diff --git a/.acrolinx-config.edn b/.acrolinx-config.edn index f6076b51964..78cdd0e4df0 100644 --- a/.acrolinx-config.edn +++ b/.acrolinx-config.edn @@ -21,7 +21,7 @@ " **More info about Acrolinx** -- [Install Acrolinx locally for VSCode](https://review.docs.microsoft.com/en-us/help/contribute/contribute-acrolinx-vscode) +- [Install Acrolinx locally for VS Code](https://review.docs.microsoft.com/en-us/help/contribute/contribute-acrolinx-vscode) - [Report false positives or issues](https://aka.ms/acrolinxbug) "} diff --git a/.github/ISSUE_TEMPLATE/new-c---2017-stl-library-documentation-topic-.md b/.github/ISSUE_TEMPLATE/new-c---2017-stl-library-documentation-topic-.md deleted file mode 100644 index d6a22e7b7ef..00000000000 --- a/.github/ISSUE_TEMPLATE/new-c---2017-stl-library-documentation-topic-.md +++ /dev/null @@ -1,13 +0,0 @@ ---- -name: 'New C++ 2017 STL library documentation topic' -about: Create a C++ 2017 doc tracking work item -title: '' -labels: C++17, STL doc work -assignees: '' ---- -{Use this template to request **new** documentation to cover a feature area in the ISO C++17 standard library. Replace this text in curly braces with a description of the feature area to cover. Include a link to the proposal paper that introduced the issue (for example, `[N4086 Removing Trigraphs??!](https://wg21.link/n4086)`), or cite the chapter and section number or \[short.name] in the C++ standard that describes the feature. Add the Visual Studio version that first implements this feature. If you don't know or don't have these values, then this issue template probably isn't the right one to use. - -If documentation already exists on docs.microsoft.com for this feature area, and you're requesting an update, bug fix, or clarification, don't use this template. Go to the article on docs.microsoft.com and use the **This page** button in the **Feedback** section at the bottom of the document to create a GitHub issue. Include a citation for the ISO standard feature area in your description.} - -ISO paper or location in the standard for this feature: {insert link or section here} -First implemented in: {VS 20YY major.minor} diff --git a/.github/ISSUE_TEMPLATE/new-c---2020-stl-library-documentation-topic-.md b/.github/ISSUE_TEMPLATE/new-c---2020-stl-library-documentation-topic-.md deleted file mode 100644 index 189349bd9ab..00000000000 --- a/.github/ISSUE_TEMPLATE/new-c---2020-stl-library-documentation-topic-.md +++ /dev/null @@ -1,13 +0,0 @@ ---- -name: 'New C++ 2020 STL library documentation topic' -about: Create a C++ 2020 doc tracking work item -title: '' -labels: C++20, STL doc work -assignees: '' ---- -{Use this template to request **new** documentation to cover a feature area in the ISO C++20 standard library. Replace this text in curly braces with a description of the feature area to cover. Include a link to the proposal paper that introduced the issue (for example, `[N4086 Removing Trigraphs??!](https://wg21.link/n4086)`), or cite the chapter and section number or \[short.name] in the C++ standard that describes the feature. Add the Visual Studio version that first implements this feature. If you don't know or don't have these values, then this issue template probably isn't the right one to use. - -If documentation already exists on docs.microsoft.com for this feature area, and you're requesting an update, bug fix, or clarification, don't use this template. Go to the article on docs.microsoft.com and use the **This page** button in the **Feedback** section at the bottom of the document to create a GitHub issue. Include a citation for the ISO standard feature area in your description.} - -ISO paper or location in the standard for this feature: {insert link or section here} -First implemented in: {VS 20YY major.minor} diff --git a/.github/ISSUE_TEMPLATE/new-c---2023-stl-library-documentation-topic.md b/.github/ISSUE_TEMPLATE/new-c---2023-stl-library-documentation-topic.md deleted file mode 100644 index 7231cf6266e..00000000000 --- a/.github/ISSUE_TEMPLATE/new-c---2023-stl-library-documentation-topic.md +++ /dev/null @@ -1,13 +0,0 @@ ---- -name: 'New C++ 2023 STL library documentation topic' -about: Create an issue to track C++ 2023 STL doc work -title: '' -labels: C++23, STL doc work -assignees: '' ---- -{Use this template to request **new** documentation to cover a feature area proposed for the ISO C++23 standard library. Replace this text in curly braces with a description of the feature area to cover. Include a link to the proposal paper that introduced the issue (for example, `[N4086 Removing Trigraphs??!](https://wg21.link/n4086)`), or cite the chapter and section number or \[short.name] in the C++ standard that describes the feature. Add the Visual Studio version that first implements this feature. If you don't know or don't have these values, then this issue template probably isn't the right one to use. - -If documentation already exists on docs.microsoft.com for this feature area, and you're requesting an update, bug fix, or clarification, don't use this template. Go to the article on docs.microsoft.com and use the **This page** button in the **Feedback** section at the bottom of the document to create a GitHub issue. Include a citation for the ISO standard feature area in your description.} - -ISO paper or location in the standard for this feature: {insert link or section here} -First implemented in: {VS 20YY major.minor} diff --git a/.github/ISSUE_TEMPLATE/new-c---stl-library-doc-topic-.md b/.github/ISSUE_TEMPLATE/new-c---stl-library-doc-topic-.md deleted file mode 100644 index 35de11091d9..00000000000 --- a/.github/ISSUE_TEMPLATE/new-c---stl-library-doc-topic-.md +++ /dev/null @@ -1,13 +0,0 @@ ---- -name: 'New C++ STL library documentation topic' -about: Create a C++ doc tracking work item -title: '' -labels: STL doc work -assignees: '' ---- -{Use this template to request **new** documentation to cover a feature area in the ISO C++ standard library. Replace this text in curly braces with a description of the feature area to cover. Include a link to the tracking issue or PR in the [Microsoft/STL](https://github.com/microsoft/STL/pulls) repo that implements the feature area. If relevant, include a link to the proposal paper that introduced the issue (for example, `[N4086 Removing Trigraphs??!](https://wg21.link/n4086)`), or cite the chapter and section number or \[short.name] in the C++ standard that describes the feature. Add the Visual Studio version that first implements this feature. If you don't know or don't have these values, then this issue template probably isn't the right one to use. - -If documentation already exists on docs.microsoft.com for this feature area, and you're requesting an update, bug fix, or clarification, don't use this template. Go to the article on docs.microsoft.com and use the **This page** button in the **Feedback** section at the bottom of the document to create a GitHub issue. If possible, include a citation for the ISO standard feature area in your description.} - -[Microsoft/STL](https://github.com/microsoft/STL/pulls) PR, ISO paper or location in the standard for this feature: {insert link or section here} -First implemented in: {VS 20YY major.minor} diff --git a/.github/ISSUE_TEMPLATE/new-c--20-compiler-doc-topic.md b/.github/ISSUE_TEMPLATE/new-c--20-compiler-doc-topic.md deleted file mode 100644 index b27ff51d563..00000000000 --- a/.github/ISSUE_TEMPLATE/new-c--20-compiler-doc-topic.md +++ /dev/null @@ -1,14 +0,0 @@ ---- -name: 'New C++20 compiler documentation topic' -about: Create a C++ doc tracking work item -title: '' -labels: C++20, Standard doc work -assignees: '' ---- -{Use this template to request **new** documentation to cover a compiler feature area in the ISO C++20 standard. Replace this text in curly braces with a description of the feature area to cover. Include a link to the proposal paper that introduced the issue (for example, `[N4086 Removing Trigraphs??!](https://wg21.link/n4086)`), or cite the chapter and section number or \[short.name] in the C++ standard that describes the feature. Add the Visual Studio version that first implements this feature. If you don't know or don't have these values, then this issue template probably isn't the right one to use. - -If documentation already exists on docs.microsoft.com for this feature area, and you're requesting an update, bug fix, or clarification, don't use this template. Go to the article on docs.microsoft.com and use the **This page** button in the **Feedback** section at the bottom of the document to create a GitHub issue. If possible, include a citation for the ISO standard feature area in your description.} - -ISO paper or location in the standard for this feature: {insert link or section here} - -First implemented in: {VS 20YY major.minor} diff --git a/.github/ISSUE_TEMPLATE/new-c--23-compiler-doc-topic.md b/.github/ISSUE_TEMPLATE/new-c--23-compiler-doc-topic.md deleted file mode 100644 index 7f86f82da5e..00000000000 --- a/.github/ISSUE_TEMPLATE/new-c--23-compiler-doc-topic.md +++ /dev/null @@ -1,14 +0,0 @@ ---- -name: 'New C++23 compiler documentation topic' -about: Create a C++ doc tracking work item -title: '' -labels: C++23, Standard doc work -assignees: '' ---- -{Use this template to request **new** documentation to cover a compiler feature area in the ISO C++23 standard. Replace this text in curly braces with a description of the feature area to cover. Include a link to the proposal paper that introduced the issue (for example, `[N4086 Removing Trigraphs??!](https://wg21.link/n4086)`), or cite the chapter and section number or \[short.name] in the C++ standard that describes the feature. Add the Visual Studio version that first implements this feature. If you don't know or don't have these values, then this issue template probably isn't the right one to use. - -If documentation already exists on docs.microsoft.com for this feature area, and you're requesting an update, bug fix, or clarification, don't use this template. Go to the article on docs.microsoft.com and use the **This page** button in the **Feedback** section at the bottom of the document to create a GitHub issue. If possible, include a citation for the ISO standard feature area in your description.} - -ISO paper or location in the standard for this feature: {insert link or section here} - -First implemented in: {VS 20YY major.minor} diff --git a/.github/copilot-instructions.md b/.github/copilot-instructions.md new file mode 100644 index 00000000000..75e32e18c89 --- /dev/null +++ b/.github/copilot-instructions.md @@ -0,0 +1,183 @@ +# Copilot Instructions for `cpp-docs-pr` + +## Introduction + +This document contains general and repository-specific instructions for GitHub Copilot when assisting with the `cpp-docs-pr` repository. + +## Priority Levels + +This document uses the following markers to indicate instruction priority: + +- **[REQUIRED]** - Must be followed. May cause build failures or PR blocks if violated +- **[STYLE]** - Microsoft Writing Style Guide requirement for consistency +- **[C++-SPECIFIC]** - C++ documentation convention that overrides general guidance +- No marker - Best practice recommendation; use judgment based on context + +## General Guidelines + +### 1. Issue Handling +When creating a PR for an issue: +- [ ] Read the full issue and all linked references + - [ ] **new-feature:** State which version introduced the feature + - [ ] **bug:** Focus on correcting technical inaccuracies +- [ ] When you're assigned an issue, after you've completed your work and the workflows (status checks) have run, ensure there are no build warnings under the OpenPublishing.Build status check. If there are, open the build report (under View Details) and resolve any build warnings you introduced. +- [ ] When starting work on an issue, document your understanding in a comment: state the issue's purpose, expected outcome, and your implementation approach. + +### 2. Issue Discussion Analysis +When working on an issue: +- [ ] **Read the complete issue discussion** - Don't rely solely on the initial issue description +- [ ] **Prioritize maintainer guidance** - Comments from repository maintainers (especially those with "MEMBER" association) should take precedence over the original issue description +- [ ] **Look for updated analysis** - Later comments may contain revised understanding, additional context, or modified resolution approaches +- [ ] **Check for explicit instructions** - Look for phrases like "Action required by GitHub Copilot" or direct "@copilot" mentions that provide specific guidance +- [ ] **Validate your understanding** - If the discussion seems to contradict the initial issue description, follow the most recent maintainer guidance + +### 3. File Naming and Organization +**Naming conventions:** +- [ ] Name new Markdown files in all lowercase with hyphens separating words +- [ ] Omit filler words like "the" or "a" from file names + +**Folder structure:** +- [ ] Linux topics → `docs/linux/` +- [ ] C++ STL → `docs/standard-library/` +- [ ] C runtime → `docs/c-runtime-library/` +- [ ] C++ language → `docs/cpp/` +- [ ] Visual Studio IDE features → `docs/ide/` +- [ ] Build process/modules → `docs/build/reference/` +- [ ] Build Insights → `docs/build-insights/` + +### 4. Links and References +- [ ] Add links to related topics and resources where appropriate. +- [ ] Use relative links for files in this repo +- [ ] **[REQUIRED]** Links to other documentation articles should be relative, not absolute. Start relative links with `/docs/` and include the `.md` suffix. If you add a link to another page on learn.microsoft.com that's not in this repo, remove https://learn.microsoft.com/en-us from the link. +- [ ] **[REQUIRED]** Links to bookmarks within the same article should be relative and start with `#`. +- [ ] **[REQUIRED]** Link descriptions should be descriptive and make sense on their own. Don't use "click here" or "this link" or "here". +- [ ] **[STYLE]** When you are going to refer to another file or an article on the web, use this format: "For more information, see [descriptive name of link](link path)." The exception to this is the See Also links at the end of an article. Those should be markdown links and contain the title of the article you link to as the descriptive portion of the link. +- [ ] For external links to non-Microsoft sites: + - [ ] **[REQUIRED]** Use absolute URLs + - [ ] **[REQUIRED]** Remove any language or culture segment from the URL path (such as `/en-us/`, `/fr-fr/`, `/en/`, etc.) + - [ ] Example (MDN): + - [ ] Original: `https://developer.mozilla.org/en-US/docs/Web/API/Element/click_event` + - [ ] Correct: `https://developer.mozilla.org/docs/Web/API/Element/click_event` + +- [ ] For links to Microsoft Learn content in other repositories: + - [ ] **[REQUIRED]** Use the relative URL starting with a forward slash + - [ ] Don't include the scheme and the host (example: `https://learn.microsoft.com`) and don't include the locale (example: `en-us`) + - [ ] Example: For the target Learn website URL `https://learn.microsoft.com/en-us/dotnet/core/introduction`, use the relative URL `/dotnet/core/introduction` for the link destination + +## Repository-Specific Guidelines +- [ ] **[REQUIRED]** Follow the [Microsoft Writing Style Guide](https://learn.microsoft.com/en-us/style-guide/welcome/) + - [ ] Use contractions following the guidance in [Use contractions](https://learn.microsoft.com/en-us/style-guide/word-choice/use-contractions) +- [ ] **Repository Exceptions**: + - [ ] **[REQUIRED]** Use **bold** text for UI elements like menu items, dialog names, and names of text boxes. + - [ ] **[REQUIRED]** Number ordered lists as "1." for every item (don't use sequential numbers) + - [ ] **[REQUIRED]** Use backticks around content specifically for file names (`file.txt`), folders (`folder`), file paths (`folder/file.txt`), custom types (`myVariable`, `MyClass`), raw URLs in the text (`https://www.contoso.com`), file extensions (`.cpp`), and code like method names, property names, and language keywords. Also use for text that should never be localized. + - [ ] **[REQUIRED]** Use `code style` for resource names (like virtual machine names) that shouldn't be localized. + - [ ] **[C++-SPECIFIC]** Use `code style` for command-line commands. The style in some articles uses **bold** for command-line commands, but use `code style` instead. + - [ ] **[STYLE]** Use placeholders with braces in the format `{PLACEHOLDER NAME}` when used code examples and other contexts where placeholders are used. Use uppercase letters with spaces between words for the placeholder name inside the braces. + - [ ] Wrong: "Launch the app and navigate to `https://localhost:/openapi/v1.json` to view the generated OpenAPI document." + - [ ] Correct: "Launch the app and navigate to `https://localhost:{PORT}/openapi/v1.json` to view the generated OpenAPI document, where the `{PORT}` placeholder is the port." + - [ ] For any new or updated .md file added to the repository, ensure the following frontmatter (metadata) is included as specified in [Metadata for Microsoft Learn documentation.](https://learn.microsoft.com/en-us/contribute/content/metadata): + - [ ] **[REQUIRED]** Metadata `ai-usage: ai-assisted` if any AI assistance was used. + - [ ] **[REQUIRED]** When updating a topic that has the ms.assetid: metadata, remove the entire ms.assetid line. + - [ ] **[REQUIRED]** Place the title metadata first, followed by the remaining metadata lines as shown in the following example: +**Example:** + ```yaml + --- + title: "Understanding C++ modules" + description: "Learn how to use C++ modules in Visual Studio" + author: github-username + ms.author: ms-alias + ms.date: 12/11/2025 + ms.topic: concept-article + ai-usage: ai-assisted + --- + ``` + +### 5. Content Writing Guidelines +- [ ] **[STYLE]** Get to the point fast. Be concise and clear. +- [ ] **[STYLE]** Talk like a person. +- [ ] **[STYLE]** Simpler is better. +- [ ] **[STYLE]** Be brief. Give customers just enough information to make decisions confidently. Prune excess words. +- [ ] **[STYLE]** Break up long sentences. +- [ ] **[STYLE]** Use present tense verbs (is, open) instead of past tense (was, opened). For example, "The method returns a value" instead of "The method will return a value." +- [ ] **[STYLE]** Write factual statements and direct commands. Avoid hypotheticals. +- [ ] **[STYLE]** Use active voice where the subject performs the action. +- [ ] **[STYLE]** Write in second person (you) to speak directly to readers. +- [ ] **[STYLE]** Use gender-neutral language. +- [ ] **[STYLE]** Avoid multiple -ing words that could create ambiguity. +- [ ] **[STYLE]** Keep prepositional phrases simple and clear. +- [ ] **[STYLE]** Place modifiers close to what they modify. +- [ ] **[STYLE]** Use a conversational tone with contractions. +- [ ] **[STYLE]** Don't use "we" or "our" to refer to the authors of the documentation. +- [ ] **[STYLE]** Use the imperative mood for instructions. For example, "Call the method" instead of "You should call the method." +- [ ] **[STYLE]** Use "might" instead of "may" to indicate possibility. For example, "This method might throw an exception" instead of "This method may throw an exception." +- [ ] **[STYLE]** Use the Oxford comma in lists of three or more items. +- [ ] Introductory paragraph: + - [ ] When drafting the first paragraph of any new article, or when significantly updating an existing article: + - [ ] Explain why and when the topic matters in practical C++ development scenarios. + - [ ] Give a concise summary of what the article covers or enables, so readers know what to expect. + - [ ] When significantly updating, revise the introductory paragraph to match the new scope and content. + +### 6. PR Description Requirements +- [ ] ALWAYS include "Fixes #[issue-number]" in the PR description, at the first line of the description to link back to the original issue +- [ ] Include a clear summary of changes made +- [ ] List all files that were modified with brief descriptions + +## Capitalization + +- [ ] Use sentence-style capitalization for everything except proper nouns. +- [ ] Always capitalize proper nouns. +- [ ] Don’t capitalize the spelled-out form of an acronym unless it's a proper noun. +- [ ] Use title-style capitalization for product and service names. +- [ ] Don't use all uppercase for emphasis. + +## Numbers + +The following does NOT apply to step numbers but applies to all other numbers: +- [ ] Spell out numbers for zero through nine, unless space is limited. Use numerals for 10 and above. +- [ ] Spell out numbers at the beginning of a sentence. +- [ ] Spell out ordinal numbers such as first, second, and third. Don't add -ly to form adverbs from ordinal numbers. +- [ ] Number ordered list items all as 1. instead of sequentially as 1., 2., etc. Use bullets for unordered lists. + +## Punctuation + +- [ ] Use short, simple sentences. +- [ ] End all sentences with a period. +- [ ] Use one space after punctuation marks. +- [ ] After a colon, capitalize only proper nouns. +- [ ] Avoid semicolons - use separate sentences instead. +- [ ] Use question marks sparingly. +- [ ] Don't use slashes (/) - use "or" instead. + +## Headings + +- [ ] Headings should be in sentence case, not title case. Don't use gerunds in titles. +- [ ] Don't apply an inline style like italic, or bold to headings. But do use inline code style for headings that are code elements, like method names or property names. + +## Alerts + +- [ ] Alerts are a Markdown extension to create block quotes that render with colors and icons that indicate the significance of the content. The following alert types are supported: + + - [ ] `[!NOTE]` Information the user should notice even if skimming. + - [ ] `[!TIP]` Optional information to help a user be more successful. + - [ ] `[!IMPORTANT]` Essential information required for user success. + - [ ] `[!CAUTION]` Negative potential consequences of an action. + - [ ] `[!WARNING]` Dangerous certain consequences of an action. + +## Images + +- [ ] Use images only when they add value. +- [ ] Images have a descriptive and meaningful alt text that starts with "Screenshot showing" and ends with ".". +- [ ] Videos have a descriptive and meaningful alt text or title that starts with "Video showing" and ends with ".". + +## Numbered steps + +- [ ] Write complete sentences with capitalization and periods +- [ ] Use imperative verbs +- [ ] Clearly indicate where actions take place (UI location) +- [ ] For single steps, use a bullet instead of a number +- [ ] When allowed, use angle brackets for menu sequences (File > Open) + +## Terminology + +- [ ] Use "Select" instead of "Click" for UI elements like buttons, menu items, links, dropdowns, and checkboxes. \ No newline at end of file diff --git a/.github/copilot-issue-verification-action-plan.md b/.github/copilot-issue-verification-action-plan.md new file mode 100644 index 00000000000..3f6d7e270e6 --- /dev/null +++ b/.github/copilot-issue-verification-action-plan.md @@ -0,0 +1,220 @@ +--- +ai-usage: ai-assisted +author: TylerMSFT +ms.author: twhitney +ms.date: 11/13/2025 +--- + +# GitHub issue analysis and action plan prompt for C++ documentation + +## Goal +Analyze the GitHub issue and provide a **structured report** determining: +1. Whether the issue is valid and actionable. +2. Whether the issue is within scope of the articles the issue relates to, or if a new article is needed. +3. The exact documentation changes required (if applicable). +4. A clear action plan that can guide PR creation. + +The report should be suitable for posting directly in the issue discussion. + +--- + +## Analysis Steps + +### 1. Information Gathering +Collect and review: +* The **issue title, description, and all comments**. +* The **published documentation** (via the provided URL). +* The **source file(s)** in the repository. +* Any **linked issues, PRs, or external references**. +* **Environment details**: .NET version, tooling versions (VS, VS Code, CLI, EF Core, etc.). +* **Code samples or error messages** mentioned in the issue. + +### 1.5 Source File Analysis +When examining source files: +* **Provide direct GitHub permalinks** to specific lines or sections. +* **Note exact line numbers** for proposed changes. +* **Include line number ranges** in GitHub URLs using `#L-L` format. +* **Quote current content** from specific lines before proposing changes. +* **Use permalinks with commit SHA** when referencing specific versions. + +Example format for file references: +* Single line: `https://github.com/owner/repo/blob/main/file.md#L123`. +* Line range: `https://github.com/owner/repo/blob/main/file.md#L123-L145`. +* Permalink: `https://github.com/owner/repo/blob//file.md#L123`. + +### 2. Validation Criteria +Determine if the issue is: +* **In scope**: Related to ASP.NET Core documentation (not product bugs). +* **Accurate**: The reported problem genuinely exists. +* **Clear**: Sufficient information to take action. +* **Current**: Applies to supported .NET versions. + +### 3. Translation Requirements +If any content is not in English: +* Include the original text in a quote block. +* Provide complete English translation. +* Label clearly as "Original" and "Translation". + +--- + +## Output Format + +### File Naming +`-analysis-report.md` + +### Report Structure + +#### Header +```markdown +## AI Analysis Report +**Analyzed by:** @ +**Date:** +**Issue:** # +**Model:** GitHub Copilot +--- +``` + +#### For Valid Issues + +```markdown +# Issue Analysis: + +## ✅ Issue Validation +**Status:** Valid and actionable + +## 📋 Issue Summary + + +## 📁 Affected Files +| File | Path | Lines | Section | +|------|------|-------|---------| +| Main article | [`aspnetcore/path/to/file.md`](https://github.com/dotnet/AspNetCore.Docs/blob/main/aspnetcore/path/to/file.md#L123-L145) | 123-145 | "Section Heading" | +| Code sample | [`aspnetcore/path/to/sample.cs`](https://github.com/dotnet/AspNetCore.Docs/blob/main/aspnetcore/path/to/sample.cs#L45-L67) | 45-67 | `MethodName()` method | + +## 📝 Proposed Changes + +### Documentation Updates +**File:** [`aspnetcore/path/to/file.md`](https://github.com/dotnet/AspNetCore.Docs/blob/main/aspnetcore/path/to/file.md#L123-L145) +**Location:** Lines 123-145 (after the paragraph containing "[specific anchor text]") +**Type:** [New paragraph / Note block / Code example / Replacement] + +**Current content (lines 123-125):** +```markdown +[Current text that will be replaced or followed] +``` + +**Proposed change:** +```markdown +[Proposed documentation text here] +``` + +### Code Sample Updates (if applicable) +**File:** [`sample.cs`](https://github.com/dotnet/AspNetCore.Docs/blob/main/path/to/sample.cs#L45-L67) +**Lines:** 45-67 +**Change:** [Add/Modify/Remove] + +**Current code:** +```csharp +// Current code at specified lines +``` + +**Proposed code:** +```csharp +// Proposed code changes +``` + +## 🎯 Action Plan +1. **Edit file:** [`aspnetcore/path/to/file.md`](https://github.com/dotnet/AspNetCore.Docs/blob/main/aspnetcore/path/to/file.md) + * Navigate to: [Line 123](https://github.com/dotnet/AspNetCore.Docs/blob/main/aspnetcore/path/to/file.md#L123) + * Find section: "Exact Section Heading" + * After text: "last sentence before insertion point" + * Insert: [!NOTE] block with explanation + +2. **Update sample:** [`path/to/sample.cs`](https://github.com/dotnet/AspNetCore.Docs/blob/main/path/to/sample.cs) + * Navigate to: [Lines 45-67](https://github.com/dotnet/AspNetCore.Docs/blob/main/path/to/sample.cs#L45-L67) + * Modify method: `MethodName()` + * Change: Update to use new pattern + +## ⚠️ Considerations +* Verify change applies to .NET [version] +* Check if similar updates needed in related articles +* Consider adding cross-references to [related topic] + +## 🔗 References +* Published article: [URL] +* Related issue: #[number] +* Microsoft Learn docs: [relevant MS docs link] +``` + +#### For Invalid Issues + +```markdown +# Issue Analysis: + +## ❌ Issue Validation +**Status:** Not actionable as is +**Reason:** [Out of scope / Insufficient information / Product issue / Already addressed] + +## 📋 Explanation + + +## 💡 Recommendation +* [Close with explanation] +* [Redirect to appropriate repository] +* [Request additional information] +* [Convert to discussion] + +## 🔗 Alternative Resources +* [Link to relevant documentation] +* [Link to appropriate repository for product issues] +``` + +--- + +## Special Instructions + +### Line Number Guidelines +* **Always inspect the actual source file** to determine accurate line numbers. +* **Provide line ranges** rather than single lines when changes affect multiple lines. +* **Use GitHub's line highlighting** format in URLs (#L123 for single, #L123-L145 for range). +* **Quote the existing content** at those lines to confirm accuracy. +* **Consider context lines** - include a few lines before/after for clarity. +* **Update line numbers** if the file has changed since issue creation. + +### Content Block Usage +Only recommend using special blocks when truly appropriate, they should not be overused: +* `[!IMPORTANT]`: Security issues, breaking changes, data loss risks +* `[!WARNING]`: Common mistakes, deprecation notices +* `[!NOTE]`: Helpful clarifications, version-specific info +* `[!TIP]`: Best practices, productivity hints + +### Code Samples +* Use appropriate language identifier for syntax highlighting. +* Include necessary `using` statements or imports. +* Add comments for complex logic. +* Ensure samples are complete and runnable. + +### Scope Boundaries +**DO:** +* Focus on documentation clarity and accuracy. +* Address missing information. +* Fix technical inaccuracies. +* Improve code samples. + +**DON'T:** +* Attempt to fix product bugs through documentation. +* Make architectural recommendations. +* Add opinions or preferences. +* Modify unrelated sections. + +## Issue labels +* Upon completion of the report, set the `ai-reviewed-issue-reported-action-plan` label for the issue. + +### Common Issue Types +1. **Missing information**: Add clarifying content +2. **Outdated content**: Update to current version +3. **Broken samples**: Fix or replace code +4. **Unclear instructions**: Rewrite for clarity +5. **Missing prerequisites**: Add setup steps + +--- \ No newline at end of file diff --git a/.gitignore b/.gitignore index 50628e8f13d..10b0192bf56 100644 --- a/.gitignore +++ b/.gitignore @@ -7,7 +7,7 @@ _themes.MSDN.Modern/ _themes.VS.Modern/ # Ignore local configuration changes -.github/ +#.github/ .openpublishing.buildcore.ps1 .vscode/ diff --git a/.openpublishing.publish.config.json b/.openpublishing.publish.config.json index 5d83ccf79d4..296bfe4f38b 100644 --- a/.openpublishing.publish.config.json +++ b/.openpublishing.publish.config.json @@ -25,14 +25,11 @@ } ], "notification_subscribers": [], - "sync_notification_subscribers": null, + "sync_notification_subscribers": [], "branches_to_filter": [], "git_repository_url_open_to_public_contributors": "https://github.com/MicrosoftDocs/cpp-docs", "git_repository_branch_open_to_public_contributors": "main", - "skip_source_output_uploading": false, "need_preview_pull_request": true, - "enable_incremental_build": true, - "contribution_branch_mappings": null, "dependent_repositories": [ { "path_to_root": "_themes", @@ -57,15 +54,16 @@ "Pdf" ] }, - "need_generate_pdf_url_template": true, "targets": { "Pdf": { "template_folder": "_themes.pdf" } }, + "docs_build_engine": {}, + "skip_source_output_uploading": false, + "enable_incremental_build": true, + "contribution_branch_mappings": null, + "need_generate_pdf_url_template": true, "need_generate_pdf": false, - "need_generate_intellisense": false, - "docs_build_engine": { - "name": "docfx_v3" - } -} + "need_generate_intellisense": false +} \ No newline at end of file diff --git a/.openpublishing.redirection.json b/.openpublishing.redirection.json index 5080a1951eb..dc663314250 100644 --- a/.openpublishing.redirection.json +++ b/.openpublishing.redirection.json @@ -21,7 +21,7 @@ "redirect_document_id": true }, { - "source_path": "docs/supported-platforms-visual-cpp.md.md", + "source_path": "docs/supported-platforms-visual-cpp.md", "redirect_url": "/cpp/overview/supported-platforms-visual-cpp", "redirect_document_id": true }, @@ -7436,7 +7436,7 @@ "redirect_document_id": false }, { - "source_path": "docs/dotnet/how-to-enumerate-data-types-in-assemblies-using-reflection-cpp-cli.md.md", + "source_path": "docs/dotnet/how-to-enumerate-data-types-in-assemblies-using-reflection-cpp-cli.md", "redirect_url": "/cpp/dotnet/reflection-cpp-cli#enumerate", "redirect_document_id": false }, @@ -13752,13 +13752,18 @@ }, { "source_path": "docs/c-runtime-library/operator-delete-crt.md", - "redirect_url": "docs/c-runtime-library/delete-operator-crt", + "redirect_url": "/cpp/c-runtime-library/delete-operator-crt", "redirect_document_id": false }, { "source_path": "docs/c-runtime-library/operator-new-crt.md", - "redirect_url": "docs/c-runtime-library/new-operator-crt", + "redirect_url": "/cpp/c-runtime-library/new-operator-crt", + "redirect_document_id": false + }, + { + "source_path": "docs/overview/whats-new-cpp-docs.md", + "redirect_url": "../../cpp/overview/what-s-new-for-visual-cpp-in-visual-studio", "redirect_document_id": false } ] -} +} \ No newline at end of file diff --git a/.vscode/settings.json b/.vscode/settings.json index 7eaad279a3d..60de5be0fe6 100644 --- a/.vscode/settings.json +++ b/.vscode/settings.json @@ -13,5 +13,8 @@ "Makefile", "VB.NET", "XML" - ] + ], + "python-envs.defaultEnvManager": "ms-python.python:conda", + "python-envs.defaultPackageManager": "ms-python.python:conda", + "python-envs.pythonProjects": [] } \ No newline at end of file diff --git a/CONTRIBUTING.md b/CONTRIBUTING.md index bbfa4431118..1fed536772c 100644 --- a/CONTRIBUTING.md +++ b/CONTRIBUTING.md @@ -1,8 +1,8 @@ # Contributing -Thank you for your interest in contributing to the Visual C++ documentation! +Thank you for your interest in contributing to the Microsoft C++ documentation! -In this topic, you'll see the basic process for adding or updating content in the [Visual C++ documentation site](https://learn.microsoft.com/cpp/). +In this topic, you'll see the basic process for adding or updating content in the [Microsoft C++ documentation site](https://learn.microsoft.com/cpp/). In this topic, we'll cover: @@ -14,16 +14,13 @@ In this topic, we'll cover: ## Process for contributing -**Step 1:** Open an issue describing the article you wish to write and how it relates to existing content. -The content inside the **docs** folder is organized into sections that are organized by content area (e.g., debugger). Try to determine the correct folder for your new content. Get feedback on your proposal. - -You can skip this first step for small changes. +**Step 1:** The content inside the **docs** folder is organized into sections that are organized by content area (e.g., debugger). Try to determine the correct folder for your changes. **Step 2:** Fork the `MicrosoftDocs/cpp-docs` repository. -**Step 3:** Create a `branch` for your article. +**Step 3:** Create a `branch` for your changes. -**Step 4:** Write your article. +**Step 4:** Make your edits and commit. If it's a new topic, you can use this [template file](./styleguide/template.md) as your starting point. It contains the writing guidelines and also explains the metadata required for each article, such as author information. @@ -46,9 +43,7 @@ docs **Step 5:** Submit a Pull Request (PR) from your branch to `MicrosoftDocs/cpp-docs/main`. -If your PR is addressing an existing issue, add the `Fixes #Issue_Number` keyword to the commit message or PR description, so the issue can be automatically closed when the PR is merged. For more information, see [Closing issues via commit messages](https://help.github.com/articles/closing-issues-via-commit-messages/). - -The Visual Studio team will review your PR and let you know if the change looks good or if there are any other updates/changes necessary in order to approve it. +The Microsoft C++ docs team will review your PR and let you know if the change looks good or if there are any other updates/changes necessary in order to approve it. **Step 6:** Make any necessary updates to your branch as discussed with the team. @@ -58,9 +53,9 @@ On a certain cadence, we push all commits from main branch into the live branch ## DOs and DON'Ts -Below is a short list of guiding rules that you should keep in mind when you are contributing to the .NET documentation. +Below is a short list of guiding rules that you should keep in mind when you are contributing to the Microsoft C++ documentation. -- **DON'T** surprise us with big pull requests. Instead, file an issue and start a discussion so we can agree on a direction before you invest a large amount of time. +- **DON'T** surprise us with big pull requests. - **DO** read the [style guide](./styleguide/template.md) and [voice and tone](./styleguide/voice-tone.md) guidelines. - **DO** use the [template](./styleguide/template.md) file as the starting point of your work. - **DO** create a separate branch on your fork before working on the articles. @@ -68,7 +63,7 @@ Below is a short list of guiding rules that you should keep in mind when you are - **DO** blog and tweet (or whatever) about your contributions, frequently! > [!NOTE] -> You might notice that some of the topics are not currently following all the guidelines specified here and on the [style guide](./styleguide/template.md) as well. We're working towards achieving consistency throughout the site. Check the list of [open issues](https://github.com/MicrosoftDocs/cpp-docs/issues?q=is%3Aissue+is%3Aopen+label%3Aguidelines-adherence) we're currently tracking for that specific goal. +> You might notice that some of the topics are not currently following all the guidelines specified here and on the [style guide](./styleguide/template.md) as well. We're working towards achieving consistency throughout the site. ## Building the documentation diff --git a/README.md b/README.md index e2a4e7c444e..816a2293bf9 100644 --- a/README.md +++ b/README.md @@ -1,14 +1,14 @@ -# Visual Studio documentation for Microsoft C++ +# Microsoft C++, C, and Assembler documentation -Welcome! This repository contains source files for the work-in-progress Microsoft C++ (MSVC or Visual C++) technical documentation. The articles are published on the [C++ in Visual Studio documentation site](https://learn.microsoft.com/cpp). +Welcome! This repository contains source files for the technical documentation published on [https://learn.microsoft.com/cpp](https://learn.microsoft.com/cpp). -The documentation for Visual Basic and Visual C# are located in a separate repository at [https://github.com/dotnet/core-docs](https://github.com/dotnet/core-docs), and the Visual Studio documentation is located in the repository located at [https://github.com/Microsoft/visualstudio-docs](https://github.com/Microsoft/visualstudio-docs). +The documentation for [.NET](https://github.com/dotnet/docs) and [Visual Studio](https://github.com/MicrosoftDocs/visualstudio-docs) are located in separate repositories. ## Contributing to the documentation We welcome your contributions to help us improve the MSVC docs. For a comprehensive guide to contributing, see the [Microsoft Docs contributor guide](https://learn.microsoft.com/contribute). For details on how to make a contribution to the MSVC documentation, see our [Contributing guidance](CONTRIBUTING.md). -Several feature areas of MSVC have their own folders in this repository, such as `standard-library` for articles on the C++ Standard Library, `ide` for C++-specific articles on the Visual Studio interactive development environment (IDE), and so forth. The `/media` subfolder in each folder contains art files for the articles. The [Contributing guide](CONTRIBUTING.md) has more information. +Several feature areas of MSVC have their own folders in this repository, such as `standard-library` for articles on the C++ Standard Library, `ide` for C++-specific articles on the Visual Studio integrated development environment (IDE), and so forth. The `/media` subfolder in each folder contains art files for the articles. The [Contributing guide](CONTRIBUTING.md) has more information. ## Microsoft Open Source Code of Conduct diff --git a/docs/assembler/arm/arm-assembler-command-line-reference.md b/docs/assembler/arm/arm-assembler-command-line-reference.md index 6c79ceaf152..a686553e861 100644 --- a/docs/assembler/arm/arm-assembler-command-line-reference.md +++ b/docs/assembler/arm/arm-assembler-command-line-reference.md @@ -5,7 +5,7 @@ ms.date: 05/09/2022 --- # ARM Assembler command-line reference -The Microsoft ARM assemblers, **armasm** and **armasm64**, support several command-line options. By default, **armasm** assembles ARMv7 Thumb assembly language into the Microsoft implementation of the Common Object File Format (COFF). The **armasm64** assembler creates COFF object code for ARM64 and ARM64EC targets. The linker can link COFF code objects produced by both the ARM assembler and the C/C++ compiler. It can link either together with object libraries created by the librarian. +The Microsoft ARM assemblers, **armasm** and **armasm64**, support several command-line options. By default, **armasm** assembles ARMv7 Thumb assembly language into the Microsoft implementation of the Common Object File Format (COFF). The **armasm64** assembler creates COFF object code for ARM64 and ARM64EC targets. The linker can link COFF code objects produced by both the ARM assembler and the MSVC compiler. It can link either together with object libraries created by the librarian. ## Syntax diff --git a/docs/assembler/inline/accessing-c-or-cpp-data-in-asm-blocks.md b/docs/assembler/inline/accessing-c-or-cpp-data-in-asm-blocks.md index c2018570a2a..8dab8e0883c 100644 --- a/docs/assembler/inline/accessing-c-or-cpp-data-in-asm-blocks.md +++ b/docs/assembler/inline/accessing-c-or-cpp-data-in-asm-blocks.md @@ -4,6 +4,7 @@ title: "Accessing C or C++ Data in __asm Blocks" ms.date: "08/30/2018" helpviewer_keywords: ["data members [C++], in __asm blocks", "data access [C++], in __asm blocks", "__asm keyword [C++], data members", "structure types in __asm blocks"] ms.assetid: e99f5a28-0381-4090-8ece-6af8f2436a49 +ms.topic: concept-article --- # Accessing C or C++ Data in __asm Blocks diff --git a/docs/assembler/inline/asm.md b/docs/assembler/inline/asm.md index 0aa4253ef7e..78787c9492b 100644 --- a/docs/assembler/inline/asm.md +++ b/docs/assembler/inline/asm.md @@ -1,10 +1,10 @@ --- -description: "Learn more about: `__asm`" title: "__asm" -ms.date: "10/09/2018" +description: "Learn more about: `__asm`" +ms.date: 10/09/2018 +ms.topic: reference f1_keywords: ["__asm", "_asm", "__asm_cpp"] helpviewer_keywords: ["__asm keyword [C++], vs. asm blocks", "__asm keyword [C++]"] -ms.assetid: 77ff3bc9-a492-4b5e-85e1-fa4e414e79cd --- # `__asm` @@ -13,7 +13,7 @@ ms.assetid: 77ff3bc9-a492-4b5e-85e1-fa4e414e79cd The **`__asm`** keyword invokes the inline assembler and can appear wherever a C or C++ statement is legal. It can't appear by itself. It must be followed by an assembly instruction, a group of instructions enclosed in braces, or, at minimum, an empty pair of braces. The term "**`__asm`** block" here refers to any instruction or group of instructions, whether or not in braces. > [!NOTE] -> Visual C++ support for the Standard C++ **`asm`** keyword is limited to the fact that the compiler will not generate an error on the keyword. However, an **`asm`** block will not generate any meaningful code. Use **`__asm`** instead of **`asm`**. +> MSVC support for the Standard C++ **`asm`** keyword is limited to the fact that the compiler will not generate an error on the keyword. However, an **`asm`** block will not generate any meaningful code. Use **`__asm`** instead of **`asm`**. ## Grammar @@ -27,7 +27,7 @@ The **`__asm`** keyword invokes the inline assembler and can appear wherever a C ## Remarks -If used without braces, the **`__asm`** keyword means that the rest of the line is an assembly-language statement. If used with braces, it means that each line between the braces is an assembly-language statement. For compatibility with previous versions, **`_asm`** is a synonym for **`__asm`**. +If used without braces, the **`__asm`** keyword means that the rest of the line is an assembly-language statement. If used with braces, it means that each line between the braces is an assembly-language statement. For compatibility with previous versions, **`_asm`** is a synonym for **`__asm`** unless compiler option [`/Za` (Disable language extensions)](../../build/reference/za-ze-disable-language-extensions.md) is specified. Since the **`__asm`** keyword is a statement separator, you can put assembly instructions on the same line. @@ -41,8 +41,6 @@ didn't cause native code to be generated when compiled with **/clr**; the compil `__asm int 3` now results in native code generation for the function. If you want a function to cause a break point in your code and if you want that function compiled to MSIL, use [__debugbreak](../../intrinsics/debugbreak.md). -For compatibility with previous versions, **`_asm`** is a synonym for **`__asm`** unless compiler option [/Za \(Disable language extensions)](../../build/reference/za-ze-disable-language-extensions.md) is specified. - ## Example The following code fragment is a simple **`__asm`** block enclosed in braces: diff --git a/docs/assembler/inline/calling-c-functions-in-inline-assembly.md b/docs/assembler/inline/calling-c-functions-in-inline-assembly.md index 151a29d5a53..74bf5c40de2 100644 --- a/docs/assembler/inline/calling-c-functions-in-inline-assembly.md +++ b/docs/assembler/inline/calling-c-functions-in-inline-assembly.md @@ -4,6 +4,7 @@ title: "Calling C Functions in Inline Assembly" ms.date: "08/30/2018" helpviewer_keywords: ["function calls, C functions", "function calls, in inline assembly", "functions [C], calling in inline assembly", "Visual C, functions", "inline assembly, calling functions", "__asm keyword [C++], calling functions"] ms.assetid: f8a8d568-d175-4e23-9b24-36ef60a4cab3 +ms.topic: concept-article --- # Calling C Functions in Inline Assembly diff --git a/docs/assembler/inline/calling-cpp-functions-in-inline-assembly.md b/docs/assembler/inline/calling-cpp-functions-in-inline-assembly.md index 4189da24ae8..11c2763e438 100644 --- a/docs/assembler/inline/calling-cpp-functions-in-inline-assembly.md +++ b/docs/assembler/inline/calling-cpp-functions-in-inline-assembly.md @@ -4,6 +4,7 @@ title: "Calling C++ Functions in Inline Assembly" ms.date: "08/30/2018" helpviewer_keywords: ["functions [C++], calling in inline assembly", "function calls, C++ functions", "function calls, in inline assembly", "Visual C++, functions", "inline assembly, calling functions", "__asm keyword [C++], calling functions"] ms.assetid: 1f0d1eb3-54cf-45d5-838d-958188616b38 +ms.topic: concept-article --- # Calling C++ Functions in Inline Assembly diff --git a/docs/assembler/inline/debugging-and-listings-for-inline-assembly.md b/docs/assembler/inline/debugging-and-listings-for-inline-assembly.md index 5ad6409390b..dbe6f30b37a 100644 --- a/docs/assembler/inline/debugging-and-listings-for-inline-assembly.md +++ b/docs/assembler/inline/debugging-and-listings-for-inline-assembly.md @@ -4,6 +4,7 @@ title: "Debugging and Listings for Inline Assembly" ms.date: "08/30/2018" helpviewer_keywords: ["source level debugger", "__asm keyword [C++], debugging", "inline assembly, listings", "bugs, __asm blocks", "debugging [C++], inline assembly code", "inline assembly, debugging"] ms.assetid: 69266930-6f9a-433d-b704-f4f44e7b2583 +ms.topic: concept-article --- # Debugging and Listings for Inline Assembly diff --git a/docs/assembler/inline/defining-asm-blocks-as-c-macros.md b/docs/assembler/inline/defining-asm-blocks-as-c-macros.md index 0a5d4df1279..ebea4aa8da3 100644 --- a/docs/assembler/inline/defining-asm-blocks-as-c-macros.md +++ b/docs/assembler/inline/defining-asm-blocks-as-c-macros.md @@ -1,9 +1,9 @@ --- -description: "Learn more about: Defining __asm Blocks as C Macros" title: "Defining __asm Blocks as C Macros" -ms.date: "08/30/2018" +description: "Learn more about: Defining __asm Blocks as C Macros" +ms.date: 08/30/2018 helpviewer_keywords: ["macros, __asm blocks", "Visual C, macros", "__asm keyword [C++], as C macros"] -ms.assetid: 677ba11c-21c8-4609-bba7-cd47312243b0 +ms.topic: concept-article --- # Defining __asm Blocks as C Macros @@ -15,7 +15,7 @@ C macros offer a convenient way to insert assembly code into your source code, b - Put the **`__asm`** keyword in front of each assembly instruction. -- Use old-style C comments ( `/* comment */`) instead of assembly-style comments ( `; comment`) or single-line C comments ( `// comment`). +- Use old-style C comments (`/* comment */`) instead of assembly-style comments (`; comment`) or single-line C comments (`// comment`). To illustrate, the following example defines a simple macro: @@ -39,7 +39,7 @@ The third and fourth **`__asm`** keywords are needed as statement separators. Th The braces are essential as well. If you omit them, the compiler can be confused by C or C++ statements on the same line to the right of the macro invocation. Without the closing brace, the compiler cannot tell where assembly code stops, and it sees C or C++ statements after the **`__asm`** block as assembly instructions. -Assembly-style comments that start with a semicolon (**;**) continue to the end of the line. This causes problems in macros because the compiler ignores everything after the comment, all the way to the end of the logical line. The same is true of single-line C or C++ comments ( `// comment`). To prevent errors, use old-style C comments ( `/* comment */`) in **`__asm`** blocks defined as macros. +Assembly-style comments that start with a semicolon (**;**) continue to the end of the line. This causes problems in macros because the compiler ignores everything after the comment, all the way to the end of the logical line. The same is true of single-line C or C++ comments (`// comment`). To prevent errors, use old-style C comments (`/* comment */`) in **`__asm`** blocks defined as macros. An **`__asm`** block written as a C macro can take arguments. Unlike an ordinary C macro, however, an **`__asm`** macro cannot return a value. So you cannot use such macros in C or C++ expressions. diff --git a/docs/assembler/inline/emit-pseudoinstruction.md b/docs/assembler/inline/emit-pseudoinstruction.md index 201c775fd0e..b736701ca0b 100644 --- a/docs/assembler/inline/emit-pseudoinstruction.md +++ b/docs/assembler/inline/emit-pseudoinstruction.md @@ -5,6 +5,7 @@ ms.date: "08/30/2018" f1_keywords: ["_emit"] helpviewer_keywords: ["byte defining (inline assembly)", "_emit pseudoinstruction"] ms.assetid: 004c48f3-364c-4e82-9a51-e326f9cc7b2b +ms.topic: reference --- # _emit Pseudoinstruction diff --git a/docs/assembler/inline/even-and-align-directives.md b/docs/assembler/inline/even-and-align-directives.md index 648f5367903..d98adc4b440 100644 --- a/docs/assembler/inline/even-and-align-directives.md +++ b/docs/assembler/inline/even-and-align-directives.md @@ -1,18 +1,17 @@ --- -description: "Learn more about: EVEN and ALIGN Directives" title: "EVEN and ALIGN Directives" -ms.date: "08/30/2018" +description: "Learn more about: EVEN and ALIGN Directives" +ms.date: 08/30/2018 helpviewer_keywords: ["EVEN directive", "directives, MASM", "MASM (Microsoft Macro Assembler), directives", "NOP (no operation instruction)", "ALIGN directive"] -ms.assetid: 7357ab2d-4a5c-43ca-accb-a5f21cdfcde5 --- -# EVEN and ALIGN Directives +# `EVEN` and `ALIGN` Directives **Microsoft Specific** -Although the inline assembler doesn't support most MASM directives, it does support `EVEN` and **ALIGN**. These directives put **NOP** (no operation) instructions in the assembly code as needed to align labels to specific boundaries. This makes instruction-fetch operations more efficient for some processors. +Although the inline assembler doesn't support most MASM directives, it does support [`EVEN`](../masm/even.md) and [`ALIGN`](../masm/align-masm.md). These directives put `NOP` (no operation) instructions in the assembly code as needed to align labels to specific boundaries. This makes instruction-fetch operations more efficient for some processors. **END Microsoft Specific** ## See also -[Using Assembly Language in __asm Blocks](../../assembler/inline/using-assembly-language-in-asm-blocks.md)
+[Using Assembly Language in `__asm` Blocks](using-assembly-language-in-asm-blocks.md) diff --git a/docs/assembler/inline/inline-assembler-overview.md b/docs/assembler/inline/inline-assembler-overview.md index 25141761486..3b97cd70431 100644 --- a/docs/assembler/inline/inline-assembler-overview.md +++ b/docs/assembler/inline/inline-assembler-overview.md @@ -4,6 +4,7 @@ title: "Inline Assembler Overview" ms.date: "08/30/2018" helpviewer_keywords: ["inline assembler", "__asm keyword [C++], invoking inline assembler", "invoking inline assembler", "inline assembly, inline assembler"] ms.assetid: d990331a-0e33-4760-8d7a-b720b0288335 +ms.topic: concept-article --- # Inline Assembler Overview diff --git a/docs/assembler/inline/instruction-set-for-inline-assembly.md b/docs/assembler/inline/instruction-set-for-inline-assembly.md index 13b356b5264..bbcdcbd635e 100644 --- a/docs/assembler/inline/instruction-set-for-inline-assembly.md +++ b/docs/assembler/inline/instruction-set-for-inline-assembly.md @@ -10,7 +10,7 @@ ms.assetid: a45b5b22-9b5f-4545-81ec-70eb8ea2ef9b **Microsoft Specific** -The Microsoft C++ compiler supports all opcodes through the Pentium 4 and AMD Athlon. Additional instructions supported by the target processor can be created with the [_emit Pseudoinstruction](../../assembler/inline/emit-pseudoinstruction.md). +The MSVC compiler supports all opcodes through the Pentium 4 and AMD Athlon. Additional instructions supported by the target processor can be created with the [_emit Pseudoinstruction](../../assembler/inline/emit-pseudoinstruction.md). **END Microsoft Specific** diff --git a/docs/assembler/inline/intel-s-mmx-instruction-set.md b/docs/assembler/inline/intel-s-mmx-instruction-set.md index eb492df28df..c66d08a1255 100644 --- a/docs/assembler/inline/intel-s-mmx-instruction-set.md +++ b/docs/assembler/inline/intel-s-mmx-instruction-set.md @@ -10,7 +10,7 @@ ms.assetid: 705deb2d-c3fd-4696-9e22-8bcf25866daf **Microsoft Specific** -The Microsoft C++ compiler allows you to use Intel's MMX (multimedia extension) instruction set in the inline assembler. The MMX instructions are also supported by the debugger disassembly. The compiler generates a warning message if the function contains MMX instructions but does not contain an EMMS instruction to empty the multimedia state. For more information, see the Intel Web site. +The MSVC compiler allows you to use Intel's MMX (multimedia extension) instruction set in the inline assembler. The MMX instructions are also supported by the debugger disassembly. The compiler generates a warning message if the function contains MMX instructions but does not contain an EMMS instruction to empty the multimedia state. For more information, see the Intel Web site. **END Microsoft Specific** diff --git a/docs/assembler/inline/jumping-to-labels-in-inline-assembly.md b/docs/assembler/inline/jumping-to-labels-in-inline-assembly.md index 0146414b364..69529719664 100644 --- a/docs/assembler/inline/jumping-to-labels-in-inline-assembly.md +++ b/docs/assembler/inline/jumping-to-labels-in-inline-assembly.md @@ -4,6 +4,7 @@ title: "Jumping to Labels in Inline Assembly" ms.date: "08/30/2018" helpviewer_keywords: ["inline assembly, jumping to labels", "labels, in inline assembly", "__asm keyword [C++], labels", "case sensitivity, labels in inline assembly", "labels, in __asm blocks", "jumping to labels in inline assembly"] ms.assetid: 36c18b97-8981-4631-9dfd-af6c14a04297 +ms.topic: concept-article --- # Jumping to Labels in Inline Assembly diff --git a/docs/assembler/inline/optimizing-inline-assembly.md b/docs/assembler/inline/optimizing-inline-assembly.md index 726c242a525..7330cf7156e 100644 --- a/docs/assembler/inline/optimizing-inline-assembly.md +++ b/docs/assembler/inline/optimizing-inline-assembly.md @@ -4,6 +4,7 @@ title: "Optimizing Inline Assembly" ms.date: "08/30/2018" helpviewer_keywords: ["storage, optimizing in inline assembly", "optimization, inline assembly", "inline assembly, optimizing", "optimizing performance, inline assembly", "__asm keyword [C++], optimizing"] ms.assetid: 52a7ec83-9782-4d96-94c1-53bb2ac9e8c8 +ms.topic: concept-article --- # Optimizing Inline Assembly diff --git a/docs/assembler/inline/using-and-preserving-registers-in-inline-assembly.md b/docs/assembler/inline/using-and-preserving-registers-in-inline-assembly.md index 30dae26e22c..b488b9fc601 100644 --- a/docs/assembler/inline/using-and-preserving-registers-in-inline-assembly.md +++ b/docs/assembler/inline/using-and-preserving-registers-in-inline-assembly.md @@ -4,6 +4,7 @@ title: "Using and Preserving Registers in Inline Assembly" ms.date: "08/30/2018" helpviewer_keywords: ["__asm keyword [C++], register values", "inline assembly, registers", "registers, inline assembly", "preserving registers"] ms.assetid: dbcd7360-6f3e-4b22-9ee2-9f65ca6f2543 +ms.topic: concept-article --- # Using and Preserving Registers in Inline Assembly diff --git a/docs/assembler/inline/using-assembly-language-in-asm-blocks.md b/docs/assembler/inline/using-assembly-language-in-asm-blocks.md index 2e80f379517..c2a33f53b50 100644 --- a/docs/assembler/inline/using-assembly-language-in-asm-blocks.md +++ b/docs/assembler/inline/using-assembly-language-in-asm-blocks.md @@ -4,6 +4,7 @@ title: "Using Assembly Language in __asm Blocks" ms.date: "08/30/2018" helpviewer_keywords: ["assembly language [C++], features", "assembly language [C++]", "__asm keyword [C++], assembly language in"] ms.assetid: ad699356-1d16-4984-871f-c5fd7797c1fb +ms.topic: concept-article --- # Using Assembly Language in __asm Blocks diff --git a/docs/assembler/inline/using-c-or-cpp-in-asm-blocks.md b/docs/assembler/inline/using-c-or-cpp-in-asm-blocks.md index 60fbff35486..0a56b28c8fc 100644 --- a/docs/assembler/inline/using-c-or-cpp-in-asm-blocks.md +++ b/docs/assembler/inline/using-c-or-cpp-in-asm-blocks.md @@ -4,6 +4,7 @@ title: "Using C or C++ in __asm Blocks" ms.date: "08/30/2018" helpviewer_keywords: ["inline assembly, mixing instructions with C/C++ statements", "symbols, in __asm blocks", "macros, __asm blocks", "preprocessor directives, used in __asm blocks", "type names, used in __asm blocks", "preprocessor directives", "preprocessor, directives", "constants, in __asm blocks", "comments, in __asm blocks", "typedef names, used in __asm blocks", "__asm keyword [C++], C/C++ elements in"] ms.assetid: ae8b2b52-6b75-42e3-ac0c-ad02d922ed97 +ms.topic: concept-article --- # Using C or C++ in __asm Blocks diff --git a/docs/assembler/inline/using-c-or-cpp-symbols-in-asm-blocks.md b/docs/assembler/inline/using-c-or-cpp-symbols-in-asm-blocks.md index 7b4602352c2..8dc38e5868e 100644 --- a/docs/assembler/inline/using-c-or-cpp-symbols-in-asm-blocks.md +++ b/docs/assembler/inline/using-c-or-cpp-symbols-in-asm-blocks.md @@ -4,6 +4,7 @@ title: "Using C or C++ Symbols in __asm Blocks" ms.date: "08/30/2018" helpviewer_keywords: ["__asm keyword [C++], syntax", "symbols, in __asm blocks", "Visual C, symbols in __asm blocks", "__asm keyword [C++], C/C++ elements in", "Visual C++, in __asm blocks"] ms.assetid: 0758ffdc-dfe9-41c8-a5e1-fd395bcac328 +ms.topic: concept-article --- # Using C or C++ Symbols in __asm Blocks diff --git a/docs/assembler/inline/using-operators-in-asm-blocks.md b/docs/assembler/inline/using-operators-in-asm-blocks.md index dbda9a8fd39..b629032f997 100644 --- a/docs/assembler/inline/using-operators-in-asm-blocks.md +++ b/docs/assembler/inline/using-operators-in-asm-blocks.md @@ -4,6 +4,7 @@ title: "Using Operators in __asm Blocks" ms.date: "08/30/2018" helpviewer_keywords: ["brackets [ ]", "brackets [ ], __asm blocks", "__asm keyword [C++], operators", "square brackets [ ], __asm blocks", "operators [C++], using in __asm blocks", "square brackets [ ]"] ms.assetid: a26ccfd4-40ae-4a61-952f-c417982aa8dd +ms.topic: concept-article --- # Using Operators in __asm Blocks diff --git a/docs/assembler/inline/writing-functions-with-inline-assembly.md b/docs/assembler/inline/writing-functions-with-inline-assembly.md index 65e852819fc..d1082cff37d 100644 --- a/docs/assembler/inline/writing-functions-with-inline-assembly.md +++ b/docs/assembler/inline/writing-functions-with-inline-assembly.md @@ -4,6 +4,7 @@ title: "Writing functions with inline assembly" ms.date: 02/11/2022 helpviewer_keywords: ["functions [C++], inline assembly", "inline assembly [C++], writing functions", "assembler [C++], writing functions", "__asm keyword [C++], in functions"] ms.assetid: b5df8a04-fdc7-4622-8c9e-e4b618927497 +ms.topic: concept-article --- # Writing functions with inline assembly diff --git a/docs/assembler/masm/dot-code.md b/docs/assembler/masm/dot-code.md index 0a87ecdd4ce..9bf447e91b3 100644 --- a/docs/assembler/masm/dot-code.md +++ b/docs/assembler/masm/dot-code.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: .CODE" title: ".CODE" +description: "Learn more about: .CODE" ms.date: "12/17/2019" f1_keywords: [".CODE"] helpviewer_keywords: [".CODE directive"] -ms.assetid: 2b8c882c-c0d2-4fa3-8335-e6b12717a4f4 --- # .CODE @@ -16,7 +15,7 @@ When using 32-bit MASM, this should be used along with [.MODEL](dot-model.md). > **.CODE** ⟦*name*⟧\ > ⟦ *segmentItem* ⟧...\ -> ⟦ *codesegmentnameId* **ENDS**;;⟧\ +> ⟦ *codesegmentnameId* **ENDS**;;⟧ ### Parameters diff --git a/docs/assembler/masm/dot-fpo.md b/docs/assembler/masm/dot-fpo.md index 0e523fb9bf1..7c70aab623a 100644 --- a/docs/assembler/masm/dot-fpo.md +++ b/docs/assembler/masm/dot-fpo.md @@ -4,35 +4,34 @@ title: ".FPO" ms.date: "11/05/2019" f1_keywords: [".FPO"] helpviewer_keywords: [".FPO directive"] -ms.assetid: 35f4cd61-32f9-4262-b657-73f04f775d09 --- # .FPO (32-bit MASM) -The **.FPO** directive controls the emission of debug records to the .debug$F segment or section. (32-bit MASM only.) +The `.FPO` directive controls the emission of debug records to the `.debug$F` segment or section. Use this directive with 32-bit MASM only. ## Syntax -> **.FPO** (*cdwLocals*, *cdwParams*, *cbProlog*, *cbRegs*, *fUseBP*, *cbFrame*) +> `.FPO` (*`cdwLocals`*, *`cdwParams`*, *`cbProlog`*, *`cbRegs`*, *`fUseBP`*, *`cbFrame`*) ### Parameters -*cdwLocals*\ -Number of local variables, an unsigned 32 bit value. +*`cdwLocals`*\ +Number of local variables, an unsigned 32-bit value. -*cdwParams*\ -Size of the parameters in DWORDS, an unsigned 16 bit value. +*`cdwParams`*\ +Size of the parameters in DWORDS, an unsigned 16-bit value. -*cbProlog*\ -Number of bytes in the function prolog code, an unsigned 8 bit value. +*`cbProlog`*\ +Number of bytes in the function prolog code, an unsigned 8-bit value. -*cbRegs*\ +*`cbRegs`*\ Number registers saved. -*fUseBP*\ -Indicates whether the EBP register has been allocated. either 0 or 1. +*`fUseBP`*\ +Indicates whether the EBP register is allocated. Use either 0 or 1. -*cbFrame*\ -Indicates the frame type. See [FPO_DATA](/windows/win32/api/winnt/ns-winnt-fpo_data) for more information. +*`cbFrame`*\ +Indicates the frame type. For more information, see [`FPO_DATA`](/windows/win32/api/winnt/ns-winnt-fpo_data). ## See also diff --git a/docs/assembler/masm/dot-nolistif.md b/docs/assembler/masm/dot-nolistif.md index bb4996f2add..37703a53fb2 100644 --- a/docs/assembler/masm/dot-nolistif.md +++ b/docs/assembler/masm/dot-nolistif.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: .NOLISTIF" title: ".NOLISTIF" +description: "Learn more about: .NOLISTIF" ms.date: "12/16/2019" f1_keywords: [".NOLISTIF"] helpviewer_keywords: [".NOLISTIF directive"] -ms.assetid: 9243af7a-7221-4531-bbc3-281b6b292bfd --- # .NOLISTIF @@ -20,5 +19,5 @@ This is the default. Same as [.SFCOND](dot-sfcond.md). ## See also -[Directives reference](directives-reference.md) +[Directives reference](directives-reference.md)\ [MASM BNF Grammar](masm-bnf-grammar.md) diff --git a/docs/assembler/masm/even.md b/docs/assembler/masm/even.md index a8123b72031..f7b6a209b92 100644 --- a/docs/assembler/masm/even.md +++ b/docs/assembler/masm/even.md @@ -1,12 +1,11 @@ --- -description: "Learn more about: EVEN" title: "EVEN" -ms.date: "12/17/2019" +description: "Learn more about: EVEN" +ms.date: 12/17/2019 f1_keywords: ["EVEN"] helpviewer_keywords: ["EVEN directive"] -ms.assetid: 68938ba4-8cb9-44d4-914e-9f9fee6bcbf4 --- -# EVEN +# `EVEN` Aligns the next variable or instruction on an even byte. @@ -16,5 +15,6 @@ Aligns the next variable or instruction on an even byte. ## See also +[`ALIGN`](align-masm.md)\ [Directives reference](directives-reference.md)\ [MASM BNF Grammar](masm-bnf-grammar.md) diff --git a/docs/assembler/masm/extern-masm.md b/docs/assembler/masm/extern-masm.md index 910e02df031..d261390d68c 100644 --- a/docs/assembler/masm/extern-masm.md +++ b/docs/assembler/masm/extern-masm.md @@ -1,9 +1,8 @@ --- -description: "Learn more about: EXTERN" +description: "Learn more about the MASM directive: EXTERN" title: "EXTERN (MASM)" -ms.date: "12/06/2019" +ms.date: 1/10/2025 helpviewer_keywords: ["EXTERN directive"] -ms.assetid: 667d703d-3aaf-4139-a586-29bc5dab1aff --- # EXTERN @@ -17,9 +16,9 @@ Defines one or more external variables, labels, or symbols called *name* whose t The *language-type* argument is valid in 32-bit MASM only. -The *type* can be [ABS](operator-abs.md), which imports *name* as a constant. Same as [EXTRN](extrn.md). +The *type* can be [`ABS`](operator-abs.md), which imports *name* as a constant. Same as [`EXTRN`](extrn.md). -The *type* can also be PROC, in which case *name* is treated as an external procedure. +The *type* can also be [`PROC`](proc.md), in which case *name* is treated as an external procedure. ## See also diff --git a/docs/assembler/masm/masm-for-x64-ml64-exe.md b/docs/assembler/masm/masm-for-x64-ml64-exe.md index 95c7e531492..840b0020837 100644 --- a/docs/assembler/masm/masm-for-x64-ml64-exe.md +++ b/docs/assembler/masm/masm-for-x64-ml64-exe.md @@ -3,11 +3,10 @@ description: "Learn more about: Microsoft Macro Assembler (MASM) for x64 (ml64.e title: "MASM for x64 (ml64.exe)" ms.date: 09/21/2021 helpviewer_keywords: ["ml64", "ml64.exe", "masm for x64"] -ms.assetid: 89059103-f372-4968-80ea-0c7f90bb9c91 --- # MASM for x64 (ml64.exe) -Visual Studio includes both 32-bit and 64-bit hosted versions of MASM (the Microsoft Macro Assembler) to target x64 code. Named ml64.exe, it's the assembler that accepts x64 assembler language. The MASM command-line tools are installed when you choose a C++ workload during Visual Studio installation. The MASM tools aren't available as a separate download. For instructions on how to download and install a copy of Visual Studio, see [Install Visual Studio](/visualstudio/install/install-visual-studio). If you only want the command-line tools, not the full IDE, download the [Build Tools for Visual Studio](https://visualstudio.microsoft.com/downloads/#build-tools-for-visual-studio-2022). +Visual Studio includes both 32-bit and 64-bit hosted versions of MASM (the Microsoft Macro Assembler) to target x64 code. Named ml64.exe, it's the assembler that accepts x64 assembly language. The MASM command-line tools are installed when you choose a C++ workload during Visual Studio installation. The MASM tools aren't available as a separate download. For instructions on how to download and install a copy of Visual Studio, see [Install Visual Studio](/visualstudio/install/install-visual-studio). If you only want the command-line tools, not the full IDE, download the [Build Tools for Visual Studio](https://visualstudio.microsoft.com/downloads/#build-tools-for-visual-studio-2022). To use ml64.exe on the command line, start a developer command prompt for x64 targets. A developer command prompt sets the required path and other environment variables. For information on how to start a developer command prompt, see [Build C/C++ code on the command line](../../build/building-on-the-command-line.md). diff --git a/docs/assembler/masm/mmword.md b/docs/assembler/masm/mmword.md index 563ae8e444f..98ca8629498 100644 --- a/docs/assembler/masm/mmword.md +++ b/docs/assembler/masm/mmword.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: MMWORD" title: "MMWORD" -ms.date: "12/17/2019" +description: "Learn more about: MMWORD" +ms.date: 12/17/2019 f1_keywords: ["MMWORD"] helpviewer_keywords: ["MMWORD directive"] -ms.assetid: b4c5a104-9078-4fb4-afc3-d1e63abe562a --- # MMWORD @@ -32,6 +31,6 @@ While both instructions work on 64-bit operands, **QWORD** is the type for 64-bi movq mm0, mmword ptr [ebx] ``` -## See Also +## See also [MASM BNF Grammar](masm-bnf-grammar.md) diff --git a/docs/assembler/masm/option-avxencoding-masm.md b/docs/assembler/masm/option-avxencoding-masm.md index c019dc5f8cb..806b205a3bf 100644 --- a/docs/assembler/masm/option-avxencoding-masm.md +++ b/docs/assembler/masm/option-avxencoding-masm.md @@ -1,9 +1,9 @@ --- title: "OPTION AVXENCODING" +description: Describes how to select the preferred encoding of AVX instructions when more than one possibility will work ms.date: "10/06/2020" f1_keywords: ["avxencoding"] helpviewer_keywords: ["OPTION AVXENCODING directive"] -description: Describes how to select the preferred encoding of AVX instructions when more than one possibility will work --- # OPTION AVXENCODING @@ -47,7 +47,7 @@ The **`OPTION AVXENCODING`** directive is available in Visual Studio 2019 versio ### Example -This example uses `VPDPBUSD` and `VPMADDWD` instructions to illustrate how the **`AVXENCODING`** option works. `VPDPBUSD` was first defined to be encoded only with `EVEX`, and was later extended with a VEX-encoded form for platforms without AVX-512 support, while `VPMADDWD` was AVX and extended to AVX-512. The listing output from assembling the example shows how changing the **`AVXENCODING`** mode affects the object code generated for each instruction. The prefix for each instruction ends at the '/". +This example uses `VPDPBUSD` and `VPMADDWD` instructions to illustrate how the **`AVXENCODING`** option works. `VPDPBUSD` was first defined to be encoded only with `EVEX`, and was later extended with a VEX-encoded form for platforms without AVX-512 support, while `VPMADDWD` was AVX and extended to AVX-512. The listing output from assembling the example shows how changing the **`AVXENCODING`** mode affects the object code generated for each instruction. The prefix for each instruction ends at the "/". ```asm 00000000 62 F2 6D 08/ 50 vpdpbusd xmm1, xmm2, xmm3 diff --git a/docs/assembler/masm/option-language-masm.md b/docs/assembler/masm/option-language-masm.md index bc258e08f1b..1ba3c6cd7d6 100644 --- a/docs/assembler/masm/option-language-masm.md +++ b/docs/assembler/masm/option-language-masm.md @@ -1,6 +1,6 @@ --- -description: Learn more about the alternatives for the OPTION LANGUAGE directive title: "OPTION LANGUAGE" +description: "Learn more about the alternatives for the OPTION LANGUAGE directive" ms.date: 09/21/2021 f1_keywords: ["language"] helpviewer_keywords: ["OPTION LANGUAGE directive"] @@ -20,11 +20,11 @@ Available languages include: :::row::: :::column span=""::: **`C`**\ - **`SYSCALL`**\ + **`SYSCALL`** :::column-end::: :::column span=""::: **`STDCALL`**\ - **`PASCAL`**\ + **`PASCAL`** :::column-end::: :::column span=""::: **`FORTRAN`**\ diff --git a/docs/assembler/masm/purge.md b/docs/assembler/masm/purge.md index 2e19584edd1..9051b7fae9b 100644 --- a/docs/assembler/masm/purge.md +++ b/docs/assembler/masm/purge.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: PURGE" title: "PURGE" +description: "Learn more about: PURGE" ms.date: "12/16/2019" f1_keywords: ["PURGE"] helpviewer_keywords: ["PURGE directive"] -ms.assetid: 1e7ec2bf-f123-4ff9-97de-28b512ade2f9 --- # PURGE @@ -16,5 +15,5 @@ Deletes the specified macros from memory. ## See also -[Directives reference](directives-reference.md) +[Directives reference](directives-reference.md)\ [MASM BNF Grammar](masm-bnf-grammar.md) diff --git a/docs/assembler/masm/subttl.md b/docs/assembler/masm/subttl.md index b59e41f2247..a119b8eb142 100644 --- a/docs/assembler/masm/subttl.md +++ b/docs/assembler/masm/subttl.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: SUBTTL" title: "SUBTTL" +description: "Learn more about: SUBTTL" ms.date: "12/16/2019" f1_keywords: ["SUBTTL"] helpviewer_keywords: ["SUBTTL directive"] -ms.assetid: 927efadd-ec99-4de9-b64d-229bb2df3bf4 --- # SUBTTL @@ -16,5 +15,5 @@ See [SUBTITLE](subtitle.md). ## See also -[Directives reference](directives-reference.md) +[Directives reference](directives-reference.md)\ [MASM BNF Grammar](masm-bnf-grammar.md) diff --git a/docs/assembler/masm/xmmword.md b/docs/assembler/masm/xmmword.md index 3722fd23f48..9e4ef7c064e 100644 --- a/docs/assembler/masm/xmmword.md +++ b/docs/assembler/masm/xmmword.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: XMMWORD" title: "XMMWORD" -ms.date: "12/17/2019" +description: "Learn more about: XMMWORD" +ms.date: 12/17/2019 f1_keywords: ["XMMWORD"] helpviewer_keywords: ["XMMWORD directive"] -ms.assetid: 18026d32-5cab-403e-ad7e-382fb41aa9b8 --- # XMMWORD @@ -24,6 +23,6 @@ Used for 128-bit multimedia operands with MMX and SSE (XMM) instructions. movdqa xmm0, xmmword ptr [ebx] ``` -## See Also +## See also [MASM BNF Grammar](masm-bnf-grammar.md) diff --git a/docs/atl-mfc-shared/atl-mfc-shared-classes.md b/docs/atl-mfc-shared/atl-mfc-shared-classes.md index 4a0a3edbac8..564d03df38f 100644 --- a/docs/atl-mfc-shared/atl-mfc-shared-classes.md +++ b/docs/atl-mfc-shared/atl-mfc-shared-classes.md @@ -3,7 +3,7 @@ description: "Learn more about: ATL/MFC Shared Classes" title: "ATL-MFC Shared Classes" ms.custom: "index-page" ms.date: "11/04/2016" -ms.topic: "conceptual" +ms.topic: "concept-article" f1_keywords: ["vc.classes.shared"] helpviewer_keywords: ["CPoint class, shared class", "CFileTimeSpan class, shared class", "COleDateTime class, shared class", "CFixedStringT class, shared class", "CStrBufT class, shared class", "CFileTime class, shared class", "CRect class, shared class", "CSimpleStringT class, shared class", "CStringT class, shared class", "CSize class, shared class", "CStringData class, shared class", "IAtlStringMgr class, shared class", "shared classes, MFC and ATL", "COleDateTimeSpan class, shared class", "CString objects, shared class", "shared classes"] ms.assetid: e13aaac3-21ec-4f4d-8834-432b40fde544 diff --git a/docs/atl-mfc-shared/basic-cstring-operations.md b/docs/atl-mfc-shared/basic-cstring-operations.md index 41926fe05be..047bd978b28 100644 --- a/docs/atl-mfc-shared/basic-cstring-operations.md +++ b/docs/atl-mfc-shared/basic-cstring-operations.md @@ -1,9 +1,8 @@ --- -description: "Learn more about: Basic CString Operations" title: "Basic CString Operations" -ms.date: "11/04/2016" +description: "Learn more about: Basic CString Operations" +ms.date: 11/04/2016 helpviewer_keywords: ["CString objects, basic operations", "string literals, CString operations", "literal strings, CString operations", "CString objects", "string comparison, CString operations", "characters, accessing in CStrings"] -ms.assetid: 41db66b2-9427-4bb3-845a-9b6869159a6c --- # Basic CString Operations @@ -19,7 +18,7 @@ This topic explains the following basic [CString](../atl-mfc-shared/reference/cs - [Converting CString objects](#_core_converting_cstring_objects) -`Class CString` is based on class template [CStringT Class](../atl-mfc-shared/reference/cstringt-class.md). `CString` is a **`typedef`** of `CStringT`. More exactly, `CString` is a **`typedef`** of an *explicit specialization* of `CStringT`, which is a common way to use a class template to define a class. Similarly defined classes are `CStringA` and `CStringW`. +`Class CString` is based on class template [`CStringT`](../atl-mfc-shared/reference/cstringt-class.md). `CString` is a **`typedef`** of `CStringT`. More exactly, `CString` is a **`typedef`** of an *explicit specialization* of `CStringT`, which is a common way to use a class template to define a class. Similarly defined classes are `CStringA` and `CStringW`. `CString`, `CStringA`, and `CStringW` are defined in atlstr.h. `CStringT` is defined in cstringt.h. diff --git a/docs/atl-mfc-shared/codesnippet/CPP/cstringt-class_39.cpp b/docs/atl-mfc-shared/codesnippet/CPP/cstringt-class_39.cpp index d2b2eb6cf39..8886e69d9f7 100644 --- a/docs/atl-mfc-shared/codesnippet/CPP/cstringt-class_39.cpp +++ b/docs/atl-mfc-shared/codesnippet/CPP/cstringt-class_39.cpp @@ -8,4 +8,4 @@ { _tprintf_s(_T("Resulting token: %s\n"), resToken); resToken = str.Tokenize(_T("% #"), curPos); - }; \ No newline at end of file + } \ No newline at end of file diff --git a/docs/atl-mfc-shared/reference/cimage-class.md b/docs/atl-mfc-shared/reference/cimage-class.md index 0dd78992509..d355d0f27a4 100644 --- a/docs/atl-mfc-shared/reference/cimage-class.md +++ b/docs/atl-mfc-shared/reference/cimage-class.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: CImage Class" title: "CImage Class" -ms.date: "08/19/2019" +description: "Learn more about: CImage Class" +ms.date: 08/19/2019 f1_keywords: ["CImage", "ATLIMAGE/ATL::CImage", "ATLIMAGE/ATL::CImage::CImage", "ATLIMAGE/ATL::CImage::AlphaBlend", "ATLIMAGE/ATL::CImage::Attach", "ATLIMAGE/ATL::CImage::BitBlt", "ATLIMAGE/ATL::CImage::Create", "ATLIMAGE/ATL::CImage::CreateEx", "ATLIMAGE/ATL::CImage::Destroy", "ATLIMAGE/ATL::CImage::Detach", "ATLIMAGE/ATL::CImage::Draw", "ATLIMAGE/ATL::CImage::GetBits", "ATLIMAGE/ATL::CImage::GetBPP", "ATLIMAGE/ATL::CImage::GetColorTable", "ATLIMAGE/ATL::CImage::GetDC", "ATLIMAGE/ATL::CImage::GetExporterFilterString", "ATLIMAGE/ATL::CImage::GetHeight", "ATLIMAGE/ATL::CImage::GetImporterFilterString", "ATLIMAGE/ATL::CImage::GetMaxColorTableEntries", "ATLIMAGE/ATL::CImage::GetPitch", "ATLIMAGE/ATL::CImage::GetPixel", "ATLIMAGE/ATL::CImage::GetPixelAddress", "ATLIMAGE/ATL::CImage::GetTransparentColor", "ATLIMAGE/ATL::CImage::GetWidth", "ATLIMAGE/ATL::CImage::IsDIBSection", "ATLIMAGE/ATL::CImage::IsIndexed", "ATLIMAGE/ATL::CImage::IsNull", "ATLIMAGE/ATL::CImage::IsTransparencySupported", "ATLIMAGE/ATL::CImage::Load", "ATLIMAGE/ATL::CImage::LoadFromResource", "ATLIMAGE/ATL::CImage::MaskBlt", "ATLIMAGE/ATL::CImage::PlgBlt", "ATLIMAGE/ATL::CImage::ReleaseDC", "ATLIMAGE/ATL::CImage::ReleaseGDIPlus", "ATLIMAGE/ATL::CImage::Save", "ATLIMAGE/ATL::CImage::SetColorTable", "ATLIMAGE/ATL::CImage::SetPixel", "ATLIMAGE/ATL::CImage::SetPixelIndexed", "ATLIMAGE/ATL::CImage::SetPixelRGB", "ATLIMAGE/ATL::CImage::SetTransparentColor", "ATLIMAGE/ATL::CImage::StretchBlt", "ATLIMAGE/ATL::CImage::TransparentBlt"] helpviewer_keywords: ["jpeg files", "bitmaps [C++], ATL and MFC support for", "images [C++], ATL and MFC support for", "gif files, ATL and MFC support", ".gif files, ATL and MFC support", "PNG files, ATL and MFC support", "CImage class", "transparent color"] -ms.assetid: 52861e3d-bf7e-481f-a240-90e88f76c490 --- # `CImage` Class @@ -745,7 +744,7 @@ static HRESULT GetImporterFilterString( A reference to a `CSimpleString` object. See **Remarks** for more information. *`aguidFileTypes`*
-An array of GUIDs, with each element corresponding to one of the file types in the string. In the example in *`pszAllFilesDescription`* below, *`aguidFileTypes[0]*` is `GUID_NULL` with the remaining array values are the image file formats supported by the current operating system. +An array of GUIDs, with each element corresponding to one of the file types in the string. In the example in *`pszAllFilesDescription`* below, *`aguidFileTypes[0]`* is `GUID_NULL` with the remaining array values are the image file formats supported by the current operating system. > [!NOTE] > For a complete list of constants, see **Image File Format Constants** in the Windows SDK. diff --git a/docs/atl-mfc-shared/reference/codesnippet/CPP/cfiledialog-class_3.cpp b/docs/atl-mfc-shared/reference/codesnippet/CPP/cfiledialog-class_3.cpp index 69b8fc155de..9c7f028ed78 100644 --- a/docs/atl-mfc-shared/reference/codesnippet/CPP/cfiledialog-class_3.cpp +++ b/docs/atl-mfc-shared/reference/codesnippet/CPP/cfiledialog-class_3.cpp @@ -1,7 +1,7 @@ void CMyClass::OnFileOpen() { // szFilters is a text string that includes two file name filters: - // "*.my" for "MyType Files" and "*.*' for "All Files." + // "*.my" for "MyType Files" and "*.*" for "All Files." TCHAR szFilters[]= _T("MyType Files (*.my)|*.my|All Files (*.*)|*.*||"); // Create an Open dialog; the default file name extension is ".my". diff --git a/docs/atl-mfc-shared/reference/coledatetime-class.md b/docs/atl-mfc-shared/reference/coledatetime-class.md index b92a1c43532..5da193d9b93 100644 --- a/docs/atl-mfc-shared/reference/coledatetime-class.md +++ b/docs/atl-mfc-shared/reference/coledatetime-class.md @@ -1,10 +1,9 @@ --- title: "COleDateTime Class" description: "API reference for the MFC COleDateTime class which Encapsulates the `DATE` data type used in OLE automation." -ms.date: "08/27/2020" +ms.date: 08/27/2020 f1_keywords: ["COleDateTime", "ATLCOMTIME/ATL::COleDateTime", "ATLCOMTIME/ATL::COleDateTime::COleDateTime", "ATLCOMTIME/ATL::COleDateTime::Format", "ATLCOMTIME/ATL::COleDateTime::GetAsDBTIMESTAMP", "ATLCOMTIME/ATL::COleDateTime::GetAsSystemTime", "ATLCOMTIME/ATL::COleDateTime::GetAsUDATE", "ATLCOMTIME/ATL::COleDateTime::GetCurrentTime", "ATLCOMTIME/ATL::COleDateTime::GetDay", "ATLCOMTIME/ATL::COleDateTime::GetDayOfWeek", "ATLCOMTIME/ATL::COleDateTime::GetDayOfYear", "ATLCOMTIME/ATL::COleDateTime::GetHour", "ATLCOMTIME/ATL::COleDateTime::GetMinute", "ATLCOMTIME/ATL::COleDateTime::GetMonth", "ATLCOMTIME/ATL::COleDateTime::GetSecond", "ATLCOMTIME/ATL::COleDateTime::GetStatus", "ATLCOMTIME/ATL::COleDateTime::GetYear", "ATLCOMTIME/ATL::COleDateTime::ParseDateTime", "ATLCOMTIME/ATL::COleDateTime::SetDate", "ATLCOMTIME/ATL::COleDateTime::SetDateTime", "ATLCOMTIME/ATL::COleDateTime::SetStatus", "ATLCOMTIME/ATL::COleDateTime::SetTime", "ATLCOMTIME/ATL::COleDateTime::m_dt", "ATLCOMTIME/ATL::COleDateTime::m_status"] helpviewer_keywords: ["shared classes, COleDateTime", "time-only values", "Date data type, MFC encapsulation of", "COleDateTime class", "dates, handling in MFC", "time, handling in MFC"] -ms.assetid: e718f294-16ec-4649-88b6-a4dbae5178fb --- # COleDateTime Class @@ -211,7 +210,7 @@ Following is a brief description of each constructor: - `COleDateTime(` `dateSrc` **)** Constructs a `COleDateTime` object from an existing `COleDateTime` object. -- `COleDateTime(` *varSrc* **)** Constructs a `COleDateTime` object. Attempts to convert a `VARIANT` structure or [COleVariant](../../mfc/reference/colevariant-class.md) object to a date/time ( `VT_DATE`) value. If this conversion is successful, the converted value is copied into the new `COleDateTime` object. If it is not, the value of the `COleDateTime` object is set to 0 (midnight, 30 December 1899) and its status to invalid. +- `COleDateTime(` *varSrc* **)** Constructs a `COleDateTime` object. Attempts to convert a `VARIANT` structure or [COleVariant](../../mfc/reference/colevariant-class.md) object to a date/time (`VT_DATE`) value. If this conversion is successful, the converted value is copied into the new `COleDateTime` object. If it is not, the value of the `COleDateTime` object is set to 0 (midnight, 30 December 1899) and its status to invalid. - `COleDateTime(` `dtSrc` **)** Constructs a `COleDateTime` object from a `DATE` value. @@ -263,7 +262,7 @@ Indicates one of the following locale flags: Indicates locale ID to use for the conversion. For more information about language identifiers, see [Language Identifiers](/windows/win32/Intl/language-identifiers). *lpszFormat*
-A formatting string similar to the `printf` formatting string. Each formatting code, preceded by a percent ( `%`) sign, is replaced by the corresponding `COleDateTime` component. Other characters in the formatting string are copied unchanged to the returned string. For more information, see the run-time function [strftime](../../c-runtime-library/reference/strftime-wcsftime-strftime-l-wcsftime-l.md). The value and meaning of the formatting codes for `Format` are: +A formatting string similar to the `printf` formatting string. Each formatting code, preceded by a percent (`%`) sign, is replaced by the corresponding `COleDateTime` component. Other characters in the formatting string are copied unchanged to the returned string. For more information, see the run-time function [strftime](../../c-runtime-library/reference/strftime-wcsftime-strftime-l-wcsftime-l.md). The value and meaning of the formatting codes for `Format` are: - `%H` Hours in the current day diff --git a/docs/atl-mfc-shared/reference/crect-class.md b/docs/atl-mfc-shared/reference/crect-class.md index d05e09be56c..a213a9fcb66 100644 --- a/docs/atl-mfc-shared/reference/crect-class.md +++ b/docs/atl-mfc-shared/reference/crect-class.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: CRect Class" title: "CRect Class" -ms.date: "11/06/2018" +description: "Learn more about: CRect Class" +ms.date: 11/06/2018 f1_keywords: ["CRect", "ATLTYPES/ATL::CRect", "ATLTYPES/ATL::CRect::CRect", "ATLTYPES/ATL::CRect::BottomRight", "ATLTYPES/ATL::CRect::CenterPoint", "ATLTYPES/ATL::CRect::CopyRect", "ATLTYPES/ATL::CRect::DeflateRect", "ATLTYPES/ATL::CRect::EqualRect", "ATLTYPES/ATL::CRect::Height", "ATLTYPES/ATL::CRect::InflateRect", "ATLTYPES/ATL::CRect::IntersectRect", "ATLTYPES/ATL::CRect::IsRectEmpty", "ATLTYPES/ATL::CRect::IsRectNull", "ATLTYPES/ATL::CRect::MoveToX", "ATLTYPES/ATL::CRect::MoveToXY", "ATLTYPES/ATL::CRect::MoveToY", "ATLTYPES/ATL::CRect::NormalizeRect", "ATLTYPES/ATL::CRect::OffsetRect", "ATLTYPES/ATL::CRect::PtInRect", "ATLTYPES/ATL::CRect::SetRect", "ATLTYPES/ATL::CRect::SetRectEmpty", "ATLTYPES/ATL::CRect::Size", "ATLTYPES/ATL::CRect::SubtractRect", "ATLTYPES/ATL::CRect::TopLeft", "ATLTYPES/ATL::CRect::UnionRect", "ATLTYPES/ATL::CRect::Width"] helpviewer_keywords: ["LPCRECT data type", "CRect class", "LPRECT operator", "RECT structure"] -ms.assetid: dee4e752-15d6-4db4-b68f-1ad65b2ed6ca --- # `CRect` Class @@ -745,7 +744,9 @@ rect.OffsetRect(230, 230); ASSERT(rect == CRect(230, 230, 265, 265)); ``` -## `CRect::operator LPCRECT` Converts a `CRect` to an [`LPCRECT`](../../mfc/reference/data-types-mfc.md). +## `CRect::operator LPCRECT` + +Converts a `CRect` to an [`LPCRECT`](../../mfc/reference/data-types-mfc.md). ```cpp operator LPCRECT() const throw(); diff --git a/docs/atl-mfc-shared/reference/csimplestringt-class.md b/docs/atl-mfc-shared/reference/csimplestringt-class.md index 66813334102..b62a850efa1 100644 --- a/docs/atl-mfc-shared/reference/csimplestringt-class.md +++ b/docs/atl-mfc-shared/reference/csimplestringt-class.md @@ -716,28 +716,6 @@ CSimpleString s(_T("abc"), pMgr); ASSERT(s[1] == _T('b')); ``` -## `CSimpleStringT::operator []` - -Call this function to access a single character of the character array. - -### Syntax - -```cpp -XCHAR operator[](int iChar) const; -``` - -### Parameters - -*`iChar`*
-Zero-based index of a character in the string. - -### Remarks - -The overloaded subscript (**`[]`**) operator returns a single character specified by the zero-based index in *`iChar`*. This operator is a convenient substitute for the [`GetAt`](#getat) member function. - -> [!NOTE] -> You can use the subscript (**`[]`**) operator to get the value of a character in a `CSimpleStringT`, but you cannot use it to change the value of a character in a `CSimpleStringT`. - ## `CSimpleStringT::operator +=` Joins a new string or character to the end of an existing string. diff --git a/docs/atl-mfc-shared/reference/csize-class.md b/docs/atl-mfc-shared/reference/csize-class.md index c6fc7033fd3..f398b5055da 100644 --- a/docs/atl-mfc-shared/reference/csize-class.md +++ b/docs/atl-mfc-shared/reference/csize-class.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: CSize Class" title: "CSize Class" -ms.date: "10/18/2018" +description: "Learn more about: CSize Class" +ms.date: 10/18/2018 f1_keywords: ["CSize", "ATLTYPES/ATL::CSize", "ATLTYPES/ATL::CSize::CSize"] helpviewer_keywords: ["SIZE", "dimensions, MFC", "dimensions", "CSize class"] -ms.assetid: fb2cf85a-0bc1-46f8-892b-309c108b52ae --- # CSize Class @@ -101,7 +100,7 @@ BOOL operator==(SIZE size) const throw(); ### Remarks -Returns nonzero if the sizes are equal, otherwize 0. +Returns nonzero if the sizes are equal, otherwise 0. ### Example diff --git a/docs/atl-mfc-shared/reference/cstringt-class.md b/docs/atl-mfc-shared/reference/cstringt-class.md index ffff1211a42..a47c9ad9a69 100644 --- a/docs/atl-mfc-shared/reference/cstringt-class.md +++ b/docs/atl-mfc-shared/reference/cstringt-class.md @@ -486,11 +486,11 @@ A handle for a **`CStringT`** object. Because the constructors copy the input data into new allocated storage, memory exceptions may result. Some of these constructors act as conversion functions. This allows you to substitute, for example, an **`LPTSTR`** where a **`CStringT`** object is expected. -- **`CStringT`**( `LPCSTR` `lpsz` ): Constructs a Unicode **`CStringT`** from an ANSI string. You can also use this constructor to load a string resource as shown in the example below. +- **`CStringT`**(`LPCSTR` `lpsz`): Constructs a Unicode **`CStringT`** from an ANSI string. You can also use this constructor to load a string resource as shown in the example below. -- `CStringT(` `LPCWSTR` `lpsz` ): Constructs a **`CStringT`** from a Unicode string. +- **`CStringT`**(`LPCWSTR` `lpsz`): Constructs a **`CStringT`** from a Unicode string. -- **`CStringT`**( `const unsigned char*` `psz` ): Allows you to construct a **`CStringT`** from a pointer to **`unsigned char`**. +- **`CStringT`**(`const unsigned char*` `psz`): Allows you to construct a **`CStringT`** from a pointer to **`unsigned char`**. > [!NOTE] > Define the `_CSTRING_DISABLE_NARROW_WIDE_CONVERSION` macro to turn off implicit string conversion between ANSI and Unicode strings. The macro excludes from compilation constructors that support conversion. @@ -998,11 +998,11 @@ Concatenates two strings or a character and a string. ```cpp friend CStringT operator+(const CStringT& str1, const CStringT& str2); friend CStringT operator+(const CStringT& str1, PCXSTR psz2); -friend CStringT operator+(PCXSTR psz1, const CStringT& str2,); -friend CStringT operator+(char ch1, const CStringT& str2,); +friend CStringT operator+(PCXSTR psz1, const CStringT& str2); +friend CStringT operator+(char ch1, const CStringT& str2); friend CStringT operator+(const CStringT& str1, char ch2); friend CStringT operator+(const CStringT& str1, wchar_t ch2); -friend CStringT operator+(wchar_t ch1, const CStringT& str2,); +friend CStringT operator+(wchar_t ch1, const CStringT& str2); ``` ### Parameters @@ -1102,8 +1102,8 @@ friend bool operator==(const CStringT& str1, PCXSTR psz2) throw(); friend bool operator==(const CStringT& str1, PCYSTR psz2) throw(); friend bool operator==(const CStringT& str1, XCHAR ch2) throw(); friend bool operator==(PCXSTR psz1, const CStringT& str2) throw(); -friend bool operator==(PCYSTR psz1, const CStringT& str2,) throw(); -friend bool operator==(XCHAR ch1, const CStringT& str2,) throw(); +friend bool operator==(PCYSTR psz1, const CStringT& str2) throw(); +friend bool operator==(XCHAR ch1, const CStringT& str2) throw(); ``` ### Parameters @@ -1144,8 +1144,8 @@ friend bool operator!=(const CStringT& str1, PCXSTR psz2) throw(); friend bool operator!=(const CStringT& str1, PCYSTR psz2) throw(); friend bool operator!=(const CStringT& str1, XCHAR ch2) throw(); friend bool operator!=(PCXSTR psz1, const CStringT& str2) throw(); -friend bool operator!=(PCYSTR psz1, const CStringT& str2,) throw(); -friend bool operator!=(XCHAR ch1, const CStringT& str2,) throw(); +friend bool operator!=(PCYSTR psz1, const CStringT& str2) throw(); +friend bool operator!=(XCHAR ch1, const CStringT& str2) throw(); ``` ### Parameters diff --git a/docs/atl/active-template-library-atl-concepts.md b/docs/atl/active-template-library-atl-concepts.md index bf9f677b9a1..cda405159a6 100644 --- a/docs/atl/active-template-library-atl-concepts.md +++ b/docs/atl/active-template-library-atl-concepts.md @@ -4,6 +4,7 @@ title: "Active Template Library (ATL) Concepts" ms.date: "05/06/2019" helpviewer_keywords: ["ATL, about ATL"] ms.assetid: a3960991-4d76-4da5-9568-3fa7fde53ff4 +ms.topic: concept-article --- # Active Template Library (ATL) Concepts diff --git a/docs/atl/active-template-library-atl-tutorial.md b/docs/atl/active-template-library-atl-tutorial.md index 52c536ff965..2a9841ea00c 100644 --- a/docs/atl/active-template-library-atl-tutorial.md +++ b/docs/atl/active-template-library-atl-tutorial.md @@ -5,6 +5,7 @@ ms.custom: "get-started-article" ms.date: "05/03/2019" helpviewer_keywords: ["ATL projects, tutorials", "controls [ATL], tutorials", "ATL tutorial", "tutorials [ATL]", "ATL, tutorials"] ms.assetid: f921a121-09c8-4812-9317-e15b2f1471fa +ms.topic: tutorial --- # Active Template Library (ATL) Tutorial diff --git a/docs/atl/adding-a-control-atl-tutorial-part-2.md b/docs/atl/adding-a-control-atl-tutorial-part-2.md index 64913399d10..668cb2039f1 100644 --- a/docs/atl/adding-a-control-atl-tutorial-part-2.md +++ b/docs/atl/adding-a-control-atl-tutorial-part-2.md @@ -4,6 +4,7 @@ title: "Adding a Control (ATL Tutorial, Part 2)" ms.custom: "get-started-article" ms.date: "08/19/2019" ms.assetid: c9575a75-1064-41f1-9697-7aada560c669 +ms.topic: tutorial --- # Adding a Control (ATL Tutorial, Part 2) diff --git a/docs/atl/adding-a-property-page-atl-tutorial-part-6.md b/docs/atl/adding-a-property-page-atl-tutorial-part-6.md index 77ab6f873a6..394d9aff8da 100644 --- a/docs/atl/adding-a-property-page-atl-tutorial-part-6.md +++ b/docs/atl/adding-a-property-page-atl-tutorial-part-6.md @@ -4,6 +4,7 @@ title: "Adding a Property Page (ATL Tutorial, Part 6)" ms.custom: "get-started-article" ms.date: "09/27/2018" ms.assetid: df80d255-e7ea-49d9-b940-3f012e90cf9b +ms.topic: tutorial --- # Adding a Property Page (ATL Tutorial, Part 6) diff --git a/docs/atl/adding-a-property-to-the-control-atl-tutorial-part-3.md b/docs/atl/adding-a-property-to-the-control-atl-tutorial-part-3.md index eae5f195dd7..839a2653ed1 100644 --- a/docs/atl/adding-a-property-to-the-control-atl-tutorial-part-3.md +++ b/docs/atl/adding-a-property-to-the-control-atl-tutorial-part-3.md @@ -4,6 +4,7 @@ title: "Adding a Property to the Control (ATL Tutorial, Part 3)" ms.custom: "get-started-article" ms.date: "09/26/2018" ms.assetid: f775fe34-103b-4f07-9999-400e987ee030 +ms.topic: tutorial --- # Adding a Property to the Control (ATL Tutorial, Part 3) diff --git a/docs/atl/adding-an-atl-message-handler.md b/docs/atl/adding-an-atl-message-handler.md index e7dd2532992..ee2243126a9 100644 --- a/docs/atl/adding-an-atl-message-handler.md +++ b/docs/atl/adding-an-atl-message-handler.md @@ -4,6 +4,7 @@ title: "Adding an ATL Message Handler" ms.date: "11/04/2016" helpviewer_keywords: ["message handlers [C++]", "ATL, windows", "message handling [C++], ATL message handler", "windows [C++], ATL", "ATL, message handlers"] ms.assetid: cdea38a1-0d9b-4f8d-bbd5-b4f063fb3eeb +ms.topic: concept-article --- # Adding an ATL Message Handler diff --git a/docs/atl/adding-an-event-atl-tutorial-part-5.md b/docs/atl/adding-an-event-atl-tutorial-part-5.md index 18306b8df03..48d9ef8f01d 100644 --- a/docs/atl/adding-an-event-atl-tutorial-part-5.md +++ b/docs/atl/adding-an-event-atl-tutorial-part-5.md @@ -4,6 +4,7 @@ title: "Adding an Event (ATL Tutorial, Part 5)" ms.custom: "get-started-article" ms.date: "09/27/2018" ms.assetid: 2de12022-3148-4ce3-8606-8a9d4274f0e9 +ms.topic: tutorial --- # Adding an Event (ATL Tutorial, Part 5) diff --git a/docs/atl/adding-connection-points-to-an-object.md b/docs/atl/adding-connection-points-to-an-object.md index 671460f394d..d2564c44cd6 100644 --- a/docs/atl/adding-connection-points-to-an-object.md +++ b/docs/atl/adding-connection-points-to-an-object.md @@ -1,58 +1,55 @@ --- -description: "Learn more about: Adding Connection Points to an Object" title: "Adding Connection Points to an Object" -ms.date: "11/04/2016" +description: "Learn more about: Adding Connection Points to an Object" +ms.date: 11/04/2016 helpviewer_keywords: ["connection points [C++], adding to ATL objects", "Implement Connection Point ATL wizard"] -ms.assetid: 843531be-4a36-4db0-9d54-e029b1a72a8b +ms.topic: how-to --- # Adding Connection Points to an Object -The [ATL Tutorial](../atl/active-template-library-atl-tutorial.md) demonstrates how to create a control with support for connection points, how to add events, and then how to implement the connection point. ATL implements connection points with the [IConnectionPointImpl](../atl/reference/iconnectionpointimpl-class.md) class. +The [ATL Tutorial](active-template-library-atl-tutorial.md) demonstrates how to create a control with support for connection points, how to add events, and then how to implement the connection point. ATL implements connection points with the [`IConnectionPointImpl`](reference/iconnectionpointimpl-class.md) class. To implement a connection point, you have two choices: - Implement your own outgoing event source, by adding a connection point to the control or object. - - Reuse a connection point interface defined in another type library. -In either case, the Implement Connection Point Wizard uses a type library to do its work. +In either case, the **Implement Connection Point Wizard** uses a type library to do its work. -### To add a connection point to a control or object +### Add a connection point to a control or object -1. Define a dispinterface in the library block of the .idl file. If you enabled support for connection points when you created the control with the ATL Control Wizard, the dispinterface will already be created. If you did not enable support for connection points when you created the control, you must manually add a dispinterface to the .idl file. The following is an example of a dispinterface. Outgoing interfaces are not required to be dispatch interfaces but many scripting languages such as VBScript and JScript require this, so this example uses two dispinterfaces: +1. Define a dispinterface in the library block of the `.idl` file. If you enabled support for connection points when you created the control with the **ATL Control Wizard**, the dispinterface will already be created. If you did not enable support for connection points when you created the control, you must manually add a dispinterface to the `.idl` file. The following is an example of a dispinterface. Outgoing interfaces are not required to be dispatch interfaces but many scripting languages such as VBScript and JScript require this, so this example uses two dispinterfaces: - [!code-cpp[NVC_ATL_Windowing#81](../atl/codesnippet/cpp/adding-connection-points-to-an-object_1.idl)] + [!code-cpp[NVC_ATL_Windowing#81](codesnippet/cpp/adding-connection-points-to-an-object_1.idl)] - Use either the uuidgen.exe or guidgen.exe utility to generate a GUID. + Use either the `uuidgen.exe` or `guidgen.exe` utility to generate a GUID. -2. Add the dispinterface as the `[default,source]` interface in the coclass for the object in the project's .idl file. Again, if you enabled support for connection points when you created the control, the ATL Control Wizard will create the `[default,source`] entry. To manually add this entry, add the line in bold: +2. Add the dispinterface as the `[default,source]` interface in the coclass for the object in the project's `.idl` file. Again, if you enabled support for connection points when you created the control, the ATL Control Wizard will create the `[default,source]` entry. To manually add this entry, add the line in bold: - [!code-cpp[NVC_ATL_Windowing#82](../atl/codesnippet/cpp/adding-connection-points-to-an-object_2.idl)] + [!code-cpp[NVC_ATL_Windowing#82](codesnippet/cpp/adding-connection-points-to-an-object_2.idl)] - See the .idl file in the [Circ](../overview/visual-cpp-samples.md) ATL sample for an example. + See the `.idl` file in the [Circ](../overview/visual-cpp-samples.md) ATL sample for an example. -3. Use Class View to add methods and properties to the event interface. Right-click the class in Class View, point to **Add** on the shortcut menu, and click **Add Connection Point**. +3. Use **Class View** to add methods and properties to the event interface. Right-click the class in **Class View**, point to **Add** on the shortcut menu, and select **Add Connection Point**. -4. In the **Source Interfaces** list box of the Implement Connection Point Wizard, select **Project's interfaces**. If you choose an interface for your control and press **OK**, you will: +4. In the **Source Interfaces** list box of the **Implement Connection Point Wizard**, select **Project's interfaces**. If you choose an interface for your control and select **OK**, you: - Generate a header file with an event proxy class that implements the code that will make the outgoing calls for the event. - - Add an entry to the connection point map. - You will also see a list of all of the type libraries on your computer. You should only use one of these other type libraries to define your connection point if you want to implement the exact same outgoing interface found in another type library. - -### To reuse a connection point interface defined in another type library + You also see a list of all of the type libraries on your computer. Only use one of these other type libraries to define your connection point if you want to implement the exact same outgoing interface found in another type library. -1. In Class View, right-click a class that implements a **BEGIN_COM_MAP** macro, point to **Add** on the shortcut menu, and click **Add Connection Point**. +### Reuse a connection point interface defined in another type library -2. In the Implement Connection Point Wizard, select a type library and an interface in the type library and click **Add**. +1. In **Class View**, right-click a class that implements a `BEGIN_COM_MAP` macro, point at **Add** on the shortcut menu, and select **Add Connection Point**. -3. Edit the .idl file to either: +2. In the **Implement Connection Point Wizard**, select a type library and an interface in the type library and select **Add**. - - Copy the dispinterface from the .idl file for the object whose event-source is being used. +3. Edit the `.idl` file to either: + - Copy the dispinterface from the `.idl` file for the object whose event-source is being used. - Use the **importlib** instruction on that type library. ## See also -[Connection Point](../atl/atl-connection-points.md) +[Connection Point](atl-connection-points.md) diff --git a/docs/atl/adding-functionality-to-the-composite-control.md b/docs/atl/adding-functionality-to-the-composite-control.md index 77ef261e3b0..35766209450 100644 --- a/docs/atl/adding-functionality-to-the-composite-control.md +++ b/docs/atl/adding-functionality-to-the-composite-control.md @@ -4,6 +4,7 @@ title: "Adding Functionality to the Composite Control" ms.date: "11/04/2016" helpviewer_keywords: ["event handlers [C++], ActiveX controls", "composite controls, handling events", "ActiveX controls [C++], events"] ms.assetid: 98f85681-9564-480d-af38-03f9733fe58b +ms.topic: concept-article --- # Adding Functionality to the Composite Control diff --git a/docs/atl/atl-class-overview.md b/docs/atl/atl-class-overview.md index 5b028118055..98846a0de5f 100644 --- a/docs/atl/atl-class-overview.md +++ b/docs/atl/atl-class-overview.md @@ -4,6 +4,7 @@ title: "ATL class overview" ms.date: "11/04/2016" helpviewer_keywords: ["classes [C++], ATL", "ATL, class reference"] ms.assetid: c38ac93d-c3a2-4ce7-8153-f1d34c0f0fa6 +ms.topic: concept-article --- # ATL class overview diff --git a/docs/atl/atl-collection-classes.md b/docs/atl/atl-collection-classes.md index 7545e6d6906..db96014d6f0 100644 --- a/docs/atl/atl-collection-classes.md +++ b/docs/atl/atl-collection-classes.md @@ -4,6 +4,7 @@ title: "ATL collection class overview" ms.date: "11/19/2018" helpviewer_keywords: ["DestructElements function", "collection classes, choosing", "ConstructElements function", "SerializeElements function", "traits classes", "collection classes, about collection classes", "CTraits classes", "collection classes"] ms.assetid: 4d619d46-5b4e-41dd-b9fd-e86b1fbc00b5 +ms.topic: concept-article --- # ATL Collection Classes diff --git a/docs/atl/atl-utilities-reference.md b/docs/atl/atl-utilities-reference.md index 1fe2da43038..d903e4dbab6 100644 --- a/docs/atl/atl-utilities-reference.md +++ b/docs/atl/atl-utilities-reference.md @@ -1,8 +1,7 @@ --- -description: "Learn more about: ATL utilities reference" title: "ATL utilities reference" -ms.date: "11/04/2016" -ms.assetid: dd8a2888-34f4-461e-9bf4-834218f9b95b +description: "Learn more about: ATL utilities reference" +ms.date: 11/04/2016 --- # ATL utilities reference @@ -10,7 +9,7 @@ ATL provides code for manipulating paths and URLs in the form of [CPathT](../atl ## Classes -|   |   | +| Name | Description | |--|--| | [CPathT class](../atl/reference/cpatht-class.md) | This class represents a path. | | [CDebugReportHook class](../atl/reference/cdebugreporthook-class.md) | Use this class to send debug reports to a named pipe. | @@ -22,7 +21,7 @@ ATL provides code for manipulating paths and URLs in the form of [CPathT](../atl ## Typedefs -|   |   | +| Name | Description | |--|--| | [CPath](../atl/reference/atl-typedefs.md#cpath) | A specialization of [CPathT](../atl/reference/cpatht-class.md) using `CString`. | | [CPathA](../atl/reference/atl-typedefs.md#cpatha) | A specialization of [CPathT](../atl/reference/cpatht-class.md) using `CStringA`. | @@ -31,13 +30,13 @@ ATL provides code for manipulating paths and URLs in the form of [CPathT](../atl ## Enums -|   |   | +| Name | Description | |--|--| | [ATL_URL_SCHEME](../atl/reference/atl-url-scheme-enum.md) | The members of this enumeration provide constants for the schemes understood by [CUrl](../atl/reference/curl-class.md). | ## Functions -|   |   | +| Name | Description | |--|--| | [AtlCanonicalizeUrl](../atl/reference/atl-http-utility-functions.md#atlcanonicalizeurl) | Call this function to canonicalize a URL, which includes converting unsafe characters and spaces into escape sequences. | | [AtlCombineUrl](../atl/reference/atl-http-utility-functions.md#atlcombineurl) | Call this function to combine a base URL and a relative URL into a single, canonical URL. | @@ -47,8 +46,7 @@ ATL provides code for manipulating paths and URLs in the form of [CPathT](../atl | [AtlIsUnsafeUrlChar](../atl/reference/atl-http-utility-functions.md#atlisunsafeurlchar) | Call this function to find out whether a character is safe for use in a URL. | | [AtlUnescapeUrl](../atl/reference/atl-http-utility-functions.md#atlunescapeurl) | Call this function to convert escaped characters back to their original values. | | [SystemTimeToHttpDate](../atl/reference/atl-http-utility-functions.md#systemtimetohttpdate) | Call this function to convert a system time to a string in a format suitable for using in HTTP headers. | -| [ATLPath::AddBackslash](../atl/reference/atl-path-functions.md#addbackslash) | This function is an overloaded wrapper for [PathAddBackslash](/windows/desktop/api/shlwapi/nf-shlwapi-pathaddbackslasha | -| ). | +| [ATLPath::AddBackslash](../atl/reference/atl-path-functions.md#addbackslash) | This function is an overloaded wrapper for [PathAddBackslash](/windows/win32/api/shlwapi/nf-shlwapi-pathaddbackslasha). | | [ATLPath::AddExtension](../atl/reference/atl-path-functions.md#addextension) | This function is an overloaded wrapper for [PathAddExtension](/windows/win32/api/shlwapi/nf-shlwapi-pathaddextensionw). | | [ATLPath::Append](../atl/reference/atl-path-functions.md#append) | This function is an overloaded wrapper for [PathAppend](/windows/win32/api/shlwapi/nf-shlwapi-pathappendw). | | [ATLPath::BuildRoot](../atl/reference/atl-path-functions.md#buildroot) | This function is an overloaded wrapper for [PathBuildRoot](/windows/win32/api/shlwapi/nf-shlwapi-pathbuildrootw). | @@ -87,5 +85,5 @@ ATL provides code for manipulating paths and URLs in the form of [CPathT](../atl ## See also -[Concepts](../atl/active-template-library-atl-concepts.md)
+[Concepts](../atl/active-template-library-atl-concepts.md)\ [ATL COM desktop components](../atl/atl-com-desktop-components.md) diff --git a/docs/atl/building-and-testing-the-atl-project.md b/docs/atl/building-and-testing-the-atl-project.md index 9a5c30dd382..d5920c6e591 100644 --- a/docs/atl/building-and-testing-the-atl-project.md +++ b/docs/atl/building-and-testing-the-atl-project.md @@ -4,6 +4,7 @@ title: "Building and Testing the ATL Project" ms.date: "11/04/2016" helpviewer_keywords: ["composite controls, building and testing the project", "composite controls, containers for"] ms.assetid: 5c1541f8-f6cb-4c22-bd22-c66bcfbaa077 +ms.topic: concept-article --- # Building and Testing the ATL Project diff --git a/docs/atl/calling-cpp-code-from-dhtml.md b/docs/atl/calling-cpp-code-from-dhtml.md index 64b57d32b47..a5d05fe09ee 100644 --- a/docs/atl/calling-cpp-code-from-dhtml.md +++ b/docs/atl/calling-cpp-code-from-dhtml.md @@ -4,6 +4,7 @@ title: "Calling C++ Code from DHTML" ms.date: "11/04/2016" helpviewer_keywords: ["DHTML, calling C++ code from"] ms.assetid: 37329acd-4c22-40ca-a85a-b7480748f75f +ms.topic: concept-article --- # Calling C++ Code from DHTML diff --git a/docs/atl/changing-the-default-class-factory-and-aggregation-model.md b/docs/atl/changing-the-default-class-factory-and-aggregation-model.md index 5cc79f13e54..78b9ca1c8a0 100644 --- a/docs/atl/changing-the-default-class-factory-and-aggregation-model.md +++ b/docs/atl/changing-the-default-class-factory-and-aggregation-model.md @@ -4,6 +4,7 @@ title: "Changing the Default Class Factory and Aggregation Model" ms.date: "11/04/2016" helpviewer_keywords: ["CComClassFactory class, making the default", "aggregation [C++], using ATL", "aggregation [C++], aggregation models", "defaults [C++], aggregation model in ATL", "default class factory", "class factories, changing default", "CComCoClass class, default class factory and aggregation model", "default class factory, ATL", "defaults [C++], class factory"] ms.assetid: 6e040e95-0f38-4839-8a8b-c9800dd47e8c +ms.topic: concept-article --- # Changing the Default Class Factory and Aggregation Model diff --git a/docs/atl/changing-the-drawing-code-atl-tutorial-part-4.md b/docs/atl/changing-the-drawing-code-atl-tutorial-part-4.md index ae8149664e8..2ed4a960e6b 100644 --- a/docs/atl/changing-the-drawing-code-atl-tutorial-part-4.md +++ b/docs/atl/changing-the-drawing-code-atl-tutorial-part-4.md @@ -5,6 +5,7 @@ ms.custom: "get-started-article" ms.date: "09/26/2018" helpviewer_keywords: ["_ATL_MIN_CRT macro"] ms.assetid: 08ff14e8-aa49-4139-a110-5d071939cf1e +ms.topic: tutorial --- # Changing the Drawing Code (ATL Tutorial, Part 4) diff --git a/docs/atl/codesnippet/CPP/atl-collection-classes_1.cpp b/docs/atl/codesnippet/CPP/atl-collection-classes_1.cpp index 876ad2f58cf..baa1deb220f 100644 --- a/docs/atl/codesnippet/CPP/atl-collection-classes_1.cpp +++ b/docs/atl/codesnippet/CPP/atl-collection-classes_1.cpp @@ -29,7 +29,7 @@ class MyTraits : public CElementTraits< MyData > return true; else return false; - }; + } }; void DoAtlCustomTraitsList() diff --git a/docs/atl/creating-an-aggregated-object.md b/docs/atl/creating-an-aggregated-object.md index ea3e0cb8d69..f0bc8d88b24 100644 --- a/docs/atl/creating-an-aggregated-object.md +++ b/docs/atl/creating-an-aggregated-object.md @@ -4,6 +4,7 @@ title: "Creating an Aggregated Object" ms.date: "11/04/2016" helpviewer_keywords: ["aggregation [C++], creating aggregated objects", "aggregate objects [C++], creating"] ms.assetid: fc29d7aa-fd53-4276-9c2f-37379f71b179 +ms.topic: how-to --- # Creating an Aggregated Object diff --git a/docs/atl/creating-an-atl-dhtml-control.md b/docs/atl/creating-an-atl-dhtml-control.md index 8a6d94f04e1..1831d58d0b3 100644 --- a/docs/atl/creating-an-atl-dhtml-control.md +++ b/docs/atl/creating-an-atl-dhtml-control.md @@ -4,6 +4,7 @@ title: "Creating an ATL DHTML Control" ms.date: "11/04/2016" helpviewer_keywords: ["HTML controls, creating", "DHTML controls", "DHTML controls, creating"] ms.assetid: 1d8f0ede-7d8b-4959-976e-b4d0e2a87f5a +ms.topic: how-to --- # Creating an ATL DHTML Control diff --git a/docs/atl/creating-registrar-scripts.md b/docs/atl/creating-registrar-scripts.md index e4a6c996184..d9d281b53ab 100644 --- a/docs/atl/creating-registrar-scripts.md +++ b/docs/atl/creating-registrar-scripts.md @@ -4,6 +4,7 @@ title: "Creating scripts for ATL Registrar" ms.date: "05/14/2014" helpviewer_keywords: ["scripting, registry scripting", "ATL, registry", "registrar scripts [ATL]", "scripts, Registrar scripts", "scripts, creating"] ms.assetid: cbd5024b-8061-4a71-be65-7fee90374a35 +ms.topic: concept-article --- # Creating Registrar scripts diff --git a/docs/atl/creating-the-project-atl-tutorial-part-1.md b/docs/atl/creating-the-project-atl-tutorial-part-1.md index 9326e91f39d..b8a01fd2255 100644 --- a/docs/atl/creating-the-project-atl-tutorial-part-1.md +++ b/docs/atl/creating-the-project-atl-tutorial-part-1.md @@ -4,6 +4,7 @@ title: "Creating the Project (ATL Tutorial, Part 1)" ms.custom: "get-started-article" ms.date: "08/19/2019" ms.assetid: f6b727d1-390a-4b27-b82f-daadcd9fc059 +ms.topic: tutorial --- # Creating the Project (ATL Tutorial, Part 1) diff --git a/docs/atl/debugging-tips.md b/docs/atl/debugging-tips.md index 986845b3192..5fcdee636d5 100644 --- a/docs/atl/debugging-tips.md +++ b/docs/atl/debugging-tips.md @@ -4,6 +4,7 @@ title: "Debugging Tips (ATL)" ms.date: "11/04/2016" helpviewer_keywords: ["ATL, debugging", "services, debugging"] ms.assetid: 48c60244-d0ce-4466-85fa-6fa65fcfe86c +ms.topic: concept-article --- # Debugging Tips diff --git a/docs/atl/design-principles-for-collection-and-enumerator-interfaces.md b/docs/atl/design-principles-for-collection-and-enumerator-interfaces.md index 84783f4e5a0..e75179b64e0 100644 --- a/docs/atl/design-principles-for-collection-and-enumerator-interfaces.md +++ b/docs/atl/design-principles-for-collection-and-enumerator-interfaces.md @@ -4,6 +4,7 @@ title: "Designing Collection and Enumerator Interfaces (ATL)" ms.date: "11/04/2016" helpviewer_keywords: ["enumerator interfaces", "collection interfaces"] ms.assetid: ea19a39e-6333-41a1-be62-5435c236640e +ms.topic: concept-article --- # Design Principles for Collection and Enumerator Interfaces diff --git a/docs/atl/displaying-assertions.md b/docs/atl/displaying-assertions.md index 8f1863b3718..8587c3eb40c 100644 --- a/docs/atl/displaying-assertions.md +++ b/docs/atl/displaying-assertions.md @@ -4,6 +4,7 @@ title: "Displaying Assertions" ms.date: "05/05/2019" helpviewer_keywords: ["debugging [ATL], displaying assertions", "assertions, displaying", "debugging assertions", "assertions, debugging"] ms.assetid: fa353fe8-4656-4384-a5d2-8866bc977f06 +ms.topic: concept-article --- # Displaying Assertions diff --git a/docs/atl/example-implementing-a-property-page.md b/docs/atl/example-implementing-a-property-page.md index c6e44f85f6f..6e7ee66751a 100644 --- a/docs/atl/example-implementing-a-property-page.md +++ b/docs/atl/example-implementing-a-property-page.md @@ -4,6 +4,7 @@ title: "Implementing a Property Page (ATL)" ms.date: "05/09/2019" helpviewer_keywords: ["property pages, implementing"] ms.assetid: c30b67fe-ce08-4249-ae29-f3060fa8d61e +ms.topic: how-to --- # Example: Implementing a Property Page diff --git a/docs/atl/identifying-the-elements-of-the-dhtml-control-project.md b/docs/atl/identifying-the-elements-of-the-dhtml-control-project.md index dcf9ebc388c..7ac825b8372 100644 --- a/docs/atl/identifying-the-elements-of-the-dhtml-control-project.md +++ b/docs/atl/identifying-the-elements-of-the-dhtml-control-project.md @@ -4,6 +4,7 @@ title: "Identifying the Elements of the DHTML Control Project" ms.date: "11/19/2018" helpviewer_keywords: ["HTML controls, ATL support", "DHTML controls, ATL support"] ms.assetid: b627547a-3768-4346-9900-4b7a21fb8e27 +ms.topic: concept-article --- # Identifying the Elements of the DHTML Control Project diff --git a/docs/atl/implementing-a-dialog-box.md b/docs/atl/implementing-a-dialog-box.md index b07f0570b52..c84428bea54 100644 --- a/docs/atl/implementing-a-dialog-box.md +++ b/docs/atl/implementing-a-dialog-box.md @@ -4,6 +4,7 @@ title: "Implementing a Dialog Box" ms.date: "11/04/2016" helpviewer_keywords: ["CSimpleDialog class, implementing dialog boxes in ATL", "dialog boxes, ATL", "CAxDialogImpl class, implementing dialog boxes in ATL", "ATL, dialog boxes"] ms.assetid: 478525f2-aa6a-435a-b162-68fc8aa98a8e +ms.topic: how-to --- # Implementing a Dialog Box diff --git a/docs/atl/implementing-a-dual-interface.md b/docs/atl/implementing-a-dual-interface.md index 0dd114236ca..6abd84d51b4 100644 --- a/docs/atl/implementing-a-dual-interface.md +++ b/docs/atl/implementing-a-dual-interface.md @@ -4,6 +4,7 @@ title: "Implementing a Dual Interface (ATL)" ms.date: "11/04/2016" helpviewer_keywords: ["IDispatchImpl class, implementing dual interfaces", "dual interfaces, implementing"] ms.assetid: d1da3633-b445-4dcd-8a0a-3efdafada3ea +ms.topic: concept-article --- # Implementing a Dual Interface diff --git a/docs/atl/implementing-a-window-with-cwindowimpl.md b/docs/atl/implementing-a-window-with-cwindowimpl.md index ec6725d6e06..be0f590b83f 100644 --- a/docs/atl/implementing-a-window-with-cwindowimpl.md +++ b/docs/atl/implementing-a-window-with-cwindowimpl.md @@ -4,6 +4,7 @@ title: "Implementing a Window with CWindowImpl" ms.date: "11/04/2016" helpviewer_keywords: ["ATL, windows", "windows [C++], subclassing", "windows [C++], superclassing", "windows [C++], ATL", "subclassing ATL window classes", "superclassing, ATL"] ms.assetid: 3fc40550-f1d6-4702-8b7c-4cf682b6a855 +ms.topic: how-to --- # Implementing a Window with CWindowImpl diff --git a/docs/atl/implementing-a-window.md b/docs/atl/implementing-a-window.md index 6f4137ced3c..dbe42c3fbc5 100644 --- a/docs/atl/implementing-a-window.md +++ b/docs/atl/implementing-a-window.md @@ -4,6 +4,7 @@ title: "Implementing a Window (ATL)" ms.date: "11/04/2016" helpviewer_keywords: ["ATL, windows", "CWindowImpl class, using", "windows [C++], implementing in ATL"] ms.assetid: eb1ce8d6-72f9-4894-aae7-e60a61665628 +ms.topic: concept-article --- # Implementing a Window diff --git a/docs/atl/implementing-an-stl-based-collection.md b/docs/atl/implementing-an-stl-based-collection.md index a01de0c2ba4..761ef740d16 100644 --- a/docs/atl/implementing-an-stl-based-collection.md +++ b/docs/atl/implementing-an-stl-based-collection.md @@ -4,6 +4,7 @@ title: "Implementing a C++ Standard Library-Based Collection" ms.date: "11/04/2016" helpviewer_keywords: ["ICollectionOnSTLImpl interface"] ms.assetid: 6d49f819-1957-4813-b074-3f12c494d8ca +ms.topic: how-to --- # Implementing a C++ Standard Library-Based Collection diff --git a/docs/atl/implementing-ccomobject-ccomaggobject-and-ccompolyobject.md b/docs/atl/implementing-ccomobject-ccomaggobject-and-ccompolyobject.md index c3016ec9b81..e7a6428fbaa 100644 --- a/docs/atl/implementing-ccomobject-ccomaggobject-and-ccompolyobject.md +++ b/docs/atl/implementing-ccomobject-ccomaggobject-and-ccompolyobject.md @@ -4,6 +4,7 @@ title: "Implementing CComObject, CComAggObject, and CComPolyObject" ms.date: "11/04/2016" helpviewer_keywords: ["CComPolyObject class, implementing", "CreateInstance method", "CComAggObject class", "CComObject class, implementing"] ms.assetid: 5aabe938-104d-492e-9c41-9f7fb1c62098 +ms.topic: concept-article --- # Implementing CComObject, CComAggObject, and CComPolyObject diff --git a/docs/atl/implementing-ccomobjectrootex.md b/docs/atl/implementing-ccomobjectrootex.md index 1c4395557b7..5dc0fc19caf 100644 --- a/docs/atl/implementing-ccomobjectrootex.md +++ b/docs/atl/implementing-ccomobjectrootex.md @@ -4,6 +4,7 @@ title: "Implementing CComObjectRootEx" ms.date: "11/04/2016" helpviewer_keywords: ["CComObjectRoot class, implementing", "CComObjectRootEx class"] ms.assetid: 79630c44-f2df-4e9e-b730-400a0ebfbd2b +ms.topic: concept-article --- # Implementing CComObjectRootEx diff --git a/docs/atl/implementing-property-pages.md b/docs/atl/implementing-property-pages.md index 3dcdced9d07..d9e3b0942c4 100644 --- a/docs/atl/implementing-property-pages.md +++ b/docs/atl/implementing-property-pages.md @@ -4,6 +4,7 @@ title: "Implementing Property Pages" ms.date: "11/04/2016" helpviewer_keywords: ["IPropertyPage2 class", "IPropertyPage class", "property pages, implementing"] ms.assetid: 62f29440-33a7-40eb-a1ef-3634c95f640c +ms.topic: how-to --- # Implementing Property Pages diff --git a/docs/atl/implementing-the-event-handling-interface.md b/docs/atl/implementing-the-event-handling-interface.md index 2be79a7b89d..3442039a73e 100644 --- a/docs/atl/implementing-the-event-handling-interface.md +++ b/docs/atl/implementing-the-event-handling-interface.md @@ -4,6 +4,7 @@ title: "Implementing the Event Handling Interface" ms.date: "11/04/2016" helpviewer_keywords: ["ATL, event handling", "event handling, ATL", "interfaces, event and event sink"] ms.assetid: eb2a5b33-88dc-4ce3-bee0-c5c38ea050d7 +ms.topic: concept-article --- # Implementing the Event Handling Interface diff --git a/docs/atl/inserting-a-composite-control.md b/docs/atl/inserting-a-composite-control.md index 2a3375c05a9..ad1f4f6dc24 100644 --- a/docs/atl/inserting-a-composite-control.md +++ b/docs/atl/inserting-a-composite-control.md @@ -4,6 +4,7 @@ title: "Inserting a Composite Control" ms.date: "11/04/2016" helpviewer_keywords: ["composite controls, inserting with ATL Object Wizard", "composite controls", "ATL Control Wizard"] ms.assetid: f10b1927-9fc6-40a7-ac29-efdac70584fe +ms.topic: how-to --- # Inserting a Composite Control diff --git a/docs/atl/introduction-to-atl-window-classes.md b/docs/atl/introduction-to-atl-window-classes.md index a4593ae915b..5ae3fc8c8a3 100644 --- a/docs/atl/introduction-to-atl-window-classes.md +++ b/docs/atl/introduction-to-atl-window-classes.md @@ -4,6 +4,7 @@ title: "Introduction to ATL Window Classes" ms.date: "11/04/2016" helpviewer_keywords: ["window classes"] ms.assetid: 503efc2c-a269-495d-97cf-3fb300d52f3d +ms.topic: concept-article --- # Introduction to ATL Window Classes diff --git a/docs/atl/introduction-to-atl.md b/docs/atl/introduction-to-atl.md index 104ef1d2749..cccfc973918 100644 --- a/docs/atl/introduction-to-atl.md +++ b/docs/atl/introduction-to-atl.md @@ -5,6 +5,7 @@ ms.custom: "index-page" ms.date: "11/04/2016" helpviewer_keywords: ["COM objects, creating in ATL", "ATL"] ms.assetid: 77f565e8-c4ec-4a80-af4b-7278fcfe5c98 +ms.topic: concept-article --- # Introduction to ATL diff --git a/docs/atl/introduction-to-com-and-atl.md b/docs/atl/introduction-to-com-and-atl.md index 8cb151d30af..57e25904bca 100644 --- a/docs/atl/introduction-to-com-and-atl.md +++ b/docs/atl/introduction-to-com-and-atl.md @@ -5,6 +5,7 @@ ms.custom: "index-page" ms.date: "11/04/2016" helpviewer_keywords: ["COM, and ATL", "ATL, COM", "COM objects, ATL"] ms.assetid: 35d6ae9c-abbb-42f0-9344-33f3c19ac3ce +ms.topic: concept-article --- # Introduction to COM and ATL diff --git a/docs/atl/introduction-to-com.md b/docs/atl/introduction-to-com.md index c90f0c03ce3..c44fc4f0652 100644 --- a/docs/atl/introduction-to-com.md +++ b/docs/atl/introduction-to-com.md @@ -5,6 +5,7 @@ ms.custom: "index-page" ms.date: "11/04/2016" helpviewer_keywords: ["COM"] ms.assetid: 120735d9-db71-4ad3-a730-ce576ea2354e +ms.topic: concept-article --- # Introduction to COM diff --git a/docs/atl/invoking-scripts.md b/docs/atl/invoking-scripts.md index 459197b82d0..2d339471811 100644 --- a/docs/atl/invoking-scripts.md +++ b/docs/atl/invoking-scripts.md @@ -4,6 +4,7 @@ title: "Invoking Scripts (ATL)" ms.date: "11/04/2016" helpviewer_keywords: ["StringRegister method", "scripts, invoking registry in ATL"] ms.assetid: eabd41ee-586b-4266-9e92-5aaad04b73a4 +ms.topic: concept-article --- # Invoking Scripts diff --git a/docs/atl/linking-to-the-crt-in-your-atl-project.md b/docs/atl/linking-to-the-crt-in-your-atl-project.md index d67da0b10b4..430134baa43 100644 --- a/docs/atl/linking-to-the-crt-in-your-atl-project.md +++ b/docs/atl/linking-to-the-crt-in-your-atl-project.md @@ -4,6 +4,7 @@ title: "Linking to the CRT in Your ATL Project" ms.date: "11/04/2016" helpviewer_keywords: ["CRT, linking with ATL", "WinMainCRTStartup method", "DllMainCRTStartup method", "wWinMainCRTStartup method", "ATL, C Run-Time library (CRT)"] ms.assetid: 650957ae-362c-4ecf-8b03-5d49138e8b5b +ms.topic: concept-article --- # Linking to the CRT in Your ATL Project diff --git a/docs/atl/marshaling.md b/docs/atl/marshaling.md index 03501d803f1..1f5c52b2be5 100644 --- a/docs/atl/marshaling.md +++ b/docs/atl/marshaling.md @@ -4,6 +4,7 @@ title: "Marshaling" ms.date: "11/04/2016" helpviewer_keywords: ["marshaling, COM interop", "marshaling", "COM interfaces, marshaling"] ms.assetid: 40644b0a-1106-4fc8-9dfb-9bee9915d825 +ms.topic: concept-article --- # Marshaling diff --git a/docs/atl/modifying-the-atl-dhtml-control.md b/docs/atl/modifying-the-atl-dhtml-control.md index 559c5470378..3e77a536a1f 100644 --- a/docs/atl/modifying-the-atl-dhtml-control.md +++ b/docs/atl/modifying-the-atl-dhtml-control.md @@ -4,6 +4,7 @@ title: "Modifying the ATL DHTML Control" ms.date: "11/04/2016" helpviewer_keywords: ["HTML controls, modifying", "DHTML controls", "DHTML controls, modifying"] ms.assetid: c053f35f-8629-4600-9595-721f5956777a +ms.topic: how-to --- # Modifying the ATL DHTML Control diff --git a/docs/atl/modifying-the-atl-project.md b/docs/atl/modifying-the-atl-project.md index b2a4b44bc82..d9211d97764 100644 --- a/docs/atl/modifying-the-atl-project.md +++ b/docs/atl/modifying-the-atl-project.md @@ -4,6 +4,7 @@ title: "Modifying the ATL Project" ms.date: "11/04/2016" helpviewer_keywords: ["controls [ATL], adding to composite controls", "Dialog editor, working with composite controls", "composite controls, adding controls"] ms.assetid: 59984518-748f-4b8b-875f-3e97d22d0b0f +ms.topic: concept-article --- # Modifying the ATL Project diff --git a/docs/atl/programming-with-atl-and-c-run-time-code.md b/docs/atl/programming-with-atl-and-c-run-time-code.md index 697a3c67502..66c4ade4f21 100644 --- a/docs/atl/programming-with-atl-and-c-run-time-code.md +++ b/docs/atl/programming-with-atl-and-c-run-time-code.md @@ -4,6 +4,7 @@ title: "Programming with ATL and C Run-Time Code" ms.date: "11/04/2016" helpviewer_keywords: ["ATL_MIN_CRT macro", "CRT, using with ATL", "_ATL_MIN_CRT macro", "ATL, C Run-Time library (CRT)"] ms.assetid: 20f03b66-1eb7-4add-84a2-6047db0911eb +ms.topic: concept-article --- # Programming with ATL and C Run-Time Code diff --git a/docs/atl/programming-with-ccombstr-atl.md b/docs/atl/programming-with-ccombstr-atl.md index 74c5c544656..31f7ee2d370 100644 --- a/docs/atl/programming-with-ccombstr-atl.md +++ b/docs/atl/programming-with-ccombstr-atl.md @@ -4,6 +4,7 @@ title: "Programming with CComBSTR (ATL)" ms.date: "11/04/2016" helpviewer_keywords: ["CComBSTR class, programming with", "Unicode, using CComBSTR [ATL]"] ms.assetid: d3bd0851-d132-4be9-9c4c-6ccba17acb2b +ms.topic: concept-article --- # Programming with CComBSTR (ATL) diff --git a/docs/atl/putting-the-control-on-a-web-page-atl-tutorial-part-7.md b/docs/atl/putting-the-control-on-a-web-page-atl-tutorial-part-7.md index 14db4bbf4cc..faf66529f16 100644 --- a/docs/atl/putting-the-control-on-a-web-page-atl-tutorial-part-7.md +++ b/docs/atl/putting-the-control-on-a-web-page-atl-tutorial-part-7.md @@ -4,6 +4,7 @@ title: "Putting the Control on a Web Page (ATL Tutorial, Part 7)" ms.custom: "get-started-article" ms.date: "05/06/2019" ms.assetid: 50dc4c95-c95b-4006-b88a-9826f7bdb222 +ms.topic: tutorial --- # Putting the Control on a Web Page (ATL Tutorial, Part 7) diff --git a/docs/atl/reference/catltemporaryfile-class.md b/docs/atl/reference/catltemporaryfile-class.md index ac4ae6210e7..9878d4a0d93 100644 --- a/docs/atl/reference/catltemporaryfile-class.md +++ b/docs/atl/reference/catltemporaryfile-class.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: CAtlTemporaryFile Class" title: "CAtlTemporaryFile Class" -ms.date: "11/04/2016" +description: "Learn more about: CAtlTemporaryFile Class" +ms.date: 11/04/2016 f1_keywords: ["CAtlTemporaryFile", "ATLFILE/ATL::CAtlTemporaryFile", "ATLFILE/ATL::CAtlTemporaryFile::CAtlTemporaryFile", "ATLFILE/ATL::CAtlTemporaryFile::Close", "ATLFILE/ATL::CAtlTemporaryFile::Create", "ATLFILE/ATL::CAtlTemporaryFile::Flush", "ATLFILE/ATL::CAtlTemporaryFile::GetPosition", "ATLFILE/ATL::CAtlTemporaryFile::GetSize", "ATLFILE/ATL::CAtlTemporaryFile::HandsOff", "ATLFILE/ATL::CAtlTemporaryFile::HandsOn", "ATLFILE/ATL::CAtlTemporaryFile::LockRange", "ATLFILE/ATL::CAtlTemporaryFile::Read", "ATLFILE/ATL::CAtlTemporaryFile::Seek", "ATLFILE/ATL::CAtlTemporaryFile::SetSize", "ATLFILE/ATL::CAtlTemporaryFile::TempFileName", "ATLFILE/ATL::CAtlTemporaryFile::UnlockRange", "ATLFILE/ATL::CAtlTemporaryFile::Write"] helpviewer_keywords: ["CAtlTemporaryFile class"] -ms.assetid: 05f0f2a5-94f6-4594-8dae-b114292ff5f9 --- # CAtlTemporaryFile Class @@ -357,7 +356,7 @@ Returns the LPCTSTR pointing to the file name. ### Remarks -The file name is generated in [CAtlTemporaryFile::CAtlTemporaryFile](#catltemporaryfile) with a call to the [GetTempFile](/windows/win32/api/fileapi/nf-fileapi-gettempfilenamew)Windows SDK function. The file extension will always be "TFR" for the temporary file. +The file name is generated in [CAtlTemporaryFile::CAtlTemporaryFile](#catltemporaryfile) with a call to the [GetTempFile](/windows/win32/api/fileapi/nf-fileapi-gettempfilenamew) Windows SDK function. The file extension will always be "TFR" for the temporary file. ## CAtlTemporaryFile::UnlockRange diff --git a/docs/atl/reference/catltransactionmanager-class.md b/docs/atl/reference/catltransactionmanager-class.md index 3b7a42f2746..4c4430bf45b 100644 --- a/docs/atl/reference/catltransactionmanager-class.md +++ b/docs/atl/reference/catltransactionmanager-class.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: CAtlTransactionManager Class" title: "CAtlTransactionManager Class" -ms.date: "11/04/2016" +description: "Learn more about: CAtlTransactionManager Class" +ms.date: 11/04/2016 f1_keywords: ["CAtlTransactionManager", "ATLTRANSACTIONMANAGER/ATL::CAtlTransactionManager", "ATLTRANSACTIONMANAGER/ATL::Close", "ATLTRANSACTIONMANAGER/ATL::Commit", "ATLTRANSACTIONMANAGER/ATL::Create", "ATLTRANSACTIONMANAGER/ATL::CreateFile", "ATLTRANSACTIONMANAGER/ATL::DeleteFile", "ATLTRANSACTIONMANAGER/ATL::FindFirstFile", "ATLTRANSACTIONMANAGER/ATL::GetFileAttributes", "ATLTRANSACTIONMANAGER/ATL::GetFileAttributesEx", "ATLTRANSACTIONMANAGER/ATL::GetHandle", "ATLTRANSACTIONMANAGER/ATL::IsFallback", "ATLTRANSACTIONMANAGER/ATL::MoveFile", "ATLTRANSACTIONMANAGER/ATL::RegCreateKeyEx", "ATLTRANSACTIONMANAGER/ATL::RegDeleteKey", "ATLTRANSACTIONMANAGER/ATL::RegOpenKeyEx", "ATLTRANSACTIONMANAGER/ATL::Rollback", "ATLTRANSACTIONMANAGER/ATL::SetFileAttributes", "ATLTRANSACTIONMANAGER/ATL::m_bFallback", "ATLTRANSACTIONMANAGER/ATL::m_hTransaction"] helpviewer_keywords: ["CAtlTransactionManager class"] -ms.assetid: b01732dc-1d16-4b42-bfac-b137fca2b740 --- # CAtlTransactionManager Class @@ -66,7 +65,7 @@ class CAtlTransactionManager; **Header:** atltransactionmanager.h -## ~CAtlTransactionManager +## ~CAtlTransactionManager CAtlTransactionManager destructor. diff --git a/docs/atl/reference/ccomcoclass-class.md b/docs/atl/reference/ccomcoclass-class.md index 58e766c1204..2101a31f892 100644 --- a/docs/atl/reference/ccomcoclass-class.md +++ b/docs/atl/reference/ccomcoclass-class.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: CComCoClass Class" title: "CComCoClass Class" +description: "Learn more about: CComCoClass Class" ms.date: "11/04/2016" f1_keywords: ["CComCoClass", "ATLCOM/ATL::CComCoClass", "ATLCOM/ATL::CComCoClass::CreateInstance", "ATLCOM/ATL::CComCoClass::Error", "ATLCOM/ATL::CComCoClass::GetObjectCLSID", "ATLCOM/ATL::CComCoClass::GetObjectDescription"] helpviewer_keywords: ["CComCoClass class", "aggregation [C++], aggregation models"] -ms.assetid: 67cfefa4-8df9-47fa-ad58-2d1a1ae25762 --- # CComCoClass Class @@ -12,29 +11,29 @@ This class provides methods for creating instances of a class, and obtaining its ## Syntax -``` +```cpp template class CComCoClass ``` #### Parameters -*T*
+*T*\ Your class, derived from `CComCoClass`. -*pclsid*
+*pclsid*\ A pointer to the CLSID of the object. ## Members ### Public Methods -|Name|Description| -|----------|-----------------| -|[CComCoClass::CreateInstance](#createinstance)|(Static) Creates an instance of the class and queries for an interface.| -|[CComCoClass::Error](#error)|(Static) Returns rich error information to the client.| -|[CComCoClass::GetObjectCLSID](#getobjectclsid)|(Static) Returns the object's class identifier.| -|[CComCoClass::GetObjectDescription](#getobjectdescription)|(Static) Override to return the object's description.| +| Name | Description | +| ---------------------------------------------------------- | ----------------------------------------------------------------------- | +| [CComCoClass::CreateInstance](#createinstance) | (Static) Creates an instance of the class and queries for an interface. | +| [CComCoClass::Error](#error) | (Static) Returns rich error information to the client. | +| [CComCoClass::GetObjectCLSID](#getobjectclsid) | (Static) Returns the object's class identifier. | +| [CComCoClass::GetObjectDescription](#getobjectdescription) | (Static) Override to return the object's description. | ## Remarks @@ -58,23 +57,23 @@ You can override either of these defaults by specifying another macro in your cl Use these `CreateInstance` functions to create an instance of a COM object and retrieve an interface pointer without using the COM API. -``` -template -static HRESULT CreateInstance( Q** pp); +```cpp +template +static HRESULT CreateInstance(Q** pp); -template +template static HRESULT CreateInstance(IUnknown* punkOuter, Q** pp); ``` ### Parameters -*Q*
+*Q*\ The COM interface that should be returned via *pp*. -*punkOuter*
+*punkOuter*\ [in] The outer unknown or controlling unknown of the aggregate. -*pp*
+*pp*\ [out] The address of a pointer variable that receives the requested interface pointer if creation succeeds. ### Return Value @@ -101,7 +100,7 @@ In the following example, `CDocument` is a wizard-generated ATL class derived fr This static function sets up the `IErrorInfo` interface to provide error information to the client. -``` +```cpp static HRESULT WINAPI Error( LPCOLESTR lpszDesc, const IID& iid = GUID_NULL, @@ -130,7 +129,7 @@ static HRESULT WINAPI Error( UINT nID, const IID& iid = GUID_NULL, HRESULT hRes = 0, - HINSTANCE hInst = _AtlBaseModule.GetResourceInstance ()); + HINSTANCE hInst = _AtlBaseModule.GetResourceInstance()); static HRESULT Error( UINT nID, @@ -143,25 +142,25 @@ static HRESULT Error( ### Parameters -*lpszDesc*
+*lpszDesc*\ [in] The string describing the error. The Unicode version of `Error` specifies that *lpszDesc* is of type LPCOLESTR; the ANSI version specifies a type of LPCSTR. -*iid*
+*iid*\ [in] The IID of the interface defining the error or GUID_NULL (the default value) if the error is defined by the operating system. -*hRes*
+*hRes*\ [in] The HRESULT you want returned to the caller. The default value is 0. For more details about *hRes*, see Remarks. -*nID*
+*nID*\ [in] The resource identifier where the error description string is stored. This value should lie between 0x0200 and 0xFFFF, inclusively. In debug builds, an **ASSERT** will result if *nID* does not index a valid string. In release builds, the error description string will be set to "Unknown Error." -*dwHelpID*
+*dwHelpID*\ [in] The help context identifier for the error. -*lpszHelpFile*
+*lpszHelpFile*\ [in] The path and name of the help file describing the error. -*hInst*
+*hInst*\ [in] The handle to the resource. By default, this parameter is `_AtlModule::GetResourceInstance`, where `_AtlModule` is the global instance of [CAtlModule](../../atl/reference/catlmodule-class.md). ### Return Value @@ -178,7 +177,7 @@ If the *hRes* parameter is nonzero, then `Error` returns the value of *hRes*. If Provides a consistent way of retrieving the object's CLSID. -``` +```cpp static const CLSID& WINAPI GetObjectCLSID(); ``` @@ -190,7 +189,7 @@ The object's class identifier. This static function retrieves the text description for your class object. -``` +```cpp static LPCTSTR WINAPI GetObjectDescription(); ``` diff --git a/docs/atl/reference/ccomcurrency-class.md b/docs/atl/reference/ccomcurrency-class.md index b51cb2e04a2..cee7bfd016c 100644 --- a/docs/atl/reference/ccomcurrency-class.md +++ b/docs/atl/reference/ccomcurrency-class.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: CComCurrency Class" title: "CComCurrency Class" -ms.date: "11/04/2016" +description: "Learn more about: CComCurrency Class" +ms.date: 11/04/2016 f1_keywords: ["CComCurrency", "ATLCUR/ATL::CComCurrency", "ATLCUR/ATL::CComCurrency::CComCurrency", "ATLCUR/ATL::CComCurrency::GetCurrencyPtr", "ATLCUR/ATL::CComCurrency::GetFraction", "ATLCUR/ATL::CComCurrency::GetInteger", "ATLCUR/ATL::CComCurrency::Round", "ATLCUR/ATL::CComCurrency::SetFraction", "ATLCUR/ATL::CComCurrency::SetInteger", "ATLCUR/ATL::CComCurrency::m_currency"] helpviewer_keywords: ["CComCurrency class"] -ms.assetid: a1c3d10a-bba6-40cc-8bcf-aed9023c8a9e --- # `CComCurrency` Class @@ -563,7 +562,7 @@ Returns a reference to a `CURRENCY` object. Call this method to round the currency to a specified number of decimal places. ```cpp -HRESULT Roundint nDecimals); +HRESULT Round(int nDecimals); ``` ### Parameters diff --git a/docs/atl/reference/ccomdynamicunkarray-class.md b/docs/atl/reference/ccomdynamicunkarray-class.md index 0c0f142ee65..682edba8166 100644 --- a/docs/atl/reference/ccomdynamicunkarray-class.md +++ b/docs/atl/reference/ccomdynamicunkarray-class.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: CComDynamicUnkArray Class" title: "CComDynamicUnkArray Class" -ms.date: "11/04/2016" +description: "Learn more about: CComDynamicUnkArray Class" +ms.date: 11/04/2016 f1_keywords: ["CComDynamicUnkArray", "ATLCOM/ATL::CComDynamicUnkArray", "ATLCOM/ATL::CComDynamicUnkArray::CComDynamicUnkArray", "ATLCOM/ATL::CComDynamicUnkArray::Add", "ATLCOM/ATL::CComDynamicUnkArray::begin", "ATLCOM/ATL::CComDynamicUnkArray::clear", "ATLCOM/ATL::CComDynamicUnkArray::end", "ATLCOM/ATL::CComDynamicUnkArray::GetAt", "ATLCOM/ATL::CComDynamicUnkArray::GetCookie", "ATLCOM/ATL::CComDynamicUnkArray::GetSize", "ATLCOM/ATL::CComDynamicUnkArray::GetUnknown", "ATLCOM/ATL::CComDynamicUnkArray::Remove"] helpviewer_keywords: ["connection points [C++], managing", "CComDynamicUnkArray class"] -ms.assetid: 202470d7-9a1b-498f-b96d-659d681acd65 --- # CComDynamicUnkArray Class @@ -194,7 +193,7 @@ int GetSize() const; The number of elements the array can store. `GetSize() == end() - begin()`. -## CComDynamicUnkArray::GetUnknown +## CComDynamicUnkArray::GetUnknown Call this method to get the `IUnknown` pointer associated with a given cookie. diff --git a/docs/atl/reference/ccommultithreadmodel-class.md b/docs/atl/reference/ccommultithreadmodel-class.md index 167fe9c3c73..651aa91f662 100644 --- a/docs/atl/reference/ccommultithreadmodel-class.md +++ b/docs/atl/reference/ccommultithreadmodel-class.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: CComMultiThreadModel Class" title: "CComMultiThreadModel Class" +description: "Learn more about: CComMultiThreadModel Class" ms.date: "11/04/2016" f1_keywords: ["CComMultiThreadModel", "ATLBASE/ATL::CComMultiThreadModel", "ATLBASE/ATL::CComMultiThreadModel::AutoCriticalSection", "ATLBASE/ATL::CComMultiThreadModel::CriticalSection", "ATLBASE/ATL::CComMultiThreadModel::ThreadModelNoCS", "ATLBASE/ATL::CComMultiThreadModel::Decrement", "ATLBASE/ATL::CComMultiThreadModel::Increment"] helpviewer_keywords: ["ATL, multithreading", "CComMultiThreadModel class", "threading [ATL]"] -ms.assetid: db8f1662-2f7a-44b3-b341-ffbfb6e422a3 --- # CComMultiThreadModel Class @@ -12,7 +11,7 @@ ms.assetid: db8f1662-2f7a-44b3-b341-ffbfb6e422a3 ## Syntax -``` +```cpp class CComMultiThreadModel ``` @@ -35,7 +34,7 @@ class CComMultiThreadModel ## Remarks -Typically, you use `CComMultiThreadModel` through one of two **`typedef`** names, either [CComObjectThreadModel](atl-typedefs.md#ccomobjectthreadmodel or [CComGlobalsThreadModel](atl-typedefs.md#ccomglobalsthreadmodel. The class referenced by each **`typedef`** depends on the threading model used, as shown in the following table: +Typically, you use `CComMultiThreadModel` through one of two **`typedef`** names, either [CComObjectThreadModel](atl-typedefs.md#ccomobjectthreadmodel) or [CComGlobalsThreadModel](atl-typedefs.md#ccomglobalsthreadmodel). The class referenced by each **`typedef`** depends on the threading model used, as shown in the following table: |typedef|Single threading|Apartment threading|Free threading| |-------------|----------------------|-------------------------|--------------------| @@ -54,7 +53,7 @@ S= `CComSingleThreadModel`; M= `CComMultiThreadModel` When using `CComMultiThreadModel`, the **`typedef`** name `AutoCriticalSection` references class [CComAutoCriticalSection](ccomautocriticalsection-class.md), which provides methods for obtaining and releasing ownership of a critical section object. -``` +```cpp typedef CComAutoCriticalSection AutoCriticalSection; ``` @@ -120,7 +119,7 @@ The following tables show the results of the `InternalAddRef` and `Lock` methods When using `CComMultiThreadModel`, the **`typedef`** name `CriticalSection` references class [CComCriticalSection](ccomcriticalsection-class.md), which provides methods for obtaining and releasing ownership of a critical section object. -``` +```cpp typedef CComCriticalSection CriticalSection; ``` @@ -144,13 +143,13 @@ See [CComMultiThreadModel::AutoCriticalSection](#autocriticalsection). This static function calls the Win32 function [InterlockedDecrement](/windows/win32/api/winnt/nf-winnt-interlockeddecrement), which decrements the value of the variable pointed to by *p*. -``` +```cpp static ULONG WINAPI Decrement(LPLONG p) throw (); ``` ### Parameters -*p*
+*p*\ [in] Pointer to the variable to be decremented. ### Return Value @@ -165,13 +164,13 @@ If the result of the decrement is 0, then `Decrement` returns 0. If the result o This static function calls the Win32 function [InterlockedIncrement](/windows/win32/api/winnt/nf-winnt-interlockedincrement), which increments the value of the variable pointed to by *p*. -``` +```cpp static ULONG WINAPI Increment(LPLONG p) throw (); ``` ### Parameters -*p*
+*p*\ [in] Pointer to the variable to be incremented. ### Return Value @@ -186,7 +185,7 @@ If the result of the increment is 0, then `Increment` returns 0. If the result o When using `CComMultiThreadModel`, the **`typedef`** name `ThreadModelNoCS` references class [CComMultiThreadModelNoCS](ccommultithreadmodelnocs-class.md). -``` +```cpp typedef CComMultiThreadModelNoCS ThreadModelNoCS; ``` @@ -208,7 +207,7 @@ See [CComMultiThreadModel::AutoCriticalSection](#autocriticalsection). ## See also -[CComSingleThreadModel Class](ccomsinglethreadmodel-class.md)
-[CComAutoCriticalSection Class](ccomautocriticalsection-class.md)
-[CComCriticalSection Class](ccomcriticalsection-class.md)
+[CComSingleThreadModel Class](ccomsinglethreadmodel-class.md)\ +[CComAutoCriticalSection Class](ccomautocriticalsection-class.md)\ +[CComCriticalSection Class](ccomcriticalsection-class.md)\ [Class Overview](../atl-class-overview.md) diff --git a/docs/atl/reference/csnapinpropertypageimpl-class.md b/docs/atl/reference/csnapinpropertypageimpl-class.md index 5bbd52fce69..e7cd51b1c78 100644 --- a/docs/atl/reference/csnapinpropertypageimpl-class.md +++ b/docs/atl/reference/csnapinpropertypageimpl-class.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: CSnapInPropertyPageImpl Class" title: "CSnapInPropertyPageImpl Class" -ms.date: "11/04/2016" +description: "Learn more about: CSnapInPropertyPageImpl Class" +ms.date: 11/04/2016 f1_keywords: ["CSnapInPropertyPageImpl", "ATLSNAP/ATL::CSnapInPropertyPageImpl", "ATLSNAP/ATL::CSnapInPropertyPageImpl::CSnapInPropertyPageImpl", "ATLSNAP/ATL::CSnapInPropertyPageImpl::CancelToClose", "ATLSNAP/ATL::CSnapInPropertyPageImpl::Create", "ATLSNAP/ATL::CSnapInPropertyPageImpl::OnApply", "ATLSNAP/ATL::CSnapInPropertyPageImpl::OnHelp", "ATLSNAP/ATL::CSnapInPropertyPageImpl::OnKillActive", "ATLSNAP/ATL::CSnapInPropertyPageImpl::OnQueryCancel", "ATLSNAP/ATL::CSnapInPropertyPageImpl::OnReset", "ATLSNAP/ATL::CSnapInPropertyPageImpl::OnSetActive", "ATLSNAP/ATL::CSnapInPropertyPageImpl::OnWizardBack", "ATLSNAP/ATL::CSnapInPropertyPageImpl::OnWizardFinish", "ATLSNAP/ATL::CSnapInPropertyPageImpl::OnWizardNext", "ATLSNAP/ATL::CSnapInPropertyPageImpl::QuerySiblings", "ATLSNAP/ATL::CSnapInPropertyPageImpl::SetModified", "ATLSNAP/ATL::CSnapInPropertyPageImpl::m_psp"] helpviewer_keywords: ["snap-ins, property pages", "snap-ins", "property pages, ATL", "CSnapInPropertyPageImpl class"] -ms.assetid: 75bdce5a-985e-4166-bd44-493132e023c4 --- # CSnapInPropertyPageImpl Class @@ -15,8 +14,9 @@ This class provides methods for implementing a snap-in property page object. ## Syntax -``` -CSnapInPropertyPageImpl : public CDialogImplBase +```cpp +template +class ATL_NO_VTABLE CSnapInPropertyPageImpl : public CDialogImplBase ``` ## Members diff --git a/docs/atl/reference/cstockpropimpl-class.md b/docs/atl/reference/cstockpropimpl-class.md index 29b1619156d..1f4959941f7 100644 --- a/docs/atl/reference/cstockpropimpl-class.md +++ b/docs/atl/reference/cstockpropimpl-class.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: CStockPropImpl Class" title: "CStockPropImpl Class" +description: "Learn more about: CStockPropImpl Class" ms.date: "05/06/2019" f1_keywords: ["CStockPropImpl", "ATLCTL/ATL::CStockPropImpl", "ATLCTL/ATL::get_Appearance", "ATLCTL/ATL::get_AutoSize", "ATLCTL/ATL::get_BackColor", "ATLCTL/ATL::get_BackStyle", "ATLCTL/ATL::get_BorderColor", "ATLCTL/ATL::get_BorderStyle", "ATLCTL/ATL::get_BorderVisible", "ATLCTL/ATL::get_BorderWidth", "ATLCTL/ATL::get_Caption", "ATLCTL/ATL::get_DrawMode", "ATLCTL/ATL::get_DrawStyle", "ATLCTL/ATL::get_DrawWidth", "ATLCTL/ATL::get_Enabled", "ATLCTL/ATL::get_FillColor", "ATLCTL/ATL::get_FillStyle", "ATLCTL/ATL::get_Font", "ATLCTL/ATL::get_ForeColor", "ATLCTL/ATL::get_HWND", "ATLCTL/ATL::get_MouseIcon", "ATLCTL/ATL::get_MousePointer", "ATLCTL/ATL::get_Picture", "ATLCTL/ATL::get_ReadyState", "ATLCTL/ATL::get_TabStop", "ATLCTL/ATL::get_Text", "ATLCTL/ATL::getvalid", "ATLCTL/ATL::get_Window", "ATLCTL/ATL::put_Appearance", "ATLCTL/ATL::put_AutoSize", "ATLCTL/ATL::put_BackColor", "ATLCTL/ATL::put_BackStyle", "ATLCTL/ATL::put_BorderColor", "ATLCTL/ATL::put_BorderStyle", "ATLCTL/ATL::put_BorderVisible", "ATLCTL/ATL::put_BorderWidth", "ATLCTL/ATL::put_Caption", "ATLCTL/ATL::put_DrawMode", "ATLCTL/ATL::put_DrawStyle", "ATLCTL/ATL::put_DrawWidth", "ATLCTL/ATL::put_Enabled", "ATLCTL/ATL::put_FillColor", "ATLCTL/ATL::put_FillStyle", "ATLCTL/ATL::put_Font", "ATLCTL/ATL::put_ForeColor", "ATLCTL/ATL::put_HWND", "ATLCTL/ATL::put_MouseIcon", "ATLCTL/ATL::put_MousePointer", "ATLCTL/ATL::put_Picture", "ATLCTL/ATL::put_ReadyState", "ATLCTL/ATL::put_TabStop", "ATLCTL/ATL::put_Text", "ATLCTL/ATL::putvalid", "ATLCTL/ATL::put_Window", "ATLCTL/ATL::putref_Font", "ATLCTL/ATL::putref_MouseIcon", "ATLCTL/ATL::putref_Picture"] helpviewer_keywords: ["CStockPropImpl class", "controls [ATL], stock properties", "stock properties, ATL controls"] -ms.assetid: 45f11d7d-6580-4a0e-872d-3bc8b836cfda --- # CStockPropImpl Class @@ -607,7 +606,7 @@ Returns S_OK on success, or an error HRESULT on failure. Call this method to set the value of flag that indicates if the control cannot be any other size. ``` -HRESULT STDMETHODCALLTYPE put_AutoSize(VARIANT_BOOL bAutoSize,); +HRESULT STDMETHODCALLTYPE put_AutoSize(VARIANT_BOOL bAutoSize); ``` ### Parameters @@ -1100,5 +1099,5 @@ The same as [CStockPropImpl::put_Picture](#put_picture), but with a reference co ## See also -[Class Overview](../../atl/atl-class-overview.md)
+[Class Overview](../../atl/atl-class-overview.md)\ [IDispatchImpl Class](../../atl/reference/idispatchimpl-class.md) diff --git a/docs/atl/reference/cthreadpool-class.md b/docs/atl/reference/cthreadpool-class.md index e5834d8409c..0cca6b473fa 100644 --- a/docs/atl/reference/cthreadpool-class.md +++ b/docs/atl/reference/cthreadpool-class.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: CThreadPool Class" title: "CThreadPool Class" -ms.date: "11/04/2016" +description: "Learn more about: CThreadPool Class" +ms.date: 11/04/2016 f1_keywords: ["CThreadPool", "ATLUTIL/ATL::CThreadPool", "ATLUTIL/ATL::CThreadPool::CThreadPool", "ATLUTIL/ATL::CThreadPool::AddRef", "ATLUTIL/ATL::CThreadPool::GetNumThreads", "ATLUTIL/ATL::CThreadPool::GetQueueHandle", "ATLUTIL/ATL::CThreadPool::GetSize", "ATLUTIL/ATL::CThreadPool::GetTimeout", "ATLUTIL/ATL::CThreadPool::Initialize", "ATLUTIL/ATL::CThreadPool::QueryInterface", "ATLUTIL/ATL::CThreadPool::QueueRequest", "ATLUTIL/ATL::CThreadPool::Release", "ATLUTIL/ATL::CThreadPool::SetSize", "ATLUTIL/ATL::CThreadPool::SetTimeout", "ATLUTIL/ATL::CThreadPool::Shutdown"] helpviewer_keywords: ["CThreadPool class"] -ms.assetid: 06683718-01b9-413c-9481-2dc1734ec70f --- # CThreadPool Class @@ -265,7 +264,7 @@ This class does not implement lifetime control using reference counting. Call this method to set the number of threads in the pool. ``` -HRESULT STDMETHODCALLTYPE SetSizeint nNumThreads) throw(); +HRESULT STDMETHODCALLTYPE SetSize(int nNumThreads) throw(); ``` ### Parameters diff --git a/docs/atl/reference/cw2wex-class.md b/docs/atl/reference/cw2wex-class.md index 3c0cfb09467..d5c15f69f2e 100644 --- a/docs/atl/reference/cw2wex-class.md +++ b/docs/atl/reference/cw2wex-class.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: CW2WEX Class" title: "CW2WEX Class" +description: "Learn more about: CW2WEX Class" ms.date: "11/04/2016" f1_keywords: ["CW2WEX", "ATLCONV/ATL::CW2WEX", "ATLCONV/ATL::CW2WEX::CW2WEX", "ATLCONV/ATL::CW2WEX::m_psz", "ATLCONV/ATL::CW2WEX::m_szBuffer"] helpviewer_keywords: ["CW2WEX class"] -ms.assetid: 46262e56-e0d2-41fe-855b-0b67ecc8fcd7 --- # CW2WEX Class @@ -100,7 +99,7 @@ Creates the buffer required for the translation. ## CW2WEX::~CW2WEX -The destructor.. +The destructor. ``` ~CW2WEX() throw(); @@ -140,9 +139,9 @@ Returns the text string as type LPWSTR. ## See also -[CA2AEX Class](../../atl/reference/ca2aex-class.md)
-[CA2CAEX Class](../../atl/reference/ca2caex-class.md)
-[CA2WEX Class](../../atl/reference/ca2wex-class.md)
-[CW2AEX Class](../../atl/reference/cw2aex-class.md)
-[CW2CWEX Class](../../atl/reference/cw2cwex-class.md)
+[CA2AEX Class](../../atl/reference/ca2aex-class.md)\ +[CA2CAEX Class](../../atl/reference/ca2caex-class.md)\ +[CA2WEX Class](../../atl/reference/ca2wex-class.md)\ +[CW2AEX Class](../../atl/reference/cw2aex-class.md)\ +[CW2CWEX Class](../../atl/reference/cw2cwex-class.md)\ [Class Overview](../../atl/atl-class-overview.md) diff --git a/docs/atl/reference/idispeventimpl-class.md b/docs/atl/reference/idispeventimpl-class.md index 74fd3e72c26..ef54c3c7b5c 100644 --- a/docs/atl/reference/idispeventimpl-class.md +++ b/docs/atl/reference/idispeventimpl-class.md @@ -1,12 +1,11 @@ --- -description: "Learn more about: IDispEventImpl Class" title: "IDispEventImpl Class" -ms.date: "11/04/2016" +description: "Learn more about: IDispEventImpl Class" +ms.date: 11/04/2016 f1_keywords: ["IDispEventImpl", "ATLCOM/ATL::IDispEventImpl", "ATLCOM/ATL::IDispEventImpl::IDispEventImpl", "ATLCOM/ATL::IDispEventImpl::GetFuncInfoFromId", "ATLCOM/ATL::IDispEventImpl::GetIDsOfNames", "ATLCOM/ATL::IDispEventImpl::GetTypeInfo", "ATLCOM/ATL::IDispEventImpl::GetTypeInfoCount", "ATLCOM/ATL::IDispEventImpl::GetUserDefinedType"] helpviewer_keywords: ["IDispEventImpl class"] -ms.assetid: a64b5288-35cb-4638-aad6-2d15b1c7cf7b --- -# IDispEventImpl Class +# `IDispEventImpl` Class This class provides implementations of the `IDispatch` methods. @@ -15,7 +14,7 @@ This class provides implementations of the `IDispatch` methods. ## Syntax -``` +```cpp template #### Parameters -*nID*
+*`nID`*\ A unique identifier for the source object. When `IDispEventImpl` is the base class for a composite control, use the resource ID of the desired contained control for this parameter. In other cases, use an arbitrary positive integer. -*T*
+*`T`*\ The user's class, which is derived from `IDispEventImpl`. -*pdiid*
-The pointer to the IID of the event dispinterface implemented by this class. This interface must be defined in the type library denoted by *plibid*, *wMajor*, and *wMinor*. +*`pdiid`*\ +The pointer to the IID of the event dispinterface implemented by this class. This interface must be defined in the type library denoted by *`plibid`*, *`wMajor`*, and *`wMinor`*. -*plibid*
-A pointer to the type library that defines the dispatch interface pointed to by *pdiid*. If **&GUID_NULL**, the type library will be loaded from the object sourcing the events. +*`plibid`*\ +A pointer to the type library that defines the dispatch interface pointed to by *`pdiid`*. If **`&GUID_NULL`**, the type library will be loaded from the object sourcing the events. -*wMajor*
+*`wMajor`*\ The major version of the type library. The default value is 0. -*wMinor*
+*`wMinor`*\ The minor version of the type library. The default value is 0. -*tihclass*
-The class used to manage the type information for *T*. The default value is a class of type `CComTypeInfoHolder`; however, you can override this template parameter by providing a class of a type other than `CComTypeInfoHolder`. +*`tihclass`*\ +The class used to manage the type information for *`T`*. The default value is a class of type `CComTypeInfoHolder`; however, you can override this template parameter by providing a class of a type other than `CComTypeInfoHolder`. ## Members @@ -54,23 +53,23 @@ The class used to manage the type information for *T*. The default value is a cl |Name|Description| |----------|-----------------| -|[IDispEventImpl::_tihclass](../../atl/reference/idispeventimpl-class.md)|The class used to manage the type information. By default, `CComTypeInfoHolder`.| +|[`IDispEventImpl::_tihclass`](#_tihclass)|The class used to manage the type information. By default, `CComTypeInfoHolder`.| ### Public Constructors |Name|Description| |----------|-----------------| -|[IDispEventImpl::IDispEventImpl](#idispeventimpl)|The constructor.| +|[`IDispEventImpl::IDispEventImpl`](#idispeventimpl)|The constructor.| ### Public Methods |Name|Description| |----------|-----------------| -|[IDispEventImpl::GetFuncInfoFromId](#getfuncinfofromid)|Locates the function index for the specified dispatch identifier.| -|[IDispEventImpl::GetIDsOfNames](#getidsofnames)|Maps a single member and an optional set of argument names to a corresponding set of integer DISPIDs.| -|[IDispEventImpl::GetTypeInfo](#gettypeinfo)|Retrieves the type information for an object.| -|[IDispEventImpl::GetTypeInfoCount](#gettypeinfocount)|Retrieves the number of type information interfaces.| -|[IDispEventImpl::GetUserDefinedType](#getuserdefinedtype)|Retrieves the basic type of a user-defined type.| +|[`IDispEventImpl::GetFuncInfoFromId`](#getfuncinfofromid)|Locates the function index for the specified dispatch identifier.| +|[`IDispEventImpl::GetIDsOfNames`](#getidsofnames)|Maps a single member and an optional set of argument names to a corresponding set of integer `DISPID`s.| +|[`IDispEventImpl::GetTypeInfo`](#gettypeinfo)|Retrieves the type information for an object.| +|[`IDispEventImpl::GetTypeInfoCount`](#gettypeinfocount)|Retrieves the number of type information interfaces.| +|[`IDispEventImpl::GetUserDefinedType`](#getuserdefinedtype)|Retrieves the basic type of a user-defined type.| ## Remarks @@ -78,18 +77,18 @@ The class used to manage the type information for *T*. The default value is a cl `IDispEventImpl` works in conjunction with the event sink map in your class to route events to the appropriate handler function. To use this class: -Add a [SINK_ENTRY](composite-control-macros.md#sink_entry) or [SINK_ENTRY_EX](composite-control-macros.md#sink_entry_ex) macro to the event sink map for each event on each object that you want to handle. When using `IDispEventImpl` as a base class of a composite control, you can call [AtlAdviseSinkMap](connection-point-global-functions.md#atladvisesinkmap) to establish and break the connection with the event sources for all entries in the event sink map. In other cases, or for greater control, call [DispEventAdvise](idispeventsimpleimpl-class.md#dispeventadvise) to establish the connection between the source object and the base class. Call [DispEventUnadvise](idispeventsimpleimpl-class.md#dispeventunadvise) to break the connection. +Add a [`SINK_ENTRY`](composite-control-macros.md#sink_entry) or [`SINK_ENTRY_EX`](composite-control-macros.md#sink_entry_ex) macro to the event sink map for each event on each object that you want to handle. When using `IDispEventImpl` as a base class of a composite control, you can call [`AtlAdviseSinkMap`](connection-point-global-functions.md#atladvisesinkmap) to establish and break the connection with the event sources for all entries in the event sink map. In other cases, or for greater control, call [`DispEventAdvise`](idispeventsimpleimpl-class.md#dispeventadvise) to establish the connection between the source object and the base class. Call [`DispEventUnadvise`](idispeventsimpleimpl-class.md#dispeventunadvise) to break the connection. -You must derive from `IDispEventImpl` (using a unique value for *nID*) for each object for which you need to handle events. You can reuse the base class by unadvising against one source object then advising against a different source object, but the maximum number of source objects that can be handled by a single object at one time is limited by the number of `IDispEventImpl` base classes. +You must derive from `IDispEventImpl` (using a unique value for *`nID`*) for each object for which you need to handle events. You can reuse the base class by unadvising against one source object then advising against a different source object, but the maximum number of source objects that can be handled by a single object at one time is limited by the number of `IDispEventImpl` base classes. -`IDispEventImpl` provides the same functionality as [IDispEventSimpleImpl](../../atl/reference/idispeventsimpleimpl-class.md), except it gets type information about the interface from a type library rather than having it supplied as a pointer to an [_ATL_FUNC_INFO](../../atl/reference/atl-func-info-structure.md) structure. Use `IDispEventSimpleImpl` when you do not have a type library describing the event interface or want to avoid the overhead associated with using the type library. +`IDispEventImpl` provides the same functionality as [`IDispEventSimpleImpl`](idispeventsimpleimpl-class.md), except it gets type information about the interface from a type library rather than having it supplied as a pointer to an [`_ATL_FUNC_INFO`](atl-func-info-structure.md) structure. Use `IDispEventSimpleImpl` when you do not have a type library describing the event interface or want to avoid the overhead associated with using the type library. > [!NOTE] > `IDispEventImpl` and `IDispEventSimpleImpl` provide their own implementation of `IUnknown::QueryInterface` enabling each `IDispEventImpl` and `IDispEventSimpleImpl` base class to act as a separate COM identity while still allowing direct access to class members in your main COM object. -CE ATL implementation of ActiveX event sinks only supports return values of type HRESULT or void from your event handler methods; any other return value is unsupported and its behavior is undefined. +CE ATL implementation of ActiveX event sinks only supports return values of type `HRESULT` or `void` from your event handler methods; any other return value is unsupported and its behavior is undefined. -For more information, see [Supporting IDispEventImpl](../../atl/supporting-idispeventimpl.md). +For more information, see [Supporting `IDispEventImpl`](../supporting-idispeventimpl.md). ## Inheritance Hierarchy @@ -97,19 +96,19 @@ For more information, see [Supporting IDispEventImpl](../../atl/supporting-idisp `_IDispEventLocator` -[IDispEventSimpleImpl](../../atl/reference/idispeventsimpleimpl-class.md) +[`IDispEventSimpleImpl`](idispeventsimpleimpl-class.md) `IDispEventImpl` ## Requirements -**Header:** atlcom.h +**Header:** `atlcom.h` -## IDispEventImpl::GetFuncInfoFromId +## `IDispEventImpl::GetFuncInfoFromId` Locates the function index for the specified dispatch identifier. -``` +```cpp HRESULT GetFuncInfoFromId( const IID& iid, DISPID dispidMember, @@ -119,27 +118,27 @@ HRESULT GetFuncInfoFromId( ### Parameters -*iid*
+*`iid`*\ [in] A reference to the ID of the function. -*dispidMember*
+*`dispidMember`*\ [in] The dispatch ID of the function. -*lcid*
+*`lcid`*\ [in] The locale context of the function ID. -*info*
+*`info`*\ [in] The structure indicating how the function is called. ### Return Value -A standard HRESULT value. +A standard `HRESULT` value. -## IDispEventImpl::GetIDsOfNames +## `IDispEventImpl::GetIDsOfNames` -Maps a single member and an optional set of argument names to a corresponding set of integer DISPIDs, which can be used on subsequent calls to [IDispatch::Invoke](/windows/win32/api/oaidl/nf-oaidl-idispatch-invoke). +Maps a single member and an optional set of argument names to a corresponding set of integer `DISPID`s, which can be used on subsequent calls to [`IDispatch::Invoke`](/windows/win32/api/oaidl/nf-oaidl-idispatch-invoke). -``` +```cpp STDMETHOD(GetIDsOfNames)( REFIID riid, LPOLESTR* rgszNames, @@ -150,38 +149,36 @@ STDMETHOD(GetIDsOfNames)( ### Remarks -See [IDispatch::GetIDsOfNames](/windows/win32/api/oaidl/nf-oaidl-idispatch-getidsofnames) in the Windows SDK. +See [`IDispatch::GetIDsOfNames`](/windows/win32/api/oaidl/nf-oaidl-idispatch-getidsofnames) in the Windows SDK. -## IDispEventImpl::GetTypeInfo +## `IDispEventImpl::GetTypeInfo` Retrieves the type information for an object, which can then be used to get the type information for an interface. -``` +```cpp STDMETHOD(GetTypeInfo)( UINT itinfo, LCID lcid, ITypeInfo** pptinfo); ``` -### Remarks - -## IDispEventImpl::GetTypeInfoCount +## `IDispEventImpl::GetTypeInfoCount` Retrieves the number of type information interfaces that an object provides (either 0 or 1). -``` +```cpp STDMETHOD(GetTypeInfoCount)(UINT* pctinfo); ``` ### Remarks -See [IDispatch::GetTypeInfoCount](/windows/win32/api/oaidl/nf-oaidl-idispatch-gettypeinfocount) in the Windows SDK. +See [`IDispatch::GetTypeInfoCount`](/windows/win32/api/oaidl/nf-oaidl-idispatch-gettypeinfocount) in the Windows SDK. -## IDispEventImpl::GetUserDefinedType +## `IDispEventImpl::GetUserDefinedType` Retrieves the basic type of a user-defined type. -``` +```cpp VARTYPE GetUserDefinedType( ITypeInfo* pTI, HREFTYPE hrt); @@ -189,10 +186,10 @@ VARTYPE GetUserDefinedType( ### Parameters -*pTI*
-[in] A pointer to the [ITypeInfo](/windows/win32/api/oaidl/nn-oaidl-itypeinfo) interface containing the user-defined type. +*`pTI`*\ +[in] A pointer to the [`ITypeInfo`](/windows/win32/api/oaidl/nn-oaidl-itypeinfo) interface containing the user-defined type. -*hrt*
+*`hrt`*\ [in] A handle to the type description to be retrieved. ### Return Value @@ -201,21 +198,21 @@ The type of variant. ### Remarks -See [ITypeInfo::GetRefTypeInfo](/windows/win32/api/oaidl/nf-oaidl-itypeinfo-getreftypeinfo). +See [`ITypeInfo::GetRefTypeInfo`](/windows/win32/api/oaidl/nf-oaidl-itypeinfo-getreftypeinfo). -## IDispEventImpl::IDispEventImpl +## `IDispEventImpl::IDispEventImpl` -The constructor. Stores the values of the class template parameters *plibid*, *pdiid*, *wMajor*, and *wMinor*. +The constructor. Stores the values of the class template parameters *`plibid`*, *`pdiid`*, *`wMajor`*, and *`wMinor`*. -``` +```cpp IDispEventImpl(); ``` -## IDispEventImpl::tihclass +## `IDispEventImpl::_tihclass` -This typedef is an instance of the class template parameter *tihclass*. +This typedef is an instance of the class template parameter *`tihclass`*. -``` +```cpp typedef tihclass _tihclass; ``` @@ -225,10 +222,10 @@ By default, the class is `CComTypeInfoHolder`. `CComTypeInfoHolder` manages the ## See also -[_ATL_FUNC_INFO Structure](../../atl/reference/atl-func-info-structure.md)
-[IDispatchImpl Class](../../atl/reference/idispatchimpl-class.md)
-[IDispEventSimpleImpl Class](../../atl/reference/idispeventsimpleimpl-class.md)
-[SINK_ENTRY](composite-control-macros.md#sink_entry)
-[SINK_ENTRY_EX](composite-control-macros.md#sink_entry_ex)
-[SINK_ENTRY_INFO](composite-control-macros.md#sink_entry_info)
-[Class Overview](../../atl/atl-class-overview.md) +[`_ATL_FUNC_INFO` Structure](atl-func-info-structure.md)\ +[`IDispatchImpl` Class](idispatchimpl-class.md)\ +[`IDispEventSimpleImpl` Class](idispeventsimpleimpl-class.md)\ +[`SINK_ENTRY`](composite-control-macros.md#sink_entry)\ +[`SINK_ENTRY_EX`](composite-control-macros.md#sink_entry_ex)\ +[`SINK_ENTRY_INFO`](composite-control-macros.md#sink_entry_info)\ +[Class Overview](../atl-class-overview.md) diff --git a/docs/atl/reference/iolecontrolimpl-class.md b/docs/atl/reference/iolecontrolimpl-class.md index 6dc7d0f8a80..6c3430e9ceb 100644 --- a/docs/atl/reference/iolecontrolimpl-class.md +++ b/docs/atl/reference/iolecontrolimpl-class.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: IOleControlImpl Class" title: "IOleControlImpl Class" +description: "Learn more about: IOleControlImpl Class" ms.date: "11/04/2016" f1_keywords: ["IOleControlImpl", "ATLCTL/ATL::IOleControlImpl", "ATLCTL/ATL::IOleControlImpl::FreezeEvents", "ATLCTL/ATL::IOleControlImpl::GetControlInfo", "ATLCTL/ATL::IOleControlImpl::OnAmbientPropertyChange", "ATLCTL/ATL::IOleControlImpl::OnMnemonic"] helpviewer_keywords: ["IOleControlImpl class"] -ms.assetid: 5a4255ad-ede4-49ca-ba9a-07c2e919fa85 --- # IOleControlImpl Class @@ -22,7 +21,7 @@ class IOleControlImpl #### Parameters -*T*
+*T*\ Your class, derived from `IOleControlImpl`. ## Members @@ -76,7 +75,7 @@ HRESULT GetControlInfo(LPCONTROLINFO pCI); ### Remarks -See [IOleControl:GetControlInfo](/windows/win32/api/ocidl/nf-ocidl-iolecontrol-getcontrolinfo) in the Windows SDK. +See [IOleControl::GetControlInfo](/windows/win32/api/ocidl/nf-ocidl-iolecontrol-getcontrolinfo) in the Windows SDK. ### Return Value @@ -116,6 +115,6 @@ See [IOleControl::OnMnemonic](/windows/win32/api/ocidl/nf-ocidl-iolecontrol-onmn ## See also -[IOleObjectImpl Class](../../atl/reference/ioleobjectimpl-class.md)
-[ActiveX Controls Interfaces](/windows/win32/com/activex-controls-interfaces)
+[IOleObjectImpl Class](../../atl/reference/ioleobjectimpl-class.md)\ +[ActiveX Controls Interfaces](/windows/win32/com/activex-controls-interfaces)\ [Class Overview](../../atl/atl-class-overview.md) diff --git a/docs/atl/reference/ipersiststorageimpl-class.md b/docs/atl/reference/ipersiststorageimpl-class.md index 9b8e3de9858..a5396bee533 100644 --- a/docs/atl/reference/ipersiststorageimpl-class.md +++ b/docs/atl/reference/ipersiststorageimpl-class.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: IPersistStorageImpl Class" title: "IPersistStorageImpl Class" +description: "Learn more about: IPersistStorageImpl Class" ms.date: "11/04/2016" f1_keywords: ["IPersistStorageImpl", "ATLCOM/ATL::IPersistStorageImpl", "ATLCOM/ATL::IPersistStorageImpl::GetClassID", "ATLCOM/ATL::IPersistStorageImpl::HandsOffStorage", "ATLCOM/ATL::IPersistStorageImpl::InitNew", "ATLCOM/ATL::IPersistStorageImpl::IsDirty", "ATLCOM/ATL::IPersistStorageImpl::Load", "ATLCOM/ATL::IPersistStorageImpl::Save", "ATLCOM/ATL::IPersistStorageImpl::SaveCompleted"] helpviewer_keywords: ["storage, ATL", "IPersistStorageImpl class"] -ms.assetid: d652f02c-239c-47c7-9a50-3e9fc3014fff --- # IPersistStorageImpl Class @@ -22,7 +21,7 @@ class ATL_NO_VTABLE IPersistStorageImpl : public IPersistStorage #### Parameters -*T*
+*T*\ Your class, derived from `IPersistStorageImpl`. ## Members @@ -97,7 +96,7 @@ STDMETHOD(InitNew)(IStorage*); The ATL implementation delegates to the [IPersistStreamInit](/windows/win32/api/ocidl/nn-ocidl-ipersiststreaminit) interface. -See [IPersistStorage:InitNew](/windows/win32/api/objidl/nf-objidl-ipersiststorage-initnew) in the Windows SDK. +See [IPersistStorage::InitNew](/windows/win32/api/objidl/nf-objidl-ipersiststorage-initnew) in the Windows SDK. ## IPersistStorageImpl::IsDirty @@ -111,7 +110,7 @@ STDMETHOD(IsDirty)(void); The ATL implementation delegates to the [IPersistStreamInit](/windows/win32/api/ocidl/nn-ocidl-ipersiststreaminit) interface. -See [IPersistStorage:IsDirty](/windows/win32/api/objidl/nf-objidl-ipersiststorage-isdirty) in the Windows SDK. +See [IPersistStorage::IsDirty](/windows/win32/api/objidl/nf-objidl-ipersiststorage-isdirty) in the Windows SDK. ## IPersistStorageImpl::Load @@ -125,7 +124,7 @@ STDMETHOD(Load)(IStorage* pStorage); The ATL implementation delegates to the [IPersistStreamInit](/windows/win32/api/ocidl/nn-ocidl-ipersiststreaminit) interface. `Load` uses a stream named "Contents" to retrieve the object's data. The [Save](#save) method originally creates this stream. -See [IPersistStorage:Load](/windows/win32/api/objidl/nf-objidl-ipersiststorage-load) in the Windows SDK. +See [IPersistStorage::Load](/windows/win32/api/objidl/nf-objidl-ipersiststorage-load) in the Windows SDK. ## IPersistStorageImpl::Save @@ -139,7 +138,7 @@ STDMETHOD(Save)(IStorage* pStorage, BOOL fSameAsLoad); The ATL implementation delegates to the [IPersistStreamInit](/windows/win32/api/ocidl/nn-ocidl-ipersiststreaminit) interface. When `Save` is first called, it creates a stream named "Contents" on the specified storage. This stream is then used in later calls to `Save` and in calls to [Load](#load). -See [IPersistStorage:Save](/windows/win32/api/objidl/nf-objidl-ipersiststorage-save) in the Windows SDK. +See [IPersistStorage::Save](/windows/win32/api/objidl/nf-objidl-ipersiststorage-save) in the Windows SDK. ## IPersistStorageImpl::SaveCompleted @@ -155,11 +154,11 @@ Returns S_OK. ### Remarks -See [IPersistStorage:SaveCompleted](/windows/win32/api/objidl/nf-objidl-ipersiststorage-savecompleted) in the Windows SDK. +See [IPersistStorage::SaveCompleted](/windows/win32/api/objidl/nf-objidl-ipersiststorage-savecompleted) in the Windows SDK. ## See also -[Storages and Streams](/windows/win32/Stg/storages-and-streams)
-[IPersistStreamInitImpl Class](../../atl/reference/ipersiststreaminitimpl-class.md)
-[IPersistPropertyBagImpl Class](../../atl/reference/ipersistpropertybagimpl-class.md)
+[Storages and Streams](/windows/win32/Stg/storages-and-streams)\ +[IPersistStreamInitImpl Class](../../atl/reference/ipersiststreaminitimpl-class.md)\ +[IPersistPropertyBagImpl Class](../../atl/reference/ipersistpropertybagimpl-class.md)\ [Class Overview](../../atl/atl-class-overview.md) diff --git a/docs/atl/running-the-program-as-a-local-server.md b/docs/atl/running-the-program-as-a-local-server.md index 5c063f70987..647555b4552 100644 --- a/docs/atl/running-the-program-as-a-local-server.md +++ b/docs/atl/running-the-program-as-a-local-server.md @@ -4,6 +4,7 @@ title: "Running the Program as a Local Server" ms.date: "11/04/2016" helpviewer_keywords: ["debugging [ATL], running services as local server", "ATL services, running as local servers"] ms.assetid: eb9701e6-e2a8-4666-897f-0c893aec8ac7 +ms.topic: concept-article --- # Running the Program as a Local Server diff --git a/docs/atl/setting-up-a-static-link-to-the-registrar-code-cpp-only.md b/docs/atl/setting-up-a-static-link-to-the-registrar-code-cpp-only.md index ef4dd01f189..e5797ef152c 100644 --- a/docs/atl/setting-up-a-static-link-to-the-registrar-code-cpp-only.md +++ b/docs/atl/setting-up-a-static-link-to-the-registrar-code-cpp-only.md @@ -4,6 +4,7 @@ description: "How to statically link C++ code to the ATL Registrar code." ms.date: 09/03/2020 helpviewer_keywords: ["statically linking to ATL Registrar code", "linking [C++], to ATL Registrar code"] ms.assetid: 835f5885-87a6-48fa-91e6-60988ee65538 +ms.topic: how-to --- # Setting up a static link to the Registrar code (C++ Only) diff --git a/docs/atl/specifying-property-pages.md b/docs/atl/specifying-property-pages.md index 25dd74d4e22..0213211d07c 100644 --- a/docs/atl/specifying-property-pages.md +++ b/docs/atl/specifying-property-pages.md @@ -4,6 +4,7 @@ title: "Specifying Property Pages (ATL)" ms.date: "11/04/2016" helpviewer_keywords: ["ISpecifyPropertyPages method", "property pages, specifying"] ms.assetid: ee8678cf-c708-49ab-b0ad-fc2db31f1ac3 +ms.topic: how-to --- # Specifying Property Pages diff --git a/docs/atl/specifying-the-threading-model-for-a-project-atl.md b/docs/atl/specifying-the-threading-model-for-a-project-atl.md index 70c3d124dd4..f9d9ebeb3aa 100644 --- a/docs/atl/specifying-the-threading-model-for-a-project-atl.md +++ b/docs/atl/specifying-the-threading-model-for-a-project-atl.md @@ -4,6 +4,7 @@ title: "Specifying the Threading Model for a Project (ATL)" ms.date: "11/04/2016" helpviewer_keywords: ["_ATL_FREE_THREADED macro", "_ATL_APARTMENT_THREADED macro", "ATL, multithreading", "threading [ATL], models", "_ATL_SINGLE_THREADED macro"] ms.assetid: 6b571078-521c-4f3e-9f08-482aa235a822 +ms.topic: concept-article --- # Specifying the Threading Model for a Project (ATL) diff --git a/docs/atl/supporting-idispatch-and-ierrorinfo.md b/docs/atl/supporting-idispatch-and-ierrorinfo.md index 7d0c89d28e7..97c49084358 100644 --- a/docs/atl/supporting-idispatch-and-ierrorinfo.md +++ b/docs/atl/supporting-idispatch-and-ierrorinfo.md @@ -4,6 +4,7 @@ title: "Supporting IDispatch and IErrorInfo" ms.date: "11/04/2016" helpviewer_keywords: ["ISupportErrorInfoImpl method", "IErrorInfo class suppor in ATL", "IDispatchImpl class", "IDispatch class support in ATL"] ms.assetid: 7db2220f-319d-4ce9-9382-d340019f14f7 +ms.topic: concept-article --- # Supporting IDispatch and IErrorInfo diff --git a/docs/atl/supporting-idispeventimpl.md b/docs/atl/supporting-idispeventimpl.md index 008def002d0..261ffa445cd 100644 --- a/docs/atl/supporting-idispeventimpl.md +++ b/docs/atl/supporting-idispeventimpl.md @@ -4,6 +4,7 @@ title: "Supporting IDispEventImpl" ms.date: "11/04/2016" helpviewer_keywords: ["event sink maps, declaring", "IDispEventImpl class, advising and unadvising", "SINK_ENTRY macro", "type libraries, importing", "ATL, IDispEventImpl support in COM objects", "BEGIN_SINK_MAP macro", "IDispEventImpl class, declaring"] ms.assetid: b957f930-6a5b-4598-8e4d-8027759957e7 +ms.topic: concept-article --- # Supporting IDispEventImpl diff --git a/docs/atl/testing-the-atl-dhtml-control.md b/docs/atl/testing-the-atl-dhtml-control.md index f148c3fe6d0..1d223e24d1d 100644 --- a/docs/atl/testing-the-atl-dhtml-control.md +++ b/docs/atl/testing-the-atl-dhtml-control.md @@ -4,6 +4,7 @@ title: "Testing the ATL DHTML Control" ms.date: "11/04/2016" helpviewer_keywords: ["HTML controls, testing", "testing controls", "DHTML controls", "DHTML controls, testing"] ms.assetid: 0e4b4358-80ce-4505-8b06-ef4f30b1d1f0 +ms.topic: how-to --- # Testing the ATL DHTML Control diff --git a/docs/atl/testing-the-modified-atl-dhtml-control.md b/docs/atl/testing-the-modified-atl-dhtml-control.md index 71a65367b2e..fe0809b88b7 100644 --- a/docs/atl/testing-the-modified-atl-dhtml-control.md +++ b/docs/atl/testing-the-modified-atl-dhtml-control.md @@ -4,6 +4,7 @@ title: "Testing the Modified ATL DHTML Control" ms.date: "11/06/2018" helpviewer_keywords: ["HTML controls, testing", "testing controls", "DHTML controls, testing"] ms.assetid: 42316118-9433-410f-9d8a-0efcc1eff824 +ms.topic: how-to --- # Testing the Modified ATL DHTML Control diff --git a/docs/atl/threading-models-and-critical-sections-classes.md b/docs/atl/threading-models-and-critical-sections-classes.md index cd8a516c145..1bc26034ca9 100644 --- a/docs/atl/threading-models-and-critical-sections-classes.md +++ b/docs/atl/threading-models-and-critical-sections-classes.md @@ -4,6 +4,7 @@ title: "Threading Models and Critical Sections Classes (ATL)" ms.date: "11/04/2016" helpviewer_keywords: ["ATL, critical sections", "ATL, multithreading", "threading [ATL], models", "critical sections"] ms.assetid: 759f05ef-6285-4be6-a2cc-78572dd75146 +ms.topic: concept-article --- # Threading Models and Critical Sections Classes diff --git a/docs/atl/understanding-backus-naur-form-bnf-syntax.md b/docs/atl/understanding-backus-naur-form-bnf-syntax.md index 1422e4379ce..7e5295bf9ec 100644 --- a/docs/atl/understanding-backus-naur-form-bnf-syntax.md +++ b/docs/atl/understanding-backus-naur-form-bnf-syntax.md @@ -4,6 +4,7 @@ title: "ATL Registrar and Backus-Naur form (BNF) syntax" ms.date: "05/14/2019" helpviewer_keywords: ["BNF notation", "Backus-Naur form (BNF) syntax"] ms.assetid: 994bbef0-9077-4aa8-bdfe-b7e830af9acc +ms.topic: concept-article --- # Understanding Backus-Naur form (BNF) syntax diff --git a/docs/atl/understanding-parse-trees.md b/docs/atl/understanding-parse-trees.md index 3f10cd3fbce..a0eea7d823a 100644 --- a/docs/atl/understanding-parse-trees.md +++ b/docs/atl/understanding-parse-trees.md @@ -3,6 +3,7 @@ description: "Learn more about: Understanding parse trees" title: "ATL Registrar and Parse Trees" ms.date: 04/15/2021 helpviewer_keywords: ["parse trees"] +ms.topic: concept-article --- # Understanding parse trees diff --git a/docs/atl/understanding-window-traits.md b/docs/atl/understanding-window-traits.md index 25564c04ec7..df7884f8624 100644 --- a/docs/atl/understanding-window-traits.md +++ b/docs/atl/understanding-window-traits.md @@ -4,6 +4,7 @@ title: "ATL Window Traits" ms.date: "11/04/2016" helpviewer_keywords: ["window traits"] ms.assetid: c90cf850-9e91-49da-9cf3-ad4efb30347d +ms.topic: concept-article --- # Understanding Window Traits diff --git a/docs/atl/using-a-template-library.md b/docs/atl/using-a-template-library.md index 36b56c57a1f..11bd456ff96 100644 --- a/docs/atl/using-a-template-library.md +++ b/docs/atl/using-a-template-library.md @@ -4,6 +4,7 @@ title: "Using a Template Library (ATL)" ms.date: "11/04/2016" helpviewer_keywords: ["template libraries"] ms.assetid: 5e80ec6e-a61c-41ce-b34b-9a6252c46265 +ms.topic: concept-article --- # Using a Template Library diff --git a/docs/atl/using-a-window.md b/docs/atl/using-a-window.md index f79ec47eb93..69488133ae5 100644 --- a/docs/atl/using-a-window.md +++ b/docs/atl/using-a-window.md @@ -4,6 +4,7 @@ title: "Using a Window (ATL)" ms.date: "11/04/2016" helpviewer_keywords: ["ATL, windows", "CWindow class, about CWindow class", "windows [C++], ATL"] ms.assetid: b3b9cc8e-4287-486b-b080-38852bc2943a +ms.topic: concept-article --- # Using a Window diff --git a/docs/atl/using-contained-windows.md b/docs/atl/using-contained-windows.md index 62451849278..82894f8eeae 100644 --- a/docs/atl/using-contained-windows.md +++ b/docs/atl/using-contained-windows.md @@ -4,6 +4,7 @@ title: "Using Contained Windows" ms.date: "11/04/2016" helpviewer_keywords: ["ATL, windows", "windows [C++], ATL", "contained windows in ATL"] ms.assetid: 7b3d79e5-b569-413f-9b98-df4f14efbe2b +ms.topic: concept-article --- # Using Contained Windows diff --git a/docs/atl/using-idispeventimpl.md b/docs/atl/using-idispeventimpl.md index d15678d3b64..9e9c1537f24 100644 --- a/docs/atl/using-idispeventimpl.md +++ b/docs/atl/using-idispeventimpl.md @@ -4,6 +4,7 @@ title: "Using IDispEventImpl (ATL)" ms.date: "08/19/2019" helpviewer_keywords: ["IDispEventImpl class, using"] ms.assetid: 82d53b61-9d0d-45c5-aff9-2fafa468a9ca +ms.topic: how-to --- # Using IDispEventImpl diff --git a/docs/atl/using-idispeventsimpleimpl.md b/docs/atl/using-idispeventsimpleimpl.md index 2c0ee8349f1..3f50230f72c 100644 --- a/docs/atl/using-idispeventsimpleimpl.md +++ b/docs/atl/using-idispeventsimpleimpl.md @@ -4,6 +4,7 @@ title: "Using IDispEventSimpleImpl (ATL)" ms.date: "08/19/2019" helpviewer_keywords: ["IDispEventSimpleImpl class, using"] ms.assetid: 8640ad1a-4bd0-40a5-b5e4-7322685d7aab +ms.topic: concept-article --- # Using IDispEventSimpleImpl diff --git a/docs/atl/using-replaceable-parameters-the-registrar-s-preprocessor.md b/docs/atl/using-replaceable-parameters-the-registrar-s-preprocessor.md index 1b9ef3d2d45..5541235e127 100644 --- a/docs/atl/using-replaceable-parameters-the-registrar-s-preprocessor.md +++ b/docs/atl/using-replaceable-parameters-the-registrar-s-preprocessor.md @@ -4,6 +4,7 @@ title: "Using Replaceable Parameters (ATL Registrar)" ms.date: "11/04/2016" helpviewer_keywords: ["%MODULE%"] ms.assetid: 0b376994-84a6-4967-8d97-8c01dfc94efe +ms.topic: concept-article --- # Using Replaceable Parameters (The Registrar's Preprocessor) diff --git a/docs/atl/using-task-manager.md b/docs/atl/using-task-manager.md index 626e5525990..31747f62825 100644 --- a/docs/atl/using-task-manager.md +++ b/docs/atl/using-task-manager.md @@ -4,6 +4,7 @@ title: "Using Task Manager" ms.date: "11/04/2016" helpviewer_keywords: ["Task Manager", "breakpoints, Task Manager", "debugging [ATL], using Task Manager"] ms.assetid: 773fccd5-308d-42c2-a17f-60ae94989062 +ms.topic: how-to --- # Using Task Manager diff --git a/docs/build-insights/build-performance.md b/docs/build-insights/build-performance.md new file mode 100644 index 00000000000..13a51332376 --- /dev/null +++ b/docs/build-insights/build-performance.md @@ -0,0 +1,183 @@ +--- +title: "Get Started with GitHub Copilot build performance for Windows" +description: "Learn how to use GitHub Copilot to improve build times." +ms.date: 01/21/2026 +helpviewer_keywords: ["GitHub Copilot build performance", "C++ Build Insights", "build time optimization", "header file analysis", "template instantiation", "Visual Studio build performance"] +ms.topic: how-to +--- + +# Get started with GitHub Copilot build performance for Windows  + +The GitHub Copilot build performance for Windows helps you make your builds faster. It finds expensive headers, template instantiations, and functions and can automatically make your builds more efficient. GitHub Copilot is integrated with Visual Studio. + +## Prerequisites  + +- Visual Studio 2026 version 18.3 Insiders 4, or later. +- MSVC Build Tools version 14.50 or later. +- An MSBuild or CMake project. +- Windows 10 or later. + +### Before you begin  + +In the Visual Studio 2026 Installer, ensure the following components are selected in the **Desktop development with C++** [workload](/visualstudio/install/install-visual-studio#step-4---choose-workloads): + +:::image type="complex" source="./media/vs-installer-options.png" alt-text="Screenshot of the Visual Studio installer."::: +The desktop development with C++ section is highlighted and C++ Build Insights, C++ profiling tools, and C++ CMake tools for Windows are selected. +:::image-end::: + +### Verify your GitHub Copilot subscription + +To use GitHub Copilot build performance for Windows, you need a GitHub Copilot Pro, Pro+, Business, or Enterprise subscription. + +Verify your GitHub Copilot subscription on GitHub, and then sign in to your GitHub account in Visual Studio 2026. + +1. Verify your GitHub Copilot subscription by signing in to [https://github.com](https://github.com/). Select your profile picture and then [Copilot settings](https://github.com/settings/copilot/features). Your plan type appears near the top of the page: + + :::image type="complex" source="./media/copilot-subscription.png" alt-text="Screenshot showing the user's GitHub Copilot information."::: + The Copilot settings page shows the type of subscription. In this case, the user has GitHub Copilot Enterprise. + :::image-end::: +1. In Visual Studio, sign in to your GitHub account: + - If you're not signed in to GitHub in Visual Studio, open the GitHub Copilot Chat and follow the sign-in instructions in the pop-up window. + - Confirm your GitHub sign-in status by selecting your profile picture in Visual Studio. You should see that your GitHub account is **Active**: + + :::image type="complex" source="./media/vs-account-authentication.png" alt-text="Screenshot of the account dropdown in Visual Studio."::: + The account dropdown shows that a Microsoft account and a GitHub account are both signed in and active. + :::image-end::: + +### Enable template collection + +To minimize analysis overhead, the template instantiation time collection is off by default. Turn it on: + + 1. In Visual Studio, go to **Tools** > **Options**. + 1. In the **Options** dialog, expand **Build Insights**. + 1. Select **Collect Template Instantiation**. + +:::image type="complex" source="./media/build-insights-options.png" alt-text="Screenshot of the Build Insights settings page in Visual Studio Options with the Collect template instantiation checkbox enabled, displaying trace collection configurations for analysis."::: +The dialog shows trace collection settings with the Collect template instantiation checkbox selected. +:::image-end::: + +For more information about template instantiation on build time, see [Troubleshoot template instantiation impact on build time | Microsoft Learn](/cpp/build-insights/tutorials/build-insights-template-view) + +## Troubleshoot build performance with GitHub Copilot + +To start the GitHub Copilot build performance agent: + +1. Open the GitHub Copilot chat pane and type '@'. One of the options is **@BuildPerfCpp**. Select it: + + :::image type="complex" source="./media/copilot-build-perf-select.png" alt-text="Screenshot of the GitHub Copilot chat pane."::: + The GitHub Copilot chat pane shows a list of agents to choose from. Build Perf C p p (optimize your c + + build) is selected. + :::image-end::: + +1. Select your preferred model in the model drop down menu: + + :::image type="complex" source="./media/model-select.png" alt-text="Screenshot of the model selection menu in the Copilot Chat window."::: + This dropdown lists various models like GPT-5, CLaude Sonnet 4, Gemini 3 Pro, and others. + :::image-end::: + +1. Instruct GitHub Copilot to improve the build performance of your selected project by typing something like **Help me improve the build performance of this project**. You can add extra context so that GitHub Copilot can better make suggestions to match the needs of your project. + + :::image type="complex" source="./media/copilot-build-request.png" alt-text="Screenshot of the GitHub Copilot Chat window."::: + The GitHub Copilot chat window shows @ Build Per Cpp: Help me improve the build performance of this project. + :::image-end::: + +### Permissions + +The first time you use GitHub Copilot build performance for Windows, you may need to enable Build Insights and grant elevated permissions to collect MSVC compiler traces. + +Visual Studio needs elevated permissions to analyze build performance and the Build Insights tool needs to be enabled. It stays enabled until you disable it. For more information about these permissions, see [Build Insights needs additional permissions](/cpp/build-insights/elevate-note). + +If GitHub Copilot prompts you to enable Build Insights and grant elevated permissions, choose **Confirm**: + +:::image type="complex" source="./media/build-insights-permission.png" alt-text="Screenshot of a GitHub Copilot dialog asking to elevate permissions."::: +The dialog indicates that Build Insights (vcperf) needs additional permissions to capture MSVC compiler traces. There are Confirm and Deny buttons. +:::image-end::: + +A Visual Studio dialog then appears prompting you to allow a one-time elevated request: + +:::image type="complex" source="./media/msvc-elevation.png" alt-text="Screenshot of a Microsoft Visual Studio prompt requesting elevated permissions."::: +The elevation prompt says: Build Insights (vcperf) needs additional permissions to capture MSVC compiler traces. Allow this one-time elevated request? There are Yes and No buttons. +:::image-end::: + +Choose **Yes**. The Windows User Account Control dialog then appears: + +:::image type="complex" source="./media/windows-user-account-control.png" alt-text="Screenshot of the User Account Control dialog."::: +The dialog asks for permission for the Windows Command Processor, verified publisher Microsoft, to allow this app to make changes to your device. There are Yes and No buttons. +:::image-end::: + +Choose **Yes** to grant permission to capture the MSVC compiler traces. Denying the elevated request cancels the build analysis. + +## Guide GitHub Copilot through the process of improving the build time + +As you guide GitHub Copilot through the process of improving the build time, it may ask you to provide permission to run tools such as PowerShell scripts: + +:::image type="complex" source="./media/terminal-permission.png" alt-text="Screenshot of a Copilot Chat notification."::: +The prompt asks the user to authorize running the command: ls ../src/ in the terminal. The Confirm dropdown offers: Always allow and Allow in this session. There's also a Deny button. +:::image-end::: + +Choose the level of permission you are comfortable with. If you deny the request, GitHub Copilot can't proceed with the build performance analysis. + +Copilot may go through multiple iterations to find the best way to make the build faster. In this chat example, Copilot made its first build performance improvement but recognizes more areas to optimize. + +:::image type="complex" source="./media/build-analysis-complete.png" alt-text="Screenshot of a message in the GitHub Copilot chat window."::: +The message indicates that analysis is complete and the build time improved from 78.6 seconds to 70.5 seconds (8.1 seconds faster, ~10.3% improvement). It indicates there's still room for improvement. +:::image-end::: + +When the analysis is done, GitHub Copilot displays a summary of the changes and build performance impact for that iteration: + +:::image type="complex" source="./media/build-summary.png" alt-text="Screenshot of the build performance summary."::: +The summary shows a before and after optimization summary indicating build time, the top bottleneck, and the top five headers that contributed the most to the build time. The report shows build time dropping from 110.7 seconds to 34.1 seconds. It highlights a 69.2% overall improvement and faster incremental rebuilds after enabling precompiled headers. +:::image-end::: + +In this example, build time dropped from **110.7s to 34.1s** after enabling precompiled headers for costly includes. A **69% improvement** and **3.2× faster builds** with near-instant incremental rebuilds. + +### Other ways to access GitHub Copilot build performance for Windows + +You can access the GitHub Copilot build performance for Windows in other ways: + +The **Build** menu: + + :::image type="complex" source="./media/build-menu-improve.png" alt-text="Screenshot of the Build menu."::: + The Build menu option Run Build Insights is expanded to show Build All, Rebuild All, and Improve Build Performance. The latter is selected. + :::image-end::: + + Select **Improve build performance on Solution** to open the GitHub Copilot chat window, which prompts you to optimize the build performance of your project. + :::image type="complex" source="./media/copilot-improve-prompt.png" alt-text="Screenshot of the Copilot chat window."::: + The chat window shows a prompt to Improve Build Performance. + :::image-end::: + +Or use the **Solution** window context menu which you can access by right-clicking the solution node: + + :::image type="complex" source="./media/solution-menu-improve.png" alt-text="A screenshot of the Solution explorer."::: + The context menu shows Build Solution, Build Solution, and so on. Improve build performance on Solution is highlighted. + :::image-end::: + + Select **Improve build performance on Solution** to open the GitHub Copilot chat window, which prompts you to optimize the build performance of your project. + + :::image type="complex" source="./media/copilot-improve-prompt.png" alt-text="Screenshot of the Copilot chat window."::: + The chat window shows a prompt to Improve Build Performance. + :::image-end::: + +Or from the **Build Insights** view: + + Select **Improve** from the Build Insights diagnostics session view to open the GitHub Copilot chat window, which prompts you to optimize the build performance of your project. This button uses data from the existing build insights trace results. It doesn't do a new analysis until the current changes are processed. + + :::image type="complex" source="./media/insights-improve-button.png" alt-text="Screenshot of the Build Insights view window."::: + The Improve link is highlighted. + :::image-end::: + + The GitHub Copilot chat window is prompted to optimize the build performance of your project, focusing on includes. + + :::image type="complex" source="./media/copilot-improve-includes.png" alt-text="Screenshot of the Copilot chat window with focusing on includes prompt."::: + The chat window shows a prompt to Improve Build Performance, focusing on includes. + :::image-end::: + +## Summary + +By combining MSVC Build Insights with GitHub Copilot, you can identify build bottlenecks and apply fixes without manually analyzing trace data or configuring precompiled headers yourself. The workflow handles trace collection, analysis, and code changes in an iterative loop until build times are reduced to your satisfaction. + +## See also + +[Build Insights function view](/cpp/build-insights/tutorials/build-insights-function-view)\ +[Build Insights included files view](/cpp/build-insights/tutorials/build-insights-included-files-view)\ +[vcperf and Windows Performance Analyzer](/cpp/build-insights/tutorials/vcperf-and-wpa)\ +[Windows Performance Analyzer basics](/cpp/build-insights/tutorials/wpa-basics) \ No newline at end of file diff --git a/docs/build-insights/elevate-note.md b/docs/build-insights/elevate-note.md new file mode 100644 index 00000000000..f13849c4b32 --- /dev/null +++ b/docs/build-insights/elevate-note.md @@ -0,0 +1,22 @@ +--- +title: "Build Insights needs additional permissions" +description: "To capture trace files, Build Insights needs additional permissions as described in this topic." +ms.topic: concept-article +ms.date: 12/9/2025 +ms.update-cycle: 3650-days +f1_keywords: + - bi_permissions +--- +# Build Insights needs additional permissions + +Starting with Visual Studio 2026, Build Insights and `vcperf` need extra permissions to capture traces. + +To allow `vcperf` to capture build traces, please accept the one time, per user, elevated prompt that appears when you first attempt to capture a trace: + +:::image type="content" source="./media/elevation-prompt.png" alt-text="A screenshot of the elevation prompt. It says: To capture trace files, Build Insights needs additional permissions. Allow this one-time elevated request?"::: + +Once you accept this elevation request, you can capture trace files with `vcperf`. You won't be prompted again to elevate permissions again. Accepting this request doesn't elevate permissions for Visual Studio--only for `vcperf` so it can to capture traces. + +## See also + +[Get started with C++ Build Insights](get-started-with-cpp-build-insights.md) \ No newline at end of file diff --git a/docs/build-insights/get-started-with-cpp-build-insights.md b/docs/build-insights/get-started-with-cpp-build-insights.md index 0ee6e8c5833..fccaa5d7f91 100644 --- a/docs/build-insights/get-started-with-cpp-build-insights.md +++ b/docs/build-insights/get-started-with-cpp-build-insights.md @@ -4,6 +4,7 @@ description: "A high-level overview of C++ Build Insights." ms.date: "11/03/2019" helpviewer_keywords: ["C++ Build Insights", "throughput analysis", "build time analysis", "vcperf.exe"] ms.custom: intro-get-started +ms.topic: how-to --- # Get started with C++ Build Insights diff --git a/docs/build-insights/index.yml b/docs/build-insights/index.yml index 876c27600a8..bf11ccdb5e3 100644 --- a/docs/build-insights/index.yml +++ b/docs/build-insights/index.yml @@ -17,7 +17,7 @@ landingContent: # Cards and links should be based on top customer tasks or top subjects # Start card title with a verb # Card (optional) - - title: Learn how your build performs + - title: Learn how your build performs linkLists: - linkListType: overview links: @@ -25,6 +25,8 @@ landingContent: url: get-started-with-cpp-build-insights.md - linkListType: tutorial links: + - text: Get started with GitHub Copilot build performance for Windows + url: build-performance.md - text: Build Insights function view url: tutorials/build-insights-function-view.md - text: Build Insights included files view diff --git a/docs/build-insights/media/build-analysis-complete.png b/docs/build-insights/media/build-analysis-complete.png new file mode 100644 index 00000000000..18857c6d623 Binary files /dev/null and b/docs/build-insights/media/build-analysis-complete.png differ diff --git a/docs/build-insights/media/build-insights-options.png b/docs/build-insights/media/build-insights-options.png new file mode 100644 index 00000000000..e8fce846167 Binary files /dev/null and b/docs/build-insights/media/build-insights-options.png differ diff --git a/docs/build-insights/media/build-insights-permission.png b/docs/build-insights/media/build-insights-permission.png new file mode 100644 index 00000000000..4a54a2c87d1 Binary files /dev/null and b/docs/build-insights/media/build-insights-permission.png differ diff --git a/docs/build-insights/media/build-menu-improve.png b/docs/build-insights/media/build-menu-improve.png new file mode 100644 index 00000000000..14fd3cbe2fa Binary files /dev/null and b/docs/build-insights/media/build-menu-improve.png differ diff --git a/docs/build-insights/media/build-summary.png b/docs/build-insights/media/build-summary.png new file mode 100644 index 00000000000..fc7e0a51bff Binary files /dev/null and b/docs/build-insights/media/build-summary.png differ diff --git a/docs/build-insights/media/copilot-build-perf-select.png b/docs/build-insights/media/copilot-build-perf-select.png new file mode 100644 index 00000000000..4bda984a9ca Binary files /dev/null and b/docs/build-insights/media/copilot-build-perf-select.png differ diff --git a/docs/build-insights/media/copilot-build-request.png b/docs/build-insights/media/copilot-build-request.png new file mode 100644 index 00000000000..325ec315daa Binary files /dev/null and b/docs/build-insights/media/copilot-build-request.png differ diff --git a/docs/build-insights/media/copilot-improve-includes.png b/docs/build-insights/media/copilot-improve-includes.png new file mode 100644 index 00000000000..2a398182634 Binary files /dev/null and b/docs/build-insights/media/copilot-improve-includes.png differ diff --git a/docs/build-insights/media/copilot-improve-prompt.png b/docs/build-insights/media/copilot-improve-prompt.png new file mode 100644 index 00000000000..43a5194dc4a Binary files /dev/null and b/docs/build-insights/media/copilot-improve-prompt.png differ diff --git a/docs/build-insights/media/copilot-subscription.png b/docs/build-insights/media/copilot-subscription.png new file mode 100644 index 00000000000..9147ff7177c Binary files /dev/null and b/docs/build-insights/media/copilot-subscription.png differ diff --git a/docs/build-insights/media/elevation-prompt.png b/docs/build-insights/media/elevation-prompt.png new file mode 100644 index 00000000000..619c2999d87 Binary files /dev/null and b/docs/build-insights/media/elevation-prompt.png differ diff --git a/docs/build-insights/media/insights-improve-button.png b/docs/build-insights/media/insights-improve-button.png new file mode 100644 index 00000000000..ba4a0383b82 Binary files /dev/null and b/docs/build-insights/media/insights-improve-button.png differ diff --git a/docs/build-insights/media/model-select.png b/docs/build-insights/media/model-select.png new file mode 100644 index 00000000000..4c3db683c85 Binary files /dev/null and b/docs/build-insights/media/model-select.png differ diff --git a/docs/build-insights/media/msvc-elevation.png b/docs/build-insights/media/msvc-elevation.png new file mode 100644 index 00000000000..7404b6f41ab Binary files /dev/null and b/docs/build-insights/media/msvc-elevation.png differ diff --git a/docs/build-insights/media/solution-menu-improve.png b/docs/build-insights/media/solution-menu-improve.png new file mode 100644 index 00000000000..8b52818c8bb Binary files /dev/null and b/docs/build-insights/media/solution-menu-improve.png differ diff --git a/docs/build-insights/media/terminal-permission.png b/docs/build-insights/media/terminal-permission.png new file mode 100644 index 00000000000..4baf7683bf5 Binary files /dev/null and b/docs/build-insights/media/terminal-permission.png differ diff --git a/docs/build-insights/media/vs-account-authentication.png b/docs/build-insights/media/vs-account-authentication.png new file mode 100644 index 00000000000..3e62cf49c70 Binary files /dev/null and b/docs/build-insights/media/vs-account-authentication.png differ diff --git a/docs/build-insights/media/vs-installer-options.png b/docs/build-insights/media/vs-installer-options.png new file mode 100644 index 00000000000..6bd7c59e9f8 Binary files /dev/null and b/docs/build-insights/media/vs-installer-options.png differ diff --git a/docs/build-insights/media/windows-user-account-control.png b/docs/build-insights/media/windows-user-account-control.png new file mode 100644 index 00000000000..7bee87290d7 Binary files /dev/null and b/docs/build-insights/media/windows-user-account-control.png differ diff --git a/docs/build-insights/reference/sdk/cpp-event-data-types/environment-variable.md b/docs/build-insights/reference/sdk/cpp-event-data-types/environment-variable.md index 7265d140e1f..133484cb32b 100644 --- a/docs/build-insights/reference/sdk/cpp-event-data-types/environment-variable.md +++ b/docs/build-insights/reference/sdk/cpp-event-data-types/environment-variable.md @@ -38,7 +38,7 @@ Along with the inherited members from its [SimpleEvent](simple-event.md) base cl ### Functions -[Name](#name) +[Name](#name)\ [Value](#value) ## EnvironmentVariable diff --git a/docs/build-insights/reference/sdk/cpp-event-data-types/event-group.md b/docs/build-insights/reference/sdk/cpp-event-data-types/event-group.md index 0329689f4c0..6eeabda6f45 100644 --- a/docs/build-insights/reference/sdk/cpp-event-data-types/event-group.md +++ b/docs/build-insights/reference/sdk/cpp-event-data-types/event-group.md @@ -42,11 +42,11 @@ The activity type contained in the group. ### Functions -[Back](#back) -[begin](#begin) -[end](#end) -[Front](#front) -[operator[]](#subscript-operator) +[Back](#back)\ +[begin](#begin)\ +[end](#end)\ +[Front](#front)\ +[operator[]](#subscript-operator)\ [Size](#size) ## Back diff --git a/docs/build-insights/reference/sdk/cpp-event-data-types/event-stack.md b/docs/build-insights/reference/sdk/cpp-event-data-types/event-stack.md index 7b642755497..e206d537cfb 100644 --- a/docs/build-insights/reference/sdk/cpp-event-data-types/event-stack.md +++ b/docs/build-insights/reference/sdk/cpp-event-data-types/event-stack.md @@ -37,8 +37,8 @@ public: ### Functions -[Back](#back) -[operator[]](#subscript-operator) +[Back](#back)\ +[operator[]](#subscript-operator)\ [Size](#size) ## Back diff --git a/docs/build-insights/reference/sdk/cpp-event-data-types/event.md b/docs/build-insights/reference/sdk/cpp-event-data-types/event.md index f8f89269172..e4518cef9e0 100644 --- a/docs/build-insights/reference/sdk/cpp-event-data-types/event.md +++ b/docs/build-insights/reference/sdk/cpp-event-data-types/event.md @@ -43,7 +43,7 @@ public: ### Functions -[Data](#data) +[Data](#data)\ [EventId](#event-id)\ [EventInstanceId](#event-instance-id)\ [EventName](#event-name)\ diff --git a/docs/build-insights/reference/sdk/cpp-event-data-types/file-input.md b/docs/build-insights/reference/sdk/cpp-event-data-types/file-input.md index 74ba8fc4ce6..16078024104 100644 --- a/docs/build-insights/reference/sdk/cpp-event-data-types/file-input.md +++ b/docs/build-insights/reference/sdk/cpp-event-data-types/file-input.md @@ -48,7 +48,7 @@ Along with the inherited members from its [SimpleEvent](simple-event.md) base cl ### Functions -[Path](#path) +[Path](#path)\ [Type](#type) ## FileInput diff --git a/docs/build-insights/reference/sdk/cpp-event-data-types/file-output.md b/docs/build-insights/reference/sdk/cpp-event-data-types/file-output.md index 6772fe813e9..f339588c6e5 100644 --- a/docs/build-insights/reference/sdk/cpp-event-data-types/file-output.md +++ b/docs/build-insights/reference/sdk/cpp-event-data-types/file-output.md @@ -48,7 +48,7 @@ Along with the inherited members from its [SimpleEvent](simple-event.md) base cl ### Functions -[Path](#path) +[Path](#path)\ [Type](#type) ## FileOutput diff --git a/docs/build-insights/reference/sdk/cpp-event-data-types/force-inlinee.md b/docs/build-insights/reference/sdk/cpp-event-data-types/force-inlinee.md index edd2ae4ddf3..ee9bac8bc6f 100644 --- a/docs/build-insights/reference/sdk/cpp-event-data-types/force-inlinee.md +++ b/docs/build-insights/reference/sdk/cpp-event-data-types/force-inlinee.md @@ -38,7 +38,7 @@ Along with the inherited members from its [SimpleEvent](simple-event.md) base cl ### Functions -[Name](#name) +[Name](#name)\ [Size](#size) ## ForceInlinee diff --git a/docs/build-insights/reference/sdk/cpp-event-data-types/invocation.md b/docs/build-insights/reference/sdk/cpp-event-data-types/invocation.md index 0006c06a835..3dc40659f7b 100644 --- a/docs/build-insights/reference/sdk/cpp-event-data-types/invocation.md +++ b/docs/build-insights/reference/sdk/cpp-event-data-types/invocation.md @@ -50,10 +50,10 @@ Along with the inherited members from its [Activity](activity.md) base class, th ### Functions -[ToolPath](#tool-path) -[ToolVersion](#tool-version) -[ToolVersionString](#tool-version-string) -[Type](#type) +[ToolPath](#tool-path)\ +[ToolVersion](#tool-version)\ +[ToolVersionString](#tool-version-string)\ +[Type](#type)\ [WorkingDirectory](#working-directory) ## Invocation diff --git a/docs/build-insights/reference/sdk/cpp-event-data-types/raw-event.md b/docs/build-insights/reference/sdk/cpp-event-data-types/raw-event.md index 2d767ed2805..ef78df1ffc9 100644 --- a/docs/build-insights/reference/sdk/cpp-event-data-types/raw-event.md +++ b/docs/build-insights/reference/sdk/cpp-event-data-types/raw-event.md @@ -67,8 +67,8 @@ If you don't want to convert ticks yourself, the `RawEvent` class provides membe [CPUTime](#cpu-time)\ [Data](#data)\ [Duration](#duration)\ -[EventId](#event-id) -[EventInstanceId](#event-instance-id) +[EventId](#event-id)\ +[EventInstanceId](#event-instance-id)\ [EventName](#event-name)\ [EventWideName](#event-wide-name)\ [ExclusiveCPUTicks](#exclusive-cpu-ticks)\ diff --git a/docs/build-insights/reference/sdk/cpp-event-data-types/symbol-name.md b/docs/build-insights/reference/sdk/cpp-event-data-types/symbol-name.md index 98b10ece5b7..a172bccaea6 100644 --- a/docs/build-insights/reference/sdk/cpp-event-data-types/symbol-name.md +++ b/docs/build-insights/reference/sdk/cpp-event-data-types/symbol-name.md @@ -38,7 +38,7 @@ Along with the inherited members from its [SimpleEvent](simple-event.md) base cl ### Functions -[Key](#key) +[Key](#key)\ [Name](#name) ## Key diff --git a/docs/build-insights/reference/sdk/cpp-event-data-types/template-instantiation.md b/docs/build-insights/reference/sdk/cpp-event-data-types/template-instantiation.md index 3729c2bebd0..b73bc7f4fbb 100644 --- a/docs/build-insights/reference/sdk/cpp-event-data-types/template-instantiation.md +++ b/docs/build-insights/reference/sdk/cpp-event-data-types/template-instantiation.md @@ -48,8 +48,8 @@ Along with the inherited members from its [Activity](activity.md) base class, th ### Functions -[Kind](#kind) -[PrimaryTemplateSymbolKey](#primary-template-symbol-key) +[Kind](#kind)\ +[PrimaryTemplateSymbolKey](#primary-template-symbol-key)\ [SpecializationSymbolKey](#specialization-symbol-key) ## Kind diff --git a/docs/build-insights/reference/sdk/cpp-event-data-types/thread.md b/docs/build-insights/reference/sdk/cpp-event-data-types/thread.md index 290d7e82754..1e850cafb6f 100644 --- a/docs/build-insights/reference/sdk/cpp-event-data-types/thread.md +++ b/docs/build-insights/reference/sdk/cpp-event-data-types/thread.md @@ -3,6 +3,7 @@ title: "Thread class" description: "The C++ Build Insights SDK Thread class reference." ms.date: "02/12/2020" helpviewer_keywords: ["C++ Build Insights", "C++ Build Insights SDK", "Thread", "throughput analysis", "build time analysis", "vcperf.exe"] +ms.topic: reference --- # Thread class diff --git a/docs/build-insights/reference/sdk/cpp-event-data-types/trace-info.md b/docs/build-insights/reference/sdk/cpp-event-data-types/trace-info.md index 918f0ecba93..0d7d0284f48 100644 --- a/docs/build-insights/reference/sdk/cpp-event-data-types/trace-info.md +++ b/docs/build-insights/reference/sdk/cpp-event-data-types/trace-info.md @@ -47,10 +47,10 @@ If you don't want to convert ticks yourself, the `TraceInfo` class provides a me ### Functions -[Duration](#duration) -[LogicalProcessorCount](#logical-processor-count) -[StartTimestamp](#start-timestamp) -[StopTimestamp](#stop-timestamp) +[Duration](#duration)\ +[LogicalProcessorCount](#logical-processor-count)\ +[StartTimestamp](#start-timestamp)\ +[StopTimestamp](#stop-timestamp)\ [TickFrequency](#tick-frequency) ## Duration diff --git a/docs/build-insights/reference/sdk/functions/relog-a.md b/docs/build-insights/reference/sdk/functions/relog-a.md index ca57d0fdb68..36ec0048ec6 100644 --- a/docs/build-insights/reference/sdk/functions/relog-a.md +++ b/docs/build-insights/reference/sdk/functions/relog-a.md @@ -1,10 +1,10 @@ --- title: "RelogA" description: "The C++ Build Insights SDK RelogA function reference." -ms.date: "02/12/2020" +ms.date: 02/12/2020 helpviewer_keywords: ["C++ Build Insights", "C++ Build Insights SDK", "RelogA", "throughput analysis", "build time analysis", "vcperf.exe"] --- -# RelogA +# `RelogA` ::: moniker range="<=msvc-140" @@ -26,17 +26,17 @@ enum RESULT_CODE RelogA( ### Parameters -*inputLogFile*\ +*`inputLogFile`*\ The input ETW trace that you wish to read events from. -*outputLogFile*\ +*`outputLogFile`*\ The file in which to write the new events. -*relogDescriptor*\ -Pointer to a [RELOG_DESCRIPTOR](../other-types/relog-descriptor-struct.md) object. Use this object to configure the relogging session. +*`relogDescriptor`*\ +Pointer to a [`RELOG_DESCRIPTOR`](../other-types/relog-descriptor-struct.md) object. Use this object to configure the relogging session. ### Return Value -A result code from the [RESULT_CODE](../other-types/result-code-enum.md) enum. +A result code from the [`RESULT_CODE`](../other-types/result-code-enum.md) enum. ::: moniker-end diff --git a/docs/build-insights/reference/sdk/functions/relog-w.md b/docs/build-insights/reference/sdk/functions/relog-w.md index c4ed0ad3d9b..d042d6ce853 100644 --- a/docs/build-insights/reference/sdk/functions/relog-w.md +++ b/docs/build-insights/reference/sdk/functions/relog-w.md @@ -1,10 +1,10 @@ --- title: "RelogW" description: "The C++ Build Insights SDK RelogW function reference." -ms.date: "02/12/2020" +ms.date: 02/12/2020 helpviewer_keywords: ["C++ Build Insights", "C++ Build Insights SDK", "RelogW", "throughput analysis", "build time analysis", "vcperf.exe"] --- -# RelogW +# `RelogW` ::: moniker range="<=msvc-140" @@ -26,17 +26,17 @@ enum RESULT_CODE RelogW( ### Parameters -*inputLogFile*\ +*`inputLogFile`*\ The input ETW trace that you wish to read events from. -*outputLogFile*\ +*`outputLogFile`*\ The file in which to write the new events. -*relogDescriptor*\ -Pointer to a [RELOG_DESCRIPTOR](../other-types/relog-descriptor-struct.md) object. Use this object to configure the relogging session. +*`relogDescriptor`*\ +Pointer to a [`RELOG_DESCRIPTOR`](../other-types/relog-descriptor-struct.md) object. Use this object to configure the relogging session. ### Return Value -A result code from the [RESULT_CODE](../other-types/result-code-enum.md) enum. +A result code from the [`RESULT_CODE`](../other-types/result-code-enum.md) enum. ::: moniker-end diff --git a/docs/build-insights/reference/sdk/functions/relog.md b/docs/build-insights/reference/sdk/functions/relog.md index 13259b2978b..c68f319545d 100644 --- a/docs/build-insights/reference/sdk/functions/relog.md +++ b/docs/build-insights/reference/sdk/functions/relog.md @@ -1,10 +1,10 @@ --- title: "Relog" description: "The C++ Build Insights SDK Relog function reference." -ms.date: "02/12/2020" +ms.date: 02/12/2020 helpviewer_keywords: ["C++ Build Insights", "C++ Build Insights SDK", "Relog", "throughput analysis", "build time analysis", "vcperf.exe"] --- -# Relog +# `Relog` ::: moniker range="<=msvc-140" @@ -41,42 +41,44 @@ RESULT_CODE Relog( StaticReloggerGroup reloggerGroup); ``` -### Parameters +### Template parameters + +*`TAnalyzerGroupMembers`*\ +This template parameter pack is always deduced. -*TAnalyzerGroupMembers*\ -This parameter is always deduced. +*`TReloggerGroupMembers`*\ +This template parameter pack is always deduced. -*TReloggerGroupMembers*\ -This parameter is always deduced. +### Parameters -*inputLogFile*\ +*`inputLogFile`*\ The input ETW trace that you wish to read events from. -*outputLogFile*\ +*`outputLogFile`*\ The file in which to write the new events. -*numberOfAnalysisPasses*\ +*`numberOfAnalysisPasses`*\ The number of analysis passes to run on the input trace. The trace gets passed through the provided analyzer group once per analysis pass. -*systemEventsRetentionFlags*\ -A bitmask that specifies which system ETW events to keep in the relogged trace. For more information, see [RELOG_RETENTION_SYSTEM_EVENT_FLAGS](../other-types/relog-retention-system-event-flags-constants.md). +*`systemEventsRetentionFlags`*\ +A bitmask that specifies which system ETW events to keep in the relogged trace. For more information, see [`RELOG_RETENTION_SYSTEM_EVENT_FLAGS`](../other-types/relog-retention-system-event-flags-constants.md). -*analyzerGroup*\ -The analyzer group used for the analysis phase of the relogging session. Call [MakeStaticAnalyzerGroup](make-static-analyzer-group.md) to create an analyzer group. To use a dynamic analyzer group obtained from [MakeDynamicAnalyzerGroup](make-dynamic-analyzer-group.md), first encapsulate it inside a static analyzer group by passing its address to `MakeStaticAnalyzerGroup`. +*`analyzerGroup`*\ +The analyzer group used for the analysis phase of the relogging session. Call [`MakeStaticAnalyzerGroup`](make-static-analyzer-group.md) to create an analyzer group. To use a dynamic analyzer group obtained from [`MakeDynamicAnalyzerGroup`](make-dynamic-analyzer-group.md), first encapsulate it inside a static analyzer group by passing its address to `MakeStaticAnalyzerGroup`. -*reloggerGroup*\ -The relogger group that relogs events into the trace file specified in *outputLogFile*. Call [MakeStaticReloggerGroup](make-static-relogger-group.md) to create a relogger group. To use a dynamic relogger group obtained from [MakeDynamicReloggerGroup](make-dynamic-relogger-group.md), first encapsulate it inside a static relogger group by passing its address to `MakeStaticReloggerGroup`. +*`reloggerGroup`*\ +The relogger group that relogs events into the trace file specified in *`outputLogFile`*. Call [`MakeStaticReloggerGroup`](make-static-relogger-group.md) to create a relogger group. To use a dynamic relogger group obtained from [`MakeDynamicReloggerGroup`](make-dynamic-relogger-group.md), first encapsulate it inside a static relogger group by passing its address to `MakeStaticReloggerGroup`. ### Return Value -A result code from the [RESULT_CODE](../other-types/result-code-enum.md) enum. +A result code from the [`RESULT_CODE`](../other-types/result-code-enum.md) enum. -### Remark +### Remarks -The input trace is passed through the analyzer group *numberOfAnalysisPasses* times. There's no similar option for relogging passes. The trace is passed trough the relogger group only once, after all analysis passes are complete. +The input trace is passed through the analyzer group *`numberOfAnalysisPasses`* times. There's no similar option for relogging passes. The trace is passed through the relogger group only once, after all analysis passes are complete. -The relogging of system events like CPU samples from within a relogger class isn't supported. Use the *systemEventsRetentionFlags* parameter to decide which system events to keep in the output trace. +The relogging of system events like CPU samples from within a relogger class isn't supported. Use the *`systemEventsRetentionFlags`* parameter to decide which system events to keep in the output trace. -The `relog` function depends on the COM API. You must call `CoInitialize` before you call `relog`. Call `CoUninitialize` once `relog` has finished. If you call `relog` without a call to `CoInitialize` first, you'll get error code 9 (`RESULT_CODE_FAILURE_START_RELOGGER`). +The `relog` function depends on the COM API. You must call [`CoInitialize`](/windows/win32/api/objbase/nf-objbase-coinitialize) before you call `relog`. Call [`CoUninitialize`](/windows/win32/api/combaseapi/nf-combaseapi-couninitialize) once `relog` has finished. If you call `relog` without a call to `CoInitialize` first, you'll get error code 9 (`RESULT_CODE_FAILURE_START_RELOGGER`). ::: moniker-end diff --git a/docs/build-insights/reference/sdk/functions/stop-and-relog-tracing-session.md b/docs/build-insights/reference/sdk/functions/stop-and-relog-tracing-session.md index b89dc7f62f5..10f6b58ae14 100644 --- a/docs/build-insights/reference/sdk/functions/stop-and-relog-tracing-session.md +++ b/docs/build-insights/reference/sdk/functions/stop-and-relog-tracing-session.md @@ -72,7 +72,7 @@ A result code from the [RESULT_CODE](../other-types/result-code-enum.md) enum. ### Remarks -The input trace is passed through the analyzer group *numberOfAnalysisPasses* times. There's no similar option for relogging passes. The trace is passed trough the relogger group only once, after all analysis passes are complete. +The input trace is passed through the analyzer group *numberOfAnalysisPasses* times. There's no similar option for relogging passes. The trace is passed through the relogger group only once, after all analysis passes are complete. The relogging of system events like CPU samples from within a relogger class isn't supported. Use the *systemEventsRetentionFlags* parameter to decide which system events to keep in the output trace. diff --git a/docs/build-insights/reference/sdk/functions/stop-tracing-session-a.md b/docs/build-insights/reference/sdk/functions/stop-tracing-session-a.md index 46dedc00da0..39ac969bab5 100644 --- a/docs/build-insights/reference/sdk/functions/stop-tracing-session-a.md +++ b/docs/build-insights/reference/sdk/functions/stop-tracing-session-a.md @@ -13,7 +13,7 @@ The C++ Build Insights SDK is compatible with Visual Studio 2017 and later. To s ::: moniker-end ::: moniker range=">=msvc-150" -The `StopTracingSessionA` function stops an ongoing tracing session and produces a raw trace file. Raw trace files can be passed to the [Analyze](analyze.md), [AnalzeA](analyze-a.md), and [AnalyzeW](analyze-w.md) functions to start an analysis session. Raw trace files can also be passed to the [Relog](relog.md), [RelogA](relog-a.md), and [RelogW](relog-w.md) functions to start relogging session. Executables calling `StopTracingSessionA` must have administrator privileges. +The `StopTracingSessionA` function stops an ongoing tracing session and produces a raw trace file. Raw trace files can be passed to the [Analyze](analyze.md), [AnalyzeA](analyze-a.md), and [AnalyzeW](analyze-w.md) functions to start an analysis session. Raw trace files can also be passed to the [Relog](relog.md), [RelogA](relog-a.md), and [RelogW](relog-w.md) functions to start relogging session. Executables calling `StopTracingSessionA` must have administrator privileges. ## Syntax diff --git a/docs/build-insights/reference/sdk/functions/stop-tracing-session-w.md b/docs/build-insights/reference/sdk/functions/stop-tracing-session-w.md index a050b60ed3b..32e05f8ce83 100644 --- a/docs/build-insights/reference/sdk/functions/stop-tracing-session-w.md +++ b/docs/build-insights/reference/sdk/functions/stop-tracing-session-w.md @@ -13,7 +13,7 @@ The C++ Build Insights SDK is compatible with Visual Studio 2017 and later. To s ::: moniker-end ::: moniker range=">=msvc-150" -The `StopTracingSessionW` function stops an ongoing tracing session and produces a raw trace file. Raw trace files can be passed to the [Analyze](analyze.md), [AnalzeA](analyze-a.md), and [AnalyzeW](analyze-w.md) functions to start an analysis session. Raw trace files can also be passed to the [Relog](relog.md), [RelogA](relog-a.md), and [RelogW](relog-w.md) functions to start relogging session. Executables calling `StopTracingSessionW` must have administrator privileges. +The `StopTracingSessionW` function stops an ongoing tracing session and produces a raw trace file. Raw trace files can be passed to the [Analyze](analyze.md), [AnalyzeA](analyze-a.md), and [AnalyzeW](analyze-w.md) functions to start an analysis session. Raw trace files can also be passed to the [Relog](relog.md), [RelogA](relog-a.md), and [RelogW](relog-w.md) functions to start relogging session. Executables calling `StopTracingSessionW` must have administrator privileges. ## Syntax diff --git a/docs/build-insights/reference/sdk/functions/stop-tracing-session.md b/docs/build-insights/reference/sdk/functions/stop-tracing-session.md index ca9bea6c23f..9e52425ed8a 100644 --- a/docs/build-insights/reference/sdk/functions/stop-tracing-session.md +++ b/docs/build-insights/reference/sdk/functions/stop-tracing-session.md @@ -15,7 +15,7 @@ The C++ Build Insights SDK is compatible with Visual Studio 2017 and later. To s ::: moniker-end ::: moniker range=">=msvc-150" -The `StopTracingSession` function stops an ongoing tracing session and produces a raw trace file. You can pass raw trace files to the [Analyze](analyze.md), [AnalzeA](analyze-a.md), and [AnalyzeW](analyze-w.md) functions to start an analysis session. You can pass raw trace files to the [Relog](relog.md), [RelogA](relog-a.md), and [RelogW](relog-w.md) functions to start a relogging session. +The `StopTracingSession` function stops an ongoing tracing session and produces a raw trace file. You can pass raw trace files to the [Analyze](analyze.md), [AnalyzeA](analyze-a.md), and [AnalyzeW](analyze-w.md) functions to start an analysis session. You can pass raw trace files to the [Relog](relog.md), [RelogA](relog-a.md), and [RelogW](relog-w.md) functions to start a relogging session. The caller must have administrator permissions to use `StopTracingSession`. @@ -28,7 +28,7 @@ inline RESULT_CODE StopTracingSession( TRACING_SESSION_STATISTICS* statistics); inline RESULT_CODE StopTracingSession( - const wchar_t* sessionName + const wchar_t* sessionName, const wchar_t* outputLogFile, TRACING_SESSION_STATISTICS* statistics); ``` diff --git a/docs/build-insights/reference/sdk/other-types/analysis-callbacks-struct.md b/docs/build-insights/reference/sdk/other-types/analysis-callbacks-struct.md index 2957df07f10..348969f6fd6 100644 --- a/docs/build-insights/reference/sdk/other-types/analysis-callbacks-struct.md +++ b/docs/build-insights/reference/sdk/other-types/analysis-callbacks-struct.md @@ -3,6 +3,7 @@ title: "ANALYSIS_CALLBACKS structure" description: "The C++ Build Insights SDK ANALYSIS_CALLBACKS structure reference." ms.date: "02/12/2020" helpviewer_keywords: ["C++ Build Insights", "C++ Build Insights SDK", "ANALYSIS_CALLBACKS", "throughput analysis", "build time analysis", "vcperf.exe"] +ms.topic: reference --- # ANALYSIS_CALLBACKS structure diff --git a/docs/build-insights/reference/sdk/other-types/analysis-descriptor-struct.md b/docs/build-insights/reference/sdk/other-types/analysis-descriptor-struct.md index 73012b0d9ac..d18e384ca27 100644 --- a/docs/build-insights/reference/sdk/other-types/analysis-descriptor-struct.md +++ b/docs/build-insights/reference/sdk/other-types/analysis-descriptor-struct.md @@ -3,6 +3,7 @@ title: "ANALYSIS_DESCRIPTOR structure" description: "The C++ Build Insights SDK ANALYSIS_DESCRIPTOR structure reference." ms.date: "02/12/2020" helpviewer_keywords: ["C++ Build Insights", "C++ Build Insights SDK", "ANALYSIS_DESCRIPTOR", "throughput analysis", "build time analysis", "vcperf.exe"] +ms.topic: reference --- # ANALYSIS_DESCRIPTOR structure diff --git a/docs/build-insights/reference/sdk/other-types/callback-code-enum.md b/docs/build-insights/reference/sdk/other-types/callback-code-enum.md index 157b5e45345..85cbc687ae1 100644 --- a/docs/build-insights/reference/sdk/other-types/callback-code-enum.md +++ b/docs/build-insights/reference/sdk/other-types/callback-code-enum.md @@ -3,6 +3,7 @@ title: "CALLBACK_CODE enum" description: "The C++ Build Insights SDK CALLBACK_CODE enum reference." ms.date: "02/12/2020" helpviewer_keywords: ["C++ Build Insights", "C++ Build Insights SDK", "CALLBACK_CODE", "throughput analysis", "build time analysis", "vcperf.exe"] +ms.topic: reference --- # CALLBACK_CODE enum diff --git a/docs/build-insights/reference/sdk/other-types/relog-callbacks-struct.md b/docs/build-insights/reference/sdk/other-types/relog-callbacks-struct.md index 4232ac43f4a..d3173d03ac4 100644 --- a/docs/build-insights/reference/sdk/other-types/relog-callbacks-struct.md +++ b/docs/build-insights/reference/sdk/other-types/relog-callbacks-struct.md @@ -3,6 +3,7 @@ title: "RELOG_CALLBACKS structure" description: "The C++ Build Insights SDK RELOG_CALLBACKS structure reference." ms.date: "02/12/2020" helpviewer_keywords: ["C++ Build Insights", "C++ Build Insights SDK", "RELOG_CALLBACKS", "throughput analysis", "build time analysis", "vcperf.exe"] +ms.topic: reference --- # RELOG_CALLBACKS structure diff --git a/docs/build-insights/reference/sdk/other-types/relog-descriptor-struct.md b/docs/build-insights/reference/sdk/other-types/relog-descriptor-struct.md index 756616dbbc5..36fa65c7679 100644 --- a/docs/build-insights/reference/sdk/other-types/relog-descriptor-struct.md +++ b/docs/build-insights/reference/sdk/other-types/relog-descriptor-struct.md @@ -3,6 +3,7 @@ title: "RELOG_DESCRIPTOR structure" description: "The C++ Build Insights SDK RELOG_DESCRIPTOR structure reference." ms.date: "02/12/2020" helpviewer_keywords: ["C++ Build Insights", "C++ Build Insights SDK", "RELOG_DESCRIPTOR", "throughput analysis", "build time analysis", "vcperf.exe"] +ms.topic: reference --- # RELOG_DESCRIPTOR structure diff --git a/docs/build-insights/reference/sdk/other-types/relog-retention-system-event-flags-constants.md b/docs/build-insights/reference/sdk/other-types/relog-retention-system-event-flags-constants.md index 103d7f456bc..c82f194f460 100644 --- a/docs/build-insights/reference/sdk/other-types/relog-retention-system-event-flags-constants.md +++ b/docs/build-insights/reference/sdk/other-types/relog-retention-system-event-flags-constants.md @@ -3,6 +3,7 @@ title: "RELOG_RETENTION_SYSTEM_EVENT_FLAGS constants" description: "The C++ Build Insights SDK RELOG_RETENTION_SYSTEM_EVENT_FLAGS constants reference." ms.date: "02/12/2020" helpviewer_keywords: ["C++ Build Insights", "C++ Build Insights SDK", "RELOG_RETENTION_SYSTEM_EVENT_FLAGS", "throughput analysis", "build time analysis", "vcperf.exe"] +ms.topic: reference --- # RELOG_RETENTION_SYSTEM_EVENT_FLAGS constants diff --git a/docs/build-insights/reference/sdk/other-types/result-code-enum.md b/docs/build-insights/reference/sdk/other-types/result-code-enum.md index 6cc9ba32d44..d6ac44cca2b 100644 --- a/docs/build-insights/reference/sdk/other-types/result-code-enum.md +++ b/docs/build-insights/reference/sdk/other-types/result-code-enum.md @@ -3,6 +3,7 @@ title: "RESULT_CODE enum" description: "The C++ Build Insights SDK RESULT_CODE enum reference." ms.date: "02/12/2020" helpviewer_keywords: ["C++ Build Insights", "C++ Build Insights SDK", "RESULT_CODE", "throughput analysis", "build time analysis", "vcperf.exe"] +ms.topic: reference --- # RESULT_CODE enum diff --git a/docs/build-insights/reference/sdk/other-types/tracing-session-msvc-event-flags-constants.md b/docs/build-insights/reference/sdk/other-types/tracing-session-msvc-event-flags-constants.md index f54881ad7f1..5bc47f3b439 100644 --- a/docs/build-insights/reference/sdk/other-types/tracing-session-msvc-event-flags-constants.md +++ b/docs/build-insights/reference/sdk/other-types/tracing-session-msvc-event-flags-constants.md @@ -3,6 +3,7 @@ title: "TRACING_SESSION_MSVC_EVENT_FLAGS constants" description: "The C++ Build Insights SDK TRACING_SESSION_MSVC_EVENT_FLAGS constants reference." ms.date: "02/12/2020" helpviewer_keywords: ["C++ Build Insights", "C++ Build Insights SDK", "TRACING_SESSION_MSVC_EVENT_FLAGS", "throughput analysis", "build time analysis", "vcperf.exe"] +ms.topic: reference --- # TRACING_SESSION_MSVC_EVENT_FLAGS constants diff --git a/docs/build-insights/reference/sdk/other-types/tracing-session-options-struct.md b/docs/build-insights/reference/sdk/other-types/tracing-session-options-struct.md index 88116edfe19..f087e51bf38 100644 --- a/docs/build-insights/reference/sdk/other-types/tracing-session-options-struct.md +++ b/docs/build-insights/reference/sdk/other-types/tracing-session-options-struct.md @@ -3,6 +3,7 @@ title: "TRACING_SESSION_OPTIONS structure" description: "Learn about the C++ Build Insights SDK TRACING_SESSION_OPTIONS structure reference." ms.date: "02/12/2020" helpviewer_keywords: ["C++ Build Insights", "C++ Build Insights SDK", "TRACING_SESSION_OPTIONS", "throughput analysis", "build time analysis", "vcperf.exe"] +ms.topic: reference --- # TRACING_SESSION_OPTIONS structure diff --git a/docs/build-insights/reference/sdk/other-types/tracing-session-statistics-struct.md b/docs/build-insights/reference/sdk/other-types/tracing-session-statistics-struct.md index 67374d0acfe..80b32daa9d1 100644 --- a/docs/build-insights/reference/sdk/other-types/tracing-session-statistics-struct.md +++ b/docs/build-insights/reference/sdk/other-types/tracing-session-statistics-struct.md @@ -3,6 +3,7 @@ title: "TRACING_SESSION_STATISTICS structure" description: "Learn about the C++ Build Insights SDK TRACING_SESSION_STATISTICS structure reference." ms.date: "02/12/2020" helpviewer_keywords: ["C++ Build Insights", "C++ Build Insights SDK", "TRACING_SESSION_STATISTICS", "throughput analysis", "build time analysis", "vcperf.exe"] +ms.topic: reference --- # TRACING_SESSION_STATISTICS structure diff --git a/docs/build-insights/reference/sdk/other-types/tracing-session-system-event-flags-constants.md b/docs/build-insights/reference/sdk/other-types/tracing-session-system-event-flags-constants.md index 4e24aea5d9b..129d27038f3 100644 --- a/docs/build-insights/reference/sdk/other-types/tracing-session-system-event-flags-constants.md +++ b/docs/build-insights/reference/sdk/other-types/tracing-session-system-event-flags-constants.md @@ -3,6 +3,7 @@ title: "TRACING_SESSION_SYSTEM_EVENT_FLAGS constants" description: "The C++ Build Insights SDK TRACING_SESSION_SYSTEM_EVENT_FLAGS constants reference." ms.date: "02/12/2020" helpviewer_keywords: ["C++ Build Insights", "C++ Build Insights SDK", "TRACING_SESSION_SYSTEM_EVENT_FLAGS", "throughput analysis", "build time analysis", "vcperf.exe"] +ms.topic: reference --- # TRACING_SESSION_SYSTEM_EVENT_FLAGS constants diff --git a/docs/build-insights/toc.yml b/docs/build-insights/toc.yml index 99cea23e5b0..f9c51225e1d 100644 --- a/docs/build-insights/toc.yml +++ b/docs/build-insights/toc.yml @@ -6,8 +6,12 @@ items: - name: "Tutorials" expanded: true items: - - name: "Troubleshoot function inlining on build time" + - name: "Get started with GitHub Copilot build performance for Windows" + href: ../build-insights/build-performance.md + - name: "Troubleshoot function inlining impact on build time" href: ../build-insights/tutorials/build-insights-function-view.md + - name: "Troubleshoot template instantiation impact on build time" + href: ../build-insights/tutorials/build-insights-template-view.md - name: "Troubleshoot header file impact on build time" href: ../build-insights/tutorials/build-insights-included-files-view.md - name: "Build Insights tips and tricks" diff --git a/docs/build-insights/tutorials/build-insights-function-view.md b/docs/build-insights/tutorials/build-insights-function-view.md index 3e311500dc5..ac5368e0961 100644 --- a/docs/build-insights/tutorials/build-insights-function-view.md +++ b/docs/build-insights/tutorials/build-insights-function-view.md @@ -1,17 +1,18 @@ --- -title: "Troubleshoot function inlining on build time" +title: "Troubleshoot function inlining impact on build time" description: "Tutorial for how to use Build Insights function view to troubleshoot the impact of function inlining on build time in your C++ projects." ms.date: 5/30/2024 helpviewer_keywords: ["C++ Build Insights", "inline function analysis", "build time analysis", "__forceinline analysis", "inlines analysis"] +ms.topic: troubleshooting-general --- -# Troubleshoot function inlining on build time +# Troubleshoot function inlining impact on build time Use Build Insights **Functions** view to troubleshoot the impact of function inlining on build time in your C++ projects. ## Prerequisites - Visual Studio 2022 17.8 or greater. -- C++ Build insights is enabled by default if you install either the Desktop development with C++ workload or the Game development with C++ workload. +- C++ Build Insights is enabled by default if you install either the Desktop development with C++ workload or the Game development with C++ workload. :::image type="complex" source="./media/installer-desktop-cpp-build-insights.png" alt-text="Screenshot of the Visual Studio Installer with the Desktop development with C++ workload selected."::: The list of installed components is shown. C++ Build Insights is highlighted and is selected which means it's installed. @@ -44,7 +45,7 @@ Set the optimization level to maximum optimizations: 1. In the **Solution Explorer**, right-click the project name and select **Properties**. 1. In the project properties, navigate to **C/C++** > **Optimization**. -1. Set the **Optimization** dropdown to **Maximum Optimization (Favor Speed) ([`/O2`](../../build/reference/ob-inline-function-expansion.md))**. +1. Set the **Optimization** dropdown to **Maximum Optimization (Favor Speed) ([`/O2`](../../build/reference/o1-o2-minimize-size-maximize-speed.md))**. :::image type="content" source="./media/max-optimization-setting.png" alt-text="Screenshot of the project property pages dialog. The settings are open to Configuration Properties > C/C++ > Optimization. The Optimization dropdown is set to Maximum Optimization (Favor Speed) (/O2)."::: @@ -52,7 +53,7 @@ Set the optimization level to maximum optimizations: ## Run Build Insights -On a project of your choosing, and using the **Release** build options set in the previous section, run Build Insights by choosing from the main menu **Build** > **Run Build Insights on Selection** > **Rebuild**. You can also right-click a project in the solution explorer and choose **Run Build Insights** > **Rebuild**. Choose **Rebuild** instead of **Build** to measure the build time for the entire project and not for just the few files may be dirty right now. +On a project of your choosing, and using the **Release** build options set in the previous section, run Build Insights by choosing from the main menu **Build** > **Run Build Insights on Selection** > **Rebuild**. You can also right-click a project in the solution explorer and choose **Run Build Insights** > **Rebuild**. Choose **Rebuild** instead of **Build** to measure the build time for the entire project and not for just the few files that may be dirty right now. :::image type="content" source="./media/build-insights-rebuild-project.png" alt-text="Screenshot of the main menu with Run Build Insights on Selection > Rebuild selected."::: @@ -60,17 +61,17 @@ When the build finishes, an Event Trace Log (ETL) file opens. It's saved in the ## Function view -In the window for the ETL file, choose the **Functions** tab. It shows the functions that were compiled and the time it took to generate the code for each function. If the amount of code generated for a function is negligible, it won't appear in the list to avoid degrading build event collection performance. +In the window for the ETL file, choose the **Functions** tab. It shows the functions that were compiled and the time it took to generate the code for each function. If the amount of code generated for a function is negligible, it doesn't appear in the list to avoid degrading build event collection performance. :::image type="complex" source="./media/functions-view-before-fix.png" alt-text="Screenshot of the Build Insights Functions view file."::: -In the Function Name column, performPhysicsCalculations() is highlighted and marked with a fire icon.::: +In the Function Name column, performPhysicsCalculations() is highlighted and marked with a fire icon. :::image-end::: -The **Time [sec, %]** column shows how long it took to compile each function in [wall clock responsibility time (WCTR)](https://devblogs.microsoft.com/cppblog/faster-cpp-builds-simplified-a-new-metric-for-time/#:~:text=Today%2C%20we%E2%80%99d%20like%20to%20teach%20you%20about%20a,your%20build%2C%20even%20in%20the%20presence%20of%20parallelism). This metric distributes the wall clock time among functions based on their use of parallel compiler threads. For example, if two different threads are compiling two different functions simultaneously within a one-second period, each function’s WCTR is recorded as 0.5 seconds. This reflects each function’s proportional share of the total compilation time, taking into account the resources each consumed during parallel execution. Thus, WCTR provides a better measure of the impact each function has on the overall build time in environments where multiple compilation activities occur simultaneously. +The **Time [sec, %]** column shows how long it took to compile each function in [wall clock responsibility time (WCTR)](https://devblogs.microsoft.com/cppblog/faster-cpp-builds-simplified-a-new-metric-for-time/#:~:text=Today%2C%20we%E2%80%99d%20like%20to%20teach%20you%20about%20a,your%20build%2C%20even%20in%20the%20presence%20of%20parallelism). This metric distributes the wall clock time among functions based on their use of parallel compiler threads. For example, if two different threads are compiling two different functions simultaneously within a one-second period, each function's WCTR is recorded as 0.5 seconds. This reflects each function's proportional share of the total compilation time, taking into account the resources each consumed during parallel execution. Thus, WCTR provides a better measure of the impact each function has on the overall build time in environments where multiple compilation activities occur simultaneously. -The **Forceinline Size** column shows roughly how many instructions were generated for the function. Click the chevron before the function name to see the individual inlined functions that were expanded in that function how roughly how many instructions were generated for each. +The **Forceinline Size** column shows roughly how many instructions were generated for the function. Click the chevron before the function name to see the individual inlined functions that were expanded in that function and roughly how many instructions were generated for each. -You can sort the list by clicking on the **Time** column to see which functions are taking the most time to compile. A 'fire' icon indicates that cost of generating that function is high and is worth investigating. Excessive use of `__forceinline` functions can significantly slow compilation. +You can sort the list by clicking on the **Time** column to see which functions are taking the most time to compile. A 'fire' icon indicates that the cost of generating that function is high and is worth investigating. Excessive use of `__forceinline` functions can significantly slow compilation. You can search for a specific function by using the **Filter Functions** box. If a function's code generation time is too small, it doesn't appear in the **Functions** View. @@ -82,13 +83,13 @@ In this example, the `performPhysicsCalculations` function is taking the most ti In the Function Name column, performPhysicsCalculations() is highlighted and marked with a fire icon. :::image-end::: -Investigating further, by selecting the chevron before that function, and then sorting the **Forceinline Size** column from highest to lowest, we see the biggest contributors to the problem. +By selecting the chevron before that function, and then sorting the **Forceinline Size** column from highest to lowest, we see the biggest contributors to the problem. :::image type="complex" source="./media/functions-view-expanded.png" alt-text="Screenshot of the Build Insights Functions view with an expanded function."::: performPhysicsCalculations() is expanded and shows a long list of functions that were inlined inside it. There are multiple instances of functions such as complexOperation(), recursiveHelper(), and sin() shown. The Forceinline Size column shows that complexOperation() is the largest inlined function at 315 instructions. recursiveHelper() has 119 instructions. Sin() has 75 instructions, but there are many more instances of it than the other functions. :::image-end::: -There are some larger inlined functions, such as `Vector2D::complexOperation()` and `Vector2D::recursiveHelper()` that are contributing to the problem. But there are many more instances (not all shown here) of `Vector2d::sin(float)`, `Vector2d::cos(float)`, `Vector2D::power(float,int)`, and `Vector2D::factorial(int)`. When you add those up, the total number of generated instructions quickly exceeds the few larger generated functions. +There are some larger inlined functions, such as `Vector2D::complexOperation()` and `Vector2D::recursiveHelper()` that are contributing to the problem. But there are many more instances (not all shown here) of `Vector2D::sin(float)`, `Vector2D::cos(float)`, `Vector2D::power(float,int)`, and `Vector2D::factorial(int)`. When you add those up, the total number of generated instructions quickly exceeds the few larger generated functions. Looking at those functions in the source code, we see that execution time is going to be spent inside loops. For example, here's the code for `factorial()`: @@ -105,17 +106,17 @@ static __forceinline T factorial(int n) } ``` -Perhaps the overall cost of calling this function is insignificant compared to the cost of the function itself. Making a function inline is most beneficial when the time it takes to call the function (pushing arguments on the stack, jumping to the function, popping return arguments, and returning from the function) is roughly similar to the time it takes to execute the function, and when the function is called a lot. When that's not the case, there may be diminishing returns on making it inline. We can try removing the `__forceinline` directive from it to see if it helps the build time. The code for `power`, `sin()` and `cos()` is similar in that the code consists of a loop that will execute many times. We can try removing the `__forceinline` directive from those functions as well. +Perhaps the overall cost of calling this function is insignificant compared to the cost of the function itself. Making a function inline is most beneficial when the time it takes to call the function (pushing arguments on the stack, jumping to the function, popping return arguments, and returning from the function) is roughly similar to the time it takes to execute the function, and when the function is called a lot. When that's not the case, there may be diminishing returns on making it inline. We can try removing the `__forceinline` directive from it to see if it helps the build time. The code for `power`, `sin()`, and `cos()` is similar in that the code consists of a loop that executes many times. We can try removing the `__forceinline` directive from those functions as well. -We rerun Build Insights from the main menu by choosing **Build** > **Run Build Insights on Selection** > **Rebuild**. You can also right-click a project in the solution explorer and choose **Run Build Insights** > **Rebuild**. We choose **Rebuild** instead of **Build** to measure the build time for the entire project, as before, and not for just the few files may be dirty right now. +We rerun Build Insights from the main menu by choosing **Build** > **Run Build Insights on Selection** > **Rebuild**. You can also right-click a project in the solution explorer and choose **Run Build Insights** > **Rebuild**. We choose **Rebuild** instead of **Build** to measure the build time for the entire project, as before, and not for just the few files that may be dirty right now. The build time goes from 25.181 seconds to 13.376 seconds and the `performPhysicsCalculations` function doesn't show up anymore in the **Functions** view because it doesn't contribute enough to the build time to be counted. :::image type="complex" source="./media/functions-view-after-fix.png" alt-text="Screenshot of the 2D vector header file."::: -In the Function Name column, performPhysicsCalculations() is highlighted and marked with a fire icon.::: +In the Function Name column, performPhysicsCalculations() is highlighted and marked with a fire icon. :::image-end::: -The Diagnostics Session time is the overall time it took do the build plus any overhead for gathering the Build Insights data. +The Diagnostics Session time is the overall time it took to do the build plus any overhead for gathering the Build Insights data. The next step would be to profile the application to see if the performance of the application is negatively impacted by the change. If it is, we can selectively add `__forceinline` back as needed. @@ -127,8 +128,8 @@ Double-click, right-click, or press **Enter** while on a file in the **Functions ## Tips -- You can **File** > **Save As** the ETL file to a more permanent location to keep a record of the build time. You can then compare it to future builds to see if your changes are improving build time. -- If you inadvertently close the Build Insights window, reopen it by finding the `.etl` file in your temporary folder. The `TEMP` Windows environment variable provides the path of your temporary files folder. +- Use **File** > **Save As** to save the ETL file to a more permanent location to keep a record of the build time information. You can then compare it to future builds to see how your changes are improving things. +- If you close the Build Insights window, reopen it by finding the `.etl` file in your temporary folder. The `TEMP` Windows environment variable provides the path of your temporary files folder. - To dig into the Build Insights data with Windows Performance Analyzer (WPA), click the **Open in WPA** button in the bottom right of the ETL window. - Drag columns to change the order of the columns. For instance, you may prefer moving the **Time** column to be the first column. You can hide columns by right-clicking on the column header and deselecting the columns you don't want to see. - The **Functions** view provides a filter box to find a function that you're interested in. It does partial matches on the name you provide. @@ -144,7 +145,7 @@ Double-click, right-click, or press **Enter** while on a file in the **Functions [Build Insights tips and tricks](build-insights-tips.md)\ [Inline functions (C++)](../../cpp/inline-functions-cpp.md)\ [Faster C++ builds, simplified: a new metric for time](https://devblogs.microsoft.com/cppblog/faster-cpp-builds-simplified-a-new-metric-for-time)\ -[Build Insights in Visual Studio video - Pure Virtual C++ 2023](/events/pure-virtual-cpp-2023/build-insights-in-visual-studio)\ +[Build Insights in Visual Studio video - Pure Virtual C++ 2023](/shows/pure-virtual-cpp-2023/build-insights-in-visual-studio)\ [Troubleshoot header file impact on build time](build-insights-included-files-view.md)\ [Functions View for Build Insights in Visual Studio 2022 17.8](https://devblogs.microsoft.com/cppblog/functions-view-for-build-insights-in-visual-studio-2022-17-8/)\ [Tutorial: vcperf and Windows Performance Analyzer](vcperf-and-wpa.md)\ diff --git a/docs/build-insights/tutorials/build-insights-included-files-view.md b/docs/build-insights/tutorials/build-insights-included-files-view.md index 94dbf1ccde9..3d4422e5572 100644 --- a/docs/build-insights/tutorials/build-insights-included-files-view.md +++ b/docs/build-insights/tutorials/build-insights-included-files-view.md @@ -3,6 +3,7 @@ title: "Troubleshoot header file impact on build time" description: "Tutorial on how to use Build Insights Includes Files and Includes Tree views to troubleshoot the impact of #include files on build time." ms.date: 5/30/2024 helpviewer_keywords: ["C++ Build Insights", "header file build time", "included files view", "include tree view", "#include analysis", "build time analysis"] +ms.topic: how-to --- # Troubleshoot header file impact on build time @@ -171,7 +172,7 @@ Or, you can right-click a file in the **Include Tree** view to jump to it in the - The **Included Files** and **Include Tree** views provide a filter box to find a header file that you're interested in. It does partial matches on the name you provide. - Sometimes the parse time reported for a header file is different depending on which file includes it. This can be due to the interplay of different `#define`s that affect which parts of the header are expanded, file caching, and other system factors. - If you forget what the **Included Files** or **Include Tree** view is trying to show you, hover over the tab to see a tooltip that describes the view. For example, if you hover over the **Include Tree** tab, the tooltip says: "View that shows include statistics for every file where the children nodes are the files included by the parent node." -- You may see cases (like `Windows.h`) where the aggregated duration of all the times for a header file is longer than the duration of the entire build. What’s happening is that headers are being parsed on multiple threads at the same time. If two threads simultaneously spend one second parsing a header file, that's 2 seconds of build time even though only one second of wall clock time has gone by. For more information, see [wall clock responsibility time (WCTR)](https://devblogs.microsoft.com/cppblog/faster-cpp-builds-simplified-a-new-metric-for-time/#:~:text=Today%2C%20we%E2%80%99d%20like%20to%20teach%20you%20about%20a,your%20build%2C%20even%20in%20the%20presence%20of%20parallelism). +- You may see cases (like `Windows.h`) where the aggregated duration of all the times for a header file is longer than the duration of the entire build. What's happening is that headers are being parsed on multiple threads at the same time. If two threads simultaneously spend one second parsing a header file, that's 2 seconds of build time even though only one second of wall clock time has gone by. For more information, see [wall clock responsibility time (WCTR)](https://devblogs.microsoft.com/cppblog/faster-cpp-builds-simplified-a-new-metric-for-time/#:~:text=Today%2C%20we%E2%80%99d%20like%20to%20teach%20you%20about%20a,your%20build%2C%20even%20in%20the%20presence%20of%20parallelism). ## Troubleshooting @@ -182,7 +183,7 @@ Or, you can right-click a file in the **Include Tree** view to jump to it in the [Build Insights tips and tricks](build-insights-tips.md)\ [Compare header units, modules, and precompiled headers](../../build/compare-inclusion-methods.md)\ -[Build Insights in Visual Studio video - Pure Virtual C++ 2023](/events/pure-virtual-cpp-2023/build-insights-in-visual-studio)\ +[Build Insights in Visual Studio video - Pure Virtual C++ 2023](/shows/pure-virtual-cpp-2023/build-insights-in-visual-studio)\ [Faster C++ builds, simplified: a new metric for time](https://devblogs.microsoft.com/cppblog/faster-cpp-builds-simplified-a-new-metric-for-time)\ [Troubleshoot function inlining on build time](build-insights-function-view.md)\ -[vcperf and Windows Performance Analyzer](vcperf-and-wpa.md) \ No newline at end of file +[vcperf and Windows Performance Analyzer](vcperf-and-wpa.md) diff --git a/docs/build-insights/tutorials/build-insights-template-view.md b/docs/build-insights/tutorials/build-insights-template-view.md new file mode 100644 index 00000000000..47382cff0bd --- /dev/null +++ b/docs/build-insights/tutorials/build-insights-template-view.md @@ -0,0 +1,235 @@ +--- +title: "Troubleshoot template instantiation impact on build time" +description: "Tutorial for how to use Build Insights template view to analyze and optimize the impact of template instantiations on build time in your C++ projects." +ms.date: 07/17/2025 +helpviewer_keywords: ["C++ Build Insights", "template instantiation analysis", "build time analysis"] +ms.topic: troubleshooting-general +ai-usage: ai-assisted +--- + +# Troubleshoot template instantiation impact on build time + +Use the Build Insights **Templates** view to see how template instantiation affects C++ build time. It's especially helpful for projects that use lots of templates, like those with template metaprogramming or large generic libraries. + +The **Templates** view works like the Build Insights [Functions view](build-insights-function-view.md). + +## Prerequisites + +- Visual Studio 2022 version 17.10 or later. +- The **C++ Build Insights** component must be installed. Either the Desktop development with C++ workload or the Game development with C++ workload includes it. To check if it's installed, follow these steps: + 1. Open the Visual Studio Installer. + 1. Select **Modify** to change your Visual Studio installation. + 1. On the **Individual components** tab, search for and select **C++ Build Insights**, then select **Close** to finish installing the component. + :::image type="content" source="./media/installer-build-insights.png" alt-text="Screenshot of the Visual Studio Installer. The search box contains C++ Build Insights. The item C++ Build Insights is visible and selected."::: + +## Overview + +Build Insights, integrated into Visual Studio, helps you optimize your build times--especially for large projects like AAA games. Build Insights provides analytics such as the **Templates** view, which shows the time it takes to instantiate each template and which template instantiations add the most to your build time. + +In general, C++ template instantiation happens quickly. In rare cases, some template instantiations can noticeably slow down your build. + +In this article, you create a project that shows how template instantiation affects build time, run Build Insights to analyze the impact, and use those insights to make the build faster. + +## Create a test project + +1. Open Visual Studio and create a new **C++ Console App** project. Name it `TemplateAnalysis`. +1. Create a header file named `Templates.h`, then replace its contents with the following code: + + ```cpp + #pragma once + + #include + #include + + template struct S1 {}; + template using type = std::vector>; + + template struct S2 {}; + + template struct S3 {}; + + template + struct S3> + { + using type = S2)...>; + }; + + inline size_t LargeValue() + { + return sizeof(S3>); + } + + inline size_t SmallValue() + { + return sizeof(S1<5>); + } + ``` + +1. Create a source file named `LargeValue.cpp`, then replace its contents with the following code: + + ```cpp + #include "Templates.h" + + size_t GetLargeValue() + { + return LargeValue(); + } + ``` + +1. Replace the contents of the `TemplateAnalysis.cpp` file with the following code: + + ```cpp + #include "Templates.h" + + extern size_t GetLargeValue(); + + size_t GetSmallValue() + { + return SmallValue(); + } + + int main() + { + size_t largeValue = GetLargeValue(); + size_t smallValue = GetSmallValue(); + return 0; + } + ``` + +## Enable build time data collection + +Template instantiation time collection is off by default to minimize build overhead. To turn it on: + +1. In Visual Studio, go to **Tools** > **Options**. +1. In the **Options** dialog, expand **Build Insights** in the left navigation. +1. Select **Collect Template Instantiation**. +1. To choose where to save the report, select **Store Build Insights reports in this directory** and enter a directory. By default, it's saved in the folder pointed to by the Windows `TEMP` environment variable. +1. Select **OK**. + +:::image type="content" source="./media/tools-options-build-insights.png" alt-text="Screenshot of the project property pages dialog. The settings are open to Build Insights > Trace Collection. The Collect Template Instantiation checkbox is selected."::: + +> [!NOTE] +> Collecting template instantiation times increases build time due to the extra data collected. Only enable it when you want to analyze template instantiation bottlenecks. + +## Run Build Insights to get template instantiation data + +From the main menu, select **Build** > **Run Build Insights on Solution** > **Rebuild**. You can also right-click a project in Solution Explorer and select **Run Build Insights** > **Rebuild**. Choose **Rebuild** instead of **Build** to measure the build time for the entire project. + +:::image type="content" source="./media/build-insights-rebuild-project.png" alt-text="Screenshot of the main menu with Run Build Insights on Selection > Rebuild selected."::: + +When the build finishes, an Event Trace Log (ETL) file opens. The file name is based on the collection time. + +## Use Templates view to optimize build time + +The **Templates** view lists the template instantiations that contributed significantly to build time. The columns provide information about: + +- **Time [sec, %]** shows how long it takes to instantiate each template in [wall clock responsibility time (WCTR)](https://devblogs.microsoft.com/cppblog/faster-cpp-builds-simplified-a-new-metric-for-time/#:~:text=Today%2C%20we%E2%80%99d%20like%20to%20teach%20you%20about%20a,your%20build%2C%20even%20in%20the%20presence%20of%20parallelism). This metric distributes the wall clock time among template instantiations based on their use of parallel compiler threads. +- **Specialization Name** shows each template instantiation, including the template arguments used. This helps you find which template specializations are most expensive. +- **Translation Unit** shows the source files where each template instantiation happens. Different files can cause the same template instantiation if they include the same header with the template definition. +- **Instantiation File Name** shows where the template is defined. + +:::image type="complex" source="./media/templates-view-before-fix.png" alt-text="Screenshot of the Build Insights Templates view showing expensive template instantiations." lightbox="./media/templates-view-before-fix.png"::: +The Templates view shows two template instantiations of struct S3 taking most (79.448 percent) of the build time. The Translation Unit column shows that both LargeValue.cpp and TemplateAnalysis.cpp are affected. The build time is 4.966 seconds. +:::image-end::: + +- Sort by **Time** to find the templates that take the longest to instantiate. +- Expand a template to see its instantiations and where they happened. +- Use the search box to focus on specific templates. + +### Understanding Templates view results + +To interpret the **Templates** view results: + +- **Empty view**: If nothing shows up in the **Templates** view, template instantiations don't dominate your build time. That's good news because your templates aren't a build bottleneck. +- **Duplicate instantiations**: If the same template instantiation appears multiple times across different translation units, different source files are causing the same expensive instantiation. This is often the biggest optimization opportunity. +- **Threshold filtering**: The view only shows instantiations whose contribution exceeds a certain threshold, so you can focus on the most impactful ones and avoid noise from trivial instantiations. +- **Time aggregation**: The time shown is the total time spent on that specific template instantiation, including any nested instantiations. + +## Improve build time by optimizing template instantiations + +In the example, two template instantiations of `S3` take 79 percent of the build time. The **Translation Unit** column shows that both `LargeValue.cpp` and `TemplateAnalysis.cpp` cause this template instantiation. + +The **Instantiation File Name** and the **Specialization Name** are the same for both entries, which means one expensive template instantiation that affects both source files. That's why the time for each of the two template instantiations is roughly equal. Including `Templates.h` in both source files causes one template instantiation to add significant time to the build. + +From the **Specialization Name** column, the expensive instantiation is `S3>`, which is instantiated in this code in `Templates.h`: + +```cpp +inline size_t LargeValue() +{ + return sizeof(S3>); +} +``` + +There are three main ways to decrease the cost of template instantiations. + +### Remove unused templates + +Check if the expensive template is used. If it isn't, the easiest solution is to remove the function or template. In the example, `LargeValue()` is used in `LargeValue.cpp`, so you can't remove it. + +Consider removing include directives that bring in unnecessary template instantiations. It's easy to forget to remove header files when you aren't using them, and unused includes can significantly affect build time. + +### Move template instantiations to source files + +In this example, rely on the third approach: move the definition that causes the expensive template instantiation to a source file. + +Because `LargeValue.cpp` is the only source file that calls `LargeValue()`, move the definition to `LargeValue.cpp`. This change prevents the template instantiation from happening in every file that includes `Templates.h`. Remove the current definition of `LargeValue()` from `Templates.h` and replace it with a declaration: + +```cpp +size_t LargeValue(); +``` + +Inside `LargeValue.cpp` add the definition: + +```cpp +size_t LargeValue() +{ + return sizeof(S3>); +} +``` + +Rebuild the project and run Build Insights again from the main menu. Select **Build** > **Run Build Insights on Selection** > **Rebuild**. + +The build time decreases. While the template instantiation of `S3` still contributes to the build time, including only necessary template instantiations cuts the build time nearly in half. The count of `S3` instantiations is now one instead of two. + +:::image type="complex" source="./media/templates-view-after-fix.png" alt-text="Screenshot of the Build Insights Templates view after optimization. The view shows reduced template instantiation time." lightbox="./media/templates-view-after-fix.png"::: +The Templates view now shows only one instantiation of S3 instead of two, and the total build time is significantly less at 3.152 seconds. +:::image-end::: + +This technique works well for larger projects. If multiple files include `Templates.h`, each file adds the instantiation time of `LargeValue()` to the total build time. By moving the definition of `LargeValue()` to a dedicated source file, you minimize build time. + +### Optimize the template implementation + +Other optimization techniques include: + +- Use simpler template patterns +- Use `if constexpr` instead of Substitution Failure Is Not An Error (SFINAE) when possible +- Avoid recursive template instantiation patterns that lead to exponential growth + +For more advanced template optimization techniques, see [Build Throughput Series: More Efficient Template Metaprogramming](https://devblogs.microsoft.com/cppblog/build-throughput-series-more-efficient-template-metaprogramming/), which provides detailed examples of reducing template instantiation overhead. + +## Tips + +- Use **File** > **Save As** to save the ETL file to a more permanent location to keep a record of the build time information. You can then compare it to future builds to see how your changes are improving things. +- If you close the Build Insights window, reopen it by finding the *dateandtime*.etl file either where you specified it should be saved, or in your temporary folder. The `TEMP` Windows environment variable provides the path of your temporary files folder. +- Drag columns to change the order of the columns. For example, you might want to move the **Wall Time Responsibility** column to the first column. You can add or hide columns by right-clicking the column header and selecting or deselecting the columns you want. +- The **Templates** view has a filter box to help you find a specific template instantiation. It does partial matches on the name you provide. + +## Troubleshooting + +**Templates view is empty**: This can mean: + +- Your build time isn't dominated by template instantiations. +- Template data collection isn't enabled. To turn it on, see [Enable build time data collection](#enable-build-time-data-collection). +- Do a rebuild instead of a build. The Build Insights window doesn't appear if nothing builds, which can be the case if no files changed since the last build. +- Make sure you're using Visual Studio 2022 17.10 or later, and that the C++ Build Insights component is installed. + +**Build is much slower with Templates view enabled:** This is expected because of the extra data collection. Turn off template instantiation collection when you don't need it. For more information, see [Enable build time data collection](#enable-build-time-data-collection). + +## See also + +- [Build Insights tips and tricks](build-insights-tips.md) +- [#include cleanup in Visual Studio](https://devblogs.microsoft.com/cppblog/include-cleanup-in-visual-studio) +- [Troubleshoot header file impact on build time](build-insights-included-files-view.md) +- [Troubleshoot function inlining on build time](build-insights-function-view.md) +- [Build Insights now available in Visual Studio 2022](https://devblogs.microsoft.com/cppblog/build-insights-now-available-in-visual-studio-2022) +- [Build throughput series: More efficient template metaprogramming](https://devblogs.microsoft.com/cppblog/build-throughput-series-more-efficient-template-metaprogramming) diff --git a/docs/build-insights/tutorials/build-insights-tips.md b/docs/build-insights/tutorials/build-insights-tips.md index c46fd438338..45b4517777f 100644 --- a/docs/build-insights/tutorials/build-insights-tips.md +++ b/docs/build-insights/tutorials/build-insights-tips.md @@ -1,10 +1,10 @@ --- title: "Build Insights tips and tricks" description: "Learn time-saving tips for using Build Insights." -ms.date: 11/11/2024 +ms.date: 1/8/2025 author: tylermsft ms.author: twhitney -ms.topic: article +ms.topic: concept-article helpviewer_keywords: ["C++ Build Insights tips and tricks"] --- # Build Insights tips and tricks @@ -30,14 +30,14 @@ If you have a large solution with many projects, you can filter the Build Insigh To try it, click the filter button on the filter column header and select the projects you want to see results for: :::image type="complex" source="./media/build-insights-filter-by-project.png" alt-text="A screenshot of the Build Insights window with the Included Files tab open."::: - The filter button is selected and a list of projects appears. Checkboxes next to two projects are checked."::: + The filter button is selected and a list of projects appears. Checkboxes next to two projects are checked. :::image-end::: -You can also use file wildcards to filter results. The search is case-insensitive: +You can also use file wildcards to filter results. The search is case-insensitive and you should use forward slashes (`/`) as path separators: :::image type="content" source="./media/build-insights-glob-filter.png" alt-text="A screenshot of the build insights filter dialog. There's a files to include text box and a files to exclude text box."::: -This allows you to exclude files from a specific folder or only include files from a specific folder. For example, if your source is located at `C:\src\`, you could include files only from the renderer directory and its subdirectories by putting `C:/src/dev/renderer/**` into the **files to include** text box. +This allows you to exclude files from a specific folder or only include files from a specific folder. For example, if your source is located at `C:\src\`, you could include files only from the renderer directory and its subdirectories by putting `C:/src/dev/renderer/**` into the **files to include** text box. Use forward slashes (`/`) as path separators. Here are some other examples: @@ -55,10 +55,10 @@ This feature requires Visual Studio 2022 17.12 or later. Now you can designate a folder to automatically save Build Insight reports to so you can easily access them. -To set the designated folder, go to **Tools** > **Options** > **C++ Build Insights** > **Trace Collection**. Set a path in the **Store Build Insights reports in this directory** field: +To set the designated folder, go to **Tools** > **Options** > **C++ Build Insights** > **Trace Collection**. Set a path in the **Store Build Insights reports in this directory** textbox: :::image type="complex" source="./media/build-insights-reports-directory.png" alt-text="A screenshot of the options window."::: - tools > Options. Build Insights > Trace Collection is selected in the left pane. Collection Settings appears on the right. The Store Build Insights reports in this directory checkbox is selected, and the text box contains the path c:\users\contoso\workspace as an example."::: + In the left pane, Build Insights > Trace Collection is selected. In the collection settings, the checkbox for Store Build Insights reports in this directory is selected, and the directory text box contains the path c:\users\contoso\workspace as an example. :::image-end::: Reports are automatically saved to this folder when you run Build Insights. If a path isn't set, the `TEMP` folder is used. @@ -73,7 +73,7 @@ To see a short description for the tabs in the Build Insights window, along with ## See also -[Build Insights in Visual Studio video - Pure Virtual C++ 2023](/events/pure-virtual-cpp-2023/build-insights-in-visual-studio)\ +[Build Insights in Visual Studio video - Pure Virtual C++ 2023](/shows/pure-virtual-cpp-2023/build-insights-in-visual-studio)\ [Improving code generation time with C++ Build Insights](https://devblogs.microsoft.com/cppblog/improving-code-generation-time-with-cpp-build-insights)\ [Troubleshoot header file impact on build time](build-insights-included-files-view.md)\ [Tutorial: Troubleshoot function inlining on build time](build-insights-function-view.md) diff --git a/docs/build-insights/tutorials/media/build-insights-rebuild-project.png b/docs/build-insights/tutorials/media/build-insights-rebuild-project.png index 63ceed7705e..fcd96f050e7 100644 Binary files a/docs/build-insights/tutorials/media/build-insights-rebuild-project.png and b/docs/build-insights/tutorials/media/build-insights-rebuild-project.png differ diff --git a/docs/build-insights/tutorials/media/installer-build-insights.png b/docs/build-insights/tutorials/media/installer-build-insights.png new file mode 100644 index 00000000000..55e1ec52cf8 Binary files /dev/null and b/docs/build-insights/tutorials/media/installer-build-insights.png differ diff --git a/docs/build-insights/tutorials/media/templates-view-after-fix.png b/docs/build-insights/tutorials/media/templates-view-after-fix.png new file mode 100644 index 00000000000..7acc1cf276c Binary files /dev/null and b/docs/build-insights/tutorials/media/templates-view-after-fix.png differ diff --git a/docs/build-insights/tutorials/media/templates-view-before-fix.png b/docs/build-insights/tutorials/media/templates-view-before-fix.png new file mode 100644 index 00000000000..22bd3ba5fd4 Binary files /dev/null and b/docs/build-insights/tutorials/media/templates-view-before-fix.png differ diff --git a/docs/build-insights/tutorials/media/tools-options-build-insights.png b/docs/build-insights/tutorials/media/tools-options-build-insights.png new file mode 100644 index 00000000000..b0317d247da Binary files /dev/null and b/docs/build-insights/tutorials/media/tools-options-build-insights.png differ diff --git a/docs/build-insights/tutorials/vcperf-and-wpa.md b/docs/build-insights/tutorials/vcperf-and-wpa.md index e4bf41a1e1e..0b8b278a8aa 100644 --- a/docs/build-insights/tutorials/vcperf-and-wpa.md +++ b/docs/build-insights/tutorials/vcperf-and-wpa.md @@ -3,6 +3,7 @@ title: "Tutorial: vcperf and Windows Performance Analyzer" description: "Tutorial on how to use vcperf and WPA for analyzing C++ build traces." ms.date: "11/03/2019" helpviewer_keywords: ["C++ Build Insights", "throughput analysis", "build time analysis", "vcperf.exe"] +ms.topic: tutorial --- # Tutorial: vcperf and Windows Performance Analyzer diff --git a/docs/build-insights/tutorials/wpa-basics.md b/docs/build-insights/tutorials/wpa-basics.md index 9ac76d830c9..35ad6fe727b 100644 --- a/docs/build-insights/tutorials/wpa-basics.md +++ b/docs/build-insights/tutorials/wpa-basics.md @@ -3,6 +3,7 @@ title: "Tutorial: Windows Performance Analyzer basics" description: "Tutorial on how to complete basic operations in Windows Performance Analyzer." ms.date: "11/03/2019" helpviewer_keywords: ["C++ Build Insights", "throughput analysis", "build time analysis", "vcperf.exe"] +ms.topic: tutorial --- # Tutorial: Windows Performance Analyzer basics diff --git a/docs/build/adding-references-in-visual-cpp-projects.md b/docs/build/adding-references-in-visual-cpp-projects.md index 5d8a5208f72..41de401156b 100644 --- a/docs/build/adding-references-in-visual-cpp-projects.md +++ b/docs/build/adding-references-in-visual-cpp-projects.md @@ -4,6 +4,7 @@ title: "Consuming libraries and components in C++ projects" ms.date: 12/18/2020 f1_keywords: ["VC.Project.References"] helpviewer_keywords: ["Add References Dialog Box (C++)", ".NET Framework (C++), Add References Dialog Box"] +ms.topic: how-to --- # Consuming libraries and components @@ -21,13 +22,13 @@ To consume a library that you have downloaded by using the **vcpkg** package man If your static library project gets built in the same solution: -1. #include the header file(s) for the static library using quotation marks. In a typical solution, the path starts with `../`. IntelliSense will help you find it. +1. `#include` the header file(s) for the static library using quotation marks. In a typical solution, the path starts with `../`. IntelliSense will help you find it. 2. Add a reference to the static library project. Right-click on **References** under the application project node in **Solution Explorer** and choose **Add Reference**. If the static library isn't part of the solution: 1. Right-click on the application project node in **Solution Explorer** and then choose **Properties**. -2. In the **VC++ Directories** property page, add the path to the directory that contains the LIB file to **Library Paths**. Then, add the path to the library header file(s) to **Include Directories**. +2. In the **VC++ Directories** property page, add the path to the directory that contains the LIB file to **Library Directories**. Then, add the path to the library header file(s) to **Include Directories**. 3. In the **Linker > Input** property page, add the name of the LIB file to **Additional Dependencies**. ## Dynamic link libraries @@ -161,5 +162,5 @@ The following properties exist on COM and .NET assembly references, and aren't m ## See also -[C++ project property page reference](reference/property-pages-visual-cpp.md)
+[C++ project property page reference](reference/property-pages-visual-cpp.md)\ [Set C++ compiler and build properties in Visual Studio](working-with-project-properties.md) diff --git a/docs/build/arm-exception-handling.md b/docs/build/arm-exception-handling.md index f2f9b9a13e6..b7cc353313d 100644 --- a/docs/build/arm-exception-handling.md +++ b/docs/build/arm-exception-handling.md @@ -1,8 +1,8 @@ --- -description: "Learn more about: ARM Exception Handling" title: "ARM Exception Handling" +description: "Learn more about: ARM Exception Handling" ms.date: 12/15/2021 -ms.assetid: fe0e615f-c033-4ad5-97f4-ff96af45b201 +ms.topic: concept-article --- # ARM Exception Handling @@ -166,7 +166,7 @@ When the packed unwind format is insufficient to describe the unwinding of a fun |0|20|*X* is a 1-bit field that indicates the presence (1) or absence (0) of exception data.| |0|21|*`E`* is a 1-bit field that indicates that information that describes a single epilogue is packed into the header (1) rather than requiring additional scope words later (0).| |0|22|*F* is a 1-bit field that indicates that this record describes a function fragment (1) or a full function (0). A fragment implies that there's no prologue and that all prologue processing should be ignored.| - |0|23-27|*Epilogue Count* is a 5-bit field that has two meanings, depending on the state of the *`E`* bit:

- If *`E`* is 0, this field is a count of the total number of epilogue scopes described in section 2. If more than 31 scopes exist in the function, then this field and the *Code Words* field must both be set to 0 to indicate that an extension word is required.
- If *`E`* is 1, this field specifies the index of the first unwind code that describes the only epilogue.| + |0|23-27|*Epilogue Count* is a 5-bit field that has two meanings, depending on the state of the *`E`* bit:

- If *`E`* is 0, this field is a count of the total number of epilogue scopes described in section 2. If more than 31 scopes exist in the function, then this field and the *Code Words* field must both be set to 0 to indicate that an extension word is required.
- If *`E`* is 1, this field specifies the index of the first unwind code that describes the only epilogue.| |0|28-31|*Code Words* is a 4-bit field that specifies the number of 32-bit words required to contain all of the unwind codes in section 4. If more than 15 words are required for more than 63 unwind code bytes, this field and the *Epilogue Count* field must both be set to 0 to indicate that an extension word is required.| |1|0-15|*Extended Epilogue Count* is a 16-bit field that provides more space for encoding an unusually large number of epilogues. The extension word that contains this field is only present if the *Epilogue Count* and *Code Words* fields in the first header word are both set to 0.| |1|16-23|*Extended Code Words* is an 8-bit field that provides more space for encoding an unusually large number of unwind code words. The extension word that contains this field is only present if the *Epilogue Count* and *Code Words* fields in the first header word are both set to 0.| diff --git a/docs/build/arm64-exception-handling.md b/docs/build/arm64-exception-handling.md index 0b2ebe6c680..d459965ede4 100644 --- a/docs/build/arm64-exception-handling.md +++ b/docs/build/arm64-exception-handling.md @@ -1,6 +1,6 @@ --- title: "ARM64 exception handling" -description: Describes the exception handling conventions and data used by windows on ARM64. +description: "Describes the exception handling conventions and data used by windows on ARM64." ms.date: 01/13/2023 --- # ARM64 exception handling @@ -287,7 +287,7 @@ The unwind codes are encoded according to the table below. All unwind codes are |--|--| | `alloc_s` | 000xxxxx: allocate small stack with size \< 512 (2^5 * 16). | | `save_r19r20_x` | 001zzzzz: save `` pair at `[sp-#Z*8]!`, pre-indexed offset >= -248 | -| `save_fplr` | 01zzzzzz: save `` pair at `[sp+#Z*8]`, offset \<= 504. | +| `save_fplr` | 01zzzzzz: save `` pair at `[sp+#Z*8]`, offset \<= 504. | | `save_fplr_x` | 10zzzzzz: save `` pair at `[sp-(#Z+1)*8]!`, pre-indexed offset >= -512 | | `alloc_m` | 11000xxx'xxxxxxxx: allocate large stack with size \< 32K (2^11 * 16). | | `save_regp` | 110010xx'xxzzzzzz: save `x(19+#X)` pair at `[sp+#Z*8]`, offset \<= 504 | @@ -299,14 +299,20 @@ The unwind codes are encoded according to the table below. All unwind codes are | `save_fregp_x` | 1101101x'xxzzzzzz: save pair `d(8+#X)` at `[sp-(#Z+1)*8]!`, pre-indexed offset >= -512 | | `save_freg` | 1101110x'xxzzzzzz: save reg `d(8+#X)` at `[sp+#Z*8]`, offset \<= 504 | | `save_freg_x` | 11011110'xxxzzzzz: save reg `d(8+#X)` at `[sp-(#Z+1)*8]!`, pre-indexed offset >= -256 | +| `alloc_z` | 11011111'zzzzzzzz: allocate stack with size `z * SVE-VL` | | `alloc_l` | 11100000'xxxxxxxx'xxxxxxxx'xxxxxxxx: allocate large stack with size \< 256M (2^24 * 16) | | `set_fp` | 11100001: set up `x29` with `mov x29,sp` | | `add_fp` | 11100010'xxxxxxxx: set up `x29` with `add x29,sp,#x*8` | | `nop` | 11100011: no unwind operation is required. | | `end` | 11100100: end of unwind code. Implies `ret` in epilog. | | `end_c` | 11100101: end of unwind code in current chained scope. | -| `save_next` | 11100110: save next non-volatile Int or FP register pair. | -| | 11100111: reserved | +| `save_next` | 11100110: save next register pair. | +| `save_any_xreg` | 11100111'0pxrrrrr'00oooooo: save register(s)
  • `p`: 0/1 => single `X(#r)` vs pair `X(#r)` + `X(#r+1)`
  • `x`: 0/1 => positive vs negative pre-indexed stack offset
  • `o`: offset = `o` * 16, if x=1 or p=1, else `o` * 8
(Windows >= 11 required) | +| `save_any_dreg` | 11100111'0pxrrrrr'01oooooo: save register(s)
  • `p`: 0/1 => single `D(#r)` vs pair `D(#r)` + `D(#r+1)`
  • `x`: 0/1 => positive vs negative pre-indexed stack offset
  • `o`: offset = `o` * 16, if x=1 or p=1, else `o` * 8
(Windows >= 11 required) | +| `save_any_qreg` | 11100111'0pxrrrrr'10oooooo: save register(s)
  • `p`: 0/1 => single `Q(#r)` vs pair `Q(#r)` + `Q(#r+1)`
  • `x`: 0/1 => positive vs negative pre-indexed stack offset
  • `o`: offset = `o` * 16
(Windows >= 11 required) | +| `save_zreg` | 11100111'0oo0rrrr'11oooooo: save reg `Z(#r+8)` at `[sp + #o * VL]`, (`Z8` through `Z23`) +| `save_preg` | 11100111'0oo1rrrr'11oooooo: save reg `P(#r)` at `[sp + #o * (VL / 8)]`, (`P4` through `P15`; `r` values `[0, 3]` are reserved) +| | 11100111'1yyyyyyy': reserved | | | 11101xxx: reserved for custom stack cases below only generated for asm routines | | | 11101000: Custom stack for `MSFT_OP_TRAP_FRAME` | | | 11101001: Custom stack for `MSFT_OP_MACHINE_FRAME` | @@ -330,7 +336,7 @@ In instructions with large values covering multiple bytes, the most significant Post-indexed offset addressing isn't allowed in a prolog. All offset ranges (#Z) match the encoding of `stp`/`str` addressing except `save_r19r20_x`, in which 248 is sufficient for all save areas (10 Int registers + 8 FP registers + 8 input registers). -`save_next` must follow a save for Int or FP volatile register pair: `save_regp`, `save_regp_x`, `save_fregp`, `save_fregp_x`, `save_r19r20_x`, or another `save_next`. It saves the next register pair at the next 16-byte slot in "growing up" order. A `save_next` refers to the first FP register pair when it follows the `save-next` that denotes the last Int register pair. +`save_next` must follow a save for a register pair: `save_regp`, `save_regp_x`, `save_fregp`, `save_fregp_x`, `save_r19r20_x`, or another `save_next`. It can also be used in conjunction with `save_any_xreg`, `save_any_dreg` or `save_any_qreg` but only when `p = 1`. It saves the next register pair in numerically increasing order to the next stack space. `save_next` must not be used beyond the last register of the same kind. Since the sizes of regular return and jump instructions are the same, there's no need for a separated `end` unwind code in tail-call scenarios. diff --git a/docs/build/arm64-windows-abi-conventions.md b/docs/build/arm64-windows-abi-conventions.md index 7d65ba7985e..0d4f98ff387 100644 --- a/docs/build/arm64-windows-abi-conventions.md +++ b/docs/build/arm64-windows-abi-conventions.md @@ -1,15 +1,15 @@ --- -description: "Learn more about: Overview of ARM64 ABI conventions" title: "Overview of ARM64 ABI conventions" -ms.date: "03/27/2019" +description: "Learn more about: Overview of ARM64 ABI conventions" +ms.date: 04/08/2025 --- # Overview of ARM64 ABI conventions -The basic application binary interface (ABI) for Windows when compiled and run on ARM processors in 64-bit mode (ARMv8 or later architectures), for the most part, follows ARM's standard AArch64 EABI. This article highlights some of the key assumptions and changes from what is documented in the EABI. For information about the 32-bit ABI, see [Overview of ARM ABI conventions](overview-of-arm-abi-conventions.md). For more information about the standard ARM EABI, see [Application Binary Interface (ABI) for the ARM Architecture](https://github.com/ARM-software/abi-aa) (external link). +The basic application binary interface (ABI) for Windows when compiled and run on ARM processors in 64-bit mode (ARMv8 or later architectures), usually follows ARM's standard AArch64 EABI. This article highlights some of the key assumptions and changes from what is documented in the EABI. For information about the 32-bit ABI, see [Overview of ARM ABI conventions](overview-of-arm-abi-conventions.md). For more information about the standard ARM EABI, see [Application Binary Interface (ABI) for the ARM Architecture](https://github.com/ARM-software/abi-aa) (external link). ## Definitions -With the introduction of 64-bit support, ARM has defined several terms: +With the introduction of 64-bit support, ARM defined several terms: - **AArch32** – the legacy 32-bit instruction set architecture (ISA) defined by ARM, including Thumb mode execution. - **AArch64** – the new 64-bit instruction set architecture (ISA) defined by ARM. @@ -19,8 +19,9 @@ With the introduction of 64-bit support, ARM has defined several terms: Windows also uses these terms: - **ARM** – refers to the 32-bit ARM architecture (AArch32), sometimes referred to as WoA (Windows on ARM). -- **ARM32** – same as ARM, above; used in this document for clarity. +- **ARM32** – same as **ARM**. Used in this document for clarity. - **ARM64** – refers to the 64-bit ARM architecture (AArch64). There's no such thing as WoA64. +- **ARM64EC** - code built as ARM64EC can interoperate with x64 code running under emulation in the same process. The Arm64EC code in the process runs with native performance, while the x64 code runs using emulation. Finally, when referring to data types, the following definitions from ARM are referenced: @@ -30,7 +31,7 @@ Finally, when referring to data types, the following definitions from ARM are re ## Base requirements -The ARM64 version of Windows presupposes that it's running on an ARMv8 or later architecture at all times. Both floating-point and NEON support are presumed to be present in hardware. +The ARM64 version of Windows always presupposes that it's running on an ARMv8 or later architecture. Both floating-point and NEON support are presumed to be present in hardware. The ARMv8 specification describes new optional crypto and CRC helper opcodes for both AArch32 and AArch64. Support for them is currently optional, but recommended. To take advantage of these opcodes, apps should first make runtime checks for their existence. @@ -74,7 +75,7 @@ The AArch64 architecture supports 32 integer registers: | x18 | N/A | Reserved platform register: in kernel mode, points to KPCR for the current processor; In user mode, points to TEB | | x19-x28 | Non-volatile | Scratch registers | | x29/fp | Non-volatile | Frame pointer | -| x30/lr | Both | Link Register: Callee function must preserve it for its own return, but caller's value will be lost. | +| x30/lr | Both | Link Register: Callee function must preserve it for its own return, but caller's value is lost. | Each register may be accessed as a full 64-bit value (via x0-x30) or as a 32-bit value (via w0-w30). 32-bit operations zero-extend their results up to 64 bits. @@ -86,7 +87,7 @@ The frame pointer (x29) is required for compatibility with fast stack walking us ## Floating-point/SIMD registers -The AArch64 architecture also supports 32 floating-point/SIMD registers, summarized below: +The AArch64 architecture also supports these 32 floating-point/SIMD registers: | Register | Volatility | Role | | - | - | - | @@ -118,7 +119,11 @@ Like AArch32, the AArch64 specification provides three system-controlled "thread ## Floating-point exceptions -Support for IEEE floating-point exceptions is optional on AArch64 systems. For processor variants that do have hardware floating-point exceptions, the Windows kernel silently catches the exceptions and implicitly disables them in the FPCR register. This trap ensures normalized behavior across processor variants. Otherwise, code developed on a platform without exception support may find itself taking unexpected exceptions when running on a platform with support. +To determine if an ARM CPU supports exceptions, write a value that enables exceptions to the FPCR register and then read it back. If the CPU supports floating-point exceptions, the bits corresponding to supported exceptions remain set, while the CPU resets the bits for unsupported exceptions. + +On ARM64, Windows delivers exceptions for processors that support hardware floating-point exceptions. + +The [`_set_controlfp`](../c-runtime-library/reference/controlfp-s.md) function on ARM platforms correctly changes the FPCR register when unmasking floating-point exceptions. However, instead of raising an unmasked exception, Windows resets the FPCR register to its defaults every time an FP exception is about to be raised. ## Parameter passing @@ -148,7 +153,7 @@ For each argument in the list, the first matching rule from the following list i ### Stage C – Assignment of arguments to registers and stack -For each argument in the list, the following rules are applied in turn until the argument has been allocated. When an argument is assigned to a register, any unused bits in the register have unspecified value. If an argument is assigned to a stack slot, any unused padding bytes have unspecified value. +For each argument in the list, the following rules are applied in turn until the argument is allocated. When an argument is assigned to a register, any unused bits in the register have unspecified value. If an argument is assigned to a stack slot, any unused padding bytes have unspecified value. 1. If the argument is a Half-, Single-, Double- or Quad-precision Floating-point or Short Vector Type, and the NSRN is less than 8, then the argument is allocated to the least significant bits of register v\[NSRN]. The NSRN is incremented by one. The argument has now been allocated. @@ -158,7 +163,7 @@ For each argument in the list, the following rules are applied in turn until the 1. If the argument is an HFA, an HVA, a Quad-precision Floating-point or Short Vector Type, then the NSAA is rounded up to the larger of 8 or the Natural Alignment of the argument's type. -1. If the argument is a Half- or Single-precision Floating Point type, then the size of the argument is set to 8 bytes. The effect is as if the argument had been copied to the least significant bits of a 64-bit register, and the remaining bits filled with unspecified values. +1. If the argument is a Half- or Single-precision Floating Point type, then the size of the argument is set to 8 bytes. The effect is as if the argument were copied to the least significant bits of a 64-bit register, and the remaining bits filled with unspecified values. 1. If the argument is an HFA, an HVA, a Half-, Single-, Double-, or Quad-precision Floating-point or Short Vector Type, then the argument is copied to memory at the adjusted NSAA. The NSAA is incremented by the size of the argument. The argument has now been allocated. @@ -199,7 +204,7 @@ Floating-point values are returned in s0, d0, or v0, as appropriate. A type is considered to be an HFA or HVA if all of the following hold: - It's non-empty, -- It doesn't have any non-trivial default or copy constructors, destructors, or assignment operators, +- It doesn't have any nontrivial default or copy constructors, destructors, or assignment operators, - All of its members have the same HFA or HVA type, or are float, double, or neon types that match the other members' HFA or HVA types. HVA values with four or fewer elements are returned in s0-s3, d0-d3, or v0-v3, as appropriate. @@ -210,12 +215,12 @@ Types returned by value are handled differently depending on whether they have c - they have a trivial copy-assignment operator, and - they have a trivial destructor, -and are returned by non-member functions or static member functions, use the following return style: +and are returned by nonmember functions or static member functions, use the following return style: - Types that are HFAs with four or fewer elements are returned in s0-s3, d0-d3, or v0-v3, as appropriate. - Types less than or equal to 8 bytes are returned in x0. - Types less than or equal to 16 bytes are returned in x0 and x1, with x0 containing the lower-order 8 bytes. -- For other aggregate types, the caller shall reserve a block of memory of sufficient size and alignment to hold the result. The address of the memory block shall be passed as an additional argument to the function in x8. The callee may modify the result memory block at any point during the execution of the subroutine. The callee isn't required to preserve the value stored in x8. +- For other aggregate types, the caller shall reserve a block of memory of sufficient size and alignment to hold the result. The address of the memory block shall be passed as another argument to the function in x8. The callee may modify the result memory block at any point during the execution of the subroutine. The callee isn't required to preserve the value stored in x8. All other types use this convention: @@ -223,9 +228,9 @@ All other types use this convention: ## Stack -Following the ABI put forth by ARM, the stack must remain 16-byte aligned at all times. AArch64 contains a hardware feature that generates stack alignment faults whenever the SP isn't 16-byte aligned and an SP-relative load or store is done. Windows runs with this feature enabled at all times. +Following the ABI put forth by ARM, the stack must always remain 16-byte aligned. AArch64 contains a hardware feature that generates stack alignment faults whenever the SP isn't 16-byte aligned and an SP-relative load or store is done. Windows always runs with this feature enabled. -Functions that allocate 4k or more worth of stack must ensure that each page prior to the final page is touched in order. This action ensures no code can "leap over" the guard pages that Windows uses to expand the stack. Typically the touching is done by the `__chkstk` helper, which has a custom calling convention that passes the total stack allocation divided by 16 in x15. +Functions that allocate 4k or more worth of stack must ensure that each page before the final page is touched in order. This action ensures no code can "leap over" the guard pages that Windows uses to expand the stack. Typically the touching is done by the `__chkstk` helper, which has a custom calling convention that passes the total stack allocation divided by 16 in x15. ## Red zone @@ -241,7 +246,7 @@ Code within Windows is compiled with frame pointers enabled ([/Oy-](reference/oy ## Exception unwinding -Unwinding during exception handling is assisted through the use of unwind codes. The unwind codes are a sequence of bytes stored in the .xdata section of the executable. They describe the operation of the prologue and epilogue in an abstract manner, such that the effects of a function's prologue can be undone in preparation for backing up to the caller's stack frame. For more information on the unwind codes, see [ARM64 exception handling](arm64-exception-handling.md). +Unwinding during exception handling is assisted by using unwind codes. The unwind codes are a sequence of bytes stored in the .xdata section of the executable. They describe the operation of the prologue and epilogue in an abstract manner, such that the effects of a function's prologue can be undone in preparation for backing up to the caller's stack frame. For more information on the unwind codes, see [ARM64 exception handling](arm64-exception-handling.md). The ARM EABI also specifies an exception unwinding model that uses unwind codes. However, the specification as presented is insufficient for unwinding in Windows, which must handle cases where the PC is in the middle of a function prologue or epilogue. @@ -251,9 +256,9 @@ Code that is dynamically generated should be described with dynamic function tab All ARMv8 CPUs are required to support a cycle counter register, a 64-bit register that Windows configures to be readable at any exception level, including user mode. It can be accessed via the special PMCCNTR_EL0 register, using the MSR opcode in assembly code, or the `_ReadStatusReg` intrinsic in C/C++ code. -The cycle counter here is a true cycle counter, not a wall clock. The counting frequency will vary with the processor frequency. If you feel you must know the frequency of the cycle counter, you shouldn't be using the cycle counter. Instead, you want to measure wall clock time, for which you should use `QueryPerformanceCounter`. +The cycle counter here is a true cycle counter, not a wall clock. The counting frequency varies with the processor frequency. If you feel you must know the frequency of the cycle counter, you shouldn't be using the cycle counter. Instead, you want to measure wall clock time, for which you should use `QueryPerformanceCounter`. ## See also -[Common Visual C++ ARM Migration Issues](common-visual-cpp-arm-migration-issues.md)
+[Common Microsoft C++ ARM Migration Issues](common-visual-cpp-arm-migration-issues.md)
[ARM64 exception handling](arm64-exception-handling.md) diff --git a/docs/build/arm64ec-windows-abi-conventions.md b/docs/build/arm64ec-windows-abi-conventions.md index 39f6d7434ea..4cd9117c777 100644 --- a/docs/build/arm64ec-windows-abi-conventions.md +++ b/docs/build/arm64ec-windows-abi-conventions.md @@ -9,7 +9,7 @@ ARM64EC is an application binary interface (ABI) that enables ARM64 binaries to For more information on the x64 and ARM64 ABIs, see [Overview of x64 ABI conventions](x64-software-conventions.md) and [Overview of ARM64 ABI conventions](arm64-windows-abi-conventions.md). -ARM64EC doesn't solve memory model differences between x64 and ARM based architectures. For more information, see [Common Visual C++ ARM migration issues](common-visual-cpp-arm-migration-issues.md). +ARM64EC doesn't solve memory model differences between x64 and ARM based architectures. For more information, see [Common Microsoft C++ ARM migration issues](common-visual-cpp-arm-migration-issues.md). ## Definitions @@ -92,6 +92,12 @@ Special helper routines like `__chkstk_arm64ec` use custom calling conventions a ARM64EC follows the same struct packing rules used for x64 to ensure interoperability between ARM64EC code and x64 code. For more information and examples of x64 struct packing, see [Overview of x64 ABI conventions](x64-software-conventions.md). +## Floating-point exceptions + +To determine if an ARM CPU supports exceptions, write a value that enables exceptions to the FPCR register and then read it back. If the CPU supports floating-point exceptions, the bits corresponding to supported exceptions remain set, while the CPU resets the bits for unsupported exceptions. + +On ARM64EC, Windows catches processor floating-point exceptions and disables them in the FPCR register. This ensures consistent behavior across different processor variants. + ## Emulation helper ABI routines ARM64EC code and [thunks](#thunks) use emulation helper routines to transition between x64 and ARM64EC functions. @@ -182,5 +188,5 @@ The ARM64EC toolchain currently doesn't support `__vectorcall`. The compiler emi ## See also [Understanding ARM64EC ABI and assembly code](/windows/arm/arm64ec-abi)\ -[Common Visual C++ ARM migration issues](common-visual-cpp-arm-migration-issues.md)\ +[Common Microsoft C++ ARM migration issues](common-visual-cpp-arm-migration-issues.md)\ [Decorated names](./reference/decorated-names.md) diff --git a/docs/build/building-c-cpp-isolated-applications-and-side-by-side-assemblies.md b/docs/build/building-c-cpp-isolated-applications-and-side-by-side-assemblies.md index 6d15a9df762..8a247863e48 100644 --- a/docs/build/building-c-cpp-isolated-applications-and-side-by-side-assemblies.md +++ b/docs/build/building-c-cpp-isolated-applications-and-side-by-side-assemblies.md @@ -4,14 +4,15 @@ title: "Building C/C++ Isolated Applications and Side-by-side Assemblies" ms.date: "05/06/2019" helpviewer_keywords: ["isolated applications [C++]", "WinSxS [C++]", "native assembly cache [C++]", "builds [C++], isolated applications", "side-by-side applications [C++]", "builds [C++], side-by-side assemblies"] ms.assetid: 9465904e-76f7-48bd-bb3f-c55d8f1699b6 +ms.topic: concept-article --- # Building C/C++ Isolated Applications and Side-by-side Assemblies Visual Studio supports a deployment model for Windows client applications based on the idea of [isolated applications](/windows/win32/SbsCs/isolated-applications) and [side-by-side assemblies](/windows/win32/SbsCs/about-side-by-side-assemblies-). By default, Visual Studio builds all native C/C++ applications as isolated applications that use [manifests](/windows/win32/sbscs/manifests) to describe their dependencies on Visual C++ libraries. -Building C/C++ programs as isolated applications presents a range of advantages. For example, an isolated application is unaffected when other C/C++ applications install or uninstall Visual C++ libraries. Visual C++ libraries used by isolated applications may still be redistributed in either the application's local folder, or by installation to the native assembly cache (WinSxS); however, servicing of Visual C++ libraries for already deployed applications can be simplified by using a [publisher configuration file](/windows/win32/SbsCs/publisher-configuration). The isolated application deployment model makes it easier to ensure that C/C++ applications that are running on a specific computer use the most recent version of Visual C++ libraries, while still leaving open the possibility for system administrators and application authors to control explicit version binding of applications to their dependent DLLs. +Building C/C++ programs as isolated applications presents a range of advantages. For example, an isolated application is unaffected when other C/C++ applications install or uninstall Microsoft C++ libraries. Microsoft C++ libraries used by isolated applications may still be redistributed in either the application's local folder, or by installation to the native assembly cache (WinSxS); however, servicing of Microsoft C++ libraries for already deployed applications can be simplified by using a [publisher configuration file](/windows/win32/SbsCs/publisher-configuration). The isolated application deployment model makes it easier to ensure that C/C++ applications that are running on a specific computer use the most recent version of Microsoft C++ libraries, while still leaving open the possibility for system administrators and application authors to control explicit version binding of applications to their dependent DLLs. -This section discusses how you can build your C/C++ application as an isolated application and ensure that it binds to Visual C++ libraries using a manifest. The information in this section primarily applies to native, or unmanaged, C++ applications. For information about deploying native C++ applications built with Visual Studio, see [Redistributing Visual C++ Files](../windows/redistributing-visual-cpp-files.md). +This section discusses how you can build your C/C++ application as an isolated application and ensure that it binds to Microsoft C++ libraries using a manifest. The information in this section primarily applies to native, or unmanaged, C++ applications. For information about deploying native C++ applications built with Visual Studio, see [Redistributing Microsoft C++ Files](../windows/redistributing-visual-cpp-files.md). ## In This Section diff --git a/docs/build/building-c-cpp-isolated-applications.md b/docs/build/building-c-cpp-isolated-applications.md index 6494e2dd386..8724e842f8c 100644 --- a/docs/build/building-c-cpp-isolated-applications.md +++ b/docs/build/building-c-cpp-isolated-applications.md @@ -4,6 +4,7 @@ title: "Building C/C++ Isolated Applications" ms.date: "05/06/2019" helpviewer_keywords: ["isolated applications [C++]"] ms.assetid: 8a2fe4fa-0489-433e-bfc6-495844d8d73a +ms.topic: concept-article --- # Building C/C++ Isolated Applications diff --git a/docs/build/building-c-cpp-side-by-side-assemblies.md b/docs/build/building-c-cpp-side-by-side-assemblies.md index 615b2c1d3bb..29478d8b6ed 100644 --- a/docs/build/building-c-cpp-side-by-side-assemblies.md +++ b/docs/build/building-c-cpp-side-by-side-assemblies.md @@ -4,6 +4,7 @@ title: "Building C/C++ Side-by-side Assemblies" ms.date: "11/04/2016" helpviewer_keywords: ["side-by-side applications [C++]"] ms.assetid: 7fa20b16-3737-4f76-a0b5-1dacea19a1e8 +ms.topic: concept-article --- # Building C/C++ Side-by-side Assemblies diff --git a/docs/build/building-on-the-command-line.md b/docs/build/building-on-the-command-line.md index 06332dd5235..07501e59a26 100644 --- a/docs/build/building-on-the-command-line.md +++ b/docs/build/building-on-the-command-line.md @@ -1,14 +1,14 @@ --- -title: "Use the Microsoft C++ toolset from the command line" -description: "Use the Microsoft C++ (MSVC) compiler toolset from the command line outside of the Visual Studio IDE." +title: "Use the Microsoft C++ Build Tools from the command line" +description: "Use the Microsoft C++ (MSVC) Build Tools from the command line outside of the Visual Studio IDE." ms.custom: "conceptual" ms.date: 04/07/2022 +ms.topic: how-to helpviewer_keywords: ["command-line builds [C++]", "compiling source code [C++], command line", "builds [C++], command-line", "command line [C++], building from", "command line [C++], compilers"] -ms.assetid: 7ca9daed-a003-4162-842d-908f79058365 --- -# Use the Microsoft C++ toolset from the command line +# Use the Microsoft C++ Build Tools from the command line -You can build C and C++ applications on the command line by using tools that are included in Visual Studio. The Microsoft C++ (MSVC) compiler toolset is also downloadable as a standalone package. You don't need to install the Visual Studio IDE if you don't plan to use it. +You can build C and C++ applications on the command line by using tools that are included in Visual Studio. The Microsoft C++ (MSVC) Build Tools are also downloadable as a standalone package. You don't need to install the Visual Studio IDE if you don't plan to use it. > [!NOTE] > This article is about how to set up an environment to use the individual compilers, linkers, librarian, and other basic tools. The native project build system in Visual Studio, based on MSBuild, doesn't use the environment as described in this article. For more information on how to use MSBuild from the command line, see [MSBuild on the command line - C++](msbuild-visual-cpp.md). @@ -22,13 +22,13 @@ If you've installed Visual Studio and a C++ workload, you have all the command-l ::: moniker-end ::: moniker range="<=msvc-150" -If you've installed Visual Studio and a C++ workload, you have all the command-line tools. For information on how to install C++ and Visual Studio, see [Install C++ support in Visual Studio](vscpp-step-0-installation.md). If you only want the command-line toolset, download the [Build Tools for Visual Studio 2017](https://my.visualstudio.com/Downloads?q=2017). When you run the downloaded executable, it updates and runs the Visual Studio Installer. To install only the tools you need for C++ development, select the **Visual C++ build tools** workload. You can select optional libraries and toolsets to include under **Installation details**. To build code by using the Visual Studio 2015 toolset, select the optional MSVC v140 build tools. When you're satisfied with your selections, choose **Install**. +If you've installed Visual Studio and a C++ workload, you have all the command-line tools. For information on how to install C++ and Visual Studio, see [Install C++ support in Visual Studio](vscpp-step-0-installation.md). If you only want the command-line toolset, download the [Build Tools for Visual Studio 2017](https://my.visualstudio.com/Downloads?q=2017). When you run the downloaded executable, it updates and runs the Visual Studio Installer. To install only the tools you need for C++ development, select the **Desktop development with C++** workload. You can select optional libraries and toolsets to include under **Installation details**. To build code by using the Visual Studio 2015 toolset, select the optional MSVC v140 build tools. When you're satisfied with your selections, choose **Install**. ::: moniker-end ## How to use the command-line tools -When you choose one of the C++ workloads in the Visual Studio Installer, it installs the Visual Studio *platform toolset*. A platform toolset has all the C and C++ tools for a specific Visual Studio version. The tools include the C/C++ compilers, linkers, assemblers, and other build tools, and matching libraries and header files. You can use all of these tools at the command line. They're also used internally by the Visual Studio IDE. There are separate x86-hosted and x64-hosted compilers and tools to build code for x86, x64, ARM, and ARM64 targets. Each set of tools for a particular host and target build architecture is stored in its own directory. +When you choose one of the C++ workloads in the Visual Studio Installer, by default, it installs a particular version of the MSVC Build Tools package. For Visual Studio 2022 and earlier, this is organized by a *platform toolset* (v### version format) that has all the C and C++ tools for a specific version of Visual Studio. For Visual Studio 2026 and later, this consists of the MSVC version (v##.## version format), which has all the C and C++ tools for that particular MSVC package. The MSVC version is decoupled from the Visual Studio version. The tools include the C/C++ compilers, linkers, assemblers, and other build tools, and matching libraries and header files. You can use all of these tools at the command-line. They're also used internally by the Visual Studio IDE. There are separate x86-hosted and x64-hosted compilers and tools that build code for x86, x64, ARM, and ARM64 targets. Each set of tools for a particular host and target build architecture is stored in its own directory. To work correctly, the tools require several specific environment variables to be set. These variables are used to add the tools to the path, and to set the locations of include files, library files, and SDKs. To make it easy to set these environment variables, the installer creates customized *command files*, or batch files, during installation. You can run one of these command files to set a specific host and target build architecture, Windows SDK version, and platform toolset. For convenience, the installer also creates shortcuts in your Start menu. The shortcuts open developer command prompt windows by using these command files for specific combinations of host and target. These shortcuts ensure all the required environment variables are set and ready to use. @@ -80,7 +80,7 @@ The Start menu folder and shortcut names vary depending on the installed version For an even faster way to open a developer command prompt, enter *developer command prompt* in the desktop search box. Then choose the result you want. > [!NOTE] -> By default, the current working directory in a developer command prompt is the root of your Visual Studio installation in the Program Files directory. This isn't an appropriate location for your code and projects. Change the current working directory to another location before you create a project. The IDE creates projects in your user directory, typically in *%USERPROFILE%\\source\\repos*. +> By default, the current working directory in a developer command prompt is the root of your Visual Studio installation in the Program Files directory. This isn't an appropriate location for your code and projects. Change the current working directory to another location before you create a project. The IDE creates projects in your user directory, typically in *`%USERPROFILE%\source\repos`*. ## Developer command file locations @@ -88,7 +88,7 @@ If you prefer to set the build environment in an existing command prompt window, ::: moniker range=">= msvc-170" -The command file location depends on the version of Visual Studio you installed, and on choices you made during installation. For Visual Studio 2019, the typical installation location on a 64-bit system is in *`\Program Files\Microsoft Visual Studio\2022\`*. The *``* may be Community, Professional, Enterprise, BuildTools, or another nickname you supplied. +The command file location depends on the version of Visual Studio you installed, and on choices you made during installation. For Visual Studio 2022, the typical installation location on a 64-bit system is in *`\Program Files\Microsoft Visual Studio\2022\`*. The *``* may be Community, Professional, Enterprise, BuildTools, or another nickname you supplied. ::: moniker-end ::: moniker range="= msvc-160" @@ -111,12 +111,12 @@ The primary developer command prompt command file, *`VsDevCmd.bat`*, is located ::: moniker range=">= msvc-150" -More command files are available to set up specific build architectures. The command files available depend on the Visual Studio workloads and options you've installed. In Visual Studio 2017 and Visual Studio 2019, you'll find them in the VC\\Auxiliary\\Build subdirectory. +More command files are available to set up specific build architectures. The command files available depend on the Visual Studio workloads and options you've installed. In Visual Studio 2017 and Visual Studio 2019, you'll find them in the *`VC\Auxiliary\Build`* subdirectory. ::: moniker-end ::: moniker range="< msvc-150" -More command files are available to set up specific build architectures. The command files available depend on the Visual Studio workloads and options you've installed. In Visual Studio 2015, they're located in the VC, VC\\bin, or VC\\bin\\*architecture* subdirectories, where *architecture* is one of the native or cross-compiler options. +More command files are available to set up specific build architectures. The command files available depend on the Visual Studio workloads and options you've installed. In Visual Studio 2015, they're located in the *`VC`*, *`VC\bin`*, or *`VC\bin\`* subdirectories, where *``* is one of the native or cross-compiler options. ::: moniker-end @@ -149,8 +149,8 @@ When used with no arguments, *`vcvarsall.bat`* configures the environment variab > **`vcvarsall.bat`** [*`architecture`*] [*`platform_type`*] [*`winsdk_version`*] [**`-vcvars_ver=`***`vcversion`*] [*`spectre_mode`*] -*`architecture`*
-This optional argument specifies the host and target architecture to use. If *architecture* isn't specified, the default build environment is used. These arguments are supported: +*`architecture`*\ +This optional argument specifies the host and target architecture to use. If *`architecture`* isn't specified, the default build environment is used. These arguments are supported: | *`architecture`* | Compiler | Host computer architecture | Build output (target) architecture | |--|--|--|--| @@ -163,13 +163,13 @@ This optional argument specifies the host and target architecture to use. If *ar | `amd64_arm` or `x64_arm` | ARM on x64 cross | x64 | ARM | | `amd64_arm64` or `x64_arm64` | ARM64 on x64 cross | x64 | ARM64 | -*`platform_type`*
+*`platform_type`*\ This optional argument allows you to specify **`store`** or **`uwp`** as the platform type. By default, the environment is set to build desktop or console apps. -*`winsdk_version`*
+*`winsdk_version`*\ Optionally specifies the version of the Windows SDK to use. By default, the latest installed Windows SDK is used. To specify the Windows SDK version, you can use a full Windows SDK number such as **`10.0.10240.0`**, or specify **`8.1`** to use the Windows 8.1 SDK. -*`vcversion`*
+*`vcversion`*\ Optionally specifies the Visual Studio compiler toolset to use. By default, the environment is set to use the current Visual Studio compiler toolset. ::: moniker range=">= msvc-160" @@ -194,11 +194,13 @@ Leave this parameter out to use libraries without Spectre mitigations. Use the v #### To set up the build environment in an existing command prompt window -1. At the command prompt, use the CD command to change to the Visual Studio installation directory. Then, use CD again to change to the subdirectory that contains the configuration-specific command files. For Visual Studio 2019 and Visual Studio 2017, use the *VC\\Auxiliary\\Build* subdirectory. For Visual Studio 2015, use the *VC* subdirectory. +1. At the command prompt, use the `CD` command to change to the Visual Studio installation directory. Then, use `CD` again to change to the subdirectory that contains the configuration-specific command files. For Visual Studio 2019 and Visual Studio 2017, use the *`VC\Auxiliary\Build`* subdirectory. For Visual Studio 2015, use the *`VC`* subdirectory. 1. Enter the command for your preferred developer environment. For example, to build ARM code for UWP on a 64-bit platform, using the latest Windows SDK and Visual Studio compiler toolset, use this command line: - `vcvarsall.bat amd64_arm uwp` + ```cmd + vcvarsall.bat amd64_arm uwp + ``` ## Create your own command prompt shortcut @@ -206,21 +208,27 @@ Leave this parameter out to use libraries without Spectre mitigations. Use the v Open the Properties dialog for a developer command prompt shortcut to see the command target used. For example, the target for the **x64 Native Tools Command Prompt for VS 2019** shortcut is something similar to: -`%comspec% /k "C:\Program Files (x86)\Microsoft Visual Studio\2019\Community\VC\Auxiliary\Build\vcvars64.bat"` +```cmd +%comspec% /k "C:\Program Files (x86)\Microsoft Visual Studio\2019\Community\VC\Auxiliary\Build\vcvars64.bat" +``` ::: moniker-end ::: moniker range="= msvc-150" Open the Properties dialog for a developer command prompt shortcut to see the command target used. For example, the target for the **x64 Native Tools Command Prompt for VS 2017** shortcut is something similar to: -`%comspec% /k "C:\Program Files (x86)\Microsoft Visual Studio\2017\Community\VC\Auxiliary\Build\vcvars64.bat"` +```cmd +%comspec% /k "C:\Program Files (x86)\Microsoft Visual Studio\2017\Community\VC\Auxiliary\Build\vcvars64.bat" +``` ::: moniker-end ::: moniker range="< msvc-150" Open the Properties dialog for a developer command prompt shortcut to see the command target used. For example, the target for the **VS2015 x64 Native Tools Command Prompt** shortcut is something similar to: -`%comspec% /k "C:\Program Files (x86)\Microsoft Visual Studio 14.0\VC\vcvarsall.bat" amd64` +```cmd +%comspec% /k "C:\Program Files (x86)\Microsoft Visual Studio 14.0\VC\vcvarsall.bat" amd64 +``` ::: moniker-end @@ -228,31 +236,37 @@ The architecture-specific batch files set the *`architecture`* parameter and cal ::: moniker range=">= msvc-160" -`%comspec% /k "C:\Program Files (x86)\Microsoft Visual Studio\2019\Community\VC\Auxiliary\Build\vcvarsall.bat" amd64_arm uwp -vcvars_ver=14.29` +```cmd +%comspec% /k "C:\Program Files (x86)\Microsoft Visual Studio\2019\Community\VC\Auxiliary\Build\vcvarsall.bat" amd64_arm uwp -vcvars_ver=14.29 +``` ::: moniker-end ::: moniker range="= msvc-150" -`%comspec% /k "C:\Program Files (x86)\Microsoft Visual Studio\2017\Community\VC\Auxiliary\Build\vcvarsall.bat" amd64_arm uwp -vcvars_ver=14.19` +```cmd +%comspec% /k "C:\Program Files (x86)\Microsoft Visual Studio\2017\Community\VC\Auxiliary\Build\vcvarsall.bat" amd64_arm uwp -vcvars_ver=14.19 +``` ::: moniker-end ::: moniker range="< msvc-150" -`%comspec% /k "C:\Program Files (x86)\Microsoft Visual Studio 14.0\VC\vcvarsall.bat" amd64 -vcvars_ver=14.0` +```cmd +%comspec% /k "C:\Program Files (x86)\Microsoft Visual Studio 14.0\VC\vcvarsall.bat" amd64 -vcvars_ver=14.0 +``` ::: moniker-end -Adjust the path to reflect your Visual Studio installation directory. The vcvarsall.bat file has additional information about specific version numbers. +Adjust the path to reflect your Visual Studio installation directory. The *`vcvarsall.bat`* file has additional information about specific version numbers. ## Command-line tools To build a C/C++ project at a command prompt, Visual Studio provides these command-line tools: -[`CL`](reference/compiling-a-c-cpp-program.md)
-Use the compiler (cl.exe) to compile and link source code files into apps, libraries, and DLLs. +[`CL`](reference/compiling-a-c-cpp-program.md)\ +Use the compiler (`cl.exe`) to compile and link source code files into apps, libraries, and DLLs. -[`Link`](reference/linking.md)
-Use the linker (link.exe) to link compiled object files and libraries into apps and DLLs. +[`Link`](reference/linking.md)\ +Use the linker (`link.exe`) to link compiled object files and libraries into apps and DLLs. When you build on the command line, the F1 command isn't available for instant help. Instead, you can use a search engine to get information about warnings, errors, and messages. You can also download and use the offline help files. To use the search in Microsoft Learn, enter your query in the search box at the top of any article. @@ -261,16 +275,16 @@ When you build on the command line, the F1 command isn't available for instant h By default, the Visual Studio IDE uses native project build systems based on MSBuild. You can invoke MSBuild directly to build projects without using the IDE. You can also use the `devenv` command to use Visual Studio to build projects and solutions. Visual Studio also supports build systems based on CMake or NMake. [`MSBuild`](msbuild-visual-cpp.md)\ -Use MSBuild (msbuild.exe) and a project file (.vcxproj) to configure a build and invoke the toolset without loading the Visual Studio IDE. It's equivalent to running the **Build** project or **Build Solution** command in the Visual Studio IDE. MSBuild has advantages over the IDE when you build at the command line. You don't have to install the full IDE on all your build servers and build pipelines. You avoid the extra overhead of the IDE. MSBuild runs in containerized build environments, and supports a [binary logger](https://msbuildlog.com/). +Use MSBuild (`msbuild.exe`) and a project file (`.vcxproj`) to configure a build and invoke the toolset without loading the Visual Studio IDE. It's equivalent to running the **Build** project or **Build Solution** command in the Visual Studio IDE. MSBuild has advantages over the IDE when you build at the command line. You don't have to install the full IDE on all your build servers and build pipelines. You avoid the extra overhead of the IDE. MSBuild runs in containerized build environments, and supports a [binary logger](https://msbuildlog.com/). [`DEVENV`](/visualstudio/ide/reference/devenv-command-line-switches)\ -Use DEVENV (devenv.exe) combined with a command-line switch such as **`/Build`** or **`/Clean`** to execute certain build commands without displaying the Visual Studio IDE. +Use DEVENV (`devenv.exe`) combined with a command-line switch such as **`/Build`** or **`/Clean`** to execute certain build commands without displaying the Visual Studio IDE. [`CMake`](../build/cmake-projects-in-visual-studio.md)\ -CMake (cmake.exe) is a cross-platform, open-source tool for defining build processes that run on multiple platforms. CMake can configure and control native build tools for its supported platforms, such as MSBuild and Make. For more information about CMake, see the [CMake documentation](https://cmake.org/cmake/help/latest/index.html#). +CMake (`cmake.exe`) is a cross-platform, open-source tool for defining build processes that run on multiple platforms. CMake can configure and control native build tools for its supported platforms, such as MSBuild and Make. For more information about CMake, see the [CMake documentation](https://cmake.org/cmake/help/latest/index.html#). [`NMAKE`](reference/nmake-reference.md)\ -Use NMAKE (nmake.exe) to build C++ projects by using a traditional makefile. +Use NMAKE (`nmake.exe`) to build C++ projects by using a traditional makefile. > [!NOTE] > Starting in Visual Studio 2019 version 16.5, MSBuild and DEVENV don't use the command-line environment to control the toolset and libraries used. @@ -279,36 +293,36 @@ Use NMAKE (nmake.exe) to build C++ projects by using a traditional makefile. These articles show how to build apps on the command line, and describe how to customize the command-line build environment. Some show how to use 64-bit toolsets, and target x86, x64, ARM, and ARM64 platforms. They also describe use of the command-line build tools MSBuild and NMAKE. -[Walkthrough: Compiling a native C++ program on the command line](walkthrough-compiling-a-native-cpp-program-on-the-command-line.md)
+[Walkthrough: Compiling a native C++ program on the command line](walkthrough-compiling-a-native-cpp-program-on-the-command-line.md)\ Gives an example that shows how to create and compile a C++ program on the command line. -[Walkthrough: Compile a C program on the command line](walkthrough-compile-a-c-program-on-the-command-line.md)
+[Walkthrough: Compile a C program on the command line](walkthrough-compile-a-c-program-on-the-command-line.md)\ Describes how to compile a program written in the C programming language. -[Walkthrough: Compiling a C++/CLI program on the command line](walkthrough-compiling-a-cpp-cli-program-on-the-command-line.md)
+[Walkthrough: Compiling a C++/CLI program on the command line](walkthrough-compiling-a-cpp-cli-program-on-the-command-line.md)\ Describes how to create and compile a C++/CLI program that uses the .NET Framework. -[Walkthrough: Compiling a C++/CX program on the command line](walkthrough-compiling-a-cpp-cx-program-on-the-command-line.md)
+[Walkthrough: Compiling a C++/CX program on the command line](walkthrough-compiling-a-cpp-cx-program-on-the-command-line.md)\ Describes how to create and compile a C++/CX program that uses the Windows Runtime. -[NMAKE reference](reference/nmake-reference.md)
-Provides links to articles that describe the Microsoft Program Maintenance Utility (NMAKE.EXE). +[NMAKE reference](reference/nmake-reference.md)\ +Provides links to articles that describe the Microsoft Program Maintenance Utility (`NMAKE.EXE`). -[MSBuild on the command line - C++](msbuild-visual-cpp.md)
-Provides links to articles that discuss how to use msbuild.exe from the command line. +[MSBuild on the command line - C++](msbuild-visual-cpp.md)\ +Provides links to articles that discuss how to use `msbuild.exe` from the command line. ## Related sections -[/MD, /MT, /LD (Use run-time library)](reference/md-mt-ld-use-run-time-library.md)
+[`/MD`, `/MT`, `/LD` (Use run-time library)](reference/md-mt-ld-use-run-time-library.md)\ Describes how to use these compiler options to use a Debug or Release run-time library. -[C/C++ compiler options](reference/compiler-options.md)
-Provides links to articles that discuss the C and C++ compiler options and CL.exe. +[C/C++ compiler options](reference/compiler-options.md)\ +Provides links to articles that discuss the C and C++ compiler options and `CL.exe`. -[MSVC linker options](reference/linker-options.md)
-Provides links to articles that discuss the linker options and LINK.exe. +[MSVC linker options](reference/linker-options.md)\ +Provides links to articles that discuss the linker options and `LINK.exe`. -[Additional MSVC build tools](reference/c-cpp-build-tools.md)
+[Additional MSVC build tools](reference/c-cpp-build-tools.md)\ Provides links to the C/C++ build tools that are included in Visual Studio. ## See also diff --git a/docs/build/calling-dll-functions-from-visual-basic-applications.md b/docs/build/calling-dll-functions-from-visual-basic-applications.md index bf6850d0f5b..38bcce3a900 100644 --- a/docs/build/calling-dll-functions-from-visual-basic-applications.md +++ b/docs/build/calling-dll-functions-from-visual-basic-applications.md @@ -4,6 +4,7 @@ title: "Calling DLL Functions from Visual Basic Applications" ms.date: "11/04/2016" helpviewer_keywords: ["functions [C++], calling DLL functions from Visual Basic", "DLL functions [C++]", "function calls [C++], DLL functions", "DLLs [C++], calling", "calling DLL functions from VB applications [C++]", "__stdcall keyword [C++]", "DLL functions [C++], calling"] ms.assetid: 282f7fbf-a0f2-4b9f-b277-1982710be56c +ms.topic: concept-article --- # Calling DLL Functions from Visual Basic Applications diff --git a/docs/build/checking-for-memory-overwrites.md b/docs/build/checking-for-memory-overwrites.md index 786540319e2..5c8869aca10 100644 --- a/docs/build/checking-for-memory-overwrites.md +++ b/docs/build/checking-for-memory-overwrites.md @@ -4,6 +4,7 @@ title: "Checking for Memory Overwrites" ms.date: "11/04/2016" helpviewer_keywords: ["memory, overwrites"] ms.assetid: da7c5d77-a267-415f-a8ab-ee5ce5bfc286 +ms.topic: concept-article --- # Checking for Memory Overwrites diff --git a/docs/build/clang-support-cmake.md b/docs/build/clang-support-cmake.md index 157c3259d95..4b74bd679fc 100644 --- a/docs/build/clang-support-cmake.md +++ b/docs/build/clang-support-cmake.md @@ -26,19 +26,18 @@ You can use Visual Studio with Clang to edit and debug C++ CMake projects that t For the best IDE support in Visual Studio, we recommend using the latest Clang compiler tools for Windows. If you don't already have those, you can install them by opening the Visual Studio Installer and choosing **C++ Clang compiler for Windows** under **Desktop development with C++** optional components. You may prefer to use an existing Clang installation on your machine; if so, choose the **C++ Clang-cl for v142 build tools** or **C++ Clang-cl for v143 build tools** component. -![Screenshot of the Visual Studio Installer Individual Components page that shows Clang components available for installation.](media/clang-install-vs2019.png) +:::image type="content" source="media/clang-install-vs2019.png" alt-text="Screenshot of the Visual Studio Installer Individual Components page. C++ Clang Compiler For Windows and C++ Clang-cl for v142 build tools are selected."::: ::: moniker-end ::: moniker range="msvc-170" For the best IDE support in Visual Studio, we recommend using the latest Clang compiler tools for Windows. If you don't already have those, you can install them by opening the Visual Studio Installer and choosing **C++ Clang compiler for Windows** under **Desktop development with C++** optional components. You may prefer to use an existing Clang installation on your machine; if so, choose the **MSBuild support for LLVM (clang-cl) toolset** component. -![Screenshot of the Visual Studio Installer Individual Components page that shows Clang components available for installation.](media/clang-install-vs2022.png) +:::image type="content" source="media/clang-install-vs2022.png" alt-text="Screenshot of the Visual Studio Installer Individual Components page. C++ Clang Compiler For Windows and MSBuild support for LLVM are selected."::: ::: moniker-end ::: moniker range=">=msvc-160" - ## Create a new configuration To add a new Clang configuration to a CMake project: @@ -47,11 +46,11 @@ To add a new Clang configuration to a CMake project: 1. Under **Configurations**, press the **Add Configuration** button: - ![Screenshot of the controls at the top of the C Make Settings dialog, with the Add Configuration control highlighted.](media/cmake-add-config-icon.png) + :::image type="content" source="media/cmake-add-config-icon.png" alt-text="Screenshot of the controls at the top of the C Make Settings dialog. The Add Configuration button is highlighted."::: 1. Choose the desired Clang configuration (note that separate Clang configurations are provided for Windows and Linux), then press **Select**: - ![Screenshot of the Add Configuration to C Make Settings dialog for Clang configuration.](media/cmake-clang-configuration.png) + :::image type="content" source="media/cmake-clang-configuration.png" alt-text="Screenshot of the Add Configuration to C Make Settings dialog for Clang configuration. Contains entries such as Mingw64-Release, x86-Debug, x64-Debug, x86-Clang Debug, and so on."::: 1. To make modifications to this configuration, use the **CMake Settings Editor**. For more information, see [Customize CMake build settings in Visual Studio](customize-cmake-settings.md). @@ -63,7 +62,7 @@ To modify an existing configuration to use Clang, follow these steps: 1. Under **General** select the **Toolset** dropdown and choose the desired Clang toolset: - ![Screenshot of the General dialog box showing that the Toolset is selected and clang cl x 86 is highlighted.](media/cmake-clang-toolset.png) + ![Screenshot of the General dialog box showing the Toolset drop-down and clang cl x 86 is highlighted.](media/cmake-clang-toolset.png) ## Custom Clang locations @@ -74,7 +73,7 @@ By default, Visual Studio looks for Clang in two places: You can specify another location by setting the **CMAKE_C_COMPILER** and **CMAKE_CXX_COMPILER** CMake variables in **CMake Settings**: -![Screenshot of the C Make Settings dialog box with the C Make C X X Compiler highlighted.](media/clang-location-cmake.png) +:::image type="content" source="media/clang-location-cmake.png" alt-text="Screenshot of the C Make Settings dialog box with the C Make C X X Compiler highlighted. C Make configurations are listed such as x64-Clang-Debug, Linux-Clang-Release, and so on." Lightbox="media/clang-location-cmake.png"::: ## Clang compatibility modes @@ -88,6 +87,6 @@ After you have set up a Clang configuration, you can build and debug the project When debugging, you can use breakpoints, memory and data visualization, and most other debugging features. Some compiler-dependent features such as Edit and Continue aren't available for Clang configurations. -![Screenshot of the Visual Studio debugger debugging a CMake Clang project.](media/clang-debug-visualize.png) +:::image type="content" source="media/clang-debug-visualize.png" alt-text="Screenshot of the Visual Studio debugger debugging a CMake Clang project."::: ::: moniker-end diff --git a/docs/build/clang-support-msbuild.md b/docs/build/clang-support-msbuild.md index 08c9adec552..8741b608e9b 100644 --- a/docs/build/clang-support-msbuild.md +++ b/docs/build/clang-support-msbuild.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: Clang/LLVM support in Visual Studio projects" title: "Clang/LLVM support in Visual Studio projects" -ms.date: 03/13/2024 +description: "Learn more about: Clang/LLVM support in Visual Studio projects" +ms.date: 12/11/2025 ms.description: "Configure a Visual Studio MSBuild project to use the Clang/LLVM toolchain." helpviewer_keywords: ["Clang support for C++ MSBuild projects"] --- @@ -49,6 +49,10 @@ The Individual components tab is selected in the installer. C++ Clang Compiler f ::: moniker range=">=msvc-160" Later versions of Visual Studio provide newer versions of the Clang toolset. The bundled version of Clang gets updated automatically to stay current with updates in the Microsoft implementation of the Standard Library. For example, Visual Studio 2019 version 16.11 includes Clang v12. +The LLVM experience in Visual Studio delivers seamless build support, project system integration, and design-time features that work with your choice of LLVM distributions. For acquisition convenience, we provide an optional LLVM binary distribution with Visual Studio. This LLVM toolset is provided as-is, sourced directly from the [LLVM Foundation’s release page](https://github.com/llvm/llvm-project/releases) without modifications by Microsoft. The installed binaries are digitally signed with a third-party Microsoft code signing certificate to mark their third-party status and to confirm that they were obtained from the LLVM Foundation’s release page. + +LLVM updates in Visual Studio are typically aligned with major LLVM releases ahead of a Visual Studio general release. However, if the community or partners report security or critical blocking issues addressed in a minor LLVM release, we prioritize updating the bundled LLVM toolset to a newer minor version containing the fix. Visual Studio’s build and project system supports using your own custom LLVM installation if needed. + ## Configure a Windows project to use Clang tools To configure a Visual Studio project to use Clang, right-click on the project node in **Solution Explorer** and choose **Properties**. Typically, you should first choose **All configurations** at the top of the dialog. Then, under **General** > **Platform Toolset**, choose **LLVM (clang-cl)** and then **OK**. @@ -57,7 +61,7 @@ To configure a Visual Studio project to use Clang, right-click on the project no The project properties page is open to the Configuration Properties > General page. The Platform Toolset dropdown is selected, on which LLVM (clang-cl) is selected. :::image-end::: -If you're using the Clang tools that are bundled with Visual Studio, no extra steps are required. For Windows projects, Visual Studio by default invokes Clang in [clang-cl](https://llvm.org/devmtg/2014-04/PDFs/Talks/clang-cl.pdf) mode. It links with the Microsoft implementation of the Standard Library. By default, **clang-cl.exe** is located in `*%VCINSTALLDIR%\Tools\Llvm\bin\*` and `*%VCINSTALLDIR%\Tools\Llvm\x64\bin\*`. +If you're using the Clang tools that are bundled with Visual Studio, no extra steps are required. For Windows projects, Visual Studio by default invokes Clang in [clang-cl](https://llvm.org/devmtg/2014-04/PDFs/Talks/clang-cl.pdf) mode. It links with the Microsoft implementation of the Standard Library. By default, **clang-cl.exe** is located in *`%VCINSTALLDIR%\Tools\Llvm\bin\`* and *`%VCINSTALLDIR%\Tools\Llvm\x64\bin\`*. If you're using a custom Clang installation, you can change the value of the `LLVMInstallDir` property. For more information, see [Set a custom LLVM location](#custom_llvm_location). @@ -111,10 +115,12 @@ When you add a `Directory.build.props` file to a project or solution, the settin ## Set properties, edit, build, and debug -After you have set up a Clang configuration, right-click again on the project node and choose **Reload project**. You can now build and debug the project using the Clang tools. Visual Studio detects that you're using the Clang compiler and provides IntelliSense, highlighting, navigation, and other editing features. Errors and warnings are displayed in the **Output Window**. The project property pages for a Clang configuration are similar to the ones for MSVC. However, some compiler-dependent features such as Edit and Continue aren't available for Clang configurations. You can set a Clang compiler or linker option that isn't available in the property pages. Add it manually in the property pages under **Configuration Properties** > **C/C++ (or Linker)** > **Command Line** > **Additional Options**. +After you set up a Clang configuration, right-click again on the project node and choose **Reload project**. You can now build and debug the project using the Clang tools. Visual Studio detects that you're using the Clang compiler and provides IntelliSense, highlighting, navigation, and other editing features. Errors and warnings are displayed in the **Output Window**. The project property pages for a Clang configuration are similar to the ones for MSVC. However, some compiler-dependent features such as Edit and Continue aren't available for Clang configurations. You can set a Clang compiler or linker option that isn't available in the property pages. Add it manually in the property pages under **Configuration Properties** > **C/C++ (or Linker)** > **Command Line** > **Additional Options**. When debugging, you can use breakpoints, memory and data visualization, and most other debugging features. :::image type="complex" source="media/clang-debug-msbuild.png" alt-text="Screenshot of Visual Studio debugging a sample app"::: -The portion of the app that is visible creates a string vector and adds some strings to it. Execution has stopped on a breakpoint for the code: v.push_back("Clang/LLVM");." +The portion of the app that's visible creates a string vector and adds some strings to it. Execution stopped on a breakpoint for the code v.push_back("Clang/LLVM");. +:::image-end::: + ::: moniker-end diff --git a/docs/build/cmake-predefined-configuration-reference.md b/docs/build/cmake-predefined-configuration-reference.md index d9597573d8d..36e2fa06ee1 100644 --- a/docs/build/cmake-predefined-configuration-reference.md +++ b/docs/build/cmake-predefined-configuration-reference.md @@ -1,6 +1,6 @@ --- -description: "Learn more about: CMake predefined build configurations" title: "CMake predefined configuration reference" +description: "Learn more about: CMake predefined build configurations" ms.description: "Visual Studio provides several predefined build configurations for CMake projects on Linux, Windows, ARM, and IoT." ms.date: 08/03/2021 helpviewer_keywords: ["CMake redefined configurations"] @@ -30,7 +30,7 @@ In a CMake project, build configurations are stored in a *`CMakeSettings.json`* When you choose a configuration, it's added to the *`CMakeSettings.json`* file in the project's root folder. You can then use it to build your project. For information about the configuration properties, see [CMakeSettings reference](cmakesettings-reference.md). -## Linux predefined build configurations: +## Linux predefined build configurations ```json { diff --git a/docs/build/cmake-presets-vs.md b/docs/build/cmake-presets-vs.md index 8aface6d9bc..5282a491801 100644 --- a/docs/build/cmake-presets-vs.md +++ b/docs/build/cmake-presets-vs.md @@ -3,6 +3,7 @@ title: Configure and build with CMake Presets description: "Reference for using CMake Presets to configure and build CMake projects." ms.date: 06/09/2023 ms.topic: reference +ms.custom: sfi-image-nochange --- # Configure and build with CMake Presets in Visual Studio @@ -19,7 +20,7 @@ This article contains information about *`CMakePresets.json`* integration with V We recommend *`CMakePresets.json`* as an alternative to *`CMakeSettings.json`*. Visual Studio never reads from both *`CMakePresets.json`* and *`CMakeSettings.json`* at the same time. To enable or disable *`CMakePresets.json`* integration in Visual Studio, see [Enable `CMakePresets.json` in Visual Studio 2019](#enable-cmakepresets-json-integration). -## Supported CMake and *`CMakePresets.json`* versions +## Supported CMake and *`CMakePresets.json`* versions The supported *`CMakePresets.json`* and *`CMakeUserPresets.json`* schema versions depend on your version of Visual Studio: - Visual Studio 2019 version 16.10 and later support schema versions 2 and 3. @@ -204,29 +205,33 @@ The official [CMake documentation](https://cmake.org/cmake/help/latest/manual/cm ### Select your compilers -You can set C and C++ compilers by using `cacheVariables.CMAKE_C_COMPILER` and `cacheVariables.CMAKE_CXX_COMPILER` in a Configure Preset. It's equivalent to passing `-D CMAKE_C_COMPILER=` and `-D CMAKE_CXX_COMPILER=` to CMake from the command line. For more information, see [`CMAKE__COMPILER`](https://cmake.org/cmake/help/latest/variable/CMAKE_LANG_COMPILER.html#cmake-lang-compiler). +You can set C and C++ compilers by using `environment.CC` and `environment.CXX` in a Configure Preset. For more information, see [`CC`](https://cmake.org/cmake/help/latest/envvar/CC.html)/[`CXX`](https://cmake.org/cmake/help/latest/envvar/CXX.html). Use the following examples to build with `cl.exe` and `clang-cl.exe` from Visual Studio. The C++ Clang tools for Windows components must be installed for you to build with `clang-cl`. Build with `cl.exe`: ```json +"environment": { + "CC": "cl", + "CXX": "cl" +}, "cacheVariables": { "CMAKE_BUILD_TYPE": "Debug", - "CMAKE_INSTALL_PREFIX": "${sourceDir}/out/install/${presetName}", - "CMAKE_C_COMPILER": "cl", - "CMAKE_CXX_COMPILER": "cl" + "CMAKE_INSTALL_PREFIX": "${sourceDir}/out/install/${presetName}" }, ``` Build with `clang`: ```json +"environment": { + "CC": "clang-cl", + "CXX": "clang-cl" +}, "cacheVariables": { "CMAKE_BUILD_TYPE": "Debug", "CMAKE_INSTALL_PREFIX": "${sourceDir}/out/install/${presetName}", - "CMAKE_C_COMPILER": "clang-cl", - "CMAKE_CXX_COMPILER": "clang-cl" }, "vendor": { @@ -260,14 +265,16 @@ For more information on generators that support the `toolset` specification, see To reproduce these builds outside Visual Studio, see [Run CMake from the command line or a CI pipeline](#run-cmake-from-the-command-line-or-a-ci-pipeline). -To build on Linux or without the Visual C++ toolset, specify the name of a compiler on your `PATH` instance, or an environment variable that evaluates to the full path of a compiler. Full paths are discouraged so that the file can remain shareable. A preset that builds with GCC version 8 might look like this: +To build on Linux or without the Microsoft C++ (MSVC) Build Tools, specify the name of a compiler on your `PATH` instance, or an environment variable that evaluates to the full path of a compiler. Full paths are discouraged so that the file can remain shareable. A preset that builds with GCC version 8 might look like this: ```json +"environment": { + "CC": "gcc-8", + "CXX": "g++-8" +}, "cacheVariables": { "CMAKE_BUILD_TYPE": "Debug", - "CMAKE_INSTALL_PREFIX": "${sourceDir}/out/install/${presetName}", - "CMAKE_C_COMPILER": "gcc-8", - "CMAKE_CXX_COMPILER": "g++-8" + "CMAKE_INSTALL_PREFIX": "${sourceDir}/out/install/${presetName}" }, ``` @@ -283,7 +290,7 @@ Set `architecture.strategy` and `toolset.strategy` to `set` when you're building You can set the configuration type (`Debug` or `Release`) for single configuration generators by using `cacheVariables.CMAKE_BUILD_TYPE`. It's equivalent to passing `-D CMAKE_BUILD_TYPE=` to CMake from the command line. For more information, see [`CMAKE_BUILD_TYPE`](https://cmake.org/cmake/help/latest/variable/CMAKE_BUILD_TYPE.html). -### Select your target and host architecture when building with the Visual C++ toolset +### Select your target and host architecture when building with the Microsoft C++ Build Tools You can set the target architecture (x64, Win32, ARM64, or ARM) by using `architecture.value`. It's equivalent to passing `-A` to CMake from the command line. For more information, see [Platform Selection](https://cmake.org/cmake/help/latest/generator/Visual%20Studio%2016%202019.html#platform-selection). @@ -391,7 +398,7 @@ Instead, set the path to `vcpkg.cmake` by using the `VCPKG_ROOT` environment var If you're already using a CMake toolchain file and want to enable vcpkg integration, see [Using multiple toolchain files](/vcpkg/users/buildsystems/cmake-integration#using-multiple-toolchain-files). Follow those instructions to use an external toolchain file with a project by using vcpkg. -## Variable substitution in *`launch.vs.json`* and *`tasks.vs.json`* +## Variable substitution in *`launch.vs.json`* and *`tasks.vs.json`* *`CMakePresets.json`* supports variable substitution in *`launch.vs.json`* and *`tasks.vs.json`*. Here are some considerations: @@ -436,7 +443,7 @@ Instead, enable and disable AddressSanitizer by setting the required compiler an You can add the following sample to *`CMakeLists.txt`* to enable or disable AddressSanitizer for a target: -```cmd +```txt option(ASAN_ENABLED "Build this target with AddressSanitizer" ON) if(ASAN_ENABLED) @@ -459,7 +466,7 @@ You can use the same *`CMakePresets.json`* and *`CMakeUserPresets.json`* files t ### Sourcing the environment when building with command-line generators on Windows -It's up to the user to configure the environment before CMake is invoked in building with a command-line generator. If you're building with Ninja and the Visual C++ toolset on Windows, set the environment before CMake is called to generate the build system. You can do it by calling *`vcvarsall.bat`* with the `architecture` argument. The `architecture` argument specifies the host and target architecture to use. For more information, see [`vcvarsall` syntax](./building-on-the-command-line.md#vcvarsall-syntax). If you build on Linux or on Windows with a Visual Studio Generator, you don't need to take this step. +It's up to the user to configure the environment before CMake is invoked in building with a command-line generator. If you're building with Ninja and the Microsoft C++ Build Tools on Windows, set the environment before CMake is called to generate the build system. You can do it by calling *`vcvarsall.bat`* with the `architecture` argument. The `architecture` argument specifies the host and target architecture to use. For more information, see [`vcvarsall` syntax](./building-on-the-command-line.md#vcvarsall-syntax). If you build on Linux or on Windows with a Visual Studio Generator, you don't need to take this step. It's the same step that Visual Studio takes for you when the IDE invokes CMake. Visual Studio parses the active Configure Preset for the host and target architecture specified by `toolset` and `architecture`. Visual Studio then sources the specified environment from *`vcvarsall.bat`*. When you build from the Windows command line with Ninja, you'll need to take this step yourself. @@ -478,7 +485,7 @@ cmake --build --preset ## Example *`CMakePresets.json`* file -The *`CMakePresets.json`* file in [box2d-lite](https://github.com/esweet431/box2d-lite/blob/vs-launch/CMakePresets.json) contains examples of Configure Presets, Build Presets, and Test Presets. For more information about this example, see the presentation [An Introduction to CMakePresets.json](/events/cpp-pure-virtual-cpp-2021/an-introduction-to-cmakepresetsjson). You can see another example in the [DirectXTK](https://github.com/microsoft/DirectXTK/blob/main/CMakePresets.json) project, which shows many build targets in its `configurePresets` section. +The *`CMakePresets.json`* file in [box2d-lite](https://github.com/esweet431/box2d-lite/blob/vs-launch/CMakePresets.json) contains examples of Configure Presets, Build Presets, and Test Presets. For more information about this example, see the presentation [An Introduction to CMakePresets.json](/shows/cpp-pure-virtual-cpp-2021/an-introduction-to-cmakepresetsjson). You can see another example in the [DirectXTK](https://github.com/microsoft/DirectXTK/blob/main/CMakePresets.json) project, which shows many build targets in its `configurePresets` section. ## Next steps diff --git a/docs/build/cmake-projects-in-visual-studio.md b/docs/build/cmake-projects-in-visual-studio.md index 40b56f6bb8f..5dcd6b75af3 100644 --- a/docs/build/cmake-projects-in-visual-studio.md +++ b/docs/build/cmake-projects-in-visual-studio.md @@ -1,25 +1,28 @@ --- title: "CMake projects in Visual Studio" -description: "How to create and build C++ projects using CMake in Visual Studio." -ms.date: 02/14/2022 -f1_keywords: ["VS.ToolsOptionsPages.CMake.General", "VS.ToolsOptionsPages.CMake.LanguageServices"] +description: "Learn how to create and build C++ projects using CMake in Visual Studio." +ms.date: 03/18/2025 +ms.topic: concept-article +f1_keywords: ["VS.ToolsOptionsPages.CMake.General", "VS.ToolsOptionsPages.CMake.LanguageServices"] +ms.custom: sfi-image-nochange --- + # CMake projects in Visual Studio [CMake](https://cmake.org) is a cross-platform, open-source tool for defining build processes that run on multiple platforms. This article assumes you're familiar with CMake. For more information about CMake, see the [CMake documentation](https://cmake.org/cmake/help/latest/index.html#). The [CMake tutorial](https://cmake.org/cmake/help/latest/guide/tutorial/index.html#guide:CMake%20Tutorial) is a good starting point to learn more. > [!NOTE] -> CMake has become more and more integrated with Visual Studio over the past few releases. To see the documentation for your preferred version of Visual Studio, use the **Version** selector control. It's found at the top of the table of contents on this page. +> CMake has become more and more integrated with Visual Studio over the past few releases. To see the documentation for your preferred version of Visual Studio, use the **Version** selector located at the top of the table of contents on this page. ::: moniker range=">=msvc-160" -Visual Studio's native support for CMake enables you to edit, build, and debug CMake projects on Windows, the Windows Subsystem for Linux (WSL), and remote systems from the same instance of Visual Studio. CMake project files (such as *`CMakeLists.txt`*) are consumed directly by Visual Studio for the purposes of IntelliSense and browsing. `cmake.exe` is invoked directly by Visual Studio for CMake configuration and build. +Visual Studio's native support for CMake allows you to edit, build, and debug CMake projects on Windows, the Windows Subsystem for Linux (WSL), and remote systems from the same instance of Visual Studio. CMake project files (such as *`CMakeLists.txt`*) are consumed directly by Visual Studio for the purposes of IntelliSense and browsing. Visual Studio invokes `cmake.exe` directly for CMake configuration and build. ## Installation **C++ CMake tools for Windows** is installed as part of the **Desktop development with C++** and **Linux Development with C++** workloads. Both **C++ CMake tools for Windows** and **Linux Development with C++** are required for cross-platform CMake development. -:::image type="complex" source="media/cmake-install-2019.png" alt-text="Screenshot of the Visual Studio installer."::: +:::image type="complex" source="media/cmake-install-2022.png" alt-text="Screenshot of the Visual Studio installer."::: In the installer, the Desktop development with C plus plus dropdown is selected and C plus plus C Make tools for Windows is selected." :::image-end::: @@ -42,12 +45,16 @@ The dialog offers these options: clone a repository, open a project or solution, - In the background, Visual Studio starts to index the source files to enable IntelliSense, browsing information, refactoring, and so on. As you work, Visual Studio monitors changes in the editor and also on disk to keep its index in sync with the sources. > [!NOTE] -> Starting in Visual Studio 2022 version 17.1 Preview 2, if your top-level `CMakeLists.txt` exists in a subfolder and not at the root of the workspace, you'll be prompted whether you'd like to enable CMake integration or not. For more information, see [CMake partial activation](#cmake-partial-activation). +> Starting in Visual Studio 2022 version 17.1 Preview 2, if your top-level *`CMakeLists.txt`* exists in a subfolder and not at the root of the workspace, you're prompted whether you'd like to enable CMake integration or not. For more information, see [CMake partial activation](#cmake-partial-activation). Once CMake cache generation has succeeded, you can also view your projects organized logically by targets. Choose the **Select View** button on the **Solution Explorer** toolbar. From the list in **Solution Explorer - Views**, select **CMake Targets View** and press **Enter** to open the targets view: :::image type="content" source="media/cmake-targets-view2.png" alt-text="Screenshot of the Solution Explorer Views window. The folder view is open. The C Make Targets View option is highlighted."::: +You can also switch views by right-clicking on any file or folder in your Solution Explorer and selecting **Switch to CMake Targets View**. + +![A screenshot of right-clicking a file or folder in the Solution explorer. The context menu item to Switch to CMake Targets View is visible.](media/visual-studio-switch-cmake-targets-view.png) + Choose the **Show All Files** button at the top of **Solution Explorer** to see all the CMake-generated output in the *`out/build/`* folders. Use the *`CMakeLists.txt`* file in each project folder just as you would in any CMake project. You can specify source files, find libraries, set compiler and linker options, and specify other build system-related information. For more information on CMake language services provided by Visual Studio, see [Editing CMakeLists.txt files](#editing-cmakeliststxt-files). @@ -64,18 +71,18 @@ Most Visual Studio and C++ language features are supported by CMake projects in - [Clang/LLVM support](https://devblogs.microsoft.com/cppblog/clang-llvm-support-in-visual-studio/) > [!NOTE] -> For other kinds of Open Folder projects, an additional JSON file *`CppProperties.json`* is used. This file is not relevant for CMake projects. +> For other kinds of Open Folder projects, an additional JSON file *`CppProperties.json`* is used. This file isn't relevant for CMake projects. ## Configuring CMake projects -The CMake configure step generates the project build system. It's equivalent to invoking `cmake.exe` from the command line. For more information on the CMake configure step, see the [CMake documentation](https://cmake.org/cmake/help/latest/manual/cmake.1.html#generate-a-project-buildsystem). +The CMake configure step generates the project build system. It's equivalent to invoking *`cmake.exe`* from the command line. For more information on the CMake configure step, see the [CMake documentation](https://cmake.org/cmake/help/latest/manual/cmake.1.html#generate-a-project-buildsystem). -Visual Studio uses a CMake configuration file to drive CMake generation and build. *`CMakePresets.json`* is supported by Visual Studio 2019 version 16.10 or later and is the recommended CMake configuration file. *`CMakePresets.json`* is supported directly by CMake and can be used to drive CMake generation and build from Visual Studio, from VS Code, in a Continuous Integration pipeline, and from the command line on Windows, Linux, and Mac. For more information on *`CMakePresets.json`*, see [Configure and build with CMake Presets](cmake-presets-vs.md). *`CMakeSettings.json`* is available for customers using an earlier version of Visual Studio. For more information on *`CMakeSettings.json`*, see [Customize CMake build settings](customize-cmake-settings.md). +Visual Studio uses a CMake configuration file to drive CMake generation and build. *`CMakePresets.json`* is supported by Visual Studio 2019 version 16.10 or later and is the recommended CMake configuration file. *`CMakePresets.json`* is supported directly by CMake and can be used to drive CMake generation and build from Visual Studio, from VS Code, in a continuous integration pipeline, and from the command line on Windows, Linux, and Mac. For more information on *`CMakePresets.json`*, see [Configure and build with CMake Presets](cmake-presets-vs.md). *`CMakeSettings.json`* is available for customers using an earlier version of Visual Studio. For more information on *`CMakeSettings.json`*, see [Customize CMake build settings](customize-cmake-settings.md). -When you make significant changes to your CMake configuration file or a *`CMakeLists.txt`* file, Visual Studio will automatically run the CMake configure step. You can invoke the configure step manually: Select **Project > Configure Cache** from the toolbar. You can also change your configuration preferences in **Tools** > **Options** > **CMake** > **General**. +When you make significant changes to your CMake configuration file or a *`CMakeLists.txt`* file, Visual Studio automatically runs the CMake configure step. You can invoke the configure step manually: Select **Project > Configure Cache** from the toolbar. You can also change your configuration preferences in **Tools** > **Options** > **CMake** > **General**. -:::image type="complex" source="media/cmake-configure-options.png" alt-text="Screenshot of the CMake configuration options in the Visual Studio settings window."::: -The CMake configure settings are called out. Show C Make cache notifications is selected. Under 'When cache is out of date:', the option 'Never run configure step automatically' is selected. +:::image type="complex" source="media/cmake-configure-options.png" alt-text="Screenshot of the C Make configuration options in the Visual Studio settings window."::: +The C Make configure settings are called out. Show C Make cache notifications is selected. Under 'When cache is out of date', the option 'Never run configure step automatically' is selected. :::image-end::: If the configure step finishes without errors, then the information that's available drives C++ IntelliSense and language services. It's also used in build and debug operations. @@ -88,6 +95,12 @@ By default, most configuration messages are suppressed unless there's an error. You can also disable all CMake cache notifications (gold bars) by deselecting **Show CMake cache notification**. +### Customize Targets View source groups + +By default, the CMake Targets View ignores the following source groups: *Source Files*, *Header Files*, *Resources*, *Object Files*. These groups are included by default in most CMake projects and would unnecessarily increase the number of clicks required to navigate the Targets View. + +You can enable the use of these source groups by selecting **Tools** > **Options** > **CMake** > **Enable the use of ignored source groups in CMake Targets View**. + ### Troubleshooting CMake cache errors If you need more information about the state of the CMake cache to diagnose a problem, open the **Project** main menu or the *`CMakeLists.txt`* context menu in **Solution Explorer** to run one of these commands: @@ -112,8 +125,8 @@ To build a CMake project, you have these choices: As you would expect, build results are shown in the **Output Window** and **Error List**. -:::image type="content" source="media/cmake-build-errors.png" alt-text="Screenshot of the Visual Studio Error List window"::: -CMake build warnings about conversions that may result in data loss such as converting from a float to an integer, are visible. +:::image type="complex" source="media/cmake-build-errors.png" alt-text="Screenshot of the Visual Studio Error List window"::: +C Make build warnings about conversions that might result in data loss such as converting from a float to an integer, are visible. :::image-end::: ### Edit build settings @@ -122,7 +135,7 @@ Visual Studio uses a CMake configuration file to drive CMake builds. CMake confi ## Debugging CMake projects -All executable CMake targets are shown in the **Startup Item** dropdown in the toolbar. To start debugging, select one and press the **Debug > Start Debugging** button in the toolbar. In a CMake project, the "Current document" option is only valid for .cpp files. +All executable CMake targets are shown in the **Startup Item** dropdown in the toolbar. To start debugging, select one and press the **Debug > Start Debugging** button in the toolbar. In a CMake project, the **Current document** option is only valid for .cpp files. :::image type="complex" source="media/debug-target.png" alt-text="Screenshot of the Visual Studio debug dropdown."::: The dropdown has these options: Show / Hide debug targets, current document, samples (which is highlighted), box2d_tests, and samples-noGUI. @@ -130,23 +143,25 @@ The dropdown has these options: Show / Hide debug targets, current document, sam The **Debug** or **F5** commands first build the project if changes have been made since the previous build. Changes to the CMake configuration file (*`CMakePresets.json`* or *`CMakeSettings.json`*) or a *`CMakeLists.txt`* causes the CMake cache to be regenerated. -You can customize a CMake debugging session by setting properties in the *`launch.vs.json`* file. To customize debug settings for a specific target, select the target in the **Startup Item** dropdown and press **Debug > Debug and Launch Settings for \**. For more information on CMake debugging sessions, see [Configure CMake debugging sessions](configure-cmake-debugging-sessions.md). +You can customize a CMake debugging session by setting properties in the *`launch.vs.json`* file. To customize debug settings for a specific target, select the target in the **Startup Item** dropdown and choose **Debug > Debug and Launch Settings for \**. For more information on CMake debugging sessions, see [Configure CMake debugging sessions](configure-cmake-debugging-sessions.md). ### Just My Code for CMake projects -When you build for Windows using the MSVC compiler, CMake projects have support for Just My Code debugging. To change the Just My Code setting, go to **Tools** > **Options** > **Debugging** > **General**. For more information on Just My Code debugging, see [Debug only user code with Just My Code](/visualstudio/debugger/just-my-code). +When you build for Windows using the Microsoft C++ (MSVC) compiler, CMake projects have support for Just My Code debugging. To change the Just My Code setting, go to **Tools** > **Options** > **Debugging** > **General**. For more information on Just My Code debugging, see [Debug only user code with Just My Code](/visualstudio/debugger/just-my-code). ### Edit and Continue for CMake projects -When you build for Windows with the MSVC compiler, CMake projects have support for Edit and Continue. Add the following code to your *`CMakeLists.txt`* file to enable Edit and Continue. For more information on Edit and Continue, see [Configure Edit and Continue (C#, VB, C++)](/visualstudio/debugger/how-to-enable-and-disable-edit-and-continue). +When you build for Windows with the MSVC compiler, CMake projects have support for Edit and Continue. Add the following code to your *`CMakeLists.txt`* file to enable Edit and Continue. -``` +```txt if(MSVC) target_compile_options( PUBLIC "/ZI") target_link_options( PUBLIC "/INCREMENTAL") endif() ``` +For more information on Edit and Continue, see [Configure Edit and Continue (C#, VB, C++)](/visualstudio/debugger/how-to-enable-and-disable-edit-and-continue). + ### Attach to a CMake project running on Linux Visual Studio allows you to debug a process running on a remote Linux system or WSL and debug it with the GDB debugger. To get started, select **Debug** > **Attach to Process...**, set the **Connection type** to **SSH**, and select your **Connection target** from the list of connections in the Connection Manager. Select a process from the list of available processes and press **Attach**. GDB must be installed on your Linux machine. For more information on SSH connections, see the [Connection Manager](../linux/connect-to-your-remote-linux-computer.md) @@ -157,16 +172,16 @@ The following options are available on the dialog: Connection type (set to SSH), ## CMake partial activation -In Visual Studio 2022 version 17.1 and later, CMake functionality won't be enabled automatically if your root folder doesn't contain a `CMakeLists.txt` file. Instead, a dialog will prompt you on whether you'd like to enable CMake functionality for your project. If you decline, CMake cache generation won't start and CMake configurations (from `CMakeSettings.json` or `CMakePresets.json`) won't appear in the configuration dropdown. If you accept, you'll be taken to a workspace-level configuration file, `CMakeWorkspaceSettings.json` (stored in the `.vs` directory), to specify the folders you'd like to enable CMake for. (These folders contain your root `CMakeLists.txt` files). +In Visual Studio 2022 version 17.1 and later, CMake functionality isn't enabled automatically if your root folder doesn't contain a *`CMakeLists.txt`* file. Instead, a dialog prompts you on whether you'd like to enable CMake functionality for your project. If you decline, CMake cache generation doesn't start and CMake configurations (from *`CMakeSettings.json`* or *`CMakePresets.json`*) doesn't appear in the configuration dropdown. If you accept, you're taken to a workspace-level configuration file, *`CMakeWorkspaceSettings.json`* (stored in the *`.vs`* directory), to specify the folders you'd like to enable CMake for. (These folders contain your root *`CMakeLists.txt`* files). The accepted properties are: | Property | Description | |--|--| | `enableCMake` | Enable Visual Studio's integration for this workspace. | -| `sourceDirectory` | A string or array of strings specifying the directory or directories with `CMakeLists.txt`. Macros (such as `${workspaceRoot}`) are allowed. Relative paths are based on the workspace root. Directories outside of the current workspace will be ignored. | +| `sourceDirectory` | A string or array of strings specifying the directory or directories with *`CMakeLists.txt`*. Macros (such as `${workspaceRoot}`) are allowed. Relative paths are based on the workspace root. Directories outside of the current workspace are ignored. | -You can reach `CMakeWorkspaceSettings.json` through the **Project** > **CMake Workspace Settings** menu command at any time, even if CMake functionality is currently disabled. +You can reach *`CMakeWorkspaceSettings.json`* through the **Project** > **CMake Workspace Settings** menu command at any time, even if CMake functionality is currently disabled. ## Open an existing cache @@ -197,7 +212,7 @@ When your custom or preferred tools generate your cache, CMake places files unde To edit a *`CMakeLists.txt`* file, right-click on the file in **Solution Explorer** and choose **Open**. If you make changes to the file, a yellow status bar appears and informs you that IntelliSense will update. It gives you a chance to cancel the update operation. For information about *`CMakeLists.txt`*, see the [CMake documentation](https://cmake.org/documentation/). -:::image type="complex" source="media/cmake-cmakelists.png" alt-text="Screenshot of a C Make Lists .txt file being edited in Visual Studio." +:::image type="complex" source="media/cmake-cmakelists.png" alt-text="Screenshot of a C Make Lists TXT file being edited in Visual Studio." It contains the lines project (hello-cmake), add_subdirectory (tests), add_executable (hello hello.cpp), and install (TARGETS hello DESTINATION hello/bin). A message at the top of the window says that c plus plus IntelliSense info will refresh after C Make finishes generating the cache. :::image-end::: @@ -209,7 +224,7 @@ A C Make error message on line 3 of CMakeLists.txt is highlighted. The details a ### Language services for CMake -Language services for CMake are available in Visual Studio 2019 version 16.5 or later. It supports code navigation features like Go To Definition, Peek Definition, and Find All References for CMake variables, functions, and targets in CMake script files. For more information, see [Code Navigation for CMake Scripts](https://devblogs.microsoft.com/cppblog/code-navigation-for-cmake-scripts/). +Language services for CMake are available in Visual Studio 2019 version 16.5 or later. Language services support code navigation features like *Go To Definition*, *Peek Definition*, and *Find All References* for CMake variables, functions, and targets in CMake script files. For more information, see [Code Navigation for CMake Scripts](https://devblogs.microsoft.com/cppblog/code-navigation-for-cmake-scripts/). :::image type="complex" source="media/cmake-find-all-refs.png" alt-text="Screenshot of the Visual Studio Find All References window."::: Results of where SUPERTUX_SOURCES_CXX are found are shown. For example, in list(SORT SSUPERTUX_SOURCES_CXX), file(GLOB SUPERTUX_SOURCES_CXX) and so on. @@ -217,10 +232,10 @@ Results of where SUPERTUX_SOURCES_CXX are found are shown. For example, in list( ### CMake project manipulation -CMake project manipulation is available in Visual Studio 2019 version 16.5 or later. Project manipulation enables you to add, remove, and rename source files and targets in your CMake project without manually editing your CMake scripts. When you add or remove files from the Solution Explorer, Visual Studio automatically edits your CMake project. There could be more than one place where it makes sense to add or remove a reference to a CMake script. If so, Visual Studio asks you where you want to make the change and displays a preview of the proposed changes. For step-by-step instructions, see [Add, Remove, and Rename Files and Targets in CMake Projects](https://devblogs.microsoft.com/cppblog/easily-add-remove-and-rename-files-and-targets-in-cmake-projects/). +CMake project manipulation is available in Visual Studio 2019 version 16.5 or later. Project manipulation lets you add, remove, and rename source files and targets in your CMake project without manually editing your CMake scripts. When you add or remove files from the Solution Explorer, Visual Studio automatically edits your CMake project. There could be more than one place where it makes sense to add or remove a reference to a CMake script. If so, Visual Studio asks you where you want to make the change and displays a preview of the proposed changes. For step-by-step instructions, see [Add, Remove, and Rename Files and Targets in CMake Projects](https://devblogs.microsoft.com/cppblog/easily-add-remove-and-rename-files-and-targets-in-cmake-projects/). :::image type="complex" source="media/cmake-project-manipulation.png" alt-text="Screenshot of the Visual Studio Preview Changes dialog box."::: -A tree view shows CMakeLists.txt, under which are two items: add_executable and set. Set is checked. The preview window shows where changes will be made. The line set (PROJECT_SRC "CmakeProject4.cpp" "CMakeProject4.h" shows "Demo.cpp" highlighted before the closing parenthesis. The apply button accepts the change, or you can press cancel. +A tree view shows CMakeLists.txt, under which are two items: add_executable and set. Set is checked. The preview window shows where changes will be made. The line set PROJECT_SRC "CmakeProject4.cpp" "CMakeProject4.h" shows "Demo.cpp" highlighted before the closing parenthesis. The apply button accepts the change, or you can press cancel. :::image-end::: ## IntelliSense for CMake projects @@ -244,15 +259,15 @@ CMake projects opened in Visual Studio integrate with vcpkg, a cross-platform C/ If *`CMakeSettings.json`* is your active configuration file, Visual Studio automatically passes the vcpkg toolchain file (`vcpkg.cmake`) to CMake. This behavior is disabled automatically when you specify any other toolchain in your CMake Settings configuration. -If *`CMakePresets.json`* is your active configuration file, you'll need to set the path to `vcpkg.cmake` in *`CMakePresets.json`*. We recommend using the `VCPKG_ROOT` environment variable instead of an absolute path to keep the file shareable. For more information, see [Enable vcpkg integration with CMake Presets](cmake-presets-vs.md#enable-vcpkg-integration). *`CMakePresets.json`* is available in Visual Studio 2019 version 16.10 or later and is the recommended CMake configuration file. +If *`CMakePresets.json`* is your active configuration file, you need to set the path to `vcpkg.cmake` in *`CMakePresets.json`*. We recommend using the `VCPKG_ROOT` environment variable instead of an absolute path to keep the file shareable. For more information, see [Enable vcpkg integration with CMake Presets](cmake-presets-vs.md#enable-vcpkg-integration). *`CMakePresets.json`* is available in Visual Studio 2019 version 16.10 or later and is the recommended CMake configuration file. ## Run CMake from the command line If *`CMakePresets.json`* is your active CMake configuration file, then you can easily reproduce your local builds outside of Visual Studio. For more information, see [Run CMake from the command line or a CI pipeline](cmake-presets-vs.md#run-cmake-from-the-command-line-or-a-ci-pipeline). *`CMakePresets.json`* is supported in Visual Studio 2019 version 16.10 or later and is the recommended CMake configuration file. -If *`CMakeSettings.json`* is your active CMake configuration file, then you'll need to manually pass the arguments that are encoded in your *`CMakeSettings.json`* file to CMake. If you have installed CMake from the Visual Studio Installer, you can run it from the command line by following these steps: +If *`CMakeSettings.json`* is your active CMake configuration file, then you need to manually pass the arguments that are encoded in your *`CMakeSettings.json`* file to CMake. If you installed CMake from the Visual Studio Installer, you can run it from the command line by following these steps: -1. Run the appropriate *`vsdevcmd.bat`* file (x86/x64). For more information, see [Building on the command line](building-on-the-command-line.md) . +1. Run the appropriate *`vsdevcmd.bat`* file (x86/x64). For more information, see [Use the Microsoft C++ toolset from the command line](building-on-the-command-line.md) . 1. Switch to your output folder. @@ -268,7 +283,7 @@ Visual Studio 2017 has rich support for CMake, including [cross-platform CMake p **Visual C++ Tools for CMake** is installed as part of the **Desktop development with C++** and **Linux Development with C++** workloads. -:::image type="content" source="media/cmake-install.png" alt-text="Screenshot of the Visual Studio Installer. The Individual components tab is selected on which Visual C plus plus tools for CMake is selected."::: +:::image type="content" source="media/cmake-install.png" alt-text="Screenshot of the Visual Studio Installer. The Individual components tab is selected on which Visual C plus plus tools for C Make is selected."::: For more information, see [Install the C++ Linux workload in Visual Studio](../linux/download-install-and-setup-the-linux-development-workload.md). @@ -284,17 +299,17 @@ When you choose **File > Open > Folder** to open a folder containing a *`CMakeLi - In the background, Visual Studio starts to index the source files to enable IntelliSense, browsing information, refactoring, and so on. As you work, Visual Studio monitors changes in the editor and also on disk to keep its index in sync with the sources. -You can open folders containing any number of CMake projects. Visual Studio detects and configures all the "root" *`CMakeLists.txt`* files in your workspace. CMake operations (configure, build, debug), C++ IntelliSense, and browsing are available to all CMake projects in your workspace. +You can open folders containing any number of CMake projects. Visual Studio detects and configures all the top-level *`CMakeLists.txt`* files in your workspace. CMake operations (configure, build, debug), C++ IntelliSense, and browsing are available to all CMake projects in your workspace. :::image type="complex" source="media/cmake-multiple-roots.png" alt-text="Screenshot of the Visual Studio Solution Explorer."::: -The files and folders of a CMake project are visible. There's a tests subdirectory, CMakeLists.txt, and hello.cpp. There's a hello-cmake-vcpkg folder that contains CMakeLists.txt, CMakeSettings.json, and hello.cpp. +The files and folders of a C Make project are visible. There's a tests subdirectory, CMakeLists.txt, and hello.cpp. There's a hello-cmake-vcpkg folder that contains CMakeLists.txt, CMakeSettings.json, and hello.cpp. :::image-end::: You can also view your projects organized logically by targets. Choose **Targets view** from the dropdown in the **Solution Explorer** toolbar: :::image type="content" source="media/cmake-targets-view.png" alt-text="Screenshot of the dropdown button in the Visual Studio Solution Explorer that offers the CMake targets view option. Which is selected."::: -Visual Studio uses a file called *`CMakeSettings.json`* to store environment variables or command-line options for CMake. *`CMakeSettings.json`* also enables you to define and store multiple CMake build configurations. You can conveniently switch between them in the IDE. +Visual Studio uses a file called *`CMakeSettings.json`* to store environment variables or command-line options for CMake. *`CMakeSettings.json`* also lets you define and store multiple CMake build configurations. You can conveniently switch between them in the IDE. Otherwise, use the *`CMakeLists.txt`* just as you would in any CMake project to specify source files, find libraries, set compiler and linker options, and specify other build system-related information. @@ -305,7 +320,7 @@ If you need to pass arguments to an executable at debug time, you can use anothe ## Import an existing cache -When you import an existing *`CMakeCache.txt`* file, Visual Studio automatically extracts customized variables and creates a pre-populated *`CMakeSettings.json`* file based on them. The original cache isn't modified in any way. It can still be used from the command line, or with whatever tool or IDE used to generate it. The new *`CMakeSettings.json`* file is placed alongside the project's root *`CMakeLists.txt`*. Visual Studio generates a new cache based the settings file. You can override automatic cache generation in the **Tools > Options > CMake > General** dialog. +When you import an existing *`CMakeCache.txt`* file, Visual Studio automatically extracts customized variables and creates a prepopulated *`CMakeSettings.json`* file based on them. The original cache isn't modified in any way. It can still be used from the command line, or with whatever tool or IDE used to generate it. The new *`CMakeSettings.json`* file is placed alongside the project's root *`CMakeLists.txt`*. Visual Studio generates a new cache based the settings file. You can override automatic cache generation in the **Tools > Options > CMake > General** dialog. Not everything in the cache is imported. Properties such as the generator and the location of the compilers are replaced with defaults that are known to work well with the IDE. @@ -313,13 +328,13 @@ Not everything in the cache is imported. Properties such as the generator and th 1. From the main menu, choose **File > Open > CMake**: - :::image type="content" source="media/cmake-file-open.png" alt-text="Screenshot of the Visual Studio main menu. File > Open > C Make is selected."::: + :::image type="content" source="media/cmake-file-open.png" alt-text="Screenshot of the Visual Studio main menu with C Make selected."::: This command brings up the **Import CMake from Cache** wizard. 2. Navigate to the *`CMakeCache.txt`* file that you want to import, and then choose **OK**. The **Import CMake Project from Cache** wizard appears: - :::image type="content" source="media/cmake-import-wizard.png" alt-text="Screenshot of the Import CMake Project from Cache wizard. The directory path of the CMake project to import goes in the `folder` textbox."::: + :::image type="content" source="media/cmake-import-wizard.png" alt-text="Screenshot of the Import C Make Project from Cache wizard. The directory path of the C Make project to import goes in the folder textbox."::: When the wizard completes, you can see the new *`CMakeCache.txt`* file in **Solution Explorer** next to the root *`CMakeLists.txt`* file in your project. @@ -327,31 +342,31 @@ Not everything in the cache is imported. Properties such as the generator and th To build a CMake project, you have these choices: -1. In the General toolbar, find the **Configurations** dropdown. It's probably showing "Linux-Debug" or "x64-Debug" by default. Select the preferred configuration and press **F5**, or choose the **Run** (green triangle) button on the toolbar. The project automatically builds first, just like a Visual Studio solution. +1. In the General toolbar, find the **Configurations** dropdown. It's probably showing **Linux-Debug** or **x64-Debug** by default. Select the preferred configuration and press **F5**, or choose the **Run** (green triangle) button on the toolbar. The project automatically builds first, just like a Visual Studio solution. 1. Right-click on *`CMakeLists.txt`* in **Solution Explorer** and select **Build** from the context menu. If you have multiple targets in your folder structure, you can choose to build all or only one specific target. 1. From the main menu, select **Build > Build Solution** (**F7** or **Ctrl+Shift+B**). Make sure that a CMake target is already selected in the **Startup Item** dropdown in the **General** toolbar. -:::image type="complex" source="media/cmake-build-menu.png" alt-text="Screenshot of the Visual Studio Solution Explorer after right-clicking CMakeLists.txt."::: +:::image type="complex" source="media/cmake-build-menu.png" alt-text="Screenshot of the Visual Studio Solution Explorer after right-clicking C Make Lists dot t x t."::: The menu has options such as Add, Open, Configure tasks, Build, Clean all, and so on. :::image-end::: -You can customize build configurations, environment variables, command-line arguments, and other settings in the *`CMakeSettings.json`* file. It lets you make changes without modifying the *`CMakeLists.txt`* file. For more information, see [Customize CMake settings](customize-cmake-settings.md). +You can customize build configurations, environment variables, command-line arguments, and other settings in the *`CMakeSettings.json`* file. It lets you make changes without modifying the *`CMakeLists.txt`* file. For more information, see [Customize CMake build settings](customize-cmake-settings.md). As you would expect, build results are shown in the **Output Window** and **Error List**. :::image type="complex" source="media/cmake-build-errors.png" alt-text="Screenshot of the Visual Studio Error List window."::: -CMake build warnings about conversions that may result in data loss such as converting from a float to an integer are visible. +C Make build warnings about conversions that might result in data loss such as converting from a float to an integer are visible. :::image-end::: In a folder with multiple build targets, you can specify which CMake target to build: Choose the **Build** item on the **CMake** menu or the *`CMakeLists.txt`* context menu to specify the target. If you enter **Ctrl+Shift+B** in a CMake project, it builds the current active document. ## Debugging CMake projects -To debug a CMake project, choose the preferred configuration and press **F5**. Or, press the **Run** button in the toolbar. If the **Run** button says "Select Startup Item", select the dropdown arrow and choose the target that you want to run. (In a CMake project, the "Current document" option is only valid for .cpp files.) +To debug a CMake project, choose the preferred configuration and press **F5**. Or, press the **Run** button in the toolbar. If the **Run** button says **Select Startup Item**, select the dropdown arrow and choose the target that you want to run. (In a CMake project, the **Current document** option is only valid for .cpp files.) -:::image type="content" source="media/cmake-run-button.png" alt-text="Screenshot of the Select Startup Item dropdown for a CMake project. You can select current document or hello-cmake.exe"::: +:::image type="content" source="media/cmake-run-button.png" alt-text="Screenshot of the Select Startup Item dropdown for a C Make project. You can select current document or hello-cmake."::: The **Run** or **F5** commands first build the project if changes have been made since the previous build. @@ -361,8 +376,8 @@ You can customize a CMake debugging session by setting properties in the *`launc To edit a *`CMakeLists.txt`* file, right-click on the file in **Solution Explorer** and choose **Open**. If you make changes to the file, a yellow status bar appears and informs you that IntelliSense will update. It gives you a chance to cancel the update operation. For information about *`CMakeLists.txt`*, see the [CMake documentation](https://cmake.org/documentation/). - :::image type="complex" source="media/cmake-cmakelists.png" alt-text="Screenshot of a C Make Lists .txt file being edited in Visual Studio."::: - The file contains: project (hello-cmake), add_subdirectory (tests), add_executable (hello hello.cpp), and install (TARGETS hello DESTINATION hello/bin). A message at the top of the window says that c plus plus IntelliSense info will refresh after C Make finishes generating the cache. + :::image type="complex" source="media/cmake-cmakelists.png" alt-text="Screenshot of a C Make Lists file being edited in Visual Studio."::: + The file contains project (hello-cmake), add_subdirectory (tests), add_executable (hello hello.cpp), and install (TARGETS hello DESTINATION hello/bin). A message at the top of the window says that c plus plus IntelliSense info will refresh after C Make finishes generating the cache. :::image-end::: As soon as you save the file, the configuration step automatically runs again and displays information in the **Output** window. Errors and warnings are shown in the **Error List** or **Output** window. Double-click on an error in the **Error List** to navigate to the offending line in *`CMakeLists.txt`*. @@ -373,12 +388,12 @@ As soon as you save the file, the configuration step automatically runs again an ## CMake configure step -When significant changes are made to the *`CMakeSettings.json`* or to *`CMakeLists.txt`* files, Visual Studio automatically reruns the CMake configure step. If the configure step finishes without errors, the information that's collected is available in C++ IntelliSense and language services. It's also used in build and debug operations. +When significant changes are made to the *`CMakeSettings.json`* or to *`CMakeLists.txt`* files, Visual Studio automatically reruns the CMake configure step. If the configure step finishes without errors, the information that's collected is available in C++ IntelliSense and language services. It's also used in build and debug operations. -Multiple CMake projects might use the same CMake configuration name (for example, x86-Debug). All of them are configured and built (in their own build root folder) when that configuration is selected. You can debug the targets from all of the CMake projects that participate in that CMake configuration. +Multiple CMake projects might use the same CMake configuration name (for example, *x86-Debug*). All of them are configured and built (in their own build root folder) when that configuration is selected. You can debug the targets from all of the CMake projects that participate in that CMake configuration. - :::image type="complex" source="media/cmake-build-only.png" alt-text="Screenshot of Visual Studio's main menu, open to CMake > Build Only."::: - The context menu shows what can be built--in this case hello-cmake-a \ hello-cmake.exe (Project hello-cmake) and hello-cmake-b\hello-cmake.exe (Project hello-cmake). The latter is highlighted. + :::image type="complex" source="media/cmake-build-only.png" alt-text="Screenshot of Visual Studio's main menu, open to C Make Build Only."::: + The context menu shows what can be built. In this case hello-cmake-a \ hello-cmake.exe (Project hello-cmake) and hello-cmake-b\hello-cmake.exe (Project hello-cmake). The latter is highlighted. :::image-end::: You can limit builds and debug sessions to a subset of the projects in the workspace. Create a new configuration with a unique name in the *`CMakeSettings.json`* file. Then, apply the configuration to those projects only. When that configuration is selected, IntelliSense and the build and debug commands only apply to those specified projects. @@ -387,7 +402,7 @@ You can limit builds and debug sessions to a subset of the projects in the works If you need more information about the state of the CMake cache to diagnose a problem, open the **CMake** main menu or the *`CMakeLists.txt`* context menu in **Solution Explorer** to run one of these commands: -- **View Cache** opens the *`CMakeCache.txt`* file from the build root folder in the editor. (Any edits you make here to *`CMakeCache.txt`* are wiped out if you clean the cache. To make changes that persist after the cache is cleaned, see [Customize CMake settings](customize-cmake-settings.md).) +- **View Cache** opens the *`CMakeCache.txt`* file from the build root folder in the editor. Any edits you make here to *`CMakeCache.txt`* are wiped out if you clean the cache. To make changes that persist after the cache is cleaned, see [Customize CMake settings](customize-cmake-settings.md). - **Open Cache Folder** opens an Explorer window to the build root folder. @@ -401,11 +416,11 @@ Automatic cache generation can be disabled in the **Tools > Options > CMake > Ge To build a single file in a CMake project, right-click on the file in **Solution Explorer**. Choose **Compile** from the pop-up menu. You can also build the currently open file in the editor by using the main **CMake** menu: -:::image type="content" source="media/cmake-single-file-compile.png" alt-text="Screenshot of the CMake > Compile context menu. It contains one entry: Bullet3Collision."::: +:::image type="content" source="media/cmake-single-file-compile.png" alt-text="Screenshot of the C Make Compile context menu. It contains one entry, Bullet 3 Collision."::: ## Run CMake from the command line -If you have installed CMake from the Visual Studio Installer, you can run it from the command line by following these steps: +If you installed CMake from the Visual Studio Installer, you can run it from the command line by following these steps: 1. Run the appropriate *`vsdevcmd.bat`* file (x86/x64). For more information, see [Building on the Command Line](building-on-the-command-line.md). @@ -421,15 +436,15 @@ In Visual Studio 2015, Visual Studio users can use a [CMake generator](https://c ::: moniker-end -## See also - -[Tutorial: Create C++ cross-platform projects in Visual Studio](get-started-linux-cmake.md)\ -[Configure a Linux CMake project](../linux/cmake-linux-project.md)\ -[Connect to your remote Linux computer](../linux/connect-to-your-remote-linux-computer.md)\ -[Customize CMake build settings](customize-cmake-settings.md)\ -[`CMakeSettings.json` schema reference](cmakesettings-reference.md)\ -[Configure CMake debugging sessions](configure-cmake-debugging-sessions.md)\ -[Deploy, run, and debug your Linux project](../linux/deploy-run-and-debug-your-linux-project.md)\ -[CMake predefined configuration reference](cmake-predefined-configuration-reference.md)\ -[vcpkg in CMake projects](/vcpkg/users/buildsystems/cmake-integration)\ -[Install and use packages with CMake in Visual Studio](/vcpkg/get_started/get-started-vs) +## Related content + +- [Tutorial: Create C++ cross-platform projects in Visual Studio](get-started-linux-cmake.md) +- [Configure a Linux CMake project](../linux/cmake-linux-project.md) +- [Connect to your remote Linux computer](../linux/connect-to-your-remote-linux-computer.md) +- [Customize CMake build settings](customize-cmake-settings.md) +- [*`CMakeSettings.json`* schema reference](cmakesettings-reference.md) +- [Configure CMake debugging sessions](configure-cmake-debugging-sessions.md) +- [Deploy, run, and debug your Linux project](../linux/deploy-run-and-debug-your-linux-project.md) +- [CMake predefined configuration reference](cmake-predefined-configuration-reference.md) +- [vcpkg in CMake projects](/vcpkg/users/buildsystems/cmake-integration) +- [Install and use packages with CMake in Visual Studio](/vcpkg/get_started/get-started-vs) diff --git a/docs/build/cmake-remote-debugging.md b/docs/build/cmake-remote-debugging.md index da1c2c77745..41645840b36 100644 --- a/docs/build/cmake-remote-debugging.md +++ b/docs/build/cmake-remote-debugging.md @@ -1,8 +1,8 @@ --- title: "Tutorial: Debug a CMake project on a remote Windows machine" +description: "How to use Visual Studio C++ on Windows to create and build a CMake project. You'll then deploy and debug it on a remote Windows machine." ms.date: "12/4/2020" ms.topic: tutorial -description: "How to use Visual Studio C++ on Windows to create and build a CMake project. You'll then deploy and debug it on a remote Windows machine." --- # Tutorial: Debug a CMake project on a remote Windows machine @@ -115,7 +115,7 @@ For example, on the remote machine, from the Visual Studio Remote Debugger menu Then, in Visual Studio on the host machine, update the *`launch.vs.json`* file to match. For example, if you choose **No Authentication** on the remote debugger, update the *`launch.vs.json`* file in your project by adding `"authenticationType": "none"` to the `configurations` section *`launch.vs.json`*. Otherwise, `"authenticationType"` defaults to `"windows"` and doesn't need to be explicitly stated. This example shows a *`launch.vs.json`* file configured for no authentication: -``` XAML +```XAML { "version": "0.2.1", "defaults": {}, diff --git a/docs/build/cmakesettings-reference.md b/docs/build/cmakesettings-reference.md index e9a6acdb8ff..274b0237bf1 100644 --- a/docs/build/cmakesettings-reference.md +++ b/docs/build/cmakesettings-reference.md @@ -122,7 +122,7 @@ By default, when the active configuration specifies a Visual Studio generator, i - `remotePreGenerateCommand`: Specifies the command to run before running CMake to parse the *`CMakeLists.txt`* file. - `remotePrebuildCommand`: Specifies the command to run on the remote machine before building. - `remotePostbuildCommand`: Specifies the command to run on the remote machine after building. -- `variables`: Contains a name-value pair of CMake variables that get passed as **`-D name=value`** to CMake. If your CMake project build instructions specify the addition of any variables directly to the *`CMakeCache.txt`* file, we recommend you add them here instead. This example shows how to specify the name-value pairs to use the 14.14.26428 MSVC toolset: +- `variables`: Contains a name-value pair of CMake variables that get passed as **`-D name=value`** to CMake. If your CMake project build instructions specify the addition of any variables directly to the *`CMakeCache.txt`* file, we recommend you add them here instead. This example shows how to specify the name-value pairs to use the 14.14.26428 MSVC Build Tools: ```json "variables": [ diff --git a/docs/build/common-visual-cpp-64-bit-migration-issues.md b/docs/build/common-visual-cpp-64-bit-migration-issues.md index 531a59ee624..7d8603ea722 100644 --- a/docs/build/common-visual-cpp-64-bit-migration-issues.md +++ b/docs/build/common-visual-cpp-64-bit-migration-issues.md @@ -1,13 +1,13 @@ --- -description: "Learn more about: Common Visual C++ 64-bit Migration Issues" -title: "Common Visual C++ 64-bit Migration Issues" +description: "Learn more about: Common Microsoft C++ 64-bit Migration Issues" +title: "Common Microsoft C++ 64-bit Migration Issues" ms.date: "05/06/2019" helpviewer_keywords: ["64-bit programming [C++], migration", "64-bit compiler [C++], migration", "porting 32-bit code to 64-bit code", "migration [C++], 64-bit code issues", "32-bit code porting [C++]", "64-bit applications [C++]", "64-bit compiler [C++], porting 32-bit code", "Win64 [C++]"] ms.assetid: d17fb838-7513-4e2d-8b27-a1666f17ad76 --- -# Common Visual C++ 64-bit Migration Issues +# Common Microsoft C++ 64-bit Migration Issues -When you use the Microsoft C++ compiler (MSVC) to create applications to run on a 64-bit Windows operating system, you should be aware of the following issues: +When you use the Microsoft C++ (MSVC) compiler to create applications to run on a 64-bit Windows operating system, you should be aware of the following issues: - An **`int`** and a **`long`** are 32-bit values on 64-bit Windows operating systems. For programs that you plan to compile for 64-bit platforms, you should be careful not to assign pointers to 32-bit variables. Pointers are 64-bit on 64-bit platforms, and you will truncate the pointer value if you assign it to a 32-bit variable. @@ -34,4 +34,4 @@ For more information, see: ## See also [Configure C++ projects for 64-bit, x64 targets](configuring-programs-for-64-bit-visual-cpp.md)
-[Visual C++ Porting and Upgrading Guide](../porting/visual-cpp-porting-and-upgrading-guide.md) +[Microsoft C++ Porting and Upgrading Guide](../porting/visual-cpp-porting-and-upgrading-guide.md) diff --git a/docs/build/common-visual-cpp-arm-migration-issues.md b/docs/build/common-visual-cpp-arm-migration-issues.md index 93805a8ab7d..bd39965f08d 100644 --- a/docs/build/common-visual-cpp-arm-migration-issues.md +++ b/docs/build/common-visual-cpp-arm-migration-issues.md @@ -1,29 +1,31 @@ --- -description: "Learn more about: Common Visual C++ ARM Migration Issues" -title: "Common Visual C++ ARM Migration Issues" +description: "Learn more about: Common Microsoft C++ ARM Migration Issues" +title: "Common Microsoft C++ ARM Migration Issues" ms.date: "05/06/2019" -ms.assetid: 0f4c434e-0679-4331-ba0a-cc15dd435a46 --- -# Common Visual C++ ARM Migration Issues +# Common Microsoft C++ ARM migration issues -When using the Microsoft C++ compiler (MSVC), the same C++ source code might produce different results on the ARM architecture than it does on x86 or x64 architectures. +This document describes some of the common issues that you might encounter when you migrate code from x86 or x64 architectures to the ARM architecture. It also describes how to avoid these issues, and how to use the compiler to help identify them. + +> [!NOTE] +> When this article refers to the ARM architecture, it applies to both ARM32 and ARM64. ## Sources of migration issues Many issues that you might encounter when you migrate code from the x86 or x64 architectures to the ARM architecture are related to source-code constructs that might invoke undefined, implementation-defined, or unspecified behavior. -*Undefined behavior* is behavior that the C++ standard does not define, and that's caused by an operation that has no reasonable result: for example, converting a floating-point value to an unsigned integer, or shifting a value by a number of positions that is negative or exceeds the number of bits in its promoted type. +*Undefined behavior* is behavior that the C++ standard doesn't define, and that's caused by an operation that has no reasonable result: for example, converting a floating-point value to an unsigned integer, or shifting a value by a number of positions that is negative or exceeds the number of bits in its promoted type. *Implementation-defined behavior* is behavior that the C++ standard requires the compiler vendor to define and document. A program can safely rely on implementation-defined behavior, even though doing so might not be portable. Examples of implementation-defined behavior include the sizes of built-in data types and their alignment requirements. An example of an operation that might be affected by implementation-defined behavior is accessing the variable arguments list. -*Unspecified behavior* is behavior that the C++ standard leaves intentionally non-deterministic. Although the behavior is considered non-deterministic, particular invocations of unspecified behavior are determined by the compiler implementation. However, there is no requirement for a compiler vendor to predetermine the result or guarantee consistent behavior between comparable invocations, and there is no requirement for documentation. An example of unspecified behavior is the order in which sub-expressions, which include arguments to a function call, are evaluated. +*Unspecified behavior* is behavior that the C++ standard leaves intentionally nondeterministic. Although the behavior is considered nondeterministic, particular invocations of unspecified behavior are determined by the compiler implementation. However, there's no requirement for a compiler vendor to predetermine the result or guarantee consistent behavior between comparable invocations, and there's no requirement for documentation. An example of unspecified behavior is the order in which sub-expressions, which include arguments to a function call, are evaluated. -Other migration issues can be attributed to hardware differences between ARM and x86 or x64 architectures that interact with the C++ standard differently. For example, the strong memory model of the x86 and x64 architecture gives **`volatile`**-qualified variables some additional properties that have been used to facilitate certain kinds of inter-thread communication in the past. But the ARM architecture's weak memory model doesn't support this use, nor does the C++ standard require it. +Other migration issues can be attributed to hardware differences between ARM and x86 or x64 architectures that interact with the C++ standard differently. For example, the strong memory model of the x86 and x64 architecture gives **`volatile`**-qualified variables some extra properties that have been used to facilitate certain kinds of inter-thread communication in the past. But the ARM architecture's weak memory model doesn't support this use, nor does the C++ standard require it. > [!IMPORTANT] -> Although **`volatile`** gains some properties that can be used to implement limited forms of inter-thread communication on x86 and x64, these additional properties are not sufficient to implement inter-thread communication in general. The C++ standard recommends that such communication be implemented by using appropriate synchronization primitives instead. +> Although **`volatile`** gains some properties that can be used to implement limited forms of inter-thread communication on x86 and x64, these properties aren't sufficient to implement inter-thread communication in general. The C++ standard recommends that such communication be implemented by using appropriate synchronization primitives instead. -Because different platforms might express these kinds of behavior differently, porting software between platforms can be difficult and bug-prone if it depends on the behavior of a specific platform. Although many of these kinds of behavior can be observed and might appear stable, relying on them is at least non-portable, and in the cases of undefined or unspecified behavior, is also an error. Even the behavior that's cited in this document should not be relied on, and could change in future compilers or CPU implementations. +Because different platforms might express these kinds of behavior differently, porting software between platforms can be difficult and bug-prone if it depends on the behavior of a specific platform. Although many of these kinds of behavior can be observed and might appear stable, relying on them is at least non-portable, and in the cases of undefined or unspecified behavior, is also an error. Even the behavior cited in this document shouldn't be relied on, and could change in future compilers or CPU implementations. ## Example migration issues @@ -41,15 +43,15 @@ These platforms also differ in how they handle conversion of NaN (Not-a-Number) Floating-point conversion can only be relied on if you know that the value is within the range of the integer type that it's being converted to. -### Shift operator (\<\< >>) behavior +### Shift operator (`<<` `>>`) behavior -On the ARM architecture, a value can be shifted left or right up to 255 bits before the pattern begins to repeat. On x86 and x64 architectures, the pattern is repeated at every multiple of 32 unless the source of the pattern is a 64-bit variable; in that case, the pattern repeats at every multiple of 64 on x64, and every multiple of 256 on x86, where a software implementation is employed. For example, for a 32-bit variable that has a value of 1 shifted left by 32 positions, on ARM the result is 0, on x86 the result is 1, and on x64 the result is also 1. However, if the source of the value is a 64-bit variable, then the result on all three platforms is 4294967296, and the value doesn't "wrap around" until it's shifted 64 positions on x64, or 256 positions on ARM and x86. +On the ARM architecture, a value can be shifted left or right up to 255 bits before the pattern begins to repeat. On x86 and x64 architectures, the pattern is repeated at every multiple of 32 unless the source of the pattern is a 64-bit variable. In that case, the pattern repeats at every multiple of 64 on x64, and every multiple of 256 on x86, where a software implementation is employed. For example, for a 32-bit variable that has a value of 1 shifted left by 32 positions, on ARM the result is 0, on x86 the result is 1, and on x64 the result is also 1. However, if the source of the value is a 64-bit variable, then the result on all three platforms is 4294967296, and the value doesn't "wrap around" until it's shifted 64 positions on x64, or 256 positions on ARM and x86. -Because the result of a shift operation that exceeds the number of bits in the source type is undefined, the compiler is not required to have consistent behavior in all situations. For example, if both operands of a shift are known at compile time, the compiler may optimize the program by using an internal routine to precompute the result of the shift and then substituting the result in place of the shift operation. If the shift amount is too large, or negative, the result of the internal routine might be different than the result of the same shift expression as executed by the CPU. +Because the result of a shift operation that exceeds the number of bits in the source type is undefined, the compiler isn't required to have consistent behavior in all situations. For example, if both operands of a shift are known at compile time, the compiler may optimize the program by using an internal routine to precompute the result of the shift and then substituting the result in place of the shift operation. If the shift amount is too large, or negative, the result of the internal routine might be different than the result of the same shift expression as executed by the CPU. ### Variable arguments (varargs) behavior -On the ARM architecture, parameters from the variable arguments list that are passed on the stack are subject to alignment. For example, a 64-bit parameter is aligned on a 64-bit boundary. On x86 and x64, arguments that are passed on the stack are not subject to alignment and pack tightly. This difference can cause a variadic function like `printf` to read memory addresses that were intended as padding on ARM if the expected layout of the variable arguments list is not matched exactly, even though it might work for a subset of some values on the x86 or x64 architectures. Consider this example: +On the ARM architecture, parameters from the variable arguments list that are passed on the stack are subject to alignment. For example, a 64-bit parameter is aligned on a 64-bit boundary. On x86 and x64, arguments that are passed on the stack aren't subject to alignment and pack tightly. This difference can cause a variadic function like `printf` to read memory addresses that were intended as padding on ARM if the expected layout of the variable arguments list isn't matched exactly, even though it might work for a subset of some values on the x86 or x64 architectures. Consider this example: ```C // notice that a 64-bit integer is passed to the function, but '%d' is used to read it. @@ -69,7 +71,7 @@ printf("%I64d\n", 1LL); Because ARM, x86, and x64 processors are so different, they can present different requirements to compiler implementations, and also different opportunities for optimizations. Because of this, together with other factors like calling-convention and optimization settings, a compiler might evaluate function arguments in a different order on different architectures or when the other factors are changed. This can cause the behavior of an app that relies on a specific evaluation order to change unexpectedly. -This kind of error can occur when arguments to a function have side effects that impact other arguments to the function in the same call. Usually this kind of dependency is easy to avoid, but it can sometimes be obscured by dependencies that are difficult to discern, or by operator overloading. Consider this code example: +This kind of error can occur when arguments to a function have side effects that impact other arguments to the function in the same call. Usually this kind of dependency is easy to avoid but can be obscured by dependencies that are difficult to discern or by operator overloading. Consider this code example: ```cpp handle memory_handle; @@ -83,16 +85,16 @@ This appears well-defined, but if `->` and `*` are overloaded operators, then th Handle::acquire(operator->(memory_handle), operator*(p)); ``` -And if there's a dependency between `operator->(memory_handle)` and `operator*(p)`, the code might rely on a specific evaluation order, even though the original code looks like there is no possible dependency. +And if there's a dependency between `operator->(memory_handle)` and `operator*(p)`, the code might rely on a specific evaluation order, even though the original code looks like there's no possible dependency. -### volatile keyword default behavior +### `volatile` keyword default behavior -The MSVC compiler supports two different interpretations of the **`volatile`** storage qualifier that you can specify by using compiler switches. The [/volatile:ms](reference/volatile-volatile-keyword-interpretation.md) switch selects the Microsoft extended volatile semantics that guarantee strong ordering, as has been the traditional case for x86 and x64 because of the strong memory model on those architectures. The [/volatile:iso](reference/volatile-volatile-keyword-interpretation.md) switch selects the strict C++ standard volatile semantics that don't guarantee strong ordering. +The Microsoft C++ (MSVC) compiler supports two different interpretations of the **`volatile`** storage qualifier that you can specify by using compiler switches. The [/volatile:ms](reference/volatile-volatile-keyword-interpretation.md) switch selects the Microsoft extended volatile semantics that guarantee strong ordering, as has been the traditional case for x86 and x64 because of the strong memory model on those architectures. The [/volatile:iso](reference/volatile-volatile-keyword-interpretation.md) switch selects the strict C++ standard volatile semantics that don't guarantee strong ordering. On the ARM architecture (except ARM64EC), the default is **/volatile:iso** because ARM processors have a weakly ordered memory model, and because ARM software doesn't have a legacy of relying on the extended semantics of **/volatile:ms** and doesn't usually have to interface with software that does. However, it's still sometimes convenient or even required to compile an ARM program to use the extended semantics. For example, it may be too costly to port a program to use the ISO C++ semantics, or driver software might have to adhere to the traditional semantics to function correctly. In these cases, you can use the **/volatile:ms** switch; however, to recreate the traditional volatile semantics on ARM targets, the compiler must insert memory barriers around each read or write of a **`volatile`** variable to enforce strong ordering, which can have a negative impact on performance. -On the x86, x64 and ARM64EC architectures, the default is **/volatile:ms** because much of the software that has already been created for these architectures by using MSVC relies on them. When you compile x86, x64 and ARM64EC programs, you can specify the **/volatile:iso** switch to help avoid unnecessary reliance on the traditional volatile semantics, and to promote portability. +On the x86, x64, and ARM64EC architectures, the default is **/volatile:ms** because much of the software that has already been created for these architectures by using MSVC relies on them. When you compile x86, x64 and ARM64EC programs, you can specify the **/volatile:iso** switch to help avoid unnecessary reliance on the traditional volatile semantics, and to promote portability. ## See also -[Configure Visual C++ for ARM processors](configuring-programs-for-arm-processors-visual-cpp.md) +[Configure Microsoft C++ for ARM processors](configuring-programs-for-arm-processors-visual-cpp.md) diff --git a/docs/build/compare-inclusion-methods.md b/docs/build/compare-inclusion-methods.md index 8c16032aee4..2f8c25c5b6a 100644 --- a/docs/build/compare-inclusion-methods.md +++ b/docs/build/compare-inclusion-methods.md @@ -40,4 +40,4 @@ If you can't use C++20 features, use `#include` and consider precompiled headers [Overview of modules in C++](../cpp/modules-cpp.md)\ [Tutorial: Import the C++ standard library using modules](../cpp/tutorial-import-stl-named-module.md)\ [Walkthrough: Import STL libraries as header units](walkthrough-import-stl-header-units.md#approach1)\ -[Walkthrough: Build and import header units in your Visual C++ projects](walkthrough-header-units.md) \ No newline at end of file +[Walkthrough: Build and import header units in your Microsoft C++ projects](walkthrough-header-units.md) \ No newline at end of file diff --git a/docs/build/concepts-of-isolated-applications-and-side-by-side-assemblies.md b/docs/build/concepts-of-isolated-applications-and-side-by-side-assemblies.md index 7b3b78360bf..2993d7abb37 100644 --- a/docs/build/concepts-of-isolated-applications-and-side-by-side-assemblies.md +++ b/docs/build/concepts-of-isolated-applications-and-side-by-side-assemblies.md @@ -4,6 +4,7 @@ title: "Concepts of Isolated Applications and Side-by-side Assemblies" ms.date: "05/06/2019" helpviewer_keywords: ["side-by-side assemblies [C++]", "isolated assemblies [C++]"] ms.assetid: 945a885f-cb3e-4c8a-a0b9-2c2e3e02cc50 +ms.topic: concept-article --- # Concepts of Isolated Applications and Side-by-side Assemblies @@ -23,9 +24,9 @@ At execution time, Windows uses assembly information from the application manife You can change side-by-side assembly dependencies after an application has been deployed by modifying the [Publisher Configuration Files](/windows/win32/SbsCs/publisher-configuration-files) and [Application Configuration Files](/windows/win32/SbsCs/application-configuration-files). A publisher configuration file, also known as a publisher policy file, is an XML file that globally redirects applications and assemblies from using one version of a side-by-side assembly to using another version of the same assembly. For example, you could change a dependency when a bug fix or security fix is deployed for a side-by-side assembly and you want to redirect all applications to use the fixed version. An application configuration file is an XML file that redirects a specific application from using one version of a side-by-side assembly to using another version of the same assembly. You can use an application configuration file to redirect a particular application to use a version of a side-by-side assembly that's different from the one that's defined in the publisher configuration file. For more information, see [Configuration](/windows/win32/SbsCs/configuration). -## Visual C++ libraries +## Microsoft C++ libraries -In Visual Studio 2005 and Visual Studio 2008, redistributable libraries such as ATL, MFC, CRT, Standard C++, OpenMP, and MSDIA were deployed as shared side-by-side assemblies to the native assembly cache. In the current version, the redistributable libraries use central deployment. By default, all applications that are built by using Visual Studio are built with the manifest embedded in the final binary, and the manifest describes the dependencies of the binary on the Visual C++ libraries. To understand manifest generation for C++ applications, see [Understanding Manifest Generation for C/C++ Programs](understanding-manifest-generation-for-c-cpp-programs.md). A manifest is not required for applications that are statically linked to the libraries that they use, or that use local deployment. For more information about deployment, see [Deployment in Visual C++](../windows/deployment-in-visual-cpp.md). +In Visual Studio 2005 and Visual Studio 2008, redistributable libraries such as ATL, MFC, CRT, Standard C++, OpenMP, and MSDIA were deployed as shared side-by-side assemblies to the native assembly cache. In the current version, the redistributable libraries use central deployment. By default, all applications that are built by using Visual Studio are built with the manifest embedded in the final binary, and the manifest describes the dependencies of the binary on the Microsoft C++ libraries. To understand manifest generation for C++ applications, see [Understanding Manifest Generation for C/C++ Programs](understanding-manifest-generation-for-c-cpp-programs.md). A manifest is not required for applications that are statically linked to the libraries that they use, or that use local deployment. For more information about deployment, see [Deployment in Microsoft C++](../windows/deployment-in-visual-cpp.md). ## See also diff --git a/docs/build/configure-cmake-debugging-sessions.md b/docs/build/configure-cmake-debugging-sessions.md index 896d5a3bf43..a16c9e0f9b8 100644 --- a/docs/build/configure-cmake-debugging-sessions.md +++ b/docs/build/configure-cmake-debugging-sessions.md @@ -3,6 +3,7 @@ title: "Configure CMake debugging sessions in Visual Studio" description: "Describes how to use Visual Studio to configure CMake debugger settings." ms.date: 10/26/2023 helpviewer_keywords: ["CMake debugging"] +ms.topic: how-to --- # Configure CMake debugging sessions diff --git a/docs/build/configuring-programs-for-64-bit-visual-cpp.md b/docs/build/configuring-programs-for-64-bit-visual-cpp.md index e922af4027d..845be402593 100644 --- a/docs/build/configuring-programs-for-64-bit-visual-cpp.md +++ b/docs/build/configuring-programs-for-64-bit-visual-cpp.md @@ -7,15 +7,15 @@ ms.assetid: cb99f72b-8c74-48f4-846a-8921b37b97e9 --- # Configure C++ projects for 64-bit, x64 targets -This section contains topics about targeting 64-bit x64 hardware with the Visual C++ build tools. +This section contains topics about targeting 64-bit x64 hardware with the Microsoft C++ (MSVC) Build Tools. ## In This Section -- [How to: Configure Visual C++ Projects to Target 64-Bit, x64 Platforms](how-to-configure-visual-cpp-projects-to-target-64-bit-platforms.md) +- [How to: Configure Microsoft C++ Projects to Target 64-Bit, x64 Platforms](how-to-configure-visual-cpp-projects-to-target-64-bit-platforms.md) - [How to: Enable a 64-bit, x64-hosted MSVC toolset on the command line](how-to-enable-a-64-bit-visual-cpp-toolset-on-the-command-line.md) -- [Common Visual C++ 64-bit Migration Issues](common-visual-cpp-64-bit-migration-issues.md) +- [Common Microsoft C++ 64-bit Migration Issues](common-visual-cpp-64-bit-migration-issues.md) - [x64 Software Conventions](x64-software-conventions.md) diff --git a/docs/build/configuring-programs-for-arm-processors-visual-cpp.md b/docs/build/configuring-programs-for-arm-processors-visual-cpp.md index fc99baa1b25..bb6e7c40dc9 100644 --- a/docs/build/configuring-programs-for-arm-processors-visual-cpp.md +++ b/docs/build/configuring-programs-for-arm-processors-visual-cpp.md @@ -5,7 +5,7 @@ ms.date: "07/11/2018" --- # Configure C++ projects for ARM processors -This section of the documentation contains information about how to use the MSVC build tools to target ARM hardware. +This section of the documentation contains information about how to use the Microsoft C++ (MSVC) Build Tools to target ARM hardware. ## In This Section diff --git a/docs/build/configuring-programs-for-windows-xp.md b/docs/build/configuring-programs-for-windows-xp.md index 3e96c4f48ed..629e6b7230e 100644 --- a/docs/build/configuring-programs-for-windows-xp.md +++ b/docs/build/configuring-programs-for-windows-xp.md @@ -3,6 +3,7 @@ title: "Configuring Programs for Windows XP" description: "How to install and use the C++ Windows XP toolsets in Visual Studio." ms.date: 09/17/2021 ms.assetid: 1e4487b3-d815-4123-878b-5718b22f0fd5 +ms.topic: how-to --- # Configuring Programs for Windows XP diff --git a/docs/build/cppproperties-schema-reference.md b/docs/build/cppproperties-schema-reference.md index cafd37a1e78..8ab040779a0 100644 --- a/docs/build/cppproperties-schema-reference.md +++ b/docs/build/cppproperties-schema-reference.md @@ -93,7 +93,7 @@ You can optionally use the `environments` property to define sets of variables i "mingw_64" ], "name": "Mingw64", - "includePath ,": [ + "includePath": [ "${env.INCLUDE}", "${workspaceRoot}\\**", ], diff --git a/docs/build/create-reusable-property-configurations.md b/docs/build/create-reusable-property-configurations.md index d046426504a..52af28e0f40 100644 --- a/docs/build/create-reusable-property-configurations.md +++ b/docs/build/create-reusable-property-configurations.md @@ -3,6 +3,7 @@ description: "Learn more about: Share or reuse Visual Studio project settings" title: "Share or reuse Visual Studio project settings - C++" ms.date: 02/07/2022 helpviewer_keywords: ["project properties [C++], reusable"] +ms.topic: how-to --- # Share or reuse Visual Studio project settings diff --git a/docs/build/creating-a-resource-only-dll.md b/docs/build/creating-a-resource-only-dll.md index e054108b83b..664e45250de 100644 --- a/docs/build/creating-a-resource-only-dll.md +++ b/docs/build/creating-a-resource-only-dll.md @@ -5,6 +5,7 @@ ms.date: "01/27/2020" helpviewer_keywords: ["resource-only DLLs [C++], creating", "DLLs [C++], creating"] ms.assetid: e6b1d4da-7275-467f-a58c-a0a8a5835199 no-loc: [noentry] +ms.topic: how-to --- # Creating a resource-only DLL diff --git a/docs/build/creating-and-managing-visual-cpp-projects.md b/docs/build/creating-and-managing-visual-cpp-projects.md index 35125a7b22a..2441a8b327e 100644 --- a/docs/build/creating-and-managing-visual-cpp-projects.md +++ b/docs/build/creating-and-managing-visual-cpp-projects.md @@ -1,27 +1,30 @@ --- -description: "Learn more about: creating and configuring Visual Studio C++ projects" -title: "Visual Studio Projects - C++" -ms.date: 10/4/2023 +title: "Create and Configure Visual Studio C++ Projects" +description: "Learn how to create a Visual Studio C++ project, and then add code and build your project." +ms.date: 03/24/2025 +ms.topic: concept-article helpviewer_keywords: ["Visual Studio C++ projects, creating", "projects [C++], creating", "Visual Studio C++ projects"] --- -# Visual Studio projects - C++ +# Visual Studio C++ projects -A *Visual Studio project* is a collection of code files and assets such as icons, images, and so on, that are built together using the MSBuild build system. MSBuild is the native build system for Visual Studio and is generally the best build system to use for Windows-specific programs. MSBuild is tightly integrated with Visual Studio, but you can also use it from the command line. +A *Visual Studio project* is a collection of code files and assets such as icons, images, and so on, that are built together using the MSBuild system. MSBuild is the native build system for Visual Studio and is generally the best build system to use for Windows-specific programs. MSBuild is tightly integrated with Visual Studio, but you can also use it from the command line. -For information about upgrading MSBuild projects from older versions of Visual Studio, see the [Microsoft C++ Porting and Upgrading Guide](../porting/visual-cpp-porting-and-upgrading-guide.md). +For information about upgrading MSBuild projects from older versions of Visual Studio, see the [Microsoft C++ porting and upgrading guide](../porting/visual-cpp-porting-and-upgrading-guide.md). -For cross-platform projects, or projects that use open-source libraries, we recommend using [CMake projects in Visual Studio](cmake-projects-in-visual-studio.md) in Visual Studio 2017 and later. +For cross-platform projects, or projects that use open-source libraries, we recommend using [CMake projects in Visual Studio](cmake-projects-in-visual-studio.md). ## Create a Visual Studio C++ project ::: moniker range=">=msvc-160" 1. Create a C++ project by choosing **File** > **New** > **Project**. + 1. In the **Create a new project** dialog, set the **Language** dropdown to **C++**. This filters the list of project templates to C++ projects. You can filter the templates by setting the **Platform**, **Project Type**, or by entering keywords in the search box. - ![Screenshot of the Create a new project wizard. The Console App project template is selected.](../build/media/vs2019-choose-console-app.png) + :::image type="content" source="../build/media/vs2019-choose-console-app.png" alt-text="Screenshot of the Create a new project wizard. The Console App project template is selected."::: 1. Select a project template, then choose **Next**. + 1. On the **Configure your new project page**, enter project-specific settings such as the project name or location and then choose **Create** to create your project. ::: moniker-end @@ -29,21 +32,22 @@ For cross-platform projects, or projects that use open-source libraries, we reco ::: moniker range="msvc-150" 1. Create a C++ project by choosing **File** > **New** > **Project**. + 1. Choose **Visual C++** in the left pane. In the center pane, a list of project templates appears: - ![Screenshot of the New Project dialog, showing available project templates for C++ such as Windows Console Application.](../overview/media/vs2017-new-project.png "Visual Studio 2017 New Project Dialog") + :::image type="content" source="../overview/media/vs2017-new-project.png" alt-text="Screenshot of the New Project dialog, showing available project templates for C++ such as Windows Console Application."::: ::: moniker-end For more information about the default project templates included in Visual Studio, see [C++ project templates in Visual Studio](reference/visual-cpp-project-types.md). -You can create your own project templates. For more information, see [How to: Create project templates](/visualstudio/ide/how-to-create-project-templates). +You can create your own project templates. For more information, see [Create project templates](/visualstudio/ide/how-to-create-project-templates). After you create a project, it appears in the [Solution Explorer](/visualstudio/ide/solutions-and-projects-in-visual-studio) window: - ![Screenshot of the Solution Explorer window, showing source files, header files, and resource files.](media/mathlibrary-solution-explorer-153.png) +:::image type="content" source="media/mathlibrary-solution-explorer-153.png" alt-text="Screenshot of the Solution Explorer window, showing source files, header files, and resource files."::: -When you create a new project, a solution file (.sln) is also created. A *Visual Studio solution* is a collection of one or more projects. You can add another project to the solution by right-clicking the solution name in **Solution Explorer** > **Add** > **New project**. +When you create a new project, a solution file (*`.sln`*) is also created. A *Visual Studio solution* is a collection of one or more projects. You can add another project to the solution by right-clicking the solution name in **Solution Explorer** > **Add** > **New project**. The solution file coordinates build dependencies when you have multiple related projects. Compiler options are set at the project level. @@ -61,28 +65,28 @@ For more information about consuming a library that you have downloaded by using - [vcpkg in MSBuild projects](/vcpkg/users/buildsystems/msbuild-integration) - [Tutorial: Install and use packages with MSBuild in Visual Studio](/vcpkg/get_started/get-started-msbuild) -They're also commercial third-party libraries that you can install. Follow their installation instructions. +There are also commercial third-party libraries that you can install. Follow their installation instructions. ## Set compiler options and build properties -To configure build settings for a project, right-click on the project in **Solution Explorer** and choose **Properties**. For more information, see [Set C++ compiler and build properties in Visual Studio](working-with-project-properties.md). +To configure build settings for a project, right-click on the project in **Solution Explorer** and choose **Properties**. For more information, see [Set compiler and build properties](working-with-project-properties.md). ## Compile and run a project -To compile and run the new project, press **F5** or click the *debug dropdown* with the green arrow on the main toolbar. The *configuration dropdown* is where you choose whether to perform a *Debug* or *Release* build (or some other custom configuration). +To compile and run the new project, press **F5** or select the *debug dropdown* with the green arrow on the main toolbar. The *configuration dropdown* is where you choose whether to perform a *Debug* or *Release* build (or some other custom configuration). A new project compiles without errors. When adding your own code, you might occasionally introduce an error or trigger a warning. An error prevents the build from completing; a warning doesn't. All errors and warnings appear both in the Output Window and in the Error List when you build the project. - ![Screenshot of the Output window and Error list, showing a syntax error for a misplaced colon.](../overview/media/vs2017-output-error-list.png) +:::image type="content" source="../overview/media/vs2017-output-error-list.png" alt-text="Screenshot of the Output window and Error list, showing a syntax error for a misplaced colon."::: In the **Error List**, you can press **F1** on the highlighted error to go to its documentation topic. -## See also +## Related content -[Create a project from existing code](how-to-create-a-cpp-project-from-existing-code.md)\ -[Set C++ compiler and build properties in Visual Studio](working-with-project-properties.md)\ -[Custom build steps and build events](understanding-custom-build-steps-and-build-events.md)\ -[Reference libraries and components at build time](adding-references-in-visual-cpp-projects.md)\ -[Organize project output files](how-to-organize-project-output-files-for-builds.md)\ -[Projects and build systems](projects-and-build-systems-cpp.md)\ -[Microsoft C++ porting and upgrade guide](../porting/visual-cpp-porting-and-upgrading-guide.md) +- [Create a project from existing code](how-to-create-a-cpp-project-from-existing-code.md) +- [Set C++ compiler and build properties in Visual Studio](working-with-project-properties.md) +- [Custom build steps and build events](understanding-custom-build-steps-and-build-events.md) +- [Reference libraries and components at build time](adding-references-in-visual-cpp-projects.md) +- [Organize project output files](how-to-organize-project-output-files-for-builds.md) +- [Projects and build systems](projects-and-build-systems-cpp.md) +- [Microsoft C++ porting and upgrade guide](../porting/visual-cpp-porting-and-upgrading-guide.md) diff --git a/docs/build/creating-precompiled-header-files.md b/docs/build/creating-precompiled-header-files.md index 1c8cb52ddcc..ec450093ce7 100644 --- a/docs/build/creating-precompiled-header-files.md +++ b/docs/build/creating-precompiled-header-files.md @@ -1,6 +1,6 @@ --- -description: "Learn more about: Precompiled header files" title: "Precompiled Header Files" +description: "Learn more about: Precompiled header files" ms.date: 06/29/2022 helpviewer_keywords: ["precompiled header files, creating", "PCH files, creating", "cl.exe compiler, precompiling code", ".pch files, creating"] --- @@ -140,7 +140,7 @@ This table lists compiler options that might trigger an inconsistency warning wh | Option | Name | Rule | |--|--|--| -| **`/D `**| Define constants and macros | Must be the same between the compilation that created the precompiled header and the current compilation. The state of defined constants isn't checked. However, unpredictable results can occur if your files depend on the values of the changed constants. | +| **`/D`**| Define constants and macros | Must be the same between the compilation that created the precompiled header and the current compilation. The state of defined constants isn't checked. However, unpredictable results can occur if your files depend on the values of the changed constants. | | **`/E`** or **`/EP`** | Copy preprocessor output to standard output | Precompiled headers don't work with the **`/E`** or **`/EP`** option. | | **`/Fr`** or **`/FR`** | Generate Microsoft Source Browser information | For the **`/Fr`** and **`/FR`** options to be valid with the **`/Yu`** option, they must also have been in effect when the precompiled header was created. Subsequent compilations that use the precompiled header also generate Source Browser information. Browser information is placed in a single *`.sbr`* file and is referenced by other files in the same manner as CodeView information. You can't override the placement of Source Browser information. | | **`/GA`**, **`/GD`**, **`/GE`**, **`/Gw`**, or **`/GW`** | Windows protocol options | Must be the same between the compilation that created the precompiled header and the current compilation. The compiler emits a warning if these options differ. | @@ -161,7 +161,6 @@ The code base of a software project is often contained in multiple C or C++ sour The figure uses three diagrammatic devices to show the flow of the build process. Named rectangles represent each file or macro; the three macros represent one or more files. Shaded areas represent each compile or link action. Arrows show which files and macros are combined during the compilation or linking process. -![ The diagram is described in the text following the diagram.]()\ Structure of a makefile that uses a precompiled header file: :::image type="complex" source="media/vc30ow1.gif" alt-text="Diagram showing example inputs and outputs of a makefile that uses a precompiled header file."::: @@ -259,7 +258,7 @@ Source file `ANOTHER.H`: // #ifndef __ANOTHER_H #define __ANOTHER_H -#include +#include void savemoretime( void ); #endif // __ANOTHER_H ``` @@ -273,7 +272,7 @@ Source file `STABLE.H`: // #ifndef __STABLE_H #define __STABLE_H -#include +#include void savetime( void ); #endif // __STABLE_H ``` @@ -289,7 +288,7 @@ Source file `UNSTABLE.H`: // #ifndef __UNSTABLE_H #define __UNSTABLE_H -#include +#include void notstable( void ); #endif // __UNSTABLE_H ``` @@ -301,9 +300,9 @@ Source file `APPLIB.CPP`: // the interface code declared in the header // files STABLE.H, ANOTHER.H, and UNSTABLE.H. // -#include"another.h" -#include"stable.h" -#include"unstable.h" +#include "another.h" +#include "stable.h" +#include "unstable.h" using namespace std; // The following code represents code that is deemed stable and // not likely to change. The associated interface code is @@ -331,9 +330,9 @@ Source file `MYAPP.CPP`: // listed in the BOUNDRY macro. Unstable code must // be included after the precompiled code. // -#include"another.h" -#include"stable.h" -#include"unstable.h" +#include "another.h" +#include "stable.h" +#include "unstable.h" int main( void ) { savetime(); @@ -346,8 +345,8 @@ int main( void ) [Compare header units, modules, and precompiled headers](compare-inclusion-methods.md)\ [C/C++ building reference](reference/c-cpp-building-reference.md)\ -[MSVC compiler options](reference/compiler-options.md) +[MSVC compiler options](reference/compiler-options.md)\ [Overview of modules in C++](../cpp/modules-cpp.md)\ [Tutorial: Import the C++ standard library using modules](../cpp/tutorial-import-stl-named-module.md)\ -[Walkthrough: Build and import header units in your Visual C++ projects](walkthrough-header-units.md)\ +[Walkthrough: Build and import header units in your Microsoft C++ projects](walkthrough-header-units.md)\ [Walkthrough: Import STL libraries as header units](walkthrough-import-stl-header-units.md#approach1) diff --git a/docs/build/customize-cmake-settings.md b/docs/build/customize-cmake-settings.md index 078c550ff55..5c8cd24cf4a 100644 --- a/docs/build/customize-cmake-settings.md +++ b/docs/build/customize-cmake-settings.md @@ -3,10 +3,21 @@ description: "Learn more about: Customize CMake build settings" title: "Customize CMake build settings in Visual Studio" ms.date: 12/15/2021 helpviewer_keywords: ["CMake build settings"] +ms.topic: how-to --- # Customize CMake build settings -::: moniker range=">=msvc-160" +::: moniker range=">=msvc-180" + +The CMake settings editor has been deprecated in Visual Studio 2026. + +To learn about changing the *`CMakePresets.json`* file, see [CMakePresets.json and CMakeUserPresets.json Microsoft vendor maps](/cpp/build/cmake-presets-json-reference). + +For Visual Studio 2019 to 2022, select your version by using the version selector in the sidebar menu. + +::: moniker-end + +::: moniker range=">=msvc-160 <=msvc-170" Visual Studio uses a CMake configuration file to drive CMake generation and build. *`CMakePresets.json`* is supported by Visual Studio 2019 version 16.10 or later and is the recommended CMake configuration file. *`CMakePresets.json`* is supported directly by CMake and can be used to drive CMake generation and build from Visual Studio, from VS Code, in a Continuous Integration pipeline, and from the command line on Windows, Linux, and Mac. For more information on *`CMakePresets.json`*, see [Configure and build with CMake Presets](cmake-presets-vs.md). @@ -22,6 +33,10 @@ Now you see the **Settings Editor** with the installed configurations on the lef The left pane shows the installed configurations (x86-Debug). The right pane shows the settings for the selected configuration. The settings include the configuration name, configuration type (set to Debug), toolset (set to msvc_x86), CMake toolchain file (empty), build root (contains ${env:USERPROFILE}\CMakeBuilds\${workspaceHash}\build\${name}), CMake command arguments (empty), and build command arguments (-v). :::image-end::: +> [!NOTE] +> If a JSON editor opens instead of the **Settings Editor** when you select **Manage Configurations**, you need to enable the CMakeSettings mode. Under **Tools** > **Options** > **CMake**, select **Never use CMake Presets**, and then close and reopen your CMake project. Alternatively, you can choose **Use CMake Presets if available, otherwise use CMakeSettings.json**, and then delete the *CMakePresets.json* file from the project folder. +> :::image type="content" source="media/options-configuration-file.png" alt-text="Screenshot of the C make options pane."::: + Visual Studio provides one `x64-Debug` configuration by default. You can add more configurations by choosing the green plus sign. The settings that you see in the editor might vary depending on which configuration is selected. The options that you choose in the editor are written to a file called *`CMakeSettings.json`*. This file provides command-line arguments and environment variables that are passed to CMake when you build the projects. Visual Studio never modifies *`CMakeLists.txt`* automatically; by using *`CMakeSettings.json`* you can customize the build through Visual Studio while leaving the CMake project files untouched so that others on your team can consume them with whatever tools they're using. @@ -72,7 +87,7 @@ For configurations such as Linux that use remote builds, the following settings ### `rsync` command arguments -Extra command-line options passed to [`rsync`](https://download.samba.org/pub/rsync/rsync.html), a fast, versatile file-copying tool. +Extra command-line options passed to [`rsync`](https://download.samba.org/pub/rsync/), a fast, versatile file-copying tool. ## CMake variables and cache @@ -200,11 +215,11 @@ For more information about each of the properties in the file, see [`CMakeSettin ::: moniker-end -## See also +## Related content -[CMake Projects in Visual Studio](cmake-projects-in-visual-studio.md)
-[Configure a Linux CMake project](../linux/cmake-linux-project.md)
-[Connect to your remote Linux computer](../linux/connect-to-your-remote-linux-computer.md)
-[Configure CMake debugging sessions](configure-cmake-debugging-sessions.md)
-[Deploy, run, and debug your Linux project](../linux/deploy-run-and-debug-your-linux-project.md)
-[CMake predefined configuration reference](cmake-predefined-configuration-reference.md) +- [CMake Projects in Visual Studio](cmake-projects-in-visual-studio.md) +- [Configure a Linux CMake project](../linux/cmake-linux-project.md) +- [Connect to your remote Linux computer](../linux/connect-to-your-remote-linux-computer.md) +- [Configure CMake debugging sessions](configure-cmake-debugging-sessions.md) +- [Deploy, run, and debug your Linux project](../linux/deploy-run-and-debug-your-linux-project.md) +- [CMake predefined configuration reference](cmake-predefined-configuration-reference.md) diff --git a/docs/build/determining-which-exporting-method-to-use.md b/docs/build/determining-which-exporting-method-to-use.md index 58d6c4432c2..f34d60e3e3b 100644 --- a/docs/build/determining-which-exporting-method-to-use.md +++ b/docs/build/determining-which-exporting-method-to-use.md @@ -19,7 +19,7 @@ Exporting functions in a .def file gives you control over the export ordinals. W Another advantage to using a .def file is that you can use the `NONAME` attribute to export a function. This puts only the ordinal in the exports table in the DLL. For DLLs that have a large number of exported functions, using the `NONAME` attribute can reduce the size of the DLL file. For information about how to write a module definition statement, see [Rules for Module-Definition Statements](reference/rules-for-module-definition-statements.md). For information about ordinal export, see [Exporting Functions from a DLL by Ordinal Rather Than by Name](exporting-functions-from-a-dll-by-ordinal-rather-than-by-name.md). -A disadvantage of using a .def file is that if you are exporting functions in a C++ file, you either have to put the decorated names in the .def file or define the exported functions by using extern "C" to avoid the name decoration that's done by the MSVC compiler. +A disadvantage of using a .def file is that if you are exporting functions in a C++ file, you either have to put the decorated names in the .def file or define the exported functions by using extern "C" to avoid the name decoration that's done by the Microsoft C++ (MSVC) compiler. If you put the decorated names in the .def file, you can obtain them by using the [DUMPBIN](reference/dumpbin-reference.md) tool or by using the linker [/MAP](reference/map-generate-mapfile.md) option. The decorated names that are produced by the compiler are compiler-specific; therefore, if you put the decorated names that are produced by the compiler into a .def file, the applications that link to the DLL must also be built by using the same version of the compiler so that the decorated names in the calling application match the exported names in the .def file of the DLL. diff --git a/docs/build/dlls-in-visual-cpp.md b/docs/build/dlls-in-visual-cpp.md index a1974a8268a..cf7683b6c21 100644 --- a/docs/build/dlls-in-visual-cpp.md +++ b/docs/build/dlls-in-visual-cpp.md @@ -68,7 +68,7 @@ Describes explicit and implicit linking to a DLL. [Initialize a DLL](run-time-library-behavior.md#initializing-a-dll)\ Discusses DLL initialization code that must execute when your DLL loads. -[DLLs and Visual C++ run-time library behavior](run-time-library-behavior.md)\ +[DLLs and Microsoft C++ run-time library behavior](run-time-library-behavior.md)\ Describes the run-time library DLL startup sequence. [LoadLibrary and AfxLoadLibrary](loadlibrary-and-afxloadlibrary.md)\ diff --git a/docs/build/exception-handling-x64.md b/docs/build/exception-handling-x64.md index 41a6e29b6e4..8e35eb70ffd 100644 --- a/docs/build/exception-handling-x64.md +++ b/docs/build/exception-handling-x64.md @@ -7,7 +7,7 @@ ms.assetid: 41fecd2d-3717-4643-b21c-65dcd2f18c93 --- # x64 exception handling -An overview of structured exception handling and C++ exception handling coding conventions and behavior on the x64. For general information on exception handling, see [Exception Handling in Visual C++](../cpp/exception-handling-in-visual-cpp.md). +An overview of structured exception handling and C++ exception handling coding conventions and behavior on the x64. For general information on exception handling, see [Exception Handling in Microsoft C++](../cpp/exception-handling-in-visual-cpp.md). ## Unwind data for exception handling, debugger support diff --git a/docs/build/exporting-and-importing-using-afx-ext-class.md b/docs/build/exporting-and-importing-using-afx-ext-class.md index 0d16f63d7b8..e47b06663e8 100644 --- a/docs/build/exporting-and-importing-using-afx-ext-class.md +++ b/docs/build/exporting-and-importing-using-afx-ext-class.md @@ -5,6 +5,7 @@ ms.date: "11/04/2016" f1_keywords: ["afx_ext_class"] helpviewer_keywords: ["AFX_EXT_CLASS macro", "exporting classes [C++]", "importing DLLs [C++]", "extension DLLs [C++], exporting classes", "executable files [C++], importing classes", "exporting DLLs [C++], AFX_EXT_CLASS macro"] ms.assetid: 6b72cb2b-e92e-4ecd-bcab-c335e1d1cfde +ms.topic: concept-article --- # Exporting and Importing Using AFX_EXT_CLASS diff --git a/docs/build/exporting-c-functions-for-use-in-c-or-cpp-language-executables.md b/docs/build/exporting-c-functions-for-use-in-c-or-cpp-language-executables.md index 2386881514b..4096be3e6e2 100644 --- a/docs/build/exporting-c-functions-for-use-in-c-or-cpp-language-executables.md +++ b/docs/build/exporting-c-functions-for-use-in-c-or-cpp-language-executables.md @@ -4,6 +4,7 @@ title: "Export C functions for use in C or C++ language executables" ms.date: 05/24/2022 helpviewer_keywords: ["functions [C], exporting", "functions [C], C or C++ executables and", "__cplusplus macro", "exporting DLLs [C++], C functions in C++ executables", "exporting functions [C++], C functions in C++ executables"] ms.assetid: b51d6e5e-37cf-4c1c-b0bf-fcf188c82f00 +ms.topic: how-to --- # Export C functions for use in C or C++ language executables diff --git a/docs/build/exporting-cpp-functions-for-use-in-c-language-executables.md b/docs/build/exporting-cpp-functions-for-use-in-c-language-executables.md index decb3fd8916..d44fe579a36 100644 --- a/docs/build/exporting-cpp-functions-for-use-in-c-language-executables.md +++ b/docs/build/exporting-cpp-functions-for-use-in-c-language-executables.md @@ -4,6 +4,7 @@ title: "Exporting C++ Functions for Use in C-Language Executables" ms.date: "11/04/2016" helpviewer_keywords: ["functions [C++], C++ functions in C executables", "exporting DLLs [C++], C++ functions in C executables", "exporting functions [C++], C++ functions in C executables", "functions [C++], exporting"] ms.assetid: 80b9e982-f52d-4312-a891-f73cc69f3c2b +ms.topic: concept-article --- # Exporting C++ Functions for Use in C-Language Executables diff --git a/docs/build/exporting-from-a-dll-using-declspec-dllexport.md b/docs/build/exporting-from-a-dll-using-declspec-dllexport.md index 46f17afc299..674c52fb8dd 100644 --- a/docs/build/exporting-from-a-dll-using-declspec-dllexport.md +++ b/docs/build/exporting-from-a-dll-using-declspec-dllexport.md @@ -5,6 +5,7 @@ ms.date: "05/06/2019" f1_keywords: ["dllexport"] helpviewer_keywords: ["__declspec(dllexport) keyword [C++]", "names [C++], DLL exports by", "export directives [C++]", "exporting DLLs [C++], __declspec(dllexport) keyword"] ms.assetid: a35e25e8-7263-4a04-bad4-00b284458679 +ms.topic: how-to --- # Exporting from a DLL Using __declspec(dllexport) diff --git a/docs/build/exporting-from-a-dll-using-def-files.md b/docs/build/exporting-from-a-dll-using-def-files.md index c0cabdb87a1..653273a5fe2 100644 --- a/docs/build/exporting-from-a-dll-using-def-files.md +++ b/docs/build/exporting-from-a-dll-using-def-files.md @@ -4,6 +4,7 @@ title: "Exporting from a DLL Using DEF Files" ms.date: "05/06/2019" helpviewer_keywords: ["def files [C++], exporting from DLLs", ".def files [C++], exporting from DLLs", "exporting DLLs [C++], DEF files"] ms.assetid: 9d31eda2-184e-47de-a2ee-a93ebd603f8e +ms.topic: concept-article --- # Exporting from a DLL Using DEF Files @@ -28,7 +29,7 @@ EXPORTS If you use the [MFC DLL Wizard](../mfc/reference/mfc-dll-wizard.md) to create an MFC DLL, the wizard creates a skeleton DEF file for you and automatically adds it to your project. Add the names of the functions to be exported to this file. For non-MFC DLLs, create the DEF file yourself and add it to your project. Then go to **Project** > **Properties** > **Linker** > **Input** > **Module Definition File** and enter the name of the DEF file. Repeat this step for each configuration and platform, or do it all at once by selecting **Configuration = All Configurations**, and **Platform = All Platforms**. -If you are exporting functions in a C++ file, you have to either place the decorated names in the DEF file or define your exported functions with standard C linkage by using extern "C". If you need to place the decorated names in the DEF file, you can obtain them by using the [DUMPBIN](../build/reference/dumpbin-reference.md) tool or by using the linker [/MAP](../build/reference/map-generate-mapfile.md) option. Note that the decorated names produced by the compiler are compiler specific. If you place the decorated names produced by the Microsoft C++ compiler (MSVC) into a DEF file, applications that link to your DLL must also be built using the same version of MSVC so that the decorated names in the calling application match the exported names in the DLL's DEF file. +If you are exporting functions in a C++ file, you have to either place the decorated names in the DEF file or define your exported functions with standard C linkage by using extern "C". If you need to place the decorated names in the DEF file, you can obtain them by using the [DUMPBIN](../build/reference/dumpbin-reference.md) tool or by using the linker [/MAP](../build/reference/map-generate-mapfile.md) option. Note that the decorated names produced by the compiler are compiler specific. If you place the decorated names produced by the Microsoft C++ (MSVC) compiler into a DEF file, applications that link to your DLL must also be built using the same version of MSVC so that the decorated names in the calling application match the exported names in the DLL's DEF file. > [!NOTE] > A DLL built with Visual Studio 2015 can be consumed by applications built with Visual Studio 2017 or Visual Studio 2019. diff --git a/docs/build/exporting-from-a-dll.md b/docs/build/exporting-from-a-dll.md index b05991ac322..d7513fc4776 100644 --- a/docs/build/exporting-from-a-dll.md +++ b/docs/build/exporting-from-a-dll.md @@ -4,6 +4,7 @@ title: "Exporting from a DLL" ms.date: "11/04/2016" helpviewer_keywords: ["exporting DLLs [C++], about exporting from DLLs", "exporting functions [C++], DLLs (exporting from)", "exporting DLLs [C++]", "DLLs [C++], exporting from", "DLL exports [C++]", "functions [C++], exporting", "exports table [C++]"] ms.assetid: a08f86c4-5996-460b-ae54-da2b764045f0 +ms.topic: concept-article --- # Exporting from a DLL diff --git a/docs/build/exporting-functions-from-a-dll-by-ordinal-rather-than-by-name.md b/docs/build/exporting-functions-from-a-dll-by-ordinal-rather-than-by-name.md index 1a3e10eeaeb..d5911954fb9 100644 --- a/docs/build/exporting-functions-from-a-dll-by-ordinal-rather-than-by-name.md +++ b/docs/build/exporting-functions-from-a-dll-by-ordinal-rather-than-by-name.md @@ -4,6 +4,7 @@ title: "Exporting Functions from a DLL by Ordinal Rather Than by Name" ms.date: "11/04/2016" helpviewer_keywords: ["exporting functions [C++], ordinal values", "ordinal exports [C++]", "exporting DLLs [C++], ordinal values", "NONAME attribute"] ms.assetid: 679719fd-d965-4df3-9f7a-7d86ad831702 +ms.topic: concept-article --- # Exporting Functions from a DLL by Ordinal Rather Than by Name diff --git a/docs/build/extension-dlls-overview.md b/docs/build/extension-dlls-overview.md index 9efaa880faa..b43f909510c 100644 --- a/docs/build/extension-dlls-overview.md +++ b/docs/build/extension-dlls-overview.md @@ -4,6 +4,7 @@ title: "Extension DLLs: Overview" ms.date: "05/06/2019" helpviewer_keywords: ["AFXDLL library", "MFC DLLs [C++], MFC extension DLLs", "DLLs [C++], extension", "shared DLL versions [C++]", "extension DLLs [C++], about MFC extension DLLs"] ms.assetid: eb5e10b7-d615-4bc7-908d-e3e99b7b1d5f +ms.topic: concept-article --- # MFC extension DLLs: Overview diff --git a/docs/build/fixing-release-build-problems.md b/docs/build/fixing-release-build-problems.md index b329363dc97..f10be40f3e4 100644 --- a/docs/build/fixing-release-build-problems.md +++ b/docs/build/fixing-release-build-problems.md @@ -4,6 +4,7 @@ title: "Fixing Release Build Problems" ms.date: "11/04/2016" helpviewer_keywords: ["release builds, troubleshooting", "debug builds, memory overwrites", "memory, overwrites", "troubleshooting Visual C++, release builds", "troubleshooting release builds"] ms.assetid: a0c0818e-4c47-4fe0-a611-50d61a41bd88 +ms.topic: concept-article --- # Fixing Release Build Problems diff --git a/docs/build/formatting-the-output-of-a-custom-build-step-or-build-event.md b/docs/build/formatting-the-output-of-a-custom-build-step-or-build-event.md index 938dc064259..b8c2ff6f181 100644 --- a/docs/build/formatting-the-output-of-a-custom-build-step-or-build-event.md +++ b/docs/build/formatting-the-output-of-a-custom-build-step-or-build-event.md @@ -4,6 +4,7 @@ title: "Formatting the output of a custom build step or build event" ms.date: 03/15/2022 helpviewer_keywords: ["builds [C++], build events", "custom build steps [C++], output format", "events [C++], build", "build events [C++], output format", "build steps [C++], output format", "builds [C++], custom build steps"] ms.assetid: 92ad3e38-24d7-4b89-90e6-5a16f5f998da +ms.topic: concept-article --- # Formatting the output of a custom build step or build event diff --git a/docs/build/get-started-linux-cmake.md b/docs/build/get-started-linux-cmake.md index 44cc20cf602..b2f59a73810 100644 --- a/docs/build/get-started-linux-cmake.md +++ b/docs/build/get-started-linux-cmake.md @@ -3,6 +3,7 @@ title: Create C++ cross-platform projects in Visual Studio description: "How to set up, compile, and debug a C++ open-source CMake project in Visual Studio that targets both Linux and Windows." ms.topic: tutorial ms.date: 02/07/2022 +ms.custom: sfi-image-nochange --- # Tutorial: Create C++ cross-platform projects in Visual Studio @@ -187,7 +188,7 @@ Because it's a desktop application, you need to provide some more configuration 1. Look at the Call Stack window and view the Calls to `x11OpenGLWindow` since Visual Studio launched the application on Linux. - :::image type="complex" source="media/cmake-bullet3-linux-console.png" alt-text="The Visual Studio Call Stack window, showing Linux call stack."::: + :::image type="complex" source="media/cmake-bullet3-linux-callstack.png" alt-text="The Visual Studio Call Stack window, showing Linux call stack."::: The callstack shows the breakpoint on CommonRigidBodyBase::mouseMoveCallback, and the calls that precede it such as OnMouseMove, X11OpenGLWindow::pumpMessage, and so on. :::image-end::: diff --git a/docs/build/how-to-debug-a-release-build.md b/docs/build/how-to-debug-a-release-build.md index bb260ccf93e..3063cfc32b2 100644 --- a/docs/build/how-to-debug-a-release-build.md +++ b/docs/build/how-to-debug-a-release-build.md @@ -1,31 +1,27 @@ --- description: "Learn more about: How to: Debug a Release Build" title: "How to: Debug a Release Build" -ms.date: "11/04/2016" +ms.date: 03/14/2025 helpviewer_keywords: ["debugging [C++], release builds", "release builds, debugging"] -ms.assetid: d333e4d1-4e6c-4384-84a9-cb549702da25 --- # How to: Debug a Release Build -You can debug a release build of an application. +This article explains which compiler and linker switches to set to enable you to debug a release build of an application. -### To debug a release build +A better experience is available starting in Visual Studio 2022 version 17.14 that allows you to debug optimized code as if it were compiled unoptimized, while retaining the speed of optimized code. For more information, see [C++ Dynamic Debugging (Preview)](/visualstudio/debugger/cpp-dynamic-debugging). -1. Open the **Property Pages** dialog box for the project. For details, see [Set C++ compiler and build properties in Visual Studio](working-with-project-properties.md). +## To debug a release build +1. Open the **Property Pages** dialog box for the project. For details, see [Set C++ compiler and build properties in Visual Studio](working-with-project-properties.md). 1. Click the **C/C++** node. Set **Debug Information Format** to [C7 compatible (/Z7)](reference/z7-zi-zi-debug-information-format.md) or **Program Database (/Zi)**. - 1. Expand **Linker** and click the **General** node. Set **Enable Incremental Linking** to [No (/INCREMENTAL:NO)](reference/incremental-link-incrementally.md). - -1. Select the **Debugging** node. Set **Generate Debug Info** to [Yes (/DEBUG)](reference/debug-generate-debug-info.md). - -1. Select the **Optimization** node. Set **References** to [/OPT:REF](reference/opt-optimizations.md) and **Enable COMDAT Folding** to [/OPT:ICF](reference/opt-optimizations.md). - +1. Under **Linker**, select the **Debugging** node. Set **Generate Debug Info** to [Yes (/DEBUG)](reference/debug-generate-debug-info.md). +1. Under **Linker**, select the **Optimization** node. Set **References** to [No (/OPT:NOREF)](reference/opt-optimizations.md) and **Enable COMDAT Folding** to [No (/OPT:NOICF)](reference/opt-optimizations.md). 1. You can now debug your release build application. To find a problem, step through the code (or use Just-In-Time debugging) until you find where the failure occurs, and then determine the incorrect parameters or code. If an application works in a debug build, but fails in a release build, one of the compiler optimizations may be exposing a defect in the source code. To isolate the problem, disable selected optimizations for each source code file until you locate the file and the optimization that is causing the problem. (To expedite the process, you can divide the files into two groups, disable optimization on one group, and when you find a problem in a group, continue dividing until you isolate the problem file.) - You can use [/RTC](reference/rtc-run-time-error-checks.md) to try to expose such bugs in your debug builds. + Use [/RTC](reference/rtc-run-time-error-checks.md) to try to expose such bugs in your debug builds. For more information, see [Optimizing Your Code](optimizing-your-code.md). diff --git a/docs/build/how-to-enable-a-64-bit-visual-cpp-toolset-on-the-command-line.md b/docs/build/how-to-enable-a-64-bit-visual-cpp-toolset-on-the-command-line.md index 4e5fb870095..e551b430faf 100644 --- a/docs/build/how-to-enable-a-64-bit-visual-cpp-toolset-on-the-command-line.md +++ b/docs/build/how-to-enable-a-64-bit-visual-cpp-toolset-on-the-command-line.md @@ -27,7 +27,7 @@ Any of the native or cross compiler tools build configurations can be used on th > [!NOTE] > For information about the specific tools that are included with each Visual Studio edition, see [Visual C++ Tools and Features in Visual Studio Editions](../overview/visual-cpp-tools-and-features-in-visual-studio-editions.md). > -> For information about how to use the Visual Studio IDE to create 64-bit applications, see [How to: Configure Visual C++ Projects to Target 64-Bit, x64 Platforms](how-to-configure-visual-cpp-projects-to-target-64-bit-platforms.md). +> For information about how to use the Visual Studio IDE to create 64-bit applications, see [How to: Configure Microsoft C++ Projects to Target 64-Bit, x64 Platforms](how-to-configure-visual-cpp-projects-to-target-64-bit-platforms.md). When you install a C++ workload in the Visual Studio installer, it always installs 32-bit, x86-hosted, native and cross compiler tools to build x86 and x64 code. If you include the Universal Windows Platform workload, it also installs x86-hosted cross compiler tools to build ARM code. If you install these workloads on a 64-bit, x64 processor, you also get 64-bit native and cross compiler tools to build x86, x64, and ARM code. The 32-bit and 64-bit tools generate identical code, but the 64-bit tools support more memory for precompiled header symbols and the Whole Program Optimization ([/GL](reference/gl-whole-program-optimization.md) and [/LTCG](reference/ltcg-link-time-code-generation.md)) options. If you run into memory limits when you use the 32-bit tools, try the 64-bit tools. diff --git a/docs/build/how-to-modify-the-target-framework-and-platform-toolset.md b/docs/build/how-to-modify-the-target-framework-and-platform-toolset.md index 8bf4c683025..3c80c787b4a 100644 --- a/docs/build/how-to-modify-the-target-framework-and-platform-toolset.md +++ b/docs/build/how-to-modify-the-target-framework-and-platform-toolset.md @@ -10,7 +10,7 @@ You can edit a Visual Studio C++ project file to target different versions of th ## Platform toolset -The platform toolset consists of the C++ compiler (cl.exe) and linker (link.exe), along with the C/C++ standard libraries. Visual Studio 2015, Visual Studio 2017, and Visual Studio 2019 are binary-compatible. It's shown by the major version of the toolset, which has remained at 14. Projects compiled in Visual Studio 2019 or Visual Studio 2017 are ABI-backwards-compatible with 2017 and 2015 projects. The minor version has updated by 1 for each version since Visual Studio 2015: +The platform toolset consists of the Microsoft C++ (MSVC) compiler (cl.exe) and linker (link.exe), along with the C/C++ standard libraries. Visual Studio 2015, Visual Studio 2017, and Visual Studio 2019 are binary-compatible. It's shown by the major version of the toolset, which has remained at 14. Projects compiled in Visual Studio 2019 or Visual Studio 2017 are ABI-backwards-compatible with 2017 and 2015 projects. The minor version has updated by 1 for each version since Visual Studio 2015: - Visual Studio 2015: v140 - Visual Studio 2017: v141 @@ -23,9 +23,9 @@ Visual Studio also supports multitargeting for C++ projects. You can use the lat ## Target framework (C++/CLI project only) -When you change the target Framework, also change the platform toolset to a version that supports that Framework. For example, to target the .NET Framework 4.5, you must use a compatible platform toolset. These toolsets include Visual Studio 2015 (v140), Visual Studio 2013 (v120), or Visual Studio 2012 (v110). You can use the [Windows 7.1 SDK](https://www.microsoft.com/download/details.aspx?id=8279) to target .NET Framework 2.0, 3.0, 3.5, and 4. +When you change the target Framework, also change the platform toolset to a version that supports that Framework. For example, to target the .NET Framework 4.5, you must use a compatible platform toolset. These toolsets include Visual Studio 2015 (v140), Visual Studio 2013 (v120), or Visual Studio 2012 (v110). You can use the [Windows 7.1 SDK](https://www.microsoft.com/en-us/download/details.aspx?id=8442) to target .NET Framework 2.0, 3.0, 3.5, and 4. -You can extend the target platform further by creating a custom platform toolset. For more information, see [C++ Native Multi-Targeting](https://devblogs.microsoft.com/cppblog/c-native-multi-targeting/) on the Visual C++ blog. +You can extend the target platform further by creating a custom platform toolset. For more information, see [C++ Native Multi-Targeting](https://devblogs.microsoft.com/cppblog/c-native-multi-targeting/) on the Microsoft C++ Team blog. ### To change the target Framework diff --git a/docs/build/how-to-use-build-events-in-msbuild-projects.md b/docs/build/how-to-use-build-events-in-msbuild-projects.md index c747397334d..72aea3d96ac 100644 --- a/docs/build/how-to-use-build-events-in-msbuild-projects.md +++ b/docs/build/how-to-use-build-events-in-msbuild-projects.md @@ -1,9 +1,8 @@ --- -description: "Learn more about: How to: Use Build Events in MSBuild Projects" title: "How to: Use Build Events in MSBuild Projects" +description: "Learn more about: How to: Use Build Events in MSBuild Projects" ms.date: "11/04/2016" helpviewer_keywords: ["msbuild (c++), howto: use build events in projects"] -ms.assetid: 2a58dc9d-3d50-4e49-97c1-86c5a05ce218 --- # How to: Use Build Events in MSBuild Projects @@ -33,7 +32,7 @@ The following table lists each *use-in-build* element: The following example can be added inside of the Project element of the myproject.vcxproj file created in [Walkthrough: Using MSBuild to Create a C++ Project](walkthrough-using-msbuild-to-create-a-visual-cpp-project.md). A *pre-build* event makes a copy of main.cpp; a *pre-link* event makes a copy of main.obj; and a *post-build* event makes a copy of myproject.exe. If the project is built using a release configuration, the build events are executed. If the project is built using a debug configuration, the build events are not executed. -``` xml +```xml copy $(ProjectDir)main.cpp $(ProjectDir)copyOfMain.cpp @@ -64,5 +63,5 @@ The following example can be added inside of the Project element of the myprojec ## See also -[MSBuild on the command line - C++](msbuild-visual-cpp.md)
+[MSBuild on the command line - C++](msbuild-visual-cpp.md)\ [Walkthrough: Using MSBuild to Create a C++ Project](walkthrough-using-msbuild-to-create-a-visual-cpp-project.md) diff --git a/docs/build/image.png b/docs/build/image.png new file mode 100644 index 00000000000..f892839fa3f Binary files /dev/null and b/docs/build/image.png differ diff --git a/docs/build/importing-and-exporting-inline-functions.md b/docs/build/importing-and-exporting-inline-functions.md index ec71f01e74a..c34b0859a15 100644 --- a/docs/build/importing-and-exporting-inline-functions.md +++ b/docs/build/importing-and-exporting-inline-functions.md @@ -4,6 +4,7 @@ title: "Importing and exporting inline functions" ms.date: "11/04/2016" helpviewer_keywords: ["exporting functions [C++], inline functions", "inline functions [C++], importing", "DLLs [C++], importing", "importing functions [C++]", "DLLs [C++], exporting from", "importing inline functions [C++]", "inline functions [C++], exporting", "functions [C++], importing", "functions [C++], exporting"] ms.assetid: 89f488f8-b078-40fe-afd7-80bd7840057b +ms.topic: concept-article --- # Importing and exporting inline functions diff --git a/docs/build/importing-and-exporting.md b/docs/build/importing-and-exporting.md index 322232d23b8..87ecffe0203 100644 --- a/docs/build/importing-and-exporting.md +++ b/docs/build/importing-and-exporting.md @@ -4,6 +4,7 @@ title: "Importing and Exporting" ms.date: "05/06/2019" helpviewer_keywords: ["DLLs [C++], importing", "exporting DLLs [C++]", "importing DLLs [C++]", "DLLs [C++], exporting from", "__declspec(dllimport) keyword [C++]"] ms.assetid: 7c44c2aa-2117-4cec-9615-a65bfd3f8f7b +ms.topic: concept-article --- # Importing and Exporting diff --git a/docs/build/importing-data-using-declspec-dllimport.md b/docs/build/importing-data-using-declspec-dllimport.md index bfe281afe38..eeec7bf2ffe 100644 --- a/docs/build/importing-data-using-declspec-dllimport.md +++ b/docs/build/importing-data-using-declspec-dllimport.md @@ -4,6 +4,7 @@ description: "How to use __declspec(dllimport) to import DLL data." ms.date: 09/03/2020 helpviewer_keywords: ["importing data [C++]", "dllimport attribute [C++], data imports", "__declspec(dllimport) keyword [C++]", "importing DLLs [C++], __declspec(dllimport)"] ms.assetid: 0ae70b39-87c7-4181-8be9-e786e0db60b0 +ms.topic: concept-article --- # Importing data using `__declspec(dllimport)` diff --git a/docs/build/importing-function-calls-using-declspec-dllimport.md b/docs/build/importing-function-calls-using-declspec-dllimport.md index e275b0ec866..4d4472780a7 100644 --- a/docs/build/importing-function-calls-using-declspec-dllimport.md +++ b/docs/build/importing-function-calls-using-declspec-dllimport.md @@ -4,6 +4,7 @@ description: "How and why to use __declspec(dllimport) when calling DLL data and ms.date: "05/03/2020" helpviewer_keywords: ["importing function calls [C++]", "dllimport attribute [C++], function call imports", "__declspec(dllimport) keyword [C++]", "function calls [C++], importing"] ms.assetid: 6b53c616-0c6d-419a-8e2a-d2fff20510b3 +ms.topic: concept-article --- # Importing function calls using `__declspec(dllimport)` diff --git a/docs/build/importing-into-an-application-using-declspec-dllimport.md b/docs/build/importing-into-an-application-using-declspec-dllimport.md index 7b8247460ee..c50718d79d0 100644 --- a/docs/build/importing-into-an-application-using-declspec-dllimport.md +++ b/docs/build/importing-into-an-application-using-declspec-dllimport.md @@ -4,6 +4,7 @@ title: "Import into an application using __declspec(dllimport)" ms.date: "11/04/2016" helpviewer_keywords: ["__declspec(dllimport) keyword [C++]", "importing DLLs [C++], __declspec(dllimport)"] ms.assetid: edb4da4e-f83a-44cf-a668-9239d49dbe42 +ms.topic: how-to --- # Import into an application using __declspec(dllimport) diff --git a/docs/build/importing-into-an-application.md b/docs/build/importing-into-an-application.md index f2458e128f9..c944f53c123 100644 --- a/docs/build/importing-into-an-application.md +++ b/docs/build/importing-into-an-application.md @@ -4,6 +4,7 @@ title: "Importing into an Application" ms.date: "11/04/2016" helpviewer_keywords: ["DLLs [C++], importing", "importing DLLs [C++], applications", "applications [C++], importing into"] ms.assetid: 9d646466-e12e-4710-8ad9-c819c0375fcc +ms.topic: concept-article --- # Importing into an Application diff --git a/docs/build/importing-using-def-files.md b/docs/build/importing-using-def-files.md index e52767c7695..f8cd00daca4 100644 --- a/docs/build/importing-using-def-files.md +++ b/docs/build/importing-using-def-files.md @@ -4,6 +4,7 @@ title: "Importing Using DEF Files" ms.date: "11/04/2016" helpviewer_keywords: ["importing DLLs [C++], DEF files", "def files [C++], importing with", ".def files [C++], importing with", "dllimport attribute [C++], DEF files", "DLLs [C++], DEF files"] ms.assetid: aefdbf50-f603-488a-b0d7-ed737bae311d +ms.topic: concept-article --- # Importing Using DEF Files @@ -49,7 +50,7 @@ if (ulDataInDll == 0L) /*sample code fragment*/ Using CONSTANT is more risky because if you forget to use the extra level of indirection, you could potentially access the import address table's pointer to the variable — not the variable itself. This type of problem can often manifest as an access violation because the import address table is currently made read-only by the compiler and linker. -The current MSVC linker issues a warning if it sees CONSTANT in the .def file to account for this case. The only real reason to use CONSTANT is if you cannot recompile some object file where the header file did not list **`__declspec(dllimport)`** on the prototype. +The current Microsoft C++ (MSVC) linker issues a warning if it sees CONSTANT in the .def file to account for this case. The only real reason to use CONSTANT is if you cannot recompile some object file where the header file did not list **`__declspec(dllimport)`** on the prototype. ## See also diff --git a/docs/build/improving-compiler-throughput.md b/docs/build/improving-compiler-throughput.md index c71675de078..3da2de62fc5 100644 --- a/docs/build/improving-compiler-throughput.md +++ b/docs/build/improving-compiler-throughput.md @@ -4,6 +4,7 @@ title: "Improving Compiler Throughput" ms.date: "11/04/2016" helpviewer_keywords: ["throughput, C++ compiler", "cl.exe compiler, performance", "performance, compiler", "cl.exe compiler, throughput"] ms.assetid: ba5f884e-9037-4a92-b10e-fc2a3836c5bf +ms.topic: concept-article --- # Improving Compiler Throughput diff --git a/docs/build/launch-vs-schema-reference-cpp.md b/docs/build/launch-vs-schema-reference-cpp.md index 1140ae533d4..e7d4f24ef18 100644 --- a/docs/build/launch-vs-schema-reference-cpp.md +++ b/docs/build/launch-vs-schema-reference-cpp.md @@ -17,7 +17,7 @@ To create the file, right-click on an executable file in **Solution Explorer** a | `args` | array | Specifies the command-line arguments passed to the launched program. | | `buildConfigurations` | array | A key-value pair that specifies the name of the build mode to apply the configurations. For example, `Debug` or `Release` and the configurations to use according to the selected build mode. | | `currentDir` | string | Specifies the full directory path to the Build Target. The directory is detected automatically unless this parameter is set. | -| `cwd` | string | Full path to the directory on the remote system where the program will run. Defaults to `"${debugInfo.defaultWorkingDirectory}"` | +| `cwd` | string | Full path to the directory on the remote system where the program will run. Defaults to `"${debugInfo.defaultWorkingDirectory}"`. | | `debugType` | string | Specifies the debugging mode according to the type of code (native, managed, or mixed). The mode is automatically detected unless this parameter is set. Allowed values: `"native"`, `"managed"`, `"mixed"`. | | `env` | array | Specifies a key-value list of custom environment variables. For example: `env:{"myEnv":"myVal"}`. | | `inheritEnvironments` | array | Specifies a set of environment variables inherited from multiple sources. You can define some variables in files like *`CMakeSettings.json`* or *`CppProperties.json`* and make them available to debug context. **Visual Studio 16.4:** Specify environment variables on a per-target basis using the `env.VARIABLE_NAME` syntax. To unset a variable, set it to `"null"`. | @@ -27,9 +27,9 @@ To create the file, right-click on an executable file in **Solution Explorer** a | `program` | string | The debug command to execute. Defaults to `"${debugInfo.fullTargetPath}"`. | | `project` | string | Specifies the relative path to the project file. Normally, you don't need to change this value when debugging a CMake project. | | `projectTarget` | string | Specifies the optional target invoked when building `project`. The target must match the name in the **Startup Item** dropdown. | -| `stopOnEntry` | boolean | Specifies whether to break a soon as the process is launched and the debugger attaches. The default value for this parameter is **`false`**. | +| `stopOnEntry` | boolean | Specifies whether to break as soon as the process is launched and the debugger attaches. The default value for this parameter is **`false`**. | | `remoteMachine` | string | Specifies the name of the remote machine where the program is launched. | -| `type` | string | Specifies whether the project is a `dll` or `exe` Defaults to .exe | +| `type` | string | Specifies whether the project is a `dll` or `exe`. Defaults to `"exe"`. | ## C++ Linux properties @@ -55,7 +55,7 @@ To create the file, right-click on an executable file in **Solution Explorer** a | `debugServerArgs` | string | Optional debug server args. Defaults to null. | | `filterStderr` | boolean | Search stderr stream for server-started pattern and log stderr to debug output. Defaults to **`false`**. | | `coreDumpPath` | string | Optional full path to a core dump file for the specified program. Defaults to null. | -| externalConsole | boolean | If true, a console is launched for the debuggee. If **`false`**, no console is launched. The default for this setting is **`false`**. This option is ignored in some cases for technical reasons. | +| `externalConsole` | boolean | If true, a console is launched for the debuggee. If **`false`**, no console is launched. The default for this setting is **`false`**. This option is ignored in some cases for technical reasons. | | `pipeTransport` | string | When present, this value tells the debugger to connect to a remote computer using another executable as a pipe that will relay standard input/output between Visual Studio and the MI-enabled debugger (such as gdb). Allowed values: one or more [Pipe Transport Options](#pipe_transport_options). | ## debugInfo macros @@ -64,7 +64,7 @@ The following macros provide information about the debugging environment. They'r | Macro | Description | Example | |--|--|--| -| `addressSanitizerRuntimeFlags` | Runtime flags used to customize behavior of the address sanitizer. Used to set the environment variable `"ASAN_OPTIONS"`. | `"env": {"ASAN_OPTIONS": "${addressSanitizerRuntimeFlags}:anotherFlag=true"`} | +| `addressSanitizerRuntimeFlags` | Runtime flags used to customize behavior of the address sanitizer. Used to set the environment variable `"ASAN_OPTIONS"`. | `"env": {"ASAN_OPTIONS": "${addressSanitizerRuntimeFlags}:anotherFlag=true"}` | | `defaultWorkingDirectory` | Set to the directory part of `"fullTargetPath"`. If the CMake variable `VS_DEBUGGER_WORKING_DIRECTORY` is defined, then `defaultWorkingDirectory` is set to that value, instead. | `"cwd":"${debugInfo.defaultWorkingDirectory}"` | | `fullTargetPath` | The full path to the binary being debugged. | `"program": "${debugInfo.fullTargetPath}"` | | `linuxNatvisPath` | The full windows path to the VS linux `.natvis` file. Usually appears as the value `"visualizerFile"`. | | @@ -98,7 +98,7 @@ The pipeTransport example below shows how to use some of the `debugInfo` macros "/c", "${debuggerCommand}" ] - } +} ``` ## C++ Windows remote debug and deploy properties @@ -109,8 +109,8 @@ Used when debugging and deploying an app on a remote machine. |--|--|--| | `cwd` | string | The working directory of the target on the remote machine. When using CMake, the macro `${debugInfo.defaultWorkingDirectory}` can be used as the value of this field. The default value is the directory of the debug program/command. | | `deploy` | string | Specifies extra files or directories to deploy. For example:
`"deploy": {"sourcePath":"", "targetPath":""}` | -| `deployDirectory` | string | The location on the remote machine where project outputs are automatically deployed to. Defaults to "`C:\Windows Default Deploy Directory\` | -| `deployDebugRuntimeLibraries` | string | Specifies whether to deploy the debug runtime libraries for the active platform. Defaults to `"true"` if the active configurationType is `"Debug"` | +| `deployDirectory` | string | The location on the remote machine where project outputs are automatically deployed to. Defaults to `"C:\Windows Default Deploy Directory\"`. | +| `deployDebugRuntimeLibraries` | string | Specifies whether to deploy the debug runtime libraries for the active platform. Defaults to `"true"` if the active configurationType is `"Debug"`. | | `deployRuntimeLibraries` | string | Specifies whether to deploy the runtime libraries for the active platform. Defaults to `"true"` if the active configurationType is `"MinSizeRel"`, `"RelWithDebInfo"`, or `"Release"`. | | `disableDeploy` | boolean | Specifies whether files should be deployed. | | `remoteMachineName` | string | Specifies the name of the remote ARM64 Windows machine where the program is launched. May be the server name or the remote machine's IP address. | diff --git a/docs/build/media/cmake-build-errors.png b/docs/build/media/cmake-build-errors.png index 089db013a3a..80127fdebdb 100644 Binary files a/docs/build/media/cmake-build-errors.png and b/docs/build/media/cmake-build-errors.png differ diff --git a/docs/build/media/cmake-cmakelists-error.png b/docs/build/media/cmake-cmakelists-error.png index 6601ecbed34..5c0877845bb 100644 Binary files a/docs/build/media/cmake-cmakelists-error.png and b/docs/build/media/cmake-cmakelists-error.png differ diff --git a/docs/build/media/cmake-cmakelists.png b/docs/build/media/cmake-cmakelists.png index f957bb6c1d5..58f47297791 100644 Binary files a/docs/build/media/cmake-cmakelists.png and b/docs/build/media/cmake-cmakelists.png differ diff --git a/docs/build/media/cmake-install-2022.png b/docs/build/media/cmake-install-2022.png new file mode 100644 index 00000000000..870db48e1c9 Binary files /dev/null and b/docs/build/media/cmake-install-2022.png differ diff --git a/docs/build/media/cmake-targets-view2.png b/docs/build/media/cmake-targets-view2.png index 04ae1e2a13e..673ddd555bf 100644 Binary files a/docs/build/media/cmake-targets-view2.png and b/docs/build/media/cmake-targets-view2.png differ diff --git a/docs/build/media/desktop-app-project-run-150.gif b/docs/build/media/desktop-app-project-run-150.gif deleted file mode 100644 index a46faeb9477..00000000000 Binary files a/docs/build/media/desktop-app-project-run-150.gif and /dev/null differ diff --git a/docs/build/media/desktop-development-cpp-workload.png b/docs/build/media/desktop-development-cpp-workload.png new file mode 100644 index 00000000000..a321200feb5 Binary files /dev/null and b/docs/build/media/desktop-development-cpp-workload.png differ diff --git a/docs/build/media/github-copilot-fix-warning-accept.png b/docs/build/media/github-copilot-fix-warning-accept.png new file mode 100644 index 00000000000..bb8f3ded876 Binary files /dev/null and b/docs/build/media/github-copilot-fix-warning-accept.png differ diff --git a/docs/build/media/github-copilot-fix-warning.png b/docs/build/media/github-copilot-fix-warning.png new file mode 100644 index 00000000000..4751bafdf01 Binary files /dev/null and b/docs/build/media/github-copilot-fix-warning.png differ diff --git a/docs/build/media/github-copilot-open-chat.png b/docs/build/media/github-copilot-open-chat.png new file mode 100644 index 00000000000..c89019f9abc Binary files /dev/null and b/docs/build/media/github-copilot-open-chat.png differ diff --git a/docs/build/media/life-exe.png b/docs/build/media/life-exe.png new file mode 100644 index 00000000000..94bad16e7d6 Binary files /dev/null and b/docs/build/media/life-exe.png differ diff --git a/docs/build/media/options-configuration-file.png b/docs/build/media/options-configuration-file.png new file mode 100644 index 00000000000..2a22a033a17 Binary files /dev/null and b/docs/build/media/options-configuration-file.png differ diff --git a/docs/build/media/visual-c---project-defaults.png b/docs/build/media/visual-c---project-defaults.png index 3b3db949ce5..659946ac9c2 100644 Binary files a/docs/build/media/visual-c---project-defaults.png and b/docs/build/media/visual-c---project-defaults.png differ diff --git a/docs/build/media/visual-c---property-pages-showing-active-configuration.png b/docs/build/media/visual-c---property-pages-showing-active-configuration.png index 57e12a44190..521ba2fec9d 100644 Binary files a/docs/build/media/visual-c---property-pages-showing-active-configuration.png and b/docs/build/media/visual-c---property-pages-showing-active-configuration.png differ diff --git a/docs/build/media/visual-c---property-pages-showing-release-config.png b/docs/build/media/visual-c---property-pages-showing-release-config.png index 763a22945ab..39ff39170dc 100644 Binary files a/docs/build/media/visual-c---property-pages-showing-release-config.png and b/docs/build/media/visual-c---property-pages-showing-release-config.png differ diff --git a/docs/build/media/visual-studio-switch-cmake-targets-view.png b/docs/build/media/visual-studio-switch-cmake-targets-view.png new file mode 100644 index 00000000000..781528af193 Binary files /dev/null and b/docs/build/media/visual-studio-switch-cmake-targets-view.png differ diff --git a/docs/build/media/vscpp-quickstart-first-run.gif b/docs/build/media/vscpp-quickstart-first-run.gif deleted file mode 100644 index 10d887cbcb4..00000000000 Binary files a/docs/build/media/vscpp-quickstart-first-run.gif and /dev/null differ diff --git a/docs/build/modify-project-properties-without-changing-project-file.md b/docs/build/modify-project-properties-without-changing-project-file.md index aebbc2c0f77..3cba0d0efad 100644 --- a/docs/build/modify-project-properties-without-changing-project-file.md +++ b/docs/build/modify-project-properties-without-changing-project-file.md @@ -3,6 +3,7 @@ description: "Learn more about: How to: Modify C++ project properties and target title: "How to: Modify C++ project properties and targets without changing the project file" ms.date: "7/28/2023" helpviewer_keywords: ["project properties [C++], modifying outside project file"] +ms.topic: how-to --- # How to: Modify C++ project properties and targets without changing the project file diff --git a/docs/build/msbuild-visual-cpp.md b/docs/build/msbuild-visual-cpp.md index 0066c81f6d9..858b524a7e4 100644 --- a/docs/build/msbuild-visual-cpp.md +++ b/docs/build/msbuild-visual-cpp.md @@ -44,7 +44,7 @@ Lists the MSBuild XML Schema elements, together with their attributes, and paren Describes the command-line arguments and options that you can use with msbuild.exe. - [Task Reference](/visualstudio/msbuild/msbuild-task-reference) -Describes MSBuild tasks. Especially note these tasks, which are specific to Visual C++: [BscMake Task](/visualstudio/msbuild/bscmake-task), [CL Task](/visualstudio/msbuild/cl-task), [CPPClean Task](/visualstudio/msbuild/cppclean-task), [LIB Task](/visualstudio/msbuild/lib-task), [Link Task](/visualstudio/msbuild/link-task), [MIDL Task](/visualstudio/msbuild/midl-task), [MT Task](/visualstudio/msbuild/mt-task), [RC Task](/visualstudio/msbuild/rc-task), [SetEnv Task](/visualstudio/msbuild/setenv-task), [VCMessage Task](/visualstudio/msbuild/vcmessage-task) +Describes MSBuild tasks. Especially note these tasks, which are specific to Microsoft C++: [BscMake Task](/visualstudio/msbuild/bscmake-task), [CL Task](/visualstudio/msbuild/cl-task), [CPPClean Task](/visualstudio/msbuild/cppclean-task), [LIB Task](/visualstudio/msbuild/lib-task), [Link Task](/visualstudio/msbuild/link-task), [MIDL Task](/visualstudio/msbuild/midl-task), [MT Task](/visualstudio/msbuild/mt-task), [RC Task](/visualstudio/msbuild/rc-task), [SetEnv Task](/visualstudio/msbuild/setenv-task), [VCMessage Task](/visualstudio/msbuild/vcmessage-task) ## In This Section diff --git a/docs/build/non-mfc-dlls-overview.md b/docs/build/non-mfc-dlls-overview.md index f77fbcf3057..ff377f90b10 100644 --- a/docs/build/non-mfc-dlls-overview.md +++ b/docs/build/non-mfc-dlls-overview.md @@ -4,6 +4,7 @@ title: "Non-MFC DLLs: Overview" ms.date: "11/04/2016" helpviewer_keywords: ["non-MFC DLLs [C++]", "DLLs [C++], non-MFC"] ms.assetid: 1ed5d1ee-e20c-47d7-801d-87ea26a73842 +ms.topic: concept-article --- # Non-MFC DLLs: Overview diff --git a/docs/build/open-folder-projects-cpp.md b/docs/build/open-folder-projects-cpp.md index dff693a6320..006635d28b2 100644 --- a/docs/build/open-folder-projects-cpp.md +++ b/docs/build/open-folder-projects-cpp.md @@ -1,9 +1,9 @@ --- -description: "Learn more about: Open Folder support for C++ build systems in Visual Studio" title: "Open Folder support for C++ build systems in Visual Studio" -ms.date: "12/02/2019" +description: "Learn more about: Open Folder support for C++ build systems in Visual Studio" +ms.date: 12/02/2019 helpviewer_keywords: ["Open Folder Projects in Visual Studio"] -ms.assetid: abd1985e-3717-4338-9e80-869db5435175 +ms.topic: how-to --- # Open Folder support for C++ build systems in Visual Studio @@ -105,7 +105,7 @@ If you add the MinGW-W64 configuration, the JSON looks this: } ``` -Note the `environments` block. It defines properties that behave like environment variables and are available not only in the *CppProperties.json* file, but also in the other configuration files *task.vs.json* and *launch.vs.json*. The `Mingw64` configuration inherits the `mingw_w64` environment, and uses its `INCLUDE` property to specify the value for `includePath`. You can add other paths to this array property as needed.` +Note the `environments` block. It defines properties that behave like environment variables and are available not only in the *CppProperties.json* file, but also in the other configuration files *task.vs.json* and *launch.vs.json*. The `Mingw64` configuration inherits the `mingw_w64` environment, and uses its `INCLUDE` property to specify the value for `includePath`. You can add other paths to this array property as needed. The `intelliSenseMode` property is set to a value appropriate for GCC. For more information on all these properties, see [CppProperties schema reference](cppproperties-schema-reference.md). diff --git a/docs/build/optimization-best-practices.md b/docs/build/optimization-best-practices.md index ce428f701b4..b0530ca07e9 100644 --- a/docs/build/optimization-best-practices.md +++ b/docs/build/optimization-best-practices.md @@ -4,6 +4,7 @@ title: "Optimization best practices" ms.date: "05/06/2019" helpviewer_keywords: ["C++, optimization", "optimization, best practices"] ms.assetid: f3433148-7255-4ca6-8a4f-7c31aac88508 +ms.topic: best-practice --- # Optimization best practices diff --git a/docs/build/optimizing-your-code.md b/docs/build/optimizing-your-code.md index a30267f3823..590f7b8faec 100644 --- a/docs/build/optimizing-your-code.md +++ b/docs/build/optimizing-your-code.md @@ -3,6 +3,7 @@ description: "Learn more about: Optimizing your code" title: "Optimizing Your Code" ms.date: "05/06/2019" helpviewer_keywords: ["performance, optimizing code", "optimization", "cl.exe compiler, performance", "optimization, C++ code", "code, optimizing", "performance, compiler"] +ms.topic: concept-article --- # Optimizing your code diff --git a/docs/build/overview-of-arm-abi-conventions.md b/docs/build/overview-of-arm-abi-conventions.md index 3e61981e84e..0b80497f7ac 100644 --- a/docs/build/overview-of-arm-abi-conventions.md +++ b/docs/build/overview-of-arm-abi-conventions.md @@ -2,12 +2,14 @@ description: "Learn more about: Overview of ARM32 ABI Conventions" title: "Overview of ARM ABI Conventions" ms.date: "07/11/2018" -ms.assetid: 23f4ae8c-3148-4657-8c47-e933a9f387de --- # Overview of ARM32 ABI Conventions The application binary interface (ABI) for code compiled for Windows on ARM processors is based on the standard ARM EABI. This article highlights key differences between Windows on ARM and the standard. This document covers the ARM32 ABI. For information about the ARM64 ABI, see [Overview of ARM64 ABI conventions](arm64-windows-abi-conventions.md). For more information about the standard ARM EABI, see [Application Binary Interface (ABI) for the ARM Architecture](https://github.com/ARM-software/abi-aa) (external link). +> [!NOTE] +> Using the Microsoft C++ (MSVC) Build Tools to target ARM32 is deprecated starting with Visual Studio 2026. If you need to target ARM32, use the Visual Studio 2022 v143 build tools. + ## Base Requirements Windows on ARM always presumes that it's running on an ARMv7 architecture. Floating-point support in the form of VFPv3-D32 or later must be present in hardware. The VFP must support both single-precision and double-precision floating-point in hardware. The Windows runtime doesn't support emulation of floating-point to enable running on non-VFP hardware. @@ -124,7 +126,7 @@ Initialization is performed exactly once, before argument processing begins: For each argument in the list, the first matching rule from the following list is applied: -1. If the argument is a composite type whose size cannot be statically determined by both the caller and the callee, the argument is copied to memory and replaced by a pointer to the copy. +1. If the argument is a composite type whose size can't be statically determined by both the caller and the callee, the argument is copied to memory and replaced by a pointer to the copy. 1. If the argument is a byte or 16-bit half-word, then it is zero-extended or sign-extended to a 32-bit full word and treated as a 4-byte argument. @@ -136,11 +138,11 @@ For each argument in the list, the following rules are applied in turn until the 1. If the argument is a VFP type and there are enough consecutive unallocated VFP registers of the appropriate type, then the argument is allocated to the lowest-numbered sequence of such registers. -1. If the argument is a VFP type, all remaining unallocated registers are marked as unavailable. The NSAA is adjusted upwards until it is correctly aligned for the argument type and the argument is copied to the stack at the adjusted NSAA. The NSAA is then incremented by the size of the argument. +1. If the argument is a VFP type, all remaining unallocated registers are marked as unavailable. The NSAA is adjusted upwards until it's correctly aligned for the argument type and the argument is copied to the stack at the adjusted NSAA. The NSAA is then incremented by the size of the argument. 1. If the argument requires 8-byte alignment, the NCRN is rounded up to the next even register number. -1. If the size of the argument in 32-bit words is not more than r4 minus NCRN, the argument is copied into core registers, starting at the NCRN, with the least significant bits occupying the lower-numbered registers. The NCRN is incremented by the number of registers used. +1. If the size of the argument in 32-bit words isn't more than r4 minus NCRN, the argument is copied into core registers, starting at the NCRN, with the least significant bits occupying the lower-numbered registers. The NCRN is incremented by the number of registers used. 1. If the NCRN is less than r4 and the NSAA is equal to the SP, the argument is split between core registers and the stack. The first part of the argument is copied into the core registers, starting at the NCRN, up to and including r3. The rest of the argument is copied onto the stack, starting at the NSAA. The NCRN is set to r4 and the NSAA is incremented by the size of the argument minus the amount passed in registers. @@ -148,7 +150,7 @@ For each argument in the list, the following rules are applied in turn until the 1. The argument is copied into memory at the NSAA. The NSAA is incremented by the size of the argument. -The VFP registers aren't used for variadic functions, and Stage C rules 1 and 2 are ignored. It means that a variadic function can begin with an optional push {r0-r3} to prepend the register arguments to any additional arguments passed by the caller, and then access the entire argument list directly from the stack. +The VFP registers aren't used for variadic functions, and Stage C rules 1 and 2 are ignored. It means that a variadic function can begin with an optional push {r0-r3} to prepend the register arguments to any other arguments passed by the caller, and then access the entire argument list directly from the stack. Integer type values are returned in r0, optionally extended to r1 for 64-bit return values. VFP/NEON floating-point or SIMD type values are returned in s0, d0, or q0, as appropriate. @@ -158,7 +160,7 @@ The stack must always remain 4-byte aligned, and must be 8-byte aligned at any f Functions that have to use a frame pointer—for example, functions that call `alloca` or that change the stack pointer dynamically—must set up the frame pointer in r11 in the function prologue and leave it unchanged until the epilogue. Functions that don't require a frame pointer must perform all stack updates in the prologue and leave the stack pointer unchanged until the epilogue. -Functions that allocate 4 KB or more on the stack must ensure that each page prior to the final page is touched in order. This order ensures that no code can "leap over" the guard pages that Windows uses to expand the stack. Typically, the expansion is done by the `__chkstk` helper, which is passed the total stack allocation in bytes divided by 4 in r4, and which returns the final stack allocation amount in bytes back in r4. +Functions that allocate 4 KB or more on the stack must ensure that each page before the final page is touched in order. This order ensures that no code can "leap over" the guard pages that Windows uses to expand the stack. Typically, the expansion is done by the `__chkstk` helper, which is passed the total stack allocation in bytes divided by 4 in r4, and which returns the final stack allocation amount in bytes back in r4. ### Red zone @@ -194,5 +196,5 @@ The counter is a true cycle counter, not a clock; therefore, the counting freque ## See also -[Common Visual C++ ARM Migration Issues](common-visual-cpp-arm-migration-issues.md)
+[Common Microsoft C++ ARM Migration Issues](common-visual-cpp-arm-migration-issues.md)
[ARM Exception Handling](arm-exception-handling.md) diff --git a/docs/build/projects-and-build-systems-cpp.md b/docs/build/projects-and-build-systems-cpp.md index 156cd4acfd8..0e429325991 100644 --- a/docs/build/projects-and-build-systems-cpp.md +++ b/docs/build/projects-and-build-systems-cpp.md @@ -1,37 +1,36 @@ --- title: "C/C++ projects and build systems in Visual Studio" description: "Use Visual Studio to compile and build C++ projects for Windows, ARM, or Linux based on any project system." -ms.date: "07/17/2019" -helpviewer_keywords: ["builds [C++]", "C++ projects, building", "projects [C++], building", "builds [C++], options", "C++, build options"] -ms.assetid: fa6ed4ff-334a-4d99-b5e2-a1f83d2b3008 +ms.date: 07/17/2019 ms.topic: "overview" ms.custom: intro-overview +helpviewer_keywords: ["builds [C++]", "C++ projects, building", "projects [C++], building", "builds [C++], options", "C++, build options"] --- # C/C++ projects and build systems in Visual Studio -You can use Visual Studio to edit, compile, and build any C++ code base with full IntelliSense support without having to convert that code into a Visual Studio project or compile with the MSVC toolset. For example, you can edit a cross-platform CMake project in Visual Studio on a Windows machine, then compile it for Linux using g++ on a remote Linux machine. +You can use Visual Studio to edit, compile, and build any C++ code base with full IntelliSense support without having to convert that code into a Visual Studio project or compile with the Microsoft C++ (MSVC) Build Tools. For example, you can edit a cross-platform CMake project in Visual Studio on a Windows machine, then compile it for Linux using g++ on a remote Linux machine. ## C++ compilation -To *build* a C++ program means to compile source code from one or more files and then link those files into an executable file (.exe), a dynamic-load library (.dll) or a static library (.lib). +To *build* a C++ program means to compile source code from one or more files and then link those files into an executable file (`.exe`), a dynamic-link library (`.dll`) or a static library (`.lib`). Basic C++ compilation involves three main steps: - The C++ preprocessor transforms all the #directives and macro definitions in each source file. This creates a *translation unit*. -- The C++ compiler compiles each translation unit into object files (.obj), applying whatever compiler options have been set. +- The C++ compiler compiles each translation unit into object files (`.obj`), applying whatever compiler options have been set. - The *linker* merges the object files into a single executable, applying the linker options that have been set. -## The MSVC toolset +## The Microsoft C++ (MSVC) Build Tools -The Microsoft C++ compiler, linker, standard libraries, and related utilities make up the MSVC compiler toolset (also called a toolchain or "build tools"). These are included in Visual Studio. You can also download and use the command-line toolset as a free standalone package. For more information, see [Build Tools for Visual Studio](https://visualstudio.microsoft.com/downloads/#build-tools-for-visual-studio-2022) on the Visual Studio Downloads page. +The Microsoft C++ compiler, linker, standard libraries, and related utilities make up the Microsoft C++ (MSVC) Build Tools (also called a toolchain or toolset). These are included in Visual Studio. You can also download and use the command-line toolset as a free standalone package. For more information, see [Build Tools for Visual Studio](https://visualstudio.microsoft.com/downloads/#build-tools-for-visual-studio-2022) on the Visual Studio Downloads page. -You can build simple programs by invoking the MSVC compiler (cl.exe) directly from the command line. The following command accepts a single source code file, and invokes cl.exe to build an executable called *hello.exe*: +You can build simple programs by invoking the MSVC compiler (`cl.exe`) directly from the command line. The following command accepts a single source code file, and invokes `cl.exe` to build an executable called *`hello.exe`*: ```cmd cl /EHsc hello.cpp ``` -Here the compiler (cl.exe) automatically invokes the C++ preprocessor and the linker to produce the final output file. For more information, see [Building on the command line](building-on-the-command-line.md). +Here the compiler (`cl.exe`) automatically invokes the C++ preprocessor and the linker to produce the final output file. For more information, see [Building on the command line](building-on-the-command-line.md). ## Build systems and projects @@ -39,19 +38,19 @@ Most real-world programs use some kind of *build system* to manage complexities The following list shows various options for Visual Studio Projects - C++: -- create a Visual Studio project by using the Visual Studio IDE and configure it by using property pages. Visual Studio projects produce programs that run on Windows. For an overview, see [Compiling and Building](/visualstudio/ide/compiling-and-building-in-visual-studio) in the Visual Studio documentation. +- Create a Visual Studio project by using the Visual Studio IDE and configure it by using property pages. Visual Studio projects produce programs that run on Windows. For an overview, see [Compiling and Building](/visualstudio/ide/compiling-and-building-in-visual-studio) in the Visual Studio documentation. -- open a folder that contains a CMakeLists.txt file. CMake support is integrated into Visual Studio. You can use the IDE to edit, test, and debug without modifying the CMake files in any way. This enables you to work in the same CMake project as others who might be using different editors. CMake is the recommended approach for cross-platform development. For more information, see [CMake projects](cmake-projects-in-visual-studio.md). +- Open a folder that contains a `CMakeLists.txt` file. CMake support is integrated into Visual Studio. You can use the IDE to edit, test, and debug without modifying the CMake files in any way. This enables you to work in the same CMake project as others who might be using different editors. CMake is the recommended approach for cross-platform development. For more information, see [CMake projects](cmake-projects-in-visual-studio.md). -- open a loose folder of source files with no project file. Visual Studio will use heuristics to build the files. This is an easy way to compile and run small console applications. For more information, see [Open Folder projects](open-folder-projects-cpp.md). +- Open a loose folder of source files with no project file. Visual Studio will use heuristics to build the files. This is an easy way to compile and run small console applications. For more information, see [Open Folder projects](open-folder-projects-cpp.md). -- open a folder that contains a makefile, or any other build system configuration file. You can configure Visual Studio to invoke any arbitrary build commands by adding JSON files to the folder. For more information, see [Open Folder projects](open-folder-projects-cpp.md). +- Open a folder that contains a makefile, or any other build system configuration file. You can configure Visual Studio to invoke any arbitrary build commands by adding JSON files to the folder. For more information, see [Open Folder projects](open-folder-projects-cpp.md). - Open a Windows makefile in Visual Studio. For more information, see [NMAKE Reference](reference/nmake-reference.md). ## MSBuild from the command line -You can invoke MSBuild from the command line by passing it a .vcxproj file along with command-line options. This approach requires a good understanding of MSBuild, and is recommended only when necessary. For more information, see [MSBuild](msbuild-visual-cpp.md). +You can invoke MSBuild from the command line by passing it a `.vcxproj` file along with command-line options. This approach requires a good understanding of MSBuild, and is recommended only when necessary. For more information, see [MSBuild](msbuild-visual-cpp.md). ## In This Section @@ -74,7 +73,7 @@ Discusses how to use the C/C++ compiler and build tools directly from the comman How to create, debug, and deploy C/C++ DLLs (shared libraries) in Visual Studio. [Walkthrough: Creating and Using a Static Library](walkthrough-creating-and-using-a-static-library-cpp.md)\ -How to create a **.lib** binary file. +How to create a `.lib` binary file. [Building C/C++ Isolated Applications and Side-by-side Assemblies](building-c-cpp-isolated-applications-and-side-by-side-assemblies.md)\ Describes the deployment model for Windows Desktop applications, based on the idea of isolated applications and side-by-side assemblies. @@ -83,10 +82,10 @@ Describes the deployment model for Windows Desktop applications, based on the id How to target 64-bit x64 hardware with the MSVC build tools. [Configure C++ projects for ARM processors](configuring-programs-for-arm-processors-visual-cpp.md)\ -How to use the MSVC build tools to target ARM hardware. +How to use the MSVC Build Tools to target ARM hardware. [Optimizing Your Code](optimizing-your-code.md)\ -How to optimize your code in various ways including program guided optimizations. +How to optimize your code in various ways including profile-guided optimization (PGO). [Configuring Programs for Windows XP](configuring-programs-for-windows-xp.md)\ How to target Windows XP with the MSVC build tools. diff --git a/docs/build/prolog-and-epilog.md b/docs/build/prolog-and-epilog.md index eb6f1ad9723..56b27b056b1 100644 --- a/docs/build/prolog-and-epilog.md +++ b/docs/build/prolog-and-epilog.md @@ -1,8 +1,7 @@ --- -description: "Learn more about: x64 prolog and epilog" title: "x64 prolog and epilog" -ms.date: "12/17/2018" -ms.assetid: 0453ed1a-3ff1-4bee-9cc2-d6d3d6384984 +description: "Learn more about: x64 prolog and epilog" +ms.date: 12/17/2018 --- # x64 prolog and epilog diff --git a/docs/build/reference/arch-arm.md b/docs/build/reference/arch-arm.md index f7495756f0b..8d7ebd3293a 100644 --- a/docs/build/reference/arch-arm.md +++ b/docs/build/reference/arch-arm.md @@ -5,7 +5,7 @@ ms.date: 07/01/2022 --- # `/arch` (ARM) -Specifies the architecture for code generation on ARM. For more information on **`/arch`** for other target architectures, see [`/arch` (ARM64)](arch-arm64.md), [`/arch` (x64)](arch-x64.md), and [`/arch` (x86)](arch-x86.md) +Specifies the architecture for code generation on ARM. These switches apply to the ARM targeting version of the compiler. For more information on **`/arch`** for other target architectures, see [`/arch` (ARM64)](arch-arm64.md), [`/arch` (x64)](arch-x64.md), and [`/arch` (x86)](arch-x86.md) ## Syntax diff --git a/docs/build/reference/arch-arm64.md b/docs/build/reference/arch-arm64.md index dd54dee205e..7b432961ec4 100644 --- a/docs/build/reference/arch-arm64.md +++ b/docs/build/reference/arch-arm64.md @@ -1,11 +1,11 @@ --- -description: "Learn more about: /arch (ARM64)" title: "/arch (ARM64)" +description: "Learn more about: /arch (ARM64)" ms.date: 05/24/2024 --- # `/arch` (ARM64) -Specifies the Arm A-Profile architecture extension for code generation on ARM64. For more information about **`/arch`** for other target architectures, see [`/arch` (x86)](arch-x86.md), [`/arch` (x64)](arch-x64.md), and [`/arch` (ARM)](arch-arm.md). +Specifies the Arm A-Profile architecture extension for code generation on ARM64. These switches apply to the ARM64 targeting version of the compiler. For more information about **`/arch`** for other target architectures, see [`/arch` (x86)](arch-x86.md), [`/arch` (x64)](arch-x64.md), and [`/arch` (ARM)](arch-arm.md). ## Syntax @@ -25,9 +25,9 @@ Specifies the Armv9-A architecture, where **`x`** is a required extension value You can specify an ARM64 extension from Armv8.0-A through Armv8.9-A, and Armv9.0-A through Armv9.4-A. Optionally, enable one or more architecture features by appending a feature argument to the option3. For example, to target Armv8.0-A and enable feature `FEAT_LSE`, append feature argument **`lse`** so that the option becomes **`/arch:armv8.0+lse`**. For more information about available features and their requirements, see [`/feature` (ARM64)](feature-arm64.md)3. > [!NOTE] -> Depending on your version of Visual Studio, the compiler may not yet generate instructions from all feature sets required by the extension level you specify. For example, **`/arch:armv8.1`** allows the `*Interlocked*` intrinsic functions to use the appropriate atomic instruction introduced with the Armv8.1-A extension feature `FEAT_LSE`, but compiler support requires Visual Studio 2022 version 17.2 or later. +> Depending on your version of Visual Studio, the compiler may not yet generate instructions from all feature sets required by the extension level you specify. For example, **`/arch:armv8.1`** allows the *`Interlocked`* intrinsic functions to use the appropriate atomic instruction introduced with the Armv8.1-A extension feature `FEAT_LSE`, but compiler support requires Visual Studio 2022 version 17.2 or later. -The `_M_ARM64` macro is defined by default when compiling for an ARM64 target. For more information, see [Predefined macros](../../preprocessor/predefined-macros.md)\ +The `_M_ARM64` macro is defined by default when compiling for an ARM64 target. For more information, see [Predefined macros](../../preprocessor/predefined-macros.md). The `__ARM_ARCH` macro is defined for `/arch:ARMv8.0` and higher. It indicates the ARM architecture extension level that the compiler is targeting. For more information, see [Predefined macros](../../preprocessor/predefined-macros.md). diff --git a/docs/build/reference/arch-x64.md b/docs/build/reference/arch-x64.md index 02fe9eb27b5..696f055f190 100644 --- a/docs/build/reference/arch-x64.md +++ b/docs/build/reference/arch-x64.md @@ -1,17 +1,17 @@ --- description: "Learn more about: /arch (x64)" title: "/arch (x64)" -ms.date: 06/30/2022 -f1_keywords: ["/arch:SSE2", "/arch:SSE4.2", "/arch:AVX", "/arch:AVX2", "/arch:AVX512", "/arch:AVX10.1"] -helpviewer_keywords: ["/arch:SSE2 compiler option [C++]", "/arch:SSE4.2 compiler option [C++]", "/arch:AVX compiler option [C++]", "/arch:AVX2 compiler option [C++]", "/arch:AVX512 compiler option [C++]", "/arch:AVX10.1 compiler option [C++]"] +ms.date: 10/21/2025 +f1_keywords: ["/arch:SSE2", "/arch:SSE4.2", "/arch:AVX", "/arch:AVX2", "/arch:AVX512", "/arch:AVX10.1", "/arch:AVX10.2"] +helpviewer_keywords: ["/arch:SSE2 compiler option [C++]", "/arch:SSE4.2 compiler option [C++]", "/arch:AVX compiler option [C++]", "/arch:AVX2 compiler option [C++]", "/arch:AVX512 compiler option [C++]", "/arch:AVX10.1 compiler option [C++]", "/arch:AVX10.2 compiler option [C++]"] --- # `/arch` (x64) -Specifies the architecture for code generation on x64. For more information on **`/arch`** for other target architectures, see [`/arch` (x86)](arch-x86.md), [`/arch` (ARM64)](arch-arm64.md), and [`/arch` (ARM)](arch-arm.md). +Specifies the architecture for code generation on x64. These switches apply to the x64 targeting version of the compiler. For more information on **`/arch`** for other target architectures, see [`/arch` (x86)](arch-x86.md), [`/arch` (ARM64)](arch-arm64.md), and [`/arch` (ARM)](arch-arm.md). ## Syntax -> **`/arch:`**\[**`SSE2`**|**`SSE4.2`**|**`AVX`**|**`AVX2`**|**`AVX512`**|**`AVX10.1`**] +> **`/arch:`**\[**`SSE2`**|**`SSE4.2`**|**`AVX`**|**`AVX2`**|**`AVX512`**|**`AVX10.1`**|**`AVX10.2`**] ## Arguments @@ -33,6 +33,9 @@ Enables Intel Advanced Vector Extensions 512. **`/arch:AVX10.1`**\ Enables Intel Advanced Vector Extensions 10 version 1. +**`/arch:AVX10.2`**\ +Enables Intel Advanced Vector Extensions 10 version 2. + ## Remarks The **`/arch`** option enables the use of certain instruction set extensions, particularly for vector calculation, available in processors from Intel and AMD. In general, more recently introduced processors may support extensions beyond the ones supported by older processors, although you should consult the documentation for a particular processor or test for instruction set extension support using [`__cpuid`](../../intrinsics/cpuid-cpuidex.md) before executing code using an instruction set extension. You can also use the [`__check_isa_support`](../../intrinsics/check-isa-arch-support.md) intrinsic to check for more frequently used CPU features. @@ -51,17 +54,20 @@ The processor extensions have the following characteristics: - **`AVX-512`** introduced another instruction encoding form that allows 512-bit vectors, masking, embedded rounding/broadcast, and new instructions. The default vector length for **`AVX-512`** is 512 bits and can be changed to 256 bits using the [`/vlen`](vlen.md) flag. -- **`AVX10.1`** adds more instructions on top of **`AVX-512`**. The default vector length for **`AVX10.1`** is 256 bits and can be changed to 512 bits using the [`/vlen`](vlen.md) flag. +- **`AVX10.1`** adds more instructions on top of **`AVX-512`**. The default vector length for **`AVX10.1`** is 256 bits and can be changed to 512 bits using the [`/vlen`](vlen.md) flag. This option was introduced in Visual Studio 2022 17.13. + +- **`AVX10.2`** expands the instruction set introduced in `AVX10.1`. The default vector length for **`AVX10.2`** is 256 bits and can be increased to 512 bits using the [`/vlen`](vlen.md) flag. +`AVX10.2` adds instructions that are enhancements of legacy instructions and media acceleration instructions. For more information about the new instructions, see section 3.1.4 in the [Intel Advanced Vector Extensions 10.2 Architecture Specification](https://www.intel.com/content/www/us/en/content-details/856721/intel-advanced-vector-extensions-10-2-intel-avx10-2-architecture-specification.html). The AI related instructions in that document are supported via MSVC intrinsics instead of being directly emitted because MSVC doesn't support their data types. This compiler option was introduced in Visual Studio 2026. -Each **`/arch`** option may also enable the use of other non-vector instructions that are associated with that option. An example is the use of certain BMI instructions when **`/arch:AVX2`** is specified. +Each **`/arch`** option may also enable the use of other nonvector instructions that are associated with that option. An example is the use of certain BMI instructions when **`/arch:AVX2`** is specified. -The `__AVX__` preprocessor symbol is defined when the **`/arch:AVX`**, **`/arch:AVX2`**, **`/arch:AVX512`**, or **`/arch:AVX10.1`** compiler option is specified. -The `__AVX2__` preprocessor symbol is defined when the **`/arch:AVX2`**, **`/arch:AVX512`**, or **`/arch:AVX10.1`** compiler option is specified. -The `__AVX512F__`, `__AVX512CD__`, `__AVX512BW__`, `__AVX512DQ__`, and `__AVX512VL__` preprocessor symbols are defined when the **`/arch:AVX512`**, or **`/arch:AVX10.1`** compiler option is specified. -The `__AVX10_VER__` preprocessor symbol is defined when the **`/arch:AVX10.1`** compiler option is specified. It indicates the AVX10 version the compiler is targeting. For more information, see [Predefined macros](../../preprocessor/predefined-macros.md). +The `__AVX__` preprocessor symbol is defined when the **`/arch:AVX`**, **`/arch:AVX2`**, **`/arch:AVX512`**, **`/arch:AVX10.1`**, or **`/arch:AVX10.2`** compiler option is specified. +The `__AVX2__` preprocessor symbol is defined when the **`/arch:AVX2`**, **`/arch:AVX512`**, **`/arch:AVX10.1`**, or **`/arch:AVX10.2`** compiler option is specified. +The `__AVX512F__`, `__AVX512CD__`, `__AVX512BW__`, `__AVX512DQ__`, and `__AVX512VL__` preprocessor symbols are defined when the **`/arch:AVX512`**, **`/arch:AVX10.1`**, or **`/arch:AVX10.2`** compiler option is specified. +The `__AVX10_VER__` preprocessor symbol is defined when the **`/arch:AVX10.1`** or **`/arch:AVX10.2`** compiler option is specified. It indicates the AVX10 version the compiler is targeting. For more information, see [Predefined macros](../../preprocessor/predefined-macros.md). The **`/arch:AVX2`** option was introduced in Visual Studio 2013 Update 2, version 12.0.34567.1. Limited support for **`/arch:AVX512`** was added in Visual Studio 2017, and expanded in Visual Studio 2019. -Support for **`/arch:AVX10.1`** was added in Visual Studio 2022. +Support for **`/arch:AVX10.1`** was added in Visual Studio 2022. Support for **`/arch:AVX10.2`** was added in Visual Studio 2026. ### To set the `/arch` compiler option in Visual Studio diff --git a/docs/build/reference/arch-x86.md b/docs/build/reference/arch-x86.md index e0806f08b83..a133eda92db 100644 --- a/docs/build/reference/arch-x86.md +++ b/docs/build/reference/arch-x86.md @@ -1,17 +1,17 @@ --- description: "Learn more about: /arch (x86)" title: "/arch (x86)" -ms.date: 06/30/2022 -f1_keywords: ["/arch:IA32", "/arch:SSE", "/arch:SSE2", "/arch:AVX", "/arch:AVX2", "/arch:AVX512", "/arch:AVX10.1"] -helpviewer_keywords: ["/arch:IA32 compiler option [C++]", "/arch:SSE compiler option [C++]", "/arch:SSE2 compiler option [C++]", "/arch:AVX compiler option [C++]", "/arch:AVX2 compiler option [C++]", "/arch:AVX512 compiler option [C++]", "/arch:AVX10.1 compiler option [C++]"] +ms.date: 10/21/2025 +f1_keywords: ["/arch:IA32", "/arch:SSE", "/arch:SSE2", "/arch:AVX", "/arch:AVX2", "/arch:AVX512", "/arch:AVX10.1", /arch:AVX10.2"] +helpviewer_keywords: ["/arch:IA32 compiler option [C++]", "/arch:SSE compiler option [C++]", "/arch:SSE2 compiler option [C++]", "/arch:AVX compiler option [C++]", "/arch:AVX2 compiler option [C++]", "/arch:AVX512 compiler option [C++]", "/arch:AVX10.1 compiler option [C++]", "/arch:AVX10.2 compiler option [C++]"] --- # `/arch` (x86) -Specifies the architecture for code generation on x86. For more information on **`/arch`** for other target architectures, see [`/arch` (ARM64)](arch-arm64.md), [`/arch` (x64)](arch-x64.md), and [`/arch` (ARM)](arch-arm.md). +Specifies the architecture for code generation on x86. These switches apply to the x86 (32-bit) targeting version of the compiler. For more information on **`/arch`** for other target architectures, see [`/arch` (ARM64)](arch-arm64.md), [`/arch` (x64)](arch-x64.md), and [`/arch` (ARM)](arch-arm.md). ## Syntax -> **`/arch:`**\[**`IA32`**|**`SSE`**|**`SSE2`**|**`AVX`**|**`AVX2`**|**`AVX512`**|**`AVX10.1`**] +> **`/arch:`**\[**`IA32`**|**`SSE`**|**`SSE2`**|**`AVX`**|**`AVX2`**|**`AVX512`**|**`AVX10.1`**|**`AVX10.2`**] ## Arguments @@ -36,6 +36,9 @@ Enables Intel Advanced Vector Extensions 512. **`/arch:AVX10.1`**\ Enables Intel Advanced Vector Extensions 10 version 1. +**`/arch:AVX10.2`**\ +Enables Intel Advanced Vector Extensions 10 version 2. + ## Remarks The **`/arch`** option enables or disables the use of certain instruction set extensions, particularly for vector calculation, available in processors from Intel and AMD. In general, more recently introduced processors may support extensions beyond the ones supported by older processors. You should consult the documentation for a particular processor or test for instruction set extension support using [`__cpuid`](../../intrinsics/cpuid-cpuidex.md) before executing code using an instruction set extension. You can also use the [`__check_isa_support`](../../intrinsics/check-isa-arch-support.md) intrinsic to check for more frequently used CPU features. @@ -56,11 +59,14 @@ The **`/arch`** options refer to instruction set extensions with the following c - **`AVX512`** introduced another instruction encoding form that allows 512-bit vectors, masking, embedded rounding/broadcast, and new instructions. The default vector length for **`AVX512`** is 512 bits and can be changed to 256 bits using the [`/vlen`](vlen.md) flag. -- **`AVX10.1`** adds more instructions on top of **`AVX-512`**. The default vector length for **`AVX10.1`** is 256 bits and can be changed to 512 bits using the [`/vlen`](vlen.md) flag. +- **`AVX10.1`** adds more instructions on top of **`AVX-512`**. The default vector length for **`AVX10.1`** is 256 bits and can be changed to 512 bits using the [`/vlen`](vlen.md) flag. This option was introduced in Visual Studio 2022 17.13. + +- **`AVX10.2`** expands the instruction set introduced in `AVX10.1`. The default vector length for **`AVX10.2`** is 256 bits and can be increased to 512 bits using the [`/vlen`](vlen.md) flag. +`AVX10.2` adds instructions that are enhancements of legacy instructions and media acceleration instructions. For more information about the new instructions, see section 3.1.4 in the [Intel Advanced Vector Extensions 10.2 Architecture Specification](https://www.intel.com/content/www/us/en/content-details/856721/intel-advanced-vector-extensions-10-2-intel-avx10-2-architecture-specification.html) The AI related instructions in that document are supported via MSVC intrinsics instead of being directly emitted because MSVC doesn't support their data types. This compiler option was introduced in Visual Studio 2026. The optimizer chooses when and how to use vector instructions depending on which **`/arch`** is specified. Scalar floating-point computations are usually performed with SSE or AVX instructions when available. Some calling conventions specify passing floating-point arguments on the x87 stack, and as a result, your code may use a mixture of both x87 and SSE/AVX instructions for floating-point computations. Integer vector instructions can also be used for some 64-bit integer operations when available. -In addition to the vector and floating-point scalar instructions, each **`/arch`** option may also enable the use of other non-vector instructions that are associated with that option. An example is the CMOVcc instruction family that first appeared on the Intel Pentium Pro processors. Because SSE instructions were introduced with the subsequent Intel Pentium III processor, CMOVcc instructions may be generated except when **`/arch:IA32`** is specified. +In addition to the vector and floating-point scalar instructions, each **`/arch`** option may also enable the use of other nonvector instructions that are associated with that option. An example is the CMOVcc instruction family that first appeared on the Intel Pentium Pro processors. Because SSE instructions were introduced with the subsequent Intel Pentium III processor, CMOVcc instructions may be generated except when **`/arch:IA32`** is specified. Floating-point operations are normally rounded to double-precision (64-bit) in x87 code, but you can use `_controlfp` to modify the FP control word, including setting the precision control to extended precision (80-bit) or single-precision (32-bit). For more information, see [`_control87`, `_controlfp`, `__control87_2`](../../c-runtime-library/reference/control87-controlfp-control87-2.md). SSE and AVX have separate single-precision and double-precision instructions for each operation, so there's no equivalent for SSE/AVX code. It can change how results are rounded when the result of a floating-point operation is used directly in further calculation instead of assigning it to a user variable. Consider the following operations: diff --git a/docs/build/reference/await-enable-coroutine-support.md b/docs/build/reference/await-enable-coroutine-support.md index 9595a434ffc..6ce254876f8 100644 --- a/docs/build/reference/await-enable-coroutine-support.md +++ b/docs/build/reference/await-enable-coroutine-support.md @@ -1,15 +1,17 @@ --- description: "Learn more about: /await (Enable coroutine support)" title: "/await (Enable coroutine support)" -ms.date: "08/15/2017" +ms.date: 09/08/2025 f1_keywords: ["/await", "-await"] helpviewer_keywords: ["/await enable coroutine support [C++]", "-await enable coroutine support [C++]", "await enable coroutine support [C++]"] -ms.assetid: 302c8e69-09b6-4c58-bcdd-0a6a8713a8df --- -# `/await` (Enable coroutine support) +# `/await` (Enable coroutine support) Deprecated. Use the **`/await`** compiler option to enable compiler support for coroutines. +> [!NOTE] +> The **`/await`** option is deprecated starting with Visual Studio 2026 and will be removed in a future release. Standard C++ coroutines are available by default in C++20 or later. Or use **`/await:strict`** option when using earlier versions of the C++ language. + ## Syntax > **`/await`**\ @@ -19,7 +21,7 @@ Use the **`/await`** compiler option to enable compiler support for coroutines. The **`/await`** compiler option enables compiler support for C++ coroutines and the keywords **`co_await`**, **`co_yield`**, and **`co_return`**. This option is off by default. For information about support for coroutines in Visual Studio, see the [Visual Studio Team Blog](https://devblogs.microsoft.com/cppblog/category/coroutine/). For more information about the coroutines standard proposal, see [N4628 Working Draft, Technical Specification for C++ Extensions for Coroutines](https://wg21.link/n4628). -The **`/await`** option is available beginning in Visual Studio 2015. +The **`/await`** option is available beginning in Visual Studio 2015 and is deprecated starting with Visual Studio 2026. Starting in Visual Studio 2019 version 16.10, the **`/await:strict`** option can be used in place of **`/await`**. The option provides C++20-compatible coroutine support in projects that build in C++14 or C++17 mode. In **`/await:strict`** mode, library support is provided in \ and in the `std` namespace. diff --git a/docs/build/reference/base-base-address.md b/docs/build/reference/base-base-address.md index a78fb4117b3..1728032bacc 100644 --- a/docs/build/reference/base-base-address.md +++ b/docs/build/reference/base-base-address.md @@ -1,10 +1,9 @@ --- description: "Learn more about: /BASE (Base address)" title: "/BASE (Base address)" -ms.date: 05/11/2022 +ms.date: 03/27/2025 f1_keywords: ["/base", "VC.Project.VCLinkerTool.BaseAddress"] helpviewer_keywords: ["base addresses [C++]", "programs [C++], preventing relocation", "semicolon [C++], specifier", "-BASE linker option", "key address size", "environment variables [C++], LIB", "programs [C++], base address", "LIB environment variable", "BASE linker option", "DLLs [C++], linking", "/BASE linker option", "@ symbol for base address", "executable files [C++], base address", "at sign symbol for base address"] -ms.assetid: 00b9f6fe-0bd2-4772-a69c-7365eb199069 --- # `/BASE` (Base address) @@ -23,7 +22,7 @@ The **`/BASE`** linker option sets a base address for the program. It overrides The linker issues an error if *`address`* isn't a multiple of 64K. You can optionally specify the size of the program. The linker issues a warning if the program can't fit in the size you specified. -On the command line, another way to specify the base address is by using a *base address response file*. A base address response file is a text file that contains the base addresses and optional sizes of all the DLLs your program uses, and a unique text key for each base address. To specify a base address by using a response file, use an at sign (**`@`**) followed by the name of the response file, *`filename`*, followed by a comma, then the *`key`* value for the base address to use in the file. The linker looks for *`filename`* in either the specified path, or if no path is specified, in the directories specified in the `LIB` environment variable. Each line in *`filename`* represents one DLL and has the following syntax: +On the command line, another way to specify the base address is by using a *base address response file*. A base address response file is a text file that contains the base addresses and optional sizes of all the DLLs your program uses, and a unique text key for each base address. To specify a base address by using a response file, use an at sign (**`@`**) followed by the name of the response file, *`filename`*, followed by a comma, then the *`key`* value for the base address to use in the file. The linker looks for *`filename`* in either the specified path, or if no path is specified, in the directories specified in the `LIB` environment variable. The fully qualified *`filename`* must not exceed `MAX_PATH` (260 characters). Each line in *`filename`* represents one DLL and has the following syntax: > *`key`* *`address`* \[*`size`*] **`;`** *`comment`* @@ -35,7 +34,7 @@ one 0x28000000 0x00100000 ; for DLLONE.DLL two 0x28100000 0x00300000 ; for DLLTWO.DLL ``` -If the file that contains these lines is called DLLS.txt, the following example command applies this information: +If the file that contains these lines is called `DLLS.txt`, the following example command applies this information: ```cmd link dlltwo.obj /dll /base:@dlls.txt,two @@ -46,9 +45,7 @@ Another way to set the base address is by using the *`BASE`* argument in a [`NAM ### To set this linker option in the Visual Studio development environment 1. Open the project's **Property Pages** dialog box. For details, see [Set C++ compiler and build properties in Visual Studio](../working-with-project-properties.md). - 1. Select the **Configuration Properties** > **Linker** > **Advanced** property page. - 1. Modify the **Base Address** property. ### To set this linker option programmatically diff --git a/docs/build/reference/c-compile-without-linking.md b/docs/build/reference/c-compile-without-linking.md index e552d6a30e2..e1d07952322 100644 --- a/docs/build/reference/c-compile-without-linking.md +++ b/docs/build/reference/c-compile-without-linking.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: /c (Compile Without Linking)" title: "/c (Compile Without Linking)" -ms.date: "11/04/2016" +description: "Learn more about: /c (Compile Without Linking)" +ms.date: 11/04/2016 f1_keywords: ["/c"] helpviewer_keywords: ["suppress link", "cl.exe compiler, compiling without linking", "-c compiler option [C++]", "c compiler option [C++]", "/c compiler option [C++]"] -ms.assetid: 8017fc3d-e5dd-4668-a1f7-3120daa95d20 --- # /c (Compile Without Linking) @@ -34,13 +33,13 @@ Any internal project created in the development environment uses the **/c** opti The following command line creates the object files FIRST.obj and SECOND.obj. THIRD.obj is ignored. -``` +```cmd CL /c FIRST.C SECOND.C THIRD.OBJ ``` To create an executable file, you must invoke LINK: -``` +```cmd LINK first.obj second.obj third.obj /OUT:filename.exe ``` diff --git a/docs/build/reference/c-cpp-prop-page.md b/docs/build/reference/c-cpp-prop-page.md index 4f92e38d17f..b43746b08b6 100644 --- a/docs/build/reference/c-cpp-prop-page.md +++ b/docs/build/reference/c-cpp-prop-page.md @@ -387,7 +387,7 @@ Experimental support for the C++ Modules TS and Standard Library modules. ### Build ISO C++23 Standard Library Modules -Starting in Visual Studio 17.6, when this property is enabled and [C++ Language Standard](#cpplang) is set to `/std:c++latest`, Visual C++ projects automatically find and build ISO C++23 Standard Library modules. This enables you to `import std` or `import std.compat` in your C++ code. +Starting in Visual Studio 17.6, when this property is enabled and [C++ Language Standard](#cpplang) is set to `/std:c++latest`, Microsoft C++ projects automatically find and build ISO C++23 Standard Library modules. This enables you to `import std` or `import std.compat` in your C++ code. ## C/C++ Precompiled Headers Properties diff --git a/docs/build/reference/choosing-the-format-of-netmodule-input-files.md b/docs/build/reference/choosing-the-format-of-netmodule-input-files.md index 708f741e6a0..86c167a0fb5 100644 --- a/docs/build/reference/choosing-the-format-of-netmodule-input-files.md +++ b/docs/build/reference/choosing-the-format-of-netmodule-input-files.md @@ -2,32 +2,31 @@ description: "Learn more about: Choosing the Format of .netmodule Input Files" title: "Choosing the Format of .netmodule Input Files" ms.date: "11/04/2016" -ms.assetid: 4653d1bd-300f-4083-86f5-d1a06f44e61c --- -# Choosing the Format of .netmodule Input Files +# Choosing the format of .netmodule input files -An MSIL .obj file (compiled with [/clr](clr-common-language-runtime-compilation.md)) can also be used as a .netmodule file. .obj files contain metadata and native symbols. .netmodules only contain metadata. +You can use an MSIL `.obj` file (compiled with [`/clr`](clr-common-language-runtime-compilation.md)) as a `.netmodule` file. `.obj` files contain metadata and native symbols. `.netmodules` only contain metadata. -You can pass an MSIL .obj file to any other Visual Studio compiler via the /addmodule compiler option (but be aware that the .obj file becomes part of the resulting assembly and must be shipped with the assembly). For example, Visual C# and Visual Basic have the /addmodule compiler option. +Pass an MSIL `.obj` file to any other Visual Studio compiler with the `/addmodule` compiler option. The `.obj` file becomes part of the resulting assembly and must be shipped with the assembly. For example, Visual C# and Visual Basic have the `/addmodule` compiler option. > [!NOTE] -> In most cases, you will need to pass to the linker the .obj file from the compilation that created the .net module. Passing a .dll or .netmodule MSIL module file to the linker may result in LNK1107. +> In most cases, you need to pass to the linker the `.obj` file from the compilation that created the .net module. Passing a `.dll` or `.netmodule` MSIL module file to the linker might result in LNK1107. -.obj files, along with their associated .h files, which you reference via #include in source, allow C++ applications to consume the native types in the module, whereas in a .netmodule file, only the managed types can be consumed by a C++ application. If you attempt to pass a .obj file to #using, information about native types will not be available; #include the .obj file's .h file instead. +`.obj` files, along with their associated `.h` files, which you reference via #include in source, allow C++ applications to consume the native types in the module. In a `.netmodule` file, only the managed types can be consumed by a C++ application. If you attempt to pass a `.obj` file to #using, information about native types isn't available. Instead, #include the `.obj` file's `.h` file. Other Visual Studio compilers can only consume managed types from a module. -Use the following to determine whether you need to use a .netmodule or a .obj file as module input to the MSVC linker: +Use the following guidance to determine whether you need to use a `.netmodule` or a `.obj` file as module input to the MSVC linker: -- If you are building with a Visual Studio compiler other than Visual C++, produce a .netmodule and use the .netmodule as input to the linker. +- If you're building with a Visual Studio compiler other than Visual C++, produce a `.netmodule` and use the `.netmodule` as input to the linker. -- If you are using the MSVC compiler to produce modules and if the module(s) will be used to build something other than a library, use the .obj files produced by the compiler as module input to the linker; do not use the .netmodule file as input. +- If you're using the MSVC compiler to produce modules and if the modules are used to build something other than a library, use the `.obj` files produced by the compiler as module input to the linker. Don't use the `.netmodule` file as input. -- If your modules will be used to build a native (not a managed) library, use .obj files as module input to the linker and generate a .lib library file. +- If your modules are used to build a native (not a managed) library, use `.obj` files as module input to the linker and generate a `.lib` library file. -- If your modules will be used to build a managed library, and if all module input to the linker will be verifiable (produced with /clr:safe), use .obj files as module input to the linker and generate a .dll (assembly) or .netmodule (module) library file. +- If your modules are used to build a managed library, and if all module input to the linker is verifiable (produced with `/clr:safe`), use `.obj` files as module input to the linker and generate a `.dll` (assembly) or `.netmodule` (module) library file. -- If your modules will be used to build a managed library, and if one or more modules input to the linker will be produced with just /clr, use .obj files as module input to the linker and generate a .dll (assembly). If you want to expose managed types from the library and if you also want C++ applications to consume the native types in the library, your library will consist of the .obj files for the libraries component modules (you will also want to ship the .h files for each module, so they can be referenced with #include from source code). +- If your modules are used to build a managed library, and if one or more modules input to the linker are produced with just `/clr`, use `.obj` files as module input to the linker and generate a `.dll` (assembly). If you want to expose managed types from the library and if you also want C++ applications to consume the native types in the library, your library consists of the `.obj` files for the libraries component modules. You also want to ship the `.h` files for each module, so they can be referenced with #include from source code. ## See also diff --git a/docs/build/reference/cl-invokes-the-linker.md b/docs/build/reference/cl-invokes-the-linker.md index 8f01f044f2d..df402a70150 100644 --- a/docs/build/reference/cl-invokes-the-linker.md +++ b/docs/build/reference/cl-invokes-the-linker.md @@ -1,9 +1,8 @@ --- -description: "Learn more about: CL Invokes the Linker" title: "CL Invokes the Linker" -ms.date: "11/04/2016" +description: "Learn more about: CL Invokes the Linker" +ms.date: 11/04/2016 helpviewer_keywords: ["compiling source code [C++], without linking", "invoking linker from the compiler", "LINK tool [C++], invoking from CL compiler", "cl.exe compiler [C++], compiling without linking", "cl.exe compiler [C++], controlling linker"] -ms.assetid: eae47ef7-09eb-40c9-b318-7c714cd452fc --- # CL Invokes the Linker @@ -30,7 +29,7 @@ Assume that you are compiling three C source files: MAIN.c, MOD1.c, and MOD2.c. To build this program, compile with the following command line: -``` +```cmd CL MAIN.c MOD1.C MOD2.C MYGRAPH.lib ``` diff --git a/docs/build/reference/common-macros-for-build-commands-and-properties.md b/docs/build/reference/common-macros-for-build-commands-and-properties.md index dfe8c6a5c01..bb52c1458b4 100644 --- a/docs/build/reference/common-macros-for-build-commands-and-properties.md +++ b/docs/build/reference/common-macros-for-build-commands-and-properties.md @@ -2,7 +2,7 @@ description: "Learn more about: Common macros for MSBuild commands and properties" title: "Common macros for MSBuild commands and properties" ms.date: 01/12/2024 -helpviewer_keywords: ["$(FrameworkSDKDir) macro", "ProjectName macro $(ProjectName)", "DevEnvDir macro $(DevEnvDir)", "$(DevEnvDir) macro", "TargetPath macro $(TargetPath)", "VSInstallDir macro $(VSInstallDir)", "$(InputFileName) macro", "$(SolutionFileName) macro", "macros [C++], build macros", "InputFileName macro $(InputFileName)", "$(VCInstallDir) macro", "$(IntDir) macro", "$(ConfigurationName) macro", "SolutionDir macro $(SolutionDir)", "$(TargetPath) macro", "$(Inherit) macro", "$(SolutionPath) macro", "WebDeployRoot macro $(WebDeployRoot)", "WebDeployPath macro $(WebDeployPath)", "StopEvaluating macro $(StopEvaluating)", "$(RootNamespace) macro", "$(WebDeployRoot) macro", "ProjectPath macro $(ProjectPath)", "$(ProjectPath) macro", "$(InputDir) macro", "SolutionName macro $(SolutionName)", "ProjectExt macro $(ProjectExt)", "$(TargetExt) macro", "$(ProjectFileName) macro", "TargetName macro $(TargetName)", "$(References) macro", "References macro $(References)", "TargetExt macro $(TargetExt)", "ProjectDir macro $(ProjectDir)", "$(TargetDir) macro", "SolutionExt macro $(SolutionExt)", "$(SolutionDir) macro", "ProjectFileName macro $(ProjectFileName)", "VCInstallDir macro $(VCInstallDir)", "$(InputExt) macro", "$(TargetFileName) macro", "$(SolutionExt) macro", "PlatformName macro $(PlatformName)", "IntDir macro $(IntDir)", "$(FrameworkVersion) macro", "$(ProjectDir) macro", "build macros [C++]", "InputPath macro $(InputPath)", "$(VSInstallDir) macro", "$(WebDeployPath) macro", "TargetFileName macro $(TargetFileName)", "NoInherit macro $(NoInherit)", "ConfigurationName macro $(ConfigurationName)", "$(ProjectExt) macro", "TargetDir macro $(TargetDir)", "InputName macro $(InputName)", "$(ProjectName) macro", "FrameworkSDKDir macro $(FrameworkSDKDir)", "$(ParentName) macro", "InputExt macro $(InputExt)", "$(SafeRootNamespace) macro", "InputDir macro $(InputDir)", "$(FxCopDir) macro", "$(RemoteMachine) macro", "Inherit macro $(Inherit)", "FrameworkVersion macro $(FrameworkVersion)", "$(StopEvaluating) macro", "$(OutDir) macro", "FrameworkDir macro $(FrameworkDir)", "SolutionFileName macro $(SolutionFileName)", "$(NoInherit) macro", "RemoteMachine macro $(RemoteMachine)", "properties [C++], build property macros", "$(TargetName) macro", "$(SolutionName) macro", "$(InputPath) macro", "ParentName macro $(ParentName)", "OutDir macro $(OutDir)", "SafeRootNamespace macro $(SafeRootNamespace)", "FxCopDir macro $(FxCopDir)", "$(InputName) macro", "RootNamespace macro $(RootNamespace)", "builds [C++], macros", "$(FrameworkDir) macro", "$(PlatformName) macro", "$(PlatformShortName) macro","SolutionPath macro $(SolutionPath)"] +helpviewer_keywords: ["$(FrameworkSDKDir) macro", "ProjectName macro $(ProjectName)", "DevEnvDir macro $(DevEnvDir)", "$(DevEnvDir) macro", "TargetPath macro $(TargetPath)", "VSInstallDir macro $(VSInstallDir)", "$(InputFileName) macro", "$(SolutionFileName) macro", "macros [C++], build macros", "InputFileName macro $(InputFileName)", "$(VCInstallDir) macro", "$(IntDir) macro", "$(ConfigurationName) macro", "SolutionDir macro $(SolutionDir)", "$(TargetPath) macro", "$(Inherit) macro", "$(SolutionPath) macro", "WebDeployRoot macro $(WebDeployRoot)", "WebDeployPath macro $(WebDeployPath)", "StopEvaluating macro $(StopEvaluating)", "$(RootNamespace) macro", "$(WebDeployRoot) macro", "ProjectPath macro $(ProjectPath)", "$(ProjectPath) macro", "$(InputDir) macro", "SolutionName macro $(SolutionName)", "ProjectExt macro $(ProjectExt)", "$(TargetExt) macro", "$(ProjectFileName) macro", "TargetName macro $(TargetName)", "$(References) macro", "References macro $(References)", "TargetExt macro $(TargetExt)", "ProjectDir macro $(ProjectDir)", "$(TargetDir) macro", "SolutionExt macro $(SolutionExt)", "$(SolutionDir) macro", "ProjectFileName macro $(ProjectFileName)", "VCInstallDir macro $(VCInstallDir)", "$(InputExt) macro", "$(TargetFileName) macro", "$(SolutionExt) macro", "PlatformName macro $(PlatformName)", "IntDir macro $(IntDir)", "$(FrameworkVersion) macro", "$(ProjectDir) macro", "build macros [C++]", "InputPath macro $(InputPath)", "$(VSInstallDir) macro", "$(WebDeployPath) macro", "TargetFileName macro $(TargetFileName)", "NoInherit macro $(NoInherit)", "ConfigurationName macro $(ConfigurationName)", "$(ProjectExt) macro", "TargetDir macro $(TargetDir)", "InputName macro $(InputName)", "$(ProjectName) macro", "FrameworkSDKDir macro $(FrameworkSDKDir)", "$(ParentName) macro", "InputExt macro $(InputExt)", "$(SafeRootNamespace) macro", "InputDir macro $(InputDir)", "$(FxCopDir) macro", "$(RemoteMachine) macro", "Inherit macro $(Inherit)", "FrameworkVersion macro $(FrameworkVersion)", "$(StopEvaluating) macro", "$(OutDir) macro", "FrameworkDir macro $(FrameworkDir)", "SolutionFileName macro $(SolutionFileName)", "$(NoInherit) macro", "RemoteMachine macro $(RemoteMachine)", "properties [C++], build property macros", "$(TargetName) macro", "$(SolutionName) macro", "$(InputPath) macro", "ParentName macro $(ParentName)", "OutDir macro $(OutDir)", "SafeRootNamespace macro $(SafeRootNamespace)", "FxCopDir macro $(FxCopDir)", "$(InputName) macro", "RootNamespace macro $(RootNamespace)", "builds [C++], macros", "$(FrameworkDir) macro", "$(PlatformName) macro", "$(PlatformShortName) macro","SolutionPath macro $(SolutionPath)", "ShortProjectName macro $(ShortProjectName)"] --- # Common macros for MSBuild commands and properties @@ -44,6 +44,7 @@ This table describes a commonly used subset of the available macros; there are m | **`$(ProjectExt)`** | The file extension of the project. It includes the '.' before the file extension. | | **`$(ProjectFileName)`** | The file name of the project (defined as base name + file extension). | | **`$(ProjectName)`** | The base name of the project. | +| **`$(ShortProjectName)`** | Shortened project name used when `IntDir` is unset; defaults to `$(ProjectName)` but truncates long names to `ProjectName.Substring(0,8).ProjectGuid.Substring(1,8)` to keep intermediate paths short and unique. | | **`$(ProjectPath)`** | The absolute path name of the project (defined as drive + path + base name + file extension). | | **`$(PublishDir)`** | The output location for the publish target; includes the trailing backslash (\\). Defaults to the **`$(OutDir)app.publish\`** folder. | | **`$(RemoteMachine)`** | Set to the value of the **Remote Machine** property on the Debug property page. For more information, see [Changing Project Settings for a C/C++ Debug Configuration](/visualstudio/debugger/project-settings-for-a-cpp-debug-configuration). | diff --git a/docs/build/reference/compiler-command-line-syntax.md b/docs/build/reference/compiler-command-line-syntax.md index 6936391ed25..e34ddaab592 100644 --- a/docs/build/reference/compiler-command-line-syntax.md +++ b/docs/build/reference/compiler-command-line-syntax.md @@ -1,15 +1,14 @@ --- -description: "Learn more about: Compiler Command-Line Syntax" title: "MSVC Compiler Command-Line Syntax" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Command-Line Syntax" +ms.date: 11/04/2016 helpviewer_keywords: ["syntax, CL compiler command line", "cl.exe compiler, command-line syntax"] -ms.assetid: acba2c1c-0803-4a3a-af25-63e849b930a2 --- # Compiler Command-Line Syntax The CL command line uses the following syntax: -``` +```cmd CL [option...] file... [option | file]... [lib...] [@command-file] [/link link-opt...] ``` @@ -17,7 +16,7 @@ The following table describes input to the CL command. |Entry|Meaning| |-----------|-------------| -|*option*|One or more [CL options](compiler-options.md). Note that all options apply to all specified source files. Options are specified by either a forward slash (/) or a dash (-). If an option takes an argument, the option's description documents whether a space is allowed between the option and the arguments. Option names (except for the /HELP option) are case sensitive. For more information, see [Order of CL Options](order-of-cl-options.md).| +|*option*|One or more [CL options](compiler-options.md). All options apply to all specified source files. Specify options using either a forward slash (/) or a dash (-). Generally, there can't be a space between the option and argument. The option's description states when a space is allowed. Options are case-sensitive--except for `/HELP`. For more information, see [Order of CL Options](order-of-cl-options.md).| |`file`|The name of one or more source files, .obj files, or libraries. CL compiles source files and passes the names of the .obj files and libraries to the linker. For more information, see [CL Filename Syntax](cl-filename-syntax.md).| |*lib*|One or more library names. CL passes these names to the linker.| |*command-file*|A file that contains multiple options and filenames. For more information, see [CL Command Files](cl-command-files.md).| diff --git a/docs/build/reference/compiler-options-listed-alphabetically.md b/docs/build/reference/compiler-options-listed-alphabetically.md index 82a2bf89c2d..193a21544b1 100644 --- a/docs/build/reference/compiler-options-listed-alphabetically.md +++ b/docs/build/reference/compiler-options-listed-alphabetically.md @@ -1,7 +1,7 @@ --- title: "Compiler options listed alphabetically" description: "Reference listing in alphabetical order of the Microsoft C/C++ compiler command-line options." -ms.date: 11/13/2023 +ms.date: 2/5/2025 helpviewer_keywords: ["compiler options, C++"] --- # Compiler options listed alphabetically @@ -35,8 +35,9 @@ This table contains an alphabetical list of compiler options. For a list of comp | [`/clr:safe`](clr-common-language-runtime-compilation.md) | Produce an IL-only verifiable output file. | | [`/constexpr:backtrace`](constexpr-control-constexpr-evaluation.md) | Show N `constexpr` evaluations in diagnostics (default: 10). | | [`/constexpr:depth`](constexpr-control-constexpr-evaluation.md) | Recursion depth limit for `constexpr` evaluation (default: 512). | -| [`/constexpr:steps`](constexpr-control-constexpr-evaluation.md) | Terminate `constexpr` evaluation after N steps (default: 100000) | +| [`/constexpr:steps`](constexpr-control-constexpr-evaluation.md) | Terminate `constexpr` evaluation after N steps (default: 100000). | | [`/D{=|#}`](d-preprocessor-definitions.md) | Defines constants and macros. | +| [`/dynamicdeopt`](dynamic-deopt.md) | Enable [C++ Dynamic Debugging (Preview)](/visualstudio/debugger/cpp-dynamic-debugging) and step in anywhere with on-demand function deoptimization. | | [`/diagnostics`](diagnostics-compiler-diagnostic-options.md) | Diagnostics format: prints column information. | | [`/diagnostics:caret[-]`](diagnostics-compiler-diagnostic-options.md) | Diagnostics format: prints column and the indicated line of source. | | [`/diagnostics:classic`](diagnostics-compiler-diagnostic-options.md) | Use legacy diagnostics format. | @@ -66,6 +67,7 @@ This table contains an alphabetical list of compiler options. For a list of comp | [`/Fd`](fd-program-database-file-name.md) | Renames program database file. | | [`/Fe`](fe-name-exe-file.md) | Renames the executable file. | | [`/feature`](feature-arm64.md) | Enable architecture features.17.10 | +| [`/forceInterlockedFunctions`](force-interlocked-functions.md) | Dynamically selects between Armv8.0 load, store exclusive instructions or Armv8.1 LSE atomic instructions based on target CPU.17.14 | | [`/FI`](fi-name-forced-include-file.md) | Preprocesses the specified include file. | | [`/Fi`](fi-preprocess-output-file-name.md) | Specifies the preprocessed output file name. | | [`/Fm`](fm-name-mapfile.md) | Creates a mapfile. | @@ -83,7 +85,7 @@ This table contains an alphabetical list of compiler options. For a list of comp | [`/fsanitize`](fsanitize.md) | Enables compilation of sanitizer instrumentation such as AddressSanitizer. | | [`/fsanitize-coverage`](fsanitize-coverage.md) | Enables compilation of code coverage instrumentation for libraries such as LibFuzzer. | | `/Ft` | Location of the header files generated for `#import`. | -| [`/FU`](fu-name-forced-hash-using-file.md) | Forces the use of a file name, as if it had been passed to the [`#using`](../../preprocessor/hash-using-directive-cpp.md) directive. | +| [`/FU`](fu-name-forced-hash-using-file.md) | Forces the use of a file name, as if it were passed to the [`#using`](../../preprocessor/hash-using-directive-cpp.md) directive. | | [`/Fx`](fx-merge-injected-code.md) | Merges injected code with the source file. | | [`/GA`](ga-optimize-for-windows-application.md) | Optimizes for Windows applications. | | [`/Gd`](gd-gr-gv-gz-calling-convention.md) | Uses the **`__cdecl`** calling convention. (x86 only) | @@ -227,7 +229,7 @@ This table contains an alphabetical list of compiler options. For a list of comp | [`/Zc:externConstexpr[-]`](zc-externconstexpr.md) | Enable external linkage for **`constexpr`** variables (off by default). | | [`/Zc:forScope[-]`](zc-forscope-force-conformance-in-for-loop-scope.md) | Enforce Standard C++ **`for`** scoping rules (on by default). | | [`/Zc:gotoScope`](zc-gotoscope.md) | Enforce Standard C++ **`goto`** rules around local variable initialization (implied by **`/permissive-`**). | -| [`/Zc:hiddenFriend[-]`](zc-hiddenfriend.md) | Enforce Standard C++ hidden friend rules (implied by **`/permissive-`**) | +| [`/Zc:hiddenFriend[-]`](zc-hiddenfriend.md) | Enforce Standard C++ hidden friend rules (implied by **`/permissive-`**). | | [`/Zc:implicitNoexcept[-]`](zc-implicitnoexcept-implicit-exception-specifiers.md) | Enable implicit **`noexcept`** on required functions (on by default). | | [`/Zc:inline[-]`](zc-inline-remove-unreferenced-comdat.md) | Remove unreferenced functions or data if they're COMDAT or have internal linkage only (off by default). | | [`/Zc:lambda[-]`](zc-lambda.md) | Enable new lambda processor for conformance-mode syntactic checks in generic lambdas. | @@ -259,7 +261,8 @@ This table contains an alphabetical list of compiler options. For a list of comp | [`/Zs`](zs-syntax-check-only.md) | Checks syntax only. | | [`/ZW`](zw-windows-runtime-compilation.md) | Produces an output file to run on the Windows Runtime. | -17.10 This option is available starting in Visual Studio 2022 version 17.10. +17.10 This option is available starting in Visual Studio 2022 version 17.10.\ +17.14 This option is available starting in Visual Studio 2022 version 17.14. ## See also diff --git a/docs/build/reference/compiler-options-listed-by-category.md b/docs/build/reference/compiler-options-listed-by-category.md index 7153251edf8..5b2a78c030d 100644 --- a/docs/build/reference/compiler-options-listed-by-category.md +++ b/docs/build/reference/compiler-options-listed-by-category.md @@ -1,7 +1,7 @@ --- title: "Compiler Options Listed by Category" description: "Reference listing by category of the Microsoft C/C++ compiler command-line options." -ms.date: 11/13/2023 +ms.date: 2/5/2025 helpviewer_keywords: ["compiler options, C++"] --- # Compiler options listed by category @@ -12,6 +12,7 @@ This article contains a categorical list of compiler options. For an alphabetica | Option | Purpose | |--|--| +| [`/dynamicdeopt`](dynamic-deopt.md) | Enable [C++ Dynamic Debugging (Preview)](/visualstudio/debugger/cpp-dynamic-debugging) to debug optimized code as if it had been compiled deoptimized. | | [`/favor:`](favor-optimize-for-architecture-specifics.md) | Produces code that is optimized for a specified architecture, or for a range of architectures. | | [`/O1`](o1-o2-minimize-size-maximize-speed.md) | Creates small code. | | [`/O2`](o1-o2-minimize-size-maximize-speed.md) | Creates fast code. | @@ -43,6 +44,7 @@ This article contains a categorical list of compiler options. For an alphabetica | [`/EHr`](eh-exception-handling-model.md) | Always generate `noexcept` runtime termination checks. | | [`/EHs`](eh-exception-handling-model.md) | Enable C++ exception handling (no SEH exceptions). | | [`/feature`](feature-arm64.md) | Enable architecture features.17.10 | +| [`/forceInterlockedFunctions`](force-interlocked-functions.md) | Dynamically selects between Armv8.0 load, store exclusive instructions or Armv8.1 LSE atomic instructions based on target CPU.17.14 | | [`/fp:contract`](fp-specify-floating-point-behavior.md) | Consider floating-point contractions when generating code. | | [`/fp:except[-]`](fp-specify-floating-point-behavior.md) | Consider floating-point exceptions when generating code. | | [`/fp:fast`](fp-specify-floating-point-behavior.md) | "fast" floating-point model; results are less predictable. | @@ -156,7 +158,7 @@ This article contains a categorical list of compiler options. For an alphabetica | [`/await:strict`](await-enable-coroutine-support.md) | Enable standard C++20 coroutine support with earlier language versions. | | [`/constexpr:backtrace`](constexpr-control-constexpr-evaluation.md) | Show N `constexpr` evaluations in diagnostics (default: 10). | | [`/constexpr:depth`](constexpr-control-constexpr-evaluation.md) | Recursion depth limit for `constexpr` evaluation (default: 512). | -| [`/constexpr:steps`](constexpr-control-constexpr-evaluation.md) | Terminate `constexpr` evaluation after N steps (default: 100000) | +| [`/constexpr:steps`](constexpr-control-constexpr-evaluation.md) | Terminate `constexpr` evaluation after N steps (default: 100000). | | [`/openmp`](openmp-enable-openmp-2-0-support.md) | Enables [`#pragma omp`](../../preprocessor/omp.md) in source code. | | [`/openmp:experimental`](openmp-enable-openmp-2-0-support.md) | Enable OpenMP 2.0 language extensions plus select OpenMP 3.0+ language extensions. | | [`/openmp:llvm`](openmp-enable-openmp-2-0-support.md) | OpenMP language extensions using LLVM runtime. | @@ -181,12 +183,12 @@ This article contains a categorical list of compiler options. For an alphabetica | [`/Zc:alignedNew[-]`](zc-alignednew.md) | Enable C++17 over-aligned dynamic allocation (on by default in C++17). | | [`/Zc:auto[-]`](zc-auto-deduce-variable-type.md) | Enforce the new Standard C++ meaning for **`auto`** (on by default). | | [`/Zc:char8_t[-]`](zc-char8-t.md) | Enable or disable C++20 native `u8` literal support as `const char8_t` (off by default, except under **`/std:c++20`**). | -| [`/Zc:enumTypes[-]`](zc-enumtypes.md) | Enable Standard C++ rules for inferred `enum` base types (Off b y default, not implied by **`/permissive-`**). | +| [`/Zc:enumTypes[-]`](zc-enumtypes.md) | Enable Standard C++ rules for inferred `enum` base types (Off by default, not implied by **`/permissive-`**). | | [`/Zc:externC[-]`](zc-externc.md) | Enforce Standard C++ rules for `extern "C"` functions (implied by **`/permissive-`**). | | [`/Zc:externConstexpr[-]`](zc-externconstexpr.md) | Enable external linkage for **`constexpr`** variables (off by default). | | [`/Zc:forScope[-]`](zc-forscope-force-conformance-in-for-loop-scope.md) | Enforce Standard C++ **`for`** scoping rules (on by default). | | [`/Zc:gotoScope`](zc-gotoscope.md) | Enforce Standard C++ **`goto`** rules around local variable initialization (implied by **`/permissive-`**). | -| [`/Zc:hiddenFriend[-]`](zc-hiddenfriend.md) | Enforce Standard C++ hidden friend rules (implied by **`/permissive-`**) | +| [`/Zc:hiddenFriend[-]`](zc-hiddenfriend.md) | Enforce Standard C++ hidden friend rules (implied by **`/permissive-`**). | | [`/Zc:implicitNoexcept[-]`](zc-implicitnoexcept-implicit-exception-specifiers.md) | Enable implicit **`noexcept`** on required functions (on by default). | | [`/Zc:inline[-]`](zc-inline-remove-unreferenced-comdat.md) | Remove unreferenced functions or data if they're COMDAT or have internal linkage only (off by default). | | [`/Zc:lambda[-]`](zc-lambda.md) | Enable new lambda processor for conformance-mode syntactic checks in generic lambdas. | @@ -208,7 +210,7 @@ This article contains a categorical list of compiler options. For an alphabetica | [`/Zc:zeroSizeArrayNew[-]`](zc-zerosizearraynew.md) | Call member `new`/`delete` for 0-size arrays of objects (on by default). | | [`/Ze`](za-ze-disable-language-extensions.md) | Deprecated. Enables C89 language extensions. | | [`/Zf`](zf.md) | Improves PDB generation time in parallel builds. | -| [`/ZH:[MD5|SHA1|SHA_256]`](zh.md) | Specifies MD5, SHA-1, or SHA-256 for checksums in debug info. | +| [`/ZH`:[MD5|SHA1|SHA_256]](zh.md) | Specifies MD5, SHA-1, or SHA-256 for checksums in debug info. | | [`/ZI`](z7-zi-zi-debug-information-format.md) | Includes debug information in a program database compatible with Edit and Continue. (x86 only) | | [`/Zi`](z7-zi-zi-debug-information-format.md) | Generates complete debugging information. | | [`/Zl`](zl-omit-default-library-name.md) | Removes the default library name from the *`.obj`* file. | @@ -311,7 +313,7 @@ Experimental options may only be supported by certain versions of the compiler. |--|--| | [`/clr:noAssembly`](clr-common-language-runtime-compilation.md) | Deprecated. Use [`/LN` (Create MSIL Module)](ln-create-msil-module.md) instead. | | [`/errorReport`](errorreport-report-internal-compiler-errors.md) | Deprecated. Error reporting is controlled by [Windows Error Reporting (WER)](/windows/win32/wer/windows-error-reporting) settings. | -| [`/experimental:preprocessor`](experimental-preprocessor.md) | Deprecated. Enables experimental conforming preprocessor support. Use [`/Zc:preprocessor`](zc-preprocessor.md) | +| [`/experimental:preprocessor`](experimental-preprocessor.md) | Deprecated. Enables experimental conforming preprocessor support. Use [`/Zc:preprocessor`](zc-preprocessor.md) instead. | | [`/Fr`](fr-fr-create-dot-sbr-file.md) | Deprecated. Creates a browse information file without local variables. | | [`/Ge`](ge-enable-stack-probes.md) | Deprecated. Activates stack probes. On by default. | | [`/Gm`](gm-enable-minimal-rebuild.md) | Deprecated. Enables minimal rebuild. | @@ -327,7 +329,8 @@ Experimental options may only be supported by certain versions of the compiler. | [`/Ze`](za-ze-disable-language-extensions.md) | Deprecated. Enables language extensions. | | [`/Zg`](zg-generate-function-prototypes.md) | Removed in Visual Studio 2015. Generates function prototypes. | -17.10 This option is available starting in Visual Studio 2022 version 17.10. +17.10 This option is available starting in Visual Studio 2022 version 17.10.\ +17.14 This option is available starting in Visual Studio 2022 version 17.14. ## See also diff --git a/docs/build/reference/constexpr-control-constexpr-evaluation.md b/docs/build/reference/constexpr-control-constexpr-evaluation.md index 6bee6fa00a3..9052345e64e 100644 --- a/docs/build/reference/constexpr-control-constexpr-evaluation.md +++ b/docs/build/reference/constexpr-control-constexpr-evaluation.md @@ -1,45 +1,42 @@ --- description: "Learn more about: /constexpr (Control constexpr evaluation)" title: "/constexpr (Control constexpr evaluation)" -ms.date: "08/15/2017" +ms.date: 04/14/2025 f1_keywords: ["/constexpr", "-constexpr"] helpviewer_keywords: ["/constexpr control constexpr evaluation [C++]", "-constexpr control constexpr evaluation [C++]", "constexpr control constexpr evaluation [C++]"] -ms.assetid: 76d56784-f5ad-401d-841d-09d1059e8b8c --- # /constexpr (Control constexpr evaluation) -Use the **/constexpr** compiler options to control parameters for **`constexpr`** evaluation at compile time. +Use the **`/constexpr`** compiler options to control parameters for **`constexpr`** evaluation at compile time. ## Syntax -> **/constexpr:depth**N\ -> **/constexpr:backtrace**N\ -> **/constexpr:steps**N +> `/constexpr:depth`N\ +> `/constexpr:backtrace`N\ +> `/constexpr:steps`N ## Arguments -**depth**N +**`depth`**N\ Limit the depth of recursive **`constexpr`** function invocation to *N* levels. The default is 512. -**backtrace**N +**`backtrace`**N\ Show up to *N* **`constexpr`** evaluations in diagnostics. The default is 10. -**steps**N -Terminate **`constexpr`** evaluation after *N* steps. The default is 100,000. +**`steps`**N\ +Terminate **`constexpr`** evaluation after *N* steps. The default is 100,000. A step refers to an individual computation taken towards evaluating the constant expression. Increasing the maximum number of steps might cause compilation to take longer in cases where compilation would otherwise fail. ## Remarks -The **/constexpr** compiler options control compile-time evaluation of **`constexpr`** expressions. Evaluation steps, recursion levels, and backtrace depth are controlled to prevent the compiler from spending too much time on **`constexpr`** evaluation. For more information on the **`constexpr`** language element, see [constexpr (C++)](../../cpp/constexpr-cpp.md). +The **`/constexpr`** compiler options control compile-time evaluation of **`constexpr`** expressions. Evaluation steps, recursion levels, and backtrace depth are controlled to prevent the compiler from spending too much time on **`constexpr`** evaluation. For more information on the **`constexpr`** language element, see [`constexpr` (C++)](../../cpp/constexpr-cpp.md). -The **/constexpr** options are available beginning in Visual Studio 2015. +The **`/constexpr`** flag is available beginning in Visual Studio 2015. ### To set this compiler option in the Visual Studio development environment 1. Open your project's **Property Pages** dialog box. - 1. Select the **Configuration Properties** > **C/C++** > **Command Line** property page. - -1. Enter any **/constexpr** compiler options in the **Additional Options** box. Choose **OK** or **Apply** to save your changes. +1. Enter **/constexpr** compiler options in the **Additional Options** box. Choose **OK** to save your changes. ### To set this compiler option programmatically @@ -47,5 +44,5 @@ The **/constexpr** options are available beginning in Visual Studio 2015. ## See also -[MSVC Compiler Options](compiler-options.md)
+[MSVC Compiler Options](compiler-options.md)\ [MSVC Compiler Command-Line Syntax](compiler-command-line-syntax.md) diff --git a/docs/build/reference/creating-a-makefile-project.md b/docs/build/reference/creating-a-makefile-project.md index 1f88156dfd8..566ed5e134c 100644 --- a/docs/build/reference/creating-a-makefile-project.md +++ b/docs/build/reference/creating-a-makefile-project.md @@ -30,7 +30,13 @@ The output file that you specify in the project has no effect on the name that t ### To create a makefile project in Visual Studio -1. From the Visual Studio main menu, choose **File** > **New** > **Project** and type "makefile" into the search box. If you see more than one project template, select from the options depending on your target platform. +1. From the Visual Studio main menu, choose **File** > **New** > **Project/Solution**. + + :::image type="content" source="media/file-new-project.png" alt-text="Screenshot of the File > New > Project/Solution menu item."::: + +1. Type *makefile* into the search box. If you see more than one project template, select the option for your target platform. + + :::image type="content" source="media/create-project.png" alt-text="Screenshot of the Create a new project dialog. The Create a new project text field text box contains the text: makefile."::: 1. **Windows only**: In the Makefile project **Debug Configuration Settings** page, provide the command, output, clean, and rebuild information for debug and retail builds. Choose **Next** if you want to specify different settings for a Release configuration. diff --git a/docs/build/reference/debug-generate-debug-info.md b/docs/build/reference/debug-generate-debug-info.md index 85a515debab..9716f477b56 100644 --- a/docs/build/reference/debug-generate-debug-info.md +++ b/docs/build/reference/debug-generate-debug-info.md @@ -1,7 +1,7 @@ --- description: "Learn more about: /DEBUG (Generate debug info)" title: "/DEBUG (Generate Debug Info)" -ms.date: 10/26/2023 +ms.date: 09/08/2025 f1_keywords: ["VC.Project.VCLinkerTool.GenerateDebugInformation", "/debug"] helpviewer_keywords: ["DEBUG linker option", "/DEBUG linker option", "-DEBUG linker option", "PDB files", "debugging [C++], debug information files", "generate debug info linker option", "pdb files, generating debug info", ".pdb files, generating debug info", "debugging [C++], linker option", "program databases [C++]"] ms.assetid: 1af389ae-3f8b-4d76-a087-1cdf861e9103 @@ -20,7 +20,10 @@ The **`/DEBUG`** option puts the debugging information from linked object and li An executable (an EXE or DLL file) created for debugging contains the name and path of the corresponding PDB. The debugger reads the embedded name and uses the PDB when you debug the program. The linker uses the base name of the program and the extension *`.pdb`* to name the program database, and embeds the path where it was created. To override this default, set the [`/PDB`](pdb-use-program-database.md) option and specify a different file name. -The **`/DEBUG:FASTLINK`** option is available in Visual Studio 2017 and later. This option generates a limited PDB that indexes into the debug information in the object files and libraries used to build the executable instead of making a full copy. You can only use this limited PDB to debug from the computer where the binary and its libraries were built. If you deploy the binary elsewhere, you may debug it remotely from the build computer, but not directly on the test computer. Since Visual Studio 2019, **`/DEBUG:FULL`** linking times have improved significantly, and **`/DEBUG:FASTLINK`** isn't always faster than **`/DEBUG:FULL`**. Since **`/DEBUG:FASTLINK`** no longer provides large build time improvements and results in a slower debugging experience versus **`/DEBUG:FULL`**, this option is no longer recommended. +> [!Note] +> The **`/DEBUG:FASTLINK`** option is **deprecated and removed** starting in Visual Studio 2026. It was available in Visual Studio 2017 through Visual Studio 2022. + +**`/DEBUG:FASTLINK`** generated a limited PDB that indexes into the debug information in the object files and libraries used to build the executable instead of making a full copy. You can only use this limited PDB to debug from the computer where the binary and its libraries were built. If you deploy the binary elsewhere, you may debug it remotely from the build computer, but not directly on the test computer. Since Visual Studio 2019, **`/DEBUG:FULL`** linking times have improved significantly, and **`/DEBUG:FASTLINK`** isn't always faster than **`/DEBUG:FULL`**. Since **`/DEBUG:FASTLINK`** no longer provides large build time improvements and results in a slower debugging experience versus **`/DEBUG:FULL`**, this option is no longer recommended, and is removed in Visual Studio 2026. Prefer using **`/DEBUG:FULL`**. A **`/DEBUG:FASTLINK`** PDB can be converted to a full PDB that you can deploy to a test machine for local debugging. In Visual Studio, use the **Property Pages** dialog as described below to create a full PDB for the project or solution. In a developer command prompt, you can use the `mspdbcmf.exe` tool to create a full PDB. @@ -41,11 +44,8 @@ It isn't possible to create an EXE or DLL that contains debug information. Debug ### To set this linker option in the Visual Studio development environment 1. Open the project's **Property Pages** dialog box. For details, see [Set C++ compiler and build properties in Visual Studio](../working-with-project-properties.md). - 1. Select the **Linker** > **Debugging** property page. - 1. Modify the **Generate Debug Info** property to enable or disable PDB generation. This property enables **`/DEBUG:FASTLINK`** by default in Visual Studio 2017 and later. - 1. Modify the **Generate Full Program Database File** property to enable **`/DEBUG:FULL`** for full PDB generation for every incremental build. ### To set this linker option programmatically diff --git a/docs/build/reference/decorated-names.md b/docs/build/reference/decorated-names.md index 6370302c0d6..4b5a674a640 100644 --- a/docs/build/reference/decorated-names.md +++ b/docs/build/reference/decorated-names.md @@ -53,10 +53,11 @@ The form of decoration for a C function depends on the calling convention used i | Calling convention | Decoration | |--|--| -| **`__cdecl`** | Leading underscore (**`_`**) | -| **`__stdcall`** | Leading underscore (**`_`**) and a trailing at sign (**`@`**) followed by the number of bytes in the parameter list in decimal | -| **`__fastcall`** | Leading and trailing at signs (**`@`**) followed by a decimal number representing the number of bytes in the parameter list | -| **`__vectorcall`** | Two trailing at signs (**`@@`**) followed by a decimal number of bytes in the parameter list | +| [**`__cdecl`**](../../cpp/cdecl.md) | Leading underscore (**`_`**) | +| [**`__stdcall`**](../../cpp/stdcall.md) | Leading underscore (**`_`**) and a trailing at sign (**`@`**) followed by the number of bytes in the parameter list in decimal | +| [**`__fastcall`**](../../cpp/fastcall.md) | Leading and trailing at signs (**`@`**) followed by a decimal number representing the number of bytes in the parameter list | +| [**`__vectorcall`**](../../cpp/vectorcall.md) | Two trailing at signs (**`@@`**) followed by a decimal number of bytes in the parameter list | +| [**`__preserve_none`**](../../cpp/preserve-none.md) | Two trailing at signs, an underscore and the 'A' character (**`@@_A`**) | For ARM64EC functions with C linkage (whether compiled as C or by using `extern "C"`), a **`#`** is prepended to the decorated name. diff --git a/docs/build/reference/def-specify-module-definition-file.md b/docs/build/reference/def-specify-module-definition-file.md index 5d6c186f61c..42e938c3ff6 100644 --- a/docs/build/reference/def-specify-module-definition-file.md +++ b/docs/build/reference/def-specify-module-definition-file.md @@ -1,10 +1,9 @@ --- description: "Learn more about: /DEF (Specify module-definition file)" title: "/DEF (Specify module-definition file)" -ms.date: 09/09/2022 +ms.date: 03/27/2025 f1_keywords: ["VC.Project.VCLinkerTool.ModuleDefinitionFile", "/def"] helpviewer_keywords: ["module definition files, specifying", "DEF linker option", "-DEF linker option", "module definition files", "/DEF linker option"] -ms.assetid: 6497fa68-65f0-48ca-8f66-b87166fc631a --- # `/DEF` (Specify module-definition file) @@ -17,7 +16,7 @@ Specifies a module-definition file to the linker. ## Arguments *`filename`*\ -The name of a module-definition file (*`.def`*) to be passed to the linker. +The name of a module-definition file (*`.def`*) to be passed to the linker. When expanded, the fully qualified filename must not exceed `MAX_PATH` (260 characters). ## Remarks @@ -28,9 +27,7 @@ To specify a *`.def`* file from within the development environment, add it to th ### To set this linker option in the Visual Studio development environment 1. Open the project's **Property Pages** dialog box. For more information, see [Set compiler and build properties](../working-with-project-properties.md). - 1. Select the **Configuration Properties** > **Linker** > **Input** property page. - 1. Modify the **Module Definition File** property. Choose **OK** or **Apply** to save your changes. ### To set this linker option programmatically diff --git a/docs/build/reference/dumpbin-options.md b/docs/build/reference/dumpbin-options.md index 2bedc34b9e1..71bd3a9c66a 100644 --- a/docs/build/reference/dumpbin-options.md +++ b/docs/build/reference/dumpbin-options.md @@ -1,9 +1,8 @@ --- title: "DUMPBIN options" description: "Reference guide to the Microsoft DUMPBIN utility command-line options." -ms.date: "02/09/2020" +ms.date: 02/09/2020 helpviewer_keywords: ["DUMPBIN program, options"] -ms.assetid: 563b696e-7599-4480-94b9-014776289ec8 --- # DUMPBIN options @@ -49,7 +48,7 @@ DUMPBIN has the following options: - [/PDBPATH\[:VERBOSE\]](pdbpath.md) -- [/RANGEE:vaMin\[,vaMax\]](range.md) +- [/RANGE:vaMin\[,vaMax\]](range.md) - [/RAWDATA\[:{NONE\|1\|2\|4\|8}\[,#\]\]](rawdata.md) diff --git a/docs/build/reference/dynamic-deopt-linker.md b/docs/build/reference/dynamic-deopt-linker.md new file mode 100644 index 00000000000..6d4602acfc5 --- /dev/null +++ b/docs/build/reference/dynamic-deopt-linker.md @@ -0,0 +1,53 @@ +--- +title: "/DYNAMICDEOPT (Support C++ Dynamic Debugging) (Preview)" +description: "Learn more about: /DYNAMICDEOPT (Support C++ Dynamic Debugging)." +ms.date: 03/14/2025 +f1_keywords: ["VC.Project.VCLinkerTool.GenerateDynamicDeoptInformation", "/dynamicdeopt"] +helpviewer_keywords: ["DYNAMICDEOPT linker option", "/DYNAMICDEOPT linker option", "-DYNAMICDEOPT linker option", "c++ dynamic debugging"] +--- +# `/DYNAMICDEOPT` (Support C++ Dynamic Debugging) (Preview) + +> [!IMPORTANT] +> The `/DYNAMICDEOPT` linker switch is currently in PREVIEW. +> This information relates to a prerelease feature that might be substantially modified before release. Microsoft makes no warranties, expressed or implied, with respect to the information provided here. + +The **`/DYNAMICDEOPT`** linker option, when used with the compiler switch [`/dynamicdeopt`](dynamic-deopt.md), enables [C++ Dynamic Debugging (Preview)](/visualstudio/debugger/cpp-dynamic-debugging), which allows you to debug optimized code as if it were compiled deoptimized and step in anywhere with on-demand function deoptimization. + +## Syntax + +> **`/DYNAMICDEOPT`**\ +> **`/DYNAMICDEOPT:SUFFIX=`**\ +> **`/DYNAMICDEOPT:SYNC`** + +## Arguments + +*`suffix`*\ +Specify the file extension for the deoptimized output. + +With no options and given `test.cpp` as input, the compiler output includes `test.obj`, `test.exe`, and `test.pdb`, as well as `test.alt.obj`, `test.alt.exe`, and `test.alt.pdb`. This switch allows you to change the suffix for the unoptimized binary build artifacts from `.alt` to something else. If you change the suffix, all files must use the new suffix, and it needs to match the name passed to the compiler using [`/dynamicdeopt:suffix` (Preview)](dynamic-deopt.md). You typically don't use this switch unless you need to avoid filename collisions with other files that you have. + +*`SYNC`*\ +Builds the deoptimized output after building the optimized output instead of in parallel. By default, the compiler spawns a parallel linker to link the unoptimized binary. This switch makes the second link run serially after the first one. This switch is provided in case this better suits your build environment. + +## Remarks + +This preview flag, available starting with Visual Studio 2022 Version 17.14 Preview 2, applies only to x64 projects. + +IncrediBuild 10.24 supports C++ Dynamic Debugging builds.\ +FastBuild v1.15 supports C++ Dynamic Debugging builds. + +### Set this linker option in the Visual Studio development environment + +1. Open the project's **Property Pages** dialog box. For details, see [Set C++ compiler and build properties in Visual Studio](../working-with-project-properties.md). +1. Select the **Linker** > **Debugging** property page. + +### Set this linker option programmatically + +- See . + +## See also + +[`/dynamicdeopt` (Enable C++ Dynamic Debugging) (Preview)](dynamic-deopt.md)\ +[C++ Dynamic Debugging (Preview)](/visualstudio/debugger/cpp-dynamic-debugging)\ +[MSVC linker reference](linking.md)\ +[MSVC linker options](linker-options.md) diff --git a/docs/build/reference/dynamic-deopt.md b/docs/build/reference/dynamic-deopt.md new file mode 100644 index 00000000000..33edd942e31 --- /dev/null +++ b/docs/build/reference/dynamic-deopt.md @@ -0,0 +1,78 @@ +--- +title: "/dynamicdeopt (Enable C++ Dynamic Debugging (Preview))" +description: "Enable the Microsoft C++ compiler option /dynamicdeopt to use C++ Dynamic Debugging." +ms.date: 04/01/2025 +f1_keywords: ["/dynamicdeopt"] +helpviewer_keywords: ["-dynamicdeopt compiler option [C++]", "dynamicdeopt compiler option [C++]"] +--- +# `/dynamicdeopt` (Enable C++ Dynamic Debugging) (Preview) + +> [!IMPORTANT] +> The `/dynamicdeopt` compiler switch is currently in PREVIEW. +> This information relates to a prerelease feature that might be substantially modified before release. Microsoft makes no warranties, expressed or implied, with respect to the information provided here. + +Enable [C++ Dynamic Debugging (Preview)](/visualstudio/debugger/cpp-dynamic-debugging) so you can debug optimized code as if it were compiled deoptimized and step in anywhere with on-demand function deoptimization. + +## Syntax + +> **`/dynamicdeopt`**\ +> **`/dynamicdeopt:suffix `**\ +> **`/dynamicdeopt:sync`** + +## Arguments + +*`suffix`*\ +Specify the file extension for the deoptimized output. + +With no options and given `test.cpp` as input, your output includes `test.obj`, `test.exe`, and `test.pdb`, as well as `test.alt.obj`, `test.alt.exe`, and `test.alt.pdb`. This switch allows you to change the suffix of the unoptimized binary build artifacts from `.alt` to something else. If you change the suffix, all files must use the new suffix, and it needs to match the name passed to the linker using [`/dynamicdeopt:suffix` (Preview)](dynamic-deopt-linker.md). You typically don't use this switch unless you need to avoid filename collisions with other files that you have. + +*`sync`*\ +Builds the deoptimized output after building the optimized output instead of in parallel. By default, the compiler spawns a parallel instance of the code generator. This switch makes them run serially instead. This switch is provided in case this better suits your build environment. + +## Remarks + +This preview flag, available starting with Visual Studio 2022 Version 17.14 Preview 2, applies only to x64 projects and must be used with the corresponding linker flag, [`/DYNAMICDEOPT`](dynamic-deopt-linker.md). + +Compiling with `/dynamicdeopt` generates other binaries that are used for debugging. When you debug an optimized function in an optimized file, the debugger steps into the alternate binary instead. This allows you to debug as if you're debugging unoptimized code while still getting the performance advantages of optimized code. + +`/dynamicdeopt` requires: + +`/DEBUG` or `/DEBUG:FULL`. If you don't specify `/DEBUG`, or if you specify `/DEBUG:FASTLINK`, the linker gives a fatal error. +If you specify `/INCREMENTAL`, the compiler generates a warning and automatically turns off `/INCREMENTAL`. +If you specify `/OPT:ICF`, the compiler generates a warning that the debug experience isn't as good. This is because ICF can cause functions to be removed from the alt file, which means you can't step into them. + +IncrediBuild 10.24 supports C++ Dynamic Debugging builds.\ +FastBuild v1.15 supports C++ Dynamic Debugging builds. + +`/dynamicdeopt` is incompatible with edit-and-continue and the following compiler switches: + +```cpp +/GL +/ZI +/RTC1 +/RTCs +/RTCc +/RTCu +/GH +/Gh +/fastcap +/callcap +/ZW +/fsanitize=address +/fsanitize=kernel-address +All of the CLR flags +``` + +### Set this linker option in the Visual Studio development environment + +You can set this switch inside Visual Studio. For more information, see [C++ Dynamic Debugging (Preview)](/visualstudio/debugger/cpp-dynamic-debugging#build-system-integration). There are advantages to setting the switch in Visual Studio because MSBuild automatically suppresses some of the incompatible switches such as `/GL` and `/OPT:ICF`. It also sets the corresponding linker option (`/DYNAMICDEOPT`). You can also set the switch in the command line. + +### Set this compiler option programmatically + +- See . + +## See also + +[C++ Dynamic Debugging (Preview)](/visualstudio/debugger/cpp-dynamic-debugging)\ +[MSVC Compiler Options](compiler-options.md)\ +[MSVC Compiler Command-Line Syntax](compiler-command-line-syntax.md) diff --git a/docs/build/reference/e-preprocess-to-stdout.md b/docs/build/reference/e-preprocess-to-stdout.md index c2e2f9d98f1..7426af03468 100644 --- a/docs/build/reference/e-preprocess-to-stdout.md +++ b/docs/build/reference/e-preprocess-to-stdout.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: /E (Preprocess to stdout)" title: "/E (Preprocess to stdout)" -ms.date: "11/04/2016" +description: "Learn more about: /E (Preprocess to stdout)" +ms.date: 11/04/2016 f1_keywords: ["/e"] helpviewer_keywords: ["-E compiler option [C++]", "/E compiler option [C++]", "preprocessor output, copy to stdout", "preprocessor output"] -ms.assetid: ddbb1725-d950-4978-ab2f-30a5cd7b778c --- # /E (Preprocess to stdout) @@ -44,7 +43,7 @@ m(int)main( ) However, if you compile with: -``` +```cmd cl -E test.cpp > test2.cpp ``` @@ -66,7 +65,7 @@ cl -E test.cpp > test2.cpp The following command line preprocesses `ADD.C`, preserves comments, adds `#line` directives, and displays the result on the standard output device: -``` +```cmd CL /E /C ADD.C ``` diff --git a/docs/build/reference/ep-preprocess-to-stdout-without-hash-line-directives.md b/docs/build/reference/ep-preprocess-to-stdout-without-hash-line-directives.md index 0c1deff9db2..61d030c0814 100644 --- a/docs/build/reference/ep-preprocess-to-stdout-without-hash-line-directives.md +++ b/docs/build/reference/ep-preprocess-to-stdout-without-hash-line-directives.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: /EP (Preprocess to stdout Without #line Directives)" title: "/EP (Preprocess to stdout Without #line Directives)" -ms.date: "11/04/2016" +description: "Learn more about: /EP (Preprocess to stdout Without #line Directives)" +ms.date: 11/04/2016 f1_keywords: ["/ep", "VC.Project.VCCLCompilerTool.GeneratePreprocessedFileNoLines"] helpviewer_keywords: ["copy preprocessor output to stdout", "preprocessor output, copy to stdout", "-EP compiler option [C++]", "EP compiler option [C++]", "/EP compiler option [C++]"] -ms.assetid: 6ec411ae-e33d-4ef5-956e-0054635eabea --- # /EP (Preprocess to stdout Without #line Directives) @@ -46,7 +45,7 @@ You cannot use precompiled headers with the **/EP** option. The following command line preprocesses file `ADD.C`, preserves comments, and displays the result on the standard output device: -``` +```cmd CL /EP /C ADD.C ``` diff --git a/docs/build/reference/experimental-log.md b/docs/build/reference/experimental-log.md index e6af3965a27..413151fd864 100644 --- a/docs/build/reference/experimental-log.md +++ b/docs/build/reference/experimental-log.md @@ -1,23 +1,28 @@ --- title: "/experimental:log (Structured SARIF diagnostics)" -description: "Use the /experimental:log compiler option to output experimental structured SARIF output for diagnostics." -ms.date: 10/26/2023 +description: "The /experimental:log compiler option outputs experimental structured SARIF output for diagnostics." +ms.date: 06/05/2025 f1_keywords: ["/experimental:log"] helpviewer_keywords: ["/experimental:log", "SARIF", "structured diagnostics"] --- # `/experimental:log` (Structured SARIF diagnostics) -Output [SARIF](https://sarifweb.azurewebsites.net/) diagnostics to the specified file. For more information, see [Structured SARIF Diagnostics](sarif-output.md). +Output [SARIF](https://sarifweb.azurewebsites.net/) diagnostics to the specified file or directory. For more information, see [Structured SARIF Diagnostics](sarif-output.md). ## Syntax -> **`/experimental:log`** *filename* +> **`/experimental:log`** *filename*\ +> **`/experimental:log`** *directoryname\\* ## Arguments *filename* -Where to output SARIF diagnostics. The `.sarif` suffix is added to *filename* to produce the final filename at which to store the resulting SARIF diagnostics. The space between `/experimental:log` and *filename* is optional. Paths that include spaces must be enclosed in double quotes. *filename* may name a relative or absolute path. +The output file for SARIF diagnostics. The compiler automatically adds the `.sarif` extension to *filename*. The space between `/experimental:log` and *filename* is optional. Use double quotes around paths containing spaces. Both relative and absolute paths are supported. + +*directoryname\\* + +The output directory for SARIF diagnostics (for example, `/experimental:log sarif_output\`). Remember to add the trailing backslash (`\`) to indicate it's a directory. Each source file name forms the base name for each SARIF file saved in the directory. The compiler automatically adds the `.sarif` extension to each file name. The space between `/experimental:log` and *directoryname\\* is optional. Use double quotes around paths containing spaces. Both relative and absolute paths are supported. ## Remarks @@ -28,19 +33,22 @@ Diagnostics are also output as text to the console as usual. ### To set this compiler option in the Visual Studio development environment 1. Open the project's **Property Pages** dialog box. For details, see [Set C++ compiler and build properties in Visual Studio](../working-with-project-properties.md). - 1. Select the specific project **Configuration** and **Platform** for which you want to change the property. You can also choose **"All Configurations"** and **"All Platforms"**. - 1. Select the **Configuration Properties** > **C/C++** > **Command Line** property page. - 1. Modify the **Additional Options** property, and then choose **OK**. -## Example +## Examples + +The following command produces SARIF information for the compilation of `main.cpp` and saves it in the file `mySarifInfo.sarif`: + +```cmd +cl /experimental:log mySarifInfo main.cpp +``` -The following command produces SARIF information for the entire compilation in the `diags.sarif` file in the current directory: +The following command produces SARIF information for the entire compilation and saves it in the `sarif_output` directory in the files `main.sarif` and `other.sarif`: ```cmd -CL /experimental:logdiags main.cpp other.cpp +cl /experimental:log sarif_output\ main.cpp other.cpp ``` ## See also diff --git a/docs/build/reference/experimental-module.md b/docs/build/reference/experimental-module.md index bd1c16ed79e..bfbcec74a89 100644 --- a/docs/build/reference/experimental-module.md +++ b/docs/build/reference/experimental-module.md @@ -1,13 +1,13 @@ --- title: "/experimental:module (Enable module support)" description: "Use the /experimental:module compiler option to enable experimental compiler support for named modules." -ms.date: 01/27/2022 +ms.date: 02/12/2025 f1_keywords: ["module", "/experimental:module"] helpviewer_keywords: ["module", "/experimental:module", "Enable module support"] --- -# `/experimental:module` (Enable module support) +# `/experimental:module` (Enable experimental module support) -Enables experimental compiler support for C++ Standard modules. This option is obsolete for C++20 standard modules in Visual Studio version 16.11 and later. It's still required (along with [`/std:c++latest`](std-specify-language-standard-version.md)) for the experimental Standard library modules. +Enables compiler support for Microsoft's experimental form of C++ Standard modules. This option is obsolete in Visual Studio 2019 version 16.11 and later. ## Syntax @@ -15,24 +15,46 @@ Enables experimental compiler support for C++ Standard modules. This option is o ## Remarks -In versions of Visual Studio before Visual Studio 2019 version 16.11, you can enable experimental modules support by use of the **`/experimental:module`** compiler option along with the [`/std:c++latest`](std-specify-language-standard-version.md) option. In Visual Studio 2019 version 16.11, module support is enabled automatically by either **`/std:c++20`** or **`/std:c++latest`**. Use **`/experimental:module-`** to disable module support explicitly. + This switch applies to the time before the new, standardized, way of consuming the C++ Standard Library as modules was available. Although you can use this switch to use the older experimental named modules, we recommend that you use the new, standardized, way of consuming the C++ Standard Library as modules described in [Import the C++ standard library using modules](../../cpp/tutorial-import-stl-named-module.md). -This option is available starting in Visual Studio 2015 Update 1. As of Visual Studio 2019 version 16.2, C++20 Standard modules aren't fully implemented in the Microsoft C++ compiler. Modules support is feature complete in Visual Studio 2019 version 16.10. You can use the modules feature import the Standard Library modules provided by Microsoft. A module and the code that consumes it must be compiled with the same compiler options. +This compiler switch is available starting in Visual Studio 2015 Update 1. In the VS Installer under the **Individual components** tab, ensure that **C++ Modules for v143 build tools (x64/x86 - experimental)** is selected. You can use the search box with **experimental** to find it. For more information, see [Install C and C++ support in Visual Studio](../vscpp-step-0-installation.md). -For more information on modules and how to use and create them, see [Overview of modules in C++](../../cpp/modules-cpp.md). +| Version | Status | +|---|---| +| Visual Studio 2015 Update 1 | `/experimental:module` introduced. | +| Visual Studio 2019 version 16.10 | C++20 modules support is feature complete. | +| Visual Studio 2019 16.11 and earlier | Enable experimental modules support using **`/experimental:module`** along with [`/std:c++latest`](std-specify-language-standard-version.md). | +| Visual Studio 2019 version 16.11 and later | Modules support is enabled automatically with **`/std:c++20`** or later, or **`/std:c++latest`**. Use **`/experimental:module-`** to disable experimental module support. | + +The experimental library consists of the following named modules: + +- `std.regex` provides the content of header `` +- `std.filesystem` provides the content of header `` +- `std.memory` provides the content of header `` +- `std.threading` provides the contents of headers ``, ``, ``, ``, ``, and `` +- `std.core` provides everything else in the C++ Standard Library + +To consume these modules, add an import declaration to the top of the source code file. For example: + +```cpp +import std.core; +import std.regex; +``` + +To consume the experimental Microsoft Standard Library modules, compile your program with the [`/EHsc`](eh-exception-handling-model.md) and [`/MD`](md-mt-ld-use-run-time-library.md) options. ### To set this compiler option in the Visual Studio development environment 1. Open the project's **Property Pages** dialog box. For details, see [Set C++ compiler and build properties in Visual Studio](../working-with-project-properties.md). - 1. Set the **Configuration** drop-down to **All Configurations**. - 1. Select the **Configuration Properties** > **C/C++** > **Language** property page. - 1. Modify the **Enable C++ Modules (experimental)** property, and then choose **OK**. +For more information about how to use and create modules, see [Overview of modules in C++](../../cpp/modules-cpp.md). + ## See also +[Import the C++ standard library using modules](../../cpp/tutorial-import-stl-named-module.md)\ [`/headerUnit` (Use header unit IFC)](headerunit.md)\ [`/exportHeader` (Create header units)](module-exportheader.md)\ [`/reference` (Use named module IFC)](module-reference.md)\ diff --git a/docs/build/reference/fd-program-database-file-name.md b/docs/build/reference/fd-program-database-file-name.md index 7bc387dcf56..c9027012f28 100644 --- a/docs/build/reference/fd-program-database-file-name.md +++ b/docs/build/reference/fd-program-database-file-name.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: /Fd (Program Database File Name)" title: "/Fd (Program Database File Name)" -ms.date: "11/04/2016" +description: "Learn more about: /Fd (Program Database File Name)" +ms.date: 11/04/2016 f1_keywords: ["/FD", "VC.Project.VCCLWCECompilerTool.ProgramDataBaseFileName", "VC.Project.VCCLCompilerTool.ProgramDataBaseFileName"] helpviewer_keywords: ["/FD compiler option [C++]", "program database file name [C++]", "-FD compiler option [C++]", "PDB files, creating", "program database compiler option [C++]", ".pdb files, creating", "FD compiler option [C++]"] -ms.assetid: 3977a9ed-f0ac-45df-bf06-01cedd2ba85a --- # /Fd (Program Database File Name) @@ -42,7 +41,7 @@ This option also names the state (.idb) file used for minimal rebuild and increm This command line creates a .pdb file named PROG.pdb and an .idb file named PROG.idb: -``` +```cmd CL /DDEBUG /Zi /FdPROG.PDB PROG.CPP ``` diff --git a/docs/build/reference/fe-name-exe-file.md b/docs/build/reference/fe-name-exe-file.md index 3defab99e37..02c71317a58 100644 --- a/docs/build/reference/fe-name-exe-file.md +++ b/docs/build/reference/fe-name-exe-file.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: /Fe (Name EXE File)" title: "/Fe (Name EXE File)" -ms.date: "11/04/2016" +description: "Learn more about: /Fe (Name EXE File)" +ms.date: 11/04/2016 f1_keywords: ["/fe"] helpviewer_keywords: ["-Fe compiler option [C++]", "executable files, renaming", "rename file compiler option [C++]", "/Fe compiler option [C++]", "Fe compiler option [C++]"] -ms.assetid: 49f594fd-5e94-45fe-a1bf-7c9f2abb6437 --- # /Fe (Name EXE File) @@ -44,13 +43,13 @@ If you specify the [/c (Compile Without Linking)](c-compile-without-linking.md) The following command line compiles and links all C source files in the current directory. The resulting executable file is named PROCESS.exe and is created in the directory "C:\Users\User Name\repos\My Project\bin". -``` +```cmd CL /Fe"C:\Users\User Name\repos\My Project\bin\PROCESS" *.C ``` The following command line creates an executable file in `C:\BIN` with the same base name as the first source file in the current directory: -``` +```cmd CL /FeC:\BIN\ *.C ``` diff --git a/docs/build/reference/files-created-for-clr-projects.md b/docs/build/reference/files-created-for-clr-projects.md index 8864195572c..1aa648278b1 100644 --- a/docs/build/reference/files-created-for-clr-projects.md +++ b/docs/build/reference/files-created-for-clr-projects.md @@ -1,9 +1,8 @@ --- -description: "Learn more about: Files Created for CLR Projects" title: "Files Created for CLR Projects" -ms.date: "11/04/2016" +description: "Learn more about: Files Created for CLR Projects" +ms.date: 11/04/2016 helpviewer_keywords: ["Visual Studio C++ projects, CLR programming", ".NET applications, C++"] -ms.assetid: 59ae9020-5f26-4ad0-bbdd-97c2e2023a20 --- # Files Created for CLR Projects @@ -11,7 +10,7 @@ When you use Visual C++ templates to create your projects, several files are cre |File name|File description| |---------------|----------------------| -|AssemblyInfo.cpp|The file that contains information (that is, attributes, files, resources, types, versioning information, signing information, and so on) for modifying the project's assembly metadata. For more information see [Assembly Concepts](/dotnet/framework/app-domains/assembly-contents).| +|AssemblyInfo.cpp|The file that contains information (that is, attributes, files, resources, types, versioning information, signing information, and so on) for modifying the project's assembly metadata. For more information, see [Assembly Concepts](/dotnet/framework/app-domains/assembly-contents).| |*projname*.asmx|A text file that references managed classes that encapsulate the functionality of the XML Web service.| |*projname*.cpp|The main source file and entry point into the application that Visual Studio created for you. Identifies the project .dll file and the project namespace. Provide your own code in this file.| |*projname*.vsdisco|An XML deployment file containing links to other resources that describe the XML Web service.| diff --git a/docs/build/reference/force-interlocked-functions.md b/docs/build/reference/force-interlocked-functions.md new file mode 100644 index 00000000000..be8e5769db8 --- /dev/null +++ b/docs/build/reference/force-interlocked-functions.md @@ -0,0 +1,55 @@ +--- +title: "/forceInterlockedFunctions" +description: "Learn more about /forceInterlockedFunctions" +ms.date: 03/07/2025 +--- +# `/forceInterlockedFunctions` + +Dynamically selects between Armv8.0 load, store exclusive instructions or Armv8.1 Large System Extension (LSE) atomic instructions based on CPU capability at runtime. + +## Syntax + +> **`/forceInterlockedFunctions`**[**`-`**] + +## Remarks +When possible, this flag avoids using Armv8.0 load and store exclusive instructions, as these instructions can result in livelocks. +This flag forces the following interlocked intrinsics to be generated as out-of-line functions: + +|Operation|8|16|32|64|128|Pointer| +|-|-------|--------|--------|--------|-------|-------| +|Add|None|None|Full|Full|None|None| +|And|Full|Full|Full|Full|None|None| +|CompareExchange|Full|Full|Full|Full|Full|Full| +|Decrement|None|Full|Full|Full|None|None| +|Exchange|Full|Full|Full|Full|None|Full| +|ExchangeAdd|Full|Full|Full|Full|None|None| +|Increment|None|Full|Full|Full|None|None| +|Or|Full|Full|Full|Full|None|None| +|Xor|Full|Full|Full|Full|None|None| +|bittestandreset|None|None|Full|Full|None|None| +|bittestandset|None|None|Full|Full|None|None| + +Key: + +- **Full**: supports plain, `_acq`, `_rel`, and `_nf` forms. + +- **None**: Not supported + +For more information about interlocked intrinsics, see the "Interlocked intrinsics" section in [Arm64 Intrinsics](../../intrinsics/arm64-intrinsics.md). + +### To set the `/forceInterlockedFunctions` compiler option in Visual Studio + +1. Open the **Property Pages** dialog box for the project. For more information, see [Set C++ compiler and build properties in Visual Studio](../working-with-project-properties.md). + +1. Select the **Configuration Properties** > **C/C++** > **Command Line** property page. + +1. In the **Additional options** box, add *`/forceInterlockedFunctions`* to enable. Choose **OK** to save your changes. + +### To set this compiler option programmatically + +- See . + +## See also +[Arm64 Intrinsics](../../intrinsics/arm64-intrinsics.md)\ +[MSVC compiler options](compiler-options.md)\ +[MSVC compiler command-line syntax](compiler-command-line-syntax.md) diff --git a/docs/build/reference/fpcvt.md b/docs/build/reference/fpcvt.md index 8661d649c92..f1277402674 100644 --- a/docs/build/reference/fpcvt.md +++ b/docs/build/reference/fpcvt.md @@ -1,6 +1,6 @@ --- -description: "Learn more about: /fpcvt (Floating-point to integer conversion compatibility)" title: "/fpcvt (Floating-point to unsigned integer conversion compatibility)" +description: "Learn more about: /fpcvt (Floating-point to integer conversion compatibility)" ms.date: 11/03/2021 f1_keywords: ["/fpcvt", "-fpcvt"] helpviewer_keywords: ["-fpcvt compiler option [C++]", "/fpcvt compiler option [C++]"] @@ -30,6 +30,8 @@ In Visual Studio 2019 version 16.8 and later versions, the **`/fpcvt`** compiler For Visual Studio 2019, the default behavior for x64 targets is consistent with **`/fpcvt:BC`** unless **`/arch:AVX512`** is specified. Usually, the behavior for x86 targets is consistent with **`/fpcvt:IA`**, except under **`/arch:IA32`**, **`/arch:SSE`**, or sometimes where the result of a function call is directly converted to an unsigned integer. Use of **`/fpcvt`** overrides the default, so all conversions are handled consistently on either target. The behavior of conversions for ARM and ARM64 targets isn't consistent with either **`/fpcvt:BC`** or **`/fpcvt:IA`**. +Starting with Visual Studio 2022, the default behavior for x64 targets is consistent with `/fpcvt:BC` even when `/arch:AVX512` is specified. To use AVX512 conversion behavior with `/arch:AVX512`, specify `/fpcvt:IA`. + Standard C++ specifies that if a truncated floating-point value is exactly representable in an integer type, it must have that value when converted to that type. Otherwise, any behavior at all is allowed. Both **`/fpcvt`** options conform with Standard C++. The only difference is in what values are returned for invalid source values. The **`/fpcvt:IA`** option causes any invalid conversion to return a single *sentinel* value, which is the destination value farthest from zero. For conversion to signed types, the sentinel is the minimum value for that type. Unsigned types use the maximum value. Floating-point operations may return a Not-a-Number (NaN) value to indicate an invalid operation. That indicator isn't an option for conversion to integer types, which don't have NaN values. The sentinel is used as a proxy for a NaN value, although it can also be the result of a valid conversion. @@ -40,7 +42,7 @@ The **`/fpcvt`** options are new in Visual Studio 2019 version 16.8. If you spec ### Intrinsic functions for conversions -You can specify the behavior of a specific conversion independently of the **`/fpcvt `** option, which applies globally. The compiler provides intrinsic sentinel conversion functions for conversions compatible with **`/fpcvt:IA`**. For more information, see [Sentinel conversion functions](../../intrinsics/sentinel-conversion-functions.md). The compiler also provides saturation conversion functions compatible with conversions on ARM or ARM64 target architectures. For more information, see [Saturation conversion functions](../../intrinsics/saturation-conversion-functions.md). +You can specify the behavior of a specific conversion independently of the **`/fpcvt`** option, which applies globally. The compiler provides intrinsic sentinel conversion functions for conversions compatible with **`/fpcvt:IA`**. For more information, see [Sentinel conversion functions](../../intrinsics/sentinel-conversion-functions.md). The compiler also provides saturation conversion functions compatible with conversions on ARM or ARM64 target architectures. For more information, see [Saturation conversion functions](../../intrinsics/saturation-conversion-functions.md). The compiler also supports intrinsic conversion functions that execute as quickly as possible for valid conversions. These functions may generate any value or throw an exception for an invalid conversion. The results depend on the target platform, compiler options, and context. They're useful for handling values that have already been range-checked, or values generated in a way that can't cause an invalid conversion. For more information, see [Fast conversion functions](../../intrinsics/fast-conversion-functions.md). diff --git a/docs/build/reference/fsanitize.md b/docs/build/reference/fsanitize.md index 7fd5128bb78..e1eef40728d 100644 --- a/docs/build/reference/fsanitize.md +++ b/docs/build/reference/fsanitize.md @@ -12,19 +12,24 @@ Use the **`/fsanitize`** compiler options to enable sanitizers. ## Syntax > **`/fsanitize=address`**\ +> **`/fsanitize=kernel-address`**\ > **`/fsanitize=fuzzer`**\ > **`/fsanitize-address-use-after-return`**\ > **`/fno-sanitize-address-vcasan-lib`** +> **`/fsanitize-address-asan-compat-lib`** +> **`/fno-sanitize-address-asan-compat-lib`** ## Remarks The **`/fsanitize=address`** compiler option enables [AddressSanitizer](../../sanitizers/asan.md), a powerful compiler and runtime technology to uncover [hard-to-find bugs](../../sanitizers/asan.md#error-types). Support for the **`/fsanitize=address`** option is available starting in Visual Studio 2019 version 16.9. +The **`/fsanitize=kernel-address`** compiler option enables [Kernel AddressSanitizer (KASan)](/windows-hardware/drivers/devtest/kasan). KASan is the kernel-mode variant of AddressSanitizer, available starting in Visual Studio 2022 version 17.11. KASan is only supported on Windows 11 24H2 or Windows Server 2025 and higher, and requires building using a Windows SDK 10.0.26100.2161 and higher. Building with KASan also implies the **`/fsanitize-address-asan-compat-lib`** compiler option. + The **`/fsanitize=fuzzer`** compiler option enables experimental support for [LibFuzzer](https://llvm.org/docs/LibFuzzer.html). LibFuzzer is a coverage-guided fuzzing library that can be used to find bugs and crashes caused by user-provided input. We recommended you use **`/fsanitize=address`** with LibFuzzer. This option is useful for fuzzing tools such as OneFuzz. For more information, see the [OneFuzz documentation](https://www.microsoft.com/research/project/project-onefuzz/) and [OneFuzz GitHub project](https://github.com/microsoft/onefuzz). Support for the **`/fsanitize=fuzzer`** option is available starting in Visual Studio 2022 version 17.0. The **`/fsanitize`** option doesn't allow comma-separated syntax, for example: **`/fsanitize=address,fuzzer`**. These options must be specified individually. -The **`/fsanitize-address-use-after-return`** and **`/fno-sanitize-address-vcasan-lib`** compiler options, and the [`/INFERASANLIBS` (Use inferred sanitizer libs)](./inferasanlibs.md) and **`/INFERASANLIBS:NO`** linker options offer support for advanced users. For more information, see [AddressSanitizer build and language reference](../../sanitizers/asan-building.md). +The **`/fsanitize-address-use-after-return`**, **`/fno-sanitize-address-vcasan-lib`**, **`/fsanitize-address-asan-compat-lib`**, and **`/fno-sanitize-address-asan-compat-lib`** compiler options, and the [`/INFERASANLIBS` (Use inferred sanitizer libs)](./inferasanlibs.md) and **`/INFERASANLIBS:NO`** linker options offer support for advanced users. For more information, see [AddressSanitizer build and language reference](../../sanitizers/asan-building.md). ### To set the **`/fsanitize=address`** compiler option in the Visual Studio development environment @@ -32,7 +37,7 @@ The **`/fsanitize-address-use-after-return`** and **`/fno-sanitize-address-vcasa 1. Select the **Configuration Properties** > **C/C++** > **General** property page. -1. Modify the **Enable Address Sanitizer** property. To enable it, choose **Yes (/fsanitize=address)**. +1. Modify the **Enable AddressSanitizer** property. To enable it, choose **Yes (/fsanitize=address)**. 1. Choose **OK** or **Apply** to save your changes. diff --git a/docs/build/reference/gd-gr-gv-gz-calling-convention.md b/docs/build/reference/gd-gr-gv-gz-calling-convention.md index 834a53189cf..50380ebb09d 100644 --- a/docs/build/reference/gd-gr-gv-gz-calling-convention.md +++ b/docs/build/reference/gd-gr-gv-gz-calling-convention.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: /Gd, /Gr, /Gv, /Gz (Calling Convention)" title: "/Gd, /Gr, /Gv, /Gz (Calling Convention)" -ms.date: "09/05/2018" +description: "Learn more about: /Gd, /Gr, /Gv, /Gz (Calling Convention)" +ms.date: 09/05/2018 f1_keywords: ["/Gr", "/Gv", "/Gd", "VC.Project.VCCLCompilerTool.CallingConvention"] helpviewer_keywords: ["-Gd compiler option [C++]", "-Gv compiler option [C++]", "/Gv compiler option [C++]", "-Gr compiler option [C++]", "Gd compiler option [C++]", "Gr compiler option [C++]", "/Gz compiler option [C++]", "-Gz compiler option [C++]", "/Gd compiler option [C++]", "Gz compiler option [C++]", "Gv compiler option [C++]", "/Gr compiler option [C++]"] -ms.assetid: fd3110cb-2d77-49f2-99cf-a03f9ead00a3 --- # /Gd, /Gr, /Gv, /Gz (Calling Convention) @@ -44,7 +43,7 @@ For more information about calling conventions, see [Calling Conventions](../../ On x86 processors, all function arguments are passed on the stack from right to left. On ARM and x64 architectures, some arguments are passed by register and the rest are passed on the stack from right to left. The calling routine pops the arguments from the stack. -For C, the **`__cdecl`** naming convention uses the function name preceded by an underscore ( `_` ); no case translation is performed. Unless declared as `extern "C"`, C++ functions use a different name-decorating scheme. For more information, see [Decorated Names](decorated-names.md). +For C, the **`__cdecl`** naming convention uses the function name preceded by an underscore (`_`); no case translation is performed. Unless declared as `extern "C"`, C++ functions use a different name-decorating scheme. For more information, see [Decorated Names](decorated-names.md). ## __fastcall Specifics diff --git a/docs/build/reference/general-property-page-project.md b/docs/build/reference/general-property-page-project.md index 5fd0640279f..b06af7088be 100644 --- a/docs/build/reference/general-property-page-project.md +++ b/docs/build/reference/general-property-page-project.md @@ -77,7 +77,7 @@ You can use project macros to change the directory location. For more informatio ### Platform Toolset -Specifies the toolset used for building the current configuration. This property allows the project to target a different version of the Visual C++ libraries and compiler. By default, Visual Studio C++ projects target the latest toolset installed by Visual Studio. You can choose one of the toolsets installed by several previous versions of Visual Studio instead. Some older toolsets can create executables that run on Windows XP or Vista. For more information on how to change the platform toolset, see [How to: Modify the target framework and platform toolset](../how-to-modify-the-target-framework-and-platform-toolset.md). +Specifies the toolset used for building the current configuration. This property allows the project to target a different version of the Microsoft C++ libraries and compiler. By default, Visual Studio C++ projects target the latest toolset installed by Visual Studio. You can choose one of the toolsets installed by several previous versions of Visual Studio instead. Some older toolsets can create executables that run on Windows XP or Vista. For more information on how to change the platform toolset, see [How to: Modify the target framework and platform toolset](../how-to-modify-the-target-framework-and-platform-toolset.md). ### Enable Managed Incremental Build diff --git a/docs/build/reference/genprofile-fastgenprofile-generate-profiling-instrumented-build.md b/docs/build/reference/genprofile-fastgenprofile-generate-profiling-instrumented-build.md index e77bc2bfd9c..37657efee2b 100644 --- a/docs/build/reference/genprofile-fastgenprofile-generate-profiling-instrumented-build.md +++ b/docs/build/reference/genprofile-fastgenprofile-generate-profiling-instrumented-build.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: /GENPROFILE, /FASTGENPROFILE (Generate Profiling Instrumented Build)" title: "/GENPROFILE, /FASTGENPROFILE (Generate Profiling Instrumented Build)" -ms.date: 04/14/2021 +description: "Learn more about: /GENPROFILE, /FASTGENPROFILE (Generate Profiling Instrumented Build)" +ms.date: 03/27/2025 f1_keywords: ["GENPROFILE", "FASTGENPROFILE", "/GENPROFILE", "/FASTGENPROFILE"] helpviewer_keywords: ["GENPROFILE", "FASTGENPROFILE"] --- @@ -12,7 +12,7 @@ Specifies generation of a *`.pgd`* file by the linker to support profile-guided ## Syntax > **`/GENPROFILE`**\[**`:`**_`profile-argument`_\[**`,`**_`profile-argument`_ ...]]\ -> **`/FASTGENPROFILE`**\[**`:`**_`profile-argument`_\[**`,`**_`profile-argument`_ ...]]\ +> **`/FASTGENPROFILE`**\[**`:`**_`profile-argument`_\[**`,`**_`profile-argument`_ ...]] > *`profile-argument`*\ >  { **`COUNTER32`** | **`COUNTER64`** }\ @@ -43,7 +43,7 @@ Use **`PATH`** to specify a separate set of PGO counters for each unique path t Specifies whether to use extra counters to keep an accurate count when exceptions are thrown during training. Use **`TRACKEH`** to specify extra counters for an exact count. Use **`NOTRACKEH`** to specify single counters for code that doesn't use exception handling or that doesn't run into exceptions in your training scenarios. When you specify **`/GENPROFILE`**, the default is **`TRACKEH`** . When you specify **`/FASTGENPROFILE`**, the default is **`NOTRACKEH`** . **`PGD`**=*filename*\ -Specifies a base file name for the *`.pgd`* file. By default, the linker uses the base executable image file name with a *`.pgd`* extension. +Specifies a base filename for the *`.pgd`* file. By default, the linker uses the base executable image filename with a *`.pgd`* extension. When expanded, the fully qualified filename must not exceed `MAX_PATH` (260 characters). ## Remarks diff --git a/docs/build/reference/gs-buffer-security-check.md b/docs/build/reference/gs-buffer-security-check.md index 227124b8142..41fe1b082cf 100644 --- a/docs/build/reference/gs-buffer-security-check.md +++ b/docs/build/reference/gs-buffer-security-check.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: /GS (Buffer Security Check)" title: "/GS (Buffer Security Check)" -ms.date: "11/04/2016" +description: "Learn more about: /GS (Buffer Security Check)" +ms.date: 11/04/2016 f1_keywords: ["VC.Project.VCCLWCECompilerTool.BufferSecurityCheck", "VC.Project.VCCLCompilerTool.BufferSecurityCheck"] helpviewer_keywords: ["buffers [C++], buffer overruns", "buffer overruns, compiler /GS switch", "GS compiler option [C++]", "/GS compiler option [C++]", "security check compiler option [C++]", "-GS compiler option [C++]", "buffers [C++], avoiding overruns"] -ms.assetid: 8d8a5ea1-cd5e-42e1-bc36-66e1cd7e731e --- # /GS (Buffer Security Check) @@ -29,11 +28,8 @@ On functions that the compiler recognizes as subject to buffer overrun problems, A buffer overrun security check is performed on a *GS buffer*. A GS buffer can be one of these: - An array that is larger than 4 bytes, has more than two elements, and has an element type that is not a pointer type. - - A data structure whose size is more than 8 bytes and contains no pointers. - -- A buffer allocated by using the [_alloca](../../c-runtime-library/reference/alloca.md) function. - +- A buffer allocated by using the [`_alloca`](../../c-runtime-library/reference/alloca.md) function. - Any class or structure that contains a GS buffer. For example, the following statements declare GS buffers. @@ -57,16 +53,14 @@ struct { int a; int b; }; ## Initialize the Security Cookie -The **/GS** compiler option requires that the security cookie be initialized before any function that uses the cookie is run. The security cookie must be initialized immediately on entry to an EXE or DLL. This is done automatically if you use the default VCRuntime entry points: mainCRTStartup, wmainCRTStartup, WinMainCRTStartup, wWinMainCRTStartup, or _DllMainCRTStartup. If you use an alternate entry point, you must manually initialize the security cookie by calling [__security_init_cookie](../../c-runtime-library/reference/security-init-cookie.md). +The **/GS** compiler option requires that the security cookie be initialized before any function that uses the cookie is run. The security cookie must be initialized immediately on entry to an EXE or DLL. This is done automatically if you use the default VCRuntime entry points: `mainCRTStartup`, `wmainCRTStartup`, `WinMainCRTStartup`, `wWinMainCRTStartup`, or `_DllMainCRTStartup`. If you use an alternate entry point, you must manually initialize the security cookie by calling [`__security_init_cookie`](../../c-runtime-library/reference/security-init-cookie.md). ## What Is Protected The **/GS** compiler option protects the following items: - The return address of a function call. - - The address of an exception handler for a function. - - Vulnerable function parameters. On all platforms, **/GS** attempts to detect buffer overruns into the return address. Buffer overruns are more easily exploited on platforms such as x86 and x64, which use calling conventions that store the return address of a function call on the stack. @@ -80,15 +74,10 @@ A vulnerable parameter is allocated before the cookie and local variables. A buf The compiler does not make copies of vulnerable parameters in the following situations: - Functions that do not contain a GS buffer. - -- Optimizations ([/O options](o-options-optimize-code.md)) are not enabled. - +- Optimizations ([`/O` options](o-options-optimize-code.md)) are not enabled. - Functions that have a variable argument list (...). - - Functions that are marked with [naked](../../cpp/naked-cpp.md). - - Functions that contain inline assembly code in the first statement. - - A parameter is used only in ways that are less likely to be exploitable in the event of a buffer overrun. ## What Is Not Protected @@ -100,9 +89,7 @@ Even if you use **/GS**, always try to write secure code that has no buffer over ### To set this compiler option in Visual Studio 1. Open the project's **Property Pages** dialog box. For details, see [Set C++ compiler and build properties in Visual Studio](../working-with-project-properties.md). - 1. Select the **Configuration Properties** > **C/C++** > **Code Generation** property page. - 1. Modify the **Buffer Security Check** property. ### To set this compiler option programmatically @@ -138,5 +125,5 @@ int main() { ## See also -[MSVC Compiler Options](compiler-options.md)
+[MSVC Compiler Options](compiler-options.md)\ [MSVC Compiler Command-Line Syntax](compiler-command-line-syntax.md) diff --git a/docs/build/reference/guard-enable-control-flow-guard.md b/docs/build/reference/guard-enable-control-flow-guard.md index 91144792528..1da0931bd13 100644 --- a/docs/build/reference/guard-enable-control-flow-guard.md +++ b/docs/build/reference/guard-enable-control-flow-guard.md @@ -1,9 +1,8 @@ --- -description: "Learn more about: /guard (Enable Control Flow Guard)" title: "/guard (Enable Control Flow Guard)" -ms.date: 09/19/2022 +description: "Learn more about: /guard (Enable Control Flow Guard)" +ms.date: 2/24/2025 f1_keywords: ["/guard", "VC.Project.VCCLCompilerTool.ControlFlowGuard"] -ms.assetid: be495323-f59f-4cf3-a6b6-8ee69e6a19dd --- # `/guard` (Enable Control Flow Guard) @@ -16,15 +15,21 @@ Enable compiler generation of Control Flow Guard security checks. ## Remarks -The **`/guard:cf`** option causes the compiler to analyze control flow for indirect call targets at compile time, and then to insert code to verify the targets at runtime. By default, **`/guard:cf`** is off and must be explicitly enabled. To explicitly disable this option, use **`/guard:cf-`**. +The **`/guard:cf`** option causes the compiler to analyze control flow for indirect call targets at compile time, and inserts code at runtime to verify the targets. By default, **`/guard:cf`** is off and must be explicitly enabled. To explicitly disable this option, use **`/guard:cf-`**. **Visual Studio 2017 and later**: This option adds guards for **`switch`** statements that generate jump tables. When the **`/guard:cf`** Control Flow Guard (CFG) option is specified, the compiler and linker insert extra runtime security checks to detect attempts to compromise your code. During compiling and linking, all indirect calls in your code are analyzed to find every location that the code can reach when it runs correctly. This information is stored in extra structures in the headers of your binaries. The compiler also injects a check before every indirect call in your code that ensures the target is one of the verified locations. If the check fails at runtime on a CFG-aware operating system, the operating system closes the program. -A common attack on software takes advantage of bugs in handling extreme or unexpected inputs. Carefully crafted input to the application may overwrite a location that contains a pointer to executable code. This technique can be used to redirect control flow to code controlled by the attacker. The CFG runtime checks don't fix the data corruption bugs in your executable. They instead make it more difficult for an attacker to use them to execute arbitrary code. CFG is a mitigation tool that prevents calls to locations other than function entry points in your code. It's similar to how Data Execution Prevention (DEP), [/GS](gs-buffer-security-check.md) stack checks, and [`/DYNAMICBASE`](dynamicbase-use-address-space-layout-randomization.md) and [/HIGHENTROPYVA](highentropyva-support-64-bit-aslr.md) address space layout randomization (ASLR) lower the chances that your code becomes an exploit vector. +A common attack on software takes advantage of bugs in handling extreme or unexpected inputs. Carefully crafted input to the application may overwrite a location that contains a pointer to executable code. This technique can be used to redirect control flow to code controlled by the attacker. The CFG runtime checks don't fix the data corruption bugs in your executable. They instead make it more difficult for an attacker to use them to execute arbitrary code. CFG is a mitigation tool that prevents calls to locations other than function entry points in your code. It's similar to how Data Execution Prevention (DEP), [/GS](gs-buffer-security-check.md) stack checks, and [`/DYNAMICBASE`](dynamicbase-use-address-space-layout-randomization.md) and [/HIGHENTROPYVA](highentropyva-support-64-bit-aslr.md) address space layout randomization (ASLR) lower the chances that your code becomes an exploit vector. + +To use the CFG exploit mitigation technique, pass **`/guard:cf`** to the compiler and **`/GUARD:CF`** to the linker. + +To disable the CFG exploit mitigation technique, pass **`/guard:cf-`** to the compiler **`/GUARD:NO`** to the linker. -The **`/guard:cf`** option must be passed to both the compiler and linker to build code that uses the CFG exploit mitigation technique. If your binary is built by using a single `cl` command, the compiler passes the option to the linker. If you compile and link separately, the option must be set on both the compiler and linker commands. The /DYNAMICBASE linker option is also required. To verify that your binary has CFG data, use the `dumpbin /headers /loadconfig` command. CFG-enabled binaries have `Guard` in the list of EXE or DLL characteristics, and Guard Flags include `CF Instrumented` and `FID table present`. +If you build using a single `cl` command, the compiler passes the option to the linker. If you compile and link separately, set the option for both the compiler and linker commands. The `/DYNAMICBASE` linker option is also required. + +To verify that your binary has CFG data, use the `dumpbin /headers /loadconfig` command. CFG-enabled binaries have `Guard` in the list of EXE or DLL characteristics, and Guard Flags include `CF Instrumented` and `FID table present`. The **`/guard:cf`** option is incompatible with [`/ZI`](z7-zi-zi-debug-information-format.md) (Edit and Continue debug information) or [`/clr`](clr-common-language-runtime-compilation.md) (Common Language Runtime Compilation). @@ -33,11 +38,8 @@ Code compiled by using **`/guard:cf`** can be linked to libraries and object fil ### To set this compiler option in the Visual Studio development environment 1. Open the **Property Pages** dialog box for the project. For more information, see [Set compiler and build properties](../working-with-project-properties.md). - 1. Select the **Configuration Properties** > **C/C++** > **Code Generation** property page. - 1. Select the **Control Flow Guard** property. - 1. In the dropdown control, choose **Yes** to enable Control Flow Guard, or **No** to disable it. ## See also diff --git a/docs/build/reference/help-compiler-command-line-help.md b/docs/build/reference/help-compiler-command-line-help.md index 8b03e638c82..673fc125b1b 100644 --- a/docs/build/reference/help-compiler-command-line-help.md +++ b/docs/build/reference/help-compiler-command-line-help.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: /HELP (Compiler Command-Line Help)" title: "/HELP (Compiler Command-Line Help)" -ms.date: "11/04/2016" +description: "Learn more about: /HELP (Compiler Command-Line Help)" +ms.date: 11/04/2016 f1_keywords: ["/help"] helpviewer_keywords: ["HELP compiler option [C++]", "Help, for compiler command line", "/HELP compiler option [C++]", "/? compiler option [C++]", "-HELP compiler option [C++]", "-? compiler option [C++]", "cl.exe compiler, command-line syntax"] -ms.assetid: 192533e7-86f2-48e0-a08f-b5e4e3a4e784 --- # /HELP (Compiler Command-Line Help) @@ -18,8 +17,6 @@ Displays a listing of compiler options to standard output. /? ``` -## Remarks - ### To set this compiler option in the Visual Studio development environment - This compiler option should only be accessed from the command line. diff --git a/docs/build/reference/hint-files.md b/docs/build/reference/hint-files.md index 374b605e6f9..b292dfffa36 100644 --- a/docs/build/reference/hint-files.md +++ b/docs/build/reference/hint-files.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Hint Files" title: "Hint Files" -ms.date: "02/26/2019" +description: "Learn more about: Hint Files" +ms.date: 02/26/2019 f1_keywords: ["cpp.hint", "vc.hint.file"] helpviewer_keywords: ["stop file", "cpp.hint", "hint file", "cpp.stop", "Class View, hint file"] -ms.assetid: 17194f66-cf62-4523-abec-77db0675ab65 --- # Hint Files @@ -133,7 +132,7 @@ For a depiction of how hints are gathered, see the [Example](#example) section. You create and delete hints by using the same syntax as the preprocessor directives to create and delete macros. In fact, the parsing system uses the C/C++ preprocessor to evaluate the hints. For more information about the preprocessor directives, see [#define Directive (C/C++)](../../preprocessor/hash-define-directive-c-cpp.md) and [#undef Directive (C/C++)](../../preprocessor/hash-undef-directive-c-cpp.md). -The only unusual syntax elements are the `@<`, `@=`, and `@>` replacement strings. These hint-file specific replacement strings are only used in *map* macros. A map is a set of macros that relate data, functions, or events to other data, functions, or event handlers. For example, `MFC` uses maps to create [message maps](../../mfc/reference/message-maps-mfc.md), and `ATL` uses maps to create [object maps](../../atl/reference/object-map-macros.md). The hint-file specific replacement strings mark the starting, intermediate, and ending elements of a map. Only the name of a map macro is significant. Therefore, each replacement string intentionally hides the implementation of the macro. +The only unusual syntax elements are the `@<`, `@=`, and `@>` replacement strings. These hint-file specific replacement strings are only used in *map* macros. A map is a set of macros that relate data, functions, or events to other data, functions, or event handlers. For example, MFC uses maps to create [message maps](../../mfc/reference/message-maps-mfc.md), and ATL uses maps to create [object maps](../../atl/reference/object-map-macros.md). The hint-file specific replacement strings mark the starting, intermediate, and ending elements of a map. Only the name of a map macro is significant. Therefore, each replacement string intentionally hides the implementation of the macro. Hints use this syntax: diff --git a/docs/build/reference/homeparams-copy-register-parameters-to-stack.md b/docs/build/reference/homeparams-copy-register-parameters-to-stack.md index bb498d1bfef..9a9b9b1119a 100644 --- a/docs/build/reference/homeparams-copy-register-parameters-to-stack.md +++ b/docs/build/reference/homeparams-copy-register-parameters-to-stack.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: /homeparams (Copy Register Parameters to Stack)" title: "/homeparams (Copy Register Parameters to Stack)" -ms.date: "12/17/2018" +description: "Learn more about: /homeparams (Copy Register Parameters to Stack)" +ms.date: 12/17/2018 f1_keywords: ["/homeparams"] helpviewer_keywords: ["/homeparams compiler option [C++]", "-homeparams compiler option [C++]"] -ms.assetid: 51067de4-24f7-436b-b8d9-bc867a7d53aa --- # /homeparams (Copy Register Parameters to Stack) diff --git a/docs/build/reference/hotpatch-create-hotpatchable-image.md b/docs/build/reference/hotpatch-create-hotpatchable-image.md index ecd2b6467e5..011a1b31280 100644 --- a/docs/build/reference/hotpatch-create-hotpatchable-image.md +++ b/docs/build/reference/hotpatch-create-hotpatchable-image.md @@ -1,14 +1,13 @@ --- -description: "Learn more about: /hotpatch (Create Hotpatchable Image)" -title: "/hotpatch (Create Hotpatchable Image)" -ms.date: "12/7/2021" +description: "Learn more about: /hotpatch (Create hotpatchable image)" +title: "/hotpatch (Create hotpatchable image)" +ms.date: "9/4/2025" f1_keywords: ["/hotpatch", "VC.Project.VCCLCompilerTool.CreateHotpatchableImage"] -helpviewer_keywords: ["hot patching", "-hotpatch compiler option [C++]", "/hotpatch compiler option [C++]", "hotpatching"] -ms.assetid: aad539b6-c053-4c78-8682-853d98327798 +helpviewer_keywords: ["hot patching", "hotpatching", "-hotpatch compiler option [C++]", "/hotpatch compiler option [C++]"] --- -# /hotpatch (Create Hotpatchable Image) +# /hotpatch (Create hotpatchable image) -Prepares an image for hot patching. +Prepares an image for hotpatching. ## Syntax @@ -16,20 +15,22 @@ Prepares an image for hot patching. /hotpatch ``` +> [!NOTE] +> This option is only available for x86 + ## Remarks -When **/hotpatch** is used in a compilation, the compiler ensures that the first instruction of each function is at least two bytes, and no jump within the function goes to the first instruction. These conditions are required for hot patching. +When `/hotpatch` is used during compilation, the compiler ensures that the first instruction of each function is at least 2 bytes long and that no jump within the function goes to the first instruction. These conditions are required for hotpatching. -To complete the preparation for making an image hotpatchable, after you use **/hotpatch** to compile, you must use [/FUNCTIONPADMIN (Create Hotpatchable Image)](functionpadmin-create-hotpatchable-image.md) to link. When you compile and link an image by using one invocation of cl.exe, **/hotpatch** implies **/functionpadmin**. +To complete the preparation for making an image hotpatchable, after you compile with `/hotpatch`, use [`/functionpadmin`](functionpadmin-create-hotpatchable-image.md) to link. When you compile and link an image using one invocation of `cl.exe`, `/hotpatch` implies `/functionpadmin`. -Because instructions are always two bytes or larger on the ARM architecture, and because x64 compilation is always treated as if **/hotpatch** has been specified, you don't have to specify **/hotpatch** when you compile for these targets; however, you must still link by using **/functionpadmin** to create hotpatchable images for them. The **/hotpatch** compiler option only affects x86 compilation. +> [!TIP] +> Arm64 and x64 architectures are always treated as hotpatchable. But you must still link by using `/functionpadmin` to create hotpatchable images for them. ### To set this compiler option in the Visual Studio development environment 1. Open the project's **Property Pages** dialog box. For details, see [Set C++ compiler and build properties in Visual Studio](../working-with-project-properties.md). - 1. Select the **Configuration Properties** > **C/C++** > **Command Line** property page. - 1. Add the compiler option to the **Additional Options** box. ### To set this compiler option programmatically @@ -38,5 +39,5 @@ Because instructions are always two bytes or larger on the ARM architecture, and ## See also -[MSVC Compiler Options](compiler-options.md)
+[MSVC Compiler Options](compiler-options.md)\ [MSVC Compiler Command-Line Syntax](compiler-command-line-syntax.md) diff --git a/docs/build/reference/idlout-name-midl-output-files.md b/docs/build/reference/idlout-name-midl-output-files.md index 38b277f76df..3c182933069 100644 --- a/docs/build/reference/idlout-name-midl-output-files.md +++ b/docs/build/reference/idlout-name-midl-output-files.md @@ -1,51 +1,45 @@ --- -description: "Learn more about: /IDLOUT (Name MIDL Output Files)" title: "/IDLOUT (Name MIDL Output Files)" -ms.date: "11/04/2016" +description: "Learn more about: /IDLOUT (Name MIDL Output Files)" +ms.date: 03/27/2025 f1_keywords: ["/idlout", "VC.Project.VCLinkerTool.MergedIDLBaseFileName"] helpviewer_keywords: ["MIDL, output file names", ".idl files, path", "MIDL", "/IDLOUT linker option", "IDL files, path", "-IDLOUT linker option", "IDLOUT linker option"] -ms.assetid: 10d00a6a-85b4-4de1-8732-e422c6931509 --- # /IDLOUT (Name MIDL Output Files) -``` -/IDLOUT:[path\]filename -``` +## Syntax -## Parameters +> /IDLOUT:[path\]filename -*path*
-An absolute or relative path specification. By specifying a path, you affect only the location of an .idl file; all other files are placed in the project directory. +## Argument -*filename*
-Specifies the name of the .idl file created by the MIDL compiler. No file extension is assumed; specify *filename*.idl if you want an .idl extension. +*`path`*\ +An absolute or relative path specification. By specifying a path, you affect only the location of an `.idl` file; all other files are placed in the project directory. + +*`filename`*\ +Specifies the name of the `.idl` file created by the MIDL compiler. No file extension is assumed; specify *`filename.idl` if you want an `.idl` extension. When expanded, the fully qualified filename must not exceed `MAX_PATH` (260 characters). ## Remarks -The /IDLOUT option specifies the name and extension of the .idl file. +The `/IDLOUT` option specifies the name and extension of the `.idl` file. -The MIDL compiler is called by the MSVC linker when linking projects that have the [module](../../windows/attributes/module-cpp.md) attribute. +The MIDL compiler is called by the MSVC linker when linking projects that have the [`module`](../../windows/attributes/module-cpp.md) attribute. -/IDLOUT also specifies the file names of the other output files associated with the MIDL compiler: +`/IDLOUT` also specifies the file names of the other output files associated with the MIDL compiler: - *filename*.tlb - - *filename*_p.c - - *filename*_i.c - - *filename*.h -*filename* is the parameter that you pass to /IDLOUT. If [/TLBOUT](tlbout-name-dot-tlb-file.md) is specified, the .tlb file will get its name from /TLBOUT *filename*. +*`filename`* is the parameter that you pass to `/IDLOUT`. If [`/TLBOUT`](tlbout-name-dot-tlb-file.md) is specified, the .tlb file will get its name from `/TLBOUT` *`filename`*. -If you specify neither /IDLOUT nor /TLBOUT, the linker will create vc70.tlb, vc70.idl, vc70_p.c, vc70_i.c, and vc70.h. +If you specify neither `/IDLOUT` nor `/TLBOUT`, the linker will create vc70.tlb, vc70.idl, vc70_p.c, vc70_i.c, and vc70.h. ### To set this linker option in the Visual Studio development environment 1. Open the project's **Property Pages** dialog box. For details, see [Set C++ compiler and build properties in Visual Studio](../working-with-project-properties.md). - 1. Select the **Configuration Properties** > **Linker** > **Embedded IDL** property page. - 1. Modify the **Merge IDL Base File Name** property. ### To set this linker option programmatically @@ -54,8 +48,8 @@ If you specify neither /IDLOUT nor /TLBOUT, the linker will create vc70.tlb, vc7 ## See also -[MSVC linker reference](linking.md)
-[MSVC Linker Options](linker-options.md)
-[/IGNOREIDL (Don't Process Attributes into MIDL)](ignoreidl-don-t-process-attributes-into-midl.md)
-[/MIDL (Specify MIDL Command Line Options)](midl-specify-midl-command-line-options.md)
+[MSVC linker reference](linking.md)\ +[MSVC Linker Options](linker-options.md)\ +[/IGNOREIDL (Don't Process Attributes into MIDL)](ignoreidl-don-t-process-attributes-into-midl.md)\ +[/MIDL (Specify MIDL Command Line Options)](midl-specify-midl-command-line-options.md)\ [Building an Attributed Program](../../windows/attributes/cpp-attributes-com-net.md) diff --git a/docs/build/reference/ifc-map.md b/docs/build/reference/ifc-map.md index e196dd9c339..7466fd2b000 100644 --- a/docs/build/reference/ifc-map.md +++ b/docs/build/reference/ifc-map.md @@ -17,7 +17,7 @@ This switch tells the compiler where to find the IFC reference map file, which m ## Remarks -The `*filename*` argument specifies the IFC reference map file. It can be relative to the compiler's working directory, or an absolute path. +The *`filename`* argument specifies the IFC reference map file. It can be relative to the compiler's working directory, or an absolute path. You can provide multiple `/ifcMap` arguments to the compiler. @@ -41,7 +41,7 @@ name = "N" ifc = "C:\\modules\\N.ifc" ``` -This IFC reference map file maps the named modules `'M'` and `'N'` to their respective IFC files. The equivalent [`/reference'](module-reference.md) is: +This IFC reference map file maps the named modules `'M'` and `'N'` to their respective IFC files. The equivalent [`/reference`](module-reference.md) is: ```cmd /reference M=C:\modules\M.ifc /reference N=C:\modules\N.ifc diff --git a/docs/build/reference/ilk-name-incremental-database-file.md b/docs/build/reference/ilk-name-incremental-database-file.md index 752535f8086..ab1d1d456e7 100644 --- a/docs/build/reference/ilk-name-incremental-database-file.md +++ b/docs/build/reference/ilk-name-incremental-database-file.md @@ -1,7 +1,7 @@ --- title: "/ILK (Name incremental database file)" description: "The MSVC linker option /ILK specifies the incremental link database file pathname." -ms.date: 09/07/2022 +ms.date: 03/27/2025 f1_keywords: ["VC.Project.VCLinkerTool.IncrementalLinkDatabaseFile", "/ilk", "ilk"] helpviewer_keywords: ["Name incremental database file in C++ linker", "/ILK linker option", "-ILK linker option", "ILK linker option"] --- @@ -16,7 +16,7 @@ The **`/ILK`** linker option tells the linker where to put the *`.ilk`* database ### Arguments *`pathname`*\ -The destination directory and filename for the generated *`.ilk`* file. If the **`/ILK`** option isn't specified when **`/INCREMENTAL`** is used, the filename is created by appending *`.ilk`* to the target base filename. +The destination directory and filename for the generated *`.ilk`* file. If the **`/ILK`** option isn't specified when **`/INCREMENTAL`** is used, the filename is created by appending *`.ilk`* to the target base filename. When expanded, the fully qualified filename must not exceed `MAX_PATH` (260 characters). ## Remarks @@ -25,9 +25,7 @@ The **`/ILK`** linker option tells the linker the path and filename to use for t ### To set this compiler option in the Visual Studio development environment 1. Open the project **Property Pages** dialog box. For more information, see [Set compiler and build properties](../working-with-project-properties.md). - 1. Select the **Configuration Properties** > **Linker** > **General** property page. - 1. Modify the **Incremental Link Database File** property. The default value is `$(IntDir)$(TargetName).ilk`. ### To set this compiler option programmatically diff --git a/docs/build/reference/implib-name-import-library.md b/docs/build/reference/implib-name-import-library.md index 9bf0f23ef31..93ad9b6efb6 100644 --- a/docs/build/reference/implib-name-import-library.md +++ b/docs/build/reference/implib-name-import-library.md @@ -1,38 +1,35 @@ --- description: "Learn more about: /IMPLIB (Name Import Library)" title: "/IMPLIB (Name Import Library)" -ms.date: "11/04/2016" +ms.date: 03/24/2025 f1_keywords: ["/implib", "VC.Project.VCLinkerTool.ImportLIbrary"] helpviewer_keywords: ["IMPLIB linker option", "/IMPLIB linker option", "-IMPLIB linker option", "import libraries, overriding default name"] -ms.assetid: fe8f71ab-7055-41b5-8ef8-2b97cfa4a432 --- -# /IMPLIB (Name Import Library) +# `/IMPLIB` (Name Import Library) + +## Syntax > /IMPLIB:*filename* -## Parameters +## Argument -*filename*
-A user-specified name for the import library. It replaces the default name. +*`filename`*\ +A user-specified name for the import library. It replaces the default name. When expanded, the fully qualified filename must not exceed `MAX_PATH` (260 characters). ## Remarks -The /IMPLIB option overrides the default name for the import library that LINK creates when it builds a program that contains exports. The default name is formed from the base name of the main output file and the extension .lib. A program contains exports if one or more of the following are specified: +The `/IMPLIB` option overrides the default name for the import library that LINK creates when it builds a program that contains exports. The default name is formed from the base name of the main output file and the extension `.lib`. A program contains exports if one or more of the following are specified: - The [__declspec(dllexport)](../../cpp/dllexport-dllimport.md) keyword in the source code - - [EXPORTS](exports.md) statement in a .def file - - An [/EXPORT](export-exports-a-function.md) specification in a LINK command -LINK ignores /IMPLIB when an import library is not being created. If no exports are specified, LINK does not create an import library. If an export file is used in the build, LINK assumes that an import library already exists and does not create one. For information on import libraries and export files, see [LIB Reference](lib-reference.md). +LINK ignores `/IMPLIB` when an import library isn't being created. If no exports are specified, LINK doesn't create an import library. If an export file is used in the build, LINK assumes that an import library already exists and doesn't create one. For information on import libraries and export files, see [LIB Reference](lib-reference.md). ### To set this linker option in the Visual Studio development environment 1. Open the project's **Property Pages** dialog box. For details, see [Set C++ compiler and build properties in Visual Studio](../working-with-project-properties.md). - 1. Select the **Configuration Properties** > **Linker** > **Advanced** property page. - 1. Modify the **Import Library** property. ### To set this linker option programmatically @@ -41,5 +38,5 @@ LINK ignores /IMPLIB when an import library is not being created. If no exports ## See also -[MSVC linker reference](linking.md)
+[MSVC linker reference](linking.md)\ [MSVC Linker Options](linker-options.md) diff --git a/docs/build/reference/integritycheck-require-signature-check.md b/docs/build/reference/integritycheck-require-signature-check.md index 2e154fe9607..0820e55c26c 100644 --- a/docs/build/reference/integritycheck-require-signature-check.md +++ b/docs/build/reference/integritycheck-require-signature-check.md @@ -17,7 +17,7 @@ The **`/INTEGRITYCHECK`** linker option sets a flag, `IMAGE_DLLCHARACTERISTICS_F ### Signing `/INTEGRITYCHECK` files -Microsoft has new signing guidance for DLL and executable files linked by using **`/INTEGRITYCHECK`**. The guidance used to recommend a cross-signed certificate from the [cross-signing program](/windows-hardware/drivers/install/cross-certificates-for-kernel-mode-code-signing). However, the [cross-signing program is now deprecated](/windows-hardware/drivers/install/deprecation-of-software-publisher-certificates-and-commercial-release-certificates). You must now sign your **`/INTEGRITYCHECK`** files by using the Microsoft [Trusted Signing service](/azure/trusted-signing/) program instead. +Microsoft has new signing guidance for DLL and executable files linked by using **`/INTEGRITYCHECK`**. The guidance used to recommend a cross-signed certificate from the [cross-signing program](/windows-hardware/drivers/install/cross-certificates-for-kernel-mode-code-signing). However, the [cross-signing program is now deprecated](/windows-hardware/drivers/install/deprecation-of-software-publisher-certificates-and-commercial-release-certificates). You must now sign your **`/INTEGRITYCHECK`** files by using the [Azure Artifact Signing service](https://azure.microsoft.com/products/artifact-signing) program instead. ### To set this linker option in Visual Studio diff --git a/docs/build/reference/keyfile-specify-key-or-key-pair-to-sign-an-assembly.md b/docs/build/reference/keyfile-specify-key-or-key-pair-to-sign-an-assembly.md index 2ef01ea5436..3d1a74d531c 100644 --- a/docs/build/reference/keyfile-specify-key-or-key-pair-to-sign-an-assembly.md +++ b/docs/build/reference/keyfile-specify-key-or-key-pair-to-sign-an-assembly.md @@ -1,12 +1,11 @@ --- -description: "Learn more about: /KEYFILE (Specify Key or Key Pair to Sign an Assembly)" title: "/KEYFILE (Specify Key or Key Pair to Sign an Assembly)" -ms.date: "11/04/2016" +description: "Learn more about: /KEYFILE (Specify Key or Key Pair to Sign an Assembly)" +ms.date: 03/24/2025 f1_keywords: ["/keyfile", "VC.Project.VCLinkerTool.KeyFile"] helpviewer_keywords: ["/KEYFILE linker option", "-KEYFILE linker option", "KEYFILE linker option"] -ms.assetid: 9b71f8c0-541c-4fe5-a0c7-9364f42ecb06 --- -# /KEYFILE (Specify Key or Key Pair to Sign an Assembly) +# `/KEYFILE` (Specify Key or Key Pair to Sign an Assembly) ``` /KEYFILE:filename @@ -14,39 +13,33 @@ ms.assetid: 9b71f8c0-541c-4fe5-a0c7-9364f42ecb06 ## Arguments -*filename*
+*`filename`*\ File that contains the key. Place the string in double quotation marks (" ") if it contains a space. ## Remarks -The linker inserts the public key into the assembly manifest and then signs the final assembly with the private key. To generate a key file, type [sn -k](/dotnet/framework/tools/sn-exe-strong-name-tool) *filename* at the command line. A signed assembly is said to have a strong name. +The linker inserts the public key into the assembly manifest and then signs the final assembly with the private key. To generate a key file, type [`sn -k`](/dotnet/framework/tools/sn-exe-strong-name-tool) *filename* at the command line. A signed assembly is said to have a strong name. -If you compile with [/LN](ln-create-msil-module.md), the name of the key file is held in the module and incorporated into the assembly that is created when you compile an assembly that includes an explicit reference to the module, via [#using](../../preprocessor/hash-using-directive-cpp.md), or when linking with [/ASSEMBLYMODULE](assemblymodule-add-a-msil-module-to-the-assembly.md). +If you compile with [`/LN`](ln-create-msil-module.md), the name of the key file is held in the module and incorporated into the assembly that is created when you compile an assembly that includes an explicit reference to the module, via [`#using`](../../preprocessor/hash-using-directive-cpp.md), or when linking with [`/ASSEMBLYMODULE`](assemblymodule-add-a-msil-module-to-the-assembly.md). -You can also pass your encryption information to the linker with [/KEYCONTAINER](keycontainer-specify-a-key-container-to-sign-an-assembly.md). Use [/DELAYSIGN](delaysign-partially-sign-an-assembly.md) if you want a partially signed assembly. For more information on signing an assembly, see [Strong Name Assemblies (Assembly Signing) (C++/CLI)](../../dotnet/strong-name-assemblies-assembly-signing-cpp-cli.md) and [Creating and Using Strong-Named Assemblies](/dotnet/framework/app-domains/create-and-use-strong-named-assemblies). +You can also pass your encryption information to the linker with [`/KEYCONTAINER`](keycontainer-specify-a-key-container-to-sign-an-assembly.md). Use [`/DELAYSIGN`](delaysign-partially-sign-an-assembly.md) if you want a partially signed assembly. For more information on signing an assembly, see [Strong Name Assemblies (Assembly Signing) (C++/CLI)](../../dotnet/strong-name-assemblies-assembly-signing-cpp-cli.md) and [Creating and Using Strong-Named Assemblies](/dotnet/framework/app-domains/create-and-use-strong-named-assemblies). -In case both **/KEYFILE** and **/KEYCONTAINER** are specified (either by command-line option or by custom attribute), the linker will first try the key container. If that succeeds, then the assembly is signed with the information in the key container. If the linker doesn't find the key container, it will try the file specified with /KEYFILE. If that succeeds, the assembly is signed with the information in the key file and the key information will be installed in the key container (similar to sn -i) so that on the next compilation, the key container will be valid. +In case both **`/KEYFILE`** and **`/KEYCONTAINER`** are specified (either by command-line option or by custom attribute), the linker will first try the key container. If that succeeds, then the assembly is signed with the information in the key container. If the linker doesn't find the key container, it will try the file specified with /KEYFILE. If that succeeds, the assembly is signed with the information in the key file and the key information will be installed in the key container (similar to sn -i) so that on the next compilation, the key container will be valid. A key file might contain only the public key. Other linker options that affect assembly generation are: -- [/ASSEMBLYDEBUG](assemblydebug-add-debuggableattribute.md) - -- [/ASSEMBLYLINKRESOURCE](assemblylinkresource-link-to-dotnet-framework-resource.md) - -- [/ASSEMBLYMODULE](assemblymodule-add-a-msil-module-to-the-assembly.md) - -- [/ASSEMBLYRESOURCE](assemblyresource-embed-a-managed-resource.md) - -- [/NOASSEMBLY](noassembly-create-a-msil-module.md) +- [`/ASSEMBLYDEBUG`](assemblydebug-add-debuggableattribute.md) +- [`/ASSEMBLYLINKRESOURCE`](assemblylinkresource-link-to-dotnet-framework-resource.md) +- [`/ASSEMBLYMODULE`](assemblymodule-add-a-msil-module-to-the-assembly.md) +- [`/ASSEMBLYRESOURCE`](assemblyresource-embed-a-managed-resource.md) +- [`/NOASSEMBLY`](noassembly-create-a-msil-module.md) ### To set this linker option in the Visual Studio development environment 1. Open the project's **Property Pages** dialog box. For details, see [Set C++ compiler and build properties in Visual Studio](../working-with-project-properties.md). - 1. Select the **Configuration Properties** > **Linker** > **Command Line** property page. - 1. Enter the option into the **Additional Options** box. ### To set this linker option programmatically @@ -55,5 +48,5 @@ Other linker options that affect assembly generation are: ## See also -[MSVC linker reference](linking.md)
+[MSVC linker reference](linking.md)\ [MSVC Linker Options](linker-options.md) diff --git a/docs/build/reference/libpath-additional-libpath.md b/docs/build/reference/libpath-additional-libpath.md index 1ac84a54858..64cfdd3f947 100644 --- a/docs/build/reference/libpath-additional-libpath.md +++ b/docs/build/reference/libpath-additional-libpath.md @@ -1,32 +1,29 @@ --- description: "Learn more about: /LIBPATH (Additional Libpath)" title: "/LIBPATH (Additional Libpath)" -ms.date: "11/04/2016" +ms.date: 03/27/2025 f1_keywords: ["/libpath", "VC.Project.VCLinkerTool.AdditionalLibraryDirectories"] helpviewer_keywords: ["LIBPATH linker option", "/LIBPATH linker option", "Additional Libpath linker option", "environment library path override", "-LIBPATH linker option", "library path linker option"] -ms.assetid: 7240af0b-9a3d-4d53-8169-2a92cd6958ba --- -# /LIBPATH (Additional Libpath) +# `/LIBPATH` (Additional Libpath) -``` -/LIBPATH:dir -``` +## Syntax -## Parameters +> /LIBPATH:dir -*dir*
-Specifies a path that the linker will search before it searches the path specified in the LIB environment option. +## Argument + +*`dir`*\ +Specifies a path that the linker searches before it searches the path specified in the `LIB` environment option. When expanded, the fully qualified directory must not exceed `MAX_PATH` (260 characters). ## Remarks -Use the /LIBPATH option to override the environment library path. The linker will first search in the path specified by this option, and then search in the path specified in the LIB environment variable. You can specify only one directory for each /LIBPATH option you enter. If you want to specify more than one directory, you must specify multiple /LIBPATH options. The linker will then search the specified directories in order. +Use the `/LIBPATH` option to override the environment library path. The linker first searches in the path specified by this option, and then searches in the path specified in the `LIB` environment variable. You can specify only one directory for each `/LIBPATH` option you enter. To specify more than one directory, specify multiple `/LIBPATH` options. The linker searches the specified directories in order. ### To set this linker option in the Visual Studio development environment 1. Open the project's **Property Pages** dialog box. For details, see [Set C++ compiler and build properties in Visual Studio](../working-with-project-properties.md). - 1. Select the **Configuration Properties** > **Linker** > **General** property page. - 1. Modify the **Additional Library Directories** property. ### To set this linker option programmatically @@ -35,5 +32,5 @@ Use the /LIBPATH option to override the environment library path. The linker wil ## See also -[MSVC linker reference](linking.md)
+[MSVC linker reference](linking.md)\ [MSVC Linker Options](linker-options.md) diff --git a/docs/build/reference/link-repro-full-path-rsp.md b/docs/build/reference/link-repro-full-path-rsp.md index 1174adb871b..c08892e4c70 100644 --- a/docs/build/reference/link-repro-full-path-rsp.md +++ b/docs/build/reference/link-repro-full-path-rsp.md @@ -1,23 +1,28 @@ --- description: "Learn more about: /LINKREPROFULLPATHRSP (Generate file containing absolute paths of linked files)" title: "/LINKREPROFULLPATHRSP (Generate file containing absolute paths of linked files)" -ms.date: 06/10/2024 +ms.date: 03/27/2025 f1_keywords: ["VC.Project.VCLinkerTool.LinkReproFullPathRSP", "/LINKREPROFULLPATHRSP"] helpviewer_keywords: ["/LINKREPROFULLPATHRSP linker option", "-LINKREPROFULLPATHRSP linker option", "LINKREPROFULLPATHRSP linker option"] --- # `/LINKREPROFULLPATHRSP` (Generate file containing absolute paths of linked files) -Generates a response file (.RSP) containing the absolute paths of all the files the linker took as input. +Generates a response file (`.RSP`) containing the absolute paths of all the files the linker took as input. This flag was introduced in Visual Studio 2022 version 17.11. ## Syntax -> **`/LINKREPROFULLPATHRSP:filename`** +> **/LINKREPROFULLPATHRSP:filename** + +## Argument + +*`filename`*\ +Specifies the name of the response file to create. When expanded, the fully qualified filename must not exceed `MAX_PATH` (260 characters). ## Remarks -Rather than generating a full link repro like `/LINKREPRO` which copies all the files to a directory and creating a response file with relative paths to that directory, this option writes the names of the files used during linking to the specified file. +Rather than generate a full link repro like `/LINKREPRO`, which copies all the files to a directory and creates a response file with relative paths to that directory, this option writes the names of the files used during linking to the specified file. For example, given: - a directory `c:\temp\test` that contains the files `test.cpp`, `f1.cpp`, `f2.cpp` diff --git a/docs/build/reference/linker-options.md b/docs/build/reference/linker-options.md index 968094a0b51..5749d0c2364 100644 --- a/docs/build/reference/linker-options.md +++ b/docs/build/reference/linker-options.md @@ -1,7 +1,7 @@ --- title: "MSVC Linker options" description: "A list of the options supported by the Microsoft LINK linker." -ms.date: 06/10/2024 +ms.date: 03/14/2025 f1_keywords: ["link"] helpviewer_keywords: ["linker [C++]", "linker [C++], options listed", "libraries [C++], linking to COFF", "LINK tool [C++], linker options"] --- @@ -9,14 +9,14 @@ helpviewer_keywords: ["linker [C++]", "linker [C++], options listed", "libraries LINK.exe links Common Object File Format (COFF) object files and libraries to create an executable (EXE) file or a dynamic-link library (DLL). -The following table lists options for LINK.exe. For more information about LINK, see: +The following table lists options for `LINK.exe`. For more information about LINK, see: - [Compiler-controlled LINK options](compiler-controlled-link-options.md) - [LINK input files](link-input-files.md) - [LINK output](link-output.md) - [Reserved words](reserved-words.md) -On the command line, linker options aren't case-sensitive; for example, `/base` and `/BASE` mean the same thing. For details on how to specify each option on the command line or in Visual Studio, see the documentation for that option. +Linker options aren't case-sensitive; for example, `/base` and `/BASE` mean the same thing. For details on how to specify each option on the command line or in Visual Studio, see the documentation for that option. You can use the [`comment`](../../preprocessor/comment-c-cpp.md) pragma to specify some linker options. @@ -52,6 +52,7 @@ You can use the [`comment`](../../preprocessor/comment-c-cpp.md) pragma to speci | [`/DLL`](dll-build-a-dll.md) | Builds a DLL. | | [`/DRIVER`](driver-windows-nt-kernel-mode-driver.md) | Creates a kernel mode driver. | | [`/DYNAMICBASE`](dynamicbase-use-address-space-layout-randomization.md) | Specifies whether to generate an executable image that's rebased at load time by using the address space layout randomization (ASLR) feature. | +| [`/DYNAMICDEOPT`](dynamic-deopt-linker.md) | Enable [C++ Dynamic Debugging (Preview)](/visualstudio/debugger/cpp-dynamic-debugging) and step in anywhere with on-demand function deoptimization. | | [`/ENTRY`](entry-entry-point-symbol.md) | Sets the starting address. | | [`/ERRORREPORT`](errorreport-report-internal-linker-errors.md) | Deprecated. Error reporting is controlled by [Windows Error Reporting (WER)](/windows/win32/wer/windows-error-reporting) settings. | | [`/EXPORT`](export-exports-a-function.md) | Exports a function. | diff --git a/docs/build/reference/linker-property-pages.md b/docs/build/reference/linker-property-pages.md index 84c379aa0b3..27a8a52d11c 100644 --- a/docs/build/reference/linker-property-pages.md +++ b/docs/build/reference/linker-property-pages.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Linker Property Pages" title: "Linker Property Pages" +description: "Learn more about: Linker Property Pages" ms.date: 09/07/2022 ms.topic: "article" f1_keywords: ["VC.Project.VCLinkerTool.IgnoreImportLibrary", "VC.Project.VCLinkerTool.RegisterOutput", "VC.Project.VCLinkerTool.PerUserRedirection", "VC.Project.VCLinkerTool.LinkLibraryDependencies", "VC.Project.VCLinkerTool.UseLibraryDependencyInputs"] -ms.assetid: 7e7671e5-a35a-4e67-9bdb-661d75c4d11e --- # Linker Property Pages @@ -252,7 +251,7 @@ Specifies total heap allocation size in virtual memory. Default is 1 MB. ([`/ ### Heap Commit Size -Specifies total heap allocation size in physical memory. Default is 4 KB. (`[/HEAP:reserve,commit`](heap-set-heap-size.md)) +Specifies total heap allocation size in physical memory. Default is 4 KB. ([`/HEAP:reserve,commit`](heap-set-heap-size.md)) ### Stack Reserve Size @@ -373,7 +372,7 @@ Partially sign the Windows Metadata. Use [`/WINMDDELAYSIGN`](winmddelaysign-part ### Entry Point -The `[/ENTRY`](entry-entry-point-symbol.md) option specifies an entry point function as the starting address for an *`.exe`* file or DLL. +The [`/ENTRY`](entry-entry-point-symbol.md) option specifies an entry point function as the starting address for an *`.exe`* file or DLL. ### No Entry Point diff --git a/docs/build/reference/linking.md b/docs/build/reference/linking.md index ecfebb24966..1934bea919d 100644 --- a/docs/build/reference/linking.md +++ b/docs/build/reference/linking.md @@ -1,7 +1,7 @@ --- description: "Learn more about: Linking" title: "MSVC linker reference" -ms.date: "12/10/2018" +ms.date: 03/27/2025 --- # Linking @@ -38,6 +38,9 @@ On the command line, an option consists of an option specifier, either a dash (` To pass a file to the linker, specify the filename on the command line after the `link.exe` command. You can specify an absolute or relative path with the filename, and you can use wildcards in the filename. If you omit the dot (`.`) and filename extension, the linker assumes an extension of `.obj` to find the file. The linker doesn't use filename extensions or the lack of them to make assumptions about the contents of files. It determines the type of file by examining it, and processes it accordingly. +> [!NOTE] +> Various linker flags take a filename. Whether you specify a relative path or an absolute path, if the fully-qualified filename exceeds `MAX_PATH` (260 characters), the linker may fail--particularly while searching for libraries. If you encounter this problem, try using a shorter path. + The linker returns zero for success (no errors). Otherwise, it returns the error number that stopped the link. For example, if the linker generates `LNK1104`, the linker returns 1104. Accordingly, the lowest error number returned on an error by the linker is 1000. A return value of 128 represents a configuration problem with either the operating system or a .config file; the loader didn't load either `link.exe` or `c2.dll`. ## Linker command files @@ -46,7 +49,7 @@ You can pass command-line arguments to `link.exe` in the form of a command file. > `link @commandfile` -The *`commandfile`* is the name of a text file. No space or tab is allowed between the at sign (**\@**) and the filename. There's no default extension; you must specify the full filename, including any extension. Wildcards can't be used. You can specify an absolute or relative path with the filename. The linker doesn't use an environment variable to search for the file. +The *`commandfile`* is the name of a text file. No space or tab is allowed between the at sign (**\@**) and the filename. There's no default extension; you must specify the full filename, including any extension. Wildcards can't be used. You can specify an absolute or relative path with the filename. Must not exceed `MAX_PATH` (260 characters). The linker doesn't use an environment variable to search for the file. In the command file, arguments are separated by spaces or tabs (as on the command line) and by newline characters. @@ -65,8 +68,8 @@ link /dll @objlist.txt @liblist.txt @exports.txt The linker recognizes the following environment variables: - `LINK` and `_LINK_`, if defined. The linker prepends the options and arguments defined in the `LINK` environment variable and appends the options and arguments defined in the `_LINK_` environment variable to the command line arguments before processing. -- `LIB`, if defined. The linker uses the `LIB` path when it searches for an object, library, or other file specified on the command line or by the [`/BASE`](base-base-address.md) option. It also uses the `LIB` path to find a `.pdb` file named in an object. The `LIB` variable can contain one or more path specifications, separated by semicolons. One path must point to the `\lib` subdirectory of your Visual C++ installation. -- `PATH`, if the tool needs to run `CVTRES` and can't find the file in the same directory as `link.exe` itself. (`link.exe` requires `CVTRES` to link a `.res` file.) `PATH` must point to the `\bin` subdirectory of your Visual C++ installation. +- `LIB`, if defined. The linker uses the `LIB` path when it searches for an object, library, or other file specified on the command line or by the [`/BASE`](base-base-address.md) option. It also uses the `LIB` path to find a `.pdb` file named in an object. The `LIB` variable can contain one or more path specifications, separated by semicolons. One path must point to the `\lib` subdirectory of your Microsoft C++ installation. +- `PATH`, if the tool needs to run `CVTRES` and can't find the file in the same directory as `link.exe` itself. (`link.exe` requires `CVTRES` to link a `.res` file.) `PATH` must point to the `\bin` subdirectory of your Microsoft C++ installation. - `TMP`, to specify a directory when linking OMF or `.res` files. ## See also diff --git a/docs/build/reference/linkrepro.md b/docs/build/reference/linkrepro.md index 9d00525a14d..a106200fdc4 100644 --- a/docs/build/reference/linkrepro.md +++ b/docs/build/reference/linkrepro.md @@ -1,7 +1,7 @@ --- title: "/LINKREPRO (Link repro directory name)" description: Linker or library tool option to set the directory for a link repro. -ms.date: "09/24/2019" +ms.date: 03/28/2025 f1_keywords: ["/LINKREPRO"] helpviewer_keywords: ["LINKREPRO linker option", "/LINKREPRO linker option", "-LINKREPRO linker option", "linker repro reporting"] --- @@ -11,12 +11,12 @@ Tells the linker or library tool to generate a link repro in a specified directo ## Syntax -> **/LINKREPRO:**_directory-name_ +> `/LINKREPRO:` **_directory-name_** ### Arguments -**/LINKREPRO:**_directory-name_\ -The user-specified directory to store the link repro in. Directory names that include spaces must be enclosed in double quotes. +**_directory-name_**\ +The user-specified directory to store the link repro in. Directory names that include spaces must be enclosed in double quotes. When expanded, the fully qualified link repro filename must not exceed `MAX_PATH` (260 characters). ## Remarks diff --git a/docs/build/reference/ln-create-msil-module.md b/docs/build/reference/ln-create-msil-module.md index c1a892c54b2..4ec40b38bd7 100644 --- a/docs/build/reference/ln-create-msil-module.md +++ b/docs/build/reference/ln-create-msil-module.md @@ -1,14 +1,13 @@ --- -description: "Learn more about: /LN (Create MSIL Module)" title: "/LN (Create MSIL Module)" -ms.date: "11/04/2016" +description: "Learn more about: /LN (Create MSIL Module)" +ms.date: 11/04/2016 f1_keywords: ["/LN"] helpviewer_keywords: ["-LN compiler option [C++]", "/LN compiler option [C++]"] -ms.assetid: 4f38f4f4-3176-4caf-8200-5c7585dc1ed3 --- # /LN (Create MSIL Module) -Specifies that an assembly manifest should not be inserted into the output file. +Specifies that the compiler shouldn't insert an assembly manifest into the output file. ## Syntax @@ -18,27 +17,27 @@ Specifies that an assembly manifest should not be inserted into the output file. ## Remarks -By default, **/LN** is not in effect (an assembly manifest is inserted into the output file). +By default, `/LN` isn't in effect, and the compiler inserts an assembly manifest into the output file. -When **/LN** is used, one of the [/clr (Common Language Runtime Compilation)](clr-common-language-runtime-compilation.md) options must also be used. +When you use `/LN`, you must also use one of the [/clr (Common Language Runtime Compilation)](clr-common-language-runtime-compilation.md) options. -A managed program that does not have an assembly metadata in the manifest is called a module. If you compile with [/c (Compile Without Linking)](c-compile-without-linking.md) and **/LN**, specify [/NOASSEMBLY (Create a MSIL Module)](noassembly-create-a-msil-module.md) in the linker phase to create the output file. +A managed program that doesn't have assembly metadata in the manifest is called a module. If you compile with [/c (Compile Without Linking)](c-compile-without-linking.md) and `/LN`, specify [`/NOASSEMBLY` (Create a MSIL Module)](noassembly-create-a-msil-module.md) in the linker phase to create the output file. -You may want to create modules if you want to take a component-based approach to building assemblies. That is, you can author types and compile them into modules. Then, you can generate an assembly from one or more modules. For more information on creating assemblies from modules, see [.netmodule Files as Linker Input](netmodule-files-as-linker-input.md) or [Al.exe (Assembly Linker)](/dotnet/framework/tools/al-exe-assembly-linker). +Create modules if you want to take a component-based approach to building assemblies. You can author types and compile them into modules. Then, you can generate an assembly from one or more modules. For more information on creating assemblies from modules, see [`.netmodule` Files as Linker Input](netmodule-files-as-linker-input.md) or [`Al.exe` (Assembly Linker)](/dotnet/framework/tools/al-exe-assembly-linker). -The default file extension for a module is .netmodule. +The default file extension for a module is `.netmodule`. -In releases before Visual Studio 2005, a module was created with **/clr:noAssembly**. +In releases before Visual Studio 2005, you created a module with `/clr:noAssembly`. -The MSVC linker accepts .netmodule files as input and the output file produced by the linker will be an assembly or .netmodule with no run-time dependence on any of the .netmodules that were input to the linker. For more information, see [.netmodule Files as Linker Input](netmodule-files-as-linker-input.md). +The MSVC linker accepts `.netmodule` files as input. The output file produced by the linker is an assembly or `.netmodule` with no run-time dependence on any of the `.netmodule`s that you input to the linker. For more information, see [`.netmodule` Files as Linker Input](netmodule-files-as-linker-input.md). ### To set this compiler option in the Visual Studio development environment -- Specify [/NOASSEMBLY (Create a MSIL Module)](noassembly-create-a-msil-module.md) in the linker phase to create the output file. +- Specify [`/NOASSEMBLY` (Create a MSIL Module)](noassembly-create-a-msil-module.md) in the linker phase to create the output file. ### To set this compiler option programmatically -- This compiler option cannot be changed programmatically. +- You can't change this compiler option programmatically. ## See also diff --git a/docs/build/reference/manifestfile-name-manifest-file.md b/docs/build/reference/manifestfile-name-manifest-file.md index acd17845b98..32a06f368ed 100644 --- a/docs/build/reference/manifestfile-name-manifest-file.md +++ b/docs/build/reference/manifestfile-name-manifest-file.md @@ -4,26 +4,28 @@ title: "/MANIFESTFILE (Name Manifest File)" ms.date: "11/04/2016" f1_keywords: ["VC.Project.VCLinkerTool.ManifestFile"] helpviewer_keywords: ["MANIFESTFILE linker option", "-MANIFESTFILE linker option", "/MANIFESTFILE linker option"] -ms.assetid: befa5ab2-a9cf-4c9b-969a-e7b4a930f08d --- # /MANIFESTFILE (Name Manifest File) -``` -/MANIFESTFILE:filename -``` +Change the default name of the manifest file. -## Remarks +## Syntax + +> `/MANIFESTFILE:`**filename** -/MANIFESTFILE lets you change the default name of the manifest file. The default name of the manifest file is the file name with .manifest appended. +## Arguments -/MANIFESTFILE will have no effect if you do not also link with [/MANIFEST](manifest-create-side-by-side-assembly-manifest.md). +**filename**\ +The default name of the manifest file is *filename* with `.manifest` appended. + +## Remarks + +`/MANIFESTFILE` has no effect if you do not also link with [/MANIFEST](manifest-create-side-by-side-assembly-manifest.md). ### To set this linker option in the Visual Studio development environment 1. Open the project's **Property Pages** dialog box. For details, see [Set C++ compiler and build properties in Visual Studio](../working-with-project-properties.md). - 1. Select the **Configuration Properties** > **Linker** > **Manifest File** property page. - 1. Modify the **Manifest File** property. ### To set this linker option programmatically @@ -32,5 +34,5 @@ ms.assetid: befa5ab2-a9cf-4c9b-969a-e7b4a930f08d ## See also -[MSVC linker reference](linking.md)
+[MSVC linker reference](linking.md)\ [MSVC Linker Options](linker-options.md) diff --git a/docs/build/reference/manifestinput-specify-manifest-input.md b/docs/build/reference/manifestinput-specify-manifest-input.md index 9c48c9dc54e..df8b326f7d6 100644 --- a/docs/build/reference/manifestinput-specify-manifest-input.md +++ b/docs/build/reference/manifestinput-specify-manifest-input.md @@ -1,9 +1,8 @@ --- description: "Learn more about: /MANIFESTINPUT (Specify Manifest Input)" title: "/MANIFESTINPUT (Specify Manifest Input)" -ms.date: 09/09/2022 +ms.date: 03/27/2025 f1_keywords: ["VC.Project.VCLinkerTool.ManifestInput"] -ms.assetid: a0b0c21e-1f9b-4d8c-bb3f-178f57fa7f1b --- # /MANIFESTINPUT (Specify Manifest Input) @@ -11,20 +10,20 @@ Specifies a manifest input file to include in the manifest that's embedded in th ## Syntax -> **`/MANIFESTINPUT:`***`filename`* +> `/MANIFESTINPUT:`*filename* ### Parameters -*`filename`*\ -The manifest file to include in the embedded manifest. +*filename*\ +The manifest file to include in the embedded manifest. When expanded, the fully qualified filename must not exceed `MAX_PATH` (260 characters). ## Remarks The **`/MANIFESTINPUT`** option specifies the path of an input file to use to create the embedded manifest in an executable image. If you have multiple manifest input files, use the switch multiple times: once for each input file. The manifest input files are merged to create the embedded manifest. This option requires the **`/MANIFEST:EMBED`** option. -This option can't be set directly in Visual Studio. Instead, use the **Additional Manifest Files** property of the project to specify additional manifest files to include. For more information, see [Manifest Tool Property Pages](manifest-tool-property-pages.md). +This option can't be set directly in Visual Studio. Instead, use the **Additional Manifest Files** property of the project to specify other manifest files to include. For more information, see [Manifest Tool Property Pages](manifest-tool-property-pages.md). ## See also -[MSVC linker reference](linking.md)
+[MSVC linker reference](linking.md)\ [MSVC Linker Options](linker-options.md) diff --git a/docs/build/reference/md-mt-ld-use-run-time-library.md b/docs/build/reference/md-mt-ld-use-run-time-library.md index ccbfe48d71f..0867d33ed05 100644 --- a/docs/build/reference/md-mt-ld-use-run-time-library.md +++ b/docs/build/reference/md-mt-ld-use-run-time-library.md @@ -1,14 +1,13 @@ --- -description: "Learn more about: /MD, /MT, /LD (Use Run-Time Library)" -title: "/MD, -MT, -LD (Use Run-Time Library)" -ms.date: "07/17/2019" +title: "/MD, /MT, /LD (Use runtime library)" +description: "Learn more about: /MD, /MT, /LD (Use runtime library)" +ms.date: "01/13/2025" f1_keywords: ["/ld", "/mt", "VC.Project.VCCLWCECompilerTool.RuntimeLibrary", "VC.Project.VCCLCompilerTool.RuntimeLibrary", "/md", "/ml"] helpviewer_keywords: ["/MT compiler option [C++]", "-MD compiler option [C++]", "threading [C++], multithread compiler option", "MSVCRTD.lib", "MSVCRT.lib", "LIBCMT.lib", "MD compiler option [C++]", "/MD compiler option [C++]", "MT compiler option [C++]", "LD compiler option [C++]", "MDd compiler option [C++]", "-MDd compiler option [C++]", "LIBCD.lib", "-MTd compiler option [C++]", "MTd compiler option [C++]", "/MTd compiler option [C++]", "-LD compiler option [C++]", "/MDd compiler option [C++]", "multithread compiler option", "_STATIC_CPPLIB symbol", "LIBC.lib", "/LD compiler option [C++]", "DLLs [C++], compiler options", "LIBCMTD.lib", "-MT compiler option [C++]"] -ms.assetid: cf7ed652-dc3a-49b3-aab9-ad60e5395579 --- -# /MD, /MT, /LD (Use Run-Time Library) +# /MD, /MT, /LD (Use runtime library) -Indicates whether a multithreaded module is a DLL and specifies retail or debug versions of the run-time library. +Indicates whether a multithreaded module is a DLL and specifies retail or debug versions of the runtime library. ## Syntax @@ -22,27 +21,25 @@ Indicates whether a multithreaded module is a DLL and specifies retail or debug |Option|Description| |------------|-----------------| -|**/MD**|Causes the application to use the multithread-specific and DLL-specific version of the run-time library. Defines `_MT` and `_DLL` and causes the compiler to place the library name MSVCRT.lib into the .obj file.| -|**/MDd**|Defines `_DEBUG`, `_MT`, and `_DLL` and causes the application to use the debug multithread-specific and DLL-specific version of the run-time library. It also causes the compiler to place the library name MSVCRTD.lib into the .obj file.| -|**/MT**|Causes the application to use the multithread, static version of the run-time library. Defines `_MT` and causes the compiler to place the library name LIBCMT.lib into the .obj file so that the linker will use LIBCMT.lib to resolve external symbols.| -|**/MTd**|Defines `_DEBUG` and `_MT`. This option also causes the compiler to place the library name LIBCMTD.lib into the .obj file so that the linker will use LIBCMTD.lib to resolve external symbols.| -|**/LD**|Creates a DLL.

Passes the **/DLL** option to the linker. The linker looks for, but does not require, a `DllMain` function. If you do not write a `DllMain` function, the linker inserts a `DllMain` function that returns TRUE.

Links the DLL startup code.

Creates an import library (.lib), if an export (.exp) file is not specified on the command line. You link the import library to applications that call your DLL.

Interprets [/Fe (Name EXE File)](fe-name-exe-file.md) as naming a DLL rather than an .exe file. By default, the program name becomes *basename*.dll instead of *basename*.exe.

Implies **/MT** unless you explicitly specify **/MD**.| -|**/LDd**|Creates a debug DLL. Defines `_MT` and `_DEBUG`.| +|**/MD**|Use the multithread-specific and DLL-specific version of the runtime library. Defines `_MT` and `_DLL`. The linker uses the `MSVCRT.lib` import library to resolve runtime symbols.| +|**/MDd**|Use the debug multithread-specific and DLL-specific version of the runtime library. Defines `_DEBUG`, `_MT`, and `_DLL`. The linker uses the `MSVCRTD.lib` import library to resolve runtime symbols.| +|**/MT**| Use the multithread, static version of the runtime library. Defines `_MT`. The linker uses `LIBCMT.lib` to resolve runtime symbols.| +|**/MTd**| Use the debug multithread, static version of the runtime library. Defines `_DEBUG` and `_MT`. The linker uses `LIBCMTD.lib` to resolve runtime symbols.| +|**/LD**|Create a DLL.

Passes the **/DLL** option to the linker. The linker looks for, but does not require, a `DllMain` function. If you don't write a `DllMain` function, the linker inserts a `DllMain` function that returns TRUE.

Links the DLL startup code.

Creates an import library (`.lib`), if an export (`.exp`) file is not specified on the command line. You link the import library to applications that call your DLL.

Interprets [/Fe (Name EXE File)](fe-name-exe-file.md) as naming a DLL rather than an `.exe` file. By default, the program name becomes *basename*.dll instead of *basename*.exe.

Implies **/MT** unless you explicitly specify **/MD**.| +|**/LDd**|Create a debug DLL. Defines `_MT` and `_DEBUG`.| -For more information about C run-time libraries and which libraries are used when you compile with [/clr (Common Language Runtime Compilation)](clr-common-language-runtime-compilation.md), see [CRT Library Features](../../c-runtime-library/crt-library-features.md). +For more information about C runtime libraries and which libraries are used when you compile with [/clr (Common Language Runtime Compilation)](clr-common-language-runtime-compilation.md), see [CRT Library Features](../../c-runtime-library/crt-library-features.md). -All modules passed to a given invocation of the linker must have been compiled with the same run-time library compiler option (**/MD**, **/MT**, **/LD**). +All modules passed to a given invocation of the linker must have been compiled with the same runtime library compiler option (**/MD**, **/MT**, **/LD**). -For more information about how to use the debug versions of the run-time libraries, see [C Run-Time Library Reference](../../c-runtime-library/c-run-time-library-reference.md). +For more information about how to use the debug versions of the runtime libraries, see [C runtime Library Reference](../../c-runtime-library/c-run-time-library-reference.md). For more about DLLs, see [Create C/C++ DLLs in Visual Studio](../dlls-in-visual-cpp.md). ### To set this compiler option in the Visual Studio development environment 1. Open the project's **Property Pages** dialog box. For details, see [Set C++ compiler and build properties in Visual Studio](../working-with-project-properties.md). - 1. Select the **Configuration Properties** > **C/C++** > **Code Generation** property page. - 1. Modify the **Runtime Library** property. ### To set this compiler option programmatically @@ -51,5 +48,6 @@ For more about DLLs, see [Create C/C++ DLLs in Visual Studio](../dlls-in-visual- ## See also -[MSVC Compiler Options](compiler-options.md)
-[MSVC Compiler Command-Line Syntax](compiler-command-line-syntax.md) +[MSVC Compiler Options](compiler-options.md)\ +[MSVC Compiler Command-Line Syntax](compiler-command-line-syntax.md)\ +[The Great C Runtime (CRT) Refactoring](https://devblogs.microsoft.com/cppblog/the-great-c-runtime-crt-refactoring/) \ No newline at end of file diff --git a/docs/build/reference/media/create-project.png b/docs/build/reference/media/create-project.png new file mode 100644 index 00000000000..e3398e80f7d Binary files /dev/null and b/docs/build/reference/media/create-project.png differ diff --git a/docs/build/reference/media/file-new-project.png b/docs/build/reference/media/file-new-project.png new file mode 100644 index 00000000000..d42284e46a5 Binary files /dev/null and b/docs/build/reference/media/file-new-project.png differ diff --git a/docs/build/reference/microsoft-extensions-to-c-and-cpp.md b/docs/build/reference/microsoft-extensions-to-c-and-cpp.md index 77eceff58eb..57eab588697 100644 --- a/docs/build/reference/microsoft-extensions-to-c-and-cpp.md +++ b/docs/build/reference/microsoft-extensions-to-c-and-cpp.md @@ -6,7 +6,7 @@ helpviewer_keywords: ["or_eq operator", "~ operator, extensions to C/C++", "& op --- # Microsoft extensions to C and C++ -Microsoft Visual C++ (MSVC) extends the C and C++ language standards in several ways, detailed in this article. +Microsoft C++ (MSVC) extends the C and C++ language standards in several ways, detailed in this article. The MSVC C++ compiler defaults to support for ISO C++14 with some ISO C++17 features and some Microsoft-specific language extensions. For more information on supported features, see [Microsoft C/C++ language conformance by Visual Studio version](../../overview/visual-cpp-language-conformance.md). You can use the **`/std`** compiler option to enable full support for ISO C++17 and ISO C++20 language features. For more information, see [`/std` (Specify language standard version)](std-specify-language-standard-version.md). diff --git a/docs/build/reference/midl-property-pages.md b/docs/build/reference/midl-property-pages.md index 66c3955c39a..24a198a8284 100644 --- a/docs/build/reference/midl-property-pages.md +++ b/docs/build/reference/midl-property-pages.md @@ -1,9 +1,8 @@ --- -description: "Learn more about: MIDL Property Pages" title: "MIDL Compiler Property Pages" -ms.date: "07/24/2019" +description: "Learn more about: MIDL Property Pages" +ms.date: 07/24/2019 ms.topic: "article" -ms.assetid: 57498a01-fccc-4a0e-a036-6ff702f83126 f1_keywords: - VC.Project.VCMidlTool.PreprocessorDefinitions - VC.Project.VCMidlTool.AdditionalIncludeDirectories @@ -112,6 +111,9 @@ Specifies the default character type of the C compiler that will be used to comp Specifies which environment to target ([/env](/windows/win32/midl/-env) arm32|win32|ia64|x64). +> [!NOTE] +> Starting with Visual Studio 2026, the **`/env:arm32`** option is deprecated and removed. If you need to target ARM32, use the Visual Studio 2022 v143 build tools. + **Choices** - **Not Set** - Win32 @@ -123,7 +125,7 @@ Specifies which environment to target ([/env](/windows/win32/midl/-env) arm32|wi ### Generate Stubless Proxies -Generate fully interpreted stubs with extensions and stubless proxies for object interfaces ([/Oicf](/windows/win32/midl/-oi), [/Oif](/windows/win32/midl/-oi) ). +Generate fully interpreted stubs with extensions and stubless proxies for object interfaces ([/Oicf](/windows/win32/midl/-oi), [/Oif](/windows/win32/midl/-oi)). ### Suppress Compiler Warnings diff --git a/docs/build/reference/module-exportheader.md b/docs/build/reference/module-exportheader.md index 5c1b8a839c3..f4f558ca283 100644 --- a/docs/build/reference/module-exportheader.md +++ b/docs/build/reference/module-exportheader.md @@ -19,7 +19,7 @@ Tells the compiler to create the header units specified by the input arguments. ### Arguments -The argument to `/exportHeader` is a `/headerName` command-line option that specifies the name, *`header-name`*, of the header file to export. +The argument to `/exportHeader` is a `/headerName` command-line option that specifies the name, *`header-name`*, of the header file to export. ## Remarks diff --git a/docs/build/reference/msbuild-reference-cpp.md b/docs/build/reference/msbuild-reference-cpp.md index e779a699b25..bbc889a922d 100644 --- a/docs/build/reference/msbuild-reference-cpp.md +++ b/docs/build/reference/msbuild-reference-cpp.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: MSBuild reference for C++ projects" title: "MSBuild reference for C++ projects in Visual Studio" -ms.date: "12/08/2018" +description: "Learn more about: MSBuild reference for C++ projects" +ms.date: 12/08/2018 helpviewer_keywords: ["MSBuild reference [C++]"] --- # MSBuild reference for C++ projects @@ -12,25 +12,25 @@ If for some reason you wish to use MSBuild directly from the command line, see [ ## In this section -[MSBuild internals for C++ projects](msbuild-visual-cpp-overview.md)
+[MSBuild internals for C++ projects](msbuild-visual-cpp-overview.md)\ Information about how properties and targets are stored and consumed. -[Common macros for build commands and properties](common-macros-for-build-commands-and-properties.md)
+[Common macros for build commands and properties](common-macros-for-build-commands-and-properties.md)\ Describes macros (compile-time constants) that can be used to define properties such as paths and product versions. -[File types created for C++ projects](file-types-created-for-visual-cpp-projects.md)
+[File types created for C++ projects](file-types-created-for-visual-cpp-projects.md)\ Describes the various kinds of files that Visual Studio creates for different project types. -[Visual Studio C++ project templates](visual-cpp-project-types.md)
+[Visual Studio C++ project templates](visual-cpp-project-types.md)\ Describes the MSBuild-based project types that are available for C++. -[C++ new item templates](using-visual-cpp-add-new-item-templates.md)
+[C++ new item templates](using-visual-cpp-add-new-item-templates.md)\ Describes source files and other items you can add to a Visual Studio project. -[Precompiled header files](../creating-precompiled-header-files.md) +[Precompiled header files](../creating-precompiled-header-files.md)\ How to use precompiled header files and how to create your own custom precompiled code to speed up build times. -[Visual Studio project property reference](property-pages-visual-cpp.md)
+[Visual Studio project property reference](property-pages-visual-cpp.md)\ Reference documentation for project properties that are set in the Visual Studio IDE. ## See also diff --git a/docs/build/reference/msbuild-visual-cpp-overview.md b/docs/build/reference/msbuild-visual-cpp-overview.md index e614f2f98a6..7ea809fa747 100644 --- a/docs/build/reference/msbuild-visual-cpp-overview.md +++ b/docs/build/reference/msbuild-visual-cpp-overview.md @@ -84,7 +84,7 @@ To use MSBuild effectively, it helps to know which properties and targets are us ### `PlatformToolset` property -The `PlatformToolset` property determines which MSVC toolset is used in the build. By default, the current toolset is used. When this property is set, its value gets concatenated with literal strings to form the path. It's the directory that contains the property and target files required to build a project for a particular platform. The platform toolset must be installed to build by using that platform toolset version. +The `PlatformToolset` property determines which Microsoft C++ (MSVC) toolset is used in the build. By default, the current toolset is used. When this property is set, its value gets concatenated with literal strings to form the path. It's the directory that contains the property and target files required to build a project for a particular platform. The platform toolset must be installed to build by using that platform toolset version. For example, set the `PlatformToolset` property to `v140` to use Visual Studio 2015 tools and libraries to build your application: diff --git a/docs/build/reference/nodefaultlib-ignore-libraries.md b/docs/build/reference/nodefaultlib-ignore-libraries.md index ba4c2438a9e..646e515a1e3 100644 --- a/docs/build/reference/nodefaultlib-ignore-libraries.md +++ b/docs/build/reference/nodefaultlib-ignore-libraries.md @@ -1,14 +1,13 @@ --- description: "Learn more about: /NODEFAULTLIB (Ignore libraries)" title: "/NODEFAULTLIB (Ignore libraries)" -ms.date: 09/09/2022 +ms.date: 04/16/2025 f1_keywords: ["VC.Project.VCLinkerTool.IgnoreAllDefaultLibraries", "VC.Project.VCLinkerTool.IgnoreDefaultLibraryNames", "VC.Project.VCLinkerTool.OVERWRITEAllDefaultLibraries", "VC.Project.VCLinkerTool.OVERWRITEDefaultLibraryNames", "/nodefaultlib"] helpviewer_keywords: ["default libraries, removing", "-NODEFAULTLIB linker option", "libraries, ignore", "NODEFAULTLIB linker option", "/NODEFAULTLIB linker option", "ignore libraries linker option"] -ms.assetid: 7270b673-6711-468e-97a7-c2925ac2be6e --- # `/NODEFAULTLIB` (Ignore Libraries) -The **`/NODEFAULTLIB`** linker option tells the linker to remove one or more default libraries from the list of libraries it searches when it resolves external references. +Unless an optional library name is provided, the `/NODEFAULTLIB` linker option removes all libraries not explicitly specified on the linker command-line. This also includes `#pragma`, `cl.exe` command-line switches, libs referenced by other libs, and so on. ## Syntax @@ -34,11 +33,8 @@ If you use **`/NODEFAULTLIB`** to build your program without the C run-time libr ### To set this linker option in the Visual Studio development environment 1. Open the project's **Property Pages** dialog box. For more information, see [Set compiler and build properties](../working-with-project-properties.md). - 1. Select the **Configuration Properties** > **Linker** > **Input** property page. - 1. Modify the **Ignore All Default Libraries** property. Or, specify a semicolon-separated list of the libraries you want to ignore in the **Ignore Specific Default Libraries** property. The **Linker** > **Command Line** property page shows the effect of the changes you make to these properties. - 1. Choose **OK** or **Apply** to save your changes. ### To set this linker option programmatically diff --git a/docs/build/reference/nologo-suppress-startup-banner-c-cpp.md b/docs/build/reference/nologo-suppress-startup-banner-c-cpp.md index df6bf589671..d4dce169d76 100644 --- a/docs/build/reference/nologo-suppress-startup-banner-c-cpp.md +++ b/docs/build/reference/nologo-suppress-startup-banner-c-cpp.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: /nologo (Suppress Startup Banner) (C/C++)" title: "/nologo (Suppress Startup Banner) (C/C++)" -ms.date: "11/04/2016" +description: "Learn more about: /nologo (Suppress Startup Banner) (C/C++)" +ms.date: 11/04/2016 f1_keywords: ["VC.Project.VCCLWCECompilerTool.SuppressStartupBanner", "VC.Project.VCCLCompilerTool.SuppressStartupBanner"] helpviewer_keywords: ["-nologo compiler option [C++]", "/nologo compiler option [C++]", "nologo compiler option [C++]", "banners, suppressing startup"] -ms.assetid: 75930d8b-b11c-4db8-99e5-b52f97da0693 --- # /nologo (Suppress Startup Banner) (C/C++) @@ -16,8 +15,6 @@ Suppresses the display of the copyright banner when the compiler starts up and d /nologo ``` -## Remarks - ### To set this compiler option in the Visual Studio development environment 1. Open the project's **Property Pages** dialog box. For details, see [Set C++ compiler and build properties in Visual Studio](../working-with-project-properties.md). diff --git a/docs/build/reference/oi-generate-intrinsic-functions.md b/docs/build/reference/oi-generate-intrinsic-functions.md index 7eb1b3e971b..6903538cac1 100644 --- a/docs/build/reference/oi-generate-intrinsic-functions.md +++ b/docs/build/reference/oi-generate-intrinsic-functions.md @@ -4,7 +4,6 @@ title: "/Oi (Generate Intrinsic Functions)" ms.date: "11/04/2016" f1_keywords: ["VC.Project.VCCLCompilerTool.EnableIntrinsicFunctions", "/oi", "VC.Project.VCCLWCECompilerTool.EnableIntrinsicFunctions"] helpviewer_keywords: ["Oi compiler option [C++]", "intrinsic functions, generate", "/Oi compiler option [C++]", "-Oi compiler option [C++]", "generate intrinsic functions compiler option [C++]"] -ms.assetid: fa4a3bf6-0ed8-481b-91c0-add7636132b4 --- # /Oi (Generate Intrinsic Functions) @@ -18,37 +17,34 @@ Replaces some function calls with intrinsic or otherwise special forms of the fu ## Remarks -Programs that use intrinsic functions are faster because they do not have the overhead of function calls, but may be larger because of the additional code created. +Programs that use intrinsic functions are faster because they don't have the overhead of function calls but may be larger because of the extra code created. -See [intrinsic](../../preprocessor/intrinsic.md) for more information on which functions have intrinsic forms. +For more information about which functions have intrinsic forms, see [intrinsic](../../preprocessor/intrinsic.md). -**/Oi** is only a request to the compiler to replace some function calls with intrinsics; the compiler may call the function (and not replace the function call with an intrinsic) if it will result in better performance. +**/Oi** is only a request to the compiler to replace some function calls with intrinsics. The compiler may call the function (and not replace the function call with an intrinsic) if it results in better performance.\ +**/Oi-** turns off this behavior, which may be useful if `/Oi` has been specified elsewhere and you want to override it. -**x86 Specific** +You can use [intrinsic](../../preprocessor/intrinsic.md) to create intrinsic functions, or [function (C/C++)](../../preprocessor/function-c-cpp.md) to explicitly force a function call. -The intrinsic floating-point functions do not perform any special checks on input values and so work in restricted ranges of input, and have different exception handling and boundary conditions than the library routines with the same name. Using the true intrinsic forms implies loss of IEEE exception handling, and loss of `_matherr` and `errno` functionality; the latter implies loss of ANSI conformance. However, the intrinsic forms can considerably speed up floating-point-intensive programs, and for many programs, the conformance issues are of little practical value. +### x86-specific remarks -You can use the [Za](za-ze-disable-language-extensions.md) compiler option to override generation of true intrinsic floating-point options. In this case, the functions are generated as library routines that pass arguments directly to the floating-point chip instead of pushing them onto the program stack. +The intrinsic floating-point functions don't perform any special checks on input values and so work in restricted ranges of input, and have different exception handling and boundary conditions than the library routines with the same name. Using the true intrinsic forms implies loss of IEEE exception handling, and loss of `_matherr` and `errno` functionality; the latter implies loss of ANSI conformance. However, the intrinsic forms can considerably speed up floating-point-intensive programs, and for many programs, the conformance issues are of little practical value. -**END x86 Specific** +You can use the [`Za`](za-ze-disable-language-extensions.md) compiler option to override generation of true intrinsic floating-point options. In this case, the functions are generated as library routines that pass arguments directly to the floating-point chip instead of pushing them onto the program stack. -You also use [intrinsic](../../preprocessor/intrinsic.md) to create intrinsic functions, or [function (C/C++)](../../preprocessor/function-c-cpp.md) to explicitly force a function call. - -### To set this compiler option in the Visual Studio development environment +## To set this compiler option in the Visual Studio development environment 1. Open the project's **Property Pages** dialog box. For details, see [Set C++ compiler and build properties in Visual Studio](../working-with-project-properties.md). - 1. Select the **Configuration Properties** > **C/C++** > **Optimization** property page. - 1. Modify the **Enable Intrinsic Functions** property. -### To set this compiler option programmatically +## To set this compiler option programmatically - See . ## See also -[/O Options (Optimize Code)](o-options-optimize-code.md)
-[MSVC Compiler Options](compiler-options.md)
-[MSVC Compiler Command-Line Syntax](compiler-command-line-syntax.md)
+[/O Options (Optimize Code)](o-options-optimize-code.md)\ +[MSVC Compiler Options](compiler-options.md)\ +[MSVC Compiler Command-Line Syntax](compiler-command-line-syntax.md)\ [Compiler Intrinsics](../../intrinsics/compiler-intrinsics.md) diff --git a/docs/build/reference/out-output-file-name.md b/docs/build/reference/out-output-file-name.md index f43bb724dc7..f671586c63d 100644 --- a/docs/build/reference/out-output-file-name.md +++ b/docs/build/reference/out-output-file-name.md @@ -1,29 +1,26 @@ --- description: "Learn more about: /OUT (Output File Name)" title: "/OUT (Output File Name)" -ms.date: "11/04/2016" +ms.date: 03/24/2025 f1_keywords: ["VC.Project.VCLinkerTool.OutputFile", "/out"] helpviewer_keywords: ["output files, name linker option", "-OUT linker option", "OUT linker option", "/OUT C++ linker option", "linker [C++], output files"] -ms.assetid: 976210a4-e51f-4cfb-af5e-c16344455834 --- # /OUT (Output File Name) -``` -/OUT:filename -``` +> /OUT:filename ## Arguments -*filename*
-A user-specified name for the output file. It replaces the default name. +*`filename`*\ +A user-specified name for the output file. It replaces the default name. When expanded, the fully qualified filename must not exceed `MAX_PATH` (260 characters). ## Remarks -The /OUT option overrides the default name and location of the program that the linker creates. +The `/OUT` option overrides the default name and location of the program that the linker creates. -By default, the linker forms the file name using the base name of the first .obj file specified and the appropriate extension (.exe or .dll). +By default, the linker forms the file name using the base name of the first `.obj` file specified and the appropriate extension (`.exe` or `.dll`). -This option the default base name for a .mapfile or import library. For details, see [Generate Mapfile](map-generate-mapfile.md) (/MAP) and [/IMPLIB](implib-name-import-library.md). +This option the default base name for a `.mapfile` or import library. For details, see [Generate Mapfile](map-generate-mapfile.md) (`/MAP`) and [/IMPLIB](implib-name-import-library.md). ### To set this linker option in the Visual Studio development environment @@ -39,5 +36,5 @@ This option the default base name for a .mapfile or import library. For details, ## See also -[MSVC linker reference](linking.md)
+[MSVC linker reference](linking.md)\ [MSVC Linker Options](linker-options.md) diff --git a/docs/build/reference/output-file-f-options.md b/docs/build/reference/output-file-f-options.md index 601eba50f41..da20a94a487 100644 --- a/docs/build/reference/output-file-f-options.md +++ b/docs/build/reference/output-file-f-options.md @@ -1,37 +1,40 @@ --- +title: "Output-File (/F) Options" description: "Learn more about: Output-File (/F) Options" -title: "Output-File (-F) Options" -ms.date: "11/04/2016" +ms.date: 11/04/2016 helpviewer_keywords: ["output files", "output files, compiler options [C++]", "cl.exe compiler, output files"] -ms.assetid: f6367f30-2710-4178-b43a-639eed824acb --- -# Output-File (/F) Options +# Output-File (`/F`) Options The output-file options create or rename output files. They affect all C or C++ source files specified in the CL environment variable, on the command line, or in any command file. -- [/FA, /Fa (Listing File)](fa-fa-listing-file.md) +- [`/FA`, `/Fa` (Listing File)](fa-fa-listing-file.md) - [Specifying the Pathname](specifying-the-pathname.md) -- [/Fd (Name PDB File)](fd-program-database-file-name.md) +- [`/FD` (IDE Minimal Rebuild)](fd-ide-minimal-rebuild.md) -- [/Fe (Name EXE File)](fe-name-exe-file.md) +- [`/Fd` (Name PDB File)](fd-program-database-file-name.md) -- [/FI (Name Forced Include File)](fi-name-forced-include-file.md) +- [`/Fe` (Name EXE File)](fe-name-exe-file.md) -- [/Fm (Name Mapfile)](fm-name-mapfile.md) +- [`/Fi` (Preprocess output file name)](fi-preprocess-output-file-name.md) -- [/Fo (Name Object File)](fo-object-file-name.md) +- [`/FI` (Name Forced Include File)](fi-name-forced-include-file.md) -- [/Fp (Name .pch File)](fp-name-dot-pch-file.md) +- [`/Fm` (Name Mapfile)](fm-name-mapfile.md) -- [/FR, /Fr (Create .sbr File)](fr-fr-create-dot-sbr-file.md) +- [`/Fo` (Name Object File)](fo-object-file-name.md) -- [/FU (Name Forced #using File)](fu-name-forced-hash-using-file.md) +- [`/Fp` (Name .pch File)](fp-name-dot-pch-file.md) -- [/Fx (Merge Injected Code)](fx-merge-injected-code.md) +- [`/FR`, `/Fr` (Create .sbr File)](fr-fr-create-dot-sbr-file.md) + +- [`/FU` (Name Forced #using File)](fu-name-forced-hash-using-file.md) + +- [`/Fx` (Merge Injected Code)](fx-merge-injected-code.md) ## See also -[MSVC Compiler Options](compiler-options.md)
+[MSVC Compiler Options](compiler-options.md)\ [MSVC Compiler Command-Line Syntax](compiler-command-line-syntax.md) diff --git a/docs/build/reference/p-preprocess-to-a-file.md b/docs/build/reference/p-preprocess-to-a-file.md index e65e5a00d03..3f8c51279bc 100644 --- a/docs/build/reference/p-preprocess-to-a-file.md +++ b/docs/build/reference/p-preprocess-to-a-file.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: /P (Preprocess to a File)" title: "/P (Preprocess to a File)" -ms.date: "11/04/2016" +description: "Learn more about: /P (Preprocess to a File)" +ms.date: 11/04/2016 f1_keywords: ["VC.Project.VCCLCompilerTool.GeneratePreprocessedFile", "/p", "VC.Project.VCCLWCECompilerTool.GeneratePreprocessedFile"] helpviewer_keywords: ["/P compiler option [C++]", "-P compiler option [C++]", "P compiler option [C++]", "output files, preprocessor", "preprocessing output files"] -ms.assetid: 123ee54f-8219-4a6f-9876-4227023d83fc --- # /P (Preprocess to a File) @@ -40,7 +39,7 @@ The **/P** option suppresses compilation. It does not produce an .obj file, even The following command line preprocesses `ADD.C`, preserves comments, adds `#line` directives, and writes the result to a file, `ADD.I`: -``` +```cmd CL /P /C ADD.C ``` diff --git a/docs/build/reference/pdb-use-program-database.md b/docs/build/reference/pdb-use-program-database.md index 3801076b0d2..9d61dad7b18 100644 --- a/docs/build/reference/pdb-use-program-database.md +++ b/docs/build/reference/pdb-use-program-database.md @@ -1,38 +1,37 @@ --- -description: "Learn more about: /PDB (Use Program Database)" title: "/PDB (Use Program Database)" -ms.date: "11/04/2016" +description: "Learn more about: /PDB (Use Program Database)" +ms.date: 03/24/2025 f1_keywords: ["/pdb", "VC.Project.VCLinkerTool.ProgramDatabaseFile"] helpviewer_keywords: ["-PDB linker option", "/PDB linker option", "PDB linker option", "PDB files, creating", ".pdb files, creating"] -ms.assetid: d23db0ce-10cb-427a-bc60-d6b2a852723d --- # /PDB (Use Program Database) -``` -/PDB:filename -``` +Specify the name of the program database (PDB) file that the linker creates. + +## Syntax + +> /PDB:filename ## Arguments -*filename*
-A user-specified name for the program database (PDB) that the linker creates. It replaces the default name. +*`filename`*\ +A user-specified name for the program database (PDB) that the linker creates. It replaces the default name. When expanded, the fully qualified filename must not exceed `MAX_PATH` (260 characters). ## Remarks -By default, when [/DEBUG](debug-generate-debug-info.md) is specified, the linker creates a program database (PDB) which holds debugging information. The default file name for the PDB has the base name of the program and the extension .pdb. +By default, when [`/DEBUG`](debug-generate-debug-info.md) is specified, the linker creates a program database (PDB) which holds debugging information. The default file name for the PDB has the base name of the program and the extension .pdb. -Use /PDB:*filename* to specify the name of the PDB file. If /DEBUG is not specified, the /PDB option is ignored. +Use `/PDB:`*`filename`* to specify the name of the PDB file. If `/DEBUG` is not specified, the `/PDB` option is ignored. -A PDB file can be up to 2GB. +A PDB file can be up to 2GB in size. For more information, see [.pdb Files as Linker Input](dot-pdb-files-as-linker-input.md). ### To set this linker option in the Visual Studio development environment 1. Open the project's **Property Pages** dialog box. For details, see [Set C++ compiler and build properties in Visual Studio](../working-with-project-properties.md). - 1. Select the **Configuration Properties** > **Linker** > **Debug** property page. - 1. Modify the **Generate Program Database File** property. ### To set this linker option programmatically @@ -41,5 +40,5 @@ For more information, see [.pdb Files as Linker Input](dot-pdb-files-as-linker-i ## See also -[MSVC linker reference](linking.md)
+[MSVC linker reference](linking.md)\ [MSVC Linker Options](linker-options.md) diff --git a/docs/build/reference/pdbaltpath-use-alternate-pdb-path.md b/docs/build/reference/pdbaltpath-use-alternate-pdb-path.md index 654278e5378..6c198f78155 100644 --- a/docs/build/reference/pdbaltpath-use-alternate-pdb-path.md +++ b/docs/build/reference/pdbaltpath-use-alternate-pdb-path.md @@ -1,29 +1,30 @@ --- description: "Learn more about: /PDBALTPATH (Use Alternate PDB Path)" title: "/PDBALTPATH (Use Alternate PDB Path)" -ms.date: "11/04/2016" +ms.date: 03/24/2025 f1_keywords: ["/pdbaltpath"] helpviewer_keywords: [".pdb files, path", "PDBALTPATH dumpbin option", "-PDBALTPATH dumpbin option", "/PDBALTPATH dumpbin option", "PDB files, path"] -ms.assetid: 72e200aa-e2c3-4ad8-b687-25528da1aaaf --- # /PDBALTPATH (Use Alternate PDB Path) -``` -/PDBALTPATH:pdb_file_name -``` +Provide an alternate location for the Program Database (`.pdb`) file in a compiled binary file. + +## Syntax + +> /PDBALTPATH:pdb_file_name ## Arguments -*pdb_file_name*
-The path and file name for the .pdb file. +*`pdb_file_name`*\ +The path and filename for the `.pdb` file. The path may exceed `MAX_PATH` (260 characters). The filename (not including the path) must not exceed `MAX_PATH`. ## Remarks -Use this option to provide an alternate location for the Program Database (.pdb) file in a compiled binary file. Normally, the linker records the location of the .pdb file in the binaries that it produces. You can use this option to provide a different path and file name for the .pdb file. The information provided with /PDBALTPATH does not change the location or name of the actual .pdb file; it changes the information that the linker writes in the binary file. This enables you to provide a path that is independent of the file structure of the build computer. Two common uses for this option are to provide a network path or a file that has no path information. +Use this option to provide an alternate location for the Program Database (`.pdb`) file in a compiled binary file. Normally, the linker records the location of the `.pdb` file in the binaries that it produces. You can use this option to provide a different path and file name for the `.pdb` file. The information provided with `/PDBALTPATH` does not change the location or name of the actual `.pdb` file; it changes the information that the linker writes in the binary file. This enables you to provide a path that is independent of the file structure of the build computer. Two common uses for this option are to provide a network path or a file that has no path information. -The value of *pdb_file_name* can be an arbitrary string, an environment variable, or **%_PDB%**. The linker will expand an environment variable, such as **%SystemRoot%**, to its value. The linker defines the environment variables **%_PDB%** and **%_EXT%**. **%_PDB%** expands to the file name of the actual .pdb file without any path information and **%_EXT%** is the extension of the generated executable. +The value of *`pdb_file_name`* can be an arbitrary string, an environment variable, or `%_PDB%`. The linker will expand an environment variable, such as `%SystemRoot%`, to its value. The linker defines the environment variables `%_PDB%` and `%_EXT%`. `%_PDB%` expands to the file name of the actual `.pdb` file without any path information and `%_EXT%` is the extension of the generated executable. ## See also -[DUMPBIN Options](dumpbin-options.md)
-[/PDBPATH](pdbpath.md) +[DUMPBIN Options](dumpbin-options.md)\ +[`/PDBPATH`](pdbpath.md) diff --git a/docs/build/reference/pgd-specify-database-for-profile-guided-optimizations.md b/docs/build/reference/pgd-specify-database-for-profile-guided-optimizations.md index 219bd6b0231..746755ec18f 100644 --- a/docs/build/reference/pgd-specify-database-for-profile-guided-optimizations.md +++ b/docs/build/reference/pgd-specify-database-for-profile-guided-optimizations.md @@ -1,14 +1,13 @@ --- -description: "Learn more about: /PGD (Specify Database for Profile-Guided Optimizations)" title: "/PGD (Specify Database for Profile-Guided Optimizations)" -ms.date: "03/14/2018" +description: "Learn more about: /PGD (Specify Database for Profile-Guided Optimizations)" +ms.date: 03/24/2025 f1_keywords: ["VC.Project.VCLinkerTool.ProfileGuidedDatabase"] helpviewer_keywords: ["-PGD linker option", "/PGD linker option"] -ms.assetid: 9f312498-493b-461f-886f-92652257e443 --- # /PGD (Specify Database for Profile-Guided Optimizations) -**The /PGD option is deprecated.** Starting in Visual Studio 2015, prefer the [/GENPROFILE or /FASTGENPROFILE](genprofile-fastgenprofile-generate-profiling-instrumented-build.md) linker options instead. This option is used to specify the name of the .pgd file used by the profile-guided optimization process. +**The /PGD option is deprecated.** Starting in Visual Studio 2015, prefer the [`/GENPROFILE` or `/FASTGENPROFILE`](genprofile-fastgenprofile-generate-profiling-instrumented-build.md) linker options instead. This option is used to specify the name of the .pgd file used by the profile-guided optimization process. ## Syntax @@ -16,14 +15,14 @@ ms.assetid: 9f312498-493b-461f-886f-92652257e443 ## Argument -*filename*
-Specifies the name of the .pgd file that is used to hold information about the running program. +`filename`\ +Specifies the name of the `.pgd` file that is used to hold information about the running program. When expanded, the fully qualified filename must not exceed `MAX_PATH` (260 characters). ## Remarks -When using the deprecated [/LTCG:PGINSTRUMENT](ltcg-link-time-code-generation.md) option, use **/PGD** to specify a nondefault name or location for the .pgd file. If you do not specify **/PGD**, the .pgd file base name is the same as the output file (.exe or .dll) base name and is created in the same directory from which the link was invoked. +When using the deprecated [`/LTCG:PGINSTRUMENT`](ltcg-link-time-code-generation.md) option, use **`/PGD`** to specify a nondefault name or location for the `.pgd` file. If you don't specify **`/PGD`**, the `.pgd` file base name is the same as the output file (`.exe` or `.dll`) base name and is created in the same directory from which the link was invoked. -When using the deprecated **/LTCG:PGOPTIMIZE** option, use the **/PGD** option to specify the name of the .pgd file to use to create the optimized image. The *filename* argument should match the *filename* specified to **/LTCG:PGINSTRUMENT**. +When using the deprecated **`/LTCG:PGOPTIMIZE`** option, use the **`/PGD`** option to specify the name of the `.pgd` file to use to create the optimized image. The *`filename`* argument should match the *`filename`* specified to **`/LTCG:PGINSTRUMENT`**. For more information, see [Profile-Guided Optimizations](../profile-guided-optimizations.md). @@ -41,5 +40,5 @@ For more information, see [Profile-Guided Optimizations](../profile-guided-optim ## See also -[MSVC linker reference](linking.md)
-[MSVC Linker Options](linker-options.md)
+[MSVC linker reference](linking.md)\ +[MSVC Linker Options](linker-options.md) diff --git a/docs/build/reference/profile-performance-tools-profiler.md b/docs/build/reference/profile-performance-tools-profiler.md index d1273f084d1..bff93bcfd78 100644 --- a/docs/build/reference/profile-performance-tools-profiler.md +++ b/docs/build/reference/profile-performance-tools-profiler.md @@ -1,6 +1,6 @@ --- -description: "Learn more about: /PROFILE (Performance Tools Profiler)" title: "/PROFILE (Performance Tools Profiler)" +description: "Learn more about: /PROFILE (Performance Tools Profiler)" ms.date: 10/13/2021 f1_keywords: ["VC.Project.VCLinkerTool.Profile"] helpviewer_keywords: ["-PROFILE linker option", "/PROFILE linker option"] @@ -57,7 +57,7 @@ Because a **CMake** project doesn't have the usual **Property Pages** support, t 1. Rebuild your solution. -## See Also +## See also [MSVC linker reference](linking.md)\ [MSVC linker options](linker-options.md) diff --git a/docs/build/reference/property-page-xml-files.md b/docs/build/reference/property-page-xml-files.md index b7d32df9fbf..7ed46f8cc98 100644 --- a/docs/build/reference/property-page-xml-files.md +++ b/docs/build/reference/property-page-xml-files.md @@ -128,7 +128,7 @@ A **``** element is the root node in the XML file. It can have many attrib - `Label=""` indicates that when the properties are written as `ItemDefinition` metadata, the label of the parent ItemDefinitionGroup will be empty (every MSBuild element can have a Label). Visual Studio 2017 and later use labeled groups to navigate the .vcxproj project file. The groups that contain most `Rule` properties have an empty string as a label. - - `HasConfigurationCondition="true"` tells the project system to affix a configuration condition to the value so that it takes effect only for the current project configuration (the condition could be affixed to the parent group or the value itself). For example, open the property pages off the project node and set the value of the property **Treat Warnings As Error** under **Configuration Properties > C/C++ General** to "Yes". The following value is written to the project file. Notice the configuration condition attached to the parent ItemDefinitionGroup. + - `HasConfigurationCondition="true"` tells the project system to affix a configuration condition to the value so that it takes effect only for the current project configuration (the condition could be affixed to the parent group or the value itself). For example, open the property pages off the project node and set the value of the property **Treat Warnings As Error** under **Configuration Properties > C/C++ General** to "Yes". The following value is written to the project file. Notice the configuration condition attached to the parent ItemDefinitionGroup. ```xml diff --git a/docs/build/reference/qspectre.md b/docs/build/reference/qspectre.md index 67dfb19bb48..2eace5222a8 100644 --- a/docs/build/reference/qspectre.md +++ b/docs/build/reference/qspectre.md @@ -1,11 +1,11 @@ --- -description: "Learn more about: /Qspectre" title: "/Qspectre" +description: "Learn more about: /Qspectre" ms.date: 07/02/2021 f1_keywords: ["VC.Project.VCCLCompilerTool.SpectreMitigation"] helpviewer_keywords: ["/Qspectre"] --- -# /Qspectre +# `/Qspectre` Specifies compiler generation of instructions to mitigate certain Spectre variant 1 security vulnerabilities. @@ -38,7 +38,7 @@ If your code operates on data that crosses a trust boundary, then we recommend y The **`/Qspectre`** option is available starting in Visual Studio 2017 version 15.5.5, and in all updates to Microsoft C/C++ compilers (MSVC) made on or after January 23, 2018. Use the Visual Studio Installer to update the compiler, and to install the Spectre-mitigated libraries as individual components. The **`/Qspectre`** option is also available in Visual Studio 2015 Update 3 through a patch. For more information, see [KB 4338871](https://support.microsoft.com/help/4338871). -All versions of Visual Studio 2017 version 15.5, and all Previews of Visual Studio 2017 version 15.6. include an undocumented option, **/`d2guardspecload`**. It's equivalent to the initial behavior of **`/Qspectre`**. You can use **`/d2guardspecload`** to apply the same mitigations to your code in these versions of the compiler. We recommend you update your build to use **`/Qspectre`** in compilers that support the option. The **`/Qspectre`** option may also support new mitigations in later versions of the compiler. +All versions of Visual Studio 2017 version 15.5, and all Previews of Visual Studio 2017 version 15.6. include an undocumented option, **`/d2guardspecload`**. It's equivalent to the initial behavior of **`/Qspectre`**. You can use **`/d2guardspecload`** to apply the same mitigations to your code in these versions of the compiler. We recommend you update your build to use **`/Qspectre`** in compilers that support the option. The **`/Qspectre`** option may also support new mitigations in later versions of the compiler. ### Effect diff --git a/docs/build/reference/return-value-of-cl-exe.md b/docs/build/reference/return-value-of-cl-exe.md index ceb9ff7972d..26806b0ec0c 100644 --- a/docs/build/reference/return-value-of-cl-exe.md +++ b/docs/build/reference/return-value-of-cl-exe.md @@ -1,9 +1,8 @@ --- -description: "Learn more about: Return Value of cl.exe" title: "Return Value of cl.exe" -ms.date: "09/05/2018" +description: "Learn more about: Return Value of cl.exe" +ms.date: 09/05/2018 helpviewer_keywords: ["cl.exe compiler, return value"] -ms.assetid: 7c2d7f33-ee0d-4199-8ef4-75fe2b007670 --- # Return Value of cl.exe @@ -13,7 +12,7 @@ The return value of cl.exe can be useful if you are compiling from a script, pow There are too many possible error exit codes for cl.exe to list them all. You can look up an error code in the winerror.h or ntstatus.h files included in the Windows Software Development Kit in the %ProgramFiles(x86)%\Windows Kits\\version\Include\shared\ directory. Error codes returned in decimal must be converted to hexadecimal for search. For example, an error code of -1073741620 converted to hexadecimal is 0xC00000CC. This error is found in ntstatus.h, where the corresponding message is "The specified share name cannot be found on the remote server." For a downloadable list of Windows error codes, see [`[MS-ERREF]` Windows Error Codes](/openspecs/windows_protocols/MS-ERREF). -You can also use the error lookup utility in Visual Studio to find out what a compiler error message means. In a Visual Studio command shell, enter **errlook.exe** to start the utility; or in the Visual Studio IDE, on the menu bar, choose **Tools**, **Error Lookup**. Enter the error value to find the descriptive text associated with the error. For more information see [ERRLOOK Reference](errlook-reference.md). +You can also use the error lookup utility in Visual Studio to find out what a compiler error message means. In a Visual Studio command shell, enter **errlook.exe** to start the utility; or in the Visual Studio IDE, on the menu bar, choose **Tools**, **Error Lookup**. Enter the error value to find the descriptive text associated with the error. For more information, see [ERRLOOK Reference](errlook-reference.md). ## Remarks diff --git a/docs/build/reference/rtc-run-time-error-checks.md b/docs/build/reference/rtc-run-time-error-checks.md index 265e61d945e..0bff5139a6e 100644 --- a/docs/build/reference/rtc-run-time-error-checks.md +++ b/docs/build/reference/rtc-run-time-error-checks.md @@ -42,7 +42,7 @@ int main() { } ``` -Because **`/RTCc`** rejects code that conforms to the standard, it's not supported by the C++ Standard Library. Code that uses **`/RTCc`** and the C++ Standard Library may cause compiler error [C1189](../../error-messages/compiler-errors-1/fatal-error-c1189.md). You can define `_ALLOW_RTCc_IN_STL` to silence the warning and use the **`/RTCc`** option. +Because **`/RTCc`** rejects code that conforms to the standard, it's not supported by the C++ Standard Library. Code that uses **`/RTCc`** and the C++ Standard Library may cause compiler error [C1189](../../error-messages/compiler-errors-1/fatal-error-c1189.md) or [C2338](../../error-messages/compiler-errors-1/compiler-error-c2338.md). Remove the **`/RTCc`** option to use the C++ Standard Library. **`/RTCs`**
Enables stack frame run-time error checking, as follows: diff --git a/docs/build/reference/running-nmake.md b/docs/build/reference/running-nmake.md index ad7fa7d7b79..e9633b59a9c 100644 --- a/docs/build/reference/running-nmake.md +++ b/docs/build/reference/running-nmake.md @@ -12,6 +12,8 @@ helpviewer_keywords: ["targets, building", "response files, NMAKE", "targets", " ## Remarks +NMAKE must run in a Developer Command Prompt window. A Developer Command Prompt window has the environment variables set for the tools, libraries, and include file paths required to build at the command line. For details on how to open a Developer Command Prompt window, see [Use the MSVC toolset from the command line](../building-on-the-command-line.md). + NMAKE builds only specified *targets* or, when none is specified, the first target in the makefile. The first makefile target can be a [pseudotarget](description-blocks.md#pseudotargets) that builds other targets. NMAKE uses makefiles specified with **`/F`**, or if **`/F`** isn't specified, the Makefile file in the current directory. If no makefile is specified, it uses inference rules to build command-line *targets*. The *command-file* text file (or response file) contains command-line input. Other input can precede or follow \@*command-file*. A path is permitted. In *command-file*, line breaks are treated as spaces. Enclose macro definitions in quotation marks if they contain spaces. diff --git a/docs/build/reference/sarif-output.md b/docs/build/reference/sarif-output.md index 3cbd7524764..29e608baa88 100644 --- a/docs/build/reference/sarif-output.md +++ b/docs/build/reference/sarif-output.md @@ -15,7 +15,7 @@ The MSVC compiler can be made to output diagnostics as [SARIF](https://sarifweb. There are two ways to make the MSVC compiler produce SARIF diagnostics: - Pass the `/experimental:log` switch on the command line. See the [documentation for `/experimental:log`](experimental-log.md) for details. -- Launch `cl.exe` programatically and set the `SARIF_OUTPUT_PIPE` environment variable to retrieve SARIF blocks through a pipe. +- Launch `cl.exe` programmatically and set the `SARIF_OUTPUT_PIPE` environment variable to retrieve SARIF blocks through a pipe. ## Retrieving SARIF through a pipe diff --git a/docs/build/reference/scandependencies.md b/docs/build/reference/scandependencies.md index 0bf2e54226b..d7a6f2f99c3 100644 --- a/docs/build/reference/scandependencies.md +++ b/docs/build/reference/scandependencies.md @@ -60,10 +60,8 @@ Consider the following sample code: #include import other.module; -import std.core; - +import std; import "t.h"; - import ; int main() {} @@ -83,14 +81,14 @@ The compiler produces a JSON file, *`output.json`*, with content similar to: { "primary-output": "app.obj", "outputs": [ - "C:\\Users\\username\\source\\repos\\app\\app" + "output.json" ], "requires": [ { "logical-name": "other.module" }, { - "logical-name": "std.core" + "logical-name": "std" }, { "logical-name": "t.h", @@ -134,6 +132,7 @@ To report module and header unit dependencies, you must also set the **Configura ## See also +[Import the C++ standard library using modules](../../cpp/tutorial-import-stl-named-module.md)\ [MSVC compiler options](compiler-options.md)\ [MSVC compiler command-line syntax](compiler-command-line-syntax.md)\ [`/sourceDependencies:directives`](sourcedependencies-directives.md)\ diff --git a/docs/build/reference/sourcedependencies-directives.md b/docs/build/reference/sourcedependencies-directives.md index 7f1e9efe388..25cfd5f1925 100644 --- a/docs/build/reference/sourcedependencies-directives.md +++ b/docs/build/reference/sourcedependencies-directives.md @@ -9,7 +9,7 @@ helpviewer_keywords: ["/sourceDependencies:directives compiler option", "/source --- # `/sourceDependencies:directives` (List module and header unit dependencies) -This command-line option scans source files and their `#include` statements to generate a JSON file that lists module export and imports. This information can be used by a build system to determine the build order of modules and header units. +This command-line option scans source files and their `#include` statements to generate a JSON file that lists module export and imports. A build system can use this information to determine the build order of modules and header units. This option differs from [`/sourceDependencies`](sourcedependencies.md) in the following ways: @@ -59,10 +59,8 @@ Given the following sample code: #include import m; -import std.core; - +import std; import ; - import "t.h"; int main() {} @@ -78,15 +76,16 @@ produces a JSON file *`output.json`* similar to: { "Version":"1.1", "Data":{ - "Source":"C:\\a\\b\\main.cpp", + "Source":"C:\\test\\main.cpp", "ProvidedModule":"", "ImportedModules":[ "m", - "std.core" + "std" ], "ImportedHeaderUnits":[ "C:\\...\\utility", - "C:\\a\\b\\t.h" + "C:\\...\\vector", + "C:\\test\\t.h" ] } } @@ -100,10 +99,11 @@ No *`.ifc`* files are listed in the output because they weren't built. Unlike `/ ## To set this compiler option in Visual Studio -You normally shouldn't set this option yourself in the Visual Studio development environment. It's set by the build system. +You normally shouldn't set this option yourself in the Visual Studio development environment. The build system sets it. ## See also +[Import the C++ standard library using modules](../../cpp/tutorial-import-stl-named-module.md)\ [`/translateInclude`](translateinclude.md)\ [C++ header-units.json reference](header-unit-json-reference.md)\ [MSVC compiler options](compiler-options.md)\ diff --git a/docs/build/reference/specifying-the-pathname.md b/docs/build/reference/specifying-the-pathname.md index 98293ee2a43..55be6dfec95 100644 --- a/docs/build/reference/specifying-the-pathname.md +++ b/docs/build/reference/specifying-the-pathname.md @@ -1,9 +1,8 @@ --- -description: "Learn more about: Specifying the Pathname" title: "Specifying the Pathname" -ms.date: "11/04/2016" +description: "Learn more about: Specifying the Pathname" +ms.date: 11/04/2016 helpviewer_keywords: ["names [C++], compiler output files", "cl.exe compiler, output files", "output files, specifying pathnames"] -ms.assetid: 7a6595ce-3383-44ae-957a-466bfa29c343 --- # Specifying the Pathname @@ -24,7 +23,7 @@ Alternatively, the *pathname* argument can be a device name (AUX, CON, PRN, or N The following command line sends a mapfile to the printer: -``` +```cmd CL /FmPRN HELLO.CPP ``` diff --git a/docs/build/reference/std-specify-language-standard-version.md b/docs/build/reference/std-specify-language-standard-version.md index d2fa1a11cd4..c9eeb3f5443 100644 --- a/docs/build/reference/std-specify-language-standard-version.md +++ b/docs/build/reference/std-specify-language-standard-version.md @@ -1,8 +1,8 @@ --- title: "/std (Specify Language Standard Version)" description: "The MSVC compiler option /std specifies the C or C++ language standard supported by the compiler." -ms.date: 4/9/2023 -f1_keywords: ["/std", "-std", "/std:c++14", "/std:c++17", "/std:c++20", "/std:c11", "/std:c17", "/std:clatest", "VC.Project.VCCLCompilerTool.CppLanguageStandard"] +ms.date: 1/29/2025 +f1_keywords: ["/std", "-std", "/std:c++14", "/std:c++17", "/std:c++20", "/std:c++23preview", "/std:c++latest", "/std:c11", "/std:c17", "/std:clatest", "VC.Project.VCCLCompilerTool.CppLanguageStandard"] --- # `/std` (Specify Language Standard Version) @@ -13,6 +13,7 @@ Enable supported C and C++ language features from the specified version of the C > **`/std:c++14`**\ > **`/std:c++17`**\ > **`/std:c++20`**\ +> **`/std:c++23preview`**\ > **`/std:c++latest`**\ > **`/std:c11`**\ > **`/std:c17`**\ @@ -24,19 +25,20 @@ The **`/std`** options are available in Visual Studio 2017 and later. They're us The Microsoft C++ compiler in Visual Studio 2017 and later versions doesn't support C++ standards modes earlier than C++14 (**`/std:c++14`**). Such support isn't planned. As an imperfect workaround, it's possible to use older Visual C++ compiler toolsets that didn't implement features from later standards. For more information on how to install and use older compiler toolsets in Visual Studio, see [Use native multi-targeting in Visual Studio to build old projects](../../porting/use-native-multi-targeting.md). -### C++ standards support +## C++ standards support -The **`/std`** option in effect during a C++ compilation can be detected by use of the [`_MSVC_LANG`](../../preprocessor/predefined-macros.md) preprocessor macro. For more information, see [Preprocessor Macros](../../preprocessor/predefined-macros.md). +Detect whether the **`/std`** option is in effect during a C++ compilation with the [`_MSVC_LANG`](../../preprocessor/predefined-macros.md) preprocessor macro. For more information, see [Preprocessor Macros](../../preprocessor/predefined-macros.md). > [!IMPORTANT] > Because some existing code depends on the value of the macro `__cplusplus` being `199711L`, the MSVC compiler doesn't change the value of this macro unless you explicitly opt in by setting [`/Zc:__cplusplus`](zc-cplusplus.md). Specify `/Zc:__cplusplus` and the **`/std`** option to set `__cplusplus` to the appropriate value. -**`/std:c++14`**\ -The **`/std:c++14`** option enables C++14 standard-specific features implemented by the MSVC compiler. This option is the default for code compiled as C++. It's available starting in Visual Studio 2015 Update 3. +### `/std:c++14` + +Enables C++14 standard-specific features implemented by the MSVC compiler. This option is the default for code compiled as C++. It's available starting in Visual Studio 2015 Update 3. This option disables compiler and standard library support for features that are changed or new in more recent versions of the language standard. However, it doesn't disable some C++17 features already implemented in previous releases of the MSVC compiler. For more information, see [Microsoft C/C++ language conformance](../../overview/visual-cpp-language-conformance.md). The tables indicate which C++17 features are enabled when you specify **`/std:c++14`**. -The following features remain enabled when the **`/std:c++14`** option is specified to avoid breaking changes for users who have already taken dependencies on the features available in or before Visual Studio 2015 Update 2: +The following features remain enabled when the **`/std:c++14`** option is specified to avoid breaking changes for users who took dependencies on features available in or before Visual Studio 2015 Update 2: - [Rules for `auto` with braced-init-lists](https://wg21.link/n3922) - [`typename` in template template-parameters](https://wg21.link/n4051) @@ -44,43 +46,52 @@ The following features remain enabled when the **`/std:c++14`** option is specif - [Attributes for namespaces and enumerators](https://wg21.link/n4266) - [u8 character literals](https://wg21.link/n4267) -**`/std:c++17`**\ -The **`/std:c++17`** option enables C++17 standard-specific features and behavior. It enables the full set of C++17 features implemented by the MSVC compiler. This option disables compiler and standard library support for features that are new or changed after C++17. It specifically disables post-C++17 changes in the C++ Standard and versions of the Working Draft. It doesn't disable retroactive defect updates of the C++ Standard. This option is available starting in Visual Studio 2017 version 15.3. +### `/std:c++17` + +Enables C++17 standard-specific features and behavior. It enables the full set of C++17 features implemented by the MSVC compiler. This option disables compiler and standard library support for features that are new or changed after C++17. It specifically disables post-C++17 changes in the C++ Standard and versions of the Working Draft. It doesn't disable retroactive defect updates of the C++ Standard. This option is available starting in Visual Studio 2017 version 15.3. Depending on the MSVC compiler version or update level, C++17 features may not be fully implemented or fully conforming when you specify the **`/std:c++17`** option. For an overview of C++ language conformance in Visual C++ by release version, see [Microsoft C/C++ language conformance](../../overview/visual-cpp-language-conformance.md). -**`/std:c++20`**\ -The **`/std:c++20`** option enables C++20 standard-specific features and behavior. Available starting in Visual Studio 2019 version 16.11, it enables the full set of C++20 features implemented by the MSVC compiler. Note that Visual Studio 2022 version 17.0 does not support `std::format`, the C++20 `` formatting extensions, and the range factories and range adaptors from `` under **`/std:c++20`** due to late-breaking changes in those features immediately after publication of the Standard. +### `/std:c++20` + +Enables C++20 standard-specific features and behavior. + +Enables the standard conformance mode provided by [**`/permissive-`**](./permissive-standards-conformance.md) unless explicitly overridden with **`/permissive`**. -The **`/std:c++20`** option disables compiler and standard library support for features that are new or changed after C++20. It specifically disables post-C++20 changes in the C++ Standard and versions of the Working Draft. It doesn't disable retroactive defect updates of the C++ Standard. +### `/std:c++23preview` -The **`/std:c++20`** option enables the standard conformance mode provided by [**`/permissive-`**](./permissive-standards-conformance.md) unless explicitly overriden with **`/permissive`**. +Enables preview C++23 standard-specific features and behavior. Available starting in Visual Studio 2022 version 17.13 Preview 4. Preview features may change and may not be ABI compatible across releases. -**`/std:c++latest`**\ -The **`/std:c++latest`** option enables all currently implemented compiler and standard library features proposed for the next draft standard, as well as some in-progress and experimental features. This option is available starting in Visual Studio 2015 Update 3. +This switch will be removed when the `/std:c++23` switch is implemented--at which point C++23 features will be fully implemented and ABI stable. If in project properties **C/C++** > **Language** you specify **Preview - ISO C++ 23 Standard (/std:c++preview)**, it will automatically change to mean `/std:c++23` once the new switch is implemented. -Depending on the MSVC compiler version or update level, C++17, C++20, or proposed C++23 features may not be fully implemented or fully conforming when you specify the **`/std:c++latest`** option. We recommend you use the latest version of Visual Studio for maximum standards conformance. For an overview of C++ language and library conformance in Visual C++ by release version, see [Microsoft C/C++ language conformance](../../overview/visual-cpp-language-conformance.md). +This switch differs from `/std:c++latest` in that it only enables features that are part of the C++23 standard. It doesn't enable experimental or in-progress features. -In versions of Visual Studio 2019 before version 16.11, **`/std:c++latest`** is required to enable all the compiler and standard library features of C++20. +### `/std:c++latest` -Since Visual Studio 2019 version 16.8, the **`/std:c++latest`** option has enabled the standard conformance mode provided by [**`/permissive-`**](./permissive-standards-conformance.md) unless explicitly overriden with **`/permissive`**. +Enables all currently implemented compiler and standard library features proposed in the next ISO C++ working draft, as well as some in-progress and experimental features. This option is available starting with Visual Studio 2015 Update 3. + +Depending on the MSVC compiler version or update level, features from published C++ standards or proposed features in the current C++ working draft, may not be fully implemented or fully conforming when you specify the **`/std:c++latest`** option. We recommend you use the latest version of Visual Studio for maximum standards conformance. For an overview of C++ language and library conformance in Visual C++ by release version, see [Microsoft C/C++ language conformance](../../overview/visual-cpp-language-conformance.md). + +Since Visual Studio 2019 version 16.8, the **`/std:c++latest`** option has enabled the standard conformance mode provided by [**`/permissive-`**](./permissive-standards-conformance.md) unless explicitly overridden with **`/permissive`**. For a list of supported language and library features, see [What's New for C++ in Visual Studio](../../overview/what-s-new-for-visual-cpp-in-visual-studio.md). The **`/std:c++latest`** option doesn't enable features guarded by the **`/experimental`** switch, but may be required to enable them. > [!NOTE] -> The compiler and library features enabled by **`/std:c++latest`** may appear in a future C++ standard. Features that have not been approved are subject to breaking changes or removal without notice and are provided on an as-is basis. +> The compiler and library features enabled by **`/std:c++latest`** may appear in a future C++ standard. Features that haven't been approved are subject to breaking changes or removal without notice and are provided on an as-is basis. -### C standards support +## C standards support You can invoke the Microsoft C compiler by using the [`/TC` or `/Tc`](tc-tp-tc-tp-specify-source-file-type.md) compiler option. It's used by default for code that has a *`.c`* file extension, unless overridden by a **`/TP`** or **`/Tp`** option. The default C compiler (that is, the compiler when **`/std:c11`** or **`/std:c17`** isn't specified) implements ANSI C89, but includes several Microsoft extensions, some of which are part of ISO C99. Some Microsoft extensions to C89 can be disabled by using the [`/Za`](za-ze-disable-language-extensions.md) compiler option, but others remain in effect. It isn't possible to specify strict C89 conformance. The compiler doesn't implement several required features of C99, so it isn't possible to specify C99 conformance, either. -**`/std:c11`**\ -The **`/std:c11`** option enables ISO C11 conformance. It's available starting in Visual Studio 2019 version 16.8. +### `/std:c11` + +Enables ISO C11 conformance. It's available starting in Visual Studio 2019 version 16.8. + +### `/std:c17` -**`/std:c17`**\ -The **`/std:c17`** option enables ISO C17 conformance. It's available starting in Visual Studio 2019 version 16.8. +Enables ISO C17 conformance. It's available starting in Visual Studio 2019 version 16.8. Because the new preprocessor is needed to support these standards, the **`/std:c11`** and **`/std:c17`** compiler options set the [`/Zc:preprocessor`](zc-preprocessor.md) option automatically. If you want to use the traditional (legacy) preprocessor for C11 or C17, you must set the **`/Zc:preprocessor-`** compiler option explicitly. Setting the **`/Zc:preprocessor-`** option may lead to unexpected behavior, and isn't recommended. @@ -90,15 +101,10 @@ Because the new preprocessor is needed to support these standards, the **`/std:c When you specify **`/std:c11`** or **`/std:c17`**, MSVC supports all the features of C11 and C17 required by the standards. The **`/std:c11`** and **`/std:c17`** compiler options enable support for these functionalities: - [`_Pragma`](../../preprocessor/pragma-directives-and-the-pragma-keyword.md#the-pragma-preprocessing-operator) - - [`restrict`](../../c-language/type-qualifiers.md#restrict) - - [`_Noreturn`](../../c-language/noreturn.md) and \ - - [`_Alignas`, `_Alignof`](../../c-language/alignment-c.md) and \ - - [`_Generic`](../../c-language/generic-selection.md) and \ - - [`_Static_assert`](../../c-language/static-assert-c.md) The IDE uses C settings for IntelliSense and code highlighting when your source files have a *`.c`* file extension, or when you specify the [`/TC` or `/Tc`](tc-tp-tc-tp-specify-source-file-type.md) compiler option. Currently, IntelliSense in C highlights keywords `_Alignas`, `_Alignof`, `_Noreturn`, and `_Static_assert`, but not the equivalent macros defined in the standard headers: `alignas`, `alignof`, `noreturn`, and `static_assert`. @@ -115,17 +121,16 @@ The compiler doesn't support most optional features of ISO C11. Several of these - Variable length array (VLA) support isn't planned. VLAs provide attack vectors comparable to [`gets`](../../c-runtime-library/gets-getws.md), which is deprecated and planned for removal. -**`/std:clatest`**\ -The **`/std:clatest`** option behaves like the `/std:c++latest` switch for the C++ compiler. The switch enables all currently implemented compiler and standard library features proposed for the next draft C standard, as well as some in-progress and experimental features. +### `/std:clatest` + +The **`/std:clatest`** option behaves like the `/std:c++latest` switch for the C++ compiler. The switch enables all currently implemented compiler and standard library features proposed in the next draft C standard, as well as some in-progress and experimental features. For more information, see the C Standard library features section of [Microsoft C/C++ language conformance](../../overview/visual-cpp-language-conformance.md). ### To set this compiler option in the Visual Studio development environment 1. Open the project's **Property Pages** dialog box. For more information, see [Set C++ compiler and build properties in Visual Studio](../working-with-project-properties.md). - 1. Select the **Configuration Properties** > **C/C++** > **Language** property page. - 1. In **C++ Language Standard** (or for C, **C Language Standard**), choose the language standard to support from the dropdown control, then choose **OK** or **Apply** to save your changes. ## See also diff --git a/docs/build/reference/subsystem-specify-subsystem.md b/docs/build/reference/subsystem-specify-subsystem.md index 4371a12db04..5669fa0e8bf 100644 --- a/docs/build/reference/subsystem-specify-subsystem.md +++ b/docs/build/reference/subsystem-specify-subsystem.md @@ -29,7 +29,7 @@ Win32 character-mode application. The operating system provides a console for co **`EFI_BOOT_SERVICE_DRIVER`**\ **`EFI_ROM`**\ **`EFI_RUNTIME_DRIVER`**\ -The Extensible Firmware Interface subsystems. For more information, see the [UEFI specification](https://uefi.org/specifications). For examples, see the Intel [UEFI Driver and Application Tool Resources](https://www.intel.com/content/www/us/en/architecture-and-technology/unified-extensible-firmware-interface/uefi-driver-and-application-tool-resources.html). The minimum version and default version is 1.0. +The Extensible Firmware Interface subsystems. For more information, see the [UEFI specification](https://uefi.org/specifications). The minimum version and default version is 1.0. **`NATIVE`**\ Kernel mode drivers for Windows NT. This option is normally reserved for Windows system components. If [`/DRIVER:WDM`](driver-windows-nt-kernel-mode-driver.md) is specified, `NATIVE` is the default. diff --git a/docs/build/reference/tlbout-name-dot-tlb-file.md b/docs/build/reference/tlbout-name-dot-tlb-file.md index a9fde3067bb..3daba013801 100644 --- a/docs/build/reference/tlbout-name-dot-tlb-file.md +++ b/docs/build/reference/tlbout-name-dot-tlb-file.md @@ -1,32 +1,31 @@ --- description: "Learn more about: /TLBOUT (Name .TLB File)" title: "/TLBOUT (Name .TLB File)" -ms.date: "11/04/2016" +ms.date: 03/24/2025 f1_keywords: ["VC.Project.VCLinkerTool.TypeLibraryFile", "/tlbout"] helpviewer_keywords: ["tlb files, renaming", "TLBOUT linker option", "/TLBOUT linker option", ".tlb files, renaming", "-TLBOUT linker option"] -ms.assetid: 0df6d078-2e48-46c9-a1a5-02674d85dce8 --- -# /TLBOUT (Name .TLB File) +# `/TLBOUT` (Name .TLB File) -``` +```cmd /TLBOUT:[path\]filename ``` ## Arguments -*path*
+*`path`*\ An absolute or relative path specification for where the .tlb file should be created. -*filename*
-Specifies the name of the .tlb file created by the MIDL compiler. No file extension is assumed; specify *filename*.tlb if you want a .tlb extension. +*`filename`* +Specifies the name of the .tlb file created by the MIDL compiler. No file extension is assumed; specify *filename*.tlb if you want a .tlb extension. When expanded, the fully qualified filename must not exceed `MAX_PATH` (260 characters). ## Remarks -The /TLBOUT option specifies the name and extension of the .tlb file. +The `/TLBOUT` option specifies the name and extension of the .tlb file. The MIDL compiler is called by the MSVC linker when linking projects that have the [module](../../windows/attributes/module-cpp.md) attribute. -If /TLBOUT is not specified, the .tlb file will get its name from [/IDLOUT](idlout-name-midl-output-files.md) *filename*. If /IDLOUT is not specified, the .tlb file will be called vc70.tlb. +If `/TLBOUT` is not specified, the .tlb file will get its name from [/IDLOUT](idlout-name-midl-output-files.md) *filename*. If /IDLOUT is not specified, the .tlb file will be called vc70.tlb. ### To set this linker option in the Visual Studio development environment @@ -42,8 +41,8 @@ If /TLBOUT is not specified, the .tlb file will get its name from [/IDLOUT](idlo ## See also -[MSVC linker reference](linking.md)
-[MSVC Linker Options](linker-options.md)
-[/IGNOREIDL (Don't Process Attributes into MIDL)](ignoreidl-don-t-process-attributes-into-midl.md)
-[/MIDL (Specify MIDL Command Line Options)](midl-specify-midl-command-line-options.md)
+[MSVC linker reference](linking.md)\ +[MSVC Linker Options](linker-options.md)\ +[/IGNOREIDL (Don't Process Attributes into MIDL)](ignoreidl-don-t-process-attributes-into-midl.md)\ +[/MIDL (Specify MIDL Command Line Options)](midl-specify-midl-command-line-options.md)\ [Building an Attributed Program](../../windows/attributes/cpp-attributes-com-net.md) diff --git a/docs/build/reference/translateinclude.md b/docs/build/reference/translateinclude.md index fa5cadac9e8..814d97b06fc 100644 --- a/docs/build/reference/translateinclude.md +++ b/docs/build/reference/translateinclude.md @@ -13,7 +13,7 @@ This switch instructs the compiler to treat `#include` as `import` for header fi When used with [`/scanDependencies`](scandependencies.md) or [`/sourceDependencies-directives`](sourcedependencies-directives.md), the compiler lists as imported header units in the generated dependency file those headers that are both included in the source and have a corresponding entry in a `header-units.json` file. This dependency info is used by the build system to generate compiled header unit `.ifc` files. Once the header units are built, they're treated by the compiler as an `import` instead of an `#include`. -The `header-units.json` file is only consulted when `/translateInclude` is specified. For more information about the format and purpose of the `header-units.json` file, see [`header-units.json`](header-unit-json-reference.md). +The `header-units.json` file is only consulted when `/translateInclude` is specified. For more information about the format and purpose of the `header-units.json` file, see [`header-units.json`](header-unit-json-reference.md). If an `#include` file isn't listed in the `header-units.json` file, it's treated as a normal `#include`. diff --git a/docs/build/reference/u-u-undefine-symbols.md b/docs/build/reference/u-u-undefine-symbols.md index 816c7045274..cdc3cdd3ba2 100644 --- a/docs/build/reference/u-u-undefine-symbols.md +++ b/docs/build/reference/u-u-undefine-symbols.md @@ -1,12 +1,11 @@ --- title: "/U, /u (Undefine symbols)" description: "Use the Microsoft C/C++ compiler /U and /u options to undefine preprocessor symbols." -ms.date: 09/03/2020 +ms.date: 04/14/2025 f1_keywords: ["VC.Project.VCCLCompilerTool.UndefinePreprocessorDefinitions", "VC.Project.VCCLWCECompilerTool.UndefinePreprocessorDefinitions", "VC.Project.VCCLCompilerTool.UndefineAllPreprocessorDefinitions", "/u", "VC.Project.VCCLWCECompilerTool.UndefineAllPreprocessorDefinitions"] helpviewer_keywords: ["-U compiler option [C++]", "Undefine Symbols compiler option", "/U compiler option [C++]", "U compiler option [C++]"] -ms.assetid: 7bc0474f-6d1f-419b-807d-0d8816763b2a --- -# /U, /u (Undefine symbols) +# `/U`, `/u` (Undefine symbols) The **`/U`** compiler option undefines the specified preprocessor symbol. The **`/u`** compiler option undefines the Microsoft-specific symbols that the compiler defines. @@ -17,7 +16,7 @@ The **`/U`** compiler option undefines the specified preprocessor symbol. The ** ## Arguments -*symbol*
+*`symbol`*\ The preprocessor symbol to undefine. ## Remarks @@ -44,9 +43,7 @@ For a complete list of Microsoft-specific predefined macros, see [Predefined mac ### To set this compiler option in the Visual Studio development environment 1. Open the project's **Property Pages** dialog box. For details, see [Set C++ compiler and build properties in Visual Studio](../working-with-project-properties.md). - -1. Select the **Configuration Properties** > **C/C++** > **Advanced** property page. - +1. Select the **Configuration Properties** > **C/C++** > **Preprocessor** property page. 1. Modify the **Undefine Preprocessor Definitions** or **Undefine All Preprocessor Definitions** properties. ### To set this compiler option programmatically @@ -55,9 +52,9 @@ For a complete list of Microsoft-specific predefined macros, see [Predefined mac ## See also -[MSVC compiler options](compiler-options.md)
-[MSVC compiler command-line syntax](compiler-command-line-syntax.md)
-[**`/J`** (Default char type is unsigned)](j-default-char-type-is-unsigned.md)
-[**`/GR`** (Enable run-time type information)](gr-enable-run-time-type-information.md)
-[**`/EH`** (Exception handling model)](eh-exception-handling-model.md)
+[MSVC compiler options](compiler-options.md)\ +[MSVC compiler command-line syntax](compiler-command-line-syntax.md)\ +[**`/J`** (Default char type is unsigned)](j-default-char-type-is-unsigned.md)\ +[**`/GR`** (Enable run-time type information)](gr-enable-run-time-type-information.md)\ +[**`/EH`** (Exception handling model)](eh-exception-handling-model.md)\ [**`/MD`**, **`/MT`**, **`/LD`** (Use run-time library)](md-mt-ld-use-run-time-library.md) diff --git a/docs/build/reference/useprofile.md b/docs/build/reference/useprofile.md index 9efe9965292..9a9fde9e724 100644 --- a/docs/build/reference/useprofile.md +++ b/docs/build/reference/useprofile.md @@ -1,12 +1,12 @@ --- description: "Learn more about: /USEPROFILE (Run PGO in thread safe mode)" title: "/USEPROFILE (Use PGO data with LTCG)" -ms.date: "03/14/2018" +ms.date: 03/24/2025 f1_keywords: ["USEPROFILE"] --- # /USEPROFILE (Run PGO in thread safe mode) -This linker option together with [/LTCG (Link-time code generation](ltcg-link-time-code-generation.md) tells the linker to build by using profile-guided optimization (PGO) training data. +This linker option together with [`/LTCG` (Link-time code generation](ltcg-link-time-code-generation.md) tells the linker to build by using profile-guided optimization (PGO) training data. ## Syntax @@ -14,21 +14,21 @@ This linker option together with [/LTCG (Link-time code generation](ltcg-link-ti ### Arguments -**AGGRESSIVE**
+**`AGGRESSIVE`**\ This optional argument specifies that aggressive speed optimizations should be used during optimized code generation. -**PGD**=*filename*
-Specifies a base file name for the .pgd file. By default, the linker uses the base executable file name with a .pgd extension. +**`PGD`**=*filename*\ +Specifies a base filename for the `.pgd` file. By default, the linker uses the base executable filename with a `.pgd` extension. When expanded, the fully qualified filename must not exceed `MAX_PATH` (260 characters). ## Remarks -The **/USEPROFILE** linker option is used together with **/LTCG** to generate or update an optimized build based on PGO training data. It is the equivalent of the deprecated **/LTCG:PGUPDATE** and **/LTCG:PGOPTIMIZE** options. +The **`/USEPROFILE`** linker option is used together with **`/LTCG`** to generate or update an optimized build based on PGO training data. It is the equivalent of the deprecated **`/LTCG:PGUPDATE`** and **`/LTCG:PGOPTIMIZE`** options. -The optional **AGGRESSIVE** argument disables size-related heuristics to attempt to optimize for speed. This may result in optimizations that substantially increase the size of your executable, and may not increase the resulting speed. You should profile and compare the results of using and not using **AGGRESSIVE**. This argument must be specified explicitly; it is not enabled by default. +The optional **`AGGRESSIVE`** argument disables size-related heuristics to attempt to optimize for speed. This may result in optimizations that substantially increase the size of your executable, and may not increase the resulting speed. You should profile and compare the results of using and not using **`AGGRESSIVE`**. This argument must be specified explicitly; it is not enabled by default. -The **PGD** argument specifies an optional name for the training data .pgd file to use, the same as in [/GENPROFILE or /FASTGENPROFILE](genprofile-fastgenprofile-generate-profiling-instrumented-build.md). It is the equivalent of the deprecated **/PGD** switch. By default, or if no *filename* is specified, a .pgd file that has the same base name as the executable is used. +The **`PGD`** argument specifies an optional name for the training data `.pgd` file to use, the same as in [`/GENPROFILE` or `/FASTGENPROFILE`](genprofile-fastgenprofile-generate-profiling-instrumented-build.md). It is the equivalent of the deprecated **/PGD** switch. By default, or if no *`filename`* is specified, a `.pgd` file that has the same base name as the executable is used. -The **/USEPROFILE** linker option is new in Visual Studio 2015. +The **`/USEPROFILE`** linker option is new in Visual Studio 2015. ### To set this linker option in the Visual Studio development environment @@ -48,7 +48,7 @@ The **/USEPROFILE** linker option is new in Visual Studio 2015. ## See also -[/GENPROFILE and /FASTGENPROFILE](genprofile-fastgenprofile-generate-profiling-instrumented-build.md)
-[/LTCG](ltcg-link-time-code-generation.md)
-[Profile-Guided Optimizations](../profile-guided-optimizations.md)
-[Environment Variables for Profile-Guided Optimizations](../environment-variables-for-profile-guided-optimizations.md)
+[`/GENPROFILE` and `/FASTGENPROFILE`](genprofile-fastgenprofile-generate-profiling-instrumented-build.md)\ +[`/LTCG`](ltcg-link-time-code-generation.md)\ +[Profile-Guided Optimizations](../profile-guided-optimizations.md)\ +[Environment Variables for Profile-Guided Optimizations](../environment-variables-for-profile-guided-optimizations.md) diff --git a/docs/build/reference/vcxproj-file-structure.md b/docs/build/reference/vcxproj-file-structure.md index 0ce1e28fb50..2071e7e393d 100644 --- a/docs/build/reference/vcxproj-file-structure.md +++ b/docs/build/reference/vcxproj-file-structure.md @@ -7,7 +7,7 @@ ms.assetid: 14d0c552-29db-480e-80c1-7ea89d6d8e9c --- # `.vcxproj` and `.props` file structure -[MSBuild](../msbuild-visual-cpp.md) is the default project system in Visual Studio; when you choose **File** > **New Project** in Visual C++ you're creating an MSBuild project whose settings are stored in an XML project file that has the extension *`.vcxproj`*. The project file may also import *`.props`* files and *`.targets`* files where settings can be stored. +[MSBuild](../msbuild-visual-cpp.md) is the default project system in Visual Studio; when you choose **File** > **New Project**, in most cases you're creating an MSBuild project whose settings are stored in an XML project file that has the extension *`.vcxproj`*. The project file may also import *`.props`* files and *`.targets`* files where settings can be stored. If you intend to maintain your project properties in the IDE, we recommend you only create and modify your *`.vcxproj`* projects in the IDE, and avoid manual edits to the files. In most cases, you never need to manually edit the project file. Manual edits may break the project connections required to modify project settings in the Visual Studio property pages, and can cause build errors that are difficult to debug and repair. For more information about using the property pages, see [Set C++ compiler and build properties in Visual Studio](../working-with-project-properties.md). @@ -125,18 +125,11 @@ The following snippet shows a project configuration. In this example, 'Debug|x64 The IDE expects to find a project configuration for any combination of `Configuration` and `Platform` values used in all `ProjectConfiguration` items. Often, it means that a project might have meaningless project configurations to fulfill this requirement. For instance, if a project has these configurations: - Debug|Win32 - -- Retail|Win32 - -- Special 32-bit Optimization|Win32 - -then it must also have these configurations, even though "Special 32-bit Optimization" is meaningless for x64: - -- Debug|x64 - - Retail|x64 +- Debug|x64 +- Retail|Win32 -- Special 32-bit Optimization|x64 +Then if you add a new configuration to the project, say "Special 32-bit Optimization|Win32", then you must also add the configuration "Special 32-bit Optimization|x64", even though "Special 32-bit Optimization" is meaningless for x64. You can disable the build and deploy commands for any configuration in the **Solution Configuration Manager**. @@ -195,7 +188,7 @@ The `PropertySheets` group contains the imports for user property sheets. These ``` -`UserMacros` contains properties you create as variables that are used to customize your build process. For example, you can define a user macro to define your custom output path as $(CustomOutputPath) and use it to define other variables. This property group houses such properties. In Visual Studio, this group isn't populated in the project file because Visual C++ doesn't support user macros for configurations. User macros are supported in property sheets. +`UserMacros` contains properties you create as variables that are used to customize your build process. For example, you can define a user macro to define your custom output path as $(CustomOutputPath) and use it to define other variables. This property group houses such properties. In Visual Studio, this group isn't populated in the project file because Microsoft C++ doesn't support user macros for configurations. User macros are supported in property sheets. ### Per-configuration PropertyGroup elements diff --git a/docs/build/reference/visual-cpp-project-types.md b/docs/build/reference/visual-cpp-project-types.md index 41e998d56e9..baebf7c6045 100644 --- a/docs/build/reference/visual-cpp-project-types.md +++ b/docs/build/reference/visual-cpp-project-types.md @@ -1,6 +1,6 @@ --- description: "Learn more about: C++ project templates" -title: "Visual C++ Project Types" +title: "Microsoft C++ Project Types" ms.date: "08/13/2019" helpviewer_keywords: ["programs [C++], projects", "project templates [Visual Studio], C++", "TODO comments [C++]", "projects [C++], types", "templates [C++], projects", "applications [C++], projects", "C++ projects, types"] ms.assetid: 7337987e-1e7b-4120-9a4b-94f0401f15e7 diff --git a/docs/build/reference/vlen.md b/docs/build/reference/vlen.md index 6557c219ef9..fbc7abdf60e 100644 --- a/docs/build/reference/vlen.md +++ b/docs/build/reference/vlen.md @@ -9,6 +9,7 @@ helpviewer_keywords: ["specify vector length", "-vlen compiler option [C++]", "v Specifies the vector length for code generation on x86 and x64. For more information about **`/arch`** for x86 and x64, see [`/arch` (x86)](arch-x86.md) and [`/arch` (x64)](arch-x64.md). + ## Syntax > **`/vlen=`**\[**`256`**|**`512`**] @@ -18,24 +19,26 @@ Specifies the vector length for code generation on x86 and x64. For more informa ## Arguments **`/vlen=256`**\ -Specify a vector length of 256 bits for auto-vectorization and other optimizations. +Specify a vector length of 256 bits for autovectorization and other optimizations. **`/vlen=512`**\ -Specify a vector length of 512 bits for auto-vectorization and other optimizations. +Specify a vector length of 512 bits for autovectorization and other optimizations. **`/vlen`**\ Specify the default vector length for the selected **`/arch`** setting. ## Remarks -If a specific **`/vlen`** value isn't specified, the default vector length depends on the **`/arch`** flag setting. The **`/vlen`** flag can override the default vector length specified by **`/arch:AVX512`** or **`/arch:AVX10.1`** flag. For example: +This compiler option was introduced in Visual Studio 2022 17.13. + +If a specific **`/vlen`** value isn't specified, the default vector length depends on the **`/arch`** compiler option setting. The **`/vlen`** compiler option can override the default vector length specified by **`/arch:AVX512`**, **`/arch:AVX10.1`**, or **`/arch:AVX10.2`** compiler option. For example: - **`/arch:AVX512 /vlen=256`** overrides the default vector length of 512 bits specified by **`/arch:AVX512`** to be 256 bits. - **`/arch:AVX10.1 /vlen=512`** overrides the default vector length of 256 bits specified by **`/arch:AVX10.1`** to be 512 bits. -When the specified **`/vlen`** value is incompatible with specified **`/arch`** flag, a warning is generated and default vector length for the **`/arch`** setting is used. For example: +When the specified **`/vlen`** value is incompatible with specified **`/arch`** compiler option, a warning is generated and default vector length for the **`/arch`** setting is used. For example: -- **`/arch:AVX2 /vlen=512`** generates a warning because AVX2 doesn't support 512-bit vectors. Vector length of 256 bits is used in this case. +- **`/arch:AVX2 /vlen=512`** generates a warning because AVX2 doesn't support 512-bit vectors. A 256-bit vector length is used in this case. ### To set the `/vlen=256` or `/vlen=512` compiler option in Visual Studio diff --git a/docs/build/reference/wholearchive-include-all-library-object-files.md b/docs/build/reference/wholearchive-include-all-library-object-files.md index 4a1addad374..dafe4bcd5f0 100644 --- a/docs/build/reference/wholearchive-include-all-library-object-files.md +++ b/docs/build/reference/wholearchive-include-all-library-object-files.md @@ -1,8 +1,7 @@ --- description: "Learn more about: /WHOLEARCHIVE (Include All Library Object Files)" title: "/WHOLEARCHIVE (Include All Library Object Files)" -ms.date: "02/12/2020" -ms.assetid: ee92d12f-18af-4602-9683-d6223be62ac9 +ms.date: 03/27/2025 --- # /WHOLEARCHIVE (Include All Library Object Files) @@ -15,26 +14,24 @@ Force the linker to include all object files in the static library in the linked ### Arguments -*library*\ -An optional pathname to a static library. The linker includes every object file from this library. +*`library`*\ +An optional pathname to a static library. The linker includes every object file from this library. When expanded, the fully qualified filename must not exceed `MAX_PATH` (260 characters). ## Remarks -The /WHOLEARCHIVE option forces the linker to include every object file from either a specified static library, or if no library is specified, from all static libraries specified to the LINK command. To specify the /WHOLEARCHIVE option for multiple libraries, you can use more than one /WHOLEARCHIVE switch on the linker command line. By default, the linker includes object files in the linked output only if they export symbols referenced by other object files in the executable. The /WHOLEARCHIVE option makes the linker treat all object files archived in a static library as if they were specified individually on the linker command line. +The `/WHOLEARCHIVE` option forces the linker to include every object file from either a specified static library, or if no library is specified, from all static libraries specified to the LINK command. To specify the `/WHOLEARCHIVE` option for multiple libraries, you can use more than one `/WHOLEARCHIVE` switch on the linker command line. By default, the linker includes object files in the linked output only if they export symbols referenced by other object files in the executable. The `/WHOLEARCHIVE` option makes the linker treat all object files archived in a static library as if they were specified individually on the linker command line. -The /WHOLEARCHIVE option can be used to re-export all the symbols from a static library. This allows you to make sure that all of your library code, resources, and metadata are included when you create a component from more than one static library. If you see warning LNK4264 when you create a static library that contains Windows Runtime components for export, use the /WHOLEARCHIVE option when linking that library into another component or app. +The `/WHOLEARCHIVE` option can be used to re-export all the symbols from a static library. This allows you to make sure that all of your library code, resources, and metadata are included when you create a component from more than one static library. If you see warning LNK4264 when you create a static library that contains Windows Runtime components for export, use the `/WHOLEARCHIVE` option when linking that library into another component or app. -The /WHOLEARCHIVE option was introduced in Visual Studio 2015 Update 2. +The `/WHOLEARCHIVE` option was introduced in Visual Studio 2015 Update 2. ### To set this linker option in Visual Studio 1. Open the project **Property Pages** dialog box. For more information, see [Set C++ compiler and build properties in Visual Studio](../working-with-project-properties.md). - 1. Select the **Configuration Properties** > **Linker** > **Command Line** property page. - 1. Add the *`/WHOLEARCHIVE`* option to the **Additional Options** text box. ## See also -[MSVC linker reference](linking.md)
+[MSVC linker reference](linking.md)\ [MSVC Linker Options](linker-options.md) diff --git a/docs/build/reference/winmdfile-specify-winmd-file.md b/docs/build/reference/winmdfile-specify-winmd-file.md index fb489848b54..69f135c446f 100644 --- a/docs/build/reference/winmdfile-specify-winmd-file.md +++ b/docs/build/reference/winmdfile-specify-winmd-file.md @@ -1,21 +1,25 @@ --- -description: "Learn more about: /WINMDFILE (Specify winmd File)" title: "/WINMDFILE (Specify winmd File)" -ms.date: "11/04/2016" +description: "Learn more about: /WINMDFILE (Specify winmd File)" +ms.date: 03/27/2025 f1_keywords: ["VC.Project.VCLinkerTool.GenerateWindowsMetadataFile"] -ms.assetid: 062b41b3-14d6-432c-a361-fdb66e918931 --- # /WINMDFILE (Specify winmd File) -Specifies the file name for the Windows Runtime Metadata (.winmd) output file that is generated by the [/WINMD](winmd-generate-windows-metadata.md) linker option. +Specifies the filename for the Windows Runtime Metadata (`.winmd`) output file that is generated by the [`/WINMD`](winmd-generate-windows-metadata.md) linker option. ``` /WINMDFILE:filename ``` +## Argument + +*`filename`*\ +The filename for `.winmd` output file. When expanded, the fully qualified filename must not exceed `MAX_PATH` (260 characters). + ## Remarks -Use the value that is specified in `filename` to override the default .winmd file name (`binaryname`.winmd). Notice that you do not append ".winmd" to `filename`. If multiple values are listed on the **/WINMDFILE** command line, the last one takes precedence. +Use the value that is specified in `filename` to override the default `.winmd` file name (`binaryname`.winmd). Don't append `".winmd"` to `filename`. If multiple values are listed on the **`/WINMDFILE`** command line, the last one takes precedence. The resulting name when combined with `.winmd` must not exceed `MAX_PATH` (260 characters). ### To set this linker option in the Visual Studio development environment @@ -27,6 +31,6 @@ Use the value that is specified in `filename` to override the default .winmd fil ## See also -[/WINMD (Generate Windows Metadata)](winmd-generate-windows-metadata.md)
-[MSVC linker reference](linking.md)
+[`/WINMD` (Generate Windows Metadata)](winmd-generate-windows-metadata.md)\ +[MSVC linker reference](linking.md)\ [MSVC Linker Options](linker-options.md) diff --git a/docs/build/reference/yd-place-debug-information-in-object-file.md b/docs/build/reference/yd-place-debug-information-in-object-file.md index b3e9699bb7c..ced560abe33 100644 --- a/docs/build/reference/yd-place-debug-information-in-object-file.md +++ b/docs/build/reference/yd-place-debug-information-in-object-file.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: /Yd (Place Debug Information in Object File)" title: "/Yd (Place Debug Information in Object File)" -ms.date: "11/04/2016" +description: "Learn more about: /Yd (Place Debug Information in Object File)" +ms.date: 11/04/2016 f1_keywords: ["/yd"] helpviewer_keywords: ["/Yd compiler option [C++]", "-Yd compiler option [C++]", "debugging [C++], debug information files", "Yd compiler option [C++]"] -ms.assetid: c5a699fe-65ce-461e-964c-7f5eb2a8320a --- # /Yd (Place Debug Information in Object File) @@ -55,13 +54,13 @@ Suppose you have two base files, F.cpp and G.cpp, each containing these **#inclu The following command creates the precompiled header file ETC.pch and the object file F.obj: -``` +```cmd CL /YcETC.H /Z7 F.CPP ``` The object file F.obj includes type and symbol information for WINDOWS.h and ETC.h (and any other header files they include). Now you can use the precompiled header ETC.pch to compile the source file G.cpp: -``` +```cmd CL /YuETC.H /Z7 G.CPP ``` diff --git a/docs/build/reference/zc-alignednew.md b/docs/build/reference/zc-alignednew.md index c8a583964a7..c591923268d 100644 --- a/docs/build/reference/zc-alignednew.md +++ b/docs/build/reference/zc-alignednew.md @@ -1,6 +1,6 @@ --- -description: "Learn more about: /Zc:alignedNew (C++17 over-aligned allocation)" title: "/Zc:alignedNew (C++17 over-aligned allocation)" +description: "Learn more about: /Zc:alignedNew (C++17 over-aligned allocation)" ms.date: "05/18/2019" f1_keywords: ["/Zc:alignedNew"] helpviewer_keywords: ["/Zc:alignedNew", "Zc:alignedNew", "-Zc:alignedNew"] @@ -17,7 +17,7 @@ Enable support for C++17 over-aligned **`new`**, dynamic memory allocation align The MSVC compiler and library support C++17 standard over-aligned dynamic memory allocation. When the **`/Zc:alignedNew`** option is specified, a dynamic allocation such as `new Example;` respects the alignment of `Example` even when it's greater than `max_align_t`, the largest alignment required for any fundamental type. When the alignment of the allocated type is no more than the alignment guaranteed by the original operator **`new`**, available as the value of the predefined macro `__STDCPP_DEFAULT_NEW_ALIGNMENT__`, the statement `new Example;` results in a call to `::operator new(size_t)` as it did in C++14. When the alignment is greater than `__STDCPP_DEFAULT_NEW_ALIGNMENT__`, the implementation instead obtains the memory by using `::operator new(size_t, align_val_t)`. Similarly, deletion of over-aligned types invokes `::operator delete(void*, align_val_t)` or the sized delete signature `::operator delete(void*, size_t, align_val_t)`. -The **`/Zc:alignedNew`** option is only available when [`/std:c++17`](std-specify-language-standard-version.md) or later is enabled. Under **`/std:c++17`** or later, **`/Zc:alignedNew`** is enabled by default to conform to the C++ standard. If the only reason you implement operator **`new`** and **`delete`** is to support over-aligned allocations, you may no longer need this code in C++17 or later modes. To turn off this option and revert to the C++14 behavior of **`new`** and **`delete`** when you use **`/std::c++17`** or later, specify **`/Zc:alignedNew-`**. If you implement operator **`new`** and **`delete`** but you're not ready to implement the over-aligned operator **`new`** and **`delete`** overloads that have the `align_val_t` parameter, use the **`/Zc:alignedNew-`** option to prevent the compiler and Standard Library from generating calls to the over-aligned overloads. The [`/permissive-`](permissive-standards-conformance.md) option doesn't change the default setting of **`/Zc:alignedNew`**. +The **`/Zc:alignedNew`** option is only available when [`/std:c++17`](std-specify-language-standard-version.md) or later is enabled. Under **`/std:c++17`** or later, **`/Zc:alignedNew`** is enabled by default to conform to the C++ standard. If the only reason you implement operator **`new`** and **`delete`** is to support over-aligned allocations, you may no longer need this code in C++17 or later modes. To turn off this option and revert to the C++14 behavior of **`new`** and **`delete`** when you use **`/std:c++17`** or later, specify **`/Zc:alignedNew-`**. If you implement operator **`new`** and **`delete`** but you're not ready to implement the over-aligned operator **`new`** and **`delete`** overloads that have the `align_val_t` parameter, use the **`/Zc:alignedNew-`** option to prevent the compiler and Standard Library from generating calls to the over-aligned overloads. The [`/permissive-`](permissive-standards-conformance.md) option doesn't change the default setting of **`/Zc:alignedNew`**. Support for **`/Zc:alignedNew`** is available starting in Visual Studio 2017 version 15.5. diff --git a/docs/build/reference/zc-conformance.md b/docs/build/reference/zc-conformance.md index efa980dbb7f..77534192bb9 100644 --- a/docs/build/reference/zc-conformance.md +++ b/docs/build/reference/zc-conformance.md @@ -30,13 +30,13 @@ Here are the **`/Zc`** compiler options: | [`/Zc:checkGwOdr[-]`](zc-check-gwodr.md) | Enforce Standard C++ ODR violations under `/Gw`. | | [`/Zc:enumTypes[-]`](zc-enumtypes.md) | Enable Standard C++ rules for `enum` type deduction. Off by default. | | [`/Zc:externC[-]`](zc-externc.md) | Enforce Standard C++ rules for `extern "C"` functions. Off by default unless **`/permissive-`** is specified. | -| [`/Zc:externConstexpr[-]`](zc-externconstexpr.md) | Enable external linkage for **`constexpr`** variables. Off by default. | +| [`/Zc:externConstexpr[-]`](zc-externconstexpr.md) | Enable external linkage for **`constexpr`** variables. Off by default unless **`/permissive-`** is specified. | | [`/Zc:forScope[-]`](zc-forscope-force-conformance-in-for-loop-scope.md) | Enforce Standard C++ **`for`** scoping rules. On by default. | | [`/Zc:gotoScope[-]`](zc-gotoscope.md) | Enforce Standard C++ **`goto`** rules around local variable initialization. Off by default unless **`/permissive-`** is specified. | | [`/Zc:hiddenFriend[-]`](zc-hiddenfriend.md) | Enforce Standard C++ hidden friend rules. Off by default unless **`/permissive-`** is specified. | | [`/Zc:implicitNoexcept[-]`](zc-implicitnoexcept-implicit-exception-specifiers.md) | Enable implicit **`noexcept`** on required functions. On by default. | | [`/Zc:inline[-]`](zc-inline-remove-unreferenced-comdat.md) | Remove unreferenced functions or data if they're COMDAT or have internal linkage only. Off by default. | -| [`/Zc:lambda[-]`](zc-lambda.md) | Enable new lambda processor for conformance-mode syntactic checks in generic lambdas. Off by default unless **`/std:c++20`** or later is specified. | +| [`/Zc:lambda[-]`](zc-lambda.md) | Enable new lambda processor for conformance-mode syntactic checks in generic lambdas. Off by default unless **`/permissive-`** or **`/std:c++20`** or later is specified. | | [`/Zc:noexceptTypes[-]`](zc-noexcepttypes.md) | Enforce C++17 **`noexcept`** rules. Off by default unless **`/std:c++17`** or later is specified. | | [`/Zc:nrvo[-]`](zc-nrvo.md) | Enable optional copy and move elisions. Off by default unless **`/O2`**, **`/permissive-`**, or **`/std:c++20`** or later is specified. | | [`/Zc:preprocessor[-]`](zc-preprocessor.md) | Use the new conforming preprocessor. Off by default unless **`/std:c11`** or later is specified. | diff --git a/docs/build/reference/zc-lambda.md b/docs/build/reference/zc-lambda.md index be3feb313d1..6081969b7cc 100644 --- a/docs/build/reference/zc-lambda.md +++ b/docs/build/reference/zc-lambda.md @@ -17,8 +17,7 @@ The **`/Zc:lambda`** compiler option enables conforming lambda grammar and proce The **`/Zc:lambda`** compiler option enables the conforming lambda processor. It parses and implements lambda code according to the C++ standard. This option is off by default, which uses the legacy lambda processor. Use this option to enable conformance-mode syntax checks of generic lambdas when you use the default [`/std:c++14`](std-specify-language-standard-version.md) or the [`/std:c++17`](std-specify-language-standard-version.md) compiler options. -**`/Zc:lambda`** is automatically enabled by the [`/std:c++20`](std-specify-language-standard-version.md), [`/std:c++latest`] -(std-specify-language-standard-version.md), [`/permissive-`](permissive-standards-conformance.md), and [`/experimental:module`](experimental-module.md) options. You can disable it explicitly by using **`/Zc:lambda-`**. +**`/Zc:lambda`** is automatically enabled by the [`/std:c++20`](std-specify-language-standard-version.md), [`/std:c++latest`](std-specify-language-standard-version.md), [`/permissive-`](permissive-standards-conformance.md), and [`/experimental:module`](experimental-module.md) options. You can disable it explicitly by using **`/Zc:lambda-`**. The **`/Zc:lambda`** option is available starting in Visual Studio 2019 version 16.8. It's available as **`/experimental:newLambdaProcessor`** starting in Visual Studio 2019 version 16.3, but this spelling is now deprecated. diff --git a/docs/build/reference/zc-static-assert.md b/docs/build/reference/zc-static-assert.md index 78276252a83..9eb98b94a5f 100644 --- a/docs/build/reference/zc-static-assert.md +++ b/docs/build/reference/zc-static-assert.md @@ -1,7 +1,7 @@ --- description: "Learn more about: /Zc:static_assert (Strict static_assert handling)" title: "/Zc:static_assert (Strict static_assert handling)" -ms.date: 12/15/2021 +ms.date: 1/15/2025 f1_keywords: ["/Zc:static_assert"] helpviewer_keywords: ["/Zc:static_assert compiler option (C++)"] --- @@ -16,7 +16,9 @@ The **`/Zc:static_assert`** compiler option tells the compiler to evaluate `stat ## Remarks -The **`/Zc:static_assert`** compiler option tells the compiler to evaluate a `static_assert` in the body of a function template or in the body of a class template member function when first parsed, if the test expression isn't dependent. If the non-dependent test expression isn't `false`, the compiler emits an error immediately. When the test expression is dependent, the `static_assert` isn't evaluated until the template is instantiated. +Starting with Visual Studio 17.10, `/Zc:static_assert` and `/Zc:static_assert-` have no effect. Both options are ignored to avoid breaking builds that use them. `static_assert` is now never evaluated when parsing class or function templates. + +The **`/Zc:static_assert`** compiler option tells the compiler to evaluate a `static_assert` in the body of a function template or in the body of a class template member function when first parsed, if the test expression isn't dependent. If the non-dependent test expression is `false`, the compiler emits an error immediately. When the test expression is dependent, the `static_assert` isn't evaluated until the template is instantiated. The **`/Zc:static_assert`** option is available starting in Visual Studio 2022 version 17.1. In earlier versions of Visual Studio, or if **`/Zc:static_assert-`** is specified, Visual Studio doesn't do dependent analysis if the `static_assert` is within the body of a function template or within the body of a member function of a class template. Instead, it only evaluates the `static_assert` when a template is instantiated. diff --git a/docs/build/reference/zc-ternary.md b/docs/build/reference/zc-ternary.md index 61d8b6a0585..b77f0d7739f 100644 --- a/docs/build/reference/zc-ternary.md +++ b/docs/build/reference/zc-ternary.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: `/Zc:ternary` (Enforce conditional operator rules)" title: "/Zc:ternary (Enforce conditional operator rules)" -ms.date: "09/12/2019" +description: "Learn more about: `/Zc:ternary` (Enforce conditional operator rules)" +ms.date: 09/12/2019 f1_keywords: ["/Zc:ternary"] helpviewer_keywords: ["/Zc:ternary", "Zc:ternary", "-Zc:ternary"] --- @@ -23,7 +23,7 @@ The **`/Zc:ternary`** option is off by default in Visual Studio 2017. Use **`/Zc ### Examples -This sample shows how a class that provides both non-explicit initialization from a type, and conversion to a type, can lead to ambiguous conversions. This code is accepted by the compiler by default, but rejected when **/`Zc:ternary`** or **`/permissive-`** is specified. +This sample shows how a class that provides both non-explicit initialization from a type, and conversion to a type, can lead to ambiguous conversions. This code is accepted by the compiler by default, but rejected when **`/Zc:ternary`** or **`/permissive-`** is specified. ```cpp // zcternary1.cpp diff --git a/docs/build/reference/zc-tlsguards.md b/docs/build/reference/zc-tlsguards.md index dfaf7ff2d06..15c36abf138 100644 --- a/docs/build/reference/zc-tlsguards.md +++ b/docs/build/reference/zc-tlsguards.md @@ -1,6 +1,6 @@ --- -description: "Learn more about the /Zc:tlsGuards (Check TLS initialization) compiler option." title: "/Zc:tlsGuards (Check TLS initialization)" +description: "Learn more about the /Zc:tlsGuards (Check TLS initialization) compiler option." ms.date: 11/08/2022 f1_keywords: ["/Zc:tlsGuards"] helpviewer_keywords: ["-Zc:tlsGuards compiler option (C++)", "/Zc:tlsGuards compiler option (C++)"] @@ -29,4 +29,4 @@ The **`/Zc:tlsGuards`** option is new in Visual Studio 2019 version 16.5. This o ## See also -[`/Zc` (Conformance)](zc-conformance.md)\ +[`/Zc` (Conformance)](zc-conformance.md) diff --git a/docs/build/reference/zc-twophase.md b/docs/build/reference/zc-twophase.md index 61178e9b214..56752563138 100644 --- a/docs/build/reference/zc-twophase.md +++ b/docs/build/reference/zc-twophase.md @@ -163,7 +163,7 @@ typename T::TYPE func(typename T::TYPE*) } ``` -If you don't use the keyword **`typename`** in the function body, this code compiles under **`/permissive- /Zc:twoPhase-`**, but not under **`/permissive-`** alone. The **`typename`** keyword is required to indicate that the `TYPE` is dependent. Because the body isn't parsed under **`/Zc:twoPhase-`**, the compiler does't require the keyword. In **`/permissive-`** conformance mode, code without the **`typename`** keyword generates errors. To migrate your code to conformance in Visual Studio 2017 version 15.3 and beyond, insert the **`typename`** keyword where it's missing. +If you don't use the keyword **`typename`** in the function body, this code compiles under **`/permissive- /Zc:twoPhase-`**, but not under **`/permissive-`** alone. The **`typename`** keyword is required to indicate that the `TYPE` is dependent. Because the body isn't parsed under **`/Zc:twoPhase-`**, the compiler doesn't require the keyword. In **`/permissive-`** conformance mode, code without the **`typename`** keyword generates errors. To migrate your code to conformance in Visual Studio 2017 version 15.3 and beyond, insert the **`typename`** keyword where it's missing. Similarly, consider this code sample: diff --git a/docs/build/reference/zp-struct-member-alignment.md b/docs/build/reference/zp-struct-member-alignment.md index cfb89975b24..f9bd480e318 100644 --- a/docs/build/reference/zp-struct-member-alignment.md +++ b/docs/build/reference/zp-struct-member-alignment.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: /Zp (Struct Member Alignment)" title: "/Zp (Struct Member Alignment)" -ms.date: "01/08/2021" +description: "Learn more about: /Zp (Struct Member Alignment)" +ms.date: 01/08/2021 f1_keywords: ["/zp", "VC.Project.VCCLCompilerTool.StructMemberAlignment", "VC.Project.VCCLWCECompilerTool.StructMemberAlignment"] helpviewer_keywords: ["Struct Member Alignment compiler option", "Zp compiler option", "/Zp compiler option [C++]", "-Zp compiler option [C++]"] -ms.assetid: 5242f656-ed9b-48a3-bc73-cfcf3ed2520f --- # /Zp (Struct Member Alignment) diff --git a/docs/build/reference/zw-windows-runtime-compilation.md b/docs/build/reference/zw-windows-runtime-compilation.md index 6bba2c712c5..b535b3e7c78 100644 --- a/docs/build/reference/zw-windows-runtime-compilation.md +++ b/docs/build/reference/zw-windows-runtime-compilation.md @@ -1,6 +1,6 @@ --- -description: "Learn more about: /ZW (Windows Runtime Compilation)" title: "/ZW (Windows Runtime Compilation)" +description: "Learn more about: /ZW (Windows Runtime Compilation)" ms.date: 06/22/2023 f1_keywords: ["VC.Project.VCCLCompilerTool.CompileAsWinRT", "/zw"] helpviewer_keywords: ["/ZW", "-ZW compiler option", "/ZW compiler option", "-ZW", "Windows Runtime compiler option"] @@ -9,19 +9,19 @@ helpviewer_keywords: ["/ZW", "-ZW compiler option", "/ZW compiler option", "-ZW" Compiles source code to support Microsoft C++ component extensions C++/CX for the creation of Universal Windows Platform (UWP) apps. -When you use **`/ZW`** to compile, always specify **`/EHsc`** as well.\ -**`/ZW`** isn't compatible with **`/std:c++20`**. +When you use **`/ZW`** to compile, always specify [`/EHsc`](eh-exception-handling-model.md) as well.\ +**`/ZW`** isn't compatible with [`/std:c++20`](std-specify-language-standard-version.md) or later. ## Syntax -```cpp +``` /ZW /EHsc /ZW:nostdlib /EHsc ``` ## Arguments -**`nostdlib`**\ +*`nostdlib`*\ Indicates that `Platform.winmd`, `Windows.Foundation.winmd`, and other default Windows metadata (`.winmd`) files aren't automatically included in the compilation. Instead, you must use the [`/FU` (Name Forced #using File)](fu-name-forced-hash-using-file.md) compiler option to explicitly specify Windows metadata files. ## Remarks @@ -32,11 +32,9 @@ When you specify the **`/ZW`** option, the compiler supports these features: - Automatic reference-counting of Windows Runtime objects, and automatic discarding of an object when its reference count goes to zero. -Because the incremental linker doesn't support the Windows metadata included in .obj files by using the **`/ZW`** option, the deprecated [/Gm (Enable Minimal Rebuild)](gm-enable-minimal-rebuild.md) option is incompatible with **`/ZW`**. - -For more information, see [Visual C++ Language Reference](../../cppcx/visual-c-language-reference-c-cx.md). +Because the incremental linker doesn't support the Windows metadata included in `.obj` files by using the **`/ZW`** option, the deprecated [`/Gm` (Enable Minimal Rebuild)](gm-enable-minimal-rebuild.md) option is incompatible with **`/ZW`**. -## Requirements +For more information, see [C++/CX Language Reference](../../cppcx/visual-c-language-reference-c-cx.md). ## See also diff --git a/docs/build/regular-dlls-statically-linked-to-mfc.md b/docs/build/regular-dlls-statically-linked-to-mfc.md index d3d90f05184..4faae4e7bb4 100644 --- a/docs/build/regular-dlls-statically-linked-to-mfc.md +++ b/docs/build/regular-dlls-statically-linked-to-mfc.md @@ -9,7 +9,7 @@ ms.assetid: 2eed531c-726a-4b8a-b936-f721dc00a7fa A regular MFC DLL statically linked to MFC is a DLL that uses MFC internally, and the exported functions in the DLL can be called by either MFC or non-MFC executables. As the name describes, this kind of DLL is built using the static link library version of MFC. Functions are usually exported from a regular MFC DLL using the standard C interface. For an example of how to write, build, and use a regular MFC DLL, see the sample [DLLScreenCap](https://github.com/Microsoft/VCSamples/tree/master/VC2010Samples/MFC/advanced/DllScreenCap). -Note that the term USRDLL is no longer used in the Visual C++ documentation. A regular MFC DLL that is statically linked to MFC has the same characteristics as the former USRDLL. +Note that the term USRDLL is no longer used in the Microsoft C++ documentation. A regular MFC DLL that is statically linked to MFC has the same characteristics as the former USRDLL. A regular MFC DLL, statically linked to MFC, has the following features: diff --git a/docs/build/run-time-library-behavior.md b/docs/build/run-time-library-behavior.md index 1a85ae8d849..ad23da72e29 100644 --- a/docs/build/run-time-library-behavior.md +++ b/docs/build/run-time-library-behavior.md @@ -1,5 +1,5 @@ --- -description: "Learn more about: DLLs and Visual C++ run-time library behavior" +description: "Learn more about: DLLs and Microsoft C++ run-time library behavior" title: "DLLs and Visual C++ run-time library behavior" ms.date: "08/19/2019" f1_keywords: ["_DllMainCRTStartup", "CRT_INIT"] diff --git a/docs/build/specifying-build-events.md b/docs/build/specifying-build-events.md index 5490fb70902..25f79a10762 100644 --- a/docs/build/specifying-build-events.md +++ b/docs/build/specifying-build-events.md @@ -5,6 +5,7 @@ ms.date: "12/28/2017" f1_keywords: ["VC.Project.IVCEventTool.CommandLine", "VC.Project.IVCEventTool.ExcludedFromBuild", "VC.Project.IVCEventTool.Description"] helpviewer_keywords: ["Pre-Link event", "build events [C++], specifying", "custom build steps [C++], build events", "builds [C++], events", "events [C++], build", "builds [C++], customizing C++", "build events [C++]", "post-build events"] ms.assetid: 788a6c18-2dbe-4a49-8cd6-86c1ad7a95cc +ms.topic: how-to --- # Specifying build events diff --git a/docs/build/specifying-custom-build-tools.md b/docs/build/specifying-custom-build-tools.md index 197908e3e4a..251433fada8 100644 --- a/docs/build/specifying-custom-build-tools.md +++ b/docs/build/specifying-custom-build-tools.md @@ -4,6 +4,7 @@ title: "Specifying Custom Build Tools" ms.date: "06/05/2018" f1_keywords: ["VC.Project.VCCustomBuildTool.CustomBuildToolBeforeTargets", "VC.Project.VCCustomBuildTool.Outputs", "VC.Project.VCCustomBuildTool.Command", "VC.Project.VCCustomBuildTool.CommandLine", "VC.Project.VCCustomBuildTool.AdditionalDependencies", "VC.Project.VCCustomBuildTool.Message", "VC.Project.VCCustomBuildTool.CustomBuildToolAfterTargets", "VC.Project.VCCustomBuildTool.Description", "VC.Project.VCCustomBuildTool.AdditionalInputs"] helpviewer_keywords: ["build tools (C++), specifying", "custom build tools (C++), specifying", "builds (C++), custom build tools"] +ms.topic: how-to --- # Specify custom build tools diff --git a/docs/build/stack-usage.md b/docs/build/stack-usage.md index 8bbec4908e8..59c102e5ec9 100644 --- a/docs/build/stack-usage.md +++ b/docs/build/stack-usage.md @@ -1,8 +1,7 @@ --- -description: "Learn more about: x64 stack usage" title: "x64 stack usage" -ms.date: "12/17/2018" -ms.assetid: 383f0072-0438-489f-8829-cca89582408c +description: "Learn more about: x64 stack usage" +ms.date: 12/17/2018 --- # x64 stack usage @@ -42,7 +41,7 @@ A leaf function is one that does not require a function table entry. It can't ma ## malloc alignment -[malloc](../c-runtime-library/reference/malloc.md) is guaranteed to return memory that's suitably aligned for storing any object that has a fundamental alignment and that could fit in the amount of memory that's allocated. A *fundamental alignment* is an alignment that's less than or equal to the largest alignment that's supported by the implementation without an alignment specification. (In Visual C++, this is the alignment that's required for a **`double`**, or 8 bytes. In code that targets 64-bit platforms, it's 16 bytes.) For example, a four-byte allocation would be aligned on a boundary that supports any four-byte or smaller object. +[malloc](../c-runtime-library/reference/malloc.md) is guaranteed to return memory that's suitably aligned for storing any object that has a fundamental alignment and that could fit in the amount of memory that's allocated. A *fundamental alignment* is an alignment that's less than or equal to the largest alignment that's supported by the implementation without an alignment specification. (In Microsoft C++, this is the alignment that's required for a **`double`**, or 8 bytes. In code that targets 64-bit platforms, it's 16 bytes.) For example, a four-byte allocation would be aligned on a boundary that supports any four-byte or smaller object. Visual C++ permits types that have *extended alignment*, which are also known as *over-aligned* types. For example, the SSE types [__m128](../cpp/m128.md) and `__m256`, and types that are declared by using `__declspec(align( n ))` where `n` is greater than 8, have extended alignment. Memory alignment on a boundary that's suitable for an object that requires extended alignment is not guaranteed by `malloc`. To allocate memory for over-aligned types, use [_aligned_malloc](../c-runtime-library/reference/aligned-malloc.md) and related functions. diff --git a/docs/build/toc.yml b/docs/build/toc.yml index 0f5f89200af..57a47a03ffb 100644 --- a/docs/build/toc.yml +++ b/docs/build/toc.yml @@ -9,7 +9,7 @@ items: - name: Set C++ compiler and build properties in Visual Studio expanded: false items: - - name: Set C++ compiler and build properties in Visual Studio + - name: Set C++ compiler and build properties href: ../build/working-with-project-properties.md - name: Share or reuse Visual Studio project settings href: ../build/create-reusable-property-configurations.md @@ -83,7 +83,7 @@ items: - name: "Header units" expanded: false items: - - name: "Walkthrough: Build and import header units in Visual C++ projects" + - name: "Walkthrough: Build and import header units in Microsoft C++ projects" href: ../build/walkthrough-header-units.md - name: "Walkthrough: Import STL libraries as header units" href: ../build/walkthrough-import-stl-header-units.md @@ -408,7 +408,7 @@ items: - name: Command line property pages href: ../build/reference/command-line-property-pages.md - name: NMake property page - href: ../build/reference/nmake-property-page.md + href: ../build/reference/nmake-property-page.md - name: Manifest Tool property pages href: ../build/reference/manifest-tool-property-pages.md - name: Resources property pages @@ -552,7 +552,7 @@ items: href: ../build/reference/fp-name-dot-pch-file.md - name: /FR, /Fr (Create .Sbr file) href: ../build/reference/fr-fr-create-dot-sbr-file.md - - name: /FU (Name forced + - name: "/FU (Name forced #using file)" href: ../build/reference/fu-name-forced-hash-using-file.md - name: /Fx (Merge injected code) href: ../build/reference/fx-merge-injected-code.md @@ -562,6 +562,9 @@ items: href: ../build/reference/fc-full-path-of-source-code-file-in-diagnostics.md - name: /feature (Enable architecture features) href: ../build/reference/feature-arm64.md + - name: /forceInterlockedFunctions (Generate and link with out-of-line atomic + functions) + href: ./reference/force-interlocked-functions.md - name: /fp (Specify floating-point behavior) href: ../build/reference/fp-specify-floating-point-behavior.md - name: /fpcvt (Floating-point to unsigned integer conversion behavior) @@ -1178,7 +1181,7 @@ items: href: ../build/reference/nmake-reference.md - name: NMAKE projects in Visual Studio href: ../build/reference/creating-a-makefile-project.md - - name: Running NMAKE + - name: Running NMAKE href: ../build/reference/running-nmake.md - name: Makefile contents and features href: ../build/reference/contents-of-a-makefile.md diff --git a/docs/build/troubleshooting-build-customizations.md b/docs/build/troubleshooting-build-customizations.md index a7608815cf8..f97a61e9d37 100644 --- a/docs/build/troubleshooting-build-customizations.md +++ b/docs/build/troubleshooting-build-customizations.md @@ -4,6 +4,7 @@ title: "Troubleshooting Build Customizations" ms.date: "11/04/2016" helpviewer_keywords: ["build events [C++], troubleshooting", "builds [C++], build events", "troubleshooting [C++], builds", "build steps [C++], troubleshooting", "events [C++], build", "builds [C++], troubleshooting", "custom build steps [C++], troubleshooting"] ms.assetid: e4ceb177-fbee-4ed3-a7d7-80f0d78c1d07 +ms.topic: troubleshooting-general --- # Troubleshooting Build Customizations diff --git a/docs/build/troubleshooting-c-cpp-isolated-applications-and-side-by-side-assemblies.md b/docs/build/troubleshooting-c-cpp-isolated-applications-and-side-by-side-assemblies.md index cef9d627e62..77c17b97ece 100644 --- a/docs/build/troubleshooting-c-cpp-isolated-applications-and-side-by-side-assemblies.md +++ b/docs/build/troubleshooting-c-cpp-isolated-applications-and-side-by-side-assemblies.md @@ -4,6 +4,7 @@ title: "Troubleshooting C/C++ Isolated Applications and Side-by-side Assemblies" ms.date: "11/04/2016" helpviewer_keywords: ["troubleshooting side-by-side assemblies", "troubleshooting isolated applications", "troubleshooting Visual C++"] ms.assetid: 3257257a-1f0b-4ede-8564-9277a7113a35 +ms.topic: troubleshooting-general --- # Troubleshooting C/C++ Isolated Applications and Side-by-side Assemblies @@ -23,7 +24,7 @@ If your application has no manifest and depends on a DLL that Windows can't find If your application is deployed on a computer that doesn't have Visual Studio, and it crashes with error messages that resemble the previous ones, check these things: -1. Follow the steps that are described in [Understanding the Dependencies of a Visual C++ Application](../windows/understanding-the-dependencies-of-a-visual-cpp-application.md). The dependency walker can show most dependencies for an application or DLL. If you observe that some DLLs are missing, install them on the computer on which you are trying to run your application. +1. Follow the steps that are described in [Understanding the Dependencies of a Microsoft C++ Application](../windows/understanding-the-dependencies-of-a-visual-cpp-application.md). The dependency walker can show most dependencies for an application or DLL. If you observe that some DLLs are missing, install them on the computer on which you are trying to run your application. 1. The operating system loader uses the application manifest to load assemblies that the application depends on. The manifest can either be embedded in the binary as a resource, or installed as a separate file in the application folder. To check whether the manifest is embedded in the binary, open the binary in Visual Studio and look for RT_MANIFEST in its list of resources. If you can't find an embedded manifest, look in the application folder for a file that's named something like .\.manifest. @@ -40,7 +41,7 @@ If your application is deployed on a computer that doesn't have Visual Studio, a ## Example -Assume we have an application, appl.exe, that's built by using Visual C++. The application manifest either is embedded in appl.exe as the binary resource RT_MANIFEST, which has an ID equal to 1, or is stored as the separate file appl.exe.manifest. The content of this manifest resembles this: +Assume we have an application, appl.exe, that's built using Microsoft C++ Build Tools. The application manifest either is embedded in appl.exe as the binary resource RT_MANIFEST, which has an ID equal to 1, or is stored as the separate file appl.exe.manifest. The content of this manifest resembles this: ``` diff --git a/docs/build/understanding-custom-build-steps-and-build-events.md b/docs/build/understanding-custom-build-steps-and-build-events.md index e468fb7224c..78632dad4e1 100644 --- a/docs/build/understanding-custom-build-steps-and-build-events.md +++ b/docs/build/understanding-custom-build-steps-and-build-events.md @@ -4,10 +4,11 @@ title: "Understanding Custom Build Steps and Build Events" ms.date: "08/29/2019" helpviewer_keywords: ["builds [C++], events", "custom build steps [C++], customizing builds", "events [C++], build", "custom build steps [C++]", "build steps [C++]", "build events [C++], order of events and build steps", "build steps [C++], build events", "builds [C++], custom build steps"] ms.assetid: beb2f017-3e9f-4b2c-9b57-2572fd2628e4 +ms.topic: how-to --- # Understanding Custom Build Steps and Build Events -From within the Visual C++ development environment, there are three basic ways to customize the build process: +Within the C++ development environment, there are three basic ways to customize the build process: - **Custom Build Steps** diff --git a/docs/build/understanding-manifest-generation-for-c-cpp-programs.md b/docs/build/understanding-manifest-generation-for-c-cpp-programs.md index 9caa9820971..0db61f8486a 100644 --- a/docs/build/understanding-manifest-generation-for-c-cpp-programs.md +++ b/docs/build/understanding-manifest-generation-for-c-cpp-programs.md @@ -1,15 +1,15 @@ --- -description: "Learn more about: Understanding manifest generation for C/C++ programs" title: "Understanding manifest generation for C/C++ programs" +description: "Learn more about: Understanding manifest generation for C/C++ programs" ms.date: 06/10/2022 helpviewer_keywords: ["manifests [C++]"] -ms.assetid: a1f24221-5b09-4824-be48-92eae5644b53 +ms.topic: how-to --- # Understanding manifest generation for C/C++ programs A [manifest](/windows/win32/sbscs/manifests) is an XML document that uniquely identifies an assembly. It contains information used for binding and activation, such as COM classes, interfaces, and type libraries. A manifest can be an external XML file or a resource embedded inside an application or an assembly. The manifest of an [isolated application](/windows/win32/SbsCs/isolated-applications) is used to manage the names and versions of shared side-by-side assemblies the application should bind to at run time. The manifest of a side-by-side assembly specifies its dependencies on names, versions, resources, and other assemblies. -There are two ways to create a manifest for an isolated application or a side-by-side assembly. First, the author of the assembly can manually create a manifest file by following the rules and naming requirements. For more information, see [Manifest files reference](/windows/win32/sbscs/manifest-files-reference). Alternatively, if a program only depends on MSVC assemblies such as CRT, MFC, ATL or others, then the linker can generate a manifest automatically. +There are two ways to create a manifest for an isolated application or a side-by-side assembly. First, the author of the assembly can manually create a manifest file by following the rules and naming requirements. For more information, see [Manifest files reference](/windows/win32/sbscs/manifest-files-reference). Alternatively, if a program only depends on Microsoft C++ (MSVC) assemblies such as CRT, MFC, ATL or others, then the linker can generate a manifest automatically. The headers of MSVC libraries contain assembly information, and when the libraries are included in application code, this assembly information is used by the linker to form a manifest for the final binary. By default, the linker doesn't embed the manifest file inside the binary. Having a manifest as an external file may not work for all scenarios. For example, it's recommended that private assemblies have embedded manifests. In command line builds such as ones that use NMAKE to build code, you can use the [`/MANIFEST:EMBED`](./reference/manifest-create-side-by-side-assembly-manifest.md) linker option to embed the manifest. Alternatively, a manifest can be embedded using the manifest tool. For more information, see [Manifest generation at the command line](#manifest-generation-at-the-command-line). When you build in Visual Studio, a manifest can be embedded by setting a property for the manifest tool in the **Project Properties** dialog, as described in the next section. @@ -29,7 +29,7 @@ The build system in Visual Studio allows the manifest to be embedded in the fina 1. If the manifest embedded in the binary is the same as the manifest generated by the manifest tool, the build continues to the next build steps. -The manifest is embedded inside the final binary as a text resource. You can view it by opening the final binary as a file in Visual Studio. To ensure that the manifest points to the correct libraries, follow the steps described in [Understanding the dependencies of a Visual C++ application](../windows/understanding-the-dependencies-of-a-visual-cpp-application.md). Or, follow the suggestions described in the [Troubleshooting](troubleshooting-c-cpp-isolated-applications-and-side-by-side-assemblies.md) article. +The manifest is embedded inside the final binary as a text resource. You can view it by opening the final binary as a file in Visual Studio. To ensure that the manifest points to the correct libraries, follow the steps described in [Understanding the dependencies of a Microsoft C++ application](../windows/understanding-the-dependencies-of-a-visual-cpp-application.md). Or, follow the suggestions described in the [Troubleshooting](troubleshooting-c-cpp-isolated-applications-and-side-by-side-assemblies.md) article. ## Manifest generation at the command line @@ -181,7 +181,7 @@ clean : #^^^^^^^^^^^^^^^^^^^^^^^^^ Change #4. (Add full path if necessary.) ``` -The makefiles now include two files that do the real work,*` makefile.inc`* and *`makefile.target.inc`*. +The makefiles now include two files that do the real work, *`makefile.inc`* and *`makefile.target.inc`*. Create *`makefile.inc`* and copy the following content into it: diff --git a/docs/build/use-github-copilot-create-cpp-console-app.md b/docs/build/use-github-copilot-create-cpp-console-app.md new file mode 100644 index 00000000000..ab3637cfa2b --- /dev/null +++ b/docs/build/use-github-copilot-create-cpp-console-app.md @@ -0,0 +1,251 @@ +--- +title: Use AI to create a C++ console application in Visual Studio +description: "Learn how to use GitHub Copilot to create a C++ app using Microsoft C++ in Visual Studio." +ms.date: 10/24/2025 +ms.topic: "tutorial" +ms.collection: ce-skilling-ai-copilot +ms.custom: + - ai-assisted + - copilot-scenario-highlight +ms.update-cycle: 180-days +--- + +# Use AI to create a C++ console application in Visual Studio + +This tutorial shows you how to use GitHub Copilot to quickly create a C++ console application in Visual Studio. You create a console version of Conway's Game of Life, a classic cellular automaton. + +Conway's Game of Life was devised by mathematician John Conway. It consists of a grid of cells that can be either alive or dead. The game evolves automatically based on simple rules and produces complex, evolving patterns that demonstrate how intricate behavior can emerge from basic mathematical rules. + +GitHub Copilot is an AI-powered coding assistant that helps you write code faster, reduce errors, and explore new solutions. Some benefits of using Copilot when coding in C++: +- Generate entire C++ functions or classes as you type. +- Suggest code completions based on plain-language comments or prompts. +- Get help with complex algorithms, data structures, and standard library usage. +- Learn new APIs and modern C++ patterns through in-context examples. +- Receive context-aware suggestions based on your comments or code. +- Debug errors in your code. +- Simplify and refactor existing code. + +## Prerequisites + +- Visual Studio 2022 or later with the **Desktop development with C++** workload installed. +- GitHub Copilot. For more information, see [Get started with GitHub Copilot](/visualstudio/ide/visual-studio-github-copilot-get-started). + +To verify you have the C++ workload installed: +1. Open Visual Studio Installer +1. Select **Modify** next to your Visual Studio installation +1. Ensure **Desktop development with C++** is checked: + + :::image type="content" source="media/desktop-development-cpp-workload.png" alt-text="Screenshot of the Visual Studio Installer with the Workloads tab selected. Desktop development with c++ is selected."::: + +1. If it isn't installed, select it and choose **Modify**. + +For more information about installing Copilot, see [Manage GitHub Copilot installation and state](/visualstudio/ide/visual-studio-github-copilot-install-and-states). + +## Create a project + +Visual Studio uses *projects* to organize the code for an app, and *solutions* to organize your projects. A project contains all the options, configurations, and rules used to build your apps. It manages the relationship between all the project's files and any external files. To create your app, first, create a new project and solution. + +1. Open Visual Studio and select **Create a new project**. +1. Search for "Console App" and select the **Console App** template for C++. + + :::image type="complex" source="media/vs2019-choose-console-app.png" alt-text="Screenshot of the Create a new project dialog."::: + The Create a new project dialog is shown with the Console App template selected. The template says: Run code in a windows terminal. Prints hello world by default. Has the tags c++, Windows, and Console. + :::image-end::: + +1. Select **Next**. +1. Set the project name to **Life** and choose the location for the project. +1. Select **Create**. +1. Once the project opens, find the `Life.cpp` file in Solution Explorer. +1. Open `Life.cpp` and delete the default "Hello, World!" code to start with a clean slate. + +## Use Copilot to create an app + +You prompt Copilot by describing the functionality you want. In this section, you'll learn how to prompt Copilot to generate an implementation of Conway's Game of Life. + +1. Open the Copilot chat window by selecting the Copilot icon in the toolbar: + + :::image type="content" source="media/github-copilot-open-chat.png" alt-text="Screenshot of the GitHub icon dropdown. Open Chat Window is selected."::: + +1. In the chat window, enter the following prompt: + ```copilot-prompt + Create a C++ console application that implements Conway's Game of Life. The program should: + - Use a 40x20 grid displayed with asterisks (*) for live cells and spaces for dead cells + - Start with a random initial pattern + - Display each generation for 500ms before showing the next + - Allow the user to press any key to exit the program + - Include proper headers and use standard C++ practices + - Clear the console between generations to provide an animation effect + ``` +1. Copilot generates C++ code for Conway's Game of Life. +1. Copy the generated code and paste it into your empty `Life.cpp` file. +1. Build the project by pressing **F6** or selecting **Build > Build Solution**. +1. Run the program by pressing **F5** or **Ctrl+F5**. + +> [!NOTE] +> The exact code generated by Copilot may vary slightly from run to run and model to model, but the core functionality should be consistent. If the generated code doesn't compile immediately, you can ask Copilot to fix any compilation errors. Copilot is powered by AI, so surprises and mistakes are possible. For more information, see [Copilot FAQs](https://aka.ms/copilot-general-use-faqs). + +### Example of typical generated code structure + +Your generated code will likely include these key components: + +- Headers for console manipulation, random number generation, and timing +- A 2D array or vector to represent the game grid +- Functions to initialize the grid, apply Conway's rules, and display the current state +- A main loop that continues until a key is pressed + +Here's an example of the code that Copilot generated using the previous prompt: + +```cpp +// Code generated by GitHub Copilot +#include +#include +#include +#include // for _kbhit and _getch + +using namespace std; + +int step = 0; +const int rows = 20; +const int cols = 40; + +void printGrid(int grid[rows][cols]) +{ + cout << "Step: " << step << endl; + for (int i = 0; i < rows; ++i) + { + for (int j = 0; j < cols; ++j) + { + cout << (grid[i][j] ? '*' : ' '); + } + cout << endl; + } +} + +int countNeighbors(int grid[rows][cols], int x, int y) +{ + int count = 0; + for (int i = -1; i <= 1; ++i) + { + for (int j = -1; j <= 1; ++j) + { + if (i == 0 && j == 0) + { + continue; + } + + int ni = x + i; + int nj = y + j; + if (ni >= 0 && ni < rows && nj >= 0 && nj < cols) + { + count += grid[ni][nj]; + } + } + } + return count; +} + +void updateGrid(int grid[rows][cols]) +{ + int newGrid[rows][cols] = { 0 }; + for (int i = 0; i < rows; ++i) + { + for (int j = 0; j < cols; ++j) + { + int neighbors = countNeighbors(grid, i, j); + if (grid[i][j] == 1) + { + newGrid[i][j] = (neighbors < 2 || neighbors > 3) ? 0 : 1; + } + else + { + newGrid[i][j] = (neighbors == 3) ? 1 : 0; + } + } + } + // Copy newGrid back to grid + for (int i = 0; i < rows; ++i) + { + for (int j = 0; j < cols; ++j) + { + grid[i][j] = newGrid[i][j]; + } + } +} + +int main() +{ + int grid[rows][cols] = { 0 }; + + // Initial configuration (a simple glider) + grid[1][2] = 1; + grid[2][3] = 1; + grid[3][1] = 1; + grid[3][2] = 1; + grid[3][3] = 1; + + while (true) + { + if (_kbhit()) // Check if a key has been pressed + { + _getch(); // Consume the key + break; // Exit the loop + } + printGrid(grid); + updateGrid(grid); + std::this_thread::sleep_for(std::chrono::milliseconds(100)); + cout << "\033[H\033[J"; // Clear the screen + step++; + } + + return 0; +} +``` +When you run the application, you should see an animated display of Conway's Game of Life with patterns evolving over time. To exit the program, press a key. + +:::image type="content" source="./media/life-exe.png" alt-text="Screenshot of Conway Life running in a command window, displaying the evolving grid of cells."::: + +In the preceding code example, the code generates a warning: `Return value ignored: '_getch'`. You can ask Copilot to fix it. Select the code editor and press **Alt+/** (Windows) to open the Copilot chat, then enter: + +:::image type="content" source="./media/github-copilot-fix-warning.png" alt-text="Screenshot of the Copilot chat window. The text: Fix warning C6031 is in the chat window."::: + +Copilot suggests a fix to handle the return value properly. To accept the changes, select **Tab**: + +:::image type="content" source="./media/github-copilot-fix-warning-accept.png" alt-text="Screenshot of the Copilot proposed changes. Tab to accept. Alt+Del to discard."::: + +Congratulations! You successfully used GitHub Copilot to create a fully functional Conway's Game of Life console application in C++. You learned how to: + +- Craft an effective prompt to generate C++ code +- Use Copilot's chat interface to create an entire application from scratch +- Fix compilation warnings with AI assistance + +## Improve your prompting skills + +For better results with Copilot, see these prompting resources: + +- [GitHub Copilot documentation](https://docs.github.com/en/copilot) - Official best practices and tips +- [OpenAI's GPT best practices](https://platform.openai.com/docs/guides/prompt-engineering) - General AI prompting techniques +- [Copilot prompting guide](https://github.blog/2023-06-20-how-to-write-better-prompts-for-github-copilot/) - Specific guidance for code generation + +## Troubleshooting + +### Missing console app template + +The **New Project** dialog should show a **Console App** template that has **C++**, **Windows**, and **Console** tags. If you don't see it, it might be filtered out of the list, or it might not be installed. First, check the filter dropdowns at the top of the list of templates. Set them to **C++**, **Windows**, and **Console**. The C++ **Console App** template should appear; otherwise, the **Desktop development with C++** workload isn't installed. + +To install **Desktop development with C++**, you can run the installer right from the **Create a new project** dialog. Choose the **Install more tools and features** link at the bottom of the **Create a new project** dialog, beneath the list of templates. If the **User Account Control** dialog requests permissions, choose **Yes**. In the installer, make sure the **Desktop development with C++** workload is checked. Then choose **Modify** to update your Visual Studio installation. + +### Copilot not responding + +- Ensure you have an active GitHub Copilot subscription. +- Try signing out and back into your GitHub account in Visual Studio + +### Generated code doesn't compile + +- Ask Copilot to fix specific compilation errors by pasting the error message into Copilot chat. +- Try refining your prompt to be more specific about what you want the app to do. + +## Next steps + +- [GitHub Copilot in Visual Studio](/visualstudio/ide/visual-studio-github-copilot-install-and-states) +- [GitHub Copilot documentation](https://docs.github.com/en/copilot) - Dive deeper into AI-assisted development +- [Awesome ChatGPT Prompts](https://github.com/f/awesome-chatgpt-prompts) - Community-driven prompting examples for inspiration \ No newline at end of file diff --git a/docs/build/using-database-ole-and-sockets-extension-dlls-in-regular-dlls.md b/docs/build/using-database-ole-and-sockets-extension-dlls-in-regular-dlls.md index 72f1bb24f21..08d3cbd88f5 100644 --- a/docs/build/using-database-ole-and-sockets-extension-dlls-in-regular-dlls.md +++ b/docs/build/using-database-ole-and-sockets-extension-dlls-in-regular-dlls.md @@ -3,6 +3,7 @@ title: "Using Database, OLE, and Sockets MFC extension DLLs in regular MFC DLLs" description: "Shows how to use the Database, OLE, and Sockets MFC extension DLLs in regular MFC DLLs." ms.date: 11/30/2020 helpviewer_keywords: ["DLLs [C++], initializing", "DLLs [C++], extension", "DLLs [C++], regular"] +ms.topic: concept-article --- # Using Database, OLE, and Sockets MFC extension DLLs in regular MFC DLLs diff --git a/docs/build/using-function-name-without-parens-produces-no-code.md b/docs/build/using-function-name-without-parens-produces-no-code.md index 29d218d3c2d..8b08e80798e 100644 --- a/docs/build/using-function-name-without-parens-produces-no-code.md +++ b/docs/build/using-function-name-without-parens-produces-no-code.md @@ -4,6 +4,7 @@ title: "Using Function Name Without () Produces No Code" ms.date: "11/04/2016" helpviewer_keywords: ["functions [C++], without parentheses"] ms.assetid: edf4a177-a160-44aa-8436-e077b5b27809 +ms.topic: concept-article --- # Using Function Name Without () Produces No Code diff --git a/docs/build/using-the-debug-build-to-check-for-memory-overwrite.md b/docs/build/using-the-debug-build-to-check-for-memory-overwrite.md index d7d94003455..36aae3bdec7 100644 --- a/docs/build/using-the-debug-build-to-check-for-memory-overwrite.md +++ b/docs/build/using-the-debug-build-to-check-for-memory-overwrite.md @@ -4,6 +4,7 @@ title: "Using the Debug Build to Check for Memory Overwrite" ms.date: "11/04/2016" helpviewer_keywords: ["memory, overwrites"] ms.assetid: 1345eb4d-24ba-4595-b1cc-2da66986311e +ms.topic: how-to --- # Using the Debug Build to Check for Memory Overwrite diff --git a/docs/build/using-verify-instead-of-assert.md b/docs/build/using-verify-instead-of-assert.md index 225a1f9d07f..f9e9350bc05 100644 --- a/docs/build/using-verify-instead-of-assert.md +++ b/docs/build/using-verify-instead-of-assert.md @@ -4,6 +4,7 @@ title: "Using VERIFY Instead of ASSERT" ms.date: "05/06/2019" helpviewer_keywords: ["ASSERT statements", "debugging [MFC], ASSERT statements", "VERIFY macro", "assertions, troubleshooting ASSERT statements", "debugging assertions", "assertions, debugging"] ms.assetid: 4c46397b-3fb1-49c1-a09b-41a72fae3797 +ms.topic: concept-article --- # Using VERIFY Instead of ASSERT diff --git a/docs/build/vscpp-step-0-installation.md b/docs/build/vscpp-step-0-installation.md index 59fc3131c8d..903016883ab 100644 --- a/docs/build/vscpp-step-0-installation.md +++ b/docs/build/vscpp-step-0-installation.md @@ -1,29 +1,33 @@ --- title: Install C and C++ support in Visual Studio -description: "Learn how to install Visual Studio with support for Microsoft C/C++ and related workloads." -ms.custom: vs-acquisition, intro-installation -ms.date: 11/08/2021 -ms.topic: "tutorial" +description: "Learn how to install Visual Studio with support for Microsoft C and C++ and related workloads." +ms.date: 09/09/2025 +ms.topic: tutorial ms.devlang: "cpp" +ms.custom: + - vs-acquisition + - intro-installation + - sfi-image-nochange + - copilot-scenario-highlight --- # Install C and C++ support in Visual Studio -If you haven't downloaded and installed Visual Studio and the Microsoft C/C++ tools yet, here's how to get started. +If you haven't installed Visual Studio and the Microsoft C and C++ tools yet, here's how to get started. ::: moniker range="msvc-170" -## Visual Studio 2022 Installation +## Visual Studio 2022 installation -Welcome to Visual Studio 2022! In this version, it's easy to choose and install just the features you need. And because of its reduced minimum footprint, it installs quickly and with less system impact. +Welcome to Visual Studio 2022! In this version, it's easy to choose and install just the features you need. Because of its reduced minimum footprint, Visual Studio installs quickly and with less system impact. > [!NOTE] -> This topic applies to installation of Visual Studio on Windows. [Visual Studio Code](https://code.visualstudio.com/) is a lightweight, cross-platform development environment that runs on Windows, Mac, and Linux systems. The Microsoft [C/C++ for Visual Studio Code](https://marketplace.visualstudio.com/items?itemName=ms-vscode.cpptools) extension supports IntelliSense, debugging, code formatting, auto-completion. Visual Studio for Mac doesn't support Microsoft C++, but does support .NET languages and cross-platform development. For installation instructions, see [Install Visual Studio for Mac](/visualstudio/mac/installation/). +> This article applies to installation of Visual Studio on Windows. [Visual Studio Code](https://code.visualstudio.com) is a lightweight, cross-platform development environment that runs on Windows, Mac, and Linux systems. The Microsoft [C/C++ for Visual Studio Code](https://marketplace.visualstudio.com/items?itemName=ms-vscode.cpptools) extension supports IntelliSense, debugging, code formatting, autocompletion. Visual Studio for Mac doesn't support Microsoft C++, but does support .NET languages and cross-platform development. For installation instructions, see [Install Visual Studio for Mac](/visualstudio/mac/installation/). -Want to know more about what else is new in this version? See the Visual Studio [release notes](/visualstudio/releases/2022/release-notes/). +To learn what else is new in this version, see the Visual Studio [release notes](/visualstudio/releases/2022/release-notes/). -Ready to install? We walk you through it, step-by-step. +Ready to install? Use the following step-by-step guide. -### Step 1 - Make sure your computer is ready for Visual Studio +### Step 1 - Prepare your computer for Visual Studio Before you begin installing Visual Studio: @@ -31,28 +35,27 @@ Before you begin installing Visual Studio: 1. Apply the latest Windows updates. These updates ensure that your computer has both the latest security updates and the required system components for Visual Studio. -1. Reboot. The reboot ensures that any pending installs or updates don't hinder the Visual Studio install. +1. Reboot your computer. The reboot ensures that any pending installs or updates don't hinder the Visual Studio install. -1. Free up space. Remove unneeded files and applications from your %SystemDrive% by, for example, running the Disk Cleanup app. +1. Free up disk space. Remove unneeded files and applications from your %SystemDrive% by, for example, running the Disk Cleanup app. For questions about running previous versions of Visual Studio side by side with Visual Studio 2022, see the [Visual Studio 2022 Platform Targeting and Compatibility](/visualstudio/releases/2022/compatibility/) page. ### Step 2 - Download Visual Studio -Next, download the Visual Studio bootstrapper file. To do so, choose the following button to go to the Visual Studio download page. Select the edition of Visual Studio that you want and choose the **Free trial** or **Free download** button. +Select the following button to go to the Visual Studio download page, and download the Visual Studio bootstrapper file. Select the edition of Visual Studio that you want and choose the **Free trial** or **Free download** button. - > [!div class="button"] - > [Download Visual Studio](https://visualstudio.microsoft.com/downloads/) +> [!div class="button"] +> [Download Visual Studio](https://visualstudio.microsoft.com/downloads/) -### Step 3 - Install the Visual Studio installer +>[!TIP] +> The Community edition is for individual developers, classroom learning, academic research, and open source development. For other uses, install Visual Studio 2022 Professional or Visual Studio 2022 Enterprise. -Run the bootstrapper file you downloaded to install the Visual Studio Installer. This new lightweight installer includes everything you need to both install and customize Visual Studio. +### Step 3 - Install the Visual Studio Installer -1. From your **Downloads** folder, double-click the bootstrapper that matches or is similar to one of the following files: +Run the bootstrapper file you downloaded to install the Visual Studio Installer. This new lightweight installer includes everything you need to both install and customize Visual Studio. - - **vs_community.exe** for Visual Studio Community - - **vs_professional.exe** for Visual Studio Professional - - **vs_enterprise.exe** for Visual Studio Enterprise +1. From your *Downloads* folder, double-click the bootstrapper file called *VisualStudioSetup.exe*. If you receive a User Account Control notice, choose **Yes** to allow the bootstrapper to run. @@ -60,40 +63,40 @@ Run the bootstrapper file you downloaded to install the Visual Studio Installer. ### Step 4 - Choose workloads -After the installer is installed, you can use it to customize your installation by selecting the *workloads*, or feature sets, that you want. Here's how. +You can use the installer to customize your installation by selecting the *workloads*, or feature sets, that you want. 1. Find the workload you want in the **Installing Visual Studio** screen. - :::image type="content" source="../get-started/media/vs2022-installer-workloads.png" alt-text="Visual studio installer with the Desktop development with C++ workload selected." lightbox="../get-started/media/vs2022-installer-workloads.png"::: + :::image type="content" source="../get-started/media/vs2022-installer-workloads.png" alt-text="Screenshot of the Visual Studio 2022 installer with the Desktop development with C plus plus workload selected." lightbox="../get-started/media/vs2022-installer-workloads.png"::: - For core C and C++ support, choose the "Desktop development with C++" workload. It comes with the default core editor, which includes basic code editing support for over 20 languages, the ability to open and edit code from any folder without requiring a project, and integrated source code control. - - Other workloads support more kinds of development. For example, choose the "Universal Windows Platform development" workload to create apps that use the Windows Runtime for the Microsoft Store. Choose "Game development with C++" to create games that use DirectX, Unreal, and Cocos2d. Choose "Linux development with C++" to target Linux platforms, including IoT development. + For core C and C++ support, choose the **Desktop development with C++** workload. It comes with the default core editor, which includes basic code editing support for more than 20 languages, the ability to open and edit code from any folder without requiring a project, and integrated source code control. The **Installation details** pane lists the included and optional components installed by each workload. You can select or deselect optional components in this list. For example, to support development by using the Visual Studio 2017 or 2015 compiler toolsets, choose the MSVC v141 or MSVC v140 optional components. You can add support for MFC, the experimental Modules language extension, IncrediBuild, and more. -1. After you choose the workload(s) and optional components you want, choose **Install**. + Other workloads support more kinds of development. For example, choose the **Universal Windows Platform development** workload to create apps that use the Windows Runtime for the Microsoft Store. Choose **Game development with C++** to create games that use DirectX, Unreal, or Cocos2d. Choose **Linux development with C++** to target Linux platforms, including IoT development. + +1. After you choose the workloads and optional components you want, choose **Install**. Next, status screens appear that show the progress of your Visual Studio installation. > [!TIP] > At any time after installation, you can install workloads or components that you didn't install initially. If you have Visual Studio open, go to **Tools** > **Get Tools and Features...** which opens the Visual Studio Installer. Or, open **Visual Studio Installer** from the Start menu. From there, you can choose the workloads or components that you wish to install. Then, choose **Modify**. -### Step 5 - Choose individual components (Optional) +### Step 5 - Choose individual components (optional) If you don't want to use the Workloads feature to customize your Visual Studio installation, or you want to add more components than a workload installs, you can do so by installing or adding individual components from the **Individual components** tab. Choose what you want, and then follow the prompts. -### Step 6 - Install language packs (Optional) +### Step 6 - Install language packs (optional) By default, the installer program tries to match the language of the operating system when it runs for the first time. To install Visual Studio in a language of your choosing, choose the **Language packs** tab from the Visual Studio Installer, and then follow the prompts. - :::image type="content" source="../get-started/media/vs-installer-language-packs.png" alt-text="Screenshot of the Visual Studio Installer, showing the Install language packs tab view and the languages you can choose from like English, Spanish, Chinese (simplified or traditional), and more." lightbox="../get-started/media/vs-installer-language-packs.png"::: + :::image type="content" source="../get-started/media/vs-installer-language-packs.png" alt-text="Screenshot of the Visual Studio Installer, showing the Install language packs tab view and the languages you can choose from like English, Spanish, Chinese (simplified or traditional)." lightbox="../get-started/media/vs-installer-language-packs.png"::: #### Change the installer language from the command line -Another way that you can change the default language is by running the installer from the command line. For example, you can force the installer to run in English by using the following command: `vs_installer.exe --locale en-US`. The installer will remember this setting when it's run the next time. The installer supports the following language tokens: zh-cn, zh-tw, cs-cz, en-us, es-es, fr-fr, de-de, it-it, ja-jp, ko-kr, pl-pl, pt-br, ru-ru, and tr-tr. +Another way that you can change the default language is by running the installer from the command line. For example, you can force the installer to run in English by using the following command: `vs_installer.exe --locale en-US`. The installer remembers this setting when it's run the next time. The installer supports the following language tokens: zh-cn, zh-tw, cs-cz, en-us, es-es, fr-fr, de-de, it-it, ja-jp, ko-kr, pl-pl, pt-br, ru-ru, and tr-tr. -### Step 7 - Change the installation location (Optional) +### Step 7 - Change the installation location (optional) You can reduce the installation footprint of Visual Studio on your system drive. You can choose to move the download cache, shared components, SDKs, and tools to different drives, and keep Visual Studio on the drive that runs it the fastest. @@ -106,28 +109,43 @@ You can reduce the installation footprint of Visual Studio on your system drive. 1. On the start window, choose **Create a new project**. -1. In the search box, enter the type of app you want to create to see a list of available templates. The list of templates depends on the workload(s) that you chose during installation. To see different templates, choose different workloads. +1. In the search box, enter the type of app you want to create to see a list of available templates. The list of templates depends on the workloads that you chose during installation. To see different templates, choose different workloads. - You can also filter your search for a specific programming language by using the **Language** drop-down list. You can filter by using the **Platform** list and the **Project type** list, too. + You can also filter your search for a specific programming language by using the **Language** dropdown list. You can filter by using the **Platform** list and the **Project type** list, too. 1. Visual Studio opens your new project, and you're ready to code! +### Step 9 - Install GitHub Copilot + +You can use GitHub Copilot in Visual Studio to help with your C++ development. Copilot is an AI-powered coding assistant that helps you write code faster, reduce errors, and explore new solutions. + +Some benefits of using Copilot for your C++ coding scenarios: +- Generate entire C++ functions or classes as you type. +- Suggest code completions based on plain-language comments or prompts. +- Get help with complex algorithms, data structures, and standard library usage. +- Learn new APIs and modern C++ patterns through in-context examples. +- Receive context-aware suggestions based on your comments or code. +- Debug errors in your code. +- Simplify and refactor existing code. + +To try GitHub copilot to create a C++ app, follow the instructions in [Use AI to create a C++ console application in Visual Studio](../build/use-github-copilot-create-cpp-console-app.md). + ::: moniker-end ::: moniker range="msvc-160" -## Visual Studio 2019 Installation +## Visual Studio 2019 installation -Welcome to Visual Studio 2019! In this version, it's easy to choose and install just the features you need. And because of its reduced minimum footprint, it installs quickly and with less system impact. +Welcome to Visual Studio 2019! In this version, it's easy to choose and install just the features you need. Because of its reduced minimum footprint, Visual Studio installs quickly and with less system impact. > [!NOTE] -> This topic applies to installation of Visual Studio on Windows. [Visual Studio Code](https://code.visualstudio.com/) is a lightweight, cross-platform development environment that runs on Windows, Mac, and Linux systems. The Microsoft [C/C++ for Visual Studio Code](https://marketplace.visualstudio.com/items?itemName=ms-vscode.cpptools) extension supports IntelliSense, debugging, code formatting, auto-completion. Visual Studio for Mac doesn't support Microsoft C++, but does support .NET languages and cross-platform development. For installation instructions, see [Install Visual Studio for Mac](/visualstudio/mac/installation/). +> This article applies to installation of Visual Studio on Windows. [Visual Studio Code](https://code.visualstudio.com) is a lightweight, cross-platform development environment that runs on Windows, Mac, and Linux systems. The Microsoft [C/C++ for Visual Studio Code](https://marketplace.visualstudio.com/items?itemName=ms-vscode.cpptools) extension supports IntelliSense, debugging, code formatting, autocompletion. Visual Studio for Mac doesn't support Microsoft C++, but does support .NET languages and cross-platform development. For installation instructions, see [Install Visual Studio for Mac](/visualstudio/mac/installation/). -Want to know more about what else is new in this version? See the Visual Studio [release notes](/visualstudio/releases/2019/release-notes/). +To learn what else is new in this version, see the Visual Studio [release notes](/visualstudio/releases/2019/release-notes/). -Ready to install? We walk you through it, step-by-step. +Ready to install? Use the following step-by-step guide. -### Step 1 - Make sure your computer is ready for Visual Studio +### Step 1 - Prepare your computer for Visual Studio Before you begin installing Visual Studio: @@ -135,28 +153,24 @@ Before you begin installing Visual Studio: 1. Apply the latest Windows updates. These updates ensure that your computer has both the latest security updates and the required system components for Visual Studio. -1. Reboot. The reboot ensures that any pending installs or updates don't hinder the Visual Studio install. +1. Reboot your computer. The reboot ensures that any pending installs or updates don't hinder the Visual Studio install. -1. Free up space. Remove unneeded files and applications from your %SystemDrive% by, for example, running the Disk Cleanup app. +1. Free up disk space. Remove unneeded files and applications from your %SystemDrive% by, for example, running the Disk Cleanup app. For questions about running previous versions of Visual Studio side by side with Visual Studio 2019, see the [Visual Studio 2019 Platform Targeting and Compatibility](/visualstudio/releases/2019/compatibility/) page. ### Step 2 - Download Visual Studio -Next, download the Visual Studio bootstrapper file. To do so, choose the following button to go to the Visual Studio download page. Choose the Download button, then you can select the edition of Visual Studio that you want. +Select the following button to go to the Visual Studio older downloads page, and download the Visual Studio 2019 bootstrapper file. > [!div class="button"] > [Download Visual Studio 2019](https://visualstudio.microsoft.com/vs/older-downloads/#visual-studio-2019-and-other-products) -### Step 3 - Install the Visual Studio installer +### Step 3 - Install the Visual Studio Installer Run the bootstrapper file you downloaded to install the Visual Studio Installer. This new lightweight installer includes everything you need to both install and customize Visual Studio. -1. From your **Downloads** folder, double-click the bootstrapper that matches or is similar to one of the following files: - - - **vs_community.exe** for Visual Studio Community - - **vs_professional.exe** for Visual Studio Professional - - **vs_enterprise.exe** for Visual Studio Enterprise +1. From your *Downloads* folder, double-click the bootstrapper file. If you receive a User Account Control notice, choose **Yes** to allow the bootstrapper to run. @@ -164,46 +178,46 @@ Run the bootstrapper file you downloaded to install the Visual Studio Installer. ### Step 4 - Choose workloads -After the installer is installed, you can use it to customize your installation by selecting the *workloads*, or feature sets, that you want. Here's how. +You can use the installer to customize your installation by selecting the *workloads*, or feature sets, that you want. 1. Find the workload you want in the **Installing Visual Studio** screen. - ![Visual Studio 2019: Install a workload.](../get-started/media/vs-installer-workloads.png) - - For core C and C++ support, choose the "Desktop development with C++" workload. It comes with the default core editor, which includes basic code editing support for over 20 languages, the ability to open and edit code from any folder without requiring a project, and integrated source code control. + :::image type="content" source="../get-started/media/vs-installer-workloads.png" alt-text="Screenshot of the Visual Studio 2019 installer." lightbox="../get-started/media/vs-installer-workloads.png"::: - Other workloads support more kinds of development. For example, choose the "Universal Windows Platform development" workload to create apps that use the Windows Runtime for the Microsoft Store. Choose "Game development with C++" to create games that use DirectX, Unreal, and Cocos2d. Choose "Linux development with C++" to target Linux platforms, including IoT development. + For core C and C++ support, choose the **Desktop development with C++** workload. It comes with the default core editor, which includes basic code editing support for over 20 languages, the ability to open and edit code from any folder without requiring a project, and integrated source code control. The **Installation details** pane lists the included and optional components installed by each workload. You can select or deselect optional components in this list. For example, to support development by using the Visual Studio 2017 or 2015 compiler toolsets, choose the MSVC v141 or MSVC v140 optional components. You can add support for MFC, the experimental Modules language extension, IncrediBuild, and more. -1. After you choose the workload(s) and optional components you want, choose **Install**. + Other workloads support more kinds of development. For example, choose the **Universal Windows Platform development** workload to create apps that use the Windows Runtime for the Microsoft Store. Choose **Game development with C++** to create games that use DirectX, Unreal, and Cocos2d. Choose **Linux development with C++** to target Linux platforms, including IoT development. + +1. After you choose the workloads and optional components you want, choose **Install**. Next, status screens appear that show the progress of your Visual Studio installation. > [!TIP] > At any time after installation, you can install workloads or components that you didn't install initially. If you have Visual Studio open, go to **Tools** > **Get Tools and Features...** which opens the Visual Studio Installer. Or, open **Visual Studio Installer** from the Start menu. From there, you can choose the workloads or components that you wish to install. Then, choose **Modify**. -### Step 5 - Choose individual components (Optional) +### Step 5 - Choose individual components (optional) -If you don't want to use the Workloads feature to customize your Visual Studio installation, or you want to add more components than a workload installs, you can do so by installing or adding individual components from the **Individual components** tab. Choose what you want, and then follow the prompts. +If you don't want to use the Workloads feature to customize your Visual Studio installation, or if you want to add more components than a workload installs, you can do so by installing or adding individual components from the **Individual components** tab. Choose what you want, and then follow the prompts. - ![Screenshot of the Visual Studio Installer, showing the Install individual components tab view.](../get-started/media/vs-installer-individual-components.png "Install Visual Studio individual components") +:::image type="content" source="../get-started/media/vs-installer-individual-components.png" alt-text="Screenshot of the Visual Studio Installer, showing the Install individual components tab view." lightbox="../get-started/media/vs-installer-individual-components.png"::: -### Step 6 - Install language packs (Optional) +### Step 6 - Install language packs (optional) By default, the installer program tries to match the language of the operating system when it runs for the first time. To install Visual Studio in a language of your choosing, choose the **Language packs** tab from the Visual Studio Installer, and then follow the prompts. - ![Screenshot of the Visual Studio Installer, showing the Install language packs tab view.](../get-started/media/vs-installer-language-packs.png "Install Visual Studio language packs") +:::image type="content" source="../get-started/media/vs-installer-language-packs.png" alt-text="Screenshot of the Visual Studio Installer, showing the Install language packs tab view." lightbox="../get-started/media/vs-installer-language-packs.png"::: #### Change the installer language from the command line Another way that you can change the default language is by running the installer from the command line. For example, you can force the installer to run in English by using the following command: `vs_installer.exe --locale en-US`. The installer will remember this setting when it's run the next time. The installer supports the following language tokens: zh-cn, zh-tw, cs-cz, en-us, es-es, fr-fr, de-de, it-it, ja-jp, ko-kr, pl-pl, pt-br, ru-ru, and tr-tr. -### Step 7 - Change the installation location (Optional) +### Step 7 - Change the installation location (optional) You can reduce the installation footprint of Visual Studio on your system drive. You can choose to move the download cache, shared components, SDKs, and tools to different drives, and keep Visual Studio on the drive that runs it the fastest. - ![Screenshot of the Visual Studio Installer, showing the installation locations tab view.](../get-started/media/vs-installer-installation-locations.png "Change the installation location") +:::image type="content" source="../get-started/media/vs-installer-installation-locations.png" alt-text="Screenshot of the Visual Studio Installer, showing the installation locations tab view." lightbox="../get-started/media/vs-installer-installation-locations.png"::: > [!IMPORTANT] > You can select a different drive only when you first install Visual Studio. If you've already installed it and want to change drives, you must uninstall Visual Studio and then reinstall it. @@ -211,12 +225,10 @@ You can reduce the installation footprint of Visual Studio on your system drive. ### Step 8 - Start developing 1. After Visual Studio installation is complete, choose the **Launch** button to get started developing with Visual Studio. - 1. On the start window, choose **Create a new project**. +1. In the search box, enter the type of app you want to create to see a list of available templates. The list of templates depends on the workloads that you chose during installation. To see different templates, choose different workloads. -1. In the search box, enter the type of app you want to create to see a list of available templates. The list of templates depends on the workload(s) that you chose during installation. To see different templates, choose different workloads. - - You can also filter your search for a specific programming language by using the **Language** drop-down list. You can filter by using the **Platform** list and the **Project type** list, too. + You can also filter your search for a specific programming language by using the **Language** dropdown list. You can filter by using the **Platform** list and the **Project type** list, too. 1. Visual Studio opens your new project, and you're ready to code! @@ -224,14 +236,12 @@ You can reduce the installation footprint of Visual Studio on your system drive. ::: moniker range="msvc-150" -## Visual Studio 2017 Installation +## Visual Studio 2017 installation -In Visual Studio 2017, it's easy to choose and install just the features you need. And because of its reduced minimum footprint, it installs quickly and with less system impact. +In Visual Studio 2017, it's easy to choose and install just the features you need. Because of its reduced minimum footprint, it installs quickly and with less system impact. ### Prerequisites -- A broadband internet connection. The Visual Studio installer can download several gigabytes of data. - - A computer that runs Microsoft Windows 7 or later versions. We recommend the latest version of Windows for the best development experience. Make sure that the latest updates are applied to your system before you install Visual Studio. - Enough free disk space. Visual Studio requires at least 7 GB of disk space, and can take 50 GB or more if many common options are installed. We recommend you install it on your C: drive. @@ -240,36 +250,29 @@ For details on the disk space and operating system requirements, see [Visual Stu ### Download and install -1. To download the latest Visual Studio 2017 installer for Windows, go to the Microsoft Visual Studio [Older downloads](https://visualstudio.microsoft.com/vs/older-downloads/#visual-studio-2017-and-other-products) page. Expand the **2017** section, and choose the **Download** button. - - >[!Tip] - > The Community edition is for individual developers, classroom learning, academic research, and open source development. For other uses, install Visual Studio 2017 Professional or Visual Studio 2017 Enterprise. +1. To download the Visual Studio 2017 installer for Windows, go to the Visual Studio [older downloads](https://visualstudio.microsoft.com/vs/older-downloads/#visual-studio-2017-and-other-products) page. Expand the **2017** section, and choose the **Download** button. -1. Find the installer file you downloaded and run it. The downloaded file might be displayed in your browser, or you might find it in your Downloads folder. The installer needs Administrator privileges to run. You might see a **User Account Control** dialog asking you to give permission to let the installer make changes to your system; choose **Yes**. If you're having trouble, find the downloaded file in File Explorer, right-click on the installer icon, and choose **Run as Administrator** from the context menu. +1. Find the installer file you downloaded and run it. The downloaded file might be displayed in your browser, or you might find it in your *Downloads* folder. The installer needs Administrator privileges to run. You might see a **User Account Control** dialog asking you to give permission to let the installer make changes to your system; choose **Yes**. If you're having trouble, find the downloaded file in File Explorer, right-click on the installer icon, and choose **Run as Administrator** from the context menu. - ![What you see when you download and install the Visual Studio Installer.](media/vscpp-concierge-run-installer.gif "Download and install the Visual Studio Installer") + :::image type="content" source="media/vscpp-concierge-run-installer.gif" alt-text="Animation that shows the Visual Studio Installer."::: 1. The installer presents you with a list of workloads, which are groups of related options for specific development areas. Support for C++ is now part of optional workloads that aren't installed by default. - ![Detail showing the Desktop development with C++ workload.](media/desktop-development-with-cpp.png "Desktop development with C++") + :::image type="content" source="media/desktop-development-with-cpp.png" alt-text="Screenshot showing the Desktop development with C plus plus workload."::: For C and C++, select the **Desktop development with C++** workload and then choose **Install**. - ![What you see when you select the Desktop development with C++ workload then choose the Install button.](media/vscpp-concierge-choose-workload.gif "Install the Desktop development with C++ workload") + :::image type="content" source="media/vscpp-concierge-choose-workload.gif" alt-text="Animation that shows the Desktop development with C plus plus workload then choose the Install button."::: 1. When the installation completes, choose the **Launch** button to start Visual Studio. The first time you run Visual Studio, you're asked to sign in with a Microsoft Account. If you don't have one, you can create one for free. You must also choose a theme. Don't worry, you can change it later if you want to. - It might take Visual Studio several minutes to get ready for use the first time you run it. Here's what it looks like in a quick time-lapse: - - ![Visual Studio sign in dialog.](media/vscpp-quickstart-first-run.gif "Visual Studio 2017 sign in") - - Visual Studio starts faster when you run it again. + It might take Visual Studio several minutes to get ready for use the first time you run it. 1. When Visual Studio opens, check to see if the flag icon in the title bar is highlighted: - ![Visual Studio notification flag.](media/vscpp-first-start-page-flag.png "Visual Studio 2017 notification flag") + :::image type="content" source="media/vscpp-first-start-page-flag.png" alt-text="Screenshot of the Visual Studio notification flag."::: If it's highlighted, select it to open the **Notifications** window. If there are any updates available for Visual Studio, we recommend you install them now. Once the installation is complete, restart Visual Studio. @@ -277,9 +280,9 @@ For details on the disk space and operating system requirements, see [Visual Stu ::: moniker range=" [!div class="nextstepaction"] -> [Create a C++ project](vscpp-step-1-create.md) +> [Create a C++ console app project](vscpp-step-1-create.md) diff --git a/docs/build/vscpp-step-1-create.md b/docs/build/vscpp-step-1-create.md index f3a3546d390..1337c29d018 100644 --- a/docs/build/vscpp-step-1-create.md +++ b/docs/build/vscpp-step-1-create.md @@ -1,9 +1,11 @@ --- title: Create a C++ console app project description: "Create a Hello World console app using Microsoft C++ in Visual Studio." -ms.custom: "mvc" ms.date: 07/05/2023 ms.topic: "tutorial" +ms.custom: + - "mvc" + - sfi-image-nochange --- # Create a C++ console app project @@ -81,7 +83,7 @@ Visual Studio now knows to build your project to run in a console window. Next, ![View of the process to add a source file for HelloWorld.cpp.](media/vscpp-add-new-item.gif "Add a source file for HelloWorld.cpp") -Visual studio creates a new, empty source code file and opens it in an editor window, ready to enter your source code. +Visual Studio creates a new, empty source code file and opens it in an editor window, ready to enter your source code. [I ran into a problem.](#add-a-source-code-file-issues) diff --git a/docs/build/vscpp-step-2-build.md b/docs/build/vscpp-step-2-build.md index d2ce5e0b517..174615c346b 100644 --- a/docs/build/vscpp-step-2-build.md +++ b/docs/build/vscpp-step-2-build.md @@ -1,6 +1,6 @@ --- title: Build and run a C++ console app project -description: "Build and run a Hello World console app in Visual C++" +description: "Build and run a Hello World console app in Microsoft C++" ms.custom: "mvc" ms.date: 06/28/2024 ms.topic: "tutorial" @@ -88,7 +88,7 @@ If red squiggles appear under anything in the source code editor, the build may ::: moniker range=" [!NOTE] > A developer command prompt shortcut automatically sets the correct paths for the compiler and tools, and for any required headers and libraries. Some of these values are different for each build configuration. You must set these environment values yourself if you don't use one of the shortcuts. For more information, see [Use the MSVC toolset from the command line](./building-on-the-command-line.md). Because the build environment is complex, we strongly recommend you use a developer command prompt shortcut instead of building your own. -These instructions vary depending on which version of Visual Studio you're using. To see the documentation for your preferred version of Visual Studio, use the **Version** selector control. It's found at the top of the table of contents on this page. +These instructions vary depending on which version of Visual Studio you're using. To see the documentation for your preferred version of Visual Studio, use the **Version** selector located at the top of the table of contents on this page. ::: moniker range="msvc-170" ## Open a developer command prompt in Visual Studio 2022 -If you've installed Visual Studio 2022 on Windows 10 or later, open the Start menu, and choose **All apps**. Then, scroll down and open the **Visual Studio 2022** folder (not the Visual Studio 2022 app). Choose **Developer Command Prompt for VS 2022** to open the command prompt window. +If you installed Visual Studio 2022 on Windows 10 or later, open the Start menu, and choose **All apps**. Then, scroll down and open the **Visual Studio 2022** folder (not the Visual Studio 2022 app). Choose **Developer Command Prompt for VS 2022** to open the command prompt window. ::: moniker-end @@ -39,7 +39,7 @@ If you've installed Visual Studio 2022 on Windows 10 or later, open the Start me ## Open a developer command prompt in Visual Studio 2019 -If you've installed Visual Studio 2019 on Windows 10 or later, open the Start menu, and choose **All apps**. Then, scroll down and open the **Visual Studio 2019** folder (not the Visual Studio 2019 app). Choose **Developer Command Prompt for VS 2019** to open the command prompt window. +If you installed Visual Studio 2019 on Windows 10 or later, open the Start menu, and choose **All apps**. Then, scroll down and open the **Visual Studio 2019** folder (not the Visual Studio 2019 app). Choose **Developer Command Prompt for VS 2019** to open the command prompt window. ::: moniker-end @@ -47,7 +47,7 @@ If you've installed Visual Studio 2019 on Windows 10 or later, open the Start me ## Open a developer command prompt in Visual Studio 2017 -If you've installed Visual Studio 2017 on Windows 10 or later, open the Start menu, and choose **All apps**. Then, scroll down and open the **Visual Studio 2017** folder (not the Visual Studio 2017 app). Choose **Developer Command Prompt for VS 2017** to open the command prompt window. +If you installed Visual Studio 2017 on Windows 10 or later, open the Start menu, and choose **All apps**. Then, scroll down and open the **Visual Studio 2017** folder (not the Visual Studio 2017 app). Choose **Developer Command Prompt for VS 2017** to open the command prompt window. ::: moniker-end @@ -55,11 +55,11 @@ If you've installed Visual Studio 2017 on Windows 10 or later, open the Start me ## Open a developer command prompt in Visual Studio 2015 -If you've installed Microsoft Visual C++ Build Tools 2015 on Windows 10 or later, open the Start menu, and choose **All apps**. Then, scroll down and open the **Visual C++ Build Tools** folder. Choose **Visual C++ 2015 x86 Native Tools Command Prompt** to open the command prompt window. +If you installed Microsoft Visual C++ Build Tools 2015 on Windows 10 or later, open the Start menu, and choose **All apps**. Then, scroll down and open the **Visual C++ Build Tools** folder. Choose **Visual C++ 2015 x86 Native Tools Command Prompt** to open the command prompt window. ::: moniker-end -If you're using a different version of Windows, look in your Start menu or Start page for a Visual Studio tools folder that contains a developer command prompt shortcut. You can also use the Windows search function to search for "developer command prompt" and choose one that matches your installed version of Visual Studio. Use the shortcut to open the command prompt window. +If you're using a different version of Windows, look in your Start menu or Start page for a Visual Studio tools folder that contains a developer command prompt shortcut. You can also use the Windows search function to search for *developer command prompt* and choose one that matches your installed version of Visual Studio. Use the shortcut to open the command prompt window. Next, verify that the developer command prompt is set up correctly. In the command prompt window, enter `cl` (or `CL`, case doesn't matter for the compiler name, but it does matter for compiler options). The output should look something like this: @@ -71,19 +71,19 @@ Copyright (C) Microsoft Corporation. All rights reserved. usage: cl [ option... ] filename... [ /link linkoption... ] ``` -There may be differences in the current directory or version numbers, depending on the version of Visual Studio and any updates installed. If the above output is similar to what you see, then you're ready to build C or C++ programs at the command line. +There might be differences in the current directory or version numbers, depending on the version of Visual Studio and any updates installed. If the preceding output is similar to what you see, then you're ready to build C or C++ programs at the command line. > [!NOTE] -> If you get an error such as "'cl' is not recognized as an internal or external command, operable program or batch file," error C1034, or error LNK1104 when you run the **cl** command, then either you are not using a developer command prompt, or something is wrong with your installation of Visual Studio. You must fix this issue before you can continue. +> If you get an error such as **'cl' is not recognized as an internal or external command, operable program or batch file**, error C1034, or error LNK1104 when you run the `cl` command, then either you're not using a developer command prompt, or something is wrong with your installation of Visual Studio. You must fix this issue before you can continue. -If you can't find the developer command prompt shortcut, or if you get an error message when you enter `cl`, then your Visual Studio installation may have a problem. If you're using Visual Studio 2017 or later, try reinstalling the **Desktop development with C++** workload in the Visual Studio installer. For details, see [Install C++ support in Visual Studio](vscpp-step-0-installation.md). Or, reinstall the Build Tools from the [Visual Studio downloads](https://visualstudio.microsoft.com/downloads/) page. Don't go on to the next section until the `cl` command works. For more information about installing and troubleshooting Visual Studio, see [Install Visual Studio](/visualstudio/install/install-visual-studio). +If you can't find the developer command prompt shortcut, or if you get an error message when you enter `cl`, then your Visual Studio installation might have a problem. If you're using Visual Studio 2017 or later, try reinstalling the **Desktop development with C++** workload in the Visual Studio installer. For details, see [Install C++ support in Visual Studio](vscpp-step-0-installation.md). Or, reinstall the build tools from the [Visual Studio downloads](https://visualstudio.microsoft.com/downloads/) page. Don't go on to the next section until the `cl` command works. For more information about installing and troubleshooting Visual Studio, see [Install Visual Studio](/visualstudio/install/install-visual-studio). > [!NOTE] -> Depending on the version of Windows on the computer and the system security configuration, you might have to right-click to open the shortcut menu for the developer command prompt shortcut and then choose **Run as Administrator** to successfully build and run the program that you create by following this walkthrough. +> Depending on the version of Windows on the computer and the system security configuration, you might need to right-click to open the shortcut menu for the developer command prompt shortcut and then choose **Run as Administrator** to successfully build and run the program that you create by following this walkthrough. ## Create a C source file and compile it on the command line -1. In the developer command prompt window, enter `cd c:\` to change the current working directory to the root of your C: drive. Next, enter `md c:\hello` to create a directory, and then enter `cd c:\hello` to change to that directory. This directory will hold your source file and the compiled program. +1. In the developer command prompt window, enter `cd c:\` to change the current working directory to the root of your C: drive. Next, enter `md c:\hello` to create a directory, and then enter `cd c:\hello` to change to that directory. This directory holds your source file and the compiled program. 1. Enter `notepad hello.c` at the developer command prompt. In the Notepad alert dialog that pops up, choose **Yes** to create a new *`hello.c`* file in your working directory. @@ -122,7 +122,7 @@ If you can't find the developer command prompt shortcut, or if you get an error 1. To compile your program, enter `cl hello.c` at the developer command prompt. - You can see the executable program name, hello.exe, in the lines of output information that the compiler displays: + You can see the executable program name, *`hello.exe`*, in the lines of output information that the compiler displays: ```Output c:\hello>cl hello.c @@ -138,7 +138,7 @@ If you can't find the developer command prompt shortcut, or if you get an error ``` > [!NOTE] - > If you get an error such as "'cl' is not recognized as an internal or external command, operable program or batch file," error C1034, or error LNK1104, your developer command prompt is not set up correctly. For information on how to fix this issue, go back to the **Open a developer command prompt** section. + > If you get an error such as **'cl' is not recognized as an internal or external command, operable program or batch file,** error C1034, or error LNK1104, your developer command prompt isn't set up correctly. For information on how to fix this issue, go back to the **Open a developer command prompt** section. > > If you get a different compiler or linker error or warning, review your source code to correct any errors, then save it and run the compiler again. For information about specific errors, use the search box at the top of this page to look for the error number. @@ -152,9 +152,9 @@ If you can't find the developer command prompt shortcut, or if you get an error Congratulations, you've compiled and run a C program by using the command line. -## Next steps +## Advanced steps -This "Hello, World" example is about as basic as a C program can get. Real world programs have header files and more source files, link in libraries, and do useful work. +This *Hello, World* example is about as basic as a C program can get. Real-world programs have header files and more source files, link in libraries, and do useful work. You can use the steps in this walkthrough to build your own C code instead of typing the sample code shown. You can also build many C code sample programs that you find elsewhere. To compile a program that has more source code files, enter them all on the command line: @@ -164,23 +164,23 @@ The compiler outputs a program called *`file1.exe`*. To change the name to *`pro `cl file1.c file2.c file3.c /link /out:program1.exe` -And to catch more programming mistakes automatically, we recommend you compile by using either the [/W3](reference/compiler-option-warning-level.md) or [/W4](reference/compiler-option-warning-level.md) warning level option: +And to catch more programming mistakes automatically, we recommend you compile by using either the [/W3 or /W4](reference/compiler-option-warning-level.md) warning level option: `cl /W4 file1.c file2.c file3.c /link /out:program1.exe` -The compiler, cl.exe, has many more options you can apply to build, optimize, debug, and analyze your code. For a quick list, enter `cl /?` at the developer command prompt. You can also compile and link separately and apply linker options in more complex build scenarios. For more information on compiler and linker options and usage, see [C/C++ Building Reference](reference/c-cpp-building-reference.md). +The compiler, *`cl.exe`*, has many more options you can apply to build, optimize, debug, and analyze your code. For a quick list, enter `cl /?` at the developer command prompt. You can also compile and link separately and apply linker options in more complex build scenarios. For more information on compiler and linker options and usage, see [C/C++ Building Reference](reference/c-cpp-building-reference.md). You can use NMAKE and makefiles, or MSBuild and project files to configure and build more complex projects on the command line. For more information on using these tools, see [NMAKE Reference](reference/nmake-reference.md) and [MSBuild](msbuild-visual-cpp.md). -The C and C++ languages are similar, but not the same. The Microsoft C/C++ compiler (MSVC) uses a basic rule to determine which language to use when it compiles your code. By default, the MSVC compiler treats all files that end in *`.c`* as C source code, and all files that end in *`.cpp`* as C++ source code. To force the compiler to treat all files as C no matter the file name extension, use the [/TC](reference/tc-tp-tc-tp-specify-source-file-type.md) compiler option. +The C and C++ languages are similar, but not the same. The MSVC compiler uses a basic rule to determine which language to use when it compiles your code. By default, the MSVC compiler treats all files that end in *`.c`* as C source code, and all files that end in *`.cpp`* as C++ source code. To force the compiler to treat all files as C no matter the file name extension, use the [/TC](reference/tc-tp-tc-tp-specify-source-file-type.md) compiler option. -By default, MSVC is compatible with the ANSI C89 and ISO C99 standards, but not strictly conforming. In most cases, portable C code will compile and run as expected. The compiler provides optional support for the changes in ISO C11/C17. To compile with C11/C17 support, use the compiler flag **`/std:c11`** or **`/std:c17`**. C11/C17 support requires Windows SDK 10.0.20201.0 or later. Windows SDK 10.0.22000.0 or later is recommended. You can download the latest SDK from the [Windows SDK](https://developer.microsoft.com/windows/downloads/windows-sdk/) page. For more information, and instructions on how to install and use this SDK for C development, see [Install C11 and C17 support in Visual Studio](../overview/install-c17-support.md). +By default, MSVC is compatible with the ANSI C89 and ISO C99 standards, but not strictly conforming. In most cases, portable C code compiles and runs as expected. The compiler provides optional support for the changes in ISO C11 and C17. To compile with C11 and C17 support, use the compiler flag `/std:c11` or `/std:c17`. C11 and C17 support requires Windows SDK 10.0.20201.0 or later. Windows SDK 10.0.22000.0 or later is recommended. You can download the latest SDK from the [Windows SDK](https://developer.microsoft.com/windows/downloads/windows-sdk/) page. For more information, and instructions on how to install and use this SDK for C development, see [Install C11 and C17 support in Visual Studio](../overview/install-c17-support.md). Certain library functions and POSIX function names are deprecated by MSVC. The functions are supported, but the preferred names have changed. For more information, see [Security Features in the CRT](../c-runtime-library/security-features-in-the-crt.md) and [Compiler Warning (level 3) C4996](../error-messages/compiler-warnings/compiler-warning-level-3-c4996.md). ## See also -[Walkthrough: Creating a Standard C++ Program (C++)](../windows/walkthrough-creating-a-standard-cpp-program-cpp.md)\ -[C Language Reference](../c-language/c-language-reference.md)\ -[Projects and build systems](projects-and-build-systems-cpp.md)\ -[Compatibility](../c-runtime-library/compatibility.md) +- [Walkthrough: Create a Standard C++ Program](../windows/walkthrough-creating-a-standard-cpp-program-cpp.md) +- [C Language Reference](../c-language/c-language-reference.md) +- [C/C++ projects and build systems](projects-and-build-systems-cpp.md) +- [Compatibility](../c-runtime-library/compatibility.md) diff --git a/docs/build/walkthrough-compiling-a-cpp-cli-program-on-the-command-line.md b/docs/build/walkthrough-compiling-a-cpp-cli-program-on-the-command-line.md index 1bf1c0904fd..f450214e366 100644 --- a/docs/build/walkthrough-compiling-a-cpp-cli-program-on-the-command-line.md +++ b/docs/build/walkthrough-compiling-a-cpp-cli-program-on-the-command-line.md @@ -6,7 +6,7 @@ ms.assetid: cef41c88-faf9-439d-8423-25aa3f5674dd --- # Walkthrough: Compiling a C++/CLI Program on the Command Line -You can create Visual C++ programs that target the Common Language Runtime (CLR) and use the .NET Framework, and build them on the command line. Visual C++ supports the C++/CLI programming language, which has additional types and operators to target the .NET programming model. For general information about the C++/CLI language, see [.NET Programming with C++/CLI (Visual C++)](../dotnet/dotnet-programming-with-cpp-cli-visual-cpp.md). +You can create Microsoft C++ programs that target the Common Language Runtime (CLR) and use the .NET Framework, and build them on the command line. Microsoft C++ supports the C++/CLI programming language, which has additional types and operators to target the .NET programming model. For general information about the C++/CLI language, see [.NET Programming with C++/CLI (Visual C++)](../dotnet/dotnet-programming-with-cpp-cli-visual-cpp.md). In this walkthrough, you use a text editor to create a basic C++/CLI program, and then compile it on the command line. (You can use your own C++/CLI program instead of typing the one that's shown, or you can use a C++/CLI code sample from another help article. This technique is useful for building and testing small modules that have no UI elements.) @@ -18,7 +18,7 @@ You understand the fundamentals of the C++ language. The following steps show how to compile a C++/CLI console application that uses .NET Framework classes. -To enable compilation for C++/CLI, you must use the [/clr](reference/clr-common-language-runtime-compilation.md) compiler option. The MSVC compiler generates an .exe file that contains MSIL code—or mixed MSIL and native code—and links to the required .NET Framework libraries. +To enable compilation for C++/CLI, you must use the [/clr](reference/clr-common-language-runtime-compilation.md) compiler option. The Microsoft C++ (MSVC) compiler generates an .exe file that contains MSIL code—or mixed MSIL and native code—and links to the required .NET Framework libraries. ### To compile a C++/CLI application on the command line @@ -43,7 +43,7 @@ To enable compilation for C++/CLI, you must use the [/clr](reference/clr-common- 1. On the menu bar, choose **File** > **Save**. - You've created a Visual C++ source file that uses a .NET Framework class () in the namespace. + You've created a C++ source file that uses a .NET Framework class () in the namespace. 1. At the command prompt, enter `cl /clr basicclr.cpp`. The cl.exe compiler compiles the source code into an .obj file that contains MSIL, and then runs the linker to generate an executable program named basicclr.exe. diff --git a/docs/build/walkthrough-compiling-a-native-cpp-program-on-the-command-line.md b/docs/build/walkthrough-compiling-a-native-cpp-program-on-the-command-line.md index 5cd2502e96e..f2bf932a35e 100644 --- a/docs/build/walkthrough-compiling-a-native-cpp-program-on-the-command-line.md +++ b/docs/build/walkthrough-compiling-a-native-cpp-program-on-the-command-line.md @@ -22,7 +22,7 @@ Visual Studio is an *integrated development environment* (IDE). It supports a fu The Build Tools for Visual Studio installs only the command-line compilers, tools, and libraries you need to build C and C++ programs. It's perfect for build labs or classroom exercises and installs relatively quickly. To install only the command-line tools, look for Build Tools for Visual Studio on the [Visual Studio Downloads](https://visualstudio.microsoft.com/downloads/#build-tools-for-visual-studio-2022) page. -Before you can build a C or C++ program on the command line, verify that the tools are installed, and you can access them from the command line. Visual C++ has complex requirements for the command-line environment to find the tools, headers, and libraries it uses. **You can't use Visual C++ in a plain command prompt window** without doing some preparation. Fortunately, Visual C++ installs shortcuts for you to launch a developer command prompt that has the environment set up for command line builds. Unfortunately, the names of the developer command prompt shortcuts and where they're located are different in almost every version of Visual C++ and on different versions of Windows. Your first walkthrough task is finding the right one to use. +Before you can build a C or C++ program on the command line, verify that the tools are installed, and you can access them from the command line. Microsoft C++ (MSVC) has complex requirements for the command-line environment to find the tools, headers, and libraries it uses. **You can't use Microsoft C++ in a plain command prompt window** without doing some preparation. Fortunately, Microsoft C++ installs shortcuts for you to launch a developer command prompt that has the environment set up for command line builds. Unfortunately, the names of the developer command prompt shortcuts and where they're located are different in almost every version of Visual Studio and on different versions of Windows. Your first walkthrough task is finding the right one to use. > [!NOTE] > A developer command prompt shortcut automatically sets the correct paths for the compiler and tools, and for any required headers and libraries. You must set these environment values yourself if you use a regular **Command Prompt** window. For more information, see [Use the MSVC toolset from the command line](./building-on-the-command-line.md). We recommend you use a developer command prompt shortcut instead of building your own. @@ -31,11 +31,11 @@ Before you can build a C or C++ program on the command line, verify that the too 1. If you have installed Visual Studio 2017 or later on Windows 10 or later, open the Start menu and choose **All apps**. Scroll down and open the **Visual Studio** folder (not the Visual Studio application). Choose **Developer Command Prompt for VS** to open the command prompt window. - If you have installed Microsoft Visual C++ Build Tools 2015 on Windows 10 or later, open the **Start** menu and choose **All apps**. Scroll down and open the **Visual C++ Build Tools** folder. Choose **Visual C++ 2015 x86 Native Tools Command Prompt** to open the command prompt window. + If you have installed Microsoft Visual Studio Build Tools 2015 on Windows 10 or later, open the **Start** menu and choose **All apps**. Scroll down and open the **Visual Studio Build Tools** folder. Choose **x86 Native Tools Command Prompt** to open the command prompt window. You can also use the Windows search function to search for "developer command prompt" and choose one that matches your installed version of Visual Studio. Use the shortcut to open the command prompt window. -1. Next, verify that the Visual C++ developer command prompt is set up correctly. In the command prompt window, enter `cl` and verify that the output looks something like this: +1. Next, verify that the C++ developer command prompt is set up correctly. In the command prompt window, enter `cl` and verify that the output looks something like this: ```Output C:\Program Files (x86)\Microsoft Visual Studio\2017\Enterprise>cl @@ -45,17 +45,17 @@ Before you can build a C or C++ program on the command line, verify that the too usage: cl [ option... ] filename... [ /link linkoption... ] ``` - There may be differences in the current directory or version numbers. These values depend on the version of Visual C++ and any updates installed. If the above output is similar to what you see, then you're ready to build C or C++ programs at the command line. + There may be differences in the current directory or version numbers. These values depend on the version of MSVC and any updates installed. If the above output is similar to what you see, then you're ready to build C or C++ programs at the command line. > [!NOTE] - > If you get an error such as "'cl' is not recognized as an internal or external command, operable program or batch file," error C1034, or error LNK1104 when you run the **`cl`** command, then either you are not using a developer command prompt, or something is wrong with your installation of Visual C++. You must fix this issue before you can continue. + > If you get an error such as "'cl' is not recognized as an internal or external command, operable program or batch file," error C1034, or error LNK1104 when you run the **`cl`** command, then either you are not using a developer command prompt, or something is wrong with your installation of MSVC. You must fix this issue before you can continue. - If you can't find the developer command prompt shortcut, or if you get an error message when you enter `cl`, then your Visual C++ installation may have a problem. Try reinstalling the Visual C++ component in Visual Studio, or reinstall the Microsoft Visual C++ Build Tools. Don't go on to the next section until the **`cl`** command works. For more information about installing and troubleshooting Visual C++, see [Install Visual Studio](/visualstudio/install/install-visual-studio). + If you can't find the developer command prompt shortcut, or if you get an error message when you enter `cl`, then your MSVC installation may have a problem. Try reinstalling the MSVC component in Visual Studio or Visual Studio Build Tools. Don't go on to the next section until the **`cl`** command works. For more information about installing and troubleshooting MSVC, see [Install Visual Studio](/visualstudio/install/install-visual-studio). > [!NOTE] > Depending on the version of Windows on the computer and the system security configuration, you might have to right-click to open the shortcut menu for the developer command prompt shortcut and then choose **Run as administrator** to successfully build and run the program that you create by following this walkthrough. -### Create a Visual C++ source file and compile it on the command line +### Create a C++ source file and compile it on the command line 1. In the developer command prompt window, enter `md c:\hello` to create a directory, and then enter `cd c:\hello` to change to that directory. This directory is where both your source file and the compiled program get created. @@ -70,7 +70,7 @@ Before you can build a C or C++ program on the command line, verify that the too using namespace std; int main() { - cout << "Hello, world, from Visual C++!" << endl; + cout << "Hello, world, from Microsoft C++!" << endl; } ``` @@ -130,7 +130,7 @@ Before you can build a C or C++ program on the command line, verify that the too The program displays this text and exits: ```Output - Hello, world, from Visual C++! + Hello, world, from Microsoft C++! ``` Congratulations, you've compiled and run a C++ program by using the command-line tools. diff --git a/docs/build/walkthrough-creating-and-using-a-dynamic-link-library-cpp.md b/docs/build/walkthrough-creating-and-using-a-dynamic-link-library-cpp.md index ed1941b8809..ac858bc073f 100644 --- a/docs/build/walkthrough-creating-and-using-a-dynamic-link-library-cpp.md +++ b/docs/build/walkthrough-creating-and-using-a-dynamic-link-library-cpp.md @@ -1,59 +1,56 @@ --- -title: "Walkthrough: Create and use your own Dynamic Link Library (C++)" -description: "Use C++ to create a Windows dynamic-link library (DLL) in Visual Studio." +title: "Create and Use Your Own Dynamic-Link Library (C++)" +description: "Learn how to use C++ to create a Windows dynamic-link library (DLL) in Visual Studio." ms.topic: tutorial -ms.date: 12/09/2021 +ms.date: 03/17/2025 helpviewer_keywords: ["libraries [C++], DLLs", "DLLs [C++], walkthroughs"] +ms.custom: sfi-image-nochange --- -# Walkthrough: Create and use your own Dynamic Link Library (C++) +# Walkthrough: Create and use your own dynamic-link library (C++) -This step-by-step walkthrough shows how to use the Visual Studio IDE to create your own dynamic link library (DLL) written in Microsoft C++ (MSVC). Then it shows how to use the DLL from another C++ app. DLLs (also known as *shared libraries* in UNIX-based operating systems) are one of the most useful kinds of Windows components. You can use them as a way to share code and resources, and to shrink the size of your apps. DLLs can even make it easier to service and extend your apps. +This step-by-step walkthrough explains how to use the Visual Studio IDE to create your own dynamic-link library (DLL) written in Microsoft C++ (MSVC), and how to use the DLL from another C++ app. DLLs, also known as *shared libraries* in UNIX-based operating systems, are one of the most useful kinds of Windows components. You can use them to share code and resources, and to shrink the size of your apps. DLLs can even make it easier to service and extend your apps. -In this walkthrough, you'll create a DLL that implements some math functions. Then you'll create a console app that uses the functions from the DLL. You'll also get an introduction to some of the programming techniques and conventions used in Windows DLLs. +In this walkthrough, you create a DLL that implements some math functions. Then you create a console app that uses the functions from the DLL. You also get an introduction to some of the programming techniques and conventions used in Windows DLLs. -This walkthrough covers these tasks: +This walkthrough covers the following steps: - Create a DLL project in Visual Studio. - - Add exported functions and variables to the DLL. - - Create a console app project in Visual Studio. - - Use the functions and variables imported from the DLL in the console app. - - Run the completed app. Like a statically linked library, a DLL _exports_ variables, functions, and resources by name. A client app _imports_ the names to use those variables, functions, and resources. Unlike a statically linked library, Windows connects the imports in your app to the exports in a DLL at load time or at run time, instead of connecting them at link time. Windows requires extra information that isn't part of the standard C++ compilation model to make these connections. The MSVC compiler implements some Microsoft-specific extensions to C++ to provide this extra information. We explain these extensions as we go. -This walkthrough creates two Visual Studio solutions; one that builds the DLL, and one that builds the client app. The DLL uses the C calling convention. It can be called from apps written in other programming languages, as long as the platform, calling conventions, and linking conventions match. The client app uses _implicit linking_, where Windows links the app to the DLL at load-time. This linking lets the app call the DLL-supplied functions just like the functions in a statically linked library. +This walkthrough creates two Visual Studio solutions: one that builds the DLL, and one that builds the client app. The DLL uses the C calling convention. It can be called from apps written in other programming languages, as long as the platform, calling conventions, and linking conventions match. The client app uses _implicit linking_, where Windows links the app to the DLL at load time. This linking lets the app call the DLL-supplied functions just like the functions in a statically linked library. -This walkthrough doesn't cover some common situations. The code doesn't show the use of C++ DLLs by other programming languages. It doesn't show how to [create a resource-only DLL](creating-a-resource-only-dll.md), or how to use [explicit linking](linking-an-executable-to-a-dll.md#linking-explicitly) to load DLLs at run-time rather than at load-time. Rest assured, you can use MSVC and Visual Studio to do all these things. +This walkthrough doesn't cover some common situations. The code doesn't show the use of C++ DLLs by other programming languages. It doesn't show how to [create a resource-only DLL](creating-a-resource-only-dll.md), or how to use [explicit linking](linking-an-executable-to-a-dll.md#linking-explicitly) to load DLLs at run time rather than at load time. Rest assured, you can use MSVC and Visual Studio to do all these things. -Even though the code of the DLL is written in C++, we've used C-style interfaces for the exported functions. There are two main reasons for this: First, many other languages support imports of C-style functions. The client app doesn't have to be written in C++. Second, it avoids some common pitfalls related to exported classes and member functions. It's easy to make hard-to-diagnose errors when exporting classes, since everything referred to within a class declaration has to have an instantiation that's also exported. This restriction applies to DLLs, but not static libraries. If your classes are plain-old-data style, you shouldn't run into this issue. +Even though the code of the DLL is written in C++, we use C-style interfaces for the exported functions. There are two main reasons for this: First, many other languages support imports of C-style functions. The client app doesn't have to be written in C++. Second, it avoids some common pitfalls related to exported classes and member functions. It's easy to make hard-to-diagnose errors when exporting classes, since everything referred to within a class declaration has to have an instantiation that's also exported. This restriction applies to DLLs, but not static libraries. If your classes are plain-old-data style, you shouldn't run into this issue. For links to more information about DLLs, see [Create C/C++ DLLs in Visual Studio](dlls-in-visual-cpp.md). For more information about implicit linking and explicit linking, see [Determine which linking method to use](linking-an-executable-to-a-dll.md#determining-which-linking-method-to-use). For information about creating C++ DLLs for use with programming languages that use C-language linkage conventions, see [Exporting C++ functions for use in C-language executables](exporting-cpp-functions-for-use-in-c-language-executables.md). For information about how to create DLLs for use with .NET languages, see [Calling DLL Functions from Visual Basic Applications](calling-dll-functions-from-visual-basic-applications.md). ## Prerequisites -- A computer that runs Microsoft Windows 7 or later versions. We recommend the latest version of Windows for the best development experience. +- Microsoft Windows 7 or later. We recommend the latest version of Windows for the best development experience. ::: moniker range=">=msvc-150" -- A copy of Visual Studio. For information on how to download and install Visual Studio, see [Install Visual Studio](/visualstudio/install/install-visual-studio). When you run the installer, make sure that the **Desktop development with C++** workload is checked. Don't worry if you didn't install this workload when you installed Visual Studio. You can run the installer again and install it now. +- Visual Studio. To learn how to download and install Visual Studio, see [Install Visual Studio](/visualstudio/install/install-visual-studio). When you run the installer, make sure that the **Desktop development with C++** workload is checked. Don't worry if you didn't install this workload when you installed Visual Studio. You can run the installer again and install it now. - ![Visual Studio Installer, Desktop development with C++ workload.](media/desktop-development-with-cpp.png "Desktop development with C++") + :::image type="content" source="media/desktop-development-with-cpp.png" alt-text="Screenshot of the Visual Studio Installer, Desktop development with C++ workload."::: ::: moniker-end ::: moniker range="msvc-140" -- A copy of Visual Studio. For information on how to download and install Visual Studio 2015, see [Install Visual Studio 2015](/visualstudio/install/install-visual-studio-2015?view=vs-2015&preserve-view=true). Use a **Custom** installation to install the C++ compiler and tools, since they're not installed by default. +- Visual Studio. For information on how to download and install Visual Studio 2015, see [Install Visual Studio 2015](/visualstudio/install/install-visual-studio-2015?view=vs-2015&preserve-view=true). Use a **Custom** installation to install the C++ compiler and tools, since they're not installed by default. ::: moniker-end - An understanding of the basics of using the Visual Studio IDE. If you've used Windows desktop apps before, you can probably keep up. For an introduction, see [Visual Studio IDE feature tour](/visualstudio/ide/visual-studio-ide). -- An understanding of enough of the fundamentals of the C++ language to follow along. Don't worry, we don't do anything too complicated. +- Some familiarity with the C++ language. Don't worry, we don't do anything too complicated. ::: moniker range="msvc-150" @@ -64,15 +61,15 @@ For links to more information about DLLs, see [Create C/C++ DLLs in Visual Studi ## Create the DLL project -In this set of tasks, you create a project for your DLL, add code, and build it. To begin, start the Visual Studio IDE, and sign in if you need to. The instructions vary slightly depending on which version of Visual Studio you're using. Make sure you have the correct version selected in the control in the upper left of this page. +In the following set of tasks, you create a project for your DLL, add code, and build it. To begin, start the Visual Studio IDE, and sign in if you need to. The instructions vary slightly depending on which version of Visual Studio you're using. To see the steps for your preferred version of Visual Studio, use the **Version** selector located at the top of the table of contents on this page. ::: moniker range=">=msvc-160" -### To create a DLL project in Visual Studio 2019 +### To create a DLL project in Visual Studio 1. On the menu bar, choose **File** > **New** > **Project** to open the **Create a New Project** dialog box. - ![Screenshot of the Create a new project dialog with the Dynamic Link Library template highlighted.](media/create-new-dll-project-2019.png "Create the MathLibrary project") + :::image type="content" source="media/create-new-dll-project-2019.png" alt-text="Screenshot of the Create a new project dialog box with the dynamic-link library template highlighted."::: 1. At the top of the dialog, set **Language** to **C++**, set **Platform** to **Windows**, and set **Project type** to **Library**. @@ -84,7 +81,7 @@ In this set of tasks, you create a project for your DLL, add code, and build it. When the solution is created, you can see the generated project and source files in the **Solution Explorer** window in Visual Studio. -![Screenshot of the Solution Explorer window with the Math Library project highlighted.](media/mathlibrary-solution-explorer-162.png "Generated solution in Visual Studio") + :::image type="content" source="media/mathlibrary-solution-explorer-162.png" alt-text="Screenshot of the Solution Explorer window with the MathLibrary project highlighted."::: ::: moniker-end @@ -96,13 +93,13 @@ When the solution is created, you can see the generated project and source files 1. In the left pane of the **New Project** dialog box, select **Installed** > **Visual C++** > **Windows Desktop**. In the center pane, select **Dynamic-Link Library (DLL)**. Enter *MathLibrary* in the **Name** box to specify a name for the project. Leave the default **Location** and **Solution name** values. Set **Solution** to **Create new solution**. Check **Create directory for solution** if it's unchecked. - ![Screenshot of the New Project dialog box showing Math Library in the Name text box.](media/mathlibrary-new-project-name-159.png "Name the MathLibrary project") + :::image type="content" source="media/mathlibrary-new-project-name-159.png" alt-text="Screenshot of the New Project dialog box in Visual Studio 2017 showing Math Library in the Name text box."::: 1. Choose the **OK** button to create the project. When the solution is created, you can see the generated project and source files in the **Solution Explorer** window in Visual Studio. -![Screenshot of the Solution Explorer window with the Math Library highlighted.](media/mathlibrary-solution-explorer-159.png "Generated solution in Visual Studio") +:::image type="content" source="media/mathlibrary-solution-explorer-159.png" alt-text="Screenshot of the Solution Explorer window in Visual Studio 2017 with the Math Library highlighted."::: ::: moniker-end @@ -114,21 +111,21 @@ When the solution is created, you can see the generated project and source files 1. In the left pane of the **New Project** dialog box, expand **Installed** > **Templates**, and select **Visual C++**, and then in the center pane, select **Win32 Console Application**. Enter *MathLibrary* in the **Name** edit box to specify a name for the project. Leave the default **Location** and **Solution name** values. Set **Solution** to **Create new solution**. Check **Create directory for solution** if it's unchecked. - ![Screenshot of the New Project dialog box showing Math Library in the Name text box.](media/mathlibrary-project-name.png "Name the MathLibrary project") + :::image type="content" source="media/mathlibrary-project-name.png" alt-text="Screenshot of the New Project dialog box in Visual Studio 2015 showing MathLibrary in the Name text box."::: 1. Choose the **OK** button to dismiss the **New Project** dialog and start the **Win32 Application Wizard**. - ![Screenshot of the Win32 Application Wizard Overview page.](media/mathlibrary-project-wizard-1.png "Win32 Application Wizard Overview") + :::image type="content" source="media/mathlibrary-project-wizard-1.png" alt-text="Screenshot of the Win32 Application Wizard Overview page."::: 1. Choose the **Next** button. On the **Application Settings** page, under **Application type**, select **DLL**. - ![Screenshot of the Win32 Application Wizard Application Settings Page.](media/mathlibrary-project-wizard-2.png "Create DLL in Win32 Application Wizard") + :::image type="content" source="media/mathlibrary-project-wizard-2.png" alt-text="Screenshot of the Win32 Application Wizard Application Settings Page."::: 1. Choose the **Finish** button to create the project. When the wizard completes the solution, you can see the generated project and source files in the **Solution Explorer** window in Visual Studio. -![Screenshot of the Solution Explorer window with the Math Library highlighted.](media/mathlibrary-solution-explorer-153.png "Generated solution in Visual Studio") +:::image type="content" source="media/mathlibrary-solution-explorer-153.png" alt-text="Screenshot of the Solution Explorer window in Visual Studio 2015 with the MathLibrary highlighted."::: ::: moniker-end @@ -138,13 +135,13 @@ Right now, this DLL doesn't do very much. Next, you'll create a header file to d 1. To create a header file for your functions, on the menu bar, choose **Project** > **Add New Item**. -1. In the **Add New Item** dialog box, in the left pane, select **Visual C++**. In the center pane, select **Header File (.h)**. Specify *MathLibrary.h* as the name for the header file. +1. In the **Add New Item** dialog box, in the left pane, select **Visual C++**. In the center pane, select **Header File (.h)**. Specify *`MathLibrary.h`* as the name for the header file. - ![Screenshot of the Add New Item dialog with the C plus plus Header File template selected, and MathLibrary.h entered in the Name textbox.](media/mathlibrary-add-new-item-header-file.png "Add header file in Add New Item dialog") + :::image type="content" source="media/mathlibrary-add-new-item-header-file.png" alt-text="Screenshot of the Add New Item dialog with the C plus plus Header File template selected, and MathLibrary.h entered in the Name textbox."::: 1. Choose the **Add** button to generate a blank header file, which is displayed in a new editor window. - ![Screenshot of the empty MathLibrary.h file in the editor.](media/edit-empty-mathlibrary-header.png "Empty MathLibrary.h file in editor") + :::image type="content" source="media/edit-empty-mathlibrary-header.png" alt-text="Screenshot of the empty MathLibrary.h file in the editor."::: 1. Replace the contents of the header file with this code: @@ -195,11 +192,11 @@ When the `MATHLIBRARY_EXPORTS` macro is defined, the `MATHLIBRARY_API` macro set ::: moniker range=">=msvc-160" -1. In **Solution Explorer**, right-click on the **Source Files** node and choose **Add** > **New Item**. Create a new .cpp file called *MathLibrary.cpp*, in the same way that you added a new header file in the previous step. +1. In **Solution Explorer**, right-click on the **Source Files** node and choose **Add** > **New Item**. Create a new *`.cpp`* file called *`MathLibrary.cpp`*, in the same way that you added a new header file in the previous step. -1. In the editor window, select the tab for **MathLibrary.cpp** if it's already open. If not, in **Solution Explorer**, double-click **MathLibrary.cpp** in the **Source Files** folder of the **MathLibrary** project to open it. +1. In the editor window, select the *`MathLibrary.cpp`* tab if it's already open. If not, in **Solution Explorer**, double-click *`MathLibrary.cpp`* in the **Source Files** folder of the **MathLibrary** project to open it. -1. In the editor, replace the contents of the MathLibrary.cpp file with the following code: +1. In the editor, replace the contents of the *`MathLibrary.cpp`* file with the following code: ```cpp // MathLibrary.cpp : Defines the exported functions for the DLL. @@ -266,7 +263,7 @@ When the `MATHLIBRARY_EXPORTS` macro is defined, the `MATHLIBRARY_API` macro set 1. In the editor window, select the tab for **MathLibrary.cpp** if it's already open. If not, in **Solution Explorer**, double-click **MathLibrary.cpp** in the **Source Files** folder of the **MathLibrary** project to open it. -1. In the editor, replace the contents of the MathLibrary.cpp file with the following code: +1. In the editor, replace the contents of the *`MathLibrary.cpp`* file with the following code: ```cpp // MathLibrary.cpp : Defines the exported functions for the DLL. @@ -329,7 +326,7 @@ When the `MATHLIBRARY_EXPORTS` macro is defined, the `MATHLIBRARY_API` macro set ::: moniker-end -To verify that everything works so far, compile the dynamic link library. To compile, choose **Build** > **Build Solution** on the menu bar. The DLL and related compiler output are placed in a folder called *Debug* directly below the solution folder. If you create a Release build, the output is placed in a folder called *Release*. The output should look something like this: +To verify that everything works so far, compile the DLL. To compile, choose **Build** > **Build Solution** on the menu bar. The DLL and related compiler output are placed in a folder called `Debug` directly below the solution folder. If you create a Release build, the output is placed in a folder called `Release`. The output should look something like this: ::: moniker range=">=msvc-160" @@ -380,9 +377,9 @@ Congratulations, you've created a DLL using Visual Studio! Next, you'll create a ## Create a client app that uses the DLL -When you create a DLL, think about how client apps may use it. To call the functions or access the data exported by a DLL, client source code must have the declarations available at compile time. At link time, the linker requires information to resolve the function calls or data accesses. A DLL supplies this information in an *import library*, a file that contains information about how to find the functions and data, instead of the actual code. And at run time, the DLL must be available to the client, in a location that the operating system can find. +When you create a DLL, think about how client apps might use it. To call the functions or access the data exported by a DLL, client source code must have the declarations available at compile time. At link time, the linker requires information to resolve the function calls or data accesses. A DLL supplies this information in an *import library*, a file that contains information about how to find the functions and data, instead of the actual code. And at run time, the DLL must be available to the client, in a location that the operating system can find. -Whether it's your own or from a third-party, your client app project needs several pieces of information to use a DLL. It needs to find the headers that declare the DLL exports, the import libraries for the linker, and the DLL itself. One solution is to copy all of these files into your client project. For third-party DLLs that are unlikely to change while your client is in development, this method may be the best way to use them. However, when you also build the DLL, it's better to avoid duplication. If you make a local copy of DLL files that are under development, you may accidentally change a header file in one copy but not the other, or use an out-of-date library. +Whether it's your own or from a third-party, your client app project needs several pieces of information to use a DLL. It needs to find the headers that declare the DLL exports, the import libraries for the linker, and the DLL itself. One solution is to copy all of these files into your client project. For third-party DLLs that are unlikely to change while your client is in development, this method might be the best way to use them. However, when you also build the DLL, it's better to avoid duplication. If you make a local copy of DLL files that are under development, you might accidentally change a header file in one copy but not the other, or use an out-of-date library. To avoid out-of-sync code, we recommend you set the include path in your client project to include the DLL header files directly from your DLL project. Also, set the library path in your client project to include the DLL import libraries from the DLL project. And finally, copy the built DLL from the DLL project into your client build output directory. This step allows your client app to use the same DLL code you build. @@ -398,11 +395,11 @@ To avoid out-of-sync code, we recommend you set the include path in your client 1. In the **Configure your new project** page, enter *MathClient* in the **Project name** box to specify a name for the project. Leave the default **Location** and **Solution name** values. Set **Solution** to **Create new solution**. Uncheck **Place solution and project in the same directory** if it's checked. - ![Screenshot of the Create a new project dialog box with the Console App option highlighted.](media/mathclient-project-name-2019.png "Name the client project") + :::image type="content" source="media/mathclient-project-name-2019.png" alt-text="Screenshot of the Create a new project dialog box with the Console App option highlighted."::: 1. Choose the **Create** button to create the client project. -A minimal console application project is created for you. The name for the main source file is the same as the project name that you entered earlier. In this example, it's named **MathClient.cpp**. You can build it, but it doesn't use your DLL yet. +A minimal console application project is created for you. The name for the main source file is the same as the project name that you entered earlier. In this example, it's named *`MathClient.cpp`*. You can build it, but it doesn't use your DLL yet. ::: moniker-end @@ -412,13 +409,13 @@ A minimal console application project is created for you. The name for the main 1. To create a C++ app that uses the DLL that you created, on the menu bar, choose **File** > **New** > **Project**. -1. In the left pane of the **New Project** dialog, select **Windows Desktop** under **Installed** > **Visual C++**. In the center pane, select **Windows Console Application**. Specify the name for the project, *MathClient*, in the **Name** edit box. Leave the default **Location** and **Solution name** values. Set **Solution** to **Create new solution**. Check **Create directory for solution** if it's unchecked. +1. In the left pane of the **New Project** dialog, select **Windows Desktop** under **Installed** > **Visual C++**. In the center pane, select **Windows Console Application**. Specify the name for the project, *MathClient*, in the **Name** edit box. Leave the default **Location** and **Solution name** values. Set **Solution** to **Create new solution**. Check **Create directory for solution** if it's unchecked. - ![Screenshot of the New Project dialog box with Installed > Visual C plus plus > Windows Desktop selected, Windows Console Application highlighted, and Math Client typed in the Name text box.](media/mathclient-new-project-name-159.png "Name the client project") + :::image type="content" source="media/mathclient-new-project-name-159.png" alt-text="Screenshot of the New Project dialog box with Windows Console Application highlighted, and Math Client typed in the Name text box."::: 1. Choose **OK** to create the client app project. -A minimal console application project is created for you. The name for the main source file is the same as the project name that you entered earlier. In this example, it's named **MathClient.cpp**. You can build it, but it doesn't use your DLL yet. +A minimal console application project is created for you. The name for the main source file is the same as the project name that you entered earlier. In this example, it's named *`MathClient.cpp`*. You can build it, but it doesn't use your DLL yet. ::: moniker-end @@ -430,7 +427,7 @@ A minimal console application project is created for you. The name for the main 1. In the left pane of the **New Project** dialog, select **Win32** under **Installed** > **Templates** > **Visual C++**. In the center pane, select **Win32 Console Application**. Specify the name for the project, *MathClient*, in the **Name** edit box. Leave the default **Location** and **Solution name** values. Set **Solution** to **Create new solution**. Check **Create directory for solution** if it's unchecked. - ![Screenshot of the New Project dialog box with Installed > Templates > Visual C plus plus > Win32 selected, Win32 Console Application Visual C plus plus highlighted, and Math Client typed in the Name text box.](media/mathclient-project-name.png "Name the client project") + :::image type="content" source="media/mathclient-project-name.png" alt-text="Screenshot of the New Project dialog box with Win32 Console Application Visual C plus plus highlighted, and Math Client typed in the Name text box."::: 1. Choose the **OK** button to dismiss the **New Project** dialog and start the **Win32 Application Wizard**. On the **Overview** page of the **Win32 Application Wizard** dialog box, choose the **Next** button. @@ -438,27 +435,27 @@ A minimal console application project is created for you. The name for the main 1. Choose the **Finish** button to create the project. -When the wizard finishes, a minimal console application project is created for you. The name for the main source file is the same as the project name that you entered earlier. In this example, it's named **MathClient.cpp**. You can build it, but it doesn't use your DLL yet. +When the wizard finishes, a minimal console application project is created for you. The name for the main source file is the same as the project name that you entered earlier. In this example, it's named *`MathClient.cpp`*. You can build it, but it doesn't use your DLL yet. ::: moniker-end -Next, to call the MathLibrary functions in your source code, your project must include the *MathLibrary.h* file. You could copy this header file into your client app project, then add it to the project as an existing item. This method can be a good choice for third-party libraries. However, if you're working on the code for your DLL and your client at the same time, the header files could get out of sync. To avoid this issue, set the **Additional Include Directories** path in your project to include the path to the original header. +Next, to call the MathLibrary functions in your source code, your project must include the *`MathLibrary.h`* file. You could copy this header file into your client app project, then add it to the project as an existing item. This method can be a good choice for third-party libraries. However, if you're working on the code for your DLL and your client at the same time, the header files could get out of sync. To avoid this issue, set the **Additional Include Directories** path in your project to include the path to the original header. ### To add the DLL header to your include path 1. Right-click on the **MathClient** node in **Solution Explorer** to open the **Property Pages** dialog. -1. In the **Configuration** drop-down box, select **All Configurations** if it's not already selected. +1. In the **Configuration** dropdown box, select **All Configurations** if it's not already selected. 1. In the left pane, select **Configuration Properties** > **C/C++** > **General**. -1. In the property pane, select the drop-down control next to the **Additional Include Directories** edit box, and then choose **Edit**. +1. In the property pane, select the dropdown control next to the **Additional Include Directories** edit box, and then choose **Edit**. - ![Screenshot of the Property Pages dialog showing the Edit command in the Additional Include Directories property drop-down.](media/mathclient-additional-include-directories-property.png "Edit the Additional Include Directories property") + :::image type="content" source="media/mathclient-additional-include-directories-property.png" alt-text="Screenshot of the Property Pages dialog showing the Edit command in the Additional Include Directories property dropdown."::: 1. Double-click in the top pane of the **Additional Include Directories** dialog box to enable an edit control. Or, choose the folder icon to create a new entry. -1. In the edit control, specify the path to the location of the **MathLibrary.h** header file. You can choose the ellipsis (**...**) control to browse to the correct folder. +1. In the edit control, specify the path to the location of the *`MathLibrary.h`* header file. You can choose the ellipsis (**...**) control to browse to the correct folder. You can also enter a relative path from your client source files to the folder that contains the DLL header files. If you followed the directions to put your client project in a separate solution from the DLL, the relative path should look like this: @@ -470,11 +467,11 @@ Next, to call the MathLibrary functions in your source code, your project must i When the DLL and client projects are in other folders, adjust the relative path to match. Or, use the ellipsis control to browse for the folder. - ![Screenshot of the Additional Include Directories dialog showing the relative path to the MathLibrary directory.](media/mathclient-additional-include-directories.png "Add the header location to the Additional Include Directories property") + :::image type="content" source="media/mathclient-additional-include-directories.png" alt-text="Screenshot of the Additional Include Directories dialog showing the relative path to the MathLibrary directory."::: 1. After you've entered the path to the header file in the **Additional Include Directories** dialog box, choose the **OK** button. In the **Property Pages** dialog box, choose the **OK** button to save your changes. -You can now include the **MathLibrary.h** file and use the functions it declares in your client application. Replace the contents of **MathClient.cpp** by using this code: +You can now include the *`MathLibrary.h`* file and use the functions it declares in your client application. Replace the contents of *`MathClient.cpp`* by using this code: ```cpp // MathClient.cpp : Client app for MathLibrary DLL. @@ -498,51 +495,51 @@ int main() } ``` -This code can be compiled, but not linked. If you build the client app now, the error list shows several LNK2019 errors. That's because your project is missing some information: You haven't specified that your project has a dependency on the *MathLibrary.lib* library yet. And, you haven't told the linker how to find the *MathLibrary.lib* file. +This code can be compiled, but not linked. If you build the client app now, the error list shows several LNK2019 errors. That's because your project is missing some information: You haven't specified that your project has a dependency on the *`MathLibrary.lib`* library yet. And, you haven't told the linker how to find the *`MathLibrary.lib`* file. -To fix this issue, you could copy the library file directly into your client app project. The linker would find and use it automatically. However, if both the library and the client app are under development, that might lead to changes in one copy that aren't shown in the other. To avoid this issue, you can set the **Additional Dependencies** property to tell the build system that your project depends on *MathLibrary.lib*. And, you can set an **Additional Library Directories** path in your project to include the path to the original library when you link. +To fix this issue, you could copy the library file directly into your client app project. The linker would find and use it automatically. However, if both the library and the client app are under development, that might lead to changes in one copy that aren't shown in the other. To avoid this issue, you can set the **Additional Dependencies** property to tell the build system that your project depends on *`MathLibrary.lib`*. And, you can set an **Additional Library Directories** path in your project to include the path to the original library when you link. ### To add the DLL import library to your project 1. Right-click on the **MathClient** node in **Solution Explorer** and choose **Properties** to open the **Property Pages** dialog. -1. In the **Configuration** drop-down box, select **All Configurations** if it's not already selected. It ensures that any property changes apply to both Debug and Release builds. +1. In the **Configuration** dropdown box, select **All Configurations** if it's not already selected. It ensures that any property changes apply to both Debug and Release builds. -1. In the left pane, select **Configuration Properties** > **Linker** > **Input**. In the property pane, select the drop-down control next to the **Additional Dependencies** edit box, and then choose **Edit**. +1. In the left pane, select **Configuration Properties** > **Linker** > **Input**. In the property pane, select the dropdown control next to the **Additional Dependencies** edit box, and then choose **Edit**. - ![Screenshot of the Property Pages dialog showing the Edit command in the Linker > Input > Additional Dependencies property drop-down.](media/mathclient-additional-dependencies-property.png "Edit the Additional Dependencies property") + :::image type="content" source="media/mathclient-additional-dependencies-property.png" alt-text="Screenshot of the Property Pages dialog box under Input that shows the Edit command in the Additional Dependencies property dropdown."::: -1. In the **Additional Dependencies** dialog, add *MathLibrary.lib* to the list in the top edit control. +1. In the **Additional Dependencies** dialog, add *`MathLibrary.lib`* to the list in the top edit control. - ![Screenshot of the Additional Dependencies dialog showing the MathLibrary.lib file.](media/mathclient-additional-dependencies.png "Add the library dependency") + :::image type="content" source="media/mathclient-additional-dependencies.png" alt-text="Screenshot of the Additional Dependencies dialog box showing the MathLibrary.lib file."::: 1. Choose **OK** to go back to the **Property Pages** dialog box. -1. In the left pane, select **Configuration Properties** > **Linker** > **General**. In the property pane, select the drop-down control next to the **Additional Library Directories** edit box, and then choose **Edit**. +1. In the left pane, select **Configuration Properties** > **Linker** > **General**. In the property pane, select the dropdown control next to the **Additional Library Directories** edit box, and then choose **Edit**. - ![Screenshot of the Property Pages dialog showing the Edit command in the Linker > General > Additional Library Directories property drop-down.](media/mathclient-additional-library-directories-property.png "Edit the Additional Library Directories property") + :::image type="content" source="media/mathclient-additional-library-directories-property.png" alt-text="Screenshot of the Property Pages dialog box under General that shows the Edit command in the Additional Library Directories property dropdown."::: -1. Double-click in the top pane of the **Additional Library Directories** dialog box to enable an edit control. In the edit control, specify the path to the location of the **MathLibrary.lib** file. By default, it's in a folder called *Debug* directly under the DLL solution folder. If you create a release build, the file is placed in a folder called *Release*. You can use the `$(IntDir)` macro so that the linker can find your DLL, no matter which kind of build you create. If you followed the directions to put your client project in a separate solution from the DLL project, the relative path should look like this: +1. Double-click in the top pane of the **Additional Library Directories** dialog box to enable an edit control. In the edit control, specify the path to the location of the *`MathLibrary.lib`* file. By default, it's in a folder called *Debug* directly under the DLL solution folder. If you create a release build, the file is placed in a folder called *Release*. You can use the `$(IntDir)` macro so that the linker can find your DLL, no matter which kind of build you create. If you followed the directions to put your client project in a separate solution from the DLL project, the relative path should look like this: `..\..\MathLibrary\$(IntDir)` If your DLL and client projects are in other locations, adjust the relative path to match. - ![Screenshot of the Additional Library Directories dialog.](media/mathclient-additional-library-directories.png "Add the library directory") + :::image type="content" source="media/mathclient-additional-library-directories.png" alt-text="Screenshot of the Additional Library Directories dialog."::: 1. Once you've entered the path to the library file in the **Additional Library Directories** dialog box, choose the **OK** button to go back to the **Property Pages** dialog box. Choose **OK** to save the property changes. Your client app can now compile and link successfully, but it still doesn't have everything it needs to run. When the operating system loads your app, it looks for the MathLibrary DLL. If it can't find the DLL in certain system directories, the environment path, or the local app directory, the load fails. Depending on the operating system, you'll see an error message like this: -![Screenshot of the error dialog, MathLibrary DLL not found.](media/mathclient-system-error-mathlibrary-dll-not-found.png "MathLibrary DLL not found error") +:::image type="content" source="media/mathclient-system-error-mathlibrary-dll-not-found.png" alt-text="Screenshot of the error dialog, MathLibrary DLL not found."::: -One way to avoid this issue is to copy the DLL to the directory that contains your client executable as part of the build process. You can add a **Post-Build Event** to your project, to add a command that copies the DLL to your build output directory. The command specified here copies the DLL only if it's missing or has changed. It uses macros to copy to and from the Debug or Release locations, based on your build configuration. +One way to avoid this issue is to copy the DLL to the directory that contains your client executable as part of the build process. You can add a *post-build event* to your project, to add a command that copies the DLL to your build output directory. The command specified here copies the DLL only if it's missing or has changed. It uses macros to copy to and from the Debug or Release locations, based on your build configuration. ### To copy the DLL in a post-build event 1. Right-click on the **MathClient** node in **Solution Explorer** and choose **Properties** to open the **Property Pages** dialog. -1. In the **Configuration** drop-down box, select **All Configurations** if it isn't already selected. +1. In the **Configuration** dropdown box, select **All Configurations** if it isn't already selected. 1. In the left pane, select **Configuration Properties** > **Build Events** > **Post-Build Event**. @@ -552,7 +549,7 @@ One way to avoid this issue is to copy the DLL to the directory that contains yo If your DLL and client projects are in other directories, change the relative path to the DLL to match. - ![Screenshot of the Property Pages dialog showing the post build event command line property.](media/mathclient-post-build-command-line.png "Add the post-build command") + :::image type="content" source="media/mathclient-post-build-command-line.png" alt-text="Screenshot of the Property Pages dialog showing the post build event command line property."::: 1. Choose the **OK** button to save your changes to the project properties. @@ -568,14 +565,14 @@ Now your client app has everything it needs to build and run. Build the applicat Congratulations, you've created an application that calls functions in your DLL. Now run your application to see what it does. On the menu bar, choose **Debug** > **Start Without Debugging**. Visual Studio opens a command window for the program to run in. The last part of the output should look like: -![Screenshot of the command window output when you start the client app without debugging.](media/mathclient-run-without-debugging.png "Start the client app without debugging") +:::image type="content" source="media/mathclient-run-without-debugging.png" alt-text="Screenshot of the command window output when you start the client app without debugging."::: Press any key to dismiss the command window. Now that you've created a DLL and a client application, you can experiment. Try setting breakpoints in the code of the client app, and run the app in the debugger. See what happens when you step into a library call. Add other functions to the library, or write another client app that uses your DLL. -When you deploy your app, you must also deploy the DLLs it uses. The simplest way to make the DLLs that you build, or that you include from third parties, available is to put them in the same directory as your app. It's known as *app-local deployment*. For more information about deployment, see [Deployment in Visual C++](../windows/deployment-in-visual-cpp.md). +When you deploy your app, you must also deploy the DLLs it uses. The simplest way to make the DLLs that you build, or that you include from third parties, available is to put them in the same directory as your app. It's known as *app-local deployment*. For more information about deployment, see [Deployment in Microsoft C++](../windows/deployment-in-visual-cpp.md). ## See also -[Calling DLL Functions from Visual Basic Applications](calling-dll-functions-from-visual-basic-applications.md) +- [Calling DLL Functions from Visual Basic Applications](calling-dll-functions-from-visual-basic-applications.md) diff --git a/docs/build/walkthrough-header-units.md b/docs/build/walkthrough-header-units.md index 2a21f566b61..4e7de18c974 100644 --- a/docs/build/walkthrough-header-units.md +++ b/docs/build/walkthrough-header-units.md @@ -1,6 +1,6 @@ --- description: "Learn more about C++ header units. Convert a header file to a header unit using Visual Studio 2022." -title: "Walkthrough: Build and import header units in Visual C++ projects" +title: "Walkthrough: Build and import header units in Microsoft C++ projects" ms.date: 09/29/2022 ms.custom: "conceptual" author: "tylermsft" @@ -9,7 +9,7 @@ helpviewer_keywords: ["import", "header unit", "ifc"] monikerRange: '>=msvc-160' --- -# Walkthrough: Build and import header units in Microsoft Visual C++ +# Walkthrough: Build and import header units in Microsoft C++ This article is about building and importing header units with Visual Studio 2022. To learn how to import C++ standard library headers as header units, see [Walkthrough: Import STL libraries as header units](walkthrough-import-stl-header-units.md). For an even faster and more robust way to import the standard library, see [Tutorial: Import the C++ standard library using modules](../cpp/tutorial-import-stl-named-module.md). diff --git a/docs/build/walkthrough-import-stl-header-units.md b/docs/build/walkthrough-import-stl-header-units.md index 4a6f8830b17..1f50e2518f9 100644 --- a/docs/build/walkthrough-import-stl-header-units.md +++ b/docs/build/walkthrough-import-stl-header-units.md @@ -182,8 +182,8 @@ Follow these steps to create a project that includes two STL libraries: `; - #include ; + #include + #include int main() { @@ -221,5 +221,5 @@ The main consideration for whether to use this approach is the balance between c [Compare header units, modules, and precompiled headers](compare-inclusion-methods.md)\ [Tutorial: Import the C++ standard library using modules](../cpp/tutorial-import-stl-named-module.md)\ -[Walkthrough: Build and import header units in your Visual C++ projects](walkthrough-header-units.md)\ +[Walkthrough: Build and import header units in your Microsoft C++ projects](walkthrough-header-units.md)\ [`/translateInclude`](./reference/translateinclude.md) diff --git a/docs/build/walkthrough-using-msbuild-to-create-a-visual-cpp-project.md b/docs/build/walkthrough-using-msbuild-to-create-a-visual-cpp-project.md index 9543859eee4..b96564b5d3c 100644 --- a/docs/build/walkthrough-using-msbuild-to-create-a-visual-cpp-project.md +++ b/docs/build/walkthrough-using-msbuild-to-create-a-visual-cpp-project.md @@ -4,9 +4,9 @@ description: "A walkthrough that shows how to create a command-line MSBuild C++ ms.date: 10/08/2020 helpviewer_keywords: ["MSBuild (C++), walkthrough: create a project"] --- -# Walkthrough: Using MSBuild to Create a Visual C++ Project +# Walkthrough: Using MSBuild to Create a Visual Studio C++ Project -This walkthrough demonstrates how to use MSBuild in a command prompt to build a Visual Studio C++ project. You'll learn how to create an XML-based *`.vcxproj`* project file for a Visual C++ console application. After building the project, you'll learn how to customize the build process. +This walkthrough demonstrates how to use MSBuild in a command prompt to build a Visual Studio C++ project. You'll learn how to create an XML-based *`.vcxproj`* project file for a C++ console application. After building the project, you'll learn how to customize the build process. > [!IMPORTANT] > Don't use this approach if you intend to edit the project file later by using the Visual Studio IDE. If you create a *`.vcxproj`* file manually, the Visual Studio IDE might not be able to edit or load it, especially if the project uses wildcards in project items. For more information, see [`.vcxproj` and `.props` file structure](./reference/vcxproj-file-structure.md) and [`.vcxproj` files and wildcards](./reference/vcxproj-files-and-wildcards.md). @@ -78,15 +78,15 @@ In this walkthrough, you'll create a project that has a source file and a header An MSBuild project file is an XML file that contains a project root element (``). In the example project you'll build, the `` element contains seven child elements: - Three item group tags (``) that specify project configuration and platform, source file name, and header file name. -- Three import tags (``) that specify the location of Microsoft Visual C++ settings. +- Three import tags (``) that specify the location of Microsoft C++ settings. - A property group tag (``) that specifies project settings. ### To create the MSBuild project file -1. Use a text editor to create a project file that is named *`myproject.vcxproj`*, and then add the root `` element shown here. (Use `ToolsVersion="14.0"` if you're using Visual Studio 2015, `ToolsVersion="15.0"` if you're using Visual Studio 2017, or `ToolsVersion="16.0"` if you're using Visual Studio 2019.) +1. Use a text editor to create a project file that is named *`myproject.vcxproj`*, and then add the root `` element shown here. (Use `ToolsVersion="14.0"` if you're using Visual Studio 2015, `ToolsVersion="15.0"` if you're using Visual Studio 2017, `ToolsVersion="16.0"` if you're using Visual Studio 2019, or `ToolsVersion="17.0"` if you're using Visual Studio 2022.) ```xml - + ``` @@ -113,12 +113,12 @@ An MSBuild project file is an XML file that contains a project root element (`

``` -1. Add a property group element (``) that specifies two project properties, `` and ``. (Use `v140` as the `` value if you're using Visual Studio 2015, `v141` if you're using Visual Studio 2017, or `v142` if you're using Visual Studio 2019.) +1. Add a property group element (``) that specifies two project properties, `` and ``. (Use `v140` as the `` value if you're using Visual Studio 2015, `v141` if you're using Visual Studio 2017, `v142` if you're using Visual Studio 2019 or `v143` if you're using Visual Studio 2022.) ```xml Application - v142 + v143 ``` @@ -155,10 +155,10 @@ An MSBuild project file is an XML file that contains a project root element (`

+ Debug @@ -249,7 +249,7 @@ At the command prompt, enter this command to use the 64-bit tools to build your ### Using MSBuild with a different toolset -If you have the toolsets and libraries for other versions of Visual C++ installed, MSBuild can build applications for either the current Visual C++ version or for the other installed versions. For example, if you have installed Visual Studio 2012, to specify the Visual C++ 11.0 toolset for Windows XP, add this property group element to the *`Myproject.vcxproj`* project file after the *`Microsoft.Cpp.props`* file `` element: +If you have the toolsets and libraries for other versions of Microsoft C++ (MSVC) installed, MSBuild can build applications for either the current MSVC version or for the other installed versions. For example, if you have installed Visual Studio 2012, to specify the Visual C++ 11.0 toolset for Windows XP, add this property group element to the *`Myproject.vcxproj`* project file after the *`Microsoft.Cpp.props`* file `` element: ```xml diff --git a/docs/build/why-floating-point-numbers-may-lose-precision.md b/docs/build/why-floating-point-numbers-may-lose-precision.md index 7fc2eb91e9a..45605f0aa43 100644 --- a/docs/build/why-floating-point-numbers-may-lose-precision.md +++ b/docs/build/why-floating-point-numbers-may-lose-precision.md @@ -17,7 +17,7 @@ This behavior is the result of one of the following: To resolve the behavior, most programmers either ensure that the value is greater or less than what is needed, or they get and use a Binary Coded Decimal (BCD) library that will maintain the precision. -Binary representation of floating-point values affects the precision and accuracy of floating-point calculations. Microsoft Visual C++ uses [IEEE floating-point format](ieee-floating-point-representation.md). +Binary representation of floating-point values affects the precision and accuracy of floating-point calculations. Microsoft C++ uses [IEEE floating-point format](ieee-floating-point-representation.md). ## Example diff --git a/docs/build/working-with-project-properties.md b/docs/build/working-with-project-properties.md index 8cd9eae55a3..b6ca518f4c8 100644 --- a/docs/build/working-with-project-properties.md +++ b/docs/build/working-with-project-properties.md @@ -1,38 +1,39 @@ --- -title: "Set C++ compiler and build properties in Visual Studio" +title: "Set C++ Compiler and Build Properties in Visual Studio" description: "Use the Visual Studio IDE to change C++ compiler and linker options and other build settings." -ms.date: "07/17/2019" +ms.date: 03/19/2025 +ms.topic: concept-article helpviewer_keywords: ["project properties [C++], modifying", "properties [C++]", "Visual C++ projects, properties", "projects [C++], properties"] --- # Set compiler and build properties -In the IDE, properties expose the information needed to build a project. This information includes the application name, extension (such as DLL, LIB, EXE), compiler options, linker options, debugger settings, custom build steps, and many other things. Typically, you use *property pages* to view and modify these properties. To access the property pages, choose **Project** > **_project-name_ Properties** from the main menu, or right-click on the project node in **Solution Explorer** and choose **Properties**. +In the Visual Studio IDE, you can view and edit the properties needed to compile and build a project. This information includes the application name, extension (such as DLL, LIB, EXE), compiler options, linker options, debugger settings, and custom build steps. + +You can view and modify these properties by using *property pages*. To access the property pages, choose **Project** > **_project-name_ Properties** from the main menu, or right-click on the project node in **Solution Explorer** and choose **Properties**. ## Default properties -When you create a project, the system assigns values for various properties. The defaults vary somewhat depending on the kind of project and what options you choose in the app wizard. For example, an ATL project has properties related to MIDL files, but these properties are absent in a basic console application. The default properties are shown in the General pane in the Property Pages: +When you create a project, the system assigns values for various properties. The defaults vary somewhat depending on the kind of project and what options you choose in the app wizard. For example, an Active Template Library (ATL) project has properties related to Microsoft Interface Definition Language (MIDL) files, but these properties are absent in a basic console application. The default properties are shown in the Advanced pane in the **Property Pages** window: -:::image type="complex" source="media/visual-c---project-defaults.png" alt-text="Screenshot of the Visual Studio project properties dialog."::: -The General page is open. The Project Defaults section is highlighted, which includes Configuration Type set to Application (.exe), use of MFC set to Use standard Windows libraries, Character set is Unicode, Common Language Runtime Support is set to No Common Language Runtime Support, Whole Program optimization is set to No Whole Program Optimization, and Windows Store APP support is set to No. -:::image-end::: +:::image type="content" source="media/visual-c---project-defaults.png" alt-text="Screenshot of the Visual Studio project properties dialog box with the Advanced pane selected. Properties such as Use of MFC, Character Set, and so on are highlighted." lightbox="media/visual-c---project-defaults.png"::: -## Applying properties to build configurations and target platforms +## Apply properties to build configurations and target platforms Some properties, such as the application name, apply to all build variations and target platforms, whether it's a debug or release build. But most properties are configuration-dependent. To generate the correct code, the compiler has to know both the specific platform the program runs on and which specific compiler options to use. So when you set a property, it's important to pay attention to which configuration and platform the new value should apply to. Should it apply only to Debug Win32 builds, or should it also apply to Debug ARM64 and Debug x64? For example, the **Optimization** property, by default, is set to **Maximize Speed (/O2)** in a Release configuration, but is disabled in the Debug configuration. -You can always see and change the configuration and platform a property value should apply to. The following illustration shows the property pages with the configuration and platform information controls at the top. When the **Optimization** property is set here, it only applies to Debug Win32 builds, the currently active configuration, as shown by the red arrows. +You can always see and change the configuration and platform a property value should apply to. The following illustration shows the property pages with the configuration and platform information controls at the top. When the **Optimization** property is set here, it only applies to Debug x64 builds, the currently active configuration, as shown by the red arrows. :::image type="complex" source="media/visual-c---property-pages-showing-active-configuration.png" alt-text="Screenshot of the Visual Studio Property Pages dialog."::: -The page is open to C/C++, Optimization. The Optimization setting is set to Disabled (/Od), which is called out. An arrow calls out the relationship between the Configuration setting in the project property page, which is set to Active(Debug), and the setting in the Solution configuration dropdown on the toolbar, which is set to Debug. Another arrow calls out the relationship between the Platform setting in the project property page, which is set to Active(Win32), and the setting in the Solutions platform dropdown on the toolbar, which is set to x86. +The page is open to C/C++, Optimization. The Optimization setting is set to Disabled (/Od), which is called out. An arrow calls out the relationship between the Configuration setting in the project property page, which is set to Active(Debug), and the setting in the Solution configuration dropdown on the toolbar, which is set to Debug. Another arrow calls out the relationship between the Platform setting in the project property page, which is set to Active(x64), and the setting in the Solutions platform dropdown on the toolbar, which is set to x64. :::image-end::: The following illustration shows the same project property page, but the configuration has been changed to Release. Note the different value for the Optimization property. Also note that the active configuration is still Debug. You can set properties for any configuration here; it doesn't have to be the active one. -:::image type="content" source="media/visual-c---property-pages-showing-release-config.png" alt-text="Screenshot of the Visual Studio project Property Pages dialog. The Configuration dropdown is called out and is set to Release. The C/C++ > Optimization > Optimization setting is set to Maximize Speed (/O2)."::: +:::image type="content" source="media/visual-c---property-pages-showing-release-config.png" alt-text="Screenshot of the Visual Studio project Property Pages dialog. The Configuration dropdown is called out and is set to Release. The optimization setting is set to Maximize Speed slash O2."::: ## Target platforms -*Target platform* refers to the kind of device and operating system that the executable will run on. You can build a project for more than one platform. The available target platforms for C++ projects depend on the kind of project. They include but aren't limited to Win32, x64, ARM, ARM64, Android, and iOS. The **x86** target platform that you might see in **Configuration Manager** is identical to **Win32** in native C++ projects. Win32 means 32-bit Windows and **x64** means 64-bit Windows. For more information about these two platforms, see [Running 32-bit applications](/windows/win32/WinProg64/running-32-bit-applications). +*Target platform* refers to the kind of device and operating system that the executable runs on. You can build a project for more than one platform. The available target platforms for C++ projects depend on the kind of project. They include but aren't limited to Win32, x64, ARM, ARM64, Android, and iOS. The **x86** target platform that you might see in **Configuration Manager** is identical to **Win32** in native C++ projects. Win32 means 32-bit Windows and **x64** means 64-bit Windows. For more information about these two platforms, see [Running 32-bit applications](/windows/win32/WinProg64/running-32-bit-applications). The **Any CPU** target platform value that you might see in **Configuration Manager** has no effect on native C++ projects. It's only relevant for C++/CLI and other .NET project types. For more information, see [`/CLRIMAGETYPE` (Specify Type of CLR Image)](reference/clrimagetype-specify-type-of-clr-image.md). @@ -40,7 +41,7 @@ For more information about setting properties for a Debug build, see: - [Project settings for a C++ debug configuration](/visualstudio/debugger/project-settings-for-a-cpp-debug-configuration) - [Debugger Settings and Preparation](/visualstudio/debugger/debugger-settings-and-preparation) -- [Debugging Preparation: Visual C++ Project Types](/visualstudio/debugger/debugging-preparation-visual-cpp-project-types) +- [Debugging Preparation: Microsoft C++ Project Types](/visualstudio/debugger/debugging-preparation-visual-cpp-project-types) - [Specify symbol (.pdb) and source files in the Visual Studio debugger](/visualstudio/debugger/specify-symbol-dot-pdb-and-source-files-in-the-visual-studio-debugger) ## C++ compiler and linker options @@ -51,7 +52,7 @@ The **Property Pages** dialog box shows only the property pages that are relevan ## Directory and path values -MSBuild supports the use of compile-time constants for certain string values, such as include directories and paths, called *macros*. A macro can refer to a value that's defined by Visual Studio or the MSBuild system, or to a user-defined value. Macros look like `$(macro-name)` or `%(item-macro-name)`. They're exposed in the property pages, where you can refer to and modify them by using the [Property Editor](#property_editor). Use macros instead of hard-coded values such as directory paths. Macros make it easier to share property settings between machines and between versions of Visual Studio. And, you can better ensure that your project settings participate correctly in [property inheritance](project-property-inheritance.md). +MSBuild supports the use of compile-time constants for certain string values, such as include directories and paths, called *macros*. A macro can refer to a value that's defined by Visual Studio or the MSBuild system, or to a user-defined value. Macros look like `$(macro-name)` or `%(item-macro-name)`. They're exposed in the property pages, where you can refer to and modify them by using the [Property Editor](#property_editor). Use macros instead of hard-coded values such as directory paths. Macros make it easier to share property settings between machines and between versions of Visual Studio. You can also better ensure that your project settings participate correctly in [property inheritance](project-property-inheritance.md). The following illustration shows the property pages for a Visual Studio C++ project. In the left pane, the **VC++ Directories** *rule* is selected, and the right pane lists the properties that are associated with that rule. The property values are often macros, such as `$(VC_SourcePath)`: @@ -63,21 +64,21 @@ You can use the [Property Editor](#property_editor) to view the values of all av ### Predefined macros -- **Global macros**:\ +- **Global macros**\ Global macros apply to all items in a project configuration. A global macro has the syntax `$(name)`. An example of a global macro is `$(VCInstallDir)`, which stores the root directory of your Visual Studio installation. A global macro corresponds to a `PropertyGroup` in MSBuild. - **Item macros**\ - Item macros have the syntax `%(name)`. For a file, an item macro applies only to that file—for example, you can use `%(AdditionalIncludeDirectories)` to specify include directories that apply only to a particular file. This kind of item macro corresponds to an `ItemGroup` metadata in MSBuild. When used in the context of a project configuration, an item macro applies to all files of a certain type. For example, the C/C++ **Preprocessor Definitions** configuration property can take a `%(PreprocessorDefinitions)` item macro that applies to all .cpp files in the project. This kind of item macro corresponds to an `ItemDefinitionGroup` metadata in MSBuild. For more information, see [Item Definitions](/visualstudio/msbuild/item-definitions). + Item macros have the syntax `%(name)`. For a file, an item macro applies only to that file. For example, you can use `%(AdditionalIncludeDirectories)` to specify include directories that apply only to a particular file. This kind of item macro corresponds to an `ItemGroup` metadata in MSBuild. When used in the context of a project configuration, an item macro applies to all files of a certain type. For example, the C/C++ **Preprocessor Definitions** configuration property can take a `%(PreprocessorDefinitions)` item macro that applies to all .cpp files in the project. This kind of item macro corresponds to an `ItemDefinitionGroup` metadata in MSBuild. For more information, see [Item definitions](/visualstudio/msbuild/item-definitions). ### User-defined macros -You can create *user-defined macros* to use as variables in project builds. For example, you could create a user-defined macro that provides a value to a custom build step or a custom build tool. A user-defined macro is a name/value pair. In a project file, use the `$(name)` notation to access the value. +You can create *user-defined macros* to use as variables in project builds. For example, you could create a user-defined macro that provides a value to a custom build step or a custom build tool. A user-defined macro is a name-value pair. In a project file, use the `$(name)` notation to access the value. A user-defined macro is stored in a property sheet. If your project doesn't already contain a property sheet, you can create one by following the steps under [Share or reuse Visual Studio project settings](create-reusable-property-configurations.md). #### To create a user-defined macro -1. Open the **Property Manager** window. (On the menu bar, choose **View** > **Property Manager** or **View** > **Other Windows** > **Property Manager**.) Open the shortcut menu for a property sheet (its name ends in *`.user`*) and then choose **Properties**. The **Property Pages** dialog box for that property sheet opens. +1. Open the **Property Manager** window. On the menu bar, select **View** > **Other Windows** > **Property Manager**. Open the shortcut menu for a property sheet (its name ends in *`.user`*) and then choose **Properties**. The **Property Pages** dialog box for that property sheet opens. 1. In the left pane of the dialog box, select **User Macros**. In the right pane, choose the **Add Macro** button to open the **Add User Macro** dialog box. @@ -99,20 +100,17 @@ The property editor for Include Directories is open. The evaluated value is disp ## Add an include directory to the set of default directories -When you add an include directory to a project, it's important not to override all the default directories. The correct way to add a directory is to append the new path, for example "`C:\MyNewIncludeDir\`", and then to Append the **`$(IncludePath)`** macro to the property value. +When you add an include directory to a project, it's important not to override all the default directories. The correct way to add a directory is to append the new path, for example `C:\MyNewIncludeDir\`, and then to append the `$(IncludePath)` macro to the property value. ## Quickly browse and search all properties The **All Options** property page (under the **Configuration Properties** > **C/C++** node in the **Property Pages** dialog box) provides a quick way to browse and search the properties that are available in the current context. It has a special search box and a simple syntax to help you filter results: -No prefix:\ -Search in property names only (case-insensitive substring). +- No prefix: Search in property names only (case-insensitive substring). -'`/`' or '`-`':\ -Search only in compiler switches (case-insensitive prefix) +- '`/`' or '`-`': Search only in compiler switches (case-insensitive prefix). -`v`:\ -Search only in values (case-insensitive substring). +- `v`: Search only in values (case-insensitive substring). ## Set environment variables for a build @@ -124,19 +122,14 @@ In the left pane of the project's **Property Pages** dialog box, expand **Config In the right pane, modify the **Environment** or **Merge Environment** project settings and then choose the **OK** button. -## In this section - -[Share or reuse Visual Studio project settings](create-reusable-property-configurations.md)\ -How to create a *`.props`* file with custom build settings that can be shared or reused. - -[Project property inheritance](project-property-inheritance.md)\ -Describes the order of evaluation for the *`.props`*, *`.targets`*, *`.vcxproj`* files, and environment variables in the build process. +## Articles in this section -[Modify properties and targets without changing the project file](modify-project-properties-without-changing-project-file.md)\ -How to create temporary build settings without having to modify a project file. +- [Share or reuse Visual Studio project settings](create-reusable-property-configurations.md) +- [Property inheritance in Visual Studio projects](project-property-inheritance.md) +- [Modify C++ project properties and targets without changing the project file](modify-project-properties-without-changing-project-file.md) ## See also -[Visual Studio Projects - C++](creating-and-managing-visual-cpp-projects.md)\ -[`.vcxproj` and `.props` file structure](reference/vcxproj-file-structure.md)\ -[Property page XML files](reference/property-page-xml-files.md) +- [Visual Studio projects - C++](creating-and-managing-visual-cpp-projects.md) +- [`.vcxproj` and `.props` file structure](reference/vcxproj-file-structure.md) +- [Property Page XML rule files](reference/property-page-xml-files.md) diff --git a/docs/build/x64-calling-convention.md b/docs/build/x64-calling-convention.md index 54418166c49..d9bf0d97b40 100644 --- a/docs/build/x64-calling-convention.md +++ b/docs/build/x64-calling-convention.md @@ -1,21 +1,22 @@ --- -title: "x64 calling convention" -description: "Learn about the details of the default x64 calling convention." -ms.date: 05/17/2022 +title: "x64 Calling Convention" +description: "Learn about the default x64 calling convention that one function uses to make calls into another function." +ms.date: 03/19/2025 +ms.topic: concept-article --- # x64 calling convention -This section describes the standard processes and conventions that one function (the caller) uses to make calls into another function (the callee) in x64 code. +This article describes the standard processes and conventions that one function (the caller) uses to make calls into another function (the callee) in x64 code. -For more information on the `__vectorcall` calling convention, see [__vectorcall](../cpp/vectorcall.md). +For more information about the `__vectorcall` calling convention, see [__vectorcall](../cpp/vectorcall.md). ## Calling convention defaults -The x64 Application Binary Interface (ABI) uses a four-register fast-call calling convention by default. Space is allocated on the call stack as a shadow store for callees to save those registers. +The x64 Application Binary Interface (ABI) uses a four-register, fast-call calling convention by default. Space is allocated on the call stack as a shadow store for callees to save those registers. There's a strict one-to-one correspondence between a function call's arguments and the registers used for those arguments. Any argument that doesn't fit in 8 bytes, or isn't 1, 2, 4, or 8 bytes, must be passed by reference. A single argument is never spread across multiple registers. -The x87 register stack is unused. It may be used by the callee, but consider it volatile across function calls. All floating point operations are done using the 16 XMM registers. +The x87 register stack is unused. It might be used by the callee, but consider it volatile across function calls. All floating point operations are done using the 16 XMM registers. Integer arguments are passed in registers RCX, RDX, R8, and R9. Floating point arguments are passed in XMM0L, XMM1L, XMM2L, and XMM3L. 16-byte arguments are passed by reference. Parameter passing is described in detail in [Parameter passing](#parameter-passing). These registers, and RAX, R10, R11, XMM4, and XMM5, are considered *volatile*, or potentially changed by a callee on return. Register usage is documented in detail in [x64 register usage](x64-software-conventions.md#x64-register-usage) and [Caller/callee saved registers](#callercallee-saved-registers). @@ -27,13 +28,13 @@ Most structures are aligned to their natural alignment. The primary exceptions a ## Unwindability -Leaf functions are functions that don't change any non-volatile registers. A non-leaf function may change non-volatile RSP, for example, by calling a function. Or, it could change RSP by allocating additional stack space for local variables. To recover non-volatile registers when an exception is handled, non-leaf functions are annotated with static data. The data describes how to properly unwind the function at an arbitrary instruction. This data is stored as *pdata*, or procedure data, which in turn refers to *xdata*, the exception handling data. The xdata contains the unwinding information, and can point to additional pdata or an exception handler function. +Leaf functions are functions that don't change any nonvolatile registers. A nonleaf function might change nonvolatile RSP, for example, by calling a function. Or, it could change RSP by allocating more stack space for local variables. To recover nonvolatile registers when an exception is handled, nonleaf functions are annotated with static data. The data describes how to properly unwind the function at an arbitrary instruction. This data is stored as *pdata*, or procedure data, which in turn refers to *xdata*, the exception handling data. The xdata contains the unwinding information, and can point to additional pdata or an exception handler function. Prologs and epilogs are highly restricted so that they can be properly described in xdata. The stack pointer must remain 16-byte aligned in any region of code that isn't part of an epilog or prolog, except within leaf functions. Leaf functions can be unwound simply by simulating a return, so pdata and xdata aren't required. For details about the proper structure of function prologs and epilogs, see [x64 prolog and epilog](../build/prolog-and-epilog.md). For more information about exception handling, and the exception handling and unwinding of pdata and xdata, see [x64 exception handling](../build/exception-handling-x64.md). ## Parameter passing -By default, the x64 calling convention passes the first four arguments to a function in registers. The registers used for these arguments depend on the position and type of the argument. Remaining arguments get pushed on the stack in right-to-left order. +By default, the x64 calling convention passes the first four arguments to a function in registers. The registers used for these arguments depend on the position and type of the argument. Remaining arguments are passed on the stack in right-to-left order. The caller reserves the required stack space and writes these arguments to stack memory using store or move instructions, maintaining 8-byte alignment for each argument. Integer valued arguments in the leftmost four positions are passed in left-to-right order in RCX, RDX, R8, and R9, respectively. The fifth and higher arguments are passed on the stack as previously described. All integer arguments in registers are right-justified, so the callee can ignore the upper bits of the register and access only the portion of the register necessary. @@ -59,21 +60,21 @@ The following table summarizes how parameters are passed, by type and position f ```cpp func1(int a, int b, int c, int d, int e, int f); -// a in RCX, b in RDX, c in R8, d in R9, f then e pushed on stack +// a in RCX, b in RDX, c in R8, d in R9, f then e passed on stack ``` ### Example of argument passing 2 - all floats ```cpp func2(float a, double b, float c, double d, float e, float f); -// a in XMM0, b in XMM1, c in XMM2, d in XMM3, f then e pushed on stack +// a in XMM0, b in XMM1, c in XMM2, d in XMM3, f then e passed on stack ``` ### Example of argument passing 3 - mixed ints and floats ```cpp func3(int a, double b, int c, float d, int e, float f); -// a in RCX, b in XMM1, c in R8, d in XMM3, f then e pushed on stack +// a in RCX, b in XMM1, c in R8, d in XMM3, f then e passed on stack ``` ### Example of argument passing 4 - `__m64`, `__m128`, and aggregates @@ -81,7 +82,7 @@ func3(int a, double b, int c, float d, int e, float f); ```cpp func4(__m64 a, __m128 b, struct c, float d, __m128 e, __m128 f); // a in RCX, ptr to b in RDX, ptr to c in R8, d in XMM3, -// ptr to f pushed on stack, then ptr to e pushed on stack +// ptr to f passed on stack, then ptr to e passed on stack ``` ## Varargs @@ -92,7 +93,7 @@ If parameters are passed via varargs (for example, ellipsis arguments), then the For functions not fully prototyped, the caller passes integer values as integers and floating-point values as double precision. For floating-point values only, both the integer register and the floating-point register contain the float value in case the callee expects the value in the integer registers. -```cpp +```c func1(); func2() { // RCX = 2, RDX = XMM1 = 1.0, and R8 = 7 func1(2, 1.0, 7); @@ -101,9 +102,9 @@ func2() { // RCX = 2, RDX = XMM1 = 1.0, and R8 = 7 ## Return values -A scalar return value that can fit into 64 bits, including the **`__m64`** type, is returned through RAX. Non-scalar types including floats, doubles, and vector types such as [`__m128`](../cpp/m128.md), [`__m128i`](../cpp/m128i.md), [`__m128d`](../cpp/m128d.md) are returned in XMM0. The state of unused bits in the value returned in RAX or XMM0 is undefined. +A scalar return value that can fit into 64 bits, including the `__m64` type, is returned through RAX. Nonscalar types including floats, doubles, and vector types such as [`__m128`](../cpp/m128.md), [`__m128i`](../cpp/m128i.md), [`__m128d`](../cpp/m128d.md) are returned in XMM0. The state of unused bits in the value returned in RAX or XMM0 is undefined. -User-defined types can be returned by value from global functions and static member functions. To return a user-defined type by value in RAX, it must have a length of 1, 2, 4, 8, 16, 32, or 64 bits. It must also have no user-defined constructor, destructor, or copy assignment operator. It can have no private or protected non-static data members, and no non-static data members of reference type. It can't have base classes or virtual functions. And, it can only have data members that also meet these requirements. (This definition is essentially the same as a C++03 POD type. Because the definition has changed in the C++11 standard, we don't recommend using `std::is_pod` for this test.) Otherwise, the caller must allocate memory for the return value and pass a pointer to it as the first argument. The remaining arguments are then shifted one argument to the right. The same pointer must be returned by the callee in RAX. +User-defined types can be returned by value from global functions and static member functions. To return a user-defined type by value in RAX, it must have a length of 1, 2, 4, 8, 16, 32, or 64 bits. It must also have no user-defined constructor, destructor, or copy assignment operator. It can have no private or protected nonstatic data members, and no nonstatic data members of reference type. It can't have base classes or virtual functions. And, it can only have data members that also meet these requirements. This definition is essentially the same as a C++03 POD type. Because the definition has changed in the C++11 standard, we don't recommend using `std::is_pod` for this test. Otherwise, the caller must allocate memory for the return value and pass a pointer to it as the first argument. The remaining arguments are then shifted one argument to the right. The same pointer must be returned by the callee in RAX. These examples show how parameters and return values are passed for functions with the specified declarations: @@ -111,7 +112,7 @@ These examples show how parameters and return values are passed for functions wi ```cpp __int64 func1(int a, float b, int c, int d, int e); -// Caller passes a in RCX, b in XMM1, c in R8, d in R9, e pushed on stack, +// Caller passes a in RCX, b in XMM1, c in R8, d in R9, e passed on stack, // callee returns __int64 result in RAX. ``` @@ -131,7 +132,7 @@ struct Struct1 { }; Struct1 func3(int a, double b, int c, float d); // Caller allocates memory for Struct1 returned and passes pointer in RCX, -// a in RDX, b in XMM2, c in R9, d pushed on the stack; +// a in RDX, b in XMM2, c in R9, d passed on the stack; // callee returns pointer to Struct1 result in RAX. ``` @@ -168,7 +169,7 @@ The x87 FPU control word register gets set using the following standard values a | Register\[bits] | Setting | |-|-| -| FPCSR\[0:6] | Exception masks all 1's (all exceptions masked) | +| FPCSR\[0:6] | Exception masks all 1s (all exceptions masked) | | FPCSR\[7] | Reserved - 0 | | FPCSR\[8:9] | Precision Control - 10B (double precision) | | FPCSR\[10:11] | Rounding control - 0 (round to nearest) | @@ -176,7 +177,7 @@ The x87 FPU control word register gets set using the following standard values a A callee that modifies any of the fields within FPCSR must restore them before returning to its caller. Furthermore, a caller that has modified any of these fields must restore them to their standard values before invoking a callee, unless by agreement the callee expects the modified values. -There are two exceptions to the rules about the non-volatility of the control flags: +There are two exceptions to the rules about the nonvolatility of the control flags: - In functions where the documented purpose of the given function is to modify the nonvolatile FPCSR flags. @@ -191,13 +192,13 @@ The nonvolatile portion is set to the following standard values at the start of | Register\[bits] | Setting | |-|-| | MXCSR\[6] | Denormals are zeros - 0 | -| MXCSR\[7:12] | Exception masks all 1's (all exceptions masked) | +| MXCSR\[7:12] | Exception masks all 1s (all exceptions masked) | | MXCSR\[13:14] | Rounding control - 0 (round to nearest) | | MXCSR\[15] | Flush to zero for masked underflow - 0 (off) | A callee that modifies any of the nonvolatile fields within MXCSR must restore them before returning to its caller. Furthermore, a caller that has modified any of these fields must restore them to their standard values before invoking a callee, unless by agreement the callee expects the modified values. -There are two exceptions to the rules about the non-volatility of the control flags: +There are two exceptions to the rules about the nonvolatility of the control flags: - In functions where the documented purpose of the given function is to modify the nonvolatile MXCSR flags. @@ -207,10 +208,10 @@ Make no assumptions about the MXCSR register's volatile portion state across a f ## setjmp/longjmp -When you include setjmpex.h or setjmp.h, all calls to [`setjmp`](../c-runtime-library/reference/setjmp.md) or [`longjmp`](../c-runtime-library/reference/longjmp.md) result in an unwind that invokes destructors and **`__finally`** calls. This behavior differs from x86, where including setjmp.h results in **`__finally`** clauses and destructors not being invoked. +When you include `setjmpex.h` or `setjmp.h`, all calls to [`setjmp`](../c-runtime-library/reference/setjmp.md) or [`longjmp`](../c-runtime-library/reference/longjmp.md) result in an unwind that invokes destructors and `__finally` calls. This behavior differs from x86, where including `setjmp.h` results in `__finally` clauses and destructors not being invoked. -A call to `setjmp` preserves the current stack pointer, non-volatile registers, and MXCSR registers. Calls to `longjmp` return to the most recent `setjmp` call site and resets the stack pointer, non-volatile registers, and MXCSR registers, back to the state as preserved by the most recent `setjmp` call. +A call to `setjmp` preserves the current stack pointer, nonvolatile registers, and MXCSR registers. Calls to `longjmp` return to the most recent `setjmp` call site and resets the stack pointer, nonvolatile registers, and MXCSR registers, back to the state as preserved by the most recent `setjmp` call. ## See also -[x64 software conventions](../build/x64-software-conventions.md) +- [Overview of x64 ABI conventions](../build/x64-software-conventions.md) diff --git a/docs/build/x64-software-conventions.md b/docs/build/x64-software-conventions.md index 256fbdb581e..7f8229a5313 100644 --- a/docs/build/x64-software-conventions.md +++ b/docs/build/x64-software-conventions.md @@ -1,8 +1,9 @@ --- description: "Learn more about: x64 ABI conventions" title: "x64 ABI conventions" -ms.date: 04/21/2022 +ms.date: 03/28/2025 helpviewer_keywords: ["x64 coding conventions", "x64 abi", "Visual C++, x64 calling conventions"] +ms.topic: concept-article --- # Overview of x64 ABI conventions @@ -11,10 +12,11 @@ This topic describes the basic application binary interface (ABI) for x64, the 6 ## x64 calling conventions Two important differences between x86 and x64 are: + - 64-bit addressing capability - Sixteen 64-bit registers for general use. -Given the expanded register set, x64 uses the [__fastcall](../cpp/fastcall.md) calling convention and a RISC-based exception-handling model. +Given the expanded register set, x64 uses the [`__fastcall`](../cpp/fastcall.md) calling convention and a RISC-based exception-handling model. The **`__fastcall`** convention uses registers for the first four arguments, and the stack frame to pass more arguments. For details on the x64 calling convention, including register usage, stack parameters, return values, and stack unwinding, see [x64 calling convention](x64-calling-convention.md). @@ -116,7 +118,7 @@ _declspec(align(2)) struct { } ``` -![Diagram showing the example 1 structure layout.](../build/media/vcamd_conv_ex_1_block.png "AMD conversion example 1 structure layout") +:::image type="content" source="../build/media/vcamd_conv_ex_1_block.png" alt-text="Diagram showing the structure layout for example 1. The diagram shows 2 bytes of memory. Member a, a short, occupies bytes 0 through 1."::: #### Example 2 @@ -130,7 +132,9 @@ _declspec(align(8)) struct { } ``` -![Diagram showing the example 2 structure layout.](../build/media/vcamd_conv_ex_2_block.png "AMD conversion example 2 structure layout") +:::image type="complex" source="../build/media/vcamd_conv_ex_2_block.png" alt-text="Diagram showing the structure layout for example 2."::: +The diagram shows 24 bytes of memory. Member a, an int, occupies bytes 0 through 3. The diagram shows padding for bytes 4 through 7. Member b, a double, occupies bytes 8 through 15. Member c, a short, occupies bytes 16 through 17. Bytes 18 through 23 are unused. +:::image-end::: #### Example 3 @@ -145,7 +149,9 @@ _declspec(align(4)) struct { } ``` -![Diagram showing the example 3 structure layout.](../build/media/vcamd_conv_ex_3_block.png "AMD conversion example 3 structure layout") +:::image type="complex" source="../build/media/vcamd_conv_ex_3_block.png" alt-text="Diagram showing the structure layout for example 3."::: +The diagram shows 12 bytes of memory. Member a, a char, occupies byte 0. Byte 1 is padding. Member b, a short, occupies bytes 2 through 4. Member c, a char, occupies byte 4. Bytes 5 through 7 are padding. Member d, an int, occupies bytes 8 through 11. +:::image-end::: #### Example 4 @@ -159,7 +165,9 @@ _declspec(align(8)) union { } ``` -![Diagram showing the example 4 union layout.](../build/media/vcamd_conv_ex_4_block.png "AMD conversion example 4 union layout") +:::image type="complex" source="../build/media/vcamd_conv_ex_4_block.png" alt-text="Diagram showing the union layout for example 4."::: +The diagram shows 8 bytes of memory. Member p, a char, occupies byte 0. Member s, a short, occupies bytes 0 through 1. Member l, a long, occupies bytes 0 through 3. Bytes 4 through 7 are padding. +:::image-end::: ### Bitfields @@ -211,7 +219,7 @@ On function exit and on function entry to C Runtime Library calls and Windows sy ## Stack usage -For details on stack allocation, alignment, function types and stack frames on x64, see [x64 stack usage](stack-usage.md). +For details on stack allocation, alignment, function types, and stack frames on x64, see [x64 stack usage](stack-usage.md). ## Prolog and epilog diff --git a/docs/c-language/c-comments.md b/docs/c-language/c-comments.md index aaa1c15a1e5..bae13131370 100644 --- a/docs/c-language/c-comments.md +++ b/docs/c-language/c-comments.md @@ -1,9 +1,8 @@ --- -description: "Learn more about: C Comments" title: "C Comments" -ms.date: "06/25/2018" +description: "Learn more about: C Comments" +ms.date: 06/25/2018 helpviewer_keywords: ["code comments, C code", "comments, documenting code", "comments, C code", "/* */ comment delimiters", "comments"] -ms.assetid: 0f5f2825-e673-49e7-8669-94e2f5294989 --- # C Comments @@ -57,7 +56,7 @@ The Microsoft compiler also supports single-line comments preceded by two forwar // This is a valid comment ``` -Comments beginning with two forward slashes (**`//`**) are terminated by the next newline character that isn't preceded by an escape character. In the next example, the newline character is preceded by a backslash (**`\`**), creating an "escape sequence." This escape sequence causes the compiler to treat the next line as part of the previous line. (For more information, see [Escape Sequences](../c-language/escape-sequences.md).) +Comments beginning with two forward slashes (**`//`**) are terminated by the next newline character that isn't preceded by an escape character. In the next example, the newline character is preceded by a backslash (**`\`**), creating an "escape sequence." This escape sequence causes the compiler to treat the next line as part of the previous line. For more information, see [Escape Sequences](../c-language/escape-sequences.md). ```C // my comment \ diff --git a/docs/c-language/c-pragmas.md b/docs/c-language/c-pragmas.md index e98dccbd721..bb5cb70aee4 100644 --- a/docs/c-language/c-pragmas.md +++ b/docs/c-language/c-pragmas.md @@ -1,9 +1,8 @@ --- -description: "Learn more about: C Pragmas" title: "C Pragmas" +description: "Learn more about: C Pragmas" ms.date: 07/26/2020 helpviewer_keywords: ["pragmas, C/C++"] -ms.assetid: 3d6d36b4-d565-4632-a4cd-e39aeaded5ad --- # C Pragmas @@ -59,7 +58,7 @@ A *pragma* instructs the compiler to perform a particular action at compile time :::column-end::: :::row-end::: -See [Pragma Directives and the `__Pragma` Keyword](../preprocessor/pragma-directives-and-the-pragma-keyword.md) for a description of the Microsoft C compiler pragmas. +See [Pragma directives and the `__pragma` and `_Pragma` keywords](../preprocessor/pragma-directives-and-the-pragma-keyword.md) for a description of the Microsoft C compiler pragmas. **END Microsoft Specific** diff --git a/docs/c-language/c-primary-expressions.md b/docs/c-language/c-primary-expressions.md index 1b57eecbf0d..b2939192a28 100644 --- a/docs/c-language/c-primary-expressions.md +++ b/docs/c-language/c-primary-expressions.md @@ -23,5 +23,5 @@ Primary expressions are the building blocks of more complex expressions. They ma ## See also -[Generic selection](generic-selection.md) +[Generic selection](generic-selection.md)\ [Operands and Expressions](../c-language/operands-and-expressions.md) diff --git a/docs/c-language/demotion-of-integers.md b/docs/c-language/demotion-of-integers.md index f64f4104f9a..5cc14b16953 100644 --- a/docs/c-language/demotion-of-integers.md +++ b/docs/c-language/demotion-of-integers.md @@ -25,7 +25,7 @@ char y = (char)0x1234; assigns the value 0x34 to `y`. -When **`signed`** variables are converted to **`unsigned`** and vice-versa, the bit patterns remain the same. For example, casting -2 (0xFE) to an **`unsigned`** value yields 254 (also 0xFE). +When **`signed`** variables are converted to **`unsigned`** and vice-versa, the bit patterns remain the same. For example, casting -2 (0xFFFFFFFE) to an **`unsigned int`** value yields 4294967294 (also 0xFFFFFFFE). ## See also diff --git a/docs/c-language/extern-storage-class-specifier.md b/docs/c-language/extern-storage-class-specifier.md index cfcf2a0c38e..fc532686093 100644 --- a/docs/c-language/extern-storage-class-specifier.md +++ b/docs/c-language/extern-storage-class-specifier.md @@ -1,9 +1,8 @@ --- -description: "Learn more about: extern Storage-Class Specifier" title: "extern Storage-Class Specifier" +description: "Learn more about: extern Storage-Class Specifier" ms.date: "07/10/2018" helpviewer_keywords: ["extern keyword [C]", "storage class specifiers, extern", "extern keyword [C], storage class specifier", "external linkage, storage-class specifiers", "external linkage, extern modifier"] -ms.assetid: 6e16d927-291f-49e4-986c-9d91a482a441 --- # extern Storage-Class Specifier @@ -14,12 +13,11 @@ A variable declared with the **`extern`** storage-class specifier is a reference This example illustrates internal- and external-level declarations: ```c - // Source1.c int i = 1; -// Source2. c +// Source2.c #include diff --git a/docs/c-language/generic-selection.md b/docs/c-language/generic-selection.md index 2e9872209a6..0eba6388e33 100644 --- a/docs/c-language/generic-selection.md +++ b/docs/c-language/generic-selection.md @@ -1,7 +1,7 @@ --- title: "Generic selection (C11)" description: "Describes the C11 _Generic keyword used in the Microsoft Visual C compiler" -ms.date: "6/29/2021" +ms.date: 6/29/2021 helpviewer_keywords: ["_Generic keyword [C]"] --- @@ -26,7 +26,7 @@ For example, the expression `_Generic(42, int: "integer", char: "character", def The first *`assignment-expression`* is called the controlling expression. The type of the controlling expression is determined at compile time and matched against the *`assoc-list`* to find which expression to evaluate and return. The controlling expression isn't evaluated. For example, `_Generic(intFunc(), int: "integer", default: "error");` doesn't result in a call at runtime to `intFunc`. -When the type of the controlling expression is determined, `const`, `volatile`, and `restrict` are removed before matching against *`assoc-list`*. +When the type of the controlling expression is determined, `const`, `volatile`, and `restrict` are removed before matching against *`assoc-list`*. Entries in the `assoc-list` that aren't chosen aren't evaluated. diff --git a/docs/c-language/initializing-scalar-types.md b/docs/c-language/initializing-scalar-types.md index 77c56738257..bcd7ca93c1f 100644 --- a/docs/c-language/initializing-scalar-types.md +++ b/docs/c-language/initializing-scalar-types.md @@ -1,9 +1,8 @@ --- -description: "Learn more about: Initializing Scalar Types" title: "Initializing Scalar Types" -ms.date: "11/04/2016" +description: "Learn more about: Initializing Scalar Types" +ms.date: 11/04/2016 helpviewer_keywords: ["initializing scalar types", "register variables", "initialization, scalar types", "initializing variables, scalar types", "scalar types", "static variables, initializing", "automatic storage class, initializing scalar types", "automatic storage class", "types [C], initializing"] -ms.assetid: 73c516f5-c3ad-4d56-ab3b-f2a82b621104 --- # Initializing Scalar Types @@ -38,7 +37,7 @@ You can initialize variables of any type, as long as you obey the following rule - Variables declared with the **`auto`** or **`register`** storage-class specifier are initialized each time execution control passes to the block in which they're declared. If you omit an initializer from the declaration of an **`auto`** or **`register`** variable, the initial value of the variable is undefined. For automatic and register values, the initializer isn't restricted to being a constant; it can be any expression involving previously defined values, even function calls. -- The initial values for external variable declarations and for all **`static`** variables, whether external or internal, must be constant expressions. (For more information, see [Constant Expressions](../c-language/c-constant-expressions.md).) Since the address of any externally declared or static variable is constant, it can be used to initialize an internally declared **`static`** pointer variable. However, the address of an **`auto`** variable can't be used as a static initializer because it may be different for each execution of the block. You can use either constant or variable values to initialize **`auto`** and **`register`** variables. +- The initial values for external variable declarations and for all **`static`** variables, whether external or internal, must be constant expressions. For more information, see [Constant Expressions](../c-language/c-constant-expressions.md). Since the address of any externally declared or static variable is constant, it can be used to initialize an internally declared **`static`** pointer variable. However, the address of an **`auto`** variable can't be used as a static initializer because it may be different for each execution of the block. You can use either constant or variable values to initialize **`auto`** and **`register`** variables. - If the declaration of an identifier has block scope, and the identifier has external linkage, the declaration can't have an initialization. diff --git a/docs/c-language/l-value-and-r-value-expressions.md b/docs/c-language/l-value-and-r-value-expressions.md index cca7a68bf24..5a646ce54db 100644 --- a/docs/c-language/l-value-and-r-value-expressions.md +++ b/docs/c-language/l-value-and-r-value-expressions.md @@ -1,9 +1,8 @@ --- -description: "Learn more about: L-Value and R-Value Expressions" title: "L-Value and R-Value Expressions" -ms.date: "11/04/2016" +description: "Learn more about: L-Value and R-Value Expressions" +ms.date: 11/04/2016 helpviewer_keywords: ["L-values", "member-selection expressions", "R-value expressions", "subscript expressions"] -ms.assetid: b790303e-ec6f-4d0d-bc55-df42da267172 --- # L-Value and R-Value Expressions @@ -31,7 +30,7 @@ The term "r-value" is sometimes used to describe the value of an expression and **Microsoft Specific** -Microsoft C includes an extension to the ANSI C standard that allows casts of l-values to be used as l-values, as long as the size of the object isn't lengthened through the cast. (For more information, see [Type-Cast Conversions](../c-language/type-cast-conversions.md).) The following example illustrates this feature: +Microsoft C includes an extension to the ANSI C standard that allows casts of l-values to be used as l-values, as long as the size of the object isn't lengthened through the cast. For more information, see [Type-Cast Conversions](../c-language/type-cast-conversions.md). The following example illustrates this feature: ``` char *p ; diff --git a/docs/c-language/parameters.md b/docs/c-language/parameters.md index cc504bb4905..f2eb26888e8 100644 --- a/docs/c-language/parameters.md +++ b/docs/c-language/parameters.md @@ -1,9 +1,8 @@ --- -description: "Learn more about: Parameters" title: "Parameters" -ms.date: "11/04/2016" +description: "Learn more about: Parameters" +ms.date: 11/04/2016 helpviewer_keywords: ["arguments [C++], function", "function parameters", "parameters [C++]", "function arguments, vs. parameters", "parameters [C++], function", "functions [C], parameters", "function parameters, syntax", "ellipsis (...), parameters", "... ellipsis"] -ms.assetid: 8f2b8026-78b5-4e21-86a3-bf0f91f05689 --- # Parameters @@ -50,7 +49,7 @@ void new( double x, double y, double z ) } ``` -If at least one parameter occurs in the parameter list, the list can end with a comma followed by three periods (**`, ...`**). This construction, called the "ellipsis notation," indicates a variable number of arguments to the function. (For more information, see [Calls with a Variable Number of Arguments](../c-language/calls-with-a-variable-number-of-arguments.md).) However, a call to the function must have at least as many arguments as there are parameters before the last comma. +If at least one parameter occurs in the parameter list, the list can end with a comma followed by three periods (**`, ...`**). This construction, called the "ellipsis notation," indicates a variable number of arguments to the function. For more information, see [Calls with a Variable Number of Arguments](../c-language/calls-with-a-variable-number-of-arguments.md). However, a call to the function must have at least as many arguments as there are parameters before the last comma. If no arguments are to be passed to the function, the list of parameters is replaced by the keyword **`void`**. This use of **`void`** is distinct from its use as a type specifier. diff --git a/docs/c-language/scope-and-visibility.md b/docs/c-language/scope-and-visibility.md index 72e07ffd0fb..8f61550b6cb 100644 --- a/docs/c-language/scope-and-visibility.md +++ b/docs/c-language/scope-and-visibility.md @@ -1,9 +1,8 @@ --- -description: "Learn more about: Scope and Visibility" title: "Scope and Visibility" -ms.date: "11/04/2016" +description: "Learn more about: Scope and Visibility" +ms.date: 11/04/2016 helpviewer_keywords: ["scope, levels", "visibility", "file scope [C++]"] -ms.assetid: a019eb7c-66ed-46a7-bc9f-89a963930a56 --- # Scope and Visibility @@ -15,7 +14,7 @@ All identifiers except labels have their scope determined by the level at which The declarator or type specifier for an identifier with file scope appears outside any block or list of parameters and is accessible from any place in the translation unit after its declaration. Identifier names with file scope are often called "global" or "external." The scope of a global identifier begins at the point of its definition or declaration and terminates at the end of the translation unit. **Function scope**\ -A label is the only kind of identifier that has function scope. A label is declared implicitly by its use in a statement. Label names must be unique within a function. (For more information about labels and label names, see [The goto and Labeled Statements](../c-language/goto-and-labeled-statements-c.md).) +A label is the only kind of identifier that has function scope. A label is declared implicitly by its use in a statement. Label names must be unique within a function. For more information about labels and label names, see [The goto and Labeled Statements](../c-language/goto-and-labeled-statements-c.md). **Block scope**\ The declarator or type specifier for an identifier with block scope appears inside a block or within the list of formal parameter declarations in a function definition. It is visible only from the point of its declaration or definition to the end of the block containing its declaration or definition. Its scope is limited to that block and to any blocks nested in that block and ends at the curly brace that closes the associated block. Such identifiers are sometimes called "local variables." diff --git a/docs/c-language/static-assert-c.md b/docs/c-language/static-assert-c.md index dc8ab22981c..99455cab88f 100644 --- a/docs/c-language/static-assert-c.md +++ b/docs/c-language/static-assert-c.md @@ -42,7 +42,7 @@ In C, when you don't include ``, the Microsoft compiler treats **`stat In the following example, **`static_assert`** and **`_Static_assert`** are used to verify how many elements are in an enum and that integers are 32 bits wide. ```C -// requires /std:c11 or higher +// requires /std:c11 or later #include enum Items @@ -78,5 +78,5 @@ Windows SDK 10.0.20348.0 (version 2104) or later. For more information on instal ## See also [`_STATIC_ASSERT` Macro](../c-runtime-library/reference/static-assert-macro.md)\ -[`assert` macro and `_assert` and `_wassert` functions](../c-runtime-library/reference/assert-macro-assert-wassert.md) +[`assert` macro and `_assert` and `_wassert` functions](../c-runtime-library/reference/assert-macro-assert-wassert.md)\ [`/std` (Specify language standard version)](../build/reference/std-specify-language-standard-version.md) diff --git a/docs/c-language/summary-of-declarations.md b/docs/c-language/summary-of-declarations.md index 117a5baaaab..975beb742bc 100644 --- a/docs/c-language/summary-of-declarations.md +++ b/docs/c-language/summary-of-declarations.md @@ -21,7 +21,7 @@ ms.assetid: 53a5e9e5-1a33-40b5-9dea-7f669b479329  *`attribute`*1 *`attribute-seq`*opt1 *`attribute`*1, 2: one of\ - **`__asm`** **`__based`** **`__cdecl`** **`__clrcall`** **`__fastcall`** **`__inline`** **`__stdcall`** **`__thiscall`** **`__vectorcall`** + **`__asm`** **`__based`** **`__cdecl`** **`__clrcall`** **`__fastcall`** **`__inline`** **`__stdcall`** **`__thiscall`** **`__vectorcall`** **`__preserve_none`** *`init-declarator-list`*:\  *`init-declarator`*\ @@ -209,7 +209,7 @@ ms.assetid: 53a5e9e5-1a33-40b5-9dea-7f669b479329  **`_Static_assert`** **`(`** *`constant-expression`* **`,`** *`string-literal`* **`)`** **`;`** 1 This grammar element is Microsoft-specific.\ -2 For more information about these elements, see [`__asm`](../assembler/inline/asm.md), [`__clrcall`](../cpp/clrcall.md), [`__stdcall`](../cpp/stdcall.md), [`__based`](../cpp/based-grammar.md), [`__fastcall`](../cpp/fastcall.md), [`__thiscall`](../cpp/thiscall.md), [`__cdecl`](../cpp/cdecl.md), [`__inline`](../cpp/inline-functions-cpp.md), and [`__vectorcall`](../cpp/vectorcall.md).\ +2 For more information about these elements, see [`__asm`](../assembler/inline/asm.md), [`__clrcall`](../cpp/clrcall.md), [`__stdcall`](../cpp/stdcall.md), [`__based`](../cpp/based-grammar.md), [`__fastcall`](../cpp/fastcall.md), [`__thiscall`](../cpp/thiscall.md), [`__cdecl`](../cpp/cdecl.md), [`__inline`](../cpp/inline-functions-cpp.md), [`__preserve_none`](../cpp/preserve-none.md) and [`__vectorcall`](../cpp/vectorcall.md).\ 3 This style is obsolete. ## See also diff --git a/docs/c-language/toc.yml b/docs/c-language/toc.yml index cfd26f82ed8..13334cd6b4e 100644 --- a/docs/c-language/toc.yml +++ b/docs/c-language/toc.yml @@ -444,7 +444,7 @@ items: - name: Inline assembler (C) href: ../c-language/inline-assembler-c.md - name: _Noreturn (C) - href: ../c-language/noreturn.md + href: ../c-language/noreturn.md - name: DLL import and export functions items: - name: DLL import and export functions diff --git a/docs/c-language/typedef-declarations.md b/docs/c-language/typedef-declarations.md index 019f17fbdf9..b503212b6c4 100644 --- a/docs/c-language/typedef-declarations.md +++ b/docs/c-language/typedef-declarations.md @@ -1,9 +1,8 @@ --- -description: "Learn more about: Typedef Declarations" title: "Typedef Declarations" -ms.date: "11/04/2016" +description: "Learn more about: Typedef Declarations" +ms.date: 11/04/2016 helpviewer_keywords: ["declarations, typedef", "typedef declarations", "types [C], declarations"] -ms.assetid: e92a3b82-9269-4bc6-834a-6f431ccac83e --- # Typedef Declarations @@ -43,7 +42,7 @@ A typedef declaration is interpreted in the same way as a variable or function d A typedef declaration doesn't create new types. It creates synonyms for existing types, or names for types that could be specified in other ways. When a typedef name is used as a type specifier, it can be combined with certain type specifiers, but not others. Acceptable modifiers include **`const`** and **`volatile`**. -Typedef names share the name space with ordinary identifiers. (For more information, see [Name Spaces](../c-language/name-spaces.md).) Therefore, a program can have a typedef name and a local-scope identifier by the same name. For example: +Typedef names share the name space with ordinary identifiers. For more information, see [Name Spaces](../c-language/name-spaces.md). Therefore, a program can have a typedef name and a local-scope identifier by the same name. For example: ```C typedef char FlagType; diff --git a/docs/c-runtime-library/acmdln-tcmdln-wcmdln.md b/docs/c-runtime-library/acmdln-tcmdln-wcmdln.md index 4d60eaa7afd..45d1630a097 100644 --- a/docs/c-runtime-library/acmdln-tcmdln-wcmdln.md +++ b/docs/c-runtime-library/acmdln-tcmdln-wcmdln.md @@ -1,14 +1,13 @@ --- -description: "Learn more about: _acmdln, _tcmdln, _wcmdln" title: "_acmdln, _tcmdln, _wcmdln" -ms.date: "11/04/2016" +description: "Learn more about: _acmdln, _tcmdln, _wcmdln" +ms.date: 11/04/2016 api_name: ["_wcmdln", "_acmdln"] api_location: ["msvcrt.dll"] api_type: ["DLLExport"] topic_type: ["apiref"] f1_keywords: ["_acmdln", "_wcmdln", "_tcmdln"] helpviewer_keywords: ["_wcmdln global variable", "wcmdln global variable", "_acmdln global variable", "_tcmdln global variable", "tcmdln global variable", "acmdln global variable"] -ms.assetid: 4fc0a6a0-3f93-420a-a19f-5276061ba539 --- # `_acmdln`, `_tcmdln`, `_wcmdln` @@ -24,6 +23,7 @@ wchar_t * _wcmdln; #define _tcmdln _wcmdln #else #define _tcmdln _acmdln +#endif ``` ## Remarks @@ -32,4 +32,4 @@ These CRT internal variables store the complete command line. They're exposed in ## See also -[Global variables](./global-variables.md) +[Global variables](global-variables.md) diff --git a/docs/c-runtime-library/ansi-c-compliance.md b/docs/c-runtime-library/ansi-c-compliance.md index e9aad2a0856..67c65fbd7c2 100644 --- a/docs/c-runtime-library/ansi-c-compliance.md +++ b/docs/c-runtime-library/ansi-c-compliance.md @@ -2,7 +2,7 @@ title: "ANSI C Conformance" description: "An overview of Microsoft C runtime naming conventions for ANSI C conformance." ms.date: "11/04/2016" -ms.topic: "conceptual" +ms.topic: "concept-article" helpviewer_keywords: ["underscores, leading", "compatibility [C++], ANSI C", "conformance with ANSI C", "conventions [C++], Microsoft extensions", "underscores", "naming conventions [C++], Microsoft library", "ANSI [C++], C standard", "Microsoft extensions naming conventions"] ms.assetid: 6be271bf-eecf-491a-a928-0ee2dd60e3b9 --- diff --git a/docs/c-runtime-library/backward-compatibility.md b/docs/c-runtime-library/backward-compatibility.md index 16e0a796c7a..c96ccb67787 100644 --- a/docs/c-runtime-library/backward-compatibility.md +++ b/docs/c-runtime-library/backward-compatibility.md @@ -2,7 +2,7 @@ title: "Backward Compatibility" description: "How to use the Microsoft OLDNAMES.LIB library to map function names for backwards compatibility." ms.date: "11/04/2016" -ms.topic: "conceptual" +ms.topic: "concept-article" helpviewer_keywords: ["CRT, compatibility", "backward compatibility, C run-time libraries", "compatibility, C run-time libraries", "backward compatibility"] ms.assetid: cc3175cf-97fd-492f-b329-5791aea63090 --- diff --git a/docs/c-runtime-library/buffer-manipulation.md b/docs/c-runtime-library/buffer-manipulation.md index 21c4336737a..7fce41ba6c2 100644 --- a/docs/c-runtime-library/buffer-manipulation.md +++ b/docs/c-runtime-library/buffer-manipulation.md @@ -1,9 +1,8 @@ --- -description: "Learn more about: Buffer manipulation" title: "Buffer manipulation" -ms.date: "04/04/2018" +description: "Learn more about: Buffer manipulation" +ms.date: 04/04/2018 helpviewer_keywords: ["buffers, manipulation routines", "buffers"] -ms.assetid: 164f4860-ce66-412c-8291-396fbd70f03e --- # Buffer manipulation @@ -13,17 +12,17 @@ Use these routines to work with areas of memory on a byte-by-byte basis. | Routine | Use | |---|---| -| [`_memccpy`](./reference/memccpy.md) | Copy characters from one buffer to another until given character or given number of characters has been copied | -| [`memchr`, `wmemchr`](./reference/memchr-wmemchr.md) | Return pointer to first occurrence, within specified number of characters, of given character in buffer | -| [`memcmp`, `wmemcmp`](./reference/memcmp-wmemcmp.md) | Compare specified number of characters from two buffers | -| [`memcpy`, `wmemcpy`](./reference/memcpy-wmemcpy.md), [`memcpy_s`, `wmemcpy_s`](./reference/memcpy-s-wmemcpy-s.md) | Copy specified number of characters from one buffer to another | -| [`_memicmp`, `_memicmp_l`](./reference/memicmp-memicmp-l.md) | Compare specified number of characters from two buffers without regard to case | -| [`memmove`, `wmemmove`](./reference/memmove-wmemmove.md),[`memmove_s`, `wmemmove_s`](./reference/memmove-s-wmemmove-s.md) | Copy specified number of characters from one buffer to another | -| [`memset`, `wmemset`](./reference/memset-wmemset.md) | Use given character to initialize specified number of bytes in the buffer | -| [`_swab`](./reference/swab.md) | Swap bytes of data and store them at specified location | +| [`_memccpy`](reference/memccpy.md) | Copy characters from one buffer to another until given character or given number of characters has been copied | +| [`memchr`, `wmemchr`](reference/memchr-wmemchr.md) | Return pointer to first occurrence, within specified number of characters, of given character in buffer | +| [`memcmp`, `wmemcmp`](reference/memcmp-wmemcmp.md) | Compare specified number of characters from two buffers | +| [`memcpy`, `wmemcpy`](reference/memcpy-wmemcpy.md), [`memcpy_s`, `wmemcpy_s`](reference/memcpy-s-wmemcpy-s.md) | Copy specified number of characters from one buffer to another | +| [`_memicmp`, `_memicmp_l`](reference/memicmp-memicmp-l.md) | Compare specified number of characters from two buffers without regard to case | +| [`memmove`, `wmemmove`](reference/memmove-wmemmove.md), [`memmove_s`, `wmemmove_s`](reference/memmove-s-wmemmove-s.md) | Copy specified number of characters from one buffer to another | +| [`memset`, `wmemset`](reference/memset-wmemset.md) | Use given character to initialize specified number of bytes in the buffer | +| [`_swab`](reference/swab.md) | Swap bytes of data and store them at specified location | When the source and target areas overlap, only `memmove` is guaranteed to copy the full source properly. ## See also -[Universal C runtime routines by category](./run-time-routines-by-category.md) +[Universal C runtime routines by category](run-time-routines-by-category.md) diff --git a/docs/c-runtime-library/byte-and-wide-streams.md b/docs/c-runtime-library/byte-and-wide-streams.md index 8ef801bf6ce..bc5ab7e6fbe 100644 --- a/docs/c-runtime-library/byte-and-wide-streams.md +++ b/docs/c-runtime-library/byte-and-wide-streams.md @@ -2,7 +2,7 @@ title: "Byte and Wide Streams" description: "An overview of byte streams in the Microsoft C runtime library." ms.date: "11/04/2016" -ms.topic: "conceptual" +ms.topic: "concept-article" helpviewer_keywords: ["byte streams", "wide streams"] --- # Byte and wide streams diff --git a/docs/c-runtime-library/cgets-cgetws.md b/docs/c-runtime-library/cgets-cgetws.md index 3869e4230ca..04390142f6d 100644 --- a/docs/c-runtime-library/cgets-cgetws.md +++ b/docs/c-runtime-library/cgets-cgetws.md @@ -1,21 +1,20 @@ --- -description: "Learn more about: _cgets, _cgetws" title: "_cgets, _cgetws" -ms.date: "4/2/2020" +description: "Learn more about: _cgets, _cgetws" +ms.date: 4/2/2020 api_name: ["_cgetws", "_cgets", "_o__cgets", "_o__cgetws"] api_location: ["msvcr100.dll", "msvcr110.dll", "msvcr80.dll", "msvcr120.dll", "msvcr90.dll", "msvcrt.dll", "msvcr110_clr0400.dll", "ucrtbase.dll", "api-ms-win-crt-conio-l1-1-0.dll"] api_type: ["DLLExport"] topic_type: ["apiref"] f1_keywords: ["cgetws", "_cgetws", "_cgets"] helpviewer_keywords: ["_cgetws function", "strings [C++], getting from console", "console, getting strings from", "_cgets function", "cgetws function", "cgets function"] -ms.assetid: 4d5e134a-58c3-4f62-befd-5d235b0212f4 --- # `_cgets`, `_cgetws` Gets a character string from the console. More secure versions of these functions are available; see [`_cgets_s`, `_cgetws_s`](./reference/cgets-s-cgetws-s.md). > [!IMPORTANT] -> These functions are obsolete. Beginning in Visual Studio 2015, they are not available in the CRT. The secure versions of these functions, _cgets_s and _cgetws_s, are still available. For information on these alternative functions, see [`_cgets_s`, `_cgetws_s`](./reference/cgets-s-cgetws-s.md). +> These functions are obsolete. Beginning in Visual Studio 2015, they are not available in the CRT. The secure versions of these functions, _cgets_s and _cgetws_s, are still available. For information on these alternative functions, see [`_cgets_s`, `_cgetws_s`](./reference/cgets-s-cgetws-s.md). > [!IMPORTANT] > This API cannot be used in applications that execute in the Windows Runtime. For more information, see [CRT functions not supported in Universal Windows Platform apps](../cppcx/crt-functions-not-supported-in-universal-windows-platform-apps.md). diff --git a/docs/c-runtime-library/code-pages.md b/docs/c-runtime-library/code-pages.md index e61fe0e5ee8..25a6e84f5df 100644 --- a/docs/c-runtime-library/code-pages.md +++ b/docs/c-runtime-library/code-pages.md @@ -1,10 +1,9 @@ --- title: "Code Pages" description: "A description of code page support in the Microsoft C runtime." -ms.topic: "conceptual" -ms.date: "11/04/2016" +ms.date: 11/04/2016 +ms.topic: "concept-article" helpviewer_keywords: ["character sets [C++], code pages", "ANSI [C++], code pages", "system-default code page", "multibyte code pages [C++]", "localization [C++], code pages", "code pages [C++], types of", "locale code pages [C++]"] -ms.assetid: 4a26fc42-185a-4add-98bf-a7b314ae6186 --- # Code pages @@ -22,7 +21,7 @@ The Microsoft runtime library uses the following types of code pages: also sets the locale to the system-default ANSI code page. -- Locale code page. The behavior of several run-time routines is dependent on the current locale setting, which includes the locale code page. (For more information, see [Locale](./locale.md).) By default, all locale-dependent routines in the Microsoft run-time library use the code page that corresponds to the "C" locale. At run time, you can change or query the locale code page in use with a call to [`setlocale`](./reference/setlocale-wsetlocale.md). +- Locale code page. The behavior of several run-time routines is dependent on the current locale setting, which includes the locale code page. For more information, see [Locale](./locale.md). By default, all locale-dependent routines in the Microsoft run-time library use the code page that corresponds to the "C" locale. At run time, you can change or query the locale code page in use with a call to [`setlocale`](./reference/setlocale-wsetlocale.md). - Multibyte code page. The behavior of most of the multibyte-character routines in the run-time library depends on the current multibyte code page setting. By default, these routines use the system-default ANSI code page. At run-time you can query and change the multibyte code page with [`_getmbcp`](./reference/getmbcp.md) and [`_setmbcp`](./reference/setmbcp.md), respectively. diff --git a/docs/c-runtime-library/compatibility.md b/docs/c-runtime-library/compatibility.md index 45f753bf021..0b56d4e3d82 100644 --- a/docs/c-runtime-library/compatibility.md +++ b/docs/c-runtime-library/compatibility.md @@ -2,7 +2,7 @@ title: "Compatibility" description: "Describes the compatibility of the Microsoft Universal C runtime library (UCRT) with the Standard C library, POSIX, the Safe CRT, and Store apps." ms.date: 1/19/2022 -ms.topic: "conceptual" +ms.topic: "concept-article" helpviewer_keywords: ["CRT, compatibility", "compatibility, C runtime libraries", "compatibility"] ms.assetid: 346709cb-edda-4909-9a19-3d253eddb6b7 --- diff --git a/docs/c-runtime-library/controlling-streams.md b/docs/c-runtime-library/controlling-streams.md index 7bdf6321eb2..43c00a11a4c 100644 --- a/docs/c-runtime-library/controlling-streams.md +++ b/docs/c-runtime-library/controlling-streams.md @@ -2,7 +2,7 @@ title: "Controlling Streams" description: "An overview of working with streams in the Microsoft C runtime library." ms.date: "11/04/2016" -ms.topic: "conceptual" +ms.topic: "concept-article" helpviewer_keywords: ["streams, controlling", "controlling streams", "streams"] ms.assetid: 267e9013-9afc-45f6-91e3-ca093230d9d9 --- diff --git a/docs/c-runtime-library/crt-debug-heap-details.md b/docs/c-runtime-library/crt-debug-heap-details.md index ffef1467161..5a0d180c7d8 100644 --- a/docs/c-runtime-library/crt-debug-heap-details.md +++ b/docs/c-runtime-library/crt-debug-heap-details.md @@ -102,14 +102,11 @@ typedef struct _CrtMemBlockHeader The `no_mans_land` buffers on either side of the user data area of the block are currently 4 bytes in size, and are filled with a known byte value used by the debug heap routines to verify that the limits of the user's memory block haven't been overwritten. The debug heap also fills new memory blocks with a known value. If you elect to keep freed blocks in the heap's linked list, these freed blocks are also filled with a known value. Currently, the actual byte values used are as follows: -`no_mans_land` (0xFD)\ -The "no_mans_land" buffers on either side of the memory used by an application are currently filled with 0xFD. - -Freed blocks (0xDD)\ -The freed blocks kept unused in the debug heap's linked list when the `_CRTDBG_DELAY_FREE_MEM_DF` flag is set are currently filled with 0xDD. - -New objects (0xCD)\ -New objects are filled with 0xCD when they're allocated. +|Code |Description | +|---------|---------| +|`no_mans_land` (0xFD) | The "no_mans_land" buffers on either side of the memory used by an application are currently filled with 0xFD. | +|Freed blocks (0xDD) | The freed blocks kept unused in the debug heap's linked list when the `_CRTDBG_DELAY_FREE_MEM_DF` flag is set are currently filled with 0xDD. | +|New objects (0xCD) | New objects are filled with 0xCD when they're allocated.| ## Types of blocks on the debug heap @@ -170,7 +167,7 @@ All calls to heap functions such as `malloc`, `free`, `calloc`, `realloc`, `new` ### To use the debug heap -- Link the debug build of your application with a debug version of the C runtime library. +Link the debug build of your application with a debug version of the C runtime library. ### To change one or more `_crtDbgFlag` bit fields and create a new state for the flag @@ -275,9 +272,9 @@ Knowing the source file name and line number of an assert or reporting macro is ### Unique allocation request numbers and `_crtBreakAlloc` -There's a simple way to identify the specific heap allocation call that went bad. It takes advantage of the unique allocation request number associated with each block in the debug heap. When information about a block is reported by one of the dump functions, this allocation request number is enclosed in braces (for example, "{36}"). +There's a simple way to identify the specific heap allocation call that went bad. It takes advantage of the unique allocation request number associated with each block in the debug heap. When information about a block is reported by one of the dump functions, this allocation request number is enclosed in braces. For example, `{36}`. -Once you know the allocation request number of an improperly allocated block, you can pass this number to [`_CrtSetBreakAlloc`](./reference/crtsetbreakalloc.md) to create a breakpoint. Execution will break just before allocating the block, and you can backtrack to determine what routine was responsible for the bad call. To avoid recompiling, you can accomplish the same thing in the debugger by setting `_crtBreakAlloc` to the allocation request number you're interested in. +Once you know the allocation request number of an improperly allocated block, you can pass this number to [`_CrtSetBreakAlloc`](./reference/crtsetbreakalloc.md) to create a breakpoint. Execution will break just before allocating the block and you can backtrack to determine what routine was responsible for the bad call. To avoid recompiling, you can accomplish the same thing in the debugger by setting `_crtBreakAlloc` to the allocation request number you're interested in. ### Creating debug versions of your allocation routines diff --git a/docs/c-runtime-library/crt-debugging-techniques.md b/docs/c-runtime-library/crt-debugging-techniques.md index a2379c0484d..fd4c975e460 100644 --- a/docs/c-runtime-library/crt-debugging-techniques.md +++ b/docs/c-runtime-library/crt-debugging-techniques.md @@ -1,6 +1,6 @@ --- -title: CRT debugging techniques -description: There are various techniques you can use to debug a program that uses the C run-time (CRT) library. Use this article and its links to learn about such techniques. +title: "CRT debugging techniques" +description: "There are various techniques you can use to debug a program that uses the C run-time (CRT) library. Use this article and its links to learn about such techniques." ms.custom: SEO-VS-2020 ms.date: 02/03/2023 f1_keywords: @@ -16,9 +16,9 @@ When you debug a program that uses the C run-time library, these debugging techn ## CRT debug library use -The C runtime (CRT) library provides extensive debugging support. To use one of the CRT debug libraries, you must link with [`/DEBUG`](/cpp/build/reference/debug-generate-debug-info) and compile with [`/MDd`, `/MTd`, or `/LDd`](../build/reference/md-mt-ld-use-run-time-library.md). +The C runtime (CRT) library provides extensive debugging support. To use one of the CRT debug libraries, you must link with [`/DEBUG`](../build/reference/debug-generate-debug-info.md) and compile with [`/MDd`, `/MTd`, or `/LDd`](../build/reference/md-mt-ld-use-run-time-library.md). -The main definitions and macros for CRT debugging can be found in the`` header file. +The main definitions and macros for CRT debugging can be found in the `` header file. The functions in the CRT debug libraries are compiled with debug information ([/Z7, /Zd, /Zi, /ZI (Debug Information Format)](../build/reference/z7-zi-zi-debug-information-format.md)) and without optimization. Some functions contain assertions to verify parameters that are passed to them, and source code is provided. With this source code, you can step into CRT functions to confirm that the functions are working as you expect and check for bad parameters or memory states. (Some CRT technology is proprietary and doesn't provide source code for exception handling, floating point, and a few other routines.) @@ -26,7 +26,7 @@ For more information on the various run-time libraries you can use, see [C Run-T ## Macros for reporting -For debugging, you can use the `_RPTn` and `_RPTFn` macros, defined in``, to replace the use of `printf` statements. You don't need to enclose them in `#ifdef` directives, because they automatically disappear in your release build when `_DEBUG` isn't defined. +For debugging, you can use the `_RPTn` and `_RPTFn` macros, defined in ``, to replace the use of `printf` statements. You don't need to enclose them in `#ifdef` directives, because they automatically disappear in your release build when `_DEBUG` isn't defined. | Macro | Description | |---|---| @@ -81,7 +81,7 @@ You can write several kinds of custom debug hook functions that allow you to ins ### Client block hook functions -If you want to validate or report the contents of the data stored in `_CLIENT_BLOCK` blocks, you can write a function specifically for this purpose. The function that you write must have a prototype similar to the following, as defined in``: +If you want to validate or report the contents of the data stored in `_CLIENT_BLOCK` blocks, you can write a function specifically for this purpose. The function that you write must have a prototype similar to the following, as defined in ``: ```cpp void YourClientDump(void *, size_t) @@ -91,7 +91,7 @@ In other words, your hook function should accept a `void` pointer to the beginni Once you've installed your hook function using [_CrtSetDumpClient](./reference/crtsetdumpclient.md), it will be called every time a `_CLIENT_BLOCK` block is dumped. You can then use [_CrtReportBlockType](./reference/crtreportblocktype.md) to get information on the type or subtype of dumped blocks. -The pointer to your function that you pass to `_CrtSetDumpClient` is of type `_CRT_DUMP_CLIENT`, as defined in``: +The pointer to your function that you pass to `_CrtSetDumpClient` is of type `_CRT_DUMP_CLIENT`, as defined in ``: ```cpp typedef void (__cdecl *_CRT_DUMP_CLIENT) @@ -113,7 +113,7 @@ int YourAllocHook(int nAllocType, void *pvData, const unsigned char * szFileName, int nLine ) ``` -The pointer that you pass to [`_CrtSetAllocHook`](./reference/crtsetallochook.md) is of type `_CRT_ALLOC_HOOK`, as defined in``: +The pointer that you pass to [`_CrtSetAllocHook`](./reference/crtsetallochook.md) is of type `_CRT_ALLOC_HOOK`, as defined in ``: ```cpp typedef int (__cdecl * _CRT_ALLOC_HOOK) @@ -169,5 +169,5 @@ If the hook handles the message in question completely, so that no further repor ## See also -- [Debugging Native Code](/visualstudio/debugger/debugging-native-code.md) -- [Debugger Security](/visualstudio/debugger/debugger-security.md) +- [Debugging Native Code](/visualstudio/debugger/debugging-native-code) +- [Debugger Security](/visualstudio/debugger/debugger-security) diff --git a/docs/c-runtime-library/crt-initialization.md b/docs/c-runtime-library/crt-initialization.md index b2971c1be1e..be30e01238f 100644 --- a/docs/c-runtime-library/crt-initialization.md +++ b/docs/c-runtime-library/crt-initialization.md @@ -1,7 +1,7 @@ --- title: "CRT Initialization" description: "Describes how the CRT initializes global state in native code." -ms.topic: "conceptual" +ms.topic: "concept-article" ms.date: 08/02/2021 helpviewer_keywords: ["CRT initialization [C++]"] --- diff --git a/docs/c-runtime-library/cxxframehandler.md b/docs/c-runtime-library/cxxframehandler.md index 67d417b3f1c..7883ff1adac 100644 --- a/docs/c-runtime-library/cxxframehandler.md +++ b/docs/c-runtime-library/cxxframehandler.md @@ -1,14 +1,13 @@ --- -description: "Learn more about: __CxxFrameHandler" title: "__CxxFrameHandler" -ms.date: "1/14/2021" +description: "Learn more about: __CxxFrameHandler" +ms.date: 1/14/2021 api_name: ["__CxxFrameHandler"] api_location: ["msvcr110.dll", "msvcrt.dll", "msvcr80.dll", "msvcr100.dll", "msvcr110_clr0400.dll", "msvcr90.dll", "msvcr120.dll"] api_type: ["DLLExport"] topic_type: ["apiref"] f1_keywords: ["__CxxFrameHandler"] helpviewer_keywords: ["__CxxFrameHandler"] -ms.assetid: b79ac97f-425a-42ae-9b91-8beaef935333 --- # `__CxxFrameHandler` @@ -43,8 +42,6 @@ Additional information about the function entry and stack frame. One of the *filter expression* values used by the [try-except Statement](../cpp/try-except-statement.md). -## Remarks - ## Requirements | Routine | Required header | diff --git a/docs/c-runtime-library/data-alignment.md b/docs/c-runtime-library/data-alignment.md index e9c8d32d667..97b03773fba 100644 --- a/docs/c-runtime-library/data-alignment.md +++ b/docs/c-runtime-library/data-alignment.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Data Alignment" title: "Data Alignment" -ms.date: "11/04/2016" +description: "Learn more about: Data Alignment" +ms.date: 11/04/2016 f1_keywords: ["data.alignment"] helpviewer_keywords: ["data alignment [C++]"] -ms.assetid: 35ac3d2d-a4b3-421b-954f-b7372b1f18e1 --- # Data alignment @@ -14,7 +13,7 @@ The following C run-time functions support data alignment. | Routine | Use | |---|---| -| [`_aligned_free`](./reference/aligned-free.md) | Frees a block of memory that was allocated with [`_aligned_malloc`](./reference/aligned-malloc.md)or [`_aligned_offset_malloc`](./reference/aligned-offset-malloc.md). | +| [`_aligned_free`](./reference/aligned-free.md) | Frees a block of memory that was allocated with [`_aligned_malloc`](./reference/aligned-malloc.md) or [`_aligned_offset_malloc`](./reference/aligned-offset-malloc.md). | | [`_aligned_free_dbg`](./reference/aligned-free-dbg.md) | Frees a block of memory that was allocated with [`_aligned_malloc`](./reference/aligned-malloc.md) or [`_aligned_offset_malloc`](./reference/aligned-offset-malloc.md) (debug only). | | [`_aligned_malloc`](./reference/aligned-malloc.md) | Allocates memory on a specified alignment boundary. | | [`_aligned_malloc_dbg`](./reference/aligned-malloc-dbg.md) | Allocates memory on a specified alignment boundary with extra space for a debugging header and overwrite buffers (debug version only). | diff --git a/docs/c-runtime-library/debug.md b/docs/c-runtime-library/debug.md index 049cce0df2b..f3d187ab4ff 100644 --- a/docs/c-runtime-library/debug.md +++ b/docs/c-runtime-library/debug.md @@ -1,16 +1,16 @@ --- -description: "Learn more about: _DEBUG" title: "_DEBUG" -ms.date: "11/04/2016" +description: "Learn more about: _DEBUG" +ms.date: 11/04/2016 helpviewer_keywords: ["DEBUG macro", "_DEBUG macro"] -ms.assetid: a9901568-4846-4731-a404-399d947e2e7a --- # `_DEBUG` -The compiler defines `_DEBUG` when you specify the /MTd or /MDd option. These options specify debug versions of the C run-time library. +The compiler defines `_DEBUG` when you specify the [`/MTd`](../build/reference/md-mt-ld-use-run-time-library.md), [`/MDd`](../build/reference/md-mt-ld-use-run-time-library.md), or [`/LDd`](../build/reference/md-mt-ld-use-run-time-library.md) option. These options specify debug versions of the C run-time library. -For more information, see [CRT debugging techniques](./crt-debugging-techniques.md). +For more information, see [CRT debugging techniques](crt-debugging-techniques.md). ## See also -[Control flags](./control-flags.md) +[Control flags](control-flags.md)\ +[Predefined macros](../preprocessor/predefined-macros.md) diff --git a/docs/c-runtime-library/direction-flag.md b/docs/c-runtime-library/direction-flag.md index 1acd9cfb5f3..f3e62b0e4a9 100644 --- a/docs/c-runtime-library/direction-flag.md +++ b/docs/c-runtime-library/direction-flag.md @@ -2,7 +2,7 @@ title: "Direction Flag" description: "Describes the effect of the CPU direction flag on Microsoft C runtime functions." ms.date: "11/04/2016" -ms.topic: "conceptual" +ms.topic: "concept-article" helpviewer_keywords: ["direction flag"] ms.assetid: 0836b4af-dbbb-4ab8-a4b2-156f2e2099e2 --- diff --git a/docs/c-runtime-library/file-handling.md b/docs/c-runtime-library/file-handling.md index 9ff1cf7924e..661f7a0fb39 100644 --- a/docs/c-runtime-library/file-handling.md +++ b/docs/c-runtime-library/file-handling.md @@ -1,16 +1,15 @@ --- -description: "Learn more about: File Handling" title: "File Handling" -ms.date: "11/04/2016" +description: "Learn more about: File Handling" +ms.date: 11/04/2016 f1_keywords: ["c.files"] helpviewer_keywords: ["files [C++], handling", "files [C++], opening", "files [C++], manipulating"] -ms.assetid: 48119e2e-e94f-4602-b08b-b72440f731d8 --- # File handling Use these routines to create, delete, and manipulate files and to set and check file-access permissions. -The C run-time libraries have a 512 limit for the number of files that can be open at any one time. Attempting to open more than the maximum number of file descriptors or file streams causes program failure. Use [`_setmaxstdio`](./reference/setmaxstdio.md) to change this number. +The C run-time libraries have a 512 limit for the number of files that can be open at any one time. Attempting to open more than the maximum number of file descriptors or file streams causes program failure. Use [`_setmaxstdio`](reference/setmaxstdio.md) to change this number. ## File-handling routines (file descriptor) @@ -18,14 +17,14 @@ These routines operate on files designated by a file descriptor. | Routine | Use | |---|---| -| [`_chsize`](./reference/chsize.md),[`_chsize_s`](./reference/chsize-s.md) | Change file size | -| [`_filelength`, `_filelengthi64`](./reference/filelength-filelengthi64.md) | Get file length | -| [`_fstat`, `_fstat32`, `_fstat64`, `_fstati64`, `_fstat32i64`, `_fstat64i32`](./reference/fstat-fstat32-fstat64-fstati64-fstat32i64-fstat64i32.md) | Get file-status information on descriptor | -| [`_get_osfhandle`](./reference/get-osfhandle.md) | Return operating-system file handle associated with existing C run-time file descriptor | -| [`_isatty`](./reference/isatty.md) | Check for character device | -| [`_locking`](./reference/locking.md) | Lock areas of file | -| [`_open_osfhandle`](./reference/open-osfhandle.md) | Associate C run-time file descriptor with existing operating-system file handle | -| [`_setmode`](./reference/setmode.md) | Set file-translation mode | +| [`_chsize`](reference/chsize.md), [`_chsize_s`](reference/chsize-s.md) | Change file size | +| [`_filelength`, `_filelengthi64`](reference/filelength-filelengthi64.md) | Get file length | +| [`_fstat`, `_fstat32`, `_fstat64`, `_fstati64`, `_fstat32i64`, `_fstat64i32`](reference/fstat-fstat32-fstat64-fstati64-fstat32i64-fstat64i32.md) | Get file-status information on descriptor | +| [`_get_osfhandle`](reference/get-osfhandle.md) | Return operating-system file handle associated with existing C run-time file descriptor | +| [`_isatty`](reference/isatty.md) | Check for character device | +| [`_locking`](reference/locking.md) | Lock areas of file | +| [`_open_osfhandle`](reference/open-osfhandle.md) | Associate C run-time file descriptor with existing operating-system file handle | +| [`_setmode`](reference/setmode.md) | Set file-translation mode | ## File-Handling Routines (Path or Filename) @@ -33,17 +32,17 @@ These routines operate on files specified by a path or filename. | Routine | Use | |---|---| -| [`_access`, `_waccess`](./reference/access-waccess.md), [`_access_s`, `_waccess_s`](./reference/access-s-waccess-s.md) | Check file-permission setting | -| [`_chmod`, `_wchmod`](./reference/chmod-wchmod.md) | Change file-permission setting | -| [`_fullpath`, `_wfullpath`](./reference/fullpath-wfullpath.md) | Expand a relative path to its absolute path name | -| [`_makepath`, `_wmakepath`](./reference/makepath-wmakepath.md), [`_makepath_s`, `_wmakepath_s`](./reference/makepath-s-wmakepath-s.md) | Merge path components into single, full path | -| [`_mktemp`, `_wmktemp`](./reference/mktemp-wmktemp.md), [`_mktemp_s`, `_wmktemp_s`](./reference/mktemp-s-wmktemp-s.md) | Create unique filename | -| [`remove`, `_wremove`](./reference/remove-wremove.md) | Delete file | -| [`rename`, `_wrename`](./reference/rename-wrename.md) | Rename file | -| [`_splitpath`, `_wsplitpath`](./reference/splitpath-wsplitpath.md), [`_splitpath_s`, `_wsplitpath_s`](./reference/splitpath-s-wsplitpath-s.md) | Parse path into components | -| [`_stat`, `_stat64`, `_stati64`, `_wstat`, `_wstat64`, `_wstati64`](./reference/stat-functions.md) | Get file-status information on named file | -| [`_umask`](./reference/umask.md), [`_umask_s`](./reference/umask-s.md) | Set default permission mask for new files created by program | -| [`_unlink`, `_wunlink`](./reference/unlink-wunlink.md) | Delete file | +| [`_access`, `_waccess`](reference/access-waccess.md), [`_access_s`, `_waccess_s`](reference/access-s-waccess-s.md) | Check file-permission setting | +| [`_chmod`, `_wchmod`](reference/chmod-wchmod.md) | Change file-permission setting | +| [`_fullpath`, `_wfullpath`](reference/fullpath-wfullpath.md) | Expand a relative path to its absolute path name | +| [`_makepath`, `_wmakepath`](reference/makepath-wmakepath.md), [`_makepath_s`, `_wmakepath_s`](reference/makepath-s-wmakepath-s.md) | Merge path components into single, full path | +| [`_mktemp`, `_wmktemp`](reference/mktemp-wmktemp.md), [`_mktemp_s`, `_wmktemp_s`](reference/mktemp-s-wmktemp-s.md) | Create unique filename | +| [`remove`, `_wremove`](reference/remove-wremove.md) | Delete file | +| [`rename`, `_wrename`](reference/rename-wrename.md) | Rename file | +| [`_splitpath`, `_wsplitpath`](reference/splitpath-wsplitpath.md), [`_splitpath_s`, `_wsplitpath_s`](reference/splitpath-s-wsplitpath-s.md) | Parse path into components | +| [`_stat`, `_stat64`, `_stati64`, `_wstat`, `_wstat64`, `_wstati64`](reference/stat-functions.md) | Get file-status information on named file | +| [`_umask`](reference/umask.md), [`_umask_s`](reference/umask-s.md) | Set default permission mask for new files created by program | +| [`_unlink`, `_wunlink`](reference/unlink-wunlink.md) | Delete file | ## File-Handling Routines (Open File) @@ -51,32 +50,30 @@ These routines open files. | Routine | Use | |---|---| -| [`fopen`, `_wfopen`](./reference/fopen-wfopen.md), [`fopen_s`, `_wfopen_s`](./reference/fopen-s-wfopen-s.md) | Opens a file and returns a pointer to the open file. | -| [`_fsopen`, `_wfsopen`](./reference/fsopen-wfsopen.md) | Open a stream with file sharing and returns a pointer to the open file. | -| [`_open`, `_wopen`](./reference/open-wopen.md) | Opens a file and returns a file descriptor to the opened file. | -| [`_sopen`, `_wsopen`](./reference/sopen-wsopen.md), [`_sopen_s`, `_wsopen_s`](./reference/sopen-s-wsopen-s.md) | Open a file with file sharing and returns a file descriptor to the open file. | -| [`_pipe`](./reference/pipe.md) | Creates a pipe for reading and writing. | -| [`freopen`, `_wfreopen`](./reference/freopen-wfreopen.md), [`freopen_s`, `_wfreopen_s`](./reference/freopen-s-wfreopen-s.md) | Reassign a file pointer. | +| [`fopen`, `_wfopen`](reference/fopen-wfopen.md), [`fopen_s`, `_wfopen_s`](reference/fopen-s-wfopen-s.md) | Opens a file and returns a pointer to the open file. | +| [`_fsopen`, `_wfsopen`](reference/fsopen-wfsopen.md) | Open a stream with file sharing and returns a pointer to the open file. | +| [`_open`, `_wopen`](reference/open-wopen.md) | Opens a file and returns a file descriptor to the opened file. | +| [`_sopen`, `_wsopen`](reference/sopen-wsopen.md), [`_sopen_s`, `_wsopen_s`](reference/sopen-s-wsopen-s.md) | Open a file with file sharing and returns a file descriptor to the open file. | +| [`_pipe`](reference/pipe.md) | Creates a pipe for reading and writing. | +| [`freopen`, `_wfreopen`](reference/freopen-wfreopen.md), [`freopen_s`, `_wfreopen_s`](reference/freopen-s-wfreopen-s.md) | Reassign a file pointer. | These routines provide a way to change the representation of the file between a `FILE` structure, a file descriptor, and a Win32 file handle. | Routine | Use | |---|---| -| [`_fdopen`, `_wfdopen`](./reference/fdopen-wfdopen.md) | Associates a stream with a file that was previously opened for low-level I/O and returns a pointer to the open stream. | -| [`_fileno`](./reference/fileno.md) | Gets the file descriptor associated with a stream. | -| [`_get_osfhandle`](./reference/get-osfhandle.md) | Return operating-system file handle associated with existing C run-time file descriptor | -| [`_open_osfhandle`](./reference/open-osfhandle.md) | Associates C run-time file descriptor with an existing operating-system file handle. | +| [`_fdopen`, `_wfdopen`](reference/fdopen-wfdopen.md) | Associates a stream with a file that was previously opened for low-level I/O and returns a pointer to the open stream. | +| [`_fileno`](reference/fileno.md) | Gets the file descriptor associated with a stream. | +| [`_get_osfhandle`](reference/get-osfhandle.md) | Return operating-system file handle associated with existing C run-time file descriptor | +| [`_open_osfhandle`](reference/open-osfhandle.md) | Associates C run-time file descriptor with an existing operating-system file handle. | The following Win32 functions also open files and pipes: - [`CreateFile`](/windows/win32/api/fileapi/nf-fileapi-createfilew) - - [`CreatePipe`](/windows/win32/api/namedpipeapi/nf-namedpipeapi-createpipe) - - [`CreateNamedPipe`](/windows/win32/api/winbase/nf-winbase-createnamedpipea) ## See also -[Universal C runtime routines by category](./run-time-routines-by-category.md)\ -[Directory control](./directory-control.md)\ -[System calls](./system-calls.md) +[Universal C runtime routines by category](run-time-routines-by-category.md)\ +[Directory control](directory-control.md)\ +[System calls](system-calls.md) diff --git a/docs/c-runtime-library/files-and-streams.md b/docs/c-runtime-library/files-and-streams.md index 16b6697be76..99c256fc55a 100644 --- a/docs/c-runtime-library/files-and-streams.md +++ b/docs/c-runtime-library/files-and-streams.md @@ -2,7 +2,7 @@ title: "Files and Streams" description: "An overview of files and streams in the Microsoft C runtime library." ms.date: "11/04/2016" -ms.topic: "conceptual" +ms.topic: "concept-article" helpviewer_keywords: ["files [C++]", "streams"] ms.assetid: f61e712b-eac9-4c28-bb18-97c3786ef387 --- diff --git a/docs/c-runtime-library/find-memory-leaks-using-the-crt-library.md b/docs/c-runtime-library/find-memory-leaks-using-the-crt-library.md index dea101aead3..1e78d27ce57 100644 --- a/docs/c-runtime-library/find-memory-leaks-using-the-crt-library.md +++ b/docs/c-runtime-library/find-memory-leaks-using-the-crt-library.md @@ -2,7 +2,7 @@ title: Find memory leaks with the CRT library description: Learn how the C/C++ debugger and C Run-time Library (CRT) can help find memory leaks. The techniques include memory-leak reports and comparing memory snapshots. ms.date: 02/03/2023 -helpviewer_keywords: +helpviewer_keywords: - breakpoints, on memory allocation - _CrtMemState - _CrtMemCheckpoint @@ -165,7 +165,7 @@ struct Pod { int x; }; -void main() { +int main() { Pod* pPod = DBG_NEW Pod; pPod = DBG_NEW Pod; // Oops, leaked the original pPod! delete pPod; @@ -216,7 +216,7 @@ You can use the allocation number to set a breakpoint on the memory allocation. After you set a breakpoint on a memory-allocation number, continue to debug. Make sure to run under the same conditions, so the memory-allocation number doesn't change. When your program breaks at the specified memory allocation, use the **Call Stack** window and other debugger windows to determine the conditions under which the memory was allocated. Then, you can continue execution to observe what happens to the object and determine why it isn't correctly deallocated. -Setting a data breakpoint on the object might also be helpful. For more information, see [Using breakpoints](/visualstudio/debugger/using-breakpoints.md). +Setting a data breakpoint on the object might also be helpful. For more information, see [Using breakpoints](/visualstudio/debugger/using-breakpoints). You can also set memory-allocation breakpoints in code. You can set: @@ -241,7 +241,7 @@ _CrtMemCheckpoint( &s1 ); The `_CrtMemCheckpoint` function fills in the structure with a snapshot of the current memory state. -To output the contents of a `_CrtMemState` structure, pass the structure to the `_ CrtMemDumpStatistics` function: +To output the contents of a `_CrtMemState` structure, pass the structure to the `_CrtMemDumpStatistics` function: ```cpp _CrtMemDumpStatistics( &s1 ); @@ -281,5 +281,5 @@ One technique for finding memory leaks begins by placing `_CrtMemCheckpoint` cal ## See also - [CRT debug heap details](./crt-debug-heap-details.md) -- [Debugger security](/visualstudio/debugger/debugger-security.md) -- [Debugging native code](/visualstudio/debugger/debugging-native-code.md) +- [Debugger security](/visualstudio/debugger/debugger-security) +- [Debugging native code](/visualstudio/debugger/debugging-native-code) diff --git a/docs/c-runtime-library/floating-point-support.md b/docs/c-runtime-library/floating-point-support.md index 69a51ce7ce6..7f4ac7bc98c 100644 --- a/docs/c-runtime-library/floating-point-support.md +++ b/docs/c-runtime-library/floating-point-support.md @@ -11,7 +11,9 @@ The Universal C Runtime library (UCRT) provides many integral and floating-point For ISO C Standard 11 (C11) and later, the `` header, in addition to including `` and ``, provides macros that invoke a corresponding math function based on the types of the parameters. See [Type-generic math](tgmath.md) for details. -Many of the floating point math library functions have different implementations for different CPU architectures. For example, the 32-bit x86 CRT may have a different implementation than the 64-bit x64 CRT. In addition, some of the functions may have multiple implementations for a given CPU architecture. The most efficient implementation is selected dynamically at run-time depending on the instruction sets supported by the CPU. For example, in the 32-bit x86 CRT, some functions have both an x87 implementation and an SSE2 implementation. When running on a CPU that supports SSE2, the faster SSE2 implementation is used. When running on a CPU that doesn't support SSE2, the slower x87 implementation is used. Because different implementations of the math library functions may use different CPU instructions and different algorithms to produce their results, the functions may produce different results across CPUs. In most cases, the results are within +/-1 ULP of the correctly rounded result, but the actual results may vary across CPUs. +Many of the floating-point math library functions have different implementations for different CPU architectures. For example, the 32-bit x86 CRT may have a different implementation than the 64-bit x64 CRT. In addition, some of the functions may have multiple implementations for a given CPU architecture. The most efficient implementation is selected dynamically at run-time depending on the instruction sets supported by the CPU. For example, in the 32-bit x86 CRT, some functions have both an x87 implementation and an SSE2 implementation. When running on a CPU that supports SSE2, the faster SSE2 implementation is used. When running on a CPU that doesn't support SSE2, the slower x87 implementation is used. Because different implementations of the math library functions may use different CPU instructions and different algorithms to produce their results, the functions may produce different results across CPUs. In most cases, the results are within +/-1 ULP of the correctly rounded result, but the actual results may vary across CPUs. + +Newer versions of the UCRT might improve the precision and accuracy of the floating-point math library functions. Since the UCRT is part of the Windows operating system, you might get different results for these functions on different operating system versions or between debug and release builds. Although it is not recommended, you can statically link to the UCRT to guarantee consistent results if you need these functions will produce identical results everywhere. Previous 16-bit versions of Microsoft C/C++ and Microsoft Visual C++ supported the **`long double`** type as an 80-bit precision floating-point data type. In later versions of Visual C++, the **`long double`** data type is a 64-bit precision floating-point data type identical to the **`double`** type. The compiler treats **`long double`** and **`double`** as distinct types, but the **`long double`** functions are identical to their **`double`** counterparts. The CRT provides **`long double`** versions of the math functions for ISO C99 source code compatibility, but note that the binary representation may differ from other compilers. @@ -79,7 +81,7 @@ Previous 16-bit versions of Microsoft C/C++ and Microsoft Visual C++ supported t | [`imaxabs`](./reference/imaxabs.md) | Computes the absolute value of an integer type | | [`imaxdiv`](./reference/imaxdiv.md) | Computes the quotient and the remainder of two integer values | | [`isfinite`, `_finite`, `_finitef`](./reference/finite-finitef.md) | Determines whether a value is finite | -| [`isgreater`, `isgreaterequal`, `isless`, `islessequal`, `islessgreater`, `isunordered`](./reference/floating-point-ordering.md) | Compare the order of two floating point values | +| [`isgreater`, `isgreaterequal`, `isless`, `islessequal`, `islessgreater`, `isunordered`](./reference/floating-point-ordering.md) | Compare the order of two floating-point values | | [`isinf`](./reference/isinf.md) | Determines whether a floating-point value is infinite | | [`isnan`, `_isnan`, `_isnanf`](./reference/isnan-isnan-isnanf.md) | Tests a floating-point value for NaN | | [`isnormal`](./reference/isnormal.md) | Tests whether a floating-point value is both finite and not subnormal | diff --git a/docs/c-runtime-library/format-specification-syntax-printf-and-wprintf-functions.md b/docs/c-runtime-library/format-specification-syntax-printf-and-wprintf-functions.md index 7b8fe374953..c6b482f1f36 100644 --- a/docs/c-runtime-library/format-specification-syntax-printf-and-wprintf-functions.md +++ b/docs/c-runtime-library/format-specification-syntax-printf-and-wprintf-functions.md @@ -1,9 +1,8 @@ --- title: "Format Specification Syntax: `printf` and `wprintf` Functions" -description: "Describes the format specifier syntax for the Microsoft C runtime `printf` and `wprintf` functions" -ms.date: "10/26/2020" +description: "Describes the format specifier syntax for the Microsoft C runtime `printf` and `wprintf` functions" +ms.date: 10/26/2020 helpviewer_keywords: ["format specification fields for printf function", "printf function format specification fields", "flag directives, printf function", "type fields, printf function", "width fields, printf function", "precision fields, printf function"] -ms.assetid: 664b1717-2760-4c61-bd9c-22eee618d825 --- # Format specification syntax: `printf` and `wprintf` functions diff --git a/docs/c-runtime-library/gets-getws.md b/docs/c-runtime-library/gets-getws.md index f3da079669f..d688cef1fbf 100644 --- a/docs/c-runtime-library/gets-getws.md +++ b/docs/c-runtime-library/gets-getws.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: gets, _getws" title: "gets, _getws" -ms.date: "4/2/2020" +description: "Learn more about: gets, _getws" +ms.date: 4/2/2020 api_name: ["_getws", "gets", "_o__getws", "_o_gets"] api_location: ["msvcr80.dll", "msvcr90.dll", "msvcr120.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcrt.dll", "msvcr100.dll", "api-ms-win-crt-stdio-l1-1-0.dll"] api_type: ["DLLExport"] @@ -14,7 +14,7 @@ helpviewer_keywords: ["getws function", "getts function", "_getws function", "li Gets a line from the **`stdin`** stream. More secure versions of these functions are available; see [`gets_s`, `_getws_s`](./reference/gets-s-getws-s.md). > [!IMPORTANT] -> These functions are obsolete. Beginning in Visual Studio 2015, they are not available in the CRT. The secure versions of these functions, `gets_s` and `_getws_s`, are still available. For information on these alternative functions, see [`gets_s`, `_getws_s`](./reference/gets-s-getws-s.md). +> These functions are obsolete. Beginning in Visual Studio 2015, they are not available in the CRT. The secure versions of these functions, `gets_s` and `_getws_s`, are still available. For information on these alternative functions, see [`gets_s`, `_getws_s`](./reference/gets-s-getws-s.md). > [!IMPORTANT] > This API cannot be used in applications that execute in the Windows Runtime. For more information, see [CRT functions not supported in Universal Windows Platform apps](../cppcx/crt-functions-not-supported-in-universal-windows-platform-apps.md). diff --git a/docs/c-runtime-library/global-state.md b/docs/c-runtime-library/global-state.md index b1d216c39c7..a68848f3215 100644 --- a/docs/c-runtime-library/global-state.md +++ b/docs/c-runtime-library/global-state.md @@ -1,8 +1,8 @@ --- title: "Global state in the CRT" -description: "Describes how shared global state is handled in the Microsoft Universal C Runtime." -ms.topic: "conceptual" -ms.date: "10/02/2020" +description: "Describes how shared global state is handled in the Microsoft Universal C Runtime." +ms.date: 10/02/2020 +ms.topic: "concept-article" helpviewer_keywords: ["CRT global state"] --- @@ -29,7 +29,7 @@ There are two ways to isolate your component's CRT state from an app's CRT state - Starting in Windows versions beginning with Windows 10 version 2004, dynamically link to the CRT but call the OS-mode exports (the functions that begin with _o_). To call the OS-mode exports, statically link as before, but ignore the static UCRT by using linker option `/NODEFAULTLIB:libucrt.lib` (release) or `/NODEFAULTLIB:libucrtd.lib` (debug). And add `ucrt.osmode.lib` to the linker input. See [`/NODEFAULTLIB` (Ignore Libraries)](../build/reference/nodefaultlib-ignore-libraries.md) for details. > [!NOTE] -> In source code, write `setlocale()`, not `_o_setlocale()`. When you link against `ucrt.osmode.lib`, the linker will automatically substitute the OS-specific version of the function. That is, `setlocale()` will be substituted with `_o_setlocale()`. +> In source code, write `setlocale()`, not `_o_setlocale()`. When you link against `ucrt.osmode.lib`, the linker will automatically substitute the OS-specific version of the function. That is, `setlocale()` will be substituted with `_o_setlocale()`. Linking against `ucrt.osmode.lib` disables some UCRT calls that are only available in app mode. Attempting to call these functions will result in a link error. diff --git a/docs/c-runtime-library/heapset.md b/docs/c-runtime-library/heapset.md index 98b435fbb4d..71dcd097259 100644 --- a/docs/c-runtime-library/heapset.md +++ b/docs/c-runtime-library/heapset.md @@ -1,6 +1,6 @@ --- -description: "Learn more about: _heapset" title: "_heapset" +description: "Learn more about: _heapset" ms.date: "11/04/2016" api_name: ["_heapset"] api_location: ["msvcr90.dll", "msvcr80.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcrt.dll", "msvcr120.dll", "msvcr100.dll"] @@ -8,7 +8,6 @@ api_type: ["DLLExport"] topic_type: ["apiref"] f1_keywords: ["_heapset", "heapset"] helpviewer_keywords: ["checking heap", "heapset function", "heaps, checking", "debugging [CRT], heap-related problems", "_heapset function"] -ms.assetid: 9667eeb0-55bc-4c19-af5f-d1fd0a142b3c --- # `_heapset` @@ -47,7 +46,7 @@ In addition, if an error occurs, **`_heapset`** sets `errno` to `ENOSYS`. The **`_heapset`** function shows free memory locations or nodes that have been unintentionally overwritten. -**`_heapset`** checks for minimal consistency on the heap and then sets each byte of the heap's free entries to the `fill` value. This known value shows which memory locations of the heap contain free nodes and which contain data that were unintentionally written to freed memory. If the operating system doesn't support **`_heapset`**(for example, Windows 98), the function returns `_HEAPOK` and sets `errno` to `ENOSYS`. +**`_heapset`** checks for minimal consistency on the heap and then sets each byte of the heap's free entries to the `fill` value. This known value shows which memory locations of the heap contain free nodes and which contain data that were unintentionally written to freed memory. If the operating system doesn't support **`_heapset`** (for example, Windows 98), the function returns `_HEAPOK` and sets `errno` to `ENOSYS`. ## Requirements diff --git a/docs/c-runtime-library/internal-set-app-type.md b/docs/c-runtime-library/internal-set-app-type.md index 9faaf4a49e3..bdf12cb0d35 100644 --- a/docs/c-runtime-library/internal-set-app-type.md +++ b/docs/c-runtime-library/internal-set-app-type.md @@ -1,14 +1,13 @@ --- -description: "Learn more about: __set_app_type" title: "__set_app_type" -ms.date: "11/04/2016" +description: "Learn more about: __set_app_type" +ms.date: 11/04/2016 api_name: ["__set_app_type", "_set_app_type"] api_location: ["msvcr90.dll", "msvcr100.dll", "msvcr110.dll", "msvcr80.dll", "msvcrt.dll", "msvcr120.dll", "msvcr110_clr0400.dll", "api-ms-win-crt-runtime-l1-1-0.dll"] api_type: ["DLLExport"] topic_type: ["apiref"] f1_keywords: ["__set_app_type"] helpviewer_keywords: ["__set_app_type"] -ms.assetid: f0ac0f4d-70e6-4e96-9e43-eb9d1515490c --- # `__set_app_type` @@ -33,8 +32,6 @@ A value that indicates the application type. The possible values are: | `_CONSOLE_APP` | Console (command-line) application. | | `_GUI_APP` | GUI (Windows) application. | -## Remarks - ## Requirements | Routine | Required header | diff --git a/docs/c-runtime-library/internationalization.md b/docs/c-runtime-library/internationalization.md index e66a9a923f6..93d47d0e917 100644 --- a/docs/c-runtime-library/internationalization.md +++ b/docs/c-runtime-library/internationalization.md @@ -2,7 +2,7 @@ title: "Internationalization" ms.date: "09/29/2020" description: "A description of Microsoft runtime library support for writing apps for international markets." -ms.topic: "conceptual" +ms.topic: "concept-article" helpviewer_keywords: ["localization, routines for", "locale-dependent routines", "internationalization routines", "international applications, run-time routines for"] ms.assetid: ee536a04-3558-4729-8e10-6dabcde055fd --- diff --git a/docs/c-runtime-library/is-isw-routines.md b/docs/c-runtime-library/is-isw-routines.md index ed954731123..84eb09729b9 100644 --- a/docs/c-runtime-library/is-isw-routines.md +++ b/docs/c-runtime-library/is-isw-routines.md @@ -1,6 +1,6 @@ --- -description: "Learn more about: is, isw Routines" title: "is, isw Routines" +description: "Learn more about: is, isw Routines" ms.date: 01/11/2022 helpviewer_keywords: ["is routines", "isw routines"] --- @@ -15,7 +15,7 @@ helpviewer_keywords: ["is routines", "isw routines"] [`iscntrl`, `iswcntrl`, `_iscntrl_l`, `_iswcntrl_l`](./reference/iscntrl-iswcntrl-iscntrl-l-iswcntrl-l.md)\ [`iscsym`, `iscsymf`, `__iscsym`, `__iswcsym`, `__iscsymf`, `__iswcsymf`, `_iscsym_l`, `_iswcsym_l`, `_iscsymf_l`, `_iswcsymf_l`](./reference/iscsym-functions.md)\ [`_isctype`, `iswctype`, `_isctype_l`, `_iswctype_l`](./reference/isctype-iswctype-isctype-l-iswctype-l.md)\ - [`isdigit`, `iswdigit`, `_isdigit_l`, `_iswdigit_l`](./reference/isdigit-iswdigit-isdigit-l-iswdigit-l.md) + [`isdigit`, `iswdigit`, `_isdigit_l`, `_iswdigit_l`](./reference/isdigit-iswdigit-isdigit-l-iswdigit-l.md)\ [`isgraph`, `iswgraph`, `_isgraph_l`, `_iswgraph_l`](./reference/isgraph-iswgraph-isgraph-l-iswgraph-l.md)\ [`isleadbyte`, `_isleadbyte_l`](./reference/isleadbyte-isleadbyte-l.md)\ [`islower`, `iswlower`, `_islower_l`, `_iswlower_l`](./reference/islower-iswlower-islower-l-iswlower-l.md)\ @@ -126,7 +126,6 @@ Character has property specified by the `desc` argument. For each valid value of | `_LOWER` | `iswlower(c)` | | `_ALPHA | _BLANK | _DIGIT | _PUNCT` | `iswprint(c)` | | `_PUNCT` | `iswpunct(c)` | -| `_BLANK` | `iswblank(c)` | | `_SPACE` | `iswspace(c)` | | `_UPPER` | `iswupper(c)` | | `_HEX` | `iswxdigit(c)` | diff --git a/docs/c-runtime-library/ismbb-routines.md b/docs/c-runtime-library/ismbb-routines.md index 2d24fedf48a..328cb2d6977 100644 --- a/docs/c-runtime-library/ismbb-routines.md +++ b/docs/c-runtime-library/ismbb-routines.md @@ -1,6 +1,6 @@ --- -description: "Learn more about: _ismbb routines" title: "_ismbb routines" +description: "Learn more about: _ismbb routines" ms.date: 01/11/2022 helpviewer_keywords: ["ismbb routines", "_ismbb routines"] --- @@ -21,7 +21,7 @@ Tests the given integer value `c` for a particular condition, by using the curre [`_ismbblead`, `_ismbblead_l`](./reference/ismbblead-ismbblead-l.md)\ [`_ismbbprint`, `_ismbbprint_l`](./reference/ismbbprint-ismbbprint-l.md)\ [`_ismbbpunct`, `_ismbbpunct_l`](./reference/ismbbpunct-ismbbpunct-l.md)\ - [`_ismbbtrail`, `_ismbbtrail_l`](./reference/ismbbtrail-ismbbtrail-l.md)\ + [`_ismbbtrail`, `_ismbbtrail_l`](./reference/ismbbtrail-ismbbtrail-l.md) :::column-end::: :::row-end::: diff --git a/docs/c-runtime-library/ismbc-routines.md b/docs/c-runtime-library/ismbc-routines.md index b941bbcf3cb..7c7a33362cb 100644 --- a/docs/c-runtime-library/ismbc-routines.md +++ b/docs/c-runtime-library/ismbc-routines.md @@ -1,41 +1,40 @@ --- -description: "Learn more about: _ismbc Routines" title: "_ismbc Routines" +description: "Learn more about: _ismbc Routines" ms.date: "11/04/2016" helpviewer_keywords: ["ismbc routines", "_ismbc routines"] -ms.assetid: b8995391-7857-4ac3-9a1e-de946eb4464d --- # `_ismbc` routines Each `_ismbc` routine tests a given multibyte character `c` for a particular condition. -- [`_ismbcalnum`, `_ismbcalnum_l`, `_ismbcalpha`, `_ismbcalpha_l`, `_ismbcdigit`, `_ismbcdigit_l`](./reference/ismbcalnum-functions.md)\ -- [`_ismbcl0`, `_ismbcl0_l`, `_ismbcl1`, `_ismbcl1_l`, `_ismbcl2`, `_ismbcl2_l`](./reference/ismbcl0-ismbcl0-l-ismbcl1-ismbcl1-l-ismbcl2-ismbcl2-l.md)\ -- [`_ismbcgraph`, `_ismbcgraph_l`, `_ismbcprint`, `_ismbcprint_l`, `_ismbcpunct`, `_ismbcpunct_l`, `_ismbcblank`, `_ismbcblank_l`, `_ismbcspace`, `_ismbcspace_l`](./reference/ismbcgraph-functions.md)\ -- [`_ismbclegal`, `_ismbclegal_l`, `_ismbcsymbol`, `_ismbcsymbol_l`](./reference/ismbclegal-ismbclegal-l-ismbcsymbol-ismbcsymbol-l.md)\ -- [`_ismbchira`, `_ismbchira_l`, `_ismbckata`, `_ismbckata_l`](./reference/ismbchira-ismbchira-l-ismbckata-ismbckata-l.md)\ -- [`_ismbclower`, `_ismbclower_l`, `_ismbcupper`, `_ismbcupper_l`](./reference/ismbclower-ismbclower-l-ismbcupper-ismbcupper-l.md) +- [`_ismbcalnum`, `_ismbcalnum_l`, `_ismbcalpha`, `_ismbcalpha_l`, `_ismbcdigit`, `_ismbcdigit_l`](reference/ismbcalnum-functions.md) +- [`_ismbcl0`, `_ismbcl0_l`, `_ismbcl1`, `_ismbcl1_l`, `_ismbcl2`, `_ismbcl2_l`](reference/ismbcl0-ismbcl0-l-ismbcl1-ismbcl1-l-ismbcl2-ismbcl2-l.md) +- [`_ismbcgraph`, `_ismbcgraph_l`, `_ismbcprint`, `_ismbcprint_l`, `_ismbcpunct`, `_ismbcpunct_l`, `_ismbcblank`, `_ismbcblank_l`, `_ismbcspace`, `_ismbcspace_l`](reference/ismbcgraph-functions.md) +- [`_ismbclegal`, `_ismbclegal_l`, `_ismbcsymbol`, `_ismbcsymbol_l`](reference/ismbclegal-ismbclegal-l-ismbcsymbol-ismbcsymbol-l.md) +- [`_ismbchira`, `_ismbchira_l`, `_ismbckata`, `_ismbckata_l`](reference/ismbchira-ismbchira-l-ismbckata-ismbckata-l.md) +- [`_ismbclower`, `_ismbclower_l`, `_ismbcupper`, `_ismbcupper_l`](reference/ismbclower-ismbclower-l-ismbcupper-ismbcupper-l.md) ## Remarks -The test result of each `_ismbc` routine depends on the multibyte code page in effect. Multibyte code pages have single-byte alphabetic characters. By default, the multibyte code page is set to the system-default ANSI code page obtained from the operating system at program startup. You can query or change the multibyte code page in use with [`_getmbcp`](./reference/getmbcp.md) or [`_setmbcp`](./reference/setmbcp.md), respectively. +The test result of each `_ismbc` routine depends on the multibyte code page in effect. Multibyte code pages have single-byte alphabetic characters. By default, the multibyte code page is set to the system-default ANSI code page obtained from the operating system at program startup. You can query or change the multibyte code page in use with [`_getmbcp`](reference/getmbcp.md) or [`_setmbcp`](reference/setmbcp.md), respectively. -The output value is affected by the `LC_CTYPE` category setting of the locale. For more information, see [`setlocale`](./reference/setlocale-wsetlocale.md). The versions of these functions without the `_l` suffix use the current locale for this locale-dependent behavior; the versions with the `_l` suffix are identical except that they use the locale parameter passed in instead. +The output value is affected by the `LC_CTYPE` category setting of the locale. For more information, see [`setlocale`](reference/setlocale-wsetlocale.md). The versions of these functions without the `_l` suffix use the current locale for this locale-dependent behavior; the versions with the `_l` suffix are identical except that they use the locale parameter passed in instead. | Routine | Test condition | Code page 932 example | |---|---|---| -| [`_ismbcalnum`, `_ismbcalnum_l`](./reference/ismbcalnum-functions.md) | Alphanumeric | Returns nonzero if and only if `c` is a single-byte representation of an ASCII English letter: See examples for `_ismbcdigit` and `_ismbcalpha`. | -| [`_ismbcalpha`, `_ismbcalpha_l`](./reference/ismbcalnum-functions.md) | Alphabetic | Returns nonzero if and only if `c` is a single-byte representation of an ASCII English letter: See examples for `_ismbcupper` and `_ismbclower`; or a katakana letter: 0xA6<=`c`<=0xDF. | -| [`_ismbcdigit`, `_ismbcdigit_l`](./reference/ismbcalnum-functions.md) | Digit | Returns nonzero if and only if `c` is a single-byte representation of an ASCII digit: 0x30<=`c`<=0x39. | -| [`_ismbcgraph`, `_ismbcgraph_l`](./reference/ismbcgraph-functions.md) | Graphic | Returns nonzero if and only if `c` is a single-byte representation of any ASCII or katakana printable character except a white space ( ). See examples for `_ismbcdigit`, `_ismbcalpha`, and `_ismbcpunct`. | -| [`_ismbclegal`, `_ismbclegal_l`](./reference/ismbclegal-ismbclegal-l-ismbcsymbol-ismbcsymbol-l.md) | Valid multibyte character | Returns nonzero if and only if the first byte of `c` is within ranges 0x81 - 0x9F or 0xE0 - 0xFC, while the second byte is within ranges 0x40 - 0x7E or 0x80 - FC. | -| [`_ismbclower`, `_ismbclower_l`](./reference/ismbclower-ismbclower-l-ismbcupper-ismbcupper-l.md) | Lowercase alphabetic | Returns nonzero if and only if `c` is a single-byte representation of an ASCII lowercase English letter: 0x61<=`c`<=0x7A. | -| [`_ismbcprint`, `_ismbcprint_l`](./reference/ismbcgraph-functions.md) | Printable | Returns nonzero if and only if `c` is a single-byte representation of any ASCII or katakana printable character including a white space ( ): See examples for `_ismbcspace`, `_ismbcdigit`, `_ismbcalpha`, and `_ismbcpunct`. | -| [`_ismbcpunct`, `_ismbcpunct_l`](./reference/ismbcgraph-functions.md) | Punctuation | Returns nonzero if and only if `c` is a single-byte representation of any ASCII or katakana punctuation character. | -| [`_ismbcblank`, `_ismbcblank_l`](./reference/ismbcgraph-functions.md) | Space or horizontal tab | Returns nonzero if and only if `c` is a single-byte representation of a space character or a horizontal tab character: `c`=0x20 or `c`=0x09. | -| [`_ismbcspace`, `_ismbcspace_l`](./reference/ismbcgraph-functions.md) | Whitespace | Returns nonzero if and only if `c` is a white space character: `c`=0x20 or 0x09<=`c`<=0x0D. | -| [`_ismbcsymbol`, `_ismbcsymbol_l`](./reference/ismbclegal-ismbclegal-l-ismbcsymbol-ismbcsymbol-l.md) | Multibyte symbol | Returns nonzero if and only if 0x8141<=`c`<=0x81AC. | -| [`_ismbcupper`, `_ismbcupper_l`](./reference/ismbclower-ismbclower-l-ismbcupper-ismbcupper-l.md) | Uppercase alphabetic | Returns nonzero if and only if `c` is a single-byte representation of an ASCII uppercase English letter: 0x41<=`c`<=0x5A. | +| [`_ismbcalnum`, `_ismbcalnum_l`](reference/ismbcalnum-functions.md) | Alphanumeric | Returns nonzero if and only if `c` is a single-byte representation of an ASCII English letter: See examples for `_ismbcdigit` and `_ismbcalpha`. | +| [`_ismbcalpha`, `_ismbcalpha_l`](reference/ismbcalnum-functions.md) | Alphabetic | Returns nonzero if and only if `c` is a single-byte representation of an ASCII English letter: See examples for `_ismbcupper` and `_ismbclower`; or a katakana letter: 0xA6<=`c`<=0xDF. | +| [`_ismbcdigit`, `_ismbcdigit_l`](reference/ismbcalnum-functions.md) | Digit | Returns nonzero if and only if `c` is a single-byte representation of an ASCII digit: 0x30<=`c`<=0x39. | +| [`_ismbcgraph`, `_ismbcgraph_l`](reference/ismbcgraph-functions.md) | Graphic | Returns nonzero if and only if `c` is a single-byte representation of any ASCII or katakana printable character except a white space ( ). See examples for `_ismbcdigit`, `_ismbcalpha`, and `_ismbcpunct`. | +| [`_ismbclegal`, `_ismbclegal_l`](reference/ismbclegal-ismbclegal-l-ismbcsymbol-ismbcsymbol-l.md) | Valid multibyte character | Returns nonzero if and only if the first byte of `c` is within ranges 0x81 - 0x9F or 0xE0 - 0xFC, while the second byte is within ranges 0x40 - 0x7E or 0x80 - FC. | +| [`_ismbclower`, `_ismbclower_l`](reference/ismbclower-ismbclower-l-ismbcupper-ismbcupper-l.md) | Lowercase alphabetic | Returns nonzero if and only if `c` is a single-byte representation of an ASCII lowercase English letter: 0x61<=`c`<=0x7A. | +| [`_ismbcprint`, `_ismbcprint_l`](reference/ismbcgraph-functions.md) | Printable | Returns nonzero if and only if `c` is a single-byte representation of any ASCII or katakana printable character including a white space ( ): See examples for `_ismbcspace`, `_ismbcdigit`, `_ismbcalpha`, and `_ismbcpunct`. | +| [`_ismbcpunct`, `_ismbcpunct_l`](reference/ismbcgraph-functions.md) | Punctuation | Returns nonzero if and only if `c` is a single-byte representation of any ASCII or katakana punctuation character. | +| [`_ismbcblank`, `_ismbcblank_l`](reference/ismbcgraph-functions.md) | Space or horizontal tab | Returns nonzero if and only if `c` is a single-byte representation of a space character or a horizontal tab character: `c`=0x20 or `c`=0x09. | +| [`_ismbcspace`, `_ismbcspace_l`](reference/ismbcgraph-functions.md) | Whitespace | Returns nonzero if and only if `c` is a white space character: `c`=0x20 or 0x09<=`c`<=0x0D. | +| [`_ismbcsymbol`, `_ismbcsymbol_l`](reference/ismbclegal-ismbclegal-l-ismbcsymbol-ismbcsymbol-l.md) | Multibyte symbol | Returns nonzero if and only if 0x8141<=`c`<=0x81AC. | +| [`_ismbcupper`, `_ismbcupper_l`](reference/ismbclower-ismbclower-l-ismbcupper-ismbcupper-l.md) | Uppercase alphabetic | Returns nonzero if and only if `c` is a single-byte representation of an ASCII uppercase English letter: 0x41<=`c`<=0x5A. | **Code Page 932 Specific** @@ -43,18 +42,18 @@ The following routines are specific to code page 932. | Routine | Test condition (code page 932 only) | |---|---| -| [`_ismbchira`, `_ismbchira_l`](./reference/ismbchira-ismbchira-l-ismbckata-ismbckata-l.md) | Double-byte Hiragana: 0x829F<=`c`<=0x82F1. | -| [`_ismbckata`, `_ismbckata_l`](./reference/ismbchira-ismbchira-l-ismbckata-ismbckata-l.md) | Double-byte katakana: 0x8340<=`c`<=0x8396. | -| [`_ismbcl0`, `_ismbcl0_l`](./reference/ismbcl0-ismbcl0-l-ismbcl1-ismbcl1-l-ismbcl2-ismbcl2-l.md) | JIS non-Kanji: 0x8140<=`c`<=0x889E. | -| [`_ismbcl1`, `_ismbcl1_l`](./reference/ismbcl0-ismbcl0-l-ismbcl1-ismbcl1-l-ismbcl2-ismbcl2-l.md) | JIS level-1: 0x889F<=`c`<=0x9872. | -| [`_ismbcl2`, `_ismbcl2_l`](./reference/ismbcl0-ismbcl0-l-ismbcl1-ismbcl1-l-ismbcl2-ismbcl2-l.md) | JIS level-2: 0x989F<=`c`<=0xEA9E. | +| [`_ismbchira`, `_ismbchira_l`](reference/ismbchira-ismbchira-l-ismbckata-ismbckata-l.md) | Double-byte Hiragana: 0x829F<=`c`<=0x82F1. | +| [`_ismbckata`, `_ismbckata_l`](reference/ismbchira-ismbchira-l-ismbckata-ismbckata-l.md) | Double-byte katakana: 0x8340<=`c`<=0x8396. | +| [`_ismbcl0`, `_ismbcl0_l`](reference/ismbcl0-ismbcl0-l-ismbcl1-ismbcl1-l-ismbcl2-ismbcl2-l.md) | JIS non-Kanji: 0x8140<=`c`<=0x889E. | +| [`_ismbcl1`, `_ismbcl1_l`](reference/ismbcl0-ismbcl0-l-ismbcl1-ismbcl1-l-ismbcl2-ismbcl2-l.md) | JIS level-1: 0x889F<=`c`<=0x9872. | +| [`_ismbcl2`, `_ismbcl2_l`](reference/ismbcl0-ismbcl0-l-ismbcl1-ismbcl1-l-ismbcl2-ismbcl2-l.md) | JIS level-2: 0x989F<=`c`<=0xEA9E. | -`_ismbcl0`, `_ismbcl1`, and `_ismbcl2` check that the specified value `c` matches the test conditions described in the preceding table, but don't check that `c` is a valid multibyte character. If the lower byte is in the ranges 0x00 - 0x3F, 0x7F, or 0xFD - 0xFF, these functions return a nonzero value, indicating that the character satisfies the test condition. Use [`_ismbbtrail`, `_ismbbtrail_l`](./reference/ismbbtrail-ismbbtrail-l.md) to test whether the multibyte character is defined. +`_ismbcl0`, `_ismbcl1`, and `_ismbcl2` check that the specified value `c` matches the test conditions described in the preceding table, but don't check that `c` is a valid multibyte character. If the lower byte is in the ranges 0x00 - 0x3F, 0x7F, or 0xFD - 0xFF, these functions return a nonzero value, indicating that the character satisfies the test condition. Use [`_ismbbtrail`, `_ismbbtrail_l`](reference/ismbbtrail-ismbbtrail-l.md) to test whether the multibyte character is defined. **END Code Page 932 Specific** ## See also -[Character classification](./character-classification.md)\ -[`is`, `isw` routines](./is-isw-routines.md)\ -[`_ismbb` routines](./ismbb-routines.md) +[Character classification](character-classification.md)\ +[`is`, `isw` routines](is-isw-routines.md)\ +[`_ismbb` routines](ismbb-routines.md) diff --git a/docs/c-runtime-library/language-strings.md b/docs/c-runtime-library/language-strings.md index c68c721c29e..99b9af3a157 100644 --- a/docs/c-runtime-library/language-strings.md +++ b/docs/c-runtime-library/language-strings.md @@ -6,7 +6,7 @@ helpviewer_keywords: ["language strings"] --- # Language strings -The [`setlocale`](./reference/setlocale-wsetlocale.md) and [`_create_locale`](./reference/create-locale-wcreate-locale.md) functions can use the Windows NLS API supported languages on operating systems that don't use the Unicode code page. For a list of supported languages by operating system version, see [Appendix A: Product Behavior](/openspecs/windows_protocols/ms-lcid/a9eac961-e77d-41a6-90a5-ce1a8b0cdb9c) in \[MS-LCID]: Windows Language Code Identifier (LCID) Reference. The language string can be any of the values in the **Language** and **Language tag** columns of the list of supported languages. For example code that enumerates available locale names and related values, see [NLS: Name-based APIs Sample](/windows/win32/intl/nls--name-based-apis-sample). +The [`setlocale`](reference/setlocale-wsetlocale.md) and [`_create_locale`](reference/create-locale-wcreate-locale.md) functions can use the Windows NLS API supported languages on operating systems that don't use the Unicode code page. For a list of supported languages by operating system version, see [Appendix A: Product Behavior](/openspecs/windows_protocols/ms-lcid/a9eac961-e77d-41a6-90a5-ce1a8b0cdb9c) in \[MS-LCID]: Windows Language Code Identifier (LCID) Reference. The language string can be any of the values in the **Language** and **Language tag** columns of the list of supported languages. For example code that enumerates available locale names and related values, see [NLS: Name-based APIs Sample](/windows/win32/intl/nls--name-based-apis-sample). ## Supported language strings @@ -82,7 +82,7 @@ The Microsoft C run-time library implementation also supports these language str ## See also -- [Locale names, Languages, and Country/Region strings](./locale-names-languages-and-country-region-strings.md)\ -- [Country/Region strings](./country-region-strings.md)\ -- [`setlocale`, `_wsetlocale`](./reference/setlocale-wsetlocale.md)\ -- [`_create_locale`, `_wcreate_locale`](./reference/create-locale-wcreate-locale.md) +- [Locale names, Languages, and Country/Region strings](locale-names-languages-and-country-region-strings.md) +- [Country/Region strings](country-region-strings.md) +- [`setlocale`, `_wsetlocale`](reference/setlocale-wsetlocale.md) +- [`_create_locale`, `_wcreate_locale`](reference/create-locale-wcreate-locale.md) diff --git a/docs/c-runtime-library/link-options.md b/docs/c-runtime-library/link-options.md index 33a73b92deb..7f27f9a1784 100644 --- a/docs/c-runtime-library/link-options.md +++ b/docs/c-runtime-library/link-options.md @@ -1,27 +1,26 @@ --- -description: "Learn more about: Link Options" -title: "Link Options" +title: "Link options" +description: "Learn more about: Link options" ms.date: "11/04/2016" helpviewer_keywords: ["nothrownew.obj", "newmode.obj", "noenv.obj", "psetargv.obj", "legacy_stdio_float_rounding.obj", "loosefpmath.obj", "smallheap.obj", "fp10.obj", "nochkclr.obj", "chkstk.obj", "pcommode.obj", "pnoenv.obj", "link options [C++]", "invalidcontinue.obj", "pnothrownew.obj", "pwsetargv.obj", "pinvalidcontinue.obj", "wsetargv.obj", "binmode.obj", "setargv.obj", "noarg.obj", "pnewmode.obj", "commode.obj", "pthreadlocale.obj", "pbinmode.obj", "threadlocale.obj", "pnoarg.obj"] -ms.assetid: 05b5a77b-9dd1-494b-ae46-314598c770bb --- # Link options -The CRT lib directory includes several small object files that enable specific CRT features without any code change. These object files are called "link options" since you only have to add them to the linker command line to use them. +The CRT lib directory includes several small object files that enable specific CRT features without code changes. These object files are called "link options" because you only have to add them to the linker command line to use them. To do this from Visual Studio, in the Solution Explorer right-click your project and choose **Properties**. Under **Configuration Properties**, choose **Linker** > **Input** > **Additional Dependencies** and specify the additional items to add to the link command line. -CLR pure mode versions of these objects are deprecated in Visual Studio 2015 and unsupported in Visual Studio 2017. Use the regular versions for native and /clr code. +CLR pure mode versions of these objects are deprecated in Visual Studio 2015 and unsupported in Visual Studio 2017. Use the regular versions for native and [`/clr`](../build/reference/clr-common-language-runtime-compilation.md) code. | Native and /clr | Pure mode | Description | |---|---|---| -| `binmode.obj` | `pbinmode.obj` | Sets the default file-translation mode to binary. See [`_fmode`](./fmode.md). | +| `binmode.obj` | `pbinmode.obj` | Sets the default file-translation mode to binary. See [`_fmode`](fmode.md). | | `chkstk.obj` | n/a | Provides stack-checking and alloca support when not using the CRT. | -| `commode.obj` | `pcommode.obj` | Sets the global commit flag to "commit". See [`fopen`, `_wfopen`](./reference/fopen-wfopen.md) and [`fopen_s`, `_wfopen_s`](./reference/fopen-s-wfopen-s.md). | -| exe_initialize_mta.lib | n/a | Initializes the MTA apartment during EXE startup, which allows the use of COM objects in global smart pointers. Because this option leaks an MTA apartment reference during shutdown, don't use it for DLLs. Linking to this file is equivalent to including `combase.h` and defining `_EXE_INITIALIZE_MTA`. Using this link option adds [onecore.lib](/windows/win32/apiindex/windows-umbrella-libraries) to the default library list. If this effect is undesirable (such as using onecore_apiset.lib or other umbrella library), use [/NODEFAULTLIB](../build/reference/nodefaultlib-ignore-libraries.md) to override this behavior and provide an alternative. | -| `fp10.obj` | n/a | Changes the default precision control to 64 bits. See [Math and floating-point support](./floating-point-support.md). | +| `commode.obj` | `pcommode.obj` | Sets the global commit flag to "commit". See [`fopen`, `_wfopen`](reference/fopen-wfopen.md) and [`fopen_s`, `_wfopen_s`](reference/fopen-s-wfopen-s.md). | +| `exe_initialize_mta.lib` | n/a | Initializes the MTA apartment during EXE startup, which allows the use of COM objects in global smart pointers. Because this option leaks an MTA apartment reference during shutdown, don't use it for DLLs. Linking to this file is equivalent to including `combase.h` and defining `_EXE_INITIALIZE_MTA`. Using this link option adds [`onecore.lib`](/windows/win32/apiindex/windows-umbrella-libraries) to the default library list. If this effect is undesirable (such as using onecore_apiset.lib or other umbrella library), use [`/NODEFAULTLIB`](../build/reference/nodefaultlib-ignore-libraries.md) to override this behavior and provide an alternative. | +| `fp10.obj` | n/a | Changes the default precision control to 64 bits. See [Math and floating-point support](floating-point-support.md). | | `invalidcontinue.obj` | `pinvalidcontinue.obj` | Sets a default invalid parameter handler that does nothing, meaning that invalid parameters passed to CRT functions will just set errno and return an error result. | -| `legacy_stdio_float_rounding.obj` | n/a | The printing of floating-point values (for example, when using [`printf`](./reference/printf-printf-l-wprintf-wprintf-l.md)) with the Windows 10 19041 Universal C Runtime has been fixed. It now properly rounds exactly representable floating-point numbers, and respects the floating-point rounding requested by [`fesetround`](./reference/fegetround-fesetround2.md). This behavior update is available in Visual Studio 2019 version 16.2 and later. Legacy behavior is used in earlier versions of Visual Studio, or by providing this link option. | +| `legacy_stdio_float_rounding.obj` | n/a | The printing of floating-point values (for example, when using [`printf`](reference/printf-printf-l-wprintf-wprintf-l.md)) with the Windows 10 19041 Universal C Runtime has been fixed. It now properly rounds exactly representable floating-point numbers, and respects the floating-point rounding requested by [`fesetround`](reference/fegetround-fesetround2.md). This behavior update is available in Visual Studio 2019 version 16.2 and later. Legacy behavior is used in earlier versions of Visual Studio, or by providing this link option. | | `loosefpmath.obj` | n/a | Ensures that floating point code tolerates denormal values. | -| `newmode.obj` | `pnewmode.obj` | Causes [`malloc`](./reference/malloc.md) to call the new handler on failure. See [`_set_new_mode`](./reference/set-new-mode.md), [`_set_new_handler`](./reference/set-new-handler.md), [`calloc`](./reference/calloc.md), and [`realloc`](./reference/realloc.md). | +| `newmode.obj` | `pnewmode.obj` | Causes [`malloc`](reference/malloc.md) to call the new handler on failure. See [`_set_new_mode`](reference/set-new-mode.md), [`_set_new_handler`](reference/set-new-handler.md), [`calloc`](reference/calloc.md), and [`realloc`](reference/realloc.md). | | `noarg.obj` | `pnoarg.obj` | Disables all processing of argc and argv. | | `nochkclr.obj` | n/a | Does nothing. Remove from your project. | | `noenv.obj` | `pnoenv.obj` | Disables the creation of a cached environment for the CRT. | @@ -32,4 +31,4 @@ CLR pure mode versions of these objects are deprecated in Visual Studio 2015 and ## See also -- [C runtime (CRT) and C++ Standard Library (STL) `.lib` files](./crt-library-features.md) +- [C runtime (CRT) and C++ Standard Library (STL) `.lib` files](crt-library-features.md) diff --git a/docs/c-runtime-library/locale-names-languages-and-country-region-strings.md b/docs/c-runtime-library/locale-names-languages-and-country-region-strings.md index dd2fae03a49..ae687afb430 100644 --- a/docs/c-runtime-library/locale-names-languages-and-country-region-strings.md +++ b/docs/c-runtime-library/locale-names-languages-and-country-region-strings.md @@ -1,7 +1,7 @@ --- title: "Locale Names, Languages, and Country-Region Strings" description: "An overview of using Microsoft Universal CRT locale, language, and country and region strings." -ms.topic: "conceptual" +ms.topic: "concept-article" ms.date: "12/10/2018" helpviewer_keywords: ["country/region strings", "localization, locale", "locales", "setlocale function", "language strings"] ms.assetid: a0e5a0c5-5602-4da0-b65f-de3d6c8530a2 diff --git a/docs/c-runtime-library/locale.md b/docs/c-runtime-library/locale.md index f7ced3c3424..5801ca774ee 100644 --- a/docs/c-runtime-library/locale.md +++ b/docs/c-runtime-library/locale.md @@ -1,63 +1,63 @@ --- -description: "Learn more about: Locale" title: "Locale" -ms.date: "04/11/2018" +description: "Learn more about: Locale" +ms.date: 04/11/2018 f1_keywords: ["c.international"] helpviewer_keywords: ["localization, locale", "country/region information", "language information routines", "setlocale function", "locale routines"] --- # Locale -*Locale* refers to country/region and language settings that you can use to customize your program. Some locale-dependent categories include the display formats for dates and monetary values. For more information, see [Locale categories](./locale-categories.md). +*Locale* refers to country/region and language settings that you can use to customize your program. Some locale-dependent categories include the display formats for dates and monetary values. For more information, see [Locale categories](locale-categories.md). -Use the [`setlocale`](./reference/setlocale-wsetlocale.md) function to change or query some or all of the current program or thread locale information while using functions without the **`_l`** suffix. The functions with the **`_l`** suffix will use the locale parameter passed in for their locale information during the execution of that specific function only. To create a locale for use with a function with a **`_l`** suffix, use [`_create_locale`](./reference/create-locale-wcreate-locale.md). To free this locale, use [`_free_locale`](./reference/free-locale.md). To get the current locale, use [`_get_current_locale`](./reference/get-current-locale.md). +Use the [`setlocale`](reference/setlocale-wsetlocale.md) function to change or query some or all of the current program or thread locale information while using functions without the **`_l`** suffix. The functions with the **`_l`** suffix will use the locale parameter passed in for their locale information during the execution of that specific function only. To create a locale for use with a function with a **`_l`** suffix, use [`_create_locale`](reference/create-locale-wcreate-locale.md). To free this locale, use [`_free_locale`](reference/free-locale.md). To get the current locale, use [`_get_current_locale`](reference/get-current-locale.md). -Use [`_configthreadlocale`](./reference/configthreadlocale.md) to control whether each thread has its own locale, or all threads in a program share the same locale. For more information, see [Locales and code pages](../text/locales-and-code-pages.md). +Use [`_configthreadlocale`](reference/configthreadlocale.md) to control whether each thread has its own locale, or all threads in a program share the same locale. For more information, see [Locales and code pages](../text/locales-and-code-pages.md). -More secure versions of the functions in the following table are available, indicated by the **`_s`** ("secure") suffix. For more information, see [Security features in the CRT](./security-features-in-the-crt.md). +More secure versions of the functions in the following table are available, indicated by the **`_s`** ("secure") suffix. For more information, see [Security features in the CRT](security-features-in-the-crt.md). ## Locale-dependent routines | Routine | Use | **`setlocale`** category setting dependence | |---|---|---| -| [`atof`, `_atof_l`, `_wtof`, `_wtof_l`](./reference/atof-atof-l-wtof-wtof-l.md) | Convert character to floating-point value | `LC_NUMERIC` | -| [`atoi`, `_atoi_l`, `_wtoi`, `_wtoi_l`](./reference/atoi-atoi-l-wtoi-wtoi-l.md) | Convert character to integer value | `LC_NUMERIC` | -| [`_atoi64`, `_atoi64_l`, `_wtoi64`, `_wtoi64_l`](./reference/atoi64-atoi64-l-wtoi64-wtoi64-l.md) | Convert character to 64-bit integer value | `LC_NUMERIC` | -| [`atol`, `_atol_l`, `_wtol`, `_wtol_l`](./reference/atol-atol-l-wtol-wtol-l.md) | Convert character to long value | `LC_NUMERIC` | -| [`_atodbl`, `_atodbl_l`, `_atoldbl`, `_atoldbl_l`, `_atoflt`, `_atoflt_l`](./reference/atodbl-atodbl-l-atoldbl-atoldbl-l-atoflt-atoflt-l.md) | Convert character to double-long value | `LC_NUMERIC` | -| [`is`, `isw` routines](./is-isw-routines.md) | Test given integer for particular condition. | `LC_CTYPE` | -| [`isleadbyte`, `_isleadbyte_l`](./reference/isleadbyte-isleadbyte-l.md) | Test for lead byte | `LC_CTYPE` | -| [`localeconv`](./reference/localeconv.md) | Read appropriate values for formatting numeric quantities | `LC_MONETARY, LC_NUMERIC` | -| [`MB_CUR_MAX`](./mb-cur-max.md) | Maximum length in bytes of any multibyte character in current locale (macro defined in `STDLIB.H`) | `LC_CTYPE` | -| [`_mbccpy`, `_mbccpy_l`](./reference/mbccpy-mbccpy-l.md),[`_mbccpy_s`, `_mbccpy_s_l`](./reference/mbccpy-s-mbccpy-s-l.md) | Copy one multibyte character | `LC_CTYPE` | -| [`_mbclen`, `mblen`, `_mblen_l`](./reference/mbclen-mblen-mblen-l.md) | Validate and return number of bytes in multibyte character | `LC_CTYPE` | -| [`strlen`, `wcslen`, `_mbslen`, `_mbslen_l`, `_mbstrlen`, `_mbstrlen_l`](./reference/strlen-wcslen-mbslen-mbslen-l-mbstrlen-mbstrlen-l.md) | For multibyte-character strings: validate each character in string; return string length | `LC_CTYPE` | -| [`mbstowcs`, `_mbstowcs_l`](./reference/mbstowcs-mbstowcs-l.md),[`mbstowcs_s`, `_mbstowcs_s_l`](./reference/mbstowcs-s-mbstowcs-s-l.md) | Convert sequence of multibyte characters to corresponding sequence of wide characters | `LC_CTYPE` | -| [`mbtowc`, `_mbtowc_l`](./reference/mbtowc-mbtowc-l.md) | Convert multibyte character to corresponding wide character | `LC_CTYPE` | -| [`printf`](./reference/printf-printf-l-wprintf-wprintf-l.md) functions | Write formatted output | `LC_NUMERIC` (determines radix character output) | -| [`scanf`](./reference/scanf-scanf-l-wscanf-wscanf-l.md) functions | Read formatted input | `LC_NUMERIC` (determines radix character recognition) | -| [`setlocale`, `_wsetlocale`](./reference/setlocale-wsetlocale.md) | Select locale for program | Not applicable | -| [`strcoll`, `wcscoll`, `_mbscoll`, `_strcoll_l`, `_wcscoll_l`, `_mbscoll_l`](./reference/strcoll-wcscoll-mbscoll-strcoll-l-wcscoll-l-mbscoll-l.md) | Compare characters of two strings | `LC_COLLATE` | -| [`_stricmp`, `_wcsicmp`, `_mbsicmp`, `_stricmp_l`, `_wcsicmp_l`, `_mbsicmp_l`](./reference/stricmp-wcsicmp-mbsicmp-stricmp-l-wcsicmp-l-mbsicmp-l.md) | Compare two strings without regard to case | `LC_CTYPE` | -| [`_stricoll`, `_wcsicoll`, `_mbsicoll`, `_stricoll_l`, `_wcsicoll_l`, `_mbsicoll_l`](./reference/stricoll-wcsicoll-mbsicoll-stricoll-l-wcsicoll-l-mbsicoll-l.md) | Compare characters of two strings (case insensitive) | `LC_COLLATE` | -| [`_strncoll`, `_wcsncoll`, `_mbsncoll`, `_strncoll_l`, `_wcsncoll_l`, `_mbsncoll_l`](./reference/strncoll-wcsncoll-mbsncoll-strncoll-l-wcsncoll-l-mbsncoll-l.md) | Compare first **`n`** characters of two strings | `LC_COLLATE` | -| [`_strnicmp`, `_wcsnicmp`, `_mbsnicmp`, `_strnicmp_l`, `_wcsnicmp_l`, `_mbsnicmp_l`](./reference/strnicmp-wcsnicmp-mbsnicmp-strnicmp-l-wcsnicmp-l-mbsnicmp-l.md) | Compare characters of two strings without regard to case. | `LC_CTYPE` | -| [`_strnicoll`, `_wcsnicoll`, `_mbsnicoll`, `_strnicoll_l`, `_wcsnicoll_l`, `_mbsnicoll_l`](./reference/strnicoll-wcsnicoll-mbsnicoll-strnicoll-l-wcsnicoll-l-mbsnicoll-l.md) | Compare first **`n`** characters of two strings (case insensitive) | `LC_COLLATE` | -| [`strftime`, `wcsftime`, `_strftime_l`, `_wcsftime_l`](./reference/strftime-wcsftime-strftime-l-wcsftime-l.md) | Format date and time value according to supplied **`format`** argument | `LC_TIME` | -| [`_strlwr`, `_wcslwr`, `_mbslwr`, `_strlwr_l`, `_wcslwr_l`, `_mbslwr_l`](./reference/strlwr-wcslwr-mbslwr-strlwr-l-wcslwr-l-mbslwr-l.md),[`_strlwr_s`, `_strlwr_s_l`, `_mbslwr_s`, `_mbslwr_s_l`, `_wcslwr_s`, `_wcslwr_s_l`](./reference/strlwr-s-strlwr-s-l-mbslwr-s-mbslwr-s-l-wcslwr-s-wcslwr-s-l.md) | Convert, in place, each uppercase letter in given string to lowercase | `LC_CTYPE` | -| [`strtod`, `_strtod_l`, `wcstod`, `_wcstod_l`](./reference/strtod-strtod-l-wcstod-wcstod-l.md) | Convert character string to **`double`** value | `LC_NUMERIC` (determines radix character recognition) | -| [`strtol`, `wcstol`, `_strtol_l`, `_wcstol_l`](./reference/strtol-wcstol-strtol-l-wcstol-l.md) | Convert character string to **`long`** value | `LC_NUMERIC` (determines radix character recognition) | -| [`strtoul`, `_strtoul_l`, `wcstoul`, `_wcstoul_l`](./reference/strtoul-strtoul-l-wcstoul-wcstoul-l.md) | Convert character string to unsigned long value | `LC_NUMERIC` (determines radix character recognition) | -| [`_strupr`, `_strupr_l`, `_mbsupr`, `_mbsupr_l`, `_wcsupr_l`, `_wcsupr`](./reference/strupr-strupr-l-mbsupr-mbsupr-l-wcsupr-l-wcsupr.md),[`_strupr_s`, `_strupr_s_l`, `_mbsupr_s`, `_mbsupr_s_l`, `_wcsupr_s`, `_wcsupr_s_l`](./reference/strupr-s-strupr-s-l-mbsupr-s-mbsupr-s-l-wcsupr-s-wcsupr-s-l.md) | Convert, in place, each lowercase letter in string to uppercase | `LC_CTYPE` | -| [`strxfrm`, `wcsxfrm`, `_strxfrm_l`, `_wcsxfrm_l`](./reference/strxfrm-wcsxfrm-strxfrm-l-wcsxfrm-l.md) | Transform string into collated form according to locale | `LC_COLLATE` | -| [`tolower`, `_tolower`, `towlower`, `_tolower_l`, `_towlower_l`](./reference/tolower-tolower-towlower-tolower-l-towlower-l.md),[`_mbctolower`, `_mbctolower_l`, `_mbctoupper`, `_mbctoupper_l`](./reference/mbctolower-mbctolower-l-mbctoupper-mbctoupper-l.md) | Convert given character to corresponding lowercase character | `LC_CTYPE` | -| [`toupper`, `_toupper`, `towupper`, `_toupper_l`, `_towupper_l`](./reference/toupper-toupper-towupper-toupper-l-towupper-l.md),[`_mbctolower`, `_mbctolower_l`, `_mbctoupper`, `_mbctoupper_l`](./reference/mbctolower-mbctolower-l-mbctoupper-mbctoupper-l.md) | Convert given character to corresponding uppercase letter | `LC_CTYPE` | -| [`wcstombs`, `_wcstombs_l`](./reference/wcstombs-wcstombs-l.md),[`wcstombs_s`, `_wcstombs_s_l`](./reference/wcstombs-s-wcstombs-s-l.md) | Convert sequence of wide characters to corresponding sequence of multibyte characters | `LC_CTYPE` | -| [`wctomb`, `_wctomb_l`](./reference/wctomb-wctomb-l.md),[`wctomb_s`, `_wctomb_s_l`](./reference/wctomb-s-wctomb-s-l.md) | Convert wide character to corresponding multibyte character | `LC_CTYPE` | +| [`atof`, `_atof_l`, `_wtof`, `_wtof_l`](reference/atof-atof-l-wtof-wtof-l.md) | Convert character to floating-point value | `LC_NUMERIC` | +| [`atoi`, `_atoi_l`, `_wtoi`, `_wtoi_l`](reference/atoi-atoi-l-wtoi-wtoi-l.md) | Convert character to integer value | `LC_NUMERIC` | +| [`_atoi64`, `_atoi64_l`, `_wtoi64`, `_wtoi64_l`](reference/atoi64-atoi64-l-wtoi64-wtoi64-l.md) | Convert character to 64-bit integer value | `LC_NUMERIC` | +| [`atol`, `_atol_l`, `_wtol`, `_wtol_l`](reference/atol-atol-l-wtol-wtol-l.md) | Convert character to long value | `LC_NUMERIC` | +| [`_atodbl`, `_atodbl_l`, `_atoldbl`, `_atoldbl_l`, `_atoflt`, `_atoflt_l`](reference/atodbl-atodbl-l-atoldbl-atoldbl-l-atoflt-atoflt-l.md) | Convert character to double-long value | `LC_NUMERIC` | +| [`is`, `isw` routines](is-isw-routines.md) | Test given integer for particular condition. | `LC_CTYPE` | +| [`isleadbyte`, `_isleadbyte_l`](reference/isleadbyte-isleadbyte-l.md) | Test for lead byte | `LC_CTYPE` | +| [`localeconv`](reference/localeconv.md) | Read appropriate values for formatting numeric quantities | `LC_MONETARY, LC_NUMERIC` | +| [`MB_CUR_MAX`](mb-cur-max.md) | Maximum length in bytes of any multibyte character in current locale (macro defined in `STDLIB.H`) | `LC_CTYPE` | +| [`_mbccpy`, `_mbccpy_l`](reference/mbccpy-mbccpy-l.md), [`_mbccpy_s`, `_mbccpy_s_l`](reference/mbccpy-s-mbccpy-s-l.md) | Copy one multibyte character | `LC_CTYPE` | +| [`_mbclen`, `mblen`, `_mblen_l`](reference/mbclen-mblen-mblen-l.md) | Validate and return number of bytes in multibyte character | `LC_CTYPE` | +| [`strlen`, `wcslen`, `_mbslen`, `_mbslen_l`, `_mbstrlen`, `_mbstrlen_l`](reference/strlen-wcslen-mbslen-mbslen-l-mbstrlen-mbstrlen-l.md) | For multibyte-character strings: validate each character in string; return string length | `LC_CTYPE` | +| [`mbstowcs`, `_mbstowcs_l`](reference/mbstowcs-mbstowcs-l.md), [`mbstowcs_s`, `_mbstowcs_s_l`](reference/mbstowcs-s-mbstowcs-s-l.md) | Convert sequence of multibyte characters to corresponding sequence of wide characters | `LC_CTYPE` | +| [`mbtowc`, `_mbtowc_l`](reference/mbtowc-mbtowc-l.md) | Convert multibyte character to corresponding wide character | `LC_CTYPE` | +| [`printf`](reference/printf-printf-l-wprintf-wprintf-l.md) functions | Write formatted output | `LC_NUMERIC` (determines radix character output) | +| [`scanf`](reference/scanf-scanf-l-wscanf-wscanf-l.md) functions | Read formatted input | `LC_NUMERIC` (determines radix character recognition) | +| [`setlocale`, `_wsetlocale`](reference/setlocale-wsetlocale.md) | Select locale for program | Not applicable | +| [`strcoll`, `wcscoll`, `_mbscoll`, `_strcoll_l`, `_wcscoll_l`, `_mbscoll_l`](reference/strcoll-wcscoll-mbscoll-strcoll-l-wcscoll-l-mbscoll-l.md) | Compare characters of two strings | `LC_COLLATE` | +| [`_stricmp`, `_wcsicmp`, `_mbsicmp`, `_stricmp_l`, `_wcsicmp_l`, `_mbsicmp_l`](reference/stricmp-wcsicmp-mbsicmp-stricmp-l-wcsicmp-l-mbsicmp-l.md) | Compare two strings without regard to case | `LC_CTYPE` | +| [`_stricoll`, `_wcsicoll`, `_mbsicoll`, `_stricoll_l`, `_wcsicoll_l`, `_mbsicoll_l`](reference/stricoll-wcsicoll-mbsicoll-stricoll-l-wcsicoll-l-mbsicoll-l.md) | Compare characters of two strings (case insensitive) | `LC_COLLATE` | +| [`_strncoll`, `_wcsncoll`, `_mbsncoll`, `_strncoll_l`, `_wcsncoll_l`, `_mbsncoll_l`](reference/strncoll-wcsncoll-mbsncoll-strncoll-l-wcsncoll-l-mbsncoll-l.md) | Compare first **`n`** characters of two strings | `LC_COLLATE` | +| [`_strnicmp`, `_wcsnicmp`, `_mbsnicmp`, `_strnicmp_l`, `_wcsnicmp_l`, `_mbsnicmp_l`](reference/strnicmp-wcsnicmp-mbsnicmp-strnicmp-l-wcsnicmp-l-mbsnicmp-l.md) | Compare characters of two strings without regard to case. | `LC_CTYPE` | +| [`_strnicoll`, `_wcsnicoll`, `_mbsnicoll`, `_strnicoll_l`, `_wcsnicoll_l`, `_mbsnicoll_l`](reference/strnicoll-wcsnicoll-mbsnicoll-strnicoll-l-wcsnicoll-l-mbsnicoll-l.md) | Compare first **`n`** characters of two strings (case insensitive) | `LC_COLLATE` | +| [`strftime`, `wcsftime`, `_strftime_l`, `_wcsftime_l`](reference/strftime-wcsftime-strftime-l-wcsftime-l.md) | Format date and time value according to supplied **`format`** argument | `LC_TIME` | +| [`_strlwr`, `_wcslwr`, `_mbslwr`, `_strlwr_l`, `_wcslwr_l`, `_mbslwr_l`](reference/strlwr-wcslwr-mbslwr-strlwr-l-wcslwr-l-mbslwr-l.md), [`_strlwr_s`, `_strlwr_s_l`, `_mbslwr_s`, `_mbslwr_s_l`, `_wcslwr_s`, `_wcslwr_s_l`](reference/strlwr-s-strlwr-s-l-mbslwr-s-mbslwr-s-l-wcslwr-s-wcslwr-s-l.md) | Convert, in place, each uppercase letter in given string to lowercase | `LC_CTYPE` | +| [`strtod`, `_strtod_l`, `wcstod`, `_wcstod_l`](reference/strtod-strtod-l-wcstod-wcstod-l.md) | Convert character string to **`double`** value | `LC_NUMERIC` (determines radix character recognition) | +| [`strtol`, `wcstol`, `_strtol_l`, `_wcstol_l`](reference/strtol-wcstol-strtol-l-wcstol-l.md) | Convert character string to **`long`** value | `LC_NUMERIC` (determines radix character recognition) | +| [`strtoul`, `_strtoul_l`, `wcstoul`, `_wcstoul_l`](reference/strtoul-strtoul-l-wcstoul-wcstoul-l.md) | Convert character string to unsigned long value | `LC_NUMERIC` (determines radix character recognition) | +| [`_strupr`, `_strupr_l`, `_mbsupr`, `_mbsupr_l`, `_wcsupr_l`, `_wcsupr`](reference/strupr-strupr-l-mbsupr-mbsupr-l-wcsupr-l-wcsupr.md), [`_strupr_s`, `_strupr_s_l`, `_mbsupr_s`, `_mbsupr_s_l`, `_wcsupr_s`, `_wcsupr_s_l`](reference/strupr-s-strupr-s-l-mbsupr-s-mbsupr-s-l-wcsupr-s-wcsupr-s-l.md) | Convert, in place, each lowercase letter in string to uppercase | `LC_CTYPE` | +| [`strxfrm`, `wcsxfrm`, `_strxfrm_l`, `_wcsxfrm_l`](reference/strxfrm-wcsxfrm-strxfrm-l-wcsxfrm-l.md) | Transform string into collated form according to locale | `LC_COLLATE` | +| [`tolower`, `_tolower`, `towlower`, `_tolower_l`, `_towlower_l`](reference/tolower-tolower-towlower-tolower-l-towlower-l.md), [`_mbctolower`, `_mbctolower_l`, `_mbctoupper`, `_mbctoupper_l`](reference/mbctolower-mbctolower-l-mbctoupper-mbctoupper-l.md) | Convert given character to corresponding lowercase character | `LC_CTYPE` | +| [`toupper`, `_toupper`, `towupper`, `_toupper_l`, `_towupper_l`](reference/toupper-toupper-towupper-toupper-l-towupper-l.md), [`_mbctolower`, `_mbctolower_l`, `_mbctoupper`, `_mbctoupper_l`](reference/mbctolower-mbctolower-l-mbctoupper-mbctoupper-l.md) | Convert given character to corresponding uppercase letter | `LC_CTYPE` | +| [`wcstombs`, `_wcstombs_l`](reference/wcstombs-wcstombs-l.md), [`wcstombs_s`, `_wcstombs_s_l`](reference/wcstombs-s-wcstombs-s-l.md) | Convert sequence of wide characters to corresponding sequence of multibyte characters | `LC_CTYPE` | +| [`wctomb`, `_wctomb_l`](reference/wctomb-wctomb-l.md), [`wctomb_s`, `_wctomb_s_l`](reference/wctomb-s-wctomb-s-l.md) | Convert wide character to corresponding multibyte character | `LC_CTYPE` | > [!NOTE] -> For multibyte routines, the multibyte code page must be equivalent to the locale set with [`setlocale`](./reference/setlocale-wsetlocale.md). [`_setmbcp`](./reference/setmbcp.md), with an argument of `_MB_CP_LOCALE` makes the multibyte code page the same as the **`setlocale`** code page. +> For multibyte routines, the multibyte code page must be equivalent to the locale set with [`setlocale`](reference/setlocale-wsetlocale.md). [`_setmbcp`](reference/setmbcp.md), with an argument of `_MB_CP_LOCALE` makes the multibyte code page the same as the **`setlocale`** code page. ## See also -[Internationalization](./internationalization.md)\ -[Universal C runtime routines by category](./run-time-routines-by-category.md) +[Internationalization](internationalization.md)\ +[Universal C runtime routines by category](run-time-routines-by-category.md) diff --git a/docs/c-runtime-library/lock.md b/docs/c-runtime-library/lock.md index e9f4e94fa0f..19562f13ef8 100644 --- a/docs/c-runtime-library/lock.md +++ b/docs/c-runtime-library/lock.md @@ -1,14 +1,13 @@ --- -description: "Learn more about: _lock" title: "_lock" -ms.date: "11/04/2016" +description: "Learn more about: _lock" +ms.date: 11/04/2016 api_name: ["_lock"] api_location: ["msvcr110_clr0400.dll", "msvcr120.dll", "msvcr100.dll", "msvcr90.dll", "msvcr80.dll", "msvcr110.dll", "msvcrt.dll", "msvcr120_clr0400.dll"] api_type: ["DLLExport"] topic_type: ["apiref"] f1_keywords: ["_lock"] helpviewer_keywords: ["lock function", "_lock function"] -ms.assetid: 29f77c37-30de-4b3d-91b6-030216e645a6 --- # `_lock` @@ -20,7 +19,7 @@ Acquires a multi-thread lock. ## Syntax ```cpp -void __cdecl _lock +void __cdecl _lock( int locknum ); ``` diff --git a/docs/c-runtime-library/multithreaded-libraries-performance.md b/docs/c-runtime-library/multithreaded-libraries-performance.md index 12d78d352fe..d1f3cc03464 100644 --- a/docs/c-runtime-library/multithreaded-libraries-performance.md +++ b/docs/c-runtime-library/multithreaded-libraries-performance.md @@ -2,7 +2,7 @@ title: "Multithreaded Libraries Performance" description: "An overview of how to get the most performance from the Microsoft C runtime multithreaded libraries." ms.date: "11/04/2016" -ms.topic: "conceptual" +ms.topic: "concept-article" helpviewer_keywords: ["threading [C++], performance", "libraries, multithreaded", "performance, multithreading", "multithreaded libraries"] ms.assetid: faa5d808-087c-463d-8f0d-8c478d137296 --- diff --git a/docs/c-runtime-library/parameter-validation.md b/docs/c-runtime-library/parameter-validation.md index a2d188ec7ed..c16c5b84dd5 100644 --- a/docs/c-runtime-library/parameter-validation.md +++ b/docs/c-runtime-library/parameter-validation.md @@ -1,14 +1,13 @@ --- title: "Parameter Validation" description: "A description of parameter validation in the Microsoft C runtime library." -ms.date: "11/04/2016" -ms.topic: "conceptual" +ms.date: 11/04/2016 +ms.topic: "concept-article" helpviewer_keywords: ["parameters, validation"] -ms.assetid: 019dd5f0-dc61-4d2e-b4e9-b66409ddf1f2 --- # Parameter validation -Most of the security-enhanced CRT functions, and many that aren't, validate their parameters for things like checking pointers for `NULL`, that integers fall into a valid range, or that enumeration values are valid. If an invalid parameter is found, the invalid parameter handler is called. +Most of the security-enhanced CRT functions, and many that aren't, validate their parameters for things like checking pointers for `NULL`, that integers fall into a valid range, or that enumeration values are valid. If an invalid parameter is found, the invalid parameter handler is called. ## Invalid parameter handler routine diff --git a/docs/c-runtime-library/potential-errors-passing-crt-objects-across-dll-boundaries.md b/docs/c-runtime-library/potential-errors-passing-crt-objects-across-dll-boundaries.md index 9aac11ab8d6..6dc1fb53c42 100644 --- a/docs/c-runtime-library/potential-errors-passing-crt-objects-across-dll-boundaries.md +++ b/docs/c-runtime-library/potential-errors-passing-crt-objects-across-dll-boundaries.md @@ -2,7 +2,7 @@ title: "Potential Errors Passing CRT Objects Across DLL Boundaries" description: "An overview of potential problems you may come across when passing Microsoft C runtime objects across a dynamic link library (DLL) boundary." ms.date: 06/29/2022 -ms.topic: "conceptual" +ms.topic: "concept-article" helpviewer_keywords: ["DLL conflicts [C++]"] ms.assetid: c217ffd2-5d9a-4678-a1df-62a637a96460 --- diff --git a/docs/c-runtime-library/recommendations-for-choosing-between-functions-and-macros.md b/docs/c-runtime-library/recommendations-for-choosing-between-functions-and-macros.md index 1971598d3b1..57ed7d86d04 100644 --- a/docs/c-runtime-library/recommendations-for-choosing-between-functions-and-macros.md +++ b/docs/c-runtime-library/recommendations-for-choosing-between-functions-and-macros.md @@ -2,7 +2,7 @@ title: "Recommendations for Choosing Between Functions and Macros" description: "Explains the differences between using macros vs functions in the Microsoft C runtime library (CRT)" ms.date: "11/04/2016" -ms.topic: "conceptual" +ms.topic: "concept-article" f1_keywords: ["c.functions"] helpviewer_keywords: ["functions [CRT], vs. macros", "macros, vs. functions"] ms.assetid: 18a633d6-cf1c-470c-a649-fa7677473e2b diff --git a/docs/c-runtime-library/reference/abort.md b/docs/c-runtime-library/reference/abort.md index 991f4640497..436a39de910 100644 --- a/docs/c-runtime-library/reference/abort.md +++ b/docs/c-runtime-library/reference/abort.md @@ -1,6 +1,6 @@ --- -description: "Learn more about: abort" title: "abort" +description: "Learn more about: abort" ms.date: 07/07/2022 api_name: ["abort", "_o_abort"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll", "api-ms-win-crt-runtime-l1-1-0.dll"] @@ -14,7 +14,7 @@ helpviewer_keywords: ["aborting current process", "abort function", "processes, Aborts the current process and returns an error code. > [!NOTE] -> Do not use this method to shut down a Microsoft Store app or Universal Windows Platform (UWP) app, except in testing or debugging scenarios. Programmatic or UI ways to close a Store app are not permitted according to the [Microsoft Store policies](/legal/windows/agreements/store-policies). For more information, see [UWP app lifecycle](/windows/uwp/launch-resume/app-lifecycle). +> Do not use this method to shut down a Microsoft Store app or Universal Windows Platform (UWP) app, except in testing or debugging scenarios. Programmatic or UI ways to close a Store app are not permitted according to the [Microsoft Store policies](/windows/apps/publish/store-policies). For more information, see [UWP app lifecycle](/windows/uwp/launch-resume/app-lifecycle). ## Syntax @@ -71,8 +71,8 @@ The following program tries to open a file and aborts if the attempt fails. // the abort function by attempting to open a file // and aborts if the attempt fails. -#include -#include +#include +#include int main( void ) { diff --git a/docs/c-runtime-library/reference/access-waccess.md b/docs/c-runtime-library/reference/access-waccess.md index 87fadbc2ba6..87cf212ca0b 100644 --- a/docs/c-runtime-library/reference/access-waccess.md +++ b/docs/c-runtime-library/reference/access-waccess.md @@ -1,6 +1,6 @@ --- -description: "Learn more about: _access, _waccess" title: "_access, _waccess" +description: "Learn more about: _access, _waccess" ms.date: "4/2/2020" api_name: ["_access", "_waccess", "t_access", "_o__access", "_o__waccess"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll", "api-ms-win-crt-filesystem-l1-1-0.dll"] @@ -90,9 +90,9 @@ The following example uses **`_access`** to check the file named *`crt_ACCESS.C` // This example uses _access to check the file named // crt_ACCESS.C to see if it exists and if writing is allowed. -#include -#include -#include +#include +#include +#include int main( void ) { diff --git a/docs/c-runtime-library/reference/acos-acosf-acosl.md b/docs/c-runtime-library/reference/acos-acosf-acosl.md index 5296418f6b5..b570c16c00b 100644 --- a/docs/c-runtime-library/reference/acos-acosf-acosl.md +++ b/docs/c-runtime-library/reference/acos-acosf-acosl.md @@ -1,7 +1,7 @@ --- title: "acos, acosf, acosl" description: "API reference for acos, acosf, and acosl; which calculate the arccosine of a floating-point value." -ms.date: "1/15/2021" +ms.date: 1/15/2021 api_name: ["acosf", "acos", "acosl", "_o_acos", "_o_acosf"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll", "api-ms-win-crt-math-l1-1-0.dll"] api_type: ["DLLExport"] @@ -19,7 +19,7 @@ Calculates the arccosine. double acos( double x ); float acosf( float x ); long double acosl( long double x ); -#define acos(X) // Requires C11 or higher +#define acos(X) // Requires C11 or later float acos( float x ); // C++ only long double acos( long double x ); // C++ only diff --git a/docs/c-runtime-library/reference/acosh-acoshf-acoshl.md b/docs/c-runtime-library/reference/acosh-acoshf-acoshl.md index eae18abea8c..18d9c23aa14 100644 --- a/docs/c-runtime-library/reference/acosh-acoshf-acoshl.md +++ b/docs/c-runtime-library/reference/acosh-acoshf-acoshl.md @@ -1,14 +1,13 @@ --- title: "acosh, acoshf, acoshl" description: "API reference for acosh, acoshf, and acoshl; which calculate the inverse hyperbolic cosine of a floating-point value." -ms.date: "08/31/2020" +ms.date: 08/31/2020 api_name: ["acoshf", "acosh", "acoshl", "_o_acosh", "_o_acoshf", "_o_acoshl"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll", "api-ms-win-crt-math-l1-1-0.dll"] api_type: ["DLLExport"] topic_type: ["apiref"] f1_keywords: ["acosh", "acoshf", "acoshl", "math/acosh", "math/acoshf", "math/acoshl"] helpviewer_keywords: ["acoshf function", "acosh function", "acoshl function"] -ms.assetid: 6985c4d7-9e2a-44ce-9a9b-5a43015f15f7 --- # `acosh`, `acoshf`, `acoshl` @@ -20,7 +19,7 @@ Calculates the inverse hyperbolic cosine. double acosh( double x ); float acoshf( float x ); long double acoshl( long double x ); -#define acosh(X) // Requires C11 or higher +#define acosh(X) // Requires C11 or later float acosh( float x ); // C++ only long double acosh( long double x ); // C++ only diff --git a/docs/c-runtime-library/reference/alloca.md b/docs/c-runtime-library/reference/alloca.md index 693bcebda9f..7c78844e4d9 100644 --- a/docs/c-runtime-library/reference/alloca.md +++ b/docs/c-runtime-library/reference/alloca.md @@ -1,6 +1,6 @@ --- -description: "Learn more about: _alloca" title: "_alloca" +description: "Learn more about: _alloca" ms.date: 01/05/2022 api_name: ["_alloca"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll"] @@ -49,7 +49,7 @@ However, **`_alloca`** can be called directly from within an EH routine or from > [!IMPORTANT] > If **`_alloca`** is called inside a try block, you must call [`_resetstkoflw`](resetstkoflw.md) in the catch block. -In addition to the above restrictions, when using the[`/clr` (Common Language Runtime Compilation)](../../build/reference/clr-common-language-runtime-compilation.md) option, **`_alloca`** can't be used in **`__except`** blocks. For more information, see [`/clr` Restrictions](../../build/reference/clr-restrictions.md). +In addition to the above restrictions, when using the [`/clr` (Common Language Runtime Compilation)](../../build/reference/clr-common-language-runtime-compilation.md) option, **`_alloca`** can't be used in **`__except`** blocks. For more information, see [`/clr` Restrictions](../../build/reference/clr-restrictions.md). ## Requirements diff --git a/docs/c-runtime-library/reference/and.md b/docs/c-runtime-library/reference/and.md index 2a5a4412c11..efa2cca2861 100644 --- a/docs/c-runtime-library/reference/and.md +++ b/docs/c-runtime-library/reference/and.md @@ -1,13 +1,12 @@ --- -description: "Learn more about: and" title: "and" +description: "Learn more about: and" ms.date: "11/04/2016" api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll"] api_type: ["DLLExport"] topic_type: ["apiref"] f1_keywords: ["ISO646/and", "and", "std.and", "std::and"] helpviewer_keywords: ["and macro"] -ms.assetid: 2644ab57-8e1b-48f0-9021-cafe3e26bdc4 --- # `and` @@ -16,7 +15,6 @@ An alternative to the && operator. ## Syntax ```C - #define and && ``` diff --git a/docs/c-runtime-library/reference/asctime-s-wasctime-s.md b/docs/c-runtime-library/reference/asctime-s-wasctime-s.md index c7762a0c8f0..99d3ffe89b3 100644 --- a/docs/c-runtime-library/reference/asctime-s-wasctime-s.md +++ b/docs/c-runtime-library/reference/asctime-s-wasctime-s.md @@ -1,14 +1,13 @@ --- -description: "Learn more about: asctime_s, _wasctime_s" title: "asctime_s, _wasctime_s" -ms.date: "4/2/2020" +description: "Learn more about: asctime_s, _wasctime_s" +ms.date: 4/2/2020 api_name: ["_wasctime_s", "asctime_s", "_o__wasctime_s", "_o_asctime_s"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll", "api-ms-win-crt-time-l1-1-0.dll"] api_type: ["DLLExport"] topic_type: ["apiref"] f1_keywords: ["asctime_s", "_wasctime_s", "_tasctime_s"] helpviewer_keywords: ["tasctime_s function", "_tasctime_s function", "time structure conversion", "wasctime_s function", "time, converting", "_wasctime_s function", "asctime_s function"] -ms.assetid: 17ad9b2b-a459-465d-976a-42822897688a --- # `asctime_s`, `_wasctime_s` @@ -24,7 +23,7 @@ errno_t asctime_s( ); errno_t _wasctime_s( wchar_t* buffer, - size_t numberOfElements + size_t numberOfElements, const struct tm *tmSource ); template diff --git a/docs/c-runtime-library/reference/asin-asinf-asinl.md b/docs/c-runtime-library/reference/asin-asinf-asinl.md index 9fbe4cda49c..0e7495e47af 100644 --- a/docs/c-runtime-library/reference/asin-asinf-asinl.md +++ b/docs/c-runtime-library/reference/asin-asinf-asinl.md @@ -1,7 +1,7 @@ --- title: "asin, asinf, asinl" description: "API reference for asin, asinf, and asinl; which calculate the arcsine of a floating-point value." -ms.date: "1/15/2021" +ms.date: 1/15/2021 api_name: ["asinf", "asinl", "asin", "_o_asin", "_o_asinf"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll", "api-ms-win-crt-math-l1-1-0.dll"] api_type: ["DLLExport"] @@ -19,7 +19,7 @@ Calculates the arcsine. double asin( double x ); float asinf ( float x ); long double asinl( long double x ); -#define asin(X) // Requires C11 or higher +#define asin(X) // Requires C11 or later float asin( float x ); // C++ only long double asin( long double x ); // C++ only diff --git a/docs/c-runtime-library/reference/asinh-asinhf-asinhl.md b/docs/c-runtime-library/reference/asinh-asinhf-asinhl.md index 1c9480aac2d..8501e27ac0f 100644 --- a/docs/c-runtime-library/reference/asinh-asinhf-asinhl.md +++ b/docs/c-runtime-library/reference/asinh-asinhf-asinhl.md @@ -1,14 +1,13 @@ --- title: "asinh, asinhf, asinhl" description: "API reference for asinh, asinhf, and asinhl; which calculate the inverse hyperbolic sine of a floating-point value." -ms.date: "08/31/2020" +ms.date: 08/31/2020 api_name: ["asinh", "asinhf", "asinhl", "_o_asinh", "_o_asinhf", "_o_asinhl"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll", "api-ms-win-crt-math-l1-1-0.dll"] api_type: ["DLLExport"] topic_type: ["apiref"] f1_keywords: ["asinhf", "asinhl", "asinh"] helpviewer_keywords: ["asinh function", "asinhl function", "asinhf function"] -ms.assetid: 4488babe-1a7e-44ca-8b7b-c2db0a70084f --- # `asinh`, `asinhf`, `asinhl` @@ -20,7 +19,7 @@ Calculates the inverse hyperbolic sine. double asinh( double x ); float asinhf( float x ); long double asinhl( long double x ); -#define asinh(X) // Requires C11 or higher +#define asinh(X) // Requires C11 or later float asinh( float x ); // C++ only long double asinh( long double x ); // C++ only diff --git a/docs/c-runtime-library/reference/assert-asserte-assert-expr-macros.md b/docs/c-runtime-library/reference/assert-asserte-assert-expr-macros.md index d2d73958108..b728bbd517c 100644 --- a/docs/c-runtime-library/reference/assert-asserte-assert-expr-macros.md +++ b/docs/c-runtime-library/reference/assert-asserte-assert-expr-macros.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: _ASSERT, _ASSERTE, _ASSERT_EXPR Macros" title: "_ASSERT, _ASSERTE, _ASSERT_EXPR Macros" -ms.date: "11/04/2016" +description: "Learn more about: _ASSERT, _ASSERTE, _ASSERT_EXPR Macros" +ms.date: 11/04/2016 api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll"] api_type: ["DLLExport"] topic_type: ["apiref"] @@ -33,7 +33,7 @@ A wide string to display as part of the report. The `_ASSERT_EXPR`, `_ASSERT` and `_ASSERTE` macros provide an application with a clean and simple mechanism for checking assumptions during the debugging process. They're flexible because they don't need to be enclosed in `#ifdef` statements to prevent them from being called in a retail build of an application. This flexibility is achieved by using the [`_DEBUG`](../debug.md) macro. `_ASSERT_EXPR`, `_ASSERT` and `_ASSERTE` are only available when `_DEBUG` is defined at compile time. When `_DEBUG` isn't defined, calls to these macros are removed during preprocessing. -`_ASSERT_EXPR`, `_ASSERT` and `_ASSERTE` evaluate their *`booleanExpression`* argument and when the result is **`false`** (0), they print a diagnostic message and call [`_CrtDbgReportW`](crtdbgreport-crtdbgreportw.md) to generate a debug report. The `_ASSERT` macro prints a simple diagnostic message, `_ASSERTE` includes a string representation of the failed expression in the message, and `_ASSERT_EXPR` includes the *`message`* string in the diagnostic message. These macros do nothing when *`booleanExpression`* evaluates to nonzero. +`_ASSERT_EXPR`, `_ASSERT` and `_ASSERTE` evaluate their *`booleanExpression`* argument and when the result is **`false`** (0), they print a diagnostic message and call [`_CrtDbgReportW`](crtdbgreport-crtdbgreportw.md) to generate a debug report. The `_ASSERT` macro prints a simple diagnostic message, `_ASSERTE` includes a string representation of the failed expression in the message, and `_ASSERT_EXPR` includes the *`message`* string in the diagnostic message. These macros do nothing when *`booleanExpression`* evaluates to nonzero. `_ASSERT_EXPR`, `_ASSERT` and `_ASSERTE` invoke `_CrtDbgReportW`, which causes all output to be in wide characters. `_ASSERTE` properly prints Unicode characters in *`booleanExpression`* and `_ASSERT_EXPR` prints Unicode characters in *`message`*. diff --git a/docs/c-runtime-library/reference/atan-atanf-atanl-atan2-atan2f-atan2l.md b/docs/c-runtime-library/reference/atan-atanf-atanl-atan2-atan2f-atan2l.md index 12dab5d0475..91fc052f9a7 100644 --- a/docs/c-runtime-library/reference/atan-atanf-atanl-atan2-atan2f-atan2l.md +++ b/docs/c-runtime-library/reference/atan-atanf-atanl-atan2-atan2f-atan2l.md @@ -1,7 +1,7 @@ --- title: "atan, atanf, atanl, atan2, atan2f, atan2l" description: "API reference for atan, atanf, atanl, atan2, atan2f, and atan2l; which calculate the arctangent of a floating-point value." -ms.date: "1/15/2021" +ms.date: 1/15/2021 api_name: ["atan2f", "atan2l", "atan2", "atanf", "atan", "atanl", "_o_atan", "_o_atan2", "_o_atan2f", "_o_atanf"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll", "api-ms-win-crt-math-l1-1-0.dll"] api_type: ["DLLExport"] @@ -19,7 +19,7 @@ Calculates the arctangent of **`x`** (**`atan`**, **`atanf`**, and **`atanl`**) double atan( double x ); float atanf( float x ); long double atanl( long double x ); -#define atan(X) // Requires C11 or higher +#define atan(X) // Requires C11 or later float atan( float x ); // C++ only long double atan( long double x ); // C++ only @@ -27,7 +27,7 @@ long double atan( long double x ); // C++ only double atan2( double y, double x ); float atan2f( float y, float x ); long double atan2l( long double y, long double x ); -#define atan2(Y, X) // Requires C11 or higher +#define atan2(Y, X) // Requires C11 or later float atan2( float y, float x ); // C++ only long double atan2( long double y, long double x ); // C++ only diff --git a/docs/c-runtime-library/reference/atanh-atanhf-atanhl.md b/docs/c-runtime-library/reference/atanh-atanhf-atanhl.md index 02b797f39aa..02ebb06caf3 100644 --- a/docs/c-runtime-library/reference/atanh-atanhf-atanhl.md +++ b/docs/c-runtime-library/reference/atanh-atanhf-atanhl.md @@ -1,14 +1,13 @@ --- title: "atanh, atanhf, atanhl" description: "API reference for atanh, atanhf, and atanhl; which calculate the inverse hyperbolic tangent of a floating-point value." -ms.date: "08/31/2020" +ms.date: 08/31/2020 api_name: ["atanhl", "atanhf", "atanh", "_o_atanh", "_o_atanhf", "_o_atanhl"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll", "api-ms-win-crt-math-l1-1-0.dll"] api_type: ["DLLExport"] topic_type: ["apiref"] f1_keywords: ["atanhl", "atanhf", "atanh"] -helpviewer_keywords: ["atanhf function", "atanhl function", "atanh funciton"] -ms.assetid: 83a43b5b-2580-4461-854f-dc84236d9f32 +helpviewer_keywords: ["atanhf function", "atanhl function", "atanh function"] --- # `atanh`, `atanhf`, `atanhl` @@ -20,7 +19,7 @@ Calculates the inverse hyperbolic tangent. double atanh( double x ); float atanhf( float x ); long double atanhl( long double x ); -#define atanh(X) // Requires C11 or higher +#define atanh(X) // Requires C11 or later float atanh( float x ); // C++ only long double atanh( long double x ); // C++ only diff --git a/docs/c-runtime-library/reference/bitand.md b/docs/c-runtime-library/reference/bitand.md index cc4b84b0bd6..0701824a21c 100644 --- a/docs/c-runtime-library/reference/bitand.md +++ b/docs/c-runtime-library/reference/bitand.md @@ -1,13 +1,12 @@ --- -description: "Learn more about: bitand" title: "bitand" +description: "Learn more about: bitand" ms.date: "11/04/2016" api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll"] api_type: ["DLLExport"] topic_type: ["apiref"] f1_keywords: ["std::bitand", "std.bitand", "ISO646/bitand", "bitand"] helpviewer_keywords: ["bitand function"] -ms.assetid: 279cf9b5-fac1-49de-b329-f1a31b3481fe --- # `bitand` @@ -16,7 +15,6 @@ An alternative to the & operator. ## Syntax ```C - #define bitand & ``` diff --git a/docs/c-runtime-library/reference/bitor.md b/docs/c-runtime-library/reference/bitor.md index 4451365a0e0..8f2aaf236df 100644 --- a/docs/c-runtime-library/reference/bitor.md +++ b/docs/c-runtime-library/reference/bitor.md @@ -1,13 +1,12 @@ --- -description: "Learn more about: bitor" title: "bitor" +description: "Learn more about: bitor" ms.date: "11/04/2016" api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll"] api_type: ["DLLExport"] topic_type: ["apiref"] f1_keywords: ["ISO646/bitor", "bitor", "std.bitor", "std::bitor"] helpviewer_keywords: ["bitor function"] -ms.assetid: 3c0a3711-9c74-41f2-b400-2f7797da30d1 --- # `bitor` @@ -16,7 +15,6 @@ An alternative to the `|` operator. ## Syntax ```C - #define bitor | ``` diff --git a/docs/c-runtime-library/reference/calloc-dbg.md b/docs/c-runtime-library/reference/calloc-dbg.md index bde434d3d86..fbff456b61b 100644 --- a/docs/c-runtime-library/reference/calloc-dbg.md +++ b/docs/c-runtime-library/reference/calloc-dbg.md @@ -99,7 +99,7 @@ int main( void ) else printf( "Problem allocating memory\n" ); - / _free_dbg must be called to free CLIENT type blocks + // _free_dbg must be called to free CLIENT type blocks free( bufferN ); _free_dbg( bufferC, _CLIENT_BLOCK ); } diff --git a/docs/c-runtime-library/reference/carg-cargf-cargl.md b/docs/c-runtime-library/reference/carg-cargf-cargl.md index 0635b71a2e0..867def0277a 100644 --- a/docs/c-runtime-library/reference/carg-cargf-cargl.md +++ b/docs/c-runtime-library/reference/carg-cargf-cargl.md @@ -1,14 +1,13 @@ --- title: "carg, cargf, cargl" description: "API reference for carg, cargf, and cargl; which retrieve the argument of a complex number, with a branch cut along the negative real axis." -ms.date: "9/2/2020" +ms.date: 9/2/2020 api_name: ["carg", "cargf", "cargl"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll", "api-ms-win-crt-math-l1-1-0.dll"] api_type: ["DLLExport"] topic_type: ["apiref"] f1_keywords: ["carg", "cargf", "cargl", "complex/carg", "complex/cargf", "complex/cargl"] helpviewer_keywords: ["carg function", "cargf function", "cargl function"] -ms.assetid: 610d6a93-b929-46ab-a966-b77db0b804be --- # `carg`, `cargf`, `cargl` @@ -32,7 +31,7 @@ float cargf( long double cargl( _Lcomplex z ); -#define carg(X) // Requires C11 or higher +#define carg(X) // Requires C11 or later ``` ### Parameters diff --git a/docs/c-runtime-library/reference/cbrt-cbrtf-cbrtl.md b/docs/c-runtime-library/reference/cbrt-cbrtf-cbrtl.md index 930c3fcaadb..0ec75d67622 100644 --- a/docs/c-runtime-library/reference/cbrt-cbrtf-cbrtl.md +++ b/docs/c-runtime-library/reference/cbrt-cbrtf-cbrtl.md @@ -1,14 +1,13 @@ --- title: "cbrt, cbrtf, cbrtl" description: "API reference for cbrt, cbrtf, and cbrtl; which calculate a cube root" -ms.date: "9/1/2020" +ms.date: 9/1/2020 api_name: ["cbrt", "cbrtf", "cbrtl", "_o_cbrt", "_o_cbrtf"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll", "api-ms-win-crt-math-l1-1-0.dll"] api_type: ["DLLExport"] topic_type: ["apiref"] f1_keywords: ["cbrtl", "cbrt", "cbrtf"] helpviewer_keywords: ["cbrtl function", "cbrtf function", "cbrt function"] -ms.assetid: ab51d916-3db2-4beb-b46a-28b4062cd33f --- # `cbrt`, `cbrtf`, `cbrtl` @@ -32,7 +31,7 @@ float cbrtf( long double cbrtl( long double x ); -#define cbrt(X) // Requires C11 or higher +#define cbrt(X) // Requires C11 or later ``` ### Parameters diff --git a/docs/c-runtime-library/reference/ceil-ceilf-ceill.md b/docs/c-runtime-library/reference/ceil-ceilf-ceill.md index 0b4598a2542..c1e0fc6cfbe 100644 --- a/docs/c-runtime-library/reference/ceil-ceilf-ceill.md +++ b/docs/c-runtime-library/reference/ceil-ceilf-ceill.md @@ -1,14 +1,13 @@ --- title: "ceil, ceilf, ceill" description: "API ref for calculating the ceiling of a value with ceil()." -ms.date: "9/1/2020" +ms.date: 9/1/2020 api_name: ["ceilf", "ceil", "ceill", "_o_ceil", "_o_ceilf"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll", "ntdll.dll", "api-ms-win-crt-math-l1-1-0.dll"] api_type: ["DLLExport"] topic_type: ["apiref"] f1_keywords: ["ceil", "ceilf", "ceill"] helpviewer_keywords: ["calculating value ceilings", "ceill function", "ceil function", "ceilf function"] -ms.assetid: f4e5acab-5c8f-4b10-9ae2-9561e6453718 --- # `ceil`, `ceilf`, `ceill` @@ -32,7 +31,7 @@ float ceilf( long double ceill( long double x ); -#define ceil(X) // Requires C11 or higher +#define ceil(X) // Requires C11 or later ``` ### Parameters diff --git a/docs/c-runtime-library/reference/cgets-s-cgetws-s.md b/docs/c-runtime-library/reference/cgets-s-cgetws-s.md index 8709404d4c9..82de69ea28d 100644 --- a/docs/c-runtime-library/reference/cgets-s-cgetws-s.md +++ b/docs/c-runtime-library/reference/cgets-s-cgetws-s.md @@ -1,6 +1,6 @@ --- -description: "Learn more about: _cgets_s, _cgetws_s" title: "_cgets_s, _cgetws_s" +description: "Learn more about: _cgets_s, _cgetws_s" ms.date: "4/2/2020" api_name: ["_cgetws_s", "_cgets_s", "_o__cgets_s", "_o__cgetws_s"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll", "api-ms-win-crt-conio-l1-1-0.dll"] @@ -8,7 +8,6 @@ api_type: ["DLLExport"] topic_type: ["apiref"] f1_keywords: ["_cgets_s", "cgets_s", "cgetws_s", "_cgetws_s"] helpviewer_keywords: ["strings [C++], getting from console", "console, getting strings from", "_cgets_s function", "cget_s function", "_cgetws_s function", "cgetws_s function"] -ms.assetid: 38b74897-afe6-4dd9-a43f-36a3c0d72c5c --- # `_cgets_s`, `_cgetws_s` @@ -26,7 +25,7 @@ errno_t _cgets_s( size_t *pSizeRead ); errno_t _cgetws_s( - wchar_t *buffer + wchar_t *buffer, size_t numberOfElements, size_t *pSizeRead ); diff --git a/docs/c-runtime-library/reference/cimag-cimagf-cimagl.md b/docs/c-runtime-library/reference/cimag-cimagf-cimagl.md index dfcdd2f3819..2f896bd5097 100644 --- a/docs/c-runtime-library/reference/cimag-cimagf-cimagl.md +++ b/docs/c-runtime-library/reference/cimag-cimagf-cimagl.md @@ -1,14 +1,13 @@ --- title: "cimag, cimagf, cimagl" description: "API reference for cimag, cimagf, and cimagl; which retrieve the imaginary part of a complex number." -ms.date: "9/2/2020" +ms.date: 9/2/2020 api_name: ["cimag", "cimagf", "cimagl"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll", "api-ms-win-crt-math-l1-1-0.dll"] api_type: ["DLLExport"] topic_type: ["apiref"] f1_keywords: ["cimagf", "cimagl", "complex/cimag", "complex/cimagf", "complex/cimagl", "cimag"] helpviewer_keywords: ["cimag function", "cimagf function", "cimagl function"] -ms.assetid: 0d8836f5-d61d-44cd-8731-6f75cb776def --- # `cimag`, `cimagf`, `cimagl` @@ -20,7 +19,7 @@ Retrieves the imaginary part of a complex number. double cimag( _Dcomplex z ); float cimagf( _Fcomplex z ); long double cimagl( _Lcomplex z ); -#define cimag(X) // Requires C11 or higher +#define cimag(X) // Requires C11 or later float cimag( _Fcomplex z ); // C++ only long double cimag( _Lcomplex z ); // C++ only diff --git a/docs/c-runtime-library/reference/conj-conjf-conjl.md b/docs/c-runtime-library/reference/conj-conjf-conjl.md index 60b5e95ad99..fbf227b3e4e 100644 --- a/docs/c-runtime-library/reference/conj-conjf-conjl.md +++ b/docs/c-runtime-library/reference/conj-conjf-conjl.md @@ -1,14 +1,13 @@ --- title: "conj, conjf, conjl" description: "API reference for conj, conjf, and conjl; which retrieve the complex conjugate of a complex number." -ms.date: "9/2/2020" +ms.date: 9/2/2020 api_name: ["conj", "conjf", "conjl"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll", "api-ms-win-crt-math-l1-1-0.dll"] api_type: ["DLLExport"] topic_type: ["apiref"] f1_keywords: ["conj", "conjf", "conjl", "complex/conj", "complex/conjf", "complex/conjl"] helpviewer_keywords: ["conj function", "conjf function", "conjl function"] -ms.assetid: 792fccfa-19c6-4890-99f9-a3b89effccd6 --- # `conj`, `conjf`, `conjl` @@ -32,7 +31,7 @@ _Fcomplex conjf( _Lcomplex conjl( _Lcomplex z ); -#define conj(X) // Requires C11 or higher +#define conj(X) // Requires C11 or later ``` ### Parameters diff --git a/docs/c-runtime-library/reference/controlfp-s.md b/docs/c-runtime-library/reference/controlfp-s.md index d955dfb42e2..8de3df8b7c6 100644 --- a/docs/c-runtime-library/reference/controlfp-s.md +++ b/docs/c-runtime-library/reference/controlfp-s.md @@ -1,7 +1,7 @@ --- description: "Learn more about: _controlfp_s" title: "_controlfp_s" -ms.date: "4/2/2020" +ms.date: 03/27/2025 api_name: ["_controlfp_s", "_o__controlfp_s"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll", "api-ms-win-crt-runtime-l1-1-0.dll"] api_type: ["DLLExport"] @@ -75,16 +75,23 @@ _controlfp_s(¤t_word, _DN_FLUSH, _MCW_DN); // and x64 processors with SSE2 support. Ignored on other x86 platforms. ``` -On ARM platforms, the **`_controlfp_s`** function applies to the FPSCR register. On x64 architectures, only the SSE2 control word that's stored in the MXCSR register is affected. On Intel (x86) platforms, **`_controlfp_s`** affects the control words for both the x87 and the SSE2, if present. It's possible for the two control words to be inconsistent with each other (because of a previous call to [`__control87_2`](control87-controlfp-control87-2.md), for example); if there's an inconsistency between the two control words, **`_controlfp_s`** sets the `EM_AMBIGUOUS` flag in *`currentControl`*. It's a warning that the returned control word might not represent the state of both floating-point control words accurately. +This function is ignored when you use [`/clr` (Common Language Runtime Compilation)](../../build/reference/clr-common-language-runtime-compilation.md) to compile because the common language runtime (CLR) only supports the default floating-point precision. -On the ARM and x64 architectures, changing the infinity mode or the floating-point precision isn't supported. If the precision control mask is used on the x64 platform, the function raises an assertion and the invalid parameter handler is invoked, as described in [Parameter validation](../parameter-validation.md). +On x64, only the SSE2 control word stored in the MXCSR register is affected. Changing the infinity mode or the floating-point precision isn't supported. If the precision control mask is used on the x64 platform, the function raises an assertion and the invalid parameter handler is invoked as described in [Parameter validation](../parameter-validation.md). -If the mask isn't set correctly, this function generates an invalid parameter exception, as described in [Parameter validation](../parameter-validation.md). If execution is allowed to continue, this function returns `EINVAL` and sets `errno` to `EINVAL`. +On x86, **`_controlfp_s`** affects the control words for both the x87 and the SSE2, if present. It's possible for the two control words to be inconsistent with each other (because of a previous call to [`__control87_2`](control87-controlfp-control87-2.md), for example); if there's an inconsistency between the two control words, **`_controlfp_s`** sets the `EM_AMBIGUOUS` flag in *`currentControl`*. It's a warning that the returned control word might not represent the state of both floating-point control words accurately. -This function is ignored when you use [`/clr` (Common Language Runtime Compilation)](../../build/reference/clr-common-language-runtime-compilation.md) to compile because the common language runtime (CLR) only supports the default floating-point precision. +If the mask isn't set correctly, this function generates an invalid parameter exception, as described in [Parameter validation](../parameter-validation.md). If execution is allowed to continue, this function returns `EINVAL` and sets `errno` to `EINVAL`. By default, this function's global state is scoped to the application. To change this behavior, see [Global state in the CRT](../global-state.md). +### Arm platforms + +- Changing the infinity mode or the floating-point precision isn't supported. If the precision control mask is used on the x64 platform, the function raises an assertion and the invalid parameter handler is invoked, as described in [Parameter validation](../parameter-validation.md). +- On ARM32 (discontinued), Windows doesn't support FP exceptions. +- On ARM64, unmasking the whole `_MCW_EM` or any bits from it (`_EM_INEXACT`, `_EM_UNDERFLOW`, `_EM_OVERFLOW`, `_EM_ZERODIVIDE`, and `_EM_INVALID`) correctly change the FPCR register. Floating point exceptions raised by standard math functions, like Invalid operation from `std::acos`, are exempt from this behavior and can be ignored or raised properly depending on the FPCR register. For more information, see [Overview of ARM32 ABI Conventions](../../build/overview-of-arm-abi-conventions.md#floating-point-exceptions). +- On ARM64EC, Windows catches processor floating-point exceptions and disables them in the FPCR register. This ensures consistent behavior across different processor variants. + ### Mask constants and values For the `_MCW_EM` mask, clearing it sets the exception, which allows the hardware exception; setting it hides the exception. If a `_EM_UNDERFLOW` or `_EM_OVERFLOW` occurs, no hardware exception is thrown until the next floating-point instruction is executed. To generate a hardware exception immediately after `_EM_UNDERFLOW` or `_EM_OVERFLOW`, call the `FWAIT MASM` instruction. diff --git a/docs/c-runtime-library/reference/copysign-copysignf-copysignl-copysign-copysignf-copysignl.md b/docs/c-runtime-library/reference/copysign-copysignf-copysignl-copysign-copysignf-copysignl.md index 8d979ab1f3e..225fd4e100d 100644 --- a/docs/c-runtime-library/reference/copysign-copysignf-copysignl-copysign-copysignf-copysignl.md +++ b/docs/c-runtime-library/reference/copysign-copysignf-copysignl-copysign-copysignf-copysignl.md @@ -1,14 +1,13 @@ --- title: "copysign, copysignf, copysignl, _copysign, _copysignf, _copysignl" description: "API ref for returning a value that has the magnitude of one argument and the sign of another using copysign()" -ms.date: "9/1/2020" +ms.date: 9/1/2020 api_name: ["copysignf", "copysignl", "_copysignl", "_copysign", "_copysignf", "copysign"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll", "api-ms-win-crt-math-l1-1-0.dll"] api_type: ["DLLExport"] topic_type: ["apiref"] f1_keywords: ["_copysignl", "copysign", "copysignf", "_copysign", "copysignl", "_copysignf"] helpviewer_keywords: ["copysignl function", "_copysignl function", "copysign function", "_copysignf function", "_copysign function", "copysignf function"] -ms.assetid: 009216d6-72a2-402d-aa6c-91d924b2c9e4 --- # `copysign`, `copysignf`, `copysignl`, `_copysign`, `_copysignf`, `_copysignl` @@ -45,7 +44,7 @@ long double _copysignl( long double x, long double y ); -#define copysign(X, Y) // Requires C11 or higher +#define copysign(X, Y) // Requires C11 or later ``` ### Parameters diff --git a/docs/c-runtime-library/reference/cos-cosf-cosl.md b/docs/c-runtime-library/reference/cos-cosf-cosl.md index 5e31e2aa7e1..ab58605fd61 100644 --- a/docs/c-runtime-library/reference/cos-cosf-cosl.md +++ b/docs/c-runtime-library/reference/cos-cosf-cosl.md @@ -1,14 +1,13 @@ --- title: "cos, cosf, cosl" description: "API reference for cos, cosf, and cosl; which calculate the cosine value of a floating-point number." -ms.date: "08/31/2020" +ms.date: 08/31/2020 api_name: ["cos", "cosf", "cosl", "_o_cos", "_o_cosf"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll", "api-ms-win-crt-math-l1-1-0.dll"] api_type: ["DLLExport"] topic_type: ["apiref"] f1_keywords: ["cos", "cosf", "cosl"] helpviewer_keywords: ["cosines", "cosl function", "calculating cosine", "cosf function", "cos function", "trigonometric functions", "cosines, calculating"] -ms.assetid: ae90435e-6b68-4a47-a81f-be87d5c08f16 --- # `cos`, `cosf`, `cosl` @@ -20,7 +19,7 @@ Calculates the cosine. double cos( double x ); float cosf( float x ); long double cosl( long double x ); -#define cos(X) // Requires C11 or higher +#define cos(X) // Requires C11 or later float cos( float x ); // C++ only long double cos( long double x ); // C++ only diff --git a/docs/c-runtime-library/reference/cosh-coshf-coshl.md b/docs/c-runtime-library/reference/cosh-coshf-coshl.md index cddafd7d1b7..f02e9ed491d 100644 --- a/docs/c-runtime-library/reference/cosh-coshf-coshl.md +++ b/docs/c-runtime-library/reference/cosh-coshf-coshl.md @@ -1,7 +1,7 @@ --- title: "cosh, coshf, coshl" description: "API reference for cosh, coshf, and coshl; which calculate the hyperbolic cosine of a floating-point value." -ms.date: "1/15/2021" +ms.date: 1/15/2021 api_name: ["cosh", "coshf", "coshl", "_o_cosh", "_o_coshf"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll", "api-ms-win-crt-math-l1-1-0.dll"] api_type: ["DLLExport"] @@ -19,7 +19,7 @@ Calculates the hyperbolic cosine. double cosh( double x ); float coshf( float x ); long double coshl( long double x ); -#define cosh(X) // Requires C11 or higher +#define cosh(X) // Requires C11 or later float cosh( float x ); // C++ only long double cosh( long double x ); // C++ only diff --git a/docs/c-runtime-library/reference/cprintf-cprintf-l-cwprintf-cwprintf-l.md b/docs/c-runtime-library/reference/cprintf-cprintf-l-cwprintf-cwprintf-l.md index 55418b0ad26..8dfe11ae631 100644 --- a/docs/c-runtime-library/reference/cprintf-cprintf-l-cwprintf-cwprintf-l.md +++ b/docs/c-runtime-library/reference/cprintf-cprintf-l-cwprintf-cwprintf-l.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: _cprintf, _cprintf_l, _cwprintf, _cwprintf_l" title: "_cprintf, _cprintf_l, _cwprintf, _cwprintf_l" -ms.date: "3/9/2021" +description: "Learn more about: _cprintf, _cprintf_l, _cwprintf, _cwprintf_l" +ms.date: 3/9/2021 api_name: ["_cwprintf_l", "_cprintf_l", "_cwprintf", "_cprintf"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll"] api_type: ["DLLExport"] @@ -85,7 +85,6 @@ For more compatibility information, see [Compatibility](../compatibility.md). ```C // crt_cprintf.c -// compile with: /c // This program displays some variables to the console. #include diff --git a/docs/c-runtime-library/reference/cprintf-s-cprintf-s-l-cwprintf-s-cwprintf-s-l.md b/docs/c-runtime-library/reference/cprintf-s-cprintf-s-l-cwprintf-s-cwprintf-s-l.md index cab723ba690..3dc9149a342 100644 --- a/docs/c-runtime-library/reference/cprintf-s-cprintf-s-l-cwprintf-s-cwprintf-s-l.md +++ b/docs/c-runtime-library/reference/cprintf-s-cprintf-s-l-cwprintf-s-cwprintf-s-l.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: _cprintf_s, _cprintf_s_l, _cwprintf_s, _cwprintf_s_l" title: "_cprintf_s, _cprintf_s_l, _cwprintf_s, _cwprintf_s_l" -ms.date: "3/9/2021" +description: "Learn more about: _cprintf_s, _cprintf_s_l, _cwprintf_s, _cwprintf_s_l" +ms.date: 3/9/2021 api_name: ["_cwprintf_s_l", "_cprintf_s_l", "_cprintf_s", "_cwprintf_s"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll"] api_type: ["DLLExport"] @@ -65,7 +65,7 @@ The versions of these functions with the `_l` suffix are identical except that t > [!IMPORTANT] > Ensure that *`format`* is not a user-defined string. > -> Starting in Windows 10 version 2004 (build 19041), the `printf` family of functions prints exactly representable floating point numbers according to the IEEE 754 rules for rounding. In previous versions of Windows, exactly representable floating point numbers ending in '5' would always round up. IEEE 754 states that they must round to the closest even digit (also known as "Banker's Rounding"). For example, both `printf("%1.0f", 1.5)` and `printf("%1.0f", 2.5)` should round to 2. Previously, 1.5 would round to 2 and 2.5 would round to 3. This change only affects exactly representable numbers. For example, 2.35 (which, when represented in memory, is closer to 2.35000000000000008) continues to round up to 2.4. Rounding done by these functions now also respects the floating point rounding mode set by [`fesetround`](fegetround-fesetround2.md). Previously, rounding always chose `FE_TONEAREST` behavior. This change only affects programs built using Visual Studio 2019 version 16.2 and later. To use the legacy floating point rounding behavior, link with ['legacy_stdio_float_rounding.obj`](../link-options.md). +> Starting in Windows 10 version 2004 (build 19041), the `printf` family of functions prints exactly representable floating point numbers according to the IEEE 754 rules for rounding. In previous versions of Windows, exactly representable floating point numbers ending in '5' would always round up. IEEE 754 states that they must round to the closest even digit (also known as "Banker's Rounding"). For example, both `printf("%1.0f", 1.5)` and `printf("%1.0f", 2.5)` should round to 2. Previously, 1.5 would round to 2 and 2.5 would round to 3. This change only affects exactly representable numbers. For example, 2.35 (which, when represented in memory, is closer to 2.35000000000000008) continues to round up to 2.4. Rounding done by these functions now also respects the floating point rounding mode set by [`fesetround`](fegetround-fesetround2.md). Previously, rounding always chose `FE_TONEAREST` behavior. This change only affects programs built using Visual Studio 2019 version 16.2 and later. To use the legacy floating point rounding behavior, link with [`legacy_stdio_float_rounding.obj`](../link-options.md). Like the non-secure versions (see [`_cprintf`, `_cprintf_l`, `_cwprintf`, `_cwprintf_l`](cprintf-cprintf-l-cwprintf-cwprintf-l.md)), these functions validate their parameters and invoke the invalid parameter handler, as described in [Parameter validation](../parameter-validation.md), if *`format`* is a null pointer. These functions differ from the non-secure versions in that the format string itself is also validated. If there are any unknown or badly formed formatting specifiers, these functions invoke the invalid parameter handler. In all cases, If execution is allowed to continue, the functions return -1 and set `errno` to `EINVAL`. @@ -93,7 +93,6 @@ All versions of the [C run-time libraries](../crt-library-features.md). ```C // crt_cprintf_s.c -// compile with: /c // This program displays some variables to the console. #include diff --git a/docs/c-runtime-library/reference/cproj-cprojf-cprojl.md b/docs/c-runtime-library/reference/cproj-cprojf-cprojl.md index 39bd6ca7d8a..99f512c15eb 100644 --- a/docs/c-runtime-library/reference/cproj-cprojf-cprojl.md +++ b/docs/c-runtime-library/reference/cproj-cprojf-cprojl.md @@ -1,14 +1,13 @@ --- title: "cproj, cprojf, cprojl" description: "API reference for cproj, cprojf, and cprojl; which retrieve the projection of a complex number on the Reimann sphere." -ms.date: "9/2/2020" +ms.date: 9/2/2020 api_name: ["cproj", "cprojf", "cprojl"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll", "api-ms-win-crt-math-l1-1-0.dll"] api_type: ["DLLExport"] topic_type: ["apiref"] f1_keywords: ["cproj", "cprojf", "cprojl", "complex/cproj", "complex/cprojf", "complex/cprojl"] helpviewer_keywords: ["cproj function", "cprojf function", "cprojl function"] -ms.assetid: 32b49623-13bf-4cae-802e-7912d75030fe --- # `cproj`, `cprojf`, `cprojl` @@ -32,7 +31,7 @@ _Fcomplex cprojf( _Lcomplex cprojl( _Lcomplex z ); -#define cproj(X) // Requires C11 or higher +#define cproj(X) // Requires C11 or later ``` ### Parameters diff --git a/docs/c-runtime-library/reference/creal-crealf-creall.md b/docs/c-runtime-library/reference/creal-crealf-creall.md index 40a36d933e1..82f3159c8da 100644 --- a/docs/c-runtime-library/reference/creal-crealf-creall.md +++ b/docs/c-runtime-library/reference/creal-crealf-creall.md @@ -1,14 +1,13 @@ --- title: "creal, crealf, creall" description: "API reference for creal, crealf, creall; which retrieve the real part of a complex number." -ms.date: "9/2/2020" +ms.date: 9/2/2020 api_name: ["creal", "crealf", "creall"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll", "api-ms-win-crt-math-l1-1-0.dll"] api_type: ["DLLExport"] topic_type: ["apiref"] f1_keywords: ["creal", "crealf", "creall", "complex/creal", "complex/crealf", "complex/creall"] helpviewer_keywords: ["creal function", "crealf function", "creall function"] -ms.assetid: fa3ac62f-7aa3-4238-a71f-d6b00cd0c7c8 --- # `creal`, `crealf`, `creall` @@ -20,7 +19,7 @@ Retrieves the real part of a complex number. double creal( _Dcomplex z ); float crealf( _Fcomplex z ); long double creall( _Lcomplex z ); -#define creal(X) // Requires C11 or higher +#define creal(X) // Requires C11 or later float creal( _Fcomplex z ); // C++ only long double creal( _Lcomplex z ); // C++ only diff --git a/docs/c-runtime-library/reference/crtcheckmemory.md b/docs/c-runtime-library/reference/crtcheckmemory.md index de0f6e98cec..5c9ca5d58ed 100644 --- a/docs/c-runtime-library/reference/crtcheckmemory.md +++ b/docs/c-runtime-library/reference/crtcheckmemory.md @@ -1,6 +1,6 @@ --- -description: "Learn more about: _CrtCheckMemory" title: "_CrtCheckMemory" +description: "Learn more about: _CrtCheckMemory" ms.date: "11/04/2016" api_name: ["_CrtCheckMemory"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll"] @@ -8,7 +8,6 @@ api_type: ["DLLExport"] topic_type: ["apiref"] f1_keywords: ["CrtCheckMemory", "_CrtCheckMemory"] helpviewer_keywords: ["_CrtCheckMemory function", "CrtCheckMemory function"] -ms.assetid: 457cc72e-60fd-4177-ab5c-6ae26a420765 --- # `_CrtCheckMemory` @@ -17,7 +16,6 @@ Confirms the integrity of the memory blocks allocated in the debug heap (debug v ## Syntax ```C - int _CrtCheckMemory( void ); ``` diff --git a/docs/c-runtime-library/reference/crtdumpmemoryleaks.md b/docs/c-runtime-library/reference/crtdumpmemoryleaks.md index 5e934bfd26a..28291b7a9ce 100644 --- a/docs/c-runtime-library/reference/crtdumpmemoryleaks.md +++ b/docs/c-runtime-library/reference/crtdumpmemoryleaks.md @@ -1,6 +1,6 @@ --- -description: "Learn more about: _CrtDumpMemoryLeaks" title: "_CrtDumpMemoryLeaks" +description: "Learn more about: _CrtDumpMemoryLeaks" ms.date: "11/04/2016" api_name: ["_CrtDumpMemoryLeaks"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll"] @@ -16,7 +16,6 @@ Dumps all the memory blocks in the debug heap when a memory leak has occurred (d ## Syntax ```C - int _CrtDumpMemoryLeaks( void ); ``` diff --git a/docs/c-runtime-library/reference/crtreportblocktype.md b/docs/c-runtime-library/reference/crtreportblocktype.md index 48220ad606b..e9c58f7c24a 100644 --- a/docs/c-runtime-library/reference/crtreportblocktype.md +++ b/docs/c-runtime-library/reference/crtreportblocktype.md @@ -1,14 +1,13 @@ --- -description: "Learn more about: _CrtReportBlockType" title: "_CrtReportBlockType" -ms.date: "11/04/2016" +description: "Learn more about: _CrtReportBlockType" +ms.date: 11/04/2016 api_name: ["_CrtReportBlockType"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll"] api_type: ["DLLExport"] topic_type: ["apiref"] f1_keywords: ["_CrtReportBlockType", "CrtReportBlockType"] helpviewer_keywords: ["CrtReportBlockType function", "BLOCK_SUBTYPE macro", "_CrtReportBlockType function", "_BLOCK_TYPE macro", "_BLOCK_SUBTYPE macro", "BLOCK_TYPE macro"] -ms.assetid: 0f4b9da7-bebb-4956-9541-b2581640ec6b --- # `_CrtReportBlockType` @@ -19,7 +18,7 @@ Returns the block type/subtype associated with a given debug heap block pointer. ```C int _CrtReportBlockType( const void * pBlock -}; +); ``` ### Parameters diff --git a/docs/c-runtime-library/reference/crtsetdebugfillthreshold.md b/docs/c-runtime-library/reference/crtsetdebugfillthreshold.md index bd91d7fa572..143cbd3f210 100644 --- a/docs/c-runtime-library/reference/crtsetdebugfillthreshold.md +++ b/docs/c-runtime-library/reference/crtsetdebugfillthreshold.md @@ -1,14 +1,13 @@ --- title: "_CrtSetDebugFillThreshold" description: "Use the _CrtSetDebugFillThreshold function to set the maximum amount of buffer to fill in secure CRT functions." -ms.date: "10/31/2019" +ms.date: 04/10/2025 api_name: ["_CrtSetDebugFillThreshold"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll"] api_type: ["DLLExport"] topic_type: ["apiref"] f1_keywords: ["_CrtSetDebugFillThreshold", "CrtSetDebugFillThreshold"] helpviewer_keywords: ["debug, buffer-filling behavior", "CrtSetDebugFillThreshold function", "_CrtSetDebugFillThreshold function", "buffer-filling behavior", "0xFE"] -ms.assetid: 6cb360e8-56ae-4248-b17f-e28aee3e0ed7 --- # `_CrtSetDebugFillThreshold` @@ -38,58 +37,36 @@ The default threshold is `SIZE_T_MAX`. Here's a list of the affected functions: - [`asctime_s`, `_wasctime_s`](asctime-s-wasctime-s.md) - - [`_cgets_s`, `_cgetws_s`](cgets-s-cgetws-s.md) - - [`ctime_s`, `_ctime32_s`, `_ctime64_s`, `_wctime_s`, `_wctime32_s`, `_wctime64_s`](ctime-s-ctime32-s-ctime64-s-wctime-s-wctime32-s-wctime64-s.md) - - [`_ecvt_s`](ecvt-s.md) - - [`_fcvt_s`](fcvt-s.md) - - [`_gcvt_s`](gcvt-s.md) - - [`_itoa_s`, `_ltoa_s`, `_ultoa_s`, `_i64toa_s`, `_ui64toa_s`, `_itow_s`, `_ltow_s`, `_ultow_s`, `_i64tow_s`, `_ui64tow_s`](itoa-s-itow-s.md) - - [`_makepath_s`, `_wmakepath_s`](makepath-s-wmakepath-s.md) - - [`_mbsnbcat_s`, `_mbsnbcat_s_l`](mbsnbcat-s-mbsnbcat-s-l.md) - - [`_mbsnbcpy_s`, `_mbsnbcpy_s_l`](mbsnbcpy-s-mbsnbcpy-s-l.md) - - [`_mbsnbset_s`, `_mbsnbset_s_l`](mbsnbset-s-mbsnbset-s-l.md) - - [`_mktemp_s`, `_wmktemp_s`](makepath-s-wmakepath-s.md) - - [`_splitpath_s`, `_wsplitpath_s`](splitpath-s-wsplitpath-s.md) - - [`strcat_s`, `wcscat_s`, `_mbscat_s`](strcat-s-wcscat-s-mbscat-s.md) - - [`strcpy_s`, `wcscpy_s`, `_mbscpy_s`](strcpy-s-wcscpy-s-mbscpy-s.md) - - [`_strdate_s`, `_wstrdate_s`](strdate-s-wstrdate-s.md) - - [`strerror_s`, `_strerror_s`, `_wcserror_s`, `__wcserror_s`](strerror-s-strerror-s-wcserror-s-wcserror-s.md) - - [`_strlwr_s`, `_strlwr_s_l`, `_mbslwr_s`, `_mbslwr_s_l`, `_wcslwr_s`, `_wcslwr_s_l`](strlwr-s-strlwr-s-l-mbslwr-s-mbslwr-s-l-wcslwr-s-wcslwr-s-l.md) - - [`strncat_s`, `_strncat_s_l`, `wcsncat_s`, `_wcsncat_s_l`, `_mbsncat_s`, `_mbsncat_s_l`](strncat-s-strncat-s-l-wcsncat-s-wcsncat-s-l-mbsncat-s-mbsncat-s-l.md) - - [`strncpy_s`, `_strncpy_s_l`, `wcsncpy_s`, `_wcsncpy_s_l`, `_mbsncpy_s`, `_mbsncpy_s_l`](strncpy-s-strncpy-s-l-wcsncpy-s-wcsncpy-s-l-mbsncpy-s-mbsncpy-s-l.md) - - [`_strnset_s`, `_strnset_s_l`, `_wcsnset_s`, `_wcsnset_s_l`, `_mbsnset_s`, `_mbsnset_s_l`](strnset-s-strnset-s-l-wcsnset-s-wcsnset-s-l-mbsnset-s-mbsnset-s-l.md) - - [`_strset_s`, `_strset_s_l`, `_wcsset_s`, `_wcsset_s_l`, `_mbsset_s`, `_mbsset_s_l`](strset-s-strset-s-l-wcsset-s-wcsset-s-l-mbsset-s-mbsset-s-l.md) - - [`_strtime_s`, `_wstrtime_s`](strtime-s-wstrtime-s.md) - - [`_strupr_s`, `_strupr_s_l`, `_mbsupr_s`, `_mbsupr_s_l`, `_wcsupr_s`, `_wcsupr_s_l`](strupr-s-strupr-s-l-mbsupr-s-mbsupr-s-l-wcsupr-s-wcsupr-s-l.md) - +- [`vsnprintf_s`, `_vsnprintf_s`, `_vsnprintf_s_l`, `_vsnwprintf_s`, `_vsnwprintf_s_l`](vsnprintf-s-vsnprintf-s-vsnprintf-s-l-vsnwprintf-s-vsnwprintf-s-l.md) + ## Requirements | Routine | Required header | |---|---| -| **`_CrtSetDebugFillThreshold`** | \ | +| **`_CrtSetDebugFillThreshold`** | `` | This function is Microsoft-specific. For more compatibility information, see [Compatibility](../compatibility.md). diff --git a/docs/c-runtime-library/reference/cscanf-s-cscanf-s-l-cwscanf-s-cwscanf-s-l.md b/docs/c-runtime-library/reference/cscanf-s-cscanf-s-l-cwscanf-s-cwscanf-s-l.md index 87dac808b60..7ca544e88b7 100644 --- a/docs/c-runtime-library/reference/cscanf-s-cscanf-s-l-cwscanf-s-cwscanf-s-l.md +++ b/docs/c-runtime-library/reference/cscanf-s-cscanf-s-l-cwscanf-s-cwscanf-s-l.md @@ -1,14 +1,13 @@ --- -description: "Learn more about: _cscanf_s, _cscanf_s_l, _cwscanf_s, _cwscanf_s_l" title: "_cscanf_s, _cscanf_s_l, _cwscanf_s, _cwscanf_s_l" -ms.date: "11/04/2016" +description: "Learn more about: _cscanf_s, _cscanf_s_l, _cwscanf_s, _cwscanf_s_l" +ms.date: 11/04/2016 api_name: ["_cwscanf_s_l", "_cwscanf_s", "_cscanf_s", "_cscanf_s_l"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll"] api_type: ["DLLExport"] topic_type: ["apiref"] f1_keywords: ["cscanf_s", "cscanf_s_l", "cwscanf_s", "_cwscanf_s", "_tcscanf_s", "_cscanf_s", "_cwscanf_s_l", "_cscanf_s_l", "cwscanf_s_l", "_tcscanf_s_l", "tcscanf_s", "tcscanf_s_l"] helpviewer_keywords: ["cscanf_s function", "_cwscanf_s_l function", "tcscanf_s function", "console [C++], reading from", "_cscanf_s function", "data [C++], reading from the console", "cwscanf_s function", "_tcscanf_s_l function", "_cscanf_s_l function", "cscanf_s_l function", "cwscanf_s_l function", "reading data [C++], from the console", "_cwscanf_s function", "_tcscanf_s function", "tcscanf_s_l function"] -ms.assetid: 9ccab74d-916f-42a6-93d8-920525efdf4b --- # `_cscanf_s`, `_cscanf_s_l`, `_cwscanf_s`, `_cwscanf_s_l` @@ -92,7 +91,6 @@ All versions of the [C run-time libraries](../crt-library-features.md). ```C // crt_cscanf_s.c -// compile with: /c /* This program prompts for a string * and uses _cscanf_s to read in the response. * Then _cscanf_s returns the number of items diff --git a/docs/c-runtime-library/reference/ctan-ctanf-ctanl.md b/docs/c-runtime-library/reference/ctan-ctanf-ctanl.md index a88bd27f839..8272c80111f 100644 --- a/docs/c-runtime-library/reference/ctan-ctanf-ctanl.md +++ b/docs/c-runtime-library/reference/ctan-ctanf-ctanl.md @@ -1,14 +1,13 @@ --- title: "ctan, ctanf, ctanl" description: "API reference for ctan, ctanf, and ctanl; which retrieve the tangent of a complex number." -ms.date: "11/04/2016" +ms.date: 11/04/2016 api_name: ["ctan", "ctanf", "ctanl"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll", "api-ms-win-crt-math-l1-1-0.dll"] api_type: ["DLLExport"] topic_type: ["apiref"] f1_keywords: ["ctan", "ctanf", "ctanl", "complex/ctan", "complex/ctanf", "complex/ctanl"] helpviewer_keywords: ["ctan function", "ctanf function", "ctanl function"] -ms.assetid: d3cbd25c-1e93-4a6d-8154-da42921f7223 --- # `ctan`, `ctanf`, `ctanl` @@ -56,7 +55,7 @@ Because C++ allows overloading, you can call overloads of **`ctan`** that take a | Routine | C header | C++ header | |---|---|---| -| **`ctan`**, **`ctanf`**, **`ctanl`** | \ | \ | +| **`ctan`**, **`ctanf`**, **`ctanl`** | \ | \ | For more compatibility information, see [Compatibility](../compatibility.md). diff --git a/docs/c-runtime-library/reference/ctime-ctime32-ctime64-wctime-wctime32-wctime64.md b/docs/c-runtime-library/reference/ctime-ctime32-ctime64-wctime-wctime32-wctime64.md index 0b2cc7c948b..3f03733bda5 100644 --- a/docs/c-runtime-library/reference/ctime-ctime32-ctime64-wctime-wctime32-wctime64.md +++ b/docs/c-runtime-library/reference/ctime-ctime32-ctime64-wctime-wctime32-wctime64.md @@ -8,7 +8,6 @@ api_type: ["DLLExport"] topic_type: ["apiref"] f1_keywords: ["_wctime64", "_ctime32", "_tctime", "_wctime", "_wctime32", "_tctime64", "_ctime64", "ctime"] helpviewer_keywords: ["tctime64 function", "_ctime32 function", "ctime32 function", "_wctime function", "wctime64 function", "_tctime64 function", "_tctime32 function", "_ctime64 function", "_wctime64 function", "ctime function", "wctime32 function", "ctime64 function", "_wctime32 function", "_tctime function", "tctime32 function", "tctime function", "wctime function", "time, converting"] -ms.assetid: 2423de37-a35c-4f0a-a378-3116bc120a9d --- # `ctime`, `_ctime32`, `_ctime64`, `_wctime`, `_wctime32`, `_wctime64` @@ -17,10 +16,10 @@ Convert a time value to a string and adjust for local time zone settings. More s ## Syntax ```C -char *ctime( const time_t *sourceTime ); +char *ctime( const time_t *sourceTime ); // See note in remarks section about linkage char *_ctime32( const __time32_t *sourceTime ); char *_ctime64( const __time64_t *sourceTime ); -wchar_t *_wctime( const time_t *sourceTime ); +wchar_t *_wctime( const time_t *sourceTime ); // See note in remarks section about linkage wchar_t *_wctime32( const __time32_t *sourceTime ); wchar_t *_wctime64( const __time64_t *sourceTime ); ``` @@ -62,9 +61,14 @@ These functions validate their parameters. If *`sourceTime`* is a null pointer, By default, this function's global state is scoped to the application. To change this behavior, see [Global state in the CRT](../global-state.md). +> [!Note] +> When you use Windows SDK version 10.0.26100.6901 and Visual Studio 2026 or later together, `ctime` and `_wctime` are no longer `static inline` (internal linkage). Instead, they're `inline` (external linkage).\ +> To return to the previous behavior, `#define _STATIC_INLINE_UCRT_FUNCTIONS=1` before including any CRT headers. By default, `_STATIC_INLINE_UCRT_FUNCTIONS` is set to 0.\ +> This change increases UCRT conformance with the C++ standard and improves compatibility with C++ modules. + ### Generic-text routine mappings -| TCHAR.H routine | `_UNICODE` and `_MBCS` not defined | `_MBCS` defined | `_UNICODE` defined | +| `TCHAR.H` routine | `_UNICODE` and `_MBCS` not defined | `_MBCS` defined | `_UNICODE` defined | |---|---|---|---| | `_tctime` | **`ctime`** | **`ctime`** | **`_wctime`** | | `_tctime32` | **`_ctime32`** | **`_ctime32`** | **`_wctime32`** | @@ -74,12 +78,12 @@ By default, this function's global state is scoped to the application. To change | Routine | Required header | |---|---| -| **`ctime`** | \ | -| **`_ctime32`** | \ | -| **`_ctime64`** | \ | -| **`_wctime`** | \ or \ | -| **`_wctime32`** | \ or \ | -| **`_wctime64`** | \ or \ | +| **`ctime`** | `` | +| **`_ctime32`** | `` | +| **`_ctime64`** | `` | +| **`_wctime`** | `` or `` | +| **`_wctime32`** | `` or `` | +| **`_wctime64`** | `` or `` | For more compatibility information, see [Compatibility](../compatibility.md). diff --git a/docs/c-runtime-library/reference/ctime-s-ctime32-s-ctime64-s-wctime-s-wctime32-s-wctime64-s.md b/docs/c-runtime-library/reference/ctime-s-ctime32-s-ctime64-s-wctime-s-wctime32-s-wctime64-s.md index efbd48aaa0d..12965dc90e2 100644 --- a/docs/c-runtime-library/reference/ctime-s-ctime32-s-ctime64-s-wctime-s-wctime32-s-wctime64-s.md +++ b/docs/c-runtime-library/reference/ctime-s-ctime32-s-ctime64-s-wctime-s-wctime32-s-wctime64-s.md @@ -1,14 +1,13 @@ --- -description: "Learn more about: ctime_s, _ctime32_s, _ctime64_s, _wctime_s, _wctime32_s, _wctime64_s" title: "ctime_s, _ctime32_s, _ctime64_s, _wctime_s, _wctime32_s, _wctime64_s" -ms.date: "4/2/2020" +description: "Learn more about: ctime_s, _ctime32_s, _ctime64_s, _wctime_s, _wctime32_s, _wctime64_s" +ms.date: 4/2/2020 api_name: ["_ctime64_s", "_wctime32_s", "ctime_s", "_wctime64_s", "_ctime32_s", "_wctime_s", "_o__ctime32_s", "_o__ctime64_s", "_o__wctime32_s", "_o__wctime64_s"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll", "api-ms-win-crt-time-l1-1-0.dll"] api_type: ["DLLExport"] topic_type: ["apiref"] f1_keywords: ["ctime64_s", "_ctime32_s", "_tctime32_s", "_ctime64_s", "_wctime_s", "_tctime_s", "_tctime64_s", "ctime_s", "ctime32_s"] helpviewer_keywords: ["_wctime32_s function", "ctime64_s function", "_tctime64_s function", "_wctime_s function", "tctime_s function", "_wctime64_s function", "ctime_s function", "ctime32_s function", "_ctime64_s function", "tctime64_s function", "wctime64_s function", "wctime_s function", "_tctime_s function", "tctime32_s function", "wctime32_s function", "time, converting", "_ctime32_s function", "_tctime32_s function"] -ms.assetid: 36ac419a-8000-4389-9fd8-d78b747a009b --- # `ctime_s`, `_ctime32_s`, `_ctime64_s`, `_wctime_s`, `_wctime32_s`, `_wctime64_s` @@ -17,7 +16,7 @@ Convert a time value to a string and adjust for local time zone settings. These ## Syntax ```C -errno_t ctime_s( +errno_t ctime_s( // See note in remarks section about linkage char* buffer, size_t numberOfElements, const time_t *sourceTime @@ -30,9 +29,9 @@ errno_t _ctime32_s( errno_t _ctime64_s( char* buffer, size_t numberOfElements, - const __time64_t *sourceTime ) -; -errno_t _wctime_s( + const __time64_t *sourceTime +); +errno_t _wctime_s( // See note in remarks section about linkage wchar_t* buffer, size_t numberOfElements, const time_t *sourceTime @@ -125,6 +124,11 @@ The debug library versions of these functions first fill the buffer with 0xFE. T By default, this function's global state is scoped to the application. To change this behavior, see [Global state in the CRT](../global-state.md). +> [!Note] +> When you use Windows SDK version 10.0.26100.6901 and Visual Studio 2026 or later together, `ctime_s` and `_wctime_s` are no longer `static inline` (internal linkage). Instead, they're `inline` (external linkage).\ +> To return to the previous behavior, `#define _STATIC_INLINE_UCRT_FUNCTIONS=1` before including any CRT headers. By default, `_STATIC_INLINE_UCRT_FUNCTIONS` is set to 0.\ +> This change increases UCRT conformance with the C++ standard and improves compatibility with C++ modules. + ### Generic-text routine mappings | TCHAR.H routine | `_UNICODE` and `_MBCS` not defined | `_MBCS` defined | `_UNICODE` defined | diff --git a/docs/c-runtime-library/reference/cwait.md b/docs/c-runtime-library/reference/cwait.md index aeaaad8adc5..4f2d069a7c6 100644 --- a/docs/c-runtime-library/reference/cwait.md +++ b/docs/c-runtime-library/reference/cwait.md @@ -1,14 +1,13 @@ --- title: "_cwait" description: "API reference for the Microsoft Visual C runtime `_cwait()` function." -ms.date: "10/23/2020" +ms.date: 10/23/2020 api_name: ["_cwait", "_o__cwait"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll", "api-ms-win-crt-process-l1-1-0.dll"] api_type: ["DLLExport"] topic_type: ["apiref"] f1_keywords: ["_cwait"] helpviewer_keywords: ["cwait function", "_cwait function"] -ms.assetid: d9b596b5-45f4-4e03-9896-3f383cb922b8 --- # `_cwait` @@ -73,7 +72,6 @@ For more compatibility information, see [Compatibility](../compatibility.md). ```C // crt_cwait.c -// compile with: /c // This program launches several processes and waits // for a specified process to finish. diff --git a/docs/c-runtime-library/reference/cxxthrowexception.md b/docs/c-runtime-library/reference/cxxthrowexception.md index 1bad3b4dd00..2a2a3b87b6f 100644 --- a/docs/c-runtime-library/reference/cxxthrowexception.md +++ b/docs/c-runtime-library/reference/cxxthrowexception.md @@ -1,6 +1,6 @@ --- -description: "Learn more about: _CxxThrowException" title: "_CxxThrowException" +description: "Learn more about: _CxxThrowException" ms.date: "11/04/2016" api_name: ["_CxxThrowException"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll"] @@ -8,7 +8,6 @@ api_type: ["DLLExport"] topic_type: ["apiref"] f1_keywords: ["CxxThrowException", "_CxxThrowException"] helpviewer_keywords: ["_CxxThrowException function", "CxxThrowException function"] -ms.assetid: 0b90bef5-b7d2-46e0-88e2-59e531e01a4d --- # `_CxxThrowException` @@ -18,7 +17,7 @@ Builds the exception record and calls the runtime environment to start processin ```C extern "C" void __stdcall _CxxThrowException( - void* pExceptionObject + void* pExceptionObject, _ThrowInfo* pThrowInfo ); ``` diff --git a/docs/c-runtime-library/reference/difftime-difftime32-difftime64.md b/docs/c-runtime-library/reference/difftime-difftime32-difftime64.md index b5825758e25..b1512299fa8 100644 --- a/docs/c-runtime-library/reference/difftime-difftime32-difftime64.md +++ b/docs/c-runtime-library/reference/difftime-difftime32-difftime64.md @@ -8,7 +8,6 @@ api_type: ["DLLExport"] topic_type: ["apiref"] f1_keywords: ["_difftime64", "difftime", "difftime64", "_difftime32", "difftime32"] helpviewer_keywords: ["_difftime32 function", "difftime function", "time, finding the difference", "difftime64 function", "_difftime64 function", "difftime32 function"] -ms.assetid: 4cc0ac2b-fc7b-42c0-8283-8c9d10c566d0 --- # `difftime`, `_difftime32`, `_difftime64` @@ -17,7 +16,7 @@ Finds the difference between two times. ## Syntax ```C -double difftime( time_t timeEnd, time_t timeStart ); +double difftime( time_t timeEnd, time_t timeStart ); // See note in remarks section about linkage double _difftime32( __time32_t timeEnd, __time32_t timeStart ); double _difftime64( __time64_t timeEnd, __time64_t timeStart ); ``` @@ -46,13 +45,18 @@ These functions validate their parameters. If either of the parameters is zero o By default, this function's global state is scoped to the application. To change this behavior, see [Global state in the CRT](../global-state.md). +> [!Note] +> If you use Windows SDK version 10.0.26100.6901 and Visual Studio 2026 or later together, `difftime` is no longer `static inline` (internal linkage). Instead, it's `inline` (external linkage).\ +> To return to the previous behavior, `#define _STATIC_INLINE_UCRT_FUNCTIONS=1` before including any CRT headers. By default, `_STATIC_INLINE_UCRT_FUNCTIONS` is set to 0.\ +> This change increases UCRT conformance with the C++ standard and improves compatibility with C++ modules. + ## Requirements | Routine | Required header | |---|---| -| **`difftime`** | \ | -| **`_difftime32`** | \ | -| **`_difftime64`** | \ | +| **`difftime`** | `` | +| **`_difftime32`** | `` | +| **`_difftime64`** | `` | For more compatibility information, see [Compatibility](../compatibility.md). diff --git a/docs/c-runtime-library/reference/dupenv-s-dbg-wdupenv-s-dbg.md b/docs/c-runtime-library/reference/dupenv-s-dbg-wdupenv-s-dbg.md index cfc0b250e27..047aba34af6 100644 --- a/docs/c-runtime-library/reference/dupenv-s-dbg-wdupenv-s-dbg.md +++ b/docs/c-runtime-library/reference/dupenv-s-dbg-wdupenv-s-dbg.md @@ -1,6 +1,6 @@ --- -description: "Learn more about: _dupenv_s_dbg, _wdupenv_s_dbg" title: "_dupenv_s_dbg, _wdupenv_s_dbg" +description: "Learn more about: _dupenv_s_dbg, _wdupenv_s_dbg" ms.date: "11/04/2016" api_name: ["_dupenv_s_dbg", "_wdupenv_s_dbg"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll"] @@ -8,7 +8,6 @@ api_type: ["DLLExport"] topic_type: ["apiref"] f1_keywords: ["_tdupenv_s_dbg", "_dupenv_s_dbg", "_wdupenv_s_dbg"] helpviewer_keywords: ["_tdupenv_s_dbg function", "dupenv_s_dbg function", "_wdupenv_s_dbg function", "environment variables", "tdupenv_s_dbg function", "wdupenv_s_dbg function", "_dupenv_s_dbg function"] -ms.assetid: e3d81148-e24e-46d0-a21d-fd87b5e6256c --- # `_dupenv_s_dbg`, `_wdupenv_s_dbg` @@ -88,7 +87,7 @@ For more compatibility information, see [Compatibility](../compatibility.md). ```C // crt_dupenv_s_dbg.c -#include +#include #include int main( void ) diff --git a/docs/c-runtime-library/reference/dupenv-s-wdupenv-s.md b/docs/c-runtime-library/reference/dupenv-s-wdupenv-s.md index e0d4242db21..da9fb11032a 100644 --- a/docs/c-runtime-library/reference/dupenv-s-wdupenv-s.md +++ b/docs/c-runtime-library/reference/dupenv-s-wdupenv-s.md @@ -1,6 +1,6 @@ --- -description: "Learn more about: _dupenv_s, _wdupenv_s" title: "_dupenv_s, _wdupenv_s" +description: "Learn more about: _dupenv_s, _wdupenv_s" ms.date: "4/2/2020" api_name: ["_dupenv_s", "_wdupenv_s", "_o__dupenv_s", "_o__wdupenv_s"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll", "api-ms-win-crt-environment-l1-1-0.dll"] @@ -8,7 +8,6 @@ api_type: ["DLLExport"] topic_type: ["apiref"] f1_keywords: ["tdupenv_s", "_dupenv_s", "wdupenv_s", "dupenv_s", "_tdupenv_s", "_wdupenv_s"] helpviewer_keywords: ["_dupenv_s function", "_tdupenv_s function", "_wdupenv_s function", "environment variables", "wdupenv_s function", "dupenv_s function", "tdupenv_s function"] -ms.assetid: b729ecc2-a31d-4ccf-92a7-5accedb8f8c8 --- # `_dupenv_s`, `_wdupenv_s` @@ -89,7 +88,7 @@ For more compatibility information, see [Compatibility](../compatibility.md). ```C // crt_dupenv_s.c -#include +#include int main( void ) { diff --git a/docs/c-runtime-library/reference/erf-erff-erfl-erfc-erfcf-erfcl.md b/docs/c-runtime-library/reference/erf-erff-erfl-erfc-erfcf-erfcl.md index ebc5633b223..84e447fee52 100644 --- a/docs/c-runtime-library/reference/erf-erff-erfl-erfc-erfcf-erfcl.md +++ b/docs/c-runtime-library/reference/erf-erff-erfl-erfc-erfcf-erfcl.md @@ -1,14 +1,13 @@ --- title: "erf, erff, erfl, erfc, erfcf, erfcl" description: "API reference for erf, erff, erfl, erfc, erfcf, and erfcl; which computes the error function or the complementary error function of a value." -ms.date: "9/1/2020" +ms.date: 9/1/2020 api_name: ["erff", "erfl", "erf", "erfc", "erfcf", "erfcl", "_o_erf", "_o_erfc", "_o_erfcf", "_o_erfcl", "_o_erff", "_o_erfl"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll", "api-ms-win-crt-math-l1-1-0.dll"] api_type: ["DLLExport"] topic_type: ["apiref"] f1_keywords: ["erfl", "erf", "erff", "erfc", "erfcf", "erfcl"] helpviewer_keywords: ["erfl function", "erff function", "erf function", "erfcl function", "erfcf function", "erfc function"] -ms.assetid: 144d90d3-e437-41c2-a659-cd57596023b5 --- # `erf`, `erff`, `erfl`, `erfc`, `erfcf`, `erfcl` @@ -47,8 +46,8 @@ float erfcf( long double erfcl( long double x ); -#define erf(X) // Requires C11 or higher -#define erfc(X) // Requires C11 or higher +#define erf(X) // Requires C11 or later +#define erfc(X) // Requires C11 or later ``` ### Parameters diff --git a/docs/c-runtime-library/reference/exit-exit-exit.md b/docs/c-runtime-library/reference/exit-exit-exit.md index 1ad98c4dc50..1736f05b272 100644 --- a/docs/c-runtime-library/reference/exit-exit-exit.md +++ b/docs/c-runtime-library/reference/exit-exit-exit.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: exit, _Exit, _exit" title: "exit, _Exit, _exit" -ms.date: "4/2/2020" +description: "Learn more about: exit, _Exit, _exit" +ms.date: 4/2/2020 api_name: ["_exit", "exit", "_o__exit", "_o_exit"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll", "api-ms-win-crt-runtime-l1-1-0.dll"] api_type: ["DLLExport"] @@ -14,7 +14,7 @@ helpviewer_keywords: ["exit function", "_exit function", "processes, terminating Terminates the calling process. The **`exit`** function terminates it after cleanup; **`_exit`** and **`_Exit`** terminate it immediately. > [!NOTE] -> Do not use this method to shut down a Universal Windows Platform (UWP) app, except in testing or debugging scenarios. Programmatic or UI ways to close a Store app are not permitted according to the [Microsoft Store policies](/legal/windows/agreements/store-policies). For more information, see [UWP app lifecycle](/windows/uwp/launch-resume/app-lifecycle). For more information about UWP apps, see [Universal Windows Platform documentation](https://developer.microsoft.com/windows/apps). +> Do not use this method to shut down a Universal Windows Platform (UWP) app, except in testing or debugging scenarios. Programmatic or UI ways to close a Store app are not permitted according to the [Microsoft Store policies](/windows/apps/publish/store-policies). For more information, see [UWP app lifecycle](/windows/uwp/launch-resume/app-lifecycle). For more information about UWP apps, see [Universal Windows Platform documentation](https://developer.microsoft.com/windows/apps). ## Syntax @@ -52,7 +52,7 @@ The **`exit`**, **`_Exit`**, **`_exit`**, **`quick_exit`**, **`_cexit`**, and ** | **`_cexit`** | Performs complete C library termination procedures and returns to the caller. Doesn't terminate the process. | | **`_c_exit`** | Performs minimal C library termination procedures and returns to the caller. Doesn't terminate the process. | -When you call the **`exit`**, **`_Exit`** or **`_exit`** function, the destructors for any temporary or automatic objects that exist at the time of the call aren't called. An automatic object is a non-static local object defined in a function. A temporary object is an object that's created by the compiler, such as a value returned by a function call. To destroy an automatic object before you call **`exit`**, **`_Exit`**, or **`_exit`**, explicitly call the destructor for the object, as shown here: +When you call the **`exit`**, **`_Exit`** or **`_exit`** function, the destructors for any temporary or automatic objects that exist at the time of the call aren't called. An automatic object is a non-static local object defined in a function. A temporary object is an object that's created by the compiler, such as a value returned by a function call. To destroy an automatic object before you call **`exit`**, **`_Exit`**, or **`_exit`**, explicitly call the destructor for the object, as shown here: ```cpp void last_fn() {} diff --git a/docs/c-runtime-library/reference/exp-expf.md b/docs/c-runtime-library/reference/exp-expf.md index ca4498aea02..b79dcacd4c9 100644 --- a/docs/c-runtime-library/reference/exp-expf.md +++ b/docs/c-runtime-library/reference/exp-expf.md @@ -1,7 +1,7 @@ --- title: "exp, expf, expl" description: "API reference for exp, expf, and expl; which calculate the exponential." -ms.date: "1/15/2021" +ms.date: 1/15/2021 api_name: ["expf", "expl", "exp", "_o_exp", "_o_expf"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll", "api-ms-win-crt-math-l1-1-0.dll"] api_type: ["DLLExport"] @@ -31,7 +31,7 @@ float expf( long double expl( long double x ); -#define exp(z) // Requires C11 or higher +#define exp(z) // Requires C11 or later ``` ### Parameters diff --git a/docs/c-runtime-library/reference/exp2-exp2f-exp2l.md b/docs/c-runtime-library/reference/exp2-exp2f-exp2l.md index b2d84ff6084..472d0cd5ce2 100644 --- a/docs/c-runtime-library/reference/exp2-exp2f-exp2l.md +++ b/docs/c-runtime-library/reference/exp2-exp2f-exp2l.md @@ -1,14 +1,13 @@ --- title: "exp2, exp2f, exp2l" description: "API ref for exp2(), exp2f(), and exp2l() which compute 2 raised to the specified value." -ms.date: "9/1/2020" +ms.date: 9/1/2020 api_name: ["exp2", "exp2f", "exp2l", "_o_exp2", "_o_exp2f", "_o_exp2l"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll", "api-ms-win-crt-math-l1-1-0.dll"] api_type: ["DLLExport"] topic_type: ["apiref"] f1_keywords: ["exp2", "math/exp2", "exp2f", "math/exp2f", "exp2l", "math/exp2l"] helpviewer_keywords: ["exp2 function", "exp2f function", "exp2l function"] -ms.assetid: 526e3e10-201a-4610-a886-533f44ece344 --- # `exp2`, `exp2f`, `exp2l` @@ -36,7 +35,7 @@ float exp2f( long double exp2l( long double x ); -#define exp2(X) // Requires C11 or higher +#define exp2(X) // Requires C11 or later ``` ### Parameters @@ -79,5 +78,5 @@ For more compatibility information, see [Compatibility](../compatibility.md). ## See also [Alphabetical function reference](crt-alphabetical-function-reference.md)\ -[`exp`, `expf`, `expl`](exp-expf.md) +[`exp`, `expf`, `expl`](exp-expf.md)\ [`log2`, `log2f`, `log2l`](log2-log2f-log2l.md) diff --git a/docs/c-runtime-library/reference/expand-dbg.md b/docs/c-runtime-library/reference/expand-dbg.md index 5998a4195c7..04f87e4d632 100644 --- a/docs/c-runtime-library/reference/expand-dbg.md +++ b/docs/c-runtime-library/reference/expand-dbg.md @@ -1,14 +1,13 @@ --- -description: "Learn more about: _expand_dbg" title: "_expand_dbg" -ms.date: "11/04/2016" +description: "Learn more about: _expand_dbg" +ms.date: 11/04/2016 api_name: ["_expand_dbg"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll"] api_type: ["DLLExport"] topic_type: ["apiref"] f1_keywords: ["expand_dbg", "_expand_dbg"] helpviewer_keywords: ["memory blocks, changing size", "expand_dbg function", "_expand_dbg function"] -ms.assetid: dc58c91f-72a8-48c6-b643-fe130fb6c1fd --- # `_expand_dbg` @@ -51,7 +50,7 @@ On successful completion, **`_expand_dbg`** returns a pointer to the resized mem ## Remarks -The **`_expand_dbg`** function is a debug version of the _[`expand`](expand.md) function. When [`_DEBUG`](../debug.md) isn't defined, each call to **`_expand_dbg`** is reduced to a call to `_expand`. Both `_expand` and **`_expand_dbg`** resize a memory block in the base heap, but **`_expand_dbg`** accommodates several debugging features: buffers on either side of the user portion of the block to test for leaks, a block type parameter to track specific allocation types, and *`filename`*/*`lineNumber`* information to determine the origin of allocation requests. +The **`_expand_dbg`** function is a debug version of the [`_expand`](expand.md) function. When [`_DEBUG`](../debug.md) isn't defined, each call to **`_expand_dbg`** is reduced to a call to `_expand`. Both `_expand` and **`_expand_dbg`** resize a memory block in the base heap, but **`_expand_dbg`** accommodates several debugging features: buffers on either side of the user portion of the block to test for leaks, a block type parameter to track specific allocation types, and *`filename`*/*`lineNumber`* information to determine the origin of allocation requests. **`_expand_dbg`** resizes the specified memory block with slightly more space than the requested *`newSize`*. *`newSize`* might be greater or less than the size of the originally allocated memory block. The extra space is used by the debug heap manager to link the debug memory blocks and to provide the application with debug header information and overwrite buffers. The resize is accomplished by either expanding or contracting the original memory block. **`_expand_dbg`** doesn't move the memory block, as does the [`_realloc_dbg`](realloc-dbg.md) function. diff --git a/docs/c-runtime-library/reference/expm1-expm1f-expm1l.md b/docs/c-runtime-library/reference/expm1-expm1f-expm1l.md index 838790997cb..7afd9844a3b 100644 --- a/docs/c-runtime-library/reference/expm1-expm1f-expm1l.md +++ b/docs/c-runtime-library/reference/expm1-expm1f-expm1l.md @@ -1,14 +1,13 @@ --- title: "expm1, expm1f, expm1l" description: "API reference for expm1, expm1f, and expm1; which compute the base-e exponential of a value, minus one." -ms.date: "9/1/2020" +ms.date: 9/1/2020 api_name: ["expm1l", "expm1", "expm1f"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll", "api-ms-win-crt-math-l1-1-0.dll"] api_type: ["DLLExport"] topic_type: ["apiref"] f1_keywords: ["expm1l", "expm1", "expm1f"] helpviewer_keywords: ["expm1f function", "expm1l function", "expm1 function"] -ms.assetid: 2a4dd2d9-370c-42b0-9067-0625efa272e0 --- # `expm1`, `expm1f`, `expm1l` @@ -32,7 +31,7 @@ float expm1f( long double expm1l( long double x ); -#define expm1(X) // Requires C11 or higher +#define expm1(X) // Requires C11 or later ``` ### Parameters diff --git a/docs/c-runtime-library/reference/fabs-fabsf-fabsl.md b/docs/c-runtime-library/reference/fabs-fabsf-fabsl.md index 99d52e6c877..541221d8f91 100644 --- a/docs/c-runtime-library/reference/fabs-fabsf-fabsl.md +++ b/docs/c-runtime-library/reference/fabs-fabsf-fabsl.md @@ -1,12 +1,12 @@ --- title: "fabs, fabsf, fabsl" description: "API reference for fabs, fabsf, and fabsl; which calculate the absolute value of a floating-point value." -ms.date: "1/15/2021" +ms.date: 1/15/2021 api_name: ["fabsf", "fabs", "fabsl", "_o_fabs", "_o_fabsf"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll", "api-ms-win-crt-math-l1-1-0.dll"] api_type: ["DLLExport"] topic_type: ["apiref"] -f1_keywords: ["fabs", "fabsf", "fabsl", "math\fabs", "math\fabsf", "math\fabsl"] +f1_keywords: ["fabs", "fabsf", "fabsl", "math/fabs", "math/fabsf", "math/fabsl"] helpviewer_keywords: ["absolute values", "fabsf function", "calculating absolute values", "fabs function", "fabsl function"] --- # `fabs`, `fabsf`, `fabsl` @@ -32,7 +32,7 @@ long double fabsl( long double x ); -#define fabs(X) // Requires C11 or higher +#define fabs(X) // Requires C11 or later ``` ### Parameters diff --git a/docs/c-runtime-library/reference/fdim-fdimf-fdiml.md b/docs/c-runtime-library/reference/fdim-fdimf-fdiml.md index 89145b12af3..7b408b24326 100644 --- a/docs/c-runtime-library/reference/fdim-fdimf-fdiml.md +++ b/docs/c-runtime-library/reference/fdim-fdimf-fdiml.md @@ -1,7 +1,7 @@ --- title: "fdim, fdimf, fdiml" description: "API reference for fdim, fdimf, and fdiml; which determines the positive difference between two values." -ms.date: "9/1/2020" +ms.date: 9/1/2020 api_name: ["fdim", "fdimf", "fdiml"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll", "api-ms-win-crt-math-l1-1-0.dll"] api_type: ["DLLExport"] @@ -41,7 +41,7 @@ long double fdiml( long double y ); -#define fdim(X) // Requires C11 or higher +#define fdim(X) // Requires C11 or later ``` ### Parameters diff --git a/docs/c-runtime-library/reference/floating-point-ordering.md b/docs/c-runtime-library/reference/floating-point-ordering.md index ece44b97be9..acdf45961dc 100644 --- a/docs/c-runtime-library/reference/floating-point-ordering.md +++ b/docs/c-runtime-library/reference/floating-point-ordering.md @@ -1,6 +1,6 @@ --- -description: "Learn more about: isgreater, isgreaterequal, isless, islessequal, islessgreater, isunordered" title: "isgreater, isgreaterequal, isless, islessequal, islessgreater, isunordered" +description: "Learn more about: isgreater, isgreaterequal, isless, islessequal, islessgreater, isunordered" ms.date: "01/31/2019" f1_keywords: ["isgreater", "math/isgreater", "isgreaterequal", "math/isgreaterequal", "isless", "math/isless", "islessequal", "math/islessequal", "islessgreater", "math/islessgreater", "isunordered", "math/isunordered"] helpviewer_keywords: ["isgreater function", "isgreaterequal function", "isless function", "islessequal function", "islessgreater function", "isunordered function"] @@ -43,7 +43,7 @@ int isunordered( ); /* C-only macro */ ``` -```C++ +```cpp template inline bool isgreater( FloatingType1 x, diff --git a/docs/c-runtime-library/reference/floating-point-primitives.md b/docs/c-runtime-library/reference/floating-point-primitives.md index 27f5ef5e1fa..965ac7ec2db 100644 --- a/docs/c-runtime-library/reference/floating-point-primitives.md +++ b/docs/c-runtime-library/reference/floating-point-primitives.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: Floating-point primitives" title: "Floating-point primitives" -ms.date: "4/2/2020" +description: "Learn more about: Floating-point primitives" +ms.date: 4/2/2020 api_name: ["_dclass", "_ldclass", "_fdclass", "_dsign", "_ldsign", "_fdsign", "_dpcomp", "_ldpcomp", "_fdpcomp", "_dtest", "_ldtest", "_fdtest", "_d_int", "_ld_int", "_fd_int", "_dscale", "_ldscale", "_fdscale", "_dunscale", "_ldunscale", "_fdunscale", "_dexp", "_ldexp", "_fdexp", "_dnorm", "_fdnorm", "_dpoly", "_ldpoly", "_fdpoly", "_dlog", "_ldlog", "_fdlog", "_dsin", "_ldsin", "_fdsin", "_o__d_int", "_o__dclass", "_o__dlog", "_o__dnorm", "_o__dpcomp", "_o__dpoly", "_o__dscale", "_o__dsign", "_o__dsin", "_o__dtest", "_o__dunscale", "_o__fd_int", "_o__fdclass", "_o__fdexp", "_o__fdlog", "_o__fdpcomp", "_o__fdpoly", "_o__fdscale", "_o__fdsign", "_o__fdsin", "_o__ld_int", "_o__ldclass", "_o__ldexp", "_o__ldlog", "_o__ldpcomp", "_o__ldpoly", "_o__ldscale", "_o__ldsign", "_o__ldsin", "_o__ldtest", "_o__ldunscale"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll", "api-ms-win-crt-math-l1-1-0.dll"] api_type: ["DLLExport"] @@ -32,7 +32,7 @@ Floating-point function argument. ### Remarks -These floating-point primitives implement the C versions of the CRT macro [`fpclassify`](fpclassify.md) for floating-point types. The classification of the argument *`x`* is returned as one of these constants, defined in math.h: +These floating-point primitives implement the C versions of the CRT macro [`fpclassify`](fpclassify.md) for floating-point types. The classification of the argument *`x`* is returned as one of these constants, defined in `math.h`: | Value | Description | |---|---| @@ -63,7 +63,7 @@ Floating-point function argument. These floating-point primitives implement the [`signbit`](signbit.md) macro or function in the CRT. They return a non-zero value if the sign bit is set in the significand (mantissa) of the argument *`x`*. Otherwise, they return 0 if the sign bit isn't set. -## _dpcomp, _ldpcomp, _fdpcomp +## `_dpcomp`, `_ldpcomp`, `_fdpcomp` ### Syntax @@ -80,7 +80,7 @@ Floating-point function arguments. ### Remarks -These floating-point primitives take two arguments, *`x`* and *`y`*, and return a value that shows their ordering relationship, expressed as the bitwise or of these constants, defined in math.h: +These floating-point primitives take two arguments, *`x`* and *`y`*, and return a value that shows their ordering relationship, expressed as the bitwise or of these constants, defined in `math.h`: | Value | Description | |------------|-----------------| @@ -90,7 +90,7 @@ These floating-point primitives take two arguments, *`x`* and *`y`*, and return These primitives implement the [`isgreater`, `isgreaterequal`, `isless`, `islessequal`, `islessgreater`, and `isunordered`](floating-point-ordering.md) macros and functions in the CRT. -## _dtest, _ldtest, _fdtest +## `_dtest`, `_ldtest`, `_fdtest` ### Syntax @@ -107,7 +107,7 @@ Pointer to a floating-point argument. ### Remarks -These floating-point primitives implement the C++ versions of the CRT function [`fpclassify`](fpclassify.md) for floating-point types. The argument *`x`* is evaluated and the classification is returned as one of these constants, defined in math.h: +These floating-point primitives implement the C++ versions of the CRT function [`fpclassify`](fpclassify.md) for floating-point types. The argument *`x`* is evaluated and the classification is returned as one of these constants, defined in `math.h`: | Value | Description | |---|---| @@ -119,7 +119,7 @@ These floating-point primitives implement the C++ versions of the CRT function [ For more detail, you can use the Microsoft-specific [`_fpclass`, `_fpclassf`](fpclass-fpclassf.md) functions. Use the [`fpclassify`](fpclassify.md) function for portability. -## _d_int, _ld_int, _fd_int +## `_d_int`, `_ld_int`, `_fd_int` ### Syntax @@ -141,7 +141,7 @@ An exponent as an integral type. These floating-point primitives take a pointer to a floating-point value *`px`* and an exponent value *`exp`*, and remove the fractional part of the floating-point value below the given exponent, if possible. The value returned is the result of `fpclassify` on the input value in *`px`* if it's a NaN or infinity, and on the output value in *`px`* otherwise. -## _dscale, _ldscale, _fdscale +## `_dscale`, `_ldscale`, `_fdscale` ### Syntax @@ -163,7 +163,7 @@ An exponent as an integral type. These floating-point primitives take a pointer to a floating-point value *`px`* and an exponent value *`exp`*, and scale the value in *`px`* by 2*`exp`*, if possible. The value returned is the result of `fpclassify` on the input value in *`px`* if it's a NaN or infinity, and on the output value in *`px`* otherwise. For portability, prefer the [`ldexp`, `ldexpf`, `ldexpl`](ldexp.md) functions. -## _dunscale, _ldunscale, _fdunscale +## `_dunscale`, `_ldunscale`, `_fdunscale` ### Syntax @@ -185,7 +185,7 @@ Pointer to a floating-point argument. These floating-point primitives break down the floating-point value pointed at by *`px`* into a significand (mantissa) and an exponent, if possible. The significand is scaled such that the absolute value is greater than or equal to 0.5 and less than 1.0. The exponent is the value *`n`*, where the original floating-point value is equal to the scaled significand times 2n. This integer exponent *`n`* is stored at the location pointed to by *`pexp`*. The value returned is the result of `fpclassify` on the input value in *`px`* if it's a NaN or infinity, and on the output value otherwise. For portability, prefer the [`frexp`, `frexpf`, `frexpl`](frexp.md) functions. -## _dexp, _ldexp, _fdexp +## `_dexp`, `_ldexp`, `_fdexp` ### Syntax @@ -210,7 +210,7 @@ An exponent as an integral type. These floating-point primitives construct a floating-point value in the location pointed at by *`px`* equal to *`y`* * 2exp. The value returned is the result of `fpclassify` on the input value in *`y`* if it's a NaN or infinity, and on the output value in *`px`* otherwise. For portability, prefer the [`ldexp`, `ldexpf`, `ldexpl`](ldexp.md) functions. -## _dnorm, _fdnorm +## `_dnorm`, `_fdnorm` ### Syntax @@ -226,16 +226,16 @@ Pointer to the bitwise representation of a floating-point value expressed as an ### Remarks -These floating-point primitives normalize the fractional part of an underflowed floating-point value and adjust the *characteristic*, or biased exponent, to match. The value is passed as the bitwise representation of the floating-point type converted to an array of **`unsigned short`** through the `_double_val`, `_ldouble_val`, or `_float_val` type-punning union declared in math.h. The return value is the result of `fpclassify` on the input floating-point value if it's a NaN or infinity, and on the output value otherwise. +These floating-point primitives normalize the fractional part of an underflowed floating-point value and adjust the *characteristic*, or biased exponent, to match. The value is passed as the bitwise representation of the floating-point type converted to an array of **`unsigned short`** through the `_double_val`, `_ldouble_val`, or `_float_val` type-punning union declared in `math.h`. The return value is the result of `fpclassify` on the input floating-point value if it's a NaN or infinity, and on the output value otherwise. -## _dpoly, _ldpoly, _fdpoly +## `_dpoly`, `_ldpoly`, `_fdpoly` ### Syntax ```C double __cdecl _dpoly(double x, double const* table, int n); long double __cdecl _ldpoly(long double x, long double const* table, int n); -float __cdecl _fdpoly(float x, _float const* table, int n); +float __cdecl _fdpoly(float x, float const* table, int n); ``` ### Parameters @@ -253,7 +253,7 @@ Order of the polynomial to evaluate. These floating-point primitives return the evaluation of *`x`* in the polynomial of order *`n`* whose coefficients are represented by the corresponding constant values in *`table`*. For example, if *`table[0]`* = 3.0, *`table[1]`* = 4.0, *`table[2]`* = 5.0, and *`n`* = 2, it represents the polynomial 5.0x2 + 4.0x + 3.0. If this polynomial is evaluated for *`x`* of 2.0, the result is 31.0. These functions aren't used internally. -## _dlog, _dlog, _dlog +## `_dlog`, `_ldlog`, `_fdlog` ### Syntax @@ -275,7 +275,7 @@ Flag that controls the base to use, 0 for base *e* and non-zero for base 10. These floating-point primitives return the natural log of *`x`* (ln(x) or log*e*(x)), when *`base_flag`* is 0. They return the log base 10 of *`x`*, or log10(x), when *`base_flag`* is non-zero. These functions aren't used internally. For portability, prefer the functions [`log`, `logf`, `logl`, `log10`, `log10f`, and `log10l`](log-logf-log10-log10f.md). -## _dsin, _ldsin, _fdsin +## `_dsin`, `_ldsin`, `_fdsin` ### Syntax @@ -299,7 +299,7 @@ These floating-point primitives return the sine of *`x`* offset by the *`quadran ## Requirements -Header: \ +Header: `` For more compatibility information, see [Compatibility](../compatibility.md). diff --git a/docs/c-runtime-library/reference/floor-floorf-floorl.md b/docs/c-runtime-library/reference/floor-floorf-floorl.md index fda68075056..5e9997e6364 100644 --- a/docs/c-runtime-library/reference/floor-floorf-floorl.md +++ b/docs/c-runtime-library/reference/floor-floorf-floorl.md @@ -1,14 +1,13 @@ --- title: "floor, floorf, floorl" -description: "API reference for floor, floorf, and floorl; which calculates the floor of a value." -ms.date: "9/1/2020" +description: "API reference for floor, floorf, and floorl; which calculates the floor of a value." +ms.date: 9/1/2020 api_name: ["floorf", "floorl", "floor", "_o_floor", "_o_floorf"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll", "api-ms-win-crt-math-l1-1-0.dll"] api_type: ["DLLExport"] topic_type: ["apiref"] f1_keywords: ["floor", "floorl", "_floorl", "floorf"] helpviewer_keywords: ["floor function", "floorf function", "calculating floors of values", "floorl function"] -ms.assetid: e9955f70-d659-414f-8050-132e13c8ff36 --- # `floor`, `floorf`, `floorl` @@ -32,7 +31,7 @@ float floorf( long double floorl( long double x ); -#define floor(X) // Requires C11 or higher +#define floor(X) // Requires C11 or later ``` ### Parameters diff --git a/docs/c-runtime-library/reference/fma-fmaf-fmal.md b/docs/c-runtime-library/reference/fma-fmaf-fmal.md index 5c1d6f5f4b8..07f439ce48c 100644 --- a/docs/c-runtime-library/reference/fma-fmaf-fmal.md +++ b/docs/c-runtime-library/reference/fma-fmaf-fmal.md @@ -1,14 +1,13 @@ --- title: "fma, fmaf, fmal" description: "API reference for fma, fmaf, and fmal; which multiplies two values together, adds a third value, and then rounds the result, while only losing a small amount of precision due to intermediary rounding." -ms.date: "9/1/2020" +ms.date: 9/1/2020 api_name: ["fma", "fmaf", "fmal", "_o_fma", "_o_fmaf", "_o_fmal"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll", "api-ms-win-crt-math-l1-1-0.dll"] api_type: ["DLLExport"] topic_type: ["apiref"] f1_keywords: ["fma", "fmaf", "fmal", "math/fma", "math/fmaf", "math/fmal"] helpviewer_keywords: ["fma function", "fmaf function", "fmal function"] -ms.assetid: 584a6037-da1e-4e86-9f0c-97aae86de0c0 --- # `fma`, `fmaf`, `fmal` @@ -47,7 +46,7 @@ long double fmal( long double z ); -#define fma(X, Y, Z) // Requires C11 or higher +#define fma(X, Y, Z) // Requires C11 or later ``` ### Parameters diff --git a/docs/c-runtime-library/reference/fmax-fmaxf-fmaxl.md b/docs/c-runtime-library/reference/fmax-fmaxf-fmaxl.md index ccd942f6729..eac6d8411b6 100644 --- a/docs/c-runtime-library/reference/fmax-fmaxf-fmaxl.md +++ b/docs/c-runtime-library/reference/fmax-fmaxf-fmaxl.md @@ -1,14 +1,13 @@ --- title: "fmax, fmaxf, fmaxl" description: "API reference for fmax, fmaxf, and fmaxl; which determines the larger of two numeric values." -ms.date: "9/1/2020" +ms.date: 9/1/2020 api_name: ["fmax", "fmaxf", "fmaxl"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll", "api-ms-win-crt-math-l1-1-0.dll"] api_type: ["DLLExport"] topic_type: ["apiref"] f1_keywords: ["fmax", "fmaxf", "fmaxl", "math/fmax", "math/fmaxf", "math/fmaxl"] helpviewer_keywords: ["fmax function", "fmaxf function", "fmaxl function"] -ms.assetid: a773ccf7-495e-4a9a-8c6d-dfb53e341e35 --- # `fmax`, `fmaxf`, `fmaxl` @@ -42,7 +41,7 @@ long double fmaxl( long double y ); -#define fmax(X, Y) // Requires C11 or higher +#define fmax(X, Y) // Requires C11 or later ``` ### Parameters diff --git a/docs/c-runtime-library/reference/fmin-fminf-fminl.md b/docs/c-runtime-library/reference/fmin-fminf-fminl.md index e1b2093567d..d3cfee38cff 100644 --- a/docs/c-runtime-library/reference/fmin-fminf-fminl.md +++ b/docs/c-runtime-library/reference/fmin-fminf-fminl.md @@ -1,14 +1,13 @@ --- title: "fmin, fminf, fminl" description: "API reference for fmin, fminf, and fminl; which determines the smaller of two values." -ms.date: "9/1/2020" +ms.date: 9/1/2020 api_name: ["fmin", "fminf", "fminl"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll", "api-ms-win-crt-math-l1-1-0.dll"] api_type: ["DLLExport"] topic_type: ["apiref"] f1_keywords: ["fmin", "fminf", "fminl", "math/fmin", "math/fminf", "math/fminl"] helpviewer_keywords: ["fmin function", "fminf function", "fminl function"] -ms.assetid: 1916dfb5-99c1-4b0d-aefb-513525c3f2ac --- # `fmin`, `fminf`, `fminl` @@ -42,7 +41,7 @@ long double fminl( long double y ); -#define fmin(x) // Requires C11 or higher +#define fmin(x) // Requires C11 or later ``` ### Parameters diff --git a/docs/c-runtime-library/reference/fmod-fmodf.md b/docs/c-runtime-library/reference/fmod-fmodf.md index ecf39a5c283..5bd8fd5c8a7 100644 --- a/docs/c-runtime-library/reference/fmod-fmodf.md +++ b/docs/c-runtime-library/reference/fmod-fmodf.md @@ -1,7 +1,7 @@ --- title: "fmod, fmodf, fmodl" description: "API reference for fmod, fmodf, and fmodl; which calculates the floating-point remainder." -ms.date: "1/15/2021" +ms.date: 1/15/2021 api_name: ["fmod", "fmodf", "fmodl", "_o_fmod", "_o_fmodf"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll", "api-ms-win-crt-math-l1-1-0.dll"] api_type: ["DLLExport"] @@ -37,7 +37,7 @@ long double fmodl( long double y ); -#define fmod(X, Y) // Requires C11 or higher +#define fmod(X, Y) // Requires C11 or later ``` ### Parameters diff --git a/docs/c-runtime-library/reference/fopen-s-wfopen-s.md b/docs/c-runtime-library/reference/fopen-s-wfopen-s.md index 1efd939eec4..6964db2b65f 100644 --- a/docs/c-runtime-library/reference/fopen-s-wfopen-s.md +++ b/docs/c-runtime-library/reference/fopen-s-wfopen-s.md @@ -153,6 +153,7 @@ Valid characters for the *`mode`* string used in **`fopen_s`** and [`_fdopen`](f | **`t`** | `_O_TEXT` (translated) | | **`c`** | None | | **`n`** | None | +| **`N`** | `_O_NOINHERIT` | | **`D`** | `_O_TEMPORARY` | | **`R`** | `_O_RANDOM` | | **`S`** | `_O_SEQUENTIAL` | @@ -166,7 +167,7 @@ The **`c`**, **`n`**, **`R`**, **`S`**, **`t`**, **`T`**, and **`D`** *`mode`* o If you're using **`rb`** mode, memory mapped Win32 files might also be an option if you don't need to port your code, you expect to read much of the file, or you don't care about network performance. Regarding `T` and `D`: -- `T` avoids writing the file to disk as long as memory pressure doesn't require it. For more information, see `FILE_ATTRIBUTE_TEMPORARY` in [File attribute constants](/windows/win32/fileio/file-attribute-constants), and also this blog post [It's only temporary](https://learn.microsoft.com/archive/blogs/larryosterman/its-only-temporary). +- `T` avoids writing the file to disk as long as memory pressure doesn't require it. For more information, see `FILE_ATTRIBUTE_TEMPORARY` in [File attribute constants](/windows/win32/fileio/file-attribute-constants), and also this blog post [It's only temporary](/archive/blogs/larryosterman/its-only-temporary). - `D` specifies a regular file that is written to disk. The difference is that it's automatically deleted when it's closed. You can combine `TD` to get both semantics. diff --git a/docs/c-runtime-library/reference/fopen-wfopen.md b/docs/c-runtime-library/reference/fopen-wfopen.md index 3756a268d04..22d44f24215 100644 --- a/docs/c-runtime-library/reference/fopen-wfopen.md +++ b/docs/c-runtime-library/reference/fopen-wfopen.md @@ -1,6 +1,6 @@ --- -description: "Learn more about: fopen, _wfopen" title: "fopen, _wfopen" +description: "Learn more about: fopen, _wfopen" ms.date: 04/27/2023 api_name: ["_wfopen", "fopen", "_o__wfopen", "_o_fopen"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll", "api-ms-win-crt-stdio-l1-1-0.dll"] @@ -136,7 +136,7 @@ Valid characters for the *`mode`* string that is used in **`fopen`** and **`_fdo | Characters in *`mode`* string | Equivalent *`oflag`* value for `_open`/`_sopen` | |--|--| | **`a`** | `_O_WRONLY | _O_APPEND` (usually `_O_WRONLY | _O_CREAT | _O_APPEND`) | -| **`a+`** | `_O_RDWR | _O_APPEND` (usually `_O_RDWR | _O_APPEND | _O_CREAT` ) | +| **`a+`** | `_O_RDWR | _O_APPEND` (usually `_O_RDWR | _O_APPEND | _O_CREAT`) | | **`r`** | `_O_RDONLY` | | **`r+`** | `_O_RDWR` | | **`w`** | `_O_WRONLY` (usually `_O_WRONLY | _O_CREAT | _O_TRUNC`) | @@ -146,6 +146,7 @@ Valid characters for the *`mode`* string that is used in **`fopen`** and **`_fdo | **`x`** | `_O_EXCL` | | **`c`** | None | | **`n`** | None | +| **`N`** | `_O_NOINHERIT` | | **`S`** | `_O_SEQUENTIAL` | | **`R`** | `_O_RANDOM` | | **`T`** | `_O_SHORTLIVED` | @@ -157,7 +158,7 @@ Valid characters for the *`mode`* string that is used in **`fopen`** and **`_fdo If you're using **`rb`** mode, you don't have to port your code, and if you expect to read most of a large file or aren't concerned about network performance, you might also consider whether to use memory mapped Win32 files as an option. Regarding `T` and `D`: -- `T` avoids writing the file to disk as long as memory pressure doesn't require it. For more information, see `FILE_ATTRIBUTE_TEMPORARY` in [File attribute constants](/windows/win32/fileio/file-attribute-constants), and also this blog post [It's only temporary](https://learn.microsoft.com/archive/blogs/larryosterman/its-only-temporary). +- `T` avoids writing the file to disk as long as memory pressure doesn't require it. For more information, see `FILE_ATTRIBUTE_TEMPORARY` in [File attribute constants](/windows/win32/fileio/file-attribute-constants), and also this blog post [It's only temporary](/archive/blogs/larryosterman/its-only-temporary). - `D` specifies a regular file that is written to disk. The difference is that it's automatically deleted when it's closed. You can combine `TD` to get both semantics. diff --git a/docs/c-runtime-library/reference/fprintf-fprintf-l-fwprintf-fwprintf-l.md b/docs/c-runtime-library/reference/fprintf-fprintf-l-fwprintf-fwprintf-l.md index 2d972d963a6..19afc35f938 100644 --- a/docs/c-runtime-library/reference/fprintf-fprintf-l-fwprintf-fwprintf-l.md +++ b/docs/c-runtime-library/reference/fprintf-fprintf-l-fwprintf-fwprintf-l.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: fprintf, _fprintf_l, fwprintf, _ftprintf, _ftprintf_l" title: "fprintf, _fprintf_l, fwprintf, _fwprintf_l, _ftprintf, _ftprintf_l" -ms.date: "3/9/2021" +description: "Learn more about: fprintf, _fprintf_l, fwprintf, _ftprintf, _ftprintf_l" +ms.date: 3/9/2021 api_name: ["fwprintf", "fprintf", "_fprintf_l", "_fwprintf_l", "_ftprintf", "_ftprintf_l"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll"] api_type: ["DLLExport"] @@ -73,7 +73,7 @@ The versions of these functions with the **`_l`** suffix are identical except th > [!IMPORTANT] > Ensure that *`format`* is not a user-defined string. > -> Starting in Windows 10 version 2004 (build 19041), the `printf` family of functions prints exactly representable floating point numbers according to the IEEE 754 rules for rounding. In previous versions of Windows, exactly representable floating point numbers ending in '5' would always round up. IEEE 754 states that they must round to the closest even digit (also known as "Banker's Rounding"). For example, both `printf("%1.0f", 1.5)` and `printf("%1.0f", 2.5)` should round to 2. Previously, 1.5 would round to 2 and 2.5 would round to 3. This change only affects exactly representable numbers. For example, 2.35 (which, when represented in memory, is closer to 2.35000000000000008) continues to round up to 2.4. Rounding done by these functions now also respects the floating point rounding mode set by [`fesetround`](fegetround-fesetround2.md). Previously, rounding always chose `FE_TONEAREST` behavior. This change only affects programs built using Visual Studio 2019 version 16.2 and later. To use the legacy floating point rounding behavior, link with ['legacy_stdio_float_rounding.obj`](../link-options.md). +> Starting in Windows 10 version 2004 (build 19041), the `printf` family of functions prints exactly representable floating point numbers according to the IEEE 754 rules for rounding. In previous versions of Windows, exactly representable floating point numbers ending in '5' would always round up. IEEE 754 states that they must round to the closest even digit (also known as "Banker's Rounding"). For example, both `printf("%1.0f", 1.5)` and `printf("%1.0f", 2.5)` should round to 2. Previously, 1.5 would round to 2 and 2.5 would round to 3. This change only affects exactly representable numbers. For example, 2.35 (which, when represented in memory, is closer to 2.35000000000000008) continues to round up to 2.4. Rounding done by these functions now also respects the floating point rounding mode set by [`fesetround`](fegetround-fesetround2.md). Previously, rounding always chose `FE_TONEAREST` behavior. This change only affects programs built using Visual Studio 2019 version 16.2 and later. To use the legacy floating point rounding behavior, link with [`legacy_stdio_float_rounding.obj`](../link-options.md). ### Generic-text function mappings diff --git a/docs/c-runtime-library/reference/fprintf-p-fprintf-p-l-fwprintf-p-fwprintf-p-l.md b/docs/c-runtime-library/reference/fprintf-p-fprintf-p-l-fwprintf-p-fwprintf-p-l.md index 8ed284f3438..67e942623e3 100644 --- a/docs/c-runtime-library/reference/fprintf-p-fprintf-p-l-fwprintf-p-fwprintf-p-l.md +++ b/docs/c-runtime-library/reference/fprintf-p-fprintf-p-l-fwprintf-p-fwprintf-p-l.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: _fprintf_p, _fprintf_p_l, _ftprintf_p, _ftprintf_p_l, _fwprintf_p, _fwprintf_p_l" title: "_fprintf_p, _fprintf_p_l, _fwprintf_p, _fwprintf_p_l" -ms.date: "3/9/2021" +description: "Learn more about: _fprintf_p, _fprintf_p_l, _ftprintf_p, _ftprintf_p_l, _fwprintf_p, _fwprintf_p_l" +ms.date: 3/9/2021 api_name: ["_fwprintf_p", "_fprintf_p_l", "_fwprintf_p_l", "_fprintf_p"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll"] api_type: ["DLLExport"] @@ -71,7 +71,7 @@ The versions of these functions with the `_l` suffix are identical except that t > [!IMPORTANT] > Ensure that *`format`* is not a user-defined string. > -> Starting in Windows 10 version 2004 (build 19041), the `printf` family of functions prints exactly representable floating point numbers according to the IEEE 754 rules for rounding. In previous versions of Windows, exactly representable floating point numbers ending in '5' would always round up. IEEE 754 states that they must round to the closest even digit (also known as "Banker's Rounding"). For example, both `printf("%1.0f", 1.5)` and `printf("%1.0f", 2.5)` should round to 2. Previously, 1.5 would round to 2 and 2.5 would round to 3. This change only affects exactly representable numbers. For example, 2.35 (which, when represented in memory, is closer to 2.35000000000000008) continues to round up to 2.4. Rounding done by these functions now also respects the floating point rounding mode set by [`fesetround`](fegetround-fesetround2.md). Previously, rounding always chose `FE_TONEAREST` behavior. This change only affects programs built using Visual Studio 2019 version 16.2 and later. To use the legacy floating point rounding behavior, link with ['legacy_stdio_float_rounding.obj`](../link-options.md). +> Starting in Windows 10 version 2004 (build 19041), the `printf` family of functions prints exactly representable floating point numbers according to the IEEE 754 rules for rounding. In previous versions of Windows, exactly representable floating point numbers ending in '5' would always round up. IEEE 754 states that they must round to the closest even digit (also known as "Banker's Rounding"). For example, both `printf("%1.0f", 1.5)` and `printf("%1.0f", 2.5)` should round to 2. Previously, 1.5 would round to 2 and 2.5 would round to 3. This change only affects exactly representable numbers. For example, 2.35 (which, when represented in memory, is closer to 2.35000000000000008) continues to round up to 2.4. Rounding done by these functions now also respects the floating point rounding mode set by [`fesetround`](fegetround-fesetround2.md). Previously, rounding always chose `FE_TONEAREST` behavior. This change only affects programs built using Visual Studio 2019 version 16.2 and later. To use the legacy floating point rounding behavior, link with [`legacy_stdio_float_rounding.obj`](../link-options.md). Like the non-secure versions (see [`fprintf`, `_fprintf_l`, `fwprintf`, `_fwprintf_l`](fprintf-fprintf-l-fwprintf-fwprintf-l.md)), these functions validate their parameters and invoke the invalid parameter handler, as described in [Parameter validation](../parameter-validation.md), if either *`stream`* or *`format`* is a null pointer or if there are any unknown or badly formed formatting specifiers. If execution is allowed to continue, the functions return -1 and set `errno` to `EINVAL`. diff --git a/docs/c-runtime-library/reference/fprintf-s-fprintf-s-l-fwprintf-s-fwprintf-s-l.md b/docs/c-runtime-library/reference/fprintf-s-fprintf-s-l-fwprintf-s-fwprintf-s-l.md index 225ec4abc77..4d8fe4b93ee 100644 --- a/docs/c-runtime-library/reference/fprintf-s-fprintf-s-l-fwprintf-s-fwprintf-s-l.md +++ b/docs/c-runtime-library/reference/fprintf-s-fprintf-s-l-fwprintf-s-fwprintf-s-l.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: fprintf_s, _fprintf_s_l, fwprintf_s, _fwprintf_s_l, _ftprintf_s, _ftprintf_s_l" title: "fprintf_s, _fprintf_s_l, fwprintf_s, _fwprintf_s_l, _ftprintf_s, _ftprintf_s_l" -ms.date: "3/9/2021" +description: "Learn more about: fprintf_s, _fprintf_s_l, fwprintf_s, _fwprintf_s_l, _ftprintf_s, _ftprintf_s_l" +ms.date: 3/9/2021 api_name: ["_fprintf_s_l", "fwprintf_s", "fprintf_s", "_fwprintf_s_l", "_ftprintf_s", "_ftprintf_s_l"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll"] api_type: ["DLLExport"] @@ -71,7 +71,7 @@ The versions of these functions with the **`_l`** suffix are identical except th > [!IMPORTANT] > Ensure that *`format`* is not a user-defined string. > -> Starting in Windows 10 version 2004 (build 19041), the `printf` family of functions prints exactly representable floating point numbers according to the IEEE 754 rules for rounding. In previous versions of Windows, exactly representable floating point numbers ending in '5' would always round up. IEEE 754 states that they must round to the closest even digit (also known as "Banker's Rounding"). For example, both `printf("%1.0f", 1.5)` and `printf("%1.0f", 2.5)` should round to 2. Previously, 1.5 would round to 2 and 2.5 would round to 3. This change only affects exactly representable numbers. For example, 2.35 (which, when represented in memory, is closer to 2.35000000000000008) continues to round up to 2.4. Rounding done by these functions now also respects the floating point rounding mode set by [`fesetround`](fegetround-fesetround2.md). Previously, rounding always chose `FE_TONEAREST` behavior. This change only affects programs built using Visual Studio 2019 version 16.2 and later. To use the legacy floating point rounding behavior, link with ['legacy_stdio_float_rounding.obj`](../link-options.md). +> Starting in Windows 10 version 2004 (build 19041), the `printf` family of functions prints exactly representable floating point numbers according to the IEEE 754 rules for rounding. In previous versions of Windows, exactly representable floating point numbers ending in '5' would always round up. IEEE 754 states that they must round to the closest even digit (also known as "Banker's Rounding"). For example, both `printf("%1.0f", 1.5)` and `printf("%1.0f", 2.5)` should round to 2. Previously, 1.5 would round to 2 and 2.5 would round to 3. This change only affects exactly representable numbers. For example, 2.35 (which, when represented in memory, is closer to 2.35000000000000008) continues to round up to 2.4. Rounding done by these functions now also respects the floating point rounding mode set by [`fesetround`](fegetround-fesetround2.md). Previously, rounding always chose `FE_TONEAREST` behavior. This change only affects programs built using Visual Studio 2019 version 16.2 and later. To use the legacy floating point rounding behavior, link with [`legacy_stdio_float_rounding.obj`](../link-options.md). Like the non-secure versions (see [`fprintf`, `_fprintf_l`, `fwprintf`, `_fwprintf_l`](fprintf-fprintf-l-fwprintf-fwprintf-l.md)), these functions validate their parameters and invoke the invalid parameter handler, as described in [Parameter validation](../parameter-validation.md), if either *`stream`* or *`format`* is a `NULL` pointer. The format string itself is also validated. If there are any unknown or badly formed formatting specifiers, these functions generate the invalid parameter exception. In all cases, If execution is allowed to continue, the functions return -1 and set `errno` to `EINVAL`. For more information about return codes, see [`errno`, `_doserrno`, `_sys_errlist`, and `_sys_nerr`](../errno-doserrno-sys-errlist-and-sys-nerr.md). diff --git a/docs/c-runtime-library/reference/frexp.md b/docs/c-runtime-library/reference/frexp.md index fa601e5e415..faf5d4404ba 100644 --- a/docs/c-runtime-library/reference/frexp.md +++ b/docs/c-runtime-library/reference/frexp.md @@ -1,14 +1,13 @@ --- title: "frexp, frexpf, frexpl" description: "API reference for frexp, frexpf, and frexpl; which gets the mantissa and exponent of a floating-point number." -ms.date: "9/1/2020" +ms.date: 9/1/2020 api_name: ["frexp", "_o_frexp"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll", "api-ms-win-crt-math-l1-1-0.dll"] api_type: ["DLLExport"] topic_type: ["apiref"] f1_keywords: ["frexp", "_frexpl"] helpviewer_keywords: ["_frexpl function", "mantissas, floating-point variables", "frexpl function", "exponent, floating-point numbers", "frexp function", "floating-point functions, mantissa and exponent"] -ms.assetid: 9b020f2e-3967-45ec-a6a8-d467a071aa55 --- # `frexp`, `frexpf`, `frexpl` @@ -29,7 +28,7 @@ long double frexpl( long double x, int * expptr ); -#define frexpl(X, INT_PTR) // Requires C11 or higher +#define frexpl(X, INT_PTR) // Requires C11 or later ``` ```cpp diff --git a/docs/c-runtime-library/reference/fsopen-wfsopen.md b/docs/c-runtime-library/reference/fsopen-wfsopen.md index 8f558b4defe..5f2c003e22a 100644 --- a/docs/c-runtime-library/reference/fsopen-wfsopen.md +++ b/docs/c-runtime-library/reference/fsopen-wfsopen.md @@ -76,7 +76,7 @@ When a file is opened with the **"`a`"** or **"`a+`"** access type, all write op If **`t`** or **`b`** isn't given in *`mode`*, the translation mode is defined by the default-mode variable **`_fmode`**. If **`t`** or **`b`** is prefixed to the argument, the function fails and returns `NULL`. For a discussion of text and binary modes, see [Text and binary mode file I/O](../text-and-binary-mode-file-i-o.md). Regarding `T` and `D`: -- `T` avoids writing the file to disk as long as memory pressure doesn't require it. For more information, see `FILE_ATTRIBUTE_TEMPORARY` in [File attribute constants](/windows/win32/fileio/file-attribute-constants), and also this blog post [It's only temporary](https://learn.microsoft.com/archive/blogs/larryosterman/its-only-temporary). +- `T` avoids writing the file to disk as long as memory pressure doesn't require it. For more information, see `FILE_ATTRIBUTE_TEMPORARY` in [File attribute constants](/windows/win32/fileio/file-attribute-constants), and also this blog post [It's only temporary](/archive/blogs/larryosterman/its-only-temporary). - `D` specifies a regular file that is written to disk. The difference is that it's automatically deleted when it's closed. You can combine `TD` to get both semantics. diff --git a/docs/c-runtime-library/reference/futime-futime32-futime64.md b/docs/c-runtime-library/reference/futime-futime32-futime64.md index a8b38058097..43712b04947 100644 --- a/docs/c-runtime-library/reference/futime-futime32-futime64.md +++ b/docs/c-runtime-library/reference/futime-futime32-futime64.md @@ -17,7 +17,7 @@ Sets the modification time on an open file. ## Syntax ```C -int _futime( +int _futime( // See note in remarks section about linkage int fd, struct _utimbuf *filetime ); @@ -51,13 +51,18 @@ The **`_futime`** routine sets the modification date and the access time on the By default, this function's global state is scoped to the application. To change this behavior, see [Global state in the CRT](../global-state.md). +> [!Note] +> If you use Windows SDK version 10.0.26100.6901 and Visual Studio 2026 or later together, `_futime` is no longer `static inline` (internal linkage). Instead, it's `inline` (external linkage).\ +> To return to the previous behavior, `#define _STATIC_INLINE_UCRT_FUNCTIONS=1` before including any CRT headers. By default, `_STATIC_INLINE_UCRT_FUNCTIONS` is set to 0.\ +> This change increases UCRT conformance with the C++ standard and improves compatibility with C++ modules. + ## Requirements | Function | Required header | Optional header | |---|---|---| -| **`_futime`** | \ | \ | -| **`_futime32`** | \ | \ | -| **`_futime64`** | \ | \ | +| **`_futime`** | `` | `` | +| **`_futime32`** | `` | `` | +| **`_futime64`** | `` | `` | For more compatibility information, see [Compatibility](../compatibility.md). diff --git a/docs/c-runtime-library/reference/fwide.md b/docs/c-runtime-library/reference/fwide.md index f21511e1069..71113cfe487 100644 --- a/docs/c-runtime-library/reference/fwide.md +++ b/docs/c-runtime-library/reference/fwide.md @@ -1,14 +1,13 @@ --- -description: "Learn more about: fwide" title: "fwide" -ms.date: "11/04/2016" +description: "Learn more about: fwide" +ms.date: 11/04/2016 api_name: ["fwide"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll"] api_type: ["DLLExport"] topic_type: ["apiref"] f1_keywords: ["fwide"] helpviewer_keywords: ["fwide function"] -ms.assetid: a4641f5b-d74f-4946-95d5-53a64610d28d --- # `fwide` @@ -19,7 +18,7 @@ Unimplemented. ```C int fwide( FILE *stream, - int mode; + int mode ); ``` diff --git a/docs/c-runtime-library/reference/get-printf-count-output.md b/docs/c-runtime-library/reference/get-printf-count-output.md index dfa9d742786..14046943faf 100644 --- a/docs/c-runtime-library/reference/get-printf-count-output.md +++ b/docs/c-runtime-library/reference/get-printf-count-output.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: _get_printf_count_output" title: "_get_printf_count_output" -ms.date: "3/9/2021" +description: "Learn more about: _get_printf_count_output" +ms.date: 3/9/2021 api_name: ["_get_printf_count_output"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll", "api-ms-win-crt-stdio-l1-1-0.dll"] api_type: ["DLLExport"] @@ -28,7 +28,7 @@ Non-zero if **`%n`** is supported; 0 if **`%n`** isn't supported. If **`%n`** isn't supported (the default), any **`%n`** found in the format string of one of the `printf` functions invokes the invalid parameter handler, as described in [Parameter validation](../parameter-validation.md). If **`%n`** support is enabled (see [`_set_printf_count_output`](set-printf-count-output.md)), then **`%n`** behaves as described in [Format specification syntax: `printf` and `wprintf` functions](../format-specification-syntax-printf-and-wprintf-functions.md). > [!IMPORTANT] -> Starting in Windows 10 version 2004 (build 19041), the `printf` family of functions prints exactly representable floating point numbers according to the IEEE 754 rules for rounding. In previous versions of Windows, exactly representable floating point numbers ending in '5' would always round up. IEEE 754 states that they must round to the closest even digit (also known as "Banker's Rounding"). For example, both `printf("%1.0f", 1.5)` and `printf("%1.0f", 2.5)` should round to 2. Previously, 1.5 would round to 2 and 2.5 would round to 3. This change only affects exactly representable numbers. For example, 2.35 (which, when represented in memory, is closer to 2.35000000000000008) continues to round up to 2.4. Rounding done by these functions now also respects the floating point rounding mode set by [`fesetround`](fegetround-fesetround2.md). Previously, rounding always chose `FE_TONEAREST` behavior. This change only affects programs built using Visual Studio 2019 version 16.2 and later. To use the legacy floating point rounding behavior, link with ['legacy_stdio_float_rounding.obj`](../link-options.md). +> Starting in Windows 10 version 2004 (build 19041), the `printf` family of functions prints exactly representable floating point numbers according to the IEEE 754 rules for rounding. In previous versions of Windows, exactly representable floating point numbers ending in '5' would always round up. IEEE 754 states that they must round to the closest even digit (also known as "Banker's Rounding"). For example, both `printf("%1.0f", 1.5)` and `printf("%1.0f", 2.5)` should round to 2. Previously, 1.5 would round to 2 and 2.5 would round to 3. This change only affects exactly representable numbers. For example, 2.35 (which, when represented in memory, is closer to 2.35000000000000008) continues to round up to 2.4. Rounding done by these functions now also respects the floating point rounding mode set by [`fesetround`](fegetround-fesetround2.md). Previously, rounding always chose `FE_TONEAREST` behavior. This change only affects programs built using Visual Studio 2019 version 16.2 and later. To use the legacy floating point rounding behavior, link with [`legacy_stdio_float_rounding.obj`](../link-options.md). ## Requirements diff --git a/docs/c-runtime-library/reference/get-purecall-handler-set-purecall-handler.md b/docs/c-runtime-library/reference/get-purecall-handler-set-purecall-handler.md index 4f491145310..22aa485c222 100644 --- a/docs/c-runtime-library/reference/get-purecall-handler-set-purecall-handler.md +++ b/docs/c-runtime-library/reference/get-purecall-handler-set-purecall-handler.md @@ -1,14 +1,13 @@ --- -description: "Learn more about: _get_purecall_handler, _set_purecall_handler" title: "_get_purecall_handler, _set_purecall_handler" -ms.date: "1/14/2021" +description: "Learn more about: _get_purecall_handler, _set_purecall_handler" +ms.date: 1/14/2021 api_name: ["_set_purecall_handler", "_set_purecall_handler_m", "_get_purecall_handler"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll"] api_type: ["DLLExport"] topic_type: ["apiref"] f1_keywords: ["_set_purecall_handler", "_set_purecall_handler_m", "set_purecall_handler_m", "set_purecall_handler", "stdlib/_set_purecall_handler", "stdlib/_get_purecall_handler", "_get_purecall_handler"] helpviewer_keywords: ["_set_purecall_handler function", "set_purecall_handler function", "purecall_handler", "set_purecall_handler_m function", "_purecall_handler", "_set_purecall_handler_m function", "_get_purecall_handler function"] -ms.assetid: 2759b878-8afa-4129-86e7-72afc2153d9c --- # `_get_purecall_handler`, `_set_purecall_handler` @@ -64,7 +63,7 @@ class CDerived; class CBase { public: - CBase(CDerived *derived): m_pDerived(derived) {}; + CBase(CDerived *derived): m_pDerived(derived) {} ~CBase(); virtual void function(void) = 0; @@ -74,8 +73,8 @@ public: class CDerived : public CBase { public: - CDerived() : CBase(this) {}; // C4355 - virtual void function(void) {}; + CDerived() : CBase(this) {} // C4355 + virtual void function(void) {} }; CBase::~CBase() diff --git a/docs/c-runtime-library/reference/getch-getwch.md b/docs/c-runtime-library/reference/getch-getwch.md index 82d45dd7758..08a4ff83acf 100644 --- a/docs/c-runtime-library/reference/getch-getwch.md +++ b/docs/c-runtime-library/reference/getch-getwch.md @@ -1,7 +1,7 @@ --- title: "_getch, _getwch" description: "API reference for _getch and _getwch; which get a character from the console without echo." -ms.date: "3/8/2023" +ms.date: 3/8/2023 api_name: ["_getch", "_getwch", "_o__getch", "_o__getwch"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll", "api-ms-win-crt-conio-l1-1-0.dll"] api_type: ["DLLExport"] @@ -54,7 +54,6 @@ For more compatibility information, see [Compatibility](../compatibility.md). ```C // crt_getch.c -// compile with: /c // This program reads characters from // the keyboard until it receives a 'Y' or 'y'. diff --git a/docs/c-runtime-library/reference/getch-nolock-getwch-nolock.md b/docs/c-runtime-library/reference/getch-nolock-getwch-nolock.md index 61bf1a4acec..91400665f61 100644 --- a/docs/c-runtime-library/reference/getch-nolock-getwch-nolock.md +++ b/docs/c-runtime-library/reference/getch-nolock-getwch-nolock.md @@ -1,7 +1,7 @@ --- title: "_getch_nolock, _getwch_nolock" description: "Learn more about: _getch_nolock, _getwch_nolock" -ms.date: "4/2/2020" +ms.date: 4/2/2020 api_name: ["_getwch_nolock", "_getch_nolock", "_o__getch_nolock", "_o__getwch_nolock"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll", "api-ms-win-crt-conio-l1-1-0.dll"] api_type: ["DLLExport"] @@ -52,7 +52,6 @@ For more compatibility information, see [Compatibility](../compatibility.md). ```C // crt_getch_nolock.c -// compile with: /c // This program reads characters from // the keyboard until it receives a 'Y' or 'y'. diff --git a/docs/c-runtime-library/reference/getche-getwche.md b/docs/c-runtime-library/reference/getche-getwche.md index 188c2ee2e72..6463db78934 100644 --- a/docs/c-runtime-library/reference/getche-getwche.md +++ b/docs/c-runtime-library/reference/getche-getwche.md @@ -1,14 +1,13 @@ --- title: "_getche, _getwche" description: "API reference for _getche and _getwche; which get a character from the console with echo." -ms.date: "4/2/2020" +ms.date: 4/2/2020 api_name: ["_getwche", "_getche", "_o__getche", "_o__getwche"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll", "api-ms-win-crt-conio-l1-1-0.dll"] api_type: ["DLLExport"] topic_type: ["apiref"] f1_keywords: ["getwche", "_getche", "_getwche"] helpviewer_keywords: ["characters, getting from console", "_getwche function", "getche function", "console, reading from", "getwche function", "_getche function"] -ms.assetid: eac978a8-c43a-4130-938f-54f12e2a0fda --- # `_getche`, `_getwche` @@ -55,7 +54,6 @@ For more compatibility information, see [Compatibility](../compatibility.md). ```C // crt_getche.c -// compile with: /c // This program reads characters from // the keyboard until it receives a 'Y' or 'y'. diff --git a/docs/c-runtime-library/reference/getche-nolock-getwche-nolock.md b/docs/c-runtime-library/reference/getche-nolock-getwche-nolock.md index c9c6b7ad6fa..9165a4f7b2a 100644 --- a/docs/c-runtime-library/reference/getche-nolock-getwche-nolock.md +++ b/docs/c-runtime-library/reference/getche-nolock-getwche-nolock.md @@ -1,7 +1,7 @@ --- title: "_getche_nolock, _getwche_nolock" description: "Learn more about: _getche_nolock, _getwche_nolock" -ms.date: "4/2/2020" +ms.date: 4/2/2020 api_name: ["_getche_nolock", "_getwche_nolock", "_o__getche_nolock", "_o__getwche_nolock"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll", "api-ms-win-crt-conio-l1-1-0.dll"] api_type: ["DLLExport"] @@ -52,7 +52,6 @@ For more compatibility information, see [Compatibility](../compatibility.md). ```C // crt_getche_nolock.c -// compile with: /c // This program reads characters from // the keyboard until it receives a 'Y' or 'y'. diff --git a/docs/c-runtime-library/reference/getdiskfree.md b/docs/c-runtime-library/reference/getdiskfree.md index 9ddb84d87bd..68fa48a070e 100644 --- a/docs/c-runtime-library/reference/getdiskfree.md +++ b/docs/c-runtime-library/reference/getdiskfree.md @@ -1,6 +1,6 @@ --- -description: "Learn more about: _getdiskfree" title: "_getdiskfree" +description: "Learn more about: _getdiskfree" ms.date: 05/11/2022 api_name: ["_getdiskfree", "_o__getdiskfree"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll", "api-ms-win-crt-filesystem-l1-1-0.dll"] @@ -66,7 +66,7 @@ For more compatibility information, see [Compatibility](../compatibility.md). ```C // crt_getdiskfree.c -// compile with: /c + #include #include #include diff --git a/docs/c-runtime-library/reference/getdrive.md b/docs/c-runtime-library/reference/getdrive.md index 571445fb636..743ae0d8239 100644 --- a/docs/c-runtime-library/reference/getdrive.md +++ b/docs/c-runtime-library/reference/getdrive.md @@ -1,14 +1,13 @@ --- -description: "Learn more about: _getdrive" title: "_getdrive" -ms.date: "4/2/2020" +description: "Learn more about: _getdrive" +ms.date: 4/2/2020 api_name: ["_getdrive", "_o__getdrive"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll", "api-ms-win-crt-filesystem-l1-1-0.dll"] api_type: ["DLLExport"] topic_type: ["apiref"] f1_keywords: ["_getdrive", "getdrive"] helpviewer_keywords: ["current disk drive", "getdrive function", "disk drives", "_getdrive function"] -ms.assetid: e40631a0-8f1a-4897-90ac-e1037ff30bca --- # `_getdrive` @@ -43,7 +42,6 @@ For more compatibility information, see [Compatibility](../compatibility.md). ```C // crt_getdrive.c -// compile with: /c // Illustrates drive functions including: // _getdrive _chdrive _getdcwd // diff --git a/docs/c-runtime-library/reference/gmtime-gmtime32-gmtime64.md b/docs/c-runtime-library/reference/gmtime-gmtime32-gmtime64.md index 1d0656b3f72..82ac3231da3 100644 --- a/docs/c-runtime-library/reference/gmtime-gmtime32-gmtime64.md +++ b/docs/c-runtime-library/reference/gmtime-gmtime32-gmtime64.md @@ -16,7 +16,7 @@ Converts a `time_t` time value to a `tm` structure. More secure versions of thes ## Syntax ```C -struct tm *gmtime( const time_t *sourceTime ); +struct tm *gmtime( const time_t *sourceTime ); // See note in remarks section about linkage struct tm *_gmtime32( const __time32_t *sourceTime ); struct tm *_gmtime64( const __time64_t *sourceTime ); ``` @@ -56,6 +56,11 @@ The **`_gmtime32`** function breaks down the *`sourceTime`* value and stores it By default, this function's global state is scoped to the application. To change this behavior, see [Global state in the CRT](../global-state.md). +> [!Note] +> When you use Windows SDK version 10.0.26100.6901 and Visual Studio 2026 or later together, `gmtime` is no longer `static inline` (internal linkage). Instead, it's `inline` (external linkage).\ +> To return to the previous behavior, `#define _STATIC_INLINE_UCRT_FUNCTIONS=1` before including any CRT headers. By default, `_STATIC_INLINE_UCRT_FUNCTIONS` is set to 0.\ +> This change increases UCRT conformance with the C++ standard and improves compatibility with C++ modules. + ## Requirements | Routine | Required C header | Required C++ header | diff --git a/docs/c-runtime-library/reference/gmtime-s-gmtime32-s-gmtime64-s.md b/docs/c-runtime-library/reference/gmtime-s-gmtime32-s-gmtime64-s.md index 91517017143..36f21d43df4 100644 --- a/docs/c-runtime-library/reference/gmtime-s-gmtime32-s-gmtime64-s.md +++ b/docs/c-runtime-library/reference/gmtime-s-gmtime32-s-gmtime64-s.md @@ -16,7 +16,7 @@ Converts a time value to a `tm` structure. These functions are versions of [`_gm ## Syntax ```C -errno_t gmtime_s( +errno_t gmtime_s( // See note in remarks section about linkage struct tm* tmDest, const __time_t* sourceTime ); @@ -76,6 +76,11 @@ Each of the structure fields is of type **`int`**, as shown in the following tab By default, this function's global state is scoped to the application. To change this behavior, see [Global state in the CRT](../global-state.md). +> [!Note] +> When you use Windows SDK version 10.0.26100.6901 and Visual Studio 2026 or later together, `gmtime_s` is no longer `static inline` (internal linkage). Instead, it's `inline` (external linkage).\ +> To return to the previous behavior, `#define _STATIC_INLINE_UCRT_FUNCTIONS=1` before including any CRT headers. By default, `_STATIC_INLINE_UCRT_FUNCTIONS` is set to 0.\ +> This change increases UCRT conformance with the C++ standard and improves compatibility with C++ modules. + ## Requirements | Routine | Required C header | Required C++ header | diff --git a/docs/c-runtime-library/reference/heapchk.md b/docs/c-runtime-library/reference/heapchk.md index 589d119aef5..4e77c836904 100644 --- a/docs/c-runtime-library/reference/heapchk.md +++ b/docs/c-runtime-library/reference/heapchk.md @@ -1,6 +1,6 @@ --- -description: "Learn more about: _heapchk" title: "_heapchk" +description: "Learn more about: _heapchk" ms.date: "4/2/2020" api_name: ["_heapchk", "_o__heapchk"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll", "api-ms-win-crt-heap-l1-1-0.dll"] @@ -8,7 +8,6 @@ api_type: ["DLLExport"] topic_type: ["apiref"] f1_keywords: ["_heapchk", "heapchk"] helpviewer_keywords: ["debugging [CRT], heap-related problems", "consistency checking of heaps", "heapchk function", "heaps, checking consistency", "_heapchk function"] -ms.assetid: 859619a5-1e35-4f02-9e09-11d9fa266ec0 --- # `_heapchk` @@ -36,7 +35,7 @@ In addition, if an error occurs, **`_heapchk`** sets `errno` to `ENOSYS`. ## Remarks -The **`_heapchk`** function helps debug heap-related problems by checking for minimal consistency of the heap. If the operating system doesn't support **`_heapchk`**(for example, Windows 98), the function returns `_HEAPOK` and sets `errno` to `ENOSYS`. +The **`_heapchk`** function helps debug heap-related problems by checking for minimal consistency of the heap. If the operating system doesn't support **`_heapchk`** (for example, Windows 98), the function returns `_HEAPOK` and sets `errno` to `ENOSYS`. By default, this function's global state is scoped to the application. To change this behavior, see [Global state in the CRT](../global-state.md). diff --git a/docs/c-runtime-library/reference/heapmin.md b/docs/c-runtime-library/reference/heapmin.md index ffee2908c13..f5f5e5671a9 100644 --- a/docs/c-runtime-library/reference/heapmin.md +++ b/docs/c-runtime-library/reference/heapmin.md @@ -1,6 +1,6 @@ --- -description: "Learn more about: _heapmin" title: "_heapmin" +description: "Learn more about: _heapmin" ms.date: "4/2/2020" api_name: ["_heapmin", "_o__heapmin"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll", "api-ms-win-crt-heap-l1-1-0.dll"] @@ -8,7 +8,6 @@ api_type: ["DLLExport"] topic_type: ["apiref"] f1_keywords: ["_heapmin", "heapmin"] helpviewer_keywords: ["heap memory", "minimizing heaps", "memory, releasing", "heaps, releasing unused memory", "_heapmin function", "heapmin function"] -ms.assetid: c0bccdf6-2d14-4d7b-a7ff-d6a17bdb410f --- # `_heapmin` @@ -28,7 +27,7 @@ For more information about this and other return codes, see [`errno`, `_doserrno ## Remarks -The **`_heapmin`** function minimizes the heap by releasing unused heap memory to the operating system. If the operating system doesn't support **`_heapmin`**(for example, Windows 98), the function returns -1 and sets `errno` to `ENOSYS`. +The **`_heapmin`** function minimizes the heap by releasing unused heap memory to the operating system. If the operating system doesn't support **`_heapmin`** (for example, Windows 98), the function returns -1 and sets `errno` to `ENOSYS`. By default, this function's global state is scoped to the application. To change this behavior, see [Global state in the CRT](../global-state.md). diff --git a/docs/c-runtime-library/reference/hypot-hypotf-hypotl-hypot-hypotf-hypotl.md b/docs/c-runtime-library/reference/hypot-hypotf-hypotl-hypot-hypotf-hypotl.md index d447ac7df15..93c84bd8b8d 100644 --- a/docs/c-runtime-library/reference/hypot-hypotf-hypotl-hypot-hypotf-hypotl.md +++ b/docs/c-runtime-library/reference/hypot-hypotf-hypotl-hypot-hypotf-hypotl.md @@ -1,14 +1,13 @@ --- title: "hypot, hypotf, hypotl, _hypot, _hypotf, _hypotl" description: "API reference for hypot, hypotf, hypotl, _hypot, _hypotf, and _hypotl; which calculate the hypotenuse." -ms.date: "9/1/2020" +ms.date: 9/1/2020 api_name: ["_hypotf", "hypot", "hypotf", "_hypot", "_hypotl", "hypotl", "_o__hypot", "_o__hypotf", "_o_hypot"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll", "api-ms-win-crt-math-l1-1-0.dll"] api_type: ["DLLExport"] topic_type: ["apiref"] f1_keywords: ["hypotf", "hypotl", "_hypotl", "hypot", "_hypot", "_hypotf"] helpviewer_keywords: ["hypotenuse calculation", "hypot function", "hypotf function", "triangles, calculating hypotenuse", "hypotl function", "calculating hypotenuses", "_hypot function"] -ms.assetid: 6a13887f-bd53-43fc-9d77-5b42d6e49925 --- # `hypot`, `hypotf`, `hypotl`, `_hypot`, `_hypotf`, `_hypotl` @@ -41,7 +40,7 @@ long double _hypotl( long double x, long double y ); -#define hypotf(X, Y) // Requires C11 or higher +#define hypotf(X, Y) // Requires C11 or later ``` ### Parameters diff --git a/docs/c-runtime-library/reference/ilogb-ilogbf-ilogbl2.md b/docs/c-runtime-library/reference/ilogb-ilogbf-ilogbl2.md index b75d22d40bb..c666ef5b99b 100644 --- a/docs/c-runtime-library/reference/ilogb-ilogbf-ilogbl2.md +++ b/docs/c-runtime-library/reference/ilogb-ilogbf-ilogbl2.md @@ -1,14 +1,13 @@ --- title: "ilogb, ilogbf, ilogbl2" description: "API reference for ilogb, ilogbf, and ilogbl2; which retrieve an integer that represents the unbiased base-2 exponent of the specified value." -ms.date: "9/1/2020" +ms.date: 9/1/2020 api_name: ["ilogb", "ilogbf", "ilogbl"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll", "api-ms-win-crt-math-l1-1-0.dll"] api_type: ["DLLExport"] topic_type: ["apiref"] f1_keywords: ["ilogb", "ilogbf", "ilogbl", "math/ilogb", "math/ilogbf", "math/ilogbl"] helpviewer_keywords: ["ilogb function", "ilogbf function", "ilogbl function"] -ms.assetid: 9ef19d57-1caa-41d5-8233-2faad3562fcb --- # `ilogb`, `ilogbf`, `ilogbl` @@ -37,7 +36,7 @@ int ilogbl( long double x ); -#define ilogbl(X) // Requires C11 or higher +#define ilogbl(X) // Requires C11 or later ``` ### Parameters diff --git a/docs/c-runtime-library/reference/islower-iswlower-islower-l-iswlower-l.md b/docs/c-runtime-library/reference/islower-iswlower-islower-l-iswlower-l.md index 02dded213e4..f95d12c979e 100644 --- a/docs/c-runtime-library/reference/islower-iswlower-islower-l-iswlower-l.md +++ b/docs/c-runtime-library/reference/islower-iswlower-islower-l-iswlower-l.md @@ -1,14 +1,13 @@ --- -description: "Learn more about: islower, iswlower, _islower_l, _iswlower_l" title: "islower, iswlower, _islower_l, _iswlower_l" -ms.date: "4/2/2020" +description: "Learn more about: islower, iswlower, _islower_l, _iswlower_l" +ms.date: 4/2/2020 api_name: ["iswlower", "_islower_l", "islower", "_iswlower_l", "_o_islower", "_o_iswlower"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll", "api-ms-win-crt-string-l1-1-0.dll", "ntoskrnl.exe"] api_type: ["DLLExport"] topic_type: ["apiref"] f1_keywords: ["_istlower", "islower", "_ismbclower_l", "_liswlower_l", "_istlower_l", "_iswlower_l", "_islower _l", "_islower_l", "iswlower"] helpviewer_keywords: ["_islower _l function", "_ismbclower_l function", "islower function", "_iswlower_l function", "_liswlower_l function", "_istlower_l function", "istlower function", "_istlower function", "iswlower function", "_islower_l function"] -ms.assetid: fcc3b70a-2b47-45fd-944d-e5c1942e6457 --- # `islower`, `iswlower`, `_islower_l`, `_iswlower_l` @@ -54,7 +53,7 @@ The behavior of **`islower`** and **`_islower_l`** is undefined if *`c`* isn't E | TCHAR.H routine | `_UNICODE` and `_MBCS` not defined | `_MBCS` defined | `_UNICODE` defined | |---|---|---|---| | `_istlower` | **`islower`** | [`_ismbclower`](ismbclower-ismbclower-l-ismbcupper-ismbcupper-l.md) | **`iswlower`** | -| **`_istlower_l`** | `_islower _l` | [`_ismbclower_l`](ismbclower-ismbclower-l-ismbcupper-ismbcupper-l.md) | **`_liswlower_l`** | +| **`_istlower_l`** | `_islower_l` | [`_ismbclower_l`](ismbclower-ismbclower-l-ismbcupper-ismbcupper-l.md) | **`_liswlower_l`** | ## Remarks @@ -64,10 +63,10 @@ By default, this function's global state is scoped to the application. To change | Routine | Required header | |---|---| -| **`islower`** | \ | -| **`iswlower`** | \ or \ | -| **`_islower_l`** | \ | -| **`_swlower_l`** | \ or \ | +| **`islower`** | `` | +| **`iswlower`** | `` or `` | +| **`_islower_l`** | `` | +| **`_swlower_l`** | `` or `` | For more compatibility information, see [Compatibility](../compatibility.md). diff --git a/docs/c-runtime-library/reference/itoa-itow.md b/docs/c-runtime-library/reference/itoa-itow.md index 48046135b6b..1f03714208a 100644 --- a/docs/c-runtime-library/reference/itoa-itow.md +++ b/docs/c-runtime-library/reference/itoa-itow.md @@ -8,7 +8,6 @@ api_type: ["DLLExport"] topic_type: ["apiref"] f1_keywords: ["_itoa", "_ltoa", "_ultoa", "_i64toa", "_ui64toa", "_itow", "_ltow", "_ultow", "_i64tow", "_ui64tow", "itoa", "ltoa", "ultoa", "i64toa", "ui64toa", "itow", "ltow", "ultow", "i64tow", "ui64tow", "itot", "_itot", "ltot", "_ltot", "ultot", "_ultot", "i64tot", "_i64tot", "ui64tot", "_ui64tot", "_MAX_ITOSTR_BASE16_COUNT", "_MAX_ITOSTR_BASE10_COUNT", "_MAX_ITOSTR_BASE8_COUNT", "_MAX_ITOSTR_BASE2_COUNT", "_MAX_LTOSTR_BASE16_COUNT", "_MAX_LTOSTR_BASE10_COUNT", "_MAX_LTOSTR_BASE8_COUNT", "_MAX_LTOSTR_BASE2_COUNT", "_MAX_ULTOSTR_BASE16_COUNT", "_MAX_ULTOSTR_BASE10_COUNT", "_MAX_ULTOSTR_BASE8_COUNT", "_MAX_ULTOSTR_BASE2_COUNT", "_MAX_I64TOSTR_BASE16_COUNT", "_MAX_I64TOSTR_BASE10_COUNT", "_MAX_I64TOSTR_BASE8_COUNT", "_MAX_I64TOSTR_BASE2_COUNT", "_MAX_U64TOSTR_BASE16_COUNT", "_MAX_U64TOSTR_BASE10_COUNT", "_MAX_U64TOSTR_BASE8_COUNT", "_MAX_U64TOSTR_BASE2_COUNT"] helpviewer_keywords: ["_itot function", "ui64toa function", "_ui64toa function", "converting integers", "itot function", "_i64tow function", "_i64toa function", "_itow function", "ui64tow function", "integers, converting", "itoa function", "_ui64tow function", "i64tow function", "itow function", "i64toa function", "converting numbers, to strings", "_itoa function"] -ms.assetid: 46592a00-77bb-4e73-98c0-bf629d96cea6 --- # `itoa`, `_itoa`, `ltoa`, `_ltoa`, `ultoa`, `_ultoa`, `_i64toa`, `_ui64toa`, `_itow`, `_ltow`, `_ultow`, `_i64tow`, `_ui64tow` @@ -137,7 +136,7 @@ This example uses a conversion count macro to define a buffer large enough to co int main() { wchar_t buffer[_MAX_U64TOSTR_BASE2_COUNT]; - std:wcout << _ui64tow(0xFFFFFFFFFFFFFFFFull, buffer, 2) << std::endl; + std::wcout << _ui64tow(0xFFFFFFFFFFFFFFFFull, buffer, 2) << std::endl; } ``` diff --git a/docs/c-runtime-library/reference/itoa-s-itow-s.md b/docs/c-runtime-library/reference/itoa-s-itow-s.md index bd52ce7408a..8625968ea08 100644 --- a/docs/c-runtime-library/reference/itoa-s-itow-s.md +++ b/docs/c-runtime-library/reference/itoa-s-itow-s.md @@ -1,16 +1,15 @@ --- -description: "Learn more about: _itoa_s, _ltoa_s, _ultoa_s, _i64toa_s, _ui64toa_s, _itow_s, _ltow_s, _ultow_s, _i64tow_s, _ui64tow_s" title: "_itoa_s, _itow_s functions" -ms.date: "4/2/2020" +description: "Learn more about: _itoa_s, _ltoa_s, _ultoa_s, _i64toa_s, _ui64toa_s, _itow_s, _ltow_s, _ultow_s, _i64tow_s, _ui64tow_s" +ms.date: 4/2/2020 api_name: ["_itoa_s", "_ltoa_s", "_ultoa_s", "_i64toa_s", "_ui64toa_s", "_itow_s", "_ltow_s", "_ultow_s", "_i64tow_s", "_ui64tow_s", "_o__i64toa_s", "_o__i64tow_s", "_o__itoa_s", "_o__itow_s", "_o__ltoa_s", "_o__ltow_s", "_o__ui64toa_s", "_o__ui64tow_s", "_o__ultoa_s", "_o__ultow_s"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll", "api-ms-win-crt-convert-l1-1-0.dll", "ntoskrnl.exe"] api_type: ["DLLExport"] topic_type: ["apiref"] f1_keywords: ["_itoa_s", "_ltoa_s", "_ultoa_s", "_i64toa_s", "_ui64toa_s", "_itow_s", "_ltow_s", "_ultow_s", "_i64tow_s", "_ui64tow_s", "_itot_s", "_ltot_s", "_ultot_s", "_i64tot_s", "_ui64tot_s", "itoa_s", "ltoa_s", "ultoa_s", "i64toa_s", "ui64toa_s", "itow_s", "ltow_s", "ultow_s", "i64tow_s", "ui64tow_s", "itot_s", "ltot_s", "ultot_s", "i64tot_s", "ui64tot_s"] helpviewer_keywords: ["_ui64toa_s function", "_itow_s function", "_i64tow_s function", "_itot_s function", "converting integers", "itow_s function", "i64toa_s function", "_ui64tow_s function", "integers, converting", "_i64tot_s function", "itoa_s function", "_itoa_s function", "ui64toa_s function", "i64tow_s function", "converting numbers, to strings", "_ui64tot_s function", "_i64toa_s function"] -ms.assetid: eb746581-bff3-48b5-a973-bfc0a4478ecf --- -# `_itoa_s`, `_ltoa_s`, `_ultoa_s`, `_i64toa_s`, `_ui64toa_s`, `_itow_s`, `_ltow_s`, `_ultow_s`, `_i64tow_s`, `_ui64tow_s` +# `_itoa_s`, `_ltoa_s`, `_ultoa_s`, `_i64toa_s`, `_ui64toa_s`, `_itow_s`, `_ltow_s`, `_ultow_s`, `_i64tow_s`, `_ui64tow_s` Converts an integer to a string. These functions are versions of the [`_itoa`, `_itow` functions](itoa-itow.md) with security enhancements as described in [Security features in the CRT](../security-features-in-the-crt.md). diff --git a/docs/c-runtime-library/reference/kbhit.md b/docs/c-runtime-library/reference/kbhit.md index e4f1f9cfb7f..fe9bfbf45fa 100644 --- a/docs/c-runtime-library/reference/kbhit.md +++ b/docs/c-runtime-library/reference/kbhit.md @@ -1,14 +1,13 @@ --- -description: "Learn more about: _kbhit" title: "_kbhit" -ms.date: "4/2/2020" +description: "Learn more about: _kbhit" +ms.date: 4/2/2020 api_name: ["_kbhit", "_o__kbhit"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll", "api-ms-win-crt-stdio-l1-1-0.dll"] api_type: ["DLLExport"] topic_type: ["apiref"] f1_keywords: ["_kbhit", "conio/_kbhit"] helpviewer_keywords: ["keyboard input", "user input, checking for keyboard", "kbhit function", "console", "console, checking", "keyboards, keyboard input", "_kbhit function", "keyboards, checking input"] -ms.assetid: e82a1cc9-bbec-4150-b678-a7e433220fe4 --- # `_kbhit` @@ -20,7 +19,6 @@ Checks the console for keyboard input. ## Syntax ```C - int _kbhit( void ); ``` @@ -50,7 +48,6 @@ All versions of the [C run-time libraries](../crt-library-features.md). ```C // crt_kbhit.c -// compile with: /c /* This program loops until the user * presses a key. If _kbhit returns nonzero, a * keystroke is waiting in the buffer. The program diff --git a/docs/c-runtime-library/reference/ldexp.md b/docs/c-runtime-library/reference/ldexp.md index 8cb4fae0462..b5b2b0ac175 100644 --- a/docs/c-runtime-library/reference/ldexp.md +++ b/docs/c-runtime-library/reference/ldexp.md @@ -1,14 +1,13 @@ --- title: "ldexp, ldexpf, ldexpl" description: "API reference for ldexp, ldexpf, and ldexpl; which multiplies a floating-point number by an integral power of two." -ms.date: "9/1/2020" +ms.date: 9/1/2020 api_name: ["ldexp", "ldexpf", "ldexpl", "_ldexpl", "_o_ldexp"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll", "api-ms-win-crt-math-l1-1-0.dll"] api_type: ["DLLExport"] topic_type: ["apiref"] f1_keywords: ["ldexp", "ldexpf", "ldexpl", "_ldexpl"] helpviewer_keywords: ["calculating real numbers", "computing real numbers", "mantissas, floating-point variables", "ldexp function", "ldexpf function", "ldexpl function", "exponent, floating-point numbers", "floating-point functions, mantissa and exponent"] -ms.assetid: aa7f5310-3879-4f63-ae74-86a39fbdedfa --- # `ldexp`, `ldexpf`, `ldexpl` @@ -29,7 +28,7 @@ long double ldexpl( long double x, int exp ); -#define ldexp(X, INT) // Requires C11 or higher +#define ldexp(X, INT) // Requires C11 or later float ldexp( float x, diff --git a/docs/c-runtime-library/reference/lgamma-lgammaf-lgammal.md b/docs/c-runtime-library/reference/lgamma-lgammaf-lgammal.md index e23d3050a2c..cd6eac91103 100644 --- a/docs/c-runtime-library/reference/lgamma-lgammaf-lgammal.md +++ b/docs/c-runtime-library/reference/lgamma-lgammaf-lgammal.md @@ -1,14 +1,13 @@ --- title: "lgamma, lgammaf, lgammal" description: "API reference for lgamma, lgammaf, and lgammal; which determines the natural logarithm of the absolute value of the gamma function of the specified value." -ms.date: "9/1/2020" +ms.date: 9/1/2020 api_name: ["lgamma", "lgammaf", "lgammal", "_o_lgamma", "_o_lgammaf", "_o_lgammal"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll", "api-ms-win-crt-math-l1-1-0.dll"] api_type: ["DLLExport"] topic_type: ["apiref"] f1_keywords: ["lgamma", "lgammaf", "lgammal", "math/lgamma", "math/lgammaf", "math/lgammal"] helpviewer_keywords: ["lgamma function", "lgammal function", "lgammaf function"] -ms.assetid: 6e326c58-7077-481a-a329-c82ae56ae9e6 --- # `lgamma`, `lgammaf`, `lgammal` @@ -20,7 +19,7 @@ Determines the natural logarithm of the absolute value of the gamma function of double lgamma( double x ); float lgammaf( float x ); long double lgammal( long double x ); -#define lgammal(X) // Requires C11 or higher +#define lgammal(X) // Requires C11 or later float lgamma( float x ); //C++ only long double lgamma( long double x ); //C++ only diff --git a/docs/c-runtime-library/reference/localtime-localtime32-localtime64.md b/docs/c-runtime-library/reference/localtime-localtime32-localtime64.md index 746082c2ad8..b5f537a55a0 100644 --- a/docs/c-runtime-library/reference/localtime-localtime32-localtime64.md +++ b/docs/c-runtime-library/reference/localtime-localtime32-localtime64.md @@ -17,7 +17,7 @@ Converts a time value and corrects for the local time zone. More secure versions ## Syntax ```C -struct tm *localtime( const time_t *sourceTime ); +struct tm *localtime( const time_t *sourceTime ); // See note in remarks section about linkage struct tm *_localtime32( const __time32_t *sourceTime ); struct tm *_localtime64( const __time64_t *sourceTime ); ``` @@ -72,6 +72,11 @@ These functions validate their parameters. If *`sourceTime`* is a null pointer, By default, this function's global state is scoped to the application. To change this behavior, see [Global state in the CRT](../global-state.md). +> [!Note] +> When you use Windows SDK version 10.0.26100.6901 and Visual Studio 2026 or later together, `localtime` is no longer `static inline` (internal linkage). Instead, it's `inline` (external linkage).\ +> To return to the previous behavior, `#define _STATIC_INLINE_UCRT_FUNCTIONS=1` before including any CRT headers. By default, `_STATIC_INLINE_UCRT_FUNCTIONS` is set to 0.\ +> This change increases UCRT conformance with the C++ standard and improves compatibility with C++ modules. + ## Requirements | Routine | Required C header | Required C++ header | diff --git a/docs/c-runtime-library/reference/localtime-s-localtime32-s-localtime64-s.md b/docs/c-runtime-library/reference/localtime-s-localtime32-s-localtime64-s.md index 64aebc449d6..430f90328b3 100644 --- a/docs/c-runtime-library/reference/localtime-s-localtime32-s-localtime64-s.md +++ b/docs/c-runtime-library/reference/localtime-s-localtime32-s-localtime64-s.md @@ -17,7 +17,7 @@ Converts a **`time_t`** time value to a **`tm`** structure, and corrects for the ## Syntax ```C -errno_t localtime_s( +errno_t localtime_s( // See note in remarks section about linkage struct tm* const tmDest, time_t const* const sourceTime ); @@ -84,6 +84,11 @@ If the **`TZ`** environment variable is set, the C run-time library assumes rule By default, this function's global state is scoped to the application. To change this behavior, see [Global state in the CRT](../global-state.md). +> [!Note] +> When you use Windows SDK version 10.0.26100.6901 and Visual Studio 2026 or later together, `localtime_s` is no longer `static inline` (internal linkage). Instead, it's `inline` (external linkage).\ +> To return to the previous behavior, `#define _STATIC_INLINE_UCRT_FUNCTIONS=1` before including any CRT headers. By default, `_STATIC_INLINE_UCRT_FUNCTIONS` is set to 0.\ +> This change increases UCRT conformance with the C++ standard and improves compatibility with C++ modules. + ## Requirements | Routine | Required C header | Required C++ header | diff --git a/docs/c-runtime-library/reference/log-logf-log10-log10f.md b/docs/c-runtime-library/reference/log-logf-log10-log10f.md index 475f4668707..ba904c50ab6 100644 --- a/docs/c-runtime-library/reference/log-logf-log10-log10f.md +++ b/docs/c-runtime-library/reference/log-logf-log10-log10f.md @@ -1,7 +1,7 @@ --- title: "log, logf, logl, log10, log10f, log10l" description: "API reference for log, logf, logl, log10, log10f, and log10l; which calculate logarithms." -ms.date: "9/1/2020" +ms.date: 9/1/2020 api_name: ["log10f", "logf", "log10", "log", "log10l", "logl", "_o_log", "_o_log10", "_o_log10f", "_o_logf"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll", "api-ms-win-crt-math-l1-1-0.dll"] api_type: ["DLLExport"] @@ -22,8 +22,8 @@ long double logl(double x); double log10(double x); float log10f (float x); long double log10l(double x); -#define log(X) // Requires C11 or higher -#define log10(X) // Requires C11 or higher +#define log(X) // Requires C11 or later +#define log10(X) // Requires C11 or later float log(float x); // C++ only long double log(long double x); // C++ only @@ -122,9 +122,9 @@ Log base 2 of 65536.000000 is 16.000000 ## See also -[Math and floating-point support](../floating-point-support.md) \ -[`exp`, `expf`, `expl`](exp-expf.md) \ -[`_matherr`](matherr.md) \ -[`pow`, `powf`, `powl`](pow-powf-powl.md) \ -[`_CIlog`](../cilog.md) \ -[`_CIlog10`](../cilog10.md)\ +[Math and floating-point support](../floating-point-support.md)\ +[`exp`, `expf`, `expl`](exp-expf.md)\ +[`_matherr`](matherr.md)\ +[`pow`, `powf`, `powl`](pow-powf-powl.md)\ +[`_CIlog`](../cilog.md)\ +[`_CIlog10`](../cilog10.md) diff --git a/docs/c-runtime-library/reference/log1p-log1pf-log1pl2.md b/docs/c-runtime-library/reference/log1p-log1pf-log1pl2.md index 4b73bb4062e..ae3103f60cc 100644 --- a/docs/c-runtime-library/reference/log1p-log1pf-log1pl2.md +++ b/docs/c-runtime-library/reference/log1p-log1pf-log1pl2.md @@ -1,7 +1,7 @@ --- title: "log1p, log1pf, log1pl2" description: "API reference for log1p, log1pf, log1pl2; which compute the natural logarithm of 1 plus the specified value." -ms.date: "2/1/2023" +ms.date: 2/1/2023 api_name: ["log1p", "log1pf", "log1pl", "_o_log1p", "_o_log1pf", "_o_log1pl"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll", "api-ms-win-crt-math-l1-1-0.dll"] api_type: ["DLLExport"] @@ -20,7 +20,7 @@ double log1p(double x); float log1pf(float x); long double log1pl(long double x); -#define log1p(X) // Requires C11 or higher +#define log1p(X) // Requires C11 or later float log1p(float x); //C++ only long double log1p(long double x); //C++ only diff --git a/docs/c-runtime-library/reference/log2-log2f-log2l.md b/docs/c-runtime-library/reference/log2-log2f-log2l.md index 9a70db2e0cf..329ca699d05 100644 --- a/docs/c-runtime-library/reference/log2-log2f-log2l.md +++ b/docs/c-runtime-library/reference/log2-log2f-log2l.md @@ -1,12 +1,11 @@ --- title: "log2, log2f, log2l" description: "API reference for log2, log2f, and log2l; which determine the binary (base-2) logarithm of the specified value." -ms.date: "9/1/2020" +ms.date: 9/1/2020 api_name: ["log2", "log2l", "log2f", "_o_log2", "_o_log2f", "_o_log2l"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll", "api-ms-win-crt-math-l1-1-0.dll"] api_type: ["DLLExport"] topic_type: ["apiref"] -ms.assetid: 94d11b38-70b7-4d3a-94ac-523153c92b2e --- # `log2`, `log2f`, `log2l` @@ -35,7 +34,7 @@ long double log2l( long double x ); -#define log2(X) // Requires C11 or higher +#define log2(X) // Requires C11 or later ``` ### Parameters diff --git a/docs/c-runtime-library/reference/logb-logbf-logbl-logb-logbf.md b/docs/c-runtime-library/reference/logb-logbf-logbl-logb-logbf.md index 30a4afeca7c..cec043552fb 100644 --- a/docs/c-runtime-library/reference/logb-logbf-logbl-logb-logbf.md +++ b/docs/c-runtime-library/reference/logb-logbf-logbl-logb-logbf.md @@ -1,7 +1,7 @@ --- title: "logb, logbf, logbl, _logb, _logbf" description: "API reference for logb, logbf, logbl, _logb, and _logbf; which extract the exponent value of a floating-point argument." -ms.date: "1/15/2021" +ms.date: 1/15/2021 api_name: ["logb", "_logb", "_logbl", "logbf", "_logbf", "logbl", "_o__logb", "_o_logb", "_o_logbf", "_o_logbl", "_o__logbf"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll", "api-ms-win-crt-math-l1-1-0.dll"] api_type: ["DLLExport"] @@ -37,7 +37,7 @@ double _logb( float _logbf( float x ); -#define logb(X) // Requires C11 or higher +#define logb(X) // Requires C11 or later ``` ### Parameters diff --git a/docs/c-runtime-library/reference/longjmp.md b/docs/c-runtime-library/reference/longjmp.md index e94b1110c17..da78b65d11e 100644 --- a/docs/c-runtime-library/reference/longjmp.md +++ b/docs/c-runtime-library/reference/longjmp.md @@ -1,6 +1,6 @@ --- -description: "Learn more about: longjmp" title: "longjmp" +description: "Learn more about: longjmp" ms.date: "1/14/2021" api_name: ["longjmp"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll", "ntoskrnl.exe"] @@ -8,7 +8,6 @@ api_type: ["DLLExport"] topic_type: ["apiref"] f1_keywords: ["longjmp"] helpviewer_keywords: ["restoring stack environment and execution locale", "longjmp function"] -ms.assetid: 0e13670a-5130-45c1-ad69-6862505b7a2f --- # `longjmp` @@ -75,5 +74,5 @@ See the example for [`_fpreset`](fpreset.md). ## See also -[Process and environment control](../process-and-environment-control.md) +[Process and environment control](../process-and-environment-control.md)\ [`setjmp`](setjmp.md) diff --git a/docs/c-runtime-library/reference/lrint-lrintf-lrintl-llrint-llrintf-llrintl.md b/docs/c-runtime-library/reference/lrint-lrintf-lrintl-llrint-llrintf-llrintl.md index 9c9b491590b..732c7abe857 100644 --- a/docs/c-runtime-library/reference/lrint-lrintf-lrintl-llrint-llrintf-llrintl.md +++ b/docs/c-runtime-library/reference/lrint-lrintf-lrintl-llrint-llrintf-llrintl.md @@ -1,14 +1,13 @@ --- title: "lrint, lrintf, lrintl, llrint, llrintf, llrintl" description: "API reference for lrint(), lrintf(), lrintl(), llrint(), llrintf(), and llrintl(); which rounds the specified floating-point value to the nearest integral value, by using the current rounding mode and direction." -ms.date: "9/1/2020" +ms.date: 9/1/2020 api_name: ["lrint", "lrintl", "lrintf", "llrint", "llrintf", "llrintl", "_o_llrint", "_o_llrintf", "_o_llrintl", "_o_lrint", "_o_lrintf", "_o_lrintl"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll", "api-ms-win-crt-math-l1-1-0.dll"] api_type: ["DLLExport"] topic_type: ["apiref"] f1_keywords: ["lrint", "lrintf", "lrintl", "llrint", "llrintf", "llrintl", "math/lrint", "math/lrintf", "math/lrintl", "math/llrint", "math/llrintf", "math/llrintl"] helpviewer_keywords: ["lrint function", "lrintf function", "lrintl function", "llrint function", "llrintf function", "llrintl function"] -ms.assetid: 28ccd5b3-5e6f-434f-997d-a21d51b8ce7f --- # `lrint`, `lrintf`, `lrintl`, `llrint`, `llrintf`, `llrintl` @@ -57,7 +56,7 @@ long long int llrintl( long double x ); -#define lrint(X) // Requires C11 or higher +#define lrint(X) // Requires C11 or later ``` ### Parameters diff --git a/docs/c-runtime-library/reference/lround-lroundf-lroundl-llround-llroundf-llroundl.md b/docs/c-runtime-library/reference/lround-lroundf-lroundl-llround-llroundf-llroundl.md index 4233c51110d..d9ff713ffdd 100644 --- a/docs/c-runtime-library/reference/lround-lroundf-lroundl-llround-llroundf-llroundl.md +++ b/docs/c-runtime-library/reference/lround-lroundf-lroundl-llround-llroundf-llroundl.md @@ -1,14 +1,13 @@ --- title: "lround, lroundf, lroundl, llround, llroundf, llroundl" description: "API reference for lround, lroundf, lroundl, llround, llroundf, and llroundl; which rounds a floating-point value to the nearest integer." -ms.date: "9/1/2020" +ms.date: 9/1/2020 api_name: ["llround", "llroundf", "llroundl", "lroundf", "lround", "lroundl", "_o_llround", "_o_llroundf", "_o_llroundl", "_o_lround", "_o_lroundf", "_o_lroundl"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll", "api-ms-win-crt-math-l1-1-0.dll"] api_type: ["DLLExport"] topic_type: ["apiref"] f1_keywords: ["lround", "lroundl", "llroundl", "llround", "lroundf", "llroundf"] helpviewer_keywords: ["lround function", "llroundl function", "llround function", "lroundf function", "llroundf function", "lroundl function"] -ms.assetid: cfb88a35-54c6-469f-85af-f7d695dcfdd8 --- # `lround`, `lroundf`, `lroundl`, `llround`, `llroundf`, `llroundl` @@ -47,7 +46,7 @@ long long llroundf( long long llroundl( long double x ); -#define lround(X) // Requires C11 or higher +#define lround(X) // Requires C11 or later ``` ### Parameters diff --git a/docs/c-runtime-library/reference/malloca.md b/docs/c-runtime-library/reference/malloca.md index 9953a916579..56b67ffeb9d 100644 --- a/docs/c-runtime-library/reference/malloca.md +++ b/docs/c-runtime-library/reference/malloca.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: _malloca" title: "_malloca" -ms.date: "11/04/2016" +description: "Learn more about: _malloca" +ms.date: 11/04/2016 api_name: ["_malloca"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll"] api_type: ["DLLExport"] @@ -38,7 +38,7 @@ If *`size`* is greater than `_ALLOCA_S_THRESHOLD`, then **`_malloca`** attempts There are restrictions to explicitly calling **`_malloca`** in an exception handler (EH). EH routines that run on x86-class processors operate in their own memory frame: They perform their tasks in memory space that isn't based on the current location of the stack pointer of the enclosing function. The most common implementations include Windows NT structured exception handling (SEH) and C++ catch clause expressions. Therefore, explicitly calling **`_malloca`** in any of the following scenarios results in program failure during the return to the calling EH routine: -- Windows SEH exception filter expression: **`__except`** (`_malloca ()` ) +- Windows SEH exception filter expression: **`__except`** (`_malloca ()`) - Windows SEH final exception handler: **`__finally`** {`_malloca ()` } diff --git a/docs/c-runtime-library/reference/mbrtoc16-mbrtoc323.md b/docs/c-runtime-library/reference/mbrtoc16-mbrtoc323.md index f30c701ea5f..f8f8f24a703 100644 --- a/docs/c-runtime-library/reference/mbrtoc16-mbrtoc323.md +++ b/docs/c-runtime-library/reference/mbrtoc16-mbrtoc323.md @@ -1,14 +1,13 @@ --- -description: "Learn more about: mbrtoc16, mbrtoc32" title: "mbrtoc16, mbrtoc323" -ms.date: "4/2/2020" +description: "Learn more about: mbrtoc16, mbrtoc32" +ms.date: 4/2/2020 api_name: ["mbrtoc16", "mbrtoc32", "_o_mbrtoc16", "_o_mbrtoc32"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll", "api-ms-win-crt-convert-l1-1-0.dll"] api_type: ["DLLExport"] topic_type: ["apiref"] f1_keywords: ["mbrtoc16", "mbrtoc32", "uchar/mbrtoc16", "uchar/mbrtoc32"] helpviewer_keywords: ["mbrtoc16 function", "mbrtoc32 function"] -ms.assetid: 099ade4d-56f7-4e61-8b45-493f1d7a64bd --- # `mbrtoc16`, `mbrtoc32` @@ -62,7 +61,7 @@ On success, returns the value of the first of these conditions that applies, giv The **`mbrtoc16`** function reads up to *`max_bytes`* bytes from *`source`* to find the first complete, valid UTF-8 multibyte character, and then stores the equivalent UTF-16 character in *`destination`*. If the character requires more than one UTF-16 output character, such as a surrogate pair, then the *`state`* value is set to store the next UTF-16 character in *`destination`* on the next call to **`mbrtoc16`**. The **`mbrtoc32`** function is identical, but output is stored as a UTF-32 character. -If *`source`* is null, these functions return the equivalent of a call made using arguments of `NULL` for *`destination`*, `""` (an empty, null-terminated string) for *`source`*, and 1 for *`max_bytes`*. The passed values of *`destination`* and *`max_bytes`* are ignored. +If *`source`* is null, these functions return the equivalent of a call made using arguments of `NULL` for *`destination`*, `""` (an empty, null-terminated string) for *`source`*, and 1 for *`max_bytes`*. The passed values of *`destination`* and *`max_bytes`* are ignored. If *`source`* isn't null, the function starts at the beginning of the string and inspects up to *`max_bytes`* bytes to determine the number of bytes required to complete the next UTF-8 multibyte character, including any shift sequences. If the examined bytes contain a valid and complete UTF-8 multibyte character, the function converts the character into the equivalent 16-bit or 32-bit wide character or characters. If *`destination`* isn't null, the function stores the first (and possibly only) result character in destination. If extra output characters are required, a value is set in *`state`*, so that subsequent calls to the function output the extra characters and return the value -3. If no more output characters are required, then *`state`* is set to the initial shift state. diff --git a/docs/c-runtime-library/reference/mbrtowc.md b/docs/c-runtime-library/reference/mbrtowc.md index b8634e50a79..7c64576e18a 100644 --- a/docs/c-runtime-library/reference/mbrtowc.md +++ b/docs/c-runtime-library/reference/mbrtowc.md @@ -1,14 +1,13 @@ --- -description: "Learn more about: mbrtowc" title: "mbrtowc" -ms.date: "4/2/2020" +description: "Learn more about: mbrtowc" +ms.date: 4/2/2020 api_name: ["mbrtowc", "_o_mbrtowc"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll", "api-ms-win-crt-convert-l1-1-0.dll"] api_type: ["DLLExport"] topic_type: ["apiref"] f1_keywords: ["mbrtowc"] helpviewer_keywords: ["mbrtowc function"] -ms.assetid: a1e87fcc-6de0-4ca1-bf26-508d28490286 --- # `mbrtowc` @@ -100,7 +99,7 @@ int Sample(char* szIn, wchar_t* wcOut, int nMax) szLocal = setlocale(LC_ALL, "French_Canada.1252"); if (!szLocal) { - printf("The fuction setlocale(LC_ALL, \"French_Canada.1252\") failed!\n"); + printf("The function setlocale(LC_ALL, \"French_Canada.1252\") failed!\n"); return 1; } @@ -110,7 +109,7 @@ int Sample(char* szIn, wchar_t* wcOut, int nMax) // from a previous call to setlocale. if (_setmbcp(_MB_CP_SBCS) == -1) { - printf("The fuction _setmbcp(_MB_CP_SBCS) failed!"); + printf("The function _setmbcp(_MB_CP_SBCS) failed!"); return 1; } diff --git a/docs/c-runtime-library/reference/mbsnbset-s-mbsnbset-s-l.md b/docs/c-runtime-library/reference/mbsnbset-s-mbsnbset-s-l.md index 903e87992a5..9fa6a973f5f 100644 --- a/docs/c-runtime-library/reference/mbsnbset-s-mbsnbset-s-l.md +++ b/docs/c-runtime-library/reference/mbsnbset-s-mbsnbset-s-l.md @@ -1,14 +1,13 @@ --- -description: "Learn more about: _mbsnbset_s, _mbsnbset_s_l" title: "_mbsnbset_s, _mbsnbset_s_l" -ms.date: "4/2/2020" +description: "Learn more about: _mbsnbset_s, _mbsnbset_s_l" +ms.date: 4/2/2020 api_name: ["_mbsnbset_s_l", "_mbsnbset_s", "_o__mbsnbset_s", "_o__mbsnbset_s_l"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll", "api-ms-win-crt-multibyte-l1-1-0.dll"] api_type: ["DLLExport"] topic_type: ["apiref"] f1_keywords: ["mbsnbset_s", "_mbsnbset_s_l", "_mbsnbset_s", "mbsnbset_s_l"] helpviewer_keywords: ["tcsnset_s function", "mbsnbset_s function", "mbsnbset_s_l function", "_mbsnbset_s_l function", "_tcsnset_s_l function", "_mbsnbset_s function", "_tcsnset_s function", "tcsnset_s_l function"] -ms.assetid: 811f92c9-cc31-4bbd-8017-2d1bfc6fb96f --- # `_mbsnbset_s`, `_mbsnbset_s_l` @@ -90,14 +89,14 @@ By default, this function's global state is scoped to the application. To change | Tchar.h routine | `_UNICODE` and `_MBCS` not defined | `_MBCS` defined | `_UNICODE` defined | |---|---|---|---| | `_tcsnset_s` | `_strnset_s` | **`_mbsnbset_s`** | `_wcsnset_s` | -| `_tcsnset_s_l` | `_strnset_s _l` | **`_mbsnbset_s_l`** | `_wcsnset_s_l` | +| `_tcsnset_s_l` | `_strnset_s_l` | **`_mbsnbset_s_l`** | `_wcsnset_s_l` | ## Requirements | Routine | Required header | |---|---| -| **`_mbsnbset_s`** | \ | -| **`_mbsnbset_s_l`** | \ | +| **`_mbsnbset_s`** | `` | +| **`_mbsnbset_s_l`** | `` | For more compatibility information, see [Compatibility](../compatibility.md). diff --git a/docs/c-runtime-library/reference/mkdir-wmkdir.md b/docs/c-runtime-library/reference/mkdir-wmkdir.md index 43a9a54ba69..f01bf458e61 100644 --- a/docs/c-runtime-library/reference/mkdir-wmkdir.md +++ b/docs/c-runtime-library/reference/mkdir-wmkdir.md @@ -1,6 +1,6 @@ --- -description: "Learn more about: _mkdir, _wmkdir" title: "_mkdir, _wmkdir" +description: "Learn more about: _mkdir, _wmkdir" ms.date: "4/2/2020" api_name: ["_wmkdir", "_mkdir", "_o__mkdir", "_o__wmkdir"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll", "api-ms-win-crt-filesystem-l1-1-0.dll"] @@ -8,7 +8,6 @@ api_type: ["DLLExport"] topic_type: ["apiref"] f1_keywords: ["_mkdir", "tmkdir", "_tmkdir", "wmkdir", "_wmkdir"] helpviewer_keywords: ["_wmkdir function", "folders [C++], creating", "wmkdir function", "directories [C++], creating", "mkdir function", "tmkdir function", "_mkdir function", "_tmkdir function"] -ms.assetid: 7f22d01d-63a5-4712-a6e7-d34878b2d840 --- # `_mkdir`, `_wmkdir` @@ -17,7 +16,6 @@ Creates a new directory. ## Syntax ```C - int _mkdir( const char *dirname ); diff --git a/docs/c-runtime-library/reference/mkgmtime-mkgmtime32-mkgmtime64.md b/docs/c-runtime-library/reference/mkgmtime-mkgmtime32-mkgmtime64.md index c692db99002..037c907886b 100644 --- a/docs/c-runtime-library/reference/mkgmtime-mkgmtime32-mkgmtime64.md +++ b/docs/c-runtime-library/reference/mkgmtime-mkgmtime32-mkgmtime64.md @@ -16,7 +16,7 @@ Converts a UTC time represented by a **`struct tm`** to a UTC time represented b ## Syntax ```C -time_t _mkgmtime( +time_t _mkgmtime( // See note in remarks section about linkage struct tm* timeptr ); __time32_t _mkgmtime32( @@ -48,6 +48,11 @@ The range of the **`_mkgmtime32`** function is from midnight, January 1, 1970, U Both **`gmtime`** and **`localtime`** use a common static buffer for the conversion. If you supply this buffer to **`_mkgmtime`**, the previous contents are destroyed. +> [!Note] +> When you use Windows SDK version 10.0.26100.6901 and Visual Studio 2026 or later together, `_mkgmtime` is no longer `static inline` (internal linkage). Instead, it's `inline` (external linkage).\ +> To return to the previous behavior, `#define _STATIC_INLINE_UCRT_FUNCTIONS=1` before including any CRT headers. By default, `_STATIC_INLINE_UCRT_FUNCTIONS` is set to 0.\ +> This change increases UCRT conformance with the C++ standard and improves compatibility with C++ modules. + ## Examples ```C diff --git a/docs/c-runtime-library/reference/mktime-mktime32-mktime64.md b/docs/c-runtime-library/reference/mktime-mktime32-mktime64.md index 51d9a4265a6..7f7bb31a6c9 100644 --- a/docs/c-runtime-library/reference/mktime-mktime32-mktime64.md +++ b/docs/c-runtime-library/reference/mktime-mktime32-mktime64.md @@ -16,7 +16,7 @@ Convert the local time to a calendar value. ## Syntax ```C -time_t mktime( +time_t mktime( // See note in remarks section about linkage struct tm *timeptr ); __time32_t _mktime32( @@ -62,6 +62,11 @@ These functions validate their parameter. If *`timeptr`* is a null pointer, the By default, this function's global state is scoped to the application. To change this behavior, see [Global state in the CRT](../global-state.md). +> [!Note] +> When you use Windows SDK version 10.0.26100.6901 and Visual Studio 2026 or later together, `mktime` is no longer `static inline` (internal linkage). Instead, it's `inline` (external linkage).\ +> To return to the previous behavior, `#define _STATIC_INLINE_UCRT_FUNCTIONS=1` before including any CRT headers. By default, `_STATIC_INLINE_UCRT_FUNCTIONS` is set to 0.\ +> This change increases UCRT conformance with the C++ standard and improves compatibility with C++ modules. + ## Requirements | Routine | Required header | diff --git a/docs/c-runtime-library/reference/modf-modff-modfl.md b/docs/c-runtime-library/reference/modf-modff-modfl.md index 80f2a849e47..8b55826f947 100644 --- a/docs/c-runtime-library/reference/modf-modff-modfl.md +++ b/docs/c-runtime-library/reference/modf-modff-modfl.md @@ -1,7 +1,7 @@ --- title: "modf, modff, modfl" description: "API reference for modf, modff, and modfl; which split a floating-point value into fractional and integer parts." -ms.date: "1/15/2021" +ms.date: 1/15/2021 api_name: ["modff", "modf", "modfl", "_o_modf", "_o_modff"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll", "api-ms-win-crt-math-l1-1-0.dll"] api_type: ["DLLExport"] @@ -52,7 +52,7 @@ By default, this function's global state is scoped to the application. To change | Routine | Required header | |---|---| -| **`modf`**, **`modff`**, **`modfl`** | C: ``

C++: , `` or `` | +| **`modf`**, **`modff`**, **`modfl`** | C: ``

C++: `` or `` | For more compatibility information, see [Compatibility](../compatibility.md). diff --git a/docs/c-runtime-library/reference/msize-dbg.md b/docs/c-runtime-library/reference/msize-dbg.md index 01ea05ea499..14b02c921cb 100644 --- a/docs/c-runtime-library/reference/msize-dbg.md +++ b/docs/c-runtime-library/reference/msize-dbg.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: _msize_dbg" title: "_msize_dbg" -ms.date: "11/04/2016" +description: "Learn more about: _msize_dbg" +ms.date: 11/04/2016 api_name: ["_msize_dbg"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll"] api_type: ["DLLExport"] @@ -36,7 +36,7 @@ On successful completion, **`_msize_dbg`** returns the size (in bytes) of the sp ## Remarks -**`_msize_dbg`** is a debug version of the _[`msize`](msize.md) function. When [`_DEBUG`](../debug.md) isn't defined, each call to **`_msize_dbg`** is reduced to a call to `_msize`. Both `_msize` and **`_msize_dbg`** calculate the size of a memory block in the base heap, but **`_msize_dbg`** adds two debugging features: It includes the buffers on either side of the user portion of the memory block in the returned size and it allows size calculations for specific block types. +**`_msize_dbg`** is a debug version of the [`_msize`](msize.md) function. When [`_DEBUG`](../debug.md) isn't defined, each call to **`_msize_dbg`** is reduced to a call to `_msize`. Both `_msize` and **`_msize_dbg`** calculate the size of a memory block in the base heap, but **`_msize_dbg`** adds two debugging features: It includes the buffers on either side of the user portion of the memory block in the returned size and it allows size calculations for specific block types. For information about how memory blocks are allocated, initialized, and managed in the debug version of the base heap, see [CRT debug heap details](../crt-debug-heap-details.md). For information about the allocation block types and how they're used, see [Types of blocks on the debug heap](../crt-debug-heap-details.md#types-of-blocks-on-the-debug-heap). For information about the differences between standard heap functions and the debug versions, see [Debug versions of heap allocation functions](../debug-versions-of-heap-allocation-functions.md). diff --git a/docs/c-runtime-library/reference/nearbyint-nearbyintf-nearbyintl1.md b/docs/c-runtime-library/reference/nearbyint-nearbyintf-nearbyintl1.md index 17a159e822e..e94c9df0707 100644 --- a/docs/c-runtime-library/reference/nearbyint-nearbyintf-nearbyintl1.md +++ b/docs/c-runtime-library/reference/nearbyint-nearbyintf-nearbyintl1.md @@ -1,14 +1,13 @@ --- title: "nearbyint, nearbyintf, nearbyintl" description: "API reference for nearbyint, nearbyintf, and nearbyintl; which rounds the specified floating-point value to an integer, and returns that value in a floating-point format." -ms.date: "9/1/2020" +ms.date: 9/1/2020 api_name: ["nearbyint", "nearbyintf", "nearbyintl", "_o_nearbyint", "_o_nearbyintf", "_o_nearbyintl"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll", "api-ms-win-crt-math-l1-1-0.dll"] api_type: ["DLLExport"] topic_type: ["apiref"] f1_keywords: ["nearbyint", "nearbyintf", "nearbyintl", "math/nearbyint", "math/narbyintf", "math/narbyintl"] helpviewer_keywords: ["nearbyint function", "nearbyintf function", "nearbyintl function"] -ms.assetid: dd39cb68-96b0-434b-820f-6ff2ea65584f --- # `nearbyint`, `nearbyintf`, `nearbyintl` @@ -20,7 +19,7 @@ Rounds the specified floating-point value to an integer, and returns that value double nearbyint( double x ); float nearbyintf( float x ); long double nearbyintl( long double x ); -#define nearbyint( X ) // Requires C11 or higher +#define nearbyint( X ) // Requires C11 or later float nearbyint( float x ); //C++ only long double nearbyint( long double x ); //C++ only diff --git a/docs/c-runtime-library/reference/nextafter-functions.md b/docs/c-runtime-library/reference/nextafter-functions.md index f4945d818ea..1e4d8da31d0 100644 --- a/docs/c-runtime-library/reference/nextafter-functions.md +++ b/docs/c-runtime-library/reference/nextafter-functions.md @@ -1,7 +1,7 @@ --- title: "nextafter, nextafterf, nextafterl, _nextafter, _nextafterf, nexttoward, nexttowardf, nexttowardl" description: "API reference for nextafter, nextafterf, nextafterl, _nextafter, _nextafterf, nexttoward, nexttowardf, and nexttowardl; which return the next representable floating-point value." -ms.date: "1/15/2021" +ms.date: 1/15/2021 api_name: ["nextafterf", "_nextafterf", "nextafter", "nextafterl", "_nextafter", "nexttoward", "nexttowardf", "nexttowardl", "_o__nextafter", "_o_nextafter", "_o_nextafterf", "_o_nextafterl", "_o_nexttoward", "_o_nexttowardf", "_o_nexttowardl", "_o__nextafterf"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll", "api-ms-win-crt-math-l1-1-0.dll"] api_type: ["DLLExport"] @@ -23,13 +23,13 @@ long double nextafterl( long double x, long double y ); double _nextafter( double x, double y ); float _nextafterf( float x, float y ); /* x64 only */ -#define nextafter(X, Y) // Requires C11 or higher +#define nextafter(X, Y) // Requires C11 or later double nexttoward( double x, long double y ); float nexttowardf( float x, long double y ); long double nexttowardl( long double x, long double y ); -#define nexttoward(X, Y) // Requires C11 or higher +#define nexttoward(X, Y) // Requires C11 or later float nextafter( float x, float y ); /* C++ only, requires */ long double nextafter( long double x, long double y ); /* C++ only, requires */ @@ -68,7 +68,7 @@ By default, this function's global state is scoped to the application. To change |---|---|---| | **`nextafter`**, **`nextafterf`**, **`nextafterl`**, **`_nextafterf`**, **`nexttoward`**, **`nexttowardf`**, **`nexttowardl`** | `` | `` or `` | | **`_nextafter`** | `` | `` or `` | -| **`nextafter`** macro, **`nexttoward`** macro | `` | | +| **`nextafter`** macro, **`nexttoward`** macro | `` | | For more compatibility information, see [Compatibility](../compatibility.md). diff --git a/docs/c-runtime-library/reference/not.md b/docs/c-runtime-library/reference/not.md index 54b1235ef3b..a878828337e 100644 --- a/docs/c-runtime-library/reference/not.md +++ b/docs/c-runtime-library/reference/not.md @@ -1,13 +1,12 @@ --- -description: "Learn more about: not" title: "not" +description: "Learn more about: not" ms.date: "11/04/2016" api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll"] api_type: ["DLLExport"] topic_type: ["apiref"] f1_keywords: ["std::not", "std.not", "ISO646/not", "not"] helpviewer_keywords: ["not function"] -ms.assetid: d2ddbd5c-33c0-4aff-8961-feac155b4ba1 --- # `not` @@ -16,7 +15,6 @@ An alternative to the **`!`** operator. ## Syntax ```C - #define not ! ``` diff --git a/docs/c-runtime-library/reference/open-wopen.md b/docs/c-runtime-library/reference/open-wopen.md index 6b72d3b25f5..13237079cad 100644 --- a/docs/c-runtime-library/reference/open-wopen.md +++ b/docs/c-runtime-library/reference/open-wopen.md @@ -1,6 +1,6 @@ --- -description: "Learn more about: _open, _wopen" title: "_open, _wopen" +description: "Learn more about: _open, _wopen" ms.date: 05/18/2022 api_name: ["_open", "_wopen"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll", "api-ms-win-crt-stdio-l1-1-0.dll"] @@ -8,7 +8,6 @@ api_type: ["DLLExport"] topic_type: ["apiref"] f1_keywords: ["CORECRT_IO/_open", "CORECRT_WIO/_wopen", "TCHAR/_topen", "_open", "_wopen", "_topen"] helpviewer_keywords: ["opening files, for file I/O", "topen function", "_open function", "_topen function", "_wopen function", "files [C++], opening", "wopen function", "open function"] -ms.assetid: 13f6a0c3-d1aa-450d-a7aa-74abc91b163e --- # `_open`, `_wopen` @@ -79,7 +78,7 @@ The **`_open`** function opens the file specified by *`filename`* and prepares i | `_O_RDONLY` | Opens a file for reading only. Can't be specified with `_O_RDWR` or `_O_WRONLY`. | | `_O_RDWR` | Opens a file for both reading and writing. Can't be specified with `_O_RDONLY` or `_O_WRONLY`. | | `_O_SEQUENTIAL` | Specifies that caching is optimized for, but not restricted to, sequential access from disk. | -| `_O_TEXT` | Opens a file in ANSI text (translated) mode. (For more information, see [Text and binary mode file I/O](../text-and-binary-mode-file-i-o.md) and [`fopen`](fopen-wfopen.md).) | +| `_O_TEXT` | Opens a file in ANSI text (translated) mode. For more information, see [Text and binary mode file I/O](../text-and-binary-mode-file-i-o.md) and [`fopen`](fopen-wfopen.md). | | `_O_TRUNC` | Opens a file and truncates it to zero length; the file must have write permission. Can't be specified with `_O_RDONLY`. `_O_TRUNC` used with `_O_CREAT` opens an existing file or creates a file. **Note:** The `_O_TRUNC` flag destroys the contents of the specified file. | | `_O_WRONLY` | Opens a file for writing only. Can't be specified with `_O_RDONLY` or `_O_RDWR`. | | `_O_U16TEXT` | Opens a file in Unicode UTF-16 mode. | @@ -96,7 +95,7 @@ If **`_open`** is called with **`_O_WRONLY | _O_APPEND`** (append mode) and `_O_ When two or more manifest constants are used to form the *`oflag`* argument, the constants are combined with the bitwise-OR operator ( **`|`** ). For a discussion of binary and text modes, see [Text and binary mode file I/O](../text-and-binary-mode-file-i-o.md). -The *`pmode`* argument is required only when `_O_CREAT` is specified. If the file already exists, *`pmode`* is ignored. Otherwise, *`pmode`* specifies the file permission settings, which are set when the new file is closed the first time. **`_open`** applies the current file-permission mask to *`pmode`* before the permissions are set. (For more information, see [`_umask`](umask.md).) *`pmode`* is an integer expression that contains one or both of the following manifest constants, which are defined in ``. +The *`pmode`* argument is required only when `_O_CREAT` is specified. If the file already exists, *`pmode`* is ignored. Otherwise, *`pmode`* specifies the file permission settings, which are set when the new file is closed the first time. **`_open`** applies the current file-permission mask to *`pmode`* before the permissions are set. For more information, see [`_umask`](umask.md). *`pmode`* is an integer expression that contains one or both of the following manifest constants, which are defined in ``. | *`pmode`* | Meaning | |--|--| diff --git a/docs/c-runtime-library/reference/or-eq.md b/docs/c-runtime-library/reference/or-eq.md index f9861186e4e..86d34f9fb7c 100644 --- a/docs/c-runtime-library/reference/or-eq.md +++ b/docs/c-runtime-library/reference/or-eq.md @@ -1,13 +1,12 @@ --- -description: "Learn more about: or_eq" title: "or_eq" +description: "Learn more about: or_eq" ms.date: "11/04/2016" api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll"] api_type: ["DLLExport"] topic_type: ["apiref"] f1_keywords: ["std::or_eq", "ISO646/or_eq", "or_eq", "std.or_eq"] helpviewer_keywords: ["or_eq function"] -ms.assetid: 1eb92464-ed58-40d8-a30e-f0a6aa2f4318 --- # `or_eq` @@ -16,7 +15,6 @@ An alternative to the `|=` operator. ## Syntax ```C - #define or_eq |= ``` diff --git a/docs/c-runtime-library/reference/pow-powf-powl.md b/docs/c-runtime-library/reference/pow-powf-powl.md index bedf5a9dcf7..dbc3247460f 100644 --- a/docs/c-runtime-library/reference/pow-powf-powl.md +++ b/docs/c-runtime-library/reference/pow-powf-powl.md @@ -1,14 +1,13 @@ --- title: "pow, powf, powl" description: "API reference for pow, powf, and powl; which calculate exponents." -ms.date: "08/31/2020" +ms.date: 08/31/2020 api_name: ["powl", "pow", "powf", "_o_pow", "_o_powf"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll", "api-ms-win-crt-math-l1-1-0.dll"] api_type: ["DLLExport"] topic_type: ["apiref"] f1_keywords: ["powl", "pow", "_powl", "powf"] helpviewer_keywords: ["exponential calculations", "powl function", "_powl function", "exponentiation", "powers, calculating", "calculating exponentials", "powf function", "pow function"] -ms.assetid: e75c33ed-2e59-48b1-be40-81da917324f1 --- # `pow`, `powf`, `powl` @@ -20,7 +19,7 @@ Calculates *`x`* raised to the power of *`y`*. double pow( double x, double y ); float powf( float x, float y ); long double powl( long double x, long double y ); -define pow(X, Y) // Requires C11 or higher +define pow(X, Y) // Requires C11 or later double pow( double x, int y ); // C++ only float pow( float x, float y ); // C++ only diff --git a/docs/c-runtime-library/reference/raise.md b/docs/c-runtime-library/reference/raise.md index 2b33716eae2..e3fe3e05b62 100644 --- a/docs/c-runtime-library/reference/raise.md +++ b/docs/c-runtime-library/reference/raise.md @@ -14,7 +14,7 @@ helpviewer_keywords: ["signals, sending to executing programs", "raise function" Sends a signal to the executing program. > [!NOTE] -> Do not use this method to shut down a Microsoft Store app, except in testing or debugging scenarios. Programmatic or UI ways to close a Store app are not permitted according to the [Microsoft Store policies](/legal/windows/agreements/store-policies). For more information, see [UWP app lifecycle](/windows/uwp/launch-resume/app-lifecycle). +> Do not use this method to shut down a Microsoft Store app, except in testing or debugging scenarios. Programmatic or UI ways to close a Store app are not permitted according to the [Microsoft Store policies](/windows/apps/publish/store-policies). For more information, see [UWP app lifecycle](/windows/uwp/launch-resume/app-lifecycle). ## Syntax diff --git a/docs/c-runtime-library/reference/recalloc.md b/docs/c-runtime-library/reference/recalloc.md index 2e10f1ee093..09cd09dea34 100644 --- a/docs/c-runtime-library/reference/recalloc.md +++ b/docs/c-runtime-library/reference/recalloc.md @@ -1,6 +1,6 @@ --- -description: "Learn more about: _recalloc" title: "_recalloc" +description: "Learn more about: _recalloc" ms.date: "4/2/2020" api_name: ["_recalloc", "_o__recalloc"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll", "api-ms-win-crt-heap-l1-1-0.dll"] @@ -8,7 +8,6 @@ api_type: ["DLLExport"] topic_type: ["apiref"] f1_keywords: ["_recalloc", "recalloc"] helpviewer_keywords: ["_recalloc function", "recalloc function"] -ms.assetid: 1db8305a-3f03-418c-8844-bf9149f63046 --- # `_recalloc` @@ -18,7 +17,7 @@ A combination of `realloc` and `calloc`. Reallocates an array in memory and init ```C void *_recalloc( - void *memblock + void *memblock, size_t num, size_t size ); diff --git a/docs/c-runtime-library/reference/remainder-remainderf-remainderl.md b/docs/c-runtime-library/reference/remainder-remainderf-remainderl.md index 2d6f85d7ed5..807e001cd3c 100644 --- a/docs/c-runtime-library/reference/remainder-remainderf-remainderl.md +++ b/docs/c-runtime-library/reference/remainder-remainderf-remainderl.md @@ -1,14 +1,13 @@ --- title: "remainder, remainderf, remainderl" description: "API reference for remainder, remainderf, and remainderl; which compute the remainder of the quotient of two floating-point values, rounded to the nearest integral value." -ms.date: "9/1/2020" +ms.date: 9/1/2020 api_name: ["remainderl", "remainder", "remainderf", "_o_remainder", "_o_remainderf", "_o_remainderl"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll", "api-ms-win-crt-math-l1-1-0.dll"] api_type: ["DLLExport"] topic_type: ["apiref"] f1_keywords: ["remainderf", "remainder", "remainderl"] helpviewer_keywords: ["remainderf", "remainderl", "remainder"] -ms.assetid: 5f721fb3-8b78-4597-9bc0-ca9bcd1f1d0e --- # `remainder`, `remainderf`, `remainderl` @@ -20,7 +19,7 @@ Computes the remainder of the quotient of two floating-point values, rounded to double remainder( double x, double y ); float remainderf( float x, float y ); long double remainderl( long double x, long double y ); -#define remainder(X, Y) // Requires C11 or higher +#define remainder(X, Y) // Requires C11 or later float remainder( float x, float y ); /* C++ only */ long double remainder( long double x, long double y ); /* C++ only */ diff --git a/docs/c-runtime-library/reference/remquo-remquof-remquol.md b/docs/c-runtime-library/reference/remquo-remquof-remquol.md index 9aa96137021..d756c829f01 100644 --- a/docs/c-runtime-library/reference/remquo-remquof-remquol.md +++ b/docs/c-runtime-library/reference/remquo-remquof-remquol.md @@ -1,14 +1,13 @@ --- title: "remquo, remquof, remquol" description: "API reference for remquo, remquof, and remquol, which compute the remainder of two integer values, and store the sign and approximate magnitude of the quotient." -ms.date: "9/1/2020" +ms.date: 9/1/2020 api_name: ["remquof", "remquo", "remquol", "_o_remquo", "_o_remquof", "_o_remquol"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll", "api-ms-win-crt-math-l1-1-0.dll"] api_type: ["DLLExport"] topic_type: ["apiref"] f1_keywords: ["remquof", "remquol", "remquo"] helpviewer_keywords: ["remquol function", "remquof function", "remquo function"] -ms.assetid: a1d3cb8b-8027-4cd3-8deb-04eb17f299fc --- # `remquo`, `remquof`, `remquol` @@ -20,7 +19,7 @@ Computes the remainder of two integer values, and stores an integer value with t double remquo( double numer, double denom, int* quo ); float remquof( float numer, float denom, int* quo ); long double remquol( long double numer, long double denom, int* quo ); -#define remquo(X, Y, INT_PTR) // Requires C11 or higher +#define remquo(X, Y, INT_PTR) // Requires C11 or later float remquo( float numer, float denom, int* quo ); /* C++ only */ long double remquo( long double numer, long double denom, int* quo ); /* C++ only */ @@ -43,7 +42,7 @@ A pointer to an integer to store a value that has the sign and approximate magni ## Remarks -The **`remquo`** function calculates the floating-point remainder `f` of *`x`* / *`y`* such that *`x`* = `n` \* *`y`* + `f`*, where `n` is an integer, `f` has the same sign as *`x`*, and the absolute value of `f` is less than the absolute value of *`y`*. +The **`remquo`** function calculates the floating-point remainder `f` of *`x`* / *`y`* such that *`x`* = `n` \* *`y`* + *`f`*, where `n` is an integer, `f` has the same sign as *`x`*, and the absolute value of `f` is less than the absolute value of *`y`*. C++ allows overloading, so you can call overloads of **`remquo`** that take and return **`float`** or **`long double`** values. In a C program, unless you're using the \ macro to call this function, **`remquo`** always takes two **`double`** arguments and returns a **`double`**. diff --git a/docs/c-runtime-library/reference/rint-rintf-rintl.md b/docs/c-runtime-library/reference/rint-rintf-rintl.md index 9b129700c93..ac703cb135f 100644 --- a/docs/c-runtime-library/reference/rint-rintf-rintl.md +++ b/docs/c-runtime-library/reference/rint-rintf-rintl.md @@ -1,14 +1,13 @@ --- title: "rint, rintf, rintl" description: "API reference for rint, rintf, and rintl; which round a floating-point value to the nearest integer in floating-point format." -ms.date: "9/1/2020" +ms.date: 9/1/2020 api_name: ["rintf", "rintl", "rint", "_o_rint", "_o_rintf", "_o_rintl"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll", "api-ms-win-crt-math-l1-1-0.dll"] api_type: ["DLLExport"] topic_type: ["apiref"] f1_keywords: ["rintf", "rintl", "rint"] helpviewer_keywords: ["rintf function", "rint function", "rintl function"] -ms.assetid: 312ae3e6-278c-459a-9393-11b8f87d9184 --- # `rint`, `rintf`, `rintl` @@ -20,7 +19,7 @@ Rounds a floating-point value to the nearest integer in floating-point format. double rint( double x ); float rintf( float x ); long double rintl( long double x ); -#define rint(X) // Requires C11 or higher +#define rint(X) // Requires C11 or later float rint( float x ); // C++ only long double rint( long double x ); // C++ only diff --git a/docs/c-runtime-library/reference/rmtmp.md b/docs/c-runtime-library/reference/rmtmp.md index 857dc4c0355..7fac6abd1a6 100644 --- a/docs/c-runtime-library/reference/rmtmp.md +++ b/docs/c-runtime-library/reference/rmtmp.md @@ -1,6 +1,6 @@ --- -description: "Learn more about: _rmtmp" title: "_rmtmp" +description: "Learn more about: _rmtmp" ms.date: "4/2/2020" api_name: ["_rmtmp", "_o__rmtmp"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll", "api-ms-win-crt-stdio-l1-1-0.dll"] @@ -8,7 +8,6 @@ api_type: ["DLLExport"] topic_type: ["apiref"] f1_keywords: ["_rmtmp"] helpviewer_keywords: ["removing temporary files", "_rmtmp function", "files [C++], temporary", "rmtmp function", "files [C++], removing", "temporary files [C++], removing"] -ms.assetid: 7419501e-2587-4f2a-b469-0dca07f84736 --- # `_rmtmp` @@ -17,7 +16,6 @@ Removes temporary files. ## Syntax ```C - int _rmtmp( void ); ``` diff --git a/docs/c-runtime-library/reference/rotl-rotl64-rotr-rotr64.md b/docs/c-runtime-library/reference/rotl-rotl64-rotr-rotr64.md index dfdbaae96f2..c095e8cadae 100644 --- a/docs/c-runtime-library/reference/rotl-rotl64-rotr-rotr64.md +++ b/docs/c-runtime-library/reference/rotl-rotl64-rotr-rotr64.md @@ -8,7 +8,6 @@ api_type: ["DLLExport"] topic_type: ["apiref"] f1_keywords: ["_rotr64", "rotl64", "_rotl64", "rotr64", "rotr", "_rotr", "_rotl", "rotl"] helpviewer_keywords: ["rotl64 function", "_rotl function", "rotr function", "rotr64 function", "_rotr function", "rotl function", "_rotl64 function", "rotating bits", "_rotr64 function", "bits, rotating"] -ms.assetid: cfce439b-366f-4584-8ab1-d527b13fcfc6 --- # `_rotl`, `_rotl64`, `_rotr`, `_rotr64` @@ -17,7 +16,6 @@ Rotates bits to the left (**`_rotl`**) or right (**`_rotr`**). ## Syntax ```C - unsigned int _rotl( unsigned int value, int shift diff --git a/docs/c-runtime-library/reference/round-roundf-roundl.md b/docs/c-runtime-library/reference/round-roundf-roundl.md index a5a0f37b5f0..df753b8e603 100644 --- a/docs/c-runtime-library/reference/round-roundf-roundl.md +++ b/docs/c-runtime-library/reference/round-roundf-roundl.md @@ -1,14 +1,13 @@ --- title: "round, roundf, roundl" description: "API reference for round, roundf, and roundl; which round a floating-point value to the nearest integer value." -ms.date: "09/25/2020" +ms.date: 09/25/2020 api_name: ["round", "roundl", "roundf", "_o_round", "_o_roundf", "_o_roundl"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll", "api-ms-win-crt-math-l1-1-0.dll"] api_type: ["DLLExport"] topic_type: ["apiref"] f1_keywords: ["roundf", "roundl", "round"] helpviewer_keywords: ["roundl function", "round function", "roundf function"] -ms.assetid: 6be90877-193c-4b80-a32b-c3eca33f9c6f --- # `round`, `roundf`, `roundl` @@ -32,7 +31,7 @@ float roundf( long double roundl( long double x ); -#define round(X) // Requires C11 or higher +#define round(X) // Requires C11 or later ``` ### Parameters diff --git a/docs/c-runtime-library/reference/rtc-numerrors.md b/docs/c-runtime-library/reference/rtc-numerrors.md index d512c8f4027..f2428d8e7a7 100644 --- a/docs/c-runtime-library/reference/rtc-numerrors.md +++ b/docs/c-runtime-library/reference/rtc-numerrors.md @@ -1,6 +1,6 @@ --- -description: "Learn more about: _RTC_NumErrors" title: "_RTC_NumErrors" +description: "Learn more about: _RTC_NumErrors" ms.date: "11/04/2016" api_name: ["_RTC_NumErrors"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll"] @@ -8,7 +8,6 @@ api_type: ["DLLExport"] topic_type: ["apiref"] f1_keywords: ["_RTC_NumErrors", "RTC_NumErrors"] helpviewer_keywords: ["run-time errors", "_RTC_NumErrors function", "RTC_NumErrors function"] -ms.assetid: 7e82adae-38e2-4f8b-bc0b-37bda8109fd1 --- # `_RTC_NumErrors` @@ -17,7 +16,6 @@ Returns the total number of errors that can be detected by run-time error checks ## Syntax ```C - int _RTC_NumErrors( void ); ``` diff --git a/docs/c-runtime-library/reference/scalbn-scalbnf-scalbnl-scalbln-scalblnf-scalblnl.md b/docs/c-runtime-library/reference/scalbn-scalbnf-scalbnl-scalbln-scalblnf-scalblnl.md index 53eccc387bb..e8633ee0086 100644 --- a/docs/c-runtime-library/reference/scalbn-scalbnf-scalbnl-scalbln-scalblnf-scalblnl.md +++ b/docs/c-runtime-library/reference/scalbn-scalbnf-scalbnl-scalbln-scalblnf-scalblnl.md @@ -1,14 +1,13 @@ --- title: "scalbn, scalbnf, scalbnl, scalbln, scalblnf, scalblnl" description: "API reference for scalbn, scalbnf, scalbnl, scalbln, scalblnf, and scalblnl; which multiplies a floating-point number by an integral power of `FLT_RADIX`." -ms.date: "9/1/2020" +ms.date: 9/1/2020 api_name: ["scalblnl", "scalbnl", "scalbnf", "scalblnf", "scalbn", "scalbln", "_o_scalbln", "_o_scalblnf", "_o_scalblnl", "_o_scalbn", "_o_scalbnf", "_o_scalbnl"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll", "api-ms-win-crt-math-l1-1-0.dll"] api_type: ["DLLExport"] topic_type: ["apiref"] f1_keywords: ["scalblnf", "scalbnl", "scalblnl", "scalbln", "scalbn", "scalbnf"] helpviewer_keywords: ["scalbn function", "scalbln function", "scalblnl function", "scalbnl function", "scalbnf function", "scalblnf function"] -ms.assetid: df2f1543-8e39-4af4-a5cf-29307e64807d --- # `scalbn`, `scalbnf`, `scalbnl`, `scalbln`, `scalblnf`, `scalblnl` @@ -38,7 +37,7 @@ long double scalbnl( int exp ); -#define scalbn(X, INT) // Requires C11 or higher +#define scalbn(X, INT) // Requires C11 or later double scalbln( double x, @@ -54,7 +53,7 @@ long double scalblnl( long exp ); -#define scalbln(X, LONG) // Requires C11 or higher +#define scalbln(X, LONG) // Requires C11 or later float scalbln( float x, diff --git a/docs/c-runtime-library/reference/scprintf-p-scprintf-p-l-scwprintf-p-scwprintf-p-l.md b/docs/c-runtime-library/reference/scprintf-p-scprintf-p-l-scwprintf-p-scwprintf-p-l.md index 8456b644e99..8067e1ed052 100644 --- a/docs/c-runtime-library/reference/scprintf-p-scprintf-p-l-scwprintf-p-scwprintf-p-l.md +++ b/docs/c-runtime-library/reference/scprintf-p-scprintf-p-l-scwprintf-p-scwprintf-p-l.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: _scprintf_p, _scprintf_p_l, _scwprintf_p, _scwprintf_p_l" title: "_scprintf_p, _scprintf_p_l, _scwprintf_p, _scwprintf_p_l" -ms.date: "3/9/2021" +description: "Learn more about: _scprintf_p, _scprintf_p_l, _scwprintf_p, _scwprintf_p_l" +ms.date: 3/9/2021 api_name: ["_scwprintf_p", "_scprintf_p_l", "_scwprintf_p_l", "_scprintf_p"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll"] api_type: ["DLLExport"] @@ -66,7 +66,7 @@ The versions of these functions with the `_l` suffix are identical except that t > [!IMPORTANT] > Ensure that *`format`* is not a user-defined string. > -> Starting in Windows 10 version 2004 (build 19041), the `printf` family of functions prints exactly representable floating point numbers according to the IEEE 754 rules for rounding. In previous versions of Windows, exactly representable floating point numbers ending in '5' would always round up. IEEE 754 states that they must round to the closest even digit (also known as "Banker's Rounding"). For example, both `printf("%1.0f", 1.5)` and `printf("%1.0f", 2.5)` should round to 2. Previously, 1.5 would round to 2 and 2.5 would round to 3. This change only affects exactly representable numbers. For example, 2.35 (which, when represented in memory, is closer to 2.35000000000000008) continues to round up to 2.4. Rounding done by these functions now also respects the floating point rounding mode set by [`fesetround`](fegetround-fesetround2.md). Previously, rounding always chose `FE_TONEAREST` behavior. This change only affects programs built using Visual Studio 2019 version 16.2 and later. To use the legacy floating point rounding behavior, link with ['legacy_stdio_float_rounding.obj`](../link-options.md). +> Starting in Windows 10 version 2004 (build 19041), the `printf` family of functions prints exactly representable floating point numbers according to the IEEE 754 rules for rounding. In previous versions of Windows, exactly representable floating point numbers ending in '5' would always round up. IEEE 754 states that they must round to the closest even digit (also known as "Banker's Rounding"). For example, both `printf("%1.0f", 1.5)` and `printf("%1.0f", 2.5)` should round to 2. Previously, 1.5 would round to 2 and 2.5 would round to 3. This change only affects exactly representable numbers. For example, 2.35 (which, when represented in memory, is closer to 2.35000000000000008) continues to round up to 2.4. Rounding done by these functions now also respects the floating point rounding mode set by [`fesetround`](fegetround-fesetround2.md). Previously, rounding always chose `FE_TONEAREST` behavior. This change only affects programs built using Visual Studio 2019 version 16.2 and later. To use the legacy floating point rounding behavior, link with [`legacy_stdio_float_rounding.obj`](../link-options.md). ### Generic-text routine mappings diff --git a/docs/c-runtime-library/reference/scprintf-scprintf-l-scwprintf-scwprintf-l.md b/docs/c-runtime-library/reference/scprintf-scprintf-l-scwprintf-scwprintf-l.md index 49789f506dc..0d2d23af0d5 100644 --- a/docs/c-runtime-library/reference/scprintf-scprintf-l-scwprintf-scwprintf-l.md +++ b/docs/c-runtime-library/reference/scprintf-scprintf-l-scwprintf-scwprintf-l.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: _scprintf, _scprintf_l, _scwprintf, _scwprintf_l" title: "_scprintf, _scprintf_l, _scwprintf, _scwprintf_l" -ms.date: "3/9/2021" +description: "Learn more about: _scprintf, _scprintf_l, _scwprintf, _scwprintf_l" +ms.date: 3/9/2021 api_name: ["_scprintf_l", "_scwprintf", "_scwprintf_l", "_scprintf"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll"] api_type: ["DLLExport"] @@ -66,7 +66,7 @@ The versions of these functions with the `_l` suffix are identical except that t > [!IMPORTANT] > Ensure that *`format`* is not a user-defined string. > -> Starting in Windows 10 version 2004 (build 19041), the `printf` family of functions prints exactly representable floating point numbers according to the IEEE 754 rules for rounding. In previous versions of Windows, exactly representable floating point numbers ending in '5' would always round up. IEEE 754 states that they must round to the closest even digit (also known as "Banker's Rounding"). For example, both `printf("%1.0f", 1.5)` and `printf("%1.0f", 2.5)` should round to 2. Previously, 1.5 would round to 2 and 2.5 would round to 3. This change only affects exactly representable numbers. For example, 2.35 (which, when represented in memory, is closer to 2.35000000000000008) continues to round up to 2.4. Rounding done by these functions now also respects the floating point rounding mode set by [`fesetround`](fegetround-fesetround2.md). Previously, rounding always chose `FE_TONEAREST` behavior. This change only affects programs built using Visual Studio 2019 version 16.2 and later. To use the legacy floating point rounding behavior, link with ['legacy_stdio_float_rounding.obj`](../link-options.md). +> Starting in Windows 10 version 2004 (build 19041), the `printf` family of functions prints exactly representable floating point numbers according to the IEEE 754 rules for rounding. In previous versions of Windows, exactly representable floating point numbers ending in '5' would always round up. IEEE 754 states that they must round to the closest even digit (also known as "Banker's Rounding"). For example, both `printf("%1.0f", 1.5)` and `printf("%1.0f", 2.5)` should round to 2. Previously, 1.5 would round to 2 and 2.5 would round to 3. This change only affects exactly representable numbers. For example, 2.35 (which, when represented in memory, is closer to 2.35000000000000008) continues to round up to 2.4. Rounding done by these functions now also respects the floating point rounding mode set by [`fesetround`](fegetround-fesetround2.md). Previously, rounding always chose `FE_TONEAREST` behavior. This change only affects programs built using Visual Studio 2019 version 16.2 and later. To use the legacy floating point rounding behavior, link with [`legacy_stdio_float_rounding.obj`](../link-options.md). ### Generic-text routine mappings diff --git a/docs/c-runtime-library/reference/set-abort-behavior.md b/docs/c-runtime-library/reference/set-abort-behavior.md index 1abfb48f289..957edb74302 100644 --- a/docs/c-runtime-library/reference/set-abort-behavior.md +++ b/docs/c-runtime-library/reference/set-abort-behavior.md @@ -14,7 +14,7 @@ helpviewer_keywords: ["aborting programs", "_set_abort_behavior function", "set_ Specifies the action to be taken when a program is abnormally terminated. > [!NOTE] -> Do not use the [`abort`](abort.md) function to shut down a Microsoft Store app, except in testing or debugging scenarios. Programmatic or UI ways to close a Store app are not permitted according to the [Microsoft Store policies](/legal/windows/agreements/store-policies). For more information, see [UWP app lifecycle](/windows/uwp/launch-resume/app-lifecycle). +> Do not use the [`abort`](abort.md) function to shut down a Microsoft Store app, except in testing or debugging scenarios. Programmatic or UI ways to close a Store app are not permitted according to the [Microsoft Store policies](/windows/apps/publish/store-policies). For more information, see [UWP app lifecycle](/windows/uwp/launch-resume/app-lifecycle). ## Syntax diff --git a/docs/c-runtime-library/reference/set-error-mode.md b/docs/c-runtime-library/reference/set-error-mode.md index cdbce0d93f7..28766500919 100644 --- a/docs/c-runtime-library/reference/set-error-mode.md +++ b/docs/c-runtime-library/reference/set-error-mode.md @@ -1,14 +1,13 @@ --- -description: "Learn more about: _set_error_mode" title: "_set_error_mode" -ms.date: "11/04/2016" +description: "Learn more about: _set_error_mode" +ms.date: 11/04/2016 api_name: ["_set_error_mode"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll", "api-ms-win-crt-runtime-l1-1-0.dll"] api_type: ["DLLExport"] topic_type: ["apiref"] f1_keywords: ["set_error_mode", "_set_error_mode"] helpviewer_keywords: ["_set_error_mode function", "set_error_mode function"] -ms.assetid: f0807be5-73d1-4a32-a701-3c9bdd139c5c --- # `_set_error_mode` @@ -61,7 +60,7 @@ When it's used with an [`assert`](assert-macro-assert-wassert.md), **`_set_error ```C // crt_set_error_mode.c -// compile with: /c + #include #include diff --git a/docs/c-runtime-library/reference/signal.md b/docs/c-runtime-library/reference/signal.md index a9c623188ff..ad4bd650a1d 100644 --- a/docs/c-runtime-library/reference/signal.md +++ b/docs/c-runtime-library/reference/signal.md @@ -14,7 +14,7 @@ helpviewer_keywords: ["signal function"] Sets interrupt signal handling. > [!IMPORTANT] -> Do not use this method to shut down a Microsoft Store app, except in testing or debugging scenarios. Programmatic or UI ways to close a Store app are not permitted according to the [Microsoft Store policies](/legal/windows/agreements/store-policies). For more information, see [UWP app lifecycle](/windows/uwp/launch-resume/app-lifecycle). +> Do not use this method to shut down a Microsoft Store app, except in testing or debugging scenarios. Programmatic or UI ways to close a Store app are not permitted according to the [Microsoft Store policies](/windows/apps/publish/store-policies). For more information, see [UWP app lifecycle](/windows/uwp/launch-resume/app-lifecycle). ## Syntax diff --git a/docs/c-runtime-library/reference/sin-sinf-sinl.md b/docs/c-runtime-library/reference/sin-sinf-sinl.md index 841be1e4a43..ae1f2d1e354 100644 --- a/docs/c-runtime-library/reference/sin-sinf-sinl.md +++ b/docs/c-runtime-library/reference/sin-sinf-sinl.md @@ -1,7 +1,7 @@ --- title: "sin, sinf, sinl" description: "API reference for sin, sinf, and sinl; which calculate the sine of a floating-point value." -ms.date: "08/31/2020" +ms.date: 08/31/2020 api_name: ["sinl", "sinf", "sin", "_o_sin", "_o_sinf"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll", "api-ms-win-crt-math-l1-1-0.dll"] api_type: ["DLLExport"] @@ -19,7 +19,7 @@ Calculates the sine of a floating-point value. double sin(double x); float sinf(float x); long double sinl(long double x); -#define sin(x) // Requires C11 or higher +#define sin(x) // Requires C11 or later ``` ```cpp diff --git a/docs/c-runtime-library/reference/sinh-sinhf-sinhl.md b/docs/c-runtime-library/reference/sinh-sinhf-sinhl.md index 3a4456374e0..161a0998f1a 100644 --- a/docs/c-runtime-library/reference/sinh-sinhf-sinhl.md +++ b/docs/c-runtime-library/reference/sinh-sinhf-sinhl.md @@ -1,7 +1,7 @@ --- title: "sinh, sinhf, sinhl" description: "API reference for calculating the hyperbolic sine of a floating-point value." -ms.date: "1/15/2021" +ms.date: 1/15/2021 api_name: ["sinh", "sinhl", "sinhf", "sinhl", "_o_sinh", "_o_sinhf"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll", "api-ms-win-crt-math-l1-1-0.dll"] api_type: ["DLLExport"] @@ -19,7 +19,7 @@ Calculates the hyperbolic sine. double sinh(double x); float sinhf(float x); long double sinhl(long double x); -#define sinh(x) // Requires C11 or higher +#define sinh(x) // Requires C11 or later float sinh(float x); // C++ only long double sinh(long double x); // C++ only diff --git a/docs/c-runtime-library/reference/snprintf-s-snprintf-s-l-snwprintf-s-snwprintf-s-l.md b/docs/c-runtime-library/reference/snprintf-s-snprintf-s-l-snwprintf-s-snwprintf-s-l.md index 548a9fccf6f..9b0fce0a47d 100644 --- a/docs/c-runtime-library/reference/snprintf-s-snprintf-s-l-snwprintf-s-snwprintf-s-l.md +++ b/docs/c-runtime-library/reference/snprintf-s-snprintf-s-l-snwprintf-s-snwprintf-s-l.md @@ -1,6 +1,6 @@ --- -description: "Learn more about: _snprintf_s, _snprintf_s_l, _snwprintf_s, _snwprintf_s_l" title: "_snprintf_s, _snprintf_s_l, _snwprintf_s, _snwprintf_s_l" +description: "Learn more about: _snprintf_s, _snprintf_s_l, _snwprintf_s, _snwprintf_s_l" ms.date: 06/27/2023 api_name: ["_snprintf_s", "_snprintf_s_l", "_snwprintf_s", "_snwprintf_s_l"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll", "ntoskrnl.exe"] @@ -126,7 +126,7 @@ For information about these and other error codes, see [`_doserrno`, `errno`, `_ > [!IMPORTANT] > Ensure that *`format`* is not a user-defined string. > -> Starting in Windows 10 version 2004 (build 19041), the `printf` family of functions prints exactly representable floating point numbers according to the IEEE 754 rules for rounding. In previous versions of Windows, exactly representable floating point numbers ending in '5' would always round up. IEEE 754 states that they must round to the closest even digit (also known as "Banker's Rounding"). For example, both `printf("%1.0f", 1.5)` and `printf("%1.0f", 2.5)` should round to 2. Previously, 1.5 would round to 2 and 2.5 would round to 3. This change only affects exactly representable numbers. For example, 2.35 (which, when represented in memory, is closer to 2.35000000000000008) continues to round up to 2.4. Rounding done by these functions now also respects the floating point rounding mode set by [`fesetround`](fegetround-fesetround2.md). Previously, rounding always chose `FE_TONEAREST` behavior. This change only affects programs built using Visual Studio 2019 version 16.2 and later. To use the legacy floating point rounding behavior, link with ['legacy_stdio_float_rounding.obj`](../link-options.md). +> Starting in Windows 10 version 2004 (build 19041), the `printf` family of functions prints exactly representable floating point numbers according to the IEEE 754 rules for rounding. In previous versions of Windows, exactly representable floating point numbers ending in '5' would always round up. IEEE 754 states that they must round to the closest even digit (also known as "Banker's Rounding"). For example, both `printf("%1.0f", 1.5)` and `printf("%1.0f", 2.5)` should round to 2. Previously, 1.5 would round to 2 and 2.5 would round to 3. This change only affects exactly representable numbers. For example, 2.35 (which, when represented in memory, is closer to 2.35000000000000008) continues to round up to 2.4. Rounding done by these functions now also respects the floating point rounding mode set by [`fesetround`](fegetround-fesetround2.md). Previously, rounding always chose `FE_TONEAREST` behavior. This change only affects programs built using Visual Studio 2019 version 16.2 and later. To use the legacy floating point rounding behavior, link with [`legacy_stdio_float_rounding.obj`](../link-options.md). **`_snwprintf_s`** is a wide-character version of **`_snprintf_s`**; the pointer arguments to **`_snwprintf_s`** are wide-character strings. Detection of encoding errors in **`_snwprintf_s`** might differ from that in **`_snprintf_s`**. **`_snwprintf_s`**, like **`swprintf_s`**, writes output to a string rather than to a destination of type **`FILE`**. diff --git a/docs/c-runtime-library/reference/snprintf-snprintf-snprintf-l-snwprintf-snwprintf-l.md b/docs/c-runtime-library/reference/snprintf-snprintf-snprintf-l-snwprintf-snwprintf-l.md index 6adfc17e2ef..a9ceb9d7a60 100644 --- a/docs/c-runtime-library/reference/snprintf-snprintf-snprintf-l-snwprintf-snwprintf-l.md +++ b/docs/c-runtime-library/reference/snprintf-snprintf-snprintf-l-snwprintf-snwprintf-l.md @@ -120,7 +120,7 @@ See [Behavior summary](#behavior-summary) for details. ## Remarks -Beginning with the UCRT in Visual Studio 2015 and Windows 10, **`snprintf`** is no longer identical to **`_snprintf`**. The **`snprintf`** behavior is now C99 standard conformant. The difference is that if you run out of buffer, `snprintf` null-terminates the end of the buffer and returns the number of characters that would have been required whereas `_snprintf` doesn't null-terminate the buffer and returns -1. Also, `snprintf()` includes one more character in the output because it doesn't null-terminate the buffer. +Beginning with the UCRT in Visual Studio 2015 and Windows 10, **`snprintf`** is no longer identical to **`_snprintf`**. The **`snprintf`** behavior is now C99 standard conformant. The difference is that if you run out of buffer, `snprintf` null-terminates the end of the buffer and returns the number of characters that would have been required whereas `_snprintf` doesn't null-terminate the buffer and returns -1. Also, `_snprintf()` includes one more character in the output because it doesn't null-terminate the buffer. - **`snprintf`** and the **`_snprintf`** family of functions format and store *`count`* or fewer characters in *`buffer`*. - **`snprintf`** always stores a terminating `NULL` character, truncating the output if necessary. @@ -175,7 +175,7 @@ In C++, these functions have template overloads that invoke the newer, more secu | Routine | Required header | |---|---| -| **`snprintf`**, **`_snprintf`**, **`_snprintf_l`** | `` | +| **`snprintf`**, **`_snprintf`**, **`_snprintf_l`** | `` | | **`_snwprintf`**, **`_snwprintf_l`** | `` or `` | For more compatibility information, see [Compatibility](../compatibility.md). diff --git a/docs/c-runtime-library/reference/sopen-s-wsopen-s.md b/docs/c-runtime-library/reference/sopen-s-wsopen-s.md index 3b1480c69a7..9be97bd7694 100644 --- a/docs/c-runtime-library/reference/sopen-s-wsopen-s.md +++ b/docs/c-runtime-library/reference/sopen-s-wsopen-s.md @@ -1,6 +1,6 @@ --- -description: "Learn more about: _sopen_s, _wsopen_s" title: "_sopen_s, _wsopen_s" +description: "Learn more about: _sopen_s, _wsopen_s" ms.date: 05/18/2022 api_name: ["_sopen_s", "_wsopen_s", "_o__sopen_s", "_o__wsopen_s"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll", "api-ms-win-crt-stdio-l1-1-0.dll"] @@ -8,7 +8,6 @@ api_type: ["DLLExport"] topic_type: ["apiref"] f1_keywords: ["CORECRT_IO/_sopen_s", "CORECRT_WIO/_wsopen_s", "TCHAR/_tsopen_s", "_sopen_s", "_wsopen_s", "_tsopen_s", "sopen_s", "wsopen_s"] helpviewer_keywords: ["sopen_s function", "_wsopen_s function", "wsopen_s function", "opening files, for sharing", "files [C++], opening", "_sopen_s function", "files [C++], sharing"] -ms.assetid: 059a0084-d08c-4973-9174-55e391b72aa2 --- # `_sopen_s`, `_wsopen_s` @@ -29,7 +28,7 @@ errno_t _wsopen_s( const wchar_t *filename, int oflag, int shflag, - int pmode, + int pmode ); ``` @@ -95,7 +94,7 @@ The integer expression *`oflag`* is formed by combining one or more manifest con | `_O_RDONLY` | Opens a file for reading only. Can't be specified with `_O_RDWR` or `_O_WRONLY`. | | `_O_RDWR` | Opens a file for both reading and writing. Can't be specified with `_O_RDONLY` or `_O_WRONLY`. | | `_O_SEQUENTIAL` | Specifies that caching is optimized for, but not restricted to, sequential access from disk. | -| `_O_TEXT` | Opens a file in ANSI text (translated) mode. (For more information, see [Text and binary mode file I/O](../text-and-binary-mode-file-i-o.md) and [`fopen`](fopen-wfopen.md).) | +| `_O_TEXT` | Opens a file in ANSI text (translated) mode. For more information, see [Text and binary mode file I/O](../text-and-binary-mode-file-i-o.md) and [`fopen`](fopen-wfopen.md). | | `_O_TRUNC` | Opens a file and truncates it to zero length; the file must have write permission. Can't be specified with `_O_RDONLY`. `_O_TRUNC` used with `_O_CREAT` opens an existing file or creates a file. **Note:** The `_O_TRUNC` flag destroys the contents of the specified file. | | `_O_WRONLY` | Opens a file for writing only. Can't be specified with `_O_RDONLY` or `_O_RDWR`. | | `_O_U16TEXT` | Opens a file in Unicode UTF-16 mode. | diff --git a/docs/c-runtime-library/reference/sopen-wsopen.md b/docs/c-runtime-library/reference/sopen-wsopen.md index c3e9b3a0aa2..8d57455bb24 100644 --- a/docs/c-runtime-library/reference/sopen-wsopen.md +++ b/docs/c-runtime-library/reference/sopen-wsopen.md @@ -1,6 +1,6 @@ --- -description: "Learn more about: _sopen, _wsopen" title: "_sopen, _wsopen" +description: "Learn more about: _sopen, _wsopen" ms.date: 05/18/2022 api_name: ["_sopen", "_wsopen", "_o__sopen"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll", "api-ms-win-crt-stdio-l1-1-0.dll"] @@ -8,7 +8,6 @@ api_type: ["DLLExport"] topic_type: ["apiref"] f1_keywords: ["CORECRT_IO/_sopen", "CORECRT_WIO/_wsopen", "TCHAR/_tsopen", "_sopen", "_wsopen", "_tsopen", "sopen", "wsopen"] helpviewer_keywords: ["sopen function", "sharing files", "opening files, for sharing", "_sopen function", "wsopen function", "files [C++], opening", "files [C++], sharing", "_wsopen function"] -ms.assetid: a9d4cccf-06e9-414d-96fa-453fca88cc1f --- # `_sopen`, `_wsopen` @@ -88,7 +87,7 @@ The integer expression *`oflag`* is formed by combining one or more of the follo | `_O_RDONLY` | Opens a file for reading only. Can't be specified with `_O_RDWR` or `_O_WRONLY`. | | `_O_RDWR` | Opens a file for both reading and writing. Can't be specified with `_O_RDONLY` or `_O_WRONLY`. | | `_O_SEQUENTIAL` | Specifies that caching is optimized for, but not restricted to, sequential access from disk. | -| `_O_TEXT` | Opens a file in ANSI text (translated) mode. (For more information, see [Text and binary mode file I/O](../text-and-binary-mode-file-i-o.md) and [`fopen`](fopen-wfopen.md).) | +| `_O_TEXT` | Opens a file in ANSI text (translated) mode. For more information, see [Text and binary mode file I/O](../text-and-binary-mode-file-i-o.md) and [`fopen`](fopen-wfopen.md). | | `_O_TRUNC` | Opens a file and truncates it to zero length; the file must have write permission. Can't be specified with `_O_RDONLY`. `_O_TRUNC` used with `_O_CREAT` opens an existing file or creates a file. **Note:** The `_O_TRUNC` flag destroys the contents of the specified file. | | `_O_WRONLY` | Opens a file for writing only. Can't be specified with `_O_RDONLY` or `_O_RDWR`. | | `_O_U16TEXT` | Opens a file in Unicode UTF-16 mode. | diff --git a/docs/c-runtime-library/reference/splitpath-wsplitpath.md b/docs/c-runtime-library/reference/splitpath-wsplitpath.md index 7f0a8c31226..f11ecc1e6d0 100644 --- a/docs/c-runtime-library/reference/splitpath-wsplitpath.md +++ b/docs/c-runtime-library/reference/splitpath-wsplitpath.md @@ -1,6 +1,6 @@ --- -description: "Learn more about: _splitpath, _wsplitpath" title: "_splitpath, _wsplitpath" +description: "Learn more about: _splitpath, _wsplitpath" ms.date: 11/30/2023 api_name: ["_wsplitpath", "_splitpath", "_o__splitpath", "_o__wsplitpath"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll", "api-ms-win-crt-filesystem-l1-1-0.dll"] @@ -41,7 +41,7 @@ Full path. Drive letter, followed by a colon (**:**). You can pass `NULL` for this parameter if you don't need the drive letter. *`dir`*\ -Directory path, including trailing slash. Forward slashes ( `/` ), backslashes ( `\` ), or both may be used. Pass `NULL` for this parameter if you don't need the directory path. +Directory path, including trailing slash. Forward slashes (`/`), backslashes (`\`), or both may be used. Pass `NULL` for this parameter if you don't need the directory path. *`fname`*\ Base filename (no extension). Pass `NULL` for this parameter if you don't need the filename. diff --git a/docs/c-runtime-library/reference/sprintf-p-sprintf-p-l-swprintf-p-swprintf-p-l.md b/docs/c-runtime-library/reference/sprintf-p-sprintf-p-l-swprintf-p-swprintf-p-l.md index 030e72c577d..2d9abe99449 100644 --- a/docs/c-runtime-library/reference/sprintf-p-sprintf-p-l-swprintf-p-swprintf-p-l.md +++ b/docs/c-runtime-library/reference/sprintf-p-sprintf-p-l-swprintf-p-swprintf-p-l.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: _sprintf_p, _sprintf_p_l, _swprintf_p, _swprintf_p_l" title: "_sprintf_p, _sprintf_p_l, _swprintf_p, _swprintf_p_l" -ms.date: "3/9/2021" +description: "Learn more about: _sprintf_p, _sprintf_p_l, _swprintf_p, _swprintf_p_l" +ms.date: 3/9/2021 api_name: ["_sprintf_p", "_swprintf_p_l", "_swprintf_p", "_sprintf_p_l"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll"] api_type: ["DLLExport"] @@ -76,7 +76,7 @@ The **`_sprintf_p`** function formats and stores a series of characters and valu **`_sprintf_p`** returns the number of bytes stored in *`buffer`*, not counting the terminating null character. **`_swprintf_p`** returns the number of wide characters stored in *`buffer`*, not counting the terminating null wide character. If *`buffer`* or *`format`* is a null pointer, or if the format string contains invalid formatting characters, the invalid parameter handler is invoked, as described in [Parameter validation](../parameter-validation.md). If execution is allowed to continue, these functions return -1 and set `errno` to `EINVAL`. > [!IMPORTANT] -> Starting in Windows 10 version 2004 (build 19041), the `printf` family of functions prints exactly representable floating point numbers according to the IEEE 754 rules for rounding. In previous versions of Windows, exactly representable floating point numbers ending in '5' would always round up. IEEE 754 states that they must round to the closest even digit (also known as "Banker's Rounding"). For example, both `printf("%1.0f", 1.5)` and `printf("%1.0f", 2.5)` should round to 2. Previously, 1.5 would round to 2 and 2.5 would round to 3. This change only affects exactly representable numbers. For example, 2.35 (which, when represented in memory, is closer to 2.35000000000000008) continues to round up to 2.4. Rounding done by these functions now also respects the floating point rounding mode set by [`fesetround`](fegetround-fesetround2.md). Previously, rounding always chose `FE_TONEAREST` behavior. This change only affects programs built using Visual Studio 2019 version 16.2 and later. To use the legacy floating point rounding behavior, link with ['legacy_stdio_float_rounding.obj`](../link-options.md). +> Starting in Windows 10 version 2004 (build 19041), the `printf` family of functions prints exactly representable floating point numbers according to the IEEE 754 rules for rounding. In previous versions of Windows, exactly representable floating point numbers ending in '5' would always round up. IEEE 754 states that they must round to the closest even digit (also known as "Banker's Rounding"). For example, both `printf("%1.0f", 1.5)` and `printf("%1.0f", 2.5)` should round to 2. Previously, 1.5 would round to 2 and 2.5 would round to 3. This change only affects exactly representable numbers. For example, 2.35 (which, when represented in memory, is closer to 2.35000000000000008) continues to round up to 2.4. Rounding done by these functions now also respects the floating point rounding mode set by [`fesetround`](fegetround-fesetround2.md). Previously, rounding always chose `FE_TONEAREST` behavior. This change only affects programs built using Visual Studio 2019 version 16.2 and later. To use the legacy floating point rounding behavior, link with [`legacy_stdio_float_rounding.obj`](../link-options.md). ### Generic-text routine mappings diff --git a/docs/c-runtime-library/reference/sprintf-s-sprintf-s-l-swprintf-s-swprintf-s-l.md b/docs/c-runtime-library/reference/sprintf-s-sprintf-s-l-swprintf-s-swprintf-s-l.md index 5e3ff04ff2a..f78c0ea9df5 100644 --- a/docs/c-runtime-library/reference/sprintf-s-sprintf-s-l-swprintf-s-swprintf-s-l.md +++ b/docs/c-runtime-library/reference/sprintf-s-sprintf-s-l-swprintf-s-swprintf-s-l.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: sprintf_s, _sprintf_s_l, swprintf_s, _swprintf_s_l" title: "sprintf_s, _sprintf_s_l, swprintf_s, _swprintf_s_l" -ms.date: "3/9/2021" +description: "Learn more about: sprintf_s, _sprintf_s_l, swprintf_s, _swprintf_s_l" +ms.date: 3/9/2021 api_name: ["_swprintf_s_l", "_sprintf_s_l", "swprintf_s", "sprintf_s"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll", "ntoskrnl.exe"] api_type: ["DLLExport"] @@ -96,7 +96,7 @@ In C++, use of these functions is simplified by template overloads. The overload There are versions of **`sprintf_s`** that offer more control over what happens if the buffer is too small. For more information, see [`_snprintf_s`, `_snprintf_s_l`, `_snwprintf_s`, `_snwprintf_s_l`](snprintf-s-snprintf-s-l-snwprintf-s-snwprintf-s-l.md). > [!IMPORTANT] -> Starting in Windows 10 version 2004 (build 19041), the `printf` family of functions prints exactly representable floating point numbers according to the IEEE 754 rules for rounding. In previous versions of Windows, exactly representable floating point numbers ending in '5' would always round up. IEEE 754 states that they must round to the closest even digit (also known as "Banker's Rounding"). For example, both `printf("%1.0f", 1.5)` and `printf("%1.0f", 2.5)` should round to 2. Previously, 1.5 would round to 2 and 2.5 would round to 3. This change only affects exactly representable numbers. For example, 2.35 (which, when represented in memory, is closer to 2.35000000000000008) continues to round up to 2.4. Rounding done by these functions now also respects the floating point rounding mode set by [`fesetround`](fegetround-fesetround2.md). Previously, rounding always chose `FE_TONEAREST` behavior. This change only affects programs built using Visual Studio 2019 version 16.2 and later. To use the legacy floating point rounding behavior, link with ['legacy_stdio_float_rounding.obj`](../link-options.md). +> Starting in Windows 10 version 2004 (build 19041), the `printf` family of functions prints exactly representable floating point numbers according to the IEEE 754 rules for rounding. In previous versions of Windows, exactly representable floating point numbers ending in '5' would always round up. IEEE 754 states that they must round to the closest even digit (also known as "Banker's Rounding"). For example, both `printf("%1.0f", 1.5)` and `printf("%1.0f", 2.5)` should round to 2. Previously, 1.5 would round to 2 and 2.5 would round to 3. This change only affects exactly representable numbers. For example, 2.35 (which, when represented in memory, is closer to 2.35000000000000008) continues to round up to 2.4. Rounding done by these functions now also respects the floating point rounding mode set by [`fesetround`](fegetround-fesetround2.md). Previously, rounding always chose `FE_TONEAREST` behavior. This change only affects programs built using Visual Studio 2019 version 16.2 and later. To use the legacy floating point rounding behavior, link with [`legacy_stdio_float_rounding.obj`](../link-options.md). ### Generic-text routine mappings diff --git a/docs/c-runtime-library/reference/sprintf-sprintf-l-swprintf-swprintf-l-swprintf-l.md b/docs/c-runtime-library/reference/sprintf-sprintf-l-swprintf-swprintf-l-swprintf-l.md index 960c47657c4..f386fc7dfd5 100644 --- a/docs/c-runtime-library/reference/sprintf-sprintf-l-swprintf-swprintf-l-swprintf-l.md +++ b/docs/c-runtime-library/reference/sprintf-sprintf-l-swprintf-swprintf-l-swprintf-l.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: sprintf, _sprintf_l, swprintf, _swprintf, _swprintf_l, __swprintf_l" title: "sprintf, _sprintf_l, swprintf, _swprintf_l, __swprintf_l" -ms.date: "3/9/2021" +description: "Learn more about: sprintf, _sprintf_l, swprintf, _swprintf, _swprintf_l, __swprintf_l" +ms.date: 3/9/2021 api_name: ["__swprintf_l", "sprintf", "_sprintf_l", "_swprintf_l", "swprintf", "_swprintf"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ntdll.dll", "ucrtbase.dll", "ntoskrnl.exe"] api_type: ["DLLExport"] @@ -105,7 +105,7 @@ The **`sprintf`** function formats and stores a series of characters and values > [!IMPORTANT] > Using **`sprintf`**, there is no way to limit the number of characters written, which means that code using **`sprintf`** is susceptible to buffer overruns. Consider using the related function [`snprintf`](snprintf-snprintf-snprintf-l-snwprintf-snwprintf-l.md), which specifies a maximum number of characters to write to *`buffer`*, or use [`_scprintf`](scprintf-scprintf-l-scwprintf-scwprintf-l.md) to determine how large a buffer is required. Also, ensure that *`format`* is not a user-defined string. > -> Starting in Windows 10 version 2004 (build 19041), the `printf` family of functions prints exactly representable floating point numbers according to the IEEE 754 rules for rounding. In previous versions of Windows, exactly representable floating point numbers ending in '5' would always round up. IEEE 754 states that they must round to the closest even digit (also known as "Banker's Rounding"). For example, both `printf("%1.0f", 1.5)` and `printf("%1.0f", 2.5)` should round to 2. Previously, 1.5 would round to 2 and 2.5 would round to 3. This change only affects exactly representable numbers. For example, 2.35 (which, when represented in memory, is closer to 2.35000000000000008) continues to round up to 2.4. Rounding done by these functions now also respects the floating point rounding mode set by [`fesetround`](fegetround-fesetround2.md). Previously, rounding always chose `FE_TONEAREST` behavior. This change only affects programs built using Visual Studio 2019 version 16.2 and later. To use the legacy floating point rounding behavior, link with ['legacy_stdio_float_rounding.obj`](../link-options.md). +> Starting in Windows 10 version 2004 (build 19041), the `printf` family of functions prints exactly representable floating point numbers according to the IEEE 754 rules for rounding. In previous versions of Windows, exactly representable floating point numbers ending in '5' would always round up. IEEE 754 states that they must round to the closest even digit (also known as "Banker's Rounding"). For example, both `printf("%1.0f", 1.5)` and `printf("%1.0f", 2.5)` should round to 2. Previously, 1.5 would round to 2 and 2.5 would round to 3. This change only affects exactly representable numbers. For example, 2.35 (which, when represented in memory, is closer to 2.35000000000000008) continues to round up to 2.4. Rounding done by these functions now also respects the floating point rounding mode set by [`fesetround`](fegetround-fesetround2.md). Previously, rounding always chose `FE_TONEAREST` behavior. This change only affects programs built using Visual Studio 2019 version 16.2 and later. To use the legacy floating point rounding behavior, link with [`legacy_stdio_float_rounding.obj`](../link-options.md). **`swprintf`** is a wide-character version of **`sprintf`**; the pointer arguments to **`swprintf`** are wide-character strings. Detection of encoding errors in **`swprintf`** may differ from **`sprintf`**. **`swprintf`** and **`fwprintf`** behave identically except **`swprintf`** writes output to a string rather than to a destination of type `FILE`, and **`swprintf`** requires the *`count`* parameter to specify the maximum number of characters to write. The versions of these functions with the **`_l`** suffix are identical except they use the locale parameter passed in instead of the current thread locale. diff --git a/docs/c-runtime-library/reference/sqrt-sqrtf-sqrtl.md b/docs/c-runtime-library/reference/sqrt-sqrtf-sqrtl.md index ef2221147ef..2e1c685b8e5 100644 --- a/docs/c-runtime-library/reference/sqrt-sqrtf-sqrtl.md +++ b/docs/c-runtime-library/reference/sqrt-sqrtf-sqrtl.md @@ -1,7 +1,7 @@ --- title: "sqrt, sqrtf, sqrtl" description: "API reference for sqrt, sqrtf, and sqrtl; which calculate a square root of a floating point number." -ms.date: "08/31/2020" +ms.date: 08/31/2020 api_name: ["sqrtl", "sqrtf", "sqrt", "_o_sqrt", "_o_sqrtf"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll", "api-ms-win-crt-math-l1-1-0.dll", "ntoskrnl.exe"] api_type: ["DLLExport"] @@ -31,7 +31,7 @@ float sqrtf( long double sqrtl( long double x ); -#define sqrt(x) // Requires C11 or higher +#define sqrt(x) // Requires C11 or later ``` ### Parameters diff --git a/docs/c-runtime-library/reference/strdate-s-wstrdate-s.md b/docs/c-runtime-library/reference/strdate-s-wstrdate-s.md index 765db826128..78db9567430 100644 --- a/docs/c-runtime-library/reference/strdate-s-wstrdate-s.md +++ b/docs/c-runtime-library/reference/strdate-s-wstrdate-s.md @@ -1,14 +1,13 @@ --- title: "_strdate_s, _wstrdate_s" description: "_strdate_s and _wstrdate_s are secure CRT versions of the _strdate and _wstrdate functions that put the current date in a buffer." -ms.date: "4/2/2020" +ms.date: 4/2/2020 api_name: ["_strdate_s", "_wstrdate_s", "_o__strdate_s", "_o__wstrdate_s"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll", "api-ms-win-crt-time-l1-1-0.dll"] api_type: ["DLLExport"] topic_type: ["apiref"] f1_keywords: ["_strdate_s", "wstrdate_s", "_wstrdate_s", "strdate_s", "_tstrdate_s"] helpviewer_keywords: ["dates, copying", "tstrdate_s function", "wstrdate_s function", "_tstrdate_s function", "strdate_s function", "copying dates", "_strdate_s function", "_wstrdate_s function"] -ms.assetid: d41d8ea9-e5ce-40d4-864e-1ac29b455991 --- # `_strdate_s`, `_wstrdate_s` @@ -76,7 +75,7 @@ The debug library versions of these functions first fill the buffer with 0xFE. T By default, this function's global state is scoped to the application. To change this behavior, see [Global state in the CRT](../global-state.md). -### Generic-text routine mapping: +### Generic-text routine mapping | TCHAR.H routine | `_UNICODE` and `_MBCS` not defined | `_MBCS` defined | `_UNICODE` defined | |---|---|---|---| diff --git a/docs/c-runtime-library/reference/strftime-wcsftime-strftime-l-wcsftime-l.md b/docs/c-runtime-library/reference/strftime-wcsftime-strftime-l-wcsftime-l.md index 9d253c5cf24..92cf4ff91eb 100644 --- a/docs/c-runtime-library/reference/strftime-wcsftime-strftime-l-wcsftime-l.md +++ b/docs/c-runtime-library/reference/strftime-wcsftime-strftime-l-wcsftime-l.md @@ -1,14 +1,13 @@ --- -description: "Learn more about: strftime, wcsftime, _strftime_l, _wcsftime_l" title: "strftime, wcsftime, _strftime_l, _wcsftime_l" -ms.date: "4/2/2020" +description: "Learn more about: strftime, wcsftime, _strftime_l, _wcsftime_l" +ms.date: 4/2/2020 api_name: ["strftime", "_wcsftime_l", "_strftime_l", "wcsftime", "_o__strftime_l", "_o__wcsftime_l", "_o_strftime", "_o_wcsftime"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll", "api-ms-win-crt-time-l1-1-0.dll"] api_type: ["DLLExport"] topic_type: ["apiref"] f1_keywords: ["_tcsftime", "strftime", "wcsftime", "_strftime_l", "_wcsftime_l"] helpviewer_keywords: ["_strftime_l function", "strftime function", "tcsftime function", "_wcsftime_l function", "wcsftime function", "_tcsftime function", "time strings"] -ms.assetid: 6330ff20-4729-4c4a-82af-932915d893ea --- # `strftime`, `wcsftime`, `_strftime_l`, `_wcsftime_l` @@ -84,7 +83,7 @@ By default, this function's global state is scoped to the application. To change |---|---|---|---| | **`_tcsftime`** | **`strftime`** | **`strftime`** | **`wcsftime`** | -The *`format`* argument consists of one or more codes; as in **`printf`**, the formatting codes are preceded by a percent sign (**`%`**). Characters that don't begin with **`%`** are copied unchanged to *`strDest`*. The `LC_TIME` category of the current locale affects the output formatting of **`strftime`**. (For more information on `LC_TIME`, see [`setlocale`](setlocale-wsetlocale.md).) The **`strftime`** and **`wcsftime`** functions use the currently set locale. The **`_strftime_l`** and **`_wcsftime_l`** versions of these functions are identical except that they take the locale as a parameter and use that instead of the currently set locale. For more information, see [Locale](../locale.md). +The *`format`* argument consists of one or more codes; as in **`printf`**, the formatting codes are preceded by a percent sign (**`%`**). Characters that don't begin with **`%`** are copied unchanged to *`strDest`*. The `LC_TIME` category of the current locale affects the output formatting of **`strftime`**. For more information on `LC_TIME`, see [`setlocale`](setlocale-wsetlocale.md). The **`strftime`** and **`wcsftime`** functions use the currently set locale. The **`_strftime_l`** and **`_wcsftime_l`** versions of these functions are identical except that they take the locale as a parameter and use that instead of the currently set locale. For more information, see [Locale](../locale.md). The **`strftime`** functions support these formatting codes: diff --git a/docs/c-runtime-library/reference/strncnt-wcsncnt-mbsnbcnt-mbsnbcnt-l-mbsnccnt-mbsnccnt-l.md b/docs/c-runtime-library/reference/strncnt-wcsncnt-mbsnbcnt-mbsnbcnt-l-mbsnccnt-mbsnccnt-l.md index 4ca437d019f..2c9cdcfed2f 100644 --- a/docs/c-runtime-library/reference/strncnt-wcsncnt-mbsnbcnt-mbsnbcnt-l-mbsnccnt-mbsnccnt-l.md +++ b/docs/c-runtime-library/reference/strncnt-wcsncnt-mbsnbcnt-mbsnbcnt-l-mbsnccnt-mbsnccnt-l.md @@ -1,6 +1,6 @@ --- -description: "Learn more about: _strncnt, _wcsncnt, _mbsnbcnt, _mbsnbcnt_l, _mbsnccnt, _mbsnccnt_l" title: "_strncnt, _wcsncnt, _mbsnbcnt, _mbsnbcnt_l, _mbsnccnt, _mbsnccnt_l" +description: "Learn more about: _strncnt, _wcsncnt, _mbsnbcnt, _mbsnbcnt_l, _mbsnccnt, _mbsnccnt_l" ms.date: "4/2/2020" api_name: ["_mbsnbcnt_l", "_mbsnccnt", "_wcsncnt", "_strncnt", "_mbsnccnt_l", "_mbsnbcnt", "_o__mbsnbcnt", "_o__mbsnbcnt_l", "_o__mbsnccnt", "_o__mbsnccnt_l"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll", "api-ms-win-crt-multibyte-l1-1-0.dll"] @@ -8,7 +8,6 @@ api_type: ["DLLExport"] topic_type: ["apiref"] f1_keywords: ["_mbsnbcnt", "wcsncnt", "_tcsnbcnt", "_mbsnccnt", "_ftcsnbcnt", "mbsnbcnt", "strncnt", "mbsnbcnt_l", "mbsnccnt_l", "mbsnccnt", "_strncnt", "_wcsncnt"] helpviewer_keywords: ["_strncnt function", "_mbsnbcnt function", "_mbsnbcnt_l function", "_mbsnccnt_l function", "mbsnbcnt_l function", "mbsnbcnt function", "tcsnbcnt function", "mbsnccnt_l function", "strncnt function", "_tcsnbcnt function", "mbsnccnt function", "wcsncnt function", "_mbsnccnt function", "_wcsncnt function"] -ms.assetid: 2a022e9e-a307-4acb-a66b-e56e5357f848 --- # `_strncnt`, `_wcsncnt`, `_mbsnbcnt`, `_mbsnbcnt_l`, `_mbsnccnt`, `_mbsnccnt_l` @@ -105,8 +104,8 @@ For more compatibility information, see [Compatibility](../compatibility.md). ```C // crt_mbsnbcnt.c -#include -#include +#include +#include int main( void ) { diff --git a/docs/c-runtime-library/reference/strnlen-strnlen-s.md b/docs/c-runtime-library/reference/strnlen-strnlen-s.md index d74f2d71dc1..ba5972caaec 100644 --- a/docs/c-runtime-library/reference/strnlen-strnlen-s.md +++ b/docs/c-runtime-library/reference/strnlen-strnlen-s.md @@ -24,7 +24,7 @@ size_t strnlen( const char *str, size_t numberOfElements ); -size_t strnlen_s( +size_t strnlen_s( // See note in remarks section about linkage const char *str, size_t numberOfElements ); @@ -32,7 +32,7 @@ size_t wcsnlen( const wchar_t *str, size_t numberOfElements ); -size_t wcsnlen_s( +size_t wcsnlen_s( // See note in remarks section about linkage const wchar_t *str, size_t numberOfElements ); @@ -88,6 +88,11 @@ Each of these functions returns the number of characters in *`str`*, not includi By default, this function's global state is scoped to the application. To change this behavior, see [Global state in the CRT](../global-state.md). +> [!Note] +> When you use Windows SDK version 10.0.26100.6901 and Visual Studio 2026 or later together, `strnlen_s` and `wcsnlen_s` are no longer `static inline` (internal linkage). Instead, they are `inline` (external linkage).\ +> To return to the previous behavior, `#define _STATIC_INLINE_UCRT_FUNCTIONS=1` before including any CRT headers. By default, `_STATIC_INLINE_UCRT_FUNCTIONS` is set to 0.\ +> This change increases UCRT conformance with the C++ standard and improves compatibility with C++ modules. + ### Generic-text routine mappings | `TCHAR.H` routine | `_UNICODE` and `_MBCS` not defined | `_MBCS` defined | `_UNICODE` defined | diff --git a/docs/c-runtime-library/reference/strrchr-wcsrchr-mbsrchr-mbsrchr-l.md b/docs/c-runtime-library/reference/strrchr-wcsrchr-mbsrchr-mbsrchr-l.md index 90ada776505..9c8d760c683 100644 --- a/docs/c-runtime-library/reference/strrchr-wcsrchr-mbsrchr-mbsrchr-l.md +++ b/docs/c-runtime-library/reference/strrchr-wcsrchr-mbsrchr-mbsrchr-l.md @@ -1,6 +1,6 @@ --- -description: "Learn more about: strrchr, wcsrchr, _mbsrchr, _mbsrchr_l" title: "strrchr, wcsrchr, _mbsrchr, _mbsrchr_l" +description: "Learn more about: strrchr, wcsrchr, _mbsrchr, _mbsrchr_l" ms.date: "4/2/2020" api_name: ["strrchr", "wcsrchr", "_mbsrchr", "_mbsrchr_l", "_o__mbsrchr", "_o__mbsrchr_l"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ntdll.dll", "ucrtbase.dll", "api-ms-win-crt-multibyte-l1-1-0.dll", "ntoskrnl.exe"] @@ -131,4 +131,4 @@ For an example of using **`strrchr`**, see [`strchr`](strchr-wcschr-mbschr-mbsch [`strcspn`, `wcscspn`, `_mbscspn`, `_mbscspn_l`](strcspn-wcscspn-mbscspn-mbscspn-l.md)\ [`_strnicmp`, `_wcsnicmp`, `_mbsnicmp`, `_strnicmp_l`, `_wcsnicmp_l`, `_mbsnicmp_l`](strnicmp-wcsnicmp-mbsnicmp-strnicmp-l-wcsnicmp-l-mbsnicmp-l.md)\ [`strpbrk`, `wcspbrk`, `_mbspbrk`, `_mbspbrk_l`](strpbrk-wcspbrk-mbspbrk-mbspbrk-l.md)\ -[`strspn`, `wcsspn`, `_mbsspn`, `_mbsspn_l`](strspn-wcsspn-mbsspn-mbsspn-l.md)\ +[`strspn`, `wcsspn`, `_mbsspn`, `_mbsspn_l`](strspn-wcsspn-mbsspn-mbsspn-l.md) diff --git a/docs/c-runtime-library/reference/strtoimax-strtoimax-l-wcstoimax-wcstoimax-l.md b/docs/c-runtime-library/reference/strtoimax-strtoimax-l-wcstoimax-wcstoimax-l.md index c6bcf88b3f3..288b4dcce83 100644 --- a/docs/c-runtime-library/reference/strtoimax-strtoimax-l-wcstoimax-wcstoimax-l.md +++ b/docs/c-runtime-library/reference/strtoimax-strtoimax-l-wcstoimax-wcstoimax-l.md @@ -1,14 +1,13 @@ --- -description: "Learn more about: strtoimax, _strtoimax_l, wcstoimax, _wcstoimax_l" title: "strtoimax, _strtoimax_l, wcstoimax, _wcstoimax_l" -ms.date: "11/04/2016" +description: "Learn more about: strtoimax, _strtoimax_l, wcstoimax, _wcstoimax_l" +ms.date: 11/04/2016 api_name: ["wcstoimax", "_wcstoimax_l", "_strtoimax_l", "strtoimax"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll", "api-ms-win-crt-convert-l1-1-0.dll"] api_type: ["DLLExport"] topic_type: ["apiref"] f1_keywords: ["wcstoimax", "_tcstoimax", "strtoimax", "_wcstoimax_l", "_strtoimax_l", "_tcstoimax_l"] -helpviewer_keywords: ["strtoimax funciton", "conversion functions", "_strtoimax_l function", "_wcstoimax_l function", "wcstoimax function"] -ms.assetid: 4530d3dc-aaac-4a76-b7cf-29ae3c98d0ae +helpviewer_keywords: ["strtoimax function", "conversion functions", "_strtoimax_l function", "_wcstoimax_l function", "wcstoimax function"] --- # `strtoimax`, `_strtoimax_l`, `wcstoimax`, `_wcstoimax_l` diff --git a/docs/c-runtime-library/reference/strtok-strtok-l-wcstok-wcstok-l-mbstok-mbstok-l.md b/docs/c-runtime-library/reference/strtok-strtok-l-wcstok-wcstok-l-mbstok-mbstok-l.md index 00ad10086c7..d257087249c 100644 --- a/docs/c-runtime-library/reference/strtok-strtok-l-wcstok-wcstok-l-mbstok-mbstok-l.md +++ b/docs/c-runtime-library/reference/strtok-strtok-l-wcstok-wcstok-l-mbstok-mbstok-l.md @@ -1,14 +1,13 @@ --- -description: "Learn more about: strtok, _strtok_l, wcstok, _wcstok_l, _mbstok, _mbstok_l" title: "strtok, _strtok_l, wcstok, _wcstok_l, _mbstok, _mbstok_l" -ms.date: "6/24/2020" +description: "Learn more about: strtok, _strtok_l, wcstok, _wcstok_l, _mbstok, _mbstok_l" +ms.date: 6/24/2020 api_name: ["_mbstok_l", "_mbstok", "wcstok", "_mbstok", "strtok", "_wcstok_l", "_o__mbstok", "_o__mbstok_l", "_o_strtok", "_o_wcstok"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll", "api-ms-win-crt-multibyte-l1-1-0.dll", "api-ms-win-crt-string-l1-1-0.dll"] api_type: ["DLLExport"] topic_type: ["apiref"] f1_keywords: ["STRING/strtok", "TCHAR/_strtok_l", "MBSTRING/_mbstok", "MBSTRING/_mbstok_l", "CORECRT_WSTRING/wcstok", "TCHAR/_wcstok_l", "TCHAR/_tcstok", "TCHAR/_tcstok_l", "strtok", "strtok_l", "_mbstok", "_mbstok_l", "wcstok", "_wcstok_l", "_tcstok", "_tcstok_l"] helpviewer_keywords: ["mbstok_l function", "strings [C++], searching", "tcstok function", "_tcstok function", "_strtok_l function", "strtok function", "mbstok function", "wcstok_l function", "_mbstok function", "tcstok_l function", "tokens, finding in strings", "_mbstok_l function", "wcstok function", "_wcstok_l function", "_tcstok_l function", "strtok_l function"] -ms.assetid: 904cb734-f0d7-4d77-ba81-4791ddf461ae --- # `strtok`, `_strtok_l`, `wcstok`, `_wcstok_l`, `_mbstok`, `_mbstok_l` @@ -74,7 +73,7 @@ Returns a pointer to the next token found in *`strToken`*. The functions return ## Remarks -The **`strtok`** function finds the next token in *`strToken`*. The set of characters in *`strDelimit`* specifies possible delimiters of the token to be found in *`strToken`* on the current call. **`wcstok`** and **`_mbstok`** are wide-character and multibyte-character versions of **`strtok`**. The arguments and return value of **`wcstok`** are wide-character strings. The argumets and return value of **`_mbstok`** are multibyte-character strings. These three functions behave identically otherwise. +The **`strtok`** function finds the next token in *`strToken`*. The set of characters in *`strDelimit`* specifies possible delimiters of the token to be found in *`strToken`* on the current call. **`wcstok`** and **`_mbstok`** are wide-character and multibyte-character versions of **`strtok`**. The arguments and return value of **`wcstok`** are wide-character strings. The arguments and return value of **`_mbstok`** are multibyte-character strings. These three functions behave identically otherwise. The two argument version of **`wcstok`** isn't standard. If you need to use that version, you'll need to define `_CRT_NON_CONFORMING_WCSTOK` before you `#include ` (or `#include `). diff --git a/docs/c-runtime-library/reference/strtol-wcstol-strtol-l-wcstol-l.md b/docs/c-runtime-library/reference/strtol-wcstol-strtol-l-wcstol-l.md index 4ae62a70e13..1b097545911 100644 --- a/docs/c-runtime-library/reference/strtol-wcstol-strtol-l-wcstol-l.md +++ b/docs/c-runtime-library/reference/strtol-wcstol-strtol-l-wcstol-l.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: strtol, wcstol, _strtol_l, _wcstol_l" title: "strtol, wcstol, _strtol_l, _wcstol_l" -ms.date: "4/2/2020" +description: "Learn more about: strtol, wcstol, _strtol_l, _wcstol_l" +ms.date: 4/2/2020 api_name: ["strtol", "wcstol", "_strtol_l", "_wcstol_l", "_o__strtol_l", "_o__wcstol_l", "_o_strtol", "_o_wcstol"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll", "api-ms-win-crt-convert-l1-1-0.dll"] api_type: ["DLLExport"] @@ -65,7 +65,7 @@ Locale to use. The **`strtol`**, **`wcstol`**, **`_strtol_l`**, and **`_wcstol_l`** functions convert *`string`* to a **`long`**. They stop reading *`string`* at the first character not recognized as part of a number. It may be the terminating-null character, or the first alphanumeric character greater than or equal to *`base`*. -**`wcstol`** and **`_wcstol_l`** are wide-character versions of **`strtol`** and **`_strtol_l`**. Their *`string`* argument is a wide-character string. These functions behave identically to **`strtol`** and **`_strtol_l`** otherwise. The locale's `LC_NUMERIC` category setting determines recognition of the radix character (the fractional marker or decimal point) in *`string`*. The functions **`strtol`** and **`wcstol`** use the current locale. **`_strtol_l`** and **`_wcstol_l`** use the locale passed in instead. For more information, see [`setlocale`] and [Locale](../locale.md). +**`wcstol`** and **`_wcstol_l`** are wide-character versions of **`strtol`** and **`_strtol_l`**. Their *`string`* argument is a wide-character string. These functions behave identically to **`strtol`** and **`_strtol_l`** otherwise. The locale's `LC_NUMERIC` category setting determines recognition of the radix character (the fractional marker or decimal point) in *`string`*. The functions **`strtol`** and **`wcstol`** use the current locale. **`_strtol_l`** and **`_wcstol_l`** use the locale passed in instead. For more information, see [`setlocale`](setlocale-wsetlocale.md) and [Locale](../locale.md). When *`end_ptr`* is `NULL`, it's ignored. Otherwise, a pointer to the character that stopped the scan is stored at the location pointed to by *`end_ptr`*. No conversion is possible if no valid digits are found, or an invalid base is specified. The value of *`string`* is then stored at the location pointed to by *`end_ptr`*. diff --git a/docs/c-runtime-library/reference/strtoumax-strtoumax-l-wcstoumax-wcstoumax-l.md b/docs/c-runtime-library/reference/strtoumax-strtoumax-l-wcstoumax-wcstoumax-l.md index 39b89feffc5..e43cfdbd12d 100644 --- a/docs/c-runtime-library/reference/strtoumax-strtoumax-l-wcstoumax-wcstoumax-l.md +++ b/docs/c-runtime-library/reference/strtoumax-strtoumax-l-wcstoumax-wcstoumax-l.md @@ -1,14 +1,13 @@ --- -description: "Learn more about: strtoumax, _strtoumax_l, wcstoumax, _wcstoumax_l" title: "strtoumax, _strtoumax_l, wcstoumax, _wcstoumax_l" -ms.date: "11/04/2016" +description: "Learn more about: strtoumax, _strtoumax_l, wcstoumax, _wcstoumax_l" +ms.date: 11/04/2016 api_name: ["_wcstoumax_l", "_strtoumax_l", "wcstoumax", "strtoumax"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll", "api-ms-win-crt-convert-l1-1-0.dll"] api_type: ["DLLExport"] topic_type: ["apiref"] f1_keywords: ["INTTYPES/strtoumax", "INTTYPES/_strtoumax_l", "INTTYPES/wcstoumax", "INTTYPES/_wcstoumax_l", "TCHAR/_tcstoumax", "TCHAR/_tcstoumax_l", "strtoumax", "_strtoumax_l", "wcstoumax", "_wcstoumax_l", "_tcstoumax", "_tcstoumax_l"] helpviewer_keywords: ["_strtoumax_l function", "conversion functions", "wcstoumax function", "_wcstoumax_l function", "strtoumax function"] -ms.assetid: 566769f9-495b-4508-b9c6-02217a578897 --- # `strtoumax`, `_strtoumax_l`, `wcstoumax`, `_wcstoumax_l` @@ -88,7 +87,7 @@ A *`whitespace`* may consist of space and tab characters, which are ignored. *`d | Routine | Required header | |---|---| -| **`strtoumax`**, **`wcstoumax`**, **`_strtoumax_l`**, **`_wcstoumax_l`** | \ | +| **`strtoumax`**, **`wcstoumax`**, **`_strtoumax_l`**, **`_wcstoumax_l`** | \ | For more compatibility information, see [Compatibility](../compatibility.md). diff --git a/docs/c-runtime-library/reference/tan-tanf-tanl.md b/docs/c-runtime-library/reference/tan-tanf-tanl.md index 815d0b95a95..58e1563bf1a 100644 --- a/docs/c-runtime-library/reference/tan-tanf-tanl.md +++ b/docs/c-runtime-library/reference/tan-tanf-tanl.md @@ -1,14 +1,13 @@ --- title: "tan, tanf, tanl" description: "API reference for tan, tanf, and tanl; which calculate the tangent of a floating-point value." -ms.date: "1/15/2021" +ms.date: 1/15/2021 api_name: ["tan", "tanf", "tanl", "_o_tan", "_o_tanf"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll", "api-ms-win-crt-math-l1-1-0.dll"] api_type: ["DLLExport"] topic_type: ["apiref"] f1_keywords: ["CORECRT_MATH/tan", "CORECRT_MATH/tanf", "CORECRT_MATH/tanl", "tan", "tanf", "tanl"] helpviewer_keywords: ["tanl function", "tan function", "calculating tangents", "tangent", "tanf function", "trigonometric functions"] -ms.assetid: 36cc0ce8-9c80-4653-b354-ddb3b378b6bd --- # `tan`, `tanf`, `tanl` @@ -20,7 +19,7 @@ Calculates the tangent. double tan( double x ); float tanf( float x ); long double tanl( long double x ); -#define tan(x) // Requires C11 or higher +#define tan(x) // Requires C11 or later ``` ```cpp diff --git a/docs/c-runtime-library/reference/tanh-tanhf-tanhl.md b/docs/c-runtime-library/reference/tanh-tanhf-tanhl.md index de71ee31781..069c1a809fe 100644 --- a/docs/c-runtime-library/reference/tanh-tanhf-tanhl.md +++ b/docs/c-runtime-library/reference/tanh-tanhf-tanhl.md @@ -1,7 +1,7 @@ --- title: "tanh, tanhf, tanhl" description: "API reference for tanh, tanhf, and tanhl; which calculate the hyperbolic tangent of a floating-point value." -ms.date: "1/15/2021" +ms.date: 1/15/2021 api_name: ["tanh", "tanhf", "tanhl", "_o_tanh", "_o_tanhf"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll", "api-ms-win-crt-math-l1-1-0.dll"] api_type: ["DLLExport"] @@ -19,7 +19,7 @@ Calculates the hyperbolic tangent. double tanh( double x ); float tanhf( float x ); long double tanhl( long double x ); -#define tanh(x) // Requires C11 or higher +#define tanh(x) // Requires C11 or later ``` ```cpp diff --git a/docs/c-runtime-library/reference/tgamma-tgammaf-tgammal.md b/docs/c-runtime-library/reference/tgamma-tgammaf-tgammal.md index eb9595efd48..a8bb3f757de 100644 --- a/docs/c-runtime-library/reference/tgamma-tgammaf-tgammal.md +++ b/docs/c-runtime-library/reference/tgamma-tgammaf-tgammal.md @@ -1,14 +1,13 @@ --- title: "tgamma, tgammaf, tgammal" description: "API reference for tgamma, tgammaf, and tgammal; which determine the gamma function of the specified value." -ms.date: "9/1/2020" +ms.date: 9/1/2020 api_name: ["tgamma", "tgammaf", "tgammal", "_o_tgamma", "_o_tgammaf", "_o_tgammal"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll", "api-ms-win-crt-math-l1-1-0.dll"] api_type: ["DLLExport"] topic_type: ["apiref"] f1_keywords: ["CORECRT_MATH/tgamma", "CORECRT_MATH/tgammaf", "CORECRT_MATH/tgammal", "tgamma", "tgammaf", "tgammal"] helpviewer_keywords: ["tgamma function", "tgammaf function", "tgammal function"] -ms.assetid: f1bd2681-8af2-48a9-919d-5358fd068acd --- # `tgamma`, `tgammaf`, `tgammal` @@ -29,7 +28,7 @@ long double tgammal( long double x ); -#define tgamma(X) // Requires C11 or higher +#define tgamma(X) // Requires C11 or later float tgamma( float x @@ -79,7 +78,7 @@ By default, this function's global state is scoped to the application. To change | Function | C header | C++ header | |---|---|---| -| **`tgamma`**, **`tgammaf`**, **`tgammal`** | \ | \ | +| **`tgamma`**, **`tgammaf`**, **`tgammal`** | \ | \ | | **`tgamma`** macro | \ | | For more compatibility information, see [Compatibility](../compatibility.md). diff --git a/docs/c-runtime-library/reference/time-time32-time64.md b/docs/c-runtime-library/reference/time-time32-time64.md index 782e7aa8359..1087f1997a6 100644 --- a/docs/c-runtime-library/reference/time-time32-time64.md +++ b/docs/c-runtime-library/reference/time-time32-time64.md @@ -8,7 +8,6 @@ api_type: ["DLLExport"] topic_type: ["apiref"] f1_keywords: ["TIME/time", "TIME/_time32", "TIME/_time64", "time", "_time32", "_time64"] helpviewer_keywords: ["time32 function", "_time32 function", "_time64 function", "time functions", "system time", "time64 function"] -ms.assetid: 280e00f2-2b93-4ece-94cd-e048484c6cc7 --- # `time`, `_time32`, `_time64` @@ -17,7 +16,7 @@ Gets the system time. ## Syntax ```C -time_t time( time_t *destTime ); +time_t time( time_t *destTime ); // See note in remarks section about linkage __time32_t _time32( __time32_t *destTime ); __time64_t _time64( __time64_t *destTime ); ``` @@ -37,6 +36,11 @@ The **`time`** function returns the number of seconds elapsed since midnight (00 **`time`** is a wrapper for **`_time64`** and **`time_t`** is, by default, equivalent to **`__time64_t`**. If you need to force the compiler to interpret **`time_t`** as the old 32-bit **`time_t`**, you can define `_USE_32BIT_TIME_T`. We don't recommend `_USE_32BIT_TIME_T`, because your application may fail after January 18, 2038; the use of this macro isn't allowed on 64-bit platforms. +> [!Note] +> When you use Windows SDK version 10.0.26100.6901 and Visual Studio 2026 or later together, `time` is no longer `static inline` (internal linkage). Instead, it's `inline` (external linkage).\ +> To return to the previous behavior, `#define _STATIC_INLINE_UCRT_FUNCTIONS=1` before including any CRT headers. By default, `_STATIC_INLINE_UCRT_FUNCTIONS` is set to 0.\ +> This change increases UCRT conformance with the C++ standard and improves compatibility with C++ modules. + ## Requirements | Routine | Required C header | Required C++ header | diff --git a/docs/c-runtime-library/reference/timespec-get-timespec32-get-timespec64-get1.md b/docs/c-runtime-library/reference/timespec-get-timespec32-get-timespec64-get1.md index e14e404ae67..fea1cd33a5a 100644 --- a/docs/c-runtime-library/reference/timespec-get-timespec32-get-timespec64-get1.md +++ b/docs/c-runtime-library/reference/timespec-get-timespec32-get-timespec64-get1.md @@ -17,7 +17,7 @@ Sets the interval pointed to by the first argument to the current calendar time, ## Syntax ```C -int timespec_get( +int timespec_get( // See note in remarks section about linkage struct timespec* const time_spec, int const base ); @@ -55,6 +55,11 @@ These functions support only `TIME_UTC` as the *`base`* value. `TIME_UTC` sets t By default, this function's global state is scoped to the application. To change this behavior, see [Global state in the CRT](../global-state.md). +> [!Note] +> When you use Windows SDK version 10.0.26100.6901 and Visual Studio 2026 or later together, `timespec_get` is no longer `static inline` (internal linkage). Instead, it's `inline` (external linkage).\ +> To return to the previous behavior, `#define _STATIC_INLINE_UCRT_FUNCTIONS=1` before including any CRT headers. By default, `_STATIC_INLINE_UCRT_FUNCTIONS` is set to 0.\ +> This change increases UCRT conformance with the C++ standard and improves compatibility with C++ modules. + ## Requirements | Routine | Required header | diff --git a/docs/c-runtime-library/reference/trunc-truncf-truncl.md b/docs/c-runtime-library/reference/trunc-truncf-truncl.md index 19c7bc04148..19205505760 100644 --- a/docs/c-runtime-library/reference/trunc-truncf-truncl.md +++ b/docs/c-runtime-library/reference/trunc-truncf-truncl.md @@ -1,14 +1,13 @@ --- title: "trunc, truncf, truncl" description: "API reference for trunc, truncf, truncl; which determine the nearest integer that is less than or equal to the specified floating-point value." -ms.date: "9/1/2020" +ms.date: 9/1/2020 api_name: ["trunc", "truncf", "truncl"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll", "api-ms-win-crt-math-l1-1-0.dll"] api_type: ["DLLExport"] topic_type: ["apiref"] f1_keywords: ["CORECRT_MATH/trunc", "CORECRT_MATH/truncf", "CORECRT_MATH/truncl", "math/trunc", "math/truncf", "math/truncl", "trunc", "truncf", "truncl"] helpviewer_keywords: ["trunc function", "truncf function", "truncl function"] -ms.assetid: de2038ac-ac0b-483e-870c-e8992dcd4fd0 --- # `trunc`, `truncf`, `truncl` @@ -19,7 +18,7 @@ Determines the nearest integer that is less than or equal to the specified float ```C double trunc( double x ); long double truncl( long double x ); -#define trunc(X) // Requires C11 or higher +#define trunc(X) // Requires C11 or later long double trunc( long double x ); //C++ only float trunc( float x ); //C++ only diff --git a/docs/c-runtime-library/reference/uncaught-exception.md b/docs/c-runtime-library/reference/uncaught-exception.md index 52c7a6c349b..9cb0108509d 100644 --- a/docs/c-runtime-library/reference/uncaught-exception.md +++ b/docs/c-runtime-library/reference/uncaught-exception.md @@ -1,14 +1,13 @@ --- -description: "Learn more about: __uncaught_exception" title: "__uncaught_exception" -ms.date: "1/14/2021" +description: "Learn more about: __uncaught_exception" +ms.date: 1/14/2021 api_name: ["__uncaught_exception"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll"] api_type: ["DLLExport"] topic_type: ["apiref"] f1_keywords: ["EH/__uncaught_exception"] helpviewer_keywords: ["__uncaught_exception"] -ms.assetid: 4d9b75c6-c9c7-4876-b761-ea9ab1925e96 --- # `__uncaught_exception` @@ -24,8 +23,6 @@ bool __uncaught_exception(); **`true`** from the time an exception is thrown in a **`try`** block until the matching **`catch`** block is initialized; otherwise, **`false`**. -## Remarks - ## Requirements | Routine | Required header | diff --git a/docs/c-runtime-library/reference/ungetch-ungetwch-ungetch-nolock-ungetwch-nolock.md b/docs/c-runtime-library/reference/ungetch-ungetwch-ungetch-nolock-ungetwch-nolock.md index 5c15bfbf429..1564dabc49c 100644 --- a/docs/c-runtime-library/reference/ungetch-ungetwch-ungetch-nolock-ungetwch-nolock.md +++ b/docs/c-runtime-library/reference/ungetch-ungetwch-ungetch-nolock-ungetwch-nolock.md @@ -1,7 +1,7 @@ --- title: "_ungetch, _ungetwch, _ungetch_nolock, _ungetwch_nolock" description: "Learn more about: _ungetch, _ungetwch, _ungetch_nolock, _ungetwch_nolock" -ms.date: "4/2/2020" +ms.date: 4/2/2020 api_name: ["_ungetch_nolock", "_ungetwch_nolock", "_ungetwch", "_ungetch", "_o__ungetch", "_o__ungetch_nolock", "_o__ungetwch", "_o__ungetwch_nolock"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll", "api-ms-win-crt-conio-l1-1-0.dll"] api_type: ["DLLExport"] @@ -70,7 +70,6 @@ For more compatibility information, see [Compatibility](../compatibility.md). ```C // crt_ungetch.c -// compile with: /c // In this program, a white-space delimited // token is read from the keyboard. When the program // encounters a delimiter, it uses _ungetch to replace diff --git a/docs/c-runtime-library/reference/utime-utime32-utime64-wutime-wutime32-wutime64.md b/docs/c-runtime-library/reference/utime-utime32-utime64-wutime-wutime32-wutime64.md index d5a82ee0b63..84b91e8d2ea 100644 --- a/docs/c-runtime-library/reference/utime-utime32-utime64-wutime-wutime32-wutime64.md +++ b/docs/c-runtime-library/reference/utime-utime32-utime64-wutime-wutime32-wutime64.md @@ -8,7 +8,6 @@ api_type: ["DLLExport"] topic_type: ["apiref"] f1_keywords: ["UTIME/_utime", "UTIME/_utime32", "UTIME/_utime64", "UTIME/_wutime", "UTIME/_wutime32", "UTIME/_wutime64", "TCHAR/_tutime", "TCHAR/_tutime32", "TCHAR/_tutime64", "_utime", "_utime32", "_utime64", "_wutime", "_wutime32", "_wutime64", "_tutime", "_tutime32", "_tutime64"] helpviewer_keywords: ["tutime function", "utime32 function", "utime64 function", "_utime function", "_tutime32 function", "time [C++], file modification", "wutime function", "_wutime function", "_wutime32 function", "_tutime64 function", "_tutime function", "files [C++], modification time", "_wutime64 function", "_utime32 function", "utime function", "_utime64 function", "wutime64 function", "wutime32 function", "tutime64 function", "tutime32 function"] -ms.assetid: 8d482d40-19b9-4591-bfee-5d7f601d1a9e --- # `_utime`, `_utime32`, `_utime64`, `_wutime`, `_wutime32`, `_wutime64` @@ -17,7 +16,7 @@ Set the file modification time. ## Syntax ```C -int _utime( +int _utime( // See note in remarks section about linkage const char *filename, struct _utimbuf *times ); @@ -29,7 +28,7 @@ int _utime64( const char *filename, struct __utimbuf64 *times ); -int _wutime( +int _wutime( // See note in remarks section about linkage const wchar_t *filename, struct _utimbuf *times ); @@ -85,6 +84,11 @@ Specific versions of the `_utimbuf` structure (`__utimbuf32` and `__utimbuf64`) By default, this function's global state is scoped to the application. To change this behavior, see [Global state in the CRT](../global-state.md). +> [!Note] +> When you use Windows SDK version 10.0.26100.6901 and Visual Studio 2026 or later together, `_utime` and `_wutime` are no longer `static inline` (internal linkage). Instead, they're `inline` (external linkage).\ +> To return to the previous behavior, `#define _STATIC_INLINE_UCRT_FUNCTIONS=1` before including any CRT headers. By default, `_STATIC_INLINE_UCRT_FUNCTIONS` is set to 0.\ +> This change increases UCRT conformance with the C++ standard and improves compatibility with C++ modules. + ### Generic-text routine mappings | TCHAR.H routine | `_UNICODE` and `_MBCS` not defined | `_MBCS` defined | `_UNICODE` defined | diff --git a/docs/c-runtime-library/reference/vcprintf-p-vcprintf-p-l-vcwprintf-p-vcwprintf-p-l.md b/docs/c-runtime-library/reference/vcprintf-p-vcprintf-p-l-vcwprintf-p-vcwprintf-p-l.md index 5a40fed9d72..04735adbee7 100644 --- a/docs/c-runtime-library/reference/vcprintf-p-vcprintf-p-l-vcwprintf-p-vcwprintf-p-l.md +++ b/docs/c-runtime-library/reference/vcprintf-p-vcprintf-p-l-vcwprintf-p-vcwprintf-p-l.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: _vcprintf_p, _vcprintf_p_l, _vcwprintf_p, _vcwprintf_p_l" title: "_vcprintf_p, _vcprintf_p_l, _vcwprintf_p, _vcwprintf_p_l" -ms.date: "3/9/2021" +description: "Learn more about: _vcprintf_p, _vcprintf_p_l, _vcwprintf_p, _vcwprintf_p_l" +ms.date: 3/9/2021 api_name: ["_vcprintf_p", "_vcwprintf_p_l", "_vcprintf_p_l", "_vcwprintf_p"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll"] api_type: ["DLLExport"] @@ -62,7 +62,7 @@ Each of these functions takes a pointer to an argument list, and then uses the ` The versions of these functions that have the `_l` suffix are identical except that they use the locale parameter that's passed in instead of the current locale. -Each *`argument`* (if any) is converted and is output according to the corresponding format specification in *`format`*. The format specification supports positional parameters so that you can specify the order in which the arguments are used in the format string. For more information, see [printf_p Positional Parameters](../printf-p-positional-parameters.md). +Each *`argument`* (if any) is converted and is output according to the corresponding format specification in *`format`*. The format specification supports positional parameters so that you can specify the order in which the arguments are used in the format string. For more information, see [`printf_p` positional parameters](../printf-p-positional-parameters.md). These functions don't translate line-feed characters on output into carriage return-line feed (CR-LF) combinations. @@ -73,7 +73,7 @@ These functions validate the input pointer and the format string. If *`format`* ### Generic-text routine mappings -| Tchar.h routine | `_UNICODE` and `_MBCS` not defined | `_MBCS` defined | `_UNICODE` defined | +| `Tchar.h` routine | `_UNICODE` and `_MBCS` not defined | `_MBCS` defined | `_UNICODE` defined | |---|---|---|---| | `_vtcprintf_p` | **`_vcprintf_p`** | **`_vcprintf_p`** | **`_vcwprintf_p`** | | `_vtcprintf_p_l` | **`_vcprintf_p_l`** | **`_vcprintf_p_l`** | **`_vcwprintf_p_l`** | @@ -82,8 +82,8 @@ These functions validate the input pointer and the format string. If *`format`* | Routine | Required header | |---|---| -| **`_vcprintf_p`**, **`_vcprintf_p_l`** | \ and \ | -| **`_vcwprintf_p`**, **`_vcwprintf_p_l`** | \ and \ | +| **`_vcprintf_p`**, **`_vcprintf_p_l`** | `` and `` | +| **`_vcwprintf_p`**, **`_vcwprintf_p_l`** | `` and `` | For more compatibility information, see [Compatibility](../compatibility.md). @@ -94,25 +94,25 @@ For more compatibility information, see [Compatibility](../compatibility.md). ```C // crt_vcprintf_p.c -// compile with: /c + #include #include // An error formatting function that's used to print to the console. int eprintf(const char* format, ...) { - va_list args; - va_start(args, format); - int result = _vcprintf_p(format, args); - va_end(args); - return result; + va_list args; + va_start(args, format); + int result = _vcprintf_p(format, args); + va_end(args); + return result; } int main() { - int n = eprintf("parameter 2 = %2$d; parameter 1 = %1$s\r\n", - "one", 222); - _cprintf_s("%d characters printed\r\n"); + int n = eprintf("parameter 2 = %2$d; parameter 1 = %1$s\r\n", + "one", 222); + _cprintf_s("%d characters printed\r\n", n); } ``` @@ -126,4 +126,4 @@ parameter 2 = 222; parameter 1 = one [Console and port I/O](../console-and-port-i-o.md)\ [`_cprintf`, `_cprintf_l`, `_cwprintf`, `_cwprintf_l`](cprintf-cprintf-l-cwprintf-cwprintf-l.md)\ [`va_arg`, `va_copy`, `va_end`, `va_start`](va-arg-va-copy-va-end-va-start.md)\ -[printf_p Positional Parameters](../printf-p-positional-parameters.md) +[`printf_p` positional parameters](../printf-p-positional-parameters.md) diff --git a/docs/c-runtime-library/reference/vcprintf-vcprintf-l-vcwprintf-vcwprintf-l.md b/docs/c-runtime-library/reference/vcprintf-vcprintf-l-vcwprintf-vcwprintf-l.md index 48dc1f6a5fa..0bffc074e8c 100644 --- a/docs/c-runtime-library/reference/vcprintf-vcprintf-l-vcwprintf-vcwprintf-l.md +++ b/docs/c-runtime-library/reference/vcprintf-vcprintf-l-vcwprintf-vcwprintf-l.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: _vcprintf, _vcprintf_l, _vcwprintf, _vcwprintf_l" title: "_vcprintf, _vcprintf_l, _vcwprintf, _vcwprintf_l" -ms.date: "3/9/2021" +description: "Learn more about: _vcprintf, _vcprintf_l, _vcwprintf, _vcwprintf_l" +ms.date: 3/9/2021 api_name: ["_vcwprintf", "_vcprintf_l", "_vcwprintf_l", "_vcprintf"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll"] api_type: ["DLLExport"] @@ -65,7 +65,7 @@ The versions of these functions with the `_l` suffix are identical except that t > [!IMPORTANT] > Ensure that *`format`* is not a user-defined string. For more information, see [Avoiding buffer overruns](/windows/win32/SecBP/avoiding-buffer-overruns). > -> Starting in Windows 10 version 2004 (build 19041), the `printf` family of functions prints exactly representable floating point numbers according to the IEEE 754 rules for rounding. In previous versions of Windows, exactly representable floating point numbers ending in '5' would always round up. IEEE 754 states that they must round to the closest even digit (also known as "Banker's Rounding"). For example, both `printf("%1.0f", 1.5)` and `printf("%1.0f", 2.5)` should round to 2. Previously, 1.5 would round to 2 and 2.5 would round to 3. This change only affects exactly representable numbers. For example, 2.35 (which, when represented in memory, is closer to 2.35000000000000008) continues to round up to 2.4. Rounding done by these functions now also respects the floating point rounding mode set by [`fesetround`](fegetround-fesetround2.md). Previously, rounding always chose `FE_TONEAREST` behavior. This change only affects programs built using Visual Studio 2019 version 16.2 and later. To use the legacy floating point rounding behavior, link with ['legacy_stdio_float_rounding.obj`](../link-options.md). +> Starting in Windows 10 version 2004 (build 19041), the `printf` family of functions prints exactly representable floating point numbers according to the IEEE 754 rules for rounding. In previous versions of Windows, exactly representable floating point numbers ending in '5' would always round up. IEEE 754 states that they must round to the closest even digit (also known as "Banker's Rounding"). For example, both `printf("%1.0f", 1.5)` and `printf("%1.0f", 2.5)` should round to 2. Previously, 1.5 would round to 2 and 2.5 would round to 3. This change only affects exactly representable numbers. For example, 2.35 (which, when represented in memory, is closer to 2.35000000000000008) continues to round up to 2.4. Rounding done by these functions now also respects the floating point rounding mode set by [`fesetround`](fegetround-fesetround2.md). Previously, rounding always chose `FE_TONEAREST` behavior. This change only affects programs built using Visual Studio 2019 version 16.2 and later. To use the legacy floating point rounding behavior, link with [`legacy_stdio_float_rounding.obj`](../link-options.md). ### Generic-text routine mappings @@ -89,7 +89,7 @@ For more compatibility information, see [Compatibility](../compatibility.md). ```cpp // crt_vcprintf.cpp -// compile with: /c + #include #include diff --git a/docs/c-runtime-library/reference/vfprintf-p-vfprintf-p-l-vfwprintf-p-vfwprintf-p-l.md b/docs/c-runtime-library/reference/vfprintf-p-vfprintf-p-l-vfwprintf-p-vfwprintf-p-l.md index 0d8c50f0a33..1da2fe9b48e 100644 --- a/docs/c-runtime-library/reference/vfprintf-p-vfprintf-p-l-vfwprintf-p-vfwprintf-p-l.md +++ b/docs/c-runtime-library/reference/vfprintf-p-vfprintf-p-l-vfwprintf-p-vfwprintf-p-l.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: _vfprintf_p, _vfprintf_p_l, _vfwprintf_p, _vfwprintf_p_l" title: "_vfprintf_p, _vfprintf_p_l, _vfwprintf_p, _vfwprintf_p_l" -ms.date: "3/9/2021" +description: "Learn more about: _vfprintf_p, _vfprintf_p_l, _vfwprintf_p, _vfwprintf_p_l" +ms.date: 3/9/2021 api_name: ["_vfprintf_p", "_vfwprintf_p", "_vfprintf_p_l", "_vfwprintf_p_l"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll"] api_type: ["DLLExport"] @@ -70,7 +70,7 @@ The versions of these functions with the `_l` suffix are identical except that t > [!IMPORTANT] > Ensure that *`format`* is not a user-defined string. For more information, see [Avoiding buffer overruns](/windows/win32/SecBP/avoiding-buffer-overruns). -> Starting in Windows 10 version 2004 (build 19041), the `printf` family of functions prints exactly representable floating point numbers according to the IEEE 754 rules for rounding. In previous versions of Windows, exactly representable floating point numbers ending in '5' would always round up. IEEE 754 states that they must round to the closest even digit (also known as "Banker's Rounding"). For example, both `printf("%1.0f", 1.5)` and `printf("%1.0f", 2.5)` should round to 2. Previously, 1.5 would round to 2 and 2.5 would round to 3. This change only affects exactly representable numbers. For example, 2.35 (which, when represented in memory, is closer to 2.35000000000000008) continues to round up to 2.4. Rounding done by these functions now also respects the floating point rounding mode set by [`fesetround`](fegetround-fesetround2.md). Previously, rounding always chose `FE_TONEAREST` behavior. This change only affects programs built using Visual Studio 2019 version 16.2 and later. To use the legacy floating point rounding behavior, link with ['legacy_stdio_float_rounding.obj`](../link-options.md). +> Starting in Windows 10 version 2004 (build 19041), the `printf` family of functions prints exactly representable floating point numbers according to the IEEE 754 rules for rounding. In previous versions of Windows, exactly representable floating point numbers ending in '5' would always round up. IEEE 754 states that they must round to the closest even digit (also known as "Banker's Rounding"). For example, both `printf("%1.0f", 1.5)` and `printf("%1.0f", 2.5)` should round to 2. Previously, 1.5 would round to 2 and 2.5 would round to 3. This change only affects exactly representable numbers. For example, 2.35 (which, when represented in memory, is closer to 2.35000000000000008) continues to round up to 2.4. Rounding done by these functions now also respects the floating point rounding mode set by [`fesetround`](fegetround-fesetround2.md). Previously, rounding always chose `FE_TONEAREST` behavior. This change only affects programs built using Visual Studio 2019 version 16.2 and later. To use the legacy floating point rounding behavior, link with [`legacy_stdio_float_rounding.obj`](../link-options.md). If either *`stream`* or *`format`* is a null pointer, or if the format string contains invalid formatting characters, the invalid parameter handler is invoked, as described in [Parameter validation](../parameter-validation.md). If execution is allowed to continue, the functions return -1 and set `errno` to `EINVAL`. diff --git a/docs/c-runtime-library/reference/vfprintf-s-vfprintf-s-l-vfwprintf-s-vfwprintf-s-l.md b/docs/c-runtime-library/reference/vfprintf-s-vfprintf-s-l-vfwprintf-s-vfwprintf-s-l.md index ffb2bfde120..5b805440d0e 100644 --- a/docs/c-runtime-library/reference/vfprintf-s-vfprintf-s-l-vfwprintf-s-vfwprintf-s-l.md +++ b/docs/c-runtime-library/reference/vfprintf-s-vfprintf-s-l-vfwprintf-s-vfwprintf-s-l.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: vfprintf_s, _vfprintf_s_l, vfwprintf_s, _vfwprintf_s_l" title: "vfprintf_s, _vfprintf_s_l, vfwprintf_s, _vfwprintf_s_l" -ms.date: "3/9/2021" +description: "Learn more about: vfprintf_s, _vfprintf_s_l, vfwprintf_s, _vfwprintf_s_l" +ms.date: 3/9/2021 api_name: ["vfwprintf_s", "_vfprintf_s_l", "vfprintf_s", "_vfwprintf_s_l"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll"] api_type: ["DLLExport"] @@ -74,7 +74,7 @@ The versions of these functions with the `_l` suffix are identical except that t > [!IMPORTANT] > Ensure that *`format`* is not a user-defined string. For more information, see [Avoiding buffer overruns](/windows/win32/SecBP/avoiding-buffer-overruns). -> Starting in Windows 10 version 2004 (build 19041), the `printf` family of functions prints exactly representable floating point numbers according to the IEEE 754 rules for rounding. In previous versions of Windows, exactly representable floating point numbers ending in '5' would always round up. IEEE 754 states that they must round to the closest even digit (also known as "Banker's Rounding"). For example, both `printf("%1.0f", 1.5)` and `printf("%1.0f", 2.5)` should round to 2. Previously, 1.5 would round to 2 and 2.5 would round to 3. This change only affects exactly representable numbers. For example, 2.35 (which, when represented in memory, is closer to 2.35000000000000008) continues to round up to 2.4. Rounding done by these functions now also respects the floating point rounding mode set by [`fesetround`](fegetround-fesetround2.md). Previously, rounding always chose `FE_TONEAREST` behavior. This change only affects programs built using Visual Studio 2019 version 16.2 and later. To use the legacy floating point rounding behavior, link with ['legacy_stdio_float_rounding.obj`](../link-options.md). +> Starting in Windows 10 version 2004 (build 19041), the `printf` family of functions prints exactly representable floating point numbers according to the IEEE 754 rules for rounding. In previous versions of Windows, exactly representable floating point numbers ending in '5' would always round up. IEEE 754 states that they must round to the closest even digit (also known as "Banker's Rounding"). For example, both `printf("%1.0f", 1.5)` and `printf("%1.0f", 2.5)` should round to 2. Previously, 1.5 would round to 2 and 2.5 would round to 3. This change only affects exactly representable numbers. For example, 2.35 (which, when represented in memory, is closer to 2.35000000000000008) continues to round up to 2.4. Rounding done by these functions now also respects the floating point rounding mode set by [`fesetround`](fegetround-fesetround2.md). Previously, rounding always chose `FE_TONEAREST` behavior. This change only affects programs built using Visual Studio 2019 version 16.2 and later. To use the legacy floating point rounding behavior, link with [`legacy_stdio_float_rounding.obj`](../link-options.md). ### Generic-text routine mappings diff --git a/docs/c-runtime-library/reference/vfprintf-vfprintf-l-vfwprintf-vfwprintf-l.md b/docs/c-runtime-library/reference/vfprintf-vfprintf-l-vfwprintf-vfwprintf-l.md index f4860772c9e..3c06a9bf539 100644 --- a/docs/c-runtime-library/reference/vfprintf-vfprintf-l-vfwprintf-vfwprintf-l.md +++ b/docs/c-runtime-library/reference/vfprintf-vfprintf-l-vfwprintf-vfwprintf-l.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: vfprintf, _vfprintf_l, vfwprintf, _vfwprintf_l" title: "vfprintf, _vfprintf_l, vfwprintf, _vfwprintf_l" -ms.date: "3/9/2021" +description: "Learn more about: vfprintf, _vfprintf_l, vfwprintf, _vfwprintf_l" +ms.date: 3/9/2021 api_name: ["_vfprintf_l", "vfprintf", "vfwprintf", "_vfwprintf_l"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll"] api_type: ["DLLExport"] @@ -72,7 +72,7 @@ The versions of these functions with the `_l` suffix are identical except that t > [!IMPORTANT] > Ensure that *`format`* is not a user-defined string. For more information, see [Avoiding buffer overruns](/windows/win32/SecBP/avoiding-buffer-overruns). -> Starting in Windows 10 version 2004 (build 19041), the `printf` family of functions prints exactly representable floating point numbers according to the IEEE 754 rules for rounding. In previous versions of Windows, exactly representable floating point numbers ending in '5' would always round up. IEEE 754 states that they must round to the closest even digit (also known as "Banker's Rounding"). For example, both `printf("%1.0f", 1.5)` and `printf("%1.0f", 2.5)` should round to 2. Previously, 1.5 would round to 2 and 2.5 would round to 3. This change only affects exactly representable numbers. For example, 2.35 (which, when represented in memory, is closer to 2.35000000000000008) continues to round up to 2.4. Rounding done by these functions now also respects the floating point rounding mode set by [`fesetround`](fegetround-fesetround2.md). Previously, rounding always chose `FE_TONEAREST` behavior. This change only affects programs built using Visual Studio 2019 version 16.2 and later. To use the legacy floating point rounding behavior, link with ['legacy_stdio_float_rounding.obj`](../link-options.md). +> Starting in Windows 10 version 2004 (build 19041), the `printf` family of functions prints exactly representable floating point numbers according to the IEEE 754 rules for rounding. In previous versions of Windows, exactly representable floating point numbers ending in '5' would always round up. IEEE 754 states that they must round to the closest even digit (also known as "Banker's Rounding"). For example, both `printf("%1.0f", 1.5)` and `printf("%1.0f", 2.5)` should round to 2. Previously, 1.5 would round to 2 and 2.5 would round to 3. This change only affects exactly representable numbers. For example, 2.35 (which, when represented in memory, is closer to 2.35000000000000008) continues to round up to 2.4. Rounding done by these functions now also respects the floating point rounding mode set by [`fesetround`](fegetround-fesetround2.md). Previously, rounding always chose `FE_TONEAREST` behavior. This change only affects programs built using Visual Studio 2019 version 16.2 and later. To use the legacy floating point rounding behavior, link with [`legacy_stdio_float_rounding.obj`](../link-options.md). ### Generic-text routine mappings diff --git a/docs/c-runtime-library/reference/vprintf-p-vprintf-p-l-vwprintf-p-vwprintf-p-l.md b/docs/c-runtime-library/reference/vprintf-p-vprintf-p-l-vwprintf-p-vwprintf-p-l.md index e3ea98113ae..239ea8e1b57 100644 --- a/docs/c-runtime-library/reference/vprintf-p-vprintf-p-l-vwprintf-p-vwprintf-p-l.md +++ b/docs/c-runtime-library/reference/vprintf-p-vprintf-p-l-vwprintf-p-vwprintf-p-l.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: _vprintf_p, _vprintf_p_l, _vwprintf_p, _vwprintf_p_l" title: "_vprintf_p, _vprintf_p_l, _vwprintf_p, _vwprintf_p_l" -ms.date: "3/9/2021" +description: "Learn more about: _vprintf_p, _vprintf_p_l, _vwprintf_p, _vwprintf_p_l" +ms.date: 3/9/2021 api_name: ["_vwprintf_p", "_vprintf_p", "_vprintf_p_l", "_vwprintf_p_l"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll"] api_type: ["DLLExport"] @@ -63,7 +63,7 @@ The versions of these functions with the `_l` suffix are identical except that t > [!IMPORTANT] > Ensure that *`format`* is not a user-defined string. For more information, see [Avoiding buffer overruns](/windows/win32/SecBP/avoiding-buffer-overruns). -> Starting in Windows 10 version 2004 (build 19041), the `printf` family of functions prints exactly representable floating point numbers according to the IEEE 754 rules for rounding. In previous versions of Windows, exactly representable floating point numbers ending in '5' would always round up. IEEE 754 states that they must round to the closest even digit (also known as "Banker's Rounding"). For example, both `printf("%1.0f", 1.5)` and `printf("%1.0f", 2.5)` should round to 2. Previously, 1.5 would round to 2 and 2.5 would round to 3. This change only affects exactly representable numbers. For example, 2.35 (which, when represented in memory, is closer to 2.35000000000000008) continues to round up to 2.4. Rounding done by these functions now also respects the floating point rounding mode set by [`fesetround`](fegetround-fesetround2.md). Previously, rounding always chose `FE_TONEAREST` behavior. This change only affects programs built using Visual Studio 2019 version 16.2 and later. To use the legacy floating point rounding behavior, link with ['legacy_stdio_float_rounding.obj`](../link-options.md). +> Starting in Windows 10 version 2004 (build 19041), the `printf` family of functions prints exactly representable floating point numbers according to the IEEE 754 rules for rounding. In previous versions of Windows, exactly representable floating point numbers ending in '5' would always round up. IEEE 754 states that they must round to the closest even digit (also known as "Banker's Rounding"). For example, both `printf("%1.0f", 1.5)` and `printf("%1.0f", 2.5)` should round to 2. Previously, 1.5 would round to 2 and 2.5 would round to 3. This change only affects exactly representable numbers. For example, 2.35 (which, when represented in memory, is closer to 2.35000000000000008) continues to round up to 2.4. Rounding done by these functions now also respects the floating point rounding mode set by [`fesetround`](fegetround-fesetround2.md). Previously, rounding always chose `FE_TONEAREST` behavior. This change only affects programs built using Visual Studio 2019 version 16.2 and later. To use the legacy floating point rounding behavior, link with [`legacy_stdio_float_rounding.obj`](../link-options.md). If *`format`* is a null pointer, or if the format string contains invalid formatting characters, the invalid parameter handler is invoked, as described in [Parameter validation](../parameter-validation.md). If execution is allowed to continue, the functions return -1 and set `errno` to `EINVAL`. diff --git a/docs/c-runtime-library/reference/vprintf-s-vprintf-s-l-vwprintf-s-vwprintf-s-l.md b/docs/c-runtime-library/reference/vprintf-s-vprintf-s-l-vwprintf-s-vwprintf-s-l.md index 9b7f90e5ef2..b1a404e8fc5 100644 --- a/docs/c-runtime-library/reference/vprintf-s-vprintf-s-l-vwprintf-s-vwprintf-s-l.md +++ b/docs/c-runtime-library/reference/vprintf-s-vprintf-s-l-vwprintf-s-vwprintf-s-l.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: vprintf_s, _vprintf_s_l, vwprintf_s, _vwprintf_s_l" title: "vprintf_s, _vprintf_s_l, vwprintf_s, _vwprintf_s_l" -ms.date: "3/9/2021" +description: "Learn more about: vprintf_s, _vprintf_s_l, vwprintf_s, _vwprintf_s_l" +ms.date: 3/9/2021 api_name: ["_vwprintf_s_l", "vwprintf_s", "_vprintf_s_l", "vprintf_s"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll"] api_type: ["DLLExport"] @@ -67,7 +67,7 @@ The versions of these functions with the `_l` suffix are identical except that t > [!IMPORTANT] > Ensure that *`format`* is not a user-defined string. For more information, see [Avoiding buffer overruns](/windows/win32/SecBP/avoiding-buffer-overruns). -> Starting in Windows 10 version 2004 (build 19041), the `printf` family of functions prints exactly representable floating point numbers according to the IEEE 754 rules for rounding. In previous versions of Windows, exactly representable floating point numbers ending in '5' would always round up. IEEE 754 states that they must round to the closest even digit (also known as "Banker's Rounding"). For example, both `printf("%1.0f", 1.5)` and `printf("%1.0f", 2.5)` should round to 2. Previously, 1.5 would round to 2 and 2.5 would round to 3. This change only affects exactly representable numbers. For example, 2.35 (which, when represented in memory, is closer to 2.35000000000000008) continues to round up to 2.4. Rounding done by these functions now also respects the floating point rounding mode set by [`fesetround`](fegetround-fesetround2.md). Previously, rounding always chose `FE_TONEAREST` behavior. This change only affects programs built using Visual Studio 2019 version 16.2 and later. To use the legacy floating point rounding behavior, link with ['legacy_stdio_float_rounding.obj`](../link-options.md). +> Starting in Windows 10 version 2004 (build 19041), the `printf` family of functions prints exactly representable floating point numbers according to the IEEE 754 rules for rounding. In previous versions of Windows, exactly representable floating point numbers ending in '5' would always round up. IEEE 754 states that they must round to the closest even digit (also known as "Banker's Rounding"). For example, both `printf("%1.0f", 1.5)` and `printf("%1.0f", 2.5)` should round to 2. Previously, 1.5 would round to 2 and 2.5 would round to 3. This change only affects exactly representable numbers. For example, 2.35 (which, when represented in memory, is closer to 2.35000000000000008) continues to round up to 2.4. Rounding done by these functions now also respects the floating point rounding mode set by [`fesetround`](fegetround-fesetround2.md). Previously, rounding always chose `FE_TONEAREST` behavior. This change only affects programs built using Visual Studio 2019 version 16.2 and later. To use the legacy floating point rounding behavior, link with [`legacy_stdio_float_rounding.obj`](../link-options.md). ### Generic-text routine mappings diff --git a/docs/c-runtime-library/reference/vprintf-vprintf-l-vwprintf-vwprintf-l.md b/docs/c-runtime-library/reference/vprintf-vprintf-l-vwprintf-vwprintf-l.md index 4575ef26d7d..e91e6092aeb 100644 --- a/docs/c-runtime-library/reference/vprintf-vprintf-l-vwprintf-vwprintf-l.md +++ b/docs/c-runtime-library/reference/vprintf-vprintf-l-vwprintf-vwprintf-l.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: vprintf, _vprintf_l, vwprintf, _vwprintf_l" title: "vprintf, _vprintf_l, vwprintf, _vwprintf_l" -ms.date: "3/9/2021" +description: "Learn more about: vprintf, _vprintf_l, vwprintf, _vwprintf_l" +ms.date: 3/9/2021 api_name: ["vprintf", "_vwprintf_l", "_vprintf_l", "vwprintf"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll"] api_type: ["DLLExport"] @@ -65,7 +65,7 @@ The versions of these functions with the `_l` suffix are identical except that t > [!IMPORTANT] > Ensure that *`format`* is not a user-defined string. For more information, see [Avoiding buffer overruns](/windows/win32/SecBP/avoiding-buffer-overruns). Invalid format strings are detected and result in an error. -> Starting in Windows 10 version 2004 (build 19041), the `printf` family of functions prints exactly representable floating point numbers according to the IEEE 754 rules for rounding. In previous versions of Windows, exactly representable floating point numbers ending in '5' would always round up. IEEE 754 states that they must round to the closest even digit (also known as "Banker's Rounding"). For example, both `printf("%1.0f", 1.5)` and `printf("%1.0f", 2.5)` should round to 2. Previously, 1.5 would round to 2 and 2.5 would round to 3. This change only affects exactly representable numbers. For example, 2.35 (which, when represented in memory, is closer to 2.35000000000000008) continues to round up to 2.4. Rounding done by these functions now also respects the floating point rounding mode set by [`fesetround`](fegetround-fesetround2.md). Previously, rounding always chose `FE_TONEAREST` behavior. This change only affects programs built using Visual Studio 2019 version 16.2 and later. To use the legacy floating point rounding behavior, link with ['legacy_stdio_float_rounding.obj`](../link-options.md). +> Starting in Windows 10 version 2004 (build 19041), the `printf` family of functions prints exactly representable floating point numbers according to the IEEE 754 rules for rounding. In previous versions of Windows, exactly representable floating point numbers ending in '5' would always round up. IEEE 754 states that they must round to the closest even digit (also known as "Banker's Rounding"). For example, both `printf("%1.0f", 1.5)` and `printf("%1.0f", 2.5)` should round to 2. Previously, 1.5 would round to 2 and 2.5 would round to 3. This change only affects exactly representable numbers. For example, 2.35 (which, when represented in memory, is closer to 2.35000000000000008) continues to round up to 2.4. Rounding done by these functions now also respects the floating point rounding mode set by [`fesetround`](fegetround-fesetround2.md). Previously, rounding always chose `FE_TONEAREST` behavior. This change only affects programs built using Visual Studio 2019 version 16.2 and later. To use the legacy floating point rounding behavior, link with [`legacy_stdio_float_rounding.obj`](../link-options.md). ### Generic-text routine mappings diff --git a/docs/c-runtime-library/reference/vscprintf-p-vscprintf-p-l-vscwprintf-p-vscwprintf-p-l.md b/docs/c-runtime-library/reference/vscprintf-p-vscprintf-p-l-vscwprintf-p-vscwprintf-p-l.md index c2185baab27..388f6f46a27 100644 --- a/docs/c-runtime-library/reference/vscprintf-p-vscprintf-p-l-vscwprintf-p-vscwprintf-p-l.md +++ b/docs/c-runtime-library/reference/vscprintf-p-vscprintf-p-l-vscwprintf-p-vscwprintf-p-l.md @@ -1,7 +1,7 @@ --- title: "_vscprintf_p, _vscprintf_p_l, _vscwprintf_p, _vscwprintf_p_l" description: "Learn more about: _vscprintf_p, _vscprintf_p_l, _vscwprintf_p, _vscwprintf_p_l" -ms.date: "10/21/2021" +ms.date: 10/21/2021 api_name: ["_vscprintf_p_l", "_vscprintf_p", "_vscwprintf_p_l", "_vscwprintf_p"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll"] api_type: ["DLLExport"] @@ -59,11 +59,14 @@ These functions differ from **`_vscprintf`** and **`_vscwprintf`** only in that The versions of these functions with the **`_l`** suffix are identical except that they use the locale parameter passed in instead of the current thread locale. +Return Value is the size of the formatted data. If the function takes a `char` buffer, the size is in bytes. If the function takes a `wchar_t` buffer, the size specifies the number of 16-bit words. +Characters refer to `char` characters for functions that take a `char` buffer, and to `wchar_t` characters for functions that take a `wchar_t` buffer. + If *`format`* is a null pointer, the invalid parameter handler is invoked, as described in [Parameter validation](../parameter-validation.md). If execution is allowed to continue, the functions return -1 and set `errno` to `EINVAL`. > [!IMPORTANT] > Ensure that if *`format`* is a user-defined string, it is null terminated and has the correct number and type of parameters. For more information, see [Avoiding buffer overruns](/windows/win32/SecBP/avoiding-buffer-overruns). -> Starting in Windows 10 version 2004 (build 19041), the `printf` family of functions prints exactly representable floating point numbers according to the IEEE 754 rules for rounding. In previous versions of Windows, exactly representable floating point numbers ending in '5' would always round up. IEEE 754 states that they must round to the closest even digit (also known as "Banker's Rounding"). For example, both `printf("%1.0f", 1.5)` and `printf("%1.0f", 2.5)` should round to 2. Previously, 1.5 would round to 2 and 2.5 would round to 3. This change only affects exactly representable numbers. For example, 2.35 (which, when represented in memory, is closer to 2.35000000000000008) continues to round up to 2.4. Rounding done by these functions now also respects the floating point rounding mode set by [`fesetround`](fegetround-fesetround2.md). Previously, rounding always chose `FE_TONEAREST` behavior. This change only affects programs built using Visual Studio 2019 version 16.2 and later. To use the legacy floating point rounding behavior, link with ['legacy_stdio_float_rounding.obj`](../link-options.md). +> Starting in Windows 10 version 2004 (build 19041), the `printf` family of functions prints exactly representable floating point numbers according to the IEEE 754 rules for rounding. In previous versions of Windows, exactly representable floating point numbers ending in '5' would always round up. IEEE 754 states that they must round to the closest even digit (also known as "Banker's Rounding"). For example, both `printf("%1.0f", 1.5)` and `printf("%1.0f", 2.5)` should round to 2. Previously, 1.5 would round to 2 and 2.5 would round to 3. This change only affects exactly representable numbers. For example, 2.35 (which, when represented in memory, is closer to 2.35000000000000008) continues to round up to 2.4. Rounding done by these functions now also respects the floating point rounding mode set by [`fesetround`](fegetround-fesetround2.md). Previously, rounding always chose `FE_TONEAREST` behavior. This change only affects programs built using Visual Studio 2019 version 16.2 and later. To use the legacy floating point rounding behavior, link with [`legacy_stdio_float_rounding.obj`](../link-options.md). ### Generic-text routine mappings diff --git a/docs/c-runtime-library/reference/vscprintf-vscprintf-l-vscwprintf-vscwprintf-l.md b/docs/c-runtime-library/reference/vscprintf-vscprintf-l-vscwprintf-vscwprintf-l.md index 080aed3268b..ac02613e06b 100644 --- a/docs/c-runtime-library/reference/vscprintf-vscprintf-l-vscwprintf-vscwprintf-l.md +++ b/docs/c-runtime-library/reference/vscprintf-vscprintf-l-vscwprintf-vscwprintf-l.md @@ -59,6 +59,9 @@ If *`format`* is a null pointer, the invalid parameter handler is invoked, as de ## Remarks +Return Value is the size of the formatted data. If the function takes a `char` buffer, the size is in bytes. If the function takes a `wchar_t` buffer, the size specifies the number of 16-bit words. +Characters refer to `char` characters for functions that take a `char` buffer, and to `wchar_t` characters for functions that take a `wchar_t` buffer. + Each *`argument`* (if any) is converted according to the corresponding format specification in *`format`*. The format consists of ordinary characters and has the same form and function as the *`format`* argument for [`printf`](printf-printf-l-wprintf-wprintf-l.md). > [!IMPORTANT] diff --git a/docs/c-runtime-library/reference/vsnprintf-s-vsnprintf-s-vsnprintf-s-l-vsnwprintf-s-vsnwprintf-s-l.md b/docs/c-runtime-library/reference/vsnprintf-s-vsnprintf-s-vsnprintf-s-l-vsnwprintf-s-vsnwprintf-s-l.md index 690566a0fc2..0cdb13f915d 100644 --- a/docs/c-runtime-library/reference/vsnprintf-s-vsnprintf-s-vsnprintf-s-l-vsnwprintf-s-vsnwprintf-s-l.md +++ b/docs/c-runtime-library/reference/vsnprintf-s-vsnprintf-s-vsnprintf-s-l-vsnwprintf-s-vsnwprintf-s-l.md @@ -1,12 +1,12 @@ --- -description: "Learn more about: vsnprintf_s, _vsnprintf_s, _vsnprintf_s_l, _vsnwprintf_s, _vsnwprintf_s_l" title: "vsnprintf_s, _vsnprintf_s, _vsnprintf_s_l, _vsnwprintf_s, _vsnwprintf_s_l" +description: "Learn more about: vsnprintf_s, _vsnprintf_s, _vsnprintf_s_l, _vsnwprintf_s, _vsnwprintf_s_l" ms.date: 06/27/2023 api_name: ["_vsnwprintf_s", "_vsnwprintf_s_l", "_vsnprintf_s", "vsnprintf_s", "_vsnprintf_s_l"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ntdll.dll", "ucrtbase.dll", "ntoskrnl.exe"] api_type: ["DLLExport"] topic_type: ["apiref"] -f1_keywords: ["STDIO/vsnprintf_s", "STDIO/_vsnprintf_s", "CORECRT_WSTDIO/_vsnwprintf_s", "TCHAR/_vsntprintf_s", "STDIO/_vsnprintf_s_l", "CORECRT_WSTDIO/_vsnwprintf_s_l", "TCHAR/_vsntprintf_s_l", "vsnprintf_s", "_vsnprintf_s", "_vsnwprintf_s", "_vsntprintf_s", "_vsnprintf_s_l", "_vsnwprintf_s_l", "_vsntprintf_s_l"] +f1_keywords: ["STDIO/vsnprintf_s", "STDIO/_vsnprintf_s", "CORECRT_WSTDIO/_vsnwprintf_s", "TCHAR/_vsntprintf_s", "STDIO/_vsnprintf_s_l", "CORECRT_WSTDIO/_vsnwprintf_s_l", "TCHAR/_vsntprintf_s_l", "vsnprintf_s", "_vsnprintf_s", "_vsnwprintf_s", "_vsntprintf_s", "_vsnprintf_s_l", "_vsnwprintf_s_l", "_vsntprintf_s_l"] helpviewer_keywords: ["vsnwprintf_s function", "_vsntprintf_s function", "_vsntprintf_s_l function", "vsntprintf_s function", "vsnwprintf_s_l function", "vsnprintf_s_l function", "vsntprintf_s_l function", "_vsnwprintf_s_l function", "_vsnprintf_s function", "vsnprintf_s function", "_vsnprintf_s_l function", "_vsnwprintf_s function", "formatted text [C++]"] --- # `vsnprintf_s`, `_vsnprintf_s`, `_vsnprintf_s_l`, `_vsnwprintf_s`, `_vsnwprintf_s_l` @@ -105,12 +105,14 @@ See [Behavior summary](#behavior-summary) for details. ## Remarks -**`vsnprintf_s`** is identical to **`_vsnprintf_s`** and is included for conformance to the ANSI standard. **`_vnsprintf`** is retained for backward compatibility. +Each of these functions takes a pointer to an argument list, then formats and writes up to *`count`* characters of the given data to the memory pointed to by *`buffer`* and appends a terminating `NULL`. -Each of these functions takes a pointer to an argument list, then formats and writes up to *`count`* characters of the given data to the memory pointed to by *`buffer`* and appends a terminating null. +In debug builds, the remaining `sizeOfBuffer` bytes following the terminating `NULL` are filled with 'xFE' as described in [`_CrtSetDebugFillThreshold`](crtsetdebugfillthreshold.md). The versions of these functions with the **`_l`** suffix are identical except that they use the locale parameter passed in instead of the current thread locale. +**`vsnprintf_s`** is identical to **`_vsnprintf_s`** and is included for conformance to the ANSI standard. **`_vnsprintf`** is retained for backward compatibility. + ### Behavior summary For the following table: @@ -127,6 +129,7 @@ For the following table: | `buffer == NULL` and `sizeOfBuffer == 0` and `count == 0` | No data is written. | 0 | N/A | No | | `buffer == NULL` and either `sizeOfBuffer != 0` or `count != 0` | If execution continues after invalid parameter handler executes, sets `errno` and returns a negative value.| -1 | `EINVAL` (22) | Yes | | `buffer != NULL` and `sizeOfBuffer == 0` | No data is written. If execution continues after invalid parameter handler executes, sets `errno` and returns a negative value. | -1 | `EINVAL` (22) | Yes | +| `buffer != NULL` and `sizeOfBuffer != 0` and `count == 0` | The buffer is `NULL` terminated. | -1 | N/A | No | | `count == 0`| Doesn't write any data and returns the number of characters that would have been written, not including the terminating `NULL`. | The number of characters that would have been written not including the terminating `NULL`. | N/A | No | | `count < 0` | Unsafe: the value is treated as unsigned, likely creating a large value that results in overwriting the memory that follows the buffer. | The number of characters written, not including the terminating `NULL`. | N/A | No | | `count < sizeOfBuffer` and `len <= count` | All of the data is written and a terminating `NULL` is appended. | The number of characters written. | N/A | No | @@ -141,10 +144,10 @@ For information about these and other error codes, see [`_doserrno`, `errno`, `_ > [!IMPORTANT] > Ensure that *`format`* is not a user-defined string. For more information, see [Avoiding buffer overruns](/windows/win32/SecBP/avoiding-buffer-overruns). -> Starting in Windows 10 version 2004 (build 19041), the `printf` family of functions prints exactly representable floating point numbers according to the IEEE 754 rules for rounding. In previous versions of Windows, exactly representable floating point numbers ending in '5' would always round up. IEEE 754 states that they must round to the closest even digit (also known as "Banker's Rounding"). For example, both `printf("%1.0f", 1.5)` and `printf("%1.0f", 2.5)` should round to 2. Previously, 1.5 would round to 2 and 2.5 would round to 3. This change only affects exactly representable numbers. For example, 2.35 (which, when represented in memory, is closer to 2.35000000000000008) continues to round up to 2.4. Rounding done by these functions now also respects the floating point rounding mode set by [`fesetround`](fegetround-fesetround2.md). Previously, rounding always chose `FE_TONEAREST` behavior. This change only affects programs built using Visual Studio 2019 version 16.2 and later. To use the legacy floating point rounding behavior, link with ['legacy_stdio_float_rounding.obj`](../link-options.md). +> Starting in Windows 10 version 2004 (build 19041), the `printf` family of functions prints exactly representable floating point numbers according to the IEEE 754 rules for rounding. In previous versions of Windows, exactly representable floating point numbers ending in '5' would always round up. IEEE 754 states that they must round to the closest even digit (also known as "Banker's Rounding"). For example, both `printf("%1.0f", 1.5)` and `printf("%1.0f", 2.5)` should round to 2. Previously, 1.5 would round to 2 and 2.5 would round to 3. This change only affects exactly representable numbers. For example, 2.35 (which, when represented in memory, is closer to 2.35000000000000008) continues to round up to 2.4. Rounding done by these functions now also respects the floating point rounding mode set by [`fesetround`](fegetround-fesetround2.md). Previously, rounding always chose `FE_TONEAREST` behavior. This change only affects programs built using Visual Studio 2019 version 16.2 and later. To use the legacy floating point rounding behavior, link with [`legacy_stdio_float_rounding.obj`](../link-options.md). > [!NOTE] -> To ensure that there is room for the terminating null, be sure that *`count`* is strictly less than the buffer length, or use `_TRUNCATE`. +> To ensure that there is room for the terminating `NULL`, be sure that *`count`* is strictly less than the buffer length, or use `_TRUNCATE`. In C++, using these functions is simplified by template overloads; the overloads can infer buffer length automatically (eliminating the need to specify a size argument) and they can automatically replace older, non-secure functions with their newer, secure counterparts. For more information, see [Secure template overloads](../secure-template-overloads.md). @@ -209,4 +212,4 @@ nSize: -1, buff: Hi there! [`fprintf`, `_fprintf_l`, `fwprintf`, `_fwprintf_l`](fprintf-fprintf-l-fwprintf-fwprintf-l.md)\ [`printf`, `_printf_l`, `wprintf`, `_wprintf_l`](printf-printf-l-wprintf-wprintf-l.md)\ [`sprintf`, `_sprintf_l`, `swprintf`, `_swprintf_l`, `__swprintf_l`](sprintf-sprintf-l-swprintf-swprintf-l-swprintf-l.md)\ -[`va_arg`, `va_copy`, `va_end`, `va_start`](va-arg-va-copy-va-end-va-start.md) \ No newline at end of file +[`va_arg`, `va_copy`, `va_end`, `va_start`](va-arg-va-copy-va-end-va-start.md) diff --git a/docs/c-runtime-library/reference/vsnprintf-vsnprintf-vsnprintf-l-vsnwprintf-vsnwprintf-l.md b/docs/c-runtime-library/reference/vsnprintf-vsnprintf-vsnprintf-l-vsnwprintf-vsnwprintf-l.md index b4a5f312137..7a90fece022 100644 --- a/docs/c-runtime-library/reference/vsnprintf-vsnprintf-vsnprintf-l-vsnwprintf-vsnwprintf-l.md +++ b/docs/c-runtime-library/reference/vsnprintf-vsnprintf-vsnprintf-l-vsnwprintf-vsnwprintf-l.md @@ -129,7 +129,7 @@ Beginning with the UCRT in Visual Studio 2015 and Windows 10, **`vsnprintf`** is > [!IMPORTANT] > To prevent certain kinds of security risks, ensure that *`format`* isn't a user-defined string. For more information, see [Avoiding buffer overruns](/windows/win32/SecBP/avoiding-buffer-overruns). -> Starting in Windows 10 version 2004 (build 19041), the `printf` family of functions prints exactly representable floating point numbers according to the IEEE 754 rules for rounding. In previous versions of Windows, exactly representable floating point numbers ending in '5' would always round up. IEEE 754 states that they must round to the closest even digit (also known as "Banker's Rounding"). For example, both `printf("%1.0f", 1.5)` and `printf("%1.0f", 2.5)` should round to 2. Previously, 1.5 would round to 2 and 2.5 would round to 3. This change only affects exactly representable numbers. For example, 2.35 (which, when represented in memory, is closer to 2.35000000000000008) continues to round up to 2.4. Rounding done by these functions now also respects the floating point rounding mode set by [`fesetround`](fegetround-fesetround2.md). Previously, rounding always chose `FE_TONEAREST` behavior. This change only affects programs built using Visual Studio 2019 version 16.2 and later. To use the legacy floating point rounding behavior, link with ['legacy_stdio_float_rounding.obj`](../link-options.md). +> Starting in Windows 10 version 2004 (build 19041), the `printf` family of functions prints exactly representable floating point numbers according to the IEEE 754 rules for rounding. In previous versions of Windows, exactly representable floating point numbers ending in '5' would always round up. IEEE 754 states that they must round to the closest even digit (also known as "Banker's Rounding"). For example, both `printf("%1.0f", 1.5)` and `printf("%1.0f", 2.5)` should round to 2. Previously, 1.5 would round to 2 and 2.5 would round to 3. This change only affects exactly representable numbers. For example, 2.35 (which, when represented in memory, is closer to 2.35000000000000008) continues to round up to 2.4. Rounding done by these functions now also respects the floating point rounding mode set by [`fesetround`](fegetround-fesetround2.md). Previously, rounding always chose `FE_TONEAREST` behavior. This change only affects programs built using Visual Studio 2019 version 16.2 and later. To use the legacy floating point rounding behavior, link with [`legacy_stdio_float_rounding.obj`](../link-options.md). > [!NOTE] > To ensure that there's room for the terminating null when calling **`_vsnprintf`**, **`_vsnprintf_l`**, **`_vsnwprintf`** and **`_vsnwprintf_l`**, be sure that *`count`* is strictly less than the buffer length and initialize the buffer to null prior to calling the function. @@ -155,7 +155,8 @@ For the following table: | Encoding error during formatting | If processing string specifier `s`, `S`, or `Z`, format specification processing stops. | -1 | `EILSEQ` (42) | No | | Encoding error during formatting | If processing character specifier `c` or `C`, the invalid character is skipped. The number of characters written isn't incremented for the skipped character, nor is any data written for it. Processing the format specification continues after skipping the specifier with the encoding error. | The number of characters written, not including the terminating `NULL`. | `EILSEQ` (42) | No | | `buffer == NULL` and `count != 0` | If execution continues after invalid parameter handler executes, sets `errno` and returns a negative value.| -1 | `EINVAL` (22) | Yes | -| `count == 0` | No data is written | The number of characters that would have been written, not including the terminating `NULL`. You can use this result to allocate sufficient buffer space for the string and a terminating `NULL`, and then call the function again to fill the buffer. | N/A | No | +| `buffer == NULL` and `count == 0` | No data is written | The number of characters that would have been written, not including the terminating `NULL`. You can use this result to allocate sufficient buffer space for the string and a terminating `NULL`, and then call the function again to fill the buffer. | N/A | No | +| `count == 0` | No data is written | -1 | `ERANGE` (34) | No | | `count < 0`| Unsafe: the value is treated as unsigned, likely creating a large value that results in overwriting the memory that follows the buffer. | The number of characters written. | N/A | No | | `count < sizeOfBuffer` and `len <= count` | All of the data is written and a terminating `NULL` is appended. | The number of characters written, not including the terminating `NULL`. | N/A | No | | `count < sizeOfBuffer` and `len > count` | The first *`count-1`* characters are written followed by a null-terminator. | The number of characters that would have been written had `count` matched the number of characters to output, not including the null-terminator. | N/A | No | diff --git a/docs/c-runtime-library/reference/vsprintf-p-vsprintf-p-l-vswprintf-p-vswprintf-p-l.md b/docs/c-runtime-library/reference/vsprintf-p-vsprintf-p-l-vswprintf-p-vswprintf-p-l.md index a5ab73d4170..7b74d3eb27a 100644 --- a/docs/c-runtime-library/reference/vsprintf-p-vsprintf-p-l-vswprintf-p-vswprintf-p-l.md +++ b/docs/c-runtime-library/reference/vsprintf-p-vsprintf-p-l-vswprintf-p-vswprintf-p-l.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: _vsprintf_p, _vsprintf_p_l, _vswprintf_p, _vswprintf_p_l" title: "_vsprintf_p, _vsprintf_p_l, _vswprintf_p, _vswprintf_p_l" -ms.date: "3/9/2021" +description: "Learn more about: _vsprintf_p, _vsprintf_p_l, _vswprintf_p, _vswprintf_p_l" +ms.date: 3/9/2021 api_name: ["_vsprintf_p", "_vswprintf_p", "_vsprintf_p_l", "_vswprintf_p_l"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll"] api_type: ["DLLExport"] @@ -66,7 +66,9 @@ The locale to use. ## Return value -**`_vsprintf_p`** and **`_vswprintf_p`** return the number of characters written, not including the terminating null character, or a negative value if an output error occurs. +**`_vsprintf_p`** and **`_vswprintf_p`** return the number of characters written, not including the terminating `NULL` character, or a negative value if an output error occurs. +If the *`buffer`* is a `NULL` pointer and *`sizeInBytes`* or *`count`* are zero, functions return the number of characters that would have been written not including the terminating `NULL`. +If the *`buffer`* is valid and *`sizeInBytes`* or *`count`* are zero, returns -1. ## Remarks @@ -76,10 +78,10 @@ These functions differ from the `vsprintf_s` and `vswprintf_s` only in that they The versions of these functions with the `_l` suffix are identical except that they use the locale parameter passed in instead of the current thread locale. -If the *`buffer`* or *`format`* parameters are `NULL` pointers, if count is zero, or if the format string contains invalid formatting characters, the invalid parameter handler is invoked, as described in [Parameter validation](../parameter-validation.md). If execution is allowed to continue, the functions return -1 and set `errno` to `EINVAL`. +If the *`buffer`* or *`format`* parameters are `NULL` pointers, or if the format string contains invalid formatting characters, the invalid parameter handler is invoked, as described in [Parameter validation](../parameter-validation.md). If execution is allowed to continue, the functions return -1 and set `errno` to `EINVAL`. > [!IMPORTANT] -> Starting in Windows 10 version 2004 (build 19041), the `printf` family of functions prints exactly representable floating point numbers according to the IEEE 754 rules for rounding. In previous versions of Windows, exactly representable floating point numbers ending in '5' would always round up. IEEE 754 states that they must round to the closest even digit (also known as "Banker's Rounding"). For example, both `printf("%1.0f", 1.5)` and `printf("%1.0f", 2.5)` should round to 2. Previously, 1.5 would round to 2 and 2.5 would round to 3. This change only affects exactly representable numbers. For example, 2.35 (which, when represented in memory, is closer to 2.35000000000000008) continues to round up to 2.4. Rounding done by these functions now also respects the floating point rounding mode set by [`fesetround`](fegetround-fesetround2.md). Previously, rounding always chose `FE_TONEAREST` behavior. This change only affects programs built using Visual Studio 2019 version 16.2 and later. To use the legacy floating point rounding behavior, link with ['legacy_stdio_float_rounding.obj`](../link-options.md). +> Starting in Windows 10 version 2004 (build 19041), the `printf` family of functions prints exactly representable floating point numbers according to the IEEE 754 rules for rounding. In previous versions of Windows, exactly representable floating point numbers ending in '5' would always round up. IEEE 754 states that they must round to the closest even digit (also known as "Banker's Rounding"). For example, both `printf("%1.0f", 1.5)` and `printf("%1.0f", 2.5)` should round to 2. Previously, 1.5 would round to 2 and 2.5 would round to 3. This change only affects exactly representable numbers. For example, 2.35 (which, when represented in memory, is closer to 2.35000000000000008) continues to round up to 2.4. Rounding done by these functions now also respects the floating point rounding mode set by [`fesetround`](fegetround-fesetround2.md). Previously, rounding always chose `FE_TONEAREST` behavior. This change only affects programs built using Visual Studio 2019 version 16.2 and later. To use the legacy floating point rounding behavior, link with [`legacy_stdio_float_rounding.obj`](../link-options.md). ### Generic-text routine mappings diff --git a/docs/c-runtime-library/reference/vsprintf-s-vsprintf-s-l-vswprintf-s-vswprintf-s-l.md b/docs/c-runtime-library/reference/vsprintf-s-vsprintf-s-l-vswprintf-s-vswprintf-s-l.md index 991b132063b..94c4dc36323 100644 --- a/docs/c-runtime-library/reference/vsprintf-s-vsprintf-s-l-vswprintf-s-vswprintf-s-l.md +++ b/docs/c-runtime-library/reference/vsprintf-s-vsprintf-s-l-vswprintf-s-vswprintf-s-l.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: vsprintf_s, _vsprintf_s_l, vswprintf_s, _vswprintf_s_l" title: "vsprintf_s, _vsprintf_s_l, vswprintf_s, _vswprintf_s_l, _vstprintf_s, _vstprintf_s_l" -ms.date: "3/9/2021" +description: "Learn more about: vsprintf_s, _vsprintf_s_l, vswprintf_s, _vswprintf_s_l" +ms.date: 3/9/2021 api_name: ["_vswprintf_s_l", "vsprintf_s", "vswprintf_s", "_vsprintf_s_l", _vstprintf_s, _vstprintf_s_l] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll", "ntoskrnl.exe"] api_type: ["DLLExport"] @@ -94,7 +94,7 @@ The versions of these functions with the **`_l`** suffix are identical except th In C++, using these functions is simplified by template overloads. The overloads can infer buffer length automatically, eliminating the need to specify a size argument. And, they can automatically replace non-secure functions with their secure counterparts. For more information, see [Secure template overloads](../secure-template-overloads.md). > [!IMPORTANT] -> Starting in Windows 10 version 2004 (build 19041), the `printf` family of functions prints exactly representable floating point numbers according to the IEEE 754 rules for rounding. In previous versions of Windows, exactly representable floating point numbers ending in '5' would always round up. IEEE 754 states that they must round to the closest even digit (also known as "Banker's Rounding"). For example, both `printf("%1.0f", 1.5)` and `printf("%1.0f", 2.5)` should round to 2. Previously, 1.5 would round to 2 and 2.5 would round to 3. This change only affects exactly representable numbers. For example, 2.35 (which, when represented in memory, is closer to 2.35000000000000008) continues to round up to 2.4. Rounding done by these functions now also respects the floating point rounding mode set by [`fesetround`](fegetround-fesetround2.md). Previously, rounding always chose `FE_TONEAREST` behavior. This change only affects programs built using Visual Studio 2019 version 16.2 and later. To use the legacy floating point rounding behavior, link with ['legacy_stdio_float_rounding.obj`](../link-options.md). +> Starting in Windows 10 version 2004 (build 19041), the `printf` family of functions prints exactly representable floating point numbers according to the IEEE 754 rules for rounding. In previous versions of Windows, exactly representable floating point numbers ending in '5' would always round up. IEEE 754 states that they must round to the closest even digit (also known as "Banker's Rounding"). For example, both `printf("%1.0f", 1.5)` and `printf("%1.0f", 2.5)` should round to 2. Previously, 1.5 would round to 2 and 2.5 would round to 3. This change only affects exactly representable numbers. For example, 2.35 (which, when represented in memory, is closer to 2.35000000000000008) continues to round up to 2.4. Rounding done by these functions now also respects the floating point rounding mode set by [`fesetround`](fegetround-fesetround2.md). Previously, rounding always chose `FE_TONEAREST` behavior. This change only affects programs built using Visual Studio 2019 version 16.2 and later. To use the legacy floating point rounding behavior, link with [`legacy_stdio_float_rounding.obj`](../link-options.md). ### Generic-text function mappings diff --git a/docs/c-runtime-library/reference/vsprintf-vsprintf-l-vswprintf-vswprintf-l-vswprintf-l.md b/docs/c-runtime-library/reference/vsprintf-vsprintf-l-vswprintf-vswprintf-l-vswprintf-l.md index 0d197f96190..e5eadb3323b 100644 --- a/docs/c-runtime-library/reference/vsprintf-vsprintf-l-vswprintf-vswprintf-l-vswprintf-l.md +++ b/docs/c-runtime-library/reference/vsprintf-vsprintf-l-vswprintf-vswprintf-l-vswprintf-l.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: vsprintf, _vsprintf_l, vswprintf, _vswprintf_l, __vswprintf_l" title: "vsprintf, _vsprintf_l, vswprintf, _vswprintf_l, __vswprintf_l" -ms.date: "3/9/2021" +description: "Learn more about: vsprintf, _vsprintf_l, vswprintf, _vswprintf_l, __vswprintf_l" +ms.date: 3/9/2021 api_name: ["_vswprintf_l", "_vsprintf_l", "vsprintf", "vswprintf", "__vswprintf_l"] api_location: ["msvcrt.dll", "msvcr80.dll", "msvcr90.dll", "msvcr100.dll", "msvcr100_clr0400.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr120_clr0400.dll", "ucrtbase.dll", "ntoskrnl.exe"] api_type: ["DLLExport"] @@ -95,6 +95,10 @@ The locale to use. **`vsprintf`** and **`vswprintf`** return the number of characters written, not including the terminating `NULL` character, or a negative value if an output error occurs. If *`buffer`* or *`format`* is a `NULL` pointer, these functions invoke the invalid parameter handler, as described in [Parameter validation](../parameter-validation.md). If execution is allowed to continue, these functions return -1 and set `errno` to `EINVAL`. +If *`buffer`* is a `NULL` pointer and *`count`* is zero, **`vswprintf`** and **`_vswprintf_l`** return the number of characters that would have been written not including the terminating NULL. + +If *`buffer`* is valid and *`count`* is zero, **`vswprintf`** and **`_vswprintf_l`** return -1. The contents of *`buffer`* are unchanged. + For information on these and other error codes, see [`errno`, `_doserrno`, `_sys_errlist`, and `_sys_nerr`](../errno-doserrno-sys-errlist-and-sys-nerr.md). ## Remarks @@ -105,7 +109,7 @@ The versions of these functions with the **`_l`** suffix are identical except th > [!IMPORTANT] > Using **`vsprintf`**, there is no way to limit the number of characters written, which means that code using this function is susceptible to buffer overruns. Use [`_vsnprintf`](vsnprintf-vsnprintf-vsnprintf-l-vsnwprintf-vsnwprintf-l.md) instead, or call [`_vscprintf`](vscprintf-vscprintf-l-vscwprintf-vscwprintf-l.md) to determine how large a buffer is needed. Also, ensure that *`format`* is not a user-defined string. For more information, see [Avoiding buffer overruns](/windows/win32/SecBP/avoiding-buffer-overruns). -> Starting in Windows 10 version 2004 (build 19041), the `printf` family of functions prints exactly representable floating point numbers according to the IEEE 754 rules for rounding. In previous versions of Windows, exactly representable floating point numbers ending in '5' would always round up. IEEE 754 states that they must round to the closest even digit (also known as "Banker's Rounding"). For example, both `printf("%1.0f", 1.5)` and `printf("%1.0f", 2.5)` should round to 2. Previously, 1.5 would round to 2 and 2.5 would round to 3. This change only affects exactly representable numbers. For example, 2.35 (which, when represented in memory, is closer to 2.35000000000000008) continues to round up to 2.4. Rounding done by these functions now also respects the floating point rounding mode set by [`fesetround`](fegetround-fesetround2.md). Previously, rounding always chose `FE_TONEAREST` behavior. This change only affects programs built using Visual Studio 2019 version 16.2 and later. To use the legacy floating point rounding behavior, link with ['legacy_stdio_float_rounding.obj`](../link-options.md). +> Starting in Windows 10 version 2004 (build 19041), the `printf` family of functions prints exactly representable floating point numbers according to the IEEE 754 rules for rounding. In previous versions of Windows, exactly representable floating point numbers ending in '5' would always round up. IEEE 754 states that they must round to the closest even digit (also known as "Banker's Rounding"). For example, both `printf("%1.0f", 1.5)` and `printf("%1.0f", 2.5)` should round to 2. Previously, 1.5 would round to 2 and 2.5 would round to 3. This change only affects exactly representable numbers. For example, 2.35 (which, when represented in memory, is closer to 2.35000000000000008) continues to round up to 2.4. Rounding done by these functions now also respects the floating point rounding mode set by [`fesetround`](fegetround-fesetround2.md). Previously, rounding always chose `FE_TONEAREST` behavior. This change only affects programs built using Visual Studio 2019 version 16.2 and later. To use the legacy floating point rounding behavior, link with [`legacy_stdio_float_rounding.obj`](../link-options.md). **`vswprintf`** conforms to the ISO C Standard, which requires the second parameter, *`count`*, of type **`size_t`**. To force the old nonstandard behavior, define `_CRT_NON_CONFORMING_SWPRINTFS`. The old behavior may not be in a future version, so code should be changed to use the new conformant behavior. diff --git a/docs/c-runtime-library/required-and-optional-header-files.md b/docs/c-runtime-library/required-and-optional-header-files.md index 679afb54500..13fb797a279 100644 --- a/docs/c-runtime-library/required-and-optional-header-files.md +++ b/docs/c-runtime-library/required-and-optional-header-files.md @@ -2,7 +2,7 @@ title: "Required and Optional Header Files" description: "When to use required versus optional header files from the Microsoft C runtime library." ms.date: "11/04/2016" -ms.topic: "conceptual" +ms.topic: "concept-article" f1_keywords: ["c.headers"] helpviewer_keywords: ["include files, required in run time", "header files, required in run time"] ms.assetid: f64d0bf5-e2c3-4b42-97d0-443b3d901d9f diff --git a/docs/c-runtime-library/routine-mappings.md b/docs/c-runtime-library/routine-mappings.md index 087515c0cde..e36658b7393 100644 --- a/docs/c-runtime-library/routine-mappings.md +++ b/docs/c-runtime-library/routine-mappings.md @@ -1,9 +1,8 @@ --- -description: "Learn more about: Microsoft specific generic-text functions and the CRT functions they map to." title: "Generic-text function mappings" -ms.date: "11/04/2016" +description: "Learn more about: Microsoft specific generic-text functions and the CRT functions they map to." +ms.date: 11/04/2016 ms.author: twhitney -api_name: ["foo",] f1_keywords: ["_cgetts", "_cgetts_s", "_cputts", "_fgettc", "_fgettchar", "_fgetts", "_fputtc", "_fputtchar", "_fputts", "_ftscanf", "_ftscanf_s", "_gettc", "_gettch", "_gettchar", "_gettche", "_getts", "_getts_s", "_istalnum", "_istalpha", "_istascii", "_istcntrl", "_istdigit", "_istgraph", "_istlead", "_istleadbyte", "_istlegal", "_istlower", "_istprint", "_istpunct", "_istspace", "_istupper", "_istxdigit", "_itot", "_itot_s", "_ltot", "_ltot_s", "_puttc", "_puttch", "_puttchar", "_putts", "_sctprintf", "_sntprintf", "_sntprintf_s", "_sntscanf", "_sntscanf_s", "_stprintf", "_stprintf_s", "_stscanf", "_stscanf_s", "_taccess", "_tasctime", "_tasctime_s", "_tccmp", "_tccpy", "_tccpy_s", "_tchdir", "_tclen", "_tchmod", "_tcprintf", "_tcprintf_s", "_tcreat", "_tcscanf", "_tcscanf_s", "_tcscat", "_tcscat_s", "_tcschr", "_tcsclen", "_tcsclen_s", "_tcscmp", "_tcscoll", "_tcscpy", "_tcscpy_s", "_tcscspn", "_tcsdec", "_tcsdup", "_tcserror", "_tcserror_s", "_tcsftime", "_tcsicmp", "_tcsicoll", "_tcsinc", "_tcslen", "_tcslwr", "_tcslwr_s", "_tcsnbcnt", "_tcsncat", "_tcsncat_s", "_tcsnccat", "_tcsnccmp", "_tcsnccmp_s", "_tcsnccoll", "_tcsncmp", "_tcsnccnt", "_tcsnccpy", "_tcsncicmp", "_tcsncicoll", "_tcsncpy", "_tcsncset", "_tcsnextc", "_tcsnicmp", "_tcsnicoll", "_tcsninc", "_tcsnccnt", "_tcsnset", "_tcspbrk", "_tcsspnp", "_tcsrchr", "_tcsrev", "_tcsset", "_tcsspn", "_tcsstr", "_tcstod", "_tcstoi64", "_tcstok", "_tcstok_s", "_tcstol", "_tcstoui64", "_tcstoul", "_tcsupr", "_tcsupr_s", "_tcsxfrm", "_tctime", "_tctime_s", "_tctime32", "_tctime32_s", "_tctime64", "_tctime64_s", "_texecl", "_texecle", "_texeclp", "_texeclpe", "_texecv", "_texecve", "_texecvp", "_texecvpe", "_tfdopen", "_tfindfirst", "_tfindnext", "_tfindnext32", "_tfindnext64", "_tfindnexti64", "_tfindnexti6432", "_tfindnext32i64", "_tfopen", "_tfopen_s", "_tfreopen", "_tfreopen_s", "_tfsopen", "_tfullpath", "_tgetcwd", "_tgetdcwd", "_tgetenv", "_tgetenv_s", "_tmain", "_tmakepath", "_tmakepath_s", "_tmkdir", "_tmktemp", "_tmktemp_s", "_topen", "_topen_s", "_totlower", "_totupper", "_tperror", "_tpopen", "_tprintf", "_tprintf_s", "_tputenv", "_tremove", "_trename", "_trmdir", "_tsearchenv", "_tsearchenv_s", "_tscanf", "_tscanf_s", "_tsetlocale", "_tsopen", "_tsopen_s", "_tspawnl", "_tspawnle", "_tspawnlp", "_tspawnlpe", "_tspawnv", "_tspawnve", "_tspawnvp", "_tspawnvpe", "_tsplitpath", "_tstat", "_tstat32", "_tstati32", "_tstat64", "_tstati64", "_tstof", "_tstoi", "_tstoi64", "_tstol", "_tstrdate", "_tstrdate_s", "_tstrtime", "_tstrtime_s", "_tsystem", "_ttempnam", "_ttmpnam", "_ttmpnam_s", "_ttoi", "_ttoi64", "_ttol", "_tunlink", "_tutime", "_tutime32", "_tutime64", "_tWinMain", "_ui64tot", "_ui64tot_s", "_ultot", "_ultot_s", "_ungettc", "_ungettch", "_vftprintf", "_vftprintf_s", "_vsctprintf", "_vsctprintf_s", "_vsntprintf", "_vsntprintf_s", "_vstprintf", "_vtprintf", "_vtprintf_s"] helpviewer_keywords: ["_tWinMain", "TCHAR.H functions, list of generic-text function mappings", "generic-text mappings", "_cgetts function", "_cgetts_s function", "_cputts function", "_fgettc function", "_fgettchar function", "_fgetts function", "_fputtc function", "_fputtchar function", "_fputts function", "_ftscanf function", "_ftscanf_s function", "_gettc function", "_gettch function", "_gettchar function", "_gettche function", "_getts function", "_getts_s function", "_istalnum function", "_istalpha function", "_istascii function", "_istcntrl function", "_istdigit function", "_istgraph function", "_istlead function", "_istleadbyte function", "_istlegal function", "_istlower function", "_istprint function", "_istpunct function", "_istspace function", "_istupper function", "_istxdigit function", "_itot function", "_itot_s function", "_ltot function", "_ltot_s function", "_puttc function", "_puttch function", "_puttchar function", "_putts function", "_sctprintf function", "_sntprintf function", "_sntprintf_s function", "_sntscanf function", "_sntscanf_s function", "_stprintf function", "_stprintf_s function", "_stscanf function", "_stscanf_s function", "_taccess function", "_tasctime function", "_tasctime_s function", "_tccmp function", "_tccpy function", "_tccpy_s function", "_tchdir function", "_tclen function", "_tchmod function", "_tcprintf function", "_tcprintf_s function", "_tcreat function", "_tcscanf function", "_tcscanf_s function", "_tcscat function", "_tcscat_s function", "_tcschr function", "_tcsclen function", "_tcsclen_s function", "_tcscmp function", "_tcscoll function", "_tcscpy function", "_tcscpy_s function", "_tcscspn function", "_tcsdec function", "_tcsdup function", "_tcserror function", "_tcserror_s function", "_tcsftime function", "_tcsicmp function", "_tcsicoll function", "_tcsinc function", "_tcslen function", "_tcslwr function", "_tcslwr_s function", "_tcsnbcnt function", "_tcsncat function", "_tcsncat_s function", "_tcsnccat function", "_tcsnccmp function", "_tcsnccmp_s function", "_tcsnccoll function", "_tcsncmp function", "_tcsnccnt function", "_tcsnccpy function", "_tcsncicmp function", "_tcsncicoll function", "_tcsncpy function", "_tcsncset function", "_tcsnextc function", "_tcsnicmp function", "_tcsnicoll function", "_tcsninc function", "_tcsnccnt function", "_tcsnset function", "_tcspbrk function", "_tcsspnp function", "_tcsrchr function", "_tcsrev function", "_tcsset function", "_tcsspn function", "_tcsstr function", "_tcstod function", "_tcstoi64 function", "_tcstok function", "_tcstok_s function", "_tcstol function", "_tcstoui64 function", "_tcstoul function", "_tcsupr function", "_tcsupr_s function", "_tcsxfrm function", "_tctime function", "_tctime_s function", "_tctime32 function", "_tctime32_s function", "_tctime64 function", "_tctime64_s function", "_texecl function", "_texecle function", "_texeclp function", "_texeclpe function", "_texecv function", "_texecve function", "_texecvp function", "_texecvpe function", "_tfdopen function", "_tfindfirst function", "_tfindnext function", "_tfindnext32 function", "_tfindnext64 function", "_tfindnexti64 function", "_tfindnexti6432 function", "_tfindnext32i64 function", "_tfopen function", "_tfopen_s function", "_tfreopen function", "_tfreopen_s function", "_tfsopen function", "_tfullpath function", "_tgetcwd function", "_tgetdcwd function", "_tgetenv function", "_tgetenv_s function", "_tmain function", "_tmakepath function", "_tmakepath_s function", "_tmkdir function", "_tmktemp function", "_tmktemp_s function", "_topen function", "_topen_s function", "_totlower function", "_totupper function", "_tperror function", "_tpopen function", "_tprintf function", "_tprintf_s function", "_tputenv function", "_tremove function", "_trename function", "_trmdir function", "_tsearchenv function", "_tsearchenv_s function", "_tscanf function", "_tscanf_s function", "_tsetlocale function", "_tsopen function", "_tsopen_s function", "_tspawnl function", "_tspawnle function", "_tspawnlp function", "_tspawnlpe function", "_tspawnv function", "_tspawnve function", "_tspawnvp function", "_tspawnvpe function", "_tsplitpath function", "_tstat function", "_tstat32 function", "_tstati32 function", "_tstat64 function", "_tstati64 function", "_tstof function", "_tstoi function", "_tstoi64 function", "_tstol function", "_tstrdate function", "_tstrdate_s function", "_tstrtime function", "_tstrtime_s function", "_tsystem function", "_ttempnam function", "_ttmpnam function", "_ttmpnam_s function", "_ttoi function", "_ttoi64 function", "_ttol function", "_tunlink function", "_tutime function", "_tutime32 function", "_tutime64 function", "_tWinMain function", "_ui64tot function", "_ui64tot_s function", "_ultot function", "_ultot_s function", "_ungettc function", "_ungettch function", "_vftprintf function", "_vftprintf_s function", "_vsctprintf function", "_vsctprintf_s function", "_vsntprintf function", "_vsntprintf_s function", "_vstprintf function", "_vtprintf function", "_vtprintf_s function"] --- @@ -127,7 +126,6 @@ For related information, see [Generic-text mappings in tchar.h](../text/generic- | `_tcsnicmp` | `_strnicmp` | `_mbsnbicmp` | `_wcsnicmp` | | `_tcsnicoll` | `_strnicoll` | `_mbsnbicoll` | `_wcsnicoll` | | `_tcsninc` | `_strninc` | `_mbsninc` | `_wcsninc` | -| `_tcsnccnt` | `_strncnt` | `_mbsnccnt` | `_wcsncnt` | | `_tcsnset` | `_strnset` | `_mbsnbset` | `_wcsnset` | | `_tcspbrk` | `strpbrk` | `_mbspbrk` | `wcspbrk` | | `_tcsspnp` | `_strspnp` | `_mbsspnp` | `_wcsspnp` | diff --git a/docs/c-runtime-library/sal-annotations.md b/docs/c-runtime-library/sal-annotations.md index 1307e5f0a24..3b7f7b24999 100644 --- a/docs/c-runtime-library/sal-annotations.md +++ b/docs/c-runtime-library/sal-annotations.md @@ -2,7 +2,7 @@ title: "SAL Annotations" description: "A brief description of the Microsoft source-code annotation language (SAL)." ms.date: "11/04/2016" -ms.topic: "conceptual" +ms.topic: "concept-article" helpviewer_keywords: ["__z annotation", "ref annotation", "_opt annotation", "__checkreturn annotatioin", "__deref_opt annotation", "deref_opt annotation", "__deref annotation", "__in annotation", "annotations [C++]", "z annotation", "_inout annotation", "__ref annotation", "full annotation", "_in annotation", "_ref annotation", "__out annotation", "_ecount annotation", "SAL annotations", "__opt annotation", "inout annotation", "in annotation", "_CA_SHOULD_CHECK_RETURN", "__bcount annotation", "_full annotation", "_bcount annotation", "deref annotation", "part annotation", "_out annotation", "__nz annotation", "__part annotation", "opt annotation", "__full annotation", "_nz annotation", "_z annotation", "out annotation", "__ecount annotation", "__inout annotation", "SAL annotations, _CA_SHOULD_CHECK_RETURN", "_deref_opt annotation", "_deref annotation", "nz annotation", "_part annotation", "ecount annotation", "bcount annotation"] ms.assetid: 81893638-010c-41a0-9cb3-666fe360f3e0 --- diff --git a/docs/c-runtime-library/sbcs-and-mbcs-data-types.md b/docs/c-runtime-library/sbcs-and-mbcs-data-types.md index 71473d9c2b6..c2111a54b41 100644 --- a/docs/c-runtime-library/sbcs-and-mbcs-data-types.md +++ b/docs/c-runtime-library/sbcs-and-mbcs-data-types.md @@ -1,7 +1,7 @@ --- title: "SBCS and MBCS Data Types" description: "How to represent single and multibyte characters in the Microsoft C runtime." -ms.topic: "conceptual" +ms.topic: "how-to" ms.date: "04/11/2018" f1_keywords: ["_MBCS", "MBCS", "SBCS"] helpviewer_keywords: ["SBCS and MBCS data types", "data types [C], MBCS and SBCS"] diff --git a/docs/c-runtime-library/secure-template-overloads.md b/docs/c-runtime-library/secure-template-overloads.md index 865c43c2abf..99f5ab2d923 100644 --- a/docs/c-runtime-library/secure-template-overloads.md +++ b/docs/c-runtime-library/secure-template-overloads.md @@ -2,7 +2,7 @@ title: "Secure Template Overloads" description: "A description of Microsoft C runtime template overloads that provide security-enhanced functions." ms.date: "11/04/2016" -ms.topic: "conceptual" +ms.topic: "concept-article" f1_keywords: ["_CRT_SECURE_CPP_OVERLOAD_STANDARD_NAMES", "_CRT_SECURE_CPP_OVERLOAD_SECURE_NAMES", "_CRT_SECURE_CPP_OVERLOAD_STANDARD_NAMES_COUNT"] helpviewer_keywords: ["_CRT_SECURE_CPP_OVERLOAD_STANDARD_NAMES", "_CRT_SECURE_CPP_OVERLOAD_SECURE_NAMES", "_CRT_SECURE_CPP_OVERLOAD_STANDARD_NAMES_COUNT", "secure template overloads"] ms.assetid: 562741d0-39c0-485e-8529-73d740f29f8f diff --git a/docs/c-runtime-library/security-features-in-the-crt.md b/docs/c-runtime-library/security-features-in-the-crt.md index d1dc77a81a2..624d6d1b9eb 100644 --- a/docs/c-runtime-library/security-features-in-the-crt.md +++ b/docs/c-runtime-library/security-features-in-the-crt.md @@ -2,10 +2,9 @@ title: "Security Features in the CRT" description: "An overview of secure CRT functions in the Microsoft C runtime." ms.date: "09/29/2020" -ms.topic: "conceptual" +ms.topic: "concept-article" f1_keywords: ["_CRT_SECURE_NO_DEPRECATE", "_CRT_NONSTDC_NO_DEPRECATE", "_CRT_NONSTDC_NO_WARNINGS", "_CRT_SECURE_NO_WARNINGS"] helpviewer_keywords: ["security deprecation warnings [C++]", "CRT_NONSTDC_NO_DEPRECATE", "buffers [C++], buffer overruns", "deprecation warnings (security-related), disabling", "_CRT_NONSTDC_NO_WARNINGS", "security [CRT]", "_CRT_SECURE_NO_WARNINGS", "_CRT_NONSTDC_NO_DEPRECATE", "_CRT_SECURE_NO_DEPRECATE", "security-enhanced CRT", "CRT_SECURE_NO_WARNINGS", "CRT_SECURE_NO_DEPRECATE", "deprecation warnings (security-related)", "buffer overruns", "CRT_NONSTDC_NO_WARNINGS", "CRT, security enhancements", "parameters [C++], validation"] -ms.assetid: d9568b08-9514-49cd-b3dc-2454ded195a3 --- # Security Features in the CRT @@ -19,7 +18,7 @@ For example, the `strcpy` function can't tell if the string it copies is too lar ## Eliminating deprecation warnings -There are several ways to eliminate deprecation warnings for the older, less secure functions. The simplest is simply to define `_CRT_SECURE_NO_WARNINGS` or use the [`warning`](../preprocessor/warning.md) pragma. Either will disable deprecation warnings, but the security issues that caused the warnings still exist. It's better to leave deprecation warnings enabled and take advantage of the new CRT security features. +There are several ways to eliminate deprecation warnings for the older, less secure functions. The simplest is simply to define `_CRT_SECURE_NO_WARNINGS` or use the [`warning`](../preprocessor/warning.md) pragma. Either disables deprecation warnings, but the security issues that caused the warnings still exist. It's better to leave deprecation warnings enabled and take advantage of the new CRT security features. In C++, the easiest way to eliminate the deprecation warnings is to use [Secure template overloads](./secure-template-overloads.md). The overloads eliminate deprecation warnings in many cases. They replace calls to deprecated functions with calls to secure versions of the functions. For example, consider this deprecated call to `strcpy`: @@ -54,13 +53,15 @@ Some of the security features include: You must pass the buffer size to any secure function that writes to a buffer. The secure versions validate that the buffer is large enough before writing to it. The validation helps avoid dangerous buffer overrun errors that could allow malicious code to execute. These functions usually return an `errno` error code and invoke the invalid parameter handler if the size of the buffer is too small. Functions that read from input buffers, such as `gets`, have secure versions that require you to specify a maximum size. + The debug versions of *some* security-enhanced CRT functions fill the buffer passed to them with a special character (0xFE). This fill character helps to find cases where the incorrect size was passed to the function. Unfortunately, it also reduces performance. To improve performance, use **`_CrtSetDebugFillThreshold`** to disable buffer-filling. For more information, and a list of functions that have this behavior, see [`_CrtSetDebugFillThreshold`](./reference/crtsetdebugfillthreshold.md). + - **Null termination** - Some functions that left potentially non-terminated strings have secure versions, which ensure that strings are properly null-terminated. + Some functions that left potentially nonterminated strings have secure versions, which ensure that strings are properly null-terminated. - **Enhanced error reporting** - The secure functions return error codes with more error information than was available with the pre-existing functions. The secure functions and many of the pre-existing functions now set `errno` and often return an `errno` code type as well, to provide better error reporting. + The secure functions return error codes with more error information than was available with the preexisting functions. The secure functions and many of the preexisting functions now set `errno` and often return an `errno` code type as well, to provide better error reporting. - **Filesystem security** diff --git a/docs/c-runtime-library/setjmp3.md b/docs/c-runtime-library/setjmp3.md index 05fbacbc026..d406921ec9d 100644 --- a/docs/c-runtime-library/setjmp3.md +++ b/docs/c-runtime-library/setjmp3.md @@ -1,14 +1,13 @@ --- -description: "Learn more about: _setjmp3" title: "_setjmp3" -ms.date: "1/14/2021" +description: "Learn more about: _setjmp3" +ms.date: 1/14/2021 api_name: ["_setjmp3"] api_location: ["msvcrt.dll", "msvcr90.dll", "msvcr110.dll", "msvcr80.dll", "msvcr110_clr0400.dll", "msvcr100.dll", "msvcr120.dll"] api_type: ["DLLExport"] topic_type: ["apiref"] f1_keywords: ["setjmp3", "_setjmp3"] helpviewer_keywords: ["_setjmp3 function", "setjmp3 function"] -ms.assetid: 6129c2f3-8bac-4fdb-a827-44e1eebba500 --- # `_setjmp3` @@ -43,8 +42,6 @@ Always returns 0. Don't use this function in a C++ program. It's an intrinsic function that doesn't support C++. For more information about how to use `setjmp`, see [Using setjmp/longjmp](../cpp/using-setjmp-longjmp.md). -## Requirements - ## See also [Alphabetical function reference](./reference/crt-alphabetical-function-reference.md)\ diff --git a/docs/c-runtime-library/setusermatherr.md b/docs/c-runtime-library/setusermatherr.md index 16a9bc0757f..b63946d98ec 100644 --- a/docs/c-runtime-library/setusermatherr.md +++ b/docs/c-runtime-library/setusermatherr.md @@ -1,14 +1,13 @@ --- -description: "Learn more about: __setusermatherr" title: "__setusermatherr" -ms.date: "11/04/2016" +description: "Learn more about: __setusermatherr" +ms.date: 11/04/2016 api_name: ["__setusermatherr"] api_location: ["msvcr80.dll", "msvcr90.dll", "msvcrt.dll", "msvcr110.dll", "msvcr110_clr0400.dll", "msvcr120.dll", "msvcr100.dll", "api-ms-win-crt-math-l1-1-0.dll"] api_type: ["DLLExport"] topic_type: ["apiref"] f1_keywords: ["__setusermatherr"] helpviewer_keywords: ["__setusermatherr"] -ms.assetid: f306818d-381a-4d68-8739-71b92bacb5ea --- # `__setusermatherr` @@ -29,8 +28,6 @@ Pointer to an implementation of `_matherr` that is supplied by the user. The type of the *`pf`* parameter is declared as `typedef int (__cdecl * _HANDLE_MATH_ERROR)(struct _exception *)`. -## Remarks - ## Requirements | Routine | Required header | diff --git a/docs/c-runtime-library/single-byte-and-multibyte-character-sets.md b/docs/c-runtime-library/single-byte-and-multibyte-character-sets.md index 7828ab3cc97..cbebeccee27 100644 --- a/docs/c-runtime-library/single-byte-and-multibyte-character-sets.md +++ b/docs/c-runtime-library/single-byte-and-multibyte-character-sets.md @@ -1,14 +1,13 @@ --- title: "Single-Byte and Multibyte Character Sets" description: "An introduction to single and multi-byte character sets in the Microsoft runtime library." -ms.topic: "conceptual" -ms.date: "11/04/2016" +ms.date: 11/04/2016 +ms.topic: "concept-article" helpviewer_keywords: ["SBCS (single byte character set)", "MBCS [C++], about MBCS", "character sets [C++], multibyte", "character sets [C++], single byte"] -ms.assetid: 2cbc78ea-33c0-4cfb-b0df-7ce2458431ce --- # Single-byte and multibyte character sets -The ASCII character set defines characters in the range 0x00 - 0x7F. There are many other character sets, primarily European, that define the characters within the range 0x00 - 0x7F identically to the ASCII character set and also define an extended character set from 0x80 - 0xFF. An 8-bit, single-byte-character set (SBCS) is sufficient to represent the ASCII character set and the character sets for many European languages. However, some non-European character sets, such as Japanese Kanji, include many more characters than can be represented in a single-byte coding scheme, and so require multibyte-character set (MBCS) encoding. +The ASCII character set defines characters in the range 0x00 - 0x7F. There are other character sets, primarily European, that define the characters within the range 0x00 - 0x7F identically to the ASCII character set and also define an extended character set from 0x80 - 0xFF. Thus, an 8-bit, single-byte-character set (SBCS) is sufficient to represent the ASCII character set and the character sets for many European languages. However, some non-European character sets, such as Japanese Kanji, include many more characters than a single-byte coding scheme can represent, and therefore require multibyte-character set (MBCS) encoding. > [!NOTE] > Many Microsoft run-time library SBCS routines handle multibyte bytes, characters, and strings as appropriate. Many multibyte-character sets define the ASCII character set as a subset. In many multibyte character sets, each character in the range 0x00 - 0x7F is identical to the character that has the same value in the ASCII character set. For example, in both ASCII and MBCS character strings, the one-byte null character ('\0') has value 0x00 and indicates the terminating null character. diff --git a/docs/c-runtime-library/stream-i-o.md b/docs/c-runtime-library/stream-i-o.md index 180ecf2b1f3..e91fcfdda2e 100644 --- a/docs/c-runtime-library/stream-i-o.md +++ b/docs/c-runtime-library/stream-i-o.md @@ -1,9 +1,8 @@ --- -description: "Learn more about: Stream I/O" title: "Stream I/O" -ms.date: "11/04/2016" +description: "Learn more about: Stream I/O" +ms.date: 11/04/2016 helpviewer_keywords: ["I/O routines, stream I/O", "I/O [CRT], stream", "stream I/O"] -ms.assetid: dc7874d3-a91b-456a-9015-4748bb358217 --- # Stream I/O @@ -13,61 +12,61 @@ These functions process data in different sizes and formats, from single charact | Routine | Use | |---|---| -| [`clearerr`](./reference/clearerr.md), [`clearerr_s`](./reference/clearerr-s.md) | Clear error indicator for stream | -| [`fclose`](./reference/fclose-fcloseall.md) | Close stream | -| [`_fcloseall`](./reference/fclose-fcloseall.md) | Close all open streams except **`stdin`**, **`stdout`**, and **`stderr`** | -| [`_fdopen`, `wfdopen`](./reference/fdopen-wfdopen.md) | Associate stream with file descriptor of open file | -| [`feof`](./reference/feof.md) | Test for end of file on stream | -| [`ferror`](./reference/ferror.md) | Test for error on stream | -| [`fflush`](./reference/fflush.md) | Flush stream to buffer or storage device | -| [`fgetc`, `fgetwc`](./reference/fgetc-fgetwc.md) | Read character from stream (function versions of **`getc`** and **`getwc`**) | -| [`_fgetchar`, `_fgetwchar`](./reference/fgetc-fgetwc.md) | Read character from **`stdin`** (function versions of **`getchar`** and **`getwchar`**) | -| [`fgetpos`](./reference/fgetpos.md) | Get position indicator of stream | -| [`fgets`, `fgetws`](./reference/fgets-fgetws.md) | Read string from stream | -| [`_fileno`](./reference/fileno.md) | Get file descriptor associated with stream | -| [`_flushall`](./reference/flushall.md) | Flush all streams to buffer or storage device | -| [`fopen`, `_wfopen`](./reference/fopen-wfopen.md), [`fopen_s`, `_wfopen_s`](./reference/fopen-s-wfopen-s.md) | Open stream | -| [`fprintf`, `_fprintf_l`, `fwprintf`, `_fwprintf_l`](./reference/fprintf-fprintf-l-fwprintf-fwprintf-l.md), [`fprintf_s`, `_fprintf_s_l`, `fwprintf_s`, `_fwprintf_s_l`](./reference/fprintf-s-fprintf-s-l-fwprintf-s-fwprintf-s-l.md) | Write formatted data to stream | -| [`fputc`, `fputwc`](./reference/fputc-fputwc.md) | Write a character to a stream (function versions of **`putc`** and **`putwc`**) | -| [`_fputchar`, `_fputwchar`](./reference/fputc-fputwc.md) | Write character to **`stdout`** (function versions of **`putchar`** and **`putwchar`**) | -| [`fputs`, `fputws`](./reference/fputs-fputws.md) | Write string to stream | -| [`fread`](./reference/fread.md) | Read unformatted data from stream | -| [`freopen`, `_wfreopen`](./reference/freopen-wfreopen.md), [`freopen_s`, `_wfreopen_s`](./reference/freopen-s-wfreopen-s.md) | Reassign `FILE` stream pointer to new file or device | -| [`fscanf`, `fwscanf`](./reference/fscanf-fscanf-l-fwscanf-fwscanf-l.md), [`fscanf_s`, `_fscanf_s_l`, `fwscanf_s`, `_fwscanf_s_l`](./reference/fscanf-s-fscanf-s-l-fwscanf-s-fwscanf-s-l.md) | Read formatted data from stream | -| [`fseek`, `_fseeki64`](./reference/fseek-fseeki64.md) | Move file position to given location | -| [`fsetpos`](./reference/fsetpos.md) | Set position indicator of stream | -| [`_fsopen`, `_wfsopen`](./reference/fsopen-wfsopen.md) | Open stream with file sharing | -| [`ftell`, `_ftelli64`](./reference/ftell-ftelli64.md) | Get current file position | -| [`fwrite`](./reference/fwrite.md) | Write unformatted data items to stream | -| [`getc`, `getwc`](./reference/getc-getwc.md) | Read character from stream (macro versions of **`fgetc`** and **`fgetwc`**) | -| [`getchar`, `getwchar`](./reference/getc-getwc.md) | Read character from **`stdin`** (macro versions of **`fgetchar`** and **`fgetwchar`**) | -| [`_getmaxstdio`](./reference/getmaxstdio.md) | Returns the number of simultaneously open files permitted at the stream I/O level. | -| [`gets_s`, `_getws_s`](./reference/gets-s-getws-s.md) | Read line from **`stdin`** | -| [`_getw`](./reference/getw.md) | Read binary **`int`** from stream | -| [`printf`, `_printf_l`, `wprintf`, `_wprintf_l`](./reference/printf-printf-l-wprintf-wprintf-l.md),[`printf_s`, `_printf_s_l`, `wprintf_s`, `_wprintf_s_l`](./reference/printf-s-printf-s-l-wprintf-s-wprintf-s-l.md) | Write formatted data to **`stdout`** | -| [`putc`, `putwc`](./reference/putc-putwc.md) | Write character to a stream (macro versions of **`fputc`** and **`fputwc`**) | -| [`putchar`, `putwchar`](./reference/putc-putwc.md) | Write character to **`stdout`** (macro versions of **`fputchar`** and **`fputwchar`**) | -| [`puts`, `_putws`](./reference/puts-putws.md) | Write line to stream | -| [`_putw`](./reference/putw.md) | Write binary **`int`** to stream | -| [`rewind`](./reference/rewind.md) | Move file position to beginning of stream | -| [`_rmtmp`](./reference/rmtmp.md) | Remove temporary files created by **`tmpfile`** | -| [`scanf`, `_scanf_l`, `wscanf`, `_wscanf_l`](./reference/scanf-scanf-l-wscanf-wscanf-l.md),[`scanf_s`, `_scanf_s_l`, `wscanf_s`, `_wscanf_s_l`](./reference/scanf-s-scanf-s-l-wscanf-s-wscanf-s-l.md) | Read formatted data from **`stdin`** | -| [`setbuf`](./reference/setbuf.md) | Control stream buffering | -| [`_setmaxstdio`](./reference/setmaxstdio.md) | Set a maximum for the number of simultaneously open files at the stream I/O level. | -| [`setvbuf`](./reference/setvbuf.md) | Control stream buffering and buffer size | -| [`_snprintf`, `_snwprintf`](./reference/snprintf-snprintf-snprintf-l-snwprintf-snwprintf-l.md), [`_snprintf_s`, `_snprintf_s_l`, `_snwprintf_s`, `_snwprintf_s_l`](./reference/snprintf-s-snprintf-s-l-snwprintf-s-snwprintf-s-l.md) | Write formatted data of specified length to string | -| [`_snscanf`, `_snwscanf`](./reference/snscanf-snscanf-l-snwscanf-snwscanf-l.md), [`_snscanf_s`, `_snscanf_s_l`, `_snwscanf_s`, `_snwscanf_s_l`](./reference/snscanf-s-snscanf-s-l-snwscanf-s-snwscanf-s-l.md) | Read formatted data of a specified length from the standard input stream. | -| [`sprintf`, `swprintf`](./reference/sprintf-sprintf-l-swprintf-swprintf-l-swprintf-l.md), [`sprintf_s`, `_sprintf_s_l`, `swprintf_s`, `_swprintf_s_l`](./reference/sprintf-s-sprintf-s-l-swprintf-s-swprintf-s-l.md) | Write formatted data to string | -| [`sscanf`, `swscanf`](./reference/sscanf-sscanf-l-swscanf-swscanf-l.md), [`sscanf_s`, _sscanf_s_l, `swscanf_s`, `_swscanf_s_l`](./reference/sscanf-s-sscanf-s-l-swscanf-s-swscanf-s-l.md) | Read formatted data from string | -| [`_tempnam`, `_wtempnam`](./reference/tempnam-wtempnam-tmpnam-wtmpnam.md) | Generate temporary filename in given directory | -| [`tmpfile`](./reference/tmpfile.md), [`tmpfile_s`](./reference/tmpfile-s.md) | Create temporary file | -| [`tmpnam`, `_wtmpnam`](./reference/tempnam-wtempnam-tmpnam-wtmpnam.md), [`tmpnam_s`, `_wtmpnam_s`](./reference/tmpnam-s-wtmpnam-s.md) | Generate temporary filename | -| [`ungetc`, `ungetwc`](./reference/ungetc-ungetwc.md) | Push character back onto stream | -| [`_vcprintf`, `_vcwprintf`](./reference/vcprintf-vcprintf-l-vcwprintf-vcwprintf-l.md), [`_vcprintf_s`, `_vcprintf_s_l`, `_vcwprintf_s`, `_vcwprintf_s_l`](./reference/vcprintf-s-vcprintf-s-l-vcwprintf-s-vcwprintf-s-l.md) | Write formatted data to the console. | -| [`vfprintf`, `vfwprintf`](./reference/vfprintf-vfprintf-l-vfwprintf-vfwprintf-l.md), [`vfprintf_s`, `_vfprintf_s_l`, `vfwprintf_s`, `_vfwprintf_s_l`](./reference/vfprintf-s-vfprintf-s-l-vfwprintf-s-vfwprintf-s-l.md) | Write formatted data to stream | -| [`vprintf`, `vwprintf`](./reference/vprintf-vprintf-l-vwprintf-vwprintf-l.md), [`vprintf_s`, `_vprintf_s_l`, `vwprintf_s`, `_vwprintf_s_l`](./reference/vprintf-s-vprintf-s-l-vwprintf-s-vwprintf-s-l.md) | Write formatted data to **`stdout`** | -| [`_vsnprintf`, `_vsnwprintf`](./reference/vsnprintf-vsnprintf-vsnprintf-l-vsnwprintf-vsnwprintf-l.md), [`vsnprintf_s`, `_vsnprintf_s`, `_vsnprintf_s_l`, `_vsnwprintf_s`, `_vsnwprintf_s_l`](./reference/vsnprintf-s-vsnprintf-s-vsnprintf-s-l-vsnwprintf-s-vsnwprintf-s-l.md) | Write formatted data of specified length to buffer | -| [`vsprintf`, `vswprintf`](./reference/vsprintf-vsprintf-l-vswprintf-vswprintf-l-vswprintf-l.md), [`vsprintf_s`, `_vsprintf_s_l`, `vswprintf_s`, `_vswprintf_s_l`](./reference/vsprintf-s-vsprintf-s-l-vswprintf-s-vswprintf-s-l.md) | Write formatted data to buffer | +| [`clearerr`](reference/clearerr.md), [`clearerr_s`](reference/clearerr-s.md) | Clear error indicator for stream | +| [`fclose`](reference/fclose-fcloseall.md) | Close stream | +| [`_fcloseall`](reference/fclose-fcloseall.md) | Close all open streams except **`stdin`**, **`stdout`**, and **`stderr`** | +| [`_fdopen`, `wfdopen`](reference/fdopen-wfdopen.md) | Associate stream with file descriptor of open file | +| [`feof`](reference/feof.md) | Test for end of file on stream | +| [`ferror`](reference/ferror.md) | Test for error on stream | +| [`fflush`](reference/fflush.md) | Flush stream to buffer or storage device | +| [`fgetc`, `fgetwc`](reference/fgetc-fgetwc.md) | Read character from stream (function versions of **`getc`** and **`getwc`**) | +| [`_fgetchar`, `_fgetwchar`](reference/fgetc-fgetwc.md) | Read character from **`stdin`** (function versions of **`getchar`** and **`getwchar`**) | +| [`fgetpos`](reference/fgetpos.md) | Get position indicator of stream | +| [`fgets`, `fgetws`](reference/fgets-fgetws.md) | Read string from stream | +| [`_fileno`](reference/fileno.md) | Get file descriptor associated with stream | +| [`_flushall`](reference/flushall.md) | Flush all streams to buffer or storage device | +| [`fopen`, `_wfopen`](reference/fopen-wfopen.md), [`fopen_s`, `_wfopen_s`](reference/fopen-s-wfopen-s.md) | Open stream | +| [`fprintf`, `_fprintf_l`, `fwprintf`, `_fwprintf_l`](reference/fprintf-fprintf-l-fwprintf-fwprintf-l.md), [`fprintf_s`, `_fprintf_s_l`, `fwprintf_s`, `_fwprintf_s_l`](reference/fprintf-s-fprintf-s-l-fwprintf-s-fwprintf-s-l.md) | Write formatted data to stream | +| [`fputc`, `fputwc`](reference/fputc-fputwc.md) | Write a character to a stream (function versions of **`putc`** and **`putwc`**) | +| [`_fputchar`, `_fputwchar`](reference/fputc-fputwc.md) | Write character to **`stdout`** (function versions of **`putchar`** and **`putwchar`**) | +| [`fputs`, `fputws`](reference/fputs-fputws.md) | Write string to stream | +| [`fread`](reference/fread.md) | Read unformatted data from stream | +| [`freopen`, `_wfreopen`](reference/freopen-wfreopen.md), [`freopen_s`, `_wfreopen_s`](reference/freopen-s-wfreopen-s.md) | Reassign `FILE` stream pointer to new file or device | +| [`fscanf`, `fwscanf`](reference/fscanf-fscanf-l-fwscanf-fwscanf-l.md), [`fscanf_s`, `_fscanf_s_l`, `fwscanf_s`, `_fwscanf_s_l`](reference/fscanf-s-fscanf-s-l-fwscanf-s-fwscanf-s-l.md) | Read formatted data from stream | +| [`fseek`, `_fseeki64`](reference/fseek-fseeki64.md) | Move file position to given location | +| [`fsetpos`](reference/fsetpos.md) | Set position indicator of stream | +| [`_fsopen`, `_wfsopen`](reference/fsopen-wfsopen.md) | Open stream with file sharing | +| [`ftell`, `_ftelli64`](reference/ftell-ftelli64.md) | Get current file position | +| [`fwrite`](reference/fwrite.md) | Write unformatted data items to stream | +| [`getc`, `getwc`](reference/getc-getwc.md) | Read character from stream (macro versions of **`fgetc`** and **`fgetwc`**) | +| [`getchar`, `getwchar`](reference/getc-getwc.md) | Read character from **`stdin`** (macro versions of **`fgetchar`** and **`fgetwchar`**) | +| [`_getmaxstdio`](reference/getmaxstdio.md) | Returns the number of simultaneously open files permitted at the stream I/O level. | +| [`gets_s`, `_getws_s`](reference/gets-s-getws-s.md) | Read line from **`stdin`** | +| [`_getw`](reference/getw.md) | Read binary **`int`** from stream | +| [`printf`, `_printf_l`, `wprintf`, `_wprintf_l`](reference/printf-printf-l-wprintf-wprintf-l.md), [`printf_s`, `_printf_s_l`, `wprintf_s`, `_wprintf_s_l`](reference/printf-s-printf-s-l-wprintf-s-wprintf-s-l.md) | Write formatted data to **`stdout`** | +| [`putc`, `putwc`](reference/putc-putwc.md) | Write character to a stream (macro versions of **`fputc`** and **`fputwc`**) | +| [`putchar`, `putwchar`](reference/putc-putwc.md) | Write character to **`stdout`** (macro versions of **`fputchar`** and **`fputwchar`**) | +| [`puts`, `_putws`](reference/puts-putws.md) | Write line to stream | +| [`_putw`](reference/putw.md) | Write binary **`int`** to stream | +| [`rewind`](reference/rewind.md) | Move file position to beginning of stream | +| [`_rmtmp`](reference/rmtmp.md) | Remove temporary files created by **`tmpfile`** | +| [`scanf`, `_scanf_l`, `wscanf`, `_wscanf_l`](reference/scanf-scanf-l-wscanf-wscanf-l.md), [`scanf_s`, `_scanf_s_l`, `wscanf_s`, `_wscanf_s_l`](reference/scanf-s-scanf-s-l-wscanf-s-wscanf-s-l.md) | Read formatted data from **`stdin`** | +| [`setbuf`](reference/setbuf.md) | Control stream buffering | +| [`_setmaxstdio`](reference/setmaxstdio.md) | Set a maximum for the number of simultaneously open files at the stream I/O level. | +| [`setvbuf`](reference/setvbuf.md) | Control stream buffering and buffer size | +| [`_snprintf`, `_snwprintf`](reference/snprintf-snprintf-snprintf-l-snwprintf-snwprintf-l.md), [`_snprintf_s`, `_snprintf_s_l`, `_snwprintf_s`, `_snwprintf_s_l`](reference/snprintf-s-snprintf-s-l-snwprintf-s-snwprintf-s-l.md) | Write formatted data of specified length to string | +| [`_snscanf`, `_snwscanf`](reference/snscanf-snscanf-l-snwscanf-snwscanf-l.md), [`_snscanf_s`, `_snscanf_s_l`, `_snwscanf_s`, `_snwscanf_s_l`](reference/snscanf-s-snscanf-s-l-snwscanf-s-snwscanf-s-l.md) | Read formatted data of a specified length from the standard input stream. | +| [`sprintf`, `swprintf`](reference/sprintf-sprintf-l-swprintf-swprintf-l-swprintf-l.md), [`sprintf_s`, `_sprintf_s_l`, `swprintf_s`, `_swprintf_s_l`](reference/sprintf-s-sprintf-s-l-swprintf-s-swprintf-s-l.md) | Write formatted data to string | +| [`sscanf`, `swscanf`](reference/sscanf-sscanf-l-swscanf-swscanf-l.md), [`sscanf_s`, _sscanf_s_l, `swscanf_s`, `_swscanf_s_l`](reference/sscanf-s-sscanf-s-l-swscanf-s-swscanf-s-l.md) | Read formatted data from string | +| [`_tempnam`, `_wtempnam`](reference/tempnam-wtempnam-tmpnam-wtmpnam.md) | Generate temporary filename in given directory | +| [`tmpfile`](reference/tmpfile.md), [`tmpfile_s`](reference/tmpfile-s.md) | Create temporary file | +| [`tmpnam`, `_wtmpnam`](reference/tempnam-wtempnam-tmpnam-wtmpnam.md), [`tmpnam_s`, `_wtmpnam_s`](reference/tmpnam-s-wtmpnam-s.md) | Generate temporary filename | +| [`ungetc`, `ungetwc`](reference/ungetc-ungetwc.md) | Push character back onto stream | +| [`_vcprintf`, `_vcwprintf`](reference/vcprintf-vcprintf-l-vcwprintf-vcwprintf-l.md), [`_vcprintf_s`, `_vcprintf_s_l`, `_vcwprintf_s`, `_vcwprintf_s_l`](reference/vcprintf-s-vcprintf-s-l-vcwprintf-s-vcwprintf-s-l.md) | Write formatted data to the console. | +| [`vfprintf`, `vfwprintf`](reference/vfprintf-vfprintf-l-vfwprintf-vfwprintf-l.md), [`vfprintf_s`, `_vfprintf_s_l`, `vfwprintf_s`, `_vfwprintf_s_l`](reference/vfprintf-s-vfprintf-s-l-vfwprintf-s-vfwprintf-s-l.md) | Write formatted data to stream | +| [`vprintf`, `vwprintf`](reference/vprintf-vprintf-l-vwprintf-vwprintf-l.md), [`vprintf_s`, `_vprintf_s_l`, `vwprintf_s`, `_vwprintf_s_l`](reference/vprintf-s-vprintf-s-l-vwprintf-s-vwprintf-s-l.md) | Write formatted data to **`stdout`** | +| [`_vsnprintf`, `_vsnwprintf`](reference/vsnprintf-vsnprintf-vsnprintf-l-vsnwprintf-vsnwprintf-l.md), [`vsnprintf_s`, `_vsnprintf_s`, `_vsnprintf_s_l`, `_vsnwprintf_s`, `_vsnwprintf_s_l`](reference/vsnprintf-s-vsnprintf-s-vsnprintf-s-l-vsnwprintf-s-vsnwprintf-s-l.md) | Write formatted data of specified length to buffer | +| [`vsprintf`, `vswprintf`](reference/vsprintf-vsprintf-l-vswprintf-vswprintf-l-vswprintf-l.md), [`vsprintf_s`, `_vsprintf_s_l`, `vswprintf_s`, `_vswprintf_s_l`](reference/vsprintf-s-vsprintf-s-l-vswprintf-s-vswprintf-s-l.md) | Write formatted data to buffer | When a program begins execution, the startup code automatically opens several streams: standard input (pointed to by **`stdin`**), standard output (pointed to by **`stdout`**), and standard error (pointed to by **`stderr`**). These streams are directed to the console (keyboard and screen) by default. Use **`freopen`** to redirect **`stdin`**, **`stdout`**, or **`stderr`** to a disk file or a device. @@ -76,16 +75,15 @@ Files opened using the stream routines are buffered by default. The **`stdout`** There are two ways to commit buffer contents to disk: - Link with the file COMMODE.OBJ to set a global commit flag. The default setting of the global flag is **`n`**, for "no-commit." - - Set the mode flag to **`c`** with **`fopen`** or **`_fdopen`**. Any file specifically opened with either the **`c`** or the **`n`** flag behaves according to the flag, regardless of the state of the global commit/no-commit flag. -If your program doesn't explicitly close a stream, the stream is automatically closed when the program terminates. However, you should close a stream when your program finishes with it, as the number of streams that can be open at one time is limited. See [`_setmaxstdio`](./reference/setmaxstdio.md) for information on this limit. +If your program doesn't explicitly close a stream, the stream is automatically closed when the program terminates. However, you should close a stream when your program finishes with it, as the number of streams that can be open at one time is limited. See [`_setmaxstdio`](reference/setmaxstdio.md) for information on this limit. Input can follow output directly only with an intervening call to **`fflush`** or to a file-positioning function (**`fseek`**, **`fsetpos`**, or **`rewind`**). Input can be followed by output without an intervening call to a file-positioning function, if the input operation encounters the end of the file. ## See also -[Input and output](./input-and-output.md)\ -[Universal C runtime routines by category](./run-time-routines-by-category.md) +[Input and output](input-and-output.md)\ +[Universal C runtime routines by category](run-time-routines-by-category.md) diff --git a/docs/c-runtime-library/text-and-binary-streams.md b/docs/c-runtime-library/text-and-binary-streams.md index 5150344ec6a..6faf1178a3e 100644 --- a/docs/c-runtime-library/text-and-binary-streams.md +++ b/docs/c-runtime-library/text-and-binary-streams.md @@ -2,7 +2,7 @@ title: "Text and Binary Streams" description: "A description of text and binary streams in the Microsoft C runtime library." ms.date: "11/04/2016" -ms.topic: "conceptual" +ms.topic: "concept-article" helpviewer_keywords: ["binary streams", "text streams"] ms.assetid: 57035e4a-955d-4e04-a560-fcf67ce68b4e --- diff --git a/docs/c-runtime-library/tgmath.md b/docs/c-runtime-library/tgmath.md index dff2a61f166..62e68f26eda 100644 --- a/docs/c-runtime-library/tgmath.md +++ b/docs/c-runtime-library/tgmath.md @@ -1,8 +1,8 @@ --- title: "Type-generic math" -description: "Describes macros in that make it easier to write C code that calls the correct math function, based on argument type." -ms.topic: "conceptual" -ms.date: "6/28/2021" +description: "Describes macros in that make it easier to write C code that calls the correct math function, based on argument type." +ms.date: 6/28/2021 +ms.topic: "concept-article" helpviewer_keywords: ["CRT tgmath.h"] --- diff --git a/docs/c-runtime-library/time-management.md b/docs/c-runtime-library/time-management.md index 784c4b009ac..619798b3cce 100644 --- a/docs/c-runtime-library/time-management.md +++ b/docs/c-runtime-library/time-management.md @@ -1,42 +1,42 @@ --- -description: "Learn more about: Time Management" title: "Time Management" -ms.date: "11/04/2016" +description: "Learn more about: Time Management" +ms.date: 11/04/2016 helpviewer_keywords: ["dates, run-time library members", "time, time management", "date functions", "time functions"] --- # Time management Use these functions to get the current time and convert, adjust, and store it as necessary. The current time is the system time. -The **`_ftime`** and **`localtime`** routines use the **`TZ`** environment variable. If **`TZ`** isn't set, the run-time library attempts to use the time-zone information specified by the operating system. If this information is unavailable, these functions use the default value of PST8PDT. For more information on **`TZ`**, see [`_tzset`](./reference/tzset.md); also see [`_daylight`, `timezone`, and `_tzname`](./daylight-dstbias-timezone-and-tzname.md). +The **`_ftime`** and **`localtime`** routines use the **`TZ`** environment variable. If **`TZ`** isn't set, the run-time library attempts to use the time-zone information specified by the operating system. If this information is unavailable, these functions use the default value of PST8PDT. For more information on **`TZ`**, see [`_tzset`](reference/tzset.md); also see [`_daylight`, `timezone`, and `_tzname`](daylight-dstbias-timezone-and-tzname.md). ### Time routines | Function | Use | |---|---| -| [`asctime`, `_wasctime`](./reference/asctime-wasctime.md), [`asctime_s`, `_wasctime_s`](./reference/asctime-s-wasctime-s.md) | Convert time from type **`struct tm`** to character string. The versions of these functions with the **`_s`** suffix are more secure. | -| [`clock`](./reference/clock.md) | Return elapsed wall-clock time for process. | -| [`ctime`, `_ctime32`, `_ctime64`, `_wctime`, `_wctime32`, `_wctime64`](./reference/ctime-ctime32-ctime64-wctime-wctime32-wctime64.md), [`_ctime_s`, `_ctime32_s`, `_ctime64_s`, `_wctime_s`, `_wctime32_s`, `_wctime64_s`](./reference/ctime-s-ctime32-s-ctime64-s-wctime-s-wctime32-s-wctime64-s.md) | Convert time from type **`time_t`**, **`__time32_t`** or **`__time64_t`** to character string. The versions of these functions with the **`_s`** suffix are more secure. | -| [`difftime`, `_difftime32`, `_difftime64`](./reference/difftime-difftime32-difftime64.md) | Compute difference between two times. | -| [`_ftime`, `_ftime32`, `_ftime64`](./reference/ftime-ftime32-ftime64.md),[`_ftime_s`, `_ftime32_s`, _ftime64_s](./reference/ftime-s-ftime32-s-ftime64-s.md) | Store current system time in variable of type **`struct _timeb`** or type **`struct __timeb64`** The versions of these functions with the **`_s`** suffix are more secure. | -| [`_futime`, `_futime32`, `_futime64`](./reference/futime-futime32-futime64.md) | Set modification time on open file | -| [`gmtime`, `_gmtime32`, `_gmtime64`](./reference/gmtime-gmtime32-gmtime64.md), [`gmtime_s`, `_gmtime32_s`, `_gmtime64_s`](./reference/gmtime-s-gmtime32-s-gmtime64-s.md) | Convert time from type **`time_t`** to **`struct tm`** or from type **`__time64_t`** to **`struct tm`**. The versions of these functions with the **`_s`** suffix are more secure. | -| [`localtime`, `_localtime32`, `_localtime64`](./reference/localtime-localtime32-localtime64.md), [`localtime_s`, `_localtime32_s`, `_localtime64_s`](./reference/localtime-s-localtime32-s-localtime64-s.md) | Convert time from type **`time_t`** to **`struct tm`** or from type **`__time64_t`** to **`struct tm`** with local correction. The versions of these functions with the **`_s`** suffix are more secure. | -| [`_mkgmtime`, `_mkgmtime32`, `_mkgmtime64`](./reference/mkgmtime-mkgmtime32-mkgmtime64.md) | Convert time to calendar value in Greenwich Mean Time. | -| [`mktime`, `_mktime32`, `_mktime64`](./reference/mktime-mktime32-mktime64.md) | Convert time to calendar value. | -| [`_strdate`, `_wstrdate`](./reference/strdate-wstrdate.md), [`_strdate_s`, `_wstrdate_s`](./reference/strdate-s-wstrdate-s.md) | Return current system date as string. The versions of these functions with the **`_s`** suffix are more secure. | -| [`strftime`, `wcsftime`, `_strftime_l`, `_wcsftime_l`](./reference/strftime-wcsftime-strftime-l-wcsftime-l.md) | Format date-and-time string for international use. | -| [`_strtime`, `_wstrtime`](./reference/strtime-wstrtime.md), [`_strtime_s`, `_wstrtime_s`](./reference/strtime-s-wstrtime-s.md) | Return current system time as string. The versions of these functions with the **`_s`** suffix are more secure. | -| [`time`, `_time32`, `_time64`](./reference/time-time32-time64.md) | Get current system time as type **`time_t`**, **`__time32_t`** or as type **`__time64_t`**. | -| [`_tzset`](./reference/tzset.md) | Set external time variables from environment time variable **`TZ`**. | -| [`_utime`, `_utime32`, `_utime64`, `_wutime`, `_wutime32`, `_wutime64`](./reference/utime-utime32-utime64-wutime-wutime32-wutime64.md) | Set modification time for specified file using either current time or time value stored in structure. | +| [`asctime`, `_wasctime`](reference/asctime-wasctime.md), [`asctime_s`, `_wasctime_s`](reference/asctime-s-wasctime-s.md) | Convert time from type **`struct tm`** to character string. The versions of these functions with the **`_s`** suffix are more secure. | +| [`clock`](reference/clock.md) | Return elapsed wall-clock time for process. | +| [`ctime`, `_ctime32`, `_ctime64`, `_wctime`, `_wctime32`, `_wctime64`](reference/ctime-ctime32-ctime64-wctime-wctime32-wctime64.md), [`_ctime_s`, `_ctime32_s`, `_ctime64_s`, `_wctime_s`, `_wctime32_s`, `_wctime64_s`](reference/ctime-s-ctime32-s-ctime64-s-wctime-s-wctime32-s-wctime64-s.md) | Convert time from type **`time_t`**, **`__time32_t`** or **`__time64_t`** to character string. The versions of these functions with the **`_s`** suffix are more secure. | +| [`difftime`, `_difftime32`, `_difftime64`](reference/difftime-difftime32-difftime64.md) | Compute difference between two times. | +| [`_ftime`, `_ftime32`, `_ftime64`](reference/ftime-ftime32-ftime64.md), [`_ftime_s`, `_ftime32_s`, _ftime64_s](reference/ftime-s-ftime32-s-ftime64-s.md) | Store current system time in variable of type **`struct _timeb`** or type **`struct __timeb64`** The versions of these functions with the **`_s`** suffix are more secure. | +| [`_futime`, `_futime32`, `_futime64`](reference/futime-futime32-futime64.md) | Set modification time on open file | +| [`gmtime`, `_gmtime32`, `_gmtime64`](reference/gmtime-gmtime32-gmtime64.md), [`gmtime_s`, `_gmtime32_s`, `_gmtime64_s`](reference/gmtime-s-gmtime32-s-gmtime64-s.md) | Convert time from type **`time_t`** to **`struct tm`** or from type **`__time64_t`** to **`struct tm`**. The versions of these functions with the **`_s`** suffix are more secure. | +| [`localtime`, `_localtime32`, `_localtime64`](reference/localtime-localtime32-localtime64.md), [`localtime_s`, `_localtime32_s`, `_localtime64_s`](reference/localtime-s-localtime32-s-localtime64-s.md) | Convert time from type **`time_t`** to **`struct tm`** or from type **`__time64_t`** to **`struct tm`** with local correction. The versions of these functions with the **`_s`** suffix are more secure. | +| [`_mkgmtime`, `_mkgmtime32`, `_mkgmtime64`](reference/mkgmtime-mkgmtime32-mkgmtime64.md) | Convert time to calendar value in Greenwich Mean Time. | +| [`mktime`, `_mktime32`, `_mktime64`](reference/mktime-mktime32-mktime64.md) | Convert time to calendar value. | +| [`_strdate`, `_wstrdate`](reference/strdate-wstrdate.md), [`_strdate_s`, `_wstrdate_s`](reference/strdate-s-wstrdate-s.md) | Return current system date as string. The versions of these functions with the **`_s`** suffix are more secure. | +| [`strftime`, `wcsftime`, `_strftime_l`, `_wcsftime_l`](reference/strftime-wcsftime-strftime-l-wcsftime-l.md) | Format date-and-time string for international use. | +| [`_strtime`, `_wstrtime`](reference/strtime-wstrtime.md), [`_strtime_s`, `_wstrtime_s`](reference/strtime-s-wstrtime-s.md) | Return current system time as string. The versions of these functions with the **`_s`** suffix are more secure. | +| [`time`, `_time32`, `_time64`](reference/time-time32-time64.md) | Get current system time as type **`time_t`**, **`__time32_t`** or as type **`__time64_t`**. | +| [`_tzset`](reference/tzset.md) | Set external time variables from environment time variable **`TZ`**. | +| [`_utime`, `_utime32`, `_utime64`, `_wutime`, `_wutime32`, `_wutime64`](reference/utime-utime32-utime64-wutime-wutime32-wutime64.md) | Set modification time for specified file using either current time or time value stored in structure. | > [!NOTE] > In all versions of Microsoft C/C++ except Microsoft C/C++ version 7.0, and in all versions of Visual C++, the time function returns the current time as the number of seconds elapsed since midnight on January 1, 1970. In Microsoft C/C++ version 7.0, **`time`** returned the current time as the number of seconds elapsed since midnight on December 31, 1899. > [!NOTE] -> In versions of Visual C++ and Microsoft C/C++ before Visual Studio 2005, **`time_t`** was a **`long int`** (32 bits) and hence could not be used for dates past 3:14:07 January 19, 2038, UTC. **`time_t`** is now equivalent to **`__time64_t`** by default, but defining `_USE_32BIT_TIME_T` changes **`time_t`** to **`__time32_t`** and forces many time functions to call versions that take the 32-bit **`time_t`**. For more information, see [Standard types](./standard-types.md) and comments in the documentation for the individual time functions. +> In versions of Visual C++ and Microsoft C/C++ before Visual Studio 2005, **`time_t`** was a **`long int`** (32 bits) and hence could not be used for dates past 3:14:07 January 19, 2038, UTC. **`time_t`** is now equivalent to **`__time64_t`** by default, but defining `_USE_32BIT_TIME_T` changes **`time_t`** to **`__time32_t`** and forces many time functions to call versions that take the 32-bit **`time_t`**. For more information, see [Standard types](standard-types.md) and comments in the documentation for the individual time functions. ## See also -[Universal C runtime routines by category](./run-time-routines-by-category.md) +[Universal C runtime routines by category](run-time-routines-by-category.md) diff --git a/docs/c-runtime-library/toc.yml b/docs/c-runtime-library/toc.yml index 4eb9c708b3c..926d9dd23ff 100644 --- a/docs/c-runtime-library/toc.yml +++ b/docs/c-runtime-library/toc.yml @@ -75,7 +75,7 @@ items: - name: Global state in the CRT href: ../c-runtime-library/global-state.md - name: Type-generic math - href: ../c-runtime-library/tgmath.md + href: ../c-runtime-library/tgmath.md - name: C runtime (CRT) and C++ Standard Library (STL) .lib files href: ../c-runtime-library/crt-library-features.md - name: Universal C runtime routines by category diff --git a/docs/c-runtime-library/unicode-stream-i-o-in-text-and-binary-modes.md b/docs/c-runtime-library/unicode-stream-i-o-in-text-and-binary-modes.md index c6c1034d8e8..2a38a3ec735 100644 --- a/docs/c-runtime-library/unicode-stream-i-o-in-text-and-binary-modes.md +++ b/docs/c-runtime-library/unicode-stream-i-o-in-text-and-binary-modes.md @@ -1,7 +1,7 @@ --- title: "Unicode Stream I/O in Text and Binary Modes" description: "A description of character conversions with Unicode stream I/O." -ms.topic: "conceptual" +ms.topic: "concept-article" ms.date: "11/04/2016" helpviewer_keywords: ["stream I/O routines", "I/O [CRT], unicode stream", "Unicode, stream I/O routines", "Unicode stream I/O"] ms.assetid: 68be0c3e-a9e6-4fd5-b34a-1b5207f0e7d6 diff --git a/docs/c-runtime-library/unicode-the-wide-character-set.md b/docs/c-runtime-library/unicode-the-wide-character-set.md index 9fbde6648ea..b78b180c2a1 100644 --- a/docs/c-runtime-library/unicode-the-wide-character-set.md +++ b/docs/c-runtime-library/unicode-the-wide-character-set.md @@ -1,7 +1,7 @@ --- title: "Unicode: The Wide-Character Set" description: "An introduction to the Unicode wide character set in the Microsoft C runtime." -ms.topic: "conceptual" +ms.topic: "concept-article" ms.date: "11/04/2016" helpviewer_keywords: ["Unicode [C++], wide character set", "wide characters [C++], Unicode"] ms.assetid: b6a05a21-59a5-4d30-8c85-2dbe185f7a74 diff --git a/docs/c-runtime-library/unix.md b/docs/c-runtime-library/unix.md index 5d63b80fd2b..e8aec366940 100644 --- a/docs/c-runtime-library/unix.md +++ b/docs/c-runtime-library/unix.md @@ -2,7 +2,7 @@ title: "UNIX" description: "Guidelines for porting your program to Unix." ms.date: "11/04/2016" -ms.topic: "conceptual" +ms.topic: "concept-article" f1_keywords: ["unix"] helpviewer_keywords: ["UNIX", "POSIX compatibility", "POSIX file names", "UNIX, compatibility"] ms.assetid: 40792414-7a5b-415d-bfa8-2bfb1ebb3731 diff --git a/docs/c-runtime-library/using-generic-text-mappings.md b/docs/c-runtime-library/using-generic-text-mappings.md index 357e8f4a54d..c40da0e91c3 100644 --- a/docs/c-runtime-library/using-generic-text-mappings.md +++ b/docs/c-runtime-library/using-generic-text-mappings.md @@ -1,17 +1,16 @@ --- title: "Using Generic-Text Mappings" description: "An introduction to Microsoft-specific mappings for data types, routines, and other objects in the C runtime." -ms.topic: "conceptual" -ms.date: "11/04/2016" +ms.date: 11/04/2016 +ms.topic: "concept-article" f1_keywords: ["_UNICODE"] helpviewer_keywords: ["_TXCHAR type", "TINT type", "_TCHAR type", "TSCHAR type", "TEXT type", "TCHAR type", "TCHAR.H data types, mappings defined in", "generic-text data types", "_TINT type", "TUCHAR type", "_UNICODE constant", "TXCHAR type", "generic-text mappings", "_TSCHAR type", "T type", "mappings, generic-text", "_TUCHAR type", "MBCS data type", "_MBCS data type", "_TEXT type", "UNICODE constant", "_T type"] -ms.assetid: 2848121c-e51f-4b9b-a2e6-833ece4b0cb3 --- # Using generic-text mappings **Microsoft Specific** -To simplify code development for various international markets, the Microsoft run-time library provides Microsoft-specific "generic-text" mappings for many data types, routines, and other objects. These mappings are defined in TCHAR.H. You can use these name mappings to write generic code that can be compiled for any of the three kinds of character sets: ASCII (SBCS), MBCS, or Unicode, depending on a manifest constant you define using a `#define` statement. Generic-text mappings are Microsoft extensions that aren't ANSI compatible. +To simplify code development for various international markets, the Microsoft run-time library provides Microsoft-specific "generic-text" mappings for many data types, routines, and other objects. These mappings are defined in `TCHAR.H`. You can use these name mappings to write generic code that can be compiled for any of the three kinds of character sets: ASCII (SBCS), MBCS, or Unicode, depending on a manifest constant you define using a `#define` statement. Generic-text mappings are Microsoft extensions that aren't ANSI compatible. ### Preprocessor directives for generic-text mappings @@ -21,13 +20,13 @@ To simplify code development for various international markets, the Microsoft ru | `_MBCS` | Multibyte-character | `_tcsrev` maps to `_mbsrev` | | None (the default: both `_UNICODE` and `_MBCS` not defined) | SBCS (ASCII) | `_tcsrev` maps to `strrev` | -For example, the generic-text function `_tcsrev`, defined in TCHAR.H, maps to `mbsrev` if `MBCS` has been defined in your program, or to `_wcsrev` if `_UNICODE` has been defined. Otherwise `_tcsrev` maps to `strrev`. +For example, the generic-text function `_tcsrev`, defined in `TCHAR.H`, maps to `_mbsrev` if `_MBCS` has been defined in your program, or to `_wcsrev` if `_UNICODE` has been defined. Otherwise `_tcsrev` maps to `strrev`. -The generic-text data type `_TCHAR`, also defined in TCHAR.H, maps to type **`char`** if `_MBCS` is defined, to type **`wchar_t`** if `_UNICODE` is defined, and to type **`char`** if neither constant is defined. Other data type mappings are provided in TCHAR.H for programming convenience, but `_TCHAR` is the type that is most useful. +The generic-text data type `_TCHAR`, also defined in `TCHAR.H`, maps to type **`char`** if `_MBCS` is defined, to type **`wchar_t`** if `_UNICODE` is defined, and to type **`char`** if neither constant is defined. Other data type mappings are provided in `TCHAR.H` for programming convenience, but `_TCHAR` is the type that is most useful. ### Generic-Text Data Type Mappings -| Generic-text data type name | SBCS (_UNICODE, _MBCS not defined) | _MBCS defined | _UNICODE defined | +| Generic-text data type name | SBCS (`_UNICODE`, `_MBCS` not defined) | `_MBCS` defined | `_UNICODE` defined | |---|---|---|---| | `_TCHAR` | **`char`** | **`char`** | **`wchar_t`** | | `_TINT` | **`int`** | **`int`** | `wint_t` | @@ -36,7 +35,7 @@ The generic-text data type `_TCHAR`, also defined in TCHAR.H, maps to type **`ch | `_TXCHAR` | **`char`** | **`unsigned char`** | **`wchar_t`** | | `_T` or `_TEXT` | No effect (removed by preprocessor) | No effect (removed by preprocessor) | `L` (converts following character or string to its Unicode counterpart) | -For a complete list of generic-text mappings of routines, variables, and other objects, see [Generic-text mappings](./generic-text-mappings.md). +For a complete list of generic-text mappings of routines, variables, and other objects, see [Generic-text mappings](generic-text-mappings.md). The following code fragments illustrate the use of `_TCHAR` and `_tcsrev` for mapping to the MBCS, Unicode, and SBCS models. @@ -45,7 +44,7 @@ _TCHAR *RetVal, *szString; RetVal = _tcsrev(szString); ``` -If `MBCS` has been defined, the preprocessor maps the preceding fragment to the following code: +If `_MBCS` has been defined, the preprocessor maps the preceding fragment to the following code: ```C char *RetVal, *szString; @@ -72,8 +71,8 @@ These macros let you write, maintain, and compile a single source code file usin ## See also -[Generic-text mappings](./generic-text-mappings.md)\ -[Data type mappings](./data-type-mappings.md)\ -[Constant and global variable mappings](./constant-and-global-variable-mappings.md)\ -[Routine mappings](./routine-mappings.md)\ -[A sample generic-text program](./a-sample-generic-text-program.md) +[Generic-text mappings](generic-text-mappings.md)\ +[Data type mappings](data-type-mappings.md)\ +[Constant and global variable mappings](constant-and-global-variable-mappings.md)\ +[Routine mappings](routine-mappings.md)\ +[A sample generic-text program](a-sample-generic-text-program.md) diff --git a/docs/c-runtime-library/using-tchar-h-data-types-with-mbcs.md b/docs/c-runtime-library/using-tchar-h-data-types-with-mbcs.md index 2a18a516783..9a6ab1ceff2 100644 --- a/docs/c-runtime-library/using-tchar-h-data-types-with-mbcs.md +++ b/docs/c-runtime-library/using-tchar-h-data-types-with-mbcs.md @@ -1,7 +1,7 @@ --- title: "Using TCHAR.H Data Types with _MBCS" description: "An overview of how Microsoft C runtime text routines are mapped when you use TCHAR.H data types with the multibyte constant _MBCS." -ms.topic: "conceptual" +ms.topic: "concept-article" ms.date: "11/04/2016" helpviewer_keywords: ["TCHAR.H data types", "MBCS data type", "_MBCS data type"] ms.assetid: 48f471e7-9d2b-4a39-b841-16a0e15c0a18 diff --git a/docs/c-runtime-library/vprintf-functions.md b/docs/c-runtime-library/vprintf-functions.md index bc1cb41d243..6119ea74286 100644 --- a/docs/c-runtime-library/vprintf-functions.md +++ b/docs/c-runtime-library/vprintf-functions.md @@ -1,9 +1,8 @@ --- -description: "Learn more about: vprintf Functions" title: "vprintf Functions" +description: "Learn more about: vprintf Functions" ms.date: "11/04/2016" helpviewer_keywords: ["vprintf functions", "formatted text [C++]"] -ms.assetid: 02ac7c51-eab1-4bf0-bf4c-77065e3fa744 --- # `vprintf` functions @@ -17,7 +16,7 @@ Each of the `vprintf` functions takes a pointer to an argument list, then format [`_vprintf_p`, `_vprintf_p_l`, `_vwprintf_p`, `_vwprintf_p_l`](./reference/vprintf-p-vprintf-p-l-vwprintf-p-vwprintf-p-l.md)\ [`vprintf_s`, `_vprintf_s_l`, `vwprintf_s`, `_vwprintf_s_l`](./reference/vprintf-s-vprintf-s-l-vwprintf-s-vwprintf-s-l.md)\ [`_vscprintf`, `_vscprintf_l`, `_vscwprintf`, `_vscwprintf_l`](./reference/vscprintf-vscprintf-l-vscwprintf-vscwprintf-l.md)\ -[`_vsnprintf`, `_vsnwprintf`](./reference/vsnprintf-vsnprintf-vsnprintf-l-vsnwprintf-vsnwprintf-l.md) +[`_vsnprintf`, `_vsnwprintf`](./reference/vsnprintf-vsnprintf-vsnprintf-l-vsnwprintf-vsnwprintf-l.md)\ [`vsprintf`, `vswprintf`](./reference/vsprintf-vsprintf-l-vswprintf-vswprintf-l-vswprintf-l.md)\ [`_vsprintf_p`, `_vsprintf_p_l`, `_vswprintf_p`, `_vswprintf_p_l`](./reference/vsprintf-p-vsprintf-p-l-vswprintf-p-vswprintf-p-l.md)\ [`vsprintf_s`, `_vsprintf_s_l`, `vswprintf_s`, `_vswprintf_s_l`](./reference/vsprintf-s-vsprintf-s-l-vswprintf-s-vswprintf-s-l.md) diff --git a/docs/cloud/cloud-and-web-programming-in-visual-cpp.md b/docs/cloud/cloud-and-web-programming-in-visual-cpp.md index 8ae34ccfbce..3259d2638e5 100644 --- a/docs/cloud/cloud-and-web-programming-in-visual-cpp.md +++ b/docs/cloud/cloud-and-web-programming-in-visual-cpp.md @@ -1,26 +1,28 @@ --- -description: "Learn more about: Cloud and Web Programming in Visual C++" -title: "Cloud and Web Programming in Visual C++" -ms.date: "05/14/2019" -ms.assetid: b63611f1-9723-44d0-ba7f-c3ebef341313 +title: "Cloud and Web Programming in Microsoft C++" +description: "Learn more about: Cloud and Web Programming in Microsoft C++" +ms.date: "11/06/2025" ms.topic: "overview" ms.custom: intro-overview --- -# Cloud and Web Programming in Visual C++ +# Cloud and web programming in Microsoft C++ In C++, you have several options for connecting to the web and the cloud. ## Microsoft Azure SDKs and REST services -- [Microsoft Azure Storage Client Library for C++](https://azure.github.io/azure-storage-cpp/) +- [Azure SDK for C++](/azure/developer/cpp/sdk/overview) - The Azure Storage Client Library for C++ provides a comprehensive API for working with Azure storage, including but not limited to the following abilities: + The Azure SDK for C++ provides a set of client libraries that enable your C++ applications to interact seamlessly with Azure services, whether in local or cloud environments. These libraries, built on top of the Azure REST API, offer familiar C++ syntax and implement common cloud patterns such as authentication, logging, and retries. The SDK provides a consistent interface for working with Azure services including: - - Create, read, delete, and list blob containers, tables, and queues. - - Create, read, delete, list and copy blobs plus read and write blob ranges. - - Insert, delete, replace, merge, and query entities in an Azure table. - - Enqueue and dequeue messages in an Azure queue. - - Lazily list containers, blobs, tables, and queues, and lazily query entities + - Azure Core + - Azure Identity + - Azure Attestation + - Azure Event Hubs + - Azure Storage + - Azure Key Vault + + To get started, see [Install and integrate from the Azure SDK for C++](/azure/developer/cpp/sdk/install-and-integrate-the-sdk/). - The ANSI C99 [Azure IoT Hub SDKs](/azure/iot-hub/iot-hub-devguide-sdks) for Internet of Things enable IoT applications to run on the device or on the backend. @@ -43,7 +45,7 @@ In C++, you have several options for connecting to the web and the cloud. - [Windows::Web::Http::HttpClient](/uwp/api/windows.web.http.httpclient) - A Windows Runtime HTTP client class modeled on the .NET Framework class of the same name in the System.Web namespace. `HttpClient` fully supports asynchronous upload and download over HTTP, and pipeline filters that enable the insertion of custom HTTP handlers into the pipeline. The Windows SDK includes sample filters for metered networks, OAuth authentication, and more. For apps that target only Universal Windows Platform, we recommend that you use the `Windows::Web:HttpClient` class. + A Windows Runtime HTTP client class modeled on the .NET Framework class of the same name in the System.Web namespace. `HttpClient` fully supports asynchronous upload and download over HTTP, and pipeline filters that enable the insertion of custom HTTP handlers into the pipeline. The Windows SDK includes sample filters for metered networks, OAuth authentication, and more. For apps that target only Universal Windows Platform, use the `Windows::Web::Http::HttpClient` class. - [IXMLHTTPRequest2 interface](/windows/win32/api/msxml6/nn-msxml6-ixmlhttprequest2) @@ -55,6 +57,6 @@ In C++, you have several options for connecting to the web and the cloud. ## See also -[C++ in Visual Studio](../overview/visual-cpp-in-visual-studio.md)
-[Microsoft Azure C and C++ Developer Center](https://azure.microsoft.com/develop/cpp/)
+[C++ in Visual Studio](../overview/visual-cpp-in-visual-studio.md)\ +[Microsoft Azure C++ Developer Center](/azure/developer/cpp/)\ [Networks and web services (UWP)](/windows/uwp/networking/) diff --git a/docs/code-quality/annotating-function-behavior.md b/docs/code-quality/annotating-function-behavior.md index 4458f342c2d..98a9bf99f68 100644 --- a/docs/code-quality/annotating-function-behavior.md +++ b/docs/code-quality/annotating-function-behavior.md @@ -2,7 +2,7 @@ description: "Learn more about: Annotating function behavior" title: Annotating function behavior ms.date: 11/04/2016 -ms.topic: "conceptual" +ms.topic: "concept-article" f1_keywords: - "_On_failure_" - "_Return_type_success_" diff --git a/docs/code-quality/annotating-function-parameters-and-return-values.md b/docs/code-quality/annotating-function-parameters-and-return-values.md index bd9ffdd4534..5c0a0531f02 100644 --- a/docs/code-quality/annotating-function-parameters-and-return-values.md +++ b/docs/code-quality/annotating-function-parameters-and-return-values.md @@ -2,7 +2,7 @@ title: Annotating function parameters and return values description: "Reference guide to function parameter and return value annotations." ms.date: 10/15/2019 -ms.topic: "conceptual" +ms.topic: "concept-article" f1_keywords: - "_Outptr_opt_result_bytebuffer_to_" - "_Inout_updates_all_opt_" diff --git a/docs/code-quality/annotating-locking-behavior.md b/docs/code-quality/annotating-locking-behavior.md index a362074bad1..99bb3bf25e9 100644 --- a/docs/code-quality/annotating-locking-behavior.md +++ b/docs/code-quality/annotating-locking-behavior.md @@ -2,7 +2,7 @@ description: "Learn more about: Annotating Locking Behavior" title: Annotating Locking Behavior ms.date: 08/24/2022 -ms.topic: "conceptual" +ms.topic: "concept-article" f1_keywords: - "_Releases_nonreentrant_lock_" - "_Lock_kind_mutex_" diff --git a/docs/code-quality/annotating-structs-and-classes.md b/docs/code-quality/annotating-structs-and-classes.md index 32669912be8..fdc83bc210b 100644 --- a/docs/code-quality/annotating-structs-and-classes.md +++ b/docs/code-quality/annotating-structs-and-classes.md @@ -1,8 +1,8 @@ --- -description: "Learn more about: Annotating Structs and Classes" title: Annotating Structs and Classes +description: "Learn more about: Annotating Structs and Classes" ms.date: 06/28/2019 -ms.topic: "conceptual" +ms.topic: "concept-article" f1_keywords: - "_Field_size_bytes_part_" - "_Field_size_bytes_full_opt_" @@ -19,7 +19,6 @@ f1_keywords: - "_Field_size_full_" - "_Field_size_full_opt_" - "_Field_z_" -ms.assetid: b8278a4a-c86e-4845-aa2a-70da21a1dd52 --- # Annotating Structs and Classes @@ -52,13 +51,11 @@ You can annotate struct and class members by using annotations that act like inv Applies to struct or class declaration. Indicates that a valid object of that type may be larger than the declared type, with the number of bytes being specified by `size`. For example: ```cpp - typedef _Struct_size_bytes_(nSize) struct MyStruct { size_t nSize; ... }; - ``` The buffer size in bytes of a parameter `pM` of type `MyStruct *` is then taken to be: diff --git a/docs/code-quality/best-practices-and-examples-sal.md b/docs/code-quality/best-practices-and-examples-sal.md index 320b8100d3c..aa2b6e986b0 100644 --- a/docs/code-quality/best-practices-and-examples-sal.md +++ b/docs/code-quality/best-practices-and-examples-sal.md @@ -2,7 +2,7 @@ description: "Learn more about: Best practices and examples (SAL)" title: Best practices and examples (SAL) ms.date: 03/30/2023 -ms.topic: "conceptual" +ms.topic: "best-practice" --- # Best practices and examples (SAL) diff --git a/docs/code-quality/build-reliable-secure-programs.md b/docs/code-quality/build-reliable-secure-programs.md index 13341b30945..2f31f19fc15 100644 --- a/docs/code-quality/build-reliable-secure-programs.md +++ b/docs/code-quality/build-reliable-secure-programs.md @@ -1,8 +1,8 @@ --- title: Build reliable and secure C++ programs description: "Learn more about: Building reliable and secure C++ programs by applying NISTIR 8397 guidelines." -ms.date: 09/28/2023 -ms.topic: "conceptual" +ms.date: 04/25/2025 +ms.topic: "concept-article" --- # Build reliable and secure C++ programs @@ -114,8 +114,8 @@ Tests that do deeper verification and take longer to run, such as static analysi **Key tools** Be aware of and use the following: - [Code analysis documentation - C++ and .NET](/visualstudio/code-quality/) -- [`/analyze` - Visual C++ compiler](../build/reference/analyze-code-analysis.md) -- [`/W4` and `/WX` - Visual C++ compiler](../build/reference/compiler-option-warning-level.md) +- [`/analyze` - Microsoft C++ compiler](../build/reference/analyze-code-analysis.md) +- [`/W4` and `/WX` - Microsoft C++ compiler](../build/reference/compiler-option-warning-level.md) - [Use the C++ Core Guidelines Checkers](using-the-cpp-core-guidelines-checkers.md) - [CodeQL | GitHub](https://codeql.github.com/) - [Binskim user guide | GitHub](https://github.com/microsoft/binskim/blob/main/docs/UserGuide.md) @@ -123,7 +123,7 @@ Tests that do deeper verification and take longer to run, such as static analysi Notes: -- `/analyze` enables static analysis of C++ code at compile time to identify critical security and reliability code vulnerabilities. It should be enabled throughout a C++ program's entire development timeline. Start by enabling at least the "Microsoft Native Recommended" by default as a minimum baseline. Then consult the documentation for how to specify more rules, especially the C++ Core Guidelines rules, as required by your engineering policies. The source code Static Analysis capability is available in both the Visual C++ IDE and in the command-line Build Tools. +- `/analyze` enables static analysis of C++ code at compile time to identify critical security and reliability code vulnerabilities. It should be enabled throughout a C++ program's entire development timeline. Start by enabling at least the "Microsoft Native Recommended" by default as a minimum baseline. Then consult the documentation for how to specify more rules, especially the C++ Core Guidelines rules, as required by your engineering policies. The source code Static Analysis capability is available in both the Visual Studio IDE and in the command-line Build Tools. - `/W4` and `/WX` should be enabled wherever possible, to ensure you compile your code cleanly at high warning levels (`W4`) and treat warnings as errors that must be fixed (`WX`). These options enable finding uninitialized data errors that other static analysis tools can't check, because the errors only become visible after the compiler back-end performs interprocedural analysis and inlining. - BinSkim binary analysis ensures that projects enable a broad range of security features. BinSkim generates PDBs and other outputs that make it easier to verify chain-of-custody and to respond efficiently to security issues. Microsoft recommends running the BinSkim tool to analyze all executable binaries (`.sys`, `.dll` or `.exe`) produced for or consumed by your programs. The BinSkim User Guide includes a list of supported security standards. Microsoft recommends that you fix all issues reported as "errors" by the BinSkim tool. Issues reported as "warnings" should be evaluated selectively, because resolving them can have performance implications or might not be necessary. @@ -182,7 +182,7 @@ Remove the now-invalidated secrets from your source code, and replace them with **Azure DevOps (AzDO)** -AzDO users can scan their code through GitHub Advanced Security for Azure DevOps (GHAzDO). GHAzDO also allows users to prevent secret exposures by enabling Push Protection on their repositories, catching potential exposures before they're ever leaked. For more information on how to detect hardcoded secrets in code in Azure DevOps, see *Secret Scanning for Github Advanced Security for Azure DevOps* in each of the following links: +AzDO users can scan their code through GitHub Advanced Security for Azure DevOps (GHAzDO). GHAzDO also allows users to prevent secret exposures by enabling Push Protection on their repositories, catching potential exposures before they're ever leaked. For more information on how to detect hardcoded secrets in code in Azure DevOps, see *Secret Scanning for GitHub Advanced Security for Azure DevOps* in each of the following links: - [GitHub advanced security for Azure DevOps](https://azure.microsoft.com/products/devops/github-advanced-security) - [Secret Scanning for GitHub Advanced Security for Azure DevOps](/azure/devops/repos/security/github-advanced-security-secret-scanning) @@ -205,11 +205,11 @@ GitHub provides known patterns of secrets for partners and users that can be con **Additional resources** -- [Credential Scanning | Microsoft Code With Engineering Playbook](https://microsoft.github.io/code-with-engineering-playbook/continuous-integration/dev-sec-ops/secret-management/credential_scanning/). -- [detect-secrets: Credential scanning tool | GitHub](https://microsoft.github.io/code-with-engineering-playbook/continuous-integration/dev-sec-ops/secret-management/recipes/detect-secrets/) - an aptly named module for detecting secrets within a code base. -- [Running detect-secrets in Azure Pipelines](https://microsoft.github.io/code-with-engineering-playbook/continuous-integration/dev-sec-ops/secret-management/recipes/detect-secrets-ado/). +- [Credential Scanning | Microsoft Code With Engineering Playbook](https://microsoft.github.io/code-with-engineering-playbook/CI-CD/dev-sec-ops/secrets-management/credential_scanning/). +- [detect-secrets: Credential scanning tool | GitHub](https://microsoft.github.io/code-with-engineering-playbook/CI-CD/dev-sec-ops/secrets-management/recipes/detect-secrets/) - an aptly named module for detecting secrets within a code base. +- [Running detect-secrets in Azure Pipelines](https://microsoft.github.io/code-with-engineering-playbook/CI-CD/dev-sec-ops/secrets-management/recipes/detect-secrets-ado/). - [Git-secrets | GitHub awslabs](https://github.com/awslabs/git-secrets) - prevents you from committing passwords and other sensitive information to a git repository. -- [Secrets Management | Microsoft Code with Engineering Playbook](https://microsoft.github.io/code-with-engineering-playbook/continuous-delivery/secrets-management/) - provides general guidelines on how secrets should be managed. +- [Secrets Management | Microsoft Code with Engineering Playbook](https://microsoft.github.io/code-with-engineering-playbook/CI-CD/dev-sec-ops/secrets-management/) - provides general guidelines on how secrets should be managed. ## 2.5 Run with language- and OS-provided checks and protection @@ -249,14 +249,14 @@ Binaries shouldn't link to insecure libraries and dependencies. Development team Compilation should enable strong code provenance guarantees to help detect and prevent introduction of backdoors and other malicious code. The resulting data, also critical to debugging and investigation, should be archived for all software releases to drive efficient security response if they're compromised. The following compiler switches generate information that is critical to a security response: -- [`/ZH:SHA_SHA256` in Visual C++](../build/reference/zh.md) - Ensures that a cryptographically secure algorithm is used to generate all PDB source file hashes. -- [`/Zi`, `/ZI` (Debug Information Format) in Visual C++](../build/reference/z7-zi-zi-debug-information-format.md) - In addition to publishing stripped symbols for collecting crash data and other public use scenarios, ensure that builds produce and archive private PDBs for all released binaries. Binary analysis tools require full symbols to verify whether many security mitigations were enabled at compile-time. Private symbols are critical in security response, and lower debugging and investigation costs when engineers are racing to assess and limit damage when an exploit happens. -- [`/SOURCELINK` in Visual C++ Linker - Include Sourcelink file in PDB](../build/reference/sourcelink.md): Source link is a language- and source-control agnostic system providing source debugging for binaries. Source debugging greatly increases the efficiency the range of prerelease security validations and post-release incident response. +- [`/ZH:SHA_SHA256` in Microsoft C++](../build/reference/zh.md) - Ensures that a cryptographically secure algorithm is used to generate all PDB source file hashes. +- [`/Zi`, `/ZI` (Debug Information Format) in Microsoft C++](../build/reference/z7-zi-zi-debug-information-format.md) - In addition to publishing stripped symbols for collecting crash data and other public use scenarios, ensure that builds produce and archive private PDBs for all released binaries. Binary analysis tools require full symbols to verify whether many security mitigations were enabled at compile-time. Private symbols are critical in security response, and lower debugging and investigation costs when engineers are racing to assess and limit damage when an exploit happens. +- [`/SOURCELINK` in Microsoft C++ Linker - Include Sourcelink file in PDB](../build/reference/sourcelink.md): Source link is a language- and source-control agnostic system providing source debugging for binaries. Source debugging greatly increases the efficiency the range of prerelease security validations and post-release incident response. **Enable compiler errors to prevent issues at code authoring time** Compilation should enable security-relevant compiler checks as breaking errors, for example: -- [`/sdl` in Visual C++ - Enable additional security checks](https://aka.ms/AdditionalSecurityChecks) elevates many security-relevant warnings into errors and enables advanced secure code-generation features. +- [`/sdl` in Microsoft C++ - Enable additional security checks](https://aka.ms/AdditionalSecurityChecks) elevates many security-relevant warnings into errors and enables advanced secure code-generation features. - [BinSkim BA2007.EnableCriticalCompilerWarnings | GitHub](https://github.com/microsoft/binskim/blob/main/src/BinSkim.Rules/PERules/BA2007.EnableCriticalCompilerWarnings.cs) maintains a list of Microsoft-recommended C/C++ compiler warnings that should always be enabled and elevated to errors. **Mark binaries as compatible with OS runtime security mitigations** @@ -395,13 +395,13 @@ When using both sanitizers such as [Address Sanitizer (ASan)](../sanitizers/asan **Azure and GitHub CI/CD** -Modify your build(s) to support continuous creation of executables that use LibFuzzer or AFL++. You can add extra computing resources required for fuzzing at services like OSS-Fuzz or OneFuzz. +Modify your build(s) to support continuous creation of executables that use LibFuzzer or AFL++. You can add extra computing resources required for fuzzing at services like OSS-Fuzz. ## 2.10 Web Application Scanning **Summary** -Within the scope of Microsoft Visual C++ on Windows, Microsoft recommends: +Within the scope of Microsoft C++ on Windows, Microsoft recommends: - Prefer TypeScript, JavaScript, and ASP.NET for web applications. - Don't write web extensions in C++. Microsoft has deprecated ActiveX. diff --git a/docs/code-quality/c1250.md b/docs/code-quality/c1250.md index 26582cfe00d..593bf2fe4df 100644 --- a/docs/code-quality/c1250.md +++ b/docs/code-quality/c1250.md @@ -1,13 +1,14 @@ --- +title: "Fatal error C1250" description: "Learn more about: Fatal error C1250" -title: Fatal error C1250 ms.date: 10/04/2022 f1_keywords: ["C1250", "FATALERROR_UnableToLoadPlugin"] helpviewer_keywords: ["C1250"] -ms.assetid: 3f2385d7-e0d6-4574-8cea-342e82d0aea4 --- # Fatal error C1250 > Unable to load plug-in '*plugin-name*'. +## Remarks + The Code Analysis tool reports this error when there's an internal error in the plugin, not in the code being analyzed. diff --git a/docs/code-quality/c1251.md b/docs/code-quality/c1251.md index ca58d7858b7..369f49e98ea 100644 --- a/docs/code-quality/c1251.md +++ b/docs/code-quality/c1251.md @@ -1,13 +1,14 @@ --- +title: "Fatal error C1251" description: "Learn more about: Fatal error C1251" -title: Fatal error C1251 ms.date: 10/04/2022 f1_keywords: ["C1251", "FATALERROR_UnableToLoadModel"] helpviewer_keywords: ["C1251"] -ms.assetid: 0b46e0a5-c290-48d8-ba4e-f526ae68993b --- # Fatal error C1251 > Unable to load models. +## Remarks + The Code Analysis tool reports this error when there's an internal error in the model file, not in the code being analyzed. diff --git a/docs/code-quality/c1252.md b/docs/code-quality/c1252.md index 4cdf0a16128..3e679ec2d38 100644 --- a/docs/code-quality/c1252.md +++ b/docs/code-quality/c1252.md @@ -1,15 +1,16 @@ --- +title: "Fatal error C1252" description: "Learn more about: Fatal error C1252" -title: Fatal error C1252 ms.date: 10/04/2022 f1_keywords: ["C1252", "FATALERROR_CircularDependency"] helpviewer_keywords: ["C1252"] -ms.assetid: e88bf199-890d-4582-bb5c-c1238797145b --- # Fatal error C1252 > Circular or missing dependency between plugins: '*plugin-name*' requires GUID '*globally-unique-identifier*' +## Remarks + The Code Analysis tool reports this error when there's an internal error in the plugin dependencies. It's not caused by an issue in the code being analyzed. In some cases, it's possible to work around this issue by disabling the **Enable Code Analysis on Build** property. To disable this build property, open the Property pages dialog for your project. In the **Solution Explorer** window, right-click on the project (not the solution) and select **Properties** in the shortcut menu. Set the **Configuration** to **All Configurations** and the **Platform** to **All Platforms**. Open the **Configuration Properties** > **Code Analysis** > **General** property page. Modify the **Enable Code Analysis on Build** property to **No**. Choose **OK** to save your changes, and then save your project files. Rebuild your project to verify that the issue no longer occurs. diff --git a/docs/code-quality/c1253.md b/docs/code-quality/c1253.md index 32765463140..568be82155e 100644 --- a/docs/code-quality/c1253.md +++ b/docs/code-quality/c1253.md @@ -1,13 +1,14 @@ --- +title: "Fatal error C1253" description: "Learn more about: Fatal error C1253" -title: Fatal error C1253 ms.date: 10/04/2022 f1_keywords: ["C1253", "FATALERROR_UnableToLoadModelFile"] helpviewer_keywords: ["C1253"] -ms.assetid: 21a4062f-fde8-40e5-8dbd-6f892926d3d2 --- # Fatal error C1253 > Unable to load model file. +## Remarks + The Code Analysis tool reports this error when there's an internal error in the model file, not in the code being analyzed. diff --git a/docs/code-quality/c1254.md b/docs/code-quality/c1254.md index e584d07eee4..b77f3f40da4 100644 --- a/docs/code-quality/c1254.md +++ b/docs/code-quality/c1254.md @@ -1,13 +1,14 @@ --- +title: "Fatal error C1254" description: "Learn more about: Fatal error C1254" -title: Fatal error C1254 ms.date: 10/04/2022 f1_keywords: ["C1254", "FATALERROR_PluginVersionMismatch"] helpviewer_keywords: ["C1254"] -ms.assetid: cb1377cf-869e-432d-941f-71f77134f97a --- # Fatal error C1254 > Plugin version mismatch: '*module*' version '*version-number*' doesn't match the version '*version-number*' of the PREfast driver +## Remarks + The Code Analysis tool reports this error when there's an internal error with the plugin version, not in the code being analyzed. diff --git a/docs/code-quality/c1255.md b/docs/code-quality/c1255.md index 9480c693e19..1f3b9d92e50 100644 --- a/docs/code-quality/c1255.md +++ b/docs/code-quality/c1255.md @@ -1,13 +1,14 @@ --- +title: "Fatal error C1255" description: "Learn more about: Fatal error C1255" -title: Fatal error C1255 ms.date: 10/04/2022 f1_keywords: ["C1255", "FATALERROR_PCHSyncLost"] helpviewer_keywords: ["C1255"] -ms.assetid: a97da6bd-06dc-42bf-9158-0de1ebb90d4a --- # Fatal error C1255 > PCH data for plugin '*plugin-name*' has incorrect length. +## Remarks + The Code Analysis tool reports this error when there's an internal error in the tool, not in the code being analyzed. diff --git a/docs/code-quality/c1256.md b/docs/code-quality/c1256.md index 54a456fa9e4..bdf7af0eff0 100644 --- a/docs/code-quality/c1256.md +++ b/docs/code-quality/c1256.md @@ -1,13 +1,14 @@ --- +title: "Fatal error C1256" description: "Learn more about: Fatal error C1256" -title: Fatal error C1256 ms.date: 10/04/2022 f1_keywords: ["C1256", "FATALERROR_PCHInconsistent"] helpviewer_keywords: ["C1256"] -ms.assetid: 4d65e495-f9d9-435c-ba51-1cf5b4cc2309 --- # Fatal error C1256 > '*plugin-name*': PCH must be both written and read. +## Remarks + The Code Analysis tool reports this error when there's an internal error in the tool, not in the code being analyzed. diff --git a/docs/code-quality/c1257.md b/docs/code-quality/c1257.md index c104af70b72..b4e698c29b9 100644 --- a/docs/code-quality/c1257.md +++ b/docs/code-quality/c1257.md @@ -1,13 +1,14 @@ --- +title: "Fatal error C1257" description: "Learn more about: Fatal error C1257" -title: Fatal error C1257 ms.date: 10/04/2022 f1_keywords: ["C1257", "FATALERROR_InitFailure"] helpviewer_keywords: ["C1257"] -ms.assetid: 38d3ec05-01ba-42b3-aac6-077e92bf2ded --- # Fatal error C1257 > '*Plugin-name*': Initialization Failure. +## Remarks + The Code Analysis tool reports this error when there's an internal error in the plugin, not in the code being analyzed. diff --git a/docs/code-quality/c1258.md b/docs/code-quality/c1258.md index accca5c1d84..46de1a74a71 100644 --- a/docs/code-quality/c1258.md +++ b/docs/code-quality/c1258.md @@ -1,6 +1,6 @@ --- +title: "Fatal error C1258" description: "Learn more about: Fatal error C1258" -title: Fatal error C1258 ms.date: 10/04/2022 f1_keywords: ["C1258", "FATALERROR_SaveToXmlFailed"] helpviewer_keywords: ["C1258"] @@ -9,4 +9,6 @@ helpviewer_keywords: ["C1258"] > Failed to save XML Log file '*filename*'. *Message*. +## Remarks + The Code Analysis tool reports this error when there's an internal error in the plugin, not in the code being analyzed. diff --git a/docs/code-quality/c1259.md b/docs/code-quality/c1259.md index 0d22874e871..0dd892f8aee 100644 --- a/docs/code-quality/c1259.md +++ b/docs/code-quality/c1259.md @@ -1,6 +1,6 @@ --- +title: "Fatal error C1259" description: "Learn more about: Fatal error C1259" -title: Fatal error C1259 ms.date: 10/04/2022 f1_keywords: ["C1259", "FATALERROR_FatalError"] helpviewer_keywords: ["C1259"] @@ -9,4 +9,6 @@ helpviewer_keywords: ["C1259"] > A fatal error was issued by a plugin. +## Remarks + The Code Analysis tool reports this error when there's an internal error in the plugin, not in the code being analyzed. diff --git a/docs/code-quality/c1260.md b/docs/code-quality/c1260.md index 6cf3642c1d2..8142771589a 100644 --- a/docs/code-quality/c1260.md +++ b/docs/code-quality/c1260.md @@ -1,6 +1,6 @@ --- +title: "Fatal error C1260" description: "Learn more about: Fatal error C1260" -title: Fatal error C1260 ms.date: 10/04/2022 f1_keywords: ["C1260", "FATALERROR_DuplicateId"] helpviewer_keywords: ["C1260"] @@ -9,4 +9,6 @@ helpviewer_keywords: ["C1260"] > The plugins '*plugin-1*' and '*plugin-2*' share the same id. It is not supported to load the same plugin twice. +## Remarks + The Code Analysis tool reports this error when there's an internal error in the plugin, not in the code being analyzed. diff --git a/docs/code-quality/c26100.md b/docs/code-quality/c26100.md index f3ab41f0209..c0a64ac0408 100644 --- a/docs/code-quality/c26100.md +++ b/docs/code-quality/c26100.md @@ -1,10 +1,9 @@ --- +title: "Warning C26100" description: "Learn more about: Warning C26100" -title: Warning C26100 ms.date: 11/04/2016 f1_keywords: ["C26100", "RACE_CONDITION", "__WARNING_RACE_CONDITION"] helpviewer_keywords: ["C26100"] -ms.assetid: 470ab2b2-5b55-424f-b192-3863a773c892 --- # Warning C26100 diff --git a/docs/code-quality/c26101.md b/docs/code-quality/c26101.md index aefe6357eb3..c89fbe4543c 100644 --- a/docs/code-quality/c26101.md +++ b/docs/code-quality/c26101.md @@ -1,15 +1,16 @@ --- +title: "Warning C26101" description: "Learn more about: Warning C26101" -title: Warning C26101 ms.date: 11/04/2016 f1_keywords: ["C26101"] helpviewer_keywords: ["C26101"] -ms.assetid: 86046553-09ec-40ce-82b3-fd641928f0b0 --- # Warning C26101 > Failing to use interlocked operation properly for variable '*var*'. +## Remarks + Windows APIs offer various interlocked operations. Annotation `_Interlocked_` specifies that a variable should only be accessed through an interlocked operation. Warning C26101 is issued when a variable access isn't consistent with the `_Interlocked_` annotation. ## Example diff --git a/docs/code-quality/c26105.md b/docs/code-quality/c26105.md index 72dbc32d32a..0381c3feec2 100644 --- a/docs/code-quality/c26105.md +++ b/docs/code-quality/c26105.md @@ -1,15 +1,16 @@ --- +title: "Warning C26105" description: "Learn more about: Warning C26105" -title: Warning C26105 ms.date: 11/04/2016 f1_keywords: ["C26105"] helpviewer_keywords: ["C26105"] -ms.assetid: 5558a3db-0513-43b4-8579-ccdc17e2b92f --- # Warning C26105 > Lock order violation. Acquiring lock '*lock*' with level '*level*' causes order inversion. +## Remarks + Concurrency SAL supports *lock levels*. To declare a lock level, which is denoted by a string literal without double quotes, use `_Create_lock_level_`. You can impose an order of acquisition between two lock levels by using the annotation `_Set_lock_level_order_(A,B)`, which states that locks that have level `A` must be acquired before locks that have level `B`. To establish a lock order hierarchy (a partial order among lock levels), use multiple `_Set_lock_level_order_` annotations. To associate a lock with a lock level, use the `_Set_lock_level_` annotation when you declare the lock. Warning C26105 is issued when a lock ordering violation is detected. ## Example diff --git a/docs/code-quality/c26110.md b/docs/code-quality/c26110.md index d1981b15768..67d89e3cefe 100644 --- a/docs/code-quality/c26110.md +++ b/docs/code-quality/c26110.md @@ -1,15 +1,16 @@ --- +title: "Warning C26110" description: "Learn more about: Warning C26110" -title: Warning C26110 ms.date: 10/01/2019 f1_keywords: ["C26110"] helpviewer_keywords: ["C26110"] -ms.assetid: d82b79ec-6d7f-438b-bd6a-da874a3e08e5 --- # Warning C26110 > Caller failing to hold lock '*lock*' before calling function '*func*'. +## Remarks + When a lock is required, make sure to clarify whether the function itself, or its caller, should acquire the lock. Warning C26110 is issued when there's a violation of the `_Requires_lock_held_` annotation, or other lock-related annotations. For more information, see [Annotating Locking Behavior](annotating-locking-behavior.md) ## Example diff --git a/docs/code-quality/c26111.md b/docs/code-quality/c26111.md index 5fdbec7c476..c7bf8bee694 100644 --- a/docs/code-quality/c26111.md +++ b/docs/code-quality/c26111.md @@ -1,15 +1,16 @@ --- +title: "Warning C26111" description: "Learn more about: Warning C26111" -title: Warning C26111 ms.date: 11/04/2016 f1_keywords: ["C26111"] helpviewer_keywords: ["C26111"] -ms.assetid: 85fc740a-3bbb-41b8-a848-95e243a08da9 --- # Warning C26111 > Caller failing to release lock '*lock*' before calling function '*func*'. +## Remarks + The annotation `_Requires_lock_not_held_` imposes a precondition that the lock count for the specified lock can't be greater than zero when the function is called. Warning C26111 is issued when a function fails to release the lock before it calls another function. ## Example diff --git a/docs/code-quality/c26112.md b/docs/code-quality/c26112.md index 7794bf4ef5b..58554638b08 100644 --- a/docs/code-quality/c26112.md +++ b/docs/code-quality/c26112.md @@ -1,15 +1,16 @@ --- +title: "Warning C26112" description: "Learn more about: Warning C26112" -title: Warning C26112 ms.date: 11/04/2016 f1_keywords: ["C26112"] helpviewer_keywords: ["C26112"] -ms.assetid: 926de738-b9b0-43d7-9137-ab2daa44ad4d --- # Warning C26112 > Caller cannot hold any lock before calling '*func*'. +## Remarks + The annotation `_Requires_no_locks_held_` imposes a precondition that the caller must not hold any lock while it calls the function. Warning C26112 is issued when a function fails to release all locks before it calls another function. ## Example diff --git a/docs/code-quality/c26115.md b/docs/code-quality/c26115.md index 402dd0aea97..3c634459d07 100644 --- a/docs/code-quality/c26115.md +++ b/docs/code-quality/c26115.md @@ -1,15 +1,16 @@ --- +title: "Warning C26115" description: "Learn more about: Warning C26115" -title: Warning C26115 ms.date: 11/04/2016 f1_keywords: ["C26115"] helpviewer_keywords: ["C26115"] -ms.assetid: 3977a2bb-d1fe-4510-89dd-07fdc69e911c --- # Warning C26115 > Failing to release lock '*lock*' in function '*func*'. +## Remarks + Enforcement of syntactically scoped lock *acquire* and lock *release* pairs in C/C++ programs isn't performed by the language. A function may introduce a locking side effect by making an observable modification to the concurrency state. For example, a lock wrapper function increments the number of lock acquisitions, or lock count, for a given lock. You can annotate a function that has a side effect from a lock acquire or lock release by using `_Acquires_lock_` or `_Releases_lock_`, respectively. Without such annotations, a function is expected not to change any lock count after it returns. If acquires and releases aren't balanced, they're considered to be *orphaned*. Warning C26115 is issued when a function introduces an orphaned lock. diff --git a/docs/code-quality/c26117.md b/docs/code-quality/c26117.md index 235b47f14f4..16ebb6bff74 100644 --- a/docs/code-quality/c26117.md +++ b/docs/code-quality/c26117.md @@ -1,15 +1,16 @@ --- +title: "Warning C26117" description: "Learn more about: Warning C26117" -title: Warning C26117 ms.date: 11/04/2016 f1_keywords: ["C26117"] helpviewer_keywords: ["C26117"] -ms.assetid: cc7ebc8d-9826-4cad-a4d5-2d3ad5896734 --- # Warning C26117 > Releasing unheld lock '*lock*' in function '*func*'. +## Remarks + Enforcement of syntactically scoped lock *acquire* and lock *release* pairs in C/C++ programs isn't performed by the language. A function may introduce a locking side effect by making an observable modification to the concurrency state. For example, a lock wrapper function increments the number of lock acquisitions, or lock count, for a given lock. You can annotate a function that has a side effect from a lock acquire or lock release by using `_Acquires_lock_` or `_Releases_lock_`, respectively. Without such annotations, a function is expected not to change any lock count after it returns. If acquires and releases aren't balanced, they're considered to be *orphaned*. Warning C26117 is issued when a function that hasn't been annotated with `_Releases_lock_` releases a lock that it doesn't hold, because the function must own the lock before it releases it. ## Examples diff --git a/docs/code-quality/c26130.md b/docs/code-quality/c26130.md index fb1912520c6..990d87c2b3e 100644 --- a/docs/code-quality/c26130.md +++ b/docs/code-quality/c26130.md @@ -1,15 +1,16 @@ --- +title: "Warning C26130" description: "Learn more about: Warning C26130" -title: Warning C26130 ms.date: 11/04/2016 f1_keywords: ["C26130"] helpviewer_keywords: ["C26130"] -ms.assetid: 535e2356-bc84-4549-983d-7d29aee2249c --- # Warning C26130 > Missing annotation \_Requires\_lock\_held\_('*lock*') or \_No\_competing\_thread\_ at function '*func*'. Otherwise it could be a race condition. Variable '*var*' should be protected by lock '*lock*'. +## Remarks + Warning C26130 is issued when the analyzer detects a potential race condition but infers that the function is likely to be run in a single threaded mode. For example, when the function is in the initialization stage, based on certain heuristics. ## Examples diff --git a/docs/code-quality/c26132.md b/docs/code-quality/c26132.md new file mode 100644 index 00000000000..aedc7e027ce --- /dev/null +++ b/docs/code-quality/c26132.md @@ -0,0 +1,73 @@ +--- +title: "Warning C26132" +description: "Documentation on static analysis warning C26132" +ms.date: 02/11/2025 +author: Rastaban +ms.author: philc +ms.service: visual-cpp +ms.topic: concept-article +--- +# Warning C26132 + +> Variable '*variable name*' should be protected by '*lock 1*', but '*lock 2*' is held instead. Possible annotation mismatch. + +The analyzer issues Warning C26132 when it detects that a lock, which is annotated to protect a value, isn't held while accessing the value. However, a related lock is held. The code may be thread-safe, so you might need to update the annotations. + +This diagnostic usually doesn't indicate a bug in the code, but rather a mismatch between the annotations and the actual locking behavior. If so, the diagnostic should be resolved as there may be other static analysis issues that aren't being reported due to the inconsistent annotations. + +## Examples + +In the following example, C26132 is emitted when `data` is used. + + The annotation specifies that `customLock01` should protect the variable `data`, but `CustomLockAcquire` is responsible for acquiring the related lock `customLock01->cs`. + +```cpp +#include +struct CustomLock +{ + int cs; // "Critical Section" lock +}; + +_Acquires_exclusive_lock_(criticalSection->cs) // notice the `->` indirection +void CustomLockAcquire(CustomLock* criticalSection); + +_Releases_lock_(criticalSection->cs) // notice the `->` indirection +void CustomLockRelease(CustomLock* criticalSection); + +// global lock +CustomLock customLock01; + +void Initialize(_Guarded_by_(customLock01) int* data) +{ + CustomLockAcquire(&customLock01); + *data = 1; // C26132 + CustomLockRelease(&customLock01); +} +``` + +In this example, the `Initialize` function is thread-safe and behaves as designed, but that design isn't correctly reflected in the concurrency SAL annotations. Fix by adjusting the annotations on the custom locking functions to use `criticalSection` rather than `criticalSection->cs`. The warning could also be fixed by changing the `_Guarded_by_` annotation from `customLock01` to `customLock01.cs`. + +```cpp +#include +struct CustomLock +{ + int cs; // "Critical Section" lock +}; + +_Acquires_exclusive_lock_(criticalSection) +void CustomLockAcquire(CustomLock* criticalSection); + +_Releases_lock_(criticalSection) +void CustomLockRelease(CustomLock* criticalSection); + +// global lock +CustomLock customLock01; + +void Initialize(_Guarded_by_(customLock01) int* data) +{ + CustomLockAcquire(&customLock01); + *data = 1; + CustomLockRelease(&customLock01); +} +``` + diff --git a/docs/code-quality/c26133.md b/docs/code-quality/c26133.md new file mode 100644 index 00000000000..e206e837948 --- /dev/null +++ b/docs/code-quality/c26133.md @@ -0,0 +1,76 @@ +--- +title: "Warning C26133" +description: "Documentation on static analysis warning C26133" +ms.date: 02/19/2025 +author: Rastaban +ms.author: philc +ms.service: visual-cpp +ms.topic: concept-article +--- +# Warning C26133 + +> Caller failing to hold lock '*lock 1*' before calling function '*function name*', but '*lock 2*' is held instead. Possible annotation mismatch. + +Warning C26133 is issued when the analyzer detects that the lock required to call a function isn't held when the function is called. However, another lock that appears to be related is held. It's possible the code is thread-safe, and the annotations need to be updated. + +This diagnostic usually doesn't indicate a bug in the code, but rather a mismatch between the annotations and the actual locking behavior. If so, the diagnostic should be resolved as there may be other static analysis issues that aren't being reported due to the inconsistent annotations. + +## Examples + +In the following example, C26133 is emitted when `DoTaskWithCustomLock` is called. + +> warning C26133: Caller failing to hold lock 'customLock01' before calling function 'DoTaskWithCustomLock', but '(&customLock01)->cs' is held instead. Possible annotation mismatch. + +```cpp +#include + +struct CustomLock +{ + int cs; // "Critical Section" +}; + +_Acquires_exclusive_lock_(criticalSection->cs) // notice the `->` indirection +void CustomLockAcquire(CustomLock* criticalSection); + +_Releases_lock_(criticalSection->cs) // notice the `->` indirection +void CustomLockRelease(CustomLock* criticalSection); + +CustomLock customLock01; + +_Requires_lock_held_(customLock01) void DoTaskWithCustomLock(); + +void DoTask() +{ + CustomLockAcquire(&customLock01); + DoTaskWithCustomLock(); // C26133 + CustomLockRelease(&customLock01); +} +``` + +In this example, the `DoTask` function is thread-safe and behaves as designed, but that design isn't correctly reflected in the concurrency SAL annotations. Fix by adjusting the annotations on the custom locking functions to use `criticalSection` rather than `criticalSection->cs`. The warning could also be fixed by changing the `_Requires_lock_held_` annotation from `customLock01` to `customLock01.cs`. + +```cpp +#include + +struct CustomLock +{ + int cs; // "Critical Section" +}; + +_Acquires_exclusive_lock_(criticalSection) +void CustomLockAcquire(CustomLock* criticalSection); + +_Releases_lock_(criticalSection) +void CustomLockRelease(CustomLock* criticalSection); + +CustomLock customLock01; + +_Requires_lock_held_(customLock01) void DoTaskWithCustomLock(); + +void DoTask() +{ + CustomLockAcquire(&customLock01); + DoTaskWithCustomLock(); + CustomLockRelease(&customLock01); +} +``` \ No newline at end of file diff --git a/docs/code-quality/c26135.md b/docs/code-quality/c26135.md index bbd4c04054a..aee06179d65 100644 --- a/docs/code-quality/c26135.md +++ b/docs/code-quality/c26135.md @@ -1,15 +1,16 @@ --- +title: "Warning C26135" description: "Learn more about: Warning C26135" -title: Warning C26135 ms.date: 11/04/2016 f1_keywords: ["C26135"] helpviewer_keywords: ["C26135"] -ms.assetid: e9515189-8d21-473b-89f4-8b92ebd3a4f1 --- # Warning C26135 > Missing annotation '*annotation*' at function '*func*'. +## Remarks + Warning C26135 is issued when the analyzer infers that a function is a lock wrapper function that has a "lock acquire" or "lock release" side effect. If the code isn't intended to be a wrapper function, then either the lock is leaking (if it's being acquired), or it's being released incorrectly (if the lock is being released). ## Examples @@ -25,14 +26,14 @@ typedef struct _DATA void MyEnter(DATA* p) { // Warning C26135: - // Missing side effect annotation _Acquires_lock_(&p->cs) + // Missing side effect annotation _Acquires_lock_(p->cs) EnterCriticalSection(&p->cs); } void MyLeave(DATA* p) { // warning C26135: - // Missing side effect annotation _Releases_lock_(&p->cs) + // Missing side effect annotation _Releases_lock_(p->cs) LeaveCriticalSection(&p->cs); } ``` diff --git a/docs/code-quality/c26138.md b/docs/code-quality/c26138.md index 08c847a5b02..12838bac4d8 100644 --- a/docs/code-quality/c26138.md +++ b/docs/code-quality/c26138.md @@ -1,6 +1,6 @@ --- +title: "Warning C26138" description: "Learn more about: Warning C26138" -title: Warning C26138 ms.date: 01/14/2019 f1_keywords: ["C26138", "SUSPENDED_WITH_LOCK"] helpviewer_keywords: ["C26138"] diff --git a/docs/code-quality/c26140.md b/docs/code-quality/c26140.md index dd11953d3e0..33e63f3b518 100644 --- a/docs/code-quality/c26140.md +++ b/docs/code-quality/c26140.md @@ -1,10 +1,9 @@ --- +title: "Warning C26140" description: "Learn more about: Warning C26140" -title: Warning C26140 ms.date: 11/04/2016 f1_keywords: ["C26140"] helpviewer_keywords: ["C26140"] -ms.assetid: a0b521b4-0c2f-470a-8904-f7bbb8014536 --- # Warning C26140 diff --git a/docs/code-quality/c26160.md b/docs/code-quality/c26160.md index 2d8df17126b..9fb21be939c 100644 --- a/docs/code-quality/c26160.md +++ b/docs/code-quality/c26160.md @@ -1,15 +1,16 @@ --- +title: "Warning C26160" description: "Learn more about: Warning C26160" -title: Warning C26160 ms.date: 11/04/2016 f1_keywords: ["C26160"] helpviewer_keywords: ["C26160"] -ms.assetid: e6518687-36b4-4eae-a732-758881638295 --- # Warning C26160 > Caller possibly failing to hold lock '*lock*' before calling function '*func*'. +## Remarks + Warning C26160 resembles warning [C26110](../code-quality/c26110.md) except that the confidence level is lower. For example, the function may contain annotation errors. ## Examples diff --git a/docs/code-quality/c26165.md b/docs/code-quality/c26165.md index 973b4745d96..a87f5b15e94 100644 --- a/docs/code-quality/c26165.md +++ b/docs/code-quality/c26165.md @@ -1,15 +1,16 @@ --- +title: "Warning C26165" description: "Learn more about: Warning C26165" -title: Warning C26165 ms.date: 11/04/2016 f1_keywords: ["C26165"] helpviewer_keywords: ["C26165"] -ms.assetid: a1d89bd6-08f3-4215-8a0c-b8ecfeb0cffc --- # Warning C26165 > Possibly failing to release lock '*lock*' in function '*func*'. +## Remarks + Warning C26165 resembles warning [C26115](../code-quality/c26115.md) except that the confidence level is lower. For example, the function may contain annotation errors. ## Examples diff --git a/docs/code-quality/c26166.md b/docs/code-quality/c26166.md index 04809e0a941..93176e6a086 100644 --- a/docs/code-quality/c26166.md +++ b/docs/code-quality/c26166.md @@ -1,15 +1,16 @@ --- +title: "Warning C26166" description: "Learn more about: Warning C26166" -title: Warning C26166 ms.date: 11/04/2016 f1_keywords: ["C26166"] helpviewer_keywords: ["C26166"] -ms.assetid: a3d21838-07da-40f6-8d2e-1ada72765af2 --- # Warning C26166 > Possibly failing to acquire or to hold lock '*lock*' in function '*func*'. +## Remarks + Warning C26166 resembles warning [C26116](../code-quality/c26116.md) except that the confidence level is lower. For example, the function may contain annotation errors. ## Example diff --git a/docs/code-quality/c26167.md b/docs/code-quality/c26167.md index 8e7eea235ba..24c4e950d2e 100644 --- a/docs/code-quality/c26167.md +++ b/docs/code-quality/c26167.md @@ -1,15 +1,16 @@ --- +title: "Warning C26167" description: "Learn more about: Warning C26167" -title: Warning C26167 ms.date: 11/04/2016 f1_keywords: ["C26167"] helpviewer_keywords: ["C26167"] -ms.assetid: 5a3d767f-31fa-45e0-8c9b-1aa776acaa45 --- # Warning C26167 > Possibly releasing unheld lock '*lock*' in function '*func*'. +## Remarks + Warning C26167 resembles warning [C26117](../code-quality/c26117.md) except that the confidence level is lower. For example, the function may contain annotation errors. ## Examples diff --git a/docs/code-quality/c26400.md b/docs/code-quality/c26400.md index ccdd3a65e3c..e4819ceeaaf 100644 --- a/docs/code-quality/c26400.md +++ b/docs/code-quality/c26400.md @@ -11,7 +11,7 @@ helpviewer_keywords: ["C26400"] ## Remarks -This check helps to enforce the *rule I.11: Never transfer ownership by a raw pointer (T\*), which is a subset of the rule *R.3: A raw pointer (a T\*) is non-owning*. Specifically, it warns on any call to `operator new`, which saves its result in a variable of raw pointer type. It also warns on calls to functions that return `gsl::owner` if their results are assigned to raw pointers. The idea is that you should clearly state ownership of memory resources. For more information, see the [C++ Core Guidelines](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#r-resource-management). +This check helps to enforce the *rule I.11: Never transfer ownership by a raw pointer (T\*), which is a subset of the rule *R.3: A raw pointer (a T\*) is non-owning*. Specifically, it warns on any call to `operator new`, which saves its result in a variable of raw pointer type. It also warns on calls to functions that return `gsl::owner` if their results are assigned to raw pointers. The idea is that you should clearly state ownership of memory resources. For more information, see the [C++ Core Guidelines](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#S-resource). The easiest way to fix this warning is to use **`auto`** declaration if the resource is assigned immediately at the variable declaration. If this fix isn't possible, then we suggest that you use the type `gsl::owner`. The **`auto`** declarations initialized with operator **`new`** are "owners" because we assume that the result of any allocation is implicitly an owner pointer. We transfer this assumption to the **`auto`** variable and treat it as `owner`. diff --git a/docs/code-quality/c26401.md b/docs/code-quality/c26401.md index ef45225be5a..0029e443d56 100644 --- a/docs/code-quality/c26401.md +++ b/docs/code-quality/c26401.md @@ -20,7 +20,7 @@ Code analysis name: `DONT_DELETE_NON_OWNER` ## See also -[C++ Core Guidelines I.11](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#i11-never-transfer-ownership-by-a-raw-pointer-t-or-reference-t) +[C++ Core Guidelines I.11](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Ri-raw) ## Examples @@ -63,7 +63,7 @@ public: ref_count_--; if (ref_count_ == 0) { - [[gsl::suppress(i.11)]] + [[gsl::suppress("i.11")]] delete this; } } diff --git a/docs/code-quality/c26402.md b/docs/code-quality/c26402.md index b79483f914f..d375a3128c5 100644 --- a/docs/code-quality/c26402.md +++ b/docs/code-quality/c26402.md @@ -1,10 +1,9 @@ --- +title: "Warning C26402" description: "Learn more about: Warning C26402 DONT_HEAP_ALLOCATE_MOVABLE_RESULT" -title: Warning C26402 ms.date: 08/20/2020 f1_keywords: ["C26402", "DONT_HEAP_ALLOCATE_MOVABLE_RESULT"] helpviewer_keywords: ["C26402"] -ms.assetid: b9d3d398-697a-4a5d-8bfe-9c667dffb90b --- # Warning C26402 @@ -12,7 +11,7 @@ ms.assetid: b9d3d398-697a-4a5d-8bfe-9c667dffb90b ## Remarks -To avoid confusion about whether a pointer owns an object, a function that returns a movable object should allocate it on the stack. It should then return the object by value instead of returning a heap-allocated object. If pointer semantics are required, return a smart pointer instead of a raw pointer. For more information, see [C++ Core Guidelines R.3](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#Rr-ptr): *Warn if a function returns an object that was allocated within the function but has a move constructor. Suggest considering returning it by value instead.* +To avoid confusion about whether a pointer owns an object, a function that returns a movable object should allocate it on the stack. It should then return the object by value instead of returning a heap-allocated object. If pointer semantics are required, return a smart pointer instead of a raw pointer. For more information, see [C++ Core Guidelines R.3](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Rr-ptr): *Warn if a function returns an object that was allocated within the function but has a move constructor. Suggest considering returning it by value instead.* ## Example @@ -34,7 +33,7 @@ S* bad_example() return s; // C26402 } -// Prefer returning objects with move contructors by value instead of unnecessarily heap-allocating the object. +// Prefer returning objects with move constructors by value instead of unnecessarily heap-allocating the object. S good_example() noexcept { S s; diff --git a/docs/code-quality/c26403.md b/docs/code-quality/c26403.md index 2501899487d..801e33dce9a 100644 --- a/docs/code-quality/c26403.md +++ b/docs/code-quality/c26403.md @@ -12,7 +12,7 @@ ms.assetid: 7e14868d-df86-4df3-98d3-71b1e80ba14e Owner pointers are like unique pointers: they own a resource exclusively, and manage release of the resource, or its transfers to other owners. This check validates that a local owner pointer properly maintains its resource through all execution paths in a function. If the resource wasn't transferred to another owner, or wasn't explicitly release, the checker warns, and points to the declaration of the pointer variable. -For more information, see the [C++ Core Guidelines](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#r-resource-management). +For more information, see the [C++ Core Guidelines](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#S-resource). ## Remarks diff --git a/docs/code-quality/c26405.md b/docs/code-quality/c26405.md index cf14b63ea67..8c8d2b45eb6 100644 --- a/docs/code-quality/c26405.md +++ b/docs/code-quality/c26405.md @@ -12,7 +12,7 @@ ms.assetid: 2034d961-3ec5-4184-bbef-aa792e4c03c0 ## Remarks -If an owner pointer already points to a valid memory buffer, it must not be assigned to another value without releasing its current resource first. Such assignment may lead to a resource leak even if the resource address is copied into some raw pointer (because raw pointers shouldn't release resources). For more information, see the [C++ Core Guidelines](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#r3-a-raw-pointer-a-t-is-non-owning). +If an owner pointer already points to a valid memory buffer, it must not be assigned to another value without releasing its current resource first. Such assignment may lead to a resource leak even if the resource address is copied into some raw pointer (because raw pointers shouldn't release resources). For more information, see the [C++ Core Guidelines](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Rr-ptr). Code analysis name: `DONT_ASSIGN_TO_VALID` diff --git a/docs/code-quality/c26406.md b/docs/code-quality/c26406.md index 1dc0b113bfb..3027afd7284 100644 --- a/docs/code-quality/c26406.md +++ b/docs/code-quality/c26406.md @@ -10,7 +10,7 @@ ms.assetid: 02fb8e23-1989-4e24-a5a5-e30f71d00325 > Do not assign a raw pointer to an `owner` (r.3) -This warning enforces R.3 from the C++ Core Guidelines. For more information, see [C++ Core Guidelines R.3](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#r3-a-raw-pointer-a-t-is-non-owning). +This warning enforces R.3 from the C++ Core Guidelines. For more information, see [C++ Core Guidelines R.3](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Rr-ptr). ## Remarks diff --git a/docs/code-quality/c26407.md b/docs/code-quality/c26407.md index d082e566811..79022356f01 100644 --- a/docs/code-quality/c26407.md +++ b/docs/code-quality/c26407.md @@ -10,7 +10,7 @@ ms.assetid: 5539907a-bfa0-40db-82a6-b860c97209e1 > Prefer scoped objects, don't heap-allocate unnecessarily (r.5) -To avoid unnecessary use of pointers, we try to detect common patterns of local allocations. For example, we detect when the result of a call to operator **`new`** is stored in a local variable and later explicitly deleted. This check supports the [C++ Core Guidelines rule R.5](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#r5-prefer-scoped-objects-dont-heap-allocate-unnecessarily): *Prefer scoped objects, don't heap-allocate unnecessarily*. To fix the issue, use an RAII type instead of a raw pointer, and allow it to deal with resources. Obviously, it isn't necessary to create a wrapper type to allocate a single object. Instead, a local variable of the object's type would work better. +To avoid unnecessary use of pointers, we try to detect common patterns of local allocations. For example, we detect when the result of a call to operator **`new`** is stored in a local variable and later explicitly deleted. This check supports the [C++ Core Guidelines rule R.5](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Rr-scoped): *Prefer scoped objects, don't heap-allocate unnecessarily*. To fix the issue, use an RAII type instead of a raw pointer, and allow it to deal with resources. Obviously, it isn't necessary to create a wrapper type to allocate a single object. Instead, a local variable of the object's type would work better. ## Remarks diff --git a/docs/code-quality/c26408.md b/docs/code-quality/c26408.md index 159c8cbfb03..423b99d972a 100644 --- a/docs/code-quality/c26408.md +++ b/docs/code-quality/c26408.md @@ -22,7 +22,7 @@ Code analysis name: `NO_MALLOC_FREE` ## See also -[C++ Core Guidelines R.10](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#r10-avoid-malloc-and-free) +[C++ Core Guidelines R.10](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Rr-mallocfree) ## Example diff --git a/docs/code-quality/c26409.md b/docs/code-quality/c26409.md index 8939a087764..459ce8cf922 100644 --- a/docs/code-quality/c26409.md +++ b/docs/code-quality/c26409.md @@ -1,10 +1,9 @@ --- -description: "Learn more about CppCoreCheck rule C26409: avoid explicit new and delete." title: Warning C26409 +description: "Learn more about CppCoreCheck rule C26409: avoid explicit new and delete." ms.date: 12/14/2020 f1_keywords: ["C26409", "NO_NEW_DELETE"] helpviewer_keywords: ["C26409"] -ms.assetid: a3b3a229-d566-4be3-bd28-2876ccc8dc37 --- # Warning C26409 @@ -13,7 +12,7 @@ ms.assetid: a3b3a229-d566-4be3-bd28-2876ccc8dc37 Even if code is clean of calls to `malloc` and `free`, we still suggest that you consider better options than explicit use of operators [`new` and `delete`](../cpp/new-and-delete-operators.md). **C++ Core Guidelines**:\ -[R.11: Avoid calling new and delete explicitly](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#r11-avoid-calling-new-and-delete-explicitly) +[R.11: Avoid calling `new` and `delete` explicitly](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Rr-newdelete) The ultimate fix is to use smart pointers and appropriate factory functions, such as [`std::make_unique`](../standard-library/memory-functions.md#make_unique). @@ -49,7 +48,7 @@ public: ref_count_--; if (ref_count_ == 0) { - [[gsl::suppress(i.11)]] + [[gsl::suppress("i.11")]] delete this; } } diff --git a/docs/code-quality/c26410.md b/docs/code-quality/c26410.md index ea77c9e0df1..6a8429c1ec5 100644 --- a/docs/code-quality/c26410.md +++ b/docs/code-quality/c26410.md @@ -10,11 +10,11 @@ ms.assetid: d1547faf-96c6-48da-90f5-841154d0e878 > The parameter '*parameter*' is a reference to const unique pointer, use `const T*` or `const T&` instead (r.32) -Generally, references to const unique pointer are meaningless. They can safely be replaced by a raw reference or a pointer. This warning enforces [C++ Core Guidelines rule R.32](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#r32-take-a-unique_ptrwidget-parameter-to-express-that-a-function-assumes-ownership-of-a-widget). +Generally, references to const unique pointer are meaningless. They can safely be replaced by a raw reference or a pointer. This warning enforces [C++ Core Guidelines rule R.32](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Rr-uniqueptrparam). ## Remarks -- Unique pointer checks have rather broad criteria to identify smart pointers. The [C++ Core Guidelines rule R.31](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#r31-if-you-have-non-std-smart-pointers-follow-the-basic-pattern-from-std): *If you have non-std smart pointers, follow the basic pattern from std describes the unique pointer and shared pointer concepts*. The heuristic is simple, but may lead to surprises: a smart pointer type is any type that defines either `operator->` or `operator*`. A copy-able type (shared pointer) must have either a public copy constructor or an overloaded assignment operator that deals with a non-Rvalue reference parameter. +- Unique pointer checks have rather broad criteria to identify smart pointers. The [C++ Core Guidelines rule R.31](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Rr-smart): *If you have non-std smart pointers, follow the basic pattern from std describes the unique pointer and shared pointer concepts*. The heuristic is simple, but may lead to surprises: a smart pointer type is any type that defines either `operator->` or `operator*`. A copy-able type (shared pointer) must have either a public copy constructor or an overloaded assignment operator that deals with a non-Rvalue reference parameter. - Template code may produce noisy warnings. Keep in mind that templates can be instantiated with various type parameters with different levels of indirection, including references. Some warnings may not be obvious and fixes may require some rework of templates (for example, explicit removal of reference indirection). If template code is intentionally generic, the warning can be suppressed. diff --git a/docs/code-quality/c26411.md b/docs/code-quality/c26411.md index d0ff131460a..cf66a21b4de 100644 --- a/docs/code-quality/c26411.md +++ b/docs/code-quality/c26411.md @@ -10,7 +10,7 @@ ms.assetid: 5134e51e-8b92-4ee7-94c3-022e318a0e24 > The parameter '*parameter*' is a reference to unique pointer and it is never reassigned or reset, use `T*` or `T&` instead (r.33) -When you pass a unique pointer to a function by reference, it implies that its resource may be released or transferred inside the function. If the function uses its parameter only to access the resource, it's safe to pass a raw pointer or a reference. For more information, see [C++ Core Guidelines rule R.33](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#r33-take-a-unique_ptrwidget-parameter-to-express-that-a-function-reseats-thewidget): *Take a unique_ptr\& parameter to express that a function reseats the widget*. +When you pass a unique pointer to a function by reference, it implies that its resource may be released or transferred inside the function. If the function uses its parameter only to access the resource, it's safe to pass a raw pointer or a reference. For more information, see [C++ Core Guidelines rule R.33](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Rr-reseat): *Take a unique_ptr\& parameter to express that a function reseats the widget*. ## Remarks diff --git a/docs/code-quality/c26414.md b/docs/code-quality/c26414.md index 471b69d1d90..704a57d4e80 100644 --- a/docs/code-quality/c26414.md +++ b/docs/code-quality/c26414.md @@ -4,7 +4,6 @@ description: "Reference for Visual Studio C++ Core Guidelines code analysis warn ms.date: 01/29/2020 f1_keywords: ["C26414", "RESET_LOCAL_SMART_PTR"] helpviewer_keywords: ["C26414"] -ms.assetid: dd875d0c-6752-4491-a533-3e8831795fbc --- # Warning C26414 diff --git a/docs/code-quality/c26415.md b/docs/code-quality/c26415.md index 8dfc40ae410..93c445fc29c 100644 --- a/docs/code-quality/c26415.md +++ b/docs/code-quality/c26415.md @@ -11,7 +11,7 @@ ms.assetid: 4165f70a-78ae-4a03-b256-c4bd74b02d09 > Smart pointer parameter is used only to access contained pointer. Use T* or T& instead. **C++ Core Guidelines**: -[R.30](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#r30-take-smart-pointers-as-parameters-only-to-explicitly-express-lifetime-semantics): Take smart pointers as parameters only to explicitly express lifetime semantics +[R.30](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Rr-smartptrparam): Take smart pointers as parameters only to explicitly express lifetime semantics Using a smart pointer type to pass data to a function indicates that the target function needs to manage the lifetime of the contained object. However, say the function only uses the smart pointer to access the contained object and never actually calls any code that may lead to its deallocation (that is, never affects its lifetime). Then there's usually no need to complicate the interface with smart pointers. A plain pointer or reference to the contained object is preferred. diff --git a/docs/code-quality/c26416.md b/docs/code-quality/c26416.md index 1bd6192adc2..c658471dc4d 100644 --- a/docs/code-quality/c26416.md +++ b/docs/code-quality/c26416.md @@ -11,7 +11,7 @@ ms.assetid: f158207b-45cf-44cf-8e4b-b5b75b56ea0e > Shared pointer parameter is passed by rvalue reference. Pass by value instead. **C++ Core Guidelines**: -[R.34](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#r34-take-a-shared_ptrwidget-parameter-to-express-that-a-function-is-part-owner): Take a shared_ptr\ parameter to express that a function is part owner +[R.34](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Rr-sharedptrparam-owner): Take a shared_ptr\ parameter to express shared ownership Passing a shared pointer by rvalue reference is rarely necessary. Unless it's an implementation of move semantics for a shared pointer type itself, shared pointer objects can be safely passed by value. Using rvalue reference may be also an indication that unique pointer is more appropriate since it clearly transfers unique ownership from caller to callee. diff --git a/docs/code-quality/c26417.md b/docs/code-quality/c26417.md index 7659d012506..b8138b42abd 100644 --- a/docs/code-quality/c26417.md +++ b/docs/code-quality/c26417.md @@ -11,7 +11,7 @@ ms.assetid: 0e09fcc6-f9eb-4404-b51e-5815705c6afb > Shared pointer parameter is passed by reference and not reset or reassigned. Use T* or T& instead. **C++ Core Guidelines**: -[R.35](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#r35-take-a-shared_ptrwidget-parameter-to-express-that-a-function-might-reseat-the-shared-pointer): Take a shared_ptr\& parameter to express that a function might reseat the shared pointer +[R.35](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Rr-sharedptrparam): Take a shared_ptr\& parameter to express that a function might reseat the shared pointer Passing shared pointers by reference may be useful in scenarios where called code updates the target of the smart pointer object, and its caller expects to see such updates. Using a reference solely to reduce costs of passing a shared pointer is questionable. If called code only accesses the target object and never manages its lifetime, it's safer to pass a raw pointer or reference, rather than to expose resource management details. diff --git a/docs/code-quality/c26418.md b/docs/code-quality/c26418.md index d1a07d1b8d4..d29c62c8656 100644 --- a/docs/code-quality/c26418.md +++ b/docs/code-quality/c26418.md @@ -11,7 +11,7 @@ ms.assetid: d2c84a40-8a5d-4018-92c2-6498cdd9b541 > Shared pointer parameter is not copied or moved. Use T* or T& instead. **C++ Core Guidelines**: -[R.36](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#r36-take-a-const-shared_ptrwidget-parameter-to-express-that-it-might-retain-a-reference-count-to-the-object-): Take a const shared_ptr\& parameter to express that it might retain a reference count to the object +[R.36](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Rr-sharedptrparam-const): Take a const shared_ptr\& parameter to express that it might retain a reference count to the object If a shared pointer parameter is passed by value or by reference to a constant object, the function is expected to take control of the target object's lifetime without affecting the caller. The code should either copy or move the shared pointer parameter to another shared pointer object, or pass it along to other code by invoking functions that accept shared pointers. Otherwise, a plain pointer or reference may be feasible. diff --git a/docs/code-quality/c26426.md b/docs/code-quality/c26426.md index 818d76d22de..15289f08c7c 100644 --- a/docs/code-quality/c26426.md +++ b/docs/code-quality/c26426.md @@ -12,7 +12,7 @@ ms.assetid: 6fb5f6d2-b097-47f8-8b49-f2fd4e9bef0e ## C++ Core Guidelines -[I.22](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#i22-avoid-complex-initialization-of-global-objects): Avoid complex initialization of global objects +[I.22](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Ri-global-init): Avoid complex initialization of global objects The order of execution of initializers for global objects may be inconsistent or undefined, which can lead to issues that are hard to reproduce and investigate. To avoid such problems, global initializers shouldn't depend on external code that's executed at run time, and that may depend on data that's not yet initialized. This rule flags cases where global objects call functions to obtain their initial values. diff --git a/docs/code-quality/c26427.md b/docs/code-quality/c26427.md index 556e26de751..5586e4d46a4 100644 --- a/docs/code-quality/c26427.md +++ b/docs/code-quality/c26427.md @@ -11,7 +11,7 @@ ms.assetid: 8fb95a44-8704-45b1-bc55-eccd59b1db2f > Global initializer accesses extern object '*symbol*' (i.22) **C++ Core Guidelines**: -[I.22](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#i22-avoid-complex-initialization-of-global-objects): Avoid complex initialization of global objects +[I.22](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Ri-global-init): Avoid complex initialization of global objects Global objects may be initialized in an inconsistent or undefined order, which means that interdependency between them is risky and should be avoided. This guideline is applicable when initializers refer to another object that's considered to be **`extern`**. diff --git a/docs/code-quality/c26429.md b/docs/code-quality/c26429.md index 95435952437..857bffecf9d 100644 --- a/docs/code-quality/c26429.md +++ b/docs/code-quality/c26429.md @@ -11,7 +11,7 @@ ms.assetid: 4e1c74d5-7307-436c-927b-f74ae863282c > Symbol is never tested for nullness, it can be marked as `gsl::not_null`. **C++ Core Guidelines**: -[F.23](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#f23-use-a-not_nullt-to-indicate-that-null-is-not-a-valid-value): Use a `not_null` to indicate that "null" isn't a valid value +[F.23](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Rf-nullptr): Use a `not_null` to indicate that "null" is not a valid value It's a common practice to use asserts to enforce assumptions about the validity of pointer values. The problem is, asserts don't expose assumptions through the interface (such as in return types or parameters). Asserts are also harder to maintain and keep in sync with other code changes. The recommendation is to use `gsl::not_null` from the Guidelines Support Library to mark resources that should never have a null value. The rule `USE_NOTNULL` helps to identify places that omit checks for null and hence can be updated to use `gsl::not_null`. diff --git a/docs/code-quality/c26430.md b/docs/code-quality/c26430.md index 230352b2e9c..92fa6af1ec7 100644 --- a/docs/code-quality/c26430.md +++ b/docs/code-quality/c26430.md @@ -11,7 +11,7 @@ ms.assetid: 3dca2626-8102-4eed-8ff3-73eb3d5c328c > Symbol is not tested for nullness on all paths. **C++ Core Guidelines**: -[F.23](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#f23-use-a-not_nullt-to-indicate-that-null-is-not-a-valid-value): Use a not_null\ to indicate that "null" isn't a valid value +[F.23](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Rf-nullptr): Use a not_null\ to indicate that "null" is not a valid value If code ever checks pointer variables for null, it should do so consistently and validate pointers on all paths. Sometimes overaggressive checking for null is still better than the possibility of a hard crash in one of the complicated branches. Ideally, such code should be refactored to be less complex (by splitting it into multiple functions), and to rely on markers like `gsl::not_null`. These markers allow the code to isolate parts of the algorithm that can make safe assumptions about valid pointer values. The rule `TEST_ON_ALL_PATHS` helps to find places where null checks are inconsistent (meaning assumptions may require review). Or, it finds actual bugs where a potential null value can bypass null checks in some of the code paths. diff --git a/docs/code-quality/c26431.md b/docs/code-quality/c26431.md index 4b78314a6d2..ae48a3ac66d 100644 --- a/docs/code-quality/c26431.md +++ b/docs/code-quality/c26431.md @@ -11,7 +11,7 @@ ms.assetid: 40be6032-c8de-49ab-8e43-e8eedc0ca0ba > The type of expression '*expr*' is already `gsl::not_null`. Do not test it for nullness (f.23) **C++ Core Guidelines**: -[F.23](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#f23-use-a-not_nullt-to-indicate-that-null-is-not-a-valid-value): Use a not_null\ to indicate that "null" isn't a valid value +[F.23](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Rf-nullptr): Use a not_null\ to indicate that "null" is not a valid value The marker type `gsl::not_null` from the Guidelines Support Library is used to clearly indicate values that are never null pointers. It causes a hard failure if the assumption doesn't hold at run time. So, obviously, there's no need to check for null if an expression evaluates to a result of type `gsl::not_null`. diff --git a/docs/code-quality/c26432.md b/docs/code-quality/c26432.md index 51dba4ebdc7..98a45f3475e 100644 --- a/docs/code-quality/c26432.md +++ b/docs/code-quality/c26432.md @@ -4,14 +4,13 @@ description: "Microsoft C++ Code Analysis warning C26432 for the C++ Core Guidel ms.date: 11/15/2017 f1_keywords: ["C26432", "DEFINE_OR_DELETE_SPECIAL_OPS"] helpviewer_keywords: ["C26432"] -ms.assetid: f587b05a-5c69-4176-baa6-fcb79d228b24 --- # Warning C26432 > `If you define or delete any default operation in the type 'type-name', define or delete them all (c.21).` **C++ Core Guidelines**:\ -[C.21: If you define or =delete any default operation, define or =delete them all](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#c21-if-you-define-or-delete-any-default-operation-define-or-delete-them-all) +[C.21: If you define or `=delete` any copy, move, or destructor function, define or `=delete` them all](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Rc-five) Special operations such as constructors are assumed to alter the behavior of types so they rely more on language mechanisms to automatically enforce specific scenarios. The canonical example is resource management. If you explicitly define, default, or delete any of these special operations, it signals you want to avoid any special handling of a type. It's inconsistent to leave the other operations unspecified, that is, implicitly defined as deleted by the compiler. diff --git a/docs/code-quality/c26433.md b/docs/code-quality/c26433.md index ed350b445d3..20d866f966d 100644 --- a/docs/code-quality/c26433.md +++ b/docs/code-quality/c26433.md @@ -1,6 +1,6 @@ --- -description: "Learn more about: Warning C26433 OVERRIDE_EXPLICITLY" title: Warning C26433 +description: "Learn more about: Warning C26433 OVERRIDE_EXPLICITLY" ms.date: 01/18/2017 f1_keywords: ["C26433", "OVERRIDE_EXPLICITLY"] helpviewer_keywords: ["C26433"] @@ -11,7 +11,7 @@ helpviewer_keywords: ["C26433"] ## C++ Core Guidelines -[C.128: Virtual functions should specify exactly one of virtual, override, or final](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md) +[C.128: Virtual functions should specify exactly one of virtual, override, or final](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Rh-override) It's not required by the compiler to clearly state that a virtual function overrides its base. Not specifying `override` can cause subtle issues during maintenance if the virtual specification ever changes in the class hierarchy. It also lowers readability and makes an interface's polymorphic behavior less obvious. If a function is clearly marked as `override`, the compiler can check the consistency of the interface, and help to spot issues before they manifest themselves at run time. @@ -25,7 +25,7 @@ Warnings show up on function definitions, not declarations. It may be confusing, Code analysis name: `OVERRIDE_EXPLICITLY` -## Example: Implicit overriding +## Example: Implicit overriding ```cpp class Shape { @@ -44,4 +44,4 @@ public: ## See also -[C.128: Virtual functions should specify exactly one of virtual, override, or final](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md) +[C.128: Virtual functions should specify exactly one of virtual, override, or final](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Rh-override) diff --git a/docs/code-quality/c26434.md b/docs/code-quality/c26434.md index 7db222af1aa..197a57cbcf8 100644 --- a/docs/code-quality/c26434.md +++ b/docs/code-quality/c26434.md @@ -4,7 +4,6 @@ description: "Microsoft C++ Code Analysis warning C26434 for the C++ Core Guidel ms.date: 08/21/2020 f1_keywords: ["C26434", "DONT_HIDE_METHODS"] helpviewer_keywords: ["C26434"] -ms.assetid: 7f66477f-da66-444a-a6e3-44513d7d7e31 --- # Warning C26434 @@ -12,7 +11,7 @@ ms.assetid: 7f66477f-da66-444a-a6e3-44513d7d7e31 ## C++ Core Guidelines -[C.128: Virtual functions should specify exactly one of virtual, override, or final](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md) +[C.128: Virtual functions should specify exactly one of virtual, override, or final](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Rh-override) ## Remarks @@ -44,5 +43,4 @@ struct Derived : Base void not_virtual() noexcept {} // C26434, hides a non-virtual function virtual void not_virtual(int i) noexcept {} // C26434, and parameters ignored }; - ``` diff --git a/docs/code-quality/c26435.md b/docs/code-quality/c26435.md index ab4ec78c93b..61b57161dc4 100644 --- a/docs/code-quality/c26435.md +++ b/docs/code-quality/c26435.md @@ -11,7 +11,7 @@ helpviewer_keywords: ["C26435"] ## C++ Core Guidelines -[C.128: Virtual functions should specify exactly one of virtual, override, or final](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md) +[C.128: Virtual functions should specify exactly one of virtual, override, or final](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Rh-override) To improve readability, the kind of virtual behavior should be stated clearly and without unnecessary redundancy. Even though multiple virtual specifiers can be used simultaneously, it's better to specify one at a time to emphasize the most important aspect of virtual behavior. The following order of importance is apparent: @@ -49,4 +49,4 @@ public: ## See also -[C.128: Virtual functions should specify exactly one of virtual, override, or final](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md) +[C.128: Virtual functions should specify exactly one of virtual, override, or final](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines) diff --git a/docs/code-quality/c26436.md b/docs/code-quality/c26436.md index 222d58fb205..f2c433854f4 100644 --- a/docs/code-quality/c26436.md +++ b/docs/code-quality/c26436.md @@ -10,7 +10,7 @@ description: CppCoreCheck rule that enforces C++ Core Guidelines C.35 > The type '*symbol*' with a virtual function needs either public virtual or protected non-virtual destructor (c.35) -[**C++ Core Guidelines**: C.35](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#c35-a-base-class-destructor-should-be-either-public-and-virtual-or-protected-and-non-virtual): A base class destructor should be either public and virtual, or protected and nonvirtual +[**C++ Core Guidelines**: C.35](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Rc-dtor-virtual): A base class destructor should be either public and virtual, or protected and non-virtual If a class defines a virtual function it becomes polymorphic, which implies that derived classes can change its behavior including resource management and destruction logic. Because client code may call polymorphic types via pointers to base classes, there's no way a client can explicitly choose which behavior is appropriate without downcasting. To make sure that resources are managed consistently and destruction occurs according to the actual type's rules, you should define a public virtual destructor. If the type hierarchy is designed to disallow client code to destroy objects directly, destructors should be defined as protected non-virtual. diff --git a/docs/code-quality/c26437.md b/docs/code-quality/c26437.md index 5757f17f667..1ec3dbc4327 100644 --- a/docs/code-quality/c26437.md +++ b/docs/code-quality/c26437.md @@ -4,7 +4,6 @@ description: "Learn more about: Warning C26437 DONT_SLICE" ms.date: 05/17/2023 f1_keywords: ["C26437", "DONT_SLICE"] helpviewer_keywords: ["C26437"] -ms.assetid: ed2f55bc-a6d8-4cc4-8069-5c96e581a96a --- # Warning C26437 diff --git a/docs/code-quality/c26438.md b/docs/code-quality/c26438.md index e6c696ca31d..dd7f16b4ebf 100644 --- a/docs/code-quality/c26438.md +++ b/docs/code-quality/c26438.md @@ -11,7 +11,7 @@ ms.assetid: c7b3f59c-fb2f-4816-bda4-0fad23c80d83 > Avoid `goto` (es.76) **C++ Core Guidelines**:\ -[ES.76](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#es76-avoid-goto): Avoid goto +[ES.76](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Res-goto): Avoid goto The use of **`goto`** is widely considered a dangerous and error-prone practice. It's acceptable only in generated code, such as in a parser generated from a grammar. With modern C++ features and utilities provided by the Guidelines Support Library, it should be easy to avoid **`goto`** altogether. diff --git a/docs/code-quality/c26439.md b/docs/code-quality/c26439.md index 68ee27f512f..385f65ca546 100644 --- a/docs/code-quality/c26439.md +++ b/docs/code-quality/c26439.md @@ -4,13 +4,12 @@ description: CppCoreCheck rule C26439 that enforces C++ Core Guidelines F.6 ms.date: 05/17/2023 f1_keywords: ["C26439", "SPECIAL_NOEXCEPT"] helpviewer_keywords: ["C26439"] -ms.assetid: 9df2a1b0-ea94-4884-9d28-c1522ec33a1b --- # Warning C26439 > This kind of function may not throw. Declare it 'noexcept'. -[**C++ Core Guidelines** F.6](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Rf-noexcept): If your function must not throw, declare it `noexcept` +[F.6: If your function must not throw, declare it `noexcept`](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Rf-noexcept) Some operations should never throw exceptions. Their implementations should be reliable and should handle possible errors conditions gracefully. They shouldn't use exceptions to indicate failure. This rule flags cases where such operations aren't explicitly marked as `noexcept`, which means that they may throw exceptions and consumers can't make assumptions about its reliability. @@ -63,5 +62,5 @@ struct S ## See also -[C26455](./c26455.md)\ -[**C++ Core Guidelines** F.6](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Rf-noexcept) \ No newline at end of file +[C26455](c26455.md)\ +[F.6: If your function must not throw, declare it `noexcept`](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Rf-noexcept) diff --git a/docs/code-quality/c26440.md b/docs/code-quality/c26440.md index edeb1db827c..62a9c87e536 100644 --- a/docs/code-quality/c26440.md +++ b/docs/code-quality/c26440.md @@ -10,7 +10,7 @@ description: CppCoreCheck rule C26440 that enforces C++ Core Guidelines F.6 > Function can be declared 'noexcept'. -[**C++ Core Guidelines** F.6](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#f6-if-your-function-may-not-throw-declare-it-noexcept): If your function may not throw, declare it `noexcept` +[**C++ Core Guidelines** F.6](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Rf-noexcept): If your function must not throw, declare it `noexcept` If code isn't supposed to cause any exceptions, it should be marked by using the `noexcept` specifier. This annotation helps to simplify error handling on the client code side, and enables the compiler to do more optimizations. diff --git a/docs/code-quality/c26441.md b/docs/code-quality/c26441.md index 75b08a780d3..a91a41ff873 100644 --- a/docs/code-quality/c26441.md +++ b/docs/code-quality/c26441.md @@ -11,7 +11,7 @@ helpviewer_keywords: ["C26441"] ## C++ Core Guidelines -[CP.44](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#cp44-remember-to-name-your-lock_guards-and-unique_locks): Remember to name your `lock_guard`s and `unique_lock`s +[CP.44: Remember to name your `lock_guard`s and `unique_lock`s](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Rconc-name) ## Remarks diff --git a/docs/code-quality/c26443.md b/docs/code-quality/c26443.md index 090995ebdaf..e07e15b419b 100644 --- a/docs/code-quality/c26443.md +++ b/docs/code-quality/c26443.md @@ -13,7 +13,7 @@ This warning was removed in Visual Studio 16.8 to reflect [changes to C.128 in t ## C++ Core Guidelines -[C.128: Virtual functions should specify exactly one of virtual, override, or final](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md). +[C.128: Virtual functions should specify exactly one of virtual, override, or final](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Rh-override). The current consensus on the Core Guidelines is to exclude destructors from the 'override explicitly' recommendation. @@ -44,4 +44,4 @@ public: ## See also -[C.128: Virtual functions should specify exactly one of virtual, override, or final](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md) +[C.128: Virtual functions should specify exactly one of virtual, override, or final](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Rh-override) diff --git a/docs/code-quality/c26444.md b/docs/code-quality/c26444.md index 86c5a329491..cca16a240be 100644 --- a/docs/code-quality/c26444.md +++ b/docs/code-quality/c26444.md @@ -11,7 +11,7 @@ helpviewer_keywords: ["C26444"] ## C++ Core Guidelines -[ES.84: Don't (try to) declare a local variable with no name](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Res-noname) +[ES.84: Don't try to declare a local variable with no name](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Res-noname) An unnamed variable declaration creates a temporary object that is discarded at the end of the statement. Such temporary objects with nontrivial behavior may point to either inefficient code that allocates and immediately throws away resources or to the code that unintentionally ignores nonprimitive data. Sometimes it may also indicate plainly wrong declaration. @@ -46,4 +46,4 @@ void Foo() ## See also [C26441](C26441.md)\ -[ES.84: Don't (try to) declare a local variable with no name](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Res-noname) +[ES.84: Don't try to declare a local variable with no name](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Res-noname) diff --git a/docs/code-quality/c26445.md b/docs/code-quality/c26445.md index 2602c8bfa53..2269f7e0653 100644 --- a/docs/code-quality/c26445.md +++ b/docs/code-quality/c26445.md @@ -13,7 +13,7 @@ A reference to `gsl::span` or `std::string_view` may be an indication of a lifet ## C++ Core Guidelines -[GSL.view: Views](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#gslview-views) +[GSL.view: Views](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#SS-views) This rule catches subtle lifetime issues that may occur in code migrated from standard containers to new span and view types. Such types can be considered as "references to buffers." Using a reference to a span or view creates an extra layer of indirection. Such indirection is often unnecessary and can be confusing for maintainers. Spans are cheap to copy and can be returned by value from function calls. Obviously, such call results should never be referenced. diff --git a/docs/code-quality/c26446.md b/docs/code-quality/c26446.md index 39091ddfde7..c8e7f37213f 100644 --- a/docs/code-quality/c26446.md +++ b/docs/code-quality/c26446.md @@ -9,7 +9,7 @@ helpviewer_keywords: ["C26446"] > Prefer to use gsl::at() instead of unchecked subscript operator (bounds.4). -C++ Core Guidelines: [Bounds.4: Don't use standard-library functions and types that are not bounds-checked](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#probounds-bounds-safety-profile). +C++ Core Guidelines: [Bounds.4: Don't use standard-library functions and types that are not bounds-checked](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#SS-bounds). ## Remarks diff --git a/docs/code-quality/c26447.md b/docs/code-quality/c26447.md index 8c4c2ef8202..1835053be83 100644 --- a/docs/code-quality/c26447.md +++ b/docs/code-quality/c26447.md @@ -10,7 +10,7 @@ helpviewer_keywords: ["C26447"] > The function is declared `noexcept` but calls function *function_name* that may throw exceptions (f.6). C++ Core Guidelines:\ -[F.6: If your function may not throw, declare it noexcept](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#f6-if-your-function-may-not-throw-declare-it-noexcept). +[F.6: If your function must not throw, declare it noexcept](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Rf-noexcept). ## Remarks diff --git a/docs/code-quality/c26448.md b/docs/code-quality/c26448.md index 6173ec82b55..3da19b9eca0 100644 --- a/docs/code-quality/c26448.md +++ b/docs/code-quality/c26448.md @@ -9,7 +9,7 @@ helpviewer_keywords: ["C26448"] > Consider using `gsl::finally` if final action is intended (gsl.util) -C++ Core Guidelines: [GSL.util: Utilities](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#SS-utilities) +C++ Core Guidelines: [GSL.util: Utilities](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#SS-utilities) The Guidelines Support Library provides a convenient utility to implement the *final action* concept. Since the C++ language doesn't support **try-finally** constructs, it became common to implement custom cleanup types that would invoke arbitrary actions on destruction. The `gsl::finally` utility is implemented in this way and provides a more uniform way to perform final actions across a code base. diff --git a/docs/code-quality/c26450.md b/docs/code-quality/c26450.md index ec01abc830e..2f4d1f351da 100644 --- a/docs/code-quality/c26450.md +++ b/docs/code-quality/c26450.md @@ -43,8 +43,8 @@ long long multiply() ## See also -[26451](c26451.md)\ -[26452](c26452.md)\ -[26453](c26453.md)\ -[26454](c26454.md)\ +[C26451](c26451.md)\ +[C26452](c26452.md)\ +[C26453](c26453.md)\ +[C26454](c26454.md)\ [ES.103: Don't overflow](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Res-overflow) diff --git a/docs/code-quality/c26451.md b/docs/code-quality/c26451.md index 725ce91a6c6..3a2246a977b 100644 --- a/docs/code-quality/c26451.md +++ b/docs/code-quality/c26451.md @@ -45,8 +45,8 @@ void leftshift(int i) noexcept ## See also -[26450](c26450.md)\ -[26452](c26452.md)\ -[26453](c26453.md)\ -[26454](c26454.md)\ -[ES.103: Don't overflow](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#Res-overflow) +[C26450](c26450.md)\ +[C26452](c26452.md)\ +[C26453](c26453.md)\ +[C26454](c26454.md)\ +[ES.103: Don't overflow](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Res-overflow) diff --git a/docs/code-quality/c26452.md b/docs/code-quality/c26452.md index d6f004eaa57..14a7f7d7279 100644 --- a/docs/code-quality/c26452.md +++ b/docs/code-quality/c26452.md @@ -37,9 +37,9 @@ unsigned long long combine(unsigned lo, unsigned hi) ## See also -[26450](c26450.md)\ -[26451](c26451.md)\ -[26453](c26453.md)\ -[26454](c26454.md)\ +[C26450](c26450.md)\ +[C26451](c26451.md)\ +[C26453](c26453.md)\ +[C26454](c26454.md)\ [ES.101: Use unsigned types for bit manipulation](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Res-unsigned)\ [ES.102: Use signed types for arithmetic](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Res-signed) diff --git a/docs/code-quality/c26453.md b/docs/code-quality/c26453.md index 7012f697ae8..f7a44f29ab0 100644 --- a/docs/code-quality/c26453.md +++ b/docs/code-quality/c26453.md @@ -39,9 +39,9 @@ void leftshift(int shiftCount) ## See also -[26450](c26450.md)\ -[26451](c26451.md)\ -[26452](c26452.md)\ -[26454](c26454.md)\ +[C26450](c26450.md)\ +[C26451](c26451.md)\ +[C26452](c26452.md)\ +[C26454](c26454.md)\ [ES.101: Use unsigned types for bit manipulation](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Res-unsigned)\ [ES.102: Use signed types for arithmetic](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Res-signed) diff --git a/docs/code-quality/c26454.md b/docs/code-quality/c26454.md index 15940afe9ec..59e6c58c517 100644 --- a/docs/code-quality/c26454.md +++ b/docs/code-quality/c26454.md @@ -1,6 +1,6 @@ --- -description: "Learn more about: Arithmetic overflow: 'operator' operation produces a negative unsigned result at compile time" title: Warning C26454 +description: "Learn more about: Arithmetic overflow: 'operator' operation produces a negative unsigned result at compile time" ms.date: 01/08/2017 f1_keywords: ["C26454", "RESULT_OF_ARITHMETIC_OPERATION_NEGATIVE_UNSIGNED"] helpviewer_keywords: ["C26454"] @@ -37,8 +37,8 @@ unsigned int negativeunsigned() ## See also -[26450](c26450.md)\ -[26451](c26451.md)\ -[26452](c26452.md)\ -[26453](c26453.md)\ -[ES.106: Don't try to avoid negative values by using unsigned](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Res-nonnegative) +[C26450](c26450.md)\ +[C26451](c26451.md)\ +[C26452](c26452.md)\ +[C26453](c26453.md)\ +[ES.106: Don't try to avoid negative values by using `unsigned`](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Res-nonnegative) diff --git a/docs/code-quality/c26455.md b/docs/code-quality/c26455.md index ca27f3e0e2b..756871cae8f 100644 --- a/docs/code-quality/c26455.md +++ b/docs/code-quality/c26455.md @@ -4,7 +4,6 @@ description: "Learn more about the C26455 DEFAULT_CTOR_NOEXCEPT" ms.date: 04/29/2022 f1_keywords: ["C26455", "DEFAULT_CTOR_NOEXCEPT"] helpviewer_keywords: ["C26455"] -ms.assetid: 27e86063-d969-49d8-8912-dcc2dc57249f author: kylereedmsft ms.author: kylereed ms.custom: kr2b-contr-experiment @@ -24,4 +23,4 @@ Code analysis name: `DEFAULT_CTOR_NOEXCEPT` ## See also [C26439](./c26439.md)\ -[**C++ Core Guidelines** F.6](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Rf-noexcept) +[F.6: If your function must not throw, declare it `noexcept`](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Rf-noexceptt) diff --git a/docs/code-quality/c26456.md b/docs/code-quality/c26456.md index 0abedce51bc..74456141ad6 100644 --- a/docs/code-quality/c26456.md +++ b/docs/code-quality/c26456.md @@ -21,4 +21,4 @@ Code analysis name: `DONT_HIDE_OPERATORS` ## See also -[C++ Core Guideline c.128](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#c128-virtual-functions-should-specify-exactly-one-of-virtual-override-or-final) +[C++ Core Guideline c.128](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Rh-override) diff --git a/docs/code-quality/c26457.md b/docs/code-quality/c26457.md index e1a5560feb9..17430f18309 100644 --- a/docs/code-quality/c26457.md +++ b/docs/code-quality/c26457.md @@ -11,7 +11,7 @@ helpviewer_keywords: ["C26457"] ## Remarks -Excerpt from the [C++ Core Guideline ES.48](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#es48-avoid-casts): +Excerpt from the [C++ Core Guideline ES.48](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Res-casts): > Never cast to `(void)` to ignore a `[[nodiscard]]` return value. If you deliberately want to discard such a result, first think hard about whether that is really a good idea (there is usually a good reason the author of the function or of the return type used `[[nodiscard]]` in the first place). If you still think it's appropriate and your code reviewer agrees, use `std::ignore =` to turn off the warning which is simple, portable, and easy to grep. diff --git a/docs/code-quality/c26460.md b/docs/code-quality/c26460.md index 2307b0d5928..008786d1a01 100644 --- a/docs/code-quality/c26460.md +++ b/docs/code-quality/c26460.md @@ -39,4 +39,4 @@ void Function2(MyStruct& myStruct) ## See also -[C++ Core Guidelines con.3](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#Rconst-ref). +[C++ Core Guidelines con.3](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Rconst-ref). diff --git a/docs/code-quality/c26461.md b/docs/code-quality/c26461.md index 85cd180b56f..eb18934fd4d 100644 --- a/docs/code-quality/c26461.md +++ b/docs/code-quality/c26461.md @@ -45,4 +45,4 @@ void Function2(MyStruct* myStruct) ## See also -[C++ Core Guidelines con.3](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#Rconst-ref). +[C++ Core Guidelines con.3](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Rconst-ref). diff --git a/docs/code-quality/c26462.md b/docs/code-quality/c26462.md index f39a230769a..8f9adfd83d4 100644 --- a/docs/code-quality/c26462.md +++ b/docs/code-quality/c26462.md @@ -31,4 +31,4 @@ void function1(int* ptr) ## See also -[C++ Core Guidelines con.4](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#con4-use-const-to-define-objects-with-values-that-do-not-change-after-construction). +[C++ Core Guidelines con.4](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Rconst-const). diff --git a/docs/code-quality/c26463.md b/docs/code-quality/c26463.md index a23cd9d028f..1da69c4f32e 100644 --- a/docs/code-quality/c26463.md +++ b/docs/code-quality/c26463.md @@ -17,4 +17,4 @@ Code analysis name: `USE_CONST_FOR_ELEMENTS` ## See also -[C++ Core Guidelines con.4](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#con4-use-const-to-define-objects-with-values-that-do-not-change-after-construction). +[C++ Core Guidelines con.4](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Rconst-const). diff --git a/docs/code-quality/c26464.md b/docs/code-quality/c26464.md index c96634aba1a..aa5d02d1284 100644 --- a/docs/code-quality/c26464.md +++ b/docs/code-quality/c26464.md @@ -17,4 +17,4 @@ Code analysis name: `USE_CONST_POINTER_FOR_ELEMENTS` ## See also -[C++ Core Guidelines con.4](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#con4-use-const-to-define-objects-with-values-that-do-not-change-after-construction). +[C++ Core Guidelines con.4](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Rconst-const). diff --git a/docs/code-quality/c26465.md b/docs/code-quality/c26465.md index d6b7fa8316e..1ca3fee5d14 100644 --- a/docs/code-quality/c26465.md +++ b/docs/code-quality/c26465.md @@ -11,7 +11,7 @@ description: CppCoreCheck rule C26465 that enforces C++ Core Guidelines Type.3 ## See also -[C++ Core Guidelines Type.3](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#Pro-type-constcast) +[C++ Core Guidelines Type.3](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Pro-type-constcast) ## Example diff --git a/docs/code-quality/c26466.md b/docs/code-quality/c26466.md index 13c4d70db42..786d95159bc 100644 --- a/docs/code-quality/c26466.md +++ b/docs/code-quality/c26466.md @@ -11,7 +11,7 @@ description: CppCoreCheck rule that enforces C++ Core Guidelines Type.2 ## See also -[C++ Core Guidelines Type.2](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#Pro-type-downcast) +[C++ Core Guidelines Type.2](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Pro-type-downcast) ## Example diff --git a/docs/code-quality/c26471.md b/docs/code-quality/c26471.md index e525394288a..f44d8335af7 100644 --- a/docs/code-quality/c26471.md +++ b/docs/code-quality/c26471.md @@ -29,4 +29,4 @@ void function(void* pValue) ## See also -[C++ Core Guidelines Type.1](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#Pro-type-reinterpretcast) +[C++ Core Guidelines Type.1](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Pro-type-reinterpretcast) diff --git a/docs/code-quality/c26472.md b/docs/code-quality/c26472.md index 3a18f09f0e8..67a2f80fd15 100644 --- a/docs/code-quality/c26472.md +++ b/docs/code-quality/c26472.md @@ -11,7 +11,7 @@ ms.assetid: 51e215a7-0e0a-4e6c-bff1-805bf5b1af29 > Don't use a static_cast for arithmetic conversions. Use brace initialization, `gsl::narrow_cast`, or `gsl::narrow`. **C++ Core Guidelines**: -[Type.1](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#prosafety-type-safety-profile): Avoid casts +[Type.1](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Pro-type-arithmeticcast): Avoid casts This rule helps to find places where static casts are used to convert between integral types. These casts are unsafe because the compiler wouldn't warn if any data loss occurs. Brace initializers are better for the cases where constants are used, and a compiler error is desired. There are also utilities from the Guidelines Support Library that help to describe intentions clearly: diff --git a/docs/code-quality/c26473.md b/docs/code-quality/c26473.md index 6ff7913be8b..410129d326e 100644 --- a/docs/code-quality/c26473.md +++ b/docs/code-quality/c26473.md @@ -11,7 +11,7 @@ ms.assetid: d88aaa57-0003-421f-8377-4e6a5c27f2df > Don't cast between pointer types where the source type and the target type are the same. **C++ Core Guidelines**: -[Type.1](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#prosafety-type-safety-profile): Avoid casts +[Type.1](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Pro-type-identitycast): Avoid casts This rule helps to remove unnecessary or suspicious casts. Obviously, when a type is converted to itself, such a conversion is ineffective. Yet the fact that the cast is used may indicate a subtle design issue or a potential for regression if types change in future. It's always safer to use as few casts as possible. diff --git a/docs/code-quality/c26474.md b/docs/code-quality/c26474.md index 30fbf70beff..fd62d069f68 100644 --- a/docs/code-quality/c26474.md +++ b/docs/code-quality/c26474.md @@ -11,7 +11,7 @@ ms.assetid: 1e23a8e6-97fa-47f5-a279-b52aa2efafa4 > Don't cast between pointer types when the conversion could be implicit. **C++ Core Guidelines**:\ -[Type.1](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#prosafety-type-safety-profile): Avoid casts +[Type.1](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Pro-type-implicitpointercast): Avoid casts In some cases, implicit casts between pointer types are safe and don't require you to write a specific cast expression. This rule finds instances of unnecessary casts you can safely remove. diff --git a/docs/code-quality/c26475.md b/docs/code-quality/c26475.md index b3856c661f1..b44baae8a8e 100644 --- a/docs/code-quality/c26475.md +++ b/docs/code-quality/c26475.md @@ -11,7 +11,7 @@ ms.assetid: 4ed71cf8-f155-4961-b4fe-77feb3b880c3 > Do not use function style C-casts. **C++ Core Guidelines**: -[ES.49](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#es49-if-you-must-use-a-cast-use-a-named-cast): If you must use a cast, use a named cast +[ES.49](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Res-casts-named): If you must use a cast, use a named cast Function-style casts (for example, `int(1.1)`) are another form of C-style casts (like `(int)1.1`), which have questionable safety. Specifically, the compiler doesn't try to check if any data loss can occur either in C-casts or in function casts. In both cases, it's better either to avoid casting or to use a braced initializer if possible. If neither works, static casts may be suitable, but it's still better to use utilities from the Guidelines Support Library: diff --git a/docs/code-quality/c26476.md b/docs/code-quality/c26476.md index d942009432a..b07cb80eeab 100644 --- a/docs/code-quality/c26476.md +++ b/docs/code-quality/c26476.md @@ -21,4 +21,4 @@ Code analysis name: `USE_VARIANT` ## See also -[C++ Core Guideline C.181](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#Ru-naked) +[C++ Core Guideline C.181](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Ru-naked) diff --git a/docs/code-quality/c26477.md b/docs/code-quality/c26477.md index fe713f5618e..7da0611abfa 100644 --- a/docs/code-quality/c26477.md +++ b/docs/code-quality/c26477.md @@ -21,4 +21,4 @@ Code analysis name: `USE_NULLPTR_NOT_CONSTANT` ## See also -[C++ Core Guideline ES.47](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#Res-nullptr) +[C++ Core Guideline ES.47](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Res-nullptr) diff --git a/docs/code-quality/c26478.md b/docs/code-quality/c26478.md index e9c680bfadf..47dc1d62bf3 100644 --- a/docs/code-quality/c26478.md +++ b/docs/code-quality/c26478.md @@ -1,6 +1,6 @@ --- -description: "Learn more about: Warning C26478: Don't use std::move on constant variables. (es.56)" title: Warning C26478 +description: "Learn more about: Warning C26478: Don't use std::move on constant variables. (es.56)" ms.date: 10/12/2023 f1_keywords: ["C26478", "NO_MOVE_OP_ON_CONST"] helpviewer_keywords: ["C26478"] @@ -37,4 +37,4 @@ To fix the issue, remove the redundant `std::move`. ## See also -[ES.56 - Write `std::move()` only when you need to explicitly move an object to another scope](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Res-move) +[ES.56: Write `std::move()` only when you need to explicitly move an object to another scope](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Res-move) diff --git a/docs/code-quality/c26479.md b/docs/code-quality/c26479.md index 336a12c33b4..130adb11af8 100644 --- a/docs/code-quality/c26479.md +++ b/docs/code-quality/c26479.md @@ -1,6 +1,6 @@ --- -description: "Learn more about: Warning C26479: Don't use std::move to return a local variable. (f.48)" title: Warning C26479 +description: "Learn more about: Warning C26479: Don't use std::move to return a local variable. (f.48)" ms.date: 10/12/2023 f1_keywords: ["C26479", "NO_MOVE_RET_ON_LOCALS"] helpviewer_keywords: ["C26479"] @@ -38,5 +38,5 @@ S foo() ## See also -[F.48 - Don't return `std::move(local)`](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Rf-return-move-local) -[ES.56 - Write `std::move()` only when you need to explicitly move an object to another scope](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Res-move) +[F.48: Don't `return std::move(local)`](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Rf-return-move-local)\ +[ES.56: Write `std::move()` only when you need to explicitly move an object to another scope](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Res-move) diff --git a/docs/code-quality/c26481.md b/docs/code-quality/c26481.md index 051b2c96ee5..31249a98f10 100644 --- a/docs/code-quality/c26481.md +++ b/docs/code-quality/c26481.md @@ -12,11 +12,11 @@ ms.assetid: 4fd8694d-b45b-4163-b2d5-88c4889d00ed ## Remarks -This check supports the [C++ Core Guidelines](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md) rule [I.13](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#Ri-array): *Do not pass an array as a single pointer*. Whenever raw pointers are used in arithmetic operations they should be replaced with safer kinds of buffers, such as `span` or `vector`. +This check supports the [C++ Core Guidelines](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines) rule [I.13](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Ri-array): *Do not pass an array as a single pointer*. Whenever raw pointers are used in arithmetic operations they should be replaced with safer kinds of buffers, such as `span` or `vector`. This check is more restrictive than I.13: it doesn't skip `zstring` or `czstring` types. -C26481 and [C26485](c26485.md) come from the [Bounds Safety Profile](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#SS-bounds) rules. These rules were implemented in the first release of the C++ Core Guidelines Checker. They're applicable to the raw pointers category since they help to avoid unsafe use of raw pointers. +C26481 and [C26485](c26485.md) come from the [Bounds Safety Profile](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#SS-bounds) rules. These rules were implemented in the first release of the C++ Core Guidelines Checker. They're applicable to the raw pointers category since they help to avoid unsafe use of raw pointers. ## Example diff --git a/docs/code-quality/c26482.md b/docs/code-quality/c26482.md index e360a51d10e..9fafb3b9124 100644 --- a/docs/code-quality/c26482.md +++ b/docs/code-quality/c26482.md @@ -11,7 +11,7 @@ description: CppCoreCheck rule C26482 that enforces C++ Core Guidelines Bounds.2 ## See also -[C++ Core Guidelines Bounds.2](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#SS-bounds) +[C++ Core Guidelines Bounds.2](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Pro-bounds-arrayindex) ## Example diff --git a/docs/code-quality/c26483.md b/docs/code-quality/c26483.md index ea4c10c6b9d..45fb0f24716 100644 --- a/docs/code-quality/c26483.md +++ b/docs/code-quality/c26483.md @@ -1,9 +1,9 @@ --- title: Warning C26483 +description: CppCoreCheck rule C26483 that enforces C++ Core Guidelines Bounds.2 ms.date: 03/22/2018 f1_keywords: ["C26483", "STATIC_INDEX_OUT_OF_RANGE"] helpviewer_keywords: ["C26483"] -description: CppCoreCheck rule C26483 that enforces C++ Core Guidelines Bounds.2 --- # Warning C26483 @@ -11,7 +11,7 @@ description: CppCoreCheck rule C26483 that enforces C++ Core Guidelines Bounds.2 ## See also -[C++ Core Guidelines Bounds.2](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#SS-bounds) +[C++ Core Guidelines Bounds.2](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Pro-bounds-arrayindex) ## Example @@ -24,5 +24,4 @@ void function() int arr2[] { 1, 2, 3 }; arr2[3] = 4; // C26483, 3 is outside the bounds of the array } - ``` diff --git a/docs/code-quality/c26485.md b/docs/code-quality/c26485.md index e0aa010236d..ef77b057905 100644 --- a/docs/code-quality/c26485.md +++ b/docs/code-quality/c26485.md @@ -12,9 +12,9 @@ ms.assetid: 8915ad2d-7fd6-4bbc-abe4-0b3292ea2170 ## Remarks -Like [C26481](c26481.md), this check helps to enforce the [C++ Core Guidelines](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md) rule [I.13](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#Ri-array): *Do not pass an array as a single pointer*. The rule detects places where static array type information is lost from decay to a raw pointer. The `zstring` and `czstring` types aren't excluded. +Like [C26481](c26481.md), this check helps to enforce the [C++ Core Guidelines](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines) rule [I.13](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Ri-array): *Do not pass an array as a single pointer*. The rule detects places where static array type information is lost from decay to a raw pointer. The `zstring` and `czstring` types aren't excluded. -C26481 and C26485 come from the [Bounds Safety Profile](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#SS-bounds) rules. These rules were implemented in the first release of the C++ Core Guidelines Checker. They're applicable to the raw pointers category since they help to avoid unsafe use of raw pointers. +C26481 and C26485 come from the [Bounds Safety Profile](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#SS-bounds) rules. These rules were implemented in the first release of the C++ Core Guidelines Checker. They're applicable to the raw pointers category since they help to avoid unsafe use of raw pointers. ## Example diff --git a/docs/code-quality/c26488.md b/docs/code-quality/c26488.md index b3ae0ce8885..a54608facb9 100644 --- a/docs/code-quality/c26488.md +++ b/docs/code-quality/c26488.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Warning C26488 LIFETIMES_DEREF_NULL_POINTER" title: Warning C26488 +description: "Learn more about: Warning C26488 LIFETIMES_DEREF_NULL_POINTER" ms.date: 12/14/2018 f1_keywords: ["C26488", "LIFETIMES_DEREF_NULL_POINTER"] helpviewer_keywords: ["C26488"] -ms.assetid: 2ade0d31-f259-49de-8676-cce6092fabfc author: kylereedmsft ms.author: kylereed --- @@ -28,9 +27,9 @@ void ex1() The Lifetime guidelines from the C++ core guidelines outline a contract that code can follow which will enable more thorough static memory leak and dangling pointer detection. The basic ideas behind the guidelines are: -1) Never dereference an invalid (dangling) or known-null pointer -2) Never return (either formal return or out parameter) any pointer from a function. -3) Never pass an invalid (dangling) pointer to any function. +1. Never dereference an invalid (dangling) or known-null pointer. +1. Never return (either formal return or out parameter) any pointer from a function. +1. Never pass an invalid (dangling) pointer to any function. ## See also diff --git a/docs/code-quality/c26489.md b/docs/code-quality/c26489.md index 2f252dc7665..85df9e569a0 100644 --- a/docs/code-quality/c26489.md +++ b/docs/code-quality/c26489.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Warning C26489 LIFETIMES_DEREF_INVALID_POINTER" title: Warning C26489 +description: "Learn more about: Warning C26489 LIFETIMES_DEREF_INVALID_POINTER" ms.date: 12/14/2018 f1_keywords: ["C26489", "LIFETIMES_DEREF_INVALID_POINTER"] helpviewer_keywords: ["C26489"] -ms.assetid: 15983d4f-f615-42e7-8521-ee094b87d066 author: kylereedmsft ms.author: kylereed --- @@ -30,9 +29,9 @@ int ex1() The Lifetime guidelines from the C++ core guidelines outline a contract that code can follow which will enable more thorough static memory leak and dangling pointer detection. The basic ideas behind the guidelines are: -1) Never dereference an invalid (dangling) or known-null pointer -2) Never return (either formal return or out parameter) any pointer from a function. -3) Never pass an invalid (dangling) pointer to any function. +1. Never dereference an invalid (dangling) or known-null pointer. +1. Never return (either formal return or out parameter) any pointer from a function. +1. Never pass an invalid (dangling) pointer to any function. ## See also diff --git a/docs/code-quality/c26490.md b/docs/code-quality/c26490.md index 48e766138e9..141a6a19411 100644 --- a/docs/code-quality/c26490.md +++ b/docs/code-quality/c26490.md @@ -11,7 +11,7 @@ description: CppCoreCheck rule C26490 that enforces C++ Core Guidelines Type.1 ## See also -[C++ Core Guidelines Type.1](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#SS-type). +[C++ Core Guidelines Type.1](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Pro-type-reinterpretcast). ## Example diff --git a/docs/code-quality/c26491.md b/docs/code-quality/c26491.md index b55c5b0f320..109c4dae5aa 100644 --- a/docs/code-quality/c26491.md +++ b/docs/code-quality/c26491.md @@ -7,4 +7,4 @@ helpviewer_keywords: ["C26491"] --- # Warning C26491 -> Don't use `static_cast` downcasts. See [C++ Core Guidelines Type.2](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#SS-type). +> Don't use `static_cast` downcasts. See [C++ Core Guidelines Type.2](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Pro-type-downcast). diff --git a/docs/code-quality/c26492.md b/docs/code-quality/c26492.md index 2e6ede538f2..33735543dcd 100644 --- a/docs/code-quality/c26492.md +++ b/docs/code-quality/c26492.md @@ -11,7 +11,7 @@ description: CppCoreCheck rule C26492 that enforces C++ Core Guidelines Type.3 ## See also -[C++ Core Guidelines Type.3](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#SS-type). +[C++ Core Guidelines Type.3](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Pro-type-constcast). ## Example diff --git a/docs/code-quality/c26493.md b/docs/code-quality/c26493.md index 34d7225070b..c67d9ffdd55 100644 --- a/docs/code-quality/c26493.md +++ b/docs/code-quality/c26493.md @@ -11,7 +11,7 @@ description: CppCoreCheck rule that enforces C++ Core Guidelines Type.4 ## See also -[C++ Core Guidelines Type.4](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#SS-type). +[C++ Core Guidelines Type.4](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Pro-type-cstylecast). ## Example diff --git a/docs/code-quality/c26494.md b/docs/code-quality/c26494.md index 100acee105a..447b03a4c41 100644 --- a/docs/code-quality/c26494.md +++ b/docs/code-quality/c26494.md @@ -38,4 +38,4 @@ void function() ## See also [ES.20: Always initialize an object](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Res-always)\ -[C++ Core Guidelines Type.5](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#prosafety-type-safety-profile) +[Pro.safety: Type-safety profile](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#SS-type) diff --git a/docs/code-quality/c26495.md b/docs/code-quality/c26495.md index f99e5697b84..5bfc3c16854 100644 --- a/docs/code-quality/c26495.md +++ b/docs/code-quality/c26495.md @@ -11,7 +11,7 @@ helpviewer_keywords: ["C26495"] ## Remarks -A member variable isn't initialized by a constructor or by an initializer. Make sure all variables are initialized by the end of construction. For more information, see C++ Core Guidelines [Type.6](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#SS-type) and [C.48](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#c48-prefer-in-class-initializers-to-member-initializers-in-constructors-for-constant-initializers). +A member variable isn't initialized by a constructor or by an initializer. Make sure all variables are initialized by the end of construction. For more information, see C++ Core Guidelines [Type.6](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Pro-type-memberinit) and [C.48](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Rc-in-class-initializer). This check is intra-procedural. Whenever there's a function call to a nonconst member function, the check assumes that this member function initializes all of the members. This heuristic can result in missed errors and is in place to avoid false positive results. Moreover, when a member is passed by nonconst reference to a function, the check assumes that the function initializes the member. diff --git a/docs/code-quality/c26496.md b/docs/code-quality/c26496.md index b5ad5763283..9fd6800df5a 100644 --- a/docs/code-quality/c26496.md +++ b/docs/code-quality/c26496.md @@ -11,7 +11,7 @@ description: CppCoreCheck rule C26496 that enforces C++ Core Guidelines Con.4 ## See also -[C++ Core Guidelines con.4](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#con4-use-const-to-define-objects-with-values-that-do-not-change-after-construction). +[C++ Core Guidelines con.4](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Rconst-const). ## Example diff --git a/docs/code-quality/c26497.md b/docs/code-quality/c26497.md index 7a7cd3fc6cc..36b52d3bfea 100644 --- a/docs/code-quality/c26497.md +++ b/docs/code-quality/c26497.md @@ -11,7 +11,7 @@ description: CppCoreCheck rule that enforces C++ Core Guidelines F.4 ## See also -[C++ Core Guidelines F.4](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#Rf-constexpr). +[C++ Core Guidelines F.4](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Rf-constexpr). ## Example diff --git a/docs/code-quality/c26498.md b/docs/code-quality/c26498.md index 8277d9601cb..7bb0edb9750 100644 --- a/docs/code-quality/c26498.md +++ b/docs/code-quality/c26498.md @@ -1,5 +1,5 @@ --- -title: Warning C26498 +title: "Warning C26498" description: "Learn more about: Warning C26498 USE_CONSTEXPR_FOR_FUNCTIONCALL" ms.date: 08/18/2020 f1_keywords: ["C26498", "USE_CONSTEXPR_FOR_FUNCTIONCALL"] @@ -9,7 +9,7 @@ helpviewer_keywords: ["C26498"] > The function '*function*' is constexpr, mark variable '*variable*' constexpr if compile-time evaluation is desired (con.5) -This rule helps to enforce Con.5 from the [C++ Core Guidelines](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Rconst-constexpr): use constexpr for values that can be computed at compile time. +This rule helps to enforce [Con.5: Use `constexpr` for values that can be computed at compile time](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Rconst-constexpr) in the C++ Core Guidelines. ## Remarks @@ -58,6 +58,6 @@ void foo() ## See also -[C26497](./c26407.md)\ -[C26814](./c26814.md)\ -[Con.5](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Rconst-constexpr) \ No newline at end of file +[C26497](c26497.md)\ +[C26814](c26814.md)\ +[Con.5: Use `constexpr` for values that can be computed at compile time](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Rconst-constexpr) diff --git a/docs/code-quality/c26800.md b/docs/code-quality/c26800.md index 1052f0f0db6..81d9a17805f 100644 --- a/docs/code-quality/c26800.md +++ b/docs/code-quality/c26800.md @@ -1,5 +1,5 @@ --- -title: Warning C26800 +title: "Warning C26800" description: "Learn more about: Warning C26800" ms.date: 01/14/2019 f1_keywords: ["C26800", "USE_OF_A_MOVED_FROM_OBJECT"] diff --git a/docs/code-quality/c26810.md b/docs/code-quality/c26810.md index 95c9c836440..027f55e32eb 100644 --- a/docs/code-quality/c26810.md +++ b/docs/code-quality/c26810.md @@ -1,5 +1,5 @@ --- -title: Warning C26810 +title: "Warning C26810" description: "Learn more about: Warning C26810." ms.date: 05/11/2023 f1_keywords: ["C26810", "COROUTINES_USE_AFTER_FREE_CAPTURE"] diff --git a/docs/code-quality/c26811.md b/docs/code-quality/c26811.md index ebdc5bcc40c..7651fbbf469 100644 --- a/docs/code-quality/c26811.md +++ b/docs/code-quality/c26811.md @@ -1,5 +1,5 @@ --- -title: Warning C26811 +title: "Warning C26811" description: "Learn more about: Warning C26811." ms.date: 05/11/2023 f1_keywords: ["C26811", "COROUTINES_USE_AFTER_FREE_PARAM"] diff --git a/docs/code-quality/c26812.md b/docs/code-quality/c26812.md index f5b54e10863..3ea3543dc18 100644 --- a/docs/code-quality/c26812.md +++ b/docs/code-quality/c26812.md @@ -1,6 +1,6 @@ --- +title: "Warning C26812" description: "Learn more about: Warning C26812" -title: Warning C26812 ms.date: 02/14/2022 f1_keywords: ["C26812", "PreferScopedEnum"] helpviewer_keywords: ["C26812"] @@ -47,4 +47,4 @@ Print_color(Product_info::Red); // Error: cannot convert Product_info to int. ## See also -[Enum.3 Prefer enum class over enum](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#enum3-prefer-class-enums-over-plain-enums) +[Enum.3 Prefer enum class over enum](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Renum-class) diff --git a/docs/code-quality/c26813.md b/docs/code-quality/c26813.md index eabce1bfec4..cbaa14e3863 100644 --- a/docs/code-quality/c26813.md +++ b/docs/code-quality/c26813.md @@ -1,5 +1,5 @@ --- -title: Warning C26813 +title: "Warning C26813" description: "Learn more about: Warning C26813" ms.date: 05/17/2022 f1_keywords: ["C26813", "USE_BITWISE_AND_TO_CHEK_ENUM_FLAGS", "USE_BITWISE_AND_TO_CHECK_ENUM_FLAGS"] diff --git a/docs/code-quality/c26814.md b/docs/code-quality/c26814.md index 0727406c7da..363b3c50732 100644 --- a/docs/code-quality/c26814.md +++ b/docs/code-quality/c26814.md @@ -1,6 +1,6 @@ --- +title: "Warning C26814" description: "Learn more about: Warning C26814" -title: Warning C26814 ms.date: 07/15/2019 f1_keywords: ["C26814", "USE_CONSTEXPR_RATHER_THAN_CONST"] helpviewer_keywords: ["C26814"] @@ -33,4 +33,4 @@ void bar() ## See also -[Con.5 Use constexpr for all variables that can be computed at compile time](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#Rconst-constexpr) +[Con.5 Use constexpr for all variables that can be computed at compile time](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Rconst-constexpr) diff --git a/docs/code-quality/c26815.md b/docs/code-quality/c26815.md index 8778703ae41..bab51260def 100644 --- a/docs/code-quality/c26815.md +++ b/docs/code-quality/c26815.md @@ -1,9 +1,9 @@ --- -title: Warning C26815 +title: "Warning C26815" description: "Learn more about: Warning C26815." +ms.date: 01/27/2020 author: Rastaban ms.author: philc -ms.date: 01/27/2020 f1_keywords: ["C26815", "LIFETIME_LOCAL_USE_AFTER_FREE_TEMP"] helpviewer_keywords: ["C26815"] --- diff --git a/docs/code-quality/c26816.md b/docs/code-quality/c26816.md index f01ea3bc00d..0dd97234962 100644 --- a/docs/code-quality/c26816.md +++ b/docs/code-quality/c26816.md @@ -1,9 +1,9 @@ --- -title: Warning C26816 +title: "Warning C26816" description: "Learn more about: Warning C26816." +ms.date: 01/27/2020 author: Rastaban ms.author: philc -ms.date: 01/27/2020 f1_keywords: ["C26816", "LIFETIME_LOCAL_USE_AFTER_FREE_STACK"] helpviewer_keywords: ["C26816"] --- diff --git a/docs/code-quality/c26817.md b/docs/code-quality/c26817.md index fd72d2a527c..9e8bcb7a9b2 100644 --- a/docs/code-quality/c26817.md +++ b/docs/code-quality/c26817.md @@ -1,5 +1,5 @@ --- -title: Warning C26817 +title: "Warning C26817" description: "Reference for Microsoft C++ Code Analysis warning C26817 in Visual Studio." ms.date: 10/12/2023 f1_keywords: ["C26817"] @@ -9,7 +9,9 @@ helpviewer_keywords: ["C26817"] > Potentially expensive copy of variable *name* in range-for loop. Consider making it a const reference (es.71). -For more information, see [ES.71 notes](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Res-for-range) in the C++ Core Guidelines. +## Remarks + +For more information, see [ES.71: Prefer a range-`for`-statement to a `for`-statement when there is a choice](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Res-for-range) in the C++ Core Guidelines. ## Example diff --git a/docs/code-quality/c26818.md b/docs/code-quality/c26818.md index aed557b6adf..46d89915db4 100644 --- a/docs/code-quality/c26818.md +++ b/docs/code-quality/c26818.md @@ -1,5 +1,5 @@ --- -title: Warning C26818 +title: "Warning C26818" description: "Reference for Microsoft C++ Code Analysis warning C26818 in Visual Studio." ms.date: 04/22/2020 f1_keywords: ["C26818"] @@ -14,7 +14,7 @@ no-loc: [ default, int, char ] This check covers the missing **`default`** label in switch statements that switch over a non-enumeration type, such as **`int`**, **`char`**, and so on. -For more information, see [ES.79: Use default to handle common cases (only)](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#es79-use-default-to-handle-common-cases-only) in the C++ Core Guidelines. +For more information, see [ES.79: Use default to handle common cases (only)](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Res-default) in the C++ Core Guidelines. ## Example diff --git a/docs/code-quality/c26819.md b/docs/code-quality/c26819.md index 34dcd15ac72..19dd7513510 100644 --- a/docs/code-quality/c26819.md +++ b/docs/code-quality/c26819.md @@ -1,5 +1,5 @@ --- -title: Warning C26819 +title: "Warning C26819" description: "Reference for Microsoft C++ Code Analysis warning C26819 in Visual Studio." ms.date: 04/22/2020 f1_keywords: ["C26819"] @@ -87,4 +87,4 @@ void foo(int a) ## See also -[ES.78: Don't rely on implicit fallthrough in `switch` statements](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Res-break) \ No newline at end of file +[ES.78: Don't rely on implicit fallthrough in `switch` statements](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Res-break) diff --git a/docs/code-quality/c26820.md b/docs/code-quality/c26820.md index 291f3abc21c..bec99f63c72 100644 --- a/docs/code-quality/c26820.md +++ b/docs/code-quality/c26820.md @@ -1,5 +1,5 @@ --- -title: Warning C26820 +title: "Warning C26820" description: "Reference for Microsoft C++ Code Analysis warning C26820 in Visual Studio." ms.date: 10/12/2023 f1_keywords: ["C26820"] @@ -9,12 +9,12 @@ helpviewer_keywords: ["C26820"] > This is a potentially expensive copy operation. Consider using a reference unless a copy is required (p.9) +## Remarks + For more information, see [P.9: Don't waste time or space](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Rp-waste) in the C++ Core Guidelines. This check covers nonobvious and easy-to-miss behavior when assigning a reference to a variable marked **`auto`**. The type of the **`auto`** variable is resolved to a value rather than a reference, and an implicit copy is made. -## Remarks - - This warning isn't raised for scalars, smart pointers, or views. It's also not raised for types whose size isn't more than twice the platform-dependent pointer size. - This warning isn't raised when the variable gets mutated, as marking it `auto&` would introduce side-effects to the mutation. - This warning isn't raised when the reference comes from a temporary object, because that results in a dangling reference. For example: diff --git a/docs/code-quality/c26822.md b/docs/code-quality/c26822.md index fd661eafff1..15e355ba209 100644 --- a/docs/code-quality/c26822.md +++ b/docs/code-quality/c26822.md @@ -1,5 +1,5 @@ --- -title: Warning C26822 +title: "Warning C26822" description: "Describes the Microsoft C/C++ code analysis warning C26822, its causes, and how to address it." ms.date: 06/27/2022 f1_keywords: ["C26822", "NULLPTR_DEREFERENCE"] diff --git a/docs/code-quality/c26823.md b/docs/code-quality/c26823.md index 0ac7318a8a6..e89b46c2e42 100644 --- a/docs/code-quality/c26823.md +++ b/docs/code-quality/c26823.md @@ -1,5 +1,5 @@ --- -title: Warning C26823 +title: "Warning C26823" description: "Describes the Microsoft C/C++ code analysis warning C26823, its causes, and how to address it." ms.date: 06/27/2022 f1_keywords: ["C26823", "NULLPTR_DEREFERENCE_MAYBE"] diff --git a/docs/code-quality/c26824.md b/docs/code-quality/c26824.md index 0513c2c3f27..c2e9cea848d 100644 --- a/docs/code-quality/c26824.md +++ b/docs/code-quality/c26824.md @@ -1,5 +1,5 @@ --- -title: Warning C26824 +title: "Warning C26824" description: "Describes the Microsoft C/C++ code analysis warning C26824, its causes, and how to address it." ms.date: 06/27/2022 f1_keywords: ["C26824", "NULLPTR_POSTCONDITION_VIOLATION"] diff --git a/docs/code-quality/c26825.md b/docs/code-quality/c26825.md index 7945aeb3d0d..0c438deafb8 100644 --- a/docs/code-quality/c26825.md +++ b/docs/code-quality/c26825.md @@ -1,5 +1,5 @@ --- -title: Warning C26825 +title: "Warning C26825" description: "Describes the Microsoft C/C++ code analysis warning C26825, its causes, and how to address it." ms.date: 06/27/2022 f1_keywords: ["C26825", "NULLPTR_POSTCONDITION_VIOLATION_MAYBE"] diff --git a/docs/code-quality/c26826.md b/docs/code-quality/c26826.md index 8c0f827e9d5..d1da079af20 100644 --- a/docs/code-quality/c26826.md +++ b/docs/code-quality/c26826.md @@ -1,5 +1,5 @@ --- -title: Warning C26826 +title: "Warning C26826" description: "Reference for Microsoft C++ Code Analysis warning C26826 in Visual Studio." ms.date: 10/25/2021 f1_keywords: ["C26826"] @@ -9,10 +9,10 @@ helpviewer_keywords: ["C26826"] > Don't use C-style variable arguments (f.55). -For more information, see [F.55: Don't use `va_arg` arguments](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#F-varargs) in the C++ Core Guidelines. - ## Remarks +For more information, see [F.55: Don't use `va_arg` arguments](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#F-varargs) in the C++ Core Guidelines. + This check warns on all usages of `va_list`, `va_start`, `va_arg`, and `va_end`, discouraging the use of C-style variable arguments. C-style variable arguments are unsafe because they require the programmer to assume that the arguments are all passed and read with the correct types. Warning C26826 is available starting in Visual Studio 2022 version 17.1. diff --git a/docs/code-quality/c26827.md b/docs/code-quality/c26827.md index 7f80abb5325..6f806ba3939 100644 --- a/docs/code-quality/c26827.md +++ b/docs/code-quality/c26827.md @@ -1,5 +1,5 @@ --- -title: Warning C26827 +title: "Warning C26827" description: "Learn more about: Warning C26827" ms.date: 05/17/2023 f1_keywords: ["C26827", "ALMOST_BITWISE_ENUM"] diff --git a/docs/code-quality/c26828.md b/docs/code-quality/c26828.md index 5c0a9d474d4..ad057d7aa97 100644 --- a/docs/code-quality/c26828.md +++ b/docs/code-quality/c26828.md @@ -1,5 +1,5 @@ --- -title: Warning C26828 +title: "Warning C26828" description: "Learn more about: Warning C26828" ms.date: 05/17/2023 f1_keywords: ["C26828", "MIXING_OVERLAPPING_ENUMS"] diff --git a/docs/code-quality/c26829.md b/docs/code-quality/c26829.md index a19bd224a37..9eb04b47e84 100644 --- a/docs/code-quality/c26829.md +++ b/docs/code-quality/c26829.md @@ -1,5 +1,5 @@ --- -title: Warning C26829 +title: "Warning C26829" description: "Describes the Microsoft C/C++ code analysis warning C26829, its causes, and how to address it." ms.date: 06/23/2022 f1_keywords: ["C26829", "UNWRAP_EMPTY_OPTIONAL"] diff --git a/docs/code-quality/c26830.md b/docs/code-quality/c26830.md index 686b4b17127..513cf97632c 100644 --- a/docs/code-quality/c26830.md +++ b/docs/code-quality/c26830.md @@ -1,5 +1,5 @@ --- -title: Warning C26830 +title: "Warning C26830" description: "Describes the Microsoft C/C++ code analysis warning C26830, its causes, and how to address it." ms.date: 06/23/2022 f1_keywords: ["C26830", "UNWRAP_EMPTY_OPTIONAL_MAYBE"] diff --git a/docs/code-quality/c26831.md b/docs/code-quality/c26831.md index 0fe737b017d..fba6057d2f2 100644 --- a/docs/code-quality/c26831.md +++ b/docs/code-quality/c26831.md @@ -58,4 +58,6 @@ void foo(int i, int j) ## See also [`C26832`](c26832.md)\ -[`C26833`](c26833.md) \ No newline at end of file +[`C26833`](c26833.md)\ +[`C26838`](c26838.md)\ +[`C26839`](c26839.md) \ No newline at end of file diff --git a/docs/code-quality/c26838.md b/docs/code-quality/c26838.md new file mode 100644 index 00000000000..652ec704cde --- /dev/null +++ b/docs/code-quality/c26838.md @@ -0,0 +1,62 @@ +--- +title: Warning C26838 +description: Learn about Microsoft C++ code analysis warning C26838. +author: Rastaban +ms.author: philc +ms.topic: reference +ms.date: 1/10/2025 +--- +# Warning C26838 + +> Allocation size is the result of a signed to unsigned narrowing conversion that could result in overflow if the signed value is negative. + +This warning was added in Visual Studio 2022 version 17.13. + +## Remarks + +Reports that the size specified for an allocation may be the result of the conversion of a possibly negative signed value to an unsigned value. For example: + +```cpp +void* CustomAlloc(size_t); + +int* CreateIntArray(int numberOfElements) +{ + int* p = (int*)CustomAlloc(numberOfElements * sizeof(int)); // Warning: C26838 + + return p; +} +``` + +The expression `numberOfElements * sizeof(int)`, `numberOfElements` is signed and `sizeof(int)` is unsigned. On 64-bit machines, `numberOfElements` is promoted to an unsigned value when multiplied +by `sizeof(int)`. When `numberOfElements` is negative, the resulting value may overflow or have unexpected results when passed to `CustomAlloc`. + +This check applies to common allocation functions like `new`, `malloc`, and `VirtualAlloc`. The check also applies to custom allocator functions that have `alloc` (case insensitive) in the function name. + +This check sometimes fails to recognize that certain checks can prevent overflows because the check is conservative. + +## Example + +To fix the previous code example in which `numberOfElements * sizeof(int)` might overflow due to a negative signed value, introduce a check to ensure it won't. For example: + +```cpp +void* CustomAlloc(size_t); + +int* CreateIntArray(int numberOfElements) +{ + if (numberOfElements < 0) + return nullptr; + + int* p = (int*)CustomAlloc(numberOfElements * sizeof(int)); + // ... + return p; +} +``` + +In the previous example, checking for a negative value addresses the `C26832` warning. Depending on the size of the types involved, this check may result in a different warning such as [`C26831`](c26831.md). For example, on a 32-bit system, both `int` and `size_t` are 32 bits, so the result of the multiplication can still overflow without negative values. + +## See also + +[`C26831`](c26831.md)\ +[`C26832`](c26832.md)\ +[`C26833`](c26833.md)\ +[`C26833`](c26839.md) \ No newline at end of file diff --git a/docs/code-quality/c26839.md b/docs/code-quality/c26839.md new file mode 100644 index 00000000000..96d47c6df22 --- /dev/null +++ b/docs/code-quality/c26839.md @@ -0,0 +1,53 @@ +--- +title: Warning C26839 +description: Learn about Microsoft C++ code analysis warning C26839. +author: Rastaban +ms.author: philc +ms.topic: reference +ms.date: 1/10/2025 +--- +# Warning C26839 + +> Array new allocation size is the result of a signed to unsigned narrowing conversion that could result in overflow if the signed value is negative. + +This warning was added in Visual Studio 2022 version 17.13. + +## Remarks + +Reports that the size specified for an array `new` allocation may be the result of the conversion of a possibly negative signed value to an unsigned value. For example: + +```cpp +int* CreateIntArray(int size) +{ + int* intArray = new int[size]; + return intArray; +} +``` + +The expression `new int[size]`, `size` is signed. The compiler converts the signed value to an unsigned value to calculate how many bytes to be allocated for the array. When `size` is negative, the result of that calculation may overflow or have unexpected results when passed to `new`. + +This check is the same as [`C26838`](c26838.md), but applies only to `new T[]`. + +This check sometimes fails to recognize that certain checks can prevent overflows because the check is conservative. + +## Example + +To fix the previous code example in which the size calculation might overflow due to a negative signed value, introduce a check to ensure it won't. For example: + +```cpp +int* CreateIntArray(int size) +{ + if (size < 0) + return nullptr; + + int* intArray = new int[size]; + return intArray; +} +``` + +## See also + +[`C26831`](c26831.md)\ +[`C26832`](c26832.md)\ +[`C26838`](c26833.md)\ +[`C26838`](c26838.md) \ No newline at end of file diff --git a/docs/code-quality/c26865.md b/docs/code-quality/c26865.md new file mode 100644 index 00000000000..0e9bd9d213a --- /dev/null +++ b/docs/code-quality/c26865.md @@ -0,0 +1,54 @@ +--- +description: "Learn more about: Warning C26865" +title: Warning C26865 +ms.date: 10/03/2022 +f1_keywords: ["C26865", "ALLOCATION_DEALLOCATION_MISMATCH", "__WARNING_ALLOCATION_DEALLOCATION_MISMATCH"] +helpviewer_keywords: ["C26865"] +ms.assetid: 2fbe9dc5-fa43-47b9-97a7-3f8215da1d40 +--- +# Warning C26865 + +> Memory allocated with '\' is being deallocated with '\'. Use '\' instead. + +This rule was added in Visual Studio 2026 18.0. + +## Remarks + +This warning indicates that the memory was allocated with one family of allocation functions, but was freed with a deallocation function from a different family. This usage results in undefined behavior according to C/C++ and the Microsoft MSVC implementation. + +The exact ramifications of this defect are difficult to predict. It might result in leaks for classes with destructors that perform memory deallocation. It could cause inconsistent behavior for classes with destructors that perform semantically significant operations, or memory corruptions and crashes. In other cases the mismatch might be unimportant, depending on the implementation of the compiler and its libraries. Analysis tools can't always distinguish between these situations. + +If memory is allocated with one family of allocation functions, it should be freed with a matching deallocation function. + +C26865 covers the following allocation/deallocation pairs: + +- C++ scalar new (`new`) must be deallocated with scalar delete (`delete`). +- C++ array new (`new[]`) must be deallocated with array delete (`delete[]`). +- C/C++ `malloc`/`calloc`/`realloc` must be deallocated with `free` (or `realloc`). +- Windows `HeapAlloc` must be deallocated with `HeapFree`. +- Windows `GlobalAlloc` must be deallocated with `GlobalFree`. +- Windows `LocalAlloc` must be deallocated with `LocalFree`. +- Windows `MIDL_user_allocate` must be deallocated with `MIDL_user_free`. +- Component Object Model (COM) `CoTaskMemAlloc` must be deallocated with `CoTaskMemFree`. + +Code analysis name: `ALLOCATION_DEALLOCATION_MISMATCH` + +## Example + +The following sample code generates warning C26865: + +```cpp +void f() { + int *pInt = (int *)calloc(10, sizeof(int)); + // code ... + delete pInt; // C26865: Memory allocated with 'calloc' is being deallocated with 'delete'. Use 'free' instead. +} + +void g() { + char * str = new char[50]; + // code ... + delete str; // C26865: Memory allocated with 'new[]' is being deallocated with 'delete'. Use 'delete[]' instead. +} +``` + +Manual memory management has many pitfalls in terms of memory leaks and exceptions. To avoid these kinds of potential leaks altogether, use the mechanisms that are provided by the C++ Standard Library (STL). These mechanisms include [`shared_ptr`](../standard-library/shared-ptr-class.md), [`unique_ptr`](../standard-library/unique-ptr-class.md), and containers such as [`vector`](../standard-library/vector.md). For more information, see [Smart pointers](../cpp/smart-pointers-modern-cpp.md) and [C++ Standard Library](../standard-library/cpp-standard-library-reference.md). diff --git a/docs/code-quality/c28020.md b/docs/code-quality/c28020.md index d3597bd1437..927e462bda8 100644 --- a/docs/code-quality/c28020.md +++ b/docs/code-quality/c28020.md @@ -1,15 +1,32 @@ --- -description: "Learn more about: Warning C28020" title: Warning C28020 -ms.date: 11/04/2016 +description: "Learn more about: Warning C28020" +ms.date: 03/25/2025 f1_keywords: ["C28020"] helpviewer_keywords: ["C28020"] -ms.assetid: 3612185a-0858-4ba9-b795-4a0681073cf7 --- # Warning C28020 -> The expression '*expr*' is not true at this call +> The expression '*expr*' is not true at this call. This warning is reported when the `_Satisfies_` expression listed isn't true. Frequently, the warning indicates an incorrect parameter. If this warning occurs on a function declaration, the annotations indicate an impossible condition. + +## Example + +The following example generates C28020: + +```cpp +#include + +int func(_In_range_(0, 10) int value) +{ + return value; +} + +int main() +{ + func(11); // C28020 +} +``` diff --git a/docs/code-quality/c28112.md b/docs/code-quality/c28112.md index d717ffd5961..61e0a5588ee 100644 --- a/docs/code-quality/c28112.md +++ b/docs/code-quality/c28112.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Warning C28112" title: Warning C28112 +description: "Learn more about: Warning C28112" ms.date: 08/25/2022 f1_keywords: ["C28112", "INTERLOCKED_ACCESS", "__WARNING_INTERLOCKED_ACCESS"] helpviewer_keywords: ["C28112"] -ms.assetid: 2720a5dc-84e9-4f78-a8c7-a320c9f9216b --- # Warning C28112 @@ -16,7 +15,7 @@ A variable that is accessed by using the Interlocked executive support routines, `InterlockedXxx` functions are intended to provide atomic operations, but are only atomic with respect to other `InterlockedXxx` functions. Although certain ordinary assignments, accesses, and comparisons to variables that are used by the Interlocked\* routines can be safely accessed by using a different function, the risk is great enough to justify examining each instance. -Code analysis name: INTERLOCKED_ACCESS +Code analysis name: `INTERLOCKED_ACCESS` ## Example @@ -36,7 +35,7 @@ InterlockedDecrement(&inter_var); InterlockedIncrement(&inter_var); ``` -## See Also +## See also [InterlockedIncrement function (wdm.h)](/windows-hardware/drivers/ddi/wdm/nf-wdm-interlockedincrement)\ [InterlockedDecrement function (wdm.h)](/windows-hardware/drivers/ddi/wdm/nf-wdm-interlockeddecrement) diff --git a/docs/code-quality/c28159.md b/docs/code-quality/c28159.md index e17a31ee6f0..05fbe31944d 100644 --- a/docs/code-quality/c28159.md +++ b/docs/code-quality/c28159.md @@ -1,14 +1,13 @@ --- -description: "Learn more about: Warning C28159" title: Warning C28159 +description: "Learn more about: Warning C28159" ms.date: 09/08/2022 f1_keywords: ["C28159", "USE_OTHER_FUNCTION", "__WARNING_USE_OTHER_FUNCTION"] helpviewer_keywords: ["C28159"] -ms.assetid: fab6cd58-0985-4ef6-89a2-64ed04297437 --- # Warning C28159 -> Consider using `*function_name_1*` instead of `*function_name_2*`. Reason: *reason* +> Consider using *`function_name_1`* instead of *`function_name_2`*. Reason: *reason* This warning occurs when you use a function that is semantically equivalent to an alternative, preferred function call. @@ -16,7 +15,7 @@ This warning occurs when you use a function that is semantically equivalent to a C28159 is a general warning message; the annotation `__drv_preferredFunction` was used (possibly with a conditional `__drv_when`() annotation) to flag a bad coding practice. -Code analysis name: USE_OTHER_FUNCTION +Code analysis name: `USE_OTHER_FUNCTION` ## Example diff --git a/docs/code-quality/c28160.md b/docs/code-quality/c28160.md index 38ea9be0b14..eeee7046da1 100644 --- a/docs/code-quality/c28160.md +++ b/docs/code-quality/c28160.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Warning C28160" title: Warning C28160 +description: "Learn more about: Warning C28160" ms.date: 09/08/2022 f1_keywords: ["C28160", "ERROR", "__WARNING_ERROR"] helpviewer_keywords: ["C28160"] -ms.assetid: cab15f6b-909c-4cc8-81a0-c24ac7c91c7c --- # Warning C28160 @@ -16,4 +15,4 @@ This warning is reported when a `__drv_error` annotation has been encountered. This annotation is used to flag coding practices that should be fixed, and can be used with a `__drv_when` annotation to indicate specific combinations of parameters. -Code analysis name: ERROR +Code analysis name: `ERROR` diff --git a/docs/code-quality/c28196.md b/docs/code-quality/c28196.md index 4bd26b41621..388766230a3 100644 --- a/docs/code-quality/c28196.md +++ b/docs/code-quality/c28196.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Warning C28196" title: Warning C28196 +description: "Learn more about: Warning C28196" ms.date: 11/04/2016 f1_keywords: ["C28196", "RETURNING_BAD_RESULT", "__WARNING_RETURNING_BAD_RESULT"] helpviewer_keywords: ["C28196"] -ms.assetid: 5ee89e96-2796-4316-a64c-702463ca1374 --- # Warning C28196 @@ -51,4 +50,4 @@ Item *get_item(_In_reads_(len) Item *items, size_t len, size_t index) { ## See also [Annotating function parameters and return values](./annotating-function-parameters-and-return-values.md)\ -[Specifying When and Where an Annotation Applies](./specifying-when-and-where-an-annotation-applies.md)\ +[Specifying When and Where an Annotation Applies](./specifying-when-and-where-an-annotation-applies.md) diff --git a/docs/code-quality/c28208.md b/docs/code-quality/c28208.md index 1a9dc76e945..6d352f4247b 100644 --- a/docs/code-quality/c28208.md +++ b/docs/code-quality/c28208.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Warning C28208" title: Warning C28208 +description: "Learn more about: Warning C28208" ms.date: 10/03/2022 f1_keywords: ["C28208", "FUNCTION_TYPE_REDECLARATION", "__WARNING_FUNCTION_TYPE_REDECLARATION"] helpviewer_keywords: ["C28208"] -ms.assetid: e9a8ce37-3b05-4202-b078-5570ae496d1d --- # Warning C28208 @@ -30,8 +29,8 @@ typedef void test_type(void*); #include "c28208_example.h" test_type my_test1; test_type my_test2; -void my_test1(int* x){}; // Generates C28208 -void my_test2(void* x){}; // Doesn't generate C28208 +void my_test1(int* x){} // Generates C28208 +void my_test2(void* x){} // Doesn't generate C28208 int main() { diff --git a/docs/code-quality/c28310.md b/docs/code-quality/c28310.md index 4b85718201b..30aa4d82445 100644 --- a/docs/code-quality/c28310.md +++ b/docs/code-quality/c28310.md @@ -1,9 +1,9 @@ --- -description: "Learn more about: Warning C28310" title: Warning C28310 +description: "Learn more about: Warning C28310" ms.date: 11/04/2016 f1_keywords: ["C28310"] -ms.assetid: 51054ca8-01b6-454b-9853-f05f1c817b18 +helpviewer_keywords: ["C28310"] --- # Warning C28310 diff --git a/docs/code-quality/c28311.md b/docs/code-quality/c28311.md index 70e03e716e1..9d72006caeb 100644 --- a/docs/code-quality/c28311.md +++ b/docs/code-quality/c28311.md @@ -1,9 +1,9 @@ --- -description: "Learn more about: Warning C28311" title: Warning C28311 +description: "Learn more about: Warning C28311" ms.date: 11/04/2016 f1_keywords: ["C28311"] -ms.assetid: 2c76e07a-4418-40ef-8a77-c62774bc3677 +helpviewer_keywords: ["C28311"] --- # Warning C28311 diff --git a/docs/code-quality/c28312.md b/docs/code-quality/c28312.md index 55f6154d544..852d5bec16d 100644 --- a/docs/code-quality/c28312.md +++ b/docs/code-quality/c28312.md @@ -1,9 +1,9 @@ --- -description: "Learn more about: Warning C28312" title: Warning C28312 +description: "Learn more about: Warning C28312" ms.date: 11/04/2016 f1_keywords: ["C28312"] -ms.assetid: 19828546-33c9-4373-b7df-2a362ca12637 +helpviewer_keywords: ["C28312"] --- # Warning C28312 diff --git a/docs/code-quality/c33001.md b/docs/code-quality/c33001.md index d3208941b45..679ffc1e04c 100644 --- a/docs/code-quality/c33001.md +++ b/docs/code-quality/c33001.md @@ -13,14 +13,23 @@ helpviewer_keywords: ["C33001"] ## Remarks -This warning is triggered when an uninitialized `VARIANT` is passed to an API such as `VariantClear` -that expects an initialized `VARIANT`. +This warning is triggered when an uninitialized `VARIANT` is passed to an API, such as `VariantClear`, that clears the object. Initialize the `VARIANT` before passing it to these functions so it can be properly cleared. + +This warning applies to these functions: + +* `VariantClear` +* `PropVariantClear` +* `VariantCopy` +* `VariantCopyInd` +* `VariantChangeType` +* `VariantChangeTypeEx` +* `DestroyPropVariant` Code analysis name: `VARIANTCLEAR_UNINITIALIZED` ## Example -The following sample code causes warning C33001: +The following code causes warning C33001: ```cpp #include @@ -36,11 +45,11 @@ HRESULT foo(bool some_condition) //... } - VariantClear(&var); // C33001 + VariantClear(&var); // C33001 } ``` -These warnings are corrected by ensuring `VariantClear` is called only for a properly initialized `VARIANT`: +In this example, the warning is corrected by calling `VariantClear` only after `var` has been initialized: ```cpp #include @@ -54,12 +63,12 @@ HRESULT foo(bool some_condition) //... VariantInit(&var); //... - VariantClear(&var); // C33001 + VariantClear(&var); // OK } } ``` ## See also -[C33004](./c33004.md) +[C33004](./c33004.md)\ [C33005](./c33005.md) diff --git a/docs/code-quality/c33004.md b/docs/code-quality/c33004.md index 752103c945e..44486d8ffc6 100644 --- a/docs/code-quality/c33004.md +++ b/docs/code-quality/c33004.md @@ -49,5 +49,5 @@ void t2(_Out_ VARIANT* pv) ## See also -[C33001](./c33001.md) +[C33001](./c33001.md)\ [C33005](./c33005.md) diff --git a/docs/code-quality/c33005.md b/docs/code-quality/c33005.md index 8c056ba671c..41509513e3c 100644 --- a/docs/code-quality/c33005.md +++ b/docs/code-quality/c33005.md @@ -55,5 +55,5 @@ void foo() ## See also -[C33001](./c33001.md) +[C33001](./c33001.md)\ [C33004](./c33004.md) diff --git a/docs/code-quality/c6001.md b/docs/code-quality/c6001.md index 755bb88cb32..8d57dd9cc84 100644 --- a/docs/code-quality/c6001.md +++ b/docs/code-quality/c6001.md @@ -1,6 +1,6 @@ --- +title: "Warning C6001" description: "Learn more about: Warning C6001" -title: Warning C6001 ms.date: 10/04/2022 f1_keywords: ["C6001", "USING_UNINIT_VAR", "__WARNING_USING_UNINIT_VAR"] helpviewer_keywords: ["C6001"] diff --git a/docs/code-quality/c6011.md b/docs/code-quality/c6011.md index 2094f73796a..2255b15e363 100644 --- a/docs/code-quality/c6011.md +++ b/docs/code-quality/c6011.md @@ -1,10 +1,9 @@ --- -title: Warning C6011 +title: "Warning C6011" description: "Reference for Visual Studio C++ code analysis warning C6011." ms.date: 10/04/2022 f1_keywords: ["C6011", "DEREF_NULL_PTR", "__WARNING_DEREF_NULL_PTR"] helpviewer_keywords: ["C6011"] -ms.assetid: 54b7bc2b-b8f5-43fc-a9a3-8189b03f249a --- # Warning C6011 @@ -16,7 +15,7 @@ This warning indicates that your code dereferences a potentially null pointer. I Code analysis name: `DEREF_NULL_PTR` -## Example +## Examples The following code generates this warning because a call to `malloc` might return null if insufficient memory is available: diff --git a/docs/code-quality/c6014.md b/docs/code-quality/c6014.md index 9806124fb84..6065a8b16c3 100644 --- a/docs/code-quality/c6014.md +++ b/docs/code-quality/c6014.md @@ -1,19 +1,18 @@ --- +title: "Warning C6014" description: "Learn more about: Warning C6014" -title: Warning C6014 ms.date: 10/03/2022 f1_keywords: ["C6014", "MEMORY_LEAK", "__WARNING_MEMORY_LEAK"] helpviewer_keywords: ["C6014"] -ms.assetid: ef76ec88-74d2-4a3b-b6fe-4b0851ab3372 --- # Warning C6014 > Leaking memory '*pointer-name*'. -This warning indicates that the specified pointer points to allocated memory or some other allocated resource that hasn't been freed. - ## Remarks +This warning indicates that the specified pointer points to allocated memory or some other allocated resource that hasn't been freed. + The analyzer checks for this condition only when the `_Analysis_mode_(_Analysis_local_leak_checks_)` SAL annotation is specified. By default, this annotation is specified for Windows kernel mode (driver) code. For more information about SAL annotations, see [Using SAL Annotations to Reduce C/C++ Code Defects](../code-quality/using-sal-annotations-to-reduce-c-cpp-code-defects.md). This warning is reported for both memory and resource leaks when the resource is commonly *aliased* to another location. Memory is aliased when a pointer to the memory escapes the function by using an `_Out_` parameter annotation, global variable, or return value. This warning can be reported on function exit if the argument is annotated that its release is expected. diff --git a/docs/code-quality/c6029.md b/docs/code-quality/c6029.md index 85829020b6e..2fd6c711b0a 100644 --- a/docs/code-quality/c6029.md +++ b/docs/code-quality/c6029.md @@ -1,6 +1,6 @@ --- +title: "Warning C6029" description: "Learn more about: Warning C6029" -title: Warning C6029 ms.date: 2/07/2023 f1_keywords: ["C6029", "USING_TAINTED_DATA", "__WARNING_USING_TAINTED_DATA"] helpviewer_keywords: ["C6029"] @@ -9,10 +9,10 @@ helpviewer_keywords: ["C6029"] > Possible buffer overrun in call to '*function*' -Possible buffer overrun in called function due to an unchecked buffer length/size parameter. - ## Remarks +Possible buffer overrun in called function due to an unchecked buffer length/size parameter. + This warning indicates that code passes an unchecked size to a function that takes a buffer and a size. The code doesn't verify that the data read from some external source is smaller than the buffer size. An attacker might intentionally specify a larger than expected value for the size, which can lead to a buffer overrun. Generally, whenever you read data from an untrusted external source, make sure to verify it for validity. It's appropriate to verify the size to make sure it's in the expected range. Code analysis name: `USING_TAINTED_DATA` @@ -35,7 +35,7 @@ void processData(FILE* file) } ``` -The fix for the issue depends on the nature of the data and the behavior of the annotated function that triggers the diagnostic. For more information, see the documentation for that function. A straightforward fix is to check the size before the second call to `std:fread`. In the next example, we throw an exception to terminate the function. Most real-world code would instead have an error recovery strategy that's specific to the scenario. +The fix for the issue depends on the nature of the data and the behavior of the annotated function that triggers the diagnostic. For more information, see the documentation for that function. A straightforward fix is to check the size before the second call to `std::fread`. In the next example, we throw an exception to terminate the function. Most real-world code would instead have an error recovery strategy that's specific to the scenario. ```cpp void processData(FILE* file) @@ -55,7 +55,7 @@ void processData(FILE* file) } ``` -In `std:fread` and similar functions, the code may need to read large amounts of data. To handle large data, you can allocate the size of the buffer dynamically after the size becomes known. Or, you can call `std:fread` multiple times as needed to read in the rest of the data. If you allocate the buffer dynamically, we recommend you put a limit on the size to avoid introducing an out-of-memory exploit for large values. We don't use this approach in our example because it's already bounded by the size of `uint8_t`. +In `std::fread` and similar functions, the code may need to read large amounts of data. To handle large data, you can allocate the size of the buffer dynamically after the size becomes known. Or, you can call `std::fread` multiple times as needed to read in the rest of the data. If you allocate the buffer dynamically, we recommend you put a limit on the size to avoid introducing an out-of-memory exploit for large values. We don't use this approach in our example because it's already bounded by the size of `uint8_t`. ```cpp void processDataDynamic(FILE* file) diff --git a/docs/code-quality/c6030.md b/docs/code-quality/c6030.md index 41d536acb35..ab0f26a88e8 100644 --- a/docs/code-quality/c6030.md +++ b/docs/code-quality/c6030.md @@ -1,22 +1,23 @@ --- -title: Warning C6030 +title: "Warning C6030" description: "Describes C++ Code Analysis warning C6030 and how to resolve it." ms.date: 03/10/2023 f1_keywords: ["C6030", "USE_ATTRIBUTE_NORETURN", "__WARNING_USE_ATTRIBUTE_NORETURN"] helpviewer_keywords: ["C6030"] --- -# Warning C6030 +# Warning C6030 > Use attribute [[noreturn]] over __declspec(noreturn) in function '*function-name*' ## Remarks -This warning suggests using the C++11 standard attribute `[[noreturn]]` in place of the declspec variant `__declspec(noreturn)`. The standard attribute provides better cross-platform support because it doesn't rely on language extensions. +This warning suggests using the C++11 standard attribute [`[[noreturn]]`](../cpp/attributes.md#noreturn) in place of the declspec variant [`__declspec(noreturn)`](../cpp/noreturn.md). The standard attribute provides better cross-platform support because it doesn't rely on language extensions. This warning is off by default and isn't part of the `All Rules` rule set. To enable this warning, it must be added to the rule set file being used. This check is available in Visual Studio 2022 version 17.0 and later versions. + Code analysis name: `USE_ATTRIBUTE_NORETURN` ## Example @@ -24,15 +25,13 @@ Code analysis name: `USE_ATTRIBUTE_NORETURN` The following code generates C6030: ```cpp -__declspec(noreturn) void TerminateApplication(); - +__declspec(noreturn) void terminate_application(); ``` Fix the issue by using the `[[noreturn]]` attribute: ```cpp -[[ noreturn ]] void TerminateApplication(); - +[[noreturn]] void terminate_application(); ``` ## See also diff --git a/docs/code-quality/c6031.md b/docs/code-quality/c6031.md index 541fca4ba56..f134bddcc00 100644 --- a/docs/code-quality/c6031.md +++ b/docs/code-quality/c6031.md @@ -1,5 +1,5 @@ --- -title: Warning C6031 +title: "Warning C6031" description: "Describes C++ Code Analysis warning C6031 and how to resolve it." ms.date: 4/5/2024 f1_keywords: ["C6031", "RETVAL_IGNORED_FUNC_COULD_FAIL", "__WARNING_RETVAL_IGNORED_FUNC_COULD_FAIL"] @@ -19,7 +19,7 @@ This warning applies to both C and C++ code. Code analysis name: `RETVAL_IGNORED_FUNC_COULD_FAIL` -## Example +## Examples The following code generates warning C6031: diff --git a/docs/code-quality/c6053.md b/docs/code-quality/c6053.md index 426980c7878..80c15b91dd2 100644 --- a/docs/code-quality/c6053.md +++ b/docs/code-quality/c6053.md @@ -1,10 +1,9 @@ --- +title: "Warning C6053" description: "Learn more about: Warning C6053" -title: Warning C6053 ms.date: 10/04/2022 f1_keywords: ["C6053", "MISSING_ZERO_TERMINATION1", "__WARNING_MISSING_ZERO_TERMINATION1"] helpviewer_keywords: ["C6053"] -ms.assetid: 8e25566a-e3b9-470a-820d-64221a877c53 --- # Warning C6053 @@ -18,9 +17,9 @@ Most C standard library and Win32 string handling functions require and produce Code analysis name: `MISSING_ZERO_TERMINATION1` -## Examples +## Example -The following sample code generates this warning: +The following example code generates this warning: ```cpp #include @@ -36,7 +35,7 @@ size_t f( ) } ``` -To correct this warning, zero-terminate the string as shown in the following sample code: +To correct this warning, zero-terminate the string as shown in the following example code: ```cpp #include @@ -53,7 +52,7 @@ size_t f( ) } ``` -The following sample code corrects this warning using safe string manipulation `strncpy_s` function: +The following example code corrects this warning using safe string manipulation `strncpy_s` function: ```cpp #include diff --git a/docs/code-quality/c6054.md b/docs/code-quality/c6054.md index 511c7f6bfae..32962f45ea6 100644 --- a/docs/code-quality/c6054.md +++ b/docs/code-quality/c6054.md @@ -1,10 +1,9 @@ --- -title: Warning C6054 +title: "Warning C6054" description: "Reference guide to Microsoft C++ code analysis warning C6054." ms.date: 10/04/2022 f1_keywords: ["C6054", "MISSING_ZERO_TERMINATION2", "__WARNING_MISSING_ZERO_TERMINATION2"] helpviewer_keywords: ["C6054"] -ms.assetid: d573a5c1-7e74-402b-92e6-8085f967aa50 --- # Warning C6054 @@ -34,7 +33,7 @@ void g ( ) } ``` -To correct this warning, null-terminate `wcArray` before calling function `func()` as shown in the following sample code: +To correct this warning, null-terminate `wcArray` before calling function `func()` as shown in the following example code: ```cpp // C6054_good.cpp diff --git a/docs/code-quality/c6059.md b/docs/code-quality/c6059.md index d78c0f3f74b..2678b0fd252 100644 --- a/docs/code-quality/c6059.md +++ b/docs/code-quality/c6059.md @@ -1,10 +1,9 @@ --- +title: "Warning C6059" description: "Learn more about: Warning C6059" -title: Warning C6059 ms.date: 12/14/2023 f1_keywords: ["C6059", "BAD_CONCATENATION", "__WARNING_BAD_CONCATENATION"] helpviewer_keywords: ["C6059"] -ms.assetid: 343a4cd1-048a-4edf-bb4b-187097bb6093 --- # Warning C6059 diff --git a/docs/code-quality/c6063.md b/docs/code-quality/c6063.md index e84940d4b23..23882eb5492 100644 --- a/docs/code-quality/c6063.md +++ b/docs/code-quality/c6063.md @@ -1,6 +1,6 @@ --- +title: "Warning C6063" description: "Learn more about: Warning C6063" -title: Warning C6063 ms.date: 2/22/2023 f1_keywords: ["C6063", "MISSING_STRING_ARGUMENT_TO_FORMAT_FUNCTION", "__WARNING_MISSING_STRING_ARGUMENT_TO_FORMAT_FUNCTION"] helpviewer_keywords: ["C6063"] diff --git a/docs/code-quality/c6064.md b/docs/code-quality/c6064.md index 645f77ff241..2bf2c32b05d 100644 --- a/docs/code-quality/c6064.md +++ b/docs/code-quality/c6064.md @@ -1,7 +1,7 @@ --- +title: "Warning C6064" description: "Learn more about: Warning C6064" -title: Warning C6064 -ms.date: 2/07/2023 +ms.date: 9/29/2025 f1_keywords: ["C6064", "MISSING_INTEGER_ARGUMENT_TO_FORMAT_FUNCTION", "__WARNING_MISSING_INTEGER_ARGUMENT_TO_FORMAT_FUNCTION"] helpviewer_keywords: ["C6064"] --- @@ -9,17 +9,19 @@ helpviewer_keywords: ["C6064"] > Missing integer argument to '*function-name*' corresponding to conversion specifier '*number*' +## Remarks + This warning indicates that the code doesn't provide enough arguments to match a format string and one of the missing arguments is an integer. -## Remarks +Providing too few arguments to a format function leads to undefined behavior because the function attempts to read values that aren't passed. Possible consequences include incorrect output, crashes, or even security vulnerabilities such as information leaks. -This defect is likely to cause incorrect output and, in more dangerous cases, can lead to stack overflow. +To ensure stability and safety, always match the number and types of arguments to the format specifiers in the string. Code analysis name: `MISSING_INTEGER_ARGUMENT_TO_FORMAT_FUNCTION` ## Example -The following code generates this warning because it uses an incorrect number of arguments in the call to `sprintf_s` and the missing argument is an integer. If the unsafe function `sprintf` was used instead of the safer variant `sprintf_s`, this code would likely cause a stack overflow instead of just an unexpected output: +The following code generates this warning when code analysis is enabled (Project properties > **Configuration Properties** > **Code Analysis ** > **General** > **Enable Code Analysis on Build**) because it uses an incorrect number of arguments in the call to `sprintf_s` and the missing argument is an integer. If the unsafe function `sprintf` was used instead of the safer variant `sprintf_s`, this code would likely cause a stack overflow instead of just an unexpected output: ```cpp void f() @@ -34,7 +36,7 @@ void f() } ``` -To correct this warning, specify missing arguments or adjust the format string. In this example, we add the missing integer value. +To correct this warning, specify the missing arguments or adjust the format string. In this example, we add the missing integer value. ```cpp void f() diff --git a/docs/code-quality/c6065.md b/docs/code-quality/c6065.md index 20ea8e81454..915ba25f3e1 100644 --- a/docs/code-quality/c6065.md +++ b/docs/code-quality/c6065.md @@ -1,6 +1,6 @@ --- +title: "Warning C6065" description: "Learn more about: Warning C6065" -title: Warning C6065 ms.date: 2/22/2023 f1_keywords: ["C6065", "MISSING_COUNTED_STRING_ARGUMENT_TO_FORMAT_FUNCTION", "__MISSING_COUNTED_STRING_ARGUMENT_TO_FORMAT_FUNCTION"] helpviewer_keywords: ["C6065"] diff --git a/docs/code-quality/c6066.md b/docs/code-quality/c6066.md index 8ae5f799022..8bdd672541d 100644 --- a/docs/code-quality/c6066.md +++ b/docs/code-quality/c6066.md @@ -1,6 +1,6 @@ --- +title: "Warning C6066" description: "Learn more about: Warning C6066" -title: Warning C6066 ms.date: 3/02/2023 f1_keywords: ["C6066", "NON_POINTER_ARGUMENT_TO_FORMAT_FUNCTION", "__WARNING_NON_POINTER_ARGUMENT_TO_FORMAT_FUNCTION"] helpviewer_keywords: ["C6066"] diff --git a/docs/code-quality/c6067.md b/docs/code-quality/c6067.md index 0a181ff13ab..e2546bfb680 100644 --- a/docs/code-quality/c6067.md +++ b/docs/code-quality/c6067.md @@ -1,6 +1,6 @@ --- +title: "Warning C6067" description: "Learn more about: Warning C6067" -title: Warning C6067 ms.date: 3/02/2023 f1_keywords: ["C6067", "NON_STRING_ARGUMENT_TO_FORMAT_FUNCTION", "__WARNING_NON_STRING_ARGUMENT_TO_FORMAT_FUNCTION"] helpviewer_keywords: ["C6067"] @@ -17,7 +17,7 @@ This defect is likely to cause a crash or corruption of some form. Code analysis name: `NON_STRING_ARGUMENT_TO_FORMAT_FUNCTION` -## Example +## Examples The following code generates this warning because an integer is passed instead of a string: diff --git a/docs/code-quality/c6101.md b/docs/code-quality/c6101.md index ee653b08a8f..11dd9b17a78 100644 --- a/docs/code-quality/c6101.md +++ b/docs/code-quality/c6101.md @@ -1,6 +1,6 @@ --- +title: "Warning C6101" description: "Learn more about: Warning C6101" -title: Warning C6101 ms.date: 02/7/2023 f1_keywords: ["C6101", "RETURN_UNINIT_VAR", "__WARNING_RETURN_UNINIT_VAR"] helpviewer_keywords: ["C6101"] @@ -9,10 +9,10 @@ helpviewer_keywords: ["C6101"] > Returning uninitialized memory '*parameter-name*'. -A successful path through the function doesn't set the `_Out_` annotated parameter. - ## Remarks +A successful path through the function doesn't set the `_Out_` annotated parameter. + The purpose of this warning is to avoid the use of uninitialized values by callers of the function. The analyzer assumes callers don't initialize any parameters annotated with `_Out_` before the function call, and checks that the function initializes them. The analyzer doesn't emit this warning if the function returns a value that indicates it had an error or wasn't successful. To fix this issue, make sure to initialize the `_Out_` parameter under all successful return paths. The error message contains the line numbers of an example path that doesn't initialize the parameter. If the initialization behavior is by design, then incorrect or missing SAL annotations are a likely cause for the warning. You can typically resolve these cases in one of two ways: Either change `_Out_` to a more appropriate annotation, or use the `_Success_()` annotation to help define the success/error states of the function. It's important for the static analysis tools to have correct annotations on the function when analyzing the call sites of the function. diff --git a/docs/code-quality/c6102.md b/docs/code-quality/c6102.md index d1dd840a693..e003c84636b 100644 --- a/docs/code-quality/c6102.md +++ b/docs/code-quality/c6102.md @@ -1,14 +1,16 @@ --- +title: "Warning C6102" description: "Learn more about: Warning C6102" -title: Warning C6102 ms.date: 11/04/2016 f1_keywords: ["C6102"] -ms.assetid: cfd49a8c-df46-48de-8dcb-02ecf2450034 +helpviewer_keywords: ["C6102"] --- # Warning C6102 > Using '*variable*' from failed function call at line '*location*'. +## Remarks + This warning is reported instead of [C6001](../code-quality/c6001.md) when a variable isn't set because it was marked as an `_Out_` parameter on a prior function call that failed. The problem might be that the prior called function isn't fully annotated. It may require `_Always_`, `_Outptr_result_nullonfailure_` (`_COM_Outptr_` for COM code), or a related annotation. diff --git a/docs/code-quality/c6103.md b/docs/code-quality/c6103.md index d348b72bd5e..4ab5fd62efe 100644 --- a/docs/code-quality/c6103.md +++ b/docs/code-quality/c6103.md @@ -1,14 +1,16 @@ --- +title: "Warning C6103" description: "Learn more about: Warning C6103" -title: Warning C6103 ms.date: 11/04/2016 f1_keywords: ["C6103"] -ms.assetid: 22d1ab35-31a3-4ba9-8ef4-7a64bce66621 +helpviewer_keywords: ["C6103"] --- # Warning C6103 > Returning '*variable*' from failed function call at line '*location*'. +## Remarks + A successful path through the function is returning a variable that was used as an `_Out_` parameter to an internal function call that failed. The problem might be that the called function and the calling function aren't fully annotated. The called function may require `_Always_`, `_Outptr_result_nullonfailure_` (`_COM_Outptr_` for COM code), or a related annotation, and the calling function may require a `_Success_` annotation. Another possible cause for this warning is that the `_Success_` annotation on the called function is incorrect. diff --git a/docs/code-quality/c6200.md b/docs/code-quality/c6200.md index 2106582d1af..945df12b0be 100644 --- a/docs/code-quality/c6200.md +++ b/docs/code-quality/c6200.md @@ -1,19 +1,18 @@ --- +title: "Warning C6200" description: "Learn more about: Warning C6200" -title: Warning C6200 ms.date: 08/16/2022 f1_keywords: ["C6200", "INDEX_EXCEEDS_MAX_NONSTACK", "__WARNING_INDEX_EXCEEDS_MAX_NONSTACK"] helpviewer_keywords: ["C6200"] -ms.assetid: bbeb159b-4e97-4317-9a07-bb83cd03069a --- # Warning C6200 > Index '*index*' is out of valid index range '*min*' to '*max*' for nonstack buffer '*parameter-name*' -This warning indicates that an integer offset into the specified nonstack array exceeds the maximum bounds of that array, causing undefined behavior and potentially crashes. - ## Remarks +This warning indicates that an integer offset into the specified nonstack array exceeds the maximum bounds of that array, causing undefined behavior and potentially crashes. + One common cause of this defect is using the size of an array as an index into the array. Because C/C++ array indexing is zero-based, the maximum legal index into an array is one less than the number of array elements. Code analysis name: `INDEX_EXCEEDS_MAX_NONSTACK` @@ -71,3 +70,16 @@ void f() ``` Code analysis doesn't warn with just `rand()` because it doesn't have any information about its return value. On the other hand, `rand() % 15` and `rand() % 14` provide hints as to the range of the return value of `rand()` and code analysis can use that information to determine that the index is out of bounds in the first case but not the second. + +## Disable warning C6200 + +You can disable this warning project-wide by passing the compiler switch `/wd6200`. If you want a more targeted solution, surround the code that generates the warning with: + +```cpp + #pragma warning(push) // save which warnings are enabled/disabled + #pragma warning(disable: 6200) // suppress this warning only in this block + // ... code that intentionally generates C6200 + #pragma warning(pop) // restore the warning state saved with the previous push +``` + +To learn more about pragma directives, see [warning pragma](../preprocessor/warning.md). diff --git a/docs/code-quality/c6201.md b/docs/code-quality/c6201.md index 85118a0503d..c1ec04f38cc 100644 --- a/docs/code-quality/c6201.md +++ b/docs/code-quality/c6201.md @@ -1,6 +1,6 @@ --- +title: "Warning C6201" description: "Learn more about: Warning C6201" -title: Warning C6201 ms.date: 11/17/2023 f1_keywords: ["C6201", "INDEX_EXCEEDS_MAX", "__WARNING_INDEX_EXCEEDS_MAX"] helpviewer_keywords: ["C6201"] @@ -9,10 +9,10 @@ helpviewer_keywords: ["C6201"] > Index '*index-name*' is out of valid index range '*minimum*' to '*maximum*' for possibly stack allocated buffer '*variable*' -This warning indicates that an integer offset into the specified stack array exceeds the maximum bounds of that array. It might potentially cause stack overflow errors, undefined behavior, or crashes. - ## Remarks +This warning indicates that an integer offset into the specified stack array exceeds the maximum bounds of that array. It might potentially cause stack overflow errors, undefined behavior, or crashes. + One common cause of this defect is using an array's size as an index into the array. Because C/C++ array indexing is zero-based, the maximum legal index into an array is one less than the number of array elements. Code analysis name: `INDEX_EXCEEDS_MAX` diff --git a/docs/code-quality/c6211.md b/docs/code-quality/c6211.md index 10fe4fad3bb..015ad0081c3 100644 --- a/docs/code-quality/c6211.md +++ b/docs/code-quality/c6211.md @@ -1,19 +1,18 @@ --- +title: "Warning C6211" description: "Learn more about: Warning C6211" -title: Warning C6211 ms.date: 10/03/2022 f1_keywords: ["C6211", "MEMORY_LEAK_EXCEPTION", "__WARNING_MEMORY_LEAK_EXCEPTION"] helpviewer_keywords: ["C6211"] -ms.assetid: 9b68243b-534c-4a05-b789-bb155dfcba1e --- # Warning C6211 > Leaking memory '*pointer*' due to an exception. Consider using a local catch block to clean up memory -This warning indicates that allocated memory isn't freed when an exception is thrown. The statement at the end of the path could throw an exception. - ## Remarks +This warning indicates that allocated memory isn't freed when an exception is thrown. The statement at the end of the path could throw an exception. + The analyzer checks for this condition only when the `_Analysis_mode_(_Analysis_local_leak_checks_)` SAL annotation is specified. By default, this annotation is specified for Windows kernel mode (driver) code. For more information about SAL annotations, see [Using SAL Annotations to Reduce C/C++ Code Defects](../code-quality/using-sal-annotations-to-reduce-c-cpp-code-defects.md). Code analysis name: `MEMORY_LEAK_EXCEPTION` diff --git a/docs/code-quality/c6214.md b/docs/code-quality/c6214.md index 81284cb8b74..719f5333c2d 100644 --- a/docs/code-quality/c6214.md +++ b/docs/code-quality/c6214.md @@ -1,19 +1,18 @@ --- +title: "Warning C6214" description: "Learn more about: Warning C6214" -title: Warning C6214 ms.date: 10/03/2022 f1_keywords: ["C6214", "CAST_HRESULT_TO_BOOL", "__WARNING_CAST_HRESULT_TO_BOOL"] helpviewer_keywords: ["C6214"] -ms.assetid: 233e2395-61c1-4a3b-a54b-f19a9ffc31a8 --- # Warning C6214 > Cast between semantically different integer types: HRESULT to a Boolean type -This warning indicates that an `HRESULT` is being cast to a Boolean type. The success value (`S_OK`) of an `HRESULT` equals 0. However, 0 indicates failure for a Boolean type. Casting an `HRESULT` to a Boolean type and then using it in a test expression will yield an incorrect result. - ## Remarks +This warning indicates that an `HRESULT` is being cast to a Boolean type. The success value (`S_OK`) of an `HRESULT` equals 0. However, 0 indicates failure for a Boolean type. Casting an `HRESULT` to a Boolean type and then using it in a test expression will yield an incorrect result. + Sometimes, this warning occurs if an `HRESULT` is being stored in a Boolean variable. Any comparison that uses the Boolean variable to test for `HRESULT` success or failure could lead to incorrect results. Code analysis name: `CAST_HRESULT_TO_BOOL` diff --git a/docs/code-quality/c6215.md b/docs/code-quality/c6215.md index 9e58ca0e1fa..ef513041b8b 100644 --- a/docs/code-quality/c6215.md +++ b/docs/code-quality/c6215.md @@ -1,19 +1,18 @@ --- +title: "Warning C6215" description: "Learn more about: Warning C6215" -title: Warning C6215 ms.date: 11/04/2016 f1_keywords: ["C6215", "CAST_BOOL_TO_HRESULT", "__WARNING_CAST_BOOL_TO_HRESULT"] helpviewer_keywords: ["C6215"] -ms.assetid: f20cc258-9c0f-4eaa-828d-74f76580ca78 --- # Warning C6215 > Cast between semantically different integer types: a Boolean type to HRESULT -This warning indicates that a Boolean is being cast to an `HRESULT`. Boolean types indicate success by a non-zero value, whereas success (`S_OK`) in `HRESULT` is indicated by a value of 0. Casting a Boolean type to an `HRESULT` and then using it in a test expression will yield an incorrect result. - ## Remarks +This warning indicates that a Boolean is being cast to an `HRESULT`. Boolean types indicate success by a non-zero value, whereas success (`S_OK`) in `HRESULT` is indicated by a value of 0. Casting a Boolean type to an `HRESULT` and then using it in a test expression will yield an incorrect result. + This warning frequently occurs when a Boolean is used as an argument to `SUCCEEDED` or `FAILED` macro, which explicitly casts their arguments to an `HRESULT`. Code analysis name: `CAST_BOOL_TO_HRESULT` diff --git a/docs/code-quality/c6216.md b/docs/code-quality/c6216.md index 4f7cb22742b..b796a0da137 100644 --- a/docs/code-quality/c6216.md +++ b/docs/code-quality/c6216.md @@ -1,19 +1,18 @@ --- +title: "Warning C6216" description: "Learn more about: Warning C6216" -title: Warning C6216 ms.date: 11/04/2016 f1_keywords: ["C6216", "COMPILER_INSERTED_CAST_BOOL_TO_HRESULT", "__WARNING_COMPILER_INSERTED_CAST_BOOL_TO_HRESULT"] helpviewer_keywords: ["C6216"] -ms.assetid: d5c4dcf9-bfd7-4604-804f-9cc41b08d060 --- # Warning C6216 > Compiler-inserted cast between semantically different integral types: a Boolean type to HRESULT -A Boolean type is being used as an `HRESULT` without being explicitly cast. - ## Remarks +A Boolean type is being used as an `HRESULT` without being explicitly cast. + Boolean types indicate success by a non-zero value; success (`S_OK`) in `HRESULT` is indicated by a value of 0. A Boolean `false` value used as an `HRESULT` would indicate `S_OK`, which is frequently a mistake. Code analysis name: `COMPILER_INSERTED_CAST_BOOL_TO_HRESULT` diff --git a/docs/code-quality/c6217.md b/docs/code-quality/c6217.md index 410cfb0fa56..042364717e6 100644 --- a/docs/code-quality/c6217.md +++ b/docs/code-quality/c6217.md @@ -1,6 +1,6 @@ --- +title: "Warning C6217" description: "Learn more about: Warning C6217" -title: Warning C6217 ms.date: 2/07/2023 f1_keywords: ["C6217", "TESTING_HRESULT_WITH_NOT", "__WARNING_TESTING_HRESULT_WITH_NOT"] helpviewer_keywords: ["C6217"] diff --git a/docs/code-quality/c6219.md b/docs/code-quality/c6219.md index 0533f905121..3dabeed9296 100644 --- a/docs/code-quality/c6219.md +++ b/docs/code-quality/c6219.md @@ -1,10 +1,9 @@ --- +title: "Warning C6219" description: "Learn more about: Warning C6219" -title: Warning C6219 ms.date: 11/04/2016 f1_keywords: ["C6219", "COMPARING_HRESULT_TO_ONE", "__WARNING_COMPARING_HRESULT_TO_ONE"] helpviewer_keywords: ["C6219"] -ms.assetid: 889a2de8-c0dc-4e8e-a46b-735384202675 --- # Warning C6219 diff --git a/docs/code-quality/c6220.md b/docs/code-quality/c6220.md index aa09af7c416..b0ad41d021d 100644 --- a/docs/code-quality/c6220.md +++ b/docs/code-quality/c6220.md @@ -1,26 +1,25 @@ --- +title: "Warning C6220" description: "Learn more about: Warning C6220" -title: Warning C6220 ms.date: 10/03/2022 f1_keywords: ["C6220", "COMPARING_HRESULT_TO_MINUS_ONE", "__WARNING_COMPARING_HRESULT_TO_MINUS_ONE"] helpviewer_keywords: ["C6220"] -ms.assetid: a13524f4-0a1f-4670-b830-70b06e4d39d2 --- # Warning C6220 > Implicit cast between semantically different integer types: comparing HRESULT to -1. Consider using `SUCCEEDED` or `FAILED` macro instead -This warning indicates that an `HRESULT` is being compared with an explicit, non-`HRESULT` value of -1, which isn't a well-formed `HRESULT`. - ## Remarks +This warning indicates that an `HRESULT` is being compared with an explicit, non-`HRESULT` value of -1, which isn't a well-formed `HRESULT`. + A failure in `HRESULT` (`E_FAIL`) isn't represented by a -1. Therefore, an implicit cast of an `HRESULT` to an integer will generate an incorrect value and is likely to lead to the wrong result. Code analysis name: `COMPARING_HRESULT_TO_MINUS_ONE` ## Example -In most cases, warning C6220 is caused by code that mistakenly expects a function to return an integer, and to use -1 as a failure value, but instead the function returns an `HRESULT`. The following code sample generates this warning: +In most cases, warning C6220 is caused by code that mistakenly expects a function to return an integer, and to use -1 as a failure value, but instead the function returns an `HRESULT`. The following code example generates this warning: ```cpp #include diff --git a/docs/code-quality/c6221.md b/docs/code-quality/c6221.md index 4a6dc472a44..c4c2e80c8d5 100644 --- a/docs/code-quality/c6221.md +++ b/docs/code-quality/c6221.md @@ -1,19 +1,18 @@ --- +title: "Warning C6221" description: "Learn more about: Warning C6221" -title: Warning C6221 ms.date: 10/03/2022 f1_keywords: ["C6221", "COMPARING_HRESULT_TO_INT", "__WARNING_COMPARING_HRESULT_TO_INT"] helpviewer_keywords: ["C6221"] -ms.assetid: b07989b7-f50f-46e0-8ed8-d9269b3d3580 --- # Warning C6221 > Implicit cast between semantically different integer types: comparing HRESULT to an integer. Consider using `SUCCEEDED` or `FAILED` macros instead -This warning indicates that an `HRESULT` is being compared to an integer other than zero. - ## Remarks +This warning indicates that an `HRESULT` is being compared to an integer other than zero. + A success in an `HRESULT` (`S_OK`) is represented by a 0. Therefore, an implicit cast of an `HRESULT` to an integer generates an incorrect value and is likely to lead to the wrong result. The error is often caused by mistakenly expecting a function to return an integer when it actually returns an `HRESULT`. Code analysis name: `COMPARING_HRESULT_TO_INT` diff --git a/docs/code-quality/c6225.md b/docs/code-quality/c6225.md index 67997f7decd..9e792a74553 100644 --- a/docs/code-quality/c6225.md +++ b/docs/code-quality/c6225.md @@ -1,19 +1,18 @@ --- +title: "Warning C6225" description: "Learn more about: Warning C6225" -title: Warning C6225 ms.date: 10/03/2022 f1_keywords: ["C6225", "ASSIGNING_ONE_TO_HRESULT", "__WARNING_ASSIGNING_ONE_TO_HRESULT"] helpviewer_keywords: ["C6225"] -ms.assetid: 2d98ffec-9842-4cd1-b1a9-9ac9d1d2a136 --- # Warning C6225 > Implicit cast between semantically different integer types: assigning 1 or `TRUE` to `HRESULT`. Consider using `S_FALSE` instead -This warning indicates that an `HRESULT` is being assigned or initialized with a value of an explicit 1. Boolean types indicate success by a non-zero value; success (`S_OK`) in `HRESULT` is indicated by a value of 0. - ## Remarks +This warning indicates that an `HRESULT` is being assigned or initialized with a value of an explicit 1. Boolean types indicate success by a non-zero value; success (`S_OK`) in `HRESULT` is indicated by a value of 0. + This warning is frequently caused by accidental confusion of Boolean and `HRESULT` types. To indicate success, the symbolic constant `S_OK` should be used. Code analysis name: `ASSIGNING_ONE_TO_HRESULT` diff --git a/docs/code-quality/c6226.md b/docs/code-quality/c6226.md index 2a7ed4d40a3..48fcb9f1f07 100644 --- a/docs/code-quality/c6226.md +++ b/docs/code-quality/c6226.md @@ -1,19 +1,18 @@ --- +title: "Warning C6226" description: "Learn more about: Warning C6226" -title: Warning C6226 ms.date: 11/04/2016 f1_keywords: ["C6226", "ASSIGNING_MINUS_ONE_TO_HRESULT", "__WARNING_ASSIGNING_MINUS_ONE_TO_HRESULT"] helpviewer_keywords: ["C6226"] -ms.assetid: c18aa576-b316-4f11-b48f-f5183fa49c7c --- # Warning C6226 > Implicit cast between semantically different integer types: assigning -1 to HRESULT. Consider using E_FAIL instead. -This warning indicates that an `HRESULT` is assigned or initialized to an explicit value of -1. - ## Remarks +This warning indicates that an `HRESULT` is assigned or initialized to an explicit value of -1. + This warning is frequently caused by accidental confusion of integer and `HRESULT` types. To indicate success, use the symbolic constant `S_OK` instead. To indicate failure, use the symbolic constants that start with E_*constant*, such as `E_FAIL`. For more information, see the [`SUCCEEDED`](/windows/desktop/api/winerror/nf-winerror-succeeded) and [`FAILED`](/windows/desktop/api/winerror/nf-winerror-failed) macros. diff --git a/docs/code-quality/c6230.md b/docs/code-quality/c6230.md index 69c8b130482..ae8a8308813 100644 --- a/docs/code-quality/c6230.md +++ b/docs/code-quality/c6230.md @@ -1,10 +1,9 @@ --- +title: "Warning C6230" description: "Learn more about: Warning C6230" -title: Warning C6230 ms.date: 11/04/2016 f1_keywords: ["C6230", "USING_HRESULT_IN_BOOLEAN_CONTEXT", "__WARNING_USING_HRESULT_IN_BOOLEAN_CONTEXT"] helpviewer_keywords: ["C6230"] -ms.assetid: aa91291d-cdc5-4720-89d4-194ce0557e99 --- # Warning C6230 diff --git a/docs/code-quality/c6235.md b/docs/code-quality/c6235.md index 3259ac77f37..b94279a6979 100644 --- a/docs/code-quality/c6235.md +++ b/docs/code-quality/c6235.md @@ -1,19 +1,18 @@ --- +title: "Warning C6235" description: "Learn more about: Warning C6235" -title: Warning C6235 ms.date: 11/04/2016 f1_keywords: ["C6235", "NONZEROLOGICALOR", "__WARNING_NONZEROLOGICALOR"] helpviewer_keywords: ["C6235"] -ms.assetid: e225955e-0bb5-43a4-a83d-83290e209df4 --- # Warning C6235 > ('*non-zero constant*' \|\| '*expression*') is always a non-zero constant -This warning indicates that a non-zero constant value, other than one, was detected on the left side of a logical-or operation that occurs in a test context. The right side of the logical-or operation isn't evaluated because the resulting expression always evaluates to true. This language feature is referred to as "short-circuit evaluation." - ## Remarks +This warning indicates that a non-zero constant value, other than one, was detected on the left side of a logical-or operation that occurs in a test context. The right side of the logical-or operation isn't evaluated because the resulting expression always evaluates to true. This language feature is referred to as "short-circuit evaluation." + A non-zero constant value, other than one, suggests that the bitwise-AND operator (`&`) may have been intended. This warning isn't generated for the common idiom when the non-zero constant is 1, because of its use for selectively enabling code paths. However, it's generated if the non-zero constant evaluates to 1, for example `1+0`. Code analysis name: `NONZEROLOGICALOR` diff --git a/docs/code-quality/c6236.md b/docs/code-quality/c6236.md index b75a4c19048..fd1b5c35e91 100644 --- a/docs/code-quality/c6236.md +++ b/docs/code-quality/c6236.md @@ -1,19 +1,18 @@ --- +title: "Warning C6236" description: "Learn more about: Warning C6236" -title: Warning C6236 ms.date: 11/04/2016 f1_keywords: ["C6236", "LOGICALORNONZERO", "__WARNING_LOGICALORNONZERO"] helpviewer_keywords: ["C6236"] -ms.assetid: 3d5ae268-6f40-4c45-a483-b5b0e6a808fc --- # Warning C6236 > ('*expression*' \|\| '*non-zero constant*') is always a non-zero constant -This warning indicates that a non-zero constant value, other than one, was detected on the right side of a logical OR operation that occurs in a test context. Logically, it implies that the test is redundant and can be removed safely. Alternatively, it suggests that the programmer may have intended to use a different operator, for example, the equality (`==`), bitwise-AND (`&`) or bitwise-XOR (`^`) operator, to test for a specific value or flag. - ## Remarks +This warning indicates that a non-zero constant value, other than one, was detected on the right side of a logical OR operation that occurs in a test context. Logically, it implies that the test is redundant and can be removed safely. Alternatively, it suggests that the programmer may have intended to use a different operator, for example, the equality (`==`), bitwise-AND (`&`) or bitwise-XOR (`^`) operator, to test for a specific value or flag. + This warning isn't generated for the common idiom when the non-zero constant is 1, because of its use for selectively enabling code paths at compile time. However, the warning is generated if the non-zero constant is formed by an expression that evaluates to 1, for example, 1 + 0. Code analysis name: `LOGICALORNONZERO` diff --git a/docs/code-quality/c6237.md b/docs/code-quality/c6237.md index e80bb7c8e2c..8518bd67ad8 100644 --- a/docs/code-quality/c6237.md +++ b/docs/code-quality/c6237.md @@ -1,19 +1,18 @@ --- +title: "Warning C6237" description: "Learn more about: Warning C6237" -title: Warning C6237 ms.date: 11/04/2016 f1_keywords: ["C6237", "ZEROLOGICALANDLOSINGSIDEEFFECTS", "__WARNING_ZEROLOGICALANDLOSINGSIDEEFFECTS"] helpviewer_keywords: ["C6237"] -ms.assetid: a18d8630-e4d6-4132-b976-c1f3e7c5c3f0 --- # Warning C6237 > ('*zero*' && '*expression*') is always zero. '*expression*' is never evaluated and may have side effects -This warning indicates that a constant value of zero was detected on the left side of a logical-and operation that occurs in a test context. The resulting expression always evaluates to false. Therefore, the right side of the logical-AND operation isn't evaluated. This language feature is referred to as "short-circuit evaluation." - ## Remarks +This warning indicates that a constant value of zero was detected on the left side of a logical-and operation that occurs in a test context. The resulting expression always evaluates to false. Therefore, the right side of the logical-AND operation isn't evaluated. This language feature is referred to as "short-circuit evaluation." + You should examine the right side of the expression carefully: Ensure that any side effects such as assignment, function call, increment, and decrement operations needed for proper functionality aren't affected by the short-circuit evaluation. The expression (`0 && n`) produces no side effects and is commonly used to selectively choose code paths. @@ -22,7 +21,7 @@ Code analysis name: `ZEROLOGICALANDLOSINGSIDEEFFECTS` ## Example -The following code shows various code samples that generate this warning: +The following code shows various code examples that generate this warning: ```cpp #include diff --git a/docs/code-quality/c6239.md b/docs/code-quality/c6239.md index de5189b9b33..0bf4cc1cb50 100644 --- a/docs/code-quality/c6239.md +++ b/docs/code-quality/c6239.md @@ -1,19 +1,18 @@ --- +title: "Warning C6239" description: "Learn more about: Warning C6239" -title: Warning C6239 ms.date: 11/04/2016 f1_keywords: ["C6239", "NONZEROLOGICALAND", "__WARNING_NONZEROLOGICALAND"] helpviewer_keywords: ["C6239"] -ms.assetid: c80e02bc-ff54-4fde-8c1c-5852853bed24 --- # Warning C6239 > ('*non-zero constant*' && '*expression*') always evaluates to the result of '*expression*'. Did you intend to use the bitwise-and operator? -This warning indicates that a non-zero constant value, other than one, was detected on the left side of a logical-AND operation that occurs in a test context. For example, the expression `( 2 && n )` is reduced to `(!!n)`, which is the Boolean value of `n`. - ## Remarks +This warning indicates that a non-zero constant value, other than one, was detected on the left side of a logical-AND operation that occurs in a test context. For example, the expression `( 2 && n )` is reduced to `(!!n)`, which is the Boolean value of `n`. + This warning typically indicates an attempt to check a bit mask in which the bitwise-AND (`&`) operator should be used, and isn't generated if the non-zero constant evaluates to 1 because of its use for selectively choosing code paths. Code analysis name: `NONZEROLOGICALAND` diff --git a/docs/code-quality/c6240.md b/docs/code-quality/c6240.md index 1e44d46db25..7ed90bcdd6a 100644 --- a/docs/code-quality/c6240.md +++ b/docs/code-quality/c6240.md @@ -1,19 +1,18 @@ --- +title: "Warning C6240" description: "Learn more about: Warning C6240" -title: Warning C6240 ms.date: 11/04/2016 f1_keywords: ["C6240", "LOGICALANDNONZERO", "__WARNING_LOGICALANDNONZERO"] helpviewer_keywords: ["C6240"] -ms.assetid: b9412ae4-622d-4aed-8c34-b67db1ccd48a --- # Warning C6240 > ('*expression*' && '*non-zero constant*') always evaluates to the result of '*expression*'. Did you intend to use the bitwise-and operator? -This warning indicates that a non-zero constant value, other than one, was detected on the right side of a logical-and operation that occurs in a test context. For example, the expression `(n && 3)` reduces to `(!!n)`, which is the Boolean value of `n`. - ## Remarks +This warning indicates that a non-zero constant value, other than one, was detected on the right side of a logical-and operation that occurs in a test context. For example, the expression `(n && 3)` reduces to `(!!n)`, which is the Boolean value of `n`. + This warning typically indicates an attempt to check a bit mask in which the bitwise-AND (`&`) operator should be used. It isn't generated if the non-zero constant evaluates to 1 because of its use for selectively choosing code paths. Code analysis name: `LOGICALANDNONZERO` diff --git a/docs/code-quality/c6242.md b/docs/code-quality/c6242.md index cdb9a7534ca..783981a099c 100644 --- a/docs/code-quality/c6242.md +++ b/docs/code-quality/c6242.md @@ -1,19 +1,18 @@ --- -title: Warning C6242 +title: "Warning C6242" description: "Describes Microsoft C/C++ compiler warning C6242." ms.date: 08/24/2020 f1_keywords: ["C6242", "LOCALUNWINDFORCED", "__WARNING_LOCALUNWINDFORCED"] helpviewer_keywords: ["C6242"] -ms.assetid: 523d46ce-8370-434c-a752-2e3a18cca9a5 --- # Warning C6242 > A jump out of this try-block forces local unwind. Incurs severe performance penalty -This warning indicates that a jump statement causes control-flow to leave the protected block of a `try-finally` other than by fall-through. - ## Remarks +This warning indicates that a jump statement causes control-flow to leave the protected block of a `try-finally` other than by fall-through. + Leaving the protected block of a `try-finally` other than by falling through from the last statement requires local unwind to occur. Local unwind typically requires approximately 1000 machine instructions, so it's detrimental to performance. Use **`__leave`** to exit the protected block of a try-finally. diff --git a/docs/code-quality/c6244.md b/docs/code-quality/c6244.md index b37d7c116d0..fa539eeac6c 100644 --- a/docs/code-quality/c6244.md +++ b/docs/code-quality/c6244.md @@ -1,10 +1,9 @@ --- +title: "Warning C6244" description: "Learn more about: Warning C6244" -title: Warning C6244 ms.date: 11/04/2016 f1_keywords: ["C6244", "LOCALDECLHIDESGLOBAL", "__WARNING_LOCALDECLHIDESGLOBAL"] helpviewer_keywords: ["C6244"] -ms.assetid: ce2c853d-3354-40f2-a8c5-569f6e4bfc0a --- # Warning C6244 @@ -42,7 +41,7 @@ void test() #pragma warning(pop) ``` -To correct this warning, use the following sample code: +To correct this warning, use the following example code: ```cpp #include diff --git a/docs/code-quality/c6246.md b/docs/code-quality/c6246.md index 7e4e33f786d..611da41b47e 100644 --- a/docs/code-quality/c6246.md +++ b/docs/code-quality/c6246.md @@ -1,10 +1,9 @@ --- +title: "Warning C6246" description: "Learn more about: Warning C6246" -title: Warning C6246 ms.date: 11/04/2016 f1_keywords: ["C6246", "LOCALDECLHIDESLOCAL", "__WARNING_LOCALDECLHIDESLOCAL"] helpviewer_keywords: ["C6246"] -ms.assetid: cd895cdb-ab3b-4671-ab43-419228fbf980 --- # Warning C6246 diff --git a/docs/code-quality/c6248.md b/docs/code-quality/c6248.md index f91fd895f45..6b85cdf3699 100644 --- a/docs/code-quality/c6248.md +++ b/docs/code-quality/c6248.md @@ -1,10 +1,9 @@ --- +title: "Warning C6248" description: "Learn more about: Warning C6248" -title: Warning C6248 ms.date: 08/16/2022 f1_keywords: ["C6248", "__WARNING_CREATINGNULLDACL", "CREATINGNULLDACL"] helpviewer_keywords: ["C6248"] -ms.assetid: 75743622-7a79-4fe8-81b9-dbdfa1a12f3d --- # Warning C6248 diff --git a/docs/code-quality/c6250.md b/docs/code-quality/c6250.md index c57c22512c1..aab691615a8 100644 --- a/docs/code-quality/c6250.md +++ b/docs/code-quality/c6250.md @@ -1,19 +1,18 @@ --- +title: "Warning C6250" description: "Learn more about: Warning C6250" -title: Warning C6250 ms.date: 10/03/2022 f1_keywords: ["C6250", "WIN32UNRELEASEDVADS", "__WARNING_WIN32UNRELEASEDVADS"] helpviewer_keywords: ["C6250"] -ms.assetid: 6949c9c5-e8bd-4f95-bc80-42073a293357 --- # Warning C6250 > Calling 'VirtualFree' without the MEM_RELEASE flag may free memory but not address descriptors (VADs); results in address space leaks -This warning indicates that a call to `VirtualFree` without the `MEM_RELEASE` flag only decommits the pages, and doesn't release them. To both decommit and release pages, use the `MEM_RELEASE` flag in the call to `VirtualFree`. If any pages in the region are committed, the function first decommits and then releases them. After this operation, the pages are in the free state. If you specify this flag, `dwSize` must be zero, and `lpAddress` must point to the base address returned by the `VirtualAlloc` function when the region was reserved. The function fails if either of these conditions isn't met. - ## Remarks +This warning indicates that a call to `VirtualFree` without the `MEM_RELEASE` flag only decommits the pages, and doesn't release them. To both decommit and release pages, use the `MEM_RELEASE` flag in the call to `VirtualFree`. If any pages in the region are committed, the function first decommits and then releases them. After this operation, the pages are in the free state. If you specify this flag, `dwSize` must be zero, and `lpAddress` must point to the base address returned by the `VirtualAlloc` function when the region was reserved. The function fails if either of these conditions isn't met. + You can ignore this warning if your code later frees the address space by calling `VirtualFree` with the `MEM_RELEASE` flag. For more information, see [`VirtualAlloc`](/windows/win32/api/memoryapi/nf-memoryapi-virtualalloc) and [`VirtualFree`](/windows/win32/api/memoryapi/nf-memoryapi-virtualfree). @@ -24,7 +23,7 @@ Code analysis name: `WIN32UNRELEASEDVADS` ## Example -The following sample code generates warning C6250: +The following example code generates warning C6250: ```cpp #include @@ -70,7 +69,7 @@ VOID f( ) } ``` -To correct this warning, use the following sample code: +To correct this warning, use the following example code: ```cpp #include diff --git a/docs/code-quality/c6255.md b/docs/code-quality/c6255.md index 43f53740cee..c8859f60aea 100644 --- a/docs/code-quality/c6255.md +++ b/docs/code-quality/c6255.md @@ -1,19 +1,18 @@ --- +title: "Warning C6255" description: "Learn more about: Warning C6255" -title: Warning C6255 ms.date: 11/04/2016 f1_keywords: ["C6255", "UNPROTECTEDUSEOFALLOCA", "__WARNING_UNPROTECTEDUSEOFALLOCA"] helpviewer_keywords: ["C6255"] -ms.assetid: bb6430b2-782a-4410-a8e1-609df06007de --- # Warning C6255 > _alloca indicates failure by raising a stack overflow exception. Consider using _malloca instead -This warning indicates that a call to `_alloca` has been detected outside of local exception handling. - ## Remarks +This warning indicates that a call to `_alloca` has been detected outside of local exception handling. + `_alloca` should always be called from within the protected range of an exception handler because it can raise a stack overflow exception on failure. If possible, instead of using `_alloca`, consider using `_malloca`, which is a more secure version of `_alloca`. Code analysis name: `UNPROTECTEDUSEOFALLOCA` diff --git a/docs/code-quality/c6258.md b/docs/code-quality/c6258.md index c6c0716a6d0..e9efa609a9d 100644 --- a/docs/code-quality/c6258.md +++ b/docs/code-quality/c6258.md @@ -1,19 +1,18 @@ --- +title: "Warning C6258" description: "Learn more about: Warning C6258" -title: Warning C6258 ms.date: 11/04/2016 f1_keywords: ["C6258", "USINGTERMINATETHREAD", "__WARNING_USINGTERMINATETHREAD"] helpviewer_keywords: ["C6258"] -ms.assetid: 62f3eed7-d9cd-46eb-8c38-0bc4f647941f --- # Warning C6258 > Using `TerminateThread` does not allow proper thread clean up. -This warning indicates that a call to `TerminateThread` has been detected. - ## Remarks +This warning indicates that a call to `TerminateThread` has been detected. + `TerminateThread` is a dangerous function that should only be used in the most extreme cases. For more information about problems associated with TerminateThread call, see [`TerminateThread` function](/windows/desktop/api/processthreadsapi/nf-processthreadsapi-terminatethread). Code analysis name: `USINGTERMINATETHREAD` diff --git a/docs/code-quality/c6259.md b/docs/code-quality/c6259.md index 6819a938cdc..07203450c55 100644 --- a/docs/code-quality/c6259.md +++ b/docs/code-quality/c6259.md @@ -1,10 +1,9 @@ --- +title: "Warning C6259" description: "Learn more about: Warning C6259" -title: Warning C6259 ms.date: 11/04/2016 f1_keywords: ["C6259", "DEADCODEINBITORLIMITEDSWITCH", "__WARNING_DEADCODEINBITORLIMITEDSWITCH"] helpviewer_keywords: ["C6259"] -ms.assetid: a370bfd2-6634-402c-84c7-3d83fa0009b7 --- # Warning C6259 @@ -18,7 +17,7 @@ Code analysis name: `DEADCODEINBITORLIMITEDSWITCH` ## Example -The following sample code generates this warning because the 'switch' expression `(rand() & 3)` can't evaluate to case label (`case 4`): +The following example code generates this warning because the 'switch' expression `(rand() & 3)` can't evaluate to case label (`case 4`): ```cpp #include diff --git a/docs/code-quality/c6260.md b/docs/code-quality/c6260.md index ed765072581..41c4541cf36 100644 --- a/docs/code-quality/c6260.md +++ b/docs/code-quality/c6260.md @@ -1,19 +1,18 @@ --- +title: "Warning C6260" description: "Learn more about: Warning C6260" -title: Warning C6260 ms.date: 11/04/2016 f1_keywords: ["C6260", "USEOFBYTEAREA", "__WARNING_USEOFBYTEAREA"] helpviewer_keywords: ["C6260"] -ms.assetid: 9cbedfcb-32b2-4fe4-99f7-a2d4a7f4422a --- # Warning C6260 > `sizeof` * `sizeof` is almost always wrong, did you intend to use a character count or a byte count? -This warning indicates that the results of two **`sizeof`** operations have been multiplied together. - ## Remarks +This warning indicates that the results of two **`sizeof`** operations have been multiplied together. + The C/C++ **`sizeof`** operator returns the number of bytes of storage an object uses. It's typically incorrect to multiply it by another **`sizeof`** operation. Usually, you're interested in the number of bytes in an object or the number of elements in an array (for example, the number of wide-characters in an array). There's some unintuitive behavior associated with **`sizeof`** operator. For example, in C, `sizeof ('\0') == 4`, because a character is of an integral type. In C++, the type of a character literal is **`char`**, so `sizeof ('\0') == 1`. However, in both C and C++, the following relation is true: diff --git a/docs/code-quality/c6262.md b/docs/code-quality/c6262.md index 775784567c4..1280eed743c 100644 --- a/docs/code-quality/c6262.md +++ b/docs/code-quality/c6262.md @@ -1,5 +1,5 @@ --- -title: Warning C6262 +title: "Warning C6262" description: "Visual Studio C++ Code Analysis warning C6262 description and resolution." ms.date: 10/14/2020 f1_keywords: ["C6262", "EXCESSIVESTACKUSAGE", "__WARNING_EXCESSIVESTACKUSAGE"] diff --git a/docs/code-quality/c6263.md b/docs/code-quality/c6263.md index a232723446f..3d8b854aa72 100644 --- a/docs/code-quality/c6263.md +++ b/docs/code-quality/c6263.md @@ -1,10 +1,9 @@ --- +title: "Warning C6263" description: "Learn more about: Warning C6263" -title: Warning C6263 ms.date: 11/04/2016 f1_keywords: ["C6263", "USINGALLOCAINLOOP", "__WARNING_USINGALLOCAINLOOP"] helpviewer_keywords: ["C6263"] -ms.assetid: bc360ad7-5f59-4480-a642-6c7e6beeb5f6 --- # Warning C6263 diff --git a/docs/code-quality/c6268.md b/docs/code-quality/c6268.md index 49ae372e517..758c5b3a36b 100644 --- a/docs/code-quality/c6268.md +++ b/docs/code-quality/c6268.md @@ -1,19 +1,18 @@ --- +title: "Warning C6268" description: "Learn more about: Warning C6268" -title: Warning C6268 ms.date: 11/04/2016 f1_keywords: ["C6268", "MISPARENTHESIZED_CASTS", "__WARNING_MISPARENTHESIZED_CASTS"] helpviewer_keywords: ["C6268"] -ms.assetid: fd81e00a-de2f-498b-b3fe-53ce056042d7 --- # Warning C6268 > Incorrect order of operations: ('*TYPE1*')('*TYPE2*')x + y. Possible missing parentheses in ('*TYPE1*')(('*TYPE2*')x + y) -This warning indicates that a complex cast expression might involve a precedence problem when performing pointer arithmetic. Because casts group more closely than binary operators, the result might not be what the programmer intended. In some cases, this defect causes incorrect behavior or a program crash. - ## Remarks +This warning indicates that a complex cast expression might involve a precedence problem when performing pointer arithmetic. Because casts group more closely than binary operators, the result might not be what the programmer intended. In some cases, this defect causes incorrect behavior or a program crash. + In an expression such as: ```cpp diff --git a/docs/code-quality/c6269.md b/docs/code-quality/c6269.md index d910880ed70..d7b26922a15 100644 --- a/docs/code-quality/c6269.md +++ b/docs/code-quality/c6269.md @@ -1,19 +1,18 @@ --- +title: "Warning C6269" description: "Learn more about: Warning C6269" -title: Warning C6269 ms.date: 11/04/2016 f1_keywords: ["C6269", "POINTER_DEREF_DISCARDED", "__WARNING_POINTER_DEREF_DISCARDED"] helpviewer_keywords: ["C6269"] -ms.assetid: a01fa7fa-fc6c-4af7-ac8c-585e44e60cca --- # Warning C6269 > Possible incorrect order of operations: dereference ignored -This warning indicates that the result of a pointer dereference is being ignored, which raises the question of why the pointer is being dereferenced in the first place. - ## Remarks +This warning indicates that the result of a pointer dereference is being ignored, which raises the question of why the pointer is being dereferenced in the first place. + The compiler will correctly optimize away the gratuitous dereference. In some cases, however, this defect may reflect a precedence or logic error. One common cause for this defect is an expression statement of the form: diff --git a/docs/code-quality/c6270.md b/docs/code-quality/c6270.md index 6a23a7f3057..ce3f1f68a54 100644 --- a/docs/code-quality/c6270.md +++ b/docs/code-quality/c6270.md @@ -1,6 +1,6 @@ --- +title: "Warning C6270" description: "Learn more about: Warning C6270" -title: Warning C6270 ms.date: 3/03/2023 f1_keywords: ["C6270", "MISSING_FLOAT_ARGUMENT_TO_FORMAT_FUNCTION", "__WARNING_MISSING_FLOAT_ARGUMENT_TO_FORMAT_FUNCTION"] helpviewer_keywords: ["C6270"] diff --git a/docs/code-quality/c6271.md b/docs/code-quality/c6271.md index 29c26267883..059c2c969f0 100644 --- a/docs/code-quality/c6271.md +++ b/docs/code-quality/c6271.md @@ -1,6 +1,6 @@ --- +title: "Warning C6271" description: "Learn more about: Warning C6271" -title: Warning C6271 ms.date: 3/06/2023 f1_keywords: ["C6271", "EXTRA_ARGUMENT_TO_FORMAT_FUNCTION", "__WARNING_EXTRA_ARGUMENT_TO_FORMAT_FUNCTION"] helpviewer_keywords: ["C6271"] @@ -17,7 +17,7 @@ Code analysis name: `EXTRA_ARGUMENT_TO_FORMAT_FUNCTION` ## Example -The following sample code generates this warning: +The following example code generates this warning: ```cpp #include @@ -43,7 +43,7 @@ void f() } ``` -The following sample code calls the safe string manipulation function, `sprintf_s`, to correct this warning: +The following example code calls the safe string manipulation function, `sprintf_s`, to correct this warning: ```cpp #include diff --git a/docs/code-quality/c6272.md b/docs/code-quality/c6272.md index 5a25de9b994..98cc4975756 100644 --- a/docs/code-quality/c6272.md +++ b/docs/code-quality/c6272.md @@ -1,6 +1,6 @@ --- +title: "Warning C6272" description: "Learn more about: Warning C6272" -title: Warning C6272 ms.date: 03/07/2023 f1_keywords: ["C6272", "NON_FLOAT_ARGUMENT_TO_FORMAT_FUNCTION", "__WARNING_NON_FLOAT_ARGUMENT_TO_FORMAT_FUNCTION"] helpviewer_keywords: ["C6272"] diff --git a/docs/code-quality/c6273.md b/docs/code-quality/c6273.md index 7bf741fbf4b..4a84e4345b0 100644 --- a/docs/code-quality/c6273.md +++ b/docs/code-quality/c6273.md @@ -1,6 +1,6 @@ --- +title: "Warning C6273" description: "Learn more about: Warning C6273" -title: Warning C6273 ms.date: 03/07/2023 f1_keywords: ["C6273", "NON_INTEGER_ARGUMENT_TO_FORMAT_FUNCTION", "__WARNING_NON_INTEGER_ARGUMENT_TO_FORMAT_FUNCTION"] helpviewer_keywords: ["C6273"] diff --git a/docs/code-quality/c6274.md b/docs/code-quality/c6274.md index 79412891722..8a324e84008 100644 --- a/docs/code-quality/c6274.md +++ b/docs/code-quality/c6274.md @@ -1,6 +1,6 @@ --- +title: "Warning C6274" description: "Learn more about: Warning C6274" -title: Warning C6274 ms.date: 03/07/2023 f1_keywords: ["C6274", "NON_CHAR_ARGUMENT_TO_FORMAT_FUNCTION", "__WARNING_NON_CHAR_ARGUMENT_TO_FORMAT_FUNCTION"] helpviewer_keywords: ["C6274"] diff --git a/docs/code-quality/c6276.md b/docs/code-quality/c6276.md index 88eb047af53..e31ce0bf0a4 100644 --- a/docs/code-quality/c6276.md +++ b/docs/code-quality/c6276.md @@ -1,19 +1,18 @@ --- +title: "Warning C6276" description: "Learn more about: Warning C6276" -title: Warning C6276 ms.date: 09/28/2022 f1_keywords: ["C6276", "CHAR_TO_WCHAR_CAST", "__WARNING_CHAR_TO_WCHAR_CAST"] helpviewer_keywords: ["C6276"] -ms.assetid: 88f288da-da81-4d32-ab0f-be9d01a2606a --- # Warning C6276 > Cast between semantically different string types. Use of invalid string can lead to undefined behavior. -This warning indicates a potentially incorrect cast from a narrow character string (`char*`) to a wide character string (`wchar_t*`). - ## Remarks +This warning indicates a potentially incorrect cast from a narrow character string (`char*`) to a wide character string (`wchar_t*`). + Because the Microsoft compiler implements wide strings with a character size of 2 bytes, casting from a narrow string might produce strings that aren't correctly terminated. If you use such strings with the `wcs*` functions in the runtime library, they could cause buffer overruns and access violations. Code analysis name: `CHAR_TO_WCHAR_CAST` diff --git a/docs/code-quality/c6277.md b/docs/code-quality/c6277.md index c01fd781f8a..9b80fad0fba 100644 --- a/docs/code-quality/c6277.md +++ b/docs/code-quality/c6277.md @@ -1,26 +1,25 @@ --- +title: "Warning C6277" description: "Learn more about: Warning C6277" -title: Warning C6277 ms.date: 09/28/2022 f1_keywords: ["C6277", "CREATEPROCESS_ESCAPE", "__WARNING_CREATEPROCESS_ESCAPE"] helpviewer_keywords: ["C6277"] -ms.assetid: 2b41252a-68c2-4e92-b005-0458db5f4430 --- # Warning C6277 > NULL application name with an unquoted path in call to '*function-name*': results in a security vulnerability if the path contains spaces -This warning indicates that the application name parameter is null and that there might be spaces in the executable path name. - ## Remarks +This warning indicates that the application name parameter is null and that there might be spaces in the executable path name. + Unless the executable name is fully qualified, there's likely to be a security problem. A malicious user could insert a rogue executable with the same name earlier in the path. To correct this warning, you can specify the application name instead of passing null. Alternatively, if you do pass null for the application name, use quotation marks around the executable path. Code analysis name: `CREATEPROCESS_ESCAPE` ## Example -The following sample code generates warning C6277. The warning is caused by the NULL application name and from the executable path name having a space. Due to how the function parses spaces, there's a risk that a different executable could be run. For more information, see [`CreateProcessA`](/windows/desktop/api/processthreadsapi/nf-processthreadsapi-createprocessa). +The following example code generates warning C6277. The warning is caused by the NULL application name and from the executable path name having a space. Due to how the function parses spaces, there's a risk that a different executable could be run. For more information, see [`CreateProcessA`](/windows/desktop/api/processthreadsapi/nf-processthreadsapi-createprocessa). ```cpp #include diff --git a/docs/code-quality/c6278.md b/docs/code-quality/c6278.md index 8ae400a83c7..44f9604a392 100644 --- a/docs/code-quality/c6278.md +++ b/docs/code-quality/c6278.md @@ -1,15 +1,18 @@ --- +title: "Warning C6278" description: "Learn more about: Warning C6278" -title: Warning C6278 ms.date: 10/03/2022 f1_keywords: ["C6278", "ARRAY_NEW_DELETE_MISMATCH", "__WARNING_ARRAY_NEW_DELETE_MISMATCH"] helpviewer_keywords: ["C6278"] -ms.assetid: 5cc3c393-c48a-4f91-9f38-03d7868be5e5 --- # Warning C6278 > '*variable*' is allocated with array new [], but deleted with scalar delete. Destructors will not be called. +## Notice + +Warning C6278 was removed in Visual Studio 2026. Use the more generic warning [`C26865`](../code-quality/C26865.md) instead. + ## Remarks This warning appears only in C++ code and indicates that the calling function has inconsistently allocated memory with the array **`new []`** operator, but freed it with the scalar **`delete`** operator. This usage is undefined behavior according to the C++ standard and the Microsoft C++ implementation. @@ -30,7 +33,7 @@ Code analysis name: `ARRAY_NEW_DELETE_MISMATCH` ## Example -The following sample code generates warning C6278: +The following example code generates warning C6278: ```cpp class A @@ -46,7 +49,7 @@ void f( ) } ``` -To correct this warning, use the following sample code: +To correct this warning, use the following example code: ```cpp void f( ) diff --git a/docs/code-quality/c6279.md b/docs/code-quality/c6279.md index ab28f2ecd13..4107dd19b22 100644 --- a/docs/code-quality/c6279.md +++ b/docs/code-quality/c6279.md @@ -1,10 +1,9 @@ --- +title: "Warning C6279" description: "Learn more about: Warning C6279" -title: Warning C6279 ms.date: 10/03/2022 f1_keywords: ["C6279", "NEW_ARRAY_DELETE_MISMATCH", "__WARNING_NEW_ARRAY_DELETE_MISMATCH"] helpviewer_keywords: ["C6279"] -ms.assetid: 0af88b58-35df-456f-8c02-e8eeffe3b7de --- # Warning C6279 @@ -12,8 +11,14 @@ ms.assetid: 0af88b58-35df-456f-8c02-e8eeffe3b7de This warning appears only in C++ code and indicates that the calling function has inconsistently allocated memory with the scalar `new` operator, but freed it with the array `delete[]` operator. If memory is allocated with scalar `new`, it should typically be freed with scalar `delete`. +## Notice + +Warning C6279 was removed in Visual Studio 2026. Use the more generic warning [`C26865`](../code-quality/C26865.md) instead. + ## Remarks +This warning appears only in C++ code and indicates that the calling function has inconsistently allocated memory with the scalar `new` operator, but freed it with the array `delete[]` operator. If memory is allocated with scalar `new`, it should typically be freed with scalar `delete`. + The exact ramifications of this defect are difficult to predict. It might cause random behavior or crashes due to usage of uninitialized memory as constructors aren't invoked. Or, it might cause memory allocations and crashes in situations where operators have been overridden. The analysis tool doesn't currently distinguish between these situations. To avoid these kinds of allocation problems altogether, use the mechanisms that are provided by the C++ Standard Library (STL). These include [`shared_ptr`](../standard-library/shared-ptr-class.md), [`unique_ptr`](../standard-library/unique-ptr-class.md), and containers such as [`vector`](../standard-library/vector.md). For more information, see [Smart pointers](../cpp/smart-pointers-modern-cpp.md) and [C++ Standard Library](../standard-library/cpp-standard-library-reference.md). diff --git a/docs/code-quality/c6280.md b/docs/code-quality/c6280.md index f03214777df..8d30cbf344f 100644 --- a/docs/code-quality/c6280.md +++ b/docs/code-quality/c6280.md @@ -1,10 +1,9 @@ --- +title: "Warning C6280" description: "Learn more about: Warning C6280" -title: Warning C6280 ms.date: 10/03/2022 f1_keywords: ["C6280", "MEMORY_ALLOCATION_MISMATCH", "__WARNING_MEMORY_ALLOCATION_MISMATCH"] helpviewer_keywords: ["C6280"] -ms.assetid: b91f2966-0876-4c9b-843a-e142f35be864 --- # Warning C6280 @@ -12,8 +11,14 @@ ms.assetid: b91f2966-0876-4c9b-843a-e142f35be864 This warning indicates that the calling function has inconsistently allocated memory by using a function from one family and freed it by using a function from another. +## Notice + +Warning C6280 was removed in Visual Studio 2026. Use the more generic warning [`C26865`](../code-quality/C26865.md) instead. + ## Remarks +This warning indicates that the calling function has inconsistently allocated memory by using a function from one family and freed it by using a function from another. + The analyzer checks for this condition only when the `_Analysis_mode_(_Analysis_local_leak_checks_)` SAL annotation is specified. By default, this annotation is specified for Windows kernel mode (driver) code. For more information about SAL annotations, see [Using SAL Annotations to Reduce C/C++ Code Defects](../code-quality/using-sal-annotations-to-reduce-c-cpp-code-defects.md). For example, this warning would be produced if memory is allocated by using `malloc` but freed by using `GlobalFree` or `delete`. In the specific cases of mismatches between array `new[]` and scalar `delete`, more precise warnings are reported instead of this one. @@ -22,7 +27,7 @@ Code analysis name: `MEMORY_ALLOCATION_MISMATCH` ## Example -The following sample code generates this warning. `pInt` is allocated using `calloc` but is freed using the mismatched function `delete`: +The following example code generates this warning. `pInt` is allocated using `calloc` but is freed using the mismatched function `delete`: ```cpp // C6280a_warning.cpp diff --git a/docs/code-quality/c6281.md b/docs/code-quality/c6281.md index f16c015ee52..4481fe9fc2e 100644 --- a/docs/code-quality/c6281.md +++ b/docs/code-quality/c6281.md @@ -1,10 +1,9 @@ --- +title: "Warning C6281" description: "Learn more about: Warning C6281" -title: Warning C6281 ms.date: 11/04/2016 f1_keywords: ["C6281", "BITWISERELATIONPRECEDENCEERROR", "__WARNING_BITWISERELATIONPRECEDENCEERROR"] helpviewer_keywords: ["C6281"] -ms.assetid: d0182269-8403-486b-ac3f-325522871bb1 --- # Warning C6281 diff --git a/docs/code-quality/c6282.md b/docs/code-quality/c6282.md index c48e6166325..c068864b18e 100644 --- a/docs/code-quality/c6282.md +++ b/docs/code-quality/c6282.md @@ -1,10 +1,9 @@ --- +title: "Warning C6282" description: "Learn more about: Warning C6282" -title: Warning C6282 ms.date: 11/04/2016 f1_keywords: ["C6282", "ASSIGNMENTREPLACESTEST", "__WARNING_ASSIGNMENTREPLACESTEST"] helpviewer_keywords: ["C6282"] -ms.assetid: 7dc153d5-fb9f-424a-8afa-4e2661efa51c --- # Warning C6282 diff --git a/docs/code-quality/c6283.md b/docs/code-quality/c6283.md index 436a46f1f52..5ae2a64d214 100644 --- a/docs/code-quality/c6283.md +++ b/docs/code-quality/c6283.md @@ -1,10 +1,9 @@ --- +title: "Warning C6283" description: "Learn more about: Warning C6283" -title: Warning C6283 ms.date: 10/03/2022 f1_keywords: ["C6283", "PRIMITIVE_ARRAY_NEW_DELETE_MISMATCH", "__WARNING_PRIMITIVE_ARRAY_NEW_DELETE_MISMATCH"] helpviewer_keywords: ["C6283"] -ms.assetid: 7760d32e-6d71-4c81-a6d2-719c9c76c2bb --- # Warning C6283 @@ -12,8 +11,14 @@ ms.assetid: 7760d32e-6d71-4c81-a6d2-719c9c76c2bb This warning appears only in C++ code and indicates that the calling function has inconsistently allocated memory with the array `new []` operator, but freed it with the scalar `delete` operator. +## Notice + +Warning C6283 was removed in Visual Studio 2026. Use the more generic warning [`C26865`](../code-quality/C26865.md) instead. + ## Remarks +This warning appears only in C++ code and indicates that the calling function has inconsistently allocated memory with the array `new []` operator, but freed it with the scalar `delete` operator. + This defect might cause leaks, memory corruptions, and, in situations where operators have been overridden, crashes. If memory is allocated with array `new []`, it should typically be freed with array `delete[]`. Warning C6283 only applies to arrays of primitive types such as integers or characters. If elements of the array are objects of class type then warning [C6278](../code-quality/c6278.md) is issued. diff --git a/docs/code-quality/c6284.md b/docs/code-quality/c6284.md index 4c29d20e333..81aeb042c5f 100644 --- a/docs/code-quality/c6284.md +++ b/docs/code-quality/c6284.md @@ -1,6 +1,6 @@ --- +title: "Warning C6284" description: "Learn more about: Warning C6284" -title: Warning C6284 ms.date: 03/07/2023 f1_keywords: ["C6284", "OBJECT_AS_STRING_ARGUMENT_TO_FORMAT_FUNCTION", "__WARNING_OBJECT_AS_STRING_ARGUMENT_TO_FORMAT_FUNCTION"] helpviewer_keywords: ["C6284"] @@ -19,6 +19,8 @@ Code analysis name: `OBJECT_AS_STRING_ARGUMENT_TO_FORMAT_FUNCTION` ## Example +The following example generates C6284: + ```cpp #include #include diff --git a/docs/code-quality/c6285.md b/docs/code-quality/c6285.md index 44221b6a57e..d7b4077b96d 100644 --- a/docs/code-quality/c6285.md +++ b/docs/code-quality/c6285.md @@ -1,19 +1,18 @@ --- +title: "Warning C6285" description: "Learn more about: Warning C6285" -title: Warning C6285 ms.date: 11/04/2016 f1_keywords: ["C6285", "LOGICALOROFCONSTANTS", "__WARNING_LOGICALOROFCONSTANTS"] helpviewer_keywords: ["C6285"] -ms.assetid: f5bc6d3d-d33b-42c8-98d2-92ec8ab17193 --- # Warning C6285 > ('*non-zero constant*' \|\| '*non-zero constant*') is always a non-zero constant. Did you intend to use the bitwise-and operator? -This warning indicates that two constant values, both greater than one, were detected as arguments to a logical-or operation that occurs in a test context. This expression is always TRUE. - ## Remarks +This warning indicates that two constant values, both greater than one, were detected as arguments to a logical-or operation that occurs in a test context. This expression is always TRUE. + Constant values greater than one suggest that the arguments to logical-or could be bit fields. Consider whether a bitwise operator might be a more appropriate operator in this case. Code analysis name: `LOGICALOROFCONSTANTS` diff --git a/docs/code-quality/c6286.md b/docs/code-quality/c6286.md index aeedbe05d59..5c850b5e3c2 100644 --- a/docs/code-quality/c6286.md +++ b/docs/code-quality/c6286.md @@ -1,10 +1,9 @@ --- +title: "Warning C6286" description: "Learn more about: Warning C6286" -title: Warning C6286 ms.date: 11/04/2016 f1_keywords: ["C6286", "NONZEROLOGICALORLOSINGSIDEEFFECTS", "__WARNING_NONZEROLOGICALORLOSINGSIDEEFFECTS"] helpviewer_keywords: ["C6286"] -ms.assetid: c79c5d4a-c02b-4b98-891a-d79e471f9da7 --- # Warning C6286 diff --git a/docs/code-quality/c6287.md b/docs/code-quality/c6287.md index 2847f5e85ec..ecf799346b7 100644 --- a/docs/code-quality/c6287.md +++ b/docs/code-quality/c6287.md @@ -1,10 +1,9 @@ --- +title: "Warning C6287" description: "Learn more about: Warning C6287" -title: Warning C6287 ms.date: 12/17/2019 f1_keywords: ["C6287", "REDUNDANTTEST", "__WARNING_REDUNDANTTEST"] helpviewer_keywords: ["C6287"] -ms.assetid: 9cb12641-8853-413a-b89e-f8b32c8dc5d3 --- # Warning C6287 diff --git a/docs/code-quality/c6288.md b/docs/code-quality/c6288.md index ffa9ae3b713..0057b6c8fea 100644 --- a/docs/code-quality/c6288.md +++ b/docs/code-quality/c6288.md @@ -1,10 +1,9 @@ --- +title: "Warning C6288" description: "Learn more about: Warning C6288" -title: Warning C6288 ms.date: 11/04/2016 f1_keywords: ["C6288", "MUTUALINCLUSIONOVERANDISFALSE", "__WARNING_MUTUALINCLUSIONOVERANDISFALSE"] helpviewer_keywords: ["C6288"] -ms.assetid: 3856b80a-c9f2-4e86-97fc-c913b0186788 --- # Warning C6288 diff --git a/docs/code-quality/c6289.md b/docs/code-quality/c6289.md index c5d8c1e205a..500153072b2 100644 --- a/docs/code-quality/c6289.md +++ b/docs/code-quality/c6289.md @@ -1,10 +1,9 @@ --- +title: "Warning C6289" description: "Learn more about: Warning C6289" -title: Warning C6289 ms.date: 11/04/2016 f1_keywords: ["C6289", "MUTUALEXCLUSIONOVERORISTRUE", "__WARNING_MUTUALEXCLUSIONOVERORISTRUE"] helpviewer_keywords: ["C6289"] -ms.assetid: 0fe09974-7577-468b-91a0-62dbe915443e --- # Warning C6289 diff --git a/docs/code-quality/c6290.md b/docs/code-quality/c6290.md index 2557e2d286a..61854f30eed 100644 --- a/docs/code-quality/c6290.md +++ b/docs/code-quality/c6290.md @@ -1,19 +1,18 @@ --- +title: "Warning C6290" description: "Learn more about: Warning C6290" -title: Warning C6290 ms.date: 11/04/2016 f1_keywords: ["C6290", "LOGICALNOTBITWISEAND", "__WARNING_LOGICALNOTBITWISEAND"] helpviewer_keywords: ["C6290"] -ms.assetid: 96a1acc4-724b-4b56-b091-661ddcc03884 --- # Warning C6290 > Bitwise operation on logical result: ! has higher precedence than &. Use && or (!(x & y)) instead -This warning indicates possible confusion in the use of an operator or an operator precedence. - ## Remarks +This warning indicates possible confusion in the use of an operator or an operator precedence. + The `!` operator yields a Boolean result, and it has higher precedence than the `&`. The bitwise-and (&) operator takes two arithmetic arguments. Therefore, one of the following errors has been detected: - The expression is mis-parenthesized: @@ -46,7 +45,7 @@ void f(int x, int y) } ``` -To correct this warning, use the following sample code: +To correct this warning, use the following example code: ```cpp void f(int x, int y) diff --git a/docs/code-quality/c6291.md b/docs/code-quality/c6291.md index 9e2421a92b6..cfdb0e86e6f 100644 --- a/docs/code-quality/c6291.md +++ b/docs/code-quality/c6291.md @@ -1,15 +1,16 @@ --- +title: "Warning C6291" description: "Learn more about: Warning C6291" -title: Warning C6291 ms.date: 11/04/2016 f1_keywords: ["C6291", "LOGICALNOTBITWISEOR", "__WARNING_LOGICALNOTBITWISEOR"] helpviewer_keywords: ["C6291"] -ms.assetid: d0457386-e403-43fa-b959-5b6a495fab42 --- # Warning C6291 > Bitwise operation on logical result: ! has higher precedence than \|. Use \|\| or (!(x \| y)) instead +## Remarks + The `!` operator yields a Boolean result, and the `|` (bitwise-or) operator takes two arithmetic arguments. The `!` operator also has higher precedence than `|`. Therefore, one of the following errors has been detected: diff --git a/docs/code-quality/c6292.md b/docs/code-quality/c6292.md index 9b1926a741c..d3f8731f944 100644 --- a/docs/code-quality/c6292.md +++ b/docs/code-quality/c6292.md @@ -1,10 +1,9 @@ --- +title: "Warning C6292" description: "Learn more about: Warning C6292" -title: Warning C6292 ms.date: 11/04/2016 f1_keywords: ["C6292", "LOOP_COUNTS_UP_FROM_MAX", "__WARNING_LOOP_COUNTS_UP_FROM_MAX"] helpviewer_keywords: ["C6292"] -ms.assetid: 23998c78-ebd7-4ba1-a391-7b31b170f8fe --- # Warning C6292 diff --git a/docs/code-quality/c6293.md b/docs/code-quality/c6293.md index ae4618266c7..1624ad4ff61 100644 --- a/docs/code-quality/c6293.md +++ b/docs/code-quality/c6293.md @@ -1,10 +1,9 @@ --- +title: "Warning C6293" description: "Learn more about: Warning C6293" -title: Warning C6293 ms.date: 11/04/2016 f1_keywords: ["C6293", "LOOP_INDEX_GOES_NEGATIVE", "__WARNING_LOOP_INDEX_GOES_NEGATIVE"] helpviewer_keywords: ["C6293"] -ms.assetid: 24a475f6-fd93-4778-856a-9dd7941f7520 --- # Warning C6293 @@ -20,7 +19,7 @@ Code analysis name: `LOOP_INDEX_GOES_NEGATIVE` ## Example -The following sample code generates this warning: +The following example code generates this warning: ```cpp void f( ) diff --git a/docs/code-quality/c6294.md b/docs/code-quality/c6294.md index c67163e3f5f..d747530e5a5 100644 --- a/docs/code-quality/c6294.md +++ b/docs/code-quality/c6294.md @@ -1,10 +1,9 @@ --- +title: "Warning C6294" description: "Learn more about: Warning C6294" -title: Warning C6294 ms.date: 11/04/2016 f1_keywords: ["C6294", "LOOP_BODY_NEVER_EXECUTED", "__WARNING_LOOP_BODY_NEVER_EXECUTED"] helpviewer_keywords: ["C6294"] -ms.assetid: 1171d76f-b862-416d-b7c0-7a29be5c132d --- # Warning C6294 @@ -18,7 +17,7 @@ Code analysis name: `LOOP_BODY_NEVER_EXECUTED` ## Example -The following sample code generates this warning because MAX_VALUE is 0: +The following example code generates this warning because MAX_VALUE is 0: ```cpp #define MAX_VALUE 0 @@ -32,7 +31,7 @@ void f() } ``` -The following sample code corrects this warning by changing the value of MAX_VALUE to 25 +The following example code corrects this warning by changing the value of MAX_VALUE to 25 ```cpp #define MAX_VALUE 25 diff --git a/docs/code-quality/c6295.md b/docs/code-quality/c6295.md index f0c587ef8ed..80b75b427cb 100644 --- a/docs/code-quality/c6295.md +++ b/docs/code-quality/c6295.md @@ -1,10 +1,9 @@ --- +title: "Warning C6295" description: "Learn more about: Warning C6295" -title: Warning C6295 ms.date: 11/04/2016 f1_keywords: ["C6295", "INFINITE_LOOP", "__WARNING_INFINITE_LOOP"] helpviewer_keywords: ["C6295"] -ms.assetid: 64e890ee-b688-4487-938d-3928762b83a4 --- # Warning C6295 diff --git a/docs/code-quality/c6296.md b/docs/code-quality/c6296.md index c5b5b21acba..a12e1eaafb5 100644 --- a/docs/code-quality/c6296.md +++ b/docs/code-quality/c6296.md @@ -1,47 +1,35 @@ --- +title: "Warning C6296" description: "Learn more about: Warning C6296" -title: Warning C6296 -ms.date: 11/04/2016 +ms.date: 03/30/2025 f1_keywords: ["C6296", "LOOP_ONLY_EXECUTED_ONCE", "__WARNING_LOOP_ONLY_EXECUTED_ONCE"] helpviewer_keywords: ["C6296"] -ms.assetid: 226573e0-db18-4c44-8fc6-0bc09d1028bc --- # Warning C6296 -> Ill-defined for-loop: Loop body only executed once +> Ill-defined for-loop. Loop body only executed once. ## Remarks -This warning indicates that a for-loop might not function as intended. When the index is unsigned and a loop counts down from zero, its body is run only once. +This warning indicates that a for-loop might unintentionally execute only once. A loop with an unsigned index counting down from zero or a mistaken use of `==` might cause this warning. Code analysis name: `LOOP_ONLY_EXECUTED_ONCE` ## Example -The following code generates this warning: +The following example generates C6296. Each for-loop shown executes exactly once. ```cpp -void f( ) +int main() { - unsigned int i; + for (unsigned int i = 0; i < 10; i--) {} // C6296 + // Use the following line to resolve the warning: + // for (unsigned int i = 0; i < 10; i++) {} - for (i = 0; i < 100; i--) - { - // code ... - } -} -``` - -To correct this warning, use the following code: + for (int i = 0; i == 0; i++) {} // C6296 -```cpp -void f( ) -{ - unsigned int i; + for (int i = 0; i < 1; i++) {} // OK - for (i = 0; i < 100; i++) - { - // code ... - } + for (int i = 1; i > 0; i--) {} // OK } ``` diff --git a/docs/code-quality/c6297.md b/docs/code-quality/c6297.md index 2bbd49a68b4..d048cd48b79 100644 --- a/docs/code-quality/c6297.md +++ b/docs/code-quality/c6297.md @@ -1,10 +1,9 @@ --- -title: Warning C6297 +title: "Warning C6297" description: "Describes causes of MSVC Code analysis warning C6297, and how to fix the issue." ms.date: 07/15/2020 f1_keywords: ["C6297", "RESULTOFSHIFTCASTTOLARGERSIZE", "__WARNING_RESULTOFSHIFTCASTTOLARGERSIZE"] helpviewer_keywords: ["C6297"] -ms.assetid: 17b585f0-75e5-4fc0-935a-143ec67659f4 --- # Warning C6297 diff --git a/docs/code-quality/c6298.md b/docs/code-quality/c6298.md index 7887a8ee7c9..e86e5e4b260 100644 --- a/docs/code-quality/c6298.md +++ b/docs/code-quality/c6298.md @@ -1,10 +1,9 @@ --- +title: "Warning C6298" description: "Learn more about: Warning C6298" -title: Warning C6298 ms.date: 11/04/2016 f1_keywords: ["C6298", "CONST_STRING_TO_WRITABLE_STRING", "__WARNING_CONST_STRING_TO_WRITABLE_STRING"] helpviewer_keywords: ["C6298"] -ms.assetid: 986dc8e7-8596-4223-a66f-8616357d4399 --- # Warning C6298 @@ -20,7 +19,7 @@ Code analysis name: `CONST_STRING_TO_WRITABLE_STRING` ## Example -The following sample code generates this warning: +The following example code generates this warning: ```cpp #include @@ -58,7 +57,7 @@ void f() } ``` -To correct this warning, use the following sample code: +To correct this warning, use the following example code: ```cpp #include diff --git a/docs/code-quality/c6299.md b/docs/code-quality/c6299.md index 43c347fecea..2a56ce73b7b 100644 --- a/docs/code-quality/c6299.md +++ b/docs/code-quality/c6299.md @@ -1,10 +1,9 @@ --- +title: "Warning C6299" description: "Learn more about: Warning C6299" -title: Warning C6299 ms.date: 11/04/2016 f1_keywords: ["C6299", "BITFIELD_TO_BOOL_COMPARISON", "__WARNING_BITFIELD_TO_BOOL_COMPARISON"] helpviewer_keywords: ["C6299"] -ms.assetid: 5129ac34-0d4f-4056-aea2-b0df2127dead --- # Warning C6299 diff --git a/docs/code-quality/c6302.md b/docs/code-quality/c6302.md index e7e9a30709a..1de8b8f8611 100644 --- a/docs/code-quality/c6302.md +++ b/docs/code-quality/c6302.md @@ -1,6 +1,6 @@ --- +title: "Warning C6302" description: "Learn more about: Warning C6302" -title: Warning C6302 ms.date: 03/07/2023 f1_keywords: ["C6302", "CHAR_WCHAR_ARGUMENT_TO_FORMAT_FUNCTION", "__WARNING_CHAR_WCHAR_ARGUMENT_TO_FORMAT_FUNCTION"] helpviewer_keywords: ["C6302"] @@ -27,7 +27,7 @@ void f() } ``` -The following sample code remediates this issue by using `%hs` to specify a single-byte character string. Alternatively it could have switched to `%S`, which is a narrow string when used with `wprintf` like functions. See [Format specification syntax: `printf` and `wprintf` functions](../c-runtime-library/format-specification-syntax-printf-and-wprintf-functions.md#type-field-characters) for more options. +The following example code remediates this issue by using `%hs` to specify a single-byte character string. Alternatively it could have switched to `%S`, which is a narrow string when used with `wprintf` like functions. See [Format specification syntax: `printf` and `wprintf` functions](../c-runtime-library/format-specification-syntax-printf-and-wprintf-functions.md#type-field-characters) for more options. ```cpp void f() diff --git a/docs/code-quality/c6303.md b/docs/code-quality/c6303.md index bb481fe624c..003309b49f4 100644 --- a/docs/code-quality/c6303.md +++ b/docs/code-quality/c6303.md @@ -1,6 +1,6 @@ --- +title: "Warning C6303" description: "Learn more about: Warning C6303" -title: Warning C6303 ms.date: 03/07/2023 f1_keywords: ["C6303", "WCHAR_CHAR_ARGUMENT_TO_FORMAT_FUNCTION", "__WARNING_WCHAR_CHAR_ARGUMENT_TO_FORMAT_FUNCTION"] helpviewer_keywords: ["C6303"] @@ -17,7 +17,7 @@ Code analysis name: `WCHAR_CHAR_ARGUMENT_TO_FORMAT_FUNCTION` ## Example -The following sample code generates this warning. `buff` is a wide character string, but the `printf_s` call expects a short string as denoted by `%s`: +The following example code generates this warning. `buff` is a wide character string, but the `printf_s` call expects a short string as denoted by `%s`: ```cpp #include @@ -29,7 +29,7 @@ void f() } ``` -The following sample code remediates this issue by using `%ls` to specify a wide character string. Alternatively it could have switched to `%S`, which is a wide string when used with `printf` like functions. See [Format specification syntax: `printf` and `wprintf` functions](../c-runtime-library/format-specification-syntax-printf-and-wprintf-functions.md#type-field-characters) for more options. +The following example code remediates this issue by using `%ls` to specify a wide character string. Alternatively it could have switched to `%S`, which is a wide string when used with `printf` like functions. See [Format specification syntax: `printf` and `wprintf` functions](../c-runtime-library/format-specification-syntax-printf-and-wprintf-functions.md#type-field-characters) for more options. ```cpp #include diff --git a/docs/code-quality/c6305.md b/docs/code-quality/c6305.md index 72f3f0ec9d7..9ffba3948ee 100644 --- a/docs/code-quality/c6305.md +++ b/docs/code-quality/c6305.md @@ -1,10 +1,9 @@ --- +title: "Warning C6305" description: "Learn more about: Warning C6305" -title: Warning C6305 ms.date: 11/04/2016 f1_keywords: ["C6305", "SIZEOF_COUNTOF_MISMATCH", "__WARNING_SIZEOF_COUNTOF_MISMATCH"] helpviewer_keywords: ["C6305"] -ms.assetid: 4b3bdf86-b593-425e-89cb-9282878b21bd --- # Warning C6305 diff --git a/docs/code-quality/c6306.md b/docs/code-quality/c6306.md index 7235deeb6eb..c4d0f81a096 100644 --- a/docs/code-quality/c6306.md +++ b/docs/code-quality/c6306.md @@ -1,10 +1,9 @@ --- +title: "Warning C6306" description: "Learn more about: Warning C6306" -title: Warning C6306 ms.date: 11/04/2016 f1_keywords: ["C6306", "INCORRECT_VARARG_FUNCTIONCALL", "__WARNING_INCORRECT_VARARG_FUNCTIONCALL"] helpviewer_keywords: ["C6306"] -ms.assetid: 7502710c-7e0e-4412-aecc-b6821cb8c182 --- # Warning C6306 diff --git a/docs/code-quality/c6308.md b/docs/code-quality/c6308.md index 07cba3b71f4..0a92764dc8b 100644 --- a/docs/code-quality/c6308.md +++ b/docs/code-quality/c6308.md @@ -1,10 +1,9 @@ --- -title: Warning C6308 +title: "Warning C6308" description: "Understand the causes of Microsoft C/C++ code analysis warning C6308, and learn how to fix them." ms.date: 09/28/2022 f1_keywords: ["C6308", "REALLOCLEAK", "__WARNING_REALLOCLEAK"] helpviewer_keywords: ["C6308"] -ms.assetid: 1162cd96-9037-4576-9858-0c8361a12559 --- # Warning C6308 @@ -18,7 +17,7 @@ Code analysis name: `REALLOCLEAK` ## Example -The following sample code generates warning C6308. This issue stems from the assignment of the return value from `realloc` to `x`. If `realloc` fails and returns a null pointer, then the original memory pointed to by `x` won't be freed: +The following example code generates warning C6308. This issue stems from the assignment of the return value from `realloc` to `x`. If `realloc` fails and returns a null pointer, then the original memory pointed to by `x` won't be freed: ```cpp #include diff --git a/docs/code-quality/c6310.md b/docs/code-quality/c6310.md index 88dd7cb3800..30516b4684d 100644 --- a/docs/code-quality/c6310.md +++ b/docs/code-quality/c6310.md @@ -1,10 +1,9 @@ --- +title: "Warning C6310" description: "Learn more about: Warning C6310" -title: Warning C6310 ms.date: 11/04/2016 f1_keywords: ["C6310", "ILLEGALEXCEPTEXPRCONST", "__WARNING_ILLEGALEXCEPTEXPRCONST"] helpviewer_keywords: ["C6310"] -ms.assetid: e759eb63-883f-4c3e-bf2f-b924ff511405 --- # Warning C6310 diff --git a/docs/code-quality/c6312.md b/docs/code-quality/c6312.md index eada1991cc4..c63f31ea716 100644 --- a/docs/code-quality/c6312.md +++ b/docs/code-quality/c6312.md @@ -1,10 +1,9 @@ --- +title: "Warning C6312" description: "Learn more about: Warning C6312" -title: Warning C6312 ms.date: 11/04/2016 f1_keywords: ["C6312", "EXCEPTIONCONTINUEEXECUTION", "__WARNING_EXCEPTIONCONTINUEEXECUTION"] helpviewer_keywords: ["C6312"] -ms.assetid: 1fc8b9a1-e6ba-4799-84c3-31f289576cca --- # Warning C6312 diff --git a/docs/code-quality/c6313.md b/docs/code-quality/c6313.md index b8b7bc12968..c57dfc2e09e 100644 --- a/docs/code-quality/c6313.md +++ b/docs/code-quality/c6313.md @@ -1,10 +1,9 @@ --- +title: "Warning C6313" description: "Learn more about: Warning C6313" -title: Warning C6313 ms.date: 11/04/2016 f1_keywords: ["C6313", "BITANDVSZEROVALUEDFLAG", "__WARNING_BITANDVSZEROVALUEDFLAG"] helpviewer_keywords: ["C6313"] -ms.assetid: 2fb95c62-d81e-4525-9ec7-7723844c806c --- # Warning C6313 diff --git a/docs/code-quality/c6314.md b/docs/code-quality/c6314.md index a0f47a7fee6..8f7303162c3 100644 --- a/docs/code-quality/c6314.md +++ b/docs/code-quality/c6314.md @@ -1,10 +1,9 @@ --- +title: "Warning C6314" description: "Learn more about: Warning C6314" -title: Warning C6314 ms.date: 11/04/2016 f1_keywords: ["C6314", "BITORVSQUESTION", "__WARNING_BITORVSQUESTION"] helpviewer_keywords: ["C6314"] -ms.assetid: 2145ca62-967c-4223-b582-f1481b74f181 --- # Warning C6314 diff --git a/docs/code-quality/c6315.md b/docs/code-quality/c6315.md index e367214b1d6..edb8a62c4c9 100644 --- a/docs/code-quality/c6315.md +++ b/docs/code-quality/c6315.md @@ -1,10 +1,9 @@ --- +title: "Warning C6315" description: "Learn more about: Warning C6315" -title: Warning C6315 ms.date: 11/04/2016 f1_keywords: ["C6315", "BITORVSBITAND", "__WARNING_BITORVSBITAND"] helpviewer_keywords: ["C6315"] -ms.assetid: 4bc932d5-04fd-440d-b3af-e32a8bbc0618 --- # Warning C6315 diff --git a/docs/code-quality/c6316.md b/docs/code-quality/c6316.md index b5c33835081..11ff13efa2d 100644 --- a/docs/code-quality/c6316.md +++ b/docs/code-quality/c6316.md @@ -1,10 +1,9 @@ --- +title: "Warning C6316" description: "Learn more about: Warning C6316" -title: Warning C6316 ms.date: 11/04/2016 f1_keywords: ["C6316", "INAPPROPRIATEUSEOFBITOR", "__WARNING_INAPPROPRIATEUSEOFBITOR"] helpviewer_keywords: ["C6316"] -ms.assetid: ddd6a928-76b1-4d1b-9a9d-af1efcf02e3a --- # Warning C6316 diff --git a/docs/code-quality/c6317.md b/docs/code-quality/c6317.md index 62319ef781f..04b7fef3f49 100644 --- a/docs/code-quality/c6317.md +++ b/docs/code-quality/c6317.md @@ -1,10 +1,9 @@ --- +title: "Warning C6317" description: "Learn more about: Warning C6317" -title: Warning C6317 ms.date: 11/04/2016 f1_keywords: ["C6317", "NOTNOTCOMPLEMENT", "__WARNING_NOTNOTCOMPLEMENT"] helpviewer_keywords: ["C6317"] -ms.assetid: dc771bb8-f596-4514-af0f-4b39658af365 --- # Warning C6317 diff --git a/docs/code-quality/c6318.md b/docs/code-quality/c6318.md index 07cb2c8ccf6..420919c91b0 100644 --- a/docs/code-quality/c6318.md +++ b/docs/code-quality/c6318.md @@ -1,10 +1,9 @@ --- +title: "Warning C6318" description: "Learn more about: Warning C6318" -title: Warning C6318 ms.date: 11/04/2016 f1_keywords: ["C6318", "EXCEPTIONCONTINUESEARCH", "__WARNING_EXCEPTIONCONTINUESEARCH"] helpviewer_keywords: ["C6318"] -ms.assetid: 3284a83e-bb8e-461c-adcc-cfc66ceea05e --- # Warning C6318 diff --git a/docs/code-quality/c6319.md b/docs/code-quality/c6319.md index 4d6642ab6fc..22249d73224 100644 --- a/docs/code-quality/c6319.md +++ b/docs/code-quality/c6319.md @@ -1,10 +1,9 @@ --- +title: "Warning C6319" description: "Learn more about: Warning C6319" -title: Warning C6319 ms.date: 11/04/2016 f1_keywords: ["C6319", "IGNOREDBYCOMMA", "__WARNING_IGNOREDBYCOMMA"] helpviewer_keywords: ["C6319"] -ms.assetid: 3ccfc1d4-820d-48f0-8ff0-8fcfc87c45d6 --- # Warning C6319 diff --git a/docs/code-quality/c6320.md b/docs/code-quality/c6320.md index 9229dc3c398..2f566ee530c 100644 --- a/docs/code-quality/c6320.md +++ b/docs/code-quality/c6320.md @@ -1,10 +1,9 @@ --- +title: "Warning C6320" description: "Learn more about: Warning C6320" -title: Warning C6320 ms.date: 11/04/2016 f1_keywords: ["C6320", "EXCEPTIONEXECUTEHANDLER", "__WARNING_EXCEPTIONEXECUTEHANDLER"] helpviewer_keywords: ["C6320"] -ms.assetid: fb9e568e-b3d4-4ce2-a276-a64ad74d7b1e --- # Warning C6320 diff --git a/docs/code-quality/c6322.md b/docs/code-quality/c6322.md index cd3a8ac4329..e555f1801bd 100644 --- a/docs/code-quality/c6322.md +++ b/docs/code-quality/c6322.md @@ -1,10 +1,9 @@ --- +title: "Warning C6322" description: "Learn more about: Warning C6322" -title: Warning C6322 ms.date: 11/04/2016 f1_keywords: ["C6322", "EXCEPT_BLOCK_EMPTY", "__WARNING_EXCEPT_BLOCK_EMPTY"] helpviewer_keywords: ["C6322"] -ms.assetid: fb23d2b1-b2a0-465c-8bf5-ec039c6c7757 --- # Warning C6322 diff --git a/docs/code-quality/c6323.md b/docs/code-quality/c6323.md index ad59ba354e2..cca253b079b 100644 --- a/docs/code-quality/c6323.md +++ b/docs/code-quality/c6323.md @@ -1,10 +1,9 @@ --- +title: "Warning C6323" description: "Learn more about: Warning C6323" -title: Warning C6323 ms.date: 11/04/2016 f1_keywords: ["C6323", "ARITH_OP_ON_BOOL", "__WARNING_ARITH_OP_ON_BOOL"] helpviewer_keywords: ["C6323"] -ms.assetid: e9ab47d7-21e1-4204-8dad-ed7ec6127647 --- # Warning C6323 diff --git a/docs/code-quality/c6324.md b/docs/code-quality/c6324.md index 063ee638a82..89539cd2214 100644 --- a/docs/code-quality/c6324.md +++ b/docs/code-quality/c6324.md @@ -1,10 +1,9 @@ --- +title: "Warning C6324" description: "Learn more about: Warning C6324" -title: Warning C6324 ms.date: 11/04/2016 f1_keywords: ["C6324", "STRCPY_INSTEAD_OF_STRCMP", "__WARNING_STRCPY_INSTEAD_OF_STRCMP"] helpviewer_keywords: ["C6324"] -ms.assetid: 08675af3-8957-4640-9bd6-01de71ea1042 --- # Warning C6324 diff --git a/docs/code-quality/c6326.md b/docs/code-quality/c6326.md index ed317497b11..9d023afa3ed 100644 --- a/docs/code-quality/c6326.md +++ b/docs/code-quality/c6326.md @@ -1,10 +1,9 @@ --- +title: "Warning C6326" description: "Learn more about: Warning C6326" -title: Warning C6326 ms.date: 11/04/2016 f1_keywords: ["C6326", "CONST_CONST_COMP", "__WARNING_CONST_CONST_COMP"] helpviewer_keywords: ["C6326"] -ms.assetid: 0b606d29-e3c2-48b5-b520-b71b670c19a1 --- # Warning C6326 diff --git a/docs/code-quality/c6328.md b/docs/code-quality/c6328.md index 87bb1426d81..6c6c6dd36a0 100644 --- a/docs/code-quality/c6328.md +++ b/docs/code-quality/c6328.md @@ -1,10 +1,9 @@ --- +title: "Warning C6328" description: "Learn more about: Warning C6328" -title: Warning C6328 ms.date: 02/14/2024 f1_keywords: ["C6328", "FORMAT_SIZE_MISMATCH", "__WARNING_FORMAT_SIZE_MISMATCH"] helpviewer_keywords: ["C6328"] -ms.assetid: e25b00fa-d344-4dc9-b322-b4f1ae06f315 --- # Warning C6328 @@ -19,6 +18,8 @@ Code analysis name: `FORMAT_SIZE_MISMATCH` ## Example +The following example generates C6328: + ```cpp #include diff --git a/docs/code-quality/c6329.md b/docs/code-quality/c6329.md index b34263a856d..6f3223f7f8b 100644 --- a/docs/code-quality/c6329.md +++ b/docs/code-quality/c6329.md @@ -1,10 +1,9 @@ --- +title: "Warning C6329" description: "Learn more about: Warning C6329" -title: Warning C6329 ms.date: 11/04/2016 f1_keywords: ["C6329", "POTENTIAL_INCORRECT_RETVAL_CHECK", "__WARNING_POTENTIAL_INCORRECT_RETVAL_CHECK"] helpviewer_keywords: ["C6329"] -ms.assetid: 5765bd4d-5fa1-4e51-82d6-c1837b4743db --- # Warning C6329 @@ -16,7 +15,7 @@ The program is comparing a number against the return value from a call to `Creat Code analysis name: `POTENTIAL_INCORRECT_RETVAL_CHECK` -## Examples +## Example This code could cause the warning: diff --git a/docs/code-quality/c6330.md b/docs/code-quality/c6330.md index d94d00c081e..2bd84f26fb1 100644 --- a/docs/code-quality/c6330.md +++ b/docs/code-quality/c6330.md @@ -1,13 +1,14 @@ --- +title: "Warning C6330" description: "Learn more about: Warning C6330" -title: Warning C6330 ms.date: 11/04/2016 f1_keywords: ["C6330", "POTENTIAL_ARGUMENT_TYPE_MISMATCH", "__WARNING_POTENTIAL_ARGUMENT_TYPE_MISMATCH"] helpviewer_keywords: ["C6330"] -ms.assetid: 48594e1c-0a4b-4848-8598-ae6d7e08b4e9 --- # Warning C6330 > '*type1*' passed as Parameter('*number*') when '*type2*' is required in call to '*function*' +## Remarks + Code analysis name: `POTENTIAL_ARGUMENT_TYPE_MISMATCH` diff --git a/docs/code-quality/c6331.md b/docs/code-quality/c6331.md index 8c3047f9cd3..0b7c6f2ee12 100644 --- a/docs/code-quality/c6331.md +++ b/docs/code-quality/c6331.md @@ -1,26 +1,25 @@ --- +title: "Warning C6331" description: "Learn more about: Warning C6331" -title: Warning C6331 ms.date: 10/03/2022 f1_keywords: ["C6331", "VirtualFreeInvalidParam1", "__WARNING_VIRTUALFREEINVALIDPARAM1"] helpviewer_keywords: ["C6331"] -ms.assetid: cb1ecc2c-29a5-4c57-acf2-0954a4c047b1 --- # Warning C6331 -> Invalid parameter: passing MEM_RELEASE and MEM_DECOMMIT in conjunction to `*function*` is not allowed. This results in the failure of this call - -This message indicates that an invalid parameter is passed to `VirtualFree` or `VirtualFreeEx`. `VirtualFree` and `VirtualFreeEx` both reject the flags (`MEM_RELEASE | MEM_DECOMMIT`) in combination. Therefore, the values `MEM_DECOMMIT` and `MEM_RELEASE` may not be used together in the same call. +> Invalid parameter: passing MEM_RELEASE and MEM_DECOMMIT in conjunction to *`function`* is not allowed. This results in the failure of this call ## Remarks +This message indicates that an invalid parameter is passed to `VirtualFree` or `VirtualFreeEx`. `VirtualFree` and `VirtualFreeEx` both reject the flags (`MEM_RELEASE | MEM_DECOMMIT`) in combination. Therefore, the values `MEM_DECOMMIT` and `MEM_RELEASE` may not be used together in the same call. + It's not required for decommit and release to occur as independent steps. Releasing committed memory will decommit the pages as well. Also, ensure the return value of this function isn't ignored. Code analysis name: `VirtualFreeInvalidParam1` ## Example -The following sample code generates warning C6331: +The following example code generates warning C6331: ```cpp #include diff --git a/docs/code-quality/c6332.md b/docs/code-quality/c6332.md index acf5ef2d951..392d45b1f78 100644 --- a/docs/code-quality/c6332.md +++ b/docs/code-quality/c6332.md @@ -1,19 +1,18 @@ --- +title: "Warning C6332" description: "Learn more about: Warning C6332" -title: Warning C6332 ms.date: 10/03/2022 f1_keywords: ["C6332", "VirtualFreeInvalidParam2", "__WARNING_VIRTUALFREEINVALIDPARAM2"] helpviewer_keywords: ["C6332"] -ms.assetid: 93d74b3f-4070-4b48-807e-52b1dfee1330 --- # Warning C6332 > Invalid parameter: passing zero as the dwFreeType parameter to '*function*' is not allowed. This results in the failure of this call -This warning indicates that an invalid parameter is being passed to `VirtualFree` or `VirtualFreeEx`. - ## Remarks +This warning indicates that an invalid parameter is being passed to `VirtualFree` or `VirtualFreeEx`. + `VirtualFree` and `VirtualFreeEx` both reject a `dwFreeType` parameter of zero. The `dwFreeType` parameter can be either `MEM_DECOMMIT` or `MEM_RELEASE`. However, the values `MEM_DECOMMIT` and `MEM_RELEASE` may not be used together in the same call. Also, make sure that the return value of the `VirtualFree` function isn't ignored. Code analysis name: `VirtualFreeInvalidParam2` diff --git a/docs/code-quality/c6333.md b/docs/code-quality/c6333.md index 3f917962eda..2a8dac30c9c 100644 --- a/docs/code-quality/c6333.md +++ b/docs/code-quality/c6333.md @@ -1,10 +1,9 @@ --- +title: "Warning C6333" description: "Learn more about: Warning C6333" -title: Warning C6333 ms.date: 08/25/2022 f1_keywords: ["C6333", "VIRTUALFREEINVALIDPARAM3", "__WARNING_VIRTUALFREEINVALIDPARAM3"] helpviewer_keywords: ["C6333"] -ms.assetid: 4b8fa4b2-a3a0-4d00-bec7-76686b66fcf9 --- # Warning C6333 @@ -18,7 +17,7 @@ Code analysis name: `VIRTUALFREEINVALIDPARAM3` ## Example -The following code sample generates this warning: +The following code example generates this warning: ```cpp #include diff --git a/docs/code-quality/c6334.md b/docs/code-quality/c6334.md index 5499f3ab135..96de5d6dbbe 100644 --- a/docs/code-quality/c6334.md +++ b/docs/code-quality/c6334.md @@ -1,10 +1,9 @@ --- +title: "Warning C6334" description: "Learn more about: Warning C6334" -title: Warning C6334 ms.date: 08/25/2022 f1_keywords: ["C6334", "SIZEOFEXPR", "__WARNING_SIZEOFEXPR"] helpviewer_keywords: ["C6334"] -ms.assetid: 83c8abfb-b11e-4573-8c6f-95b205d32137 --- # Warning C6334 diff --git a/docs/code-quality/c6335.md b/docs/code-quality/c6335.md index a5f62fe5fe6..662ee5f946e 100644 --- a/docs/code-quality/c6335.md +++ b/docs/code-quality/c6335.md @@ -1,5 +1,5 @@ --- -title: Warning C6335 +title: "Warning C6335" description: "Learn more about: Warning C6335" ms.date: 11/04/2016 f1_keywords: ["C6335", "LEAKING_PROCESS_HANDLE", "__WARNING_LEAKING_PROCESS_HANDLE"] diff --git a/docs/code-quality/c6336.md b/docs/code-quality/c6336.md index a2264c13e82..1f3cc67146d 100644 --- a/docs/code-quality/c6336.md +++ b/docs/code-quality/c6336.md @@ -1,10 +1,9 @@ --- +title: "Warning C6336" description: "Learn more about: Warning C6336" -title: Warning C6336 ms.date: 11/04/2016 f1_keywords: ["C6336", "QUESTIONPRECEDENCE", "__WARNING_QUESTIONPRECEDENCE"] helpviewer_keywords: ["C6336"] -ms.assetid: cf402433-9940-4466-ac15-f94288f51f74 --- # Warning C6336 diff --git a/docs/code-quality/c6340.md b/docs/code-quality/c6340.md index baf564d0267..7733f30f873 100644 --- a/docs/code-quality/c6340.md +++ b/docs/code-quality/c6340.md @@ -1,10 +1,9 @@ --- +title: "Warning C6340" description: "Learn more about: Warning C6340" -title: Warning C6340 ms.date: 02/14/2024 f1_keywords: ["C6340", "FORMAT_SIGN_MISMATCH"] helpviewer_keywords: ["C6340"] -ms.assetid: c4fe474f-5a27-4148-ba35-1ef021371e13 --- # Warning C6340 @@ -19,6 +18,8 @@ Code analysis name: `FORMAT_SIGN_MISMATCH` ## Example +The following example generates C6340: + ```cpp #include diff --git a/docs/code-quality/c6381.md b/docs/code-quality/c6381.md index 1a753fdbdea..b374965fd48 100644 --- a/docs/code-quality/c6381.md +++ b/docs/code-quality/c6381.md @@ -1,10 +1,9 @@ --- +title: "Warning C6381" description: "Learn more about: Warning C6381" -title: Warning C6381 ms.date: 11/04/2016 f1_keywords: ["C6381", "SHUTDOWN_API", "__WARNING_SHUTDOWN_API"] helpviewer_keywords: ["C6381"] -ms.assetid: c01a3040-26d4-47ac-b72d-7e1292ca435f --- # Warning C6381 diff --git a/docs/code-quality/c6383.md b/docs/code-quality/c6383.md index 84bf8c27374..ee46f686092 100644 --- a/docs/code-quality/c6383.md +++ b/docs/code-quality/c6383.md @@ -1,19 +1,18 @@ --- +title: "Warning C6383" description: "Learn more about: Warning C6383" -title: Warning C6383 ms.date: 09/07/2022 f1_keywords: ["C6383", "ELEMENTS_TO_BYTES", "__WARNING_ELEMENTS_TO_BYTES"] helpviewer_keywords: ["C6383"] -ms.assetid: f5ff7938-0fbe-4b71-b98f-098fe887799d --- # Warning C6383 -> Buffer overrun due to conversion of an element count into a byte count: an element count is expected for parameter `*parameter_name*` in call to `*function_name*` - -This warning indicates that a non-constant byte count is being passed when an element count is instead required. +> Buffer overrun due to conversion of an element count into a byte count: an element count is expected for parameter *`parameter_name`* in call to *`function_name`* ## Remarks +This warning indicates that a non-constant byte count is being passed when an element count is instead required. + Typically, this warning occurs when a variable is multiplied by the `sizeof` a type. This issue will likely result in more bytes being copied to the buffer than it can hold. Code analysis name: `ELEMENTS_TO_BYTES` diff --git a/docs/code-quality/c6384.md b/docs/code-quality/c6384.md index 75067282fa5..23a603be8b1 100644 --- a/docs/code-quality/c6384.md +++ b/docs/code-quality/c6384.md @@ -1,19 +1,18 @@ --- +title: "Warning C6384" description: "Learn more about: Warning C6384" -title: Warning C6384 ms.date: 10/03/2022 f1_keywords: ["C6384", "DIVIDING_SIZEOF_POINTER", "__WARNING_DIVIDING_SIZEOF_POINTER"] helpviewer_keywords: ["C6384"] -ms.assetid: 9c605b61-1485-49a8-847b-41170193dbf4 --- # Warning C6384 > Dividing sizeof a pointer by another value -This warning indicates that a size calculation might be incorrect. To calculate the number of elements in an array, you sometimes divide the size of the array by the size of the first element. However, when the array is actually a pointer, the result is typically different than intended. - ## Remarks +This warning indicates that a size calculation might be incorrect. To calculate the number of elements in an array, you sometimes divide the size of the array by the size of the first element. However, when the array is actually a pointer, the result is typically different than intended. + If the pointer is a function parameter and the size of the buffer wasn't passed, it isn't possible to calculate the maximum buffer available. When the pointer is allocated locally, the size used in the allocation should be used. Code analysis name: `DIVIDING_SIZEOF_POINTER` diff --git a/docs/code-quality/c6385.md b/docs/code-quality/c6385.md index ef43fb923b0..8e6446f76b7 100644 --- a/docs/code-quality/c6385.md +++ b/docs/code-quality/c6385.md @@ -1,10 +1,9 @@ --- -title: Warning C6385 +title: "Warning C6385" description: "Describes C++ Code Analysis warning C6385 and how to resolve it." ms.date: 03/16/2020 f1_keywords: ["C6385", "READ_OVERRUN", "__WARNING_READ_OVERRUN"] helpviewer_keywords: ["C6385"] -ms.assetid: 3e4961e7-0f09-42a8-8cc2-151109dfdbda --- # Warning C6385 diff --git a/docs/code-quality/c6386.md b/docs/code-quality/c6386.md index 2419833b70c..1b08ddf6bdf 100644 --- a/docs/code-quality/c6386.md +++ b/docs/code-quality/c6386.md @@ -1,10 +1,9 @@ --- +title: "Warning C6386" description: "Learn more about: Warning C6386" -title: Warning C6386 -ms.date: 11/04/2016 +ms.date: 4/30/2025 f1_keywords: ["C6386", "WRITE_OVERRUN", "__WARNING_WRITE_OVERRUN"] helpviewer_keywords: ["C6386"] -ms.assetid: 84e69fe8-8f03-4bb3-b194-e5551882e214 --- # Warning C6386 @@ -23,15 +22,14 @@ The following code generates both this warning and [C6201](../code-quality/c6201 ```cpp #define MAX 25 -void f ( ) +void f() { - char ar[MAX]; - // code ... - ar[MAX] = '\0'; + char a[MAX]; + a[MAX] = '\0'; // this writes one element past the end of the buffer } ``` -To correct both warnings, use the following code: +To correct the warning, use the following code which accounts for the fact that array indexes are zero-based. Thus `MAX - 1` is the last element in the buffer: ```cpp #define MAX 25 @@ -39,8 +37,7 @@ To correct both warnings, use the following code: void f ( ) { char a[MAX]; - // code ... - a[MAX - 1] = '\0'; + a[MAX-1] = '\0'; } ``` diff --git a/docs/code-quality/c6387.md b/docs/code-quality/c6387.md index d96f377b6d6..fc082680d9d 100644 --- a/docs/code-quality/c6387.md +++ b/docs/code-quality/c6387.md @@ -1,10 +1,9 @@ --- +title: "Warning C6387" description: "Learn more about: Warning C6387" -title: Warning C6387 ms.date: 11/04/2016 f1_keywords: ["C6387", "INVALID_PARAM_VALUE_1", "__WARNING_INVALID_PARAM_VALUE_1"] helpviewer_keywords: ["C6387"] -ms.assetid: 3ea2fc4d-ffc3-4c3c-bfae-d42aa56235d8 --- # Warning C6387 @@ -27,7 +26,7 @@ _Post_ _Null_ char * g(); void f(_In_ char *pch); -void main() +int main() { char *pCh = g(); f(pCh); // Warning C6387 @@ -43,7 +42,7 @@ _Post_ _Notnull_ char * g(); void f(_In_ char *pch); -void main() +int main() { char *pCh = g(); f(pCh); diff --git a/docs/code-quality/c6388.md b/docs/code-quality/c6388.md index 540db622f9a..229efeee446 100644 --- a/docs/code-quality/c6388.md +++ b/docs/code-quality/c6388.md @@ -1,10 +1,9 @@ --- +title: "Warning C6388" description: "Learn more about: Warning C6388" -title: Warning C6388 ms.date: 11/04/2016 f1_keywords: ["C6388", "INVALID_PARAM_VALUE_2", "__WARNING_INVALID_PARAM_VALUE_2"] helpviewer_keywords: ["C6388"] -ms.assetid: 667fe9cf-cc53-49f9-b6c0-6ee87c397568 --- # Warning C6388 @@ -37,7 +36,7 @@ void f() } ``` -To correct this warning, use the following sample code: +To correct this warning, use the following example code: ```cpp // C6388_no_warning.cpp diff --git a/docs/code-quality/c6389.md b/docs/code-quality/c6389.md index 5838f22f32a..0b4fb2a1d54 100644 --- a/docs/code-quality/c6389.md +++ b/docs/code-quality/c6389.md @@ -1,5 +1,5 @@ --- -title: Warning C6389 +title: "Warning C6389" description: "Describes the Microsoft C/C++ code analysis warning C6389, its causes, and how to address it." ms.date: 06/09/2021 f1_keywords: ["C6389", "MARK_INTERNAL_OR_MISSING_COMMON_DECL"] @@ -21,6 +21,8 @@ Code analysis name: `MARK_INTERNAL_OR_MISSING_COMMON_DECL` ## Example +The following example generates C6389: + ```cpp // A.h struct X; diff --git a/docs/code-quality/c6390.md b/docs/code-quality/c6390.md index f5895dc43fc..225bfd16e4f 100644 --- a/docs/code-quality/c6390.md +++ b/docs/code-quality/c6390.md @@ -1,5 +1,5 @@ --- -title: Warning C6390 +title: "Warning C6390" description: "Describes the Microsoft C/C++ code analysis warning C6390, its causes, and how to address it." ms.date: 06/17/2022 f1_keywords: ["C6390", "NO_NULLCHECK_FOR_THIS"] @@ -17,6 +17,8 @@ Code analysis name: `NO_NULLCHECK_FOR_THIS` ## Example +The following example generates C6390: + ```cpp struct X { diff --git a/docs/code-quality/c6392.md b/docs/code-quality/c6392.md index b8dc3b2ff4f..63f9a7c3139 100644 --- a/docs/code-quality/c6392.md +++ b/docs/code-quality/c6392.md @@ -1,6 +1,6 @@ --- +title: "Warning C6392" description: "Learn more about: Warning C6392" -title: Warning C6392 ms.date: 03/06/2024 f1_keywords: ["C6392", "STREAM_OUTPUT_VOID_PTR", "__STREAM_OUTPUT_VOID_PTR"] helpviewer_keywords: ["C6392"] @@ -9,10 +9,10 @@ helpviewer_keywords: ["C6392"] > This expression writes the value of the pointer to the stream. If this is intentional, add an explicit cast to 'void *' -This rule was added in Visual Studio 2022 17.8. - ## Remarks +This rule was added in Visual Studio 2022 17.8. + C++ supports wide character streams such as `std::wostringstream`, and nonwide character streams such as `std::ostringstream`. Trying to print a wide string to a nonwide stream calls the `void*` overload of `operator<<`. This overload prints the address of the wide string instead of the value. Code analysis name: `STREAM_OUTPUT_VOID_PTR` diff --git a/docs/code-quality/c6393.md b/docs/code-quality/c6393.md index 07f0c540f0c..2de6638f3ab 100644 --- a/docs/code-quality/c6393.md +++ b/docs/code-quality/c6393.md @@ -1,6 +1,6 @@ --- +title: "Warning C6393" description: "Learn more about: Warning C6393" -title: Warning C6393 ms.date: 11/29/2023 f1_keywords: ["C6393", "LEAP_YEAR_INVALID_DATE_KEYED_LOOKUP", "__WARNING_LEAP_YEAR_INVALID_DATE_KEYED_LOOKUP"] helpviewer_keywords: ["C6393"] @@ -9,10 +9,10 @@ helpviewer_keywords: ["C6393"] > A lookup table of size 365 isn't sufficient to handle leap years -This rule was added in Visual Studio 2022 17.8. - ## Remarks +This rule was added in Visual Studio 2022 17.8. + In the Gregorian calendar, every year exactly divisible by four is a leap year--except for years that are exactly divisible by 100. The centurial years are also leap years if they're exactly divisible by 400. A leap year bug occurs when software doesn't account for this leap year logic, or uses flawed logic. The can affect reliability, availability, or even the security of the affected system. @@ -26,26 +26,25 @@ Code analysis name: `LEAP_YEAR_INVALID_DATE_KEYED_LOOKUP` The following code creates a lookup table for the day of the year, assuming 365 days per year. However, this doesn't work if the year is a leap year: ```cpp - -#include - -void foo(int year) -{ - const std::vector items(365); // C6393 - // Initialize items and use it... +#include + +void foo(int year) +{ + const std::vector items(365); // C6393 + // Initialize items and use it... } ``` To fix the problem, adjust the size of the lookup table as the table is created according to the result of appropriate leap year check: ```cpp -#include - -void foo(int year) -{ - bool isLeapYear = year % 4 == 0 && (year % 100 != 0 || year % 400 == 0); - const std::vector items(isLeapYear ? 366 : 365); - // Initialize items and use it... +#include + +void foo(int year) +{ + bool isLeapYear = year % 4 == 0 && (year % 100 != 0 || year % 400 == 0); + const std::vector items(isLeapYear ? 366 : 365); + // Initialize items and use it... } ``` diff --git a/docs/code-quality/c6394.md b/docs/code-quality/c6394.md index 7d5c7b4db2a..913accff0e0 100644 --- a/docs/code-quality/c6394.md +++ b/docs/code-quality/c6394.md @@ -1,6 +1,6 @@ --- +title: "Warning C6394" description: "Learn more about: Warning C6394" -title: Warning C6394 ms.date: 11/29/2023 f1_keywords: ["C6394", "LEAP_YEAR_INVALID_DATE_KEYED_LOOKUP_MUTABLE", "__WARNING_LEAP_YEAR_INVALID_DATE_KEYED_LOOKUP_MUTABLE"] helpviewer_keywords: ["C6394"] @@ -9,10 +9,10 @@ helpviewer_keywords: ["C6394"] > A lookup table of size 365 isn't sufficient to handle leap years -This rule was added in Visual Studio 2022 17.8. - ## Remarks +This rule was added in Visual Studio 2022 17.8. + In the Gregorian calendar, every year exactly divisible by four is a leap year--except for years that are exactly divisible by 100. The centurial years are also leap years if they're exactly divisible by 400. A leap year bug occurs when software doesn't account for this leap year logic, or uses flawed logic. The can affect reliability, availability, or even the security of the affected system. @@ -52,7 +52,7 @@ void foo(int year) ## Heuristics -This rule is enforced by checking if a lookup table has an initial size of 365 elements, but can be expanded to 366. However, it doesn't check if the table’s size is adjusted through proper leap year check or not, and so is a low confidence warning. +This rule is enforced by checking if a lookup table has an initial size of 365 elements, but can be expanded to 366. However, it doesn't check if the table's size is adjusted through proper leap year check or not, and so is a low confidence warning. ## See also diff --git a/docs/code-quality/c6395.md b/docs/code-quality/c6395.md index fba3e04720f..52a0feeb35a 100644 --- a/docs/code-quality/c6395.md +++ b/docs/code-quality/c6395.md @@ -1,5 +1,5 @@ --- -title: Warning C6395 +title: "Warning C6395" description: "Describes the Microsoft C/C++ code analysis warning C6395, its causes, and how to address it." ms.date: 10/12/2023 f1_keywords: ["C6395", "EVAL_ORDER_CHANGE"] @@ -17,6 +17,8 @@ Code analysis name: `EVAL_ORDER_CHANGE` ## Example +The following example generates C6395: + ```cpp void foo(int* a, int i) { diff --git a/docs/code-quality/c6396.md b/docs/code-quality/c6396.md index 6bd3b0952bf..210935d9f60 100644 --- a/docs/code-quality/c6396.md +++ b/docs/code-quality/c6396.md @@ -1,6 +1,6 @@ --- +title: "Warning C6396" description: "Learn more about: Warning C6396: sizeof('integerConstant') always returns the size of the underlying integer type" -title: Warning C6396 ms.date: 02/05/2024 f1_keywords: ["C6396", "SIZEOF_CONSTANT"] helpviewer_keywords: ["C6396"] @@ -17,6 +17,8 @@ This check ignores character literals because `buffer_size += sizeof(UNICODE_NUL ## Example +The following example generates C6396: + ```cpp void f() { diff --git a/docs/code-quality/c6397.md b/docs/code-quality/c6397.md index 4247b431616..a45d0582c08 100644 --- a/docs/code-quality/c6397.md +++ b/docs/code-quality/c6397.md @@ -1,6 +1,6 @@ --- +title: "Warning C6397" description: "Learn more about: Warning C6397: The address-of operator cannot return null pointer in well-defined code" -title: Warning C6397 ms.date: 02/05/2024 f1_keywords: ["C6397", "DUBIOUS_NULL_CHECK"] helpviewer_keywords: ["C6397"] @@ -17,6 +17,8 @@ The address-of operator returns the address of its operand. This value should ne ## Example +The following example generates C6397: + ```cpp bool isNull(int *a) { diff --git a/docs/code-quality/c6398.md b/docs/code-quality/c6398.md index 5ee996202d7..072a3669b65 100644 --- a/docs/code-quality/c6398.md +++ b/docs/code-quality/c6398.md @@ -1,6 +1,6 @@ --- +title: "Warning C6398" description: "Learn more about: Warning C6398: The address-of a field cannot be null in well-defined code" -title: Warning C6398 ms.date: 02/05/2024 f1_keywords: ["C6398", "DUBIOUS_NULL_CHECK_FIELD"] helpviewer_keywords: ["C6398"] @@ -17,6 +17,8 @@ The address-of operator returns the address of its operand. This value should ne ## Example +The following example generates C6398: + ```cpp struct A { int* x; }; diff --git a/docs/code-quality/c6400.md b/docs/code-quality/c6400.md index 2d2d4ac5590..ed5d187c376 100644 --- a/docs/code-quality/c6400.md +++ b/docs/code-quality/c6400.md @@ -1,10 +1,9 @@ --- +title: "Warning C6400" description: "Learn more about: Warning C6400" -title: Warning C6400 ms.date: 11/04/2016 f1_keywords: ["C6400", "LOCALE_DEPENDENT_CONSTANT_STRING_COMPARISON", "__WARNING_LOCALE_DEPENDENT_CONSTANT_STRING_COMPARISON"] helpviewer_keywords: ["C6400"] -ms.assetid: 35808969-1d43-41e8-bcda-33635637fb26 --- # Warning C6400 diff --git a/docs/code-quality/c6401.md b/docs/code-quality/c6401.md index 954dbdddef9..071f30b46bc 100644 --- a/docs/code-quality/c6401.md +++ b/docs/code-quality/c6401.md @@ -1,10 +1,9 @@ --- +title: "Warning C6401" description: "Learn more about: Warning C6401" -title: Warning C6401 ms.date: 11/04/2016 f1_keywords: ["C6401", "DEFAULT_LOCALE_CONSTANT_STRING_COMPARISON", "__WARNING_DEFAULT_LOCALE_CONSTANT_STRING_COMPARISON"] helpviewer_keywords: ["C6401"] -ms.assetid: d57b1c94-57a3-4d4b-a7de-8b9ffbac3ebe --- # Warning C6401 diff --git a/docs/code-quality/c6411.md b/docs/code-quality/c6411.md index a24d5c91181..4e1627384d3 100644 --- a/docs/code-quality/c6411.md +++ b/docs/code-quality/c6411.md @@ -1,9 +1,9 @@ --- +title: "Warning C6411" description: "Learn more about: Warning C6411" -title: Warning C6411 ms.date: 11/04/2016 f1_keywords: ["C6411", "POTENTIAL_READ_OVERRUN"] -ms.assetid: 6bbc1734-eec4-4ad6-9908-4ed2a5f025db +helpviewer_keywords: ["C6411"] --- # Warning C6411 diff --git a/docs/code-quality/c6412.md b/docs/code-quality/c6412.md index 5c293568822..cd387c66074 100644 --- a/docs/code-quality/c6412.md +++ b/docs/code-quality/c6412.md @@ -1,9 +1,9 @@ --- +title: "Warning C6412" description: "Learn more about: Warning C6412" -title: Warning C6412 ms.date: 11/04/2016 f1_keywords: ["C6412", "POTENTIAL_WRITE_OVERRUN"] -ms.assetid: 6498f045-1bdc-4428-9d95-d9498de207bb +helpviewer_keywords: ["C6412"] --- # Warning C6412 diff --git a/docs/code-quality/c6500.md b/docs/code-quality/c6500.md index db2024951ba..4b2373b63d5 100644 --- a/docs/code-quality/c6500.md +++ b/docs/code-quality/c6500.md @@ -1,20 +1,19 @@ --- +title: "Warning C6500" description: "Learn more about: Warning C6500" -title: Warning C6500 ms.date: 11/04/2016 f1_keywords: ["C6500", "INVALID_ATTRIBUTE_PROPERTY", "__WARNING_INVALID_ATTRIBUTE_PROPERTY"] helpviewer_keywords: ["C6500"] -ms.assetid: bfc61ec1-8ac5-4465-a23c-91418fbc4552 --- # Warning C6500 > Invalid annotation: value for '*name*' property is invalid +## Remarks + > [!NOTE] > This warning occurs only in code that is using a deprecated version of the source-code annotation language (SAL). We recommend that you port your code to use the latest version of SAL. For more information, see [Using SAL Annotations to Reduce C/C++ Code Defects](../code-quality/using-sal-annotations-to-reduce-c-cpp-code-defects.md). -## Remarks - This warning indicates that a property value used in the annotation isn't valid. For example, it can occur if an incorrect level of dereference is used in the `Deref` property, or if you use a constant value that is larger than `size_t` for properties like `ElementSize`. Code analysis name: `INVALID_ATTRIBUTE_PROPERTY` @@ -35,7 +34,7 @@ using namespace vc_attributes; void f( [Pre( Deref=2, Access=Read )] char buffer[] ); ``` -To correct this warning, specify the correct level of dereference, as shown in the following sample code: +To correct this warning, specify the correct level of dereference, as shown in the following example code: ```cpp // C diff --git a/docs/code-quality/c6501.md b/docs/code-quality/c6501.md index 437e4e78f41..6b552356726 100644 --- a/docs/code-quality/c6501.md +++ b/docs/code-quality/c6501.md @@ -1,20 +1,19 @@ --- +title: "Warning C6501" description: "Learn more about: Warning C6501" -title: Warning C6501 ms.date: 11/04/2016 f1_keywords: ["C6501", "CONFLICTING_ATTRIBUTE_PROPERTY_VALUES", "__WARNING_CONFLICTING_ATTRIBUTE_PROPERTY_VALUES"] helpviewer_keywords: ["C6501"] -ms.assetid: f9e8b847-2516-4bbb-bb1c-c87cfbacf254 --- # Warning C6501 > Annotation conflict: '*name*' property conflicts with previously specified property +## Remarks + > [!NOTE] > This warning occurs only in code that is using a deprecated version of the source-code annotation language (SAL). We recommend that you port your code to use the latest version of SAL. For more information, see [Using SAL Annotations to Reduce C/C++ Code Defects](../code-quality/using-sal-annotations-to-reduce-c-cpp-code-defects.md). -## Remarks - This warning indicates the presence of conflicting properties in the annotation. The warning typically occurs when multiple properties that serve similar purpose are used to annotate a parameter or return value. To correct the warning, you must choose the property that best addresses your need. Code analysis name: `CONFLICTING_ATTRIBUTE_PROPERTY_VALUES` diff --git a/docs/code-quality/c6503.md b/docs/code-quality/c6503.md index 919cad1a16e..5c320d0eaed 100644 --- a/docs/code-quality/c6503.md +++ b/docs/code-quality/c6503.md @@ -1,20 +1,19 @@ --- +title: "Warning C6503" description: "Learn more about: Warning C6503" -title: Warning C6503 ms.date: 11/04/2016 f1_keywords: ["C6503", "REFERENCES_CANT_BE_NULL", "__WARNING_REFERENCES_CANT_BE_NULL"] helpviewer_keywords: ["C6503"] -ms.assetid: a6212938-bef9-4830-becb-6baa70b53e97 --- # Warning C6503 > Invalid annotation: references and arrays may not be marked `Null=Yes` or `Null=Maybe` +## Remarks + > [!NOTE] > This warning occurs only in code that is using a deprecated version of the source-code annotation language (SAL). We recommend that you port your code to use the latest version of SAL. For more information, see [Using SAL Annotations to Reduce C/C++ Code Defects](../code-quality/using-sal-annotations-to-reduce-c-cpp-code-defects.md). -## Remarks - This warning indicates that `Null` property is incorrectly used on a reference or array type. A reference or array type holds the address of an object and must point to a valid object. Because reference and array types can't be null, you must correct the error by either removing the `Null` property or by setting the `Null` property value to `No`. Code analysis name: `REFERENCES_CANT_BE_NULL` diff --git a/docs/code-quality/c6504.md b/docs/code-quality/c6504.md index e77e99df282..eb9d24fa536 100644 --- a/docs/code-quality/c6504.md +++ b/docs/code-quality/c6504.md @@ -1,19 +1,18 @@ --- +title: "Warning C6504" description: "Learn more about: Warning C6504" -title: Warning C6504 ms.date: 10/03/2022 f1_keywords: ["C6504", "NULL_ON_NON_POINTER", "__WARNING_NULL_ON_NON_POINTER"] helpviewer_keywords: ["C6504"] -ms.assetid: 6baeed46-e73d-4974-af16-7487c55b3473 --- # Warning C6504 > Invalid annotation: property may only be used on values of pointer, pointer-to-member, or array type -This warning indicates the use of a pointer-specific SAL annotation on a non-pointer data type. - ## Remarks +This warning indicates the use of a pointer-specific SAL annotation on a non-pointer data type. + For more information about what data types are supported by properties, see [Annotation Properties](using-sal-annotations-to-reduce-c-cpp-code-defects.md). Code analysis name: `NULL_ON_NON_POINTER` @@ -60,6 +59,6 @@ void g(Point& pt) } ``` -## See Also +## See also [Annotation Properties](using-sal-annotations-to-reduce-c-cpp-code-defects.md) diff --git a/docs/code-quality/c6505.md b/docs/code-quality/c6505.md index 3edfe826bbf..317778e442c 100644 --- a/docs/code-quality/c6505.md +++ b/docs/code-quality/c6505.md @@ -1,10 +1,9 @@ --- +title: "Warning C6505" description: "Learn more about: Warning C6505" -title: Warning C6505 ms.date: 11/04/2016 f1_keywords: ["C6505", "MUSTCHECK_ON_VOID", "__WARNING_MUSTCHECK_ON_VOID"] helpviewer_keywords: ["C6505"] -ms.assetid: 1883ce60-48d7-41c8-add8-814e4b8b908b --- # Warning C6505 diff --git a/docs/code-quality/c6506.md b/docs/code-quality/c6506.md index df143e3c842..6cd1cf750b2 100644 --- a/docs/code-quality/c6506.md +++ b/docs/code-quality/c6506.md @@ -1,10 +1,9 @@ --- +title: "Warning C6506" description: "Learn more about: Warning C6506" -title: Warning C6506 ms.date: 11/04/2016 f1_keywords: ["C6506", "BUFFER_SIZE_ON_NON_POINTER_OR_ARRAY", "__WARNING_BUFFER_SIZE_ON_NON_POINTER_OR_ARRAY"] helpviewer_keywords: ["C6506"] -ms.assetid: 20b87ee8-13ea-4d71-95a1-2b2d144d196a --- # Warning C6506 @@ -21,17 +20,17 @@ Code analysis name: `BUFFER_SIZE_ON_NON_POINTER_OR_ARRAY` The following code generates this warning: ```cpp -#include +#include void f(_Out_ char c) { c = 'd'; } ``` -To correct this warning, use a pointer or an array type, as shown in the following sample code: +To correct this warning, use a pointer or an array type, as shown in the following example code: ```cpp -#include +#include void f(_Out_ char *c) { *c = 'd'; diff --git a/docs/code-quality/c6508.md b/docs/code-quality/c6508.md index 3915b736ae7..f48ec901cc3 100644 --- a/docs/code-quality/c6508.md +++ b/docs/code-quality/c6508.md @@ -1,20 +1,19 @@ --- +title: "Warning C6508" description: "Learn more about: Warning C6508" -title: Warning C6508 ms.date: 11/04/2016 f1_keywords: ["C6508", "WRITE_ACCESS_ON_CONST", "__WARNING_WRITE_ACCESS_ON_CONST"] helpviewer_keywords: ["C6508"] -ms.assetid: ac5b23c8-ab9e-481b-bc97-8404f0b63100 --- # Warning C6508 > Invalid annotation: write access is not allowed on const values +## Remarks + > [!NOTE] > This warning occurs only in code that is using a deprecated version of the source-code annotation language (SAL). We recommend that you port your code to use the latest version of SAL. For more information, see [Using SAL Annotations to Reduce C/C++ Code Defects](../code-quality/using-sal-annotations-to-reduce-c-cpp-code-defects.md). -## Remarks - This warning indicates that the Access property specified on a const parameter implies that it can be written to. For constant values, Access=Read is the only valid setting. Code analysis name: `WRITE_ACCESS_ON_CONST` diff --git a/docs/code-quality/c6509.md b/docs/code-quality/c6509.md index 5266f53e763..e969a7c5d47 100644 --- a/docs/code-quality/c6509.md +++ b/docs/code-quality/c6509.md @@ -1,10 +1,9 @@ --- +title: "Warning C6509" description: "Learn more about: Warning C6509" -title: Warning C6509 ms.date: 11/04/2016 f1_keywords: ["C6509", "RETURN_USED_ON_PRECONDITION", "__WARNING_RETURN_USED_ON_PRECONDITION"] helpviewer_keywords: ["C6509"] -ms.assetid: 6311bfd9-8372-48da-b01b-1c8775c38449 --- # Warning C6509 diff --git a/docs/code-quality/c6510.md b/docs/code-quality/c6510.md index e6d2366a4cf..b390495e5f6 100644 --- a/docs/code-quality/c6510.md +++ b/docs/code-quality/c6510.md @@ -1,10 +1,9 @@ --- +title: "Warning C6510" description: "Learn more about: Warning C6510" -title: Warning C6510 ms.date: 11/04/2016 f1_keywords: ["C6510", "NULLTERMINATED_ON_NON_POINTER", "__WARNING_NULLTERMINATED_ON_NON_POINTER"] helpviewer_keywords: ["C6510"] -ms.assetid: b7fc5eb4-3311-442c-ac79-401e88ef2129 --- # Warning C6510 diff --git a/docs/code-quality/c6511.md b/docs/code-quality/c6511.md index 262a03838f3..37d75c8a480 100644 --- a/docs/code-quality/c6511.md +++ b/docs/code-quality/c6511.md @@ -1,20 +1,19 @@ --- +title: "Warning C6511" description: "Learn more about: Warning C6511" -title: Warning C6511 ms.date: 11/04/2016 f1_keywords: ["C6511", "MUSTCHECK_MAYBE", "__WARNING_MUSTCHECK_MAYBE"] helpviewer_keywords: ["C6511"] -ms.assetid: 1a0ac213-c205-4fb1-9bc3-3dc7885329fa --- # Warning C6511 > Invalid annotation: MustCheck property must be Yes or No +## Remarks + > [!NOTE] > This warning occurs only in code that is using a deprecated version of the source-code annotation language (SAL). We recommend that you port your code to use the latest version of SAL. For more information, see [Using SAL Annotations to Reduce C/C++ Code Defects](../code-quality/using-sal-annotations-to-reduce-c-cpp-code-defects.md). -## Remarks - This warning indicates an invalid value for `MustCheck` property was specified. The only valid values for this property are: Yes and No. Code analysis name: `MUSTCHECK_MAYBE` diff --git a/docs/code-quality/c6513.md b/docs/code-quality/c6513.md index be19005461a..7f4d110c621 100644 --- a/docs/code-quality/c6513.md +++ b/docs/code-quality/c6513.md @@ -1,20 +1,19 @@ --- +title: "Warning C6513" description: "Learn more about: Warning C6513" -title: Warning C6513 ms.date: 11/04/2016 f1_keywords: ["C6513", "ELEMENT_SIZE_WITHOUT_BUFFER_SIZE", "__WARNING_ELEMENT_SIZE_WITHOUT_BUFFER_SIZE"] helpviewer_keywords: ["C6513"] -ms.assetid: b27780ac-b237-4b26-a796-68a920da73a3 --- # Warning C6513 > Invalid annotation: ElementSizeConst requires additional size properties +## Remarks + > [!NOTE] > This warning occurs only in code that is using a deprecated version of the source-code annotation language (SAL). We recommend that you port your code to use the latest version of SAL. For more information, see [Using SAL Annotations to Reduce C/C++ Code Defects](../code-quality/using-sal-annotations-to-reduce-c-cpp-code-defects.md). -## Remarks - This warning indicates that `ElementSizeConst` requires other properties that are missing from the annotation. Specifying `ElementSizeConst` alone doesn't provide any benefit to the analysis process. In addition to specifying `ElementSize`, other properties such as `ValidElementsConst` or `WritableElementsConst` must also be specified. Code analysis name: `ELEMENT_SIZE_WITHOUT_BUFFER_SIZE` diff --git a/docs/code-quality/c6514.md b/docs/code-quality/c6514.md index cad312ecf26..b0826ee86ce 100644 --- a/docs/code-quality/c6514.md +++ b/docs/code-quality/c6514.md @@ -1,10 +1,9 @@ --- +title: "Warning C6514" description: "Learn more about: Warning C6514" -title: Warning C6514 ms.date: 11/04/2016 f1_keywords: ["C6514", "BUFFER_SIZE_EXCEEDS_ARRAY_SIZE", "__WARNING_BUFFER_SIZE_EXCEEDS_ARRAY_SIZE"] helpviewer_keywords: ["C6514"] -ms.assetid: 4930a9f9-c721-437f-8754-cf39b30ea2db --- # Warning C6514 @@ -31,7 +30,7 @@ using namespace vc_attributes; void f( [Pre(Deref=1, ValidElementsConst=8)] char(*matrix) [6] ); ``` -To correct this warning, make sure the size of specified in ValidElementsConst is less than or equal to the size of the array, as shown in the following sample code: +To correct this warning, make sure the size of specified in ValidElementsConst is less than or equal to the size of the array, as shown in the following example code: ```cpp // C diff --git a/docs/code-quality/c6515.md b/docs/code-quality/c6515.md index 1f329099e64..b8d51042420 100644 --- a/docs/code-quality/c6515.md +++ b/docs/code-quality/c6515.md @@ -1,10 +1,9 @@ --- +title: "Warning C6515" description: "Learn more about: Warning C6515" -title: Warning C6515 ms.date: 11/04/2016 f1_keywords: ["C6515", "BUFFER_SIZE_ON_NON_POINTER", "__WARNING_BUFFER_SIZE_ON_NON_POINTER"] helpviewer_keywords: ["C6515"] -ms.assetid: e0f21858-0fea-427b-965a-a7eff62e1371 --- # Warning C6515 diff --git a/docs/code-quality/c6516.md b/docs/code-quality/c6516.md index 7bb9fb56826..128900e3e6b 100644 --- a/docs/code-quality/c6516.md +++ b/docs/code-quality/c6516.md @@ -1,20 +1,19 @@ --- +title: "Warning C6516" description: "Learn more about: Warning C6516" -title: Warning C6516 ms.date: 11/04/2016 f1_keywords: ["C6516", "NO_PROPERTIES_ON_ATTRIBUTE", "__WARNING_NO_PROPERTIES_ON_ATTRIBUTE"] helpviewer_keywords: ["C6516"] -ms.assetid: 461078c8-18d4-49ca-80a2-a15736f429a0 --- # Warning C6516 > Invalid annotation: no properties specified for '*name*' attribute +## Remarks + > [!NOTE] > This warning occurs only in code that is using a deprecated version of the source-code annotation language (SAL). We recommend that you port your code to use the latest version of SAL. For more information, see [Using SAL Annotations to Reduce C/C++ Code Defects](../code-quality/using-sal-annotations-to-reduce-c-cpp-code-defects.md). -## Remarks - This warning indicates that either no property was specified in the attribute or the property that was specified is invalid; therefore, the attribute can't be considered complete. Code analysis name: `NO_PROPERTIES_ON_ATTRIBUTE` diff --git a/docs/code-quality/c6517.md b/docs/code-quality/c6517.md index b7ce49aa83f..45b7ea115d8 100644 --- a/docs/code-quality/c6517.md +++ b/docs/code-quality/c6517.md @@ -1,20 +1,19 @@ --- +title: "Warning C6517" description: "Learn more about: Warning C6517" -title: Warning C6517 ms.date: 11/04/2016 f1_keywords: ["C6517", "VALID_SIZE_ON_NON_READABLE_BUFFER", "__WARNING_VALID_SIZE_ON_NON_READABLE_BUFFER"] helpviewer_keywords: ["C6517"] -ms.assetid: 96822155-8b2a-4699-980f-744afff84ca8 --- # Warning C6517 > Invalid annotation: 'SAL_readableTo' property may not be specified on buffers that are not readable: '*Parameter*'. +## Remarks + > [!NOTE] > This warning occurs only in code that is using a deprecated version of the source-code annotation language (SAL). We recommend that you port your code to use the latest version of SAL. For more information, see [Using SAL Annotations to Reduce C/C++ Code Defects](../code-quality/using-sal-annotations-to-reduce-c-cpp-code-defects.md). -## Remarks - This warning indicates that `SAL_readableTo` property doesn't have the required read access. You can't use this property to annotate a parameter without providing read access. Code analysis name: `VALID_SIZE_ON_NON_READABLE_BUFFER` diff --git a/docs/code-quality/c6518.md b/docs/code-quality/c6518.md index 179ef86f930..de6c364ac96 100644 --- a/docs/code-quality/c6518.md +++ b/docs/code-quality/c6518.md @@ -1,10 +1,9 @@ --- +title: "Warning C6518" description: "Learn more about: Warning C6518" -title: Warning C6518 ms.date: 11/04/2016 f1_keywords: ["C6518", "WRITABLE_SIZE_ON_NON_WRITABLE_BUFFER", "__WARNING_WRITABLE_SIZE_ON_NON_WRITABLE_BUFFER"] helpviewer_keywords: ["C6518"] -ms.assetid: c391a75b-9f16-43a5-a7cd-c5a233002850 --- # Warning C6518 diff --git a/docs/code-quality/c6522.md b/docs/code-quality/c6522.md index 3f7b9cbb6d4..b4d4d9f5bc2 100644 --- a/docs/code-quality/c6522.md +++ b/docs/code-quality/c6522.md @@ -1,20 +1,19 @@ --- +title: "Warning C6522" description: "Learn more about: Warning C6522" -title: Warning C6522 ms.date: 11/04/2016 f1_keywords: ["C6522", "INVALID_SIZE_STRING_TYPE", "__WARNING_INVALID_SIZE_STRING_TYPE"] helpviewer_keywords: ["C6522"] -ms.assetid: ac482f63-b27f-4807-968a-1c449033d2dd --- # Warning C6522 > Invalid size specification: expression must be of integral type: annotation '*annotation*' on function '*function*' '*parameter*' +## Remarks + > [!NOTE] > This warning occurs only in code that is using a deprecated version of the source-code annotation language (SAL). We recommend that you port your code to use the latest version of SAL. For more information, see [Using SAL Annotations to Reduce C/C++ Code Defects](../code-quality/using-sal-annotations-to-reduce-c-cpp-code-defects.md). -## Remarks - This warning indicates that an integral type was expected, but an incorrect data type was used. You can use annotation properties that accept the size of a parameter in terms of another parameter, but you must use correct data type. For a list of annotation properties, see [Using SAL Annotations to reduce code defects](using-sal-annotations-to-reduce-c-cpp-code-defects.md). Code analysis name: `INVALID_SIZE_STRING_TYPE` @@ -34,7 +33,7 @@ using namespace vc_attributes; void f ([Pre(ValidBytes="c")] char *pc, double c); ``` -To correct this warning, use `size_t` for the `ValidBytesParam` parameter data type, as shown in the following sample code: +To correct this warning, use `size_t` for the `ValidBytesParam` parameter data type, as shown in the following example code: ```cpp // C diff --git a/docs/code-quality/c6525.md b/docs/code-quality/c6525.md index 360aa708d94..36a6e2cd5e0 100644 --- a/docs/code-quality/c6525.md +++ b/docs/code-quality/c6525.md @@ -1,20 +1,19 @@ --- +title: "Warning C6525" description: "Learn more about: Warning C6525" -title: Warning C6525 ms.date: 11/04/2016 f1_keywords: ["C6525", "INVALID_SIZE_STRING_UNREACHABLE_LOCATION", "__WARNING_INVALID_SIZE_STRING_UNREACHABLE_LOCATION"] helpviewer_keywords: ["C6525"] -ms.assetid: a7af4dc7-d5a4-455f-a414-0c389ffd9aa9 --- # Warning C6525 > Invalid size specification: property value may not be valid +## Remarks + > [!NOTE] > This warning occurs only in code that is using a deprecated version of the source-code annotation language (SAL). We recommend that you port your code to use the latest version of SAL. For more information, see [Using SAL Annotations to Reduce C/C++ Code Defects](../code-quality/using-sal-annotations-to-reduce-c-cpp-code-defects.md). -## Remarks - This warning indicates that the property value used to specify the size isn't valid. The warning occurs if the size parameter is annotated using `Valid=No`. Code analysis name: `INVALID_SIZE_STRING_UNREACHABLE_LOCATION` diff --git a/docs/code-quality/c6527.md b/docs/code-quality/c6527.md index 4c6c08810c6..0df3ea2dd62 100644 --- a/docs/code-quality/c6527.md +++ b/docs/code-quality/c6527.md @@ -1,10 +1,9 @@ --- +title: "Warning C6527" description: "Learn more about: Warning C6527" -title: Warning C6527 ms.date: 11/04/2016 f1_keywords: ["C6527"] helpviewer_keywords: ["C6527"] -ms.assetid: 5ebb6279-0f75-4566-a5f3-a47834de9625 --- # Warning C6527 diff --git a/docs/code-quality/c6530.md b/docs/code-quality/c6530.md index 4bf05cf3e30..fcaaaee3b72 100644 --- a/docs/code-quality/c6530.md +++ b/docs/code-quality/c6530.md @@ -1,20 +1,19 @@ --- +title: "Warning C6530" description: "Learn more about: Warning C6530" -title: Warning C6530 ms.date: 11/04/2016 f1_keywords: ["C6530", "UNRECOGNIZED_FORMAT_STRING_STYLE", "__WARNING_UNRECOGNIZED_FORMAT_STRING_STYLE"] helpviewer_keywords: ["C6530"] -ms.assetid: 60e9dc58-e0f1-4a34-8c75-efebaa6cadd2 --- # Warning C6530 > Unrecognized format string style '*name*' +## Remarks + > [!NOTE] > This warning occurs only in code that is using a deprecated version of the source-code annotation language (SAL). We recommend that you port your code to use the latest version of SAL. For more information, see [Using SAL Annotations to Reduce C/C++ Code Defects](../code-quality/using-sal-annotations-to-reduce-c-cpp-code-defects.md). -## Remarks - This warning indicates that the `FormatString` property is using a value other than `scanf` or `printf`. To correct this warning, review your code and use a valid value for the `Style` property. Code analysis name: `UNRECOGNIZED_FORMAT_STRING_STYLE` diff --git a/docs/code-quality/c6540.md b/docs/code-quality/c6540.md index 77790ec3ea0..65e63f09ada 100644 --- a/docs/code-quality/c6540.md +++ b/docs/code-quality/c6540.md @@ -1,10 +1,9 @@ --- +title: "Warning C6540" description: "Learn more about: Warning C6540" -title: Warning C6540 ms.date: 11/04/2016 f1_keywords: ["C6540"] helpviewer_keywords: ["C6540"] -ms.assetid: b047084c-9187-443e-8bcd-8f42064003f7 --- # Warning C6540 diff --git a/docs/code-quality/c6551.md b/docs/code-quality/c6551.md index d6b47b6f155..6a4e0b3c4a9 100644 --- a/docs/code-quality/c6551.md +++ b/docs/code-quality/c6551.md @@ -1,14 +1,15 @@ --- +title: "Warning C6551" description: "Learn more about: Warning C6551" -title: Warning C6551 ms.date: 11/04/2016 f1_keywords: ["C6551"] helpviewer_keywords: ["C6551"] -ms.assetid: cfd02698-7ba7-4564-841d-208999b1561d --- # Warning C6551 > Invalid size specification: expression not parsable +## Remarks + > [!NOTE] > This warning occurs only in code that is using a deprecated version of the source-code annotation language (SAL). We recommend that you port your code to use the latest version of SAL. For more information, see [Using SAL Annotations to Reduce C/C++ Code Defects](../code-quality/using-sal-annotations-to-reduce-c-cpp-code-defects.md). diff --git a/docs/code-quality/c6552.md b/docs/code-quality/c6552.md index 9ccb714199a..ebdf48ef39d 100644 --- a/docs/code-quality/c6552.md +++ b/docs/code-quality/c6552.md @@ -1,14 +1,15 @@ --- +title: "Warning C6552" description: "Learn more about: Warning C6552" -title: Warning C6552 ms.date: 11/04/2016 f1_keywords: ["C6552"] helpviewer_keywords: ["C6552"] -ms.assetid: 6c6f17d8-4ddd-4fad-b81f-e32285e7afa8 --- # Warning C6552 > Invalid `Deref=` or `Notref=`: expression not parsable +## Remarks + > [!NOTE] > This warning occurs only in code that is using a deprecated version of the source-code annotation language (SAL). We recommend that you port your code to use the latest version of SAL. For more information, see [Using SAL Annotations to Reduce C/C++ Code Defects](../code-quality/using-sal-annotations-to-reduce-c-cpp-code-defects.md). diff --git a/docs/code-quality/c6701.md b/docs/code-quality/c6701.md index bdbbdf6afad..35aa86ba49d 100644 --- a/docs/code-quality/c6701.md +++ b/docs/code-quality/c6701.md @@ -1,13 +1,14 @@ --- +title: "Warning C6701" description: "Learn more about: Warning C6701" -title: Warning C6701 ms.date: 11/04/2016 f1_keywords: ["C6701"] -helpviewer_keywords: ["C67901"] -ms.assetid: c48484e2-542c-4f7b-93ea-98c6367cb3d9 +helpviewer_keywords: ["C6701"] --- # Warning C6701 > The value is not a valid Yes/No/Maybe value: '*string*' +## Remarks + This warning is reported when there's an error in the annotations. diff --git a/docs/code-quality/c6702.md b/docs/code-quality/c6702.md index 6fb0c5520df..ecb9a87a5dc 100644 --- a/docs/code-quality/c6702.md +++ b/docs/code-quality/c6702.md @@ -1,13 +1,14 @@ --- +title: "Warning C6702" description: "Learn more about: Warning C6702" -title: Warning C6702 ms.date: 11/04/2016 f1_keywords: ["C6702"] helpviewer_keywords: ["C6702"] -ms.assetid: 6d373843-4ab4-4a94-bb83-5fec9214c625 --- # Warning C6702 > The value is not a string value: '*string*' +## Remarks + This warning is reported when there's an error in the annotations. diff --git a/docs/code-quality/c6703.md b/docs/code-quality/c6703.md index f8b5ad7669f..40f198dc2e5 100644 --- a/docs/code-quality/c6703.md +++ b/docs/code-quality/c6703.md @@ -1,13 +1,14 @@ --- +title: "Warning C6703" description: "Learn more about: Warning C6703" -title: Warning C6703 ms.date: 11/04/2016 f1_keywords: ["C6703"] helpviewer_keywords: ["C6703"] -ms.assetid: 8ec4f403-e63e-4930-8266-569c9cd263b4 --- # Warning C6703 > The value is not a number: '*string*' +## Remarks + This warning is reported when there's an error in the annotations. diff --git a/docs/code-quality/c6704.md b/docs/code-quality/c6704.md index c15266ab7fe..5a68ddfee58 100644 --- a/docs/code-quality/c6704.md +++ b/docs/code-quality/c6704.md @@ -1,13 +1,14 @@ --- +title: "Warning C6704" description: "Learn more about: Warning C6704" -title: Warning C6704 ms.date: 11/04/2016 f1_keywords: ["C6704"] helpviewer_keywords: ["C6704"] -ms.assetid: fc25543d-746e-415e-b0a8-d5134461af41 --- # Warning C6704 > Unexpected Annotation Expression Error: '*annotation*' ['*why*'] +## Remarks + This warning is reported when there's an error in the annotations. diff --git a/docs/code-quality/c6705.md b/docs/code-quality/c6705.md index 6d6c84dcc51..17a2222150d 100644 --- a/docs/code-quality/c6705.md +++ b/docs/code-quality/c6705.md @@ -1,13 +1,14 @@ --- +title: "Warning C6705" description: "Learn more about: Warning C6705" -title: Warning C6705 ms.date: 11/04/2016 f1_keywords: ["C6705"] helpviewer_keywords: ["C6705"] -ms.assetid: 5d81e7ac-0c51-4cca-aaa8-df1aa599f175 --- # Warning C6705 > Annotation error expected arguments for annotation '*parameter*' found . +## Remarks + This warning is reported when there's an error in the annotations. diff --git a/docs/code-quality/c6706.md b/docs/code-quality/c6706.md index 317a1bb989d..7f430a9c48b 100644 --- a/docs/code-quality/c6706.md +++ b/docs/code-quality/c6706.md @@ -1,13 +1,14 @@ --- +title: "Warning C6706" description: "Learn more about: Warning C6706" -title: Warning C6706 ms.date: 11/04/2016 f1_keywords: ["C6706"] helpviewer_keywords: ["C6706"] -ms.assetid: 20f3fd01-4993-4f7f-bd3f-57706356cf1d --- # Warning C6706 > Unexpected Annotation Error for annotation '*annotation*': '*why*' +## Remarks + This warning is reported when there's an error in the annotations. diff --git a/docs/code-quality/c6707.md b/docs/code-quality/c6707.md index 8a12d79df99..24441240b1d 100644 --- a/docs/code-quality/c6707.md +++ b/docs/code-quality/c6707.md @@ -1,10 +1,9 @@ --- +title: "Warning C6707" description: "Learn more about: Warning C6707" -title: Warning C6707 ms.date: 11/04/2016 f1_keywords: ["C6707"] helpviewer_keywords: ["C6707"] -ms.assetid: a6610464-9bc5-4f24-b0a5-7fa29581874d --- # Warning C6707 diff --git a/docs/code-quality/c6993.md b/docs/code-quality/c6993.md index e4df96bfabb..a2b72c3ae86 100644 --- a/docs/code-quality/c6993.md +++ b/docs/code-quality/c6993.md @@ -1,12 +1,16 @@ --- +title: "Warning C6993" description: "Learn more about: Warning C6993" -title: Warning C6993 -ms.date: 11/04/2016 +ms.date: 2/25/2025 f1_keywords: ["C6993"] -ms.assetid: 7ea93bc6-b934-4b6b-b71a-a56e765fb4cd +helpviewer_keywords: ["C6993"] --- # Warning C6993 > Code analysis ignores OpenMP constructs; analyzing single-threaded code -This warning indicates that the Code Analyzer has encountered Open MP pragmas that it can't analyze. +## Remarks + +This warning indicates that the static analysis tools don't support Open MP pragmas. The static analysis tools could generate incorrect results because they assume the code is single-threaded, not multi-threaded. + +Your code doesn't necessarily need to be 'fixed' to resolve this diagnostic because this warning indicates what the toolset supports and not an issue with your code. \ No newline at end of file diff --git a/docs/code-quality/c6995.md b/docs/code-quality/c6995.md index 6e5736bd791..a7183235967 100644 --- a/docs/code-quality/c6995.md +++ b/docs/code-quality/c6995.md @@ -1,14 +1,16 @@ --- +title: "Warning C6995" description: "Learn more about: Warning C6995" -title: Warning C6995 ms.date: 11/04/2016 f1_keywords: ["C6995"] -ms.assetid: 1e82e3ad-99fe-4a35-87d5-359c74b9658e +helpviewer_keywords: ["C6995"] --- # Warning C6995 > Failed to save XML Log file +## Remarks + This warning indicates that the Code Analysis tool can't create the defect log, which is the output of the code analysis. This error might indicate a disk error or indicate that you don't have permission to create a file in the specified directory. diff --git a/docs/code-quality/c6997.md b/docs/code-quality/c6997.md index 4090bea0511..693cd3ffb47 100644 --- a/docs/code-quality/c6997.md +++ b/docs/code-quality/c6997.md @@ -1,9 +1,9 @@ --- +title: "Warning C6997" description: "Learn more about: Warning C6997" -title: Warning C6997 ms.date: 11/04/2016 f1_keywords: ["C6997", "IGNORED_ANNOTATIONS"] -ms.assetid: 48fd86a3-d57b-4ecb-979a-5d3a4186482e +helpviewer_keywords: ["C6997"] --- # Warning C6997 diff --git a/docs/code-quality/clang-tidy.md b/docs/code-quality/clang-tidy.md index 7427e96a45c..3d731181ea9 100644 --- a/docs/code-quality/clang-tidy.md +++ b/docs/code-quality/clang-tidy.md @@ -2,8 +2,8 @@ title: Using Clang-Tidy in Visual Studio description: "How to use Clang-Tidy in Visual Studio for Microsoft C++ code analysis." ms.date: 03/1/2022 -ms.topic: "conceptual" -f1_keywords: ["vs.codeanalysis.clangtidy","vs.codeanalysis.propertypages.ClangTidyToolPath"] +ms.topic: "concept-article" +f1_keywords: ["vs.codeanalysis.clangtidy","vs.codeanalysis.propertypages.ClangTidyToolPath","vs.codeanalysis.propertypages.AdditionalOptions","vs.codeanalysis.propertypages.MaxProcesses"] --- # Using Clang-Tidy in Visual Studio @@ -94,6 +94,18 @@ By default, Clang-Tidy does not set any checks when enabled. To see the list of If you'd like to have custom rules built into your clang-tidy executable and run it in Microsoft Visual Studio, you can change the path to the executable that Visual Studio runs. In the project Property Pages dialog, open the **Configuration Properties** > **Code Analysis** > **Clang-Tidy** page. Manually type in the path or **Browse** and select the path under the **Clang-Tidy Tool Directory** property. The new executable is used once the change is saved, and the app is recompiled. +## Clang-Tidy Additional Options + +The **Clang-Tidy Additional Options** property lets you specify additional compiler arguments that are passed to Clang-Tidy using the `--extra-args` command-line option. These arguments can be used to control how Clang-Tidy parses your code, such as defining macros, include paths, or language standards. Enter arguments as a semi-colon separated list. For example: `-std=c++20;-DMY_DEFINE=1;-Ipath\to\include`. + +## Clang-Tidy Prepend Additional Options + +The **Clang-Tidy Prepend Additional Options** property lets you specify compiler arguments that are passed to Clang-Tidy using the `--extra-args-before` command-line option. These arguments are inserted before the default compiler arguments when Clang-Tidy parses your code. Enter arguments as a semi-colon separated list. For example: `-std=c++20;-DMY_DEFINE=1;`. + +## Max Number of Processes + +The **Max Number of Processes** property lets you specify how many processes Clang-Tidy can use to run analysis in parallel. By default, Clang-Tidy runs serially. Set this property to enable parallel execution and specify the number of parallel processes. Set it to `0` to use all available logical processors on your system. Increasing the number of processes can improve analysis speed on multi-core machines. + ## See also [Clang/LLVM support for MSBuild projects](https://devblogs.microsoft.com/cppblog/clang-llvm-support-for-msbuild-projects/)\ diff --git a/docs/code-quality/code-analysis-for-c-cpp-overview.md b/docs/code-quality/code-analysis-for-c-cpp-overview.md index e9ef85e6775..fffa6d3ad8b 100644 --- a/docs/code-quality/code-analysis-for-c-cpp-overview.md +++ b/docs/code-quality/code-analysis-for-c-cpp-overview.md @@ -2,7 +2,7 @@ description: "Learn more about: Code analysis for C/C++ overview" title: Code analysis for C/C++ overview ms.date: 04/28/2018 -ms.topic: conceptual +ms.topic: concept-article helpviewer_keywords: - "annotations, code analysis" - "build integration, code analysis" @@ -20,7 +20,7 @@ ms.assetid: 81f0c9e8-f471-4de5-aac4-99db336a8809 --- # Code analysis for C/C++ overview -The C/C++ Code Analysis tool provides information about possible defects in your C/C++ source code. Common coding errors reported by the tool include buffer overruns, uninitialized memory, null pointer dereferences, and memory and resource leaks. The tool can also run checks against the [C++ Core Guidelines](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md). +The Microsoft C++ Code Analysis tool provides information about possible defects in your C/C++ source code. Common coding errors reported by the tool include buffer overruns, uninitialized memory, null pointer dereferences, and memory and resource leaks. The tool can also run checks against the [C++ Core Guidelines](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines). ## IDE (integrated development environment) integration diff --git a/docs/code-quality/code-analysis-for-cpp-corecheck.md b/docs/code-quality/code-analysis-for-cpp-corecheck.md index ecae8ba0d0f..c57ae64393f 100644 --- a/docs/code-quality/code-analysis-for-cpp-corecheck.md +++ b/docs/code-quality/code-analysis-for-cpp-corecheck.md @@ -1,11 +1,10 @@ --- +title: "C++ Core Guidelines checker reference" description: "Learn more about: C++ Core Guidelines checker reference" -title: C++ Core Guidelines checker reference ms.date: 03/22/2018 ms.topic: reference helpviewer_keywords: - "code analysis, C++ core check" -ms.assetid: f1429463-136e-41ed-8a75-a8dbf0b4fd89 --- # C++ Core Guidelines checker reference @@ -17,250 +16,250 @@ This section lists C++ Core Guidelines Checker warnings. For information about C ## OWNER_POINTER Group [C26402 DONT_HEAP_ALLOCATE_MOVABLE_RESULT](C26402.md)\ -Return a scoped object instead of a heap-allocated if it has a move constructor. See [C++ Core Guidelines R.3](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#Rr-ptr). +Return a scoped object instead of a heap-allocated if it has a move constructor. See [C++ Core Guidelines R.3](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Rr-ptr). [C26403 RESET_OR_DELETE_OWNER](C26403.md)\ -Reset or explicitly delete an owner\ pointer '*variable*'. See [C++ Core Guidelines R.3](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#Rr-ptr). +Reset or explicitly delete an owner\ pointer '*variable*'. See [C++ Core Guidelines R.3](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Rr-ptr). [C26404 DONT_DELETE_INVALID](C26404.md)\ -Do not delete an owner\ that may be in invalid state. See [C++ Core Guidelines R.3](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#Rr-ptr). +Do not delete an owner\ that may be in invalid state. See [C++ Core Guidelines R.3](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Rr-ptr). [C26405 DONT_ASSIGN_TO_VALID](C26405.md)\ -Do not assign to an owner\ that may be in valid state. See [C++ Core Guidelines R.3](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#Rr-ptr). +Do not assign to an owner\ that may be in valid state. See [C++ Core Guidelines R.3](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Rr-ptr). [C26406 DONT_ASSIGN_RAW_TO_OWNER](C26406.md)\ -Do not assign a raw pointer to an owner\. See [C++ Core Guidelines R.3](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#Rr-ptr). +Do not assign a raw pointer to an owner\. See [C++ Core Guidelines R.3](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Rr-ptr). [C26407 DONT_HEAP_ALLOCATE_UNNECESSARILY](C26407.md)\ -Prefer scoped objects, don't heap-allocate unnecessarily. See [C++ Core Guidelines R.5](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#Rr-scoped). +Prefer scoped objects, don't heap-allocate unnecessarily. See [C++ Core Guidelines R.5](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Rr-scoped). [C26429 USE_NOTNULL](C26429.md)\ -Symbol '*symbol*' is never tested for nullness, it can be marked as not_null. See [C++ Core Guidelines F.23](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#f23-use-a-not_nullt-to-indicate-that-null-is-not-a-valid-value). +Symbol '*symbol*' is never tested for nullness, it can be marked as not_null. See [C++ Core Guidelines F.23](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Rf-nullptr). [C26430 TEST_ON_ALL_PATHS](C26430.md)\ -Symbol '*symbol*' is not tested for nullness on all paths. See [C++ Core Guidelines F.23](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#f23-use-a-not_nullt-to-indicate-that-null-is-not-a-valid-value). +Symbol '*symbol*' is not tested for nullness on all paths. See [C++ Core Guidelines F.23](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Rf-nullptr). [C26431 DONT_TEST_NOTNULL](C26431.md)\ -The type of expression '*expr*' is already gsl::not_null. Do not test it for nullness. See [C++ Core Guidelines F.23](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#f23-use-a-not_nullt-to-indicate-that-null-is-not-a-valid-value). +The type of expression '*expr*' is already gsl::not_null. Do not test it for nullness. See [C++ Core Guidelines F.23](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Rf-nullptr). ## RAW_POINTER Group [C26400 NO_RAW_POINTER_ASSIGNMENT](c26400.md)\ -Do not assign the result of an allocation or a function call with an owner\ return value to a raw pointer; use owner\ instead. See [C++ Core Guidelines I.11](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#Ri-raw). +Do not assign the result of an allocation or a function call with an owner\ return value to a raw pointer; use owner\ instead. See [C++ Core Guidelines I.11](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Ri-raw). [C26401 DONT_DELETE_NON_OWNER](c26401.md)\ -Do not delete a raw pointer that is not an owner\. See [C++ Core Guidelines I.11](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#Ri-raw). +Do not delete a raw pointer that is not an owner\. See [C++ Core Guidelines I.11](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Ri-raw). [C26402 DONT_HEAP_ALLOCATE_MOVABLE_RESULT](C26402.md)\ -Return a scoped object instead of a heap-allocated if it has a move constructor. See [C++ Core Guidelines R.3](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#Rr-ptr). +Return a scoped object instead of a heap-allocated if it has a move constructor. See [C++ Core Guidelines R.3](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Rr-ptr). [C26408 NO_MALLOC_FREE](C26408.md)\ -Avoid malloc() and free(), prefer the nothrow version of new with delete. See [C++ Core Guidelines R.10](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#Rr-mallocfree). +Avoid malloc() and free(), prefer the nothrow version of new with delete. See [C++ Core Guidelines R.10](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Rr-mallocfree). [C26409 NO_NEW_DELETE](C26409.md)\ -Avoid calling new and delete explicitly, use std::make_unique\ instead. See [C++ Core Guidelines R.11](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#Rr-newdelete). +Avoid calling new and delete explicitly, use std::make_unique\ instead. See [C++ Core Guidelines R.11](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Rr-newdelete). [C26429 USE_NOTNULL](C26429.md)\ -Symbol '*symbol*' is never tested for nullness, it can be marked as not_null. See [C++ Core Guidelines F.23](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#f23-use-a-not_nullt-to-indicate-that-null-is-not-a-valid-value). +Symbol '*symbol*' is never tested for nullness, it can be marked as not_null. See [C++ Core Guidelines F.23](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Rf-nullptr). [C26430 TEST_ON_ALL_PATHS](C26430.md)\ -Symbol '*symbol*' is not tested for nullness on all paths. See [C++ Core Guidelines F.23](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#f23-use-a-not_nullt-to-indicate-that-null-is-not-a-valid-value). +Symbol '*symbol*' is not tested for nullness on all paths. See [C++ Core Guidelines F.23](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Rf-nullptr). [C26431 DONT_TEST_NOTNULL](C26431.md)\ -The type of expression '*expr*' is already gsl::not_null. Do not test it for nullness. See [C++ Core Guidelines F.23](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#f23-use-a-not_nullt-to-indicate-that-null-is-not-a-valid-value). +The type of expression '*expr*' is already gsl::not_null. Do not test it for nullness. See [C++ Core Guidelines F.23](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Rf-nullptr). [C26481 NO_POINTER_ARITHMETIC](C26481.md)\ -Don't use pointer arithmetic. Use span instead. See [C++ Core Guidelines Bounds.1](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#SS-bounds). +Don't use pointer arithmetic. Use span instead. See [C++ Core Guidelines Bounds.1](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Pro-bounds-arithmetic). [C26485 NO_ARRAY_TO_POINTER_DECAY](C26485.md)\ -Expression '*expr*': No array to pointer decay. See [C++ Core Guidelines Bounds.3](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#SS-bounds). +Expression '*expr*': No array to pointer decay. See [C++ Core Guidelines Bounds.3](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Pro-bounds-decay). ## UNIQUE_POINTER Group [C26410 NO_REF_TO_CONST_UNIQUE_PTR](C26410.md)\ -The parameter '*parameter*' is a reference to `const` unique pointer, use const T* or const T& instead. See [C++ Core Guidelines R.32](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#Rr-uniqueptrparam). +The parameter '*parameter*' is a reference to `const` unique pointer, use const T* or const T& instead. See [C++ Core Guidelines R.32](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Rr-uniqueptrparam). [C26411 NO_REF_TO_UNIQUE_PTR](C26411.md)\ -The parameter '*parameter*' is a reference to unique pointer and it is never reassigned or reset, use T* or T& instead. See [C++ Core Guidelines R.33](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#Rr-reseat). +The parameter '*parameter*' is a reference to unique pointer and it is never reassigned or reset, use T* or T& instead. See [C++ Core Guidelines R.33](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Rr-reseat). [C26414 RESET_LOCAL_SMART_PTR](C26414.md)\ -Move, copy, reassign, or reset a local smart pointer '*symbol*'. See [C++ Core Guidelines R.5](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#Rr-scoped). +Move, copy, reassign, or reset a local smart pointer '*symbol*'. See [C++ Core Guidelines R.5](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Rr-scoped). [C26415 SMART_PTR_NOT_NEEDED](C26415.md)\ -Smart pointer parameter '*symbol*' is used only to access contained pointer. Use T* or T& instead. See [C++ Core Guidelines R.30](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#Rr-smartptrparam). +Smart pointer parameter '*symbol*' is used only to access contained pointer. Use T* or T& instead. See [C++ Core Guidelines R.30](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Rr-smartptrparam). ## SHARED_POINTER Group [C26414 RESET_LOCAL_SMART_PTR](C26414.md)\ -Move, copy, reassign, or reset a local smart pointer '*symbol*'. See [C++ Core Guidelines R.5](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#Rr-scoped). +Move, copy, reassign, or reset a local smart pointer '*symbol*'. See [C++ Core Guidelines R.5](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Rr-scoped). [C26415 SMART_PTR_NOT_NEEDED](C26415.md)\ -Smart pointer parameter '*symbol*' is used only to access contained pointer. Use T* or T& instead. See [C++ Core Guidelines R.30](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#Rr-smartptrparam). +Smart pointer parameter '*symbol*' is used only to access contained pointer. Use T* or T& instead. See [C++ Core Guidelines R.30](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Rr-smartptrparam). [C26416 NO_RVALUE_REF_SHARED_PTR](C26416.md)\ -Shared pointer parameter '*symbol*' is passed by rvalue reference. Pass by value instead. See [C++ Core Guidelines R.34](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#Rr-sharedptrparam-owner). +Shared pointer parameter '*symbol*' is passed by rvalue reference. Pass by value instead. See [C++ Core Guidelines R.34](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Rr-sharedptrparam-owner). [C26417 NO_LVALUE_REF_SHARED_PTR](C26417.md)\ -Shared pointer parameter '*symbol*' is passed by reference and not reset or reassigned. Use T* or T& instead. See [C++ Core Guidelines R.35](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#Rr-sharedptrparam). +Shared pointer parameter '*symbol*' is passed by reference and not reset or reassigned. Use T* or T& instead. See [C++ Core Guidelines R.35](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Rr-sharedptrparam). [C26418 NO_VALUE_OR_CONST_REF_SHARED_PTR](C26418.md)\ -Shared pointer parameter '*symbol*' is not copied or moved. Use T* or T& instead. See [C++ Core Guidelines R.36](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#Rr-sharedptrparam-const). +Shared pointer parameter '*symbol*' is not copied or moved. Use T* or T& instead. See [C++ Core Guidelines R.36](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Rr-sharedptrparam-const). ## DECLARATION Group [C26426 NO_GLOBAL_INIT_CALLS](C26426.md)\ -Global initializer calls a non-constexpr function '*symbol*'. See [C++ Core Guidelines I.22](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#i22-avoid-complex-initialization-of-global-objects). +Global initializer calls a non-constexpr function '*symbol*'. See [C++ Core Guidelines I.22](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Ri-global-init). [C26427 NO_GLOBAL_INIT_EXTERNS](C26427.md)\ -Global initializer accesses extern object '*symbol*'. See [C++ Core Guidelines I.22](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#i22-avoid-complex-initialization-of-global-objects). +Global initializer accesses extern object '*symbol*'. See [C++ Core Guidelines I.22](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Ri-global-init). [C26444 NO_UNNAMED_RAII_OBJECTS](c26444.md)\ -Avoid unnamed objects with custom construction and destruction. See [ES.84: Don't (try to) declare a local variable with no name](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md). +Avoid unnamed objects with custom construction and destruction. See [ES.84: Don't (try to) declare a local variable with no name](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Res-noname). ## CLASS Group [C26432 DEFINE_OR_DELETE_SPECIAL_OPS](C26432.md)\ -If you define or delete any default operation in the type '*symbol*', define or delete them all. See [C++ Core Guidelines C.21](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#c21-if-you-define-or-delete-any-default-operation-define-or-delete-them-all). +If you define or delete any default operation in the type '*symbol*', define or delete them all. See [C++ Core Guidelines C.21](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Rc-five). [C26433 OVERRIDE_EXPLICITLY](c26433.md)\ -Function '*symbol*' should be marked with 'override'. See [C.128: Virtual functions should specify exactly one of virtual, override, or final](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#c128-virtual-functions-should-specify-exactly-one-of-virtual-override-or-final). +Function '*symbol*' should be marked with 'override'. See [C.128: Virtual functions should specify exactly one of virtual, override, or final](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Rh-override). [C26434 DONT_HIDE_METHODS](C26434.md)\ -Function '*symbol_1*' hides a non-virtual function '*symbol_2*'. See [C++ Core Guidelines C.128](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#c128-virtual-functions-should-specify-exactly-one-of-virtual-override-or-final). +Function '*symbol_1*' hides a non-virtual function '*symbol_2*'. See [C++ Core Guidelines C.128](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Rh-override). [C26435 SINGLE_VIRTUAL_SPECIFICATION](c26435.md)\ -Function '*symbol*' should specify exactly one of 'virtual', 'override', or 'final'. See [C.128: Virtual functions should specify exactly one of virtual, override, or final](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md). +Function '*symbol*' should specify exactly one of 'virtual', 'override', or 'final'. See [C.128: Virtual functions should specify exactly one of virtual, override, or final](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Rh-override). [C26436 NEED_VIRTUAL_DTOR](C26436.md)\ -The type '*symbol*' with a virtual function needs either public virtual or protected non-virtual destructor. See [C++ Core Guidelines C.35](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#c35-a-base-class-destructor-should-be-either-public-and-virtual-or-protected-and-nonvirtual). +The type '*symbol*' with a virtual function needs either public virtual or protected non-virtual destructor. See [C++ Core Guidelines C.35](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Rc-dtor-virtual). [C26443 NO_EXPLICIT_DTOR_OVERRIDE](c26443.md)\ -Overriding destructor should not use explicit 'override' or 'virtual' specifiers. See [C.128: Virtual functions should specify exactly one of virtual, override, or final](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md). +Overriding destructor should not use explicit 'override' or 'virtual' specifiers. See [C.128: Virtual functions should specify exactly one of virtual, override, or final](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Rh-override). ## STYLE Group [C26438 NO_GOTO](C26438.md)\ -Avoid `goto`. See [C++ Core Guidelines ES.76](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#es76-avoid-goto). +Avoid `goto`. See [C++ Core Guidelines ES.76](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Res-goto). ## FUNCTION Group [C26439 SPECIAL_NOEXCEPT](C26439.md)\ -This kind of function may not throw. Declare it **`noexcept`**. See [C++ Core Guidelines F.6](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#f6-if-your-function-may-not-throw-declare-it-noexcept). +This kind of function may not throw. Declare it **`noexcept`**. See [C++ Core Guidelines F.6](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Rf-noexcept). [C26440 DECLARE_NOEXCEPT](C26440.md)\ -Function '*symbol*' can be declared **`noexcept`**. See [C++ Core Guidelines F.6](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#f6-if-your-function-may-not-throw-declare-it-noexcept). +Function '*symbol*' can be declared **`noexcept`**. See [C++ Core Guidelines F.6](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Rf-noexcept). [C26447 DONT_THROW_IN_NOEXCEPT](c26447.md)\ The function is declared **`noexcept`** but calls a function which may throw exceptions. -See [C++ Core Guidelines: F.6: If your function may not throw, declare it noexcept](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#f6-if-your-function-may-not-throw-declare-it-noexcept). +See [C++ Core Guidelines: F.6: If your function may not throw, declare it noexcept](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Rf-noexcept). ## CONCURRENCY Group [C26441 NO_UNNAMED_GUARDS](C26441.md)\ -Guard objects must be named. See [C++ Core Guidelines cp.44](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#cp44-remember-to-name-your-lock_guards-and-unique_locks). +Guard objects must be named. See [C++ Core Guidelines cp.44](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Rconc-name). ## CONST Group [C26460 USE_CONST_REFERENCE_ARGUMENTS](c26460.md)\ -The reference argument '*argument*' for function '*function*' can be marked as `const`. See [C++ Core Guidelines con.3](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#Rconst-ref). +The reference argument '*argument*' for function '*function*' can be marked as `const`. See [C++ Core Guidelines con.3](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Rconst-ref). [C26461 USE_CONST_POINTER_ARGUMENTS](c26461.md):\ -The pointer argument '*argument*' for function '*function*' can be marked as a pointer to `const`. See [C++ Core Guidelines con.3](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#Rconst-ref). +The pointer argument '*argument*' for function '*function*' can be marked as a pointer to `const`. See [C++ Core Guidelines con.3](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Rconst-ref). [C26462 USE_CONST_POINTER_FOR_VARIABLE](c26462.md)\ -The value pointed to by '*variable*' is assigned only once, mark it as a pointer to `const`. See [C++ Core Guidelines con.4](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#con4-use-const-to-define-objects-with-values-that-do-not-change-after-construction). +The value pointed to by '*variable*' is assigned only once, mark it as a pointer to `const`. See [C++ Core Guidelines con.4](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Rconst-const). [C26463 USE_CONST_FOR_ELEMENTS](c26463.md)\ -The elements of array '*array*' are assigned only once, mark elements `const`. See [C++ Core Guidelines con.4](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#con4-use-const-to-define-objects-with-values-that-do-not-change-after-construction). +The elements of array '*array*' are assigned only once, mark elements `const`. See [C++ Core Guidelines con.4](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Rconst-const). [C26464 USE_CONST_POINTER_FOR_ELEMENTS](c26464.md)\ -The values pointed to by elements of array '*array*' are assigned only once, mark elements as pointer to `const`. See [C++ Core Guidelines con.4](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#con4-use-const-to-define-objects-with-values-that-do-not-change-after-construction). +The values pointed to by elements of array '*array*' are assigned only once, mark elements as pointer to `const`. See [C++ Core Guidelines con.4](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Rconst-const). [C26496 USE_CONST_FOR_VARIABLE](c26496.md)\ -The variable '*variable*' is assigned only once, mark it as `const`. See [C++ Core Guidelines con.4](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#con4-use-const-to-define-objects-with-values-that-do-not-change-after-construction). +The variable '*variable*' is assigned only once, mark it as `const`. See [C++ Core Guidelines con.4](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Rconst-const). [C26497 USE_CONSTEXPR_FOR_FUNCTION](c26497.md)\ -This function *function* could be marked `constexpr` if compile-time evaluation is desired. See [C++ Core Guidelines F.4](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#Rf-constexpr). +This function *function* could be marked `constexpr` if compile-time evaluation is desired. See [C++ Core Guidelines F.4](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Rf-constexpr). [C26498 USE_CONSTEXPR_FOR_FUNCTIONCALL](c26498.md)\ -This function call *function* can use `constexpr` if compile-time evaluation is desired. See [C++ Core Guidelines con.5](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#Rconst-constexpr). +This function call *function* can use `constexpr` if compile-time evaluation is desired. See [C++ Core Guidelines con.5](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Rconst-constexpr). ## TYPE Group [C26437 DONT_SLICE](C26437.md)\ -Do not slice. See [C++ Core Guidelines ES.63](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#es63-dont-slice). +Do not slice. See [C++ Core Guidelines ES.63](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Res-slice). [C26465 NO_CONST_CAST_UNNECESSARY](c26465.md)\ -Don't use `const_cast` to cast away `const`. `const_cast` is not required; constness or volatility is not being removed by this conversion. See [C++ Core Guidelines Type.3](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#Pro-type-constcast). +Don't use `const_cast` to cast away `const`. `const_cast` is not required; constness or volatility is not being removed by this conversion. See [C++ Core Guidelines Type.3](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Pro-type-constcast). [C26466 NO_STATIC_DOWNCAST_POLYMORPHIC](c26466.md)\ -Don't use `static_cast` downcasts. A cast from a polymorphic type should use dynamic_cast. See [C++ Core Guidelines Type.2](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#Pro-type-downcast). +Don't use `static_cast` downcasts. A cast from a polymorphic type should use dynamic_cast. See [C++ Core Guidelines Type.2](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Pro-type-downcast). [C26471 NO_REINTERPRET_CAST_FROM_VOID_PTR](c26471.md)\ -Don't use `reinterpret_cast`. A cast from void* can use `static_cast`. See [C++ Core Guidelines Type.1](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#Pro-type-reinterpretcast). +Don't use `reinterpret_cast`. A cast from void* can use `static_cast`. See [C++ Core Guidelines Type.1](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Pro-type-reinterpretcast). [C26472 NO_CASTS_FOR_ARITHMETIC_CONVERSION](C26472.md)\ -Don't use a `static_cast` for arithmetic conversions. Use brace initialization, gsl::narrow_cast, or gsl::narrow. See [C++ Core Guidelines Type.1](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#Pro-type-reinterpretcast). +Don't use a `static_cast` for arithmetic conversions. Use brace initialization, gsl::narrow_cast, or gsl::narrow. See [C++ Core Guidelines Type.1](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Pro-type-arithmeticcast). [C26473 NO_IDENTITY_CAST](C26473.md)\ -Don't cast between pointer types where the source type and the target type are the same. See [C++ Core Guidelines Type.1](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#Pro-type-reinterpretcast). +Don't cast between pointer types where the source type and the target type are the same. See [C++ Core Guidelines Type.1](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Pro-type-identitycast). [C26474 NO_IMPLICIT_CAST](C26474.md)\ -Don't cast between pointer types when the conversion could be implicit. See [C++ Core Guidelines Type.1](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#Pro-type-reinterpretcast). +Don't cast between pointer types when the conversion could be implicit. See [C++ Core Guidelines Type.1](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Pro-type-implicitpointercast). [C26475 NO_FUNCTION_STYLE_CASTS](C26475.md)\ -Do not use function style C-casts. See [C++ Core Guidelines ES.49](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#es49-if-you-must-use-a-cast-use-a-named-cast). +Do not use function style C-casts. See [C++ Core Guidelines ES.49](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Res-casts-named). [C26490 NO_REINTERPRET_CAST](c26490.md)\ -Don't use `reinterpret_cast`. See [C++ Core Guidelines Type.1](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#SS-type). +Don't use `reinterpret_cast`. See [C++ Core Guidelines Type.1](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Pro-type-reinterpretcast). -[C26491 NO_STATIC_DOWNCAST](c26490.md)\ -Don't use `static_cast` downcasts. See [C++ Core Guidelines Type.2](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#SS-type). +[C26491 NO_STATIC_DOWNCAST](c26491.md)\ +Don't use `static_cast` downcasts. See [C++ Core Guidelines Type.2](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Pro-type-downcast). [C26492 NO_CONST_CAST](c26492.md)\ -Don't use `const_cast` to cast away `const`. See [C++ Core Guidelines Type.3](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#SS-type). +Don't use `const_cast` to cast away `const`. See [C++ Core Guidelines Type.3](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Pro-type-constcast). [C26493 NO_CSTYLE_CAST](c26493.md)\ -Don't use C-style casts. See [C++ Core Guidelines Type.4](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#SS-type). +Don't use C-style casts. See [C++ Core Guidelines Type.4](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Pro-type-cstylecast). [C26494 VAR_USE_BEFORE_INIT](c26494.md)\ -Variable '*variable*' is uninitialized. Always initialize an object. See [C++ Core Guidelines Type.5](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#SS-type). +Variable '*variable*' is uninitialized. Always initialize an object. See [C++ Core Guidelines Type.5](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Pro-type-init). [C26495 MEMBER_UNINIT](c26495.md)\ -Variable '*variable*' is uninitialized. Always initialize a member variable. See [C++ Core Guidelines Type.6](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#SS-type). +Variable '*variable*' is uninitialized. Always initialize a member variable. See [C++ Core Guidelines Type.6](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Pro-type-memberinit). ## BOUNDS Group [C26446 USE_GSL_AT](c26446.md)\ -Prefer to use `gsl::at()` instead of unchecked subscript operator. See [C++ Core Guidelines: Bounds.4: Don't use standard-library functions and types that are not bounds-checked](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#probounds-bounds-safety-profile). +Prefer to use `gsl::at()` instead of unchecked subscript operator. See [C++ Core Guidelines: Bounds.4: Don't use standard-library functions and types that are not bounds-checked](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Pro-bounds-stdlib). [C26481 NO_POINTER_ARITHMETIC](C26481.md)\ -Don't use pointer arithmetic. Use span instead. See [C++ Core Guidelines Bounds.1](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#SS-bounds) +Don't use pointer arithmetic. Use span instead. See [C++ Core Guidelines Bounds.1](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Pro-bounds-arithmetic) [C26482 NO_DYNAMIC_ARRAY_INDEXING](c26482.md)\ -Only index into arrays using constant expressions. See [C++ Core Guidelines Bounds.2](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#SS-bounds) +Only index into arrays using constant expressions. See [C++ Core Guidelines Bounds.2](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Pro-bounds-arrayindex) [C26483 STATIC_INDEX_OUT_OF_RANGE](c26483.md)\ -Value *value* is outside the bounds (0, *bound*) of variable '*variable*'. Only index into arrays using constant expressions that are within bounds of the array. See [C++ Core Guidelines Bounds.2](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#SS-bounds) +Value *value* is outside the bounds (0, *bound*) of variable '*variable*'. Only index into arrays using constant expressions that are within bounds of the array. See [C++ Core Guidelines Bounds.2](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Pro-bounds-arrayindex) [C26485 NO_ARRAY_TO_POINTER_DECAY](C26485.md)\ -Expression '*expr*': No array to pointer decay. See [C++ Core Guidelines Bounds.3](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#SS-bounds) +Expression '*expr*': No array to pointer decay. See [C++ Core Guidelines Bounds.3](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Pro-bounds-decay) ## GSL Group [C26445 NO_SPAN_REF](c26445.md)\ A reference to `gsl::span` or `std::string_view` may be an indication of a lifetime issue. -See [C++ Core Guidelines GSL.view: Views](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#gslview-views) +See [C++ Core Guidelines GSL.view: Views](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#SS-views) [C26446 USE_GSL_AT](c26446.md)\ -Prefer to use `gsl::at()` instead of unchecked subscript operator. See [C++ Core Guidelines: Bounds.4: Don't use standard-library functions and types that are not bounds-checked](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#probounds-bounds-safety-profile). +Prefer to use `gsl::at()` instead of unchecked subscript operator. See [C++ Core Guidelines: Bounds.4: Don't use standard-library functions and types that are not bounds-checked](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Pro-bounds-stdlib). [C26448 USE_GSL_FINALLY](c26448.md)\ -Consider using `gsl::finally` if final action is intended. See [C++ Core Guidelines: GSL.util: Utilities](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#SS-utilities). +Consider using `gsl::finally` if final action is intended. See [C++ Core Guidelines: GSL.util: Utilities](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#SS-utilities). [C26449 NO_SPAN_FROM_TEMPORARY](c26449.md)\ `gsl::span` or `std::string_view` created from a temporary will be invalid when the temporary is invalidated. See -[C++ Core Guidelines: GSL.view: Views](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#gslview-views). +[C++ Core Guidelines: GSL.view: Views](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#SS-views). ## Deprecated Warnings diff --git a/docs/code-quality/how-to-set-code-analysis-properties-for-c-cpp-projects.md b/docs/code-quality/how-to-set-code-analysis-properties-for-c-cpp-projects.md index cd25a57d26d..d4b1e95e891 100644 --- a/docs/code-quality/how-to-set-code-analysis-properties-for-c-cpp-projects.md +++ b/docs/code-quality/how-to-set-code-analysis-properties-for-c-cpp-projects.md @@ -2,7 +2,6 @@ description: "Learn more about: How to: Set Code Analysis Properties for C/C++ Projects" title: "How to: Set Code Analysis Properties for C/C++ Projects" ms.date: 11/04/2016 -ms.topic: "conceptual" f1_keywords: - "vs.codeanalysis.propertypages.native" - "VC.Project.VCCLCompilerTool.EnablePrefast" diff --git a/docs/code-quality/how-to-specify-additional-code-information-by-using-analysis-assume.md b/docs/code-quality/how-to-specify-additional-code-information-by-using-analysis-assume.md index cf2bac2dc35..16272c8e974 100644 --- a/docs/code-quality/how-to-specify-additional-code-information-by-using-analysis-assume.md +++ b/docs/code-quality/how-to-specify-additional-code-information-by-using-analysis-assume.md @@ -2,7 +2,6 @@ description: "Learn more about how to specify additional code information by using _Analysis_assume_." title: "Use _Analysis_assume_ for code analysis hints" ms.date: 12/16/2020 -ms.topic: "conceptual" f1_keywords: - "_Analysis_assume_" helpviewer_keywords: diff --git a/docs/code-quality/intrinsic-functions.md b/docs/code-quality/intrinsic-functions.md index 7b9d3a334cb..7a86f4a05c3 100644 --- a/docs/code-quality/intrinsic-functions.md +++ b/docs/code-quality/intrinsic-functions.md @@ -2,7 +2,7 @@ description: "Learn more about: Intrinsic Functions" title: Intrinsic Functions ms.date: 11/04/2016 -ms.topic: "conceptual" +ms.topic: "concept-article" f1_keywords: - "_String_length_" - "_Param_" diff --git a/docs/code-quality/quick-start-code-analysis-for-c-cpp.md b/docs/code-quality/quick-start-code-analysis-for-c-cpp.md index b54c5ce1d3d..1a8f22e7f2c 100644 --- a/docs/code-quality/quick-start-code-analysis-for-c-cpp.md +++ b/docs/code-quality/quick-start-code-analysis-for-c-cpp.md @@ -2,7 +2,7 @@ title: "Quickstart: Code analysis for C/C++" description: "Run static analysis on C++ code in Visual Studio to detect common coding problems and defects." ms.date: 04/08/2020 -ms.topic: "conceptual" +ms.topic: "quickstart" helpviewer_keywords: - "C/C++ code analysis" - "code analysis, C/C++" @@ -17,9 +17,9 @@ You can improve the quality of your application by running code analysis regular 1. Optionally, in the **Configuration** and **Platform** lists, choose the build configuration and target platform. -1. To run code analysis every time the project is built using the selected configuration, select the **Enable Code Analysis on Build** check box. You can also run code analysis manually by opening the **Analyze** menu and then choosing **Run Code Analysis on** *ProjectName* or **Run Code Analysis on File**. +1. To run code analysis every time the project is built using the selected configuration, select **Configuration Properties** > **Code Analysis**, then select the **Enable Code Analysis on Build** check box. You can also run code analysis manually by opening the **Analyze** menu and then choosing **Run Code Analysis on** *ProjectName* or **Run Code Analysis on File**. -1. Choose the [rule set](using-rule-sets-to-specify-the-cpp-rules-to-run.md) that you want to use or create a [custom rule set](using-rule-sets-to-specify-the-cpp-rules-to-run.md#to-create-a-rule-set-in-a-text-editor). If using LLVM/clang-cl, see [Using Clang-Tidy in Visual Studio](../code-quality/clang-tidy.md) to configure Clang-Tidy analysis options. +1. Choose the [rule set](using-rule-sets-to-specify-the-cpp-rules-to-run.md) that you want to use or create a [custom rule set](using-rule-sets-to-specify-the-cpp-rules-to-run.md#to-create-a-rule-set-in-a-text-editor). If using LLVM/clang-cl, see [Using Clang-Tidy in Visual Studio](clang-tidy.md) to configure Clang-Tidy analysis options. ### Standard C/C++ rule sets @@ -27,25 +27,25 @@ Visual Studio includes these standard sets of rules for native code: | Rule Set | Description | |--|--| -| **C++ Core Check Arithmetic Rules** | These rules enforce checks related to [arithmetic operations from the C++ Core Guidelines](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#es-expressions-and-statements). | -| **C++ Core Check Bounds Rules** | These rules enforce the [Bounds profile of the C++ Core Guidelines](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#probounds-bounds-safety-profile). | -| **C++ Core Check Class Rules** | These rules enforce checks related to [classes from the C++ Core Guidelines](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#c-classes-and-class-hierarchies). | -| **C++ Core Check Concurrency Rules** | These rules enforce checks related to [concurrency from the C++ Core Guidelines](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#cpcon-concurrency). | -| **C++ Core Check Const Rules** | These rules enforce [const-related checks from the C++ Core Guidelines](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#con-constants-and-immutability). | -| **C++ Core Check Declaration Rules** | These rules enforce checks related to [declarations from the C++ Core Guidelines](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#i-interfaces). | -| **C++ Core Check Enum Rules** | These rules enforce [enum-related checks from the C++ Core Guidelines](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#S-enum). | +| **C++ Core Check Arithmetic Rules** | These rules enforce checks related to [arithmetic operations from the C++ Core Guidelines](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#es-expressions-and-statements). | +| **C++ Core Check Bounds Rules** | These rules enforce the [Bounds profile of the C++ Core Guidelines](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#probounds-bounds-safety-profile). | +| **C++ Core Check Class Rules** | These rules enforce checks related to [classes from the C++ Core Guidelines](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#c-classes-and-class-hierarchies). | +| **C++ Core Check Concurrency Rules** | These rules enforce checks related to [concurrency from the C++ Core Guidelines](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#cpcon-concurrency). | +| **C++ Core Check Const Rules** | These rules enforce [const-related checks from the C++ Core Guidelines](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#con-constants-and-immutability). | +| **C++ Core Check Declaration Rules** | These rules enforce checks related to [declarations from the C++ Core Guidelines](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#i-interfaces). | +| **C++ Core Check Enum Rules** | These rules enforce [enum-related checks from the C++ Core Guidelines](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#S-enum). | | **C++ Core Check Experimental Rules** | These rules collect some experimental checks. Eventually, we expect these checks to be moved to other rulesets or removed completely. | -| **C++ Core Check Function Rules** | These rules enforce checks related to [functions from the C++ Core Guidelines](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#f-functions). | -| **C++ Core Check GSL Rules** | These rules enforce checks related to the [Guidelines Support Library from the C++ Core Guidelines](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#S-gsl). | -| **C++ Core Check Lifetime Rules** | These rules enforce the [Lifetime profile of the C++ Core Guidelines](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#prolifetime-lifetime-safety-profile). | -| **C++ Core Check Owner Pointer Rules** | These rules enforce resource-management checks related to [`owner` from the C++ Core Guidelines](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#r-resource-management). | -| **C++ Core Check Raw Pointer Rules** | These rules enforce resource-management checks related to [raw pointers from the C++ Core Guidelines](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#r-resource-management). | -| **C++ Core Check Rules** | These rules enforce a subset of the checks from the [C++ Core Guidelines](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#c-core-guidelines). Use this ruleset to include all of the C++ Core Check rules except the Enum and Experimental rulesets. | -| **C++ Core Check Shared Pointer Rules** | These rules enforce resource-management checks related to [types with shared pointer semantics from the C++ Core Guidelines](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#r-resource-management). | -| **C++ Core Check STL Rules** | These rules enforce checks related to the [C++ Standard Library from the C++ Core Guidelines](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#S-stdlib). | -| **C++ Core Check Style Rules** | These rules enforce checks related to use of [expressions and statements from the C++ Core Guidelines](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#es-expressions-and-statements). | -| **C++ Core Check Type Rules** | These rules enforce the [Type profile of the C++ Core Guidelines](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#prosafety-type-safety-profile). | -| **C++ Core Check Unique Pointer Rules** | These rules enforce resource-management checks related to types with [unique pointer semantics from the C++ Core Guidelines](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#r-resource-management). | +| **C++ Core Check Function Rules** | These rules enforce checks related to [functions from the C++ Core Guidelines](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#f-functions). | +| **C++ Core Check GSL Rules** | These rules enforce checks related to the [Guidelines Support Library from the C++ Core Guidelines](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#S-gsl). | +| **C++ Core Check Lifetime Rules** | These rules enforce the [Lifetime profile of the C++ Core Guidelines](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#prolifetime-lifetime-safety-profile). | +| **C++ Core Check Owner Pointer Rules** | These rules enforce resource-management checks related to [`owner` from the C++ Core Guidelines](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#r-resource-management). | +| **C++ Core Check Raw Pointer Rules** | These rules enforce resource-management checks related to [raw pointers from the C++ Core Guidelines](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#r-resource-management). | +| **C++ Core Check Rules** | These rules enforce a subset of the checks from the [C++ Core Guidelines](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#c-core-guidelines). Use this ruleset to include all of the C++ Core Check rules except the Enum and Experimental rulesets. | +| **C++ Core Check Shared Pointer Rules** | These rules enforce resource-management checks related to [types with shared pointer semantics from the C++ Core Guidelines](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#r-resource-management). | +| **C++ Core Check STL Rules** | These rules enforce checks related to the [C++ Standard Library from the C++ Core Guidelines](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#S-stdlib). | +| **C++ Core Check Style Rules** | These rules enforce checks related to use of [expressions and statements from the C++ Core Guidelines](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#es-expressions-and-statements). | +| **C++ Core Check Type Rules** | These rules enforce the [Type profile of the C++ Core Guidelines](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#prosafety-type-safety-profile). | +| **C++ Core Check Unique Pointer Rules** | These rules enforce resource-management checks related to types with [unique pointer semantics from the C++ Core Guidelines](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#r-resource-management). | | **Concurrency Check Rules** | These rules enforce a set of Win32 concurrency pattern checks in C++. | | **Concurrency Rules** | Adds concurrency rules from C++ Core Guidelines to **Concurrency Check Rules**. | | **Microsoft Native Minimum Rules** | These rules focus on the most critical problems in your native code, including potential security holes and application crashes. We recommend you include this rule set in any custom rule set you create for your native projects. | @@ -92,7 +92,7 @@ To run code analysis on a file: 1. In the **Build** menu, choose **Run Code Analysis on File** or press **Ctrl+Shift+Alt+F7**. - The project or solution is compiled and code analysis runs. Results appear in the Error List window. +The project or solution is compiled and code analysis runs. Results appear in the **Error List** window. ## Analyze and resolve code analysis warnings @@ -100,7 +100,7 @@ The Error List window lists the code analysis warnings found. The results are di For detailed information about the warning, including possible solutions to the issue, choose the warning ID in the Code column to display its corresponding online help article. -Double-click a warning to move the cursor to the line of code that caused the warning in the Visual Studio code editor. Or, press Enter on the selected warning. +Double-click a warning to move the cursor to the line of code that caused the warning in the code editor. Or, press Enter on the selected warning. After you understand the problem, you can resolve it in your code. Then, rerun code analysis to make sure that the warning no longer appears in the Error List. @@ -128,4 +128,4 @@ You can search long lists of warning messages and you can filter warnings in mul ## See also -- [Code analysis for C/C++](../code-quality/code-analysis-for-c-cpp-overview.md) +- [Code analysis for C/C++](code-analysis-for-c-cpp-overview.md) diff --git a/docs/code-quality/specifying-when-and-where-an-annotation-applies.md b/docs/code-quality/specifying-when-and-where-an-annotation-applies.md index d0849fc192a..f01e08d9919 100644 --- a/docs/code-quality/specifying-when-and-where-an-annotation-applies.md +++ b/docs/code-quality/specifying-when-and-where-an-annotation-applies.md @@ -2,7 +2,7 @@ description: "Learn more about: Specifying When and Where an Annotation Applies" title: Specifying When and Where an Annotation Applies ms.date: 11/04/2016 -ms.topic: "conceptual" +ms.topic: "concept-article" f1_keywords: - "_Group_" - "_At_" diff --git a/docs/code-quality/toc.yml b/docs/code-quality/toc.yml index 049d6ad6229..948d04dcb78 100644 --- a/docs/code-quality/toc.yml +++ b/docs/code-quality/toc.yml @@ -591,6 +591,10 @@ items: href: ../code-quality/c26117.md - name: Warning C26130 href: ../code-quality/c26130.md + - name: Warning C26132 + href: c26132.md + - name: Warning C26133 + href: c26133.md - name: Warning C26135 href: ../code-quality/c26135.md - name: Warning C26138 @@ -633,6 +637,10 @@ items: href: ../code-quality/c26830.md - name: Warning C26831 href: ../code-quality/c26831.md + - name: Warning C26838 + href: ../code-quality/c26838.md + - name: Warning C26839 + href: ../code-quality/c26839.md - name: Warning C26832 href: ../code-quality/c26832.md - name: Warning C26833 @@ -653,6 +661,8 @@ items: href: ../code-quality/c26863.md - name: Warning C26864 href: ../code-quality/c26864.md + - name: Warning C26865 + href: ../code-quality/c26865.md - name: Warning C28020 href: ../code-quality/c28020.md - name: Warning C28021 diff --git a/docs/code-quality/understanding-sal.md b/docs/code-quality/understanding-sal.md index 8669d1689b4..fea482553a1 100644 --- a/docs/code-quality/understanding-sal.md +++ b/docs/code-quality/understanding-sal.md @@ -1,9 +1,8 @@ --- -description: "Learn more about: Understanding SAL" title: Understanding SAL +description: "Learn more about: Understanding SAL" ms.date: 11/04/2016 -ms.topic: "conceptual" -ms.assetid: a94d6907-55f2-4874-9571-51d52d6edcfd +ms.topic: "concept-article" --- # Understanding SAL @@ -94,9 +93,9 @@ These annotations help identify possible uninitialized values and invalid null p This section shows code examples for the basic SAL annotations. -### Using the Visual Studio Code Analysis Tool to Find Defects +### Using the Visual Studio code analysis tool to find defects -In the examples, the Visual Studio Code Analysis tool is used together with SAL annotations to find code defects. Here's how to do that. +In the examples, the Visual Studio code analysis tool is used together with SAL annotations to find code defects. Here's how to do that. #### To use Visual Studio code analysis tools and SAL @@ -145,7 +144,7 @@ void BadInCaller() } ``` -If you use Visual Studio Code Analysis on this example, it validates that the callers pass a non-Null pointer to an initialized buffer for `pInt`. In this case, `pInt` pointer cannot be NULL. +If you use Visual Studio code analysis on this example, it validates that the callers pass a non-Null pointer to an initialized buffer for `pInt`. In this case, `pInt` pointer cannot be NULL. ### Example: The \_In\_opt\_ Annotation @@ -172,7 +171,7 @@ void InOptCaller() } ``` -Visual Studio Code Analysis validates that the function checks for NULL before it accesses the buffer. +Visual Studio code analysis validates that the function checks for NULL before it accesses the buffer. ### Example: The \_Out\_ Annotation @@ -198,7 +197,7 @@ void OutCaller() } ``` -Visual Studio Code Analysis Tool validates that the caller passes a non-NULL pointer to a buffer for `pInt` and that the buffer is initialized by the function before it returns. +Visual Studio code analysis validates that the caller passes a non-NULL pointer to a buffer for `pInt` and that the buffer is initialized by the function before it returns. ### Example: The \_Out\_opt\_ Annotation @@ -225,7 +224,7 @@ void OutOptCaller() } ``` -Visual Studio Code Analysis validates that this function checks for NULL before `pInt` is dereferenced, and if `pInt` is not NULL, that the buffer is initialized by the function before it returns. +Visual Studio code analysis validates that this function checks for NULL before `pInt` is dereferenced, and if `pInt` is not NULL, that the buffer is initialized by the function before it returns. ### Example: The \_Inout\_ Annotation @@ -256,7 +255,7 @@ void BadInOutCaller() } ``` -Visual Studio Code Analysis validates that callers pass a non-NULL pointer to an initialized buffer for `pInt`, and that, before return, `pInt` is still non-NULL and the buffer is initialized. +Visual Studio code analysis validates that callers pass a non-NULL pointer to an initialized buffer for `pInt`, and that, before return, `pInt` is still non-NULL and the buffer is initialized. ### Example: The \_Inout\_opt\_ Annotation @@ -285,7 +284,7 @@ void InOutOptCaller() } ``` -Visual Studio Code Analysis validates that this function checks for NULL before it accesses the buffer, and if `pInt` is not NULL, that the buffer is initialized by the function before it returns. +Visual Studio code analysis validates that this function checks for NULL before it accesses the buffer, and if `pInt` is not NULL, that the buffer is initialized by the function before it returns. ### Example: The \_Outptr\_ Annotation @@ -315,7 +314,7 @@ void OutPtrCaller() } ``` -Visual Studio Code Analysis validates that the caller passes a non-NULL pointer for `*pInt`, and that the buffer is initialized by the function before it returns. +Visual Studio code analysis validates that the caller passes a non-NULL pointer for `*pInt`, and that the buffer is initialized by the function before it returns. ### Example: The \_Outptr\_opt\_ Annotation @@ -347,7 +346,7 @@ void OutPtrOptCaller() } ``` -Visual Studio Code Analysis validates that this function checks for NULL before `*pInt` is dereferenced, and that the buffer is initialized by the function before it returns. +Visual Studio code analysis validates that this function checks for NULL before `*pInt` is dereferenced, and that the buffer is initialized by the function before it returns. ### Example: The \_Success\_ Annotation in Combination with \_Out\_ @@ -366,7 +365,7 @@ bool GetValue(_Out_ int *pInt, bool flag) } ``` -The `_Out_` annotation causes Visual Studio Code Analysis to validate that the caller passes a non-NULL pointer to a buffer for `pInt`, and that the buffer is initialized by the function before it returns. +The `_Out_` annotation causes Visual Studio code analysis to validate that the caller passes a non-NULL pointer to a buffer for `pInt`, and that the buffer is initialized by the function before it returns. ## SAL Best Practice @@ -384,7 +383,7 @@ Here are some guidelines: - Annotate value-range annotations so that Code Analysis can ensure buffer and pointer safety. -- Annotate locking rules and locking side effects. For more information, see [Annotating Locking Behavior](../code-quality/annotating-locking-behavior.md). +- Annotate locking rules and locking side effects. For more information, see [Annotating Locking Behavior](annotating-locking-behavior.md). - Annotate driver properties and other domain-specific properties. @@ -392,10 +391,10 @@ Or you can annotate all parameters to make your intent clear throughout and to m ## See also -- [Using SAL Annotations to Reduce C/C++ Code Defects](../code-quality/using-sal-annotations-to-reduce-c-cpp-code-defects.md) -- [Annotating Function Parameters and Return Values](../code-quality/annotating-function-parameters-and-return-values.md) -- [Annotating Function Behavior](../code-quality/annotating-function-behavior.md) -- [Annotating Structs and Classes](../code-quality/annotating-structs-and-classes.md) -- [Annotating Locking Behavior](../code-quality/annotating-locking-behavior.md) -- [Specifying When and Where an Annotation Applies](../code-quality/specifying-when-and-where-an-annotation-applies.md) -- [Best Practices and Examples](../code-quality/best-practices-and-examples-sal.md) +- [Using SAL Annotations to Reduce C/C++ Code Defects](using-sal-annotations-to-reduce-c-cpp-code-defects.md) +- [Annotating Function Parameters and Return Values](annotating-function-parameters-and-return-values.md) +- [Annotating Function Behavior](annotating-function-behavior.md) +- [Annotating Structs and Classes](annotating-structs-and-classes.md) +- [Annotating Locking Behavior](annotating-locking-behavior.md) +- [Specifying When and Where an Annotation Applies](specifying-when-and-where-an-annotation-applies.md) +- [Best Practices and Examples](best-practices-and-examples-sal.md) diff --git a/docs/code-quality/using-rule-sets-to-specify-the-cpp-rules-to-run.md b/docs/code-quality/using-rule-sets-to-specify-the-cpp-rules-to-run.md index 545b52d1840..a9884d1794c 100644 --- a/docs/code-quality/using-rule-sets-to-specify-the-cpp-rules-to-run.md +++ b/docs/code-quality/using-rule-sets-to-specify-the-cpp-rules-to-run.md @@ -1,8 +1,8 @@ --- +title: "Using Rule Sets to Specify the C++ Rules to Run" description: "Learn more about: Use Rule Sets to Specify the C++ Rules to Run" -title: Using Rule Sets to Specify the C++ Rules to Run ms.date: 07/27/2020 -ms.topic: "conceptual" +ms.topic: "how-to" f1_keywords: - "vs.codeanalysis.rulesets.native" --- @@ -243,7 +243,7 @@ Schema element details: | `TIncludeAll` | Rule action for all rules | | `TRule` | Rule ID with rule action | | `TRules` | Collection of one or more rules | -| `TRuleSet` | Ruleset file format consisting of localization information, rule hint paths, include all information, include information, rules information, name, description, and tools version information | +| `TRuleSet` | Ruleset file format consisting of localization information, rule hint paths, include all information, include information, rules information, name, description, and tools version information | | `TRuleAction` | Enumeration describing a rule action such as an error, warning, info, hidden, or none | | `TIncludeAction` | Enumeration describing a rule action such as an error, warning, info, hidden, none, or default | | `TIncludeAllAction` | Enumeration describing a rule action such as an error, warning, info, or hidden | diff --git a/docs/code-quality/using-sal-annotations-to-reduce-c-cpp-code-defects.md b/docs/code-quality/using-sal-annotations-to-reduce-c-cpp-code-defects.md index 80f88e1c27f..3426d695a2a 100644 --- a/docs/code-quality/using-sal-annotations-to-reduce-c-cpp-code-defects.md +++ b/docs/code-quality/using-sal-annotations-to-reduce-c-cpp-code-defects.md @@ -1,13 +1,12 @@ --- -description: "Learn more about: Using SAL Annotations to Reduce C/C++ Code Defects" title: Using SAL Annotations to Reduce C/C++ Code Defects +description: "Learn more about: Using SAL Annotations to Reduce C/C++ Code Defects" ms.date: 11/04/2016 -ms.topic: "conceptual" +ms.topic: "concept-article" helpviewer_keywords: - "annotations" - "SAL annotations" - "code analysis, annotation" -ms.assetid: a16e47d0-6f3e-4ed6-8883-459b2874e9a4 --- # Using SAL Annotations to Reduce C/C++ Code Defects @@ -47,6 +46,6 @@ The articles in this section of the documentation discuss aspects of SAL, provid Provides examples that show how to use SAL annotations. Also explains common pitfalls. -## See Also +## See also [SAL 2.0 Annotations for Windows Drivers](/windows-hardware/drivers/devtest/sal-2-annotations-for-windows-drivers) diff --git a/docs/code-quality/using-the-cpp-core-guidelines-checkers.md b/docs/code-quality/using-the-cpp-core-guidelines-checkers.md index 3609f413acc..34cdcc545ff 100644 --- a/docs/code-quality/using-the-cpp-core-guidelines-checkers.md +++ b/docs/code-quality/using-the-cpp-core-guidelines-checkers.md @@ -2,13 +2,13 @@ title: Using the C++ Core Guidelines checkers description: "How to set up and use the Microsoft C++ Code Analysis rules for C++ Core Guidelines." ms.date: 06/21/2023 -ms.topic: "conceptual" +ms.topic: "how-to" dev_langs: - CPP --- # Use the C++ Core Guidelines checkers -The C++ Core Guidelines are a portable set of guidelines, rules, and best practices about coding in C++ created by C++ experts and designers. Visual Studio currently supports a subset of these rules as part of its code analysis tools for C++. The core guideline checkers are installed by default in Visual Studio 2017 and Visual Studio 2019. They're [available as a NuGet package for Visual Studio 2015](#vs2015_corecheck). +The C++ Core Guidelines are a portable set of guidelines, rules, and best practices about coding in C++ created by C++ experts and designers. Visual Studio currently supports a subset of these rules as part of its Microsoft C++ Code Analysis tools. The core guideline checkers are installed by default in Visual Studio 2017 and Visual Studio 2019. They're [available as a NuGet package for Visual Studio 2015](#vs2015_corecheck). ## The C++ Core Guidelines Project @@ -39,7 +39,7 @@ To enable more Core Check rules, open the dropdown list and choose which rule se A subset of C++ Core Check rules is included in the Microsoft Native Recommended rule set. It's the ruleset that runs by default when Microsoft code analysis is enabled. -### To enable code analysis on your project: +### To enable code analysis on your project 1. Open the **Property Pages** dialog for your project. @@ -74,7 +74,7 @@ int main() int arr[10]; // warning C26494 int* p = arr; // warning C26485 - [[gsl::suppress(bounds.1)]] // This attribute suppresses Bounds rule #1 + [[gsl::suppress("bounds.1", justification : "This attribute suppresses Bounds rules #1")]] { int* q = p + 1; // warning C26481 (suppressed) p = q++; // warning C26481 (suppressed) @@ -104,50 +104,50 @@ c:\users\username\documents\visual studio 2015\projects\corecheckexample\coreche ========== Build: 1 succeeded, 0 failed, 0 up-to-date, 0 skipped ========== ``` -The C++ Core Guidelines are there to help you write better and safer code. However, you might find an instance where a rule or a profile shouldn't be applied. It's easy to suppress it directly in the code. You can use the `[[gsl::suppress]]` attribute to keep C++ Core Check from detecting and reporting any violation of a rule in the following code block. You can mark individual statements to suppress specific rules. You can even suppress the entire bounds profile by writing `[[gsl::suppress(bounds)]]` without including a specific rule number. +The C++ Core Guidelines are there to help you write better and safer code. However, you might find an instance where a rule or a profile shouldn't be applied. It's easy to suppress it directly in the code. You can use the `[[gsl::suppress]]` attribute to keep C++ Core Check from detecting and reporting any violation of a rule in the following code block. You can mark individual statements to suppress specific rules. You can even suppress the entire bounds profile by writing `[[gsl::suppress("bounds")]]` without including a specific rule number. ## Supported rule sets As new rules are added to the C++ Core Guidelines Checker, the number of warnings that are produced for pre-existing code might increase. You can use predefined rule sets to filter which kinds of rules to enable. You'll find reference articles for most rules under [Visual Studio C++ Core Check Reference](code-analysis-for-cpp-corecheck.md). -- **Arithmetic Rules**: Rules to detect arithmetic [overflow](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#Res-overflow), [signed-unsigned operations](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#Res-unsigned), and [bit manipulation](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#Res-nonnegative).15.6 +- **Arithmetic Rules**: Rules to detect arithmetic [overflow](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Res-overflow), [signed-unsigned operations](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Res-unsigned), and [bit manipulation](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Res-nonnegative).15.6 -- **Bounds Rules**: Enforce the [Bounds profile of the C++ Core Guidelines](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#probounds-bounds-safety-profile).15.3 +- **Bounds Rules**: Enforce the [Bounds profile of the C++ Core Guidelines](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#probounds-bounds-safety-profile).15.3 -- **Class Rules**: A few rules that focus on proper use of special member functions and virtual specifications. They're a subset of the checks recommended for [classes and class hierarchies](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#S-class).15.5 +- **Class Rules**: A few rules that focus on proper use of special member functions and virtual specifications. They're a subset of the checks recommended for [classes and class hierarchies](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#S-class).15.5 -- **Concurrency Rules**: A single rule, which catches bad guard object declarations. For more information, see [guidelines related to concurrency](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#S-concurrency).15.5 +- **Concurrency Rules**: A single rule, which catches bad guard object declarations. For more information, see [guidelines related to concurrency](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#S-concurrency).15.5 -- **Const Rules**: Enforce [const-related checks from the C++ Core Guidelines](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#con-constants-and-immutability).15.3 +- **Const Rules**: Enforce [const-related checks from the C++ Core Guidelines](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#con-constants-and-immutability).15.3 -- **Declaration Rules**: A couple of rules from the [interfaces guidelines](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#S-interfaces) that focus on how global variables are declared.15.5 +- **Declaration Rules**: A couple of rules from the [interfaces guidelines](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#S-interfaces) that focus on how global variables are declared.15.5 -- **Enum Rules**: These rules enforce [enum-related checks from the C++ Core Guidelines](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#S-enum).16.3 +- **Enum Rules**: These rules enforce [enum-related checks from the C++ Core Guidelines](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#S-enum).16.3 - **Experimental Rules** These are experimental C++ Core Check rules that are useful but not ready for everyday use. Try them out and [provide feedback](https://aka.ms/feedback/suggest?space=62).16.0 -- **Function Rules**: Two checks that help with adoption of the **`noexcept`** specifier. They're part of the guidelines for [clear function design and implementation](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#S-functions).15.5 +- **Function Rules**: Two checks that help with adoption of the **`noexcept`** specifier. They're part of the guidelines for [clear function design and implementation](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#S-functions).15.5 -- **GSL Rules**: These rules enforce checks related to the [Guidelines Support Library from the C++ Core Guidelines](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#S-gsl).15.7 +- **GSL Rules**: These rules enforce checks related to the [Guidelines Support Library from the C++ Core Guidelines](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#S-gsl).15.7 -- **Lifetime Rules**: These rules enforce the [Lifetime profile of the C++ Core Guidelines](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#prolifetime-lifetime-safety-profile).15.7 +- **Lifetime Rules**: These rules enforce the [Lifetime profile of the C++ Core Guidelines](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#prolifetime-lifetime-safety-profile).15.7 -- **Owner Pointer Rules**: Enforce [resource-management checks related to owner\ from the C++ Core Guidelines](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#r-resource-management).15.3 +- **Owner Pointer Rules**: Enforce [resource-management checks related to owner\ from the C++ Core Guidelines](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#r-resource-management).15.3 -- **Raw Pointer Rules**: Enforce [resource-management checks related to raw pointers from the C++ Core Guidelines](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#r-resource-management).15.3 +- **Raw Pointer Rules**: Enforce [resource-management checks related to raw pointers from the C++ Core Guidelines](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#r-resource-management).15.3 -- **Shared pointer Rules**: It's part of [resource management](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#S-resource) guidelines enforcement.15.5 We added a few rules specific to how shared pointers are passed into functions or used locally. +- **Shared pointer Rules**: It's part of [resource management](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#S-resource) guidelines enforcement.15.5 We added a few rules specific to how shared pointers are passed into functions or used locally. -- **STL Rules**: These rules enforce checks related to the [C++ Standard Library (STL) from the C++ Core Guidelines](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#S-stdlib).15.7 +- **STL Rules**: These rules enforce checks related to the [C++ Standard Library (STL) from the C++ Core Guidelines](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#S-stdlib).15.7 -- **Style Rules**: One simple but important check, which bans use of [goto](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#Res-goto).15.5 It's the first step to improve your coding style and use of expressions and statements in C++. +- **Style Rules**: One simple but important check, which bans use of [goto](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Res-goto).15.5 It's the first step to improve your coding style and use of expressions and statements in C++. -- **Type Rules**: Enforce the [Type profile of the C++ Core Guidelines](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#prosafety-type-safety-profile).15.3 +- **Type Rules**: Enforce the [Type profile of the C++ Core Guidelines](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#prosafety-type-safety-profile).15.3 -- **Unique Pointer Rules**: Enforce [resource-management checks related to types with unique pointer semantics from the C++ Core Guidelines](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#r-resource-management).15.3 +- **Unique Pointer Rules**: Enforce [resource-management checks related to types with unique pointer semantics from the C++ Core Guidelines](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#r-resource-management).15.3 -- **C++ Core Check Rules**: This rule set contains all the currently implemented checks from the [C++ Core Guidelines](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#c-core-guidelines), except for the Experimental rules. +- **C++ Core Check Rules**: This rule set contains all the currently implemented checks from the [C++ Core Guidelines](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#c-core-guidelines), except for the Experimental rules. 15.3 These rules first appeared in Visual Studio 2017 version 15.3\ 15.5 These rules first appeared in Visual Studio 2017 version 15.5\ @@ -197,10 +197,10 @@ The Microsoft C++ compiler has limited support for the `[[gsl::suppress]]` attri ```cpp // Suppress only warnings from the 'r.11' rule in expression. -[[gsl::suppress(r.11)]] new int; +[[gsl::suppress("r.11")]] new int; // Suppress all warnings from the 'r' rule group (resource management) in block. -[[gsl::suppress(r)]] +[[gsl::suppress("r")]] { new int; } @@ -209,7 +209,7 @@ The Microsoft C++ compiler has limited support for the `[[gsl::suppress]]` attri // For declarations, you might need to use the surrounding block. // Macros are not expanded inside of attributes. // Use plain numbers instead of macros from the warnings.h. -[[gsl::suppress(26400)]] +[[gsl::suppress("26400")]] { int *p = new int; } @@ -305,7 +305,7 @@ The Guideline Support Library (GSL) is designed to help you follow the Core Guid ## Use the C++ Core Check guidelines in Visual Studio 2015 projects -If you use Visual Studio 2015, the C++ Core Check code analysis rule sets aren't installed by default. Other steps are needed before you can enable the C++ Core Check code analysis tools in Visual Studio 2015. Microsoft provides support for Visual Studio 2015 projects by using a NuGet package. The package is named Microsoft.CppCoreCheck, and it's available at [http://www.nuget.org/packages/Microsoft.CppCoreCheck](https://www.nuget.org/packages/Microsoft.CppCoreCheck). This package requires you have at least Visual Studio 2015 with Update 1 installed. +If you use Visual Studio 2015, the C++ Core Check code analysis rule sets aren't installed by default. Other steps are needed before you can enable the C++ Core Check code analysis tools in Visual Studio 2015. Microsoft provides support for Visual Studio 2015 projects by using a NuGet package. The package is named Microsoft.CppCoreCheck, and it's available at [https://www.nuget.org/packages/Microsoft.CppCoreCheck](https://www.nuget.org/packages/Microsoft.CppCoreCheck). This package requires you have at least Visual Studio 2015 with Update 1 installed. The package also installs another package as a dependency, the header-only Guideline Support Library (GSL). The GSL is also available on GitHub at [https://github.com/Microsoft/GSL](https://github.com/Microsoft/GSL). @@ -317,11 +317,11 @@ Because of the way the code analysis rules get loaded within Visual Studio 2015, 1. In the **NuGet Package Manager** window, search for Microsoft.CppCoreCheck. - ![Nuget Package Manager window showing the CppCoreCheck package.](../code-quality/media/cppcorecheck_nuget_window.png) + ![Nuget Package Manager window showing the CppCoreCheck package.](media/cppcorecheck_nuget_window.png) 1. Select the Microsoft.CppCoreCheck package and then choose the **Install** button to add the rules to your project. - The NuGet package adds an MSBuild *`.targets`* file to your project that is invoked when you enable code analysis on your project. The *`.targets`* file adds the C++ Core Check rules as another extension to the Visual Studio Code analysis tool. When the package is installed, you can use the Property Pages dialog to enable or disable the released and experimental rules. + The NuGet package adds an MSBuild *`.targets`* file to your project that is invoked when you enable code analysis on your project. The *`.targets`* file adds the C++ Core Check rules as another extension to the Visual Studio code analysis tool. When the package is installed, you can use the Property Pages dialog to enable or disable the released and experimental rules. ::: moniker-end diff --git a/docs/code-quality/walkthrough-analyzing-c-cpp-code-for-defects.md b/docs/code-quality/walkthrough-analyzing-c-cpp-code-for-defects.md index 0332306aa55..384584b365a 100644 --- a/docs/code-quality/walkthrough-analyzing-c-cpp-code-for-defects.md +++ b/docs/code-quality/walkthrough-analyzing-c-cpp-code-for-defects.md @@ -2,7 +2,7 @@ title: "Walkthrough: Analyzing C/C++ code for defects" description: "Demonstrates how to use code analysis with Microsoft C++ in Visual Studio." ms.date: 04/14/2020 -ms.topic: "conceptual" +ms.topic: "concept-article" helpviewer_keywords: ["C/C++, code analysis", "code analysis, walkthroughs", "code, analyzing C/C++", "code analysis tool, walkthroughs"] --- # Walkthrough: Analyzing C/C++ code for defects diff --git a/docs/cpp/align-cpp.md b/docs/cpp/align-cpp.md index 480640779f9..939c0edb165 100644 --- a/docs/cpp/align-cpp.md +++ b/docs/cpp/align-cpp.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: align (C++)" title: "align (C++)" -ms.date: "12/17/2018" +description: "Learn more about: align (C++)" +ms.date: 12/17/2018 f1_keywords: ["align_cpp"] helpviewer_keywords: ["align __declspec keyword", "__declspec keyword [C++], align"] --- diff --git a/docs/cpp/alignof-operator.md b/docs/cpp/alignof-operator.md index 85de3668703..a30d84fe45d 100644 --- a/docs/cpp/alignof-operator.md +++ b/docs/cpp/alignof-operator.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: alignof Operator" title: "alignof Operator" -ms.date: "12/17/2018" +description: "Learn more about: alignof Operator" +ms.date: 12/17/2018 f1_keywords: ["__alignof_cpp", "alignof_cpp", "__alignof", "_alignof"] helpviewer_keywords: ["alignas [C++]", "alignment of structures", "__alignof keyword [C++]", "alignof [C++]", "types [C++], alignment requirements"] --- diff --git a/docs/cpp/anonymous-class-types.md b/docs/cpp/anonymous-class-types.md index 591f8492676..2e26ebc728b 100644 --- a/docs/cpp/anonymous-class-types.md +++ b/docs/cpp/anonymous-class-types.md @@ -1,9 +1,8 @@ --- -description: "Learn more about: Anonymous Class Types" title: "Anonymous Class Types" -ms.date: "11/04/2016" +description: "Learn more about: Anonymous Class Types" +ms.date: 11/04/2016 helpviewer_keywords: ["class types [C++], anonymous", "anonymous class types"] -ms.assetid: 9ba667b2-8c2a-4c29-82a6-fa120b9233c8 --- # Anonymous Class Types @@ -42,7 +41,7 @@ In the preceding code, `iValue` can be accessed using the object member-selectio int i = ptv.iValue; ``` -Anonymous classes are subject to certain restrictions. (For more information about anonymous unions, see [Unions](../cpp/unions.md).) Anonymous classes: +Anonymous classes are subject to certain restrictions. For more information about anonymous unions, see [Unions](../cpp/unions.md). Anonymous classes: - Cannot have a constructor or destructor. diff --git a/docs/cpp/argument-passing-and-naming-conventions.md b/docs/cpp/argument-passing-and-naming-conventions.md index b7ec0825474..11dfa80a2e9 100644 --- a/docs/cpp/argument-passing-and-naming-conventions.md +++ b/docs/cpp/argument-passing-and-naming-conventions.md @@ -1,9 +1,8 @@ --- -description: "Learn more about: Argument Passing and Naming Conventions" title: "Argument Passing and Naming Conventions" -ms.date: "12/17/2018" +description: "Learn more about: Argument Passing and Naming Conventions" +ms.date: 12/17/2018 helpviewer_keywords: ["argument passing [C++], conventions", "arguments [C++], widening", "coding conventions, arguments", "arguments [C++], passing", "registers, return values", "thiscall keyword [C++]", "naming conventions [C++], arguments", "arguments [C++], naming", "passing arguments [C++], conventions", "conventions [C++], argument names"] -ms.assetid: de468979-eab8-4158-90c5-c198932f93b9 --- # Argument Passing and Naming Conventions @@ -32,6 +31,7 @@ The following calling conventions are supported by the Visual C/C++ compiler. |[__fastcall](../cpp/fastcall.md)|Callee|Stored in registers, then pushed on stack| |[__thiscall](../cpp/thiscall.md)|Callee|Pushed on stack; **`this`** pointer stored in ECX| |[__vectorcall](../cpp/vectorcall.md)|Callee|Stored in registers, then pushed on stack in reverse order (right to left)| +|[__preserve_none](../cpp/preserve-none.md)|Callee|Stored in registers only| For related information, see [Obsolete Calling Conventions](../cpp/obsolete-calling-conventions.md). diff --git a/docs/cpp/arrays-cpp.md b/docs/cpp/arrays-cpp.md index e32eaab9fa1..48563141ee0 100644 --- a/docs/cpp/arrays-cpp.md +++ b/docs/cpp/arrays-cpp.md @@ -161,10 +161,9 @@ int i2[5][7]; It specifies an array of type **`int`**, conceptually arranged in a two-dimensional matrix of five rows and seven columns, as shown in the following figure: -:::image type="content" source="../cpp/media/vc38rc1.gif" alt-text="Conceptual layout of a multidimensional array."::: - +:::image type="complex" source="../cpp/media/vc38rc1.gif" alt-text="Conceptual layout of a multidimensional array."::: The image is a grid 7 cells wide and 5 cells high. Each cell contains the index of the cell. The first cell index is labeled 0,0. The next cell in that row is 0,1 and so on to the last cell in that row which is 0,6. The next row starts with the index 1,0. The cell after that has an index of 1,1. The last cell in that row is 1,6. This pattern repeats until the last row, which starts with the index 4,0. The last cell in the last row has an index of 4,6. -:::image-end +:::image-end::: You can declare multidimensioned arrays that have an initializer list (as described in [Initializers](../cpp/initializers.md)). In these declarations, the constant expression that specifies the bounds for the first dimension can be omitted. For example: diff --git a/docs/cpp/attributes.md b/docs/cpp/attributes.md index 961f2945bb9..9a45ef04e6f 100644 --- a/docs/cpp/attributes.md +++ b/docs/cpp/attributes.md @@ -1,9 +1,9 @@ --- -description: "Learn more about: Attributes in C++" title: "Attributes in C++" -f1_keywords: ["deprecated", "no_return", "carries_dependency", "fallthrough", "nodiscard", "maybe_unused", "likely", "unlikely", "gsl::suppress", "msvc::intrinsic", "msvc::no_tls_guard"] -helpviewer_keywords: ["deprecated", "no_return", "carries_dependency", "fallthrough", "nodiscard", "maybe_unused", "likely", "unlikely", "gsl::suppress", "msvc::intrinsic", "msvc::no_tls_guard"] -ms.date: 4/13/2023 +description: "Learn more about: Attributes in C++" +f1_keywords: ["deprecated", "noreturn", "carries_dependency", "fallthrough", "nodiscard", "maybe_unused", "likely", "unlikely", "gsl::suppress", "msvc::flatten", "msvc::forceinline", "msvc::forceinline_calls", "msvc::intrinsic", "msvc::noinline", "msvc::noinline_calls", "msvc::no_tls_guard", "msvc::musttail"] +helpviewer_keywords: ["deprecated", "noreturn", "carries_dependency", "fallthrough", "nodiscard", "maybe_unused", "likely", "unlikely", "gsl::suppress", "msvc::flatten", "msvc::forceinline", "msvc::forceinline_calls", "msvc::intrinsic", "msvc::noinline", "msvc::noinline_calls", "msvc::no_tls_guard", "msvc::musttail"] +ms.date: 12/9/2025 --- # Attributes in C++ @@ -77,16 +77,18 @@ The `[[noreturn]]` attribute specifies that a function never returns; in other w ## Microsoft-specific attributes -### `[[gsl::suppress(rules)]]` +### `[[gsl::suppress( [, justification: ])]]` -The Microsoft-specific `[[gsl::suppress(rules)]]` attribute is used to suppress warnings from checkers that enforce [Guidelines Support Library (GSL)](https://github.com/Microsoft/GSL) rules in code. For example, consider this code snippet: +`` is a string that specifies the name of the rule to suppress. The optional `justification` field allows you to explain why a warning is being disabled or suppressed. This value will appear in the SARIF output when the `/analyze:log:includesuppressed` option is specified. Its value is a UTF-8 encoded narrow string literal. The `[[gsl::suppress]]` attribute is available in Visual Studio 2022 version 17.14 and later versions. + +The Microsoft-specific `[[gsl::suppress]]` attribute is used to suppress warnings from checkers that enforce [Guidelines Support Library (GSL)](https://github.com/Microsoft/GSL) rules in code. For example, consider this code snippet: ```cpp int main() { int arr[10]; // GSL warning C26494 will be fired int* p = arr; // GSL warning C26485 will be fired - [[gsl::suppress(bounds.1)]] // This attribute suppresses Bounds rule #1 + [[gsl::suppress("bounds.1", justification: "This attribute suppresses Bounds rule #1")]] { int* q = p + 1; // GSL warning C26481 suppressed p = q--; // GSL warning C26481 suppressed @@ -102,7 +104,7 @@ The example raises these warnings: - [C26481](../code-quality/c26481.md) (Bounds Rule 1: Don't use pointer arithmetic. Use span instead.) -The first two warnings fire when you compile this code with the CppCoreCheck code analysis tool installed and activated. But the third warning doesn't fire because of the attribute. You can suppress the entire bounds profile by writing `[[gsl::suppress(bounds)]]` without including a specific rule number. The C++ Core Guidelines are designed to help you write better and safer code. The suppress attribute makes it easy to turn off the warnings when they aren't wanted. +The first two warnings fire when you compile this code with the CppCoreCheck code analysis tool installed and activated. But the third warning doesn't fire because of the attribute. You can suppress the entire bounds profile by writing `[[gsl::suppress("bounds")]]` without including a specific rule number. The C++ Core Guidelines are designed to help you write better and safer code. The suppress attribute makes it easy to turn off the warnings when they aren't wanted. ### `[[msvc::flatten]]` @@ -157,6 +159,56 @@ void f() { } ``` +### `[[msvc::musttail]]` + +The `[[msvc::musttail]]` attribute, introduced in [MSVC Build Tools version 14.50](../overview/what-s-new-for-msvc.md#whats-new-for-msvc-build-tools-version-1450), is an experimental x64-only Microsoft-specific attribute that enforces tail-call optimization. When applied to a qualifying return statement, it instructs the compiler to emit the call as a tail call. If the compiler can't emit the tail call, it produces a compilation error. The `[[msvc::musttail]]` attribute enforces a tail call instead of inlining the function. + +`[[msvc::musttail]]` requirements: +- The caller and callee must have matching return types. +- The calling conventions must be compatible. +- The tail call must be the final action in the calling function. +- The callee can't use more stack space than the calling function. +- If more than four integer parameters are passed, the calling function must allocate enough stack space for those additional arguments. +- Compile with `/O2` or `/O2 /GL` optimization level. + +#### Example + +Tail calls are a compiler optimization that is possible when a function call is the last action performed before returning. Instead of creating a new stack frame to call the function, the current function's stack frame is reused. This reduces stack usage and improves performance—especially in recursive scenarios. + +In the following code, the `[[msvc::musttail]]` attribute applied to `return increment(x)` causes control to transfer directly to `increment`. When `increment` reaches the `return x+1;` statement, its result is provided directly to the caller of `incrementIfPositive`, that is `main`. This replaces inlining `increment` into `incrementIfPositive` or calling `increment` from `incrementIfPositive` and returning to `incrementIfPositive` before returning to `main`. The tail call optimization eliminates the need for `incrementIfPositive` to regain control after `increment` finishes. This is a performance optimization that reduces stack usage, especially useful in recursive scenarios. + +```cpp +// compile with /O2 +#include + +int increment(int x) +{ + return x + 1; +} + +int incrementIfPositive(int x) +{ + if (x > 0) + { + [[msvc::musttail]] + return increment(x); + } + return -1; +} + +int main() +{ + int result = incrementIfPositive(42); + if (result < 0) + { + return -1; + } + + std::cout << result; // outputs 43 + return 0; +} +``` + ### `[[msvc::noinline]]` When placed before a function declaration, the Microsoft-specific attribute `[[msvc::noinline]]` has the same meaning as `__declspec(noinline)`. diff --git a/docs/cpp/basic-concepts-cpp.md b/docs/cpp/basic-concepts-cpp.md index 7102a6a9f74..a60b27fef42 100644 --- a/docs/cpp/basic-concepts-cpp.md +++ b/docs/cpp/basic-concepts-cpp.md @@ -1,12 +1,11 @@ --- -description: "Learn more about: Basic Concepts (C++)" -title: "Basic Concepts (C++)" +title: "Basic Concepts (C++)" +description: "Learn more about: Basic Concepts (C++)" ms.custom: "index-page" -ms.date: "12/11/2019" +ms.date: 12/11/2019 helpviewer_keywords: ["C++, basic language concepts"] -ms.assetid: 961801e6-2ffd-4bf1-bb71-7f55e48d9c79 --- -# Basic Concepts (C++) +# Basic Concepts (C++) This section explains concepts that are critical to understanding C++. C programmers will be familiar with many of these concepts, but there are some subtle differences that can cause unexpected program results. The following topics are included: diff --git a/docs/cpp/bstr-t-assign.md b/docs/cpp/bstr-t-assign.md index 565b248630a..801be55d0ab 100644 --- a/docs/cpp/bstr-t-assign.md +++ b/docs/cpp/bstr-t-assign.md @@ -1,11 +1,11 @@ --- -description: "Learn more about: _bstr_t::Assign" title: "_bstr_t::Assign" +description: "Learn more about: _bstr_t::Assign" ms.date: 02/02/2021 f1_keywords: ["_bstr_t::Assign"] helpviewer_keywords: ["Assign method [C++]"] --- -# _`bstr_t::Assign` +# `_bstr_t::Assign` **Microsoft Specific** diff --git a/docs/cpp/c-cpp-language-and-standard-libraries.md b/docs/cpp/c-cpp-language-and-standard-libraries.md index 69a5e4afc8a..59218ff5e3e 100644 --- a/docs/cpp/c-cpp-language-and-standard-libraries.md +++ b/docs/cpp/c-cpp-language-and-standard-libraries.md @@ -1,6 +1,6 @@ --- -description: "Learn more about: C/C++ language and standard libraries reference" title: "C/C++ language and standard libraries reference" +description: "Learn more about: C/C++ language and standard libraries reference" ms.date: 09/11/2024 ms.topic: "overview" ms.custom: intro-overview @@ -16,7 +16,7 @@ You'll also find documentation for the C runtime library, the C++ standard libra [C language](../c-language/c-language-reference.md)\ Reference content for the Microsoft implementation of the C language. -[C++ language](../cpp/cpp-language-reference.md)\ +[C++ language](cpp-language-reference.md)\ Reference content for the Microsoft implementation of the C++ language. [C/C++ preprocessor](../preprocessor/c-cpp-preprocessor-reference.md)\ @@ -66,7 +66,7 @@ A header-only C++20 library for using polymorphism in C++ without inheritance. F [SafeInt library](../safeint/safeint-library.md)\ A portable library that can be used with MSVC, GCC, or Clang to help prevent integer overflows. -[Data Access Libraries](../data/data-access-in-cpp.md) +[Data Access Libraries](../data/data-access-in-cpp.md)\ Libraries to support data access using ATL or MFC, and legacy services such as OLE DB and ODBC. ## Related articles diff --git a/docs/cpp/casting.md b/docs/cpp/casting.md index 17830ed970d..1a74c493987 100644 --- a/docs/cpp/casting.md +++ b/docs/cpp/casting.md @@ -1,6 +1,6 @@ --- -description: "Learn more about: Casting in C++" title: "Casting" +description: "Learn more about: Casting in C++" ms.date: 6/11/2024 helpviewer_keywords: ["casting [C++]", "coercion [C++]", "virtual functions [C++], in derived classes [C++]", "static cast operator", "dynamic cast operator", "polymorphic classes [C++]", "classes [C++], polymorphism"] ai-usage: ai-assisted @@ -9,21 +9,21 @@ ai-usage: ai-assisted In C++, if a class is derived from a base class containing one or more virtual functions, a pointer to that base class type can be used to call virtual functions in the derived class object. A class containing virtual functions is sometimes called a "polymorphic class." -![Diagram of a class hierarchy where C derives from B, which derives from A.](../cpp/media/vc38zz1.gif "Class hierarchy")
+![Diagram of a class hierarchy where C derives from B, which derives from A.](media/vc38zz1.gif "Class hierarchy")\ Class hierarchy An object of type `C` can be visualized as follows: -![Diagram of Class C with subobjects B and A.](../cpp/media/vc38zz2.gif "Class C with subobjects B and A")
+![Diagram of Class C with subobjects B and A.](media/vc38zz2.gif "Class C with subobjects B and A")\ Class C with subobjects B and A Given an instance of class `C`, there's a `B` subobject and an `A` subobject. The instance of `C`, including the `A` and `B` subobjects, is the "complete object." Because a derived class completely contains the definitions of all the base classes from which it's derived, it's safe to cast a pointer to any of its base classes (also called an upcast). Given a pointer to a base class, it may be safe to cast the pointer to an instance of a derived class (also called a downcast). -Using run-time type information, it's possible to check whether a pointer actually points to a complete object and can be safely cast to point to another object in its hierarchy. The [dynamic_cast](../cpp/dynamic-cast-operator.md) operator performs a run-time check to ensure that the operation is safe. It's better to design your class hierarchy so that you can use virtual functions to avoid the need for downcasting. However, if you must downcast, use `dynamic_cast` to ensure that the operation is safe. +Using run-time type information, it's possible to check whether a pointer actually points to a complete object and can be safely cast to point to another object in its hierarchy. The [dynamic_cast](dynamic-cast-operator.md) operator performs a run-time check to ensure that the operation is safe. It's better to design your class hierarchy so that you can use virtual functions to avoid the need for downcasting. However, if you must downcast, use `dynamic_cast` to ensure that the operation is safe. -For conversion of nonpolymorphic types, you can use the [static_cast](../cpp/static-cast-operator.md) operator (this topic explains the difference between static and dynamic casting conversions, and when it's appropriate to use each). +For conversion of nonpolymorphic types, you can use the [static_cast](static-cast-operator.md) operator (this topic explains the difference between static and dynamic casting conversions, and when it's appropriate to use each). The following example demonstrates the use of `dynamic_cast` and `static_cast`: @@ -72,9 +72,9 @@ int main() { This section covers the following topics: -- [Casting operators](../cpp/casting-operators.md)\ -- [Run-time type information](../cpp/run-time-type-information.md) +- [Casting operators](casting-operators.md) +- [Run-time type information](run-time-type-information.md) ## See also -[Expressions](../cpp/expressions-cpp.md) +[Expressions](expressions-cpp.md) diff --git a/docs/cpp/char-wchar-t-char16-t-char32-t.md b/docs/cpp/char-wchar-t-char16-t-char32-t.md index 5df11da2668..4a4e7703852 100644 --- a/docs/cpp/char-wchar-t-char16-t-char32-t.md +++ b/docs/cpp/char-wchar-t-char16-t-char32-t.md @@ -1,6 +1,6 @@ --- -description: "Learn more about: char, wchar_t, char8_t, char16_t, char32_t" title: "char, wchar_t, char8_t, char16_t, char32_t" +description: "Learn more about: char, wchar_t, char8_t, char16_t, char32_t" ms.date: 04/23/2021 --- # char, wchar_t, char8_t, char16_t, char32_t @@ -26,6 +26,6 @@ The **`wchar_t`** type is an implementation-defined wide character type. In the The **`char8_t`**, **`char16_t`**, and **`char32_t`** types represent 8-bit, 16-bit, and 32-bit wide characters, respectively. (**`char8_t`** is new in C++20 and requires the [`/std:c++20`](../build/reference/std-specify-language-standard-version.md) or **`/std:c++latest`** compiler option.) Unicode encoded as UTF-8 can be stored in the **`char8_t`** type. Strings of **`char8_t`** and **`char`** type are referred to as *narrow* strings, even when used to encode Unicode or multi-byte characters. Unicode encoded as UTF-16 can be stored in the **`char16_t`** type, and Unicode encoded as UTF-32 can be stored in the **`char32_t`** type. Strings of these types and **`wchar_t`** are all referred to as *wide* strings, though the term often refers specifically to strings of **`wchar_t`** type. -In the C++ standard library, the [`basic_string`](/cpp/standard-library/basic-string-class) type is specialized for both narrow and wide strings. Use `std::string` when the characters are of type **`char`**, `std::u8string` when the characters are of type **`char8_t`**, `std::u16string` when the characters are of type **`char16_t`**, `std::u32string` when the characters are of type **`char32_t`**, and `std::wstring` when the characters are of type **`wchar_t`**. +In the C++ standard library, the [`basic_string`](../standard-library/basic-string-class.md) type is specialized for both narrow and wide strings. Use `std::string` when the characters are of type **`char`**, `std::u8string` when the characters are of type **`char8_t`**, `std::u16string` when the characters are of type **`char16_t`**, `std::u32string` when the characters are of type **`char32_t`**, and `std::wstring` when the characters are of type **`wchar_t`**. -Other types that represent text, including [`std::stringstream`](/cpp/standard-library/sstream-typedefs/#stringstream) and [`std::cout`](/cpp/standard-library/iostream#cout) have specializations for narrow and wide strings. +Other types that represent text, including [`std::stringstream`](../standard-library/sstream-typedefs.md#stringstream) and [`std::cout`](../standard-library/iostream.md#cout) have specializations for narrow and wide strings. diff --git a/docs/cpp/class-member-overview.md b/docs/cpp/class-member-overview.md index 54f6191224d..3d97b74bea9 100644 --- a/docs/cpp/class-member-overview.md +++ b/docs/cpp/class-member-overview.md @@ -17,7 +17,7 @@ The full list of member categories is as follows: - [Overview of member functions](overview-of-member-functions.md). -- [Mutable](static-members-cpp.md) and [static](static-members-cpp.md) data members, including built-in types and other user defined types. +- [Mutable](mutable-data-members-cpp.md) and [static](static-members-cpp.md) data members, including built-in types and other user defined types. - Operators diff --git a/docs/cpp/class-templates.md b/docs/cpp/class-templates.md index 42bb8d25398..4d0d7b7ce66 100644 --- a/docs/cpp/class-templates.md +++ b/docs/cpp/class-templates.md @@ -1,9 +1,8 @@ --- -description: "Learn more about: Class Templates" title: "Class Templates" +description: "Learn more about: Class Templates" ms.date: 06/30/2022 helpviewer_keywords: ["classes [C++], operating on type", "class templates", "templates, class templates"] -ms.assetid: 633a53c8-24ee-4c23-8c88-e7c3cb0b7ac3 --- # Class Templates @@ -28,15 +27,15 @@ public: template< class T, int i > MyStack< T, i >::MyStack( void ) { -}; +} template< class T, int i > void MyStack< T, i >::push( const T item ) { -}; +} template< class T, int i > T& MyStack< T, i >::pop( void ) { -}; +} int main() { diff --git a/docs/cpp/clrcall.md b/docs/cpp/clrcall.md index e0271e971a4..c368132c787 100644 --- a/docs/cpp/clrcall.md +++ b/docs/cpp/clrcall.md @@ -38,7 +38,7 @@ int __clrcall Func1() { } // Func1 hasn't been used at this point (code has not been generated), -// so runtime returns the adddress of a stub to the function +// so runtime returns the address of a stub to the function int (__clrcall *pf)() = &Func1; // code calls the function, code generated at difference address diff --git a/docs/cpp/codesnippet/CPP/how-to-create-and-use-shared-ptr-instances_1.cpp b/docs/cpp/codesnippet/CPP/how-to-create-and-use-shared-ptr-instances_1.cpp index af736b0495e..753367555e0 100644 --- a/docs/cpp/codesnippet/CPP/how-to-create-and-use-shared-ptr-instances_1.cpp +++ b/docs/cpp/codesnippet/CPP/how-to-create-and-use-shared-ptr-instances_1.cpp @@ -1,4 +1,3 @@ - // Use make_shared function when possible. auto sp1 = make_shared(L"The Beatles", L"Im Happy Just to Dance With You"); diff --git a/docs/cpp/codesnippet/CPP/how-to-create-and-use-shared-ptr-instances_6.cpp b/docs/cpp/codesnippet/CPP/how-to-create-and-use-shared-ptr-instances_6.cpp index 551c3f2f5b7..2c02d593fbd 100644 --- a/docs/cpp/codesnippet/CPP/how-to-create-and-use-shared-ptr-instances_6.cpp +++ b/docs/cpp/codesnippet/CPP/how-to-create-and-use-shared-ptr-instances_6.cpp @@ -1,4 +1,3 @@ - // Initialize two separate raw pointers. // Note that they contain the same values. auto song1 = new Song(L"Village People", L"YMCA"); diff --git a/docs/cpp/codesnippet/CPP/how-to-create-and-use-unique-ptr-instances_3.cpp b/docs/cpp/codesnippet/CPP/how-to-create-and-use-unique-ptr-instances_3.cpp index e7ad81c8d5a..29baefa191f 100644 --- a/docs/cpp/codesnippet/CPP/how-to-create-and-use-unique-ptr-instances_3.cpp +++ b/docs/cpp/codesnippet/CPP/how-to-create-and-use-unique-ptr-instances_3.cpp @@ -1,4 +1,3 @@ - class MyClass { private: diff --git a/docs/cpp/codesnippet/CPP/smart-pointers-modern-cpp_2.cpp b/docs/cpp/codesnippet/CPP/smart-pointers-modern-cpp_2.cpp index 10ac9aab95d..2c7e2716ed6 100644 --- a/docs/cpp/codesnippet/CPP/smart-pointers-modern-cpp_2.cpp +++ b/docs/cpp/codesnippet/CPP/smart-pointers-modern-cpp_2.cpp @@ -1,4 +1,3 @@ - class LargeObject { public: diff --git a/docs/cpp/com-ptr-t-extractors.md b/docs/cpp/com-ptr-t-extractors.md index 416c3967124..305a593e877 100644 --- a/docs/cpp/com-ptr-t-extractors.md +++ b/docs/cpp/com-ptr-t-extractors.md @@ -4,7 +4,6 @@ description: "Describes the extraction operators for the _com_ptr_t class." ms.date: 07/07/2020 f1_keywords: ["_com_ptr_t::operatorInterface&", "_com_ptr_t::operatorbool", "_com_ptr_t::operator->", "_com_ptr_t::operator*"] helpviewer_keywords: ["operator Interface& [C++]", "* operator [C++], with specific objects", "operator& [C++]", "operator* [C++]", "-> operator [C++], with specific objects", "& operator [C++], with specific objects", "operator Interface* [C++]", "operator * [C++]", "operator->", "operator bool", "extractors, _com_ptr_t class", "extractors [C++]"] -ms.assetid: 194b9e0e-123c-49ff-a187-0a7fcd68145a --- # `_com_ptr_t` Extractors @@ -14,7 +13,7 @@ Extract the encapsulated COM interface pointer. ## Syntax -```c++ +```cpp operator Interface*( ) const throw( ); operator Interface&( ) const; Interface& operator*( ) const; diff --git a/docs/cpp/com-ptr-t-relational-operators.md b/docs/cpp/com-ptr-t-relational-operators.md index 37ebee59797..7101967bd2a 100644 --- a/docs/cpp/com-ptr-t-relational-operators.md +++ b/docs/cpp/com-ptr-t-relational-operators.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: _com_ptr_t Relational Operators" title: "_com_ptr_t Relational Operators" -ms.date: "11/04/2016" +description: "Learn more about: _com_ptr_t Relational Operators" +ms.date: 11/04/2016 f1_keywords: ["_com_ptr_t::operator>", "_com_ptr_t::operator>=", "_com_ptr_t::operator<=", "_com_ptr_t::operator==", "_com_ptr_t::operator!=", "_com_ptr_t::operator<"] helpviewer_keywords: [">= operator [C++], comparing specific objects", "!= operator", "operator > [C++], pointers", "operator>= [C++], pointers", "operator < [C++], pointers", "operator!= [C++], relational operators", "< operator [C++], comparing specific objects", "operator== [C++], pointers", "operator == [C++], pointers", "<= operator [C++], with specific objects", "relational operators [C++], _com_ptr_t class", "operator >= [C++], pointers", "operator != [C++], relational operators", "operator <= [C++], pointers", "> operator [C++], comparing specific objects", "operator<= [C++], pointers", "operator< [C++], pointers", "== operator [C++], with specific Visual C++ objects"] -ms.assetid: 5ae4028c-33ee-485d-bbda-88d2604d6d4b --- # _com_ptr_t Relational Operators @@ -33,7 +32,7 @@ bool operator==( const _com_ptr_t& p ) throw(); template<> bool operator==( _com_ptr_t& p ) throw(); -bool operator==( Int null ); +bool operator==( int null ); template bool operator!=( const _com_ptr_t<_OtherIID>& p ); @@ -44,7 +43,7 @@ bool operator!=( _com_ptr_t<_OtherIID>& p ); template bool operator!=( _InterfaceType* p ); -bool operator!=( Int null ); +bool operator!=( int null ); template bool operator<( const _com_ptr_t<_OtherIID>& p ); diff --git a/docs/cpp/compiler-limits.md b/docs/cpp/compiler-limits.md index c1926cd2744..4fcdd08cfc9 100644 --- a/docs/cpp/compiler-limits.md +++ b/docs/cpp/compiler-limits.md @@ -1,6 +1,6 @@ --- -description: "Learn more about: Compiler Limits" title: "Compiler Limits" +description: "Learn more about: Compiler Limits" ms.date: "06/05/2023" helpviewer_keywords: ["cl.exe compiler, limits for language constructs"] --- @@ -22,7 +22,7 @@ The C++ standard recommends limits for various language constructs. The followin - Scope qualifications of one identifier - C++ standard: 256, Microsoft C++ compiler: 127. -- Nested **`extern`** specifications - C++ standard: 1024, Microsoft C++ compiler: 9 (not counting the implicit **`extern`** specification in global scope, or 10, if you count the implicit **`extern`** specification in global scope.. +- Nested **`extern`** specifications - C++ standard: 1024, Microsoft C++ compiler: 9 (not counting the implicit **`extern`** specification in global scope, or 10, if you count the implicit **`extern`** specification in global scope. - Template arguments in a template declaration - C++ standard: 1024, Microsoft C++ compiler: 2046. diff --git a/docs/cpp/const-and-volatile-pointers.md b/docs/cpp/const-and-volatile-pointers.md index cca4371b50a..b786fcb6b4d 100644 --- a/docs/cpp/const-and-volatile-pointers.md +++ b/docs/cpp/const-and-volatile-pointers.md @@ -1,9 +1,8 @@ --- -description: "Learn more about: const and volatile pointers" title: "const and volatile pointers" +description: "Learn more about: const and volatile pointers" ms.date: "11/19/2019" helpviewer_keywords: ["volatile keyword [C++], and pointers", "pointers, and const", "pointers, and volatile", "const keyword [C++], volatile pointers"] -ms.assetid: 0c92dc6c-400e-4342-b345-63ddfe649d7e --- # const and volatile pointers @@ -117,5 +116,5 @@ int main() { ## See also -[Pointers](pointers-cpp.md) +[Pointers](pointers-cpp.md)\ [Raw pointers](raw-pointers.md) diff --git a/docs/cpp/cpp-language-reference.md b/docs/cpp/cpp-language-reference.md index f5316639dfd..7165a7aa290 100644 --- a/docs/cpp/cpp-language-reference.md +++ b/docs/cpp/cpp-language-reference.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: C++ Language Reference" title: "C++ Language Reference" +description: "Learn more about: C++ Language Reference" ms.custom: "index-page" -ms.date: "12/10/2019" +ms.date: 12/10/2019 helpviewer_keywords: ["C++, language reference"] -ms.assetid: 4be9cacb-c862-4391-894a-3a118c9c93ce --- # C++ Language Reference @@ -14,96 +13,95 @@ For an overview of Modern C++ programming practices, see [Welcome Back to C++](w See the following tables to quickly find a keyword or operator: -- [C++ Keywords](../cpp/keywords-cpp.md) - -- [C++ Operators](../cpp/cpp-built-in-operators-precedence-and-associativity.md) +- [C++ Keywords](keywords-cpp.md) +- [C++ Operators](cpp-built-in-operators-precedence-and-associativity.md) ## In This Section -[Lexical Conventions](../cpp/lexical-conventions.md)
+[Lexical Conventions](lexical-conventions.md)\ Fundamental lexical elements of a C++ program: tokens, comments, operators, keywords, punctuators, literals. Also, file translation, operator precedence/associativity. -[Basic Concepts](../cpp/basic-concepts-cpp.md)
+[Basic Concepts](basic-concepts-cpp.md)\ Scope, linkage, program startup and termination, storage classes, and types. -[Built-in types](fundamental-types-cpp.md) +[Built-in types](fundamental-types-cpp.md)\ The fundamental types that are built into the C++ compiler and their value ranges. -[Standard Conversions](../cpp/standard-conversions.md)
+[Standard Conversions](standard-conversions.md)\ Type conversions between built-in types. Also, arithmetic conversions and conversions among pointer, reference, and pointer-to-member types. -[Declarations and definitions](declarations-and-definitions-cpp.md) +[Declarations and definitions](declarations-and-definitions-cpp.md)\ Declaring and defining variables, types and functions. -[Operators, Precedence and Associativity](../cpp/cpp-built-in-operators-precedence-and-associativity.md)
+[Operators, Precedence and Associativity](cpp-built-in-operators-precedence-and-associativity.md)\ The operators in C++. -[Expressions](../cpp/expressions-cpp.md)
+[Expressions](expressions-cpp.md)\ Types of expressions, semantics of expressions, reference topics on operators, casting and casting operators, run-time type information. -[Lambda Expressions](../cpp/lambda-expressions-in-cpp.md)
+[Lambda Expressions](lambda-expressions-in-cpp.md)\ A programming technique that implicitly defines a function object class and constructs a function object of that class type. -[Statements](../cpp/statements-cpp.md)
+[Statements](statements-cpp.md)\ Expression, null, compound, selection, iteration, jump, and declaration statements. -[Classes and structs](../cpp/classes-and-structs-cpp.md)
+[Classes and structs](classes-and-structs-cpp.md)\ Introduction to classes, structures, and unions. Also, member functions, special member functions, data members, bit fields, **`this`** pointer, nested classes. -[Unions](unions.md)
+[Unions](unions.md)\ User-defined types in which all members share the same memory location. -[Derived Classes](../cpp/inheritance-cpp.md)
+[Derived Classes](inheritance-cpp.md)\ Single and multiple inheritance, **`virtual`** functions, multiple base classes, **abstract** classes, scope rules. Also, the **`__super`** and **`__interface`** keywords. -[Member-Access Control](../cpp/member-access-control-cpp.md)
+[Member-Access Control](member-access-control-cpp.md)\ Controlling access to class members: **`public`**, **`private`**, and **`protected`** keywords. Friend functions and classes. -[Overloading](operator-overloading.md)
+[Overloading](operator-overloading.md)\ Overloaded operators, rules for operator overloading. -[Exception Handling](../cpp/exception-handling-in-visual-cpp.md)
+[Exception Handling](exception-handling-in-visual-cpp.md)\ C++ exception handling, structured exception handling (SEH), keywords used in writing exception handling statements. -[Assertion and User-Supplied Messages](../cpp/assertion-and-user-supplied-messages-cpp.md)
+[Assertion and User-Supplied Messages](assertion-and-user-supplied-messages-cpp.md)\ `#error` directive, the **`static_assert`** keyword, the `assert` macro. -[Templates](../cpp/templates-cpp.md)
+[Templates](templates-cpp.md)\ Template specifications, function templates, class templates, **`typename`** keyword, templates vs. macros, templates and smart pointers. -[Event Handling](../cpp/event-handling.md)
+[Event Handling](event-handling.md)\ Declaring events and event handlers. -[Microsoft-Specific Modifiers](../cpp/microsoft-specific-modifiers.md)
+[Microsoft-Specific Modifiers](microsoft-specific-modifiers.md)\ Modifiers specific to Microsoft C++. Memory addressing, calling conventions, **`naked`** functions, extended storage-class attributes (**`__declspec`**), **`__w64`**. -[Inline Assembler](../assembler/inline/inline-assembler.md)
+[Inline Assembler](../assembler/inline/inline-assembler.md)\ Using assembly language and C++ in **`__asm`** blocks. -[Compiler COM Support](../cpp/compiler-com-support.md)
+[Compiler COM Support](compiler-com-support.md)\ A reference to Microsoft-specific classes and global functions used to support COM types. -[Microsoft Extensions](../cpp/microsoft-extensions.md)
+[Microsoft Extensions](microsoft-extensions.md)\ Microsoft extensions to C++. -[Nonstandard Behavior](../cpp/nonstandard-behavior.md)
+[Nonstandard Behavior](nonstandard-behavior.md)\ Information about nonstandard behavior of the Microsoft C++ compiler. -[Welcome Back to C++](welcome-back-to-cpp-modern-cpp.md)
+[Welcome Back to C++](welcome-back-to-cpp-modern-cpp.md)\ An overview of modern C++ programming practices for writing safe, correct and efficient programs. ## Related Sections -[Component Extensions for Runtime Platforms](../extensions/component-extensions-for-runtime-platforms.md)
+[Component Extensions for Runtime Platforms](../extensions/component-extensions-for-runtime-platforms.md)\ Reference material on using the Microsoft C++ compiler to target .NET. -[C/C++ Building Reference](../build/reference/c-cpp-building-reference.md)
+[C/C++ Building Reference](../build/reference/c-cpp-building-reference.md)\ Compiler options, linker options, and other build tools. -[C/C++ Preprocessor Reference](../preprocessor/c-cpp-preprocessor-reference.md)
+[C/C++ Preprocessor Reference](../preprocessor/c-cpp-preprocessor-reference.md)\ Reference material on pragmas, preprocessor directives, predefined macros, and the preprocessor. -[Visual C++ Libraries](../standard-library/cpp-standard-library-reference.md)
+[Visual C++ Libraries](../standard-library/cpp-standard-library-reference.md)\ A list of links to the reference start pages for the various Microsoft C++ libraries. ## See also diff --git a/docs/cpp/cpp-type-system-modern-cpp.md b/docs/cpp/cpp-type-system-modern-cpp.md index ad5f425f45c..67772c31a07 100644 --- a/docs/cpp/cpp-type-system-modern-cpp.md +++ b/docs/cpp/cpp-type-system-modern-cpp.md @@ -2,8 +2,7 @@ description: "Learn more about: C++ type system" title: "C++ type system" ms.date: 11/04/2022 -ms.topic: "conceptual" -ms.assetid: 553c0ed6-77c4-43e9-87b1-c903eec53e80 +ms.topic: "concept-article" --- # C++ type system @@ -56,7 +55,7 @@ The compiler recognizes these built-in types, and it has built-in rules that gov The following illustration shows the relative sizes of the built-in types in the Microsoft C++ implementation: -![Diagram of the relative size in bytes of several built in types.](../cpp/media/built-intypesizes.png) +:::image type="content" source="../cpp/media/built-intypesizes.png" alt-text="Diagram showing the relative sizes in bytes of C++ built-in types: bool and char (1 byte), short (2 bytes), int, long, and float (4 bytes), double and long long (8 bytes)"::: The following table lists the most frequently used fundamental types, and their sizes in the Microsoft C++ implementation: diff --git a/docs/cpp/declspec.md b/docs/cpp/declspec.md index 253de9e94dd..443a140a7cb 100644 --- a/docs/cpp/declspec.md +++ b/docs/cpp/declspec.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: `__declspec`" title: "__declspec" -ms.date: 03/01/2022 +description: "Learn more about: `__declspec`" +ms.date: 1/14/2025 f1_keywords: ["__declspec_cpp", "__declspec", "_declspec"] helpviewer_keywords: ["__declspec keyword [C++]"] --- @@ -9,7 +9,7 @@ helpviewer_keywords: ["__declspec keyword [C++]"] **Microsoft Specific** -The extended attribute syntax for specifying storage-class information uses the **`__declspec`** keyword, which specifies that an instance of a given type is to be stored with a Microsoft-specific storage-class attribute listed below. Examples of other storage-class modifiers include the **`static`** and **`extern`** keywords. However, these keywords are part of the ANSI specification of the C and C++ languages, and as such aren't covered by extended attribute syntax. The extended attribute syntax simplifies and standardizes Microsoft-specific extensions to the C and C++ languages. +The extended attribute syntax for specifying storage-class information uses the `__declspec` keyword, which specifies that an instance of a given type is to be stored with a Microsoft-specific storage-class attribute listed below. Examples of other storage-class modifiers include the `static` and `extern` keywords. However, these keywords are part of the ANSI specification of the C and C++ languages, and as such aren't covered by extended attribute syntax. The extended attribute syntax simplifies and standardizes Microsoft-specific extensions to the C and C++ languages. ## Grammar @@ -30,6 +30,7 @@ The extended attribute syntax for specifying storage-class information uses the  **`dllimport`**\  **`dllexport`**\  **`empty_bases`**\ + **`hybrid_patchable`**\  **`jitintrinsic`**\  **`naked`**\  **`noalias`**\ @@ -49,7 +50,7 @@ The extended attribute syntax for specifying storage-class information uses the White space separates the declaration modifier sequence. Examples appear in later sections. -Extended attribute grammar supports these Microsoft-specific storage-class attributes: [`align`](../cpp/align-cpp.md), [`allocate`](../cpp/allocate.md), [`allocator`](../cpp/allocator.md), [`appdomain`](../cpp/appdomain.md), [`code_seg`](../cpp/code-seg-declspec.md), [`deprecated`](../cpp/deprecated-cpp.md), [`dllexport`](../cpp/dllexport-dllimport.md), [`dllimport`](../cpp/dllexport-dllimport.md), [`empty_bases`](../cpp/empty-bases.md), [`jitintrinsic`](../cpp/jitintrinsic.md), [`naked`](../cpp/naked-cpp.md), [`noalias`](../cpp/noalias.md), [`noinline`](../cpp/noinline.md), [`noreturn`](../cpp/noreturn.md), [`nothrow`](../cpp/nothrow-cpp.md), [`novtable`](../cpp/novtable.md), [`no_sanitize_address`](../cpp/no-sanitize-address.md),[`process`](../cpp/process.md), [`restrict`](../cpp/restrict.md), [`safebuffers`](../cpp/safebuffers.md), [`selectany`](../cpp/selectany.md), [`spectre`](../cpp/spectre.md), and [`thread`](../cpp/thread.md). It also supports these COM-object attributes: [`property`](../cpp/property-cpp.md) and [`uuid`](../cpp/uuid-cpp.md). +Extended attribute grammar supports these Microsoft-specific storage-class attributes: [`align`](align-cpp.md), [`allocate`](allocate.md), [`allocator`](allocator.md), [`appdomain`](appdomain.md), [`code_seg`](code-seg-declspec.md), [`deprecated`](deprecated-cpp.md), [`dllexport`](dllexport-dllimport.md), [`dllimport`](dllexport-dllimport.md), [`empty_bases`](empty-bases.md), [`jitintrinsic`](jitintrinsic.md), [`naked`](naked-cpp.md), [`noalias`](noalias.md), [`noinline`](noinline.md), [`noreturn`](noreturn.md), [`nothrow`](nothrow-cpp.md), [`novtable`](novtable.md), [`no_sanitize_address`](no-sanitize-address.md), [`process`](process.md), [`restrict`](restrict.md), [`safebuffers`](safebuffers.md), [`selectany`](selectany.md), [`spectre`](spectre.md), and [`thread`](thread.md). It also supports these COM-object attributes: [`property`](property-cpp.md) and [`uuid`](uuid-cpp.md). The **`code_seg`**, **`dllexport`**, **`dllimport`**, **`empty_bases`**, **`naked`**, **`noalias`**, **`nothrow`**, **`no_sanitize_address`**, **`property`**, **`restrict`**, **`selectany`**, **`thread`**, and **`uuid`** storage-class attributes are properties only of the declaration of the object or function to which they're applied. The **`thread`** attribute affects data and objects only. The **`naked`** and **`spectre`** attributes affect functions only. The **`dllimport`** and **`dllexport`** attributes affect functions, data, and objects. The **`property`**, **`selectany`**, and **`uuid`** attributes affect COM objects. @@ -94,5 +95,5 @@ __declspec( thread ) int tls_i = 1; ## See also -[Keywords](../cpp/keywords-cpp.md)\ +[Keywords](keywords-cpp.md)\ [C extended storage-class attributes](../c-language/c-extended-storage-class-attributes.md) diff --git a/docs/cpp/decltype-cpp.md b/docs/cpp/decltype-cpp.md index 2b387820ce7..a223db3db59 100644 --- a/docs/cpp/decltype-cpp.md +++ b/docs/cpp/decltype-cpp.md @@ -1,6 +1,6 @@ --- -description: "Learn more about: decltype (C++)" title: "decltype (C++)" +description: "Learn more about: decltype (C++)" ms.date: 09/14/2023 f1_keywords: ["decltype_cpp"] helpviewer_keywords: ["operators [C++], decltype", "decltype operator", "operators [C++], type of an expression", "operators [C++], deduce expression type"] @@ -60,7 +60,7 @@ In C++11, you can use the **`decltype`** type specifier on a trailing return typ ```cpp template -UNKNOWN func(T&& t, U&& u){ return t + u; }; +UNKNOWN func(T&& t, U&& u){ return t + u; } ``` The introduction of the **`decltype`** type specifier enables a developer to obtain the type of the expression that the function template returns. Use the *alternative function declaration syntax* that is shown later, the **`auto`** keyword, and the **`decltype`** type specifier to declare a *late-specified* return type. The late-specified return type is determined when the declaration is compiled, instead of when it's coded. @@ -75,12 +75,12 @@ In the following code example, the late-specified return type of the `myFunc` fu //C++11 template auto myFunc(T&& t, U&& u) -> decltype (forward(t) + forward(u)) - { return forward(t) + forward(u); }; + { return forward(t) + forward(u); } //C++14 template decltype(auto) myFunc(T&& t, U&& u) - { return forward(t) + forward(u); }; + { return forward(t) + forward(u); } ``` ## `decltype` and forwarding functions (C++11) diff --git a/docs/cpp/errors-and-exception-handling-modern-cpp.md b/docs/cpp/errors-and-exception-handling-modern-cpp.md index 486a271ba82..3140848fae8 100644 --- a/docs/cpp/errors-and-exception-handling-modern-cpp.md +++ b/docs/cpp/errors-and-exception-handling-modern-cpp.md @@ -2,7 +2,7 @@ title: "Modern C++ best practices for exceptions and error handling" description: "How Modern C++ supports exceptional programming styles over error codes." ms.date: 03/22/2024 -ms.topic: "conceptual" +ms.topic: "best-practice" --- # Modern C++ best practices for exceptions and error handling diff --git a/docs/cpp/explicit-specialization-of-function-templates.md b/docs/cpp/explicit-specialization-of-function-templates.md index 5842f4e767d..769315f1496 100644 --- a/docs/cpp/explicit-specialization-of-function-templates.md +++ b/docs/cpp/explicit-specialization-of-function-templates.md @@ -1,9 +1,8 @@ --- -description: "Learn more about: Explicit Specialization of Function Templates" title: "Explicit Specialization of Function Templates" -ms.date: "11/04/2016" +description: "Learn more about: Explicit Specialization of Function Templates" +ms.date: 11/04/2016 helpviewer_keywords: ["overriding, functions", "function templates, specialization", "explicit specialization of function templates", "declaring functions [C++], specialization of function template", "specialization of function templates"] -ms.assetid: eb0fcb73-eaed-42a1-9b83-14b055a34bf8 --- # Explicit Specialization of Function Templates @@ -21,7 +20,7 @@ This declaration enables you to define a different function for **`double`** var // explicit_specialization.cpp template void f(T t) { -}; +} // Explicit specialization of f with 'char' with the // template argument explicitly specified: diff --git a/docs/cpp/explicitly-defaulted-and-deleted-functions.md b/docs/cpp/explicitly-defaulted-and-deleted-functions.md index 13daddcfc36..78904c4e76c 100644 --- a/docs/cpp/explicitly-defaulted-and-deleted-functions.md +++ b/docs/cpp/explicitly-defaulted-and-deleted-functions.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: Explicitly Defaulted and Deleted Functions" title: "Explicitly Defaulted and Deleted Functions" -ms.date: "11/04/2016" +description: "Learn more about: Explicitly Defaulted and Deleted Functions" +ms.date: 11/04/2016 --- # Explicitly Defaulted and Deleted Functions @@ -44,7 +44,7 @@ These rules can complicate the implementation of what should be straight-forward ```cpp struct noncopyable { - noncopyable() {}; + noncopyable() {} private: noncopyable(const noncopyable&); diff --git a/docs/cpp/extension-restrict.md b/docs/cpp/extension-restrict.md index ce69c439af6..16c3231d0a3 100644 --- a/docs/cpp/extension-restrict.md +++ b/docs/cpp/extension-restrict.md @@ -1,7 +1,7 @@ --- title: "`__restrict`" -description: "Describes the Microsoft Visual C++ `__restrict` keyword." -ms.date: "11/6/2020" +description: "Describes the Microsoft Visual C++ `__restrict` keyword." +ms.date: 11/6/2020 f1_keywords: ["__restrict_cpp", "__restrict", "_restrict"] helpviewer_keywords: ["__restrict keyword [C++]"] --- diff --git a/docs/cpp/floating-limits.md b/docs/cpp/floating-limits.md index 475ad5b18ba..60762ecfb15 100644 --- a/docs/cpp/floating-limits.md +++ b/docs/cpp/floating-limits.md @@ -1,9 +1,8 @@ --- -description: "Learn more about: Floating Limits" title: "Floating Limits" -ms.date: "08/03/2018" +description: "Learn more about: Floating Limits" +ms.date: 08/03/2018 helpviewer_keywords: ["ranges, floating-point constants", "floating-point constants, limits", "float.h header file", "limits, floating-point constants", "floating-point numbers [C++]", "floating limits"] -ms.assetid: fc718652-1f4c-4ed8-af60-0e769637459c --- # Floating Limits @@ -15,7 +14,7 @@ The following table lists the limits on the values of floating-point constants. |Constant|Meaning|Value| |--------------|-------------|-----------| -|`FLT_DIG`
`DBL_DIG`
`LDBL_DIG`|Number of digits, q, such that a floating-point number with q decimal digits can be rounded into a floating-point representation and back without loss of precision.|6
15
15| +|`FLT_DIG`
`DBL_DIG`
`LDBL_DIG`|Number of digits, q, such that a floating-point number with q decimal digits can be rounded into a floating-point representation and back without loss of precision.|6
15
15| |`FLT_EPSILON`
`DBL_EPSILON`
`LDBL_EPSILON`|Smallest positive number x, such that x + 1.0 is not equal to 1.0.|1.192092896e-07F
2.2204460492503131e-016
2.2204460492503131e-016| |`FLT_GUARD`||0| |`FLT_MANT_DIG`
`DBL_MANT_DIG`
`LDBL_MANT_DIG`|Number of digits in the radix specified by `FLT_RADIX` in the floating-point significand. The radix is 2; hence these values specify bits.|24
53
53| diff --git a/docs/cpp/function-overloading.md b/docs/cpp/function-overloading.md index 694aa6e3d17..8f8c24a61a9 100644 --- a/docs/cpp/function-overloading.md +++ b/docs/cpp/function-overloading.md @@ -1,6 +1,6 @@ --- -description: "Learn more about: Function Overloading" title: "Function Overloading" +description: "Learn more about: Function Overloading" ms.date: 02/01/2023 helpviewer_keywords: ["function overloading [C++], about function overloading", "function overloading", "declaring functions [C++], overloading"] --- @@ -307,7 +307,7 @@ public: void Print( int i ) { -}; +} UDC udc; diff --git a/docs/cpp/functions-cpp.md b/docs/cpp/functions-cpp.md index 92c4ee51583..58670206a16 100644 --- a/docs/cpp/functions-cpp.md +++ b/docs/cpp/functions-cpp.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: Functions (C++)" title: "Functions (C++)" -ms.date: "11/19/2018" +description: "Learn more about: Functions (C++)" +ms.date: 11/19/2018 helpviewer_keywords: ["defaults, arguments", "function definitions", "function definitions, about function definitions", "default arguments", "declarators, functions"] --- # Functions (C++) @@ -77,7 +77,6 @@ Optional parts of a function declaration are: ```cpp //Declare printf with C linkage. extern "C" int printf( const char *fmt, ... ); - ``` For more information, see [Translation units and linkage](../cpp/program-and-linkage-cpp.md). diff --git a/docs/cpp/functions-with-variable-argument-lists-cpp.md b/docs/cpp/functions-with-variable-argument-lists-cpp.md index 1fb884942d9..59316d69931 100644 --- a/docs/cpp/functions-with-variable-argument-lists-cpp.md +++ b/docs/cpp/functions-with-variable-argument-lists-cpp.md @@ -1,66 +1,68 @@ --- -description: "Learn more about: Functions with Variable Argument Lists (C++)" -title: "Functions with Variable Argument Lists (C++)" -ms.date: "11/04/2016" +title: "Functions with Variable Argument Lists (C++)" +description: "Learn more about: Functions with Variable Argument Lists (C++)" +ms.date: 05/01/2025 helpviewer_keywords: ["arguments [C++], variable number of", "variable argument lists", "declarators, functions", "argument lists [C++], variable number of", "declaring functions [C++], variables", "function calls, variable number of arguments"] -ms.assetid: 27c2f83a-21dd-44c6-913c-2834cb944703 --- -# Functions with Variable Argument Lists (C++) +# Functions with Variable Argument Lists (C++) -Function declarations in which the last member of is the ellipsis (...) can take a variable number of arguments. In these cases, C++ provides type checking only for the explicitly declared arguments. You can use variable argument lists when you need to make a function so general that even the number and types of arguments can vary. The family of functions is an example of functions that use variable argument lists.`printf`*argument-declaration-list* +Function declarations that have ellipsis (...) as the last argument take a variable number of arguments. C++ provides type checking only for the explicitly declared arguments. You can use variable argument lists when the number and types of arguments to the function can vary. The `printf` family of functions is an example of functions that have variable argument lists. ## Functions with variable arguments -To access arguments after those declared, use the macros contained in the standard include file \ as described below. +To access arguments after those declared, use the macros contained in the standard include file `` as explained in this article. **Microsoft Specific** -Microsoft C++ allows the ellipsis to be specified as an argument if the ellipsis is the last argument and the ellipsis is preceded by a comma. Therefore, the declaration `int Func( int i, ... );` is legal, but `int Func( int i ... );` is not. +Microsoft C++ allows the ellipsis to be specified as an argument if the ellipsis is the last argument and a comma comes before the ellipsis. Therefore, the declaration `int Func( int i, ... );` is legal, but `int Func( int i ... );` isn't. **END Microsoft Specific** -Declaration of a function that takes a variable number of arguments requires at least one placeholder argument, even if it is not used. If this placeholder argument is not supplied, there is no way to access the remaining arguments. +Declaration of a function that takes a variable number of arguments requires at least one placeholder argument, even if it isn't used. If this placeholder argument isn't supplied, there's no way to access the remaining arguments. -When arguments of type **`char`** are passed as variable arguments, they are converted to type **`int`**. Similarly, when arguments of type **`float`** are passed as variable arguments, they are converted to type **`double`**. Arguments of other types are subject to the usual integral and floating-point promotions. See [Standard Conversions](standard-conversions.md) for more information. +When arguments of type **`char`** are passed as variable arguments, they're converted to type **`int`**. Similarly, when arguments of type **`float`** are passed as variable arguments, they're converted to type **`double`**. Arguments of other types are subject to the usual integral and floating-point promotions. For more information, see [Standard Conversions](standard-conversions.md). -Functions that require variable lists are declared by using the ellipsis (...) in the argument list. Use the types and macros that are described in the \ include file to access arguments that are passed by a variable list. For more information about these macros, see [va_arg, va_copy, va_end, va_start](../c-runtime-library/reference/va-arg-va-copy-va-end-va-start.md). in the documentation for the C Run-Time Library. +Functions that require variable lists are declared by using the ellipsis (...) in the argument list. Use the types and macros that are described in the `` include file to access arguments that are passed by a variable list. For more information about these macros, see [va_arg, va_copy, va_end, va_start](../c-runtime-library/reference/va-arg-va-copy-va-end-va-start.md). -The following example shows how the macros work together with the type (declared in \): +The following example shows how to use the macros to process a variable argument list: ```cpp // variable_argument_lists.cpp + #include #include // Declaration, but not definition, of ShowVar. void ShowVar( char *szTypes, ... ); + int main() { ShowVar( "fcsi", 32.4f, 'a', "Test string", 4 ); } -// ShowVar takes a format string of the form -// "ifcs", where each character specifies the -// type of the argument in that position. +// ShowVar takes a format string of the form +// "ifcs", where each character specifies the +// type of the argument in that position. // -// i = int -// f = float -// c = char -// s = string (char *) +// i = int +// f = float +// c = char +// s = string (char *) // -// Following the format specification is a variable -// list of arguments. Each argument corresponds to -// a format character in the format string to which +// Following the format specification is a variable +// list of arguments. Each argument corresponds to +// a format character in the format string to which // the szTypes parameter points void ShowVar( char *szTypes, ... ) { va_list vl; int i; - // szTypes is the last argument specified; you must access - // all others using the variable-argument macros. + // szTypes is the last argument specified; you must access + // all others using the variable-argument macros. va_start( vl, szTypes ); // Step through the list. for( i = 0; szTypes[i] != '\0'; ++i ) { + union Printable_t { int i; float f; @@ -68,45 +70,44 @@ void ShowVar( char *szTypes, ... ) { char *s; } Printable; - switch( szTypes[i] ) { // Type to expect. + switch( szTypes[i] ) { // Type to expect case 'i': Printable.i = va_arg( vl, int ); printf_s( "%i\n", Printable.i ); - break; + break; case 'f': Printable.f = va_arg( vl, double ); printf_s( "%f\n", Printable.f ); - break; + break; case 'c': Printable.c = va_arg( vl, char ); printf_s( "%c\n", Printable.c ); - break; + break; case 's': Printable.s = va_arg( vl, char * ); printf_s( "%s\n", Printable.s ); - break; + break; default: - break; + break; } } va_end( vl ); } -//Output: -// 32.400002 -// a -// Test string +``` + +```Output +32.400002 +a +Test string ``` The previous example illustrates these important concepts: 1. You must establish a list marker as a variable of type `va_list` before any variable arguments are accessed. In the previous example, the marker is called `vl`. - 1. The individual arguments are accessed by using the `va_arg` macro. You must tell the `va_arg` macro the type of argument to retrieve so that it can transfer the correct number of bytes from the stack. If you specify an incorrect type of a size different from that supplied by the calling program to `va_arg`, the results are unpredictable. - 1. You should explicitly cast the result obtained by using the `va_arg` macro to the type that you want. - -You must call the macro to terminate variable-argument processing.`va_end` +1. You must call the `va_end` macro to terminate variable-argument processing. \ No newline at end of file diff --git a/docs/cpp/fundamental-types-cpp.md b/docs/cpp/fundamental-types-cpp.md index 457e01bac46..69c1c4ca01d 100644 --- a/docs/cpp/fundamental-types-cpp.md +++ b/docs/cpp/fundamental-types-cpp.md @@ -1,10 +1,9 @@ --- +title: "Built-in types (C++)" description: "Learn more about: Built-in types (C++)" -title: "Built-in types (C++)" ms.date: 07/22/2020 f1_keywords: ["__int128_cpp", "__wchar_t_cpp", "char_cpp", "char8_t_cpp", "char16_t_cpp", "char32_t_cpp", "double_cpp", "float_cpp", "int_cpp", "long_cpp", "long_double_cpp", "short_cpp", "signed_cpp", "unsigned_cpp", "unsigned_int_cpp", "wchar_t_cpp"] helpviewer_keywords: ["specifiers [C++], type", "float keyword [C++]", "char keyword [C++]", "__wchar_t keyword [C++]", "signed types [C++], summary of data types", "Integer data type [C++], C++ data types", "arithmetic operations [C++], types", "int data type", "unsigned types [C++], summary of data types", "short data type [C++]", "double data type [C++], summary of types", "long long keyword [C++]", "long double keyword [C++]", "unsigned types [C++]", "signed types [C++]", "void keyword [C++]", "storage [C++], basic type", "integral types, C++", "wchar_t keyword [C++]", "floating-point numbers [C++], C++ data types", "long keyword [C++]", "type specifiers [C++]", "integral types", "long keyword [C++]", "storing types [C++]", "data types [C++], void"] -ms.assetid: 58b0106a-0406-4b74-a430-7cbd315c0f89 --- # Built-in types (C++) @@ -14,11 +13,11 @@ Built-in types (also called *fundamental types*) are specified by the C++ langua The [`void`](void-cpp.md) type describes an empty set of values. No variable of type **`void`** can be specified. The **`void`** type is used primarily to declare functions that return no values or to declare generic pointers to untyped or arbitrarily typed data. Any expression can be explicitly converted or cast to type **`void`**. However, such expressions are restricted to the following uses: -- An expression statement. (For more information, see [Expressions](expressions-cpp.md).) +- An expression statement. For more information, see [Expressions](expressions-cpp.md). -- The left operand of the comma operator. (For more information, see [Comma Operator](comma-operator.md).) +- The left operand of the comma operator. For more information, see [Comma Operator](comma-operator.md). -- The second or third operand of the conditional operator (`? :`). (For more information, see [Expressions with the Conditional Operator](conditional-operator-q.md).) +- The second or third operand of the conditional operator (`? :`). For more information, see [Expressions with the Conditional Operator](conditional-operator-q.md). ## std::nullptr_t diff --git a/docs/cpp/how-to-create-and-use-ccomptr-and-ccomqiptr-instances.md b/docs/cpp/how-to-create-and-use-ccomptr-and-ccomqiptr-instances.md index c25e220009e..a780106d816 100644 --- a/docs/cpp/how-to-create-and-use-ccomptr-and-ccomqiptr-instances.md +++ b/docs/cpp/how-to-create-and-use-ccomptr-and-ccomqiptr-instances.md @@ -3,8 +3,6 @@ description: "Learn more about: How to: Create and use CComPtr and CComQIPtr ins title: "How to: Create and use CComPtr and CComQIPtr instances" ms.custom: "how-to" ms.date: "11/19/2019" -ms.topic: "conceptual" -ms.assetid: b0356cfb-12cc-4ee8-b988-8311ed1ab5e0 --- # How to: Create and use CComPtr and CComQIPtr instances @@ -20,7 +18,7 @@ The following example shows how to use `CComPtr` to instantiate a COM object and `CComPtr` and its relatives are part of the ATL and are defined in \. `_com_ptr_t` is declared in \. The compiler creates specializations of `_com_ptr_t` when it generates wrapper classes for type libraries. -## Example: CComQIPt +## Example: CComQIPtr ATL also provides `CComQIPtr`, which has a simpler syntax for querying a COM object to retrieve an additional interface. However, we recommend `CComPtr` because it does everything that `CComQIPtr` can do and is semantically more consistent with raw COM interface pointers. If you use a `CComPtr` to query for an interface, the new interface pointer is placed in an out parameter. If the call fails, an HRESULT is returned, which is the typical COM pattern. With `CComQIPtr`, the return value is the pointer itself, and if the call fails, the internal HRESULT return value cannot be accessed. The following two lines show how the error handling mechanisms in `CComPtr` and `CComQIPtr` differ. diff --git a/docs/cpp/how-to-create-and-use-shared-ptr-instances.md b/docs/cpp/how-to-create-and-use-shared-ptr-instances.md index 28e2e78d4a1..cc993258bd9 100644 --- a/docs/cpp/how-to-create-and-use-shared-ptr-instances.md +++ b/docs/cpp/how-to-create-and-use-shared-ptr-instances.md @@ -3,7 +3,6 @@ description: "Learn more about: How to: Create and Use shared_ptr instances" title: "How to: Create and use shared_ptr instances" ms.custom: "how-to" ms.date: "12/4/2024" -ms.topic: "conceptual" --- # How to: Create and Use shared_ptr instances diff --git a/docs/cpp/how-to-create-and-use-unique-ptr-instances.md b/docs/cpp/how-to-create-and-use-unique-ptr-instances.md index 4621600bd18..b679190aeee 100644 --- a/docs/cpp/how-to-create-and-use-unique-ptr-instances.md +++ b/docs/cpp/how-to-create-and-use-unique-ptr-instances.md @@ -3,7 +3,6 @@ description: "Learn more about: How to: Create and use unique_ptr instances" title: "How to: Create and use unique_ptr instances" ms.custom: "how-to" ms.date: "11/19/2018" -ms.topic: "conceptual" ms.assetid: 9a373030-e587-452f-b9a5-c5f9d58b7673 --- # How to: Create and use unique_ptr instances diff --git a/docs/cpp/how-to-create-and-use-weak-ptr-instances.md b/docs/cpp/how-to-create-and-use-weak-ptr-instances.md index 0f5cf8724c2..0947a8d9be9 100644 --- a/docs/cpp/how-to-create-and-use-weak-ptr-instances.md +++ b/docs/cpp/how-to-create-and-use-weak-ptr-instances.md @@ -3,7 +3,6 @@ description: "Learn more about: How to: Create and use weak_ptr instances" title: "How to: Create and use weak_ptr instances" ms.custom: "how-to" ms.date: "11/19/2019" -ms.topic: "conceptual" ms.assetid: 8dd6909b-b070-4afa-9696-f2fc94579c65 --- # How to: Create and use weak_ptr instances diff --git a/docs/cpp/how-to-design-for-exception-safety.md b/docs/cpp/how-to-design-for-exception-safety.md index 8d6a8c270d3..588c564ebd8 100644 --- a/docs/cpp/how-to-design-for-exception-safety.md +++ b/docs/cpp/how-to-design-for-exception-safety.md @@ -3,7 +3,6 @@ description: "Learn more about: How to: Design for exception safety" title: "How to: Design for exception safety" ms.custom: "how-to" ms.date: "11/19/2019" -ms.topic: "conceptual" ms.assetid: 19ecc5d4-297d-4c4e-b4f3-4fccab890b3d --- # How to: Design for exception safety diff --git a/docs/cpp/how-to-interface-between-exceptional-and-non-exceptional-code.md b/docs/cpp/how-to-interface-between-exceptional-and-non-exceptional-code.md index 75d4de49348..2c4f1b4b128 100644 --- a/docs/cpp/how-to-interface-between-exceptional-and-non-exceptional-code.md +++ b/docs/cpp/how-to-interface-between-exceptional-and-non-exceptional-code.md @@ -3,7 +3,6 @@ description: "Learn more about: How to: Interface between exceptional and non-ex title: "How to: Interface between exceptional and non-exceptional code" ms.custom: "how-to" ms.date: 03/02/2022 -ms.topic: "conceptual" --- # How to: Interface between exceptional and non-exceptional code diff --git a/docs/cpp/hybrid-patchable.md b/docs/cpp/hybrid-patchable.md new file mode 100644 index 00000000000..49dc470455b --- /dev/null +++ b/docs/cpp/hybrid-patchable.md @@ -0,0 +1,49 @@ +--- +description: "Learn more about: hybrid_patchable (C++)" +title: "hybrid_patchable (C++)" +ms.date: 1/15/2025 +f1_keywords: ["hybrid_patchable"] +helpviewer_keywords: ["__declspec keyword [C++], hybrid_patchable", "hybrid_patchable __declspec keyword"] +--- +# `hybrid_patchable` (C++) + +**Microsoft Specific** + +Use `__declspec(hybrid_patchable)` to mark a function as a hybrid patchable function. This attribute generates a fast-forward sequence. Fast-forward sequences are small x64 functions which contain no real logic, and tail-call the real Arm64EC function. Because fast-forward sequences are primarily used for hooking, if they are unaltered, execution is transferred directly to the Arm64EC function. + +## Syntax + +> `__declspec(hybrid_patchable)` + +## Remarks + +`__declspec(hybrid_patchable)` is an ARM64EC-only feature. + +**Example:** + +```cpp +__declspec(hybrid_patchable) int Example() +{ + return 1; +} +``` + +Generates the following fast-forward sequence: + +``` +EXP+#Example: + 00000001400CE000: 48 8B C4 mov rax,rsp + 00000001400CE003: 48 89 58 20 mov qword ptr [rax+20h],rbx + 00000001400CE007: 55 push rbp + 00000001400CE008: 5D pop rbp + 00000001400CE009: E9 BA 7A F3 FF jmp #Example + 00000001400CE00E: CC int 3 + 00000001400CE00F: CC int 3 +``` + +**END Microsoft Specific** + +## See also + +[`__declspec`](../cpp/declspec.md)\ +[Fast-Forward sequences](/windows/arm/arm64ec-abi#fast-forward-sequences) \ No newline at end of file diff --git a/docs/cpp/import-export-module.md b/docs/cpp/import-export-module.md index 349708fa551..360717d20f8 100644 --- a/docs/cpp/import-export-module.md +++ b/docs/cpp/import-export-module.md @@ -1,13 +1,13 @@ --- title: "module, import, export" -ms.date: 02/14/2022 +description: Use import and export declarations to access and to publish types and functions defined in the specified module. +ms.date: 02/13/2025 f1_keywords: ["module_cpp", "import_cpp", "export_cpp"] helpviewer_keywords: ["modules [C++]", "modules [C++], import", "modules [C++], export"] -description: Use import and export declarations to access and to publish types and functions defined in the specified module. --- # `module`, `import`, `export` -The **`module`**, **`import`**, and **`export`** declarations are available in C++20 and require the [`/experimental:module`](../build/reference/experimental-module.md) compiler switch along with [`/std:c++20`](../build/reference/std-specify-language-standard-version.md) or later (such as **`/std:c++latest`**). For more information, see [Overview of modules in C++](modules-cpp.md). +The **`module`**, **`import`**, and **`export`** declarations are available in C++20 and require the compiler switch [`/std:c++20`](../build/reference/std-specify-language-standard-version.md) or later. For more information, see [Overview of modules in C++](modules-cpp.md). ## `module` @@ -19,7 +19,7 @@ module ModuleA; ## `export` -Use an **`export module`** declaration for the module's primary interface file, which must have extension *`.ixx`*: +Use an **`export module`** declaration for the module's primary interface file, which has an extension *`.ixx`* by default. If you want to use a different extension, use the [/interface](../build/reference/interface.md) switch to compile it as a module interface. ```cpp export module ModuleA; @@ -40,11 +40,9 @@ namespace ModuleA_NS } ``` -Non-exported names aren't visible to code that imports the module: +Nonexported names aren't visible to code that imports the module: ```cpp -//MyProgram.cpp - import ModuleA; int main() { @@ -64,9 +62,8 @@ Use an **`import`** declaration to make a module's names visible in your program module ModuleA; #include "custom-lib.h" -import std.core; -import std.regex; -import ModuleB; +import std; +import myModule; // begin declarations here: template @@ -112,6 +109,7 @@ import // Always an identifier, never a keyword **End Microsoft Specific** -## See Also +## See also -[Overview of modules in C++](modules-cpp.md) +[Overview of modules in C++](modules-cpp.md)\ +[Import the C++ standard library using modules](tutorial-import-stl-named-module.md) \ No newline at end of file diff --git a/docs/cpp/inheritance-cpp.md b/docs/cpp/inheritance-cpp.md index c024fafdcf2..14660d3866f 100644 --- a/docs/cpp/inheritance-cpp.md +++ b/docs/cpp/inheritance-cpp.md @@ -1,50 +1,54 @@ --- -description: "Learn more about: Inheritance (C++)" -title: "Inheritance (C++)" +title: "Inheritance (C++)" +description: "Learn more about: Inheritance (C++)" ms.date: "11/04/2016" helpviewer_keywords: ["derived classes [C++]", "derived classes [C++], about derived classes", "classes [C++], derived"] -ms.assetid: 3534ca19-d9ed-4a40-be1b-b921ad0e6956 --- -# Inheritance (C++) +# Inheritance (C++) This section explains how to use derived classes to produce extensible programs. ## Overview -New classes can be derived from existing classes using a mechanism called "inheritance" (see the information beginning in [Single Inheritance](../cpp/single-inheritance.md)). Classes that are used for derivation are called "base classes" of a particular derived class. A derived class is declared using the following syntax: +New classes can be derived from existing classes using a mechanism called "inheritance" (see the information beginning in [Single Inheritance](single-inheritance.md)). Classes that are used for derivation are called "base classes" of a particular derived class. A derived class is declared using the following syntax: ```cpp -class Derived : [virtual] [access-specifier] Base +class DerivedSingleBase : [virtual] [access-specifier] Base { - // member list + // member list }; -class Derived : [virtual] [access-specifier] Base1, - [virtual] [access-specifier] Base2, . . . + +class DerivedMultipleBases : [virtual] [access-specifier] Base1, + [virtual] [access-specifier] Base2, ... { - // member list + // member list }; ``` -After the tag (name) for the class, a colon appears followed by a list of base specifications. The base classes so named must have been declared previously. The base specifications may contain an access specifier, which is one of the keywords **`public`**, **`protected`** or **`private`**. These access specifiers appear before the base class name and apply only to that base class. These specifiers control the derived class's permission to use to members of the base class. See [Member-Access Control](../cpp/member-access-control-cpp.md) for information on access to base class members. If the access specifier is omitted, the access to that base is considered **`private`**. The base specifications may contain the keyword **`virtual`** to indicate virtual inheritance. This keyword may appear before or after the access specifier, if any. If virtual inheritance is used, the base class is referred to as a virtual base class. +After the tag (name) for the class, a colon appears followed by a list of base specifications. The base classes so named must have been declared previously. The base specifications may contain an access specifier, which is one of the keywords [**`public`**](public-cpp.md), [**`protected`**](protected-cpp.md) or [**`private`**](private-cpp.md). These access specifiers appear before the base class name and apply only to that base class. These specifiers control the derived class's permission to use members of the base class. See [Member-Access Control](member-access-control-cpp.md) for information on access to base class members. If the access specifier is omitted, the access to that base is considered **`private`**. The base specifications may contain the keyword [**`virtual`**](virtual-cpp.md) to indicate virtual inheritance. This keyword may appear before or after the access specifier, if any. If virtual inheritance is used, the base class is referred to as a virtual base class. -Multiple base classes can be specified, separated by commas. If a single base class is specified, the inheritance model is [Single inheritance](../cpp/single-inheritance.md). If more than one base class is specified, the inheritance model is called [Multiple inheritance](../cpp/multiple-base-classes.md). +Multiple base classes can be specified, separated by commas. If a single base class is specified, the inheritance model is [Single inheritance](single-inheritance.md). If more than one base class is specified, the inheritance model is called [Multiple inheritance](multiple-base-classes.md). The following topics are included: -- [Single inheritance](../cpp/single-inheritance.md) +- [Single inheritance](single-inheritance.md) + +- [Multiple base classes](multiple-base-classes.md) + +- [Virtual functions](virtual-functions.md) -- [Multiple base classes](../cpp/multiple-base-classes.md) +- [Explicit overrides](explicit-overrides-cpp.md) -- [Virtual functions](../cpp/virtual-functions.md) +- [Abstract classes](abstract-classes-cpp.md) -- [Explicit overrides](../cpp/explicit-overrides-cpp.md) +- [Summary of scope rules](summary-of-scope-rules.md) -- [Abstract classes](../cpp/abstract-classes-cpp.md) +**Microsoft Specific** -- [Summary of scope rules](../cpp/summary-of-scope-rules.md) +The [`__super`](super.md) and [`__interface`](interface.md) keywords are documented in this section. -The [__super](../cpp/super.md) and [__interface](../cpp/interface.md) keywords are documented in this section. +**END Microsoft Specific** ## See also -[C++ Language Reference](../cpp/cpp-language-reference.md) +[C++ Language Reference](cpp-language-reference.md) diff --git a/docs/cpp/initializers.md b/docs/cpp/initializers.md index 48c7f624d1f..465e8537f7d 100644 --- a/docs/cpp/initializers.md +++ b/docs/cpp/initializers.md @@ -1,7 +1,7 @@ --- title: "Initializers" -ms.date: "07/29/2019" description: "How to initialize classes, structs, arrays and fundamental types in C++." +ms.date: 07/29/2019 helpviewer_keywords: ["arrays [C++], array-element initializers", "aggregate initializers [C++]"] --- # Initializers @@ -51,8 +51,8 @@ Initializers may take these forms: }; class PointConsumer{ public: - void set_point(Point p){}; - void set_points(initializer_list my_list){}; + void set_point(Point p){} + void set_points(initializer_list my_list){} }; int main() { PointConsumer pc{}; diff --git a/docs/cpp/inline-functions-cpp.md b/docs/cpp/inline-functions-cpp.md index edfd41def2e..f67599ff01b 100644 --- a/docs/cpp/inline-functions-cpp.md +++ b/docs/cpp/inline-functions-cpp.md @@ -1,7 +1,7 @@ --- title: "Inline Functions (C++)" description: "The C++ inline keyword can be used to suggest inline functions to the compiler." -ms.date: 12/07/2023 +ms.date: 02/05/2026 f1_keywords: ["__forceinline_cpp", "__inline_cpp", "inline_cpp", "__inline", "_inline", "__forceinline", "_forceinline"] helpviewer_keywords: ["inline functions [C++], class members"] --- @@ -11,13 +11,47 @@ The **`inline`** keyword suggests that the compiler substitute the code within t In theory, using inline functions can make your program faster because they eliminate the overhead associated with function calls. Calling a function requires pushing the return address on the stack, pushing arguments onto the stack, jumping to the function body, and then executing a return instruction when the function finishes. This process is eliminated by inlining the function. The compiler also has different opportunities to optimize functions expanded inline versus those that aren't. A tradeoff of inline functions is that the overall size of your program can increase. -Inline code substitution is done at the compiler's discretion. For example, the compiler won't inline a function if its address is taken or if the compiler decides it's too large. +Inline code substitution is done at the compiler's discretion. For example, the compiler doesn't inline a function if its address is taken or if the compiler decides it's too large. -A function defined in the body of a class declaration is implicitly an inline function. +## The `inline` keyword and the One Definition Rule (ODR) -## Example +The original meaning of **`inline`** is a hint to the compiler to prefer code expansion at the call site over function call instructions. This remains one of the meanings of **`inline`**. -In the following class declaration, the `Account` constructor is an inline function because it is defined in the body of the class declaration. The member functions `GetBalance`, `Deposit`, and `Withdraw` are specified `inline` in their definitions. The `inline` keyword is optional in the function declarations in the class declaration. +However, the **`inline`** keyword also has implications for the One Definition Rule (ODR). Normally, a function can only be defined once across all translation units. When a function is marked **`inline`**, it can be defined in multiple translation units (typically via a header file) if all the definitions are identical. The linker then selects one definition and discards the duplicates rather than reporting an error. + +This dual nature of **`inline`**—as both an optimization hint and an ODR mechanism—can cause confusion. The ODR aspect is a practical necessity where the same header (containing an inline function definition) may be included in multiple source files. + +## Implicitly inline functions + +Certain functions are implicitly **`inline`** without requiring the keyword: + +- **Functions defined at class scope**: A function defined in the body of a class declaration is implicitly an inline function. This allows small accessor functions and to be defined directly in class definitions without incurring function call overhead—a priority since the early days of C++. + +- **`constexpr` functions**: Functions declared **`constexpr`** (introduced in C++11) are implicitly **`inline`**. Because **`constexpr`** functions are typically defined in header files to allow compile-time evaluation, they must follow the same ODR rules as inline functions. + +- **`consteval` functions**: Functions declared **`consteval`** (introduced in C++20) are implicitly **`inline`**. + +## Inline variables (C++17) + +C++17 extended the **`inline`** keyword to variables. An **`inline`** variable can be defined in multiple translation units, and like inline functions, the linker selects one definition and discards the rest. + +Inline variables are useful for defining constants or static data members in header files: + +```cpp +// constants.h +inline constexpr double pi = 3.14159265358979323846; + +struct MyClass +{ + static inline int instanceCount = 0; // Can be defined in header +}; +``` + +Before C++17, such variables required a separate definition in a single source file to avoid linker errors. + +## Example: Inline class member functions + +In the following class declaration, the `Account` constructor is an inline function because it's defined in the body of the class declaration. The member functions `GetBalance`, `Deposit`, and `Withdraw` are specified **`inline`** in their definitions. The **`inline`** keyword is optional in the function declarations in the class declaration. ```cpp // account.h @@ -60,7 +94,7 @@ inline double Account::Withdraw(double amount) A given inline member function must be declared the same way in every compilation unit. There must be exactly one definition of an inline function. -A class member function defaults to external linkage unless a definition for that function contains the **`inline`** specifier. The preceding example shows that you don't have to declare these functions explicitly with the **`inline`** specifier. Using **`inline`** in the function definition suggests to the compiler that it be treated as an inline function. However, you can't redeclare a function as **`inline`** after a call to that function. +A class member function defaults to external linkage unless a definition for that function contains the **`inline`** specifier. The preceding example shows that you don't have to declare these functions explicitly with the **`inline`** specifier. Using **`inline`** in the function definition suggests to the compiler to treat it as an inline function. However, you can't redeclare a function as **`inline`** after a call to that function. ## `inline`, `__inline`, and `__forceinline` @@ -68,11 +102,11 @@ The **`inline`** and **`__inline`** specifiers suggest to the compiler that it i The insertion, called *inline expansion* or *inlining*, occurs only if the compiler's own cost-benefit analysis shows it's worthwhile. Inline expansion minimizes the function-call overhead at the potential cost of larger code size. -The **`__forceinline`** keyword overrides the cost-benefit analysis and relies on the judgment of the programmer instead. Exercise caution when using **`__forceinline`**. Indiscriminate use of **`__forceinline`** can result in larger code with only marginal performance gains or, in some cases, even performance losses (because of the increased paging of a larger executable, for example). +The **`__forceinline`** keyword (or [`[msvc::forceinline]`](/cpp/cpp/attributes#msvcforceinline) attribute) overrides the cost-benefit analysis and relies on the judgment of the programmer instead. Exercise caution when using **`__forceinline`**. Indiscriminate use of **`__forceinline`** can result in larger code with only marginal performance gains or, in some cases, even performance losses (because of the increased paging of a larger executable, for example). The compiler treats the inline expansion options and keywords as suggestions. There's no guarantee that functions will be inlined. You can't force the compiler to inline a particular function, even with the **`__forceinline`** keyword. When you compile with **`/clr`**, the compiler won't inline a function if there are security attributes applied to the function. -For compatibility with previous versions, **`_inline`** and **`_forceinline`** are synonyms for **`__inline`** and **`__forceinline`**, respectively, unless compiler option [`/Za` \(Disable language extensions)](../build/reference/za-ze-disable-language-extensions.md) is specified. +For compatibility with previous versions, **`_inline`** and **`_forceinline`** are synonyms for **`__inline`** and **`__forceinline`** (two leading underscores), respectively, unless compiler option [`/Za` \(Disable language extensions)](../build/reference/za-ze-disable-language-extensions.md) is specified. The **`inline`** keyword tells the compiler that inline expansion is preferred. However, the compiler can ignore it. Two cases where this behavior can happen are: @@ -140,6 +174,18 @@ If the compiler can't inline a function declared with **`__forceinline`**, it ge Recursive functions can be replaced with inline code to a depth specified by the [`inline_depth`](../preprocessor/inline-depth.md) pragma, up to a maximum of 16 calls. After that depth, recursive function calls are treated as calls to an instance of the function. The depth to which recursive functions are examined by the inline heuristic can't exceed 16. The [`inline_recursion`](../preprocessor/inline-recursion.md) pragma controls the inline expansion of a function currently under expansion. See the [Inline-Function Expansion](../build/reference/ob-inline-function-expansion.md) (/Ob) compiler option for related information. +The C++ Standard defines a common set of attributes. It also allows compiler vendors to define their own attributes within a vendor-specific (in our case, `msvc`) namespace. The following Microsoft-specific attributes can be used to control inlining behavior: + +## Microsoft-specific attributes for controlling inlining behavior + +|Attribute | Meaning | +|---------|---------| +| [`[msvc::forceinline]`](/cpp/cpp/attributes#msvcforceinline)| Has the same meaning as **`__forceinline`**.| +| [`[msvc::forceinline_calls]`](/cpp/cpp/attributes#msvcforceinline_calls) | Can be placed on or before a statement or block to cause the inline heuristic to force-inline all calls in that statement or block.| +| [`[msvc::flatten]`](/cpp/cpp/attributes#msvcflatten) | Similar to `[[msvc::forceinline_calls]]`, but recursively force-inlines all calls in the scope it's applied to until no calls are left. | +| [`[msvc::noinline]`](/cpp/cpp/attributes#msvcnoinline) | When placed before a function declaration, has the same meaning as `__declspec(noinline)`. | +| [`[msvc::noinline_calls]`](/cpp/cpp/attributes#msvcnoinline_calls) | Can be placed before any statement or block to turn off inlining for all calls in the scope it's applied to. | + **END Microsoft Specific** For more information on using the **`inline`** specifier, see: @@ -228,8 +274,8 @@ int main() Here are some of the differences between the macro and the inline function: -- Macros are always expanded inline. However, an inline function is only inlined when the compiler determines it is the optimal thing to do. -- The macro may result in unexpected behavior, which can lead to subtle bugs. For example, the expression `mult1(2 + 2, 3 + 3)` expands to `2 + 2 * 3 + 3` which evaluates to 11, but the expected result is 24. A seemingly valid fix is to add parentheses around both arguments of the function macro, resulting in `#define mult2(a, b) (a) * (b)`, which will solve the issue at hand but can still cause surprising behavior when part of a larger expression. That was demonstrated in the preceding example, and the problem could be addressed by defining the macro as such `#define mult3(a, b) ((a) * (b))`. +- Macros are always expanded inline. However, an inline function is only inlined when the compiler determines it's the optimal thing to do. +- The macro may result in unexpected behavior, which can lead to subtle bugs. For example, the expression `mult1(2 + 2, 3 + 3)` expands to `2 + 2 * 3 + 3` which evaluates to 11, but the expected result is 24. A seemingly valid fix is to add parentheses around both arguments of the function macro, resulting in `#define mult2(a, b) (a) * (b)`, which solves the issue at hand but can still cause surprising behavior when part of a larger expression. That was demonstrated in the preceding example, and the problem could be addressed by defining the macro as such `#define mult3(a, b) ((a) * (b))`. - An inline function is subject to semantic processing by the compiler, whereas the preprocessor expands macros without that same benefit. Macros aren't type-safe, whereas functions are. - Expressions passed as arguments to inline functions are evaluated once. In some cases, expressions passed as arguments to macros can be evaluated more than once. For example, consider the following: @@ -272,4 +318,9 @@ In this example, the function `increment` is called twice as the expression `sqr ## See also [`noinline`](../cpp/noinline.md)\ -[`auto_inline`](../preprocessor/auto-inline.md) +[`auto_inline`](../preprocessor/auto-inline.md)\ +[`[msvc::forceinline]`](/cpp/cpp/attributes#msvcforceinline)\ +[`[msvc::forceinline_calls]`](/cpp/cpp/attributes#msvcforceinline_calls)\ +[`[msvc::flatten]`](/cpp/cpp/attributes#msvcflatten)\ +[`[msvc::nolinline]`](/cpp/cpp/attributes#msvcnoinline)\ +[`[msvc::nolinline_calls]`](/cpp/cpp/attributes#msvcnoinline_calls) \ No newline at end of file diff --git a/docs/cpp/keywords-cpp.md b/docs/cpp/keywords-cpp.md index 5c0b32ebdac..0bb5fff6c04 100644 --- a/docs/cpp/keywords-cpp.md +++ b/docs/cpp/keywords-cpp.md @@ -4,7 +4,6 @@ description: "Lists the C++ standard language keywords, Microsoft-specific keywo ms.custom: "index-page" ms.date: 07/25/2020 helpviewer_keywords: ["keywords [C++]"] -ms.assetid: d7ca94a8-f785-41ce-9f73-d3c4fd508489 --- # Keywords (C++) @@ -79,7 +78,7 @@ Keywords are predefined reserved identifiers that have special meanings. They ca [`private`](private-cpp.md)\ [`protected`](protected-cpp.md)\ [`public`](public-cpp.md)\ - [`register`](storage-classes-cpp.md#register) + [`register`](storage-classes-cpp.md#register)\ [`reinterpret_cast`](reinterpret-cast-operator.md)\ **`requires`** c\ [`return`](return-statement-cpp.md)\ @@ -287,5 +286,5 @@ These identifiers are extended attributes for the **`__declspec`** modifier. The ## See also -[Lexical conventions](lexical-conventions.md)
+[Lexical conventions](lexical-conventions.md)\ [C++ built-in operators, precedence, and associativity](cpp-built-in-operators-precedence-and-associativity.md) diff --git a/docs/cpp/lvalues-and-rvalues-visual-cpp.md b/docs/cpp/lvalues-and-rvalues-visual-cpp.md index 0fb47aa4e20..ad2e8ebae47 100644 --- a/docs/cpp/lvalues-and-rvalues-visual-cpp.md +++ b/docs/cpp/lvalues-and-rvalues-visual-cpp.md @@ -27,7 +27,7 @@ An lvalue has an address that your program can access. Examples of lvalue expres A prvalue expression has no address that is accessible by your program. Examples of prvalue expressions include literals, function calls that return a nonreference type, and temporary objects that are created during expression evaluation but accessible only by the compiler. -An xvalue expression has an address that no longer accessible by your program but can be used to initialize an rvalue reference, which provides access to the expression. Examples include function calls that return an rvalue reference, and the array subscript, member and pointer to member expressions where the array or object is an rvalue reference. +An xvalue expression has an address that is no longer accessible by your program but can be used to initialize an rvalue reference, which provides access to the expression. Examples include function calls that return an rvalue reference, and the array subscript, member and pointer to member expressions where the array or object is an rvalue reference. ## Example diff --git a/docs/cpp/m64.md b/docs/cpp/m64.md index 74c415036ca..66800090f64 100644 --- a/docs/cpp/m64.md +++ b/docs/cpp/m64.md @@ -1,12 +1,11 @@ --- -description: "Learn more about: __m64" title: "__m64" +description: "Learn more about: __m64" ms.date: "11/04/2016" f1_keywords: ["__m64_cpp"] helpviewer_keywords: ["__m64 keyword [C++]"] -ms.assetid: df0410e8-67c9-4954-88c8-fe2653575252 --- -# __m64 +# `__m64` **Microsoft Specific** @@ -15,9 +14,10 @@ The **`__m64`** data type is for use with the MMX and 3DNow! intrinsics, and is ```cpp // data_types__m64.cpp #include + int main() { - __m64 x; + __m64 x; } ``` @@ -25,14 +25,14 @@ int main() You should not access the **`__m64`** fields directly. You can, however, see these types in the debugger. A variable of type **`__m64`** maps to the MM[0-7] registers. -Variables of type **_m64** are automatically aligned on 8-byte boundaries. +Variables of type **`__m64`** are automatically aligned on 8-byte boundaries. -The **`__m64`** data type is not supported on x64 processors. Applications that use __m64 as part of MMX intrinsics must be rewritten to use equivalent SSE and SSE2 intrinsics. +The **`__m64`** data type is not supported on x64 processors. Applications that use **`__m64`** as part of MMX intrinsics must be rewritten to use equivalent SSE and SSE2 intrinsics. **END Microsoft Specific** ## See also -[Keywords](../cpp/keywords-cpp.md)
-[Built-in types](../cpp/fundamental-types-cpp.md)
-[Data Type Ranges](../cpp/data-type-ranges.md) +[Keywords](keywords-cpp.md)\ +[Built-in types](fundamental-types-cpp.md)\ +[Data Type Ranges](data-type-ranges.md) diff --git a/docs/cpp/microsoft-specific-modifiers.md b/docs/cpp/microsoft-specific-modifiers.md index 3d8fc865625..fda7e966152 100644 --- a/docs/cpp/microsoft-specific-modifiers.md +++ b/docs/cpp/microsoft-specific-modifiers.md @@ -1,8 +1,7 @@ --- -description: "Learn more about: Microsoft-specific modifiers" title: "Microsoft-specific modifiers" +description: "Learn more about: Microsoft-specific modifiers" ms.date: "08/16/2018" -ms.assetid: 22c7178c-f854-47fa-9de6-07d23fda58e1 --- # Microsoft-specific modifiers @@ -29,7 +28,7 @@ Many of the Microsoft-specific keywords can be used to modify declarators to for |[__restrict](extension-restrict.md)|Similar to __declspec([restrict](restrict.md)), but for use on variables.|No| |[__stdcall](stdcall.md)|The name that follows specifies a function that observes the standard calling convention.|Yes| |[__w64](w64.md)|Marks a data type as being larger on a 64-bit compiler.|No| -|[__unaligned](unaligned.md)|Specifies that a pointer to a type or other data is not aligned..|No| +|[__unaligned](unaligned.md)|Specifies that a pointer to a type or other data is not aligned.|No| |[__vectorcall](vectorcall.md)|The name that follows declares a function that uses registers, including SSE registers, when available, instead of the stack for argument passing.|Yes| ## See also diff --git a/docs/cpp/modules-cpp.md b/docs/cpp/modules-cpp.md index bfdbfb73467..333beca9b52 100644 --- a/docs/cpp/modules-cpp.md +++ b/docs/cpp/modules-cpp.md @@ -1,12 +1,12 @@ --- title: "Overview of modules in C++" -ms.date: 01/29/2024 -helpviewer_keywords: ["modules [C++]", "modules [C++], overview"] description: Modules in C++20 provide a modern alternative to header files. +ms.date: 04/17/2025 +helpviewer_keywords: ["modules [C++]", "modules [C++], overview"] --- # Overview of modules in C++ -C++20 introduces *modules*. A *module* is a set of source code files that are compiled independently of the source files (or more precisely, the [translation units](https://wikipedia.org/wiki/Translation_unit_(programming)) that import them. +C++20 introduces *modules*. A *module* is a set of source code files that are compiled independently of the source files (or more precisely, the [translation units](https://wikipedia.org/wiki/Translation_unit_(programming))) that import them. Modules eliminate or reduce many of the problems associated with the use of header files. They often reduce compilation times, sometimes significantly. Macros, preprocessor directives, and nonexported names declared in a module aren't visible outside the module. They have no effect on the compilation of the translation unit that imports the module. You can import modules in any order without concern for macro redefinitions. Declarations in the importing translation unit don't participate in overload resolution or name lookup in the imported module. After a module is compiled once, the results are stored in a binary file that describes all the exported types, functions, and templates. The compiler can process that file much faster than a header file. And, the compiler can reuse it every place where the module is imported in a project. @@ -14,44 +14,15 @@ You can use modules side by side with header files. A C++ source file can `impor To contrast modules with other ways to import the standard library, see [Compare header units, modules, and precompiled headers](../build/compare-inclusion-methods.md). -## Enable modules in the Microsoft C++ compiler - -As of Visual Studio 2022 version 17.1, C++20 standard modules are fully implemented in the Microsoft C++ compiler. - -Before it was specified by the C++20 standard, Microsoft had experimental support for modules. The compiler also supported importing prebuilt Standard Library modules, described below. - -Starting with Visual Studio 2022 version 17.5, importing the Standard Library as a module is both standardized and fully implemented in the Microsoft C++ compiler. This section describes the older, experimental method, which is still supported. For information about the new standardized way to import the Standard Library using modules, see [Import the C++ standard library using modules](tutorial-import-stl-named-module.md). +Starting with Visual Studio 2022 version 17.5, importing the Standard Library as a module is both standardized and fully implemented in the Microsoft C++ compiler. To learn how to import the Standard Library using modules, see [Import the C++ standard library using modules](tutorial-import-stl-named-module.md). -You can use the modules feature to create single-partition modules and to import the Standard Library modules provided by Microsoft. To enable support for Standard Library modules, compile with [`/experimental:module`](../build/reference/experimental-module.md) and [`/std:c++latest`](../build/reference/std-specify-language-standard-version.md). In a Visual Studio project, right-click the project node in **Solution Explorer** and choose **Properties**. Set the **Configuration** drop-down to **All Configurations**, then choose **Configuration Properties** > **C/C++** > **Language** > **Enable C++ Modules (experimental)**. +## Single-partition modules -A module and the code that consumes it must be compiled with the same compiler options. +A single-partition module is a module that consists of a single source file. The module interface and implementation are in the same file. -## Consume C++ Standard Library as modules (experimental) +The following single-partition module example shows a simple module definition in a source file called *`Example.ixx`*. The *`.ixx`* extension is the default extension for module interface files in Visual Studio. If you want to use a different extension, use the [/interface](../build/reference/interface.md) switch to compile it as a module interface. In this example, the interface file contains both the function definition and the declaration. You can also place the definitions in one or more separate module implementation files, as shown in a later example, but this is an example of a single-partition module. -This section describes the experimental implementation, which is still supported. The new standardized way of consuming the C++ Standard Library as modules is described in [Import the C++ standard library using modules](tutorial-import-stl-named-module.md). - -By importing the C++ Standard Library as modules rather than including it through header files, you can potentially speed up compilation times depending on the size of your project. The experimental library is split into the following named modules: - -- `std.regex` provides the content of header `` -- `std.filesystem` provides the content of header `` -- `std.memory` provides the content of header `` -- `std.threading` provides the contents of headers ``, ``, ``, ``, ``, and `` -- `std.core` provides everything else in the C++ Standard Library - -To consume these modules, add an import declaration to the top of the source code file. For example: - -```cpp -import std.core; -import std.regex; -``` - -To consume the Microsoft Standard Library modules, compile your program with the [`/EHsc`](../build/reference/eh-exception-handling-model.md) and [`/MD`](../build/reference/md-mt-ld-use-run-time-library.md) options. - -## Example - -The following example shows a simple module definition in a source file called *`Example.ixx`*. The *`.ixx`* extension is required for module interface files in Visual Studio. In this example, the interface file contains both the function definition and the declaration. However, you can also place the definitions in one or more separate module implementation files, as shown in a later example. - -The `export module Example;` statement indicates that this file is the primary interface for a module called `Example`. The **`export`** modifier on `f()` indicates that this function is visible when another program or module imports `Example`. +The `export module Example;` statement indicates that this file is the primary interface for a module called `Example`. The **`export`** modifier before `int f()` indicates that this function is visible when another program or module imports `Example`: ```cpp // Example.ixx @@ -61,12 +32,14 @@ export module Example; namespace Example_NS { - int f_internal() { - return ANSWER; - } + int f_internal() + { + return ANSWER; + } - export int f() { - return f_internal(); + export int f() + { + return f_internal(); } } ``` @@ -75,8 +48,8 @@ The file *`MyProgram.cpp`* uses **`import`** to access the name exported by `Exa ```cpp // MyProgram.cpp +import std; import Example; -import std.core; using namespace std; @@ -88,7 +61,7 @@ int main() } ``` -The `import` declaration can appear only at global scope. +The `import` declaration can appear only at global scope. A module and the code that consumes it must be compiled with the same compiler options. ## Module grammar @@ -133,15 +106,16 @@ The **`export`** keyword is only used in interface files. An implementation file The rules for namespaces in modules are the same as any other code. If a declaration within a namespace is exported, the enclosing namespace (excluding members that aren't explicitly exported in that namespace) is also implicitly exported. If a namespace is explicitly exported, all declarations within that namespace definition are exported. -When the compiler does argument-dependent lookup for overload resolutions in the importing translation unit, it considers functions declared in the same translation unit (including module interfaces) as where the type of the function's arguments are defined. +When the compiler does argument-dependent lookup for overload resolution in the importing translation unit, it considers functions declared in the same translation unit (including module interfaces) as where the type of the function's arguments is defined. ### Module partitions A module partition is similar to a module, except: + - It shares ownership of all declarations in the entire module. - All names exported by partition interface files are imported and exported by the primary interface file. - A partition's name must begin with the module name followed by a colon (`:`). -- Declarations in any of the partitions are visible within the entire module.\ +- Declarations in any of the partitions are visible within the entire module. - No special precautions are needed to avoid one-definition-rule (ODR) errors. You can declare a name (function, class, and so on) in one partition and define it in another. A partition implementation file begins like this, and is an internal partition from a C++ standards perspective: @@ -182,7 +156,7 @@ You can include header files in a module source file by putting an `#include` di #include "customlib.h" #include "anotherlib.h" -import std.core; +import std; import MyModuleB; //... rest of file @@ -192,9 +166,10 @@ You can use a traditional header file to control which modules are imported: ```cpp // MyProgram.h -import std.core; -#ifdef DEBUG_LOGGING -import std.filesystem; +#ifdef C_RUNTIME_GLOBALS +import std.compat; +#else +import std; #endif ``` @@ -209,6 +184,7 @@ import "myheader.h"; ## See also +[Import the C++ standard library using modules](tutorial-import-stl-named-module.md)\ [`module`, `import`, `export`](import-export-module.md)\ [Named modules tutorial](tutorial-named-modules-cpp.md)\ [Compare header units, modules, and precompiled headers](../build/compare-inclusion-methods.md) diff --git a/docs/cpp/multiple-base-classes.md b/docs/cpp/multiple-base-classes.md index d792657cd24..26bdbee6881 100644 --- a/docs/cpp/multiple-base-classes.md +++ b/docs/cpp/multiple-base-classes.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: Multiple Base Classes" title: "Multiple Base Classes" -ms.date: "11/19/2018" +description: "Learn more about: Multiple Base Classes" +ms.date: 11/19/2018 helpviewer_keywords: ["base classes [C++], multiple", "derived classes [C++], multiple bases", "multiple inheritance, class declaration", "multiple base classes [C++]"] --- # Multiple Base Classes @@ -11,8 +11,7 @@ A class can be derived from more than one base class. In a multiple-inheritance ```cpp // deriv_MultipleBaseClasses.cpp // compile with: /LD -class Collection { -}; +class Collection {}; class Book {}; class CollectionOfBook : public Book, public Collection { // New members @@ -26,7 +25,7 @@ The order in which base classes are specified isn't significant except in certai - The order in which destructors are invoked to clean up. Again, if a particular "part" of the class must be present when the other part is being destroyed, the order is significant. Destructors are called in the reverse order of the classes specified in the *base-list*. > [!NOTE] - > The order of specification of base classes can affect the memory layout of the class. Do not make any programming decisions based on the order of base members in memory. + > The order of specification of base classes can affect the memory layout of the class. Do not make any programming decisions based on the order of base members in memory. When specifying the *base-list*, you can't specify the same class name more than once. However, it's possible for a class to be an indirect base to a derived class more than once. @@ -42,14 +41,14 @@ When declaring a virtual base class, the **`virtual`** keyword appears in the ba Consider the class hierarchy in the following figure, which illustrates a simulated lunch line: -:::image type="complex" source="../cpp/media/vc38xp1.gif" alt-text="Diagram of a simulated lunch line." border="false"::: +:::image type="complex" source="media/vc38xp1.gif" alt-text="Diagram of a simulated lunch line." border="false"::: The base class is Queue. Cashier Queue and Lunch Queue both inherit from Queue. Finally, Lunch Cashier Queue inherits from both Cashier Queue and Lunch Queue. :::image-end::: *Simulated lunch-line graph* In the figure, `Queue` is the base class for both `CashierQueue` and `LunchQueue`. However, when both classes are combined to form `LunchCashierQueue`, the following problem arises: the new class contains two subobjects of type `Queue`, one from `CashierQueue` and the other from `LunchQueue`. The following figure shows the conceptual memory layout (the actual memory layout might be optimized): -:::image type="complex" source="../cpp/media/vc38xp2.gif" alt-text="Diagram of a simulated lunch line object." border="false"::: +:::image type="complex" source="media/vc38xp2.gif" alt-text="Diagram of a simulated lunch line object." border="false"::: The figure shows a Lunch Cashier Queue object with two subobjects in it: Cashier Queue and Lunch Queue. Both Cashier Queue and Lunch Queue contain a Queue subobject." :::image-end::: *Simulated lunch-line object* @@ -67,21 +66,21 @@ class LunchCashierQueue : public LunchQueue, public CashierQueue {}; The **`virtual`** keyword ensures that only one copy of the subobject `Queue` is included (see the following figure). -:::image type="complex" source="../cpp/media/vc38xp3.gif" alt-text="Diagram of a simulated lunch line object, with virtual base classes depicted." border="false"::: +:::image type="complex" source="media/vc38xp3.gif" alt-text="Diagram of a simulated lunch line object, with virtual base classes depicted." border="false"::: The diagram shows a Lunch Cashier Queue object, which contains a Cashier Queue subobject and a Lunch Queue subobject. Both Cashier Queue and Lunch Queue share the same Queue subobject. :::image-end::: *Simulated lunch-line object with virtual base classes* A class can have both a virtual component and a nonvirtual component of a given type. This happens in the conditions illustrated in the following figure: -:::image type="complex" source="../cpp/media/vc38xp4.gif" alt-text="Diagram of virtual and non virtual components of a class." border="false"::: +:::image type="complex" source="media/vc38xp4.gif" alt-text="Diagram of virtual and non virtual components of a class." border="false"::: The diagram shows a queue base class. A Cashier Queue class and Lunch Queue class inherit virtually from Queue. A third class, Takeout Queue, inherits non virtually from queue. Lunch Cashier Queue inherits from both Cashier Queue and Lunch Queue. Lunch Takeout Cashier Queue inherits from both Lunch Cashier Queue and Takeout Queue. :::image-end::: *Virtual and nonvirtual components of the same class* In the figure, `CashierQueue` and `LunchQueue` use `Queue` as a virtual base class. However, `TakeoutQueue` specifies `Queue` as a base class, not a virtual base class. Therefore, `LunchTakeoutCashierQueue` has two subobjects of type `Queue`: one from the inheritance path that includes `LunchCashierQueue` and one from the path that includes `TakeoutQueue`. This is illustrated in the following figure. -:::image type="complex" source="../cpp/media/vc38xp5.gif" alt-text="Diagram of the object layout for virtual and non virtual inheritance." border="false"::: +:::image type="complex" source="media/vc38xp5.gif" alt-text="Diagram of the object layout for virtual and non virtual inheritance." border="false"::: A Lunch Takeout Cashier Queue object is shown that contains two subobjects: a Takeout Queue (which contains a Queue subobject) and a Lunch Cashier Queue. The Lunch Cashier Queue subobject contains a Cashier Queue subobject and a Lunch Queue subobject, both of which share a Queue sub object. :::image-end::: *Object layout with virtual and nonvirtual inheritance* @@ -96,7 +95,7 @@ The `/vd` compiler option affects an entire compilation module. Use the `vtordis ```cpp #pragma vtordisp( off ) class GetReal : virtual public { ... }; -\#pragma vtordisp( on ) +#pragma vtordisp( on ) ``` ## Name ambiguities @@ -142,7 +141,7 @@ The compiler detects ambiguities by performing tests in this order: 1. If overloaded functions are unambiguous, they're resolved. -1. If access to the name violates member-access permission, an error message is generated. (For more information, see [Member-Access Control](../cpp/member-access-control-cpp.md).) +1. If access to the name violates member-access permission, an error message is generated. For more information, see [Member-Access Control](member-access-control-cpp.md). When an expression produces an ambiguity through inheritance, you can manually resolve it by qualifying the name in question with its class name. To make the preceding example compile properly with no ambiguities, use code such as: @@ -157,7 +156,7 @@ pc->B::a(); ### Dominance -it's possible for more than one name (function, object, or enumerator) to be reached through an inheritance graph. Such cases are considered ambiguous with nonvirtual base classes. They're also ambiguous with virtual base classes, unless one of the names "dominates" the others. +It's possible for more than one name (function, object, or enumerator) to be reached through an inheritance graph. Such cases are considered ambiguous with nonvirtual base classes. They're also ambiguous with virtual base classes, unless one of the names "dominates" the others. A name dominates another name if it's defined in both classes and one class is derived from the other. The dominant name is the name in the derived class; this name is used when an ambiguity would otherwise have arisen, as shown in the following example: @@ -188,11 +187,11 @@ Explicit and implicit conversions from pointers or references to class types can - The declaration of an object of type `D`. -- The effect of applying the address-of operator (**&**) to that object. The address-of operator always supplies the base address of the object. +- The effect of applying the address-of operator (`&`) to that object. The address-of operator always supplies the base address of the object. - The effect of explicitly converting the pointer obtained using the address-of operator to the base-class type `A`. Coercing the address of the object to type `A*` doesn't always provide the compiler with enough information as to which subobject of type `A` to select; in this case, two subobjects exist. -:::image type="complex" source="../cpp/media/vc38xt1.gif" alt-text="Diagram showing how the conversion of pointers to base classes can be ambiguous." border="false"::: +:::image type="complex" source="media/vc38xt1.gif" alt-text="Diagram showing how the conversion of pointers to base classes can be ambiguous." border="false"::: The diagram first shows an inheritance hierarchy: A is the base class. B and C inherit from A. D inherits from B and C. Then, the memory layout is shown for object D. There are three subobjects in D: B (which includes a subobject A) and C (which includes a subobject A). The code & d points to the A in subobject B. The code ( * A ) & d points to both subobject B and subobject C. :::image-end::: *Ambiguous conversion of pointers to base classes* @@ -210,7 +209,7 @@ If virtual base classes are used, functions, objects, types, and enumerators can The following figure shows how objects are composed using virtual and nonvirtual inheritance. -:::image type="complex" source="../cpp/media/vc38xr1.gif" alt-text="Diagram showing virtual derivation and nonvirtual derivation." border="false"::: +:::image type="complex" source="media/vc38xr1.gif" alt-text="Diagram showing virtual derivation and nonvirtual derivation." border="false"::: The diagram first shows an inheritance hierarchy: A is the base class. B and C virtually inherit from A. D virtually inherits from B and C. Then, the layout of D is shown. D contains subobjects B and C, which share subobject A. Then the layout is shown as though the same hierarchy had been derived using nonvirtual inheritance. In that case, D contains the subobjects B and C. Both B and C contain their own copy of subobject A. :::image-end::: *Virtual and nonvirtual derivation* @@ -219,4 +218,4 @@ In the figure, accessing any member of class `A` through nonvirtual base classes ## See also -[Inheritance](../cpp/inheritance-cpp.md) +[Inheritance](inheritance-cpp.md) diff --git a/docs/cpp/nothrow-cpp.md b/docs/cpp/nothrow-cpp.md index b0749a32f4c..fd5ebc478b4 100644 --- a/docs/cpp/nothrow-cpp.md +++ b/docs/cpp/nothrow-cpp.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: nothrow (C++)" title: "nothrow (C++)" -ms.date: "01/03/2018" +description: "Learn more about: nothrow (C++)" +ms.date: 01/03/2018 f1_keywords: ["nothrow_cpp"] helpviewer_keywords: ["__declspec keyword [C++], nothrow", "nothrow __declspec keyword"] -ms.assetid: 0a475139-459c-4ec6-99e8-7ecd0d7f44a3 --- # `nothrow` (C++) @@ -20,7 +19,7 @@ A **`__declspec`** extended attribute which can be used in the declaration of fu We recommend that all new code use the [`noexcept`](noexcept-cpp.md) operator rather than `__declspec(nothrow)`. -This attribute tells the compiler that the declared function and the functions it calls never throw an exception. However, it does not enforce the directive. In other words, it never causes [`std::terminate`](../standard-library/exception-functions.md#terminate) to be invoked, unlike **`noexcept`**, or in **`std:c++17`** mode (Visual Studio 2017 version 15.5 and later), `throw()`. +This attribute tells the compiler that the declared function and the functions it calls never throw an exception. However, it does not enforce the directive. In other words, it never causes [`std::terminate`](../standard-library/exception-functions.md#terminate) to be invoked, unlike **`noexcept`**, or in **`/std:c++17`** mode (Visual Studio 2017 version 15.5 and later), `throw()`. With the synchronous exception handling model, now the default, the compiler can eliminate the mechanics of tracking the lifetime of certain unwindable objects in such a function, and significantly reduce the code size. Given the following preprocessor directive, the three function declarations below are equivalent in **`/std:c++14`** mode: diff --git a/docs/cpp/object-lifetime-and-resource-management-modern-cpp.md b/docs/cpp/object-lifetime-and-resource-management-modern-cpp.md index b13d412b966..a4aa439b894 100644 --- a/docs/cpp/object-lifetime-and-resource-management-modern-cpp.md +++ b/docs/cpp/object-lifetime-and-resource-management-modern-cpp.md @@ -2,7 +2,7 @@ title: "Object lifetime and resource management (RAII)" description: "Follow the principle of RAII in modern C++ to avoid resource leaks." ms.date: 06/02/2022 -ms.topic: "conceptual" +ms.topic: "concept-article" ms.assetid: 8aa0e1a1-e04d-46b1-acca-1d548490700f --- # Object lifetime and resource management (RAII) diff --git a/docs/cpp/overload-resolution-of-function-template-calls.md b/docs/cpp/overload-resolution-of-function-template-calls.md index 17455439ed8..f8e8fc30319 100644 --- a/docs/cpp/overload-resolution-of-function-template-calls.md +++ b/docs/cpp/overload-resolution-of-function-template-calls.md @@ -1,9 +1,8 @@ --- -description: "Learn more about: Overload resolution of function template calls" title: "Overload resolution of function template calls" +description: "Learn more about: Overload resolution of function template calls" ms.date: 09/27/2022 helpviewer_keywords: ["function templates overload resolution"] -ms.assetid: a2918748-2cbb-4fc6-a176-e256f120bee4 --- # Overload resolution of function template calls @@ -26,7 +25,7 @@ template void f(T1, T2) { cout << "void f(T1, T2)" << endl; -}; +} int main() { @@ -58,7 +57,7 @@ template void f(T1, T2) { cout << "void f(T1, T2)" << endl; -}; +} int main() { diff --git a/docs/cpp/pimpl-for-compile-time-encapsulation-modern-cpp.md b/docs/cpp/pimpl-for-compile-time-encapsulation-modern-cpp.md index 5aede48b9b8..3865266d997 100644 --- a/docs/cpp/pimpl-for-compile-time-encapsulation-modern-cpp.md +++ b/docs/cpp/pimpl-for-compile-time-encapsulation-modern-cpp.md @@ -2,7 +2,7 @@ description: "Learn more about: Pimpl For Compile-Time Encapsulation (Modern C++)" title: "Pimpl For Compile-Time Encapsulation (Modern C++)" ms.date: "11/04/2016" -ms.topic: "conceptual" +ms.topic: "concept-article" ms.assetid: c3e8a90a-b328-4990-82bb-e1b147f76e07 --- # Pimpl For Compile-Time Encapsulation (Modern C++) diff --git a/docs/cpp/pointers-to-members.md b/docs/cpp/pointers-to-members.md index 17e5da3112e..9512ed71b35 100644 --- a/docs/cpp/pointers-to-members.md +++ b/docs/cpp/pointers-to-members.md @@ -1,9 +1,8 @@ --- -description: "Learn more about: Pointers to Members" title: "Pointers to Members" -ms.date: "11/04/2016" +description: "Learn more about: Pointers to Members" +ms.date: 11/04/2016 helpviewer_keywords: ["declarations, pointers", "class members [C++], pointers to", "pointers, to members", "members [C++], pointers to", "pointers, declarations"] -ms.assetid: f42ddb79-9721-4e39-95b1-c56b55591f68 --- # Pointers to Members @@ -121,7 +120,7 @@ The address of a static member isn't a pointer to a member. It's a regular point Invoking a virtual function through a pointer-to-member function works as if the function had been called directly. The correct function is looked up in the v-table and invoked. -The key to virtual functions working, as always, is invoking them through a pointer to a base class. (For more information about virtual functions, see [Virtual Functions](../cpp/virtual-functions.md).) +The key to virtual functions working, as always, is invoking them through a pointer to a base class. For more information about virtual functions, see [Virtual Functions](../cpp/virtual-functions.md). The following code shows how to invoke a virtual function through a pointer-to-member function: diff --git a/docs/cpp/portability-at-abi-boundaries-modern-cpp.md b/docs/cpp/portability-at-abi-boundaries-modern-cpp.md index 28caf182d05..09249b99cd1 100644 --- a/docs/cpp/portability-at-abi-boundaries-modern-cpp.md +++ b/docs/cpp/portability-at-abi-boundaries-modern-cpp.md @@ -2,7 +2,7 @@ title: "Portability at ABI boundaries" description: "Flatten C++ interfaces to C calling conventions at binary interface boundaries." ms.date: "11/19/2019" -ms.topic: "conceptual" +ms.topic: "concept-article" ms.assetid: abbd405e-3038-427c-8c24-e00598f0936a --- # Portability at ABI boundaries diff --git a/docs/cpp/postfix-expressions.md b/docs/cpp/postfix-expressions.md index 9ed1835bcfc..dbb3ab65ddb 100644 --- a/docs/cpp/postfix-expressions.md +++ b/docs/cpp/postfix-expressions.md @@ -1,9 +1,8 @@ --- -description: "Learn more about: Postfix Expressions" title: "Postfix Expressions" -ms.date: "11/04/2016" +description: "Learn more about: Postfix Expressions" +ms.date: 11/04/2016 helpviewer_keywords: ["operators [C++], postfix", "postfix expressions", "expressions [C++], postfix"] -ms.assetid: 7ac62a57-06df-422f-b012-a75b37d7cb9b --- # Postfix Expressions @@ -72,7 +71,7 @@ When a function is called, the following tasks are performed: Func( Temp_i ); ``` - Note that the initialization is performed as if using the equal-sign syntax instead of the parentheses syntax. A copy of `i` is made prior to passing the value to the function. (For more information, see [Initializers](../cpp/initializers.md) and [Conversions](../cpp/user-defined-type-conversions-cpp.md)). + Note that the initialization is performed as if using the equal-sign syntax instead of the parentheses syntax. A copy of `i` is made prior to passing the value to the function. For more information, see [Initializers](../cpp/initializers.md) and [Conversions](../cpp/user-defined-type-conversions-cpp.md). Therefore, if the function prototype (declaration) calls for an argument of type **`long`**, and if the calling program supplies an actual argument of type **`int`**, the actual argument is promoted using a standard type conversion to type **`long`** (see [Standard Conversions](../cpp/standard-conversions.md)). diff --git a/docs/cpp/postfix-increment-and-decrement-operators-increment-and-decrement.md b/docs/cpp/postfix-increment-and-decrement-operators-increment-and-decrement.md index beb76735fa8..9113738138e 100644 --- a/docs/cpp/postfix-increment-and-decrement-operators-increment-and-decrement.md +++ b/docs/cpp/postfix-increment-and-decrement-operators-increment-and-decrement.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Postfix Increment and Decrement Operators: ++ and --" title: "Postfix Increment and Decrement Operators: ++ and --" -ms.date: "11/04/2016" +description: "Learn more about: Postfix Increment and Decrement Operators: ++ and --" +ms.date: 11/04/2016 f1_keywords: ["--", "++"] helpviewer_keywords: ["increment operators [C++], syntax", "member-selection operators [C++]", "-- operator [C++], postfix decrement operators", "postfix operators [C++]", "++ operator [C++], postfix increment operators", "decrement operators [C++], syntax", "operators [C++], postfix", "decrement operators [C++]"] -ms.assetid: 0204d5c8-51b0-4108-b8a1-074c5754d89c --- # Postfix Increment and Decrement Operators: `++` and `--` @@ -17,7 +16,7 @@ postfix-expression -- ## Remarks -C++ provides prefix and postfix increment and decrement operators; this section describes only the postfix increment and decrement operators. (For more information, see [Prefix Increment and Decrement Operators](../cpp/prefix-increment-and-decrement-operators-increment-and-decrement.md).) The difference between the two is that in the postfix notation, the operator appears after *postfix-expression*, whereas in the prefix notation, the operator appears before *expression.* The following example shows a postfix-increment operator: +C++ provides prefix and postfix increment and decrement operators; this section describes only the postfix increment and decrement operators. For more information, see [Prefix Increment and Decrement Operators](../cpp/prefix-increment-and-decrement-operators-increment-and-decrement.md). The difference between the two is that in the postfix notation, the operator appears after *postfix-expression*, whereas in the prefix notation, the operator appears before *expression.* The following example shows a postfix-increment operator: ```cpp i++; @@ -43,19 +42,25 @@ The following code illustrates the postfix increment operator: #include using namespace std; -int main() { - int i = 10; - cout << i++ << endl; - cout << i << endl; +int main() +{ + int i = 10; + cout << i++ << endl; + cout << i << endl; } ``` +```Output +10 +11 +``` + Postincrement and postdecrement operations on enumerated types are not supported: ```cpp -enum Compass { North, South, East, West ); +enum Compass { North, South, East, West }; Compass myCompass; -for( myCompass = North; myCompass != West; myCompass++ ) // Error +for (myCompass = North; myCompass != West; myCompass++); // Error ``` ## See also diff --git a/docs/cpp/prefix-increment-and-decrement-operators-increment-and-decrement.md b/docs/cpp/prefix-increment-and-decrement-operators-increment-and-decrement.md index 238ae3dfb0e..0ca9c55341a 100644 --- a/docs/cpp/prefix-increment-and-decrement-operators-increment-and-decrement.md +++ b/docs/cpp/prefix-increment-and-decrement-operators-increment-and-decrement.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Prefix Increment and Decrement Operators: ++ and --" title: "Prefix Increment and Decrement Operators: ++ and --" -ms.date: "11/04/2016" +description: "Learn more about: Prefix Increment and Decrement Operators: ++ and --" +ms.date: 11/04/2016 f1_keywords: ["--", "++"] helpviewer_keywords: ["increment operators [C++], syntax", "++ operator [C++], prefix increment operators", "operators [C++], decrement", "-- operator [C++], prefix decrement operators [C++]", "operators [C++], increment", "decrement operators [C++], syntax", "decrement operators [C++]"] -ms.assetid: 45ea7fc7-f279-4be9-a216-1d9a0ef9eb7b --- # Prefix Increment and Decrement Operators: `++` and `--` @@ -23,7 +22,7 @@ The prefix decrement operator (**`--`**) is analogous to the prefix increment op **Visual Studio 2017 version 15.3 and later** (available in [`/std:c++17`](../build/reference/std-specify-language-standard-version.md) mode and later): The operand of an increment or decrement operator may not be of type **`bool`**. -Both the prefix and postfix increment and decrement operators affect their operands. The key difference between them is the order in which the increment or decrement takes place in the evaluation of an expression. (For more information, see [Postfix Increment and Decrement Operators](../cpp/postfix-increment-and-decrement-operators-increment-and-decrement.md).) In the prefix form, the increment or decrement takes place before the value is used in expression evaluation, so the value of the expression is different from the value of the operand. In the postfix form, the increment or decrement takes place after the value is used in expression evaluation, so the value of the expression is the same as the value of the operand. For example, the following program prints "`++i = 6`": +Both the prefix and postfix increment and decrement operators affect their operands. The key difference between them is the order in which the increment or decrement takes place in the evaluation of an expression. For more information, see [Postfix Increment and Decrement Operators](../cpp/postfix-increment-and-decrement-operators-increment-and-decrement.md). In the prefix form, the increment or decrement takes place before the value is used in expression evaluation, so the value of the expression is different from the value of the operand. In the postfix form, the increment or decrement takes place after the value is used in expression evaluation, so the value of the expression is the same as the value of the operand. For example, the following program prints "`++i = 6`": ```cpp // expre_Increment_and_Decrement_Operators.cpp diff --git a/docs/cpp/preserve-none.md b/docs/cpp/preserve-none.md new file mode 100644 index 00000000000..f90d613bc96 --- /dev/null +++ b/docs/cpp/preserve-none.md @@ -0,0 +1,74 @@ +--- +description: "Learn more about: __preserve_none" +title: "__preserve_none" +ms.date: 02/11/2026 +f1_keywords: ["__preserve_none", "register spilling", "non preserving calling convention"] +helpviewer_keywords: ["__preserve_none keyword"] +--- +# __preserve_none + +**Microsoft Specific** + +> [!IMPORTANT] +> The **`__preserve_none`** calling convention is experimental and subject to change. + +The **`__preserve_none`** calling convention specifies that arguments to functions are to be passed in registers, with most general-purpose registers treated as volatile. This calling convention is only supported for C programs and only applies to x64 code. + +This calling convention is designed to minimize register spilling and improve performance. + +The following list shows the behavior of this calling convention. + +| Element | Behavior | +|---------|----------------| +| Argument-passing order | Arguments are passed in up to 10 registers in the following order: `r13`, `r14`, `r15`, `rbx`, `rsi`, `rdi`, `r9`, `r8`, `rdx`, `rcx`. If a hidden parameter is required for struct returns, it's passed in `r13` (the first parameter register), reducing available parameter registers to 9. Registers `r10`-`r12` are reserved for various CRT and Windows runtimes. All parameters must be passed through registers; stack-based parameters aren't currently supported. | +| Register allocation strategy | To help minimize register spilling, the allocator assigns `r9`, `r8`, `rdx`, and `rcx` only after other registers have been used. | +| Argument limit | Functions are restricted to a maximum of 10 parameters. An error is generated if this limit is exceeded. | +| Return value convention | Follows the regular x64 calling convention rules. Scalar return values are returned in `rax`. Structs of size 1, 2, 4, or 8 bytes are returned through the `rax` register. For structs of other sizes, a pointer to memory allocated by the caller and passed through the hidden parameter is returned in `rax`. | +| Volatile registers | All general-purpose registers except `rsp` (stack pointer) and `rbp` (base pointer) are treated as volatile and don't need to be preserved across function calls. While `r10` and `r11` are volatile, they aren't used for parameter passing to maintain compatibility with existing programs. | +| Nonvolatile registers | Only `rsp`, `rbp`, and `r12` are nonvolatile. | +| Stack alignment | The stack must maintain 16-byte alignment. | +| Frame pointer | The `rbp` register and frame chain follow the [/Gy switch](../build/reference/gy-enable-function-level-linking.md) settings. | +| Stack-maintenance responsibility | The callee is responsible for cleaning up its own stack space. | +| Shadow space | 32 bytes are reserved on the stack as a shadow space to maintain compatibility with profilers and debugging tools. *(Shadow space is a reserved area on the stack where register parameters can be spilled if needed. It's typically 32 bytes (4 registers × 8 bytes each) that the caller reserves for the first four register parameters.)* | +| Floating-point support | Floating-point parameters aren't supported. | +| Name-decoration convention | Function names are decorated with @@_A suffix. | +| Case-translation convention | No case translation performed. | + +## Restrictions and Limitations + +The **`__preserve_none`** calling convention has the following restrictions: + +- **C only**: Only supported for C programs. +- **x64 only**: Only supported on x64. +- **No floating-point**: Floating-point parameters aren't supported. +- **No variadic functions**: Variadic functions (varargs) aren't supported. +- **Parameter limit**: Maximum of 10 parameters, all passed through registers. + +## Use Cases + +The **`__preserve_none`** calling convention is designed for performance-critical scenarios where: + +- Most functions in the codebase use the **`__preserve_none`** calling convention +- Used with `msvc::musttail` to tail call between functions with no stack usage +- Minimizing register spilling is important for performance +- The codebase is compatible with treating most registers as volatile + +## Example + +In the following example, the function `ProcessData` uses the **`__preserve_none`** calling convention: + +```c +// Example of the __preserve_none keyword +void __preserve_none ProcessData(int a, int b, int c, int d, int e); + +// Example of the __preserve_none keyword on function pointer +typedef int (__preserve_none *callback_ptr)(void* context, int value, int flags); +``` + +**END Microsoft Specific** + +## See also + +[Argument Passing and Naming Conventions](argument-passing-and-naming-conventions.md)\ +[x64 Calling Convention](../build/x64-calling-convention.md)\ +[Keywords](keywords-cpp.md) diff --git a/docs/cpp/program-and-linkage-cpp.md b/docs/cpp/program-and-linkage-cpp.md index 85a25f80160..720e33de0fc 100644 --- a/docs/cpp/program-and-linkage-cpp.md +++ b/docs/cpp/program-and-linkage-cpp.md @@ -11,7 +11,7 @@ In a C++ program, a *symbol*, for example a variable or function name, can be de The following example shows some declarations: ```cpp -int i; +extern int i; int f(int x); class C; ``` diff --git a/docs/cpp/ptr32-ptr64.md b/docs/cpp/ptr32-ptr64.md index 08fc2cedc23..a41c67307da 100644 --- a/docs/cpp/ptr32-ptr64.md +++ b/docs/cpp/ptr32-ptr64.md @@ -1,16 +1,17 @@ --- description: "Learn more about: __ptr32, __ptr64" title: "__ptr32, __ptr64" -ms.date: "10/09/2018" +ms.date: 12/16/2025 f1_keywords: ["__ptr32_cpp", "__ptr64_cpp", "__ptr32", "__ptr64", "_ptr32", "_ptr64"] helpviewer_keywords: ["__ptr64 keyword [C++]", "_ptr32 keyword [C++]", "ptr32 keyword [C++]", "ptr64 keyword [C++]", "_ptr64 keyword [C++]", "__ptr32 keyword [C++]"] -ms.assetid: afb563d8-7458-4fe7-9c30-bd4b5385a59f --- # __ptr32, __ptr64 -**Microsoft Specific** +**Microsoft specific** -**`__ptr32`** represents a native pointer on a 32-bit system, while **`__ptr64`** represents a native pointer on a 64-bit system. +Use **`__ptr32`** to represent a native pointer on a 32-bit system. Use **`__ptr64`** to represent a native pointer on a 64-bit system. + +The `__ptr32` and `__ptr64` modifiers are Microsoft-specific extensions for interop scenarios. For standard 32-bit (x86) or standard x64 code, use native pointers, instead. The following example shows how to declare each of these pointer types: @@ -19,17 +20,22 @@ int * __ptr32 p32; int * __ptr64 p64; ``` -On a 32-bit system, a pointer declared with **`__ptr64`** is truncated to a 32-bit pointer. On a 64-bit system, a pointer declared with **`__ptr32`** is coerced to a 64-bit pointer. +On a 32-bit system, a pointer declared with **`__ptr64`** is treated as a 32-bit pointer and truncates the upper 32 bits of any 64-bit address assigned to it. On a 64-bit system, a pointer declared with **`__ptr32`** is treated as a 32-bit pointer and truncates the upper 32 bits of any 64-bit address assigned to it. This truncation can lead to an invalid pointer if the 64-bit address is above 4GB. > [!NOTE] -> You cannot use **`__ptr32`** or **`__ptr64`** when compiling with **/clr:pure**. Otherwise, Compiler Error C2472 will be generated. The **/clr:pure** and **/clr:safe** compiler options are deprecated in Visual Studio 2015 and unsupported in Visual Studio 2017. +> You can't use **`__ptr32`** or **`__ptr64`** when compiling with **`/clr:pure`**. Otherwise, the compiler generates error C2472. The **/clr:pure** and **/clr:safe** compiler options are deprecated in Microsoft Visual Studio 2015 and unsupported in Microsoft Visual Studio 2017. -For compatibility with previous versions, **_ptr32** and **_ptr64** are synonyms for **`__ptr32`** and **`__ptr64`** unless compiler option [/Za \(Disable language extensions)](../build/reference/za-ze-disable-language-extensions.md) is specified. +For compatibility with previous versions, **`_ptr32`** and **`_ptr64`** are synonyms for **`__ptr32`** and **`__ptr64`** unless you specify compiler option [/Za \(Disable language extensions)](../build/reference/za-ze-disable-language-extensions.md). ## Example The following example shows how to declare and allocate pointers with the **`__ptr32`** and **`__ptr64`** keywords. +This code works on x86 but might crash on x64. + +- It works when compiled for 32-bit because **`__ptr64`** pointers are treated as 32-bit pointers on x86. On x86 (32-bit), `malloc` returns a 32-bit address which fits in `p64`. +- It might crash when compiled for 64-bit because on x64, `malloc` returns a 64-bit pointer which is truncated to 32 bits by this line: `p32 = (int* __ptr32)malloc(4);`. Truncating a 64-bit address to a 32-bit address could result in an invalid pointer if the allocation happened above 4GB. In that case, `*p32 = 32` could attempt to access a truncated address that isn't part of your process's address space, causing an access violation. Even if it works once, it could fail later if the memory allocator returns a higher address. + ```cpp #include #include @@ -38,22 +44,22 @@ int main() { using namespace std; - int * __ptr32 p32; - int * __ptr64 p64; + int* __ptr32 p32; + int* __ptr64 p64; - p32 = (int * __ptr32)malloc(4); - *p32 = 32; + p64 = (int* __ptr64)malloc(4); + *p64 = 64; // Works on x86 and x64 + cout << *p64 << endl; + + p32 = (int* __ptr32)malloc(4); + *p32 = 32; // Works on x86. Possible exception on x64 cout << *p32 << endl; - - p64 = (int * __ptr64)malloc(4); - *p64 = 64; - cout << *p64 << endl; } ``` ```Output -32 64 +32 ``` **END Microsoft Specific** diff --git a/docs/cpp/raw-pointers.md b/docs/cpp/raw-pointers.md index 6b65cb30b14..c12c7051c64 100644 --- a/docs/cpp/raw-pointers.md +++ b/docs/cpp/raw-pointers.md @@ -334,7 +334,7 @@ int main() ## See also -[Smart pointers](smart-pointers-modern-cpp.md) -[Indirection Operator: *](indirection-operator-star.md)
-[Address-of Operator: &](address-of-operator-amp.md)
+[Smart pointers](smart-pointers-modern-cpp.md)\ +[Indirection Operator: *](indirection-operator-star.md)\ +[Address-of Operator: &](address-of-operator-amp.md)\ [Welcome back to C++](welcome-back-to-cpp-modern-cpp.md) diff --git a/docs/cpp/restrict-cpp-amp.md b/docs/cpp/restrict-cpp-amp.md index 5255fa72ffd..97dcc8e1286 100644 --- a/docs/cpp/restrict-cpp-amp.md +++ b/docs/cpp/restrict-cpp-amp.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: restrict (C++ AMP)" title: "restrict (C++ AMP)" -ms.date: "11/04/2016" +description: "Learn more about: restrict (C++ AMP)" +ms.date: 11/04/2016 f1_keywords: ["cpu_CPP", "amp_CPP"] helpviewer_keywords: ["restrict clause (C++ AMP)"] -ms.assetid: 07d3291f-7edf-456b-8828-283ac8673661 --- # restrict (C++ AMP) @@ -19,7 +18,7 @@ The **`restrict`** clause takes the following forms: |------------|-----------------| |`restrict(cpu)`|The function can use the full C++ language. Only other functions that are declared by using restrict(cpu) functions can call the function.| |`restrict(amp)`|The function can only use the subset of the C++ language that C++ AMP can accelerate.| -|A sequence of `restrict(cpu)` and `restrict(amp)`.|The function must adhere to the limitations of both `restrict(cpu)` and `restrict(amp)`. The function can be called by functions that are declared by using `restrict(cpu)`, `restrict(amp)`, `restrict(cpu, amp)`, or `restrict(amp, cpu)`.

The form `restrict(A) restrict(B)` can be written as `restrict(A,B)`.| +|A sequence of `restrict(cpu)` and `restrict(amp)`.|The function must adhere to the limitations of both `restrict(cpu)` and `restrict(amp)`. The function can be called by functions that are declared by using `restrict(cpu)`, `restrict(amp)`, `restrict(cpu, amp)`, or `restrict(amp, cpu)`.

The form `restrict(A) restrict(B)` can be written as `restrict(A,B)`.| ## Remarks diff --git a/docs/cpp/results-of-calling-example.md b/docs/cpp/results-of-calling-example.md index d4b2e023575..7684793aa79 100644 --- a/docs/cpp/results-of-calling-example.md +++ b/docs/cpp/results-of-calling-example.md @@ -1,9 +1,8 @@ --- -description: "Learn more about: Results of Calling Example" title: "Results of Calling Example" -ms.date: "11/19/2018" +description: "Learn more about: Results of Calling Example" +ms.date: 11/19/2018 helpviewer_keywords: ["examples [C++], results of calling", "results, thiscall call", "results, __fastcall keyword call", "results, __cdecl call", "results, __stdcall call"] -ms.assetid: aa70a7cb-ba1d-4aa6-bd0a-ba783da2e642 --- # Results of Calling Example @@ -20,7 +19,7 @@ The **`__cdecl`** calling convention The C decorated name (**`__stdcall`**) is `_MyFunc@20`. The C++ decorated name is implementation-specific. -![Diagram showing the stack and registers for the S T D call and this call calling conventions.](../cpp/media/vc37i02.gif )
+![Diagram showing the stack and registers for the S T D call and this call calling conventions.](../cpp/media/vc37i02.gif)
The __stdcall and thiscall calling conventions ## `__fastcall` diff --git a/docs/cpp/safebuffers.md b/docs/cpp/safebuffers.md index 5d581c08ee5..c813aa53e2b 100644 --- a/docs/cpp/safebuffers.md +++ b/docs/cpp/safebuffers.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: safebuffers" title: "safebuffers" -ms.date: "11/04/2016" +description: "Learn more about: safebuffers" +ms.date: 11/04/2016 f1_keywords: ["safebuffers_cpp"] helpviewer_keywords: ["__declspec keyword (C++), safebuffers", "safebuffers __declspec keyword"] -ms.assetid: 0b0dce14-4523-44d2-8070-5dd0fdabc618 --- # safebuffers @@ -50,7 +49,7 @@ static int checkBuffers() { BUFFER cb; // Use the buffer... return 0; -}; +} static __declspec(safebuffers) int noCheckBuffers() { BUFFER ncb; diff --git a/docs/cpp/selectany.md b/docs/cpp/selectany.md index 4369cd35eb0..73b773a2a0e 100644 --- a/docs/cpp/selectany.md +++ b/docs/cpp/selectany.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: `selectany`" title: "selectany" -ms.date: "11/04/2016" +description: "Learn more about: `selectany`" +ms.date: 11/04/2016 f1_keywords: ["selectany_cpp"] helpviewer_keywords: ["__declspec keyword [C++], selectany", "selectany __declspec keyword"] -ms.assetid: 9c353017-5a42-4f50-b741-bd13da1ce84d --- # `selectany` @@ -56,7 +55,7 @@ extern __declspec(selectany) int x5; // OK: dynamic initialization of global object class X { public: -X(int i){i++;}; +X(int i){i++;} int i; }; diff --git a/docs/cpp/single-inheritance.md b/docs/cpp/single-inheritance.md index 74c79169b4c..ccba5fd02c1 100644 --- a/docs/cpp/single-inheritance.md +++ b/docs/cpp/single-inheritance.md @@ -1,9 +1,8 @@ --- -description: "Learn more about: Single Inheritance" title: "Single Inheritance" -ms.date: "11/19/2018" +description: "Learn more about: Single Inheritance" +ms.date: 11/19/2018 helpviewer_keywords: ["single inheritance", "base classes [C++], indirect", "scope, scope resolution operator", "operators [C++], scope resolution", "scope resolution operator", "derived classes [C++], single base class", "inheritance, single"] -ms.assetid: 1cb946ed-8b1b-4cf1-bde0-d9cecbfdc622 --- # Single Inheritance @@ -74,7 +73,7 @@ Book::Book( char *name, long pagecount ) { Name = new char[ strlen( name ) + 1 ]; strcpy_s( Name, strlen(Name), name ); PageCount = pagecount; -}; +} ``` Note that the constructor for `Book`, (`Book::Book`), has access to the data member, `Name`. In a program, an object of type `Book` can be created and used as follows: diff --git a/docs/cpp/smart-pointers-modern-cpp.md b/docs/cpp/smart-pointers-modern-cpp.md index 40af79d21d5..2551bba44a0 100644 --- a/docs/cpp/smart-pointers-modern-cpp.md +++ b/docs/cpp/smart-pointers-modern-cpp.md @@ -2,7 +2,7 @@ description: "Learn more about: Smart pointers (Modern C++)" title: "Smart pointers (Modern C++)" ms.date: "11/19/2019" -ms.topic: "conceptual" +ms.topic: "concept-article" ms.assetid: 909ef870-904c-49b6-b8cd-e9d0b7dc9435 --- # Smart pointers (Modern C++) diff --git a/docs/cpp/standard-conversions.md b/docs/cpp/standard-conversions.md index 083ac66a0f1..aabdc570be3 100644 --- a/docs/cpp/standard-conversions.md +++ b/docs/cpp/standard-conversions.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: Standard conversions" title: "Standard conversions" -ms.date: "10/02/2019" +description: "Learn more about: Standard conversions" +ms.date: 10/02/2019 helpviewer_keywords: ["standard conversions, categories of", "L-values [C++]", "conversions, standard"] --- # Standard conversions @@ -203,7 +203,7 @@ The second case in which a pointer to a class can be converted to a pointer to a The result of such a conversion is a pointer to the *subobject*, the portion of the object that is completely described by the base class. -The following code defines two classes, `A` and `B`, where `B` is derived from `A`. (For more information on inheritance, see [Derived Classes](../cpp/inheritance-cpp.md).) It then defines `bObject`, an object of type `B`, and two pointers (`pA` and `pB`) that point to the object. +The following code defines two classes, `A` and `B`, where `B` is derived from `A`. For more information on inheritance, see [Derived Classes](../cpp/inheritance-cpp.md). It then defines `bObject`, an object of type `B`, and two pointers (`pA` and `pB`) that point to the object. ```cpp // C2039 expected @@ -278,7 +278,7 @@ A reference to a class can be converted to a reference to a base class in these - The specified base class is accessible. -- The conversion is unambiguous. (For more information about ambiguous base-class references, see [Multiple base classes](../cpp/multiple-base-classes.md).) +- The conversion is unambiguous. For more information about ambiguous base-class references, see [Multiple base classes](../cpp/multiple-base-classes.md). The result of the conversion is a pointer to the subobject that represents the base class. diff --git a/docs/cpp/stdcall.md b/docs/cpp/stdcall.md index a6e9a503516..61ad524d75c 100644 --- a/docs/cpp/stdcall.md +++ b/docs/cpp/stdcall.md @@ -13,6 +13,8 @@ The **`__stdcall`** calling convention is used to call Win32 API functions. The ## Syntax > *return-type* **`__stdcall`** *function-name*[**`(`** *argument-list* **`)`**] +> +> **`auto`** **`__stdcall`** *function-name*[**`(`** *argument-list* **`)`**] [ **`->`** *return-type* ] ## Remarks diff --git a/docs/cpp/string-and-character-literals-cpp.md b/docs/cpp/string-and-character-literals-cpp.md index 70addb2b9b1..643fd31daea 100644 --- a/docs/cpp/string-and-character-literals-cpp.md +++ b/docs/cpp/string-and-character-literals-cpp.md @@ -331,7 +331,10 @@ const size_t byteSize = (wcslen(str) + 1) * sizeof(wchar_t); Notice that `strlen()` and `wcslen()` don't include the size of the terminating null character, whose size is equal to the element size of the string type: one byte on a `char*` or `char8_t*` string, two bytes on `wchar_t*` or `char16_t*` strings, and four bytes on `char32_t*` strings. -In versions of Visual Studio before Visual Studio 2022 version 17.0, the maximum length of a string literal is 65,535 bytes. This limit applies to both narrow string literals and wide string literals. In Visual Studio 2022 version 17.0 and later, this restriction is lifted and string length is limited by available resources. +Maximum length of a string literal after concatenation: + +* Visual Studio prior to 2022 version 17.0: the maximum length of a string literal after concatenation is 65,535 bytes. This applies to both narrow and wide string literals. +* From Visual Studio 2022 version 17.0 onwards: the maximum length of a string literal after concatenation is only limited by available memory. However, the size limit before concatenation is still 16,384 bytes ### Modifying string literals diff --git a/docs/cpp/switch-statement-cpp.md b/docs/cpp/switch-statement-cpp.md index 21afd60347f..321b32fa4ca 100644 --- a/docs/cpp/switch-statement-cpp.md +++ b/docs/cpp/switch-statement-cpp.md @@ -1,11 +1,10 @@ --- title: "switch statement (C++)" description: "Reference to the Standard C++ switch statement in Microsoft Visual Studio C++." -ms.date: "04/25/2020" +ms.date: 04/25/2020 f1_keywords: ["default_cpp", "switch_cpp", "case_cpp"] helpviewer_keywords: ["switch keyword [C++]", "case keyword [C++], in switch statements", "default keyword [C++]"] no-loc: [switch, case, default, break, while, opt] -ms.assetid: 6c3f3ed3-5593-463c-8f4b-b33742b455c6 --- # `switch` statement (C++) @@ -117,7 +116,7 @@ int main() break; case status::bad: throw BadGadget(); - }; + } ``` An inner block of a **`switch`** statement can contain definitions with initializers as long as they're *reachable*, that is, not bypassed by all possible execution paths. Names introduced using these declarations have local scope. For example: diff --git a/docs/cpp/templates-cpp.md b/docs/cpp/templates-cpp.md index 93e8ddb0948..bc964932988 100644 --- a/docs/cpp/templates-cpp.md +++ b/docs/cpp/templates-cpp.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Templates (C++)" title: "Templates (C++)" -ms.date: "12/27/2019" +description: "Learn more about: Templates (C++)" +ms.date: 12/27/2019 f1_keywords: ["template_cpp"] helpviewer_keywords: ["templates, C++", "templates [C++]"] -ms.assetid: 90fcc14a-2092-47af-9d2e-dba26d25b872 --- # Templates (C++) @@ -157,7 +156,7 @@ class MyClass2 }; ``` -Because the *Arr* parameter itself has no body, its parameter names are not needed. In fact, it is an error to refer to *Arr*'s typename or class parameter names from within the body of `MyClass2`. For this reason, *Arr*'s type parameter names can be omitted, as shown in this example: +Because the *Arr* parameter itself has no body, its parameter names are not needed. In fact, it is an error to refer to *Arr*'s typename or class parameter names from within the body of `MyClass2`. For this reason, *Arr*'s type parameter names can be omitted, as shown in this example: ```cpp template class Arr> diff --git a/docs/cpp/toc.yml b/docs/cpp/toc.yml index 03a00af04cb..1f17ade4e51 100644 --- a/docs/cpp/toc.yml +++ b/docs/cpp/toc.yml @@ -369,7 +369,7 @@ items: - name: Pimpl idiom for compile-time encapsulation href: ../cpp/pimpl-for-compile-time-encapsulation-modern-cpp.md - name: Portability at ABI boundaries - href: ../cpp/portability-at-abi-boundaries-modern-cpp.md + href: ../cpp/portability-at-abi-boundaries-modern-cpp.md - name: Constructors items: - name: Constructors @@ -644,6 +644,8 @@ items: href: ../cpp/thiscall.md - name: __vectorcall href: ../cpp/vectorcall.md + - name: __preserve_none + href: ../cpp/preserve-none.md - name: "Calling example: Function prototype and call" items: - name: "Calling example: Function prototype and call" @@ -696,6 +698,8 @@ items: href: ../cpp/using-dllimport-and-dllexport-in-cpp-classes.md - name: empty_bases href: ../cpp/empty-bases.md + - name: hybrid_patchable + href: ../cpp/hybrid-patchable.md - name: jitintrinsic href: ../cpp/jitintrinsic.md - name: naked diff --git a/docs/cpp/transporting-exceptions-between-threads.md b/docs/cpp/transporting-exceptions-between-threads.md index 343b25f91f4..b05544d78bc 100644 --- a/docs/cpp/transporting-exceptions-between-threads.md +++ b/docs/cpp/transporting-exceptions-between-threads.md @@ -1,6 +1,6 @@ --- -description: "Learn more about: Transporting exceptions between threads" title: "Transporting exceptions between threads" +description: "Learn more about: Transporting exceptions between threads" ms.date: 05/02/2023 helpviewer_keywords: ["std::current_exception", "transporting exceptions between threads", "std::copy_exception", "exception_ptr", "std::exception_ptr", "std::rethrow_exception", "current_exception", "transport exceptions between threads", "copy_exception", "rethrow_exception", "move exceptions between threads"] --- @@ -65,7 +65,7 @@ For more information about the C++ Standards committee proposal, search the Inte ### Exception-handling models and compiler options -Your application's exception-handling model determines whether it can catch and transport an exception. Visual C++ supports three models for handling C++ exceptions: [ISO-standard C++ exception handling](/cpp/cpp/errors-and-exception-handling-modern-cpp), [structured exception handling (SEH)](/windows/win32/debug/structured-exception-handling), and [common language runtime (CLR) exceptions](/cpp/extensions/exception-handling-cpp-component-extensions). Use the [`/EH`](../build/reference/eh-exception-handling-model.md) and [`/clr`](../build/reference/clr-common-language-runtime-compilation.md) compiler options to specify your application's exception-handling model. +Your application's exception-handling model determines whether it can catch and transport an exception. Visual C++ supports three models for handling C++ exceptions: [ISO-standard C++ exception handling](errors-and-exception-handling-modern-cpp.md), [structured exception handling (SEH)](/windows/win32/debug/structured-exception-handling), and [common language runtime (CLR) exceptions](../extensions/exception-handling-cpp-component-extensions.md). Use the [`/EH`](../build/reference/eh-exception-handling-model.md) and [`/clr`](../build/reference/clr-common-language-runtime-compilation.md) compiler options to specify your application's exception-handling model. Only the following combination of compiler options and programming statements can transport an exception. Other combinations either can't catch exceptions, or can catch but can't transport exceptions. @@ -244,6 +244,6 @@ exception_ptr 1: Caught a myException exception. ## See also -[Exception Handling](../cpp/exception-handling-in-visual-cpp.md) +[Exception Handling](../cpp/exception-handling-in-visual-cpp.md)\ [`/EH` (Exception Handling Model)](../build/reference/eh-exception-handling-model.md)\ [`/clr` (Common Language Runtime Compilation)](../build/reference/clr-common-language-runtime-compilation.md) diff --git a/docs/cpp/try-except-statement.md b/docs/cpp/try-except-statement.md index cb344b682e9..451aed3b2a8 100644 --- a/docs/cpp/try-except-statement.md +++ b/docs/cpp/try-except-statement.md @@ -4,7 +4,6 @@ description: "The Microsoft C++ reference to the __try and __except structured e ms.date: 08/25/2020 f1_keywords: ["_abnormal_termination_cpp", "_exception_code_cpp", "_exception_info", "__except", "_except", "_exception_code", "__except_cpp", "_exception_info_cpp"] helpviewer_keywords: ["__try keyword [C++]", "EXCEPTION_CONTINUE_EXECUTION macro", "EXCEPTION_CONTINUE_SEARCH macro", "EXCEPTION_EXECUTE_HANDLER macro", "GetExceptionCode function", "try-catch keyword [C++], try-except keyword [C++]", "_exception_code keyword [C++]", "try-except keyword [C++]", "_exception_info keyword [C++]", "_abnormal_termination keyword [C++]"] -ms.assetid: 30d60071-ea49-4bfb-a8e6-7a420de66381 --- # `try-except` statement @@ -115,7 +114,7 @@ int filter(unsigned int code, struct _EXCEPTION_POINTERS *ep) { puts("didn't catch AV, unexpected."); return EXCEPTION_CONTINUE_SEARCH; - }; + } } int main() diff --git a/docs/cpp/tutorial-import-stl-named-module.md b/docs/cpp/tutorial-import-stl-named-module.md index de5eec7bcf4..717ad7e3d43 100644 --- a/docs/cpp/tutorial-import-stl-named-module.md +++ b/docs/cpp/tutorial-import-stl-named-module.md @@ -1,11 +1,11 @@ --- title: "Tutorial: Import the standard library (STL) using modules from the command line (C++)" +description: "Learn how to import the C++ standard library (STL) using modules from the command line." ms.date: 01/29/2024 ms.topic: "tutorial" author: "tylermsft" ms.author: "twhitney" -helpviewer_keywords: ["modules [C++]", "modules [C++]", "named modules [C++], import standard library (STL) using named modules"] -description: Learn how to import the C++ standard library (STL) using modules from the command line +helpviewer_keywords: ["modules [C++]", "named modules [C++], import standard library (STL) using named modules"] --- # Tutorial: Import the C++ standard library using modules from the command line @@ -24,9 +24,9 @@ This tutorial requires Visual Studio 2022 17.5 or later. ## Introduction to standard library modules -Header files suffer from semantics that can change depending on macro definitions, the order in which you include them, and they slow compilation. Modules solve these problems. +Header file semantics can change depending on macro definitions, the order in which you include them, and they slow compilation. Modules solve these problems. -It's now possible to import the standard library as a module instead of as a tangle of header files. This is much faster and more robust than including header files or header units or precompiled headers (PCH). +It's now possible to import the standard library as a module instead of as a tangle of header files. This is much faster and more robust than including header files, header units, or precompiled headers (PCH). The C++23 standard library introduces two named modules: `std` and `std.compat`: @@ -39,25 +39,23 @@ Because named modules don't expose macros, macros like `assert`, `errno`, `offse ## About C++ modules -Header files are how declarations and definitions have been shared between source files in C++. Prior to standard library modules, you'd include the part of the standard library you needed with a directive like `#include `. Header files are fragile and difficult to compose because their semantics may change depending on the order you include them, or whether certain macros are defined. They also slow compilation because they're reprocessed by every source file that includes them. +Header files are how declarations and definitions have been shared between source files in C++. Before standard library modules, you'd include the part of the standard library you needed with a directive like `#include `. Header files are fragile and difficult to compose because their semantics may change depending on the order you include them, or whether certain macros are defined. They also slow compilation because they're reprocessed by every source file that includes them. C++20 introduces a modern alternative called *modules*. In C++23, we were able to capitalize on module support to introduce named modules to represent the standard library. Like header files, modules allow you to share declarations and definitions across source files. But unlike header files, modules aren't fragile and are easier to compose because their semantics don't change due to macro definitions or the order in which you import them. The compiler can process modules much faster than it can process `#include` files, and uses less memory at compile time as well. Named modules don't expose macro definitions or private implementation details. -For in depth information about modules, see [Overview of modules in C++](modules-cpp.md) That article also discusses consuming the C++ standard library as modules, but uses an older and experimental way of doing it. - This article demonstrates the new and best way to consume the standard library. For more information about alternative ways to consume the standard library, see [Compare header units, modules, and precompiled headers](../build/compare-inclusion-methods.md). ## Import the standard library with `std` -The following examples demonstrate how to consume the standard library as a module using the command line compiler. For information about how to do this in the Visual Studio IDE, see [Build ISO C++23 Standard Library Modules](..\build\reference\c-cpp-prop-page.md#build-iso-c23-standard-library-modules). +The following examples demonstrate how to consume the standard library as a module using the command line compiler. For information about how to do this in the Visual Studio IDE, see [Build ISO C++23 Standard Library Modules](../build/reference/c-cpp-prop-page.md#build-iso-c23-standard-library-modules). The statement `import std;` or `import std.compat;` imports the standard library into your application. But first, you must compile the standard library named modules into binary form. The following steps demonstrate how. ### Example: How to build and import `std` -1. Open a x86 Native Tools Command Prompt for VS: from the Windows **Start** menu, type *x86 native* and the prompt should appear in the list of apps. Ensure that the prompt is for Visual Studio 2022 version 17.5 or above. You'll get errors if you use the wrong version of the prompt. The examples used in this tutorial are for the CMD shell. +1. Open a x86 Native Tools Command Prompt for VS: from the Windows **Start** menu, type *x86 native* and the prompt should appear in the list of apps. Ensure that the prompt is for Visual Studio 2022 version 17.5 or above. You get errors if you use the wrong version of the prompt. The examples used in this tutorial are for the CMD shell. 1. Create a directory, such as `%USERPROFILE%\source\repos\STLModules`, and make it the current directory. If you choose a directory that you don't have write access to, you'll get errors during compilation. 1. Compile the `std` named module with the following command: @@ -77,9 +75,9 @@ The statement `import std;` or `import std.compat;` imports the standard library | Switch | Meaning | |---|---| - | [`/std:c++:latest`](../build/reference/std-specify-language-standard-version.md) | Use the latest version of the C++ language standard and library. Although module support is available under `/std:c++20`, you need the latest standard library to get support for standard library named modules. | + | [`/std:c++latest`](../build/reference/std-specify-language-standard-version.md) | Use the latest version of the C++ language standard and library. Although module support is available under `/std:c++20`, you need the latest standard library to get support for standard library named modules. | | [`/EHsc`](../build/reference/eh-exception-handling-model.md) | Use C++ exception handling, except for functions marked `extern "C"`. | - | [`/W4`](../build/reference//compiler-option-warning-level.md) | Using /W4 is generally recommended, especially for new projects because it enables all level 1, level 2, level 3, and most level 4 (informational) warnings, which can help you catch potential issues early. It essentially provides lint-like warnings that can help ensure the fewest possible hard-to-find code defects. | + | [`/W4`](../build/reference/compiler-option-warning-level.md) | Using `/W4` is generally recommended, especially for new projects because it enables all level 1, level 2, level 3, and most level 4 (informational) warnings, which can help you catch potential issues early. It essentially provides lint-like warnings that can help ensure the fewest possible hard-to-find code defects. | | [`/c`](../build/reference/c-compile-without-linking.md) | Compile without linking, because we're just building the binary named module interface at this point. | You can control the object file name and the named module interface file name with the following switches: @@ -161,7 +159,7 @@ Before you can use `import std.compat;` you must compile the module interface fi - `std.compat.obj` contains implementation. However, most of the implementation is provided by `std.obj`. Add `std.obj` to the command line when you compile the sample app to statically link the functionality that you use from the standard library into your application. You can control the object file name and the named module interface file name with the following switches: - - [`/Fo`](../build/reference/fo-object-file-name.md) sets the name of the object file. For example, `/Fo:"somethingelse"`. By default, the compiler uses the same name for the object file as the module source file (`.ixx`) you're compiling. In the example, the object file names are `std.obj` and `std.compat.obj` by default because we're compiling the module files `std.ixx` and `std.compat.obj`. + - [`/Fo`](../build/reference/fo-object-file-name.md) sets the name of the object file. For example, `/Fo:"somethingelse"`. By default, the compiler uses the same name for the object file as the module source file (`.ixx`) you're compiling. In the example, the object file names are `std.obj` and `std.compat.obj` by default because we're compiling the module files `std.ixx` and `std.compat.ixx`. - [`/ifcOutput`](../build/reference/ifc-output.md) sets the name of the named module interface file (`.ifc`). For example, `/ifcOutput "somethingelse.ifc"`. By default, the compiler uses the same name for the module interface file (`.ifc`) as the module source file (`.ixx`) you're compiling. In the example, the generated `ifc` files are `std.ifc` and `std.compat.ifc` by default because we're compiling the module files `std.ixx` and `std.compat.ixx`. 1. Import the `std.compat` library by first creating a file named `stdCompatExample.cpp` with the following content: @@ -212,7 +210,7 @@ Before you can use `import std.compat;` you must compile the module interface fi ## Standard library named module considerations -Versioning for named modules is the same as for headers. The `.ixx` named module files are installed alongside the headers, for example: `"%VCToolsInstallDir%\modules\std.ixx`, which resolves to `C:\Program Files\Microsoft Visual Studio\2022\Enterprise\VC\Tools\MSVC\14.38.33130\modules\std.ixx` in the version of the tools used at the time of this writing. Select the version of the named module the same way you choose the version of the header file to use--by the directory you refer to them from. +Versioning for named modules is the same as for headers. The `.ixx` named module files are installed alongside the headers, for example: `"%VCToolsInstallDir%\modules\std.ixx"`, which resolves to `C:\Program Files\Microsoft Visual Studio\2022\Enterprise\VC\Tools\MSVC\14.38.33130\modules\std.ixx` in the version of the tools used at the time of this writing. Select the version of the named module the same way you choose the version of the header file to use--by the directory you refer to them from. Don't mix and match importing header units and named modules. For example, don't `import ;` and `import std;` in the same file. @@ -224,7 +222,7 @@ If you need to use the `assert()` macro, then `#include `. If you need to use the `errno` macro, `#include `. Because named modules don't expose macros, this is the workaround if you need to check for errors from ``, for example. -Macros such as `NAN`, `INFINITY`, and `INT_MIN` are defined by ``, which you can include. However, if you `import std;` you can use `numeric_limits::quiet_NaN()` and `numeric_limits::infinity()` instead of `NAN` and `INFINITY`, and `std::numeric_limits::min()` instead of `INT_MIN`. +Macros such as `NAN`, `INFINITY`, and `INT_MIN` are defined by ``, which you can include. However, if you `import std;` you can use `std::numeric_limits::quiet_NaN()` and `std::numeric_limits::infinity()` instead of `NAN` and `INFINITY`, and `std::numeric_limits::min()` instead of `INT_MIN`. ## Summary diff --git a/docs/cpp/tutorial-named-modules-cpp.md b/docs/cpp/tutorial-named-modules-cpp.md index 89830e77642..776ac6f114f 100644 --- a/docs/cpp/tutorial-named-modules-cpp.md +++ b/docs/cpp/tutorial-named-modules-cpp.md @@ -1,6 +1,6 @@ --- title: "Named modules tutorial in C++" -ms.date: 08/08/2022 +ms.date: 02/13/2025 ms.topic: "tutorial" author: "tylermsft" ms.author: "twhitney" @@ -9,7 +9,7 @@ description: Named modules in C++20 provide a modern alternative to header files --- # Named modules tutorial (C++) -This tutorial is about creating C++20 modules. Modules replace header files. You'll learn how modules are an improvement on header files. +This tutorial is about creating C++20 modules. Modules are a significant improvement on header files. In this tutorial, learn how to: @@ -22,13 +22,11 @@ In this tutorial, learn how to: This tutorial requires Visual Studio 2022 17.1.0 or later. -You might get IntelliSense errors while working on the code example in this tutorial. Work on the IntelliSense engine is catching up with the compiler. IntelliSense errors can be ignored and won't prevent the code example from building. To track progress on the IntelliSense work, see this [issue](https://developercommunity.visualstudio.com/t/When-importing-a-C20-module-or-header-/1550846). - ## What are C++ modules -Header files are how declarations and definitions are shared between source files in C++. Header files are fragile and difficult to compose. They may compile differently depending on the order you include them in, or on the macros that are or aren't defined. They can slow compilation time because they're reprocessed for each source file that includes them. +Header files are how declarations and definitions are shared between source files in C++. Header files are fragile and may compile differently depending on the order you include them in or on the macros that are or aren't defined. They can slow compilation time because they're reprocessed for each source file that includes them. -C++20 introduces a modern approach to componentizing C++ programs: *modules*. +C++20 introduces *modules* as a modern approach to componentizing C++ programs. Like header files, modules allow you to share declarations and definitions across source files. But unlike header files, modules don't leak macro definitions or private implementation details. @@ -50,7 +48,7 @@ Your code can consume modules in the same project, or any referenced projects, a ## Create the project -As we build a simple project, we'll look at various aspects of modules. The project will implement an API using a module instead of a header file. +The following project implements an API using a module instead of a header file. In Visual Studio 2022 or later, choose **Create a new project** and then the **Console App** (for C++) project type. If this project type isn't available, you may not have selected the **Desktop development with C++** workload when you installed Visual Studio. You can use the Visual Studio Installer to add the C++ workload. @@ -62,7 +60,7 @@ Because modules are a C++20 feature, use the [`/std:c++20` or `/std:c++latest`]( ## Create the primary module interface unit -A module consists of one or more files. One of these files must be what is called the *primary module interface unit*. It defines what the module exports; that is, what importers of the module will see. There can only be one primary module interface unit per module. +A module consists of one or more files. One of these files must be what is called the *primary module interface unit*. It defines what the module exports; that is, what importers of the module see. There can only be one primary module interface unit per module. To add a primary module interface unit, in **Solution Explorer**, right-click **Source Files** then select **Add** > **Module**. @@ -88,17 +86,17 @@ Replace the contents of *`BasicPlane.Figures.ixx`* file with: export module BasicPlane.Figures; // the export module keywords mark this file as a primary module interface unit ``` -This line identifies this file as the primary module interface and gives the module a name: `BasicPlane.Figures`. The period in the module name has no special meaning to the compiler. A period can be used to convey how your module is organized. If you have multiple module files that work together, you can use periods to indicate a separation of concerns. In this tutorial, we'll use periods to indicate different functional areas of the API. +This line identifies this file as the primary module interface and gives the module a name: `BasicPlane.Figures`. The period in the module name has no special meaning to the compiler. A period can be used to convey how your module is organized. If you have multiple module files that work together, you can use periods to indicate a separation of concerns. In this tutorial, periods indicate different functional areas of the API. This name is also where the "named" in "named module" comes from. The files that are part of this module use this name to identify themselves as part of the named module. A named module is the collection of module units with the same module name. We should talk about the API we'll implement for a moment before going further. It impacts the choices we make next. The API represents different shapes. We're only going to provide a couple shapes in this example: `Point` and `Rectangle`. `Point` is meant to be used as part of more complex shapes such as `Rectangle`. -To illustrate some features of modules, we'll factor this API into pieces. One piece will be the `Point` API. The other part will be `Rectangle`. Imagine that this API will grow into something more complex. The division is useful for separating concerns or easing code maintenance. +To illustrate some features of modules, we factor this API into parts. One part is the `Point` API. The other part is `Rectangle`. Imagine that this API could grow into something more complex. The division is useful for separating concerns or easing code maintenance. So far, we've created the primary module interface that will expose this API. Let's now build the `Point` API. We want it to be part of this module. For reasons of logical organization, and potential build efficiency, we want to make the code for this part of the API a *module partition* file. -Module partitions are useful for dividing the module implementation into manageable pieces. A module partition file is a piece, or component, of a module. What makes it unique is that it can be treated as an individual piece of the module--but only within the module. Module partitions can't be consumed outside of a module. +Module partitions are useful for dividing the module implementation into manageable parts. A module partition file is part of a module. What makes it unique is that it can be treated as an individual parts of the module--but only within the module. Module partitions can't be consumed outside of a module. When you import a partition into the primary module, all its declarations become visible to the primary module regardless of whether they're exported. Partitions can be imported into any partition interface, primary module interface, or module unit that belongs to the named module. @@ -108,7 +106,7 @@ When you import a partition into the primary module, all its declarations become To create a module partition file, in the **Solution Explorer** right-click **Source Files**, then select **Add** > **Module**. Name the file *`BasicPlane.Figures-Point.ixx`* and choose **Add**. -Because it's a module partition file, we've added a hyphen and the name of the partition to the module name. This convention aids the compiler in the command-line case because the compiler uses name lookup rules based on the module name to find the compiled *`.ifc`* file for the partition. This way you don't have to provide explicit `/reference` command-line arguments to find the partitions that belong to the module. It's also helpful for organizing the files that belong to a module by name because you can easily see which files belong to which modules. +Because it's a module partition file, we add a hyphen and the name of the partition to the module name. This convention aids the compiler in the command-line case because the compiler uses name lookup rules based on the module name to find the compiled *`.ifc`* file for the partition. This way you don't have to provide explicit `/reference` command-line arguments to find the partitions that belong to the module. It's also helpful for organizing the files that belong to a module by name because you can easily see which files belong to which modules. Replace the contents of *`BasicPlane.Figures-Point.ixx`* with: @@ -129,7 +127,7 @@ In this file, the `export` keyword makes `struct Point` visible to consumers. ### `Rectangle` module partition example -The next partition we'll define is `Rectangle`. Create another module file using the same steps as before: In **Solution Explorer**, right-click on **Source Files**, then select **Add** > **Module**. Name the file *`BasicPlane.Figures-Rectangle.ixx`* and select **Add**. +The next partition we define is `Rectangle`. Create another module file using the same steps as before: In **Solution Explorer**, right-click on **Source Files**, then select **Add** > **Module**. Name the file *`BasicPlane.Figures-Rectangle.ixx`* and select **Add**. Replace the contents of *`BasicPlane.Figures-Rectangle.ixx`* with: @@ -156,13 +154,13 @@ Next, `import :Point;` shows how to import a module partition. The `import` stat Next, the code exports the definition of `struct Rectangle` and declarations for some functions that return various properties of the rectangle. The `export` keyword indicates whether to make what it precedes visible to consumers of the module. It's used to make the functions `area`, `height`, and `width` visible outside of the module. -All definitions and declarations in a module partition are visible to the importing module unit whether they have the `export` keyword or not. The `export` keyword governs whether the definition, declaration, or typedef will be visible outside of the module when you export the partition in the primary module interface. +All definitions and declarations in a module partition are visible to the importing module unit whether they have the `export` keyword or not. The `export` keyword governs whether the definition, declaration, or typedef is visible outside of the module when you export the partition in the primary module interface. Names are made visible to consumers of a module in several ways: - Put the keyword `export` in front of each type, function, and so on, that you want to export. - If you put `export` in front of a namespace, for example `export namespace N { ... }`, everything defined within the braces is exported. But if elsewhere in the module you define `namespace N { struct S {...};}`, then `struct S` isn't available to consumers of the module. It's not available because that namespace declaration isn't prefaced by `export`, even though there's another namespace with the same name that is. -- If a type, function, and so on, shouldn't be exported, omit the `export` keyword. It will be visible to other files that are part of the module, but not to importers of the module. +- If a type, function, and so on, shouldn't be exported, omit the `export` keyword. It's visible to other files that are part of the module, but not to importers of the module. - Use `module :private;` to mark the beginning of the private module partition. The private module partition is a section of the module where declarations are only visible to that file. They aren't visible to files that import this module or to other files that are part of this module. Think of it as a section that is static local to the file. This section is visible only within the file. - To make an imported module or module partition visible, use `export import`. An example is shown in the next section. @@ -179,11 +177,11 @@ export import :Point; // bring in the Point partition, and export it to consumer export import :Rectangle; // bring in the Rectangle partition, and export it to consumers of this module ``` -The two lines that begin with `export import` are new here. When combined like this, these two keywords instruct the compiler to import the specified module and make it visible to consumers of this module. In this case, the colon (`:`) in the module name indicates that we are importing a module partition. +The two lines that begin with `export import` are new here. When combined like this, these two keywords instruct the compiler to import the specified module and make it visible to consumers of this module. In this case, the colon (`:`) in the module name indicates that we're importing a module partition. The imported names don't include the full module name. For example, the `:Point` partition was declared as `export module BasicPlane.Figures:Point`. Yet here we're importing `:Point`. Because we're in the primary module interface file for the module `BasicPlane.Figures`, the module name is implied, and only the partition name is specified. -So far, we've defined the primary module interface, which exposes the API surface we want to make available. But we've only declared, not defined, `area()`, `height()`, or `width()`. We'll do that next by creating a module implementation file. +So far, we've defined the primary module interface, which exposes the API surface we want to make available. But we've only declared, not defined, `area()`, `height()`, or `width()`. We do that next by creating a module implementation file. ## Create a module unit implementation file @@ -219,7 +217,7 @@ Anything you declare within an implementation unit is only visible to the module ## Import the module -Now we'll make use of the module we've defined. Open the *`ModulesTutorial.cpp`* file. It was created automatically as part of the project. It currently contains the function `main()`. Replace its contents with: +Now we make use of the module we've defined. Open the *`ModulesTutorial.cpp`* file. It was created automatically as part of the project. It currently contains the function `main()`. Replace its contents with: ```cpp #include @@ -237,7 +235,7 @@ int main() } ``` -The statement `import BasicPlane.Figures;` makes all the exported functions and types from the `BasicPlane.Figures` module visible to this file. It can come before or after any `#include` directives. +The statement `import BasicPlane.Figures;` makes all the exported functions and types from the `BasicPlane.Figures` module visible to this file. It comes after any `#include` directives. The app then uses the types and functions from the module to output the area and width of the defined rectangle: @@ -252,7 +250,7 @@ Let's now look in more detail at the various module files. ### Primary module interface -A module consists of one or more files. One of them defines the interface that importers will see. This file contains the *Primary module interface*. There can only be one primary module interface per module. As pointed out earlier, the exported module interface unit doesn't specify a module partition. +A module consists of one or more files. One of them defines the interface that importers see. This file contains the *Primary module interface*. There can only be one primary module interface per module. As pointed out earlier, the exported module interface unit doesn't specify a module partition. It has an *`.ixx`* extension by default. However, you can treat a source file with any extension as a module interface file. To do so, set the **Compile As** property in the **Advanced** tab for the source file's properties page to **Compile As Module (/interface)**: @@ -265,7 +263,7 @@ module; // optional. Defines the beginning of the global module fragment // #include directives go here but only apply to this file and // aren't shared with other module implementation files. -// Macro definitions aren't visible outside this file, or to importers. +// Macro definitions aren't visible outside this file or to importers. // import statements aren't allowed here. They go in the module preamble, below. export module [module-name]; // Required. Marks the beginning of the module preamble @@ -300,12 +298,13 @@ For a more in-depth look at module syntax, see [Modules](modules-cpp.md). Module implementation units belong to a named module. The named module they belong to is indicated by the `module [module-name]` statement in the file. Module implementation units provide implementation details that, for code hygiene or other reasons, you don't want to put in the primary module interface or in a module partition file. -Module implementation units are useful for breaking up a large module into smaller pieces, which can result in faster build times. This technique is covered briefly in the [Best practices](#module-best-practices) section. +Module implementation units are useful for breaking up a large module into smaller parts, which can result in faster build times. This technique is covered briefly in the [Best practices](#module-best-practices) section. Module implementation unit files have a *`.cpp`* extension. The basic outline of a module implementation unit file is: ```cpp -// optional #include or import statements. These only apply to this file +// optional #include statements. These only apply to this file +// optional import statements. These only apply to this file // imports in the associated module's interface are automatically available to this file module [module-name]; // required. Identifies which named module this implementation unit belongs to @@ -315,7 +314,7 @@ module [module-name]; // required. Identifies which named module this implementa ### Module partition files -Module partitions provide a way to componentize a module into different pieces, or *partitions*. Module partitions are meant to be imported only in files that are part of the named module. They can't be imported outside of the named module. +Module partitions provide a way to componentize a module into different parts, or *partitions*. Module partitions are meant to be imported only in files that are part of the named module. They can't be imported outside of the named module. A partition has an interface file, and zero or more implementation files. A module partition shares ownership of all the declarations in the entire module. @@ -358,7 +357,7 @@ A module and the code that imports it must be compiled with the same compiler op - The name of the file that contains the module primary interface is generally the name of the module. For example, given the module name `BasicPlane.Figures`, the name of the file containing the primary interface would be named *`BasicPlane.Figures.ixx`*. - The name of a module partition file is generally `-` where the name of the module is followed by a hyphen ('-') and then the name of the partition. For example, *`BasicPlane.Figures-Rectangle.ixx`* -If you're building from the command line and you use this naming convention for module partitions, then you won't have to explicitly add `/reference` for each module partition file. The compiler will look for them automatically based on the name of the module. The name of the compiled partition file (ending with an *`.ifc`* extension) is generated from the module name. Consider the module name `BasicPlane.Figures:Rectangle`: the compiler will anticipate that the corresponding compiled partition file for `Rectangle` is named `BasicPlane.Figures-Rectangle.ifc`. The compiler uses this naming scheme to make it easier to use module partitions by automatically finding the interface unit files for partitions. +If you're building from the command line and you use this naming convention for module partitions, then you won't have to explicitly add `/reference` for each module partition file. The compiler looks for them automatically based on the name of the module. The name of the compiled partition file is generated from the module name and ends in *`.ifc`*. Consider the module name `BasicPlane.Figures:Rectangle`: the compiler anticipates that the corresponding compiled partition file for `Rectangle` is named `BasicPlane.Figures-Rectangle.ifc`. The compiler uses this naming scheme to make it easier to use module partitions by automatically finding the interface unit files for partitions. You can name them using your own convention. But then you'll need to specify corresponding [`/reference`](../build/reference/module-reference.md) arguments to the command-line compiler. @@ -372,7 +371,7 @@ Module partitions make it easier to logically factor a large module. They can be ## Summary -In this tutorial, you've been introduced to the basics of C++20 modules. You've created a primary module interface, defined a module partition, and built a module implementation file. +In this tutorial, you were introduced to the basics of C++20 modules by creating a primary module interface, defined a module partition, and built a module implementation file. ## See also diff --git a/docs/cpp/type-conversions-and-type-safety-modern-cpp.md b/docs/cpp/type-conversions-and-type-safety-modern-cpp.md index 0d6fb436b4b..08ae5ed19c0 100644 --- a/docs/cpp/type-conversions-and-type-safety-modern-cpp.md +++ b/docs/cpp/type-conversions-and-type-safety-modern-cpp.md @@ -1,9 +1,8 @@ --- -description: "Learn more about: Type conversions and type safety" title: "Type conversions and type safety" +description: "Learn more about: Type conversions and type safety" ms.date: "11/19/2019" -ms.topic: "conceptual" -ms.assetid: 629b361a-2ce1-4700-8b5d-ab4f57b245d5 +ms.topic: "concept-article" --- # Type conversions and type safety @@ -105,7 +104,7 @@ The C-style cast operator is identical to the call operator () and is therefore int i = d; // warning C4244 possible loss of data int j = static_cast(d); // No warning. string s = static_cast(d); // Error C2440:cannot convert from - // double to std:string + // double to std::string // No error but not necessarily safe. Base* b = new Base(); @@ -173,7 +172,7 @@ The C-style cast operator is identical to the call operator () and is therefore ## See also -[C++ type system](../cpp/cpp-type-system-modern-cpp.md)
-[Welcome back to C++](../cpp/welcome-back-to-cpp-modern-cpp.md)
-[C++ Language Reference](../cpp/cpp-language-reference.md)
+[C++ type system](../cpp/cpp-type-system-modern-cpp.md)\ +[Welcome back to C++](../cpp/welcome-back-to-cpp-modern-cpp.md)\ +[C++ Language Reference](../cpp/cpp-language-reference.md)\ [C++ Standard Library](../standard-library/cpp-standard-library-reference.md) diff --git a/docs/cpp/unaligned.md b/docs/cpp/unaligned.md index ab25505fd0f..9892e057476 100644 --- a/docs/cpp/unaligned.md +++ b/docs/cpp/unaligned.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: __unaligned" title: "__unaligned" -ms.date: "12/17/2018" +description: "Learn more about: __unaligned" +ms.date: 12/17/2018 f1_keywords: ["__unaligned_cpp", "__unaligned", "_unaligned"] helpviewer_keywords: ["__unaligned keyword [C++]"] --- diff --git a/docs/cpp/unary-plus-and-negation-operators-plus-and.md b/docs/cpp/unary-plus-and-negation-operators-plus-and.md index be1f3402345..16c5a8ce9d8 100644 --- a/docs/cpp/unary-plus-and-negation-operators-plus-and.md +++ b/docs/cpp/unary-plus-and-negation-operators-plus-and.md @@ -27,12 +27,8 @@ The unary negation operator (**`-`**) produces the negative of its operand. The Integral promotion is performed on integral operands, and the resultant type is the type to which the operand is promoted. See [Standard Conversions](standard-conversions.md) for more information about how the promotion is performed. -**Microsoft Specific** - Unary negation of unsigned quantities is performed by subtracting the value of the operand from 2^n, where n is the number of bits in an object of the given unsigned type. -**END Microsoft Specific** - ## See also [Expressions with Unary Operators](../cpp/expressions-with-unary-operators.md)\ diff --git a/docs/cpp/unhook.md b/docs/cpp/unhook.md index c281450fafc..146b6502e07 100644 --- a/docs/cpp/unhook.md +++ b/docs/cpp/unhook.md @@ -64,7 +64,7 @@ A pointer to the event handler method to be unhooked from an event. The handler - Managed events: *`ReceiverClass`* is the event receiver class and *`HandlerMethod`* is the handler. -*`receiver`*(optional) +*`receiver`* (optional) A pointer to an instance of the event receiver class. If you don't specify a receiver, the default is the receiver class or structure in which **`__unhook`** is called. ## Usage diff --git a/docs/cpp/value-types-modern-cpp.md b/docs/cpp/value-types-modern-cpp.md index a3bed668f6a..8178c483c4a 100644 --- a/docs/cpp/value-types-modern-cpp.md +++ b/docs/cpp/value-types-modern-cpp.md @@ -2,7 +2,7 @@ description: "Learn more about: C++ classes as value types" title: "C++ classes as value types" ms.date: 06/09/2022 -ms.topic: "conceptual" +ms.topic: "concept-article" ms.assetid: f63bb62c-60da-40d5-ac14-4366608fe260 --- # C++ classes as value types diff --git a/docs/cpp/vectorcall.md b/docs/cpp/vectorcall.md index 97bca68b082..54209c78efd 100644 --- a/docs/cpp/vectorcall.md +++ b/docs/cpp/vectorcall.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: __vectorcall" title: "__vectorcall" -ms.date: "12/17/2018" +description: "Learn more about: __vectorcall" +ms.date: 12/17/2018 f1_keywords: ["__vectorcall_cpp", "__vectorcall", "_vectorcall"] helpviewer_keywords: ["__vectorcall keyword", "__vectorcall"] -ms.assetid: 1c95ed59-86c6-4857-b4ed-10519193f851 --- # __vectorcall diff --git a/docs/cpp/virtual-functions.md b/docs/cpp/virtual-functions.md index 665db8ecdf3..308dcd25756 100644 --- a/docs/cpp/virtual-functions.md +++ b/docs/cpp/virtual-functions.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Virtual Functions" title: "Virtual Functions" -ms.date: "09/10/2019" -helpviewer_keywords: ["functions [C++], virtual functions", "derived classes [C++], virtual functions", "virtual functions"] -ms.assetid: b3e1ed88-2a90-4af8-960a-16f47deb3452 +description: "Learn more about: Virtual Functions" +ms.date: 09/10/2019 adobe-target: true +helpviewer_keywords: ["functions [C++], virtual functions", "derived classes [C++], virtual functions", "virtual functions"] --- # Virtual Functions @@ -137,7 +136,7 @@ Because virtual functions are called only for objects of class types, you cannot The **`virtual`** keyword can be used when declaring overriding functions in a derived class, but it is unnecessary; overrides of virtual functions are always virtual. -Virtual functions in a base class must be defined unless they are declared using the *pure-specifier*. (For more information about pure virtual functions, see [Abstract Classes](../cpp/abstract-classes-cpp.md).) +Virtual functions in a base class must be defined unless they are declared using the *pure-specifier*. For more information about pure virtual functions, see [Abstract Classes](../cpp/abstract-classes-cpp.md). The virtual function-call mechanism can be suppressed by explicitly qualifying the function name using the scope-resolution operator (`::`). Consider the earlier example involving the `Account` class. To call `PrintBalance` in the base class, use code such as the following: diff --git a/docs/cpp/void-cpp.md b/docs/cpp/void-cpp.md index 09444a7cc04..b53334fff27 100644 --- a/docs/cpp/void-cpp.md +++ b/docs/cpp/void-cpp.md @@ -16,7 +16,7 @@ In C++, a **`void`** pointer can point to a free function (a function that's not You can't declare a variable of type **`void`**. -As a matter of style, the C++ Core Guidelines recommend you don't use **`void`** to specify an empty formal parameter list. For more information, see [C++ Core Guidelines NL.25: Don't use `void` as an argument type](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md#nl25-dont-use-void-as-an-argument-type). +As a matter of style, the C++ Core Guidelines recommend you don't use **`void`** to specify an empty formal parameter list. For more information, see [C++ Core Guidelines NL.25: Don't use `void` as an argument type](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#nl25-dont-use-void-as-an-argument-type). ## Example diff --git a/docs/cpp/welcome-back-to-cpp-modern-cpp.md b/docs/cpp/welcome-back-to-cpp-modern-cpp.md index dd8346fd6d2..dad330d014a 100644 --- a/docs/cpp/welcome-back-to-cpp-modern-cpp.md +++ b/docs/cpp/welcome-back-to-cpp-modern-cpp.md @@ -2,7 +2,7 @@ title: "Welcome back to C++ - Modern C++" description: "Describes the new programming idioms in Modern C++ and their rationale." ms.date: 06/02/2022 -ms.topic: "conceptual" +ms.topic: "concept-article" --- # Welcome back to C++ - Modern C++ diff --git a/docs/cppcx/attributes-c-cx.md b/docs/cppcx/attributes-c-cx.md index 38b2c2a6ec3..f7c87dca2b2 100644 --- a/docs/cppcx/attributes-c-cx.md +++ b/docs/cppcx/attributes-c-cx.md @@ -1,12 +1,11 @@ --- -description: "Learn more about: Attributes (C++/CX)" title: "Attributes (C++/CX)" -ms.date: "12/30/2016" -ms.assetid: 4438e03c-4de3-433d-abcc-31aa863bc0e0 +description: "Learn more about: Attributes (C++/CX)" +ms.date: 12/30/2016 --- # Attributes (C++/CX) -An attribute is a special kind of ref class that can be prepended in square brackets to Windows Runtime types and methods to specify certain behaviors in metadata creation. Several predefined attributes—for example, [Windows::Foundation::Metadata::WebHostHidden](/uwp/api/windows.foundation.metadata.webhosthiddenattribute)—are commonly used in C++/CX code. This example shows how the attribute is applied to a class: +An attribute is a special kind of ref class that can be prepended in square brackets to Windows Runtime types and methods to specify certain behaviors in metadata creation. Several predefined attributes—for example, [Windows::Foundation::Metadata::WebHostHidden](/uwp/api/windows.foundation.metadata.webhosthiddenattribute)—are commonly used in C++/CX code. This example shows how the attribute is applied to a class: [!code-cpp[cx_attributes#01](../cppcx/codesnippet/CPP/cx_attributes/class1.h#01)] diff --git a/docs/cppcx/codesnippet/CPP/cppcx_strings/class1.cpp b/docs/cppcx/codesnippet/CPP/cppcx_strings/class1.cpp index cdc05a2c214..654cf20fe9e 100644 --- a/docs/cppcx/codesnippet/CPP/cppcx_strings/class1.cpp +++ b/docs/cppcx/codesnippet/CPP/cppcx_strings/class1.cpp @@ -55,11 +55,11 @@ void Test1() if (str1 == str2) { /* ... */ } if (str1->Equals(str2)) { /* ... */ } if (str1 != str2) { /* ... */ } - if (str1 < str2 || str1 > str2) { /* ... */}; + if (str1 < str2 || str1 > str2) { /* ... */ } int result = String::CompareOrdinal(str1, str2); - if(str1 == nullptr) { /* ...*/}; - if(str1->IsEmpty()) { /* ...*/}; + if (str1 == nullptr) { /* ...*/ } + if (str1->IsEmpty()) { /* ...*/ } // Accessing individual characters in a String^ auto it = str1->Begin(); diff --git a/docs/cppcx/codesnippet/CPP/partialclassexample/class1.h b/docs/cppcx/codesnippet/CPP/partialclassexample/class1.h index 52efa84e747..9e8425b3b8f 100644 --- a/docs/cppcx/codesnippet/CPP/partialclassexample/class1.h +++ b/docs/cppcx/codesnippet/CPP/partialclassexample/class1.h @@ -21,7 +21,7 @@ namespace PartialClassExample /* // This is commented out because it causes - // a compile error in Delcaration #6 due to mc already being defined. + // a compile error in Declaration #6 due to mc already being defined. // the error is understood. The example is most effective showing // the various declaration rules all in one example like this. // diff --git a/docs/cppcx/codesnippet/CPP/walkthrough-creating-a-windows-store-app-using-wrl-and-media-foundation_4.cpp b/docs/cppcx/codesnippet/CPP/walkthrough-creating-a-windows-store-app-using-wrl-and-media-foundation_4.cpp index d5b8967bfde..9bdeebfd49e 100644 --- a/docs/cppcx/codesnippet/CPP/walkthrough-creating-a-windows-store-app-using-wrl-and-media-foundation_4.cpp +++ b/docs/cppcx/codesnippet/CPP/walkthrough-creating-a-windows-store-app-using-wrl-and-media-foundation_4.cpp @@ -252,7 +252,7 @@ MFT_GRAYSCALE_SATURATION (type = double) MFT_GRAYSCALE_CHROMA_ROTATION (type = double) - Rotates the chroma values of each pixel. The attribue value is the angle of + Rotates the chroma values of each pixel. The attribute value is the angle of rotation in degrees. The result is a shift in hue. The effect is implemented by treating the chroma value of each pixel as a vector [u,v], @@ -351,7 +351,7 @@ void TransformChroma(const D2D1::Matrix3x2F& mat, BYTE *pu, BYTE *pv) // // The image conversion functions take the following parameters: // -// mat Transfomation matrix for chroma values. +// mat Transformation matrix for chroma values. // rcDest Destination rectangle. // pDest Pointer to the destination buffer. // lDestStride Stride of the destination buffer, in bytes. diff --git a/docs/cppcx/collections-c-cx.md b/docs/cppcx/collections-c-cx.md index 9785f9056ed..2471f4f3bb9 100644 --- a/docs/cppcx/collections-c-cx.md +++ b/docs/cppcx/collections-c-cx.md @@ -1,7 +1,7 @@ --- title: "Collections (C++/CX)" description: "Learn more about: Collections (C++/CX)" -ms.date: "11/19/2018" +ms.date: 11/19/2018 --- # Collections (C++/CX) @@ -9,57 +9,57 @@ In a C++/CX program, you can make free use of Standard Template Library (STL) co The Windows Runtime defines the interfaces for collections and related types, and C++/CX provides the concrete C++ implementations in the collection.h header file. This illustration shows the relationships between the collection types: -![Diagram of C plus plus C X inheritance tree for collection types.](../cppcx/media/cppcxcollectionsinheritancetree.png) +![Diagram of C plus plus C X inheritance tree for collection types.](media/cppcxcollectionsinheritancetree.png) -- The [Platform::Collections::Vector class](../cppcx/platform-collections-vector-class.md) resembles the [std::vector class](../standard-library/vector-class.md). +- The [`Platform::Collections::Vector` class](platform-collections-vector-class.md) resembles the [`std::vector` class](../standard-library/vector-class.md). -- The [Platform::Collections::Map class](../cppcx/platform-collections-map-class.md) resembles the [std::map class](../standard-library/map-class.md). +- The [`Platform::Collections::Map` class](platform-collections-map-class.md) resembles the [`std::map` class](../standard-library/map-class.md). -- [Platform::Collections::VectorView class](../cppcx/platform-collections-vectorview-class.md) and [Platform::Collections::MapView class](../cppcx/platform-collections-mapview-class.md) are read-only versions of `Vector` and `Map`. +- [`Platform::Collections::VectorView` class](platform-collections-vectorview-class.md) and [`Platform::Collections::MapView` class](platform-collections-mapview-class.md) are read-only versions of `Vector` and `Map`. -- Iterators are defined in the [Platform::Collections Namespace](../cppcx/platform-collections-namespace.md). These iterators satisfy the requirements for STL iterators and enable the use of [std::find](../standard-library/algorithm-functions.md#find), [std::count_if](../standard-library/algorithm-functions.md#count_if), and other STL algorithms on any [Windows::Foundation::Collections](/uwp/api/windows.foundation.collections) interface type or [Platform::Collections](../cppcx/platform-collections-namespace.md) concrete type. For example, this means that you can iterate a collection in a Windows Runtime component that's created in C# and apply an STL algorithm to it. +- Iterators are defined in the [`Platform::Collections` Namespace](platform-collections-namespace.md). These iterators satisfy the requirements for STL iterators and enable the use of [`std::find`](../standard-library/algorithm-functions.md#find), [`std::count_if`](../standard-library/algorithm-functions.md#count_if), and other STL algorithms on any [`Windows::Foundation::Collections`](/uwp/api/windows.foundation.collections) interface type or [`Platform::Collections`](platform-collections-namespace.md) concrete type. For example, this means that you can iterate a collection in a Windows Runtime component that's created in C# and apply an STL algorithm to it. > [!IMPORTANT] - > Proxy iterators `VectorIterator` and `VectorViewIterator` utilize proxy objects `VectoryProxy` and `ArrowProxy` to enable usage with STL containers. For more information, see "VectorProxy elements" later in this article. + > Proxy iterators `VectorIterator` and `VectorViewIterator` utilize proxy objects `VectorProxy` and `ArrowProxy` to enable usage with STL containers. For more information, see [VectorProxy elements](#vectorproxy-elements) later in this article. - The C++/CX collection types support the same thread safety guarantees that STL containers support. -- [Windows::Foundation::Collections::IObservableVector](/uwp/api/windows.foundation.collections.iobservablevector-1) and [Windows::Foundation::Collections::IObservableMap](/uwp/api/windows.foundation.collections.iobservablemap-2) define events that are fired when the collection changes in various ways. By implementing these interfaces, [Platform::Collections::Map](../cppcx/platform-collections-map-class.md) and [Platform::Collections::Vector](../cppcx/platform-collections-vector-class.md) support databinding with XAML collections. For example, if you have a `Vector` that is data-bound to a `Grid`, when you add an item to a collection, the change is reflected in the Grid UI. +- [`Windows::Foundation::Collections::IObservableVector`](/uwp/api/windows.foundation.collections.iobservablevector-1) and [`Windows::Foundation::Collections::IObservableMap`](/uwp/api/windows.foundation.collections.iobservablemap-2) define events that are fired when the collection changes in various ways. By implementing these interfaces, [`Platform::Collections::Map`](platform-collections-map-class.md) and [`Platform::Collections::Vector`](platform-collections-vector-class.md) support databinding with XAML collections. For example, if you have a `Vector` that is data-bound to a `Grid`, when you add an item to a collection, the change is reflected in the Grid UI. ## Vector usage -When your class has to pass a sequence container to another Windows Runtime component, use [Windows::Foundation::Collections:: IVector\](/uwp/api/windows.foundation.collections.ivector-1) as the parameter or return type, and [Platform::Collections::Vector\](../cppcx/platform-collections-vector-class.md) as the concrete implementation. If you attempt to use a `Vector` type in a public return value or parameter, compiler error C3986 will be raised. You can fix the error by changing the `Vector` to an `IVector`. +When your class has to pass a sequence container to another Windows Runtime component, use [`Windows::Foundation::Collections::IVector`](/uwp/api/windows.foundation.collections.ivector-1) as the parameter or return type, and [`Platform::Collections::Vector`](platform-collections-vector-class.md) as the concrete implementation. If you attempt to use a `Vector` type in a public return value or parameter, compiler error C3986 will be raised. You can fix the error by changing the `Vector` to an `IVector`. > [!IMPORTANT] > If you are passing a sequence within your own program, then use either `Vector` or `std::vector` because they are more efficient than `IVector`. Use `IVector` only when you pass the container across the ABI. > > The Windows Runtime type system does not support the concept of jagged arrays and therefore you cannot pass an `IVector>` as a return value or method parameter. To pass a jagged array or a sequence of sequences across the ABI, use `IVector^>`. -`Vector` provides the methods that are required for adding, removing, and accessing items in the collection, and it is implicitly convertible to `IVector`. You can also use STL algorithms on instances of `Vector`. The following example demonstrates some basic usage. The [begin function](../cppcx/begin-function.md) and [end function](../cppcx/end-function.md) here are from the `Platform::Collections` namespace, not the `std` namespace. +`Vector` provides the methods that are required for adding, removing, and accessing items in the collection, and it is implicitly convertible to `IVector`. You can also use STL algorithms on instances of `Vector`. The following example demonstrates some basic usage. The [`begin` function](begin-function.md) and [`end` function](end-function.md) here are from the `Platform::Collections` namespace, not the `std` namespace. -[!code-cpp[cx_collections#01](../cppcx/codesnippet/CPP/collections/class1.cpp#01)] +[!code-cpp[cx_collections#01](codesnippet/CPP/collections/class1.cpp#01)] If you have existing code that uses `std::vector` and you want to reuse it in a Windows Runtime component, just use one of the `Vector` constructors that takes a `std::vector` or a pair of iterators to construct a `Vector` at the point where you pass the collection across the ABI. The following example shows how to use the `Vector` move constructor for efficient initialization from a `std::vector`. After the move operation, the original `vec` variable is no longer valid. -[!code-cpp[cx_collections#02](../cppcx/codesnippet/CPP/collections/class1.cpp#02)] +[!code-cpp[cx_collections#02](codesnippet/CPP/collections/class1.cpp#02)] -If you have a vector of strings that you must pass across the ABI at some future point, you must decide whether to create the strings initially as `std::wstring` types or as `Platform::String^` types. If you have to do a lot of processing on the strings, then use `wstring`. Otherwise, create the strings as `Platform::String^` types and avoid the cost of converting them later. You must also decide whether to put these strings into a `std:vector` or `Platform::Collections::Vector` internally. As a general practice, use `std::vector` and then create a `Platform::Vector` from it only when you pass the container across the ABI. +If you have a vector of strings that you must pass across the ABI at some future point, you must decide whether to create the strings initially as `std::wstring` types or as `Platform::String^` types. If you have to do a lot of processing on the strings, then use `wstring`. Otherwise, create the strings as `Platform::String^` types and avoid the cost of converting them later. You must also decide whether to put these strings into a `std::vector` or `Platform::Collections::Vector` internally. As a general practice, use `std::vector` and then create a `Platform::Vector` from it only when you pass the container across the ABI. ## Value types in Vector -Any element to be stored in a [Platform::Collections::Vector](../cppcx/platform-collections-vector-class.md) must support equality comparison, either implicitly or by using a custom [std::equal_to](../standard-library/equal-to-struct.md) comparator that you provide. All reference types and all scalar types implicitly support equality comparisons. For non-scalar value types such as [Windows::Foundation::DateTime](/uwp/api/windows.foundation.datetime), or for custom comparisons—for example, `objA->UniqueID == objB->UniqueID`—you must provide a custom function object. +Any element to be stored in a [`Platform::Collections::Vector`](platform-collections-vector-class.md) must support equality comparison, either implicitly or by using a custom [`std::equal_to`](../standard-library/equal-to-struct.md) comparator that you provide. All reference types and all scalar types implicitly support equality comparisons. For non-scalar value types such as [`Windows::Foundation::DateTime`](/uwp/api/windows.foundation.datetime), or for custom comparisons—for example, `objA->UniqueID == objB->UniqueID`—you must provide a custom function object. ## VectorProxy elements -[Platform::Collections::VectorIterator](../cppcx/platform-collections-vectoriterator-class.md) and [Platform::Collections::VectorViewIterator](../cppcx/platform-collections-vectorviewiterator-class.md) enable the use of `range for` loops and algorithms like [std::sort](../standard-library/algorithm-functions.md#sort) with an [IVector\](/uwp/api/windows.foundation.collections.ivector-1) container. But `IVector` elements cannot be accessed through C++ pointer dereference; they can be accessed only through [GetAt](/uwp/api/windows.foundation.collections.ivector-1.getat) and [SetAt](/uwp/api/windows.foundation.collections.ivector-1.setat) methods. Therefore, these iterators use the proxy classes `Platform::Details::VectorProxy` and `Platform::Details::ArrowProxy` to provide access to the individual elements through __\*__, __->__, and __\[]__ operators, as required by the Standard Library. Strictly speaking, given an `IVector vec`, the type of `*begin(vec)` is `VectorProxy`. However, the proxy object is almost always transparent to your code. These proxy objects are not documented because they are only for internal use by the iterators, but it is useful to know how the mechanism works. +[`Platform::Collections::VectorIterator`](platform-collections-vectoriterator-class.md) and [`Platform::Collections::VectorViewIterator`](platform-collections-vectorviewiterator-class.md) enable the use of `range for` loops and algorithms like [`std::sort`](../standard-library/algorithm-functions.md#sort) with an [`IVector`](/uwp/api/windows.foundation.collections.ivector-1) container. But `IVector` elements cannot be accessed through C++ pointer dereference; they can be accessed only through [`GetAt`](/uwp/api/windows.foundation.collections.ivector-1.getat) and [`SetAt`](/uwp/api/windows.foundation.collections.ivector-1.setat) methods. Therefore, these iterators use the proxy classes `Platform::Details::VectorProxy` and `Platform::Details::ArrowProxy` to provide access to the individual elements through **`*`**, **`->`**, and **`[]`** operators, as required by the Standard Library. Strictly speaking, given an `IVector vec`, the type of `*begin(vec)` is `VectorProxy`. However, the proxy object is almost always transparent to your code. These proxy objects are not documented because they are only for internal use by the iterators, but it is useful to know how the mechanism works. -When you use a range-based **`for`** loop over `IVector` containers, use `auto&&` to enable the iterator variable to bind correctly to the `VectorProxy` elements. If you use `auto&`, compiler warning [C4239](../error-messages/compiler-warnings/compiler-warning-level-4-c4239.md) is raised and `VectoryProxy` is mentioned in the warning text. +When you use a range-based **`for`** loop over `IVector` containers, use `auto&&` to enable the iterator variable to bind correctly to the `VectorProxy` elements. If you use `auto&`, compiler warning [C4239](../error-messages/compiler-warnings/compiler-warning-level-4-c4239.md) is raised and `VectorProxy` is mentioned in the warning text. The following illustration shows a `range for` loop over an `IVector`. Notice that execution is stopped on the breakpoint on line 64. The **QuickWatch** window shows that the iterator variable `p` is in fact a `VectorProxy` that has `m_v` and `m_i` member variables. However, when you call `GetType` on this variable, it returns the identical type to the `Person` instance `p2`. The takeaway is that although `VectorProxy` and `ArrowProxy` might appear in **QuickWatch**, the debugger certain compiler errors, or other places, you typically don't have to explicitly code for them. -![Screenshot of debugging VectorProxy in a range based for loop.](../cppcx/media/vectorproxy-1.png) +![Screenshot of debugging VectorProxy in a range based for loop.](media/vectorproxy-1.png) -One scenario in which you have to code around the proxy object is when you have to perform a **`dynamic_cast`** on the elements—for example, when you are looking for XAML objects of a particular type in a `UIElement` element collection. In this case, you must first cast the element to [Platform::Object](../cppcx/platform-object-class.md)^ and then perform the dynamic cast: +One scenario in which you have to code around the proxy object is when you have to perform a **`dynamic_cast`** on the elements—for example, when you are looking for XAML objects of a particular type in a `UIElement` element collection. In this case, you must first cast the element to [`Platform::Object`](platform-object-class.md)^ and then perform the dynamic cast: ```cpp void FindButton(UIElementCollection^ col) @@ -78,67 +78,67 @@ void FindButton(UIElementCollection^ col) ## Map usage -This example shows how to insert items and look them up in a [Platform::Collections::Map](../cppcx/platform-collections-map-class.md), and then return the `Map` as a read-only [Windows::Foundation::Collections::IMapView](/uwp/api/windows.foundation.collections.imapview-2) type. +This example shows how to insert items and look them up in a [`Platform::Collections::Map`](platform-collections-map-class.md), and then return the `Map` as a read-only [`Windows::Foundation::Collections::IMapView`](/uwp/api/windows.foundation.collections.imapview-2) type. -[!code-cpp[cx_collections#04](../cppcx/codesnippet/CPP/collections/class1.cpp#04)] +[!code-cpp[cx_collections#04](codesnippet/CPP/collections/class1.cpp#04)] -In general, for internal map functionality, prefer the `std::map` type for performance reasons. If you have to pass the container across the ABI, construct a [Platform::Collections::Map](../cppcx/platform-collections-map-class.md) from the [std::map](../standard-library/map-class.md) and return the `Map` as an [Windows::Foundation::Collections::IMap](/uwp/api/windows.foundation.collections.imap-2). If you attempt to use a `Map` type in a public return value or parameter, compiler error C3986 will be raised. You can fix the error by changing the `Map` to an `IMap`. In some cases—for example, if you are not making a large number of lookups or insertions, and you are passing the collection across the ABI frequently—it might be less expensive to use `Platform::Collections::Map` from the beginning and avoid the cost of converting the `std::map`. In any case, avoid lookup and insert operations on an `IMap` because these are the least performant of the three types. Convert to `IMap` only at the point that you pass the container across the ABI. +In general, for internal map functionality, prefer the `std::map` type for performance reasons. If you have to pass the container across the ABI, construct a [`Platform::Collections::Map`](platform-collections-map-class.md) from the [`std::map`](../standard-library/map-class.md) and return the `Map` as an [`Windows::Foundation::Collections::IMap`](/uwp/api/windows.foundation.collections.imap-2). If you attempt to use a `Map` type in a public return value or parameter, compiler error C3986 will be raised. You can fix the error by changing the `Map` to an `IMap`. In some cases—for example, if you are not making a large number of lookups or insertions, and you are passing the collection across the ABI frequently—it might be less expensive to use `Platform::Collections::Map` from the beginning and avoid the cost of converting the `std::map`. In any case, avoid lookup and insert operations on an `IMap` because these are the least performant of the three types. Convert to `IMap` only at the point that you pass the container across the ABI. ## Value types in Map -Elements in a [Platform::Collections::Map](../cppcx/platform-collections-map-class.md) are ordered. Any element to be stored in a `Map` must support less-than comparison with strict weak ordering, either implicitly or by using a custom [stl::less](../standard-library/less-struct.md) comparator that you provide. Scalar types support the comparison implicitly. For non-scalar value types such as `Windows::Foundation::DateTime`, or for custom comparisons—for example, `objA->UniqueID < objB->UniqueID`—you must provide a custom comparator. +Elements in a [`Platform::Collections::Map`](platform-collections-map-class.md) are ordered. Any element to be stored in a `Map` must support less-than comparison with strict weak ordering, either implicitly or by using a custom [`std::less`](../standard-library/less-struct.md) comparator that you provide. Scalar types support the comparison implicitly. For non-scalar value types such as `Windows::Foundation::DateTime`, or for custom comparisons—for example, `objA->UniqueID < objB->UniqueID`—you must provide a custom comparator. ## Collection types Collections fall into four categories: modifiable versions and read-only versions of sequence collections and associative collections. In addition, C++/CX enhances collections by providing three iterator classes that simplify the accessing of collections. -Elements of a modifiable collection can be changed, but elements of a read-only collection, which is known as a *view*, can only be read. Elements of a [Platform::Collections::Vector](../cppcx/platform-collections-vector-class.md) or[Platform::Collections::VectorView](../cppcx/platform-collections-vectorview-class.md) collection can be accessed by using an iterator or the collection's [Vector::GetAt](../cppcx/platform-collections-vector-class.md#getat) and an index. Elements of an associative collection can be accessed by using the collection's [Map::Lookup](../cppcx/platform-collections-map-class.md#lookup) and a key. +Elements of a modifiable collection can be changed, but elements of a read-only collection, which is known as a *view*, can only be read. Elements of a [`Platform::Collections::Vector`](platform-collections-vector-class.md) or [`Platform::Collections::VectorView`](platform-collections-vectorview-class.md) collection can be accessed by using an iterator or the collection's [`Vector::GetAt`](platform-collections-vector-class.md#getat) and an index. Elements of an associative collection can be accessed by using the collection's [`Map::Lookup`](platform-collections-map-class.md#lookup) and a key. -[Platform::Collections::Map class](../cppcx/platform-collections-map-class.md)
+[`Platform::Collections::Map` class](platform-collections-map-class.md)\ A modifiable, associative collection. Map elements are key-value pairs. Looking up a key to retrieve its associated value, and iterating through all key-value pairs, are both supported. -`Map` and `MapView` are templated on `>`; therefore, you can customize the comparator. Additionally, `Vector` and `VectorView` are templated on `>` so that you can customize the behavior of `IndexOf()`. This is important mostly for `Vector` and `VectorView` of value structs. For example, to create a Vector\, you must provide a custom comparator because DateTime does not overload the == operator. +`Map` and `MapView` are templated on `>`; therefore, you can customize the comparator. Additionally, `Vector` and `VectorView` are templated on `>` so that you can customize the behavior of `IndexOf()`. This is important mostly for `Vector` and `VectorView` of value structs. For example, to create a `Vector`, you must provide a custom comparator because DateTime does not overload the `==` operator. -[Platform::Collections::MapView class](../cppcx/platform-collections-mapview-class.md)
+[`Platform::Collections::MapView` class](platform-collections-mapview-class.md)\ A read-only version of a `Map`. -[Platform::Collections::Vector class](../cppcx/platform-collections-vector-class.md)
-A modifiable sequence collection. `Vector` supports constant-time random access and amortized-constant-time [Append](../cppcx/platform-collections-vector-class.md#append) operations.. +[`Platform::Collections::Vector` class](platform-collections-vector-class.md)\ +A modifiable sequence collection. `Vector` supports constant-time random access and amortized-constant-time [`Append`](platform-collections-vector-class.md#append) operations. -[Platform::Collections::VectorView class](../cppcx/platform-collections-vectorview-class.md)
+[`Platform::Collections::VectorView` class](platform-collections-vectorview-class.md)\ A read-only version of a `Vector`. -[Platform::Collections::InputIterator class](../cppcx/platform-collections-inputiterator-class.md)
+[`Platform::Collections::InputIterator` class](platform-collections-inputiterator-class.md)\ An STL iterator that satisfies the requirements of an STL input iterator. -[Platform::Collections::VectorIterator class](../cppcx/platform-collections-vectoriterator-class.md)
+[`Platform::Collections::VectorIterator` class](platform-collections-vectoriterator-class.md)\ An STL iterator that satisfies the requirements of an STL mutable random-access iterator. -[Platform::Collections::VectorViewIterator class](../cppcx/platform-collections-vectorviewiterator-class.md)
-An STL iterator that satisfies the requirements of an STL **`const`** random-access iterator. +[`Platform::Collections::VectorViewIterator` class](platform-collections-vectorviewiterator-class.md)\ +An STL iterator that satisfies the requirements of an STL **`const`** random-access iterator. ### begin() and end() functions -To simplify the use of the STL to process `Vector`, `VectorView`, `Map`, `MapView`, and arbitrary `Windows::Foundation::Collections` objects, C++/CX supports overloads of the [begin Function](../cppcx/begin-function.md) and [end Function](../cppcx/end-function.md) non-member functions. +To simplify the use of the STL to process `Vector`, `VectorView`, `Map`, `MapView`, and arbitrary `Windows::Foundation::Collections` objects, C++/CX supports overloads of the [`begin` Function](begin-function.md) and [`end` Function](end-function.md) non-member functions. The following table lists the available iterators and functions. |Iterators|Functions| |---------------|---------------| -|[Platform::Collections::VectorIterator\](../cppcx/platform-collections-vectoriterator-class.md)

(Internally stores [Windows::Foundation::Collections:: IVector\](/uwp/api/windows.foundation.collections.ivector-1) and int.)|[begin](../cppcx/begin-function.md)/ [end](../cppcx/end-function.md)([Windows::Foundation::Collections:: IVector\](/uwp/api/windows.foundation.collections.ivector-1))| -|[Platform::Collections::VectorViewIterator\](../cppcx/platform-collections-vectorviewiterator-class.md)

(Internally stores [IVectorView\](/uwp/api/windows.foundation.collections.ivectorview-1)^ and int.)|[begin](../cppcx/begin-function.md)/ [end](../cppcx/end-function.md) ([IVectorView\](/uwp/api/windows.foundation.collections.ivectorview-1)^)| -|[Platform::Collections::InputIterator\](../cppcx/platform-collections-inputiterator-class.md)

(Internally stores [IIterator\](/uwp/api/windows.foundation.collections.iiterator-1)^ and T.)|[begin](../cppcx/begin-function.md)/ [end](../cppcx/end-function.md) ([IIterable\](/uwp/api/windows.foundation.collections.iiterable-1))| -|[Platform::Collections::InputIterator^>](../cppcx/platform-collections-inputiterator-class.md)

(Internally stores [IIterator\](/uwp/api/windows.foundation.collections.iiterator-1)^ and T.)|[begin](../cppcx/begin-function.md)/ [end](../cppcx/end-function.md) ([IMap\](/uwp/api/windows.foundation.collections.imap-2).| -|[Platform::Collections::InputIterator^>](../cppcx/platform-collections-inputiterator-class.md)

(Internally stores [IIterator\](/uwp/api/windows.foundation.collections.iiterator-1)^ and T.)|[begin](../cppcx/begin-function.md)/ [end](../cppcx/end-function.md) ([Windows::Foundation::Collections::IMapView](/uwp/api/windows.foundation.collections.imapview-2))| +|[`Platform::Collections::VectorIterator`](platform-collections-vectoriterator-class.md)

(Internally stores [`Windows::Foundation::Collections::IVector`](/uwp/api/windows.foundation.collections.ivector-1) and `int`.)|[`begin`](begin-function.md)/ [`end`](end-function.md)([`Windows::Foundation::Collections::IVector`](/uwp/api/windows.foundation.collections.ivector-1))| +|[`Platform::Collections::VectorViewIterator`](platform-collections-vectorviewiterator-class.md)

(Internally stores [`IVectorView`](/uwp/api/windows.foundation.collections.ivectorview-1)^ and `int`.)|[`begin`](begin-function.md)/ [`end`](end-function.md) ([`IVectorView`](/uwp/api/windows.foundation.collections.ivectorview-1)^)| +|[`Platform::Collections::InputIterator`](platform-collections-inputiterator-class.md)

(Internally stores [`IIterator`](/uwp/api/windows.foundation.collections.iiterator-1)^ and `T`.)|[`begin`](begin-function.md)/ [`end`](end-function.md) ([`IIterable`](/uwp/api/windows.foundation.collections.iiterable-1))| +|[`Platform::Collections::InputIterator^>`](platform-collections-inputiterator-class.md)

(Internally stores [`IIterator`](/uwp/api/windows.foundation.collections.iiterator-1)^ and `T`.)|[`begin`](begin-function.md)/ [`end`](end-function.md) ([`IMap`](/uwp/api/windows.foundation.collections.imap-2))| +|[`Platform::Collections::InputIterator^>`](platform-collections-inputiterator-class.md)

(Internally stores [`IIterator`](/uwp/api/windows.foundation.collections.iiterator-1)^ and `T`.)|[`begin`](begin-function.md)/ [`end`](end-function.md) ([`Windows::Foundation::Collections::IMapView`](/uwp/api/windows.foundation.collections.imapview-2))| ### Collection change events `Vector` and `Map` support databinding in XAML collections by implementing events that occur when a collection object is changed or reset, or when any element of a collection is inserted, removed, or changed. You can write your own types that support databinding, although you cannot inherit from `Map` or `Vector` because those types are sealed. -The [Windows::Foundation::Collections::VectorChangedEventHandler](/uwp/api/windows.foundation.collections.vectorchangedeventhandler-1) and [Windows::Foundation::Collections::MapChangedEventHandler](/uwp/api/windows.foundation.collections.mapchangedeventhandler-2) delegates specify the signatures for event handlers for collection change events. The [Windows::Foundation::Collections::CollectionChange](/uwp/api/windows.foundation.collections.collectionchange) public enum class, and `Platform::Collection::Details::MapChangedEventArgs` and `Platform::Collections::Details::VectorChangedEventArgs` ref classes, store the event arguments to determine what caused the event. The `*EventArgs` types are defined in the `Details` namespace because you don't have to construct or consume them explicitly when you use `Map` or `Vector`. +The [`Windows::Foundation::Collections::VectorChangedEventHandler`](/uwp/api/windows.foundation.collections.vectorchangedeventhandler-1) and [`Windows::Foundation::Collections::MapChangedEventHandler`](/uwp/api/windows.foundation.collections.mapchangedeventhandler-2) delegates specify the signatures for event handlers for collection change events. The [`Windows::Foundation::Collections::CollectionChange`](/uwp/api/windows.foundation.collections.collectionchange) public enum class, and `Platform::Collections::Details::MapChangedEventArgs` and `Platform::Collections::Details::VectorChangedEventArgs` ref classes, store the event arguments to determine what caused the event. The `*EventArgs` types are defined in the `Details` namespace because you don't have to construct or consume them explicitly when you use `Map` or `Vector`. ## See also -[Type System](../cppcx/type-system-c-cx.md)\ -[C++/CX Language Reference](../cppcx/visual-c-language-reference-c-cx.md)\ -[Namespaces Reference](../cppcx/namespaces-reference-c-cx.md) +[Type System](type-system-c-cx.md)\ +[C++/CX Language Reference](visual-c-language-reference-c-cx.md)\ +[Namespaces Reference](namespaces-reference-c-cx.md) diff --git a/docs/cppcx/crt-functions-not-supported-in-universal-windows-platform-apps.md b/docs/cppcx/crt-functions-not-supported-in-universal-windows-platform-apps.md index 602af8f2765..9291df90ccb 100644 --- a/docs/cppcx/crt-functions-not-supported-in-universal-windows-platform-apps.md +++ b/docs/cppcx/crt-functions-not-supported-in-universal-windows-platform-apps.md @@ -1,8 +1,7 @@ --- title: "CRT functions not supported in Universal Windows Platform apps" description: "Reference guide to CRT functions not supported in Universal Windows Platform apps." -ms.date: "04/16/2020" -ms.assetid: cbfc957d-6c60-48f4-97e3-1ed8526743b4 +ms.date: 04/16/2020 --- # CRT functions not supported in Universal Windows Platform apps @@ -47,4 +46,4 @@ Both the previously mentioned APIs and the following APIs are unavailable in Win |`_chdir` `_wchdir` `_getcwd` `_getdcwd` `_wgetcwd` `_wgetdcwd`|The concept of a working directory doesn't apply to Windows 8.x Store apps.|Use full paths instead.| |`_isleadbyte_l` `_ismbbalnum`, `_ismbbalnum_l`, `_ismbbalpha`, `_ismbbalpha` `_ismbbalpha_l` `_ismbbgraph` `_ismbbgraph_l` `_ismbbkalnum` `_ismbbkalnum_l` `_ismbbkana` `_ismbbkana_l` `_ismbbkprint` `_ismbbkprint_l` `_ismbbkpunct` `_ismbbkpunct_l` `_ismbblead` `_ismbblead_l` `_ismbbprint` `_ismbbprint_l` `_ismbbpunct` `_ismbbpunct_l` `_ismbbtrail` `_ismbbtrail_l` `_ismbslead` `_ismbslead_l` `_ismbstrail` `_ismbstrail_l` `_mbsdup` `isleadbyte`|Multi-byte strings are not supported in Windows 8.x Store apps.|Use Unicode strings instead.| |`_tzset`|Environment variables are not available to Windows 8.x Store apps.|No workaround.| -|`_get_heap_handle`, `_heapmin`|The corresponding Win32 APIs are not supported in Windows 8.x Store apps. And, apps can no longer create private heaps.|No workaround. However, ``_get_heap_handle`` is available in the DEBUG CRT, for debugging purposes only.| +|`_get_heap_handle`, `_heapmin`|The corresponding Win32 APIs are not supported in Windows 8.x Store apps. And, apps can no longer create private heaps.|No workaround. However, `_get_heap_handle` is available in the DEBUG CRT, for debugging purposes only.| diff --git a/docs/cppcx/delegates-c-cx.md b/docs/cppcx/delegates-c-cx.md index af0f96e6d68..3ea53942eb7 100644 --- a/docs/cppcx/delegates-c-cx.md +++ b/docs/cppcx/delegates-c-cx.md @@ -18,7 +18,7 @@ Delegates are most commonly used in conjunction with events. An event has a dele event PrimeFoundHandler^ primeFoundEvent; ``` -When declaring delegates that will be exposed to clients across the Windows Runtime application binary interface, use [Windows::Foundation::TypedEventHandler\](/uwp/api/windows.foundation.typedeventhandler-2). This delegate has predefined proxy and stub binaries that enable it to be consumed by Javascript clients. +When declaring delegates that will be exposed to clients across the Windows Runtime application binary interface, use [Windows::Foundation::TypedEventHandler\](/uwp/api/windows.foundation.typedeventhandler-2). This delegate has predefined proxy and stub binaries that enable it to be consumed by JavaScript clients. ## Consuming delegates diff --git a/docs/cppcx/deprecating-types-and-members-c-cx.md b/docs/cppcx/deprecating-types-and-members-c-cx.md index 85471b58e54..8c17a5e3a88 100644 --- a/docs/cppcx/deprecating-types-and-members-c-cx.md +++ b/docs/cppcx/deprecating-types-and-members-c-cx.md @@ -1,6 +1,6 @@ --- -description: "Learn more about: Deprecating types and members (C++/CX)" title: "Deprecating types and members (C++/CX)" +description: "Learn more about: Deprecating types and members (C++/CX)" ms.date: 01/07/2022 no-loc: [ "class", "delegate", "enum", "field", "interface", "method", "property", "struct" ] --- @@ -13,7 +13,7 @@ C++/CX supports deprecation of Windows Runtime types and members for producers a ## Example -The following example shows how to deprecate your own public APIs—for example, in a Windows Runtime component. The second parameter, of type [`Windows:Foundation::Metadata::DeprecationType`](/uwp/api/windows.foundation.metadata.deprecationtype) specifies whether the API is being deprecated or removed. Currently only the `DeprecationType::Deprecated` value is supported. The third parameter in the attribute specifies the [`Windows::Foundation::Metadata::Platform`](/uwp/api/windows.foundation.metadata.platformattribute) to which the attribute applies. +The following example shows how to deprecate your own public APIs—for example, in a Windows Runtime component. The second parameter, of type [`Windows::Foundation::Metadata::DeprecationType`](/uwp/api/windows.foundation.metadata.deprecationtype) specifies whether the API is being deprecated or removed. Currently only the `DeprecationType::Deprecated` value is supported. The third parameter in the attribute specifies the [`Windows::Foundation::Metadata::Platform`](/uwp/api/windows.foundation.metadata.platformattribute) to which the attribute applies. ```cpp namespace wfm = Windows::Foundation::Metadata; diff --git a/docs/cppcx/fundamental-types-c-cx.md b/docs/cppcx/fundamental-types-c-cx.md index 4f1bd6c1d8b..47155e3cdb7 100644 --- a/docs/cppcx/fundamental-types-c-cx.md +++ b/docs/cppcx/fundamental-types-c-cx.md @@ -1,12 +1,11 @@ --- -description: "Learn more about: Fundamental types (C++/CX)" title: "Fundamental types (C++/CX)" +description: "Learn more about: Fundamental types (C++/CX)" ms.date: "01/22/2017" -ms.assetid: c9f82907-25f2-440b-91d6-afb8dbd46ea6 --- # Fundamental types (C++/CX) -In addition to the standard C++ built-in types, C++/CX supports the type system that's defined by the Windows Runtime architecture by providing typedefs for the Windows Runtime fundamental types that map to standard C++ types.. C++/CX implements Boolean, character, and numeric fundamental types. These typedefs are defined in the `default` namespace, which never needs to be specified explicitly. In addition, C++/CX provides wrappers and concrete implementations for certain Windows Runtime types and interfaces. +In addition to the standard C++ built-in types, C++/CX supports the type system that's defined by the Windows Runtime architecture by providing typedefs for the Windows Runtime fundamental types that map to standard C++ types. C++/CX implements Boolean, character, and numeric fundamental types. These typedefs are defined in the `default` namespace, which never needs to be specified explicitly. In addition, C++/CX provides wrappers and concrete implementations for certain Windows Runtime types and interfaces. ## Boolean and Character Types diff --git a/docs/cppcx/operator-type-hat.md b/docs/cppcx/operator-type-hat.md index 658cfdad71f..238e11d9715 100644 --- a/docs/cppcx/operator-type-hat.md +++ b/docs/cppcx/operator-type-hat.md @@ -1,8 +1,7 @@ --- -description: "Learn more about: operator Type^" title: "operator Type^" -ms.date: "12/30/2016" -ms.assetid: b24ffc83-0780-4f9a-8ee0-f5725db339d1 +description: "Learn more about: operator Type^" +ms.date: 12/30/2016 --- # operator Type^ @@ -42,8 +41,6 @@ Type^ tx2 = (Type^)(tn); .NET Framework programs project `TypeName` as -### Requirements - ## See also [operator Windows::UI::Xaml::Interop::TypeName](../cppcx/operator-windows-ui-xaml-interop-typename.md)
diff --git a/docs/cppcx/operator-windows-ui-xaml-interop-typename.md b/docs/cppcx/operator-windows-ui-xaml-interop-typename.md index 750e6301a96..0e585769a5e 100644 --- a/docs/cppcx/operator-windows-ui-xaml-interop-typename.md +++ b/docs/cppcx/operator-windows-ui-xaml-interop-typename.md @@ -1,8 +1,7 @@ --- -description: "Learn more about: operator Windows::UI::Xaml::Interop::TypeName" title: "operator Windows::UI::Xaml::Interop::TypeName" -ms.date: "12/30/2016" -ms.assetid: a65a105e-7e3a-452f-932f-2cdaf00fbba5 +description: "Learn more about: operator Windows::UI::Xaml::Interop::TypeName" +ms.date: 12/30/2016 --- # operator Windows::UI::Xaml::Interop::TypeName @@ -42,8 +41,6 @@ Type^ tx2 = (Type^)(tn); .NET Framework programs project `TypeName` as [System.Type](/dotnet/api/system.type). -### Requirements - ## See also [operator Windows::UI::Xaml::Interop::TypeName](../cppcx/operator-windows-ui-xaml-interop-typename.md)
diff --git a/docs/cppcx/platform-accessdeniedexception-class.md b/docs/cppcx/platform-accessdeniedexception-class.md index bf6cbaed0b4..cc50d74596c 100644 --- a/docs/cppcx/platform-accessdeniedexception-class.md +++ b/docs/cppcx/platform-accessdeniedexception-class.md @@ -1,11 +1,10 @@ --- -description: "Learn more about: Platform::AccessDeniedException Class" title: "Platform::AccessDeniedException Class" +description: "Learn more about: Platform::AccessDeniedException Class" ms.date: "12/30/2016" ms.topic: "reference" f1_keywords: ["VCCORLIB/Platform::AccessDeniedException", "VCCORLIB/Platform::AccessDeniedException::AccessDeniedException"] helpviewer_keywords: ["Platform::AccessDeniedException"] -ms.assetid: 6ae2155b-7b16-4587-8d2d-da05eab4c7e9 --- # Platform::AccessDeniedException Class @@ -14,7 +13,7 @@ Thrown when access to a resource or feature is denied. ## Syntax ```cpp -public ref class AccessDeniedException : COMException, IException, IPrintable, IEquatable +public ref class AccessDeniedException : COMException, IException, IPrintable, IEquatable ``` ### Remarks diff --git a/docs/cppcx/platform-arrayreference-class.md b/docs/cppcx/platform-arrayreference-class.md index 4441c41afba..7925842befc 100644 --- a/docs/cppcx/platform-arrayreference-class.md +++ b/docs/cppcx/platform-arrayreference-class.md @@ -1,11 +1,10 @@ --- -description: "Learn more about: Platform::ArrayReference Class" title: "Platform::ArrayReference Class" -ms.date: "10/16/2019" +description: "Learn more about: Platform::ArrayReference Class" +ms.date: 10/16/2019 ms.topic: "reference" f1_keywords: ["VCCORLIB/Platform::ArrayReference::ArrayReference"] helpviewer_keywords: ["Platform::ArrayReference Class"] -ms.assetid: 9ab3b15e-8a60-4600-8fcb-7d6c86284f4b --- # Platform::ArrayReference Class @@ -70,8 +69,6 @@ The number of elements in the source array. *otherArg*
An `ArrayReference` object whose data will be moved to initialize the new instance. -### Remarks - ## ArrayReference::operator= Operator Assigns the specified object to the current [Platform::ArrayReference](../cppcx/platform-arrayreference-class.md) object by using move semantics. diff --git a/docs/cppcx/platform-changedstateexception-class.md b/docs/cppcx/platform-changedstateexception-class.md index b123e94431b..6fc12015009 100644 --- a/docs/cppcx/platform-changedstateexception-class.md +++ b/docs/cppcx/platform-changedstateexception-class.md @@ -1,11 +1,10 @@ --- -description: "Learn more about: Platform::ChangedStateException Class" title: "Platform::ChangedStateException Class" +description: "Learn more about: Platform::ChangedStateException Class" ms.date: "12/30/2016" ms.topic: "reference" f1_keywords: ["VCCORLIB/Platform::ChangedStateException", "VCCORLIB/Platform::ChangedStateException::ChangedStateException"] helpviewer_keywords: ["Platform::ChangedStateException"] -ms.assetid: f894beac-9e80-4fac-ac25-89f1dbc0a6a4 --- # Platform::ChangedStateException Class @@ -14,7 +13,7 @@ Thrown when the internal state of an object has changed, thereby invalidating th ## Syntax ```cpp -public ref class ChangedStateException : COMException, IException, IPrintable, IEquatable +public ref class ChangedStateException : COMException, IException, IPrintable, IEquatable ``` ### Remarks diff --git a/docs/cppcx/platform-classnotregisteredexception-class.md b/docs/cppcx/platform-classnotregisteredexception-class.md index 9fa2b993972..0108e2bff66 100644 --- a/docs/cppcx/platform-classnotregisteredexception-class.md +++ b/docs/cppcx/platform-classnotregisteredexception-class.md @@ -1,11 +1,10 @@ --- -description: "Learn more about: Platform::ClassNotRegisteredException Class" title: "Platform::ClassNotRegisteredException Class" +description: "Learn more about: Platform::ClassNotRegisteredException Class" ms.date: "12/30/2016" ms.topic: "reference" f1_keywords: ["VCCORLIB/Platform::ClassNotRegisteredException::ClassNotRegisteredException", "VCCORLIB/Platform::ClassNotRegisteredException"] helpviewer_keywords: ["Platform::ClassNotRegisteredException"] -ms.assetid: 8f8871d8-51b9-46e8-902e-ae023c9f1de9 --- # Platform::ClassNotRegisteredException Class @@ -14,7 +13,7 @@ Thrown when a COM class has not been registered. ## Syntax ```cpp -public ref class ClassNotRegisteredException : COMException, IException, IPrintable, IEquatable +public ref class ClassNotRegisteredException : COMException, IException, IPrintable, IEquatable ``` ### Remarks diff --git a/docs/cppcx/platform-collections-map-class.md b/docs/cppcx/platform-collections-map-class.md index 21b981e5f6e..473101cef06 100644 --- a/docs/cppcx/platform-collections-map-class.md +++ b/docs/cppcx/platform-collections-map-class.md @@ -1,11 +1,10 @@ --- -description: "Learn more about: Platform::Collections::Map Class" title: "Platform::Collections::Map Class" -ms.date: "10/01/2019" +description: "Learn more about: Platform::Collections::Map Class" +ms.date: 10/01/2019 ms.topic: "reference" f1_keywords: ["COLLECTION/Platform::Collections::Map::Map", "COLLECTION/Platform::Collections::Map::Clear", "COLLECTION/Platform::Collections::Map::First", "COLLECTION/Platform::Collections::Map::GetView", "COLLECTION/Platform::Collections::Map::HasKey", "COLLECTION/Platform::Collections::Map::Insert", "COLLECTION/Platform::Collections::Map::Lookup", "COLLECTION/Platform::Collections::Map::Remove", "COLLECTION/Platform::Collections::Map::Size"] helpviewer_keywords: ["Map Class (C++/Cx)"] -ms.assetid: 2b8cf968-1167-4898-a149-1195b32c1785 --- # Platform::Collections::Map Class @@ -206,7 +205,7 @@ Initializes a new instance of the Map class. ```cpp explicit Map(const C& comp = C()); explicit Map(const StdMap& m); -explicit Map(StdMap&& m ; +explicit Map(StdMap&& m); template Map( InItfirst, diff --git a/docs/cppcx/platform-collections-namespace.md b/docs/cppcx/platform-collections-namespace.md index f079c117af1..1cffd685219 100644 --- a/docs/cppcx/platform-collections-namespace.md +++ b/docs/cppcx/platform-collections-namespace.md @@ -9,7 +9,7 @@ ms.assetid: b5042864-5f22-40b7-b7a5-c0691f65cc47 --- # Platform::Collections Namespace -The Platform::Collections namespace contains the `Map`, `MapView`, `Vector`, and `VectorView` classes. These classes are concrete implementations of the corresponding interfaces that are defined in the [Windows::Foundation::Collections](/uwp/api/windows.foundation.collections) namespace. The concrete collection types are not portable across the ABI (for example when a Javascript or C# program calls into a C++ component), but they are implicitly convertible to their corresponding interface types. For example, if you implement a public method that populates and returns a collection, then use [Platform::Collections::Vector](../cppcx/platform-collections-vector-class.md) to implement the collection internally and use [Windows::Foundation::Collections::IVector](/uwp/api/windows.foundation.collections.ivector-1) as the return type. For more information, see [Collections](../cppcx/collections-c-cx.md) and [Creating Windows Runtime Components in C++](/windows/uwp/winrt-components/creating-windows-runtime-components-in-cpp). +The Platform::Collections namespace contains the `Map`, `MapView`, `Vector`, and `VectorView` classes. These classes are concrete implementations of the corresponding interfaces that are defined in the [Windows::Foundation::Collections](/uwp/api/windows.foundation.collections) namespace. The concrete collection types are not portable across the ABI (for example when a JavaScript or C# program calls into a C++ component), but they are implicitly convertible to their corresponding interface types. For example, if you implement a public method that populates and returns a collection, then use [Platform::Collections::Vector](../cppcx/platform-collections-vector-class.md) to implement the collection internally and use [Windows::Foundation::Collections::IVector](/uwp/api/windows.foundation.collections.ivector-1) as the return type. For more information, see [Collections](../cppcx/collections-c-cx.md) and [Creating Windows Runtime Components in C++](/windows/uwp/winrt-components/creating-windows-runtime-components-in-cpp). You can construct a Platform::Collections::Vector from a [std::vector](../standard-library/vector-class.md) and a [Platform::Collections::Map](../cppcx/platform-collections-map-class.md) from a [std::map](../standard-library/map-class.md). diff --git a/docs/cppcx/platform-collections-unorderedmap-class.md b/docs/cppcx/platform-collections-unorderedmap-class.md index a2a55e71329..a65c9b4d548 100644 --- a/docs/cppcx/platform-collections-unorderedmap-class.md +++ b/docs/cppcx/platform-collections-unorderedmap-class.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Platform::Collections::UnorderedMap Class" title: "Platform::Collections::UnorderedMap Class" -ms.date: "12/30/2016" +description: "Learn more about: Platform::Collections::UnorderedMap Class" +ms.date: 12/30/2016 ms.topic: "reference" f1_keywords: ["collection/Platform::Collections::UnorderedMap"] -ms.assetid: dc84f261-b13c-4c0a-9b57-30dcb9e3065e --- # Platform::Collections::UnorderedMap Class @@ -30,7 +29,7 @@ The type of the key in the key-value pair. The type of the value in the key-value pair. *C*
-A type that provides a function object that can compare two element values as sort keys to determine their relative order in the Map. By default, [std::equal_to\](../standard-library/equal-to-struct.md). +A type that provides a function object that can compare two element values as sort keys to determine their relative order in the Map. By default, [std::equal_to\](../standard-library/equal-to-struct.md). ### Remarks diff --git a/docs/cppcx/platform-collections-vector-class.md b/docs/cppcx/platform-collections-vector-class.md index 56d9181e80a..4bb382e37ef 100644 --- a/docs/cppcx/platform-collections-vector-class.md +++ b/docs/cppcx/platform-collections-vector-class.md @@ -1,11 +1,10 @@ --- -description: "Learn more about: Platform::Collections::Vector Class" title: "Platform::Collections::Vector Class" -ms.date: "12/04/2019" +description: "Learn more about: Platform::Collections::Vector Class" +ms.date: 12/04/2019 ms.topic: "reference" f1_keywords: ["COLLECTION/Platform::Collections::Vector::Vector", "COLLECTION/Platform::Collections::Vector::Append", "COLLECTION/Platform::Collections::Vector::Clear", "COLLECTION/Platform::Collections::Vector::First", "COLLECTION/Platform::Collections::Vector::GetAt", "COLLECTION/Platform::Collections::Vector::GetMany", "COLLECTION/Platform::Collections::Vector::GetView", "COLLECTION/Platform::Collections::Vector::IndexOf", "COLLECTION/Platform::Collections::Vector::InsertAt", "COLLECTION/Platform::Collections::Vector::ReplaceAll", "COLLECTION/Platform::Collections::Vector::RemoveAt", "COLLECTION/Platform::Collections::Vector::RemoveAtEnd", "COLLECTION/Platform::Collections::Vector::SetAt", "COLLECTION/Platform::Collections::Vector::Size", "COLLECTION/Platform::Collections::Vector::VectorChanged"] helpviewer_keywords: ["Vector Class (C++/Cx)"] -ms.assetid: aee8c076-9700-47c3-99b6-799fd3edb0ca --- # Platform::Collections::Vector Class @@ -176,7 +175,7 @@ The number of items retrieved. ### Remarks -This function is not intended for use directly by client code. It is used internally in the [to_vector Function](../cppcx/to-vector-function.md) to enable efficient conversion of Platform::Vector intances to std::vector instances. +This function is not intended for use directly by client code. It is used internally in the [to_vector Function](../cppcx/to-vector-function.md) to enable efficient conversion of Platform::Vector instances to std::vector instances. ## Vector::GetView Method diff --git a/docs/cppcx/platform-comexception-class.md b/docs/cppcx/platform-comexception-class.md index 5c8363381cc..42aaeb78ad9 100644 --- a/docs/cppcx/platform-comexception-class.md +++ b/docs/cppcx/platform-comexception-class.md @@ -1,11 +1,10 @@ --- -description: "Learn more about: Platform::COMException Class" title: "Platform::COMException Class" -ms.date: "12/30/2016" +description: "Learn more about: Platform::COMException Class" +ms.date: 12/30/2016 ms.topic: "reference" f1_keywords: ["VCCORLIB/Platform::COMException", "VCCORLIB/Platform::COMException::HResult", "VCCORLIB/Platform::COMException::Message"] helpviewer_keywords: ["Platform::COMException Class"] -ms.assetid: 44fda4e5-574f-4d12-ab5f-4ff3f277448d --- # Platform::COMException Class @@ -14,7 +13,7 @@ Represents COM errors that occur during application execution. COMException is t ## Syntax ```cpp -public ref class COMException : Exception, IException, IPrintable, IEquatable +public ref class COMException : Exception, IException, IPrintable, IEquatable ``` ### Members @@ -74,17 +73,17 @@ The following predefined exceptions are derived from COMException. They differ f ## COMException::COMException Constructor -Intializes a new instance of the COMException class. +Initializes a new instance of the COMException class. ### Syntax ```cpp -COMException( int hresult ) +COMException(int hresult); ``` ### Parameters -*hresult*
+*hresult*\ The error HRESULT that is represented by the exception. ## COMException::HResult Property @@ -95,7 +94,7 @@ The HRESULT that corresponds to the exception. ```cpp public: - property int HResult { int get();} + property int HResult { int get(); } ``` ## Property Value @@ -113,7 +112,8 @@ Message that describes the exception. ### Syntax ```cpp -public:property String^ Message { String^ get();} +public: + property String^ Message { String^ get(); } ``` ### Property Value diff --git a/docs/cppcx/platform-details-heapallocationtrackinglevel-enumeration.md b/docs/cppcx/platform-details-heapallocationtrackinglevel-enumeration.md index 095d32d6233..8e3e645bf9f 100644 --- a/docs/cppcx/platform-details-heapallocationtrackinglevel-enumeration.md +++ b/docs/cppcx/platform-details-heapallocationtrackinglevel-enumeration.md @@ -1,11 +1,10 @@ --- -description: "Learn more about: Platform::Details::HeapAllocationTrackingLevel Enumeration" title: "Platform::Details::HeapAllocationTrackingLevel Enumeration" -ms.date: "12/30/2016" +description: "Learn more about: Platform::Details::HeapAllocationTrackingLevel Enumeration" +ms.date: 12/30/2016 ms.topic: "reference" f1_keywords: ["VCCORLIB/Platform::Details::HeapAllocationTrackingLevel"] helpviewer_keywords: ["Platform::Details::HeapAllocationTrackingLevel Enumeration"] -ms.assetid: dc341bc0-b47b-4eb2-9445-fbaf788e7b1a --- # Platform::Details::HeapAllocationTrackingLevel Enumeration @@ -14,7 +13,7 @@ This enumeration is intended for internal use only, and is not intended to be us ## Syntax ```cpp -enumm class HeapAllocationTrackingLevel; +enum class HeapAllocationTrackingLevel; ``` ### Remarks diff --git a/docs/cppcx/platform-disconnectedexception-class.md b/docs/cppcx/platform-disconnectedexception-class.md index 332d47be884..5721f44c9aa 100644 --- a/docs/cppcx/platform-disconnectedexception-class.md +++ b/docs/cppcx/platform-disconnectedexception-class.md @@ -1,20 +1,19 @@ --- -description: "Learn more about: Platform::DisconnectedException Class" title: "Platform::DisconnectedException Class" +description: "Learn more about: Platform::DisconnectedException Class" ms.date: "12/30/2016" ms.topic: "reference" f1_keywords: ["VCCORLIB/Platform::DisconnectedException", "VCCORLIB/Platform::DisconnectedException::DisconnectedException"] helpviewer_keywords: ["Platform::DisconnectedException"] -ms.assetid: c25e0d64-5bff-4c21-88e5-c4ec2776fa7f --- # Platform::DisconnectedException Class -Thrown when a COM proxy object attempts to reference a COM server that no longer exists +Thrown when a COM proxy object attempts to reference a COM server that no longer exists. ## Syntax -``` -public ref class DisconnectedException : COMException, IException, IPrintable, IEquatable +```cpp +public ref class DisconnectedException : COMException, IException, IPrintable, IEquatable ``` ### Remarks diff --git a/docs/cppcx/platform-exception-class.md b/docs/cppcx/platform-exception-class.md index ea48d339c26..32f89702c67 100644 --- a/docs/cppcx/platform-exception-class.md +++ b/docs/cppcx/platform-exception-class.md @@ -1,7 +1,7 @@ --- title: "Platform::Exception Class" description: "Learn more about: Platform::Exception Class" -ms.date: "12/30/2016" +ms.date: 12/30/2016 ms.topic: "reference" f1_keywords: ["VCCORLIB/Platform::Exception::Exception", "VCCORLIB/Platform::Exception::CreateException", "VCCORLIB/Platform::Exception::HResult", "VCCORLIB/Platform::Exception::Message"] helpviewer_keywords: ["Platform::Exception Class"] @@ -13,7 +13,7 @@ Represents errors that occur during application execution. Custom exception clas ## Syntax ```cpp -public ref class Exception : Object, IException, IPrintable, IEquatable +public ref class Exception : Object, IException, IPrintable, IEquatable ``` ### Members @@ -68,10 +68,10 @@ Exception^ CreateException(int32 hr, Platform::String^ message); ### Parameters -*hr*
+*hr*\ An HRESULT value that you typically get from a call to a COM method. If the value is 0, which is equal to S_OK, this method throws [Platform::InvalidArgumentException](../cppcx/platform-invalidargumentexception-class.md) because COM methods that succeed should not throw exceptions. -*message*
+*message*\ A string that describes the error. ### Return Value @@ -86,7 +86,7 @@ It is strongly recommended to use CreateException to create a strongly-typed exc ## Exception::Exception Constructor -Intializes a new instance of the Exception class. +Initializes a new instance of the Exception class. ### Syntax @@ -97,10 +97,10 @@ Exception(int32 hresult, ::Platform::String^ message); ### Parameters -*hresult*
+*hresult*\ The error HRESULT that is represented by the exception. -*message*
+*message*\ A user-specified message, such as prescriptive text, that is associated with the exception. In general you should prefer the second overload in order to provide a descriptive message that is as specific as possible about how and why the error has occurred. ## Exception::HResult Property @@ -129,7 +129,8 @@ Message that describes the error. ### Syntax ```cpp -public:property String^ Message; +public: + property String^ Message; ``` ### Property Value diff --git a/docs/cppcx/platform-failureexception-class.md b/docs/cppcx/platform-failureexception-class.md index 02f7ca1cfb6..24268a74b33 100644 --- a/docs/cppcx/platform-failureexception-class.md +++ b/docs/cppcx/platform-failureexception-class.md @@ -1,11 +1,10 @@ --- -description: "Learn more about: Platform::FailureException Class" title: "Platform::FailureException Class" +description: "Learn more about: Platform::FailureException Class" ms.date: "12/30/2016" ms.topic: "reference" f1_keywords: ["VCCORLIB/Platform::FailureException::FailureException", "VCCORLIB/Platform::FailureException"] helpviewer_keywords: ["Platform::FailureException"] -ms.assetid: 1729cd07-bfc2-448e-9db5-185d5cbf5b81 --- # Platform::FailureException Class @@ -14,7 +13,7 @@ Thrown when the operation has failed. It is the equivalent of the E_FAIL HRESULT ## Syntax ```cpp -public ref class FailureException : COMException, IException, IPrintable, IEquatable +public ref class FailureException : COMException, IException, IPrintable, IEquatable ``` ### Remarks diff --git a/docs/cppcx/platform-guid-value-class.md b/docs/cppcx/platform-guid-value-class.md index 952645712cc..825700de854 100644 --- a/docs/cppcx/platform-guid-value-class.md +++ b/docs/cppcx/platform-guid-value-class.md @@ -1,15 +1,14 @@ --- -description: "Learn more about: Platform::Guid value class" title: "Platform::Guid value class" +description: "Learn more about: Platform::Guid value class" ms.date: "01/15/2019" ms.topic: "reference" f1_keywords: ["VCCORLIB/Platform::Guid"] helpviewer_keywords: ["Platform::Guid Struct"] -ms.assetid: 25c0bfb2-7f93-44d8-bdf4-ef4fbac3424a --- # Platform::Guid value class -Represents a [GUID](/windows/win32/api/guiddef/ns-guiddef-guid type in the Windows Runtime type system. +Represents a [GUID](/windows/win32/api/guiddef/ns-guiddef-guid) type in the Windows Runtime type system. ## Syntax @@ -74,43 +73,43 @@ Guid( ### Parameters -*a*
+*a*\ The first 4 bytes of the `GUID`. -*b*
+*b*\ The next 2 bytes of the `GUID`. -*c*
+*c*\ The next 2 bytes of the `GUID`. -*d*
+*d*\ The next byte of the `GUID`. -*e*
+*e*\ The next byte of the `GUID`. -*f*
+*f*\ The next byte of the `GUID`. -*g*
+*g*\ The next byte of the `GUID`. -*h*
+*h*\ The next byte of the `GUID`. -*i*
+*i*\ The next byte of the `GUID`. -*j*
+*j*\ The next byte of the `GUID`. -*k*
+*k*\ The next byte of the `GUID`. -*m*
+*m*\ A `GUID` in the form a [GUID structure](/windows/win32/api/guiddef/ns-guiddef-guid). -*n*
+*n*\ The remaining 8 bytes of the `GUID`. ## Guid::operator== Operator @@ -125,10 +124,10 @@ static bool Platform::Guid::operator==(Platform::Guid guid1, Platform::Guid guid ### Parameters -*guid1*
+*guid1*\ The first `Platform::Guid` to compare. -*guid2*
+*guid2*\ The second `Platform::Guid` to compare. ### Return Value @@ -152,10 +151,10 @@ static bool Platform::Guid::operator!=(Platform::Guid guid1, Platform::Guid guid ### Parameters -*guid1*
+*guid1*\ The first `Platform::Guid` to compare. -*guid2*
+*guid2*\ The second `Platform::Guid` to compare. ### Return Value @@ -174,10 +173,10 @@ static bool Platform::Guid::operator<(Platform::Guid guid1, Platform::Guid guid2 ### Parameters -*guid1*
+*guid1*\ The first `Platform::Guid` to compare. -*guid2*
+*guid2*\ The second `Platform::Guid` to compare. ### Return Value diff --git a/docs/cppcx/platform-ibox-interface.md b/docs/cppcx/platform-ibox-interface.md index bf606fcf34c..fdc629b0e21 100644 --- a/docs/cppcx/platform-ibox-interface.md +++ b/docs/cppcx/platform-ibox-interface.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Platform::IBox Interface" title: "Platform::IBox Interface" -ms.date: "12/30/2016" +description: "Learn more about: Platform::IBox Interface" +ms.date: 12/30/2016 ms.topic: "reference" f1_keywords: ["VCCORLIB/Namespace not found::Platform", "VCCORLIB/Namespace not found::Platform::Value"] -ms.assetid: 774df45d-f8a7-45a3-ae24-eecc3c681040 --- # Platform::IBox Interface @@ -26,8 +25,6 @@ The type of the boxed value. The `IBox` interface is primarily used internally to represent nullable value types, as described in [Value classes and structs (C++/CX)](../cppcx/value-classes-and-structs-c-cx.md). The interface is also used to box value types that are passed to C++ methods that take parameters of type `Object^`. You can explicitly declare an input parameter as `IBox`. For an example, see [Boxing](../cppcx/boxing-c-cx.md). -### Requirements - ### Members The `Platform::IBox` interface inherits from the [Platform::IValueType](../cppcx/platform-ivaluetype-interface.md) interface. `IBox` has these members: diff --git a/docs/cppcx/platform-intptr-value-class.md b/docs/cppcx/platform-intptr-value-class.md index b08b50209b5..8abd76f842b 100644 --- a/docs/cppcx/platform-intptr-value-class.md +++ b/docs/cppcx/platform-intptr-value-class.md @@ -1,7 +1,7 @@ --- title: "Platform::IntPtr value class" description: "Learn more about: Platform::IntPtr value class" -ms.date: "12/30/2016" +ms.date: 12/30/2016 ms.topic: "reference" f1_keywords: ["VCCORLIB/PlatformIntPtr::IntPtr", "VCCORLIB/PlatformIntPtr::op_explicit Operator", "VCCORLIB/PlatformIntPtr::ToInt32"] helpviewer_keywords: ["Platform::IntPtr Struct"] @@ -43,7 +43,9 @@ Initializes a new instance of an IntPtr with the specified value. ### Syntax ```cpp -IntPtr( __int64 handle-or-pointer ); IntPtr( void* value ); IntPtr( int 32-bit_value ); +IntPtr( __int64 handle-or-pointer ); +IntPtr( void* value ); +IntPtr( int 32-bit_value ); ``` ### Parameters @@ -58,7 +60,9 @@ Converts the specified parameter to an IntPtr or a pointer to an IntPtr value. ### Syntax ```cpp -static IntPtr::operator IntPtr( void* value1); static IntPtr::operator IntPtr( int value2); static IntPtr::operator void*( IntPtr value3 ); +static IntPtr::operator IntPtr( void* value1); +static IntPtr::operator IntPtr( int value2); +static IntPtr::operator void*( IntPtr value3 ); ``` ### Parameters diff --git a/docs/cppcx/platform-invalidargumentexception-class.md b/docs/cppcx/platform-invalidargumentexception-class.md index 120bdd9d5c6..040d608c66d 100644 --- a/docs/cppcx/platform-invalidargumentexception-class.md +++ b/docs/cppcx/platform-invalidargumentexception-class.md @@ -1,11 +1,10 @@ --- -description: "Learn more about: Platform::InvalidArgumentException Class" title: "Platform::InvalidArgumentException Class" +description: "Learn more about: Platform::InvalidArgumentException Class" ms.date: "12/30/2016" ms.topic: "reference" f1_keywords: ["VCCORLIB/Platform::InvalidArgumentException", "VCCORLIB/Platform::InvalidArgumentException::InvalidArgumentException"] helpviewer_keywords: ["Platform::InvalidArgumentException"] -ms.assetid: 1a8d860b-3bcb-41a9-9346-6610616a0b46 --- # Platform::InvalidArgumentException Class @@ -14,7 +13,7 @@ Thrown when one of the arguments provided to a method is not valid. ## Syntax ```cpp -public ref class InvalidArgumentException : COMException, IException, IPrintable, IEquatable +public ref class InvalidArgumentException : COMException, IException, IPrintable, IEquatable ``` ### Remarks diff --git a/docs/cppcx/platform-invalidcastexception-class.md b/docs/cppcx/platform-invalidcastexception-class.md index 4f9b3c4ba71..9e664b598be 100644 --- a/docs/cppcx/platform-invalidcastexception-class.md +++ b/docs/cppcx/platform-invalidcastexception-class.md @@ -1,11 +1,10 @@ --- -description: "Learn more about: Platform::InvalidCastException Class" title: "Platform::InvalidCastException Class" +description: "Learn more about: Platform::InvalidCastException Class" ms.date: "12/30/2016" ms.topic: "reference" f1_keywords: ["VCCORLIB/Platform::InvalidCastException::InvalidCastException", "VCCORLIB/Platform::InvalidCastException"] helpviewer_keywords: ["Platform::InvalidCastException"] -ms.assetid: 0215131d-1251-4913-9561-824410e045b6 --- # Platform::InvalidCastException Class @@ -14,7 +13,7 @@ Thrown when a cast or explicit conversion is invalid. ## Syntax ```cpp -public ref class InvalidCastException : COMException, IException, IPrintable, IEquatable +public ref class InvalidCastException : COMException, IException, IPrintable, IEquatable ``` ### Remarks diff --git a/docs/cppcx/platform-metadata-flagsattribute-attribute.md b/docs/cppcx/platform-metadata-flagsattribute-attribute.md index b3f435aa5ad..ec334277811 100644 --- a/docs/cppcx/platform-metadata-flagsattribute-attribute.md +++ b/docs/cppcx/platform-metadata-flagsattribute-attribute.md @@ -1,11 +1,10 @@ --- -description: "Learn more about: Platform::Metadata::FlagsAttribute Attribute" title: "Platform::Metadata::FlagsAttribute Attribute" -ms.date: "12/30/2016" +description: "Learn more about: Platform::Metadata::FlagsAttribute Attribute" +ms.date: 12/30/2016 ms.topic: "reference" f1_keywords: ["VCCORLIB/Platform::Metadata::FlagsAttribute"] helpviewer_keywords: ["Platform::Metadata::FlagsAttribute Attribute"] -ms.assetid: 56f4a191-cc81-4742-aff8-bd2219c0735c --- # Platform::Metadata::FlagsAttribute Attribute @@ -23,8 +22,6 @@ public ref class Flags abstract : Attribute [Platform::Metadata::Attribute](../cppcx/platform-metadata-attribute-attribute.md) -### Remarks - ### Requirements **Minimum supported client:** Windows 8 diff --git a/docs/cppcx/platform-metadata-runtimeclassname.md b/docs/cppcx/platform-metadata-runtimeclassname.md index d40541dd80c..e7e5d3a0568 100644 --- a/docs/cppcx/platform-metadata-runtimeclassname.md +++ b/docs/cppcx/platform-metadata-runtimeclassname.md @@ -1,15 +1,14 @@ --- -description: "Learn more about: Platform::Metadata::RuntimeClassName" title: "Platform::Metadata::RuntimeClassName" +description: "Learn more about: Platform::Metadata::RuntimeClassName" ms.date: "12/30/2016" ms.topic: "reference" f1_keywords: ["VCCORLIB/Platform::Metadata::RuntimeClassName"] helpviewer_keywords: ["RuntimeClassName", "Platform::Metadata::RuntimeClassName"] -ms.assetid: fdef8f85-ab94-4edd-ba50-ee0da9358ff6 --- # Platform::Metadata::RuntimeClassName -When applied to a class definition, ensures that a private class returns a valid name from the GetRuntimeClassName function.. +When applied to a class definition, ensures that a private class returns a valid name from the GetRuntimeClassName function. ## Syntax diff --git a/docs/cppcx/platform-notimplementedexception-class.md b/docs/cppcx/platform-notimplementedexception-class.md index 55e18d0b577..94f1c289d83 100644 --- a/docs/cppcx/platform-notimplementedexception-class.md +++ b/docs/cppcx/platform-notimplementedexception-class.md @@ -1,11 +1,10 @@ --- -description: "Learn more about: Platform::NotImplementedException Class" title: "Platform::NotImplementedException Class" +description: "Learn more about: Platform::NotImplementedException Class" ms.date: "12/30/2016" ms.topic: "reference" f1_keywords: ["VCCORLIB/Platform::NotImplementedException", "VCCORLIB/Platform::NotImplementedException::NotImplementedException"] helpviewer_keywords: ["Platform::NotImplementedException"] -ms.assetid: 6da26cc2-dde8-4aea-aa85-67aac55cf97b --- # Platform::NotImplementedException Class @@ -14,7 +13,7 @@ Thrown when an interface member is not been implemented in a derived type. ## Syntax ```cpp -public ref class NotImplementedException : COMException, IException, IPrintable, IEquatable +public ref class NotImplementedException : COMException, IException, IPrintable, IEquatable ``` ### Remarks diff --git a/docs/cppcx/platform-nullreferenceexception-class.md b/docs/cppcx/platform-nullreferenceexception-class.md index c5924402c21..4fd31538544 100644 --- a/docs/cppcx/platform-nullreferenceexception-class.md +++ b/docs/cppcx/platform-nullreferenceexception-class.md @@ -1,11 +1,10 @@ --- -description: "Learn more about: Platform::NullReferenceException Class" title: "Platform::NullReferenceException Class" +description: "Learn more about: Platform::NullReferenceException Class" ms.date: "12/30/2016" ms.topic: "reference" f1_keywords: ["VCCORLIB/Platform::NullReferenceException", "VCCORLIB/Platform::NullReferenceException::NullReferenceException"] helpviewer_keywords: ["Platform::NullReferenceException"] -ms.assetid: be202577-d898-4716-83cd-e3556fe8a241 --- # Platform::NullReferenceException Class @@ -14,7 +13,7 @@ Thrown when there is an attempt to dereference a null object reference. ## Syntax ```cpp -public ref class NullReferenceException : COMException, IException, IPrintable, IEquatable +public ref class NullReferenceException : COMException, IException, IPrintable, IEquatable ``` ### Remarks diff --git a/docs/cppcx/platform-object-class.md b/docs/cppcx/platform-object-class.md index 3964399163d..a080235c9d0 100644 --- a/docs/cppcx/platform-object-class.md +++ b/docs/cppcx/platform-object-class.md @@ -1,7 +1,7 @@ --- title: "Platform::Object Class" description: "Learn more about: Platform::Object Class" -ms.date: "12/30/2016" +ms.date: 12/30/2016 ms.topic: "reference" f1_keywords: ["VCCORLIB/Platform::Object::Object", "VCCORLIB/Platform::Object::Equals", "VCCORLIB/Platform::Object::GetHashCode", "VCCORLIB/Platform::Object::ReferenceEquals", "VCCORLIB/Platform::ToString", "VCCORLIB/Platform::GetType"] helpviewer_keywords: ["Object class"] @@ -166,7 +166,7 @@ public: virtual Platform::String^ ToString() override { return "I'm a Tree"; - }; + } }; ``` diff --git a/docs/cppcx/platform-objectdisposedexception-class.md b/docs/cppcx/platform-objectdisposedexception-class.md index 36f7004267f..0d9a9055519 100644 --- a/docs/cppcx/platform-objectdisposedexception-class.md +++ b/docs/cppcx/platform-objectdisposedexception-class.md @@ -1,11 +1,10 @@ --- -description: "Learn more about: Platform::ObjectDisposedException Class" title: "Platform::ObjectDisposedException Class" +description: "Learn more about: Platform::ObjectDisposedException Class" ms.date: "12/30/2016" ms.topic: "reference" f1_keywords: ["VCCORLIB/Platform::ObjectDisposedException", "VCCORLIB/Platform::ObjectDisposedException::ObjectDisposedException"] helpviewer_keywords: ["Platform::ObjectDisposedException"] -ms.assetid: 68506fe4-d09c-4407-999f-1e3edb261d41 --- # Platform::ObjectDisposedException Class @@ -14,7 +13,7 @@ Thrown when an operation is performed on a disposed object. ## Syntax ```cpp -public ref class ObjectDisposedException : COMException, IException, IPrintable, IEquatable +public ref class ObjectDisposedException : COMException, IException, IPrintable, IEquatable ``` ### Remarks diff --git a/docs/cppcx/platform-operationcanceledexception-class.md b/docs/cppcx/platform-operationcanceledexception-class.md index 0ada6f44964..99ce0bc5589 100644 --- a/docs/cppcx/platform-operationcanceledexception-class.md +++ b/docs/cppcx/platform-operationcanceledexception-class.md @@ -1,11 +1,10 @@ --- -description: "Learn more about: Platform::OperationCanceledException Class" title: "Platform::OperationCanceledException Class" +description: "Learn more about: Platform::OperationCanceledException Class" ms.date: "12/30/2016" ms.topic: "reference" f1_keywords: ["VCCORLIB/Platform::OperationCanceledException::OperationCanceledException", "VCCORLIB/Platform::OperationCanceledException"] helpviewer_keywords: ["Platform::OperationCanceledException"] -ms.assetid: 5351bc20-5408-423a-8169-f09acc8a3fbb --- # Platform::OperationCanceledException Class @@ -14,7 +13,7 @@ Thrown when an operation is aborted. ## Syntax ```cpp -public ref class OperationCanceledException : COMException, IException, IPrintable, IEquatable +public ref class OperationCanceledException : COMException, IException, IPrintable, IEquatable ``` ### Remarks diff --git a/docs/cppcx/platform-outofboundsexception-class.md b/docs/cppcx/platform-outofboundsexception-class.md index d8a878c8913..2bca3dbbac7 100644 --- a/docs/cppcx/platform-outofboundsexception-class.md +++ b/docs/cppcx/platform-outofboundsexception-class.md @@ -1,11 +1,10 @@ --- -description: "Learn more about: Platform::OutOfBoundsException Class" title: "Platform::OutOfBoundsException Class" +description: "Learn more about: Platform::OutOfBoundsException Class" ms.date: "12/30/2016" ms.topic: "reference" f1_keywords: ["VCCORLIB/Platform::OutOfBoundsException", "VCCORLIB/Platform::OutOfBoundsException::OutOfBoundsException"] helpviewer_keywords: ["Platform::OutOfBoundsException"] -ms.assetid: 96f8bf75-1207-4049-964b-7771822cadf3 --- # Platform::OutOfBoundsException Class @@ -14,7 +13,7 @@ Thrown when an operation attempts to access data outside the valid range. ## Syntax ```cpp -public ref class OutOfBoundsException : COMException, IException, IPrintable, IEquatable +public ref class OutOfBoundsException : COMException, IException, IPrintable, IEquatable ``` ### Remarks diff --git a/docs/cppcx/platform-outofmemoryexception-class.md b/docs/cppcx/platform-outofmemoryexception-class.md index bf36a9f7911..486396cf6ac 100644 --- a/docs/cppcx/platform-outofmemoryexception-class.md +++ b/docs/cppcx/platform-outofmemoryexception-class.md @@ -1,11 +1,10 @@ --- -description: "Learn more about: Platform::OutOfMemoryException Class" title: "Platform::OutOfMemoryException Class" +description: "Learn more about: Platform::OutOfMemoryException Class" ms.date: "12/30/2016" ms.topic: "reference" f1_keywords: ["VCCORLIB/Platform::OutOfMemoryException", "VCCORLIB/Platform::OutOfMemoryException::OutOfMemoryException"] helpviewer_keywords: ["Platform::OutOfMemoryException"] -ms.assetid: 49c19f6b-f66c-4448-b861-91dcbf32de2c --- # Platform::OutOfMemoryException Class @@ -14,7 +13,7 @@ Thrown when there's insufficient memory to complete the operation. ## Syntax ```cpp -public ref class OutOfMemoryException : COMException, IException, IPrintable, IEquatable +public ref class OutOfMemoryException : COMException, IException, IPrintable, IEquatable ``` ### Remarks diff --git a/docs/cppcx/platform-sizet-value-class.md b/docs/cppcx/platform-sizet-value-class.md index fe4da84ea6a..3bfbf58eb18 100644 --- a/docs/cppcx/platform-sizet-value-class.md +++ b/docs/cppcx/platform-sizet-value-class.md @@ -1,11 +1,10 @@ --- -description: "Learn more about: Platform::SizeT value class" title: "Platform::SizeT value class" -ms.date: "12/30/2016" +description: "Learn more about: Platform::SizeT value class" +ms.date: 12/30/2016 ms.topic: "reference" f1_keywords: ["VCCORLIB/PlatformSizeT::SizeT constructor"] helpviewer_keywords: ["Platform::SizeT Struct"] -ms.assetid: 0803612c-8ba1-430c-9b7b-1bebae88608d --- # Platform::SizeT value class @@ -40,7 +39,8 @@ Initializes a new instance of SizeT with the specified value. ### Syntax ```cpp -SizeT( uint32 value1 ); SizeT( void* value2 ); +SizeT( uint32 value1 ); +SizeT( void* value2 ); ``` ### Parameters diff --git a/docs/cppcx/platform-stringreference-class.md b/docs/cppcx/platform-stringreference-class.md index 6b6a0663076..ca8ef3bcf09 100644 --- a/docs/cppcx/platform-stringreference-class.md +++ b/docs/cppcx/platform-stringreference-class.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Platform::StringReference Class" title: "Platform::StringReference Class" -ms.date: "12/30/2016" +description: "Learn more about: Platform::StringReference Class" +ms.date: 12/30/2016 ms.topic: "reference" f1_keywords: ["VCCORLIB/Platform::StringReference::StringReference", "VCCORLIB/Platform::StringReference::Data", "VCCORLIB/Platform::StringReference::Length", "VCCORLIB/Platform::StringReference::GetHSTRING", "VCCORLIB/Platform::StringReference::GetString"] -ms.assetid: 2d09c7ec-0f16-458e-83ed-7225a1b9221e --- # Platform::StringReference Class @@ -16,8 +15,6 @@ An optimization type that you can use to pass string data from `Platform::String class StringReference ``` -### Remarks - ### Members ### Public Constructors @@ -80,8 +77,6 @@ __abi_HSTRING GetHSTRING() const; An `__abi_HSTRING` that contains the string data. -### Remarks - ## StringReference::GetString Method Returns the contents of the string as a `Platform::String^`. @@ -111,8 +106,6 @@ unsigned int Length() const; An unsigned integer that specifies the number of characters in the string. -### Remarks - ## StringReference::operator= Operator Assigns the specified object to the current `StringReference` object. @@ -140,7 +133,7 @@ A reference to an object of type `StringReference`. Because `StringReference` is a standard C++ class and not a ref class, it does not appear in the **Object Browser**. -## StringReference::operator() Operator +## StringReference::operator() Operator Converts a `StringReference` object to a `Platform::String^` object. diff --git a/docs/cppcx/platform-wrongthreadexception-class.md b/docs/cppcx/platform-wrongthreadexception-class.md index 79320770d50..33c50399148 100644 --- a/docs/cppcx/platform-wrongthreadexception-class.md +++ b/docs/cppcx/platform-wrongthreadexception-class.md @@ -1,11 +1,10 @@ --- -description: "Learn more about: Platform::WrongThreadException Class" title: "Platform::WrongThreadException Class" +description: "Learn more about: Platform::WrongThreadException Class" ms.date: "12/30/2016" ms.topic: "reference" f1_keywords: ["VCCORLIB/Platform::WrongThreadException", "VCCORLIB/Platform::WrongThreadException::WrongThreadException"] helpviewer_keywords: ["Platform::WrongThreadException"] -ms.assetid: c193f97e-0392-4535-a4c4-0711e4e4a836 --- # Platform::WrongThreadException Class @@ -14,7 +13,7 @@ Thrown when a thread calls by way of an interface pointer for a proxy object tha ## Syntax ```cpp -public ref class WrongThreadException : COMException, IException, IPrintable, IEquatable +public ref class WrongThreadException : COMException, IException, IPrintable, IEquatable ``` ### Remarks diff --git a/docs/cppcx/value-classes-and-structs-c-cx.md b/docs/cppcx/value-classes-and-structs-c-cx.md index 4c4cd2cdc80..55d96917543 100644 --- a/docs/cppcx/value-classes-and-structs-c-cx.md +++ b/docs/cppcx/value-classes-and-structs-c-cx.md @@ -1,9 +1,8 @@ --- -description: "Learn more about: Value classes and structs (C++/CX)" title: "Value classes and structs (C++/CX)" +description: "Learn more about: Value classes and structs (C++/CX)" ms.date: "12/30/2016" helpviewer_keywords: ["value struct", "value class"] -ms.assetid: 262a0992-9721-4c02-8297-efc07d90e5a4 --- # Value classes and structs (C++/CX) @@ -48,7 +47,7 @@ A value struct or value class can contain as fields only fundamental numeric typ A value class or value struct that contains a `Platform::String^` or `IBox^` type as a member is not `memcpy`-able. -Because all members of a **`value class`** or **`value struct`** are public and are emitted into metadata, standard C++ types are not allowed as members. This is different from ref classes, which may contain **`private`** or **`internal`** standard C++ types.. +Because all members of a **`value class`** or **`value struct`** are public and are emitted into metadata, standard C++ types are not allowed as members. This is different from ref classes, which may contain **`private`** or **`internal`** standard C++ types. The following code fragment declares the `Coordinates` and `City` types as value structs. Notice that one of the `City` data members is a `GeoCoordinates` type. A **`value struct`** can contain other value structs as members. @@ -140,7 +139,7 @@ public: ## See also -[Type System (C++/CX)](../cppcx/type-system-c-cx.md)
-[C++/CX Language Reference](../cppcx/visual-c-language-reference-c-cx.md)
-[Namespaces Reference](../cppcx/namespaces-reference-c-cx.md)
+[Type System (C++/CX)](../cppcx/type-system-c-cx.md)\ +[C++/CX Language Reference](../cppcx/visual-c-language-reference-c-cx.md)\ +[Namespaces Reference](../cppcx/namespaces-reference-c-cx.md)\ [Ref classes and structs (C++/CX)](../cppcx/ref-classes-and-structs-c-cx.md) diff --git a/docs/cppcx/wrl/callback-function-wrl.md b/docs/cppcx/wrl/callback-function-wrl.md index 777ea551af4..dd804d4df02 100644 --- a/docs/cppcx/wrl/callback-function-wrl.md +++ b/docs/cppcx/wrl/callback-function-wrl.md @@ -20,166 +20,14 @@ template< ComPtr Callback( TCallback callback ); -template< - typename TDelegateInterface, - typename TCallbackObject -> -ComPtr Callback( - _In_ TCallbackObject *object, - _In_ HRESULT (TCallbackObject::* method)() -); -template< - typename TDelegateInterface, - typename TCallbackObject, - typename TArg1 -> -ComPtr Callback( - _In_ TCallbackObject *object, - _In_ HRESULT (TCallbackObject::* method)(TArg1) -); -template< - typename TDelegateInterface, - typename TCallbackObject, - typename TArg1, - typename TArg2 -> -ComPtr Callback( - _In_ TCallbackObject *object, - _In_ HRESULT (TCallbackObject::* method)(TArg1, - TArg2) -); -template< - typename TDelegateInterface, - typename TCallbackObject, - typename TArg1, - typename TArg2, - typename TArg3 -> -ComPtr Callback( - _In_ TCallbackObject *object, - _In_ HRESULT (TCallbackObject::* method)(TArg1, - TArg2, - TArg3) -); -template< - typename TDelegateInterface, - typename TCallbackObject, - typename TArg1, - typename TArg2, - typename TArg3, - typename TArg4 -> -ComPtr Callback( - _In_ TCallbackObject *object, - _In_ HRESULT (TCallbackObject::* method)(TArg1, - TArg2, - TArg3, - TArg4) -); -template< - typename TDelegateInterface, - typename TCallbackObject, - typename TArg1, - typename TArg2, - typename TArg3, - typename TArg4, - typename TArg5 -> -ComPtr Callback( - _In_ TCallbackObject *object, - _In_ HRESULT (TCallbackObject::* method)(TArg1, - TArg2, - TArg3, - TArg4, - TArg5) -); -template< - typename TDelegateInterface, - typename TCallbackObject, - typename TArg1, - typename TArg2, - typename TArg3, - typename TArg4, - typename TArg5, - typename TArg6 -> -ComPtr Callback( - _In_ TCallbackObject *object, - _In_ HRESULT (TCallbackObject::* method)(TArg1, - TArg2, - TArg3, - TArg4, - TArg5, - TArg6) -); template< typename TDelegateInterface, typename TCallbackObject, - typename TArg1, - typename TArg2, - typename TArg3, - typename TArg4, - typename TArg5, - typename TArg6, - typename TArg7 + typename... TArgs > ComPtr Callback( _In_ TCallbackObject *object, - _In_ HRESULT (TCallbackObject::* method)(TArg1, - TArg2, - TArg3, - TArg4, - TArg5, - TArg6, - TArg7) -); -template< - typename TDelegateInterface, - typename TCallbackObject, - typename TArg1, - typename TArg2, - typename TArg3, - typename TArg4, - typename TArg5, - typename TArg6, - typename TArg7, - typename TArg8 -> -ComPtr Callback( - _In_ TCallbackObject *object, - _In_ HRESULT (TCallbackObject::* method)(TArg1, - TArg2, - TArg3, - TArg4, - TArg5, - TArg6, - TArg7, - TArg8) -); -template< - typename TDelegateInterface, - typename TCallbackObject, - typename TArg1, - typename TArg2, - typename TArg3, - typename TArg4, - typename TArg5, - typename TArg6, - typename TArg7, - typename TArg8, - typename TArg9 -> -ComPtr Callback( - _In_ TCallbackObject *object, - _In_ HRESULT (TCallbackObject::* method)(TArg1, - TArg2, - TArg3, - TArg4, - TArg5, - TArg6, - TArg7, - TArg8, - TArg9) + _In_ HRESULT (TCallbackObject::* method)(TArgs...) ); ``` @@ -194,32 +42,8 @@ A template parameter that specifies the type of an object that represents an obj *TCallbackObject*
A template parameter that specifies the object whose member function is the method to call when an event occurs. -*TArg1*
-A template parameter that specifies the type of the first callback method argument. - -*TArg2*
-A template parameter that specifies the type of the second callback method argument. - -*TArg3*
-A template parameter that specifies the type of the third callback method argument. - -*TArg4*
-A template parameter that specifies the type of the fourth callback method argument. - -*TArg5*
-A template parameter that specifies the type of the fifth callback method argument. - -*TArg6*
-A template parameter that specifies the type of the sixth callback method argument. - -*TArg7*
-A template parameter that specifies the type of the seventh callback method argument. - -*TArg8*
-A template parameter that specifies the type of the eighth callback method argument. - -*TArg9*
-A template parameter that specifies the type of the ninth callback method argument. +*TArgs*
+A template parameter pack that specifies the types of the callback method arguments. *callback*
An object that represents the callback object and its member function. diff --git a/docs/cppcx/wrl/hstring-class.md b/docs/cppcx/wrl/hstring-class.md index c29a4a6cff1..1d9df0ceedf 100644 --- a/docs/cppcx/wrl/hstring-class.md +++ b/docs/cppcx/wrl/hstring-class.md @@ -1,11 +1,10 @@ --- -description: "Learn more about: HString Class" title: "HString Class" -ms.date: "07/15/2019" +description: "Learn more about: HString Class" +ms.date: 07/15/2019 ms.topic: "reference" f1_keywords: ["corewrappers/Microsoft::WRL::Wrappers::HString", "corewrappers/Microsoft::WRL::Wrappers::HString::Attach", "corewrappers/Microsoft::WRL::Wrappers::HString::CopyTo", "corewrappers/Microsoft::WRL::Wrappers::HString::Detach", "corewrappers/Microsoft::WRL::Wrappers::HString::Get", "corewrappers/Microsoft::WRL::Wrappers::HString::GetRawBuffer","corewrappers/Microsoft::WRL::Wrappers::HString::GetAddressOf", "corewrappers/Microsoft::WRL::Wrappers::HString::HString", "corewrappers/Microsoft::WRL::Wrappers::HString::IsValid", "corewrappers/Microsoft::WRL::Wrappers::HString::MakeReference", "corewrappers/Microsoft::WRL::Wrappers::HString::operator=", "corewrappers/Microsoft::WRL::Wrappers::HString::operator==", "corewrappers/Microsoft::WRL::Wrappers::HString::operator!=", "corewrappers/Microsoft::WRL::Wrappers::HString::operator<", "corewrappers/Microsoft::WRL::Wrappers::HString::Release", "corewrappers/Microsoft::WRL::Wrappers::HString::Set", "corewrappers/Microsoft::WRL::Wrappers::HString::~HString"] helpviewer_keywords: ["Microsoft::WRL::Wrappers::HString class", "Microsoft::WRL::Wrappers::HString::Attach method", "Microsoft::WRL::Wrappers::HString::CopyTo method", "Microsoft::WRL::Wrappers::HString::Detach method", "Microsoft::WRL::Wrappers::HString::Get method", "Microsoft::WRL::Wrappers::HString::GetAddressOf method", "Microsoft::WRL::Wrappers::HString::HString, constructor", "Microsoft::WRL::Wrappers::HString::IsValid method", "Microsoft::WRL::Wrappers::HString::MakeReference method", "Microsoft::WRL::Wrappers::HString::operator= operator", "Microsoft::WRL::Wrappers::HString::operator== operator", "Microsoft::WRL::Wrappers::HString::operator!= operator", "Microsoft::WRL::Wrappers::HString::operator< operator", "Microsoft::WRL::Wrappers::HString::Release method", "Microsoft::WRL::Wrappers::HString::Set method", "Microsoft::WRL::Wrappers::HString::~HString, destructor"] -ms.assetid: 6709dd2e-8d72-4675-8ec7-1baa7d71854d --- # HString Class @@ -340,7 +339,7 @@ The second parameter to compare. *rhs* can be a reference to an `HString`. ## HString::Release -Deletes the underlying string value and intializes the current `HString` object to an empty value. +Deletes the underlying string value and initializes the current `HString` object to an empty value. ```cpp void Release() throw() diff --git a/docs/cppcx/wrl/module-class.md b/docs/cppcx/wrl/module-class.md index e228f5e864c..3cefc4e6d76 100644 --- a/docs/cppcx/wrl/module-class.md +++ b/docs/cppcx/wrl/module-class.md @@ -1,11 +1,10 @@ --- -description: "Learn more about: Module Class" title: "Module Class" -ms.date: "10/18/2018" +description: "Learn more about: Module Class" +ms.date: 10/18/2018 ms.topic: "reference" f1_keywords: ["module/Microsoft::WRL::Module", "module/Microsoft::WRL::Module::Create", "module/Microsoft::WRL::Module::DecrementObjectCount", "module/Microsoft::WRL::Module::GetActivationFactory", "module/Microsoft::WRL::Module::GetClassObject", "module/Microsoft::WRL::Module::GetModule", "module/Microsoft::WRL::Module::GetObjectCount", "module/Microsoft::WRL::Module::IncrementObjectCount", "module/Microsoft::WRL::Module::Module", "module/Microsoft::WRL::Module::objectCount_Data", "module/Microsoft::WRL::Module::RegisterCOMObject", "module/Microsoft::WRL::Module::RegisterObjects", "module/Microsoft::WRL::Module::RegisterWinRTObject", "module/Microsoft::WRL::Module::releaseNotifier_", "module/Microsoft::WRL::Module::Terminate", "module/Microsoft::WRL::Module::~Module", "module/Microsoft::WRL::Module::UnregisterCOMObject", "module/Microsoft::WRL::Module::UnregisterObjects", "module/Microsoft::WRL::Module::UnregisterWinRTObject"] helpviewer_keywords: ["Microsoft::WRL::Module class", "Microsoft::WRL::Module::Create method", "Microsoft::WRL::Module::DecrementObjectCount method", "Microsoft::WRL::Module::GetActivationFactory method", "Microsoft::WRL::Module::GetClassObject method", "Microsoft::WRL::Module::GetModule method", "Microsoft::WRL::Module::GetObjectCount method", "Microsoft::WRL::Module::IncrementObjectCount method", "Microsoft::WRL::Module::Module, constructor", "Microsoft::WRL::Module::objectCount_ data member", "Microsoft::WRL::Module::RegisterCOMObject method", "Microsoft::WRL::Module::RegisterObjects method", "Microsoft::WRL::Module::RegisterWinRTObject method", "Microsoft::WRL::Module::releaseNotifier_ data member", "Microsoft::WRL::Module::Terminate method", "Microsoft::WRL::Module::~Module, destructor", "Microsoft::WRL::Module::UnregisterCOMObject method", "Microsoft::WRL::Module::UnregisterObjects method", "Microsoft::WRL::Module::UnregisterWinRTObject method"] -ms.assetid: dd67e3b8-c2e1-4f53-8c0f-565a140ba649 --- # Module Class @@ -396,7 +395,7 @@ Unregisters one or more COM objects, which prevents other applications from conn virtual HRESULT UnregisterCOMObject( const wchar_t* serverName, DWORD* cookies, - unsigned int count + unsigned int count); ``` ### Parameters diff --git a/docs/cppcx/wrl/walkthrough-creating-a-windows-store-app-using-wrl-and-media-foundation.md b/docs/cppcx/wrl/walkthrough-creating-a-windows-store-app-using-wrl-and-media-foundation.md index a4f29be1420..5ec81ffc805 100644 --- a/docs/cppcx/wrl/walkthrough-creating-a-windows-store-app-using-wrl-and-media-foundation.md +++ b/docs/cppcx/wrl/walkthrough-creating-a-windows-store-app-using-wrl-and-media-foundation.md @@ -1,6 +1,6 @@ --- -description: "Learn more about: Creating a UWP app using WRL and Media Foundation" title: "Walkthrough: Creating a UWP app using WRL and Media Foundation" +description: "Learn more about: Creating a UWP app using WRL and Media Foundation" ms.date: 04/15/2021 ms.topic: "reference" --- @@ -37,7 +37,7 @@ You can usually use C++/CX to create Windows Runtime components. However, someti - The `namespace` and `runtimeclass` attributes, and the `NTDDI_WIN8` [version](/windows/win32/Midl/version) attribute value are important parts of the MIDL definition for a Media Foundation component that uses WRL. -- [`Microsoft::WRL::RuntimeClass`](runtimeclass-class.md) is the base class for the custom Media Foundation component. The [`Microsoft::WRL::RuntimeClassType::WinRtClassicComMix]`(runtimeclasstype-enumeration.md) enum value, which is provided as a template argument, marks the class for use both as a Windows Runtime class and as a classic COM runtime class. +- [`Microsoft::WRL::RuntimeClass`](runtimeclass-class.md) is the base class for the custom Media Foundation component. The [`Microsoft::WRL::RuntimeClassType::WinRtClassicComMix`](runtimeclasstype-enumeration.md) enum value, which is provided as a template argument, marks the class for use both as a Windows Runtime class and as a classic COM runtime class. - The [`InspectableClass`](inspectableclass-macro.md) macro implements basic COM functionality such as reference counting and the `QueryInterface` method, and sets the runtime class name and trust level. diff --git a/docs/cppcx/wrl/weakref-class.md b/docs/cppcx/wrl/weakref-class.md index 227bdd1cf25..66191b5c263 100644 --- a/docs/cppcx/wrl/weakref-class.md +++ b/docs/cppcx/wrl/weakref-class.md @@ -1,6 +1,6 @@ --- -description: "Learn more about: WeakRef Class" title: "WeakRef Class" +description: "Learn more about: WeakRef Class" ms.date: 11/22/2021 ms.topic: "reference" f1_keywords: ["client/Microsoft::WRL::WeakRef", "client/Microsoft::WRL::WeakRef::~WeakRef", "client/Microsoft::WRL::WeakRef::As", "client/Microsoft::WRL::WeakRef::AsIID", "client/Microsoft::WRL::WeakRef::CopyTo", "client/Microsoft::WRL::WeakRef::operator&", "client/Microsoft::WRL::WeakRef::WeakRef"] @@ -193,7 +193,7 @@ When this operation completes, an object that represents parameter *`riid`*. - `S_OK` if this operation succeeds, but the current `WeakRef` object has already been released. Parameter *`ptr`* is set to **`nullptr`**. -- `S_OK` if this operation succeeds, but the current `WeakRef` object isn't derived from parameter *`riid`*. Parameter *`ptr`* is set to **`nullptr`**. (For more information, see Remarks.) +- `S_OK` if this operation succeeds, but the current `WeakRef` object isn't derived from parameter *`riid`*. Parameter *`ptr`* is set to **`nullptr`**. For more information, see Remarks. ### Remarks diff --git a/docs/cross-platform/build-an-opengl-es-application-on-android-and-ios.md b/docs/cross-platform/build-an-opengl-es-application-on-android-and-ios.md index 43deedc3b74..8f2c0764404 100644 --- a/docs/cross-platform/build-an-opengl-es-application-on-android-and-ios.md +++ b/docs/cross-platform/build-an-opengl-es-application-on-android-and-ios.md @@ -2,17 +2,20 @@ description: "Learn more about: Build an OpenGL ES application on Android and iOS" title: "Build an OpenGL ES application on Android and iOS" ms.date: "06/09/2023" +ms.topic: how-to +ms.custom: sfi-image-nochange --- # Build an OpenGL ES application on Android and iOS +> [!IMPORTANT] +> Starting with Visual Studio 2026 (version 18.0), the Mobile development with C++ workload for iOS and Android, as well as the Embedded and IoT tools (RTOS Viewer, Serial Monitor, Peripheral Viewer, and ST Project Import), are no longer supported and will be removed in a future update. The Android NDKs included in the Mobile development with C++ workload remain supported. +> OpenGL support is no longer available. It was last available in Visual Studio 17.3. + You can create Visual Studio solutions and projects for iOS apps and Android apps that share common code. This article guides you through a combined solution template. It creates both an iOS app, and an Android Native Activity app. The apps have C++ code in common that uses OpenGL ES to display the same animated rotating cube on each platform. OpenGL ES (OpenGL for Embedded Systems or GLES) is a 2D and 3D graphics API. It's supported on many mobile devices. ## Requirements -> [!IMPORTANT] -> OpenGL support is no longer available. It was last available in Visual Studio 17.3. - Here are the system requirements to create an OpenGL ES app for iOS and Android. If you haven't already, install the Mobile Development with C++ workload in the Visual Studio Installer. To get the OpenGL ES templates, and to build for iOS, include the optional C++ iOS development tools. To build for Android, install the C++ Android development tools and the required third-party tools: Android NDK, Apache Ant, and Google Android Emulator. For better emulator performance on Intel platforms, one option is to install the Intel Hardware Accelerated Execution Manager (HAXM). For detailed instructions, see [Install cross-platform mobile development with C++](../cross-platform/install-visual-cpp-for-cross-platform-mobile-development.md). @@ -21,7 +24,7 @@ To build and test the iOS app, you'll need a Mac computer. Set it up according t ## Create a new OpenGLES Application project -In this tutorial, you first create a new OpenGL ES Application project. and then build and run the default app in an Android emulator. Next you build the app for iOS and run the app on an iOS device. +In this tutorial, you first create a new OpenGL ES Application project and then build and run it in an Android emulator. Next you build the app for iOS and run the app on an iOS device. ::: moniker range="msvc-150" @@ -53,7 +56,7 @@ In this tutorial, you first create a new OpenGL ES Application project. and then ::: moniker-end -The new OpenGL ES Application solution includes three library projects and two application projects. The Libraries folder includes a shared code project. And, two platform-specific projects that reference the shared code: +The new OpenGL ES Application solution includes three library projects and two application projects. The Libraries folder includes a shared code project, and two platform-specific projects that reference the shared code: - `MyOpenGLESApp.Android.NativeActivity` contains the references and glue code that implements your app as a Native Activity on Android. The entry points from the glue code are implemented in *main.cpp*, which includes the common shared code in `MyOpenGLESApp.Shared`. Precompiled headers are in *pch.h*. This Native Activity app project is compiled into a shared library (*.so*) file, which is picked up by the `MyOpenGLESApp.Android.Packaging` project. diff --git a/docs/cross-platform/create-an-android-native-activity-app.md b/docs/cross-platform/create-an-android-native-activity-app.md index c8a88f33efc..095a2a7735a 100644 --- a/docs/cross-platform/create-an-android-native-activity-app.md +++ b/docs/cross-platform/create-an-android-native-activity-app.md @@ -2,10 +2,13 @@ description: "Learn more about: Create an Android Native Activity App" title: "Create an Android Native Activity App" ms.date: "10/17/2019" -ms.assetid: 884014b1-5208-45ec-b0da-ad0070d2c24d +ms.topic: how-to --- # Create an Android Native Activity App +> [!IMPORTANT] +> Starting with Visual Studio 2026 (version 18.0), the Mobile development with C++ workload for iOS and Android, as well as the Embedded and IoT tools (RTOS Viewer, Serial Monitor, Peripheral Viewer, and ST Project Import), are no longer supported and will be removed in a future update. The Android NDKs included in the Mobile development with C++ workload remain supported. + When you install the cross-platform **Mobile development with C++** workload, Visual Studio can be used to create fully functional Android Native Activity apps. The Android Native Development Kit (NDK) is a toolset that allows you to implement the majority of your Android app using pure C/C++ code. Some Java JNI code acts as glue to allow your C/C++ code to interact with Android. The Android NDK introduced the ability to create Native Activity apps with Android API Level 9. Native Activity code is popular for creating gaming and graphic intensive apps that use Unreal Engine or OpenGL. This topic will guide you through creation of a simple Native Activity app that uses OpenGL. Additional topics walk through the developer lifecycle of editing, building, debugging and deploying Native Activity code. ## Requirements diff --git a/docs/cross-platform/cross-platform-mobile-development-examples.md b/docs/cross-platform/cross-platform-mobile-development-examples.md index 7eb5ea368ab..4a53fea00e5 100644 --- a/docs/cross-platform/cross-platform-mobile-development-examples.md +++ b/docs/cross-platform/cross-platform-mobile-development-examples.md @@ -5,6 +5,9 @@ ms.date: 03/04/2024 --- # Cross-platform mobile development examples +> [!IMPORTANT] +> Starting with Visual Studio 2026 (version 18.0), the Mobile development with C++ workload for iOS and Android, as well as the Embedded and IoT tools (RTOS Viewer, Serial Monitor, Peripheral Viewer, and ST Project Import), are no longer supported and will be removed in a future update. The Android NDKs included in the Mobile development with C++ workload remain supported. + Several of the templates installed by the **Mobile development with C++** workload generate complete examples that you can use to learn from. Additionally, here are some example applications that you can download and try out in Visual Studio. - [hello-jni Android Application Sample](https://github.com/android/ndk-samples/tree/master/hello-jni) diff --git a/docs/cross-platform/general-android-prop-page.md b/docs/cross-platform/general-android-prop-page.md index 3bbadb70d3a..df6f9dd5a42 100644 --- a/docs/cross-platform/general-android-prop-page.md +++ b/docs/cross-platform/general-android-prop-page.md @@ -2,7 +2,6 @@ description: "Learn more about: General Project Properties (Android C++)" title: "General Project Properties (Android C++)" ms.date: "10/23/2017" -ms.assetid: 65f4868b-b864-4989-a275-1e51869ef599 f1_keywords: - VC.Project.VCConfiguration.Android.OutputDirectory - VC.Project.VCConfiguration.Android.IntermediateDirectory @@ -17,6 +16,9 @@ f1_keywords: --- # General Project Properties (Android C++) +> [!IMPORTANT] +> Starting with Visual Studio 2026 (version 18.0), the Mobile development with C++ workload for iOS and Android, as well as the Embedded and IoT tools (RTOS Viewer, Serial Monitor, Peripheral Viewer, and ST Project Import), are no longer supported and will be removed in a future update. The Android NDKs included in the Mobile development with C++ workload remain supported. + | Property | Description | Choices | |--|--|--| | Output Directory | Specifies a relative path to the output file directory; can include environment variables. | diff --git a/docs/cross-platform/import-an-xcode-project.md b/docs/cross-platform/import-an-xcode-project.md index a536a9fc47d..1ea0c5c2e8b 100644 --- a/docs/cross-platform/import-an-xcode-project.md +++ b/docs/cross-platform/import-an-xcode-project.md @@ -2,10 +2,13 @@ description: "Learn more about: Import an Xcode project" title: "Import an Xcode project" ms.date: "10/17/2019" -ms.assetid: aa4b8161-d98f-4a1a-9db3-520133bfc82f +ms.topic: how-to --- # Import an Xcode project +> [!IMPORTANT] +> Starting with Visual Studio 2026 (version 18.0), the Mobile development with C++ workload for iOS and Android, as well as the Embedded and IoT tools (RTOS Viewer, Serial Monitor, Peripheral Viewer, and ST Project Import), are no longer supported and will be removed in a future update. The Android NDKs included in the Mobile development with C++ workload remain supported. + The Visual Studio tools for cross-platform mobile development with C++ include support for moving your Xcode projects into Visual Studio, where you can create cross-platform libraries and share code with other projects. The Import from Xcode wizard simplifies the process of importing projects and splitting out the C++ code in your Xcode targets for use as a static library or shared code project. You can manage your iOS-specific code in Visual Studio and still use Xcode to do storyboards and builds. For information on how to easily move code back and forth between Visual Studio and Xcode, see [Sync changes between Xcode and Visual Studio](sync-changes-between-xcode-and-visual-studio.md). ## Use the Import From Xcode wizard diff --git a/docs/cross-platform/index.yml b/docs/cross-platform/index.yml index 0fb5f94c593..789c7f8b022 100644 --- a/docs/cross-platform/index.yml +++ b/docs/cross-platform/index.yml @@ -17,7 +17,7 @@ landingContent: # Cards and links should be based on top customer tasks or top subjects # Start card title with a verb # Card (optional) - - title: Learn how to build cross-platform mobile apps + - title: Learn how to build cross-platform mobile apps linkLists: - linkListType: get-started links: diff --git a/docs/cross-platform/install-and-configure-tools-to-build-using-ios.md b/docs/cross-platform/install-and-configure-tools-to-build-using-ios.md index 84bc01c5895..b0adf51b595 100644 --- a/docs/cross-platform/install-and-configure-tools-to-build-using-ios.md +++ b/docs/cross-platform/install-and-configure-tools-to-build-using-ios.md @@ -2,11 +2,16 @@ description: "Learn more about: Install and configure tools to build using iOS" title: "Install and configure tools to build using iOS" ms.date: 12/18/2022 -ms.assetid: d0c311c9-9eb9-42c5-ba07-25604362cd28 -ms.custom: intro-installation +ms.topic: install-set-up-deploy +ms.custom: + - intro-installation + - sfi-image-nochange --- # Install and configure tools to build using iOS +> [!IMPORTANT] +> Starting with Visual Studio 2026 (version 18.0), the Mobile development with C++ workload for iOS and Android, as well as the Embedded and IoT tools (RTOS Viewer, Serial Monitor, Peripheral Viewer, and ST Project Import), are no longer supported and will be removed in a future update. The Android NDKs included in the Mobile development with C++ workload remain supported. + You can use Visual Studio with the cross-platform **Mobile development with C++** tools to edit, debug, and deploy iOS code to the iOS Simulator or to an iOS device. But, because of licensing restrictions, the code must be built and run remotely on a Mac. To build and run iOS apps using Visual Studio, you need to set up and configure the remote agent, [vcremote](https://www.npmjs.com/package/vcremote), on your Mac. The vcremote remote agent handles build requests from Visual Studio and runs the app on an iOS device connected to the Mac, or in the iOS Simulator on the Mac. > [!NOTE] diff --git a/docs/cross-platform/install-visual-cpp-for-cross-platform-mobile-development.md b/docs/cross-platform/install-visual-cpp-for-cross-platform-mobile-development.md index 200c128cb34..abd451551b8 100644 --- a/docs/cross-platform/install-visual-cpp-for-cross-platform-mobile-development.md +++ b/docs/cross-platform/install-visual-cpp-for-cross-platform-mobile-development.md @@ -3,9 +3,13 @@ description: "Learn more about: Install cross-platform mobile development with C title: "Install cross-platform mobile development with C++" ms.date: "10/17/2019" ms.custom: intro-installation +ms.topic: install-set-up-deploy --- # Install cross-platform mobile development with C++ +> [!IMPORTANT] +> Starting with Visual Studio 2026 (version 18.0), the Mobile development with C++ workload for iOS and Android, as well as the Embedded and IoT tools (RTOS Viewer, Serial Monitor, Peripheral Viewer, and ST Project Import), are no longer supported and will be removed in a future update. The Android NDKs included in the Mobile development with C++ workload remain supported. + You can use C++ in Visual Studio to build Windows Desktop apps, Universal Windows Platform (UWP) apps, and Linux apps. And now, you can build C++ apps for Android and iOS. The **Mobile development with C++** workload is an installable set of components in Visual Studio. It includes cross-platform iOS, Android, and UWP Visual Studio templates. The workload installs the cross-platform tools and SDKs you need to get started quickly. You don't have to locate, download, and configure them yourself. You can use these tools in Visual Studio to easily create, edit, debug, and test your cross-platform projects. This article describes how to install the tools and third-party software required to develop cross-platform apps in C++ using Visual Studio. For an overview, see [Visual C++ cross-platform mobile](https://visualstudio.microsoft.com/vs/features/cplusplus-mdd/) diff --git a/docs/cross-platform/sync-changes-between-xcode-and-visual-studio.md b/docs/cross-platform/sync-changes-between-xcode-and-visual-studio.md index 834a4af4463..415ec583ea6 100644 --- a/docs/cross-platform/sync-changes-between-xcode-and-visual-studio.md +++ b/docs/cross-platform/sync-changes-between-xcode-and-visual-studio.md @@ -2,10 +2,12 @@ description: "Learn more about: Sync changes between Xcode and Visual Studio" title: "Sync changes between Xcode and Visual Studio" ms.date: "10/17/2019" -ms.assetid: c71a4d7c-120e-4559-a114-3a99c4b860a9 --- # Sync changes between Xcode and Visual Studio +> [!IMPORTANT] +> Starting with Visual Studio 2026 (version 18.0), the Mobile development with C++ workload for iOS and Android, as well as the Embedded and IoT tools (RTOS Viewer, Serial Monitor, Peripheral Viewer, and ST Project Import), are no longer supported and will be removed in a future update. The Android NDKs included in the Mobile development with C++ workload remain supported. + The mobile development with C++ components in Visual Studio include remote capabilities for syncing your work between your PC and your Mac. When your Visual Studio and Mac machines are paired, new options are available for iOS Application projects in Visual Studio that you can use to open your project in Xcode, move your code between Xcode and Visual Studio, and clean the temporary Xcode project directory. To use the Remote Machine options, your project must be an iOS Application project, and Visual Studio must be paired with your Mac. For prerequisites and instructions on how to pair a Mac, see [Install and configure tools to build using iOS](../cross-platform/install-and-configure-tools-to-build-using-ios.md). diff --git a/docs/cross-platform/toc.yml b/docs/cross-platform/toc.yml index 4446b6541ff..22771c639f1 100644 --- a/docs/cross-platform/toc.yml +++ b/docs/cross-platform/toc.yml @@ -2,7 +2,7 @@ items: - name: Cross-platform mobile development with C++ href: ../cross-platform/index.yml - name: Overview - href: ../cross-platform/visual-cpp-for-cross-platform-mobile-development.md + href: ../cross-platform/visual-cpp-for-cross-platform-mobile-development.md - name: Get Started expanded: true items: diff --git a/docs/cross-platform/visual-cpp-for-cross-platform-mobile-development.md b/docs/cross-platform/visual-cpp-for-cross-platform-mobile-development.md index 561a0d7c2d8..997d8893371 100644 --- a/docs/cross-platform/visual-cpp-for-cross-platform-mobile-development.md +++ b/docs/cross-platform/visual-cpp-for-cross-platform-mobile-development.md @@ -1,11 +1,13 @@ --- description: "Learn more about: Cross-platform mobile development with C++" title: "Cross-platform mobile development with C++" -ms.date: "11/14/2019" -ms.assetid: 0bb872d6-981b-4c96-9143-fcec5336bf0d +ms.date: 11/07/2025 --- # Cross-platform mobile development with C++ +> [!IMPORTANT] +> Starting with Visual Studio 2026 (version 18.0), the Mobile development with C++ workload for iOS and Android, as well as the Embedded and IoT tools (RTOS Viewer, Serial Monitor, Peripheral Viewer, and ST Project Import), are no longer supported and will be removed in a future update. The Android NDKs included in the Mobile development with C++ workload remain supported. + You can build native C++ apps for iOS, Android, and Windows devices by using the cross-platform tools available in Visual Studio. **Mobile development with C++** is a workload available in the Visual Studio installer. It installs the SDKs and tools you need for cross-platform development of shared libraries and native apps. When it's installed, you can use C++ to create code that runs on iOS and Android devices and platforms, Windows, Windows Store, and Xbox. Writing code for multiple platforms is often frustrating. The primary development languages and tools for iOS, Android, and Windows are different on each platform. However, all platforms support writing code in C++. It's the common denominator that can enable reuse of core code across platforms. Native code written in C++ can be both more performant and resistant to reverse engineering. Code reuse can save both time and effort when creating apps for multiple platforms. diff --git a/docs/data/catalog-information-mfc-data-access.md b/docs/data/catalog-information-mfc-data-access.md index 6935e8ae313..39e786d3e45 100644 --- a/docs/data/catalog-information-mfc-data-access.md +++ b/docs/data/catalog-information-mfc-data-access.md @@ -1,11 +1,10 @@ --- -description: "Learn more about: Catalog Information (MFC Data Access)" -title: "Catalog Information (MFC Data Access)" -ms.date: "11/04/2016" +title: "Catalog Information (MFC Data Access)" +description: "Learn more about: Catalog Information (MFC Data Access)" +ms.date: 11/04/2016 helpviewer_keywords: ["tables [C++], catalog information", "tables [C++]", "ODBC [C++], catalog information", "catalog information database [C++]", "databases [C++], catalog information database"] -ms.assetid: c184e80f-ff17-409f-9df8-05275080bb8d --- -# Catalog Information (MFC Data Access) +# Catalog Information (MFC Data Access) Information about the tables in a data source can include the names of tables and the columns in them, table privileges, names of primary and foreign keys, information about predefined queries or stored procedures, information about indexes on tables, and statistics about tables. diff --git a/docs/data/changes-you-might-make-to-the-default-code-mfc-data-access.md b/docs/data/changes-you-might-make-to-the-default-code-mfc-data-access.md index d524c7ae40c..36779b2c17c 100644 --- a/docs/data/changes-you-might-make-to-the-default-code-mfc-data-access.md +++ b/docs/data/changes-you-might-make-to-the-default-code-mfc-data-access.md @@ -1,10 +1,10 @@ --- -title: "Changes You Might Make to the Default Code (MFC Data Access)" -description: "Learn more about: Changes You Might Make to the Default Code (MFC Data Access)" -ms.date: "11/04/2016" +title: "Changes You Might Make to the Default Code (MFC Data Access)" +description: "Learn more about: Changes You Might Make to the Default Code (MFC Data Access)" +ms.date: 11/04/2016 helpviewer_keywords: ["record views [C++], customizing default code"] --- -# Changes You Might Make to the Default Code (MFC Data Access) +# Changes You Might Make to the Default Code (MFC Data Access) The [MFC Application Wizard](../mfc/reference/database-support-mfc-application-wizard.md) writes a recordset class for you that selects all records in a single table. You will often want to modify that behavior in one or more of the following ways: diff --git a/docs/data/command-handlers-for-record-scrolling-mfc-data-access.md b/docs/data/command-handlers-for-record-scrolling-mfc-data-access.md index 62d9a45c139..5974a0a0173 100644 --- a/docs/data/command-handlers-for-record-scrolling-mfc-data-access.md +++ b/docs/data/command-handlers-for-record-scrolling-mfc-data-access.md @@ -1,11 +1,10 @@ --- -description: "Learn more about: Command Handlers for Record Scrolling (MFC Data Access)" -title: "Command Handlers for Record Scrolling (MFC Data Access)" -ms.date: "11/04/2016" +title: "Command Handlers for Record Scrolling (MFC Data Access)" +description: "Learn more about: Command Handlers for Record Scrolling (MFC Data Access)" +ms.date: 11/04/2016 helpviewer_keywords: ["record views [C++], scrolling", "record scrolling [C++]", "scrolling records"] -ms.assetid: f8b13477-2a37-459e-a30c-806fb78165ac --- -# Command Handlers for Record Scrolling (MFC Data Access) +# Command Handlers for Record Scrolling (MFC Data Access) The [CRecordView](../mfc/reference/crecordview-class.md) class provides default command handling for the following standard commands: diff --git a/docs/data/data-access-in-cpp.md b/docs/data/data-access-in-cpp.md index 9ac4a727550..f9f8add32c0 100644 --- a/docs/data/data-access-in-cpp.md +++ b/docs/data/data-access-in-cpp.md @@ -20,18 +20,18 @@ Describes legacy data access programming with Visual C++, where the preferred wa The Microsoft Foundation Classes (MFC) library supplies classes for programming with Open Database Connectivity (ODBC). [OLE DB Programming](oledb/ole-db-programming.md)
-A mostly legacy interface which is still required in some scenarios, specifically when you are programming against linked servers. +A mostly legacy interface which is still required in some scenarios, specifically when you're programming against linked servers. ## Related Topics [Connect to SQL Database using C and C++](/azure/sql-database/sql-database-develop-cplusplus-simple)
Connect to Azure SQL Database from C or C++ applications. -[Microsoft Azure Storage Client Library for C++](https://github.com/Azure/azure-storage-cpp)
-[Azure Storage](/azure/storage/common/storage-introduction) is a cloud storage solution for modern applications that rely on durability, availability, and scalability to meet the needs of their customers. Connect to Azure Storage from C++ by using the Azure Storage Client Library for C++. +[Azure SDK for C++](/azure/developer/cpp/sdk/overview)
+[Azure Storage](/azure/storage/common/storage-introduction) is a cloud storage solution for modern applications that rely on durability, availability, and scalability to meet the needs of their customers. Connect to Azure Storage from C++ by using the Azure SDK for C++. [ODBC Driver for SQL Server](/sql/connect/odbc/microsoft-odbc-driver-for-sql-server)
-The latest ODBC driver provides robust data access to Microsoft SQL Server and Microsoft Azure SQL Database for C/C++ based applications. Provides support for features including always encrypted, Azure Active Directory, and AlwaysOn Availability Groups. Also available for MacOS and Linux. +The latest ODBC driver provides robust data access to Microsoft SQL Server and Microsoft Azure SQL Database for C/C++ based applications. Provides support for features including always encrypted, Azure Active Directory, and AlwaysOn Availability Groups. Also available for macOS and Linux. [OLE DB Driver for SQL Server](/sql/connect/oledb/oledb-driver-for-sql-server)
The latest OLE DB driver is a stand-alone data access application programming interface (API) that supports Microsoft SQL Server and Microsoft Azure SQL Database. diff --git a/docs/data/data-exchange-for-record-views-mfc-data-access.md b/docs/data/data-exchange-for-record-views-mfc-data-access.md index 08307d190cf..cf7e9e780d0 100644 --- a/docs/data/data-exchange-for-record-views-mfc-data-access.md +++ b/docs/data/data-exchange-for-record-views-mfc-data-access.md @@ -1,11 +1,10 @@ --- -description: "Learn more about: Data Exchange for Record Views (MFC Data Access)" -title: "Data Exchange for Record Views (MFC Data Access)" -ms.date: "11/19/2018" +title: "Data Exchange for Record Views (MFC Data Access)" +description: "Learn more about: Data Exchange for Record Views (MFC Data Access)" +ms.date: 11/19/2018 helpviewer_keywords: ["RFX (record field exchange), data exchange mechanism", "RFX (record field exchange), record views", "record views, data exchange", "DDX (dialog data exchange), record views", "RFX (record field exchange)"] -ms.assetid: abc52ca7-6997-47a7-98f3-f347f52b1f72 --- -# Data Exchange for Record Views (MFC Data Access) +# Data Exchange for Record Views (MFC Data Access) When you use [Add Class](../mfc/reference/adding-an-mfc-odbc-consumer.md) to map the controls in a record view's dialog template resource to the fields of a recordset, the framework manages data exchange in both directions — from recordset to controls and from controls to recordset. Using the DDX mechanism means that you do not have to write the code to transfer data back and forth yourself. diff --git a/docs/data/designing-and-creating-a-record-view-mfc-data-access.md b/docs/data/designing-and-creating-a-record-view-mfc-data-access.md index aa747752af9..82d8ec88812 100644 --- a/docs/data/designing-and-creating-a-record-view-mfc-data-access.md +++ b/docs/data/designing-and-creating-a-record-view-mfc-data-access.md @@ -1,11 +1,11 @@ --- -description: "Learn more about: Designing and Creating a Record View (MFC Data Access)" -title: "Designing and Creating a Record View (MFC Data Access)" -ms.date: "11/04/2016" +title: "Designing and Creating a Record View (MFC Data Access)" +description: "Learn more about: Designing and Creating a Record View (MFC Data Access)" +ms.date: 11/04/2016 helpviewer_keywords: ["designing forms", "record views, creating", "forms [C++], designing", "record views, designing", "application wizards [C++], creating record view classes", "designing record views"] -ms.assetid: 1d6f5439-754f-4b8b-a19d-841a4657827b +ms.topic: how-to --- -# Designing and Creating a Record View (MFC Data Access) +# Designing and Creating a Record View (MFC Data Access) You can create your record view class with the [MFC Application Wizard](../mfc/reference/database-support-mfc-application-wizard.md). If you use an application wizard, it creates the record view class and a dialog template resource for it (without controls). You must use the Visual C++ Dialog editor to add controls to the dialog template resource. On the other hand, if you use **Add Class**, you must first create the dialog template resource in the Dialog editor and then create the record view class. diff --git a/docs/data/features-of-record-view-classes-mfc-data-access.md b/docs/data/features-of-record-view-classes-mfc-data-access.md index 0f19f101bda..4b5aa7499ed 100644 --- a/docs/data/features-of-record-view-classes-mfc-data-access.md +++ b/docs/data/features-of-record-view-classes-mfc-data-access.md @@ -1,11 +1,10 @@ --- -description: "Learn more about: Features of Record View Classes (MFC Data Access)" -title: "Features of Record View Classes (MFC Data Access)" -ms.date: "11/04/2016" +title: "Features of Record View Classes (MFC Data Access)" +description: "Learn more about: Features of Record View Classes (MFC Data Access)" +ms.date: 11/04/2016 helpviewer_keywords: ["record views, classes", "record view classes"] -ms.assetid: e7b2820f-09c4-483f-83c0-317e8be42bdf --- -# Features of Record View Classes (MFC Data Access) +# Features of Record View Classes (MFC Data Access) You can do form-based data-access programming with class [CFormView](../mfc/reference/cformview-class.md), but [CRecordView](../mfc/reference/crecordview-class.md) is generally a better class to derive from. In addition to its `CFormView` features, `CRecordView`: diff --git a/docs/data/filling-a-list-box-from-a-second-recordset-mfc-data-access.md b/docs/data/filling-a-list-box-from-a-second-recordset-mfc-data-access.md index 78104b47fc8..23a02764b2d 100644 --- a/docs/data/filling-a-list-box-from-a-second-recordset-mfc-data-access.md +++ b/docs/data/filling-a-list-box-from-a-second-recordset-mfc-data-access.md @@ -1,11 +1,11 @@ --- -description: "Learn more about: Filling a List Box from a Second Recordset (MFC Data Access)" -title: "Filling a List Box from a Second Recordset (MFC Data Access)" -ms.date: "11/04/2016" +title: "Filling a List Box from a Second Recordset (MFC Data Access)" +description: "Learn more about: Filling a List Box from a Second Recordset (MFC Data Access)" +ms.date: 11/04/2016 helpviewer_keywords: ["record views, filling list boxes", "list boxes, filling from second recordset", "recordsets [C++], filling list boxes or combo boxes", "CComboBox class, filling object from second rowset", "ODBC recordsets [C++], filling list boxes or combo boxes", "combo boxes [C++], filling from second recordset", "CListCtrl class, filling from second recordset"] -ms.assetid: 360c0834-da6b-4dc0-bcea-80e9acd611f0 +ms.topic: how-to --- -# Filling a List Box from a Second Recordset (MFC Data Access) +# Filling a List Box from a Second Recordset (MFC Data Access) By default, a record view is associated with a single recordset object, whose fields are mapped to the record view's controls. Sometimes you might want to put a list box or combo box control in your record view and fill it with values from a second recordset object. The user can use the list box to select a new category of information to display in the record view. This topic explains how and when to do that. diff --git a/docs/data/installing-database-support-mfc-atl.md b/docs/data/installing-database-support-mfc-atl.md index 047eee85fef..6a63eec21ef 100644 --- a/docs/data/installing-database-support-mfc-atl.md +++ b/docs/data/installing-database-support-mfc-atl.md @@ -5,6 +5,7 @@ ms.date: "11/04/2016" helpviewer_keywords: ["data access [C++], installing database support", "installing database support", "ATL [C++], database support", "databases [C++], installing database support"] ms.assetid: 3820ba96-4fb8-4405-83dd-bb3bc5998667 ms.custom: intro-installation +ms.topic: concept-article --- # Installing Database Support (MFC/ATL) diff --git a/docs/data/odbc/connecting-to-a-data-source.md b/docs/data/odbc/connecting-to-a-data-source.md index 18a727d5a83..52845dfa96b 100644 --- a/docs/data/odbc/connecting-to-a-data-source.md +++ b/docs/data/odbc/connecting-to-a-data-source.md @@ -4,6 +4,7 @@ title: "Connecting to a Data Source" ms.date: "11/04/2016" helpviewer_keywords: ["database connections [C++], ODBC", "ODBC connections [C++], using", "connections [C++], data source", "databases [C++], connecting to", "data sources [C++], connecting to", "ODBC data sources [C++], connections", "database connections [C++], MFC ODBC classes"] ms.assetid: ef6c8c98-5979-43a8-9fb5-5bb06fc59f36 +ms.topic: concept-article --- # Connecting to a Data Source diff --git a/docs/data/odbc/data-source-managing-connections-odbc.md b/docs/data/odbc/data-source-managing-connections-odbc.md index 3c08f7c6a11..8667ed49931 100644 --- a/docs/data/odbc/data-source-managing-connections-odbc.md +++ b/docs/data/odbc/data-source-managing-connections-odbc.md @@ -4,6 +4,7 @@ title: "Data Source: Managing Connections (ODBC)" ms.date: "11/04/2016" helpviewer_keywords: ["ODBC data sources [C++], multiuser environments", "generalizing connection strings", "ODBC [C++], disconnecting from data sources", "connection strings [C++], generalizing", "database connections [C++], creating", "GetDefaultConnect method", "connections [C++], data source", "ODBC connections [C++], configuring", "disconnecting from data sources", "databases [C++], connecting to", "ODBC connections [C++], disconnecting", "data sources [C++], connecting to", "ODBC connections [C++], connecting to data source", "ODBC data sources [C++], connections", "database connections [C++], MFC ODBC classes"] ms.assetid: c0adbcdd-c000-40c6-b199-09ffdc7b6ef2 +ms.custom: sfi-ropc-nochange --- # Data Source: Managing Connections (ODBC) diff --git a/docs/data/odbc/displaying-and-manipulating-data-in-a-form.md b/docs/data/odbc/displaying-and-manipulating-data-in-a-form.md index 46c6041841d..cf05784207f 100644 --- a/docs/data/odbc/displaying-and-manipulating-data-in-a-form.md +++ b/docs/data/odbc/displaying-and-manipulating-data-in-a-form.md @@ -4,6 +4,7 @@ title: "Displaying and Manipulating Data in a Form" ms.date: "11/04/2016" helpviewer_keywords: ["forms [C++], displaying data", "displaying data [C++], forms", "ODBC [C++], forms", "record views [C++], displaying data", "data [MFC]", "data [MFC], displaying in a form"] ms.assetid: c56185c4-12cb-40b1-b499-02b29ea83e3a +ms.topic: concept-article --- # Displaying and Manipulating Data in a Form diff --git a/docs/data/odbc/installing-and-getting-started-with-odbc.md b/docs/data/odbc/installing-and-getting-started-with-odbc.md index 6f358b59278..a62e8cab628 100644 --- a/docs/data/odbc/installing-and-getting-started-with-odbc.md +++ b/docs/data/odbc/installing-and-getting-started-with-odbc.md @@ -5,6 +5,7 @@ ms.date: "11/04/2016" helpviewer_keywords: ["installing ODBC", "ODBC, installing"] ms.assetid: 6b473481-1d68-468f-89f6-82b0fd7716fd ms.custom: intro-installation +ms.topic: get-started --- # Installing and Getting Started with ODBC diff --git a/docs/data/odbc/odbc-and-mfc.md b/docs/data/odbc/odbc-and-mfc.md index 5f25751635a..8a647cef023 100644 --- a/docs/data/odbc/odbc-and-mfc.md +++ b/docs/data/odbc/odbc-and-mfc.md @@ -1,14 +1,13 @@ --- -description: "Learn more about: ODBC and MFC" title: "ODBC and MFC" +description: "Learn more about: ODBC and MFC" ms.date: "11/04/2016" helpviewer_keywords: ["ODBC [C++], MFC", "connections [C++], databases", "connections [C++], data source", "databases [C++], connecting to", "data sources [C++], connecting to", "MFC [C++], ODBC and", "database connections [C++], MFC ODBC classes"] -ms.assetid: 98f02fd7-1235-437b-89a9-edfd0fc797f7 --- # ODBC and MFC > [!NOTE] -> To use the MFC database classes, you must have the appropriate ODBC driver for your data source. The lastest Microsoft ODBC driver for SQL Server is [Microsoft ODBC Driver 13 for SQL Server](https://www.microsoft.com/download/details.aspx?id=50420). Most database vendors provide an ODBC driver for Windows. +> To use the MFC database classes, you must have the appropriate ODBC driver for your data source. The lastest Microsoft ODBC driver for SQL Server is [Microsoft ODBC Driver 18 for SQL Server](/sql/connect/odbc/download-odbc-driver-for-sql-server). Most database vendors provide an ODBC driver for Windows. This topic introduces the main concepts of the Microsoft Foundation Classes (MFC) library's ODBC-based database classes and provides an overview of how the classes work together. For more information about ODBC and MFC, see the following topics: diff --git a/docs/data/odbc/record-field-exchange-how-rfx-works.md b/docs/data/odbc/record-field-exchange-how-rfx-works.md index 1845d7f121e..f2f300fd447 100644 --- a/docs/data/odbc/record-field-exchange-how-rfx-works.md +++ b/docs/data/odbc/record-field-exchange-how-rfx-works.md @@ -4,6 +4,7 @@ title: "Record Field Exchange: How RFX Works" ms.date: "11/04/2016" helpviewer_keywords: ["record editing [C++], using RFX", "RFX (ODBC) [C++], updating data in recordsets", "scrolling [C++]", "ODBC [C++], RFX", "data binding [C++], DFX", "scrolling [C++], RFX", "RFX (ODBC) [C++], binding fields and parameters"] ms.assetid: e647cacd-62b0-4b80-9e20-b392deca5a88 +ms.topic: concept-article --- # Record Field Exchange: How RFX Works diff --git a/docs/data/odbc/record-field-exchange-working-with-the-wizard-code.md b/docs/data/odbc/record-field-exchange-working-with-the-wizard-code.md index e4863b06c9f..40e4b98913b 100644 --- a/docs/data/odbc/record-field-exchange-working-with-the-wizard-code.md +++ b/docs/data/odbc/record-field-exchange-working-with-the-wizard-code.md @@ -4,6 +4,7 @@ title: "Record Field Exchange: Working with the Wizard Code" ms.date: "05/09/2019" helpviewer_keywords: ["DoFieldExchange method, overriding", "Unicode, with database classes", "field data members, declaring", "RFX (ODBC), wizard code", "RFX (ODBC), implementing", "field data members", "ODBC, RFX", "m_nParams data member, initializing", "m_nFields data member", "m_nParams data member", "overriding, DoFieldExchange", "m_nFields data member, initializing"] ms.assetid: f00d882a-ff1b-4a75-9717-98d8762bb237 +ms.topic: how-to --- # Record Field Exchange: Working with the Wizard Code diff --git a/docs/data/odbc/recordset-fetching-records-in-bulk-odbc.md b/docs/data/odbc/recordset-fetching-records-in-bulk-odbc.md index bea45e7ed94..83ad1f4bc73 100644 --- a/docs/data/odbc/recordset-fetching-records-in-bulk-odbc.md +++ b/docs/data/odbc/recordset-fetching-records-in-bulk-odbc.md @@ -1,9 +1,8 @@ --- -description: "Learn more about: Recordset: Fetching Records in Bulk (ODBC)" title: "Recordset: Fetching Records in Bulk (ODBC)" -ms.date: "11/04/2016" +description: "Learn more about: Recordset: Fetching Records in Bulk (ODBC)" +ms.date: 11/04/2016 helpviewer_keywords: ["bulk row fetching, implementing", "ODBC recordsets, bulk row fetching", "bulk record field exchange", "bulk row fetching", "bulk RFX functions", "recordsets, bulk row fetching", "DoBulkFieldExchange method", "fetching ODBC records in bulk", "RFX (ODBC), bulk", "rowsets, bulk row fetching", "RFX (ODBC), bulk row fetching"] -ms.assetid: 20d10fe9-c58a-414a-b675-cdf9aa283e4f --- # Recordset: Fetching Records in Bulk (ODBC) @@ -74,7 +73,7 @@ public: . . . -} +}; ``` You can either allocate these storage buffers manually or have the framework do the allocation. To allocate the buffers yourself, you must specify the `CRecordset::userAllocMultiRowBuffers` option of the *dwOptions* parameter in the `Open` member function. Be sure to set the sizes of the arrays at least equal to the rowset size. If you want to have the framework do the allocation, you should initialize your pointers to NULL. This is typically done in the recordset object's constructor: diff --git a/docs/data/odbc/redistributing-odbc-components-to-your-customers.md b/docs/data/odbc/redistributing-odbc-components-to-your-customers.md index 96b7157adc5..35e7a61de99 100644 --- a/docs/data/odbc/redistributing-odbc-components-to-your-customers.md +++ b/docs/data/odbc/redistributing-odbc-components-to-your-customers.md @@ -4,6 +4,7 @@ title: "Redistributing ODBC Components to Your Customers" ms.date: "11/04/2016" helpviewer_keywords: ["ODBC components, redistributing", "ODBC, distributing components", "components [C++], distributing", "ODBC Administrator", "components [C++]", "components [C++], redistributing"] ms.assetid: 17b065b4-a307-4b89-99ac-d05831cfab87 +ms.topic: concept-article --- # Redistributing ODBC Components to Your Customers diff --git a/docs/data/odbc/selecting-and-manipulating-records.md b/docs/data/odbc/selecting-and-manipulating-records.md index c39755668cb..d8d3c06f787 100644 --- a/docs/data/odbc/selecting-and-manipulating-records.md +++ b/docs/data/odbc/selecting-and-manipulating-records.md @@ -4,6 +4,7 @@ title: "Selecting and Manipulating Records" ms.date: "05/09/2019" helpviewer_keywords: ["records, selecting", "record selection, MFC ODBC classes", "ODBC recordsets, selecting records"] ms.assetid: 7f0b3a4a-9941-4475-a612-9ec8d15b7691 +ms.topic: concept-article --- # Selecting and Manipulating Records diff --git a/docs/data/odbc/sql-customizing-your-recordsets-sql-statement-odbc.md b/docs/data/odbc/sql-customizing-your-recordsets-sql-statement-odbc.md index c8f798aa6f0..034a0b37d85 100644 --- a/docs/data/odbc/sql-customizing-your-recordsets-sql-statement-odbc.md +++ b/docs/data/odbc/sql-customizing-your-recordsets-sql-statement-odbc.md @@ -1,9 +1,8 @@ --- -description: "Learn more about: SQL: Customizing Your Recordset's SQL Statement (ODBC)" title: "SQL: Customizing Your Recordset's SQL Statement (ODBC)" -ms.date: "11/04/2016" +description: "Learn more about: SQL: Customizing Your Recordset's SQL Statement (ODBC)" +ms.date: 11/04/2016 helpviewer_keywords: ["recordsets, SQL statements", "ODBC recordsets, SQL statements", "SQL statements, customizing", "SQL statements, recordset", "customizing SQL statements", "overriding, SQL statements", "SQL, opening recordsets"] -ms.assetid: 72293a08-cef2-4be2-aa1c-30565fcfbaf9 --- # SQL: Customizing Your Recordset's SQL Statement (ODBC) @@ -82,11 +81,11 @@ The following table shows the possibilities for the *lpszSQL* parameter to `Open \* `m_nFields` must be less than or equal to the number of columns specified in the **SELECT** statement. The data type of each column specified in the **SELECT** statement must be the same as the data type of the corresponding RFX output column. -### Case 1 lpszSQL = NULL +### Case 1 lpszSQL = NULL The recordset selection depends on what `GetDefaultSQL` returns when `CRecordset::Open` calls it. Cases 2 through 5 describe the possible strings. -### Case 2 lpszSQL = a Table Name +### Case 2 lpszSQL = a Table Name The recordset uses record field exchange (RFX) to build the column list from the column names provided in the RFX function calls in the recordset class's override of `DoFieldExchange`. If you used a wizard to declare your recordset class, this case has the same result as case 1 (provided that you pass the same table name you specified in the wizard). If you do not use a wizard to write your class, case 2 is the simplest way to construct the SQL statement. @@ -120,7 +119,7 @@ SELECT CourseID, InstructorID, RoomNo, Schedule, SectionNo FROM SECTION ``` -### Case 3 lpszSQL = a SELECT/FROM Statement +### Case 3 lpszSQL = a SELECT/FROM Statement You specify the column list by hand rather than relying on RFX to construct it automatically. You might want to do this when: @@ -138,11 +137,11 @@ You specify the column list by hand rather than relying on RFX to construct it a For information and an example, see [Recordset: Performing a Join (ODBC)](../../data/odbc/recordset-performing-a-join-odbc.md). -### Case 4 lpszSQL = SELECT/FROM Plus WHERE and/or ORDER BY +### Case 4 lpszSQL = SELECT/FROM Plus WHERE and/or ORDER BY You specify everything: the column list (based on the RFX calls in `DoFieldExchange`), the table list, and the contents of a **WHERE** and/or an **ORDER BY** clause. If you specify your **WHERE** and/or **ORDER BY** clauses this way, do not use `m_strFilter` and/or `m_strSort`. -### Case 5 lpszSQL = a Stored Procedure Call +### Case 5 lpszSQL = a Stored Procedure Call If you need to call a predefined query (such as a stored procedure in a Microsoft SQL Server database), you must write a **CALL** statement in the string you pass to *lpszSQL*. The wizards do not support declaring a recordset class for calling a predefined query. Not all predefined queries return records. diff --git a/docs/data/odbc/working-with-documents-and-views.md b/docs/data/odbc/working-with-documents-and-views.md index fd9339a4dff..d683432083b 100644 --- a/docs/data/odbc/working-with-documents-and-views.md +++ b/docs/data/odbc/working-with-documents-and-views.md @@ -4,6 +4,7 @@ title: "Working with Documents and Views" ms.date: "11/04/2016" helpviewer_keywords: ["MFC [C++], documents", "MFC [C++], views", "views [C++], MFC", "documents [C++], MFC"] ms.assetid: 349b142d-1c5a-4b99-9de4-241e41d3d2f1 +ms.topic: concept-article --- # Working with Documents and Views diff --git a/docs/data/oledb/cdatasource-class.md b/docs/data/oledb/cdatasource-class.md index befd0149817..d85b974a3cb 100644 --- a/docs/data/oledb/cdatasource-class.md +++ b/docs/data/oledb/cdatasource-class.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: CDataSource Class" title: "CDataSource Class" -ms.date: "11/04/2016" +description: "Learn more about: CDataSource Class" +ms.date: 11/04/2016 f1_keywords: ["ATL.CDataSource", "ATL::CDataSource", "CDataSource", "ATL::CDataSource::Close", "ATL.CDataSource.Close", "CDataSource::Close", "CDataSource.Close", "ATL::CDataSource::GetInitializationString", "CDataSource.GetInitializationString", "GetInitializationString", "CDataSource::GetInitializationString", "ATL.CDataSource.GetInitializationString", "CDataSource::GetProperties", "ATL.CDataSource.GetProperties", "CDataSource.GetProperties", "ATL::CDataSource::GetProperties", "ATL::CDataSource::GetProperty", "ATL.CDataSource.GetProperty", "CDataSource.GetProperty", "CDataSource::GetProperty", "ATL::CDataSource::Open", "ATL.CDataSource.Open", "CDataSource::Open", "CDataSource.Open", "CDataSource::OpenFromFileName", "ATL::CDataSource::OpenFromFileName", "OpenFromFileName", "CDataSource.OpenFromFileName", "ATL.CDataSource.OpenFromFileName", "CDataSource.OpenFromInitializationString", "OpenFromInitializationString", "CDataSource::OpenFromInitializationString", "ATL::CDataSource::OpenFromInitializationString", "ATL.CDataSource.OpenFromInitializationString", "CDataSource.OpenWithPromptFileName", "OpenWithPromptFileName", "ATL::CDataSource::OpenWithPromptFileName", "ATL.CDataSource.OpenWithPromptFileName", "CDataSource::OpenWithPromptFileName", "CDataSource::OpenWithServiceComponents", "OpenWithServiceComponents", "CDataSource.OpenWithServiceComponents"] helpviewer_keywords: ["CDataSource class", "Close method", "GetInitializationString method", "GetProperties method", "GetProperty method", "Open method", "OpenFromFileName method", "OpenFromInitializationString method", "OpenWithPromptFileName method", "OpenWithServiceComponents method"] -ms.assetid: 99bf862c-9d5c-4117-9501-aa0e2672085c --- # CDataSource Class @@ -201,7 +200,7 @@ HRESULT Open(LPCSTR szProgID, [in] The user's password. *nInitMode*
-[in] Database initialization mode. See [Initialization Properties](/previous-versions/windows/desktop/ms723127(v=vs.85))in the *OLE DB Programmer's Reference* in the Windows SDK for a list of valid initialization modes. If *nInitMode* is zero, no initialization mode is included in the property set used to open the connection. +[in] Database initialization mode. See [Initialization Properties](/previous-versions/windows/desktop/ms723127(v=vs.85)) in the *OLE DB Programmer's Reference* in the Windows SDK for a list of valid initialization modes. If *nInitMode* is zero, no initialization mode is included in the property set used to open the connection. *szProgID*
[in] A program identifier. diff --git a/docs/data/oledb/cdbpropset-class.md b/docs/data/oledb/cdbpropset-class.md index 9086c09dde7..858162faf33 100644 --- a/docs/data/oledb/cdbpropset-class.md +++ b/docs/data/oledb/cdbpropset-class.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: CDBPropSet Class" title: "CDBPropSet Class" +description: "Learn more about: CDBPropSet Class" ms.date: "11/04/2016" f1_keywords: ["CDBPropSet", "ATL.CDBPropSet", "ATL::CDBPropSet", "CDBPropSet::AddProperty", "CDBPropSet.AddProperty", "AddProperty", "ATL::CDBPropSet::AddProperty", "ATL.CDBPropSet.AddProperty", "CDBPropSet.CDBPropSet", "CDBPropSet::CDBPropSet", "ATL::CDBPropSet::CDBPropSet", "ATL.CDBPropSet.CDBPropSet", "CDBPropSet.operator=", "ATL::CDBPropSet::operator=", "ATL.CDBPropSet.operator=", "CDBPropSet::operator=", "ATL.CDBPropSet.SetGUID", "CDBPropSet.SetGUID", "ATL::CDBPropSet::SetGUID", "CDBPropSet::SetGUID"] helpviewer_keywords: ["CDBPropSet class", "AddProperty method", "CDBPropSet class, constructor", "operator =, property sets", "= operator, with OLE DB templates", "operator=, property sets", "SetGUID method", "AddProperty method"] -ms.assetid: 54190149-c277-4679-b81a-ef484d4d1c00 --- # CDBPropSet Class @@ -144,8 +143,8 @@ CDBPropSet& operator =(CDBPropSet& propset) throw(); ## See also -[OLE DB Consumer Templates](../../data/oledb/ole-db-consumer-templates-cpp.md)
-[OLE DB Consumer Templates Reference](../../data/oledb/ole-db-consumer-templates-reference.md)
-[CDBPropIDSet Class](../../data/oledb/cdbpropidset-class.md)
-[DBPROPSET Structure](/previous-versions/windows/desktop/ms714367(v=vs.85)) +[OLE DB Consumer Templates](../../data/oledb/ole-db-consumer-templates-cpp.md)\ +[OLE DB Consumer Templates Reference](../../data/oledb/ole-db-consumer-templates-reference.md)\ +[CDBPropIDSet Class](../../data/oledb/cdbpropidset-class.md)\ +[DBPROPSET Structure](/previous-versions/windows/desktop/ms714367(v=vs.85))\ [DBPROP Structure](/previous-versions/windows/desktop/ms717970(v=vs.85)) diff --git a/docs/data/oledb/creating-an-updatable-provider.md b/docs/data/oledb/creating-an-updatable-provider.md index dd01af2f426..cb579e95ae6 100644 --- a/docs/data/oledb/creating-an-updatable-provider.md +++ b/docs/data/oledb/creating-an-updatable-provider.md @@ -1,9 +1,8 @@ --- -description: "Learn more about: Creating an Updatable Provider" title: "Creating an Updatable Provider" -ms.date: "08/16/2018" +description: "Learn more about: Creating an Updatable Provider" +ms.date: 08/16/2018 helpviewer_keywords: ["OLE DB providers, updatable", "notifications, support in providers", "OLE DB providers, creating"] -ms.assetid: bdfd5c9f-1c6f-4098-822c-dd650e70ab82 --- # Creating an Updatable Provider @@ -174,7 +173,7 @@ Making sure that the data store can handle changes. Handling NULL values. -### Handling default values. +### Handling default values To implement your own `FlushData` method, you need to: diff --git a/docs/data/oledb/crowset-class.md b/docs/data/oledb/crowset-class.md index d64fd3ebc50..d42f6d0f813 100644 --- a/docs/data/oledb/crowset-class.md +++ b/docs/data/oledb/crowset-class.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: CRowset Class" title: "CRowset Class" +description: "Learn more about: CRowset Class" ms.date: "11/04/2016" f1_keywords: ["ATL.CRowset", "CRowset", "ATL::CRowset", "ATL::CRowset", "ATL.CRowset", "CRowset.AddRefRows", "CRowset.AddRefRows", "ATL.CRowset.AddRefRows", "AddRefRows", "CRowset::AddRefRows", "CRowset::AddRefRows", "ATL::CRowset::AddRefRows", "ATL.CRowset.AddRefRows", "ATL::CRowset::AddRefRows", "CRowset::Close", "ATL.CRowset.Close", "CRowset::Close", "CRowset.Close", "ATL.CRowset.Close", "ATL::CRowset::Close", "ATL::CRowset::Close", "CRowset.Close", "CRowset.Compare", "CRowset::Compare", "ATL.CRowset.Compare", "ATL::CRowset::Compare", "CRowset.Compare", "ATL::CRowset::Compare", "ATL.CRowset.Compare", "CRowset::Compare", "CRowset::CRowset", "CRowset.CRowset", "ATL::CRowset::CRowset", "ATL::CRowset::CRowset", "ATL.CRowset.CRowset", "CRowset.CRowset", "CRowset::CRowset", "ATL.CRowset.CRowset", "ATL::CRowset::Delete", "CRowset.Delete", "CRowset::Delete", "ATL.CRowset.Delete", "ATL::CRowset::Delete", "CRowset.Delete", "CRowset::Delete", "ATL.CRowset.Delete", "ATL.CRowset.FindNextRow", "CRowset.FindNextRow", "ATL::CRowset::FindNextRow", "CRowset::FindNextRow", "CRowset::FindNextRow", "CRowset.FindNextRow", "ATL.CRowset.FindNextRow", "ATL::CRowset::FindNextRow", "FindNextRow", "ATL::CRowset::GetApproximatePosition", "ATL::CRowset::GetApproximatePosition", "CRowset.GetApproximatePosition", "CRowset::GetApproximatePosition", "GetApproximatePosition", "ATL.CRowset.GetApproximatePosition", "CRowset::GetApproximatePosition", "CRowset::GetData", "ATL::CRowset::GetData", "ATL::CRowset::GetData", "ATL.CRowset.GetData", "CRowset.GetData", "CRowset::GetData", "CRowset.GetData", "ATL.CRowset.GetData", "CRowset::GetDataHere", "CRowset.GetDataHere", "CRowset.GetDataHere", "GetDataHere", "CRowset::GetDataHere", "ATL::CRowset::GetDataHere", "ATL::CRowset::GetDataHere", "ATL.CRowset.GetDataHere", "ATL.CRowset.GetDataHere", "ATL.CRowset.GetOriginalData", "CRowset::GetOriginalData", "ATL::CRowset::GetOriginalData", "ATL.CRowset.GetOriginalData", "CRowset::GetOriginalData", "ATL::CRowset::GetOriginalData", "CRowset.GetOriginalData", "CRowset.GetRowStatus", "ATL.CRowset.GetRowStatus", "ATL::CRowset::GetRowStatus", "CRowset::GetRowStatus", "ATL::CRowset::GetRowStatus", "CRowset::GetRowStatus", "ATL.CRowset.GetRowStatus", "CRowset.GetRowStatus", "ATL.CRowset.Insert", "CRowset.Insert", "CRowset.Insert", "CRowset::Insert", "ATL::CRowset::Insert", "ATL.CRowset.Insert", "CRowset::Insert", "ATL::CRowset::Insert", "CRowset::IsSameRow", "CRowset.IsSameRow", "ATL::CRowset::IsSameRow", "ATL.CRowset.IsSameRow", "CRowset::IsSameRow", "ATL.CRowset.IsSameRow", "CRowset.IsSameRow", "ATL::CRowset::IsSameRow", "CRowset::MoveFirst", "ATL::CRowset::MoveFirst", "CRowset.MoveFirst", "CRowset::MoveFirst", "CRowset.MoveFirst", "ATL.CRowset.MoveFirst", "ATL.CRowset.MoveFirst", "ATL::CRowset::MoveFirst", "ATL::CRowset::MoveLast", "CRowset::MoveLast", "ATL.CRowset.MoveLast", "ATL::CRowset::MoveLast", "CRowset.MoveLast", "CRowset::MoveLast", "ATL.CRowset.MoveLast", "CRowset.MoveLast", "ATL.CRowset.MoveNext", "ATL.CRowset.MoveNext", "ATL::CRowset::MoveNext", "CRowset.MoveNext", "CRowset.MoveNext", "CRowset::MoveNext", "CRowset::MoveNext", "ATL::CRowset::MoveNext", "CRowset.MovePrev", "CRowset.MovePrev", "CRowset::MovePrev", "ATL.CRowset.MovePrev", "ATL::CRowset::MovePrev", "ATL::CRowset::MovePrev", "ATL.CRowset.MovePrev", "CRowset::MovePrev", "ATL::CRowset::MoveToBookmark", "ATL::CRowset::MoveToBookmark", "ATL.CRowset.MoveToBookmark", "ATL.CRowset.MoveToBookmark", "CRowset::MoveToBookmark", "CRowset.MoveToBookmark", "CRowset::MoveToBookmark", "CRowset::MoveToRatio", "CRowset::MoveToRatio", "CRowset.MoveToRatio", "ATL.CRowset.MoveToRatio", "ATL::CRowset::MoveToRatio", "CRowset.MoveToRatio", "ATL.CRowset.MoveToRatio", "ATL::CRowset::MoveToRatio", "CRowset::ReleaseRows", "ATL::CRowset::ReleaseRows", "CRowset.ReleaseRows", "CRowset.ReleaseRows", "ATL.CRowset.ReleaseRows", "ATL.CRowset.ReleaseRows", "CRowset::ReleaseRows", "ATL::CRowset::ReleaseRows", "ATL.CRowset.SetData", "ATL::CRowset::SetData", "CRowset.SetData", "CRowset::SetData", "ATL.CRowset.SetData", "CRowset.SetData", "CRowset::SetData", "ATL::CRowset::SetData", "CRowset.Undo", "ATL::CRowset::Undo", "CRowset::Undo", "ATL.CRowset.Undo", "ATL.CRowset.Undo", "CRowset.Undo", "ATL::CRowset::Undo", "CRowset::Undo", "Undo", "CRowset.Update", "ATL.CRowset.Update", "ATL.CRowset.Update", "ATL::CRowset::Update", "CRowset::Update", "CRowset::Update", "CRowset.Update", "ATL::CRowset::Update", "CRowset::UpdateAll", "ATL.CRowset.UpdateAll", "CRowset.UpdateAll", "ATL.CRowset.UpdateAll", "UpdateAll", "CRowset.UpdateAl", "ATL::CRowset::UpdateAll", "CRowset::UpdateAll", "ATL::CRowset::UpdateAll"] helpviewer_keywords: ["CRowset class", "AddRefRows method", "Close method", "Compare method", "CRowset class, constructor", "Delete method", "FindNextRow method", "GetApproximatePosition method", "GetData method [OLE DB]", "GetDataHere method", "GetOriginalData method", "GetRowStatus method", "Insert method", "IsSameRow method", "MoveFirst method", "MoveLast method", "MoveNext method", "MovePrev method", "MoveToBookmark method", "MoveToRatio method", "ReleaseRows method", "SetData method", "Undo method", "Update method", "UpdateAll method"] -ms.assetid: b0228a90-b8dd-47cc-b397-8d4c15c1e7f4 --- # CRowset Class @@ -19,7 +18,7 @@ class CRowset ### Parameters -*TAccessor*
+*TAccessor*\ An accessor class. The default is `CAccessorBase`. ## Requirements @@ -36,14 +35,14 @@ An accessor class. The default is `CAccessorBase`. |[Close](#close)|Releases rows and the current `IRowset` interface.| |[Compare](#compare)|Compares two bookmarks using [IRowsetLocate::Compare](/previous-versions/windows/desktop/ms709539(v=vs.85)).| |[CRowset](#crowset)|Creates a new `CRowset` object and (optionally) associates it with an `IRowset` interface supplied as a parameter.| -|[Delete](#delete)|Deletes rows from the rowset using [IRowsetChange:DeleteRows](/previous-versions/windows/desktop/ms724362(v=vs.85)).| +|[Delete](#delete)|Deletes rows from the rowset using [IRowsetChange::DeleteRows](/previous-versions/windows/desktop/ms724362(v=vs.85)).| |[FindNextRow](#findnextrow)|Finds the next matching row after the specified bookmark.| |[GetApproximatePosition](#getapproximateposition)|Returns the approximate position of a row corresponding to a bookmark.| |[GetData](#getdata)|Retrieves data from the rowset's copy of the row.| |[GetDataHere](#getdatahere)|Retrieves data from the specified buffer.| |[GetOriginalData](#getoriginaldata)|Retrieves the data most recently fetched from or transmitted to the data source, ignoring pending changes.| |[GetRowStatus](#getrowstatus)|Returns the status of all rows.| -|[Insert](#insert)|Creates and inserts a new row using [IRowsetChange:InsertRow](/previous-versions/windows/desktop/ms716921(v=vs.85)).| +|[Insert](#insert)|Creates and inserts a new row using [IRowsetChange::InsertRow](/previous-versions/windows/desktop/ms716921(v=vs.85)).| |[IsSameRow](#issamerow)|Compares the specified row with the current row.| |[MoveFirst](#movefirst)|Repositions the next-fetch location to the initial position.| |[MoveLast](#movelast)|Moves to the last record.| @@ -52,7 +51,7 @@ An accessor class. The default is `CAccessorBase`. |[MoveToBookmark](#movetobookmark)|Fetches the row marked by a bookmark or the row at a specified offset from that bookmark.| |[MoveToRatio](#movetoratio)|Fetches rows starting from a fractional position in the rowset.| |[ReleaseRows](#releaserows)|Calls [IRowset::ReleaseRows](/previous-versions/windows/desktop/ms719771(v=vs.85)) to release the current row handle.| -|[SetData](#setdata)|Sets data values in one or more columns of a row using [IRowsetChange:SetData](/previous-versions/windows/desktop/ms721232(v=vs.85)).| +|[SetData](#setdata)|Sets data values in one or more columns of a row using [IRowsetChange::SetData](/previous-versions/windows/desktop/ms721232(v=vs.85)).| |[Undo](#undo)|Undoes any changes made to a row since the last fetch or [Update](#update).| |[Update](#update)|Transmits any pending changes made to the current row since the last fetch or update.| |[UpdateAll](#updateall)|Transmits any pending changes made to all rows since the last fetch or update.| @@ -109,13 +108,13 @@ HRESULT Compare(const CBookmarkBase& bookmark1, #### Parameters -*Bookmark1*
+*Bookmark1*\ [in] The first bookmark to compare. -*Bookmark2*
+*Bookmark2*\ [in] The second bookmark to compare. -*pComparison*
+*pComparison*\ [out] A pointer to the result of the comparison. ### Return Value @@ -142,7 +141,7 @@ CRowset(IRowset* pRowset); #### Parameters -*pRowset*
+*pRowset*\ [in] A pointer to an `IRowset` interface to be associated with this class. ## CRowset::Delete @@ -178,28 +177,28 @@ HRESULT FindNextRow(DBCOMPAREOP op, #### Parameters -*op*
+*op*\ [in] The operation to use in comparing row values. For values, see [IRowsetFind::FindNextRow](/previous-versions/windows/desktop/ms723091(v=vs.85)). -*pData*
+*pData*\ [in] A pointer to the value to be matched. -*wType*
+*wType*\ [in] Indicates the data type of the value part of the buffer. For information about type indicators, see [Data Types](/previous-versions/windows/desktop/ms723969(v=vs.85)) in the *OLE DB Programmer's Reference* in the Windows SDK. -*nLength*
+*nLength*\ [in] The length, in bytes, of the consumer data structure allocated for the data value. For details, see the description of `cbMaxLen` in [DBBINDING Structures](/previous-versions/windows/desktop/ms716845(v=vs.85)) in the *OLE DB Programmer's Reference.* -*bPrecision*
+*bPrecision*\ [in] The maximum precision used when getting data. Used only if *wType* is DBTYPE_NUMERIC. For more information, see [Conversions involving DBTYPE_NUMERIC or DBTYPE_DECIMAL](/previous-versions/windows/desktop/ms719714(v=vs.85)) in the *OLE DB Programmer's Reference*. -*bScale*
+*bScale*\ [in] The scale used when getting data. Used only if *wType* is DBTYPE_NUMERIC or DBTYPE_DECIMAL. For more information, see [Conversions involving DBTYPE_NUMERIC or DBTYPE_DECIMAL](/previous-versions/windows/desktop/ms719714(v=vs.85)) in the *OLE DB Programmer's Reference*. -*bSkipCurrent*
+*bSkipCurrent*\ [in] The number of rows from the bookmark at which to start a search. -*pBookmark*
+*pBookmark*\ [in] The bookmark for position at which to start a search. ### Return Value @@ -226,13 +225,13 @@ HRESULT GetApproximatePosition(const CBookmarkBase* pBookmark, #### Parameters -*pBookmark*
+*pBookmark*\ [in] A pointer to a bookmark that identifies the row whose position is to be found. NULL if only the row count is required. -*pPosition*
+*pPosition*\ [out] A pointer to the location where `GetApproximatePosition` returns the position of the row. NULL if the position is not required. -*pcRows*
+*pcRows*\ [out] A pointer to the location where `GetApproximatePosition` returns the total number of rows. NULL if the row count is not required. ### Return Value @@ -259,7 +258,7 @@ HRESULT GetData(int nAccessor) throw(); #### Parameters -*nAccessor*
+*nAccessor*\ [in] The (zero-offset) index number of the accessor to use for accessing the data. ### Return Value @@ -283,10 +282,10 @@ HRESULT GetDataHere(int nAccessor, #### Parameters -*nAccessor*
+*nAccessor*\ [in] The index number of the accessor to use for accessing the data. -*pBuffer*
+*pBuffer*\ [out] A buffer into which to place the data for the current record. ### Return Value @@ -329,7 +328,7 @@ HRESULT GetRowStatus(DBPENDINGSTATUS* pStatus) const throw(); #### Parameters -*pStatus*
+*pStatus*\ [out] A pointer to a location where `GetRowStatus` returns the status value. See DBPENDINGSTATUS in the OLE DB Programmer's Reference. ### Return Value @@ -353,10 +352,10 @@ HRESULT Insert(int nAccessor = 0, #### Parameters -*nAccessor*
+*nAccessor*\ [in] The number of the accessor to use for inserting the data. -*bGetHRow*
+*bGetHRow*\ [in] Indicates whether the handle for the inserted row is retrieved. ### Return Value @@ -389,7 +388,7 @@ HRESULT IsSameRow(HROW hRow) const throw(); #### Parameters -*hRow*
+*hRow*\ [in] A handle to the row to compare to the current row. ### Return Value @@ -449,10 +448,10 @@ HRESULT MoveNext(LONG lSkip, #### Parameters -*lSkip*
+*lSkip*\ [in] The number of rows to skip before fetching. -*bForward*
+*bForward*\ [in] Pass **`true`** to move forward to the next record, **`false`** to move backward. ### Return Value @@ -502,10 +501,10 @@ HRESULT MoveToBookmark(const CBookmarkBase& bookmark, #### Parameters -*bookmark*
+*bookmark*\ [in] A bookmark marking the location from which you want to fetch data. -*lSkip*
+*lSkip*\ [in] The number count of rows from the bookmark to the target row. If *lSkip* is zero, the first row fetched is the bookmarked row. If *lSkip* is 1, the first row fetched is the row after the bookmarked row. If *lSkip* is -1, the first row fetched is the row before the bookmarked row. ### Return Value @@ -531,13 +530,13 @@ HRESULT MoveToRatio(DBCOUNTITEM nNumerator, #### Parameters -*nNumerator*
+*nNumerator*\ [in] The numerator used to determine the fractional positional from which to fetch data. -*nDenominator*
+*nDenominator*\ [in] The denominator used to determine the fractional positional from which to fetch data. -*bForward*
+*bForward*\ [in] Indicates whether to move forward or backward. The default is forward. ### Return Value @@ -582,7 +581,7 @@ HRESULT SetData(int nAccessor) const throw(); #### Parameters -*nAccessor*
+*nAccessor*\ [in] The number of the accessor to use for accessing the data. ### Return Value @@ -611,13 +610,13 @@ HRESULT Undo(DBCOUNTITEM* pcRows = NULL, #### Parameters -*pcRows*
+*pcRows*\ [out] A pointer to the location where `Undo` returns the number of rows it attempted to undo if required. -*phRow*
+*phRow*\ [out] A pointer to the location where `Undo` returns an array of handles to all rows it attempted to undo if required. -*pStatus*
+*pStatus*\ [out] A pointer to the location where `Undo` returns the row status value. No status is returned if *pStatus* is null. ### Return Value @@ -642,13 +641,13 @@ HRESULT Update(DBCOUNTITEM* pcRows = NULL, #### Parameters -*pcRows*
+*pcRows*\ [out] A pointer to the location where `Update` returns the number of rows it attempted to update, if required. -*phRow*
+*phRow*\ [out] A pointer to the location where `Update` returns the handle of the row it attempted to update. No handle is returned if *phRow* is null. -*pStatus*
+*pStatus*\ [out] A pointer to the location where `Update` returns the row status value. No status is returned if *pStatus* is null. ### Return Value @@ -675,13 +674,13 @@ HRESULT UpdateAll(DBCOUNTITEM* pcRows = NULL, #### Parameters -*pcRows*
+*pcRows*\ [out] A pointer to the location where `UpdateAll` returns the number of rows it attempted to update, if required. -*pphRow*
+*pphRow*\ [out] A pointer to memory in which `UpdateAll` returns the handle of the row it attempted to update. No handle is returned if *pphRow* is null. -*ppStatus*
+*ppStatus*\ [out] A pointer to the location where `Update` returns the row status value. No status is returned if *ppStatus* is null. ### Remarks @@ -698,8 +697,8 @@ A standard HRESULT. ## See also -[DBViewer Sample](../../overview/visual-cpp-samples.md)
-[MultiRead Sample](../../overview/visual-cpp-samples.md)
-[MultiRead Attributes Sample](../../overview/visual-cpp-samples.md)
-[OLE DB Consumer Templates](../../data/oledb/ole-db-consumer-templates-cpp.md)
+[DBViewer Sample](../../overview/visual-cpp-samples.md)\ +[MultiRead Sample](../../overview/visual-cpp-samples.md)\ +[MultiRead Attributes Sample](../../overview/visual-cpp-samples.md)\ +[OLE DB Consumer Templates](../../data/oledb/ole-db-consumer-templates-cpp.md)\ [OLE DB Consumer Templates Reference](../../data/oledb/ole-db-consumer-templates-reference.md) diff --git a/docs/data/oledb/crowsetimpl-class.md b/docs/data/oledb/crowsetimpl-class.md index e83271fca53..ee3884e6daa 100644 --- a/docs/data/oledb/crowsetimpl-class.md +++ b/docs/data/oledb/crowsetimpl-class.md @@ -5,6 +5,7 @@ ms.date: "11/04/2016" f1_keywords: ["CRowsetImpl", "ATL.CRowsetImpl", "ATL::CRowsetImpl", "CRowsetImpl.NameFromDBID", "CRowsetImpl::NameFromDBID", "CRowsetImpl.SetCommandText", "CRowsetImpl::SetCommandText", "CRowsetImpl.GetColumnInfo", "CRowsetImpl::GetColumnInfo", "CRowsetImpl::GetCommandFromID", "GetCommandFromID", "CRowsetImpl.GetCommandFromID", "CRowsetImpl.ValidateCommandID", "CRowsetImpl::ValidateCommandID", "CRowsetImpl.m_rgRowData", "CRowsetImpl::m_rgRowData", "CRowsetImpl::m_strCommandText", "CRowsetImpl.m_strCommandText", "CRowsetImpl::m_strIndexText", "CRowsetImpl.m_strIndexText"] helpviewer_keywords: ["CRowsetImpl class", "NameFromDBID method", "SetCommandText method", "GetColumnInfo method", "GetCommandFromID method", "ValidateCommandID method", "m_rgRowData", "m_strCommandText", "m_strIndexText"] ms.assetid: e97614b3-b11d-4806-a0d3-b9401331473f +ms.custom: sfi-ropc-nochange --- # CRowsetImpl Class diff --git a/docs/data/oledb/icommandpropertiesimpl-class.md b/docs/data/oledb/icommandpropertiesimpl-class.md index 3d50ed3c85f..2b1694ea7c9 100644 --- a/docs/data/oledb/icommandpropertiesimpl-class.md +++ b/docs/data/oledb/icommandpropertiesimpl-class.md @@ -5,6 +5,7 @@ ms.date: "11/04/2016" f1_keywords: ["ICommandPropertiesImpl", "ATL.ICommandPropertiesImpl", "ATL::ICommandPropertiesImpl", "ICommandPropertiesImpl::GetProperties", "ICommandPropertiesImpl.GetProperties", "ICommandPropertiesImpl.SetProperties", "ICommandPropertiesImpl::SetProperties"] helpviewer_keywords: ["ICommandPropertiesImpl class", "GetProperties method", "SetProperties method"] ms.assetid: b3cf6aea-527e-4f0d-96e0-669178b021a2 +ms.custom: sfi-ropc-nochange --- # ICommandPropertiesImpl Class diff --git a/docs/data/oledb/irowsetcreatorimpl-class.md b/docs/data/oledb/irowsetcreatorimpl-class.md index 542a3dffabe..8fb9c33eabd 100644 --- a/docs/data/oledb/irowsetcreatorimpl-class.md +++ b/docs/data/oledb/irowsetcreatorimpl-class.md @@ -5,6 +5,7 @@ ms.date: "11/04/2016" f1_keywords: ["ATL::IRowsetCreatorImpl", "ATL.IRowsetCreatorImpl", "ATL::IRowsetCreatorImpl", "ATL.IRowsetCreatorImpl", "IRowsetCreatorImpl", "IRowsetCreatorImpl.SetSite", "IRowsetCreatorImpl::SetSite", "IRowsetCreatorImpl::SetSite", "SetSite", "ATL.IRowsetCreatorImpl.SetSite", "ATL::IRowsetCreatorImpl::SetSite", "ATL::IRowsetCreatorImpl::SetSite", "ATL.IRowsetCreatorImpl.SetSite"] helpviewer_keywords: ["IRowsetCreatorImpl class", "SetSite method"] ms.assetid: 92cc950f-7978-4754-8d9a-defa63867d82 +ms.custom: sfi-ropc-nochange --- # IRowsetCreatorImpl Class diff --git a/docs/data/oledb/irowsetinfoimpl-class.md b/docs/data/oledb/irowsetinfoimpl-class.md index d05de7876df..d5f545e3bb7 100644 --- a/docs/data/oledb/irowsetinfoimpl-class.md +++ b/docs/data/oledb/irowsetinfoimpl-class.md @@ -5,6 +5,7 @@ ms.date: "11/04/2016" f1_keywords: ["ATL.IRowsetInfoImpl", "IRowsetInfoImpl", "ATL::IRowsetInfoImpl", "ATL.IRowsetInfoImpl.GetProperties", "IRowsetInfoImpl.GetProperties", "ATL::IRowsetInfoImpl::GetProperties", "IRowsetInfoImpl::GetProperties", "ATL::IRowsetInfoImpl::GetReferencedRowset", "GetReferencedRowset", "ATL.IRowsetInfoImpl.GetReferencedRowset", "IRowsetInfoImpl.GetReferencedRowset", "IRowsetInfoImpl::GetReferencedRowset", "IRowsetInfoImpl::GetSpecification", "ATL.IRowsetInfoImpl.GetSpecification", "IRowsetInfoImpl.GetSpecification", "GetSpecification", "ATL::IRowsetInfoImpl::GetSpecification"] helpviewer_keywords: ["IRowsetInfoImpl class", "GetProperties method", "GetReferencedRowset method", "GetSpecification method"] ms.assetid: 9c654155-7727-464e-bd31-143e68391a47 +ms.custom: sfi-ropc-nochange --- # IRowsetInfoImpl Class diff --git a/docs/data/oledb/irowsetlocateimpl-class.md b/docs/data/oledb/irowsetlocateimpl-class.md index 082de1f7b90..16872cbd1a0 100644 --- a/docs/data/oledb/irowsetlocateimpl-class.md +++ b/docs/data/oledb/irowsetlocateimpl-class.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: IRowsetLocateImpl Class" title: "IRowsetLocateImpl Class" +description: "Learn more about: IRowsetLocateImpl Class" ms.date: "11/04/2016" f1_keywords: ["IRowsetLocateImpl", "ATL.IRowsetLocateImpl.Compare", "IRowsetLocateImpl::Compare", "IRowsetLocateImpl.Compare", "ATL::IRowsetLocateImpl::Compare", "GetRowsAt", "IRowsetLocateImpl.GetRowsAt", "ATL::IRowsetLocateImpl::GetRowsAt", "IRowsetLocateImpl::GetRowsAt", "ATL.IRowsetLocateImpl.GetRowsAt", "IRowsetLocateImpl::GetRowsByBookmark", "IRowsetLocateImpl.GetRowsByBookmark", "GetRowsByBookmark", "IRowsetLocateImpl::Hash", "IRowsetLocateImpl.Hash", "m_rgBookmarks", "IRowsetLocateImpl::m_rgBookmarks", "ATL.IRowsetLocateImpl.m_rgBookmarks", "ATL::IRowsetLocateImpl::m_rgBookmarks", "IRowsetLocateImpl.m_rgBookmarks"] helpviewer_keywords: ["providers, bookmarks", "IRowsetLocateImpl class", "bookmarks, OLE DB", "Compare method", "GetRowsAt method", "GetRowsByBookmark method", "Hash method", "m_rgbookmarks"] -ms.assetid: a8aa3149-7ce8-4976-a680-2da193fd3234 --- # IRowsetLocateImpl Class @@ -202,8 +201,8 @@ CAtlArray m_rgBookmarks; ## See also -[OLE DB Provider Templates](../../data/oledb/ole-db-provider-templates-cpp.md)
-[OLE DB Provider Template Architecture](../../data/oledb/ole-db-provider-template-architecture.md)
-[IRowsetLocate:IRowset](/previous-versions/windows/desktop/ms721190(v=vs.85)) -[Provider Support for Bookmarks](../../data/oledb/provider-support-for-bookmarks.md)
+[OLE DB Provider Templates](../../data/oledb/ole-db-provider-templates-cpp.md)\ +[OLE DB Provider Template Architecture](../../data/oledb/ole-db-provider-template-architecture.md)\ +[IRowsetLocate:IRowset](/previous-versions/windows/desktop/ms721190(v=vs.85))\ +[Provider Support for Bookmarks](../../data/oledb/provider-support-for-bookmarks.md)\ [Bookmarks](/previous-versions/windows/desktop/ms709728(v=vs.85)) diff --git a/docs/data/oledb/irowsetnotifyimpl-class.md b/docs/data/oledb/irowsetnotifyimpl-class.md index 314202ddd9b..8737941bcd0 100644 --- a/docs/data/oledb/irowsetnotifyimpl-class.md +++ b/docs/data/oledb/irowsetnotifyimpl-class.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: IRowsetNotifyImpl Class" title: "IRowsetNotifyImpl Class" +description: "Learn more about: IRowsetNotifyImpl Class" ms.date: "11/04/2016" f1_keywords: ["ATL.IRowsetNotifyImpl", "ATL::IRowsetNotifyImpl", "IRowsetNotifyImpl", "IRowsetNotifyImpl.OnFieldChange", "IRowsetNotifyImpl::OnFieldChange", "OnFieldChange", "IRowsetNotifyImpl::OnRowChange", "IRowsetNotifyImpl.OnRowChange", "OnRowChange", "OnRowsetChange", "IRowsetNotifyImpl::OnRowsetChange", "IRowsetNotifyImpl.OnRowsetChange"] helpviewer_keywords: ["IRowsetNotifyImpl class", "OnFieldChange method", "OnRowChange method", "OnRowsetChange method"] -ms.assetid: fbfd0cb2-38ff-4b42-899a-8de902f834b8 --- # IRowsetNotifyImpl Class @@ -121,6 +120,6 @@ This method wraps the [IRowsetNotify::OnRowsetChange](/previous-versions/windows ## See also -[OLE DB Consumer Templates](../../data/oledb/ole-db-consumer-templates-cpp.md)
-[IRowsetNotify](/previous-versions/windows/desktop/ms712959(v=vs.85)) +[OLE DB Consumer Templates](../../data/oledb/ole-db-consumer-templates-cpp.md)\ +[IRowsetNotify](/previous-versions/windows/desktop/ms712959(v=vs.85))\ [IRowsetNotifyCP Class](../../data/oledb/irowsetnotifycp-class.md) diff --git a/docs/data/oledb/isessionpropertiesimpl-class.md b/docs/data/oledb/isessionpropertiesimpl-class.md index 89043502938..5818498c6e9 100644 --- a/docs/data/oledb/isessionpropertiesimpl-class.md +++ b/docs/data/oledb/isessionpropertiesimpl-class.md @@ -5,6 +5,7 @@ ms.date: "11/04/2016" f1_keywords: ["ISessionPropertiesImpl", "ISessionPropertiesImpl::GetProperties", "ISessionPropertiesImpl.GetProperties", "ISessionPropertiesImpl.SetProperties", "ISessionPropertiesImpl::SetProperties"] helpviewer_keywords: ["ISessionPropertiesImpl class", "GetProperties method", "SetProperties method"] ms.assetid: ca0ba254-c7dc-4c52-abec-cf895a0c6a63 +ms.custom: sfi-ropc-nochange --- # ISessionPropertiesImpl Class diff --git a/docs/data/oledb/ole-db-provider-templates-reference.md b/docs/data/oledb/ole-db-provider-templates-reference.md index 8e4f8167f9f..ba16a0f8a26 100644 --- a/docs/data/oledb/ole-db-provider-templates-reference.md +++ b/docs/data/oledb/ole-db-provider-templates-reference.md @@ -4,6 +4,7 @@ title: "OLE DB Provider Templates Reference" ms.date: "11/04/2016" helpviewer_keywords: ["OLE DB provider templates"] ms.assetid: 518358f0-bab1-4de9-bce9-4062cc87c11f +ms.custom: sfi-ropc-nochange --- # OLE DB Provider Templates Reference diff --git a/docs/data/oledb/schema-rowset-classes-and-typedef-classes.md b/docs/data/oledb/schema-rowset-classes-and-typedef-classes.md index 574d95b2ac2..f4782506663 100644 --- a/docs/data/oledb/schema-rowset-classes-and-typedef-classes.md +++ b/docs/data/oledb/schema-rowset-classes-and-typedef-classes.md @@ -1,12 +1,9 @@ --- -description: "Learn more about: Schema Rowset Classes and Typedef Classes" title: "Schema Rowset Classes and Typedef Classes" -ms.date: "11/04/2016" +description: "Learn more about: Schema Rowset Classes and Typedef Classes" +ms.date: 11/04/2016 f1_keywords: ["CAssertionInfo", "CAssertions", "CCatalogInfo", "CCatalogs", "CCharacterSetInfo", "CCharacterSets", "CCheckConstraintInfo", "CCheckConstraints", "CCollationInfo", "CCollations", "CColumnDomainUsage", "CColumnDomainUsageInfo", "CColumnPrivilegeInfo", "CColumnPrivileges", "CColumns", "CColumnsInfo", "CConstraintColumnUsage", "CConstraintColumnUsageInfo", "CConstraintTableUsage", "CConstraintTableUsageInfo", "CForeignKeys", "CForeignKeysInfo", "CHARACTER_MAXIMUM_LENGTH", "CHARACTER_OCTET_LENGTH", "CHARACTER_SET_CATALOG", "CHARACTER_SET_NAME", "CHARACTER_SET_SCHEMA", "CHECK_CLAUSE", "CHECK_CONSTRAINTS", "CHECK_OPTION", "CIndexes", "CIndexInfo", "CKeyColumnInfo", "CKeyColumns", "CLUSTERED", "COLLATION", "COLLATION_CATALOG", "COLLATION_NAME", "COLLATION_SCHEMA", "COLLATIONS", "COLUMN_DEFAULT", "COLUMN_DOMAIN_USAGE", "COLUMN_FLAGS", "COLUMN_GUID", "COLUMN_HASDEFAULT", "COLUMN_PRIVILEGES", "COLUMN_PROPID", "COLUMN_SIZE", "CONSTRAINT_CATALOG", "CONSTRAINT_COLUMN_USAGE", "CONSTRAINT_NAME", "CONSTRAINT_SCHEMA", "CONSTRAINT_TABLE_USAGE", "CONSTRAINT_TYPE", "CPrimaryKeyInfo", "CPrimaryKeys", "CProcedureColumnInfo", "CProcedureColumns", "CProcedureInfo", "CProcedureParameters", "CProcedureParamInfo", "CProcedures", "CProviderInfo", "CProviderTypes", "CReferentialConstraintInfo", "CReferentialConstraints", "CSchemata", "CSchemataInfo", "CSQLLanguageInfo", "CSQLLanguages", "CStatisticInfo", "CStatistics", "CTableConstraintInfo", "CTableConstraints", "CTableInfo", "CTablePrivilegeInfo", "CTablePrivileges", "CTables", "CTranslationInfo", "CTranslations", "CUsagePrivilegeInfo", "CUsagePrivileges", "CViewColumnInfo", "CViewColumnUsage", "CViewInfo", "CViews", "CViewTableInfo", "CViewTableUsage", "DATA_TYPE", "DATETIME_PRECISION", "DEFAULT_CHARACTER_SET_CATALOG", "DEFAULT_CHARACTER_SET_NAME", "DEFAULT_CHARACTER_SET_SCHEMA", "DEFAULT_COLLATE_CATALOG", "DEFAULT_COLLATE_NAME", "DEFAULT_COLLATE_SCHEMA", "DELETE_RULE", "DOMAIN_CATALOG", "DOMAIN_NAME", "DOMAIN_SCHEMA", "FILL_FACTOR", "FILTER_CONDITION", "FIXED_PREC_SCALE", "FK_COLUMN_GUID", "FK_COLUMN_NAME", "FK_COLUMN_PROPID", "FK_TABLE_CATALOG", "FK_TABLE_NAME", "FK_TABLE_SCHEMA", "FORM_OF_USE", "GRANTEE", "GRANTOR", "INDEX_CATALOG", "INDEX_NAME", "INDEX_SCHEMA", "INITIAL_SIZE", "INITIALLY_DEFERRED", "IS_DEFERRABLE", "IS_GRANTABLE", "IS_LONG", "IS_NULLABLE", "IS_UPDATABLE", "LITERAL_SUFFIX", "LOCAL_TYPE_NAME", "m_bAutoUniqueValue", "m_bAutoUpdate", "m_bBestMatch", "m_bCaseSensitive", "m_bCheckOption", "m_bClustered", "m_bColumnHasDefault", "m_bFixedPrecScale", "m_bHasDefault", "m_bInitiallyDeferred", "m_bIsDeferrable", "m_bIsGrantable", "m_bIsLong", "m_bIsNullable", "m_bIsUpdatable", "m_bPrimaryKey", "m_bSortBookmarks", "m_bUnique", "m_bUnsignedAttribute", "m_guidColumn", "m_guidFKColumn", "m_guidPKColumn", "m_guidTable", "m_guidType", "m_nCardinality", "m_nCollation", "m_nColumnFlags", "m_nColumnPropID", "m_nColumnSize", "m_nDataType", "m_nDateTimePrecision", "m_nFillFactor", "m_nFKColumnPropID", "m_nInitialSize", "m_nMaxLength", "m_nMaxScale", "m_nNullCollation", "m_nNulls", "m_nNumCharacters", "m_nNumericPrecision", "m_nNumericScale", "m_nOctetLength", "m_nOrdinal", "m_nOrdinalPosition", "m_nPages", "m_nPKColumnPropID", "m_nPrecision", "m_nRowsetNumber", "m_nScale", "m_nSearchable", "m_szBindingStyle", "m_szCatalog", "m_szCharCatalog", "m_szCharName", "m_szCharSchema", "m_szCharSetCatalog", "m_szCharSetName", "m_szCharSetSchema", "m_szCheckClause", "m_szCollateCatalog", "m_szCollateName", "m_szCollateSchema", "m_szCollationCatalog", "m_szCollationName", "m_szCollationSchema", "m_szColumnDefault", "m_szColumnName", "m_szConformance", "m_szConstraintCatalog", "m_szConstraintName", "m_szConstraintSchema", "m_szCreateParams", "m_szDefault", "m_szDefinition", "m_szDeleteRule", "m_szDomainCatalog", "m_szDomainName", "m_szDomainSchema", "m_szFilterCondition", "m_szFKColumnName", "m_szFKTableCatalog", "m_szFKTableName", "m_szFKTableSchema", "m_szFormOfUse", "m_szGrantee", "m_szGrantor", "m_szImplementation", "m_szIndexCatalog", "m_szIndexName", "m_szIndexSchema", "m_szIntegrity", "m_szLiter alSuffix", "m_szLiteralPrefix", "m_szLocalTypeName", "m_szMatchOption", "m_szObjectCatalog", "m_szObjectName", "m_szObjectSchema", "m_szObjectType", "m_szOwner", "m_szPadAttribute", "m_szParameterName", "m_szPKColumnName", "m_szPKTableCatalog", "m_szPKTableName", "m_szPKTableSchema", "m_szPrivilegeType", "m_szProgrammingLanguage", "m_szSchema", "m_szSource", "m_szSourceCatalog", "m_szSourceName", "m_szSourceSchema", "m_szTableCatalog", "m_szTableName", "m_szTableSchema", "m_szTargetCatalog", "m_szTargetName", "m_szTargetSchema", "m_szType", "m_szTypeLib", "m_szTypeName", "m_szUniqueCatalog", "m_szUniqueName", "m_szUniqueSchema", "m_szUpdateRule", "m_szVersion", "m_szYear", "MATCH_OPTION", "MAXIMUM_SCALE", "MINIMUM_SCALE", "NULL_COLLATION", "NULLS", "NUMBER_OF_CHARACTERS", "NUMERIC_PRECISION", "NUMERIC_SCALE", "OBJECT_CATALOG", "OBJECT_NAME", "OBJECT_SCHEMA", "OBJECT_TYPE", "ORDINAL", "ORDINAL_POSITION", "TABLE_CATALOG", "TABLE_GUID", "TABLE_NAME", "TABLE_SCHEMA"] - - helpviewer_keywords: ["schema rowsets", "CAssertionInfo parameter class", "CAssertions typedef class", "CCatalogInfo parameter class", "CCatalogs typedef class", "CCharacterSetInfo parameter class", "CCharacterSets typedef class", "CCheckConstraintInfo parameter class", "CCheckConstraints typedef class", "CCollationInfo parameter class", "CCollations typedef class", "CColumnDomainUsage typedef class", "CColumnDomainUsageInfo parameter class", "CColumnPrivilegeInfo parameter class", "CColumnPrivileges typedef class", "CColumns typedef class", "CColumnsInfo parameter class", "CConstraintColumnUsage typedef class", "CConstraintColumnUsageInfo parameter class", "CConstraintTableUsage typedef class", "CConstraintTableUsageInfo parameter class", "CForeignKeys typedef class", "CForeignKeysInfo parameter class", "CHARACTER_MAXIMUM_LENGTH", "CHARACTER_OCTET_LENGTH", "CHARACTER_SET_CATALOG", "CHARACTER_SET_NAME", "CHARACTER_SET_SCHEMA", "CHECK_CLAUSE", "CHECK_CONSTRAINTS", "CHECK_OPTION", "CIndexes typedef class", "CIndexInfo parameter class", "CKeyColumnInfo parameter class", "CKeyColumns typedef class", "CLUSTERED", "COLLATION_CATALOG", "COLLATION_NAME", "COLLATION_SCHEMA", "COLLATIONS recordset", "COLUMN_DEFAULT", "COLUMN_DOMAIN_USAGE", "COLUMN_FLAGS", "COLUMN_GUID", "COLUMN_HASDEFAULT", "COLUMN_NAME", "COLUMN_PRIVILEGES", "COLUMN_PROPID", "CONSTRAINT_CATALOG", "CONSTRAINT_COLUMN_USAGE", "CONSTRAINT_NAME", "CONSTRAINT_SCHEMA", "CONSTRAINT_TABLE_USAGE", "CONSTRAINT_TYPE", "CPrimaryKeyInfo parameter class", "CPrimaryKeys typedef class", "CProcedureColumnInfo parameter class", "CProcedureColumns typedef class", "CProcedureInfo parameter class", "CProcedureParameters typedef class", "CProcedureParamInfo parameter class", "CProcedures typedef class", "CProviderInfo parameter class", "CProviderTypes typedef class", "CReferentialConstraintInfo parameter class", "CReferentialConstraints typedef class", "CSchemata typedef class", "CSchemataInfo parameter class", "CSQLLanguageInfo parameter class", "CSQLLanguages typedef class", "CStatisticInfo parameter class", "CStatistics typedef class", "CTableConstraintInfo parameter class", "CTableConstraints typedef class", "CTableInfo parameter class", "CTablePrivilegeInfo parameter class", "CTablePrivileges typedef class", "CTables typedef class", "CTranslationInfo parameter class", "CTranslations typedef class", "CUsagePrivilegeInfo parameter class", "CUsagePrivileges typedef class", "CViewColumnInfo parameter class", "CViewColumnUsage typedef class", "CViewInfo parameter class", "CViews typedef class", "CViewTableInfo parameter class", "CViewTableUsage typedef class", "DATA_TYPE", "DATETIME_PRECISION", "DEFAULT_CHARACTER_SET_CATALOG", "DEFAULT_CHARACTER_SET_NAME", "DEFAULT_CHARACTER_SET_SCHEMA", "DEFAULT_COLLATE_CATALOG", "DEFAULT_COLLATE_NAME", "DEFAULT_COLLATE_SCHEMA", "DELETE_RULE", "DESCRIPTION class data member", "DOMAIN_CATALOG", "DOMAIN_NAME", "DOMAIN_SCHEMA", "FILL_FACTOR", "FILTER_CONDITION", "FIXED_PREC_SCALE", "FK_COLUMN_GUID", "FK_COLUMN_NAME", "FK_COLUMN_PROPID", "FK_TABLE_CATALOG", "FK_TABLE_NAME", "FK_TABLE_SCHEMA", "FORM_OF_USE OLE DB column", "GRANTEE", "GRANTOR", "INDEX_CATALOG", "INDEX_NAME", "INDEX_SCHEMA", "INITIAL_SIZE", "INITIALLY_DEFERRED", "IS_DEFERRABLE", "IS_GRANTABLE", "IS_LONG", "IS_NULLABLE", "IS_UPDATABLE", "LITERAL_SUFFIX", "LOCAL_TYPE_NAME", "m_bAutoUniqueValue", "m_bAutoUpdate", "m_bBestMatch", "m_bCaseSensitive", "m_bCheckOption", "m_bClustered", "m_bColumnHasDefault", "m_bFixedPrecScale", "m_bHasDefault", "m_bInitiallyDeferred", "m_bIsDeferrable", "m_bIsGrantable", "m_bIsLong", "m_bIsNullable", "m_bIsUpdatable", "m_bPrimaryKey", "m_bSortBookmarks", "m_bUnique", "m_bUnsignedAttribute", "m_guidColumn", "m_guidFKColumn", "m_guidTable", "m_guidType", "m_nCardinality", "m_nCollation", "m_nColumnFlags", "m_nColumnPropID", "m_nColumnSize", "m_nDataType", "m_nDateTimePrecision", "m_nFillFactor", "m_nFKColumnPropID", "m_nInitialSize", "m_nMaxLength", "m_nMinScale", "m_nNullCollation", "m_nNulls", "m_nNumCharacters", "m_nNumericPrecision", "m_nNumericScale", "m_nOctetLength", "m_nOrdinal", "m_nOrdinalPosition", "m_nPages", "m_nPKColumnPropID", "m_nPrecision", "m_nRowsetNumber", "m_nScale", "m_nSearchable", "m_nType", "m_szBindingStyle", "m_szCatalog", "m_szCharCatalog", "m_szCharName", "m_szCharSchema", "m_szCharSetCatalog", "m_szCharSetName", "m_szCharSetSchema", "m_szCheckClause", "m_szCollateCatalog", "m_szCollateName", "m_szCollateSchema", "m_szCollationCatalog", "m_szCollationName", "m_szCollationSchema", "m_szColumnDefault", "m_szColumnName", "m_szConformance", "m_szConstraintCatalog", "m_szConstraintName", "m_szConstraintSchema", "m_szCreateParams", "m_szDefault", "m_szDefinition", "m_szDeleteRule", "m_szDescription", "m_szDomainCatalog", "m_szDomainName", "m_szDomainSchema", "m_szFilterCondition", "m_szFKColumnName", "m_szFKTableCatalog", "m_szFKTableName", "m_szFKTableSchema", "m_szFormOfUse", "m_szGrantee", "m_szGrantor", "m_szImplementation", "m_szIndexCatalog", "m_szIndexName", "m_szIndexSchema", "m_szIntegrity", "m_szLiteralPrefix", "m_szLocalTypeName", "m_szMatchOption", "m_szName", "m_szObjectCatalog", "m_szObjectName", "m_szObjectSchema", "m_szObjectType", "m_szOwner", "m_szPadAttribute", "m_szParameterName", "m_szPKColumnName", "m_szPKTableCatalog", "m_szPKTableName", "m_szPKTableSchema", "m_szPrivilegeType", "m_szPrivilegeType", "m_szProgrammingLanguage", "m_szSchema", "m_szSource", "m_szSourceCatalog", "m_szSourceName", "m_szSourceSchema", "m_szTableCatalog", "m_szTableName", "m_szTableSchema", "m_szTargetCatalog", "m_szTargetName", "m_szTargetSchema", "m_szType", "m_szTypeLib", "m_szTypeName", "m_szUniqueCatalog", "m_szUniqueName", "m_szUniqueSchema", "m_szUpdateRule", "m_szUpdateRule", "m_szVersion", "m_szYear", "MATCH_OPTION", "MAXIMUM_SCALE", "MINIMUM_SCALE", "NULL_COLLATION", "NULLS", "NUMBER_OF_CHARACTERS", "NUMERIC_PRECISION", "NUMERIC_SCALE", "OBJECT_CATALOG", "OBJECT_NAME", "OBJECT_SCHEMA", "OBJECT_TYPE", "ORDINAL data member", "ORDINAL_POSITION", "TABLE_CATALOG", "TABLE_GUID", "TABLE_NAME", "TABLE_SCHEMA"] -ms.assetid: 4bd881b3-26ca-4bdb-9226-d67560864f29 --- # Schema Rowset Classes and Typedef Classes diff --git a/docs/data/record-view-code-created-by-application-wizard-mfc-data-access.md b/docs/data/record-view-code-created-by-application-wizard-mfc-data-access.md index 73e90f63211..25cbb8cdefb 100644 --- a/docs/data/record-view-code-created-by-application-wizard-mfc-data-access.md +++ b/docs/data/record-view-code-created-by-application-wizard-mfc-data-access.md @@ -1,11 +1,10 @@ --- -description: "Learn more about: Record View Code Created by Application Wizard (MFC Data Access)" -title: "Record View Code Created by Application Wizard (MFC Data Access)" -ms.date: "11/04/2016" +title: "Record View Code Created by Application Wizard (MFC Data Access)" +description: "Learn more about: Record View Code Created by Application Wizard (MFC Data Access)" +ms.date: 11/04/2016 helpviewer_keywords: ["application wizards [C++], record view code", "record views, refreshing controls", "record views, application wizard code"] -ms.assetid: 18fd4703-5939-491d-b759-985f767b951f --- -# Record View Code Created by Application Wizard (MFC Data Access) +# Record View Code Created by Application Wizard (MFC Data Access) The [MFC Application Wizard](../mfc/reference/database-support-mfc-application-wizard.md) overrides the view's `OnInitialUpdate` and `OnGetRecordset` member functions. After the framework creates the frame window, document, and view, it calls `OnInitialUpdate` to initialize the view. `OnInitialUpdate` obtains a pointer to the recordset from the document. A call to the base class [CView::OnInitialUpdate](../mfc/reference/cview-class.md#oninitialupdate) function opens the recordset. The following code shows this process for a `CRecordView`: diff --git a/docs/data/record-views-mfc-data-access.md b/docs/data/record-views-mfc-data-access.md index d6ad32f05e2..2741f14ec1c 100644 --- a/docs/data/record-views-mfc-data-access.md +++ b/docs/data/record-views-mfc-data-access.md @@ -1,11 +1,10 @@ --- -description: "Learn more about: Record Views (MFC Data Access)" -title: "Record Views (MFC Data Access)" -ms.date: "11/04/2016" +title: "Record Views (MFC Data Access)" +description: "Learn more about: Record Views (MFC Data Access)" +ms.date: 11/04/2016 helpviewer_keywords: ["MFC [C++], record views", "ODBC recordsets [C++], record views", "databases [C++], record views", "record views [C++]", "forms [C++], data access tasks"] -ms.assetid: 562122d9-01d8-4284-acf6-ea109ab0408d --- -# Record Views (MFC Data Access) +# Record Views (MFC Data Access) This section applies only to the MFC ODBC classes. For information about OLE DB record views, see [COleDBRecordView](../mfc/reference/coledbrecordview-class.md) and [Using OLE DB Record Views](../data/oledb/using-ole-db-record-views.md). diff --git a/docs/data/schema-mfc-data-access.md b/docs/data/schema-mfc-data-access.md index c45bdeb2bc5..6b5c9e1d0e4 100644 --- a/docs/data/schema-mfc-data-access.md +++ b/docs/data/schema-mfc-data-access.md @@ -1,11 +1,10 @@ --- -description: "Learn more about: Schema (MFC Data Access)" -title: "Schema (MFC Data Access)" -ms.date: "11/04/2016" +title: "Schema (MFC Data Access)" +description: "Learn more about: Schema (MFC Data Access)" +ms.date: 11/04/2016 helpviewer_keywords: ["structures [C++], database", "databases [C++], schema", "database schema [C++], about database schemas", "database schema [C++]", "schemas [C++], database", "structures [C++]"] -ms.assetid: 7d17e35f-1ccf-4853-b915-5b8c7a45b9ee --- -# Schema (MFC Data Access) +# Schema (MFC Data Access) A database schema describes the current structure of the tables and database views in the database. In general, wizard-generated code assumes that the schema for the table or tables accessed by a recordset will not change, but the database classes can deal with some schema changes, such as adding, reordering, or deleting unbound columns. If a table changes, you must manually update the recordset for the table, then recompile your application. diff --git a/docs/data/supporting-navigation-in-a-record-view-mfc-data-access.md b/docs/data/supporting-navigation-in-a-record-view-mfc-data-access.md index df688530ed2..0bc07831d5d 100644 --- a/docs/data/supporting-navigation-in-a-record-view-mfc-data-access.md +++ b/docs/data/supporting-navigation-in-a-record-view-mfc-data-access.md @@ -1,11 +1,11 @@ --- -description: "Learn more about: Supporting Navigation in a Record View (MFC Data Access)" -title: "Supporting Navigation in a Record View (MFC Data Access)" -ms.date: "11/04/2016" +title: "Supporting Navigation in a Record View (MFC Data Access)" +description: "Learn more about: Supporting Navigation in a Record View (MFC Data Access)" +ms.date: 11/04/2016 helpviewer_keywords: ["records [C++], navigating", "record views, navigation", "navigation [C++], in record view"] -ms.assetid: 227f2a6d-87c9-4656-807a-8e246965bcce +ms.topic: reference --- -# Supporting Navigation in a Record View (MFC Data Access) +# Supporting Navigation in a Record View (MFC Data Access) This topic explains how to support movement from record to record in your [CRecordView](../mfc/reference/crecordview-class.md) class, including information about: diff --git a/docs/data/transactions-mfc-data-access.md b/docs/data/transactions-mfc-data-access.md index b9008f382a7..6d9bcec6ace 100644 --- a/docs/data/transactions-mfc-data-access.md +++ b/docs/data/transactions-mfc-data-access.md @@ -1,11 +1,10 @@ --- -description: "Learn more about: Transactions (MFC Data Access)" -title: "Transactions (MFC Data Access)" -ms.date: "11/04/2016" +title: "Transactions (MFC Data Access)" +description: "Learn more about: Transactions (MFC Data Access)" +ms.date: 11/04/2016 helpviewer_keywords: ["transactions [C++], support for", "transactions [C++]", "databases [C++], transactions"] -ms.assetid: f80afbfe-1517-4fec-8870-9ffc70a58b05 --- -# Transactions (MFC Data Access) +# Transactions (MFC Data Access) The concept of a transaction was developed to handle cases in which the resulting state of the database depends on the total success of a series of operations. This could come about because successive operations might modify the results of previous operations. In such cases, if any one operation fails, the resulting state could be indeterminate. diff --git a/docs/data/user-interface-updating-for-record-views-mfc-data-access.md b/docs/data/user-interface-updating-for-record-views-mfc-data-access.md index 5e489fd9018..e221fc09c0d 100644 --- a/docs/data/user-interface-updating-for-record-views-mfc-data-access.md +++ b/docs/data/user-interface-updating-for-record-views-mfc-data-access.md @@ -1,11 +1,10 @@ --- -description: "Learn more about: User-Interface Updating for Record Views (MFC Data Access)" -title: "User-Interface Updating for Record Views (MFC Data Access)" -ms.date: "11/04/2016" +title: "User-Interface Updating for Record Views (MFC Data Access)" +description: "Learn more about: User-Interface Updating for Record Views (MFC Data Access)" +ms.date: 11/04/2016 helpviewer_keywords: ["user interfaces, updating", "menus, updating as context changes", "record views, user interface"] -ms.assetid: 2c7914b6-2dc3-40c3-b2f2-8371da2a4063 --- -# User-Interface Updating for Record Views (MFC Data Access) +# User-Interface Updating for Record Views (MFC Data Access) `CRecordView` provides default user-interface update handlers for the navigation commands. These handlers automate enabling and disabling the user-interface objects — menu items and toolbar buttons. The application wizard supplies standard menus and, if you choose the **Dockable Toolbar** option, a set of toolbar buttons for the commands. If you create a record view class using `CRecordView`, you might want to add similar user-interface objects to your application. diff --git a/docs/data/using-a-record-view-mfc-data-access.md b/docs/data/using-a-record-view-mfc-data-access.md index 18724bc75b9..6cb21b3e690 100644 --- a/docs/data/using-a-record-view-mfc-data-access.md +++ b/docs/data/using-a-record-view-mfc-data-access.md @@ -1,11 +1,11 @@ --- -description: "Learn more about: Using a Record View (MFC Data Access)" -title: "Using a Record View (MFC Data Access)" -ms.date: "11/04/2016" +title: "Using a Record View (MFC Data Access)" +description: "Learn more about: Using a Record View (MFC Data Access)" +ms.date: 11/04/2016 helpviewer_keywords: ["record views, customizing default code"] -ms.assetid: 91f2828f-0666-4273-ae28-e4703fd98521 +ms.topic: concept-article --- -# Using a Record View (MFC Data Access) +# Using a Record View (MFC Data Access) This topic explains how you might commonly customize the default code for record views that the wizard writes for you. Typically, you want to constrain the record selection with a [filter](../data/odbc/recordset-filtering-records-odbc.md) or [parameters](../data/odbc/recordset-parameterizing-a-recordset-odbc.md), perhaps [sort](../data/odbc/recordset-sorting-records-odbc.md) the records, customize the SQL statement. diff --git a/docs/data/your-role-in-working-with-a-record-view-mfc-data-access.md b/docs/data/your-role-in-working-with-a-record-view-mfc-data-access.md index be06ed8b285..f88cfad605f 100644 --- a/docs/data/your-role-in-working-with-a-record-view-mfc-data-access.md +++ b/docs/data/your-role-in-working-with-a-record-view-mfc-data-access.md @@ -1,11 +1,10 @@ --- -description: "Learn more about: Your Role in Working with a Record View (MFC Data Access)" -title: "Your Role in Working with a Record View (MFC Data Access)" -ms.date: "11/04/2016" +title: "Your Role in Working with a Record View (MFC Data Access)" +description: "Learn more about: Your Role in Working with a Record View (MFC Data Access)" +ms.date: 11/04/2016 helpviewer_keywords: ["record views, customizing default code", "MFC, record views"] -ms.assetid: 691e89a5-ff21-4ca3-9278-69d4678288bb --- -# Your Role in Working with a Record View (MFC Data Access) +# Your Role in Working with a Record View (MFC Data Access) The following table shows what you typically must do to work with a record view and what the framework does for you. diff --git a/docs/docfx.json b/docs/docfx.json index 52f700e0840..e3765f2f722 100644 --- a/docs/docfx.json +++ b/docs/docfx.json @@ -38,11 +38,11 @@ "externalReference": [], "globalMetadata": { "breadcrumb_path": "~/_breadcrumb/toc.yml", -  "uhfHeaderId": "MSDocsHeader-CPP", + "uhfHeaderId": "MSDocsHeader-CPP", "ROBOTS": "INDEX,FOLLOW", "manager": "coxford", "ms.date": "11/16/2016", - "ms.topic": "conceptual", + "ms.topic": "article", "audience": "developer", "ms.service": "visual-cpp", "ms.tgt_pltfrm": "Windows", @@ -50,7 +50,6 @@ "cplusplus" ], "dev_langs": [ - "C++", "cpp" ], "searchScope": [ @@ -103,6 +102,7 @@ "atl/reference/**.md": "reference", "atl-mfc-shared/**.md": "reference", "build/reference/**.md": "reference", + "build-insights/reference/sdk/c-event-data-types/**.md": "reference", "c-language/**.md": "language-reference", "c-runtime-library/**.md": "reference", "c-runtime-library/reference/**.md": "reference", @@ -111,18 +111,18 @@ "cppcx/**.md": "language-reference", "data/oledb/**.md": "reference", "error-messages/**.md": "error-reference", + "ide/refactoring/**.md": "how-to", "extensions/**.md": "reference", "intrinsics/**.md": "reference", "mfc/reference/**.md": "reference", "overview/**.md": "overview", - "parallel/amp/reference/**.md": "reference", - "parallel/concrt/reference/**.md": "reference", - "parallel/openmp/reference/**.md": "reference", + "parallel/**.md": "reference", "preprocessor/**.md": "reference", "safeint/**.md": "reference", "sanitizers/**.md": "reference", "standard-library/**.md": "reference", - "windows/attributes/**.md": "reference" + "windows/attributes/**.md": "reference", + "**/how-to*.md": "how-to" }, "ms.subservice": { "assembler/**.md": "masm", @@ -140,6 +140,7 @@ "cross-platform/**.md": "tools", "data/**.md": "data-access", "dotnet/**.md": "cli-lang", + "embedded/**.md": "tools", "error-messages/**.md": "errors-warnings", "extensions/**.md": "cli-lang", "get-started/**.md": "cpp-lang", @@ -148,8 +149,6 @@ "linux/**.md": "linux-development", "mfc/**.md": "mfc-library", "overview/**.md": "tools", - "parallel/amp/**.md": "parallel-programming", - "parallel/concrt/**.md": "parallel-programming", "parallel/**.md": "parallel-programming", "porting/**.md": "cpp-lang", "preprocessor/**.md": "cpp-lang", @@ -160,79 +159,189 @@ "text/**.md": "windows-development", "windows/**.md": "windows-development" }, + "ms.update-cycle": { + "assembler/**.md": "3650-days", + "assembler/**.yml": "3650-days", + "attributes/**.md": "3650-days", + "attributes/**.yml": "3650-days", + "atl/**.md": "3650-days", + "atl/**.yml": "3650-days", + "atl-mfc-shared/**.md": "3650-days", + "atl-mfc-shared/**.yml": "3650-days", + "build/**.md": "1825-days", + "build/**.yml": "1825-days", + "c-language/**.md": "3650-days", + "c-language/**.yml": "3650-days", + "c-runtime-library/**.md": "3650-days", + "c-runtime-library/**.yml": "3650-days", + "cpp/**.md": "1095-days", + "cpp/**.yml": "1095-days", + "cppcx/**.md": "3650-days", + "cppcx/**.yml": "3650-days", + "cross-platform/**.md": "1825-days", + "cross-platform/**.yml": "1825-days", + "data/**.md": "3650-days", + "data/**.yml": "3650-days", + "dotnet/**.md": "3650-days", + "dotnet/**.yml": "3650-days", + "embedded/**.md": "3650-days", + "embedded/**.yml": "3650-days", + "error-messages/**.md": "3650-days", + "error-messages/**.yml": "3650-days", + "extensions/**.md": "3650-days", + "extensions/**.yml": "3650-days", + "intrinsics/**.md": "3650-days", + "intrinsics/**.yml": "3650-days", + "mfc/**.md": "3650-days", + "mfc/**.yml": "3650-days", + "parallel/**.md": "3650-days", + "parallel/**.yml": "3650-days", + "porting/**.md": "1095-days", + "porting/**.yml": "1095-days", + "preprocessor/**.md": "3650-days", + "preprocessor/**.yml": "3650-days", + "safeint/**.md": "3650-days", + "safeint/**.yml": "3650-days", + "standard-library/**.md": "3650-days", + "standard-library/**.yml": "3650-days", + "text/**.md": "3650-days", + "text/**.yml": "3650-days", + "windows/**.md": "1825-days", + "windows/**.yml": "1825-days" + }, "author": { - "index.md": "tylermsft", - "assembler/**.md": "tylermsft", - "attributes/**.md": "tylermsft", - "atl/**.md": "tylermsft", - "atl-mfc-shared/**.md": "tylermsft", - "build/**.md": "tylermsft", - "build-insights/**.md": "kevcadieux", - "c-language/**.md": "tylermsft", - "c-runtime-library/**.md": "tylermsft", - "cloud/**.md": "tylermsft", - "code-quality/**.md": "tylermsft", - "cpp/**.md": "tylermsft", - "cppcx/**.md": "tylermsft", - "cross-platform/**.md": "tylermsft", - "data/**.md": "tylermsft", - "dotnet/**.md": "tylermsft", - "error-messages/**.md": "tylermsft", - "extensions/**.md": "tylermsft", - "get-started/**.md": "tylermsft", - "ide/**.md": "tylermsft", - "intrinsics/**.md": "tylermsft", - "linux/**.md": "tylermsft", - "mfc/**.md": "tylermsft", - "overview/**.md": "tylermsft", - "parallel/amp/**.md": "tylermsft", - "parallel/concrt/**.md": "tylermsft", - "parallel/**.md": "tylermsft", - "porting/**.md": "tylermsft", - "preprocessor/**.md": "tylermsft", - "safeint/**.md": "tylermsft", - "sanitizers/**.md": "tylermsft", - "security/**.md": "tylermsft", - "standard-library/**.md": "tylermsft", - "text/**.md": "tylermsft", - "windows/**.md": "tylermsft" + "index.md": "TylerMSFT", + "assembler/**.md": "TylerMSFT", + "assembler/**.yml": "TylerMSFT", + "attributes/**.md": "TylerMSFT", + "attributes/**.yml": "TylerMSFT", + "atl/**.md": "TylerMSFT", + "atl/**.yml": "TylerMSFT", + "atl-mfc-shared/**.md": "TylerMSFT", + "atl-mfc-shared/**.yml": "TylerMSFT", + "build/**.md": "TylerMSFT", + "build/**.yml": "TylerMSFT", + "build-insights/**.md": "TylerMSFT", + "build-insights/**.yml": "TylerMSFT", + "c-language/**.md": "TylerMSFT", + "c-language/**.yml": "TylerMSFT", + "c-runtime-library/**.md": "TylerMSFT", + "c-runtime-library/**.yml": "TylerMSFT", + "cloud/**.md": "TylerMSFT", + "cloud/**.yml": "TylerMSFT", + "code-quality/**.md": "TylerMSFT", + "code-quality/**.yml": "TylerMSFT", + "cpp/**.md": "TylerMSFT", + "cpp/**.yml": "TylerMSFT", + "cppcx/**.md": "TylerMSFT", + "cppcx/**.yml": "TylerMSFT", + "cross-platform/**.md": "TylerMSFT", + "cross-platform/**.yml": "TylerMSFT", + "data/**.md": "TylerMSFT", + "data/**.yml": "TylerMSFT", + "dotnet/**.md": "TylerMSFT", + "dotnet/**.yml": "TylerMSFT", + "error-messages/**.md": "TylerMSFT", + "error-messages/**.yml": "TylerMSFT", + "extensions/**.md": "TylerMSFT", + "extensions/**.yml": "TylerMSFT", + "get-started/**.md": "TylerMSFT", + "get-started/**.yml": "TylerMSFT", + "ide/**.md": "TylerMSFT", + "ide/**.yml": "TylerMSFT", + "intrinsics/**.md": "TylerMSFT", + "intrinsics/**.yml": "TylerMSFT", + "linux/**.md": "TylerMSFT", + "linux/**.yml": "TylerMSFT", + "mfc/**.md": "TylerMSFT", + "mfc/**.yml": "TylerMSFT", + "overview/**.md": "TylerMSFT", + "overview/**.yml": "TylerMSFT", + "parallel/**.md": "TylerMSFT", + "parallel/**.yml": "TylerMSFT", + "porting/**.md": "TylerMSFT", + "porting/**.yml": "TylerMSFT", + "preprocessor/**.md": "TylerMSFT", + "preprocessor/**.yml": "TylerMSFT", + "safeint/**.md": "TylerMSFT", + "safeint/**.yml": "TylerMSFT", + "sanitizers/**.md": "TylerMSFT", + "sanitizers/**.yml": "TylerMSFT", + "security/**.md": "TylerMSFT", + "security/**.yml": "TylerMSFT", + "standard-library/**.md": "TylerMSFT", + "standard-library/**.yml": "TylerMSFT", + "text/**.md": "TylerMSFT", + "text/**.yml": "TylerMSFT", + "windows/**.md": "TylerMSFT", + "windows/**.yml": "TylerMSFT" }, "ms.author": { "index.md": "twhitney", "assembler/**.md": "twhitney", + "assembler/**.yml": "twhitney", "atl/**.md": "twhitney", + "atl/**.yml": "twhitney", "atl-mfc-shared/**.md": "twhitney", + "atl-mfc-shared/**.yml": "twhitney", "attributes/**.md": "twhitney", + "attributes/**.yml": "twhitney", "build/**.md": "twhitney", - "build-insights/**.md": "kevca", + "build/**.yml": "twhitney", + "build-insights/**.md": "twhitney", + "build-insights/**.yml": "twhitney", "c-language/**.md": "twhitney", + "c-language/**.yml": "twhitney", "c-runtime-library/**.md": "twhitney", + "c-runtime-library/**.yml": "twhitney", "cloud/**.md": "twhitney", + "cloud/**.yml": "twhitney", "code-quality/**.md": "twhitney", + "code-quality/**.yml": "twhitney", "cpp/**.md": "twhitney", + "cpp/**.yml": "twhitney", "cppcx/**.md": "twhitney", + "cppcx/**.yml": "twhitney", "cross-platform/**.md": "twhitney", + "cross-platform/**.yml": "twhitney", "data/**.md": "twhitney", + "data/**.yml": "twhitney", "dotnet/**.md": "twhitney", + "dotnet/**.yml": "twhitney", "error-messages/**.md": "twhitney", + "error-messages/**.yml": "twhitney", "extensions/**.md": "twhitney", + "extensions/**.yml": "twhitney", "get-started/**.md": "twhitney", + "get-started/**.yml": "twhitney", "ide/**.md": "twhitney", + "ide/**.yml": "twhitney", "intrinsics/**.md": "twhitney", + "intrinsics/**.yml": "twhitney", "linux/**.md": "twhitney", + "linux/**.yml": "twhitney", "mfc/**.md": "twhitney", + "mfc/**.yml": "twhitney", "overview/**.md": "twhitney", - "parallel/amp/**.md": "twhitney", - "parallel/concrt/**.md": "twhitney", + "overview/**.yml": "twhitney", "parallel/**.md": "twhitney", + "parallel/**.yml": "twhitney", "porting/**.md": "twhitney", + "porting/**.yml": "twhitney", "preprocessor/**.md": "twhitney", + "preprocessor/**.yml": "twhitney", "safeint/**.md": "twhitney", + "safeint/**.yml": "twhitney", "sanitizers/**.md": "twhitney", + "sanitizers/**.yml": "twhitney", "security/**.md": "twhitney", + "security/**.yml": "twhitney", "standard-library/**.md": "twhitney", + "standard-library/**.yml": "twhitney", "text/**.md": "twhitney", - "windows/**.md": "twhitney" + "text/**.yml": "twhitney", + "windows/**.md": "twhitney", + "windows/**.yml": "twhitney" } }, "template": [], diff --git a/docs/dotnet/auto-gcroot-class.md b/docs/dotnet/auto-gcroot-class.md index 00b3976e160..0998fb94764 100644 --- a/docs/dotnet/auto-gcroot-class.md +++ b/docs/dotnet/auto-gcroot-class.md @@ -1,11 +1,10 @@ --- -description: "Learn more about: auto_gcroot Class" title: "auto_gcroot Class" -ms.date: "01/16/2019" +description: "Learn more about: auto_gcroot Class" +ms.date: 01/16/2019 ms.topic: "reference" f1_keywords: ["msclr::auto_gcroot::auto_gcroot", "msclr::auto_gcroot::attach", "msclr::auto_gcroot::get", "msclr::auto_gcroot::release", "msclr::auto_gcroot::reset", "msclr::auto_gcroot::swap", "msclr::auto_gcroot::operator=", "msclr::auto_gcroot::operator->", "msclr::auto_gcroot::operator!", "msclr::auto_gcroot::operator auto_gcroot"] helpviewer_keywords: ["msclr::auto_gcroot"] -ms.assetid: b5790912-265d-463e-a486-47302e91042a --- # auto_gcroot Class @@ -20,7 +19,7 @@ class auto_gcroot; ### Parameters -*_element_type*
+*_element_type*\ The managed type to be embedded. ## Members @@ -30,8 +29,7 @@ The managed type to be embedded. |Name|Description| |---------|-----------| |[auto_gcroot::auto_gcroot](#auto-gcroot)|The `auto_gcroot` constructor.| -|[auto_gcroot::~auto_gcroot](#tilde-auto-gcroot)|The `auto_gcroot` destructor. -| +|[auto_gcroot::~auto_gcroot](#tilde-auto-gcroot)|The `auto_gcroot` destructor.| ### Public methods @@ -49,8 +47,8 @@ The managed type to be embedded. |---------|-----------| |[`auto_gcroot::operator->`](#operator-arrow)|The member access operator.| |[auto_gcroot::operator=](#operator-assign)|Assignment operator.| -|[auto_gcroot::operator auto_gcroot](#operator-auto-gcroot)|Type-cast operator between `auto_gcroot` and compatible types.| -|[auto_gcroot::operator bool](#operator-bool)|Operator for using `auto_gcroot` in a conditional expression.| +|[auto_gcroot::operator auto_gcroot](#operator-auto-gcroot)|Type-cast operator between `auto_gcroot` and compatible types.| +|[auto_gcroot::operator bool](#operator-bool)|Operator for using `auto_gcroot` in a conditional expression.| |[auto_gcroot::operator!](#operator-logical-not)|Operator for using `auto_gcroot` in a conditional expression.| ## Requirements @@ -78,10 +76,10 @@ auto_gcroot( ### Parameters -*_ptr*
+*_ptr*\ The object to own. -*_right*
+*_right*\ An existing `auto_gcroot`. ### Remarks @@ -241,7 +239,7 @@ auto_gcroot<_element_type> & attach( ### Parameters -*_right*
+*_right*\ The object to attach, or an `auto_gcroot` containing the object to attach. ### Return value @@ -452,7 +450,7 @@ void reset( ### Parameters -*_new_ptr*
+*_new_ptr*\ (Optional) The new object. ### Example @@ -517,7 +515,7 @@ void swap( ### Parameters -*_right*
+*_right*\ The `auto_gcroot` with which to swap objects. ### Example @@ -615,7 +613,7 @@ auto_gcroot<_element_type> & operator=( ### Parameters -*_right*
+*_right*\ The object or `auto_gcroot` to be assigned to the current `auto_gcroot`. ### Return value diff --git a/docs/dotnet/auto-handle-class.md b/docs/dotnet/auto-handle-class.md index cf238bd76d9..8363250a9a4 100644 --- a/docs/dotnet/auto-handle-class.md +++ b/docs/dotnet/auto-handle-class.md @@ -1,11 +1,10 @@ --- -description: "Learn more about: auto_handle Class" title: "auto_handle Class" -ms.date: "01/16/2019" +description: "Learn more about: auto_handle Class" +ms.date: 01/16/2019 ms.topic: "reference" f1_keywords: ["msclr::auto_handle::auto_handle", "msclr::auto_handle::get", "msclr::auto_handle::release", "msclr::auto_handle::reset", "msclr::auto_handle::swap", "msclr::auto_handle::operator->", "msclr::auto_handle::operator=", "msclr::auto_handle::operator auto_handle", "msclr::auto_handle::operator!"] helpviewer_keywords: ["msclr::auto_handle class"] -ms.assetid: a65604d1-ecbb-44fd-ae2f-696ddeeed9d6 --- # auto_handle Class @@ -25,14 +24,14 @@ The managed type to be embedded. ## Members -### Public constructors +### Public constructors |Name|Description| |---------|-----------| |[auto_handle::auto_handle](#auto-handle)|The `auto_handle` constructor.| |[auto_handle::~auto_handle](#tilde-auto-handle)|The `auto_handle` destructor.| -### Public methods +### Public methods |Name|Description| |---------|-----------| diff --git a/docs/dotnet/avoiding-exceptions-on-clr-shutdown-when-consuming-com-objects-built-with-clr.md b/docs/dotnet/avoiding-exceptions-on-clr-shutdown-when-consuming-com-objects-built-with-clr.md index 3959e713c67..bc10b85fb92 100644 --- a/docs/dotnet/avoiding-exceptions-on-clr-shutdown-when-consuming-com-objects-built-with-clr.md +++ b/docs/dotnet/avoiding-exceptions-on-clr-shutdown-when-consuming-com-objects-built-with-clr.md @@ -4,6 +4,7 @@ title: "Avoiding Exceptions thrown by COM Objects Built with -clr" ms.date: "11/04/2016" helpviewer_keywords: ["interop [C++], CLR shutdown exceptions", "/clr compiler option [C++], CLR shutdown exceptions", "mixed assemblies [C++], CLR shutdown exceptions", "/clr compiler option [C++], COM objects", "interoperability [C++], CLR shutdown exceptions", "CLR shutdown exceptions [C++]"] ms.assetid: 41249d83-4b51-4e46-866f-27f475f2498c +ms.topic: concept-article --- # Avoiding Exceptions on CLR Shutdown When Consuming COM Objects Built with /clr diff --git a/docs/dotnet/boxing-cpp-cli.md b/docs/dotnet/boxing-cpp-cli.md index e012f8806eb..f57d3ad8922 100644 --- a/docs/dotnet/boxing-cpp-cli.md +++ b/docs/dotnet/boxing-cpp-cli.md @@ -3,6 +3,7 @@ description: "Learn more about: Boxing (C++/CLI)" title: "Boxing (C++/CLI)" ms.date: "11/04/2016" ms.assetid: f4ee27a8-6a34-432d-b9ec-39285d513b23 +ms.topic: concept-article --- # Boxing (C++/CLI) diff --git a/docs/dotnet/calling-native-functions-from-managed-code.md b/docs/dotnet/calling-native-functions-from-managed-code.md index fd914a432a2..78930676f74 100644 --- a/docs/dotnet/calling-native-functions-from-managed-code.md +++ b/docs/dotnet/calling-native-functions-from-managed-code.md @@ -4,6 +4,7 @@ title: "Calling Native Functions from Managed Code" ms.date: "11/04/2016" helpviewer_keywords: ["native functions called from managed code [C++]", "managed code [C++], interoperability", "platform invoke [C++], interoperability", "interoperabiliy [C++], calling native functions from managed code", "calling native functions from managed code", "interop [C++], calling native functions from managed code"] ms.assetid: 982cef18-20d9-42b4-8242-a77fa65f2e36 +ms.topic: concept-article --- # Calling Native Functions from Managed Code diff --git a/docs/dotnet/com-ptr-class.md b/docs/dotnet/com-ptr-class.md index 047e3491791..e72c3f8d9e0 100644 --- a/docs/dotnet/com-ptr-class.md +++ b/docs/dotnet/com-ptr-class.md @@ -1,11 +1,10 @@ --- -description: "Learn more about: com::ptr Class" title: "com::ptr Class" -ms.date: "01/16/2019" +description: "Learn more about: com::ptr Class" +ms.date: 01/16/2019 ms.topic: "reference" f1_keywords: ["msclr::com::ptr::ptr", "msclr::com::ptr::Attach", "msclr::com::ptr::CreateInstance", "msclr::com::ptr::Detach", "msclr::com::ptr::GetInterface", "msclr::com::ptr::QueryInterface", "msclr::com::ptr::Release", "msclr::com::ptr::operator=", "msclr::com::ptr::operator->", "msclr::com::ptr::operator!"] helpviewer_keywords: ["msclr::ptr class"] -ms.assetid: 0144d0e4-919c-45f9-a3f8-fbc9edba32bf --- # com::ptr Class @@ -173,7 +172,7 @@ int main() { |---------|-----------| |[`ptr::operator->`](#operator-arrow)|Member access operator, used to call methods on the owned COM object.| |[ptr::operator=](#operator-assign)|Attaches a COM object to a `com::ptr`.| -|[ptr::operator bool](#operator-bool)|Operator for using `com::ptr` in a conditional expression.| +|[ptr::operator bool](#operator-bool)|Operator for using `com::ptr` in a conditional expression.| |[ptr::operator!](#operator-logical-not)|Operator to determine if the owned COM object is invalid.| ## Requirements diff --git a/docs/dotnet/converting-projects-from-mixed-mode-to-pure-intermediate-language.md b/docs/dotnet/converting-projects-from-mixed-mode-to-pure-intermediate-language.md index e035e617f92..4f62d8f01c8 100644 --- a/docs/dotnet/converting-projects-from-mixed-mode-to-pure-intermediate-language.md +++ b/docs/dotnet/converting-projects-from-mixed-mode-to-pure-intermediate-language.md @@ -3,6 +3,7 @@ description: "Learn more about: Converting projects from mixed mode to pure inte title: "Converting projects from mixed mode to pure intermediate language" ms.date: 04/15/2021 helpviewer_keywords: ["intermediate language, mixed-mode applications", "mixed-mode applications", "mixed-mode applications, intermediate language", "projects [C++], converting to intermediate language"] +ms.topic: how-to --- # Converting projects from mixed mode to pure intermediate language diff --git a/docs/dotnet/create-a-partially-trusted-application.md b/docs/dotnet/create-a-partially-trusted-application.md index 5e0a343494b..9d24f2ea685 100644 --- a/docs/dotnet/create-a-partially-trusted-application.md +++ b/docs/dotnet/create-a-partially-trusted-application.md @@ -5,6 +5,7 @@ ms.custom: "get-started-article" ms.date: "11/04/2016" helpviewer_keywords: ["partially trusted applications [C++]", "mixed assemblies [C++], partially trusted applications", "msvcm90[d].dll", "interoperability [C++], partially trusted applications", "interop [C++], partially trusted applications", "/clr compiler option [C++], partially trusted applications"] ms.assetid: 4760cd0c-4227-4f23-a7fb-d25b51bf246e +ms.topic: how-to --- # How to: Create a Partially Trusted Application by Removing Dependency on the CRT Library DLL diff --git a/docs/dotnet/data-access-using-adonet-cpp-cli.md b/docs/dotnet/data-access-using-adonet-cpp-cli.md index 73c3d4e6c82..69724de4d57 100644 --- a/docs/dotnet/data-access-using-adonet-cpp-cli.md +++ b/docs/dotnet/data-access-using-adonet-cpp-cli.md @@ -1,9 +1,8 @@ --- -description: "Learn more about: Data Access Using ADO.NET (C++/CLI)" title: "Data Access Using ADO.NET (C++/CLI)" +description: "Learn more about: Data Access Using ADO.NET (C++/CLI)" ms.date: "11/04/2016" helpviewer_keywords: ["ADO.NET [C++]", ".NET Framework [C++], data access", "databases [C++], accessing in C++", "data access [C++], ADO.NET", "data [C++], ADO.NET", "native strings [C++]", "ADO.NET [C++], marshaling ANSI strings", "strings [C++], ADO.NET", "BSTRs, strings", "ADO.NET [C++], marshaling BSTR strings", "strings [C++], marshaling BSTR strings", "ADO.NET [C++], marshaling Unicode strings", "Unicode [C++], strings", "strings [C++], Unicode", "VARIANT, marshaling", "ADO.NET [C++], marshaling VARIANT types", "VARIANT", "SAFEARRAY, marshaling", "ADO.NET [C++], marshaling SAFEARRAY types"] -ms.assetid: b0cd987d-1ea7-4f76-ba01-cbd52503d06d --- # Data Access Using ADO.NET (C++/CLI) @@ -152,7 +151,7 @@ The rest of the code in this example is native C++ code, as is indicated by the > [!NOTE] > The memory allocated by must be deallocated by calling either or `SysFreeString`. -``` cpp +```cpp // adonet_marshal_string_bstr.cpp // compile with: /clr /FU System.dll /FU System.Data.dll /FU System.Xml.dll #include diff --git a/docs/dotnet/debug-class-cpp-cli.md b/docs/dotnet/debug-class-cpp-cli.md index f4f8da1750b..5230757827e 100644 --- a/docs/dotnet/debug-class-cpp-cli.md +++ b/docs/dotnet/debug-class-cpp-cli.md @@ -4,6 +4,7 @@ title: "Debug Class (C++/CLI)" ms.date: "11/04/2016" helpviewer_keywords: ["Trace class, Visual C++", ".NET Framework [C++], Debug class", "Debug class"] ms.assetid: 076bd528-1b6f-4e8a-a372-eb5849cf969a +ms.topic: how-to --- # Debug Class (C++/CLI) diff --git a/docs/dotnet/deque-stl-clr.md b/docs/dotnet/deque-stl-clr.md index b7e7be166a5..8a4ef045094 100644 --- a/docs/dotnet/deque-stl-clr.md +++ b/docs/dotnet/deque-stl-clr.md @@ -1,11 +1,10 @@ --- -description: "Learn more about: deque (STL/CLR)" title: "deque (STL/CLR)" -ms.date: "11/04/2016" +description: "Learn more about: deque (STL/CLR)" +ms.date: 11/04/2016 ms.topic: "reference" f1_keywords: ["cliext::deque", "cliext::deque::assign", "cliext::deque::at", "cliext::deque::back", "cliext::deque::back_item", "cliext::deque::begin", "cliext::deque::clear", "cliext::deque::const_iterator", "cliext::deque::const_reference", "cliext::deque::const_reverse_iterator", "cliext::deque::deque", "cliext::deque::difference_type", "cliext::deque::empty", "cliext::deque::end", "cliext::deque::erase", "cliext::deque::front", "cliext::deque::front_item", "cliext::deque::generic_container", "cliext::deque::generic_iterator", "cliext::deque::generic_reverse_iterator", "cliext::deque::generic_value", "cliext::deque::insert", "cliext::deque::iterator", "cliext::deque::operator!=", "cliext::deque::operator[]", "cliext::deque::pop_back", "cliext::deque::pop_front", "cliext::deque::push_back", "cliext::deque::push_front", "cliext::deque::rbegin", "cliext::deque::reference", "cliext::deque::rend", "cliext::deque::resize", "cliext::deque::reverse_iterator", "cliext::deque::size", "cliext::deque::size_type", "cliext::deque::swap", "cliext::deque::to_array", "cliext::deque::value_type", "cliext::deque::operator<", "cliext::deque::operator<=", "cliext::deque::operator=", "cliext::deque::operator==", "cliext::deque::operator>", "cliext::deque::operator>="] helpviewer_keywords: ["deque class [STL/CLR]", " header [STL/CLR]", " header [STL/CLR]", "assign member [STL/CLR]", "assign member [STL/CLR]", "at member [STL/CLR]", "back member [STL/CLR]", "back_item member [STL/CLR]", "begin member [STL/CLR]", "clear member [STL/CLR]", "const_iterator member [STL/CLR]", "const_reference member [STL/CLR]", "const_reverse_iterator member [STL/CLR]", "deque member [STL/CLR]", "difference_type member [STL/CLR]", "empty member [STL/CLR]", "end member [STL/CLR]", "erase member [STL/CLR]", "front member [STL/CLR]", "front_item member [STL/CLR]", "generic_container member [STL/CLR]", "generic_iterator member [STL/CLR]", "generic_reverse_iterator member [STL/CLR]", "generic_value member [STL/CLR]", "insert member [STL/CLR]", "iterator member [STL/CLR]", "operator!= member [STL/CLR]", "operator member [] [STL/CLR]", "pop_back member [STL/CLR]", "pop_front member [STL/CLR]", "push_back member [STL/CLR]", "push_front member [STL/CLR]", "rbegin member [STL/CLR]", "reference member [STL/CLR]", "rend member [STL/CLR]", "resize member [STL/CLR]", "reverse_iterator member [STL/CLR]", "size member [STL/CLR]", "size_type member [STL/CLR]", "swap member [STL/CLR]", "to_array member [STL/CLR]", "value_type member [STL/CLR]", "operator< member [STL/CLR]", "operator<= member [STL/CLR]", "operator= member [STL/CLR]", "operator== member [STL/CLR]", "operator> member [STL/CLR]", "operator>= member [STL/CLR]"] -ms.assetid: dd669da3-3c0e-45e9-8596-f6b483720941 --- # deque (STL/CLR) @@ -561,7 +560,7 @@ a b c ## deque::const_reverse_iterator (STL/CLR) -The type of a constant reverse iterator for the controlled sequence.. +The type of a constant reverse iterator for the controlled sequence. ### Syntax @@ -1568,7 +1567,7 @@ Position of element to access. ### Remarks -The member operator returns a referene to the element at position *pos*. You use it to access an element whose position you know. +The member operator returns a reference to the element at position *pos*. You use it to access an element whose position you know. ### Example diff --git a/docs/dotnet/dotnet-programming-with-cpp-cli-visual-cpp.md b/docs/dotnet/dotnet-programming-with-cpp-cli-visual-cpp.md index 2109d30acee..359bef6d31e 100644 --- a/docs/dotnet/dotnet-programming-with-cpp-cli-visual-cpp.md +++ b/docs/dotnet/dotnet-programming-with-cpp-cli-visual-cpp.md @@ -1,11 +1,22 @@ --- title: ".NET programming with C++/CLI" description: "Learn how to use C++/CLI to create .NET apps and components in Visual Studio." -ms.date: 10/28/2021 +ms.date: 05/02/2025 helpviewer_keywords: ["programming [C++], .NET programming", ".NET Framework [C++]", ".NET applications [C++]", "Visual C++, .NET programming"] --- # .NET programming with C++/CLI +> [!IMPORTANT] +> C++/CLI is a technology designed during the early years of .NET (2003–2010) and remains supported for compatibility purposes. It's best suited for existing codebases, particularly those being brought forward from .NET Framework to .NET Core, or for maintaining large legacy systems that are unlikely to evolve beyond .NET Framework. +> +> While C++/CLI is reliable and robust, no new feature work is planned beyond what's necessary to ensure continued functionality. Developers should be aware that using C++/CLI pessimizes both C++ and .NET languages, as it's constrained by the language features and APIs available at the time of its design—that is, prior to ISO C++11 and .NET Core. C++/CLI was designed based on C++98, and its [ECMA standard](https://ecma-international.org/publications-and-standards/standards/ecma-372) hasn't been updated to keep up with newer C++ standards since C++11. While some features in C++11 were incorporated, many features from more recent standards, like C++20 and C++23, have no direct support in C++/CLI for compilation to managed code. For more information, see [C++20 Support Comes To C++/CLI](https://devblogs.microsoft.com/cppblog/cpp20-support-comes-to-cpp-cli/). +> +> For new projects, we recommend exploring modern third-party alternatives such as or , which offer more flexibility and better alignment with current language and runtime capabilities. + +C++/CLI supplanted Managed C++. C++/CLI is a language specification created by Microsoft that extends C++ to support .NET. It's only supported on Windows. It's not for writing [WinUI](/windows/apps/winui) or Universal Windows Platform [UWP](/windows/uwp/get-started/universal-application-platform-guide) Windows Runtime (WinRT) apps. It's for writing .NET applications and components that run on .NET. C++/CLI is a bridge between native C++ code and managed code. It allows you to use existing C++ libraries in .NET applications and to write new .NET applications in C++. + +Microsoft provides C++/WinRT for writing WinUI and WinRT apps. It's an entirely standard modern C++17 language projection for Windows Runtime (WinRT) APIs. For more information about using C++ with the Windows Runtime (WinRT), see [C++/WinRT](/windows/uwp/cpp-and-winrt-apis/). + ::: moniker range="msvc-140" By default, CLR projects created with Visual Studio 2015 target .NET Framework 4.5.2. You can target .NET Framework 4.6 when you create a new project. In the **New Project** dialog, change the target framework in the dropdown at the top middle of the dialog. To change the target framework for an existing project, close the project, edit the project file (*`.vcxproj`*), and change the value of the Target Framework Version to 4.6. The changes take effect the next time you open the project. @@ -41,40 +52,23 @@ C++/CLI itself isn't installed by default when you install a Visual Studio C++ w ## In this section -[C++/CLI tasks](../dotnet/cpp-cli-tasks.md) - -[Native and .NET interoperability](../dotnet/native-and-dotnet-interoperability.md) - -[Pure and verifiable code (C++/CLI)](../dotnet/pure-and-verifiable-code-cpp-cli.md) - -[Regular expressions (C++/CLI)](../dotnet/regular-expressions-cpp-cli.md) - -[File handling and I/O (C++/CLI)](../dotnet/file-handling-and-i-o-cpp-cli.md) - -[Graphics operations (C++/CLI)](../dotnet/graphics-operations-cpp-cli.md) - -[Windows operations (C++/CLI)](../dotnet/windows-operations-cpp-cli.md) - -[Data access using ADO.NET (C++/CLI)](../dotnet/data-access-using-adonet-cpp-cli.md) - -[Interoperability with other .NET languages (C++/CLI)](../dotnet/interoperability-with-other-dotnet-languages-cpp-cli.md) - -[Serialization (C++/CLI)](../dotnet/serialization-cpp-cli.md) - -[Managed types (C++/CLI)](../dotnet/managed-types-cpp-cli.md) - -[Reflection (C++/CLI)](../dotnet/reflection-cpp-cli.md) - -[Strong Name assemblies (assembly signing) (C++/CLI)](../dotnet/strong-name-assemblies-assembly-signing-cpp-cli.md) - -[Debug class (C++/CLI)](../dotnet/debug-class-cpp-cli.md) - -[STL/CLR library reference](../dotnet/stl-clr-library-reference.md) - -[C++ support library](../dotnet/cpp-support-library.md) - -[Exceptions in C++/CLI](../dotnet/exceptions-in-cpp-cli.md) - +[C++/CLI tasks](../dotnet/cpp-cli-tasks.md)\ +[Native and .NET interoperability](../dotnet/native-and-dotnet-interoperability.md)\ +[Pure and verifiable code (C++/CLI)](../dotnet/pure-and-verifiable-code-cpp-cli.md)\ +[Regular expressions (C++/CLI)](../dotnet/regular-expressions-cpp-cli.md)\ +[File handling and I/O (C++/CLI)](../dotnet/file-handling-and-i-o-cpp-cli.md)\ +[Graphics operations (C++/CLI)](../dotnet/graphics-operations-cpp-cli.md)\ +[Windows operations (C++/CLI)](../dotnet/windows-operations-cpp-cli.md)\ +[Data access using ADO.NET (C++/CLI)](../dotnet/data-access-using-adonet-cpp-cli.md)\ +[Interoperability with other .NET languages (C++/CLI)](../dotnet/interoperability-with-other-dotnet-languages-cpp-cli.md)\ +[Serialization (C++/CLI)](../dotnet/serialization-cpp-cli.md)\ +[Managed types (C++/CLI)](../dotnet/managed-types-cpp-cli.md)\ +[Reflection (C++/CLI)](../dotnet/reflection-cpp-cli.md)\ +[Strong Name assemblies (assembly signing) (C++/CLI)](../dotnet/strong-name-assemblies-assembly-signing-cpp-cli.md)\ +[Debug class (C++/CLI)](../dotnet/debug-class-cpp-cli.md)\ +[STL/CLR library reference](../dotnet/stl-clr-library-reference.md)\ +[C++ support library](../dotnet/cpp-support-library.md)\ +[Exceptions in C++/CLI](../dotnet/exceptions-in-cpp-cli.md)\ [Boxing (C++/CLI)](../dotnet/boxing-cpp-cli.md) ## See also diff --git a/docs/dotnet/double-thunking-cpp.md b/docs/dotnet/double-thunking-cpp.md index f8b13c40ff2..345eb179e61 100644 --- a/docs/dotnet/double-thunking-cpp.md +++ b/docs/dotnet/double-thunking-cpp.md @@ -1,9 +1,9 @@ --- -description: "Learn more about: Double Thunking (C++)" title: "Double Thunking (C++)" -ms.date: "11/04/2016" +description: "Learn more about: Double Thunking (C++)" +ms.date: 11/04/2016 helpviewer_keywords: ["double thunks", "interop [C++], double thunking", "mixed assemblies [C++], double thunking", "/clr compiler option [C++], double thunking", "interoperability [C++], double thunking"] -ms.assetid: a85090b2-dc3c-498a-b40c-340db229dd6f +ms.topic: how-to --- # Double Thunking (C++) @@ -51,7 +51,7 @@ struct T { }; struct S { - virtual void /* __clrcall */ f(T t) {}; + virtual void /* __clrcall */ f(T t) {} } s; int main() { @@ -100,7 +100,7 @@ struct T { }; struct S { - virtual void /* __clrcall */ f(T t) {}; + virtual void /* __clrcall */ f(T t) {} } s; int main() { diff --git a/docs/dotnet/file-handling-and-i-o-cpp-cli.md b/docs/dotnet/file-handling-and-i-o-cpp-cli.md index dba79da1ef8..b19777bddd1 100644 --- a/docs/dotnet/file-handling-and-i-o-cpp-cli.md +++ b/docs/dotnet/file-handling-and-i-o-cpp-cli.md @@ -4,6 +4,7 @@ title: "File Handling and I-O (C++/CLI)" ms.date: "11/04/2016" helpviewer_keywords: [".NET Framework [C++], file handling", "files [C++], .NET Framework and", "I/O [C++], .NET Framework applications", ".NET Framework [C++], I/O", "files [C++], listing files", "directories [C++], listing files", "monitoring file system events", "FileSystemWatcher class, examples", "examples [C++], monitoring file system changes", "events [C++], monitoring", "file system events [C++]", "files [C++], binary", "binary files, reading in C++", "reading text files", "text files, reading", "files [C++], retrieving information about", "FileInfo class", "binary files, writing in C++", "files [C++], binary", "files [C++], text", "text files, writing in C++"] ms.assetid: 3296fd59-a83a-40d4-bd4a-6096cc13101b +ms.topic: how-to --- # File Handling and I/O (C++/CLI) diff --git a/docs/dotnet/functional-stl-clr.md b/docs/dotnet/functional-stl-clr.md index fcb52b4c315..a47621cd29a 100644 --- a/docs/dotnet/functional-stl-clr.md +++ b/docs/dotnet/functional-stl-clr.md @@ -1,11 +1,10 @@ --- -description: "Learn more about: functional (STL/CLR)" title: "functional (STL/CLR)" +description: "Learn more about: functional (STL/CLR)" ms.date: 09/28/2022 ms.topic: "reference" f1_keywords: ["", "cliext::binary_delegate", "cliext::binary_delegate_noreturn", "cliext::binary_negate", "cliext::bind1st", "cliext::bind2nd", "cliext::binder1st", "cliext::binder2nd", "cliext::divides", "cliext::equal_to", "cliext::greater", "cliext::greater_equal", "cliext::less", "cliext::less_equal", "cliext::logical_and", "cliext::logical_not", "cliext::logical_or", "cliext::minus", "cliext::modulus", "cliext::multiplies", "cliext::negate", "cliext::not_equal_to", "cliext::not1", "cliext::not2", "cliext::plus", "cliext::unary_delegate", "cliext::unary_delegate_noreturn", "cliext::unary_negate"] helpviewer_keywords: [" header [STL/CLR]", " header [STL/CLR]", "functional functions [STL/CLR]", "binary_delegate function [STL/CLR]", "binary_delegate_noreturn function [STL/CLR]", "binary_negate function [STL/CLR]", "bind1st function [STL/CLR]", "bind2nd function [STL/CLR]", "binder1st function [STL/CLR]", "binder2nd function [STL/CLR]", "divides function [STL/CLR]", "equal_to function [STL/CLR]", "greater function [STL/CLR]", "greater_equal function [STL/CLR]", "less function [STL/CLR]", "less_equal function [STL/CLR]", "logical_and function [STL/CLR]", "logical_not function [STL/CLR]", "logical_or function [STL/CLR]", "minus function [STL/CLR]", "modulus function [STL/CLR]", "multiplies function [STL/CLR]", "negate function [STL/CLR]", "not_equal_to function [STL/CLR]", "not1 function [STL/CLR]", "not2 function [STL/CLR]", "plus function [STL/CLR]", "unary_delegate function [STL/CLR]", "unary_delegate_noreturn function [STL/CLR]", "unary_negate function [STL/CLR]"] -ms.assetid: 88738b8c-5d37-4375-970e-a4442bf5efde --- # `functional` (STL/CLR) @@ -499,7 +498,7 @@ public: typedef Fun stored_function_type; typedef typename Fun::first_argument_type first_argument_type; typedef typename Fun::second_argument_type second_argument_type; - typedef typename Fun:result_type result_type; + typedef typename Fun::result_type result_type; typedef Microsoft::VisualC::StlClr::UnaryDelegate< second_argument_type, result_type> delegate_type; @@ -604,7 +603,7 @@ public: typedef Fun stored_function_type; typedef typename Fun::first_argument_type first_argument_type; typedef typename Fun::second_argument_type second_argument_type; - typedef typename Fun:result_type result_type; + typedef typename Fun::result_type result_type; typedef Microsoft::VisualC::StlClr::UnaryDelegate< first_argument_type, result_type> delegate_type; diff --git a/docs/dotnet/hosting-a-windows-form-user-control-as-an-mfc-dialog-box.md b/docs/dotnet/hosting-a-windows-form-user-control-as-an-mfc-dialog-box.md index 14d59ab612a..8c35fc41ed9 100644 --- a/docs/dotnet/hosting-a-windows-form-user-control-as-an-mfc-dialog-box.md +++ b/docs/dotnet/hosting-a-windows-form-user-control-as-an-mfc-dialog-box.md @@ -1,15 +1,15 @@ --- -description: "Learn more about: Hosting a Windows Form User Control as an MFC Dialog Box" title: "Hosting a Windows Form User Control as an MFC Dialog Box" -ms.date: "11/04/2016" +description: "Learn more about: Hosting a Windows Form User Control as an MFC Dialog Box" +ms.date: 11/04/2016 helpviewer_keywords: ["MFC [C++], Windows Forms support", "Windows Forms [C++], hosting as MFC Dialog", "hosting Windows Forms control [C++]"] -ms.assetid: 0434a9d7-8b14-48e6-ad69-9ba9a684677a +ms.topic: how-to --- # Hosting a Windows Form User Control as an MFC Dialog Box -MFC provides the template class [CWinFormsDialog](../mfc/reference/cwinformsdialog-class.md) so that you can host a Windows Forms user control () in a modal or modeless MFC dialog box. `CWinFormsDialog` is derived from the MFC class [CDialog](../mfc/reference/cdialog-class.md), so the dialog box can be launched as modal or modeless. +MFC provides the template class [`CWinFormsDialog`](../mfc/reference/cwinformsdialog-class.md) so that you can host a Windows Forms user control () in a modal or modeless MFC dialog box. `CWinFormsDialog` is derived from the MFC class [`CDialog`](../mfc/reference/cdialog-class.md), so the dialog box can be launched as modal or modeless. -The process that `CWinFormsDialog` uses to host the user control is the similar to that described in [Hosting a Windows Form User Control in an MFC Dialog Box](../dotnet/hosting-a-windows-form-user-control-in-an-mfc-dialog-box.md). However, `CWinFormsDialog` manages the initialization and hosting of the user control so that it does not have to be programmed manually. +The process that `CWinFormsDialog` uses to host the user control is similar to that described in [Hosting a Windows Form User Control in an MFC Dialog Box](hosting-a-windows-form-user-control-in-an-mfc-dialog-box.md). However, `CWinFormsDialog` manages the initialization and hosting of the user control so that it does not have to be programmed manually. ### To create the MFC host application @@ -17,7 +17,7 @@ The process that `CWinFormsDialog` uses to host the user control is the similar On the **File** menu, select **New**, and then click **Project**. In the **Visual C++** folder, select **MFC Application**. - In the **Name** box, enter `MFC03` and change the Solution setting to **Add to Solution**.Click **OK**. + In the **Name** box, enter `MFC03` and change the Solution setting to **Add to Solution**. Click **OK**. In the **MFC Application Wizard**, accept all the defaults, and then click **Finish**. This creates an MFC application with a Multiple Document Interface. @@ -29,21 +29,21 @@ The process that `CWinFormsDialog` uses to host the user control is the similar 1. Add a reference to the .NET control. - In **Solution Explorer**, right-click the **MFC03** project node and choose **Add**, **References**. In the **Property Page**, click **Add New Reference**, select WindowsControlLibrary1 (under the **Projects** tab), and click **OK**. This adds a reference in the form of a [/FU](../build/reference/fu-name-forced-hash-using-file.md) compiler option so that the program will compile; it also copies WindowsControlLibrary1.dll into the `MFC03` project directory so that the program will run. + In **Solution Explorer**, right-click the **MFC03** project node and choose **Add**, **References**. In the **Property Page**, click **Add New Reference**, select WindowsControlLibrary1 (under the **Projects** tab), and click **OK**. This adds a reference in the form of a [`/FU`](../build/reference/fu-name-forced-hash-using-file.md) compiler option so that the program will compile; it also copies `WindowsControlLibrary1.dll` into the `MFC03` project directory so that the program will run. 1. Add `#include ` to *pch.h* (*stdafx.h* in Visual Studio 2017 and earlier), at the end of the existing `#include` statements. 1. Add a new class that subclasses `CDialog`. - Right click on project name and add an MFC class (called CHostForWinForm) that subclasses `CDialog`. Since you do not need the dialog box resource, you can delete the resource ID (select **Resource View**, expand the **Dialog** folder and delete `IDD_HOSTFORWINFORM` resource. Then, remove any references to the ID in code.). + Right click on project name and add an MFC class (called `CHostForWinForm`) that subclasses `CDialog`. Since you do not need the dialog box resource, you can delete the resource ID (select **Resource View**, expand the **Dialog** folder and delete `IDD_HOSTFORWINFORM` resource. Then, remove any references to the ID in code.). -1. Replace `CDialog` in CHostForWinForm.h and CHostForWinForm.cpp files with `CWinFormsDialog`. +1. Replace `CDialog` in `CHostForWinForm.h` and `CHostForWinForm.cpp` files with `CWinFormsDialog`. -1. Call DoModal on the CHostForWinForm class. +1. Call `DoModal` on the `CHostForWinForm` class. - In MFC03.cpp, add `#include "HostForWinForm.h"`. + In `MFC03.cpp`, add `#include "HostForWinForm.h"`. - Before the return statement in the definition of CMFC03App::InitInstance, add: + Before the return statement in the definition of `CMFC03App::InitInstance`, add: ```cpp CHostForWinForm m_HostForWinForm; @@ -58,15 +58,15 @@ The process that `CWinFormsDialog` uses to host the user control is the similar Next you will add code to monitor the state of a control on the Windows Forms from the MFC application. -1. Add a handler for OnInitDialog. +1. Add a handler for `OnInitDialog`. - Display the **Properties** window (F4). In **Class View**, select CHostForWinForm. In the **Properties** window, select overrides and in the row for OnInitDialog, click in the left hand column and select \< Add >. This adds the following line to CHostForWinForm.h: + Display the **Properties** window (F4). In **Class View**, select `CHostForWinForm`. In the **Properties** window, select overrides and in the row for `OnInitDialog`, click in the left hand column and select \< Add >. This adds the following line to `CHostForWinForm.h`: ```cpp virtual BOOL OnInitDialog(); ``` -1. Define OnInitDialog (in CHostForWinForm.cpp) as follows: +1. Define `OnInitDialog` (in `CHostForWinForm.cpp`) as follows: ```cpp BOOL CHostForWinForm::OnInitDialog() { @@ -76,7 +76,7 @@ The process that `CWinFormsDialog` uses to host the user control is the similar } ``` -1. Next add the OnButton1 handler. Add the following lines to the public section of the CHostForWinForm class in CHostForWinForm.h: +1. Next add the `OnButton1` handler. Add the following lines to the public section of the `CHostForWinForm` class in `CHostForWinForm.h`: ```cpp virtual void OnButton1( System::Object^ sender, System::EventArgs^ e ); @@ -86,7 +86,7 @@ The process that `CWinFormsDialog` uses to host the user control is the similar END_DELEGATE_MAP() ``` - In CHostForWinForm.cpp, add this definition: + In `CHostForWinForm.cpp`, add this definition: ```cpp void CHostForWinForm::OnButton1( System::Object^ sender, System::EventArgs^ e ) @@ -99,13 +99,13 @@ The process that `CWinFormsDialog` uses to host the user control is the similar Next you will add code to display from the MFC code the value in the text box on the Windows Form. -1. In the public section of the CHostForWinForm class in CHostForWinForm.h, add the following declaration: +1. In the public section of the `CHostForWinForm` class in `CHostForWinForm.h`, add the following declaration: ```cpp CString m_sEditBoxOnWinForm; ``` -1. In the definition of DoDataExchange in CHostForWinForm.cpp, add the following three lines to the end of the function: +1. In the definition of `DoDataExchange` in `CHostForWinForm.cpp`, add the following four lines to the end of the function: ```cpp if (pDX->m_bSaveAndValidate) @@ -114,7 +114,7 @@ The process that `CWinFormsDialog` uses to host the user control is the similar GetControl()->textBox1->Text = gcnew System::String(m_sEditBoxOnWinForm); ``` -1. In the definition of OnButton1 in CHostForWinForm.cpp, add the following three lines to the end of the function: +1. In the definition of `OnButton1` in `CHostForWinForm.cpp`, add the following three lines to the end of the function: ```cpp this->UpdateData(TRUE); @@ -126,5 +126,5 @@ The process that `CWinFormsDialog` uses to host the user control is the similar ## See also - -[Using a Windows Form User Control in MFC](../dotnet/using-a-windows-form-user-control-in-mfc.md) +\ +[Using a Windows Form User Control in MFC](using-a-windows-form-user-control-in-mfc.md) diff --git a/docs/dotnet/hosting-a-windows-form-user-control-in-an-mfc-dialog-box.md b/docs/dotnet/hosting-a-windows-form-user-control-in-an-mfc-dialog-box.md index b7b889caf1a..9244b69d983 100644 --- a/docs/dotnet/hosting-a-windows-form-user-control-in-an-mfc-dialog-box.md +++ b/docs/dotnet/hosting-a-windows-form-user-control-in-an-mfc-dialog-box.md @@ -4,6 +4,7 @@ title: "Hosting a Windows Form User Control in an MFC Dialog Box" ms.date: "11/04/2016" helpviewer_keywords: ["MFC [C++], Windows Forms support", "hosting Windows Forms control [C++]", "Windows Forms [C++], MFC support"] ms.assetid: 9f66ee52-b7cb-4ffd-8306-392a5da990d8 +ms.topic: concept-article --- # Hosting a Windows Form User Control in an MFC Dialog Box diff --git a/docs/dotnet/hosting-a-windows-forms-user-control-as-an-mfc-view.md b/docs/dotnet/hosting-a-windows-forms-user-control-as-an-mfc-view.md index e3968fb0fcd..7353bb36611 100644 --- a/docs/dotnet/hosting-a-windows-forms-user-control-as-an-mfc-view.md +++ b/docs/dotnet/hosting-a-windows-forms-user-control-as-an-mfc-view.md @@ -4,6 +4,7 @@ title: "Hosting a Windows Forms User Control as an MFC View" ms.date: "11/04/2016" helpviewer_keywords: ["MFC [C++], Windows Forms support", "Windows Forms controls [C++], hosting as an MFC view", "hosting Windows Forms control [C++]"] ms.assetid: 43c02ab4-1366-434c-a980-0b19326d6ea0 +ms.topic: concept-article --- # Hosting a Windows Forms User Control as an MFC View diff --git a/docs/dotnet/how-to-access-characters-in-a-system-string.md b/docs/dotnet/how-to-access-characters-in-a-system-string.md index 1dab0f2a63f..c16e9e87202 100644 --- a/docs/dotnet/how-to-access-characters-in-a-system-string.md +++ b/docs/dotnet/how-to-access-characters-in-a-system-string.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: How to: Access Characters in a System::String" title: "How to: Access Characters in a System::String" +description: "Learn more about: How to: Access Characters in a System::String" +ms.date: 11/04/2016 ms.custom: "get-started-article" -ms.date: "11/04/2016" helpviewer_keywords: ["characters [C++], accessing in System::String", "examples [C++], strings", "strings [C++], accessing characters"] -ms.assetid: cfc89756-aef3-4988-907e-fb236dcb7087 --- # How to: Access Characters in a System::String @@ -21,7 +20,7 @@ If you pass `ppchar` to a native function, then it must be a pinning pointer; th ```cpp // PtrToStringChars.cpp // compile with: /clr -#include +#include using namespace System; int main() { @@ -54,7 +53,7 @@ size_t getlen(System::String ^ s) { // make sure it doesn't move during the unmanaged call pin_ptr pinchars = PtrToStringChars(s); return wcsnlen(pinchars, maxsize); -}; +} int main() { System::Console::WriteLine(getlen("testing")); diff --git a/docs/dotnet/how-to-declare-override-specifiers-in-native-compilations-cpp-cli.md b/docs/dotnet/how-to-declare-override-specifiers-in-native-compilations-cpp-cli.md index a9e25c2df5b..3eeb84d31e6 100644 --- a/docs/dotnet/how-to-declare-override-specifiers-in-native-compilations-cpp-cli.md +++ b/docs/dotnet/how-to-declare-override-specifiers-in-native-compilations-cpp-cli.md @@ -1,16 +1,15 @@ --- -description: "Learn more about: How to: Declare Override Specifiers in Native Compilations (C++/CLI)" title: "How to: Declare Override Specifiers (C++/CLI)" +description: "Learn more about: How to: Declare Override Specifiers in Native Compilations (C++/CLI)" ms.date: "11/04/2016" helpviewer_keywords: ["override specifiers in native compilation, overriding"] -ms.assetid: d0551836-9ac7-41eb-a6e9-a4b3ef60767d --- # How to: Declare Override Specifiers in Native Compilations (C++/CLI) -[sealed](../extensions/sealed-cpp-component-extensions.md), [abstract](../extensions/abstract-cpp-component-extensions.md), and [override](../extensions/override-cpp-component-extensions.md) are available in compilations that do not use **/ZW** or [/clr](../build/reference/clr-common-language-runtime-compilation.md). +[`sealed`](../extensions/sealed-cpp-component-extensions.md), [`abstract`](../extensions/abstract-cpp-component-extensions.md), and [`override`](../extensions/override-cpp-component-extensions.md) are available in compilations that do not use **/ZW** or [`/clr`](../build/reference/clr-common-language-runtime-compilation.md). > [!NOTE] -> The ISO C++11 Standard language has the [override](../cpp/override-specifier.md) identifier and the [final](../cpp/final-specifier.md) identifier, and both are supported in Visual Studio Use `final` instead of **`sealed`** in code that is meant to be compiled as native-only. +> The ISO C++11 Standard language [`override`](../cpp/override-specifier.md) and [`final`](../cpp/final-specifier.md) specifiers are supported in Visual Studio. Use `final` instead of **`sealed`** in code that is meant to be compiled as native-only. ## Example: sealed is valid @@ -67,7 +66,7 @@ public: ### Description -This example shows that **`abstract`** is valid in native compilations. +This example shows that `abstract` is valid in native compilations. ### Code diff --git a/docs/dotnet/how-to-define-and-consume-classes-and-structs-cpp-cli.md b/docs/dotnet/how-to-define-and-consume-classes-and-structs-cpp-cli.md index 0850717e4cd..a0b88ce253c 100644 --- a/docs/dotnet/how-to-define-and-consume-classes-and-structs-cpp-cli.md +++ b/docs/dotnet/how-to-define-and-consume-classes-and-structs-cpp-cli.md @@ -3,7 +3,6 @@ title: "How to: Define and consume classes and structs (C++/CLI)" description: "How to create and use user-defined class and struct types in C++/CLI code." ms.date: 09/25/2020 helpviewer_keywords: ["structs [C++]", "classes [C++], instantiating"] -ms.assetid: 1c03cb0d-1459-4b5e-af65-97d6b3094fd7 --- # How to: Define and consume classes and structs (C++/CLI) @@ -467,7 +466,7 @@ in static constructor ## Semantics of the `this` pointer -When you're using C++\CLI to define types, the **`this`** pointer in a reference type is of type *handle*. The **`this`** pointer in a value type is of type *interior pointer*. +When you're using C++/CLI to define types, the **`this`** pointer in a reference type is of type *handle*. The **`this`** pointer in a value type is of type *interior pointer*. These different semantics of the **`this`** pointer can cause unexpected behavior when a default indexer is called. The next example shows the correct way to access a default indexer in both a ref type and a value type. @@ -636,7 +635,7 @@ The following sample demonstrates when a copy constructor isn't generated. ```cpp // compile with: /clr -#include +#include struct S { int i; diff --git a/docs/dotnet/how-to-define-and-install-a-global-exception-handler.md b/docs/dotnet/how-to-define-and-install-a-global-exception-handler.md index bfed57f87c4..35af0b6fce2 100644 --- a/docs/dotnet/how-to-define-and-install-a-global-exception-handler.md +++ b/docs/dotnet/how-to-define-and-install-a-global-exception-handler.md @@ -4,6 +4,7 @@ title: "How to: Define and Install a Global Exception Handler" ms.date: "11/04/2016" helpviewer_keywords: ["handlers, global"] ms.assetid: dd88a812-3bc7-4ce8-8283-4b674c246534 +ms.topic: how-to --- # How to: Define and Install a Global Exception Handler diff --git a/docs/dotnet/how-to-define-and-use-delegates-cpp-cli.md b/docs/dotnet/how-to-define-and-use-delegates-cpp-cli.md index 3a2235ad91a..eec4a6002ec 100644 --- a/docs/dotnet/how-to-define-and-use-delegates-cpp-cli.md +++ b/docs/dotnet/how-to-define-and-use-delegates-cpp-cli.md @@ -1,9 +1,8 @@ --- -description: "Learn more about: How to: Define and Use Delegates (C++/CLI)" title: "How to: Define and Use Delegates (C++/CLI)" -ms.date: "11/04/2016" +description: "Learn more about: How to: Define and Use Delegates (C++/CLI)" +ms.date: 11/04/2016 helpviewer_keywords: ["delegates"] -ms.assetid: 1cdf3420-89c1-47c0-b796-aa984020e0f8 --- # How to: Define and Use Delegates (C++/CLI) @@ -442,7 +441,7 @@ int main() { Del^ d = gcnew Del(r1, &R::f); d += gcnew Del(&R::f); d(r2); -}; +} ``` **Output** diff --git a/docs/dotnet/how-to-do-ddx-ddv-data-binding-with-windows-forms.md b/docs/dotnet/how-to-do-ddx-ddv-data-binding-with-windows-forms.md index 7d77830650e..098179c4ef5 100644 --- a/docs/dotnet/how-to-do-ddx-ddv-data-binding-with-windows-forms.md +++ b/docs/dotnet/how-to-do-ddx-ddv-data-binding-with-windows-forms.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: How to: Do DDX/DDV Data Binding with Windows Forms" title: "How to: Do DDX-DDV Data Binding with Windows Forms" +description: "Learn more about: How to: Do DDX/DDV Data Binding with Windows Forms" ms.custom: "get-started-article" ms.date: "11/04/2016" helpviewer_keywords: ["MFC [C++], hosting a Windows Forms Control", "Windows Forms [C++], MFC support"] -ms.assetid: b2957370-cf1f-4779-94ac-228cd393686c --- # How to: Do DDX/DDV Data Binding with Windows Forms @@ -53,7 +52,7 @@ void CMFC01Dlg::DoDataExchange(CDataExchange* pDX) ## Example: Add handler method -Now we will add the handler method for a click on the OK button. Click the **Resource View** tab. In Resource View, double-click on `IDD_MFC01_DIALOG`. The dialog resource appears in Resource Editor. Then double click the OK button.. +Now we will add the handler method for a click on the OK button. Click the **Resource View** tab. In Resource View, double-click on `IDD_MFC01_DIALOG`. The dialog resource appears in Resource Editor. Then double click the OK button. Define the handler as follows. @@ -77,6 +76,6 @@ You can now build and run the application. Notice that any text in the text box ## See also -[CWinFormsControl Class](../mfc/reference/cwinformscontrol-class.md)
-[DDX_ManagedControl](../mfc/reference/standard-dialog-data-exchange-routines.md#ddx_managedcontrol)
+[CWinFormsControl Class](../mfc/reference/cwinformscontrol-class.md)\ +[DDX_ManagedControl](../mfc/reference/standard-dialog-data-exchange-routines.md#ddx_managedcontrol)\ [CWnd::DoDataExchange](../mfc/reference/cwnd-class.md#dodataexchange) diff --git a/docs/dotnet/how-to-migrate-to-clr.md b/docs/dotnet/how-to-migrate-to-clr.md index b3e6d4c633d..e05adbbaf9b 100644 --- a/docs/dotnet/how-to-migrate-to-clr.md +++ b/docs/dotnet/how-to-migrate-to-clr.md @@ -1,14 +1,14 @@ --- -description: "Learn more about: How to: Migrate to /clr" title: "How to: Migrate to /clr" +description: "Learn more about: How to: Migrate to /clr" +ms.date: 09/18/2018 ms.custom: "get-started-article" -ms.date: "09/18/2018" +ms.topic: upgrade-and-migration-article helpviewer_keywords: ["upgrading Visual C++ applications, /clr compiler option", "compiling native code [C++]", "interoperability [C++], /clr compiler option", "interop [C++], /clr compiler option", "migration [C++], /clr compiler option", "/clr compiler option [C++], porting to"] -ms.assetid: c9290b8b-436a-4510-8b56-eae51f4a9afc --- # How to: Migrate to `/clr` -This article discusses issues that arise when compiling native code with **`/clr`**. (For more information, see [/clr (Common Language Runtime Compilation)](../build/reference/clr-common-language-runtime-compilation.md).) **`/clr`** allows native C++ code to invoke and be invoked from .NET assemblies in addition to other native C++ code. For more information on the advantages of compiling with **`/clr`**, see [Mixed (Native and Managed) Assemblies](../dotnet/mixed-native-and-managed-assemblies.md) and [Native and .NET Interoperability](../dotnet/native-and-dotnet-interoperability.md). +This article discusses issues that arise when compiling native code with **`/clr`**. For more information, see [/clr (Common Language Runtime Compilation)](../build/reference/clr-common-language-runtime-compilation.md). **`/clr`** allows native C++ code to invoke and be invoked from .NET assemblies in addition to other native C++ code. For more information on the advantages of compiling with **`/clr`**, see [Mixed (Native and Managed) Assemblies](../dotnet/mixed-native-and-managed-assemblies.md) and [Native and .NET Interoperability](../dotnet/native-and-dotnet-interoperability.md). ## Known issues compiling library projects with `/clr` @@ -119,7 +119,7 @@ Native types are **`private`** by default. A **`private`** native type isn't vis ### Floating point and alignment issues -`__controlfp` isn't supported in the common language runtime. (For more information, see [`_control87`, `_controlfp`, `__control87_2`](../c-runtime-library/reference/control87-controlfp-control87-2.md).) The CLR also doesn't respect [`align`](../cpp/align-cpp.md). +`__controlfp` isn't supported in the common language runtime. For more information, see [`_control87`, `_controlfp`, `__control87_2`](../c-runtime-library/reference/control87-controlfp-control87-2.md). The CLR also doesn't respect [`align`](../cpp/align-cpp.md). ### COM initialization diff --git a/docs/dotnet/how-to-sink-windows-forms-events-from-native-cpp-classes.md b/docs/dotnet/how-to-sink-windows-forms-events-from-native-cpp-classes.md index 07a8fd3dcc9..71f5f0f5e8c 100644 --- a/docs/dotnet/how-to-sink-windows-forms-events-from-native-cpp-classes.md +++ b/docs/dotnet/how-to-sink-windows-forms-events-from-native-cpp-classes.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: How to: Sink Windows Forms Events from Native C++ Classes" title: "How to: Sink Windows Forms Events from Native C++ Classes" +description: "Learn more about: How to: Sink Windows Forms Events from Native C++ Classes" +ms.date: 11/04/2016 ms.custom: "get-started-article" -ms.date: "11/04/2016" helpviewer_keywords: ["event handling, managed/native interop", "event handling, sinking .NET in C++", "event handling, .NET/native interop", "event handling, Windows Forms in C++"] -ms.assetid: 6e30ddee-d058-4c8d-9956-2a43d86f19d5 --- # How to: Sink Windows Forms Events from Native C++ Classes @@ -20,7 +19,7 @@ This sample continues the work you did in [How to: Do DDX/DDV Data Binding with Now, you will associate your MFC control (`m_MyControl`) with a managed event handler delegate called `OnClick` for the managed event. -### To attach the OnClick event handler: +### To attach the OnClick event handler 1. Add the following code to the implementation of BOOL CMFC01Dlg::OnInitDialog: diff --git a/docs/dotnet/how-to-use-arrays-in-cpp-cli.md b/docs/dotnet/how-to-use-arrays-in-cpp-cli.md index 14f17299db7..6bdeba25b06 100644 --- a/docs/dotnet/how-to-use-arrays-in-cpp-cli.md +++ b/docs/dotnet/how-to-use-arrays-in-cpp-cli.md @@ -221,7 +221,7 @@ public: }; int main() { - // Aggregate initialize a multidimension managed array. + // Aggregate initialize a multidimensional managed array. array^ gc1 = gcnew array{ {"one", "two"}, {"three", "four"} }; array^ gc2 = { {"one", "two"}, {"three", "four"} }; diff --git a/docs/dotnet/list-stl-clr.md b/docs/dotnet/list-stl-clr.md index 7069b4797ca..fff82c19fd8 100644 --- a/docs/dotnet/list-stl-clr.md +++ b/docs/dotnet/list-stl-clr.md @@ -1,11 +1,10 @@ --- -description: "Learn more about: list (STL/CLR)" title: "list (STL/CLR)" +description: "Learn more about: list (STL/CLR)" ms.date: "11/04/2016" ms.topic: "reference" f1_keywords: ["cliext::list", "cliext::list::assign", "cliext::list::back", "cliext::list::back_item", "cliext::list::begin", "cliext::list::clear", "cliext::list::const_iterator", "cliext::list::const_reference", "cliext::list::const_reverse_iterator", "cliext::list::difference_type", "cliext::list::empty", "cliext::list::end", "cliext::list::erase", "cliext::list::front", "cliext::list::front_item", "cliext::list::generic_container", "cliext::list::generic_iterator", "cliext::list::generic_reverse_iterator", "cliext::list::generic_value", "cliext::list::insert", "cliext::list::iterator", "cliext::list::list", "cliext::list::merge", "cliext::list::operator=", "cliext::list::pop_back", "cliext::list::pop_front", "cliext::list::push_back", "cliext::list::push_front", "cliext::list::rbegin", "cliext::list::reference", "cliext::list::remove", "cliext::list::remove_if", "cliext::list::rend", "cliext::list::resize", "cliext::list::reverse", "cliext::list::reverse_iterator", "cliext::list::size", "cliext::list::size_type", "cliext::list::sort", "cliext::list::splice", "cliext::list::swap", "cliext::list::to_array", "cliext::list::unique", "cliext::list::value_type", "cliext::operator!=(list)", "cliext::operator<(list)", "cliext::operator<=(list)", "cliext::operator==(list)", "cliext::operator>(list)", "cliext::operator>=(list)"] helpviewer_keywords: [" header [STL/CLR]", "list class [STL/CLR]", " header [STL/CLR]", "assign member [STL/CLR]", "assign member [STL/CLR]", "back member [STL/CLR]", "back_item member [STL/CLR]", "begin member [STL/CLR]", "clear member [STL/CLR]", "const_iterator member [STL/CLR]", "const_reference member [STL/CLR]", "const_reverse_iterator member [STL/CLR]", "difference_type member [STL/CLR]", "empty member [STL/CLR]", "end member [STL/CLR]", "erase member [STL/CLR]", "front member [STL/CLR]", "front_item member [STL/CLR]", "generic_container member [STL/CLR]", "generic_iterator member [STL/CLR]", "generic_reverse_iterator member [STL/CLR]", "generic_value member [STL/CLR]", "insert member [STL/CLR]", "iterator member [STL/CLR]", "list member [STL/CLR]", "merge member [STL/CLR]", "operator= member [STL/CLR]", "pop_back member [STL/CLR]", "pop_front member [STL/CLR]", "push_back member [STL/CLR]", "push_front member [STL/CLR]", "rbegin member [STL/CLR]", "reference member [STL/CLR]", "remove member [STL/CLR]", "remove_if member [STL/CLR]", "rend member [STL/CLR]", "resize member [STL/CLR]", "reverse member [STL/CLR]", "reverse_iterator member [STL/CLR]", "size member [STL/CLR]", "size_type member [STL/CLR]", "sort member [STL/CLR]", "splice member [STL/CLR]", "swap member [STL/CLR]", "to_array member [STL/CLR]", "unique member [STL/CLR]", "value_type member [STL/CLR]", "operator!=(list) member [STL/CLR]", "operator<(list) member [STL/CLR]", "operator<=(list) member [STL/CLR]", "operator==(list) member [STL/CLR]", "operator>(list) member [STL/CLR]", "operator>=(list) member [STL/CLR]"] -ms.assetid: a70c45c8-a257-4f6b-8434-b27ff6685bac --- # list (STL/CLR) @@ -510,7 +509,7 @@ a b c ## list::const_reverse_iterator (STL/CLR) -The type of a constant reverse iterator for the controlled sequence.. +The type of a constant reverse iterator for the controlled sequence. ### Syntax diff --git a/docs/dotnet/lock-class.md b/docs/dotnet/lock-class.md index 62bfe76335f..98e44d2673f 100644 --- a/docs/dotnet/lock-class.md +++ b/docs/dotnet/lock-class.md @@ -1,11 +1,10 @@ --- -description: "Learn more about: lock Class" title: "lock Class" -ms.date: "01/16/2019" +description: "Learn more about: lock Class" +ms.date: 01/16/2019 ms.topic: "reference" f1_keywords: ["msclr::lock::lock", "msclr::lock::is_locked", "msclr::lock.is_locked", "msclr::lock::acquire", "msclr::lock::try_acquire", "msclr::lock::release", "msclr::lock::operator==", "msclr::lock::operator!="] helpviewer_keywords: ["msclr::lock class"] -ms.assetid: 5123edd9-6aed-497d-9a0b-f4b6d6c0d666 --- # lock Class @@ -45,7 +44,7 @@ Internally, the lock class uses to synchronize a |Name|Description| |---------|-----------| -|[lock::operator bool](#operator-bool)|Operator for using `lock` in a conditional expression.| +|[lock::operator bool](#operator-bool)|Operator for using `lock` in a conditional expression.| |[lock::operator==](#operator-equality)|Equality operator.| |[lock::operator!=](#operator-inequality)|Inequality operator.| diff --git a/docs/dotnet/multimap-stl-clr.md b/docs/dotnet/multimap-stl-clr.md index 5579077cd35..16acca22db6 100644 --- a/docs/dotnet/multimap-stl-clr.md +++ b/docs/dotnet/multimap-stl-clr.md @@ -1,11 +1,10 @@ --- -description: "Learn more about: multimap (STL/CLR)" title: "multimap (STL/CLR)" -ms.date: "11/04/2016" +description: "Learn more about: multimap (STL/CLR)" +ms.date: 11/04/2016 ms.topic: "reference" f1_keywords: ["cliext::multimap", "cliext::multimap::begin", "cliext::multimap::clear", "cliext::multimap::const_iterator", "cliext::multimap::const_reference", "cliext::multimap::const_reverse_iterator", "cliext::multimap::count", "cliext::multimap::difference_type", "cliext::multimap::empty", "cliext::multimap::end", "cliext::multimap::equal_range", "cliext::multimap::erase", "cliext::multimap::find", "cliext::multimap::generic_container", "cliext::multimap::generic_iterator", "cliext::multimap::generic_reverse_iterator", "cliext::multimap::generic_value", "cliext::multimap::insert", "cliext::multimap::iterator", "cliext::multimap::key_comp", "cliext::multimap::key_compare", "cliext::multimap::key_type", "cliext::multimap::lower_bound", "cliext::multimap::make_value", "cliext::multimap::mapped_type", "cliext::multimap::multimap", "cliext::multimap::operator=", "cliext::multimap::rbegin", "cliext::multimap::reference", "cliext::multimap::rend", "cliext::multimap::reverse_iterator", "cliext::multimap::size", "cliext::multimap::size_type", "cliext::multimap::swap", "cliext::multimap::to_array", "cliext::multimap::upper_bound", "cliext::multimap::value_comp", "cliext::multimap::value_compare", "cliext::multimap::value_type", "cliext::mutlimap::operator!=", "cliext::mutlimap::operator<", "cliext::mutlimap::operator<=", "cliext::mutlimap::operator==", "cliext::mutlimap::operator>", "cliext::mutlimap::operator>="] helpviewer_keywords: [" header [STL/CLR]", " header [STL/CLR]", "multimap class [STL/CLR]", "begin member [STL/CLR]", "clear member [STL/CLR]", "const_iterator member [STL/CLR]", "const_reference member [STL/CLR]", "const_reverse_iterator member [STL/CLR]", "count member [STL/CLR]", "difference_type member [STL/CLR]", "empty member [STL/CLR]", "end member [STL/CLR]", "equal_range member [STL/CLR]", "erase member [STL/CLR]", "find member [STL/CLR]", "generic_container member [STL/CLR]", "generic_iterator member [STL/CLR]", "generic_reverse_iterator member [STL/CLR]", "generic_value member [STL/CLR]", "insert member [STL/CLR]", "iterator member [STL/CLR]", "key_comp member [STL/CLR]", "key_compare member [STL/CLR]", "key_type member [STL/CLR]", "lower_bound member [STL/CLR]", "make_value member [STL/CLR]", "mapped_type member [STL/CLR]", "multimap member [STL/CLR]", "operator= member [STL/CLR]", "rbegin member [STL/CLR]", "reference member [STL/CLR]", "rend member [STL/CLR]", "reverse_iterator member [STL/CLR]", "size member [STL/CLR]", "size_type member [STL/CLR]", "swap member [STL/CLR]", "to_array member [STL/CLR]", "upper_bound member [STL/CLR]", "value_comp member [STL/CLR]", "value_compare member [STL/CLR]", "value_type member [STL/CLR]", "operator!= member [STL/CLR]", "operator< member [STL/CLR]", "operator<= member [STL/CLR]", "operator== member [STL/CLR]", "operator> member [STL/CLR]", "operator>= member [STL/CLR]"] -ms.assetid: 3dfe329d-a078-462a-b050-7999ce6110ad --- # `multimap` (STL/CLR) @@ -770,7 +769,7 @@ Key value to search for. ### Remarks -If at least one element in the controlled sequence has equivalent ordering with *`key`*, the member function returns an iterator designating one of those elements; otherwise it returns[`end()`](#end). You use it to locate an element currently in the controlled sequence that matches a specified key. +If at least one element in the controlled sequence has equivalent ordering with *`key`*, the member function returns an iterator designating one of those elements; otherwise it returns [`end()`](#end). You use it to locate an element currently in the controlled sequence that matches a specified key. ### Example diff --git a/docs/dotnet/priority-queue-stl-clr.md b/docs/dotnet/priority-queue-stl-clr.md index 3dc4e67eb65..220f5b91d1b 100644 --- a/docs/dotnet/priority-queue-stl-clr.md +++ b/docs/dotnet/priority-queue-stl-clr.md @@ -1,11 +1,10 @@ --- -description: "Learn more about: priority_queue (STL/CLR)" title: "priority_queue (STL/CLR)" -ms.date: "11/04/2016" +description: "Learn more about: priority_queue (STL/CLR)" +ms.date: 11/04/2016 ms.topic: "reference" f1_keywords: ["cliext::priority_queue", "cliext::priority_queue::assign", "cliext::priority_queue::const_reference", "cliext::priority_queue::container_type", "cliext::priority_queue::difference_type", "cliext::priority_queue::empty", "cliext::priority_queue::generic_container", "cliext::priority_queue::generic_value", "cliext::priority_queue::get_container", "cliext::priority_queue::operator=", "cliext::priority_queue::pop", "cliext::priority_queue::priority_queue", "cliext::priority_queue::push", "cliext::priority_queue::reference", "cliext::priority_queue::size", "cliext::priority_queue::size_type", "cliext::priority_queue::to_array", "cliext::priority_queue::top", "cliext::priority_queue::top_item", "cliext::priority_queue::value_comp", "cliext::priority_queue::value_compare", "cliext::priority_queue::value_type"] helpviewer_keywords: ["priority_queue class [STL/CLR]", " header [STL/CLR]", " header [STL/CLR]", "assign member [STL/CLR]", "const_reference member [STL/CLR]", "container_type member [STL/CLR]", "difference_type member [STL/CLR]", "empty member [STL/CLR]", "generic_container member [STL/CLR]", "generic_value member [STL/CLR]", "get_container member [STL/CLR]", "operator= member [STL/CLR]", "pop member [STL/CLR]", "priority_queue member [STL/CLR]", "push member [STL/CLR]", "reference member [STL/CLR]", "size member [STL/CLR]", "size_type member [STL/CLR]", "to_array member [STL/CLR]", "top member [STL/CLR]", "top_item member [STL/CLR]", "value_comp member [STL/CLR]", "value_compare member [STL/CLR]", "value_type member [STL/CLR]"] -ms.assetid: 4d0000d3-68ff-4c4b-8157-7060540136f5 --- # priority_queue (STL/CLR) @@ -701,19 +700,19 @@ The constructor: `template priority_queue(InIt first, InIt last);` -creates an empty wrapped container, with the default ordering predicate, then pushes the sequence [`first`, `last`). You use it to specify an initial controlled sequence from a specified eqeuence, with the specified ordering predicate. +creates an empty wrapped container, with the default ordering predicate, then pushes the sequence [`first`, `last`). You use it to specify an initial controlled sequence from a specified sequence, with the specified ordering predicate. The constructor: `template priority_queue(InIt first, InIt last, value_compare^ pred);` -creates an empty wrapped container, with the ordering predicate *pred*, then pushes the sequence [`first`, `last`). You use it to specify an initial controlled sequence from a specified seqeuence, with the specified ordering predicate. +creates an empty wrapped container, with the ordering predicate *pred*, then pushes the sequence [`first`, `last`). You use it to specify an initial controlled sequence from a specified sequence, with the specified ordering predicate. The constructor: `template priority_queue(InIt first, InIt last, value_compare^ pred, container_type% cont);` -creates an empty wrapped container, with the ordering predicate *pred*, then pushes all the elements of *cont* plus the sequence [`first`, `last`). You use it to specify an initial controlled sequence from an existing container and a specified seqeuence, with the specified ordering predicate. +creates an empty wrapped container, with the ordering predicate *pred*, then pushes all the elements of *cont* plus the sequence [`first`, `last`). You use it to specify an initial controlled sequence from an existing container and a specified sequence, with the specified ordering predicate. ### Example diff --git a/docs/dotnet/queue-stl-clr.md b/docs/dotnet/queue-stl-clr.md index 4bd7aaf67ec..d3bc7430b5a 100644 --- a/docs/dotnet/queue-stl-clr.md +++ b/docs/dotnet/queue-stl-clr.md @@ -1,6 +1,6 @@ --- -description: "Learn more about: queue (STL/CLR)" title: "queue (STL/CLR)" +description: "Learn more about: queue (STL/CLR)" ms.date: "4/20/2023" ms.topic: "reference" f1_keywords: ["cliext::queue", "cliext::queue::assign", "cliext::queue::back", "cliext::queue::back_item", "cliext::queue::const_reference", "cliext::queue::container_type", "cliext::queue::difference_type", "cliext::queue::empty", "cliext::queue::front", "cliext::queue::front_item", "cliext::queue::generic_container", "cliext::queue::generic_value", "cliext::queue::get_container", "cliext::queue::operator=", "cliext::queue::pop", "cliext::queue::push", "cliext::queue::queue", "cliext::queue::reference", "cliext::queue::size", "cliext::queue::size_type", "cliext::queue::to_array", "cliext::queue::value_type"] @@ -1417,7 +1417,7 @@ int main() c2.push(L'b'); c2.push(L'd'); -/ / display contents "a b d" + // display contents "a b d" for each (wchar_t elem in c2.get_container()) System::Console::Write("{0} ", elem); System::Console::WriteLine(); diff --git a/docs/dotnet/reflection-cpp-cli.md b/docs/dotnet/reflection-cpp-cli.md index 9b31b0a1498..5cf26a76a1f 100644 --- a/docs/dotnet/reflection-cpp-cli.md +++ b/docs/dotnet/reflection-cpp-cli.md @@ -1,9 +1,8 @@ --- -description: "Learn more about: Reflection (C++/CLI)" title: "Reflection (C++/CLI)" -ms.date: "11/04/2016" -helpviewer_keywords: ["typeid keyword [C++]", "reflection [C++}, about reflection", "metadata, reflection", "GetType method", ".NET Framework [C++], reflection", "data types [C++], reflection", "reflection [C++}", "plug-ins [C++]", "reflection [C++}, plug-ins", "assemblies [C++], enumerating data types in", "public types [C++]", "reflection [C++], external assemblies", "assemblies [C++]", "data types [C++], enumerating", "public members [C++]"] -ms.assetid: 46b6ff4a-e441-4022-8892-78e69422f230 +description: "Learn more about: Reflection (C++/CLI)" +ms.date: 11/04/2016 +helpviewer_keywords: ["typeid keyword [C++]", "reflection [C++], about reflection", "metadata, reflection", "GetType method", ".NET Framework [C++], reflection", "data types [C++], reflection", "reflection [C++]", "plug-ins [C++]", "reflection [C++], plug-ins", "assemblies [C++], enumerating data types in", "public types [C++]", "reflection [C++], external assemblies", "assemblies [C++]", "data types [C++], enumerating", "public members [C++]"] --- # Reflection (C++/CLI) diff --git a/docs/dotnet/stl-clr-library-reference.md b/docs/dotnet/stl-clr-library-reference.md index e38c1906036..8b2cd934967 100644 --- a/docs/dotnet/stl-clr-library-reference.md +++ b/docs/dotnet/stl-clr-library-reference.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: STL/CLR Library Reference" title: "STL/CLR Library Reference" +description: "Learn more about: STL/CLR Library Reference" ms.date: 09/18/2018 ms.topic: "reference" helpviewer_keywords: ["STL/CLR Library", "STL/CLR, redistribution", "cliext directory"] -ms.assetid: a9d9ca00-7bf2-48c1-b205-3ae6f8c25f82 --- # STL/CLR Library Reference @@ -51,7 +50,7 @@ In addition, this section also describes the following components of STL/CLR: [`hash_multimap` (STL/CLR)](../dotnet/hash-multimap-stl-clr.md)\ [`hash_multiset` (STL/CLR)](../dotnet/hash-multiset-stl-clr.md)\ [`hash_set` (STL/CLR)](../dotnet/hash-set-stl-clr.md)\ - [`list` (STL/CLR)](../dotnet/list-stl-clr.md)\ + [`list` (STL/CLR)](../dotnet/list-stl-clr.md) :::column-end::: :::column span=""::: [`map` (STL/CLR)](../dotnet/map-stl-clr.md)\ @@ -63,7 +62,7 @@ In addition, this section also describes the following components of STL/CLR: [`set` (STL/CLR)](../dotnet/set-stl-clr.md)\ [`stack` (STL/CLR)](../dotnet/stack-stl-clr.md)\ [`utility` (STL/CLR)](../dotnet/utility-stl-clr.md)\ - [`vector` (STL/CLR)](../dotnet/vector-stl-clr.md)\ + [`vector` (STL/CLR)](../dotnet/vector-stl-clr.md) :::column-end::: :::row-end::: diff --git a/docs/dotnet/using-a-windows-form-user-control-in-mfc.md b/docs/dotnet/using-a-windows-form-user-control-in-mfc.md index d5c87478bdd..a4d8bac8ddc 100644 --- a/docs/dotnet/using-a-windows-form-user-control-in-mfc.md +++ b/docs/dotnet/using-a-windows-form-user-control-in-mfc.md @@ -4,6 +4,7 @@ title: "Using a Windows Form User Control in MFC" ms.date: "01/08/2018" helpviewer_keywords: ["MFC [C++], Windows Forms support", "interoperability [C++], Windows Forms in MFC", "interoperability [C++], MFC", "interop [C++], Windows Forms in MFC", "interop [C++], MFC", "Windows Forms [C++], MFC support"] ms.assetid: 63fb099b-1dff-469c-9e34-dab52e122fcd +ms.topic: how-to --- # Using a Windows Form User Control in MFC diff --git a/docs/dotnet/using-cpp-interop-implicit-pinvoke.md b/docs/dotnet/using-cpp-interop-implicit-pinvoke.md index b3fd4a5badb..2cb904144ed 100644 --- a/docs/dotnet/using-cpp-interop-implicit-pinvoke.md +++ b/docs/dotnet/using-cpp-interop-implicit-pinvoke.md @@ -4,6 +4,7 @@ title: "Using C++ Interop (Implicit PInvoke)" ms.date: "11/04/2016" helpviewer_keywords: ["blittable types [C++]", "platform invoke [C++], implicit", "interop [C++], features", "data marshaling [C++], C++ Interop features", "porting [C++], C++ native to .NET", "COM interfaces [C++]", "implicit platform invoke", "examples [C++], interoperability", "types [C++], blittable", "marshaling [C++], C++ Interop features", "platform invoke [C++], examples", "interoperability [C++]", "C++ Interop", "interoperability [C++], Implicit PInvoke", "C++, interop", "C++ COM Interop", ".NET [C++], porting C++ native to"] ms.assetid: 5f710bf1-88ae-4c4e-8326-b3f0b7c4c68a +ms.topic: concept-article --- # Using C++ Interop (Implicit PInvoke) diff --git a/docs/dotnet/using-explicit-pinvoke-in-cpp-dllimport-attribute.md b/docs/dotnet/using-explicit-pinvoke-in-cpp-dllimport-attribute.md index 61b35c6421e..df29926c353 100644 --- a/docs/dotnet/using-explicit-pinvoke-in-cpp-dllimport-attribute.md +++ b/docs/dotnet/using-explicit-pinvoke-in-cpp-dllimport-attribute.md @@ -4,6 +4,7 @@ title: "Using Explicit PInvoke in C++ (DllImport Attribute)" ms.date: "11/04/2016" helpviewer_keywords: ["marshaling [C++], platform invoke", "C++ Interop, platform invoke", "interop [C++], platform invoke", "platform invoke [C++], marshaling in C++", "data marshaling [C++], platform invoke"] ms.assetid: 18e5218c-6916-48a1-a127-f66e22ef15fc +ms.topic: concept-article --- # Using Explicit PInvoke in C++ (DllImport Attribute) diff --git a/docs/dotnet/using-verifiable-assemblies-with-sql-server-cpp-cli.md b/docs/dotnet/using-verifiable-assemblies-with-sql-server-cpp-cli.md index 93acc4fdd74..d6ce13de8ab 100644 --- a/docs/dotnet/using-verifiable-assemblies-with-sql-server-cpp-cli.md +++ b/docs/dotnet/using-verifiable-assemblies-with-sql-server-cpp-cli.md @@ -4,6 +4,7 @@ title: "Using Verifiable Assemblies with SQL Server (C++/CLI)" ms.date: "10/17/2018" helpviewer_keywords: ["verifiable assemblies [C++], with SQL Server"] ms.assetid: 5248a60d-aa88-4ff3-b30a-b791c3ea2de9 +ms.topic: how-to --- # Using Verifiable Assemblies with SQL Server (C++/CLI) diff --git a/docs/dotnet/vector-stl-clr.md b/docs/dotnet/vector-stl-clr.md index d325c773972..c9469c0b712 100644 --- a/docs/dotnet/vector-stl-clr.md +++ b/docs/dotnet/vector-stl-clr.md @@ -1,11 +1,10 @@ --- -description: "Learn more about: vector (STL/CLR)" title: "vector (STL/CLR)" -ms.date: "11/04/2016" +description: "Learn more about: vector (STL/CLR)" +ms.date: 11/04/2016 ms.topic: "reference" f1_keywords: ["cliext::vector", "cliext::vector::assign", "cliext::vector::at", "cliext::vector::back", "cliext::vector::back_item", "cliext::vector::begin", "cliext::vector::capacity", "cliext::vector::clear", "cliext::vector::const_iterator", "cliext::vector::const_reference", "cliext::vector::const_reverse_iterator", "cliext::vector::difference_type", "cliext::vector::empty", "cliext::vector::end", "cliext::vector::erase", "cliext::vector::front", "cliext::vector::front_item", "cliext::vector::generic_container", "cliext::vector::generic_iterator", "cliext::vector::generic_reverse_iterator", "cliext::vector::generic_value", "cliext::vector::insert", "cliext::vector::iterator", "cliext::vector::operator=", "cliext::vector::operator", "cliext::vector::pop_back", "cliext::vector::push_back", "cliext::vector::rbegin", "cliext::vector::reference", "cliext::vector::rend", "cliext::vector::reserve", "cliext::vector::resize", "cliext::vector::reverse_iterator", "cliext::vector::size", "cliext::vector::size_type", "cliext::vector::swap", "cliext::vector::to_array", "cliext::vector::value_type", "cliext::vector::vector"] helpviewer_keywords: ["vector class [STL/CLR]", " header [STL/CLR]", " header [STL/CLR]", "operator!= member [STL/CLR]", "operator< member [STL/CLR]", "operator<= member [STL/CLR]", "operator== member [STL/CLR]", "operator> (vector) member [STL/CLR]", "operator>= member [STL/CLR]", "assign member [STL/CLR]", "at member [STL/CLR]", "back member [STL/CLR]", "back_item member [STL/CLR]", "begin member [STL/CLR]", "capacity member [STL/CLR]", "clear member [STL/CLR]", "const_iterator member [STL/CLR]", "const_reference member [STL/CLR]", "const_reverse_iterator member [STL/CLR]", "difference_type member [STL/CLR]", "empty member [STL/CLR]", "end member [STL/CLR]", "erase member [STL/CLR]", "front member [STL/CLR]", "front_item member [STL/CLR]", "generic_container member [STL/CLR]", "generic_iterator member [STL/CLR]", "generic_reverse_iterator member [STL/CLR]", "generic_value member [STL/CLR]", "insert member [STL/CLR]", "iterator member [STL/CLR]", "operator= member [STL/CLR]", "operator member [STL/CLR]", "pop_back member [STL/CLR]", "push_back member [STL/CLR]", "rbegin member [STL/CLR]", "reference member [STL/CLR]", "rend member [STL/CLR]", "reserve member [STL/CLR]", "resize member [STL/CLR]", "reverse_iterator member [STL/CLR]", "size member [STL/CLR]", "size_type member [STL/CLR]", "swap member [STL/CLR]", "to_array member [STL/CLR]", "value_type member [STL/CLR]", "vector member [STL/CLR]"] -ms.assetid: f90060d5-097a-4e9d-9a26-a634b5b9c6c2 --- # vector (STL/CLR) @@ -608,7 +607,7 @@ a b c ## vector::const_reverse_iterator (STL/CLR) -The type of a constant reverse iterator for the controlled sequence.. +The type of a constant reverse iterator for the controlled sequence. ### Syntax @@ -1455,7 +1454,7 @@ Position of element to access. ### Remarks -The member operator returns a referene to the element at position *pos*. You use it to access an element whose position you know. +The member operator returns a reference to the element at position *pos*. You use it to access an element whose position you know. ### Example diff --git a/docs/dotnet/walkthrough-compiling-a-cpp-program-that-targets-the-clr-in-visual-studio.md b/docs/dotnet/walkthrough-compiling-a-cpp-program-that-targets-the-clr-in-visual-studio.md index 89be33ea732..8152460289f 100644 --- a/docs/dotnet/walkthrough-compiling-a-cpp-program-that-targets-the-clr-in-visual-studio.md +++ b/docs/dotnet/walkthrough-compiling-a-cpp-program-that-targets-the-clr-in-visual-studio.md @@ -4,6 +4,7 @@ description: "Use Microsoft C++ to create programs and libraries that can connec ms.date: 10/28/2021 helpviewer_keywords: ["command-line applications [C++], managed code", "compiling programs [C++]", "Visual C++, managed code", "managed code [C++]"] ms.assetid: 339f89df-a5d2-4040-831a-ddbe25b5dce4 +ms.topic: how-to --- # Walkthrough: Compile a C++/CLI program that targets the CLR in Visual Studio diff --git a/docs/embedded/download-and-install-the-embedded-tooling.md b/docs/embedded/download-and-install-the-embedded-tooling.md index a445146308e..3e7d613e7ae 100644 --- a/docs/embedded/download-and-install-the-embedded-tooling.md +++ b/docs/embedded/download-and-install-the-embedded-tooling.md @@ -6,6 +6,7 @@ ms.custom: intro-installation author: gcampbell-msft ms.author: gcampbell monikerRange: '>=msvc-170' +ms.topic: install-set-up-deploy --- # Download and install the Embedded tooling @@ -14,6 +15,9 @@ monikerRange: '>=msvc-170' In Visual Studio 2022 and later versions, you can use the Visual Studio IDE on Windows to edit and debug embedded projects. Use tools such as the [Peripheral View](./peripheral-view.md), [RTOS View](./rtos-view.md), and the [Serial Monitor](./serial-monitor.md) to help interact with and debug your embedded projects. +> [!IMPORTANT] +> Starting with Visual Studio 2026 (version 18.0), the Mobile development with C++ workload for iOS and Android, as well as the Embedded and IoT tools (RTOS Viewer, Serial Monitor, Peripheral Viewer, and ST Project Import), are no longer supported and will be removed in a future update. The Android NDKs included in the Mobile development with C++ workload remain supported. + To use the embedded development tools in Visual Studio, you must install the required **Linux and embedded development with C++** workload. ## To install the Linux and embedded development with C++ workload @@ -24,7 +28,7 @@ To use the embedded development tools in Visual Studio, you must install the req 1. Open the Visual Studio Installer. In Visual Studio Installer, choose **Modify** next to your installation of Visual Studio, and then select the **Workloads** tab. Scroll down to **Other toolsets** and select the **Linux and embedded development with C++** workload. - ![Screenshot showing the Visual C++ for Linux Development workload item in Visual Studio Installer.](media/linux-and-embedded-workload.png) + ![Screenshot showing the Microsoft C++ for Linux Development workload item in Visual Studio Installer.](media/linux-and-embedded-workload.png) 1. Choose **Modify** to continue with the installation. diff --git a/docs/embedded/rtos-view.md b/docs/embedded/rtos-view.md index 4428fc316af..e5e9b7da9b0 100644 --- a/docs/embedded/rtos-view.md +++ b/docs/embedded/rtos-view.md @@ -18,7 +18,7 @@ The RTOS Object View allows users to view various components of an RTOS while de # [Visual Studio Code](#tab/visual-studio-code) -![RTOS View in VSCode](media/rtos-threads-vscode.png) +![RTOS View in VS Code](media/rtos-threads-vscode.png) --- diff --git a/docs/embedded/serial-monitor.md b/docs/embedded/serial-monitor.md index 6ec62acf7ed..581430e7832 100644 --- a/docs/embedded/serial-monitor.md +++ b/docs/embedded/serial-monitor.md @@ -14,6 +14,8 @@ The Serial Monitor allows users to configure, monitor, and communicate with seri # [Visual Studio](#tab/visual-studio) +To install Serial Monitor in Visual Studio, go to **Extensions** > **Manage Extensions**. Search for **Serial Monitor 2** in the extensions marketplace. Select **Install** and then restart Visual Studio to complete the installation. + :::image type="complex" source="./media/serial-monitor.png" alt-text="Screenshot of the Visual Studio Serial Monitor window."::: The window is split into two sections. The top section shows the monitoring mode (serial), Port (virtual COM port COM3), baud rate (115200), line ending (None), and a Stop monitoring button. The bottom section shows the messages, consisting of four lines of the text Hello, World! :::image-end::: @@ -44,6 +46,8 @@ The window is split into two sections. The top section shows the monitoring mode # [Visual Studio Code](#tab/visual-studio-code) +To install Serial Monitor in Visual Studio Code, open the extensions marketplace and then search for **Serial Monitor**. Select **Install**. + :::image type="complex" source="./media/serial-monitor-vscode.png" alt-text="Screenshot of the VS Code Serial Monitor window."::: The window is split into two sections. The top section shows the monitoring mode (serial), Port (virtual COM port COM3), baud rate (115200), line ending (None), and a Stop monitoring button. The bottom section where messages are displayed is empty. :::image-end::: diff --git a/docs/embedded/toc.yml b/docs/embedded/toc.yml index f05018c2726..b948c79311e 100644 --- a/docs/embedded/toc.yml +++ b/docs/embedded/toc.yml @@ -1,5 +1,5 @@ items: -- name: Embedded development with Visual Studio and Visual Studio code +- name: Embedded development with Visual Studio and Visual Studio Code href: ./index.yml - name: Download and install the Embedded Tools href: download-and-install-the-embedded-tooling.md @@ -19,7 +19,7 @@ items: href: ./peripheral-view.md - name: RTOS View href: ./rtos-view.md - - name: Serial Monitor + - name: Serial Monitor href: ./serial-monitor.md - name: vcpkg artifacts href: https://devblogs.microsoft.com/cppblog/vcpkg-artifacts/ diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2001.md b/docs/error-messages/compiler-errors-1/compiler-error-c2001.md index b72f3b033c9..6f34a4fc3d2 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2001.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2001.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Error C2001" title: "Compiler Error C2001" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2001" +ms.date: 11/04/2016 f1_keywords: ["C2001"] helpviewer_keywords: ["C2001"] -ms.assetid: 0c3a7821-d8e5-4398-ab5a-4116d46e8dda --- # Compiler Error C2001 -newline in constant +> newline in constant + +## Remarks A string constant cannot be continued on a second line unless you do the following: @@ -18,9 +19,9 @@ A string constant cannot be continued on a second line unless you do the followi Ending the first line with \n is not sufficient. -## Examples +## Example -The following sample generates C2001: +The following example generates C2001: ```cpp // C2001.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2002.md b/docs/error-messages/compiler-errors-1/compiler-error-c2002.md index 70d299ecd6b..418f0bc0552 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2002.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2002.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Error C2002" title: "Compiler Error C2002" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2002" +ms.date: 11/04/2016 f1_keywords: ["C2002"] helpviewer_keywords: ["C2002"] -ms.assetid: 91982314-203a-4de1-b884-94e39a623f61 --- # Compiler Error C2002 -invalid wide-character constant +> invalid wide-character constant + +## Remarks The multibyte-character constant is not valid. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2003.md b/docs/error-messages/compiler-errors-1/compiler-error-c2003.md index 61d4e32b6b6..2fbb8924306 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2003.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2003.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Compiler Error C2003" title: "Compiler Error C2003" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2003" +ms.date: 11/04/2016 f1_keywords: ["C2003"] helpviewer_keywords: ["C2003"] -ms.assetid: 3161bc08-593d-4448-9fd3-4e3810be9e82 --- # Compiler Error C2003 -expected 'defined id' +> expected 'defined id' + +## Remarks An identifier must follow the preprocessor keyword. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2004.md b/docs/error-messages/compiler-errors-1/compiler-error-c2004.md index a17dba2cb45..18b687d027d 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2004.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2004.md @@ -1,22 +1,23 @@ --- -description: "Learn more about: Compiler Error C2004" title: "Compiler Error C2004" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2004" +ms.date: 11/04/2016 f1_keywords: ["C2004"] helpviewer_keywords: ["C2004"] -ms.assetid: d81526dd-3a00-4593-87b0-d910d3d29bca --- # Compiler Error C2004 -expected 'defined(id)' +> expected 'defined(id)' + +## Remarks An identifier must appear in the parentheses following the preprocessor keyword. This error can also be generated as a result of compiler conformance work that was done for Visual Studio .NET 2003: missing parenthesis in preprocessor directive. If the closing parenthesis is missing from a preprocessor directive, the compiler will generate an error. -## Examples +## Example -The following sample generates C2004: +The following example generates C2004: ```cpp // C2004.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2005.md b/docs/error-messages/compiler-errors-1/compiler-error-c2005.md index 01f56d8c3ff..d09db6738ac 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2005.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2005.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2005" title: "Compiler Error C2005" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2005" +ms.date: 11/04/2016 f1_keywords: ["C2005"] helpviewer_keywords: ["C2005"] -ms.assetid: 090530ed-e0ec-4358-833a-ca24260e7ffe --- # Compiler Error C2005 -\#line expected a line number, found 'token' +> #line expected a line number, found 'token' + +## Remarks The `#line` directive must be followed by a line number. -The following sample generates C2005: +## Example + +The following example generates C2005: ```cpp // C2005.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2006.md b/docs/error-messages/compiler-errors-1/compiler-error-c2006.md index a1a28744008..65c59918ffd 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2006.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2006.md @@ -1,28 +1,26 @@ --- -description: "Learn more about: Compiler Error C2006" title: "Compiler Error C2006" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2006" +ms.date: 01/28/2025 f1_keywords: ["C2006"] helpviewer_keywords: ["C2006"] -ms.assetid: caaed6f7-ceb9-4742-8820-d66657c0b04d --- # Compiler Error C2006 -'directive' expected a filename, found 'token' +> 'directive': expected "FILENAME" or \ -Directives such as [#include](../../preprocessor/hash-include-directive-c-cpp.md) or [#import](../../preprocessor/hash-import-directive-cpp.md) require a filename. To resolve the error, make sure *token* is a valid filename. Also, put the filename in double quotes or angle brackets. +## Remarks -The following sample generates C2006: +Directives such as [#include](../../preprocessor/hash-include-directive-c-cpp.md) or [#import](../../preprocessor/hash-import-directive-cpp.md) require a filename. To resolve the error, ensure the filename is valid and enclosed in either double quotes or angle brackets. -```cpp -// C2006.cpp -#include stdio.h // C2006 -``` +## Example -Possible resolution: +The following example generates C2006: ```cpp -// C2006b.cpp +// C2006.cpp // compile with: /c -#include +#include iostream // C2006 +#include 'iostream' // C2006 +#include // OK ``` diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2007.md b/docs/error-messages/compiler-errors-1/compiler-error-c2007.md index c34b64e7886..e5831f153ad 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2007.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2007.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2007" title: "Compiler Error C2007" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2007" +ms.date: 11/04/2016 f1_keywords: ["C2007"] helpviewer_keywords: ["C2007"] -ms.assetid: ecd09d99-5036-408b-9e46-bc15488f049e --- # Compiler Error C2007 -\#define syntax +> #define syntax + +## Remarks No identifier appears after a `#define`. To resolve the error, use an identifier. -The following sample generates C2007: +## Example + +The following example generates C2007: ```cpp // C2007.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2008.md b/docs/error-messages/compiler-errors-1/compiler-error-c2008.md index 3c0bc7b7c0d..56451a8c67f 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2008.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2008.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2008" title: "Compiler Error C2008" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2008" +ms.date: 11/04/2016 f1_keywords: ["C2008"] helpviewer_keywords: ["C2008"] -ms.assetid: e748ccbe-ffd4-4008-aca7-e53c25225209 --- # Compiler Error C2008 -'character' : unexpected in macro definition +> 'character' : unexpected in macro definition + +## Remarks The character appears immediately following the macro name. To resolve the error, there must be a space after the macro name. -The following sample generates C2008: +## Example + +The following example generates C2008: ```cpp // C2008.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2009.md b/docs/error-messages/compiler-errors-1/compiler-error-c2009.md index fe06f1de781..22d2909681a 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2009.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2009.md @@ -1,20 +1,21 @@ --- -description: "Learn more about: Compiler Error C2009" title: "Compiler Error C2009" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2009" +ms.date: 11/04/2016 f1_keywords: ["C2009"] helpviewer_keywords: ["C2009"] -ms.assetid: fe9d94ed-20a5-4d83-b9c4-60ee69d2f30a --- # Compiler Error C2009 -reuse of macro formal 'identifier' +> reuse of macro formal 'identifier' + +## Remarks The formal parameter list of a macro definition uses the identifier more than once. Identifiers in the macro's parameter list must be unique. -## Examples +## Example -The following sample generates C2009: +The following example generates C2009: ```cpp // C2009.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2010.md b/docs/error-messages/compiler-errors-1/compiler-error-c2010.md index 0219901c98f..2deeab992f0 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2010.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2010.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2010" title: "Compiler Error C2010" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2010" +ms.date: 11/04/2016 f1_keywords: ["C2010"] helpviewer_keywords: ["C2010"] -ms.assetid: 5795ed1d-e206-410b-b7b4-528d125c67b4 --- # Compiler Error C2010 -'character' : unexpected in macro formal parameter list +> 'character' : unexpected in macro formal parameter list + +## Remarks The character is used incorrectly in the formal parameter list of a macro definition. Remove the character to resolve the error. -The following sample generates C2010: +## Example + +The following example generates C2010: ```cpp // C2010.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2011.md b/docs/error-messages/compiler-errors-1/compiler-error-c2011.md index f74c11a4a07..57533da7f97 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2011.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2011.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Error C2011" title: "Compiler Error C2011" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2011" +ms.date: 11/04/2016 f1_keywords: ["C2011"] helpviewer_keywords: ["C2011"] -ms.assetid: 992c9d51-e850-4d53-b86b-02e73b38249c --- # Compiler Error C2011 -'identifier' : 'type' type redefinition +> 'identifier' : 'type' type redefinition + +## Remarks The identifier was already defined as `type`. Check for redefinitions of the identifier. @@ -16,7 +17,9 @@ You may also get C2011 if you import a header file or type library more than onc If you need to find the initial declaration of the redefined type, you can use the [/P](../../build/reference/p-preprocess-to-a-file.md) compiler flag to generate the preprocessed output passed to the compiler. You can use text search tools to find instances of the redefined identifier in the output file. -The following sample generates C2011 and shows one way to fix it: +## Example + +The following example generates C2011 and shows one way to fix it: ```cpp // C2011.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2012.md b/docs/error-messages/compiler-errors-1/compiler-error-c2012.md index e186eb5de56..ef35628c054 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2012.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2012.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2012" title: "Compiler Error C2012" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2012" +ms.date: 11/04/2016 f1_keywords: ["C2012"] helpviewer_keywords: ["C2012"] -ms.assetid: 9f0d8162-c0b3-4234-a41f-836fdb75c84e --- # Compiler Error C2012 -missing name following '<' +> missing name following '<' + +## Remarks An `#include` directive lacks the required filename. -The following sample generates C2012: +## Example + +The following example generates C2012: ```cpp // C2012.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2013.md b/docs/error-messages/compiler-errors-1/compiler-error-c2013.md index 88d193210e1..eeca87ca533 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2013.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2013.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2013" title: "Compiler Error C2013" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2013" +ms.date: 11/04/2016 f1_keywords: ["C2013"] helpviewer_keywords: ["C2013"] -ms.assetid: 6b5c955c-53da-48ee-8533-64ef5b905173 --- # Compiler Error C2013 -missing '>' +> missing '>' + +## Remarks An `#include` directive lacks a closing angle bracket. Add the closing bracket to resolve the error. -The following sample generates C2013: +## Example + +The following example generates C2013: ```cpp // C2013.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2014.md b/docs/error-messages/compiler-errors-1/compiler-error-c2014.md index b4369d49390..0bbac771005 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2014.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2014.md @@ -1,29 +1,31 @@ --- -description: "Learn more about: Compiler Error C2014" title: "Compiler Error C2014" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2014" +ms.date: 08/25/2025 f1_keywords: ["C2014"] helpviewer_keywords: ["C2014"] -ms.assetid: 231d8e9c-48c0-4027-99a3-245d186275ec --- # Compiler Error C2014 -preprocessor command must start as first nonwhite space +> preprocessor command must start as first nonwhite space -The `#` sign of a preprocessor directive must be the first character on a line that is not white space. +## Remarks -The following sample generates C2014: +The `#` sign of a [preprocessor directive](../../preprocessor/preprocessor-directives.md) must be the first character on a line that is not white space. Ensure that the previous line doesn't contain a trailing escape. -```cpp -// C2014.cpp -int k; #include // C2014 -``` +## Example -Possible resolution: +The following example generates C2014: ```cpp -// C2014b.cpp +// C2014.cpp // compile with: /c -int k; -#include + +int a; #define A // C2014 + +int b;\ +#define B // C2014 + +int c; +#define C // OK ``` diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2015.md b/docs/error-messages/compiler-errors-1/compiler-error-c2015.md index 7c3cb4ed8e3..060b5b60fbe 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2015.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2015.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Error C2015" title: "Compiler Error C2015" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2015" +ms.date: 11/04/2016 f1_keywords: ["C2015"] helpviewer_keywords: ["C2015"] -ms.assetid: 8f40af0a-3a5a-4d6a-8ed7-125966e6bfed --- # Compiler Error C2015 -too many characters in constant +> too many characters in constant + +## Remarks A character constant contains more than two characters. The limit is one character for standard character constants and two characters for long character constants. @@ -16,7 +17,7 @@ An escape sequence, such as \t, is converted to a single character. ## Examples -The following sample generates C2015: +The following example generates C2015: ```cpp // C2015.cpp @@ -26,7 +27,7 @@ char test1 = 'error'; // C2015 char test2 = 'e'; // OK ``` -C2015 can also occur when using a Microsoft extension, character constants converted to integers. The following sample generates C2015: +C2015 can also occur when using a Microsoft extension, character constants converted to integers. The following example generates C2015: ```cpp // C2015b.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2016.md b/docs/error-messages/compiler-errors-1/compiler-error-c2016.md index 8e6379635ae..563387c249a 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2016.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2016.md @@ -1,6 +1,6 @@ --- -description: "Learn more about: Compiler Error C2016" title: "Compiler Error C2016" +description: "Learn more about: Compiler Error C2016" ms.date: 08/18/2022 f1_keywords: ["C2016"] helpviewer_keywords: ["C2016"] @@ -9,6 +9,8 @@ helpviewer_keywords: ["C2016"] > C requires that a struct or union has at least one member +## Remarks + The compiler found a **`struct`** or **`union`** defined with no members, which isn't allowed in C. For more information, see [Structures](../../c-language/structure-declarations.md) and [Unions](../../c-language/union-declarations.md). To resolve this error, create at least one member in your **`struct`** or **`union`**. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2017.md b/docs/error-messages/compiler-errors-1/compiler-error-c2017.md index fc2705d40d0..d659ba2526b 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2017.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2017.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2017" title: "Compiler Error C2017" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2017" +ms.date: 11/04/2016 f1_keywords: ["C2017"] helpviewer_keywords: ["C2017"] -ms.assetid: 1083eed9-9906-4a97-883c-54e52d7e82cd --- # Compiler Error C2017 -illegal escape sequence +> illegal escape sequence + +## Remarks An escape sequence, such as \t, appears outside of a character or string constant. -The following sample generates C2017: +## Examples + +The following example generates C2017: ```cpp // C2017.cpp @@ -24,7 +27,7 @@ int main() { C2017 can occur when the stringize operator is used with strings that include escape sequences. -The following sample generates C2017: +The following example generates C2017: ```cpp // C2017b.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2018.md b/docs/error-messages/compiler-errors-1/compiler-error-c2018.md index f81256fbfbf..16c19e66bfb 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2018.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2018.md @@ -1,31 +1,26 @@ --- -description: "Learn more about: Compiler Error C2018" title: "Compiler Error C2018" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2018" +ms.date: 06/21/2025 f1_keywords: ["C2018"] helpviewer_keywords: ["C2018"] -ms.assetid: 86b54573-dca0-4446-be1a-e3ac489c073b --- # Compiler Error C2018 -unknown character 'hexnumber' +> unknown character 'hexnumber' -The source file contains an unexpected ASCII character, which is identified by its hex number. To resolve the error, remove the character. +## Remarks -The following sample generates C2018: +The source file contains an unexpected ASCII character, which is identified by its hex number. To resolve the error, remove the character. -```cpp -// C2018.cpp -int main() { - @ // C2018 -} -``` +## Example -Possible resolution: +The following example generates C2018: ```cpp -// C2018b.cpp -int main() { - +// C2018.cpp +int main() +{ + @ // C2018 } ``` diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2019.md b/docs/error-messages/compiler-errors-1/compiler-error-c2019.md index 8353a05ae67..e835a042526 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2019.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2019.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2019" title: "Compiler Error C2019" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2019" +ms.date: 11/04/2016 f1_keywords: ["C2019"] helpviewer_keywords: ["C2019"] -ms.assetid: 4f37b1e1-9eca-418f-a4c3-141e8512d7b6 --- # Compiler Error C2019 -expected preprocessor directive, found 'character' +> expected preprocessor directive, found 'character' + +## Remarks The character followed a `#` sign but it is not the first letter of a preprocessor directive. -The following sample generates C2019: +## Example + +The following example generates C2019: ```cpp // C2019.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2020.md b/docs/error-messages/compiler-errors-1/compiler-error-c2020.md index 1d9ecbc4945..bc32e9e64ce 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2020.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2020.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Compiler Error C2020" title: "Compiler Error C2020" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2020" +ms.date: 11/04/2016 f1_keywords: ["C2020"] helpviewer_keywords: ["C2020"] -ms.assetid: 486f98ed-6574-4d82-89e3-74b5a61ed419 --- # Compiler Error C2020 -'member' : 'class' member redefinition +> 'member' : 'class' member redefinition + +## Remarks A member inherited from a base class or structure is redefined. Inherited members cannot be redefined unless declared as **`virtual`** in the base class. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2021.md b/docs/error-messages/compiler-errors-1/compiler-error-c2021.md index a32149660cb..e0a6ce1831a 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2021.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2021.md @@ -1,20 +1,21 @@ --- -description: "Learn more about: Compiler Error C2021" title: "Compiler Error C2021" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2021" +ms.date: 11/04/2016 f1_keywords: ["C2021"] helpviewer_keywords: ["C2021"] -ms.assetid: 064f32e2-3794-48d5-9767-991003dcb36a --- # Compiler Error C2021 -expected exponent value, not 'character' +> expected exponent value, not 'character' + +## Remarks The character used as the exponent of a floating-point constant is not a valid number. Be sure to use an exponent that is in range. -## Examples +## Example -The following sample generates C2021: +The following example generates C2021: ```cpp // C2021.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2022.md b/docs/error-messages/compiler-errors-1/compiler-error-c2022.md index a072ce76c29..619c126d667 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2022.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2022.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Compiler Error C2022" title: "Compiler Error C2022" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2022" +ms.date: 11/04/2016 f1_keywords: ["C2022"] helpviewer_keywords: ["C2022"] -ms.assetid: 1f5c477a-d909-42d8-8588-811586e8ba1e --- # Compiler Error C2022 -'number' : too big for character +> 'number' : too big for character + +## Remarks The octal number following a backslash (\\) in a character or string constant is too big to represent a character. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2023.md b/docs/error-messages/compiler-errors-1/compiler-error-c2023.md index ab9dba93d82..8ddc41ef919 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2023.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2023.md @@ -1,6 +1,6 @@ --- -description: "Learn more about: Compiler Error C2023" title: "Compiler Error C2023" +description: "Learn more about: Compiler Error C2023" ms.date: 08/18/2022 f1_keywords: ["C2023"] helpviewer_keywords: ["C2023"] @@ -9,11 +9,15 @@ helpviewer_keywords: ["C2023"] > '*identifier*': Alignment (*value-1*) different from prior declaration (*value-2*) +## Remarks + The compiler found an alignment specifier for a class type that's different from a previous declaration, or an **`enum`** alignment specifier that's different from the natural alignment of the base type. To resolve this error, make sure all declarations and definitions of the type use the same alignment value. -The following sample generates C2023: +## Example + +The following example generates C2023: ```cpp // C2023.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2024.md b/docs/error-messages/compiler-errors-1/compiler-error-c2024.md index fe0b5e057f3..89965f73fe6 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2024.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2024.md @@ -1,6 +1,6 @@ --- -description: "Learn more about: Compiler Error C2024" title: "Compiler Error C2024" +description: "Learn more about: Compiler Error C2024" ms.date: 08/18/2022 f1_keywords: ["C2024"] helpviewer_keywords: ["C2024"] @@ -9,11 +9,15 @@ helpviewer_keywords: ["C2024"] > 'alignas' attribute applies to variables, data members and tag types only +## Remarks + The compiler found an **`alignas`** specifier applied to a function or other type that can't be aligned. To resolve this error, remove the **`alignas`** specifier. -The following sample generates C2024: +## Example + +The following example generates C2024: ```cpp // C2024.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2025.md b/docs/error-messages/compiler-errors-1/compiler-error-c2025.md index 92c0e186ea0..edd6d5218cd 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2025.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2025.md @@ -1,6 +1,6 @@ --- -description: "Learn more about: Compiler Error C2025" title: "Compiler Error C2025" +description: "Learn more about: Compiler Error C2025" ms.date: 08/18/2022 f1_keywords: ["C2025"] helpviewer_keywords: ["C2025"] @@ -9,6 +9,8 @@ helpviewer_keywords: ["C2025"] > invalid or corrupted binary module interface file: '*filename*' +## Remarks + The compiler could not read the specified IFC file. To resolve this error, rebuild the module interface file. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2026.md b/docs/error-messages/compiler-errors-1/compiler-error-c2026.md index c04bbb7582e..0ebf596eb09 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2026.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2026.md @@ -4,16 +4,15 @@ description: "Describes Microsoft C/C++ compiler error C2026, its causes and how ms.date: 09/25/2020 f1_keywords: ["C2026"] helpviewer_keywords: ["C2026"] -ms.assetid: 8e64b6e1-b967-479b-be97-d12dc4a8e389 --- # Compiler Error C2026 > string too big, trailing characters truncated -The string was longer than the limit of 16380 single-byte characters. - ## Remarks +The string was longer than the limit of 16380 single-byte characters. + Before adjacent strings get concatenated, a string can't be longer than 16380 single-byte characters. A Unicode string of about one half this length would also generate this error. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2027.md b/docs/error-messages/compiler-errors-1/compiler-error-c2027.md index d824942cd4c..b99589dda0a 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2027.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2027.md @@ -1,20 +1,21 @@ --- -description: "Learn more about: Compiler Error C2027" title: "Compiler Error C2027" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2027" +ms.date: 11/04/2016 f1_keywords: ["C2027"] helpviewer_keywords: ["C2027"] -ms.assetid: a39150c0-ec04-45ec-934c-a838bfe76627 --- # Compiler Error C2027 -use of undefined type 'type' +> use of undefined type 'type' + +## Remarks A type cannot be used until it is defined. To resolve the error, be sure the type is fully defined before referencing it. ## Examples -The following sample generates C2027. +The following example generates C2027. ```cpp // C2027.cpp @@ -36,7 +37,7 @@ int main() { It is possible to declare a pointer to a declared but undefined type. But C++ does not allow a reference to an undefined type. -The following sample generates C2027. +The following example generates C2027. ```cpp // C2027_b.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2028.md b/docs/error-messages/compiler-errors-1/compiler-error-c2028.md index dbf89a234a8..d7adba707ec 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2028.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2028.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Compiler Error C2028" title: "Compiler Error C2028" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2028" +ms.date: 11/04/2016 f1_keywords: ["C2028"] helpviewer_keywords: ["C2028"] -ms.assetid: 4e92e944-8fce-4443-9baf-4411ad9bde70 --- # Compiler Error C2028 -struct/union member must be inside a struct/union +> struct/union member must be inside a struct/union + +## Remarks Structure or union members must be declared within the structure or union. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2030.md b/docs/error-messages/compiler-errors-1/compiler-error-c2030.md index 6f355444f85..e13728eaddb 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2030.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2030.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Error C2030" title: "Compiler Error C2030" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2030" +ms.date: 11/04/2016 f1_keywords: ["C2030"] helpviewer_keywords: ["C2030"] -ms.assetid: 5806cead-64df-4eff-92de-52c9a3f5ee62 --- # Compiler Error C2030 -a destructor with 'protected private' accessibility cannot be a member of a class declared 'sealed' +> a destructor with 'protected private' accessibility cannot be a member of a class declared 'sealed' + +## Remarks A Windows Runtime class declared as **`sealed`** cannot have a protected private destructor. Only public virtual and private non-virtual destructors are allowed on sealed types. For more information, see [Ref classes and structs](../../cppcx/ref-classes-and-structs-c-cx.md). diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2031.md b/docs/error-messages/compiler-errors-1/compiler-error-c2031.md index 737fec97896..f6ef1fa4815 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2031.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2031.md @@ -1,6 +1,6 @@ --- -description: "Learn more about: Compiler Error C2031" title: "Compiler Error C2031" +description: "Learn more about: Compiler Error C2031" ms.date: 08/18/2022 f1_keywords: ["C2031"] helpviewer_keywords: ["C2031"] @@ -10,6 +10,8 @@ helpviewer_keywords: ["C2031"] > a virtual destructor with '*accessibility*' accessibility is not allowed for this type\ > a virtual destructor must have 'public' accessibility +## Remarks + A virtual Windows Runtime class has an access specifier or **`sealed`** specifier that's not allowed for a virtual destructor. For more information, see [Ref classes and structs](../../cppcx/ref-classes-and-structs-c-cx.md). To fix this error, change the accessibility of the destructor. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2032.md b/docs/error-messages/compiler-errors-1/compiler-error-c2032.md index 973fedfa7ab..e2ed2b78c27 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2032.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2032.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2032" title: "Compiler Error C2032" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2032" +ms.date: 11/04/2016 f1_keywords: ["C2032"] helpviewer_keywords: ["C2032"] -ms.assetid: 625d7c83-70b6-42c2-a558-81fbc0026324 --- # Compiler Error C2032 -'identifier' : function cannot be member of struct/union 'structorunion' +> 'identifier' : function cannot be member of struct/union 'structorunion' + +## Remarks The structure or union has a member function, which is allowed in C++ but not in C. To resolve the error, either compile as a C++ program or remove the member function. -The following sample generates C2032: +## Example + +The following example generates C2032: ```c // C2032.c diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2033.md b/docs/error-messages/compiler-errors-1/compiler-error-c2033.md index 767ad979198..110b499acd5 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2033.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2033.md @@ -1,32 +1,33 @@ --- -description: "Learn more about: Compiler Error C2033" title: "Compiler Error C2033" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2033" +ms.date: 09/10/2025 f1_keywords: ["C2033"] helpviewer_keywords: ["C2033"] -ms.assetid: fd5a1637-9db2-4c98-a7cc-b63b39737cd9 --- # Compiler Error C2033 -'identifier' : bit field cannot have indirection +> '*identifier*': bit field cannot have indirection -The bit field was declared as a pointer, which is not allowed. +## Remarks -The following sample generates C2033: +Bit fields can't be declared as a pointer, reference, or array. For more information, see [C++ Bit Fields](../../cpp/cpp-bit-fields.md). -```cpp -// C2033.cpp -struct S { - int *b : 1; // C2033 -}; -``` +## Example -Possible resolution: +The following example generates C2033: ```cpp -// C2033b.cpp +// C2033.cpp // compile with: /c -struct S { - int b : 1; + +struct S +{ + int* ptr : 1; // C2033 + int arr[3] : 1; // C2033 }; ``` + +## See also + +[Compiler Error C2531](../compiler-errors-2/compiler-error-c2531.md) diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2034.md b/docs/error-messages/compiler-errors-1/compiler-error-c2034.md index b512dc66b2b..1f988de2b4c 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2034.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2034.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2034" title: "Compiler Error C2034" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2034" +ms.date: 11/04/2016 f1_keywords: ["C2034"] helpviewer_keywords: ["C2034"] -ms.assetid: 953d70fa-bde9-4ce6-a55d-741e7bc63ff4 --- # Compiler Error C2034 -'identifier' : type of bit field too small for number of bits +> 'identifier' : type of bit field too small for number of bits + +## Remarks The number of bits in the bit-field declaration exceeds the size of the base type. -The following sample generates C2034: +## Example + +The following example generates C2034: ```cpp // C2034.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2035.md b/docs/error-messages/compiler-errors-1/compiler-error-c2035.md index 3b2f4c6fa85..8b4e5fe38b5 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2035.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2035.md @@ -1,6 +1,6 @@ --- -description: "Learn more about: Compiler Error C2035" title: "Compiler Error C2035" +description: "Learn more about: Compiler Error C2035" ms.date: 08/18/2022 f1_keywords: ["C2035"] helpviewer_keywords: ["C2035"] @@ -10,6 +10,8 @@ helpviewer_keywords: ["C2035"] > a non-virtual destructor with '*accessibility*' accessibility is not allowed for this type\ > a non-virtual destructor must have 'protected private' or 'private' accessibility +## Remarks + A non-virtual Windows Runtime class has an access specifier or **`sealed`** specifier that's not allowed for a non-virtual destructor. For more information, see [Ref classes and structs](../../cppcx/ref-classes-and-structs-c-cx.md). To fix this error, change the accessibility of the destructor. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2036.md b/docs/error-messages/compiler-errors-1/compiler-error-c2036.md index 92350e0b5b0..10f675360e0 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2036.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2036.md @@ -1,20 +1,21 @@ --- -description: "Learn more about: Compiler Error C2036" title: "Compiler Error C2036" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2036" +ms.date: 11/04/2016 f1_keywords: ["C2036"] helpviewer_keywords: ["C2036"] -ms.assetid: 895821a9-65d1-44b5-bde1-dae827f3e486 --- # Compiler Error C2036 -'identifier' : unknown size +> 'identifier' : unknown size + +## Remarks An operation on `identifier` requires the size of the data object, which cannot be determined. ## Examples -The following sample generates C2036. +The following example generates C2036. ```c // C2036.c @@ -29,7 +30,7 @@ int main() { } ``` -The following sample generates C2036. +The following example generates C2036. ```cpp // C2036_2.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2037.md b/docs/error-messages/compiler-errors-1/compiler-error-c2037.md index ad11cf2dc6a..04fffc4ba7b 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2037.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2037.md @@ -1,6 +1,6 @@ --- -description: "Learn more about: Compiler Error C2037" title: "Compiler Error C2037" +description: "Learn more about: Compiler Error C2037" ms.date: 08/18/2022 f1_keywords: ["C2037"] helpviewer_keywords: ["C2037"] @@ -9,6 +9,8 @@ helpviewer_keywords: ["C2037"] > left of '*operator*' specifies undefined struct/union '*type*' +## Remarks + The operand to the left of the member-selection *operator* is not a fully defined class, structure, or union. This error can be caused by a left operand that is an undefined variable. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2038.md b/docs/error-messages/compiler-errors-1/compiler-error-c2038.md index 8e7ffa2aa0e..4de865e57cd 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2038.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2038.md @@ -1,6 +1,6 @@ --- -description: "Learn more about: Compiler Error C2038" title: "Compiler Error C2038" +description: "Learn more about: Compiler Error C2038" ms.date: 08/18/2022 f1_keywords: ["C2038"] helpviewer_keywords: ["C2038"] @@ -9,6 +9,8 @@ helpviewer_keywords: ["C2038"] > the std namespace cannot be inline +## Remarks + The C++ standard does not allow the `std` namespace to be declared `inline`. To resolve this issue, remove the `inline` specifier. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2039.md b/docs/error-messages/compiler-errors-1/compiler-error-c2039.md index 02647583595..635d97226b9 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2039.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2039.md @@ -1,19 +1,21 @@ --- -description: "Learn more about: Compiler Error C2039" title: "Compiler Error C2039" -ms.date: "8/1/2023" +description: "Learn more about: Compiler Error C2039" +ms.date: 8/1/2023 f1_keywords: ["C2039"] helpviewer_keywords: ["C2039"] --- # Compiler Error C2039 -`'identifier1' : is not a member of 'identifier2'` +> 'identifier1' : is not a member of 'identifier2' + +## Remarks The code incorrectly calls or refers to a member of a structure, class, or union. ## Examples -The following sample generates C2039: +The following example generates C2039: ```cpp // C2039.cpp @@ -27,7 +29,7 @@ int main() { } ``` -The following sample generates C2039: +The following example generates C2039: ```cpp // C2039_b.cpp @@ -40,7 +42,7 @@ int main() { } ``` -The following sample generates C2039: +The following example generates C2039: ```cpp // C2039_c.cpp @@ -71,7 +73,7 @@ public class B { }; ``` -The following sample generates C2039 when it uses the previously defined C# component's default indexer incorrectly from C++/CLI: +The following example generates C2039 when it uses the previously defined C# component's default indexer incorrectly from C++/CLI: ```cpp // C2039_e.cpp @@ -88,7 +90,7 @@ int main() { } ``` -C2039 can also occur if you use generics. The following sample generates C2039: +C2039 can also occur if you use generics. The following example generates C2039: ```cpp // C2039_f.cpp @@ -113,7 +115,7 @@ int main() { C2039 can occur when you try to release managed or unmanaged resources. For more information, see [Destructors and finalizers](../../dotnet/how-to-define-and-consume-classes-and-structs-cpp-cli.md#BKMK_Destructors_and_finalizers). -The following sample generates C2039: +The following example generates C2039: ```cpp // C2039_g.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2040.md b/docs/error-messages/compiler-errors-1/compiler-error-c2040.md index 76c71d13bbf..ba66506a83d 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2040.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2040.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2040" title: "Compiler Error C2040" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2040" +ms.date: 11/04/2016 f1_keywords: ["C2040"] helpviewer_keywords: ["C2040"] -ms.assetid: 74ca3592-1469-4965-ab34-a4815e2fbefe --- # Compiler Error C2040 -'operator' : 'identifier1' differs in levels of indirection from 'identifier2' +> 'operator' : 'identifier1' differs in levels of indirection from 'identifier2' + +## Remarks An expression involving the specified operands has incompatible operand types or implicitly converted operand types. If both operands are arithmetic, or both are nonarithmetic (such as array or pointer), they are used without change. If one operand is arithmetic and the other is not, the arithmetic operand is converted to the type of the nonarithmetic operand. -This sample generates C2040 and shows how to fix it. +## Example + +This example generates C2040 and shows how to fix it. ```cpp // C2040.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2041.md b/docs/error-messages/compiler-errors-1/compiler-error-c2041.md index e78711fd216..fd9ffaba7a9 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2041.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2041.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2041" title: "Compiler Error C2041" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2041" +ms.date: 11/04/2016 f1_keywords: ["C2041"] helpviewer_keywords: ["C2041"] -ms.assetid: c9a33bb1-f9cf-47d6-bd21-7d867a8c37d5 --- # Compiler Error C2041 -illegal digit 'character' for base 'number' +> illegal digit 'character' for base 'number' + +## Remarks The specified character is not a valid digit for the base (such as octal or hex). -The following sample generates C2041: +## Example + +The following example generates C2041: ```cpp // C2041.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2042.md b/docs/error-messages/compiler-errors-1/compiler-error-c2042.md index a29490360b5..514b99958e3 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2042.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2042.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2042" title: "Compiler Error C2042" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2042" +ms.date: 11/04/2016 f1_keywords: ["C2042"] helpviewer_keywords: ["C2042"] -ms.assetid: e111788f-41ce-405a-9824-a4c1c26059e6 --- # Compiler Error C2042 -signed/unsigned keywords mutually exclusive +> signed/unsigned keywords mutually exclusive + +## Remarks The keywords **`signed`** and **`unsigned`** are used in a single declaration. -The following sample generates C2042: +## Example + +The following example generates C2042: ```cpp // C2042.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2043.md b/docs/error-messages/compiler-errors-1/compiler-error-c2043.md index 0ef748d8218..5cc6bae8010 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2043.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2043.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Compiler Error C2043" title: "Compiler Error C2043" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2043" +ms.date: 11/04/2016 f1_keywords: ["C2043"] helpviewer_keywords: ["C2043"] -ms.assetid: 6cc829f3-c6ea-43ae-8a3f-303ecf6c7dc6 --- # Compiler Error C2043 -illegal break +> illegal break + +## Remarks A [break](../../cpp/break-statement-cpp.md) is legal only within a **`do`**, **`for`**, **`while`**, or **`switch`** statement. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2044.md b/docs/error-messages/compiler-errors-1/compiler-error-c2044.md index 12ec3d94b6f..5bb88a790e1 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2044.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2044.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Compiler Error C2044" title: "Compiler Error C2044" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2044" +ms.date: 11/04/2016 f1_keywords: ["C2044"] helpviewer_keywords: ["C2044"] -ms.assetid: adf4bedc-f915-4008-8b48-a06d626d8c38 --- # Compiler Error C2044 -illegal continue +> illegal continue + +## Remarks A [continue](../../cpp/continue-statement-cpp.md) is legal only within a **`do`**, **`for`**, or **`while`** statement. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2045.md b/docs/error-messages/compiler-errors-1/compiler-error-c2045.md index a694941e73a..dd805a57e02 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2045.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2045.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2045" title: "Compiler Error C2045" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2045" +ms.date: 11/04/2016 f1_keywords: ["C2045"] helpviewer_keywords: ["C2045"] -ms.assetid: 2fca668e-9b20-4933-987a-18c0fd0187df --- # Compiler Error C2045 -'identifier' : label redefined +> 'identifier' : label redefined + +## Remarks The label appears before multiple statements in the same function. -The following sample generates C2045: +## Example + +The following example generates C2045: ```cpp // C2045.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2046.md b/docs/error-messages/compiler-errors-1/compiler-error-c2046.md index 1fc5235d5d4..7831da647a4 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2046.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2046.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2046" title: "Compiler Error C2046" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2046" +ms.date: 11/04/2016 f1_keywords: ["C2046"] helpviewer_keywords: ["C2046"] -ms.assetid: f0c8f9dd-dbd7-4c4a-8838-fde54208ec71 --- # Compiler Error C2046 -illegal case +> illegal case + +## Remarks The keyword `case` can appear only in a **`switch`** statement. -The following sample generates C2046: +## Example + +The following example generates C2046: ```cpp // C2046.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2047.md b/docs/error-messages/compiler-errors-1/compiler-error-c2047.md index 57ec7a835df..51b7b6470fc 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2047.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2047.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2047" title: "Compiler Error C2047" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2047" +ms.date: 11/04/2016 f1_keywords: ["C2047"] helpviewer_keywords: ["C2047"] -ms.assetid: 686a5a81-3857-4753-84a0-5c2e7149cbee --- # Compiler Error C2047 -illegal default +> illegal default + +## Remarks The keyword **`default`** can appear only in a **`switch`** statement. -The following sample generates C2047: +## Example + +The following example generates C2047: ```cpp // C2047.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2048.md b/docs/error-messages/compiler-errors-1/compiler-error-c2048.md index d424fe39c4b..11ef98ecba7 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2048.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2048.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2048" title: "Compiler Error C2048" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2048" +ms.date: 11/04/2016 f1_keywords: ["C2048"] helpviewer_keywords: ["C2048"] -ms.assetid: 44704726-85fc-42f0-afb9-194df8c4ca7c --- # Compiler Error C2048 -more than one default +> more than one default + +## Remarks A **`switch`** statement contains multiple **`default`** labels. Delete one of the **`default`** labels to resolve the error. -The following sample generates C2048: +## Example + +The following example generates C2048: ```cpp // C2048.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2049.md b/docs/error-messages/compiler-errors-1/compiler-error-c2049.md index cc707acda14..efcbb0ca4fd 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2049.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2049.md @@ -1,6 +1,6 @@ --- -description: "Learn more about: Compiler Error C2049" title: "Compiler Error C2049" +description: "Learn more about: Compiler Error C2049" ms.date: 08/18/2022 f1_keywords: ["C2049"] helpviewer_keywords: ["C2049"] @@ -9,11 +9,15 @@ helpviewer_keywords: ["C2049"] > '*namespace-name*': non-inline namespace cannot be reopened as inline +## Remarks + The **`inline`** keyword may be used on a namespace definition extension only if it was also used on the original namespace definition. To resolve this issue, make the use of the **`inline`** specifier consistent across all parts of the namespace. -The following sample generates C2049: +## Example + +The following example generates C2049: ```cpp // C2049.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2050.md b/docs/error-messages/compiler-errors-1/compiler-error-c2050.md index a1815f9b37c..962b523cf2c 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2050.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2050.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2050" title: "Compiler Error C2050" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2050" +ms.date: 11/04/2016 f1_keywords: ["C2050"] helpviewer_keywords: ["C2050"] -ms.assetid: 66aaed7d-00db-4ce1-a9d6-4447c1cf07ce --- # Compiler Error C2050 -switch expression not integral +> switch expression not integral + +## Remarks The **`switch`** expression evaluates to a noninteger value. To resolve the error, use only integral values in switch statements. -The following sample generates C2050: +## Example + +The following example generates C2050: ```cpp // C2050.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2051.md b/docs/error-messages/compiler-errors-1/compiler-error-c2051.md index b7a5383002d..1437749339b 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2051.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2051.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2051" title: "Compiler Error C2051" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2051" +ms.date: 11/04/2016 f1_keywords: ["C2051"] helpviewer_keywords: ["C2051"] -ms.assetid: 81c0469a-78e2-49fa-bd76-97cdb135e3ea --- # Compiler Error C2051 -case expression not constant +> case expression not constant + +## Remarks Case expressions must be integer constants. -The following sample generates C2051: +## Example + +The following example generates C2051: ```cpp // C2051.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2052.md b/docs/error-messages/compiler-errors-1/compiler-error-c2052.md index a32b58543ea..4a0693ce3e8 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2052.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2052.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2052" title: "Compiler Error C2052" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2052" +ms.date: 11/04/2016 f1_keywords: ["C2052"] helpviewer_keywords: ["C2052"] -ms.assetid: 922ca43b-b64b-4ef7-9611-c7313be3fd79 --- # Compiler Error C2052 -'type' : illegal type for case expression +> 'type' : illegal type for case expression + +## Remarks Case expressions must be integer constants. -The following sample generates C2052: +## Example + +The following example generates C2052: ```cpp // C2052.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2053.md b/docs/error-messages/compiler-errors-1/compiler-error-c2053.md index bc6087a46ee..8a61e880a57 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2053.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2053.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2053" title: "Compiler Error C2053" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2053" +ms.date: 11/04/2016 f1_keywords: ["C2053"] helpviewer_keywords: ["C2053"] -ms.assetid: 13324c85-13a8-4996-bd42-a31bfe7ff80f --- # Compiler Error C2053 -'identifier' : wide string mismatch +> 'identifier' : wide string mismatch + +## Remarks The wide string is assigned to an incompatible type. -The following sample generates C2053: +## Example + +The following example generates C2053: ```c // C2053.c diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2054.md b/docs/error-messages/compiler-errors-1/compiler-error-c2054.md index d3cbf892c7c..58ec5aff223 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2054.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2054.md @@ -1,20 +1,23 @@ --- -description: "Learn more about: Compiler Error C2054" title: "Compiler Error C2054" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2054" +ms.date: 11/04/2016 f1_keywords: ["C2054"] helpviewer_keywords: ["C2054"] -ms.assetid: 37f7c612-0d7d-4728-9e67-ac4160555f48 --- # Compiler Error C2054 -expected '(' to follow 'identifier' +> expected '(' to follow 'identifier' + +## Remarks The function identifier is used in a context that requires trailing parentheses. This error can be caused by omitting an equal sign (=) on a complex initialization. -The following sample generates C2054: +## Example + +The following example generates C2054: ```c // C2054.c diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2055.md b/docs/error-messages/compiler-errors-1/compiler-error-c2055.md index 1654921d893..c382074bc57 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2055.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2055.md @@ -1,6 +1,6 @@ --- -description: "Learn more about: Microsoft Visual C++ compiler error C2055" title: "Compiler error C2055" +description: "Learn more about: Microsoft Visual C++ compiler error C2055" ms.date: 06/10/2024 f1_keywords: ["C2055"] helpviewer_keywords: ["C2055"] @@ -9,11 +9,15 @@ helpviewer_keywords: ["C2055"] > expected formal parameter list, not a type list +## Remarks + A function definition contains a parameter type list instead of a formal parameter list. ANSI C requires formal parameters to be named unless they're `void` or an ellipsis (`...`). An example of a named formal parameter is the `int i` in `void func(int i)`.\ A parameter type list is a list of types, for example, `int, char`. +## Example + The following code generates error `C2055`: ```c diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2056.md b/docs/error-messages/compiler-errors-1/compiler-error-c2056.md index f29b08129a9..2aca685be38 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2056.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2056.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Compiler Error C2056" title: "Compiler Error C2056" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2056" +ms.date: 11/04/2016 f1_keywords: ["C2056"] helpviewer_keywords: ["C2056"] -ms.assetid: 043a1f72-738a-487f-b7b3-055cc5ca0ae7 --- # Compiler Error C2056 -illegal expression +> illegal expression + +## Remarks An expression was invalid because of a previous error. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2057.md b/docs/error-messages/compiler-errors-1/compiler-error-c2057.md index 41049e9a070..eefd54c1e9d 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2057.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2057.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Error C2057" title: "Compiler Error C2057" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2057" +ms.date: 11/04/2016 f1_keywords: ["C2057"] helpviewer_keywords: ["C2057"] -ms.assetid: 038a99d6-1f5a-42fa-8449-03b4ff11ee0b --- # Compiler Error C2057 -expected constant expression +> expected constant expression + +## Remarks The context requires a constant expression, an expression whose value is known at compile time. @@ -16,7 +17,7 @@ The compiler must know the size of a type at compile time in order to allocate s ## Examples -The following sample generates C2057 and shows how to fix it: +The following example generates C2057 and shows how to fix it: ```cpp // C2057.cpp @@ -28,7 +29,7 @@ int main() { } ``` -C has more restrictive rules for constant expressions. The following sample generates C2057 and shows how to fix it: +C has more restrictive rules for constant expressions. The following example generates C2057 and shows how to fix it: ```c // C2057b.c diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2058.md b/docs/error-messages/compiler-errors-1/compiler-error-c2058.md index 4910bb4b71e..04aa6b3c5ac 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2058.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2058.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2058" title: "Compiler Error C2058" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2058" +ms.date: 11/04/2016 f1_keywords: ["C2058"] helpviewer_keywords: ["C2058"] -ms.assetid: 81e08e6b-15f7-41b4-980a-53763e19990c --- # Compiler Error C2058 -constant expression is not integral +> constant expression is not integral + +## Remarks The context requires an integer constant expression. -The following sample generates C2058: +## Example + +The following example generates C2058: ```cpp // C2058.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2059.md b/docs/error-messages/compiler-errors-1/compiler-error-c2059.md index 61b19f215fd..b575bf8b277 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2059.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2059.md @@ -1,17 +1,20 @@ --- -description: "Learn more about: Compiler Error C2059" title: "Compiler Error C2059" -ms.date: "03/26/2019" +description: "Learn more about: Compiler Error C2059" +ms.date: 03/26/2019 f1_keywords: ["C2059"] helpviewer_keywords: ["C2059"] -ms.assetid: 2be4eb39-3f37-4b32-8e8d-75835e07c78a --- # Compiler Error C2059 -syntax error : 'token' +> syntax error : 'token' + +## Remarks The token caused a syntax error. +## Examples + The following example generates an error message for the line that declares `j`. ```cpp @@ -73,7 +76,7 @@ void func(ag_type arg = ag_type(5, 7.0)); // OK C2059 can occur for an ill-formed cast. -The following sample generates C2059: +The following example generates C2059: ```cpp // C2059c.cpp @@ -91,7 +94,7 @@ int main() { C2059 can also occur if you attempt to create a namespace name that contains a period. -The following sample generates C2059: +The following example generates C2059: ```cpp // C2059d.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2060.md b/docs/error-messages/compiler-errors-1/compiler-error-c2060.md index a6cfa82a76c..19ef4398bbc 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2060.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2060.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Compiler Error C2060" title: "Compiler Error C2060" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2060" +ms.date: 11/04/2016 f1_keywords: ["C2060"] helpviewer_keywords: ["C2060"] -ms.assetid: 2572deba-cc12-464e-9162-86252a3af061 --- # Compiler Error C2060 -syntax error : end of file found +> syntax error : end of file found + +## Remarks At least one more token was expected. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2061.md b/docs/error-messages/compiler-errors-1/compiler-error-c2061.md index 2af16ddaeec..83394157a63 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2061.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2061.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Error C2061" title: "Compiler Error C2061" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2061" +ms.date: 11/04/2016 f1_keywords: ["C2061"] helpviewer_keywords: ["C2061"] -ms.assetid: b0e61c0c-a205-4820-b9aa-301d6c6fe6eb --- # Compiler Error C2061 -syntax error : identifier 'identifier' +> syntax error : identifier 'identifier' + +## Remarks The compiler found an identifier where it wasn't expected. Make sure that `identifier` is declared before you use it. @@ -16,7 +17,9 @@ An initializer may be enclosed by parentheses. To avoid this problem, enclose th This error could also be caused when the compiler detects an expression as a class template argument; use [typename](../../cpp/typename.md) to tell the compiler it is a type, as shown in the following example: -The following sample generates C2061: +## Examples + +The following example generates C2061: ```cpp // C2061.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2062.md b/docs/error-messages/compiler-errors-1/compiler-error-c2062.md index 331da15078f..b7cd52a817f 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2062.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2062.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2062" title: "Compiler Error C2062" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2062" +ms.date: 11/04/2016 f1_keywords: ["C2062"] helpviewer_keywords: ["C2062"] -ms.assetid: 6cc98353-2ddf-43ab-88a2-9cc91cdd6033 --- # Compiler Error C2062 -type 'type' unexpected +> type 'type' unexpected + +## Remarks The compiler did not expect a type name. -The following sample generates C2062: +## Example + +The following example generates C2062: ```cpp // C2062.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2063.md b/docs/error-messages/compiler-errors-1/compiler-error-c2063.md index 6bb9d67d1c7..474aaa30fc7 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2063.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2063.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2063" title: "Compiler Error C2063" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2063" +ms.date: 11/04/2016 f1_keywords: ["C2063"] helpviewer_keywords: ["C2063"] -ms.assetid: 0a90c18f-4029-416a-9128-e8713b53e6f1 --- # Compiler Error C2063 -'identifier' : not a function +> 'identifier' : not a function + +## Remarks The identifier is used as a function but not declared as a function. -The following sample generates C2063: +## Example + +The following example generates C2063: ```c // C2063.c diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2064.md b/docs/error-messages/compiler-errors-1/compiler-error-c2064.md index 6d92b1ba307..2714aee760d 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2064.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2064.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2064" title: "Compiler Error C2064" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2064" +ms.date: 11/04/2016 f1_keywords: ["C2064"] helpviewer_keywords: ["C2064"] -ms.assetid: 6cda05da-f437-4f50-9813-ae69538713a3 --- # Compiler Error C2064 -term does not evaluate to a function taking N arguments +> term does not evaluate to a function taking N arguments + +## Remarks A call is made to a function through an expression. The expression does not evaluate to a pointer to a function that takes the specified number of arguments. -In this example, the code attempts to call non-functions as functions. The following sample generates C2064: +## Examples + +In this example, the code attempts to call non-functions as functions. The following example generates C2064: ```cpp // C2064.cpp @@ -24,7 +27,7 @@ void func() { } ``` -You must call pointers to non-static member functions from the context of an object instance. The following sample generates C2064, and shows how to fix it: +You must call pointers to non-static member functions from the context of an object instance. The following example generates C2064, and shows how to fix it: ```cpp // C2064b.cpp @@ -43,7 +46,7 @@ int main() { } ``` -Within a class, member function pointers must also indicate the calling object context. The following sample generates C2064 and shows how to fix it: +Within a class, member function pointers must also indicate the calling object context. The following example generates C2064 and shows how to fix it: ```cpp // C2064d.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2065.md b/docs/error-messages/compiler-errors-1/compiler-error-c2065.md index e18d5004506..9081a6fe978 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2065.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2065.md @@ -1,15 +1,16 @@ --- -description: "Learn more about: Compiler Error C2065" title: "Compiler Error C2065" +description: "Learn more about: Compiler Error C2065" ms.date: 06/29/2022 f1_keywords: ["C2065"] helpviewer_keywords: ["C2065"] -ms.assetid: 78093376-acb7-45f5-9323-5ed7e0aab1dc --- # Compiler Error C2065 > '*identifier*' : undeclared identifier +## Remarks + The compiler can't find the declaration for an identifier. There are many possible causes for this error. The most common causes of C2065 are that the identifier hasn't been declared, the identifier is misspelled, the header where the identifier is declared isn't included in the file, or the identifier is missing a scope qualifier, for example, `cout` instead of `std::cout`. For more information on declarations in C++, see [Declarations and Definitions (C++)](../../cpp/declarations-and-definitions-cpp.md). Here are some common issues and solutions in greater detail. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2066.md b/docs/error-messages/compiler-errors-1/compiler-error-c2066.md index 8a0b42ca727..a55f64b22f2 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2066.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2066.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Compiler Error C2066" title: "Compiler Error C2066" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2066" +ms.date: 11/04/2016 f1_keywords: ["C2066"] helpviewer_keywords: ["C2066"] -ms.assetid: f1efc63f-948a-410b-bf6e-ba250d52cd38 --- # Compiler Error C2066 -cast to function type is illegal +> cast to function type is illegal + +## Remarks In ANSI C, it is not legal to cast between a function pointer and a data pointer. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2067.md b/docs/error-messages/compiler-errors-1/compiler-error-c2067.md index e5e1e4ab588..892535c0560 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2067.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2067.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Compiler Error C2067" title: "Compiler Error C2067" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2067" +ms.date: 11/04/2016 f1_keywords: ["C2067"] helpviewer_keywords: ["C2067"] -ms.assetid: 97cab473-a713-489f-8536-ca2cc5792b8c --- # Compiler Error C2067 -cast to array type is illegal +> cast to array type is illegal + +## Remarks An object was cast to an array type. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2068.md b/docs/error-messages/compiler-errors-1/compiler-error-c2068.md index 71ed5cd042d..9f31bb8a1d3 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2068.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2068.md @@ -1,6 +1,6 @@ --- -description: "Learn more about: Compiler Error C2068" title: "Compiler Error C2068" +description: "Learn more about: Compiler Error C2068" ms.date: 08/18/2022 f1_keywords: ["C2068"] helpviewer_keywords: ["C2068"] @@ -9,8 +9,12 @@ helpviewer_keywords: ["C2068"] > illegal use of overloaded function. Missing argument list? +## Remarks + The compiler detected the invalid use of an overloaded function with no arguments. +## Example + For example: ```cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2069.md b/docs/error-messages/compiler-errors-1/compiler-error-c2069.md index f0170cb6ac3..ba2b9bea9a2 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2069.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2069.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Compiler Error C2069" title: "Compiler Error C2069" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2069" +ms.date: 11/04/2016 f1_keywords: ["C2069"] helpviewer_keywords: ["C2069"] -ms.assetid: 0c87445a-9eed-4917-a733-f08217f2d64d --- # Compiler Error C2069 -cast of 'void' term to non-'void' +> cast of 'void' term to non-'void' + +## Remarks Type **`void`** cannot be cast to any other type. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2070.md b/docs/error-messages/compiler-errors-1/compiler-error-c2070.md index 76cac0d4b89..2d2828762f2 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2070.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2070.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2070" title: "Compiler Error C2070" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2070" +ms.date: 11/04/2016 f1_keywords: ["C2070"] helpviewer_keywords: ["C2070"] -ms.assetid: 4c8dea63-1227-4aba-be26-2462537f86fb --- # Compiler Error C2070 -'type': illegal sizeof operand +> 'type': illegal sizeof operand + +## Remarks The [sizeof](../../cpp/sizeof-operator.md) operator requires an expression or type name. -The following sample generates C2070: +## Example + +The following example generates C2070: ```cpp // C2070.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2071.md b/docs/error-messages/compiler-errors-1/compiler-error-c2071.md index 1bfd7926e5f..40faec7cb70 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2071.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2071.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Error C2071" title: "Compiler Error C2071" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2071" +ms.date: 11/04/2016 f1_keywords: ["C2071"] helpviewer_keywords: ["C2071"] -ms.assetid: f8c09255-a5c4-47e3-8089-3d875ae43cc5 --- # Compiler Error C2071 -'identifier' : illegal storage class +> 'identifier' : illegal storage class + +## Remarks `identifier` was declared with an invalid [storage class](../../c-language/c-storage-classes.md). This error can be caused when more than one storage class is specified for an identifier, or when the definition is incompatible with the storage class declaration. @@ -16,7 +17,7 @@ To fix this issue, understand the intended storage class of the identifier—for ## Examples -The following sample generates C2071. +The following example generates C2071. ```cpp // C2071.cpp @@ -29,7 +30,7 @@ struct D { }; ``` -The following sample generates C2071. +The following example generates C2071. ```cpp // C2071_b.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2072.md b/docs/error-messages/compiler-errors-1/compiler-error-c2072.md index 027a73b4a2f..479dfaf4317 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2072.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2072.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Compiler Error C2072" title: "Compiler Error C2072" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2072" +ms.date: 11/04/2016 f1_keywords: ["C2072"] helpviewer_keywords: ["C2072"] -ms.assetid: 0b19a847-61dd-4bc3-b54d-108a637a4424 --- # Compiler Error C2072 -'identifier' : initialization of a function +> 'identifier' : initialization of a function + +## Remarks A function initializer was specified incorrectly. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2073.md b/docs/error-messages/compiler-errors-1/compiler-error-c2073.md index c790ea0ffbe..3db2c03db5e 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2073.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2073.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2073" title: "Compiler Error C2073" +description: "Learn more about: Compiler Error C2073" ms.date: 06/29/2022 f1_keywords: ["C2073"] helpviewer_keywords: ["C2073"] -ms.assetid: 57908234-be7a-4ce9-b0a7-8b1ad621865e --- # Compiler Error C2073 @@ -18,7 +17,7 @@ This compiler error is obsolete in Visual Studio 2022. ## Example -The following sample generates C2073. Source file `C2073.cpp`: +The following example generates C2073. Source file `C2073.cpp`: ```cpp // C2073.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2074.md b/docs/error-messages/compiler-errors-1/compiler-error-c2074.md index 0e2f7f6326e..8221fccd282 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2074.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2074.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Compiler Error C2074" title: "Compiler Error C2074" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2074" +ms.date: 11/04/2016 f1_keywords: ["C2074"] helpviewer_keywords: ["C2074"] -ms.assetid: 1abe5934-61db-4374-8c48-1fa7281317f4 --- # Compiler Error C2074 -'identifier' : 'class-key' initialization needs curly braces +> 'identifier' : 'class-key' initialization needs curly braces + +## Remarks There were no curly braces around the specified class, structure, or union initializer. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2075.md b/docs/error-messages/compiler-errors-1/compiler-error-c2075.md index b83c31b4f74..8e47b3cd00e 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2075.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2075.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2075" title: "Compiler Error C2075" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2075" +ms.date: 11/04/2016 f1_keywords: ["C2075"] helpviewer_keywords: ["C2075"] -ms.assetid: 8b1865d2-540b-4117-b982-e7a58a0b6cf7 --- # Compiler Error C2075 -'identifier' : array initialization needs curly braces +> 'identifier' : array initialization needs curly braces + +## Remarks There were no curly braces around the specified array initializer. -The following sample generates C2075: +## Example + +The following example generates C2075: ```c // C2075.c diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2076.md b/docs/error-messages/compiler-errors-1/compiler-error-c2076.md index bd3b76f5c71..e20e53b4fa6 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2076.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2076.md @@ -1,6 +1,6 @@ --- -description: "Learn more about: Compiler Error C2076" title: "Compiler Error C2076" +description: "Learn more about: Compiler Error C2076" ms.date: 08/18/2022 f1_keywords: ["C2076"] helpviewer_keywords: ["C2076"] @@ -9,6 +9,8 @@ helpviewer_keywords: ["C2076"] > a brace-enclosed initializer list cannot be used in a new-expression whose type contains 'auto/decltype(auto)' +## Remarks + If an **`auto`** type-specifier appears in the specifier sequence of a new type-identifier or the type-identifier of a **`new`** expression, the expression must contain an initializer of the form `( assignment-expression )`. The compiler deduces the type-identifier from the `assignment-expression` in the initializer. For example, ```cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2077.md b/docs/error-messages/compiler-errors-1/compiler-error-c2077.md index 824efd91f1f..720cf2cbf39 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2077.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2077.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Compiler Error C2077" title: "Compiler Error C2077" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2077" +ms.date: 11/04/2016 f1_keywords: ["C2077"] helpviewer_keywords: ["C2077"] -ms.assetid: f046f0e3-1987-477a-a0af-fe543a9f5fcb --- # Compiler Error C2077 -non-scalar field initializer 'identifier' +> non-scalar field initializer 'identifier' + +## Remarks You tried to initialize a bit field with a nonscalar (struct, union, array, or class). Use an integer or floating-point value. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2078.md b/docs/error-messages/compiler-errors-1/compiler-error-c2078.md index 6cc3e1e1fe2..f2c6dfa626d 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2078.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2078.md @@ -1,20 +1,23 @@ --- -description: "Learn more about: Compiler Error C2078" title: "Compiler Error C2078" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2078" +ms.date: 11/04/2016 f1_keywords: ["C2078"] helpviewer_keywords: ["C2078"] -ms.assetid: 9bead850-4123-46cf-a634-5c77ba974b2b --- # Compiler Error C2078 -too many initializers +> too many initializers + +## Remarks The number of initializers exceeds the number of objects to be initialized. The compiler can deduce the correct assignment of initializers to objects and inner objects when inner braces are elided from the initializer list. Complete bracing also eliminates ambiguity and results in correct assignment. Partial bracing can cause C2078 because of ambiguity in the assignment of initializers to objects. -The following sample generates C2078 and shows how to fix it: +## Example + +The following example generates C2078 and shows how to fix it: ```cpp // C2078.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2079.md b/docs/error-messages/compiler-errors-1/compiler-error-c2079.md index c096d8ffb12..b4b8022579d 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2079.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2079.md @@ -1,20 +1,23 @@ --- -description: "Learn more about: Compiler Error C2079" title: "Compiler Error C2079" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2079" +ms.date: 11/04/2016 f1_keywords: ["C2079"] helpviewer_keywords: ["C2079"] -ms.assetid: ca58d6d5-eccd-40b7-ba14-c003223c5bc7 --- # Compiler Error C2079 -'identifier' uses undefined class/struct/union 'name' +> 'identifier' uses undefined class/struct/union 'name' + +## Remarks The specified identifier is an undefined class, structure, or union. This error can be caused by initializing an anonymous union. -The following sample generates C2079: +## Examples + +The following example generates C2079: ```cpp // C2079.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2080.md b/docs/error-messages/compiler-errors-1/compiler-error-c2080.md index 26fa529539c..43be41f7b5d 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2080.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2080.md @@ -1,6 +1,6 @@ --- -description: "Learn more about: Compiler Error C2080" title: "Compiler Error C2080" +description: "Learn more about: Compiler Error C2080" ms.date: 08/18/2022 f1_keywords: ["C2080"] helpviewer_keywords: ["C2080"] @@ -15,7 +15,7 @@ The compiler can only deduce the type for `auto` or `decltype(auto)` if the decl ## Example -The following sample shows some declarations that cause C2080: +The following example shows some declarations that cause C2080: ```cpp auto x1(1, 2); // C2080 diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2081.md b/docs/error-messages/compiler-errors-1/compiler-error-c2081.md index 39c5c3f2863..91f785dfd40 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2081.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2081.md @@ -1,20 +1,23 @@ --- -description: "Learn more about: Compiler Error C2081" title: "Compiler Error C2081" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2081" +ms.date: 11/04/2016 f1_keywords: ["C2081"] helpviewer_keywords: ["C2081"] -ms.assetid: 7db9892d-364d-4178-a49d-f8398ece09a0 --- # Compiler Error C2081 -'identifier' : name in formal parameter list illegal +> 'identifier' : name in formal parameter list illegal + +## Remarks The identifier caused a syntax error. This error can be caused by using the old style for the formal parameter list. You must specify the type of formal parameters in the formal parameter list. -The following sample generates C2081: +## Example + +The following example generates C2081: ```c // C2081.c diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2082.md b/docs/error-messages/compiler-errors-1/compiler-error-c2082.md index e5a420137b4..205cdfdc0e3 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2082.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2082.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2082" title: "Compiler Error C2082" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2082" +ms.date: 11/04/2016 f1_keywords: ["C2082"] helpviewer_keywords: ["C2082"] -ms.assetid: 87a6d442-157c-46e8-9bff-8388f8338ae0 --- # Compiler Error C2082 -redefinition of formal parameter 'identifier' +> redefinition of formal parameter 'identifier' + +## Remarks A formal parameter to a function is redeclared within the function body. To resolve the error, remove the redefinition. -The following sample generates C2082: +## Example + +The following example generates C2082: ```cpp // C2082.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2083.md b/docs/error-messages/compiler-errors-1/compiler-error-c2083.md index a3e24730c9d..c47d0828db9 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2083.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2083.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Compiler Error C2083" title: "Compiler Error C2083" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2083" +ms.date: 11/04/2016 f1_keywords: ["C2083"] helpviewer_keywords: ["C2083"] -ms.assetid: 5fc4f931-eab6-4d8d-a3ee-3b8e11e64b18 --- # Compiler Error C2083 -struct/union comparison illegal +> struct/union comparison illegal + +## Remarks A structure or union is compared directly with another user-defined type. This is not allowed unless a comparison operator has been defined or a conversion to a scalar type exists. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2084.md b/docs/error-messages/compiler-errors-1/compiler-error-c2084.md index 19f1c11e732..8133c53ace2 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2084.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2084.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Error C2084" title: "Compiler Error C2084" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2084" +ms.date: 11/04/2016 f1_keywords: ["C2084"] helpviewer_keywords: ["C2084"] -ms.assetid: 990b107f-3721-4851-ae8b-4b69a8c149ed --- # Compiler Error C2084 -function '*function*' already has a body +> function '*function*' already has a body + +## Remarks The function has already been defined. @@ -20,7 +21,7 @@ Before Visual Studio 2002, ## Example -The following sample generates C2084: +The following example generates C2084: ```cpp // C2084.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2085.md b/docs/error-messages/compiler-errors-1/compiler-error-c2085.md index fcd890fb8ec..ab918561c43 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2085.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2085.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2085" title: "Compiler Error C2085" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2085" +ms.date: 11/04/2016 f1_keywords: ["C2085"] helpviewer_keywords: ["C2085"] -ms.assetid: 0a86785c-8e6f-481b-8c7b-412220c1950d --- # Compiler Error C2085 -'identifier' : not in formal parameter list +> 'identifier' : not in formal parameter list + +## Remarks The identifier was declared in a function definition but not in the formal parameter list. (ANSI C only) -The following sample generates C2085: +## Example + +The following example generates C2085: ```c // C2085.c diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2086.md b/docs/error-messages/compiler-errors-1/compiler-error-c2086.md index 0041ca25136..a3cf0c60f0a 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2086.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2086.md @@ -1,24 +1,27 @@ --- -description: "Learn more about: Compiler Error C2086" title: "Compiler Error C2086" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2086" +ms.date: 11/04/2016 f1_keywords: ["C2086"] helpviewer_keywords: ["C2086"] -ms.assetid: 4329bf72-90c8-444c-8524-4ef75e6b2139 --- # Compiler Error C2086 -'identifier' : redefinition +> 'identifier' : redefinition + +## Remarks The identifier is defined more than once, or a subsequent declaration differs from a previous one. C2086 can also be the result of incremental building for a referenced C# assembly. Rebuild the C# assembly to resolve this error. -The following sample generates C2086: +## Example + +The following example generates C2086: ```cpp // C2086.cpp -main() { +int main() { int a; int a; // C2086 not an error in ANSI C } diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2087.md b/docs/error-messages/compiler-errors-1/compiler-error-c2087.md index 990afe20506..bbda0677224 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2087.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2087.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2087" title: "Compiler Error C2087" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2087" +ms.date: 11/04/2016 f1_keywords: ["C2087"] helpviewer_keywords: ["C2087"] -ms.assetid: 89761e83-415a-4468-a4c6-b6dedfd1dd6a --- # Compiler Error C2087 -'identifier' : missing subscript +> 'identifier' : missing subscript + +## Remarks The definition of an array with multiple subscripts is missing a subscript value for a dimension higher than one. -The following sample generates C2087: +## Example + +The following example generates C2087: ```cpp // C2087.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2088.md b/docs/error-messages/compiler-errors-1/compiler-error-c2088.md index d25127ed208..372c228b7e0 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2088.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2088.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2088" title: "Compiler Error C2088" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2088" +ms.date: 11/04/2016 f1_keywords: ["C2088"] helpviewer_keywords: ["C2088"] -ms.assetid: b93f7094-185b-423d-8bb9-507cd757dbf5 --- # Compiler Error C2088 -'operator' : illegal for 'class-key' +> 'operator' : illegal for 'class-key' + +## Remarks The operator was not defined for the structure or union. This error is only valid for C code. -The following sample generates C2088 three times: +## Example + +The following example generates C2088 three times: ```c // C2088.c diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2089.md b/docs/error-messages/compiler-errors-1/compiler-error-c2089.md index 1bcf00bbc33..caf451167e6 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2089.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2089.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Compiler Error C2089" title: "Compiler Error C2089" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2089" +ms.date: 11/04/2016 f1_keywords: ["C2089"] helpviewer_keywords: ["C2089"] -ms.assetid: 7c777775-5535-4eea-b6a2-340b71af9560 --- # Compiler Error C2089 -'identifier' : 'class-key' too large +> 'identifier' : 'class-key' too large + +## Remarks The specified structure or union exceeds the 4GB limit. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2090.md b/docs/error-messages/compiler-errors-1/compiler-error-c2090.md index 715aaff8d3c..384319cefd7 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2090.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2090.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2090" title: "Compiler Error C2090" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2090" +ms.date: 11/04/2016 f1_keywords: ["C2090"] helpviewer_keywords: ["C2090"] -ms.assetid: e8176e55-382b-453d-aa27-6597f0274afd --- # Compiler Error C2090 -function returns array +> function returns array + +## Remarks A function cannot return an array. Return a pointer to an array instead. -The following sample generates C2090: +## Example + +The following example generates C2090: ```cpp // C2090.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2091.md b/docs/error-messages/compiler-errors-1/compiler-error-c2091.md index 9b354713a20..e873a8864ef 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2091.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2091.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Compiler Error C2091" title: "Compiler Error C2091" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2091" +ms.date: 11/04/2016 f1_keywords: ["C2091"] helpviewer_keywords: ["C2091"] -ms.assetid: 247c3b57-f123-4420-b68e-d65a364b63cb --- # Compiler Error C2091 -function returns function +> function returns function + +## Remarks A function cannot return a function. Return a pointer to a function instead. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2092.md b/docs/error-messages/compiler-errors-1/compiler-error-c2092.md index ed654b5ab5e..3b07baae29f 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2092.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2092.md @@ -1,20 +1,21 @@ --- -description: "Learn more about: Compiler Error C2092" title: "Compiler Error C2092" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2092" +ms.date: 11/04/2016 f1_keywords: ["C2092"] helpviewer_keywords: ["C2092"] -ms.assetid: 037e44ae-16c8-489a-a512-dcdf7f7795a6 --- # Compiler Error C2092 -'array name' array element type cannot be function +> 'array name' array element type cannot be function + +## Remarks Arrays of functions are not allowed. Use an array of pointers to functions. -## Examples +## Example -The following sample generates C2092: +The following example generates C2092: ```cpp // C2092.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2093.md b/docs/error-messages/compiler-errors-1/compiler-error-c2093.md index 4cf2f9332a5..ea575c36681 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2093.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2093.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2093" title: "Compiler Error C2093" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2093" +ms.date: 11/04/2016 f1_keywords: ["C2093"] helpviewer_keywords: ["C2093"] -ms.assetid: 17529a70-9169-46b5-9fc6-57a5ce224e6a --- # Compiler Error C2093 -'variable1' : cannot be initialized using address of automatic variable 'variable2' +> 'variable1' : cannot be initialized using address of automatic variable 'variable2' + +## Remarks When compiling with [/Za](../../build/reference/za-ze-disable-language-extensions.md), the program tried to use the address of an automatic variable as an initializer. -The following sample generates C2093: +## Example + +The following example generates C2093: ```c // C2093.c diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2094.md b/docs/error-messages/compiler-errors-1/compiler-error-c2094.md index 2fd470d2dd6..3c06cae2fe6 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2094.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2094.md @@ -1,20 +1,21 @@ --- -description: "Learn more about: Compiler Error C2094" title: "Compiler Error C2094" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2094" +ms.date: 11/04/2016 f1_keywords: ["C2094"] helpviewer_keywords: ["C2094"] -ms.assetid: 9e4f8f88-f189-46e7-91c9-481bacc7af87 --- # Compiler Error C2094 -label 'identifier' was undefined +> label 'identifier' was undefined + +## Remarks The label used by a [goto](../../cpp/goto-statement-cpp.md) statement does not exist in the function. ## Example -The following sample generates C2094: +The following example generates C2094: ```cpp // C2094.c diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2095.md b/docs/error-messages/compiler-errors-1/compiler-error-c2095.md index 8224cfb3a8e..8a998415a2c 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2095.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2095.md @@ -1,15 +1,16 @@ --- -description: "Learn more about: Compiler Error C2095" title: "Compiler Error C2095" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2095" +ms.date: 11/04/2016 f1_keywords: ["C2095"] helpviewer_keywords: ["C2095"] -ms.assetid: 44f8ada1-974f-4e81-a408-33ac6695aa53 --- # Compiler Error C2095 -'function' : actual parameter has type 'void' : parameter 'number' +> 'function' : actual parameter has type 'void' : parameter 'number' + +## Remarks -The parameter passed to the function is type **`void`**, which is not allowed. Use a pointer to void ( `void *`) instead. +The parameter passed to the function is type **`void`**, which is not allowed. Use a pointer to void (`void *`) instead. The `number` indicates which parameter is **`void`**. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2096.md b/docs/error-messages/compiler-errors-1/compiler-error-c2096.md index 429150aba63..9121807028e 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2096.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2096.md @@ -1,6 +1,6 @@ --- -description: "Learn more about: Compiler Error C2096" title: "Compiler Error C2096" +description: "Learn more about: Compiler Error C2096" ms.date: 08/23/2022 f1_keywords: ["C2096"] helpviewer_keywords: ["C2096"] @@ -9,4 +9,6 @@ helpviewer_keywords: ["C2096"] > '*identifier*': A data member cannot be initialized with a parenthesized initializer +## Remarks + The compiler expected a braced initializer or an equal expression initializer. To resolve the issue, replace the parenthesized initializer with a braced initializer. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2097.md b/docs/error-messages/compiler-errors-1/compiler-error-c2097.md index b17f2535fbd..0c01d1f89aa 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2097.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2097.md @@ -1,14 +1,13 @@ --- -description: "Learn more about: Compiler Error C2097" title: "Compiler Error C2097" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2097" +ms.date: 11/04/2016 f1_keywords: ["C2097"] helpviewer_keywords: ["C2097"] -ms.assetid: 7e5b2fd4-f61c-4b8a-b265-93e987a04bd3 --- # Compiler Error C2097 -illegal initialization +> illegal initialization ### To fix by checking the following possible causes diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2098.md b/docs/error-messages/compiler-errors-1/compiler-error-c2098.md index b8c19fd652d..886f3d8f80a 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2098.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2098.md @@ -1,6 +1,6 @@ --- -description: "Learn more about: Compiler Error C2098" title: "Compiler Error C2098" +description: "Learn more about: Compiler Error C2098" ms.date: 08/23/2022 f1_keywords: ["C2098"] helpviewer_keywords: ["C2098"] @@ -9,4 +9,6 @@ helpviewer_keywords: ["C2098"] > unexpected token after data member '*identifier*' +## Remarks + The compiler expected a semicolon, a braced initializer or an equal expression initializer. To resolve the issue, insert a semicolon or an initializer. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2099.md b/docs/error-messages/compiler-errors-1/compiler-error-c2099.md index 05dd905b4a8..1547eff225b 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2099.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2099.md @@ -1,20 +1,21 @@ --- -description: "Learn more about: Compiler Error C2099" title: "Compiler Error C2099" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2099" +ms.date: 11/04/2016 f1_keywords: ["C2099"] helpviewer_keywords: ["C2099"] -ms.assetid: 30e151ee-d458-4901-b0c0-d45054a913f5 --- # Compiler Error C2099 -initializer is not a constant +> initializer is not a constant + +## Remarks This error is issued only by the C compiler and occurs only for non-automatic variables. The compiler initializes non-automatic variables at the start of the program and the values they are initialized with must be constant. ## Examples -The following sample generates C2099. +The following example generates C2099. ```c // C2099.c @@ -31,7 +32,7 @@ To resolve this error, compile the module as a .cpp file or simplify the express For more information, see [/fp (Specify Floating-Point Behavior)](../../build/reference/fp-specify-floating-point-behavior.md). -The following sample generates C2099. +The following example generates C2099. ```c // C2099_2.c diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2100.md b/docs/error-messages/compiler-errors-1/compiler-error-c2100.md index 8c691295285..e89c4bde438 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2100.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2100.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2100" title: "Compiler Error C2100" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2100" +ms.date: 11/04/2016 f1_keywords: ["C2100"] helpviewer_keywords: ["C2100"] -ms.assetid: 9ed5ea11-9d55-4ddf-8b1a-162c74f3c390 --- # Compiler Error C2100 -illegal indirection +> illegal indirection + +## Remarks + +Indirection operator (`*`) is applied to a nonpointer value. -Indirection operator ( `*` ) is applied to a nonpointer value. +## Example -The following sample generates C2100: +The following example generates C2100: ```cpp // C2100.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2101.md b/docs/error-messages/compiler-errors-1/compiler-error-c2101.md index a01fe6598c8..e2703e5d860 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2101.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2101.md @@ -1,17 +1,21 @@ --- -description: "Learn more about: Compiler Error C2101" title: "Compiler Error C2101" -ms.date: "03/04/2024" +description: "Learn more about: Compiler Error C2101" +ms.date: 03/04/2024 f1_keywords: ["C2101"] helpviewer_keywords: ["C2101"] --- # Compiler Error C2101 -'&' on constant +> '&' on constant + +## Remarks The [address-of operator (**`&`**)](../../cpp/address-of-operator-amp.md) must have an l-value as operand. -The following sample generates C2101: +## Example + +The following example generates C2101: ```cpp // C2101.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2102.md b/docs/error-messages/compiler-errors-1/compiler-error-c2102.md index 292bbccacca..7db34d038f0 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2102.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2102.md @@ -1,17 +1,21 @@ --- -description: "Learn more about: Compiler Error C2102" title: "Compiler Error C2102" -ms.date: "03/03/2024" +description: "Learn more about: Compiler Error C2102" +ms.date: 03/03/2024 f1_keywords: ["C2102"] helpviewer_keywords: ["C2102"] --- # Compiler Error C2102 -'&' requires l-value +> '&' requires l-value + +## Remarks The [address-of operator (**`&`**)](../../cpp/address-of-operator-amp.md) must have an l-value as operand. Address of temporary values cannot be taken. -The following sample generates C2102: +## Example + +The following example generates C2102: ```cpp // C2102.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2103.md b/docs/error-messages/compiler-errors-1/compiler-error-c2103.md index 3809ebf9833..af055b688c2 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2103.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2103.md @@ -1,17 +1,21 @@ --- -description: "Learn more about: Compiler Error C2103" title: "Compiler Error C2103" -ms.date: "03/04/2024" +description: "Learn more about: Compiler Error C2103" +ms.date: 03/04/2024 f1_keywords: ["C2103"] helpviewer_keywords: ["C2103"] --- # Compiler Error C2103 -'&' on register variable +> '&' on register variable + +## Remarks You cannot take the address of a register. -The following sample generates C2103: +## Example + +The following example generates C2103: ```c // C2103.c diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2104.md b/docs/error-messages/compiler-errors-1/compiler-error-c2104.md index b2640fdd2d0..957f09c7a3f 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2104.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2104.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2104" title: "Compiler Error C2104" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2104" +ms.date: 11/04/2016 f1_keywords: ["C2104"] helpviewer_keywords: ["C2104"] -ms.assetid: 2ea78896-72a6-4901-a1fa-f33ea88ad61b --- # Compiler Error C2104 -'&' on bit field ignored +> '&' on bit field ignored + +## Remarks You cannot take the address of a bit field. -The following sample generates C2104: +## Example + +The following example generates C2104: ```cpp // C2104.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2105.md b/docs/error-messages/compiler-errors-1/compiler-error-c2105.md index 68cf1a2ad6c..55de44e8302 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2105.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2105.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2105" title: "Compiler Error C2105" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2105" +ms.date: 11/04/2016 f1_keywords: ["C2105"] helpviewer_keywords: ["C2105"] -ms.assetid: 19b7f7bc-a9da-4d23-8193-005b6d09274f --- # Compiler Error C2105 -'operator' needs l-value +> 'operator' needs l-value + +## Remarks The operator must have an l-value as operand. -The following sample generates C2105: +## Examples + +The following example generates C2105: ```cpp // C2105.cpp @@ -29,7 +32,7 @@ int main() { } ``` -The following sample generates C2105: +The following example generates C2105: ```cpp // C2105b.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2106.md b/docs/error-messages/compiler-errors-1/compiler-error-c2106.md index 58fec648a53..e22d82019d7 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2106.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2106.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2106" title: "Compiler Error C2106" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2106" +ms.date: 11/04/2016 f1_keywords: ["C2106"] helpviewer_keywords: ["C2106"] -ms.assetid: d5c91a2e-04e4-4770-8478-788b98c52a53 --- # Compiler Error C2106 -'operator' : left operand must be l-value +> 'operator' : left operand must be l-value + +## Remarks The operator must have an l-value as its left operand. -The following sample generates C2106: +## Example + +The following example generates C2106: ```cpp // C2106.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2107.md b/docs/error-messages/compiler-errors-1/compiler-error-c2107.md index 1644f153374..51bcd37722f 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2107.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2107.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Error C2107" title: "Compiler Error C2107" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2107" +ms.date: 11/04/2016 f1_keywords: ["C2107"] helpviewer_keywords: ["C2107"] -ms.assetid: 2866a121-884e-4bb5-8613-36de5817000e --- # Compiler Error C2107 -illegal index, indirection not allowed +> illegal index, indirection not allowed + +## Remarks A subscript is applied to an expression that does not evaluate to a pointer. @@ -16,7 +17,7 @@ A subscript is applied to an expression that does not evaluate to a pointer. C2107 can occur if you incorrectly use the **`this`** pointer of a value type to access the type's default indexer. For more information, see [Semantics of the `this` pointer](../../dotnet/how-to-define-and-consume-classes-and-structs-cpp-cli.md#BKMK_Semantics_of_the_this_pointer). -The following sample generates C2107. +The following example generates C2107. ```cpp // C2107.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2108.md b/docs/error-messages/compiler-errors-1/compiler-error-c2108.md index 4560690ae78..fa7b26db53e 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2108.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2108.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2108" title: "Compiler Error C2108" +description: "Learn more about: Compiler Error C2108" ms.date: 06/03/2022 f1_keywords: ["C2108"] helpviewer_keywords: ["C2108"] -ms.assetid: c84f0b47-5e2c-47d2-8edb-427a40e17c36 --- # Compiler Error C2108 @@ -18,7 +17,7 @@ The array subscript is a non-integer expression. C2108 can occur if you incorrectly use the **`this`** pointer of a value type to access the type's default indexer. For more information, see [Semantics of the `this` pointer](../../dotnet/how-to-define-and-consume-classes-and-structs-cpp-cli.md#BKMK_Semantics_of_the_this_pointer). -The following sample generates C2108. +The following example generates C2108. ```cpp // C2108.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2109.md b/docs/error-messages/compiler-errors-1/compiler-error-c2109.md index c6bff1af2df..8092ba90016 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2109.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2109.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2109" title: "Compiler Error C2109" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2109" +ms.date: 11/04/2016 f1_keywords: ["C2109"] helpviewer_keywords: ["C2109"] -ms.assetid: 2d1ac79d-a985-4904-a38b-b270578d664d --- # Compiler Error C2109 -subscript requires array or pointer type +> subscript requires array or pointer type + +## Remarks The subscript was used on a variable that was not an array. -The following sample generates C2109: +## Example + +The following example generates C2109: ```cpp // C2109.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2110.md b/docs/error-messages/compiler-errors-1/compiler-error-c2110.md index 6136d130b17..480293e439d 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2110.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2110.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2110" title: "Compiler Error C2110" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2110" +ms.date: 11/04/2016 f1_keywords: ["C2110"] helpviewer_keywords: ["C2110"] -ms.assetid: 48fd76ed-90d6-4a60-9c7b-f6ce9355b4ca --- # Compiler Error C2110 -'+' : cannot add two pointers +> '+' : cannot add two pointers + +## Remarks + +An attempt was made to add two pointer values using the plus (`+`) operator. -An attempt was made to add two pointer values using the plus ( `+` ) operator. +## Example -The following sample generates C2110: +The following example generates C2110: ```cpp // C2110.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2111.md b/docs/error-messages/compiler-errors-1/compiler-error-c2111.md index 10ba943b728..f8a9305aa9b 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2111.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2111.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2111" title: "Compiler Error C2111" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2111" +ms.date: 11/04/2016 f1_keywords: ["C2111"] helpviewer_keywords: ["C2111"] -ms.assetid: 38fd42ec-1480-4a44-aaca-ae4593ed5f50 --- # Compiler Error C2111 -'+' : pointer addition requires integral operand +> '+' : pointer addition requires integral operand + +## Remarks + +An attempt was made to add a nonintegral value to a pointer using the plus (`+`) operator. -An attempt was made to add a nonintegral value to a pointer using the plus ( `+` ) operator. +## Example -The following sample generates C2111: +The following example generates C2111: ```cpp // C2111.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2112.md b/docs/error-messages/compiler-errors-1/compiler-error-c2112.md index 8c4236d97a3..1928506edc0 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2112.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2112.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Compiler Error C2112" title: "Compiler Error C2112" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2112" +ms.date: 11/04/2016 f1_keywords: ["C2112"] helpviewer_keywords: ["C2112"] -ms.assetid: 527a2fea-f585-4d00-bbb4-477aee17144b --- # Compiler Error C2112 -'-' : pointer subtraction requires integral or pointer operand +> '-' : pointer subtraction requires integral or pointer operand + +## Remarks An attempt was made to subtract pointers that point to different types. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2113.md b/docs/error-messages/compiler-errors-1/compiler-error-c2113.md index e22c5d9a149..bfeb4b2390c 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2113.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2113.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Compiler Error C2113" title: "Compiler Error C2113" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2113" +ms.date: 11/04/2016 f1_keywords: ["C2113"] helpviewer_keywords: ["C2113"] -ms.assetid: be85cb5e-b0ed-4fc9-b062-032bf7f59a4e --- # Compiler Error C2113 -'-' : pointer can only be subtracted from another pointer +> '-' : pointer can only be subtracted from another pointer + +## Remarks The right operand in a subtraction operation was a pointer, but the left operand was not. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2114.md b/docs/error-messages/compiler-errors-1/compiler-error-c2114.md index ada80748121..75831e51f9d 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2114.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2114.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Compiler Error C2114" title: "Compiler Error C2114" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2114" +ms.date: 11/04/2016 f1_keywords: ["C2114"] helpviewer_keywords: ["C2114"] -ms.assetid: c1b2445f-74eb-4dc8-8d5a-6c8627775ee8 --- # Compiler Error C2114 -'operator' : pointer on left; needs integral value on right +> 'operator' : pointer on left; needs integral value on right + +## Remarks The left operand of `operator` was a pointer, so the right operand must be an integer value. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2115.md b/docs/error-messages/compiler-errors-1/compiler-error-c2115.md index 2125c5674c6..52147bca167 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2115.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2115.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Compiler Error C2115" title: "Compiler Error C2115" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2115" +ms.date: 11/04/2016 f1_keywords: ["C2115"] helpviewer_keywords: ["C2115"] -ms.assetid: 95d76ab5-ddd7-4e29-8cac-24285dccc490 --- # Compiler Error C2115 -'identifier' : incompatible types +> 'identifier' : incompatible types + +## Remarks An expression contained incompatible types. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2116.md b/docs/error-messages/compiler-errors-1/compiler-error-c2116.md index 9dfd0d52b9c..f0b37397e6f 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2116.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2116.md @@ -1,19 +1,18 @@ --- -description: "Learn more about: Compiler Error C2116" title: "Compiler Error C2116" +description: "Learn more about: Compiler Error C2116" ms.date: 12/02/2021 f1_keywords: ["C2116"] helpviewer_keywords: ["C2116"] -ms.assetid: 0089a23f-e6bd-4956-9b58-3bcca09ab5ad --- # Compiler Error C2116 > function parameter lists do not match between declarations -The parameter list of a redeclared function doesn't match the parameter list used in an earlier declaration. - ## Remarks +The parameter list of a redeclared function doesn't match the parameter list used in an earlier declaration. + This error can occur if you use different types for the parameters when you redeclare an `extern "C"` function. This error may occur after an upgrade because of conformance changes in Visual Studio 2019. Starting in Visual Studio 2019 version 16.3, the [`/Zc:externC-`](../../build/reference/zc-externc.md) compiler option relaxes this check. The option must come after any [`/permissive-`](../../build/reference/permissive-standards-conformance.md) option on the command line. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2117.md b/docs/error-messages/compiler-errors-1/compiler-error-c2117.md index 1b5aeb3f185..9776f59ce2e 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2117.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2117.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Error C2117" title: "Compiler Error C2117" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2117" +ms.date: 11/04/2016 f1_keywords: ["C2117"] helpviewer_keywords: ["C2117"] -ms.assetid: b947379d-5861-42fc-ac26-170318579cbd --- # Compiler Error C2117 -'identifier' : array bounds overflow +> 'identifier' : array bounds overflow + +## Remarks An array has too many initializers: @@ -16,7 +17,9 @@ An array has too many initializers: - No space for the null terminator in a string. -The following sample generates C2117: +## Example + +The following example generates C2117: ```cpp // C2117.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2118.md b/docs/error-messages/compiler-errors-1/compiler-error-c2118.md index b10252e5e57..b033bb8ddc7 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2118.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2118.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2118" title: "Compiler Error C2118" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2118" +ms.date: 11/04/2016 f1_keywords: ["C2118"] helpviewer_keywords: ["C2118"] -ms.assetid: bf4315d0-f085-4323-b813-96ee61a13bde --- # Compiler Error C2118 -negative subscript +> negative subscript + +## Remarks The value defining the array size is larger than the maximum array size or smaller than zero. -The following sample generates C2118: +## Example + +The following example generates C2118: ```cpp // C2118.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2120.md b/docs/error-messages/compiler-errors-1/compiler-error-c2120.md index fe8ca7df9c9..b3f630d7c1a 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2120.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2120.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2120" title: "Compiler Error C2120" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2120" +ms.date: 11/04/2016 f1_keywords: ["C2120"] helpviewer_keywords: ["C2120"] -ms.assetid: b0f3f66c-6cd2-4f48-9ea3-c270b53c2b8c --- # Compiler Error C2120 -'void' illegal with all types +> 'void' illegal with all types + +## Remarks The **`void`** type is used in a declaration with another type. -The following sample generates C2120: +## Example + +The following example generates C2120: ```cpp // C2120.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2121.md b/docs/error-messages/compiler-errors-1/compiler-error-c2121.md index bcd354b2fc1..3c2b4770564 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2121.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2121.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Compiler Error C2121" title: "Compiler Error C2121" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2121" +ms.date: 11/04/2016 f1_keywords: ["C2121"] helpviewer_keywords: ["C2121"] -ms.assetid: e04f32da-3736-4df3-8a1c-d687afcecf5c --- # Compiler Error C2121 -'#' : invalid character : possibly the result of a macro expansion +> '#' : invalid character : possibly the result of a macro expansion + +## Remarks An invalid # character may have been inserted by an incorrect macro that uses the token-pasting operator (##) instead of the stringizing operator (#). diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2122.md b/docs/error-messages/compiler-errors-1/compiler-error-c2122.md index a71d88a415f..31ae2f699a5 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2122.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2122.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Compiler Error C2122" title: "Compiler Error C2122" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2122" +ms.date: 11/04/2016 f1_keywords: ["C2122"] helpviewer_keywords: ["C2122"] -ms.assetid: bc060002-cd38-481b-a144-65af035ce851 --- # Compiler Error C2122 -'identifier' : prototype parameter in name list illegal +> 'identifier' : prototype parameter in name list illegal + +## Remarks The parameter is not a legal type. ANSI C does not support user-defined types. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2124.md b/docs/error-messages/compiler-errors-1/compiler-error-c2124.md index 66e5e748be4..e20cba89e6a 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2124.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2124.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2124" title: "Compiler Error C2124" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2124" +ms.date: 11/04/2016 f1_keywords: ["C2124"] helpviewer_keywords: ["C2124"] -ms.assetid: 93392aaa-5582-4d68-8cc5-bd9c62a0ae7e --- # Compiler Error C2124 -divide or mod by zero +> divide or mod by zero + +## Remarks A constant expression has a zero denominator. To resolve the error, do not divide by zero. -The following sample generates C2124: +## Example + +The following example generates C2124: ```cpp // C2124.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2128.md b/docs/error-messages/compiler-errors-1/compiler-error-c2128.md index 242935dcf88..a2d21596f72 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2128.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2128.md @@ -1,17 +1,21 @@ --- -description: "Learn more about: Compiler Error C2128" title: "Compiler Error C2128" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2128" +ms.date: 11/04/2016 f1_keywords: ["C2128"] helpviewer_keywords: ["C2128"] --- # Compiler Error C2128 -'function' : alloc_text/same_seg applicable only to functions with C linkage +> 'function' : alloc_text/same_seg applicable only to functions with C linkage + +## Remarks `#pragma alloc_text` can only be used with functions declared to have C linkage. -The following sample generates C2128: +## Example + +The following example generates C2128: ```cpp // C2128.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2129.md b/docs/error-messages/compiler-errors-1/compiler-error-c2129.md index bc65e651420..161c15cfb96 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2129.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2129.md @@ -1,20 +1,23 @@ --- -description: "Learn more about: Compiler Error C2129" title: "Compiler Error C2129" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2129" +ms.date: 11/04/2016 f1_keywords: ["C2129"] helpviewer_keywords: ["C2129"] -ms.assetid: 21a8223e-1d22-4baa-9ca1-922b7f751dd0 --- # Compiler Error C2129 -static function 'function' declared but not defined +> static function 'function' declared but not defined + +## Remarks A forward reference is made to a **`static`** function that is never defined. A **`static`** function must be defined within file scope. If the function is defined in another file, it must be declared **`extern`**. -The following sample generates C2129: +## Example + +The following example generates C2129: ```cpp // C2129.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2130.md b/docs/error-messages/compiler-errors-1/compiler-error-c2130.md index cf56b31a742..5f1fd271618 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2130.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2130.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2130" title: "Compiler Error C2130" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2130" +ms.date: 11/04/2016 f1_keywords: ["C2130"] helpviewer_keywords: ["C2130"] -ms.assetid: c6fd5a7e-8f28-4f67-99d1-95a13b0dff90 --- # Compiler Error C2130 -\#line expected a string containing the filename, found 'token' +> #line expected a string containing the filename, found 'token' + +## Remarks The optional file name token following [#line](../../preprocessor/hash-line-directive-c-cpp.md) `linenumber` must be a string. -The following sample generates C2130: +## Example + +The following example generates C2130: ```cpp // C2130.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2131.md b/docs/error-messages/compiler-errors-1/compiler-error-c2131.md index 90733559e1d..32855ce4313 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2131.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2131.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: Compiler Error C2131" title: "Compiler Error C2131" -ms.date: "02/28/2019" +description: "Learn more about: Compiler Error C2131" +ms.date: 02/28/2019 f1_keywords: ["C2131"] helpviewer_keywords: ["C2131"] --- @@ -9,6 +9,8 @@ helpviewer_keywords: ["C2131"] > expression did not evaluate to a constant +## Remarks + An expression declared as **`const`** or **`constexpr`** didn't evaluate to a constant at compile time. The compiler must be able to determine the value of the expression at the point it's used. ## Example diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2132.md b/docs/error-messages/compiler-errors-1/compiler-error-c2132.md index c4c21615336..0bf9a330741 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2132.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2132.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Compiler Error C2132" title: "Compiler Error C2132" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2132" +ms.date: 11/04/2016 f1_keywords: ["C2132"] helpviewer_keywords: ["C2132"] -ms.assetid: 32902472-49d1-4513-888f-b52d336839d5 --- # Compiler Error C2132 -syntax error : unexpected identifier +> syntax error : unexpected identifier + +## Remarks An identifier appears in an unsupported context. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2133.md b/docs/error-messages/compiler-errors-1/compiler-error-c2133.md index bc9e05e319d..fbeed35e5b4 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2133.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2133.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2133" title: "Compiler Error C2133" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2133" +ms.date: 11/04/2016 f1_keywords: ["C2133"] helpviewer_keywords: ["C2133"] -ms.assetid: 8942f9e8-9818-468f-97db-09dbd124fcae --- # Compiler Error C2133 -'identifier' : unknown size +> 'identifier' : unknown size + +## Remarks An unsized array is declared as a member of a class, structure, union, or enumeration. The /Za (ANSI C) option does not allow unsized member arrays. -The following sample generates C2133: +## Example + +The following example generates C2133: ```cpp // C2133.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2134.md b/docs/error-messages/compiler-errors-1/compiler-error-c2134.md index a46a3837848..2e79ffe2bb8 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2134.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2134.md @@ -1,24 +1,28 @@ --- -description: "Learn more about: Compiler Error C2134" title: "Compiler Error C2134" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2134" +ms.date: 11/04/2016 f1_keywords: ["C2134"] -ms.assetid: d45cb3e8-0be4-4bd6-8be9-5f8d2384363f +helpviewer_keywords: ["C2134"] --- # Compiler Error C2134 -'function' : call does not result in a constant expression +> 'function' : call does not result in a constant expression + +## Remarks A function declared as constexpr can only call other functions declared as constexpr. -The following sample generates C2134: +## Example + +The following example generates C2134: ```cpp // C2134.cpp // compile with: /c int A() { return 42; -}; +} constexpr int B() { return A(); // Error C2134: 'A': call does not result in a constant expression. @@ -31,7 +35,7 @@ Possible resolution: // C2134b.cpp constexpr int A() { // add constexpr to A, since it meets the requirements of constexpr. return 42; -}; +} constexpr int B() { return A(); // No error diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2135.md b/docs/error-messages/compiler-errors-1/compiler-error-c2135.md index d830da92acb..aff3621ccb1 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2135.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2135.md @@ -1,30 +1,38 @@ --- -description: "Learn more about: Compiler Error C2135" title: "Compiler Error C2135" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2135" +ms.date: 08/13/2025 f1_keywords: ["C2135"] helpviewer_keywords: ["C2135"] -ms.assetid: aa360d22-4f79-4de1-b384-93cadd10975f --- # Compiler Error C2135 -'bit operator' : illegal bit field operation +> '*identifier*': you cannot apply '*operator*' to a bit-field + +## Remarks + +The [address-of operator (`&`)](../../cpp/address-of-operator-amp.md), [unary plus operator (`+`)](../../cpp/unary-plus-and-negation-operators-plus-and.md), [unary negation operator (`-`)](../../cpp/unary-plus-and-negation-operators-plus-and.md), [logical negation operator (`!`)](../../cpp/logical-negation-operator-exclpt.md), [one's complement operator (`~`)](../../cpp/one-s-complement-operator-tilde.md), and [indirection operator (`*`)](../../cpp/indirection-operator-star.md) cannot be applied to a bit-field in this context. -The address-of operator (`&`) cannot be applied to a bit field. +## Example -The following sample generates C2135: +The following example generates C2135: ```cpp // C2135.cpp -struct S { - int i : 1; -}; -struct T { - int j; +struct S +{ + int bit_field : 1; + int integer; }; -int main() { - &S::i; // C2135 address of a bit field - &T::j; // OK + +int main() +{ + &S::bit_field; // C2135 + &S::integer; // OK } ``` + +## See also + +[C2104](compiler-error-c2104.md) diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2137.md b/docs/error-messages/compiler-errors-1/compiler-error-c2137.md index bb5b13eaa61..283c3c3777a 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2137.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2137.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2137" title: "Compiler Error C2137" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2137" +ms.date: 11/04/2016 f1_keywords: ["C2137"] helpviewer_keywords: ["C2137"] -ms.assetid: 984687ee-7766-4f6b-ae15-0c9a010e2366 --- # Compiler Error C2137 -empty character constant +> empty character constant + +## Remarks The empty character constant ( ' ' ) is not permitted. -The following sample generates C2137: +## Example + +The following example generates C2137: ```cpp // C2137.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2138.md b/docs/error-messages/compiler-errors-1/compiler-error-c2138.md index 77a93bb632b..3b597d22ad4 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2138.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2138.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Compiler Error C2138" title: "Compiler Error C2138" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2138" +ms.date: 11/04/2016 f1_keywords: ["C2138"] helpviewer_keywords: ["C2138"] -ms.assetid: 59fd1a58-3605-45dd-b9c1-0981e8aab26d --- # Compiler Error C2138 -illegal to define an enumeration without any members +> illegal to define an enumeration without any members + +## Remarks An enumeration must have at least one member when /Za (disable Microsoft extensions) is selected. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2139.md b/docs/error-messages/compiler-errors-1/compiler-error-c2139.md index e14f1709bf4..3f09eaac25a 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2139.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2139.md @@ -1,6 +1,6 @@ --- -description: "Learn more about: Compiler Error C2139" title: "Compiler Error C2139" +description: "Learn more about: Compiler Error C2139" ms.date: 05/03/2021 f1_keywords: ["C2139"] helpviewer_keywords: ["C2139"] @@ -9,15 +9,15 @@ helpviewer_keywords: ["C2139"] > '*type*' : an undefined class is not allowed as an argument to compiler intrinsic type trait '*trait*' -An invalid argument was passed to a type trait. - ## Remarks +An invalid argument was passed to a type trait. + For more information, see [Compiler Support for Type Traits](../../extensions/compiler-support-for-type-traits-cpp-component-extensions.md). ## Example -The following sample generates C2139. +The following example generates C2139. ```cpp // C2139.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2140.md b/docs/error-messages/compiler-errors-1/compiler-error-c2140.md index 59c8c1212ff..5d5a0648071 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2140.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2140.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Error C2140" title: "Compiler Error C2140" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2140" +ms.date: 11/04/2016 f1_keywords: ["C2140"] helpviewer_keywords: ["C2140"] -ms.assetid: d44a0500-002c-4632-9e5e-c71c3a473ec4 --- # Compiler Error C2140 -'type' : a type that is dependent on a generic type parameter is not allowed as an argument to compiler intrinsic type trait 'trait' +> 'type' : a type that is dependent on a generic type parameter is not allowed as an argument to compiler intrinsic type trait 'trait' + +## Remarks An invalid type specifier was passed to a type trait. @@ -16,7 +17,7 @@ For more information, see [Compiler Support for Type Traits](../../extensions/co ## Example -The following sample generates C2140. +The following example generates C2140. ```cpp // C2140.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2141.md b/docs/error-messages/compiler-errors-1/compiler-error-c2141.md index 056b2983499..18e160df28b 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2141.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2141.md @@ -1,20 +1,21 @@ --- -description: "Learn more about: Compiler Error C2141" title: "Compiler Error C2141" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2141" +ms.date: 11/04/2016 f1_keywords: ["C2141"] helpviewer_keywords: ["C2141"] -ms.assetid: 10cf770f-0500-4220-ac90-a863b7ea5fe6 --- # Compiler Error C2141 -array size overflow +> array size overflow + +## Remarks An array exceeds the 2GB limit. Reduce the size of the array. ## Example -The following sample generates C2141. +The following example generates C2141. ```cpp // C2141.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2142.md b/docs/error-messages/compiler-errors-1/compiler-error-c2142.md index 1920a389631..63c8eae9446 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2142.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2142.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2142" title: "Compiler Error C2142" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2142" +ms.date: 11/04/2016 f1_keywords: ["C2142"] helpviewer_keywords: ["C2142"] -ms.assetid: d0dbe10e-0952-49a4-8b33-e82fb7558b19 --- # Compiler Error C2142 -function declarations differ, variable parameters specified only in one of them +> function declarations differ, variable parameters specified only in one of them + +## Remarks One declaration of the function contains a variable parameter list. Another declaration does not. ANSI C ([/Za](../../build/reference/za-ze-disable-language-extensions.md)) only. -The following sample generates C2142: +## Example + +The following example generates C2142: ```c // C2142.c diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2143.md b/docs/error-messages/compiler-errors-1/compiler-error-c2143.md index 66f9011fb60..244566a6131 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2143.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2143.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Error C2143" title: "Compiler Error C2143" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2143" +ms.date: 11/04/2016 f1_keywords: ["C2143"] helpviewer_keywords: ["C2143"] -ms.assetid: 1d8d1456-e031-4965-9240-09a6e33ba81c --- # Compiler Error C2143 -syntax error : missing 'token1' before 'token2' +> syntax error : missing 'token1' before 'token2' + +## Remarks The compiler expected a specific token (that is, a language element other than white space) and found another token instead. @@ -16,6 +17,8 @@ Check the [C++ Language Reference](../../cpp/cpp-language-reference.md) to deter C2143 can occur in different situations. +## Examples + It can occur when an operator that can qualify a name (`::`, `->`, and `.`) must be followed by the keyword **`template`**, as in this example: ```cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2144.md b/docs/error-messages/compiler-errors-1/compiler-error-c2144.md index b421b7b1e78..c50ffbe8bfc 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2144.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2144.md @@ -1,15 +1,16 @@ --- -description: "Learn more about: Compiler Error C2144" title: "Compiler Error C2144" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2144" +ms.date: 11/04/2016 f1_keywords: ["C2144"] helpviewer_keywords: ["C2144"] -ms.assetid: 49f3959b-324f-4c06-9588-c0ecef5dc5b3 --- # Compiler Error C2144 > syntax error : '*type*' should be preceded by '*token*' +## Remarks + The compiler expected *token* and found *type* instead. This error may be caused by a missing closing brace, right parenthesis, or semicolon. @@ -20,7 +21,7 @@ You may also see C2144 if you are trying to do type forwarding. See [Type Forwar ## Examples -The following sample generates C2144, and shows a way to fix it: +The following example generates C2144, and shows a way to fix it: ```cpp // C2144.cpp @@ -33,7 +34,7 @@ REF struct MyStruct0; // C2144 REF1 MyStruct1; ``` -The following sample generates C2144, and shows a way to fix it: +The following example generates C2144, and shows a way to fix it: ```cpp // C2144_2.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2145.md b/docs/error-messages/compiler-errors-1/compiler-error-c2145.md index d38fac35d8b..3f0cb125a01 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2145.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2145.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Error C2145" title: "Compiler Error C2145" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2145" +ms.date: 11/04/2016 f1_keywords: ["C2145"] helpviewer_keywords: ["C2145"] -ms.assetid: 158e5809-8adb-4195-8ca5-684501defbc8 --- # Compiler Error C2145 -syntax error : missing 'token' before identifier +> syntax error : missing 'token' before identifier + +## Remarks The compiler expected `token` and found identifier instead. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2146.md b/docs/error-messages/compiler-errors-1/compiler-error-c2146.md index 083cfd7db76..075f911dfac 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2146.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2146.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Error C2146" title: "Compiler Error C2146" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2146" +ms.date: 11/04/2016 f1_keywords: ["C2146"] helpviewer_keywords: ["C2146"] -ms.assetid: 6bfb7de6-6723-4486-9350-c66ef88d7a64 --- # Compiler Error C2146 -syntax error : missing 'token' before identifier 'identifier' +> syntax error : missing 'token' before identifier 'identifier' + +## Remarks The compiler expected `token` and found `identifier` instead. Possible causes: @@ -20,7 +21,7 @@ This error may be caused by a typographical error. Error [C2065](../../error-mes ## Examples -The following sample generates C2146. +The following example generates C2146. ```cpp // C2146.cpp @@ -39,7 +40,7 @@ int main() { This error can also be generated as a result of compiler conformance work that was done for Visual Studio .NET 2003: missing **`typename`** keyword. -The following sample compiles in Visual Studio .NET 2002 but will fail in Visual Studio .NET 2003: +The following example compiles in Visual Studio .NET 2002 but will fail in Visual Studio .NET 2003: ```cpp // C2146b.cpp @@ -64,7 +65,7 @@ You will also see this error as a result of compiler conformance work that was d The use of `T` from the primary template is not allowed in the explicit specialization. For code to be valid in the Visual Studio .NET 2003 and Visual Studio .NET, replace all instances of the template parameter in the specialization with the explicitly specialized type. -The following sample compiles in Visual Studio .NET but will fail in Visual Studio .NET 2003: +The following example compiles in Visual Studio .NET but will fail in Visual Studio .NET 2003: ```cpp // C2146_c.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2147.md b/docs/error-messages/compiler-errors-1/compiler-error-c2147.md index 363bd1c2862..c282a1e2bdc 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2147.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2147.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2147" title: "Compiler Error C2147" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2147" +ms.date: 11/04/2016 f1_keywords: ["C2147"] helpviewer_keywords: ["C2147"] -ms.assetid: d1adb3bf-7ece-4815-922c-ad7492fb6670 --- # Compiler Error C2147 -syntax error : 'identifier' is a new keyword +> syntax error : 'identifier' is a new keyword + +## Remarks An identifier was used that is now a reserved keyword in the language. -The following sample generates C2147: +## Example + +The following example generates C2147: ```cpp // C2147.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2148.md b/docs/error-messages/compiler-errors-1/compiler-error-c2148.md index f2a12bc67bb..6caab690512 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2148.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2148.md @@ -1,20 +1,21 @@ --- -description: "Learn more about: Compiler Error C2148" title: "Compiler Error C2148" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2148" +ms.date: 11/04/2016 f1_keywords: ["C2148"] helpviewer_keywords: ["C2148"] -ms.assetid: e510c2c9-7b57-4ce8-be03-ba363e2cc5d9 --- # Compiler Error C2148 -total size of array must not exceed 0x7fffffff bytes +> total size of array must not exceed 0x7fffffff bytes + +## Remarks An array exceeds the limit. Reduce the size of the array. ## Example -The following sample generates C2148: +The following example generates C2148: ```cpp // C2148.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2149.md b/docs/error-messages/compiler-errors-1/compiler-error-c2149.md index 5eede2573b2..e6e64526d8d 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2149.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2149.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2149" title: "Compiler Error C2149" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2149" +ms.date: 11/04/2016 f1_keywords: ["C2149"] helpviewer_keywords: ["C2149"] -ms.assetid: 7a106dab-d79f-41b9-85be-f36e86e4d2ab --- # Compiler Error C2149 -'identifier' : named bit field cannot have zero width +> 'identifier' : named bit field cannot have zero width + +## Remarks Bit fields can have zero width only if unnamed. -The following sample generates C2149: +## Example + +The following example generates C2149: ```cpp // C2149.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2150.md b/docs/error-messages/compiler-errors-1/compiler-error-c2150.md index 3fc67eca0f4..c1595ba5141 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2150.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2150.md @@ -1,20 +1,21 @@ --- -description: "Learn more about: Compiler Error C2150" title: "Compiler Error C2150" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2150" +ms.date: 11/04/2016 f1_keywords: ["C2150"] helpviewer_keywords: ["C2150"] -ms.assetid: 21e82a10-c1d4-4c0d-9dc6-c5d92ea42a31 --- # Compiler Error C2150 > '*identifier*' : bit field must have type 'int', 'signed int', or 'unsigned int' +## Remarks + The base type for a bit-field is required to be **`int`**, **`signed int`**, or **`unsigned int`**. ## Example -This sample shows how you might encounter C2150, and how you can fix it: +This example shows how you might encounter C2150, and how you can fix it: ```cpp // C2150.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2151.md b/docs/error-messages/compiler-errors-1/compiler-error-c2151.md index 9fffa41bf1f..60f0f9ebea8 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2151.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2151.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Compiler Error C2151" title: "Compiler Error C2151" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2151" +ms.date: 11/04/2016 f1_keywords: ["C2151"] helpviewer_keywords: ["C2151"] -ms.assetid: 7f8dd83a-1f41-46d8-8778-0d1f79ed36c9 --- # Compiler Error C2151 -more than one language attribute +> more than one language attribute + +## Remarks A function has more than one keyword ( **`__cdecl`**, **`__stdcall`**, or **`__fastcall`**) specifying a calling convention. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2152.md b/docs/error-messages/compiler-errors-1/compiler-error-c2152.md index 40c3988ecfd..fa096f9730a 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2152.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2152.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Compiler Error C2152" title: "Compiler Error C2152" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2152" +ms.date: 11/04/2016 f1_keywords: ["C2152"] helpviewer_keywords: ["C2152"] -ms.assetid: a9ea2b0c-d55d-41c7-ba9f-dd75592ffc8a --- # Compiler Error C2152 -'identifier' : pointers to functions with different attributes +> 'identifier' : pointers to functions with different attributes + +## Remarks A pointer to a function with one calling convention (**`__cdecl`**, **`__stdcall`**, or **`__fastcall`**) is assigned to a pointer to a function with another calling convention. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2153.md b/docs/error-messages/compiler-errors-1/compiler-error-c2153.md index 893455edab7..8f34dce0ada 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2153.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2153.md @@ -1,23 +1,30 @@ --- -description: "Learn more about: Compiler Error C2153" title: "Compiler Error C2153" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2153" +ms.date: 01/31/2025 f1_keywords: ["C2153"] helpviewer_keywords: ["C2153"] -ms.assetid: cfc50cb7-9a0f-4b5b-879a-d419c99f7be1 --- # Compiler Error C2153 -hex constants must have at least one hex digit +> integer literals must have at least one digit + +## Remarks -Hexadecimal constants 0x, 0X, and \x are not valid. At least one hex digit must follow x or X. +Hexadecimal and binary literals must contain at least one digit after the leading sequence (`0x`, `0X`, `0b`, or `0B`), otherwise the trailing character may be incorrectly interpreted as a suffix or literal operator. See [Integer literals](../../cpp/numeric-boolean-and-pointer-literals-cpp.md#integer-literals) for more information. -The following sample generates C2153: +## Example + +The following example generates C2153: ```cpp // C2153.cpp -int main() { - int a= 0x; // C2153 - int b= 0xA; // OK +int main() +{ + int a = 0x; // C2153 + int b = 0x0; // OK + + int c = 0b; // C2153 + int d = 0b0; // OK } ``` diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2154.md b/docs/error-messages/compiler-errors-1/compiler-error-c2154.md index a60157128dc..38192df4ca8 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2154.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2154.md @@ -1,15 +1,36 @@ --- -description: "Learn more about: Compiler Error C2154" title: "Compiler Error C2154" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2154" +ms.date: 09/21/2025 f1_keywords: ["C2154"] helpviewer_keywords: ["C2154"] -ms.assetid: 98d6b044-5a3a-43ad-95fa-9b916b22468a --- # Compiler Error C2154 -'type' : only enumeration type is allowed as an argument to compiler intrinsic type trait '__underlying_type' +> '*type*': only enumeration type is allowed as an argument to compiler intrinsic type trait '__underlying_type' + +## Remarks + +You can only get the underlying type of an [enumeration](../../cpp/enumerations-cpp.md) type. + +## Example + +The following example generates C2154: + +```cpp +// C2154.cpp +// compile with: /c + +struct S {}; +enum E {}; +enum class EC {}; + +__underlying_type(S) s; // C2154 +__underlying_type(int) i; // C2154 +__underlying_type(E) e; // OK +__underlying_type(EC) ec; // OK +``` -You can only get the underlying type of an enumeration type. +## See also -For more information, see [Compiler Support for Type Traits](../../extensions/compiler-support-for-type-traits-cpp-component-extensions.md). +[`underlying_type` class](../../standard-library/underlying-type-class.md) diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2155.md b/docs/error-messages/compiler-errors-1/compiler-error-c2155.md index d65e37535c5..7dfb22df0d8 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2155.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2155.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Compiler Error C2155" title: "Compiler Error C2155" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2155" +ms.date: 11/04/2016 f1_keywords: ["C2155"] helpviewer_keywords: ["C2155"] -ms.assetid: 54d408af-fc48-4121-9011-5e75c7072e01 --- # Compiler Error C2155 -'?' : invalid left operand, expected arithmetic or pointer type +> '?' : invalid left operand, expected arithmetic or pointer type + +## Remarks An expression on the left hand side of `?` cannot be compared to zero. You must use an arithmetic or pointer expression that can be compared to zero. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2156.md b/docs/error-messages/compiler-errors-1/compiler-error-c2156.md index 3f26c7e32e0..8ba7b0a0ca2 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2156.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2156.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2156" title: "Compiler Error C2156" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2156" +ms.date: 11/04/2016 f1_keywords: ["C2156"] helpviewer_keywords: ["C2156"] -ms.assetid: 136f9c67-2c27-4f61-b7e6-ccd202eca697 --- # Compiler Error C2156 -pragma must be outside function +> pragma must be outside function + +## Remarks A pragma that must be specified at a global level (outside a function body) is within a function. -The following sample generates C2156: +## Example + +The following example generates C2156: ```cpp // C2156.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2157.md b/docs/error-messages/compiler-errors-1/compiler-error-c2157.md index 5128e4a1b95..104d98276b1 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2157.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2157.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2157" title: "Compiler Error C2157" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2157" +ms.date: 11/04/2016 f1_keywords: ["C2157"] helpviewer_keywords: ["C2157"] -ms.assetid: babbca24-16dc-4b69-be14-a675029249c1 --- # Compiler Error C2157 -'function' : must be declared before use in pragma list +> 'function' : must be declared before use in pragma list + +## Remarks The function name is not declared before being referenced in the list of functions for an [alloc_text](../../preprocessor/alloc-text.md) pragma. -The following sample generates C2157: +## Example + +The following example generates C2157: ```cpp // C2157.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2158.md b/docs/error-messages/compiler-errors-1/compiler-error-c2158.md index 9701f65a703..4372aa71568 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2158.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2158.md @@ -1,20 +1,21 @@ --- -description: "Learn more about: Compiler Error C2158" title: "Compiler Error C2158" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2158" +ms.date: 11/04/2016 f1_keywords: ["C2158"] helpviewer_keywords: ["C2158"] -ms.assetid: 39028899-e95c-4809-8e65-6111118641ee --- # Compiler Error C2158 -'type' : #pragma make_public directive is currently supported for native non-template types only +> 'type' : #pragma make_public directive is currently supported for native non-template types only + +## Remarks The [make_public](../../preprocessor/make-public.md) pragma can only be applied to a native, non-template type. ## Example -The following sample generates C2158. +The following example generates C2158. ```cpp // C2158.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2159.md b/docs/error-messages/compiler-errors-1/compiler-error-c2159.md index 70073ebc69e..1463230715d 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2159.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2159.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2159" title: "Compiler Error C2159" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2159" +ms.date: 11/04/2016 f1_keywords: ["C2159"] helpviewer_keywords: ["C2159"] -ms.assetid: 925a2cbd-43c9-45ee-a373-84004350b380 --- # Compiler Error C2159 -more than one storage class specified +> more than one storage class specified + +## Remarks A declaration contains more than one storage class. -The following sample generates C2159: +## Example + +The following example generates C2159: ```cpp // C2159.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2160.md b/docs/error-messages/compiler-errors-1/compiler-error-c2160.md index 6353f84bba8..1b9174fbe60 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2160.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2160.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2160" title: "Compiler Error C2160" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2160" +ms.date: 11/04/2016 f1_keywords: ["C2160"] helpviewer_keywords: ["C2160"] -ms.assetid: a1f694a7-fb16-4437-b7f5-a1af6da94bc5 --- # Compiler Error C2160 -'##' cannot occur at the beginning of a macro definition +> '##' cannot occur at the beginning of a macro definition + +## Remarks A macro definition began with a token-pasting operator (##). -The following sample generates C2160: +## Example + +The following example generates C2160: ```cpp // C2160.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2161.md b/docs/error-messages/compiler-errors-1/compiler-error-c2161.md index e552b85448f..cab1ce72319 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2161.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2161.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2161" title: "Compiler Error C2161" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2161" +ms.date: 11/04/2016 f1_keywords: ["C2161"] helpviewer_keywords: ["C2161"] -ms.assetid: d6798821-13bb-4e60-924f-85f7bf955387 --- # Compiler Error C2161 -'##' cannot occur at the end of a macro definition +> '##' cannot occur at the end of a macro definition + +## Remarks A macro definition ended with a token-pasting operator (##). -The following sample generates C2161: +## Example + +The following example generates C2161: ```cpp // C2161.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2162.md b/docs/error-messages/compiler-errors-1/compiler-error-c2162.md index 9255eacdab9..eb2b08aa201 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2162.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2162.md @@ -1,26 +1,25 @@ --- -description: "Learn more about: Compiler Error C2162" title: "Compiler Error C2162" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2162" +ms.date: 03/30/2025 f1_keywords: ["C2162"] helpviewer_keywords: ["C2162"] -ms.assetid: 34923628-d35e-48ab-9072-b95e3b5f6b45 --- # Compiler Error C2162 -expected macro formal parameter +> expected macro formal parameter -The token following a stringizing operator (#) is not a formal parameter name. +## Remarks + +The token following a [stringizing operator (#)](../../preprocessor/stringizing-operator-hash.md) or a [charizing operator (#@)](../../preprocessor/charizing-operator-hash-at.md) is not a formal parameter. ## Example -The following sample generates C2162: +The following example generates C2162: ```cpp // C2162.cpp // compile with: /c -#include - -#define print(a) printf_s(b) // OK -#define print(a) printf_s(#b) // C2162 +#define make_string1(s) # // C2162 +#define make_string2(s) #s // OK ``` diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2163.md b/docs/error-messages/compiler-errors-1/compiler-error-c2163.md index 8cf898cc43c..1fd73ce8bd0 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2163.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2163.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Compiler Error C2163" title: "Compiler Error C2163" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2163" +ms.date: 11/04/2016 f1_keywords: ["C2163"] helpviewer_keywords: ["C2163"] -ms.assetid: 6428d1e9-1ba1-46fc-bbf6-91d6fef2734c --- # Compiler Error C2163 -'function' : not available as an intrinsic function +> 'function' : not available as an intrinsic function + +## Remarks An `intrinsic` or `function` pragma lists a function not available in intrinsic form. For example, certain intrinsics are not available when compiling a program that uses /clr programming. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2164.md b/docs/error-messages/compiler-errors-1/compiler-error-c2164.md index 0938243a688..5110e09126a 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2164.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2164.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2164" title: "Compiler Error C2164" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2164" +ms.date: 11/04/2016 f1_keywords: ["C2164"] helpviewer_keywords: ["C2164"] -ms.assetid: 55df5024-68a8-45a8-ae6c-e6dba35318a2 --- # Compiler Error C2164 -'function' : intrinsic function not declared +> 'function' : intrinsic function not declared + +## Remarks An `intrinsic` pragma uses an undeclared function (only occurs with **/Oi**). Or, one of the compiler intrinsics was used without including its header file. -The following sample generates C2164: +## Example + +The following example generates C2164: ```c // C2164.c diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2165.md b/docs/error-messages/compiler-errors-1/compiler-error-c2165.md index 6cc12f0dcc2..c205d3531eb 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2165.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2165.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2165" title: "Compiler Error C2165" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2165" +ms.date: 11/04/2016 f1_keywords: ["C2165"] helpviewer_keywords: ["C2165"] -ms.assetid: b108313b-b8cb-4dce-b2ec-f2b31c9cdc87 --- # Compiler Error C2165 -'keyword' : cannot modify pointers to data +> 'keyword' : cannot modify pointers to data + +## Remarks The **`__stdcall`**, **`__cdecl`**, or **`__fastcall`** keyword attempts to modify a pointer to data. -The following sample generates C2165: +## Example + +The following example generates C2165: ```cpp // C2165.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2166.md b/docs/error-messages/compiler-errors-1/compiler-error-c2166.md index a4df5a11666..82508f2bf90 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2166.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2166.md @@ -1,23 +1,26 @@ --- -description: "Learn more about: Compiler Error C2166" title: "Compiler Error C2166" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2166" +ms.date: 06/29/2025 f1_keywords: ["C2166"] helpviewer_keywords: ["C2166"] -ms.assetid: 12789c3a-cc76-48bb-ae2e-64283e0964ed --- # Compiler Error C2166 -l-value specifies const object +> l-value specifies const object + +## Remarks Code attempts to modify an item declared **`const`**. -The following sample generates C2166: +## Example + +The following example generates C2166: ```cpp // C2166.cpp -int f(); -int main() { - ( (const int&) 1 ) = 5; // C2166 +int main() +{ + ((const int&)1) = 5; // C2166 } ``` diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2167.md b/docs/error-messages/compiler-errors-1/compiler-error-c2167.md index 04cfdca5904..f893c4e0ff5 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2167.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2167.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Compiler Error C2167" title: "Compiler Error C2167" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2167" +ms.date: 11/04/2016 f1_keywords: ["C2167"] helpviewer_keywords: ["C2167"] -ms.assetid: 3de3de96-12cd-47df-b24e-34cc9747ef83 --- # Compiler Error C2167 -'function' : too many actual parameters for intrinsic function +> 'function' : too many actual parameters for intrinsic function + +## Remarks A reference to an `intrinsic` function has too many parameters. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2168.md b/docs/error-messages/compiler-errors-1/compiler-error-c2168.md index 26574e9a1be..e2fe0f0550c 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2168.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2168.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Compiler Error C2168" title: "Compiler Error C2168" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2168" +ms.date: 11/04/2016 f1_keywords: ["C2168"] helpviewer_keywords: ["C2168"] -ms.assetid: 625e7dc3-ca74-4980-8268-8d5c0245e376 --- # Compiler Error C2168 -'function' : too few actual parameters for intrinsic function +> 'function' : too few actual parameters for intrinsic function + +## Remarks A reference to an `intrinsic` function has too few parameters. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2169.md b/docs/error-messages/compiler-errors-1/compiler-error-c2169.md index a4e58165941..210ec567bc1 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2169.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2169.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Compiler Error C2169" title: "Compiler Error C2169" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2169" +ms.date: 11/04/2016 f1_keywords: ["C2169"] helpviewer_keywords: ["C2169"] -ms.assetid: 97f700bd-1044-46f5-b276-3d7570ee7708 --- # Compiler Error C2169 -'function' : intrinsic function, cannot be defined +> 'function' : intrinsic function, cannot be defined + +## Remarks A function definition appears for a function already declared `intrinsic`. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2170.md b/docs/error-messages/compiler-errors-1/compiler-error-c2170.md index 599a5750112..a3e73e406fa 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2170.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2170.md @@ -1,14 +1,13 @@ --- -description: "Learn more about: Compiler Error C2170" title: "Compiler Error C2170" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2170" +ms.date: 11/04/2016 f1_keywords: ["C2170"] helpviewer_keywords: ["C2170"] -ms.assetid: d5c663f0-2459-4e11-a8bf-a52b62f3c71d --- # Compiler Error C2170 -'identifier' : not declared as a function, cannot be intrinsic +> 'identifier' : not declared as a function, cannot be intrinsic ### To fix by checking the following possible causes diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2171.md b/docs/error-messages/compiler-errors-1/compiler-error-c2171.md index f32ebc62e2e..fb4d42de908 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2171.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2171.md @@ -1,20 +1,21 @@ --- -description: "Learn more about: Compiler Error C2171" title: "Compiler Error C2171" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2171" +ms.date: 11/04/2016 f1_keywords: ["C2171"] helpviewer_keywords: ["C2171"] -ms.assetid: a80343b5-ab3f-4413-b6f1-3ce9d7e519e5 --- # Compiler Error C2171 -'operator' : illegal on operands of type 'type' +> 'operator' : illegal on operands of type 'type' + +## Remarks A unary operator is used with an invalid operand type. ## Examples -The following sample generates C2171. +The following example generates C2171. ```cpp // C2171.cpp @@ -28,7 +29,7 @@ int main() { } ``` -The following sample generates C2171. +The following example generates C2171. ```cpp // C2171_b.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2172.md b/docs/error-messages/compiler-errors-1/compiler-error-c2172.md index 8e2992bd811..55e01b5bb3a 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2172.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2172.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Compiler Error C2172" title: "Compiler Error C2172" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2172" +ms.date: 11/04/2016 f1_keywords: ["C2172"] helpviewer_keywords: ["C2172"] -ms.assetid: 31183ea7-858d-4273-932a-d865af7059b1 --- # Compiler Error C2172 -'function' : actual parameter is not a pointer : parameter number +> 'function' : actual parameter is not a pointer : parameter number + +## Remarks Parameter `number` is not a pointer. The function expects a pointer. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2173.md b/docs/error-messages/compiler-errors-1/compiler-error-c2173.md index 45dc2487855..fb92234298a 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2173.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2173.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Compiler Error C2173" title: "Compiler Error C2173" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2173" +ms.date: 11/04/2016 f1_keywords: ["C2173"] helpviewer_keywords: ["C2173"] -ms.assetid: 4df592b8-609b-41a5-b4fc-966eb5bb2d1a --- # Compiler Error C2173 -'function' : actual parameter is not a pointer : parameter number1, parameter list number2 +> 'function' : actual parameter is not a pointer : parameter number1, parameter list number2 + +## Remarks Parameter `number1` passed to parameter list `number2` is not a pointer. The function expects a pointer. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2174.md b/docs/error-messages/compiler-errors-1/compiler-error-c2174.md index bc685baa294..fe6702545fe 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2174.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2174.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Compiler Error C2174" title: "Compiler Error C2174" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2174" +ms.date: 11/04/2016 f1_keywords: ["C2174"] helpviewer_keywords: ["C2174"] -ms.assetid: 161d563c-76e9-47e9-9142-7812e9ea169e --- # Compiler Error C2174 -'function' : actual parameter has type 'void' : parameter number1, parameter list number2 +> 'function' : actual parameter has type 'void' : parameter number1, parameter list number2 + +## Remarks Parameter `number1` passed to parameter list `number2` is a **`void`** parameter. Parameters cannot have type **`void`**. Use **`void*`** instead. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2175.md b/docs/error-messages/compiler-errors-1/compiler-error-c2175.md index 4f210813ce0..32d47e23c22 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2175.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2175.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Compiler Error C2175" title: "Compiler Error C2175" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2175" +ms.date: 11/04/2016 f1_keywords: ["C2175"] helpviewer_keywords: ["C2175"] -ms.assetid: 3a8fa90b-2b29-414a-bb55-cf27c2bf989a --- # Compiler Error C2175 -'locale' : invalid locale +> 'locale' : invalid locale + +## Remarks The specified locale is not valid. See [Language and Country/Region Strings](../../c-runtime-library/locale-names-languages-and-country-region-strings.md) in the *Run-Time Library Reference* for supported locales. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2177.md b/docs/error-messages/compiler-errors-1/compiler-error-c2177.md index a69d0bcd35b..e448186bf1a 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2177.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2177.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2177" title: "Compiler Error C2177" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2177" +ms.date: 11/04/2016 f1_keywords: ["C2177"] helpviewer_keywords: ["C2177"] -ms.assetid: 2a39a880-cddb-4d3e-a572-645a14c4c478 --- # Compiler Error C2177 -constant too big +> constant too big + +## Remarks A constant value is too large for the variable type it is assigned. -The following sample generates C2177: +## Example + +The following example generates C2177: ```cpp // C2177.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2178.md b/docs/error-messages/compiler-errors-1/compiler-error-c2178.md index b9aecbda49c..4c93e6c79d6 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2178.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2178.md @@ -1,32 +1,51 @@ --- -description: "Learn more about: Compiler Error C2178" title: "Compiler Error C2178" -ms.date: "05/08/2017" +description: "Learn more about: Compiler Error C2178" +ms.date: 08/11/2025 f1_keywords: ["C2178"] helpviewer_keywords: ["C2178"] -ms.assetid: 79a14158-17f3-4221-bd06-9d675c49cef4 --- # Compiler Error C2178 -'*identifier*' cannot be declared with '*specifier*' specifier +> '*identifier*' cannot be declared with '*specifier*' specifier + +## Remarks -A **`mutable`** specifier was used in a declaration, but the specifier is not allowed in this context. +A **`mutable`** specifier was used in a declaration, but the specifier is not allowed in this context. It can only be applied to non-static, non-const, and non-reference data members. For more information, see [Mutable Data Members](../../cpp/mutable-data-members-cpp.md). -The **`mutable`** specifier can be applied only to names of class data members, and cannot be applied to names declared **`const`** or **`static`**, and cannot be applied to reference members. +A **`consteval`** specifier was used on a [destructor](../../cpp/destructors-cpp.md), allocation function, or deallocation function. -## Example +## Example: `mutable` -The following sample shows how C2178 may occur, and how to fix it. +The following example shows how C2178 may occur with the **`mutable`** specifier, and how to resolve it: ```cpp -// C2178.cpp -// compile with: cl /c /W4 C2178.cpp +// C2178_mutable.cpp +// compile with: /c -class S { - mutable const int i; // C2178 - // To fix, declare either const or mutable, not both. +struct S +{ + mutable const int i; // C2178, remove mutable or const to resolve }; -mutable int x = 4; // C2178 -// To fix, remove mutable keyword +mutable int x = 4; // C2178, remove mutable to resolve +``` + +## Example: `consteval` + +The following example shows how C2178 may occur with the **`consteval`** specifier. To resolve this error, remove all **`consteval`** specifiers: + +```cpp +// C2178_consteval.cpp +// compile with: /c /std:c++20 + +#include + +struct S +{ + consteval ~S() {} // C2178 + + consteval static void* operator new(std::size_t size); // C2178 + consteval static void operator delete(void* ptr); // C2178 +}; ``` diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2179.md b/docs/error-messages/compiler-errors-1/compiler-error-c2179.md index d1c9b3dc115..2f9baef3385 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2179.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2179.md @@ -1,20 +1,21 @@ --- -description: "Learn more about: Compiler Error C2179" title: "Compiler Error C2179" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2179" +ms.date: 11/04/2016 f1_keywords: ["C2179"] helpviewer_keywords: ["C2179"] -ms.assetid: f929bfc6-3964-4e54-87d6-7529b9b6c0b9 --- # Compiler Error C2179 -'type' : an attribute argument cannot use type parameters +> 'type' : an attribute argument cannot use type parameters + +## Remarks A generic type parameter is resolved at runtime. However, an attribute parameter must be resolved at compile time. Therefore, you cannot use a generic type parameter as an argument to an attribute. ## Example -The following sample generates C2179. +The following example generates C2179. ```cpp // C2179.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2180.md b/docs/error-messages/compiler-errors-1/compiler-error-c2180.md index 30c5e6e220f..d9f8803ca2b 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2180.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2180.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2180" title: "Compiler Error C2180" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2180" +ms.date: 11/04/2016 f1_keywords: ["C2180"] helpviewer_keywords: ["C2180"] -ms.assetid: ea71b39e-b977-48a7-b7bd-af68ef5e263b --- # Compiler Error C2180 -controlling expression has type 'type' +> controlling expression has type 'type' + +## Remarks The controlling expression in an **`if`**, **`while`**, **`for`**, or **`do`** statement is an expression cast to **`void`**. To fix this issue, change the controlling expression to one that produces a **`bool`** or a type that can be converted to **`bool`**. -The following sample generates C2180: +## Example + +The following example generates C2180: ```c // C2180.c diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2181.md b/docs/error-messages/compiler-errors-1/compiler-error-c2181.md index e3ca226ad79..be880ea0e88 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2181.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2181.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2181" title: "Compiler Error C2181" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2181" +ms.date: 11/04/2016 f1_keywords: ["C2181"] helpviewer_keywords: ["C2181"] -ms.assetid: d52b2fe4-566a-40a9-b8e2-8dce1f287668 --- # Compiler Error C2181 -illegal else without matching if +> illegal else without matching if + +## Remarks Each **`else`** must have a matching **`if`**. -The following sample generates C2181: +## Example + +The following example generates C2181: ```cpp // C2181.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2182.md b/docs/error-messages/compiler-errors-1/compiler-error-c2182.md index 6aef2bbc657..cbe5f56228d 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2182.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2182.md @@ -1,25 +1,28 @@ --- -description: "Learn more about: Compiler Error C2182" title: "Compiler Error C2182" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2182" +ms.date: 08/22/2025 f1_keywords: ["C2182"] helpviewer_keywords: ["C2182"] -ms.assetid: dfd8d47d-9606-496e-bd96-4bf41ba1f857 --- # Compiler Error C2182 -'identifier' : illegal use of type 'void' +> '*identifier*': this use of 'void' is not valid + +## Remarks -A variable is declared type **`void`**. +You can't create a variable or array of type **`void`**. Only pointers to **`void`** are allowed. -The following sample generates C2182: +## Example + +The following example generates C2182: ```cpp // C2182.cpp // compile with: /c -int main() { - int i = 10; - void &ir = i; // C2182 cannot have a reference to type void - int &ir = i; // OK -} + +void var; // C2182 +void arr[5]; // C2182 + +void* ptr; // OK ``` diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2183.md b/docs/error-messages/compiler-errors-1/compiler-error-c2183.md index 85d58a53721..95d0ed0a559 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2183.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2183.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Compiler Error C2183" title: "Compiler Error C2183" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2183" +ms.date: 11/04/2016 f1_keywords: ["C2183"] helpviewer_keywords: ["C2183"] -ms.assetid: 03d2d010-a276-4ac3-820c-159abd8b1222 --- # Compiler Error C2183 -syntax error: translation unit is empty +> syntax error: translation unit is empty + +## Remarks Preprocessing produced an empty source file. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2184.md b/docs/error-messages/compiler-errors-1/compiler-error-c2184.md index 3d038496347..bee34695f9b 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2184.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2184.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2184" title: "Compiler Error C2184" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2184" +ms.date: 11/04/2016 f1_keywords: ["C2184"] helpviewer_keywords: ["C2184"] -ms.assetid: 80fc8bff-7d76-4bde-94d2-01d84bb6824a --- # Compiler Error C2184 -'type' : illegal type for __except expression, must be an integral +> 'type' : illegal type for __except expression, must be an integral + +## Remarks A type was used in an [__except](../../c-language/try-except-statement-c.md) statement, but the type is not allowed. -The following sample generates C2184: +## Example + +The following example generates C2184: ```cpp // C2184.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2185.md b/docs/error-messages/compiler-errors-1/compiler-error-c2185.md index b6db0922903..0137134698f 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2185.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2185.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Compiler Error C2185" title: "Compiler Error C2185" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2185" +ms.date: 11/04/2016 f1_keywords: ["C2185"] helpviewer_keywords: ["C2185"] -ms.assetid: 74bc9f64-7b4c-4735-ba13-67c43f8c47db --- # Compiler Error C2185 -'identifier' : illegal based allocation +> 'identifier' : illegal based allocation + +## Remarks A register variable or automatic (local) variable is declared **`__based`**. Only global variables can be declared **`__based`**. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2186.md b/docs/error-messages/compiler-errors-1/compiler-error-c2186.md index 749be6dcbc4..e2ad100f3de 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2186.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2186.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2186" title: "Compiler Error C2186" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2186" +ms.date: 11/04/2016 f1_keywords: ["C2186"] helpviewer_keywords: ["C2186"] -ms.assetid: 284bfb7e-ab85-4fcb-9864-1ddf7f6c94ae --- # Compiler Error C2186 -'operator' : illegal operand of type 'void' +> 'operator' : illegal operand of type 'void' + +## Remarks The operator has a **`void`** operand. -The following sample generates C2186: +## Example + +The following example generates C2186: ```cpp // C2186.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2188.md b/docs/error-messages/compiler-errors-1/compiler-error-c2188.md index 74433b09195..e6bc3822cd9 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2188.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2188.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Compiler Error C2188" title: "Compiler Error C2188" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2188" +ms.date: 11/04/2016 f1_keywords: ["C2188"] helpviewer_keywords: ["C2188"] -ms.assetid: 2223147f-e487-4090-acdf-75ba4e1114f6 --- # Compiler Error C2188 -'number' : too big for wide character +> 'number' : too big for wide character + +## Remarks The number exceeds the size limit for the wide-character type. Choose a larger type. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2190.md b/docs/error-messages/compiler-errors-1/compiler-error-c2190.md index a1a2c41a07e..8c9adb4ad4c 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2190.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2190.md @@ -1,23 +1,32 @@ --- -description: "Learn more about: Compiler Error C2190" title: "Compiler Error C2190" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2190" +ms.date: 08/22/2025 f1_keywords: ["C2190"] helpviewer_keywords: ["C2190"] -ms.assetid: 34e15f85-d979-4948-80fc-46c414508a70 --- # Compiler Error C2190 -first parameter list longer than second +> first parameter list longer than second + +## Remarks + +A C function was declared a second time with a shorter parameter list. C does not support overloaded functions. Without [`/Za`](../../build/reference/za-ze-disable-language-extensions.md), the compiler emits [Compiler Warning (level 1) C4030](../compiler-warnings/compiler-warning-level-1-c4030.md) instead. -A C function was declared a second time with a shorter parameter list. C does not support overloaded functions. +## Example -The following sample generates C2190: +The following example generates C2190: ```c // C2190.c // compile with: /Za /c -void func( int, float ); -void func( int ); // C2190, different parameter list -void func2( int ); // OK + +void func1(int, float); +void func1(int); // C2190, shorter parameter list + +void func2(int); // OK ``` + +## See also + +[Compiler Error C2191](compiler-error-c2191.md) diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2191.md b/docs/error-messages/compiler-errors-1/compiler-error-c2191.md index d55e9b6fc77..9644cee4889 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2191.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2191.md @@ -1,25 +1,32 @@ --- -description: "Learn more about: Compiler Error C2191" title: "Compiler Error C2191" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2191" +ms.date: 08/22/2025 f1_keywords: ["C2191"] helpviewer_keywords: ["C2191"] -ms.assetid: 051b8350-e5de-4f51-ab6e-96d32366bcef --- # Compiler Error C2191 -second parameter list longer than first +> second parameter list longer than first -A C function was declared a second time with a longer parameter list. C does not support overloaded functions. +## Remarks + +A C function was declared a second time with a longer parameter list. C does not support overloaded functions. Without [`/Za`](../../build/reference/za-ze-disable-language-extensions.md), the compiler emits [Compiler Warning (level 1) C4031](../compiler-warnings/compiler-warning-level-1-c4031.md) instead. ## Example -The following sample generates C2191: +The following example generates C2191: ```c // C2191.c // compile with: /Za /c -void func( int ); -void func( int, float ); // C2191 different parameter list -void func2( int, float ); // OK + +void func1(int); +void func1(int, float); // C2191, longer parameter list + +void func2(int, float); // OK ``` + +## See also + +[Compiler Error C2190](compiler-error-c2190.md) diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2192.md b/docs/error-messages/compiler-errors-1/compiler-error-c2192.md index 3444f6a2d61..99ad0f1f3cd 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2192.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2192.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2192" title: "Compiler Error C2192" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2192" +ms.date: 11/04/2016 f1_keywords: ["C2192"] helpviewer_keywords: ["C2192"] -ms.assetid: a147197e-e72d-4620-939b-f9e08d7c7c12 --- # Compiler Error C2192 -parameter 'number' declaration different +> parameter 'number' declaration different + +## Remarks A C function was declared a second time with a different parameter list. C does not support overloaded functions. -The following sample generates C2192: +## Example + +The following example generates C2192: ```c // C2192.c diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2193.md b/docs/error-messages/compiler-errors-1/compiler-error-c2193.md index 8175641f502..3ccc804d025 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2193.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2193.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2193" title: "Compiler Error C2193" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2193" +ms.date: 11/04/2016 f1_keywords: ["C2193"] helpviewer_keywords: ["C2193"] -ms.assetid: 9813e853-d581-4f51-bb75-4e242298a844 --- # Compiler Error C2193 -'identifier' : already in a segment +> 'identifier' : already in a segment + +## Remarks A function was placed in two different segments using `alloc_text` and `code_seg` pragmas. -The following sample generates C2193: +## Example + +The following example generates C2193: ```cpp // C2193.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2194.md b/docs/error-messages/compiler-errors-1/compiler-error-c2194.md index 97e108884eb..371a93bf9f7 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2194.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2194.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2194" title: "Compiler Error C2194" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2194" +ms.date: 11/04/2016 f1_keywords: ["C2194"] helpviewer_keywords: ["C2194"] -ms.assetid: df6e631c-0062-4844-9088-4cc7a0ff879f --- # Compiler Error C2194 -'identifier' : is a text segment +> 'identifier' : is a text segment + +## Remarks The `data_seg` pragma uses a segment name used with `code_seg`. -The following sample generates C2194: +## Example + +The following example generates C2194: ```cpp // C2194.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2195.md b/docs/error-messages/compiler-errors-1/compiler-error-c2195.md index 34f1655447b..04352aa63fa 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2195.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2195.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2195" title: "Compiler Error C2195" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2195" +ms.date: 11/04/2016 f1_keywords: ["C2195"] helpviewer_keywords: ["C2195"] -ms.assetid: 9f9f035c-9c51-4173-a8ea-c6f907fc5c63 --- # Compiler Error C2195 -'identifier' : is a data segment +> 'identifier' : is a data segment + +## Remarks The `code_seg` pragma uses a segment name used with the `data_seg` pragma. -The following sample generates C2195: +## Example + +The following example generates C2195: ```cpp // C2195.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2196.md b/docs/error-messages/compiler-errors-1/compiler-error-c2196.md index e3e854bae89..d36f92c67ec 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2196.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2196.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2196" title: "Compiler Error C2196" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2196" +ms.date: 11/04/2016 f1_keywords: ["C2196"] helpviewer_keywords: ["C2196"] -ms.assetid: fd2f6a58-48ce-4e58-96f8-e37720feb8e7 --- # Compiler Error C2196 -case value 'value' already used. +> case value 'value' already used. + +## Remarks A switch statement uses the same case value more than once. -The following sample generates C2196: +## Example + +The following example generates C2196: ```cpp // C2196.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2197.md b/docs/error-messages/compiler-errors-1/compiler-error-c2197.md index d59180593bc..ea6795bcdd4 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2197.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2197.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2197" title: "Compiler Error C2197" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2197" +ms.date: 11/04/2016 f1_keywords: ["C2197"] helpviewer_keywords: ["C2197"] -ms.assetid: 6dd5a6ec-bc80-41b9-a4ac-46f80eaca42d --- # Compiler Error C2197 -'function' : too many arguments for call +> 'function' : too many arguments for call + +## Remarks The compiler detected too many parameters for a call to the function, or an incorrect function declaration. -The following sample generates C2197: +## Example + +The following example generates C2197: ```c // C2197.c diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2198.md b/docs/error-messages/compiler-errors-1/compiler-error-c2198.md index 56e12832c9b..e200cd44285 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2198.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2198.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2198" title: "Compiler Error C2198" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2198" +ms.date: 11/04/2016 f1_keywords: ["C2198"] helpviewer_keywords: ["C2198"] -ms.assetid: 638a845c-9d7f-4115-a9aa-d72455605668 --- # Compiler Error C2198 -'function' : too few arguments for call +> 'function' : too few arguments for call + +## Remarks The compiler found too few parameters for a call to the function, or an incorrect function declaration. -The following sample generates C2198: +## Example + +The following example generates C2198: ```c // C2198.c diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2199.md b/docs/error-messages/compiler-errors-1/compiler-error-c2199.md index 74067b233cc..91384b33bda 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2199.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2199.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2199" title: "Compiler Error C2199" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2199" +ms.date: 11/04/2016 f1_keywords: ["C2199"] helpviewer_keywords: ["C2199"] -ms.assetid: 6a92a1b7-7906-49e6-a31f-e8bffbc7706a --- # Compiler Error C2199 -syntax error : found 'identifier (' at global scope (was a declaration intended?) +> syntax error : found 'identifier (' at global scope (was a declaration intended?) + +## Remarks The specified context caused a syntax error. There may be incorrect declaration syntax. -The following sample generates C2199: +## Example + +The following example generates C2199: ```cpp // C2199.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2200.md b/docs/error-messages/compiler-errors-1/compiler-error-c2200.md index bc39dfceb86..5ef2473a21f 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2200.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2200.md @@ -1,13 +1,25 @@ --- -description: "Learn more about: Compiler Error C2200" title: "Compiler Error C2200" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2200" +ms.date: 02/15/2025 f1_keywords: ["C2200"] helpviewer_keywords: ["C2200"] -ms.assetid: a04139a6-ce18-404b-9bfd-2369fc0af3cb --- # Compiler Error C2200 -'function' : function has already been defined +> 'function': function has already been defined + +## Remarks + +An [`alloc_text`](../../preprocessor/alloc-text.md) pragma uses a function name already defined. Ensure the `alloc_text` pragma appears after the function declaration but before its definition. + +## Example + +The following example generates C2200: -An `alloc_text` pragma uses a function name already defined. +```cpp +// C2200.cpp +// compile with: /c +extern "C" void func() {} +#pragma alloc_text("section", func) // C2200 +``` diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2201.md b/docs/error-messages/compiler-errors-1/compiler-error-c2201.md index aa9d5356317..4be33f800de 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2201.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2201.md @@ -1,6 +1,6 @@ --- -description: "Learn more about: Compiler Error C2201" title: "Compiler Error C2201" +description: "Learn more about: Compiler Error C2201" ms.date: 05/03/2021 f1_keywords: ["C2201"] helpviewer_keywords: ["C2201"] @@ -9,11 +9,13 @@ helpviewer_keywords: ["C2201"] > '*identifier*' : must have external linkage in order to be exported/imported +## Remarks + The exported identifier is **`static`**. ## Example -The following sample generates C2286, and shows how to fix it: +The following example generates C2201, and shows how to fix it: ```cpp // C2201.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2203.md b/docs/error-messages/compiler-errors-1/compiler-error-c2203.md index 6171c53c18a..1850f52d271 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2203.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2203.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2203" title: "Compiler Error C2203" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2203" +ms.date: 11/04/2016 f1_keywords: ["C2203"] helpviewer_keywords: ["C2203"] -ms.assetid: 5497df43-86f6-43d5-b6cb-723c4c589b10 --- # Compiler Error C2203 -delete operator cannot specify bounds for an array +> delete operator cannot specify bounds for an array + +## Remarks With the **/Za** (ANSI) option, the **`delete`** operator can delete an entire array but not parts or specific members of the array. -The following sample generates C2203: +## Example + +The following example generates C2203: ```cpp // C2203.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2204.md b/docs/error-messages/compiler-errors-1/compiler-error-c2204.md index 001aefd823c..b09f6a116a9 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2204.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2204.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Compiler Error C2204" title: "Compiler Error C2204" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2204" +ms.date: 11/04/2016 f1_keywords: ["C2204"] helpviewer_keywords: ["C2204"] -ms.assetid: bbe506d4-7863-44af-8709-161881c4b4ba --- # Compiler Error C2204 -'type' : type definition found within parentheses +> 'type' : type definition found within parentheses + +## Remarks The type is defined as an operand or in prototype scope. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2205.md b/docs/error-messages/compiler-errors-1/compiler-error-c2205.md index 933e5828067..6b073e8cc7c 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2205.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2205.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Compiler Error C2205" title: "Compiler Error C2205" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2205" +ms.date: 11/04/2016 f1_keywords: ["C2205"] helpviewer_keywords: ["C2205"] -ms.assetid: bfc19840-4a48-4da5-8e69-7069989f1d2c --- # Compiler Error C2205 -'identifier' : cannot initialize extern variables with block scope +> 'identifier' : cannot initialize extern variables with block scope + +## Remarks An **`extern`** variable cannot be initialized in a function. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2206.md b/docs/error-messages/compiler-errors-1/compiler-error-c2206.md index ecc111e042f..611865407d5 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2206.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2206.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2206" title: "Compiler Error C2206" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2206" +ms.date: 11/04/2016 f1_keywords: ["C2206"] helpviewer_keywords: ["C2206"] -ms.assetid: d7fba68b-aa28-4885-a9a0-27107358f066 --- # Compiler Error C2206 -'function' : typedef cannot be used for function definition +> 'function' : typedef cannot be used for function definition + +## Remarks A **`typedef`** is used to define a function type. -The following sample generates C2206: +## Example + +The following example generates C2206: ```cpp // C2206.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2207.md b/docs/error-messages/compiler-errors-1/compiler-error-c2207.md index 1f1fffd0dd9..fab75ec1e1e 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2207.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2207.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Compiler Error C2207" title: "Compiler Error C2207" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2207" +ms.date: 11/04/2016 f1_keywords: ["C2207"] helpviewer_keywords: ["C2207"] -ms.assetid: d7d7b537-68f1-420a-9835-b5b6f2cb5cfd --- # Compiler Error C2207 -'member': a member of a class template cannot acquire a function type +> 'member': a member of a class template cannot acquire a function type + +## Remarks The `member` of the class template was previously parsed as a non-static data member. It cannot be redefined as a member function. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2208.md b/docs/error-messages/compiler-errors-1/compiler-error-c2208.md index b191a057341..6c3ca308787 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2208.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2208.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2208" title: "Compiler Error C2208" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2208" +ms.date: 11/04/2016 f1_keywords: ["C2208"] helpviewer_keywords: ["C2208"] -ms.assetid: 9ae704bc-bf70-45f1-8e47-0470f21edd4e --- # Compiler Error C2208 -'type' : no members defined using this type +> 'type' : no members defined using this type + +## Remarks An identifier resolving to a type name is in an aggregate declaration, but the compiler cannot declare a member. -The following sample generates C2208: +## Example + +The following example generates C2208: ```cpp // C2208.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2212.md b/docs/error-messages/compiler-errors-1/compiler-error-c2212.md index db3551919f0..16a9f9f198b 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2212.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2212.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Compiler Error C2212" title: "Compiler Error C2212" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2212" +ms.date: 11/04/2016 f1_keywords: ["C2212"] helpviewer_keywords: ["C2212"] -ms.assetid: 3fdab304-272c-4d07-bfd4-fad75170e536 --- # Compiler Error C2212 -'identifier' : __based not available for pointers to functions +> 'identifier' : __based not available for pointers to functions + +## Remarks Pointers to functions cannot be declared **`__based`**. If you need code-based data, use the **`__declspec`** keyword or the `data_seg` pragma. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2213.md b/docs/error-messages/compiler-errors-1/compiler-error-c2213.md index ef1d970869d..667f53b64db 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2213.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2213.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2213" title: "Compiler Error C2213" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2213" +ms.date: 11/04/2016 f1_keywords: ["C2213"] helpviewer_keywords: ["C2213"] -ms.assetid: ff012278-7f3b-4d49-aaed-2349756f6225 --- # Compiler Error C2213 -'modifier' : illegal argument to __based +> 'modifier' : illegal argument to __based + +## Remarks The argument modifying **`__based`** is invalid. -The following sample generates C2213: +## Example + +The following example generates C2213: ```cpp // C2213.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2216.md b/docs/error-messages/compiler-errors-1/compiler-error-c2216.md index 51d2a53818b..5d0d49c0e9e 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2216.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2216.md @@ -1,20 +1,21 @@ --- -description: "Learn more about: Compiler Error C2216" title: "Compiler Error C2216" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2216" +ms.date: 11/04/2016 f1_keywords: ["C2216"] helpviewer_keywords: ["C2216"] -ms.assetid: 250f6bdc-a5e1-495f-a1e8-6e8e7021ad9d --- # Compiler Error C2216 -'keyword1' cannot be used with ' keyword2' +> 'keyword1' cannot be used with ' keyword2' + +## Remarks Two keywords that are mutually exclusive were used together. ## Examples -The following sample generates C2216. +The following example generates C2216. ```cpp // C2216.cpp @@ -25,7 +26,7 @@ ref struct Y1 { }; ``` -The following sample generates C2216. +The following example generates C2216. ```cpp // C2216b.cpp @@ -36,7 +37,7 @@ public ref class X { }; ``` -The following sample generates C2216. +The following example generates C2216. ```cpp // C2216c.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2217.md b/docs/error-messages/compiler-errors-1/compiler-error-c2217.md index 009e512bf14..b13e45b5eec 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2217.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2217.md @@ -1,20 +1,21 @@ --- -description: "Learn more about: Compiler Error C2217" title: "Compiler Error C2217" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2217" +ms.date: 11/04/2016 f1_keywords: ["C2217"] helpviewer_keywords: ["C2217"] -ms.assetid: 1ce1e3f5-4171-4376-804d-967f7e612935 --- # Compiler Error C2217 -'attribute1' requires 'attribute2' +> 'attribute1' requires 'attribute2' + +## Remarks The first function attribute requires the second attribute. ## Example -C2217 can occur if you attempt to bind a delegate to a CLR function that takes a variable number of arguments. If the function also has a param array overload, use that instead. The following sample generates C2217. +C2217 can occur if you attempt to bind a delegate to a CLR function that takes a variable number of arguments. If the function also has a param array overload, use that instead. The following example generates C2217. ```cpp // C2217.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2218.md b/docs/error-messages/compiler-errors-1/compiler-error-c2218.md index a5f96212403..07e17522d3b 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2218.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2218.md @@ -1,15 +1,16 @@ --- -description: "Learn more about: Compiler Error C2218" title: "Compiler Error C2218" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2218" +ms.date: 11/04/2016 f1_keywords: ["C2218"] helpviewer_keywords: ["C2218"] -ms.assetid: b0f55da4-8edb-4b45-b298-1a091981bd7b --- # Compiler Error C2218 > '__vectorcall' cannot be used with '/arch:IA32' +## Remarks + The **`__vectorcall`** calling convention is only supported in native code on x86 and x64 processors that include Streaming SIMD Extensions 2 (SSE2) and above. For more information, see [`__vectorcall`](../../cpp/vectorcall.md). To fix this error, change the compiler options to target SSE2, AVX or AVX2 instruction sets. For more information, see [`/arch` (x86)](../../build/reference/arch-x86.md). diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2219.md b/docs/error-messages/compiler-errors-1/compiler-error-c2219.md index eb2fc27f7dd..499519f546c 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2219.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2219.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Compiler Error C2219" title: "Compiler Error C2219" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2219" +ms.date: 11/04/2016 f1_keywords: ["C2219"] helpviewer_keywords: ["C2219"] -ms.assetid: 2cfe9a75-6890-46a1-a127-79a7def78e94 --- # Compiler Error C2219 -syntax error : type qualifier must be after '*' +> syntax error : type qualifier must be after '*' + +## Remarks Type qualifier (**`const`** or **`volatile`**) appears where it is not permitted. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2220.md b/docs/error-messages/compiler-errors-1/compiler-error-c2220.md index edfa71f27b2..0660cff0df4 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2220.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2220.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Error C2220" title: "Compiler Error C2220" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2220" +ms.date: 11/04/2016 f1_keywords: ["C2220"] helpviewer_keywords: ["C2220"] -ms.assetid: d610802c-64d7-40ad-a2a6-0ed0b6815a6c --- # Compiler Error C2220 -warning treated as error - no object file generated +> warning treated as error - no object file generated + +## Remarks [/WX](../../build/reference/compiler-option-warning-level.md) tells the compiler to treat all warnings as errors. Because an error occurred, no object or executable file was generated. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2222.md b/docs/error-messages/compiler-errors-1/compiler-error-c2222.md index 7d2bc23ae53..894171131f6 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2222.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2222.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Compiler Error C2222" title: "Compiler Error C2222" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2222" +ms.date: 11/04/2016 f1_keywords: ["C2222"] helpviewer_keywords: ["C2222"] -ms.assetid: 1c902054-5c77-41e6-a1cc-018f802460cd --- # Compiler Error C2222 -unexpected type 'type': a base-class or member was expected +> unexpected type 'type': a base-class or member was expected + +## Remarks The initializer list can only initialize base classes or members of a type. To fix this error, verify that only base classes or members of the type are initialized in the initializer list. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2223.md b/docs/error-messages/compiler-errors-1/compiler-error-c2223.md index cc9b7306391..4607f1838a6 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2223.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2223.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Error C2223" title: "Compiler Error C2223" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2223" +ms.date: 11/04/2016 f1_keywords: ["C2223"] helpviewer_keywords: ["C2223"] -ms.assetid: e4506f0f-0317-4a96-8a90-877a156d7939 --- # Compiler Error C2223 -left of '->identifier' must point to struct/union +> left of '->identifier' must point to struct/union + +## Remarks The operand to the left of `->` is not a pointer to a class, structure, or union. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2224.md b/docs/error-messages/compiler-errors-1/compiler-error-c2224.md index 7bd87633ef8..7d13d46a0e9 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2224.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2224.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Error C2224" title: "Compiler Error C2224" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2224" +ms.date: 11/04/2016 f1_keywords: ["C2224"] helpviewer_keywords: ["C2224"] -ms.assetid: 27b93bbf-4ce7-47a3-a9c4-f4fbed689bdf --- # Compiler Error C2224 -left of '.identifier' must have struct/union type +> left of '.identifier' must have struct/union type + +## Remarks The operand to the left of the period (.) is not a class, structure, or union. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2226.md b/docs/error-messages/compiler-errors-1/compiler-error-c2226.md index 5ad3e477754..7576eab5fea 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2226.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2226.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Compiler Error C2226" title: "Compiler Error C2226" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2226" +ms.date: 11/04/2016 f1_keywords: ["C2226"] helpviewer_keywords: ["C2226"] -ms.assetid: b3aaa2a5-254a-46a9-a508-de2371ecffeb --- # Compiler Error C2226 -syntax error : unexpected type 'type' +> syntax error : unexpected type 'type' + +## Remarks A syntax error occurs before or in the type specifier. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2227.md b/docs/error-messages/compiler-errors-1/compiler-error-c2227.md index 15613f96e17..4c84efc13a6 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2227.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2227.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2227" title: "Compiler Error C2227" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2227" +ms.date: 11/04/2016 f1_keywords: ["C2227"] helpviewer_keywords: ["C2227"] -ms.assetid: d470e8b8-7e15-468b-84fa-37d1a0132271 --- # Compiler Error C2227 -left of '->member' must point to class/struct/union/generic type +> left of '->member' must point to class/struct/union/generic type + +## Remarks The operand to the left of `->` is not a pointer to a class, structure, or union. -The following sample generates C2227: +## Example + +The following example generates C2227: ```cpp // C2227.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2228.md b/docs/error-messages/compiler-errors-1/compiler-error-c2228.md index d8cc1b4db97..f0605e69fc8 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2228.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2228.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2228" title: "Compiler Error C2228" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2228" +ms.date: 11/04/2016 f1_keywords: ["C2228"] helpviewer_keywords: ["C2228"] -ms.assetid: 901cadb1-ce90-4ae0-a360-547a9ba2ca18 --- # Compiler Error C2228 -left of '.identifier' must have class/struct/union +> left of '.identifier' must have class/struct/union + +## Remarks The operand to the left of the period (.) is not a class, structure, or union. -The following sample generates C2228: +## Example + +The following example generates C2228: ```cpp // C2228.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2229.md b/docs/error-messages/compiler-errors-1/compiler-error-c2229.md index 24ce025b2cd..a77432e3f15 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2229.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2229.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Error C2229" title: "Compiler Error C2229" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2229" +ms.date: 11/04/2016 f1_keywords: ["C2229"] helpviewer_keywords: ["C2229"] -ms.assetid: 933c7cf2-a463-4e74-b0b4-59dedad987fb --- # Compiler Error C2229 -type 'identifier' has an illegal zero-sized array +> type 'identifier' has an illegal zero-sized array + +## Remarks A member of a structure or bit field contains a zero-sized array that is not the last member. @@ -16,7 +17,9 @@ Because you can have a zero sized array as the last member of the struct, you mu If the zero sized array is not the last member of the struct, the compiler can't calculate the offset for the remaining fields. -The following sample generates C2229: +## Example + +The following example generates C2229: ```cpp // C2229.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2231.md b/docs/error-messages/compiler-errors-1/compiler-error-c2231.md index 6f95cb15e9f..a3ab0edc007 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2231.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2231.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2231" title: "Compiler Error C2231" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2231" +ms.date: 11/04/2016 f1_keywords: ["C2231"] helpviewer_keywords: ["C2231"] -ms.assetid: 677c5c66-d30f-4c3b-bbb9-760858d56477 --- # Compiler Error C2231 -'.' : left operand points to 'class-key', use '->' +> '.' : left operand points to 'class-key', use '->' + +## Remarks The operand to the left of the member-selection operation (.) is a pointer instead of a class, structure, or union. -The following sample generates C2231: +## Example + +The following example generates C2231: ```c // C2231.c diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2232.md b/docs/error-messages/compiler-errors-1/compiler-error-c2232.md index 46af61cbe1f..58ab4d67d20 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2232.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2232.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2232" title: "Compiler Error C2232" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2232" +ms.date: 11/04/2016 f1_keywords: ["C2232"] helpviewer_keywords: ["C2232"] -ms.assetid: 76f302b7-30a7-4a81-9a39-b4edde33b54c --- # Compiler Error C2232 -'->' : left operand has 'class-key' type, use '.' +> '->' : left operand has 'class-key' type, use '.' + +## Remarks The operand to the left of the `->` operator is not a pointer. Use the period (.) operator for a class, structure, or union. -The following sample generates C2232: +## Example + +The following example generates C2232: ```c // C2232.c diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2233.md b/docs/error-messages/compiler-errors-1/compiler-error-c2233.md index cb1b6646bc1..941d8ee870c 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2233.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2233.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2233" title: "Compiler Error C2233" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2233" +ms.date: 11/04/2016 f1_keywords: ["C2233"] helpviewer_keywords: ["C2233"] -ms.assetid: 236bdf0b-9607-4f26-a249-d8def0b1333c --- # Compiler Error C2233 -'identifier' : arrays of objects containing zero-size arrays are illegal +> 'identifier' : arrays of objects containing zero-size arrays are illegal + +## Remarks Each object in an array must contain at least one element. -The following sample generates C2233: +## Example + +The following example generates C2233: ```cpp // C2233.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2234.md b/docs/error-messages/compiler-errors-1/compiler-error-c2234.md index 2b08baaddf2..df26be2eea1 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2234.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2234.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2234" title: "Compiler Error C2234" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2234" +ms.date: 11/04/2016 f1_keywords: ["C2234"] helpviewer_keywords: ["C2234"] -ms.assetid: cfa42458-c803-4717-a017-9eca1c0cbfb0 --- # Compiler Error C2234 -'name' : arrays of references are illegal +> 'name' : arrays of references are illegal + +## Remarks Because pointers to references are not allowed, arrays of references are not possible. -The following sample generates C2234: +## Example + +The following example generates C2234: ```cpp // C2234.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2236.md b/docs/error-messages/compiler-errors-1/compiler-error-c2236.md index fee5e16f054..4fc2c582fb4 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2236.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2236.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2236" title: "Compiler Error C2236" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2236" +ms.date: 11/04/2016 f1_keywords: ["C2236"] helpviewer_keywords: ["C2236"] -ms.assetid: 0b6771a7-a783-4729-9c3d-7a3339c432cc --- # Compiler Error C2236 -unexpected token 'identifier'. Did you forget a ';'? +> unexpected token 'identifier'. Did you forget a ';'? + +## Remarks The identifier is already defined as a type and cannot be overridden by a user-defined type. -The following sample generates C2236: +## Example + +The following example generates C2236: ```cpp // C2236.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2238.md b/docs/error-messages/compiler-errors-1/compiler-error-c2238.md index 26743ab065b..36610cb8a82 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2238.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2238.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2238" title: "Compiler Error C2238" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2238" +ms.date: 11/04/2016 f1_keywords: ["C2238"] helpviewer_keywords: ["C2238"] -ms.assetid: 3d53060c-d6b7-4603-b9cf-d7c65eb64cd2 --- # Compiler Error C2238 -unexpected token(s) preceding 'token' +> unexpected token(s) preceding 'token' + +## Remarks An incorrect token was found. -The following sample generates C2238: +## Example + +The following example generates C2238: ```cpp // C2238.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2241.md b/docs/error-messages/compiler-errors-1/compiler-error-c2241.md index f1793fd8d9b..1b3217d46fa 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2241.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2241.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Error C2241" title: "Compiler Error C2241" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2241" +ms.date: 11/04/2016 f1_keywords: ["C2241"] helpviewer_keywords: ["C2241"] -ms.assetid: 2f4e2c2c-b95c-4afe-bbe0-4214cd39d140 --- # Compiler Error C2241 -'identifier' : member access is restricted +> 'identifier' : member access is restricted + +## Remarks Code attempts to access a private or protected member. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2242.md b/docs/error-messages/compiler-errors-1/compiler-error-c2242.md index ccf78a2612b..d7401ce7584 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2242.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2242.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Compiler Error C2242" title: "Compiler Error C2242" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2242" +ms.date: 11/04/2016 f1_keywords: ["C2242"] helpviewer_keywords: ["C2242"] -ms.assetid: e1b687ed-4460-4c26-9f7e-c43e65c6dd65 --- # Compiler Error C2242 -typedef name cannot follow class/struct/union +> typedef name cannot follow class/struct/union + +## Remarks A **`typedef`** name appears at the end of a qualified name. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2243.md b/docs/error-messages/compiler-errors-1/compiler-error-c2243.md index e12e7174e74..036a1ae997d 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2243.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2243.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2243" title: "Compiler Error C2243" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2243" +ms.date: 11/04/2016 f1_keywords: ["C2243"] helpviewer_keywords: ["C2243"] -ms.assetid: b90065bb-d251-4ba9-8b4c-280ee13fa9c0 --- # Compiler Error C2243 -'conversion type' conversion from 'type1' to 'type2' exists, but is inaccessible +> 'conversion type' conversion from 'type1' to 'type2' exists, but is inaccessible + +## Remarks Access protection (**`protected`** or **`private`**) prevented conversion from a pointer to a derived class to a pointer to the base class. -The following sample generates C2243: +## Example + +The following example generates C2243: ```cpp // C2243.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2244.md b/docs/error-messages/compiler-errors-1/compiler-error-c2244.md index eed68eeec0e..d0ae19f3282 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2244.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2244.md @@ -1,20 +1,23 @@ --- -description: "Learn more about: Compiler Error C2244" title: "Compiler Error C2244" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2244" +ms.date: 11/04/2016 f1_keywords: ["C2244"] helpviewer_keywords: ["C2244"] -ms.assetid: d9911c12-ceb5-4f93-ac47-b44a485215c2 --- # Compiler Error C2244 -'identifier' : unable to match function definition to an existing declaration +> 'identifier' : unable to match function definition to an existing declaration + +## Remarks An unusual use of the unary + operator was used in front of a function call that did not have parenthesis. This error only occurs in C++ projects. -The following sample generates C2244: +## Examples + +The following example generates C2244: ```cpp // C2244.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2245.md b/docs/error-messages/compiler-errors-1/compiler-error-c2245.md index cf96d1724c4..585fe22556b 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2245.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2245.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2245" title: "Compiler Error C2245" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2245" +ms.date: 11/04/2016 f1_keywords: ["C2245"] helpviewer_keywords: ["C2245"] -ms.assetid: 08aaeadf-10ec-485a-b2a6-6e775289082b --- # Compiler Error C2245 -non-existent member function 'function' specified as friend (member function signature does not match any overload) +> non-existent member function 'function' specified as friend (member function signature does not match any overload) + +## Remarks A function specified as a friend was not found by the compiler. -The following sample generates C2245: +## Example + +The following example generates C2245: ```cpp // C2245.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2246.md b/docs/error-messages/compiler-errors-1/compiler-error-c2246.md index c2ebd50d80a..4055d44c346 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2246.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2246.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2246" title: "Compiler Error C2246" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2246" +ms.date: 11/04/2016 f1_keywords: ["C2246"] helpviewer_keywords: ["C2246"] -ms.assetid: 4f3e4f83-21f3-4256-af96-43e0bb060311 --- # Compiler Error C2246 -'identifier' : illegal static data member in locally defined class +> 'identifier' : illegal static data member in locally defined class + +## Remarks A member of a class, structure, or union with local scope is declared **`static`**. -The following sample generates C2246: +## Example + +The following example generates C2246: ```cpp // C2246.cpp @@ -20,5 +23,5 @@ The following sample generates C2246: void func( void ) { class A { static int i; }; // C2246 i is local to func static int j; // OK -}; +} ``` diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2247.md b/docs/error-messages/compiler-errors-1/compiler-error-c2247.md index 6fb7fea7989..e658316482a 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2247.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2247.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2247" title: "Compiler Error C2247" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2247" +ms.date: 11/04/2016 f1_keywords: ["C2247"] helpviewer_keywords: ["C2247"] -ms.assetid: 72efa03e-615e-4ef9-aede-0a98654b20fd --- # Compiler Error C2247 -'identifier' not accessible because 'class' uses 'specifier' to inherit from 'class' +> 'identifier' not accessible because 'class' uses 'specifier' to inherit from 'class' + +## Remarks `identifier` is inherited from a class declared with private or protected access. -The following sample generates C2247: +## Examples + +The following example generates C2247: ```cpp // C2247.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2248.md b/docs/error-messages/compiler-errors-1/compiler-error-c2248.md index 81f0232666f..6a240fa1ff8 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2248.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2248.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2248" title: "Compiler Error C2248" +description: "Learn more about: Compiler Error C2248" ms.date: 09/27/2022 f1_keywords: ["C2248"] helpviewer_keywords: ["C2248"] -ms.assetid: 7a3ba0e8-d3b9-4bb9-95db-81ef17e31d23 --- # Compiler Error C2248 @@ -14,9 +13,9 @@ ms.assetid: 7a3ba0e8-d3b9-4bb9-95db-81ef17e31d23 Members of a derived class can't access **`private`** members of a base class. You can't access **`private`** or **`protected`** members of class instances. -## Example +## Examples -The following sample generates C2248 when `private` or `protected` members of a class are accessed from outside the class. To fix this issue, don't access these members directly outside the class. Use `public` member data and member functions to interact with the class. +The following example generates C2248 when `private` or `protected` members of a class are accessed from outside the class. To fix this issue, don't access these members directly outside the class. Use `public` member data and member functions to interact with the class. ```cpp // C2248_access.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2249.md b/docs/error-messages/compiler-errors-1/compiler-error-c2249.md index 2b33cb4e285..59bdaa2294d 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2249.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2249.md @@ -1,28 +1,29 @@ --- -description: "Learn more about: Compiler Error C2249" title: "Compiler Error C2249" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2249" +ms.date: 11/04/2016 f1_keywords: ["C2249"] helpviewer_keywords: ["C2249"] -ms.assetid: bdd6697c-e04b-49b9-8e40-d9eb6d74f2b6 --- # Compiler Error C2249 -'member' : no accessible path to access member declared in virtual base 'class' +> 'member' : no accessible path to access member declared in virtual base 'class' + +## Remarks The `member` is inherited from a nonpublic **`virtual`** base class or structure. ## Examples -The following sample generates C2249. +The following example generates C2249. ```cpp // C2249.cpp class A { private: - void privFunc( void ) {}; + void privFunc( void ) {} public: - void pubFunc( void ) {}; + void pubFunc( void ) {} }; class B : virtual public A {} b; @@ -33,7 +34,7 @@ int main() { } ``` -C2249 can also occur if you try to assign a stream from the C++ Standard Library to another stream. The following sample generates C2249. +C2249 can also occur if you try to assign a stream from the C++ Standard Library to another stream. The following example generates C2249. ```cpp // C2249_2.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2250.md b/docs/error-messages/compiler-errors-1/compiler-error-c2250.md index c4ac513175e..5e30d649e82 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2250.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2250.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2250" title: "Compiler Error C2250" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2250" +ms.date: 11/04/2016 f1_keywords: ["C2250"] helpviewer_keywords: ["C2250"] -ms.assetid: f990986f-5c7d-4af4-a25c-b35540f1e217 --- # Compiler Error C2250 -'identifier' : ambiguous inheritance of 'class::member' +> 'identifier' : ambiguous inheritance of 'class::member' + +## Remarks The derived class inherits more than one override of a virtual function of a virtual base class. These overrides are ambiguous in the derived class. -The following sample generates C2286: +## Example + +The following example generates C2250: ```cpp // C2250.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2251.md b/docs/error-messages/compiler-errors-1/compiler-error-c2251.md index 77ec80c5746..f3be89655fb 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2251.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2251.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2251" title: "Compiler Error C2251" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2251" +ms.date: 11/04/2016 f1_keywords: ["C2251"] helpviewer_keywords: ["C2251"] -ms.assetid: fefe050c-f8d3-4316-b237-8007dbcdd3bf --- # Compiler Error C2251 -namespace 'namespace' does not have a member 'member' - Did you mean 'member'? +> namespace 'namespace' does not have a member 'member' - Did you mean 'member'? + +## Remarks The compiler was not able to find an identifier in the specified namespace. -The following sample generates C2251: +## Example + +The following example generates C2251: ```cpp // C2251.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2252.md b/docs/error-messages/compiler-errors-1/compiler-error-c2252.md index 7eaf55a4a0f..a26bb54ffd5 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2252.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2252.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2252" title: "Compiler Error C2252" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2252" +ms.date: 11/04/2016 f1_keywords: ["C2252"] helpviewer_keywords: ["C2252"] -ms.assetid: fee74ab9-1997-4615-82fe-e6d1fe3aacd9 --- # Compiler Error C2252 -cannot explicitly instantiate template in current scope +> cannot explicitly instantiate template in current scope + +## Remarks The compiler detected a problem with an explicit instantiation of a template. For example, you cannot explicitly instantiate a template in a function. -The following sample generates C2252: +## Example + +The following example generates C2252: ```cpp // C2252.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2253.md b/docs/error-messages/compiler-errors-1/compiler-error-c2253.md index 95a67878c5b..10af621f451 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2253.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2253.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2253" title: "Compiler Error C2253" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2253" +ms.date: 11/04/2016 f1_keywords: ["C2253"] helpviewer_keywords: ["C2253"] -ms.assetid: bd6445ae-b2c1-4669-9657-a8f4acf80b16 --- # Compiler Error C2253 -'function' : pure specifier or abstract override specifier only allowed on virtual function +> 'function' : pure specifier or abstract override specifier only allowed on virtual function + +## Remarks A nonvirtual function is specified as pure **`virtual`**. -The following sample generates C2253: +## Examples + +The following example generates C2253: ```cpp // C2253.cpp @@ -24,7 +27,7 @@ public: }; ``` -The following sample generates C2253: +The following example generates C2253: ```cpp // C2253_2.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2254.md b/docs/error-messages/compiler-errors-1/compiler-error-c2254.md index 0f7436b72b5..46c118163cd 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2254.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2254.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2254" title: "Compiler Error C2254" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2254" +ms.date: 11/04/2016 f1_keywords: ["C2254"] helpviewer_keywords: ["C2254"] -ms.assetid: 49bb3d7e-3bdf-4af6-937c-fa627be412a9 --- # Compiler Error C2254 -'function' : pure specifier or abstract override specifier not allowed on friend function +> 'function' : pure specifier or abstract override specifier not allowed on friend function + +## Remarks A **`friend`** function is specified as pure **`virtual`**. -The following sample generates C2254: +## Example + +The following example generates C2254: ```cpp // C2254.cpp @@ -24,6 +27,6 @@ public: friend void func3(); // OK, friend not virtual nor pure }; -void func1() {}; -void func3() {}; +void func1() {} +void func3() {} ``` diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2255.md b/docs/error-messages/compiler-errors-1/compiler-error-c2255.md index fa25eb214a5..99711de628b 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2255.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2255.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2255" title: "Compiler Error C2255" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2255" +ms.date: 11/04/2016 f1_keywords: ["C2255"] helpviewer_keywords: ["C2255"] -ms.assetid: 67dc4cb0-de6b-4405-bd64-d47736367a93 --- # Compiler Error C2255 -'element' : not allowed outside of a class definition +> 'element' : not allowed outside of a class definition + +## Remarks For example, a nonmember function is declared a **`friend`**. -The following sample generates C2255: +## Example + +The following example generates C2255: ```cpp // C2255.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2256.md b/docs/error-messages/compiler-errors-1/compiler-error-c2256.md index c0c1e5daac7..2c40773e239 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2256.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2256.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2256" title: "Compiler Error C2256" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2256" +ms.date: 11/04/2016 f1_keywords: ["C2256"] helpviewer_keywords: ["C2256"] -ms.assetid: 171fa2bc-8c72-49cd-afe5-d723b7acd3c5 --- # Compiler Error C2256 -illegal use of friend specifier on 'function' +> illegal use of friend specifier on 'function' + +## Remarks A destructor or constructor cannot be specified as a [friend](../../cpp/friend-cpp.md). -The following sample generates C2256: +## Example + +The following example generates C2256: ```cpp // C2256.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2258.md b/docs/error-messages/compiler-errors-1/compiler-error-c2258.md index 1e31e3d7671..8b04f7d245e 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2258.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2258.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2258" title: "Compiler Error C2258" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2258" +ms.date: 11/04/2016 f1_keywords: ["C2258"] helpviewer_keywords: ["C2258"] -ms.assetid: 105eaa87-befb-4ecb-9a3f-e09e14d2f5bf --- # Compiler Error C2258 -illegal pure syntax, must be '= 0' +> illegal pure syntax, must be '= 0' + +## Remarks A pure virtual function is declared with incorrect syntax. -The following sample generates C2258: +## Example + +The following example generates C2258: ```cpp // C2258.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2259.md b/docs/error-messages/compiler-errors-1/compiler-error-c2259.md index 11c96f2b724..9bcb2e62f8d 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2259.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2259.md @@ -1,22 +1,25 @@ --- -description: "Learn more about: Compiler Error C2259" title: "Compiler Error C2259" +description: "Learn more about: Compiler Error C2259" ms.date: 07/08/2021 f1_keywords: ["C2259"] helpviewer_keywords: ["C2259"] -ms.assetid: e458236f-bdea-4786-9aa6-a98d8bffa5f4 --- # Compiler Error C2259 > '*class*' : cannot instantiate abstract class +## Remarks + Code declares an instance of an abstract class or structure. You can't instantiate a class or structure with one or more pure virtual functions. To instantiate objects of a derived class, the derived class must override each pure virtual function. For more information, see [Implicitly abstract classes](../../dotnet/how-to-define-and-consume-classes-and-structs-cpp-cli.md#BKMK_Implicitly_abstract_classes). -The following sample generates C2259: +## Examples + +The following example generates C2259: ```cpp // C2259.cpp @@ -41,7 +44,7 @@ To resolve this issue, don't use more restrictive access permissions for the imp C2259 can also occur because of conformance work that was done in Visual Studio 2005, **`/Zc:wchar_t`** is now on by default. In this situation, C2599 can be resolved either by compiling with **`/Zc:wchar_t-`**, to get the behavior from previous versions, or preferably, by updating your types so they're compatible. For more information, see [`/Zc:wchar_t` (wchar_t Is Native Type)](../../build/reference/zc-wchar-t-wchar-t-is-native-type.md). -The following sample generates C2259: +The following example generates C2259: ```cpp // C2259b.cpp @@ -79,7 +82,7 @@ public: MyClass4 y; ``` -The following sample generates C2259: +The following example generates C2259: ```cpp // C2259c.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2261.md b/docs/error-messages/compiler-errors-1/compiler-error-c2261.md index eb8bd54da28..3c27593063d 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2261.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2261.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Error C2261" title: "Compiler Error C2261" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2261" +ms.date: 11/04/2016 f1_keywords: ["C2261"] helpviewer_keywords: ["C2261"] -ms.assetid: 60969482-9e83-49b5-9631-a04bc844da12 --- # Compiler Error C2261 -'string' : assembly reference is invalid and cannot be resolved +> 'string' : assembly reference is invalid and cannot be resolved + +## Remarks A value was not valid. @@ -18,7 +19,7 @@ For more on the correct syntax when specifying friend assemblies, see [Friend As ## Example -The following sample generates C2261. +The following example generates C2261. ```cpp // C2261.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2262.md b/docs/error-messages/compiler-errors-1/compiler-error-c2262.md index 8aa445522b1..752d2409f8f 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2262.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2262.md @@ -1,20 +1,21 @@ --- -description: "Learn more about: Compiler Error C2262" title: "Compiler Error C2262" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2262" +ms.date: 11/04/2016 f1_keywords: ["C2262"] helpviewer_keywords: ["C2262"] -ms.assetid: 727d1c6e-53e8-40e5-b7b8-6a7ac2011727 --- # Compiler Error C2262 -'attribute_specifiers' : InternalsVisibleTo declarations cannot have a version, culture, or processor architecture specified +> 'attribute_specifiers' : InternalsVisibleTo declarations cannot have a version, culture, or processor architecture specified + +## Remarks The attribute was not specified correctly. ## Example -The following sample generates C2262. +The following example generates C2262. ```cpp // C2262.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2264.md b/docs/error-messages/compiler-errors-1/compiler-error-c2264.md index e2e1dd617ec..915f27a906d 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2264.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2264.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2264" title: "Compiler Error C2264" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2264" +ms.date: 11/04/2016 f1_keywords: ["C2264"] helpviewer_keywords: ["C2264"] -ms.assetid: 158b72cc-cee9-4a08-bd79-b7a5955345a8 --- # Compiler Error C2264 -'function' : error in function definition or declaration; function not called +> 'function' : error in function definition or declaration; function not called + +## Remarks The function cannot be called due to an incorrect definition or declaration. -The following sample generates C2264: +## Example + +The following example generates C2264: ```cpp // C2264.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2266.md b/docs/error-messages/compiler-errors-1/compiler-error-c2266.md index 9fc181b416e..ecd97db4e0b 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2266.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2266.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Compiler Error C2266" title: "Compiler Error C2266" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2266" +ms.date: 11/04/2016 f1_keywords: ["C2266"] helpviewer_keywords: ["C2266"] -ms.assetid: 5c267a67-d5a1-4ad7-b6f7-a156510aee35 --- # Compiler Error C2266 -'identifier' : reference to a non-constant bounded array is illegal +> 'identifier' : reference to a non-constant bounded array is illegal + +## Remarks A reference is declared for an array with a nonconstant bound. The array must have constant bounds. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2267.md b/docs/error-messages/compiler-errors-1/compiler-error-c2267.md index 4018e13c8c5..2393a3ecdbc 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2267.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2267.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2267" title: "Compiler Error C2267" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2267" +ms.date: 11/04/2016 f1_keywords: ["C2267"] helpviewer_keywords: ["C2267"] -ms.assetid: ea63bebb-6208-4367-8440-39be07f9c360 --- # Compiler Error C2267 -'function' : static functions with block scope are illegal +> 'function' : static functions with block scope are illegal + +## Remarks A local function is declared **`static`**. Static functions must have global scope. -The following sample generates C2267: +## Example + +The following example generates C2267: ```cpp // C2267.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2268.md b/docs/error-messages/compiler-errors-1/compiler-error-c2268.md index 8be93111970..6c77ca44b41 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2268.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2268.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2268" title: "Compiler Error C2268" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2268" +ms.date: 11/04/2016 f1_keywords: ["C2268"] helpviewer_keywords: ["C2268"] -ms.assetid: 0ed055c9-3c6f-4df2-a5b6-85cf0e01a249 --- # Compiler Error C2268 -'function' is a compiler predefined library helper. Library helpers are not supported with /GL; compile object file 'file' without /GL. +> 'function' is a compiler predefined library helper. Library helpers are not supported with /GL; compile object file 'file' without /GL. + +## Remarks A function defined in your source code has the same name as an internal compiler function. Compile the module containing the function without [/GL](../../build/reference/gl-whole-program-optimization.md). -The following sample generates C2268: +## Example + +The following example generates C2268: ```c // C2268.c diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2270.md b/docs/error-messages/compiler-errors-1/compiler-error-c2270.md index b19c40b8b21..d6400d66435 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2270.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2270.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2270" title: "Compiler Error C2270" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2270" +ms.date: 11/04/2016 f1_keywords: ["C2270"] helpviewer_keywords: ["C2270"] -ms.assetid: b52c068e-0b61-42e7-b775-4d57b3ddcba0 --- # Compiler Error C2270 -'function' : modifiers not allowed on nonmember functions +> 'function' : modifiers not allowed on nonmember functions + +## Remarks A nonmember function is declared with [const](../../cpp/const-cpp.md), [volatile](../../cpp/volatile-cpp.md), or another memory-model modifier. -The following sample generates C2270: +## Example + +The following example generates C2270: ```cpp // C2270.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2271.md b/docs/error-messages/compiler-errors-1/compiler-error-c2271.md index cb79055f4c2..5cd706b2936 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2271.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2271.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2271" title: "Compiler Error C2271" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2271" +ms.date: 11/04/2016 f1_keywords: ["C2271"] helpviewer_keywords: ["C2271"] -ms.assetid: ea47bf57-f55d-4171-8e98-95a71d62820e --- # Compiler Error C2271 -'operator' : new/delete cannot have formal list modifiers +> 'operator' : new/delete cannot have formal list modifiers + +## Remarks The operator (**`new`** or **`delete`**) is declared with a memory-model specifier. -The following sample generates C2271: +## Example + +The following example generates C2271: ```cpp // C2271.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2272.md b/docs/error-messages/compiler-errors-1/compiler-error-c2272.md index a47e01e02a9..b8915aeab7b 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2272.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2272.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2272" title: "Compiler Error C2272" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2272" +ms.date: 11/04/2016 f1_keywords: ["C2272"] helpviewer_keywords: ["C2272"] -ms.assetid: 1517706a-9c27-452e-9b10-3424b3d232bc --- # Compiler Error C2272 -'function' : modifiers not allowed on static member functions +> 'function' : modifiers not allowed on static member functions + +## Remarks A **`static`** member function is declared with a memory-model specifier, such as [const](../../cpp/const-cpp.md) or [volatile](../../cpp/volatile-cpp.md), and such modifiers are not allowed on **`static`** member functions. -The following sample generates C2272: +## Example + +The following example generates C2272: ```cpp // C2272.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2273.md b/docs/error-messages/compiler-errors-1/compiler-error-c2273.md index 2000e990c36..c1bc46a2c64 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2273.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2273.md @@ -1,20 +1,23 @@ --- -description: "Learn more about: Compiler Error C2273" title: "Compiler Error C2273" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2273" +ms.date: 11/04/2016 f1_keywords: ["C2273"] helpviewer_keywords: ["C2273"] -ms.assetid: 3c682c66-97bf-4a23-a22c-d9a26a92bf95 --- # Compiler Error C2273 -'type' : illegal as right side of '->' operator +> 'type' : illegal as right side of '->' operator + +## Remarks A type appears as the right operand of a `->` operator. This error can be caused by trying to access a user-defined type conversion. Use the keyword **`operator`** between -> and `type`. -The following sample generates C2273: +## Example + +The following example generates C2273: ```cpp // C2273.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2274.md b/docs/error-messages/compiler-errors-1/compiler-error-c2274.md index 52cd5d4fcaf..1724a0006e3 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2274.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2274.md @@ -1,32 +1,16 @@ --- -description: "Learn more about: Compiler Error C2274" title: "Compiler Error C2274" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2274" +ms.date: 11/04/2016 f1_keywords: ["C2274"] helpviewer_keywords: ["C2274"] -ms.assetid: 8e874903-f499-45ef-8291-f821eee4cc1c --- # Compiler Error C2274 -'type' : illegal as right side of '.' operator - -A type appears as the right operand of a member-access (.) operator. - -This error can be caused by trying to access a user-defined type conversion. Use the keyword **`operator`** between the period and `type`. +> 'type' : illegal as right side of '.' operator -The following sample generates C2286: +## Remarks -```cpp -// C2274.cpp -struct MyClass { - operator int() { - return 0; - } -}; +A type appears as the right operand of a member-access (.) operator. -int main() { - MyClass ClassName; - int i = ClassName.int(); // C2274 - int j = ClassName.operator int(); // OK -} -``` +This error can be caused by trying to access a user-defined type conversion. Use the keyword **`operator`** between the period and `type`. \ No newline at end of file diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2275.md b/docs/error-messages/compiler-errors-1/compiler-error-c2275.md index 5398ae9154c..b4a3a21d317 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2275.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2275.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2275" title: "Compiler Error C2275" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2275" +ms.date: 11/04/2016 f1_keywords: ["C2275"] helpviewer_keywords: ["C2275"] -ms.assetid: c1eafa71-48de-46e0-82f3-b575538ef205 --- # Compiler Error C2275 -'identifier' : illegal use of this type as an expression +> 'identifier' : illegal use of this type as an expression + +## Remarks An expression uses the `->` operator with a **`typedef`** identifier. -The following sample generates C2275: +## Example + +The following example generates C2275: ```cpp // C2275.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2276.md b/docs/error-messages/compiler-errors-1/compiler-error-c2276.md index b6fe542bb7f..e583d2541cc 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2276.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2276.md @@ -1,6 +1,6 @@ --- -description: "Learn more about: Compiler Error C2276" title: "Compiler Error C2276" +description: "Learn more about: Compiler Error C2276" ms.date: 03/25/2021 f1_keywords: ["C2276"] helpviewer_keywords: ["C2276"] @@ -9,15 +9,15 @@ helpviewer_keywords: ["C2276"] > '*operator*' : illegal operation on bound member function expression -The compiler found a problem with the syntax used to create a pointer-to-member. - ## Remarks +The compiler found a problem with the syntax used to create a pointer-to-member. + Error `C2276` is often caused when you attempt to create a pointer-to-member by using an instance variable to qualify the member, instead of a class type. You may also see this error if you're trying to call a member function by using the wrong syntax. ## Example -This sample shows several ways C2276 may occur, and how to fix them: +This example shows several ways C2276 may occur, and how to fix them: ```cpp // C2276.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2277.md b/docs/error-messages/compiler-errors-1/compiler-error-c2277.md index f1aef2b07ff..20429c174ac 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2277.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2277.md @@ -1,24 +1,29 @@ --- -description: "Learn more about: Compiler Error C2277" title: "Compiler Error C2277" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2277" +ms.date: 08/27/2025 f1_keywords: ["C2277"] helpviewer_keywords: ["C2277"] -ms.assetid: 15a83b07-8731-4524-810b-267f65a7844f --- # Compiler Error C2277 -'identifier' : cannot take address of this member function +> '*function*': cannot take address of this member function + +## Remarks -You cannot take the address of a member function. +You cannot take the address of a [constructor](../../cpp/constructors-cpp.md) or [destructor](../../cpp/destructors-cpp.md). For more information, see [Address-of operator: `&`](../../cpp/address-of-operator-amp.md) and [Pointers to Members](../../cpp/pointers-to-members.md). -The following sample generates C2277: +## Example + +The following example generates C2277: ```cpp -// C2277.cpp -class A { +// compile with: /c + +class A +{ public: A(); }; -(*pctor)() = &A::A; // C2277 +(*pctor)() = &A::A; // C2277 ``` diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2279.md b/docs/error-messages/compiler-errors-1/compiler-error-c2279.md index b7df615fbd6..0591321c482 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2279.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2279.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2279" title: "Compiler Error C2279" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2279" +ms.date: 11/04/2016 f1_keywords: ["C2279"] helpviewer_keywords: ["C2279"] -ms.assetid: 1b5c88ef-2336-49b8-9ddb-d61f97c73e14 --- # Compiler Error C2279 -exception specification cannot appear in a typedef declaration +> exception specification cannot appear in a typedef declaration + +## Remarks Under **/Za**, [exception specifications](../../cpp/exception-specifications-throw-cpp.md) are not allowed in a typedef declaration. -The following sample generates C2279: +## Example + +The following example generates C2279: ```cpp // C2279.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2280.md b/docs/error-messages/compiler-errors-1/compiler-error-c2280.md index c438dc7138a..c952f212b5e 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2280.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2280.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Error C2280" title: "Compiler Error C2280" -ms.date: "04/25/2017" +description: "Learn more about: Compiler Error C2280" +ms.date: 04/25/2017 f1_keywords: ["C2280"] helpviewer_keywords: ["C2280"] -ms.assetid: e6c5b1fb-2b9b-4554-8ff9-775eeb37161b --- # Compiler Error C2280 -'*declaration*': attempting to reference a deleted function +> '*declaration*': attempting to reference a deleted function + +## Remarks The compiler detected an attempt to reference a `deleted` function. This error can be caused by a call to a member function that has been explicitly marked as `= deleted` in the source code. This error can also be caused by a call to an implicit special member function of a struct or class that is automatically declared and marked as `deleted` by the compiler. For more information about when the compiler automatically generates **`default`** or `deleted` special member functions, see [Special member functions](../../cpp/special-member-functions.md). diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2283.md b/docs/error-messages/compiler-errors-1/compiler-error-c2283.md index 2c01122914a..8f402a366e2 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2283.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2283.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2283" title: "Compiler Error C2283" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2283" +ms.date: 11/04/2016 f1_keywords: ["C2283"] helpviewer_keywords: ["C2283"] -ms.assetid: 8a5b3175-b480-4598-a1f7-0b50504c5caa --- # Compiler Error C2283 -'identifier' : pure specifier or abstract override specifier not allowed on unnamed struct +> '*identifier*': pure specifier or abstract override specifier not allowed on unnamed struct + +## Remarks A member function of an unnamed class or structure is declared with a pure specifier, which is not permitted. -The following sample generates C2283: +## Example + +The following example generates C2283: ```cpp // C2283.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2285.md b/docs/error-messages/compiler-errors-1/compiler-error-c2285.md index cb7c1d60c9e..d11de7e744b 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2285.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2285.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Compiler Error C2285" title: "Compiler Error C2285" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2285" +ms.date: 11/04/2016 f1_keywords: ["C2285"] helpviewer_keywords: ["C2285"] -ms.assetid: 7b40a1b0-f477-49fa-b762-c3bccd88514e --- # Compiler Error C2285 -pointers to members representation has already been determined - pragma ignored +> pointers to members representation has already been determined - pragma ignored + +## Remarks Two different representations exist for class. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2286.md b/docs/error-messages/compiler-errors-1/compiler-error-c2286.md index 8479291e545..81e52facd85 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2286.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2286.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Error C2286" title: "Compiler Error C2286" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2286" +ms.date: 11/04/2016 f1_keywords: ["C2286"] helpviewer_keywords: ["C2286"] -ms.assetid: 078e0201-35cc-42e2-8dbc-6f8cf557b098 --- # Compiler Error C2286 -pointers to members of 'identifier' representation is already set to 'inheritance' - declaration ignored +> pointers to members of 'identifier' representation is already set to 'inheritance' - declaration ignored + +## Remarks Two different pointer-to-members representations exist for class. @@ -16,7 +17,7 @@ For more information, see [Inheritance Keywords](../../cpp/inheritance-keywords. ## Example -The following sample generates C2286: +The following example generates C2286: ```cpp // C2286.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2287.md b/docs/error-messages/compiler-errors-1/compiler-error-c2287.md index 178c7c0076b..5028b594ce8 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2287.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2287.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2287" title: "Compiler Error C2287" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2287" +ms.date: 11/04/2016 f1_keywords: ["C2287"] helpviewer_keywords: ["C2287"] -ms.assetid: 64556299-4e1f-4437-88b7-2464fc0b95bb --- # Compiler Error C2287 -'class': inheritance representation: 'representation1' is less general than the required 'representation2' +> 'class': inheritance representation: 'representation1' is less general than the required 'representation2' + +## Remarks A class is declared with a simpler representation than required. -The following sample generates C2287: +## Example + +The following example generates C2287: ```cpp // C2287.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2289.md b/docs/error-messages/compiler-errors-1/compiler-error-c2289.md index 485af601948..25fe25f0f2f 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2289.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2289.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2289" title: "Compiler Error C2289" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2289" +ms.date: 11/04/2016 f1_keywords: ["C2289"] helpviewer_keywords: ["C2289"] -ms.assetid: cb41a29e-1b06-47dc-bfce-8d73bd63a0df --- # Compiler Error C2289 -same type qualifier used more than once +> same type qualifier used more than once + +## Remarks A type declaration or definition uses a type qualifier (**`const`**, **`volatile`**, **`signed`**, or **`unsigned`**) more than once, causing an error under ANSI compatibility (**/Za**). -The following sample generates C2286: +## Example + +The following example generates C2289: ```cpp // C2289.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2290.md b/docs/error-messages/compiler-errors-1/compiler-error-c2290.md index f69fdf273cf..41f755959b1 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2290.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2290.md @@ -1,13 +1,29 @@ --- -description: "Learn more about: Compiler Error C2290" title: "Compiler Error C2290" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2290" +ms.date: 12/5/2025 f1_keywords: ["C2290"] helpviewer_keywords: ["C2290"] -ms.assetid: 78c0feec-ccde-401b-8335-5b6ea6be8a13 --- # Compiler Error C2290 -C++ asm syntax ignored. Use __asm. +> C++ 'asm' syntax ignored. Use __asm. + +## Remarks + +The **`asm`** syntax is reserved for future use. Try [`__asm`](../../assembler/inline/asm.md) instead. For more information, see [Inline Assembler](../../assembler/inline/inline-assembler.md). + +## Example + +The following example generates C2290: + +```cpp +// C2290.cpp +// Compile for 32 bit, i.e. x86 instead of x64 -The **`asm`** syntax is reserved for future use. +int main() +{ + asm("nop"); // C2290 + __asm { nop } // OK +} +``` diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2292.md b/docs/error-messages/compiler-errors-1/compiler-error-c2292.md index 45784ec91f4..1b9d0e238de 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2292.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2292.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Error C2292" title: "Compiler Error C2292" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2292" +ms.date: 11/04/2016 f1_keywords: ["C2292"] helpviewer_keywords: ["C2292"] -ms.assetid: 256b392f-2b8f-4162-b578-e7633984e162 --- # Compiler Error C2292 -'identifier': best case inheritance representation: 'representation1' declared but 'representation2' required +> 'identifier': best case inheritance representation: 'representation1' declared but 'representation2' required + +## Example Compiling the following code with [/vmb](../../build/reference/vmb-vmg-representation-method.md) ("Best-case always" representation) causes C2292. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2293.md b/docs/error-messages/compiler-errors-1/compiler-error-c2293.md index 6e0833a07e3..d5eb84b0f59 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2293.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2293.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2293" title: "Compiler Error C2293" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2293" +ms.date: 11/04/2016 f1_keywords: ["C2293"] helpviewer_keywords: ["C2293"] -ms.assetid: 17e7b4e2-368b-4dd7-a01b-d82be60f8e56 --- # Compiler Error C2293 -'identifier': illegal to have a member variable as a __based specifier +> 'identifier': illegal to have a member variable as a __based specifier + +## Remarks Specifiers for **`__based`** modifier must be nonmember pointers. -The following sample generates C2293: +## Example + +The following example generates C2293: ```cpp // C2293.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2295.md b/docs/error-messages/compiler-errors-1/compiler-error-c2295.md index 484d1908b7d..f67e5222233 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2295.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2295.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Compiler Error C2295" title: "Compiler Error C2295" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2295" +ms.date: 11/04/2016 f1_keywords: ["C2295"] helpviewer_keywords: ["C2295"] -ms.assetid: faddf446-5924-401e-b719-93390d5cd084 --- # Compiler Error C2295 -escaped 'character' : is illegal in macro definition +> escaped 'character' : is illegal in macro definition + +## Remarks A macro definition cannot contain an escape sequence with the specified character. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2296.md b/docs/error-messages/compiler-errors-1/compiler-error-c2296.md index bdd1b4b3d24..a37e7a959bf 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2296.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2296.md @@ -1,20 +1,23 @@ --- -description: "Learn more about: Compiler Error C2296" title: "Compiler Error C2296" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2296" +ms.date: 11/04/2016 f1_keywords: ["C2296"] helpviewer_keywords: ["C2296"] -ms.assetid: 47d270f4-13ce-4c16-81e2-7d67c6c4a540 --- # Compiler Error C2296 -'operator' : bad left operand +> 'operator' : bad left operand + +## Remarks The left operand used with `operator` is invalid. For example, the compiler may see a declaration where you intended a function call. -The following sample generates C2296: +## Example + +The following example generates C2296: ```cpp // C2296.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2297.md b/docs/error-messages/compiler-errors-1/compiler-error-c2297.md index 97ed907a34a..8ce344ccd8b 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2297.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2297.md @@ -1,20 +1,23 @@ --- -description: "Learn more about: Compiler Error C2297" title: "Compiler Error C2297" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2297" +ms.date: 11/04/2016 f1_keywords: ["C2297"] helpviewer_keywords: ["C2297"] -ms.assetid: 65849fe5-17e1-4b7e-b50c-f508b05ddaa4 --- # Compiler Error C2297 -'operator' : bad right operand +> 'operator' : bad right operand + +## Remarks The right operand used with `operator` is invalid. For example, the compiler may see a declaration where you intended a function call. -The following sample generates C2297: +## Example + +The following example generates C2297: ```cpp // C2297.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2298.md b/docs/error-messages/compiler-errors-1/compiler-error-c2298.md index 529c6f15ebc..cddce97fedd 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2298.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2298.md @@ -1,20 +1,21 @@ --- -description: "Learn more about: Compiler Error C2298" title: "Compiler Error C2298" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2298" +ms.date: 11/04/2016 f1_keywords: ["C2298"] helpviewer_keywords: ["C2298"] -ms.assetid: eb0120ad-c850-4bdd-911d-0361229cc859 --- # Compiler Error C2298 -'operation' : illegal operation on pointer to member function expression +> 'operation' : illegal operation on pointer to member function expression + +## Remarks A pointer to member-function expression must call the member function. ## Examples -The following sample generates C2298. +The following example generates C2298. ```cpp // C2298.cpp @@ -48,7 +49,7 @@ int main() { } ``` -The following sample generates C2298. +The following example generates C2298. ```cpp // C2298_b.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2299.md b/docs/error-messages/compiler-errors-1/compiler-error-c2299.md index 16cf37d4d9a..ae1494b4035 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2299.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2299.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2299" title: "Compiler Error C2299" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2299" +ms.date: 11/04/2016 f1_keywords: ["C2299"] helpviewer_keywords: ["C2299"] -ms.assetid: d001c2bc-f6fd-47aa-8e42-0eb824d6441d --- # Compiler Error C2299 @@ -18,7 +17,7 @@ To resolve C2299, don't make the copy constructor or assignment operator a funct ## Example -The following sample generates C2299: +The following example generates C2299: ```cpp // C2299.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2300.md b/docs/error-messages/compiler-errors-1/compiler-error-c2300.md index 38fcc87e79f..5727f9ee377 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2300.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2300.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Compiler Error C2300" title: "Compiler Error C2300" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2300" +ms.date: 11/04/2016 f1_keywords: ["C2300"] helpviewer_keywords: ["C2300"] -ms.assetid: bb8fed56-feb0-412b-ae7b-04d48b202b78 --- # Compiler Error C2300 -'identifier' : class does not have a destructor called '~identifier' +> 'identifier' : class does not have a destructor called '~identifier' + +## Remarks The class does not have a destructor with the required name. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2301.md b/docs/error-messages/compiler-errors-1/compiler-error-c2301.md index d95b81771a2..95225fd76a4 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2301.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2301.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Compiler Error C2301" title: "Compiler Error C2301" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2301" +ms.date: 11/04/2016 f1_keywords: ["C2301"] helpviewer_keywords: ["C2301"] -ms.assetid: d294a1a2-dc7a-4e18-90b3-747e1a8c51ee --- # Compiler Error C2301 -left of '->~identifier' must point to class/struct/union +> left of '->~identifier' must point to class/struct/union + +## Remarks The expression to the left of the `->` operator does not evaluate to a pointer to a class, structure, or union. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2302.md b/docs/error-messages/compiler-errors-1/compiler-error-c2302.md index b496d9de753..18abffb5de1 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2302.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2302.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Compiler Error C2302" title: "Compiler Error C2302" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2302" +ms.date: 11/04/2016 f1_keywords: ["C2302"] helpviewer_keywords: ["C2302"] -ms.assetid: 74a54bab-9d5c-446e-9b1f-c92fb57090a8 --- # Compiler Error C2302 -left of '.~identifier' must have class/struct/union type +> left of '.~identifier' must have class/struct/union type + +## Remarks The expression to the left of the period (.) operator is not a class, structure, or union. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2307.md b/docs/error-messages/compiler-errors-1/compiler-error-c2307.md index 469a7facd99..69e3890ef35 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2307.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2307.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Compiler Error C2307" title: "Compiler Error C2307" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2307" +ms.date: 11/04/2016 f1_keywords: ["C2307"] helpviewer_keywords: ["C2307"] -ms.assetid: ce6c8033-a673-4679-9883-bedec36ae385 --- # Compiler Error C2307 -pragma 'pragma' must be outside function if incremental compilation is enabled +> pragma 'pragma' must be outside function if incremental compilation is enabled + +## Remarks You must place the `data_seg` pragma between functions if you're using incremental compilation. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2308.md b/docs/error-messages/compiler-errors-1/compiler-error-c2308.md index 83af91881dc..60d5d48ec7c 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2308.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2308.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Compiler Error C2308" title: "Compiler Error C2308" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2308" +ms.date: 11/04/2016 f1_keywords: ["C2308"] helpviewer_keywords: ["C2308"] -ms.assetid: d1eaf101-077d-4c43-97ac-410efd5b6fc9 --- # Compiler Error C2308 -concatenating mismatched strings +> concatenating mismatched strings + +## Remarks Both wide and non-wide character strings were specified for concatenation. You cannot concatenate a wide character string and non-wide character string. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2309.md b/docs/error-messages/compiler-errors-1/compiler-error-c2309.md index 631119862e5..e2d392ca6a8 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2309.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2309.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2309" title: "Compiler Error C2309" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2309" +ms.date: 11/04/2016 f1_keywords: ["C2309"] helpviewer_keywords: ["C2309"] -ms.assetid: 6303d5b5-72cf-42b8-92ce-b1eb48e80d48 --- # Compiler Error C2309 -catch handler expected a parenthesized exception declaration +> catch handler expected a parenthesized exception declaration + +## Remarks A catch handler has no parenthesized type. -The following sample generates C2309: +## Example + +The following example generates C2309: ```cpp // C2309.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2310.md b/docs/error-messages/compiler-errors-1/compiler-error-c2310.md index b66045af5f2..401f5456254 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2310.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2310.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2310" title: "Compiler Error C2310" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2310" +ms.date: 11/04/2016 f1_keywords: ["C2310"] helpviewer_keywords: ["C2310"] -ms.assetid: 1969c682-b97e-43fb-b9a9-f783e7ff1710 --- # Compiler Error C2310 -catch handlers must specify one type +> catch handlers must specify one type + +## Remarks A catch handler specified no type or multiple types. -The following sample generates C2310: +## Example + +The following example generates C2310: ```cpp // C2310.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2311.md b/docs/error-messages/compiler-errors-1/compiler-error-c2311.md index 1593deabd62..8b132322598 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2311.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2311.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2311" title: "Compiler Error C2311" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2311" +ms.date: 11/04/2016 f1_keywords: ["C2311"] helpviewer_keywords: ["C2311"] -ms.assetid: 1aff9bd5-ed0b-4db6-bbc0-01ac89850cf2 --- # Compiler Error C2311 -'exception' : is caught by '...' on line number +> 'exception' : is caught by '...' on line number + +## Remarks The catch handler for the ellipsis (...) must be the last handler for a throw. -The following sample generates C2311: +## Example + +The following example generates C2311: ```cpp // C2311.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2312.md b/docs/error-messages/compiler-errors-1/compiler-error-c2312.md index 39b2968286d..81b15ceb6ff 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2312.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2312.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2312" title: "Compiler Error C2312" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2312" +ms.date: 11/04/2016 f1_keywords: ["C2312"] helpviewer_keywords: ["C2312"] -ms.assetid: c8bcfd06-12c1-4323-bb53-ba392d36daa4 --- # Compiler Error C2312 -'exception1' : is caught by 'exception2' on line number +> 'exception1' : is caught by 'exception2' on line number + +## Remarks Two handlers catch the same exception type. -The following sample generates C2312: +## Example + +The following example generates C2312: ```cpp // C2312.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2313.md b/docs/error-messages/compiler-errors-1/compiler-error-c2313.md index 01c0b6c5737..2d71495167d 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2313.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2313.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2313" title: "Compiler Error C2313" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2313" +ms.date: 11/04/2016 f1_keywords: ["C2313"] helpviewer_keywords: ["C2313"] -ms.assetid: f70eb19b-c0a3-4fb2-ade1-3890a589928d --- # Compiler Error C2313 -'type1' : is caught by reference ('type2') on line number +> 'type1' : is caught by reference ('type2') on line number + +## Remarks The exception type has two handlers. The type for the second catch is a reference to the type of the first. -The following sample generates C2313: +## Example + +The following example generates C2313: ```cpp // C2313.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2315.md b/docs/error-messages/compiler-errors-1/compiler-error-c2315.md index fc0b04c563f..d6ea11e2f93 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2315.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2315.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Compiler Error C2315" title: "Compiler Error C2315" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2315" +ms.date: 11/04/2016 f1_keywords: ["C2315"] helpviewer_keywords: ["C2315"] -ms.assetid: a0d91b81-944c-4a69-9a24-fd484aabcc5c --- # Compiler Error C2315 -'type1' : reference is caught by 'type2' on line number +> 'type1' : reference is caught by 'type2' on line number + +## Remarks The exception type is handled by a previous handler. The reference for the second catch has the type of the first. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2316.md b/docs/error-messages/compiler-errors-1/compiler-error-c2316.md index 6163529aca2..4e208a5fc5b 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2316.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2316.md @@ -1,24 +1,23 @@ --- -description: "Learn more about: Compiler Error C2316" title: "Compiler Error C2316" -ms.date: "07/08/2019" +description: "Learn more about: Compiler Error C2316" +ms.date: 07/08/2019 f1_keywords: ["C2316"] helpviewer_keywords: ["C2316"] -ms.assetid: 9ad08eb5-060b-4eb0-8d66-0dc134f7bf67 --- # Compiler Error C2316 > '*class_type*' : cannot be caught as the destructor and/or copy constructor are inaccessible or deleted -An exception was caught by value or by reference, but the copy constructor, the assignment operator, or both were inaccessible. - ## Remarks +An exception was caught by value or by reference, but the copy constructor, the assignment operator, or both were inaccessible. + Conformance changes in Visual Studio 2015 made this error apply to bad catch statements of MFC exceptions derived from `CException`. Because `CException` has an inherited private copy constructor, the class and its derivatives aren't copyable, and can't be passed by value, which also means they can't be caught by value. Catch statements that caught MFC exceptions by value previously led to uncaught exceptions at runtime. Now the compiler correctly identifies this situation and reports error C2316. To fix this issue, we recommend you use the MFC TRY/CATCH macros rather than write your own exception handlers. If that's not appropriate for your code, catch MFC exceptions by reference instead. ## Example -The following sample generates C2316, and shows a way to fix it: +The following example generates C2316, and shows a way to fix it: ```cpp // C2316.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2317.md b/docs/error-messages/compiler-errors-1/compiler-error-c2317.md index 79f823cb0e5..fc575b588a1 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2317.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2317.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2317" title: "Compiler Error C2317" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2317" +ms.date: 11/04/2016 f1_keywords: ["C2317"] helpviewer_keywords: ["C2317"] -ms.assetid: e44d129b-8d3e-4ce9-9d79-6791ee77f25e --- # Compiler Error C2317 -'try' block starting on line 'number' has no catch handlers +> 'try' block starting on line 'number' has no catch handlers + +## Remarks A **`try`** block must have at least one catch handler. -The following sample generates C2317: +## Example + +The following example generates C2317: ```cpp // C2317.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2318.md b/docs/error-messages/compiler-errors-1/compiler-error-c2318.md index b5482c8358f..5a67e8cb5a3 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2318.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2318.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2318" title: "Compiler Error C2318" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2318" +ms.date: 11/04/2016 f1_keywords: ["C2318"] helpviewer_keywords: ["C2318"] -ms.assetid: 169e30b9-df78-46cb-90bf-576ad3c32fd4 --- # Compiler Error C2318 -no try block associated with this catch handler +> no try block associated with this catch handler + +## Remarks A **`catch`** handler is defined but not preceded by a **`try`** block. -The following sample generates C2318: +## Example + +The following example generates C2318: ```cpp // C2318.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2319.md b/docs/error-messages/compiler-errors-1/compiler-error-c2319.md index 0a9d1381842..87a4c1537f5 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2319.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2319.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2319" title: "Compiler Error C2319" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2319" +ms.date: 11/04/2016 f1_keywords: ["C2319"] helpviewer_keywords: ["C2319"] -ms.assetid: 25263e6e-f5ba-4d2c-8727-8c2d8ca2e5ce --- # Compiler Error C2319 -'try/catch' must be followed by a compound statement. Missing '{' +> 'try/catch' must be followed by a compound statement. Missing '{' + +## Remarks A **`try`** or **`catch`** block is not found following the **`try`** or **`catch`** statement. The block must be enclosed in curly braces. -The following sample generates C2319: +## Example + +The following example generates C2319: ```cpp // C2319.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2320.md b/docs/error-messages/compiler-errors-1/compiler-error-c2320.md index 1b9cf5a1050..ea08646bec4 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2320.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2320.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Compiler Error C2320" title: "Compiler Error C2320" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2320" +ms.date: 11/04/2016 f1_keywords: ["C2320"] helpviewer_keywords: ["C2320"] -ms.assetid: ae78ae1b-364f-4b65-bfb8-8809d5151ca5 --- # Compiler Error C2320 > expected ':' to follow access specifier '*specifier*' +## Remarks + The keyword **`public`**, **`protected`**, or **`private`** must be followed by a colon. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2322.md b/docs/error-messages/compiler-errors-1/compiler-error-c2322.md index 3118e5213b8..fb2482086a5 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2322.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2322.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Compiler Error C2322" title: "Compiler Error C2322" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2322" +ms.date: 11/04/2016 f1_keywords: ["C2322"] helpviewer_keywords: ["C2322"] -ms.assetid: f9b92005-618a-42d8-80e9-67ce769a9f3b --- # Compiler Error C2322 -'identifier' : address of dllimport 'dllimport' is not static +> 'identifier' : address of dllimport 'dllimport' is not static + +## Remarks A nonstatic value is given as the address of a function declared with `dllimport`. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2323.md b/docs/error-messages/compiler-errors-1/compiler-error-c2323.md index d17cf401d94..1c00da83503 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2323.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2323.md @@ -1,16 +1,20 @@ --- title: "Compiler Error C2323" description: "Learn more about: Compiler Error C2323" -ms.date: "03/20/2024" +ms.date: 03/20/2024 f1_keywords: ["C2323"] helpviewer_keywords: ["C2323"] --- # Compiler Error C2323 -'identifier': non-member operator `new` or `delete` functions may not be declared `static` or in a namespace other than the global namespace. +> 'identifier': non-member operator `new` or `delete` functions may not be declared `static` or in a namespace other than the global namespace. + +## Remarks The `new` and `delete` overload operators must be non-static, defined in the global namespace or as class members. +## Example + The following generates C2323: ```cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2324.md b/docs/error-messages/compiler-errors-1/compiler-error-c2324.md index d1ef4836f5e..fcb0fd61a1a 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2324.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2324.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2324" title: "Compiler Error C2324" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2324" +ms.date: 11/04/2016 f1_keywords: ["C2324"] helpviewer_keywords: ["C2324"] -ms.assetid: 215f0544-85b0-452d-825f-17a388b6a61c --- # Compiler Error C2324 -'identifier' : unexpected to the right of 'name' +> 'identifier' : unexpected to the right of 'name' + +## Remarks A destructor is called using an incorrect identifier. -The following sample generates C2324: +## Example + +The following example generates C2324: ```cpp // C2324.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2325.md b/docs/error-messages/compiler-errors-1/compiler-error-c2325.md index 4085db3ee9c..4864fe0c516 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2325.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2325.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2325" title: "Compiler Error C2325" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2325" +ms.date: 11/04/2016 f1_keywords: ["C2325"] helpviewer_keywords: ["C2325"] -ms.assetid: e6b0a186-3f2a-4adf-beae-fadd75492bf7 --- # Compiler Error C2325 -'type' : unexpected type to the right of 'name' +> 'type' : unexpected type to the right of 'name' + +## Remarks A call is made to a destructor of incorrect type. -The following sample generates C2325: +## Example + +The following example generates C2325: ```cpp // C2325.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2326.md b/docs/error-messages/compiler-errors-1/compiler-error-c2326.md index ba0c0c01128..5168287dacd 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2326.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2326.md @@ -1,20 +1,21 @@ --- -description: "Learn more about: Compiler Error C2326" title: "Compiler Error C2326" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2326" +ms.date: 11/04/2016 f1_keywords: ["C2326"] helpviewer_keywords: ["C2326"] -ms.assetid: 01a5ea40-de83-4e6f-a4e8-469f441258e0 --- # Compiler Error C2326 -'declarator' : function cannot access 'name' +> 'declarator' : function cannot access 'name' + +## Remarks The code tries to modify a member variable, which is not possible. ## Example -The following sample generates C2326: +The following example generates C2326: ```cpp // C2326.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2327.md b/docs/error-messages/compiler-errors-1/compiler-error-c2327.md index 1a2c9cb18a9..204783d6cb6 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2327.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2327.md @@ -1,20 +1,23 @@ --- -description: "Learn more about: Compiler Error C2327" title: "Compiler Error C2327" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2327" +ms.date: 11/04/2016 f1_keywords: ["C2327"] helpviewer_keywords: ["C2327"] -ms.assetid: 95278c95-d1f9-4487-ad27-53311f5e8112 --- # Compiler Error C2327 -'symbol' : is not a type name, static, or enumerator +> 'symbol' : is not a type name, static, or enumerator + +## Remarks Code within a nested class attempts to access a member of the enclosing class that is not a type name, a static member, or an enumerator. When compiling with **/clr**, a common cause for C2327 is a property with the same name as the property type. -The following sample generates C2327: +## Examples + +The following example generates C2327: ```cpp // C2327.cpp @@ -62,7 +65,7 @@ struct B { }; ``` -The following sample generates C2327: +The following example generates C2327: ```cpp // C2327d.cpp @@ -96,7 +99,7 @@ namespace NA { } ``` -The following sample shows C2327 when a property has the same name as the property type: +The following example shows C2327 when a property has the same name as the property type: ```cpp // C2327f.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2332.md b/docs/error-messages/compiler-errors-1/compiler-error-c2332.md index 90d950d5461..8ff2d139da5 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2332.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2332.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2332" title: "Compiler Error C2332" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2332" +ms.date: 11/04/2016 f1_keywords: ["C2332"] helpviewer_keywords: ["C2332"] -ms.assetid: fb05cd68-e271-4bea-9fb7-ef4edb0a26ac --- # Compiler Error C2332 -'typedef' : missing tag name +> 'typedef' : missing tag name + +## Remarks The compiler found an incomplete type definition. -The following sample generates C2332: +## Example + +The following example generates C2332: ```cpp // C2332.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2333.md b/docs/error-messages/compiler-errors-1/compiler-error-c2333.md index b1be3f36fc8..ef87be83dac 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2333.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2333.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2333" title: "Compiler Error C2333" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2333" +ms.date: 11/04/2016 f1_keywords: ["C2333"] helpviewer_keywords: ["C2333"] -ms.assetid: 2636fc1e-d3e7-4e68-8628-3c81a99ba813 --- # Compiler Error C2333 -'function' : error in function declaration; skipping function body +> 'function' : error in function declaration; skipping function body + +## Remarks This error occurs after another error, for member functions defined inside their class. -The following sample generates C2333: +## Example + +The following example generates C2333: ```cpp // C2333.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2334.md b/docs/error-messages/compiler-errors-1/compiler-error-c2334.md index 0ba710e94ac..83f01fe91e8 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2334.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2334.md @@ -1,16 +1,17 @@ --- -description: "Learn more about: Compiler Error C2334" title: "Compiler Error C2334" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2334" +ms.date: 11/04/2016 f1_keywords: ["C2334"] helpviewer_keywords: ["C2334"] -ms.assetid: 36142855-e00b-4bbf-80f5-a301edeff46e --- # Compiler Error C2334 -unexpected token(s) preceding ': or {'; skipping apparent function body +> unexpected token(s) preceding ': or {'; skipping apparent function body + +## Example -The following sample generates C2334. This error occurs after error C2059: +The following example generates C2334. This error occurs after error C2059: ```cpp // C2334.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2337.md b/docs/error-messages/compiler-errors-1/compiler-error-c2337.md index ca4fe6be894..9f5f6c91490 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2337.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2337.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2337" title: "Compiler Error C2337" -ms.date: "09/19/2019" +description: "Learn more about: Compiler Error C2337" +ms.date: 09/19/2019 f1_keywords: ["C2337"] helpviewer_keywords: ["C2337"] -ms.assetid: eccc9178-a15e-42cd-bbd0-3cea7cf2d55b --- # Compiler Error C2337 > '*attribute-name*' : attribute not found +## Remarks + Your code uses an attribute that isn't supported in this context. Or, the attribute isn't available in this version of the compiler. To resolve this issue, remove the unsupported attribute. -The following sample generates C2337: +## Example + +The following example generates C2337: ```cpp // C2337.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2338.md b/docs/error-messages/compiler-errors-1/compiler-error-c2338.md index 1ab34e8a9b8..db9b460f461 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2338.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2338.md @@ -1,15 +1,16 @@ --- -description: "Learn more about: Compiler Error C2338" title: "Compiler Error C2338" +description: "Learn more about: Compiler Error C2338" ms.date: 02/22/2022 f1_keywords: ["C2338"] helpviewer_keywords: ["C2338"] -ms.assetid: 49bba575-1de4-4963-86c6-ce3226a2ba51 --- # Compiler Error C2338 > *Error message* +## Remarks + Error C2338 can be caused by a **`static_assert`** error during compilation. The message is supplied by the **`static_assert`** parameters. Error C2338 can also be generated by external providers to the compiler. In most cases, these errors are reported by an attribute provider DLL, such as ATLPROV. Some common forms of this message include: @@ -24,6 +25,8 @@ These errors are often unrecoverable, and may be followed by a fatal compiler er To fix these issues, correct the attribute usage. For example, in some cases, attribute parameters must be declared before they can be used. If an ATL error number is provided, check the documentation for that error for more specific information. +## Example + In Standard C++11 and later, **`constexpr`** functions are no longer considered **`noexcept`** by default when used in a constant expression. This behavior change comes from the resolution of Core Working Group (CWG) [CWG 1351](https://wg21.link/cwg1351) and is enabled in [`/permissive-`](../../build/reference/permissive-standards-conformance.md) mode. The following example compiles in Visual Studio 2019 version 16.1 and earlier, but produces C2338 in Visual Studio 2019 version 16.2: ```cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2341.md b/docs/error-messages/compiler-errors-1/compiler-error-c2341.md index 74f459a7bf2..3fe4850bb8d 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2341.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2341.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2341" title: "Compiler Error C2341" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2341" +ms.date: 11/04/2016 f1_keywords: ["C2341"] helpviewer_keywords: ["C2341"] -ms.assetid: aa2a7da5-e1c8-4225-9939-5bdc50158f31 --- # Compiler Error C2341 -'section name' : segment must be defined using #pragma data_seg, code_seg or section prior to use +> 'section name' : segment must be defined using #pragma data_seg, code_seg or section prior to use + +## Remarks An [allocate](../../cpp/allocate.md) statement refers to a segment not yet defined by [code_seg](../../preprocessor/code-seg.md), [data_seg](../../preprocessor/data-seg.md), or [section](../../preprocessor/section.md) pragmas. -The following sample generates C2341: +## Example + +The following example generates C2341: ```cpp // C2341.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2344.md b/docs/error-messages/compiler-errors-1/compiler-error-c2344.md index 4fb3b3f2f7b..978a21fe0fa 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2344.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2344.md @@ -1,17 +1,20 @@ --- -description: "Learn more about: Compiler Error C2344" title: "Compiler Error C2344" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2344" +ms.date: 11/04/2016 f1_keywords: ["C2344"] helpviewer_keywords: ["C2344"] -ms.assetid: a84c7b37-c84e-4345-8691-c23abb2dc193 --- # Compiler Error C2344 -align(#) : alignment must be power of two +> align(#) : alignment must be power of two + +## Remarks When using the [align](../../cpp/align-cpp.md) keyword, the value you pass must be a power of two. +## Example + For example, the following code generates C2344 because 3 is not a power of two: ```cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2345.md b/docs/error-messages/compiler-errors-1/compiler-error-c2345.md index 4044e32b0e7..6d621a6d8c2 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2345.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2345.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2345" title: "Compiler Error C2345" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2345" +ms.date: 11/04/2016 f1_keywords: ["C2345"] helpviewer_keywords: ["C2345"] -ms.assetid: e1cc88b0-0223-4d07-975b-fa99956a82bd --- # Compiler Error C2345 -align(value) : illegal alignment value +> align(value) : illegal alignment value + +## Remarks You passed a value to the [align](../../cpp/align-cpp.md) keyword that is outside the allowable range. -The following sample generates C2345: +## Example + +The following example generates C2345: ```cpp // C2345.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2346.md b/docs/error-messages/compiler-errors-1/compiler-error-c2346.md index 6c26eabe752..b4a03aaf133 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2346.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2346.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Error C2346" title: "Compiler Error C2346" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2346" +ms.date: 11/04/2016 f1_keywords: ["C2346"] helpviewer_keywords: ["C2346"] -ms.assetid: 246145be-5645-4cd6-867c-e3bc39e33dca --- # Compiler Error C2346 -'function' cannot be compiled as native: reason +> 'function' cannot be compiled as native: reason + +## Remarks The compiler was unable to compile a function to MSIL. @@ -22,7 +23,7 @@ For more information, see [managed, unmanaged](../../preprocessor/managed-unmana ## Example -The following sample generates C2346. +The following example generates C2346. ```cpp // C2346.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2348.md b/docs/error-messages/compiler-errors-1/compiler-error-c2348.md index 66e3378836a..f2d45f255de 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2348.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2348.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2348" title: "Compiler Error C2348" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2348" +ms.date: 11/04/2016 f1_keywords: ["C2348"] helpviewer_keywords: ["C2348"] -ms.assetid: 4c4d701f-ccf1-46fe-9ddb-3f341684f269 --- # Compiler Error C2348 -'type name' : is not a C-style aggregate, cannot be exported in embedded-IDL +> 'type name' : is not a C-style aggregate, cannot be exported in embedded-IDL + +## Remarks To place a **`struct`** in a .idl file with the [export](../../windows/attributes/export.md) attribute, the **`struct`** must contain only data. -The following sample generates C2348: +## Example + +The following example generates C2348: ```cpp // C2348.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2349.md b/docs/error-messages/compiler-errors-1/compiler-error-c2349.md index 4b596fc273d..b365f1b240e 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2349.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2349.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Compiler Error C2349" title: "Compiler Error C2349" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2349" +ms.date: 11/04/2016 f1_keywords: ["C2349"] helpviewer_keywords: ["C2349"] -ms.assetid: ce9f2e65-fda0-41b6-9c4a-538607136396 --- # Compiler Error C2349 -'function' cannot be compiled as managed: 'reason'; use #pragma unmanaged +> 'function' cannot be compiled as managed: 'reason'; use #pragma unmanaged + +## Remarks -For more information see [Compiler Warning (level 1 and 3) C4793](../../error-messages/compiler-warnings/compiler-warning-level-1-and-3-c4793.md). +For more information, see [Compiler Warning (level 1 and 3) C4793](../../error-messages/compiler-warnings/compiler-warning-level-1-and-3-c4793.md). diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2350.md b/docs/error-messages/compiler-errors-1/compiler-error-c2350.md index f4ba948e013..8d4160dde22 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2350.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2350.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Compiler Error C2350" title: "Compiler Error C2350" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2350" +ms.date: 11/04/2016 f1_keywords: ["C2350"] helpviewer_keywords: ["C2350"] -ms.assetid: 3a50cb94-8ced-4df4-b602-c48916fa957d --- # Compiler Error C2350 -'identifier' is not a static member +> 'identifier' is not a static member + +## Remarks Nonstatic members of a class or structure cannot be defined. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2351.md b/docs/error-messages/compiler-errors-1/compiler-error-c2351.md index cb65e6f46a4..a3f4108c1ca 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2351.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2351.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2351" title: "Compiler Error C2351" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2351" +ms.date: 11/04/2016 f1_keywords: ["C2351"] helpviewer_keywords: ["C2351"] -ms.assetid: 5439ccf6-66f6-4859-964c-c73f5eddfc1b --- # Compiler Error C2351 -obsolete C++ constructor initialization syntax +> obsolete C++ constructor initialization syntax + +## Remarks In a new-style initialization list for a constructor, you must explicitly name each direct base class, even if it is the only base class. -The following sample generates C2351: +## Example + +The following example generates C2351: ```cpp // C2351.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2352.md b/docs/error-messages/compiler-errors-1/compiler-error-c2352.md index 54c319840ee..8a5af21eae8 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2352.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2352.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2352" title: "Compiler Error C2352" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2352" +ms.date: 11/04/2016 f1_keywords: ["C2352"] helpviewer_keywords: ["C2352"] -ms.assetid: 0efad8cb-659f-4b3e-8f6f-9f8ec44d345c --- # Compiler Error C2352 -'class::function' : illegal call of non-static member function +> 'class::function' : illegal call of non-static member function + +## Remarks A **`static`** member function called a nonstatic member function. Or, a nonstatic member function was called from outside the class as a static function. -The following sample generates C2352 and shows how to fix it: +## Examples + +The following example generates C2352 and shows how to fix it: ```cpp // C2352.cpp @@ -28,7 +31,7 @@ public: }; ``` -The following sample generates C2352 and shows how to fix it: +The following example generates C2352 and shows how to fix it: ```cpp // C2352b.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2353.md b/docs/error-messages/compiler-errors-1/compiler-error-c2353.md index bbf3f1fdc64..50668f8cfe2 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2353.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2353.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2353" title: "Compiler Error C2353" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2353" +ms.date: 11/04/2016 f1_keywords: ["C2353"] helpviewer_keywords: ["C2353"] -ms.assetid: d57f8f77-d9b1-4bba-a940-87ec269ad183 --- # Compiler Error C2353 -exception specification is not allowed +> exception specification is not allowed + +## Remarks Exception specifications are not allowed on member functions of managed classes. -The following sample generates C2353: +## Example + +The following example generates C2353: ```cpp // C2353.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2355.md b/docs/error-messages/compiler-errors-1/compiler-error-c2355.md index 3c2ec1586f3..abde37c99c8 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2355.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2355.md @@ -1,20 +1,23 @@ --- -description: "Learn more about: Compiler Error C2355" title: "Compiler Error C2355" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2355" +ms.date: 11/04/2016 f1_keywords: ["C2355"] helpviewer_keywords: ["C2355"] -ms.assetid: 0a947881-d61f-4f98-8409-32140f39500b --- # Compiler Error C2355 -'this' : can only be referenced inside non-static member functions or non-static data member initializers +> 'this' : can only be referenced inside non-static member functions or non-static data member initializers + +## Remarks The **`this`** pointer is valid only within non-static member functions or in non-static data member initializers. This error can result when the class scope of a member function definition outside of the class declaration is not properly qualified. The error can also occur when the **`this`** pointer is used in a function that is not declared in the class. To fix this issue, make sure the member function definition matches a member function declaration in the class, and that it is not declared static. For data member initializers, make sure the data member is not declared static. -The following sample generates C2355 and shows how to fix it: +## Example + +The following example generates C2355 and shows how to fix it: ```cpp // C2355.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2356.md b/docs/error-messages/compiler-errors-1/compiler-error-c2356.md index 6049b17292d..3ee44ce9730 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2356.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2356.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Error C2356" title: "Compiler Error C2356" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2356" +ms.date: 11/04/2016 f1_keywords: ["C2356"] helpviewer_keywords: ["C2356"] -ms.assetid: 84d5a816-9a61-4d45-9978-38e485bbf767 --- # Compiler Error C2356 -initialization segment must not change during translation unit +> initialization segment must not change during translation unit + +## Remarks Possible causes: @@ -18,7 +19,9 @@ Possible causes: To resolve, move the segment initialization code to the beginning of the module. If multiple areas must be initialized, move them to separate modules. -The following sample generates C2356: +## Example + +The following example generates C2356: ```cpp // C2356.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2357.md b/docs/error-messages/compiler-errors-1/compiler-error-c2357.md index 0b06b9383d1..67b2a2901ce 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2357.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2357.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Error C2357" title: "Compiler Error C2357" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2357" +ms.date: 11/04/2016 f1_keywords: ["C2357"] helpviewer_keywords: ["C2357"] -ms.assetid: d1083945-0ea2-4385-9e66-8c665978806c --- # Compiler Error C2357 -'identifier' : must be a function of type 'type' +> 'identifier' : must be a function of type 'type' + +## Remarks Your code declares a version of the `atexit` function that does not match the version declared internally by the compiler. Declare `atexit` as follows: @@ -18,7 +19,9 @@ int __cdecl atexit(void (__cdecl *)()); For more information, see [init_seg](../../preprocessor/init-seg.md). -The following sample generates C2357: +## Example + +The following example generates C2357: ```cpp // C2357.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2360.md b/docs/error-messages/compiler-errors-1/compiler-error-c2360.md index 3fc5204e7bb..58a393241ac 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2360.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2360.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2360" title: "Compiler Error C2360" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2360" +ms.date: 11/04/2016 f1_keywords: ["C2360"] helpviewer_keywords: ["C2360"] -ms.assetid: 51bfd2ee-8108-4777-aa93-148b9cebfa83 --- # Compiler Error C2360 -initialization of 'identifier' is skipped by 'case' label +> initialization of 'identifier' is skipped by 'case' label + +## Remarks The initialization of `identifier` can be skipped in a **`switch`** statement. You cannot jump past a declaration with an initializer unless the declaration is enclosed in a block. (Unless it is declared within a block, the variable is within scope until the end of the **`switch`** statement.) -The following sample generates C2360: +## Example + +The following example generates C2360: ```cpp // C2360.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2361.md b/docs/error-messages/compiler-errors-1/compiler-error-c2361.md index 6a7962c2d68..8c6743d7d40 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2361.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2361.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2361" title: "Compiler Error C2361" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2361" +ms.date: 11/04/2016 f1_keywords: ["C2361"] helpviewer_keywords: ["C2361"] -ms.assetid: efbdaeb9-891c-4f7d-97da-89088a8413f3 --- # Compiler Error C2361 -initialization of 'identifier' is skipped by 'default' label +> initialization of 'identifier' is skipped by 'default' label + +## Remarks The initialization of `identifier` can be skipped in a **`switch`** statement. You cannot jump past a declaration with an initializer unless the declaration is enclosed in a block. (Unless it is declared within a block, the variable is within scope until the end of the **`switch`** statement.) -The following sample generates C2361: +## Example + +The following example generates C2361: ```cpp // C2361.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2362.md b/docs/error-messages/compiler-errors-1/compiler-error-c2362.md index ee78fcd6f02..5691441c218 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2362.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2362.md @@ -1,20 +1,23 @@ --- -description: "Learn more about: Compiler Error C2362" title: "Compiler Error C2362" -ms.date: "06/03/2019" +description: "Learn more about: Compiler Error C2362" +ms.date: 06/03/2019 f1_keywords: ["C2362"] helpviewer_keywords: ["C2362"] -ms.assetid: 7aafecbc-b3cf-45a6-9ec3-a17e3f222511 --- # Compiler Error C2362 > initialization of '*identifier*' is skipped by 'goto *label*' +## Remarks + When compiled by using [/Za](../../build/reference/za-ze-disable-language-extensions.md), a jump to the label prevents the identifier from being initialized. You can only jump past a declaration with an initializer if the declaration is enclosed in a block that isn't entered, or if the variable has already been initialized. -The following sample generates C2362: +## Example + +The following example generates C2362: ```cpp // C2362.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2364.md b/docs/error-messages/compiler-errors-1/compiler-error-c2364.md index 38050c2e713..8eeabc0bef7 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2364.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2364.md @@ -1,20 +1,21 @@ --- -description: "Learn more about: Compiler Error C2364" title: "Compiler Error C2364" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2364" +ms.date: 11/04/2016 f1_keywords: ["C2364"] helpviewer_keywords: ["C2364"] -ms.assetid: 4f550571-94b5-42ca-84cb-663fecbead44 --- # Compiler Error C2364 -'type': illegal type for custom attribute +> 'type': illegal type for custom attribute + +## Remarks Named arguments for custom attributes are limited to compile time constants. For example, integral types (int, char, etc.), System::Type^, and System::Object^. ## Example -The following sample generates C2364. +The following example generates C2364. ```cpp // c2364.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2365.md b/docs/error-messages/compiler-errors-1/compiler-error-c2365.md index 11c859cbdd7..7fd276bfe74 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2365.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2365.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2365" title: "Compiler Error C2365" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2365" +ms.date: 11/04/2016 f1_keywords: ["C2365"] helpviewer_keywords: ["C2365"] -ms.assetid: 35839b0b-4055-4b79-8957-b3a0871bdd02 --- # Compiler Error C2365 -'class member' : redefinition; previous definition was 'class member' +> 'class member' : redefinition; previous definition was 'class member' + +## Remarks You attempted to redefine a class member. -The following sample generates C2365. +## Example + +The following example generates C2365. ```cpp // C2365.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2368.md b/docs/error-messages/compiler-errors-1/compiler-error-c2368.md index a2f6d269f02..7711b7ae2c4 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2368.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2368.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Compiler Error C2368" title: "Compiler Error C2368" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2368" +ms.date: 11/04/2016 f1_keywords: ["C2368"] helpviewer_keywords: ["C2368"] -ms.assetid: a824626f-9fb5-453b-a3a4-da89d1e32218 --- # Compiler Error C2368 -'identifier' : redefinition; different allocation specifiers +> 'identifier' : redefinition; different allocation specifiers + +## Remarks The declaration and definition of the symbol specify different **`__declspec`** attributes. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2369.md b/docs/error-messages/compiler-errors-1/compiler-error-c2369.md index aab5f981a69..27a97bd4866 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2369.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2369.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2369" title: "Compiler Error C2369" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2369" +ms.date: 11/04/2016 f1_keywords: ["C2369"] helpviewer_keywords: ["C2369"] -ms.assetid: 2a3933f6-2313-40ff-800f-921b296fdbbf --- # Compiler Error C2369 -'array' : redefinition; different subscripts +> 'array' : redefinition; different subscripts + +## Remarks The array is already declared with a different subscript. -The following sample generates C2369: +## Example + +The following example generates C2369: ```cpp // C2369.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2370.md b/docs/error-messages/compiler-errors-1/compiler-error-c2370.md index 644e2724e52..256c331a639 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2370.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2370.md @@ -1,20 +1,21 @@ --- -description: "Learn more about: Compiler Error C2370" title: "Compiler Error C2370" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2370" +ms.date: 11/04/2016 f1_keywords: ["C2370"] helpviewer_keywords: ["C2370"] -ms.assetid: 03403e8f-f393-47c4-bd25-5c1c7ea7d5cd --- # Compiler Error C2370 -'identifier' : redefinition; different storage class +> 'identifier' : redefinition; different storage class + +## Remarks The identifier is already declared with a different storage class. ## Examples -The following sample generates C2370: +The following example generates C2370: ```cpp // C2370.cpp @@ -24,7 +25,7 @@ static int i; // C2370 int i; // OK ``` -The following sample generates C2370: +The following example generates C2370: ```cpp // C2370b.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2371.md b/docs/error-messages/compiler-errors-1/compiler-error-c2371.md index 3574efe5302..bb5ba669bfc 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2371.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2371.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2371" title: "Compiler Error C2371" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2371" +ms.date: 11/04/2016 f1_keywords: ["C2371"] helpviewer_keywords: ["C2371"] -ms.assetid: d383993d-05ef-4e35-8129-3b58a6f7b7b7 --- # Compiler Error C2371 -'identifier' : redefinition; different basic types +> 'identifier' : redefinition; different basic types + +## Remarks The identifier is already declared. -The following sample generates C2371: +## Example + +The following example generates C2371: ```cpp // C2371.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2372.md b/docs/error-messages/compiler-errors-1/compiler-error-c2372.md index eac3e935a76..e893c5eb51e 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2372.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2372.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2372" title: "Compiler Error C2372" -ms.date: "03/23/2020" +description: "Learn more about: Compiler Error C2372" +ms.date: 03/23/2020 f1_keywords: ["C2372"] helpviewer_keywords: ["C2372"] -ms.assetid: 406bea63-c8d3-4231-9d26-c70af6980840 --- # Compiler Error C2372 > '*identifier*' : redefinition; different types of indirection +## Remarks + The identifier is already defined with a different derived type. -The following sample generates C2372: +## Example + +The following example generates C2372: ```cpp // C2372.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2373.md b/docs/error-messages/compiler-errors-1/compiler-error-c2373.md index 2122dfb2982..1a2078adf1a 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2373.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2373.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2373" title: "Compiler Error C2373" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2373" +ms.date: 11/04/2016 f1_keywords: ["C2373"] helpviewer_keywords: ["C2373"] -ms.assetid: 7a08bf0b-852d-48be-ba75-70df9f4b5951 --- # Compiler Error C2373 -'identifier' : redefinition; different type modifiers +> 'identifier' : redefinition; different type modifiers + +## Remarks The identifier is already defined with a different type modifier. -The following sample generates C2373: +## Example + +The following example generates C2373: ``` // C2373.h diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2374.md b/docs/error-messages/compiler-errors-1/compiler-error-c2374.md index 6d1b49420da..ae1d39df38d 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2374.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2374.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2374" title: "Compiler Error C2374" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2374" +ms.date: 11/04/2016 f1_keywords: ["C2374"] helpviewer_keywords: ["C2374"] -ms.assetid: 73b51965-e91c-4e21-9732-f71c1449d22e --- # Compiler Error C2374 -'identifier' : redefinition; multiple initialization +> 'identifier' : redefinition; multiple initialization + +## Remarks The identifier is initialized more than once. -The following sample generates C2374: +## Example + +The following example generates C2374: ```cpp // C2374.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2375.md b/docs/error-messages/compiler-errors-1/compiler-error-c2375.md index 2a7da09bf72..a70339533a4 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2375.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2375.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2375" title: "Compiler Error C2375" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2375" +ms.date: 11/04/2016 f1_keywords: ["C2375"] helpviewer_keywords: ["C2375"] -ms.assetid: 193c5e8b-1b20-4928-8a02-8c1cddaf2a26 --- # Compiler Error C2375 -'function' : redefinition; different linkage +> 'function' : redefinition; different linkage + +## Remarks The function is already declared with a different linkage specifier. -The following sample generates C2375: +## Example + +The following example generates C2375: ```cpp // C2375.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2376.md b/docs/error-messages/compiler-errors-1/compiler-error-c2376.md index 6e089703c80..0cb73a4d373 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2376.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2376.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Compiler Error C2376" title: "Compiler Error C2376" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2376" +ms.date: 11/04/2016 f1_keywords: ["C2376"] helpviewer_keywords: ["C2376"] -ms.assetid: 89423cf7-a24a-4bb3-a2ed-36a1ff8ba458 --- # Compiler Error C2376 -'function' : redefinition; different based allocation +> 'function' : redefinition; different based allocation + +## Remarks The function is already declared with a different based allocation. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2377.md b/docs/error-messages/compiler-errors-1/compiler-error-c2377.md index 409d365c347..5ed9e0b2649 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2377.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2377.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2377" title: "Compiler Error C2377" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2377" +ms.date: 11/04/2016 f1_keywords: ["C2377"] helpviewer_keywords: ["C2377"] -ms.assetid: f7660965-bf4c-4cd9-8307-1bd7016678a1 --- # Compiler Error C2377 -'identifier' : redefinition; typedef cannot be overloaded with any other symbol +> 'identifier' : redefinition; typedef cannot be overloaded with any other symbol + +## Remarks A **`typedef`** identifier is redefined. -The following sample generates C2377: +## Example + +The following example generates C2377: ```cpp // C2377.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2378.md b/docs/error-messages/compiler-errors-1/compiler-error-c2378.md index a42b65d5c7c..5005fb5f367 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2378.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2378.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2378" title: "Compiler Error C2378" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2378" +ms.date: 11/04/2016 f1_keywords: ["C2378"] helpviewer_keywords: ["C2378"] -ms.assetid: 507a91c6-ca72-48df-b3a4-2cf931c86806 --- # Compiler Error C2378 -'identifier' : redefinition; symbol cannot be overloaded with a typedef +> 'identifier' : redefinition; symbol cannot be overloaded with a typedef + +## Remarks The identifier was redefined as a **`typedef`**. -The following sample generates C2378: +## Example + +The following example generates C2378: ```cpp // C2378.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2379.md b/docs/error-messages/compiler-errors-1/compiler-error-c2379.md index f10e6b2a952..46c248af538 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2379.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2379.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2379" title: "Compiler Error C2379" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2379" +ms.date: 11/04/2016 f1_keywords: ["C2379"] helpviewer_keywords: ["C2379"] -ms.assetid: 37dc3015-a4af-4341-bbf3-da6150df7e51 --- # Compiler Error C2379 -formal parameter number has different type when promoted +> formal parameter number has different type when promoted + +## Remarks The type of the specified parameter is not compatible, through default promotions, with the type in a previous declaration. This is an error in ANSI C ([/Za](../../build/reference/za-ze-disable-language-extensions.md)) and a warning with Microsoft extensions (**/Ze**). -The following sample generates C2379: +## Example + +The following example generates C2379: ```c // C2379.c diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2380.md b/docs/error-messages/compiler-errors-1/compiler-error-c2380.md index 4e2bdc50260..a0745e12c88 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2380.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2380.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2380" title: "Compiler Error C2380" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2380" +ms.date: 11/04/2016 f1_keywords: ["C2380"] helpviewer_keywords: ["C2380"] -ms.assetid: 717b1e6e-ddfe-4bac-a5f3-7f9a4dcb1572 --- # Compiler Error C2380 -type(s) preceding 'identifier' (constructor with return type, or illegal redefinition of current class-name?) +> type(s) preceding 'identifier' (constructor with return type, or illegal redefinition of current class-name?) + +## Remarks A constructor returns a value or redefines the class name. -The following sample generates C2326: +## Example + +The following example generates C2380: ```cpp // C2380.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2381.md b/docs/error-messages/compiler-errors-1/compiler-error-c2381.md index 86b2ef3426c..01ef31cff42 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2381.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2381.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2381" title: "Compiler Error C2381" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2381" +ms.date: 11/04/2016 f1_keywords: ["C2381"] helpviewer_keywords: ["C2381"] -ms.assetid: cc765f67-64ac-406f-93ef-ae7d548d58d7 --- # Compiler Error C2381 -'function' : redefinition; __declspec(noreturn) differs +> 'function' : redefinition; __declspec(noreturn) differs + +## Remarks A function was declared and then defined but the definition used the [noreturn](../../cpp/noreturn.md) **`__declspec`** modifier. The use of `noreturn` constitutes a redefinition of the function; the declaration and definition need to agree on the use of `noreturn`. -The following sample generates C2381: +## Example + +The following example generates C2381: ```cpp // C2381.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2382.md b/docs/error-messages/compiler-errors-1/compiler-error-c2382.md index 93ae496d52e..d4542d3dfb9 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2382.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2382.md @@ -1,26 +1,25 @@ --- -description: "Learn more about: Compiler Error C2382" title: "Compiler Error C2382" +description: "Learn more about: Compiler Error C2382" ms.date: 12/10/2021 f1_keywords: ["C2382"] helpviewer_keywords: ["C2382"] -ms.assetid: 4d4436f9-d0d6-4bd0-b8ec-767b89adfb2f --- # Compiler Error C2382 > '*function*' : redefinition; different exception specifications -This error indicates that a function overload was attempted only on the [exception specification](../../cpp/exception-specifications-throw-cpp.md). - ## Remarks +This error indicates that a function overload was attempted only on the [exception specification](../../cpp/exception-specifications-throw-cpp.md). + By default, the compiler considers a `noexcept` specification to be equivalent to a `throw()` or `throw(some_type)` specification. Under [`/Za`](../../build/reference/za-ze-disable-language-extensions.md), this check is more strict. To resolve this issue, change all declarations and definitions of the function (or the specific function overload) to use the same exception specification. ## Example -The following sample generates C2382: +The following example generates C2382: ```cpp // C2382.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2383.md b/docs/error-messages/compiler-errors-1/compiler-error-c2383.md index 1e0db5c5781..07b1a0d9d32 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2383.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2383.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Error C2383" title: "Compiler Error C2383" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2383" +ms.date: 11/04/2016 f1_keywords: ["C2383"] helpviewer_keywords: ["C2383"] -ms.assetid: 6696221d-879c-477a-a0f3-a6edc15fd3d7 --- # Compiler Error C2383 -'*symbol*' : default-arguments are not allowed on this symbol +> '*symbol*' : default-arguments are not allowed on this symbol + +## Remarks The C++ compiler does not allow default arguments on pointers to functions. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2384.md b/docs/error-messages/compiler-errors-1/compiler-error-c2384.md index ceff45b6302..19755c18cd9 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2384.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2384.md @@ -1,19 +1,22 @@ --- -description: "Learn more about: Compiler Error C2384" title: "Compiler Error C2384" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2384" +ms.date: 11/04/2016 f1_keywords: ["C2384"] helpviewer_keywords: ["C2384"] -ms.assetid: 8145f7ad-31b1-406d-ac43-0d557feab635 --- # Compiler Error C2384 -'member' : cannot apply __declspec(thread) to a member of a managed or WinRT class +> 'member' : cannot apply __declspec(thread) to a member of a managed or WinRT class + +## Remarks The [thread](../../cpp/thread.md) **`__declspec`** modifier cannot be used on a member of a managed or Windows Runtime class. Static thread local storage in managed code can only be used for statically loaded DLLs—the DLL must be statically loaded when the process starts. Windows Runtime does not support thread local storage. +## Example + The following line generates C2384 and shows how to fix it in C++/CLI code: ```cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2385.md b/docs/error-messages/compiler-errors-1/compiler-error-c2385.md index 073c282ce9b..1db2d3606f3 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2385.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2385.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: Compiler Error C2385" title: "Compiler Error C2385" -ms.date: "1/19/2024" +description: "Learn more about: Compiler Error C2385" +ms.date: 1/19/2024 f1_keywords: ["C2385"] helpviewer_keywords: ["C2385"] --- @@ -9,6 +9,8 @@ helpviewer_keywords: ["C2385"] > ambiguous access of 'member' +## Remarks + A member is inherited from more than one base type, making unqualified access to that member ambiguous. To resolve this error: - Explicitly qualify access to the member. @@ -18,7 +20,7 @@ A member is inherited from more than one base type, making unqualified access to ## Example -The following sample generates C2385: +The following example generates C2385: ```cpp // C2385.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2386.md b/docs/error-messages/compiler-errors-1/compiler-error-c2386.md index 012734bc39e..0c6ef1105bd 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2386.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2386.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2386" title: "Compiler Error C2386" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2386" +ms.date: 11/04/2016 f1_keywords: ["C2386"] helpviewer_keywords: ["C2386"] -ms.assetid: aaaa1284-34a0-4da2-8547-9fcbb559dae0 --- # Compiler Error C2386 -'symbol' : a symbol with this name already exists in the current scope +> 'symbol' : a symbol with this name already exists in the current scope + +## Remarks You tried to create a namespace alias, but the name you chose already exists. -The following sample generates C2386: +## Example + +The following example generates C2386: ```cpp // C2386.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2387.md b/docs/error-messages/compiler-errors-1/compiler-error-c2387.md index 9eb33692520..d14ff9cbb32 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2387.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2387.md @@ -1,20 +1,23 @@ --- -description: "Learn more about: Compiler Error C2387" title: "Compiler Error C2387" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2387" +ms.date: 11/04/2016 f1_keywords: ["C2387"] helpviewer_keywords: ["C2387"] -ms.assetid: 6847b8e1-ffac-458d-ab88-0c92f72f2527 --- # Compiler Error C2387 -'type' : ambiguous base class +> 'type' : ambiguous base class + +## Remarks The compiler could not unambiguously resolve a function call because the function exists in more than one base class. To resolve this error, either remove one of the base classes from the inheritance, or explicitly qualify the function call. -The following sample generates C2387: +## Example + +The following example generates C2387: ```cpp // C2387.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2388.md b/docs/error-messages/compiler-errors-1/compiler-error-c2388.md index 28c5b68ad5b..8c10c31f398 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2388.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2388.md @@ -1,20 +1,23 @@ --- -description: "Learn more about: Compiler Error C2388" title: "Compiler Error C2388" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2388" +ms.date: 11/04/2016 f1_keywords: ["C2388"] helpviewer_keywords: ["C2388"] -ms.assetid: 764ad2d7-cb04-425f-ba30-70989488c4a4 --- # Compiler Error C2388 -'symbol' : a symbol cannot be declared with both __declspec(appdomain) and \__declspec(process) +> 'symbol' : a symbol cannot be declared with both __declspec(appdomain) and \__declspec(process) + +## Remarks The `appdomain` and `process` **`__declspec`** modifiers cannot be used on the same symbol. The storage for a variable exists per process or per application domain. For more information, see [appdomain](../../cpp/appdomain.md) and [process](../../cpp/process.md). -The following sample generates C2388: +## Example + +The following example generates C2388: ```cpp // C2388.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2389.md b/docs/error-messages/compiler-errors-1/compiler-error-c2389.md index 6f13b7db12c..4c354f6d1f2 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2389.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2389.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2389" title: "Compiler Error C2389" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2389" +ms.date: 11/04/2016 f1_keywords: ["C2389"] helpviewer_keywords: ["C2389"] -ms.assetid: 6122dc81-4ee3-49a5-a67d-d867808c9bac --- # Compiler Error C2389 -'operator' : illegal operand 'nullptr' +> 'operator' : illegal operand 'nullptr' + +## Remarks **`nullptr`** cannot be an operand. -The following sample generates C2389: +## Example + +The following example generates C2389: ```cpp // C2389.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2390.md b/docs/error-messages/compiler-errors-1/compiler-error-c2390.md index bab715650c8..8cb77912ec8 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2390.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2390.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Error C2390" title: "Compiler Error C2390" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2390" +ms.date: 11/04/2016 f1_keywords: ["C2390"] helpviewer_keywords: ["C2390"] -ms.assetid: 06b749ee-d072-4db1-b229-715f2c0728b5 --- # Compiler Error C2390 -'identifier' : incorrect storage class 'specifier' +> 'identifier' : incorrect storage class 'specifier' + +## Remarks The storage class is not valid for the global-scope identifier. The default storage class is used in place of the invalid class. @@ -22,7 +23,7 @@ Possible resolutions: ## Example -- The following sample generates C2390: +The following example generates C2390: ```cpp // C2390.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2391.md b/docs/error-messages/compiler-errors-1/compiler-error-c2391.md index b1895fb9ffc..283aeb7e762 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2391.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2391.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2391" title: "Compiler Error C2391" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2391" +ms.date: 11/04/2016 f1_keywords: ["C2391"] helpviewer_keywords: ["C2391"] -ms.assetid: 63a9c6b9-03cc-4517-885c-bdcd048643b3 --- # Compiler Error C2391 -'identifier' : 'friend' cannot be used during type definition +> 'identifier' : 'friend' cannot be used during type definition + +## Remarks The **`friend`** declaration includes a complete class declaration. A **`friend`** declaration can specify a member function or an elaborated type specifier, but not a complete class declaration. -The following sample generates C2326: +## Example + +The following example generates C2391: ```cpp // C2391.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2392.md b/docs/error-messages/compiler-errors-1/compiler-error-c2392.md index 81f7a1df2e4..70e6acb33cb 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2392.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2392.md @@ -1,20 +1,21 @@ --- -description: "Learn more about: Compiler Error C2392" title: "Compiler Error C2392" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2392" +ms.date: 11/04/2016 f1_keywords: ["C2392"] helpviewer_keywords: ["C2392"] -ms.assetid: 98ced473-6383-46ed-b79c-21857d65dcb2 --- # Compiler Error C2392 -'method1' : covariant returns types are not supported in managed or WinRTtypes, otherwise 'method2' would be overridden +> 'method1' : covariant returns types are not supported in managed or WinRTtypes, otherwise 'method2' would be overridden + +## Remarks Covariant return types are not allowed for Windows Runtime member functions or when compiling with the [/clr (Common Language Runtime Compilation)](../../build/reference/clr-common-language-runtime-compilation.md) option. ## Example -The following sample generates C2392 and shows how to fix it. +The following example generates C2392 and shows how to fix it. ```cpp // C2392.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2393.md b/docs/error-messages/compiler-errors-1/compiler-error-c2393.md index 36d2868f7bf..fe80176868d 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2393.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2393.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2393" title: "Compiler Error C2393" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2393" +ms.date: 11/04/2016 f1_keywords: ["C2393"] helpviewer_keywords: ["C2393"] -ms.assetid: 4bd95728-e813-4ce8-844a-c6ebe235ca82 --- # Compiler Error C2393 @@ -20,7 +19,7 @@ See [/clr (Common Language Runtime Compilation)](../../build/reference/clr-commo ## Example -The following sample generates C2393. To fix this issue, do not create a data segment. +The following example generates C2393. To fix this issue, do not create a data segment. ```cpp // C2393.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2394.md b/docs/error-messages/compiler-errors-1/compiler-error-c2394.md index 14b86fb0447..58274a9b468 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2394.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2394.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2394" title: "Compiler Error C2394" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2394" +ms.date: 11/04/2016 f1_keywords: ["C2394"] helpviewer_keywords: ["C2394"] -ms.assetid: 653fa9a0-29b3-48aa-bc01-82f98f717a2b --- # Compiler Error C2394 -'your_type::operator'op'" : CLR or WinRToperator not valid. At least one parameter must be of the following types: 'T^', 'T^%', 'T^&', where T = 'your_type' +> '*type*::operator *operator*': CLR/WinRT operator not valid. At least one parameter must be of the following types: 'T^', 'T^%', 'T^&', where T = 'type' + +## Remarks An operator in a Windows Runtime or managed type did not have at least one parameter whose type is the same as the type of the operator return value. -The following sample generates C2394: +## Example + +The following example generates C2394: ```cpp // C2394.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2395.md b/docs/error-messages/compiler-errors-1/compiler-error-c2395.md index 214524e4d84..1d4a90319a9 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2395.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2395.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2395" title: "Compiler Error C2395" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2395" +ms.date: 11/04/2016 f1_keywords: ["C2395"] helpviewer_keywords: ["C2395"] -ms.assetid: 2d9e3b28-8c2c-4f41-a57f-61ef88fc2af0 --- # Compiler Error C2395 -'your_type::operator'op'' : CLR or WinRT operator not valid. At least one parameter must be of the following types: 'T', 'T%', 'T&', 'T^', 'T^%', 'T^&', where T = 'your_type' +> 'your_type::operator'op'' : CLR or WinRT operator not valid. At least one parameter must be of the following types: 'T', 'T%', 'T&', 'T^', 'T^%', 'T^&', where T = 'your_type' + +## Remarks An operator in a Windows Runtime or managed type did not have at least one parameter whose type is the same as the type of the operator return value. -The following sample generates C2395 and shows how to fix it: +## Example + +The following example generates C2395 and shows how to fix it: ```cpp // C2395.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2396.md b/docs/error-messages/compiler-errors-1/compiler-error-c2396.md index 1bbd9657c83..8fa97066805 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2396.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2396.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2396" title: "Compiler Error C2396" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2396" +ms.date: 11/04/2016 f1_keywords: ["C2396"] helpviewer_keywords: ["C2396"] -ms.assetid: 1b515ef6-7af4-400f-b4ed-564313ea15f6 --- # Compiler Error C2396 -'your_type::operator'type'' : CLR or WinRT user-defined conversion functionnot valid. Must either convert from or convert to: 'T^', 'T^%', 'T^&', where T = 'your_type' +> 'your_type::operator'type'' : CLR or WinRT user-defined conversion functionnot valid. Must either convert from or convert to: 'T^', 'T^%', 'T^&', where T = 'your_type' + +## Remarks A conversion function in a Windows Runtime or managed type did not have at least one parameter whose type is the same as the type containing the conversion function. -The following sample generates C2396 and shows how to fix it: +## Example + +The following example generates C2396 and shows how to fix it: ```cpp // C2396.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2397.md b/docs/error-messages/compiler-errors-1/compiler-error-c2397.md index 271763d69f2..8563bf8e4fe 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2397.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2397.md @@ -1,13 +1,15 @@ --- -description: "Learn more about: Compiler Error C2397" title: "Compiler Error C2397" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2397" +ms.date: 11/04/2016 f1_keywords: ["C2397"] -ms.assetid: b418cf5a-d50d-4a6c-98a7-994ae35046d1 +helpviewer_keywords: ["C2397"] --- # Compiler Error C2397 -conversion from 'type_1' to 'type_2' requires a narrowing conversion +> conversion from 'type_1' to 'type_2' requires a narrowing conversion + +## Remarks An implicit narrowing conversion was found when using uniform initialization. @@ -15,7 +17,9 @@ The C language allows implicit narrowing conversions in assignments and initiali A narrowing conversion can be okay when you know the possible range of converted values can fit in the target. In this case, you know more than the compiler does. If you make a narrowing conversion intentionally, make your intentions explicit by using a static cast. Otherwise, this error message almost always indicates you have a bug in your code. You can fix it by making sure the objects you initialize have types that are large enough to handle the inputs. -The following sample generates C2397: +## Example + +The following example generates C2397: ```cpp // C2397.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2400.md b/docs/error-messages/compiler-errors-1/compiler-error-c2400.md index 5cde822bb86..88ccb9b2eec 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2400.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2400.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2400" title: "Compiler Error C2400" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2400" +ms.date: 11/04/2016 f1_keywords: ["C2400"] helpviewer_keywords: ["C2400"] -ms.assetid: 1ba441ee-73f9-42a5-bfe9-fbeab93808eb --- # Compiler Error C2400 -inline assembler syntax error in 'context'; found 'token' +> inline assembler syntax error in 'context'; found 'token' + +## Remarks The token caused a syntax error in the specified context. -The following sample generates C2400: +## Example + +The following example generates C2400: ```cpp // C2400.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2401.md b/docs/error-messages/compiler-errors-1/compiler-error-c2401.md index 7a729d9dc0a..de3de95c5ea 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2401.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2401.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Compiler Error C2401" title: "Compiler Error C2401" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2401" +ms.date: 11/04/2016 f1_keywords: ["C2401"] helpviewer_keywords: ["C2401"] -ms.assetid: 4c237b34-f771-4106-93e2-82dae337f1e2 --- # Compiler Error C2401 -'identifier' : register must be base in 'context' +> 'identifier' : register must be base in 'context' + +## Remarks The register used in an indirect memory operand must be a base register in this context. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2402.md b/docs/error-messages/compiler-errors-1/compiler-error-c2402.md index 82a4fc4ea0e..18f1900886b 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2402.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2402.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Compiler Error C2402" title: "Compiler Error C2402" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2402" +ms.date: 11/04/2016 f1_keywords: ["C2402"] helpviewer_keywords: ["C2402"] -ms.assetid: 23fa63e1-ea9e-482f-be2e-a205c548ba69 --- # Compiler Error C2402 -'identifier' : register must be index in 'context' +> 'identifier' : register must be index in 'context' + +## Remarks The register used in an indirect memory operand must be an index register in this context. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2403.md b/docs/error-messages/compiler-errors-1/compiler-error-c2403.md index c570c28dd6f..3526871fd49 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2403.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2403.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Compiler Error C2403" title: "Compiler Error C2403" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2403" +ms.date: 11/04/2016 f1_keywords: ["C2403"] helpviewer_keywords: ["C2403"] -ms.assetid: add1f0ba-96b6-4df3-b53f-de1433d80c0c --- # Compiler Error C2403 -'identifier' : register must be base/index in 'context' +> 'identifier' : register must be base/index in 'context' + +## Remarks The register used in an indirect memory operand must be a base or index register in this context. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2404.md b/docs/error-messages/compiler-errors-1/compiler-error-c2404.md index 220f381937d..3bb8a4dfb3a 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2404.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2404.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Compiler Error C2404" title: "Compiler Error C2404" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2404" +ms.date: 11/04/2016 f1_keywords: ["C2404"] helpviewer_keywords: ["C2404"] -ms.assetid: 51794d2f-404b-4d89-b3ea-fc5faa9c197d --- # Compiler Error C2404 -'identifier' : illegal register in 'context' +> 'identifier' : illegal register in 'context' + +## Remarks This register is invalid in this context. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2405.md b/docs/error-messages/compiler-errors-1/compiler-error-c2405.md index f0e40a3d19c..e8fe1a73261 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2405.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2405.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Compiler Error C2405" title: "Compiler Error C2405" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2405" +ms.date: 11/04/2016 f1_keywords: ["C2405"] helpviewer_keywords: ["C2405"] -ms.assetid: 14f6726d-e04b-4cce-8a85-4553fc38fcf7 --- # Compiler Error C2405 -illegal short forward reference with offset +> illegal short forward reference with offset + +## Remarks Short forward references must refer to a label only. An additional offset cannot be used. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2406.md b/docs/error-messages/compiler-errors-1/compiler-error-c2406.md index 6c58cf2252d..4b0c6c99dfa 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2406.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2406.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Compiler Error C2406" title: "Compiler Error C2406" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2406" +ms.date: 11/04/2016 f1_keywords: ["C2406"] helpviewer_keywords: ["C2406"] -ms.assetid: 9d3fbc4c-40bb-42c7-bfd7-7656c40e2065 --- # Compiler Error C2406 -'identifier' : name undefined in 'context' +> 'identifier' : name undefined in 'context' + +## Remarks An undefined identifier is used with the `SIZE`, `LENGTH`, or member-selection (.) operator. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2407.md b/docs/error-messages/compiler-errors-1/compiler-error-c2407.md index d6e33a822d3..f554591dff2 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2407.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2407.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Compiler Error C2407" title: "Compiler Error C2407" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2407" +ms.date: 11/04/2016 f1_keywords: ["C2407"] helpviewer_keywords: ["C2407"] -ms.assetid: faf38041-cf0f-4624-b6f8-30ce0e1efc1e --- # Compiler Error C2407 -illegal 'float' register in 'context' +> illegal 'float' register in 'context' + +## Remarks An `NDP` register was specified in an invalid context. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2408.md b/docs/error-messages/compiler-errors-1/compiler-error-c2408.md index 0206666f921..d7f4e75d63f 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2408.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2408.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Compiler Error C2408" title: "Compiler Error C2408" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2408" +ms.date: 11/04/2016 f1_keywords: ["C2408"] helpviewer_keywords: ["C2408"] -ms.assetid: 3dc4881a-3c33-4c4e-b18e-a1f0e21ea931 --- # Compiler Error C2408 -illegal type on PTR operator in 'context' +> illegal type on PTR operator in 'context' + +## Remarks The first parameter of the `PTR` operator is not a legal type specification. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2409.md b/docs/error-messages/compiler-errors-1/compiler-error-c2409.md index 0cbc1b90364..f067880298e 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2409.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2409.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Compiler Error C2409" title: "Compiler Error C2409" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2409" +ms.date: 11/04/2016 f1_keywords: ["C2409"] helpviewer_keywords: ["C2409"] -ms.assetid: 5d4aa952-0752-4412-b5c2-050dde0636f4 --- # Compiler Error C2409 -illegal type used as operator in 'context' +> illegal type used as operator in 'context' + +## Remarks The type is not legal as an operator in this context. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2410.md b/docs/error-messages/compiler-errors-1/compiler-error-c2410.md index 0e1729028bb..497da598ce8 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2410.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2410.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Error C2410" title: "Compiler Error C2410" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2410" +ms.date: 11/04/2016 f1_keywords: ["C2410"] helpviewer_keywords: ["C2410"] -ms.assetid: b69b2de1-56f3-4ebc-8913-04ac57ffe8a1 --- # Compiler Error C2410 -'identifier' : ambiguous member name in 'context' +> 'identifier' : ambiguous member name in 'context' + +## Remarks The identifier is a member of more than one structure or union in this context. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2411.md b/docs/error-messages/compiler-errors-1/compiler-error-c2411.md index f2683b3a880..ddeca9c353c 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2411.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2411.md @@ -1,14 +1,13 @@ --- -description: "Learn more about: Compiler Error C2411" title: "Compiler Error C2411" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2411" +ms.date: 11/04/2016 f1_keywords: ["C2411"] helpviewer_keywords: ["C2411"] -ms.assetid: 453317d3-0629-4b42-b8ea-3a0b39698ca5 --- # Compiler Error C2411 -'identifier' : illegal struct/union member in 'context' +> 'identifier' : illegal struct/union member in 'context' ### To fix by checking the following possible causes diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2412.md b/docs/error-messages/compiler-errors-1/compiler-error-c2412.md index 7f80cf5952c..6b82d8b7cb2 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2412.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2412.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Compiler Error C2412" title: "Compiler Error C2412" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2412" +ms.date: 11/04/2016 f1_keywords: ["C2412"] helpviewer_keywords: ["C2412"] -ms.assetid: d1842b89-da09-4c35-89a1-84dc844a9f3e --- # Compiler Error C2412 -'label' : case-insensitive label redefined +> 'label' : case-insensitive label redefined + +## Remarks The label is defined more than once in the current function. Change the spelling of the label and its references. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2413.md b/docs/error-messages/compiler-errors-1/compiler-error-c2413.md index d48df5df859..8bda57669c2 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2413.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2413.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Compiler Error C2413" title: "Compiler Error C2413" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2413" +ms.date: 11/04/2016 f1_keywords: ["C2413"] helpviewer_keywords: ["C2413"] -ms.assetid: d0403952-f41e-4b21-840d-ab4e44171838 --- # Compiler Error C2413 -'token' : illegal align size +> 'token' : illegal align size + +## Remarks The size used with the `ALIGN` directive is missing or outside the valid range. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2414.md b/docs/error-messages/compiler-errors-1/compiler-error-c2414.md index 1a4d8639a07..d504db15d26 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2414.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2414.md @@ -1,14 +1,13 @@ --- -description: "Learn more about: Compiler Error C2414" title: "Compiler Error C2414" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2414" +ms.date: 11/04/2016 f1_keywords: ["C2414"] helpviewer_keywords: ["C2414"] -ms.assetid: bbe94e03-862e-4990-b15e-544ae464727d --- # Compiler Error C2414 -illegal number of operands +> illegal number of operands ### To fix by checking the following possible causes diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2415.md b/docs/error-messages/compiler-errors-1/compiler-error-c2415.md index 73486e37299..d393c9ad04e 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2415.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2415.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Error C2415" title: "Compiler Error C2415" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2415" +ms.date: 11/04/2016 f1_keywords: ["C2415"] helpviewer_keywords: ["C2415"] -ms.assetid: f225c913-2bea-46b1-b096-3d358ac94a15 --- # Compiler Error C2415 -improper operand type +> improper operand type + +## Remarks The opcode does not use operands of this type. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2417.md b/docs/error-messages/compiler-errors-1/compiler-error-c2417.md index ad1ec1ba737..2627c37262a 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2417.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2417.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Compiler Error C2417" title: "Compiler Error C2417" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2417" +ms.date: 11/04/2016 f1_keywords: ["C2417"] helpviewer_keywords: ["C2417"] -ms.assetid: 8f42d7a8-5289-4f56-8404-23e5243274d2 --- # Compiler Error C2417 -divide by zero in 'context' +> divide by zero in 'context' + +## Remarks The parameter to the right of the division operator is zero in this context. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2418.md b/docs/error-messages/compiler-errors-1/compiler-error-c2418.md index fd9efc9dec5..0134d570d69 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2418.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2418.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Error C2418" title: "Compiler Error C2418" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2418" +ms.date: 11/04/2016 f1_keywords: ["C2418"] helpviewer_keywords: ["C2418"] -ms.assetid: 00e4690f-04a0-4159-b358-b1e0664102c1 --- # Compiler Error C2418 -cannot delete browser file: filename +> cannot delete browser file: filename + +## Remarks The compiler could not delete the browser file. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2419.md b/docs/error-messages/compiler-errors-1/compiler-error-c2419.md index 1785a274a9a..5b39fcc3e27 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2419.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2419.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Compiler Error C2419" title: "Compiler Error C2419" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2419" +ms.date: 11/04/2016 f1_keywords: ["C2419"] helpviewer_keywords: ["C2419"] -ms.assetid: 51fe3195-34b6-445e-9f01-1e93e8714295 --- # Compiler Error C2419 -mod by zero in 'context' +> mod by zero in 'context' + +## Remarks The parameter to the right of the `MOD` operator is zero in this context. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2420.md b/docs/error-messages/compiler-errors-1/compiler-error-c2420.md index 9f3d63e7ea4..cfe19fb2e68 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2420.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2420.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Compiler Error C2420" title: "Compiler Error C2420" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2420" +ms.date: 11/04/2016 f1_keywords: ["C2420"] helpviewer_keywords: ["C2420"] -ms.assetid: cc11faab-a022-4702-ac8b-9864b916cfa2 --- # Compiler Error C2420 -'identifier' : illegal symbol in context +> 'identifier' : illegal symbol in context + +## Remarks The identifier is invalid in this context. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2421.md b/docs/error-messages/compiler-errors-1/compiler-error-c2421.md index 7df9ea0208f..e55242b045f 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2421.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2421.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Compiler Error C2421" title: "Compiler Error C2421" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2421" +ms.date: 11/04/2016 f1_keywords: ["C2421"] helpviewer_keywords: ["C2421"] -ms.assetid: 0a9afb9f-60d8-4df7-b2ae-5c36e86df891 --- # Compiler Error C2421 -PTR operator used with register in 'context' +> PTR operator used with register in 'context' + +## Remarks The `PTR` operator cannot be used with a **`register`** operand. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2422.md b/docs/error-messages/compiler-errors-1/compiler-error-c2422.md index 3f23f41613c..5bec6948265 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2422.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2422.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Error C2422" title: "Compiler Error C2422" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2422" +ms.date: 11/04/2016 f1_keywords: ["C2422"] helpviewer_keywords: ["C2422"] -ms.assetid: ef0ec302-4028-4778-b134-0b8cea4bcad9 --- # Compiler Error C2422 -illegal segment override in 'operand' +> illegal segment override in 'operand' + +## Remarks Inline assembly code incorrectly uses a segment override operator (colon) on an operand. Possible causes include: @@ -20,7 +21,9 @@ Inline assembly code incorrectly uses a segment override operator (colon) on an - The expression following the segment override operator is not an immediate operand or a memory operand. -The following sample generates C2422: +## Example + +The following example generates C2422: ```cpp // C2422.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2423.md b/docs/error-messages/compiler-errors-1/compiler-error-c2423.md index 24f2acbd023..903fb38c3e5 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2423.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2423.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2423" title: "Compiler Error C2423" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2423" +ms.date: 11/04/2016 f1_keywords: ["C2423"] helpviewer_keywords: ["C2423"] -ms.assetid: 8797fb8b-b58b-4add-b6e6-2a9a3cd9084d --- # Compiler Error C2423 -'number' : illegal scale +> 'number' : illegal scale + +## Remarks Inline assembly code uses a number other than 1, 2, 4, or 8 to scale a register. -The following sample generates C2423: +## Example + +The following example generates C2423: ```cpp // C2423.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2424.md b/docs/error-messages/compiler-errors-1/compiler-error-c2424.md index 3e87ba06f89..8828b961d38 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2424.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2424.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Compiler Error C2424" title: "Compiler Error C2424" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2424" +ms.date: 11/04/2016 f1_keywords: ["C2424"] helpviewer_keywords: ["C2424"] -ms.assetid: 03613746-a324-4b8b-94c0-424e8b0aae94 --- # Compiler Error C2424 -'token' : improper expression in 'context' +> 'token' : improper expression in 'context' + +## Remarks The token forms part of an incorrect expression in this context. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2425.md b/docs/error-messages/compiler-errors-1/compiler-error-c2425.md index a87f7c098d7..27430083843 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2425.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2425.md @@ -1,20 +1,23 @@ --- -description: "Learn more about: Compiler Error C2425" title: "Compiler Error C2425" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2425" +ms.date: 11/04/2016 f1_keywords: ["C2425"] helpviewer_keywords: ["C2425"] -ms.assetid: 0ce59404-9aff-4e01-aa8d-27d23e92eb30 --- # Compiler Error C2425 -'token' :non-constant expression in 'context' +> 'token' :non-constant expression in 'context' + +## Remarks The token forms part of a non-constant expression in this context. To fix this issue, replace the token with a constant literal or with a calculation. -The following sample generates C2425: +## Example + +The following example generates C2425: ```cpp // C2425.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2426.md b/docs/error-messages/compiler-errors-1/compiler-error-c2426.md index fd4668b17ba..8f4bc8c7f20 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2426.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2426.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Compiler Error C2426" title: "Compiler Error C2426" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2426" +ms.date: 11/04/2016 f1_keywords: ["C2426"] helpviewer_keywords: ["C2426"] -ms.assetid: 3428aeed-3f78-4675-9bc4-5b72f50eaaf6 --- # Compiler Error C2426 -'token' : illegal operator in 'context' +> 'token' : illegal operator in 'context' + +## Remarks The token cannot be used as an operator in this context. Index operators, for example, cannot be nested. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2427.md b/docs/error-messages/compiler-errors-1/compiler-error-c2427.md index 8d570e65b0a..bd48ac4560f 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2427.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2427.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2427" title: "Compiler Error C2427" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2427" +ms.date: 11/04/2016 f1_keywords: ["C2427"] helpviewer_keywords: ["C2427"] -ms.assetid: a7d421af-6180-40b4-b7a6-9f3bc7dfaaf9 --- # Compiler Error C2427 -'class' : cannot define class in this scope +> 'class' : cannot define class in this scope + +## Remarks An attempt was made to define a nested class, but the nested class is a member of a base class, not the most containing class. -The following sample generates C2427: +## Example + +The following example generates C2427: ```cpp // C2427.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2428.md b/docs/error-messages/compiler-errors-1/compiler-error-c2428.md index d58660dd89f..285e59c87ec 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2428.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2428.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2428" title: "Compiler Error C2428" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2428" +ms.date: 11/04/2016 f1_keywords: ["C2428"] helpviewer_keywords: ["C2428"] -ms.assetid: 74aa5714-e930-4f9e-9061-68ccce7f0d38 --- # Compiler Error C2428 -'operation' : not allowed on operand of type 'bool' +> 'operation' : not allowed on operand of type 'bool' + +## Remarks You cannot apply a decrement operator to objects of type **`bool`**. -The following sample generates C2428: +## Example + +The following example generates C2428: ```cpp // C2428.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2429.md b/docs/error-messages/compiler-errors-1/compiler-error-c2429.md index 6b465a254d7..5e90b4c64ca 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2429.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2429.md @@ -1,17 +1,20 @@ --- -description: "Learn more about: Compiler Error C2429" title: "Compiler Error C2429" -ms.date: "11/16/2017" +description: "Learn more about: Compiler Error C2429" +ms.date: 11/16/2017 f1_keywords: ["C2429"] helpviewer_keywords: ["C2429"] -ms.assetid: 57ff6df9-5cf1-49f3-8bd8-4e550dfd65a0 --- # Compiler Error C2429 > '*language feature*' requires compiler flag '*compiler option*' +## Remarks + The language feature requires a specific compiler option for support. +## Example + The error **C2429: language feature 'nested-namespace-definition' requires compiler flag '/std:c++17'** is generated if you try to define a *compound namespace*, a namespace that contains one or more scope-nested namespace names, starting in Visual Studio 2015 Update 5. (In Visual Studio 2017 version 15.3, the **`/std:c++latest`** switch is required.) Compound namespace definitions are not allowed in C++ prior to C++17. The compiler supports compound namespace definitions when the [`/std:c++17`](../../build/reference/std-specify-language-standard-version.md) compiler option is specified: ```cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2430.md b/docs/error-messages/compiler-errors-1/compiler-error-c2430.md index 93fb29b3ba4..931d37287a6 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2430.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2430.md @@ -1,20 +1,21 @@ --- -description: "Learn more about: Compiler Error C2430" title: "Compiler Error C2430" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2430" +ms.date: 11/04/2016 f1_keywords: ["C2430"] helpviewer_keywords: ["C2430"] -ms.assetid: 07c20f76-63e1-4d22-b2a9-98b0d45c5cac --- # Compiler Error C2430 -more than one index register in 'identifier' +> more than one index register in 'identifier' + +## Remarks More than one register is scaled. The compiler supports scaled indexing, but you can only scale one register. ## Example -The following sample generates C2430. +The following example generates C2430. ```cpp // C2430.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2431.md b/docs/error-messages/compiler-errors-1/compiler-error-c2431.md index bf087591be9..923f9f17e1c 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2431.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2431.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2431" title: "Compiler Error C2431" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2431" +ms.date: 11/04/2016 f1_keywords: ["C2431"] helpviewer_keywords: ["C2431"] -ms.assetid: 88a5b648-c89f-47d1-a20e-63231ab4f0f7 --- # Compiler Error C2431 -illegal index register in 'identifier' +> illegal index register in 'identifier' + +## Remarks The ESP register is scaled or used as both index and base register. The SIB encoding for the x86 processor does not allow either. -The following sample generates C2431: +## Example + +The following example generates C2431: ```cpp // C2431.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2432.md b/docs/error-messages/compiler-errors-1/compiler-error-c2432.md index 03d4ba54d10..ef91964904e 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2432.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2432.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2432" title: "Compiler Error C2432" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2432" +ms.date: 11/04/2016 f1_keywords: ["C2432"] helpviewer_keywords: ["C2432"] -ms.assetid: 0e3326e8-cab1-45a5-b48d-61edd33793e8 --- # Compiler Error C2432 -illegal reference to 16-bit data in 'identifier' +> illegal reference to 16-bit data in 'identifier' + +## Remarks A 16-bit register is used as an index or base register. The compiler does not support referencing 16-bit data. 16-bit registers cannot be used as index or base registers when compiling for 32-bit code. -The following sample generates C2432: +## Example + +The following example generates C2432: ```cpp // C2432.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2433.md b/docs/error-messages/compiler-errors-1/compiler-error-c2433.md index 614e07b1be1..64fa90a70b1 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2433.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2433.md @@ -1,26 +1,26 @@ --- -description: "Learn more about: Compiler Error C2433" title: "Compiler Error C2433" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2433" +ms.date: 05/25/2025 f1_keywords: ["C2433"] helpviewer_keywords: ["C2433"] -ms.assetid: 7079fedd-6059-4125-82ef-ebe275f1f9d1 --- # Compiler Error C2433 -'identifier' : 'modifier' not permitted on data declarations +> '*identifier*': '*modifier*' not permitted on data declarations + +## Remarks The **`friend`**, **`virtual`**, and **`inline`** modifiers cannot be used for data declarations. ## Example -The following sample generates C2433. +The following example generates C2433: ```cpp // C2433.cpp -class C{}; - -int main() { - inline C c; // C2433 +int main() +{ + virtual int i; // C2433 } ``` diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2434.md b/docs/error-messages/compiler-errors-1/compiler-error-c2434.md index 7a9cba1f7d9..f48832f1467 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2434.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2434.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2434" title: "Compiler Error C2434" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2434" +ms.date: 11/04/2016 f1_keywords: ["C2434"] helpviewer_keywords: ["C2434"] -ms.assetid: 01329e26-7c74-4219-b74f-69e3a40c9738 --- # Compiler Error C2434 @@ -18,7 +17,7 @@ It is not possible to dynamically initialize a per-process variable under **/clr ## Example -The following sample generates C2434. To fix this issue, use constants to initialize `process` variables. +The following example generates C2434. To fix this issue, use constants to initialize `process` variables. ```cpp // C2434.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2435.md b/docs/error-messages/compiler-errors-1/compiler-error-c2435.md index 90b82057ad1..6522c4a0255 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2435.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2435.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2435" title: "Compiler Error C2435" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2435" +ms.date: 11/04/2016 f1_keywords: ["C2435"] helpviewer_keywords: ["C2435"] -ms.assetid: be6aa8f8-579b-42ea-bdd8-2d01393646ad --- # Compiler Error C2435 @@ -20,7 +19,7 @@ For more information, see [appdomain](../../cpp/appdomain.md) and [process](../. ## Example -The following sample generates C2435: +The following example generates C2435: ```cpp // C2435.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2436.md b/docs/error-messages/compiler-errors-1/compiler-error-c2436.md index 2c21782820b..8b1879a76d8 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2436.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2436.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2436" title: "Compiler Error C2436" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2436" +ms.date: 11/04/2016 f1_keywords: ["C2436"] helpviewer_keywords: ["C2436"] -ms.assetid: ca4cc813-bc1d-4c0a-9a2c-3a5fe673d084 --- # Compiler Error C2436 -'identifier' : member function or nested class in constructor initializer list +> 'identifier' : member function or nested class in constructor initializer list + +## Remarks Member functions or local classes in the constructor initializer list cannot be initialized. -The following sample generates C2436: +## Example + +The following example generates C2436: ```cpp // C2436.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2437.md b/docs/error-messages/compiler-errors-1/compiler-error-c2437.md index ad2838f1954..07b62af2655 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2437.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2437.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2437" title: "Compiler Error C2437" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2437" +ms.date: 11/04/2016 f1_keywords: ["C2437"] helpviewer_keywords: ["C2437"] -ms.assetid: 2d2b3c6c-856a-4b27-ae10-64813b3e5483 --- # Compiler Error C2437 -'identifier' : already initialized +> 'identifier' : already initialized + +## Remarks An object can be initialized only once. -The following sample generates C2437: +## Example + +The following example generates C2437: ```cpp // C2437.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2438.md b/docs/error-messages/compiler-errors-1/compiler-error-c2438.md index 5c50bbcf063..2a0e207e1df 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2438.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2438.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2438" title: "Compiler Error C2438" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2438" +ms.date: 11/04/2016 f1_keywords: ["C2438"] helpviewer_keywords: ["C2438"] -ms.assetid: 3a0ab3ba-d0e4-4d8f-971d-e503397cc827 --- # Compiler Error C2438 -'identifier' : cannot initialize static class data via constructor +> 'identifier' : cannot initialize static class data via constructor + +## Remarks A constructor is used to initialize a static member of a class. Static members must be initialized in a definition outside the class declaration. -The following sample generates C2438: +## Example + +The following example generates C2438: ```cpp // C2438.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2439.md b/docs/error-messages/compiler-errors-1/compiler-error-c2439.md index 3afca77e01e..37a5523bea6 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2439.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2439.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Error C2439" title: "Compiler Error C2439" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2439" +ms.date: 11/04/2016 f1_keywords: ["C2439"] helpviewer_keywords: ["C2439"] -ms.assetid: 3c5dbe5c-b7d3-4bb0-8619-92f6e280461e --- # Compiler Error C2439 -'identifier' : member could not be initialized +> 'identifier' : member could not be initialized + +## Remarks A class, structure, or union member cannot be initialized. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2440.md b/docs/error-messages/compiler-errors-1/compiler-error-c2440.md index 218b5f7a3d3..b1416ad8096 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2440.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2440.md @@ -1,28 +1,27 @@ --- -description: "Learn about type conversion errors that cause Compiler Error C2440." title: "Compiler Error C2440" +description: "Learn about type conversion errors that cause Compiler Error C2440." ms.date: 08/27/2021 f1_keywords: ["C2440"] helpviewer_keywords: ["C2440"] no-loc: ["struct", "const"] -ms.assetid: 36e6676c-f04f-4715-8ba1-f096c4bf3b44 --- # Compiler Error C2440 > '*initializing*' : cannot convert from '*type1*' to '*type2*'\ > '*conversion*' : cannot convert from '*type1*' to '*type2*' -The compiler can't implicitly convert from `*type1*` to `*type2*`, or can't use the specified cast or conversion operator. - ## Remarks +The compiler can't implicitly convert from *`type1`* to *`type2`*, or can't use the specified cast or conversion operator. + The compiler generates C2440 when it can't convert from one type to another, either implicitly or by using the specified cast or conversion operator. There are many ways to generate this error. We've listed some common ones in the Examples section. ## Examples ### C++ string literals are `const` -C2440 can be caused if you attempt to initialize a non-const `char*` (or `wchar_t*`) by using a string literal in C++ code, when the compiler conformance option [`/Zc:strictStrings`](../../build/reference/zc-strictstrings-disable-string-literal-type-conversion.md) is set. In C, the type of a string literal is array of **`char`**, but in C++, it's array of `const char`. This sample generates C2440: +C2440 can be caused if you attempt to initialize a non-const `char*` (or `wchar_t*`) by using a string literal in C++ code, when the compiler conformance option [`/Zc:strictStrings`](../../build/reference/zc-strictstrings-disable-string-literal-type-conversion.md) is set. In C, the type of a string literal is array of **`char`**, but in C++, it's array of `const char`. This example generates C2440: ```cpp // C2440s.cpp @@ -41,7 +40,7 @@ int main() { ### C++20 `u8` literals are `const char8_t` -In C++20 or under [`/Zc:char8_t`](../../build/reference/zc-char8-t.md), a UTF-8 literal character or string (such as `u8'a'` or `u8"String"`) is of type `const char8_t` or `const char8_t[N]`, respectively. This sample shows how compiler behavior changes between C++17 and C++20: +In C++20 or under [`/Zc:char8_t`](../../build/reference/zc-char8-t.md), a UTF-8 literal character or string (such as `u8'a'` or `u8"String"`) is of type `const char8_t` or `const char8_t[N]`, respectively. This example shows how compiler behavior changes between C++17 and C++20: ```cpp // C2440u8.cpp @@ -61,7 +60,7 @@ int main() { ### Pointer to member -You may see C2440 if you attempt to convert a pointer to member to `void*`. The next sample generates C2440: +You may see C2440 if you attempt to convert a pointer to member to `void*`. The next example generates C2440: ```cpp // C2440.cpp @@ -84,7 +83,7 @@ public: ### Cast of undefined type -The compiler emits C2440 if you attempt to cast from a type that's only forward declared but not defined. This sample generates C2440: +The compiler emits C2440 if you attempt to cast from a type that's only forward declared but not defined. This example generates C2440: ```cpp // c2440a.cpp @@ -99,7 +98,7 @@ Base * func(Derived * d) { ### Incompatible calling convention -The C2440 errors on lines 15 and 16 of the next sample are qualified with the `Incompatible calling conventions for UDT return value` message. A *UDT* is a user-defined type, such as a class, struct, or union. These kinds of incompatibility errors are caused when the calling convention of a UDT specified in the return type of a forward declaration conflicts with the actual calling convention of the UDT and when a function pointer is involved. +The C2440 errors on lines 15 and 16 of the next example are qualified with the `Incompatible calling conventions for UDT return value` message. A *UDT* is a user-defined type, such as a class, struct, or union. These kinds of incompatibility errors are caused when the calling convention of a UDT specified in the return type of a forward declaration conflicts with the actual calling convention of the UDT and when a function pointer is involved. In the example, first there are forward declarations for a struct and for a function that returns the struct. The compiler assumes that the struct uses the C++ calling convention. Next is the struct definition, which uses the C calling convention by default. Because the compiler doesn't know the calling convention of the struct until it finishes reading the entire struct, the calling convention for the struct in the return type of `get_c2` is also assumed to be C++. @@ -164,7 +163,7 @@ int main() { ### User-defined conversions -C2440 can also occur for an incorrect use of a user-defined conversion. For example, when a conversion operator has been defined as **`explicit`**, the compiler can't use it in an implicit conversion. For more information about user-defined conversions, see [User-Defined Conversions (C++/CLI)](../../dotnet/user-defined-conversions-cpp-cli.md)). This sample generates C2440: +C2440 can also occur for an incorrect use of a user-defined conversion. For example, when a conversion operator has been defined as **`explicit`**, the compiler can't use it in an implicit conversion. For more information about user-defined conversions, see [User-Defined Conversions (C++/CLI)](../../dotnet/user-defined-conversions-cpp-cli.md)). This example generates C2440: ```cpp // C2440d.cpp @@ -188,7 +187,7 @@ int main() { ### `System::Array` creation -C2440 can also occur if you try to create an instance of an array in C++/CLI whose type is a . For more information, see [Arrays](../../extensions/arrays-cpp-component-extensions.md). The next sample generates C2440: +C2440 can also occur if you try to create an instance of an array in C++/CLI whose type is a . For more information, see [Arrays](../../extensions/arrays-cpp-component-extensions.md). The next example generates C2440: ```cpp // C2440e.cpp @@ -203,7 +202,7 @@ int main() { ### Attributes -C2440 can also occur because of changes in the attributes feature. The following sample generates C2440. +C2440 can also occur because of changes in the attributes feature. The following example generates C2440. ```cpp // c2440f.cpp @@ -219,7 +218,7 @@ The Microsoft C++ compiler no longer allows the [`const_cast` operator](../../cp To resolve this C2440, use the correct cast operator. For more information, see [Casting operators](../../cpp/casting-operators.md). -This sample generates C2440: +This example generates C2440: ```cpp // c2440g.cpp @@ -238,7 +237,7 @@ int main() { C2440 can occur because of conformance changes to the compiler in Visual Studio 2015 Update 3. Previously, the compiler incorrectly treated certain distinct expressions as the same type when identifying a template match for a **`static_cast`** operation. Now the compiler distinguishes the types correctly, and code that relied on the previous **`static_cast`** behavior is broken. To fix this issue, change the template argument to match the template parameter type, or use a **`reinterpret_cast`** or C-style cast. -This sample generates C2440: +This example generates C2440: ```cpp // c2440h.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2441.md b/docs/error-messages/compiler-errors-1/compiler-error-c2441.md index 6ec4ce06501..e82e9e4cb04 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2441.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2441.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2441" title: "Compiler Error C2441" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2441" +ms.date: 11/04/2016 f1_keywords: ["C2441"] helpviewer_keywords: ["C2441"] -ms.assetid: ffbd6573-777a-48dd-892f-5cf4a758dcab --- # Compiler Error C2441 @@ -22,7 +21,7 @@ For more information, see [process](../../cpp/process.md) and [/clr (Common Lang ## Example -The following sample generates C2441. +The following example generates C2441. ```cpp // C2441.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2443.md b/docs/error-messages/compiler-errors-1/compiler-error-c2443.md index 15026511214..2246220c488 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2443.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2443.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2443" title: "Compiler Error C2443" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2443" +ms.date: 11/04/2016 f1_keywords: ["C2443"] helpviewer_keywords: ["C2443"] -ms.assetid: 315330d5-24bc-4193-a531-0642095be58f --- # Compiler Error C2443 -operand size conflict +> operand size conflict + +## Remarks The instruction requires operands to be the same size. -The following sample generates C2443: +## Example + +The following example generates C2443: ```cpp // C2443.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2444.md b/docs/error-messages/compiler-errors-1/compiler-error-c2444.md index 94cb7948fa9..8fbffad64a9 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2444.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2444.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Error C2444" title: "Compiler Error C2444" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2444" +ms.date: 11/04/2016 f1_keywords: ["C2444"] helpviewer_keywords: ["C2444"] -ms.assetid: 6339ed82-caad-45d3-a8ff-6c746589fd03 --- # Compiler Error C2444 -'identifier' : used ANSI prototype, found 'type', expected '{' or ';' +> 'identifier' : used ANSI prototype, found 'type', expected '{' or ';' + +## Remarks The function prototype is followed by a type. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2446.md b/docs/error-messages/compiler-errors-1/compiler-error-c2446.md index de76e6c65ac..0f1951562ed 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2446.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2446.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Compiler Error C2446" title: "Compiler Error C2446" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2446" +ms.date: 11/04/2016 f1_keywords: ["C2446"] helpviewer_keywords: ["C2446"] -ms.assetid: 4f70dd11-6baf-4b92-9a08-f88f65ffa199 --- # Compiler Error C2446 -'operator' : no conversion from 'type1' to 'type2' +> 'operator' : no conversion from 'type1' to 'type2' + +## Remarks The compiler cannot convert `type1` to `type2`. The conversion may not make sense because it violates C/C++ semantics. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2447.md b/docs/error-messages/compiler-errors-1/compiler-error-c2447.md index e88e1565f63..7191d5ad851 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2447.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2447.md @@ -1,20 +1,23 @@ --- -description: "Learn more about: Compiler Error C2447" title: "Compiler Error C2447" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2447" +ms.date: 11/04/2016 f1_keywords: ["C2447"] helpviewer_keywords: ["C2447"] -ms.assetid: d1bd6e9a-ee42-4510-ae5e-6b0378f7b931 --- # Compiler Error C2447 -'{' : missing function header (old-style formal list?) +> '{' : missing function header (old-style formal list?) + +## Remarks The compiler encountered an unexpected open brace at global scope. In most cases, this is caused by a badly-formed function header, a misplaced declaration, or a stray semi-colon. To resolve this issue, verify that the open brace follows a correctly-formed function header, and is not preceded by a declaration or a stray semi-colon. This error can also be caused by an old-style C-language formal argument list. To resolve this issue, refactor the argument list to use modern style—that is, enclosed in parentheses. -The following sample generates C2447: +## Example + +The following example generates C2447: ```cpp // C2447.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2448.md b/docs/error-messages/compiler-errors-1/compiler-error-c2448.md index 49c7aeafb64..05ae565e92e 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2448.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2448.md @@ -1,20 +1,23 @@ --- -description: "Learn more about: Compiler Error C2448" title: "Compiler Error C2448" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2448" +ms.date: 11/04/2016 f1_keywords: ["C2448"] helpviewer_keywords: ["C2448"] -ms.assetid: e255df3c-f861-4b4d-a193-8768cef061a5 --- # Compiler Error C2448 -'identifier' : function-style initializer appears to be a function definition +> 'identifier' : function-style initializer appears to be a function definition + +## Remarks The function definition is incorrect. This error can be caused by an old-style C-language formal list. -The following sample generates C2448: +## Example + +The following example generates C2448: ```cpp // C2448.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2449.md b/docs/error-messages/compiler-errors-1/compiler-error-c2449.md index 938093971e8..b99392c66d8 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2449.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2449.md @@ -1,20 +1,23 @@ --- -description: "Learn more about: Compiler Error C2449" title: "Compiler Error C2449" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2449" +ms.date: 11/04/2016 f1_keywords: ["C2449"] helpviewer_keywords: ["C2449"] -ms.assetid: 544bf0b6-daa0-40e8-9f21-8e583d472a2d --- # Compiler Error C2449 -found '{' at file scope (missing function header?) +> found '{' at file scope (missing function header?) + +## Remarks An open brace occurs at file scope. This error can be caused by a semicolon between a function header and the opening brace of the function definition. -The following sample generates C2499: +## Example + +The following example generates C2449: ```c // C2449.c diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2450.md b/docs/error-messages/compiler-errors-1/compiler-error-c2450.md index ac6c260ef86..61dc7caa663 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2450.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2450.md @@ -1,17 +1,21 @@ --- -description: "Learn more about: Compiler Error C2450" title: "Compiler Error C2450" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2450" +ms.date: 11/04/2016 f1_keywords: ["C2450"] helpviewer_keywords: ["C2450"] --- # Compiler Error C2450 -switch expression of type 'type' is illegal +> switch expression of type 'type' is illegal + +## Remarks The **`switch`** expression evaluates to an invalid type. It must evaluate to an integer type or a class type with unambiguous conversion to an integer type. If it evaluates to a user-defined type, you must supply a conversion operator. -The following sample generates C2450: +## Example + +The following example generates C2450: ```cpp // C2450.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2451.md b/docs/error-messages/compiler-errors-1/compiler-error-c2451.md index cc99c291bb0..0d266179dbd 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2451.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2451.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2451" title: "Compiler Error C2451" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2451" +ms.date: 11/04/2016 f1_keywords: ["C2451"] helpviewer_keywords: ["C2451"] -ms.assetid: a64c93a5-ab8d-4d39-ae57-9ee7ef803036 --- # Compiler Error C2451 -conditional expression of type 'type' is illegal +> conditional expression of type 'type' is illegal + +## Remarks The conditional expression evaluates to an integer type. -The following sample generates C2451: +## Example + +The following example generates C2451: ```cpp // C2451.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2452.md b/docs/error-messages/compiler-errors-1/compiler-error-c2452.md index f16f583de17..fabb98fbc3e 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2452.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2452.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2452" title: "Compiler Error C2452" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2452" +ms.date: 11/04/2016 f1_keywords: ["C2452"] helpviewer_keywords: ["C2452"] -ms.assetid: a4ec7642-6660-4c7a-9866-853d1cc67daf --- # Compiler Error C2452 -'type' : invalid source type for safe_cast +> 'type' : invalid source type for safe_cast + +## Remarks The source type for [safe_cast](../../extensions/safe-cast-cpp-component-extensions.md) was not valid. For example, all types in a `safe_cast` operation must be CLR types. -The following sample generates C2452: +## Example + +The following example generates C2452: ```cpp // C2452.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2457.md b/docs/error-messages/compiler-errors-1/compiler-error-c2457.md index a60da33b7bb..55e9609401a 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2457.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2457.md @@ -1,20 +1,21 @@ --- -description: "Learn more about: Compiler Error C2457" title: "Compiler Error C2457" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2457" +ms.date: 11/04/2016 f1_keywords: ["C2457"] helpviewer_keywords: ["C2457"] -ms.assetid: 347e169d-23ad-434f-8836-5b09b53980ff --- # Compiler Error C2457 > '*macro*': predefined macro cannot appear outside of a function body +## Remarks + You attempted to use a predefined macro, such as [`__FUNCTION__`](../../preprocessor/predefined-macros.md), in a global space. ## Example -The following sample generates C2457 and also shows correct usage: +The following example generates C2457 and also shows correct usage: ```cpp // C2457.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2458.md b/docs/error-messages/compiler-errors-1/compiler-error-c2458.md index ec96c8970fb..e87f8b60f8d 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2458.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2458.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2458" title: "Compiler Error C2458" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2458" +ms.date: 11/04/2016 f1_keywords: ["C2458"] helpviewer_keywords: ["C2458"] -ms.assetid: ed21901f-1067-42f5-b275-19b480decf5c --- # Compiler Error C2458 -'identifier' : redefinition within definition +> 'identifier' : redefinition within definition + +## Remarks A class, structure, union, or enumeration is redefined in its own declaration. -The following sample generates C2458: +## Example + +The following example generates C2458: ```cpp // C2458.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2459.md b/docs/error-messages/compiler-errors-1/compiler-error-c2459.md index 635f08cf2e5..135799238c3 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2459.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2459.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2459" title: "Compiler Error C2459" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2459" +ms.date: 11/04/2016 f1_keywords: ["C2459"] helpviewer_keywords: ["C2459"] -ms.assetid: 81e29f4c-5b60-40fb-9557-1cdc630d77e8 --- # Compiler Error C2459 -'identifier' : is being defined; cannot add as an anonymous member +> 'identifier' : is being defined; cannot add as an anonymous member + +## Remarks A class, structure, or union is redefined in its own scope by a member of an anonymous union. -The following sample generates C2459: +## Example + +The following example generates C2459: ```cpp // C2459.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2460.md b/docs/error-messages/compiler-errors-1/compiler-error-c2460.md index e6e7bdd164b..6f13975fc47 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2460.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2460.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2460" title: "Compiler Error C2460" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2460" +ms.date: 11/04/2016 f1_keywords: ["C2460"] helpviewer_keywords: ["C2460"] -ms.assetid: d969fca9-3ac5-4e4e-88fc-df05510e2093 --- # Compiler Error C2460 -'identifier1' : uses 'identifier2', which is being defined +> 'identifier1' : uses 'identifier2', which is being defined + +## Remarks A class or structure (`identifier2`) is declared as a member of itself (`identifier1`). Recursive definitions of classes and structures are not allowed. -The following sample generates C2460: +## Example + +The following example generates C2460: ```cpp // C2460.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2461.md b/docs/error-messages/compiler-errors-1/compiler-error-c2461.md index 4d3aac6503f..7b4d94ac41d 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2461.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2461.md @@ -1,22 +1,23 @@ --- -description: "Learn more about: Compiler Error C2461" title: "Compiler Error C2461" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2461" +ms.date: 11/04/2016 f1_keywords: ["C2461"] helpviewer_keywords: ["C2461"] -ms.assetid: e64ba651-f441-4fdb-b5cb-4209bbbe4db4 --- # Compiler Error C2461 > '*class*' : constructor syntax missing formal parameters +## Remarks + The constructor for the class does not specify any formal parameters. The declaration of a constructor must specify a formal parameter list. The list can be empty. To fix this issue, add a pair of parentheses after the declaration of *class*::**class*. ## Example -The following sample shows how to fix C2461: +The following example shows how to fix C2461: ```cpp // C2461.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2462.md b/docs/error-messages/compiler-errors-1/compiler-error-c2462.md index b374ec31368..baad0121506 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2462.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2462.md @@ -1,22 +1,26 @@ --- -description: "Learn more about: Compiler Error C2462" title: "Compiler Error C2462" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2462" +ms.date: 11/04/2016 f1_keywords: ["C2462"] helpviewer_keywords: ["C2462"] -ms.assetid: a8601bf8-f5ce-41de-9117-e2632bd4996b --- # Compiler Error C2462 -'identifier' : cannot define a type in a 'new-expression' +> 'identifier' : cannot define a type in a 'new-expression' + +## Remarks You cannot define a type in the operand field of the **`new`** operator. Put the type definition in a separate statement. -The following sample generates C2462: +## Example + +The following example generates C2462: ```cpp // C2462.cpp -int main() { +int main() +{ new struct S { int i; }; // C2462 } ``` diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2464.md b/docs/error-messages/compiler-errors-1/compiler-error-c2464.md index 15645af89f1..10a9a5155f1 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2464.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2464.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2464" title: "Compiler Error C2464" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2464" +ms.date: 11/04/2016 f1_keywords: ["C2464"] helpviewer_keywords: ["C2464"] -ms.assetid: ace953d6-b414-49ee-bfef-90578a8da00c --- # Compiler Error C2464 -'identifier' : cannot use 'new' to allocate a reference +> 'identifier' : cannot use 'new' to allocate a reference + +## Remarks A reference identifier was allocated with the **`new`** operator. References are not memory objects, so **`new`** cannot return a pointer to them. Use the standard variable declaration syntax to declare a reference. -The following sample generates C2464: +## Example + +The following example generates C2464: ```cpp // C2464.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2465.md b/docs/error-messages/compiler-errors-1/compiler-error-c2465.md index fc173014703..861458fb9ea 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2465.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2465.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Compiler Error C2465" title: "Compiler Error C2465" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2465" +ms.date: 11/04/2016 f1_keywords: ["C2465"] helpviewer_keywords: ["C2465"] -ms.assetid: 65ba2a9f-d95e-4af3-b60b-1ac59a1e307c --- # Compiler Error C2465 -cannot define an anonymous type inside parentheses +> cannot define an anonymous type inside parentheses + +## Remarks An anonymous structure, union, or enumerated type is defined inside a parenthetical expression. This is invalid in C++ because the definition is meaningless in function scope. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2466.md b/docs/error-messages/compiler-errors-1/compiler-error-c2466.md index ae382ccd5fd..05985b61cba 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2466.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2466.md @@ -1,23 +1,25 @@ --- -description: "Learn more about: Compiler Error C2466" title: "Compiler Error C2466" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2466" +ms.date: 03/19/2025 f1_keywords: ["C2466"] helpviewer_keywords: ["C2466"] -ms.assetid: 75b251d1-7d0b-4a86-afca-26adedf74486 --- # Compiler Error C2466 -cannot allocate an array of constant size 0 +> cannot allocate an array of constant size 0 + +## Remarks An array is allocated or declared with size zero. The constant expression for the array size must be an integer greater than zero. An array declaration with a zero subscript is legal only for a class, structure, or union member and only with Microsoft extensions ([/Ze](../../build/reference/za-ze-disable-language-extensions.md)). -The following sample generates C2466: +## Example + +The following example generates C2466: ```cpp // C2466.cpp // compile with: /c -int i[0]; // C2466 -int j[1]; // OK -char *p; +int arr1[0]; // C2466 +int arr2[1]; // OK ``` diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2467.md b/docs/error-messages/compiler-errors-1/compiler-error-c2467.md index 05d89f1289e..a941568e44a 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2467.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2467.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2467" title: "Compiler Error C2467" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2467" +ms.date: 11/04/2016 f1_keywords: ["C2467"] helpviewer_keywords: ["C2467"] -ms.assetid: f9ead270-5d0b-41cc-bdcd-586a647c67a7 --- # Compiler Error C2467 -illegal declaration of anonymous 'user-defined-type' +> illegal declaration of anonymous 'user-defined-type' + +## Remarks A nested user-defined type was declared. This is an error when compiling C source code with the ANSI compatibility option ([/Za](../../build/reference/za-ze-disable-language-extensions.md)) enabled. -The following sample generates C2467: +## Example + +The following example generates C2467: ```c //C2467.c diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2470.md b/docs/error-messages/compiler-errors-1/compiler-error-c2470.md index 1070a0128b1..228392a8ef2 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2470.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2470.md @@ -1,26 +1,36 @@ --- -description: "Learn more about: Compiler Error C2470" title: "Compiler Error C2470" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2470" +ms.date: 03/29/2025 f1_keywords: ["C2470"] helpviewer_keywords: ["C2470"] -ms.assetid: e17d2cb8-b84c-447c-976a-625f0c96f3fe --- # Compiler Error C2470 -'function' : looks like a function definition, but there is no parameter list; skipping apparent body +> '*function*': looks like a function definition, but there is no parameter list; skipping apparent body + +## Remarks A function definition is missing its argument list. -The following sample generates C2470: +## Example + +The following example generates C2470: ```cpp // C2470.cpp -int MyFunc {}; // C2470 -void MyFunc2() {}; //OK +// compile with: /c +template +class C +{ + int func(); +}; -int main(){ - MyFunc(); - MyFunc2(); +template +int C::func // C2470 +// Use the following line to resolve the error: +// int C::func() +{ + return 0; } ``` diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2471.md b/docs/error-messages/compiler-errors-1/compiler-error-c2471.md index 062241d3ee9..abf9f1606c1 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2471.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2471.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Error C2471" title: "Compiler Error C2471" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2471" +ms.date: 11/04/2016 f1_keywords: ["C2471"] helpviewer_keywords: ["C2471"] -ms.assetid: a8928b44-20f6-4cbc-9aa5-7e86052a9c6b --- # Compiler Error C2471 -cannot update program database 'file' +> cannot update program database 'file' + +## Remarks The compiler cannot write to the database file. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2472.md b/docs/error-messages/compiler-errors-1/compiler-error-c2472.md index 7fce0f698a8..0b322bc60c3 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2472.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2472.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2472" title: "Compiler Error C2472" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2472" +ms.date: 11/04/2016 f1_keywords: ["C2472"] helpviewer_keywords: ["C2472"] -ms.assetid: 3b36bcdc-2ba5-4357-ab88-7545ba0551cd --- # Compiler Error C2472 @@ -18,7 +17,7 @@ The **/clr:pure** and **/clr:safe** compiler options are deprecated in Visual St ## Example -The following sample generates C2472. +The following example generates C2472. ```cpp // C2472.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2473.md b/docs/error-messages/compiler-errors-1/compiler-error-c2473.md index 63eb9afabf2..8577d69fade 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2473.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2473.md @@ -1,20 +1,21 @@ --- -description: "Learn more about: Compiler Error C2473" title: "Compiler Error C2473" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2473" +ms.date: 11/04/2016 f1_keywords: ["C2473"] helpviewer_keywords: ["C2473"] -ms.assetid: 6bb7dbf5-b198-490f-860e-fd64d0c2a284 --- # Compiler Error C2473 -'identifier' : looks like a function definition, but there is no parameter list. +> 'identifier' : looks like a function definition, but there is no parameter list. + +## Remarks The compiler detected what looked like a function, without the parameter list. ## Example -The following sample generates C2473. +The following example generates C2473. ```cpp // C2473.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2474.md b/docs/error-messages/compiler-errors-1/compiler-error-c2474.md index 939b72aa8e8..a486d75c68e 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2474.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2474.md @@ -1,20 +1,21 @@ --- -description: "Learn more about: Compiler Error C2474" title: "Compiler Error C2474" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2474" +ms.date: 11/04/2016 f1_keywords: ["C2474"] helpviewer_keywords: ["C2474"] -ms.assetid: 64e6c61e-6e77-480e-bcf0-b30a2fc482ac --- # Compiler Error C2474 -'keyword' : missing an adjacent semicolon, could be either keyword or identifier. +> 'keyword' : missing an adjacent semicolon, could be either keyword or identifier. + +## Remarks The compiler expected to find a semicolon, and was unable to determine your intent. Add the semicolon to resolve this error. ## Example -The following sample generates C2474. +The following example generates C2474. ```cpp // C2474.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2477.md b/docs/error-messages/compiler-errors-1/compiler-error-c2477.md index 9979cd6338c..458ef4e497b 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2477.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2477.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2477" title: "Compiler Error C2477" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2477" +ms.date: 11/04/2016 f1_keywords: ["C2477"] helpviewer_keywords: ["C2477"] -ms.assetid: 60bc324b-6605-4833-8099-a291efc712e7 --- # Compiler Error C2477 -'member' : static data member cannot be initialized via derived class +> 'member' : static data member cannot be initialized via derived class + +## Remarks A static data member of a template class was initialized incorrectly. This is a breaking change with versions of the Microsoft C++ compiler prior to Visual Studio .NET 2003, in order to conform to the ISO C++ standard. -The following sample generates C2477: +## Example + +The following example generates C2477: ```cpp // C2477.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2479.md b/docs/error-messages/compiler-errors-1/compiler-error-c2479.md index e7eca0e5cc1..9f1401b3543 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2479.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2479.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2479" title: "Compiler Error C2479" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2479" +ms.date: 11/04/2016 f1_keywords: ["C2479"] helpviewer_keywords: ["C2479"] -ms.assetid: c74c7869-e65b-4ca1-b6fa-eb39fed4458a --- # Compiler Error C2479 -'identifier' : 'allocate( )' is only valid for data items of static extent +> 'identifier' : 'allocate( )' is only valid for data items of static extent + +## Remarks The `__declspec( allocate())` syntax can be used for static data only. -The following sample generates C2479: +## Example + +The following example generates C2479: ```cpp // C2479.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2480.md b/docs/error-messages/compiler-errors-1/compiler-error-c2480.md index 53d48131942..669e3b97af6 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2480.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2480.md @@ -1,20 +1,23 @@ --- -description: "Learn more about: Compiler Error C2480" title: "Compiler Error C2480" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2480" +ms.date: 11/04/2016 f1_keywords: ["C2480"] helpviewer_keywords: ["C2480"] -ms.assetid: 1a58d1c2-971b-4084-96fa-f94aa51c02f1 --- # Compiler Error C2480 -'identifier' : 'thread' is only valid for data items of static extent +> 'identifier' : 'thread' is only valid for data items of static extent + +## Remarks You cannot use the `thread` attribute with an automatic variable, nonstatic data member, function parameter, or on function declarations or definitions. Use the `thread` attribute for global variables, static data members, and local static variables only. -The following sample generates C2480: +## Example + +The following example generates C2480: ```cpp // C2480.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2482.md b/docs/error-messages/compiler-errors-1/compiler-error-c2482.md index 9c48b04b768..2e86bf038f7 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2482.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2482.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2482" title: "Compiler Error C2482" -ms.date: "09/15/2017" +description: "Learn more about: Compiler Error C2482" +ms.date: 09/15/2017 f1_keywords: ["C2482"] helpviewer_keywords: ["C2482"] -ms.assetid: 98c87da2-625c-4cc2-9bf7-78d15921e779 --- # Compiler Error C2482 @@ -16,7 +15,7 @@ In managed or WinRT code, variables declared by using the [__declspec(thread)](. ## Example -The following sample generates C2482 in managed (**/clr**) and in WinRT (**/ZW**) code: +The following example generates C2482 in managed (**/clr**) and in WinRT (**/ZW**) code: ```cpp // C2482.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2483.md b/docs/error-messages/compiler-errors-1/compiler-error-c2483.md index 5e225b8d6d9..b150748d853 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2483.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2483.md @@ -1,20 +1,21 @@ --- -description: "Learn more about: Compiler Error C2483" title: "Compiler Error C2483" -ms.date: "09/15/2017" +description: "Learn more about: Compiler Error C2483" +ms.date: 09/15/2017 f1_keywords: ["C2483"] helpviewer_keywords: ["C2483"] -ms.assetid: 5762b325-914b-442d-a604-e4617ba04038 --- # Compiler Error C2483 >'*identifier*' : object with constructor or destructor cannot be declared 'thread' +## Remarks + This error message is obsolete in Visual Studio 2015 and later versions. In previous versions, variables declared with the `thread` attribute cannot be initialized with a constructor or other expression that requires run-time evaluation. A static expression is required to initialize `thread` data. ## Example -The following sample generates C2483 in Visual Studio 2013 and earlier versions. +The following example generates C2483 in Visual Studio 2013 and earlier versions. ```cpp // C2483.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2485.md b/docs/error-messages/compiler-errors-1/compiler-error-c2485.md index cc0fae6ad51..3dcdb343ffa 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2485.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2485.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Compiler Error C2485" title: "Compiler Error C2485" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2485" +ms.date: 11/04/2016 f1_keywords: ["C2485"] helpviewer_keywords: ["C2485"] -ms.assetid: daae3fc1-76cf-4a6f-b2fa-86873fb0929d --- # Compiler Error C2485 -'identifier' : unrecognized extended attribute +> 'identifier' : unrecognized extended attribute + +## Remarks The declaration attribute is not valid. diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2486.md b/docs/error-messages/compiler-errors-1/compiler-error-c2486.md index be3ef73366d..6e597959509 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2486.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2486.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2486" title: "Compiler Error C2486" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2486" +ms.date: 11/04/2016 f1_keywords: ["C2486"] helpviewer_keywords: ["C2486"] -ms.assetid: 436da349-6461-4e32-bfca-4f3e620108e2 --- # Compiler Error C2486 -'__LOCAL_SIZE' only allowed in function with the 'naked' attribute +> '__LOCAL_SIZE' only allowed in function with the 'naked' attribute + +## Remarks In inline assembly functions, the name `__LOCAL_SIZE` is reserved for functions declared with the [naked](../../cpp/naked-cpp.md) attribute. -The following sample generates C2486: +## Example + +The following example generates C2486: ```cpp // C2486.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2487.md b/docs/error-messages/compiler-errors-1/compiler-error-c2487.md index 29a8a9beeb8..360a49315ca 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2487.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2487.md @@ -1,17 +1,21 @@ --- -description: "Learn more about: Compiler Error C2487" title: "Compiler Error C2487" -ms.date: "03/04/2024" +description: "Learn more about: Compiler Error C2487" +ms.date: 03/04/2024 f1_keywords: ["C2487"] helpviewer_keywords: ["C2487"] --- # Compiler Error C2487 -'identifier' : member of dll interface class may not be declared with dll interface +> 'identifier' : member of dll interface class may not be declared with dll interface + +## Remarks You can declare a whole class, or certain members of a non-DLL interface class, with DLL interface. You cannot declare a class with DLL interface and then declare a member of that class with DLL interface. -The following sample generates C2487: +## Example + +The following example generates C2487: ```cpp // C2487.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2488.md b/docs/error-messages/compiler-errors-1/compiler-error-c2488.md index 03afc72f646..f708e3c6c8e 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2488.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2488.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2488" title: "Compiler Error C2488" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2488" +ms.date: 11/04/2016 f1_keywords: ["C2488"] helpviewer_keywords: ["C2488"] -ms.assetid: cd435909-43e4-43c6-a57c-5d02468ef75f --- # Compiler Error C2488 -'identifier' : 'naked' can only be applied to non-member function definitions +> 'identifier' : 'naked' can only be applied to non-member function definitions + +## Remarks The [naked](../../cpp/naked-cpp.md) attribute was applied to a function declaration. -The following sample generates C2488: +## Example + +The following example generates C2488: ```cpp // C2488.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2489.md b/docs/error-messages/compiler-errors-1/compiler-error-c2489.md index b7cdbc9ed09..fb1bc4c1b20 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2489.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2489.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2489" title: "Compiler Error C2489" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2489" +ms.date: 11/04/2016 f1_keywords: ["C2489"] helpviewer_keywords: ["C2489"] -ms.assetid: 67d8cd98-db7e-4f7f-86b4-4af7bc89ec8b --- # Compiler Error C2489 -'identifier' : initialized auto or register variable not allowed at function scope in 'naked' function +> 'identifier' : initialized auto or register variable not allowed at function scope in 'naked' function + +## Remarks For more information, see [naked](../../cpp/naked-cpp.md). -The following sample generates C2489: +## Example + +The following example generates C2489: ```cpp // C2489.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2490.md b/docs/error-messages/compiler-errors-1/compiler-error-c2490.md index b675d35c6b0..56c30f37d31 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2490.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2490.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2490" title: "Compiler Error C2490" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2490" +ms.date: 11/04/2016 f1_keywords: ["C2490"] helpviewer_keywords: ["C2490"] -ms.assetid: 9de6bddd-b2e2-4ce6-b33b-201a8c2c8c54 --- # Compiler Error C2490 -'keyword' not allowed in function with 'naked' attribute +> 'keyword' not allowed in function with 'naked' attribute + +## Remarks A function defined as [naked](../../cpp/naked-cpp.md) cannot use structured exception handling. -The following sample generates C2490: +## Example + +The following example generates C2490: ```cpp // C2490.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2491.md b/docs/error-messages/compiler-errors-1/compiler-error-c2491.md index d04430cdf58..cdbaa93e35a 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2491.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2491.md @@ -1,20 +1,23 @@ --- -description: "Learn more about: Compiler Error C2491" title: "Compiler Error C2491" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2491" +ms.date: 11/04/2016 f1_keywords: ["C2491"] helpviewer_keywords: ["C2491"] -ms.assetid: 4e5a8f81-124e-402c-a5ec-d35a89b5469e --- # Compiler Error C2491 -'identifier' : definition of dllimport function not allowed +> 'identifier' : definition of dllimport function not allowed + +## Remarks Data, static data members, and functions can be declared as `dllimport`s but not defined as `dllimport`s. To fix this issue, remove the `__declspec(dllimport)` specifier from the definition of the function. -The following sample generates C2491: +## Example + +The following example generates C2491: ```cpp // C2491.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2492.md b/docs/error-messages/compiler-errors-1/compiler-error-c2492.md index 5b1d3f958a7..15b7b82c18a 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2492.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2492.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2492" title: "Compiler Error C2492" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2492" +ms.date: 11/04/2016 f1_keywords: ["C2492"] helpviewer_keywords: ["C2492"] -ms.assetid: 8c44c9bb-c366-4fe5-a0ab-882e38608aaa --- # Compiler Error C2492 -'*variable*': data with thread storage duration may not have dll interface +> '*variable*': data with thread storage duration may not have dll interface + +## Remarks The variable is declared with the [thread](../../cpp/thread.md) attribute and with the DLL interface. The address of the `thread` variable is not known until run time, so it cannot be linked to a DLL import or export. -The following sample generates C2492: +## Example + +The following example generates C2492: ```cpp // C2492.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2493.md b/docs/error-messages/compiler-errors-1/compiler-error-c2493.md index 880eb4770f3..9a594c154ba 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2493.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2493.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2493" title: "Compiler Error C2493" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2493" +ms.date: 11/04/2016 f1_keywords: ["C2493"] helpviewer_keywords: ["C2493"] -ms.assetid: 68316cd5-682b-49c3-b6ea-23c4e5d296cf --- # Compiler Error C2493 -illegal form of __based +> illegal form of __based + +## Remarks A **`__based`** expression must be based on a pointer. -The following sample generates C2493: +## Example + +The following example generates C2493: ```cpp // C2493.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2494.md b/docs/error-messages/compiler-errors-1/compiler-error-c2494.md index b8e75b82068..2d3a8755b78 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2494.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2494.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2494" title: "Compiler Error C2494" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2494" +ms.date: 11/04/2016 f1_keywords: ["C2494"] helpviewer_keywords: ["C2494"] -ms.assetid: 5dfd07ab-351d-49c9-b54e-f0a104776ab8 --- # Compiler Error C2494 > '*keyword*' cannot be called from within a filter expression or __finally/finally block +## Remarks + You cannot use *keyword* in a **`__finally`** or **`finally`** block. -The following sample generates C2494: +## Examples + +The following example generates C2494: ```cpp // C2494.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2495.md b/docs/error-messages/compiler-errors-1/compiler-error-c2495.md index 4c574088ef9..77119a710aa 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2495.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2495.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2495" title: "Compiler Error C2495" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2495" +ms.date: 11/04/2016 f1_keywords: ["C2495"] helpviewer_keywords: ["C2495"] -ms.assetid: bb7066fe-3549-4901-97e4-157f3c04dd57 --- # Compiler Error C2495 -'identifier' : 'nothrow' can only be applied to function declarations or definitions +> 'identifier' : 'nothrow' can only be applied to function declarations or definitions + +## Remarks The [nothrow](../../cpp/nothrow-cpp.md) extended attribute can be applied to function declarations or definitions only. -The following sample generates C2495: +## Example + +The following example generates C2495: ```cpp // C2495.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2496.md b/docs/error-messages/compiler-errors-1/compiler-error-c2496.md index 8e35f8ac5c5..4c8ff4c65ab 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2496.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2496.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2496" title: "Compiler Error C2496" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2496" +ms.date: 11/04/2016 f1_keywords: ["C2496"] helpviewer_keywords: ["C2496"] -ms.assetid: 9a25237d-5bbb-4112-98f3-29cd99d3f89f --- # Compiler Error C2496 -'identifier' : 'selectany' can only be applied to data items with external linkage +> 'identifier' : 'selectany' can only be applied to data items with external linkage + +## Remarks The [selectany](../../cpp/selectany.md) attribute can be applied only to externally visible and global data items. -The following sample generates C2496: +## Example + +The following example generates C2496: ```cpp // C2496.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2498.md b/docs/error-messages/compiler-errors-1/compiler-error-c2498.md index ca002045d60..fb603e31ed2 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2498.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2498.md @@ -1,20 +1,21 @@ --- -description: "Learn more about: Compiler Error C2498" title: "Compiler Error C2498" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2498" +ms.date: 11/04/2016 f1_keywords: ["C2498"] helpviewer_keywords: ["C2498"] -ms.assetid: 0839f12c-aaa4-4a02-bb33-7f072715dd14 --- # Compiler Error C2498 -'function' : 'novtable' can only be applied to class declarations or definitions +> 'function' : 'novtable' can only be applied to class declarations or definitions + +## Remarks This error can be caused by using `__declspec(novtable)` with a function. ## Example -The following sample generates C2498: +The following example generates C2498: ```cpp // C2498.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-error-c2499.md b/docs/error-messages/compiler-errors-1/compiler-error-c2499.md index ce2ea37923d..38e8f58cd81 100644 --- a/docs/error-messages/compiler-errors-1/compiler-error-c2499.md +++ b/docs/error-messages/compiler-errors-1/compiler-error-c2499.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2499" title: "Compiler Error C2499" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2499" +ms.date: 11/04/2016 f1_keywords: ["C2499"] helpviewer_keywords: ["C2499"] -ms.assetid: b323ff4d-b3c1-4bfd-b052-ae7292d53222 --- # Compiler Error C2499 -'class' : a class cannot be its own base class +> 'class' : a class cannot be its own base class + +## Remarks You attempted to specify the class that you are defining as a base class. -The following sample generates C2499: +## Example + +The following example generates C2499: ```cpp // C2499.cpp diff --git a/docs/error-messages/compiler-errors-1/compiler-errors-c2001-through-c2099.md b/docs/error-messages/compiler-errors-1/compiler-errors-c2001-through-c2099.md index eff111136ba..d12d6a6217b 100644 --- a/docs/error-messages/compiler-errors-1/compiler-errors-c2001-through-c2099.md +++ b/docs/error-messages/compiler-errors-1/compiler-errors-c2001-through-c2099.md @@ -2,8 +2,8 @@ description: "Learn more about: Compiler errors C2001 through C2099" title: "Compiler errors C2001 through C2099" ms.date: 08/24/2022 -f1_keywords: ["C2000", "C2029"] -helpviewer_keywords: ["C2000", "C2029"] +f1_keywords: ["C2029"] +helpviewer_keywords: ["C2029"] --- # Compiler errors C2001 through C2099 @@ -20,14 +20,14 @@ The articles in this section of the documentation explain a subset of the error | [Compiler error C2003](compiler-error-c2003.md) | expected 'defined id' | | [Compiler error C2004](compiler-error-c2004.md) | expected 'defined(id)' | | [Compiler error C2005](compiler-error-c2005.md) | #line expected a line number, found '*token*' | -| [Compiler error C2006](compiler-error-c2006.md) | '*directive*': expected a filename, found '*token*' | +| [Compiler error C2006](compiler-error-c2006.md) | '*directive*': expected `"FILENAME"` or `` | | [Compiler error C2007](compiler-error-c2007.md) | #define syntax | | [Compiler error C2008](compiler-error-c2008.md) | '*character*': unexpected in macro definition | -| [Compiler error C2009](compiler-error-c2009.md) | reuse of macro formal '*identifier*' | +| [Compiler error C2009](compiler-error-c2009.md) | cannot reuse macro parameter name '*identifier*' | | [Compiler error C2010](compiler-error-c2010.md) | '*character*': unexpected in macro formal parameter list | | [Compiler error C2011](compiler-error-c2011.md) | '*identifier*': '*type*' type redefinition | | [Compiler error C2012](compiler-error-c2012.md) | missing name following '<' | -| [Compiler error C2013](compiler-error-c2013.md) | missing '>' | +| [Compiler error C2013](compiler-error-c2013.md) | expected a '*token*' | | [Compiler error C2014](compiler-error-c2014.md) | preprocessor command must start as first nonwhite space | | [Compiler error C2015](compiler-error-c2015.md) | too many characters in constant | | [Compiler error C2016](compiler-error-c2016.md) | C requires that a struct or union has at least one member | @@ -89,7 +89,7 @@ The articles in this section of the documentation explain a subset of the error | [Compiler error C2072](compiler-error-c2072.md) | '*identifier*': initialization of a function | | [Compiler error C2073](compiler-error-c2073.md) | **(Obsolete)** '*identifier*': elements of partially initialized array must have a default constructor | | [Compiler error C2074](compiler-error-c2074.md) | '*identifier*': '*type*' initialization requires a brace-enclosed initializer list | -| [Compiler error C2075](compiler-error-c2075.md) | '*identifier*': array initialization requires a brace-enclosed initializer list | +| [Compiler error C2075](compiler-error-c2075.md) | '*identifier*': initialization requires a brace-enclosed initializer list | | [Compiler error C2076](compiler-error-c2076.md) | a brace-enclosed initializer list cannot be used in a new-expression whose type contains '*type*' | | [Compiler error C2077](compiler-error-c2077.md) | non-scalar field initializer '*identifier*' | | [Compiler error C2078](compiler-error-c2078.md) | too many initializers | @@ -102,11 +102,11 @@ The articles in this section of the documentation explain a subset of the error | [Compiler error C2085](compiler-error-c2085.md) | '*identifier*': not in formal parameter list | | [Compiler error C2086](compiler-error-c2086.md) | '*identifier*': redefinition | | [Compiler error C2087](compiler-error-c2087.md) | '*identifier*': missing subscript | -| [Compiler error C2088](compiler-error-c2088.md) | '*operator*': illegal for struct/class/union | +| [Compiler error C2088](compiler-error-c2088.md) | built-in operator '*operator*' cannot be applied to an operand of type '*class type*' | | [Compiler error C2089](compiler-error-c2089.md) | '*identifier*': '*type*' too large | | [Compiler error C2090](compiler-error-c2090.md) | function returns array | | [Compiler error C2091](compiler-error-c2091.md) | function returns function | -| [Compiler error C2092](compiler-error-c2092.md) | '*identifier*' array element type cannot be function | +| [Compiler error C2092](compiler-error-c2092.md) | '*identifier*' array element type cannot be function or abstract class type | | [Compiler error C2093](compiler-error-c2093.md) | '*identifier1*': cannot be initialized using address of automatic variable '*identifier2*' | | [Compiler error C2094](compiler-error-c2094.md) | label '*identifier*' was undefined | | [Compiler error C2095](compiler-error-c2095.md) | '*function*': actual parameter has type 'void': parameter *number* | diff --git a/docs/error-messages/compiler-errors-1/compiler-errors-c2100-through-c2199.md b/docs/error-messages/compiler-errors-1/compiler-errors-c2100-through-c2199.md index f6bbfd99175..66e44a4ebeb 100644 --- a/docs/error-messages/compiler-errors-1/compiler-errors-c2100-through-c2199.md +++ b/docs/error-messages/compiler-errors-1/compiler-errors-c2100-through-c2199.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler errors C2100 through C2199" title: "Compiler errors C2100 through C2199" -ms.date: "04/21/2019" +description: "Learn more about: Compiler errors C2100 through C2199" +ms.date: 04/21/2019 f1_keywords: ["C2119", "C2123", "C2125", "C2126", "C2127", "C2136", "C2176", "C2187", "C2189"] -helpviewer_keywords: ["C2119", "C2123", "C2125", "C2126", "C2127", "C2131", "C2136", "C2176", "C2187", "C2189"] -ms.assetid: 1ccab076-0954-4386-b959-d3112a6793ae +helpviewer_keywords: ["C2119", "C2123", "C2125", "C2126", "C2127", "C2136", "C2176", "C2187", "C2189"] --- # Compiler errors C2100 through C2199 @@ -16,7 +15,7 @@ The articles in this section of the documentation explain a subset of the error |Error|Message| |-----------|-------------| -|[Compiler error C2100](compiler-error-c2100.md)|illegal indirection| +|[Compiler error C2100](compiler-error-c2100.md)|you cannot dereference an operand of type '*type*'| |[Compiler error C2101](compiler-error-c2101.md)|'&' on constant| |[Compiler error C2102](compiler-error-c2102.md)|'&' requires l-value| |[Compiler error C2103](compiler-error-c2103.md)|'&' on register variable| @@ -32,11 +31,11 @@ The articles in this section of the documentation explain a subset of the error |[Compiler error C2113](compiler-error-c2113.md)|'-': pointer can only be subtracted from another pointer| |[Compiler error C2114](compiler-error-c2114.md)|'*operator*': pointer on left; needs integral value on right| |[Compiler error C2115](compiler-error-c2115.md)|'*operator*': incompatible types| -|[Compiler error C2116](compiler-error-c2116.md)|function parameter lists differed| +|[Compiler error C2116](compiler-error-c2116.md)|'*name*': function parameter lists do not match between declarations| |[Compiler error C2117](compiler-error-c2117.md)|'*identifier*': array bounds overflow| |[Compiler error C2118](compiler-error-c2118.md)|negative subscript| |Compiler error C2119|'*identifier*': the type for '*type*' cannot be deduced from an empty initializer| -|[Compiler error C2120](compiler-error-c2120.md)|'void' illegal with all types| +|[Compiler error C2120](compiler-error-c2120.md)|'`void`' cannot be combined with any other type specifier| |[Compiler error C2121](compiler-error-c2121.md)|'#': invalid character: possibly the result of a macro expansion| |[Compiler error C2122](compiler-error-c2122.md)|'*identifier*': prototype parameter in name list illegal| |Compiler error C2123|'*identifier*': alias templates cannot be explicitly or partially specialized| @@ -51,7 +50,7 @@ The articles in this section of the documentation explain a subset of the error |[Compiler error C2132](compiler-error-c2132.md)|syntax error: unexpected identifier| |[Compiler error C2133](compiler-error-c2133.md)|'*identifier*': unknown size| |[Compiler error C2134](compiler-error-c2134.md)|'*function*': call does not result in a constant expression| -|[Compiler error C2135](compiler-error-c2135.md)|'*operator*': illegal bit field operation| +|[Compiler error C2135](compiler-error-c2135.md)|'*identifier*': you cannot apply '*operator*' to a bit-field| |Compiler error C2136|authoring API contract not allowed| |[Compiler error C2137](compiler-error-c2137.md)|empty character constant| |[Compiler error C2138](compiler-error-c2138.md)|illegal to define an enumeration without any members| @@ -70,7 +69,7 @@ The articles in this section of the documentation explain a subset of the error |[Compiler error C2151](compiler-error-c2151.md)|more than one language attribute| |[Compiler error C2152](compiler-error-c2152.md)|'*identifier*': pointers to functions with different attributes| |[Compiler error C2153](compiler-error-c2153.md)|integer literals must have at least one digit| -|[Compiler error C2154](compiler-error-c2154.md)|'*type*': only enumeration type is allowed as an argument to compiler intrinsic type trait '*trait*'| +|[Compiler error C2154](compiler-error-c2154.md)|'*type*': only enumeration type is allowed as an argument to compiler intrinsic type trait '__underlying_type'| |[Compiler error C2155](compiler-error-c2155.md)|'?': invalid left operand, expected arithmetic or pointer type| |[Compiler error C2156](compiler-error-c2156.md)|pragma must be outside function| |[Compiler error C2157](compiler-error-c2157.md)|'*identifier*': must be declared before use in pragma list| @@ -87,7 +86,7 @@ The articles in this section of the documentation explain a subset of the error |[Compiler error C2168](compiler-error-c2168.md)|'*function*': too few actual parameters for intrinsic function| |[Compiler error C2169](compiler-error-c2169.md)|'*function*': intrinsic function, cannot be defined| |[Compiler error C2170](compiler-error-c2170.md)|'*identifier*': not declared as a function, cannot be intrinsic| -|[Compiler error C2171](compiler-error-c2171.md)|'*operator*': illegal on operands of type '*type*'| +|[Compiler error C2171](compiler-error-c2171.md)|operator '*operator*' cannot be applied to an operand of type '*type*'| |[Compiler error C2172](compiler-error-c2172.md)|'*function*': actual parameter is not a pointer: parameter *number*| |[Compiler error C2173](compiler-error-c2173.md)|'*function*': actual parameter is not a pointer: parameter *number*, parameter list *number*| |[Compiler error C2174](compiler-error-c2174.md)|'*function*': actual parameter has type 'void': parameter *number*, parameter list *number*| @@ -98,7 +97,7 @@ The articles in this section of the documentation explain a subset of the error |[Compiler error C2179](compiler-error-c2179.md)|'*type*': an attribute argument cannot use type parameters| |[Compiler error C2180](compiler-error-c2180.md)|controlling expression has type '*type*'| |[Compiler error C2181](compiler-error-c2181.md)|illegal else without matching if| -|[Compiler error C2182](compiler-error-c2182.md)|'*identifier*': illegal use of type 'void'| +|[Compiler error C2182](compiler-error-c2182.md)|'*identifier*': this use of 'void' is not valid| |[Compiler error C2183](compiler-error-c2183.md)|syntax error: translation unit is empty| |[Compiler error C2184](compiler-error-c2184.md)|'*type*': illegal type for __except expression| |[Compiler error C2185](compiler-error-c2185.md)|'*identifier*': illegal based allocation| @@ -119,5 +118,5 @@ The articles in this section of the documentation explain a subset of the error ## See also -[C/C++ Compiler and build tools errors and warnings](../compiler-errors-1/c-cpp-build-errors.md) \ -[Compiler errors C2001 - C3999, C7000 - C7999](../compiler-errors-1/compiler-errors-c2000-c3999.md) +[C/C++ Compiler and build tools errors and warnings](c-cpp-build-errors.md)\ +[Compiler errors C2001 - C3999, C7000 - C7999](compiler-errors-c2000-c3999.md) diff --git a/docs/error-messages/compiler-errors-1/compiler-errors-c2200-through-c2299.md b/docs/error-messages/compiler-errors-1/compiler-errors-c2200-through-c2299.md index aeb9e58f334..061b94f1696 100644 --- a/docs/error-messages/compiler-errors-1/compiler-errors-c2200-through-c2299.md +++ b/docs/error-messages/compiler-errors-1/compiler-errors-c2200-through-c2299.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler errors C2200 through C2299" title: "Compiler errors C2200 through C2299" +description: "Learn more about: Compiler errors C2200 through C2299" ms.date: "04/21/2019" -f1_keywords: ["C2202", "C2209", "C2210", "C2211", "C2214", "C2215", "C2221", "C2225", "C2230", "C2235", "C2237", "C2239", "C2240", "C2257", "C2260", "C2263", "C2265", "C2269", "C2278", "C2281", "C2282", "C2288", "C2291", "C2294"] -helpviewer_keywords: ["C2202", "C2209", "C2210", "C2211", "C2214", "C2215", "C2221", "C2225", "C2230", "C2235", "C2237", "C2239", "C2240", "C2257", "C2260", "C2263", "C2265", "C2269", "C2278", "C2281", "C2282", "C2288", "C2291", "C2294"] -ms.assetid: 9b36d11b-9510-4390-96f1-0c9235124d14 +f1_keywords: ["C2202", "C2209", "C2210", "C2211", "C2214", "C2215", "C2221", "C2225", "C2230", "C2235", "C2237", "C2239", "C2240", "C2257", "C2260", "C2263", "C2265", "C2269", "C2278", "C2281", "C2282", "C2284", "C2288", "C2291", "C2294"] +helpviewer_keywords: ["C2202", "C2209", "C2210", "C2211", "C2214", "C2215", "C2221", "C2225", "C2230", "C2235", "C2237", "C2239", "C2240", "C2257", "C2260", "C2263", "C2265", "C2269", "C2278", "C2281", "C2282", "C2284", "C2288", "C2291", "C2294"] --- # Compiler errors C2200 through C2299 @@ -36,7 +35,7 @@ The articles in this section of the documentation explain a subset of the error |[Compiler error C2217](compiler-error-c2217.md)|'*attribute1*' requires '*attribute2*'| |[Compiler error C2218](compiler-error-c2218.md)|'*calltype*' cannot be used with '/arch:IA32'| |[Compiler error C2219](compiler-error-c2219.md)|syntax error: type qualifier must be after '*'| -|[Compiler error C2220](compiler-error-c2220.md)|warning treated as error - no '*filetype*' file generated| +|[Compiler error C2220](compiler-error-c2220.md)|the following warning is treated as an error| |Compiler error C2221|Obsolete.| |[Compiler error C2222](compiler-error-c2222.md)|unexpected type '*type*': a base-class or member was expected| |[Compiler error C2223](compiler-error-c2223.md)|left of '->*identifier*' must point to struct/union| @@ -51,7 +50,7 @@ The articles in this section of the documentation explain a subset of the error |[Compiler error C2232](compiler-error-c2232.md)|'->*identifier*': left operand has 'class/struct/union' type, use '.'| |[Compiler error C2233](compiler-error-c2233.md)|'*identifier*': arrays of objects containing zero-size arrays are illegal| |[Compiler error C2234](compiler-error-c2234.md)|*identifier*': arrays of references are illegal| -|Compiler error C2235|Obsolete.| +|Compiler error C2235|mismatching target architecture for compiled module interface for '*architecture 1*' from '*architecture 2*'| |[Compiler error C2236](compiler-error-c2236.md)|unexpected token '*token*'. Did you forget a ';'?| |Compiler error C2237|multiple module declaration| |[Compiler error C2238](compiler-error-c2238.md)|unexpected token(s) preceding '*token*'| @@ -79,7 +78,7 @@ The articles in this section of the documentation explain a subset of the error |Compiler error C2260|'*specifier*': invalid InternalsVisibleToAttribute friend assembly specifier| |[Compiler error C2261](compiler-error-c2261.md)|'*string*': assembly reference is invalid and cannot be resolved| |[Compiler error C2262](compiler-error-c2262.md)|'*specifier*': InternalsVisibleTo declarations cannot have a version, culture, or processor architecture specified| -|Compiler error C2263|Obsolete.| +|Compiler error C2263|'*module name*': a translation unit cannot be imported into itself| |[Compiler error C2264](compiler-error-c2264.md)|'*function*': error in function definition or declaration; function not called| |Compiler error C2265|Obsolete.| |[Compiler error C2266](compiler-error-c2266.md)|'*identifier*': reference to a non-constant bounded array is illegal| @@ -91,20 +90,20 @@ The articles in this section of the documentation explain a subset of the error |[Compiler error C2272](compiler-error-c2272.md)|'*function*': modifiers not allowed on static member functions| |[Compiler error C2273](compiler-error-c2273.md)|'*type*': illegal as right side of '->' operator| |[Compiler error C2274](compiler-error-c2274.md)|'*type*': illegal as right side of '.' operator| -|[Compiler error C2275](compiler-error-c2275.md)|'*type*': illegal use of this type as an expression| +|[Compiler error C2275](compiler-error-c2275.md)|'*type*': expected an expression instead of a type| |[Compiler error C2276](compiler-error-c2276.md)|'*operator*': illegal operation on bound member function expression| |[Compiler error C2277](compiler-error-c2277.md)|'*function*': cannot take address of this member function| -|Compiler error C2278|Obsolete.| +|Compiler error C2278|'*token*': unexpected token. Format is '`__has_cpp_attribute( identifier )`'| |[Compiler error C2279](compiler-error-c2279.md)|exception specification cannot appear in a typedef declaration| |[Compiler error C2280](compiler-error-c2280.md)|'*class*::*function*': attempting to reference a deleted function| |Compiler error C2281|'*class*::*function*': a function can only be deleted on the first declaration| |Compiler error C2282|'*function1*' cannot override '*function2*'| -|[Compiler error C2283](compiler-error-c2283.md)|'*identifer*': pure specifier or abstract override specifier not allowed on unnamed class/struct| +|[Compiler error C2283](compiler-error-c2283.md)|'*identifier*': pure specifier or abstract override specifier not allowed on unnamed struct| |Compiler error C2284|'*function*': illegal argument to intrinsic function, parameter *number*| |[Compiler error C2285](compiler-error-c2285.md)|pointers to members representation has already been determined - pragma ignored| |[Compiler error C2286](compiler-error-c2286.md)|pointers to members of '*identifier*' representation is already set to *inheritance* - declaration ignored| |[Compiler error C2287](compiler-error-c2287.md)|'*identifier*': inheritance representation: '*inheritiance*' is less general than the required '*inheritance*'| -|Compiler error C2288|Obsolete.| +|Compiler error C2288|preprocessing number '*number*' is not a valid integer or floating literal| |[Compiler error C2289](compiler-error-c2289.md)|same type qualifier used more than once| |[Compiler error C2290](compiler-error-c2290.md)|C++ 'asm' syntax ignored. Use __asm.| |Compiler error C2291|An anonymous namespace cannot be exported.| diff --git a/docs/error-messages/compiler-errors-1/compiler-errors-c2300-through-c2399.md b/docs/error-messages/compiler-errors-1/compiler-errors-c2300-through-c2399.md index d64bb155bed..3abd7f9ea41 100644 --- a/docs/error-messages/compiler-errors-1/compiler-errors-c2300-through-c2399.md +++ b/docs/error-messages/compiler-errors-1/compiler-errors-c2300-through-c2399.md @@ -53,7 +53,7 @@ The articles in this section of the documentation explain a subset of the error |Compiler error C2335|'*identifier*': a type cannot be introduced in a function parameter list| |Compiler error C2336|'*type*': illegal type| |[Compiler error C2337](compiler-error-c2337.md)|'*attribute*': attribute not found| -|[Compiler error C2338](compiler-error-c2338.md)|*(error message from external provider)*| +|[Compiler error C2338](compiler-error-c2338.md)|static_assert failed: '*(error message from external provider)*'| |Compiler error C2339|'*identifier*': illegal type in embedded-IDL| |Compiler error C2340|'*identifier*': 'static' can only be used within a class definition| |[Compiler error C2341](compiler-error-c2341.md)|'*section*': segment must be defined using #pragma data_seg, code_seg or section prior to use| @@ -67,7 +67,7 @@ The articles in this section of the documentation explain a subset of the error |[Compiler error C2349](compiler-error-c2349.md)|'*function*' cannot be compiled as managed: '*explanation*'; use #pragma unmanaged| |[Compiler error C2350](compiler-error-c2350.md)|'*identifier*' is not a static member| |[Compiler error C2351](compiler-error-c2351.md)|obsolete C++ constructor initialization syntax| -|[Compiler error C2352](compiler-error-c2352.md)|'*identifier*': illegal call of non-static member function| +|[Compiler error C2352](compiler-error-c2352.md)|'*identifier*': a call of a non-static member function requires an object| |[Compiler error C2353](compiler-error-c2353.md)|exception specification is not allowed| |Compiler error C2354|Obsolete.| |[Compiler error C2355](compiler-error-c2355.md)|'this': can only be referenced inside non-static member functions or non-static data member initializers| @@ -96,7 +96,7 @@ The articles in this section of the documentation explain a subset of the error |[Compiler error C2378](compiler-error-c2378.md)|'*identifier*': redefinition; symbol cannot be overloaded with a typedef| |[Compiler error C2379](compiler-error-c2379.md)|formal parameter *number* has different type when promoted| |[Compiler error C2380](compiler-error-c2380.md)|type(s) preceding '*identifier*' (constructor with return type, or illegal redefinition of current class-name?)| -|[Compiler error C2381](compiler-error-c2381.md)|'*identifier*': redefinition; '__declspec(noreturn)' or '[[noreturn]]' differs| +|[Compiler error C2381](compiler-error-c2381.md)|'*identifier*': redefinition; '`noreturn`' differs| |[Compiler error C2382](compiler-error-c2382.md)|'*identifier*': redefinition; different exception specifications| |[Compiler error C2383](compiler-error-c2383.md)|'*identifier*': default-arguments are not allowed on this symbol| |[Compiler error C2384](compiler-error-c2384.md)|'*member*': cannot apply thread_local or __declspec(thread) to a member of a managed/WinRT class| diff --git a/docs/error-messages/compiler-errors-1/compiler-errors-c2400-through-c2499.md b/docs/error-messages/compiler-errors-1/compiler-errors-c2400-through-c2499.md index 31902125890..d7e931c1e43 100644 --- a/docs/error-messages/compiler-errors-1/compiler-errors-c2400-through-c2499.md +++ b/docs/error-messages/compiler-errors-1/compiler-errors-c2400-through-c2499.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler errors C2400 Through C2499" title: "Compiler errors C2400 Through C2499" +description: "Learn more about: Compiler errors C2400 Through C2499" ms.date: "04/21/2019" f1_keywords: ["C2416", "C2442", "C2453", "C2454", "C2455", "C2456", "C2468", "C2475", "C2478", "C2481", "C2497"] helpviewer_keywords: ["C2416", "C2442", "C2453", "C2454", "C2455", "C2456", "C2468", "C2475", "C2478", "C2481", "C2497"] -ms.assetid: f1f05572-af0b-497b-bde4-4c81ec01af3b --- # Compiler errors C2400 Through C2499 @@ -51,7 +50,7 @@ The articles in this section of the documentation explain a subset of the error |[Compiler error C2432](compiler-error-c2432.md)|illegal reference to 16-bit data in '*context*'| |[Compiler error C2433](compiler-error-c2433.md)|'*identifier*': '*modifier*' not permitted on data declarations| |[Compiler error C2434](compiler-error-c2434.md)|'*symbol*': a symbol declared with `__declspec(process)` cannot be dynamically initialized in `/clr:pure` mode| -|[Compiler error C2435](compiler-error-c2435.md)|'var': dynamic initialization requires managed CRT, cannot compile with `/clr:safe`| +|[Compiler error C2435](compiler-error-c2435.md)|'*var*': dynamic initialization requires managed CRT, cannot compile with `/clr:safe`| |[Compiler error C2436](compiler-error-c2436.md)|'*identifier*': member function or nested class in constructor initializer list| |[Compiler error C2437](compiler-error-c2437.md)|'*identifier*': has already been initialized| |[Compiler error C2438](compiler-error-c2438.md)|'*identifier*': cannot initialize static class data via constructor| @@ -61,11 +60,12 @@ The articles in this section of the documentation explain a subset of the error |Compiler error C2442|'*identifier*': nested-namespace-definition cannot be inline or have attributes| |[Compiler error C2443](compiler-error-c2443.md)|operand size conflict| |[Compiler error C2444](compiler-error-c2444.md)|'*identifier*': used ANSI prototype, found 'type', expected '{' or ';'| +|Compiler error C2445|result type of conditional expression is ambiguous: types '*type 1*' and '*type 2*' can be converted to multiple common types| |[Compiler error C2446](compiler-error-c2446.md)|'*operator*': no conversion from '*type_1*' to '*type_2*'| |[Compiler error C2447](compiler-error-c2447.md)|'{': missing function header (old-style formal list?)| |[Compiler error C2448](compiler-error-c2448.md)|'*identifier*': function-style initializer appears to be a function definition| |[Compiler error C2449](compiler-error-c2449.md)|found '{' at file scope (missing function header?)| -|[Compiler error C2450](compiler-error-c2450.md)|switch expression of type '*type*' is illegal| +|[Compiler error C2450](compiler-error-c2450.md)|a `switch` expression of type '*type*' is illegal| |[Compiler error C2451](compiler-error-c2451.md)|conditional expression of type '*type*' is illegal| |[Compiler error C2452](compiler-error-c2452.md)|'*type*': invalid source type for `safe_cast`| |Compiler error C2453|'*type*': invalid target type for safe_cast| diff --git a/docs/error-messages/compiler-errors-1/compiler-fatal-errors-c999-through-c1999.md b/docs/error-messages/compiler-errors-1/compiler-fatal-errors-c999-through-c1999.md index 47a7d928d59..8ba3fceb817 100644 --- a/docs/error-messages/compiler-errors-1/compiler-fatal-errors-c999-through-c1999.md +++ b/docs/error-messages/compiler-errors-1/compiler-fatal-errors-c999-through-c1999.md @@ -1,12 +1,11 @@ --- -description: "Learn more about: Compiler fatal errors C999 through C1999" -title: "Compiler fatal errors C999 through C1999" -ms.date: 08/17/2022 -f1_keywords: ["C1006", "C1024", "C1027", "C1030", "C1032", "C1034", "C1036", "C1039", "C1040", "C1041", "C1042", "C1043", "C1044", "C1048", "C1056", "C1058", "C1059", "C1063", "C1069", "C1101", "C1102", "C1105", "C1110", "C1111", "C1112", "C1114", "C1118", "C1119", "C1127", "C1193", "C1194", "C1195", "C1198", "C1199", "C1203", "C1204", "C1212", "C1213", "C1214", "C1300", "C1301", "C1302", "C1303", "C1304", "C1306", "C1354", "C1355", "C1356", "C1357", "C1358", "C1384", "C1385", "C1451", "C1505", "C1507", "C1511", "C1604", "C1605", "C1901", "C1906", "C1907"] -helpviewer_keywords: ["C1006", "C1024", "C1027", "C1030", "C1032", "C1034", "C1036", "C1039", "C1040", "C1041", "C1042", "C1043", "C1044", "C1048", "C1056", "C1058", "C1059", "C1063", "C1069", "C1101", "C1102", "C1105", "C1110", "C1111", "C1112", "C1114", "C1118", "C1119", "C1127", "C1193", "C1194", "C1195", "C1198", "C1199", "C1203", "C1204", "C1212", "C1213", "C1214", "C1300", "C1301", "C1302", "C1303", "C1304", "C1306", "C1354", "C1355", "C1356", "C1357", "C1358", "C1384", "C1385", "C1451", "C1505", "C1507", "C1511", "C1604", "C1605", "C1901", "C1906", "C1907"] -ms.assetid: 6c8df109-7594-48ed-987a-97d9fe2b04af +title: "Compiler fatal errors C1001 through C1907" +description: "Learn more about: Compiler fatal errors C1001 through C1907" +ms.date: 01/24/2025 +f1_keywords: ["C1006", "C1024", "C1027", "C1030", "C1032", "C1034", "C1036", "C1039", "C1040", "C1041", "C1042", "C1043", "C1044", "C1048", "C1056", "C1058", "C1059", "C1063", "C1069", "C1101", "C1102", "C1105", "C1110", "C1111", "C1112", "C1114", "C1118", "C1119", "C1127", "C1193", "C1194", "C1195", "C1198", "C1199", "C1203", "C1204", "C1212", "C1213", "C1214", "C1300", "C1301", "C1302", "C1303", "C1304", "C1306", "C1354", "C1355", "C1356", "C1357", "C1358", "C1384", "C1385", "C1451", "C1505", "C1507", "C1511", "C1604", "C1605", "C1859", "C1901", "C1906", "C1907"] +helpviewer_keywords: ["C1006", "C1024", "C1027", "C1030", "C1032", "C1034", "C1036", "C1039", "C1040", "C1041", "C1042", "C1043", "C1044", "C1048", "C1056", "C1058", "C1059", "C1063", "C1069", "C1101", "C1102", "C1105", "C1110", "C1111", "C1112", "C1114", "C1118", "C1119", "C1127", "C1193", "C1194", "C1195", "C1198", "C1199", "C1203", "C1204", "C1212", "C1213", "C1214", "C1300", "C1301", "C1302", "C1303", "C1304", "C1306", "C1354", "C1355", "C1356", "C1357", "C1358", "C1384", "C1385", "C1451", "C1505", "C1507", "C1511", "C1604", "C1605", "C1859", "C1901", "C1906", "C1907"] --- -# Compiler fatal errors C999 through C1999 +# Compiler fatal errors C1001 through C1907 The articles in this section of the documentation explain a subset of the error messages that are generated by the Microsoft C/C++ compiler. @@ -27,7 +26,7 @@ The articles in this section of the documentation explain a subset of the error | [Fatal error C1009](fatal-error-c1009.md) | compiler limit: macros nested too deeply | | [Fatal error C1010](fatal-error-c1010.md) | unexpected end of file while looking for precompiled header. Did you forget to add '`#include <`*file*`>`' to your source? | | [Fatal error C1011](fatal-error-c1011.md) | cannot locate standard module interface. Did you install the library part of the C++ modules feature in VS setup? | -| [Fatal error C1012](fatal-error-c1012.md) | unmatched parenthesis: missing '*character*" | +| [Fatal error C1012](fatal-error-c1012.md) | unmatched parenthesis: missing '*character*' | | [Fatal error C1013](fatal-error-c1013.md) | compiler limit: too many open parentheses | | [Fatal error C1014](fatal-error-c1014.md) | too many include files: depth = *number* | | [Fatal error C1015](fatal-error-c1015.md) | header-names '*header-name*' and '*header-name*' identify the same header and cannot be used as both `/headerUnit:quoted` and `/headerUnit:angle` arguments; please provide this header-name only once | @@ -43,6 +42,7 @@ The articles in this section of the documentation explain a subset of the error | [Fatal error C1025](fatal-error-c1025-c1115.md) | too many nested lambdas | | [Fatal error C1026](fatal-error-c1026.md) | parser stack overflow, program too complex | | Fatal error C1027 | **(Obsolete)** Inconsistent values for /Ym between creation and use of precompiled header | +| Fatal error C1028 | missing IFC for analysis. Please rebuild *module* '*ifc filename*' with `/analyze`. | | Fatal error C1030 | WMMX types not allowed in the function signature by the calling convention | | Fatal error C1032 | `__eabi` requires VFP code generation (`/QRfpe-`) | | [Fatal error C1033](fatal-error-c1033.md) | cannot open program database '*file*' | @@ -102,6 +102,7 @@ The articles in this section of the documentation explain a subset of the error | [Fatal error C1092](fatal-error-c1092.md) | Edit and Continue does not support changes to data types; build required | | [Fatal error C1093](fatal-error-c1093.md) | API call '*function*' failed '*HRESULT*': '*description*' | | [Fatal error C1094](fatal-error-c1094.md) | '`-Zm`*number*': command line option is inconsistent with value used to build precompiled header ('`-Zm`*number*') | +| Fatal error C1095 | Failed to locate a free memory range. Use `/Yb` to specify a base address. | | [Fatal error C1098](fatal-error-c1098.md) | Version mismatch with Edit and Continue engine | | [Fatal error C1099](fatal-error-c1099.md) | Edit and Continue engine terminating compile | | [Fatal error C1100](fatal-error-c1100.md) | unable to initialize OLE: *error* | @@ -110,12 +111,13 @@ The articles in this section of the documentation explain a subset of the error | [Fatal error C1103](fatal-error-c1103.md) | fatal error importing progid: '*message*' | | [Fatal error C1104](fatal-error-c1104.md) | fatal error importing libid: '*message*' | | Fatal error C1105 | *message*: *HRESULT error* | +| Fatal error C1106 | compiler limit: only *number* function parameters are allowed | | [Fatal error C1107](fatal-error-c1107.md) | could not find assembly '*assembly*': please specify the assembly search path using `/AI` or by setting the `LIBPATH` environment variable | | [Fatal error C1108](fatal-error-c1108.md) | unable to find DLL: '*file*' | | [Fatal error C1109](fatal-error-c1109.md) | unable to find '*symbol*' in DLL '*file*' | | Fatal error C1110 | too many nested template/generic definitions | | Fatal error C1111 | too many template/generic parameters | -| Fatal error C1112 | compiler limit: '*number*' too many macro arguments, only *number* allowed | +| Fatal error C1112 | compiler limit: '*number*' too many macro arguments, only '*number*' allowed | | [Fatal error C1113](fatal-error-c1113.md) | `#using` failed on '*file*' | | Fatal error C1114 | '*file*': WinRT does not support `#using` of a managed assembly | | [Fatal error C1115](fatal-error-c1025-c1115.md) | too many nested lambdas | @@ -129,7 +131,7 @@ The articles in this section of the documentation explain a subset of the error | Fatal error C1127 | *Operation* requires *option* | | [Fatal error C1128](fatal-error-c1128.md) | number of sections exceeded object file format limit: compile with `/bigobj` | | [Fatal error C1189](fatal-error-c1189.md) | `#error`: *message* | -| [Fatal error C1190](fatal-error-c1190.md) | managed targeted code requires a '`/clr`' option | +| [Fatal error C1190](fatal-error-c1190.md) | `System::Object` not found, missing `/clr` option or missing import of standard assemblies? | | [Fatal error C1191](fatal-error-c1191.md) | '*file*' can only be imported at global scope | | [Fatal error C1192](fatal-error-c1192.md) | `#using` failed on '*file*' | | Fatal error C1193 | an error expected in *file*(*line*) not reached | @@ -153,6 +155,7 @@ The articles in this section of the documentation explain a subset of the error | Fatal error C1212 | Input file was modified by another process while building: '*filename*' | | Fatal error C1213 | Header units are unsupported without `/Zc:preprocessor` | | Fatal error C1214 | Modules conflict with non-standard behavior requested via '*option*' | +| Fatal error C1215 | Cannot open file '*filename*' corresponding to warning set '`-W`*warning set*' | | Fatal error C1300 | error accessing program database *file* (*message*) | | Fatal error C1301 | error accessing program database *file*, invalid format, please delete and rebuild | | Fatal error C1302 | no profile data for module '*module*' in profile database '*file*' | diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1001.md b/docs/error-messages/compiler-errors-1/fatal-error-c1001.md index d2dc62f249f..bcf89b5bd87 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1001.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1001.md @@ -1,15 +1,16 @@ --- -description: "Learn more about: Fatal Error C1001" title: "Fatal Error C1001" -ms.date: "11/04/2016" +description: "Learn more about: Fatal Error C1001" +ms.date: 11/04/2016 f1_keywords: ["C1001"] helpviewer_keywords: ["C1001"] -ms.assetid: 5736cdb3-22c8-4fad-aa85-d5e0d2b232f4 --- # Fatal Error C1001 > INTERNAL COMPILER ERROR(compiler file *file*, line *number*) +## Remarks + The compiler cannot generate correct code for a construct, often due to the combination of a particular expression and an optimization option, or an issue in parsing. If the compiler file listed has a utc or C2 path segment, it is probably an optimization error. If the file has a cxxfe or c1xx path segment, or is msc1.cpp, it is probably a parser error. If the file named is cl.exe, there is no other information available. You can often fix an optimization problem by removing one or more optimization options. To determine which option is at fault, remove options one at a time and recompile until the error message goes away. The options most commonly responsible are [/Og (Global optimizations)](../../build/reference/og-global-optimizations.md) and [/Oi (Generate Intrinsic Functions)](../../build/reference/oi-generate-intrinsic-functions.md). Once you determine which optimization option is responsible, you can disable it around the function where the error occurs by using the [optimize](../../preprocessor/optimize.md) pragma, and continue to use the option for the rest of the module. For more information about optimization options, see [Optimization best practices](../../build/optimization-best-practices.md). diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1002.md b/docs/error-messages/compiler-errors-1/fatal-error-c1002.md index c001659abf6..d254d4e5ced 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1002.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1002.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Fatal Error C1002" title: "Fatal Error C1002" -ms.date: "11/04/2016" +description: "Learn more about: Fatal Error C1002" +ms.date: 11/04/2016 f1_keywords: ["C1002"] helpviewer_keywords: ["C1002"] -ms.assetid: bd6d274a-c7b4-43af-8bf2-23c5e442aa22 --- # Fatal Error C1002 -compiler is out of heap space in pass 2 +> compiler is out of heap space in pass 2 + +## Remarks The compiler ran out of dynamic memory space during its second pass, probably due to a program with too many symbols or complex expressions. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1003.md b/docs/error-messages/compiler-errors-1/fatal-error-c1003.md index 651a5259eac..453e163d0d4 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1003.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1003.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Fatal Error C1003" title: "Fatal Error C1003" -ms.date: "11/04/2016" +description: "Learn more about: Fatal Error C1003" +ms.date: 11/04/2016 f1_keywords: ["C1003"] helpviewer_keywords: ["C1003"] -ms.assetid: 27d2d009-2e0f-41fb-8bfc-372752fbe920 --- # Fatal Error C1003 -error count exceeds number; stopping compilation +> error count exceeds number; stopping compilation + +## Remarks Errors in the program are too numerous to allow recovery. The compiler must terminate. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1004.md b/docs/error-messages/compiler-errors-1/fatal-error-c1004.md index 266090b83c3..e611dbbc9ed 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1004.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1004.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Fatal Error C1004" title: "Fatal Error C1004" -ms.date: "11/04/2016" +description: "Learn more about: Fatal Error C1004" +ms.date: 11/04/2016 f1_keywords: ["C1004"] helpviewer_keywords: ["C1004"] -ms.assetid: dbe034b0-6eb0-41b4-a50c-2fccf9e78ad4 --- # Fatal Error C1004 -unexpected end of file found +> unexpected end of file found + +## Remarks The compiler reached the end of a source file without resolving a construct. The code may be missing one of the following elements: @@ -28,7 +29,9 @@ To resolve this error, check for the following: - A source file does not end with a carriage return and line feed. -The following sample generates C1004: +## Example + +The following example generates C1004: ```cpp // C1004.cpp diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1005.md b/docs/error-messages/compiler-errors-1/fatal-error-c1005.md index cbb2d4aa5b2..2d2a87369b9 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1005.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1005.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Fatal Error C1005" title: "Fatal Error C1005" -ms.date: "11/04/2016" +description: "Learn more about: Fatal Error C1005" +ms.date: 11/04/2016 f1_keywords: ["C1005"] helpviewer_keywords: ["C1005"] -ms.assetid: 150daf8e-a38a-4669-9c1a-a05b5a1f65ef --- # Fatal Error C1005 -string too big for buffer +> string too big for buffer + +## Remarks A string in a compiler intermediate file overflowed a buffer. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1007.md b/docs/error-messages/compiler-errors-1/fatal-error-c1007.md index 23d81272a56..55a3c31b1da 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1007.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1007.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Fatal Error C1007" title: "Fatal Error C1007" -ms.date: "11/04/2016" +description: "Learn more about: Fatal Error C1007" +ms.date: 11/04/2016 f1_keywords: ["C1007"] helpviewer_keywords: ["C1007"] -ms.assetid: 224f7e2c-4522-4e09-b455-8d293bdb799d --- # Fatal Error C1007 -unrecognized flag string in option +> unrecognized flag string in option + +## Remarks The command-line option contains an invalid string. Check the **CL** command line and environment variable for errors. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1008.md b/docs/error-messages/compiler-errors-1/fatal-error-c1008.md index df73ac1ebd3..1ad6c868baf 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1008.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1008.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Fatal Error C1008" title: "Fatal Error C1008" -ms.date: "11/04/2016" +description: "Learn more about: Fatal Error C1008" +ms.date: 11/04/2016 f1_keywords: ["C1008"] helpviewer_keywords: ["C1008"] -ms.assetid: 7de729e3-b2ca-4a68-95ab-8a1c920f3f2c --- # Fatal Error C1008 -no input file specified +> no input file specified + +## Remarks The compiler was not given a C or C++ source file to compile. Check the **CL** command line and environment variable for filename specifications. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1009.md b/docs/error-messages/compiler-errors-1/fatal-error-c1009.md index 358d670bec1..5ba6678782b 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1009.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1009.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Fatal Error C1009" title: "Fatal Error C1009" -ms.date: "11/04/2016" +description: "Learn more about: Fatal Error C1009" +ms.date: 11/04/2016 f1_keywords: ["C1009"] helpviewer_keywords: ["C1009"] -ms.assetid: dcc8383c-3362-4c47-9c26-25d2451ebd53 --- # Fatal Error C1009 -compiler limit : macros nested too deeply +> compiler limit : macros nested too deeply + +## Remarks The compiler tried to expand too many macros at the same time. The compiler has a limit of 256 levels of nested macros. Split nested macros into simpler macros. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1010.md b/docs/error-messages/compiler-errors-1/fatal-error-c1010.md index 775bed37190..eb64115ebd9 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1010.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1010.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Fatal Error C1010" title: "Fatal Error C1010" -ms.date: "09/03/2019" +description: "Learn more about: Fatal Error C1010" +ms.date: 09/03/2019 f1_keywords: ["C1010"] helpviewer_keywords: ["C1010"] -ms.assetid: dfd035f1-a7a2-40bc-bc92-dc4d7f456767 --- # Fatal Error C1010 diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1011.md b/docs/error-messages/compiler-errors-1/fatal-error-c1011.md index b7517a9e35e..b50d6450ef6 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1011.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1011.md @@ -1,6 +1,6 @@ --- -description: "Learn more about: Fatal Error C1011" title: "Fatal Error C1011" +description: "Learn more about: Fatal Error C1011" ms.date: 08/17/2022 f1_keywords: ["C1011"] helpviewer_keywords: ["C1011"] diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1012.md b/docs/error-messages/compiler-errors-1/fatal-error-c1012.md index 3de04be3d2c..33245ef2b6c 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1012.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1012.md @@ -1,13 +1,25 @@ --- -description: "Learn more about: Fatal Error C1012" title: "Fatal Error C1012" -ms.date: "11/04/2016" +description: "Learn more about: Fatal Error C1012" +ms.date: 02/20/2025 f1_keywords: ["C1012"] helpviewer_keywords: ["C1012"] -ms.assetid: 92cc83a7-b5b8-4da8-a128-9b7ccb510496 --- # Fatal Error C1012 -unmatched parenthesis : missing character +> unmatched parenthesis: missing 'character' + +## Remarks The parentheses in a preprocessor directive do not match. + +## Example + +The following example generates C1012: + +```cpp +// C1012.cpp +// compile with: /c +#if (0 // C1012 +#endif +``` diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1013.md b/docs/error-messages/compiler-errors-1/fatal-error-c1013.md index c8950e24e8a..f0f85a0ee1a 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1013.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1013.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Fatal Error C1013" title: "Fatal Error C1013" -ms.date: "11/04/2016" +description: "Learn more about: Fatal Error C1013" +ms.date: 11/04/2016 f1_keywords: ["C1013"] helpviewer_keywords: ["C1013"] -ms.assetid: 5514a679-efe7-4055-bdd3-5693ca0c332f --- # Fatal Error C1013 -compiler limit : too many open parentheses +> compiler limit : too many open parentheses + +## Remarks An expression contains too many levels of parentheses in a single expression. Simplify the expression or break it into multiple statements. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1014.md b/docs/error-messages/compiler-errors-1/fatal-error-c1014.md index 084aa82fad9..678465c1973 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1014.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1014.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Fatal Error C1014" title: "Fatal Error C1014" -ms.date: "11/04/2016" +description: "Learn more about: Fatal Error C1014" +ms.date: 11/04/2016 f1_keywords: ["C1014"] helpviewer_keywords: ["C1014"] -ms.assetid: 4c01ef70-e765-4d07-a3fe-a11c19fb610b --- # Fatal Error C1014 -too many include files : depth = level +> too many include files : depth = level + +## Remarks The nesting of `#include` directives is too deep. Nested directives can include open files. The source file containing the directive counts as one file. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-C1015.md b/docs/error-messages/compiler-errors-1/fatal-error-c1015.md similarity index 98% rename from docs/error-messages/compiler-errors-1/fatal-error-C1015.md rename to docs/error-messages/compiler-errors-1/fatal-error-c1015.md index e4072713895..7b161e0ef81 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-C1015.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1015.md @@ -1,6 +1,6 @@ --- -description: "Learn more about: Fatal Error C1015" title: "Fatal Error C1015" +description: "Learn more about: Fatal Error C1015" ms.date: 08/17/2022 f1_keywords: ["C1015"] helpviewer_keywords: ["C1015"] @@ -9,4 +9,6 @@ helpviewer_keywords: ["C1015"] > header-names '*header-name*' and '*header-name*' identify the same header and cannot be used as both `/headerUnit:quote` and `/headerUnit:angle` arguments; please provide this header-name only once +## Remarks + Don't include a header unit using both double-quotes and angle brackets. Use only one form, consistent with the **`/headerUnit:quote`** or **`/headerUnit:angle`** compiler option. For more information, see [`/headerUnit` (Use header unit IFC)](../../build/reference/headerunit.md). diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1016.md b/docs/error-messages/compiler-errors-1/fatal-error-c1016.md index c921566c37a..5dc38afa6a8 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1016.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1016.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Fatal Error C1016" title: "Fatal Error C1016" -ms.date: "11/04/2016" +description: "Learn more about: Fatal Error C1016" +ms.date: 11/04/2016 f1_keywords: ["C1016"] helpviewer_keywords: ["C1016"] -ms.assetid: 33f45c3e-2d8f-43ad-a445-c412d1d54ce1 --- # Fatal Error C1016 -\#ifdef expected an identifier#ifndef expected an identifier +> #ifdef expected an identifier#ifndef expected an identifier + +## Remarks The conditional compilation directive ([#ifdef](../../preprocessor/hash-ifdef-and-hash-ifndef-directives-c-cpp.md) or `#ifndef`) has no identifier to evaluate. To resolve the error, specify an identifier. -The following sample generates C1016: +## Example + +The following example generates C1016: ```cpp // C1016.cpp diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1017.md b/docs/error-messages/compiler-errors-1/fatal-error-c1017.md index cd6fbcbc772..7ae9f9c0d6a 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1017.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1017.md @@ -1,20 +1,23 @@ --- -description: "Learn more about: Fatal Error C1017" title: "Fatal Error C1017" -ms.date: "11/04/2016" +description: "Learn more about: Fatal Error C1017" +ms.date: 11/04/2016 f1_keywords: ["C1017"] helpviewer_keywords: ["C1017"] -ms.assetid: 5542e604-599d-4e36-8f83-1d454c5753c9 --- # Fatal Error C1017 -invalid integer constant expression +> invalid integer constant expression + +## Remarks The expression in an `#if` directive did not exist or did not evaluate to a constant. Constants defined using `#define` must have values that evaluate to an integer constant if they are used in an `#if`, `#elif`, or `#else` directive. -The following sample generates C1017: +## Example + +The following example generates C1017: ```cpp // C1017.cpp @@ -35,7 +38,7 @@ Possible resolution: Because `CONSTANT_NAME` evaluates to a string and not an integer, the `#if` directive generates fatal error C1017. -In other cases, the preprocessor evaluates an undefined constant as zero. This can cause unintended results, as shown in the following sample. `YES` is undefined, so it evaluates to zero. The expression `#if` `CONSTANT_NAME` evaluates to false and the code to be used on `YES` is removed by the preprocessor. `NO` is also undefined (zero), so `#elif` `CONSTANT_NAME==NO` evaluates to true (`0 == 0`), causing the preprocessor to leave the code in the `#elif` portion of the statement — exactly the opposite of the intended behavior. +In other cases, the preprocessor evaluates an undefined constant as zero. This can cause unintended results, as shown in the following example. `YES` is undefined, so it evaluates to zero. The expression `#if` `CONSTANT_NAME` evaluates to false and the code to be used on `YES` is removed by the preprocessor. `NO` is also undefined (zero), so `#elif` `CONSTANT_NAME==NO` evaluates to true (`0 == 0`), causing the preprocessor to leave the code in the `#elif` portion of the statement — exactly the opposite of the intended behavior. ```cpp // C1017c.cpp diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1018.md b/docs/error-messages/compiler-errors-1/fatal-error-c1018.md index 4283dedc9d1..6a4fd9b145c 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1018.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1018.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Fatal Error C1018" title: "Fatal Error C1018" -ms.date: "11/04/2016" +description: "Learn more about: Fatal Error C1018" +ms.date: 11/04/2016 f1_keywords: ["C1018"] helpviewer_keywords: ["C1018"] -ms.assetid: 2ceb8a99-30b2-4b80-bf42-e9f3305b3c52 --- # Fatal Error C1018 -unexpected #elif +> unexpected #elif + +## Remarks The `#elif` directive appears outside an `#if`, `#ifdef`, or `#ifndef` construct. Use `#elif` only within one of these constructs. -The following sample generates C1018: +## Example + +The following example generates C1018: ```cpp // C1018.cpp diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1019.md b/docs/error-messages/compiler-errors-1/fatal-error-c1019.md index 5d51ab87de9..b03103db4e3 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1019.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1019.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Fatal Error C1019" title: "Fatal Error C1019" -ms.date: "11/04/2016" +description: "Learn more about: Fatal Error C1019" +ms.date: 11/04/2016 f1_keywords: ["C1019"] helpviewer_keywords: ["C1019"] -ms.assetid: c4f8968b-bc62-4200-b3ca-69d06c163236 --- # Fatal Error C1019 -unexpected #else +> unexpected #else + +## Remarks The `#else` directive appears outside an `#if`, `#ifdef`, or `#ifndef` construct. Use `#else` only within one of these constructs. -The following sample generates C1019: +## Example + +The following example generates C1019: ```cpp // C1019.cpp diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1020.md b/docs/error-messages/compiler-errors-1/fatal-error-c1020.md index 1fb7fcdb590..877bba743f4 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1020.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1020.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Fatal Error C1020" title: "Fatal Error C1020" +description: "Learn more about: Fatal Error C1020" ms.date: 07/11/2022 f1_keywords: ["C1020"] helpviewer_keywords: ["C1020"] -ms.assetid: 42f429e2-5e3b-4086-a10d-b99e032e51c5 --- # Fatal Error C1020 @@ -16,9 +15,9 @@ The `#endif` directive has no matching `#if`, `#ifdef`, or `#ifndef` directive. This error can occur if you have conditional preprocessor directives before you include a precompiled header file. The compiler ignores everything in the file before the precompiled header, including any `#if`, `#ifdef`, or `#ifndef` directives. For more information, see [`/Yu` (Use precompiled header)](../../build/reference/yu-use-precompiled-header-file.md). -## Examples +## Example -The following sample generates C1020: +The following example generates C1020: ```cpp // C1020.cpp diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1021.md b/docs/error-messages/compiler-errors-1/fatal-error-c1021.md index 352339095ed..4e45879b395 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1021.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1021.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Fatal Error C1021" title: "Fatal Error C1021" -ms.date: "11/04/2016" +description: "Learn more about: Fatal Error C1021" +ms.date: 11/04/2016 f1_keywords: ["C1021"] helpviewer_keywords: ["C1021"] -ms.assetid: e23171f4-ca6b-40c0-a913-a2edc6fa3766 --- # Fatal Error C1021 -invalid preprocessor command 'string' +> invalid preprocessor command 'string' + +## Remarks `string` is not a valid [preprocessor directive](../../preprocessor/preprocessor-directives.md). To resolve the error, use a valid preprocessor name for `string`. -The following sample generates C1021: +## Example + +The following example generates C1021: ```cpp // C1021.cpp diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1022.md b/docs/error-messages/compiler-errors-1/fatal-error-c1022.md index 043664fee8b..365d7c9b8f5 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1022.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1022.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Fatal Error C1022" title: "Fatal Error C1022" -ms.date: "11/04/2016" +description: "Learn more about: Fatal Error C1022" +ms.date: 11/04/2016 f1_keywords: ["C1022"] helpviewer_keywords: ["C1022"] -ms.assetid: edada720-dc73-49bc-bd93-a7945a316312 --- # Fatal Error C1022 -expected #endif +> expected #endif + +## Remarks An `#if`, `#ifdef`, or `#ifndef` directive has no matching `#endif` directive. Be sure each `#if`, `#ifdef`, or `#ifndef` has a matching `#endif`. -The following sample generates C1022: +## Example + +The following example generates C1022: ```cpp // C1022.cpp diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1023.md b/docs/error-messages/compiler-errors-1/fatal-error-c1023.md index ccfc54d80c6..48c1c71a23d 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1023.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1023.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Fatal Error C1023" title: "Fatal Error C1023" -ms.date: "11/04/2016" +description: "Learn more about: Fatal Error C1023" +ms.date: 11/04/2016 f1_keywords: ["C1023"] helpviewer_keywords: ["C1023"] -ms.assetid: 727b4070-7474-420b-ab11-6530f96c794f --- # Fatal Error C1023 -'file' : unexpected error with pch, try rebuilding the pch +> 'file' : unexpected error with pch, try rebuilding the pch + +## Remarks C1023 could be caused by one of several problems, the solution to which is a rebuild of the precompiled header file. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1025-c1115.md b/docs/error-messages/compiler-errors-1/fatal-error-c1025-c1115.md index caf838ff182..cd5353d6cfa 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1025-c1115.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1025-c1115.md @@ -1,6 +1,6 @@ --- -description: "Learn more about: Fatal Error C1025, C1115" title: "Fatal Error C1025, C1115" +description: "Learn more about: Fatal Error C1025, C1115" ms.date: 08/17/2022 f1_keywords: ["C1025", "C1115"] helpviewer_keywords: ["C1025", "C1115"] @@ -9,4 +9,6 @@ helpviewer_keywords: ["C1025", "C1115"] > too many nested lambdas +## Remarks + The compiler detected more than an internal limit for nested lambdas in the same scope. The limit is 65,535 in recent versions of Visual Studio. To resolve this issue, reduce the number of nested lambdas in the current scope. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1026.md b/docs/error-messages/compiler-errors-1/fatal-error-c1026.md index b210727debf..adc8b235f2b 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1026.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1026.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Fatal Error C1026" title: "Fatal Error C1026" -ms.date: "11/04/2016" +description: "Learn more about: Fatal Error C1026" +ms.date: 11/04/2016 f1_keywords: ["C1026"] helpviewer_keywords: ["C1026"] -ms.assetid: 89bb9d40-673a-44aa-a9f4-b42c07b49d44 --- # Fatal Error C1026 -parser stack overflow, program too complex +> parser stack overflow, program too complex + +## Remarks The space required to parse the program caused a compiler stack overflow. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1033.md b/docs/error-messages/compiler-errors-1/fatal-error-c1033.md index 74b6260d6d9..5e5ab6734b9 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1033.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1033.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Fatal Error C1033" title: "Fatal Error C1033" -ms.date: "11/04/2016" +description: "Learn more about: Fatal Error C1033" +ms.date: 11/04/2016 f1_keywords: ["C1033"] helpviewer_keywords: ["C1033"] -ms.assetid: 09976c03-8450-4cf7-8b43-1b91c2c2b9f9 --- # Fatal Error C1033 -cannot open program database pdb +> cannot open program database pdb + +## Remarks This error can be caused by a disk error, a temporary lock created by an anti-virus program, a previous debugger instance that has not fully shut down, or parallel build mspdbsrv.exe processes that attempt to access the same file, among other possible causes. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1035.md b/docs/error-messages/compiler-errors-1/fatal-error-c1035.md index b41d21a1702..ddeb60ad0fc 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1035.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1035.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Fatal Error C1035" title: "Fatal Error C1035" -ms.date: "11/04/2016" +description: "Learn more about: Fatal Error C1035" +ms.date: 11/04/2016 f1_keywords: ["C1035"] helpviewer_keywords: ["C1035"] -ms.assetid: 28cdccee-4377-4823-a4d8-89ca7229a83e --- # Fatal Error C1035 -expression too complex; simplify expression +> expression too complex; simplify expression + +## Remarks The compiler could not generate code for a complex expression. Split the expression into simpler expressions and recompile. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1037.md b/docs/error-messages/compiler-errors-1/fatal-error-c1037.md index 80eecc85dfe..ccc83f0680e 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1037.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1037.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Fatal Error C1037" title: "Fatal Error C1037" -ms.date: "11/04/2016" +description: "Learn more about: Fatal Error C1037" +ms.date: 11/04/2016 f1_keywords: ["C1037"] helpviewer_keywords: ["C1037"] -ms.assetid: 79103bca-ccfb-42e7-aef9-9b90c15b162f --- # Fatal Error C1037 -cannot open object file filename +> cannot open object file filename + +## Remarks The object file specified by [/Fo](../../build/reference/fo-object-file-name.md) cannot be opened. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1038.md b/docs/error-messages/compiler-errors-1/fatal-error-c1038.md index fd563949b88..ac3e9b80f8d 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1038.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1038.md @@ -1,15 +1,16 @@ --- -description: "Learn more about: Fatal Error C1038" title: "Fatal Error C1038" +description: "Learn more about: Fatal Error C1038" ms.date: 08/17/2022 f1_keywords: ["C1038"] helpviewer_keywords: ["C1038"] -ms.assetid: 560dccb8-5b45-46f0-9412-caa4a6172aef --- # Fatal Error C1038 > compiler limit : function : control flow state too complex; simplify function +## Remarks + The function has more control-flow states than the compiler can handle. Simplify control flow or split the function into smaller functions. This error is obsolete in Visual Studio 2022 and later versions. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1045.md b/docs/error-messages/compiler-errors-1/fatal-error-c1045.md index ec28119696b..5251ca128ef 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1045.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1045.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Fatal Error C1045" title: "Fatal Error C1045" -ms.date: "11/04/2016" +description: "Learn more about: Fatal Error C1045" +ms.date: 11/04/2016 f1_keywords: ["C1045"] helpviewer_keywords: ["C1045"] -ms.assetid: 766c2f89-4ecd-4281-adaa-14b270cc0829 --- # Fatal Error C1045 -compiler limit : linkage specifications nested too deeply +> compiler limit : linkage specifications nested too deeply + +## Remarks Nested externals exceed the compiler limit. Nested externals are allowed with the external linkage type, such as **`extern`** "C++". Reduce the number of nested externals to resolve the error. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1046.md b/docs/error-messages/compiler-errors-1/fatal-error-c1046.md index 94f902b2fda..66d20348517 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1046.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1046.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Fatal Error C1046" title: "Fatal Error C1046" -ms.date: "11/04/2016" +description: "Learn more about: Fatal Error C1046" +ms.date: 11/04/2016 f1_keywords: ["C1046"] helpviewer_keywords: ["C1046"] -ms.assetid: 822ec5f5-b0b0-4711-99e1-fc237b619af6 --- # Fatal Error C1046 -compiler limit : structure nested too deeply +> compiler limit : structure nested too deeply + +## Remarks The structure, union, or class exceeded the nesting limit, which is 15 levels. Rewrite the definition to reduce the nesting level. Split the structure, union, or class into two or more parts by using **`typedef`** to define one or more of the nested structures. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1047.md b/docs/error-messages/compiler-errors-1/fatal-error-c1047.md index c868dfe4150..caf2bd6d441 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1047.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1047.md @@ -1,6 +1,6 @@ --- -description: "Learn more about: Fatal Error C1047" title: "Fatal Error C1047" +description: "Learn more about: Fatal Error C1047" ms.date: 10/22/2021 f1_keywords: ["C1047"] helpviewer_keywords: ["C1047"] diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1049.md b/docs/error-messages/compiler-errors-1/fatal-error-c1049.md index 658e780882f..81455150da0 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1049.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1049.md @@ -1,7 +1,7 @@ --- title: "Fatal Error C1049" description: "Describes compiler fatal error C1049, invalid numerical argument, and explains how to resolve it." -ms.date: "11/04/2019" +ms.date: 11/04/2019 f1_keywords: ["C1049"] helpviewer_keywords: ["C1049"] --- @@ -9,6 +9,8 @@ helpviewer_keywords: ["C1049"] > invalid numerical argument '*value*' +## Remarks + The CL.EXE command-line parser found *value* where it was expecting a numerical argument. A C1049 error may occur when the compiler can't find a numerical argument for one of these compiler options: diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1051.md b/docs/error-messages/compiler-errors-1/fatal-error-c1051.md index da1b46802d4..d2aab16d092 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1051.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1051.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Fatal Error C1051" title: "Fatal Error C1051" -ms.date: "11/04/2016" +description: "Learn more about: Fatal Error C1051" +ms.date: 11/04/2016 f1_keywords: ["C1051"] helpviewer_keywords: ["C1051"] -ms.assetid: 87dcbd3b-0952-499a-bd42-64f9e8de2605 --- # Fatal Error C1051 -program database file, 'pdbfile', has an obsolete format, delete it and recompile +> program database file, 'pdbfile', has an obsolete format, delete it and recompile + +## Remarks The compiler cannot update the program database file, which has an older version number. Delete the file and recompile your program with **/Zi** or **/ZI**. For more information, see [/Z7, /Zi, /ZI (Debug Information Format)](../../build/reference/z7-zi-zi-debug-information-format.md) diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1052.md b/docs/error-messages/compiler-errors-1/fatal-error-c1052.md index 7a564c3f29f..37f4cfe70cf 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1052.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1052.md @@ -1,15 +1,16 @@ --- -description: "Learn more about: Fatal Error C1052" title: "Fatal Error C1052" -ms.date: "05/08/2017" +description: "Learn more about: Fatal Error C1052" +ms.date: 05/08/2017 f1_keywords: ["C1052"] helpviewer_keywords: ["C1052"] -ms.assetid: f2c09a2f-d3c1-4420-9501-ffcb65caf87b --- # Fatal Error C1052 > program database file, '*filename*', was generated by the linker with /DEBUG:fastlink; compiler cannot update such PDB files; please delete it or use /Fd to specify a different PDB filename +## Remarks + The compiler cannot update the same program database (PDB) files which are generated by the linker when the [/DEBUG:fastlink](../../build/reference/debug-generate-debug-info.md) option is specified. Normally the compiler-generated PDB files and the linker-generated PDB files have different names. However, if they are set to use the same names, this error can result. To fix this issue, you can explicitly delete the PDB files before you compile again, or you can create different names for the compiler-generated and linker-generated PDB files. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1053.md b/docs/error-messages/compiler-errors-1/fatal-error-c1053.md index b97c1b622f9..111e9c5fcb5 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1053.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1053.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Fatal Error C1053" title: "Fatal Error C1053" -ms.date: "11/04/2016" +description: "Learn more about: Fatal Error C1053" +ms.date: 11/04/2016 f1_keywords: ["C1053"] helpviewer_keywords: ["C1053"] -ms.assetid: f50c1c6a-d9cc-42fa-984e-4e2e6e9cd1b1 --- # Fatal Error C1053 -'\' : function too large +> '\' : function too large + +## Remarks The function is too large to compile. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1054.md b/docs/error-messages/compiler-errors-1/fatal-error-c1054.md index ff4963cff7c..826abb49061 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1054.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1054.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Fatal Error C1054" title: "Fatal Error C1054" -ms.date: "11/04/2016" +description: "Learn more about: Fatal Error C1054" +ms.date: 11/04/2016 f1_keywords: ["C1054"] helpviewer_keywords: ["C1054"] -ms.assetid: 9cfb7307-b22a-4418-b7c0-2621b0ab5b1b --- # Fatal Error C1054 -compiler limit : initializers nested too deeply +> compiler limit : initializers nested too deeply + +## Remarks The code exceeds the nesting limit on initializers (10-15 levels, depending on the combination of types being initialized). diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1055.md b/docs/error-messages/compiler-errors-1/fatal-error-c1055.md index b60f41acd71..d3106aef984 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1055.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1055.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Fatal Error C1055" title: "Fatal Error C1055" -ms.date: "11/04/2016" +description: "Learn more about: Fatal Error C1055" +ms.date: 11/04/2016 f1_keywords: ["C1055"] helpviewer_keywords: ["C1055"] -ms.assetid: a9fb9190-d7eb-4d5f-b1a2-a41e584a28c1 --- # Fatal Error C1055 -compiler limit : out of keys +> compiler limit : out of keys + +## Remarks The source file contains too many symbols. The compiler ran out of hash keys for the symbol table. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1057.md b/docs/error-messages/compiler-errors-1/fatal-error-c1057.md index 238df928a73..646398bb393 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1057.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1057.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Fatal Error C1057" title: "Fatal Error C1057" -ms.date: "11/04/2016" +description: "Learn more about: Fatal Error C1057" +ms.date: 11/04/2016 f1_keywords: ["C1057"] helpviewer_keywords: ["C1057"] -ms.assetid: 1e67e727-963d-42c5-8c32-c0e370d32735 --- # Fatal Error C1057 -unexpected end of file in macro expansion +> unexpected end of file in macro expansion + +## Remarks The compiler reached the end of the source file while gathering macro-invocation arguments, probably due to a missing right parenthesis in the macro invocation. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1060.md b/docs/error-messages/compiler-errors-1/fatal-error-c1060.md index 60e1f7a1e32..d3d409b2d1a 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1060.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1060.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Fatal Error C1060" title: "Fatal Error C1060" -ms.date: "11/04/2016" +description: "Learn more about: Fatal Error C1060" +ms.date: 11/04/2016 f1_keywords: ["C1060"] helpviewer_keywords: ["C1060"] -ms.assetid: feaf305c-c84c-4160-b974-50e283412849 --- # Fatal Error C1060 -compiler is out of heap space +> compiler is out of heap space + +## Remarks The operating system or run-time library cannot fill a request for memory. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1061.md b/docs/error-messages/compiler-errors-1/fatal-error-c1061.md index 9e17fd39f86..96b7691a600 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1061.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1061.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Fatal Error C1061" title: "Fatal Error C1061" -ms.date: "11/04/2016" +description: "Learn more about: Fatal Error C1061" +ms.date: 11/04/2016 f1_keywords: ["C1061"] helpviewer_keywords: ["C1061"] -ms.assetid: 9366c0bc-96e0-4967-aa7d-4ebf098de806 --- # Fatal Error C1061 -compiler limit : blocks nested too deeply +> compiler limit : blocks nested too deeply + +## Remarks Nesting of code blocks exceeds the limit of 128 nesting levels. This is a hard limit in the compiler for both C and C++, in both the 32-bit and 64-bit tool set. The count of nesting levels can be increased by anything that creates a scope or block. For example, namespaces, using directives, preprocessor expansions, template expansion, exception handling, loop constructs, and else-if clauses can all increase the nesting level seen by the compiler. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1064.md b/docs/error-messages/compiler-errors-1/fatal-error-c1064.md index e3f16ff5dca..c1469fc91e9 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1064.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1064.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Fatal Error C1064" title: "Fatal Error C1064" -ms.date: "11/04/2016" +description: "Learn more about: Fatal Error C1064" +ms.date: 11/04/2016 f1_keywords: ["C1064"] helpviewer_keywords: ["C1064"] -ms.assetid: d4598a28-b8f6-4e78-a0c6-db324f5bdfc3 --- # Fatal Error C1064 -compiler limit : token overflowed internal buffer +> compiler limit : token overflowed internal buffer + +## Remarks An identifier exceeds the length of the internal buffer used for identifiers. Shorten the name. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1065.md b/docs/error-messages/compiler-errors-1/fatal-error-c1065.md index 2db2bf5c213..b0650fec32c 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1065.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1065.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Fatal Error C1065" title: "Fatal Error C1065" -ms.date: "11/04/2016" +description: "Learn more about: Fatal Error C1065" +ms.date: 11/04/2016 f1_keywords: ["C1065"] helpviewer_keywords: ["C1065"] -ms.assetid: 80a27e13-696d-4199-a284-0d6b07446ff3 --- # Fatal Error C1065 -compiler limit : out of tags +> compiler limit : out of tags + +## Remarks The source file contains more than 65,523 classes, structs, unions, namespaces, or enums. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1067.md b/docs/error-messages/compiler-errors-1/fatal-error-c1067.md index b9d556d5a6d..f9a3bfd24eb 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1067.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1067.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Fatal Error C1067" title: "Fatal Error C1067" -ms.date: "11/04/2016" +description: "Learn more about: Fatal Error C1067" +ms.date: 11/04/2016 f1_keywords: ["C1067"] helpviewer_keywords: ["C1067"] -ms.assetid: e2c94be6-4573-4571-aac9-73d657fe9f96 --- # Fatal Error C1067 -compiler limit : 64K limit on size of a type record has been exceeded +> compiler limit : 64K limit on size of a type record has been exceeded + +## Remarks This error could occur if a symbol has a decorated name exceeding 247 characters. To resolve, shorten the symbol name. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1068.md b/docs/error-messages/compiler-errors-1/fatal-error-c1068.md index ff9d25709d3..86414b26597 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1068.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1068.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Fatal Error C1068" title: "Fatal Error C1068" -ms.date: "11/04/2016" +description: "Learn more about: Fatal Error C1068" +ms.date: 11/04/2016 f1_keywords: ["C1068"] helpviewer_keywords: ["C1068"] -ms.assetid: 3b4abd16-4552-4900-84be-54f6ebb6c785 --- # Fatal Error C1068 -cannot open file 'file' +> cannot open file 'file' + +## Remarks Ensure that `file` is not in use by another program. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1070.md b/docs/error-messages/compiler-errors-1/fatal-error-c1070.md index a1cc8f0a774..df482bb1aad 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1070.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1070.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Fatal Error C1070" title: "Fatal Error C1070" -ms.date: "11/04/2016" +description: "Learn more about: Fatal Error C1070" +ms.date: 11/04/2016 f1_keywords: ["C1070"] helpviewer_keywords: ["C1070"] -ms.assetid: 1058269a-5db6-4c23-a97f-b5269eb9188b --- # Fatal Error C1070 -mismatched #if/#endif pair in file 'filename' +> mismatched #if/#endif pair in file 'filename' + +## Remarks An `#if`, `#ifdef`, or `#ifndef` directive has no corresponding `#endif`. -The following sample generates C1070: +## Example + +The following example generates C1070: ```cpp // C1070.cpp diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1071.md b/docs/error-messages/compiler-errors-1/fatal-error-c1071.md index 82f1926458f..bb3ba4b6f51 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1071.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1071.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Fatal Error C1071" title: "Fatal Error C1071" -ms.date: "11/04/2016" +description: "Learn more about: Fatal Error C1071" +ms.date: 11/04/2016 f1_keywords: ["C1071"] helpviewer_keywords: ["C1071"] -ms.assetid: 489f1786-370e-4ecd-af67-538fe6e5bd4e --- # Fatal Error C1071 -unexpected end of file found in comment +> unexpected end of file found in comment + +## Remarks The compiler reached the end of the file while scanning a comment. @@ -18,7 +19,9 @@ The compiler reached the end of the file while scanning a comment. 1. Missing newline character after a comment on the last line of a source file. -The following sample generates C1071: +## Example + +The following example generates C1071: ```cpp // C1071.cpp diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1073.md b/docs/error-messages/compiler-errors-1/fatal-error-c1073.md index 5bdfc8ee77d..8a58d0814ab 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1073.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1073.md @@ -1,15 +1,16 @@ --- -description: "Learn more about: Fatal Error C1073" title: "Fatal Error C1073" +description: "Learn more about: Fatal Error C1073" ms.date: 08/17/2022 f1_keywords: ["C1073"] helpviewer_keywords: ["C1073"] -ms.assetid: a946fcf1-674e-4a7a-a28c-b1effacbabe1 --- # Fatal Error C1073 > Internal error involving incremental compilation (compiler file '*filename*', line *number*) +## Remarks + Recompile the file without using incremental compilation. This error is obsolete in Visual Studio 2022 and later versions. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1074.md b/docs/error-messages/compiler-errors-1/fatal-error-c1074.md index 4058a24309d..0966a7fdc7c 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1074.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1074.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Fatal Error C1074" title: "Fatal Error C1074" -ms.date: "11/04/2016" +description: "Learn more about: Fatal Error C1074" +ms.date: 11/04/2016 f1_keywords: ["C1074"] helpviewer_keywords: ["C1074"] -ms.assetid: 979d4ab2-0f1a-472a-85f8-71f48297274f --- # Fatal Error C1074 -'IDB' is illegal extension for PDB file: filename +> 'IDB' is illegal extension for PDB file: filename + +## Remarks The compiler expects program databases to have the .pdb extension. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1075.md b/docs/error-messages/compiler-errors-1/fatal-error-c1075.md index e63540537d6..8ecce1735e7 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1075.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1075.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Fatal Error C1075" title: "Fatal Error C1075" -ms.date: "11/04/2016" +description: "Learn more about: Fatal Error C1075" +ms.date: 11/04/2016 f1_keywords: ["C1075"] helpviewer_keywords: ["C1075"] -ms.assetid: 69a74e3d-b53f-4526-a440-2c94e6403355 --- # Fatal Error C1075 -the left token was unmatched at the end of the file +> the left token was unmatched at the end of the file + +## Remarks The compiler expected matching *token* before it reached the end of file. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1076.md b/docs/error-messages/compiler-errors-1/fatal-error-c1076.md index 42d68e82109..e0851683ca6 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1076.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1076.md @@ -1,15 +1,16 @@ --- -description: "Learn more about: Fatal Error C1076" title: "Fatal Error C1076" -ms.date: "03/08/2019" +description: "Learn more about: Fatal Error C1076" +ms.date: 03/08/2019 f1_keywords: ["C1076"] helpviewer_keywords: ["C1076"] -ms.assetid: 84ac1180-3e8a-48e8-9f77-7f18a778b964 --- # Fatal Error C1076 > compiler limit : internal heap limit reached; use /Zm to specify a higher limit +## Remarks + This error can be caused by too many symbols, or too many template instantiations. Starting in Visual Studio 2015, this message may result from Windows virtual memory pressure caused by too many parallel build processes. In this case, the recommendation to use the **/Zm** option should be ignored unless you are using a `#pragma hdrstop` directive. To resolve this error: diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1077.md b/docs/error-messages/compiler-errors-1/fatal-error-c1077.md index a759bcabfab..fb66328c987 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1077.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1077.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Fatal Error C1077" title: "Fatal Error C1077" -ms.date: "11/04/2016" +description: "Learn more about: Fatal Error C1077" +ms.date: 11/04/2016 f1_keywords: ["C1077"] helpviewer_keywords: ["C1077"] -ms.assetid: 514d66f4-b512-479a-b793-ebf45c91e15b --- # Fatal Error C1077 -compiler limit : cannot have more than number command line options +> compiler limit : cannot have more than number command line options + +## Remarks The number of command-line options exceeds the internal limit. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1079.md b/docs/error-messages/compiler-errors-1/fatal-error-c1079.md index d66d45a5955..0b3c3710186 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1079.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1079.md @@ -1,15 +1,16 @@ --- -description: "Learn more about: Fatal Error C1079" title: "Fatal Error C1079" +description: "Learn more about: Fatal Error C1079" ms.date: 08/17/2022 f1_keywords: ["C1079"] helpviewer_keywords: ["C1079"] -ms.assetid: cf06a65a-f9a5-4bd8-8128-201a6cbe2113 --- # Fatal Error C1079 > compiler limit : PCH file size limit exceeded +## Remarks + The PCH file exceeds the 4 GB size limit. This error is obsolete in Visual Studio 2022 and later versions. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1080.md b/docs/error-messages/compiler-errors-1/fatal-error-c1080.md index c5d058e6e8a..3868560b97a 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1080.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1080.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Fatal Error C1080" title: "Fatal Error C1080" -ms.date: "11/04/2016" +description: "Learn more about: Fatal Error C1080" +ms.date: 11/04/2016 f1_keywords: ["C1080"] helpviewer_keywords: ["C1080"] -ms.assetid: 01e9e7c0-6a20-4539-b9d2-d27e7afcc8e6 --- # Fatal Error C1080 -compiler limit : command line option exceeded limit of number characters +> compiler limit : command line option exceeded limit of number characters + +## Remarks An argument passed to the compiler exceeds 256 characters. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1081.md b/docs/error-messages/compiler-errors-1/fatal-error-c1081.md index dabb2798dc7..8922f2cb05e 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1081.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1081.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Fatal Error C1081" title: "Fatal Error C1081" -ms.date: "11/04/2016" +description: "Learn more about: Fatal Error C1081" +ms.date: 11/04/2016 f1_keywords: ["C1081"] helpviewer_keywords: ["C1081"] -ms.assetid: e58adf17-cbe1-4955-a5c7-80622bbba249 --- # Fatal Error C1081 -'symbol': file name too long +> 'symbol': file name too long + +## Remarks The length of a file pathname exceeds `_MAX_PATH` (defined by STDLIB.h as 260 characters). Shorten the name of the file. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1082.md b/docs/error-messages/compiler-errors-1/fatal-error-c1082.md index ff154134ce9..c0052079a27 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1082.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1082.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Fatal Error C1082" title: "Fatal Error C1082" -ms.date: "11/04/2016" +description: "Learn more about: Fatal Error C1082" +ms.date: 11/04/2016 f1_keywords: ["C1082"] helpviewer_keywords: ["C1082"] -ms.assetid: 173179f1-1e14-4a91-9451-122f8a53c0b8 --- # Fatal Error C1082 -Cannot close filetype file: 'file': message +> Cannot close filetype file: 'file': message + +## Remarks If the message says "bad file number", the file may have been closing in the foreground while compiling in the background. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1083.md b/docs/error-messages/compiler-errors-1/fatal-error-c1083.md index 740cef07032..06c6ff63ab1 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1083.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1083.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: Fatal Error C1083" title: "Fatal Error C1083" -ms.date: "09/01/2017" +description: "Learn more about: Fatal Error C1083" +ms.date: 09/01/2017 f1_keywords: ["C1083"] helpviewer_keywords: ["C1083"] --- @@ -9,6 +9,8 @@ helpviewer_keywords: ["C1083"] > Cannot open *filetype* file: '*file*': *message* +## Remarks + The compiler generates a C1083 error when it can't find a file. There are many possible causes for this error. An incorrect include search path or missing or misnamed header files are the most common causes, but other file types and issues can also cause C1083. Here are some of the common reasons why the compiler generates this error. ## The specified file name is wrong diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1084.md b/docs/error-messages/compiler-errors-1/fatal-error-c1084.md index f4fc81eada9..d5cfb9d0bcd 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1084.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1084.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Fatal Error C1084" title: "Fatal Error C1084" -ms.date: "11/04/2016" +description: "Learn more about: Fatal Error C1084" +ms.date: 11/04/2016 f1_keywords: ["C1084"] helpviewer_keywords: ["C1084"] -ms.assetid: b2f273ef-3a14-4d5f-8ce0-7a11a0388fe6 --- # Fatal Error C1084 -Cannot read filetype file: 'file': message +> Cannot read filetype file: 'file': message + +## Remarks This error is generally the result of a failed internal system API call made by the compiler. The message shown when this error is encountered is often generated by either [_wcserror_s](../../c-runtime-library/reference/strerror-s-strerror-s-wcserror-s-wcserror-s.md) or [FormatMessage](/windows/win32/api/winbase/nf-winbase-formatmessage). diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1085.md b/docs/error-messages/compiler-errors-1/fatal-error-c1085.md index dd3fff0adf3..b7a9acd4f40 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1085.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1085.md @@ -1,14 +1,13 @@ --- -description: "Learn more about: Fatal Error C1085" title: "Fatal Error C1085" -ms.date: "11/04/2016" +description: "Learn more about: Fatal Error C1085" +ms.date: 11/04/2016 f1_keywords: ["C1085"] helpviewer_keywords: ["C1085"] -ms.assetid: f2766365-d09b-4299-8a98-12e5aca98568 --- # Fatal Error C1085 -Cannot write filetype file: 'file': message +> Cannot write filetype file: 'file': message ### To fix by checking the following possible causes diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1086.md b/docs/error-messages/compiler-errors-1/fatal-error-c1086.md index f5686a8a742..d89d6f0efb4 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1086.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1086.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Fatal Error C1086" title: "Fatal Error C1086" -ms.date: "11/04/2016" +description: "Learn more about: Fatal Error C1086" +ms.date: 11/04/2016 f1_keywords: ["C1086"] helpviewer_keywords: ["C1086"] -ms.assetid: 8e3c32c9-cafe-48bf-87bf-f70a1f0367f0 --- # Fatal Error C1086 -Cannot seek filetype file: 'file': message +> Cannot seek filetype file: 'file': message + +## Remarks The compiler cannot complete an I/O operation. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1087.md b/docs/error-messages/compiler-errors-1/fatal-error-c1087.md index 80fd48be9c6..84d1dd3314f 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1087.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1087.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Fatal Error C1087" title: "Fatal Error C1087" -ms.date: "11/04/2016" +description: "Learn more about: Fatal Error C1087" +ms.date: 11/04/2016 f1_keywords: ["C1087"] helpviewer_keywords: ["C1087"] -ms.assetid: 2fb4c14e-c6ea-45e4-8ce5-a51d15811a01 --- # Fatal Error C1087 -Cannot tell filetype file: 'file': message +> Cannot tell filetype file: 'file': message + +## Remarks The compiler cannot complete an I/O operation. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1088.md b/docs/error-messages/compiler-errors-1/fatal-error-c1088.md index f037f7af44f..8359676108d 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1088.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1088.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Fatal Error C1088" title: "Fatal Error C1088" -ms.date: "11/04/2016" +description: "Learn more about: Fatal Error C1088" +ms.date: 11/04/2016 f1_keywords: ["C1088"] helpviewer_keywords: ["C1088"] -ms.assetid: e61ebbb4-ab50-4a66-b2f6-3cc4400d8511 --- # Fatal Error C1088 -Cannot flush filetype file: 'file': message +> Cannot flush filetype file: 'file': message + +## Remarks The compiler cannot complete an I/O operation. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1089.md b/docs/error-messages/compiler-errors-1/fatal-error-c1089.md index 753f67e2f74..0b1c98a1e84 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1089.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1089.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Fatal Error C1089" title: "Fatal Error C1089" -ms.date: "11/04/2016" +description: "Learn more about: Fatal Error C1089" +ms.date: 11/04/2016 f1_keywords: ["C1089"] helpviewer_keywords: ["C1089"] -ms.assetid: c4f1e8e5-62c5-464a-9112-99b0790a0fb7 --- # Fatal Error C1089 -Cannot truncate filetype file: 'file': message +> Cannot truncate filetype file: 'file': message + +## Remarks The compiler cannot shrink a file to zero length. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1090.md b/docs/error-messages/compiler-errors-1/fatal-error-c1090.md index 3764f4cd32c..7602b777254 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1090.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1090.md @@ -1,6 +1,6 @@ --- -description: "Learn more about: Fatal Error C1090 PDB API call failed" title: "Fatal Error C1090" +description: "Learn more about: Fatal Error C1090 PDB API call failed" ms.date: 04/01/2021 f1_keywords: ["C1090"] helpviewer_keywords: ["C1090"] @@ -9,6 +9,8 @@ helpviewer_keywords: ["C1090"] > PDB API call failed, error code '*error-number*': *message* +## Remarks + An error occurred in processing a PDB file. Error C1090 is a catch-all for uncommon compiler PDB file errors that aren't reported separately. We only have generic advice for resolving this issue: diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1091.md b/docs/error-messages/compiler-errors-1/fatal-error-c1091.md index dfdc32778cd..fb5e7195d9b 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1091.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1091.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Fatal Error C1091" title: "Fatal Error C1091" -ms.date: "11/04/2016" +description: "Learn more about: Fatal Error C1091" +ms.date: 11/04/2016 f1_keywords: ["C1091"] helpviewer_keywords: ["C1091"] -ms.assetid: 812d4201-9154-48b0-b9af-5959c082ca33 --- # Fatal Error C1091 -compiler limit: string exceeds 'length' bytes in length +> compiler limit: string exceeds 'length' bytes in length + +## Remarks A string constant exceeded the current limit on the length of strings. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1092.md b/docs/error-messages/compiler-errors-1/fatal-error-c1092.md index 396f6b007a6..a34f58ab352 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1092.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1092.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Fatal Error C1092" title: "Fatal Error C1092" -ms.date: "11/04/2016" +description: "Learn more about: Fatal Error C1092" +ms.date: 11/04/2016 f1_keywords: ["C1092"] helpviewer_keywords: ["C1092"] -ms.assetid: bcaa87f0-fbfc-4a33-844b-3b9f5d67f279 --- # Fatal Error C1092 -Edit and Continue does not support changes to data types; build required +> Edit and Continue does not support changes to data types; build required + +## Remarks You changed or added a data type since the last successful build. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1093.md b/docs/error-messages/compiler-errors-1/fatal-error-c1093.md index 4d6e7437f7c..b975a6552d6 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1093.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1093.md @@ -1,15 +1,16 @@ --- -description: "Learn more about: Fatal Error C1093" title: "Fatal Error C1093" -ms.date: "11/04/2016" +description: "Learn more about: Fatal Error C1093" +ms.date: 11/04/2016 f1_keywords: ["C1093"] helpviewer_keywords: ["C1093"] -ms.assetid: 61b120e2-44cc-4824-981a-7eb72aa57745 --- # Fatal Error C1093 > API call '*function name*' failed '*location of call*' : '*text from run-time*' +## Remarks + A call to a .NET function failed. The *text from run-time* string may or may not be supplied by the COM runtime. For more information about system error messages, see the winerror.h system file, and [FormatMessage](/windows/win32/api/winbase/nf-winbase-formatmessage). diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1094.md b/docs/error-messages/compiler-errors-1/fatal-error-c1094.md index bc80c63eeb3..7bc3d767268 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1094.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1094.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Fatal Error C1094" title: "Fatal Error C1094" +description: "Learn more about: Fatal Error C1094" ms.date: 08/17/2022 f1_keywords: ["C1094"] helpviewer_keywords: ["C1094"] -ms.assetid: 9e1193b2-cb95-44f9-bf6f-019e0d41dd97 --- # Fatal Error C1094 @@ -16,7 +15,7 @@ The value that is passed to [`/Yc`](../../build/reference/yc-create-precompiled- ## Example -The following sample generates C1094: +The following example generates C1094: ``` // C1094.h diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1098.md b/docs/error-messages/compiler-errors-1/fatal-error-c1098.md index d28a67c5100..4a2b422fb33 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1098.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1098.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Fatal Error C1098" title: "Fatal Error C1098" -ms.date: "11/04/2016" +description: "Learn more about: Fatal Error C1098" +ms.date: 11/04/2016 f1_keywords: ["C1098"] helpviewer_keywords: ["C1098"] -ms.assetid: 09a1a14b-95bd-49db-b644-192efbaf9f45 --- # Fatal Error C1098 -Version mismatch with Edit and Continue engine +> Version mismatch with Edit and Continue engine + +## Remarks The debugger version you are using does not match the compiler used to create the executable. If recompiling does not fix the problem, you may need to reinstall Visual C++ to make sure you have the proper versions of the debugger and compiler. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1099.md b/docs/error-messages/compiler-errors-1/fatal-error-c1099.md index 5cf10883dcb..0b55641fd09 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1099.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1099.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Fatal Error C1099" title: "Fatal Error C1099" -ms.date: "11/04/2016" +description: "Learn more about: Fatal Error C1099" +ms.date: 11/04/2016 f1_keywords: ["C1099"] helpviewer_keywords: ["C1099"] -ms.assetid: c050b074-a06a-4026-9e10-569029cc0739 --- # Fatal Error C1099 -Edit and Continue engine terminating compile +> Edit and Continue engine terminating compile + +## Remarks Edit and Continue loaded a precompiled header file in preparation for compiling code changes, but subsequent actions (such as code changes prior to the precompiled header `#include` statement or stopping the debugger) prevented Edit and Continue from finishing the compile with that process. You do not need to take any action to fix this error. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1100.md b/docs/error-messages/compiler-errors-1/fatal-error-c1100.md index 77c7b876b76..71ab285e1b9 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1100.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1100.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Fatal Error C1100" title: "Fatal Error C1100" -ms.date: "11/04/2016" +description: "Learn more about: Fatal Error C1100" +ms.date: 11/04/2016 f1_keywords: ["C1100"] helpviewer_keywords: ["C1100"] -ms.assetid: d4d877ea-acd6-4ec7-961e-55e460d98820 --- # Fatal Error C1100 -unable to initialize OLE : system error message +> unable to initialize OLE : system error message + +## Remarks The compiler cannot initialize the Component Object Model (COM) library. See [CoInitialize](/windows/win32/api/objbase/nf-objbase-coinitialize). diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1103.md b/docs/error-messages/compiler-errors-1/fatal-error-c1103.md index 7b102186fe7..8d252ac10e1 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1103.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1103.md @@ -1,20 +1,23 @@ --- -description: "Learn more about: Fatal Error C1103" title: "Fatal Error C1103" -ms.date: "11/04/2016" +description: "Learn more about: Fatal Error C1103" +ms.date: 11/04/2016 f1_keywords: ["C1103"] helpviewer_keywords: ["C1103"] -ms.assetid: 9d276939-9c47-4235-9d20-76b8434f9731 --- # Fatal Error C1103 -fatal error importing progid: 'message' +> fatal error importing progid: 'message' + +## Remarks The compiler detected a problem importing a type library. For example, you cannot specify a type library with progid and also specify `no_registry`. For more information, see [#import Directive](../../preprocessor/hash-import-directive-cpp.md). -The following sample will generate C1103: +## Example + +The following example will generate C1103: ```cpp // C1103.cpp diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1104.md b/docs/error-messages/compiler-errors-1/fatal-error-c1104.md index d942c0c4c7c..4e5f7e9d27c 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1104.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1104.md @@ -1,20 +1,23 @@ --- -description: "Learn more about: Fatal Error C1104" title: "Fatal Error C1104" -ms.date: "11/04/2016" +description: "Learn more about: Fatal Error C1104" +ms.date: 11/04/2016 f1_keywords: ["C1104"] helpviewer_keywords: ["C1104"] -ms.assetid: 45bd85c4-77d3-4d3c-b167-49c563aefb4d --- # Fatal Error C1104 -fatal error importing libid: 'message' +> fatal error importing libid: 'message' + +## Remarks The compiler detected a problem importing a type library. For example, you cannot specify a type library with libid and also specify `no_registry`. For more information, see [#import Directive](../../preprocessor/hash-import-directive-cpp.md). -The following sample will generate C1104: +## Example + +The following example will generate C1104: ```cpp // C1104.cpp diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1107.md b/docs/error-messages/compiler-errors-1/fatal-error-c1107.md index 7ec4ba1fb4c..0033caaaace 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1107.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1107.md @@ -1,15 +1,16 @@ --- -description: "Learn more about: Fatal Error C1107" title: "Fatal Error C1107" +description: "Learn more about: Fatal Error C1107" ms.date: 11/22/2021 f1_keywords: ["C1107"] helpviewer_keywords: ["C1107"] -ms.assetid: 541a4d9f-10bc-4dd8-b68e-15e548f3dc0a --- # Fatal Error C1107 > could not find assembly '*file*': please specify the assembly search path using `/AI` or by setting the `LIBPATH` environment variable +## Remarks + A metadata file was passed to a [`#using`](../../preprocessor/hash-using-directive-cpp.md) directive that the compiler was unable to locate. LIBPATH, which is described in the article for `#using`, and the [`/AI`](../../build/reference/ai-specify-metadata-directories.md) compiler option allow you to specify directories in which the compiler will look for referenced metadata files. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1108.md b/docs/error-messages/compiler-errors-1/fatal-error-c1108.md index 98678a609eb..4e44ae651ed 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1108.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1108.md @@ -1,15 +1,16 @@ --- -description: "Learn more about: Fatal Error C1108" title: "Fatal Error C1108" -ms.date: "11/04/2016" +description: "Learn more about: Fatal Error C1108" +ms.date: 11/04/2016 f1_keywords: ["C1108"] helpviewer_keywords: ["C1108"] -ms.assetid: 3cadf07b-b7a7-41c7-ad5c-06ceb8af8c3b --- # Fatal Error C1108 > unable to find DLL: '*dll name*' +## Remarks + The specified DLL (*dll name*) could not be found in the path. To resolve this error, reinstall Visual C++ or copy the appropriate .dll file from the installation to your computer. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1109.md b/docs/error-messages/compiler-errors-1/fatal-error-c1109.md index 01bc560c948..98e571d5285 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1109.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1109.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Fatal Error C1109" title: "Fatal Error C1109" -ms.date: "11/04/2016" +description: "Learn more about: Fatal Error C1109" +ms.date: 11/04/2016 f1_keywords: ["C1109"] helpviewer_keywords: ["C1109"] -ms.assetid: df385e46-e54d-412c-88f8-42582b59909c --- # Fatal Error C1109 -unable to find 'entry point' in DLL 'dll' +> unable to find 'entry point' in DLL 'dll' + +## Remarks An entry point in a [delay-loaded DLL](../../build/reference/linker-support-for-delay-loaded-dlls.md) required by the compiler could not be found. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1113.md b/docs/error-messages/compiler-errors-1/fatal-error-c1113.md index c23e479a0e7..dbc382ae0b6 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1113.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1113.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Fatal Error C1113" title: "Fatal Error C1113" -ms.date: "11/04/2016" +description: "Learn more about: Fatal Error C1113" +ms.date: 11/04/2016 f1_keywords: ["C1113"] helpviewer_keywords: ["C1113"] -ms.assetid: 1c7c3ce7-2827-4822-9c63-0abc8615ea39 --- # Fatal Error C1113 -\#using failed on 'file' +> #using failed on 'file' + +## Remarks Only a file in the Microsoft Intermediate Language (MSIL) format can be passed to a [#using](../../preprocessor/hash-using-directive-cpp.md) directive. The [/clr](../../build/reference/clr-common-language-runtime-compilation.md) compiler option lets you create an MSIL output file. Other Visual Studio languages also produce MSIL files. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1116.md b/docs/error-messages/compiler-errors-1/fatal-error-c1116.md index 7a5fba81b0f..79274cc6b14 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1116.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1116.md @@ -1,6 +1,6 @@ --- -description: "Learn more about: Fatal Error C1116" title: "Fatal Error C1116" +description: "Learn more about: Fatal Error C1116" ms.date: 08/17/2022 f1_keywords: ["C1116"] helpviewer_keywords: ["C1116"] @@ -9,4 +9,6 @@ helpviewer_keywords: ["C1116"] > unrecoverable error importing module/headerunit '*name*'. Specialization of '*primary-template*' with arguments '*argument-list*' +## Remarks + Error C1116 can happen when the creation of the specialization requires the compiler to parse a token-stream and it encounters an identifier without a matching symbol. To resolve the issue, verify that all template specification arguments are defined and spelled correctly. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1117.md b/docs/error-messages/compiler-errors-1/fatal-error-c1117.md index af3886d74f6..1c1856a0520 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1117.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1117.md @@ -1,6 +1,6 @@ --- -description: "Learn more about: Fatal Error C1117" title: "Fatal Error C1117" +description: "Learn more about: Fatal Error C1117" ms.date: 08/17/2022 f1_keywords: ["C1117"] helpviewer_keywords: ["C1117"] @@ -9,4 +9,6 @@ helpviewer_keywords: ["C1117"] > unrecoverable error importing module/headerunit '*name*': symbol '*symbol-name*' has already been defined +## Remarks + The compiler found a redefinition of an existing type. To resolve the issue, verify that the symbol has only one definition across modules and translation units. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1120.md b/docs/error-messages/compiler-errors-1/fatal-error-c1120.md index f828f4e0129..4152492f557 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1120.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1120.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Fatal Error C1120" title: "Fatal Error C1120" -ms.date: "11/04/2016" +description: "Learn more about: Fatal Error C1120" +ms.date: 11/04/2016 f1_keywords: ["C1120"] helpviewer_keywords: ["C1120"] -ms.assetid: 34212b64-f4e5-4c55-9acc-6f6b2ab5f1c0 --- # Fatal Error C1120 -call to GetProcAddress failed for 'function' +> call to GetProcAddress failed for 'function' + +## Remarks This error indicates Visual C++ needs to be reinstalled. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1121.md b/docs/error-messages/compiler-errors-1/fatal-error-c1121.md index 32816f5b502..ed1e1c77aa2 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1121.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1121.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Fatal Error C1121" title: "Fatal Error C1121" -ms.date: "11/04/2016" +description: "Learn more about: Fatal Error C1121" +ms.date: 11/04/2016 f1_keywords: ["C1121"] helpviewer_keywords: ["C1121"] -ms.assetid: d16e51c5-4c50-4303-a028-ca60f7a3273c --- # Fatal Error C1121 -call to CryptoAPI failed +> call to CryptoAPI failed + +## Remarks The compiler made a call to the CryptoAPI and the call failed. Reinstall Visual Studio and possibly reinstall the operating system. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1126.md b/docs/error-messages/compiler-errors-1/fatal-error-c1126.md index 444c7d01110..cc63a251925 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1126.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1126.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Fatal Error C1126" title: "Fatal Error C1126" -ms.date: "11/04/2016" +description: "Learn more about: Fatal Error C1126" +ms.date: 11/04/2016 f1_keywords: ["C1126"] helpviewer_keywords: ["C1126"] -ms.assetid: f22b26a6-8ad7-47cf-a237-196c8ea60aca --- # Fatal Error C1126 -'identifier' : automatic allocation exceeds size +> 'identifier' : automatic allocation exceeds size + +## Remarks Space allocated for local variables of a function (plus a limited amount of space used by the compiler, such as an extra 20 bytes for swappable functions) exceeds the limit. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1128.md b/docs/error-messages/compiler-errors-1/fatal-error-c1128.md index 083737e4b44..3df616a6771 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1128.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1128.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Fatal Error C1128" title: "Fatal Error C1128" -ms.date: "11/04/2016" +description: "Learn more about: Fatal Error C1128" +ms.date: 11/04/2016 f1_keywords: ["C1128"] helpviewer_keywords: ["C1128"] -ms.assetid: 6f9580fd-ecef-48be-9780-dcf666704279 --- # Fatal Error C1128 -number of sections exceeded object file format limit : compile with /bigobj +> number of sections exceeded object file format limit : compile with /bigobj + +## Remarks An .obj file exceeded the number of allowable sections, a COFF object file format limitation. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1189.md b/docs/error-messages/compiler-errors-1/fatal-error-c1189.md index 91233b42997..791eb9e2253 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1189.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1189.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Fatal Error C1189" title: "Fatal Error C1189" -ms.date: "04/27/2018" +description: "Learn more about: Fatal Error C1189" +ms.date: 04/27/2018 f1_keywords: ["C1189"] helpviewer_keywords: ["C1189"] -ms.assetid: 2e5c8a78-edd4-411c-b619-558a96be148a --- # Fatal Error C1189 @@ -16,7 +15,7 @@ C1189 is generated by the `#error` directive. The developer who codes the direct ## Example -The following sample generates C1189. In the sample, the developer issues a custom error message because the `_WIN32` identifier is not defined: +The following example generates C1189. In the example, the developer issues a custom error message because the `_WIN32` identifier is not defined: ```cpp // C1189.cpp diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1190.md b/docs/error-messages/compiler-errors-1/fatal-error-c1190.md index da144884d90..b02620a88fd 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1190.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1190.md @@ -1,20 +1,23 @@ --- -description: "Learn more about: Fatal Error C1190" title: "Fatal Error C1190" -ms.date: "11/04/2016" +description: "Learn more about: Fatal Error C1190" +ms.date: 11/04/2016 f1_keywords: ["C1190"] helpviewer_keywords: ["C1190"] -ms.assetid: dee2266d-6c40-4f6e-91db-f01e65f8d2bc --- # Fatal Error C1190 -managed targeted code requires a '/clr' option +> managed targeted code requires a '/clr' option + +## Remarks You are using CLR constructs but you did not specify **/clr**. For more information, see [/clr (Common Language Runtime Compilation)](../../build/reference/clr-common-language-runtime-compilation.md). -The following sample generates C1190: +## Example + +The following example generates C1190: ```cpp // C1190.cpp diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1191.md b/docs/error-messages/compiler-errors-1/fatal-error-c1191.md index 523f3574ff0..d6bf50086a0 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1191.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1191.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Fatal Error C1191" title: "Fatal Error C1191" -ms.date: "11/04/2016" +description: "Learn more about: Fatal Error C1191" +ms.date: 11/04/2016 f1_keywords: ["C1191"] helpviewer_keywords: ["C1191"] -ms.assetid: 2888c6c4-b4e6-449e-8ee0-7917f31086df --- # Fatal Error C1191 -'dll' can only be imported at global scope +> 'dll' can only be imported at global scope + +## Remarks The instruction to import mscorlib.dll into a program that uses /clr programming cannot appear in a namespace or function, but must appear at global scope. -The following sample generates C1191: +## Example + +The following example generates C1191: ```cpp // C1191.cpp diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1192.md b/docs/error-messages/compiler-errors-1/fatal-error-c1192.md index 93ece1e127c..2c374cd29f7 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1192.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1192.md @@ -1,12 +1,14 @@ --- -description: "Learn more about: Fatal Error C1192" title: "Fatal Error C1192" -ms.date: "11/04/2016" +description: "Learn more about: Fatal Error C1192" +ms.date: 11/04/2016 f1_keywords: ["C1192"] helpviewer_keywords: ["C1192"] --- # Fatal Error C1192 -\#using failed on 'file' +> #using failed on 'file' + +## Remarks Only a file in the Microsoft Intermediate Language (MSIL) format can be passed to a [#using](../../preprocessor/hash-using-directive-cpp.md) directive. The [/clr](../../build/reference/clr-common-language-runtime-compilation.md) compiler option lets you create an MSIL output file. Other Visual Studio languages also produce MSIL files. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1196.md b/docs/error-messages/compiler-errors-1/fatal-error-c1196.md index ff1a7716283..8ae577e8b49 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1196.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1196.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Fatal Error C1196" title: "Fatal Error C1196" -ms.date: "11/04/2016" +description: "Learn more about: Fatal Error C1196" +ms.date: 11/04/2016 f1_keywords: ["C1196"] helpviewer_keywords: ["C1196"] -ms.assetid: 10a79b3f-3423-4ee3-98fa-e9e59cddabb1 --- # Fatal Error C1196 -'identifier' : identifier found in type library 'typelib' is not a valid C++ identifier +> 'identifier' : identifier found in type library 'typelib' is not a valid C++ identifier + +## Remarks One of the identifiers in your type library is not a valid C++ identifier. The type library is not available for use with [#import](../../preprocessor/hash-import-directive-cpp.md). diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1197.md b/docs/error-messages/compiler-errors-1/fatal-error-c1197.md index f08b1d92a2f..3a63aaa8362 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1197.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1197.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Fatal Error C1197" title: "Fatal Error C1197" -ms.date: "11/04/2016" +description: "Learn more about: Fatal Error C1197" +ms.date: 11/04/2016 f1_keywords: ["C1197"] helpviewer_keywords: ["C1197"] -ms.assetid: 22b801b7-e792-41f6-a461-973c03c69f25 --- # Fatal Error C1197 -cannot reference 'mscorlib.dll_1' as the program has already referenced 'mscorlib.dll_2' +> cannot reference 'mscorlib.dll_1' as the program has already referenced 'mscorlib.dll_2' + +## Remarks The compiler is matched to a version of the common language runtime. However, an attempt was made to reference a version of a common language runtime file from a previous version. @@ -16,7 +17,7 @@ To resolve this error, only reference files from the version of the common langu ## Example -The following sample generates C1197: +The following example generates C1197: ```cpp // C1197.cpp diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1201.md b/docs/error-messages/compiler-errors-1/fatal-error-c1201.md index a318e4523e8..f726151d895 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1201.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1201.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Fatal Error C1201" title: "Fatal Error C1201" -ms.date: "11/04/2016" +description: "Learn more about: Fatal Error C1201" +ms.date: 11/04/2016 f1_keywords: ["C1201"] helpviewer_keywords: ["C1201"] -ms.assetid: e58b9b9a-2c6f-454d-8719-9773aca765d1 --- # Fatal Error C1201 -unable to continue after syntax error in class template definition +> unable to continue after syntax error in class template definition + +## Remarks An unexpected error occurred while parsing a class template definition. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1202.md b/docs/error-messages/compiler-errors-1/fatal-error-c1202.md index 54eb8261043..4e2c9efccfc 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1202.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1202.md @@ -1,20 +1,21 @@ --- -description: "Learn more about: Fatal Error C1202" title: "Fatal Error C1202" -ms.date: "11/04/2016" +description: "Learn more about: Fatal Error C1202" +ms.date: 11/04/2016 f1_keywords: ["C1202"] helpviewer_keywords: ["C1202"] -ms.assetid: c859adb8-17a7-4fa1-a1f3-5820b7bf3849 --- # Fatal Error C1202 -recursive type or function dependency context too complex +> recursive type or function dependency context too complex + +## Remarks A template definition was recursive or exceeded complexity limits. -## Examples +## Example -The following sample generates C1202. +The following example generates C1202. ```cpp // C1202.cpp diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1205.md b/docs/error-messages/compiler-errors-1/fatal-error-c1205.md index 37af5602e90..d66fd0f7793 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1205.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1205.md @@ -1,15 +1,16 @@ --- -description: "Learn more about: Fatal Error C1205" title: "Fatal Error C1205" +description: "Learn more about: Fatal Error C1205" ms.date: 08/17/2022 f1_keywords: ["C1205"] helpviewer_keywords: ["C1205"] -ms.assetid: f855c145-8cf7-4dd1-bb19-257ee38b8382 --- # Fatal Error C1205 > Generics are not supported by the version of the runtime installed +## Remarks + The version of the common language runtime that the compiler is using isn't a version of the runtime supported by the current compiler. For example, the generics feature requires a runtime that is matched to the compiler. Your path specification may need to be modified. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1206.md b/docs/error-messages/compiler-errors-1/fatal-error-c1206.md index 0859695a799..c519b7e27cb 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1206.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1206.md @@ -1,15 +1,16 @@ --- -description: "Learn more about: Fatal Error C1206" title: "Fatal Error C1206" +description: "Learn more about: Fatal Error C1206" ms.date: 08/17/2022 f1_keywords: ["C1206"] helpviewer_keywords: ["C1206"] -ms.assetid: 2211428f-ad86-4f7b-82eb-f1ba89b0510e --- # Fatal Error C1206 > Per-appdomain data is not supported by the version of the runtime installed +## Remarks + Some features, such as per application domain data, are only supported by the common language runtime that supports the feature. C1206 indicates that the latest version of the runtime isn't installed on your computer. Install the common language runtime version that is intended for use with your compiler. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1207.md b/docs/error-messages/compiler-errors-1/fatal-error-c1207.md index 5302f9c823c..abcb64a7f3b 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1207.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1207.md @@ -1,15 +1,16 @@ --- -description: "Learn more about: Fatal Error C1207" title: "Fatal Error C1207" +description: "Learn more about: Fatal Error C1207" ms.date: 08/17/2022 f1_keywords: ["C1207"] helpviewer_keywords: ["C1207"] -ms.assetid: cd31b410-9523-47db-883c-e69a9351ffa2 --- # Fatal Error C1207 > Managed templates not supported by the version of the runtime installed +## Remarks + C1207 occurs when you have a compiler for the current release, but a common language runtime from a previous release. Some functionality of the compiler may not work on a previous version of the run time. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1208.md b/docs/error-messages/compiler-errors-1/fatal-error-c1208.md index 304879dfc5b..57732dfda0e 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1208.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1208.md @@ -1,15 +1,16 @@ --- -description: "Learn more about: Fatal Error C1208" title: "Fatal Error C1208" +description: "Learn more about: Fatal Error C1208" ms.date: 08/17/2022 f1_keywords: ["C1208"] helpviewer_keywords: ["C1208"] -ms.assetid: 4eefd8f0-5c2e-4a11-9e63-293e1139db65 --- # Fatal Error C1208 > Allocating reference classes on the stack is not supported by the version of the runtime installed +## Remarks + C1208 occurs when you have a compiler for the current release, but a common language runtime from a previous release. Some functionality of the compiler may not work on a previous version of the run time. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1209.md b/docs/error-messages/compiler-errors-1/fatal-error-c1209.md index 1029773c300..3967da97ec8 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1209.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1209.md @@ -1,15 +1,16 @@ --- -description: "Learn more about: Fatal Error C1209" title: "Fatal Error C1209" +description: "Learn more about: Fatal Error C1209" ms.date: 08/17/2022 f1_keywords: ["C1209"] helpviewer_keywords: ["C1209"] -ms.assetid: aa9ee10f-abe3-4683-9792-adca4cbbabb5 --- # Fatal Error C1209 > Friend assemblies not supported by the version of the runtime installed +## Remarks + C1208 occurs when you have a compiler for the current release, but a common language runtime from a previous release. Some functionality of the compiler may not work on a previous version of the run time. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1210.md b/docs/error-messages/compiler-errors-1/fatal-error-c1210.md index 09aac9e2bd0..70c37bc8c76 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1210.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1210.md @@ -1,15 +1,16 @@ --- -description: "Learn more about: Fatal Error C1210" title: "Fatal Error C1210" +description: "Learn more about: Fatal Error C1210" ms.date: 08/17/2022 f1_keywords: ["C1210"] helpviewer_keywords: ["C1210"] -ms.assetid: e2208309-c284-425c-a7e8-48e96e66f35b --- # Fatal Error C1210 > `/clr:pure` and `/clr:safe` are not supported by the version of the runtime installed +## Remarks + The **`/clr:pure`** and **`/clr:safe`** compiler options are deprecated in Visual Studio 2015 and unsupported in Visual Studio 2017. C1210 occurs when you have a compiler for the current release, but a common language runtime from a previous release. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1211.md b/docs/error-messages/compiler-errors-1/fatal-error-c1211.md index 174c78ea004..24359b9c00c 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1211.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1211.md @@ -1,15 +1,16 @@ --- -description: "Learn more about: Fatal Error C1211" title: "Fatal Error C1211" +description: "Learn more about: Fatal Error C1211" ms.date: 08/17/2022 f1_keywords: ["C1211"] helpviewer_keywords: ["C1211"] -ms.assetid: df0ca70d-ec6e-4400-926a-b877e2599978 --- # Fatal Error C1211 > The TypeForwardedTo Custom Attribute is not supported by the version of the runtime installed +## Remarks + C1211 occurs when you have a compiler for the current release, but a common language runtime from a previous release. Some functionality of the compiler may not work on a previous version of the run time. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1305.md b/docs/error-messages/compiler-errors-1/fatal-error-c1305.md index 35a90daf3c2..398c483eb5f 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1305.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1305.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Fatal Error C1305" title: "Fatal Error C1305" -ms.date: "11/04/2016" +description: "Learn more about: Fatal Error C1305" +ms.date: 11/04/2016 f1_keywords: ["C1305"] helpviewer_keywords: ["C1305"] -ms.assetid: 1629c850-e2db-4678-83d8-9bfc85323bc5 --- # Fatal Error C1305 -profile database 'pgd_file' is for a different architecture +> profile database 'pgd_file' is for a different architecture + +## Remarks A .pgd file that was generated from the /LTCG:PGINSTRUMENT operation for another platform was passed to [/LTCG:PGOPTIMIZE](../../build/reference/ltcg-link-time-code-generation.md) . [Profile-guided optimizations](../../build/profile-guided-optimizations.md) are available for x86 and x64 platforms. However, a .pgd file generated with a /LTCG:PGINSTRUMENT operation for one platform is not valid as input to a /LTCG:PGOPTIMIZE for a different platform. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1307.md b/docs/error-messages/compiler-errors-1/fatal-error-c1307.md index d358e2bbd8b..27c1ed010ea 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1307.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1307.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Fatal Error C1307" title: "Fatal Error C1307" -ms.date: "11/04/2016" +description: "Learn more about: Fatal Error C1307" +ms.date: 11/04/2016 f1_keywords: ["C1307"] helpviewer_keywords: ["C1307"] -ms.assetid: 6f77d3d4-ba8a-476c-b540-aff19eb4efc4 --- # Fatal Error C1307 -program has been edited since profile data was collected +> program has been edited since profile data was collected + +## Remarks When using [/LTCG:PGOPTIMIZE](../../build/reference/ltcg-link-time-code-generation.md), the linker detected an input module that was recompiled after /LTCG:PGINSTRUMENT and that the module was changed to the point where existing profile data is no longer relevant. For example, if the call graph changed in the recompiled module, the compiler will generate C1307. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1308.md b/docs/error-messages/compiler-errors-1/fatal-error-c1308.md index 045cd2f5e42..81335e1a835 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1308.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1308.md @@ -1,20 +1,23 @@ --- -description: "Learn more about: Fatal Error C1308" title: "Fatal Error C1308" -ms.date: "11/04/2016" +description: "Learn more about: Fatal Error C1308" +ms.date: 11/04/2016 f1_keywords: ["C1308"] helpviewer_keywords: ["C1308"] -ms.assetid: 46177997-069e-433a-8e20-93c846d78ffd --- # Fatal Error C1308 -linking assemblies is not supported +> linking assemblies is not supported + +## Remarks A .netmodule is allowed as input to the linker, but an assembly is not. This error can be generated when an attempt is made to link an assembly compiled with `/clr:safe`. For more information, see [.netmodule Files as Linker Input](../../build/reference/netmodule-files-as-linker-input.md). -The following sample generates C1308: +## Example + +The following example generates C1308: ```cpp // C1308.cpp diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1309.md b/docs/error-messages/compiler-errors-1/fatal-error-c1309.md index f70ecf7bd42..0bd33544bfd 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1309.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1309.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Fatal Error C1309" title: "Fatal Error C1309" -ms.date: "11/04/2016" +description: "Learn more about: Fatal Error C1309" +ms.date: 11/04/2016 f1_keywords: ["C1309"] helpviewer_keywords: ["C1309"] -ms.assetid: a95363d6-a4f3-45fb-9690-aa7e552093b7 --- # Fatal Error C1309 -Mismatched versions of C2.DLL and PGODB\.DLL +> Mismatched versions of C2.DLL and PGODB\.DLL + +## Remarks The toolset you are using to build and use [Profile-Guided Optimizations](../../build/profile-guided-optimizations.md) contains mismatched components. If you cannot manually resolve this error, reinstall Visual C++. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1310.md b/docs/error-messages/compiler-errors-1/fatal-error-c1310.md index 233ae5c7e4d..5fef1f9c37b 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1310.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1310.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Fatal Error C1310" title: "Fatal Error C1310" -ms.date: "11/04/2016" +description: "Learn more about: Fatal Error C1310" +ms.date: 11/04/2016 f1_keywords: ["C1310"] helpviewer_keywords: ["C1310"] -ms.assetid: ac48aa51-8023-42fe-b844-3f8bf228fbef --- # Fatal Error C1310 -profile guided optimizations are not available with OpenMP +> profile guided optimizations are not available with OpenMP + +## Remarks You will not be able to link with [/LTCG:PGI](../../build/reference/ltcg-link-time-code-generation.md) any module that was compiled with [/GL](../../build/reference/gl-whole-program-optimization.md). -The following sample generates C1310: +## Example + +The following example generates C1310: ```cpp // C1310.cpp diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1311.md b/docs/error-messages/compiler-errors-1/fatal-error-c1311.md index 93d5084e290..fdb102ebbda 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1311.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1311.md @@ -1,19 +1,22 @@ --- -description: "Learn more about: Fatal Error C1311" title: "Fatal Error C1311" -ms.date: "11/04/2016" +description: "Learn more about: Fatal Error C1311" +ms.date: 11/04/2016 f1_keywords: ["C1311"] helpviewer_keywords: ["C1311"] -ms.assetid: 6590a06c-ce9d-4f17-8f62-c809343143b8 --- # Fatal Error C1311 -COFF format cannot statically initialize 'var' with number byte(s) of an address +> COFF format cannot statically initialize 'var' with number byte(s) of an address + +## Remarks An address whose value is not known at compile time cannot be statically assigned to a variable whose type has storage of less than four bytes. This error can occur on code that is otherwise valid C++. +## Example + The following example shows one condition that might cause C1311. ``` diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1312.md b/docs/error-messages/compiler-errors-1/fatal-error-c1312.md index 03699b2824c..3173bfba076 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1312.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1312.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Fatal Error C1312" title: "Fatal Error C1312" -ms.date: "11/04/2016" +description: "Learn more about: Fatal Error C1312" +ms.date: 11/04/2016 f1_keywords: ["C1312"] helpviewer_keywords: ["C1312"] -ms.assetid: 1aa7cd0e-d45f-4ae7-a85d-015ebb962eaf --- # Fatal Error C1312 -Too many conditional branches in function. Simplify or refactor source code. +> Too many conditional branches in function. Simplify or refactor source code. + +## Remarks The code is too complex for the compiler to process without running out of stack memory. Simplify your code. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1313.md b/docs/error-messages/compiler-errors-1/fatal-error-c1313.md index 629767d0279..90814b3406e 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1313.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1313.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Fatal Error C1313" title: "Fatal Error C1313" -ms.date: "11/04/2016" +description: "Learn more about: Fatal Error C1313" +ms.date: 11/04/2016 f1_keywords: ["C1313"] helpviewer_keywords: ["C1313"] -ms.assetid: 6c7631c8-6fd7-476a-9303-564717fda0f9 --- # Fatal Error C1313 -compiler limit : type blocks may not be nested deeper than number levels +> compiler limit : type blocks may not be nested deeper than number levels + +## Remarks Exception handling (or structured exception handling) blocks were nested too deeply. Simplify your code. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1350.md b/docs/error-messages/compiler-errors-1/fatal-error-c1350.md index 96c160733c6..dcb1474a08b 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1350.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1350.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Fatal Error C1350" title: "Fatal Error C1350" -ms.date: "11/04/2016" +description: "Learn more about: Fatal Error C1350" +ms.date: 11/04/2016 f1_keywords: ["C1350"] helpviewer_keywords: ["C1350"] -ms.assetid: 8bb47c23-ac9c-4a33-9ede-4d63ed9d4ba8 --- # Fatal Error C1350 -error loading dll 'dll': dll not found +> error loading dll 'dll': dll not found + +## Remarks The DLL that supports the attempted operation was not found. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1351.md b/docs/error-messages/compiler-errors-1/fatal-error-c1351.md index 9e772faf2c1..2019a263242 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1351.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1351.md @@ -1,15 +1,16 @@ --- -description: "Learn more about: Fatal Error C1351" title: "Fatal Error C1351" -ms.date: "11/04/2016" +description: "Learn more about: Fatal Error C1351" +ms.date: 11/04/2016 f1_keywords: ["C1351"] helpviewer_keywords: ["C1351"] -ms.assetid: 1f8502e4-1049-49c7-bbe3-fa101c79021e --- # Fatal Error C1351 > error loading dll '*dll*': incompatible version +## Remarks + The wrong version of a DLL was found. This indicates a problem with your installation, and you should reinstall Visual Studio. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1352.md b/docs/error-messages/compiler-errors-1/fatal-error-c1352.md index 3becb52d1f7..581c2864959 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1352.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1352.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Fatal Error C1352" title: "Fatal Error C1352" -ms.date: "11/04/2016" +description: "Learn more about: Fatal Error C1352" +ms.date: 11/04/2016 f1_keywords: ["C1352"] helpviewer_keywords: ["C1352"] -ms.assetid: d044e8b0-b6ef-4d57-8eb5-6254071be707 --- # Fatal Error C1352 -Invalid or corrupt MSIL in function 'function' from module 'file' +> Invalid or corrupt MSIL in function 'function' from module 'file' + +## Remarks A .netmodule was passed to the compiler, but the compiler detected corruption in the file. Ask the person who produced the .netmodule to investigate. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1353.md b/docs/error-messages/compiler-errors-1/fatal-error-c1353.md index d36fe258647..48b39279dd2 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1353.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1353.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Fatal Error C1353" title: "Fatal Error C1353" -ms.date: "11/04/2016" +description: "Learn more about: Fatal Error C1353" +ms.date: 11/04/2016 f1_keywords: ["C1353"] helpviewer_keywords: ["C1353"] -ms.assetid: 37f55b1d-9e7a-4932-a41e-d593190895d3 --- # Fatal Error C1353 -metadata operation failed: runtime not installed or version mismatch +> metadata operation failed: runtime not installed or version mismatch + +## Remarks Reinstall your CLR or Visual Studio. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1382.md b/docs/error-messages/compiler-errors-1/fatal-error-c1382.md index f90ab23a6c1..f61a7a1fa02 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1382.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1382.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Fatal Error C1382" title: "Fatal Error C1382" -ms.date: "11/04/2016" +description: "Learn more about: Fatal Error C1382" +ms.date: 11/04/2016 f1_keywords: ["C1382"] helpviewer_keywords: ["C1382"] -ms.assetid: 7a100f8c-3179-4927-a2f1-98de4c753850 --- # Fatal Error C1382 -the PCH file 'file' has been rebuilt since 'obj' was generated. Please rebuild this object +> the PCH file 'file' has been rebuilt since 'obj' was generated. Please rebuild this object + +## Remarks When using [/LTCG](../../build/reference/ltcg-link-time-code-generation.md), the compiler detected a .pch file that is newer than a CIL .obj that points to it. The information in the CIL .obj file is out of date. Rebuild the object. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1383.md b/docs/error-messages/compiler-errors-1/fatal-error-c1383.md index 787baf5bbae..f826a4c3a1c 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1383.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1383.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Fatal Error C1383" title: "Fatal Error C1383" -ms.date: "11/04/2016" +description: "Learn more about: Fatal Error C1383" +ms.date: 11/04/2016 f1_keywords: ["C1383"] helpviewer_keywords: ["C1383"] -ms.assetid: ca224d14-d687-4fd6-80c2-8b82f28924ea --- # Fatal Error C1383 -compiler option /GL is incompatible with the installed version of common language runtime +> compiler option /GL is incompatible with the installed version of common language runtime + +## Remarks C1383 occurs when you are using a previous version of the common language runtime with a newer compiler, and when you compile with **/clr** and **/GL.** diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1506.md b/docs/error-messages/compiler-errors-1/fatal-error-c1506.md index e439909d468..2509bc5f2b6 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1506.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1506.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Fatal Error C1506" title: "Fatal Error C1506" -ms.date: "11/04/2016" +description: "Learn more about: Fatal Error C1506" +ms.date: 11/04/2016 f1_keywords: ["C1506"] helpviewer_keywords: ["C1506"] -ms.assetid: c73d5702-c898-4a32-b0fa-a118601a1e14 --- # Fatal Error C1506 -unrecoverable block scoping error +> unrecoverable block scoping error + +## Remarks The block was too large to compile. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1508.md b/docs/error-messages/compiler-errors-1/fatal-error-c1508.md index 1954f3cf0b1..394368d4291 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1508.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1508.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Fatal Error C1508" title: "Fatal Error C1508" -ms.date: "11/04/2016" +description: "Learn more about: Fatal Error C1508" +ms.date: 11/04/2016 f1_keywords: ["C1508"] helpviewer_keywords: ["C1508"] -ms.assetid: 1112c17d-d60f-470d-b886-fd1a9556c0ea --- # Fatal Error C1508 -compiler limit : 'function' : more than 65535 argument bytes +> compiler limit : 'function' : more than 65535 argument bytes + +## Remarks The formal parameters to the function exceed the limit of 65535 bytes. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1509.md b/docs/error-messages/compiler-errors-1/fatal-error-c1509.md index b716a1d9a16..1a17d1c7f5b 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1509.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1509.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Fatal Error C1509" title: "Fatal Error C1509" -ms.date: "11/04/2016" +description: "Learn more about: Fatal Error C1509" +ms.date: 11/04/2016 f1_keywords: ["C1509"] helpviewer_keywords: ["C1509"] -ms.assetid: 40dd100d-c6ba-451c-bd26-2c99ec1c36d6 --- # Fatal Error C1509 -compiler limit : too many exception handler states in function 'function'. simplify function +> compiler limit : too many exception handler states in function 'function'. simplify function + +## Remarks The code exceeds an internal limit on exception handler states (32,768 states). diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1510.md b/docs/error-messages/compiler-errors-1/fatal-error-c1510.md index 382b7e07cbf..640a564c8fd 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1510.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1510.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Fatal Error C1510" title: "Fatal Error C1510" -ms.date: "04/11/2017" +description: "Learn more about: Fatal Error C1510" +ms.date: 04/11/2017 f1_keywords: ["C1510"] helpviewer_keywords: ["C1510"] -ms.assetid: 150c827f-9514-41a9-8d7e-82f820749bcb --- # Fatal Error C1510 -Cannot open language resource clui.dll +> Cannot open language resource clui.dll + +## Remarks The compiler can't load the language resource DLL. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1601.md b/docs/error-messages/compiler-errors-1/fatal-error-c1601.md index b0ccf6cebf2..f36aca8a88d 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1601.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1601.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Fatal Error C1601" title: "Fatal Error C1601" -ms.date: "11/04/2016" +description: "Learn more about: Fatal Error C1601" +ms.date: 11/04/2016 f1_keywords: ["C1601"] helpviewer_keywords: ["C1601"] -ms.assetid: 25797c39-f085-4d75-9eab-159ecd36ef49 --- # Fatal Error C1601 -unsupported inline assembly opcode +> unsupported inline assembly opcode + +## Remarks This error indicates a mismatch in your compiler .exe files, which may have occurred because of an incomplete installation. For example, you may have installed a service pack but not the Processor Pack. Install all required products. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1602.md b/docs/error-messages/compiler-errors-1/fatal-error-c1602.md index 5565ea2d137..5f29077c41f 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1602.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1602.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Fatal Error C1602" title: "Fatal Error C1602" -ms.date: "11/04/2016" +description: "Learn more about: Fatal Error C1602" +ms.date: 11/04/2016 f1_keywords: ["C1602"] helpviewer_keywords: ["C1602"] -ms.assetid: a9365c58-fe66-49c4-a702-9bb75429cc1a --- # Fatal Error C1602 -unsupported intrinsic +> unsupported intrinsic + +## Remarks This error indicates a mismatch in your compiler .exe files, which may have occurred because of an incomplete installation. For example, you may have installed a service pack but not the Processor Pack. Install all required products. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1603.md b/docs/error-messages/compiler-errors-1/fatal-error-c1603.md index 4f6744a59e1..8e8fe6f3782 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1603.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1603.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Fatal Error C1603" title: "Fatal Error C1603" -ms.date: "11/04/2016" +description: "Learn more about: Fatal Error C1603" +ms.date: 11/04/2016 f1_keywords: ["C1603"] helpviewer_keywords: ["C1603"] -ms.assetid: e5a06925-f916-4637-8240-6d2d280e6124 --- # Fatal Error C1603 -inline assembly branch target out of range by 'number' bytes +> inline assembly branch target out of range by 'number' bytes + +## Remarks The computed distance between a JCXZ or JECXZ instruction and its specified target label was greater than 128 bytes. Update your code so that the label is closer to the instruction. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1852.md b/docs/error-messages/compiler-errors-1/fatal-error-c1852.md index 9c42b79c0b2..06b8fd90e3b 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1852.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1852.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Fatal Error C1852" title: "Fatal Error C1852" -ms.date: "11/04/2016" +description: "Learn more about: Fatal Error C1852" +ms.date: 11/04/2016 f1_keywords: ["C1852"] helpviewer_keywords: ["C1852"] -ms.assetid: fa011004-b8d6-46f1-ba80-4785e4ce137f --- # Fatal Error C1852 -'filename' is not a valid precompiled header file +> 'filename' is not a valid precompiled header file + +## Remarks The file is not a precompiled header. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1853.md b/docs/error-messages/compiler-errors-1/fatal-error-c1853.md index 1b77c8c0bbb..6ff6d7e1dd8 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1853.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1853.md @@ -1,15 +1,16 @@ --- -description: "Learn more about: Fatal Error C1853" title: "Fatal Error C1853" -ms.date: "11/04/2016" +description: "Learn more about: Fatal Error C1853" +ms.date: 11/04/2016 f1_keywords: ["C1853"] helpviewer_keywords: ["C1853"] -ms.assetid: ceb9b4a5-92bf-4573-8a9f-3109cc7743ce --- # Fatal Error C1853 > '*filename*' precompiled header file is from a previous version of the compiler, or the precompiled header is C++ and you are using it from C (or vice versa) +## Remarks + Possible causes: - The precompiled header was compiled with a previous compiler version. Try recompiling the header with the current compiler. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1854.md b/docs/error-messages/compiler-errors-1/fatal-error-c1854.md index 6280c869d44..460413ed4c8 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1854.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1854.md @@ -1,15 +1,16 @@ --- -description: "Learn more about: Fatal Error C1854" title: "Fatal Error C1854" -ms.date: "11/04/2016" +description: "Learn more about: Fatal Error C1854" +ms.date: 11/04/2016 f1_keywords: ["C1854"] helpviewer_keywords: ["C1854"] -ms.assetid: 8c21a9cc-1737-475c-9e57-8725cd8937c1 --- # Fatal Error C1854 > cannot overwrite information formed during creation of the precompiled header in object file: '*filename*' +## Remarks + You specified the [/Yu (Use Precompiled Header File)](../../build/reference/yu-use-precompiled-header-file.md) option after specifying the [/Yc (Create Precompiled Header File)](../../build/reference/yc-create-precompiled-header-file.md) option for the same file. To fix this issue, in general, set only one file in your project to be compiled by using the **/Yc** option, and set all other files to compile by using the **/Yu** option. For details on the use of the **/Yc** option, and how to set it in the Visual Studio IDE, see [/Yc (Create Precompiled Header File)](../../build/reference/yc-create-precompiled-header-file.md). For more information on using precompiled headers, see [Creating Precompiled Header Files](../../build/creating-precompiled-header-files.md). diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1900.md b/docs/error-messages/compiler-errors-1/fatal-error-c1900.md index 5634a9b78bd..8d67b8fd8d5 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1900.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1900.md @@ -1,15 +1,16 @@ --- -description: "Learn more about: Fatal Error C1900" title: "Fatal Error C1900" -ms.date: "11/04/2016" +description: "Learn more about: Fatal Error C1900" +ms.date: 11/04/2016 f1_keywords: ["C1900"] helpviewer_keywords: ["C1900"] -ms.assetid: 3aaa583b-4c1a-45de-aa34-527d806f2cb5 --- # Fatal Error C1900 > Il mismatch between '*tool1*' version '*number1*' and '*tool2*' version '*number2*' +## Remarks + Tools run in various passes of the compiler do not match. *number1* and *number2* refer to the dates on the files. For example, in pass 1, the compiler front end runs (c1.dll) and in pass 2, the compiler back end runs (c2.dll). The dates on the files must match. To fix this issue, make sure that all updates have been applied to Visual Studio. If the problem persists, use **Programs and Features** in the Windows Control Panel to repair or reinstall Visual Studio. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1902.md b/docs/error-messages/compiler-errors-1/fatal-error-c1902.md index 8bde156cbf2..2433f0dc9dc 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1902.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1902.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Fatal Error C1902" title: "Fatal Error C1902" -ms.date: "11/04/2016" +description: "Learn more about: Fatal Error C1902" +ms.date: 11/04/2016 f1_keywords: ["C1902"] helpviewer_keywords: ["C1902"] -ms.assetid: 2dc066cc-fcb1-4725-8bcb-9f44dd0905b7 --- # Fatal Error C1902 -program database manager mismatch; please check your installation +> program database manager mismatch; please check your installation + +## Remarks A program database file (.pdb) was created using a newer version of mspdb*XXX*.dll than the one the compiler found on your system. This error usually indicates that mspdbsrv.exe or mspdbcore.dll are missing or have different versions than mspdb*XXX*.dll. (The *XXX* placeholder in the mspdb*XXX*.dll file name changes with each product release. For example, in Visual Studio 2015, the file name is mspdb140.dll.) diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1903.md b/docs/error-messages/compiler-errors-1/fatal-error-c1903.md index 1f818efeaf3..d7d3f8cc18b 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1903.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1903.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Fatal Error C1903" title: "Fatal Error C1903" -ms.date: "11/04/2016" +description: "Learn more about: Fatal Error C1903" +ms.date: 11/04/2016 f1_keywords: ["C1903"] helpviewer_keywords: ["C1903"] -ms.assetid: 4b4719d6-35d2-4ca5-81ce-903ecd28dfb9 --- # Fatal Error C1903 -unable to recover from previous error(s); stopping compilation +> unable to recover from previous error(s); stopping compilation + +## Remarks The compiler found too many errors to continue. Fix the errors and recompile. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1904.md b/docs/error-messages/compiler-errors-1/fatal-error-c1904.md index a3443127d98..2fd23f23976 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1904.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1904.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Fatal Error C1904" title: "Fatal Error C1904" -ms.date: "11/04/2016" +description: "Learn more about: Fatal Error C1904" +ms.date: 11/04/2016 f1_keywords: ["C1904"] helpviewer_keywords: ["C1904"] -ms.assetid: 10f66015-146f-41a7-8011-327b29dedec8 --- # Fatal Error C1904 -bad provider interaction: 'file' +> bad provider interaction: 'file' + +## Remarks This error indicates the failure of an attribute provider. diff --git a/docs/error-messages/compiler-errors-1/fatal-error-c1905.md b/docs/error-messages/compiler-errors-1/fatal-error-c1905.md index 69b567fcd5f..89b8a800a51 100644 --- a/docs/error-messages/compiler-errors-1/fatal-error-c1905.md +++ b/docs/error-messages/compiler-errors-1/fatal-error-c1905.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Fatal Error C1905" title: "Fatal Error C1905" -ms.date: "11/04/2016" +description: "Learn more about: Fatal Error C1905" +ms.date: 11/04/2016 f1_keywords: ["C1905"] helpviewer_keywords: ["C1905"] -ms.assetid: fefc6769-477f-45a2-9878-6f0a5f42472c --- # Fatal Error C1905 -Front end and back end not compatible (must target same processor) +> Front end and back end not compatible (must target same processor) + +## Remarks This error occurs when a .obj file is generated by a compiler front end (C1.dll) that targets one processor, such as x86, ARM, or x64, but is being read by a back end (C2.dll) that targets a different processor. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2500.md b/docs/error-messages/compiler-errors-2/compiler-error-c2500.md index 172a50f9026..ca18bb6baa8 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2500.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2500.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Error C2500" title: "Compiler Error C2500" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2500" +ms.date: 11/04/2016 f1_keywords: ["C2500"] helpviewer_keywords: ["C2500"] -ms.assetid: 6bff8161-dc9a-48ca-91f1-fd2eefdbbc93 --- # Compiler Error C2500 -'identifier1' : 'identifier2' is already a direct base class +> 'identifier1' : 'identifier2' is already a direct base class + +## Remarks A class or structure appears more than once in a list of base classes. @@ -16,7 +17,9 @@ A direct base is one mentioned in the base list. An indirect base is a base clas A class cannot be specified as a direct base class more than once. A class can be used as an indirect base class more than once. -The following sample generates C2500: +## Example + +The following example generates C2500: ```cpp // C2500.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2502.md b/docs/error-messages/compiler-errors-2/compiler-error-c2502.md index 5870524c77c..682a1056c70 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2502.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2502.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2502" title: "Compiler Error C2502" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2502" +ms.date: 11/04/2016 f1_keywords: ["C2502"] helpviewer_keywords: ["C2502"] -ms.assetid: affa0b86-15fc-4e17-b7f2-6aad4a3771c4 --- # Compiler Error C2502 -'identifier' : too many access modifiers on the base class +> 'identifier' : too many access modifiers on the base class + +## Remarks The base class has more than one access modifier. Only one access modifier (**`public`**, **`private`**, or **`protected`**) is allowed. -The following sample generates C2502: +## Example + +The following example generates C2502: ```cpp // C2502.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2503.md b/docs/error-messages/compiler-errors-2/compiler-error-c2503.md index e1e75d0a6d6..2f5f2a710c1 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2503.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2503.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2503" title: "Compiler Error C2503" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2503" +ms.date: 11/04/2016 f1_keywords: ["C2503"] helpviewer_keywords: ["C2503"] -ms.assetid: da86cc89-fd04-400b-aa8d-a5ffaf7e3918 --- # Compiler Error C2503 -'class' : base classes cannot contain zero-sized arrays +> 'class' : base classes cannot contain zero-sized arrays + +## Remarks A base class or structure contains a zero-sized array. An array in a class must have at least one element. -The following sample generates C2503: +## Example + +The following example generates C2503: ```cpp // C2503.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2504.md b/docs/error-messages/compiler-errors-2/compiler-error-c2504.md index 454446e6514..82e484fe671 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2504.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2504.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Error C2504" title: "Compiler Error C2504" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2504" +ms.date: 11/04/2016 f1_keywords: ["C2504"] helpviewer_keywords: ["C2504"] -ms.assetid: c9e002a6-a4ee-4ba7-970e-edf4adb83692 --- # Compiler Error C2504 -'class' : base class undefined +> 'class' : base class undefined + +## Remarks The base class is declared but never defined. Possible causes: @@ -16,7 +17,9 @@ The base class is declared but never defined. Possible causes: 1. External base class not declared with [extern](../../cpp/extern-cpp.md). -The following sample generates C2504: +## Example + +The following example generates C2504: ```cpp // C2504.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2505.md b/docs/error-messages/compiler-errors-2/compiler-error-c2505.md index e243be38013..2418358823a 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2505.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2505.md @@ -1,20 +1,23 @@ --- -description: "Learn more about: Compiler Error C2505" title: "Compiler Error C2505" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2505" +ms.date: 11/04/2016 f1_keywords: ["C2505"] helpviewer_keywords: ["C2505"] -ms.assetid: b19f5c53-399d-425e-90db-fe3ca9b40858 --- # Compiler Error C2505 -'symbol' : '__declspec(modifer)' can only be applied to declarations or definitions of global objects or static data members +> 'symbol' : '__declspec(modifer)' can only be applied to declarations or definitions of global objects or static data members + +## Remarks A **`__declspec`** modifier that is designed to only be used at global scope was used in a function. For more information, see [appdomain](../../cpp/appdomain.md) and [process](../../cpp/process.md). -The following sample generates C2505: +## Example + +The following example generates C2505: ```cpp // C2505.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2506.md b/docs/error-messages/compiler-errors-2/compiler-error-c2506.md index 58498d0b67b..6b29b6aa6a6 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2506.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2506.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Error C2506" title: "Compiler Error C2506" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2506" +ms.date: 11/04/2016 f1_keywords: ["C2506"] helpviewer_keywords: ["C2506"] -ms.assetid: cfed21cd-2404-46f2-985e-d0c2c3820830 --- # Compiler Error C2506 -'member' : '__declspec(modifier)' cannot be applied to this symbol +> 'member' : '__declspec(modifier)' cannot be applied to this symbol + +## Remarks You cannot declare per-process or per-appdomain for static members of a managed class. @@ -16,7 +17,7 @@ See [appdomain](../../cpp/appdomain.md) for more information. ## Example -The following sample generates C2506. +The following example generates C2506. ```cpp // C2506.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2507.md b/docs/error-messages/compiler-errors-2/compiler-error-c2507.md index acc9e18da98..4a586ada072 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2507.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2507.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2507" title: "Compiler Error C2507" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2507" +ms.date: 11/04/2016 f1_keywords: ["C2507"] helpviewer_keywords: ["C2507"] -ms.assetid: f102aff5-de7d-4c3f-9cac-2ddf9ce02b14 --- # Compiler Error C2507 -'identifier' : too many virtual modifiers on the base class +> 'identifier' : too many virtual modifiers on the base class + +## Remarks A class or structure is declared as **`virtual`** more than once. Only one **`virtual`** modifier can appear for each class in a list of base classes. -The following sample generates C2507: +## Example + +The following example generates C2507: ```cpp // C2507.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2509.md b/docs/error-messages/compiler-errors-2/compiler-error-c2509.md index f352ec966de..570e65755fc 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2509.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2509.md @@ -1,20 +1,21 @@ --- -description: "Learn more about: Compiler Error C2509" title: "Compiler Error C2509" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2509" +ms.date: 11/04/2016 f1_keywords: ["C2509"] helpviewer_keywords: ["C2509"] -ms.assetid: 339c1fcd-ec4a-456c-9f18-a9b24d9921af --- # Compiler Error C2509 -'identifier' : member function not declared in 'class' +> 'identifier' : member function not declared in 'class' + +## Remarks The function is not declared in the specified class. ## Example -The following sample generates C2509. +The following example generates C2509. ```cpp // C2509.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2510.md b/docs/error-messages/compiler-errors-2/compiler-error-c2510.md index 6f3e7b8c2af..9a1d072e990 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2510.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2510.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2510" title: "Compiler Error C2510" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2510" +ms.date: 11/04/2016 f1_keywords: ["C2510"] helpviewer_keywords: ["C2510"] -ms.assetid: bf6d28db-f2f4-48f8-8f4e-7d662ed278fe --- # Compiler Error C2510 -'identifier' : left of '::' must be a class/struct/union +> 'identifier' : left of '::' must be a class/struct/union + +## Remarks A class, structure, or union name must appear on the left side of the scope-resolution operator (`::`) operator. -The following sample generates C2510: +## Example + +The following example generates C2510: ```cpp // C2510.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2511.md b/docs/error-messages/compiler-errors-2/compiler-error-c2511.md index 366066b72ce..9b0661a8f52 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2511.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2511.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Error C2511" title: "Compiler Error C2511" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2511" +ms.date: 11/04/2016 f1_keywords: ["C2511"] helpviewer_keywords: ["C2511"] -ms.assetid: df999efe-fe2b-418b-bb55-4af6a0592631 --- # Compiler Error C2511 -'identifier' : overloaded member function not found in 'class' +> 'identifier' : overloaded member function not found in 'class' + +## Remarks No version of the function is declared with the specified parameters. Possible causes: @@ -18,7 +19,9 @@ No version of the function is declared with the specified parameters. Possible 1. Incorrect spelling of parameter names. -The following sample generates C2511: +## Example + +The following example generates C2511: ```cpp // C2511.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2512.md b/docs/error-messages/compiler-errors-2/compiler-error-c2512.md index 10f91ac3852..2d3eda00460 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2512.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2512.md @@ -1,15 +1,16 @@ --- -description: "Learn more about: Compiler Error C2512" title: "Compiler Error C2512" -ms.date: "02/09/2018" +description: "Learn more about: Compiler Error C2512" +ms.date: 02/09/2018 f1_keywords: ["C2512"] helpviewer_keywords: ["C2512"] -ms.assetid: 15206da9-1164-451a-b869-280e00711aad --- # Compiler Error C2512 > '*identifier*' : no appropriate default constructor available +## Remarks + A *default constructor*, a constructor that requires no arguments, is not available for the specified class, structure, or union. The compiler supplies a default constructor only if no user-defined constructors are provided. If you provide a constructor that takes a non-void parameter, and you want to allow your class to be created with no parameters (for example, as the elements of an array), you must also provide a default constructor. The default constructor can be a constructor with default values for all parameters. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2513.md b/docs/error-messages/compiler-errors-2/compiler-error-c2513.md index a8b17632744..f473c159cb8 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2513.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2513.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2513" title: "Compiler Error C2513" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2513" +ms.date: 11/04/2016 f1_keywords: ["C2513"] helpviewer_keywords: ["C2513"] -ms.assetid: ab5b21d3-61e2-4df7-8eea-6f14d6ba8620 --- # Compiler Error C2513 -'type' : no variable declared before '=' +> 'type' : no variable declared before '=' + +## Remarks The type specifier appears in declaration with no variable identifier. -The following sample generates C2513: +## Examples + +The following example generates C2513: ```cpp // C2513.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2514.md b/docs/error-messages/compiler-errors-2/compiler-error-c2514.md index 9d5d9b20d57..c42b99c7b3b 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2514.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2514.md @@ -1,20 +1,23 @@ --- -description: "Learn more about: Compiler Error C2514" title: "Compiler Error C2514" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2514" +ms.date: 11/04/2016 f1_keywords: ["C2514"] helpviewer_keywords: ["C2514"] -ms.assetid: 4b7085e5-6714-4261-80b7-bc72e64ab3e8 --- # Compiler Error C2514 -'class' : class has no constructors +> 'class' : class has no constructors + +## Remarks The class, structure, or union has no constructor with a parameter list that matches the parameters being used to instantiate it. A class must be fully declared before it can be instantiated. -The following sample generates C2514: +## Example + +The following example generates C2514: ```cpp // C2514.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2516.md b/docs/error-messages/compiler-errors-2/compiler-error-c2516.md index 187439712a0..80332510416 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2516.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2516.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2516" title: "Compiler Error C2516" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2516" +ms.date: 11/04/2016 f1_keywords: ["C2516"] helpviewer_keywords: ["C2516"] -ms.assetid: cd3accc1-0179-4a13-9587-616908c4ad1d --- # Compiler Error C2516 -'name' : is not a legal base class +> 'name' : is not a legal base class + +## Remarks The class is derived from a type name defined by a **`typedef`** statement. -The following sample generates C2516: +## Example + +The following example generates C2516: ```cpp // C2516.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2517.md b/docs/error-messages/compiler-errors-2/compiler-error-c2517.md index 4b06aacf31a..ef8d366347d 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2517.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2517.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Compiler Error C2517" title: "Compiler Error C2517" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2517" +ms.date: 11/04/2016 f1_keywords: ["C2517"] helpviewer_keywords: ["C2517"] -ms.assetid: d79348d5-e271-4aad-b973-8264515f8e90 --- # Compiler Error C2517 -'identifier' : right of '::' is undefined +> 'identifier' : right of '::' is undefined + +## Remarks The identifier on the right of the scope-resolution operator (`::`) must be a defined member of the class, structure, or union on the left. If no class, structure, or union is named, the identifier on the right must be declared with global scope. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2518.md b/docs/error-messages/compiler-errors-2/compiler-error-c2518.md index de3a5ceab9d..f87fee60c91 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2518.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2518.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2518" title: "Compiler Error C2518" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2518" +ms.date: 11/04/2016 f1_keywords: ["C2518"] helpviewer_keywords: ["C2518"] -ms.assetid: a7895b47-da90-4851-ac97-18e81479595a --- # Compiler Error C2518 -keyword 'keyword' illegal in base class list; ignored +> keyword 'keyword' illegal in base class list; ignored + +## Remarks The keywords **`class`** and **`struct`** should not appear in a base class list. -The following sample generates C2518: +## Example + +The following example generates C2518: ```cpp // C2518.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2521.md b/docs/error-messages/compiler-errors-2/compiler-error-c2521.md index dee34ce80d3..249652f2fd2 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2521.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2521.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Error C2521" title: "Compiler Error C2521" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2521" +ms.date: 11/04/2016 f1_keywords: ["C2521"] helpviewer_keywords: ["C2521"] -ms.assetid: 6042821b-e345-4a54-a7e9-a2c9019ea016 --- # Compiler Error C2521 -function does not take any arguments +> function does not take any arguments + +## Remarks You attempted to use arguments with a destructor or finalizer. @@ -16,7 +17,7 @@ For more information, see [Destructors and finalizers](../../dotnet/how-to-defin ## Example -The following sample generates C2521. +The following example generates C2521. ```cpp // C2521.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2523.md b/docs/error-messages/compiler-errors-2/compiler-error-c2523.md index 5b41bea97ec..0ae81bfb1d2 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2523.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2523.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2523" title: "Compiler Error C2523" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2523" +ms.date: 11/04/2016 f1_keywords: ["C2523"] helpviewer_keywords: ["C2523"] -ms.assetid: 7951b700-8f37-45a0-beb4-a79ae0ced72e --- # Compiler Error C2523 -'class::~identifier' : destructor/finalizer tag mismatch +> 'class::~identifier' : destructor/finalizer tag mismatch + +## Remarks The name of the destructor must be the class name preceded by a tilde (`~`). The constructor and destructor are the only members that have the same name as the class. -The following sample generates C2523: +## Example + +The following example generates C2523: ```cpp // C2523.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2524.md b/docs/error-messages/compiler-errors-2/compiler-error-c2524.md index 1614c50b8dd..b5d7096731c 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2524.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2524.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Error C2524" title: "Compiler Error C2524" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2524" +ms.date: 11/04/2016 f1_keywords: ["C2524"] helpviewer_keywords: ["C2524"] -ms.assetid: e71d17f5-2fc2-416b-8dbd-e9bed85eb33a --- # Compiler Error C2524 -'destructor' : a destructor/finalizer must have a 'void' parameter list +> 'destructor' : a destructor/finalizer must have a 'void' parameter list + +## Remarks The destructor or finalizer had a parameter list that is not [void](../../cpp/void-cpp.md). Other parameter types are not allowed. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2526.md b/docs/error-messages/compiler-errors-2/compiler-error-c2526.md index bd212154e23..9e02ec15aae 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2526.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2526.md @@ -1,17 +1,21 @@ --- -description: "Learn more about: Compiler Error C2526" title: "Compiler Error C2526" -ms.date: "03/08/2024" +description: "Learn more about: Compiler Error C2526" +ms.date: 03/08/2024 f1_keywords: ["C2526"] helpviewer_keywords: ["C2526"] --- # Compiler Error C2526 -'identifier1' : C linkage function cannot return C++ class 'identifier2' +> 'identifier1' : C linkage function cannot return C++ class 'identifier2' + +## Remarks A function defined with C linkage cannot return a user-defined type. -The following sample generates C2526: +## Example + +The following example generates C2526: ```cpp // C2526.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2528.md b/docs/error-messages/compiler-errors-2/compiler-error-c2528.md index a70528679d2..eb69976c237 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2528.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2528.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2528" title: "Compiler Error C2528" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2528" +ms.date: 11/04/2016 f1_keywords: ["C2528"] helpviewer_keywords: ["C2528"] -ms.assetid: 2ea9d583-67a8-4b16-b35f-a50eeffc03c4 --- # Compiler Error C2528 -'name' : pointer to reference is illegal +> 'name' : pointer to reference is illegal + +## Remarks You cannot declare a pointer to a reference. Dereference the variable before declaring a pointer to it. -The following sample generates C2528: +## Example + +The following example generates C2528: ```cpp // C2528.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2529.md b/docs/error-messages/compiler-errors-2/compiler-error-c2529.md index 6a7223a5af7..bec04c6a15f 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2529.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2529.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2529" title: "Compiler Error C2529" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2529" +ms.date: 11/04/2016 f1_keywords: ["C2529"] helpviewer_keywords: ["C2529"] -ms.assetid: 73a99e55-b91e-488d-9b72-cc80faaeb436 --- # Compiler Error C2529 -'name' : reference to reference is illegal +> 'name' : reference to reference is illegal + +## Remarks This error may be fixed by using pointer syntax and declaring a reference to a pointer. -The following sample generates C2529: +## Example + +The following example generates C2529: ```cpp // C2529.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2530.md b/docs/error-messages/compiler-errors-2/compiler-error-c2530.md index 4aff7437f14..17a71250c71 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2530.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2530.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Error C2530" title: "Compiler Error C2530" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2530" +ms.date: 11/04/2016 f1_keywords: ["C2530"] helpviewer_keywords: ["C2530"] -ms.assetid: b790a312-48df-4a6a-9e27-be2c5f32f16c --- # Compiler Error C2530 -'identifier' : references must be initialized +> 'identifier' : references must be initialized + +## Remarks You must initialize a reference when it was declared, unless it is declared already: @@ -20,7 +21,9 @@ You must initialize a reference when it was declared, unless it is declared alre - As the return type of a function. -The following sample generates C2530: +## Example + +The following example generates C2530: ```cpp // C2530.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2531.md b/docs/error-messages/compiler-errors-2/compiler-error-c2531.md index ea98a6788e1..f6015c2c29f 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2531.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2531.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2531" title: "Compiler Error C2531" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2531" +ms.date: 11/04/2016 f1_keywords: ["C2531"] helpviewer_keywords: ["C2531"] -ms.assetid: c49afe15-55f8-4dc8-ac01-bf653622a7db --- # Compiler Error C2531 -'identifier' : reference to a bit field illegal +> 'identifier' : reference to a bit field illegal + +## Remarks References to bit fields are not allowed. -The following sample generates C2531: +## Example + +The following example generates C2531: ```cpp // C2531.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2532.md b/docs/error-messages/compiler-errors-2/compiler-error-c2532.md index 3b23c6eeeb6..80856245d87 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2532.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2532.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Compiler Error C2532" title: "Compiler Error C2532" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2532" +ms.date: 11/04/2016 f1_keywords: ["C2532"] helpviewer_keywords: ["C2532"] -ms.assetid: a94fdf13-5063-4206-b5a5-374930287bee --- # Compiler Error C2532 -'identifier' : illegal modifier for reference +> 'identifier' : illegal modifier for reference + +## Remarks The reference was changed. References cannot be modified to refer to another object. Use a pointer instead. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2533.md b/docs/error-messages/compiler-errors-2/compiler-error-c2533.md index bc17130d602..025404ed61d 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2533.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2533.md @@ -1,20 +1,23 @@ --- -description: "Learn more about: Compiler Error C2533" title: "Compiler Error C2533" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2533" +ms.date: 11/04/2016 f1_keywords: ["C2533"] helpviewer_keywords: ["C2533"] -ms.assetid: 5b335652-076c-4824-87c8-a741f64a3ce0 --- # Compiler Error C2533 -'identifier' : constructors not allowed a return type +> 'identifier' : constructors not allowed a return type + +## Remarks A constructor cannot have a return type (not even a **`void`** return type). A common source of this error is a missing semicolon between the end of a class definition and the first constructor implementation. The compiler sees the class as a definition of the return type for the constructor function, and generates C2533. -The following sample generates C2533, and shows how to fix it: +## Example + +The following example generates C2533, and shows how to fix it: ```cpp // C2533.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2534.md b/docs/error-messages/compiler-errors-2/compiler-error-c2534.md index 71081526b9a..514403e602d 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2534.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2534.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2534" title: "Compiler Error C2534" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2534" +ms.date: 11/04/2016 f1_keywords: ["C2534"] helpviewer_keywords: ["C2534"] -ms.assetid: 481f9f54-5b51-4aa0-8eea-218f10807705 --- # Compiler Error C2534 -'identifier' : constructor cannot return a value +> 'identifier' : constructor cannot return a value + +## Remarks A constructor cannot contain a **`return`** statement with an expression (even if the expression has type **`void`**). This differs from regular void-returning function where a return expression of type **`void`** is allowed. However, using the **`return`** statement without an expression is allowed for early returns in the constructor. -The following sample generates C2534: +## Example + +The following example generates C2534: ```cpp // C2534.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2535.md b/docs/error-messages/compiler-errors-2/compiler-error-c2535.md index 3ead6411365..cb2505b77c7 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2535.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2535.md @@ -1,20 +1,23 @@ --- -description: "Learn more about: Compiler Error C2535" title: "Compiler Error C2535" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2535" +ms.date: 11/04/2016 f1_keywords: ["C2535"] helpviewer_keywords: ["C2535"] -ms.assetid: a958f83e-e2bf-4a59-b44b-d406ec325d7e --- # Compiler Error C2535 -'identifier' : member function already defined or declared +> 'identifier' : member function already defined or declared + +## Remarks This error could be caused by using the same formal parameter list in more than one definition or declaration of an overloaded function. If you get C2535 because of the Dispose function, see [Destructors and finalizers](../../dotnet/how-to-define-and-consume-classes-and-structs-cpp-cli.md#BKMK_Destructors_and_finalizers) for more information. -The following sample generates C2535: +## Example + +The following example generates C2535: ```cpp // C2535.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2537.md b/docs/error-messages/compiler-errors-2/compiler-error-c2537.md index 10f8c006259..2a767197bcb 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2537.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2537.md @@ -1,17 +1,21 @@ --- -description: "Learn more about: Compiler Error C2537" title: "Compiler Error C2537" -ms.date: "03/08/2024" +description: "Learn more about: Compiler Error C2537" +ms.date: 03/08/2024 f1_keywords: ["C2537"] helpviewer_keywords: ["C2537"] --- # Compiler Error C2537 -'specifier' : illegal linkage specification +> 'specifier' : illegal linkage specification + +## Remarks The linkage specifier is not supported. Only the "C" and "C++" linkage specifiers are supported. -The following sample generates C2537: +## Example + +The following example generates C2537: ```cpp // C2537.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2540.md b/docs/error-messages/compiler-errors-2/compiler-error-c2540.md index 89a2a496ade..0278d815c0e 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2540.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2540.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2540" title: "Compiler Error C2540" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2540" +ms.date: 11/04/2016 f1_keywords: ["C2540"] helpviewer_keywords: ["C2540"] -ms.assetid: 92c805a3-2dd9-46ca-a63d-3845c18ecc95 --- # Compiler Error C2540 -non-constant expression as array bound +> non-constant expression as array bound + +## Remarks An array must have a constant bound. -The following sample generates C2540: +## Example + +The following example generates C2540: ```cpp // C2540.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2541.md b/docs/error-messages/compiler-errors-2/compiler-error-c2541.md index ac2e94c4f96..54bc47b02b4 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2541.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2541.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2541" title: "Compiler Error C2541" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2541" +ms.date: 11/04/2016 f1_keywords: ["C2541"] helpviewer_keywords: ["C2541"] -ms.assetid: ed95180f-00df-4e62-a8e9-1b6dab8281bf --- # Compiler Error C2541 -'delete' : delete : cannot delete objects that are not pointers +> 'delete' : delete : cannot delete objects that are not pointers + +## Remarks The [delete](../../cpp/delete-operator-cpp.md) operator was used on an object that is not a pointer. -The following sample generates C2541: +## Example + +The following example generates C2541: ```cpp // C2541.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2542.md b/docs/error-messages/compiler-errors-2/compiler-error-c2542.md index c35adf15529..b41ae2e7d22 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2542.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2542.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Error C2542" title: "Compiler Error C2542" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2542" +ms.date: 11/04/2016 f1_keywords: ["C2542"] helpviewer_keywords: ["C2542"] -ms.assetid: a984520d-f835-4cac-ac0e-7f1d5f5c6278 --- # Compiler Error C2542 -'identifier' : class object has no constructor for initialization +> 'identifier' : class object has no constructor for initialization + +## Remarks There is no constructor with a parameter list that matches the initialization. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2543.md b/docs/error-messages/compiler-errors-2/compiler-error-c2543.md index b4167a06053..6f695891d1e 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2543.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2543.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Error C2543" title: "Compiler Error C2543" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2543" +ms.date: 11/04/2016 f1_keywords: ["C2543"] helpviewer_keywords: ["C2543"] -ms.assetid: 6e4d2d03-ef34-4514-92fe-763543a71fa8 --- # Compiler Error C2543 -expected ']' for operator '[]' +> expected ']' for operator '[]' + +## Remarks The subscripting operator is missing a left bracket. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2544.md b/docs/error-messages/compiler-errors-2/compiler-error-c2544.md index 7f975f4a00f..5a664fae23a 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2544.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2544.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Error C2544" title: "Compiler Error C2544" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2544" +ms.date: 11/04/2016 f1_keywords: ["C2544"] helpviewer_keywords: ["C2544"] -ms.assetid: 8e79b74a-4e92-4752-a5fe-c3143dfc5524 --- # Compiler Error C2544 -expected ')' for operator '()' +> expected ')' for operator '()' + +## Remarks The function call operator is missing a left parenthesis. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2545.md b/docs/error-messages/compiler-errors-2/compiler-error-c2545.md index 65bbf221f32..bbf07446c62 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2545.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2545.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Error C2545" title: "Compiler Error C2545" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2545" +ms.date: 11/04/2016 f1_keywords: ["C2545"] helpviewer_keywords: ["C2545"] -ms.assetid: 51598eb9-0c57-4306-a0cd-3862980f3672 --- # Compiler Error C2545 -'operator' : unable to find overloaded operator +> 'operator' : unable to find overloaded operator + +## Remarks The operator cannot be used with the operands provided. You must supply an overloaded operator with the required operands. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2548.md b/docs/error-messages/compiler-errors-2/compiler-error-c2548.md index 6b59cfc2b60..5c8525181bb 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2548.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2548.md @@ -1,28 +1,30 @@ --- -description: "Learn more about: Compiler Error C2548" title: "Compiler error C2548" -ms.date: "03/01/2024" +description: "Learn more about: Compiler Error C2548" +ms.date: 03/01/2024 f1_keywords: ["C2548"] helpviewer_keywords: ["C2548"] --- # Compiler error C2548 -'class::member' : missing default parameter for parameter parameter +> 'class::member' : missing default parameter for parameter parameter + +## Remarks The default parameter list is missing a parameter. If you supply a default parameter anywhere in a parameter list, you must define default parameters for all subsequent parameters in the current declaration or any previous declarations within the same scope. ## Example -The following sample generates C2548 for: +The following example generates C2548 for: - `func1` because it's missing the default argument `b`. - `func3` because it's missing the default argument `c`. -The following sample doesn't generate C2548 for: +The following example doesn't generate C2548 for: - `func2` because all the required default arguments are supplied. -- The second `func4` declaration because the default argument `c` is supplied in the preceding declaration and is in the same scope. -- The third `func4` declaration because both default arguments `b` and `c` are provided previously. +- The second `func4` declaration because the default argument `c` is supplied in the preceding declaration and is in the same scope. +- The third `func4` declaration because both default arguments `b` and `c` are provided previously. ```cpp // C2548.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2549.md b/docs/error-messages/compiler-errors-2/compiler-error-c2549.md index 95ea293aa90..a779b7adf17 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2549.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2549.md @@ -1,16 +1,17 @@ --- -description: "Learn more about: Compiler Error C2549" title: "Compiler Error C2549" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2549" +ms.date: 11/04/2016 f1_keywords: ["C2549"] helpviewer_keywords: ["C2549"] -ms.assetid: 29310094-54a3-4605-bc6d-a312a68daf5d --- # Compiler Error C2549 -user-defined conversion cannot specify a return type +> user-defined conversion cannot specify a return type + +## Example -The following sample generates C2549: +The following example generates C2549: ```cpp // C2549.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2550.md b/docs/error-messages/compiler-errors-2/compiler-error-c2550.md index 12046ba0826..eac2acfcd2a 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2550.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2550.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2550" title: "Compiler Error C2550" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2550" +ms.date: 11/04/2016 f1_keywords: ["C2550"] helpviewer_keywords: ["C2550"] -ms.assetid: 3293f53e-ee66-4035-920d-34e115c3a24c --- # Compiler Error C2550 -'identifier' : constructor initializer lists are only allowed on constructor definitions +> 'identifier' : constructor initializer lists are only allowed on constructor definitions + +## Remarks A base class initializer list is used on the definition of a function that is not a constructor. -The following sample generates C2550: +## Example + +The following example generates C2550: ```cpp // C2550.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2551.md b/docs/error-messages/compiler-errors-2/compiler-error-c2551.md index a0bff6271a9..26983767f91 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2551.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2551.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Compiler Error C2551" title: "Compiler Error C2551" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2551" +ms.date: 11/04/2016 f1_keywords: ["C2551"] helpviewer_keywords: ["C2551"] -ms.assetid: 6f48b91d-635b-4eef-b13c-1bf2056c1053 --- # Compiler Error C2551 -'void *' type needs explicit cast +> 'void *' type needs explicit cast + +## Remarks A **`void`** pointer is assigned to a nonvoid pointer by implicit conversion. You must use an explicit cast. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2552.md b/docs/error-messages/compiler-errors-2/compiler-error-c2552.md index c3714405422..e995484a613 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2552.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2552.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Error C2552" title: "Compiler Error C2552" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2552" +ms.date: 11/04/2016 f1_keywords: ["C2552"] helpviewer_keywords: ["C2552"] -ms.assetid: 0e0ab759-788a-4faf-9337-80d4b9e2e8c9 --- # Compiler Error C2552 -'identifier' : non-aggregates cannot be initialized with initializer list +> 'identifier' : non-aggregates cannot be initialized with initializer list + +## Remarks The aggregate identifier was incorrectly initialized. @@ -42,7 +43,9 @@ The following represent the reasons C2552 may fire when an aggregate initializat - The type has a non-fixed dimension array (zero-array) whose elements have destructors. -The following sample generates C2552: +## Example + +The following example generates C2552: ```cpp // C2552.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2553.md b/docs/error-messages/compiler-errors-2/compiler-error-c2553.md index 4db5c543e36..bf468cd7234 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2553.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2553.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2553" title: "Compiler Error C2553" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2553" +ms.date: 11/04/2016 f1_keywords: ["C2553"] helpviewer_keywords: ["C2553"] -ms.assetid: 64bc1e9a-627f-4ce9-b7bc-dc911bdb9180 --- # Compiler Error C2553 -'base_function': overriding virtual function return type differs from 'override_function' +> 'base_function': overriding virtual function return type differs from 'override_function' + +## Remarks A function in a derived class attempted to override a virtual function in a base class, but the derived class function did not have the same return type as the base class function. An override function signature must match the signature of the function being overridden. -The following sample generates C2553: +## Example + +The following example generates C2553: ```cpp // C2553.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2555.md b/docs/error-messages/compiler-errors-2/compiler-error-c2555.md index 787b255c78b..e8d97e2e695 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2555.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2555.md @@ -1,19 +1,18 @@ --- title: "Compiler Error C2555" description: "Reference for Visual Studio C++ compiler error C2555." -ms.date: "03/30/2020" +ms.date: 03/30/2020 f1_keywords: ["C2555"] helpviewer_keywords: ["C2555"] -ms.assetid: 5e49ebb8-7c90-457a-aa12-7ca7ab6574b2 --- # Compiler Error C2555 > '*class1*::*function1*': overriding virtual function return type differs and is not covariant from '*class2*::*function2*' -A virtual function and a derived overriding function have identical parameter lists but different return types. - ## Remarks +A virtual function and a derived overriding function have identical parameter lists but different return types. + In C++, an overriding function in a derived class can't differ only by return type from a virtual function in a base class. There's an exception to this rule for certain return types. When a derived class overrides a public base class, it may return a pointer or reference to the derived class instead of a base-class pointer or reference. These return types are called *covariant*, because they vary together with the type. This rule exception doesn't allow covariant reference-to-pointer or pointer-to-pointer types. @@ -34,7 +33,7 @@ is Guid CheckSources(Guid sourceID, Guid carouselIDs[]) []; ``` -The following sample generates C2555: +The following example generates C2555: ```cpp // C2555.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2556.md b/docs/error-messages/compiler-errors-2/compiler-error-c2556.md index c53302f927a..25a188c34cd 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2556.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2556.md @@ -1,25 +1,26 @@ --- -description: "Learn more about: Compiler Error C2556" title: "Compiler Error C2556" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2556" +ms.date: 06/29/2025 f1_keywords: ["C2556"] helpviewer_keywords: ["C2556"] -ms.assetid: fc4399ad-45b3-49fd-be1f-0b13956a595a --- # Compiler Error C2556 -'identifier' : overloaded functions only differ by return type +> '*function1*': overloaded function differs only by return type from '*function2*' + +## Remarks The overloaded functions have different return types but the same parameter list. Each overloaded function must have a distinct formal parameter list. -The following sample generates C2556: +## Example + +The following example generates C2556: ```cpp // C2556.cpp // compile with: /c -class C { - int func(); - double func(); // C2556 - int func(int i); // ok parameter lists differ -}; +int func(); +double func(); // C2556 +int func(int i); // OK parameter lists differ ``` diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2557.md b/docs/error-messages/compiler-errors-2/compiler-error-c2557.md index cb0f2c74826..63bc8d7a2fc 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2557.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2557.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Compiler Error C2557" title: "Compiler Error C2557" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2557" +ms.date: 11/04/2016 f1_keywords: ["C2557"] helpviewer_keywords: ["C2557"] -ms.assetid: 48a33d82-aa16-4658-b346-2311fcb39864 --- # Compiler Error C2557 -'identifier' : private and protected members cannot be initialized without a constructor +> 'identifier' : private and protected members cannot be initialized without a constructor + +## Remarks Only members and friends can assign a value to a private or protected member. Nonpublic members should be initialized in the class constructor. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2558.md b/docs/error-messages/compiler-errors-2/compiler-error-c2558.md index eb0b6683dec..0b53dfa4199 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2558.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2558.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Error C2558" title: "Compiler Error C2558" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2558" +ms.date: 11/04/2016 f1_keywords: ["C2558"] helpviewer_keywords: ["C2558"] -ms.assetid: 822b701e-dcae-423a-b21f-47f36aff9c90 --- # Compiler Error C2558 -'identifier' : no copy constructor available or copy constructor is declared 'explicit' +> 'identifier' : no copy constructor available or copy constructor is declared 'explicit' + +## Remarks A copy constructor initializes an object from another object of the same type. (It makes a copy of the object.) The compiler generates a default copy constructor if you do not define any constructors. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2561.md b/docs/error-messages/compiler-errors-2/compiler-error-c2561.md index 474c57ced61..82c6dd35778 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2561.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2561.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Error C2561" title: "Compiler Error C2561" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2561" +ms.date: 11/04/2016 f1_keywords: ["C2561"] helpviewer_keywords: ["C2561"] -ms.assetid: 0abe955b-53a6-4a3c-8362-b1a8eb40e8d1 --- # Compiler Error C2561 -'identifier' : function must return a value +> 'identifier' : function must return a value + +## Remarks The function was declared as returning a value, but the function definition does not contain a **`return`** statement. @@ -20,7 +21,9 @@ This error can be caused by an incorrect function prototype: 1. C++ functions containing inline assembly routines that store the return value in the `AX` register may need a return statement. Copy the value in `AX` to a temporary variable and return that variable from the function. -The following sample generates C2561: +## Example + +The following example generates C2561: ```cpp // C2561.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2562.md b/docs/error-messages/compiler-errors-2/compiler-error-c2562.md index 9e95f4fecd7..b0a67f988fc 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2562.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2562.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Error C2562" title: "Compiler Error C2562" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2562" +ms.date: 11/04/2016 f1_keywords: ["C2562"] helpviewer_keywords: ["C2562"] -ms.assetid: 2c41e511-9952-4b98-9976-6b1523613e1b --- # Compiler Error C2562 -'identifier' : 'void' function returning a value +> 'identifier' : 'void' function returning a value + +## Remarks The function is declared as **`void`** but returns a value. @@ -16,7 +17,9 @@ This error can be caused by an incorrect function prototype. This error may be fixed if you specify the return type in the function declaration. -The following sample generates C2562: +## Example + +The following example generates C2562: ```cpp // C2562.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2563.md b/docs/error-messages/compiler-errors-2/compiler-error-c2563.md index 5b7c1e30083..8a0d90be59e 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2563.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2563.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2563" title: "Compiler Error C2563" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2563" +ms.date: 11/04/2016 f1_keywords: ["C2563"] helpviewer_keywords: ["C2563"] -ms.assetid: 54abba68-6458-4ca5-894d-3babdb7b3552 --- # Compiler Error C2563 -mismatch in formal parameter list +> mismatch in formal parameter list + +## Remarks The formal parameter list of a function (or a pointer to a function) does not match those of another function (or pointer to a member function). As a result, the assignment of functions or pointers cannot be made. -The following sample generates C2563: +## Example + +The following example generates C2563: ```cpp // C2563.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2566.md b/docs/error-messages/compiler-errors-2/compiler-error-c2566.md index 1deba5aad6c..728f0d13a2f 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2566.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2566.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Compiler Error C2566" title: "Compiler Error C2566" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2566" +ms.date: 11/04/2016 f1_keywords: ["C2566"] helpviewer_keywords: ["C2566"] -ms.assetid: 8fe10fb2-d974-432a-a56b-3a61b9a8dfc2 --- # Compiler Error C2566 -overloaded function in conditional expression +> overloaded function in conditional expression + +## Remarks An overloaded function in a conditional expression cannot be evaluated. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2567.md b/docs/error-messages/compiler-errors-2/compiler-error-c2567.md index cda3fa6ee81..9e75dfef04b 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2567.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2567.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Error C2567" title: "Compiler Error C2567" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2567" +ms.date: 11/04/2016 f1_keywords: ["C2567"] helpviewer_keywords: ["C2567"] -ms.assetid: 9c140ac9-7059-47e6-9ba1-e7939c8c0dc3 --- # Compiler Error C2567 -unable to open metadata in 'file', file may have been deleted or moved +> unable to open metadata in 'file', file may have been deleted or moved + +## Remarks A metadata file that was referenced in source (with `#using`) was not found in the same directory by the compiler back end process as it was by the compiler front end process. See [#using Directive](../../preprocessor/hash-using-directive-cpp.md) for more information. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2568.md b/docs/error-messages/compiler-errors-2/compiler-error-c2568.md index a68ce21d1c6..20930150ec5 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2568.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2568.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Compiler Error C2568" title: "Compiler Error C2568" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2568" +ms.date: 11/04/2016 f1_keywords: ["C2568"] helpviewer_keywords: ["C2568"] -ms.assetid: 140b4dc9-5a88-4032-9aef-a224bb796f72 --- # Compiler Error C2568 -'identifier1' : unable to resolve function overload +> 'identifier1' : unable to resolve function overload + +## Remarks The compiler cannot determine which overloaded function to call. The actual parameters passed to the function must be cast to match the formal parameters for one of the overloaded function, but no one match is unambiguously better than all others. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2569.md b/docs/error-messages/compiler-errors-2/compiler-error-c2569.md index d3ac69ec987..ca20d30dba3 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2569.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2569.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2569" title: "Compiler Error C2569" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2569" +ms.date: 11/04/2016 f1_keywords: ["C2569"] helpviewer_keywords: ["C2569"] -ms.assetid: 092bed1e-f631-436c-9586-7750629f6fac --- # Compiler Error C2569 -'EnumOrUnion' : enum/union cannot be used as a base class +> 'EnumOrUnion' : enum/union cannot be used as a base class + +## Remarks If you must derive a type from the specified union or enumeration, change the union or enumeration to a class or structure. -The following sample generates C2569: +## Example + +The following example generates C2569: ```cpp // C2569.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2570.md b/docs/error-messages/compiler-errors-2/compiler-error-c2570.md index 161805be9e0..29977145390 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2570.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2570.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2570" title: "Compiler Error C2570" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2570" +ms.date: 11/04/2016 f1_keywords: ["C2570"] helpviewer_keywords: ["C2570"] -ms.assetid: d65d0b32-2fac-464a-bcdf-0ebcedf3bf32 --- # Compiler Error C2570 -'identifier' : union cannot have base classes +> 'identifier' : union cannot have base classes + +## Remarks A union derives from a class, structure, or union. This is not allowed. Declare the derived type as a class or structure instead. -The following sample generates C2570: +## Example + +The following example generates C2570: ```cpp // C2570.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2571.md b/docs/error-messages/compiler-errors-2/compiler-error-c2571.md index ac2efce8e24..358d64654b2 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2571.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2571.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Error C2571" title: "Compiler Error C2571" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2571" +ms.date: 11/04/2016 f1_keywords: ["C2571"] helpviewer_keywords: ["C2571"] -ms.assetid: c6522616-dee9-4d7d-9bf8-30a7e1deaadf --- # Compiler Error C2571 -'function' : virtual function cannot be in union 'union' +> 'function' : virtual function cannot be in union 'union' + +## Remarks A union is declared with a virtual function. You can declare a virtual function only in a class or structure. Possible resolutions: @@ -16,7 +17,9 @@ A union is declared with a virtual function. You can declare a virtual function 1. Make the function nonvirtual. -The following sample generates C2571: +## Example + +The following example generates C2571: ```cpp // C2571.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2572.md b/docs/error-messages/compiler-errors-2/compiler-error-c2572.md index eec5bbb70f0..44a23efa094 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2572.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2572.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2572" title: "Compiler Error C2572" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2572" +ms.date: 11/04/2016 f1_keywords: ["C2572"] helpviewer_keywords: ["C2572"] -ms.assetid: f1a42d69-727d-4ce5-88c8-d5f55dea66ac --- # Compiler Error C2572 -'class::member' : redefinition of default parameter : parameter param +> 'class::member' : redefinition of default parameter : parameter param + +## Remarks Default parameters cannot be redefined. If you require another value for the parameter, the default parameter should be left undefined. -The following sample generates C2572: +## Example + +The following example generates C2572: ```cpp // C2572.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2573.md b/docs/error-messages/compiler-errors-2/compiler-error-c2573.md index 435289285d2..28c8053df8d 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2573.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2573.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Compiler Error C2573" title: "Compiler Error C2573" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2573" +ms.date: 11/04/2016 f1_keywords: ["C2573"] helpviewer_keywords: ["C2573"] -ms.assetid: 2ce523da-da3c-4fb4-bad2-fbde663dbfbf --- # Compiler Error C2573 -'class' : cannot delete pointers to objects of this type; the class has no non-placement overload for 'operator delete'. +> 'class' : cannot delete pointers to objects of this type; the class has no non-placement overload for 'operator delete'. + +## Remarks The class is missing a non-placement delete operator. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2574.md b/docs/error-messages/compiler-errors-2/compiler-error-c2574.md index 0581e78c1fa..cc557824ff5 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2574.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2574.md @@ -1,25 +1,30 @@ --- -description: "Learn more about: Compiler Error C2574" title: "Compiler Error C2574" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2574" +ms.date: 06/04/2025 f1_keywords: ["C2574"] helpviewer_keywords: ["C2574"] -ms.assetid: 3e1c5c18-ee8b-4dbb-bfc0-d3b8991af71b --- # Compiler Error C2574 -'destructor' : cannot be declared static +> '*function*': cannot be declared static + +## Remarks -Neither destructors nor constructors can be declared **`static`**. +Neither [constructors](../../cpp/constructors-cpp.md) nor [destructors](../../cpp/destructors-cpp.md) can be declared **`static`**. -The following sample generates C2574: +## Example + +The following example generates C2574: ```cpp // C2574.cpp // compile with: /c -class A { - virtual static ~A(); // C2574 - // try the following line instead - // virtual ~A(); +struct S +{ + static S() {} // C2574 + + // Try the following line instead: + // S() {} }; ``` diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2575.md b/docs/error-messages/compiler-errors-2/compiler-error-c2575.md index ac5c97f6e50..1e9527cef38 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2575.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2575.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2575" title: "Compiler Error C2575" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2575" +ms.date: 11/04/2016 f1_keywords: ["C2575"] helpviewer_keywords: ["C2575"] -ms.assetid: 9eb45706-37ef-4481-b373-6d193ba13634 --- # Compiler Error C2575 -'identifier' : only member functions and bases can be virtual +> 'identifier' : only member functions and bases can be virtual + +## Remarks A global function or class is declared **`virtual`**. This is not allowed. -The following sample generates C2575: +## Example + +The following example generates C2575: ```cpp // C2575.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2577.md b/docs/error-messages/compiler-errors-2/compiler-error-c2577.md index c935a62d6f2..45c7e0f6b16 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2577.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2577.md @@ -1,20 +1,21 @@ --- -description: "Learn more about: Compiler Error C2577" title: "Compiler Error C2577" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2577" +ms.date: 11/04/2016 f1_keywords: ["C2577"] helpviewer_keywords: ["C2577"] -ms.assetid: fc79ef83-8362-40a2-9257-8037c3195ce4 --- # Compiler Error C2577 -'member' : destructor/finalizer cannot have a return type +> 'member' : destructor/finalizer cannot have a return type + +## Remarks A destructor or finalizer cannot return a value of **`void`** or any other type. Remove the **`return`** statement from the destructor definition. ## Example -The following sample generates C2577. +The following example generates C2577. ```cpp // C2577.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2579.md b/docs/error-messages/compiler-errors-2/compiler-error-c2579.md index f40da38fe60..f4e504ca778 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2579.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2579.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Compiler Error C2579" title: "Compiler Error C2579" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2579" +ms.date: 11/04/2016 f1_keywords: ["C2579"] helpviewer_keywords: ["C2579"] -ms.assetid: ab090a8d-5462-4046-a1a6-8007e354dedb --- # Compiler Error C2579 -unable to resolve type 'type' (offset). It is expected in file +> unable to resolve type 'type' (offset). It is expected in file + +## Remarks C2579 always follows C4691. For more information, see [Compiler Warning (level 1) C4691](../../error-messages/compiler-warnings/compiler-warning-level-1-c4691.md). diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2581.md b/docs/error-messages/compiler-errors-2/compiler-error-c2581.md index c6e7b9a608c..9097b0b6b34 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2581.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2581.md @@ -1,20 +1,21 @@ --- -description: "Learn more about: Compiler Error C2581" title: "Compiler Error C2581" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2581" +ms.date: 11/04/2016 f1_keywords: ["C2581"] helpviewer_keywords: ["C2581"] -ms.assetid: 24a4e4c1-24d3-4e42-b760-7dcaf9740b16 --- # Compiler Error C2581 -'type' : static 'operator =' function is illegal +> 'type' : static 'operator =' function is illegal + +## Remarks The assignment (`=`) operator is incorrectly declared as **`static`**. Assignment operators cannot be **`static`**. For more information, see [User-Defined Operators (C++/CLI)](../../dotnet/user-defined-operators-cpp-cli.md). ## Example -The following sample generates C2581. +The following example generates C2581. ```cpp // C2581.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2582.md b/docs/error-messages/compiler-errors-2/compiler-error-c2582.md index 82484c7c1ad..2a57df672e8 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2582.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2582.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2582" title: "Compiler Error C2582" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2582" +ms.date: 11/04/2016 f1_keywords: ["C2582"] helpviewer_keywords: ["C2582"] -ms.assetid: ee1b9378-8bcd-4792-b87e-6d7a466d29ed --- # Compiler Error C2582 -'function' function is unavailable in 'type' +> 'function' function is unavailable in 'type' + +## Remarks An attempt was made to assign to an object that does not have an assignment operator. -The following sample generates C2582: +## Example + +The following example generates C2582: ```cpp // C2582.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2583.md b/docs/error-messages/compiler-errors-2/compiler-error-c2583.md index be529b59a76..e6a0d840758 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2583.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2583.md @@ -1,28 +1,30 @@ --- -description: "Learn more about: Compiler Error C2583" title: "Compiler Error C2583" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2583" +ms.date: 06/06/2025 f1_keywords: ["C2583"] helpviewer_keywords: ["C2583"] -ms.assetid: b1c952dc-872c-47e4-9fc8-4dd72bcee6f9 --- # Compiler Error C2583 -'identifier' : 'const/volatile' 'this' pointer is illegal for constructors/destructors +> '*identifier*': '*const/volatile*' 'this' pointer is illegal for constructors/destructors + +## Remarks + +A [constructor](../../cpp/constructors-cpp.md) or [destructor](../../cpp/destructors-cpp.md) can't be declared **`const`** or **`volatile`**. -A constructor or destructor is declared **`const`** or **`volatile`**. This is not allowed. +## Example -The following sample generates C2583: +The following example generates C2583: ```cpp // C2583.cpp // compile with: /c -class A { -public: - int i; - A() const; // C2583 +struct S +{ + S() const {} // C2583 - // try the following line instead - // A(); + // Try the following line instead: + // S() {} }; ``` diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2584.md b/docs/error-messages/compiler-errors-2/compiler-error-c2584.md index e63ec9e0542..8164ce8b38c 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2584.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2584.md @@ -1,20 +1,21 @@ --- -description: "Learn more about: Compiler Error C2584" title: "Compiler Error C2584" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2584" +ms.date: 11/04/2016 f1_keywords: ["C2584"] helpviewer_keywords: ["C2584"] -ms.assetid: 836e2c0a-86c0-4742-b432-beb0191ad20e --- # Compiler Error C2584 -'Class' : direct base 'Base2' is inaccessible; already a base of 'Base1' +> 'Class' : direct base 'Base2' is inaccessible; already a base of 'Base1' + +## Remarks `Class` already derives directly from `Base1`. `Base2` also derives from `Base1`. `Class` cannot derive from `Base2` because that would mean inheriting (indirectly) from `Base1` again, which is not legal because `Base1` is already a direct base class. ## Example -The following sample generates C2584. +The following example generates C2584. ```cpp // C2584.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2585.md b/docs/error-messages/compiler-errors-2/compiler-error-c2585.md index 7ced014cea2..32c34f271a4 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2585.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2585.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Error C2585" title: "Compiler Error C2585" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2585" +ms.date: 11/04/2016 f1_keywords: ["C2585"] helpviewer_keywords: ["C2585"] -ms.assetid: 05bb1a9c-28fb-4a88-a1b5-aea85ebdee1c --- # Compiler Error C2585 -explicit conversion to 'type' is ambiguous +> explicit conversion to 'type' is ambiguous + +## Remarks The type conversion can produce more than one result. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2586.md b/docs/error-messages/compiler-errors-2/compiler-error-c2586.md index a5767ea958e..412a45f14d8 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2586.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2586.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2586" title: "Compiler Error C2586" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2586" +ms.date: 11/04/2016 f1_keywords: ["C2586"] helpviewer_keywords: ["C2586"] -ms.assetid: dae703c7-5c38-4db6-8411-4d1b22713eb5 --- # Compiler Error C2586 -incorrect user-defined conversion syntax : illegal indirections +> incorrect user-defined conversion syntax : illegal indirections + +## Remarks Indirection of a conversion operator is not allowed. -The following sample generates C2586: +## Example + +The following example generates C2586: ```cpp // c2586.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2587.md b/docs/error-messages/compiler-errors-2/compiler-error-c2587.md index dd0b86bde45..f70167f35f9 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2587.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2587.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2587" title: "Compiler Error C2587" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2587" +ms.date: 11/04/2016 f1_keywords: ["C2587"] helpviewer_keywords: ["C2587"] -ms.assetid: 7637a2c7-35d4-4b5a-a8f2-515a7bda98fd --- # Compiler Error C2587 -'identifier' : illegal use of local variable as default parameter +> 'identifier' : illegal use of local variable as default parameter + +## Remarks Local variables are not allowed as default parameters. -The following sample generates C2587: +## Example + +The following example generates C2587: ```cpp // C2587.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2588.md b/docs/error-messages/compiler-errors-2/compiler-error-c2588.md index 97560fa93c1..774f364b96c 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2588.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2588.md @@ -1,20 +1,23 @@ --- -description: "Learn more about: Compiler Error C2588" title: "Compiler Error C2588" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2588" +ms.date: 11/04/2016 f1_keywords: ["C2588"] helpviewer_keywords: ["C2588"] -ms.assetid: 19a0cabd-ca13-44a5-9be3-ee676abf9bc4 --- # Compiler Error C2588 -'::~identifier' : illegal global destructor +> '::~identifier' : illegal global destructor + +## Remarks The destructor is defined for something other than a class, structure, or union. This is not allowed. This error can be caused by a missing class, structure, or union name on the left side of the scope resolution (`::`) operator. -The following sample generates C2588: +## Example + +The following example generates C2588: ```cpp // C2588.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2589.md b/docs/error-messages/compiler-errors-2/compiler-error-c2589.md index e712be3b261..3f7e4fa6da6 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2589.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2589.md @@ -1,20 +1,23 @@ --- -description: "Learn more about: Compiler Error C2589" title: "Compiler Error C2589" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2589" +ms.date: 11/04/2016 f1_keywords: ["C2589"] helpviewer_keywords: ["C2589"] -ms.assetid: 1d7942c7-8a81-4bb4-b272-76a0019e8513 --- # Compiler Error C2589 -'identifier' : illegal token on right side of '::' +> 'identifier' : illegal token on right side of '::' + +## Remarks If a class, structure, or union name appears to the left of the scope-resolution operator (double colons), the token on the right must be a class, structure, or union member. Otherwise, any global identifier can appear on the right. The scope-resolution operator cannot be overloaded. -The following sample generates C2589: +## Example + +The following example generates C2589: ```cpp // C2589.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2592.md b/docs/error-messages/compiler-errors-2/compiler-error-c2592.md index 637edee9781..054f08281e8 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2592.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2592.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Compiler Error C2592" title: "Compiler Error C2592" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2592" +ms.date: 11/04/2016 f1_keywords: ["C2592"] helpviewer_keywords: ["C2592"] -ms.assetid: 833a4d7b-66ef-4d4c-ae83-a533c2b0eb07 --- # Compiler Error C2592 -'class': 'base_class_2' is inherited from 'base_class_1' and cannot be re-specified +> 'class': 'base_class_2' is inherited from 'base_class_1' and cannot be re-specified + +## Remarks You can only specify base classes that do not inherit from other base classes. In this case, only `base_class_1` is needed in the specification of **`class`** because `base_class_1` already inherits `base_class_2`. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2593.md b/docs/error-messages/compiler-errors-2/compiler-error-c2593.md index b12f1563fd6..b31ff336de4 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2593.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2593.md @@ -1,20 +1,23 @@ --- -description: "Learn more about: Compiler Error C2593" title: "Compiler Error C2593" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2593" +ms.date: 11/04/2016 f1_keywords: ["C2593"] helpviewer_keywords: ["C2593"] -ms.assetid: 4a0fe9bb-2163-447d-91f6-1890ed8250f6 --- # Compiler Error C2593 -'operator identifier' is ambiguous +> 'operator identifier' is ambiguous + +## Remarks More than one possible operator is defined for an overloaded operator. This error may be fixed if you use an explicit cast on one or more actual parameters. -The following sample generates C2593: +## Examples + +The following example generates C2593: ```cpp // C2593.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2594.md b/docs/error-messages/compiler-errors-2/compiler-error-c2594.md index a68fd0ce545..c962231113f 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2594.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2594.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2594" title: "Compiler Error C2594" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2594" +ms.date: 11/04/2016 f1_keywords: ["C2594"] helpviewer_keywords: ["C2594"] -ms.assetid: 68cd708f-266e-44b0-a211-3e3ab63b11bf --- # Compiler Error C2594 -'operator' : ambiguous conversions from 'type1' to 'type2' +> 'operator' : ambiguous conversions from 'type1' to 'type2' + +## Remarks No conversion from *type1* to *type2* was more direct than any other. We suggest two possible solutions to converting from *type1* to *type2*. The first option is to define a direct conversion from *type1* to *type2*, and the second option is to specify a sequence of conversions from *type1* to *type2*. -The following sample generates C2594. The suggested resolution to the error is a sequence of conversions: +## Example + +The following example generates C2594. The suggested resolution to the error is a sequence of conversions: ```cpp // C2594.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2597.md b/docs/error-messages/compiler-errors-2/compiler-error-c2597.md index 1c77cfc6004..ed1bcf191ce 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2597.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2597.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Error C2597" title: "Compiler Error C2597" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2597" +ms.date: 11/04/2016 f1_keywords: ["C2597"] helpviewer_keywords: ["C2597"] -ms.assetid: 2e48127d-e3ff-4a40-8156-2863e45b1a38 --- # Compiler Error C2597 -illegal reference to non-static member 'identifier' +> illegal reference to non-static member 'identifier' + +## Remarks Possible causes: @@ -18,7 +19,9 @@ Possible causes: 1. A member access operator refers to a nonmember function. -1. The following sample generates C2597 and shows how to fix it: +## Example + +1. The following example generates C2597 and shows how to fix it: ```cpp // C2597.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2598.md b/docs/error-messages/compiler-errors-2/compiler-error-c2598.md index 017757d46f4..9e996c4837a 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2598.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2598.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2598" title: "Compiler Error C2598" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2598" +ms.date: 11/04/2016 f1_keywords: ["C2598"] helpviewer_keywords: ["C2598"] -ms.assetid: 40777c62-39ba-441e-b081-f49f94b43547 --- # Compiler Error C2598 -linkage specification must be at global scope +> linkage specification must be at global scope + +## Remarks The linkage specifier is declared at local scope. -The following sample generates C2598: +## Example + +The following example generates C2598: ```cpp // C2598.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2599.md b/docs/error-messages/compiler-errors-2/compiler-error-c2599.md index 4d8490f2778..56a13a45eeb 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2599.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2599.md @@ -1,20 +1,23 @@ --- -description: "Learn more about: Compiler Error C2599" title: "Compiler Error C2599" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2599" +ms.date: 11/04/2016 f1_keywords: ["C2599"] helpviewer_keywords: ["C2599"] -ms.assetid: 88515f36-7589-47e2-862e-0de8b18d6668 --- # Compiler Error C2599 -'enum' : forward declaration of enum type is not allowed +> 'enum' : forward declaration of enum type is not allowed + +## Remarks The compiler no longer supports forward declaration of a managed enumeration. Forward declaration of an enum type is not allowed under [/Za](../../build/reference/za-ze-disable-language-extensions.md). -The following sample generates C2599: +## Example + +The following example generates C2599: ```cpp // C2599.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2600.md b/docs/error-messages/compiler-errors-2/compiler-error-c2600.md index 75038e37b85..63dcc2d64a0 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2600.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2600.md @@ -1,20 +1,23 @@ --- -description: "Learn more about: Compiler Error C2600" title: "Compiler Error C2600" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2600" +ms.date: 11/04/2016 f1_keywords: ["C2600"] helpviewer_keywords: ["C2600"] -ms.assetid: cce11943-ea01-4bee-a7b0-b67d24ec6493 --- # Compiler Error C2600 -'function' : cannot define a compiler-generated special member function (must be declared in the class first) +> 'function' : cannot define a compiler-generated special member function (must be declared in the class first) + +## Remarks Before member functions such as constructors or destructors can be defined for a class, they must be declared in the class. The compiler can generate default constructors and destructors (called special member functions) if none are declared in the class. However, if you define one of these functions without a matching declaration in the class, the compiler detects a conflict. To fix this error, in the class declaration, declare each member function that you define outside the class declaration. -The following sample generates C2600: +## Example + +The following example generates C2600: ```cpp // C2600.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2601.md b/docs/error-messages/compiler-errors-2/compiler-error-c2601.md index 451d97d15cc..0a5225628f3 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2601.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2601.md @@ -1,28 +1,51 @@ --- -description: "Learn more about: Compiler Error C2601" title: "Compiler Error C2601" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2601" +ms.date: 06/04/2025 f1_keywords: ["C2601"] helpviewer_keywords: ["C2601"] -ms.assetid: 88275582-5f37-45d7-807d-05f06ba00965 --- # Compiler Error C2601 -'function' : local function definitions are illegal +> '*function*': local function definitions are illegal + +## Remarks Code tries to define a function within a function. -Or, there may be an extra brace in your source code before the location of the C2601 error. +Or, there may be an extra/missing brace before the location of the C2601 error. -The following sample generates C2601: +## Examples + +### Define function within a function + +[Lambda Expressions](../../cpp/lambda-expressions-in-cpp.md) may be used to emulate the behavior of local functions: ```cpp -// C2601.cpp -int main() { - int i = 0; +// C2601a.cpp +int main() +{ + int increment(int value) // C2601 + { + return value + 1; + } + + // Try the following line instead: + // auto increment = [](int value) { return value + 1; }; - void funcname(int j) { // C2601 - j++; - } + int two = increment(1); } ``` + +### Missing closing brace + +If a preceding function is missing a closing brace, the subsequent function is taken to be a local function: + +```cpp +// C2601b.cpp +void func() +{ +// missing '}' brace here + +int main() {} // C2601 +``` diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2602.md b/docs/error-messages/compiler-errors-2/compiler-error-c2602.md index dabc0048be8..bc32d316af0 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2602.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2602.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2602" title: "Compiler Error C2602" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2602" +ms.date: 11/04/2016 f1_keywords: ["C2602"] helpviewer_keywords: ["C2602"] -ms.assetid: 6c07a40e-537e-4954-b5c5-1e0e58fe1952 --- # Compiler Error C2602 -'class::Identifier' is not a member of a base class of 'class' +> 'class::Identifier' is not a member of a base class of 'class' + +## Remarks `Identifier` cannot be accessed because it is not a member inherited from any base class. -The following sample generates C2602: +## Example + +The following example generates C2602: ```cpp // C2602.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2603.md b/docs/error-messages/compiler-errors-2/compiler-error-c2603.md index c66a5ff3e1c..c4700923f0f 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2603.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2603.md @@ -1,15 +1,16 @@ --- -description: "Learn more about: Compiler Error C2603" title: "Compiler Error C2603" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2603" +ms.date: 11/04/2016 f1_keywords: ["C2603"] helpviewer_keywords: ["C2603"] -ms.assetid: 9ca520d0-f082-4b65-933d-17c3bcf8b02c --- # Compiler Error C2603 > '*function*' : Too many block scope static objects with constructor/destructors in function +## Remarks + In versions of the Microsoft C++ compiler before Visual Studio 2015, or when the [/Zc:threadSafeInit-](../../build/reference/zc-threadsafeinit-thread-safe-local-static-initialization.md) compiler option is specified, there is a limit of 31 on the number of static objects you can have in an externally visible inline function. To resolve this issue, we recommend you adopt more recent version of the Microsoft C++ compiler toolset, or if possible, remove the /Zc:threadSafeInit- compiler option. If this is not possible, consider combining your static objects. If the objects are of the same type, consider use of a single static array of that type, and reference individual members as required. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2605.md b/docs/error-messages/compiler-errors-2/compiler-error-c2605.md index a11f99a7a35..ee73a6aa642 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2605.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2605.md @@ -1,20 +1,21 @@ --- -description: "Learn more about: Compiler Error C2605" title: "Compiler Error C2605" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2605" +ms.date: 11/04/2016 f1_keywords: ["C2605"] helpviewer_keywords: ["C2605"] -ms.assetid: a0e6f132-5acf-4e19-b277-ddf196d182bf --- # Compiler Error C2605 -'name' : this method is reserved within a managed or WinRT class +> 'name' : this method is reserved within a managed or WinRT class + +## Remarks Certain names are reserved by the compiler for internal functions. For more information, see [Destructors and finalizers](../../dotnet/how-to-define-and-consume-classes-and-structs-cpp-cli.md#BKMK_Destructors_and_finalizers). ## Example -The following sample generates C2605. +The following example generates C2605. ```cpp // C2605.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2611.md b/docs/error-messages/compiler-errors-2/compiler-error-c2611.md index 46d020f2d8d..9c4825ce615 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2611.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2611.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2611" title: "Compiler Error C2611" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2611" +ms.date: 11/04/2016 f1_keywords: ["C2611"] helpviewer_keywords: ["C2611"] -ms.assetid: 3f2d5253-f24f-4724-83d0-6b2aa6a4e551 --- # Compiler Error C2611 -'token' : illegal following '~' (expected identifier) +> 'token' : illegal following '~' (expected identifier) + +## Remarks The token is not an identifier. -The following sample generates C2611: +## Example + +The following example generates C2611: ```cpp // C2611.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2612.md b/docs/error-messages/compiler-errors-2/compiler-error-c2612.md index 58b1d0ff3d6..2966afaeb11 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2612.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2612.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2612" title: "Compiler Error C2612" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2612" +ms.date: 11/04/2016 f1_keywords: ["C2612"] helpviewer_keywords: ["C2612"] -ms.assetid: 6faacfd6-4455-41a2-808e-0f6799f84d6d --- # Compiler Error C2612 -trailing 'char' illegal in base/member initializer list +> trailing 'char' illegal in base/member initializer list + +## Remarks A character appears after the last base or member in an initializer list. -The following sample generates C2612: +## Example + +The following example generates C2612: ```cpp // C2612.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2613.md b/docs/error-messages/compiler-errors-2/compiler-error-c2613.md index 547668b933c..70ef49410d0 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2613.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2613.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Compiler Error C2613" title: "Compiler Error C2613" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2613" +ms.date: 11/04/2016 f1_keywords: ["C2613"] helpviewer_keywords: ["C2613"] -ms.assetid: d8fa7b32-08cb-4bb4-96e7-c04dded0e917 --- # Compiler Error C2613 -trailing ',' illegal in base class list +> trailing ',' illegal in base class list + +## Remarks A comma appears after the last base in a base class list. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2614.md b/docs/error-messages/compiler-errors-2/compiler-error-c2614.md index 7b3c6312ac8..4764e9574fa 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2614.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2614.md @@ -1,32 +1,33 @@ --- -description: "Learn more about: Compiler Error C2614" title: "Compiler Error C2614" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2614" +ms.date: 11/04/2016 f1_keywords: ["C2614"] helpviewer_keywords: ["C2614"] -ms.assetid: a550c1d5-8718-4e17-a888-b2619e00fe11 --- # Compiler Error C2614 -'class1' : illegal member initialization: 'class2' is not a base or member +> 'class1' : illegal member initialization: 'class2' is not a base or member + +## Remarks Only member or base classes can appear in the initialization list for a class or structure. ## Example -The following sample generates C2614. +The following example generates C2614. ```cpp // C2614.cpp // compile with: /c struct A { int i; - A( int ia ) : B( i ) {}; // C2614 B is not a member of A + A( int ia ) : B( i ) {} // C2614 B is not a member of A }; struct A2 { int B; int i; - A2( int ia ) : B( i ) {}; // OK + A2( int ia ) : B( i ) {} // OK }; ``` diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2616.md b/docs/error-messages/compiler-errors-2/compiler-error-c2616.md index 77c845af313..9da31ed6fe6 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2616.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2616.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Error C2616" title: "Compiler Error C2616" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2616" +ms.date: 11/04/2016 f1_keywords: ["C2616"] helpviewer_keywords: ["C2616"] -ms.assetid: 8d0c02d6-a0b0-4135-b10f-438d67da68c6 --- # Compiler Error C2616 -'conversion' : cannot implicitly convert a non-lvalue 'type1' to a 'type2' that is not const +> 'conversion' : cannot implicitly convert a non-lvalue 'type1' to a 'type2' that is not const + +## Remarks A reference cannot be initialized from a non-lvalue. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2617.md b/docs/error-messages/compiler-errors-2/compiler-error-c2617.md index 1cd6a242ae3..a868e75c05d 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2617.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2617.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2617" title: "Compiler Error C2617" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2617" +ms.date: 11/04/2016 f1_keywords: ["C2617"] helpviewer_keywords: ["C2617"] -ms.assetid: d6a435d2-7d95-4dbf-ad4a-abe4744f63e8 --- # Compiler Error C2617 -'function' : inconsistent return statement +> 'function' : inconsistent return statement + +## Remarks The specified function does not have a declared return type, and a previous return statement did not supply a value. -The following sample generates C2617: +## Example + +The following example generates C2617: ```cpp // C2617.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2619.md b/docs/error-messages/compiler-errors-2/compiler-error-c2619.md index 0b31549ce06..7defff06cd1 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2619.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2619.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2619" title: "Compiler Error C2619" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2619" +ms.date: 11/04/2016 f1_keywords: ["C2619"] helpviewer_keywords: ["C2619"] -ms.assetid: c826f8ab-d66a-4b79-a0b2-93b0af8c41ac --- # Compiler Error C2619 -'identifier': a static data member is not allowed in an anonymous struct or union +> 'identifier': a static data member is not allowed in an anonymous struct or union + +## Remarks A member of an anonymous struct or union is declared **`static`**. -The following sample generates C2619, and demonstrates how to fix it by removing the static keyword. +## Example + +The following example generates C2619, and demonstrates how to fix it by removing the static keyword. ```cpp // C2619.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2624.md b/docs/error-messages/compiler-errors-2/compiler-error-c2624.md index 7532dae0b40..a1e2ad3153d 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2624.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2624.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2624" title: "Compiler Error C2624" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2624" +ms.date: 11/04/2016 f1_keywords: ["C2624"] helpviewer_keywords: ["C2624"] -ms.assetid: 32f2ec15-a7cd-4049-a64b-131746d3152b --- # Compiler Error C2624 -local classes cannot be used to declare 'extern' variables +> local classes cannot be used to declare 'extern' variables + +## Remarks A local class or structure cannot be used to declare **`extern`** variables. -The following sample generates C2624: +## Example + +The following example generates C2624: ```cpp // C2624.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2626.md b/docs/error-messages/compiler-errors-2/compiler-error-c2626.md index 3ee3d112c02..bc83bd476dc 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2626.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2626.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2626" title: "Compiler Error C2626" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2626" +ms.date: 11/04/2016 f1_keywords: ["C2626"] helpviewer_keywords: ["C2626"] -ms.assetid: 4c283ad0-251b-4571-bc18-468b9836746f --- # Compiler Error C2626 -'identifier': a private or protected data member is not allowed in an anonymous struct or union +> 'identifier': a private or protected data member is not allowed in an anonymous struct or union + +## Remarks A member of an anonymous struct or union must have public access. -The following sample generates C2626: +## Example + +The following example generates C2626: ```cpp // C2626.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2627.md b/docs/error-messages/compiler-errors-2/compiler-error-c2627.md index f0cd09ab0b8..b35f668333b 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2627.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2627.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2627" title: "Compiler Error C2627" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2627" +ms.date: 11/04/2016 f1_keywords: ["C2627"] helpviewer_keywords: ["C2627"] -ms.assetid: 7fc6c5ac-c7c9-4f0b-ad52-f52252526458 --- # Compiler Error C2627 -'function' : member function not allowed in anonymous union +> 'function' : member function not allowed in anonymous union + +## Remarks An [anonymous union](../../cpp/unions.md#anonymous_unions) cannot have member functions. -The following sample generates C2627: +## Example + +The following example generates C2627: ```cpp // C2627.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2628.md b/docs/error-messages/compiler-errors-2/compiler-error-c2628.md index 561bc2aa568..e398afc1aa4 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2628.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2628.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2628" title: "Compiler Error C2628" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2628" +ms.date: 11/04/2016 f1_keywords: ["C2628"] helpviewer_keywords: ["C2628"] -ms.assetid: 19a25e77-d5be-4107-88d5-0745b6281f98 --- # Compiler Error C2628 -'type1' followed by 'type2' is illegal (did you forget a ';'?) +> 'type1' followed by 'type2' is illegal (did you forget a ';'?) + +## Remarks A semicolon may be missing. -The following sample generates C2628: +## Example + +The following example generates C2628: ```cpp // C2628.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2630.md b/docs/error-messages/compiler-errors-2/compiler-error-c2630.md index 205a06a4753..367ec0360cc 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2630.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2630.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2630" title: "Compiler Error C2630" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2630" +ms.date: 11/04/2016 f1_keywords: ["C2630"] helpviewer_keywords: ["C2630"] -ms.assetid: 7a655a9c-bab4-495b-97a3-a3f34cf5369a --- # Compiler Error C2630 -'symbol' found in what should be a comma-separated list +> 'symbol' found in what should be a comma-separated list + +## Remarks The symbol appears in a context that requires a comma. -The following sample generates C2630: +## Example + +The following example generates C2630: ```cpp // C2630.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2632.md b/docs/error-messages/compiler-errors-2/compiler-error-c2632.md index 2471e652250..28b0937c21b 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2632.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2632.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2632" title: "Compiler Error C2632" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2632" +ms.date: 11/04/2016 f1_keywords: ["C2632"] helpviewer_keywords: ["C2632"] -ms.assetid: b15a6b1b-42d2-4e1b-8660-e6bfde61052d --- # Compiler Error C2632 -'type1' followed by 'type2' is illegal +> 'type1' followed by 'type2' is illegal + +## Remarks This error can be caused if there is missing code between two type specifiers. -The following sample generates C2632: +## Examples + +The following example generates C2632: ```cpp // C2632.cpp @@ -21,7 +24,7 @@ int float i; // C2632 This error can also be generated as a result of compiler conformance work that was done for Visual Studio .NET 2003. **`bool`** is now a proper type. In previous versions, **`bool`** was a typedef, and you could create identifiers with that name. -The following sample generates C2632: +The following example generates C2632: ```cpp // C2632_2.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2633.md b/docs/error-messages/compiler-errors-2/compiler-error-c2633.md index db695cecb70..4270773097f 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2633.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2633.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2633" title: "Compiler Error C2633" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2633" +ms.date: 11/04/2016 f1_keywords: ["C2633"] helpviewer_keywords: ["C2633"] -ms.assetid: a7aceb65-4255-42d6-a8fb-e3cb6c4d2270 --- # Compiler Error C2633 -'identifier' : 'inline' is the only legal storage class for constructors +> 'identifier' : 'inline' is the only legal storage class for constructors + +## Remarks A constructor is declared as a storage class other than inline. -The following sample generates C2633: +## Example + +The following example generates C2633: ```cpp // C2633.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2634.md b/docs/error-messages/compiler-errors-2/compiler-error-c2634.md index 721415f346f..234acb5b249 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2634.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2634.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2634" title: "Compiler Error C2634" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2634" +ms.date: 11/04/2016 f1_keywords: ["C2634"] helpviewer_keywords: ["C2634"] -ms.assetid: 58c8f2db-ac95-4a81-9355-ef3cfb0ba7b3 --- # Compiler Error C2634 -'&class::member' : pointer to reference member is illegal +> '&class::member' : pointer to reference member is illegal + +## Remarks A pointer to a reference member is declared. -The following sample generates C2634: +## Example + +The following example generates C2634: ```cpp // C2634.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2635.md b/docs/error-messages/compiler-errors-2/compiler-error-c2635.md index eb9ed290c46..065efac641f 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2635.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2635.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2635" title: "Compiler Error C2635" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2635" +ms.date: 11/04/2016 f1_keywords: ["C2635"] helpviewer_keywords: ["C2635"] -ms.assetid: 9deca2a8-2d61-42eb-9783-6578132ee3fb --- # Compiler Error C2635 -cannot convert an 'identifier1*' to an 'identifier2\*'; conversion from a virtual base class is implied +> cannot convert an 'identifier1*' to an 'identifier2\*'; conversion from a virtual base class is implied + +## Remarks The conversion requires a cast from a **`virtual`** base class to a derived class, which is not allowed. -The following sample generates C2635: +## Example + +The following example generates C2635: ```cpp // C2635.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2636.md b/docs/error-messages/compiler-errors-2/compiler-error-c2636.md index b60fb195320..0d37fabe818 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2636.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2636.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2636" title: "Compiler Error C2636" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2636" +ms.date: 11/04/2016 f1_keywords: ["C2636"] helpviewer_keywords: ["C2636"] -ms.assetid: 379873ec-8d05-49f8-adf1-b067bc07bdb8 --- # Compiler Error C2636 -'identifier' : pointer to reference member is illegal +> 'identifier' : pointer to reference member is illegal + +## Remarks A pointer to a reference member was declared. -The following sample generates C2636: +## Example + +The following example generates C2636: ```cpp // C2636.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2637.md b/docs/error-messages/compiler-errors-2/compiler-error-c2637.md index 40cb31b6061..4eda884eb63 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2637.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2637.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2637" title: "Compiler Error C2637" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2637" +ms.date: 11/04/2016 f1_keywords: ["C2637"] helpviewer_keywords: ["C2637"] -ms.assetid: 58d94447-eb96-4d8f-a690-dd78d322462e --- # Compiler Error C2637 -'identifier' : cannot modify pointers to data members +> 'identifier' : cannot modify pointers to data members + +## Remarks A pointer to a data member cannot have a calling convention. To resolve, either remove the calling convention or declare a pointer to member function. -The following sample generates C2637: +## Example + +The following example generates C2637: ```cpp // C2637.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2638.md b/docs/error-messages/compiler-errors-2/compiler-error-c2638.md index 0f19715ed7f..bb2c3beed90 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2638.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2638.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2638" title: "Compiler Error C2638" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2638" +ms.date: 11/04/2016 f1_keywords: ["C2638"] helpviewer_keywords: ["C2638"] -ms.assetid: 9d4275e8-406d-455e-afee-3a37799230e0 --- # Compiler Error C2638 -'identifier' : __based modifier illegal on pointer to member +> 'identifier' : __based modifier illegal on pointer to member + +## Remarks The **`__based`** modifier cannot be used for pointers to members. -The following sample generates C2638: +## Example + +The following example generates C2638: ```cpp // C2638.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2640.md b/docs/error-messages/compiler-errors-2/compiler-error-c2640.md index c1467898ef6..365c80e4250 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2640.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2640.md @@ -1,23 +1,29 @@ --- -description: "Learn more about: Compiler Error C2640" title: "Compiler Error C2640" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2640" +ms.date: 03/17/2025 f1_keywords: ["C2640"] helpviewer_keywords: ["C2640"] -ms.assetid: e4d137ab-ed1d-457c-9eec-b70d97f1b0b4 --- # Compiler Error C2640 -'identifier' : __based modifier illegal on reference +> 'abstract declarator': __based modifier illegal on reference + +## Remarks -The **`__based`** modifier can be used on pointers only. +The [**`__based`**](../../cpp/based-pointers-cpp.md) modifier can be used on pointers only. -The following sample generates C2640: +## Example + +The following example generates C2640: ```cpp // C2640.cpp -void f(int i) { - void *vp; - int _based(vp) &vr = I; // C2640 +int* ptr; + +int main() +{ + int __based(ptr)& based_ref; // C2640 + int __based(ptr)* based_ptr; // OK } ``` diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2645.md b/docs/error-messages/compiler-errors-2/compiler-error-c2645.md index 10f903aa458..51bc814c4a6 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2645.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2645.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2645" title: "Compiler Error C2645" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2645" +ms.date: 11/04/2016 f1_keywords: ["C2645"] helpviewer_keywords: ["C2645"] -ms.assetid: 6609c2fa-c3b2-4a6b-8e8d-58fb52f67175 --- # Compiler Error C2645 -no qualified name for pointer to member (found ':: *') +> no qualified name for pointer to member (found ':: *') + +## Remarks The declaration of a pointer to a member does not specify a class. -The following sample generates C2645: +## Example + +The following example generates C2645: ```cpp // C2645.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2646.md b/docs/error-messages/compiler-errors-2/compiler-error-c2646.md index 733efb98bc5..f6c33292e47 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2646.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2646.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2646" title: "Compiler Error C2646" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2646" +ms.date: 11/04/2016 f1_keywords: ["C2646"] helpviewer_keywords: ["C2646"] -ms.assetid: 92ff1f02-5eaf-40a5-8b7a-a682f149e967 --- # Compiler Error C2646 -an anonymous struct or union at global or namespace scope must be declared static +> an anonymous struct or union at global or namespace scope must be declared static + +## Remarks An anonymous struct or union has global or namespace scope but is not declared **`static`**. -The following sample generates C2646 and shows how to fix it: +## Example + +The following example generates C2646 and shows how to fix it: ```cpp // C2646.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2647.md b/docs/error-messages/compiler-errors-2/compiler-error-c2647.md index 20f2b56c027..0a6e5dab39d 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2647.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2647.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2647" title: "Compiler Error C2647" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2647" +ms.date: 11/04/2016 f1_keywords: ["C2647"] helpviewer_keywords: ["C2647"] -ms.assetid: 1034589e-bc3e-41a6-831f-2a1a4b8a2500 --- # Compiler Error C2647 -'operator': cannot dereference a 'type1' on a 'type2' +> 'operator': cannot dereference a 'type1' on a 'type2' + +## Remarks + +The left operand of a pointer-to-member operator (`->*` or `.*`) cannot be implicitly converted to a type related to the right operator. -The left operand of a pointer-to-member operator ( `->*` or `.*` ) cannot be implicitly converted to a type related to the right operator. +## Example -The following sample generates C2647: +The following example generates C2647: ```cpp // C2647.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2648.md b/docs/error-messages/compiler-errors-2/compiler-error-c2648.md index ef44b945847..8ece835b5be 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2648.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2648.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2648" title: "Compiler Error C2648" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2648" +ms.date: 11/04/2016 f1_keywords: ["C2648"] helpviewer_keywords: ["C2648"] -ms.assetid: ce338337-9154-4f85-bb61-b05fdbfad75d --- # Compiler Error C2648 -'identifier' : use of member as default parameter requires static member +> 'identifier' : use of member as default parameter requires static member + +## Remarks A non-static member is used as a default parameter. -The following sample generates C2648: +## Example + +The following example generates C2648: ```cpp // C2648.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2649.md b/docs/error-messages/compiler-errors-2/compiler-error-c2649.md index fb6e19c4f93..5cca3fb8e7a 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2649.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2649.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Compiler Error C2649" title: "Compiler Error C2649" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2649" +ms.date: 11/04/2016 f1_keywords: ["C2649"] helpviewer_keywords: ["C2649"] -ms.assetid: 09e78f08-9b74-41e7-a76f-66bc190ba0d2 --- # Compiler Error C2649 -'identifier' : is not a 'class-key' +> 'identifier' : is not a 'class-key' + +## Remarks A class, structure, or union declaration uses an incorrect tag. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2650.md b/docs/error-messages/compiler-errors-2/compiler-error-c2650.md index 005db3ee7ac..dfaf2272cb3 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2650.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2650.md @@ -1,20 +1,21 @@ --- -description: "Learn more about: Compiler Error C2650" title: "Compiler Error C2650" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2650" +ms.date: 11/04/2016 f1_keywords: ["C2650"] helpviewer_keywords: ["C2650"] -ms.assetid: 49a8ac6e-aa6d-4616-917c-a3cfcdbad5a4 --- # Compiler Error C2650 -'operator' : cannot be a virtual function +> 'operator' : cannot be a virtual function + +## Remarks A **`new`** or **`delete`** operator is declared **`virtual`**. These operators are **`static`** member functions and cannot be **`virtual`**. ## Example -The following sample generates C2650: +The following example generates C2650: ```cpp // C2650.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2651.md b/docs/error-messages/compiler-errors-2/compiler-error-c2651.md index 1c1c8fcddf5..14c8d273955 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2651.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2651.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Compiler Error C2651" title: "Compiler Error C2651" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2651" +ms.date: 11/04/2016 f1_keywords: ["C2651"] helpviewer_keywords: ["C2651"] -ms.assetid: c3524a89-47d1-43f6-9e20-2cda15f9ae8a --- # Compiler Error C2651 -'data type' : left of 'operator' must be a class, struct or union +> 'data type' : left of 'operator' must be a class, struct or union + +## Remarks To use a template parameter as if it is a class, specialize the class template with a class instead of an integral type. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2652.md b/docs/error-messages/compiler-errors-2/compiler-error-c2652.md index 8c816d24a78..5e7e2f0ee85 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2652.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2652.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2652" title: "Compiler Error C2652" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2652" +ms.date: 11/04/2016 f1_keywords: ["C2652"] helpviewer_keywords: ["C2652"] -ms.assetid: 6e3d1a90-a989-4088-8afd-dc82f6a2d66f --- # Compiler Error C2652 -'identifier' : illegal copy constructor: first parameter must not be an 'identifier' +> 'identifier' : illegal copy constructor: first parameter must not be an 'identifier' + +## Remarks The first parameter in the copy constructor has the same type as the class, structure, or union for which it is defined. The first parameter can be a reference to the type but not the type itself. -The following sample generates C2651: +## Example + +The following example generates C2652: ```cpp // C2652.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2653.md b/docs/error-messages/compiler-errors-2/compiler-error-c2653.md index b1cbd557784..658521dbf31 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2653.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2653.md @@ -1,24 +1,25 @@ --- -description: "Learn more about: Compiler Error C2653" title: "Compiler Error C2653" -ms.date: "11/30/2017" +description: "Learn more about: Compiler Error C2653" +ms.date: 11/30/2017 f1_keywords: ["C2653"] helpviewer_keywords: ["C2653"] -ms.assetid: 3f49e731-affd-43a0-a8d0-181db7650bc3 --- # Compiler Error C2653 > '*identifier*' : is not a class or namespace name +## Remarks + The language syntax requires a class, structure, union, or namespace name here. This error can occur when you use a name that has not been declared as a class, structure, union, or namespace in front of a scope operator. To fix this issue, declare the name or include the header that declares the name before it is used. -C2653 is also possible if you try to define a *compound namespace*, a namespace that contains one or more scope-nested namespace names. Compound namespace definitions are not allowed in C++ prior to C++17. Compound namespaces are supported starting in Visual Studio 2015 Update 3 when you specify the [`/std:c++latest`](../../build/reference/std-specify-language-standard-version.md) compiler option. Starting in Visual Studio 2017 version 15.5, the compiler supports compound namespace definitions when the `[/std:c++17`](../../build/reference/std-specify-language-standard-version.md) or later option is specified. +C2653 is also possible if you try to define a *compound namespace*, a namespace that contains one or more scope-nested namespace names. Compound namespace definitions are not allowed in C++ prior to C++17. Compound namespaces are supported starting in Visual Studio 2015 Update 3 when you specify the [`/std:c++latest`](../../build/reference/std-specify-language-standard-version.md) compiler option. Starting in Visual Studio 2017 version 15.5, the compiler supports compound namespace definitions when the [`/std:c++17`](../../build/reference/std-specify-language-standard-version.md) or later option is specified. ## Examples -This sample generates C2653 because a scope name is used but not declared. The compiler expects a class, structure, union, or namespace name before a scope operator (::). +This example generates C2653 because a scope name is used but not declared. The compiler expects a class, structure, union, or namespace name before a scope operator (::). ```cpp // C2653.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2654.md b/docs/error-messages/compiler-errors-2/compiler-error-c2654.md index c1905fbdb7c..2c7a489eb1b 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2654.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2654.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Error C2654" title: "Compiler Error C2654" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2654" +ms.date: 11/04/2016 f1_keywords: ["C2654"] helpviewer_keywords: ["C2654"] -ms.assetid: ca7de1bd-576b-40bf-96fc-a91984827d20 --- # Compiler Error C2654 -'identifier' : attempt to access member outside a member function +> 'identifier' : attempt to access member outside a member function + +## Remarks A member is accessed in a declaration. Member data can be accessed only in member functions. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2655.md b/docs/error-messages/compiler-errors-2/compiler-error-c2655.md index 77dcb0e48d4..4169ae3ee9f 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2655.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2655.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2655" title: "Compiler Error C2655" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2655" +ms.date: 11/04/2016 f1_keywords: ["C2655"] helpviewer_keywords: ["C2655"] -ms.assetid: beaefa6e-51b3-4df9-9150-960f3fbf40e0 --- # Compiler Error C2655 -'identifier' : definition or redeclaration illegal in current scope +> 'identifier' : definition or redeclaration illegal in current scope + +## Remarks An identifier can be redeclared only at global scope. -The following sample generates C2655: +## Example + +The following example generates C2655: ```cpp // C2655.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2656.md b/docs/error-messages/compiler-errors-2/compiler-error-c2656.md index c76d36e6f7b..acdffd18ea1 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2656.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2656.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Error C2656" title: "Compiler Error C2656" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2656" +ms.date: 11/04/2016 f1_keywords: ["C2656"] helpviewer_keywords: ["C2656"] -ms.assetid: 1ec91186-0735-4904-859b-59da9af2d426 --- # Compiler Error C2656 -'function' : function not allowed as a bit field +> 'function' : function not allowed as a bit field + +## Remarks A function is declared as a member of a bit field. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2657.md b/docs/error-messages/compiler-errors-2/compiler-error-c2657.md index 8cb0fddc1ef..af0af9e0dd2 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2657.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2657.md @@ -1,20 +1,23 @@ --- -description: "Learn more about: Compiler Error C2657" title: "Compiler Error C2657" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2657" +ms.date: 11/04/2016 f1_keywords: ["C2657"] helpviewer_keywords: ["C2657"] -ms.assetid: f7cf29a9-684a-4605-9469-ecfee9ba4b03 --- # Compiler Error C2657 -'class::*' found at the start of a statement (did you forget to specify a type?) +> 'class::*' found at the start of a statement (did you forget to specify a type?) + +## Remarks The line began with a pointer-to-member identifier. This error can be caused by a missing type specifier in the declaration of a pointer to a member. -The following sample generates C2657: +## Example + +The following example generates C2657: ```cpp // C2657.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2658.md b/docs/error-messages/compiler-errors-2/compiler-error-c2658.md index e71e04ef906..fb3c762da11 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2658.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2658.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2658" title: "Compiler Error C2658" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2658" +ms.date: 11/04/2016 f1_keywords: ["C2658"] helpviewer_keywords: ["C2658"] -ms.assetid: 638368e8-7893-4a14-abec-13c768a9543a --- # Compiler Error C2658 -'member': redefinition in anonymous struct/union +> 'member': redefinition in anonymous struct/union + +## Remarks Two anonymous structures or unions contained member declarations with the same identifier but with different types. Under [/Za](../../build/reference/za-ze-disable-language-extensions.md), you will also get this error for members with the same identifier and type. -The following sample generates C2658: +## Example + +The following example generates C2658: ```cpp // C2658.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2659.md b/docs/error-messages/compiler-errors-2/compiler-error-c2659.md index ab818a1f07a..d02a04abd4f 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2659.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2659.md @@ -1,16 +1,21 @@ --- -description: "Learn more about: Compiler Error C2659" title: "Compiler Error C2659" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2659" +ms.date: 11/04/2016 f1_keywords: ["C2659"] helpviewer_keywords: ["C2659"] -ms.assetid: b0883600-4d27-4ca7-a931-8ca6bd48654d --- # Compiler Error C2659 -'operator' : function as left operand +> 'operator' : function as left operand + +## Remarks + +A function was on the left side of the specified operator. The most common reason for this error is that the compiler has parsed the identifier on the left side of the operator as a function when the developer intended it to be a variable. For more information, see Wikipedia article [Most vexing parse](https://en.wikipedia.org/wiki/Most_vexing_parse). + +## Examples -A function was on the left side of the specified operator. The most common reason for this error is that the compiler has parsed the identifier on the left side of the operator as a function when the developer intended it to be a variable. For more information, see Wikipedia article [Most vexing parse](https://en.wikipedia.org/wiki/Most_vexing_parse). This example shows a function declaration and a variable definition that are easily confused: +This example shows a function declaration and a variable definition that are easily confused: ```cpp // C2659a.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2660.md b/docs/error-messages/compiler-errors-2/compiler-error-c2660.md index b825312531a..206114d0ac4 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2660.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2660.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Error C2660" title: "Compiler Error C2660" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2660" +ms.date: 11/04/2016 f1_keywords: ["C2660"] helpviewer_keywords: ["C2660"] -ms.assetid: 2e01a1db-4f00-4df6-a04d-cb6f70a6922b --- # Compiler Error C2660 -'function' : function does not take number parameters +> 'function' : function does not take number parameters + +## Remarks The function is called with an incorrect number of parameters. @@ -20,7 +21,7 @@ C2660 can occur if you accidentally call a Windows API function rather than an M ## Examples -The following sample generates C2660. +The following example generates C2660. ```cpp // C2660.cpp @@ -32,7 +33,7 @@ int main() { } ``` -C2660 can also occur if you attempt to directly call the Dispose method of a managed type. For more information, see [Destructors and finalizers](../../dotnet/how-to-define-and-consume-classes-and-structs-cpp-cli.md#BKMK_Destructors_and_finalizers). The following sample generates C2660. +C2660 can also occur if you attempt to directly call the Dispose method of a managed type. For more information, see [Destructors and finalizers](../../dotnet/how-to-define-and-consume-classes-and-structs-cpp-cli.md#BKMK_Destructors_and_finalizers). The following example generates C2660. ```cpp // C2660_a.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2661.md b/docs/error-messages/compiler-errors-2/compiler-error-c2661.md index 9f2a5bbc1c3..720b9f3334e 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2661.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2661.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Error C2661" title: "Compiler Error C2661" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2661" +ms.date: 11/04/2016 f1_keywords: ["C2661"] helpviewer_keywords: ["C2661"] -ms.assetid: 60021467-71cd-451b-9877-23840c69309f --- # Compiler Error C2661 -'function' : no overloaded function takes number parameters +> 'function' : no overloaded function takes number parameters + +## Remarks Possible causes: @@ -16,7 +17,9 @@ Possible causes: 1. Missing function declaration. -The following sample generates C2661: +## Example + +The following example generates C2661: ```cpp // C2661.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2662.md b/docs/error-messages/compiler-errors-2/compiler-error-c2662.md index 0afdad4fbd3..b6184513912 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2662.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2662.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Error C2662" title: "Compiler Error C2662" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2662" +ms.date: 11/04/2016 f1_keywords: ["C2662"] helpviewer_keywords: ["C2662"] -ms.assetid: e172c2a4-f29e-4034-8232-e7dc6f83689f --- # Compiler Error C2662 -'function' : cannot convert 'this' pointer from 'type1' to 'type2' +> 'function' : cannot convert 'this' pointer from 'type1' to 'type2' + +## Remarks The compiler could not convert the **`this`** pointer from `type1` to `type2`. @@ -18,7 +19,9 @@ This error can be caused by invoking a non-**`const`** member function on a **`c - Add **`const`** to the member function. -The following sample generates C2662: +## Examples + +The following example generates C2662: ```cpp // C2662.cpp @@ -60,7 +63,7 @@ ref struct N { }; ``` -The following sample generates C2662: +The following example generates C2662: ```cpp // C2662_c.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2663.md b/docs/error-messages/compiler-errors-2/compiler-error-c2663.md index 8c3e53207f7..8f6ee981e2b 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2663.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2663.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Error C2663" title: "Compiler Error C2663" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2663" +ms.date: 11/04/2016 f1_keywords: ["C2663"] helpviewer_keywords: ["C2663"] -ms.assetid: 1e93e368-fd52-42bf-9908-9b6df467c8c9 --- # Compiler Error C2663 -'function' : number overloads have no legal conversions for 'this' pointer +> 'function' : number overloads have no legal conversions for 'this' pointer + +## Remarks The compiler could not convert **`this`** to any of the overloaded versions of the member function. @@ -18,7 +19,9 @@ This error can be caused by invoking a non-**`const`** member function on a **`c 1. Add **`const`** to one of the member function overloads. -The following sample generates C2663: +## Example + +The following example generates C2663: ```cpp // C2663.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2664.md b/docs/error-messages/compiler-errors-2/compiler-error-c2664.md index c7146ee907d..f08a2cb9704 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2664.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2664.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Error C2664" title: "Compiler Error C2664" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2664" +ms.date: 11/04/2016 f1_keywords: ["C2664"] helpviewer_keywords: ["C2664"] -ms.assetid: 3595d66e-cf87-4fda-a896-c0cd81f95db4 --- # Compiler Error C2664 -'function' : cannot convert argument n from 'type1' to 'type2' +> 'function' : cannot convert argument n from 'type1' to 'type2' + +## Remarks This parameter conversion problem might happen if an instance of a class is created and an implicit conversion is attempted on a constructor marked with the **`explicit`** keyword. For more information about explicit conversions, see [User-Defined Type Conversions](../../cpp/user-defined-type-conversions-cpp.md). @@ -28,19 +29,19 @@ For more information, see [How to: Convert System::String to wchar_t* or char\*] ## Examples -The following sample generates C2664 and shows how to fix it. +The following example generates C2664 and shows how to fix it. ```cpp // C2664.cpp // C2664 struct A { - void f(int i) {}; + void f(int i) {} }; struct B : public A { // To fix, uncomment the following line. // using A::f; - void f(A a) {}; + void f(A a) {} }; int main() { @@ -50,7 +51,7 @@ int main() { } ``` -This sample also generates C2664 and shows how to fix it. +This example also generates C2664 and shows how to fix it. ```cpp // C2664b.cpp @@ -67,7 +68,7 @@ int main() { } ``` -The next sample demonstrates C2664 by using a string literal to call `Test`, and shows how to fix it. Because the parameter is an `szString` reference, an object must be created by the appropriate constructor. The result is a temporary object that cannot be used to initialize the reference. +The next example demonstrates C2664 by using a string literal to call `Test`, and shows how to fix it. Because the parameter is an `szString` reference, an object must be created by the appropriate constructor. The result is a temporary object that cannot be used to initialize the reference. ```cpp // C2664c.cpp @@ -106,7 +107,7 @@ int main() { } ``` -The compiler enforces the C++ standard requirements for applying **`const`**. This sample generates C2664: +The compiler enforces the C++ standard requirements for applying **`const`**. This example generates C2664: ```cpp // C2664d.cpp @@ -172,7 +173,7 @@ int main( ) { } ``` -An enum variable is not converted to its underlying type such that a function call will be satisfied. For more information, see [enum class](../../extensions/enum-class-cpp-component-extensions.md). The following sample generates C2664 and shows how to fix it. +An enum variable is not converted to its underlying type such that a function call will be satisfied. For more information, see [enum class](../../extensions/enum-class-cpp-component-extensions.md). The following example generates C2664 and shows how to fix it. ```cpp // C2664f.cpp @@ -215,7 +216,7 @@ library myproj1 { C2664 is also raised by using **`wchar_t`** when porting code from Visual C++ 6.0 to later versions. In Visual C++ 6.0 and earlier, **`wchar_t`** was a **`typedef`** for **`unsigned short`** and was therefore implicitly convertible to that type. After Visual C++ 6.0, **`wchar_t`** is its own built-in type, as specified in the C++ standard, and is no longer implicitly convertible to **`unsigned short`**. See [/Zc:wchar_t (wchar_t Is Native Type)](../../build/reference/zc-wchar-t-wchar-t-is-native-type.md). -The following sample generates C2664 and shows how to fix it. +The following example generates C2664 and shows how to fix it. ```cpp // C2664h.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2665.md b/docs/error-messages/compiler-errors-2/compiler-error-c2665.md index c1efc17c246..cc110cf8229 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2665.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2665.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Error C2665" title: "Compiler Error C2665" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2665" +ms.date: 11/04/2016 f1_keywords: ["C2665"] helpviewer_keywords: ["C2665"] -ms.assetid: a7f99b61-2eae-4f2b-ba75-ea68fd1e8312 --- # Compiler Error C2665 -'function' : none of the number1 overloads can convert parameter number2 from type 'type' +> 'function' : none of the number1 overloads can convert parameter number2 from type 'type' + +## Remarks A parameter of the overloaded function cannot be converted to the required type. Possible resolutions: @@ -18,7 +19,7 @@ A parameter of the overloaded function cannot be converted to the required type. ## Example -The following sample generates C2665. +The following example generates C2665. ```cpp // C2665.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2666.md b/docs/error-messages/compiler-errors-2/compiler-error-c2666.md index 7307e34bb41..9dbac3a9b13 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2666.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2666.md @@ -1,20 +1,21 @@ --- -description: "Learn more about: Compiler Error C2666" title: "Compiler Error C2666" +description: "Learn more about: Compiler Error C2666" ms.date: 10/18/2021 f1_keywords: ["C2666"] helpviewer_keywords: ["C2666"] -ms.assetid: 78364d15-c6eb-439a-9088-e04a0176692b --- # Compiler Error C2666 -'identifier' : number overloads have similar conversions +> 'identifier' : number overloads have similar conversions + +## Remarks An overloaded function or operator is ambiguous. Formal parameter lists may be too similar for the compiler to resolve the ambiguity. To resolve this error, explicitly cast one or more of the actual parameters. ## Examples -The following sample generates C2666: +The following example generates C2666: ```cpp // C2666.cpp @@ -141,7 +142,7 @@ int main() } ``` -The following sample generates C2666 +The following example generates C2666 ```cpp // C2666c.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2667.md b/docs/error-messages/compiler-errors-2/compiler-error-c2667.md index 17887deb7b7..883874fb3d6 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2667.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2667.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Error C2667" title: "Compiler Error C2667" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2667" +ms.date: 11/04/2016 f1_keywords: ["C2667"] helpviewer_keywords: ["C2667"] -ms.assetid: 3c91d9d1-18fa-4e0d-a9ba-984d38980ca3 --- # Compiler Error C2667 -'function' : none of number overloads have a best conversion +> 'function' : none of number overloads have a best conversion + +## Remarks An overloaded function call is ambiguous and cannot be resolved. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2668.md b/docs/error-messages/compiler-errors-2/compiler-error-c2668.md index 797a39b3122..5c85dee6a57 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2668.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2668.md @@ -1,22 +1,23 @@ --- -description: "Learn more about: Compiler Error C2668" title: "Compiler Error C2668" +description: "Learn more about: Compiler Error C2668" ms.date: 05/03/2021 f1_keywords: ["C2668"] helpviewer_keywords: ["C2668"] -ms.assetid: 041e9627-1c76-420e-a653-cfc83f933bd3 --- # Compiler Error C2668 > 'function' : ambiguous call to overloaded function +## Remarks + The specified overloaded function call couldn't be resolved. You may want to explicitly cast one or more of the actual parameters. You can also get this error through template use. If, in the same class, you have a regular member function and a templated member function with the same signature, the templated one must come first. This limitation remains in the current implementation of Visual C++. ## Examples -The following sample generates C2668: +The following example generates C2668: ```cpp // C2668.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2669.md b/docs/error-messages/compiler-errors-2/compiler-error-c2669.md index c2145433cb5..13d58e90c33 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2669.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2669.md @@ -1,20 +1,21 @@ --- -description: "Learn more about: Compiler Error C2669" title: "Compiler Error C2669" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2669" +ms.date: 11/04/2016 f1_keywords: ["C2669"] helpviewer_keywords: ["C2669"] -ms.assetid: f9cb8111-bcdc-484b-a863-2c42e15a0496 --- # Compiler Error C2669 -member function not allowed in anonymous union +> member function not allowed in anonymous union + +## Remarks [Anonymous unions](../../cpp/unions.md#anonymous_unions) cannot have member functions. ## Example -The following sample generates C2669: +The following example generates C2669: ```cpp // C2669.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2670.md b/docs/error-messages/compiler-errors-2/compiler-error-c2670.md index be41ed903cd..a1bfb105edc 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2670.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2670.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Error C2670" title: "Compiler Error C2670" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2670" +ms.date: 11/04/2016 f1_keywords: ["C2670"] helpviewer_keywords: ["C2670"] -ms.assetid: 4b3b74c7-a750-4b0d-abd3-216d1234461f --- # Compiler Error C2670 -'identifier' : the function template cannot convert parameter number from type 'type' +> 'identifier' : the function template cannot convert parameter number from type 'type' + +## Remarks A parameter could not be converted to the required type. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2671.md b/docs/error-messages/compiler-errors-2/compiler-error-c2671.md index faa1b927d76..fd2c623dd42 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2671.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2671.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2671" title: "Compiler Error C2671" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2671" +ms.date: 11/04/2016 f1_keywords: ["C2671"] helpviewer_keywords: ["C2671"] -ms.assetid: fc0ee40f-c8f3-408f-b89d-745d149c4169 --- # Compiler Error C2671 -'function' : static member functions do not have 'this' pointers +> 'function' : static member functions do not have 'this' pointers + +## Remarks A **`static`** member function tried to access **`this`**. -The following sample generates C2671: +## Example + +The following example generates C2671: ```cpp // C2671.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2672.md b/docs/error-messages/compiler-errors-2/compiler-error-c2672.md index a43ddf67cc8..8af88f34643 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2672.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2672.md @@ -1,15 +1,16 @@ --- -description: "Learn more about: Compiler Error C2672" title: "Compiler Error C2672" -ms.date: "10/24/2017" +description: "Learn more about: Compiler Error C2672" +ms.date: 10/24/2017 f1_keywords: ["C2672"] helpviewer_keywords: ["C2672"] -ms.assetid: 7e86338a-2d4b-40fe-9dd2-ac6886f3f31a --- # Compiler Error C2672 > '*function*': no matching overloaded function found +## Remarks + The compiler could not find an overloaded function that matches the specified function. No function was found that takes matching parameters, or no matching function has the required accessibility in context. When used by certain standard library containers or algorithms, your types must provide accessible members or friend functions that satisfy the requirements of the container or algorithm. For example, your iterator types should derive from `std::iterator<>`. Comparison operations or use of other operators on container element types may require the type be considered as both a left-hand and a right-hand operand. Use of the type as a right-hand operand can require implementation of the operator as a non-member function of the type. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2673.md b/docs/error-messages/compiler-errors-2/compiler-error-c2673.md index b122a1aabbb..bd53c6d9836 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2673.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2673.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2673" title: "Compiler Error C2673" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2673" +ms.date: 11/04/2016 f1_keywords: ["C2673"] helpviewer_keywords: ["C2673"] -ms.assetid: 780230c0-619b-4a78-b01d-ff5886306741 --- # Compiler Error C2673 -'function' : global functions do not have 'this' pointers +> 'function' : global functions do not have 'this' pointers + +## Remarks A global function tried to access **`this`**. -The following sample generates C2673: +## Example + +The following example generates C2673: ```cpp // C2673.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2674.md b/docs/error-messages/compiler-errors-2/compiler-error-c2674.md index 6f86c485aaa..25f54555820 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2674.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2674.md @@ -1,20 +1,21 @@ --- -description: "Learn more about: Compiler Error C2674" title: "Compiler Error C2674" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2674" +ms.date: 11/04/2016 f1_keywords: ["C2674"] helpviewer_keywords: ["C2674"] -ms.assetid: 7cbd70d8-d992-44d7-a5cb-dd8cf9c759d2 --- # Compiler Error C2674 -a generic declaration is not allowed in this context +> a generic declaration is not allowed in this context + +## Remarks A generic was declared incorrectly. For more information, see [Generics](../../extensions/generics-cpp-component-extensions.md). ## Example -The following sample generates C2674. +The following example generates C2674. ```cpp // C2674.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2675.md b/docs/error-messages/compiler-errors-2/compiler-error-c2675.md index 4bd9416580f..44d681044bb 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2675.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2675.md @@ -1,20 +1,21 @@ --- -description: "Learn more about: Compiler Error C2675" title: "Compiler Error C2675" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2675" +ms.date: 11/04/2016 f1_keywords: ["C2675"] helpviewer_keywords: ["C2675"] -ms.assetid: 4b92a12b-bff8-4dd5-a109-620065fc146c --- # Compiler Error C2675 -unary 'operator' : 'type' does not define this operator or a conversion to a type acceptable to the predefined operator +> unary 'operator' : 'type' does not define this operator or a conversion to a type acceptable to the predefined operator + +## Remarks C2675 can also occur when using a unary operator, and the type does not define the operator or a conversion to a type acceptable to the predefined operator. To use the operator, you must overload it for the specified type or define a conversion to a type for which the operator is defined. ## Example -The following sample generates C2675. +The following example generates C2675. ```cpp // C2675.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2676.md b/docs/error-messages/compiler-errors-2/compiler-error-c2676.md index c2368b92a68..f12d12d14d8 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2676.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2676.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2676" title: "Compiler Error C2676" +description: "Learn more about: Compiler Error C2676" ms.date: 06/03/2022 f1_keywords: ["C2676"] helpviewer_keywords: ["C2676"] -ms.assetid: 838a5e34-c92f-4f65-a597-e150bf8cf737 --- # Compiler Error C2676 @@ -16,7 +15,7 @@ To use the operator, you must overload it for the specified type or define a con ## Examples -The following sample generates C2676. +The following example generates C2676. ```cpp // C2676.cpp @@ -50,7 +49,7 @@ C2676 can also occur if you attempt to do pointer arithmetic on the **`this`** p The **`this`** pointer is of type handle in a reference type. For more information, see [Semantics of the `this` pointer](../../dotnet/how-to-define-and-consume-classes-and-structs-cpp-cli.md#BKMK_Semantics_of_the_this_pointer). -The following sample generates C2676. +The following example generates C2676. ```cpp // C2676_a.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2677.md b/docs/error-messages/compiler-errors-2/compiler-error-c2677.md index e5e8937b497..665726d4c01 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2677.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2677.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2677" title: "Compiler Error C2677" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2677" +ms.date: 11/04/2016 f1_keywords: ["C2677"] helpviewer_keywords: ["C2677"] -ms.assetid: 76bc0b65-f52a-45a6-b6d6-0555f89da9a8 --- # Compiler Error C2677 -binary 'operator' : no global operator found which takes type 'type' (or there is no acceptable conversion) +> binary 'operator' : no global operator found which takes type 'type' (or there is no acceptable conversion) + +## Remarks To use the operator, you must overload it for the specified type or define a conversion to a type for which the operator is defined. -The following sample generates C2677: +## Example + +The following example generates C2677: ```cpp // C2677.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2678.md b/docs/error-messages/compiler-errors-2/compiler-error-c2678.md index 3c56b110b05..6719229f6e9 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2678.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2678.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Error C2678" title: "Compiler Error C2678" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2678" +ms.date: 11/04/2016 f1_keywords: ["C2678"] helpviewer_keywords: ["C2678"] -ms.assetid: 1f0a4e26-b429-44f5-9f94-cb66441220c8 --- # Compiler Error C2678 -binary 'operator' : no operator defined which takes a left-hand operand of type 'type' (or there is no acceptable conversion) +> binary 'operator' : no operator defined which takes a left-hand operand of type 'type' (or there is no acceptable conversion) + +## Remarks To use the operator, you must overload it for the specified type or define a conversion to a type for which the operator is defined. @@ -16,7 +17,7 @@ C2678 can occur when the left-hand operand is const-qualified but the operator i ## Examples -The following sample generates C2678 and shows how to fix it: +The following example generates C2678 and shows how to fix it: ```cpp // C2678a.cpp @@ -42,7 +43,7 @@ int main() { C2678 can also occur if you do not pin a native member before calling a member function on it. -The following sample generates C2678 and shows how to fix it. +The following example generates C2678 and shows how to fix it. ```cpp // C2678.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2679.md b/docs/error-messages/compiler-errors-2/compiler-error-c2679.md index 41762a92db1..88f7498add1 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2679.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2679.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2679" title: "Compiler Error C2679" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2679" +ms.date: 11/04/2016 f1_keywords: ["C2679"] helpviewer_keywords: ["C2679"] -ms.assetid: 1a5f9d00-9190-4aa6-bc72-949f68ec136f --- # Compiler Error C2679 -binary 'operator' : no operator found which takes a right-hand operand of type 'type' (or there is no acceptable conversion) +> binary 'operator' : no operator found which takes a right-hand operand of type 'type' (or there is no acceptable conversion) + +## Remarks To use the operator, you must overload it for the specified type or define a conversion to a type for which the operator is defined. -The following sample generates C2679: +## Example + +The following example generates C2679: ```cpp // C2679.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2680.md b/docs/error-messages/compiler-errors-2/compiler-error-c2680.md index de9fce157af..29a2effd882 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2680.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2680.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2680" title: "Compiler Error C2680" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2680" +ms.date: 11/04/2016 f1_keywords: ["C2680"] helpviewer_keywords: ["C2680"] -ms.assetid: d6f7129e-dd17-4661-b680-18d6b925b1cc --- # Compiler Error C2680 -'type' : invalid target type for name +> 'type' : invalid target type for name + +## Remarks A casting operator tried to convert to a type that is not a pointer or reference. The [dynamic_cast](../../cpp/dynamic-cast-operator.md) operator can be used only for pointers or references. -The following sample generates C2680: +## Examples + +The following example generates C2680: ```cpp // C2680.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2681.md b/docs/error-messages/compiler-errors-2/compiler-error-c2681.md index 36739b95071..8920a1c75f2 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2681.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2681.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2681" title: "Compiler Error C2681" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2681" +ms.date: 11/04/2016 f1_keywords: ["C2681"] helpviewer_keywords: ["C2681"] -ms.assetid: eb42da6d-8d2c-43fd-986b-e73e2b004885 --- # Compiler Error C2681 -'type' : invalid expression type for name +> 'type' : invalid expression type for name + +## Remarks A casting operator tried to convert from an invalid type. For example, if you use the [dynamic_cast](../../cpp/dynamic-cast-operator.md) operator to convert an expression to a pointer type, the source expression must be a pointer. -The following sample generates C2681: +## Example + +The following example generates C2681: ```cpp // C2681.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2682.md b/docs/error-messages/compiler-errors-2/compiler-error-c2682.md index 09a250de791..6dbf392b6f8 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2682.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2682.md @@ -1,20 +1,23 @@ --- -description: "Learn more about: Compiler Error C2682" title: "Compiler Error C2682" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2682" +ms.date: 11/04/2016 f1_keywords: ["C2682"] helpviewer_keywords: ["C2682"] -ms.assetid: 30c6a7c4-f5f7-4fe8-81a8-c48938521ab4 --- # Compiler Error C2682 -cannot use casting_operator to convert from 'type1' to 'type2' +> cannot use casting_operator to convert from 'type1' to 'type2' + +## Remarks A casting operator tried to convert between incompatible types. For example, you cannot use the [dynamic_cast](../../cpp/dynamic-cast-operator.md) operator to convert a pointer to a reference. The **`dynamic_cast`** operator cannot be used to cast away qualifiers. All qualifiers on the types must match. You can use the **`const_cast`** operator to remove attributes such as **`const`**, **`volatile`**, or **`__unaligned`**. -The following sample generates C2682: +## Examples + +The following example generates C2682: ```cpp // C2682.cpp @@ -26,7 +29,7 @@ void g(A* pa) { } ``` -The following sample generates C2682: +The following example generates C2682: ```cpp // C2682b.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2683.md b/docs/error-messages/compiler-errors-2/compiler-error-c2683.md index 27edb0c552f..a2b7b04276a 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2683.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2683.md @@ -1,20 +1,23 @@ --- -description: "Learn more about: Compiler Error C2683" title: "Compiler Error C2683" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2683" +ms.date: 11/04/2016 f1_keywords: ["C2683"] helpviewer_keywords: ["C2683"] -ms.assetid: db605e4f-601b-4d05-92a1-c43ca24de08d --- # Compiler Error C2683 -'cast' : 'type' is not a polymorphic type +> 'cast' : 'type' is not a polymorphic type + +## Remarks You cannot use [dynamic_cast](../../cpp/dynamic-cast-operator.md) to convert from a non-polymorphic class (a class with no virtual functions). You can use [static_cast](../../cpp/static-cast-operator.md) to perform conversions of non-polymorphic types. However, **`static_cast`** does not perform a run-time check. -The following sample generates C2683: +## Example + +The following example generates C2683: ```cpp // C2683.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2687.md b/docs/error-messages/compiler-errors-2/compiler-error-c2687.md index 9284b359bc2..d61bb9d910f 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2687.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2687.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2687" title: "Compiler Error C2687" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2687" +ms.date: 11/04/2016 f1_keywords: ["C2687"] helpviewer_keywords: ["C2687"] -ms.assetid: 1d24b24a-cd0f-41cc-975c-b08dcfb7f402 --- # Compiler Error C2687 -'type' : exception-declaration cannot be 'void' or denote an incomplete type or pointer or reference to an incomplete type +> 'type' : exception-declaration cannot be 'void' or denote an incomplete type or pointer or reference to an incomplete type + +## Remarks For a type to be part of an exception declaration, it must be defined and not void. -The following sample generates C2687: +## Example + +The following example generates C2687: ```cpp // C2687.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2688.md b/docs/error-messages/compiler-errors-2/compiler-error-c2688.md index ddad95bbbfa..438291e9818 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2688.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2688.md @@ -1,20 +1,23 @@ --- -description: "Learn more about: Compiler Error C2688" title: "Compiler Error C2688" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2688" +ms.date: 11/04/2016 f1_keywords: ["C2688"] helpviewer_keywords: ["C2688"] -ms.assetid: 168c9e9d-8f65-4664-af86-db71d3e6ee46 --- # Compiler Error C2688 -'C2::fgrv' : covariant returns with multiple or virtual inheritance not supported for varargs functions +> 'C2::fgrv' : covariant returns with multiple or virtual inheritance not supported for varargs functions + +## Remarks Covariant return types are not supported in Visual C++ when a function contains variable arguments. To resolve this error, either define your functions so that they do not use variable arguments or make the return values the same for all virtual functions. -The following sample generates C2688: +## Example + +The following example generates C2688: ```cpp // C2688.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2689.md b/docs/error-messages/compiler-errors-2/compiler-error-c2689.md index 82ab8e83b9d..0fb3674eb26 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2689.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2689.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2689" title: "Compiler Error C2689" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2689" +ms.date: 11/04/2016 f1_keywords: ["C2689"] helpviewer_keywords: ["C2689"] -ms.assetid: b5216fba-524d-4194-9168-26e9dc5210ce --- # Compiler Error C2689 -'function' : a friend function cannot be defined within a local class +> 'function' : a friend function cannot be defined within a local class + +## Remarks You can declare but not define a friend function in a local class. -The following sample generates C2689: +## Example + +The following example generates C2689: ```cpp // C2689.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2690.md b/docs/error-messages/compiler-errors-2/compiler-error-c2690.md index 8d9cf9f82a5..9885b8a0b12 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2690.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2690.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Compiler Error C2690" title: "Compiler Error C2690" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2690" +ms.date: 11/04/2016 f1_keywords: ["C2690"] helpviewer_keywords: ["C2690"] -ms.assetid: f165a806-14bd-4942-99b7-8a9fc7dea227 --- # Compiler Error C2690 -'operator' : cannot perform pointer arithmetic on a managed or WinRT array +> 'operator' : cannot perform pointer arithmetic on a managed or WinRT array + +## Remarks Pointer arithmetic is not allowed on a managed or WinRT array. Use array index notation to traverse the array. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2691.md b/docs/error-messages/compiler-errors-2/compiler-error-c2691.md index 9a6d9a67d90..b2ff8c3044d 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2691.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2691.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2691" title: "Compiler Error C2691" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2691" +ms.date: 11/04/2016 f1_keywords: ["C2691"] helpviewer_keywords: ["C2691"] -ms.assetid: 6925f8f3-ea60-4909-91e6-b781492c645d --- # Compiler Error C2691 -'data type' : a managed or WinRTarray cannot have this element type +> 'data type' : a managed or WinRTarray cannot have this element type + +## Remarks The type of a managed or WinRT array element can be a value type or a reference type. -The following sample generates C2691: +## Example + +The following example generates C2691: ```cpp // C2691a.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2692.md b/docs/error-messages/compiler-errors-2/compiler-error-c2692.md index cfeedd4078c..a415df2551f 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2692.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2692.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Compiler Error C2692" title: "Compiler Error C2692" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2692" +ms.date: 11/04/2016 f1_keywords: ["C2692"] helpviewer_keywords: ["C2692"] -ms.assetid: 02ade3b4-b757-448b-b065-d7d71bc3f441 --- # Compiler Error C2692 -'function_name' : fully prototyped functions required in C compiler with the '/clr' option +> 'function_name' : fully prototyped functions required in C compiler with the '/clr' option + +## Remarks When compiling for .NET managed code, the C compiler requires ANSI function declarations. In addition, if a function takes no parameters, it must explicitly declare **`void`** as the parameter type. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2693.md b/docs/error-messages/compiler-errors-2/compiler-error-c2693.md index d26adbe71c5..3cbf3814c91 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2693.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2693.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Compiler Error C2693" title: "Compiler Error C2693" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2693" +ms.date: 11/04/2016 f1_keywords: ["C2693"] helpviewer_keywords: ["C2693"] -ms.assetid: b7364ca8-b6be-48c0-97d6-6029787fb171 --- # Compiler Error C2693 -'operator' : illegal comparison for references to a managed or WinRT array +> 'operator' : illegal comparison for references to a managed or WinRT array + +## Remarks You cannot test a managed or WinRT array for any kind of inequality. For example, you can test to see if managed arrays are equal but you cannot test to see if one array is greater or less than another array. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2694.md b/docs/error-messages/compiler-errors-2/compiler-error-c2694.md index c093639deba..3b33248c161 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2694.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2694.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2694" title: "Compiler Error C2694" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2694" +ms.date: 11/04/2016 f1_keywords: ["C2694"] helpviewer_keywords: ["C2694"] -ms.assetid: 8dc2cec2-67ae-4e16-8c0c-374425aca8bc --- # Compiler Error C2694 -'override': overriding virtual function has less restrictive exception specification than base class virtual member function 'base' +> 'override': overriding virtual function has less restrictive exception specification than base class virtual member function 'base' + +## Remarks A virtual function was overridden, but under [/Za](../../build/reference/za-ze-disable-language-extensions.md), the overriding function had a less restrictive [exception specification](../../cpp/exception-specifications-throw-cpp.md). -The following sample generates C2694: +## Example + +The following example generates C2694: ```cpp // C2694.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2695.md b/docs/error-messages/compiler-errors-2/compiler-error-c2695.md index 5b24ca30b5d..4e2b58d9815 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2695.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2695.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2695" title: "Compiler Error C2695" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2695" +ms.date: 11/04/2016 f1_keywords: ["C2695"] helpviewer_keywords: ["C2695"] -ms.assetid: 3f6f2091-c38b-40ea-ab6c-f1846f5702d7 --- # Compiler Error C2695 -'function1': overriding virtual function differs from 'function2' only by calling convention +> 'function1': overriding virtual function differs from 'function2' only by calling convention + +## Remarks The signature of a function in a derived class cannot override a function in a base class and change the calling convention. -The following sample generates C2695: +## Example + +The following example generates C2695: ```cpp // C2695.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2696.md b/docs/error-messages/compiler-errors-2/compiler-error-c2696.md index 4939dc99786..27d130d222b 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2696.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2696.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Error C2696" title: "Compiler Error C2696" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2696" +ms.date: 11/04/2016 f1_keywords: ["C2696"] helpviewer_keywords: ["C2696"] -ms.assetid: 6c6eb7df-1230-4346-9a73-abf14c20785d --- # Compiler Error C2696 -Cannot create a temporary object of a managed type 'type' +> Cannot create a temporary object of a managed type 'type' + +## Remarks References to **`const`** in an unmanaged program cause the compiler to call the constructor and create a temporary object on the stack. However, a managed class can never be created on the stack. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2698.md b/docs/error-messages/compiler-errors-2/compiler-error-c2698.md index efdb26599fb..dbc7eef8618 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2698.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2698.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2698" title: "Compiler Error C2698" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2698" +ms.date: 11/04/2016 f1_keywords: ["C2698"] helpviewer_keywords: ["C2698"] -ms.assetid: 3ebfe395-c20b-4c56-9980-ca9ed8653382 --- # Compiler Error C2698 -the using-declaration for 'declaration 1' cannot co-exist with the existing using-declaration for 'declaration 2' +> the using-declaration for 'declaration 1' cannot co-exist with the existing using-declaration for 'declaration 2' + +## Remarks Once you have a [using declaration](../../cpp/using-declaration.md) for a data member, any using declaration in the same scope that uses the same name is not permitted, as only functions can be overloaded. -The following sample generates C2698: +## Example + +The following example generates C2698: ```cpp // C2698.cpp @@ -27,5 +30,5 @@ struct B { struct C : A, B { using A::x; using B::x; // C2698 -} +}; ``` diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2700.md b/docs/error-messages/compiler-errors-2/compiler-error-c2700.md index d843b7d0d84..9032db07969 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2700.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2700.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Compiler Error C2700" title: "Compiler Error C2700" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2700" +ms.date: 11/04/2016 f1_keywords: ["C2700"] helpviewer_keywords: ["C2700"] -ms.assetid: a231eb86-bdae-4b37-a606-06854f47929f --- # Compiler Error C2700 -'identifier' : cannot be thrown (use /W4 for more info) +> 'identifier' : cannot be thrown (use /W4 for more info) + +## Remarks The object cannot be thrown. Compile with [/W4](../../build/reference/compiler-option-warning-level.md) for more diagnostic information. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2701.md b/docs/error-messages/compiler-errors-2/compiler-error-c2701.md index 7db2a0789fb..6d038a0270c 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2701.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2701.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2701" title: "Compiler Error C2701" +description: "Learn more about: Compiler Error C2701" ms.date: 09/27/2022 f1_keywords: ["C2701"] helpviewer_keywords: ["C2701"] -ms.assetid: 31cf2ab7-ced9-4f75-aa51-e169e20407fb --- # Compiler Error C2701 > 'function': a function template cannot be a `friend` of a local class +## Remarks + A local class can't have a function template as a `friend` function. -The following sample generates C2701: +## Example + +The following example generates C2701: ```cpp // C2701.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2702.md b/docs/error-messages/compiler-errors-2/compiler-error-c2702.md index 8ab3ce78de1..d552a512152 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2702.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2702.md @@ -4,15 +4,18 @@ description: "Describes Microsoft C/C++ compiler error C2702." ms.date: 08/25/2020 f1_keywords: ["C2702"] helpviewer_keywords: ["C2702"] -ms.assetid: 6def15d4-9a8d-43e7-ae35-42d7cb57c27e --- # Compiler Error C2702 > `__except` may not appear in termination block +## Remarks + An exception handler (**`__try`**/**`__except`**) cannot be nested inside a **`__finally`** block. -The following sample generates C2702: +## Example + +The following example generates C2702: ```cpp // C2702.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2703.md b/docs/error-messages/compiler-errors-2/compiler-error-c2703.md index 113bf49c705..87adbc90511 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2703.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2703.md @@ -4,7 +4,6 @@ description: "Describes Microsoft C/C++ compiler error C2703." ms.date: 08/24/2020 f1_keywords: ["C2703"] helpviewer_keywords: ["C2703"] -ms.assetid: 384295c3-643d-47ae-a9a6-865b3036aa84 --- # Compiler Error C2703 @@ -16,7 +15,7 @@ A **`__leave`** statement must be inside a **`__try`** block. ## Example -The following sample generates C2703: +The following example generates C2703: ```cpp // C2703.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2704.md b/docs/error-messages/compiler-errors-2/compiler-error-c2704.md index 476dd462288..4d231d20a99 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2704.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2704.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Compiler Error C2704" title: "Compiler Error C2704" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2704" +ms.date: 11/04/2016 f1_keywords: ["C2704"] helpviewer_keywords: ["C2704"] -ms.assetid: 185797e2-55b5-4c11-8493-e70eb1d15a94 --- # Compiler Error C2704 -'identifier' : __va_start intrinsic only allowed in varargs +> 'identifier' : __va_start intrinsic only allowed in varargs + +## Remarks The `__va_start` intrinsic is used in a declaration for a function with a fixed number of arguments. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2705.md b/docs/error-messages/compiler-errors-2/compiler-error-c2705.md index 39fdf0029a3..d080e7a213e 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2705.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2705.md @@ -4,7 +4,6 @@ description: "Describes Microsoft C/C++ compiler error C2705." ms.date: 08/25/2020 f1_keywords: ["C2705"] helpviewer_keywords: ["C2705"] -ms.assetid: 29249ea3-4ea7-4105-944b-bdb83e8d6852 --- # Compiler Error C2705 @@ -16,7 +15,7 @@ Execution jumps to a label within a **`try`**/**`catch`**, **`__try`**/**`__exce ## Example -The following sample generates C2705: +The following example generates C2705: ```cpp // C2705.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2706.md b/docs/error-messages/compiler-errors-2/compiler-error-c2706.md index c21375885ed..0490d7807ca 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2706.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2706.md @@ -4,15 +4,18 @@ description: "Describes Microsoft C/C++ compiler error C2706." ms.date: 08/25/2020 f1_keywords: ["C2706"] helpviewer_keywords: ["C2706"] -ms.assetid: e18da924-c42d-4b09-8e29-f4e0382d7dc6 --- # Compiler Error C2706 > illegal `__except` without matching `__try` (missing '}' in `__try` block?) +## Remarks + The compiler did not find a closing brace for a **`__try`** block. -The following sample generates C2706: +## Example + +The following example generates C2706: ```cpp // C2706.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2707.md b/docs/error-messages/compiler-errors-2/compiler-error-c2707.md index ff081cdf341..3bfc8a90ae7 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2707.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2707.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Error C2707" title: "Compiler Error C2707" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2707" +ms.date: 11/04/2016 f1_keywords: ["C2707"] helpviewer_keywords: ["C2707"] -ms.assetid: 3deaf45c-74da-4c9d-acc6-b82412720b74 --- # Compiler Error C2707 -'identifier' : bad context for intrinsic function +> 'identifier' : bad context for intrinsic function + +## Remarks Structured exception-handling intrinsics are invalid in certain contexts: @@ -22,7 +23,7 @@ To resolve the error, be sure that the exception-handling intrinsics are placed ## Example -The following sample generates C2707. +The following example generates C2707. ```cpp // C2707.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2708.md b/docs/error-messages/compiler-errors-2/compiler-error-c2708.md index 72031e762ad..a8b2f3d6500 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2708.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2708.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Error C2708" title: "Compiler Error C2708" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2708" +ms.date: 11/04/2016 f1_keywords: ["C2708"] helpviewer_keywords: ["C2708"] -ms.assetid: d52d3088-1141-42f4-829c-74755a7fcc3a --- # Compiler Error C2708 -'identifier' : actual parameters length in bytes differs from previous call or reference +> 'identifier' : actual parameters length in bytes differs from previous call or reference + +## Remarks A [__stdcall](../../cpp/stdcall.md) function must be preceded by a prototype. Otherwise, the compiler interprets the first call to the function as a prototype and this error occurs when the compiler encounters a call that does not match. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2709.md b/docs/error-messages/compiler-errors-2/compiler-error-c2709.md index 8412aaff029..36a2376616d 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2709.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2709.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Compiler Error C2709" title: "Compiler Error C2709" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2709" +ms.date: 11/04/2016 f1_keywords: ["C2709"] helpviewer_keywords: ["C2709"] -ms.assetid: e66fc7e6-0e91-4b99-a6e0-fdb069b09fbc --- # Compiler Error C2709 -'identifier' : formal parameter's length in bytes differs from previous declaration +> 'identifier' : formal parameter's length in bytes differs from previous declaration + +## Remarks The signature in a call to the specified function differs from the prototype. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2710.md b/docs/error-messages/compiler-errors-2/compiler-error-c2710.md index 5b2ddea8617..3019c67c1ca 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2710.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2710.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2710" title: "Compiler Error C2710" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2710" +ms.date: 11/04/2016 f1_keywords: ["C2710"] helpviewer_keywords: ["C2710"] -ms.assetid: a2a6bb5b-86ad-4a6c-acd0-e2bef8464e0e --- # Compiler Error C2710 -'construct' : '__declspec(modifier)' can only be applied to a function returning a pointer +> 'construct' : '__declspec(modifier)' can only be applied to a function returning a pointer + +## Remarks A function whose return value is a pointer is the only construct to which `modifier` can be applied. -The following sample generates C2710: +## Example + +The following example generates C2710: ```cpp // C2710.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2711.md b/docs/error-messages/compiler-errors-2/compiler-error-c2711.md index 137e67e9338..a0b44f38278 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2711.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2711.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2711" title: "Compiler Error C2711" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2711" +ms.date: 11/04/2016 f1_keywords: ["C2711"] helpviewer_keywords: ["C2711"] -ms.assetid: 9df9f808-7419-4e63-abdd-e6538ff0871f --- # Compiler Error C2711 -'function' : this function cannot be compiled as managed, consider using #pragma unmanaged +> 'function' : this function cannot be compiled as managed, consider using #pragma unmanaged + +## Remarks Some instructions will prevent the compiler from generating MSIL for the enclosing function. -The following sample generates C2711: +## Example + +The following example generates C2711: ```cpp // C2711.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2712.md b/docs/error-messages/compiler-errors-2/compiler-error-c2712.md index 8b1b715cb00..b1caf1ca2da 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2712.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2712.md @@ -4,7 +4,6 @@ description: "Describes Microsoft C/C++ compiler error C2712." ms.date: 08/25/2020 f1_keywords: ["C2712"] helpviewer_keywords: ["C2712"] -ms.assetid: f7d4ffcc-7ed2-459b-8067-a728ce647071 --- # Compiler Error C2712 @@ -30,7 +29,7 @@ The **`/clr:pure`** and **`/clr:safe`** compiler options are deprecated in Visua ## Example -The following sample generates C2712 and shows how to fix it. +The following example generates C2712 and shows how to fix it. ```cpp // C2712.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2713.md b/docs/error-messages/compiler-errors-2/compiler-error-c2713.md index 59ee0bf0a9e..65eeed13bdc 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2713.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2713.md @@ -4,10 +4,11 @@ description: "Describes Microsoft C/C++ compiler error C2713." ms.date: 08/25/2020 f1_keywords: ["C2713"] helpviewer_keywords: ["C2713"] -ms.assetid: bae9bee3-b4b8-4be5-b6a5-02df587a7278 --- # Compiler Error C2713 > only one form of exception handling permitted per function +## Remarks + You can't use structured exception handling (**`__try`**/**`__except`**) and C++ exception handling (**`try`**/**`catch`**) in the same function. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2714.md b/docs/error-messages/compiler-errors-2/compiler-error-c2714.md index 95d86859dc7..c876015451b 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2714.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2714.md @@ -1,24 +1,23 @@ --- -description: "Learn more about: Compiler Error C2714" title: "Compiler Error C2714" +description: "Learn more about: Compiler Error C2714" ms.date: 07/22/2020 f1_keywords: ["C2714"] helpviewer_keywords: ["C2714"] -ms.assetid: 401a5a42-660c-4bad-9d63-1a2d092bc489 --- # Compiler Error C2714 > `alignof(void)` is not allowed -An invalid value was passed to an operator. - ## Remarks +An invalid value was passed to an operator. + See [`alignof` operator](../../cpp/alignof-operator.md) for more information. ## Example -The following sample generates C2714. +The following example generates C2714. ```cpp // C2714.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2715.md b/docs/error-messages/compiler-errors-2/compiler-error-c2715.md index 1321f85ca92..ddb31bc681b 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2715.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2715.md @@ -1,17 +1,22 @@ --- -description: "Learn more about: Compiler Error C2715" title: "Compiler Error C2715" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2715" +ms.date: 11/04/2016 f1_keywords: ["C2715"] helpviewer_keywords: ["C2715"] -ms.assetid: c81567a7-5b65-468f-aaf9-835f91e468e4 --- # Compiler Error C2715 -'type' : cannot throw or catch this type +> 'type' : cannot throw or catch this type + +## Remarks Value types are not valid arguments when using exception handling in managed code (see [Exception Handling](../../extensions/exception-handling-cpp-component-extensions.md) for more information). +## Example + +The following example generates C2715 and shows how to fix it: + ```cpp // C2715a.cpp // compile with: /clr diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2718.md b/docs/error-messages/compiler-errors-2/compiler-error-c2718.md index 6b67c1f9331..180afef6eac 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2718.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2718.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2718" title: "Compiler Error C2718" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2718" +ms.date: 11/04/2016 f1_keywords: ["C2718"] helpviewer_keywords: ["C2718"] -ms.assetid: 78cc71f8-c142-46fc-9aed-970635d74f0c --- # Compiler Error C2718 -'parameter': actual parameter with __declspec(align('#')) won't be aligned +> 'parameter': actual parameter with __declspec(align('#')) won't be aligned + +## Remarks The [align](../../cpp/align-cpp.md) **`__declspec`** modifier is not permitted on function parameters. -The following sample generates C2718: +## Example + +The following example generates C2718: ```cpp // C2718.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2719.md b/docs/error-messages/compiler-errors-2/compiler-error-c2719.md index 3b367a25ba2..6df11d9414e 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2719.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2719.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2719" title: "Compiler Error C2719" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2719" +ms.date: 11/04/2016 f1_keywords: ["C2719"] helpviewer_keywords: ["C2719"] -ms.assetid: ea6236d3-8286-45cc-9478-c84ad3dd3c8e --- # Compiler Error C2719 -'parameter': formal parameter with __declspec(align('#')) won't be aligned +> 'parameter': formal parameter with __declspec(align('#')) won't be aligned + +## Remarks The [align](../../cpp/align-cpp.md) **`__declspec`** modifier is not permitted on function parameters. Function parameter alignment is controlled by the calling convention used. For more information, see [Calling Conventions](../../cpp/calling-conventions.md). -The following sample generates C2719 and shows how to fix it: +## Example + +The following example generates C2719 and shows how to fix it: ```cpp // C2719.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2720.md b/docs/error-messages/compiler-errors-2/compiler-error-c2720.md index 40b1afaa4e3..66fd999f7a3 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2720.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2720.md @@ -1,20 +1,21 @@ --- -description: "Learn more about: Compiler Error C2720" title: "Compiler Error C2720" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2720" +ms.date: 11/04/2016 f1_keywords: ["C2720"] helpviewer_keywords: ["C2720"] -ms.assetid: 9ee3aab7-711b-4f5a-b2f1-cb62b130f1ce --- # Compiler Error C2720 > '*identifier*' : '*specifier*' storage-class specifier illegal on members +## Remarks + The storage class cannot be used on class members outside the declaration. To fix this error, remove the unneeded [storage class](../../cpp/storage-classes-cpp.md) specifier from the definition of the member outside the class declaration. ## Example -The following sample generates C2720 and shows how to fix it: +The following example generates C2720 and shows how to fix it: ```cpp // C2720.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2721.md b/docs/error-messages/compiler-errors-2/compiler-error-c2721.md index 0bafc693b29..2bfd272ae2c 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2721.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2721.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Compiler Error C2721" title: "Compiler Error C2721" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2721" +ms.date: 11/04/2016 f1_keywords: ["C2721"] helpviewer_keywords: ["C2721"] -ms.assetid: 7a97823c-3ce1-4112-8253-fc1448685235 --- # Compiler Error C2721 -'specifier' : storage-class specifier illegal between operator keyword and type +> 'specifier' : storage-class specifier illegal between operator keyword and type + +## Remarks User-defined type conversions apply to all storage classes, so you cannot specify a storage class in a type conversion. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2722.md b/docs/error-messages/compiler-errors-2/compiler-error-c2722.md index 0240cca6d41..892e345c5cc 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2722.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2722.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Compiler Error C2722" title: "Compiler Error C2722" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2722" +ms.date: 11/04/2016 f1_keywords: ["C2722"] helpviewer_keywords: ["C2722"] -ms.assetid: 4cc2c7fa-cb12-4bcf-9df1-6d627ef62973 --- # Compiler Error C2722 -'::operator' : illegal following operator command; use 'operator operator' +> '::operator' : illegal following operator command; use 'operator operator' + +## Remarks An `operator` statement redefines `::new` or `::delete`. The `new` and `delete` operators are global, so the scope resolution operator (`::`) is meaningless. Remove the `::` operator. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2723.md b/docs/error-messages/compiler-errors-2/compiler-error-c2723.md index 48dad9d850c..b878410fa11 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2723.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2723.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2723" title: "Compiler Error C2723" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2723" +ms.date: 11/04/2016 f1_keywords: ["C2723"] helpviewer_keywords: ["C2723"] -ms.assetid: 86925601-2297-4cfd-94e2-2caf27c474c4 --- # Compiler Error C2723 -'function' : 'specifier' specifier illegal on function definition +> 'function' : 'specifier' specifier illegal on function definition + +## Remarks The specifier cannot appear with a function definition outside of a class declaration. The **`virtual`** specifier can be specified only on a member function declaration within a class declaration. -The following sample generates C2723 and shows how to fix it: +## Example + +The following example generates C2723 and shows how to fix it: ```cpp // C2723.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2724.md b/docs/error-messages/compiler-errors-2/compiler-error-c2724.md index 534107c5007..21e3b41693d 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2724.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2724.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2724" title: "Compiler Error C2724" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2724" +ms.date: 11/04/2016 f1_keywords: ["C2724"] helpviewer_keywords: ["C2724"] -ms.assetid: 4e4664bc-8c96-4156-b79f-03436f532ea8 --- # Compiler Error C2724 -'identifier' : 'static' should not be used on member functions defined at file scope +> 'identifier' : 'static' should not be used on member functions defined at file scope + +## Remarks Static member functions should be declared with external linkage. -The following sample generates C2724: +## Example + +The following example generates C2724: ```cpp // C2724.cpp @@ -20,7 +23,7 @@ class C { static void func(); }; -static void C::func(){}; // C2724 +static void C::func(){} // C2724 // try the following line instead -// void C::func(){}; +// void C::func(){} ``` diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2725.md b/docs/error-messages/compiler-errors-2/compiler-error-c2725.md index b362cad13e2..ef72d45e281 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2725.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2725.md @@ -1,20 +1,21 @@ --- -description: "Learn more about: Compiler Error C2725" title: "Compiler Error C2725" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2725" +ms.date: 11/04/2016 f1_keywords: ["C2725"] helpviewer_keywords: ["C2725"] -ms.assetid: 13cd5b1b-e906-4cd8-9b2b-510d587c665a --- # Compiler Error C2725 -'exception' : unable to throw or catch a managed or WinRT object by value or reference +> 'exception' : unable to throw or catch a managed or WinRT object by value or reference + +## Remarks The type of a managed or WinRT exception was not correct. ## Examples -The following sample generates C2725 and shows how to fix it. +The following example generates C2725 and shows how to fix it. ```cpp // C2725.cpp @@ -33,7 +34,7 @@ int main() { } ``` -The following sample generates C2725 and shows how to fix it. +The following example generates C2725 and shows how to fix it. ```cpp // C2725b.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2726.md b/docs/error-messages/compiler-errors-2/compiler-error-c2726.md index 1cf7c3f939c..22aa1b52408 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2726.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2726.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2726" title: "Compiler Error C2726" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2726" +ms.date: 11/04/2016 f1_keywords: ["C2726"] helpviewer_keywords: ["C2726"] -ms.assetid: f0191bb7-c175-450b-bf09-a3213db96d09 --- # Compiler Error C2726 -'gcnew' may only be used to create an object with managed or WinRT type +> 'gcnew' may only be used to create an object with managed or WinRT type + +## Remarks You cannot create an instance of a native type on the garbage-collected heap. -The following sample generates C2726 and shows how to fix it: +## Example + +The following example generates C2726 and shows how to fix it: ```cpp // C2726.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2728.md b/docs/error-messages/compiler-errors-2/compiler-error-c2728.md index 79660264d06..8300ece3561 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2728.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2728.md @@ -1,20 +1,23 @@ --- -description: "Learn more about: Compiler Error C2728" title: "Compiler Error C2728" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2728" +ms.date: 11/04/2016 f1_keywords: ["C2728"] helpviewer_keywords: ["C2728"] -ms.assetid: 65635f91-1cd1-46e4-9ad7-14726d0546af --- # Compiler Error C2728 -'type' : a native array cannot contain this type +> 'type' : a native array cannot contain this type + +## Remarks Array creation syntax was used to create an array of managed or WinRT objects. You cannot create an array of managed or WinRT objects using native array syntax. For more information, see [array](../../extensions/arrays-cpp-component-extensions.md). -The following sample generates C2728 and shows how to fix it: +## Example + +The following example generates C2728 and shows how to fix it: ```cpp // C2728.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2730.md b/docs/error-messages/compiler-errors-2/compiler-error-c2730.md index b7a014e42cd..f06cf3b7fed 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2730.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2730.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Compiler Error C2730" title: "Compiler Error C2730" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2730" +ms.date: 11/04/2016 f1_keywords: ["C2730"] helpviewer_keywords: ["C2730"] -ms.assetid: 07f0b17a-bc8e-4d79-af5a-07a07af3687b --- # Compiler Error C2730 -'class' : cannot be a base class of itself +> 'class' : cannot be a base class of itself + +## Remarks Recursive base classes are invalid. Specify another class as the base class. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2731.md b/docs/error-messages/compiler-errors-2/compiler-error-c2731.md index 3140f55a23e..beb16353908 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2731.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2731.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2731" title: "Compiler Error C2731" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2731" +ms.date: 11/04/2016 f1_keywords: ["C2731"] helpviewer_keywords: ["C2731"] -ms.assetid: 9b563999-febd-4582-9147-f355083c091e --- # Compiler Error C2731 -'identifier' : function cannot be overloaded +> 'identifier' : function cannot be overloaded + +## Remarks The functions `main`, `WinMain`, `DllMain`, and `LibMain` cannot be overloaded. -The following sample generates C2731: +## Example + +The following example generates C2731: ```cpp // C2731.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2732.md b/docs/error-messages/compiler-errors-2/compiler-error-c2732.md index a8c934d69a8..6984e65b413 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2732.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2732.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Error C2732" title: "Compiler Error C2732" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2732" +ms.date: 11/04/2016 f1_keywords: ["C2732"] helpviewer_keywords: ["C2732"] -ms.assetid: 01b7ad2c-93cf-456f-a4c0-c5f2fdc7c07c --- # Compiler Error C2732 -linkage specification contradicts earlier specification for 'function' +> linkage specification contradicts earlier specification for 'function' + +## Remarks The function is already declared with a different linkage specifier. @@ -18,7 +19,7 @@ To fix this error, change the **`extern`** statements so that the linkages agree ## Example -The following sample generates C2732: +The following example generates C2732: ```cpp // C2732.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2733.md b/docs/error-messages/compiler-errors-2/compiler-error-c2733.md index 03a7ae6bf2f..ba6d27d4753 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2733.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2733.md @@ -1,22 +1,23 @@ --- -description: "Learn more about: Compiler Error C2733" title: "Compiler Error C2733" +description: "Learn more about: Compiler Error C2733" ms.date: 12/02/2021 f1_keywords: ["C2733"] helpviewer_keywords: ["C2733"] -ms.assetid: 67f83561-c633-407c-a2ee-f9fd16e165bf --- # Compiler Error C2733 > you cannot overload a function with 'C' linkage +## Remarks + More than one overloaded function is declared with `extern "C"` linkage. When using `"C"` linkage, only one form of a specified function can be external. Since overloaded functions have the same undecorated name, they can't be used with C programs. This error may occur after an upgrade because of conformance changes in Visual Studio 2019. Starting in Visual Studio 2019 version 16.3, the [`/Zc:externC-`](../../build/reference/zc-externc.md) compiler option relaxes this check. The option must come after any [`/permissive-`](../../build/reference/permissive-standards-conformance.md) option on the command line. ## Example -The following sample generates C2733: +The following example generates C2733: ```cpp // C2733.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2734.md b/docs/error-messages/compiler-errors-2/compiler-error-c2734.md index 926b55a676b..c11247bd758 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2734.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2734.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2734" title: "Compiler Error C2734" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2734" +ms.date: 11/04/2016 f1_keywords: ["C2734"] helpviewer_keywords: ["C2734"] -ms.assetid: e53a77b7-825c-42d1-a655-90e1c93b833e --- # Compiler Error C2734 -'identifier' : const object must be initialized if not extern +> 'identifier' : const object must be initialized if not extern + +## Remarks The identifier is declared **`const`** but not initialized or **`extern`**. -The following sample generates C2734: +## Example + +The following example generates C2734: ```cpp // C2734.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2735.md b/docs/error-messages/compiler-errors-2/compiler-error-c2735.md index c3549dc46d5..8f363b12b84 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2735.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2735.md @@ -1,20 +1,25 @@ --- -description: "Learn more about: Compiler Error C2735" title: "Compiler Error C2735" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2735" +ms.date: 09/12/2025 f1_keywords: ["C2735"] helpviewer_keywords: ["C2735"] -ms.assetid: 6ce45600-7148-4bc0-8699-af0ef137571e --- # Compiler Error C2735 -'keyword' keyword is not permitted in formal parameter type specifier +> '*keyword*' keyword is not permitted in formal parameter type specifier + +## Remarks The keyword is invalid in this context. -The following sample generates C2735: +## Example + +The following example generates C2735: ```cpp // C2735.cpp -void f(inline int){} // C2735 +// compile with: /c + +void func(virtual int) {} // C2735 ``` diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2736.md b/docs/error-messages/compiler-errors-2/compiler-error-c2736.md index b0135806686..a17c5de2ad8 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2736.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2736.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2736" title: "Compiler Error C2736" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2736" +ms.date: 11/04/2016 f1_keywords: ["C2736"] helpviewer_keywords: ["C2736"] -ms.assetid: 95a6bc28-c0cb-49dc-87e6-e993dbbba881 --- # Compiler Error C2736 -'keyword' keyword is not permitted in cast +> 'keyword' keyword is not permitted in cast + +## Remarks The keyword is invalid in a cast. -The following sample generates C2736: +## Example + +The following example generates C2736: ```cpp // C2736.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2738.md b/docs/error-messages/compiler-errors-2/compiler-error-c2738.md index b640ef4a018..4eeec6e77a0 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2738.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2738.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2738" title: "Compiler Error C2738" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2738" +ms.date: 11/04/2016 f1_keywords: ["C2738"] helpviewer_keywords: ["C2738"] -ms.assetid: 896b4640-1ee0-4cd8-9910-de3efa30006a --- # Compiler Error C2738 -'declaration' : is ambiguous or is not a member of 'type' +> 'declaration' : is ambiguous or is not a member of 'type' + +## Remarks A function was declared incorrectly. -The following sample generates C2738: +## Example + +The following example generates C2738: ```cpp // C2738.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2739.md b/docs/error-messages/compiler-errors-2/compiler-error-c2739.md index 15c3f8b0ea8..3125f5102bb 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2739.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2739.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2739" title: "Compiler Error C2739" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2739" +ms.date: 11/04/2016 f1_keywords: ["C2739"] helpviewer_keywords: ["C2739"] -ms.assetid: 5b63e435-7631-43d7-805e-f2adefb7e517 --- # Compiler Error C2739 -'number' : explicit managed or WinRT array dimensions must be between 1 and 32 +> 'number' : explicit managed or WinRT array dimensions must be between 1 and 32 + +## Remarks An array dimension was not between 1 and 32. -The following sample generates C2739 and shows how to fix it: +## Example + +The following example generates C2739 and shows how to fix it: ```cpp // C2739.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2743.md b/docs/error-messages/compiler-errors-2/compiler-error-c2743.md index 82d0b04f293..0f2118ff291 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2743.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2743.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Error C2743" title: "Compiler Error C2743" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2743" +ms.date: 11/04/2016 f1_keywords: ["C2743"] helpviewer_keywords: ["C2743"] -ms.assetid: 644cd444-21d2-471d-a176-f5f52c5a0b73 --- # Compiler Error C2743 -'type' : cannot catch a native type with __clrcall destructor or copy constructor +> 'type' : cannot catch a native type with __clrcall destructor or copy constructor + +## Remarks A module compiled with **/clr** attempted to catch an exception of native type and where the type's destructor or copy constructor uses `__clrcall` calling convention. @@ -18,7 +19,7 @@ For more information, see [/clr (Common Language Runtime Compilation)](../../bui ## Example -The following sample generates C2743. +The following example generates C2743. ```cpp // C2743.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2745.md b/docs/error-messages/compiler-errors-2/compiler-error-c2745.md index efa92f63c9e..4fbbf13bcce 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2745.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2745.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2745" title: "Compiler Error C2745" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2745" +ms.date: 11/04/2016 f1_keywords: ["C2745"] helpviewer_keywords: ["C2745"] -ms.assetid: a1c45f13-7667-4678-aa16-265304a449a1 --- # Compiler Error C2745 -'token' : this token cannot be converted to an identifier +> 'token' : this token cannot be converted to an identifier + +## Remarks Identifiers must be comprised of legal characters. -The following sample generates C2745: +## Example + +The following example generates C2745: ```cpp // C2745.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2748.md b/docs/error-messages/compiler-errors-2/compiler-error-c2748.md index df420793898..c7a99b67943 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2748.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2748.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2748" title: "Compiler Error C2748" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2748" +ms.date: 11/04/2016 f1_keywords: ["C2748"] helpviewer_keywords: ["C2748"] -ms.assetid: b63ac78b-a200-499c-afea-15af1a1e819e --- # Compiler Error C2748 -managed or WinRT array creation must have array size or array initializer +> managed or WinRT array creation must have array size or array initializer + +## Remarks A managed or WinRT array was ill formed. For more information, see [array](../../extensions/arrays-cpp-component-extensions.md). -The following sample generates C2748 and shows how to fix it: +## Example + +The following example generates C2748 and shows how to fix it: ```cpp // C2748.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2749.md b/docs/error-messages/compiler-errors-2/compiler-error-c2749.md index 293ce1aaab8..c2bc309d835 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2749.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2749.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Error C2749" title: "Compiler Error C2749" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2749" +ms.date: 11/04/2016 f1_keywords: ["C2749"] helpviewer_keywords: ["C2749"] -ms.assetid: a81aef36-cdca-4d78-89d5-b72eff2500b2 --- # Compiler Error C2749 -'type' : can only throw or catch handle to a managed class with /clr:safe +> 'type' : can only throw or catch handle to a managed class with /clr:safe + +## Remarks When using **/clr:safe**, you can only throw or catch a reference type. @@ -16,7 +17,7 @@ For more information, see [/clr (Common Language Runtime Compilation)](../../bui ## Example -The following sample generates C2749: +The following example generates C2749: ```cpp // C2749.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2750.md b/docs/error-messages/compiler-errors-2/compiler-error-c2750.md index f38c917907c..55899400da8 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2750.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2750.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2750" title: "Compiler Error C2750" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2750" +ms.date: 11/04/2016 f1_keywords: ["C2750"] helpviewer_keywords: ["C2750"] -ms.assetid: 30450034-feb5-448c-9655-b8c5f3639695 --- # Compiler Error C2750 -'type' : cannot use 'new' on the reference type; use 'gcnew' instead +> 'type' : cannot use 'new' on the reference type; use 'gcnew' instead + +## Remarks To create an instance of a CLR type, which causes the instance to be placed on the garbage-collected heap, you must use [gcnew](../../extensions/ref-new-gcnew-cpp-component-extensions.md). -The following sample generates C2750: +## Example + +The following example generates C2750: ```cpp // C2750.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2751.md b/docs/error-messages/compiler-errors-2/compiler-error-c2751.md index 6a466cdf6a8..ef7c77075c1 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2751.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2751.md @@ -1,17 +1,21 @@ --- -description: "Learn more about: Compiler Error C2751" title: "Compiler Error C2751" -ms.date: "03/11/2024" +description: "Learn more about: Compiler Error C2751" +ms.date: 03/11/2024 f1_keywords: ["C2751"] helpviewer_keywords: ["C2751"] --- # Compiler Error C2751 -'parameter' : the name of a function parameter cannot be qualified +> 'parameter' : the name of a function parameter cannot be qualified + +## Remarks You cannot use a qualified name as a function parameter. -The following sample generates C2751: +## Example + +The following example generates C2751: ```cpp // C2751.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2752.md b/docs/error-messages/compiler-errors-2/compiler-error-c2752.md index 62770f96025..5c0d2337ce2 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2752.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2752.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2752" title: "Compiler Error C2752" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2752" +ms.date: 11/04/2016 f1_keywords: ["C2752"] helpviewer_keywords: ["C2752"] -ms.assetid: ae42b3ec-84a9-4e9d-8d59-3d208132d0b2 --- # Compiler Error C2752 -'template' : more than one partial specialization matches the template argument list +> 'template' : more than one partial specialization matches the template argument list + +## Remarks An instantiation was ambiguous. -The following sample generates C2752: +## Example + +The following example generates C2752: ```cpp // C2752.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2753.md b/docs/error-messages/compiler-errors-2/compiler-error-c2753.md index ba0897b0d1e..9f68e282613 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2753.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2753.md @@ -1,20 +1,21 @@ --- -description: "Learn more about: Compiler Error C2753" title: "Compiler Error C2753" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2753" +ms.date: 11/04/2016 f1_keywords: ["C2753"] helpviewer_keywords: ["C2753"] -ms.assetid: 92bfeeac-524a-4a8e-9a4f-fb8269055826 --- # Compiler Error C2753 -'*template*' : partial specialization cannot match argument list for primary template +> '*template*' : partial specialization cannot match argument list for primary template + +## Remarks If the template argument list matches the parameter list, the compiler treats it as the same template. Defining the same template twice is not allowed. ## Example -The following sample generates C2753 and shows a way to fix it: +The following example generates C2753 and shows a way to fix it: ```cpp // C2753.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2754.md b/docs/error-messages/compiler-errors-2/compiler-error-c2754.md index fafd439fa48..8b391baaa37 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2754.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2754.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2754" title: "Compiler Error C2754" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2754" +ms.date: 11/04/2016 f1_keywords: ["C2754"] helpviewer_keywords: ["C2754"] -ms.assetid: 1cab66c5-da9d-4b81-b7fb-9cdc48ff1ccc --- # Compiler Error C2754 -'specialization' : a partial specialization cannot have a dependent non-type template parameter +> 'specialization' : a partial specialization cannot have a dependent non-type template parameter + +## Remarks An attempt was made to partially specialize a template class that has a dependent non-type template parameter. This is not allowed. -The following sample generates C2754: +## Example + +The following example generates C2754: ```cpp // C2754.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2755.md b/docs/error-messages/compiler-errors-2/compiler-error-c2755.md index 99a5290a5fd..adabdd70a83 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2755.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2755.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2755" title: "Compiler Error C2755" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2755" +ms.date: 11/04/2016 f1_keywords: ["C2755"] helpviewer_keywords: ["C2755"] -ms.assetid: 8ee4eeb6-4757-4efe-9100-38ff4a96f1de --- # Compiler Error C2755 -'param' : non-type parameter of a partial specialization must be a simple identifier +> 'param' : non-type parameter of a partial specialization must be a simple identifier + +## Remarks The non-type parameter needs to be a simple identifier, something the compiler can resolve at compile time to a single identifier or a constant value. -The following sample generates C2755: +## Example + +The following example generates C2755: ```cpp // C2755.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2756.md b/docs/error-messages/compiler-errors-2/compiler-error-c2756.md index 429fa87ea10..5f7089c2367 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2756.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2756.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2756" title: "Compiler Error C2756" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2756" +ms.date: 11/04/2016 f1_keywords: ["C2756"] helpviewer_keywords: ["C2756"] -ms.assetid: 42eb988d-4043-4dee-8fd4-596949f69a55 --- # Compiler Error C2756 -'template type' : default template arguments not allowed on a partial specialization +> 'template type' : default template arguments not allowed on a partial specialization + +## Remarks The template for a partial specialization may not contain a default argument. -The following sample generates C2756 and shows how to fix it: +## Example + +The following example generates C2756 and shows how to fix it: ```cpp // C2756.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2757.md b/docs/error-messages/compiler-errors-2/compiler-error-c2757.md index 5a863c1b734..a759aa5196f 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2757.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2757.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2757" title: "Compiler Error C2757" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2757" +ms.date: 11/04/2016 f1_keywords: ["C2757"] helpviewer_keywords: ["C2757"] -ms.assetid: 421f102f-8a32-4d47-a109-811ddf2c909d --- # Compiler Error C2757 -'symbol' : a symbol with this name already exists and therefore this name cannot be used as a namespace name +> 'symbol' : a symbol with this name already exists and therefore this name cannot be used as a namespace name + +## Remarks A symbol used in the current compilation as a namespace identifier is already being used in a referenced assembly. -The following sample generates C2757: +## Example + +The following example generates C2757: ```cpp // C2757a.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2758.md b/docs/error-messages/compiler-errors-2/compiler-error-c2758.md index ad5301bf1e3..3b5c2bed46f 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2758.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2758.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2758" title: "Compiler Error C2758" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2758" +ms.date: 11/04/2016 f1_keywords: ["C2758"] helpviewer_keywords: ["C2758"] -ms.assetid: 1d273034-194c-4926-9869-142d1b219cbe --- # Compiler Error C2758 -'member': a member of reference type must be initialized +> 'member': a member of reference type must be initialized + +## Remarks Compiler error C2758 is caused when the constructor does not initialize a member of reference type in an initializer list. The compiler leaves the member undefined. Reference member variables must initialized when declared or be given a value in the initialization list of the constructor. -The following sample generates C2758: +## Example + +The following example generates C2758: ```cpp // C2758.cpp @@ -20,8 +23,8 @@ The following sample generates C2758: struct A { const int i; - A(int n) { }; // C2758 + A(int n) { } // C2758 // try the following line instead - // A(int n) : i{n} {}; + // A(int n) : i{n} {} }; ``` diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2760.md b/docs/error-messages/compiler-errors-2/compiler-error-c2760.md index e33c5a9552a..619d63d8c42 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2760.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2760.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2760" title: "Compiler Error C2760" +description: "Learn more about: Compiler Error C2760" ms.date: 08/12/2021 f1_keywords: ["C2760"] helpviewer_keywords: ["C2760"] -ms.assetid: 585757fd-d519-43f3-94e5-50316ac8b90b --- # Compiler Error C2760 @@ -16,9 +15,9 @@ ms.assetid: 585757fd-d519-43f3-94e5-50316ac8b90b There are several ways to cause this error. Usually, it's caused by a token sequence that the compiler can't make sense of. -## Example +## Examples -In this sample, a casting operator is used with an invalid operator. +In this example, a casting operator is used with an invalid operator. ```cpp // C2760.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2761.md b/docs/error-messages/compiler-errors-2/compiler-error-c2761.md index 1e8e60e233f..ab82d98deff 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2761.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2761.md @@ -1,20 +1,21 @@ --- -description: "Learn more about: Compiler Error C2761" title: "Compiler Error C2761" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2761" +ms.date: 11/04/2016 f1_keywords: ["C2761"] helpviewer_keywords: ["C2761"] -ms.assetid: 38c79a05-b56d-485b-820f-95e8c0cb926f --- # Compiler Error C2761 -'function' : member function redeclaration not allowed +> 'function' : member function redeclaration not allowed + +## Remarks You cannot redeclare a member function. You can define it, but not redeclare it. ## Examples -The following sample generates C2761. +The following example generates C2761. ```cpp // C2761.cpp @@ -27,7 +28,7 @@ void a::a; // C2761 void a::test; // C2761 ``` -Nonstatic members of a class or structure cannot be defined. The following sample generates C2761. +Nonstatic members of a class or structure cannot be defined. The following example generates C2761. ```cpp // C2761_b.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2762.md b/docs/error-messages/compiler-errors-2/compiler-error-c2762.md index 6b64d52ba52..6892019ad37 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2762.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2762.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2762" title: "Compiler Error C2762" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2762" +ms.date: 11/04/2016 f1_keywords: ["C2762"] helpviewer_keywords: ["C2762"] -ms.assetid: 8b81a801-fd48-40a1-8bee-0748795b12e4 --- # Compiler Error C2762 -'class' : invalid expression as a template argument for 'argument' +> 'class' : invalid expression as a template argument for 'argument' + +## Remarks When using [/Za](../../build/reference/za-ze-disable-language-extensions.md), the compiler will not convert an integral to a pointer. -The following sample generates C2762: +## Example + +The following example generates C2762: ```cpp // C2762.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2764.md b/docs/error-messages/compiler-errors-2/compiler-error-c2764.md index cc1c8e94940..52a87747fd5 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2764.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2764.md @@ -1,20 +1,21 @@ --- -description: "Learn more about: Compiler Error C2764" title: "Compiler Error C2764" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2764" +ms.date: 11/04/2016 f1_keywords: ["C2764"] helpviewer_keywords: ["C2764"] -ms.assetid: 3754f5af-e094-4425-be20-d0c9a9b5baec --- # Compiler Error C2764 -'param' : template parameter not used or deducible in partial specialization 'specialization' +> 'param' : template parameter not used or deducible in partial specialization 'specialization' + +## Remarks A template parameter is not used in a partial specialization. This makes the partial specialization unusable because the template parameter cannot be deduced. ## Example -The following sample generates C2764: +The following example generates C2764: ```cpp // C2764.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2765.md b/docs/error-messages/compiler-errors-2/compiler-error-c2765.md index e00d03d4855..46067a15fc3 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2765.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2765.md @@ -1,22 +1,25 @@ --- -description: "Learn more about: Compiler Error C2765" title: "Compiler Error C2765" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2765" +ms.date: 11/04/2016 f1_keywords: ["C2765"] helpviewer_keywords: ["C2765"] -ms.assetid: 47ad86f3-a7e0-47ad-85ff-0f5534458cb9 --- # Compiler Error C2765 -'function' : an explicit specialization of a function template cannot have any default arguments +> 'function' : an explicit specialization of a function template cannot have any default arguments + +## Remarks Default arguments are not allowed on an explicit specialization of a function template. For more information, see [Explicit Specialization of Function Templates](../../cpp/explicit-specialization-of-function-templates.md). -The following sample generates C2765: +## Example + +The following example generates C2765: ```cpp // C2765.cpp -template void f(T t) {}; +template void f(T t) {} template<> void f(char c = 'a') {} // C2765 // try the following line instead diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2766.md b/docs/error-messages/compiler-errors-2/compiler-error-c2766.md index 765ffaba7d7..f683b8433a2 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2766.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2766.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2766" title: "Compiler Error C2766" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2766" +ms.date: 11/04/2016 f1_keywords: ["C2766"] helpviewer_keywords: ["C2766"] -ms.assetid: 8032f4ca-6827-4f04-9c61-c44643c85cc4 --- # Compiler Error C2766 -explicit specialization; 'specialization' has already been defined +> explicit specialization; 'specialization' has already been defined + +## Remarks Duplicate explicit specializations are not allowed. For more information, see [Explicit Specialization of Function Templates](../../cpp/explicit-specialization-of-function-templates.md). -The following sample generates C2766: +## Example + +The following example generates C2766: ```cpp // C2766.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2767.md b/docs/error-messages/compiler-errors-2/compiler-error-c2767.md index 0e37e783405..07706df7ad5 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2767.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2767.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2767" title: "Compiler Error C2767" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2767" +ms.date: 11/04/2016 f1_keywords: ["C2767"] helpviewer_keywords: ["C2767"] -ms.assetid: e8f84178-a160-4d71-a236-07e4fcc11e96 --- # Compiler Error C2767 -managed or WinRTarray dimension mismatch : expected N argument(s) - M provided +> managed or WinRTarray dimension mismatch : expected N argument(s) - M provided + +## Remarks A managed or WinRT array declaration was ill formed. For more information, see [array](../../extensions/arrays-cpp-component-extensions.md). -The following sample generates C2767 and shows how to fix it: +## Example + +The following example generates C2767 and shows how to fix it: ```cpp // C2767.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2768.md b/docs/error-messages/compiler-errors-2/compiler-error-c2768.md index c8ae01c2c0c..472b925a5e1 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2768.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2768.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2768" title: "Compiler Error C2768" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2768" +ms.date: 11/04/2016 f1_keywords: ["C2768"] helpviewer_keywords: ["C2768"] -ms.assetid: a7f6047a-6a80-4737-ad5c-c12868639fb5 --- # Compiler Error C2768 @@ -18,7 +17,7 @@ This error was introduced in Visual Studio .NET 2003, as part of the compiler co ## Example -The following sample generates C2768: +The following example generates C2768: ```cpp // C2768.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2770.md b/docs/error-messages/compiler-errors-2/compiler-error-c2770.md index 93734f5356f..0e0d7839fdb 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2770.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2770.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2770" title: "Compiler Error C2770" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2770" +ms.date: 11/04/2016 f1_keywords: ["C2770"] helpviewer_keywords: ["C2770"] -ms.assetid: 100001b5-80b0-4971-8ff6-9023f443c926 --- # Compiler Error C2770 -invalid explicit template_or_generic argument(s) for 'template' +> invalid explicit template_or_generic argument(s) for 'template' + +## Remarks Function template candidates with explicit template or generic arguments resulted in disallowed function types. -The following sample generates C2770: +## Example + +The following example generates C2770: ```cpp // C2770.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2771.md b/docs/error-messages/compiler-errors-2/compiler-error-c2771.md index f6d00ce5b5e..beafafe99db 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2771.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2771.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Compiler Error C2771" title: "Compiler Error C2771" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2771" +ms.date: 11/04/2016 f1_keywords: ["C2771"] helpviewer_keywords: ["C2771"] -ms.assetid: b649cc9f-7cbc-4b42-a5e8-51dad5c55e4b --- # Compiler Error C2771 -\#import only permitted at global or namespace scope +> #import only permitted at global or namespace scope + +## Remarks The `#import` directive is not allowed in, for example, a function or structure. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2773.md b/docs/error-messages/compiler-errors-2/compiler-error-c2773.md index a5269df8cb4..01ca8986236 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2773.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2773.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Compiler Error C2773" title: "Compiler Error C2773" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2773" +ms.date: 11/04/2016 f1_keywords: ["C2773"] helpviewer_keywords: ["C2773"] -ms.assetid: 8d564b26-1623-4d92-aabc-dff33f7b1145 --- # Compiler Error C2773 -\#import and #using available only in C++ compiler +> #import and #using available only in C++ compiler + +## Remarks The C compiler does not recognize the `#import` preprocessor directive. Compile the source as C++. Use [/TP](../../build/reference/tc-tp-tc-tp-specify-source-file-type.md) if necessary. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2774.md b/docs/error-messages/compiler-errors-2/compiler-error-c2774.md index 83bb2f1f579..6ad8e6659e4 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2774.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2774.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2774" title: "Compiler Error C2774" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2774" +ms.date: 11/04/2016 f1_keywords: ["C2774"] helpviewer_keywords: ["C2774"] -ms.assetid: 10f428c6-7f49-489a-92ba-6ef978b7caaf --- # Compiler Error C2774 -'identifier' : no 'put' method is associated with this property +> 'identifier' : no 'put' method is associated with this property + +## Remarks A data member declared with [property](../../cpp/property-cpp.md) has no `put` function, but an expression tries to set its value. -The following sample generates C2774: +## Example + +The following example generates C2774: ```cpp // C2774.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2775.md b/docs/error-messages/compiler-errors-2/compiler-error-c2775.md index 0997247f838..00654e73f7a 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2775.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2775.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2775" title: "Compiler Error C2775" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2775" +ms.date: 11/04/2016 f1_keywords: ["C2775"] helpviewer_keywords: ["C2775"] -ms.assetid: 9c488508-ade0-48f1-b94f-d538d15f807a --- # Compiler Error C2775 -'identifier' : no 'get' method is associated with this property +> 'identifier' : no 'get' method is associated with this property + +## Remarks A data member declared with the [property](../../cpp/property-cpp.md) extended attribute does not have a `get` function specified, but an expression tries to retrieve its value. -The following sample generates C2775: +## Example + +The following example generates C2775: ```cpp // C2775.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2776.md b/docs/error-messages/compiler-errors-2/compiler-error-c2776.md index 94145080436..a1844454dfa 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2776.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2776.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2776" title: "Compiler Error C2776" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2776" +ms.date: 11/04/2016 f1_keywords: ["C2776"] helpviewer_keywords: ["C2776"] -ms.assetid: 9d80addc-62c7-40fc-a2cc-60303abb87df --- # Compiler Error C2776 -only one 'get' method can be specified per property +> only one 'get' method can be specified per property + +## Remarks You can only specify one `get` function in the [property](../../cpp/property-cpp.md) extended attribute. This error occurs when multiple `get` functions are specified. -The following sample generates C2776: +## Example + +The following example generates C2776: ```cpp // C2776.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2777.md b/docs/error-messages/compiler-errors-2/compiler-error-c2777.md index cff4aef538b..5b624a0afe0 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2777.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2777.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2777" title: "Compiler Error C2777" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2777" +ms.date: 11/04/2016 f1_keywords: ["C2777"] helpviewer_keywords: ["C2777"] -ms.assetid: 5fe158c0-2a65-488a-aca2-61d4a8b32d43 --- # Compiler Error C2777 -only one 'put' method can be specified per property +> only one 'put' method can be specified per property + +## Remarks A [property](../../cpp/property-cpp.md) declspec modifier had more than one `put` property. -The following sample generates C2777: +## Example + +The following example generates C2777: ```cpp // C2777.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2778.md b/docs/error-messages/compiler-errors-2/compiler-error-c2778.md index febe7f24c82..5988f1aa528 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2778.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2778.md @@ -1,17 +1,20 @@ --- -description: "Learn more about: Compiler Error C2778" title: "Compiler Error C2778" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2778" +ms.date: 11/04/2016 f1_keywords: ["C2778"] helpviewer_keywords: ["C2778"] -ms.assetid: b24cb732-2914-42cc-8928-e2d87b393428 --- # Compiler Error C2778 -improperly formed GUID in __declspec(uuid()) +> improperly formed GUID in __declspec(uuid()) + +## Remarks An incorrect GUID is supplied to the [uuid](../../cpp/uuid-cpp.md) extended attribute. +## Example + The GUID must be a string of hexadecimal numbers with the following format: ```cpp @@ -23,7 +26,7 @@ struct __declspec(uuid("{00000000-0000-0000-0000-000000000000}")) B{}; The `uuid` extended attribute accepts strings recognized by [CLSIDFromString](/windows/win32/api/combaseapi/nf-combaseapi-clsidfromstring), with or without brace delimiters. -The following sample generates C2778: +The following example generates C2778: ```cpp // C2778b.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2779.md b/docs/error-messages/compiler-errors-2/compiler-error-c2779.md index a5cceba3ae5..8e0b8797e1f 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2779.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2779.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2779" title: "Compiler Error C2779" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2779" +ms.date: 11/04/2016 f1_keywords: ["C2779"] helpviewer_keywords: ["C2779"] -ms.assetid: 4a00e492-855a-41f3-8a18-5f60ee20c2f2 --- # Compiler Error C2779 -'declaration' : property methods can only be associated with non-static data members +> 'declaration' : property methods can only be associated with non-static data members + +## Remarks The **`property`** extended attribute is incorrectly applied to a static data member. -The following sample generates C2779: +## Example + +The following example generates C2779: ```cpp // C2779.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2780.md b/docs/error-messages/compiler-errors-2/compiler-error-c2780.md index e1d639ffdf2..6c5c901d405 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2780.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2780.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2780" title: "Compiler Error C2780" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2780" +ms.date: 11/04/2016 f1_keywords: ["C2780"] helpviewer_keywords: ["C2780"] -ms.assetid: 423793d8-a3b2-4f35-85f8-ae1d043e2b69 --- # Compiler Error C2780 -'declaration' : expects N arguments - M provided +> 'declaration' : expects N arguments - M provided + +## Remarks A function template has too few or too many arguments. -The following sample generates C2780 and shows how to fix it: +## Example + +The following example generates C2780 and shows how to fix it: ```cpp // C2780.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2781.md b/docs/error-messages/compiler-errors-2/compiler-error-c2781.md index e7ac58ef5a7..8af20a38e2d 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2781.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2781.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2781" title: "Compiler Error C2781" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2781" +ms.date: 11/04/2016 f1_keywords: ["C2781"] helpviewer_keywords: ["C2781"] -ms.assetid: f29b9963-f55b-427c-8db6-50f37713df5a --- # Compiler Error C2781 -'declaration' : expects at least value1 argument - value2 provided +> 'declaration' : expects at least value1 argument - value2 provided + +## Remarks A function template with a variable parameter list has too few arguments. -The following sample generates C2781: +## Example + +The following example generates C2781: ```cpp // C2781.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2782.md b/docs/error-messages/compiler-errors-2/compiler-error-c2782.md index 0b253401473..1437c8068c4 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2782.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2782.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2782" title: "Compiler Error C2782" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2782" +ms.date: 11/04/2016 f1_keywords: ["C2782"] helpviewer_keywords: ["C2782"] -ms.assetid: 8b685422-294d-4f64-9f3d-c14eaf03a93d --- # Compiler Error C2782 -'declaration' : template parameter 'identifier' is ambiguous +> 'declaration' : template parameter 'identifier' is ambiguous + +## Remarks The compiler cannot determine the type of a template argument. -The following sample generates C2782: +## Examples + +The following example generates C2782: ```cpp // C2782.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2783.md b/docs/error-messages/compiler-errors-2/compiler-error-c2783.md index c44ff86dbb7..d906f0cd87f 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2783.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2783.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2783" title: "Compiler Error C2783" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2783" +ms.date: 11/04/2016 f1_keywords: ["C2783"] helpviewer_keywords: ["C2783"] -ms.assetid: 1ce94a11-bb8b-4be3-a222-f1f105da74b3 --- # Compiler Error C2783 -'declaration' : could not deduce template argument for 'identifier' +> 'declaration' : could not deduce template argument for 'identifier' + +## Remarks The compiler cannot determine a template argument. Default arguments cannot be used to deduce a template argument. -The following sample generates C2783: +## Examples + +The following example generates C2783: ```cpp // C2783.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2784.md b/docs/error-messages/compiler-errors-2/compiler-error-c2784.md index a8b82581e80..289c3733624 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2784.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2784.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2784" title: "Compiler Error C2784" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2784" +ms.date: 11/04/2016 f1_keywords: ["C2784"] helpviewer_keywords: ["C2784"] -ms.assetid: 3d761fe2-881c-48bd-afae-e2e714e20473 --- # Compiler Error C2784 -'declaration' : could not deduce template argument for 'type' from 'type' +> 'declaration' : could not deduce template argument for 'type' from 'type' + +## Remarks The compiler cannot determine a template argument from the supplied function arguments. -The following sample generates C2784 and shows how to fix it: +## Example + +The following example generates C2784 and shows how to fix it: ```cpp // C2784.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2785.md b/docs/error-messages/compiler-errors-2/compiler-error-c2785.md index db69f33c9fe..07589c43d27 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2785.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2785.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Error C2785" title: "Compiler Error C2785" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2785" +ms.date: 11/04/2016 f1_keywords: ["C2785"] helpviewer_keywords: ["C2785"] -ms.assetid: d8d13360-0d00-4815-8475-b49c7f0dc0f3 --- # Compiler Error C2785 -'declaration1' and 'declaration2' have different return types +> 'declaration1' and 'declaration2' have different return types + +## Remarks The return type of function template specialization differs from the return type of the primary function template. @@ -18,7 +19,7 @@ The return type of function template specialization differs from the return type ## Example -The following sample generates C2785: +The following example generates C2785: ```cpp // C2785.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2786.md b/docs/error-messages/compiler-errors-2/compiler-error-c2786.md index f8befff1ee9..3cdd52ad9a4 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2786.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2786.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Error C2786" title: "Compiler Error C2786" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2786" +ms.date: 11/04/2016 f1_keywords: ["C2786"] helpviewer_keywords: ["C2786"] -ms.assetid: 6676d8c0-86dd-4a39-bdda-b75a35f4d137 --- # Compiler Error C2786 -'type' : invalid operand for __uuidof +> 'type' : invalid operand for __uuidof + +## Remarks The [__uuidof](../../cpp/uuidof-operator.md) operator takes a user-defined type with a GUID attached or an object of such a user-defined type. Possible causes: @@ -16,7 +17,9 @@ The [__uuidof](../../cpp/uuidof-operator.md) operator takes a user-defined type 1. **`__uuidof`** cannot extract the GUID from the argument. -The following sample generates C2786: +## Example + +The following example generates C2786: ```cpp // C2786.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2787.md b/docs/error-messages/compiler-errors-2/compiler-error-c2787.md index f6e3c1e6f5b..e7e92cd8d32 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2787.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2787.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2787" title: "Compiler Error C2787" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2787" +ms.date: 11/04/2016 f1_keywords: ["C2787"] helpviewer_keywords: ["C2787"] -ms.assetid: 34cb57e6-cafe-4ce7-bcc6-53d194629bd0 --- # Compiler Error C2787 -'identifier' : no GUID has been associated with this object +> 'identifier' : no GUID has been associated with this object + +## Remarks The [__uuidof](../../cpp/uuidof-operator.md) operator takes a user-defined type with a GUID attached or an object of such a user-defined type. This error occurs when the argument is a user-defined type with no GUID. -The following sample generates C2787: +## Example + +The following example generates C2787: ```cpp // C2787.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2788.md b/docs/error-messages/compiler-errors-2/compiler-error-c2788.md index 688823ae549..f45b9117036 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2788.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2788.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2788" title: "Compiler Error C2788" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2788" +ms.date: 11/04/2016 f1_keywords: ["C2788"] helpviewer_keywords: ["C2788"] -ms.assetid: 8688fc5c-e652-43b4-b407-9c488c76f2db --- # Compiler Error C2788 -'identifier' : more than one GUID associated with this object +> 'identifier' : more than one GUID associated with this object + +## Remarks The [__uuidof](../../cpp/uuidof-operator.md) operator takes a user-defined type with a GUID attached or an object of such a user-defined type. This error occurs when the argument is an object with multiple GUIDs. -The following sample generates C2788: +## Example + +The following example generates C2788: ```cpp // C2788.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2790.md b/docs/error-messages/compiler-errors-2/compiler-error-c2790.md index 7fa8d57c9bf..bf32485d812 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2790.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2790.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2790" title: "Compiler Error C2790" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2790" +ms.date: 11/04/2016 f1_keywords: ["C2790"] helpviewer_keywords: ["C2790"] -ms.assetid: 38d4fce1-ba00-413d-8bc1-e8aa43d7bc1f --- # Compiler Error C2790 -'super' : this keyword can only be used within the body of class member function +> 'super' : this keyword can only be used within the body of class member function + +## Remarks This error message appears if the user ever tries to uses the keyword [super](../../cpp/super.md) outside of the context of a member function. -The following sample generates C2790: +## Example + +The following example generates C2790: ```cpp // C2790.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2791.md b/docs/error-messages/compiler-errors-2/compiler-error-c2791.md index 127353149a4..24de65980a5 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2791.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2791.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2791" title: "Compiler Error C2791" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2791" +ms.date: 11/04/2016 f1_keywords: ["C2791"] helpviewer_keywords: ["C2791"] -ms.assetid: 938ad1fb-75d9-4ce2-ad92-83d6249005b5 --- # Compiler Error C2791 -illegal use of 'super': 'class' does not have any base classes +> illegal use of 'super': 'class' does not have any base classes + +## Remarks The keyword [super](../../cpp/super.md) was used within the context of a member function of a class that does not have any base classes. -The following sample generates C2791: +## Example + +The following example generates C2791: ```cpp // C2791.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2792.md b/docs/error-messages/compiler-errors-2/compiler-error-c2792.md index 54f751a3118..5503da07a8e 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2792.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2792.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2792" title: "Compiler Error C2792" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2792" +ms.date: 11/04/2016 f1_keywords: ["C2792"] helpviewer_keywords: ["C2792"] -ms.assetid: 392cf748-4f5e-4e62-a364-3118d5658408 --- # Compiler Error C2792 -'super' : this keyword must be followed by '::' +> 'super' : this keyword must be followed by '::' + +## Remarks The only token that can follow the keyword **`__super`** is `::`. -The following sample generates C2792: +## Example + +The following example generates C2792: ```cpp // C2792.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2793.md b/docs/error-messages/compiler-errors-2/compiler-error-c2793.md index 6421099661f..3581467aef3 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2793.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2793.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2793" title: "Compiler Error C2793" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2793" +ms.date: 11/04/2016 f1_keywords: ["C2793"] helpviewer_keywords: ["C2793"] -ms.assetid: ce35f4e8-c357-40ca-95c4-15ff001ad69d --- # Compiler Error C2793 -'token' : unexpected token following '::', identifier or keyword 'operator' expected +> 'token' : unexpected token following '::', identifier or keyword 'operator' expected + +## Remarks The only tokens that can follow `__super::` are an identifier or the keyword **`operator`**. -The following sample generates C2793 +## Example + +The following example generates C2793 ```cpp // C2793.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2794.md b/docs/error-messages/compiler-errors-2/compiler-error-c2794.md index d9d8fbb45ff..72657858861 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2794.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2794.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2794" title: "Compiler Error C2794" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2794" +ms.date: 11/04/2016 f1_keywords: ["C2794"] helpviewer_keywords: ["C2794"] -ms.assetid: d508191c-9044-4c6a-9119-4bca668c0b93 --- # Compiler Error C2794 -'function' : is not a member of any direct or indirect base class of 'class' +> 'function' : is not a member of any direct or indirect base class of 'class' + +## Remarks You tried to use [super](../../cpp/super.md) to call a nonexistent member function. -The following sample generates C2794 +## Example + +The following example generates C2794 ```cpp // C2794.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2795.md b/docs/error-messages/compiler-errors-2/compiler-error-c2795.md index b9aaa67ad82..1505d3af111 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2795.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2795.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Compiler Error C2795" title: "Compiler Error C2795" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2795" +ms.date: 11/04/2016 f1_keywords: ["C2795"] helpviewer_keywords: ["C2795"] -ms.assetid: 8cd8c7fe-2add-4871-85f7-9a6afe4ac588 --- # Compiler Error C2795 -'super::function' is not a member function +> 'super::function' is not a member function + +## Remarks This error message appears whenever you try to use [super](../../cpp/super.md) to access a member other than a member function. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2797.md b/docs/error-messages/compiler-errors-2/compiler-error-c2797.md index 7dc731a466a..52e3d27661b 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2797.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2797.md @@ -1,20 +1,23 @@ --- -description: "Learn more about: Compiler Error C2797" title: "Compiler Error C2797" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2797" +ms.date: 11/04/2016 f1_keywords: ["C2797"] helpviewer_keywords: ["C2797"] -ms.assetid: 9fb26d35-eb5c-46fc-9ff5-756fba5bdaff --- # Compiler Error C2797 -(Obsolete) List initialization inside member initializer list or non-static data member initializer is not implemented. +> (Obsolete) List initialization inside member initializer list or non-static data member initializer is not implemented. + +## Remarks This warning is obsolete in Visual Studio 2015. In Visual Studio 2013 and earlier versions, the Microsoft C++ compiler does not implement list initialization inside either a member initializer list or a non-static data member initializer. Before Visual Studio 2013 Update 3, this was silently converted to a function call, which could lead to bad code generation. Visual Studio 2013 Update 3 reports this as an error. +## Examples + This example generates C2797: -``` +```cpp #include struct S { S() : v1{1} {} // C2797, VS2013 RTM incorrectly calls 'vector(size_type)' @@ -26,7 +29,7 @@ struct S { This example also generates C2797: -``` +```cpp struct S1 { int i; }; @@ -40,7 +43,7 @@ struct S2 { To fix this issue, you can use explicit construction of inner lists. For example: -``` +```cpp #include typedef std::vector Vector; struct S { @@ -53,7 +56,7 @@ struct S { If you do not require list initialization: -``` +```cpp struct S { S() : s1("") {} diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2798.md b/docs/error-messages/compiler-errors-2/compiler-error-c2798.md index 9bdca5513c9..5e5d7754190 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2798.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2798.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Error C2798" title: "Compiler Error C2798" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2798" +ms.date: 11/04/2016 f1_keywords: ["C2798"] helpviewer_keywords: ["C2798"] -ms.assetid: fb0cd861-b228-4f81-8090-e28344a727e0 --- # Compiler Error C2798 -'super::member' is ambiguous +> 'super::member' is ambiguous + +## Remarks Multiple inherited structures contain the member you referenced with [super](../../cpp/super.md). You could fix the error by either: @@ -16,7 +17,9 @@ Multiple inherited structures contain the member you referenced with [super](../ - Changing the name of the data member in B1 or B2. -The following sample generates C2798: +## Example + +The following example generates C2798: ```cpp // C2798.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2800.md b/docs/error-messages/compiler-errors-2/compiler-error-c2800.md index 31f8908e35f..7de01cf11dc 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2800.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2800.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2800" title: "Compiler Error C2800" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2800" +ms.date: 11/04/2016 f1_keywords: ["C2800"] helpviewer_keywords: ["C2800"] -ms.assetid: a2f1a590-9fe6-44cb-ad09-b4505ef47c6a --- # Compiler Error C2800 -'operator operator' cannot be overloaded +> 'operator operator' cannot be overloaded + +## Remarks The following operators cannot be overloaded: class member access (`.`), pointer to member (`.*`), scope resolution (`::`), conditional expression (`? :`), and **`sizeof`**. -The following sample generates C2800: +## Example + +The following example generates C2800: ```cpp // C2800.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2801.md b/docs/error-messages/compiler-errors-2/compiler-error-c2801.md index 072efc5bada..1fc1d35138c 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2801.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2801.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Error C2801" title: "Compiler Error C2801" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2801" +ms.date: 11/04/2016 f1_keywords: ["C2801"] helpviewer_keywords: ["C2801"] -ms.assetid: 35dfc7ea-9e37-4e30-baa1-944dc61302f5 --- # Compiler Error C2801 -'operator operator' must be a non-static member +> 'operator operator' must be a non-static member + +## Remarks The following operators can be overloaded only as nonstatic members: @@ -26,7 +27,9 @@ Possible C2801 causes: - Overloaded operator is declared **`static`**. -- The following sample generates C2801: +## Example + +- The following example generates C2801: ```cpp // C2801.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2802.md b/docs/error-messages/compiler-errors-2/compiler-error-c2802.md index 6213cbba277..d7920ab5bd3 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2802.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2802.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2802" title: "Compiler Error C2802" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2802" +ms.date: 11/04/2016 f1_keywords: ["C2802"] helpviewer_keywords: ["C2802"] -ms.assetid: 08b68c0e-9382-40ac-8949-39a7a2749e05 --- # Compiler Error C2802 -static member 'operator operator' has no formal parameters +> static member 'operator operator' has no formal parameters + +## Remarks An operator declared by a **`static`** member function must have at least one parameter. -The following sample generates C2802: +## Example + +The following example generates C2802: ```cpp // C2802.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2803.md b/docs/error-messages/compiler-errors-2/compiler-error-c2803.md index d3b3c841e34..56585a0492d 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2803.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2803.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Error C2803" title: "Compiler Error C2803" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2803" +ms.date: 11/04/2016 f1_keywords: ["C2803"] helpviewer_keywords: ["C2803"] -ms.assetid: 2cdbe374-8cc4-4c4e-ba15-062a7479e937 --- # Compiler Error C2803 -'operator operator' must have at least one formal parameter of class type +> 'operator operator' must have at least one formal parameter of class type + +## Remarks The overloaded operator lacks a parameter of class type. @@ -16,7 +17,9 @@ You need to pass at least one parameter by reference (not using pointers, but re If both parameters are pointers it will be a pure comparison of pointer addresses and will not use the user-defined conversion. -The following sample generates C2803: +## Example + +The following example generates C2803: ```cpp // C2803.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2804.md b/docs/error-messages/compiler-errors-2/compiler-error-c2804.md index 1ca73c5ca65..6837c7650c2 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2804.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2804.md @@ -1,20 +1,21 @@ --- -description: "Learn more about: Compiler Error C2804" title: "Compiler Error C2804" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2804" +ms.date: 11/04/2016 f1_keywords: ["C2804"] helpviewer_keywords: ["C2804"] -ms.assetid: b066e563-cca4-450c-8ba7-3b0d7a89f3ea --- # Compiler Error C2804 -binary 'operator operator' has too many parameters +> binary 'operator operator' has too many parameters + +## Remarks The overloaded binary operator member function is declared with more than one parameter. The first operand parameter of a binary operator member function, whose type is the operator's enclosing type, is implied. ## Examples -The following sample generates C2804 and shows how to fix it. +The following example generates C2804 and shows how to fix it. ```cpp // C2804.cpp @@ -31,7 +32,7 @@ int main() { } ``` -The following sample generates C2804 and shows how to fix it. +The following example generates C2804 and shows how to fix it. ```cpp // C2804_2.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2805.md b/docs/error-messages/compiler-errors-2/compiler-error-c2805.md index 69a25b9734a..219a8c8d65b 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2805.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2805.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2805" title: "Compiler Error C2805" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2805" +ms.date: 11/04/2016 f1_keywords: ["C2805"] helpviewer_keywords: ["C2805"] -ms.assetid: c997dc56-e199-442f-b94e-ac551ec9b015 --- # Compiler Error C2805 -binary 'operator operator' has too few parameters +> binary 'operator operator' has too few parameters + +## Remarks The binary operator has no parameters. -The following sample generates C2805: +## Example + +The following example generates C2805: ```cpp // C2805.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2806.md b/docs/error-messages/compiler-errors-2/compiler-error-c2806.md index a1efc1388d3..84ff0db1dfa 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2806.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2806.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2806" title: "Compiler Error C2806" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2806" +ms.date: 11/04/2016 f1_keywords: ["C2806"] helpviewer_keywords: ["C2806"] -ms.assetid: 7c9ff1f4-1590-4c47-991d-b1075a173b48 --- # Compiler Error C2806 -'operator operator' has too many formal parameters +> 'operator operator' has too many formal parameters + +## Remarks An overloaded operator has too many parameters. -The following sample generates C2806: +## Example + +The following example generates C2806: ```cpp // C2806.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2807.md b/docs/error-messages/compiler-errors-2/compiler-error-c2807.md index 1eb9f971c86..eda69103326 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2807.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2807.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2807" title: "Compiler Error C2807" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2807" +ms.date: 11/04/2016 f1_keywords: ["C2807"] helpviewer_keywords: ["C2807"] -ms.assetid: bd7a207a-f379-4de6-8ee8-c7cab78b3480 --- # Compiler Error C2807 -the second formal parameter to postfix 'operator operator' must be 'int' +> the second formal parameter to postfix 'operator operator' must be 'int' + +## Remarks The second parameter to a postfix operator has the wrong type. -The following sample generates C2807: +## Example + +The following example generates C2807: ```cpp // C2807.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2808.md b/docs/error-messages/compiler-errors-2/compiler-error-c2808.md index 438adafd4a0..7a2df195342 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2808.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2808.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2808" title: "Compiler Error C2808" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2808" +ms.date: 11/04/2016 f1_keywords: ["C2808"] helpviewer_keywords: ["C2808"] -ms.assetid: 3d745102-d3b3-4735-a7d2-ad42d5bf3cfa --- # Compiler Error C2808 -unary 'operator operator' has too many formal parameters +> unary 'operator operator' has too many formal parameters + +## Remarks The unary operator has a nonvoid parameter list. -The following sample generates C2808: +## Example + +The following example generates C2808: ```cpp // C2808.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2809.md b/docs/error-messages/compiler-errors-2/compiler-error-c2809.md index 48d236e3e85..e99316b66eb 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2809.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2809.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2809" title: "Compiler Error C2809" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2809" +ms.date: 11/04/2016 f1_keywords: ["C2809"] helpviewer_keywords: ["C2809"] -ms.assetid: ce796b8e-1a8c-4074-995d-1ad09afd0e93 --- # Compiler Error C2809 -'operator operator' has no formal parameters +> 'operator operator' has no formal parameters + +## Remarks The operator lacks required parameters. -The following sample generates C2809: +## Example + +The following example generates C2809: ```cpp // C2809.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2810.md b/docs/error-messages/compiler-errors-2/compiler-error-c2810.md index 43de6906e30..822e5b9de74 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2810.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2810.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2810" title: "Compiler Error C2810" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2810" +ms.date: 11/04/2016 f1_keywords: ["C2810"] helpviewer_keywords: ["C2810"] -ms.assetid: f63e8f24-d7f6-42ac-904f-72ff49592ba6 --- # Compiler Error C2810 -'interface' : an interface can only inherit from another interface +> 'interface' : an interface can only inherit from another interface + +## Remarks An [interface](../../cpp/interface.md) may only inherit from another interface and may not inherit from a class or struct. -The following sample generates C2810: +## Example + +The following example generates C2810: ```cpp // C2810.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2811.md b/docs/error-messages/compiler-errors-2/compiler-error-c2811.md index 4f36772c6c5..e10b1d0ebea 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2811.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2811.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2811" title: "Compiler Error C2811" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2811" +ms.date: 11/04/2016 f1_keywords: ["C2811"] helpviewer_keywords: ["C2811"] -ms.assetid: 6a44b18e-44c1-49d8-9b99-e0545b9a6e7d --- # Compiler Error C2811 -'type1' : cannot inherit from 'type2', a ref class can only inherit from a ref class or interface class +> 'type1' : cannot inherit from 'type2', a ref class can only inherit from a ref class or interface class + +## Remarks You attempted to use an unmanaged class as a base class for a managed class. -The following sample generates C2811: +## Example + +The following example generates C2811: ```cpp // C2811.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2812.md b/docs/error-messages/compiler-errors-2/compiler-error-c2812.md index 5b4483c3476..247df73f444 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2812.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2812.md @@ -1,14 +1,13 @@ --- -description: "Learn more about: Compiler Error C2812" title: "Compiler Error C2812" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2812" +ms.date: 11/04/2016 f1_keywords: ["C2812"] helpviewer_keywords: ["C2812"] -ms.assetid: 22aadb8c-7232-489d-a3ad-60662dda30a8 --- # Compiler Error C2812 -> \#import is not supported with /clr:pure and /clr:safe +> #import is not supported with /clr:pure and /clr:safe ## Remarks @@ -18,7 +17,7 @@ The **/clr:pure** and **/clr:safe** compiler options are deprecated in Visual St ## Example -The following sample generates C2812. +The following example generates C2812. ```cpp // C2812.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2813.md b/docs/error-messages/compiler-errors-2/compiler-error-c2813.md index a9ae15d2023..d2c6623c52b 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2813.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2813.md @@ -1,22 +1,23 @@ --- -description: "Learn more about: Compiler Error C2813" title: "Compiler Error C2813" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2813" +ms.date: 11/04/2016 f1_keywords: ["C2813"] helpviewer_keywords: ["C2813"] -ms.assetid: 6cf2135f-7b82-42d1-909a-5e864308a09c --- # Compiler Error C2813 -\#import is not supported with /MP +> #import is not supported with /MP + +## Remarks -C2813 is emitted if in a compiler command you specify the **/MP** compiler option and two or more files to compile, and one or more of the files contains the[#import](../../preprocessor/hash-import-directive-cpp.md) preprocessor directive. The [#import](../../preprocessor/hash-import-directive-cpp.md) directive generates C++ classes from the types in the specified type library, and then writes those classes to two header files. The [#import](../../preprocessor/hash-import-directive-cpp.md) directive is not supported because if multiple compilation units import the same type library, those units conflict when they try to write the same header files at the same time. +C2813 is emitted if in a compiler command you specify the **/MP** compiler option and two or more files to compile, and one or more of the files contains the [#import](../../preprocessor/hash-import-directive-cpp.md) preprocessor directive. The [#import](../../preprocessor/hash-import-directive-cpp.md) directive generates C++ classes from the types in the specified type library, and then writes those classes to two header files. The [#import](../../preprocessor/hash-import-directive-cpp.md) directive is not supported because if multiple compilation units import the same type library, those units conflict when they try to write the same header files at the same time. This compiler error and the **/MP** compiler option are new in Visual Studio 2008. ## Example -The following sample generates C2813. The command line in the "compile with:" comment indicates to the compiler to use the **/MP** and **/c** compiler options to compile several files. At least one of the files contains the [#import](../../preprocessor/hash-import-directive-cpp.md) directive. We use the same file twice for the sake of testing this example. +The following example generates C2813. The command line in the "compile with:" comment indicates to the compiler to use the **/MP** and **/c** compiler options to compile several files. At least one of the files contains the [#import](../../preprocessor/hash-import-directive-cpp.md) directive. We use the same file twice for the sake of testing this example. ```cpp // C2813.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2814.md b/docs/error-messages/compiler-errors-2/compiler-error-c2814.md index 3c5b827f798..a34fc692a4f 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2814.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2814.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2814" title: "Compiler Error C2814" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2814" +ms.date: 11/04/2016 f1_keywords: ["C2814"] helpviewer_keywords: ["C2814"] -ms.assetid: 7d165136-a08b-4497-a76d-60a21bb19404 --- # Compiler Error C2814 -'member' : a native type cannot be nested within a managed or WinRT type 'type' +> 'member' : a native type cannot be nested within a managed or WinRT type 'type' + +## Remarks + +A native type cannot be nested in a CLR or WinRT type. ## Example -A native type cannot be nested in a CLR or WinRT type. The following sample generates C2814 and shows how to fix it. +The following example generates C2814 and shows how to fix it. ```cpp // C2814.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2815.md b/docs/error-messages/compiler-errors-2/compiler-error-c2815.md index 8c0711ede95..d4e855253e4 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2815.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2815.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2815" title: "Compiler Error C2815" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2815" +ms.date: 11/04/2016 f1_keywords: ["C2815"] helpviewer_keywords: ["C2815"] -ms.assetid: d0256fd6-0721-4c99-b03c-52d96e77a613 --- # Compiler Error C2815 -'operator delete' : first formal parameter must be 'void *', but 'param' was used +> 'operator delete' : first formal parameter must be 'void *', but 'param' was used + +## Remarks Any user-defined [operator delete](../../standard-library/new-operators.md#op_delete) function must take a first formal parameter of type `void *`. -The following sample generates C2815: +## Example + +The following example generates C2815: ```cpp // C2815.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2817.md b/docs/error-messages/compiler-errors-2/compiler-error-c2817.md index b437cf9ca4e..24c59040cf3 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2817.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2817.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Compiler Error C2817" title: "Compiler Error C2817" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2817" +ms.date: 11/04/2016 f1_keywords: ["C2817"] helpviewer_keywords: ["C2817"] -ms.assetid: bca2e55a-8d86-4ddf-ba2b-4568f3bb776e --- # Compiler Error C2817 -return type for 'operator delete' must be 'void' +> return type for 'operator delete' must be 'void' + +## Remarks An overloaded [operator delete](../../standard-library/new-operators.md#op_delete) function cannot return a value. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2818.md b/docs/error-messages/compiler-errors-2/compiler-error-c2818.md index 9ca58a16377..88373838771 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2818.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2818.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Compiler Error C2818" title: "Compiler Error C2818" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2818" +ms.date: 11/04/2016 f1_keywords: ["C2818"] helpviewer_keywords: ["C2818"] -ms.assetid: 715fc7c9-0c6d-452b-b7f5-1682cea5e907 --- # Compiler Error C2818 -application of overloaded 'operator ->' is recursive through type 'type' +> application of overloaded 'operator ->' is recursive through type 'type' + +## Remarks A redefinition of the class member access operator contains a recursive **`return`** statement. To redefine the `->` operator with recursion, you must move the recursive routine to a separate function called from the operator override function. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2819.md b/docs/error-messages/compiler-errors-2/compiler-error-c2819.md index 7021fec040b..063bf1c863a 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2819.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2819.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2819" title: "Compiler Error C2819" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2819" +ms.date: 11/04/2016 f1_keywords: ["C2819"] helpviewer_keywords: ["C2819"] -ms.assetid: fcc7762d-cb82-4bb1-a715-0d82da832edf --- # Compiler Error C2819 -type 'type' does not have an overloaded member 'operator ->' +> type 'type' does not have an overloaded member 'operator ->' + +## Remarks You need to define `operator->()` to use this pointer operation. -The following sample generates C2819: +## Examples + +The following example generates C2819: ```cpp // C2819.cpp @@ -42,7 +45,7 @@ void F(D j) { } ``` -C2819 can also occur when using [C++ Stack Semantics for Reference Types](../../dotnet/cpp-stack-semantics-for-reference-types.md). The following sample generates C2819: +C2819 can also occur when using [C++ Stack Semantics for Reference Types](../../dotnet/cpp-stack-semantics-for-reference-types.md). The following example generates C2819: ```cpp // C2819_b.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2821.md b/docs/error-messages/compiler-errors-2/compiler-error-c2821.md index d187c402136..aff747245de 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2821.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2821.md @@ -1,20 +1,21 @@ --- -description: "Learn more about: Compiler Error C2821" title: "Compiler Error C2821" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2821" +ms.date: 11/04/2016 f1_keywords: ["C2821"] helpviewer_keywords: ["C2821"] -ms.assetid: e8d71988-a968-4484-94db-e8c3bad74a4a --- # Compiler Error C2821 -first formal parameter to 'operator new' must be 'unsigned int' +> first formal parameter to 'operator new' must be 'unsigned int' + +## Remarks The first formal parameter of the [operator new](../../standard-library/new-operators.md#op_new) must be an unsigned **`int`**. ## Example -The following sample generates C2821: +The following example generates C2821: ```cpp // C2821.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2823.md b/docs/error-messages/compiler-errors-2/compiler-error-c2823.md index acdfe09f032..461936a5360 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2823.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2823.md @@ -1,20 +1,21 @@ --- -description: "Learn more about: Compiler Error C2823" title: "Compiler Error C2823" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2823" +ms.date: 11/04/2016 f1_keywords: ["C2823"] helpviewer_keywords: ["C2823"] -ms.assetid: 982b1b35-1a7c-456e-b711-f80cfe2d571e --- # Compiler Error C2823 > a typedef template is illegal +## Remarks + Templates are not allowed in **`typedef`** definitions. ## Example -The following sample generates C2823, and shows one way to fix it: +The following example generates C2823, and shows one way to fix it: ```cpp // C2823.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2824.md b/docs/error-messages/compiler-errors-2/compiler-error-c2824.md index 2178beb0a79..f314fdc5d08 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2824.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2824.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2824" title: "Compiler Error C2824" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2824" +ms.date: 11/04/2016 f1_keywords: ["C2824"] helpviewer_keywords: ["C2824"] -ms.assetid: 5bd865f7-e0af-404e-80fe-e2b798b44a59 --- # Compiler Error C2824 -return type for 'operator new' must be 'void *' +> return type for 'operator new' must be 'void *' + +## Remarks With non-based pointers, overloads of operator `new` must return `void *`. -The following sample generates C2824: +## Example + +The following example generates C2824: ```cpp // C2824.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2825.md b/docs/error-messages/compiler-errors-2/compiler-error-c2825.md index fc7b5f733e7..451592c6a90 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2825.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2825.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Error C2825" title: "Compiler Error C2825" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2825" +ms.date: 11/04/2016 f1_keywords: ["C2825"] helpviewer_keywords: ["C2825"] -ms.assetid: c832f1c1-5184-4fc2-9356-12b21daa7af3 --- # Compiler Error C2825 -var : must be a class or namespace when followed by '::' +> var : must be a class or namespace when followed by '::' + +## Remarks An unsuccessful attempt was made to form a qualified name. @@ -16,7 +17,7 @@ For example, make sure that your code does not contain a function declaration wh ## Example -The following sample generates C2825: +The following example generates C2825: ```cpp // C2825.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2827.md b/docs/error-messages/compiler-errors-2/compiler-error-c2827.md index fe90f7e62bf..77edf9d6175 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2827.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2827.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Error C2827" title: "Compiler Error C2827" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2827" +ms.date: 11/04/2016 f1_keywords: ["C2827"] helpviewer_keywords: ["C2827"] -ms.assetid: cb3e5814-0c92-40e4-b620-98578ae3003a --- # Compiler Error C2827 -'operator operator' cannot be globally overridden with unary form +> 'operator operator' cannot be globally overridden with unary form + +## Remarks The operator cannot have a unary form outside of an object. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2828.md b/docs/error-messages/compiler-errors-2/compiler-error-c2828.md index 0273a717134..3a2f05f16f2 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2828.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2828.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Error C2828" title: "Compiler Error C2828" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2828" +ms.date: 11/04/2016 f1_keywords: ["C2828"] helpviewer_keywords: ["C2828"] -ms.assetid: d8df6ed4-5954-46c2-b59b-52881d4e923d --- # Compiler Error C2828 -'operator operator' cannot be globally overridden with binary form +> 'operator operator' cannot be globally overridden with binary form + +## Remarks The operator cannot have a binary form outside of an object. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2829.md b/docs/error-messages/compiler-errors-2/compiler-error-c2829.md index 137d653a228..785f6ffbe62 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2829.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2829.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Error C2829" title: "Compiler Error C2829" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2829" +ms.date: 11/04/2016 f1_keywords: ["C2829"] helpviewer_keywords: ["C2829"] -ms.assetid: b3bfecb8-c8c1-45fd-bb85-4b42a6b8ed2b --- # Compiler Error C2829 -'operator operator' cannot have a variable parameter list +> 'operator operator' cannot have a variable parameter list + +## Remarks Only two operators can take variable parameter lists: diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2830.md b/docs/error-messages/compiler-errors-2/compiler-error-c2830.md index 6141a2a5023..44f5c71e35d 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2830.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2830.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Compiler Error C2830" title: "Compiler Error C2830" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2830" +ms.date: 11/04/2016 f1_keywords: ["C2830"] helpviewer_keywords: ["C2830"] -ms.assetid: 91607d2d-6aab-4c1b-b253-a7b8ec37760e --- # Compiler Error C2830 -only placement parameters to 'operator new' can have default values +> only placement parameters to 'operator new' can have default values + +## Remarks The standard formal parameters for [operator new](../../standard-library/new-operators.md#op_new) cannot have default values. Only user-defined placement parameters can specify defaults. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2831.md b/docs/error-messages/compiler-errors-2/compiler-error-c2831.md index 9512ca8f412..bc27fed8ecd 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2831.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2831.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Error C2831" title: "Compiler Error C2831" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2831" +ms.date: 11/04/2016 f1_keywords: ["C2831"] helpviewer_keywords: ["C2831"] -ms.assetid: c8c04288-0889-4265-a077-17f94cbcdcc9 --- # Compiler Error C2831 -'operator operator' cannot have default parameters +> 'operator operator' cannot have default parameters + +## Remarks Only three operators can have default parameters: @@ -18,7 +19,9 @@ Only three operators can have default parameters: - Left parenthesis ( -The following sample generates C2831: +## Example + +The following example generates C2831: ```cpp // C2831.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2833.md b/docs/error-messages/compiler-errors-2/compiler-error-c2833.md index 84e1e48a152..db4f336ded0 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2833.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2833.md @@ -1,20 +1,23 @@ --- -description: "Learn more about: Compiler Error C2833" title: "Compiler Error C2833" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2833" +ms.date: 11/04/2016 f1_keywords: ["C2833"] helpviewer_keywords: ["C2833"] -ms.assetid: b9418ce1-e2ee-4599-8959-6fde89c27569 --- # Compiler Error C2833 > 'operator *operator-name*' is not a recognized operator or type +## Remarks + The word **`operator`** must be followed by an *operator-name* that you want to override or a type you want to convert. For a list of the operators that you can define in a managed type, see [User-defined Operators](../../dotnet/user-defined-operators-cpp-cli.md). -The following sample generates C2833: +## Example + +The following example generates C2833: ```cpp // C2833.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2834.md b/docs/error-messages/compiler-errors-2/compiler-error-c2834.md index 716e1c7e5a9..32d04c4ef42 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2834.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2834.md @@ -1,15 +1,16 @@ --- -description: "Learn more about: Compiler Error C2834" title: "Compiler Error C2834" +description: "Learn more about: Compiler Error C2834" ms.date: 06/01/2022 f1_keywords: ["C2834"] helpviewer_keywords: ["C2834"] -ms.assetid: 28f9f6eb-ab2a-4e64-aaaa-9d14f955de41 --- # Compiler Error C2834 > 'operator *operator-name*' must be globally qualified +## Remarks + The `new` and `delete` operators are tied to the class where they reside. Scope resolution cannot be used to select a version of `new` or `delete` from a different class. To implement multiple forms of the `new` or `delete` operator, create a version of the operator with extra formal parameters. This error is obsolete in Visual Studio 2022 and later versions. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2835.md b/docs/error-messages/compiler-errors-2/compiler-error-c2835.md index 4dbcb7c9d5a..5492c49de67 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2835.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2835.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2835" title: "Compiler Error C2835" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2835" +ms.date: 11/04/2016 f1_keywords: ["C2835"] helpviewer_keywords: ["C2835"] -ms.assetid: 41c70630-983f-4da2-8342-513cf48b0519 --- # Compiler Error C2835 -user-defined conversion 'type' takes no formal parameters +> user-defined conversion 'type' takes no formal parameters + +## Remarks User-defined type conversions cannot take formal parameters. -The following sample generates C2835: +## Example + +The following example generates C2835: ```cpp // C2835.cpp @@ -22,12 +25,12 @@ public: A() { v_char = 'A'; - }; + } operator char(char a) { // C2835 // try the following line instead // operator char() { return v_char + 1; - }; + } }; int main() { diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2838.md b/docs/error-messages/compiler-errors-2/compiler-error-c2838.md index 5667a087511..d25d68cdfc3 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2838.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2838.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2838" title: "Compiler Error C2838" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2838" +ms.date: 11/04/2016 f1_keywords: ["C2838"] helpviewer_keywords: ["C2838"] -ms.assetid: 176b2ad6-7a84-4019-b97e-328866054457 --- # Compiler Error C2838 -'member' : illegal qualified name in member declaration +> 'member' : illegal qualified name in member declaration + +## Remarks A class, structure, or union uses a fully qualified name to redeclare a member of another class, structure, or union. -The following sample generates C2838: +## Example + +The following example generates C2838: ```cpp // C2838.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2839.md b/docs/error-messages/compiler-errors-2/compiler-error-c2839.md index f7480b7bc45..94fe1998ec3 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2839.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2839.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Compiler Error C2839" title: "Compiler Error C2839" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2839" +ms.date: 11/04/2016 f1_keywords: ["C2839"] helpviewer_keywords: ["C2839"] -ms.assetid: e4914def-2ee1-4e2e-8951-d35f9515c2b2 --- # Compiler Error C2839 -invalid return type 'type' for overloaded 'operator ->' +> invalid return type 'type' for overloaded 'operator ->' + +## Remarks The `->` operator must return a class, struct, or union, or a reference to one. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2842.md b/docs/error-messages/compiler-errors-2/compiler-error-c2842.md index 62762894e97..b31737736aa 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2842.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2842.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2842" title: "Compiler Error C2842" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2842" +ms.date: 11/04/2016 f1_keywords: ["C2842"] helpviewer_keywords: ["C2842"] -ms.assetid: 8674f08d-9f50-46ad-9229-abc6b74fa0e5 --- # Compiler Error C2842 @@ -18,7 +17,7 @@ For more information, see [User-Defined Operators (C++/CLI)](../../dotnet/user-d ## Example -The following sample generates C2842. +The following example generates C2842. ```cpp // C2842.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2843.md b/docs/error-messages/compiler-errors-2/compiler-error-c2843.md index 14b5171ffa2..87266f66be2 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2843.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2843.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2843" title: "Compiler Error C2843" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2843" +ms.date: 11/04/2016 f1_keywords: ["C2843"] helpviewer_keywords: ["C2843"] -ms.assetid: 9d3f2ac4-eea5-4fed-abeb-e752f442bfcc --- # Compiler Error C2843 -'member' : cannot take the address of a non-static data member or method of a managed or WinRT type +> 'member' : cannot take the address of a non-static data member or method of a managed or WinRT type + +## Remarks An instance is needed to take the address of nonstatic data members of a managed or WinRT class or interface. -The following sample generates C2843 and shows how to fix it: +## Example + +The following example generates C2843 and shows how to fix it: ```cpp // C2843_2.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2844.md b/docs/error-messages/compiler-errors-2/compiler-error-c2844.md index 5fd3a703db6..4560e90ad50 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2844.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2844.md @@ -1,20 +1,23 @@ --- -description: "Learn more about: Compiler Error C2844" title: "Compiler Error C2844" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2844" +ms.date: 11/04/2016 f1_keywords: ["C2844"] helpviewer_keywords: ["C2844"] -ms.assetid: dcaf4cd2-21b0-4280-ae42-0a706c524d83 --- # Compiler Error C2844 -'member' : cannot be a member of interface 'interface' +> 'member' : cannot be a member of interface 'interface' + +## Remarks An [interface class](../../extensions/interface-class-cpp-component-extensions.md) cannot contain a data member unless it is also a property. Anything other than a property or member function is not allowed in an interface. Furthermore, constructors, destructors, and operators are not allowed. -The following sample generates C2844: +## Example + +The following example generates C2844: ```cpp // C2844a.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2845.md b/docs/error-messages/compiler-errors-2/compiler-error-c2845.md index 16511963892..772b3afbfc4 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2845.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2845.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Compiler Error C2845" title: "Compiler Error C2845" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2845" +ms.date: 11/04/2016 f1_keywords: ["C2845"] helpviewer_keywords: ["C2845"] -ms.assetid: 31b28ee9-978f-403b-94d8-dbaacd24cce0 --- # Compiler Error C2845 -'operator' : pointer arithmetic not allowed on this type +> 'operator' : pointer arithmetic not allowed on this type + +## Remarks You cannot increment the pointer to a managed class. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2846.md b/docs/error-messages/compiler-errors-2/compiler-error-c2846.md index a33ecf9a560..a7e56fc19f6 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2846.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2846.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2846" title: "Compiler Error C2846" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2846" +ms.date: 11/04/2016 f1_keywords: ["C2846"] helpviewer_keywords: ["C2846"] -ms.assetid: bc090ec2-5410-4112-9ec6-261325374375 --- # Compiler Error C2846 -'constructor' : an interface cannot have a constructor +> 'constructor' : an interface cannot have a constructor + +## Remarks A Visual C++ [interface](../../cpp/interface.md) cannot have a constructor. -The following sample generates C2846: +## Example + +The following example generates C2846: ```cpp // C2846.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2847.md b/docs/error-messages/compiler-errors-2/compiler-error-c2847.md index ef48d9496b8..93cc7ebfb76 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2847.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2847.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2847" title: "Compiler Error C2847" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2847" +ms.date: 11/04/2016 f1_keywords: ["C2847"] helpviewer_keywords: ["C2847"] -ms.assetid: 9ad9a0e0-8b16-49d9-a5be-f8eda2372aa9 --- # Compiler Error C2847 -cannot apply sizeof to managed or WinRT type 'class' +> cannot apply sizeof to managed or WinRT type 'class' + +## Remarks The [sizeof](../../cpp/sizeof-operator.md) operator gets the value of an object at compile time. The size of a managed or WinRT class, interface, or value type is dynamic and so cannot be known at compile time. -For example, the following sample generates C2847: +## Example + +For example, the following example generates C2847: ```cpp // C2847.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2849.md b/docs/error-messages/compiler-errors-2/compiler-error-c2849.md index 529a6699481..4b2afd8008a 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2849.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2849.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2849" title: "Compiler Error C2849" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2849" +ms.date: 11/04/2016 f1_keywords: ["C2849"] helpviewer_keywords: ["C2849"] -ms.assetid: e28f6b3e-e0e7-4f92-b006-ebaa81d368e6 --- # Compiler Error C2849 -'destructor' : an interface cannot have a destructor +> 'destructor' : an interface cannot have a destructor + +## Remarks A Visual C++ [interface](../../cpp/interface.md) cannot have a destructor. -The following sample generates C2849: +## Example + +The following example generates C2849: ```cpp // C2849.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2850.md b/docs/error-messages/compiler-errors-2/compiler-error-c2850.md index 86e1d28646f..a5720a6a0bb 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2850.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2850.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2850" title: "Compiler Error C2850" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2850" +ms.date: 11/04/2016 f1_keywords: ["C2850"] helpviewer_keywords: ["C2850"] -ms.assetid: f3efe86c-4168-4e76-a133-3f8314c69f51 --- # Compiler Error C2850 -'construct' : only allowed at file scope; may not be in a nested construct +> 'construct' : only allowed at file scope; may not be in a nested construct + +## Remarks Constructs, such as some pragmas, can only appear at global scope. -The following sample generates C2850: +## Example + +The following example generates C2850: ```cpp // C2850.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2854.md b/docs/error-messages/compiler-errors-2/compiler-error-c2854.md index f4c3ab89deb..881fa57914a 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2854.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2854.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2854" title: "Compiler Error C2854" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2854" +ms.date: 11/04/2016 f1_keywords: ["C2854"] helpviewer_keywords: ["C2854"] -ms.assetid: 917fec9c-790a-4149-8dfc-00d17a09199c --- # Compiler Error C2854 -syntax error in #pragma hdrstop +> syntax error in #pragma hdrstop + +## Remarks The `#pragma hdrstop` gives an invalid filename. The pragma can be followed by an optional filename in parentheses and quotation marks: -The following sample generates C2854: +## Example + +The following example generates C2854: ```cpp // C2854.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2855.md b/docs/error-messages/compiler-errors-2/compiler-error-c2855.md index c67e56ab236..03760f6647a 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2855.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2855.md @@ -1,6 +1,6 @@ --- -description: "Learn more about: Compiler Error C2855" title: "Compiler Error C2855" +description: "Learn more about: Compiler Error C2855" ms.date: 02/16/2021 f1_keywords: ["C2855"] helpviewer_keywords: ["C2855"] @@ -9,10 +9,10 @@ helpviewer_keywords: ["C2855"] > command-line option '*option*' inconsistent with precompiled header -This error occurs when a command-line option differs from the options used to create the precompiled header. - ## Remarks +This error occurs when a command-line option differs from the options used to create the precompiled header. + Error C2855 can occur when you make an incremental build after changing a compiler option. It can also happen if you set specific compiler options for individual source files. To resolve this error, regenerate the precompiled header by using the specified command-line option. To regenerate the precompiled header, build the associated source file. For example, projects created by a Visual Studio template usually create a source file named *`pch.cpp`* to generate the precompiled header. (In older versions of Visual Studio, this file is named *`stdafx.cpp`*.) In other projects, the source file to rebuild is the one built by using the [`/Yc` (Create precompiled header file)](../../build/reference/yc-create-precompiled-header-file.md) compiler option. We recommend you rebuild your entire project after making a change to the precompiled header. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2856.md b/docs/error-messages/compiler-errors-2/compiler-error-c2856.md index 900d8c6d6a8..1a6f8ec7dd4 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2856.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2856.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Error C2856" title: "Compiler Error C2856" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2856" +ms.date: 11/04/2016 f1_keywords: ["C2856"] helpviewer_keywords: ["C2856"] -ms.assetid: fe616c51-124e-49e3-9dd8-883ec1660680 --- # Compiler Error C2856 -\#pragma hdrstop cannot be inside an #if block +> #pragma hdrstop cannot be inside an #if block + +## Remarks The `hdrstop` pragma cannot be placed inside the body of a conditional compilation block. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2857.md b/docs/error-messages/compiler-errors-2/compiler-error-c2857.md index 8b8572462b6..f81d9f06527 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2857.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2857.md @@ -1,26 +1,25 @@ --- -description: "Learn more about: Compiler Error C2857" title: "Compiler Error C2857" -ms.date: "09/13/2018" +description: "Learn more about: Compiler Error C2857" +ms.date: 09/13/2018 f1_keywords: ["C2857"] helpviewer_keywords: ["C2857"] -ms.assetid: b57302bd-58ec-45ae-992a-1e282d5eeccc --- # Compiler Error C2857 > '#include' statement specified with the /Yc*filename* command-line option was not found in the source file -The [/Yc](../../build/reference/yc-create-precompiled-header-file.md) option specifies the name of an include file that is not included in the source file being compiled. - ## Remarks +The [/Yc](../../build/reference/yc-create-precompiled-header-file.md) option specifies the name of an include file that is not included in the source file being compiled. + When you use the **/Yc**filename option on a source file to create a precompiled header (PCH) file, that source file must include the *filename* header file. Every file included by the source file, up to and including the specified *filename*, is included in the PCH file. In other source files compiled by using the **/Yu**filename option to use the PCH file, an include of *filename* must be the first non-comment line in the file. The compiler ignores anything in the source file before this include. This error can be caused by an `#include "filename"` statement in a conditional compilation block that is not compiled in your PCH source file. ## Example -In typical usage, one source file in your project is designated as the PCH source file, and one header file is used as the PCH header file. A typical PCH header file has all of the library headers used in your project, but not local headers that are still under development. In this sample, the PCH header file is named *my_pch.h*. +In typical usage, one source file in your project is designated as the PCH source file, and one header file is used as the PCH header file. A typical PCH header file has all of the library headers used in your project, but not local headers that are still under development. In this example, the PCH header file is named *my_pch.h*. ```cpp // my_pch.h diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2858.md b/docs/error-messages/compiler-errors-2/compiler-error-c2858.md index 5c73c903ae3..5779b92df96 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2858.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2858.md @@ -1,15 +1,16 @@ --- -description: "Learn more about: Compiler Error C2858" title: "Compiler Error C2858" +description: "Learn more about: Compiler Error C2858" ms.date: 06/01/2022 f1_keywords: ["C2858"] helpviewer_keywords: ["C2858"] -ms.assetid: 1fb1d770-307e-476e-9984-a1d8f8ce2820 --- # Compiler Error C2858 > command-line option '/Yc (/Fd*filename1*)' inconsistent with precompiled header, which used '/Fd*filename2*' +## Remarks + The program database specified by the Use Precompiled Header ([`/Yu`](../../build/reference/yu-use-precompiled-header-file.md)) option is not the one specified by the previous Create Precompiled Header ([`/Yc`](../../build/reference/yc-create-precompiled-header-file.md)) option. This error is obsolete in Visual Studio 2022 and later versions. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2859.md b/docs/error-messages/compiler-errors-2/compiler-error-c2859.md index 10dbcd0e841..5d2a5e941e2 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2859.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2859.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Error C2859" title: "Compiler Error C2859" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2859" +ms.date: 11/04/2016 f1_keywords: ["C2859"] helpviewer_keywords: ["C2859"] -ms.assetid: fcfbc58d-08f6-4752-9688-8aaac517e684 --- # Compiler Error C2859 -filename is not the type file that was used when this precompiled header was created, recreate the precompiled header. +> filename is not the type file that was used when this precompiled header was created, recreate the precompiled header. + +## Remarks The project database and precompiled header files must be created together to ensure consistent information. Rebuild the project to recreate the precompiled header. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2860.md b/docs/error-messages/compiler-errors-2/compiler-error-c2860.md index 5d0d5958203..3ac684a3f24 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2860.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2860.md @@ -1,17 +1,21 @@ --- -description: "Learn more about: Compiler Error C2860" title: "Compiler Error C2860" -ms.date: "03/16/2024" +description: "Learn more about: Compiler Error C2860" +ms.date: 03/16/2024 f1_keywords: ["C2860"] helpviewer_keywords: ["C2860"] --- # Compiler Error C2860 -'void' cannot be used as a function parameter except for '(void)' +> 'void' cannot be used as a function parameter except for '(void)' + +## Remarks A function parameter cannot be of type **`void`**. -The following sample generates C2860: +## Example + +The following example generates C2860: ```cpp // C2860.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2861.md b/docs/error-messages/compiler-errors-2/compiler-error-c2861.md index 2a03308508a..eeba808fa07 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2861.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2861.md @@ -1,20 +1,21 @@ --- -description: "Learn more about: Compiler Error C2861" title: "Compiler Error C2861" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2861" +ms.date: 11/04/2016 f1_keywords: ["C2861"] helpviewer_keywords: ["C2861"] -ms.assetid: 012bb44d-6c9b-4def-b54e-b19f1f8ddd1b --- # Compiler Error C2861 -'function name' : an interface member function cannot be defined +> 'function name' : an interface member function cannot be defined + +## Remarks The compiler encountered the interface keyword or deduced a struct as an interface but then found a member function definition. An interface cannot contain a definition for a member function. ## Example -The following sample generates C2861: +The following example generates C2861: ```cpp // C2861.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2862.md b/docs/error-messages/compiler-errors-2/compiler-error-c2862.md index 1e293348d28..ccef63bbcf6 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2862.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2862.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2862" title: "Compiler Error C2862" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2862" +ms.date: 11/04/2016 f1_keywords: ["C2862"] helpviewer_keywords: ["C2862"] -ms.assetid: c04d8499-b799-48a1-9fb4-7902a0b0ac8e --- # Compiler Error C2862 -'interface' : an interface can only have public members +> 'interface' : an interface can only have public members + +## Remarks Protected and private members may be accessed only from other member functions. Such members are no use in an interface, since it may not provide implementations for any of its members. -The following sample will generate C2862: +## Example + +The following example will generate C2862: ```cpp // C2862.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2863.md b/docs/error-messages/compiler-errors-2/compiler-error-c2863.md index 5df82ef31b2..dbd762cdf7e 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2863.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2863.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2863" title: "Compiler Error C2863" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2863" +ms.date: 11/04/2016 f1_keywords: ["C2863"] helpviewer_keywords: ["C2863"] -ms.assetid: 32561d67-a795-486b-b3b6-4b90a1acb176 --- # Compiler Error C2863 -'interface' : an interface cannot have friends +> 'interface' : an interface cannot have friends + +## Remarks Declaring friends on an interface is not allowed. -The following sample generates C2863: +## Example + +The following example generates C2863: ```cpp // C2863.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2864.md b/docs/error-messages/compiler-errors-2/compiler-error-c2864.md index 9dd8b4fe30e..950b3a8bacb 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2864.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2864.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2864" title: "Compiler Error C2864" +description: "Learn more about: Compiler Error C2864" ms.date: 10/04/2019 f1_keywords: ["C2864"] helpviewer_keywords: ["C2864"] -ms.assetid: d0ca2ad9-90a6-4aef-8511-98a3b414c102 --- # Compiler Error C2864 @@ -16,7 +15,7 @@ To initialize a **`static`** data member that's defined as **`volatile`**, non-* ## Example -This sample generates C2864: +This example generates C2864: ```cpp // C2864.cpp @@ -32,7 +31,7 @@ private: }; ``` -This sample shows how to fix C2864: +This example shows how to fix C2864: ```cpp // C2864b.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2865.md b/docs/error-messages/compiler-errors-2/compiler-error-c2865.md index 798e14910ec..1f9f9040dfc 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2865.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2865.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Error C2865" title: "Compiler Error C2865" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2865" +ms.date: 11/04/2016 f1_keywords: ["C2865"] helpviewer_keywords: ["C2865"] -ms.assetid: 973eb6a0-c99a-4d25-b3e5-fe0539794d77 --- # Compiler Error C2865 -'function' : illegal comparison for handle_or_pointer +> 'function' : illegal comparison for handle_or_pointer + +## Remarks You can compare references to [Classes and Structs](../../extensions/classes-and-structs-cpp-component-extensions.md) or managed reference types only for equality to see if they refer to the same object (==) or to different objects (!=). diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2867.md b/docs/error-messages/compiler-errors-2/compiler-error-c2867.md index 5a5373bcccf..6f82ffe3058 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2867.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2867.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2867" title: "Compiler Error C2867" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2867" +ms.date: 11/04/2016 f1_keywords: ["C2867"] helpviewer_keywords: ["C2867"] -ms.assetid: 63be26b2-d9ab-4f3d-a8b7-981ce3e4d6b9 --- # Compiler Error C2867 -'identifier' : is not a namespace +> 'identifier' : is not a namespace + +## Remarks A **`using`** directive is applied to something other than a namespace. -The following sample generates C2867: +## Example + +The following example generates C2867: ```cpp // C2867.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2868.md b/docs/error-messages/compiler-errors-2/compiler-error-c2868.md index 3c9e74506eb..aace8ea2a24 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2868.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2868.md @@ -1,20 +1,21 @@ --- -description: "Learn more about: Compiler Error C2868" title: "Compiler Error C2868" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2868" +ms.date: 11/04/2016 f1_keywords: ["C2868"] helpviewer_keywords: ["C2868"] -ms.assetid: 6ff5837b-e66d-44d1-9d17-80af35e08d08 --- # Compiler Error C2868 > '*identifier*' : illegal syntax for using-declaration; expected qualified-name +## Remarks + A [using declaration](../../cpp/using-declaration.md) requires a *qualified name*, a scope-operator (`::`) separated sequence of namespace, class, or enumeration names that ends with the identifier name. A single scope resolution operator may be used to introduce a name from the global namespace. ## Example -The following sample generates C2868 and also shows correct usage: +The following example generates C2868 and also shows correct usage: ```cpp // C2868.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2869.md b/docs/error-messages/compiler-errors-2/compiler-error-c2869.md index e42f10940ac..74243dc953f 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2869.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2869.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2869" title: "Compiler Error C2869" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2869" +ms.date: 11/04/2016 f1_keywords: ["C2869"] helpviewer_keywords: ["C2869"] -ms.assetid: 6e30c001-47f3-4101-b9f1-cc542c9fffae --- # Compiler Error C2869 -'name' : has already been defined to be a namespace +> 'name' : has already been defined to be a namespace + +## Remarks You cannot reuse a name already used as a namespace. -The following sample generates C2869: +## Example + +The following example generates C2869: ```cpp // C2869.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2870.md b/docs/error-messages/compiler-errors-2/compiler-error-c2870.md index 47ea940abcd..0aa1c8d1ccd 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2870.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2870.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2870" title: "Compiler Error C2870" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2870" +ms.date: 11/04/2016 f1_keywords: ["C2870"] helpviewer_keywords: ["C2870"] -ms.assetid: 80523ee9-1fd3-4dc4-8a77-5083deb99066 --- # Compiler Error C2870 -'name' : a namespace definition must appear either at file scope or immediately within another namespace definition +> 'name' : a namespace definition must appear either at file scope or immediately within another namespace definition + +## Remarks You defined namespace `name` incorrectly. Namespaces must be defined at file scope (outside all blocks and classes) or immediately within another namespace. -The following sample generates C2870: +## Example + +The following example generates C2870: ```cpp // C2870.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2871.md b/docs/error-messages/compiler-errors-2/compiler-error-c2871.md index 2e451cbade7..c3261549f3c 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2871.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2871.md @@ -1,20 +1,21 @@ --- -description: "Learn more about: Compiler Error C2871" title: "Compiler Error C2871" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2871" +ms.date: 11/04/2016 f1_keywords: ["C2871"] helpviewer_keywords: ["C2871"] -ms.assetid: 44aeb84d-61f0-45e0-8dad-22a3cd46b7f8 --- # Compiler Error C2871 -'name' : a namespace with this name does not exist +> 'name' : a namespace with this name does not exist + +## Remarks This error will occur when you pass an identifier that is not a namespace to a [using](../../cpp/namespaces-cpp.md#using_directives) directive. ## Example -The following sample generates C2871: +The following example generates C2871: ```cpp // C2871.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2872.md b/docs/error-messages/compiler-errors-2/compiler-error-c2872.md index 8c90fb01c05..9e5f59ead02 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2872.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2872.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Error C2872" title: "Compiler Error C2872" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2872" +ms.date: 11/04/2016 f1_keywords: ["C2872"] helpviewer_keywords: ["C2872"] -ms.assetid: c619ef97-6e0e-41d7-867c-f8d28a07d553 --- # Compiler Error C2872 -'*symbol*' : ambiguous symbol +> '*symbol*' : ambiguous symbol + +## Remarks The compiler cannot determine which symbol you are referring to. More than one symbol with the specified name is in scope. See the notes following the error message for the file locations and declarations the compiler found for the ambiguous symbol. To fix this issue, you can fully qualify the ambiguous symbol by using its namespace, for example, `std::byte` or `::byte`. You can also use a [namespace alias](../../cpp/namespaces-cpp.md#namespace_aliases) to give an included namespace a convenient short name for use when disambiguating symbols in your source code. @@ -22,7 +23,7 @@ C2872 can occur in Visual Studio 2013 due to a conflict between the `Windows::Fo ## Example -The following sample generates C2872, because an ambiguous reference is made to a variable named `i`; two variables with the same name are in scope: +The following example generates C2872, because an ambiguous reference is made to a variable named `i`; two variables with the same name are in scope: ```cpp // C2872.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2873.md b/docs/error-messages/compiler-errors-2/compiler-error-c2873.md index f68141e9cb5..befff3cf35f 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2873.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2873.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Compiler Error C2873" title: "Compiler Error C2873" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2873" +ms.date: 11/04/2016 f1_keywords: ["C2873"] helpviewer_keywords: ["C2873"] -ms.assetid: 7a10036b-400e-4364-bd2f-dcd7370c5e28 --- # Compiler Error C2873 -'symbol' : symbol cannot be used in a using-declaration +> 'symbol' : symbol cannot be used in a using-declaration + +## Remarks A **`using`** directive is missing a [namespace](../../cpp/namespaces-cpp.md) keyword. This causes the compiler to misinterpret the code as a [using declaration](../../cpp/using-declaration.md) rather than a [using directive](../../cpp/namespaces-cpp.md#using_directives). diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2874.md b/docs/error-messages/compiler-errors-2/compiler-error-c2874.md index f77e52f6aa5..2903d83b7e9 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2874.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2874.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2874" title: "Compiler Error C2874" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2874" +ms.date: 11/04/2016 f1_keywords: ["C2874"] helpviewer_keywords: ["C2874"] -ms.assetid: b54fa9d8-8df5-40d9-9b3b-aa3e9dd6a3be --- # Compiler Error C2874 -using-declaration causes a multiple declaration of 'symbol' +> using-declaration causes a multiple declaration of 'symbol' + +## Remarks The declaration causes the same item to be defined twice. -The following sample generates C2874: +## Example + +The following example generates C2874: ```cpp // C2874.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2875.md b/docs/error-messages/compiler-errors-2/compiler-error-c2875.md index ed6b53506d0..2a2e0688f85 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2875.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2875.md @@ -1,20 +1,23 @@ --- -description: "Learn more about: Compiler Error C2875" title: "Compiler Error C2875" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2875" +ms.date: 11/04/2016 f1_keywords: ["C2875"] helpviewer_keywords: ["C2875"] -ms.assetid: d589fc0c-08b2-4a79-bc0e-dca5eb80bdd5 --- # Compiler Error C2875 > using-declaration causes a multiple declaration of 'class::identifier' +## Remarks + The declaration causes the same item to be defined twice. This error is obsolete in Visual Studio 2022 and later versions. -The following sample generates C2875: +## Example + +The following example generates C2875: ```cpp // C2875.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2876.md b/docs/error-messages/compiler-errors-2/compiler-error-c2876.md index 4aa48c784ad..d102a7f0192 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2876.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2876.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2876" title: "Compiler Error C2876" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2876" +ms.date: 11/04/2016 f1_keywords: ["C2876"] helpviewer_keywords: ["C2876"] -ms.assetid: 8b674bf1-f9f4-4a8e-8127-e884c1d1708f --- # Compiler Error C2876 -'class::symbol' : not all overloads are accessible +> 'class::symbol' : not all overloads are accessible + +## Remarks All overloaded forms of a function in a base class must be accessible to the derived class. -The following sample generates C2876: +## Example + +The following example generates C2876: ```cpp // C2876.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2877.md b/docs/error-messages/compiler-errors-2/compiler-error-c2877.md index dfe1367cf52..62a17b4f704 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2877.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2877.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2877" title: "Compiler Error C2877" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2877" +ms.date: 11/04/2016 f1_keywords: ["C2877"] helpviewer_keywords: ["C2877"] -ms.assetid: 0b54837e-fcae-4d90-9658-623250435e24 --- # Compiler Error C2877 -'symbol' is not accessible from 'class' +> 'symbol' is not accessible from 'class' + +## Remarks All members derived from a base class must be accessible in the derived class. -The following sample generates C2877: +## Example + +The following example generates C2877: ```cpp // C2877.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2878.md b/docs/error-messages/compiler-errors-2/compiler-error-c2878.md index cc6a1320dac..d5c043adce3 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2878.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2878.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2878" title: "Compiler Error C2878" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2878" +ms.date: 11/04/2016 f1_keywords: ["C2878"] helpviewer_keywords: ["C2878"] -ms.assetid: 83ee3de1-f554-49e8-a840-1f550cee7f69 --- # Compiler Error C2878 -'name' : a namespace or class of this name does not exist +> 'name' : a namespace or class of this name does not exist + +## Remarks You made reference to a namespace or class that is not defined. -The following sample generates C2878: +## Example + +The following example generates C2878: ```cpp // C2878.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2879.md b/docs/error-messages/compiler-errors-2/compiler-error-c2879.md index 90cfabfe639..0baee26805f 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2879.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2879.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2879" title: "Compiler Error C2879" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2879" +ms.date: 11/04/2016 f1_keywords: ["C2879"] helpviewer_keywords: ["C2879"] -ms.assetid: ac92b645-2394-49de-8632-43d44e0553ed --- # Compiler Error C2879 -'symbol' : only an existing namespace can be given an alternative name by a namespace alias definition +> 'symbol' : only an existing namespace can be given an alternative name by a namespace alias definition + +## Remarks You cannot create a [namespace alias](../../cpp/namespaces-cpp.md#namespace_aliases) to a symbol other than a namespace. -The following sample generates C2879: +## Example + +The following example generates C2879: ```cpp // C2879.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2881.md b/docs/error-messages/compiler-errors-2/compiler-error-c2881.md index 45d454a253a..b454691769b 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2881.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2881.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2881" title: "Compiler Error C2881" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2881" +ms.date: 11/04/2016 f1_keywords: ["C2881"] helpviewer_keywords: ["C2881"] -ms.assetid: b49c63c2-b064-4d4b-a75e-ddd2af947522 --- # Compiler Error C2881 -'namespace1' : is already used as an alias for 'namespace2' +> 'namespace1' : is already used as an alias for 'namespace2' + +## Remarks You cannot use the same name as an alias for two namespaces. -The following sample generates C2881: +## Example + +The following example generates C2881: ```cpp // C2881.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2882.md b/docs/error-messages/compiler-errors-2/compiler-error-c2882.md index e3a0d257e3e..a9197ff4b8f 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2882.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2882.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2882" title: "Compiler Error C2882" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2882" +ms.date: 11/04/2016 f1_keywords: ["C2882"] helpviewer_keywords: ["C2882"] -ms.assetid: 617018ee-5a0d-4b8d-9612-77e8ae52679b --- # Compiler Error C2882 -'name' : illegal use of namespace identifier in expression +> 'name' : illegal use of namespace identifier in expression + +## Remarks You tried to use the name of a namespace in an expression. -The following sample generates C2882: +## Example + +The following example generates C2882: ```cpp // C2882.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2883.md b/docs/error-messages/compiler-errors-2/compiler-error-c2883.md index e503e3d6ad6..8f99b1c5f3e 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2883.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2883.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2883" title: "Compiler Error C2883" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2883" +ms.date: 11/04/2016 f1_keywords: ["C2883"] helpviewer_keywords: ["C2883"] -ms.assetid: 5c6d689d-ed42-41ad-b5c0-e9c2e0b8c356 --- # Compiler Error C2883 -'name' : function declaration conflicts with 'identifier' introduced by using-declaration +> 'name' : function declaration conflicts with 'identifier' introduced by using-declaration + +## Remarks You tried to define a function more than once. The first definition was made from a namespace with a **`using`** declaration. The second was a local definition. -The following sample generates C2883: +## Example + +The following example generates C2883: ```cpp // C2883.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2884.md b/docs/error-messages/compiler-errors-2/compiler-error-c2884.md index fedd4259709..246efeaf563 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2884.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2884.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2884" title: "Compiler Error C2884" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2884" +ms.date: 11/04/2016 f1_keywords: ["C2884"] helpviewer_keywords: ["C2884"] -ms.assetid: 8b4d43e3-3fb5-4360-86c8-de59d8736d4f --- # Compiler Error C2884 -'name' : introduced by using-declaration conflicts with local function 'function' +> 'name' : introduced by using-declaration conflicts with local function 'function' + +## Remarks You tried to define a function more than once. The first definition is a local definition. The second is from a namespace with a **`using`** declaration. -The following sample generates C2884: +## Example + +The following example generates C2884: ```cpp // C2884.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2885.md b/docs/error-messages/compiler-errors-2/compiler-error-c2885.md index 018ee3660e2..05e2cc3e2a1 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2885.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2885.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Error C2885" title: "Compiler Error C2885" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2885" +ms.date: 11/04/2016 f1_keywords: ["C2885"] helpviewer_keywords: ["C2885"] -ms.assetid: 7743e5f3-a034-44b4-9ee8-5a6254c27f8c --- # Compiler Error C2885 -'class::identifier' : not a valid using-declaration at non-class scope +> 'class::identifier' : not a valid using-declaration at non-class scope + +## Remarks You used a [using](../../cpp/using-declaration.md) declaration incorrectly. @@ -16,7 +17,7 @@ This error can be generated as a result of compiler conformance work that was do ## Examples -The following sample generates C2885. +The following example generates C2885. ```cpp // C2885.cpp @@ -47,7 +48,7 @@ int main () { If you use the **`using`** keyword with a class member, C++ requires you to define that member inside another class (a derived class). -The following sample generates C2885. +The following example generates C2885. ```cpp // C2885_b.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2886.md b/docs/error-messages/compiler-errors-2/compiler-error-c2886.md index b93a4b5c767..485fb01d635 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2886.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2886.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2886" title: "Compiler Error C2886" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2886" +ms.date: 11/04/2016 f1_keywords: ["C2886"] helpviewer_keywords: ["C2886"] -ms.assetid: c01588a1-484c-4dc9-a3f1-f900c6e44543 --- # Compiler Error C2886 -'class::identifier' : symbol cannot be used in a member using-declaration +> 'class::identifier' : symbol cannot be used in a member using-declaration + +## Remarks A **`using`** declaration uses a symbol, such as a namespace name. A **`using`** declaration is for declaring base class members. -The following sample generates C2886: +## Example + +The following example generates C2886: ```cpp // C2886.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2888.md b/docs/error-messages/compiler-errors-2/compiler-error-c2888.md index cfc30eecb95..cc6421b7442 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2888.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2888.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2888" title: "Compiler Error C2888" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2888" +ms.date: 11/04/2016 f1_keywords: ["C2888"] helpviewer_keywords: ["C2888"] -ms.assetid: 244f593e-ff25-4dad-b31f-84dafa3bc84a --- # Compiler Error C2888 -'identifier' : symbol cannot be defined within namespace 'namespace' +> 'identifier' : symbol cannot be defined within namespace 'namespace' + +## Remarks A symbol belonging to namespace A must be defined in a namespace that encloses A. -The following sample generates C2888: +## Example + +The following example generates C2888: ```cpp // C2888.cpp @@ -23,7 +26,7 @@ namespace M { void f2(); } - void N::f1() {} // OK: namspace M encloses N + void N::f1() {} // OK: namespace M encloses N } namespace O { diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2890.md b/docs/error-messages/compiler-errors-2/compiler-error-c2890.md index d17bdde458f..85a41dc4631 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2890.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2890.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2890" title: "Compiler Error C2890" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2890" +ms.date: 11/04/2016 f1_keywords: ["C2890"] helpviewer_keywords: ["C2890"] -ms.assetid: 49147375-182c-42b1-b170-f475cd436d47 --- # Compiler Error C2890 -'class' : a ref class can only have one non-interface base class +> 'class' : a ref class can only have one non-interface base class + +## Remarks A reference class can only have one base class. -The following sample generates C2890: +## Example + +The following example generates C2890: ```cpp // C2890.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2891.md b/docs/error-messages/compiler-errors-2/compiler-error-c2891.md index e092c0a18bf..d4068c29352 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2891.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2891.md @@ -1,24 +1,29 @@ --- -description: "Learn more about: Compiler Error C2891" title: "Compiler Error C2891" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2891" +ms.date: 11/04/2016 f1_keywords: ["C2891"] helpviewer_keywords: ["C2891"] -ms.assetid: e12cfb2d-df45-4b0d-b155-c51d17e812fa --- # Compiler Error C2891 -'parameter' : cannot take the address of a template parameter +> 'parameter' : cannot take the address of a template parameter -You can't take the address of a template parameter unless it is an lvalue. Type parameters are not lvalues because they have no address. Non-type values in template parameter lists that are not lvalues also do not have an address. This is an example of code that causes Compiler Error C2891, because the value passed as the template parameter is a compiler-generated copy of the template argument. +## Remarks -``` +You can't take the address of a template parameter unless it is an lvalue. Type parameters are not lvalues because they have no address. Non-type values in template parameter lists that are not lvalues also do not have an address. + +## Example + +This is an example of code that causes Compiler Error C2891, because the value passed as the template parameter is a compiler-generated copy of the template argument. + +```cpp template int* f() { return &i; } ``` Template parameters that are lvalues, such as reference types, can have their address taken. -``` +```cpp template int* f() { return &r; } ``` diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2892.md b/docs/error-messages/compiler-errors-2/compiler-error-c2892.md index 4ae86e0ab38..9ac778b80eb 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2892.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2892.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2892" title: "Compiler Error C2892" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2892" +ms.date: 11/04/2016 f1_keywords: ["C2892"] helpviewer_keywords: ["C2892"] -ms.assetid: c22a5084-2f50-42c2-a56b-6dfe5442edc9 --- # Compiler Error C2892 -local class shall not have member templates +> local class shall not have member templates + +## Remarks Templated member functions are not valid in a class that is defined in a function. -The following sample generates C2892: +## Example + +The following example generates C2892: ```cpp // C2892.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2893.md b/docs/error-messages/compiler-errors-2/compiler-error-c2893.md index 7e1fab4903a..2e416b3f4fa 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2893.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2893.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Error C2893" title: "Compiler Error C2893" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2893" +ms.date: 11/04/2016 f1_keywords: ["C2893"] helpviewer_keywords: ["C2893"] -ms.assetid: ec0cbe43-005d-45da-8742-aaeb9b81d28e --- # Compiler Error C2893 -Failed to specialize function template 'template name' +> Failed to specialize function template 'template name' + +## Remarks The compiler failed to specialize a function template. There can be many causes for this error. @@ -16,12 +17,12 @@ In general, the way to resolve a C2893 error is to review the function's signatu ## Example -C2893 occurs because `f`'s template parameter `T` is deduced to be `std::map`, but `std::map` has no member `data_type` (`T::data_type` can not be instantiated with `T = std::map`.). The following sample generates C2893. +C2893 occurs because `f`'s template parameter `T` is deduced to be `std::map`, but `std::map` has no member `data_type` (`T::data_type` can not be instantiated with `T = std::map`.). The following example generates C2893. ```cpp // C2893.cpp // compile with: /c /EHsc -#include +#include using namespace std; class MyClass {}; diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2894.md b/docs/error-messages/compiler-errors-2/compiler-error-c2894.md index 1d4ddc374de..0e16df5bc87 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2894.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2894.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2894" title: "Compiler Error C2894" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2894" +ms.date: 11/04/2016 f1_keywords: ["C2894"] helpviewer_keywords: ["C2894"] -ms.assetid: 4e250579-2b59-4993-a6f4-49273e7ecf06 --- # Compiler Error C2894 -templates cannot be declared to have 'C' linkage +> templates cannot be declared to have 'C' linkage + +## Remarks This error can be caused by a template defined inside an `extern "C"` block. -The following sample generates C2894: +## Examples + +The following example generates C2894: ```cpp // C2894.cpp @@ -23,7 +26,7 @@ extern "C" { } ``` -The following sample generates C2894: +The following example generates C2894: ```cpp // C2894b.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2896.md b/docs/error-messages/compiler-errors-2/compiler-error-c2896.md index 32db06f54ff..b46ff6e8c4d 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2896.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2896.md @@ -1,20 +1,23 @@ --- -description: "Learn more about: Compiler Error C2896" title: "Compiler Error C2896" +description: "Learn more about: Compiler Error C2896" ms.date: 06/01/2022 f1_keywords: ["C2896"] helpviewer_keywords: ["C2896"] -ms.assetid: b600407b-cb05-42e3-9069-2aa6960f0eaa --- # Compiler Error C2896 > '*function1*' : cannot use function template '*function2*' as argument +## Remarks + A function template can't be an argument to another function template. This error is obsolete in Visual Studio 2022 and later versions. -The following sample generates C2896: +## Examples + +The following example generates C2896: ```cpp // C2896.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2897.md b/docs/error-messages/compiler-errors-2/compiler-error-c2897.md index f68c4fe3304..3ecd2efb034 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2897.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2897.md @@ -1,20 +1,21 @@ --- -description: "Learn more about: Compiler Error C2897" title: "Compiler Error C2897" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2897" +ms.date: 11/04/2016 f1_keywords: ["C2897"] helpviewer_keywords: ["C2897"] -ms.assetid: a88349e2-823f-42a0-8660-0653b677afa4 --- # Compiler Error C2897 -a destructor/finalizer cannot be a function template +> a destructor/finalizer cannot be a function template + +## Remarks Destructors or finalizers cannot be overloaded, so declaring a destructor as a template (which would define a set of destructors) is not allowed. ## Examples -The following sample generates C2897. +The following example generates C2897. ```cpp // C2897.cpp @@ -25,7 +26,7 @@ public: }; ``` -The following sample generates C2897. +The following example generates C2897. ```cpp // C2897_b.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2898.md b/docs/error-messages/compiler-errors-2/compiler-error-c2898.md index f4dd5343894..2a75f55d76f 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2898.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2898.md @@ -1,16 +1,17 @@ --- -description: "Learn more about: Compiler Error C2898" title: "Compiler Error C2898" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2898" +ms.date: 11/04/2016 f1_keywords: ["C2898"] helpviewer_keywords: ["C2898"] -ms.assetid: 68466e11-2541-4f6b-b772-13a642f30dfb --- # Compiler Error C2898 -'declaration' : member function templates cannot be virtual +> 'declaration' : member function templates cannot be virtual + +## Example -The following sample generates C2898: +The following example generates C2898: ```cpp // C2898.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2902.md b/docs/error-messages/compiler-errors-2/compiler-error-c2902.md index 1769f12a7de..4c05069ed3d 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2902.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2902.md @@ -1,20 +1,23 @@ --- -description: "Learn more about: Compiler Error C2902" title: "Compiler Error C2902" +description: "Learn more about: Compiler Error C2902" ms.date: 06/01/2022 f1_keywords: ["C2902"] helpviewer_keywords: ["C2902"] -ms.assetid: 89d78d0e-78e5-4c2c-a0f9-a60110e9395e --- # Compiler Error C2902 > '*token*' : unexpected token following '*template*', identifier expected +## Remarks + The token following the keyword **`template`** was not an identifier. This error is obsolete in Visual Studio 2022 and later versions. -The following sample generates C2902: +## Examples + +The following example generates C2902: ```cpp // C2902.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2903.md b/docs/error-messages/compiler-errors-2/compiler-error-c2903.md index 4b8619c11ef..0024b394e0d 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2903.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2903.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2903" title: "Compiler Error C2903" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2903" +ms.date: 11/04/2016 f1_keywords: ["C2903"] helpviewer_keywords: ["C2903"] -ms.assetid: bf6b223f-4921-48c7-82b9-ff318b42c801 --- # Compiler Error C2903 -'identifier' : symbol is neither a class template nor a function template +> 'identifier' : symbol is neither a class template nor a function template + +## Remarks Code attempts explicit instantiation of something that is not a template. -The following sample generates C2903: +## Examples + +The following example generates C2903: ```cpp // C2903.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2904.md b/docs/error-messages/compiler-errors-2/compiler-error-c2904.md index c499ffed634..f7193434586 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2904.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2904.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2904" title: "Compiler Error C2904" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2904" +ms.date: 11/04/2016 f1_keywords: ["C2904"] helpviewer_keywords: ["C2904"] -ms.assetid: d5802f2e-d3fc-473d-aa04-36957b4eaca5 --- # Compiler Error C2904 -'identifier' : name already used for a template in the current scope +> 'identifier' : name already used for a template in the current scope + +## Remarks Check the code for duplicate names. -The following sample generates C2904: +## Example + +The following example generates C2904: ```cpp // C2904.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2906.md b/docs/error-messages/compiler-errors-2/compiler-error-c2906.md index f48e4457855..9a081d51aa9 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2906.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2906.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2906" title: "Compiler Error C2906" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2906" +ms.date: 11/04/2016 f1_keywords: ["C2906"] helpviewer_keywords: ["C2906"] -ms.assetid: 30f652f1-6af6-4a2f-a69e-a1a4876cc8c6 --- # Compiler Error C2906 -'specialization' : explicit specialization requires 'template <>' +> 'specialization' : explicit specialization requires 'template <>' + +## Remarks You must use the new syntax for explicit specialization of templates. -The following sample generates C2906: +## Example + +The following example generates C2906: ```cpp // C2906.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2908.md b/docs/error-messages/compiler-errors-2/compiler-error-c2908.md index 19d7588b5f4..c440d9f60f0 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2908.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2908.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2908" title: "Compiler Error C2908" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2908" +ms.date: 11/04/2016 f1_keywords: ["C2908"] helpviewer_keywords: ["C2908"] -ms.assetid: 49cd2a21-cad8-4ba0-9a0b-3a0190d9344c --- # Compiler Error C2908 -explicit specialization; 'template' has already been instantiated +> explicit specialization; 'template' has already been instantiated + +## Remarks A specialization of the primary template occurs before the explicit specialization. -The following sample generates C2908: +## Example + +The following example generates C2908: ```cpp // C2908.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2909.md b/docs/error-messages/compiler-errors-2/compiler-error-c2909.md index 6483ee73dad..d665e604712 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2909.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2909.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2909" title: "Compiler Error C2909" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2909" +ms.date: 11/04/2016 f1_keywords: ["C2909"] helpviewer_keywords: ["C2909"] -ms.assetid: 1c9df8ae-925d-4002-a5f8-a71413c45f9e --- # Compiler Error C2909 -'identifier': explicit instantiation of function template requires return type +> 'identifier': explicit instantiation of function template requires return type + +## Remarks An explicit instantiation of a function template requires explicit specification of its return type. Implicit return type specification does not work. -The following sample generates C2909: +## Example + +The following example generates C2909: ```cpp // C2909.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2910.md b/docs/error-messages/compiler-errors-2/compiler-error-c2910.md index 1aa3cc27a3d..aa2f41b2086 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2910.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2910.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2910" title: "Compiler Error C2910" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2910" +ms.date: 11/04/2016 f1_keywords: ["C2910"] helpviewer_keywords: ["C2910"] -ms.assetid: 09c50e6a-e099-42f6-8ed6-d80e292a7a36 --- # Compiler Error C2910 -'function' : cannot be explicitly specialized +> 'function' : cannot be explicitly specialized + +## Remarks The compiler detected an attempt to explicitly specialize a function twice. -The following sample generates C2910: +## Examples + +The following example generates C2910: ```cpp // C2910.cpp @@ -26,7 +29,7 @@ template <> void S::f() {} // C2910 delete this specialization C2910 can also be generated if you try to explicitly specialize a non-template member. That is, you can only explicitly specialize a function template. -The following sample generates C2910: +The following example generates C2910: ```cpp // C2910b.cpp @@ -51,7 +54,7 @@ This error will also be generated as a result of compiler conformance work that For code will be valid in the Visual Studio .NET 2003 and Visual Studio .NET versions of Visual C++, remove `template <>`. -The following sample generates C2910: +The following example generates C2910: ```cpp // C2910c.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2911.md b/docs/error-messages/compiler-errors-2/compiler-error-c2911.md index 980b21e196c..89012b64268 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2911.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2911.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2911" title: "Compiler Error C2911" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2911" +ms.date: 11/04/2016 f1_keywords: ["C2911"] helpviewer_keywords: ["C2911"] -ms.assetid: 83c7c01a-ab6a-4179-9fb0-289a9ec8d44e --- # Compiler Error C2911 -'member' : cannot be declared or defined in the current scope +> 'member' : cannot be declared or defined in the current scope + +## Remarks Inside a namespace, class, or function, you can only define a member of the same namespace, class, or function or a member that is enclosed by the same namespace, class, or function. -The following sample generates C2911: +## Example + +The following example generates C2911: ```cpp // C2911.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2912.md b/docs/error-messages/compiler-errors-2/compiler-error-c2912.md index 70fe8cd6599..3184529521a 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2912.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2912.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2912" title: "Compiler Error C2912" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2912" +ms.date: 11/04/2016 f1_keywords: ["C2912"] helpviewer_keywords: ["C2912"] -ms.assetid: bd55cecd-ab1a-4636-ab8a-a00393fe7b3d --- # Compiler Error C2912 -explicit specialization 'declaration' is not a specialization of a function template +> explicit specialization 'declaration' is not a specialization of a function template + +## Remarks You cannot specialize a non-template function. -The following sample generates C2912: +## Examples + +The following example generates C2912: ```cpp // C2912.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2913.md b/docs/error-messages/compiler-errors-2/compiler-error-c2913.md index 4b9adf22edd..db8bc5ec90c 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2913.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2913.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2913" title: "Compiler Error C2913" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2913" +ms.date: 11/04/2016 f1_keywords: ["C2913"] helpviewer_keywords: ["C2913"] -ms.assetid: c6cf6090-02e8-49a5-913f-5bc6f864b769 --- # Compiler Error C2913 -explicit specialization; 'declaration' is not a specialization of a class template +> explicit specialization; 'declaration' is not a specialization of a class template + +## Remarks You cannot specialize a non-template class. -The following sample generates C2913: +## Example + +The following example generates C2913: ```cpp // C2913.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2914.md b/docs/error-messages/compiler-errors-2/compiler-error-c2914.md index dc67e9f0658..89cb2921fca 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2914.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2914.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2914" title: "Compiler Error C2914" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2914" +ms.date: 11/04/2016 f1_keywords: ["C2914"] helpviewer_keywords: ["C2914"] -ms.assetid: fc6a0592-f53e-4f5a-88cb-780bbed4acf2 --- # Compiler Error C2914 -'identifier' : cannot deduce type argument as function argument is ambiguous +> 'identifier' : cannot deduce type argument as function argument is ambiguous + +## Remarks The compiler cannot determine which overloaded functions to use for a generic or template argument. -The following sample generates C2914: +## Examples + +The following example generates C2914: ```cpp // C2914.cpp @@ -25,7 +28,7 @@ void h() { g(f); } // C2914 // void h() { g(f); } ``` -C2914 can also occur when using generics. The following sample generates C2914: +C2914 can also occur when using generics. The following example generates C2914: ```cpp // C2914b.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2917.md b/docs/error-messages/compiler-errors-2/compiler-error-c2917.md index f7b627b4264..f572ec0664c 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2917.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2917.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C2917" title: "Compiler Error C2917" +description: "Learn more about: Compiler Error C2917" ms.date: 06/01/2022 f1_keywords: ["C2917"] helpviewer_keywords: ["C2917"] -ms.assetid: ec9da9ee-0f37-47b3-87dd-19ef5a14dc4c --- # Compiler Error C2917 @@ -18,7 +17,7 @@ This error is obsolete in Visual Studio 2022 and later versions. ## Example -The following sample generates C2917. +The following example generates C2917. ```cpp // C2917.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2918.md b/docs/error-messages/compiler-errors-2/compiler-error-c2918.md index a32dfb09d0d..805c9907a4b 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2918.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2918.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Compiler Error C2918" title: "Compiler Error C2918" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2918" +ms.date: 11/04/2016 f1_keywords: ["C2918"] helpviewer_keywords: ["C2918"] -ms.assetid: e452f7ef-0590-45e6-9c7c-ee75dc014670 --- # Compiler Error C2918 -'name': Indexed properties cannot be used on the published surface of a WinRT type +> 'name': Indexed properties cannot be used on the published surface of a WinRT type + +## Remarks Indexed properties are not supported on the published surface of a WinRT type. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2919.md b/docs/error-messages/compiler-errors-2/compiler-error-c2919.md index 4a127dde77d..0c922ead41a 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2919.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2919.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Error C2919" title: "Compiler Error C2919" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2919" +ms.date: 11/04/2016 f1_keywords: ["C2919"] helpviewer_keywords: ["C2919"] -ms.assetid: 140a6db9-eb48-4c5e-84a7-a09d2653605b --- # Compiler Error C2919 -'type': Operators cannot be used on the published surface of a WinRT type +> 'type': Operators cannot be used on the published surface of a WinRT type + +## Remarks The Windows Runtime type system does not support operator member functions in the published surface of a type. This is because not all languages can consume operator member functions. You can create private or internal operator member functions that can be called from C++ code in the same class or compilation unit. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2920.md b/docs/error-messages/compiler-errors-2/compiler-error-c2920.md index 09e52d53e3c..d93a9e6731b 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2920.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2920.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2920" title: "Compiler Error C2920" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2920" +ms.date: 11/04/2016 f1_keywords: ["C2920"] helpviewer_keywords: ["C2920"] -ms.assetid: 0a4cb2de-00a0-4209-8160-c7ce6ed7d9ab --- # Compiler Error C2920 -redefinition : 'class' : class template or generic has already been declared as 'type' +> redefinition : 'class' : class template or generic has already been declared as 'type' + +## Remarks A generic or template class has multiple declarations, which are not equivalent. To fix this error, use different names for different types, or remove the redefinition of the type name. -The following sample generates C2920 and shows how to fix it: +## Examples + +The following example generates C2920 and shows how to fix it: ```cpp // C2920.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2921.md b/docs/error-messages/compiler-errors-2/compiler-error-c2921.md index 9e54aedc97d..1e95a49174b 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2921.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2921.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2921" title: "Compiler Error C2921" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2921" +ms.date: 11/04/2016 f1_keywords: ["C2921"] helpviewer_keywords: ["C2921"] -ms.assetid: 323642a0-bfc4-4942-9f41-c3adf5c54296 --- # Compiler Error C2921 -redefinition : 'class' : class template or generic is being redeclared as 'type' +> redefinition : 'class' : class template or generic is being redeclared as 'type' + +## Remarks A generic or template class has multiple declarations that are not equivalent. To fix this error, use different names for different types, or remove the redefinition of the type name. -The following sample generates C2921: +## Examples + +The following example generates C2921: ```cpp // C2921.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2923.md b/docs/error-messages/compiler-errors-2/compiler-error-c2923.md index aa7b7cb9f12..d5867c16777 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2923.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2923.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2923" title: "Compiler Error C2923" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2923" +ms.date: 11/04/2016 f1_keywords: ["C2923"] helpviewer_keywords: ["C2923"] -ms.assetid: 6b92933b-13ef-4124-99d9-b89f9fdae030 --- # Compiler Error C2923 -'type' : 'identifier' is not a valid template type argument for parameter 'param' +> 'type' : 'identifier' is not a valid template type argument for parameter 'param' + +## Remarks The argument list is missing a type needed to instantiate the template or generic. Check the template or generic declaration. -The following sample generates C2923: +## Examples + +The following example generates C2923: ```cpp // C2923.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2927.md b/docs/error-messages/compiler-errors-2/compiler-error-c2927.md index 26c2fc59b5e..eefb7751741 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2927.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2927.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Compiler Error C2927" title: "Compiler Error C2927" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2927" +ms.date: 11/04/2016 f1_keywords: ["C2927"] helpviewer_keywords: ["C2927"] -ms.assetid: 3f75beec-ff5c-44e1-9085-990ecd55198d --- # Compiler Error C2927 -'function' : a function template must be called with at least one argument +> 'function' : a function template must be called with at least one argument + +## Remarks You cannot call a function template without arguments. The type of the template arguments determines what version of the function to generate. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2928.md b/docs/error-messages/compiler-errors-2/compiler-error-c2928.md index 87bc5a29d23..d2660e9a556 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2928.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2928.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Compiler Error C2928" title: "Compiler Error C2928" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2928" +ms.date: 11/04/2016 f1_keywords: ["C2928"] helpviewer_keywords: ["C2928"] -ms.assetid: 869e57f4-7024-4cbe-b47b-6e1e2a6005c5 --- # Compiler Error C2928 > explicit instantiation; '*identifier*' is not a function or static data member of template-class '*class-name*' +## Remarks + You cannot explicitly instantiate a member of *class-name* that is not a function or **`static`** variable. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2929.md b/docs/error-messages/compiler-errors-2/compiler-error-c2929.md index 64c2ad0086f..9ebb6d95a29 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2929.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2929.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2929" title: "Compiler Error C2929" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2929" +ms.date: 11/04/2016 f1_keywords: ["C2929"] helpviewer_keywords: ["C2929"] -ms.assetid: 11134027-6adc-4733-b6bd-b94486bd1933 --- # Compiler Error C2929 -'identifier' : explicit instantiation; cannot explicitly force and suppress instantiation of template-class member +> 'identifier' : explicit instantiation; cannot explicitly force and suppress instantiation of template-class member + +## Remarks You cannot explicitly instantiate an identifier while preventing it from being instantiated. -The following sample generates C2929: +## Example + +The following example generates C2929: ```cpp // C2929.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2930.md b/docs/error-messages/compiler-errors-2/compiler-error-c2930.md index 882645295d0..5cfc1f444e4 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2930.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2930.md @@ -1,20 +1,23 @@ --- -description: "Learn more about: Compiler Error C2930" title: "Compiler Error C2930" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2930" +ms.date: 11/04/2016 f1_keywords: ["C2930"] helpviewer_keywords: ["C2930"] -ms.assetid: f07eecd1-e5d1-4518-bd89-b1fd2a003a17 --- # Compiler Error C2930 -'class' : type-class-id redefined as an enumerator of 'enum identifier' +> 'class' : type-class-id redefined as an enumerator of 'enum identifier' + +## Remarks You cannot use a generic or template class as a member of an enumeration. This error can be caused if braces are improperly matched. -The following sample generates C2930: +## Examples + +The following example generates C2930: ```cpp // C2930.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2931.md b/docs/error-messages/compiler-errors-2/compiler-error-c2931.md index 569af1e5875..a282986af7b 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2931.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2931.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Error C2931" title: "Compiler Error C2931" +description: "Learn more about: Compiler Error C2931" ms.date: 06/01/2022 f1_keywords: ["C2931"] helpviewer_keywords: ["C2931"] -ms.assetid: 33430407-b149-4ba3-baf8-b0dae1ea3a5d --- # Compiler Error C2931 -'*class*' : type-class-id redefined as a member function of '*identifier*' +> '*class*' : type-class-id redefined as a member function of '*identifier*' + +## Remarks You can't use a generic or template class as a member function of another class. @@ -16,7 +17,9 @@ This error is obsolete in Visual Studio 2022 and later versions. This error can be caused if braces are improperly matched. -The following sample generates C2931: +## Examples + +The following example generates C2931: ```cpp // C2931.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2932.md b/docs/error-messages/compiler-errors-2/compiler-error-c2932.md index 3ec4a323b08..e42e9e08fde 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2932.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2932.md @@ -1,20 +1,23 @@ --- -description: "Learn more about: Compiler Error C2932" title: "Compiler Error C2932" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2932" +ms.date: 11/04/2016 f1_keywords: ["C2932"] helpviewer_keywords: ["C2932"] -ms.assetid: c28e88d9-e654-4367-bfb4-13c780bca9bd --- # Compiler Error C2932 > '*class*' : type-class-id redefined as a data member of '*identifier*' +## Remarks + You can't use a generic or template class as a data member. This error is obsolete in Visual Studio 2022 and later versions. -The following sample generates C2932: +## Examples + +The following example generates C2932: ```cpp // C2932.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2933.md b/docs/error-messages/compiler-errors-2/compiler-error-c2933.md index c908e2a05c6..93b6124a889 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2933.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2933.md @@ -1,20 +1,23 @@ --- -description: "Learn more about: Compiler Error C2933" title: "Compiler Error C2933" +description: "Learn more about: Compiler Error C2933" ms.date: 06/01/2022 f1_keywords: ["C2933"] helpviewer_keywords: ["C2933"] -ms.assetid: 394891e3-6b52-4b61-83d2-a1c5125d9bd5 --- # Compiler Error C2933 > '*class*' : type-class-id redefined as a typedef member of '*identifier*' +## Remarks + You can't use a generic or template class as a **`typedef`** member. This error is obsolete in Visual Studio 2022 and later versions. -The following sample generates C2933: +## Examples + +The following example generates C2933: ```cpp // C2933.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2934.md b/docs/error-messages/compiler-errors-2/compiler-error-c2934.md index f95f66da05f..43f7ec8c538 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2934.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2934.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Error C2934" title: "Compiler Error C2934" +description: "Learn more about: Compiler Error C2934" ms.date: 06/01/2022 f1_keywords: ["C2934"] helpviewer_keywords: ["C2934"] -ms.assetid: b7f7e7aa-2d4c-4e17-8564-2c005ab81fd5 --- # Compiler Error C2934 -'*class*' : type-class-id redefined as a nested 'item' of '*identifier*' +> '*class*' : type-class-id redefined as a nested 'item' of '*identifier*' + +## Remarks You can't use a generic or template class as a nested item. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2935.md b/docs/error-messages/compiler-errors-2/compiler-error-c2935.md index 277c0cafd58..7c8f46a10f6 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2935.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2935.md @@ -1,22 +1,25 @@ --- -description: "Learn more about: Compiler Error C2935" title: "Compiler Error C2935" +description: "Learn more about: Compiler Error C2935" ms.date: 06/01/2022 f1_keywords: ["C2935"] helpviewer_keywords: ["C2935"] -ms.assetid: e11ef90d-0756-4e43-8a09-4974c6aa72a3 --- # Compiler Error C2935 > '*class*' : type-class-id redefined as a global function +## Remarks + You can't use a generic or template class as a global function. This error is obsolete in Visual Studio 2022 and later versions. This error can be caused if braces are improperly matched. -The following sample generates C2935: +## Examples + +The following example generates C2935: ```cpp // C2935.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2936.md b/docs/error-messages/compiler-errors-2/compiler-error-c2936.md index 0b7ee74a590..803199c6e6e 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2936.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2936.md @@ -1,22 +1,25 @@ --- -description: "Learn more about: Compiler Error C2936" title: "Compiler Error C2936" +description: "Learn more about: Compiler Error C2936" ms.date: 06/01/2022 f1_keywords: ["C2936"] helpviewer_keywords: ["C2936"] -ms.assetid: 5d1ba0fc-0c78-4a37-a83b-1ef8527763be --- # Compiler Error C2936 > '*class*' : type-class-id redefined as a global data variable +## Remarks + You can't use a generic or template class as a global data variable. This error is obsolete in Visual Studio 2022 and later versions. This error can be caused if braces are improperly matched. -The following sample generates C2936: +## Examples + +The following example generates C2936: ```cpp // C2936.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2937.md b/docs/error-messages/compiler-errors-2/compiler-error-c2937.md index 7c14567bc23..d69d2a883a8 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2937.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2937.md @@ -1,20 +1,23 @@ --- -description: "Learn more about: Compiler Error C2937" title: "Compiler Error C2937" +description: "Learn more about: Compiler Error C2937" ms.date: 06/01/2022 f1_keywords: ["C2937"] helpviewer_keywords: ["C2937"] -ms.assetid: 95671ca3-79f7-4b56-a5f2-a92296da1629 --- # Compiler Error C2937 > '*class*' : type-class-id redefined as a global typedef +## Remarks + You can't use a generic or template class as a global **`typedef`**. This error is obsolete in Visual Studio 2022 and later versions. -The following sample generates C2937: +## Examples + +The following example generates C2937: ```cpp // C2937.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2939.md b/docs/error-messages/compiler-errors-2/compiler-error-c2939.md index 602ed451dc0..50bf40c9c39 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2939.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2939.md @@ -1,22 +1,25 @@ --- -description: "Learn more about: Compiler Error C2939" title: "Compiler Error C2939" +description: "Learn more about: Compiler Error C2939" ms.date: 06/01/2022 f1_keywords: ["C2939"] helpviewer_keywords: ["C2939"] -ms.assetid: 455b050b-f2dc-4b5b-bd6a-e1f81d3d1644 --- # Compiler Error C2939 > '*class*' : type-class-id redefined as a local data variable +## Remarks + You can't use a generic or template class as a local data variable. This error is obsolete in Visual Studio 2022 and later versions. This error can be caused if braces are improperly matched. -The following sample generates C2939: +## Examples + +The following example generates C2939: ```cpp // C2939.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2940.md b/docs/error-messages/compiler-errors-2/compiler-error-c2940.md index dec4f0abd4a..583db713d13 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2940.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2940.md @@ -1,20 +1,23 @@ --- -description: "Learn more about: Compiler Error C2940" title: "Compiler Error C2940" +description: "Learn more about: Compiler Error C2940" ms.date: 06/01/2022 f1_keywords: ["C2940"] helpviewer_keywords: ["C2940"] -ms.assetid: af6bf2bf-8de6-4cfd-bbf0-4c6b32a30edf --- # Compiler Error C2940 > '*class*' : type-class-id redefined as a local typedef +## Remarks + You can't use a generic or template class as a local **`typedef`**. This error is obsolete in Visual Studio 2022 and later versions. -The following sample generates C2940: +## Examples + +The following example generates C2940: ```cpp // C2940.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2941.md b/docs/error-messages/compiler-errors-2/compiler-error-c2941.md index 53c28a6c841..4d14d929168 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2941.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2941.md @@ -1,15 +1,16 @@ --- -description: "Learn more about: Compiler Error C2941" title: "Compiler Error C2941" +description: "Learn more about: Compiler Error C2941" ms.date: 06/01/2022 f1_keywords: ["C2941"] helpviewer_keywords: ["C2941"] -ms.assetid: 1bba94eb-5bf6-468d-8f84-96a6391a7048 --- # Compiler Error C2941 > '*class*' : type-class-id redefined as a local 'item' +## Remarks + You can't use a generic or template class as an item. This error is obsolete in Visual Studio 2022 and later versions. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2942.md b/docs/error-messages/compiler-errors-2/compiler-error-c2942.md index 83426631265..f806be05068 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2942.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2942.md @@ -1,20 +1,23 @@ --- -description: "Learn more about: Compiler Error C2942" title: "Compiler Error C2942" +description: "Learn more about: Compiler Error C2942" ms.date: 06/01/2022 f1_keywords: ["C2942"] helpviewer_keywords: ["C2942"] -ms.assetid: 13abf744-8fa1-450d-886d-e5717c04956e --- # Compiler Error C2942 > '*class*' : type-class-id redefined as a formal argument of a function +## Remarks + You can't use a generic or template class as a formal argument. You cannot pass an argument directly to the constructor of a generic or template class. This error is obsolete in Visual Studio 2022 and later versions. -The following sample generates C2942: +## Examples + +The following example generates C2942: ```cpp // C2942.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2943.md b/docs/error-messages/compiler-errors-2/compiler-error-c2943.md index 99b4d8f7abd..d2ede6f3564 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2943.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2943.md @@ -1,20 +1,23 @@ --- -description: "Learn more about: Compiler Error C2943" title: "Compiler Error C2943" +description: "Learn more about: Compiler Error C2943" ms.date: 06/01/2022 f1_keywords: ["C2943"] helpviewer_keywords: ["C2943"] -ms.assetid: ede6565e-d892-44c0-8eee-c69545f3be2e --- # Compiler Error C2943 > '*class*' : type-class-id redefined as a type argument of a template +## Remarks + You can't use a generic or template class, instead of a symbol, as a generic or template type argument. This error is obsolete in Visual Studio 2022 and later versions. -The following sample generates C2943: +## Example + +The following example generates C2943: ```cpp // C2943.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2944.md b/docs/error-messages/compiler-errors-2/compiler-error-c2944.md index 68866586941..4c2a3a33869 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2944.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2944.md @@ -1,20 +1,23 @@ --- -description: "Learn more about: Compiler Error C2944" title: "Compiler Error C2944" +description: "Learn more about: Compiler Error C2944" ms.date: 06/01/2022 f1_keywords: ["C2944"] helpviewer_keywords: ["C2944"] -ms.assetid: f209e668-e72f-442a-a438-8c4ff43a404a --- # Compiler Error C2944 > '*class*' : type-class-id redefined as a value argument of a template +## Remarks + You can't use a generic or template class, instead of a symbol, as a template value argument. This error is obsolete in Visual Studio 2022 and later versions. -The following sample generates C2944: +## Examples + +The following example generates C2944: ```cpp // C2944.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2945.md b/docs/error-messages/compiler-errors-2/compiler-error-c2945.md index 2d13eb9f49e..9674071222b 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2945.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2945.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Compiler Error C2945" title: "Compiler Error C2945" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2945" +ms.date: 11/04/2016 f1_keywords: ["C2945"] helpviewer_keywords: ["C2945"] -ms.assetid: be640257-7017-45d1-986a-9fe8caab52f3 --- # Compiler Error C2945 -explicit instantiation does not refer to a template-class specialization +> explicit instantiation does not refer to a template-class specialization + +## Remarks You cannot explicitly instantiate something that is not templated. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2946.md b/docs/error-messages/compiler-errors-2/compiler-error-c2946.md index 382b205402a..01b72d1aeb9 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2946.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2946.md @@ -1,20 +1,21 @@ --- -description: "Learn more about: Compiler Error C2946" title: "Compiler Error C2946" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2946" +ms.date: 11/04/2016 f1_keywords: ["C2946"] helpviewer_keywords: ["C2946"] -ms.assetid: c86dfbfc-7702-4f09-8a53-d205710e99c2 --- # Compiler Error C2946 -explicit instantiation; 'class' is not a template-class specialization +> explicit instantiation; 'class' is not a template-class specialization + +## Remarks You cannot explicitly instantiate a nontemplated class. ## Example -The following sample generates C2946. +The following example generates C2946. ```cpp // C2946.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2947.md b/docs/error-messages/compiler-errors-2/compiler-error-c2947.md index 77faf9893e2..ef70b5db307 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2947.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2947.md @@ -1,20 +1,23 @@ --- -description: "Learn more about: Compiler Error C2947" title: "Compiler Error C2947" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2947" +ms.date: 11/04/2016 f1_keywords: ["C2947"] helpviewer_keywords: ["C2947"] -ms.assetid: 6c056f62-ec90-4883-8a67-aeeb6ec13546 --- # Compiler Error C2947 -expecting '>' to terminate construct, found 'syntax' +> expecting '>' to terminate construct, found 'syntax' + +## Remarks A generic or template argument list may not have been terminated correctly. C2947 can also be generated by syntax errors. -The following sample generates C2947: +## Example + +The following example generates C2947: ```cpp // C2947.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2948.md b/docs/error-messages/compiler-errors-2/compiler-error-c2948.md index b3a878a050a..18dda3d7874 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2948.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2948.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Compiler Error C2948" title: "Compiler Error C2948" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2948" +ms.date: 11/04/2016 f1_keywords: ["C2948"] helpviewer_keywords: ["C2948"] -ms.assetid: 780c6ed3-43a0-4112-8d00-b7bf79086c05 --- # Compiler Error C2948 -explicit instantiation; storage class specifier 'specifier' not permitted on specialization +> explicit instantiation; storage class specifier 'specifier' not permitted on specialization + +## Remarks You cannot use storage-class specifiers (such as **`extern`**) in a specialization of a template class that was previously explicitly instantiated. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2951.md b/docs/error-messages/compiler-errors-2/compiler-error-c2951.md index a38b41dfaf7..993bf2811b4 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2951.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2951.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2951" title: "Compiler Error C2951" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2951" +ms.date: 11/04/2016 f1_keywords: ["C2951"] helpviewer_keywords: ["C2951"] -ms.assetid: c6f95aa2-c894-425b-a51c-d40d70c8daa1 --- # Compiler Error C2951 -type declarations are only permitted at global, namespace, or class scope +> type declarations are only permitted at global, namespace, or class scope + +## Remarks You cannot declare a generic or template class outside global or namespace scope. If you make your generic or template declarations in an include file, make sure the include file is at global scope. -The following sample generates C2951: +## Examples + +The following example generates C2951: ```cpp // C2951.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2952.md b/docs/error-messages/compiler-errors-2/compiler-error-c2952.md index 9998595a1ca..59b2ce3c7f4 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2952.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2952.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2952" title: "Compiler Error C2952" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2952" +ms.date: 11/04/2016 f1_keywords: ["C2952"] helpviewer_keywords: ["C2952"] -ms.assetid: a40e18a2-d02c-4511-854f-6c6fd6789a1a --- # Compiler Error C2952 -'declaration' : type declaration missing template parameter list +> 'declaration' : type declaration missing template parameter list + +## Remarks A template declaration was ill formed. -The following sample generates C2952: +## Examples + +The following example generates C2952: ```cpp // C2952.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2953.md b/docs/error-messages/compiler-errors-2/compiler-error-c2953.md index 6e0d8091d5c..a9f3ae8178a 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2953.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2953.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2953" title: "Compiler Error C2953" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2953" +ms.date: 11/04/2016 f1_keywords: ["C2953"] helpviewer_keywords: ["C2953"] -ms.assetid: 8dbcfa24-8296-4e40-bdc4-5526c07d8892 --- # Compiler Error C2953 -'identifier' : class template has already been defined +> 'identifier' : class template has already been defined + +## Remarks Check the source file and include files for other definitions. -The following sample generates C2953: +## Example + +The following example generates C2953: ```cpp // C2953.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2955.md b/docs/error-messages/compiler-errors-2/compiler-error-c2955.md index 521cf7a352c..93996879010 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2955.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2955.md @@ -1,20 +1,23 @@ --- -description: "Learn more about: Compiler Error C2955" title: "Compiler Error C2955" -ms.date: "03/28/2017" +description: "Learn more about: Compiler Error C2955" +ms.date: 03/28/2017 f1_keywords: ["C2955"] helpviewer_keywords: ["C2955"] -ms.assetid: 77709fb6-d69b-46fd-a62f-e8564563d01b --- # Compiler Error C2955 -'identifier' : use of class template or alias generic requires template or generic argument list +> 'identifier' : use of class template or alias generic requires template or generic argument list + +## Remarks You cannot use a class template or class generic as an identifier without a template or generic argument list. For more information, see [Class Templates](../../cpp/class-templates.md). -The following sample generates C2955 and shows how to fix it: +## Examples + +The following example generates C2955 and shows how to fix it: ```cpp // C2955.cpp @@ -61,8 +64,6 @@ int main() { } ``` -## Example - **Visual Studio 2017 and later:** The compiler correctly diagnoses missing template argument lists when the template appears in a template parameter list (for example as part of a default template argument or a non-type template parameter). The following code compiles in Visual Studio 2015 but produces an error in Visual Studio 2017. ``` diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2956.md b/docs/error-messages/compiler-errors-2/compiler-error-c2956.md index d5fc9187030..77f9fee4e42 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2956.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2956.md @@ -1,6 +1,6 @@ --- -description: "Learn more about: Compiler Error C2956" title: "Compiler Error C2956" +description: "Learn more about: Compiler Error C2956" ms.date: 04/05/2022 f1_keywords: ["C2956"] helpviewer_keywords: ["C2956"] @@ -9,10 +9,10 @@ helpviewer_keywords: ["C2956"] > usual deallocation function '*function*' would be chosen as placement deallocation function -The deallocation function found for the placement new expression matches one of the usual deallocation functions. Either an implicit compiler-generated deallocation or an explicit `delete` (or `delete[]`) would use the wrong deallocation function. - ## Remarks +The deallocation function found for the placement new expression matches one of the usual deallocation functions. Either an implicit compiler-generated deallocation or an explicit `delete` (or `delete[]`) would use the wrong deallocation function. + Error C2956 indicates you used a *placement new expression* (a `new` expression that takes parameters) in a way that can cause a memory leak or runtime crash. It usually means the resulting value can't be deleted in a typical way. That is, either an explicit `delete` (or `delete[]`) expression in your code, or the implicit deallocation when a constructor throws an exception, could invoke the wrong `operator delete` or supply it with the wrong parameters. The C++ standard specifies *usual deallocation functions* as overloads of `operator delete` or `operator delete[]` that take extra parameters of type `std::size_t` (C++14 or later), `std::align_val_t` (C++17 or later), and `std::destroying_delete_t` (C++20 or later). When you use a placement new expression, the compiler looks for a matching `operator delete` function that takes the same parameters (after the first one). If one is found and its signature matches a usual deallocation function, the compiler reports error C2956. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2957.md b/docs/error-messages/compiler-errors-2/compiler-error-c2957.md index e2d17ce3dd2..2c1e921c6a3 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2957.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2957.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2957" title: "Compiler Error C2957" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2957" +ms.date: 11/04/2016 f1_keywords: ["C2957"] helpviewer_keywords: ["C2957"] -ms.assetid: 9cb4526f-4af8-47e9-b786-56192627ca72 --- # Compiler Error C2957 -'delim' : invalid left delimiter : expected '<' +> 'delim' : invalid left delimiter : expected '<' + +## Remarks A generic class was ill formed. -The following sample generates C2957: +## Example + +The following example generates C2957: ```cpp // C2957.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2958.md b/docs/error-messages/compiler-errors-2/compiler-error-c2958.md index 72706383992..341ff3c1dd6 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2958.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2958.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Error C2958" title: "Compiler Error C2958" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2958" +ms.date: 11/04/2016 f1_keywords: ["C2958"] helpviewer_keywords: ["C2958"] -ms.assetid: 332bf6d3-7cd1-4b1a-8ddb-d4a8cbf01115 --- # Compiler Error C2958 -the left delimiter found at 'location' was not matched correctly +> the left delimiter found at 'location' was not matched correctly + +## Remarks A delimiter is not properly matched. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2959.md b/docs/error-messages/compiler-errors-2/compiler-error-c2959.md index 6855bf67bb9..af70755a70c 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2959.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2959.md @@ -1,20 +1,21 @@ --- -description: "Learn more about: Compiler Error C2959" title: "Compiler Error C2959" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2959" +ms.date: 11/04/2016 f1_keywords: ["C2959"] helpviewer_keywords: ["C2959"] -ms.assetid: d66bb2a8-70c3-4209-a358-b0c47f111a50 --- # Compiler Error C2959 -a generic class or function may not be a member of a template +> a generic class or function may not be a member of a template + +## Remarks For more information, see [Windows Runtime and Managed Templates](../../extensions/windows-runtime-and-managed-templates-cpp-component-extensions.md) and [Generics](../../extensions/generics-cpp-component-extensions.md). ## Example -The following sample generates C2959. +The following example generates C2959. ```cpp // C2959.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2962.md b/docs/error-messages/compiler-errors-2/compiler-error-c2962.md index 9059b4b8787..87f5149e549 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2962.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2962.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Error C2962" title: "Compiler Error C2962" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2962" +ms.date: 11/04/2016 f1_keywords: ["C2962"] helpviewer_keywords: ["C2962"] -ms.assetid: 6f966aec-4eea-4221-8e1b-fe66808c6f5c --- # Compiler Error C2962 -syntax error : 'token' : expected template-class member function definition to end with '}' +> syntax error : 'token' : expected template-class member function definition to end with '}' + +## Remarks The token caused a syntax error in a template declaration. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2969.md b/docs/error-messages/compiler-errors-2/compiler-error-c2969.md index 47b9816261f..76d07d11952 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2969.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2969.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2969" title: "Compiler Error C2969" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2969" +ms.date: 11/04/2016 f1_keywords: ["C2969"] helpviewer_keywords: ["C2969"] -ms.assetid: e4ea3d66-b937-4b2c-b42a-96e03fb11579 --- # Compiler Error C2969 -syntax error : 'symbol' : expected member function definition to end with '}' +> syntax error : 'symbol' : expected member function definition to end with '}' + +## Remarks A template member function definition has an unmatched closing brace. -The following sample generates C2969: +## Example + +The following example generates C2969: ```cpp // C2969.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2970.md b/docs/error-messages/compiler-errors-2/compiler-error-c2970.md index 4f25c08138b..f92b1c41441 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2970.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2970.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2970" title: "Compiler Error C2970" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2970" +ms.date: 11/04/2016 f1_keywords: ["C2970"] helpviewer_keywords: ["C2970"] -ms.assetid: 21d90348-20d3-438c-b278-efdbfb93a7d2 --- # Compiler Error C2970 -'class' : template parameter 'param' : 'arg' : an expression involving objects with internal linkage cannot be used as a non-type argument +> 'class' : template parameter 'param' : 'arg' : an expression involving objects with internal linkage cannot be used as a non-type argument + +## Remarks You cannot use the name or address of a static variable as a template argument. The template class expects a const value that can be evaluated at compile time. -The following sample generates C2970: +## Example + +The following example generates C2970: ```cpp // C2970.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2971.md b/docs/error-messages/compiler-errors-2/compiler-error-c2971.md index 2ff75e440c6..667d494be2d 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2971.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2971.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2971" title: "Compiler Error C2971" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2971" +ms.date: 11/04/2016 f1_keywords: ["C2971"] helpviewer_keywords: ["C2971"] -ms.assetid: fdb5467b-9a41-41ef-ac20-2e9428d5a4fc --- # Compiler Error C2971 -'class' : template parameter 'param' : 'arg' : a local variable cannot be used as a non-type argument +> 'class' : template parameter 'param' : 'arg' : a local variable cannot be used as a non-type argument + +## Remarks You cannot use the name or address of a local variable as a template argument. -The following sample generates C2971: +## Example + +The following example generates C2971: ```cpp // C2971.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2973.md b/docs/error-messages/compiler-errors-2/compiler-error-c2973.md index 2a06b243465..79b7b4ab806 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2973.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2973.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Compiler Error C2973" title: "Compiler Error C2973" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2973" +ms.date: 11/04/2016 f1_keywords: ["C2973"] helpviewer_keywords: ["C2973"] -ms.assetid: 18b4a1c1-0ef6-43af-887a-1b5b1ab88d5b --- # Compiler Error C2973 -invalid template argument 'number' +> invalid template argument 'number' + +## Remarks Check the template definition to find the correct types. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2974.md b/docs/error-messages/compiler-errors-2/compiler-error-c2974.md index 1b9610dfcde..1ae52a62674 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2974.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2974.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2974" title: "Compiler Error C2974" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2974" +ms.date: 11/04/2016 f1_keywords: ["C2974"] helpviewer_keywords: ["C2974"] -ms.assetid: 1b444260-f2bf-48d7-ab1e-35573d8c4a0e --- # Compiler Error C2974 -invalid type argument 'number', type expected +> invalid type argument 'number', type expected + +## Remarks The generic or template argument does not match the generic or template declaration. A type should appear within the angle brackets. Check the generic or template definition to find the correct types. -The following sample generates C2974: +## Examples + +The following example generates C2974: ```cpp // C2974.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2975.md b/docs/error-messages/compiler-errors-2/compiler-error-c2975.md index 5e91d46fa5c..e9254cb923f 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2975.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2975.md @@ -1,20 +1,21 @@ --- -description: "Learn more about: Compiler Error C2975" title: "Compiler Error C2975" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2975" +ms.date: 11/04/2016 f1_keywords: ["C2975"] helpviewer_keywords: ["C2975"] -ms.assetid: 526f6b9d-6c76-4c12-9252-1b1d7c1e06c7 --- # Compiler Error C2975 > '*argument*' : invalid template argument for '*type*', expected compile-time constant expression +## Remarks + The template argument does not match the template declaration; a constant expression should appear within the angle brackets. Variables are not allowed as template actual arguments. Check the template definition to find the correct types. -## Example +## Examples -The following sample generates C2975 and also shows correct usage: +The following example generates C2975 and also shows correct usage: ```cpp // C2975.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2976.md b/docs/error-messages/compiler-errors-2/compiler-error-c2976.md index 3ed9ac47998..d9b7e0953b0 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2976.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2976.md @@ -1,20 +1,23 @@ --- -description: "Learn more about: Compiler Error C2976" title: "Compiler Error C2976" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2976" +ms.date: 11/04/2016 f1_keywords: ["C2976"] helpviewer_keywords: ["C2976"] -ms.assetid: d9bf9836-325e-4f72-a7e3-a67cf19d32e7 --- # Compiler Error C2976 -'identifier' : too few type arguments +> 'identifier' : too few type arguments + +## Remarks A generic or template is missing one or more actual arguments. Check the generic or template declaration to find the correct number of parameters. This error can be caused by missing template arguments in C++ Standard Library components. -The following sample generates C2976: +## Examples + +The following example generates C2976: ```cpp // C2976.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2977.md b/docs/error-messages/compiler-errors-2/compiler-error-c2977.md index 4be0207cbb0..302846e67d7 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2977.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2977.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2977" title: "Compiler Error C2977" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2977" +ms.date: 11/04/2016 f1_keywords: ["C2977"] helpviewer_keywords: ["C2977"] -ms.assetid: 3c4218e0-5d03-4a2b-b757-c507c35f3542 --- # Compiler Error C2977 -'identifier' : too many type arguments +> 'identifier' : too many type arguments + +## Remarks A generic or template has too many actual arguments. Check the generic or template declaration to find the correct number of parameters. -The following sample generates C2977: +## Examples + +The following example generates C2977: ```cpp // C2977.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2978.md b/docs/error-messages/compiler-errors-2/compiler-error-c2978.md index 4426147e9a7..d9bee87b88d 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2978.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2978.md @@ -1,20 +1,21 @@ --- -description: "Learn more about: Compiler Error C2978" title: "Compiler Error C2978" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2978" +ms.date: 11/04/2016 f1_keywords: ["C2978"] helpviewer_keywords: ["C2978"] -ms.assetid: 5e7bee82-e266-4ccd-ad2e-ee89606ec5bf --- # Compiler Error C2978 -syntax error : expected 'keyword1' or 'keyword2'; found type 'keyword3'; non-type parameters are not supported in generics +> syntax error : expected 'keyword1' or 'keyword2'; found type 'keyword3'; non-type parameters are not supported in generics + +## Remarks -A generic class was declared incorrectly. See [Generics](../../extensions/generics-cpp-component-extensions.md)for more information. +A generic class was declared incorrectly. See [Generics](../../extensions/generics-cpp-component-extensions.md) for more information. ## Example -The following sample generates C2978. +The following example generates C2978. ```cpp // C2978.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2979.md b/docs/error-messages/compiler-errors-2/compiler-error-c2979.md index c880a70db6b..691bd16a70c 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2979.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2979.md @@ -1,20 +1,21 @@ --- -description: "Learn more about: Compiler Error C2979" title: "Compiler Error C2979" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2979" +ms.date: 11/04/2016 f1_keywords: ["C2979"] helpviewer_keywords: ["C2979"] -ms.assetid: 98bd9043-ec44-451e-a482-3a8e35fc7464 --- # Compiler Error C2979 -explicit specializations are not supported in generics +> explicit specializations are not supported in generics + +## Remarks A generic class was declared incorrectly. See [Generics](../../extensions/generics-cpp-component-extensions.md) for more information. ## Example -The following sample generates C2979. +The following example generates C2979. ```cpp // C2979.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2988.md b/docs/error-messages/compiler-errors-2/compiler-error-c2988.md index a7abd23cc3a..06f37437baa 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2988.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2988.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Compiler Error C2988" title: "Compiler Error C2988" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2988" +ms.date: 11/04/2016 f1_keywords: ["C2988"] helpviewer_keywords: ["C2988"] -ms.assetid: c07ada8d-7cdf-4496-8656-cc3851e76b46 --- # Compiler Error C2988 -unrecognizable template declaration/definition +> unrecognizable template declaration/definition + +## Remarks The template declaration does not parse correctly. Check delimiters. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2989.md b/docs/error-messages/compiler-errors-2/compiler-error-c2989.md index 7b6991ded17..973a9e9107e 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2989.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2989.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2989" title: "Compiler Error C2989" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2989" +ms.date: 11/04/2016 f1_keywords: ["C2989"] helpviewer_keywords: ["C2989"] -ms.assetid: 936303d8-eb3b-4746-82ec-2f18020a6f64 --- # Compiler Error C2989 -'class' : class type has already been declared as a non-class type +> 'class' : class type has already been declared as a non-class type + +## Remarks The class generic or template redefines a non-template or non-generic class. Check header files for conflicts. -The following sample generates C2989: +## Examples + +The following example generates C2989: ```cpp // C2989.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2990.md b/docs/error-messages/compiler-errors-2/compiler-error-c2990.md index b0132230ba9..02ecde2c786 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2990.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2990.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2990" title: "Compiler Error C2990" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2990" +ms.date: 11/04/2016 f1_keywords: ["C2990"] helpviewer_keywords: ["C2990"] -ms.assetid: 674e9f6a-6743-4af0-a7ed-cbe11103a2f8 --- # Compiler Error C2990 -'class' : non-class type as already been declared as a class type +> 'class' : non-class type as already been declared as a class type + +## Remarks The non generic or template class redefines a generic or template class. Check header files for conflicts. -The following sample generates C2990: +## Examples + +The following example generates C2990: ```cpp // C2990.cpp @@ -35,7 +38,7 @@ ref struct GC {}; // C2990 C2990 can also occur due to a breaking change in the Microsoft C++ compiler for Visual Studio 2005; the compiler now requires that multiple declarations for the same type be identical with respect to template specification. -The following sample generates C2990: +The following example generates C2990: ```cpp // C2990c.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2991.md b/docs/error-messages/compiler-errors-2/compiler-error-c2991.md index 6a972a047e6..7b9c8c2bc13 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2991.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2991.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2991" title: "Compiler Error C2991" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2991" +ms.date: 11/04/2016 f1_keywords: ["C2991"] helpviewer_keywords: ["C2991"] -ms.assetid: a87e4404-26e8-4927-b3ee-5d02b3b8bee1 --- # Compiler Error C2991 -redefinition of type parameter 'parameter' +> redefinition of type parameter 'parameter' + +## Remarks There was a type conflict between two generic or template definitions of `parameter`. When defining multiple generic or template parameters, you must use equivalent types. -The following sample generates C2991: +## Examples + +The following example generates C2991: ```cpp // C2991.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2992.md b/docs/error-messages/compiler-errors-2/compiler-error-c2992.md index 2220dec8212..023ef93a9b3 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2992.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2992.md @@ -1,20 +1,21 @@ --- -description: "Learn more about: Compiler Error C2992" title: "Compiler Error C2992" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2992" +ms.date: 11/04/2016 f1_keywords: ["C2992"] helpviewer_keywords: ["C2992"] -ms.assetid: 01b16447-43fe-4e91-9a5a-af884a166a31 --- # Compiler Error C2992 -'class' : invalid or missing type parameter list +> 'class' : invalid or missing type parameter list + +## Remarks The class is preceded by a **`template`** or **generic** keyword with missing or invalid parameters. -## Example +## Examples -The following sample generates C2992: +The following example generates C2992: ```cpp // C2992.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2993.md b/docs/error-messages/compiler-errors-2/compiler-error-c2993.md index 3588a205e10..dc9f175046f 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2993.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2993.md @@ -1,18 +1,22 @@ --- -description: "Learn more about: Compiler Error C2993" title: "Compiler Error C2993" -ms.date: "10/03/2023" +description: "Learn more about: Compiler Error C2993" +ms.date: 10/03/2023 f1_keywords: ["C2993"] helpviewer_keywords: ["C2993"] --- # Compiler Error C2993 -'identifier' : illegal type for non-type template parameter 'parameter' +> 'identifier' : illegal type for non-type template parameter 'parameter' + +## Remarks - Prior to C++20, you cannot declare a template with a structure, class, or union argument. Pointers can be used in place of these types as template parameters. - Since C++20, structure, class, or unions *can* be used as non-type template parameters. A non-type template parameter can't be a rvalue reference type or a parameter pack of rvalue types. -The following sample generates C2993: +## Examples + +The following example generates C2993: ```cpp // compile with: /c and /std:c++17 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2994.md b/docs/error-messages/compiler-errors-2/compiler-error-c2994.md index 506170906f5..9aa9c4f11a1 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2994.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2994.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Compiler Error C2994" title: "Compiler Error C2994" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2994" +ms.date: 11/04/2016 f1_keywords: ["C2994"] helpviewer_keywords: ["C2994"] -ms.assetid: b03570b5-e5fd-41d8-bdf1-dfadc2b1e116 --- # Compiler Error C2994 -unnamed class in template parameter list +> unnamed class in template parameter list + +## Remarks You cannot use the **`class`** keyword as a template argument without specifying a class name. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2995.md b/docs/error-messages/compiler-errors-2/compiler-error-c2995.md index c720f6294c5..03f7125d169 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2995.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2995.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C2995" title: "Compiler Error C2995" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2995" +ms.date: 11/04/2016 f1_keywords: ["C2995"] helpviewer_keywords: ["C2995"] -ms.assetid: a57cdfe0-b40b-4a67-a95c-1a49ace4842b --- # Compiler Error C2995 -'function' : function template has already been defined +> 'function' : function template has already been defined + +## Remarks Make sure that there is only one definition for each member function of a templated class. -The following sample generates C2995: +## Example + +The following example generates C2995: ```cpp // C2995.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2996.md b/docs/error-messages/compiler-errors-2/compiler-error-c2996.md index d21aa58ca7f..8222baa8df3 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2996.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2996.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Compiler Error C2996" title: "Compiler Error C2996" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2996" +ms.date: 11/04/2016 f1_keywords: ["C2996"] helpviewer_keywords: ["C2996"] -ms.assetid: f0ca9f8b-1751-4182-adab-1424f0c5e0c0 --- # Compiler Error C2996 -'function' : recursive function template definition +> 'function' : recursive function template definition + +## Remarks A function definition attempts to instantiate its root templated class. Recursive template instantiations are not allowed. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c2998.md b/docs/error-messages/compiler-errors-2/compiler-error-c2998.md index 78bb2293253..f1401071122 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c2998.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c2998.md @@ -1,21 +1,14 @@ --- -description: "Learn more about: Compiler Error C2998" title: "Compiler Error C2998" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C2998" +ms.date: 06/29/2025 f1_keywords: ["C2998"] helpviewer_keywords: ["C2998"] -ms.assetid: 8193d491-b5d9-4477-acb1-cf166889c070 --- # Compiler Error C2998 -'identifier' : cannot be a template definition +> '*identifier*': cannot be a template definition -The compiler could not process the syntax used in the template definition. +## Remarks -The following sample generates C2998: - -```cpp -// C2998.cpp -// compile with: /c -template int x = 1018; // C2998 -``` +The compiler could not process the syntax used in the template definition. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3001.md b/docs/error-messages/compiler-errors-2/compiler-error-c3001.md index 8839791989f..617f88cb018 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3001.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3001.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C3001" title: "Compiler Error C3001" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3001" +ms.date: 11/04/2016 f1_keywords: ["C3001"] helpviewer_keywords: ["C3001"] -ms.assetid: d0e03478-1b44-47e5-8f5b-70415fa1f8bc --- # Compiler Error C3001 -'error_text' : expected an OpenMP directive name +> 'error_text' : expected an OpenMP directive name + +## Remarks The `omp` pragma must be followed by a directive. -The following sample generates C3001: +## Example + +The following example generates C3001: ```c // C3001.c diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3002.md b/docs/error-messages/compiler-errors-2/compiler-error-c3002.md index 0bc4652dba0..ee452060426 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3002.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3002.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C3002" title: "Compiler Error C3002" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3002" +ms.date: 11/04/2016 f1_keywords: ["C3002"] helpviewer_keywords: ["C3002"] -ms.assetid: 2d4241a7-c8eb-4d43-a128-dca255d137bc --- # Compiler Error C3002 -'name1 name2' : multiple OpenMP directive names +> 'name1 name2' : multiple OpenMP directive names + +## Remarks Multiple directive names are not allowed. -The following sample generates C3002: +## Example + +The following example generates C3002: ```c // C3002.c diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3003.md b/docs/error-messages/compiler-errors-2/compiler-error-c3003.md index 9bec4bf3c4a..c9a04e0dbb2 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3003.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3003.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C3003" title: "Compiler Error C3003" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3003" +ms.date: 11/04/2016 f1_keywords: ["C3003"] helpviewer_keywords: ["C3003"] -ms.assetid: 22e74f99-bb7f-4518-ab0d-934d5d49bcc7 --- # Compiler Error C3003 -'directive' : OpenMP directive name not allowed after directive clauses +> 'directive' : OpenMP directive name not allowed after directive clauses + +## Remarks An OpenMP directive name cannot follow an OpenMP directive clause. -The following sample generates C3003: +## Example + +The following example generates C3003: ```c // C3003.c diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3004.md b/docs/error-messages/compiler-errors-2/compiler-error-c3004.md index 47e57c17a04..7d9edc3a448 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3004.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3004.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C3004" title: "Compiler Error C3004" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3004" +ms.date: 11/04/2016 f1_keywords: ["C3004"] helpviewer_keywords: ["C3004"] -ms.assetid: 819c2b57-8366-4ca7-9135-1f0c5e5b6bb6 --- # Compiler Error C3004 -'clause' : clause not valid on OpenMP 'directive' directive +> 'clause' : clause not valid on OpenMP 'directive' directive + +## Remarks An OpenMP clause was used on a directive for which it is not enabled. -The following sample generates C3004: +## Example + +The following example generates C3004: ```c // C3004.c diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3005.md b/docs/error-messages/compiler-errors-2/compiler-error-c3005.md index 6548d72a0f2..83f3fcf62df 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3005.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3005.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C3005" title: "Compiler Error C3005" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3005" +ms.date: 11/04/2016 f1_keywords: ["C3005"] helpviewer_keywords: ["C3005"] -ms.assetid: 30bad565-e79f-4c3f-82cb-a74bd0baab8f --- # Compiler Error C3005 -'error_text' : unexpected token encountered on OpenMP 'directive' directive +> 'error_text' : unexpected token encountered on OpenMP 'directive' directive + +## Remarks An OpenMP directive was ill formed. -The following sample generates C3005: +## Examples + +The following example generates C3005: ```c // C3005.c diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3006.md b/docs/error-messages/compiler-errors-2/compiler-error-c3006.md index 13bc64c5b49..278771bdba0 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3006.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3006.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C3006" title: "Compiler Error C3006" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3006" +ms.date: 11/04/2016 f1_keywords: ["C3006"] helpviewer_keywords: ["C3006"] -ms.assetid: 449082ec-fd45-4c47-8ab3-ba6a719e4dc4 --- # Compiler Error C3006 -'clause' : clause on OpenMP 'directive' directive is missing an expected argument +> 'clause' : clause on OpenMP 'directive' directive is missing an expected argument + +## Remarks An OpenMP directive did not have an expected argument. -The following sample generates C3006: +## Example + +The following example generates C3006: ```c // C3006.c diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3007.md b/docs/error-messages/compiler-errors-2/compiler-error-c3007.md index f4d9bd13b97..a18f67035f8 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3007.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3007.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C3007" title: "Compiler Error C3007" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3007" +ms.date: 11/04/2016 f1_keywords: ["C3007"] helpviewer_keywords: ["C3007"] -ms.assetid: e415ef42-bdc9-4f32-8198-5e25b289a089 --- # Compiler Error C3007 -'arg' : clause on OpenMP 'directive' directive does not take an argument +> 'arg' : clause on OpenMP 'directive' directive does not take an argument + +## Remarks An OpenMP directive had an argument, but the directive does not take an argument. -The following sample generates C3007: +## Example + +The following example generates C3007: ```c // C3007.c diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3008.md b/docs/error-messages/compiler-errors-2/compiler-error-c3008.md index 41bbfcc6010..e9578e2930f 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3008.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3008.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C3008" title: "Compiler Error C3008" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3008" +ms.date: 11/04/2016 f1_keywords: ["C3008"] helpviewer_keywords: ["C3008"] -ms.assetid: 04d93201-28e5-4be0-945c-aad616376f4b --- # Compiler Error C3008 -'arg' : argument is missing closing ')' on OpenMP 'directive' directive +> 'arg' : argument is missing closing ')' on OpenMP 'directive' directive + +## Remarks An OpenMP directive that takes an argument did not have a closing parenthesis. -The following sample generates C3008: +## Example + +The following example generates C3008: ```c // C3008.c diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3009.md b/docs/error-messages/compiler-errors-2/compiler-error-c3009.md index 83fd8c99acc..7a3a7aa8252 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3009.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3009.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C3009" title: "Compiler Error C3009" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3009" +ms.date: 11/04/2016 f1_keywords: ["C3009"] helpviewer_keywords: ["C3009"] -ms.assetid: aded5985-f5fd-4c3e-a157-16be55ec1313 --- # Compiler Error C3009 -'label' : jump into OpenMP structured block not allowed +> 'label' : jump into OpenMP structured block not allowed + +## Remarks Code cannot jump into or out of an OpenMP block. -The following sample generates C3009: +## Example + +The following example generates C3009: ```c // C3009.c diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3010.md b/docs/error-messages/compiler-errors-2/compiler-error-c3010.md index dc715809c72..def3dcb1b98 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3010.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3010.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C3010" title: "Compiler Error C3010" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3010" +ms.date: 11/04/2016 f1_keywords: ["C3010"] helpviewer_keywords: ["C3010"] -ms.assetid: e959d038-bba6-432a-9c0a-0470474de7d9 --- # Compiler Error C3010 -'label' : jump out of OpenMP structured block not allowed +> 'label' : jump out of OpenMP structured block not allowed + +## Remarks Code cannot jump into or out of an OpenMP block. -The following sample generates C3010: +## Example + +The following example generates C3010: ```c // C3010.c diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3011.md b/docs/error-messages/compiler-errors-2/compiler-error-c3011.md index 830e14b0863..65e8f9cd82b 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3011.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3011.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C3011" title: "Compiler Error C3011" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3011" +ms.date: 11/04/2016 f1_keywords: ["C3011"] helpviewer_keywords: ["C3011"] -ms.assetid: 24c3a917-ebff-4deb-9155-23adf6468531 --- # Compiler Error C3011 -inline assembly not allowed directly within a parallel region +> inline assembly not allowed directly within a parallel region + +## Remarks An `omp` parallel region cannot contain inline assembly instructions. -The following sample generates C3011: +## Example + +The following example generates C3011: ```cpp // C3011.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3012.md b/docs/error-messages/compiler-errors-2/compiler-error-c3012.md index 8754ce80f9b..e6abf61a319 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3012.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3012.md @@ -1,20 +1,21 @@ --- -description: "Learn more about: Compiler Error C3012" title: "Compiler Error C3012" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3012" +ms.date: 11/04/2016 f1_keywords: ["C3012"] helpviewer_keywords: ["C3012"] -ms.assetid: cc7040b1-b3fb-4da6-a474-877914d30332 --- # Compiler Error C3012 > '*intrinsic*' : intrinsic function not allowed directly within a parallel region +## Remarks + A [compiler intrinsic](../../intrinsics/compiler-intrinsics.md) function is not allowed in an `omp parallel` region. To fix this issue, move intrinsics out of the region, or replace them with non-intrinsic equivalents. ## Example -The following sample generates C3012, and shows one way to fix it: +The following example generates C3012, and shows one way to fix it: ```cpp // C3012.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3013.md b/docs/error-messages/compiler-errors-2/compiler-error-c3013.md index cd9019d1f11..744d28b348c 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3013.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3013.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C3013" title: "Compiler Error C3013" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3013" +ms.date: 11/04/2016 f1_keywords: ["C3013"] helpviewer_keywords: ["C3013"] -ms.assetid: f896777d-27e6-4b6d-baab-1567317f3374 --- # Compiler Error C3013 -'clause' : clause may only appear once on OpenMP 'directive' directive +> 'clause' : clause may only appear once on OpenMP 'directive' directive + +## Remarks A clause appeared twice on the same directive. Delete one occurrence of the clause. -The following sample generates C3013: +## Example + +The following example generates C3013: ```cpp // C3013.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3014.md b/docs/error-messages/compiler-errors-2/compiler-error-c3014.md index 6f59ffd243c..b57685ca12d 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3014.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3014.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C3014" title: "Compiler Error C3014" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3014" +ms.date: 11/04/2016 f1_keywords: ["C3014"] helpviewer_keywords: ["C3014"] -ms.assetid: af1c5b0c-dbf9-4274-b06a-c6c2cdcf2a52 --- # Compiler Error C3014 -expected a for loop following OpenMP 'directive' directive +> expected a for loop following OpenMP 'directive' directive + +## Remarks It is an error for anything other than a **`for`** loop to immediately follow a `#pragma omp for` directive. -The following sample generates C3014: +## Example + +The following example generates C3014: ```cpp // C3014.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3015.md b/docs/error-messages/compiler-errors-2/compiler-error-c3015.md index cbc3d828a33..57be2b65cd9 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3015.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3015.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C3015" title: "Compiler Error C3015" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3015" +ms.date: 11/04/2016 f1_keywords: ["C3015"] helpviewer_keywords: ["C3015"] -ms.assetid: d5e8e50b-7542-4b2d-8665-1b22072a5bc6 --- # Compiler Error C3015 -initialization in OpenMP 'for' statement has improper form +> initialization in OpenMP 'for' statement has improper form + +## Remarks A **`for`** loop in an OpenMP statement must be fully and explicitly specified. -The following sample generates C3015: +## Example + +The following example generates C3015: ```cpp // C3015.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3016.md b/docs/error-messages/compiler-errors-2/compiler-error-c3016.md index ef990e16bb7..4da397545bc 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3016.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3016.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C3016" title: "Compiler Error C3016" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3016" +ms.date: 11/04/2016 f1_keywords: ["C3016"] helpviewer_keywords: ["C3016"] -ms.assetid: 3423467e-e8bb-4f35-b4db-7925cafa74c1 --- # Compiler Error C3016 -'var' : index variable in OpenMP 'for' statement must have signed integral type +> 'var' : index variable in OpenMP 'for' statement must have signed integral type + +## Remarks The index variable in an OpenMP **`for`** statement must be a signed integral type. -The following sample generates C3016: +## Example + +The following example generates C3016: ```cpp // C3016.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3017.md b/docs/error-messages/compiler-errors-2/compiler-error-c3017.md index 35ffc5aecf9..5a9bcff8460 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3017.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3017.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C3017" title: "Compiler Error C3017" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3017" +ms.date: 11/04/2016 f1_keywords: ["C3017"] helpviewer_keywords: ["C3017"] -ms.assetid: 12ab2c2a-d0d2-4900-9cbf-39be0af590dd --- # Compiler Error C3017 -termination test in OpenMP 'for' statement has improper form +> termination test in OpenMP 'for' statement has improper form + +## Remarks A **`for`** loop in an OpenMP statement must be fully and explicitly specified. -The following sample generates C3017: +## Example + +The following example generates C3017: ```cpp // C3017.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3018.md b/docs/error-messages/compiler-errors-2/compiler-error-c3018.md index 9843c07518c..4dc33cbf6a4 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3018.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3018.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C3018" title: "Compiler Error C3018" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3018" +ms.date: 11/04/2016 f1_keywords: ["C3018"] helpviewer_keywords: ["C3018"] -ms.assetid: 685be45f-f116-43a8-a88d-05ab6616e2f1 --- # Compiler Error C3018 -'var1' : OpenMP 'for' test or increment must use index variable 'var2' +> 'var1' : OpenMP 'for' test or increment must use index variable 'var2' + +## Remarks A **`for`** loop in an OpenMP statement must use the same variable for its test and increment as it uses for its index. -The following sample generates C3018: +## Example + +The following example generates C3018: ```cpp // C3018.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3019.md b/docs/error-messages/compiler-errors-2/compiler-error-c3019.md index 72a6e03a165..ad39fe669ac 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3019.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3019.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C3019" title: "Compiler Error C3019" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3019" +ms.date: 11/04/2016 f1_keywords: ["C3019"] helpviewer_keywords: ["C3019"] -ms.assetid: 31a6d9b6-d29f-4499-9ad8-48dd751e87c7 --- # Compiler Error C3019 -increment in OpenMP 'for' statement has improper form +> increment in OpenMP 'for' statement has improper form + +## Remarks The increment part of an OpenMP **`for`** loop must use the index variable both on the left and right side of the operator. -The following sample generates C3019: +## Example + +The following example generates C3019: ```cpp // C3019.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3020.md b/docs/error-messages/compiler-errors-2/compiler-error-c3020.md index 4f67e28e54e..ca7e3d3f787 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3020.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3020.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C3020" title: "Compiler Error C3020" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3020" +ms.date: 11/04/2016 f1_keywords: ["C3020"] helpviewer_keywords: ["C3020"] -ms.assetid: f625c7a3-afaa-4bd8-9c1b-51891b832f36 --- # Compiler Error C3020 -'var' : index variable of OpenMP 'for' loop cannot be modified in loop body +> 'var' : index variable of OpenMP 'for' loop cannot be modified in loop body + +## Remarks An OpenMP **`for`** loop may not modify the index (loop counter) in the body of the **`for`** loop. -The following sample generates C3020: +## Examples + +The following example generates C3020: ```cpp // C3020.cpp @@ -33,7 +36,7 @@ int main() { A variable declared with [lastprivate](../../parallel/openmp/reference/openmp-clauses.md#lastprivate) cannot be used as the index inside a parallelized loop. -The following sample will give C3020 for the second lastprivate because that lastprivate will trigger a write to idx_a within the outermost for loop. The first lastprivate doesn't give an error because that lastprivate triggers a write to idx_a outside the outermost for loop (technically, at the very end of the last iteration). The following sample generates C3020. +The following example will give C3020 for the second lastprivate because that lastprivate will trigger a write to idx_a within the outermost for loop. The first lastprivate doesn't give an error because that lastprivate triggers a write to idx_a outside the outermost for loop (technically, at the very end of the last iteration). The following example generates C3020. ```cpp // C3020b.cpp @@ -52,7 +55,7 @@ void test(int first, int last) } ``` -The following sample demonstrates a possible resolution: +The following example demonstrates a possible resolution: ```cpp // C3020c.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3021.md b/docs/error-messages/compiler-errors-2/compiler-error-c3021.md index 5a016f5608e..c144f991470 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3021.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3021.md @@ -1,20 +1,21 @@ --- -description: "Learn more about: Compiler Error C3021" title: "Compiler Error C3021" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3021" +ms.date: 11/04/2016 f1_keywords: ["C3021"] helpviewer_keywords: ["C3021"] -ms.assetid: 0cef6d97-e267-438a-ac8b-0daf5bbbc2cf --- # Compiler Error C3021 -'arg' : argument is empty on OpenMP directive 'directive' +> 'arg' : argument is empty on OpenMP directive 'directive' + +## Remarks An argument is required for an OpenMP directive. ## Example -The following sample generates C3021: +The following example generates C3021: ```cpp // C3021.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3022.md b/docs/error-messages/compiler-errors-2/compiler-error-c3022.md index ca6749b8abb..a833519ab11 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3022.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3022.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C3022" title: "Compiler Error C3022" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3022" +ms.date: 11/04/2016 f1_keywords: ["C3022"] helpviewer_keywords: ["C3022"] -ms.assetid: 9f1d444c-6c6e-48d9-9346-69128390aa33 --- # Compiler Error C3022 -'clause' : invalid schedule kind of 'value' on OpenMP 'directive' directive +> 'clause' : invalid schedule kind of 'value' on OpenMP 'directive' directive + +## Remarks An unsupported value was passed to a clause. -The following sample generates C3022: +## Example + +The following example generates C3022: ```cpp // C3022.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3023.md b/docs/error-messages/compiler-errors-2/compiler-error-c3023.md index 5cc79ab4b52..76419763f3a 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3023.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3023.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C3023" title: "Compiler Error C3023" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3023" +ms.date: 11/04/2016 f1_keywords: ["C3023"] helpviewer_keywords: ["C3023"] -ms.assetid: 89dcce98-3cd7-4931-a50f-87df1d2ebc9b --- # Compiler Error C3023 -'value' : unexpected token encountered in argument to OpenMP 'clause' clause +> 'value' : unexpected token encountered in argument to OpenMP 'clause' clause + +## Remarks The values passed to a clause were not valid. -The following sample generates C3023: +## Example + +The following example generates C3023: ```cpp // C3023.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3024.md b/docs/error-messages/compiler-errors-2/compiler-error-c3024.md index a9c91358b3c..4fd7152b8fb 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3024.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3024.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C3024" title: "Compiler Error C3024" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3024" +ms.date: 11/04/2016 f1_keywords: ["C3024"] helpviewer_keywords: ["C3024"] -ms.assetid: 1c031c28-ce37-4de3-aead-cfe76b261856 --- # Compiler Error C3024 -'schedule(runtime)' : chunk_size expression is not allowed +> 'schedule(runtime)' : chunk_size expression is not allowed + +## Remarks A value cannot be passed to the run-time parameter of the schedule clause. -The following sample generates C3024: +## Example + +The following example generates C3024: ```cpp // C3024.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3025.md b/docs/error-messages/compiler-errors-2/compiler-error-c3025.md index ef52fb54153..5f8148aa80d 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3025.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3025.md @@ -1,20 +1,21 @@ --- -description: "Learn more about: Compiler Error C3025" title: "Compiler Error C3025" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3025" +ms.date: 11/04/2016 f1_keywords: ["C3025"] helpviewer_keywords: ["C3025"] -ms.assetid: 4442f5a3-d9ea-4873-b1fb-e7e5bd3cbe5e --- # Compiler Error C3025 -'clause' : integral expression expected +> 'clause' : integral expression expected + +## Remarks A clause requires an integer expression but was given a noninteger expression. ## Example -The following sample generates C3025. +The following example generates C3025. ```cpp // C3025.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3026.md b/docs/error-messages/compiler-errors-2/compiler-error-c3026.md index cf7c5487239..458980db4a8 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3026.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3026.md @@ -1,20 +1,21 @@ --- -description: "Learn more about: Compiler Error C3026" title: "Compiler Error C3026" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3026" +ms.date: 11/04/2016 f1_keywords: ["C3026"] helpviewer_keywords: ["C3026"] -ms.assetid: 3297060e-cc5b-4600-a2db-09bfc4ffa21f --- # Compiler Error C3026 -'clause' : constant expression must be positive +> 'clause' : constant expression must be positive + +## Remarks A clause was passed an integer value, but the value was not a positive number. The number must be positive. ## Example -The following sample generates C3026: +The following example generates C3026: ```cpp // C3026.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3027.md b/docs/error-messages/compiler-errors-2/compiler-error-c3027.md index 8276f6de600..853563e4b62 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3027.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3027.md @@ -1,20 +1,21 @@ --- -description: "Learn more about: Compiler Error C3027" title: "Compiler Error C3027" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3027" +ms.date: 11/04/2016 f1_keywords: ["C3027"] helpviewer_keywords: ["C3027"] -ms.assetid: 6562a5c2-2f28-4b36-91ca-2a64c0f0501a --- # Compiler Error C3027 -'clause' : arithmetic or pointer expression expected +> 'clause' : arithmetic or pointer expression expected + +## Remarks A clause that requires an arithmetic or pointer expression was passed another kind of expression. ## Example -The following sample generates C3027: +The following example generates C3027: ```cpp // C3027.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3028.md b/docs/error-messages/compiler-errors-2/compiler-error-c3028.md index d64d33f2004..c4a24a6afbe 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3028.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3028.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C3028" title: "Compiler Error C3028" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3028" +ms.date: 11/04/2016 f1_keywords: ["C3028"] helpviewer_keywords: ["C3028"] -ms.assetid: 175e697f-8e8f-492a-8456-6240ffbbb900 --- # Compiler Error C3028 -'member' : only a variable or static data member can be used in a data-sharing clause +> 'member' : only a variable or static data member can be used in a data-sharing clause + +## Remarks A symbol other than a variable or static data member was passed to the reduction clause. -The following sample generates C3028: +## Example + +The following example generates C3028: ```cpp // C3028.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3029.md b/docs/error-messages/compiler-errors-2/compiler-error-c3029.md index 8b2b019ed48..a92c60fda2a 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3029.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3029.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C3029" title: "Compiler Error C3029" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3029" +ms.date: 11/04/2016 f1_keywords: ["C3029"] helpviewer_keywords: ["C3029"] -ms.assetid: 655eb04d-504a-468d-8c0c-bda1e5f297b7 --- # Compiler Error C3029 -'symbol' : can only appear once in data-sharing clauses in an OpenMP directive +> 'symbol' : can only appear once in data-sharing clauses in an OpenMP directive + +## Remarks A symbol was used more than once in one or more clauses in a directive. The symbol can only be used once in the directive. -The following sample generates C3029: +## Example + +The following example generates C3029: ```cpp // C3029.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3030.md b/docs/error-messages/compiler-errors-2/compiler-error-c3030.md index daf295ebe76..96dde7dad6e 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3030.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3030.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C3030" title: "Compiler Error C3030" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3030" +ms.date: 11/04/2016 f1_keywords: ["C3030"] helpviewer_keywords: ["C3030"] -ms.assetid: de92fd7e-29ba-46e8-b43b-f4b985cd74de --- # Compiler Error C3030 -'var' : variable in 'reduction' clause/directive cannot have reference type +> 'var' : variable in 'reduction' clause/directive cannot have reference type + +## Remarks You can only pass value parameters to certain clauses, such as the reduction clause. -The following sample generates C3030: +## Example + +The following example generates C3030: ```cpp // C3030.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3031.md b/docs/error-messages/compiler-errors-2/compiler-error-c3031.md index ad1689a82f3..583e25e206f 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3031.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3031.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C3031" title: "Compiler Error C3031" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3031" +ms.date: 11/04/2016 f1_keywords: ["C3031"] helpviewer_keywords: ["C3031"] -ms.assetid: 7e621e7e-eda7-45b5-8836-29599cd05255 --- # Compiler Error C3031 -'var' : variable in 'reduction' clause must have scalar arithmetic type +> 'var' : variable in 'reduction' clause must have scalar arithmetic type + +## Remarks A variable of the wrong type was passed to a reduction clause. -The following sample generates C3031: +## Example + +The following example generates C3031: ```cpp // C3031.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3032.md b/docs/error-messages/compiler-errors-2/compiler-error-c3032.md index 0feba15df8c..02ada4cb731 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3032.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3032.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C3032" title: "Compiler Error C3032" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3032" +ms.date: 11/04/2016 f1_keywords: ["C3032"] helpviewer_keywords: ["C3032"] -ms.assetid: 6a92bd8e-319f-4a99-aef4-a9021f6f9928 --- # Compiler Error C3032 -'var' : variable in 'clause' clause cannot have incomplete type 'type' +> 'var' : variable in 'clause' clause cannot have incomplete type 'type' + +## Remarks Types passed to certain clauses must be fully visible to the compiler. -The following sample generates C3032: +## Example + +The following example generates C3032: ```cpp // C3032.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3033.md b/docs/error-messages/compiler-errors-2/compiler-error-c3033.md index b1dcebc9f78..420ba6376bd 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3033.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3033.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C3033" title: "Compiler Error C3033" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3033" +ms.date: 11/04/2016 f1_keywords: ["C3033"] helpviewer_keywords: ["C3033"] -ms.assetid: 8628b6bb-a650-4ed2-af13-57acd2f7ddbb --- # Compiler Error C3033 -'var' : variable in 'clause' clause cannot have const-qualified type +> 'var' : variable in 'clause' clause cannot have const-qualified type + +## Remarks Values passed to certain clauses cannot be **`const`** variables. -The following sample generates C3033: +## Example + +The following example generates C3033: ```cpp // C3033.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3034.md b/docs/error-messages/compiler-errors-2/compiler-error-c3034.md index c6581ba1b3e..9d76496fe4f 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3034.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3034.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C3034" title: "Compiler Error C3034" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3034" +ms.date: 11/04/2016 f1_keywords: ["C3034"] helpviewer_keywords: ["C3034"] -ms.assetid: 49db8bac-2720-4622-94e3-7988f1603fa3 --- # Compiler Error C3034 -OpenMP 'directive1' directive cannot be directly nested within 'directive2' directive +> OpenMP 'directive1' directive cannot be directly nested within 'directive2' directive + +## Remarks Some directives cannot be nested. To fix this error, you can merge the statements of both directives into the block of one directive, or you can construct consecutive directives. -The following sample generates C3034: +## Example + +The following example generates C3034: ```cpp // C3034.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3035.md b/docs/error-messages/compiler-errors-2/compiler-error-c3035.md index 3fcf1e25f17..fd2006a31d5 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3035.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3035.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C3035" title: "Compiler Error C3035" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3035" +ms.date: 11/04/2016 f1_keywords: ["C3035"] helpviewer_keywords: ["C3035"] -ms.assetid: af34fad2-2b45-42d0-a9ff-04eab3e91c37 --- # Compiler Error C3035 -OpenMP 'ordered' directive must bind directly to a 'for' or 'parallel for' directive with the 'ordered' clause +> OpenMP 'ordered' directive must bind directly to a 'for' or 'parallel for' directive with the 'ordered' clause + +## Remarks An ordered clause was ill formed. -The following sample generates C3035: +## Example + +The following example generates C3035: ```cpp // C3035.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3036.md b/docs/error-messages/compiler-errors-2/compiler-error-c3036.md index 597adf0ff4f..0584a878e54 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3036.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3036.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C3036" title: "Compiler Error C3036" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3036" +ms.date: 11/04/2016 f1_keywords: ["C3036"] helpviewer_keywords: ["C3036"] -ms.assetid: 10c6993e-bc42-4a07-85c7-cdc34ac30906 --- # Compiler Error C3036 -'operator' : invalid operator token in OpenMP 'reduction' clause +> 'operator' : invalid operator token in OpenMP 'reduction' clause + +## Remarks A [reduction](../../parallel/openmp/reference/openmp-clauses.md#reduction) clause was not specified correctly. -The following sample generates C3036: +## Example + +The following example generates C3036: ```cpp // C3036.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3037.md b/docs/error-messages/compiler-errors-2/compiler-error-c3037.md index 13cb9a96f50..fce1f7b9649 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3037.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3037.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C3037" title: "Compiler Error C3037" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3037" +ms.date: 11/04/2016 f1_keywords: ["C3037"] helpviewer_keywords: ["C3037"] -ms.assetid: 9ba8a890-d3c7-4cce-93c5-d358e2bfad28 --- # Compiler Error C3037 -'var' : variable in 'reduction' clause must be shared in enclosing context +> 'var' : variable in 'reduction' clause must be shared in enclosing context + +## Remarks A variable specified in a [reduction](../../parallel/openmp/reference/openmp-clauses.md#reduction) clause may not be private to each thread in the context. -The following sample generates C3037: +## Example + +The following example generates C3037: ```cpp // C3037.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3038.md b/docs/error-messages/compiler-errors-2/compiler-error-c3038.md index 1219fcdd1e3..9819029d531 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3038.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3038.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C3038" title: "Compiler Error C3038" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3038" +ms.date: 11/04/2016 f1_keywords: ["C3038"] helpviewer_keywords: ["C3038"] -ms.assetid: 140ada3e-5636-43ef-a4ee-22a9f66a771f --- # Compiler Error C3038 -'var' : variable in 'private' clause cannot be a reduction variable in enclosing context +> 'var' : variable in 'private' clause cannot be a reduction variable in enclosing context + +## Remarks Variables that appear in the [reduction](../../parallel/openmp/reference/openmp-clauses.md#reduction) clause of a parallel directive cannot be specified in a [private](../../parallel/openmp/reference/openmp-clauses.md#private-openmp) clause on a work-sharing directive that binds to the parallel construct. -The following sample generates C3038: +## Example + +The following example generates C3038: ```cpp // C3038.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3039.md b/docs/error-messages/compiler-errors-2/compiler-error-c3039.md index c5029592752..92bc1abf4be 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3039.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3039.md @@ -1,20 +1,21 @@ --- -description: "Learn more about: Compiler Error C3039" title: "Compiler Error C3039" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3039" +ms.date: 11/04/2016 f1_keywords: ["C3039"] helpviewer_keywords: ["C3039"] -ms.assetid: 02776f16-f57a-4ffd-b7f7-9c696b633e08 --- # Compiler Error C3039 -'var' : index variable in OpenMP 'for' statement cannot be a reduction variable +> 'var' : index variable in OpenMP 'for' statement cannot be a reduction variable + +## Remarks An index variable is implicitly private, so the variable cannot be used in a [reduction](../../parallel/openmp/reference/openmp-clauses.md#reduction) clause in the enclosing [parallel](../../parallel/openmp/reference/openmp-directives.md#parallel) directive. ## Example -The following sample generates C3039: +The following example generates C3039: ```cpp // C3039.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3040.md b/docs/error-messages/compiler-errors-2/compiler-error-c3040.md index 33c117e5f43..82f04a80bcd 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3040.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3040.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C3040" title: "Compiler Error C3040" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3040" +ms.date: 11/04/2016 f1_keywords: ["C3040"] helpviewer_keywords: ["C3040"] -ms.assetid: 29e857ac-74f0-4ec6-becf-9026e38c160e --- # Compiler Error C3040 -'var' : type of variable in 'reduction' clause is incompatible with reduction operator 'operator' +> 'var' : type of variable in 'reduction' clause is incompatible with reduction operator 'operator' + +## Remarks A variable in a [reduction](../../parallel/openmp/reference/openmp-clauses.md#reduction) clause cannot be used with the reduction operator. -The following sample generates C3040: +## Example + +The following example generates C3040: ```cpp // C3040.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3041.md b/docs/error-messages/compiler-errors-2/compiler-error-c3041.md index fb2a1a285d7..5c60eb3ff1a 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3041.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3041.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C3041" title: "Compiler Error C3041" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3041" +ms.date: 11/04/2016 f1_keywords: ["C3041"] helpviewer_keywords: ["C3041"] -ms.assetid: 9df1ae44-3ac7-4c6c-899f-f35ffe7ccf0d --- # Compiler Error C3041 -'var' : variable in 'copyprivate' clause must be private in enclosing context +> 'var' : variable in 'copyprivate' clause must be private in enclosing context + +## Remarks A variable passed to [copyprivate](../../parallel/openmp/reference/openmp-clauses.md#copyprivate) cannot be shared in the enclosing context. -The following sample generates C3041: +## Example + +The following example generates C3041: ```cpp // C3041.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3042.md b/docs/error-messages/compiler-errors-2/compiler-error-c3042.md index ba13716ff03..8b52b9ae987 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3042.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3042.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C3042" title: "Compiler Error C3042" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3042" +ms.date: 11/04/2016 f1_keywords: ["C3042"] helpviewer_keywords: ["C3042"] -ms.assetid: bf73f61e-5bd2-40a8-9b06-6244e6a15a41 --- # Compiler Error C3042 -'copyprivate' and 'nowait' clauses cannot appear together on OpenMP 'directive' directive +> 'copyprivate' and 'nowait' clauses cannot appear together on OpenMP 'directive' directive + +## Remarks The [copyprivate](../../parallel/openmp/reference/openmp-clauses.md#copyprivate) and [nowait](../../parallel/openmp/reference/openmp-clauses.md#nowait) clauses are mutually exclusive on the specified directive. To fix this error, remove one or both of the `copyprivate` or `nowait` clauses. -The following sample generates C3042: +## Example + +The following example generates C3042: ```cpp // C3042.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3043.md b/docs/error-messages/compiler-errors-2/compiler-error-c3043.md index 2e2a807aa5e..ceb6883d661 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3043.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3043.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C3043" title: "Compiler Error C3043" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3043" +ms.date: 11/04/2016 f1_keywords: ["C3043"] helpviewer_keywords: ["C3043"] -ms.assetid: 0ef55e63-e82b-48eb-9d44-690950ac34c6 --- # Compiler Error C3043 -OpenMP 'critical' directive cannot be nested in 'critical' directive with same name +> OpenMP 'critical' directive cannot be nested in 'critical' directive with same name + +## Remarks A [critical](../../parallel/openmp/reference/openmp-directives.md#critical) directive cannot be nested in a `critical` directive that uses the same name. -The following sample generates C3043: +## Example + +The following example generates C3043: ```cpp // C3043.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3044.md b/docs/error-messages/compiler-errors-2/compiler-error-c3044.md index 26b146188d2..ae3ed18c230 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3044.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3044.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C3044" title: "Compiler Error C3044" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3044" +ms.date: 11/04/2016 f1_keywords: ["C3044"] helpviewer_keywords: ["C3044"] -ms.assetid: 9f3e25b2-4676-49ab-97bf-6c88cd0fa377 --- # Compiler Error C3044 -'section' : only allowed directly nested under an OpenMP 'sections' directive +> 'section' : only allowed directly nested under an OpenMP 'sections' directive + +## Remarks The compiler found a `section` directive was used incorrectly. For more information, see [sections](../../parallel/openmp/reference/openmp-directives.md#sections-openmp). -The following sample generates C3044: +## Example + +The following example generates C3044: ```cpp // C3044.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3045.md b/docs/error-messages/compiler-errors-2/compiler-error-c3045.md index 67891c401ee..6c59aff18d6 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3045.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3045.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C3045" title: "Compiler Error C3045" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3045" +ms.date: 11/04/2016 f1_keywords: ["C3045"] helpviewer_keywords: ["C3045"] -ms.assetid: 9351ba3e-3d3f-455f-ac90-a810fa9fd947 --- # Compiler Error C3045 -Expected a compound statement following OpenMP 'sections' directive. Missing '{' +> Expected a compound statement following OpenMP 'sections' directive. Missing '{' + +## Remarks A code block delimited by braces must follow a [sections](../../parallel/openmp/reference/openmp-directives.md#sections-openmp) directive. -The following sample generates C3045: +## Example + +The following example generates C3045: ```cpp // C3045.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3046.md b/docs/error-messages/compiler-errors-2/compiler-error-c3046.md index da74cf83c76..3633da04abd 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3046.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3046.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C3046" title: "Compiler Error C3046" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3046" +ms.date: 11/04/2016 f1_keywords: ["C3046"] helpviewer_keywords: ["C3046"] -ms.assetid: 2e53d835-faa1-4ec0-9807-41f3dc552635 --- # Compiler Error C3046 -Missing structured block in an OpenMP '#pragma omp sections' region +> Missing structured block in an OpenMP '#pragma omp sections' region + +## Remarks A [sections](../../parallel/openmp/reference/openmp-directives.md#sections-openmp) directive has an empty code block. -The following sample generates C3046: +## Example + +The following example generates C3046: ```cpp // C3046.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3047.md b/docs/error-messages/compiler-errors-2/compiler-error-c3047.md index 33412373c1d..850e45397bb 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3047.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3047.md @@ -1,20 +1,23 @@ --- -description: "Learn more about: Compiler Error C3047" title: "Compiler Error C3047" +description: "Learn more about: Compiler Error C3047" ms.date: 06/01/2022 f1_keywords: ["C3047"] helpviewer_keywords: ["C3047"] -ms.assetid: 91c14566-5958-433d-8549-0e8bc3196f76 --- # Compiler Error C3047 > Structured block in an OpenMP 'sections' region must be preceded by '#pragma omp section' +## Remarks + Any code in a code block introduced by a [sections](../../parallel/openmp/reference/openmp-directives.md#sections-openmp) directive must be in a code block introduced by a `section` directive. This error is obsolete in Visual Studio 2022 and later versions. -The following sample generates C3047: +## Example + +The following example generates C3047: ```cpp // C3047.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3048.md b/docs/error-messages/compiler-errors-2/compiler-error-c3048.md index 62ceeb6d4e4..20c553cc781 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3048.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3048.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C3048" title: "Compiler Error C3048" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3048" +ms.date: 11/04/2016 f1_keywords: ["C3048"] helpviewer_keywords: ["C3048"] -ms.assetid: 48e07091-94d9-471d-befe-7e2507631edd --- # Compiler Error C3048 -Expression following '#pragma omp atomic' has improper form +> Expression following '#pragma omp atomic' has improper form + +## Remarks An atomic directive was incorrectly specified. -The following sample generates C3048: +## Example + +The following example generates C3048: ```cpp // C3048.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3049.md b/docs/error-messages/compiler-errors-2/compiler-error-c3049.md index 3b87b0f3746..b89c25bb6dc 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3049.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3049.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C3049" title: "Compiler Error C3049" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3049" +ms.date: 11/04/2016 f1_keywords: ["C3049"] helpviewer_keywords: ["C3049"] -ms.assetid: 6ddf54f6-2c30-4d04-b637-98c6c922c533 --- # Compiler Error C3049 -'arg' : invalid argument in OpenMP 'default' clause +> 'arg' : invalid argument in OpenMP 'default' clause + +## Remarks An incorrect value was passed to a [default](../../parallel/openmp/reference/openmp-clauses.md#default-openmp) clause. -The following sample generates C3049: +## Example + +The following example generates C3049: ```cpp // C3049.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3050.md b/docs/error-messages/compiler-errors-2/compiler-error-c3050.md index 95167d41bce..853b205551f 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3050.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3050.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C3050" title: "Compiler Error C3050" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3050" +ms.date: 11/04/2016 f1_keywords: ["C3050"] helpviewer_keywords: ["C3050"] -ms.assetid: ee090a0b-29cc-4215-a2f9-d82af79b8e82 --- # Compiler Error C3050 -'type1' : a ref class cannot inherit from 'type1' +> 'type1' : a ref class cannot inherit from 'type1' + +## Remarks `System::ValueType` cannot be a base class for a reference type. -The following sample generates C3050: +## Example + +The following example generates C3050: ```cpp // C3050.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3052.md b/docs/error-messages/compiler-errors-2/compiler-error-c3052.md index 2eaaa547883..57d7f03c1d8 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3052.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3052.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C3052" title: "Compiler Error C3052" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3052" +ms.date: 11/04/2016 f1_keywords: ["C3052"] helpviewer_keywords: ["C3052"] -ms.assetid: 87480c42-1ceb-4775-8d20-88c54a7bb6a6 --- # Compiler Error C3052 -'var' : variable doesn't appear in a data-sharing clause under a default(none) clause +> 'var' : variable doesn't appear in a data-sharing clause under a default(none) clause + +## Remarks If [default(none)](../../parallel/openmp/reference/openmp-clauses.md#default-openmp) is used, any variable used in the structured block must be explicitly specified as either [shared](../../parallel/openmp/reference/openmp-clauses.md#shared-openmp) or [private](../../parallel/openmp/reference/openmp-clauses.md#private-openmp). -The following sample generates C3052: +## Example + +The following example generates C3052: ```cpp // C3052.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3053.md b/docs/error-messages/compiler-errors-2/compiler-error-c3053.md index e2ca4233799..62bcc0b3055 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3053.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3053.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C3053" title: "Compiler Error C3053" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3053" +ms.date: 11/04/2016 f1_keywords: ["C3053"] helpviewer_keywords: ["C3053"] -ms.assetid: ab9a25f3-e341-4f6e-8e69-069b4a963a64 --- # Compiler Error C3053 -'symbol' : 'threadprivate' is only valid for global or static data items +> 'symbol' : 'threadprivate' is only valid for global or static data items + +## Remarks Symbols passed to [threadprivate](../../parallel/openmp/reference/openmp-directives.md#threadprivate) must either be global or static. -The following sample generates C3053: +## Example + +The following example generates C3053: ```cpp // C3053.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3054.md b/docs/error-messages/compiler-errors-2/compiler-error-c3054.md index 4961c563e50..be1a516fcf8 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3054.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3054.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3054" title: "Compiler Error C3054" +description: "Learn more about: Compiler Error C3054" ms.date: 06/01/2022 f1_keywords: ["C3054"] helpviewer_keywords: ["C3054"] -ms.assetid: 6f4b7ac5-0d12-474b-b611-76ff26ee41ac --- # Compiler Error C3054 @@ -18,7 +17,7 @@ This error is obsolete in Visual Studio 2022 and later versions. ## Example -The following sample generates C3054. +The following example generates C3054. ```cpp // C3054.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3055.md b/docs/error-messages/compiler-errors-2/compiler-error-c3055.md index a3e046633f4..c27fbebbe56 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3055.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3055.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C3055" title: "Compiler Error C3055" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3055" +ms.date: 11/04/2016 f1_keywords: ["C3055"] helpviewer_keywords: ["C3055"] -ms.assetid: 60446ee0-18dd-48fc-9059-f0a14229dce8 --- # Compiler Error C3055 -'symbol' : symbol cannot be referenced before it is used in 'threadprivate' directive +> 'symbol' : symbol cannot be referenced before it is used in 'threadprivate' directive + +## Remarks A symbol was referenced and then used in a [threadprivate](../../parallel/openmp/reference/openmp-directives.md#threadprivate) clause, which is not allowed. -The following sample generates C3055: +## Example + +The following example generates C3055: ```cpp // C3055.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3056.md b/docs/error-messages/compiler-errors-2/compiler-error-c3056.md index cf9e92e01a6..48b72cc3463 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3056.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3056.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C3056" title: "Compiler Error C3056" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3056" +ms.date: 11/04/2016 f1_keywords: ["C3056"] helpviewer_keywords: ["C3056"] -ms.assetid: 9500173d-870b-49b3-8e88-0ee93586d19a --- # Compiler Error C3056 -'symbol' : symbol is not in the same scope with 'threadprivate' directive +> 'symbol' : symbol is not in the same scope with 'threadprivate' directive + +## Remarks A symbol used in a [threadprivate](../../parallel/openmp/reference/openmp-directives.md#threadprivate) clause must be in the same scope as the `threadprivate` clause. -The following sample generates C3056: +## Example + +The following example generates C3056: ```cpp // C3056.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3057.md b/docs/error-messages/compiler-errors-2/compiler-error-c3057.md index e2b10e3f31f..009ad60d670 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3057.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3057.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C3057" title: "Compiler Error C3057" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3057" +ms.date: 11/04/2016 f1_keywords: ["C3057"] helpviewer_keywords: ["C3057"] -ms.assetid: b0b2ba88-9c74-4bec-bf60-8fc72eade34c --- # Compiler Error C3057 -'symbol' : dynamic initialization of 'threadprivate' symbols is not currently supported +> 'symbol' : dynamic initialization of 'threadprivate' symbols is not currently supported + +## Remarks The initialized value of a symbol used in a [threadprivate](../../parallel/openmp/reference/openmp-directives.md#threadprivate) clause must be known at compile time. -The following sample generates C3057: +## Examples + +The following example generates C3057: ```cpp // C3057.cpp @@ -38,7 +41,7 @@ int main() { } ``` -The following sample generates C3057: +The following example generates C3057: ```cpp // C3057b.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3058.md b/docs/error-messages/compiler-errors-2/compiler-error-c3058.md index 2e52864c0de..b02ea0b7cd4 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3058.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3058.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C3058" title: "Compiler Error C3058" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3058" +ms.date: 11/04/2016 f1_keywords: ["C3058"] helpviewer_keywords: ["C3058"] -ms.assetid: 669d08c8-0b58-4351-88aa-c6e6e1af481c --- # Compiler Error C3058 -'symbol' : symbol not declared as 'threadprivate' before it is used in the 'copyin' clause +> 'symbol' : symbol not declared as 'threadprivate' before it is used in the 'copyin' clause + +## Remarks A symbol must first be declared [threadprivate](../../parallel/openmp/reference/openmp-directives.md#threadprivate) before it can be used in a [copyin](../../parallel/openmp/reference/openmp-clauses.md#copyin) clause. -The following sample generates C3058: +## Example + +The following example generates C3058: ```cpp // C3058.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3059.md b/docs/error-messages/compiler-errors-2/compiler-error-c3059.md index 0385160ecf1..d7518ccc873 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3059.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3059.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C3059" title: "Compiler Error C3059" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3059" +ms.date: 11/04/2016 f1_keywords: ["C3059"] helpviewer_keywords: ["C3059"] -ms.assetid: 57220324-8286-4cab-a1ab-45385eb1eae0 --- # Compiler Error C3059 -'var' : 'threadprivate' symbol cannot be used in the 'clause' clause +> 'var' : 'threadprivate' symbol cannot be used in the 'clause' clause + +## Remarks A [threadprivate](../../parallel/openmp/reference/openmp-directives.md#threadprivate) symbol was used in a clause. -The following sample generates C3059: +## Example + +The following example generates C3059: ```cpp // C3059.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3060.md b/docs/error-messages/compiler-errors-2/compiler-error-c3060.md index 56687093106..1745f7c3480 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3060.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3060.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C3060" title: "Compiler Error C3060" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3060" +ms.date: 11/04/2016 f1_keywords: ["C3060"] helpviewer_keywords: ["C3060"] -ms.assetid: 6282bb92-0546-4b59-9435-d3840bf93bdb --- # Compiler Error C3060 -'member' : a friend function may not be defined inside a class using a qualified name (it may only be declared) +> 'member' : a friend function may not be defined inside a class using a qualified name (it may only be declared) + +## Remarks A friend function was defined using a qualified name, which is not allowed. -The following sample generates C3060: +## Example + +The following example generates C3060: ```cpp // C3060.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3062.md b/docs/error-messages/compiler-errors-2/compiler-error-c3062.md index ecd02c05848..bb87d31e352 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3062.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3062.md @@ -1,20 +1,23 @@ --- -description: "Learn more about: Compiler Error C3062" title: "Compiler Error C3062" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3062" +ms.date: 11/04/2016 f1_keywords: ["C3062"] helpviewer_keywords: ["C3062"] -ms.assetid: 78632e6d-255f-42c3-b124-31a9194ff86d --- # Compiler Error C3062 -'enum': enumerator requires value since the underlying type is 'type' +> 'enum': enumerator requires value since the underlying type is 'type' + +## Remarks You can specify an underlying type for an enumeration. However, some types require you to assign values to each enumerator. For more information on enums, see [enum class](../../extensions/enum-class-cpp-component-extensions.md). -The following sample generates C3062: +## Example + +The following example generates C3062: ```cpp // C3062.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3063.md b/docs/error-messages/compiler-errors-2/compiler-error-c3063.md index 14672ef7f5f..00e1890b694 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3063.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3063.md @@ -1,20 +1,21 @@ --- -description: "Learn more about: Compiler Error C3063" title: "Compiler Error C3063" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3063" +ms.date: 11/04/2016 f1_keywords: ["C3063"] helpviewer_keywords: ["C3063"] -ms.assetid: 0ecf6f1f-e4a7-487a-9fd5-79d8ac470001 --- # Compiler Error C3063 -operator 'operator': all operands must have the same enumeration type +> operator 'operator': all operands must have the same enumeration type + +## Remarks When using operators on enumerators, both operands must be of the enumeration type. For more information, see [How to: Define and consume enums in C++/CLI](../../dotnet/how-to-define-and-consume-enums-in-cpp-cli.md). ## Example -The following sample generates C3063 and shows how to fix it: +The following example generates C3063 and shows how to fix it: ```cpp // C3063.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3065.md b/docs/error-messages/compiler-errors-2/compiler-error-c3065.md index 38985064a54..6c8a2fdb26e 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3065.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3065.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C3065" title: "Compiler Error C3065" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3065" +ms.date: 11/04/2016 f1_keywords: ["C3065"] helpviewer_keywords: ["C3065"] -ms.assetid: e7a0bc69-1c68-459e-a7c4-93c65609ff7c --- # Compiler Error C3065 -property declaration at non-class scope is not allowed +> property declaration at non-class scope is not allowed + +## Remarks The [property](../../cpp/property-cpp.md) __declspec modifier was used outside a class. A property can only be declared inside a class. -The following sample generates C3065: +## Example + +The following example generates C3065: ```cpp // C3065.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3066.md b/docs/error-messages/compiler-errors-2/compiler-error-c3066.md index 59508836a8e..2829acc296f 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3066.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3066.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C3066" title: "Compiler Error C3066" -ms.date: "03/28/2017" +description: "Learn more about: Compiler Error C3066" +ms.date: 03/28/2017 f1_keywords: ["C3066"] helpviewer_keywords: ["C3066"] -ms.assetid: 226f6de5-c4c5-41e2-b31a-2e30a37fbbeb --- # Compiler Error C3066 -there are multiple ways that an object of this type can be called with these arguments +> there are multiple ways that an object of this type can be called with these arguments + +## Remarks The compiler detected an ambiguous function call involving surrogates. -The following sample generates C3066: +## Examples + +The following example generates C3066: ```cpp // C3066.cpp @@ -46,12 +49,12 @@ int main() { } ``` -## Copy-list-initialization +### Copy-list-initialization In Visual Studio 2015, the compiler erroneously treated copy-list-initialization in the same way as regular copy-initialization; it considered only converting constructors for overload resolution. In the following example, Visual Studio 2015 chooses MyInt(23) but Visual Studio 2017 correctly raises the error. ``` -// From http://www.open-std.org/jtc1/sc22/wg21/docs/cwg_closed.html#1228 +// From https://www.open-std.org/jtc1/sc22/wg21/docs/cwg_closed.html#1228 struct MyList { explicit MyStore(int initialCapacity); }; diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3068.md b/docs/error-messages/compiler-errors-2/compiler-error-c3068.md index ef02c390227..70488a70967 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3068.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3068.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Error C3068" title: "Compiler Error C3068" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3068" +ms.date: 11/04/2016 f1_keywords: ["C3068"] helpviewer_keywords: ["C3068"] -ms.assetid: 613e3447-b4a8-4268-a661-297bed63ccdf --- # Compiler Error C3068 -'function' : a 'naked' function cannot contain objects that would require unwinding if a C++ exception occurred +> 'function' : a 'naked' function cannot contain objects that would require unwinding if a C++ exception occurred + +## Remarks The compiler was unable to perform stack unwinding on a [naked](../../cpp/naked-cpp.md) function that threw an exception because a temporary object was created in the function and C++ exception handling ([/EHsc](../../build/reference/eh-exception-handling-model.md)) was specified. @@ -26,7 +27,7 @@ When an exception is thrown, compiler generated code, called the prolog and epil ## Example -The following sample generates C3068: +The following example generates C3068: ```cpp // C3068.cpp @@ -42,5 +43,5 @@ void b(A){} __declspec(naked) void c() { b(A()); // C3068 -}; +} ``` diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3069.md b/docs/error-messages/compiler-errors-2/compiler-error-c3069.md index 34a45c96c9d..e334e11aaa5 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3069.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3069.md @@ -1,20 +1,21 @@ --- -description: "Learn more about: Compiler Error C3069" title: "Compiler Error C3069" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3069" +ms.date: 11/04/2016 f1_keywords: ["C3069"] helpviewer_keywords: ["C3069"] -ms.assetid: ca94291b-2bb4-4e3f-9acf-534234b83513 --- # Compiler Error C3069 -'operator': not allowed for enumeration type +> 'operator': not allowed for enumeration type + +## Remarks An operator is not supported for CLR enumerations. For more information, see [How to: Define and consume enums in C++/CLI](../../dotnet/how-to-define-and-consume-enums-in-cpp-cli.md). ## Example -The following sample generates C3069: +The following example generates C3069: ```cpp // C3069.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3070.md b/docs/error-messages/compiler-errors-2/compiler-error-c3070.md index 9740fc45eeb..3e5cd8cee5e 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3070.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3070.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C3070" title: "Compiler Error C3070" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3070" +ms.date: 11/04/2016 f1_keywords: ["C3070"] helpviewer_keywords: ["C3070"] -ms.assetid: ac88584d-40a6-4176-90f3-2371c3c935f2 --- # Compiler Error C3070 -'property': property does not have a 'set' method +> 'property': property does not have a 'set' method + +## Remarks A property's set accessor method was not defined. For more information, see [property](../../extensions/property-cpp-component-extensions.md). -The following sample generates C3070: +## Example + +The following example generates C3070: ```cpp // C3070.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3071.md b/docs/error-messages/compiler-errors-2/compiler-error-c3071.md index 2b25f530af2..b8f37bba23f 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3071.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3071.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Error C3071" title: "Compiler Error C3071" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3071" +ms.date: 11/04/2016 f1_keywords: ["C3071"] helpviewer_keywords: ["C3071"] -ms.assetid: 69879e66-a60e-4058-9bbd-d5c5e2d8ee37 --- # Compiler Error C3071 -operator 'operator' can only be applied to an instance of a ref class or a value-type +> operator 'operator' can only be applied to an instance of a ref class or a value-type + +## Remarks A CLR operator cannot be used on a native type. The operator can be used on a ref class or a ref struct (a value type) but not a native type such as int or an alias for a native type such as System::Int32. These types can't be boxed from C++ code in a way that refers to the native variable, so the operator cannot be used. @@ -16,7 +17,7 @@ For more information, see [Tracking Reference Operator](../../extensions/trackin ## Example -The following sample generates C3071. +The following example generates C3071. ```cpp // C3071.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3072.md b/docs/error-messages/compiler-errors-2/compiler-error-c3072.md index 3fc36b7657a..c4a4aa4d695 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3072.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3072.md @@ -1,22 +1,23 @@ --- -description: "Learn more about: Compiler Error C3072" title: "Compiler Error C3072" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3072" +ms.date: 11/04/2016 f1_keywords: ["C3072"] helpviewer_keywords: ["C3072"] -ms.assetid: cdd5cb6b-c478-4698-adfa-c40188d34a18 --- # Compiler Error C3072 > operator '*operator-name*' cannot be applied to an instance of a ref class +## Remarks + use the unary *operator-name* operator to convert an instance of a ref class to a handle type A CLR type requires CLR operators, not native (or standard) operators. For more information, see [Tracking Reference Operator](../../extensions/tracking-reference-operator-cpp-component-extensions.md). ## Example -The following sample generates C3072. +The following example generates C3072. ```cpp // C3072.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3073.md b/docs/error-messages/compiler-errors-2/compiler-error-c3073.md index abfadfab32d..ee969551dee 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3073.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3073.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Error C3073" title: "Compiler Error C3073" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3073" +ms.date: 11/04/2016 f1_keywords: ["C3073"] helpviewer_keywords: ["C3073"] -ms.assetid: b24b9b8b-f9fb-4c3c-a1a0-97fad2081bfc --- # Compiler Error C3073 -'type' : ref class does not have a user-defined copy constructor +> 'type' : ref class does not have a user-defined copy constructor + +## Remarks In a [/clr (Common Language Runtime Compilation)](../../build/reference/clr-common-language-runtime-compilation.md) compilation, the compiler will not generate a copy constructor for a reference type. In any **/clr** compilation, you must define your own copy constructor for a reference type if you expect an instance of the type to be copied. @@ -16,7 +17,7 @@ For more information, see [C++ Stack Semantics for Reference Types](../../dotnet ## Example -The following sample generates C3073. +The following example generates C3073. ```cpp // C3073.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3075.md b/docs/error-messages/compiler-errors-2/compiler-error-c3075.md index edb6485a4cd..eddf91c56cb 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3075.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3075.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Error C3075" title: "Compiler Error C3075" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3075" +ms.date: 11/04/2016 f1_keywords: ["C3075"] helpviewer_keywords: ["C3075"] -ms.assetid: f431daa9-e0fa-48f0-a5c3-f99be96b55e3 --- # Compiler Error C3075 -'instance' : you cannot embed an instance of a reference type, 'type', in a value-type +> 'instance' : you cannot embed an instance of a reference type, 'type', in a value-type + +## Remarks A value type cannot contain an instance of a reference type. @@ -16,7 +17,7 @@ For more information, see [C++ Stack Semantics for Reference Types](../../dotnet ## Example -The following sample generates C3075. +The following example generates C3075. ```cpp // C3075.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3076.md b/docs/error-messages/compiler-errors-2/compiler-error-c3076.md index 35183fa19d4..62da9d235f0 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3076.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3076.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Error C3076" title: "Compiler Error C3076" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3076" +ms.date: 11/04/2016 f1_keywords: ["C3076"] helpviewer_keywords: ["C3076"] -ms.assetid: 8a87b3e4-2c17-4b87-9622-ef0962d6a34e --- # Compiler Error C3076 -'instance' : you cannot embed an instance of a reference type, 'type', in a native type +> 'instance' : you cannot embed an instance of a reference type, 'type', in a native type + +## Remarks A native type cannot contain an instance of a CLR type. @@ -16,7 +17,7 @@ For more information, see [C++ Stack Semantics for Reference Types](../../dotnet ## Example -The following sample generates C3076. +The following example generates C3076. ```cpp // C3076.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3077.md b/docs/error-messages/compiler-errors-2/compiler-error-c3077.md index 4ceb95d997d..db80911f95c 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3077.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3077.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Error C3077" title: "Compiler Error C3077" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3077" +ms.date: 11/04/2016 f1_keywords: ["C3077"] helpviewer_keywords: ["C3077"] -ms.assetid: d9f3c619-d1e2-4656-81a5-a35a9586a7d4 --- # Compiler Error C3077 -'finalizer' : a finalizer can only be a member of a reference type +> 'finalizer' : a finalizer can only be a member of a reference type + +## Remarks You cannot declare a finalizer in a native or value type. @@ -16,7 +17,7 @@ For more information, see [Destructors and finalizers in How to: Define and cons ## Example -The following sample generates C3077. +The following example generates C3077. ```cpp // C3077.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3080.md b/docs/error-messages/compiler-errors-2/compiler-error-c3080.md index 14b0241f785..88cbc6ca129 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3080.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3080.md @@ -1,20 +1,21 @@ --- -description: "Learn more about: Compiler Error C3080" title: "Compiler Error C3080" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3080" +ms.date: 11/04/2016 f1_keywords: ["C3080"] helpviewer_keywords: ["C3080"] -ms.assetid: ff62a3f7-9b3b-44bd-b8d9-f3a8e5354560 --- # Compiler Error C3080 -'finalizer_function' : a finalizer cannot have a storage-class-specifier +> 'finalizer_function' : a finalizer cannot have a storage-class-specifier + +## Remarks For more information, see [Destructors and finalizers in How to: Define and consume classes and structs (C++/CLI)](../../dotnet/how-to-define-and-consume-classes-and-structs-cpp-cli.md#BKMK_Destructors_and_finalizers). ## Example -The following sample generates C3080. +The following example generates C3080. ```cpp // C3080.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3083.md b/docs/error-messages/compiler-errors-2/compiler-error-c3083.md index 35cefa54416..8b0ec411136 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3083.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3083.md @@ -1,32 +1,31 @@ --- -description: "Learn more about: Compiler Error C3083" title: "Compiler Error C3083" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3083" +ms.date: 08/14/2025 f1_keywords: ["C3083"] helpviewer_keywords: ["C3083"] -ms.assetid: 05ff791d-52bb-41eb-9511-3ef89d7f4710 --- # Compiler Error C3083 -'function': the symbol to the left of a '::' must be a type +> '*identifier*': the symbol to the left of a '::' must be a type -A function was called incorrectly. +## Remarks + +The qualification used is invalid. Ensure that no extra symbols were used in the qualification and that you included all required headers. ## Example -The following sample generates C3083. +The following example generates C3083: ```cpp // C3083.cpp // compile with: /c -struct N { - ~N(); -}; -struct N1 { - ~N1(); +struct S +{ + S(); }; -N::N::~N() {} // C3083 -N1::~N1() {} // OK +S::Extra::S() {} // C3083 +S::S() {} // OK ``` diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3084.md b/docs/error-messages/compiler-errors-2/compiler-error-c3084.md index aebe230b47a..a07399b74d7 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3084.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3084.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Error C3084" title: "Compiler Error C3084" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3084" +ms.date: 11/04/2016 f1_keywords: ["C3084"] helpviewer_keywords: ["C3084"] -ms.assetid: 0362cb70-e24e-476f-a24d-8f5bb97c3afd --- # Compiler Error C3084 -'function': a finalizer/destructor cannot be 'keyword' +> 'function': a finalizer/destructor cannot be 'keyword' + +## Remarks A finalizer or destructor was declared incorrectly. @@ -16,7 +17,7 @@ For example, a destructor should not be marked as sealed. The destructor will b ## Example -The following sample generates C3084. +The following example generates C3084. ```cpp // C3084.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3085.md b/docs/error-messages/compiler-errors-2/compiler-error-c3085.md index 7fe1b774584..74751546f6d 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3085.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3085.md @@ -1,20 +1,21 @@ --- -description: "Learn more about: Compiler Error C3085" title: "Compiler Error C3085" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3085" +ms.date: 11/04/2016 f1_keywords: ["C3085"] helpviewer_keywords: ["C3085"] -ms.assetid: 1ac40bf2-f63e-439e-8921-47e6dadc8354 --- # Compiler Error C3085 -'constructor': a constructor cannot be 'keyword' +> 'constructor': a constructor cannot be 'keyword' + +## Remarks A constructor was declared incorrectly. See [Override Specifiers](../../extensions/override-specifiers-cpp-component-extensions.md) for more information. ## Example -The following sample generates C3085. +The following example generates C3085. ```cpp // C3085.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3087.md b/docs/error-messages/compiler-errors-2/compiler-error-c3087.md index a55aa67f4bd..1ab7a8e1e53 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3087.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3087.md @@ -1,20 +1,21 @@ --- -description: "Learn more about: Compiler Error C3087" title: "Compiler Error C3087" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3087" +ms.date: 11/04/2016 f1_keywords: ["C3087"] helpviewer_keywords: ["C3087"] -ms.assetid: 4f5bdd52-a853-4f02-b160-6868e9190b9d --- # Compiler Error C3087 -'named_argument': call of 'attribute' already initializes this member +> 'named_argument': call of 'attribute' already initializes this member + +## Remarks A named argument was specified in the same attribute block as an unnamed argument for the same value. Specify only a named or unnamed argument. ## Example -The following sample generates C3087. +The following example generates C3087. ```cpp // C3087.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3094.md b/docs/error-messages/compiler-errors-2/compiler-error-c3094.md index a97f0f43706..83e295f29c3 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3094.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3094.md @@ -1,20 +1,21 @@ --- -description: "Learn more about: Compiler Error C3094" title: "Compiler Error C3094" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3094" +ms.date: 11/04/2016 f1_keywords: ["C3094"] helpviewer_keywords: ["C3094"] -ms.assetid: 10da9b7c-e72d-4013-9925-c83e1bb142db --- # Compiler Error C3094 -'attribute': anonymous usage not allowed +> 'attribute': anonymous usage not allowed + +## Remarks An attribute was not scoped correctly. For more information, see [User-Defined Attributes](../../extensions/user-defined-attributes-cpp-component-extensions.md). ## Example -The following sample generates C3094. +The following example generates C3094. ```cpp // C3094.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3095.md b/docs/error-messages/compiler-errors-2/compiler-error-c3095.md index bd8be003cbd..5cae3a92d4e 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3095.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3095.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Error C3095" title: "Compiler Error C3095" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3095" +ms.date: 11/04/2016 f1_keywords: ["C3095"] helpviewer_keywords: ["C3095"] -ms.assetid: cde725be-0936-40f6-9e57-e1d7d0710f83 --- # Compiler Error C3095 -'attribute': attribute cannot be repeated +> 'attribute': attribute cannot be repeated + +## Remarks Some attributes are declared such that, multiple occurrences of the attribute cannot be applied to a target. @@ -16,7 +17,7 @@ For more information, see [User-Defined Attributes](../../extensions/user-define ## Example -The following sample generates C3095. +The following example generates C3095. ```cpp // C3095.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3096.md b/docs/error-messages/compiler-errors-2/compiler-error-c3096.md index aef61fc0947..65387f15584 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3096.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3096.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Error C3096" title: "Compiler Error C3096" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3096" +ms.date: 11/04/2016 f1_keywords: ["C3096"] helpviewer_keywords: ["C3096"] -ms.assetid: 56353c9a-800c-474f-b428-3e5d2a7afc9a --- # Compiler Error C3096 -'attribute': attribute is allowed on data members of attribute classes only +> 'attribute': attribute is allowed on data members of attribute classes only + +## Remarks An attribute was applied incorrectly. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3097.md b/docs/error-messages/compiler-errors-2/compiler-error-c3097.md index b8147494239..0df9c143f97 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3097.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3097.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Error C3097" title: "Compiler Error C3097" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3097" +ms.date: 11/04/2016 f1_keywords: ["C3097"] helpviewer_keywords: ["C3097"] -ms.assetid: b24bd8f8-e04f-4fbb-be57-4feb9165572e --- # Compiler Error C3097 -'attribute': attribute must be scoped with 'assembly:' or 'module:' +> 'attribute': attribute must be scoped with 'assembly:' or 'module:' + +## Remarks A global attribute was used incorrectly. @@ -16,7 +17,7 @@ For more information, see [User-Defined Attributes](../../extensions/user-define ## Example -The following sample generates C3097. +The following example generates C3097. ```cpp // C3097.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3099.md b/docs/error-messages/compiler-errors-2/compiler-error-c3099.md index ae0c8f89aa8..715d0b0c786 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3099.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3099.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Error C3099" title: "Compiler Error C3099" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3099" +ms.date: 11/04/2016 f1_keywords: ["C3099"] helpviewer_keywords: ["C3099"] -ms.assetid: b3dded0f-76c9-42c1-991b-532eb8619661 --- # Compiler Error C3099 -'keyword': use [System::AttributeUsageAttribute] for managed attributes; use [Windows::Foundation::Metadata::AttributeUsageAttribute] for WinRT attributes +> 'keyword': use [System::AttributeUsageAttribute] for managed attributes; use [Windows::Foundation::Metadata::AttributeUsageAttribute] for WinRT attributes + +## Remarks Use to declare **/clr** attributes. Use `Windows::Foundation::Metadata::AttributeUsageAttribute` to declare Windows Runtime attributes. @@ -16,7 +17,7 @@ For more information about /CLR attributes, see [User-Defined Attributes](../../ ## Example -The following sample generates C3099 and shows how to fix it. +The following example generates C3099 and shows how to fix it. ```cpp // C3099.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3100.md b/docs/error-messages/compiler-errors-2/compiler-error-c3100.md index 5fa251c5129..c67b602e9a6 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3100.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3100.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Error C3100" title: "Compiler Error C3100" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3100" +ms.date: 11/04/2016 f1_keywords: ["C3100"] helpviewer_keywords: ["C3100"] -ms.assetid: 7a9c9eaf-08ef-442d-94a0-e457beee8549 --- # Compiler Error C3100 -'target' : unknown attribute qualifier +> 'target' : unknown attribute qualifier + +## Remarks An invalid attribute target was specified. @@ -16,7 +17,7 @@ For more information, see [User-Defined Attributes](../../extensions/user-define ## Example -The following sample generates C3100. +The following example generates C3100. ```cpp // C3100.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3101.md b/docs/error-messages/compiler-errors-2/compiler-error-c3101.md index 045856000f7..6c5f88063b5 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3101.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3101.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Error C3101" title: "Compiler Error C3101" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3101" +ms.date: 11/04/2016 f1_keywords: ["C3101"] helpviewer_keywords: ["C3101"] -ms.assetid: 4f673766-d4f7-4632-94a5-d36a83f7f4b5 --- # Compiler Error C3101 -illegal expression for named attribute argument 'field' +> illegal expression for named attribute argument 'field' + +## Remarks When initializing a named attribute argument, the value must be a compile time constant. @@ -16,7 +17,7 @@ For more information on attributes, see [User-Defined Attributes](../../extensio ## Example -The following sample generates C3101. +The following example generates C3101. ```cpp // C3101.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3103.md b/docs/error-messages/compiler-errors-2/compiler-error-c3103.md index c877baa9b96..46b7d95b5f6 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3103.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3103.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Error C3103" title: "Compiler Error C3103" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3103" +ms.date: 11/04/2016 f1_keywords: ["C3103"] helpviewer_keywords: ["C3103"] -ms.assetid: 7984bd3e-d51d-43e4-b6f4-08c1e9fb9704 --- # Compiler Error C3103 -'argument': repeated named argument +> 'argument': repeated named argument + +## Remarks An attribute can not repeat named arguments. @@ -16,7 +17,7 @@ For more information, see [User-Defined Attributes](../../extensions/user-define ## Example -The following sample generates C3103. +The following example generates C3103. ```cpp // C3103.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3104.md b/docs/error-messages/compiler-errors-2/compiler-error-c3104.md index 1dec0a81074..b2b05bdc091 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3104.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3104.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Error C3104" title: "Compiler Error C3104" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3104" +ms.date: 11/04/2016 f1_keywords: ["C3104"] helpviewer_keywords: ["C3104"] -ms.assetid: b5648d47-e5d3-4b45-a3c0-f46e04eae731 --- # Compiler Error C3104 -illegal attribute argument +> illegal attribute argument + +## Remarks You specified an invalid argument to an attribute. @@ -18,7 +19,7 @@ This error can be generated as a result of compiler conformance work that was do ## Examples -The following sample generates C3104. +The following example generates C3104. ```cpp // C3104a.cpp @@ -37,7 +38,7 @@ public ref struct ABC : public Attribute { ref struct AStruct{}; ``` -The following sample generates C3104. +The following example generates C3104. ```cpp // C3104b.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3106.md b/docs/error-messages/compiler-errors-2/compiler-error-c3106.md index 0722bc47ab8..e44c24da629 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3106.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3106.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Error C3106" title: "Compiler Error C3106" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3106" +ms.date: 11/04/2016 f1_keywords: ["C3106"] helpviewer_keywords: ["C3106"] -ms.assetid: 39d97a32-0905-4702-87d3-7f8ce473fb93 --- # Compiler Error C3106 -'attribute': unnamed arguments must precede named arguments +> 'attribute': unnamed arguments must precede named arguments + +## Remarks Unnamed arguments must be passed to an attribute before named arguments. @@ -16,7 +17,7 @@ For more information, see [User-Defined Attributes](../../extensions/user-define ## Example -The following sample generates C3106. +The following example generates C3106. ```cpp // C3106.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3110.md b/docs/error-messages/compiler-errors-2/compiler-error-c3110.md index d9394cedf03..9cf78b27444 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3110.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3110.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Error C3110" title: "Compiler Error C3110" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3110" +ms.date: 11/04/2016 f1_keywords: ["C3110"] helpviewer_keywords: ["C3110"] -ms.assetid: 821dc71f-896e-4b2d-af0e-aa9932934b7b --- # Compiler Error C3110 -'function_name' : you cannot overload a COM interface method +> 'function_name' : you cannot overload a COM interface method + +## Remarks An interface that is prefaced by an interface attribute, such as: @@ -20,7 +21,11 @@ An interface that is prefaced by an interface attribute, such as: - [object](../../windows/attributes/object-cpp.md) -cannot be overloaded. For example: +cannot be overloaded. + +## Example + +For example: ```cpp // C3110.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3113.md b/docs/error-messages/compiler-errors-2/compiler-error-c3113.md index 970f7590709..640eb8d5bb1 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3113.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3113.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C3113" title: "Compiler Error C3113" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3113" +ms.date: 11/04/2016 f1_keywords: ["C3113"] helpviewer_keywords: ["C3113"] -ms.assetid: 3afdc668-b29e-474e-9ea3-aa027d42db7c --- # Compiler Error C3113 -an 'structure' cannot be a template/generic +> an 'structure' cannot be a template/generic + +## Remarks You attempted to make a class template or class generic out of an interface or an enum. -The following sample generates C3113: +## Example + +The following example generates C3113: ```cpp // C3113.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3114.md b/docs/error-messages/compiler-errors-2/compiler-error-c3114.md index 6fac377ccb8..0d6fdb2e633 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3114.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3114.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Error C3114" title: "Compiler Error C3114" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3114" +ms.date: 11/04/2016 f1_keywords: ["C3114"] helpviewer_keywords: ["C3114"] -ms.assetid: b5d2df4f-87d0-4292-9981-25c6a6013c05 --- # Compiler Error C3114 -'argument': not a valid named attribute argument +> 'argument': not a valid named attribute argument + +## Remarks In order for an attribute class data member to be a valid named argument, it must not be marked **`static`**, **`const`**, or **`literal`**. If a property, the property must not be **`static`** and must have get and set accessors. @@ -16,7 +17,7 @@ For more information, see [property](../../extensions/property-cpp-component-ext ## Example -The following sample generates C3114. +The following example generates C3114. ```cpp // C3114.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3115.md b/docs/error-messages/compiler-errors-2/compiler-error-c3115.md index 217ea876771..f6be15f40d3 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3115.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3115.md @@ -1,20 +1,21 @@ --- -description: "Learn more about: Compiler Error C3115" title: "Compiler Error C3115" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3115" +ms.date: 11/04/2016 f1_keywords: ["C3115"] helpviewer_keywords: ["C3115"] -ms.assetid: 51726145-9782-4ec9-84b9-286f366d9cbd --- # Compiler Error C3115 -'attribute': this attribute is not allowed on 'construct' +> 'attribute': this attribute is not allowed on 'construct' + +## Remarks An attribute was applied to a construct for which it was not intended. See [Attributes by Usage](../../windows/attributes/attributes-by-usage.md) for more information. ## Example -The following sample generates C3115. +The following example generates C3115. ```cpp // C3115.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3116.md b/docs/error-messages/compiler-errors-2/compiler-error-c3116.md index 57dbf504d7f..4a3b9237bc0 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3116.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3116.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C3116" title: "Compiler Error C3116" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3116" +ms.date: 11/04/2016 f1_keywords: ["C3116"] helpviewer_keywords: ["C3116"] -ms.assetid: 597463e1-a5cc-4ed3-a917-eae9a61d3312 --- # Compiler Error C3116 -'storage specifier' : invalid storage class for interface method +> 'storage specifier' : invalid storage class for interface method + +## Remarks You used **`typedef`**, **`register`**, or **`static`** as the storage class for an interface method. These storage classes are not permitted on interface members. -The following sample generates C3116: +## Example + +The following example generates C3116: ```cpp // C3116.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3117.md b/docs/error-messages/compiler-errors-2/compiler-error-c3117.md index d8564c19483..67f914ff316 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3117.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3117.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C3117" title: "Compiler Error C3117" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3117" +ms.date: 11/04/2016 f1_keywords: ["C3117"] helpviewer_keywords: ["C3117"] -ms.assetid: dceee392-d4c7-4599-b75e-7aaac7c36fdd --- # Compiler Error C3117 -'%$S' : an interface can only have one base class +> '%$S' : an interface can only have one base class + +## Remarks You declared an interface that inherits from multiple base classes. -The following sample generates C3117: +## Example + +The following example generates C3117: ```cpp // C3117.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3118.md b/docs/error-messages/compiler-errors-2/compiler-error-c3118.md index 336a3aaf927..48d11292d5f 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3118.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3118.md @@ -1,16 +1,21 @@ --- -description: "Learn more about: Compiler Error C3118" title: "Compiler Error C3118" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3118" +ms.date: 11/04/2016 f1_keywords: ["C3118"] helpviewer_keywords: ["C3118"] -ms.assetid: 40fbe681-8868-4cb2-a2b2-4db4449319a7 --- # Compiler Error C3118 -'interface' : interfaces do not support virtual inheritance +> 'interface' : interfaces do not support virtual inheritance + +## Remarks + +You tried to virtually inherit from an interface. + +## Example -You tried to virtually inherit from an interface. For example, +For example, ```cpp // C3118.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3120.md b/docs/error-messages/compiler-errors-2/compiler-error-c3120.md index b9d10eea8a6..a292987bc60 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3120.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3120.md @@ -1,16 +1,21 @@ --- -description: "Learn more about: Compiler Error C3120" title: "Compiler Error C3120" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3120" +ms.date: 11/04/2016 f1_keywords: ["C3120"] helpviewer_keywords: ["C3120"] -ms.assetid: 9b6b210f-9948-4517-a4cc-b4aaadebde68 --- # Compiler Error C3120 -'method_name' : interface methods cannot take a variable argument list +> 'method_name' : interface methods cannot take a variable argument list + +## Remarks + +An interface method cannot take a variable argument list. + +## Example -An interface method cannot take a variable argument list. For example, the following interface definition generates C3120: +For example, the following interface definition generates C3120: ```cpp // C3120.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3121.md b/docs/error-messages/compiler-errors-2/compiler-error-c3121.md index 227db69a1d0..463bcaba93a 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3121.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3121.md @@ -1,17 +1,20 @@ --- -description: "Learn more about: Compiler Error C3121" title: "Compiler Error C3121" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3121" +ms.date: 11/04/2016 f1_keywords: ["C3121"] helpviewer_keywords: ["C3121"] -ms.assetid: 1d3c7be4-d42d-4def-8d53-182c0c5cc237 --- # Compiler Error C3121 -cannot change GUID for class 'class_name' +> cannot change GUID for class 'class_name' + +## Remarks You attempted to change the class ID with [__declspec(uuid)](../../cpp/uuid-cpp.md). +## Example + For example, the following code generates C3121: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3126.md b/docs/error-messages/compiler-errors-2/compiler-error-c3126.md index 2822c84cc6a..2b8904f94d5 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3126.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3126.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C3126" title: "Compiler Error C3126" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3126" +ms.date: 11/04/2016 f1_keywords: ["C3126"] helpviewer_keywords: ["C3126"] -ms.assetid: e72658a3-5d85-4a31-89a4-dbc3d475973d --- # Compiler Error C3126 -cannot define a union 'union' inside of managed type 'type' +> cannot define a union 'union' inside of managed type 'type' + +## Remarks A union cannot be defined inside a managed type. -The following sample generates C3126: +## Example + +The following example generates C3126: ```cpp // C3126_2.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3130.md b/docs/error-messages/compiler-errors-2/compiler-error-c3130.md index 4da60e51e93..ebd75f87f3b 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3130.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3130.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Compiler Error C3130" title: "Compiler Error C3130" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3130" +ms.date: 11/04/2016 f1_keywords: ["C3130"] helpviewer_keywords: ["C3130"] -ms.assetid: c1462f33-434f-41f0-937e-392864916850 --- # Compiler Error C3130 -Internal Compiler Error: failed to write injected code block to PDB +> Internal Compiler Error: failed to write injected code block to PDB + +## Remarks This error occurs if the compiler failed to write an injected code block to the .pdb file. The most common reason for the failure is lack of disk space. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3131.md b/docs/error-messages/compiler-errors-2/compiler-error-c3131.md index 54a1b28c50b..6206cebbdfa 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3131.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3131.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C3131" title: "Compiler Error C3131" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3131" +ms.date: 11/04/2016 f1_keywords: ["C3131"] helpviewer_keywords: ["C3131"] -ms.assetid: 38f20fac-83c9-4cd9-b7b5-74ca8f650ea6 --- # Compiler Error C3131 -project must have a 'module' attribute with a 'name' property +> project must have a 'module' attribute with a 'name' property + +## Remarks The [module](../../windows/attributes/module-cpp.md) attribute must have a name parameter. -The following sample generates C3131: +## Example + +The following example generates C3131: ```cpp // C3131.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3132.md b/docs/error-messages/compiler-errors-2/compiler-error-c3132.md index d61facc1aab..83bbc2fe187 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3132.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3132.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C3132" title: "Compiler Error C3132" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3132" +ms.date: 11/04/2016 f1_keywords: ["C3132"] helpviewer_keywords: ["C3132"] -ms.assetid: d54a3d12-336a-4ed0-ad4e-43cddac33b5e --- # Compiler Error C3132 -'function-parameter' : parameter arrays can only be applied to a formal argument of type 'single-dimensional managed array' +> 'function-parameter' : parameter arrays can only be applied to a formal argument of type 'single-dimensional managed array' + +## Remarks The attribute was applied to a parameter that was not a single-dimension array. -The following sample generates C3132: +## Example + +The following example generates C3132: ```cpp // C3132.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3133.md b/docs/error-messages/compiler-errors-2/compiler-error-c3133.md index d26c091a66a..cb737253640 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3133.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3133.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Error C3133" title: "Compiler Error C3133" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3133" +ms.date: 11/04/2016 f1_keywords: ["C3133"] helpviewer_keywords: ["C3133"] -ms.assetid: 4a709405-b67b-4061-8a2a-19fa5fb34a2a --- # Compiler Error C3133 -Attributes cannot be applied to C++ varargs +> Attributes cannot be applied to C++ varargs + +## Remarks An attribute was applied incorrectly. Attributes can not be applied to an ellipsis representing variable arguments. @@ -16,7 +17,7 @@ For more information, see [User-Defined Attributes](../../extensions/user-define ## Example -The following sample generates C3133. +The following example generates C3133. ```cpp // C3133.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3134.md b/docs/error-messages/compiler-errors-2/compiler-error-c3134.md index f8e04a9e7b5..ee6d5ab7c78 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3134.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3134.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Error C3134" title: "Compiler Error C3134" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3134" +ms.date: 11/04/2016 f1_keywords: ["C3134"] helpviewer_keywords: ["C3134"] -ms.assetid: f887e4d2-7740-49e4-9972-7edceb8fa77b --- # Compiler Error C3134 -'value' : value of attribute argument 'attribute' does not have valid type 'type' +> 'value' : value of attribute argument 'attribute' does not have valid type 'type' + +## Remarks A syntax error was detected when a value was assigned to an attribute. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3135.md b/docs/error-messages/compiler-errors-2/compiler-error-c3135.md index 1b97325d54a..9e421773ca1 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3135.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3135.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Compiler Error C3135" title: "Compiler Error C3135" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3135" +ms.date: 11/04/2016 f1_keywords: ["C3135"] helpviewer_keywords: ["C3135"] -ms.assetid: e92ee007-5a26-47f4-8ef4-339f2d9528d1 --- # Compiler Error C3135 -'property' : a property cannot have a 'const' or 'volatile' type +> 'property' : a property cannot have a 'const' or 'volatile' type + +## Remarks The [const](../../cpp/const-cpp.md) and [volatile](../../cpp/volatile-cpp.md) keywords are not permitted on properties. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3136.md b/docs/error-messages/compiler-errors-2/compiler-error-c3136.md index d7f66d04349..6a3a0d24b47 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3136.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3136.md @@ -1,17 +1,20 @@ --- -description: "Learn more about: Compiler Error C3136" title: "Compiler Error C3136" -ms.date: "10/03/2018" +description: "Learn more about: Compiler Error C3136" +ms.date: 10/03/2018 f1_keywords: ["C3136"] helpviewer_keywords: ["C3136"] -ms.assetid: c77103cd-00f7-408e-b74b-4f8562039d31 --- # Compiler Error C3136 -'interface' : a COM interface can only inherit from another COM interface, 'interface' is not a COM interface +> 'interface' : a COM interface can only inherit from another COM interface, 'interface' is not a COM interface + +## Remarks An interface to which you applied an [interface attribute](../../windows/attributes/interface-attributes.md) inherits from an interface that is not a COM interface. A COM interface ultimately inherits from `IUnknown`. Any interface preceded by an interface attribute is a COM interface. +## Example + The following example generates C3136: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3137.md b/docs/error-messages/compiler-errors-2/compiler-error-c3137.md index 1ac5395685b..6e731bc7062 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3137.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3137.md @@ -1,17 +1,20 @@ --- -description: "Learn more about: Compiler Error C3137" title: "Compiler Error C3137" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3137" +ms.date: 11/04/2016 f1_keywords: ["C3137"] helpviewer_keywords: ["C3137"] -ms.assetid: 70bb1313-2e87-43ed-a0d8-33fa6ff475e4 --- # Compiler Error C3137 -'property' : a property cannot be initialized +> 'property' : a property cannot be initialized + +## Remarks A property cannot be initialized, for example, in a constructor's initialization list. +## Example + The following example generates C3137: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3138.md b/docs/error-messages/compiler-errors-2/compiler-error-c3138.md index d02f0ad8c55..d7f229b6067 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3138.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3138.md @@ -1,17 +1,20 @@ --- -description: "Learn more about: Compiler Error C3138" title: "Compiler Error C3138" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3138" +ms.date: 11/04/2016 f1_keywords: ["C3138"] helpviewer_keywords: ["C3138"] -ms.assetid: 364ee9e8-9358-410e-bd35-9c4a226a3753 --- # Compiler Error C3138 -'interface' : a 'attribute' interface must inherit from IDispatch, or from an interface that inherits from IDispatch +> 'interface' : a 'attribute' interface must inherit from IDispatch, or from an interface that inherits from IDispatch + +## Remarks An interface with the [dual](../../windows/attributes/dual.md) or [dispinterface](../../windows/attributes/dispinterface.md) attributes does not have `IDispatch` as a direct or indirect base interface. +## Example + The following example generates C3138: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3139.md b/docs/error-messages/compiler-errors-2/compiler-error-c3139.md index 7d5df2ca7ad..2fd93ca5493 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3139.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3139.md @@ -1,16 +1,21 @@ --- -description: "Learn more about: Compiler Error C3139" title: "Compiler Error C3139" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3139" +ms.date: 11/04/2016 f1_keywords: ["C3139"] helpviewer_keywords: ["C3139"] -ms.assetid: 95c92263-10ac-4ff3-b385-6312dd92adbc --- # Compiler Error C3139 -'struct' : cannot export a UDT without members +> 'struct' : cannot export a UDT without members + +## Remarks + +You attempted to apply the [export](../../windows/attributes/export.md) attribute to an empty UDT (user-defined type). + +## Example -You attempted to apply the [export](../../windows/attributes/export.md) attribute to an empty UDT (user-defined type). For example: +For example: ```cpp // C3139.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3140.md b/docs/error-messages/compiler-errors-2/compiler-error-c3140.md index 4339d3f6bd6..6141df55509 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3140.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3140.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C3140" title: "Compiler Error C3140" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3140" +ms.date: 11/04/2016 f1_keywords: ["C3140"] helpviewer_keywords: ["C3140"] -ms.assetid: 122f8943-fac3-4db8-a3a8-2c5d19233de6 --- # Compiler Error C3140 -cannot have multiple 'module' attributes in the same compilation unit +> cannot have multiple 'module' attributes in the same compilation unit + +## Remarks The [module](../../windows/attributes/module-cpp.md) attribute can only be defined once per project. -The following sample generates C3140: +## Example + +The following example generates C3140: ```cpp // C3140.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3141.md b/docs/error-messages/compiler-errors-2/compiler-error-c3141.md index 6811def6fc9..a46f2847091 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3141.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3141.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C3141" title: "Compiler Error C3141" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3141" +ms.date: 11/04/2016 f1_keywords: ["C3141"] helpviewer_keywords: ["C3141"] -ms.assetid: b4fd65c3-50cc-46cd-8de0-6a6d24cb9cda --- # Compiler Error C3141 -'interface_name' : interfaces only support public inheritance +> 'interface_name' : interfaces only support public inheritance + +## Remarks Interfaces defined with the [interface (or __interface)](../../cpp/interface.md) keyword only support public inheritance. -The following sample generates C3141: +## Example + +The following example generates C3141: ```cpp // C3141.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3142.md b/docs/error-messages/compiler-errors-2/compiler-error-c3142.md index 0a7e12997f3..ac7aaeb13d2 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3142.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3142.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C3142" title: "Compiler Error C3142" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3142" +ms.date: 11/04/2016 f1_keywords: ["C3142"] helpviewer_keywords: ["C3142"] -ms.assetid: 795137ad-d00a-4a9c-9665-0cd8bfb5da8b --- # Compiler Error C3142 -'property_name' : you cannot take the address of a property +> 'property_name' : you cannot take the address of a property + +## Remarks The address of a property is not available to the developer. -The following sample generates C3142: +## Example + +The following example generates C3142: ```cpp // C3142_2.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3145.md b/docs/error-messages/compiler-errors-2/compiler-error-c3145.md index 0105f33cfee..fad9fdabf3f 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3145.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3145.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C3145" title: "Compiler Error C3145" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3145" +ms.date: 11/04/2016 f1_keywords: ["C3145"] helpviewer_keywords: ["C3145"] -ms.assetid: f165c874-0f51-45c7-85e8-ebe321cbc168 --- # Compiler Error C3145 -'object' : global or static variable may not have managed or WinRT type 'type' +> 'object' : global or static variable may not have managed or WinRT type 'type' + +## Remarks You can only define CLR or WinRT objects within function scope. -The following sample generates C3145 and shows how to fix it: +## Examples + +The following example generates C3145 and shows how to fix it: ```cpp // C3145.cpp @@ -35,7 +38,7 @@ int main() { } ``` -The following sample generates C3145: +The following example generates C3145: ```cpp // C3145b.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3149.md b/docs/error-messages/compiler-errors-2/compiler-error-c3149.md index d28f9366044..241585d1b14 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3149.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3149.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Error C3149" title: "Compiler Error C3149" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3149" +ms.date: 11/04/2016 f1_keywords: ["C3149"] helpviewer_keywords: ["C3149"] -ms.assetid: cf6e2616-2f06-46da-8a8a-d449cb481c51 --- # Compiler Error C3149 -'type' : cannot use this type here without a top-level 'char' +> 'type' : cannot use this type here without a top-level 'char' + +## Remarks A declaration was not specified correctly. @@ -16,7 +17,9 @@ For example, you may have defined a CLR type at global scope and tried to create To resolve this error, declare variables of CLR types inside a function or type definition. -The following sample generates C3149: +## Examples + +The following example generates C3149: ```cpp // C3149.cpp @@ -29,7 +32,7 @@ int main() { } ``` -The following sample generates C3149: +The following example generates C3149: ```cpp // C3149b.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3150.md b/docs/error-messages/compiler-errors-2/compiler-error-c3150.md index 3145de7e129..2c26b49381a 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3150.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3150.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Error C3150" title: "Compiler Error C3150" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3150" +ms.date: 11/04/2016 f1_keywords: ["C3150"] helpviewer_keywords: ["C3150"] -ms.assetid: c1ff28f5-52fe-4fd4-81d0-2e0ad8548631 --- # Compiler Error C3150 -'element' : 'attribute' can only be applied to a class, interface, array or pointer +> 'element' : 'attribute' can only be applied to a class, interface, array or pointer + +## Remarks **`__gc`** can only be used on a class, interface, or array. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3152.md b/docs/error-messages/compiler-errors-2/compiler-error-c3152.md index 2208919a996..6372b7c33e0 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3152.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3152.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C3152" title: "Compiler Error C3152" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3152" +ms.date: 11/04/2016 f1_keywords: ["C3152"] helpviewer_keywords: ["C3152"] -ms.assetid: 4ee6e2cd-5d19-4b73-833d-765c35797e4b --- # Compiler Error C3152 -'construct' : 'keyword' can only be applied to a class, struct, or virtual member function +> 'construct' : 'keyword' can only be applied to a class, struct, or virtual member function + +## Remarks Certain keywords can only be applied to a C++ class. -The following sample generates C3152 and shows how to fix it: +## Example + +The following example generates C3152 and shows how to fix it: ```cpp // C3152.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3153.md b/docs/error-messages/compiler-errors-2/compiler-error-c3153.md index 5aacbbacaae..8f85face4cc 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3153.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3153.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C3153" title: "Compiler Error C3153" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3153" +ms.date: 11/04/2016 f1_keywords: ["C3153"] helpviewer_keywords: ["C3153"] -ms.assetid: d775d97e-2480-484f-81f1-88406b10f947 --- # Compiler Error C3153 -'interface' : you cannot create an instance of an interface +> 'interface' : you cannot create an instance of an interface + +## Remarks An interface cannot be instantiated. To use the members of an interface, derive a class from the interface, implement the interface members, and then use the members. -The following sample generates C3153: +## Example + +The following example generates C3153: ```cpp // C3153.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3154.md b/docs/error-messages/compiler-errors-2/compiler-error-c3154.md index 1a22ee051b2..6d9110b55cf 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3154.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3154.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Error C3154" title: "Compiler Error C3154" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3154" +ms.date: 11/04/2016 f1_keywords: ["C3154"] helpviewer_keywords: ["C3154"] -ms.assetid: 78005c74-eaaf-4ac2-88ae-6c25d01a302a --- # Compiler Error C3154 -Expected ',' before ellipsis. Non-comma separated ellipsis not supported on parameter array functions. +> Expected ',' before ellipsis. Non-comma separated ellipsis not supported on parameter array functions. + +## Remarks A variable argument function was not declared correctly. @@ -16,7 +17,7 @@ For more information, see [Variable Argument Lists (...) (C++/CLI)](../../extens ## Example -The following sample generates C3154. +The following example generates C3154. ```cpp // C3154.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3155.md b/docs/error-messages/compiler-errors-2/compiler-error-c3155.md index 313c3c080a6..8fadcc0c30c 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3155.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3155.md @@ -1,20 +1,21 @@ --- -description: "Learn more about: Compiler Error C3155" title: "Compiler Error C3155" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3155" +ms.date: 11/04/2016 f1_keywords: ["C3155"] helpviewer_keywords: ["C3155"] -ms.assetid: b04a42e1-64e7-40f8-81fe-c7945348b2cf --- # Compiler Error C3155 -attributes are not allowed in a property indexer +> attributes are not allowed in a property indexer + +## Remarks An indexed property was declared incorrectly. For more information, see [How to: Use Properties in C++/CLI](../../dotnet/how-to-use-properties-in-cpp-cli.md). ## Example -The following sample generates C3155. +The following example generates C3155. ```cpp // C3155.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3156.md b/docs/error-messages/compiler-errors-2/compiler-error-c3156.md index 6fdca14c852..8f70a06967b 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3156.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3156.md @@ -1,20 +1,21 @@ --- -description: "Learn more about: Compiler Error C3156" title: "Compiler Error C3156" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3156" +ms.date: 11/04/2016 f1_keywords: ["C3156"] helpviewer_keywords: ["C3156"] -ms.assetid: 1876da78-b94e-4af7-9795-28f72b209b3e --- # Compiler Error C3156 -'class' : you cannot have a local definition of a managed or WinRT type +> 'class' : you cannot have a local definition of a managed or WinRT type + +## Remarks A function cannot contain the definition, or declaration, of a managed or WinRT class, struct, or interface. ## Example -The following sample generates C3156. +The following example generates C3156. ```cpp // C3156.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3157.md b/docs/error-messages/compiler-errors-2/compiler-error-c3157.md index bc9741e6078..445bf3ff9ca 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3157.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3157.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Compiler Error C3157" title: "Compiler Error C3157" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3157" +ms.date: 11/04/2016 f1_keywords: ["C3157"] helpviewer_keywords: ["C3157"] -ms.assetid: fe94d97f-612e-4729-8b2b-b057d84822a1 --- # Compiler Error C3157 -ParamArray attribute can only be applied to the last parameter +> ParamArray attribute can only be applied to the last parameter + +## Remarks The attribute was applied to the wrong parameter. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3159.md b/docs/error-messages/compiler-errors-2/compiler-error-c3159.md index 92cdaba9c63..c1090d08ec0 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3159.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3159.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Error C3159" title: "Compiler Error C3159" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3159" +ms.date: 11/04/2016 f1_keywords: ["C3159"] helpviewer_keywords: ["C3159"] -ms.assetid: e115cc76-0021-4568-95fd-61a324c41a85 --- # Compiler Error C3159 -'pointer' : array of pointers to value type cannot be declared +> 'pointer' : array of pointers to value type cannot be declared + +## Remarks An array of pointers to a value type cannot be declared. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3160.md b/docs/error-messages/compiler-errors-2/compiler-error-c3160.md index b28eace9bbe..a509272d5a4 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3160.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3160.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C3160" title: "Compiler Error C3160" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3160" +ms.date: 11/04/2016 f1_keywords: ["C3160"] helpviewer_keywords: ["C3160"] -ms.assetid: a250c433-8adf-43b9-8dee-c3794e09b0a5 --- # Compiler Error C3160 -'pointer' : a data member of a managed or WinRT class cannot have this type +> 'pointer' : a data member of a managed or WinRT class cannot have this type + +## Remarks Interior garbage collection pointers may point to the interior of a managed or WinRT class. Because they are slower than whole-object pointers and require special handling by the garbage collector, you cannot declare interior managed pointers as members of a class. -The following sample generates C3160: +## Example + +The following example generates C3160: ```cpp // C3160.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3161.md b/docs/error-messages/compiler-errors-2/compiler-error-c3161.md index 2dbb59b9051..f462c3b2494 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3161.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3161.md @@ -1,20 +1,21 @@ --- -description: "Learn more about: Compiler Error C3161" title: "Compiler Error C3161" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3161" +ms.date: 11/04/2016 f1_keywords: ["C3161"] helpviewer_keywords: ["C3161"] -ms.assetid: 1fe2be85-a343-487b-8476-bf9e257eb29d --- # Compiler Error C3161 -'interface' : nesting class, struct, union or interface in an interface is illegal; nesting interface in a class, struct or union is illegal +> 'interface' : nesting class, struct, union or interface in an interface is illegal; nesting interface in a class, struct or union is illegal + +## Remarks An [__interface](../../cpp/interface.md) can only appear at global scope or within a namespace. A class, struct, or union cannot appear in an interface. ## Example -The following sample generates C3161. +The following example generates C3161. ```cpp // C3161.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3162.md b/docs/error-messages/compiler-errors-2/compiler-error-c3162.md index 6c059c9c65b..8823e0e12ec 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3162.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3162.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Error C3162" title: "Compiler Error C3162" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3162" +ms.date: 11/04/2016 f1_keywords: ["C3162"] helpviewer_keywords: ["C3162"] -ms.assetid: 0d4c4a24-1456-4191-b7d8-c38cb7b17c32 --- # Compiler Error C3162 -'type' : a reference type which has a destructor cannot be used as the type of static data member 'member' +> 'type' : a reference type which has a destructor cannot be used as the type of static data member 'member' + +## Remarks The common language runtime cannot know when to run a user-defined destructor when the class also contains static member function. @@ -22,7 +23,7 @@ For more information, see, ## Example -The following sample generates C3162. +The following example generates C3162. ```cpp // C3162.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3163.md b/docs/error-messages/compiler-errors-2/compiler-error-c3163.md index efd0231c211..f8d07d28b1b 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3163.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3163.md @@ -1,15 +1,16 @@ --- -description: "Learn more about: Compiler Error C3163" title: "Compiler Error C3163" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3163" +ms.date: 11/04/2016 f1_keywords: ["C3163"] helpviewer_keywords: ["C3163"] -ms.assetid: 17dcafa3-f416-4e04-a232-f9569218ba75 --- # Compiler Error C3163 > '*construct*': attributes inconsistent with previous declaration +## Remarks + The attribute(s) that are applied to a definition conflict with the attribute(s) that are applied to a declaration. One way to resolve C3163 is to eliminate attributes on the forward declaration. Any attributes on a forward declaration should be less than the attributes on the definition or, at most, equal to them. @@ -18,7 +19,7 @@ A possible cause of the C3163 error involves the Microsoft source code annotatio ## Example -The following sample generates C3163. +The following example generates C3163. ```cpp // C3163.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3166.md b/docs/error-messages/compiler-errors-2/compiler-error-c3166.md index 6b12aa26515..4c7d4cdb3f7 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3166.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3166.md @@ -1,15 +1,16 @@ --- -description: "Learn more about: Compiler Error C3166" title: "Compiler Error C3166" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3166" +ms.date: 11/04/2016 f1_keywords: ["C3166"] helpviewer_keywords: ["C3166"] -ms.assetid: ec3e330d-c15d-4158-8268-09101486c566 --- # Compiler Error C3166 > 'pointer' : cannot declare a pointer to an interior __gc pointer as a member of 'type' +## Remarks + The compiler found an invalid pointer declaration (a **`__nogc`** pointer to a **`__gc`** pointer.). C3166 is only reachable using the obsolete compiler option **`/clr:oldSyntax`**. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3167.md b/docs/error-messages/compiler-errors-2/compiler-error-c3167.md index 32c75e4d421..62b80984084 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3167.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3167.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Compiler Error C3167" title: "Compiler Error C3167" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3167" +ms.date: 11/04/2016 f1_keywords: ["C3167"] helpviewer_keywords: ["C3167"] -ms.assetid: 58c25fe7-8562-4a18-ad3f-487f081ff173 --- # Compiler Error C3167 -Unable to initialize .NET Framework: make sure it is installed +> Unable to initialize .NET Framework: make sure it is installed + +## Remarks The .NET Framework is not installed on this computer; install the .NET Framework. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3168.md b/docs/error-messages/compiler-errors-2/compiler-error-c3168.md index bdfd093a15a..fe5c27dd2ce 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3168.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3168.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C3168" title: "Compiler Error C3168" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3168" +ms.date: 11/04/2016 f1_keywords: ["C3168"] helpviewer_keywords: ["C3168"] -ms.assetid: 4c36fcfb-c351-48ff-b4eb-78d2aa1b4d55 --- # Compiler Error C3168 -'type' : illegal underlying type for enum +> 'type' : illegal underlying type for enum + +## Remarks The underlying type you specified for the **`enum`** type was not valid. The underlying type must be an integral C++ type or a corresponding CLR type. -The following sample generates C3168: +## Example + +The following example generates C3168: ```cpp // C3168.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3170.md b/docs/error-messages/compiler-errors-2/compiler-error-c3170.md index 10e9b317c49..5613a0ec2d4 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3170.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3170.md @@ -1,19 +1,22 @@ --- -description: "Learn more about: Compiler Error C3170" title: "Compiler Error C3170" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3170" +ms.date: 11/04/2016 f1_keywords: ["C3170"] helpviewer_keywords: ["C3170"] -ms.assetid: ca9a59d6-7df3-42f0-b028-c09d0af3ac2a --- # Compiler Error C3170 -cannot have different module identifiers in a project +> cannot have different module identifiers in a project + +## Remarks [module](../../windows/attributes/module-cpp.md) attributes with different names were found in two of the files in a compilation. Only one unique `module` attribute can be specified per compilation. Identical `module` attributes can be specified in more than one source code file. +## Example + For example, if the following module attributes were found: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3171.md b/docs/error-messages/compiler-errors-2/compiler-error-c3171.md index b51a5d11dd0..63f770be44f 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3171.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3171.md @@ -1,19 +1,22 @@ --- -description: "Learn more about: Compiler Error C3171" title: "Compiler Error C3171" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3171" +ms.date: 11/04/2016 f1_keywords: ["C3171"] helpviewer_keywords: ["C3171"] -ms.assetid: 1ce26997-7ef1-4c9f-84da-003ea1a4251e --- # Compiler Error C3171 -'module': cannot specify different module attributes in a project +> 'module': cannot specify different module attributes in a project + +## Remarks [module](../../windows/attributes/module-cpp.md) attributes with different parameter lists were found in two of the files in a compilation. Only one unique `module` attribute can be specified per compilation. Identical `module` attributes can be specified in more than one source code file. +## Example + For example, if the following `module` attributes were found: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3172.md b/docs/error-messages/compiler-errors-2/compiler-error-c3172.md index 832aaa9c403..5bcbd0ef9ef 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3172.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3172.md @@ -1,19 +1,22 @@ --- -description: "Learn more about: Compiler Error C3172" title: "Compiler Error C3172" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3172" +ms.date: 11/04/2016 f1_keywords: ["C3172"] helpviewer_keywords: ["C3172"] -ms.assetid: 1834e2fd-6036-4c33-aff2-b51bc7c99441 --- # Compiler Error C3172 -'module_name': cannot specify different idl_module attributes in a project +> 'module_name': cannot specify different idl_module attributes in a project + +## Remarks [idl_module](../../windows/attributes/idl-module.md) attributes with the same name but different `dllname` or `version` parameters were found in two of the files in a compilation. Only one unique `idl_module` attribute can be specified per compilation. Identical `idl_module` attributes can be specified in more than one source code file. +## Example + For example, if the following `idl_module` attributes were found: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3173.md b/docs/error-messages/compiler-errors-2/compiler-error-c3173.md index 264132ec13c..39d61590982 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3173.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3173.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Error C3173" title: "Compiler Error C3173" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3173" +ms.date: 11/04/2016 f1_keywords: ["C3173"] helpviewer_keywords: ["C3173"] -ms.assetid: edf79e10-e8cf-4f76-8d33-ab9d05e974e9 --- # Compiler Error C3173 -version mismatch in idl merge +> version mismatch in idl merge + +## Remarks This error occurs when an object file contains embedded idl that was generated with a previous version of the compiler. The compiler encodes a version number to ensure that the same compiler used to generate the idl content that is embedded in the .obj files is also the same compiler used to merge the embedded idl. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3174.md b/docs/error-messages/compiler-errors-2/compiler-error-c3174.md index 43fbd18675c..c73157a2997 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3174.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3174.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C3174" title: "Compiler Error C3174" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3174" +ms.date: 11/04/2016 f1_keywords: ["C3174"] helpviewer_keywords: ["C3174"] -ms.assetid: fe6b3b5a-8196-485f-a45f-0b2e51df4086 --- # Compiler Error C3174 -module attribute was not specified +> module attribute was not specified + +## Remarks A program that uses Visual C++ attributes did not also use the [module](../../windows/attributes/module-cpp.md) attribute, which is required in any program that uses attributes. -The following sample generates C3174: +## Example + +The following example generates C3174: ```cpp // C3174.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3175.md b/docs/error-messages/compiler-errors-2/compiler-error-c3175.md index 410de47bc69..8cce6182a2d 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3175.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3175.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C3175" title: "Compiler Error C3175" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3175" +ms.date: 11/04/2016 f1_keywords: ["C3175"] helpviewer_keywords: ["C3175"] -ms.assetid: 3f19d513-a05a-4b6c-806f-276fe5c36b90 --- # Compiler Error C3175 -'function1' : cannot call a method of a managed type from unmanaged function 'function2' +> 'function1' : cannot call a method of a managed type from unmanaged function 'function2' + +## Remarks Unmanaged functions cannot call member functions of managed classes. -The following sample generates C3175: +## Example + +The following example generates C3175: ```cpp // C3175_2.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3176.md b/docs/error-messages/compiler-errors-2/compiler-error-c3176.md index 9252c20ad4c..dac1b4f9bdc 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3176.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3176.md @@ -1,20 +1,21 @@ --- -description: "Learn more about: Compiler Error C3176" title: "Compiler Error C3176" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3176" +ms.date: 11/04/2016 f1_keywords: ["C3176"] helpviewer_keywords: ["C3176"] -ms.assetid: 6cc8d602-8e15-47a7-b1b5-e93e5d50e271 --- # Compiler Error C3176 -'type' : cannot declare local value type +> 'type' : cannot declare local value type + +## Remarks A class can only be declared as a value type at global scope. ## Example -The following sample generates C3176. +The following example generates C3176. ```cpp // C3176.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3179.md b/docs/error-messages/compiler-errors-2/compiler-error-c3179.md index 3ae78d152d7..20752c024d2 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3179.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3179.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C3179" title: "Compiler Error C3179" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3179" +ms.date: 11/04/2016 f1_keywords: ["C3179"] helpviewer_keywords: ["C3179"] -ms.assetid: 60d7e41b-25fd-48ac-8b79-830c062f4dcd --- # Compiler Error C3179 -an unnamed managed or WinRT type is not allowed +> an unnamed managed or WinRT type is not allowed + +## Remarks All CLR and WinRT classes and structs must have names. -The following sample generates C3179 and shows how to fix it: +## Example + +The following example generates C3179 and shows how to fix it: ```cpp // C3179a.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3180.md b/docs/error-messages/compiler-errors-2/compiler-error-c3180.md index 7c795d00663..c5e39e638b9 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3180.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3180.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Error C3180" title: "Compiler Error C3180" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3180" +ms.date: 11/04/2016 f1_keywords: ["C3180"] helpviewer_keywords: ["C3180"] -ms.assetid: 5281f583-7df7-418a-8507-d4da67ed6572 --- # Compiler Error C3180 -'type name' : name exceeds meta-data limit of 'limit' characters +> 'type name' : name exceeds meta-data limit of 'limit' characters + +## Remarks The compiler truncated the name for a managed type in metadata. The truncation will make the type unusable with the `#using` directive (or the equivalent in another language). diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3181.md b/docs/error-messages/compiler-errors-2/compiler-error-c3181.md index 1af9f7eccf5..4c71262029e 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3181.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3181.md @@ -1,20 +1,23 @@ --- -description: "Learn more about: Compiler Error C3181" title: "Compiler Error C3181" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3181" +ms.date: 11/04/2016 f1_keywords: ["C3181"] helpviewer_keywords: ["C3181"] -ms.assetid: 5d450f8b-6cef-4452-a0c4-2076e967451d --- # Compiler Error C3181 -'type' : invalid operand for operator +> 'type' : invalid operand for operator + +## Remarks An invalid parameter was passed to the [typeid](../../extensions/typeid-cpp-component-extensions.md) operator. The parameter must be a managed type. Note that the compiler uses aliases for native types that map to types in the common language runtime. -The following sample generates C3181: +## Example + +The following example generates C3181: ```cpp // C3181a.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3182.md b/docs/error-messages/compiler-errors-2/compiler-error-c3182.md index 9c3772dff9c..56822448225 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3182.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3182.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C3182" title: "Compiler Error C3182" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3182" +ms.date: 11/04/2016 f1_keywords: ["C3182"] helpviewer_keywords: ["C3182"] -ms.assetid: f3681266-308e-4990-a979-8eef8920e186 --- # Compiler Error C3182 -'class' : a member using-declaration or access declaration is illegal within a managed or WinRTtype +> 'class' : a member using-declaration or access declaration is illegal within a managed or WinRTtype + +## Remarks A [using](../../cpp/using-declaration.md) declaration is invalid within all forms of managed classes. -The following sample generates C3182 and shows how to fix it. +## Example + +The following example generates C3182 and shows how to fix it. ```cpp // C3182a.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3183.md b/docs/error-messages/compiler-errors-2/compiler-error-c3183.md index 82ad13cdc56..c23ae7054a4 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3183.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3183.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C3183" title: "Compiler Error C3183" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3183" +ms.date: 11/04/2016 f1_keywords: ["C3183"] helpviewer_keywords: ["C3183"] -ms.assetid: dbd0f020-c739-43c9-947e-9ce21537331b --- # Compiler Error C3183 -cannot define unnamed class, struct or union inside of managed or WinRT type 'type' +> cannot define unnamed class, struct or union inside of managed or WinRT type 'type' + +## Remarks A type that is embedded in a managed or WinRT type must be named. -The following sample generates C3183: +## Example + +The following example generates C3183: ```cpp // C3183a.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3185.md b/docs/error-messages/compiler-errors-2/compiler-error-c3185.md index cad61481f3e..a4b6c832e37 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3185.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3185.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C3185" title: "Compiler Error C3185" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3185" +ms.date: 11/04/2016 f1_keywords: ["C3185"] helpviewer_keywords: ["C3185"] -ms.assetid: 5bf96279-043c-4981-9d02-b4550071b192 --- # Compiler Error C3185 -'typeid' used on managed or WinRT type 'type', use 'operator' instead +> 'typeid' used on managed or WinRT type 'type', use 'operator' instead + +## Remarks You cannot apply the [typeid](../../cpp/typeid-operator.md) operator to a managed or WinRT type; use [typeid](../../extensions/typeid-cpp-component-extensions.md) instead. -The following sample generates C3185 and shows how to fix it: +## Example + +The following example generates C3185 and shows how to fix it: ```cpp // C3185a.cpp @@ -25,5 +28,5 @@ int main() { Base ^pb = pd; const type_info & t1 = typeid(pb); // C3185 System::Type ^ MyType = Base::typeid; // OK -}; +} ``` diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3187.md b/docs/error-messages/compiler-errors-2/compiler-error-c3187.md index 4ef3efeedb4..1bb673cd78a 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3187.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3187.md @@ -1,15 +1,39 @@ --- -description: "Learn more about: Compiler Error C3187" title: "Compiler Error C3187" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3187" +ms.date: 01/28/2026 f1_keywords: ["C3187"] helpviewer_keywords: ["C3187"] -ms.assetid: 9d2ebf55-1a6a-4087-bf5b-5274baae6351 --- # Compiler Error C3187 -> '`__func__`' : is only available within the body of a function +> '`__func__`': is only available within the body of a function + +## Remarks + +The predefined identifier [`__func__`](../../cpp/func.md) is not available outside the body of a function. + +To correct this error, move the identifier inside the body of a function. + +## Example + +The following example generates C3187: + +```cpp +// compile with: /c + +#include + +auto global = __func__; // C3187, usage in global scope +void func(const char* f = __func__); // C3187, usage in parameter list + +// correct usage inside a function +void test() +{ + std::cout << __func__; // outputs: test +} +``` -The predefined macro is not available outside the body of a function. +## See also -To correct this error, move the macro inside the body of a function. +[C2457](../compiler-errors-1/compiler-error-c2457.md) diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3189.md b/docs/error-messages/compiler-errors-2/compiler-error-c3189.md index 6197c274ae7..90248e75159 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3189.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3189.md @@ -1,20 +1,23 @@ --- -description: "Learn more about: Compiler Error C3189" title: "Compiler Error C3189" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3189" +ms.date: 11/04/2016 f1_keywords: ["C3189"] helpviewer_keywords: ["C3189"] -ms.assetid: b254de79-931e-4a59-a9f4-1c690d90ca5e --- # Compiler Error C3189 > 'typeid\': this syntax is no longer supported, use ::typeid instead +## Remarks + An obsolete form of [typeid](../../extensions/typeid-cpp-component-extensions.md) was used, use the new form. This error is obsolete in Visual Studio 2022 and later versions. -The following sample generates C3189: +## Example + +The following example generates C3189: ```cpp // C3189.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3190.md b/docs/error-messages/compiler-errors-2/compiler-error-c3190.md index a1fd356cb1b..3b55ad91f4e 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3190.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3190.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C3190" title: "Compiler Error C3190" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3190" +ms.date: 11/04/2016 f1_keywords: ["C3190"] helpviewer_keywords: ["C3190"] -ms.assetid: 7c701afa-85a7-4f7a-8881-0662436ac244 --- # Compiler Error C3190 -'instantiation' with the provided template arguments is not the explicit instantiation of any member function of 'type' +> 'instantiation' with the provided template arguments is not the explicit instantiation of any member function of 'type' + +## Remarks The compiler detected an attempt to make an explicit function instantiation; however, the provided type arguments do not match any of the possible functions. -The following sample generates C3190: +## Example + +The following example generates C3190: ```cpp // C3190.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3192.md b/docs/error-messages/compiler-errors-2/compiler-error-c3192.md index b9e9dd8a921..28b5f9c2d5a 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3192.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3192.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C3192" title: "Compiler Error C3192" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3192" +ms.date: 11/04/2016 f1_keywords: ["C3192"] helpviewer_keywords: ["C3192"] -ms.assetid: 8b0083d4-706f-46f6-858a-e1d9af464cf8 --- # Compiler Error C3192 -syntax error : '^' is not a prefix operator (did you mean '*'?) +> syntax error : '^' is not a prefix operator (did you mean '*'?) + +## Remarks A handle cannot be used as a dereference operator. -The following sample generates C3192: +## Example + +The following example generates C3192: ```cpp // C3192.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3194.md b/docs/error-messages/compiler-errors-2/compiler-error-c3194.md index a33d63090f6..8db7784857a 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3194.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3194.md @@ -1,20 +1,21 @@ --- -description: "Learn more about: Compiler Error C3194" title: "Compiler Error C3194" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3194" +ms.date: 11/04/2016 f1_keywords: ["C3194"] helpviewer_keywords: ["C3194"] -ms.assetid: 49d3ffc6-eff6-4b46-865b-18811692a8bb --- # Compiler Error C3194 -'member' : a value-type cannot have an assignment operator +> 'member' : a value-type cannot have an assignment operator + +## Remarks Special member functions that require automatic invocation by the compiler, such as a copy constructor or copy assignment operator are not supported within a value class. ## Example -The following sample generates C3194. +The following example generates C3194. ```cpp // C3194.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3195.md b/docs/error-messages/compiler-errors-2/compiler-error-c3195.md index 415527ec2dd..ec488b88ac7 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3195.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3195.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C3195" title: "Compiler Error C3195" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3195" +ms.date: 11/04/2016 f1_keywords: ["C3195"] helpviewer_keywords: ["C3195"] -ms.assetid: 97e4f681-812b-49e8-ba57-24b7817e3cd8 --- # Compiler Error C3195 -'operator' : is reserved and cannot be used as a member of a ref class or value type. CLR or WinRT operators must be defined using the 'operator' keyword +> 'operator' : is reserved and cannot be used as a member of a ref class or value type. CLR or WinRT operators must be defined using the 'operator' keyword + +## Remarks The compiler detected an operator definition using the Managed Extensions for C++ syntax. You must use the C++ syntax for operators. -The following sample generates C3195 and shows how to fix it: +## Example + +The following example generates C3195 and shows how to fix it: ```cpp // C3195.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3196.md b/docs/error-messages/compiler-errors-2/compiler-error-c3196.md index 38cf9afdc32..070c0c87ed4 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3196.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3196.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C3196" title: "Compiler Error C3196" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3196" +ms.date: 11/04/2016 f1_keywords: ["C3196"] helpviewer_keywords: ["C3196"] -ms.assetid: d9c38a13-191d-472d-aa2b-f61a6459d16c --- # Compiler Error C3196 -'keyword' : used more than once +> 'keyword' : used more than once + +## Remarks A keyword was used more than once. -The following sample generates C3196: +## Example + +The following example generates C3196: ```cpp // C3196.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3197.md b/docs/error-messages/compiler-errors-2/compiler-error-c3197.md index b5153e95918..3362584a4a0 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3197.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3197.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C3197" title: "Compiler Error C3197" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3197" +ms.date: 11/04/2016 f1_keywords: ["C3197"] helpviewer_keywords: ["C3197"] -ms.assetid: 4e385c3b-222e-425c-9612-46e83ed41650 --- # Compiler Error C3197 -'keyword' : can only be used in definitions +> 'keyword' : can only be used in definitions + +## Remarks A keyword was used in a declaration but is only valid in a definition. -The following sample generates C3197: +## Example + +The following example generates C3197: ```cpp // C3197.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3198.md b/docs/error-messages/compiler-errors-2/compiler-error-c3198.md index d853ab33b43..b871f254a6e 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3198.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3198.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C3198" title: "Compiler Error C3198" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3198" +ms.date: 11/04/2016 f1_keywords: ["C3198"] helpviewer_keywords: ["C3198"] -ms.assetid: ec4ecf61-0067-4aa4-b443-a91013a1e59d --- # Compiler Error C3198 -invalid use of floating-point pragmas: fenv_access pragma operates only in precise mode +> invalid use of floating-point pragmas: fenv_access pragma operates only in precise mode + +## Remarks [fenv_access](../../preprocessor/fenv-access.md) pragma was used under an [/fp](../../build/reference/fp-specify-floating-point-behavior.md) setting other than **/fp:precise**. -The following sample generates C3198: +## Example + +The following example generates C3198: ```cpp // C3198.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3199.md b/docs/error-messages/compiler-errors-2/compiler-error-c3199.md index 724e71a9f0d..fd0da44ace7 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3199.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3199.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C3199" title: "Compiler Error C3199" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3199" +ms.date: 11/04/2016 f1_keywords: ["C3199"] helpviewer_keywords: ["C3199"] -ms.assetid: e7a478d3-115a-40a3-991b-c7454fd2e28e --- # Compiler Error C3199 -invalid use of floating-point pragmas: exceptions are not supported in non-precise mode +> invalid use of floating-point pragmas: exceptions are not supported in non-precise mode + +## Remarks The [float_control](../../preprocessor/float-control.md) pragma was used to specify floating-point exception model under an [/fp](../../build/reference/fp-specify-floating-point-behavior.md) setting other than **/fp:precise**. -The following sample generates C3199: +## Example + +The following example generates C3199: ```cpp // C3199.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3200.md b/docs/error-messages/compiler-errors-2/compiler-error-c3200.md index e4b6fe76163..548a0b21c5a 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3200.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3200.md @@ -1,16 +1,21 @@ --- -description: "Learn more about: Compiler Error C3200" title: "Compiler Error C3200" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3200" +ms.date: 11/04/2016 f1_keywords: ["C3200"] helpviewer_keywords: ["C3200"] -ms.assetid: 44bb5e77-f0ec-421c-a732-b9ee7c0a3529 --- # Compiler Error C3200 -'template' : invalid template argument for template parameter 'parameter', expected a class template +> 'template' : invalid template argument for template parameter 'parameter', expected a class template + +## Remarks + +You passed an invalid argument to a class template. The class template expects template as a parameter. + +## Example -You passed an invalid argument to a class template. The class template expects template as a parameter. In the following example, calling `Y aY` will generate C3200. The first parameter needs to be a template, such as `Y aY`. +In the following example, calling `Y aY` will generate C3200. The first parameter needs to be a template, such as `Y aY`. ```cpp // C3200.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3201.md b/docs/error-messages/compiler-errors-2/compiler-error-c3201.md index a8042c538fe..6799ee98060 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3201.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3201.md @@ -1,17 +1,22 @@ --- -description: "Learn more about: Compiler Error C3201" title: "Compiler Error C3201" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3201" +ms.date: 11/04/2016 f1_keywords: ["C3201"] helpviewer_keywords: ["C3201"] -ms.assetid: ec19cd64-1789-40a3-b2db-dff2852b9d98 --- # Compiler Error C3201 -the template parameter list for class template 'template' does not match the template parameter list for template parameter 'template' +> the template parameter list for class template 'template' does not match the template parameter list for template parameter 'template' + +## Remarks You passed a class template in the argument to a class template that does not take a template parameter, or you passed a mismatched number of template arguments for the default template argument. +## Example + +The following example generates C3201: + ```cpp // C3201.cpp template diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3202.md b/docs/error-messages/compiler-errors-2/compiler-error-c3202.md index 30bd9a0ebd0..f84c285a958 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3202.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3202.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C3202" title: "Compiler Error C3202" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3202" +ms.date: 11/04/2016 f1_keywords: ["C3202"] helpviewer_keywords: ["C3202"] -ms.assetid: 23528a0c-5493-4804-9789-cd3c38e49fb9 --- # Compiler Error C3202 -'arg name' : invalid default argument for template parameter 'parameter', expected a class template +> 'arg name' : invalid default argument for template parameter 'parameter', expected a class template + +## Remarks You passed an invalid default argument for a template parameter. -The following sample generates C3202: +## Example + +The following example generates C3202: ```cpp // C3202.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3203.md b/docs/error-messages/compiler-errors-2/compiler-error-c3203.md index f06d5ca3de2..9eda8670397 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3203.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3203.md @@ -1,19 +1,24 @@ --- -description: "Learn more about: Compiler Error C3203" title: "Compiler Error C3203" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3203" +ms.date: 11/04/2016 f1_keywords: ["C3203"] helpviewer_keywords: ["C3203"] -ms.assetid: 6356770e-22c1-434c-91fe-f60b0aa23b91 --- # Compiler Error C3203 -'type' : unspecialized class template or generic can't be used as a template or generic argument for template or generic parameter 'param', expected a real type +> 'type' : unspecialized class template or generic can't be used as a template or generic argument for template or generic parameter 'param', expected a real type + +## Remarks You passed an invalid argument to a class template or generic. The class template or generic expects a type as a parameter. This error can be generated as a result of compiler conformance work that was done for Visual Studio 2005: an unspecialized class template can't be used as a template argument in a base class list. To resolve C3203, explicitly add the template type parameter(s) to the template class name when using it as a template parameter in a base class list. +## Examples + +The following example generates C3203: + ```cpp // C3203.cpp template< typename T > @@ -33,7 +38,7 @@ int main() { } ``` -The following sample generates C3203 and shows how to fix it: +The following example generates C3203 and shows how to fix it: ```cpp // C3203_b.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3204.md b/docs/error-messages/compiler-errors-2/compiler-error-c3204.md index 60063fce8c1..fcbc33e8a80 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3204.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3204.md @@ -1,20 +1,21 @@ --- -description: "Learn more about: Compiler Error C3204" title: "Compiler Error C3204" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3204" +ms.date: 11/04/2016 f1_keywords: ["C3204"] helpviewer_keywords: ["C3204"] -ms.assetid: 06e578da-0262-48c8-b2ae-be1cd6d28884 --- # Compiler Error C3204 -'_alloca' cannot be called from within a catch block +> '_alloca' cannot be called from within a catch block + +## Remarks This error occurs when you use a call to [_alloca](../../c-runtime-library/reference/alloca.md) from within a catch block. ## Example -The following sample generates C3204: +The following example generates C3204: ```cpp // C3204.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3205.md b/docs/error-messages/compiler-errors-2/compiler-error-c3205.md index 40350e71348..0e0223a4cd1 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3205.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3205.md @@ -1,20 +1,21 @@ --- -description: "Learn more about: Compiler Error C3205" title: "Compiler Error C3205" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3205" +ms.date: 11/04/2016 f1_keywords: ["C3205"] helpviewer_keywords: ["C3205"] -ms.assetid: 802d306e-5ff3-4491-8a22-c5f1c072d005 --- # Compiler Error C3205 -argument list for template parameter 'parameter' is missing +> argument list for template parameter 'parameter' is missing + +## Remarks A [template](../../cpp/templates-cpp.md) parameter is missing. ## Example -The following sample generates C3205: +The following example generates C3205: ```cpp // C3205.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3206.md b/docs/error-messages/compiler-errors-2/compiler-error-c3206.md index 0832f2a6ebe..188fa575037 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3206.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3206.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C3206" title: "Compiler Error C3206" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3206" +ms.date: 11/04/2016 f1_keywords: ["C3206"] helpviewer_keywords: ["C3206"] -ms.assetid: d62995b5-e349-4418-bbe8-8a5e776ca7b0 --- # Compiler Error C3206 -'function' : invalid type argument for 'param', missing type argument list on class type 'typename' +> 'function' : invalid type argument for 'param', missing type argument list on class type 'typename' + +## Remarks A function template is defined as taking a template type argument. However, a template template argument was passed. -The following sample generates C3206: +## Examples + +The following example generates C3206: ```cpp // C3206.cpp @@ -77,7 +80,7 @@ int main() { } ``` -A class template is not allowed as a template type argument. The following sample raises C3206: +A class template is not allowed as a template type argument. The following example raises C3206: ```cpp // C3206e.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3207.md b/docs/error-messages/compiler-errors-2/compiler-error-c3207.md index bef3bea2a4a..b26b866d47d 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3207.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3207.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C3207" title: "Compiler Error C3207" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3207" +ms.date: 11/04/2016 f1_keywords: ["C3207"] helpviewer_keywords: ["C3207"] -ms.assetid: 4a28b976-142a-4cff-aa2f-480b892c50ca --- # Compiler Error C3207 -'function' : invalid template argument for 'arg', class template expected +> 'function' : invalid template argument for 'arg', class template expected + +## Remarks A function template is defined as taking a template template argument. However, a template type argument was passed. -The following sample generates C3207: +## Example + +The following example generates C3207: ```cpp // C3207.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3208.md b/docs/error-messages/compiler-errors-2/compiler-error-c3208.md index 503703f98ee..f8478e5ba06 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3208.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3208.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C3208" title: "Compiler Error C3208" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3208" +ms.date: 11/04/2016 f1_keywords: ["C3208"] helpviewer_keywords: ["C3208"] -ms.assetid: 6d060bfe-52cf-4599-8f70-bdeb5a670df3 --- # Compiler Error C3208 -'function' : template parameter list for class template 'class' does not match template parameter list for template template parameter 'parameter' +> 'function' : template parameter list for class template 'class' does not match template parameter list for template template parameter 'parameter' + +## Remarks A template template parameter does not have the same number of template parameters as the provided class template. -The following sample generates C3208: +## Example + +The following example generates C3208: ```cpp // C3208.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3209.md b/docs/error-messages/compiler-errors-2/compiler-error-c3209.md index 333144c305b..7be3106af49 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3209.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3209.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C3209" title: "Compiler Error C3209" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3209" +ms.date: 11/04/2016 f1_keywords: ["C3209"] helpviewer_keywords: ["C3209"] -ms.assetid: 1de44e39-69d1-4894-8f89-ff92136e8e5d --- # Compiler Error C3209 -'class' : generic class must be a managed or WinRTclass +> 'class' : generic class must be a managed or WinRTclass + +## Remarks A generic class must be a managed class or a Windows Runtime class. -The following sample generates C3209 and shows how to fix it: +## Example + +The following example generates C3209 and shows how to fix it: ```cpp // C3209.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3210.md b/docs/error-messages/compiler-errors-2/compiler-error-c3210.md index 53f447d6de6..bea665dad72 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3210.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3210.md @@ -1,20 +1,21 @@ --- -description: "Learn more about: Compiler Error C3210" title: "Compiler Error C3210" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3210" +ms.date: 11/04/2016 f1_keywords: ["C3210"] helpviewer_keywords: ["C3210"] -ms.assetid: c6e9d309-fabc-4e7d-b526-be20d9fe3f6a --- # Compiler Error C3210 -'type' : access declaration can only be applied to a base class member +> 'type' : access declaration can only be applied to a base class member + +## Remarks A [using declaration](../../cpp/using-declaration.md) was specified incorrectly. ## Example -The following sample generates C3210. +The following example generates C3210. ```cpp // C3210.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3211.md b/docs/error-messages/compiler-errors-2/compiler-error-c3211.md index 964563891f5..be567ccd716 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3211.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3211.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C3211" title: "Compiler Error C3211" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3211" +ms.date: 11/04/2016 f1_keywords: ["C3211"] helpviewer_keywords: ["C3211"] -ms.assetid: 85e33fed-3b59-4315-97e6-20d31c6a985a --- # Compiler Error C3211 -'explicit specialization' : explicit specialization is using partial specialization syntax, use template <> instead +> 'explicit specialization' : explicit specialization is using partial specialization syntax, use template <> instead + +## Remarks An explicit specialization was ill formed. -The following sample generates C3211: +## Example + +The following example generates C3211: ```cpp // C3211.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3212.md b/docs/error-messages/compiler-errors-2/compiler-error-c3212.md index 0930774cd11..0364fb2ac86 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3212.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3212.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C3212" title: "Compiler Error C3212" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3212" +ms.date: 11/04/2016 f1_keywords: ["C3212"] helpviewer_keywords: ["C3212"] -ms.assetid: 9e271bb6-a51f-4b96-b26b-9f4ca28fca0a --- # Compiler Error C3212 -'specialization' : an explicit specialization of a template member must be a member of an explicit specialization +> 'specialization' : an explicit specialization of a template member must be a member of an explicit specialization + +## Remarks An explicit specialization was ill formed. -The following sample generates C3212: +## Example + +The following example generates C3212: ```cpp // C3212.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3213.md b/docs/error-messages/compiler-errors-2/compiler-error-c3213.md index 9e56eefd1b3..92f037e2fc1 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3213.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3213.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C3213" title: "Compiler Error C3213" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3213" +ms.date: 11/04/2016 f1_keywords: ["C3213"] helpviewer_keywords: ["C3213"] -ms.assetid: 1f079e36-b3e9-40f8-8e95-08eeba3adc82 --- # Compiler Error C3213 -base class 'base_type' is less accessible than 'derived_type' +> base class 'base_type' is less accessible than 'derived_type' + +## Remarks A type that will be visible from an assembly must use publicly visible base classes. -The following sample generates C3213: +## Example + +The following example generates C3213: ```cpp // C3213.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3214.md b/docs/error-messages/compiler-errors-2/compiler-error-c3214.md index 7eeb9bc371a..7f83f18b2e9 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3214.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3214.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C3214" title: "Compiler Error C3214" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3214" +ms.date: 11/04/2016 f1_keywords: ["C3214"] helpviewer_keywords: ["C3214"] -ms.assetid: 49ee4a9a-2549-4adb-9d3a-38e154303c2e --- # Compiler Error C3214 -'type' : invalid type argument for generic parameter 'param' of generic 'generic_type', does not meet constraint 'constraint' +> 'type' : invalid type argument for generic parameter 'param' of generic 'generic_type', does not meet constraint 'constraint' + +## Remarks The type was specified for an instantiation of a generic class that does not meet the generic class's constraint. -The following sample generates C3214: +## Example + +The following example generates C3214: ```cpp // C3214.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3215.md b/docs/error-messages/compiler-errors-2/compiler-error-c3215.md index 6a6ca708566..23799ce938e 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3215.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3215.md @@ -1,20 +1,23 @@ --- -description: "Learn more about: Compiler Error C3215" title: "Compiler Error C3215" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3215" +ms.date: 11/04/2016 f1_keywords: ["C3215"] helpviewer_keywords: ["C3215"] -ms.assetid: d0d16007-8885-42e0-b086-2d3a61f348c5 --- # Compiler Error C3215 -'type1' : generic type parameter already constrained by 'type2' +> 'type1' : generic type parameter already constrained by 'type2' + +## Remarks A constraint was specified more than once. For more information on generics, see [Generics](../../extensions/generics-cpp-component-extensions.md). -The following sample generates C3215: +## Example + +The following example generates C3215: ```cpp // C3215.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3216.md b/docs/error-messages/compiler-errors-2/compiler-error-c3216.md index bbb2967e39e..22291b161a0 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3216.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3216.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C3216" title: "Compiler Error C3216" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3216" +ms.date: 11/04/2016 f1_keywords: ["C3216"] helpviewer_keywords: ["C3216"] -ms.assetid: bbab1efe-8779-4489-8bb0-b11e45f5cbe5 --- # Compiler Error C3216 -constraint must be a generic parameter, not 'type' +> constraint must be a generic parameter, not 'type' + +## Remarks A constraint was ill formed. -The following sample generates C3216: +## Example + +The following example generates C3216: ```cpp // C3216.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3217.md b/docs/error-messages/compiler-errors-2/compiler-error-c3217.md index 8cacbfeb157..c2628b1b6b8 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3217.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3217.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C3217" title: "Compiler Error C3217" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3217" +ms.date: 11/04/2016 f1_keywords: ["C3217"] helpviewer_keywords: ["C3217"] -ms.assetid: 99070417-c23a-4d82-bdd2-04be1a07adea --- # Compiler Error C3217 -'param' : generic parameter cannot be constrained in this declaration +> 'param' : generic parameter cannot be constrained in this declaration + +## Remarks A constraint was ill formed; the constraint generic parameter must agree with the generic class template parameter. -The following sample generates C3217: +## Example + +The following example generates C3217: ```cpp // C3217.cpp @@ -27,7 +30,7 @@ ref class C { }; ``` -The following sample demonstrates a possible resolution: +The following example demonstrates a possible resolution: ```cpp // C3217b.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3218.md b/docs/error-messages/compiler-errors-2/compiler-error-c3218.md index c1abbab3d5a..691dc13049b 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3218.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3218.md @@ -1,20 +1,21 @@ --- -description: "Learn more about: Compiler Error C3218" title: "Compiler Error C3218" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3218" +ms.date: 11/04/2016 f1_keywords: ["C3218"] helpviewer_keywords: ["C3218"] -ms.assetid: 0eea19e0-503e-4e07-ae8b-2cb2e95922cd --- # Compiler Error C3218 -'type' : type not allowed as a constraint +> 'type' : type not allowed as a constraint + +## Remarks For a type to be a constraint, it must be either a value type or reference to a managed class or interface. ## Example -The following sample generates C3218. +The following example generates C3218. ```cpp // C3218.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3219.md b/docs/error-messages/compiler-errors-2/compiler-error-c3219.md index 4ee80752f48..4800bece797 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3219.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3219.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C3219" title: "Compiler Error C3219" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3219" +ms.date: 11/04/2016 f1_keywords: ["C3219"] helpviewer_keywords: ["C3219"] -ms.assetid: 9c9757b0-1256-4cdf-9d8c-a3a72f300ce5 --- # Compiler Error C3219 -'param' : generic parameter cannot be constrained by multiple non-interfaces : 'class' +> 'param' : generic parameter cannot be constrained by multiple non-interfaces : 'class' + +## Remarks It is not valid to constrain a generic parameter by two or more managed classes. -The following sample generates C3219: +## Example + +The following example generates C3219: ```cpp // C3219.cpp @@ -25,7 +28,7 @@ where T : A, B ref class E {}; // C3219 ``` -The following sample demonstrates a possible resolution: +The following example demonstrates a possible resolution: ```cpp // C3219b.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3222.md b/docs/error-messages/compiler-errors-2/compiler-error-c3222.md index 09815402d91..0bf257f399f 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3222.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3222.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C3222" title: "Compiler Error C3222" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3222" +ms.date: 11/04/2016 f1_keywords: ["C3222"] helpviewer_keywords: ["C3222"] -ms.assetid: 5624bde8-2fd0-4b8b-92ce-5dfbaf91cf93 --- # Compiler Error C3222 -'parameter' : cannot declare default arguments for member functions of a managed or WinRT type or generic functions +> 'parameter' : cannot declare default arguments for member functions of a managed or WinRT type or generic functions + +## Remarks It is not permitted to declare a method parameter with a default argument. An overloaded form of the method is one way to work around this issue. That is, define a method with the same name with no parameters and then initialize the variable in the method body. -The following sample generates C3222: +## Example + +The following example generates C3222: ```cpp // C3222_2.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3223.md b/docs/error-messages/compiler-errors-2/compiler-error-c3223.md index 0895d06aaa9..778004eaa27 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3223.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3223.md @@ -1,20 +1,21 @@ --- -description: "Learn more about: Compiler Error C3223" title: "Compiler Error C3223" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3223" +ms.date: 11/04/2016 f1_keywords: ["C3223"] helpviewer_keywords: ["C3223"] -ms.assetid: 1f4380b4-0413-40db-a868-62f97babaf78 --- # Compiler Error C3223 -'property' : you cannot apply 'typeid' to a property +> 'property' : you cannot apply 'typeid' to a property + +## Remarks You cannot apply [typeid](../../extensions/typeid-cpp-component-extensions.md) to a property. ## Example -The following sample generates C3223. +The following example generates C3223. ```cpp // C3223.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3224.md b/docs/error-messages/compiler-errors-2/compiler-error-c3224.md index 3262737e78b..83735abdfb6 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3224.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3224.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C3224" title: "Compiler Error C3224" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3224" +ms.date: 11/04/2016 f1_keywords: ["C3224"] helpviewer_keywords: ["C3224"] -ms.assetid: 129be22f-8f3e-4fc6-9ccd-d27d8ef91251 --- # Compiler Error C3224 -'type' : no overloaded generic class takes 'number' generic type arguments +> 'type' : no overloaded generic class takes 'number' generic type arguments + +## Remarks The compiler failed to find an appropriate overload. -The following sample generates C3224: +## Example + +The following example generates C3224: ``` // C3224.cs diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3225.md b/docs/error-messages/compiler-errors-2/compiler-error-c3225.md index d43f5993964..c0bb2c4af55 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3225.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3225.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Error C3225" title: "Compiler Error C3225" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3225" +ms.date: 11/04/2016 f1_keywords: ["C3225"] helpviewer_keywords: ["C3225"] -ms.assetid: f5f66973-256e-4298-ac46-c87819cbde34 --- # Compiler Error C3225 -generic type argument for 'arg' cannot be 'type', it must be a value type or handle type +> generic type argument for 'arg' cannot be 'type', it must be a value type or handle type + +## Remarks The generic type argument was not of the correct type. @@ -16,7 +17,7 @@ For more information, see [Generics](../../extensions/generics-cpp-component-ext ## Examples -You cannot instantiate a generic type with a native type. The following sample generates C3225. +You cannot instantiate a generic type with a native type. The following example generates C3225. ```cpp // C3225.cpp @@ -34,7 +35,7 @@ int main() { } ``` -The following sample creates a component using C#. Notice that the constraint specifies that the generic type can only be instantiated with a value type. +The following example creates a component using C#. Notice that the constraint specifies that the generic type can only be instantiated with a value type. ``` // C3225_b.cs @@ -43,7 +44,7 @@ The following sample creates a component using C#. Notice that the constraint sp public class MyList where T: struct {} ``` -This sample consumes the C#-authored component, and violates the constraint that MyList can only be instantiated with a value type other than . The following sample generates C3225. +This example consumes the C#-authored component, and violates the constraint that MyList can only be instantiated with a value type other than . The following example generates C3225. ```cpp // C3225_c.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3226.md b/docs/error-messages/compiler-errors-2/compiler-error-c3226.md index ecdbe62b7b5..298a2d8a275 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3226.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3226.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C3226" title: "Compiler Error C3226" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3226" +ms.date: 11/04/2016 f1_keywords: ["C3226"] helpviewer_keywords: ["C3226"] -ms.assetid: 636106ca-6f4e-4303-a6a0-8803221ec67d --- # Compiler Error C3226 -A template declaration is not allowed inside a generic declaration +> A template declaration is not allowed inside a generic declaration + +## Remarks Use a generic declaration inside a generic class. -The following sample generates C3226: +## Example + +The following example generates C3226: ```cpp // C3226.cpp @@ -24,7 +27,7 @@ ref class C { }; ``` -The following sample demonstrates a possible resolution: +The following example demonstrates a possible resolution: ```cpp // C3226b.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3227.md b/docs/error-messages/compiler-errors-2/compiler-error-c3227.md index 4917215a910..1674ac4f55c 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3227.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3227.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Error C3227" title: "Compiler Error C3227" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3227" +ms.date: 11/04/2016 f1_keywords: ["C3227"] helpviewer_keywords: ["C3227"] -ms.assetid: 7939c23a-96c8-43c2-89e9-f217d132d155 --- # Compiler Error C3227 -'parameter' : cannot use 'keyword' to allocate a generic type +> 'parameter' : cannot use 'keyword' to allocate a generic type + +## Remarks In order to instantiate a type, an appropriate constructor is required. However, the compiler is not able to ensure that an appropriate constructor is available. @@ -16,7 +17,7 @@ You can use templates instead of generics to resolve this error, or you can use ## Example -The following sample generates C3227. +The following example generates C3227. ```cpp // C3227.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3228.md b/docs/error-messages/compiler-errors-2/compiler-error-c3228.md index 78fa2305b55..99d9de708f6 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3228.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3228.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C3228" title: "Compiler Error C3228" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3228" +ms.date: 11/04/2016 f1_keywords: ["C3228"] helpviewer_keywords: ["C3228"] -ms.assetid: 9015adf9-17b0-4312-b4a7-c1f33e4126f4 --- # Compiler Error C3228 -'function' : generic type argument for 'param' cannot be 'type', it must be a valuetype or handle type +> 'function' : generic type argument for 'param' cannot be 'type', it must be a valuetype or handle type + +## Remarks An incorrect type was passed as a generic type argument. -The following sample generates C3228: +## Example + +The following example generates C3228: ```cpp // C3228.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3229.md b/docs/error-messages/compiler-errors-2/compiler-error-c3229.md index ed9e525ef2c..c19f6c0bf8c 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3229.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3229.md @@ -1,20 +1,21 @@ --- -description: "Learn more about: Compiler Error C3229" title: "Compiler Error C3229" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3229" +ms.date: 11/04/2016 f1_keywords: ["C3229"] helpviewer_keywords: ["C3229"] -ms.assetid: f2d90923-aa8b-444f-ab10-1f37dbb864e1 --- # Compiler Error C3229 -'type' : indirections on a generic type parameter are not allowed +> 'type' : indirections on a generic type parameter are not allowed + +## Remarks You cannot use generic parameters with `*`, `^`, or `&`. ## Examples -The following sample generates C3229. +The following example generates C3229. ```cpp // C3229.cpp @@ -31,7 +32,7 @@ ref class D { }; ``` -The following sample generates C3229. +The following example generates C3229. ```cpp // C3229_b.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3230.md b/docs/error-messages/compiler-errors-2/compiler-error-c3230.md index 75fbf6d7d1c..c58e94c7255 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3230.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3230.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C3230" title: "Compiler Error C3230" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3230" +ms.date: 11/04/2016 f1_keywords: ["C3230"] helpviewer_keywords: ["C3230"] -ms.assetid: 5ec53f25-59f6-4801-81e7-7b68bf04994d --- # Compiler Error C3230 -'function' : template type argument for 'template' cannot contain a generic type parameter: 'param' +> 'function' : template type argument for 'template' cannot contain a generic type parameter: 'param' + +## Remarks Templates are instantiated at compile time, but generics are instantiated at run time. Therefore, it is not possible to generate generic code that can call the template because the template cannot be instantiated at run time when the generic type is finally known. -The following sample generates C3230: +## Example + +The following example generates C3230: ```cpp // C3230.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3231.md b/docs/error-messages/compiler-errors-2/compiler-error-c3231.md index 8b4b8d161bf..f6d1c264985 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3231.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3231.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C3231" title: "Compiler Error C3231" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3231" +ms.date: 11/04/2016 f1_keywords: ["C3231"] helpviewer_keywords: ["C3231"] -ms.assetid: fe5dc352-e634-45fa-9534-3da176294c98 --- # Compiler Error C3231 -'arg' : template type argument cannot use a generic type parameter +> 'arg' : template type argument cannot use a generic type parameter + +## Remarks Templates are instantiated at compile time, but generics are instantiated at run time. Therefore, it is not possible to generate generic code that can call the template because the template cannot be instantiated at run time when the generic type is finally known. -The following sample generates C3231: +## Example + +The following example generates C3231: ```cpp // C3231.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3232.md b/docs/error-messages/compiler-errors-2/compiler-error-c3232.md index ed8f0a32c43..9608a4d798f 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3232.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3232.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C3232" title: "Compiler Error C3232" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3232" +ms.date: 11/04/2016 f1_keywords: ["C3232"] helpviewer_keywords: ["C3232"] -ms.assetid: 3119b3a9-0eff-4a3f-b805-e4d160af9e39 --- # Compiler Error C3232 -'param' : a generic type parameter cannot be used in a qualified name +> 'param' : a generic type parameter cannot be used in a qualified name + +## Remarks A generic type parameter was used incorrectly. -The following sample generates C3232: +## Example + +The following example generates C3232: ```cpp // C3232.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3233.md b/docs/error-messages/compiler-errors-2/compiler-error-c3233.md index cab7999c98c..93f9a1bbf8e 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3233.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3233.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C3233" title: "Compiler Error C3233" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3233" +ms.date: 11/04/2016 f1_keywords: ["C3233"] helpviewer_keywords: ["C3233"] -ms.assetid: a9210830-1136-4f02-ba41-030c85f93547 --- # Compiler Error C3233 -'type' : generic type parameter already constrained +> 'type' : generic type parameter already constrained + +## Remarks It is not valid to constrain a generic parameter in more than one `where` clause. -The following sample generates C3233: +## Example + +The following example generates C3233: ```cpp // C3233.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3234.md b/docs/error-messages/compiler-errors-2/compiler-error-c3234.md index 0239ec60f31..e6b26096cb8 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3234.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3234.md @@ -1,20 +1,21 @@ --- -description: "Learn more about: Compiler Error C3234" title: "Compiler Error C3234" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3234" +ms.date: 11/04/2016 f1_keywords: ["C3234"] helpviewer_keywords: ["C3234"] -ms.assetid: ebefc15a-e40d-424b-a3dd-d7e185d0ed7b --- # Compiler Error C3234 -a generic class may not derive from a generic type parameter +> a generic class may not derive from a generic type parameter + +## Remarks A generic class cannot inherit from a generic type parameter. ## Example -The following sample generates C3234. +The following example generates C3234. ```cpp // C3234.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3235.md b/docs/error-messages/compiler-errors-2/compiler-error-c3235.md index 40c569e6718..e88284ee42d 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3235.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3235.md @@ -1,20 +1,21 @@ --- -description: "Learn more about: Compiler Error C3235" title: "Compiler Error C3235" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3235" +ms.date: 11/04/2016 f1_keywords: ["C3235"] helpviewer_keywords: ["C3235"] -ms.assetid: 0554d6c7-e1dc-4c99-8934-cbcf491c8203 --- # Compiler Error C3235 -'specialization' : explicit or partial specialization of a generic class is not allowed +> 'specialization' : explicit or partial specialization of a generic class is not allowed + +## Remarks Generic classes cannot be used for explicit or partial specializations. ## Example -The following sample generates C3235. +The following example generates C3235. ```cpp // C3235.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3236.md b/docs/error-messages/compiler-errors-2/compiler-error-c3236.md index 7bdd011603e..40f1e394497 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3236.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3236.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C3236" title: "Compiler Error C3236" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3236" +ms.date: 11/04/2016 f1_keywords: ["C3236"] helpviewer_keywords: ["C3236"] -ms.assetid: 4ef1871f-a348-44ae-922b-1e2081de20d0 --- # Compiler Error C3236 -explicit instantiation of a generic is not allowed +> explicit instantiation of a generic is not allowed + +## Remarks The compiler does not allow explicit instantiation of generic classes. -The following sample generates C3236: +## Example + +The following example generates C3236: ```cpp // C3236.cpp @@ -23,7 +26,7 @@ public ref class X {}; generic ref class X; // C3236 ``` -The following sample demonstrates a possible resolution: +The following example demonstrates a possible resolution: ```cpp // C3236b.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3237.md b/docs/error-messages/compiler-errors-2/compiler-error-c3237.md index 5faaa77e2c8..7e528bc49d1 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3237.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3237.md @@ -1,20 +1,21 @@ --- -description: "Learn more about: Compiler Error C3237" title: "Compiler Error C3237" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3237" +ms.date: 11/04/2016 f1_keywords: ["C3237"] helpviewer_keywords: ["C3237"] -ms.assetid: 690970c8-e13b-4ff3-96e3-5fd93c4d356b --- # Compiler Error C3237 -'generic_class' : a generic class cannot be a custom attribute +> 'generic_class' : a generic class cannot be a custom attribute + +## Remarks Generic classes cannot be user-defined attributes. ## Example -The following sample generates C3237. +The following example generates C3237. ```cpp // C3237.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3238.md b/docs/error-messages/compiler-errors-2/compiler-error-c3238.md index fa015df2c29..f2c99fe1706 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3238.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3238.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Error C3238" title: "Compiler Error C3238" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3238" +ms.date: 11/04/2016 f1_keywords: ["C3238"] helpviewer_keywords: ["C3238"] -ms.assetid: 19942497-b3c5-4df0-9144-142ced92468b --- # Compiler Error C3238 -'type' : a type with this name has already been forwarded to assembly 'assembly' +> 'type' : a type with this name has already been forwarded to assembly 'assembly' + +## Remarks A type was defined in a client application that is also defined, via type forwarding syntax, in a referenced assembly. Both types cannot be defined in the scope of the application. @@ -16,7 +17,7 @@ See [Type Forwarding (C++/CLI)](../../extensions/type-forwarding-cpp-cli.md) for ## Examples -The following sample creates an assembly that contains a type that was forwarded from another assembly. +The following example creates an assembly that contains a type that was forwarded from another assembly. ```cpp // C3238.cpp @@ -24,7 +25,7 @@ The following sample creates an assembly that contains a type that was forwarded public ref class R {}; ``` -The following sample creates an assembly that used to contain the type definition, but not only contains type forwarding syntax. +The following example creates an assembly that used to contain the type definition, but not only contains type forwarding syntax. ```cpp // C3238_b.cpp @@ -33,7 +34,7 @@ The following sample creates an assembly that used to contain the type definitio [ assembly:TypeForwardedTo(R::typeid) ]; ``` -The following sample generates C3238. +The following example generates C3238. ```cpp // C3238_c.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3239.md b/docs/error-messages/compiler-errors-2/compiler-error-c3239.md index 9c080208e2a..c214f06fe32 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3239.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3239.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C3239" title: "Compiler Error C3239" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3239" +ms.date: 11/04/2016 f1_keywords: ["C3239"] helpviewer_keywords: ["C3239"] -ms.assetid: 22a518b7-020f-4f3c-9963-a094667fd1ac --- # Compiler Error C3239 -'type' : pointer to interior/pin pointer is disallowed by the common language runtime +> 'type' : pointer to interior/pin pointer is disallowed by the common language runtime + +## Remarks The compiler encountered an invalid type. -The following sample generates C3229: +## Example + +The following example generates C3239: ```cpp // C3239.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3240.md b/docs/error-messages/compiler-errors-2/compiler-error-c3240.md index 4dd2cc0d81f..19d9853fa83 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3240.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3240.md @@ -1,20 +1,21 @@ --- -description: "Learn more about: Compiler Error C3240" title: "Compiler Error C3240" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3240" +ms.date: 11/04/2016 f1_keywords: ["C3240"] helpviewer_keywords: ["C3240"] -ms.assetid: 1a8dc213-b80c-47ae-ada0-e9554b635d1e --- # Compiler Error C3240 -'function' : must be a non-overloaded abstract member function of 'type' +> 'function' : must be a non-overloaded abstract member function of 'type' + +## Remarks A base type contained a function that was defined. Function must be virtual. ## Example -The following sample generates C3240. +The following example generates C3240. ```cpp // C3240.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3241.md b/docs/error-messages/compiler-errors-2/compiler-error-c3241.md index 34ba8ad6560..9151758b840 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3241.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3241.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C3241" title: "Compiler Error C3241" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3241" +ms.date: 11/04/2016 f1_keywords: ["C3241"] helpviewer_keywords: ["C3241"] -ms.assetid: 2ca14879-bba0-4a23-b22a-72cfff92d6a4 --- # Compiler Error C3241 -'method' : this method was not introduced by 'interface' +> 'method' : this method was not introduced by 'interface' + +## Remarks When you explicitly override a function, the function signature must exactly match the declaration for the function that you are overriding. -The following sample generates C3241: +## Example + +The following example generates C3241: ```cpp // C3241.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3242.md b/docs/error-messages/compiler-errors-2/compiler-error-c3242.md index 323f6db037c..290e2ae1513 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3242.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3242.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Compiler Error C3242" title: "Compiler Error C3242" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3242" +ms.date: 11/04/2016 f1_keywords: ["C3242"] helpviewer_keywords: ["C3242"] -ms.assetid: c7621ced-d5c7-4595-904b-bd871676784c --- # Compiler Error C3242 -'function' : you can only explicitly override virtual functions +> 'function' : you can only explicitly override virtual functions + +## Remarks You tried to explicitly override a nonvirtual method. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3243.md b/docs/error-messages/compiler-errors-2/compiler-error-c3243.md index a250dd83090..3a52311b95c 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3243.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3243.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C3243" title: "Compiler Error C3243" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3243" +ms.date: 11/04/2016 f1_keywords: ["C3243"] helpviewer_keywords: ["C3243"] -ms.assetid: 35d8ad1a-377d-47df-be9d-c55eea23340f --- # Compiler Error C3243 -none of the overload functions were introduced by 'interface' +> none of the overload functions were introduced by 'interface' + +## Remarks You tried to [explicitly override](../../cpp/explicit-overrides-cpp.md) a member that does not exist in the specified interface. -The following sample generates C3243: +## Example + +The following example generates C3243: ```cpp // C3243.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3244.md b/docs/error-messages/compiler-errors-2/compiler-error-c3244.md index acaad50b54a..f94ccbfce06 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3244.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3244.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C3244" title: "Compiler Error C3244" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3244" +ms.date: 11/04/2016 f1_keywords: ["C3244"] helpviewer_keywords: ["C3244"] -ms.assetid: dae6c49b-5212-4206-8f61-d4010c0b9969 --- # Compiler Error C3244 -'method' : this method was introduced by 'interface' not by 'interface' +> 'method' : this method was introduced by 'interface' not by 'interface' + +## Remarks You tried to [explicitly override](../../cpp/explicit-overrides-cpp.md) a member that does not exist in the specified interface but does exist in another base class. -The following sample generates C3244: +## Example + +The following example generates C3244: ```cpp // C3244.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3246.md b/docs/error-messages/compiler-errors-2/compiler-error-c3246.md index e3150e1036a..6458e051d45 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3246.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3246.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C3246" title: "Compiler Error C3246" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3246" +ms.date: 11/04/2016 f1_keywords: ["C3246"] helpviewer_keywords: ["C3246"] -ms.assetid: ad85224a-e540-479b-a5eb-a3bc3964c30b --- # Compiler Error C3246 -'class' : cannot inherit from 'type' as it has been declared as 'sealed' +> 'class' : cannot inherit from 'type' as it has been declared as 'sealed' + +## Remarks A class that is marked as [sealed](../../extensions/sealed-cpp-component-extensions.md) cannot be the base class for any other classes. -The following sample generates C3246: +## Example + +The following example generates C3246: ```cpp // C3246_2.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3247.md b/docs/error-messages/compiler-errors-2/compiler-error-c3247.md index b5fa60f4205..93888a5ddb5 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3247.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3247.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C3247" title: "Compiler Error C3247" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3247" +ms.date: 11/04/2016 f1_keywords: ["C3247"] helpviewer_keywords: ["C3247"] -ms.assetid: f9a2bbb5-3fce-40bf-9fd3-835a5f164dbb --- # Compiler Error C3247 -'class1' : a coclass cannot inherit from another coclass 'class2' +> 'class1' : a coclass cannot inherit from another coclass 'class2' + +## Remarks A class marked with the [coclass](../../windows/attributes/coclass.md) attribute cannot inherit from another class marked with the `coclass` attribute. -The following sample generates C3247: +## Example + +The following example generates C3247: ```cpp // C3247.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3248.md b/docs/error-messages/compiler-errors-2/compiler-error-c3248.md index 700129cccdd..f2edd92a462 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3248.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3248.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Error C3248" title: "Compiler Error C3248" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3248" +ms.date: 11/04/2016 f1_keywords: ["C3248"] helpviewer_keywords: ["C3248"] -ms.assetid: d00b9d7d-b6be-4a5b-bb52-48174ea71fc4 --- # Compiler Error C3248 -'function1': function declared as '__sealed' cannot be overridden by 'function2' +> 'function1': function declared as '__sealed' cannot be overridden by 'function2' + +## Remarks A derived class tried to override a **__sealed** virtual method. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3251.md b/docs/error-messages/compiler-errors-2/compiler-error-c3251.md index 8756c4429db..ff7203c63a0 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3251.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3251.md @@ -1,15 +1,16 @@ --- -description: "Learn more about: Compiler Error C3251" title: "Compiler Error C3251" +description: "Learn more about: Compiler Error C3251" ms.date: 06/01/2022 f1_keywords: ["C3251"] helpviewer_keywords: ["C3251"] -ms.assetid: 541c163e-5ee9-457c-a1e5-da860788b10d --- # Compiler Error C3251 > cannot invoke base class method on a value type instance +## Remarks + The following error occurs because `GetClass` is a member of `Microsoft.Runtime.Object`, not of `Microsoft.Runtime.Integer4`. This error is obsolete in Visual Studio 2022 and later versions. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3252.md b/docs/error-messages/compiler-errors-2/compiler-error-c3252.md index 979108c12a0..0313cb3e10d 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3252.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3252.md @@ -1,20 +1,23 @@ --- -description: "Learn more about: Compiler Error C3252" title: "Compiler Error C3252" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3252" +ms.date: 11/04/2016 f1_keywords: ["C3252"] helpviewer_keywords: ["C3252"] -ms.assetid: aa9ad096-e9ac-41c7-8ad9-b966751c7c75 --- # Compiler Error C3252 -'method' : cannot reduce accessibility of a virtual method in a managed or WinRT type +> 'method' : cannot reduce accessibility of a virtual method in a managed or WinRT type + +## Remarks A class that implements a virtual method from a base class or any method from an interface cannot reduce the access of that method. Note that all methods in an interface are public. -The following sample generates C3252 and shows how to fix it: +## Example + +The following example generates C3252 and shows how to fix it: ```cpp // C3252.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3253.md b/docs/error-messages/compiler-errors-2/compiler-error-c3253.md index 789a18bd235..3fc664e8ad4 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3253.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3253.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C3253" title: "Compiler Error C3253" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3253" +ms.date: 11/04/2016 f1_keywords: ["C3253"] helpviewer_keywords: ["C3253"] -ms.assetid: da40be26-0f78-4730-8727-ad11cddf8869 --- # Compiler Error C3253 -'function' : error with explicit override +> 'function' : error with explicit override + +## Remarks An explicit override was specified incorrectly. For example, you cannot specify an implementation for an override that you also specify as pure. For more information, see [Explicit Overrides](../../extensions/explicit-overrides-cpp-component-extensions.md). -The following sample generates C3253: +## Example + +The following example generates C3253: ```cpp // C3253.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3254.md b/docs/error-messages/compiler-errors-2/compiler-error-c3254.md index 8d7f4685f95..564020dfafb 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3254.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3254.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C3254" title: "Compiler Error C3254" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3254" +ms.date: 11/04/2016 f1_keywords: ["C3254"] helpviewer_keywords: ["C3254"] -ms.assetid: 93427b10-fa72-4e43-80d1-1a6e122f9f40 --- # Compiler Error C3254 -'explicit override' : class contains explicit override 'override' but does not derive from an interface that contains the function declaration +> 'explicit override' : class contains explicit override 'override' but does not derive from an interface that contains the function declaration + +## Remarks When you [explicitly override](../../cpp/explicit-overrides-cpp.md) a method, the class that contains the override must derive, directly or indirectly, from the type that contains the function you are overriding. -The following sample generates C3254: +## Example + +The following example generates C3254: ```cpp // C3254.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3255.md b/docs/error-messages/compiler-errors-2/compiler-error-c3255.md index 5e2b71a8530..85780e5caf6 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3255.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3255.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C3255" title: "Compiler Error C3255" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3255" +ms.date: 11/04/2016 f1_keywords: ["C3255"] helpviewer_keywords: ["C3255"] -ms.assetid: 877ffca2-fd92-44b6-9060-6091b928b1c1 --- # Compiler Error C3255 -'value type' : cannot dynamically allocate this value type object on native heap +> 'value type' : cannot dynamically allocate this value type object on native heap + +## Remarks Instances of a value type (see [Classes and Structs](../../extensions/classes-and-structs-cpp-component-extensions.md)) that contain managed members can be created on the stack but not on the heap. -The following sample generates C3255: +## Example + +The following example generates C3255: ```cpp // C3255.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3262.md b/docs/error-messages/compiler-errors-2/compiler-error-c3262.md index aeff907ea7f..a03b9b56756 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3262.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3262.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C3262" title: "Compiler Error C3262" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3262" +ms.date: 11/04/2016 f1_keywords: ["C3262"] helpviewer_keywords: ["C3262"] -ms.assetid: 3e74b9aa-de3c-4492-9331-ee73012b958b --- # Compiler Error C3262 -invalid array indexing: '#' dimension(s) specified for '#'-dimensional 'array type' +> invalid array indexing: '#' dimension(s) specified for '#'-dimensional 'array type' + +## Remarks An array was improperly subscripted. The number of indices may not match the number of dimensions in the array. -The following sample generates C3262: +## Example + +The following example generates C3262: ```cpp // C3262.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3264.md b/docs/error-messages/compiler-errors-2/compiler-error-c3264.md index 2f620f59858..67246af20c0 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3264.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3264.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C3264" title: "Compiler Error C3264" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3264" +ms.date: 11/04/2016 f1_keywords: ["C3264"] helpviewer_keywords: ["C3264"] -ms.assetid: 94ece687-2364-4f7a-8ebb-7afd3ae9d63d --- # Compiler Error C3264 -'class' : a class-constructor cannot have a return type +> 'class' : a class-constructor cannot have a return type + +## Remarks Class constructors cannot have return types. -The following sample generates C3264: +## Example + +The following example generates C3264: ```cpp // C3264_2.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3265.md b/docs/error-messages/compiler-errors-2/compiler-error-c3265.md index c1b01d64d2f..0a42b012bb7 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3265.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3265.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C3265" title: "Compiler Error C3265" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3265" +ms.date: 11/04/2016 f1_keywords: ["C3265"] helpviewer_keywords: ["C3265"] -ms.assetid: 10ab3e17-4a9f-4120-bab5-21473869b70f --- # Compiler Error C3265 -cannot declare a managed 'managed construct' in an unmanaged 'unmanaged construct' +> cannot declare a managed 'managed construct' in an unmanaged 'unmanaged construct' + +## Remarks You cannot include a managed object in an unmanaged context. -The following sample reproduces C3265: +## Example + +The following example reproduces C3265: ```cpp // C3265_2.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3266.md b/docs/error-messages/compiler-errors-2/compiler-error-c3266.md index 80ca7c50aaa..74c180fce42 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3266.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3266.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C3266" title: "Compiler Error C3266" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3266" +ms.date: 11/04/2016 f1_keywords: ["C3266"] helpviewer_keywords: ["C3266"] -ms.assetid: 7375c099-acb7-42f6-898d-57cfefa010b8 --- # Compiler Error C3266 -'class' : a class-constructor must have a 'void' parameter list +> 'class' : a class-constructor must have a 'void' parameter list + +## Remarks Class-constructors in a class using /clr programming cannot take parameters. -The following sample generates C3266: +## Example + +The following example generates C3266: ```cpp // C3266.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3268.md b/docs/error-messages/compiler-errors-2/compiler-error-c3268.md index f58d77ec0de..48c86a4db5a 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3268.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3268.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3268" title: "Compiler Error C3268" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3268" +ms.date: 11/04/2016 f1_keywords: ["C3268"] helpviewer_keywords: ["C3268"] -ms.assetid: d74a630c-daea-4e29-9759-83efef7fb184 --- # Compiler Error C3268 @@ -18,7 +17,7 @@ See [Generics](../../extensions/generics-cpp-component-extensions.md) for more i ## Example -The following sample generates C3268. +The following example generates C3268. ```cpp // C3268.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3269.md b/docs/error-messages/compiler-errors-2/compiler-error-c3269.md index 30e3769f27f..dda026a75a8 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3269.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3269.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C3269" title: "Compiler Error C3269" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3269" +ms.date: 11/04/2016 f1_keywords: ["C3269"] helpviewer_keywords: ["C3269"] -ms.assetid: c575f067-244d-4dd5-bf58-9e7630ea58b7 --- # Compiler Error C3269 -'function' : a member-function of a managed or WinRTtype cannot be declared with '...' +> 'function' : a member-function of a managed or WinRTtype cannot be declared with '...' + +## Remarks Managed and WinRT class member functions cannot declare variable-length parameter lists. -The following sample generates C3269 and shows how to fix it: +## Example + +The following example generates C3269 and shows how to fix it: ```cpp // C3269_2.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3270.md b/docs/error-messages/compiler-errors-2/compiler-error-c3270.md index 1fbce5730df..67d801e0485 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3270.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3270.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C3270" title: "Compiler Error C3270" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3270" +ms.date: 11/04/2016 f1_keywords: ["C3270"] helpviewer_keywords: ["C3270"] -ms.assetid: 70e6e76b-7415-48f5-a61e-2ed50caf08e4 --- # Compiler Error C3270 -'field': the FieldOffset attribute can only be used in the context of StructLayout(Explicit), in which case it is required +> 'field': the FieldOffset attribute can only be used in the context of StructLayout(Explicit), in which case it is required + +## Remarks A field was marked with **FieldOffset**, which is only allowed when **StructLayout(Explicit)** is in effect. -The following sample generates C3270: +## Example + +The following example generates C3270: ```cpp // C3270_2.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3271.md b/docs/error-messages/compiler-errors-2/compiler-error-c3271.md index 13e5aa3832a..d40c824e597 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3271.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3271.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C3271" title: "Compiler Error C3271" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3271" +ms.date: 11/04/2016 f1_keywords: ["C3271"] helpviewer_keywords: ["C3271"] -ms.assetid: 16d8bd1d-2e30-4c6a-a07f-0c4f3342fab5 --- # Compiler Error C3271 -'member': invalid value 'value' for the FieldOffset attribute +> 'member': invalid value 'value' for the FieldOffset attribute + +## Remarks A negative number was passed to the **FieldOffset** attribute. -The following sample generates C3271: +## Example + +The following example generates C3271: ```cpp // C3271.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3272.md b/docs/error-messages/compiler-errors-2/compiler-error-c3272.md index 6431d6dcf5b..6cdc82dc549 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3272.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3272.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C3272" title: "Compiler Error C3272" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3272" +ms.date: 11/04/2016 f1_keywords: ["C3272"] helpviewer_keywords: ["C3272"] -ms.assetid: 7cdf254d-f207-4116-a1bf-7386f3b82a6f --- # Compiler Error C3272 -'symbol' : symbol requires FieldOffset, as it is a member of type typename defined with StructLayout(LayoutKind::Explicit) +> 'symbol' : symbol requires FieldOffset, as it is a member of type typename defined with StructLayout(LayoutKind::Explicit) + +## Remarks When `StructLayout(LayoutKind::Explicit)` is in effect, fields must be marked with `FieldOffset`. -The following sample generates C3272: +## Example + +The following example generates C3272: ```cpp // C3272_2.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3273.md b/docs/error-messages/compiler-errors-2/compiler-error-c3273.md index c1d5a9f6802..c19397dfa91 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3273.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3273.md @@ -1,16 +1,17 @@ --- -description: "Learn more about: Compiler Error C3273" title: "Compiler Error C3273" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3273" +ms.date: 11/04/2016 f1_keywords: ["C3273"] helpviewer_keywords: ["C3273"] -ms.assetid: 1d2ce9d9-222b-4cab-94e2-d2c1a9f5ebe0 --- # Compiler Error C3273 -__finally cannot be used on an exception block in unmanaged code. +> __finally cannot be used on an exception block in unmanaged code. + +## Example -The following sample generates C3273: +The following example generates C3273: ```cpp // C3273.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3274.md b/docs/error-messages/compiler-errors-2/compiler-error-c3274.md index b3732ce47ae..59a9dfa237a 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3274.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3274.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C3274" title: "Compiler Error C3274" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3274" +ms.date: 11/04/2016 f1_keywords: ["C3274"] helpviewer_keywords: ["C3274"] -ms.assetid: 1f03f18e-b569-48eb-9249-11c70122a305 --- # Compiler Error C3274 -__finally/finally without matching try +> __finally/finally without matching try + +## Remarks A [__finally](../../cpp/try-finally-statement.md) or [finally](../../dotnet/finally.md) statement was found without a matching **`try`**. To resolve this, either delete the **`__finally`** statement or add a **`try`** statement for the **`__finally`**. -The following sample generates C3274: +## Example + +The following example generates C3274: ```cpp // C3274.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3275.md b/docs/error-messages/compiler-errors-2/compiler-error-c3275.md index ec6d61c49ef..8164db7e728 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3275.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3275.md @@ -1,15 +1,16 @@ --- -description: "Learn more about: Compiler Error C3275" title: "Compiler Error C3275" +description: "Learn more about: Compiler Error C3275" ms.date: 06/01/2022 f1_keywords: ["C3275"] helpviewer_keywords: ["C3275"] -ms.assetid: 5752680f-7d3e-4c42-ba9c-845e09d32e7a --- # Compiler Error C3275 > 'enum member' : cannot use this symbol without qualifier +## Remarks + When using managed code and when two or more enumerations contain an identifier with the same name, you must explicitly qualify references to the identifier. C3275 is only reachable using the obsolete compiler option **`/clr:oldSyntax`**. It's not generated in Visual Studio 2022 or later versions. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3276.md b/docs/error-messages/compiler-errors-2/compiler-error-c3276.md index 7734a6efa52..2acd2f43475 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3276.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3276.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Compiler Error C3276" title: "Compiler Error C3276" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3276" +ms.date: 11/04/2016 f1_keywords: ["C3276"] helpviewer_keywords: ["C3276"] -ms.assetid: dd6b4fd2-094d-4d34-a467-a9afd59789f7 --- # Compiler Error C3276 -'keyword' : jump out of __finally/finally block has undefined behavior during termination handling +> 'keyword' : jump out of __finally/finally block has undefined behavior during termination handling + +## Remarks This error is the same as the [C4532](../../error-messages/compiler-warnings/compiler-warning-level-1-c4532.md) warning. However, when you are using /clr, this condition cannot be disabled with the [warning](../../preprocessor/warning.md) pragma. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3277.md b/docs/error-messages/compiler-errors-2/compiler-error-c3277.md index 5dda1f60f5e..99686122c80 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3277.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3277.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C3277" title: "Compiler Error C3277" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3277" +ms.date: 11/04/2016 f1_keywords: ["C3277"] helpviewer_keywords: ["C3277"] -ms.assetid: 8ac5f476-e30c-4879-92c6-f03cdbd74045 --- # Compiler Error C3277 -cannot define an unmanaged enum 'enum' inside managed 'type' +> cannot define an unmanaged enum 'enum' inside managed 'type' + +## Remarks An enumeration was defined incorrectly inside a managed type. -The following sample generates C3277: +## Example + +The following example generates C3277: ```cpp // C3277a.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3278.md b/docs/error-messages/compiler-errors-2/compiler-error-c3278.md index 633bd972416..4fa4676b8f1 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3278.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3278.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3278" title: "Compiler Error C3278" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3278" +ms.date: 11/04/2016 f1_keywords: ["C3278"] helpviewer_keywords: ["C3278"] -ms.assetid: 56f818f5-85a6-4792-843b-54fe16327658 --- # Compiler Error C3278 @@ -16,7 +15,7 @@ A call was made to an interface method or a pure method, which is not allowed. ## Example -The following sample generates C3278: +The following example generates C3278: ```cpp // C3278_2.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3279.md b/docs/error-messages/compiler-errors-2/compiler-error-c3279.md index ed97e7991d8..2c8c603fabc 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3279.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3279.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C3279" title: "Compiler Error C3279" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3279" +ms.date: 11/04/2016 f1_keywords: ["C3279"] helpviewer_keywords: ["C3279"] -ms.assetid: 639afc20-984c-4a95-be35-8bf9409f02d5 --- # Compiler Error C3279 -partial and explicit specializations as well as explicit instantiations of class templates declared in the cli namespace are disallowed +> partial and explicit specializations as well as explicit instantiations of class templates declared in the cli namespace are disallowed + +## Remarks The `cli` namespace is defined by Microsoft and contains pseudo-templates. The Microsoft C++ compiler does not allow user-defined, partial and explicit specializations, and explicit instantiations of class templates in this namespace. -The following sample generates C3279: +## Example + +The following example generates C3279: ```cpp // C3279.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3280.md b/docs/error-messages/compiler-errors-2/compiler-error-c3280.md index c4d98cceae1..f0e23ff5668 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3280.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3280.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C3280" title: "Compiler Error C3280" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3280" +ms.date: 11/04/2016 f1_keywords: ["C3280"] helpviewer_keywords: ["C3280"] -ms.assetid: 86dc5bbc-8818-4786-a728-9334268d308b --- # Compiler Error C3280 -'class' : a member-function of a managed type cannot be compiled as an unmanaged function +> 'class' : a member-function of a managed type cannot be compiled as an unmanaged function + +## Remarks Managed class member functions cannot be compiled as unmanaged functions. -The following sample generates C3280: +## Example + +The following example generates C3280: ```cpp // C3280_2.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3282.md b/docs/error-messages/compiler-errors-2/compiler-error-c3282.md index f424b4ccf18..741de4d6c9f 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3282.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3282.md @@ -1,20 +1,21 @@ --- -description: "Learn more about: Compiler Error C3282" title: "Compiler Error C3282" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3282" +ms.date: 11/04/2016 f1_keywords: ["C3282"] helpviewer_keywords: ["C3282"] -ms.assetid: bac2ac89-c360-4c24-bb81-c20c62ece9ba --- # Compiler Error C3282 -generic parameter lists can only appear on managed or WinRTclasses, structs, or functions +> generic parameter lists can only appear on managed or WinRTclasses, structs, or functions + +## Remarks A generic parameter list was used incorrectly. For more information, see [Generics](../../extensions/generics-cpp-component-extensions.md). ## Example -The following sample generates C3282 and shows how to fix it. +The following example generates C3282 and shows how to fix it. ```cpp // C3282.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3283.md b/docs/error-messages/compiler-errors-2/compiler-error-c3283.md index a21e84993f8..bdd801d2ffd 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3283.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3283.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C3283" title: "Compiler Error C3283" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3283" +ms.date: 11/04/2016 f1_keywords: ["C3283"] helpviewer_keywords: ["C3283"] -ms.assetid: c51d912c-cde3-4928-904e-26734c8954ce --- # Compiler Error C3283 -'type' : an interface cannot have an instance constructor +> 'type' : an interface cannot have an instance constructor + +## Remarks A CLR [interface](../../extensions/interface-class-cpp-component-extensions.md) cannot have an instance constructor. A static constructor is allowed. -The following sample generates C3283: +## Example + +The following example generates C3283: ```cpp // C3283.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3284.md b/docs/error-messages/compiler-errors-2/compiler-error-c3284.md index c2e17582e38..20908966346 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3284.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3284.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C3284" title: "Compiler Error C3284" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3284" +ms.date: 11/04/2016 f1_keywords: ["C3284"] helpviewer_keywords: ["C3284"] -ms.assetid: e582f316-e9db-4d27-9c70-fdfa737a9d5f --- # Compiler Error C3284 -the constraints for generic parameter 'parameter' of function 'function' must match the constraints for generic parameter 'parameter' of function 'function' +> the constraints for generic parameter 'parameter' of function 'function' must match the constraints for generic parameter 'parameter' of function 'function' + +## Remarks A virtual generic function must use the same constraints as a virtual function with the same name and set of arguments in the base class. -The following sample generates C3284: +## Example + +The following example generates C3284: ```cpp // C3284.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3285.md b/docs/error-messages/compiler-errors-2/compiler-error-c3285.md index 59d5d68b7b2..fdd60a3eda7 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3285.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3285.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Error C3285" title: "Compiler Error C3285" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3285" +ms.date: 11/04/2016 f1_keywords: ["C3285"] helpviewer_keywords: ["C3285"] -ms.assetid: 04e8f210-d67e-4810-b153-e1efe2986c8f --- # Compiler Error C3285 -for each statement cannot operate on variables of type 'type' +> for each statement cannot operate on variables of type 'type' + +## Remarks The `for each` statement repeats a group of embedded statements for each element in an array or an object collection. @@ -16,7 +17,7 @@ See [for each, in](../../dotnet/for-each-in.md) for more information. ## Example -The following sample generates C3285. +The following example generates C3285. ```cpp // C3285.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3286.md b/docs/error-messages/compiler-errors-2/compiler-error-c3286.md index 9efe53c1c97..7a93263d5ff 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3286.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3286.md @@ -1,20 +1,21 @@ --- -description: "Learn more about: Compiler Error C3286" title: "Compiler Error C3286" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3286" +ms.date: 11/04/2016 f1_keywords: ["C3286"] helpviewer_keywords: ["C3286"] -ms.assetid: 554328c8-cf44-4f7d-a8d2-def74d28ecdd --- # Compiler Error C3286 > '*specifier*': an iteration variable cannot have any storage-class specifiers +## Remarks + A storage class can't be specified on an iteration variable. For more information, see [Storage classes (C++)](../../cpp/storage-classes-cpp.md) and [for each, in](../../dotnet/for-each-in.md). ## Example -The following sample generates C3286, and also shows correct usage. +The following example generates C3286, and also shows correct usage. ```cpp // C3286.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3287.md b/docs/error-messages/compiler-errors-2/compiler-error-c3287.md index 787b4508cff..f039ff49189 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3287.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3287.md @@ -4,7 +4,6 @@ description: "Describes Microsoft C++ compiler error C3287." ms.date: 09/25/2020 f1_keywords: ["C3287"] helpviewer_keywords: ["C3287"] -ms.assetid: c1fa73d2-2c82-4136-a7da-0e75e3b420ad --- # Compiler Error C3287 @@ -18,7 +17,7 @@ For more information, see [for each, in](../../dotnet/for-each-in.md). ## Example -The following sample generates C3287. +The following example generates C3287. ```cpp // C3287.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3288.md b/docs/error-messages/compiler-errors-2/compiler-error-c3288.md index 4f9b011915a..6597067eb90 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3288.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3288.md @@ -1,20 +1,21 @@ --- -description: "Learn more about: Compiler Error C3288" title: "Compiler Error C3288" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3288" +ms.date: 11/04/2016 f1_keywords: ["C3288"] helpviewer_keywords: ["C3288"] -ms.assetid: ed08a540-9751-46e1-9cbe-c51d6a49ffab --- # Compiler Error C3288 -'type' : illegal dereference of a handle type +> 'type' : illegal dereference of a handle type + +## Remarks The compiler detected an illegal dereference of a handle type. You can dereference a handle type and assign it to a reference. For more information, see [Tracking Reference Operator](../../extensions/tracking-reference-operator-cpp-component-extensions.md). ## Example -The following sample generates C3288. +The following example generates C3288. ```cpp // C3288.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3289.md b/docs/error-messages/compiler-errors-2/compiler-error-c3289.md index 9aec61ca772..d4823e99655 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3289.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3289.md @@ -1,20 +1,21 @@ --- -description: "Learn more about: Compiler Error C3289" title: "Compiler Error C3289" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3289" +ms.date: 11/04/2016 f1_keywords: ["C3289"] helpviewer_keywords: ["C3289"] -ms.assetid: 3c1c623b-7fcf-43ab-a89a-8722532a8d29 --- # Compiler Error C3289 -'property' : a trivial property cannot be indexed +> 'property' : a trivial property cannot be indexed + +## Remarks A property was declared incorrectly. Accessors must be defined for an indexed property. See [property](../../extensions/property-cpp-component-extensions.md) for more information. ## Example -The following sample generates C3289. +The following example generates C3289. ```cpp // C3289.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3290.md b/docs/error-messages/compiler-errors-2/compiler-error-c3290.md index 0c418160ac2..86166548898 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3290.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3290.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Error C3290" title: "Compiler Error C3290" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3290" +ms.date: 11/04/2016 f1_keywords: ["C3290"] helpviewer_keywords: ["C3290"] -ms.assetid: 0baf684b-1143-4953-ac99-a2fa267d8017 --- # Compiler Error C3290 -'type' : a trivial property cannot have reference type +> 'type' : a trivial property cannot have reference type + +## Remarks A property was declared incorrectly. When you declare a trivial property, the compiler creates a variable that the property will update, and it is not possible to have a tracking reference variable in a class. @@ -16,7 +17,7 @@ See [property](../../extensions/property-cpp-component-extensions.md) and [Track ## Example -The following sample generates C3290. +The following example generates C3290. ```cpp // C3290.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3291.md b/docs/error-messages/compiler-errors-2/compiler-error-c3291.md index 7786861b99d..ae67efb8b3a 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3291.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3291.md @@ -1,20 +1,21 @@ --- -description: "Learn more about: Compiler Error C3291" title: "Compiler Error C3291" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3291" +ms.date: 11/04/2016 f1_keywords: ["C3291"] helpviewer_keywords: ["C3291"] -ms.assetid: ed2e9f89-8dbc-4387-bc26-cc955e840858 --- # Compiler Error C3291 -'default' : cannot be the name of a trivial property +> 'default' : cannot be the name of a trivial property + +## Remarks A trivial property cannot be named **`default`**. See [property](../../extensions/property-cpp-component-extensions.md) for more information. ## Example -The following sample generates C3291. +The following example generates C3291. ```cpp // C3291.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3292.md b/docs/error-messages/compiler-errors-2/compiler-error-c3292.md index 06b23f7f6fa..6951f30c688 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3292.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3292.md @@ -1,20 +1,21 @@ --- -description: "Learn more about: Compiler Error C3292" title: "Compiler Error C3292" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3292" +ms.date: 11/04/2016 f1_keywords: ["C3292"] helpviewer_keywords: ["C3292"] -ms.assetid: ead485cc-5471-4e10-b361-300589ff5b70 --- # Compiler Error C3292 -the cli namespace cannot be reopened +> the cli namespace cannot be reopened + +## Remarks The cli namespace cannot be declared in your code. For more information, see [Platform, default, and cli Namespaces](../../extensions/platform-default-and-cli-namespaces-cpp-component-extensions.md). ## Example -The following sample generates C3292. +The following example generates C3292. ```cpp // C3292.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3293.md b/docs/error-messages/compiler-errors-2/compiler-error-c3293.md index 6ce9d649914..e62c1f37089 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3293.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3293.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Error C3293" title: "Compiler Error C3293" -ms.date: "07/21/2017" +description: "Learn more about: Compiler Error C3293" +ms.date: 07/21/2017 f1_keywords: ["C3293"] helpviewer_keywords: ["C3293"] -ms.assetid: b772cf98-52e0-4e24-be23-1f5d87d999ac --- # Compiler Error C3293 -'accessor': use 'default' to access the default property (indexer) for class 'type' +> 'accessor': use 'default' to access the default property (indexer) for class 'type' + +## Remarks An indexed property was accessed incorrectly. See [How to: Use Properties in C++/CLI](../../dotnet/how-to-use-properties-in-cpp-cli.md) for more information. @@ -16,7 +17,7 @@ An indexed property was accessed incorrectly. See [How to: Use Properties in C+ ## Example -The following sample generates C3293 in Visual Studio 2015 and earlier. +The following example generates C3293 in Visual Studio 2015 and earlier. ```cpp // C3293.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3295.md b/docs/error-messages/compiler-errors-2/compiler-error-c3295.md index 422e2296b2b..262bb7979b0 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3295.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3295.md @@ -1,16 +1,15 @@ --- -description: "Learn more about: Compiler Error C3295" title: "Compiler Error C3295" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3295" +ms.date: 11/04/2016 f1_keywords: ["C3295"] helpviewer_keywords: ["C3295"] -ms.assetid: 83f0aa4d-0e0a-4905-9f66-fcf9991fc07a --- # Compiler Error C3295 '#pragma pragma' can only be used at global or namespace scope -Some pragmas cannot be used in a function. See [Pragma Directives and the __Pragma Keyword](../../preprocessor/pragma-directives-and-the-pragma-keyword.md) for more information. +Some pragmas cannot be used in a function. See [Pragma directives and the `__pragma` and `_Pragma` keywords](../../preprocessor/pragma-directives-and-the-pragma-keyword.md) for more information. ## Example diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3296.md b/docs/error-messages/compiler-errors-2/compiler-error-c3296.md index 46a10a2ae6e..cc62bb8e34a 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3296.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3296.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Error C3296" title: "Compiler Error C3296" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3296" +ms.date: 11/04/2016 f1_keywords: ["C3296"] helpviewer_keywords: ["C3296"] -ms.assetid: fc4c9dcd-16cf-4eee-a1ac-c43e7c29e443 --- # Compiler Error C3296 -'property' : a property with this name already exists +> 'property' : a property with this name already exists + +## Remarks The compiler encountered more than one property with the same name. Each property in a type must have a unique name. @@ -16,7 +17,7 @@ For more information, see [property](../../extensions/property-cpp-component-ext ## Example -The following sample generates C3296. +The following example generates C3296. ```cpp // C3296.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3297.md b/docs/error-messages/compiler-errors-2/compiler-error-c3297.md index 569007694b7..8a2ba2122a7 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3297.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3297.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Error C3297" title: "Compiler Error C3297" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3297" +ms.date: 11/04/2016 f1_keywords: ["C3297"] helpviewer_keywords: ["C3297"] -ms.assetid: 2a718b4c-6cdb-4418-92c0-fc3a259431c4 --- # Compiler Error C3297 -'constraint_2' : cannot use 'constraint_1' as a constraint because 'constraint_1' has the value constraint +> 'constraint_2' : cannot use 'constraint_1' as a constraint because 'constraint_1' has the value constraint + +## Remarks Value classes are sealed. If a constraint is a value class, another constraint can never derive from it. @@ -16,7 +17,7 @@ For more information, see [Constraints on Generic Type Parameters (C++/CLI)](../ ## Example -The following sample generates C3297. +The following example generates C3297. ```cpp // C3297.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3298.md b/docs/error-messages/compiler-errors-2/compiler-error-c3298.md index 38cb9191d8c..5b6d1155d9c 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3298.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3298.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Error C3298" title: "Compiler Error C3298" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3298" +ms.date: 11/04/2016 f1_keywords: ["C3298"] helpviewer_keywords: ["C3298"] -ms.assetid: 458c2680-95bb-4d5e-895f-ce4115844193 --- # Compiler Error C3298 -'constraint_1' : cannot use 'constraint_2' as a constraint because 'constraint_2' has the ref constraint and 'constraint_1' has the value constraint +> 'constraint_1' : cannot use 'constraint_2' as a constraint because 'constraint_2' has the ref constraint and 'constraint_1' has the value constraint + +## Remarks You cannot specify mutually exclusive characteristics for a constraint. For example, a generic type parameter cannot be constrained to both a value type and a reference type. @@ -16,7 +17,7 @@ For more information, see [Constraints on Generic Type Parameters (C++/CLI)](../ ## Example -The following sample generates C3298. +The following example generates C3298. ```cpp // C3298.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3299.md b/docs/error-messages/compiler-errors-2/compiler-error-c3299.md index c9b8510b600..2ddb3da5245 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3299.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3299.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Error C3299" title: "Compiler Error C3299" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3299" +ms.date: 11/04/2016 f1_keywords: ["C3299"] helpviewer_keywords: ["C3299"] -ms.assetid: 7cabdf01-bceb-404f-9401-cdd9c7fc1641 --- # Compiler Error C3299 -'member_function' : cannot specify constraints, they are inherited from the base method +> 'member_function' : cannot specify constraints, they are inherited from the base method + +## Remarks When overriding a generic member function, you cannot specify constraint clauses (repeating the constraints implies that the constraints are not inherited). @@ -18,7 +19,7 @@ For more information, see [Constraints on Generic Type Parameters (C++/CLI)](../ ## Example -The following sample generates C3299. +The following example generates C3299. ```cpp // C3299.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3303.md b/docs/error-messages/compiler-errors-2/compiler-error-c3303.md index 323f0832162..db42b47058e 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3303.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3303.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Compiler Error C3303" title: "Compiler Error C3303" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3303" +ms.date: 11/04/2016 f1_keywords: ["C3303"] helpviewer_keywords: ["C3303"] -ms.assetid: c6f6ea3d-f6b7-4401-8bbb-f283a2c05540 --- # Compiler Error C3303 -'attribute': attribute can only be used on 'usage' +> 'attribute': attribute can only be used on 'usage' + +## Remarks An attempt was made to use an attribute where it is not valid. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3309.md b/docs/error-messages/compiler-errors-2/compiler-error-c3309.md index 651e7c8c0f9..779f2c44544 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3309.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3309.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C3309" title: "Compiler Error C3309" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3309" +ms.date: 11/04/2016 f1_keywords: ["C3309"] helpviewer_keywords: ["C3309"] -ms.assetid: 75ee16e3-7d4e-4c41-b3cb-64e9849c3aab --- # Compiler Error C3309 -'macro_name': module name cannot be a macro or a keyword +> 'macro_name': module name cannot be a macro or a keyword + +## Remarks The value that you pass to the name property of the module attribute cannot be a symbol for the preprocessor to expand; it must be a string literal. -The following sample generates C3309: +## Example + +The following example generates C3309: ```cpp // C3309.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3320.md b/docs/error-messages/compiler-errors-2/compiler-error-c3320.md index 50975948b9a..54472b937f7 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3320.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3320.md @@ -1,20 +1,21 @@ --- -description: "Learn more about: Compiler Error C3320" title: "Compiler Error C3320" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3320" +ms.date: 11/04/2016 f1_keywords: ["C3320"] helpviewer_keywords: ["C3320"] -ms.assetid: 2ef72d9a-1f1d-4b2e-b244-9fd3f3e70cb6 --- # Compiler Error C3320 -'type': type cannot have the same name as the module 'name' property +> 'type': type cannot have the same name as the module 'name' property + +## Remarks An exported user-defined type (UDT), which could be a struct, class, enum, or union, cannot have the same name as the parameter passed to the [module](../../windows/attributes/module-cpp.md) attribute's name property. ## Example -The following sample generates C3320: +The following example generates C3320: ```cpp // C3320.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3322.md b/docs/error-messages/compiler-errors-2/compiler-error-c3322.md index 374af497ee7..b8a614d504e 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3322.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3322.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Compiler Error C3322" title: "Compiler Error C3322" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3322" +ms.date: 11/04/2016 f1_keywords: ["C3322"] helpviewer_keywords: ["C3322"] -ms.assetid: d8a0ad95-30df-4337-b0c8-4747de0bef50 --- # Compiler Error C3322 -'property': is not a valid property for attribute 'attribute' +> 'property': is not a valid property for attribute 'attribute' + +## Remarks An invalid or unrecognized property (or parameter) was passed to an attribute. Check the documentation for the attribute. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3333.md b/docs/error-messages/compiler-errors-2/compiler-error-c3333.md index 731607d8c59..6279bcb307d 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3333.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3333.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Compiler Error C3333" title: "Compiler Error C3333" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3333" +ms.date: 11/04/2016 f1_keywords: ["C3333"] helpviewer_keywords: ["C3333"] -ms.assetid: 51693978-fba6-435a-a696-74735cc875de --- # Compiler Error C3333 -'type library': cannot #import corrupt type library +> 'type library': cannot #import corrupt type library + +## Remarks The type library specified in the `#import` statement is unreadable by the compiler. You may want to either regenerate the type library, if possible, or request a new type library from your supplier. You may want to use the OLE Viewer, supplied with Visual C++, to view the type library file to see what is the matter with it. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3334.md b/docs/error-messages/compiler-errors-2/compiler-error-c3334.md index 4710d310457..017856ba7c0 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3334.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3334.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Error C3334" title: "Compiler Error C3334" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3334" +ms.date: 11/04/2016 f1_keywords: ["C3334"] helpviewer_keywords: ["C3334"] -ms.assetid: e972c625-77e7-4022-8aba-e1db01d7a0d7 --- # Compiler Error C3334 -cannot #import corrupt type library +> cannot #import corrupt type library + +## Remarks The library file in a `#import` statement is corrupt and can't be consumed by the compiler. Corruption can come from bad generation of the module, disk corruption, or if the binary file was somehow edited and modified. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3340.md b/docs/error-messages/compiler-errors-2/compiler-error-c3340.md index 8eea083c5d9..0c76035b527 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3340.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3340.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C3340" title: "Compiler Error C3340" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3340" +ms.date: 11/04/2016 f1_keywords: ["C3340"] helpviewer_keywords: ["C3340"] -ms.assetid: 23b12298-b92a-4717-8380-f165c998cb8a --- # Compiler Error C3340 -'interface': interface cannot be both 'restricted' and 'default' in coclass 'class' +> 'interface': interface cannot be both 'restricted' and 'default' in coclass 'class' + +## Remarks The [restricted](../../windows/attributes/restricted.md) attribute and the [default](../../windows/attributes/default-cpp.md) attribute are mutually exclusive. -The following sample generates C3340: +## Example + +The following example generates C3340: ```cpp // C3340.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3342.md b/docs/error-messages/compiler-errors-2/compiler-error-c3342.md index f14134d5da0..e4edbd8c142 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3342.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3342.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Error C3342" title: "Compiler Error C3342" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3342" +ms.date: 11/04/2016 f1_keywords: ["C3342"] helpviewer_keywords: ["C3342"] -ms.assetid: 5c6d784f-bebe-4f7e-8615-44ca6f78bfba --- # Compiler Error C3342 -'attribute': ambiguous attribute +> 'attribute': ambiguous attribute + +## Remarks The compiler found more than one definition of an attribute. @@ -18,7 +19,7 @@ For more information, see [User-Defined Attributes](../../extensions/user-define ## Example -The following sample generates C3342. +The following example generates C3342. ```cpp // C3342.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3345.md b/docs/error-messages/compiler-errors-2/compiler-error-c3345.md index 7cbcbd255c2..852653abaa3 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3345.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3345.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Error C3345" title: "Compiler Error C3345" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3345" +ms.date: 11/04/2016 f1_keywords: ["C3345"] helpviewer_keywords: ["C3345"] -ms.assetid: 1dda4c79-73bb-441b-b939-746154c3afba --- # Compiler Error C3345 -'identifier': invalid identifier for module name +> 'identifier': invalid identifier for module name + +## Remarks The *identifier* for a module contains one or more unacceptable characters. An identifier is valid if the first character is an alphabetical, underscore, or high ANSI (0x80-FF) character, and any subsequent character is an alphanumeric, underscore, or high ANSI character. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3347.md b/docs/error-messages/compiler-errors-2/compiler-error-c3347.md index 4fe6b20eb35..3433ff4fd12 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3347.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3347.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C3347" title: "Compiler Error C3347" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3347" +ms.date: 11/04/2016 f1_keywords: ["C3347"] helpviewer_keywords: ["C3347"] -ms.assetid: e939ad29-0b78-4681-9618-9bdae5675cee --- # Compiler Error C3347 -'arg': required argument is not specified in attribute idl_module +> 'arg': required argument is not specified in attribute idl_module + +## Remarks A required argument was not passed to the [idl_module](../../windows/attributes/idl-module.md) attribute. -The following sample generates C3347: +## Example + +The following example generates C3347: ```cpp // C3347.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3350.md b/docs/error-messages/compiler-errors-2/compiler-error-c3350.md index 832d21b80ca..57907de24ac 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3350.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3350.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C3350" title: "Compiler Error C3350" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3350" +ms.date: 11/04/2016 f1_keywords: ["C3350"] helpviewer_keywords: ["C3350"] -ms.assetid: cfbbc338-92b5-4f34-999e-aa2d2376bc70 --- # Compiler Error C3350 -'delegate' : a delegate constructor expects number argument(s) +> 'delegate' : a delegate constructor expects number argument(s) + +## Remarks When you create an instance of a delegate, you must pass two arguments, an instance of the type containing the delegate function, and the function. -The following sample generates C3350: +## Example + +The following example generates C3350: ```cpp // C3350.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3351.md b/docs/error-messages/compiler-errors-2/compiler-error-c3351.md index 3962af7b367..0734f32ab3f 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3351.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3351.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C3351" title: "Compiler Error C3351" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3351" +ms.date: 11/04/2016 f1_keywords: ["C3351"] helpviewer_keywords: ["C3351"] -ms.assetid: c021bbbe-1067-4f51-af4f-940d2b792eb5 --- # Compiler Error C3351 -'object' : delegate constructor: second argument must be address of a static member function or global function +> 'object' : delegate constructor: second argument must be address of a static member function or global function + +## Remarks The compiler expected the address of a function declared **`static`**. -The following sample generates C3351: +## Example + +The following example generates C3351: ```cpp // C3351a.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3352.md b/docs/error-messages/compiler-errors-2/compiler-error-c3352.md index 60bf88d2fa8..1268b23389d 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3352.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3352.md @@ -1,20 +1,23 @@ --- -description: "Learn more about: Compiler Error C3352" title: "Compiler Error C3352" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3352" +ms.date: 11/04/2016 f1_keywords: ["C3352"] helpviewer_keywords: ["C3352"] -ms.assetid: f233bed7-474e-425f-aad2-7801578169d4 --- # Compiler Error C3352 -'function' : the specified function does not match the delegate type 'type' +> 'function' : the specified function does not match the delegate type 'type' + +## Remarks The parameter lists for `function` and the delegate do not match. For more information, see [delegate (C++ Component Extensions)](../../extensions/delegate-cpp-component-extensions.md). -The following sample generates C3352: +## Example + +The following example generates C3352: ```cpp // C3352.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3353.md b/docs/error-messages/compiler-errors-2/compiler-error-c3353.md index de559c94332..1499d4c19ef 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3353.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3353.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C3353" title: "Compiler Error C3353" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3353" +ms.date: 11/04/2016 f1_keywords: ["C3353"] helpviewer_keywords: ["C3353"] -ms.assetid: 5699c04b-d504-46ce-bf71-c200318fed71 --- # Compiler Error C3353 -'delegate' : a delegate can only be created from a global function or a member function of a managed or WinRT type +> 'delegate' : a delegate can only be created from a global function or a member function of a managed or WinRT type + +## Remarks Delegates, declared with the [delegate](../../extensions/delegate-cpp-component-extensions.md) keyword, can only be declared at global scope. -The following sample generates C3353: +## Example + +The following example generates C3353: ```cpp // C3353.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3354.md b/docs/error-messages/compiler-errors-2/compiler-error-c3354.md index ba44cfdb382..a3f9b768b05 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3354.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3354.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Error C3354" title: "Compiler Error C3354" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3354" +ms.date: 11/04/2016 f1_keywords: ["C3354"] helpviewer_keywords: ["C3354"] -ms.assetid: 185de401-231e-4999-a149-172ee4c69d84 --- # Compiler Error C3354 -'function' : the function used to create a delegate cannot have return type 'type' +> 'function' : the function used to create a delegate cannot have return type 'type' + +## Remarks The following types are invalid as return types for a **`delegate`**: @@ -22,7 +23,9 @@ The following types are invalid as return types for a **`delegate`**: - Reference to member function -The following sample generates C3354: +## Example + +The following example generates C3354: ```cpp // C3354_2.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3356.md b/docs/error-messages/compiler-errors-2/compiler-error-c3356.md index 507aa851102..d4ead99fde5 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3356.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3356.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Compiler Error C3356" title: "Compiler Error C3356" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3356" +ms.date: 11/04/2016 f1_keywords: ["C3356"] helpviewer_keywords: ["C3356"] -ms.assetid: 6c1094f6-ac85-480a-b78b-e92fcf38641a --- # Compiler Error C3356 -'attribute': cannot call a multicast attribute with a fully qualified name +> 'attribute': cannot call a multicast attribute with a fully qualified name + +## Remarks An attribute that is processed by more than one process, for example, the compiler and ATL provider, was specified incorrectly. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3358.md b/docs/error-messages/compiler-errors-2/compiler-error-c3358.md index 44e865694af..e433cbf1dce 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3358.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3358.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C3358" title: "Compiler Error C3358" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3358" +ms.date: 11/04/2016 f1_keywords: ["C3358"] helpviewer_keywords: ["C3358"] -ms.assetid: 180b93df-e78f-441a-91fb-1594c681f7f0 --- # Compiler Error C3358 -'symbol': symbol not found +> 'symbol': symbol not found + +## Remarks The required symbol was not found. -The following sample generates C3358: +## Example + +The following example generates C3358: ```cpp // C3358.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3360.md b/docs/error-messages/compiler-errors-2/compiler-error-c3360.md index f8f06342a45..312db01e736 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3360.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3360.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C3360" title: "Compiler Error C3360" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3360" +ms.date: 11/04/2016 f1_keywords: ["C3360"] helpviewer_keywords: ["C3360"] -ms.assetid: 6acf983a-dbb6-422b-b045-a34bb4ba6761 --- # Compiler Error C3360 -'string': cannot create name +> 'string': cannot create name + +## Remarks The value that was passed to the [uuid](../../windows/attributes/uuid-cpp-attributes.md) attribute was not valid. -The following sample generates C3360: +## Example + +The following example generates C3360: ```cpp // C3360.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3363.md b/docs/error-messages/compiler-errors-2/compiler-error-c3363.md index d224e476b45..11a8d33c1f1 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3363.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3363.md @@ -1,20 +1,21 @@ --- -description: "Learn more about: Compiler Error C3363" title: "Compiler Error C3363" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3363" +ms.date: 11/04/2016 f1_keywords: ["C3363"] helpviewer_keywords: ["C3363"] -ms.assetid: 41aa922f-608e-4f7a-ba66-451fc1161935 --- # Compiler Error C3363 -'type' : 'typeid' can only be applied to a type +> 'type' : 'typeid' can only be applied to a type + +## Remarks The [typeid](../../extensions/typeid-cpp-component-extensions.md) operator was used incorrectly. ## Example -The following sample generates C3363. +The following example generates C3363. ```cpp // C3363.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3364.md b/docs/error-messages/compiler-errors-2/compiler-error-c3364.md index 252a5951662..97e7ec74e88 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3364.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3364.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C3364" title: "Compiler Error C3364" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3364" +ms.date: 11/04/2016 f1_keywords: ["C3364"] helpviewer_keywords: ["C3364"] -ms.assetid: 98654741-60fe-4472-a6af-e580f8c0a6e1 --- # Compiler Error C3364 -'delegate': delegate constructor: argument must be pointer to member function of managed class or global function +> 'delegate': delegate constructor: argument must be pointer to member function of managed class or global function + +## Remarks The second parameter of the delegate's constructor takes either the address of a member function or the address of a static member function of any class. Both are treated as simple addresses. -The following sample generates C3364: +## Example + +The following example generates C3364: ```cpp // C3364_2.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3365.md b/docs/error-messages/compiler-errors-2/compiler-error-c3365.md index 2966274d70a..4d6ea4ed4f7 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3365.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3365.md @@ -1,20 +1,21 @@ --- -description: "Learn more about: Compiler Error C3365" title: "Compiler Error C3365" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3365" +ms.date: 11/04/2016 f1_keywords: ["C3365"] helpviewer_keywords: ["C3365"] -ms.assetid: 875ec3a4-522c-4e3d-9b67-48808b857f6d --- # Compiler Error C3365 -operator 'operator' : differing operands of type 'type1' and 'type2' +> operator 'operator' : differing operands of type 'type1' and 'type2' + +## Remarks An attempt was made to compose delegates with different types. See [How to: Define and Use Delegates (C++/CLI)](../../dotnet/how-to-define-and-use-delegates-cpp-cli.md) for more information about delegates. ## Example -The following sample generates C3365: +The following example generates C3365: ```cpp // C3365.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3366.md b/docs/error-messages/compiler-errors-2/compiler-error-c3366.md index e29cedffa30..084e2ae3240 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3366.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3366.md @@ -1,19 +1,22 @@ --- -description: "Learn more about: Compiler Error C3366" title: "Compiler Error C3366" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3366" +ms.date: 11/04/2016 f1_keywords: ["C3366"] helpviewer_keywords: ["C3366"] -ms.assetid: efc55bcf-c16d-43c1-a36f-87a6165fa2a8 --- # Compiler Error C3366 -'variable' : static data members of managed or WinRTtypes must be defined within the class definition +> 'variable' : static data members of managed or WinRTtypes must be defined within the class definition + +## Remarks You attempted to reference a static member of a WinRT or .NET class or interface outside the definition of that class or interface. The compiler needs to know the full definition of the class (to emit the meta-data after one pass) and requires static data members to be initialized within the class. +## Example + For example, the following example generates C3366 and shows how to fix it: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3367.md b/docs/error-messages/compiler-errors-2/compiler-error-c3367.md index c7b9e199930..906b2d970b5 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3367.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3367.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Error C3367" title: "Compiler Error C3367" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3367" +ms.date: 11/04/2016 f1_keywords: ["C3367"] helpviewer_keywords: ["C3367"] -ms.assetid: e675d42b-f5b0-4d43-aab1-1f5024233102 --- # Compiler Error C3367 -'static_member_function' : cannot use static function to create an unbound delegate +> 'static_member_function' : cannot use static function to create an unbound delegate + +## Remarks When you call an unbound delegate, you must pass an instance of an object. Since a static member function is called through the class name, you can only instantiate an unbound delegate with an instance member function. @@ -16,7 +17,7 @@ For more information about unbound delegates, see [How to: Define and Use Delega ## Example -The following sample generates C3367. +The following example generates C3367. ```cpp // C3367.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3368.md b/docs/error-messages/compiler-errors-2/compiler-error-c3368.md index 56c588043ec..8b719026039 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3368.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3368.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C3368" title: "Compiler Error C3368" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3368" +ms.date: 11/04/2016 f1_keywords: ["C3368"] helpviewer_keywords: ["C3368"] -ms.assetid: 5bfd5be4-dfa9-4b33-9612-010561b40955 --- # Compiler Error C3368 -'function declaration' : invalid calling convention for IDL +> 'function declaration' : invalid calling convention for IDL + +## Remarks You can only use the [__stdcall](../../cpp/stdcall.md) or [__cdecl](../../cpp/cdecl.md) calling conventions in an .idl file. -The following sample generates C3368: +## Example + +The following example generates C3368: ```cpp // C3368.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3369.md b/docs/error-messages/compiler-errors-2/compiler-error-c3369.md index 55cbcf23004..fd633c461d1 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3369.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3369.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C3369" title: "Compiler Error C3369" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3369" +ms.date: 11/04/2016 f1_keywords: ["C3369"] helpviewer_keywords: ["C3369"] -ms.assetid: c6ceb9cb-3df9-4334-9a5c-d16db351d476 --- # Compiler Error C3369 -'module name': idl_module already defined +> 'module name': idl_module already defined + +## Remarks The [idl_module](../../windows/attributes/idl-module.md) usage where you define the DLL can only occur once in a program. -The following sample generates C3369: +## Example + +The following example generates C3369: ```cpp // C3369.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3370.md b/docs/error-messages/compiler-errors-2/compiler-error-c3370.md index 519ed9ab92b..c6771ad1148 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3370.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3370.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C3370" title: "Compiler Error C3370" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3370" +ms.date: 11/04/2016 f1_keywords: ["C3370"] helpviewer_keywords: ["C3370"] -ms.assetid: ee6d4c85-78fc-42b2-836e-5cc491a3b2ba --- # Compiler Error C3370 -'idl_module name': idl_module not yet defined +> 'idl_module name': idl_module not yet defined + +## Remarks Before you can use [idl_module](../../windows/attributes/idl-module.md) to specify an entry point in a DLL, you must first use `idl_module` to specify the DLL name. -The following sample generates C3370: +## Example + +The following example generates C3370: ```cpp // C3370.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3371.md b/docs/error-messages/compiler-errors-2/compiler-error-c3371.md index 3eed2c81fba..d6003778a7f 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3371.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3371.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C3371" title: "Compiler Error C3371" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3371" +ms.date: 11/04/2016 f1_keywords: ["C3371"] helpviewer_keywords: ["C3371"] -ms.assetid: f7ecf1aa-ed0a-4f73-81e5-62cf98f88ea1 --- # Compiler Error C3371 -'idl_module': only the 'name' property is allowed here +> 'idl_module': only the 'name' property is allowed here + +## Remarks [idl_module](../../windows/attributes/idl-module.md) usage directly on a function declaration cannot have any parameters other than name. -The following sample generates C3371: +## Example + +The following example generates C3371: ```cpp // C3371.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3372.md b/docs/error-messages/compiler-errors-2/compiler-error-c3372.md index 52307011d61..91cb56aa842 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3372.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3372.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C3372" title: "Compiler Error C3372" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3372" +ms.date: 11/04/2016 f1_keywords: ["C3372"] helpviewer_keywords: ["C3372"] -ms.assetid: 38ee39ed-03ff-4e6d-9104-f1977b96645d --- # Compiler Error C3372 -must specify at least 1 interface for attribute 'source' on a coclass +> must specify at least 1 interface for attribute 'source' on a coclass + +## Remarks For certain attributes, you must pass an interface name as a parameter. -The following sample generates C3372: +## Example + +The following example generates C3372: ```cpp // C3372.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3373.md b/docs/error-messages/compiler-errors-2/compiler-error-c3373.md index 373f91ea803..5df76fc80d5 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3373.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3373.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C3373" title: "Compiler Error C3373" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3373" +ms.date: 11/04/2016 f1_keywords: ["C3373"] helpviewer_keywords: ["C3373"] -ms.assetid: 6e7586c3-1a15-4773-ad20-f90090a400dc --- # Compiler Error C3373 -attribute 'attribute' takes no arguments except on a coclass +> attribute 'attribute' takes no arguments except on a coclass + +## Remarks Some attributes can be applied to more than one C++ construct, but arguments to the attribute may only be allowed on some constructs. -The following sample generates C3373: +## Example + +The following example generates C3373: ```cpp // C3373.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3374.md b/docs/error-messages/compiler-errors-2/compiler-error-c3374.md index 5b1012f661c..3256f943241 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3374.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3374.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C3374" title: "Compiler Error C3374" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3374" +ms.date: 11/04/2016 f1_keywords: ["C3374"] helpviewer_keywords: ["C3374"] -ms.assetid: 41431299-bd20-47d4-a0c8-1334dd79018b --- # Compiler Error C3374 -can't take address of 'function' unless creating delegate instance +> can't take address of 'function' unless creating delegate instance + +## Remarks The address of a function was taken in a context other than the creation of a delegate instance. -The following sample generates C3374: +## Example + +The following example generates C3374: ```cpp // C3374.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3375.md b/docs/error-messages/compiler-errors-2/compiler-error-c3375.md index 5e7405e0170..41c91468995 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3375.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3375.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Error C3375" title: "Compiler Error C3375" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3375" +ms.date: 11/04/2016 f1_keywords: ["C3375"] helpviewer_keywords: ["C3375"] -ms.assetid: f1df78c6-e6ca-48f3-8b29-4e1710002bf3 --- # Compiler Error C3375 -'function' : ambiguous delegate function +> 'function' : ambiguous delegate function + +## Remarks A delegate instantiation could have been to a static member function, or as an unbound delegate to an instance function, so the compiler issued this error. @@ -16,7 +17,7 @@ For more information, see [delegate (C++ Component Extensions)](../../extension ## Example -The following sample generates C3375. +The following example generates C3375. ```cpp // C3375.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3379.md b/docs/error-messages/compiler-errors-2/compiler-error-c3379.md index baacee8b4ed..3d953bb8c7d 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3379.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3379.md @@ -1,20 +1,23 @@ --- -description: "Learn more about: Compiler Error C3379" title: "Compiler Error C3379" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3379" +ms.date: 11/04/2016 f1_keywords: ["C3379"] helpviewer_keywords: ["C3379"] -ms.assetid: a66c2c4e-091c-4426-9cde-7c4cfb2ffce1 --- # Compiler Error C3379 -'class' : a nested class cannot have an assembly access specifier as part of its declaration +> 'class' : a nested class cannot have an assembly access specifier as part of its declaration + +## Remarks When applied to a managed type, such as class or struct, the [public](../../cpp/public-cpp.md) and [private](../../cpp/private-cpp.md) keywords indicate whether the class will be exposed through assembly metadata. `public` or `private` cannot be applied to a nested class, which will inherit the assembly access of the enclosing class. When used with [/clr](../../build/reference/clr-common-language-runtime-compilation.md), the `ref` and `value` keywords indicate that a class is managed (see [Classes and Structs](../../extensions/classes-and-structs-cpp-component-extensions.md)). -The following sample generates C3379: +## Example + +The following example generates C3379: ```cpp // C3379a.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3380.md b/docs/error-messages/compiler-errors-2/compiler-error-c3380.md index a150009936f..124b958b0d2 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3380.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3380.md @@ -1,20 +1,23 @@ --- -description: "Learn more about: Compiler Error C3380" title: "Compiler Error C3380" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3380" +ms.date: 11/04/2016 f1_keywords: ["C3380"] helpviewer_keywords: ["C3380"] -ms.assetid: 86f1f4ec-4ad8-4a1a-9b6c-2d9b6129df6b --- # Compiler Error C3380 -'class' : invalid assembly access specifier - only 'public' or 'private' are allowed +> 'class' : invalid assembly access specifier - only 'public' or 'private' are allowed + +## Remarks When applied to a managed class or struct, the [public](../../cpp/public-cpp.md) and [private](../../cpp/private-cpp.md) keywords indicate whether the class will be exposed through assembly metadata. Only `public` or `private` can be applied to a class in a program compiled with [/clr](../../build/reference/clr-common-language-runtime-compilation.md). The `ref` and `value` keywords, when used with [/clr](../../build/reference/clr-common-language-runtime-compilation.md), indicate that a class is managed (see [Classes and Structs](../../extensions/classes-and-structs-cpp-component-extensions.md)). -The following sample generates C3380: +## Example + +The following example generates C3380: ```cpp // C3380_2.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3381.md b/docs/error-messages/compiler-errors-2/compiler-error-c3381.md index 36a5ded5ce2..913b50fe2cd 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3381.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3381.md @@ -4,23 +4,22 @@ description: "Microsoft C++ compiler error C3381, its causes and how to resolve ms.date: 09/28/2020 f1_keywords: ["C3381"] helpviewer_keywords: ["C3381"] -ms.assetid: d276c89f-8377-4cb6-a8d4-7770885f06c4 --- # Compiler Error C3381 > '*identifier*' : assembly access specifiers are only available in code compiled with a /clr option -A type was declared or defined by using an access specifier, which is only permitted in code compiled by using **`/clr`**. - ## Remarks +A type was declared or defined by using an access specifier, which is only permitted in code compiled by using **`/clr`**. + This error may result from a misplaced **`public`**, **`protected`**, or **`private`** keyword, or a missing colon (**`:`**) after an access specifier within a **`class`** or **`struct`**. In C++/CLI, native types can be visible outside an assembly, but you can only specify assembly access for native types in a **`/clr`** compilation. For more information, see [Type visibility](../../dotnet/how-to-define-and-consume-classes-and-structs-cpp-cli.md#BKMK_Type_visibility) and [`/clr` (Common Language Runtime Compilation)](../../build/reference/clr-common-language-runtime-compilation.md). ## Example -The following sample generates C3381. To fix it, first either remove the **`public`** specifier from the `class A` definition, or compile by using the **`/clr`** option. Next, add a colon after **`private`** to specify access for `class B {} b;`. That's because a nested class can't have an assembly access specifier as part of its declaration. +The following example generates C3381. To fix it, first either remove the **`public`** specifier from the `class A` definition, or compile by using the **`/clr`** option. Next, add a colon after **`private`** to specify access for `class B {} b;`. That's because a nested class can't have an assembly access specifier as part of its declaration. ```cpp // C3381.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3382.md b/docs/error-messages/compiler-errors-2/compiler-error-c3382.md index e66b793fc50..1314e1265cd 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3382.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3382.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Error C3382" title: "Compiler Error C3382" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3382" +ms.date: 11/04/2016 f1_keywords: ["C3382"] helpviewer_keywords: ["C3382"] -ms.assetid: a7603abd-ac4e-4ae6-a02b-3bdc6d1908a6 --- # Compiler Error C3382 -'sizeof' is not supported with /clr:safe +> 'sizeof' is not supported with /clr:safe + +## Remarks The output file of a **/clr:safe** compilation is a file that is verifiably type safe, and sizeof is not supported because the return value of the sizeof operator is size_t, whose size varies depending on the operating system. @@ -22,7 +23,7 @@ For more information, see, ## Example -The following sample generates C3382. +The following example generates C3382. ```cpp // C3382.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3383.md b/docs/error-messages/compiler-errors-2/compiler-error-c3383.md index 2c45ba4d14d..1a7f753626c 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3383.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3383.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Error C3383" title: "Compiler Error C3383" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3383" +ms.date: 11/04/2016 f1_keywords: ["C3383"] helpviewer_keywords: ["C3383"] -ms.assetid: ceb7f725-f417-4dc3-8496-0f413bb76687 --- # Compiler Error C3383 -'operator new' is not supported with /clr:safe +> 'operator new' is not supported with /clr:safe + +## Remarks The output file of a **/clr:safe** compilation is a file that is verifiably type safe, and pointers are not supported. @@ -20,7 +21,7 @@ For more information, see, ## Example -The following sample generates C3383. +The following example generates C3383. ```cpp // C3383.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3384.md b/docs/error-messages/compiler-errors-2/compiler-error-c3384.md index 29c4ae7a09f..b9652439d74 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3384.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3384.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Error C3384" title: "Compiler Error C3384" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3384" +ms.date: 11/04/2016 f1_keywords: ["C3384"] helpviewer_keywords: ["C3384"] -ms.assetid: c9f92c6a-62a9-4333-b2b1-bc55c7f288b6 --- # Compiler Error C3384 -'type_parameter' : the value constraint and the ref constraint are mutually exclusive +> 'type_parameter' : the value constraint and the ref constraint are mutually exclusive + +## Remarks You cannot constrain a generic type to both **`value class`** and **`ref class`**. @@ -16,7 +17,7 @@ See [Constraints on Generic Type Parameters (C++/CLI)](../../extensions/constrai ## Example -The following sample generates C3384. +The following example generates C3384. ```cpp // C3384.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3385.md b/docs/error-messages/compiler-errors-2/compiler-error-c3385.md index 84eb77cee46..4bdd233dd9a 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3385.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3385.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C3385" title: "Compiler Error C3385" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3385" +ms.date: 11/04/2016 f1_keywords: ["C3385"] helpviewer_keywords: ["C3385"] -ms.assetid: 5f1838c1-986e-47db-8dbc-e06976b83cf3 --- # Compiler Error C3385 -'class::function' : a function that has a DllImport Custom attribute cannot return an instance of a class +> 'class::function' : a function that has a DllImport Custom attribute cannot return an instance of a class + +## Remarks A function defined as being in a .dll file specified with the `DllImport` attribute cannot return an instance of a class. -The following sample generates C3385: +## Example + +The following example generates C3385: ```cpp // C3385.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3386.md b/docs/error-messages/compiler-errors-2/compiler-error-c3386.md index 0c91775a21d..b6e8bef3bad 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3386.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3386.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C3386" title: "Compiler Error C3386" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3386" +ms.date: 11/04/2016 f1_keywords: ["C3386"] helpviewer_keywords: ["C3386"] -ms.assetid: 93fa8c33-0f10-402b-8eec-b0a217a1f8dc --- # Compiler Error C3386 > '*type-name*' : `__declspec(dllexport)`/`__declspec(dllimport)` cannot be applied to a managed or WinRT type +## Remarks + The [`dllimport`](../../cpp/dllexport-dllimport.md) and [`dllexport`](../../cpp/dllexport-dllimport.md) **`__declspec`** modifiers aren't valid on a managed or Windows Runtime type. -The following sample generates C3386 and shows how to fix it: +## Example + +The following example generates C3386 and shows how to fix it: ```cpp // C3386.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3387.md b/docs/error-messages/compiler-errors-2/compiler-error-c3387.md index e4ebc2bbf6b..1aa8d110eef 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3387.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3387.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C3387" title: "Compiler Error C3387" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3387" +ms.date: 11/04/2016 f1_keywords: ["C3387"] helpviewer_keywords: ["C3387"] -ms.assetid: c54d9925-ed14-4976-b8db-e8d4dc84e536 --- # Compiler Error C3387 -'member' : __declspec(dllexport)/\__declspec(dllimport) cannot be applied to a member of a managed or WinRT type +> 'member' : __declspec(dllexport)/\__declspec(dllimport) cannot be applied to a member of a managed or WinRT type + +## Remarks The `dllimport` and [dllexport](../../cpp/dllexport-dllimport.md) **`__declspec`** modifiers are not valid on members of a managed or Windows Runtime type. -The following sample generates C3387 and shows how to fix it: +## Example + +The following example generates C3387 and shows how to fix it: ```cpp // C3387a.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3388.md b/docs/error-messages/compiler-errors-2/compiler-error-c3388.md index 570db2843a3..1b69e8c4669 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3388.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3388.md @@ -1,20 +1,21 @@ --- -description: "Learn more about: Compiler Error C3388" title: "Compiler Error C3388" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3388" +ms.date: 11/04/2016 f1_keywords: ["C3388"] helpviewer_keywords: ["C3388"] -ms.assetid: 34336545-ed13-4d81-ab5f-f869799fe4c2 --- # Compiler Error C3388 -'type' : not allowed as a constraint, assuming 'ref class' to continue parsing +> 'type' : not allowed as a constraint, assuming 'ref class' to continue parsing + +## Remarks A constraint was specified on a generic type, but the constraint was not specified correctly. See [Constraints on Generic Type Parameters (C++/CLI)](../../extensions/constraints-on-generic-type-parameters-cpp-cli.md) for more information. ## Example -The following sample generates C3388. +The following example generates C3388. ```cpp // C3388.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3389.md b/docs/error-messages/compiler-errors-2/compiler-error-c3389.md index 01353be5e88..4f662925f08 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3389.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3389.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3389" title: "Compiler Error C3389" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3389" +ms.date: 11/04/2016 f1_keywords: ["C3389"] helpviewer_keywords: ["C3389"] -ms.assetid: eaaffe17-23f2-413c-b1ad-f7220cfa1334 --- # Compiler Error C3389 @@ -18,7 +17,7 @@ A [`__declspec`](../../cpp/declspec.md) modifier used implies a per-process stat ## Example -The following sample generates C3389: +The following example generates C3389: ```cpp // C3389.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3390.md b/docs/error-messages/compiler-errors-2/compiler-error-c3390.md index ecd8d608dd0..ff243fdbd3e 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3390.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3390.md @@ -4,21 +4,20 @@ description: "Microsoft C++ compiler error C3390, its causes and how to resolve ms.date: 09/26/2020 f1_keywords: ["C3390"] helpviewer_keywords: ["C3390"] -ms.assetid: 84800a87-c8e6-45aa-82ae-02f816dc8d97 --- # Compiler Error C3390 > '*type_arg*' : invalid type argument for generic parameter '*param*' of generic '*generic_type*', must be a reference type -A generic type was instantiated incorrectly. Check the type definition. - ## Remarks +A generic type was instantiated incorrectly. Check the type definition. + For more information, see [Generics](../../extensions/generics-cpp-component-extensions.md). ## Example -The first sample uses C# to create a component that contains a generic type. This type has certain constraints that aren't supported when authoring generic types in C++/CLI. For more information, see [Constraints on Type Parameters](/dotnet/csharp/programming-guide/generics/constraints-on-type-parameters). +The first example uses C# to create a component that contains a generic type. This type has certain constraints that aren't supported when authoring generic types in C++/CLI. For more information, see [Constraints on Type Parameters](/dotnet/csharp/programming-guide/generics/constraints-on-type-parameters). ```csharp // C3390.cs @@ -30,7 +29,7 @@ where V : struct where N : new() {} ``` -When the C3390.dll component is available, the following sample generates C3390. +When the C3390.dll component is available, the following example generates C3390. ```cpp // C3390_b.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3391.md b/docs/error-messages/compiler-errors-2/compiler-error-c3391.md index 6960f3ffb04..32d4d18f191 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3391.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3391.md @@ -1,20 +1,21 @@ --- -description: "Learn more about: Compiler Error C3391" title: "Compiler Error C3391" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3391" +ms.date: 11/04/2016 f1_keywords: ["C3391"] helpviewer_keywords: ["C3391"] -ms.assetid: c32532b9-7db4-4ccd-84b9-479e5a1a19d1 --- # Compiler Error C3391 -'type_arg' : invalid type argument for generic parameter 'param' of generic 'generic_type', must be a non-nullable value type +> 'type_arg' : invalid type argument for generic parameter 'param' of generic 'generic_type', must be a non-nullable value type + +## Remarks A generic type was instantiated incorrectly. Check the type definition. For more information, see and [Generics](../../extensions/generics-cpp-component-extensions.md). ## Example -The following sample uses C# to create a component that contains a generic type that has certain constraints that are not supported when authoring generic types in C++/CLI. For more information, see [Constraints on Type Parameters](/dotnet/csharp/programming-guide/generics/constraints-on-type-parameters). +The following example uses C# to create a component that contains a generic type that has certain constraints that are not supported when authoring generic types in C++/CLI. For more information, see [Constraints on Type Parameters](/dotnet/csharp/programming-guide/generics/constraints-on-type-parameters). ```csharp // C3391.cs @@ -24,7 +25,7 @@ public class GR where N : struct {} ``` -When the C3391.dll component is available, the following sample generates C3391. +When the C3391.dll component is available, the following example generates C3391. ```cpp // C3391_b.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3392.md b/docs/error-messages/compiler-errors-2/compiler-error-c3392.md index 79b2f3c2bb8..57b89416bf3 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3392.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3392.md @@ -1,20 +1,21 @@ --- -description: "Learn more about: Compiler Error C3392" title: "Compiler Error C3392" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3392" +ms.date: 11/04/2016 f1_keywords: ["C3392"] helpviewer_keywords: ["C3392"] -ms.assetid: e4757596-e2aa-4314-b01e-5c4bfd2110e9 --- # Compiler Error C3392 -'type_arg' : invalid type argument for generic parameter 'param' of generic 'generic_type', must have a public parameterless constructor +> 'type_arg' : invalid type argument for generic parameter 'param' of generic 'generic_type', must have a public parameterless constructor + +## Remarks A generic type was instantiated incorrectly. Check the type definition. For more information, see [Generics](../../extensions/generics-cpp-component-extensions.md). ## Example -The following sample uses C# to create a component that contains a generic type that has certain constraints that are not supported when authoring generic types in C++/CLI. For more information, see [Constraints on Type Parameters](/dotnet/csharp/programming-guide/generics/constraints-on-type-parameters). +The following example uses C# to create a component that contains a generic type that has certain constraints that are not supported when authoring generic types in C++/CLI. For more information, see [Constraints on Type Parameters](/dotnet/csharp/programming-guide/generics/constraints-on-type-parameters). ```csharp // C3392.cs @@ -26,7 +27,7 @@ where V : struct where N : new() {} ``` -When the C3392.dll component is available, the following sample generates C3392. +When the C3392.dll component is available, the following example generates C3392. ```cpp // C3392_b.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3393.md b/docs/error-messages/compiler-errors-2/compiler-error-c3393.md index f302d672a06..82ca666acc1 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3393.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3393.md @@ -1,20 +1,21 @@ --- -description: "Learn more about: Compiler Error C3393" title: "Compiler Error C3393" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3393" +ms.date: 11/04/2016 f1_keywords: ["C3393"] helpviewer_keywords: ["C3393"] -ms.assetid: d57f7c69-0a02-4fe3-9e45-bc62644fd77c --- # Compiler Error C3393 -syntax error in constraint clause: 'identifier' is not a type +> syntax error in constraint clause: 'identifier' is not a type + +## Remarks The identifier passed to a constraint, which must be a type, was not a type. For more information, see [Constraints on Generic Type Parameters (C++/CLI)](../../extensions/constraints-on-generic-type-parameters-cpp-cli.md). ## Example -The following sample generates C3393: +The following example generates C3393: ```cpp // C3393.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3394.md b/docs/error-messages/compiler-errors-2/compiler-error-c3394.md index 8586236b83c..a2866af1438 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3394.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3394.md @@ -1,20 +1,21 @@ --- -description: "Learn more about: Compiler Error C3394" title: "Compiler Error C3394" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3394" +ms.date: 11/04/2016 f1_keywords: ["C3394"] helpviewer_keywords: ["C3394"] -ms.assetid: 4e025d79-27ba-43c8-b0d9-839ecef98126 --- # Compiler Error C3394 -syntax error in constraint clause: found 'identifier' expected a type +> syntax error in constraint clause: found 'identifier' expected a type + +## Remarks A constraint was ill formed. For more information, see [Constraints on Generic Type Parameters (C++/CLI)](../../extensions/constraints-on-generic-type-parameters-cpp-cli.md). ## Example -The following sample generates C3394: +The following example generates C3394: ```cpp // C3394.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3395.md b/docs/error-messages/compiler-errors-2/compiler-error-c3395.md index 932858dc94a..5c14e3a6380 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3395.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3395.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C3395" title: "Compiler Error C3395" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3395" +ms.date: 11/04/2016 f1_keywords: ["C3395"] helpviewer_keywords: ["C3395"] -ms.assetid: 26a9ebc9-ed97-47ce-b436-19aa2bcf6e50 --- # Compiler Error C3395 -'function' : __declspec(dllexport) cannot be applied to a function with the \__clrcall calling convention +> 'function' : __declspec(dllexport) cannot be applied to a function with the \__clrcall calling convention + +## Remarks `__declspec(dllexport)` and [__clrcall](../../cpp/clrcall.md) are not compatible. For more information, see [dllexport, dllimport](../../cpp/dllexport-dllimport.md). -The following sample generates C3395: +## Example + +The following example generates C3395: ```cpp // C3395.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3396.md b/docs/error-messages/compiler-errors-2/compiler-error-c3396.md index 3d79f79eec6..958845bb38e 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3396.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3396.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Compiler Error C3396" title: "Compiler Error C3396" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3396" +ms.date: 11/04/2016 f1_keywords: ["C3396"] helpviewer_keywords: ["C3396"] -ms.assetid: e3580e32-72ec-4c3e-8afa-755603ffd25c --- # Compiler Error C3396 -'attribute' : custom attribute not found in 'namespace' +> 'attribute' : custom attribute not found in 'namespace' + +## Remarks C3396 indicates that you are not using an up-to-date common language runtime. Reinstall your CLR to resolve. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3397.md b/docs/error-messages/compiler-errors-2/compiler-error-c3397.md index 92b7b3b5ae7..62ff9b28448 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3397.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3397.md @@ -1,20 +1,21 @@ --- -description: "Learn more about: Compiler Error C3397" title: "Compiler Error C3397" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3397" +ms.date: 11/04/2016 f1_keywords: ["C3397"] helpviewer_keywords: ["C3397"] -ms.assetid: a8536e87-79c4-4ed7-bd96-42704d06391f --- # Compiler Error C3397 -Aggregate initialization is not allowed in default arguments +> Aggregate initialization is not allowed in default arguments + +## Remarks An array was declared incorrectly. See [Arrays](../../extensions/arrays-cpp-component-extensions.md) for more information. ## Example -The following sample generates C3397. +The following example generates C3397. ```cpp // C3397.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3398.md b/docs/error-messages/compiler-errors-2/compiler-error-c3398.md index 27441e24516..12e80fd4613 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3398.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3398.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Error C3398" title: "Compiler Error C3398" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3398" +ms.date: 11/04/2016 f1_keywords: ["C3398"] helpviewer_keywords: ["C3398"] -ms.assetid: 26f8c8a4-526f-415b-8047-155c5cd4f180 --- # Compiler Error C3398 -'operator' : cannot convert from 'function_signature' to 'function_pointer'. Source expression must be a function symbol +> 'operator' : cannot convert from 'function_signature' to 'function_pointer'. Source expression must be a function symbol + +## Remarks When the [__clrcall](../../cpp/clrcall.md) calling convention is not specified when compiling with **/clr**, the compiler generates two entry points (addresses) for each function, a native entry point and a managed entry point. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3399.md b/docs/error-messages/compiler-errors-2/compiler-error-c3399.md index 55794507286..dd6950693e9 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3399.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3399.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Error C3399" title: "Compiler Error C3399" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3399" +ms.date: 11/04/2016 f1_keywords: ["C3399"] helpviewer_keywords: ["C3399"] -ms.assetid: 306ad199-d150-4f6c-bcf1-24a7948b93be --- # Compiler Error C3399 -'type' : cannot provide arguments when creating an instance of a generic parameter +> 'type' : cannot provide arguments when creating an instance of a generic parameter + +## Remarks When you specify the `gcnew()` constraint, you specify that the constraint type will have a parameterless constructor. Therefore, it is an error to attempt to instantiate that type and pass a parameter. @@ -16,7 +17,7 @@ See [Constraints on Generic Type Parameters (C++/CLI)](../../extensions/constrai ## Example -The following sample generates C3399. +The following example generates C3399. ```cpp // C3399.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3400.md b/docs/error-messages/compiler-errors-2/compiler-error-c3400.md index df57d95cb79..68f42cc0a03 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3400.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3400.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Error C3400" title: "Compiler Error C3400" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3400" +ms.date: 11/04/2016 f1_keywords: ["C3400"] helpviewer_keywords: ["C3400"] -ms.assetid: d44169a8-73b6-4766-b406-b3a6c93f2a4d --- # Compiler Error C3400 -circular constraint dependency involving 'constraint_1' and 'constraint_2' +> circular constraint dependency involving 'constraint_1' and 'constraint_2' + +## Remarks The compiler detected circular constraints. @@ -16,7 +17,7 @@ For more information, see [Constraints on Generic Type Parameters (C++/CLI)](../ ## Example -The following sample generates C3400. +The following example generates C3400. ```cpp // C3400.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3408.md b/docs/error-messages/compiler-errors-2/compiler-error-c3408.md index 9774072606f..b0239c3bd19 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3408.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3408.md @@ -1,20 +1,21 @@ --- -description: "Learn more about: Compiler Error C3408" title: "Compiler Error C3408" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3408" +ms.date: 11/04/2016 f1_keywords: ["C3408"] helpviewer_keywords: ["C3408"] -ms.assetid: 1f5ea979-fb1e-4214-b310-6fd6ca8249b1 --- # Compiler Error C3408 -'attribute': attribute is not allowed on template definitions +> 'attribute': attribute is not allowed on template definitions + +## Remarks Attributes cannot be applied to template definitions. ## Example -The following sample generates C3408. +The following example generates C3408. ```cpp // C3408.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3409.md b/docs/error-messages/compiler-errors-2/compiler-error-c3409.md index 393e09c5d88..6603ef05435 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3409.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3409.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3409" title: "Compiler Error C3409" -ms.date: "11/06/2018" +description: "Learn more about: Compiler Error C3409" +ms.date: 11/06/2018 f1_keywords: ["C3409"] helpviewer_keywords: ["C3409"] -ms.assetid: e372d9fa-230c-4b28-b6d3-6ad81ccf9dbb --- # Compiler Error C3409 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3412.md b/docs/error-messages/compiler-errors-2/compiler-error-c3412.md index f9aab8f46cd..5209a9eca05 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3412.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3412.md @@ -1,20 +1,21 @@ --- -description: "Learn more about: Compiler Error C3412" title: "Compiler Error C3412" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3412" +ms.date: 11/04/2016 f1_keywords: ["C3412"] helpviewer_keywords: ["C3412"] -ms.assetid: aa4dd43b-54ce-4cda-85c1-1a77dd6e34fa --- # Compiler Error C3412 -'template' : cannot specialize template in current scope +> 'template' : cannot specialize template in current scope + +## Remarks A template cannot be specialized at class scope, only in global or namespace scope. -## Examples +## Example -The following sample generates C3412. +The following example generates C3412. ```cpp // C3412.cpp @@ -25,7 +26,7 @@ struct S { }; ``` -The following sample shows a possible resolution. +The following example shows a possible resolution. ```cpp // C3412b.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3413.md b/docs/error-messages/compiler-errors-2/compiler-error-c3413.md index 6e569181037..d5c4e89b153 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3413.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3413.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C3413" title: "Compiler Error C3413" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3413" +ms.date: 11/04/2016 f1_keywords: ["C3413"] helpviewer_keywords: ["C3413"] -ms.assetid: de6c9b05-c373-4bd8-8cb0-12c2cd2e5674 --- # Compiler Error C3413 -'name' : invalid explicit instantiation +> 'name' : invalid explicit instantiation + +## Remarks The compiler detected an ill-formed explicit instantiation. -The following sample generates C3413: +## Example + +The following example generates C3413: ```cpp // C3413.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3414.md b/docs/error-messages/compiler-errors-2/compiler-error-c3414.md index 44d295535b0..5ff2d2b3ae5 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3414.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3414.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C3414" title: "Compiler Error C3414" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3414" +ms.date: 11/04/2016 f1_keywords: ["C3414"] helpviewer_keywords: ["C3414"] -ms.assetid: 715f5432-b509-4f8f-84f5-e1463bac490f --- # Compiler Error C3414 -'member' : imported member function can't be defined +> 'member' : imported member function can't be defined + +## Remarks A member was defined in code that is also defined in a referenced assembly. -The following sample generates C3414: +## Example + +The following example generates C3414: ```cpp // C3414a2.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3415.md b/docs/error-messages/compiler-errors-2/compiler-error-c3415.md index afda211990f..30450c07d51 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3415.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3415.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Error C3415" title: "Compiler Error C3415" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3415" +ms.date: 11/04/2016 f1_keywords: ["C3415"] helpviewer_keywords: ["C3415"] -ms.assetid: fa2db8ab-2820-4ec3-a740-fb5e2adcfb29 --- # Compiler Error C3415 -multiple 'section_name' sections found with different attributes ('value') +> multiple 'section_name' sections found with different attributes ('value') + +## Remarks Conflicting values were specified in [section](../../preprocessor/section.md) pragmas. @@ -33,7 +34,9 @@ Conflicting values were specified in [section](../../preprocessor/section.md) pr #define IMAGE_SCN_MEM_WRITE 0x80000000 ``` -The following sample generates C3415: +## Example + +The following example generates C3415: ```cpp // C3415.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3417.md b/docs/error-messages/compiler-errors-2/compiler-error-c3417.md index debcd0ffbc3..e7fdaddf9e7 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3417.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3417.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C3417" title: "Compiler Error C3417" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3417" +ms.date: 11/04/2016 f1_keywords: ["C3417"] helpviewer_keywords: ["C3417"] -ms.assetid: 3e7869ea-8948-42fb-ba30-6ccafe499c35 --- # Compiler Error C3417 -'member' : value types cannot contain user-defined special member functions +> 'member' : value types cannot contain user-defined special member functions + +## Remarks Value types cannot contain functions such as a default instance constructor, destructor, or copy constructor. -The following sample generates C3517: +## Example + +The following example generates C3417: ```cpp // C3417.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3418.md b/docs/error-messages/compiler-errors-2/compiler-error-c3418.md index e49e934d0bd..2d7e3ab6a67 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3418.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3418.md @@ -1,20 +1,21 @@ --- -description: "Learn more about: Compiler Error C3418" title: "Compiler Error C3418" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3418" +ms.date: 11/04/2016 f1_keywords: ["C3418"] helpviewer_keywords: ["C3418"] -ms.assetid: 54042c04-3c45-41c1-bad7-90f9ee05a21b --- # Compiler Error C3418 -access specifier 'specifier' is not supported +> access specifier 'specifier' is not supported + +## Remarks A CLR access specifier was specified incorrectly. For more information, see Type visibility and Member visibility in [How to: Define and Consume Classes and Structs (C++/CLI)](../../dotnet/how-to-define-and-consume-classes-and-structs-cpp-cli.md). ## Example -The following sample generates C3418. +The following example generates C3418. ```cpp // C3418.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3420.md b/docs/error-messages/compiler-errors-2/compiler-error-c3420.md index da90a0cbaa3..5ae784e3d77 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3420.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3420.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Error C3420" title: "Compiler Error C3420" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3420" +ms.date: 11/04/2016 f1_keywords: ["C3420"] helpviewer_keywords: ["C3420"] -ms.assetid: 99b53c77-f36b-4574-9199-b53111becccb --- # Compiler Error C3420 -'finalizer' : a finalizer cannot be virtual +> 'finalizer' : a finalizer cannot be virtual + +## Remarks A finalizer can only be called non-virtually from its enclosing type. Therefore, it is an error to declare a virtual finalizer. @@ -16,7 +17,7 @@ For more information, see [Destructors and finalizers in How to: Define and cons ## Example -The following sample generates C3420. +The following example generates C3420. ```cpp // C3420.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3421.md b/docs/error-messages/compiler-errors-2/compiler-error-c3421.md index f80f790e6b6..d3c41e7bdab 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3421.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3421.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Error C3421" title: "Compiler Error C3421" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3421" +ms.date: 11/04/2016 f1_keywords: ["C3421"] helpviewer_keywords: ["C3421"] -ms.assetid: b52050c6-17a4-424a-8894-337b0cec7010 --- # Compiler Error C3421 -'type' : you cannot call the finalizer for this class as it is either inaccessible or it does not exist +> 'type' : you cannot call the finalizer for this class as it is either inaccessible or it does not exist + +## Remarks A finalizer is implicitly private, so it cannot be called from outside its enclosing type. @@ -16,7 +17,7 @@ For more information, see [Destructors and finalizers in How to: Define and cons ## Example -The following sample generates C3421. +The following example generates C3421. ```cpp // C3421.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3445.md b/docs/error-messages/compiler-errors-2/compiler-error-c3445.md index 3fc2bcb631b..7add75b0312 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3445.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3445.md @@ -1,22 +1,23 @@ --- -description: "Learn more about: Compiler Error C3445" title: "Compiler Error C3445" -ms.date: "04/10/2017" +description: "Learn more about: Compiler Error C3445" +ms.date: 04/10/2017 f1_keywords: ["C3445"] helpviewer_keywords: ["C3445"] -ms.assetid: 0d272bfc-136b-4025-a9ba-5e4eea5f8215 --- # Compiler Error C3445 > copy-list-initialization of '*type*' cannot use an explicit constructor +## Remarks + According to the ISO C++17 standard, the compiler is required to consider an explicit constructor for overload resolution in copy-list-initialization, but must raise an error if that overload is actually chosen. Starting in Visual Studio 2017, the compiler finds errors related to object creation by using an initializer list that were not found by Visual Studio 2015. These errors could lead to crashes or undefined behavior at runtime. ## Example -The following sample generates C3445. +The following example generates C3445. ```cpp // C3445.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3446.md b/docs/error-messages/compiler-errors-2/compiler-error-c3446.md index 0a6ae8b11ee..46fe4603c2f 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3446.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3446.md @@ -1,20 +1,21 @@ --- -description: "Learn more about: Compiler Error C3446" title: "Compiler Error C3446" -ms.date: "07/21/2017" +description: "Learn more about: Compiler Error C3446" +ms.date: 07/21/2017 f1_keywords: ["C3446"] helpviewer_keywords: ["C3446"] -ms.assetid: 33064548-24e4-46f1-beb1-476e3c3b3fbf --- # Compiler Error C3446 ->'*class*': a default member initializer is not allowed for a member of a value class +> '*class*': a default member initializer is not allowed for a member of a value class + +## Remarks In Visual Studio 2015 and earlier, the compiler permitted (but ignored) a default member initializer for a member of a value class. Default initialization of a value class always zero-initializes the members; a default constructor is not permitted. In Visual Studio 2017, default member initializers raise a compiler error, as shown in this example: ## Example -The following sample generates C3446 in Visual Studio 2017 and later: +The following example generates C3446 in Visual Studio 2017 and later: ```cpp // C3446.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3450.md b/docs/error-messages/compiler-errors-2/compiler-error-c3450.md index ffdbc286a20..1b8c1d6bf6f 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3450.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3450.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Error C3450" title: "Compiler Error C3450" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3450" +ms.date: 11/04/2016 f1_keywords: ["C3450"] helpviewer_keywords: ["C3450"] -ms.assetid: 78892cf7-0b82-4589-90d0-e06666247003 --- # Compiler Error C3450 -'type': not an attribute; cannot specify [System::AttributeUsageAttribute] or [Windows::Foundation::Metadata::AttributeUsageAttribute] +> 'type': not an attribute; cannot specify [System::AttributeUsageAttribute] or [Windows::Foundation::Metadata::AttributeUsageAttribute] + +## Remarks A user-defined managed attribute must inherit from . A Windows Runtime attribute must be defined in the `Windows::Foundation::Metadata` namespace. @@ -16,7 +17,7 @@ For more information, see [User-Defined Attributes](../../extensions/user-define ## Example -The following sample generates C3450 and shows how to fix it. +The following example generates C3450 and shows how to fix it. ```cpp // C3450.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3451.md b/docs/error-messages/compiler-errors-2/compiler-error-c3451.md index 6e7e9dbe75e..17b42bf6a51 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3451.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3451.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Error C3451" title: "Compiler Error C3451" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3451" +ms.date: 11/04/2016 f1_keywords: ["C3451"] helpviewer_keywords: ["C3451"] -ms.assetid: a4897a69-e3e7-40bb-bb1c-598644904012 --- # Compiler Error C3451 -'attribute': cannot apply unmanaged attribute to 'type' +> 'attribute': cannot apply unmanaged attribute to 'type' + +## Remarks A C++ attribute cannot be applied to a CLR type. See [C++ Attributes Reference](../../windows/attributes/attributes-alphabetical-reference.md) for more information. @@ -18,7 +19,7 @@ This error can be generated as a result of compiler conformance work that was do ## Example -The following sample generates C3451. +The following example generates C3451. ```cpp // C3451.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3452.md b/docs/error-messages/compiler-errors-2/compiler-error-c3452.md index b40ab656fc2..4a112bc3935 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3452.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3452.md @@ -1,20 +1,21 @@ --- -description: "Learn more about: Compiler Error C3452" title: "Compiler Error C3452" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3452" +ms.date: 11/04/2016 f1_keywords: ["C3452"] helpviewer_keywords: ["C3452"] -ms.assetid: e5293dcf-cb70-4133-ae2a-0bb496950ba0 --- # Compiler Error C3452 -list argument member not constant +> list argument member not constant + +## Remarks An argument was passed to an attribute that expected a constant, a value that can be evaluated at compile time. ## Example -The following sample generates C3452. +The following example generates C3452. ```cpp // C3452.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3453.md b/docs/error-messages/compiler-errors-2/compiler-error-c3453.md index edd640d730a..d04287ade5b 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3453.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3453.md @@ -1,20 +1,21 @@ --- -description: "Learn more about: Compiler Error C3453" title: "Compiler Error C3453" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3453" +ms.date: 11/04/2016 f1_keywords: ["C3453"] helpviewer_keywords: ["C3453"] -ms.assetid: dbefdbcf-f697-4239-b7a5-1d99b85e9e7f --- # Compiler Error C3453 -'attribute': attribute not applied because qualifier 'assembly' did not match +> 'attribute': attribute not applied because qualifier 'assembly' did not match + +## Remarks Assembly or module level attributes can only be specified as stand-alone instructions. ## Example -The following sample generates C3453. +The following example generates C3453. ```cpp // C3453.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3454.md b/docs/error-messages/compiler-errors-2/compiler-error-c3454.md index f051c32753f..c7034d16637 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3454.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3454.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Error C3454" title: "Compiler Error C3454" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3454" +ms.date: 11/04/2016 f1_keywords: ["C3454"] helpviewer_keywords: ["C3454"] -ms.assetid: dc4e6d57-5b4d-4114-8d6f-22f9ae62925b --- # Compiler Error C3454 -[attribute] not allowed on class declaration +> [attribute] not allowed on class declaration + +## Remarks A class must be defined for it to be an attribute. @@ -16,7 +17,7 @@ For more information, see [attribute](../../windows/attributes/attribute.md). ## Example -The following sample generates C3454. +The following example generates C3454. ```cpp // C3454.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3455.md b/docs/error-messages/compiler-errors-2/compiler-error-c3455.md index f32ad44b44c..5cdd85744c9 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3455.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3455.md @@ -1,20 +1,21 @@ --- -description: "Learn more about: Compiler Error C3455" title: "Compiler Error C3455" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3455" +ms.date: 11/04/2016 f1_keywords: ["C3455"] helpviewer_keywords: ["C3455"] -ms.assetid: 218e5cfe-5391-4eeb-81c2-85c47e3a6cd2 --- # Compiler Error C3455 -'attribute': none of the attribute constructors matched the arguments +> 'attribute': none of the attribute constructors matched the arguments + +## Remarks An invalid value was used to declare an attribute. See [attribute](../../windows/attributes/attribute.md) for more information. ## Example -The following sample generates C3455. +The following example generates C3455. ```cpp // C3455.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3456.md b/docs/error-messages/compiler-errors-2/compiler-error-c3456.md index 73d326827fd..996bf27c057 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3456.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3456.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Error C3456" title: "Compiler Error C3456" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3456" +ms.date: 11/04/2016 f1_keywords: ["C3456"] helpviewer_keywords: ["C3456"] -ms.assetid: 9f781919-aaf2-4725-94a4-44a0b80cc64a --- # Compiler Error C3456 -[source_annotation_attribute] not allowed on managed or WinRT class declaration +> [source_annotation_attribute] not allowed on managed or WinRT class declaration + +## Remarks source_annotation_attribute is used to define custom attributes to be used by code analysis. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3457.md b/docs/error-messages/compiler-errors-2/compiler-error-c3457.md index 151c01319fe..dc7ffe0c88b 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3457.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3457.md @@ -1,22 +1,23 @@ --- -description: "Learn more about: Compiler Error C3457" title: "Compiler Error C3457" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3457" +ms.date: 11/04/2016 f1_keywords: ["C3457"] helpviewer_keywords: ["C3457"] -ms.assetid: 5c1e366a-fa75-4cca-b9a3-86d4ebe4090e --- # Compiler Error C3457 -'attribute': attribute does not support unnamed arguments +> 'attribute': attribute does not support unnamed arguments + +## Remarks Source annotation attributes, unlike CLR custom attribute or compiler attributes, only support named arguments. ## Example -The following sample generates C3457. +The following example generates C3457. -``` +```cpp #include "SourceAnnotations.h" [vc_attributes::Post( 1 )] int f(); // C3457 [vc_attributes::Post( Valid=vc_attributes::Yes )] int f2(); // OK diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3458.md b/docs/error-messages/compiler-errors-2/compiler-error-c3458.md index 345783c0e18..a6d8238079d 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3458.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3458.md @@ -1,20 +1,21 @@ --- -description: "Learn more about: Compiler Error C3458" title: "Compiler Error C3458" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3458" +ms.date: 11/04/2016 f1_keywords: ["C3458"] helpviewer_keywords: ["C3458"] -ms.assetid: 940202fd-8dcc-4042-9c96-3f9e9127d2f1 --- # Compiler Error C3458 -'attribute1': attribute 'attribute2' already specified for 'construct' +> 'attribute1': attribute 'attribute2' already specified for 'construct' + +## Remarks Two attributes that are mutually exclusive were specified for the same construct. ## Example -The following sample generates C3458 +The following example generates C3458 ```cpp // C3458.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3459.md b/docs/error-messages/compiler-errors-2/compiler-error-c3459.md index 98298a38e28..4c8ad60d6f9 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3459.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3459.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Error C3459" title: "Compiler Error C3459" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3459" +ms.date: 11/04/2016 f1_keywords: ["C3459"] helpviewer_keywords: ["C3459"] -ms.assetid: 3d290a20-d313-4c07-9bd8-c5c159cb169f --- # Compiler Error C3459 -'attribute': attribute allowed only on class indexer (default indexed property) +> 'attribute': attribute allowed only on class indexer (default indexed property) + +## Remarks An attribute that is designed to be applied to a class indexer property was used incorrectly. @@ -16,7 +17,7 @@ For more information, see [How to: Use Properties in C++/CLI](../../dotnet/how-t ## Example -The following sample generates C3459. +The following example generates C3459. ```cpp // C3459.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3460.md b/docs/error-messages/compiler-errors-2/compiler-error-c3460.md index 58c67af4f7f..e002f487f9e 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3460.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3460.md @@ -1,20 +1,21 @@ --- -description: "Learn more about: Compiler Error C3460" title: "Compiler Error C3460" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3460" +ms.date: 11/04/2016 f1_keywords: ["C3460"] helpviewer_keywords: ["C3460"] -ms.assetid: adbf8775-10ca-4654-acdf-58dd765351cd --- # Compiler Error C3460 -'type': only a user-defined type can be forwarded +> 'type': only a user-defined type can be forwarded + +## Remarks For more information, see [Type Forwarding (C++/CLI)](../../extensions/type-forwarding-cpp-cli.md). -## Examples +## Example -The following sample creates a component. +The following example creates a component. ```cpp // C3460.cpp @@ -22,7 +23,7 @@ The following sample creates a component. public ref class R {}; ``` -The following sample generates C3460. +The following example generates C3460. ```cpp // C3460_b.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3461.md b/docs/error-messages/compiler-errors-2/compiler-error-c3461.md index 4c45c0a6eac..9c801ba167e 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3461.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3461.md @@ -1,22 +1,23 @@ --- -description: "Learn more about: Compiler Error C3461" title: "Compiler Error C3461" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3461" +ms.date: 11/04/2016 f1_keywords: ["C3461"] helpviewer_keywords: ["C3461"] -ms.assetid: bd66833a-545d-445a-bdfe-dee771a450a4 --- # Compiler Error C3461 -'type': only a managed type can be forwarded +> 'type': only a managed type can be forwarded + +## Remarks Type forwarding can only occur on CLR types. See [Classes and Structs](../../extensions/classes-and-structs-cpp-component-extensions.md) for more information. For more information, see [Type Forwarding (C++/CLI)](../../extensions/type-forwarding-cpp-cli.md). -## Examples +## Example -The following sample creates a component. +The following example creates a component. ```cpp // C3461.cpp @@ -24,7 +25,7 @@ The following sample creates a component. public ref class R {}; ``` -The following sample generates C3461. +The following example generates C3461. ```cpp // C3461b.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3462.md b/docs/error-messages/compiler-errors-2/compiler-error-c3462.md index 1711df90e85..1c48adb2f45 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3462.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3462.md @@ -1,22 +1,23 @@ --- -description: "Learn more about: Compiler Error C3462" title: "Compiler Error C3462" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3462" +ms.date: 11/04/2016 f1_keywords: ["C3462"] helpviewer_keywords: ["C3462"] -ms.assetid: 56b75f35-9fad-42d9-a969-eeca5d709bec --- # Compiler Error C3462 -'type': only an imported type can be forwarded +> 'type': only an imported type can be forwarded + +## Remarks The TypeForwardedTo attribute must be applied to a type in referenced metadata. For more information, see [Type Forwarding (C++/CLI)](../../extensions/type-forwarding-cpp-cli.md). -## Examples +## Example -The following sample creates a component. +The following example creates a component. ```cpp // C3462.cpp @@ -24,7 +25,7 @@ The following sample creates a component. public ref class R {}; ``` -The following sample generates C3462. +The following example generates C3462. ```cpp // C3462b.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3463.md b/docs/error-messages/compiler-errors-2/compiler-error-c3463.md index 96fbcf90c51..e2b9d5fff23 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3463.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3463.md @@ -1,20 +1,21 @@ --- -description: "Learn more about: Compiler Error C3463" title: "Compiler Error C3463" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3463" +ms.date: 11/04/2016 f1_keywords: ["C3463"] helpviewer_keywords: ["C3463"] -ms.assetid: 153efcc0-085c-4615-84ea-d22942618bdf --- # Compiler Error C3463 -'type': type not allowed in attribute 'implements' +> 'type': type not allowed in attribute 'implements' + +## Remarks An invalid type was passed to the [implements](../../windows/attributes/implements-cpp.md) attribute. For example, you can pass an interface to `implements`, but you cannot pass a pointer to an interface. ## Example -The following sample generates C3463. +The following example generates C3463. ```cpp // C3463.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3464.md b/docs/error-messages/compiler-errors-2/compiler-error-c3464.md index 4def91d2596..684c143ea61 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3464.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3464.md @@ -1,22 +1,23 @@ --- -description: "Learn more about: Compiler Error C3464" title: "Compiler Error C3464" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3464" +ms.date: 11/04/2016 f1_keywords: ["C3464"] helpviewer_keywords: ["C3464"] -ms.assetid: 0ede05dc-4486-4921-8e8c-78ab5a2e09c5 --- # Compiler Error C3464 -'type' a nested type cannot be forwarded +> 'type' a nested type cannot be forwarded + +## Remarks Type forwarding does not work on nested types. For more information, see [Type Forwarding (C++/CLI)](../../extensions/type-forwarding-cpp-cli.md). -## Examples +## Example -The following sample creates a component. +The following example creates a component. ```cpp // C3464.cpp @@ -27,7 +28,7 @@ public: }; ``` -The following sample generates C3464. +The following example generates C3464. ```cpp // C3464_b.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3465.md b/docs/error-messages/compiler-errors-2/compiler-error-c3465.md index 453ced5d660..b49fc9e1f2e 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3465.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3465.md @@ -1,22 +1,23 @@ --- -description: "Learn more about: Compiler Error C3465" title: "Compiler Error C3465" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3465" +ms.date: 11/04/2016 f1_keywords: ["C3465"] helpviewer_keywords: ["C3465"] -ms.assetid: aeb815e5-b3fc-4525-afe2-d738e9321df1 --- # Compiler Error C3465 -to use type 'type' you must reference the assembly 'assembly' +> to use type 'type' you must reference the assembly 'assembly' + +## Remarks Type forwarding will work for a client application until you recompile the client. When you recompile, you will need a reference for every assembly containing the definition of a type used in your client application. For more information, see [Type Forwarding (C++/CLI)](../../extensions/type-forwarding-cpp-cli.md). -## Examples +## Example -The following sample builds an assembly that contains the new location of a type. +The following example builds an assembly that contains the new location of a type. ```cpp // C3465.cpp @@ -27,7 +28,7 @@ public: }; ``` -The following sample builds an assembly that used to contain the definition of the type, but now contains forwarding syntax for the type. +The following example builds an assembly that used to contain the definition of the type, but now contains forwarding syntax for the type. ```cpp // C3465_b.cpp @@ -36,7 +37,7 @@ The following sample builds an assembly that used to contain the definition of t [ assembly:TypeForwardedTo(R::typeid) ]; ``` -The following sample generates C3465. +The following example generates C3465. ```cpp // C3465_c.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3466.md b/docs/error-messages/compiler-errors-2/compiler-error-c3466.md index 2f1b223aa91..9183287145d 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3466.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3466.md @@ -1,22 +1,23 @@ --- -description: "Learn more about: Compiler Error C3466" title: "Compiler Error C3466" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3466" +ms.date: 11/04/2016 f1_keywords: ["C3466"] helpviewer_keywords: ["C3466"] -ms.assetid: 69a877d9-a749-474b-bfc3-8d3fd53ba8fd --- # Compiler Error C3466 -'type' : a specialization of a generic class cannot be forwarded +> 'type' : a specialization of a generic class cannot be forwarded + +## Remarks You cannot use type forwarding on a specialization of a generic class. For more information, see [Type Forwarding (C++/CLI)](../../extensions/type-forwarding-cpp-cli.md). -## Examples +## Example -The following sample creates a component. +The following example creates a component. ```cpp // C3466.cpp @@ -27,7 +28,7 @@ public ref class GR {}; public ref class GR2 {}; ``` -The following sample generates C3466. +The following example generates C3466. ```cpp // C3466_b.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3467.md b/docs/error-messages/compiler-errors-2/compiler-error-c3467.md index 05af0ad696d..4b253247f2d 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3467.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3467.md @@ -1,22 +1,23 @@ --- -description: "Learn more about: Compiler Error C3467" title: "Compiler Error C3467" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3467" +ms.date: 11/04/2016 f1_keywords: ["C3467"] helpviewer_keywords: ["C3467"] -ms.assetid: e2b844d0-4920-412f-99fd-cd8051c4aa41 --- # Compiler Error C3467 -'type' : this type has already been forwarded +> 'type' : this type has already been forwarded + +## Remarks The compiler found more than one forward type declaration for the same type. Only one declaration per type is allowed. For more information, see [Type Forwarding (C++/CLI)](../../extensions/type-forwarding-cpp-cli.md). -## Examples +## Example -The following sample creates a component. +The following example creates a component. ```cpp // C3467.cpp @@ -24,7 +25,7 @@ The following sample creates a component. public ref class R {}; ``` -The following sample generates C3467. +The following example generates C3467. ```cpp // C3467_b.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3468.md b/docs/error-messages/compiler-errors-2/compiler-error-c3468.md index 62e82fd9136..e101a28857d 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3468.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3468.md @@ -1,24 +1,23 @@ --- -description: "Learn more about: Compiler Error C3468" title: "Compiler Error C3468" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3468" +ms.date: 11/04/2016 f1_keywords: ["C3468"] helpviewer_keywords: ["C3468"] -ms.assetid: cfd320db-2f6e-4e0d-ba02-e79ece87e1e0 --- # Compiler Error C3468 -'type' : you can only forward a type to an assembly: +> '*type*': you can only forward a type to an assembly: '*identifier*' is not an assembly -'`file`' is not an assembly +## Remarks Only types in an assembly can be forwarded. For more information, see [Type Forwarding (C++/CLI)](../../extensions/type-forwarding-cpp-cli.md). -## Examples +## Example -The following sample creates a module. +The following example creates a module. ```cpp // C3468.cpp @@ -26,7 +25,7 @@ The following sample creates a module. public ref class R {}; ``` -The following sample generates C3468. +The following example generates C3468. ```cpp // C3468_b.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3469.md b/docs/error-messages/compiler-errors-2/compiler-error-c3469.md index e45fb32a382..e835ecfbecf 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3469.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3469.md @@ -1,22 +1,23 @@ --- -description: "Learn more about: Compiler Error C3469" title: "Compiler Error C3469" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3469" +ms.date: 11/04/2016 f1_keywords: ["C3469"] helpviewer_keywords: ["C3469"] -ms.assetid: e23b0e5c-c704-4e67-a868-bf02c2055d85 --- # Compiler Error C3469 -'type' : a generic class cannot be forwarded +> 'type' : a generic class cannot be forwarded + +## Remarks You cannot use type forwarding on a generic class. For more information, see [Type Forwarding (C++/CLI)](../../extensions/type-forwarding-cpp-cli.md). -## Examples +## Example -The following sample creates a component. +The following example creates a component. ```cpp // C3469.cpp @@ -27,7 +28,7 @@ public ref class GR {}; public ref class GR2 {}; ``` -The following sample generates C3466. +The following example generates C3469. ```cpp // C3469_b.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3470.md b/docs/error-messages/compiler-errors-2/compiler-error-c3470.md index a487c4e889b..ebbbfbe2096 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3470.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3470.md @@ -1,20 +1,21 @@ --- -description: "Learn more about: Compiler Error C3470" title: "Compiler Error C3470" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3470" +ms.date: 11/04/2016 f1_keywords: ["C3470"] helpviewer_keywords: ["C3470"] -ms.assetid: 170c7a9d-214d-41b1-8f15-d4a4fc38aaa5 --- # Compiler Error C3470 -'type' : a class cannot have both an indexer (default indexed property) and an operator[] +> 'type' : a class cannot have both an indexer (default indexed property) and an operator[] + +## Remarks A type cannot define both a default indexer and an operator[]. ## Example -The following sample generates C3470 +The following example generates C3470 ```cpp // C3470.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3480.md b/docs/error-messages/compiler-errors-2/compiler-error-c3480.md index 261faca8ab3..a032ea4e1b8 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3480.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3480.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Error C3480" title: "Compiler Error C3480" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3480" +ms.date: 11/04/2016 f1_keywords: ["C3480"] helpviewer_keywords: ["C3480"] -ms.assetid: 7b2e055a-9604-4d13-861b-b38bda1a6940 --- # Compiler Error C3480 -'var': a lambda capture variable must be from an enclosing function scope +> 'var': a lambda capture variable must be from an enclosing function scope + +## Remarks The lambda capture variable is not from an enclosing function scope. @@ -16,7 +17,7 @@ The lambda capture variable is not from an enclosing function scope. - Remove the variable from the capture list of the lambda expression. -## Examples +## Example The following example generates C3480 because the variable `global` is not from an enclosing function scope: diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3481.md b/docs/error-messages/compiler-errors-2/compiler-error-c3481.md index 775cbc06826..7e07537f533 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3481.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3481.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Error C3481" title: "Compiler Error C3481" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3481" +ms.date: 11/04/2016 f1_keywords: ["C3481"] helpviewer_keywords: ["C3481"] -ms.assetid: 5d09375a-5ed3-4b61-86ed-45e91fd734c7 --- # Compiler Error C3481 -'var': lambda capture variable not found +> 'var': lambda capture variable not found + +## Remarks The compiler could not find the definition of a variable that you passed to the capture list of a lambda expression. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3482.md b/docs/error-messages/compiler-errors-2/compiler-error-c3482.md index 8e471aea04c..3b396c9bedc 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3482.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3482.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Error C3482" title: "Compiler Error C3482" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3482" +ms.date: 11/04/2016 f1_keywords: ["C3482"] helpviewer_keywords: ["C3482"] -ms.assetid: bf99558e-bef4-421c-bb16-dcd9c54c1011 --- # Compiler Error C3482 -'this' can only be used as a lambda capture within a non-static member function +> 'this' can only be used as a lambda capture within a non-static member function + +## Remarks You cannot pass **`this`** to the capture list of a lambda expression that is declared in a static method or a global function. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3483.md b/docs/error-messages/compiler-errors-2/compiler-error-c3483.md index 0664764558f..2fee0c0075b 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3483.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3483.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Error C3483" title: "Compiler Error C3483" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3483" +ms.date: 11/04/2016 f1_keywords: ["C3483"] helpviewer_keywords: ["C3483"] -ms.assetid: 18b3a2c5-dfc9-4661-9653-08a5798474cf --- # Compiler Error C3483 -'var' is already part of the lambda capture list +> 'var' is already part of the lambda capture list + +## Remarks You passed the same variable to the capture list of a lambda expression more than one time. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3484.md b/docs/error-messages/compiler-errors-2/compiler-error-c3484.md index 43a0e771a38..1da53a08ba9 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3484.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3484.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Error C3484" title: "Compiler Error C3484" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3484" +ms.date: 11/04/2016 f1_keywords: ["C3484"] helpviewer_keywords: ["C3484"] -ms.assetid: 2fe847fa-f6ee-4978-bc1d-b6dc6ae906ac --- # Compiler Error C3484 -expected '->' before the return type +> expected '->' before the return type + +## Remarks You must provide `->` before the return type of a lambda expression. @@ -16,7 +17,7 @@ You must provide `->` before the return type of a lambda expression. - Provide `->` before the return type. -## Examples +## Example The following example generates C3484: diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3485.md b/docs/error-messages/compiler-errors-2/compiler-error-c3485.md index f1a62610292..30fa2541210 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3485.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3485.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3485" title: "Compiler Error C3485" +description: "Learn more about: Compiler Error C3485" ms.date: 06/01/2022 f1_keywords: ["C3485"] helpviewer_keywords: ["C3485"] -ms.assetid: d67536f9-67a1-4ad9-9a94-d8bbbca3d0dc --- # Compiler Error C3485 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3487.md b/docs/error-messages/compiler-errors-2/compiler-error-c3487.md index 6af8420b559..7a34600a5aa 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3487.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3487.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Error C3487" title: "Compiler Error C3487" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3487" +ms.date: 11/04/2016 f1_keywords: ["C3487"] helpviewer_keywords: ["C3487"] -ms.assetid: 39bda474-4418-4a79-98bf-2b22fa92eaaa --- # Compiler Error C3487 -'return type': all return expressions must deduce to the same type: previously it was 'return type' +> 'return type': all return expressions must deduce to the same type: previously it was 'return type' + +## Remarks A lambda must specify its return type unless it contains a single return statement. If a lambda contains multiple return statements, they must all have the same type. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3488.md b/docs/error-messages/compiler-errors-2/compiler-error-c3488.md index 7a38d4c1158..407a19b00e1 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3488.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3488.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Error C3488" title: "Compiler Error C3488" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3488" +ms.date: 11/04/2016 f1_keywords: ["C3488"] helpviewer_keywords: ["C3488"] -ms.assetid: 0a6fcd76-dd3b-48d7-abb3-22eccda96034 --- # Compiler Error C3488 -'var' is not allowed when the default capture mode is by-reference +> 'var' is not allowed when the default capture mode is by-reference + +## Remarks When you specify that the default capture mode for a lambda expression is by-reference, you cannot pass a variable by reference to the capture clause of that expression. @@ -22,7 +23,7 @@ When you specify that the default capture mode for a lambda expression is by-ref - Pass the variable by value to the capture clause. (This might change the behavior of the lambda expression.) -## Examples +## Example The following example generates C3488 because a reference to the variable `n` appears in the capture clause of a lambda expression whose default mode is by-reference: diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3489.md b/docs/error-messages/compiler-errors-2/compiler-error-c3489.md index fbd175529d6..3aa45bc46d6 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3489.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3489.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Error C3489" title: "Compiler Error C3489" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3489" +ms.date: 11/04/2016 f1_keywords: ["C3489"] helpviewer_keywords: ["C3489"] -ms.assetid: 47b58d69-459d-4499-abc7-5f0b9303d773 --- # Compiler Error C3489 -'var' is required when the default capture mode is by-value +> 'var' is required when the default capture mode is by-value + +## Remarks When you specify that the default capture mode for a lambda expression is by-value, you cannot pass a variable by value to the capture clause of that expression. @@ -22,7 +23,7 @@ When you specify that the default capture mode for a lambda expression is by-val - Pass the variable by reference to the capture clause. (This might change the behavior of the lambda expression.) -## Examples +## Example The following example generates C3489 variable `n` appears by value in the capture clause of a lambda expression whose default mode is by-value: diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3490.md b/docs/error-messages/compiler-errors-2/compiler-error-c3490.md index 55fda1bfc02..191d54b3881 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3490.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3490.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Error C3490" title: "Compiler Error C3490" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3490" +ms.date: 11/04/2016 f1_keywords: ["C3490"] helpviewer_keywords: ["C3490"] -ms.assetid: 7638559a-fd06-4527-a9c1-0c8ae68b3123 --- # Compiler Error C3490 -'var' cannot be modified because it is being accessed through a const object +> 'var' cannot be modified because it is being accessed through a const object + +## Remarks A lambda expression that is declared in a **`const`** method cannot modify non-mutable member data. @@ -16,7 +17,7 @@ A lambda expression that is declared in a **`const`** method cannot modify non-m - Remove the **`const`** modifier from your method declaration. -## Examples +## Example The following example generates C3490 because it modifies the member variable `_i` in a **`const`** method: diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3491.md b/docs/error-messages/compiler-errors-2/compiler-error-c3491.md index f941d825ccb..4183526cc84 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3491.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3491.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Error C3491" title: "Compiler Error C3491" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3491" +ms.date: 11/04/2016 f1_keywords: ["C3491"] helpviewer_keywords: ["C3491"] -ms.assetid: 7f0e71b2-46a0-4d25-bd09-6158a280f509 --- # Compiler Error C3491 -'var': a by-value capture cannot be modified in a non-mutable lambda +> 'var': a by-value capture cannot be modified in a non-mutable lambda + +## Remarks A non-mutable lambda expression cannot modify the value of a variable that is captured by value. @@ -18,7 +19,7 @@ A non-mutable lambda expression cannot modify the value of a variable that is ca - Pass the variable by reference to the capture list of the lambda expression. -## Examples +## Example The following example generates C3491 because the body of a non-mutable lambda expression modifies the capture variable `m`: diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3492.md b/docs/error-messages/compiler-errors-2/compiler-error-c3492.md index 3883b98b062..6993760f29a 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3492.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3492.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Error C3492" title: "Compiler Error C3492" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3492" +ms.date: 11/04/2016 f1_keywords: ["C3492"] helpviewer_keywords: ["C3492"] -ms.assetid: b1dc6342-9133-4b1f-a9c3-e8c65d20d121 --- # Compiler Error C3492 -'var': you cannot capture a member of an anonymous union +> 'var': you cannot capture a member of an anonymous union + +## Remarks You cannot capture a member of an unnamed union. @@ -16,7 +17,7 @@ You cannot capture a member of an unnamed union. - Give the union a name and pass the complete union structure to the capture list of the lambda expression. -## Examples +## Example The following example generates C3492 because it captures a member of an anonymous union: diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3493.md b/docs/error-messages/compiler-errors-2/compiler-error-c3493.md index f711ca6cabf..6101fd828c6 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3493.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3493.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Error C3493" title: "Compiler Error C3493" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3493" +ms.date: 11/04/2016 f1_keywords: ["C3493"] helpviewer_keywords: ["C3493"] -ms.assetid: 734b4257-12a3-436f-8488-c8c55ec81634 --- # Compiler Error C3493 -'var' cannot be implicitly captured because no default capture mode has been specified +> 'var' cannot be implicitly captured because no default capture mode has been specified + +## Remarks The empty lambda expression capture, `[]`, specifies that the lambda expression does not explicitly or implicitly capture any variables. @@ -18,7 +19,7 @@ The empty lambda expression capture, `[]`, specifies that the lambda expression - Explicitly capture one or more variables. -## Examples +## Example The following example generates C3493 because it modifies an external variable but specifies the empty capture clause: diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3495.md b/docs/error-messages/compiler-errors-2/compiler-error-c3495.md index 361a6225925..be74c020b84 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3495.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3495.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Error C3495" title: "Compiler Error C3495" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3495" +ms.date: 11/04/2016 f1_keywords: ["C3495"] helpviewer_keywords: ["C3495"] -ms.assetid: 1fd40cb8-8373-403d-b8a8-f08424a50807 --- # Compiler Error C3495 -'var': a lambda capture must have automatic storage duration +> 'var': a lambda capture must have automatic storage duration + +## Remarks You cannot capture a variable that does not have automatic storage duration, such as a variable that is marked **`static`** or **`extern`**. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3496.md b/docs/error-messages/compiler-errors-2/compiler-error-c3496.md index b766b396aff..b859690dd96 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3496.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3496.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Error C3496" title: "Compiler Error C3496" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3496" +ms.date: 11/04/2016 f1_keywords: ["C3496"] helpviewer_keywords: ["C3496"] -ms.assetid: e19885f2-677f-4c1e-bc69-e35852262dc3 --- # Compiler Error C3496 -'this' is always captured by value: '&' ignored +> 'this' is always captured by value: '&' ignored + +## Remarks You cannot capture the **`this`** pointer by reference. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3498.md b/docs/error-messages/compiler-errors-2/compiler-error-c3498.md index 353b893e20b..71ba1c6542b 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3498.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3498.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Error C3498" title: "Compiler Error C3498" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3498" +ms.date: 11/04/2016 f1_keywords: ["C3498"] helpviewer_keywords: ["C3498"] -ms.assetid: 0a5a7817-0872-4119-83bf-980a19113374 --- # Compiler Error C3498 -'var': you cannot capture a variable that has a managed or WinRTtype +> 'var': you cannot capture a variable that has a managed or WinRTtype + +## Remarks You cannot capture a variable that has a managed type or a Windows Runtime type in a lambda. @@ -16,7 +17,7 @@ You cannot capture a variable that has a managed type or a Windows Runtime type - Pass the managed or Windows Runtime variable to the parameter list of the lambda expression. -## Examples +## Example The following example generates C3498 because a variable that has a managed type appears in the capture list of a lambda expression: diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3499.md b/docs/error-messages/compiler-errors-2/compiler-error-c3499.md index 0004f9b25bc..390975bf586 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3499.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3499.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Error C3499" title: "Compiler Error C3499" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3499" +ms.date: 11/04/2016 f1_keywords: ["C3499"] helpviewer_keywords: ["C3499"] -ms.assetid: 6717de5c-ae0f-4024-bdf2-b5598009e7b6 --- # Compiler Error C3499 -a lambda that has been specified to have a void return type cannot return a value +> a lambda that has been specified to have a void return type cannot return a value + +## Remarks The compiler generates this error when a lambda expression that specifies **`void`** as the return type returns a value; or when a lambda expression contains more than one statement and returns a value, but does not specify its return type. @@ -20,7 +21,7 @@ The compiler generates this error when a lambda expression that specifies **`voi - Combine the statements that make up the body of the lambda expression into a single statement. -## Examples +## Example The following example generates C3499 because the body of a lambda expression contains multiple statements and returns a value, but the lambda expression does not specify the return type: diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3500.md b/docs/error-messages/compiler-errors-2/compiler-error-c3500.md index 7498428d7d6..7de809c495b 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3500.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3500.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Compiler Error C3500" title: "Compiler Error C3500" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3500" +ms.date: 11/04/2016 f1_keywords: ["C3500"] helpviewer_keywords: ["C3500"] -ms.assetid: 77336f16-04f5-4943-bfc0-faba4cd8bb51 --- # Compiler Error C3500 -invalid ProgID 'progid' +> invalid ProgID 'progid' + +## Remarks An invalid progid was specified with the `#import` statement. Check the Windows registry to ensure that you are specifying a valid progid. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3501.md b/docs/error-messages/compiler-errors-2/compiler-error-c3501.md index 87053046e34..980a2f5a0bb 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3501.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3501.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Compiler Error C3501" title: "Compiler Error C3501" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3501" +ms.date: 11/04/2016 f1_keywords: ["C3501"] helpviewer_keywords: ["C3501"] -ms.assetid: cad69fab-2687-41ac-961f-25dc4c51b167 --- # Compiler Error C3501 -there is no typelib registered for ProgID 'progid' +> there is no typelib registered for ProgID 'progid' + +## Remarks The class ID for a given progid does not have an associated type library. Therefore, you cannot pass this progid to the `#import` statement. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3505.md b/docs/error-messages/compiler-errors-2/compiler-error-c3505.md index f3d6d67d2c2..c383d2d03e1 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3505.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3505.md @@ -1,15 +1,16 @@ --- -description: "Learn more about: Compiler Error C3505" title: "Compiler Error C3505" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3505" +ms.date: 11/04/2016 f1_keywords: ["C3505"] helpviewer_keywords: ["C3505"] -ms.assetid: ed73c99e-93a1-4f3a-bac7-ba7ed5d836e4 --- # Compiler Error C3505 > cannot load type library '*guid*' +## Remarks + C3505 can be caused if you are running the 32-bit, x86-hosted cross-compiler for 64-bit, x64 targets on a 64-bit machine, because the compiler is running under WOW64 and can only read from the 32-bit registry hive. You can resolve this error by building both 32-bit and 64-bit versions of the type library you are trying to import, and then register them both. Or you can use the native 64-bit compiler, which requires you to change your **VC++ Directories** property in the IDE to point to the 64-bit compiler. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3506.md b/docs/error-messages/compiler-errors-2/compiler-error-c3506.md index 9ff1a9b7fda..8a2a8d3b71c 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3506.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3506.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Compiler Error C3506" title: "Compiler Error C3506" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3506" +ms.date: 11/04/2016 f1_keywords: ["C3506"] helpviewer_keywords: ["C3506"] -ms.assetid: d382c067-5fad-42ca-acf3-9e6d8cbdb2c5 --- # Compiler Error C3506 -there is no typelib registered for LIBID 'id' +> there is no typelib registered for LIBID 'id' + +## Remarks A typelib was not registered correctly. Use regsvr32.exe to register a type library. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3507.md b/docs/error-messages/compiler-errors-2/compiler-error-c3507.md index e28427a5e8b..ed79db7afe0 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3507.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3507.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C3507" title: "Compiler Error C3507" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3507" +ms.date: 11/04/2016 f1_keywords: ["C3507"] helpviewer_keywords: ["C3507"] -ms.assetid: 75f89767-f6f9-40f6-9820-81a49e09abdf --- # Compiler Error C3507 -a ProgID can have no more than 39 characters 'id'; nor contain any punctuation apart from '.'; nor start with a digit +> a ProgID can have no more than 39 characters 'id'; nor contain any punctuation apart from '.'; nor start with a digit + +## Remarks The [progid](../../windows/attributes/progid.md) attribute has restrictions on the values that it can take. -The following sample generates C3507: +## Example + +The following example generates C3507: ```cpp // C3507.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3508.md b/docs/error-messages/compiler-errors-2/compiler-error-c3508.md index d179185e372..189788fc259 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3508.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3508.md @@ -1,20 +1,21 @@ --- -description: "Learn more about: Compiler Error C3508" title: "Compiler Error C3508" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3508" +ms.date: 11/04/2016 f1_keywords: ["C3508"] helpviewer_keywords: ["C3508"] -ms.assetid: 16d08f89-2f32-44eb-9421-68acecddf49b --- # Compiler Error C3508 -'type': is not a valid Automation type +> 'type': is not a valid Automation type + +## Remarks An invalid type was specified. ## Example -The following sample generates C3508: +The following example generates C3508: ```cpp // C3508.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3509.md b/docs/error-messages/compiler-errors-2/compiler-error-c3509.md index 2b68307157e..4504363ff30 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3509.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3509.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C3509" title: "Compiler Error C3509" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3509" +ms.date: 11/04/2016 f1_keywords: ["C3509"] helpviewer_keywords: ["C3509"] -ms.assetid: cc2db39a-2f98-4e40-b803-496e585494e6 --- # Compiler Error C3509 -'type': invalid Automation return type; when a parameter is marked 'retval', the return type must be 'void', 'HRESULT' or 'SCODE' +> 'type': invalid Automation return type; when a parameter is marked 'retval', the return type must be 'void', 'HRESULT' or 'SCODE' + +## Remarks A method in a COM interface must return either void or an HRESULT. -The following sample generates C3509: +## Example + +The following example generates C3509: ```cpp // C3509.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3510.md b/docs/error-messages/compiler-errors-2/compiler-error-c3510.md index 7149143be10..c992a78b251 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3510.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3510.md @@ -1,20 +1,23 @@ --- -description: "Learn more about: Compiler Error C3510" title: "Compiler Error C3510" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3510" +ms.date: 11/04/2016 f1_keywords: ["C3510"] helpviewer_keywords: ["C3510"] -ms.assetid: c48387bc-0300-4a4d-97f7-3fb90f82a451 --- # Compiler Error C3510 -cannot locate dependent type library 'type_lib' +> cannot locate dependent type library 'type_lib' + +## Remarks [no_registry](../../preprocessor/no-registry.md) and [auto_search](../../preprocessor/auto-search.md) were passed to `#import` but the compiler was not able to find a referenced type library. To resolve this error, make sure that all type libraries and referenced type libraries are available to the compiler. -The following sample generates C3510: +## Example + +The following example generates C3510: Assume that the following two type libraries were built, and that C3510a.tlb was deleted or not on the path. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3519.md b/docs/error-messages/compiler-errors-2/compiler-error-c3519.md index af93d7018e6..94e81b7cdbd 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3519.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3519.md @@ -1,20 +1,23 @@ --- -description: "Learn more about: Compiler Error C3519" title: "Compiler Error C3519" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3519" +ms.date: 11/04/2016 f1_keywords: ["C3519"] helpviewer_keywords: ["C3519"] -ms.assetid: ca24b2bc-7e90-4448-ae84-3fedddf9bca7 --- # Compiler Error C3519 -'invalid_param' : invalid parameter to embedded_idl attribute +> 'invalid_param' : invalid parameter to embedded_idl attribute + +## Remarks A parameter was passed to the `embedded_idl` attribute of [#import](../../preprocessor/hash-import-directive-cpp.md), but the compiler did not recognize the parameter. The only parameters that are allowed for `embedded_idl` are `emitidl` and `no_emitidl`. -The following sample generates C3519: +## Example + +The following example generates C3519: ```cpp // C3519.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3530.md b/docs/error-messages/compiler-errors-2/compiler-error-c3530.md index 9a1a7467a25..bc8713e3bd4 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3530.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3530.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Error C3530" title: "Compiler Error C3530" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3530" +ms.date: 11/04/2016 f1_keywords: ["C3530"] helpviewer_keywords: ["C3530"] -ms.assetid: 21be81ce-b699-4c74-81bc-80a0c34d2d5a --- # Compiler Error C3530 -'auto' cannot be combined with any other type-specifier +> 'auto' cannot be combined with any other type-specifier + +## Remarks A type specifier is used with the **`auto`** keyword. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3531.md b/docs/error-messages/compiler-errors-2/compiler-error-c3531.md index 5881579fcb1..af8e3c7faad 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3531.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3531.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Error C3531" title: "Compiler Error C3531" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3531" +ms.date: 11/04/2016 f1_keywords: ["C3531"] helpviewer_keywords: ["C3531"] -ms.assetid: 2bdb9fdc-9ddf-403e-8b92-02763d434487 --- # Compiler Error C3531 -'symbol': a symbol whose type contains 'auto' must have an initializer +> 'symbol': a symbol whose type contains 'auto' must have an initializer + +## Remarks The specified variable does not have an initializer expression. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3532.md b/docs/error-messages/compiler-errors-2/compiler-error-c3532.md index ab9dd8b31e9..ae31df7e246 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3532.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3532.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Error C3532" title: "Compiler Error C3532" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3532" +ms.date: 11/04/2016 f1_keywords: ["C3532"] helpviewer_keywords: ["C3532"] -ms.assetid: 51067853-eda8-4f59-86e8-8924e16d3a95 --- # Compiler Error C3532 -'type': incorrect usage of 'auto' +> 'type': incorrect usage of 'auto' + +## Remarks The indicated type cannot be declared with the **`auto`** keyword. For example, you cannot use the **`auto`** keyword to declare an array or a method return type. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3533.md b/docs/error-messages/compiler-errors-2/compiler-error-c3533.md index eea7dbe64db..0b56398b7bd 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3533.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3533.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Error C3533" title: "Compiler Error C3533" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3533" +ms.date: 11/04/2016 f1_keywords: ["C3533"] helpviewer_keywords: ["C3533"] -ms.assetid: a68b1ba5-466e-4190-a1a4-505ccfe548b7 --- # Compiler Error C3533 -'type': a parameter cannot have a type that contains 'auto' +> 'type': a parameter cannot have a type that contains 'auto' + +## Remarks A method or template parameter cannot be declared with the **`auto`** keyword if the default [/Zc:auto](../../build/reference/zc-auto-deduce-variable-type.md) compiler option is in effect. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3535.md b/docs/error-messages/compiler-errors-2/compiler-error-c3535.md index 05d22de8d0a..7ea0627d720 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3535.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3535.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Error C3535" title: "Compiler Error C3535" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3535" +ms.date: 11/04/2016 f1_keywords: ["C3535"] helpviewer_keywords: ["C3535"] -ms.assetid: 24449c98-f681-484d-a00b-32533dca3a88 --- # Compiler Error C3535 -cannot deduce type for 'type1' from 'type2' +> cannot deduce type for 'type1' from 'type2' + +## Remarks The type of the variable declared by the **`auto`** keyword cannot be deduced from the type of the initialization expression. For example, this error occurs if the initialization expression evaluates to **`void`**, which is not a type. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3536.md b/docs/error-messages/compiler-errors-2/compiler-error-c3536.md index 1701d26b5ab..cb8018a28dc 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3536.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3536.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Error C3536" title: "Compiler Error C3536" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3536" +ms.date: 11/04/2016 f1_keywords: ["C3536"] helpviewer_keywords: ["C3536"] -ms.assetid: 8d866075-866b-49eb-9979-ee27b308f7e3 --- # Compiler Error C3536 -'symbol': cannot be used before it is initialized +> 'symbol': cannot be used before it is initialized + +## Remarks The indicated symbol cannot be used before it is initialized. In practice, this means that a variable cannot be used to initialize itself. @@ -31,7 +32,7 @@ int main() auto* d = &d; //C3536 auto& e = e; //C3536 return 0; -}; +} ``` ## See also diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3537.md b/docs/error-messages/compiler-errors-2/compiler-error-c3537.md index d7562baaf89..1daeb6d5e7a 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3537.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3537.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Error C3537" title: "Compiler Error C3537" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3537" +ms.date: 11/04/2016 f1_keywords: ["C3537"] helpviewer_keywords: ["C3537"] -ms.assetid: f537ebd1-4fb0-4e09-a453-4f38db2c6881 --- # Compiler Error C3537 -'type': you cannot cast to a type that contains 'auto' +> 'type': you cannot cast to a type that contains 'auto' + +## Remarks You cannot cast a variable to the indicated type because the type contains the **`auto`** keyword and the default [/Zc:auto](../../build/reference/zc-auto-deduce-variable-type.md) compiler option is in effect. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3538.md b/docs/error-messages/compiler-errors-2/compiler-error-c3538.md index 3f503e35509..58df9218dba 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3538.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3538.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Error C3538" title: "Compiler Error C3538" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3538" +ms.date: 11/04/2016 f1_keywords: ["C3538"] helpviewer_keywords: ["C3538"] -ms.assetid: ef3698a5-7356-4c62-b9af-5d3a4baed958 --- # Compiler Error C3538 -in a declarator-list 'auto' must always deduce to the same type +> in a declarator-list 'auto' must always deduce to the same type + +## Remarks All the declared variables in a declaration list do not resolve to the same type. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3539.md b/docs/error-messages/compiler-errors-2/compiler-error-c3539.md index c7235b2ddd4..2ace0616df1 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3539.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3539.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Error C3539" title: "Compiler Error C3539" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3539" +ms.date: 11/04/2016 f1_keywords: ["C3539"] helpviewer_keywords: ["C3539"] -ms.assetid: 34a33a0f-d1b6-498f-b312-ffad2d4799b3 --- # Compiler Error C3539 -'type': a template-argument cannot be a type that contains 'auto' +> 'type': a template-argument cannot be a type that contains 'auto' + +## Remarks The indicated template argument type cannot contain a usage of the **`auto`** keyword. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3540.md b/docs/error-messages/compiler-errors-2/compiler-error-c3540.md index 38339db5a72..b1688781639 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3540.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3540.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Error C3540" title: "Compiler Error C3540" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3540" +ms.date: 11/04/2016 f1_keywords: ["C3540"] helpviewer_keywords: ["C3540"] -ms.assetid: 3c0c959c-e3b7-40eb-b922-ccac44bd9d85 --- # Compiler Error C3540 -'type': sizeof cannot be applied to a type that contains 'auto' +> 'type': sizeof cannot be applied to a type that contains 'auto' + +## Remarks The [sizeof](../../cpp/sizeof-operator.md) operator cannot be applied to the indicated type because it contains the **`auto`** specifier. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3541.md b/docs/error-messages/compiler-errors-2/compiler-error-c3541.md index 10701262c51..c29ca9eebf6 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3541.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3541.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Error C3541" title: "Compiler Error C3541" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3541" +ms.date: 11/04/2016 f1_keywords: ["C3541"] helpviewer_keywords: ["C3541"] -ms.assetid: 252cfd4c-5fd2-415e-a17d-6b0c254350db --- # Compiler Error C3541 -'type': typeid cannot be applied to a type that contains 'auto' +> 'type': typeid cannot be applied to a type that contains 'auto' + +## Remarks The [typeid](../../extensions/typeid-cpp-component-extensions.md) operator cannot be applied to the indicated type because it contains the **`auto`** specifier. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3550.md b/docs/error-messages/compiler-errors-2/compiler-error-c3550.md index 01e5f185657..c77d30507be 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3550.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3550.md @@ -1,20 +1,21 @@ --- -description: "Learn more about: Compiler Error C3550" title: "Compiler Error C3550" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3550" +ms.date: 11/04/2016 f1_keywords: ["C3550"] helpviewer_keywords: ["C3550"] -ms.assetid: 9f2d5ffc-e429-41a1-89e3-7acc4fd47e14 --- # Compiler Error C3550 -only plain 'decltype(auto)' is allowed in this context +> only plain 'decltype(auto)' is allowed in this context + +## Remarks If [`decltype(auto)`](../../cpp/decltype-cpp.md#decltype-and-auto) is used as a placeholder for the return type of a function, it must be used by itself. It cannot be used as part of a pointer declaration (`decltype(auto)*`), a reference declaration (`decltype(auto)&`), or any other such qualification. ## Example -The following sample generates C3550: +The following example generates C3550: ```cpp // C3550.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3551.md b/docs/error-messages/compiler-errors-2/compiler-error-c3551.md index 0423abf69ee..5496151097d 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3551.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3551.md @@ -1,17 +1,22 @@ --- -description: "Learn more about: Compiler Error C3551" title: "Compiler Error C3551" -ms.date: "10/07/2023" +description: "Learn more about: Compiler Error C3551" +ms.date: 10/07/2023 f1_keywords: ["C3551"] helpviewer_keywords: ["C3551"] -ms.assetid: c8ee23da-6568-40db-93a6-3ddb7ac47712 --- # Compiler Error C3551 -if a trailing return type is used then the leading return type shall be the single type-specifier 'auto' (not 'type') +> if a trailing return type is used then the leading return type shall be the single type-specifier 'auto' (not 'type') + +## Remarks The leading return type in [trailing return type](../../cpp/functions-cpp.md#trailing-return-types) syntax must contain only `auto`. +## Example + +The following example generates C3551: + ```cpp // C3551.cpp // compile with: /c diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3552.md b/docs/error-messages/compiler-errors-2/compiler-error-c3552.md index 6d6c214ea1c..157c8b64b31 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3552.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3552.md @@ -1,15 +1,20 @@ --- -description: "Learn more about: Compiler Error C3552" title: "Compiler Error C3552" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3552" +ms.date: 11/04/2016 f1_keywords: ["C3552"] helpviewer_keywords: ["C3552"] -ms.assetid: 83401524-1bf1-44c0-8aca-a6eb35c4224c --- # Compiler Error C3552 -'typename': a late specified return type cannot contain 'auto' +> 'typename': a late specified return type cannot contain 'auto' + +## Remarks + +If you use the **`auto`** keyword as a placeholder for the return type of a function, you must provide a late-specified return type. However, you cannot use another **`auto`** keyword to specify the late-specified return type. + +## Example -If you use the **`auto`** keyword as a placeholder for the return type of a function, you must provide a late-specified return type. However, you cannot use another **`auto`** keyword to specify the late-specified return type. For example, the following code fragment yields error C3552. +For example, the following code fragment yields error C3552. `auto myFunction->auto; // C3552` diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3553.md b/docs/error-messages/compiler-errors-2/compiler-error-c3553.md index aa032de7ddc..ad12e1f1f4c 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3553.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3553.md @@ -1,16 +1,21 @@ --- -description: "Learn more about: Compiler Error C3553" title: "Compiler Error C3553" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3553" +ms.date: 11/04/2016 f1_keywords: ["C3553"] helpviewer_keywords: ["C3553"] -ms.assetid: 7f84bf37-6419-4ad3-ab30-64266100b930 --- # Compiler Error C3553 > decltype expects an expression not a type -The `decltype()` keyword requires an expression as an argument, not the name of a type. For example, the last statement in the following code fragment yields error C3553. +## Remarks + +The `decltype()` keyword requires an expression as an argument, not the name of a type. + +## Example + +For example, the last statement in the following code fragment yields error C3553. ```cpp int x = 0; diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3554.md b/docs/error-messages/compiler-errors-2/compiler-error-c3554.md index bb36c2a954d..d05cfaf3689 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3554.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3554.md @@ -1,18 +1,23 @@ --- -description: "Learn more about: Compiler Error C3554" title: "Compiler Error C3554" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3554" +ms.date: 11/04/2016 f1_keywords: ["C3554"] helpviewer_keywords: ["C3554"] -ms.assetid: aede18d5-fefc-4da9-9b69-adfe90bfa742 --- # Compiler Error C3554 -'decltype' cannot be combined with any other type-specifier +> 'decltype' cannot be combined with any other type-specifier -You cannot qualify the `decltype()` keyword with any type specifier. For example, the following code fragment yields error C3554. +## Remarks -``` +You cannot qualify the `decltype()` keyword with any type specifier. + +## Example + +For example, the following code fragment yields error C3554. + +```cpp int x; unsigned decltype(x); // C3554 ``` diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3555.md b/docs/error-messages/compiler-errors-2/compiler-error-c3555.md index 20d3a809439..3f716381455 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3555.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3555.md @@ -1,15 +1,16 @@ --- -description: "Learn more about: Compiler Error C3555" title: "Compiler Error C3555" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3555" +ms.date: 11/04/2016 f1_keywords: ["C3555"] helpviewer_keywords: ["C3555"] -ms.assetid: b4311bd3-851b-479a-9965-d03f39dd8fd4 --- # Compiler Error C3555 > incorrect argument to 'decltype' +## Remarks + The argument to the `decltype(`*expression*`)` type specifier is not a valid expression. > [!NOTE] diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3556.md b/docs/error-messages/compiler-errors-2/compiler-error-c3556.md index d6f25c1171d..dbfbe198704 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3556.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3556.md @@ -1,15 +1,16 @@ --- -description: "Learn more about: Compiler Error C3556" title: "Compiler Error C3556" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3556" +ms.date: 11/04/2016 f1_keywords: ["C3556"] helpviewer_keywords: ["C3556"] -ms.assetid: 9b002dcc-494e-414f-9587-20c2a0a39333 --- # Compiler Error C3556 > '*expression*': incorrect argument to 'decltype' +## Remarks + The compiler cannot deduce the type of the expression that is the argument to the `decltype(`*expression*`)` type specifier. ## Example diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3603.md b/docs/error-messages/compiler-errors-2/compiler-error-c3603.md index 7e37da6a646..d3e6f9a8806 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3603.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3603.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Compiler Error C3603" title: "Compiler Error C3603" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3603" +ms.date: 11/04/2016 f1_keywords: ["C3603"] helpviewer_keywords: ["C3603"] -ms.assetid: d0cdc7d3-f25a-4242-9ee8-51fe044a9959 --- # Compiler Error C3603 -'Symbol' : type 'Type' not yet supported +> 'Symbol' : type 'Type' not yet supported + +## Remarks You attempted to use a data type that is not yet supported by the .NET runtime in a managed object. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3609.md b/docs/error-messages/compiler-errors-2/compiler-error-c3609.md index b667614aedd..e0a7eca6c11 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3609.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3609.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C3609" title: "Compiler Error C3609" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3609" +ms.date: 11/04/2016 f1_keywords: ["C3609"] helpviewer_keywords: ["C3609"] -ms.assetid: 801e7f79-4ac6-4f8f-955f-703cdf095d00 --- # Compiler Error C3609 -'member': a sealed or final function must be virtual +> 'member': a sealed or final function must be virtual + +## Remarks The [sealed](../../extensions/sealed-cpp-component-extensions.md) and [final](../../cpp/final-specifier.md) keywords are only allowed on a class, struct, or member function marked **`virtual`**. -The following sample generates C3609: +## Example + +The following example generates C3609: ```cpp // C3609.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3610.md b/docs/error-messages/compiler-errors-2/compiler-error-c3610.md index 81720af72c7..8d7ddb5eeda 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3610.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3610.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Error C3610" title: "Compiler Error C3610" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3610" +ms.date: 11/04/2016 f1_keywords: ["C3610"] helpviewer_keywords: ["C3610"] -ms.assetid: 9349a348-9d37-4a00-9eab-481039268d31 --- # Compiler Error C3610 -'valuetype': value type must be 'boxed' before method 'method' can be called +> 'valuetype': value type must be 'boxed' before method 'method' can be called + +## Remarks By default, a value type is not on the managed heap. Before you can call methods from .NET runtime classes, such as `Object`, you need to move the value type to the managed heap. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3611.md b/docs/error-messages/compiler-errors-2/compiler-error-c3611.md index 53a3ecfdb1d..985c54d27e6 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3611.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3611.md @@ -1,20 +1,21 @@ --- -description: "Learn more about: Compiler Error C3611" title: "Compiler Error C3611" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3611" +ms.date: 11/04/2016 f1_keywords: ["C3611"] helpviewer_keywords: ["C3611"] -ms.assetid: 42f3e320-41de-420a-bd05-8924cab765aa --- # Compiler Error C3611 -'function': a sealed function cannot have a pure-specifier +> 'function': a sealed function cannot have a pure-specifier + +## Remarks A sealed function was declared incorrectly. For more information, see [sealed](../../extensions/sealed-cpp-component-extensions.md). ## Example -The following sample generates C3611. +The following example generates C3611. ```cpp // C3611.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3612.md b/docs/error-messages/compiler-errors-2/compiler-error-c3612.md index 133fdce7452..f8b2ed8dc3e 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3612.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3612.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Error C3612" title: "Compiler Error C3612" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3612" +ms.date: 11/04/2016 f1_keywords: ["C3612"] helpviewer_keywords: ["C3612"] -ms.assetid: aa6e3a2b-4afa-481c-98c1-1b6d1f82f869 --- # Compiler Error C3612 -'type': a sealed class cannot be abstract +> 'type': a sealed class cannot be abstract + +## Remarks Types defined by using `value` are sealed by default, and a class is abstract unless it implements all methods of its base. A sealed abstract class can neither be a base class nor can it be instantiated. @@ -16,7 +17,7 @@ For more information, see [Classes and Structs](../../extensions/classes-and-str ## Example -The following sample generates C3612: +The following example generates C3612: ```cpp // C3612.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3615.md b/docs/error-messages/compiler-errors-2/compiler-error-c3615.md index a66992f97d8..43d833dbcec 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3615.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3615.md @@ -1,15 +1,16 @@ --- -description: "Learn more about: Compiler Error C3615" title: "Compiler Error C3615" -ms.date: "10/24/2017" +description: "Learn more about: Compiler Error C3615" +ms.date: 10/24/2017 f1_keywords: ["C3615"] helpviewer_keywords: ["C3615"] -ms.assetid: 5ce96ba9-3d31-49f3-9aa8-24e5cdf6dcfc --- # Compiler Error C3615 > constexpr function '*function*' cannot result in a constant expression +## Remarks + The function *function* could not be evaluated as **`constexpr`** at compile time. To be **`constexpr`**, a function can only call other **`constexpr`** functions. ## Example diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3618.md b/docs/error-messages/compiler-errors-2/compiler-error-c3618.md index facaf056dbb..0ee128a4473 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3618.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3618.md @@ -1,20 +1,21 @@ --- -description: "Learn more about: Compiler Error C3618" title: "Compiler Error C3618" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3618" +ms.date: 11/04/2016 f1_keywords: ["C3618"] helpviewer_keywords: ["C3618"] -ms.assetid: cacc105d-4389-4cb8-ae6c-41a3622e9a86 --- # Compiler Error C3618 -'function': a method marked DllImport cannot be defined +> 'function': a method marked DllImport cannot be defined + +## Remarks A method marked with is defined in the specified.DLL. ## Example -The following sample generates C3618. +The following example generates C3618. ```cpp // C3618.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3619.md b/docs/error-messages/compiler-errors-2/compiler-error-c3619.md index 6867cad9b73..53c17536203 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3619.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3619.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Error C3619" title: "Compiler Error C3619" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3619" +ms.date: 11/04/2016 f1_keywords: ["C3619"] helpviewer_keywords: ["C3619"] -ms.assetid: 76ae80d0-9fbe-4297-a1ef-b1503377fdcf --- # Compiler Error C3619 -a template cannot be declared within a managed or WinRT type +> a template cannot be declared within a managed or WinRT type + +## Remarks Class templates are not allowed in a managed or WinRT class or interface. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3622.md b/docs/error-messages/compiler-errors-2/compiler-error-c3622.md index 7301a8b96aa..60241213166 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3622.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3622.md @@ -1,20 +1,21 @@ --- -description: "Learn more about: Compiler Error C3622" title: "Compiler Error C3622" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3622" +ms.date: 11/04/2016 f1_keywords: ["C3622"] helpviewer_keywords: ["C3622"] -ms.assetid: 02836f78-0cf2-4947-b87e-710187d81014 --- # Compiler Error C3622 -'class' : a class declared as 'keyword' cannot be instantiated +> 'class' : a class declared as 'keyword' cannot be instantiated + +## Remarks An attempt was made to instantiate a class marked as [abstract](../../extensions/abstract-cpp-component-extensions.md). A class marked as **`abstract`** can be a base class, but it cannot be instantiated. ## Example -The following sample generates C3622. +The following example generates C3622. ```cpp // C3622.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3623.md b/docs/error-messages/compiler-errors-2/compiler-error-c3623.md index 07627ca798e..f19e798bd68 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3623.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3623.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C3623" title: "Compiler Error C3623" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3623" +ms.date: 11/04/2016 f1_keywords: ["C3623"] helpviewer_keywords: ["C3623"] -ms.assetid: a0341b45-062a-4f67-beb9-ba74201ed1ed --- # Compiler Error C3623 -'variable': bit fields are not supported in managed or WinRT types +> 'variable': bit fields are not supported in managed or WinRT types + +## Remarks The use of bit fields is not permitted on variables in a managed or WinRT class. -The following sample generates C3623: +## Example + +The following example generates C3623: ```cpp // C3623.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3624.md b/docs/error-messages/compiler-errors-2/compiler-error-c3624.md index 8a9eba82beb..81196f32bb3 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3624.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3624.md @@ -1,20 +1,21 @@ --- -description: "Learn more about: Compiler Error C3624" title: "Compiler Error C3624" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3624" +ms.date: 11/04/2016 f1_keywords: ["C3624"] helpviewer_keywords: ["C3624"] -ms.assetid: eaac6a4f-eb11-4e4d-ab12-124ba995c5cf --- # Compiler Error C3624 -'type': use of this type requires a reference to assembly 'assembly' +> 'type': use of this type requires a reference to assembly 'assembly' + +## Remarks An assembly (reference) needed to compile your code was not specified; pass the assembly to the [#using](../../preprocessor/hash-using-directive-cpp.md) directive. ## Example -The following sample generates C3624: +The following example generates C3624: ```cpp // C3624.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3625.md b/docs/error-messages/compiler-errors-2/compiler-error-c3625.md index eed0c1f02bf..46ae1ba8349 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3625.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3625.md @@ -1,20 +1,21 @@ --- -description: "Learn more about: Compiler Error C3625" title: "Compiler Error C3625" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3625" +ms.date: 11/04/2016 f1_keywords: ["C3625"] helpviewer_keywords: ["C3625"] -ms.assetid: fdf49f21-d6b1-42f4-9eec-23b04ae8b4aa --- # Compiler Error C3625 -'native_type': a native type cannot derive from a managed or WinRT type 'type' +> 'native_type': a native type cannot derive from a managed or WinRT type 'type' + +## Remarks A native class cannot inherit from a managed or WinRT class. For more information, see [Classes and Structs](../../extensions/classes-and-structs-cpp-component-extensions.md). ## Example -The following sample generates C3625: +The following example generates C3625: ```cpp // C3625.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3626.md b/docs/error-messages/compiler-errors-2/compiler-error-c3626.md index dd04cfe1a42..b28d6ad76c1 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3626.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3626.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C3626" title: "Compiler Error C3626" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3626" +ms.date: 11/04/2016 f1_keywords: ["C3626"] helpviewer_keywords: ["C3626"] -ms.assetid: 43926e2b-1ba9-4a43-9343-c58449cbb336 --- # Compiler Error C3626 -'keyword': '__event' keyword can only be used on COM interfaces, member functions and data members that are pointers to delegates +> 'keyword': '__event' keyword can only be used on COM interfaces, member functions and data members that are pointers to delegates + +## Remarks A keyword was used incorrectly. -The following sample generates C3626: +## Example + +The following example generates C3626: ```cpp // C3626.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3627.md b/docs/error-messages/compiler-errors-2/compiler-error-c3627.md index cddb376d1bb..1512ff7a55f 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3627.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3627.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Compiler Error C3627" title: "Compiler Error C3627" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3627" +ms.date: 11/04/2016 f1_keywords: ["C3627"] helpviewer_keywords: ["C3627"] -ms.assetid: 905ad0a0-8c49-4187-b66e-b375f5a1fae5 --- # Compiler Error C3627 -Only a value type can be boxed +> Only a value type can be boxed + +## Remarks Only value classes can be boxed. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3628.md b/docs/error-messages/compiler-errors-2/compiler-error-c3628.md index cd3c08937af..9ee013b88bc 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3628.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3628.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C3628" title: "Compiler Error C3628" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3628" +ms.date: 11/04/2016 f1_keywords: ["C3628"] helpviewer_keywords: ["C3628"] -ms.assetid: 0ff5a4a4-fcc9-47a0-a4d8-8af9cf2815f6 --- # Compiler Error C3628 -'base class' : managed or WinRTclasses only support public inheritance +> 'base class' : managed or WinRTclasses only support public inheritance + +## Remarks An attempt was made to use a managed or WinRT class as a [private](../../cpp/private-cpp.md) or [protected](../../cpp/protected-cpp.md) base class. A managed or WinRT class can only be used as a base class with [public](../../cpp/public-cpp.md) access. -The following sample generates C3628 and shows how to fix it: +## Example + +The following example generates C3628 and shows how to fix it: ```cpp // C3628a.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3630.md b/docs/error-messages/compiler-errors-2/compiler-error-c3630.md index d5fd6878985..26adba75358 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3630.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3630.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Compiler Error C3630" title: "Compiler Error C3630" +description: "Learn more about: Compiler Error C3630" ms.date: 05/25/2022 f1_keywords: ["C3630"] helpviewer_keywords: ["C3630"] -ms.assetid: 865626a9-98cc-465d-acde-44d4574c019a --- # Compiler Error C3630 > error when processing the token '*token*' +## Remarks + A token in source code couldn't be processed. This error is obsolete in Visual Studio 2022. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3631.md b/docs/error-messages/compiler-errors-2/compiler-error-c3631.md index 202b12ae211..2feb0d3e348 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3631.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3631.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Error C3631" title: "Compiler Error C3631" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3631" +ms.date: 11/04/2016 f1_keywords: ["C3631"] helpviewer_keywords: ["C3631"] -ms.assetid: 88cbd2d5-6fef-4940-be34-d8cbe816d3da --- # Compiler Error C3631 -'function': cannot overload managed or WinRT events +> 'function': cannot overload managed or WinRT events + +## Remarks A managed or WinRT event cannot be overloaded. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3632.md b/docs/error-messages/compiler-errors-2/compiler-error-c3632.md index c9151e571fa..337489011a3 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3632.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3632.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Error C3632" title: "Compiler Error C3632" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3632" +ms.date: 11/04/2016 f1_keywords: ["C3632"] helpviewer_keywords: ["C3632"] -ms.assetid: a04e3217-f5a1-4461-a1db-d69fd096d468 --- # Compiler Error C3632 -'event': illegal style of event for construct +> 'event': illegal style of event for construct + +## Remarks [__event](../../cpp/event.md) declarations are not valid in all constructs. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3633.md b/docs/error-messages/compiler-errors-2/compiler-error-c3633.md index fb0ba09ac2e..acefca20c78 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3633.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3633.md @@ -1,20 +1,21 @@ --- -description: "Learn more about: Compiler Error C3633" title: "Compiler Error C3633" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3633" +ms.date: 11/04/2016 f1_keywords: ["C3633"] helpviewer_keywords: ["C3633"] -ms.assetid: 7d65babf-2191-4d67-a69f-f5c4c2ddf946 --- # Compiler Error C3633 -cannot define 'member' as a member of managed 'type' +> cannot define 'member' as a member of managed 'type' + +## Remarks CLR reference class data members cannot be of a non-POD C++ type. You can only instantiate a POD native type in a CLR type. For example, a POD type cannot contain a copy constructor or an assignment operator. ## Example -The following sample generates C3633. +The following example generates C3633. ```cpp // C3633.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3634.md b/docs/error-messages/compiler-errors-2/compiler-error-c3634.md index 390f9d9b044..5a003e3be6d 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3634.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3634.md @@ -1,20 +1,21 @@ --- -description: "Learn more about: Compiler Error C3634" title: "Compiler Error C3634" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3634" +ms.date: 11/04/2016 f1_keywords: ["C3634"] helpviewer_keywords: ["C3634"] -ms.assetid: fd09f10c-f863-483b-9756-71c16b760b02 --- # Compiler Error C3634 -'function' : cannot define an abstract method of a managed or WinRTclass +> 'function' : cannot define an abstract method of a managed or WinRTclass + +## Remarks An abstract method can be declared in a managed or WinRT class, but it cannot be defined. ## Example -The following sample generates C3634: +The following example generates C3634: ```cpp // C3634.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3637.md b/docs/error-messages/compiler-errors-2/compiler-error-c3637.md index b49fbc33968..0ff30315570 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3637.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3637.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C3637" title: "Compiler Error C3637" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3637" +ms.date: 11/04/2016 f1_keywords: ["C3637"] helpviewer_keywords: ["C3637"] -ms.assetid: 72391377-8519-43d9-870a-73a6423deb74 --- # Compiler Error C3637 -'function' : a friend function definition cannot be a specialization of a function type +> 'function' : a friend function definition cannot be a specialization of a function type + +## Remarks A friend function was defined incorrectly for a template or generic. -The following sample generates C3637: +## Examples + +The following example generates C3637: ```cpp // C3637.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3638.md b/docs/error-messages/compiler-errors-2/compiler-error-c3638.md index 2fcff4c27d4..0f0c2e3c61a 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3638.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3638.md @@ -1,20 +1,23 @@ --- -description: "Learn more about: Compiler Error C3638" title: "Compiler Error C3638" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3638" +ms.date: 11/04/2016 f1_keywords: ["C3638"] helpviewer_keywords: ["C3638"] -ms.assetid: 8d8bc5ca-75aa-480e-b6b6-3178fab51b1d --- # Compiler Error C3638 -'operator' : the standard boxing and unboxing conversion operators cannot be redefined +> 'operator' : the standard boxing and unboxing conversion operators cannot be redefined + +## Remarks The compiler defines a conversion operator for each managed class to support implicit boxing. This operator cannot be redefined. For more information, see [Implicit Boxing](../../extensions/boxing-cpp-component-extensions.md). -The following sample generates C3638: +## Example + +The following example generates C3638: ```cpp // C3638.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3640.md b/docs/error-messages/compiler-errors-2/compiler-error-c3640.md index 88cd60658d6..dae63059c1e 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3640.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3640.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C3640" title: "Compiler Error C3640" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3640" +ms.date: 11/04/2016 f1_keywords: ["C3640"] helpviewer_keywords: ["C3640"] -ms.assetid: fcc56894-0f98-48af-8561-3bf7c7b2b93f --- # Compiler Error C3640 -'member' : a referenced or virtual member function of a local class must be defined +> 'member' : a referenced or virtual member function of a local class must be defined + +## Remarks The compiler requires certain functions to be defined. -The following sample generates C3640: +## Example + +The following example generates C3640: ```cpp // C3640.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3641.md b/docs/error-messages/compiler-errors-2/compiler-error-c3641.md index fbca71d1025..46835413dba 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3641.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3641.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3641" title: "Compiler Error C3641" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3641" +ms.date: 11/04/2016 f1_keywords: ["C3641"] helpviewer_keywords: ["C3641"] -ms.assetid: e8d3613e-5e8d-46fe-a516-eb7d1de7cd21 --- # Compiler Error C3641 @@ -18,7 +17,7 @@ Only [__clrcall](../../cpp/clrcall.md) calling convention is allowed with [/clr: ## Example -The following sample generates C3641: +The following example generates C3641: ```cpp // C3641.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3642.md b/docs/error-messages/compiler-errors-2/compiler-error-c3642.md index 6408f3f41d4..9ad9ca91d3e 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3642.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3642.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Error C3642" title: "Compiler Error C3642" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3642" +ms.date: 11/04/2016 f1_keywords: ["C3642"] helpviewer_keywords: ["C3642"] -ms.assetid: 429790c2-9614-4d85-b31c-687c8d8f83ff --- # Compiler Error C3642 -'return_type/args' : cannot call a function with __clrcall calling convention from native code +> 'return_type/args' : cannot call a function with __clrcall calling convention from native code + +## Remarks A function that is marked with the [__clrcall](../../cpp/clrcall.md) calling convention cannot be called from native (unmanaged) code. @@ -16,7 +17,9 @@ A function that is marked with the [__clrcall](../../cpp/clrcall.md) calling con To call a managed function from a native context, you can add a "wrapper" function that will call the `__clrcall` function. Or, you can use the CLR marshalling mechanism; see [How to: Marshal Function Pointers Using PInvoke](../../dotnet/how-to-marshal-function-pointers-using-pinvoke.md) for more information. -The following sample generates C3642: +## Example + +The following example generates C3642: ```cpp // C3642.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3644.md b/docs/error-messages/compiler-errors-2/compiler-error-c3644.md index 1798239f263..78613404658 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3644.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3644.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C3644" title: "Compiler Error C3644" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3644" +ms.date: 11/04/2016 f1_keywords: ["C3644"] helpviewer_keywords: ["C3644"] -ms.assetid: 2e3f6c41-3ec5-4a01-82bc-f11b61ebe68e --- # Compiler Error C3644 -'function' : cannot compile the function to generate managed code +> 'function' : cannot compile the function to generate managed code + +## Remarks The presence of some keywords in a function will cause the function to be compiled to native. -The following sample generates C3644: +## Example + +The following example generates C3644: ```cpp // C3644.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3645.md b/docs/error-messages/compiler-errors-2/compiler-error-c3645.md index b58af9dcfdb..4667e877425 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3645.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3645.md @@ -1,20 +1,21 @@ --- -description: "Learn more about: Compiler Error C3645" title: "Compiler Error C3645" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3645" +ms.date: 11/04/2016 f1_keywords: ["C3645"] helpviewer_keywords: ["C3645"] -ms.assetid: 346da528-ae86-4cd0-9654-f41bee26ac0d --- # Compiler Error C3645 -'function' : __clrcall cannot be used on functions compiled to native code +> 'function' : __clrcall cannot be used on functions compiled to native code + +## Remarks The presence of some keywords in a function will cause the function to be compiled to native. ## Example -The following sample generates C3645. +The following example generates C3645. ```cpp // C3645.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3646.md b/docs/error-messages/compiler-errors-2/compiler-error-c3646.md index 21c1177f7d6..330b23f3339 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3646.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3646.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3646" title: "Compiler Error C3646" -ms.date: "06/14/2018" +description: "Learn more about: Compiler Error C3646" +ms.date: 06/14/2018 f1_keywords: ["C3646"] helpviewer_keywords: ["C3646"] -ms.assetid: 4391ead2-9637-4ca3-aeda-5a991b18d66d --- # Compiler Error C3646 @@ -20,7 +19,7 @@ For more information, see [Override Specifiers](../../extensions/override-specif ## Example -The following sample generates C3646 and shows a way to fix it: +The following example generates C3646 and shows a way to fix it: ```cpp // C3646.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3648.md b/docs/error-messages/compiler-errors-2/compiler-error-c3648.md index 273693bbe46..0eacdf8cfcf 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3648.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3648.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Error C3648" title: "Compiler Error C3648" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3648" +ms.date: 11/04/2016 f1_keywords: ["C3648"] helpviewer_keywords: ["C3648"] -ms.assetid: 5d042989-41cb-4cd0-aa50-976b70146aaf --- # Compiler Error C3648 -this explicit override syntax requires /clr:oldSyntax +> this explicit override syntax requires /clr:oldSyntax + +## Remarks When compiling for the latest managed syntax, the compiler found explicit override syntax for previous versions that is no longer supported. @@ -16,7 +17,7 @@ For more information, see [Explicit Overrides](../../extensions/explicit-overrid ## Example -The following sample generates C3648: +The following example generates C3648: ```cpp // C3648.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3650.md b/docs/error-messages/compiler-errors-2/compiler-error-c3650.md index e77e5ac394f..7687b504002 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3650.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3650.md @@ -1,20 +1,23 @@ --- -description: "Learn more about: Compiler Error C3650" title: "Compiler Error C3650" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3650" +ms.date: 11/04/2016 f1_keywords: ["C3650"] helpviewer_keywords: ["C3650"] -ms.assetid: ca4d8de4-b027-4d13-9b9f-03ca62905c33 --- # Compiler Error C3650 -'interface_method' : cannot be used as an explicit override, must be a virtual member function of a base class +> 'interface_method' : cannot be used as an explicit override, must be a virtual member function of a base class + +## Remarks An attempt was made to perform an explicit override on a member that was not virtual. For more information, see [Explicit Overrides](../../extensions/explicit-overrides-cpp-component-extensions.md). -The following sample generates C3650: +## Example + +The following example generates C3650: ```cpp // C3650.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3651.md b/docs/error-messages/compiler-errors-2/compiler-error-c3651.md index f50b6090be8..05a811b6625 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3651.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3651.md @@ -1,20 +1,23 @@ --- -description: "Learn more about: Compiler Error C3651" title: "Compiler Error C3651" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3651" +ms.date: 11/04/2016 f1_keywords: ["C3651"] helpviewer_keywords: ["C3651"] -ms.assetid: a03e692e-c219-4654-9827-8415cfa5a22d --- # Compiler Error C3651 -'member' : cannot be used as an explicit override, must be a member of a base class +> 'member' : cannot be used as an explicit override, must be a member of a base class + +## Remarks An explicit override was specified, but the function being overridden was in a type that is not a base type. For more information, see [Explicit Overrides](../../extensions/explicit-overrides-cpp-component-extensions.md). -The following sample generates C3651: +## Example + +The following example generates C3651: ```cpp // C3651.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3652.md b/docs/error-messages/compiler-errors-2/compiler-error-c3652.md index 81541733938..d4cff5ba850 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3652.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3652.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C3652" title: "Compiler Error C3652" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3652" +ms.date: 11/04/2016 f1_keywords: ["C3652"] helpviewer_keywords: ["C3652"] -ms.assetid: 15d68737-177e-41f1-80e0-7c3e2afdf0fc --- # Compiler Error C3652 -'override' : a function that explicitly overrides must be virtual +> 'override' : a function that explicitly overrides must be virtual + +## Remarks A function that does an explicit override must be virtual. For more information, see [Explicit Overrides](../../extensions/explicit-overrides-cpp-component-extensions.md). -The following sample generates C3652: +## Example + +The following example generates C3652: ```cpp // C3652.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3653.md b/docs/error-messages/compiler-errors-2/compiler-error-c3653.md index 4f6aeb2eeca..0dff663b5c9 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3653.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3653.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C3653" title: "Compiler Error C3653" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3653" +ms.date: 11/04/2016 f1_keywords: ["C3653"] helpviewer_keywords: ["C3653"] -ms.assetid: 316549d7-f7ef-4578-a2ba-57adc8aac527 --- # Compiler Error C3653 -'function' : cannot be used as a named override: a function being overridden not found; did you forget to name the function explicitly, using a :: operator? +> 'function' : cannot be used as a named override: a function being overridden not found; did you forget to name the function explicitly, using a :: operator? + +## Remarks An explicit override specified a function that was not found in any interface. For more information, see [Explicit Overrides](../../extensions/explicit-overrides-cpp-component-extensions.md). -The following sample generates C3653: +## Example + +The following example generates C3653: ```cpp // C3653.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3654.md b/docs/error-messages/compiler-errors-2/compiler-error-c3654.md index 593ca9bd654..f3cb4716ef2 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3654.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3654.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C3654" title: "Compiler Error C3654" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3654" +ms.date: 11/04/2016 f1_keywords: ["C3654"] helpviewer_keywords: ["C3654"] -ms.assetid: 57d96e3f-6bbb-4eaa-934b-26c23b4ceb2e --- # Compiler Error C3654 -'text' : syntax error in explicit override +> 'text' : syntax error in explicit override + +## Remarks An unexpected string was in an explicit override. For more information, see [Explicit Overrides](../../extensions/explicit-overrides-cpp-component-extensions.md). -The following sample generates C3654: +## Example + +The following example generates C3654: ```cpp // C3654.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3655.md b/docs/error-messages/compiler-errors-2/compiler-error-c3655.md index e2b51a05bb3..cca99c6c609 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3655.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3655.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C3655" title: "Compiler Error C3655" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3655" +ms.date: 11/04/2016 f1_keywords: ["C3655"] helpviewer_keywords: ["C3655"] -ms.assetid: 724919ab-2915-4b61-8794-44648e162d62 --- # Compiler Error C3655 -'function' : function already explicitly overridden +> 'function' : function already explicitly overridden + +## Remarks A function can only be explicitly overridden once. For more information, see [Explicit Overrides](../../extensions/explicit-overrides-cpp-component-extensions.md). -The following sample generates C3655: +## Example + +The following example generates C3655: ```cpp // C3655.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3656.md b/docs/error-messages/compiler-errors-2/compiler-error-c3656.md index 1825ce5c157..da9a9fb22c7 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3656.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3656.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C3656" title: "Compiler Error C3656" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3656" +ms.date: 11/04/2016 f1_keywords: ["C3656"] helpviewer_keywords: ["C3656"] -ms.assetid: 88965d85-73b0-4b35-8020-0650c9c94cd8 --- # Compiler Error C3656 -'override' : override specifier cannot be repeated +> 'override' : override specifier cannot be repeated + +## Remarks An explicit override keyword can only be specified once. For more information, see [Explicit Overrides](../../extensions/explicit-overrides-cpp-component-extensions.md). -The following sample generates C3656: +## Example + +The following example generates C3656: ```cpp // C3656.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3657.md b/docs/error-messages/compiler-errors-2/compiler-error-c3657.md index a778329f3c9..155f032d990 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3657.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3657.md @@ -1,20 +1,21 @@ --- -description: "Learn more about: Compiler Error C3657" title: "Compiler Error C3657" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3657" +ms.date: 11/04/2016 f1_keywords: ["C3657"] helpviewer_keywords: ["C3657"] -ms.assetid: 89a28a18-4c17-43a1-bda6-deb52c32d203 --- # Compiler Error C3657 -destructors cannot explicitly override or be explicitly overridden +> destructors cannot explicitly override or be explicitly overridden + +## Remarks Destructors or finalizers cannot be explicitly overridden. For more information, see [Explicit Overrides](../../extensions/explicit-overrides-cpp-component-extensions.md). ## Example -The following sample generates C3657. +The following example generates C3657. ```cpp // C3657.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3661.md b/docs/error-messages/compiler-errors-2/compiler-error-c3661.md index 8f0e21753b5..7429b9de5ac 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3661.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3661.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Error C3661" title: "Compiler Error C3661" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3661" +ms.date: 11/04/2016 f1_keywords: ["C3661"] helpviewer_keywords: ["C3661"] -ms.assetid: 50793fd1-1829-4b29-ad0d-094ef2068b43 --- # Compiler Error C3661 -explicit override list did not find any methods to override +> explicit override list did not find any methods to override + +## Remarks An explicit override specified one or more type names. However, there was no function with the necessary signature in the type(s) that matched the overriding function's signature. If you attempt to override based on type name, there must be one or more virtual functions in the specified type(s) that match the signature of the overriding function. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3662.md b/docs/error-messages/compiler-errors-2/compiler-error-c3662.md index 6ba37b24059..e5edfda336a 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3662.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3662.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Error C3662" title: "Compiler Error C3662" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3662" +ms.date: 11/04/2016 f1_keywords: ["C3662"] helpviewer_keywords: ["C3662"] -ms.assetid: 61bd3e41-a86b-42c0-be89-d992d3906ff1 --- # Compiler Error C3662 -'member' : override specifier 'specifier' only allowed on member functions of managed or WinRT classes +> 'member' : override specifier 'specifier' only allowed on member functions of managed or WinRT classes + +## Remarks An override specifier was used on a member of native type, which is not allowed. @@ -16,7 +17,7 @@ For more information, see [Explicit Overrides](../../extensions/explicit-overrid ## Example -The following sample generates C3662. +The following example generates C3662. ```cpp // C3662.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3665.md b/docs/error-messages/compiler-errors-2/compiler-error-c3665.md index 936a2255bf1..969f276e9c6 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3665.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3665.md @@ -1,20 +1,23 @@ --- -description: "Learn more about: Compiler Error C3665" title: "Compiler Error C3665" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3665" +ms.date: 11/04/2016 f1_keywords: ["C3665"] helpviewer_keywords: ["C3665"] -ms.assetid: 893bb47e-8de1-43aa-af7d-fa47ad149ee9 --- # Compiler Error C3665 -'destructor' : override specifier 'keyword' not allowed on a destructor/finalizer +> 'destructor' : override specifier 'keyword' not allowed on a destructor/finalizer + +## Remarks A keyword was used that is not allowed on a destructor or finalizer. For example, a new slot cannot be requested on a destructor or finalizer. For more information, see [Explicit Overrides](../../extensions/explicit-overrides-cpp-component-extensions.md) and [Destructors and finalizers](../../dotnet/how-to-define-and-consume-classes-and-structs-cpp-cli.md#BKMK_Destructors_and_finalizers). -The following sample generates C3665: +## Example + +The following example generates C3665: ```cpp // C3665.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3666.md b/docs/error-messages/compiler-errors-2/compiler-error-c3666.md index c2aa130de78..b516ef72145 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3666.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3666.md @@ -1,20 +1,21 @@ --- -description: "Learn more about: Compiler Error C3666" title: "Compiler Error C3666" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3666" +ms.date: 11/04/2016 f1_keywords: ["C3666"] helpviewer_keywords: ["C3666"] -ms.assetid: 459e51dd-cefb-4346-99b3-644f2d8b65b2 --- # Compiler Error C3666 -'constructor' : override specifier 'keyword' not allowed on a constructor +> 'constructor' : override specifier 'keyword' not allowed on a constructor + +## Remarks An override specifier was used on a constructor, and that is not allowed. For more information, see [Override Specifiers](../../extensions/override-specifiers-cpp-component-extensions.md). ## Example -The following sample generates C3666. +The following example generates C3666. ```cpp // C3666.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3668.md b/docs/error-messages/compiler-errors-2/compiler-error-c3668.md index 079daf488b1..e8640f0b6b5 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3668.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3668.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Error C3668" title: "Compiler Error C3668" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3668" +ms.date: 11/04/2016 f1_keywords: ["C3668"] helpviewer_keywords: ["C3668"] -ms.assetid: 53a96698-bde4-4447-95b5-b5108291f60c --- # Compiler Error C3668 -'method' : method with override specifier 'override' did not override any base class methods +> 'method' : method with override specifier 'override' did not override any base class methods + +## Remarks A function attempted to override a non-existent function. @@ -16,7 +17,7 @@ For more information, see [Explicit Overrides](../../extensions/explicit-overrid ## Example -The following sample generates C3668. +The following example generates C3668. ```cpp // C3668.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3669.md b/docs/error-messages/compiler-errors-2/compiler-error-c3669.md index 4b1fcf62295..c4e896e88fe 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3669.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3669.md @@ -1,20 +1,21 @@ --- -description: "Learn more about: Compiler Error C3669" title: "Compiler Error C3669" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3669" +ms.date: 11/04/2016 f1_keywords: ["C3669"] helpviewer_keywords: ["C3669"] -ms.assetid: be9c7ae4-e96f-47ab-922a-39a3537d5ca6 --- # Compiler Error C3669 -'member' : override specifier 'override' not allowed on static member functions or constructors +> 'member' : override specifier 'override' not allowed on static member functions or constructors + +## Remarks An override was specified incorrectly. For more information, see [Explicit Overrides](../../extensions/explicit-overrides-cpp-component-extensions.md). ## Example -The following sample generates C3669. +The following example generates C3669. ```cpp // C3669.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3670.md b/docs/error-messages/compiler-errors-2/compiler-error-c3670.md index 6c0d1e1786d..7db7a7f9bc4 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3670.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3670.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C3670" title: "Compiler Error C3670" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3670" +ms.date: 11/04/2016 f1_keywords: ["C3670"] helpviewer_keywords: ["C3670"] -ms.assetid: d0fa9c6e-8f90-48c7-9066-31b4fa5942eb --- # Compiler Error C3670 -'override' : cannot override inaccessible base class method 'method' +> 'override' : cannot override inaccessible base class method 'method' + +## Remarks An override can only take place on a function whose access level makes it available in a derived type. For more information, see [Explicit Overrides](../../extensions/explicit-overrides-cpp-component-extensions.md). -The following sample generates C3670: +## Example + +The following example generates C3670: ```cpp // C3670.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3671.md b/docs/error-messages/compiler-errors-2/compiler-error-c3671.md index 8a310719b59..81d0cefecf9 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3671.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3671.md @@ -1,20 +1,21 @@ --- -description: "Learn more about: Compiler Error C3671" title: "Compiler Error C3671" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3671" +ms.date: 11/04/2016 f1_keywords: ["C3671"] helpviewer_keywords: ["C3671"] -ms.assetid: d684e4ae-87e2-4424-80bb-6f346652c831 --- # Compiler Error C3671 -'function_1' : function does not override 'function_2' +> 'function_1' : function does not override 'function_2' + +## Remarks When using explicit override syntax, the compiler generates an error if a function is not overridden. See [Explicit Overrides](../../extensions/explicit-overrides-cpp-component-extensions.md) for more information. ## Example -The following sample generates C3671. +The following example generates C3671. ```cpp // C3671.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3672.md b/docs/error-messages/compiler-errors-2/compiler-error-c3672.md index 3624f2563d0..6a013789552 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3672.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3672.md @@ -1,20 +1,21 @@ --- -description: "Learn more about: Compiler Error C3672" title: "Compiler Error C3672" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3672" +ms.date: 11/04/2016 f1_keywords: ["C3672"] helpviewer_keywords: ["C3672"] -ms.assetid: da971041-1766-467a-aecf-1d8655c6cb7a --- # Compiler Error C3672 -pseudo-destructor expression can only be used as part of a function call +> pseudo-destructor expression can only be used as part of a function call + +## Remarks A destructor was called incorrectly. For more information, see [Destructors](../../cpp/destructors-cpp.md). ## Example -The following sample generates C3672. +The following example generates C3672. ```cpp // C3672.cpp @@ -22,7 +23,7 @@ template void f(T* pT) { &pT->T::~T; // C3672 pT->T::~T(); // OK -}; +} int main() { int i; diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3673.md b/docs/error-messages/compiler-errors-2/compiler-error-c3673.md index 80458100b76..5781848d703 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3673.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3673.md @@ -1,20 +1,21 @@ --- -description: "Learn more about: Compiler Error C3673" title: "Compiler Error C3673" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3673" +ms.date: 11/04/2016 f1_keywords: ["C3673"] helpviewer_keywords: ["C3673"] -ms.assetid: bb6d2079-05af-4e2c-be0e-75c892e6c590 --- # Compiler Error C3673 -'type' : class does not have a copy-constructor +> 'type' : class does not have a copy-constructor + +## Remarks A user-defined constructor is needed to copy objects of CLR ref types. For more information, see [C++ Stack Semantics for Reference Types](../../dotnet/cpp-stack-semantics-for-reference-types.md). ## Examples -The following sample generates C3673. +The following example generates C3673. ```cpp // C3673.cpp @@ -32,7 +33,7 @@ int main() { } ``` -The following sample generates C3673. +The following example generates C3673. ```cpp // C3673_b.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3675.md b/docs/error-messages/compiler-errors-2/compiler-error-c3675.md index 8ef0cbf41f7..437cd7bb1ae 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3675.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3675.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Error C3675" title: "Compiler Error C3675" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3675" +ms.date: 11/04/2016 f1_keywords: ["C3675"] helpviewer_keywords: ["C3675"] -ms.assetid: 87461613-6633-430b-b95d-c7cb1bb63776 --- # Compiler Error C3675 -'function' : is reserved because 'property' is defined +> 'function' : is reserved because 'property' is defined + +## Remarks When you declare a simple property, the compiler generates the get and set accessor methods, and those names are present in the scope of your program. The compiler-generated names are formed by prepending get_ and set_ to the property name. Therefore, you cannot declare functions with the same name as the compiler-generated accessors. @@ -16,7 +17,7 @@ See [property](../../extensions/property-cpp-component-extensions.md) for more i ## Example -The following sample generates C3675. +The following example generates C3675. ```cpp // C3675.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3697.md b/docs/error-messages/compiler-errors-2/compiler-error-c3697.md index aa3cb7f3396..dbb5120276b 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3697.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3697.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C3697" title: "Compiler Error C3697" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3697" +ms.date: 11/04/2016 f1_keywords: ["C3697"] helpviewer_keywords: ["C3697"] -ms.assetid: 2d3f63c4-b7f8-421d-a7a5-2bf17fd054f9 --- # Compiler Error C3697 -'qualifier' : cannot use this qualifier on '^' +> 'qualifier' : cannot use this qualifier on '^' + +## Remarks The tracking handle (^) was applied to a qualifier for which it was not designed. -The following sample generates C3697: +## Example + +The following example generates C3697: ```cpp // C3697.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3698.md b/docs/error-messages/compiler-errors-2/compiler-error-c3698.md index f3be544edad..76dac5ebdc7 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3698.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3698.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C3698" title: "Compiler Error C3698" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3698" +ms.date: 11/04/2016 f1_keywords: ["C3698"] helpviewer_keywords: ["C3698"] -ms.assetid: 3c02fb08-7ba4-4637-a06f-19926cb2b5f1 --- # Compiler Error C3698 -'type' : cannot use this type as argument of 'operator' +> 'type' : cannot use this type as argument of 'operator' + +## Remarks A managed object was declared incorrectly. -The following sample generates C3698: +## Example + +The following example generates C3698: ```cpp // C3698.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3699.md b/docs/error-messages/compiler-errors-2/compiler-error-c3699.md index 98d2020bbf0..962b767cd4f 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3699.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3699.md @@ -1,20 +1,21 @@ --- -description: "Learn more about: Compiler Error C3699" title: "Compiler Error C3699" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3699" +ms.date: 11/04/2016 f1_keywords: ["C3699"] helpviewer_keywords: ["C3699"] -ms.assetid: 47c29afc-ab8b-4238-adfe-788dd6e00b3b --- # Compiler Error C3699 -'operator' : cannot use this indirection on type 'type' +> 'operator' : cannot use this indirection on type 'type' + +## Remarks An attempt was made to use indirection that is not allowed on `type`. ## Examples -The following sample generates C3699. +The following example generates C3699. ```cpp // C3699.cpp @@ -27,7 +28,7 @@ int main() { } ``` -A trivial property cannot have reference type. See [property](../../extensions/property-cpp-component-extensions.md) for more information. The following sample generates C3699. +A trivial property cannot have reference type. See [property](../../extensions/property-cpp-component-extensions.md) for more information. The following example generates C3699. ```cpp // C3699_b.cpp @@ -38,7 +39,7 @@ ref struct C { }; ``` -The equivalent of a "pointer to a pointer" syntax is a handle to a tracking reference. The following sample generates C3699. +The equivalent of a "pointer to a pointer" syntax is a handle to a tracking reference. The following example generates C3699. ```cpp // C3699_c.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3701.md b/docs/error-messages/compiler-errors-2/compiler-error-c3701.md index 5ddae9dc5cf..4194641c39f 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3701.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3701.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C3701" title: "Compiler Error C3701" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3701" +ms.date: 11/04/2016 f1_keywords: ["C3701"] helpviewer_keywords: ["C3701"] -ms.assetid: a7faaa87-d2f5-4d6a-9a2f-5cab2d24a648 --- # Compiler Error C3701 -'function' : event_source has no events +> 'function' : event_source has no events + +## Remarks You attempted to use [event_source](../../windows/attributes/event-source.md) on a class that has no event methods. To fix this error, add one or more events to the class. -The following sample generates C3701: +## Example + +The following example generates C3701: ```cpp // C3701.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3702.md b/docs/error-messages/compiler-errors-2/compiler-error-c3702.md index c405d39324e..8c101ecfb71 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3702.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3702.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C3702" title: "Compiler Error C3702" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3702" +ms.date: 11/04/2016 f1_keywords: ["C3702"] helpviewer_keywords: ["C3702"] -ms.assetid: 14fcc20e-4404-45d7-be54-e4f09332fa5a --- # Compiler Error C3702 -'function' : ATL is required for COM events +> 'function' : ATL is required for COM events + +## Remarks You attempted to use COM events without including the necessary ATL header files. -The following sample generates C3702: +## Example + +The following example generates C3702: ```cpp // C3702.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3703.md b/docs/error-messages/compiler-errors-2/compiler-error-c3703.md index 674971f02c2..3061a7f300e 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3703.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3703.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C3703" title: "Compiler Error C3703" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3703" +ms.date: 11/04/2016 f1_keywords: ["C3703"] helpviewer_keywords: ["C3703"] -ms.assetid: 7e3677d9-f2be-4c26-998f-423564e9023c --- # Compiler Error C3703 -'event handler': an event handler method must have the same storage class as the source 'event' +> 'event handler': an event handler method must have the same storage class as the source 'event' + +## Remarks An [event](../../cpp/event-handling.md) has a different storage class than the event handler to which it is hooked. For example, this error occurs if the event handler is a static member function and the event is not static. To fix this error, give the event and the event handler the same storage class. -The following sample generates C3703: +## Example + +The following example generates C3703: ```cpp // C3703.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3704.md b/docs/error-messages/compiler-errors-2/compiler-error-c3704.md index 619885fc8a2..7b218f85226 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3704.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3704.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C3704" title: "Compiler Error C3704" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3704" +ms.date: 11/04/2016 f1_keywords: ["C3704"] helpviewer_keywords: ["C3704"] -ms.assetid: ee40ea35-a214-4dec-9489-d7f155dd0ac2 --- # Compiler Error C3704 -'function' : a vararg method cannot fire events +> 'function' : a vararg method cannot fire events + +## Remarks + +You attempted to use [__event](../../cpp/event.md) on a vararg method. To fix this error, replace the `fireEvent(int i, ...)` call with the `fireEvent(int i)` call as shown in the following code example. -You attempted to use [__event](../../cpp/event.md) on a vararg method. To fix this error, replace the `fireEvent(int i, ...)` call with the `fireEvent(int i)` call as shown in the following code sample. +## Example -The following sample generates C3704: +The following example generates C3704: ```cpp // C3704.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3705.md b/docs/error-messages/compiler-errors-2/compiler-error-c3705.md index d0aafaf4e3d..7408c255823 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3705.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3705.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C3705" title: "Compiler Error C3705" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3705" +ms.date: 11/04/2016 f1_keywords: ["C3705"] helpviewer_keywords: ["C3705"] -ms.assetid: 8361017d-5782-4214-a9d7-e9825fd29bc8 --- # Compiler Error C3705 -'function' : cannot find eventing interface +> 'function' : cannot find eventing interface + +## Remarks + +You must define an event interface to use COM events. Note that the `#include` lines of the ATL header files shown in the example below are required for using COM events. To fix this error, uncomment the definition of the `IEvents` interface in the example code. -You must define an event interface to use COM events. Note that the `#include` lines of the ATL header files shown in the sample below are required for using COM events. To fix this error, uncomment the definition of the `IEvents` interface in the sample code. +## Example -The following sample generates C3705: +The following example generates C3705: ```cpp // C3705.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3706.md b/docs/error-messages/compiler-errors-2/compiler-error-c3706.md index 82e34020d09..3a64b432952 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3706.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3706.md @@ -1,22 +1,25 @@ --- -description: "Learn more about: Compiler Error C3706" title: "Compiler Error C3706" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3706" +ms.date: 11/04/2016 f1_keywords: ["C3706"] helpviewer_keywords: ["C3706"] -ms.assetid: d20a33eb-d625-46c5-ac87-32075a590d07 --- # Compiler Error C3706 -'function' : must be a COM interface to fire COM events +> 'function' : must be a COM interface to fire COM events + +## Remarks The event interface that you use to fire COM events must be a COM interface. In this situation, the interface should either be defined using a Visual C++ attribute, or imported using [#import](../../preprocessor/hash-import-directive-cpp.md) from a type library with #import's embedded_idl attribute. -Note that the `#include` lines of the ATL header files shown in the sample below are required for using COM events. To fix this error, make `IEvents` (the eventing interface) a COM interface by applying one of the following attributes to the interface definition: [object](../../windows/attributes/object-cpp.md), [dual](../../windows/attributes/dual.md), or [dispinterface](../../windows/attributes/dispinterface.md). +Note that the `#include` lines of the ATL header files shown in the example below are required for using COM events. To fix this error, make `IEvents` (the eventing interface) a COM interface by applying one of the following attributes to the interface definition: [object](../../windows/attributes/object-cpp.md), [dual](../../windows/attributes/dual.md), or [dispinterface](../../windows/attributes/dispinterface.md). If an interface is from a header file generated by MIDL, the compiler will not recognize it as a COM interface. -The following sample generates C3706: +## Example + +The following example generates C3706: ```cpp // C3706.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3707.md b/docs/error-messages/compiler-errors-2/compiler-error-c3707.md index 66e76dcccbd..1d3d66e45fa 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3707.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3707.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C3707" title: "Compiler Error C3707" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3707" +ms.date: 11/04/2016 f1_keywords: ["C3707"] helpviewer_keywords: ["C3707"] -ms.assetid: ac63a5dd-7a4b-48d2-9f2a-be9cb090134c --- # Compiler Error C3707 -'function' : dispinterface method must have a dispid +> 'function' : dispinterface method must have a dispid + +## Remarks + +If you use a `dispinterface` method, you must assign it a `dispid`. To fix this error, assign a `dispid` to the `dispinterface` method, for example, by uncommenting the `id` attribute on the method in the example below. For more information, see the attributes [dispinterface](../../windows/attributes/dispinterface.md) and [id](../../windows/attributes/id.md). -If you use a `dispinterface` method, you must assign it a `dispid`. To fix this error, assign a `dispid` to the `dispinterface` method, for example, by uncommenting the `id` attribute on the method in the sample below. For more information, see the attributes [dispinterface](../../windows/attributes/dispinterface.md) and [id](../../windows/attributes/id.md). +## Example -The following sample generates C3707: +The following example generates C3707: ```cpp // C3707.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3708.md b/docs/error-messages/compiler-errors-2/compiler-error-c3708.md index 4d171cc1b67..a611b94ccf0 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3708.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3708.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C3708" title: "Compiler Error C3708" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3708" +ms.date: 11/04/2016 f1_keywords: ["C3708"] helpviewer_keywords: ["C3708"] -ms.assetid: 45e71564-9c7f-437f-98d8-a735ce162ed0 --- # Compiler Error C3708 -'interface': improper use of 'keyword'; must be a member of a compatible event source +> 'interface': improper use of 'keyword'; must be a member of a compatible event source + +## Remarks To declare an interface as an event, the event declaration must be in an event source. -The following sample generates C3708: +## Example + +The following example generates C3708: ```cpp // C3708.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3709.md b/docs/error-messages/compiler-errors-2/compiler-error-c3709.md index c357f96034f..9c0750d1cc0 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3709.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3709.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C3709" title: "Compiler Error C3709" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3709" +ms.date: 11/04/2016 f1_keywords: ["C3709"] helpviewer_keywords: ["C3709"] -ms.assetid: d5576b04-2f93-420a-8f3e-8b8e987e8dab --- # Compiler Error C3709 -'function': improper syntax for specifying event in __hook/\__unhook +> 'function': improper syntax for specifying event in __hook/\__unhook + +## Remarks When you specify an event source with [__hook](../../cpp/hook.md) or [__unhook](../../cpp/unhook.md), the first parameter must be a valid event method and the second parameter must be a valid event source object (not a method). -The following sample generates C3709: +## Example + +The following example generates C3709: ```cpp // C3709.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3710.md b/docs/error-messages/compiler-errors-2/compiler-error-c3710.md index a3e0b13c6c7..7616ac9a947 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3710.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3710.md @@ -1,20 +1,21 @@ --- -description: "Learn more about: Compiler Error C3710" title: "Compiler Error C3710" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3710" +ms.date: 11/04/2016 f1_keywords: ["C3710"] helpviewer_keywords: ["C3710"] -ms.assetid: 18bec009-5b6f-464a-a21e-5d58a6936504 --- # Compiler Error C3710 -'function': improper syntax for specifying event handler in __hook/\__unhook +> 'function': improper syntax for specifying event handler in __hook/\__unhook + +## Remarks When you specify an event handler with [__hook](../../cpp/hook.md) or [__unhook](../../cpp/unhook.md), the handler must be a valid method. ## Example -The following sample generates C3710 +The following example generates C3710 ```cpp // C3710.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3711.md b/docs/error-messages/compiler-errors-2/compiler-error-c3711.md index 16b395e4bfd..8b7399ff2e6 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3711.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3711.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C3711" title: "Compiler Error C3711" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3711" +ms.date: 11/04/2016 f1_keywords: ["C3711"] helpviewer_keywords: ["C3711"] -ms.assetid: 26d581cc-2153-4ee0-b814-a371184be3e1 --- # Compiler Error C3711 -'method': an non-managed event source method must return void or an integral type +> 'method': an non-managed event source method must return void or an integral type + +## Remarks You defined a method in the event source that did not return void or an integral type. To fix this error, make the event and event handler have a return type of **`void`** or an integral type such as **`int`** or **`long`**. -The following sample generates C3711: +## Example + +The following example generates C3711: ```cpp // C3711.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3712.md b/docs/error-messages/compiler-errors-2/compiler-error-c3712.md index 99094e6ddab..d7ac31955f0 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3712.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3712.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C3712" title: "Compiler Error C3712" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3712" +ms.date: 11/04/2016 f1_keywords: ["C3712"] helpviewer_keywords: ["C3712"] -ms.assetid: 65b1fcaf-be89-4c55-9e40-25ec03457253 --- # Compiler Error C3712 -'method': an event handler method must return the same type as the source 'method' +> 'method': an event handler method must return the same type as the source 'method' + +## Remarks You defined an event handler method that did not return the same type as the source event method. To fix this error, give the event handler method the same return type as that of the source event method. -The following sample generates C3712: +## Example + +The following example generates C3712: ```cpp // C3712.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3713.md b/docs/error-messages/compiler-errors-2/compiler-error-c3713.md index 9ab74b96bbc..8949eafa8a0 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3713.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3713.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C3713" title: "Compiler Error C3713" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3713" +ms.date: 11/04/2016 f1_keywords: ["C3713"] helpviewer_keywords: ["C3713"] -ms.assetid: 75c6b9b6-955b-49bd-9bc8-ced88b496a1f --- # Compiler Error C3713 -'method': an event handler method must have the same function parameters as the source 'method' +> 'method': an event handler method must have the same function parameters as the source 'method' + +## Remarks You defined an event handler method that did not use the same parameters as the source event method. To fix this error, give the event handler method the same parameters as those of the source event method. -The following sample generates C3713: +## Example + +The following example generates C3713: ```cpp // C3713.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3714.md b/docs/error-messages/compiler-errors-2/compiler-error-c3714.md index 2f230ab4060..a623be6a03d 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3714.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3714.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C3714" title: "Compiler Error C3714" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3714" +ms.date: 11/04/2016 f1_keywords: ["C3714"] helpviewer_keywords: ["C3714"] -ms.assetid: 17718f75-5a37-4e42-912b-487e91008a95 --- # Compiler Error C3714 -'method': an event handler method must have the same calling convention as the source 'method' +> 'method': an event handler method must have the same calling convention as the source 'method' + +## Remarks You defined an event handler method that did not use the same calling convention as the source event method. To fix this error, give the event handler method the same calling conventions as those of the source event method. For example, in the code below, make the calling conventions of `handler1` and `event1` match ([__cdecl](../../cpp/cdecl.md) or [__stdcall](../../cpp/stdcall.md) or others). Removing calling convention keywords from both declarations will also solve the problem, and cause `event1` and `handler1` to default to the [thiscall](../../cpp/thiscall.md) calling convention. See [Calling Conventions](../../cpp/calling-conventions.md) for more information. -The following sample generates C3714: +## Example + +The following example generates C3714: ```cpp // C3714.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3715.md b/docs/error-messages/compiler-errors-2/compiler-error-c3715.md index 3357231814a..807db400d6b 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3715.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3715.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Compiler Error C3715" title: "Compiler Error C3715" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3715" +ms.date: 11/04/2016 f1_keywords: ["C3715"] helpviewer_keywords: ["C3715"] -ms.assetid: ee5dce88-ddc4-4bdb-9464-47467ce1674f --- # Compiler Error C3715 -'pointer': must be a pointer to 'class' +> 'pointer': must be a pointer to 'class' + +## Remarks You specified a pointer in [`__hook`](../../cpp/hook.md) or [`__unhook`](../../cpp/unhook.md) that did not point to a valid class. To fix this error, ensure that your **`__hook`** and **`__unhook`** calls specify pointers to valid classes. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3717.md b/docs/error-messages/compiler-errors-2/compiler-error-c3717.md index 6aead02f76c..26f54ec56c1 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3717.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3717.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C3717" title: "Compiler Error C3717" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3717" +ms.date: 11/04/2016 f1_keywords: ["C3717"] helpviewer_keywords: ["C3717"] -ms.assetid: ae4fceb1-2583-4577-b2f1-40971a017055 --- # Compiler Error C3717 -'method': a method that fires events cannot be defined +> 'method': a method that fires events cannot be defined + +## Remarks You declared an event method that includes an implementation. An [__event](../../cpp/event.md) method declaration cannot have a definition. To fix this error, ensure that no event method declarations have definitions. For example, in the code below, remove the function body from the `event1` declaration as indicated by the comments. -The following sample generates C3717: +## Example + +The following example generates C3717: ```cpp // C3717.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3718.md b/docs/error-messages/compiler-errors-2/compiler-error-c3718.md index ad3cb130088..63b08e810fb 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3718.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3718.md @@ -1,20 +1,21 @@ --- -description: "Learn more about: Compiler Error C3718" title: "Compiler Error C3718" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3718" +ms.date: 11/04/2016 f1_keywords: ["C3718"] helpviewer_keywords: ["C3718"] -ms.assetid: 346b5205-c44d-49d3-b66a-96417d3d6986 --- # Compiler Error C3718 > can only call '*event*' in the context of a member function of the receiving class +## Remarks + The event can only be called from the receiving class. ## Example -The following sample generates C3718: +The following example generates C3718: ```cpp // C3718.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3719.md b/docs/error-messages/compiler-errors-2/compiler-error-c3719.md index 777a99eabac..7dad0a67d1c 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3719.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3719.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C3719" title: "Compiler Error C3719" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3719" +ms.date: 11/04/2016 f1_keywords: ["C3719"] helpviewer_keywords: ["C3719"] -ms.assetid: d0d59d4e-babb-4480-9ef7-70cf1a28165c --- # Compiler Error C3719 -'interface': an interface based event source can only be used for COM events +> 'interface': an interface based event source can only be used for COM events + +## Remarks You declared an interface in a non-COM context. -The following sample generates C3719: +## Example + +The following example generates C3719: ```cpp // C3719a.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3721.md b/docs/error-messages/compiler-errors-2/compiler-error-c3721.md index fbfee81eae7..9b2aa843ac7 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3721.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3721.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Error C3721" title: "Compiler Error C3721" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3721" +ms.date: 11/04/2016 f1_keywords: ["C3721"] helpviewer_keywords: ["C3721"] -ms.assetid: c696ca38-3e00-4875-abbe-7bce0f46930e --- # Compiler Error C3721 -'signature': incompatible signature for event +> 'signature': incompatible signature for event + +## Remarks An event was declared incorrectly. For more information, see [__event](../../cpp/event.md). diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3722.md b/docs/error-messages/compiler-errors-2/compiler-error-c3722.md index c526c8d8924..e852c92d29f 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3722.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3722.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C3722" title: "Compiler Error C3722" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3722" +ms.date: 11/04/2016 f1_keywords: ["C3722"] helpviewer_keywords: ["C3722"] -ms.assetid: 3cb28363-5eff-4548-bd0d-d5c615846353 --- # Compiler Error C3722 -a generic event is not allowed +> a generic event is not allowed + +## Remarks The compiler only allows generic classes, structs, and functions. For more information, see [Generics](../../extensions/generics-cpp-component-extensions.md). -The following sample generates C3722: +## Example + +The following example generates C3722: ```cpp // C3722.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3723.md b/docs/error-messages/compiler-errors-2/compiler-error-c3723.md index 1723435e049..c40274a831f 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3723.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3723.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C3723" title: "Compiler Error C3723" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3723" +ms.date: 11/04/2016 f1_keywords: ["C3723"] helpviewer_keywords: ["C3723"] -ms.assetid: ef0fb1ff-3f9a-4093-a6b6-894d1ab0c4b9 --- # Compiler Error C3723 > 'function': could not resolve event +## Remarks + `function` could not resolve which event to call. -The following sample generates C3723: +## Examples + +The following example generates C3723: ```cpp // C3723.cpp @@ -37,7 +40,7 @@ int main() { **`__hook`** and **`__unhook`** are not compatible with **`/clr`** programming. Use the += and -= operators instead. -The following sample generates C3723: +The following example generates C3723: ```cpp // C3723b.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3724.md b/docs/error-messages/compiler-errors-2/compiler-error-c3724.md index 227b770bdc2..78cc2f268c4 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3724.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3724.md @@ -1,17 +1,22 @@ --- -description: "Learn more about: Compiler Error C3724" title: "Compiler Error C3724" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3724" +ms.date: 11/04/2016 f1_keywords: ["C3724"] helpviewer_keywords: ["C3724"] -ms.assetid: cab8aba7-14fc-406f-8cc6-32744c8f31c1 --- # Compiler Error C3724 -must #include \ to use multi-threading with events +> must #include \ to use multi-threading with events + +## Remarks The windows.h file is required if you use multi-threading with events. To fix this error, add `#include ` to the top of the file in which event sources and event receivers are defined. +## Example + +The following example generates C3724: + ```cpp // C3724.cpp // uncomment the following line to resolve diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3727.md b/docs/error-messages/compiler-errors-2/compiler-error-c3727.md index 9bd6172470b..a431ad71bcc 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3727.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3727.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Compiler Error C3727" title: "Compiler Error C3727" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3727" +ms.date: 11/04/2016 f1_keywords: ["C3727"] helpviewer_keywords: ["C3727"] -ms.assetid: 17b9fe7b-ee9e-483f-9c27-1f709255a9e0 --- # Compiler Error C3727 -'event': a managed event must be a member function or a data member that is a pointer to a delegate +> 'event': a managed event must be a member function or a data member that is a pointer to a delegate + +## Remarks .NET events must be a pointer to a delegate type. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3728.md b/docs/error-messages/compiler-errors-2/compiler-error-c3728.md index a99650d9999..a67b6d6b90c 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3728.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3728.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Error C3728" title: "Compiler Error C3728" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3728" +ms.date: 11/04/2016 f1_keywords: ["C3728"] helpviewer_keywords: ["C3728"] -ms.assetid: 6b510cb1-887f-4fcd-9a1f-3bb720417ed1 --- # Compiler Error C3728 -'event': event does not have a raise method +> 'event': event does not have a raise method + +## Remarks Metadata created with a language, such as C#, that does not allow an event to be raised from outside the class in which it was defined, was included with the [#using](../../preprocessor/hash-using-directive-cpp.md) directive, and a Visual C++ program using CLR programming attempted to raise the event. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3731.md b/docs/error-messages/compiler-errors-2/compiler-error-c3731.md index 3336cfa957f..7b8d9f51f09 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3731.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3731.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C3731" title: "Compiler Error C3731" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3731" +ms.date: 11/04/2016 f1_keywords: ["C3731"] helpviewer_keywords: ["C3731"] -ms.assetid: 45f89fcd-464c-4bc8-8a42-edcb5416d26c --- # Compiler Error C3731 -incompatible event 'function1' and handler 'function2'; event source and event handler must be the same type +> incompatible event 'function1' and handler 'function2'; event source and event handler must be the same type + +## Remarks The event source and event receiver must have the same type (for example `native` vs. `com` types). To fix this error, make the types of the event source and the event handler match. -The following sample generates C3731: +## Example + +The following example generates C3731: ```cpp // C3731.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3732.md b/docs/error-messages/compiler-errors-2/compiler-error-c3732.md index 5b02bbd1e22..b8a783b4e74 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3732.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3732.md @@ -1,17 +1,20 @@ --- -description: "Learn more about: Compiler Error C3732" title: "Compiler Error C3732" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3732" +ms.date: 11/04/2016 f1_keywords: ["C3732"] helpviewer_keywords: ["C3732"] -ms.assetid: 2d55a7e1-9c39-4379-a093-2f7beb27e2ca --- # Compiler Error C3732 -'interface': a custom interface that fires COM events cannot inherit from IDispatch +> 'interface': a custom interface that fires COM events cannot inherit from IDispatch + +## Remarks An interface that supports COM events cannot inherit from `IDispatch`. For more information, see [Event Handling in COM](../../cpp/event-handling-in-com.md). +## Example + The following error generates C3732: ```cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3733.md b/docs/error-messages/compiler-errors-2/compiler-error-c3733.md index 7a889e735f7..e5fdcabd78d 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3733.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3733.md @@ -1,20 +1,23 @@ --- -description: "Learn more about: Compiler Error C3733" title: "Compiler Error C3733" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3733" +ms.date: 11/04/2016 f1_keywords: ["C3733"] helpviewer_keywords: ["C3733"] -ms.assetid: 0cc1a9fe-1400-4be3-b35a-16435cba7a5a --- # Compiler Error C3733 -'event': improper syntax for specifying a COM event; did you forget '__interface'? +> 'event': improper syntax for specifying a COM event; did you forget '__interface'? + +## Remarks The wrong syntax was used for a COM event. To fix this error, change the event type or correct the syntax to comply with the COM event rules. -The following sample generates C3733: +## Example -``` +The following example generates C3733: + +```cpp #define _ATL_ATTRIBUTES 1 #include "atlbase.h" #include "atlcom.h" diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3734.md b/docs/error-messages/compiler-errors-2/compiler-error-c3734.md index e324edba416..3b4e5624503 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3734.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3734.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C3734" title: "Compiler Error C3734" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3734" +ms.date: 11/04/2016 f1_keywords: ["C3734"] helpviewer_keywords: ["C3734"] -ms.assetid: 4e2afdcc-7da9-45a1-9c96-85f25e2986e8 --- # Compiler Error C3734 -'class': a managed or WinRT class cannot be a coclass +> 'class': a managed or WinRT class cannot be a coclass + +## Remarks The [coclass](../../windows/attributes/coclass.md) attribute cannot be used with managed or WinRT classes. -The following sample generates C3734 and shows how to fix it: +## Example + +The following example generates C3734 and shows how to fix it: ```cpp // C3734.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3736.md b/docs/error-messages/compiler-errors-2/compiler-error-c3736.md index fcd2b8d333d..e95ba8acaf9 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3736.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3736.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C3736" title: "Compiler Error C3736" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3736" +ms.date: 11/04/2016 f1_keywords: ["C3736"] helpviewer_keywords: ["C3736"] -ms.assetid: 579b773c-41e7-40ea-8382-2e3ce2667f4c --- # Compiler Error C3736 -'event': must be a method or, in the case of managed events, optionally a data member +> 'event': must be a method or, in the case of managed events, optionally a data member + +## Remarks Native and COM events must be methods. .NET events can also be data members. -The following sample generates C3736: +## Example + +The following example generates C3736: ```cpp // C3736.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3737.md b/docs/error-messages/compiler-errors-2/compiler-error-c3737.md index b6b4efa9ffc..1ca3f1a46cf 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3737.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3737.md @@ -1,20 +1,21 @@ --- -description: "Learn more about: Compiler Error C3737" title: "Compiler Error C3737" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3737" +ms.date: 11/04/2016 f1_keywords: ["C3737"] helpviewer_keywords: ["C3737"] -ms.assetid: ca2aeb23-2491-4ccb-8838-884abf7065c8 --- # Compiler Error C3737 -'delegate': a delegate may not have an explicit calling convention +> 'delegate': a delegate may not have an explicit calling convention + +## Remarks You cannot specify the [calling convention](../../cpp/calling-conventions.md) for a **`delegate`**. ## Example -The following sample generates C3737: +The following example generates C3737: ```cpp // C3737a.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3738.md b/docs/error-messages/compiler-errors-2/compiler-error-c3738.md index 319585c5184..d31a1c9b75a 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3738.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3738.md @@ -1,20 +1,21 @@ --- -description: "Learn more about: Compiler Error C3738" title: "Compiler Error C3738" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3738" +ms.date: 11/04/2016 f1_keywords: ["C3738"] helpviewer_keywords: ["C3738"] -ms.assetid: dd3ee011-e204-4264-bf3a-da32c4ef7038 --- # Compiler Error C3738 -'calling_convention': the calling convention of the explicit instantiation must match that of the template being instantiated +> 'calling_convention': the calling convention of the explicit instantiation must match that of the template being instantiated + +## Remarks It is recommended that you do not specify a calling convention on an explicit instantiation. If you must, though, the calling conventions must match. ## Example -The following sample generates C3738. +The following example generates C3738. ```cpp // C3738.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3739.md b/docs/error-messages/compiler-errors-2/compiler-error-c3739.md index 88b29cba22b..f666f3bdc4b 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3739.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3739.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C3739" title: "Compiler Error C3739" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3739" +ms.date: 11/04/2016 f1_keywords: ["C3739"] helpviewer_keywords: ["C3739"] -ms.assetid: acffe894-08b8-4bf2-9249-9501e6e2bad3 --- # Compiler Error C3739 -'class': syntax is only supported when the 'layout_dependent' parameter of event_receiver is true +> 'class': syntax is only supported when the 'layout_dependent' parameter of event_receiver is true + +## Remarks You tried to hook an entire interface of events but `layout_dependent` on [event_receiver](../../windows/attributes/event-receiver.md) attribute is not true; you must hook a single event at a time. -The following sample generates C3739: +## Example + +The following example generates C3739: ```cpp // C3739.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3740.md b/docs/error-messages/compiler-errors-2/compiler-error-c3740.md index a660236cdf5..b71adc946a8 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3740.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3740.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C3740" title: "Compiler Error C3740" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3740" +ms.date: 11/04/2016 f1_keywords: ["C3740"] helpviewer_keywords: ["C3740"] -ms.assetid: edb17a90-2307-4df6-943d-580460d26d2b --- # Compiler Error C3740 -templates cannot source or receive events +> templates cannot source or receive events + +## Remarks A templated class or struct cannot contain [events](../../cpp/event-handling.md). -The following sample generates C3740: +## Example + +The following example generates C3740: ```cpp // C3740.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3741.md b/docs/error-messages/compiler-errors-2/compiler-error-c3741.md index eda0e59dd9b..9fabe12afba 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3741.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3741.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C3741" title: "Compiler Error C3741" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3741" +ms.date: 11/04/2016 f1_keywords: ["C3741"] helpviewer_keywords: ["C3741"] -ms.assetid: ed311315-cc32-49c9-97fa-01b293d81526 --- # Compiler Error C3741 -'class': must be a coclass when the 'layout_dependent' parameter of event_receiver = true +> 'class': must be a coclass when the 'layout_dependent' parameter of event_receiver = true + +## Remarks When `layout_dependent=true` for an [event_receiver](../../windows/attributes/event-receiver.md) class, then the class must also have the [coclass](../../windows/attributes/coclass.md) attribute. -The following sample generates C3741 +## Example + +The following example generates C3741 ```cpp // C3741.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3743.md b/docs/error-messages/compiler-errors-2/compiler-error-c3743.md index 6cabeee37af..eeb1dc1a848 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3743.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3743.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C3743" title: "Compiler Error C3743" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3743" +ms.date: 11/04/2016 f1_keywords: ["C3743"] helpviewer_keywords: ["C3743"] -ms.assetid: 7ca9a76e-7b60-46d1-ab8b-18600cf1a306 --- # Compiler Error C3743 -can only hook/unhook an entire interface when the 'layout_dependent' parameter of event_receiver is true +> can only hook/unhook an entire interface when the 'layout_dependent' parameter of event_receiver is true + +## Remarks The [__unhook](../../cpp/unhook.md) function varies in the number of parameters that it takes based on the value passed to the `layout_dependent` parameter in the [event_receiver](../../windows/attributes/event-receiver.md) class. -The following sample generates C3743: +## Example + +The following example generates C3743: ```cpp // C3743.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3744.md b/docs/error-messages/compiler-errors-2/compiler-error-c3744.md index 289ae4d140b..7edb6d976b9 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3744.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3744.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Error C3744" title: "Compiler Error C3744" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3744" +ms.date: 11/04/2016 f1_keywords: ["C3744"] helpviewer_keywords: ["C3744"] -ms.assetid: a447d050-80d1-406a-9a6e-f15c527d717c --- # Compiler Error C3744 -__unhook must have at least 3 arguments for managed events +> __unhook must have at least 3 arguments for managed events + +## Remarks The [`__unhook`](../../cpp/unhook.md) function must take three parameters when used in a program that is compiled for Managed Extensions for C++. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3745.md b/docs/error-messages/compiler-errors-2/compiler-error-c3745.md index 1959d9bdeca..480fca90e6a 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3745.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3745.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C3745" title: "Compiler Error C3745" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3745" +ms.date: 11/04/2016 f1_keywords: ["C3745"] helpviewer_keywords: ["C3745"] -ms.assetid: 1e64aec5-7e53-47e5-bc7d-3905230cfc66 --- # Compiler Error C3745 -'function': only an event can be 'raised' +> 'function': only an event can be 'raised' + +## Remarks Only a function defined with the [__event](../../cpp/event.md) keyword can be passed to the [__raise](../../cpp/raise.md) keyword. -The following sample generates C3745: +## Example + +The following example generates C3745: ```cpp // C3745.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3747.md b/docs/error-messages/compiler-errors-2/compiler-error-c3747.md index 0b9fbeab007..deba5ccb381 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3747.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3747.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C3747" title: "Compiler Error C3747" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3747" +ms.date: 11/04/2016 f1_keywords: ["C3747"] helpviewer_keywords: ["C3747"] -ms.assetid: a9a4be67-5d9c-4dcc-9ae9-baae46cbecde --- # Compiler Error C3747 -missing default type parameter : parameter param +> missing default type parameter : parameter param + +## Remarks Generic or template parameters with default values cannot be followed in the parameter list by parameters that do not have default values. -The following sample generates C3747: +## Example + +The following example generates C3747: ```cpp // C3747.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3748.md b/docs/error-messages/compiler-errors-2/compiler-error-c3748.md index f2f54266dfc..ba2b46ba8f0 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3748.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3748.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C3748" title: "Compiler Error C3748" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3748" +ms.date: 11/04/2016 f1_keywords: ["C3748"] helpviewer_keywords: ["C3748"] -ms.assetid: 6fe71a0a-dd93-4ce6-9729-b9616360cf34 --- # Compiler Error C3748 -'interface': managed interfaces may not fire events +> 'interface': managed interfaces may not fire events + +## Remarks The [__event](../../cpp/event.md) keyword cannot appear inside an interface. -The following sample generates C3748: +## Example + +The following example generates C3748: ```cpp // C3748.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3749.md b/docs/error-messages/compiler-errors-2/compiler-error-c3749.md index d31c3c0c67a..605a68c8fc6 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3749.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3749.md @@ -1,20 +1,21 @@ --- -description: "Learn more about: Compiler Error C3749" title: "Compiler Error C3749" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3749" +ms.date: 11/04/2016 f1_keywords: ["C3749"] helpviewer_keywords: ["C3749"] -ms.assetid: 3d26b468-4757-41b8-b5a2-78022a5295fb --- # Compiler Error C3749 -'attribute': a custom attribute may not be used inside a function +> 'attribute': a custom attribute may not be used inside a function + +## Remarks A custom attribute cannot be used inside a function. For more information on custom attributes, see the topic [attribute](../../windows/attributes/attribute.md). ## Example -The following sample generates C3749: +The following example generates C3749: ```cpp // C3749a.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3752.md b/docs/error-messages/compiler-errors-2/compiler-error-c3752.md index 31df4234c49..3e8f4de3350 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3752.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3752.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Compiler Error C3752" title: "Compiler Error C3752" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3752" +ms.date: 11/04/2016 f1_keywords: ["C3752"] helpviewer_keywords: ["C3752"] -ms.assetid: 1ac81d85-0f5a-4f39-95b6-42fd43cb18d5 --- # Compiler Error C3752 -'attribute class': cannot classify attribute; 'keyword' should not be used in this context +> 'attribute class': cannot classify attribute; 'keyword' should not be used in this context + +## Remarks A user-defined attribute was applied incorrectly. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3753.md b/docs/error-messages/compiler-errors-2/compiler-error-c3753.md index 54464a9469b..a455bba26fb 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3753.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3753.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Error C3753" title: "Compiler Error C3753" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3753" +ms.date: 11/04/2016 f1_keywords: ["C3753"] helpviewer_keywords: ["C3753"] -ms.assetid: a5b99e28-796c-4107-a673-97c2ae3bb2b9 --- # Compiler Error C3753 -a generic property is not allowed +> a generic property is not allowed + +## Remarks Generic parameter lists can only appear on managed classes, structs, or functions. @@ -16,7 +17,7 @@ For more information, see [Generics](../../extensions/generics-cpp-component-ext ## Example -The following sample generates C3753. +The following example generates C3753. ```cpp // C3753.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3754.md b/docs/error-messages/compiler-errors-2/compiler-error-c3754.md index f35e3c280a1..648b8bd64e0 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3754.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3754.md @@ -1,20 +1,21 @@ --- -description: "Learn more about: Compiler Error C3754" title: "Compiler Error C3754" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3754" +ms.date: 11/04/2016 f1_keywords: ["C3754"] helpviewer_keywords: ["C3754"] -ms.assetid: 14b877bc-9277-40ec-af1c-196a58b45f10 --- # Compiler Error C3754 -delegate constructor: member function 'function' cannot be called on an instance of type 'type' +> delegate constructor: member function 'function' cannot be called on an instance of type 'type' + +## Remarks A call was made to a function through a pointer to a type that does not contain the function. ## Example -The following sample generates C3754: +The following example generates C3754: ```cpp // C3754a.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3755.md b/docs/error-messages/compiler-errors-2/compiler-error-c3755.md index 0f31bab3a5a..2ef2709d235 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3755.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3755.md @@ -1,20 +1,21 @@ --- -description: "Learn more about: Compiler Error C3755" title: "Compiler Error C3755" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3755" +ms.date: 11/04/2016 f1_keywords: ["C3755"] helpviewer_keywords: ["C3755"] -ms.assetid: 9317b55e-a52e-4b87-b915-5a208d6eda38 --- # Compiler Error C3755 -'delegate': a delegate may not be defined +> 'delegate': a delegate may not be defined + +## Remarks A [delegate (C++ Component Extensions)](../../extensions/delegate-cpp-component-extensions.md) can be declared but not defined. ## Examples -The following sample generates C3755. +The following example generates C3755. ```cpp // C3755.cpp @@ -22,7 +23,7 @@ The following sample generates C3755. delegate void MyDel() {}; // C3755 ``` -C3755 can also occur if you attempt to create a delegate template. The following sample generates C3755. +C3755 can also occur if you attempt to create a delegate template. The following example generates C3755. ```cpp // C3755_b.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3761.md b/docs/error-messages/compiler-errors-2/compiler-error-c3761.md index 3b30366f458..7e0d0f90e8d 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3761.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3761.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C3761" title: "Compiler Error C3761" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3761" +ms.date: 11/04/2016 f1_keywords: ["C3761"] helpviewer_keywords: ["C3761"] -ms.assetid: 0c16f093-7a78-4838-b90b-0c67ef6e9270 --- # Compiler Error C3761 -'function': 'retval' can only appear on the last argument of a function +> 'function': 'retval' can only appear on the last argument of a function + +## Remarks The [retval](../../windows/attributes/retval.md) attribute was used on a function argument that was not the last argument in the list. -The following sample generates C3761: +## Example + +The following example generates C3761: ```cpp // C3761.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3762.md b/docs/error-messages/compiler-errors-2/compiler-error-c3762.md index 03925fb2115..a732ee83512 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3762.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3762.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Compiler Error C3762" title: "Compiler Error C3762" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3762" +ms.date: 11/04/2016 f1_keywords: ["C3762"] helpviewer_keywords: ["C3762"] -ms.assetid: b79b6506-2cea-44a0-855a-5fdcb9fd7ad9 --- # Compiler Error C3762 -unable to process attribute 'attribute' +> unable to process attribute 'attribute' + +## Remarks A user-defined attribute that inherits from `System.Security.Permissions.SecurityAttribute` is being used to define a security attribute. Such an attribute cannot be used in the same assembly where it is defined. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3763.md b/docs/error-messages/compiler-errors-2/compiler-error-c3763.md index 0166ca13a41..f056026f670 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3763.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3763.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C3763" title: "Compiler Error C3763" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3763" +ms.date: 11/04/2016 f1_keywords: ["C3763"] helpviewer_keywords: ["C3763"] -ms.assetid: 58b1f079-cd1d-46e0-9431-ea18210106b7 --- # Compiler Error C3763 -'type': 'retval' and 'out' can only appear on a data-pointer type +> 'type': 'retval' and 'out' can only appear on a data-pointer type + +## Remarks The [out](../../windows/attributes/out-cpp.md) or [retval](../../windows/attributes/retval.md) attributes can only appear on parameters of type pointer. Either remove the attribute or make the parameter of type pointer. -The following sample generates C3763: +## Example + +The following example generates C3763: ```cpp // C3763.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3764.md b/docs/error-messages/compiler-errors-2/compiler-error-c3764.md index ea866633a68..aa4d0782cbc 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3764.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3764.md @@ -1,20 +1,21 @@ --- -description: "Learn more about: Compiler Error C3764" title: "Compiler Error C3764" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3764" +ms.date: 11/04/2016 f1_keywords: ["C3764"] helpviewer_keywords: ["C3764"] -ms.assetid: af5d254c-8d4a-4dda-aad9-3c5c1257c868 --- # Compiler Error C3764 -'override_function': cannot override base class method 'base_class_function' +> 'override_function': cannot override base class method 'base_class_function' + +## Remarks The compiler detected an ill-formed override. For example, the base class function was not **`virtual`**. For more information, see [override](../../extensions/override-cpp-component-extensions.md). ## Examples -The following sample generates C3764. +The following example generates C3764. ```cpp // C3764.cpp @@ -30,7 +31,7 @@ public ref struct B : A { }; ``` -C3764 can also occur when a base class method is both explicitly and named overridden. The following sample generates C3764. +C3764 can also occur when a base class method is both explicitly and named overridden. The following example generates C3764. ```cpp // C3764_b.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3765.md b/docs/error-messages/compiler-errors-2/compiler-error-c3765.md index 6091aaa1b07..cba25055ecc 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3765.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3765.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C3765" title: "Compiler Error C3765" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3765" +ms.date: 11/04/2016 f1_keywords: ["C3765"] helpviewer_keywords: ["C3765"] -ms.assetid: feadee7a-fcfb-402c-af2f-0e656f814a13 --- # Compiler Error C3765 -'event': cannot define an event in a class/struct 'type' marked as an event_receiver +> 'event': cannot define an event in a class/struct 'type' marked as an event_receiver + +## Remarks If a class is marked with the [event_receiver](../../windows/attributes/event-receiver.md) attribute, the class cannot contain an [__event](../../cpp/event.md) declaration. -The following sample generates C3765: +## Example + +The following example generates C3765: ```cpp // C3765.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3766.md b/docs/error-messages/compiler-errors-2/compiler-error-c3766.md index 9e4127d7f5d..996e2b80d35 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3766.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3766.md @@ -1,20 +1,21 @@ --- -description: "Learn more about: Compiler Error C3766" title: "Compiler Error C3766" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3766" +ms.date: 11/04/2016 f1_keywords: ["C3766"] helpviewer_keywords: ["C3766"] -ms.assetid: b5af2089-2e1e-4e45-a41d-495b6c55656e --- # Compiler Error C3766 -'type' must provide an implementation for the interface method 'function' +> 'type' must provide an implementation for the interface method 'function' + +## Remarks A class that inherits from an interface must implement the interface members. ## Example -The following sample generates C3766. +The following example generates C3766. ```cpp // C3766.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3767.md b/docs/error-messages/compiler-errors-2/compiler-error-c3767.md index 9a9ed09b2b3..c3019dc8a11 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3767.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3767.md @@ -1,22 +1,23 @@ --- -description: "Learn more about: Compiler Error C3767" title: "Compiler Error C3767" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3767" +ms.date: 11/04/2016 f1_keywords: ["C3767"] helpviewer_keywords: ["C3767"] -ms.assetid: 5247cdcd-639c-4527-bd37-37e74c4e8fab --- # Compiler Error C3767 -'function' candidate function(s) not accessible +> 'function' candidate function(s) not accessible + +## Remarks A friend function defined in a class is not supposed to be treated as if it were defined and declared in the global namespace scope. It can, however, be found by argument-dependent lookup. C3767 may also be caused by a breaking change: native types are now private by default in a **/clr** compilation; see [Type visibility](../../dotnet/how-to-define-and-consume-classes-and-structs-cpp-cli.md#BKMK_Type_visibility) for more information. -## Example +## Examples -The following sample generates C3767: +The following example generates C3767: ```cpp // C3767a.cpp @@ -47,7 +48,7 @@ int main() { }; ``` -The following sample generates C3767: +The following example generates C3767: ```cpp // C3767c.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3768.md b/docs/error-messages/compiler-errors-2/compiler-error-c3768.md index 8bf47793aea..0d49df0bf52 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3768.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3768.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3768" title: "Compiler Error C3768" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3768" +ms.date: 11/04/2016 f1_keywords: ["C3768"] helpviewer_keywords: ["C3768"] -ms.assetid: 091f0d53-1dff-43fd-813d-5c43c85b6ab0 --- # Compiler Error C3768 @@ -18,7 +17,7 @@ When compiling with **/clr:pure**, you cannot take the address of a virtual `var ## Example -The following sample generates C3768: +The following example generates C3768: ```cpp // C3768.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3769.md b/docs/error-messages/compiler-errors-2/compiler-error-c3769.md index 47aa0fda651..1109fddfcde 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3769.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3769.md @@ -1,20 +1,21 @@ --- -description: "Learn more about: Compiler Error C3769" title: "Compiler Error C3769" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3769" +ms.date: 11/04/2016 f1_keywords: ["C3769"] helpviewer_keywords: ["C3769"] -ms.assetid: 341675e1-7428-4da6-8275-1b2f0a70dacc --- # Compiler Error C3769 -'type' : a nested class cannot have the same name as the immediately enclosing class +> 'type' : a nested class cannot have the same name as the immediately enclosing class + +## Remarks A nested class cannot have the same name as the immediately enclosing class. ## Example -The following sample generates C3769. +The following example generates C3769. ```cpp // C3769.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3771.md b/docs/error-messages/compiler-errors-2/compiler-error-c3771.md index 3daf52e4047..3b950fed268 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3771.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3771.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Error C3771" title: "Compiler Error C3771" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3771" +ms.date: 11/04/2016 f1_keywords: ["C3771"] helpviewer_keywords: ["C3771"] -ms.assetid: 68c23b25-7f21-4eaa-8f7e-38fda1130a69 --- # Compiler Error C3771 -"identifier" : friend declaration cannot be found in the nearest namespace scope +> "identifier" : friend declaration cannot be found in the nearest namespace scope + +## Remarks The class template declaration for the specified template *identifier* cannot be found within the current namespace. @@ -26,7 +27,7 @@ The following code example declares a class template and function in namespace ` namespace NA { template class A { - void aFunction(T t) {}; + void aFunction(T t) {} }; } // using namespace NA; diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3772.md b/docs/error-messages/compiler-errors-2/compiler-error-c3772.md index 042a708d93a..1cf537711b4 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3772.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3772.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Error C3772" title: "Compiler Error C3772" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3772" +ms.date: 11/04/2016 f1_keywords: ["C3772"] helpviewer_keywords: ["C3772"] -ms.assetid: 63e938d4-088d-41cc-a562-5881a05b5710 --- # Compiler Error C3772 -"name" : invalid friend template declaration +> "name" : invalid friend template declaration + +## Remarks It is invalid to declare a friend of a class template specialization. You cannot declare an explicit or partial specialization of a class template and in the same statement declare a friend of that specialization. The *name* placeholder identifies the invalid declaration. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3779.md b/docs/error-messages/compiler-errors-2/compiler-error-c3779.md index 1f113ff903b..b1029535d73 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3779.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3779.md @@ -1,6 +1,6 @@ --- -description: "Learn more about: Compiler Error C3779" title: "Compiler Error C3779" +description: "Learn more about: Compiler Error C3779" ms.date: 05/19/2021 f1_keywords: ["C3779"] helpviewer_keywords: ["C3779"] @@ -9,15 +9,15 @@ helpviewer_keywords: ["C3779"] > '*function*': a function that returns '*auto or decltype(auto)*' cannot be used before it is defined -The **`auto`** return type of the specified function call couldn't be deduced. The compiler didn't have enough information at the call site. - ## Remarks +The **`auto`** return type of the specified function call couldn't be deduced. The compiler didn't have enough information at the call site. + This error can occur when you call a forward-declared member function that has an **`auto`** return type but no body or trailing return type. You can also get this error when the compiler can't find a candidate return type when it instantiates a template specialization. A common cause of this error is a missing interface header. The missing type can often be determined from the typename mentioned in a note that follows this error. To resolve this issue, for every type you use, include the header for the namespace the type is in. -## Examples +## Example -The following C++/WinRT sample generates C3779: +The following C++/WinRT example generates C3779: ```cpp // C3779.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3797.md b/docs/error-messages/compiler-errors-2/compiler-error-c3797.md index 22e95517bff..fd98c9b12f8 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3797.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3797.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Error C3797" title: "Compiler Error C3797" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3797" +ms.date: 11/04/2016 f1_keywords: ["C3797"] helpviewer_keywords: ["C3797"] -ms.assetid: ab27ff34-8c1d-4297-b004-9e39bd3a4f25 --- # Compiler Error C3797 -'override': event declaration cannot have override specifier (should be placed on event add/remove/raise methods instead) +> 'override': event declaration cannot have override specifier (should be placed on event add/remove/raise methods instead) + +## Remarks You cannot override a trivial event (an event without explicitly defined accessor methods) with another trivial event. The overriding event must define its behavior with accessor functions. @@ -16,7 +17,7 @@ For more information, see [event](../../extensions/event-cpp-component-extension ## Example -The following sample generates C3797. +The following example generates C3797. ```cpp // C3797.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3798.md b/docs/error-messages/compiler-errors-2/compiler-error-c3798.md index c0916d81b5b..40ce4ddd31b 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3798.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3798.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Error C3798" title: "Compiler Error C3798" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3798" +ms.date: 11/04/2016 f1_keywords: ["C3798"] helpviewer_keywords: ["C3798"] -ms.assetid: b2f8b1d8-8812-49b8-a346-28e48f02ba5c --- # Compiler Error C3798 -'specifier': property declaration cannot have override specifier (should be placed on property get/set methods instead) +> 'specifier': property declaration cannot have override specifier (should be placed on property get/set methods instead) + +## Remarks A property was declared incorrectly. For more information, see @@ -20,7 +21,7 @@ A property was declared incorrectly. For more information, see ## Example -The following sample generates C3798 +The following example generates C3798 ```cpp // C3798.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3799.md b/docs/error-messages/compiler-errors-2/compiler-error-c3799.md index 7a9f3980f9e..7824ef85cb5 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3799.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3799.md @@ -1,20 +1,21 @@ --- -description: "Learn more about: Compiler Error C3799" title: "Compiler Error C3799" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3799" +ms.date: 11/04/2016 f1_keywords: ["C3799"] helpviewer_keywords: ["C3799"] -ms.assetid: 336a2811-9370-4e6e-b03b-325bda470805 --- # Compiler Error C3799 -indexed property cannot have an empty parameter list +> indexed property cannot have an empty parameter list + +## Remarks An indexed property was declared incorrectly. For more information, see [How to: Use Properties in C++/CLI](../../dotnet/how-to-use-properties-in-cpp-cli.md). ## Example -The following sample generates C3799 and shows how to fix it. +The following example generates C3799 and shows how to fix it. ```cpp // C3799.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3800.md b/docs/error-messages/compiler-errors-2/compiler-error-c3800.md index 4d21036576b..c2bf14ce9aa 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3800.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3800.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Error C3800" title: "Compiler Error C3800" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3800" +ms.date: 11/04/2016 f1_keywords: ["C3800"] helpviewer_keywords: ["C3800"] -ms.assetid: c653240a-b6db-4437-8d65-fa58f0e6fcf4 --- # Compiler Error C3800 -'declaration': cannot mix properties and events +> 'declaration': cannot mix properties and events + +## Remarks You cannot declare a construct to be both a property and an event. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3803.md b/docs/error-messages/compiler-errors-2/compiler-error-c3803.md index af817ec77d1..367696019e8 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3803.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3803.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C3803" title: "Compiler Error C3803" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3803" +ms.date: 11/04/2016 f1_keywords: ["C3803"] helpviewer_keywords: ["C3803"] -ms.assetid: bad5fb9a-ed9a-4c15-96e7-cf06e200a50d --- # Compiler Error C3803 -'property': property has a type that is incompatible with one of its accessors 'accessor' +> 'property': property has a type that is incompatible with one of its accessors 'accessor' + +## Remarks The type of a property defined with [property](../../cpp/property-cpp.md) does not match the return type for one of its accessor functions. -The following sample generates C3803: +## Example + +The following example generates C3803: ```cpp // C3803.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3804.md b/docs/error-messages/compiler-errors-2/compiler-error-c3804.md index 78038af3c8d..243706cab93 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3804.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3804.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Error C3804" title: "Compiler Error C3804" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3804" +ms.date: 11/04/2016 f1_keywords: ["C3804"] helpviewer_keywords: ["C3804"] -ms.assetid: 7c4cda28-ec96-4d04-937b-36dbd9944722 --- # Compiler Error C3804 -'property_accessor': the accessor methods for a property must either be all static or all non-static +> 'property_accessor': the accessor methods for a property must either be all static or all non-static + +## Remarks When defining a non-trivial property, the accessor functions can be either static or instance, but not both. @@ -16,7 +17,7 @@ See [property](../../extensions/property-cpp-component-extensions.md) for more i ## Example -The following sample generates C3804. +The following example generates C3804. ```cpp // C3804.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3805.md b/docs/error-messages/compiler-errors-2/compiler-error-c3805.md index 405f04301ed..b889e2d7e73 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3805.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3805.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Compiler Error C3805" title: "Compiler Error C3805" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3805" +ms.date: 11/04/2016 f1_keywords: ["C3805"] helpviewer_keywords: ["C3805"] -ms.assetid: 166bbc35-5488-46b4-8e4c-9cd26ee5644e --- # Compiler Error C3805 -'token' : unexpected token, expected either '}' or an identifier +> 'token' : unexpected token, expected either '}' or an identifier + +## Remarks When defining a property, an invalid token was encountered. Remove the invalid token. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3807.md b/docs/error-messages/compiler-errors-2/compiler-error-c3807.md index 836ea5b2fe2..c951650c6d0 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3807.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3807.md @@ -1,20 +1,21 @@ --- -description: "Learn more about: Compiler Error C3807" title: "Compiler Error C3807" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3807" +ms.date: 11/04/2016 f1_keywords: ["C3807"] helpviewer_keywords: ["C3807"] -ms.assetid: 7e2b0aab-8c61-4e71-b9c1-fcaeb6a1b5ea --- # Compiler Error C3807 -'type' : a class with the ComImport attribute cannot derive from 'type2', only interface implementation is allowed +> 'type' : a class with the ComImport attribute cannot derive from 'type2', only interface implementation is allowed + +## Remarks A type that derived from can only implement an interface. ## Example -The following sample generates C3807. +The following example generates C3807. ```cpp // C3807.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3808.md b/docs/error-messages/compiler-errors-2/compiler-error-c3808.md index 33e19c9ba8a..d55d364f37d 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3808.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3808.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3808" title: "Compiler Error C3808" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3808" +ms.date: 11/04/2016 f1_keywords: ["C3808"] helpviewer_keywords: ["C3808"] -ms.assetid: 2ee8ac97-3ea4-417a-8710-be73a7f98cf4 --- # Compiler Error C3808 @@ -18,7 +17,7 @@ The **/clr:pure** and **/clr:safe** compiler options are deprecated in Visual St ## Example -The following sample generates C3808. +The following example generates C3808. ```cpp // C3808.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3809.md b/docs/error-messages/compiler-errors-2/compiler-error-c3809.md index 33561ee925b..90fdd8856ac 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3809.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3809.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C3809" title: "Compiler Error C3809" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3809" +ms.date: 11/04/2016 f1_keywords: ["C3809"] helpviewer_keywords: ["C3809"] -ms.assetid: 37eca584-c20c-464e-8e45-a987214b7ce4 --- # Compiler Error C3809 -'class' : a managed or WinRT type cannot have any friend functions/classes/interfaces +> 'class' : a managed or WinRT type cannot have any friend functions/classes/interfaces + +## Remarks Managed types and Windows Runtime types do not allow friends. To fix this error, do not declare friends inside managed or Windows Runtime types. -The following sample generates C3809: +## Example + +The following example generates C3809: ```cpp // C3809a.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3812.md b/docs/error-messages/compiler-errors-2/compiler-error-c3812.md index 01948fe0827..b2618d099ba 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3812.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3812.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Error C3812" title: "Compiler Error C3812" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3812" +ms.date: 11/04/2016 f1_keywords: ["C3812"] helpviewer_keywords: ["C3812"] -ms.assetid: 326ac706-9a5f-4851-b9d2-b90c64c75532 --- # Compiler Error C3812 -'property' must be the first token in a property declaration +> 'property' must be the first token in a property declaration + +## Remarks When declaring a property, the `__property` keyword must be the first token on the line. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3813.md b/docs/error-messages/compiler-errors-2/compiler-error-c3813.md index 191a711ea7f..4f384bab29a 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3813.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3813.md @@ -1,20 +1,21 @@ --- -description: "Learn more about: Compiler Error C3813" title: "Compiler Error C3813" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3813" +ms.date: 11/04/2016 f1_keywords: ["C3813"] helpviewer_keywords: ["C3813"] -ms.assetid: ffdbc489-71bf-4cd6-988c-f824c9ab3ceb --- # Compiler Error C3813 -a property declaration can only appear within the definition of a managed or WinRT type +> a property declaration can only appear within the definition of a managed or WinRT type + +## Remarks A [property](../../dotnet/how-to-use-properties-in-cpp-cli.md) can only be declared within a managed or Windows Runtime type. Native types do not support the **`property`** keyword. ## Example -The following sample generates C3813 and shows how to fix it: +The following example generates C3813 and shows how to fix it: ```cpp // C3813.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3815.md b/docs/error-messages/compiler-errors-2/compiler-error-c3815.md index 5ba2bf28ee5..b60ddbf7dd0 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3815.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3815.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Error C3815" title: "Compiler Error C3815" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3815" +ms.date: 11/04/2016 f1_keywords: ["C3815"] helpviewer_keywords: ["C3815"] -ms.assetid: c5a3b404-6341-4fd3-92af-152b404c4dde --- # Compiler Error C3815 -return type of method 'get_accessor' must match type of the last parameter of a setter +> return type of method 'get_accessor' must match type of the last parameter of a setter + +## Remarks When declaring properties, the return value of the `get_accessor` method must match the last parameter in the declaration of the set accessor method. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3816.md b/docs/error-messages/compiler-errors-2/compiler-error-c3816.md index 555ed517ecc..e489ee5545d 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3816.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3816.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C3816" title: "Compiler Error C3816" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3816" +ms.date: 11/04/2016 f1_keywords: ["C3816"] helpviewer_keywords: ["C3816"] -ms.assetid: 2e52cc7f-e31c-41a3-8d6f-9f5fab3648c0 --- # Compiler Error C3816 -'declaration' was previously declared or defined with a different managed or WinRTmodifier +> 'declaration' was previously declared or defined with a different managed or WinRTmodifier + +## Remarks A forward declaration and an actual declaration require that there be no conflicts or inconsistencies in the declaration of attributes. -The following sample generates C3816 and shows how to fix it: +## Example + +The following example generates C3816 and shows how to fix it: ```cpp // C3816a.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3817.md b/docs/error-messages/compiler-errors-2/compiler-error-c3817.md index 763d7fecb84..2485dc8edf8 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3817.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3817.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Error C3817" title: "Compiler Error C3817" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3817" +ms.date: 11/04/2016 f1_keywords: ["C3817"] helpviewer_keywords: ["C3817"] -ms.assetid: c6dbb57a-c65e-4040-8dd2-85bd9d4fd337 --- # Compiler Error C3817 -'declaration' : property can only be applied to a function +> 'declaration' : property can only be applied to a function + +## Remarks The **`property`** keyword can only be a applied to a function definition. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3818.md b/docs/error-messages/compiler-errors-2/compiler-error-c3818.md index e89b0f982be..142477f6753 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3818.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3818.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Error C3818" title: "Compiler Error C3818" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3818" +ms.date: 11/04/2016 f1_keywords: ["C3818"] helpviewer_keywords: ["C3818"] -ms.assetid: f9502f6a-0690-4135-ab88-cc97cf490f5c --- # Compiler Error C3818 -array property declaration 'property1' shall not overload an index property 'property2' +> array property declaration 'property1' shall not overload an index property 'property2' + +## Remarks An overload is not possible for properties when one is an indexer and the other is an array property. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3820.md b/docs/error-messages/compiler-errors-2/compiler-error-c3820.md index f9398c914e6..31f296f9bcd 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3820.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3820.md @@ -4,7 +4,6 @@ description: "Microsoft C/C++ compiler error C3820 causes and remedies." ms.date: 09/26/2020 f1_keywords: ["C3820"] helpviewer_keywords: ["C3820"] -ms.assetid: 98638838-068f-4a62-b8d5-1068368a0ff1 --- # Compiler Error C3820 diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3821.md b/docs/error-messages/compiler-errors-2/compiler-error-c3821.md index 40b92e5f159..408630cab82 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3821.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3821.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Error C3821" title: "Compiler Error C3821" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3821" +ms.date: 11/04/2016 f1_keywords: ["C3821"] helpviewer_keywords: ["C3821"] -ms.assetid: 2b327c7a-5faf-443c-ae82-944fae25b4df --- # Compiler Error C3821 -'function': managed type or function cannot be used in an unmanaged function +> 'function': managed type or function cannot be used in an unmanaged function + +## Remarks Functions with inline assembly or [setjmp](../../c-runtime-library/reference/setjmp.md) cannot contain value types or managed classes. To fix this error, remove the inline assembly and `setjmp` or remove the managed objects. @@ -16,7 +17,7 @@ C3821 can also occur if you try to use automatic storage in a vararg function. ## Examples -The following sample generates C3821. +The following example generates C3821. ```cpp // C3821a.cpp @@ -27,7 +28,7 @@ void test1(...) { } ``` -The following sample generates C3821. +The following example generates C3821. ```cpp // C3821b.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3824.md b/docs/error-messages/compiler-errors-2/compiler-error-c3824.md index 9287340b195..37daec6fadf 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3824.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3824.md @@ -1,20 +1,21 @@ --- -description: "Learn more about: Compiler Error C3824" title: "Compiler Error C3824" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3824" +ms.date: 11/04/2016 f1_keywords: ["C3824"] helpviewer_keywords: ["C3824"] -ms.assetid: b6c6adf1-0a29-401c-a06e-616fd50d4c37 --- # Compiler Error C3824 -'member': this type cannot appear in this context (function parameter, return type, or a static member) +> 'member': this type cannot appear in this context (function parameter, return type, or a static member) + +## Remarks Pinning pointers cannot be function parameters, return types, or declared **`static`**. ## Example -The following sample generates C3824: +The following example generates C3824: ```cpp // C3824a.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3825.md b/docs/error-messages/compiler-errors-2/compiler-error-c3825.md index 9b05b9a696c..40293c4ae53 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3825.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3825.md @@ -1,20 +1,21 @@ --- -description: "Learn more about: Compiler Error C3825" title: "Compiler Error C3825" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3825" +ms.date: 11/04/2016 f1_keywords: ["C3825"] helpviewer_keywords: ["C3825"] -ms.assetid: 18e204a1-f26e-42c6-8d74-2b49cc95f940 --- # Compiler Error C3825 -'class': a managed or WinRTclass can only support managed or WinRTevents +> 'class': a managed or WinRTclass can only support managed or WinRTevents + +## Remarks Only .NET events are supported in managed classes. Only Windows Runtime events are supported in Windows Runtime classes. To fix this error in managed code, change type parameter of `event_source` and `event_receiver` from `native` to `managed`. Alternatively, remove the attribute. ## Example -The following sample generates C3825 and shows how to fix it: +The following example generates C3825 and shows how to fix it: ```cpp // C3825a.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3828.md b/docs/error-messages/compiler-errors-2/compiler-error-c3828.md index 42507113264..9fe4e6f0102 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3828.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3828.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C3828" title: "Compiler Error C3828" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3828" +ms.date: 11/04/2016 f1_keywords: ["C3828"] helpviewer_keywords: ["C3828"] -ms.assetid: 8d9cee75-9504-4bc8-88b6-2413618a3f45 --- # Compiler Error C3828 -'object type': placement arguments not allowed while creating instances of managed or WinRTclasses +> 'object type': placement arguments not allowed while creating instances of managed or WinRTclasses + +## Remarks When creating an object of a managed type or Windows Runtime type, you cannot use the placement form of operator [ref new, gcnew](../../extensions/ref-new-gcnew-cpp-component-extensions.md) or [new](../../cpp/new-operator-cpp.md). -The following sample generates C3828 and shows how to fix it: +## Example + +The following example generates C3828 and shows how to fix it: ```cpp // C3828a.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3830.md b/docs/error-messages/compiler-errors-2/compiler-error-c3830.md index 8ea57b4157b..cbcf4775975 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3830.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3830.md @@ -1,20 +1,21 @@ --- -description: "Learn more about: Compiler Error C3830" title: "Compiler Error C3830" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3830" +ms.date: 11/04/2016 f1_keywords: ["C3830"] helpviewer_keywords: ["C3830"] -ms.assetid: c9798f88-5001-4067-9fb1-09957ddc6fa8 --- # Compiler Error C3830 -'type1': cannot inherit from 'type2', value types can only inherit from interface classes +> 'type1': cannot inherit from 'type2', value types can only inherit from interface classes + +## Remarks A value type cannot inherit a base class. For more information, see [Classes and Structs](../../extensions/classes-and-structs-cpp-component-extensions.md). ## Example -The following sample generates C3830: +The following example generates C3830: ```cpp // C3830a.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3831.md b/docs/error-messages/compiler-errors-2/compiler-error-c3831.md index 60e02f58a61..2b861984944 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3831.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3831.md @@ -1,20 +1,21 @@ --- -description: "Learn more about: Compiler Error C3831" title: "Compiler Error C3831" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3831" +ms.date: 11/04/2016 f1_keywords: ["C3831"] helpviewer_keywords: ["C3831"] -ms.assetid: a125d8dc-b75a-4ea0-b6c7-fe7b119dba25 --- # Compiler Error C3831 -'member': 'class' cannot have a pinned data member or a member function returning a pinning pointer +> 'member': 'class' cannot have a pinned data member or a member function returning a pinning pointer + +## Remarks [pin_ptr (C++/CLI)](../../extensions/pin-ptr-cpp-cli.md) was used incorrectly. ## Example -The following sample generates C3831: +The following example generates C3831: ```cpp // C3831a.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3832.md b/docs/error-messages/compiler-errors-2/compiler-error-c3832.md index caeebc3ea94..e1e3bdfaa45 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3832.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3832.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Compiler Error C3832" title: "Compiler Error C3832" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3832" +ms.date: 11/04/2016 f1_keywords: ["C3832"] helpviewer_keywords: ["C3832"] -ms.assetid: 9a41df82-42e1-4908-958c-76cff9235de0 --- # Compiler Error C3832 -'type library': type library looks as if it was built for 32-bit pointers; please change the 'ptrsize' qualifier +> 'type library': type library looks as if it was built for 32-bit pointers; please change the 'ptrsize' qualifier + +## Remarks Explicit information supplied with the `ptrsize` attribute of the [#import](../../preprocessor/hash-import-directive-cpp.md) directive did not agree with what the compiler found in the type library. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3833.md b/docs/error-messages/compiler-errors-2/compiler-error-c3833.md index a57735b84a7..b129c53c0af 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3833.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3833.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C3833" title: "Compiler Error C3833" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3833" +ms.date: 11/04/2016 f1_keywords: ["C3833"] helpviewer_keywords: ["C3833"] -ms.assetid: 8152be53-e01e-48cd-9eef-9de38723664c --- # Compiler Error C3833 -'type' : invalid target type for pointer_type +> 'type' : invalid target type for pointer_type + +## Remarks An [interior_ptr](../../extensions/interior-ptr-cpp-cli.md) or [pin_ptr](../../extensions/pin-ptr-cpp-cli.md) was declared incorrectly. -The following sample generates C3833: +## Examples + +The following example generates C3833: ```cpp // C3833.cpp @@ -34,7 +37,7 @@ int main() { } ``` -The following sample generates C3833: +The following example generates C3833: ```cpp // C3833b.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3834.md b/docs/error-messages/compiler-errors-2/compiler-error-c3834.md index 957ff8062bb..f20bfc9b040 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3834.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3834.md @@ -1,20 +1,21 @@ --- -description: "Learn more about: Compiler Error C3834" title: "Compiler Error C3834" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3834" +ms.date: 11/04/2016 f1_keywords: ["C3834"] helpviewer_keywords: ["C3834"] -ms.assetid: 059e0dc4-300b-4e74-b6c2-41a57831fe2a --- # Compiler Error C3834 -illegal explicit cast to a pinning pointer; use a pinned local variable instead +> illegal explicit cast to a pinning pointer; use a pinned local variable instead + +## Remarks Explicit casts to a pinned pointer are not allowed. ## Example -The following sample generates C3834. +The following example generates C3834. ```cpp // C3834.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3836.md b/docs/error-messages/compiler-errors-2/compiler-error-c3836.md index d033952fdc1..47bcc280d81 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3836.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3836.md @@ -1,20 +1,21 @@ --- -description: "Learn more about: Compiler Error C3836" title: "Compiler Error C3836" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3836" +ms.date: 11/04/2016 f1_keywords: ["C3836"] helpviewer_keywords: ["C3836"] -ms.assetid: 254f851b-7b7d-4c34-a740-fcf72f6a636a --- # Compiler Error C3836 -static constructor is not allowed to have a member initializer list +> static constructor is not allowed to have a member initializer list + +## Remarks A managed class cannot have a static constructor that also has a member initialization list. Static class constructors are called by the common language runtime to do class initialization, initializing static data members. ## Example -The following sample generates C3836: +The following example generates C3836: ```cpp // C3836a.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3838.md b/docs/error-messages/compiler-errors-2/compiler-error-c3838.md index 88b0263bba7..10518be7bfe 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3838.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3838.md @@ -1,20 +1,21 @@ --- -description: "Learn more about: Compiler Error C3838" title: "Compiler Error C3838" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3838" +ms.date: 11/04/2016 f1_keywords: ["C3838"] helpviewer_keywords: ["C3838"] -ms.assetid: d6f470c2-131a-4a8c-843a-254acd43da83 --- # Compiler Error C3838 -cannot explicitly inherit from 'type' +> cannot explicitly inherit from 'type' + +## Remarks The specified `type` cannot act as a base class in any class. ## Example -The following sample generates C3838: +The following example generates C3838: ```cpp // C3838a.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3839.md b/docs/error-messages/compiler-errors-2/compiler-error-c3839.md index 0979234a149..6cc03dfe858 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3839.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3839.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C3839" title: "Compiler Error C3839" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3839" +ms.date: 11/04/2016 f1_keywords: ["C3839"] helpviewer_keywords: ["C3839"] -ms.assetid: 0957faff-1e9f-439b-876b-85bd8d2c578d --- # Compiler Error C3839 -cannot change alignment in a managed or WinRT type +> cannot change alignment in a managed or WinRT type + +## Remarks Alignment of variables in managed or Windows Runtime types is controlled by the CLR or Windows Runtime and cannot be modified with [align](../../cpp/align-cpp.md). -The following sample generates C3839: +## Example + +The following example generates C3839: ```cpp // C3839a.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3842.md b/docs/error-messages/compiler-errors-2/compiler-error-c3842.md index 283392fcc7e..5149f7f4d13 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3842.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3842.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C3842" title: "Compiler Error C3842" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3842" +ms.date: 11/04/2016 f1_keywords: ["C3842"] helpviewer_keywords: ["C3842"] -ms.assetid: 41a1a44a-c618-40a2-8d26-7da27d14095d --- # Compiler Error C3842 -'function': 'const' and 'volatile' qualifiers on member functions of WinRT or managed types are not supported +> 'function': 'const' and 'volatile' qualifiers on member functions of WinRT or managed types are not supported + +## Remarks [const](../../cpp/const-cpp.md) and [volatile](../../cpp/volatile-cpp.md) are not supported on member functions of Windows Runtime or managed types. -The following sample generates C3842: +## Example + +The following example generates C3842: ```cpp // C3842a.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3846.md b/docs/error-messages/compiler-errors-2/compiler-error-c3846.md index 8196ca04b3f..4a9caf6f2d3 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3846.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3846.md @@ -1,20 +1,21 @@ --- -description: "Learn more about: Compiler Error C3846" title: "Compiler Error C3846" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3846" +ms.date: 11/04/2016 f1_keywords: ["C3846"] helpviewer_keywords: ["C3846"] -ms.assetid: c470f8a5-106b-4efb-b8dc-e1319e04130f --- # Compiler Error C3846 -'symbol' : cannot import symbol from 'assembly2': as 'symbol' has already been imported from another assembly 'assembly1' +> 'symbol' : cannot import symbol from 'assembly2': as 'symbol' has already been imported from another assembly 'assembly1' + +## Remarks A symbol could not be imported from a referenced assembly because it was previously imported from a referenced assembly. ## Example -The following sample generates C3846: +The following example generates C3846: ```cpp // C3846a.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3848.md b/docs/error-messages/compiler-errors-2/compiler-error-c3848.md index c67ffd0065f..f9bd3b6ac87 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3848.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3848.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C3848" title: "Compiler Error C3848" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3848" +ms.date: 11/04/2016 f1_keywords: ["C3848"] helpviewer_keywords: ["C3848"] -ms.assetid: 32d3ccef-01ec-4f8b-bbff-fb9b1a76b4c4 --- # Compiler Error C3848 -expression having type 'type' would lose some const-volatile qualifiers in order to call 'function' +> expression having type 'type' would lose some const-volatile qualifiers in order to call 'function' + +## Remarks A variable with a specified const-volatile type can only call member functions defined with same or greater const-volatile qualifications. -The following samples generate C3848: +## Example + +The following example generate C3848: ```cpp // C3848.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3849.md b/docs/error-messages/compiler-errors-2/compiler-error-c3849.md index 2945bd37e2b..923c5269c4b 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3849.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3849.md @@ -1,20 +1,23 @@ --- -description: "Learn more about: Compiler Error C3849" title: "Compiler Error C3849" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3849" +ms.date: 11/04/2016 f1_keywords: ["C3849"] helpviewer_keywords: ["C3849"] -ms.assetid: 5347140e-1a81-4841-98c0-b63d98264b64 --- # Compiler Error C3849 -function-style call on an expression of type 'type' would lose const and/or volatile qualifiers for all number available operator overloads +> function-style call on an expression of type 'type' would lose const and/or volatile qualifiers for all number available operator overloads + +## Remarks A variable with a specified const-volatile type can only call member functions defined with same or greater const-volatile qualifications. To fix this error, provide an appropriate member function. You cannot execute a conversion on a const or volatile qualified object when the conversion causes loss of qualification. You can gain qualifiers but you cannot lose qualifiers in a conversion. -The following samples generate C3849: +## Example + +The following example generate C3849: ```cpp // C3849.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3850.md b/docs/error-messages/compiler-errors-2/compiler-error-c3850.md index e5add0470c0..e5ae957dc8f 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3850.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3850.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3850" title: "Compiler Error C3850" -ms.date: "09/05/2018" +description: "Learn more about: Compiler Error C3850" +ms.date: 09/05/2018 f1_keywords: ["C3850"] helpviewer_keywords: ["C3850"] -ms.assetid: 028f3a37-f3ad-4ebc-9168-3cdea47524d4 --- # Compiler Error C3850 @@ -20,7 +19,7 @@ In code compiled as C++, a universal character name may use any valid Unicode co ## Example -The following sample generates C3850, and shows how to fix it: +The following example generates C3850, and shows how to fix it: ```cpp // C3850.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3851.md b/docs/error-messages/compiler-errors-2/compiler-error-c3851.md index 50a7a94eabb..a505013ce14 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3851.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3851.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3851" title: "Compiler Error C3851" -ms.date: "09/05/2018" +description: "Learn more about: Compiler Error C3851" +ms.date: 09/05/2018 f1_keywords: ["C3851"] helpviewer_keywords: ["C3851"] -ms.assetid: da30c21c-33aa-4439-8fb3-2f5021ea4985 --- # Compiler Error C3851 @@ -16,7 +15,7 @@ In code compiled as C++, you cannot use a universal character name that represen ## Example -The following samples generate C3851, and show how to fix it: +The following example generates C3851, and show how to fix it: ```cpp // C3851.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3852.md b/docs/error-messages/compiler-errors-2/compiler-error-c3852.md index af2bf00c9e5..79818b2719a 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3852.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3852.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C3852" title: "Compiler Error C3852" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3852" +ms.date: 11/04/2016 f1_keywords: ["C3852"] helpviewer_keywords: ["C3852"] -ms.assetid: 194e5c5e-0dfb-414e-86db-791c11eb610c --- # Compiler Error C3852 -'member' having type 'type': aggregate initialization could not initialize this member +> 'member' having type 'type': aggregate initialization could not initialize this member + +## Remarks An attempt was made to assign a default initialization as part of an aggregate initialization to a data member that cannot receive a default initialization in an aggregate initialization. -The following samples generate C3852: +## Example + +The following example generate C3852: ```cpp // C3852.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3853.md b/docs/error-messages/compiler-errors-2/compiler-error-c3853.md index cc8cc07302f..49307be38a6 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3853.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3853.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C3853" title: "Compiler Error C3853" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3853" +ms.date: 11/04/2016 f1_keywords: ["C3853"] helpviewer_keywords: ["C3853"] -ms.assetid: 5b71805d-52b4-44ec-80ae-37c68d876f6a --- # Compiler Error C3853 -'=': re-initializing a reference or assignment through a reference-to-function is illegal +> '=': re-initializing a reference or assignment through a reference-to-function is illegal + +## Remarks Cannot assign to a reference through a function because functions are not lvalues. -The following samples generate C3853: +## Example + +The following example generates C3853: ```cpp // C3853.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3854.md b/docs/error-messages/compiler-errors-2/compiler-error-c3854.md index 5726a0af135..1884381f47f 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3854.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3854.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C3854" title: "Compiler Error C3854" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3854" +ms.date: 11/04/2016 f1_keywords: ["C3854"] helpviewer_keywords: ["C3854"] -ms.assetid: 32a9ead0-c6c7-485a-8802-c7b1fe921d3a --- # Compiler Error C3854 -expression to left of '=' evaluates to a function. Cannot assign to a function (a function is not an l-value) +> expression to left of '=' evaluates to a function. Cannot assign to a function (a function is not an l-value) + +## Remarks A reference cannot be reinitialized. Dereferencing a reference to a function yields a function, which is an rvalue, to which you cannot assign. Therefore, you cannot assign through a reference to a function. -The following sample generates C3854: +## Example + +The following example generates C3854: ```cpp // C3854.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3855.md b/docs/error-messages/compiler-errors-2/compiler-error-c3855.md index 94133ecbfa7..070460053f8 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3855.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3855.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C3855" title: "Compiler Error C3855" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3855" +ms.date: 11/04/2016 f1_keywords: ["C3855"] helpviewer_keywords: ["C3855"] -ms.assetid: ed90f8c0-4154-4243-b066-493913df5727 --- # Compiler Error C3855 -'class': type parameter 'param' is incompatible with the declaration +> 'class': type parameter 'param' is incompatible with the declaration + +## Remarks The compiler found nontype template or generic parameters with different names. This can occur when a specified template parameter in the definition of a template specialization is incompatible with its declaration. -The following sample generates C3855: +## Examples + +The following example generates C3855: ```cpp // C3855.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3856.md b/docs/error-messages/compiler-errors-2/compiler-error-c3856.md index 8ce44778f3f..e4241d6dcc0 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3856.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3856.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C3856" title: "Compiler Error C3856" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3856" +ms.date: 11/04/2016 f1_keywords: ["C3856"] helpviewer_keywords: ["C3856"] -ms.assetid: 242d9322-c325-4f20-be58-b2be6da56d60 --- # Compiler Error C3856 -'type': class is not a class type +> 'type': class is not a class type + +## Remarks The most common cause for this error is when there are more generic or template parameter lists at the point of definition than there were at the point of declaration. -The following sample generates C3856: +## Examples + +The following example generates C3856: ```cpp // C3856.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3857.md b/docs/error-messages/compiler-errors-2/compiler-error-c3857.md index f1696e055f2..0a64becf2b8 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3857.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3857.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C3857" title: "Compiler Error C3857" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3857" +ms.date: 11/04/2016 f1_keywords: ["C3857"] helpviewer_keywords: ["C3857"] -ms.assetid: 9f746d1e-9708-4945-bc29-3150d5371d3c --- # Compiler Error C3857 -'type': multiple type parameter lists are not allowed +> 'type': multiple type parameter lists are not allowed + +## Remarks More than one template or generic was specified for the same type, which is not allowed. -The following sample generates C3857: +## Examples + +The following example generates C3857: ```cpp // C3857.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3858.md b/docs/error-messages/compiler-errors-2/compiler-error-c3858.md index 00ac4027fa4..249ac5979b0 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3858.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3858.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C3858" title: "Compiler Error C3858" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3858" +ms.date: 11/04/2016 f1_keywords: ["C3858"] helpviewer_keywords: ["C3858"] -ms.assetid: 46e178d5-a55f-4ac6-a9dc-561fbcba5c1f --- # Compiler Error C3858 -'type': cannot be redeclared in current scope +> 'type': cannot be redeclared in current scope + +## Remarks The type cannot be declared twice in the same scope. -The following sample generates C3858: +## Example + +The following example generates C3858: ```cpp // C3858.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3859.md b/docs/error-messages/compiler-errors-2/compiler-error-c3859.md index f46601d6816..b9c63f460ab 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3859.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3859.md @@ -1,6 +1,6 @@ --- -description: "Learn more about: Compiler Error C3859" title: "Compiler Error C3859" +description: "Learn more about: Compiler Error C3859" ms.date: 02/22/2022 f1_keywords: ["C3859"] helpviewer_keywords: ["C3859"] @@ -25,6 +25,8 @@ The message has one of the following notes: >PCH: Unable to get the requested block of memory\ >Consider using /Fp to allow the compiler to reserve the memory early +## Remarks + There isn't enough virtual memory allocated for your [precompiled header (PCH)](../../build/creating-precompiled-header-files.md). If your precompiled header uses an explicit `#pragma hdrstop` directive, use the **`/Zm`** compiler flag to specify a larger value for the precompiled header file. Otherwise, consider reducing the number of parallel compilation processes in your build. For more information, see [`/Zm` (Specify precompiled header memory allocation limit)](../../build/reference/zm-specify-precompiled-header-memory-allocation-limit.md). This diagnostic shows up mostly in two scenarios: diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3860.md b/docs/error-messages/compiler-errors-2/compiler-error-c3860.md index 173f2736ae8..b33bd7e9836 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3860.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3860.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C3860" title: "Compiler Error C3860" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3860" +ms.date: 11/04/2016 f1_keywords: ["C3860"] helpviewer_keywords: ["C3860"] -ms.assetid: 1fb5110d-594e-4f1c-8773-888233af1313 --- # Compiler Error C3860 -type argument list following class type name must list parameters in the order used in type parameter list +> type argument list following class type name must list parameters in the order used in type parameter list + +## Remarks A generic or template argument list was ill formed. -The following sample generates C3860: +## Examples + +The following example generates C3860: ```cpp // C3860.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3861.md b/docs/error-messages/compiler-errors-2/compiler-error-c3861.md index 3675124e82f..b45f6623ab7 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3861.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3861.md @@ -1,19 +1,18 @@ --- -description: "Learn more about: Compiler Error C3861" title: "Compiler Error C3861" +description: "Learn more about: Compiler Error C3861" ms.date: 06/29/2022 f1_keywords: ["C3861"] helpviewer_keywords: ["C3861"] -ms.assetid: 0a1eee30-b3db-41b1-b1e5-35949c3924d7 --- # Compiler Error C3861 > '*identifier*': identifier not found -The compiler was unable to resolve a reference to an identifier, even using argument-dependent lookup. - ## Remarks +The compiler was unable to resolve a reference to an identifier, even using argument-dependent lookup. + To fix this error, compare use of *identifier* to the identifier declaration for case and spelling. Verify that [scope resolution operators](../../cpp/scope-resolution-operator.md) and namespace [`using` directives](../../cpp/namespaces-cpp.md#using_directives) are used correctly. If the identifier is declared in a header file, verify that the header is included before the identifier is referenced. If the identifier is meant to be externally visible, make sure that it's declared in any source file that uses it. Also check that the identifier declaration or definition isn't excluded by [conditional compilation directives](../../preprocessor/hash-if-hash-elif-hash-else-and-hash-endif-directives-c-cpp.md). Changes to remove obsolete functions from the C Runtime Library in Visual Studio 2015 can cause C3861. To resolve this error, remove references to these functions or replace them with their secure alternatives, if any. For more information, see [Obsolete functions](../../c-runtime-library/obsolete-functions.md). @@ -24,7 +23,7 @@ If error C3861 appears after project migration from older versions of the compil ### Undefined identifier -The following sample generates C3861 because the identifier isn't defined. +The following example generates C3861 because the identifier isn't defined. ```cpp // C3861.cpp @@ -37,7 +36,7 @@ int main() { ### Identifier not in scope -The following sample generates C3861, because an identifier is only visible in the file scope of its definition, unless it's declared in other source files that use it. +The following example generates C3861, because an identifier is only visible in the file scope of its definition, unless it's declared in other source files that use it. Source file `C3861_a1.cpp`: @@ -98,7 +97,7 @@ int main() { ### ADL and friend functions -The following sample generates C3767 because the compiler can't use argument dependent lookup for `FriendFunc`: +The following example generates C3861 because the compiler can't use argument dependent lookup for `FriendFunc`: ```cpp namespace N { diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3862.md b/docs/error-messages/compiler-errors-2/compiler-error-c3862.md index 583cd4c16f4..8bfa574489d 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3862.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3862.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Error C3862" title: "Compiler Error C3862" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3862" +ms.date: 11/04/2016 f1_keywords: ["C3862"] helpviewer_keywords: ["C3862"] -ms.assetid: ba547366-4189-4077-8c00-ab45e08a9533 --- # Compiler Error C3862 @@ -20,7 +19,7 @@ For more information, see [/clr (Common Language Runtime Compilation)](../../bui ## Example -The following sample generates C3862: +The following example generates C3862: ```cpp // C3862.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3865.md b/docs/error-messages/compiler-errors-2/compiler-error-c3865.md index 587ea10aba1..147494f98db 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3865.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3865.md @@ -1,20 +1,23 @@ --- -description: "Learn more about: Compiler Error C3865" title: "Compiler Error C3865" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3865" +ms.date: 11/04/2016 f1_keywords: ["C3865"] helpviewer_keywords: ["C3865"] -ms.assetid: 9bc62bb0-4fb8-4856-a5cf-c7cb4029a596 --- # Compiler Error C3865 -'calling_convention' : can only be used on native member functions +> 'calling_convention' : can only be used on native member functions + +## Remarks A calling convention was used on a function that was either a global function or on a managed member function. The calling convention can only be used on a native (not managed) member function. For more information, see [Calling Conventions](../../cpp/calling-conventions.md). -The following sample generates C3865: +## Example + +The following example generates C3865: ```cpp // C3865.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3866.md b/docs/error-messages/compiler-errors-2/compiler-error-c3866.md index 71d634a4b5e..655db97c3ad 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3866.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3866.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C3866" title: "Compiler Error C3866" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3866" +ms.date: 11/04/2016 f1_keywords: ["C3866"] helpviewer_keywords: ["C3866"] -ms.assetid: 685870af-2440-4cdf-a6cb-284a5b96ef9d --- # Compiler Error C3866 -function call missing argument list +> function call missing argument list + +## Remarks Inside a nonstatic member function, a destructor or finalizer call did not have an argument list. -The following sample generates C3866: +## Example + +The following example generates C3866: ```cpp // C3866.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3867.md b/docs/error-messages/compiler-errors-2/compiler-error-c3867.md index 8a22a876fe6..a3426c61f3b 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3867.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3867.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Error C3867" title: "Compiler Error C3867" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3867" +ms.date: 11/04/2016 f1_keywords: ["C3867"] helpviewer_keywords: ["C3867"] -ms.assetid: bc5de03f-e01a-4407-88c3-2c63f0016a1e --- # Compiler Error C3867 -'func': function call missing argument list; use '&func' to create a pointer to member +> 'func': function call missing argument list; use '&func' to create a pointer to member + +## Remarks You tried to take the address of a member function without qualifying the member function with its class name and the address-of operator. @@ -18,7 +19,7 @@ This error can also be generated as a result of compiler conformance work that w C3867 can be issued from the compiler with a misleading suggested resolution. Whenever possible, use the most derived class. -The following sample generates C3867 and shows how to fix it. +The following example generates C3867 and shows how to fix it. ```cpp // C3867_1.cpp @@ -38,11 +39,11 @@ void Derived::Bar() { } ``` -The following sample generates C3867 and shows how to fix it. +The following example generates C3867 and shows how to fix it. ```cpp // C3867_2.cpp -#include +#include struct S { char *func() { @@ -68,7 +69,7 @@ int main() { } ``` -The following sample generates C3867 and shows how to fix it. +The following example generates C3867 and shows how to fix it. ```cpp // C3867_3.cpp @@ -85,7 +86,7 @@ int main() { } ``` -The following sample generates C3867. +The following example generates C3867. ```cpp // C3867_4.cpp @@ -107,7 +108,7 @@ public: }; ``` -The following sample generates C3867. +The following example generates C3867. ```cpp // C3867_5.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3868.md b/docs/error-messages/compiler-errors-2/compiler-error-c3868.md index d3eb1d2f2e4..3276521fff2 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3868.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3868.md @@ -1,20 +1,21 @@ --- -description: "Learn more about: Compiler Error C3868" title: "Compiler Error C3868" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3868" +ms.date: 11/04/2016 f1_keywords: ["C3868"] helpviewer_keywords: ["C3868"] -ms.assetid: f0e45c2a-2149-4885-a03b-0d230069f03a --- # Compiler Error C3868 -'type': constraints on generic parameter 'parameter' differ from those on the declaration +> 'type': constraints on generic parameter 'parameter' differ from those on the declaration + +## Remarks Multiple declarations must have the same generic constraints. For more information, see [Generics](../../extensions/generics-cpp-component-extensions.md). ## Example -The following sample generates C3868. +The following example generates C3868. ```cpp // C3868.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3869.md b/docs/error-messages/compiler-errors-2/compiler-error-c3869.md index 6df2c9c037f..6264bd6bdf2 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3869.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3869.md @@ -1,20 +1,21 @@ --- -description: "Learn more about: Compiler Error C3869" title: "Compiler Error C3869" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3869" +ms.date: 11/04/2016 f1_keywords: ["C3869"] helpviewer_keywords: ["C3869"] -ms.assetid: 85b2ad72-95c1-4ed6-9761-6ef66c3802b7 --- # Compiler Error C3869 -gcnew constraint is missing empty parameter list '()' +> gcnew constraint is missing empty parameter list '()' + +## Remarks The **`gcnew`** special constraint was specified without the empty parameter list. See [Constraints on Generic Type Parameters (C++/CLI)](../../extensions/constraints-on-generic-type-parameters-cpp-cli.md) for more information. ## Example -The following sample generates C3869. +The following example generates C3869. ```cpp // C3869.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3872.md b/docs/error-messages/compiler-errors-2/compiler-error-c3872.md index 65ac7afb1f6..3a5499f3518 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3872.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3872.md @@ -1,20 +1,23 @@ --- -description: "Learn more about: Compiler Error C3872" title: "Compiler Error C3872" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3872" +ms.date: 11/04/2016 f1_keywords: ["C3872"] helpviewer_keywords: ["C3872"] -ms.assetid: 519e95be-5641-40cc-894c-da4819506604 --- # Compiler Error C3872 -'char': this character is not allowed in an identifier +> 'char': this character is not allowed in an identifier + +## Remarks The C++ compiler follows the C++11 standard on characters allowed in an identifier. Only certain ranges of characters and universal character names are allowed in an identifier. Additional restrictions apply to the initial character of an identifier. For more information and a list of allowed characters and universal character name ranges, see [Identifiers](../../cpp/identifiers-cpp.md). The range of characters allowed in an identifier is less restrictive when compiling C++/CLI code. Identifiers in code compiled by using /clr should follow [Standard ECMA-335: Common Language Infrastructure (CLI)](https://ecma-international.org/publications-and-standards/standards/ecma-335/). -The following sample generates C3872: +## Example + +The following example generates C3872: ```cpp // C3872.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3873.md b/docs/error-messages/compiler-errors-2/compiler-error-c3873.md index 90f0de0b051..829b2a9a342 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3873.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3873.md @@ -1,20 +1,23 @@ --- -description: "Learn more about: Compiler Error C3873" title: "Compiler Error C3873" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3873" +ms.date: 11/04/2016 f1_keywords: ["C3873"] helpviewer_keywords: ["C3873"] -ms.assetid: e68fd3be-2391-492b-ac3f-d2428901b2e9 --- # Compiler Error C3873 -'char': this character is not allowed as a first character of an identifier +> 'char': this character is not allowed as a first character of an identifier + +## Remarks The C++ compiler follows the C++11 standard on characters allowed in an identifier. Only certain ranges of characters and universal character names are allowed in an identifier. Additional restrictions apply to the initial character of an identifier. For more information and a list of allowed characters and universal character name ranges, see [Identifiers](../../cpp/identifiers-cpp.md). The range of characters allowed in an identifier is less restrictive when compiling C++/CLI code. Identifiers in code compiled by using /clr should follow [Standard ECMA-335: Common Language Infrastructure (CLI)](https://ecma-international.org/publications-and-standards/standards/ecma-335/). -The following sample generates C3873: +## Example + +The following example generates C3873: ```cpp // C3873.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3874.md b/docs/error-messages/compiler-errors-2/compiler-error-c3874.md index 596ca9d98d1..b6461f75e73 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3874.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3874.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C3874" title: "Compiler Error C3874" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3874" +ms.date: 11/04/2016 f1_keywords: ["C3874"] helpviewer_keywords: ["C3874"] -ms.assetid: fd55fc05-69a7-4237-b3b7-dca1d5400b4f --- # Compiler Error C3874 -return type of 'function' should be 'int' instead of 'type' +> return type of 'function' should be 'int' instead of 'type' + +## Remarks A function does not have the return type that was expected by the compiler. -The following sample generates C3874: +## Example + +The following example generates C3874: ```cpp // C3874b.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3880.md b/docs/error-messages/compiler-errors-2/compiler-error-c3880.md index 6a0ac4d45c6..cb33548783f 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3880.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3880.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Error C3880" title: "Compiler Error C3880" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3880" +ms.date: 11/04/2016 f1_keywords: ["C3880"] helpviewer_keywords: ["C3880"] -ms.assetid: b0e05d1e-32d0-4034-9246-f37d23573ea9 --- # Compiler Error C3880 -'var' : cannot be a literal data member +> 'var' : cannot be a literal data member + +## Remarks The type of a [literal](../../extensions/literal-cpp-component-extensions.md) attribute must be, or compile-time convertible to, one of the following types: @@ -18,7 +19,9 @@ The type of a [literal](../../extensions/literal-cpp-component-extensions.md) at - enum with an integral or underlying type -The following sample generates C3880: +## Example + +The following example generates C3880: ```cpp // C3880.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3883.md b/docs/error-messages/compiler-errors-2/compiler-error-c3883.md index 5ffa8913d6f..12fcbf17f42 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3883.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3883.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C3883" title: "Compiler Error C3883" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3883" +ms.date: 11/04/2016 f1_keywords: ["C3883"] helpviewer_keywords: ["C3883"] -ms.assetid: cdd1c1f4-f268-4469-9c62-d52303114b0c --- # Compiler Error C3883 -'var' : an initonly static data member must be initialized +> '*member*': an initonly static data member must be initialized + +## Remarks A variable marked with [initonly](../../dotnet/initonly-cpp-cli.md) was not initialized correctly. -The following sample generates C3883: +## Example + +The following example generates C3883: ```cpp // C3883.cpp @@ -23,7 +26,7 @@ ref struct Y1 { }; ``` -The following sample demonstrates a possible resolution: +The following example demonstrates a possible resolution: ```cpp // C3883b.cpp @@ -34,7 +37,7 @@ ref struct Y1 { }; ``` -The following sample shows how to initialize in a static constructor: +The following example shows how to initialize in a static constructor: ```cpp // C3883c.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3886.md b/docs/error-messages/compiler-errors-2/compiler-error-c3886.md index e1973ceb117..5464660fa41 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3886.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3886.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C3886" title: "Compiler Error C3886" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3886" +ms.date: 11/04/2016 f1_keywords: ["C3886"] helpviewer_keywords: ["C3886"] -ms.assetid: 485f6c12-cc1b-4146-9034-409a0a5e615e --- # Compiler Error C3886 -'var' : a literal data member must be initialized +> 'var' : a literal data member must be initialized + +## Remarks A [literal](../../extensions/literal-cpp-component-extensions.md) variable must be initialized when it is declaraed. -The following sample generates C3886: +## Example + +The following example generates C3886: ```cpp // C3886.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3887.md b/docs/error-messages/compiler-errors-2/compiler-error-c3887.md index 65c16cb61d9..fae154f26b9 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3887.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3887.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C3887" title: "Compiler Error C3887" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3887" +ms.date: 11/04/2016 f1_keywords: ["C3887"] helpviewer_keywords: ["C3887"] -ms.assetid: a7e82426-ef99-437b-9562-2822004e18fe --- # Compiler Error C3887 -'var' : the initializer for a literal data member must be a constant expression +> 'var' : the initializer for a literal data member must be a constant expression + +## Remarks A [literal](../../extensions/literal-cpp-component-extensions.md) data member can only be initialized with a constant expresion. -The following sample generates C3887: +## Example + +The following example generates C3887: ```cpp // C3887.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3888.md b/docs/error-messages/compiler-errors-2/compiler-error-c3888.md index b7a9a19d216..42306cab20a 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3888.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3888.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Error C3888" title: "Compiler Error C3888" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3888" +ms.date: 11/04/2016 f1_keywords: ["C3888"] helpviewer_keywords: ["C3888"] -ms.assetid: 40820812-79c5-4dcd-a19d-b4164d25fc8a --- # Compiler Error C3888 -'name' : the const expression associated with this literal data member is not supported by C++/CLI +> 'name' : the const expression associated with this literal data member is not supported by C++/CLI + +## Remarks The *name* data member that is declared with the [literal](../../extensions/literal-cpp-component-extensions.md) keyword is initialized with a value the compiler does not support. The compiler supports only constant integral, enum, or string types. The likely cause for the **C3888** error is that the data member is initialized with a byte array. diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3890.md b/docs/error-messages/compiler-errors-2/compiler-error-c3890.md index 22c57edd6cd..5034b0196cf 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3890.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3890.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C3890" title: "Compiler Error C3890" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3890" +ms.date: 11/04/2016 f1_keywords: ["C3890"] helpviewer_keywords: ["C3890"] -ms.assetid: 2f22c2fd-c14e-45e1-b936-b739ffc0b135 --- # Compiler Error C3890 -'var' : you cannot take the address of a literal data member +> 'var' : you cannot take the address of a literal data member + +## Remarks A literal data member exists on the garbage-collected heap. An object on the garbage-collected heap can be moved, so taking the address is not useful. -The following sample generates C3890: +## Example + +The following example generates C3890: ```cpp // C3890.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3891.md b/docs/error-messages/compiler-errors-2/compiler-error-c3891.md index d21a7d8e696..e59a0a50479 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3891.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3891.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C3891" title: "Compiler Error C3891" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3891" +ms.date: 11/04/2016 f1_keywords: ["C3891"] helpviewer_keywords: ["C3891"] -ms.assetid: 6e1a9458-97f5-4580-bc0f-aa97a1bfd20d --- # Compiler Error C3891 -'var' : a literal data member cannot be used as a l-value +> 'var' : a literal data member cannot be used as a l-value + +## Remarks A [literal](../../extensions/literal-cpp-component-extensions.md) variable is const, and its value cannot be changed after it is initialized in the declaration. -The following sample generates C3891: +## Example + +The following example generates C3891: ```cpp // C3891.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3892.md b/docs/error-messages/compiler-errors-2/compiler-error-c3892.md index 283ef497cad..a046e7e6d0e 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3892.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3892.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C3892" title: "Compiler Error C3892" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3892" +ms.date: 11/04/2016 f1_keywords: ["C3892"] helpviewer_keywords: ["C3892"] -ms.assetid: 83fff42c-ea48-442f-bc2e-b33a6b99d890 --- # Compiler Error C3892 -'var' : you cannot assign to a variable that is const +> 'var' : you cannot assign to a variable that is const + +## Remarks A const variable cannot be changed after it is declared and initialized. -The following sample generates C3892: +## Example + +The following example generates C3892: ```cpp // C3892.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3893.md b/docs/error-messages/compiler-errors-2/compiler-error-c3893.md index b77022a2fd5..3585d8de062 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3893.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3893.md @@ -1,20 +1,23 @@ --- -description: "Learn more about: Compiler Error C3893" title: "Compiler Error C3893" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3893" +ms.date: 11/04/2016 f1_keywords: ["C3893"] helpviewer_keywords: ["C3893"] -ms.assetid: 90d52eae-6ef2-4db1-b7ad-92f9e8b140fb --- # Compiler Error C3893 -'var' : l-value use of initonly data member is only allowed in an instance constructor of class 'type_name' +> 'var' : l-value use of initonly data member is only allowed in an instance constructor of class 'type_name' + +## Remarks Static [initonly](../../dotnet/initonly-cpp-cli.md) data members can only have their address taken in a static constructor. Instance (non-static) initonly data members can only have their address taken in instance (non-static) constructors. -The following sample generates C3893: +## Example + +The following example generates C3893: ```cpp // C3893.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3894.md b/docs/error-messages/compiler-errors-2/compiler-error-c3894.md index 15508ee9ee6..72eeb3433d8 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3894.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3894.md @@ -1,20 +1,23 @@ --- -description: "Learn more about: Compiler Error C3894" title: "Compiler Error C3894" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3894" +ms.date: 11/04/2016 f1_keywords: ["C3894"] helpviewer_keywords: ["C3894"] -ms.assetid: 6d5ac903-1dea-431d-8e3a-cebca4342983 --- # Compiler Error C3894 -'var' : l-value use of initonly static data member is only allowed in the class constructor of class 'class' +> 'var' : l-value use of initonly static data member is only allowed in the class constructor of class 'class' + +## Remarks Static [initonly](../../dotnet/initonly-cpp-cli.md) data members can only be used as l-values at their point of declaration, or in a static constructor. Instance (non-static) initonly data members can only be used as l-values at their point of declaration, or in instance (non-static) constructors. -The following sample generates C3894: +## Example + +The following example generates C3894: ```cpp // C3894.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3895.md b/docs/error-messages/compiler-errors-2/compiler-error-c3895.md index 1bdeb12441e..3b970022dbf 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3895.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3895.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C3895" title: "Compiler Error C3895" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3895" +ms.date: 11/04/2016 f1_keywords: ["C3895"] helpviewer_keywords: ["C3895"] -ms.assetid: 771b9fe5-d6d4-4297-bf57-e2f857722155 --- # Compiler Error C3895 -'var' : type data members cannot be 'volatile' +> 'var' : type data members cannot be 'volatile' + +## Remarks Certain kinds of data members, for example [literal](../../extensions/literal-cpp-component-extensions.md) or [initonly](../../dotnet/initonly-cpp-cli.md), cannot be [volatile](../../cpp/volatile-cpp.md). -The following sample generates C3895: +## Example + +The following example generates C3895: ```cpp // C3895.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3896.md b/docs/error-messages/compiler-errors-2/compiler-error-c3896.md index fb207c3e781..99836883967 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3896.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3896.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C3896" title: "Compiler Error C3896" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3896" +ms.date: 11/04/2016 f1_keywords: ["C3896"] helpviewer_keywords: ["C3896"] -ms.assetid: eb8be0f6-5b4e-4d71-8285-8a2a94f8ba29 --- # Compiler Error C3896 -'member' : improper initializer: this literal data member can only be initialized with 'nullptr' +> 'member' : improper initializer: this literal data member can only be initialized with 'nullptr' + +## Remarks A [literal](../../extensions/literal-cpp-component-extensions.md) data member was initialized incorrectly. See [nullptr](../../extensions/nullptr-cpp-component-extensions.md) for more information. -The following sample generates C3896: +## Example + +The following example generates C3896: ```cpp // C3896.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3898.md b/docs/error-messages/compiler-errors-2/compiler-error-c3898.md index 0665bbe6c7c..dd2fdddb61e 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3898.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3898.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C3898" title: "Compiler Error C3898" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3898" +ms.date: 11/04/2016 f1_keywords: ["C3898"] helpviewer_keywords: ["C3898"] -ms.assetid: d9a90df6-87e4-4fe7-ab01-c226ee86bf10 --- # Compiler Error C3898 -'var' : type data members can only be members of managed types +> 'var' : type data members can only be members of managed types + +## Remarks An [initonly](../../dotnet/initonly-cpp-cli.md) data member was declared in a native class. An **`initonly`** data member can only be declared in a CLR class. -The following sample generates C3898: +## Example + +The following example generates C3898: ```cpp // C3898.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3899.md b/docs/error-messages/compiler-errors-2/compiler-error-c3899.md index b8e55730c7f..cd8558439ef 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3899.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3899.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Error C3899" title: "Compiler Error C3899" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3899" +ms.date: 11/04/2016 f1_keywords: ["C3899"] helpviewer_keywords: ["C3899"] -ms.assetid: 14e07e4a-f7a7-4309-baaa-649d69e12e23 --- # Compiler Error C3899 -'var' : l-value use of initonly data member is not allowed directly within a parallel region in class 'class' +> 'var' : l-value use of initonly data member is not allowed directly within a parallel region in class 'class' + +## Remarks An [initonly (C++/CLI)](../../dotnet/initonly-cpp-cli.md) data member cannot be initialized inside that part of a constructor that is in a [parallel](../../parallel/openmp/reference/openmp-directives.md#parallel) region. This is because the compiler does an internal relocation of that code, such that, it is effectively no longer part of the constructor. @@ -16,7 +17,7 @@ To resolve, initialize the initonly data member in the constructor, but outside ## Example -The following sample generates C3899. +The following example generates C3899. ```cpp // C3899.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3900.md b/docs/error-messages/compiler-errors-2/compiler-error-c3900.md index 75f0af0b487..197aefade42 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3900.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3900.md @@ -1,20 +1,23 @@ --- -description: "Learn more about: Compiler Error C3900" title: "Compiler Error C3900" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3900" +ms.date: 11/04/2016 f1_keywords: ["C3900"] helpviewer_keywords: ["C3900"] -ms.assetid: a94cc561-8fa8-4344-9e01-e81ff462fae5 --- # Compiler Error C3900 -'member': not allowed in current scope +> 'member': not allowed in current scope + +## Remarks Property blocks can contain function declarations and inline function definitions only. No members other than functions are allowed in property blocks. No typedefs, operators, or friend functions are allowed. For more information, see [property](../../extensions/property-cpp-component-extensions.md). Event definitions can only contain access methods and functions. -The following sample generates C3900: +## Examples + +The following example generates C3900: ```cpp // C3900.cpp @@ -27,7 +30,7 @@ ref class X { }; ``` -The following sample generates C3900: +The following example generates C3900: ```cpp // C3900b.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3901.md b/docs/error-messages/compiler-errors-2/compiler-error-c3901.md index 391b3327368..65d317906bb 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3901.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3901.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C3901" title: "Compiler Error C3901" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3901" +ms.date: 11/04/2016 f1_keywords: ["C3901"] helpviewer_keywords: ["C3901"] -ms.assetid: 19af4141-39ad-4c16-a68f-3ae76f648186 --- # Compiler Error C3901 -'accessor_function': must have return type 'type' +> 'accessor_function': must have return type 'type' + +## Remarks At least one get method's return type must match the property type. For more information, see [property](../../extensions/property-cpp-component-extensions.md). -The following sample generates C3901: +## Example + +The following example generates C3901: ```cpp // C3901.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3902.md b/docs/error-messages/compiler-errors-2/compiler-error-c3902.md index 0dd340d0e69..baf0a90f30a 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3902.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3902.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C3902" title: "Compiler Error C3902" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3902" +ms.date: 11/04/2016 f1_keywords: ["C3902"] helpviewer_keywords: ["C3902"] -ms.assetid: feb3bb29-f836-4d77-ba71-3876f7f4f216 --- # Compiler Error C3902 -'accessor': type of last parameter must be 'type' +> 'accessor': type of last parameter must be 'type' + +## Remarks The type of the last parameter of at least one set method must match the type of the property. For more information, see [property](../../extensions/property-cpp-component-extensions.md). -The following sample generates C3902: +## Example + +The following example generates C3902: ```cpp // C3902.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3903.md b/docs/error-messages/compiler-errors-2/compiler-error-c3903.md index d64e3d81a8b..98033fe2afd 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3903.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3903.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C3903" title: "Compiler Error C3903" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3903" +ms.date: 11/04/2016 f1_keywords: ["C3903"] helpviewer_keywords: ["C3903"] -ms.assetid: cf47d7ad-a3bd-4f75-a253-71586e7a3be6 --- # Compiler Error C3903 -'property': does not have set or get method +> 'property': does not have set or get method + +## Remarks A property must have at least a `get` or a `set` method. For more information, see [property](../../extensions/property-cpp-component-extensions.md). -The following sample generates C3903: +## Example + +The following example generates C3903: ```cpp // C3903.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3904.md b/docs/error-messages/compiler-errors-2/compiler-error-c3904.md index 948b386d8d0..1da734c8c62 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3904.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3904.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Error C3904" title: "Compiler Error C3904" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3904" +ms.date: 11/04/2016 f1_keywords: ["C3904"] helpviewer_keywords: ["C3904"] -ms.assetid: 08297605-e4f2-4c6c-b637-011f1fd40631 --- # Compiler Error C3904 -'property_accessor': must specify number parameter(s) +> 'property_accessor': must specify number parameter(s) + +## Remarks Check the number of parameters in your `get` and `set` methods against property dimensions. @@ -20,7 +21,7 @@ For more information, see [property](../../extensions/property-cpp-component-ext ## Examples -The following sample generates C3904. +The following example generates C3904. ```cpp // C3904.cpp @@ -40,7 +41,7 @@ ref class X { }; ``` -The following sample generates C3904. +The following example generates C3904. ```cpp // C3904b.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3908.md b/docs/error-messages/compiler-errors-2/compiler-error-c3908.md index dfbf987ce71..5c4f692b586 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3908.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3908.md @@ -1,20 +1,23 @@ --- -description: "Learn more about: Compiler Error C3908" title: "Compiler Error C3908" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3908" +ms.date: 11/04/2016 f1_keywords: ["C3908"] helpviewer_keywords: ["C3908"] -ms.assetid: 3c322482-c79e-4197-a578-2ad9bc379d1a --- # Compiler Error C3908 -access level less restrictive than 'construct' +> access level less restrictive than 'construct' + +## Remarks A property accessor method (get or set) cannot have less restrictive access than the access specified on the property itself. Similarly, for event accessor methods. For more information, see [property](../../extensions/property-cpp-component-extensions.md) and [event](../../extensions/event-cpp-component-extensions.md). -The following sample generates C3908: +## Example + +The following example generates C3908: ```cpp // C3908.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3909.md b/docs/error-messages/compiler-errors-2/compiler-error-c3909.md index 0ab76f3c406..205c07d12ce 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3909.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3909.md @@ -1,20 +1,23 @@ --- -description: "Learn more about: Compiler Error C3909" title: "Compiler Error C3909" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3909" +ms.date: 11/04/2016 f1_keywords: ["C3909"] helpviewer_keywords: ["C3909"] -ms.assetid: 0a443132-e53f-42dc-a58b-f086da3e7bfd --- # Compiler Error C3909 -aWinRT or managed event declaration must occur in a WinRT or managed type +> a WinRT or managed event declaration must occur in a WinRT or managed type + +## Remarks A Windows Runtime event or managed event was declared in a native type. To fix this error, declare events in Windows Runtime types or managed types. For more information, see [event](../../extensions/event-cpp-component-extensions.md). -The following sample generates C3909 and shows how to fix it: +## Example + +The following example generates C3909 and shows how to fix it: ```cpp // C3909.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3910.md b/docs/error-messages/compiler-errors-2/compiler-error-c3910.md index 9b78fc9761a..ddd865d127d 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3910.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3910.md @@ -1,20 +1,23 @@ --- -description: "Learn more about: Compiler Error C3910" title: "Compiler Error C3910" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3910" +ms.date: 11/04/2016 f1_keywords: ["C3910"] helpviewer_keywords: ["C3910"] -ms.assetid: cfcbe620-b463-463b-95ea-2d60ad33ebb5 --- # Compiler Error C3910 -'event': must define member 'method' +> 'event': must define member 'method' + +## Remarks An event was defined, but did not contain the specified, required accessor method. For more information, see [event](../../extensions/event-cpp-component-extensions.md). -The following sample generates C3910: +## Example + +The following example generates C3910: ```cpp // C3910.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3911.md b/docs/error-messages/compiler-errors-2/compiler-error-c3911.md index 06637b605a0..57fa57784be 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3911.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3911.md @@ -1,20 +1,23 @@ --- -description: "Learn more about: Compiler Error C3911" title: "Compiler Error C3911" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3911" +ms.date: 11/04/2016 f1_keywords: ["C3911"] helpviewer_keywords: ["C3911"] -ms.assetid: b786da59-0e99-479d-bc0d-551126e940f2 --- # Compiler Error C3911 -'event_accessor_method': function must have type 'signature' +> 'event_accessor_method': function must have type 'signature' + +## Remarks An event's accessor method was not properly declared. For more information, see [event](../../extensions/event-cpp-component-extensions.md). -The following sample generates C3911: +## Example + +The following example generates C3911: ```cpp // C3911.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3912.md b/docs/error-messages/compiler-errors-2/compiler-error-c3912.md index 60a7683cfe9..57daf670a72 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3912.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3912.md @@ -1,20 +1,23 @@ --- -description: "Learn more about: Compiler Error C3912" title: "Compiler Error C3912" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3912" +ms.date: 11/04/2016 f1_keywords: ["C3912"] helpviewer_keywords: ["C3912"] -ms.assetid: 674e050c-11fb-4db1-8bdf-a3e95b41161d --- # Compiler Error C3912 -'event': type of event must be a delegate type +> 'event': type of event must be a delegate type + +## Remarks An event was declared but was not of the proper type. For more information, see [event](../../extensions/event-cpp-component-extensions.md). -The following sample generates C3912: +## Example + +The following example generates C3912: ```cpp // C3912.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3913.md b/docs/error-messages/compiler-errors-2/compiler-error-c3913.md index 29bf729fda1..b9e510d71f6 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3913.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3913.md @@ -1,20 +1,23 @@ --- -description: "Learn more about: Compiler Error C3913" title: "Compiler Error C3913" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3913" +ms.date: 11/04/2016 f1_keywords: ["C3913"] helpviewer_keywords: ["C3913"] -ms.assetid: a678bfce-9524-470d-9f23-7d08ecb972c8 --- # Compiler Error C3913 -default property must be indexed +> default property must be indexed + +## Remarks A default property was defined incorrectly. For more information, see [property](../../extensions/property-cpp-component-extensions.md). -The following sample generates C3913: +## Example + +The following example generates C3913: ```cpp // C3913.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3914.md b/docs/error-messages/compiler-errors-2/compiler-error-c3914.md index e50e306dc7e..e97f908f234 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3914.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3914.md @@ -1,20 +1,21 @@ --- -description: "Learn more about: Compiler Error C3914" title: "Compiler Error C3914" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3914" +ms.date: 11/04/2016 f1_keywords: ["C3914"] helpviewer_keywords: ["C3914"] -ms.assetid: 8f3190e6-ee50-4916-9ecc-3b8748b2e1e7 --- # Compiler Error C3914 -a default property cannot be static +> a default property cannot be static + +## Remarks A default property was declared incorrectly. For more information, see [How to: Use Properties in C++/CLI](../../dotnet/how-to-use-properties-in-cpp-cli.md). ## Example -The following sample generates C3914 and shows how to fix it. +The following example generates C3914 and shows how to fix it. ```cpp // C3914.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3915.md b/docs/error-messages/compiler-errors-2/compiler-error-c3915.md index 8c882d38401..afda8542b14 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3915.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3915.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Error C3915" title: "Compiler Error C3915" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3915" +ms.date: 11/04/2016 f1_keywords: ["C3915"] helpviewer_keywords: ["C3915"] -ms.assetid: 2b0a5e5f-3aec-4a4b-9157-233031817084 --- # Compiler Error C3915 -'type' has no default indexed property (class indexer) +> 'type' has no default indexed property (class indexer) + +## Remarks A type does not have a default, indexed property. @@ -16,7 +17,7 @@ For more information, see [property](../../extensions/property-cpp-component-ext ## Examples -The following sample generates C3915. +The following example generates C3915. ```cpp // C3915.cpp @@ -41,7 +42,7 @@ int main() { C3915 can also occur if you attempt to consume a default indexer in the same compiland where it was defined with . -The following sample generates C3915. +The following example generates C3915. ```cpp // C3915_b.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3917.md b/docs/error-messages/compiler-errors-2/compiler-error-c3917.md index 1fceea56f9f..9ecc4cdf305 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3917.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3917.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Error C3917" title: "Compiler Error C3917" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3917" +ms.date: 11/04/2016 f1_keywords: ["C3917"] helpviewer_keywords: ["C3917"] -ms.assetid: a24cd0c9-262f-46e5-9488-1c01f945933d --- # Compiler Error C3917 -'*property*': obsolete construct declaration style +> '*property*': obsolete construct declaration style + +## Remarks A property or event definition used syntax from a version before Visual Studio 2005. @@ -16,6 +17,8 @@ For more information, see [property](../../extensions/property-cpp-component-ext ## Example +The following example generates C3917: + ```cpp // C3917.cpp // compile with: /clr /c diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3918.md b/docs/error-messages/compiler-errors-2/compiler-error-c3918.md index 77d654ba213..b85f5c2b89c 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3918.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3918.md @@ -1,20 +1,21 @@ --- -description: "Learn more about: Compiler Error C3918" title: "Compiler Error C3918" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3918" +ms.date: 11/04/2016 f1_keywords: ["C3918"] helpviewer_keywords: ["C3918"] -ms.assetid: a8b3a90a-3fe1-4244-a5ff-a31cdae97d98 --- # Compiler Error C3918 -usage requires 'member' to be a data member +> usage requires 'member' to be a data member + +## Remarks C3918 can occur for several reasons related to events. ## Examples -C3918 can occur because a class member is required in the current context. The following sample generates C3918. +C3918 can occur because a class member is required in the current context. The following example generates C3918. ```cpp // C3918.cpp @@ -36,7 +37,7 @@ public: C3918 is also caused if you try to check a trivial event for null (the event name will no longer provide direct access to the backing store delegate for the event). -The following sample generates C3918. +The following example generates C3918. ```cpp // C3918_2.cpp @@ -57,7 +58,7 @@ ref struct EventSource : public IEFace { }; ``` -C3918 can also occur if you incorrectly subscribe to an event. The following sample generates C3918. +C3918 can also occur if you incorrectly subscribe to an event. The following example generates C3918. ```cpp // C3918_3.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3919.md b/docs/error-messages/compiler-errors-2/compiler-error-c3919.md index 97f0dacc47f..c81a7c540df 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3919.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3919.md @@ -1,20 +1,23 @@ --- -description: "Learn more about: Compiler Error C3919" title: "Compiler Error C3919" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3919" +ms.date: 11/04/2016 f1_keywords: ["C3919"] helpviewer_keywords: ["C3919"] -ms.assetid: 5f8eddda-d751-478b-930d-e18f7191ddfb --- # Compiler Error C3919 -'event_method': function must have type 'type' +> 'event_method': function must have type 'type' + +## Remarks An event accessor method was not declared correctly. For more information about events, see [event](../../extensions/event-cpp-component-extensions.md). -The following sample generates C3919: +## Example + +The following example generates C3919: ```cpp // C3919.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3920.md b/docs/error-messages/compiler-errors-2/compiler-error-c3920.md index 0784fc24d37..47b2bb58c3a 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3920.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3920.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Error C3920" title: "Compiler Error C3920" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3920" +ms.date: 11/04/2016 f1_keywords: ["C3920"] helpviewer_keywords: ["C3920"] -ms.assetid: 66e91f28-ed82-4ce2-bf22-c0c74905b1ed --- # Compiler Error C3920 -'operator'' : cannot define a postfix increment/decrement WinRT or CLR operator Calling the postfix WinRT or CLR operator will call the corresponding prefix WinRT or CLR operator (op_Increment/op_Decrement), but with postfix semantics +> 'operator'' : cannot define a postfix increment/decrement WinRT or CLR operator Calling the postfix WinRT or CLR operator will call the corresponding prefix WinRT or CLR operator (op_Increment/op_Decrement), but with postfix semantics + +## Remarks The Windows Runtime and CLR do not support the postfix operator and user-defined postfix operators are not allowed. You can define a prefix operator and the prefix operator will be used for both pre- and post-increment operations. -The following sample generates C3920 and shows how to fix it: +## Example + +The following example generates C3920 and shows how to fix it: ```cpp // C3920.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c3923.md b/docs/error-messages/compiler-errors-2/compiler-error-c3923.md index 8b30a7fb64b..5ab80466ed9 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c3923.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c3923.md @@ -1,18 +1,17 @@ --- -description: "Learn more about: Compiler Error C3923" title: "Compiler Error C3923" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Error C3923" +ms.date: 11/04/2016 f1_keywords: ["C3923"] helpviewer_keywords: ["C3923"] -ms.assetid: db8838e9-6344-4cd6-83e0-a8abeb12c4c0 --- # Compiler Error C3923 -'member' : local class, struct, or union definitions are not allowed in a member function of a WinRT or managed class +> 'member' : local class, struct, or union definitions are not allowed in a member function of a WinRT or managed class ## Example -The following sample generates C3923. +The following example generates C3923. ```cpp // C3923.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c7510.md b/docs/error-messages/compiler-errors-2/compiler-error-c7510.md index 4d310b7a6f2..b22fad3bdd3 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c7510.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c7510.md @@ -1,6 +1,6 @@ --- -description: "Learn about the causes of Compiler error C7510 and how to fix it." title: "Compiler Error C7510" +description: "Learn about the causes of Compiler error C7510 and how to fix it." ms.date: 04/21/2021 f1_keywords: ["C7510"] helpviewer_keywords: ["C7510"] @@ -10,10 +10,10 @@ helpviewer_keywords: ["C7510"] > '*type-name*': use of dependent template name must be prefixed with 'template'\ > '*type-name*': use of dependent type name must be prefixed with 'typename' -In [`/permissive-`](../../build/reference/permissive-standards-conformance.md) mode, the compiler requires the **`template`** keyword to precede a template name when it comes after a dependent [`nested-name-specifier`](../../cpp/scope-resolution-operator.md). Similar rules hold for types qualified by **`typename`**. - ## Remarks +In [`/permissive-`](../../build/reference/permissive-standards-conformance.md) mode, the compiler requires the **`template`** keyword to precede a template name when it comes after a dependent [`nested-name-specifier`](../../cpp/scope-resolution-operator.md). Similar rules hold for types qualified by **`typename`**. + Compiler behavior has changed starting in Visual Studio 2017 version 15.8 under [`/permissive-`](../../build/reference/permissive-standards-conformance.md) mode. The compiler requires the **`template`** or **`typename`** keyword to precede a template or type name when it comes after a dependent *`nested-name-specifier`*. For more information, see [Name resolution for dependent types](../../cpp/name-resolution-for-dependent-types.md) and [Templates and name resolution](../../cpp/templates-and-name-resolution.md). ## Examples diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c7536.md b/docs/error-messages/compiler-errors-2/compiler-error-c7536.md index a2f4751a33a..dad516b4b11 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c7536.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c7536.md @@ -1,6 +1,6 @@ --- -description: "Learn about the causes of Compiler error C7536 and how to fix it." title: "Compiler Error C7536" +description: "Learn about the causes of Compiler error C7536 and how to fix it." ms.date: 05/03/2021 f1_keywords: ["C7536"] helpviewer_keywords: ["C7536"] @@ -9,6 +9,8 @@ helpviewer_keywords: ["C7536"] > ifc failed integrity checks. Expected SHA2: '*hash-value*' +## Remarks + The compiler raises C7536 whenever the *`.ifc`* file has been tampered with. The header of the module interface contains an SHA2 hash of the contents below it. On import, the *`.ifc`* file is hashed, then checked against the hash provided in the header. If these don't match, error C7536 is raised: ```Output diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c7553.md b/docs/error-messages/compiler-errors-2/compiler-error-c7553.md index 63cd4464c52..c0f40017200 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c7553.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c7553.md @@ -1,6 +1,6 @@ --- title: "Compiler Error C7553" -description: Compiler Error C7553 description and solution. +description: "Compiler Error C7553 description and solution." ms.date: 02/22/2022 f1_keywords: ["C7553"] helpviewer_keywords: ["C7553"] diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c7688.md b/docs/error-messages/compiler-errors-2/compiler-error-c7688.md index 2caa56307c1..bad39dc8ab9 100644 --- a/docs/error-messages/compiler-errors-2/compiler-error-c7688.md +++ b/docs/error-messages/compiler-errors-2/compiler-error-c7688.md @@ -1,6 +1,6 @@ --- title: "Compiler error C7688" -description: Compiler error C7688 description and solution. +description: "Compiler error C7688 description and solution." ms.date: 03/01/2023 f1_keywords: ["C7688"] helpviewer_keywords: ["C7688"] @@ -13,11 +13,11 @@ helpviewer_keywords: ["C7688"] OpenMP restricts expressions in `#pragma omp atomic` constructs to scalar type. -Compiler error C7688 is new in Visual Studio 2022 version 17.4. In previous compiler versions, the compiler would emit error [C3048](./compiler-error-c3048.md). +Compiler error C7688 is new in Visual Studio 2022 version 17.4. In previous compiler versions, the compiler would emit error [C3048](compiler-error-c3048.md). ## Example -The sample code shows diagnostics generated for non-scalar types in `#pragma omp atomic` constructs. +The example code shows diagnostics generated for non-scalar types in `#pragma omp atomic` constructs. ```cpp // C7688.cpp diff --git a/docs/error-messages/compiler-errors-2/compiler-error-c7742.md b/docs/error-messages/compiler-errors-2/compiler-error-c7742.md new file mode 100644 index 00000000000..dd7fd0b64fd --- /dev/null +++ b/docs/error-messages/compiler-errors-2/compiler-error-c7742.md @@ -0,0 +1,47 @@ +--- +title: "Compiler Error C7742" +description: "Learn more about: Compiler Error C7742" +ms.date: 07/02/2025 +ai-usage: ai-assisted +f1_keywords: ["C7742"] +helpviewer_keywords: ["C7742"] +--- +# Compiler Error C7742 + +> *Identifier*: a forward declaration of an enum can only use a simple identifier + +## Remarks + +The C++ Standard doesn't allow declaring an opaque enumeration using a qualified-id. An opaque enum declaration specifies the name and the underlying type, but doesn't list the enumerators or their values. + +## Example + +The following example generates C7742: + +```cpp +// C7742.cpp +class MyClass +{ +public: + enum MyEnum + { + e1, + e2 + }; +}; + +enum MyClass::MyEnum; // C7742 +``` + +To fix this error, remove the opaque enumeration declaration because it doesn't add anything to the program. + +However, you can define an enumeration with a qualified-id. For example: + +```cpp +struct S +{ + enum E : int; +}; + +enum S::E : int { e1, e2, e3 }; +``` diff --git a/docs/error-messages/compiler-errors-2/compiler-errors-c2500-through-c2599.md b/docs/error-messages/compiler-errors-2/compiler-errors-c2500-through-c2599.md index dc47e09a5b9..d018f827b7c 100644 --- a/docs/error-messages/compiler-errors-2/compiler-errors-c2500-through-c2599.md +++ b/docs/error-messages/compiler-errors-2/compiler-errors-c2500-through-c2599.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler errors C2500 Through C2599" title: "Compiler errors C2500 Through C2599" -ms.date: "04/21/2019" -f1_keywords: ["C2501", "C2508", "C2515", "C2519", "C2520", "C2522", "C2525", "C2527", "C2536", "C2538", "C2539", "C2546", "C2547", "C2559", "C2560", "C2564", "C2565", "C2576", "C2578", "C2580", "C2590", "C2591", "C2595", "C2596"] -helpviewer_keywords: ["C2501", "C2508", "C2515", "C2519", "C2520", "C2522", "C2525", "C2527", "C2536", "C2538", "C2539", "C2546", "C2547", "C2559", "C2560", "C2564", "C2565", "C2576", "C2578", "C2580", "C2590", "C2591", "C2595", "C2596"] -ms.assetid: a869aaed-e9f6-49e3-b273-00ea7f45bed7 +description: "Learn more about: Compiler errors C2500 through C2599" +ms.date: 04/21/2019 +f1_keywords: ["C2501", "C2508", "C2515", "C2519", "C2520", "C2522", "C2525", "C2527", "C2536", "C2538", "C2539", "C2546", "C2547", "C2554", "C2559", "C2560", "C2564", "C2565", "C2576", "C2578", "C2580", "C2590", "C2591", "C2595", "C2596"] +helpviewer_keywords: ["C2501", "C2508", "C2515", "C2519", "C2520", "C2522", "C2525", "C2527", "C2536", "C2538", "C2539", "C2546", "C2547", "C2554", "C2559", "C2560", "C2564", "C2565", "C2576", "C2578", "C2580", "C2590", "C2591", "C2595", "C2596"] --- # Compiler errors C2500 Through C2599 @@ -34,7 +33,7 @@ The articles in this section of the documentation explain a subset of the error |Compiler error C2515|'*identifier*': 'vtguard' can only be applied to class declarations or definitions| |[Compiler error C2516](compiler-error-C2516.md)|'*class*': is not a legal base class| |[Compiler error C2517](compiler-error-C2517.md)|'*identifier*': right of '::' is undefined| -|[Compiler error C2518](compiler-error-C2518.md)|keyword '*keyword*' illegal in base class list; ignored| +|[Compiler error C2518](compiler-error-C2518.md)|keyword '*keyword*' is invalid in a base class list; expected a `class` name| |Compiler error C2519|'*identifier*': WinRT attributes may only contain public fields| |Compiler error C2520|'*class*': no non-explicit constructor available for implicit conversion| |[Compiler error C2521](compiler-error-C2521.md)|a destructor/finalizer does not take any arguments| @@ -64,14 +63,15 @@ The articles in this section of the documentation explain a subset of the error |[Compiler error C2545](compiler-error-C2545.md)|'*operator*': unable to find overloaded operator| |Compiler error C2546|'*identifier*': when a type is defined in both a PIA and a no-PIA the PIA must be referenced first| |Compiler error C2547|'*identifier*': All parameters of a published method must be explicitly named on the declaration| -|[Compiler error C2548](compiler-error-C2548.md)|'*function*': missing default parameter for parameter *parameter*| +|[Compiler error C2548](compiler-error-C2548.md)|'*function*': missing default argument for parameter *parameter*| |[Compiler error C2549](compiler-error-C2549.md)|user-defined conversion cannot specify a return type| |[Compiler error C2550](compiler-error-C2550.md)|'*identifier*': constructor initializer lists are only allowed on constructor definitions| |[Compiler error C2551](compiler-error-C2551.md)|'void *' type needs explicit cast| |[Compiler error C2552](compiler-error-C2552.md)|'*identifier*': non-aggregates cannot be initialized with an initializer list| |[Compiler error C2553](compiler-error-C2553.md)|'*type* *derived_class*::*function*': overriding virtual function return type differs from '*type* *base_class*::*function*'| +|Compiler error C2554|'*variable*': 'constinit' only allowed on a variable declaration with static or thread storage duration| |[Compiler error C2555](compiler-error-C2555.md)|'*derived_class*::*function*': overriding virtual function return type differs and is not covariant from '*base_class*::*function*'| -|[Compiler error C2556](compiler-error-C2556.md)|'*type1* *class*::*function*': overloaded function differs only by return type from '*type2* *class*::*function*'| +|[Compiler error C2556](compiler-error-C2556.md)|'*function1*': overloaded function differs only by return type from '*function2*'| |[Compiler error C2557](compiler-error-C2557.md)|'*identifier*': private and protected members cannot be initialized without a constructor| |[Compiler error C2558](compiler-error-C2558.md)|class '*class*': no copy constructor available or copy constructor is declared 'explicit'| |Compiler error C2559|'*identifier*': cannot overload a member function without ref-qualifier with a member function with ref-qualifier| @@ -89,7 +89,7 @@ The articles in this section of the documentation explain a subset of the error |[Compiler error C2571](compiler-error-C2571.md)|'*identifier*': virtual function cannot be in union '*union*'| |[Compiler error C2572](compiler-error-C2572.md)|'*function*': redefinition of default argument: parameter *number*| |[Compiler error C2573](compiler-error-C2573.md)|'*class*': cannot delete pointers to objects of this type; the class has no non-placement overload for 'operator delete'. Use ::delete, or add 'operator delete(void*)' to the class| -|[Compiler error C2574](compiler-error-C2574.md)|'*destructor*': cannot be declared static| +|[Compiler error C2574](compiler-error-C2574.md)|'*function*': cannot be declared static| |[Compiler error C2575](compiler-error-C2575.md)|'*identifier*': only member functions and bases can be virtual| |Compiler error C2576|'*identifier*': cannot introduce a new virtual method as 'public'. Consider making the method non-virtual, or change the accessibility to 'internal' or 'protected private'| |[Compiler error C2577](compiler-error-C2577.md)|'*identifier*': a destructor/finalizer cannot have a return type| @@ -98,7 +98,7 @@ The articles in this section of the documentation explain a subset of the error |Compiler error C2580|'*identifier*': multiple versions of a defaulted special member functions are not allowed| |[Compiler error C2581](compiler-error-C2581.md)|'*type*': static 'operator =' function is illegal| |[Compiler error C2582](compiler-error-C2582.md)|'operator *operator*' function is unavailable in '*type*'| -|[Compiler error C2583](compiler-error-C2583.md)|'*identifier*': 'const/volatile' 'this' pointer is illegal for constructors/destructors| +|[Compiler error C2583](compiler-error-C2583.md)|'*identifier*': '*const/volatile*' 'this' pointer is illegal for constructors/destructors| |[Compiler error C2584](compiler-error-C2584.md)|'*class*': direct base '*base_class2*' is inaccessible; already a base of '*base_class1*'| |[Compiler error C2585](compiler-error-C2585.md)|explicit conversion to '*type*' is ambiguous| |[Compiler error C2586](compiler-error-C2586.md)|incorrect user-defined conversion syntax: illegal indirections| diff --git a/docs/error-messages/compiler-errors-2/compiler-errors-c2600-through-c2699.md b/docs/error-messages/compiler-errors-2/compiler-errors-c2600-through-c2699.md index 4c6182230c5..e8cbf106a75 100644 --- a/docs/error-messages/compiler-errors-2/compiler-errors-c2600-through-c2699.md +++ b/docs/error-messages/compiler-errors-2/compiler-errors-c2600-through-c2699.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler errors C2600 Through C2699" title: "Compiler errors C2600 Through C2699" +description: "Learn more about: Compiler errors C2600 Through C2699" ms.date: "04/21/2019" f1_keywords: ["C2604", "C2606", "C2607", "C2608", "C2609", "C2610", "C2615", "C2618", "C2620", "C2621", "C2622", "C2623", "C2625", "C2629", "C2631", "C2639", "C2641", "C2642", "C2643", "C2644", "C2684", "C2685", "C2686", "C2697"] helpviewer_keywords: ["C2604", "C2606", "C2607", "C2608", "C2609", "C2610", "C2615", "C2618", "C2620", "C2621", "C2622", "C2623", "C2625", "C2629", "C2631", "C2639", "C2641", "C2642", "C2643", "C2644", "C2684", "C2685", "C2686", "C2697"] -ms.assetid: 73c6319f-cbea-4a2f-913b-90dc1af61f64 --- # Compiler errors C2600 Through C2699 @@ -24,17 +23,17 @@ The articles in this section of the documentation explain a subset of the error |[Compiler error C2605](compiler-error-c2605.md)|'*identifier*': this method is reserved within a managed/WinRT class| |Compiler error C2606|'*class1*': cannot re-implement '*member*', as it is inherited from runtime base '*class2*'| |Compiler error C2607|static assertion failed| -|Compiler error C2608|Obsolete.| -|Compiler error C2609|Obsolete.| +|Compiler error C2608|invalid token '*token*' in macro parameter list| +|Compiler error C2609|missing ')' in macro parameter list| |Compiler error C2610|'*class*::*member*': is not a special member function which can be defaulted| |[Compiler error C2611](compiler-error-c2611.md)|'*token*': illegal following '~' (expected identifier)| |[Compiler error C2612](compiler-error-c2612.md)|trailing '*character*' illegal in base/member initializer list| |[Compiler error C2613](compiler-error-c2613.md)|trailing '*character*' illegal in base class list| |[Compiler error C2614](compiler-error-c2614.md)|'*class*': illegal member initialization: '*identifier*' is not a base or member| -|Compiler error C2615|Obsolete.| +|Compiler error C2615|'`offsetof`' cannot be applied to non-class type '*type*'| |[Compiler error C2616](compiler-error-c2616.md)|'*conversion*': cannot implicitly convert a non-lvalue '*type1*' to a '*type2*' that is not const| |[Compiler error C2617](compiler-error-c2617.md)|'*function*': inconsistent return statement| -|Compiler error C2618|Obsolete.| +|Compiler error C2618|illegal member designator in `offsetof`| |[Compiler error C2619](compiler-error-c2619.md)|'*identifier*': a static data member is not allowed in an anonymous struct/union| |Compiler error C2620|Obsolete.| |Compiler error C2621|Obsolete.| @@ -55,12 +54,12 @@ The articles in this section of the documentation explain a subset of the error |[Compiler error C2636](compiler-error-c2636.md)|'*identifier*': pointer to reference member is illegal| |[Compiler error C2637](compiler-error-c2637.md)|'*identifier*': cannot modify pointers to data members| |[Compiler error C2638](compiler-error-c2638.md)|'*identifier*': __based modifier illegal on pointer to member| -|Compiler error C2639|Obsolete.| -|[Compiler error C2640](compiler-error-c2640.md)|'*identifier*': __based modifier illegal on reference| -|Compiler error C2641|Obsolete.| -|Compiler error C2642|Obsolete.| -|Compiler error C2643|Obsolete.| -|Compiler error C2644|Obsolete.| +|Compiler error C2639|trailing return type '*type*' of deduction guide should be a specialization of '*class template*'| +|[Compiler error C2640](compiler-error-c2640.md)|'abstract declarator': __based modifier illegal on reference| +|Compiler error C2641|cannot deduce template arguments for '*template name*'| +|Compiler error C2642|two deduction guide declarations for the same class template cannot have equivalent parameter list and template head| +|Compiler error C2643|deduction guide should be declared in the same scope as the corresponding class template '*template name*'| +|Compiler error C2644|deduction guide should have the same access as the corresponding class template '*template name*'| |[Compiler error C2645](compiler-error-c2645.md)|no qualified name for pointer to member (found ':: *')| |[Compiler error C2646](compiler-error-c2646.md)|an anonymous struct/union at global or namespace scope must be declared static| |[Compiler error C2647](compiler-error-c2647.md)|'*operator*': cannot dereference a '*type1*' on a '*type2*'| @@ -79,11 +78,11 @@ The articles in this section of the documentation explain a subset of the error |[Compiler error C2660](compiler-error-c2660.md)|'*function*': function does not take *number* arguments| |[Compiler error C2661](compiler-error-c2661.md)|'*function*': no overloaded function takes *number* arguments| |[Compiler error C2662](compiler-error-c2662.md)|'*function*': cannot convert 'this' pointer from '*type1*' to '*type2*'| -|[Compiler error C2663](compiler-error-c2663.md)|'*function*': *number* overloads have no legal conversion for 'this' pointer| +|[Compiler error C2663](compiler-error-c2663.md)|'*function*': no overloaded function has valid conversion for '`this`' pointer| |[Compiler error C2664](compiler-error-c2664.md)|'*function*': cannot convert argument *number* from '*type1*' to '*type2*'| -|[Compiler error C2665](compiler-error-c2665.md)|'*function*': none of the *number* overloads could convert all the argument types| -|[Compiler error C2666](compiler-error-c2666.md)|'*function*': *number* overloads have similar conversions| -|[Compiler error C2667](compiler-error-c2667.md)|'*function*': none of *number* overloads have a best conversion| +|[Compiler error C2665](compiler-error-c2665.md)|'*function*': no overloaded function could convert all the argument types| +|[Compiler error C2666](compiler-error-c2666.md)|'*function*': overloaded functions have similar conversions| +|[Compiler error C2667](compiler-error-c2667.md)|'*function*': no overloaded function has a best conversion| |[Compiler error C2668](compiler-error-c2668.md)|'*function*': ambiguous call to overloaded function| |[Compiler error C2669](compiler-error-c2669.md)|member function not allowed in anonymous union| |[Compiler error C2670](compiler-error-c2670.md)|'*function*': the function template cannot convert parameter *number* from type '*type*'| diff --git a/docs/error-messages/compiler-errors-2/compiler-errors-c2700-through-c2799.md b/docs/error-messages/compiler-errors-2/compiler-errors-c2700-through-c2799.md index 9d44ce11f4c..1a597951d4d 100644 --- a/docs/error-messages/compiler-errors-2/compiler-errors-c2700-through-c2799.md +++ b/docs/error-messages/compiler-errors-2/compiler-errors-c2700-through-c2799.md @@ -4,7 +4,6 @@ title: "Compiler errors C2700 Through C2799" ms.date: "04/21/2019" f1_keywords: ["C2716", "C2717", "C2727", "C2729", "C2737", "C2740", "C2741", "C2742", "C2744", "C2746", "C2747", "C2759", "C2763", "C2769", "C2772", "C2789", "C2796", "C2799"] helpviewer_keywords: ["C2716", "C2717", "C2727", "C2729", "C2737", "C2740", "C2741", "C2742", "C2744", "C2746", "C2747", "C2759", "C2763", "C2769", "C2772", "C2789", "C2796", "C2799"] -ms.assetid: 6ee257bb-94bc-42b9-af2c-3c73926afba4 --- # Compiler errors C2700 Through C2799 @@ -49,7 +48,7 @@ The articles in this section of the documentation explain a subset of the error |[Compiler error C2730](compiler-error-c2730.md)|'*class*': cannot be a base class of itself| |[Compiler error C2731](compiler-error-c2731.md)|'*function*': function cannot be overloaded| |[Compiler error C2732](compiler-error-c2732.md)|linkage specification contradicts earlier specification for '*function*'| -|[Compiler error C2733](compiler-error-c2733.md)|'*function*': second C linkage of overloaded function not allowed| +|[Compiler error C2733](compiler-error-c2733.md)|'*function*': you cannot overload a function with '`extern "C"`' linkage| |[Compiler error C2734](compiler-error-c2734.md)|'*identifier*': 'const' object must be initialized if not 'extern'| |[Compiler error C2735](compiler-error-c2735.md)|'*keyword*' keyword is not permitted in formal parameter type specifier| |[Compiler error C2736](compiler-error-c2736.md)|'*keyword*' keyword is not permitted in cast| @@ -81,7 +80,7 @@ The articles in this section of the documentation explain a subset of the error |[Compiler error C2762](compiler-error-c2762.md)|'*template*': invalid expression as a template argument for '*parameter*'| |Compiler error C2763|'*template*': invalid use of a string literal as a template argument for '*parameter*'| |[Compiler error C2764](compiler-error-c2764.md)|'*parameter*': template parameter not used or deducible in partial specialization '*specialization*'| -|[Compiler error C2765](compiler-error-c2765.md)|'*function*': an explicit specialization of a function template cannot have any default arguments| +|[Compiler error C2765](compiler-error-c2765.md)|'*function*': an explicit specialization or instantiation of a function template cannot have any default arguments| |[Compiler error C2766](compiler-error-c2766.md)|explicit specialization; '*specialization*' has already been defined| |[Compiler error C2767](compiler-error-c2767.md)|managed/WinRT array dimension mismatch: expected *number* argument(s) - *number* provided| |[Compiler error C2768](compiler-error-c2768.md)|'*function*': illegal use of explicit template arguments| @@ -113,7 +112,7 @@ The articles in this section of the documentation explain a subset of the error |[Compiler error C2794](compiler-error-c2794.md)|'*identifier*': is not a member of any direct or indirect base class of '*class*'| |[Compiler error C2795](compiler-error-c2795.md)|'super::*identifier*' is not a member function| |Compiler error C2796|'ref new' may only be used to create an instance of a WinRT type| -|[Compiler error C2797](compiler-error-c2797.md)|(Obsolete) '*identifier*': list initialization inside member initializer list or non-static data member initializer is not implemented| +|[Compiler error C2797](compiler-error-c2797.md)|'*identifier*': list initialization inside member initializer list or non-static data member initializer is not implemented| |[Compiler error C2798](compiler-error-c2798.md)|'super::*identifier*' is ambiguous| |Compiler error C2799|'*identifier*': an object of const-qualified class type without a user-provided default constructor must be initialized| diff --git a/docs/error-messages/compiler-errors-2/compiler-errors-c2800-through-c2899.md b/docs/error-messages/compiler-errors-2/compiler-errors-c2800-through-c2899.md index 3b351c5ffe7..6ad3bb045bf 100644 --- a/docs/error-messages/compiler-errors-2/compiler-errors-c2800-through-c2899.md +++ b/docs/error-messages/compiler-errors-2/compiler-errors-c2800-through-c2899.md @@ -4,7 +4,6 @@ title: "Compiler errors C2800 Through C2899" ms.date: 06/01/2022 f1_keywords: ["C2816", "C2820", "C2822", "C2826", "C2832", "C2836", "C2837", "C2840", "C2841", "C2848", "C2851", "C2852", "C2853", "C2866", "C2880", "C2887", "C2889", "C2895", "C2899"] helpviewer_keywords: ["C2816", "C2820", "C2822", "C2826", "C2832", "C2836", "C2837", "C2840", "C2841", "C2848", "C2851", "C2852", "C2853", "C2866", "C2880", "C2887", "C2889", "C2895", "C2899"] -ms.assetid: e5de1e92-746a-4315-a331-c5d9efb76dbb --- # Compiler errors C2800 Through C2899 @@ -108,7 +107,7 @@ The articles in this section of the documentation explain a subset of the error | Compiler error C2889 | '*class*': a managed/WinRT class type cannot be a virtual base class | | [Compiler error C2890](compiler-error-c2890.md) | '*class*': a ref class can only have one non-interface base class | | [Compiler error C2891](compiler-error-c2891.md) | '*parameter*': cannot take the address of a template parameter | -| [Compiler error C2892](compiler-error-c2892.md) | local class shall not have member templates | +| [Compiler error C2892](compiler-error-c2892.md) | a template cannot be a member of a local class | | [Compiler error C2893](compiler-error-c2893.md) | Failed to specialize function template '*template*' | | [Compiler error C2894](compiler-error-c2894.md) | templates cannot be declared to have 'C' linkage | | Compiler error C2895 | '*declaration*': cannot explicitly instantiate a function template that has been declared with dllimport | diff --git a/docs/error-messages/compiler-errors-2/compiler-errors-c2900-through-c3499.md b/docs/error-messages/compiler-errors-2/compiler-errors-c2900-through-c3499.md index 9bb91a7e7cd..f426601753e 100644 --- a/docs/error-messages/compiler-errors-2/compiler-errors-c2900-through-c3499.md +++ b/docs/error-messages/compiler-errors-2/compiler-errors-c2900-through-c3499.md @@ -2,9 +2,8 @@ description: "Learn more about: Compiler errors C2900 Through C2999" title: "Compiler errors C2900 Through C2999" ms.date: 06/01/2022 -f1_keywords: ["C2900", "C2901", "C2905", "C2907", "C2915", "C2916", "C2922", "C2924", "C2925", "C2926", "C2938", "C2949", "C2950", "C2954", "C2956", "C2960", "C2961", "C2963", "C2964", "C2965", "C2966", "C2967", "C2968", "C2972", "C2980", "C2981", "C2982", "C2983", "C2984", "C2985", "C2986", "C2987", "C2997", "C2999"] -helpviewer_keywords: ["C2900", "C2901", "C2905", "C2907", "C2915", "C2916", "C2922", "C2924", "C2925", "C2926", "C2938", "C2949", "C2950", "C2954", "C2956", "C2960", "C2961", "C2963", "C2964", "C2965", "C2966", "C2967", "C2968", "C2972", "C2980", "C2981", "C2982", "C2983", "C2984", "C2985", "C2986", "C2987", "C2997", "C2999"] -ms.assetid: e3440738-e11b-4878-9ae3-6bc6c53ba461 +f1_keywords: ["C2900", "C2901", "C2905", "C2907", "C2915", "C2916", "C2922", "C2924", "C2925", "C2926", "C2938", "C2949", "C2950", "C2954", "C2960", "C2961", "C2963", "C2964", "C2965", "C2966", "C2967", "C2968", "C2972", "C2980", "C2981", "C2982", "C2983", "C2984", "C2985", "C2986", "C2987", "C2997"] +helpviewer_keywords: ["C2900", "C2901", "C2905", "C2907", "C2915", "C2916", "C2922", "C2924", "C2925", "C2926", "C2938", "C2949", "C2950", "C2954", "C2960", "C2961", "C2963", "C2964", "C2965", "C2966", "C2967", "C2968", "C2972", "C2980", "C2981", "C2982", "C2983", "C2984", "C2985", "C2986", "C2987", "C2997"] --- # Compiler errors C2900 Through C2999 @@ -99,10 +98,10 @@ The articles in this section of the documentation explain a subset of the error | Compiler error C2980 | C++ exception handling is not supported with /kernel | | Compiler error C2981 | the dynamic form of '*keyword*' is not supported with /kernel | | Compiler error C2982 | '*declaration*': different __declspec(code_seg(...)) used: was '*identifier1*' now '*identifier2*' | -| Compiler error C2983 | '*declaration*': all declarations must have an identical __declspec(code_seg(...)) | +| Compiler error C2983 | '*name*': a definition must have the same `__declspec(code_seg(...))` as the prior declaration | | Compiler error C2984 | Obsolete. | | Compiler error C2985 | '*argument*': the argument to __declspec(code_seg(...)) must be a text section | -| Compiler error C2986 | '*identifier*': __declspec(code_seg(...)) can only be applied to a class or a function | +| Compiler error C2986 | '`__declspec(code_seg(...))`' can only be applied to a class or a function | | Compiler error C2987 | a declaration cannot have both __declspec(code_seg('*identifier*')) and __declspec(code_seg('*value*')) | | [Compiler error C2988](compiler-error-c2988.md) | unrecognizable template declaration/definition | | [Compiler error C2989](compiler-error-c2989.md) | '*class*': class template/generic has already been declared as a non-class template/generic | @@ -114,7 +113,7 @@ The articles in this section of the documentation explain a subset of the error | [Compiler error C2995](compiler-error-c2995.md) | '*declaration*': function template has already been defined | | [Compiler error C2996](compiler-error-c2996.md) | '*function*': recursive function template definition | | Compiler error C2997 | '*function*': array bound cannot be deduced from a default member initializer | -| [Compiler error C2998](compiler-error-c2998.md) | '*declarator*': cannot be a template definition | +| [Compiler error C2998](compiler-error-c2998.md) | '*identifier*': cannot be a template definition | ## See also diff --git a/docs/error-messages/compiler-errors-2/compiler-errors-c3000-through-c3099.md b/docs/error-messages/compiler-errors-2/compiler-errors-c3000-through-c3099.md index a4abebdc6d7..bcdc2b953e2 100644 --- a/docs/error-messages/compiler-errors-2/compiler-errors-c3000-through-c3099.md +++ b/docs/error-messages/compiler-errors-2/compiler-errors-c3000-through-c3099.md @@ -2,9 +2,8 @@ description: "Learn more about: Compiler errors C3000 Through C3099" title: "Compiler errors C3000 Through C3099" ms.date: 06/01/2022 -f1_keywords: ["C3051", "C3061", "C3064", "C3067", "C3074", "C3078", "C3079", "C3081", "C3082", "C3086", "C3088", "C3089", "C3090", "C3091", "C3092", "C3093", "C3098"] -helpviewer_keywords: ["C3051", "C3061", "C3064", "C3067", "C3074", "C3078", "C3079", "C3081", "C3082", "C3086", "C3088", "C3089", "C3090", "C3091", "C3092", "C3093", "C3098"] -ms.assetid: 01b7b9cb-b351-4b5a-8cb0-1fcddb08d2ab +f1_keywords: ["C3000", "C3051", "C3061", "C3064", "C3067", "C3074", "C3078", "C3079", "C3081", "C3082", "C3086", "C3088", "C3089", "C3090", "C3091", "C3092", "C3093", "C3098"] +helpviewer_keywords: ["C3000", "C3051", "C3061", "C3064", "C3067", "C3074", "C3078", "C3079", "C3081", "C3082", "C3086", "C3088", "C3089", "C3090", "C3091", "C3092", "C3093", "C3098"] --- # Compiler errors C3000 Through C3099 @@ -64,11 +63,11 @@ The articles in this section of the documentation explain a subset of the error | [Compiler error C3045](compiler-error-c3045.md) | Expected a compound statement following OpenMP 'sections' directive. Missing '{' | | [Compiler error C3046](compiler-error-c3046.md) | Missing structured block in an OpenMP '#pragma omp sections' region | | [Compiler error C3047](compiler-error-c3047.md) | Structured block in an OpenMP 'sections' region must be preceded by '#pragma omp section' (Obsolete in Visual Studio 2022.) | -| [Compiler error C3048](compiler-error-c3048.md) | Expression following '#pragma omp atomic' has improper form | +| [Compiler error C3048](compiler-error-c3048.md) | '`#pragma omp atomic`*statement*': expression or block-statement following pragma does not conform to the OpenMP specification | | [Compiler error C3049](compiler-error-c3049.md) | '*argument*': invalid argument in OpenMP 'default' clause | | [Compiler error C3050](compiler-error-c3050.md) | '*class*': a ref class cannot inherit from '*identifier*' | | Compiler error C3051 | Obsolete. | -| [Compiler error C3052](compiler-error-c3052.md) | '*identifier*': variable doesn't appear in a data-sharing clause under a default(none) clause | +| [Compiler error C3052](compiler-error-c3052.md) | '*identifier*': variable reference occurs under a `default(none)` clause and must have explicitly specified data sharing attributes | | [Compiler error C3053](compiler-error-c3053.md) | '*identifier*': 'threadprivate' is only valid for global or static data items | | [Compiler error C3054](compiler-error-c3054.md) | '#pragma omp parallel' is currently not supported in a generic class or function (Obsolete in Visual Studio 2022.) | | [Compiler error C3055](compiler-error-c3055.md) | '*identifier*': symbol cannot be referenced before it is used in 'threadprivate' directive | @@ -81,8 +80,8 @@ The articles in this section of the documentation explain a subset of the error | [Compiler error C3062](compiler-error-c3062.md) | '*identifier*': enumerator requires value since the underlying type is '*type*' | | [Compiler error C3063](compiler-error-c3063.md) | operator '*operator*': all operands must have the same enumeration type | | Compiler error C3064 | '*identifier*': must be a simple type or resolve to one | -| [Compiler error C3065](compiler-error-c3065.md) | property declaration at non-class scope is not allowed | -| [Compiler error C3066](compiler-error-c3066.md) | there are multiple ways that an object of this type can be called with these arguments | +| [Compiler error C3065](compiler-error-c3065.md) | '`__declspec(`*specifier*`)`' at non-class scope is not allowed | +| [Compiler error C3066](compiler-error-c3066.md) | call to an object of this type is ambiguous | | Compiler error C3067 | an initializer list cannot be used with the built-in operator[] | | [Compiler error C3068](compiler-error-c3068.md) | '*identifier*': a 'naked' function cannot contain objects that would require unwinding if a C++ exception occurred | | [Compiler error C3069](compiler-error-c3069.md) | operator '*operator*': not allowed for enumeration type | @@ -94,7 +93,7 @@ The articles in this section of the documentation explain a subset of the error | [Compiler error C3075](compiler-error-c3075.md) | '*identifier*': you cannot embed an instance of a reference type, '*type*', in a value-type | | [Compiler error C3076](compiler-error-c3076.md) | '*identifier*': you cannot embed an instance of a reference type, '*type*', in a native type | | [Compiler error C3077](compiler-error-c3077.md) | '*identifier*': a finalizer can only be a member of a reference type | -| Compiler error C3078 | array size must be specified in new expressions | +| Compiler error C3078 | array size must be specified in new expressions without an initializer | | Compiler error C3079 | an initializer list cannot be used as the right operand of this assignment operator | | [Compiler error C3080](compiler-error-c3080.md) | '*finalizer*': a finalizer cannot have a storage-class-specifier | | Compiler error C3081 | Obsolete. | diff --git a/docs/error-messages/compiler-errors-2/compiler-errors-c3100-through-c3199.md b/docs/error-messages/compiler-errors-2/compiler-errors-c3100-through-c3199.md index 9bec78ffec9..92e4a1b994d 100644 --- a/docs/error-messages/compiler-errors-2/compiler-errors-c3100-through-c3199.md +++ b/docs/error-messages/compiler-errors-2/compiler-errors-c3100-through-c3199.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler errors C3100 Through C3199" title: "Compiler errors C3100 Through C3199" +description: "Learn more about: Compiler errors C3100 Through C3199" ms.date: 06/01/2022 -f1_keywords: ["C3102", "C3105", "C3107", "C3108", "C3109", "C3111", "C3112", "C3119", "C3122", "C3123", "C3124", "C3125", "C3127", "C3128", "C3129", "C3143", "C3144", "C3146", "C3147", "C3148", "C3151", "C3158", "C3164", "C3165", "C3169", "C3177", "C3178", "C3184", "C3188", "C3191", "C3193"] -helpviewer_keywords: ["C3102", "C3105", "C3107", "C3108", "C3109", "C3111", "C3112", "C3119", "C3122", "C3123", "C3124", "C3125", "C3127", "C3128", "C3129", "C3143", "C3144", "C3146", "C3147", "C3148", "C3151", "C3158", "C3164", "C3165", "C3169", "C3177", "C3178", "C3184", "C3188", "C3191", "C3193"] -ms.assetid: 7bc40c2f-6a8d-488a-b665-f39375afee77 +f1_keywords: ["C3102", "C3105", "C3107", "C3108", "C3109", "C3111", "C3112", "C3119", "C3122", "C3123", "C3124", "C3125", "C3127", "C3128", "C3129", "C3143", "C3144", "C3146", "C3147", "C3148", "C3151", "C3158", "C3164", "C3165", "C3169", "C3177", "C3178", "C3184", "C3186", "C3188", "C3191", "C3193"] +helpviewer_keywords: ["C3102", "C3105", "C3107", "C3108", "C3109", "C3111", "C3112", "C3119", "C3122", "C3123", "C3124", "C3125", "C3127", "C3128", "C3129", "C3143", "C3144", "C3146", "C3147", "C3148", "C3151", "C3158", "C3164", "C3165", "C3169", "C3177", "C3178", "C3184", "C3186", "C3188", "C3191", "C3193"] --- # Compiler errors C3100 Through C3199 @@ -82,7 +81,7 @@ The articles in this section of the documentation explain a subset of the error | [Compiler error C3163](compiler-error-c3163.md) | '*class*': attributes inconsistent with previous declaration | | Compiler error C3164 | Obsolete. | | Compiler error C3165 | '*value*': cannot convert to an integral or floating point value | -| [Compiler error C3166](compiler-error-c3166.md) | Obsolete. '*type*': a data member of a managed/WinRT class cannot have type '*pointer_type* to interior *managed_pointer_type*' | +| [Compiler error C3166](compiler-error-c3166.md) | '*type*': a data member of a managed/WinRT class cannot have type '*pointer_type* to interior *managed_pointer_type*' | | [Compiler error C3167](compiler-error-c3167.md) | Unable to initialize .NET Framework: make sure it is installed | | [Compiler error C3168](compiler-error-c3168.md) | '*type*': illegal underlying type for enum | | Compiler error C3169 | '*type*': cannot deduce type for 'auto' from '*type*' | @@ -103,7 +102,7 @@ The articles in this section of the documentation explain a subset of the error | Compiler error C3184 | Obsolete. | | [Compiler error C3185](compiler-error-c3185.md) | 'typeid': used on managed/WinRT type '*type*', use '*operator*' instead | | Compiler error C3186 | Obsolete. | -| [Compiler error C3187](compiler-error-c3187.md) | '*identifier*': is only available within the body of a function | +| [Compiler error C3187](compiler-error-c3187.md) | '`__func__`': is only available within the body of a function | | Compiler error C3188 | Obsolete. | | [Compiler error C3189](compiler-error-c3189.md) | 'typeid<*declarator*>': this syntax is no longer supported, use::typeid instead (Obsolete in Visual Studio 2022.) | | [Compiler error C3190](compiler-error-c3190.md) | '*declarator*' with the provided template arguments is not the explicit instantiation of any member function of '*type*' | diff --git a/docs/error-messages/compiler-errors-2/compiler-errors-c3200-through-c3299.md b/docs/error-messages/compiler-errors-2/compiler-errors-c3200-through-c3299.md index e835858c672..87483c7cfe9 100644 --- a/docs/error-messages/compiler-errors-2/compiler-errors-c3200-through-c3299.md +++ b/docs/error-messages/compiler-errors-2/compiler-errors-c3200-through-c3299.md @@ -4,7 +4,6 @@ title: "Compiler errors C3200 Through C3299" ms.date: 06/01/2022 f1_keywords: ["C3220", "C3221", "C3245", "C3249", "C3250", "C3256", "C3257", "C3258", "C3259", "C3260", "C3261", "C3263", "C3267", "C3281", "C3294"] helpviewer_keywords: ["C3220", "C3221", "C3245", "C3249", "C3250", "C3256", "C3257", "C3258", "C3259", "C3260", "C3261", "C3263", "C3267", "C3281", "C3294"] -ms.assetid: 6b3104f6-63bc-4823-b6f3-b8a16be4b87f --- # Compiler errors C3200 Through C3299 @@ -64,7 +63,7 @@ The articles in this section of the documentation explain a subset of the error | Compiler error C3245 | '*function*': use of a variable template requires template argument list | | [Compiler error C3246](compiler-error-c3246.md) | '*class*': cannot inherit from '*base_class*' as it has been declared as '*inheritance*' | | [Compiler error C3247](compiler-error-c3247.md) | '*coclass*': a coclass cannot inherit from another coclass '*base_class*' | -| [Compiler error C3248](compiler-error-c3248.md) | Obsolete. '*function*': function declared as 'sealed' cannot be overridden by '*function*' | +| [Compiler error C3248](compiler-error-c3248.md) | '*function*': function declared as '`sealed`' cannot be overridden by '*function*' | | Compiler error C3249 | illegal statement or sub-expression for '`constexpr`' function (Obsolete in Visual Studio 2022.) | | Compiler error C3250 | '*declaration*': declaration is not allowed in '`constexpr`' function body (Obsolete in Visual Studio 2022.) | | [Compiler error C3251](compiler-error-c3251.md) | cannot invoke base class method on a value type instance (Obsolete in Visual Studio 2022.) | @@ -77,7 +76,7 @@ The articles in this section of the documentation explain a subset of the error | Compiler error C3258 | Obsolete. | | Compiler error C3259 | '`constexpr`' functions can only have one `return` statement (Obsolete in Visual Studio 2022.) | | Compiler error C3260 | '*token*': skipping unexpected token(s) before lambda body | -| Compiler error C3261 | a function returning a managed/WinRT array must have array brackets at the end of the declaration: '*identifier*(...) \[]' | +| Compiler error C3261 | a function returning a managed/WinRT array must have array brackets at the end of the declaration: '*identifier*(...) []' | | [Compiler error C3262](compiler-error-c3262.md) | invalid array indexing: *number* dimension(s) specified for *number*-dimensional '*type*' | | Compiler error C3263 | Obsolete. | | [Compiler error C3264](compiler-error-c3264.md) | '*identifier*': a class-constructor cannot have a return type | @@ -102,7 +101,7 @@ The articles in this section of the documentation explain a subset of the error | [Compiler error C3283](compiler-error-c3283.md) | '*interface*': an interface cannot have an instance constructor | | [Compiler error C3284](compiler-error-c3284.md) | the constraints for generic parameter '*parameter*' of function '*declarator*' must match the constraints for generic parameter '*parameter*' of function '*declarator*' | | [Compiler error C3285](compiler-error-c3285.md) | for each statement cannot operate on variables of type '*type*' | -| [Compiler error C3286](compiler-error-c3286.md) | '*specifier*': an iteration variable cannot have any storage-class specifiers | +| [Compiler error C3286](compiler-error-c3286.md) | A for-range-declaration cannot have a storage class other than '`constexpr`' | | [Compiler error C3287](compiler-error-c3287.md) | the type '*type*' (return type of `GetEnumerator`) must have a suitable public `MoveNext` member function and public `Current` property | | [Compiler error C3288](compiler-error-c3288.md) | '*type*': illegal dereference of a handle type | | [Compiler error C3289](compiler-error-c3289.md) | '*identifier*': a trivial property cannot be indexed | diff --git a/docs/error-messages/compiler-errors-2/compiler-errors-c3300-through-c3399.md b/docs/error-messages/compiler-errors-2/compiler-errors-c3300-through-c3399.md index fa4967f5009..691f9c0e369 100644 --- a/docs/error-messages/compiler-errors-2/compiler-errors-c3300-through-c3399.md +++ b/docs/error-messages/compiler-errors-2/compiler-errors-c3300-through-c3399.md @@ -54,7 +54,7 @@ The articles in this section of the documentation explain a subset of the error | Compiler error C3336 | This operation must be performed at class scope | | Compiler error C3337 | '*identifier*': defaultvtable must be an event source for a coclass '*class*' | | Compiler error C3338 | '*identifier*': There can be at most one default interface that is also an event source for a coclass '*class*' | -| Compiler error C3339 | template parameter requires either 'class' or 'typename' after the parameter list | +| Compiler error C3339 | template template parameter requires either '`class`' or '`typename`' after the parameter list | | [Compiler error C3340](compiler-error-c3340.md) | '*identifier*': interface cannot be both 'restricted' and 'default' in coclass '*class*' | | Compiler error C3341 | '*interface*': a defaultvtable interface must be either 'dual' or 'custom' | | [Compiler error C3342](compiler-error-c3342.md) | '*identifier*': ambiguous attribute | diff --git a/docs/error-messages/compiler-errors-2/compiler-errors-c3400-through-c3499.md b/docs/error-messages/compiler-errors-2/compiler-errors-c3400-through-c3499.md index ce25161b6d6..688a5b80ca1 100644 --- a/docs/error-messages/compiler-errors-2/compiler-errors-c3400-through-c3499.md +++ b/docs/error-messages/compiler-errors-2/compiler-errors-c3400-through-c3499.md @@ -3,8 +3,7 @@ description: "Learn more about: Compiler errors C3400 Through C3499" title: "Compiler errors C3400 Through C3499" ms.date: 06/01/2022 f1_keywords: ["C3401", "C3402", "C3403", "C3404", "C3405", "C3406", "C3407", "C3410", "C3411", "C3416", "C3419", "C3422", "C3423", "C3424", "C3425", "C3426", "C3427", "C3428", "C3429", "C3430", "C3431", "C3432", "C3433", "C3434", "C3435", "C3436", "C3437", "C3438", "C3439", "C3440", "C3441", "C3442", "C3443", "C3444", "C3447", "C3448", "C3449", "C3471", "C3472", "C3473", "C3474", "C3475", "C3476", "C3477", "C3478", "C3479", "C3486", "C3494", "C3497"] -helpviewer_keywords: ["C3401", "C3402", "C3403", "C3404", "C3405", "C3406", "C3407", "C3410", "C3411", "C3416", "C3419", "C3422", "C3424", "C3425", "C3426", "C3427", "C3428", "C3429", "C3430", "C3431", "C3432", "C3433", "C3434", "C3435", "C3436", "C3437", "C3438", "C3439", "C3440", "C3441", "C3442", "C3443", "C3444", "C3471", "C3472", "C3473", "C3474", "C3475", "C3476", "C3477", "C3478", "C3479", "C3486", "C3494", "C3497"] -ms.assetid: a5651dfb-c402-4e01-b3ae-28f371e51d6a +helpviewer_keywords: ["C3401", "C3402", "C3403", "C3404", "C3405", "C3406", "C3407", "C3410", "C3411", "C3416", "C3419", "C3422", "C3423", "C3424", "C3425", "C3426", "C3427", "C3428", "C3429", "C3430", "C3431", "C3432", "C3433", "C3434", "C3435", "C3436", "C3437", "C3438", "C3439", "C3440", "C3441", "C3442", "C3443", "C3444", "C3447", "C3448", "C3449", "C3471", "C3472", "C3473", "C3474", "C3475", "C3476", "C3477", "C3478", "C3479", "C3486", "C3494", "C3497"] --- # Compiler errors C3400 Through C3499 @@ -44,7 +43,7 @@ The articles in this section of the documentation explain a subset of the error | Compiler error C3425 | cannot throw pointer to object of incomplete type '*type*' | | Compiler error C3426 | cannot throw object of incomplete type '*type*' | | Compiler error C3427 | '*context*': '*keyword*' cannot be used with layout_version(*number*) | -| Compiler error C3428 | '*context*': '*keyword*' can only be applied to class declarations or definitions | +| Compiler error C3428 | '`__declspec(`*keyword*`)`' can only be applied to class declarations or definitions | | Compiler error C3429 | '*context*': '*keyword*' cannot be applied to a union | | Compiler error C3430 | a scoped enumeration must have a name | | Compiler error C3431 | '*identifier*': *type1* cannot be redeclared as *type2* | @@ -93,8 +92,8 @@ The articles in this section of the documentation explain a subset of the error | Compiler error C3474 | could not open output file '*filename*' | | Compiler error C3475 | syntax error in input file '*filename*' | | Compiler error C3476 | could not open file '*filename*' for input | -| Compiler error C3477 | a lambda cannot appear in an unevaluated context | -| Compiler error C3478 | '*identifier*': an array cannot be captured by copy | +| Compiler error C3477 | a lambda can only appear in an unevaluated context with '*C++ version*' or later | +| Compiler error C3478 | '*identifier*': an array of unknown bounds cannot be captured by copy | | Compiler error C3479 | SAL annotations on lambdas are not supported | | [Compiler error C3480](compiler-error-c3480.md) | '*variable*': a lambda capture variable must be from an enclosing function scope | | [Compiler error C3481](compiler-error-c3481.md) | '*identifier*': lambda capture variable not found | @@ -104,16 +103,16 @@ The articles in this section of the documentation explain a subset of the error | [Compiler error C3485](compiler-error-c3485.md) | a lambda definition cannot have any cv-qualifiers (Obsolete in Visual Studio 2022.) | | Compiler error C3486 | a parameter for a lambda cannot have a default argument (Obsolete in Visual Studio 2022.) | | [Compiler error C3487](compiler-error-c3487.md) | '*type*': all return expressions must deduce to the same type: previously it was '*type*' | -| [Compiler error C3488](compiler-error-c3488.md) | '&*identifier*' is not allowed when the default capture mode is by-reference | -| [Compiler error C3489](compiler-error-c3489.md) | '&*identifier*' is required when the default capture mode is by copy | +| [Compiler error C3488](compiler-error-c3488.md) | '`&`*identifier*' cannot be explicitly captured when the default capture mode is by reference (`&`) | +| [Compiler error C3489](compiler-error-c3489.md) | '`&`*identifier*' is required when the default capture mode is by copy (`=`) | | [Compiler error C3490](compiler-error-c3490.md) | '*identifier*' cannot be modified because it is being accessed through a const object | | [Compiler error C3491](compiler-error-c3491.md) | '*identifier*': a by copy capture cannot be modified in a non-mutable lambda | | [Compiler error C3492](compiler-error-c3492.md) | '*identifier*': you cannot capture a member of an anonymous union | | [Compiler error C3493](compiler-error-c3493.md) | '*identifier*' cannot be implicitly captured because no default capture mode has been specified | | Compiler error C3494 | 'this' cannot be explicitly captured because an enclosing capture mode does not allow it | -| [Compiler error C3495](compiler-error-c3495.md) | '*identifier*': identifier in capture must be a variable with automatic storage duration declared in the reaching scope of the lambda | -| [Compiler error C3496](compiler-error-c3496.md) | 'this' is always captured by value: '&' ignored | -| Compiler error C3497 | you cannot construct an instance of a lambda | +| [Compiler error C3495](compiler-error-c3495.md) | '*identifier*': a simple capture must be a variable with automatic storage duration declared in the reaching scope of the lambda | +| [Compiler error C3496](compiler-error-c3496.md) | '`this`' is always captured by copy: '`&`' ignored | +| Compiler error C3497 | cannot construct an instance of this lambda | | [Compiler error C3498](compiler-error-c3498.md) | '*identifier*': you cannot capture a variable that has a managed/WinRT type | | [Compiler error C3499](compiler-error-c3499.md) | a lambda that has been specified to have a void return type cannot return a value | diff --git a/docs/error-messages/compiler-errors-2/compiler-errors-c3500-through-c3999.md b/docs/error-messages/compiler-errors-2/compiler-errors-c3500-through-c3999.md index 1d3dffd1797..e1469d0230f 100644 --- a/docs/error-messages/compiler-errors-2/compiler-errors-c3500-through-c3999.md +++ b/docs/error-messages/compiler-errors-2/compiler-errors-c3500-through-c3999.md @@ -1,8 +1,9 @@ --- -description: "Learn more about: Compiler errors C3500 through C3999" title: "Compiler errors C3500 through C3999" +description: "Learn more about: Compiler errors C3500 through C3999" ms.date: 05/25/2022 -f1_keywords: ["C3502", "C3503", "C3504", "C3511", "C3512", "C3513", "C3514", "C3515", "C3516", "C3517", "C3518", "C3520", "C3521", "C3522", "C3523", "C3524", "C3525", "C3526", "C3527", "C3528", "C3529", "C3534", "C3542", "C3543", "C3544", "C3545", "C3546", "C3547", "C3548", "C3549", "C3557", "C3558", "C3559", "C3560", "C3561", "C3562", "C3563", "C3564", "C3565", "C3566", "C3567", "C3568", "C3569", "C3570", "C3571", "C3572", "C3573", "C3574", "C3575", "C3576", "C3577", "C3578", "C3579", "C3580", "C3581", "C3582", "C3583", "C3584", "C3585", "C3586", "C3587", "C3588", "C3589", "C3590", "C3591", "C3592", "C3593", "C3594", "C3595", "C3596", "C3597", "C3598", "C3599", "C3600", "C3601", "C3602", "C3604", "C3605", "C3606", "C3613", "C3614", "C3616", "C3617", "C3620", "C3621", "C3635", "C3636", "C3639", "C3643", "C3649", "C3658", "C3659", "C3660", "C3663", "C3664", "C3667", "C3674", "C3676", "C3677", "C3678", "C3679", "C3680", "C3681", "C3682", "C3683", "C3684", "C3685", "C3686", "C3687", "C3688", "C3689", "C3690", "C3691", "C3692", "C3693", "C3694", "C3695", "C3696", "C3700", "C3716", "C3720", "C3725", "C3726", "C3729", "C3730", "C3735", "C3742", "C3746", "C3750", "C3751", "C3756", "C3757", "C3758", "C3759", "C3760", "C3770", "C3773", "C3774", "C3775", "C3776", "C3777", "C3778", "C3780", "C3781", "C3782", "C3783", "C3784", "C3785", "C3786", "C3787", "C3788", "C3789", "C3790", "C3791", "C3792", "C3793", "C3794", "C3795", "C3796", "C3801", "C3802", "C3806", "C3810", "C3811", "C3814", "C3819", "C3822", "C3823", "C3826", "C3827", "C3829", "C3837", "C3840", "C3841", "C3843", "C3844", "C3845", "C3847", "C3863", "C3870", "C3871", "C3875", "C3876", "C3877", "C3878", "C3879", "C3881", "C3882", "C3884", "C3885", "C3897", "C3905", "C3906", "C3907", "C3916", "C3921", "C3924", "C3925", "C3926", "C3927", "C3928", "C3930", "C3931", "C3932", "C3933", "C3934", "C3935", "C3936", "C3937", "C3938", "C3939", "C3940", "C3941", "C3945", "C3946", "C3947", "C3948", "C3949", "C3950", "C3951", "C3952", "C3953", "C3954", "C3955", "C3956", "C3957", "C3958", "C3959", "C3960", "C3961", "C3962", "C3963", "C3964", "C3965", "C3966", "C3967", "C3968", "C3969", "C3970", "C3971", "C3972", "C3973", "C3974", "C3975", "C3976", "C3977", "C3978", "C3979", "C3980", "C3981", "C3982", "C3983", "C3984", "C3985", "C3986", "C3987", "C3988", "C3989", "C3990", "C3991", "C3992", "C3993", "C3994", "C3995", "C3996", "C3997", "C3998", "C3999"] +f1_keywords: ["C3502", "C3503", "C3504", "C3511", "C3512", "C3513", "C3514", "C3515", "C3516", "C3517", "C3518", "C3520", "C3521", "C3522", "C3523", "C3524", "C3525", "C3526", "C3527", "C3528", "C3529", "C3534", "C3542", "C3543", "C3544", "C3545", "C3546", "C3547", "C3548", "C3549", "C3557", "C3558", "C3559", "C3560", "C3561", "C3562", "C3563", "C3564", "C3565", "C3566", "C3567", "C3568", "C3569", "C3570", "C3571", "C3572", "C3573", "C3574", "C3575", "C3576", "C3577", "C3578", "C3579", "C3580", "C3581", "C3582", "C3583", "C3584", "C3585", "C3586", "C3587", "C3588", "C3589", "C3590", "C3591", "C3592", "C3593", "C3594", "C3595", "C3596", "C3597", "C3598", "C3599", "C3600", "C3601", "C3602", "C3604", "C3605", "C3606", "C3613", "C3614", "C3616", "C3617", "C3620", "C3621", "C3629", "C3635", "C3636", "C3639", "C3643", "C3647", "C3649", "C3658", "C3659", "C3660", "C3663", "C3664", "C3667", "C3674", "C3676", "C3677", "C3678", "C3679", "C3680", "C3681", "C3682", "C3683", "C3684", "C3685", "C3686", "C3687", "C3688", "C3689", "C3690", "C3691", "C3692", "C3693", "C3694", "C3695", "C3696", "C3700", "C3716", "C3720", "C3725", "C3726", "C3729", "C3730", "C3735", "C3742", "C3746", "C3750", "C3751", "C3756", "C3757", "C3758", "C3759", "C3760", "C3770", "C3773", "C3774", "C3775", "C3776", "C3777", "C3778", "C3780", "C3781", "C3782", "C3783", "C3784", "C3785", "C3786", "C3787", "C3788", "C3789", "C3790", "C3791", "C3792", "C3793", "C3794", "C3795", "C3796", "C3801", "C3802", "C3806", "C3810", "C3811", "C3814", "C3819", "C3822", "C3823", "C3826", "C3827", "C3829", "C3835", "C3837", "C3840", "C3841", "C3843", "C3844", "C3845", "C3847", "C3863", "C3864", "C3870", "C3871", "C3875", "C3876", "C3877", "C3878", "C3879", "C3881", "C3882", "C3884", "C3885", "C3897", "C3905", "C3906", "C3907", "C3916", "C3921", "C3924", "C3925", "C3926", "C3927", "C3928", "C3930", "C3931", "C3932", "C3933", "C3934", "C3935", "C3936", "C3937", "C3938", "C3939", "C3940", "C3941", "C3945", "C3946", "C3947", "C3948", "C3949", "C3950", "C3951", "C3952", "C3953", "C3954", "C3955", "C3956", "C3957", "C3958", "C3959", "C3960", "C3961", "C3962", "C3963", "C3964", "C3965", "C3966", "C3967", "C3968", "C3969", "C3970", "C3971", "C3972", "C3973", "C3974", "C3975", "C3976", "C3977", "C3978", "C3979", "C3980", "C3981", "C3982", "C3983", "C3984", "C3985", "C3986", "C3987", "C3988", "C3989", "C3990", "C3991", "C3992", "C3993", "C3994", "C3995", "C3996", "C3997", "C3998"] +helpviewer_keywords: ["C3502", "C3503", "C3504", "C3511", "C3512", "C3513", "C3514", "C3515", "C3516", "C3517", "C3518", "C3520", "C3521", "C3522", "C3523", "C3524", "C3525", "C3526", "C3527", "C3528", "C3529", "C3534", "C3542", "C3543", "C3544", "C3545", "C3546", "C3547", "C3548", "C3549", "C3557", "C3558", "C3559", "C3560", "C3561", "C3562", "C3563", "C3564", "C3565", "C3566", "C3567", "C3568", "C3569", "C3570", "C3571", "C3572", "C3573", "C3574", "C3575", "C3576", "C3577", "C3578", "C3579", "C3580", "C3581", "C3582", "C3583", "C3584", "C3585", "C3586", "C3587", "C3588", "C3589", "C3590", "C3591", "C3592", "C3593", "C3594", "C3595", "C3596", "C3597", "C3598", "C3599", "C3600", "C3601", "C3602", "C3604", "C3605", "C3606", "C3613", "C3614", "C3616", "C3617", "C3620", "C3621", "C3629", "C3635", "C3636", "C3639", "C3643", "C3647", "C3649", "C3658", "C3659", "C3660", "C3663", "C3664", "C3667", "C3674", "C3676", "C3677", "C3678", "C3679", "C3680", "C3681", "C3682", "C3683", "C3684", "C3685", "C3686", "C3687", "C3688", "C3689", "C3690", "C3691", "C3692", "C3693", "C3694", "C3695", "C3696", "C3700", "C3716", "C3720", "C3725", "C3726", "C3729", "C3730", "C3735", "C3742", "C3746", "C3750", "C3751", "C3756", "C3757", "C3758", "C3759", "C3760", "C3770", "C3773", "C3774", "C3775", "C3776", "C3777", "C3778", "C3780", "C3781", "C3782", "C3783", "C3784", "C3785", "C3786", "C3787", "C3788", "C3789", "C3790", "C3791", "C3792", "C3793", "C3794", "C3795", "C3796", "C3801", "C3802", "C3806", "C3810", "C3811", "C3814", "C3819", "C3822", "C3823", "C3826", "C3827", "C3829", "C3835", "C3837", "C3840", "C3841", "C3843", "C3844", "C3845", "C3847", "C3863", "C3864", "C3870", "C3871", "C3875", "C3876", "C3877", "C3878", "C3879", "C3881", "C3882", "C3884", "C3885", "C3897", "C3905", "C3906", "C3907", "C3916", "C3921", "C3924", "C3925", "C3926", "C3927", "C3928", "C3930", "C3931", "C3932", "C3933", "C3934", "C3935", "C3936", "C3937", "C3938", "C3939", "C3940", "C3941", "C3945", "C3946", "C3947", "C3948", "C3949", "C3950", "C3951", "C3952", "C3953", "C3954", "C3955", "C3956", "C3957", "C3958", "C3959", "C3960", "C3961", "C3962", "C3963", "C3964", "C3965", "C3966", "C3967", "C3968", "C3969", "C3970", "C3971", "C3972", "C3973", "C3974", "C3975", "C3976", "C3977", "C3978", "C3979", "C3980", "C3981", "C3982", "C3983", "C3984", "C3985", "C3986", "C3987", "C3988", "C3989", "C3990", "C3991", "C3992", "C3993", "C3994", "C3995", "C3996", "C3997", "C3998"] --- # Compiler errors C3500 through C3999 @@ -104,7 +105,7 @@ The articles in this section explain a subset of the error messages generated by |Compiler error C3587|dynamic_cast is unsupported in amp restricted code| |Compiler error C3588|casting from '*type1*' to '*type2*' is unsupported in amp restricted code| |Compiler error C3589|'*string*': unsupported usage of string literals in amp restricted code| -|Compiler error C3590|'*token*': by-reference capture or 'this' capture is unsupported if the lambda is amp restricted| +|Compiler error C3590|capture of '*value*' is unsupported if the lambda is amp restricted| |Compiler error C3591|typeid operator is unsupported in amp restricted code| |Compiler error C3592|Inline native assembly ('__asm') is unsupported in amp restricted code| |Compiler error C3593|'goto' is unsupported in amp restricted code| @@ -262,7 +263,7 @@ The articles in this section explain a subset of the error messages generated by |[Compiler error C3747](compiler-error-c3747.md)|missing default template/generic parameter: parameter *number*| |[Compiler error C3748](compiler-error-c3748.md)|'*interface*': unmanaged interfaces may not fire events| |[Compiler error C3749](compiler-error-c3749.md)|'*attribute*': a custom attribute may not be used inside a function| -|Compiler error C3750|'*token*': unexpected token in attribute list| +|Compiler error C3750|'*token*': unexpected token in attribute specifier| |Compiler error C3751|'*identifier*': unexpected identifier in attribute list| |[Compiler error C3752](compiler-error-c3752.md)|'*attribute*': cannot classify attribute; '*keyword*' should not be used in this context| |[Compiler error C3753](compiler-error-c3753.md)|a generic property is not allowed| @@ -285,7 +286,7 @@ The articles in this section explain a subset of the error messages generated by |Compiler error C3770|'*type*': is not a valid base class| |[Compiler error C3771](compiler-error-c3771.md)|'*identifier*': friend declaration cannot be found in the nearest namespace scope| |[Compiler error C3772](compiler-error-c3772.md)|'*identifier*': invalid friend template declaration| -|Compiler error C3773|please use /await compiler switch to enable coroutines| +|Compiler error C3773|Use of '*feature*' in this context is a non-conforming extension in `C++`*version*| |Compiler error C3774|cannot find '*scope*::*identifier*': Please include *header_name* header| |Compiler error C3775|return type of '*function*' should not be '*type*'| |Compiler error C3776|cannot return an expression of type void in a coroutine with non-void eventual return type| @@ -296,7 +297,7 @@ The articles in this section explain a subset of the error messages generated by |Compiler error C3781|'*keyword*': cannot be a used in a coroutine of type '*type*'. Either *keyword* or *keyword* must be present in associated promise_type| |Compiler error C3782|*type*: a coroutine's promise cannot contain both *keyword* and *keyword*| |Compiler error C3783|'*identifier*': cannot be a coroutine| -|Compiler error C3784|*keyword* expression cannot appear in this context| +|Compiler error C3784|*keyword* cannot appear in this context| |Compiler error C3785|the first template argument to 'std::integer_sequence' must be an integer type| |Compiler error C3786|the second template argument to 'std::make_integer_sequence' must be an integer constant greater than or equal to zero| |Compiler error C3787|cannot deduce the return type of this coroutine| @@ -341,7 +342,7 @@ The articles in this section explain a subset of the error messages generated by |Compiler error C3826|Obsolete.| |Compiler error C3827|standard attribute 'deprecated' may have either no arguments or one string literal describing the reason| |[Compiler error C3828](compiler-error-c3828.md)|placement arguments cannot be specified for a '*keyword*' expression for type '*type*'| -|Compiler error C3829|standard attribute 'noreturn' may only be applied to functions| +|Compiler error C3829|attribute `[[`*attribute name*`]]` may only be applied to a function declaration| |[Compiler error C3830](compiler-error-c3830.md)|'*type1*': cannot inherit from '*type2*', value types can only inherit from interface classes| |[Compiler error C3831](compiler-error-c3831.md)|'*identifier*': '*type*' cannot have a pinned data member or a member function returning a pinning pointer| |[Compiler error C3832](compiler-error-c3832.md)|'*typelib*': type library looks as if it was built for 32-bit pointers; please change the 'ptrsize' qualifier| @@ -376,7 +377,7 @@ The articles in this section explain a subset of the error messages generated by |[Compiler error C3861](compiler-error-c3861.md)|'*identifier*': identifier not found| |[Compiler error C3862](compiler-error-c3862.md)|'*function*': cannot compile an unmanaged function with `/clr:pure` or `/clr:safe`| |Compiler error C3863|array type '*type*' is not assignable| -|Compiler error C3864|Obsolete.| +|Compiler error C3864|'*context*': requires clause is incompatible with the declaration| |[Compiler error C3865](compiler-error-c3865.md)|'*keyword*': can only be used on native member functions| |[Compiler error C3866](compiler-error-c3866.md)|destructor/finalizer call missing argument list| |[Compiler error C3867](compiler-error-c3867.md)|'*function*': non-standard syntax; use '&' to create a pointer to member| @@ -390,17 +391,18 @@ The articles in this section explain a subset of the error messages generated by |Compiler error C3875|call of non-static member function missing argument list| | Compiler error C3876 | hexadecimal floating literal requires an exponent | | Compiler error C3877 | invalid type argument to the TypeForwardedTo attribute | -| Compiler error C3878 | syntax error: unexpected token '%1$L' following '%2s' | +| Compiler error C3878 | syntax error: unexpected token '*name*' following '*context*' | |Compiler error C3879|'*member*': cannot be an initonly data member| |[Compiler error C3880](compiler-error-c3880.md)|'*member*': cannot be a literal data member| |Compiler error C3881|can only inherit constructor from direct base| |Compiler error C3882|'*class*': constructor has already been inherited from '*class*'| -|Compiler error C3883|'*member*': an initonly static data member must be initialized| +|[Compiler error C3883](compiler-error-c3883.md)|'*member*': an initonly static data member must be initialized| |Compiler error C3884|'*type*': An array of unknown size cannot be value-initialized| |Compiler error C3885|'*type*': An array of unknown size cannot be initialized with an empty initializer list| |[Compiler error C3886](compiler-error-c3886.md)|'*member*': a literal data member must be initialized| |[Compiler error C3887](compiler-error-c3887.md)|'*member*': the initializer for a literal data member must be a constant expression| |[Compiler error C3888](compiler-error-c3888.md)|'*member*': the const expression associated with this literal data member is not supported by C++/CLI| +|Compiler error C3889|call to object of class type '*type*': no matching call operator found| |[Compiler error C3890](compiler-error-c3890.md)|'*member*': you cannot take the address of a literal data member| |[Compiler error C3891](compiler-error-c3891.md)|'*member*': a literal data member cannot be used as a l-value| |[Compiler error C3892](compiler-error-c3892.md)|'*variable*': you cannot assign to a variable that is const| @@ -433,12 +435,14 @@ The articles in this section explain a subset of the error messages generated by |[Compiler error C3919](compiler-error-c3919.md)|'*function*': function must have type '*return_type* (*type*)'| |[Compiler error C3920](compiler-error-c3920.md)|'*operator*': cannot define a postfix increment/decrement CLR/WinRT operator Calling the postfix CLR/WinRT operator will call the corresponding prefix CLR/WinRT operator (op_Increment/op_Decrement), but with postfix semantics| |Compiler error C3921|Obsolete.| +|Compiler error C3922|'*name*': argument must be a constant expression| |[Compiler error C3923](compiler-error-c3923.md)|'*member*': local class, struct or union definitions are not allowed in a member function of a managed/WinRT class| |Compiler error C3924|error in argument #*number* of delegate constructor call '*constructor*':| |Compiler error C3925|expected a loop (`for`, `while`, or `do`) following '*directive_name*' directive| |Compiler error C3926|invalid constant in 'parallel' directive| |Compiler error C3927|'->': trailing return type is not allowed after a non-function declarator| |Compiler error C3928|'->': trailing return type is not allowed after a parenthesized declarator| +|Compiler error C3929|'`collapse(`*count*`)`' specified but found only *value* loops following '`#pragma omp for`'| |Compiler error C3930|'*function*': no overloaded function has restriction specifiers that are compatible with the ambient context '*context*'| |Compiler error C3931|'*type*': cannot call a function that has restriction specifiers that are incompatible with the ambient context| |Compiler error C3932|Obsolete.| @@ -451,6 +455,9 @@ The articles in this section explain a subset of the error messages generated by |Compiler error C3939|'*identifier*': pointer to member functions, function pointers, references to functions with 'amp' restriction specifier are not allowed| |Compiler error C3940|'*identifier*': identifier not found - possible mismatch between compiler and library versions. Please ensure vccorlib.h/.lib, vccorlib120.dll and c1xx.dll match| |Compiler error C3941|'*condition*': requires '/clr' command line option| +|Compiler error C3942|'`#pragma omp atomic capture`': expression on right of '`=`' must be an lvalue-expression of scalar type| +|Compiler error C3943|'`#pragma omp atomic`': operator '*operator*' is overloaded; only built-in operators are allowed| +|Compiler error C3944|'`#pragma omp atomic`': lvalue expression required as left operand of '*operator*'| |Compiler error C3945|'*type*': unable to throw or catch a winrt object which doesn't derive from Platform::Exception| |Compiler error C3946|'*type*': typeid cannot be applied to this type| |Compiler error C3947|'*typeid*': typeid cannot be applied to a pack expansion| @@ -508,5 +515,5 @@ The articles in this section explain a subset of the error messages generated by ## See also -[C/C++ Compiler and build tools errors and warnings](../compiler-errors-1/c-cpp-build-errors.md) \ +[C/C++ Compiler and build tools errors and warnings](../compiler-errors-1/c-cpp-build-errors.md)\ [Compiler errors C2000 - C3999, C7000 - C7999](../compiler-errors-1/compiler-errors-c2000-c3999.md) diff --git a/docs/error-messages/compiler-errors-2/compiler-errors-c7500-through-c7999.md b/docs/error-messages/compiler-errors-2/compiler-errors-c7500-through-c7999.md index 9bd380066b3..02b5801c7bd 100644 --- a/docs/error-messages/compiler-errors-2/compiler-errors-c7500-through-c7999.md +++ b/docs/error-messages/compiler-errors-2/compiler-errors-c7500-through-c7999.md @@ -1,9 +1,9 @@ --- -description: "Learn more about: Compiler errors C7500 through C7999" title: "Compiler errors C7500 through C7999" +description: "Learn more about: Compiler errors C7500 through C7999" ms.date: 10/13/2023 -f1_keywords: ["C7500", "C7501", "C7502", "C7503", "C7504", "C7505", "C7506", "C7507", "C7508", "C7509", "C7511", "C7512", "C7513", "C7514", "C7515", "C7516", "C7517", "C7518", "C7519", "C7520", "C7521", "C7522", "C7523", "C7524", "C7525", "C7526", "C7527", "C7528", "C7529", "C7530", "C7531", "C7532", "C7533", "C7534", "C7535", "C7537", "C7538", "C7539", "C7540", "C7541", "C7542", "C7543", "C7544", "C7545", "C7546", "C7547", "C7548", "C7549", "C7550", "C7551", "C7552", "C7554", "C7555", "C7556", "C7557", "C7558", "C7559", "C7560", "C7561", "C7562", "C7563", "C7564", "C7565", "C7566", "C7567", "C7568", "C7569", "C7570", "C7571", "C7572", "C7573", "C7574", "C7575", "C7576", "C7577", "C7578", "C7579", "C7580", "C7581", "C7582", "C7583", "C7584", "C7585", "C7586", "C7587", "C7588", "C7589", "C7590", "C7591", "C7592", "C7593", "C7594", "C7595", "C7596", "C7597", "C7599", "C7600", "C7601", "C7602", "C7603", "C7604", "C7605", "C7606", "C7607", "C7608", "C7609", "C7610", "C7611", "C7612", "C7613", "C7614", "C7615", "C7616", "C7617", "C7618", "C7619", "C7620", "C7621", "C7622", "C7623", "C7624", "C7625", "C7627", "C7628", "C7629", "C7630", "C7631", "C7632", "C7633", "C7634", "C7635", "C7636", "C7637", "C7638", "C7639", "C7640", "C7641", "C7642", "C7643", "C7644", "C7645", "C7646", "C7647", "C7648", "C7649", "C7650", "C7651", "C7652", "C7653", "C7654", "C7655", "C7656", "C7657", "C7658", "C7659", "C7660", "C7661", "C7662", "C7696", "C7700", "C7701", "C7702", "C7703", "C7704"] -helpviewer_keywords: ["C7500", "C7501", "C7502", "C7503", "C7504", "C7505", "C7506", "C7507", "C7508", "C7509", "C7511", "C7512", "C7513", "C7514", "C7515", "C7516", "C7517", "C7518", "C7519", "C7520", "C7521", "C7522", "C7523", "C7524", "C7525", "C7526", "C7527", "C7528", "C7529", "C7530", "C7531", "C7532", "C7533", "C7534", "C7535", "C7537", "C7538", "C7539", "C7540", "C7541", "C7542", "C7543", "C7544", "C7545", "C7546", "C7547", "C7548", "C7549", "C7550", "C7551", "C7552", "C7554", "C7555", "C7556", "C7557", "C7558", "C7559", "C7560", "C7561", "C7562", "C7563", "C7564", "C7565", "C7566", "C7567", "C7568", "C7569", "C7570", "C7571", "C7572", "C7573", "C7574", "C7575", "C7576", "C7577", "C7578", "C7579", "C7580", "C7581", "C7582", "C7583", "C7584", "C7585", "C7586", "C7587", "C7588", "C7589", "C7590", "C7591", "C7592", "C7593", "C7594", "C7595", "C7596", "C7597", "C7599", "C7600", "C7601", "C7602", "C7603", "C7604", "C7605", "C7606", "C7607", "C7608", "C7609", "C7610", "C7611", "C7612", "C7613", "C7614", "C7615", "C7616", "C7617", "C7618", "C7619", "C7620", "C7621", "C7622", "C7623", "C7624", "C7625", "C7627", "C7628", "C7629", "C7630", "C7631", "C7632", "C7633", "C7634", "C7635", "C7636", "C7637", "C7638", "C7639", "C7640", "C7641", "C7642", "C7643", "C7644", "C7645", "C7646", "C7647", "C7648", "C7649", "C7650", "C7651", "C7652", "C7653", "C7654", "C7655", "C7656", "C7657", "C7658", "C7659", "C7660", "C7661", "C7662", "C7696", "C7700", "C7701", "C7702", "C7703", "C7704"] +f1_keywords: ["C7500", "C7501", "C7502", "C7503", "C7504", "C7505", "C7506", "C7507", "C7508", "C7509", "C7511", "C7512", "C7513", "C7514", "C7515", "C7516", "C7517", "C7518", "C7519", "C7520", "C7521", "C7522", "C7523", "C7524", "C7525", "C7526", "C7527", "C7528", "C7529", "C7530", "C7531", "C7532", "C7533", "C7534", "C7535", "C7537", "C7538", "C7539", "C7540", "C7541", "C7542", "C7543", "C7544", "C7545", "C7546", "C7547", "C7548", "C7549", "C7550", "C7551", "C7552", "C7554", "C7555", "C7556", "C7557", "C7558", "C7559", "C7560", "C7561", "C7562", "C7563", "C7564", "C7565", "C7566", "C7567", "C7568", "C7569", "C7570", "C7571", "C7572", "C7573", "C7574", "C7575", "C7576", "C7577", "C7578", "C7579", "C7580", "C7581", "C7582", "C7583", "C7584", "C7585", "C7586", "C7587", "C7588", "C7589", "C7590", "C7591", "C7592", "C7593", "C7594", "C7595", "C7596", "C7597", "C7598", "C7599", "C7600", "C7601", "C7602", "C7603", "C7604", "C7605", "C7606", "C7607", "C7608", "C7609", "C7610", "C7611", "C7612", "C7613", "C7614", "C7615", "C7616", "C7617", "C7618", "C7619", "C7620", "C7621", "C7622", "C7623", "C7624", "C7625", "C7627", "C7628", "C7629", "C7630", "C7631", "C7632", "C7633", "C7634", "C7635", "C7636", "C7637", "C7638", "C7639", "C7640", "C7641", "C7642", "C7643", "C7644", "C7645", "C7646", "C7647", "C7648", "C7649", "C7650", "C7651", "C7652", "C7653", "C7654", "C7655", "C7656", "C7657", "C7658", "C7659", "C7660", "C7661", "C7662", "C7665", "C7666", "C7667", "C7668", "C7669", "C7670", "C7671", "C7672", "C7673", "C7674", "C7675", "C7676", "C7677", "C7678", "C7679", "C7680", "C7682", "C7683", "C7684", "C7685", "C7686", "C7687", "C7689", "C7690", "C7691", "C7692", "C7693", "C7694", "C7695", "C7696", "C7697", "C7698", "C7699", "C7700", "C7701", "C7702", "C7703", "C7704", "C7705", "C7706", "C7707", "C7708", "C7709", "C7710", "C7711", "C7712", "C7713", "C7714", "C7720", "C7730", "C7731", "C7732", "C7733", "C7734", "C7735", "C7736", "C7737", "C7738", "C7739", "C7740", "C7741", "C7800", "C7801", "C7802", "C7803", "C7804", "C7806", "C7807"] +helpviewer_keywords: ["C7500", "C7501", "C7502", "C7503", "C7504", "C7505", "C7506", "C7507", "C7508", "C7509", "C7511", "C7512", "C7513", "C7514", "C7515", "C7516", "C7517", "C7518", "C7519", "C7520", "C7521", "C7522", "C7523", "C7524", "C7525", "C7526", "C7527", "C7528", "C7529", "C7530", "C7531", "C7532", "C7533", "C7534", "C7535", "C7537", "C7538", "C7539", "C7540", "C7541", "C7542", "C7543", "C7544", "C7545", "C7546", "C7547", "C7548", "C7549", "C7550", "C7551", "C7552", "C7554", "C7555", "C7556", "C7557", "C7558", "C7559", "C7560", "C7561", "C7562", "C7563", "C7564", "C7565", "C7566", "C7567", "C7568", "C7569", "C7570", "C7571", "C7572", "C7573", "C7574", "C7575", "C7576", "C7577", "C7578", "C7579", "C7580", "C7581", "C7582", "C7583", "C7584", "C7585", "C7586", "C7587", "C7588", "C7589", "C7590", "C7591", "C7592", "C7593", "C7594", "C7595", "C7596", "C7597", "C7598", "C7599", "C7600", "C7601", "C7602", "C7603", "C7604", "C7605", "C7606", "C7607", "C7608", "C7609", "C7610", "C7611", "C7612", "C7613", "C7614", "C7615", "C7616", "C7617", "C7618", "C7619", "C7620", "C7621", "C7622", "C7623", "C7624", "C7625", "C7627", "C7628", "C7629", "C7630", "C7631", "C7632", "C7633", "C7634", "C7635", "C7636", "C7637", "C7638", "C7639", "C7640", "C7641", "C7642", "C7643", "C7644", "C7645", "C7646", "C7647", "C7648", "C7649", "C7650", "C7651", "C7652", "C7653", "C7654", "C7655", "C7656", "C7657", "C7658", "C7659", "C7660", "C7661", "C7662", "C7665", "C7666", "C7667", "C7668", "C7669", "C7670", "C7671", "C7672", "C7673", "C7674", "C7675", "C7676", "C7677", "C7678", "C7679", "C7680", "C7682", "C7683", "C7684", "C7685", "C7686", "C7687", "C7689", "C7690", "C7691", "C7692", "C7693", "C7694", "C7695", "C7696", "C7697", "C7698", "C7699", "C7700", "C7701", "C7702", "C7703", "C7704", "C7705", "C7706", "C7707", "C7708", "C7709", "C7710", "C7711", "C7712", "C7713", "C7714", "C7720", "C7730", "C7731", "C7732", "C7733", "C7734", "C7735", "C7736", "C7737", "C7738", "C7739", "C7740", "C7741", "C7800", "C7801", "C7802", "C7803", "C7804", "C7806", "C7807"] --- # Compiler errors C7500 through C7999 @@ -42,7 +42,7 @@ The articles in this section of the documentation explain a subset of the error | Compiler error C7524 | 'inline' specifier cannot appear on a block-scope declaration or non-static data member | | Compiler error C7525 | inline variables require at least '%1$M' | | Compiler error C7526 | '%$I': inline variable is undefined | -| Compiler error C7527 | '%$I': template parameter name cannot be redeclared | +| Compiler error C7527 | '*identifier*': a template parameter name cannot be reused within its scope | | Compiler error C7528 | '%1$S': A default constructor or its exception specification cannot be used within a data member initializer of the same class | | Compiler error C7529 | multiple using-declarators require at least '%1$M' | | Compiler error C7530 | applying a pack-expansion to a using-declaration requires at least '%1$M' | @@ -58,7 +58,7 @@ The articles in this section of the documentation explain a subset of the error | Compiler error C7540 | '%1$I': member cannot have the same name as the enclosing class | | Compiler error C7541 | '%1$I': C++17 inline static data members are not compatible with managed types | | Compiler error C7542 | '%1$S': expected a type | -| Compiler error C7543 | likelihood attributes can only be applied to statements and labels | +| Compiler error C7543 | attribute `[[`*attribute*`]]` can only be applied to statements and labels | | Compiler error C7544 | standard attributes '%1$s' and '%2$s' are mutually exclusive | | Compiler error C7545 | attribute '%sno_unique_address' can only be applied to a non-static data member that is not a bitfield | | Compiler error C7546 | binary operator '<=>': unsupported operand types '%$T' and '%$T' | @@ -113,6 +113,7 @@ The articles in this section of the documentation explain a subset of the error | Compiler error C7595 | '%1$S': call to immediate function is not a constant expression | | Compiler error C7596 | '%1$S': cannot take address of immediate function outside of an immediate invocation | | Compiler error C7597 | '%1$D': 'consteval': overriding function must match overridden function | +| Compiler error C7598 | the constraint expression cannot use the concept name '*identifier*'| | Compiler error C7599 | '%1$S': a trailing requires clause is only allowed on a templated function | | Compiler error C7600 | '%1$S': the concept designated by a type constraint shall be a type concept | | Compiler error C7601 | the associated constraints are not satisfied | @@ -123,7 +124,7 @@ The articles in this section of the documentation explain a subset of the error | Compiler error C7606 | '%1$S': concept cannot be explicitly instantiated, explicitly specialized or partially specialized | | Compiler error C7607 | atomic constraint should be a constant expression of type 'bool', not '%1$T' | | Compiler error C7608 | atomic constraint should be a constant expression | -| Compiler error C7609 | '%1$S': type constraint expects a concept name | +| Compiler error C7609 | '*identifier*': expected a concept name for type constraint | | Compiler error C7610 | operator '%$L': not allowed between enumeration types and floating-point types | | Compiler error C7611 | operator '%$L': not allowed for array types | | Compiler error C7612 | could not find header unit for '%s' | @@ -163,8 +164,8 @@ The articles in this section of the documentation explain a subset of the error | Compiler error C7646 | destroying operator delete functions cannot be array delete operators 'operator delete[]' | | Compiler error C7647 | destroying operator delete functions must be usual deallocation functions | | Compiler error C7648 | a conversion function cannot have a trailing return type | -| Compiler error C7649 | attribute 'xfg::rename' may only be applied to structs, classes and virtual methods | -| Compiler error C7650 | attribute 'xfg::rename' must be passed a string argument | +| Compiler error C7649 | attribute '`[[xfg::rename]]`' may only be applied to structs, classes and virtual methods | +| Compiler error C7650 | attribute '`[[xfg::rename]]`' must be passed a string argument | | Compiler error C7651 | %1$I cannot be used with /await. Use '%2$M' or later for standard coroutine support | | Compiler error C7652 | if a member function has a trailing requires clause then another member function with the same signature, ignoring any trailing requires clause, cannot be virtual | | Compiler error C7653 | '%1$S': failed to select a destructor for the class | @@ -173,17 +174,81 @@ The articles in this section of the documentation explain a subset of the error | Compiler error C7656 | private module fragment cannot be redeclared | | Compiler error C7657 | private module fragment cannot be declared before a module declaration | | Compiler error C7658 | '%1$S': the initializer must be the address of a variable | -| Compiler error C7659 | attribute 'xfg::rename' may not be applied to nested class hierarchies | +| Compiler error C7659 | attribute '`[[xfg::rename]]`' may not be applied to nested class hierarchies | | Compiler error C7660 | '%s': requires '%s' command line option(s) | | Compiler error C7661 | header-name '%s' has an ambiguous resolution to header '%s' | | Compiler error C7662 | '%$S': a coroutine cannot be constexpr or consteval | +| Compiler error C7665 | '*operator*': you cannot assign to '`this`' as it is not an lvalue | +| Compiler error C7666 | you cannot apply '*operator*' to '`this`' as it is not an lvalue | +| Compiler error C7667 | no global `operator delete` function found | +| Compiler error C7668 | a function with an explicit object parameter must be a member function | +| Compiler error C7669 | a function with an explicit object parameter cannot be declared '`static`' | +| Compiler error C7670 | only the first parameter may be an explicit object parameter | +| Compiler error C7671 | a member function with an explicit object parameter may only have one such parameter | +| Compiler error C7672 | a member function with an explicit object parameter may not have trailing implicit object parameter specifiers | +| Compiler error C7673 | explicit object member functions requires at least '*C++ language version*' | +| Compiler error C7674 | member function '*function 1*' with explicit object parameter of type '*type 1*' cannot overload member function '*function 2*' with implicit object parameter of type '*type 2*' | +| Compiler error C7675 | cannot overload static member function with member function declaring the same non-object parameter types | +| Compiler error C7676 | member functions with an explicit object parameter cannot be defaulted | +| Compiler error C7677 | constructors cannot contain an explicit object parameter | +| Compiler error C7678 | member functions with an explicit object parameter cannot be virtual | +| Compiler error C7679 | an explicit object parameter cannot be a parameter pack | +| Compiler error C7680 | only function parameters may be explicit object parameters | +| Compiler error C7682 | '*declaration*': a non-defining declaration of an enumeration with a fixed underlying type is only permitted as a standalone declaration | +| Compiler error C7683 | you cannot create a reference to '`void`' | +| Compiler error C7684 | module name '*name*' has an ambiguous resolution to IFC | +| Compiler error C7685 | there is no type named '*identifier*' in '*type*' | +| Compiler error C7686 | attribute `[[msvc::constexpr]]` cannot be applied to a '`constexpr`' or '`consteval`' function | +| Compiler error C7687 | attribute `[[`*attribute*`]]` may only be applied to statements and functions | | [Compiler error C7688](compiler-error-c7688.md) | '`#pragma omp atomic`': expected an expression of scalar type | -| Compiler error C7686 | TOML parse error | +| Compiler error C7689 | attribute `[[msvc::intrinsic]]` cannot be applied to explicit specializations | +| Compiler error C7690 | attribute `[[msvc::intrinsic]]` cannot be applied to a recursive function | +| Compiler error C7691 | '`__super`' is not supported as '`/allowSuper-`' was specified | +| Compiler error C7692 | '*name*': rewritten candidate function was excluded from overload resolution because a corresponding `operator!=` declared in the same scope | +| Compiler error C7693 | constraints are not supported for managed types and constructs | +| Compiler error C7694 | managed type '*type*' used in a constraint definition or evaluation or in an entity that uses constraints | +| Compiler error C7695 | coroutine promise type '*type*' cannot be abstract | +| Compiler error C7696 | TOML parse error: *error name*; see '*TOML filename*' | +| Compiler error C7697 | '*header unit*' is not a recognized header-name lookup | +| Compiler error C7698 | '`__declspec(`*name*`(...))`' requires a single string argument | +| Compiler error C7699 | file mapping must be unique. Both '*name 1*' and '*name 2*' map to '*filename*' | | Compiler error C7700 | type '%$T' in _Generic association compatible with previous association type '%$T' | | Compiler error C7701 | default _Generic association previously specified | | Compiler error C7702 | no compatible type for '%$T' in _Generic association list | | Compiler error C7703 | inline nested namespaces requires at least '%1$M' | | Compiler error C7704 | '_Alignas' specifier can be used on variables and structure fields only | +| Compiler error C7705 | '`_Atomic`' type '*typename*' cannot be an array or function | +| Compiler error C7706 | '`_Atomic`' type '*typename*' cannot be atomic or CVR qualified | +| Compiler error C7707 | call to '*function*': argument type '*type*' must be a pointer to an atomic type | +| Compiler error C7708 | '*variable*': '`thread_local`' is only valid on variables at file or block scope | +| Compiler error C7709 | '*variable*': '`thread_local`' variables at block scope must be marked `static` | +| Compiler error C7710 | '*variable*': bit-fields cannot be atomic | +| Compiler error C7711 | '`_Atomic`' cannot be applied to incomplete type '*type*' | +| Compiler error C7712 | address argument to atomic operation must be a pointer to an atomic integer, '*type*' is not valid | +| Compiler error C7713 | a statement-expression may only appear inside a function body | +| Compiler error C7714 | the syntax for a 'statement-expression' is '`__extension__ ({ S1; ... ; Sn; })`' | +| Compiler error C7720 | bound for nested loop to be collapsed does not conform to the OpenMP specification | +| Compiler error C7730 | '`#`*directive*' directive requires '*language version*' or later | +| Compiler error C7731 | '*name*' is not allowed on a constructor declaration | +| Compiler error C7732 | expected an expression before '`]`' | +| Compiler error C7733 | the built-in subscript operator expects a single expression | +| Compiler error C7734 | '`size_t`' literal is out of range of possible '`size_t`' values | +| Compiler error C7735 | a lambda cannot be both '`static`' and '`mutable`' | +| Compiler error C7736 | a static lambda must have an empty capture-clause | +| Compiler error C7737 | a lambda with an explicit object parameter shall be neither '`mutable`' nor '`static`' | +| Compiler error C7738 | '`if consteval`' requires a compound statement | +| Compiler error C7739 | cannot jump from this `goto` statement to its label | +| Compiler error C7740 | cannot jump to case label | +| Compiler error C7741 | ABI inconsistency: '*function*' was originally assumed to use '`C`' return semantics but now it requires '`C++`' return semantics | +| [Compiler error C7742](compiler-error-c7742.md) | '*identifier*': a forward declaration of an enum can only use a simple identifier | +| Compiler error C7743 | [`__preserve_none` calling convention](../../cpp/preserve-none.md) is not supported | +| Compiler error C7800 | duplicate explicit instantiation definition of '*name*' | +| Compiler error C7801 | '*function*': if one declaration of '*identifier*' has the '`[[msvc::disptach]]`' attribute then all functions must have the attribute | +| Compiler error C7802 | '*identifier*': a capability must resolve to an enumerator | +| Compiler error C7803 | '*identifier*': a capability must be associated with a non-overloaded, non-virtual function | +| Compiler error C7804 | '*identifier*': cannot find a matching default dispatch function | +| Compiler error C7806 | support for the '`msvc::dispatch`' attribute requires '`/experimental:loadTimeSelection`' | +| Compiler error C7807 | expecting a narrow string literal | ## See also diff --git a/docs/error-messages/compiler-warnings/c4371.md b/docs/error-messages/compiler-warnings/c4371.md index aed32ad81b3..44dfa2efae5 100644 --- a/docs/error-messages/compiler-warnings/c4371.md +++ b/docs/error-messages/compiler-warnings/c4371.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: Compiler Warning (level 3, off) C4371" title: "Compiler Warning (level 3, off) C4371" -ms.date: "01/31/2018" +description: "Learn more about: Compiler Warning (level 3, off) C4371" +ms.date: 01/31/2018 f1_keywords: ["C4371"] helpviewer_keywords: ["C4371"] --- @@ -9,6 +9,8 @@ helpviewer_keywords: ["C4371"] > '*classname*': layout of class may have changed from a previous version of the compiler due to better packing of member '*member*' +## Remarks + Warning C4371 tells you that the layout created by the current compiler may be different from the layout generated by previous versions of the compiler. This difference may be significant for serialization operations or operating system interfaces that rely on a particular memory layout. In most other cases, this warning is safe to ignore. Warning C4371 is off by default. For more information, see [Compiler Warnings That Are Off By Default](../../preprocessor/compiler-warnings-that-are-off-by-default.md). diff --git a/docs/error-messages/compiler-warnings/c4388.md b/docs/error-messages/compiler-warnings/c4388.md index ee8b36db8d8..5f4c698f08e 100644 --- a/docs/error-messages/compiler-warnings/c4388.md +++ b/docs/error-messages/compiler-warnings/c4388.md @@ -9,17 +9,17 @@ helpviewer_keywords: ["C4388"] > '*token*' : signed/unsigned mismatch -Using the *token* operator to compare a **`signed`** and a larger **`unsigned`** number required the compiler to convert the **`signed`** value to the larger **`unsigned`** type. - ## Remarks +Using the *token* operator to compare a **`signed`** and a larger **`unsigned`** number required the compiler to convert the **`signed`** value to the larger **`unsigned`** type. + One way to fix this warning is if you cast one of the two types when you compare **`signed`** and larger **`unsigned`** types. This warning is off by default. You can use [/Wall](../../build/reference/compiler-option-warning-level.md) or **`/w44388`** to enable it on the command line as a level 4 warning. Or, use [`#pragma warning(default:4388)`](../../preprocessor/warning.md) in your source file. For more information, see [Compiler warnings that are off by default](../../preprocessor/compiler-warnings-that-are-off-by-default.md). ## Example -This sample generates C4388 and shows how to fix it: +This example generates C4388 and shows how to fix it: ```cpp // C4388.cpp diff --git a/docs/error-messages/compiler-warnings/c4473.md b/docs/error-messages/compiler-warnings/c4473.md index b10194290b8..5dfe94c2862 100644 --- a/docs/error-messages/compiler-warnings/c4473.md +++ b/docs/error-messages/compiler-warnings/c4473.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4473" title: "Compiler Warning C4473" -ms.date: "02/16/2018" +description: "Learn more about: Compiler Warning (level 1) C4473" +ms.date: 02/16/2018 f1_keywords: ["C4473"] helpviewer_keywords: ["C4473"] --- @@ -54,3 +54,7 @@ void scan_func(int a, float f) ``` In this example, **scanf_s** requires two arguments for each placeholder, one to supply the address to write to, and a second to supply the size of the first. Check the documentation for each library function for an explanation of the required arguments. + +## See also + +[C6064](../../code-quality/c6064.md) diff --git a/docs/error-messages/compiler-warnings/c4477.md b/docs/error-messages/compiler-warnings/c4477.md index 6a661707d9b..e9d25f97453 100644 --- a/docs/error-messages/compiler-warnings/c4477.md +++ b/docs/error-messages/compiler-warnings/c4477.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4477" title: "Compiler Warning C4477" -ms.date: "02/16/2018" +description: "Learn more about: Compiler Warning (level 1) C4477" +ms.date: 02/16/2018 f1_keywords: ["C4477"] helpviewer_keywords: ["C4477"] --- @@ -9,6 +9,8 @@ helpviewer_keywords: ["C4477"] > '*function*' : format string '*string*' requires an argument of type '*type*', but variadic argument *number* has type '*type*' +## Remarks + The compiler detected a mismatch between the type of argument required to satisfy the placeholder in a format string, and the type of argument supplied. Correct use of the printf and scanf families of variadic functions requires that you supply arguments of the types specified by the format string. A mismatch generally means there is a bug in your code. For information on the arguments associated with printf family format string placeholders, see [Format specification syntax: printf and wprintf functions](../../c-runtime-library/format-specification-syntax-printf-and-wprintf-functions.md). See the documentation for information specific to function *function*. @@ -17,7 +19,7 @@ This warning is new in Visual Studio 2015. ## Example -This sample shows two C4477 warnings for the first printf_s function, when two arguments are found to be of the wrong type, and also shows how to fix the issues. +This example shows two C4477 warnings for the first printf_s function, when two arguments are found to be of the wrong type, and also shows how to fix the issues. ```cpp // C4477p.cpp diff --git a/docs/error-messages/compiler-warnings/c4596.md b/docs/error-messages/compiler-warnings/c4596.md index 9c7afed4d11..1f2156b3c89 100644 --- a/docs/error-messages/compiler-warnings/c4596.md +++ b/docs/error-messages/compiler-warnings/c4596.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: Compiler Warning (level 4) C4596" title: "Compiler Warning (Level 4) C4596" -ms.date: "08/15/2019" +description: "Learn more about: Compiler Warning (level 4) C4596" +ms.date: 08/15/2019 f1_keywords: ["C4596"] helpviewer_keywords: ["C4596"] --- @@ -19,7 +19,7 @@ This warning is available starting in Visual Studio 2015 Update 3. Code that com ## Example -This sample generates C4596, and shows a way to fix it: +This example generates C4596, and shows a way to fix it: ```cpp // C4596.cpp diff --git a/docs/error-messages/compiler-warnings/c4597.md b/docs/error-messages/compiler-warnings/c4597.md index 9d3a66071fa..55790a29b4f 100644 --- a/docs/error-messages/compiler-warnings/c4597.md +++ b/docs/error-messages/compiler-warnings/c4597.md @@ -1,6 +1,6 @@ --- -description: "Learn more about: Compiler Warning (error) C4597" title: "Compiler Warning (error) C4597" +description: "Learn more about: Compiler Warning (error) C4597" ms.date: 05/03/2021 f1_keywords: ["C4597"] helpviewer_keywords: ["C4597"] @@ -9,10 +9,10 @@ helpviewer_keywords: ["C4597"] > undefined behavior: `offsetof` applied to a member of a virtual base -Using `offsetof(T, m)` where *`m`* refers to a static data member or a member function results in C4597. - ## Remarks +Using `offsetof(T, m)` where *`m`* refers to a static data member or a member function results in C4597. + This warning is new in Visual Studio 2017 version 15.3. It's reported as an error by default. For information on how to disable warnings by compiler version, see [Compiler warnings by compiler version](compiler-warnings-by-compiler-version.md). ## Example diff --git a/docs/error-messages/compiler-warnings/c4698.md b/docs/error-messages/compiler-warnings/c4698.md index cc66fdd20a6..91fb47a5c74 100644 --- a/docs/error-messages/compiler-warnings/c4698.md +++ b/docs/error-messages/compiler-warnings/c4698.md @@ -1,6 +1,6 @@ --- -description: "Learn about the cause and fixes for Compiler warning (level 3) C4698." title: "Compiler warning (Level 4) C4698" +description: "Learn about the cause and fixes for Compiler warning (level 3) C4698." ms.date: 04/18/2021 f1_keywords: ["C4698"] helpviewer_keywords: ["C4698"] diff --git a/docs/error-messages/compiler-warnings/c4768.md b/docs/error-messages/compiler-warnings/c4768.md index ac07f56f108..d2338975995 100644 --- a/docs/error-messages/compiler-warnings/c4768.md +++ b/docs/error-messages/compiler-warnings/c4768.md @@ -1,6 +1,6 @@ --- -description: "Learn more about: Compiler Warning (level 3) C4768" title: "Compiler Warning (level 3) C4768" +description: "Learn more about: Compiler Warning (level 3) C4768" ms.date: 05/03/2021 f1_keywords: ["C4768"] helpviewer_keywords: ["C4768"] @@ -9,10 +9,10 @@ helpviewer_keywords: ["C4768"] > `__declspec` attributes before linkage specification are ignored -The compiler warns if `__declspec(...)` is applied before the `extern "C"` linkage specification. Previously, the compiler would ignore the attribute, which could have runtime implications. - ## Remarks +The compiler warns if `__declspec(...)` is applied before the `extern "C"` linkage specification. Previously, the compiler would ignore the attribute, which could have runtime implications. + This warning is new in Visual Studio 2017 version 15.3, which left it off by default. It's enabled by default as a level 3 warning starting in Visual Studio 2017 version 15.5. For information on how to disable warnings by compiler version, see [Compiler warnings by compiler version](compiler-warnings-by-compiler-version.md). ## Example diff --git a/docs/error-messages/compiler-warnings/c4770.md b/docs/error-messages/compiler-warnings/c4770.md index 3acd9eddc4f..f82f6915475 100644 --- a/docs/error-messages/compiler-warnings/c4770.md +++ b/docs/error-messages/compiler-warnings/c4770.md @@ -1,6 +1,6 @@ --- -description: "Learn more about: Compiler Warning (level 4) C4770" title: "Compiler Warning (level 4) C4770" +description: "Learn more about: Compiler Warning (level 4) C4770" ms.date: 11/02/2022 f1_keywords: ["C4770"] helpviewer_keywords: ["C4770"] @@ -9,10 +9,10 @@ helpviewer_keywords: ["C4770"] > partially validated enum '*symbol*' used as index -The compiler warns if an enum value is cast or aliased to an integer type, but the result isn't checked for non-negative or excessive values. - ## Remarks +The compiler warns if an enum value is cast or aliased to an integer type, but the result isn't checked for non-negative or excessive values. + This warning is new in Visual Studio 2013. It's not enabled by default. To enable it as a level 1 warning, use `/w14770`. For information on how to disable warnings by compiler version, see [Compiler warnings by compiler version](compiler-warnings-by-compiler-version.md). ## Example diff --git a/docs/error-messages/compiler-warnings/c4834.md b/docs/error-messages/compiler-warnings/c4834.md index 7012f5c3c69..aca33a0eb14 100644 --- a/docs/error-messages/compiler-warnings/c4834.md +++ b/docs/error-messages/compiler-warnings/c4834.md @@ -1,6 +1,6 @@ --- -description: "Learn about the cause and fixes for Compiler warning (level 1) C4834." title: "Compiler warning (Level 1) C4834" +description: "Learn about the cause and fixes for Compiler warning (level 1) C4834." ms.date: 01/18/2024 f1_keywords: ["C4834"] helpviewer_keywords: ["C4834"] @@ -30,7 +30,7 @@ To turn off the warning for an entire project in the Visual Studio IDE: ## Example -This sample generates C4834, and shows four ways to fix it: +This example generates C4834, and shows four ways to fix it: ```cpp // C4834.cpp @@ -43,7 +43,7 @@ int square_of(int i) { return i * i; } int main() { square_of(42); // warning C4834: discarding return value of function with 'nodiscard' attribute - // If ignoring the [[nodiscard] attribute is unintentional, make use of the return value as intended: + // If ignoring the [[nodiscard]] attribute is unintentional, make use of the return value as intended: // For example: std::cout << "square_of(42) = " << square_of(42) << "\n"; // Ok // Or: diff --git a/docs/error-messages/compiler-warnings/c4841.md b/docs/error-messages/compiler-warnings/c4841.md index 89b7db20d63..d4b9c5b80f3 100644 --- a/docs/error-messages/compiler-warnings/c4841.md +++ b/docs/error-messages/compiler-warnings/c4841.md @@ -1,6 +1,6 @@ --- -description: "Learn more about: Compiler Warning (level 4) C4841" title: "Compiler Warning (level 4) C4841" +description: "Learn more about: Compiler Warning (level 4) C4841" ms.date: 05/03/2021 f1_keywords: ["C4841"] helpviewer_keywords: ["C4841"] diff --git a/docs/error-messages/compiler-warnings/c4843.md b/docs/error-messages/compiler-warnings/c4843.md index f867eaa11b6..857df4af62d 100644 --- a/docs/error-messages/compiler-warnings/c4843.md +++ b/docs/error-messages/compiler-warnings/c4843.md @@ -1,6 +1,6 @@ --- -description: "Learn more about: Compiler Warning (level 4) C4843" title: "Compiler Warning (level 4) C4843" +description: "Learn more about: Compiler Warning (level 4) C4843" ms.date: 05/03/2021 f1_keywords: ["C4843"] helpviewer_keywords: ["C4843"] @@ -17,7 +17,7 @@ This warning is new in Visual Studio 2017 version 15.5. For information on how t ## Example -This sample shows several **`catch`** statements that cause C4843: +This example shows several **`catch`** statements that cause C4843: ```cpp // C4843_warning.cpp diff --git a/docs/error-messages/compiler-warnings/c4866.md b/docs/error-messages/compiler-warnings/c4866.md index 66c73becda2..5a5400220b3 100644 --- a/docs/error-messages/compiler-warnings/c4866.md +++ b/docs/error-messages/compiler-warnings/c4866.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: Compiler Warning (level 4) C4866" title: "Compiler Warning (Level 4) C4866" -ms.date: "09/30/2018" +description: "Learn more about: Compiler Warning (level 4) C4866" +ms.date: 09/30/2018 f1_keywords: ["C4866"] helpviewer_keywords: ["C4866"] --- @@ -25,11 +25,11 @@ This warning was introduced in Visual Studio 2017 version 15.9 as a result of co To resolve this warning, first consider whether left-to-right evaluation of the operator elements is necessary, such as when evaluation of the elements might produce order-dependent side-effects. In many cases, the order in which elements are evaluated does not have an observable effect. -If the order of evaluation must be left-to-right, consider whether you can pass the elements by **`const`** reference instead. This change eliminates the warning in the following code sample. +If the order of evaluation must be left-to-right, consider whether you can pass the elements by **`const`** reference instead. This change eliminates the warning in the following code example. ## Example -This sample generates C4866, and shows a way to fix it: +This example generates C4866, and shows a way to fix it: ```cpp // C4866.cpp diff --git a/docs/error-messages/compiler-warnings/c5033.md b/docs/error-messages/compiler-warnings/c5033.md index d60b67afabf..c816d98078c 100644 --- a/docs/error-messages/compiler-warnings/c5033.md +++ b/docs/error-messages/compiler-warnings/c5033.md @@ -1,6 +1,6 @@ --- title: "Compiler warning C5033" -description: Describes the causes and fixes for compiler warning C5033. +description: "Describes the causes and fixes for compiler warning C5033." ms.date: 05/03/2021 f1_keywords: ["C5033"] helpviewer_keywords: ["C5033"] @@ -9,10 +9,10 @@ helpviewer_keywords: ["C5033"] > '*storage-class-keyword*' is no longer a supported storage class -The **`auto`** and **`register`** storage class keywords have been deprecated or removed from the C++ language. - ## Remarks +The **`auto`** and **`register`** storage class keywords have been deprecated or removed from the C++ language. + **Visual Studio 2010 and later:** In C++11, the **`auto`** keyword is no longer a C++ storage-class specifier, and the **`register`** keyword is deprecated. **Visual Studio 2017 version 15.7 and later:** (available in [`/std:c++17`](../../build/reference/std-specify-language-standard-version.md) mode and later): The **`register`** keyword is removed from the C++ language in C++17 and later standards. diff --git a/docs/error-messages/compiler-warnings/c5037.md b/docs/error-messages/compiler-warnings/c5037.md index 95c12967f23..d55293db78a 100644 --- a/docs/error-messages/compiler-warnings/c5037.md +++ b/docs/error-messages/compiler-warnings/c5037.md @@ -1,6 +1,6 @@ --- title: "Compiler warning C5037" -description: Describes the causes and fixes for compiler warning C5037. +description: "Describes the causes and fixes for compiler warning C5037." ms.date: 04/18/2021 f1_keywords: ["C5037"] helpviewer_keywords: ["C5037"] diff --git a/docs/error-messages/compiler-warnings/c5038.md b/docs/error-messages/compiler-warnings/c5038.md index a5ecba20d56..9046d2792d6 100644 --- a/docs/error-messages/compiler-warnings/c5038.md +++ b/docs/error-messages/compiler-warnings/c5038.md @@ -1,6 +1,6 @@ --- title: "Compiler Warning C5038" -description: Describes the causes and fixes for compiler warning C5038. +description: "Describes the causes and fixes for compiler warning C5038." ms.date: 05/03/2021 f1_keywords: ["C5038"] helpviewer_keywords: ["C5038"] diff --git a/docs/error-messages/compiler-warnings/c5045.md b/docs/error-messages/compiler-warnings/c5045.md index 13e3406a604..d9d9bc3aea7 100644 --- a/docs/error-messages/compiler-warnings/c5045.md +++ b/docs/error-messages/compiler-warnings/c5045.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: Compiler Warning C5045" title: "Compiler Warning C5045" -ms.date: "06/21/2018" +description: "Learn more about: Compiler Warning C5045" +ms.date: 06/21/2018 f1_keywords: ["C5045"] helpviewer_keywords: ["C5045"] --- diff --git a/docs/error-messages/compiler-warnings/c5046.md b/docs/error-messages/compiler-warnings/c5046.md index 83c0ba4b116..2cfd74a6498 100644 --- a/docs/error-messages/compiler-warnings/c5046.md +++ b/docs/error-messages/compiler-warnings/c5046.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: Compiler Warning (level 2) C5046" title: "Compiler Warning C5046" -ms.date: "03/21/2019" +description: "Learn more about: Compiler Warning (level 2) C5046" +ms.date: 03/21/2019 f1_keywords: ["C5046"] helpviewer_keywords: ["C5046"] --- @@ -25,7 +25,7 @@ This warning is new in Visual Studio 2017 version 15.8. ## Example -This sample shows two C5046 warnings: +This example shows two C5046 warnings: ```cpp // C5046p.cpp diff --git a/docs/error-messages/compiler-warnings/c5050.md b/docs/error-messages/compiler-warnings/c5050.md index 37158601358..7df6abc376f 100644 --- a/docs/error-messages/compiler-warnings/c5050.md +++ b/docs/error-messages/compiler-warnings/c5050.md @@ -1,6 +1,6 @@ --- title: "Compiler Warning C5050" -description: Compiler warning C5050 description and solution. +description: "Compiler warning C5050 description and solution." ms.date: 05/03/2021 f1_keywords: ["C5050"] helpviewer_keywords: ["C5050"] diff --git a/docs/error-messages/compiler-warnings/c5054.md b/docs/error-messages/compiler-warnings/c5054.md index ba2e219746f..669dbdd5b40 100644 --- a/docs/error-messages/compiler-warnings/c5054.md +++ b/docs/error-messages/compiler-warnings/c5054.md @@ -1,6 +1,6 @@ --- title: "Compiler Warning C5054" -description: Compiler warning C5054 description and solution. +description: "Compiler warning C5054 description and solution." ms.date: 02/22/2022 f1_keywords: ["C5054"] helpviewer_keywords: ["C5054"] diff --git a/docs/error-messages/compiler-warnings/c5055.md b/docs/error-messages/compiler-warnings/c5055.md index 4cca582e6c3..4a469b06fd3 100644 --- a/docs/error-messages/compiler-warnings/c5055.md +++ b/docs/error-messages/compiler-warnings/c5055.md @@ -1,6 +1,6 @@ --- title: "Compiler Warning C5055" -description: Compiler warning C5055 description and solution. +description: "Compiler warning C5055 description and solution." ms.date: 02/22/2022 f1_keywords: ["C5055"] helpviewer_keywords: ["C5055"] diff --git a/docs/error-messages/compiler-warnings/c5056.md b/docs/error-messages/compiler-warnings/c5056.md index cb757f7ad98..8d775f210eb 100644 --- a/docs/error-messages/compiler-warnings/c5056.md +++ b/docs/error-messages/compiler-warnings/c5056.md @@ -1,6 +1,6 @@ --- title: "Compiler Warning C5056" -description: Compiler warning C5056 description and solution. +description: "Compiler warning C5056 description and solution." ms.date: 02/22/2022 f1_keywords: ["C5056"] helpviewer_keywords: ["C5056"] diff --git a/docs/error-messages/compiler-warnings/c5105.md b/docs/error-messages/compiler-warnings/c5105.md index e7167acca07..e1f17302e9a 100644 --- a/docs/error-messages/compiler-warnings/c5105.md +++ b/docs/error-messages/compiler-warnings/c5105.md @@ -1,7 +1,7 @@ --- title: "Compiler Warning C5105" -description: Compiler warning C5105 description and solution. -ms.date: "09/22/2019" +description: "Compiler warning C5105 description and solution." +ms.date: 09/22/2019 f1_keywords: ["C5105"] helpviewer_keywords: ["C5105"] --- @@ -29,7 +29,7 @@ To turn off the warning for an entire project in the Visual Studio IDE: ## Example -This sample program shows how to generate warning C5105, and how to fix it. +This example program shows how to generate warning C5105, and how to fix it. ```cpp // C5105.cpp diff --git a/docs/error-messages/compiler-warnings/c5208.md b/docs/error-messages/compiler-warnings/c5208.md index 53a7f3b9eaf..a1369dcd380 100644 --- a/docs/error-messages/compiler-warnings/c5208.md +++ b/docs/error-messages/compiler-warnings/c5208.md @@ -1,6 +1,6 @@ --- title: "Compiler Warning C5208, Error C7626" -description: Compiler warning C5208 and error C7626 description and solution. +description: "Compiler warning C5208 and error C7626 description and solution." ms.date: 04/18/2021 f1_keywords: ["C5208", "C7626"] helpviewer_keywords: ["C5208", "C7626"] @@ -33,7 +33,7 @@ To turn off the warning for an entire project in the Visual Studio IDE: ## Example -The following sample shows the constructs that are no longer allowed in unnamed structs. Depending on the standards mode specified, C5208 or C7626 errors or warnings are emitted: +The following example shows the constructs that are no longer allowed in unnamed structs. Depending on the standards mode specified, C5208 or C7626 errors or warnings are emitted: ```cpp struct Base { }; diff --git a/docs/error-messages/compiler-warnings/c5240.md b/docs/error-messages/compiler-warnings/c5240.md index 8389182d68d..942056d2bcd 100644 --- a/docs/error-messages/compiler-warnings/c5240.md +++ b/docs/error-messages/compiler-warnings/c5240.md @@ -1,6 +1,6 @@ --- title: "Compiler Warning C5240" -description: Compiler warning C5240 description and solution. +description: "Compiler warning C5240 description and solution." ms.date: 02/22/2022 f1_keywords: ["C5240"] helpviewer_keywords: ["C5240"] diff --git a/docs/error-messages/compiler-warnings/c5243.md b/docs/error-messages/compiler-warnings/c5243.md index 0679327d677..3a14cbf8fee 100644 --- a/docs/error-messages/compiler-warnings/c5243.md +++ b/docs/error-messages/compiler-warnings/c5243.md @@ -1,6 +1,6 @@ --- -title: Compiler warning C5243 -description: Compiler warning C5243 description and solution. +title: "Compiler warning C5243" +description: "Compiler warning C5243 description and solution." ms.date: 08/09/2021 f1_keywords: ["C5243"] helpviewer_keywords: ["C5243"] diff --git a/docs/error-messages/compiler-warnings/c5247.md b/docs/error-messages/compiler-warnings/c5247.md index 6ac55f629e1..f3d1101d2c1 100644 --- a/docs/error-messages/compiler-warnings/c5247.md +++ b/docs/error-messages/compiler-warnings/c5247.md @@ -1,6 +1,6 @@ --- title: "Compiler Warning C5247" -description: Compiler warning C5247 description and solution. +description: "Compiler warning C5247 description and solution." ms.date: 08/02/2021 f1_keywords: ["C5247"] helpviewer_keywords: ["C5247"] diff --git a/docs/error-messages/compiler-warnings/c5248.md b/docs/error-messages/compiler-warnings/c5248.md index 255771462ec..ea45b79264c 100644 --- a/docs/error-messages/compiler-warnings/c5248.md +++ b/docs/error-messages/compiler-warnings/c5248.md @@ -1,6 +1,6 @@ --- title: "Compiler Warning C5248" -description: Compiler warning C5248 description and solution. +description: "Compiler warning C5248 description and solution." ms.date: 08/02/2021 f1_keywords: ["C5248"] helpviewer_keywords: ["C5248"] diff --git a/docs/error-messages/compiler-warnings/c5262.md b/docs/error-messages/compiler-warnings/c5262.md index d51098ead1a..48fcd340ecc 100644 --- a/docs/error-messages/compiler-warnings/c5262.md +++ b/docs/error-messages/compiler-warnings/c5262.md @@ -1,6 +1,6 @@ --- title: "Compiler warning (level 1, error, off) C5262" -description: Compiler warning C5262 description and solution. +description: "Compiler warning C5262 description and solution." ms.date: 03/01/2023 f1_keywords: ["C5262"] helpviewer_keywords: ["C5262"] @@ -17,7 +17,7 @@ Compiler warning C5262 is new in Visual Studio 2022 version 17.4, and is both of ## Example -The sample code shows diagnostics for `switch` cases that fall through without `break` or `return` statements or the `[[fallthrough]]` attribute. +The example code shows diagnostics for `switch` cases that fall through without `break` or `return` statements or the `[[fallthrough]]` attribute. ```cpp // C5262.cpp diff --git a/docs/error-messages/compiler-warnings/c5267.md b/docs/error-messages/compiler-warnings/c5267.md index 23b1a7a5db6..a43a8ec9824 100644 --- a/docs/error-messages/compiler-warnings/c5267.md +++ b/docs/error-messages/compiler-warnings/c5267.md @@ -1,6 +1,6 @@ --- title: "Compiler warning C5267" -description: Learn about compiler warning C5267 +description: "Learn about compiler warning C5267" ms.date: 11/08/2023 f1_keywords: ["C5267"] helpviewer_keywords: ["C5267"] diff --git a/docs/error-messages/compiler-warnings/c5301-c5302.md b/docs/error-messages/compiler-warnings/c5301-c5302.md index 0283c7f2f6d..4bc84869d81 100644 --- a/docs/error-messages/compiler-warnings/c5301-c5302.md +++ b/docs/error-messages/compiler-warnings/c5301-c5302.md @@ -1,6 +1,6 @@ --- title: "Compiler warnings (level 1) C5301 and C5302" -description: Compiler warnings C5301 and C5302 description and solution. +description: "Compiler warnings C5301 and C5302 description and solution." ms.date: 03/01/2023 f1_keywords: ["C5301", "C5302"] helpviewer_keywords: ["C5301", "C5302"] @@ -19,7 +19,7 @@ These compiler warnings are new in Visual Studio 2022 version 17.4. ## Example -The sample code shows a diagnostic for a `for` loop that decrements the index, but it uses a `<=` comparison that tests whether the index is less than a value higher than the starting value. +The example code shows a diagnostic for a `for` loop that decrements the index, but it uses a `<=` comparison that tests whether the index is less than a value higher than the starting value. ```C // C5302.c diff --git a/docs/error-messages/compiler-warnings/compiler-warning-c4335.md b/docs/error-messages/compiler-warnings/compiler-warning-c4335.md index e57e115b0be..2f17fe0d623 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-c4335.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-c4335.md @@ -1,7 +1,7 @@ --- +title: "Compiler Warning (level 1) C4335" description: "Learn more about: Compiler Warning (level 1) C4335" -title: "Compiler Warning(level 1) C4335" -ms.date: "11/04/2016" +ms.date: 11/04/2016 f1_keywords: ["C4335"] helpviewer_keywords: ["C4335"] --- @@ -9,6 +9,8 @@ helpviewer_keywords: ["C4335"] > Mac file format detected: please convert the source file to either DOS or UNIX format +## Remarks + The line termination character of the first line of a source file is the old Macintosh style ('\r') as opposed to UNIX ('\n') or DOS ('\r\n'). This warning is only issued once per translation unit. Therefore, if there are multiple `#include` directives that specify files in Macintosh format, C4335 is emitted once. @@ -17,7 +19,7 @@ One way to generate files in Macintosh format is by using the **Advanced Save Op ## Example -The following sample generates C4335. +The following example generates C4335: ```cpp // C4335 expected diff --git a/docs/error-messages/compiler-warnings/compiler-warning-c4355.md b/docs/error-messages/compiler-warnings/compiler-warning-c4355.md index f32d4d86f97..132a3ccf66b 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-c4355.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-c4355.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: Compiler Warning (level 1 and level 4, off) C4355" title: "Compiler Warning (level 1 and level 4, off) C4355" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1 and level 4, off) C4355" +ms.date: 11/04/2016 f1_keywords: ["C4355"] helpviewer_keywords: ["C4355"] --- @@ -9,13 +9,17 @@ helpviewer_keywords: ["C4355"] > '`this`': used in base member initializer list +## Remarks + The `this` pointer is valid only within nonstatic member functions. It can't be used in the initializer list for a base class. The base-class constructors and class member constructors are called before `this` constructor. This pattern is the same as passing a pointer to an unconstructed object to another constructor. If those other constructors access any members or call member functions on `this`, the result is undefined. You shouldn't use the `this` pointer until all construction is complete. This warning is off by default. For more information, see [Compiler Warnings That Are Off by Default](../../preprocessor/compiler-warnings-that-are-off-by-default.md). -The following sample generates C4355: +## Example + +The following example generates C4355: ```cpp // C4355.cpp @@ -25,7 +29,7 @@ The following sample generates C4355: class CDerived; class CBase { public: - CBase(CDerived *derived): m_pDerived(derived) {}; + CBase(CDerived *derived): m_pDerived(derived) {} ~CBase(); virtual void function() = 0; @@ -34,8 +38,8 @@ public: class CDerived : public CBase { public: - CDerived() : CBase(this) {}; // C4355 "this" used in derived c'tor - virtual void function() {}; + CDerived() : CBase(this) {} // C4355 "this" used in derived c'tor + virtual void function() {} }; CBase::~CBase() { diff --git a/docs/error-messages/compiler-warnings/compiler-warning-c4368.md b/docs/error-messages/compiler-warnings/compiler-warning-c4368.md index 0d5f9305326..94a975c3cd8 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-c4368.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-c4368.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: Compiler Warning (level 1, Error) C4368" title: "Compiler Warning (level 1, Error) C4368" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1, Error) C4368" +ms.date: 11/04/2016 f1_keywords: ["C4368"] helpviewer_keywords: ["C4368"] --- @@ -9,6 +9,8 @@ helpviewer_keywords: ["C4368"] > cannot define 'member' as a member of managed 'type': mixed types are not supported +## Remarks + You can't embed a native data member in a managed type. You can, however, declare a pointer to a native type and control its lifetime in the constructor and destructor and finalizer of your managed class. For more information, see [Destructors and finalizers](../../dotnet/how-to-define-and-consume-classes-and-structs-cpp-cli.md#BKMK_Destructors_and_finalizers). @@ -17,7 +19,7 @@ This warning is always issued as an error. Use the [warning](../../preprocessor/ ## Example -The following sample generates C4368. +The following example generates C4368. ```cpp // C4368.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-c4394.md b/docs/error-messages/compiler-warnings/compiler-warning-c4394.md index d49d391ea0b..128be88cbc4 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-c4394.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-c4394.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: Compiler Warning (level 1, Error) C4394" title: "Compiler Warning (level 1, Error) C4394" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1, Error) C4394" +ms.date: 11/04/2016 f1_keywords: ["C4394"] helpviewer_keywords: ["C4394"] --- @@ -9,6 +9,8 @@ helpviewer_keywords: ["C4394"] > 'function' : per-appdomain symbol should not be marked with __declspec(dllexport) +## Remarks + A function marked with the [appdomain](../../cpp/appdomain.md) **`__declspec`** modifier is compiled to MSIL (not native), and export tables ([export](../../windows/attributes/export.md) **`__declspec`** modifier) aren't supported for managed functions. You can declare a managed function to have public accessibility. For more information, see [Type visibility](../../dotnet/how-to-define-and-consume-classes-and-structs-cpp-cli.md#BKMK_Type_visibility) and [Member visibility](../../dotnet/how-to-define-and-consume-classes-and-structs-cpp-cli.md#BKMK_Member_visibility). @@ -17,7 +19,7 @@ C4394 is always issued as an error. You can turn off this warning or change its ## Example -The following sample generates C4394. +The following example generates C4394. ```cpp // C4394.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-c4430.md b/docs/error-messages/compiler-warnings/compiler-warning-c4430.md index 15c04e3b0fd..82777f11454 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-c4430.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-c4430.md @@ -1,36 +1,35 @@ --- -description: "Learn more about: Compiler Warning C4430" -title: "Compiler Warning C4430" -ms.date: "11/04/2016" +title: "Compiler warning (level 1, error) C4430" +description: "Learn more about: Compiler Warning (level 1, error) C4430" +ms.date: 04/22/2025 f1_keywords: ["C4430"] helpviewer_keywords: ["C4430"] -ms.assetid: 12efbfff-aa58-4a86-a7d6-2c6a12d01dd3 --- -# Compiler Warning C4430 +# Compiler Warning (level 1, Error) C4430 -missing type specifier - int assumed. Note: C++ does not support default-int +> missing type specifier - int assumed. Note: C++ does not support default-int -This error can be generated as a result of compiler conformance work that was done for Visual Studio 2005: all declarations must explicitly specify the type; int is no longer assumed. +## Remarks -C4430 is always issued as an error. You can turn off this warning with the `#pragma warning` or **/wd**; see [warning](../../preprocessor/warning.md) or [/w, /W0, /W1, /W2, /W3, /W4, /w1, /w2, /w3, /w4, /Wall, /wd, /we, /wo, /Wv, /WX (Warning Level)](../../build/reference/compiler-option-warning-level.md) for more information. +This warning is issued when a type specifier is missing in a declaration. The compiler used to assume the type was `int` in this case. But due to compiler conformance work done for Visual Studio 2005, all declarations must explicitly specify the type. + +C4430 is always issued as an error. You can turn off this warning with the `#pragma warning` or `/wd`. For more information, see [`warning`](../../preprocessor/warning.md) or [`/w`, `/W0`, `/W1`, `/W2`, `/W3`, `/W4`, `/w1`, `/w2`, `/w3`, `/w4`, `/Wall`, `/wd`, `/we`, `/wo`, `/Wv`, `/WX` (Warning Level)](../../build/reference/compiler-option-warning-level.md). ## Example -The following sample generates C4430. +The following example generates C4430: ```cpp -// C4430.cpp // compile with: /c struct CMyClass { CUndeclared m_myClass; // C4430 - int m_myClass; // OK }; typedef struct { - POINT(); // C4430 - // try the following line instead - // int POINT(); + someFunction(); // C4430 unsigned x; unsigned y; } POINT; ``` + +To fix this code, you'd need to define the type `CUndeclared` and the function `someFunction` prior to their use. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-c4439.md b/docs/error-messages/compiler-warnings/compiler-warning-c4439.md index f8d402b8386..b4b5b4ffc3e 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-c4439.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-c4439.md @@ -1,22 +1,23 @@ --- -description: "Learn more about: Compiler Warning C4439" -title: "Compiler Warning C4439" -ms.date: "11/04/2016" +title: "Compiler warning (level 1, error) C4439" +description: "Learn more about: Compiler Warning (level 1, error) C4439" +ms.date: 1/22/2025 f1_keywords: ["C4439"] helpviewer_keywords: ["C4439"] -ms.assetid: 9449958f-f407-4824-829b-9e092f2af97d --- -# Compiler Warning C4439 +# Compiler warning C4439 -'function' : function definition with a managed type in the signature must have a __clrcall calling convention +> '*function name*': function definition with a managed type in the signature must have a `__clrcall` calling convention + +## Remarks The compiler implicitly replaced a calling convention with [`__clrcall`](../../cpp/clrcall.md). To resolve this warning, remove the **`__cdecl`** or **`__stdcall`** calling convention. -C4439 is always issued as an error. You can turn off this warning with the `#pragma warning` or **`/wd`**; see [warning](../../preprocessor/warning.md) or [/w, /W0, /W1, /W2, /W3, /W4, /w1, /w2, /w3, /w4, /Wall, /wd, /we, /wo, /Wv, /WX (Warning Level)](../../build/reference/compiler-option-warning-level.md) for more information. +C4439 is always issued as an error. You can turn off this warning with the `#pragma warning` or **`/wd`**. For more information, see [`warning`](../../preprocessor/warning.md) or [`/w`, `/W0`, `/W1`, `/W2`, `/W3`, `/W4`, `/w1`, `/w2`, `/w3`, `/w4`, `/Wall`, `/wd`, `/we`, `/wo`, `/Wv`, `/WX` (Warning Level)](../../build/reference/compiler-option-warning-level.md). ## Example -The following sample generates C4439. +The following example generates C4439: ```cpp // C4439.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-c4484.md b/docs/error-messages/compiler-warnings/compiler-warning-c4484.md index fc6a823d68f..72034be28b7 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-c4484.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-c4484.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Warning C4484" title: "Compiler Warning C4484" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning C4484" +ms.date: 11/04/2016 f1_keywords: ["C4484"] helpviewer_keywords: ["C4484"] -ms.assetid: 3d30e5b3-2297-45b7-a37a-1360056fdd0e --- # Compiler Warning C4484 -'override_function' : matches base ref class method 'base_class_function', but is not marked 'virtual', 'new' or 'override'; 'new' (and not 'virtual') is assumed +> 'override_function' : matches base ref class method 'base_class_function', but is not marked 'virtual', 'new' or 'override'; 'new' (and not 'virtual') is assumed + +## Remarks When compiling with **/clr**, the compiler will not implicitly override a base class function, which means the function will get a new slot in the vtable. To resolve, explicitly specify whether a function is an override. @@ -24,7 +25,7 @@ C4484 is always issued as an error. Use the [warning](../../preprocessor/warning ## Example -The following sample generates C4484. +The following example generates C4484. ```cpp // C4484.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-c4485.md b/docs/error-messages/compiler-warnings/compiler-warning-c4485.md index 29ce3800cd3..6711406f3e3 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-c4485.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-c4485.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Warning C4485" title: "Compiler Warning C4485" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning C4485" +ms.date: 11/04/2016 f1_keywords: ["C4485"] helpviewer_keywords: ["C4485"] -ms.assetid: a6f2b437-ca93-4dcd-b9cb-df415e10df86 --- # Compiler Warning C4485 -'override_function' : matches base ref class method 'base_class_function ', but is not marked 'new' or 'override'; 'new' (and 'virtual') is assumed +> 'override_function' : matches base ref class method 'base_class_function ', but is not marked 'new' or 'override'; 'new' (and 'virtual') is assumed + +## Remarks An accessor overrides, with or without the **`virtual`** keyword, a base class accessor function, but the `override` or **`new`** specifier was not part of the overriding function signature. Add the **`new`** or `override` specifier to resolve this warning. @@ -18,7 +19,7 @@ C4485 is always issued as an error. Use the [warning](../../preprocessor/warning ## Example -The following sample generates C4485 +The following example generates C4485 ```cpp // C4485.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-c4687.md b/docs/error-messages/compiler-warnings/compiler-warning-c4687.md index 6414748bd3f..c4d55b15351 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-c4687.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-c4687.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning C4687" title: "Compiler Warning C4687" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning C4687" +ms.date: 11/04/2016 f1_keywords: ["C4687"] helpviewer_keywords: ["C4687"] -ms.assetid: 2f28e0b1-7358-4c88-bd70-aad8f0aa004c --- # Compiler Warning C4687 @@ -20,7 +19,7 @@ C4687 is issued as an error by default. You can suppress C4687 with the [warning ## Example -The following sample generates C4687. +The following example generates C4687. ```cpp // C4687.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-c4693.md b/docs/error-messages/compiler-warnings/compiler-warning-c4693.md index 9603aea04d9..cd9461c3e9a 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-c4693.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-c4693.md @@ -1,22 +1,23 @@ --- -description: "Learn more about: Compiler Warning C4693" title: "Compiler Warning C4693" -ms.date: "10/25/2017" +description: "Learn more about: Compiler Warning C4693" +ms.date: 10/25/2017 f1_keywords: ["C4693"] helpviewer_keywords: ["C4693"] -ms.assetid: 72d8db01-5e6f-4794-8731-76107e8f064a --- # Compiler Warning C4693 > 'class': a sealed abstract class cannot have any instance members 'Test' +## Remarks + If a type is marked [sealed](../../extensions/sealed-cpp-component-extensions.md) and [abstract](../../extensions/abstract-cpp-component-extensions.md), it can only have static members. This warning is automatically promoted to an error. If you wish to modify this behavior, use [#pragma warning](../../preprocessor/warning.md). ## Example -The following sample generates C4693. +The following example generates C4693. ```cpp // C4693.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-c4694.md b/docs/error-messages/compiler-warnings/compiler-warning-c4694.md index 69a3a53382e..42b5c6af3af 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-c4694.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-c4694.md @@ -1,15 +1,16 @@ --- -description: "Learn more about: Compiler Warning C4694" title: "Compiler Warning C4694" -ms.date: "10/25/2017" +description: "Learn more about: Compiler Warning C4694" +ms.date: 10/25/2017 f1_keywords: ["C4694"] helpviewer_keywords: ["C4694"] -ms.assetid: 5ca122bb-34f3-43ee-a21f-95802cd515f7 --- # Compiler Warning C4694 > '*class*': a sealed abstract class cannot have a base-class '*base_class*' +## Remarks + An abstract and sealed class cannot inherit from a reference type; a sealed and abstract class can neither implement the base class functions nor allow itself to be used as a base class. For more information, see [abstract](../../extensions/abstract-cpp-component-extensions.md), [sealed](../../extensions/sealed-cpp-component-extensions.md), and [Classes and Structs](../../extensions/classes-and-structs-cpp-component-extensions.md). @@ -18,7 +19,7 @@ This warning is automatically promoted to an error. If you wish to modify this b ## Example -The following sample generates C4694. +The following example generates C4694. ```cpp // C4694.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-c4746.md b/docs/error-messages/compiler-warnings/compiler-warning-c4746.md index 04491bb8f18..529e25e81c6 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-c4746.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-c4746.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Warning C4746" title: "Compiler Warning C4746" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning C4746" +ms.date: 11/04/2016 f1_keywords: ["C4746"] helpviewer_keywords: ["C4746"] -ms.assetid: 5e79ab46-6031-499a-a986-716c866b6c0e --- # Compiler Warning C4746 -volatile access of '\' is subject to /volatile:[iso\|ms] setting; consider using __iso_volatile_load/store intrinsic functions. +> volatile access of '\' is subject to /volatile:[iso\|ms] setting; consider using __iso_volatile_load/store intrinsic functions. + +## Remarks C4746 is emitted whenever a volatile variable is accessed directly. It's intended to help developers identify code locations that are affected by the specific volatile model currently specified (which can be controlled with the [`/volatile`](../../build/reference/volatile-volatile-keyword-interpretation.md) compiler option). In particular, it can be useful in locating compiler-generated hardware memory barriers when `/volatile:ms` is used. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-c4867.md b/docs/error-messages/compiler-warnings/compiler-warning-c4867.md index 2d3ddc1217c..3826e9e0ecc 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-c4867.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-c4867.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Warning C4867" title: "Compiler Warning C4867" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning C4867" +ms.date: 11/04/2016 f1_keywords: ["C4867"] helpviewer_keywords: ["C4867"] -ms.assetid: 8a257d70-c3a7-462d-b285-e57c952a8bf7 --- # Compiler Warning C4867 -'function': function call missing argument list; use 'call' to create a pointer to member +> 'function': function call missing argument list; use 'call' to create a pointer to member + +## Remarks A pointer to member function was initialized incorrectly. @@ -18,7 +19,7 @@ This warning is always issued as an error. Use the [warning](../../preprocessor/ ## Example -The following sample generates C4867. +The following example generates C4867. ```cpp // C4867.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-c4868.md b/docs/error-messages/compiler-warnings/compiler-warning-c4868.md index 8857a084f10..d863beaad53 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-c4868.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-c4868.md @@ -1,15 +1,16 @@ --- -description: "Learn more about: Compiler Warning (level 4) C4868" title: "Compiler Warning C4868" -ms.date: "10/26/2017" +description: "Learn more about: Compiler Warning (level 4) C4868" +ms.date: 10/26/2017 f1_keywords: ["C4868"] helpviewer_keywords: ["C4868"] -ms.assetid: fc6aa7e5-34dd-4ec2-88bd-16e430361dc7 --- # Compiler Warning (level 4) C4868 > '_file_(*line_number*)' compiler may not enforce left-to-right evaluation order in braced initializer list +## Remarks + The elements of a braced initializer list are to be evaluated in left-to-right order. There are two cases in which the compiler is unable to guarantee this order: the first is when some of the elements are objects passed by value; the second is when compiling with `/clr` and some of the elements are fields of objects or are array elements. When the compiler can't guarantee left-to-right evaluation it emits warning C4868. This warning can be generated as a result of compiler conformance work that was done for Visual Studio 2015 Update 2. Code that compiled prior to Visual Studio 2015 Update 2 can now generate C4868. @@ -18,11 +19,11 @@ This warning is off by default. Use `/Wall` to activate this warning. To resolve this warning, first consider whether left-to-right evaluation of the initializer list elements is necessary, such as when evaluation of the elements might produce order-dependent side-effects. In many cases, the order in which elements are evaluated does not have an observable effect. -If the order of evaluation must be left-to-right, consider if it's possible to pass the elements by **`const`** reference instead. A change such as this eliminates the warning in the following code sample. +If the order of evaluation must be left-to-right, consider if it's possible to pass the elements by **`const`** reference instead. A change such as this eliminates the warning in the following code example. ## Example -This sample generates C4868, and shows a way to fix it: +This example generates C4868, and shows a way to fix it: ```cpp // C4868.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-c4936.md b/docs/error-messages/compiler-warnings/compiler-warning-c4936.md index bd5d2d26f79..73342f7523e 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-c4936.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-c4936.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning C4936" title: "Compiler Warning C4936" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning C4936" +ms.date: 11/04/2016 f1_keywords: ["C4936"] helpviewer_keywords: ["C4936"] -ms.assetid: 6676de35-bf1b-4d0b-a70f-b5734130336c --- # Compiler Warning C4936 @@ -22,7 +21,7 @@ C4936 is always issued as an error. You can disable C4936 with the [warning](.. ## Example -The following sample generates C4936: +The following example generates C4936: ```cpp // C4936.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-c4950.md b/docs/error-messages/compiler-warnings/compiler-warning-c4950.md index e4ca8421480..e7fef9ffffd 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-c4950.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-c4950.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Warning C4950" title: "Compiler Warning C4950" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning C4950" +ms.date: 11/04/2016 f1_keywords: ["C4950"] helpviewer_keywords: ["C4950"] -ms.assetid: 50226a5c-c664-4d09-ac59-e9e874ca244f --- # Compiler Warning C4950 -'type_or_member' : marked as obsolete +> 'type_or_member' : marked as obsolete + +## Remarks A member or type was marked as obsolete with the attribute. @@ -16,7 +17,7 @@ C4950 is always issued as an error. You can turn off this warning by using the [ ## Example -The following sample generates C4950: +The following example generates C4950: ```cpp // C4950.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-c4956.md b/docs/error-messages/compiler-warnings/compiler-warning-c4956.md index cd8382e9920..d2be88d6b50 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-c4956.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-c4956.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning C4956" title: "Compiler Warning C4956" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning C4956" +ms.date: 11/04/2016 f1_keywords: ["C4956"] helpviewer_keywords: ["C4956"] -ms.assetid: 9154f2d1-d49f-4e07-90d2-0e9bc028011a --- # Compiler Warning C4956 @@ -20,7 +19,7 @@ This warning is issued as an error and can be disabled with the [warning](../../ ## Example -The following sample generates C4956: +The following example generates C4956: ```cpp // C4956.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-c4957.md b/docs/error-messages/compiler-warnings/compiler-warning-c4957.md index 762111b68af..cf4900c21d3 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-c4957.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-c4957.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning C4957" title: "Compiler Warning C4957" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning C4957" +ms.date: 11/04/2016 f1_keywords: ["C4957"] helpviewer_keywords: ["C4957"] -ms.assetid: a18c52d4-23e2-44f1-b4b5-f7fa5a7f3987 --- # Compiler Warning C4957 @@ -24,7 +23,7 @@ This warning is issued as an error and can be disabled with the [warning](../../ ## Example -The following sample generates C4957: +The following example generates C4957: ```cpp // C4957.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-c4958.md b/docs/error-messages/compiler-warnings/compiler-warning-c4958.md index dffd446ceec..5f8f2fd50c3 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-c4958.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-c4958.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning C4958" title: "Compiler Warning C4958" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning C4958" +ms.date: 11/04/2016 f1_keywords: ["C4958"] helpviewer_keywords: ["C4958"] -ms.assetid: e79b9e9c-d572-4a3a-a3b6-60962b70864a --- # Compiler Warning C4958 @@ -20,9 +19,9 @@ The **/clr:safe** compiler option is deprecated in Visual Studio 2015 and unsupp This warning is issued as an error and can be disabled with the [warning](../../preprocessor/warning.md) pragma or the [/wd](../../build/reference/compiler-option-warning-level.md) compiler option. -## Example +## Examples -The following sample generates C4958: +The following example generates C4958: ```cpp // C4958.cpp @@ -39,7 +38,7 @@ int main( ) { The compiler implements array operations with pointer arithmetic. Therefore, native arrays are not verifiable; use a CLR array instead. For more information, see [array](../../extensions/arrays-cpp-component-extensions.md). -The following sample generates C4958: +The following example generates C4958: ```cpp // C4958b.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-c4959.md b/docs/error-messages/compiler-warnings/compiler-warning-c4959.md index f1ac31d8d2e..98be05f3e47 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-c4959.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-c4959.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning C4959" title: "Compiler Warning C4959" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning C4959" +ms.date: 11/04/2016 f1_keywords: ["C4959"] helpviewer_keywords: ["C4959"] -ms.assetid: 3a128f3e-4d8a-4565-ba1a-5d32fdeb5982 --- # Compiler Warning C4959 @@ -22,7 +21,7 @@ This warning is issued as an error and can be disabled with the [warning](../../ ## Example -The following sample generates C4959: +The following example generates C4959: ```cpp // C4959.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-c4961.md b/docs/error-messages/compiler-warnings/compiler-warning-c4961.md index 59298487148..19f28ac5064 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-c4961.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-c4961.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Compiler Warning C4961" title: "Compiler Warning C4961" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning C4961" +ms.date: 11/04/2016 f1_keywords: ["C4961"] helpviewer_keywords: ["C4961"] -ms.assetid: fe22d99f-5a12-45d3-a7cf-867773a71e16 --- # Compiler Warning C4961 -No profile data was merged into '.pgd file', profile-guided optimizations disabled +> No profile data was merged into '.pgd file', profile-guided optimizations disabled + +## Remarks No profile data (.pgc files) were available, so profile-guided optimizations cannot take place. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-c4962.md b/docs/error-messages/compiler-warnings/compiler-warning-c4962.md index 3a1468d7299..68e7379ebe0 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-c4962.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-c4962.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Warning C4962" title: "Compiler Warning C4962" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning C4962" +ms.date: 11/04/2016 f1_keywords: ["C4962"] helpviewer_keywords: ["C4962"] -ms.assetid: 62b156fe-04e5-4a6e-9339-6ab148185f87 --- # Compiler Warning C4962 -'function' : Profile-guided optimizations disabled because optimizations caused profile data to become inconsistent" +> 'function' : Profile-guided optimizations disabled because optimizations caused profile data to become inconsistent" + +## Remarks A function was not compiled with /LTCG:PGO, because count (profile) data for the function was unreliable. Redo profiling to regenerate the .pgc file that contains the unreliable profile data for that function. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-c4972.md b/docs/error-messages/compiler-warnings/compiler-warning-c4972.md index 95e783ed6a2..b115d03e149 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-c4972.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-c4972.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Warning C4972" title: "Compiler Warning C4972" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning C4972" +ms.date: 11/04/2016 f1_keywords: ["C4972"] helpviewer_keywords: ["C4972"] -ms.assetid: d18e8e65-b2ef-4d75-a207-fbd0c17c9060 --- # Compiler Warning C4972 -Directly modifying or treating the result of an unbox operation as an lvalue is unverifiable +> Directly modifying or treating the result of an unbox operation as an lvalue is unverifiable + +## Remarks Dereferencing a handle to a value type, also known as unboxing, and then assigning to it is not verifiable. @@ -16,7 +17,7 @@ For more information, see [Boxing](../../extensions/boxing-cpp-component-extensi ## Example -The following sample generates C4972. +The following example generates C4972. ```cpp // C4972.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-c4984.md b/docs/error-messages/compiler-warnings/compiler-warning-c4984.md index 6fb4984b33d..c30dbf85bd3 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-c4984.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-c4984.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: Compiler Warning C4984" title: "Compiler Warning C4984" -ms.date: "08/19/2019" +description: "Learn more about: Compiler Warning C4984" +ms.date: 08/19/2019 f1_keywords: ["C4984"] helpviewer_keywords: ["C4984"] --- @@ -19,7 +19,7 @@ This warning is available starting in Visual Studio 2017 version 15.3. For infor ## Example -This sample generates C4984, and shows ways to fix it: +This example generates C4984, and shows ways to fix it: ```cpp // C4984.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-c4986.md b/docs/error-messages/compiler-warnings/compiler-warning-c4986.md index 7cb4e24c1de..975f37ff915 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-c4986.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-c4986.md @@ -1,22 +1,23 @@ --- -description: "Learn more about: Compiler Warning C4986" title: "Compiler Warning C4986" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning C4986" +ms.date: 11/04/2016 f1_keywords: ["C4986"] helpviewer_keywords: ["C4986"] -ms.assetid: a3a7b008-29dd-4203-85f3-7740ab6790bb --- # Compiler Warning C4986 -'function': exception specification does not match previous declaration +> 'function': exception specification does not match previous declaration + +## Remarks This warning can be generated when there is an exception specification in one declaration and not the other. By default, C4986 is off. For more information, see [Compiler Warnings That Are Off by Default](../../preprocessor/compiler-warnings-that-are-off-by-default.md). -## Examples +## Example -The following sample generates C4986. +The following example generates C4986. ```cpp class X { }; @@ -28,7 +29,7 @@ void f1() } ``` -The following sample eliminates this warning. +The following example eliminates this warning. ```cpp class X { }; diff --git a/docs/error-messages/compiler-warnings/compiler-warning-c5072.md b/docs/error-messages/compiler-warnings/compiler-warning-c5072.md index b3216cb81bb..ad186122f61 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-c5072.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-c5072.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: Compiler Warning (level 1) C5072" title: "Compiler Warning (level 1) C5072" -ms.date: 02/09/2024 +description: "Learn more about: Compiler Warning (level 1) C5072" +ms.date: 09/10/2025 f1_keywords: ["C5072"] helpviewer_keywords: ["C5072"] --- @@ -9,18 +9,24 @@ helpviewer_keywords: ["C5072"] > ASAN enabled without debug information emission. Enable debug info for better ASAN error reporting -This warning occurs when you compile with [Address Sanitizer](/cpp/sanitizers/asan) (ASAN) turned on, but you don't also instruct the compiler to emit debug info. ASAN uses debug info to provide better diagnostics. +## Remarks + +This warning occurs when you compile with [Address Sanitizer](../../sanitizers/asan.md) (ASAN) turned on, but you don't also instruct the compiler to emit debug info. ASAN uses debug info to provide better diagnostics. ## Example -The following command line generates warning `C5072`: +The following command line generates warning C5072: -```cpp - cl /fsanitize=address /EHsc test.cpp +```cmd +cl /fsanitize=address /EHsc test.cpp ``` -To fix it, have the compiler generate debug information by using a switch like [`/Zi`](/cpp/build/reference/z7-zi-zi-debug-information-format#zi) or [`/Z7`](/cpp/build/reference/z7-zi-zi-debug-information-format#z7), like this: `cl /fsanitize=address /EHsc /Zi test.cpp` +To fix it, have the compiler generate debug information by using a switch like [`/Zi`](../../build/reference/z7-zi-zi-debug-information-format.md#zi) or [`/Z7`](../../build/reference/z7-zi-zi-debug-information-format.md#z7), like this: + +```cmd +cl /fsanitize=address /EHsc /Zi test.cpp +``` ## See also -[Address Sanitizer (ASAN)](/cpp/sanitizers/asan) +[Address Sanitizer (ASAN)](../../sanitizers/asan.md) diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-and-3-c4793.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-and-3-c4793.md index ae937e3ff24..fadac33d1d3 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-and-3-c4793.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-and-3-c4793.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1 and 3) C4793" title: "Compiler Warning (level 1 and 3) C4793" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1 and 3) C4793" +ms.date: 11/04/2016 f1_keywords: ["C4793"] helpviewer_keywords: ["C6634", "C6635", "C6640", "C6630", "C6639", "C6636", "C6638", "C6631", "C6637", "C4793"] -ms.assetid: 819ada53-1d9c-49b8-a629-baf8c12314e6 --- # Compiler Warning (level 1 and 3) C4793 @@ -30,9 +29,9 @@ The following table lists all possible continuation messages. |A non-__clrcall virtual function thunk must be compiled as native|A non-[__clrcall](../../cpp/clrcall.md) virtual function thunk must use an unmanaged address.| |A function using '_setjmp' must be compiled as native|The CLR must be able to control program execution. However, the [setjmp](../../cpp/using-setjmp-longjmp.md) function bypasses regular program execution by saving and restoring low-level information such as registers and execution state.| -## Example +## Examples -The following sample generates C4793. +The following example generates C4793. ```cpp // C4793.cpp @@ -50,7 +49,7 @@ warning C4793: 'asmfunc' : function is compiled as native code: Inline native assembly ('__asm') is not supported in managed code ``` -The following sample generates C4793. +The following example generates C4793. ```cpp // C4793_b.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-and-level-4-c4700.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-and-level-4-c4700.md index db6a5e55dca..17e3df14c6b 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-and-level-4-c4700.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-and-level-4-c4700.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1 and level 4) C4700" title: "Compiler Warning (level 1 and level 4) C4700" +description: "Learn more about: Compiler Warning (level 1 and level 4) C4700" ms.date: 08/30/2022 f1_keywords: ["C4700"] helpviewer_keywords: ["C4700"] -ms.assetid: 2da0deb4-77dd-4b05-98d3-b78d74ac4ca7 --- # Compiler Warning (level 1 and level 4) C4700 @@ -20,7 +19,7 @@ The [`/sdl` (Enable Additional Security Checks)](../../build/reference/sdl-enabl ## Example -This sample generates C4700 when variables `t`, `u`, and `v` are used before they're initialized, and shows the kind of garbage value that can result. Variables `x`, `y`, and `z` don't cause the warning, because they're initialized before use: +This example generates C4700 when variables `t`, `u`, and `v` are used before they're initialized, and shows the kind of garbage value that can result. Variables `x`, `y`, and `z` don't cause the warning, because they're initialized before use: ```cpp // c4700.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-and-level-4-c4949.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-and-level-4-c4949.md index 896988405d4..e4dd9831b20 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-and-level-4-c4949.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-and-level-4-c4949.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Warning (level 1 and level 4) C4949" title: "Compiler Warning (level 1 and level 4) C4949" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1 and level 4) C4949" +ms.date: 11/04/2016 f1_keywords: ["C4949"] helpviewer_keywords: ["C4949"] -ms.assetid: 34f45a05-c115-49cb-9f67-0bd4f0735d9b --- # Compiler Warning (level 1 and level 4) C4949 -pragmas 'managed' and 'unmanaged' are meaningful only when compiled with '/clr[:option]' +> pragmas 'managed' and 'unmanaged' are meaningful only when compiled with '/clr[:option]' + +## Remarks The compiler ignores the [managed](../../preprocessor/managed-unmanaged.md) and unmanaged pragmas if the source code is not compiled with [/clr](../../build/reference/clr-common-language-runtime-compilation.md). This warning is informational. -The following sample generates C4949: +## Example + +The following example generates C4949: ```cpp // C4949.cpp @@ -22,7 +25,7 @@ The following sample generates C4949: When **#pragma unmanaged** is used without **/clr**, C4949 is a level 4 warning. -The following sample generates C4949: +The following example generates C4949: ```cpp // C4949b.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4002.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4002.md index 18d513c7877..c97bb7d1227 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4002.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4002.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: Compiler Warning (level 1, Error) C4002" title: "Compiler Warning (level 1, Error) C4002" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1, Error) C4002" +ms.date: 11/04/2016 f1_keywords: ["C4002"] helpviewer_keywords: ["C4002"] --- @@ -9,11 +9,15 @@ helpviewer_keywords: ["C4002"] > too many arguments for function-like macro invocation '*identifier*' +## Remarks + The number of actual parameters in the macro exceeds the number of formal parameters in the macro definition. The preprocessor collects the extra parameters but ignores them during macro expansion. C4002 can occur when incorrectly using [variadic macros](../../preprocessor/variadic-macros.md). -The following sample generates C4002: +## Example + +The following example generates C4002: ```cpp // C4002.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4003.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4003.md index 360f59e8949..45a2adcf25c 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4003.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4003.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: Compiler Warning (level 1, Error) C4003" title: "Compiler Warning (level 1, Error) C4003" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1, Error) C4003" +ms.date: 11/04/2016 f1_keywords: ["C4003"] helpviewer_keywords: ["C4003"] --- @@ -9,9 +9,13 @@ helpviewer_keywords: ["C4003"] > not enough arguments for function-like macro invocation '*identifier*' +## Remarks + The number of formal parameters in the macro definition exceeds the number of actual parameters in the macro. Macro expansion substitutes empty text for the missing parameters. -The following sample generates C4003: +## Example + +The following example generates C4003: ```cpp // C4003.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4005.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4005.md index 53cbf804f6d..69a14d6e511 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4005.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4005.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4005" title: "Compiler Warning (level 1) C4005" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4005" +ms.date: 11/04/2016 f1_keywords: ["C4005"] helpviewer_keywords: ["C4005"] -ms.assetid: 7f2dc79a-9fcb-4d5b-be61-120d9cb487ad --- # Compiler Warning (level 1) C4005 -'identifier' : macro redefinition +> 'identifier' : macro redefinition + +## Remarks The macro identifier is defined twice. The compiler uses the second macro definition. @@ -24,7 +25,9 @@ The macro identifier is defined twice. The compiler uses the second macro defini 1. Use an [#undef](../../preprocessor/hash-undef-directive-c-cpp.md) directive before the second definition. -The following sample generates C4005: +## Example + +The following example generates C4005: ```cpp // C4005.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4006.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4006.md index fead77c55d7..c39751f601c 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4006.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4006.md @@ -1,16 +1,21 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4006" title: "Compiler Warning (level 1) C4006" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4006" +ms.date: 11/04/2016 f1_keywords: ["C4006"] helpviewer_keywords: ["C4006"] -ms.assetid: f1a59819-0fd2-4361-8e3a-99e4b514b8e1 --- # Compiler Warning (level 1) C4006 -\#undef expected an identifier +> #undef expected an identifier + +## Remarks + +The `#undef` directive did not specify an identifier to undefine. The directive is ignored. To resolve the warning, be sure to specify an identifier. + +## Example -The `#undef` directive did not specify an identifier to undefine. The directive is ignored. To resolve the warning, be sure to specify an identifier. The following sample generates C4006: +The following example generates C4006: ```cpp // C4006.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4010.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4010.md index 4f3d6f55eb1..ae54258c558 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4010.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4010.md @@ -1,20 +1,23 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4010" title: "Compiler Warning (level 1) C4010" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4010" +ms.date: 11/04/2016 f1_keywords: ["C4010"] helpviewer_keywords: ["C4010"] -ms.assetid: d607a9ff-8f8f-45c0-b07b-3b2f439e5485 --- # Compiler Warning (level 1) C4010 -single-line comment contains line-continuation character +> single-line comment contains line-continuation character + +## Remarks A single-line comment, which is introduced by //, contains a backslash (\\) that serves as a line-continuation character. The compiler considers the next line to be a continuation and treats it as a comment. Some syntax-directed editors do not indicate the line following the continuation character as a comment. Ignore syntax coloring on any lines that cause this warning. -The following sample generates C4010: +## Example + +The following example generates C4010: ```cpp // C4010.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4015.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4015.md index 5ad3ccbb8cb..17fcd129fdb 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4015.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4015.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4015" title: "Compiler Warning (level 1) C4015" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4015" +ms.date: 11/04/2016 f1_keywords: ["C4015"] helpviewer_keywords: ["C4015"] -ms.assetid: 7242ab90-c869-482f-8152-46728575837e --- # Compiler Warning (level 1) C4015 -'identifier' : type of bit field must be integral +> 'identifier' : type of bit field must be integral + +## Remarks The bit field is not declared as an integer type. The compiler assumes the base type of the bit field to be unsigned. Bit fields must be declared as unsigned integer types. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4020.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4020.md index a5fb74a51a3..587b65dc88e 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4020.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4020.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4020" title: "Compiler Warning (level 1) C4020" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4020" +ms.date: 11/04/2016 f1_keywords: ["C4020"] helpviewer_keywords: ["C4020"] -ms.assetid: 8c4cd6be-9371-4c8c-b0ff-a5ad367bbab0 --- # Compiler Warning (level 1) C4020 -'function' : too many actual parameters +> 'function' : too many actual parameters + +## Remarks The number of actual parameters in a function call exceeds the number of formal parameters in the function prototype or definition. The compiler passes the extra actual parameters according to the calling convention of the function. -The following sample generates C4020: +## Example + +The following example generates C4020: ```c // C4020.c diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4022.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4022.md index 051feb44a3c..ee13a0d21af 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4022.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4022.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4022" title: "Compiler Warning (level 1) C4022" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4022" +ms.date: 11/04/2016 f1_keywords: ["C4022"] helpviewer_keywords: ["C4022"] -ms.assetid: 9586ca84-4b40-4602-91a4-2e2415b1ab63 --- # Compiler Warning (level 1) C4022 -'function' : pointer mismatch for actual parameter 'number' +> 'function' : pointer mismatch for actual parameter 'number' + +## Remarks The pointer type of the actual parameter differs from the pointer type of the corresponding formal parameter. The actual parameter is passed without change. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4024.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4024.md index eb23ea6c5f2..f4fb400f3cf 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4024.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4024.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4024" title: "Compiler Warning (level 1) C4024" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4024" +ms.date: 11/04/2016 f1_keywords: ["C4024"] helpviewer_keywords: ["C4024"] -ms.assetid: f6cb1b70-686a-4747-a01c-de673208209a --- # Compiler Warning (level 1) C4024 -'function' : different types for formal and actual parameter 'number' +> 'function' : different types for formal and actual parameter 'number' + +## Remarks Corresponding formal and actual parameters have different types. The compiler passes the actual parameter without change. The receiving function converts the parameter type to the type expected. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4025.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4025.md index 505f3d85979..d9c89fd4608 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4025.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4025.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4025" title: "Compiler Warning (level 1) C4025" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4025" +ms.date: 11/04/2016 f1_keywords: ["C4025"] helpviewer_keywords: ["C4025"] -ms.assetid: c4f6a651-0641-4446-973e-8290065e49ad --- # Compiler Warning (level 1) C4025 -'number' : based pointer passed to function with variable arguments: parameter number +> 'number' : based pointer passed to function with variable arguments: parameter number + +## Remarks Passing a based pointer to a function with variable arguments causes the pointer to be normalized, with unpredictable results. Do not pass based pointers to functions with variable arguments. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4026.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4026.md index 57b763bec5b..4aa8c4d8323 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4026.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4026.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4026" title: "Compiler Warning (level 1) C4026" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4026" +ms.date: 11/04/2016 f1_keywords: ["C4026"] helpviewer_keywords: ["C4026"] -ms.assetid: 2c8ff616-8d7f-4784-8037-77f8b6a67698 --- # Compiler Warning (level 1) C4026 -function declared with formal parameter list +> function declared with formal parameter list + +## Remarks The function declaration has formal parameters, but the function definition does not. Subsequent calls to this function assume that the function takes no parameters. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4027.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4027.md index c3a3de1492d..cf626d581a8 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4027.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4027.md @@ -1,6 +1,6 @@ --- -description: "Learn more about compiler warning (level 1) C4027" title: "Compiler Warning (level 1) C4027" +description: "Learn more about compiler warning (level 1) C4027" ms.date: 12/16/2020 f1_keywords: ["C4027"] helpviewer_keywords: ["C4027"] @@ -9,6 +9,8 @@ helpviewer_keywords: ["C4027"] > function declared without formal parameter list +## Remarks + The function declaration had no formal parameters, but there are formal parameters in the function definition or actual parameters in a call. The compiler accepts, but warns, on an old C-style forward declaration of a function name without a parameter list. On later calls to this function, the compiler assumes that the function takes actual parameters of the types found in the function definition or call. We recommend you modify your function declaration diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4028.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4028.md index abc7bff802b..8b090d3b4ba 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4028.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4028.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4028" title: "Compiler Warning (level 1) C4028" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4028" +ms.date: 11/04/2016 f1_keywords: ["C4028"] helpviewer_keywords: ["C4028"] -ms.assetid: c3e8b70b-e870-416c-a285-bba5f71dbfc6 --- # Compiler Warning (level 1) C4028 -formal parameter 'number' different from declaration +> formal parameter 'number' different from declaration + +## Remarks The type of the formal parameter does not agree with the corresponding parameter in the declaration. The type in the original declaration is used. @@ -16,7 +17,7 @@ This warning is only valid for C source code. ## Example -The following sample generates C4028. +The following example generates C4028. ```c // C4028.c diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4029.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4029.md index d34c5ff797c..fc2983d339e 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4029.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4029.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4029" title: "Compiler Warning (level 1) C4029" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4029" +ms.date: 11/04/2016 f1_keywords: ["C4029"] helpviewer_keywords: ["C4029"] -ms.assetid: a5c50bab-a189-44c9-aa5c-4377c7c8443a --- # Compiler Warning (level 1) C4029 -declared formal parameter list different from definition +> declared formal parameter list different from definition + +## Remarks Formal parameter types in the function declaration do not agree with those in the function definition. The compiler uses the parameter list from the definition. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4030.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4030.md index 9440c168978..c36e7b4667b 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4030.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4030.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4030" title: "Compiler Warning (level 1) C4030" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4030" +ms.date: 11/04/2016 f1_keywords: ["C4030"] helpviewer_keywords: ["C4030"] -ms.assetid: 155b290e-4777-4704-ad35-02968b1e4c5e --- # Compiler Warning (level 1) C4030 -**first formal parameter list longer than the second list** +> first formal parameter list longer than the second list + +## Remarks A function was redeclared with different formal parameters. The compiler uses the formal parameters given in the first declaration. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4031.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4031.md index d7291b5939d..f87f4f40fd2 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4031.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4031.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4031" title: "Compiler Warning (level 1) C4031" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4031" +ms.date: 11/04/2016 f1_keywords: ["C4031"] helpviewer_keywords: ["C4031"] -ms.assetid: 8ac4965d-75e2-42db-9763-3f6ae707e1e1 --- # Compiler Warning (level 1) C4031 -second formal parameter list longer than the first list +> second formal parameter list longer than the first list + +## Remarks A function is redeclared with different formal parameters. The compiler uses the formal parameters given in the first declaration. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4033.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4033.md index 9e90e7cd31b..0243da64091 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4033.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4033.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4033" title: "Compiler Warning (level 1) C4033" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4033" +ms.date: 11/04/2016 f1_keywords: ["C4033"] helpviewer_keywords: ["C4033"] -ms.assetid: 189a9ec3-ff6d-49dd-b9b2-530b28bbb7c9 --- # Compiler Warning (level 1) C4033 -'function' must return a value +> 'function' must return a value + +## Remarks The function does not return a value. An undefined value is returned. @@ -16,7 +17,9 @@ Functions that use **`return`** without a return value must be declared as type This error is for C language code. -The following sample generates C4033: +## Example + +The following example generates C4033: ```c // C4033.c diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4034.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4034.md index fa3394aaf44..b1f4596f19e 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4034.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4034.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4034" title: "Compiler Warning (level 1) C4034" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4034" +ms.date: 11/04/2016 f1_keywords: ["C4034"] helpviewer_keywords: ["C4034"] -ms.assetid: 1d2f598d-bdfc-4a95-9617-424b591ed3e8 --- # Compiler Warning (level 1) C4034 -sizeof returns 0 +> sizeof returns 0 + +## Remarks The **`sizeof`** operator is applied to an operand of size zero (an empty structure, union, class, or enumerated type, or type **`void`**). diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4036.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4036.md index 5741b71a91a..6cd5d9f50a5 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4036.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4036.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4036" title: "Compiler Warning (level 1) C4036" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4036" +ms.date: 11/04/2016 f1_keywords: ["C4036"] helpviewer_keywords: ["C4036"] -ms.assetid: f0b15359-4d62-48ec-8cb1-a7b36587a47f --- # Compiler Warning (level 1) C4036 -unnamed 'type' as actual parameter +> unnamed 'type' as actual parameter + +## Remarks No type name is given for a structure, union, enumeration, or class used as an actual parameter. If you are using [/Zg](../../build/reference/zg-generate-function-prototypes.md) to generate function prototypes, the compiler issues this warning and comments out the formal parameter in the generated prototype. @@ -16,7 +17,7 @@ Specify a type name to resolve this warning. ## Example -The following sample generates C4036. +The following example generates C4036 and shows how to fix it by providing a type name. ```c // C4036.c diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4038.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4038.md index 5fefad3f82d..1ae8f389eee 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4038.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4038.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4038" title: "Compiler Warning (level 1) C4038" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4038" +ms.date: 11/04/2016 f1_keywords: ["C4038"] helpviewer_keywords: ["C4038"] -ms.assetid: 54c7f4ed-9386-436e-b4be-bf6c338ded64 --- # Compiler Warning (level 1) C4038 -'modifier' : illegal ambient class modifier +> 'modifier' : illegal ambient class modifier + +## Remarks This modifier cannot be used for classes with **`dllimport`** or [dllexport](../../cpp/dllexport-dllimport.md) attributes. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4041.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4041.md index 1dc226cd33f..522bdd17d0d 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4041.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4041.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4041" title: "Compiler Warning (level 1) C4041" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4041" +ms.date: 11/04/2016 f1_keywords: ["C4041"] helpviewer_keywords: ["C4041"] -ms.assetid: 107ee9fd-4b88-4f22-a18f-a20726831095 --- # Compiler Warning (level 1) C4041 -compiler limit : terminating browser output +> compiler limit : terminating browser output + +## Remarks Browser information exceeded the compiler limit. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4042.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4042.md index 4ec209f86f8..aad89002ff8 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4042.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4042.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4042" title: "Compiler Warning (level 1) C4042" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4042" +ms.date: 11/04/2016 f1_keywords: ["C4042"] helpviewer_keywords: ["C4042"] -ms.assetid: e4bd861b-1194-426b-bf79-68c5b021eb0a --- # Compiler Warning (level 1) C4042 -'identifier' : has bad storage class +> 'identifier' : has bad storage class + +## Remarks The specified storage class cannot be used with this identifier in this context. The compiler uses the default storage class instead: @@ -20,7 +21,9 @@ The specified storage class cannot be used with this identifier in this context. This warning can be caused by specifying a storage class other than **`register`** in a parameter declaration. -The following sample generates C4042 +## Example + +The following example generates C4042: ```cpp // C4042.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4045.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4045.md index 92468659928..3a866f8ae5f 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4045.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4045.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4045" title: "Compiler Warning (level 1) C4045" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4045" +ms.date: 11/04/2016 f1_keywords: ["C4045"] helpviewer_keywords: ["C4045"] -ms.assetid: 3c6f7373-da91-45cd-b224-f49f7d8b4df0 --- # Compiler Warning (level 1) C4045 -'array' : array bounds overflow +> 'array' : array bounds overflow + +## Remarks The array has too many initializers. Extra initializers are ignored. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4047.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4047.md index 229da7ccbde..4a9b1b9a0ba 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4047.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4047.md @@ -1,20 +1,21 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4047" title: "Compiler Warning (level 1) C4047" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4047" +ms.date: 11/04/2016 f1_keywords: ["C4047"] helpviewer_keywords: ["C4047"] -ms.assetid: b75ad6fb-5c93-4434-a85f-c4083051a5de --- # Compiler Warning (level 1) C4047 -'operator' : 'identifier1' differs in levels of indirection from 'identifier2' +> 'operator' : 'identifier1' differs in levels of indirection from 'identifier2' + +## Remarks A pointer can point to a variable (one level of indirection), to another pointer that points to a variable (two levels of indirection), and so on. ## Examples -The following sample generates C4047: +The following example generates C4047: ```c // C4047.c @@ -32,7 +33,7 @@ int main() { } ``` -The following sample generates C4047: +The following example generates C4047: ```c // C4047b.c diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4048.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4048.md index a3786cb575b..bf07d4838c3 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4048.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4048.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4048" title: "Compiler Warning (level 1) C4048" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4048" +ms.date: 11/04/2016 f1_keywords: ["C4048"] helpviewer_keywords: ["C4048"] -ms.assetid: 8429f513-4732-40f1-8e56-4c224e723bcb --- # Compiler Warning (level 1) C4048 -different declared array subscripts : 'identifier1' and 'identifier2' +> different declared array subscripts : 'identifier1' and 'identifier2' + +## Remarks An expression involves pointers to arrays of different size. The pointers are used without conversion. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4049.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4049.md index d13fb15e544..8e31d5fcc0e 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4049.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4049.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4049" title: "Compiler Warning (level 1) C4049" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4049" +ms.date: 11/04/2016 f1_keywords: ["C4049"] helpviewer_keywords: ["C4049"] -ms.assetid: d11c1870-bcfc-4d71-8945-b87ec6ec3514 --- # Compiler Warning (level 1) C4049 -compiler limit : terminating line number emission +> compiler limit : terminating line number emission + +## Remarks The file contains more than 16,777,215 (224-1) source lines. The compiler stops numbering at 16,777,215. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4052.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4052.md index aaf4746a460..d2c29d924f1 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4052.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4052.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: Compiler Warning (level 1 and level 4) C4052" title: "Compiler Warning (level 1 and level 4) C4052" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1 and level 4) C4052" +ms.date: 11/04/2016 f1_keywords: ["C4052"] helpviewer_keywords: ["C4052"] --- @@ -9,9 +9,13 @@ helpviewer_keywords: ["C4052"] > function declarations different; one contains variable arguments +## Remarks + One declaration of the function doesn't contain variable arguments. The empty declaration is ignored. -The following sample generates C4052: +## Example + +The following example generates C4052: ```c // C4052.c diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4055.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4055.md index 29d27d3b0e8..766f8180af8 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4055.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4055.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4055" title: "Compiler Warning (level 1) C4055" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4055" +ms.date: 11/04/2016 f1_keywords: ["C4055"] helpviewer_keywords: ["C4055"] -ms.assetid: f9955421-16ab-46e5-8f9d-bf1639a519ef --- # Compiler Warning (level 1) C4055 @@ -18,7 +17,7 @@ A data pointer is cast (possibly incorrectly) to a function pointer. This is a l ## Example -The following sample generates C4055: +The following example generates C4055: ```C // C4055.c diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4067.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4067.md index 10e6a99d949..6091facabd8 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4067.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4067.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4067" title: "Compiler Warning (level 1) C4067" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4067" +ms.date: 11/04/2016 f1_keywords: ["C4067"] helpviewer_keywords: ["C4067"] -ms.assetid: 1d10353e-8cd5-4b01-9184-a06189b965a4 --- # Compiler Warning (level 1) C4067 @@ -16,6 +15,8 @@ The compiler found and ignored extra characters following a preprocessor directi ## Example +The following example generates C4067: + ```cpp // C4067a.cpp // compile with: cl /EHsc /DX /W1 /Za C4067a.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4068.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4068.md index f6f9cadd5f9..138b6715dff 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4068.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4068.md @@ -1,16 +1,21 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4068" title: "Compiler Warning (level 1) C4068" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4068" +ms.date: 11/04/2016 f1_keywords: ["C4068"] helpviewer_keywords: ["C4068"] -ms.assetid: 96a7397a-4eab-44ab-b3bb-36747503f7e5 --- # Compiler Warning (level 1) C4068 -unknown pragma +> unknown pragma + +## Remarks + +The compiler ignored an unrecognized [pragma](../../preprocessor/pragma-directives-and-the-pragma-keyword.md). Be sure the **pragma** is allowed by the compiler you are using. + +## Example -The compiler ignored an unrecognized [pragma](../../preprocessor/pragma-directives-and-the-pragma-keyword.md). Be sure the **pragma** is allowed by the compiler you are using. The following sample generates C4068: +The following example generates C4068: ```cpp // C4068.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4074.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4074.md index 8d4fbe8f3a6..ce3eb6ac36d 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4074.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4074.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4074" title: "Compiler Warning (level 1) C4074" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4074" +ms.date: 11/04/2016 f1_keywords: ["C4074"] helpviewer_keywords: ["C4074"] -ms.assetid: cd510e66-c338-4a86-a4d7-bfa1df9b16c3 --- # Compiler Warning (level 1) C4074 -initializers put in compiler reserved initialization area +> initializers put in compiler reserved initialization area + +## Remarks The compiler initialization area, which is specified by [#pragma init_seg](../../preprocessor/init-seg.md), is reserved by Microsoft. Code in this area may be executed before initialization of the C run-time library. -The following sample generates C4074: +## Example + +The following example generates C4074: ```cpp // C4074.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4075.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4075.md index 4fe1b0c563a..5e99eb14589 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4075.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4075.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4075" title: "Compiler Warning (level 1) C4075" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4075" +ms.date: 11/04/2016 f1_keywords: ["C4075"] helpviewer_keywords: ["C4075"] -ms.assetid: 19a700b6-f210-4b9d-a2f2-76cfe39ab178 --- # Compiler Warning (level 1) C4075 -initializers put in unrecognized initialization area +> initializers put in unrecognized initialization area + +## Remarks A [#pragma init_seg](../../preprocessor/init-seg.md) uses an unrecognized section name. The compiler ignores the **pragma** command. -The following sample generates C4075: +## Example + +The following example generates C4075: ```cpp // C4075.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4076.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4076.md index ba24a51e7f3..0361ba89332 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4076.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4076.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4076" title: "Compiler Warning (level 1) C4076" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4076" +ms.date: 11/04/2016 f1_keywords: ["C4076"] helpviewer_keywords: ["C4076"] -ms.assetid: 04581066-313a-4a11-bb60-721e6d038d75 --- # Compiler Warning (level 1) C4076 @@ -16,7 +15,7 @@ A type modifier, whether it is **`signed`** or **`unsigned`**, cannot be used wi ## Example -The following sample generates C4076; to fix it, remove the **`unsigned`** type modifier: +The following example generates C4076; to fix it, remove the **`unsigned`** type modifier: ```cpp // C4076.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4077.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4077.md index c6c140c75ae..de0009d557a 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4077.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4077.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4077" title: "Compiler Warning (level 1) C4077" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4077" +ms.date: 11/04/2016 f1_keywords: ["C4077"] helpviewer_keywords: ["C4077"] -ms.assetid: c2d28805-b33f-41ad-afba-33b3f788c649 --- # Compiler Warning (level 1) C4077 -unknown check_stack option +> unknown check_stack option + +## Remarks The old form of the **check_stack** pragma is used with an unknown argument. The argument must be `+`, `-`, `(on)`, `(off)`, or empty. @@ -16,6 +17,8 @@ The compiler ignores the pragma and leaves the stack checking unchanged. ## Example +The following example generates C4077: + ```cpp // C4077.cpp // compile with: /W1 /LD diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4079.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4079.md index aa3914ce05d..89ec4207fdb 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4079.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4079.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4079" title: "Compiler Warning (level 1) C4079" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4079" +ms.date: 11/04/2016 f1_keywords: ["C4079"] helpviewer_keywords: ["C4079"] -ms.assetid: 549759f0-e168-47e9-8c9a-de93ac843689 --- # Compiler Warning (level 1) C4079 -unexpected token 'token' +> unexpected token 'token' + +## Remarks An unexpected separator token occurs in a pragma argument list. The remainder of the pragma was ignored. -The following sample generates C4079: +## Example + +The following example generates C4079: ```cpp // C4079.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4080.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4080.md index 4c78d21774f..60c2c69d85b 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4080.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4080.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4080" title: "Compiler Warning (level 1) C4080" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4080" +ms.date: 11/04/2016 f1_keywords: ["C4080"] helpviewer_keywords: ["C4080"] -ms.assetid: 964fb3f4-b9fd-450b-aa23-35cece126172 --- # Compiler Warning (level 1) C4080 -expected identifier for segment name; found 'symbol' +> expected identifier for segment name; found 'symbol' + +## Remarks The name of the segment in [#pragma alloc_text](../../preprocessor/alloc-text.md) must be a string or an identifier. The compiler ignores the pragma if a valid identifier is not found. -The following sample generates C4080: +## Example + +The following example generates C4080: ```cpp // C4080.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4081.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4081.md index a266ad55b2d..fff7ef70eca 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4081.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4081.md @@ -1,19 +1,22 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4081" title: "Compiler Warning (level 1) C4081" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4081" +ms.date: 11/04/2016 f1_keywords: ["C4081"] helpviewer_keywords: ["C4081"] -ms.assetid: 6f656373-a080-4989-bbc9-e2f894b03293 --- # Compiler Warning (level 1) C4081 -expected 'token1'; found 'token2' +> expected 'token1'; found 'token2' + +## Remarks The compiler expected a different token in this context. ## Example +The following example generates C4081: + ```cpp // C4081.cpp // compile with: /W1 /LD diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4083.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4083.md index 87918fc4491..2796ab139eb 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4083.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4083.md @@ -1,19 +1,22 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4083" title: "Compiler Warning (level 1) C4083" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4083" +ms.date: 11/04/2016 f1_keywords: ["C4083"] helpviewer_keywords: ["C4083"] -ms.assetid: e7d3344e-5645-4d56-8460-d1acc9145ada --- # Compiler Warning (level 1) C4083 -expected 'token'; found identifier 'identifier' +> expected 'token'; found identifier 'identifier' + +## Remarks An identifier occurs in the wrong place in a **#pragma** statement. ## Example +The following example generates C4083: + ```cpp // C4083.cpp // compile with: /W1 /LD diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4085.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4085.md index af90990a225..98a8afd3948 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4085.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4085.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4085" title: "Compiler Warning (level 1) C4085" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4085" +ms.date: 11/04/2016 f1_keywords: ["C4085"] helpviewer_keywords: ["C4085"] -ms.assetid: 2bc6eb25-058f-4597-b351-fd69587b5170 --- # Compiler Warning (level 1) C4085 -expected pragma parameter to be 'on' or 'off' +> expected pragma parameter to be 'on' or 'off' + +## Remarks The pragma requires an **on** or **off** parameter. The pragma is ignored. -The following sample generates C4085: +## Example + +The following example generates C4085: ```cpp // C4085.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4086.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4086.md index 1c8cf29e1b9..f64ee275649 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4086.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4086.md @@ -1,19 +1,22 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4086" title: "Compiler Warning (level 1) C4086" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4086" +ms.date: 11/04/2016 f1_keywords: ["C4086"] helpviewer_keywords: ["C4086"] -ms.assetid: 9248831b-22bf-47af-8684-bfadb17e94fc --- # Compiler Warning (level 1) C4086 -expected pragma parameter to be '1', '2', '4', '8', or '16' +> expected pragma parameter to be '1', '2', '4', '8', or '16' + +## Remarks The pragma parameter does not have the required value (1, 2, 4, 8, or 16). ## Example +The following example generates C4086: + ```cpp // C4086.cpp // compile with: /W1 /LD diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4087.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4087.md index 631fbd9d8c8..b8d7e4fa763 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4087.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4087.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4087" title: "Compiler Warning (level 1) C4087" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4087" +ms.date: 11/04/2016 f1_keywords: ["C4087"] helpviewer_keywords: ["C4087"] -ms.assetid: 546e4d57-5c8e-422c-8ef1-92657336dad5 --- # Compiler Warning (level 1) C4087 -'function' : declared with 'void' parameter list +> 'function' : declared with 'void' parameter list + +## Remarks The function declaration has no formal parameters, but the function call has actual parameters. Extra parameters are passed according to the calling convention of the function. @@ -16,6 +17,8 @@ This warning is for the C compiler. ## Example +The following example generates C4087: + ```c // C4087.c // compile with: /W1 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4088.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4088.md index 743a55b292b..24b6a432788 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4088.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4088.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4088" title: "Compiler Warning (level 1) C4088" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4088" +ms.date: 11/04/2016 f1_keywords: ["C4088"] helpviewer_keywords: ["C4088"] -ms.assetid: 9bab817c-16b2-4324-be5e-f9cbb06b702e --- # Compiler Warning (level 1) C4088 -'function' : pointer mismatch in actual parameter 'number', formal parameter 'number' +> 'function' : pointer mismatch in actual parameter 'number', formal parameter 'number' + +## Remarks The corresponding formal and actual parameters have a different level of indirection. The actual parameter is passed without change. The called function interprets its value as a pointer. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4089.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4089.md index c5a33f3524b..90895290376 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4089.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4089.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4089" title: "Compiler Warning (level 1) C4089" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4089" +ms.date: 11/04/2016 f1_keywords: ["C4089"] helpviewer_keywords: ["C4089"] -ms.assetid: 7c8f929b-9bf9-4063-9b7e-4affd98c1acc --- # Compiler Warning (level 1) C4089 -'function' : different types in actual parameter 'number', formal parameter 'number' +> 'function' : different types in actual parameter 'number', formal parameter 'number' + +## Remarks The corresponding formal and actual parameters have different types. The actual parameter is passed without change. The function casts the actual parameter to the type specified in the function definition. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4090.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4090.md index 4bb401cbcb1..716f99228f5 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4090.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4090.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4090" title: "Compiler Warning (level 1) C4090" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4090" +ms.date: 11/04/2016 f1_keywords: ["C4090"] helpviewer_keywords: ["C4090"] -ms.assetid: baad469d-23d4-45aa-ad9c-305b32d61e9a --- # Compiler Warning (level 1) C4090 -'operation' : different 'modifier' qualifiers +> 'operation' : different 'modifier' qualifiers + +## Remarks A variable used in an operation is defined with a specified modifier that prevents it from being modified without detection by the compiler. The expression is compiled without modification. @@ -16,7 +17,9 @@ This warning can be caused when a pointer to a **`const`** or **`volatile`** ite This warning is issued for C programs. In a C++ program, the compiler issues an error: [C2440](../../error-messages/compiler-errors-1/compiler-error-c2440.md). -The following sample generates C4090: +## Example + +The following example generates C4090: ```c // C4090.c diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4091.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4091.md index bd1e02649e1..100e44a0e12 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4091.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4091.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: Compiler Warning (level 1 and level 2) C4091" title: "Compiler Warning (level 1 and level 2) C4091" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1 and level 2) C4091" +ms.date: 11/04/2016 f1_keywords: ["C4091"] helpviewer_keywords: ["C4091"] --- @@ -9,11 +9,13 @@ helpviewer_keywords: ["C4091"] > '*keyword*': ignored on left of '*type*' when no variable is declared +## Remarks + The compiler detected a situation where the user probably intended a variable to be declared, but the compiler wasn't able to declare the variable. ## Examples -A **`__declspec`** attribute at the beginning of a user-defined type declaration applies to the variable of that type. C4091 indicates no variable is declared. The following sample generates C4091. +A **`__declspec`** attribute at the beginning of a user-defined type declaration applies to the variable of that type. C4091 indicates no variable is declared. The following example generates C4091. ```cpp // C4091.cpp @@ -28,7 +30,7 @@ __declspec(dllimport) class X2 {} varX; class __declspec(dllimport) X3 {}; ``` -If an identifier is a typedef, it can't also be a variable name. The following sample generates C4091. +If an identifier is a typedef, it can't also be a variable name. The following example generates C4091. ```cpp // C4091_b.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4096.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4096.md index 1013ef52740..95738c23070 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4096.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4096.md @@ -1,20 +1,23 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4096" title: "Compiler Warning (level 1) C4096" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4096" +ms.date: 11/04/2016 f1_keywords: ["C4096"] helpviewer_keywords: ["C4096"] -ms.assetid: abf3cca2-2f21-45d8-b025-6b513b00681e --- # Compiler Warning (level 1) C4096 -'a': interface is not a COM interface; will not be emitted to IDL +> 'a': interface is not a COM interface; will not be emitted to IDL + +## Remarks An interface definition that you may have intended as a COM interface was not defined as a COM interface and therefore will not be emitted to the IDL file. See [Interface Attributes](../../windows/attributes/interface-attributes.md) for a list attributes that indicate an interface is a COM interface. -The following sample generates C4096: +## Example + +The following example generates C4096: ```cpp // C4096.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4097.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4097.md index c9c9d9688d8..36cde34b27c 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4097.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4097.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4097" title: "Compiler Warning (level 1) C4097" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4097" +ms.date: 11/04/2016 f1_keywords: ["C4097"] helpviewer_keywords: ["C4097"] -ms.assetid: 2525be51-fac2-43b2-b57c-3bbf1a2268f7 --- # Compiler Warning (level 1) C4097 -expected pragma parameter to be 'restore' or 'off' +> expected pragma parameter to be 'restore' or 'off' + +## Remarks A pragma was passed an invalid value. -The following sample generates C4097: +## Example + +The following example generates C4097: ```cpp // C4097.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4098.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4098.md index 02da792a1f2..c90d530b284 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4098.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4098.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4098" title: "Compiler Warning (level 1) C4098" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4098" +ms.date: 11/04/2016 f1_keywords: ["C4098"] helpviewer_keywords: ["C4098"] -ms.assetid: 8c8aef1c-1639-44ec-a3dd-c0dfe9aa727d --- # Compiler Warning (level 1) C4098 -'function' : void function returning a value +> 'function' : void function returning a value + +## Remarks A function declared with return type [void](../../cpp/void-cpp.md) has a **`return`** statement that returns a value. The compiler assumes the function returns a value of type **`int`**. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4103.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4103.md index a61f63ece8c..c9365e43be1 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4103.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4103.md @@ -1,20 +1,23 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4103" title: "Compiler Warning (level 1) C4103" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4103" +ms.date: 11/04/2016 f1_keywords: ["C4103"] helpviewer_keywords: ["C4103"] -ms.assetid: 9021b514-375e-4d62-b261-ccb06f299e8e --- # Compiler Warning (level 1) C4103 -'filename' : alignment changed after including header, may be due to missing #pragma pack(pop) +> 'filename' : alignment changed after including header, may be due to missing #pragma pack(pop) + +## Remarks Packing affects the layout of classes, and commonly, if packing changes across header files, there can be problems. Use #pragma [pack](../../preprocessor/pack.md)(pop) before exiting the header file to resolve this warning. -The following sample generates C4103: +## Example + +The following example generates C4103: ```cpp // C4103.h diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4109.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4109.md index 3c6de78389d..dfa71b61be9 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4109.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4109.md @@ -1,19 +1,22 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4109" title: "Compiler Warning (level 1) C4109" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4109" +ms.date: 11/04/2016 f1_keywords: ["C4109"] helpviewer_keywords: ["C4109"] -ms.assetid: 9e8d95c6-e05d-47e0-bd87-78974b3cc06c --- # Compiler Warning (level 1) C4109 -unexpected identifier 'identifier' +> unexpected identifier 'identifier' + +## Remarks The pragma containing the unexpected identifier is ignored. ## Example +The following example generates C4109: + ```cpp // C4109.cpp // compile with: /W1 /LD diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4113.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4113.md index 7a93cc5ec61..336d4c75cb1 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4113.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4113.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4113" title: "Compiler Warning (level 1) C4113" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4113" +ms.date: 11/04/2016 f1_keywords: ["C4113"] helpviewer_keywords: ["C4113"] -ms.assetid: ec7a7c4a-d2ee-431c-89dc-31b0f9bfd975 --- # Compiler Warning (level 1) C4113 -'identifier1' differs in parameter lists from 'identifier2' +> 'identifier1' differs in parameter lists from 'identifier2' + +## Remarks A function pointer is assigned to another function pointer, but the formal parameter lists of the functions do not agree. The assignment is compiled without modification. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4114.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4114.md index ef6514dddea..57c02abc3a4 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4114.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4114.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4114" title: "Compiler Warning (level 1) C4114" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4114" +ms.date: 11/04/2016 f1_keywords: ["C4114"] helpviewer_keywords: ["C4114"] -ms.assetid: 3983e1c6-e8bb-46dc-8894-e1827db48797 --- # Compiler Warning (level 1) C4114 -same type qualifier used more than once +> same type qualifier used more than once + +## Remarks A type declaration or definition uses a type qualifier (**`const`**, **`volatile`**, **`signed`**, or **`unsigned`**) more than once. This causes a warning with Microsoft extensions (/Ze) and an error under ANSI compatibility (/Za). -The following sample generates C4114: +## Examples + +The following example generates C4114: ```cpp // C4114.cpp @@ -20,7 +23,7 @@ The following sample generates C4114: volatile volatile int i; // C4114 ``` -The following sample generates C4114: +The following example generates C4114: ```cpp // C4114_b.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4116.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4116.md index 4c64a7d9d08..b650d740844 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4116.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4116.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4116" title: "Compiler Warning (level 1) C4116" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4116" +ms.date: 11/04/2016 f1_keywords: ["C4116"] helpviewer_keywords: ["C4116"] -ms.assetid: 25434ef3-061e-4252-91a5-0fe2a4b2ffb3 --- # Compiler Warning (level 1) C4116 -unnamed type definition in parentheses +> unnamed type definition in parentheses + +## Remarks A structure, union, or enumerated type with no name is defined in a parenthetical expression. The type definition is meaningless. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4117.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4117.md index 1b76610289e..8355fc6923a 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4117.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4117.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4117" title: "Compiler Warning (level 1) C4117" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4117" +ms.date: 11/04/2016 f1_keywords: ["C4117"] helpviewer_keywords: ["C4117"] -ms.assetid: c45aa281-4cc1-4dfd-bd32-bd7a60ddd577 --- # Compiler Warning (level 1) C4117 -macro name 'name' is reserved; 'Command' ignored +> macro name 'name' is reserved; 'Command' ignored + +## Remarks ### To fix by checking the following possible causes @@ -16,7 +17,9 @@ macro name 'name' is reserved; 'Command' ignored 1. Trying to define or undefine the preprocessor operator **defined**. -The following sample generates C4117: +## Example + +The following example generates C4117: ```cpp // C4117.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4119.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4119.md index 6734a6e402b..4cdf1d4876f 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4119.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4119.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4119" title: "Compiler Warning (level 1) C4119" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4119" +ms.date: 11/04/2016 f1_keywords: ["C4119"] helpviewer_keywords: ["C4119"] -ms.assetid: 0052ce92-033a-4dce-a11e-b7388f4f5c2b --- # Compiler Warning (level 1) C4119 -different bases 'base1' and 'base2' specified +> different bases 'base1' and 'base2' specified + +## Remarks Two based pointers are incompatible because they have different bases. The compiler cannot convert between them. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4120.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4120.md index 65f329119b9..04227416fd6 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4120.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4120.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4120" title: "Compiler Warning (level 1) C4120" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4120" +ms.date: 11/04/2016 f1_keywords: ["C4120"] helpviewer_keywords: ["C4120"] -ms.assetid: 9faa9265-34b4-41dd-b7a2-e2f3969b1d91 --- # Compiler Warning (level 1) C4120 -based/unbased mismatch +> based/unbased mismatch + +## Remarks The compiler cannot convert between the two pointers because one is based and the other is not. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4122.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4122.md index 61cba8a38be..bdb3071ce53 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4122.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4122.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4122" title: "Compiler Warning (level 1) C4122" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4122" +ms.date: 11/04/2016 f1_keywords: ["C4122"] helpviewer_keywords: ["C4122"] -ms.assetid: 9a83eb0d-8708-42f7-988a-b0b6f2f646a0 --- # Compiler Warning (level 1) C4122 -'function' : alloc_text applicable only to functions with C linkage +> 'function' : alloc_text applicable only to functions with C linkage + +## Remarks The **alloc_text** pragma applies only to functions declared with **extern c**. It cannot be used with external C++ functions. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4124.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4124.md index 504d71c8ed4..6e38358a92c 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4124.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4124.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4124" title: "Compiler Warning (level 1) C4124" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4124" +ms.date: 11/04/2016 f1_keywords: ["C4124"] helpviewer_keywords: ["C4124"] -ms.assetid: c08c3a65-9584-47a1-a147-44f00c4b230e --- # Compiler Warning (level 1) C4124 -__fastcall with stack checking is inefficient +> __fastcall with stack checking is inefficient + +## Remarks The **`__fastcall`** keyword was used with stack checking enabled. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4129.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4129.md index 1dc06732e56..d75dddc8ccd 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4129.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4129.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4129" title: "Compiler Warning (level 1) C4129" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4129" +ms.date: 11/04/2016 f1_keywords: ["C4129"] helpviewer_keywords: ["C4129"] -ms.assetid: a4190c64-4bfb-48fd-8e98-52720bc0d878 --- # Compiler Warning (level 1) C4129 -'character' : unrecognized character escape sequence +> 'character' : unrecognized character escape sequence + +## Remarks The `character` following a backslash (\\) in a character or string constant is not recognized as a valid escape sequence. The backslash is ignored and not printed. The character following the backslash is printed. @@ -16,7 +17,9 @@ To print a single backslash, specify a double backslash (\\\\). The C++ standard, in section 2.13.2 discusses escape sequences. -The following sample generates C4129: +## Example + +The following example generates C4129: ```cpp // C4129.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4138.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4138.md index 8a5d005a472..e6971ba8739 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4138.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4138.md @@ -1,19 +1,22 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4138" title: "Compiler Warning (level 1) C4138" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4138" +ms.date: 11/04/2016 f1_keywords: ["C4138"] helpviewer_keywords: ["C4138"] -ms.assetid: 65ebf929-bba0-4237-923b-c1b66adfe17d --- # Compiler Warning (level 1) C4138 -'*/' found outside of comment +> '*/' found outside of comment + +## Remarks The closing-comment delimiter is not preceded by an opening-comment delimiter. The compiler assumes a space between the asterisk (\*) and the forward slash (/). ## Example +The following example generates C4138: + ```cpp // C4138a.cpp // compile with: /W1 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4141.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4141.md index e166131289d..7a38f03c082 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4141.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4141.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: Compiler Warning (level 1, Error) C4141" title: "Compiler Warning (level 1, Error) C4141" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1, Error) C4141" +ms.date: 11/04/2016 f1_keywords: ["C4141"] helpviewer_keywords: ["C4141"] --- @@ -11,6 +11,8 @@ helpviewer_keywords: ["C4141"] ## Example +The following example generates C4141: + ```cpp // C4141.cpp // compile with: /W1 /LD diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4142.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4142.md index 202399a686d..90f6cc10a7b 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4142.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4142.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4142" title: "Compiler Warning (level 1) C4142" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4142" +ms.date: 11/04/2016 f1_keywords: ["C4142"] helpviewer_keywords: ["C4142"] -ms.assetid: 1fdfc3dc-60a2-4f00-b133-20e400f9b7a6 --- # Compiler Warning (level 1) C4142 -benign redefinition of type +> benign redefinition of type + +## Remarks A type is redefined in a manner that has no effect on the generated code. @@ -18,7 +19,9 @@ To fix by checking the following possible causes: - A type defined with the **`typedef`** command is redefined using different syntax. -The following sample generates C4142: +## Example + +The following example generates C4142: ```c // C4142.c diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4143.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4143.md index 5ae6a8f9ad2..d4e1d6c8ab3 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4143.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4143.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4143" title: "Compiler Warning (level 1) C4143" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4143" +ms.date: 11/04/2016 f1_keywords: ["C4143"] helpviewer_keywords: ["same_seg", "C4143"] -ms.assetid: ef0bd19f-d169-4034-8710-b22971bd642d --- # Compiler Warning (level 1) C4143 -pragma 'same_seg' not supported; use __based allocation +> pragma 'same_seg' not supported; use __based allocation + +## Remarks The **#pragma same_seg** is no longer supported. Use the [__based](../../cpp/based-pointers-cpp.md) keyword instead. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4144.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4144.md index 9a5b1400ff6..19e46906093 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4144.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4144.md @@ -1,16 +1,21 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4144" title: "Compiler Warning (level 1) C4144" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4144" +ms.date: 11/04/2016 f1_keywords: ["C4144"] helpviewer_keywords: ["C4144"] -ms.assetid: a37b445d-dbc6-43b4-8d95-ffd0e4225464 --- # Compiler Warning (level 1) C4144 -'expression' : relational expression as switch expression +> 'expression' : relational expression as switch expression + +## Remarks + +The specified relational expression was used as the control expression of a [switch](../../cpp/switch-statement-cpp.md) statement. The associated case statements will be offered Boolean values. + +## Example -The specified relational expression was used as the control expression of a [switch](../../cpp/switch-statement-cpp.md) statement. The associated case statements will be offered Boolean values. The following sample generates C4144: +The following example generates C4144: ```cpp // C4144.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4145.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4145.md index 5d2abaa9db8..4ef4b5f5e37 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4145.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4145.md @@ -1,20 +1,21 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4145" title: "Compiler Warning (level 1) C4145" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4145" +ms.date: 11/04/2016 f1_keywords: ["C4145"] helpviewer_keywords: ["C4145"] -ms.assetid: 0440777a-cca2-4159-aff5-e67a254ad64a --- # Compiler Warning (level 1) C4145 -'expression1' : relational expression as switch expression; possible confusion with 'expression2' +> 'expression1' : relational expression as switch expression; possible confusion with 'expression2' + +## Remarks A **`switch`** statement uses a relational expression as its control expression, which results in a Boolean value for the **`case`** statements. Did you mean *expression2*? ## Example -The following sample generates C4145: +The following example generates C4145: ```cpp // C4145.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4153.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4153.md index 452c1f40feb..0f80d1e4c9d 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4153.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4153.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4153" title: "Compiler Warning (level 1) C4153" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4153" +ms.date: 11/04/2016 f1_keywords: ["C4153"] helpviewer_keywords: ["C4153"] -ms.assetid: 37a15754-9dba-470b-adda-c4b888064b3e --- # Compiler Warning (level 1) C4153 -function/data pointer conversion in expression +> function/data pointer conversion in expression + +## Remarks A function pointer is converted to or from a data pointer. This conversion is allowed under Microsoft extensions (/Ze) but not under ANSI C. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4154.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4154.md index a46730e0c11..bd590178ea3 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4154.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4154.md @@ -1,19 +1,22 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4154" title: "Compiler Warning (level 1) C4154" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4154" +ms.date: 11/04/2016 f1_keywords: ["C4154"] helpviewer_keywords: ["C4154"] -ms.assetid: 4511afeb-e893-4cc6-83b6-4c7a0477f76b --- # Compiler Warning (level 1) C4154 -deletion of an array expression; conversion to pointer supplied +> deletion of an array expression; conversion to pointer supplied + +## Remarks You cannot use **`delete`** on an array, so the compiler converts the array to a pointer. ## Example +The following example generates C4154: + ```cpp // C4154.cpp // compile with: /c /W1 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4155.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4155.md index bb736d60391..8ae584b843a 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4155.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4155.md @@ -1,20 +1,21 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4155" title: "Compiler Warning (level 1) C4155" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4155" +ms.date: 11/04/2016 f1_keywords: ["C4155"] helpviewer_keywords: ["C4155"] -ms.assetid: ba233353-09e3-4195-8127-13a27ddd8d70 --- # Compiler Warning (level 1) C4155 -deletion of an array expression without using the array form of 'delete' +> deletion of an array expression without using the array form of 'delete' + +## Remarks The array form of **`delete`** should be used to delete an array. This warning occurs only under ANSI-compatibility (/Za). ## Example -The following sample generates C4155: +The following example generates C4155: ```cpp // C4155.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4157.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4157.md index db705ad99ec..1f1864aff51 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4157.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4157.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4157" title: "Compiler Warning (level 1) C4157" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4157" +ms.date: 11/04/2016 f1_keywords: ["C4157"] helpviewer_keywords: ["C4157"] -ms.assetid: 6dabc303-eba1-4a8e-a124-a6e1dc84f4bd --- # Compiler Warning (level 1) C4157 -pragma was ignored by C compiler +> pragma was ignored by C compiler + +## Remarks Only the C++ compiler recognizes **init_seg()**. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4158.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4158.md index 0c5e3fe14ca..72fbc895e57 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4158.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4158.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4158" title: "Compiler Warning (level 1) C4158" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4158" +ms.date: 11/04/2016 f1_keywords: ["C4158"] helpviewer_keywords: ["C4158"] -ms.assetid: 6513c6b9-6772-4849-b96c-5bb093d54de6 --- # Compiler Warning (level 1) C4158 > assuming #pragma pointers_to_members(full_generality, inheritance) +## Remarks + A `#pragma pointers_to_members( single | multiple | virtual )` was issued without an accompanying `#pragma pointers_to_members(full_generality)`. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4160.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4160.md index a0765747a33..6eea80c6c9e 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4160.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4160.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4160" title: "Compiler Warning (level 1) C4160" -ms.date: "08/27/2018" +description: "Learn more about: Compiler Warning (level 1) C4160" +ms.date: 08/27/2018 f1_keywords: ["C4160"] helpviewer_keywords: ["C4160"] -ms.assetid: a9610cb7-cac4-4a74-8b4e-049030ebb92b --- # Compiler Warning (level 1) C4160 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4162.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4162.md index 151a1a95050..41936b10c1f 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4162.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4162.md @@ -1,20 +1,23 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4162" title: "Compiler Warning (level 1) C4162" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4162" +ms.date: 11/04/2016 f1_keywords: ["C4162"] helpviewer_keywords: ["C4162"] -ms.assetid: 21ae3c92-501d-4689-ad7d-13753cb65eff --- # Compiler Warning (level 1) C4162 -'identifier' : no function with C linkage found +> 'identifier' : no function with C linkage found + +## Remarks A function with C linkage is declared but cannot be found. To resolve this warning, compile in a .c file (invoke the C compiler). If you must invoke the C++ compiler, place extern "C" before the function declaration. -The following sample generates C4162 +## Example + +The following example generates C4162: ```cpp // C4162.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4163.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4163.md index b49a2aed3ae..a66c5cf9508 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4163.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4163.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4163" title: "Compiler Warning (level 1) C4163" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4163" +ms.date: 11/04/2016 f1_keywords: ["C4163"] helpviewer_keywords: ["C4163"] -ms.assetid: b08413fd-03fc-4f41-9167-a98976ac12f2 --- # Compiler Warning (level 1) C4163 -'identifier' : not available as an intrinsic function +> 'identifier' : not available as an intrinsic function + +## Remarks The specified function cannot be used as an [intrinsic](../../preprocessor/intrinsic.md) function. The compiler ignores the invalid function name. -The following sample generates C4163: +## Example + +The following example generates C4163: ```cpp // C4163.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4164.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4164.md index 37bbf267a15..ba0cc3fa68d 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4164.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4164.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4164" title: "Compiler Warning (level 1) C4164" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4164" +ms.date: 11/04/2016 f1_keywords: ["C4164"] helpviewer_keywords: ["C4164"] -ms.assetid: 6d7e4a36-8227-4419-880f-44576033493e --- # Compiler Warning (level 1) C4164 -'identifier' : intrinsic function not declared +> 'identifier' : intrinsic function not declared + +## Remarks The specified intrinsic function is not declared; you may need to #include the appropriate header file. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4165.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4165.md index aa851b63b8c..eb54234ee06 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4165.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4165.md @@ -1,13 +1,15 @@ --- -description: "Learn more about: Compiler Warning (level 3, off) C4165" title: "Compiler Warning (level 3, off) C4165" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 3, off) C4165" +ms.date: 11/04/2016 f1_keywords: ["C4165"] helpviewer_keywords: ["C4165"] --- # Compiler Warning (level 3, off) C4165 -'`HRESULT`' is being converted to '`bool`'; are you sure this is what you want? +> '`HRESULT`' is being converted to '`bool`'; are you sure this is what you want? + +## Remarks When an `HRESULT` is used in an [`if`](../../cpp/if-else-statement-cpp.md) statement, the `HRESULT` is converted to a [`bool`](../../cpp/bool-cpp.md) unless you explicitly test for the variable as an `HRESULT`. @@ -15,7 +17,7 @@ Warning C4165 is off by default. For more information, see [Compiler Warnings Th ## Example -The following sample generates C4165: +The following example generates C4165: ```cpp // C4165.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4166.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4166.md index 081a79b459b..b3b8268a78d 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4166.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4166.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4166" title: "Compiler Warning (level 1) C4166" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4166" +ms.date: 11/04/2016 f1_keywords: ["C4166"] helpviewer_keywords: ["C4166"] -ms.assetid: 4e5398a1-d913-4791-a470-06fc99c36ac5 --- # Compiler Warning (level 1) C4166 -**illegal calling convention for constructor/destructor** +> illegal calling convention for constructor/destructor + +## Remarks Constructors and destructors cannot have calling conventions other than the default for the platform (except when you explicitly specify **__clrcall**). diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4167.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4167.md index ba1b58c8861..4ab61233a5d 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4167.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4167.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4167" title: "Compiler Warning (level 1) C4167" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4167" +ms.date: 11/04/2016 f1_keywords: ["C4167"] helpviewer_keywords: ["C4167"] -ms.assetid: 74a420bd-9371-4167-b1ee-74dd8680f97b --- # Compiler Warning (level 1) C4167 -function : only available as an intrinsic function +> function : only available as an intrinsic function + +## Remarks The **#pragma function** tries to force the compiler to use a conventional call to a function that must be used in intrinsic form. The pragma is ignored. @@ -16,6 +17,8 @@ To avoid this warning, remove the **#pragma function**. ## Example +The following example generates C4167: + ```cpp // C4167.cpp // compile with: /W1 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4168.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4168.md index 18cc19630d2..6c487ba5d60 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4168.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4168.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4168" title: "Compiler Warning (level 1) C4168" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4168" +ms.date: 11/04/2016 f1_keywords: ["C4168"] helpviewer_keywords: ["C4168"] -ms.assetid: 1feefa6c-37be-4f7d-856e-f4b648f2fff8 --- # Compiler Warning (level 1) C4168 -compiler limit : out of debugger types, delete program database 'database' and rebuild +> compiler limit : out of debugger types, delete program database 'database' and rebuild + +## Remarks The program database file must be rebuilt to accommodate all types in the program. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4172.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4172.md index 45e27ccfbd7..393c35c0c60 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4172.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4172.md @@ -1,29 +1,43 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4172" title: "Compiler Warning (level 1) C4172" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4172" +ms.date: 06/25/2025 f1_keywords: ["C4172"] helpviewer_keywords: ["C4172"] -ms.assetid: a8d2bf65-d8b1-4fe3-8340-a223d7e7fde6 --- # Compiler Warning (level 1) C4172 -returning address of local variable or temporary +> returning address of local variable or temporary : *optional_context* + +## Remarks A function returns the address of a local variable or temporary object. Local variables and temporary objects are destroyed when a function returns, so the address returned is not valid. Redesign the function so that it does not return the address of a local object. -The following sample generates C4172: +## Example + +The following example generates C4172: ```cpp // C4172.cpp -// compile with: /W1 /LD -float f = 10; +// compile with: /c /W1 + +const int* func1() +{ + int i = 42; + return &i; // C4172 +} + +float f = 1.f; -const double& bar() { -// try the following line instead -// const float& bar() { - return f; // C4172 +const double& func2() +// Try one of the following lines instead: +// const float& func2() +// const auto& func2() +{ + // The problem is that a temporary is created to convert f to a double. + // C4172 in this case refers to returning the address of a temporary. + return f; // C4172 } ``` diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4174.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4174.md index 4f3fdd7da9b..7f02878573c 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4174.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4174.md @@ -1,17 +1,18 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4174" title: "Compiler Warning (level 1) C4174" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4174" +ms.date: 11/04/2016 f1_keywords: ["C4174"] helpviewer_keywords: ["C4174"] -ms.assetid: 63301e51-24bc-43c4-bb11-252f7d513e9e --- # Compiler Warning (level 1) C4174 -'name' : not available as a #pragma component +> 'name' : not available as a #pragma component ## Example +The following example generates C4174: + ```cpp // C4174.cpp // compile with: /W1 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4175.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4175.md index 5840c607830..275c235f0b5 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4175.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4175.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4175" title: "Compiler Warning (level 1) C4175" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4175" +ms.date: 11/04/2016 f1_keywords: ["C4175"] helpviewer_keywords: ["C4175"] -ms.assetid: 11407a07-127c-4d0d-b262-61f9f2b035ba --- # Compiler Warning (level 1) C4175 -\#pragma component(browser, on) : browser info must initially be specified on the command line +> #pragma component(browser, on) : browser info must initially be specified on the command line + +## Remarks To use [component](../../preprocessor/component.md) pragma, you must generate browse information during compilation ([/FR](../../build/reference/fr-fr-create-dot-sbr-file.md)). diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4176.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4176.md index 209b15d9bfc..22aa2aa22bd 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4176.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4176.md @@ -1,19 +1,22 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4176" title: "Compiler Warning (level 1) C4176" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4176" +ms.date: 11/04/2016 f1_keywords: ["C4176"] helpviewer_keywords: ["C4176"] -ms.assetid: cfffb934-219a-4a63-9df6-ba54405bf766 --- # Compiler Warning (level 1) C4176 -'subcomponent' : unknown subcomponent for #pragma component browser +> 'subcomponent' : unknown subcomponent for #pragma component browser + +## Remarks The **component** pragma contains an invalid subcomponent. To exclude references to a particular name, you must use the **references** option before the name. ## Example +The following example generates C4176: + ```cpp // C4176.cpp // compile with: /W1 /LD diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4177.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4177.md index d01e1cdba15..39115e3e153 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4177.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4177.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4177" title: "Compiler Warning (level 1) C4177" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4177" +ms.date: 11/04/2016 f1_keywords: ["C4177"] helpviewer_keywords: ["C4177"] -ms.assetid: 2b05a5b3-696e-4f21-818e-227b9335e748 --- # Compiler Warning (level 1) C4177 -\#pragma pragma should be at global scope +> #pragma pragma should be at global scope + +## Remarks The [pragma](../../preprocessor/pragma-directives-and-the-pragma-keyword.md) pragma should not be used within a local scope. The **pragma** will not be valid until global scope is encountered after the current scope. -The following sample generates C4177: +## Example + +The following example generates C4177: ```cpp // C4177.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4178.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4178.md index c3cf0473250..9500322b58e 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4178.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4178.md @@ -1,18 +1,22 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4178" title: "Compiler Warning (level 1) C4178" -ms.date: "03/06/2024" +description: "Learn more about: Compiler Warning (level 1) C4178" +ms.date: 03/06/2024 f1_keywords: ["C4178"] helpviewer_keywords: ["C4178"] --- # Compiler Warning (level 1) C4178 -case constant 'constant' too big for the type of the switch expression +> case constant 'constant' too big for the type of the switch expression + +## Remarks A case constant in a **`switch`** expression does not fit in the type to which it is assigned. ## Example +The following example generates C4178: + ```cpp // C4178.cpp // compile with: /W1 /permissive diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4179.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4179.md index 79ed15e5d51..7ee0442c813 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4179.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4179.md @@ -1,6 +1,6 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4179" title: "Compiler Warning (level 1) C4179" +description: "Learn more about: Compiler Warning (level 1) C4179" ms.date: 05/03/2021 f1_keywords: ["C4179"] helpviewer_keywords: ["C4179"] @@ -9,14 +9,18 @@ helpviewer_keywords: ["C4179"] > '`//*`' : parsed as '`/`' and '`/*`': confusion with standard '`//`' comments -In standard C89, **`//*`** is an incorrect comment delimiter. Use **`/*`** under **`/Za`** instead. - ## Remarks +In standard C89, **`//*`** is an incorrect comment delimiter. Use **`/*`** under **`/Za`** instead. + Before Visual Studio 2017 version 15.5, under **`/Za`**, the C compiler emits C4179 for a non-standard comment delimiter. In Visual Studio 2017 version 15.5, the C compiler no longer emits warnings C4001 and C4179. The warnings aren't needed because single-line comments have been part of the C standard since C99. +## Example + +The following example generates C4179: + ```C /* C only */ #pragma warning(disable:4001) // C4619 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4180.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4180.md index c1134d1c3d7..e29467a8dea 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4180.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4180.md @@ -1,19 +1,22 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4180" title: "Compiler Warning (level 1) C4180" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4180" +ms.date: 11/04/2016 f1_keywords: ["C4180"] helpviewer_keywords: ["C4180"] -ms.assetid: 40c91bd4-37f1-4d59-a4f3-d5ddab68239b --- # Compiler Warning (level 1) C4180 -qualifier applied to function type has no meaning; ignored +> qualifier applied to function type has no meaning; ignored + +## Remarks A qualifier, such as **`const`**, is applied to a function type defined by **`typedef`**. ## Example +The following example generates C4180: + ```cpp // C4180.cpp // compile with: /W1 /c diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4182.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4182.md index 0983b499fa9..c5097e114ba 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4182.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4182.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4182" title: "Compiler Warning (level 1) C4182" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4182" +ms.date: 11/04/2016 f1_keywords: ["C4182"] helpviewer_keywords: ["C4182"] -ms.assetid: 8970f3c6-e2dd-407e-b2ec-964360eb8b43 --- # Compiler Warning (level 1) C4182 -\#include nesting level is 'number' deep; possible infinite recursion +> #include nesting level is 'number' deep; possible infinite recursion + +## Remarks The compiler ran out of space on the heap because of the number of nested include files. An include file is nested when it is included from another include file. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4183.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4183.md index f6151e2d0f2..1b3233348c9 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4183.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4183.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4183" title: "Compiler Warning (level 1) C4183" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4183" +ms.date: 11/04/2016 f1_keywords: ["C4183"] helpviewer_keywords: ["C4183"] -ms.assetid: dc48312c-4b34-44dd-80ff-eb5f11d5ca47 --- # Compiler Warning (level 1) C4183 -'identifier': missing return type; assumed to be a member function returning 'int' +> 'identifier': missing return type; assumed to be a member function returning 'int' + +## Remarks The inline definition of a member function in a class or a structure does not have a return type. This member function is assumed to have a default return type of **`int`**. -The following sample generates C4183: +## Example + +The following example generates C4183: ```cpp // C4183.cpp @@ -20,6 +23,6 @@ The following sample generates C4183: #pragma warning(disable : 4430) class MyClass1; class MyClass2 { - MyClass1() {}; // C4183 + MyClass1() {} // C4183 }; ``` diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4185.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4185.md index 92f1ada3b6b..d2bfec209ad 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4185.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4185.md @@ -1,19 +1,22 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4185" title: "Compiler Warning (level 1) C4185" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4185" +ms.date: 11/04/2016 f1_keywords: ["C4185"] helpviewer_keywords: ["C4185"] -ms.assetid: 37e7063a-35b1-4e05-ae31-e811dced02b9 --- # Compiler Warning (level 1) C4185 -ignoring unknown #import attribute 'attribute' +> ignoring unknown #import attribute 'attribute' + +## Remarks The attribute is not a valid attribute of `#import`. It is ignored. ## Example +The following example generates C4185: + ```cpp // C4185.cpp // compile with: /W1 /c diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4186.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4186.md index 5e4248063e1..0f6985e5d1a 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4186.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4186.md @@ -1,19 +1,22 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4186" title: "Compiler Warning (level 1) C4186" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4186" +ms.date: 11/04/2016 f1_keywords: ["C4186"] helpviewer_keywords: ["C4186"] -ms.assetid: caf3f7d8-f305-426b-8d4e-2b96f5c269ea --- # Compiler Warning (level 1) C4186 -\#import attribute 'attribute' requires count arguments; ignored +> #import attribute 'attribute' requires count arguments; ignored + +## Remarks A `#import` attribute has the wrong number of arguments. ## Example +The following example generates C4186: + ```cpp // C4186.cpp // compile with: /W1 /c diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4187.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4187.md index 7690c5eca1f..8ff6b94d85c 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4187.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4187.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4187" title: "Compiler Warning (level 1) C4187" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4187" +ms.date: 11/04/2016 f1_keywords: ["C4187"] helpviewer_keywords: ["C4187"] -ms.assetid: 2443d948-ab7b-472c-af43-5d81e09af677 --- # Compiler Warning (level 1) C4187 -\#import attributes 'attribute1' and 'attribute2' are incompatible; both ignored +> #import attributes 'attribute1' and 'attribute2' are incompatible; both ignored + +## Remarks A [#import](../../preprocessor/hash-import-directive-cpp.md) statement specified `no_implementation` and `implementation_only` attributes. Both are ignored. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4190.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4190.md index 7870bbed65c..57257424bda 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4190.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4190.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4190" title: "Compiler Warning (level 1) C4190" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4190" +ms.date: 11/04/2016 f1_keywords: ["C4190"] helpviewer_keywords: ["C4190"] -ms.assetid: a4d0ad93-a19a-4063-addd-36d605831567 --- # Compiler Warning (level 1) C4190 -'identifier1' has C-linkage specified, but returns UDT 'identifier2' which is incompatible with C +> 'identifier1' has C-linkage specified, but returns UDT 'identifier2' which is incompatible with C + +## Remarks A function or pointer to function has a UDT (user-defined type, which is a class, structure, enum, or union) as return type and `extern "C"` linkage. This is legal if: @@ -18,6 +19,8 @@ A function or pointer to function has a UDT (user-defined type, which is a class ## Example +The following example generates C4190: + ```cpp // C4190.cpp // compile with: /W1 /LD diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4215.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4215.md index ee07bacbca1..27a4c3ce647 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4215.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4215.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4215" title: "Compiler Warning (level 1) C4215" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4215" +ms.date: 11/04/2016 f1_keywords: ["C4215"] helpviewer_keywords: ["C4215"] -ms.assetid: f2aab64d-1bab-4f75-95ee-89e1263047b1 --- # Compiler Warning (level 1) C4215 -nonstandard extension used : long float +> nonstandard extension used : long float + +## Remarks The default Microsoft extensions (/Ze) treat **long float** as **`double`**. ANSI compatibility ([/Za](../../build/reference/za-ze-disable-language-extensions.md)) does not. Use **`double`** to maintain compatibility. -The following sample generates C4215: +## Example + +The following example generates C4215: ```cpp // C4215.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4216.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4216.md index 26fd546e18b..aa54762a695 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4216.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4216.md @@ -1,16 +1,21 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4216" title: "Compiler Warning (level 1) C4216" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4216" +ms.date: 11/04/2016 f1_keywords: ["C4216"] helpviewer_keywords: ["C4216"] -ms.assetid: 211079dc-59d0-42a7-801c-2ddab21d7232 --- # Compiler Warning (level 1) C4216 -nonstandard extension used : float long +> nonstandard extension used : float long + +## Remarks + +The default Microsoft extensions (/Ze) treat **float long** as **`double`**. ANSI compatibility ([/Za](../../build/reference/za-ze-disable-language-extensions.md)) does not. Use **`double`** to maintain compatibility. + +## Example -The default Microsoft extensions (/Ze) treat **float long** as **`double`**. ANSI compatibility ([/Za](../../build/reference/za-ze-disable-language-extensions.md)) does not. Use **`double`** to maintain compatibility. The following sample generates C4216: +The following example generates C4216: ```cpp // C4216.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4218.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4218.md index 510c44d4b9f..21910d55dfc 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4218.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4218.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: Compiler Warning (level 4) C4218" title: "Compiler Warning (level 4) C4218" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 4) C4218" +ms.date: 11/04/2016 f1_keywords: ["C4218"] helpviewer_keywords: ["C4218"] --- @@ -9,10 +9,14 @@ helpviewer_keywords: ["C4218"] > nonstandard extension used: must specify at least a storage class or a type +## Remarks + With the default Microsoft extensions (`/Ze`), you can declare a variable without specifying a type or storage class. The default type is **`int`**. ## Example +The following example generates C4218: + ```cpp // C4218.c // compile with: /W4 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4224.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4224.md index 58abd03fe9a..9eea04e97ed 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4224.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4224.md @@ -1,19 +1,22 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4224" title: "Compiler Warning (level 1) C4224" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4224" +ms.date: 11/04/2016 f1_keywords: ["C4224"] helpviewer_keywords: ["C4224"] -ms.assetid: 1531cae0-5040-49fd-b149-005bb5085391 --- # Compiler Warning (level 1) C4224 -nonstandard extension used : formal parameter 'identifier' was previously defined as a type +> nonstandard extension used : formal parameter 'identifier' was previously defined as a type + +## Remarks The identifier was previously used as a **`typedef`**. This causes a warning under ANSI compatibility ([/Za](../../build/reference/za-ze-disable-language-extensions.md)). ## Example +The following example generates C4224: + ```cpp // C4224.cpp // compile with: /Za /W1 /LD diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4226.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4226.md index 8861456c970..19124a35a03 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4226.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4226.md @@ -1,15 +1,16 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4226" title: "Compiler Warning (level 1) C4226" -ms.date: "10/25/2017" +description: "Learn more about: Compiler Warning (level 1) C4226" +ms.date: 10/25/2017 f1_keywords: ["C4226"] helpviewer_keywords: ["C4226"] -ms.assetid: 69d6bbde-1300-4e48-8a9c-3648c80ab441 --- # Compiler Warning (level 1) C4226 > nonstandard extension used : '*keyword*' is an obsolete keyword +## Remarks + The current version of Visual C++ does not use this keyword. This warning is automatically promoted to an error. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4227.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4227.md index b07ac66855a..d59944fbccf 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4227.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4227.md @@ -1,19 +1,22 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4227" title: "Compiler Warning (level 1) C4227" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4227" +ms.date: 11/04/2016 f1_keywords: ["C4227"] helpviewer_keywords: ["C4227"] -ms.assetid: 78f98374-c00b-4000-aefa-1b1c67b4666b --- # Compiler Warning (level 1) C4227 -anachronism used : qualifiers on reference are ignored +> anachronism used : qualifiers on reference are ignored + +## Remarks Using qualifiers like **`const`** or **`volatile`** with C++ references is an outdated practice. ## Example +The following example generates C4227: + ```cpp // C4227.cpp // compile with: /W1 /c diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4228.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4228.md index 9d10d770f9b..da9cdeefa90 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4228.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4228.md @@ -1,19 +1,22 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4228" title: "Compiler Warning (level 1) C4228" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4228" +ms.date: 11/04/2016 f1_keywords: ["C4228"] helpviewer_keywords: ["C4228"] -ms.assetid: 9301d660-d601-464e-83f5-7ed844a3c6dc --- # Compiler Warning (level 1) C4228 -nonstandard extension used : qualifiers after comma in declarator list are ignored +> nonstandard extension used : qualifiers after comma in declarator list are ignored + +## Remarks Use of qualifiers like **`const`** or **`volatile`** after a comma when declaring variables is a Microsoft extension ([/Ze](../../build/reference/za-ze-disable-language-extensions.md)). ## Example +The following example generates C4228: + ```cpp // C4228.cpp // compile with: /W1 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4229.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4229.md index d79edef4c85..cbc55d7f30d 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4229.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4229.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: Compiler Warning (level 1, Error) C4229" title: "Compiler Warning (level 1, Error) C4229" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1, Error) C4229" +ms.date: 11/04/2016 f1_keywords: ["C4229"] helpviewer_keywords: ["C4229"] --- @@ -9,10 +9,14 @@ helpviewer_keywords: ["C4229"] > anachronism used: modifiers on data are ignored +## Remarks + Using a Microsoft modifier such as **`__cdecl`** on a data declaration is an outdated practice. ## Example +The following example generates C4229: + ```cpp // C4229.cpp // compile with: /W1 /LD diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4230.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4230.md index 0365bac51a4..37dd1af4b1c 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4230.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4230.md @@ -1,19 +1,22 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4230" title: "Compiler Warning (level 1) C4230" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4230" +ms.date: 11/04/2016 f1_keywords: ["C4230"] helpviewer_keywords: ["C4230"] -ms.assetid: a4be8729-74b6-44df-a5ea-e3f45aad0f8f --- # Compiler Warning (level 1) C4230 -anachronism used : modifiers/qualifiers interspersed; qualifier ignored +> anachronism used : modifiers/qualifiers interspersed; qualifier ignored + +## Remarks Using a qualifier before a Microsoft modifier such as **`__cdecl`** is an outdated practice. ## Example +The following example generates C4230: + ```cpp // C4230.cpp // compile with: /W1 /LD diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4237.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4237.md index 30336fc8024..122af024123 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4237.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4237.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4237" title: "Compiler Warning (level 1) C4237" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4237" +ms.date: 11/04/2016 f1_keywords: ["C4237"] helpviewer_keywords: ["C4237"] -ms.assetid: f2e86c4b-80d8-460e-9429-83c5f3f5d7ca --- # Compiler Warning (level 1) C4237 -'keyword' keyword is not yet supported, but reserved for future use +> 'keyword' keyword is not yet supported, but reserved for future use + +## Remarks A keyword in the C++ specification is not implemented in the Microsoft C++ compiler, but the keyword is not available as a user-defined symbol. -The following sample generates C4237: +## Example + +The following example generates C4237: ```cpp // C4237.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4251.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4251.md index 5045a15a4cc..b0b11764a1c 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4251.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4251.md @@ -1,13 +1,13 @@ --- -description: "Learn more about: Compiler Warning (level 2) C4251" title: "Compiler Warning (level 2) C4251" +description: "Learn more about: Compiler Warning (level 2) C4251" ms.date: 12/01/2023 f1_keywords: ["C4251"] helpviewer_keywords: ["C4251"] --- # Compiler Warning (level 2) C4251 -> '*type*' : class '*type1*' needs to have dll-interface to be used by clients of class '*type2*' +> '*type*': '*type1*' needs to have dll-interface to be used by clients of '*type2*' ## Remarks @@ -32,6 +32,8 @@ Think carefully about adding `__declspec(dllexport)` or `__declspec(dllimport)` ## Example +The following example generates C4251: + ```cpp // C4251.cpp // Compile with /std:c++20 /EHsc /W2 /c C4251.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4258.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4258.md index f2131c6a91c..a29bd856a5b 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4258.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4258.md @@ -1,16 +1,21 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4258" title: "Compiler Warning (level 1) C4258" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4258" +ms.date: 11/04/2016 f1_keywords: ["C4258"] helpviewer_keywords: ["C4258"] -ms.assetid: bbb75e6d-6693-4e62-8ed3-b006a0ec55e3 --- # Compiler Warning (level 1) C4258 -'variable' : definition from the for loop is ignored; the definition from the enclosing scope is used" +> 'variable' : definition from the for loop is ignored; the definition from the enclosing scope is used" + +## Remarks + +Under [/Ze](../../build/reference/za-ze-disable-language-extensions.md) and [/Zc:forScope](../../build/reference/zc-forscope-force-conformance-in-for-loop-scope.md), variables defined in a [for](../../cpp/for-statement-cpp.md) loop go out of scope after the **`for`** loop ends. This warning occurs if a variable with the same name as the loop variable, but defined in the enclosing loop, is used again in the scope containing the **`for`** loop. + +## Example -Under [/Ze](../../build/reference/za-ze-disable-language-extensions.md) and [/Zc:forScope](../../build/reference/zc-forscope-force-conformance-in-for-loop-scope.md), variables defined in a [for](../../cpp/for-statement-cpp.md) loop go out of scope after the **`for`** loop ends. This warning occurs if a variable with the same name as the loop variable, but defined in the enclosing loop, is used again in the scope containing the **`for`** loop. For example: +For example: ```cpp // C4258.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4264.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4264.md index 4fe40000681..a781621f80a 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4264.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4264.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: Compiler Warning (level 4, off) C4264" title: "Compiler Warning (level 4, off) C4264" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 4, off) C4264" +ms.date: 11/04/2016 f1_keywords: ["C4264"] helpviewer_keywords: ["C4264"] --- @@ -9,6 +9,8 @@ helpviewer_keywords: ["C4264"] > 'virtual_function' : no override available for virtual member function from base 'class'; function is hidden +## Remarks + C4264 is always generated after [C4263](../../error-messages/compiler-warnings/compiler-warning-level-4-c4263.md). This warning is off by default. For more information, see [Compiler Warnings That Are Off by Default](../../preprocessor/compiler-warnings-that-are-off-by-default.md). diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4269.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4269.md index 3a8fdd16f45..d5b610b7592 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4269.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4269.md @@ -1,19 +1,22 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4269" title: "Compiler Warning (level 1) C4269" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4269" +ms.date: 11/04/2016 f1_keywords: ["C4269"] helpviewer_keywords: ["C4269"] -ms.assetid: 96c97bbc-068a-4b65-8cd8-4ed5dca04c15 --- # Compiler Warning (level 1) C4269 -'identifier' : 'const' automatic data initialized with compiler generated default constructor produces unreliable results +> 'identifier' : 'const' automatic data initialized with compiler generated default constructor produces unreliable results + +## Remarks A **`const`** automatic instance of a non-trivial class is initialized with a compiler-generated default constructor. ## Example +The following example generates C4269: + ```cpp // C4269.cpp // compile with: /c /LD /W1 @@ -24,7 +27,7 @@ public: void g() { const X x1; // C4269 -}; +} ``` Since this instance of the class is generated on the stack, the initial value of `m_data` can be anything. Also, since it is a **`const`** instance, the value of `m_data` can never be changed. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4272.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4272.md index 6ef913aa807..d4f042ea5c1 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4272.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4272.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4272" title: "Compiler Warning (level 1) C4272" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4272" +ms.date: 11/04/2016 f1_keywords: ["C4272"] helpviewer_keywords: ["C4272"] -ms.assetid: 0d6c1de4-2eef-42c4-b861-c221f8b495ef --- # Compiler Warning (level 1) C4272 -'function' : is marked __declspec(dllimport); must specify native calling convention when importing a function. +> 'function' : is marked __declspec(dllimport); must specify native calling convention when importing a function. + +## Remarks It is an error to export a function marked with the [__clrcall](../../cpp/clrcall.md) calling convention, and the compiler issues this warning if you attempt to import a function marked `__clrcall`. -The following sample generates C4272: +## Example + +The following example generates C4272: ```cpp // C4272.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4273.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4273.md index 4bd91a8079a..d53d8ece27c 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4273.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4273.md @@ -1,20 +1,21 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4273" title: "Compiler Warning (level 1) C4273" +description: "Learn more about: Compiler Warning (level 1) C4273" ms.date: 05/23/2022 f1_keywords: ["C4273"] helpviewer_keywords: ["C4273"] -ms.assetid: cc18611d-9454-40a4-ad73-69823d5888fb --- # Compiler Warning (level 1) C4273 > '*function*' : inconsistent DLL linkage +## Remarks + Two definitions in a file differ in their use of [`dllimport`](../../cpp/dllexport-dllimport.md). ## Examples -The following sample generates C4273, and shows how to fix it. +The following example generates C4273, and shows how to fix it. ```cpp // C4273.cpp @@ -23,7 +24,7 @@ char __declspec(dllimport) c; char c; // C4273, delete this line or the line above to resolve ``` -The following sample generates C4273. To fix it, delete the redeclaration of `printf_s`. +The following example generates C4273. To fix it, delete the redeclaration of `printf_s`. ```cpp // C4273_b.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4274.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4274.md index 2588a0e4a21..6e7ea2759ce 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4274.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4274.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4274" title: "Compiler Warning (level 1) C4274" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4274" +ms.date: 11/04/2016 f1_keywords: ["C4274"] helpviewer_keywords: ["C4274"] -ms.assetid: 5a948680-7ed1-469f-978d-ae99d154e161 --- # Compiler Warning (level 1) C4274 -\#ident ignored; see documentation for #pragma comment(exestr, 'string') +> #ident ignored; see documentation for #pragma comment(exestr, 'string') + +## Remarks The `#ident` directive, which inserts a user-specified string in the object or executable file, is deprecated. Consequently, the compiler ignores the directive. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4276.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4276.md index 7e8473bae3d..cd9812fc4e8 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4276.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4276.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4276" title: "Compiler Warning (level 1) C4276" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4276" +ms.date: 11/04/2016 f1_keywords: ["C4276"] helpviewer_keywords: ["C4276"] -ms.assetid: 9d738c2d-29e5-408a-b9ff-be1a850b2238 --- # Compiler Warning (level 1) C4276 -'function' : no prototype provided; assumed no parameters +> 'function' : no prototype provided; assumed no parameters + +## Remarks When you take the address of a function with the [__stdcall](../../cpp/stdcall.md) calling convention, you must give a prototype so the compiler can create the function's decorated name. Since *function* has no prototype, the compiler, when creating the decorated name, assumes the function has no parameters. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4286.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4286.md index a83f7124352..248b4040981 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4286.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4286.md @@ -1,19 +1,22 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4286" title: "Compiler Warning (level 1) C4286" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4286" +ms.date: 11/04/2016 f1_keywords: ["C4286"] helpviewer_keywords: ["C4286"] -ms.assetid: 93eadd6c-6f36-413b-ba91-c9aa2314685a --- # Compiler Warning (level 1) C4286 -'type1' : is caught by base class ('type2') on line number +> 'type1' : is caught by base class ('type2') on line number + +## Remarks The specified exception type is handled by a previous handler. The type for the second catch is derived from the type of the first. Exceptions for a base class catch exceptions for a derived class. ## Example +The following example generates C4286: + ```cpp //C4286.cpp // compile with: /W1 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4288.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4288.md index 67b2cfa8515..5a7b2f7bc3d 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4288.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4288.md @@ -1,20 +1,23 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4288" title: "Compiler Warning (level 1) C4288" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4288" +ms.date: 11/04/2016 f1_keywords: ["C4288"] helpviewer_keywords: ["C4288"] -ms.assetid: 6aaeb139-90cd-457a-9d37-65687042736f --- # Compiler Warning (level 1) C4288 > nonstandard extension used : 'var' : loop control variable declared in the for-loop is used outside the for-loop scope; it conflicts with the declaration in the outer scope +## Remarks + When compiling with [`/Ze`](../../build/reference/za-ze-disable-language-extensions.md) and **/Zc:forscope-**, a variable declared in a **`for`** loop was used after the [for](../../cpp/for-statement-cpp.md)-loop scope. A Microsoft extension to the C++ language allows this variable to remain in scope, and C4288 reminds you that the first declaration of the variable is not used. See [`/Zc:forScope`](../../build/reference/zc-forscope-force-conformance-in-for-loop-scope.md) for information about how to specify the Microsoft extension in **`for`** loops with /Ze. -The following sample generates C4288: +## Example + +The following example generates C4288: ```cpp // C4288.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4291.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4291.md index e1e251737f2..fb8a23defbe 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4291.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4291.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4291" title: "Compiler Warning (level 1) C4291" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4291" +ms.date: 11/04/2016 f1_keywords: ["C4291"] helpviewer_keywords: ["C4291"] -ms.assetid: c2b95dea-38f2-4609-9104-707c30798da4 --- # Compiler Warning (level 1) C4291 -'declaration' : no matching operator delete found; memory will not be freed if initialization throws an exception +> 'declaration' : no matching operator delete found; memory will not be freed if initialization throws an exception + +## Remarks A placement [new](../../cpp/new-operator-cpp.md) is used for which there is no placement [delete](../../cpp/delete-operator-cpp.md). @@ -16,7 +17,11 @@ When memory is allocated for an object with operator **`new`**, the object's con If you use the operator **`new`** without any extra arguments and compile with [/GX](../../build/reference/gx-enable-exception-handling.md), [/EHs](../../build/reference/eh-exception-handling-model.md), or /EHa options to enable exception handling, the compiler will generate code to call operator **`delete`** if the constructor throws an exception. -If you use the placement form of the **`new`** operator (the form with arguments in addition to the size of the allocation) and the object's constructor throws an exception, the compiler will still generate code to call operator **`delete`**; but it will only do so if a placement form of operator **`delete`** exists matching the placement form of the operator **`new`** that allocated the memory. For example: +If you use the placement form of the **`new`** operator (the form with arguments in addition to the size of the allocation) and the object's constructor throws an exception, the compiler will still generate code to call operator **`delete`**; but it will only do so if a placement form of operator **`delete`** exists matching the placement form of the operator **`new`** that allocated the memory. + +## Example + +For example: ```cpp // C4291.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4293.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4293.md index 288d303e446..cb24eb825ba 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4293.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4293.md @@ -4,21 +4,20 @@ description: "Describes the causes of MSVC compiler warning C4293, and shows how ms.date: 07/15/2020 f1_keywords: ["C4293"] helpviewer_keywords: ["C4293"] -ms.assetid: babecd96-eb51-41a5-9835-462c7a46dbad --- # Compiler Warning (level 1) C4293 > '*operator*' : shift count negative or too big, undefined behavior -If a shift count is negative or too large, the behavior of the resulting image is undefined. - ## Remarks +If a shift count is negative or too large, the behavior of the resulting image is undefined. + To resolve this issue, you can use a cast on the first operand to expand it to the size of the result type. ## Example -The following sample generates C4293, and shows ways to fix it: +The following example generates C4293, and shows ways to fix it: ```cpp // C4293.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4297.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4297.md index c300a5b4f1d..25b6d26a536 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4297.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4297.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4297" title: "Compiler Warning (level 1) C4297" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4297" +ms.date: 11/04/2016 f1_keywords: ["C4297"] helpviewer_keywords: ["C4297"] -ms.assetid: ba92fcdc-9f70-4f60-abe6-281f9582ca59 --- # Compiler Warning (level 1) C4297 -'function' : function assumed not to throw an exception but does +> 'function' : function assumed not to throw an exception but does + +## Remarks A function declaration contains a (possibly implicit) **`noexcept`** specifier, an empty **`throw`** exception specifier, or a [__declspec(nothrow)](../../cpp/nothrow-cpp.md) attribute, and the definition contains one or more [throw](../../cpp/try-throw-and-catch-statements-cpp.md) statements. To resolve C4297, do not attempt to throw exceptions in functions that are declared `__declspec(nothrow)`, `noexcept(true)` or `throw()`. Alternatively, remove the **`noexcept`**, `throw()`, or `__declspec(nothrow)` specification. @@ -18,7 +19,9 @@ For more information on exception specifications, see [Exception Specifications This warning is also generated for __declspec([dllexport](../../cpp/dllexport-dllimport.md)) functions marked extern "C", even if they are C++ functions. -The following sample generates C4297: +## Example + +The following example generates C4297: ```cpp // C4297.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4305.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4305.md index ba2979d7c62..b34e71b9984 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4305.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4305.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: Compiler Warning (level 1 and level 2 and level 4) C4305" title: "Compiler Warning (level 1 and level 2 and level 4) C4305" -ms.date: "01/17/2018" +description: "Learn more about: Compiler Warning (level 1 and level 2 and level 4) C4305" +ms.date: 01/17/2018 f1_keywords: ["C4305"] helpviewer_keywords: ["C4305"] --- @@ -15,7 +15,7 @@ This warning is issued when a value is converted to a smaller type in an initial ## Example -This sample shows two ways you might see this warning: +This example shows two ways you might see this warning: ```cpp // C4305.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4311.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4311.md index 241e383b04a..f27b08010af 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4311.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4311.md @@ -1,19 +1,22 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4311" title: "Compiler Warning (level 1) C4311" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4311" +ms.date: 11/04/2016 f1_keywords: ["C4311"] helpviewer_keywords: ["C4311"] -ms.assetid: ddc579d0-d051-47bc-915d-71ffb32323c9 --- # Compiler Warning (level 1) C4311 -'variable' : pointer truncation from 'type' to 'type' +> 'variable' : pointer truncation from 'type' to 'type' + +## Remarks This warning detects 64-bit pointer truncation issues. For example, if code is compiled for a 64-bit architecture, the value of a pointer (64 bits) will be truncated if it is assigned to an **`int`** (32 bits). For more information, see [Rules for Using Pointers](/windows/win32/WinProg64/rules-for-using-pointers). For additional information about common causes of warning C4311, see [Common Compiler Errors](/windows/win32/WinProg64/common-compiler-errors). +## Example + The following code example generates C4311 when compiled for a 64-bit target, and then demonstrates how to fix it: ```cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4312.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4312.md index 3bb9426aab6..4cbe2bf10b6 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4312.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4312.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4312" title: "Compiler Warning (level 1) C4312" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4312" +ms.date: 11/04/2016 f1_keywords: ["C4312"] helpviewer_keywords: ["C4312"] -ms.assetid: 541906ed-4f62-4bcb-947f-cf9ae7411bcb --- # Compiler Warning (level 1) C4312 -'operation' : conversion from 'type1' to 'type2' of greater size +> 'operation' : conversion from 'type1' to 'type2' of greater size + +## Remarks This warning detects an attempt to assign a 32-bit value to a 64-bit pointer type, for example, casting a 32-bit **`int`** or **`long`** to a 64-bit pointer. @@ -16,6 +17,8 @@ This can be an unsafe conversion even for pointer values that fit in 32 bits whe This warning is only issued for 64-bit compilation targets. For more information, see [Rules for Using Pointers](/windows/win32/WinProg64/rules-for-using-pointers). +## Example + The following code example generates C4312 when it is compiled for 64-bit targets: ```cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4313.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4313.md index 44d7f2e2556..64050afef86 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4313.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4313.md @@ -1,20 +1,21 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4313" title: "Compiler Warning (level 1) C4313" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4313" +ms.date: 11/04/2016 f1_keywords: ["C4313"] helpviewer_keywords: ["C4313"] -ms.assetid: bcf64191-e2cf-452e-97b4-423fcec2d07c --- # Compiler Warning (level 1) C4313 -'function' : 'format specifier' in format string conflicts with argument number of type 'type' +> 'function' : 'format specifier' in format string conflicts with argument number of type 'type' + +## Remarks There is a conflict between the format specified and the value that you are passing. For example, you passed a 64-bit parameter to an unqualified %d format specifier, which expects a 32-bit integer parameter. This warning is only in effect when the code is compiled for 64-bit targets. ## Example -The following code sample generates C4313 when it is compiled for a 64-bit target. +The following code example generates C4313 when it is compiled for a 64-bit target. ```cpp // C4313.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4319.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4319.md index af4e194b373..486da6781bd 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4319.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4319.md @@ -1,15 +1,16 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4319" title: "Compiler Warning (level 1) C4319" -ms.date: "01/18/2018" +description: "Learn more about: Compiler Warning (level 1) C4319" +ms.date: 01/18/2018 f1_keywords: ["C4319"] helpviewer_keywords: ["C4319"] -ms.assetid: 1fac8048-9bd6-4552-a21c-192c67772bb9 --- # Compiler Warning (level 1) C4319 > '~' : zero extending '*type1*' to '*type2*' of greater size +## Remarks + The result of the **~** (bitwise complement) operator is unsigned and then zero-extended when it is converted to a larger type. ## Example diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4325.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4325.md index bb1233d0d72..7ac44c2fca2 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4325.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4325.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4325" title: "Compiler Warning (level 1) C4325" -ms.date: "08/27/2018" +description: "Learn more about: Compiler Warning (level 1) C4325" +ms.date: 08/27/2018 f1_keywords: ["C4325"] helpviewer_keywords: ["C4325"] -ms.assetid: 8127a08c-d626-481b-aa7b-04a3fdc9a9ec --- # Compiler Warning (level 1) C4325 @@ -12,7 +11,11 @@ ms.assetid: 8127a08c-d626-481b-aa7b-04a3fdc9a9ec ## Remarks -You may not change the attributes of a standard section. For example: +You may not change the attributes of a standard section. + +## Example + +For example: ```cpp #pragma section(".sdata", long) diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4326.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4326.md index 4cad0b88a46..53d3f74109a 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4326.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4326.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4326" title: "Compiler Warning (level 1) C4326" -ms.date: "08/27/2018" +description: "Learn more about: Compiler Warning (level 1) C4326" +ms.date: 08/27/2018 f1_keywords: ["C4326"] helpviewer_keywords: ["C4326"] -ms.assetid: d44d2c4e-9456-42d3-b35b-4ba4b2d42ec7 --- # Compiler Warning (level 1) C4326 @@ -16,7 +15,7 @@ A function returned a type other than *type1*. For example, using [/Za](../../bu ## Example -The following sample generates C4326 and shows how to fix it: +The following example generates C4326 and shows how to fix it: ```cpp // C4326.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4329.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4329.md index 2922e2c6250..63d963b4898 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4329.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4329.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4329" title: "Compiler Warning (level 1) C4329" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4329" +ms.date: 11/04/2016 f1_keywords: ["C4329"] helpviewer_keywords: ["C4329"] --- @@ -9,7 +9,13 @@ helpviewer_keywords: ["C4329"] > alignment specifier is ignored on enum -Use of the alignment specifiers on `enum` isn't allowed. This pattern includes the use of the [`align`](../../cpp/align-cpp.md) [`__declspec`](../../cpp/declspec.md) modifier. The following sample generates C4329: +## Remarks + +Use of the alignment specifiers on `enum` isn't allowed. This pattern includes the use of the [`align`](../../cpp/align-cpp.md) [`__declspec`](../../cpp/declspec.md) modifier. + +## Example + +The following example generates C4329: ```cpp // C4329.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4333.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4333.md index 972196b570d..7f2ed906c9a 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4333.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4333.md @@ -1,20 +1,21 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4333" title: "Compiler Warning (level 1) C4333" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4333" +ms.date: 11/04/2016 f1_keywords: ["C4333"] helpviewer_keywords: ["C4333"] -ms.assetid: d3763c52-6110-4da0-84db-5264e3f3f166 --- # Compiler Warning (level 1) C4333 -'operator' : right shift by too large amount, data loss +> 'operator' : right shift by too large amount, data loss + +## Remarks A right shift operation was too large an amount. All significant bits are shifted out and the result will always be zero. ## Example -The following sample generates C4333. +The following example generates C4333. ```cpp // C4333.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4340.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4340.md index 58981026e43..004d0d3c45f 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4340.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4340.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4340" title: "Compiler Warning (level 1) C4340" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4340" +ms.date: 11/04/2016 f1_keywords: ["C4340"] helpviewer_keywords: ["C4340"] -ms.assetid: ddd5344b-5167-4c55-a318-20615052fd54 --- # Compiler Warning (level 1) C4340 -'value' : value wrapped from positive to negative value +> 'value' : value wrapped from positive to negative value + +## Remarks The **`enum`** value is greater than the largest **`enum`** positive value wrapped around to a negative value. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4342.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4342.md index b16363c5117..63ce40a82f9 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4342.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4342.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4342" title: "Compiler Warning (level 1) C4342" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4342" +ms.date: 11/04/2016 f1_keywords: ["C4342"] helpviewer_keywords: ["C4342"] -ms.assetid: 47d4d5ab-069f-4cdc-98c3-10d649577a37 --- # Compiler Warning (level 1) C4342 -behavior change: '*function*' called, but a member operator was called in previous versions +> behavior change: '*function*' called, but a member operator was called in previous versions + +## Remarks In versions of Visual C++ before Visual Studio 2002, a member was called, but this behavior has been changed and the compiler now finds the best match in namespace scope. @@ -18,7 +19,9 @@ This warning should be disabled after you successfully port your code to the cur This warning is off by default. For more information, see [Compiler Warnings That Are Off by Default](../../preprocessor/compiler-warnings-that-are-off-by-default.md). -The following sample generates C4342: +## Example + +The following example generates C4342: ```cpp // C4342.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4344.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4344.md index 24e2d0b749f..49eccaec8b4 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4344.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4344.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4344" title: "Compiler Warning (level 1) C4344" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4344" +ms.date: 11/04/2016 f1_keywords: ["C4344"] helpviewer_keywords: ["C4344"] -ms.assetid: cd20859d-f07f-4c70-904b-cb756a53b1ed --- # Compiler Warning (level 1) C4344 -behavior change: use of explicit template arguments results in call to 'function' +> behavior change: use of explicit template arguments results in call to 'function' + +## Remarks A call to a function using explicit template arguments calls a different function than it would if explicit arguments had not been specified diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4346.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4346.md index a508a599219..568ad7cd845 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4346.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4346.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4346" title: "Compiler Warning (level 1) C4346" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4346" +ms.date: 11/04/2016 f1_keywords: ["C4346"] helpviewer_keywords: ["C4346"] -ms.assetid: 68ee562d-cca9-4a2a-9a1b-14ad1a1e7396 --- # Compiler Warning (level 1) C4346 -'name' : dependent name is not a type +> 'name' : dependent name is not a type + +## Remarks The [typename](../../cpp/typename.md) keyword is required if a dependent name is to be treated as a type. For code that works the same in all versions of Visual C++, add **`typename`** to the declaration. -The following sample generates C4346: +## Examples + +The following example generates C4346: ```cpp // C4346.cpp @@ -25,7 +28,7 @@ struct C { }; ``` -The following samples shows other examples where the **`typename`** keyword is required: +The following shows other examples where the **`typename`** keyword is required: ```cpp // C4346b.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4348.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4348.md index 9a691ded0a2..e123b095dc9 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4348.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4348.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4348" title: "Compiler Warning (level 1) C4348" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4348" +ms.date: 11/04/2016 f1_keywords: ["C4348"] helpviewer_keywords: ["C4348"] -ms.assetid: 816010eb-6079-48d5-a41b-0fc4d67cfe4c --- # Compiler Warning (level 1) C4348 -'type' : redefinition of default parameter : parameter number +> 'type' : redefinition of default parameter : parameter number + +## Remarks A template parameter was redefined. -The following sample generates C4348: +## Example + +The following example generates C4348: ```cpp // C4348.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4350.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4350.md index 99f15243ebb..04e98691df3 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4350.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4350.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4350" title: "Compiler Warning (level 1) C4350" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4350" +ms.date: 11/04/2016 f1_keywords: ["C4350"] helpviewer_keywords: ["C4350"] -ms.assetid: 4cc8ed67-64c4-4da5-a7a5-a639232baa23 --- # Compiler Warning (level 1) C4350 -behavior change: 'member1' called instead of 'member2' +> behavior change: 'member1' called instead of 'member2' + +## Remarks An rvalue cannot be bound to a non-const reference. In versions of Visual C++ before Visual Studio 2003, it was possible to bind an rvalue to a non-const reference in a direct initialization. This code now gives a warning. @@ -20,7 +21,9 @@ If you get this warning, examine your code to see if it depends on binding rvalu This warning is off by default. For more information, see [Compiler Warnings That Are Off by Default](../../preprocessor/compiler-warnings-that-are-off-by-default.md). -The following sample generates C4350: +## Example + +The following example generates C4350: ```cpp // C4350.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4353.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4353.md index afade9f92fb..ced2c8a0687 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4353.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4353.md @@ -1,23 +1,26 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4353" title: "Compiler Warning (level 1) C4353" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4353" +ms.date: 11/04/2016 f1_keywords: ["C4353"] helpviewer_keywords: ["C4353"] -ms.assetid: 6e79f186-ed82-4c95-9923-0ad5bb9c4db1 --- # Compiler Warning (level 1) C4353 -nonstandard extension used: constant 0 as function expression. Use '__noop' function intrinsic instead +> nonstandard extension used: constant 0 as function expression. Use '__noop' function intrinsic instead + +## Remarks You cannot use the constant zero (0) as a function expression. For more information, see [__noop](../../intrinsics/noop.md). -The following sample generates C4353: +## Example + +The following example generates C4353: ```cpp // C4353.cpp // compile with: /W1 -void MyPrintf(void){}; +void MyPrintf(void){} #define X 0 #if X #define DBPRINT MyPrint diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4358.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4358.md index 02e7ffc810f..4c4832aa51b 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4358.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4358.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4358" title: "Compiler Warning (level 1) C4358" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4358" +ms.date: 11/04/2016 f1_keywords: ["C4358"] helpviewer_keywords: ["C4358"] -ms.assetid: a9848f84-14b3-405e-81bf-ee3e91a51511 --- # Compiler Warning (level 1) C4358 -'operator': return type of combined delegates is not 'void'; returned value is undefined +> 'operator': return type of combined delegates is not 'void'; returned value is undefined + +## Remarks Two delegates were combined and the return value is not void. If two delegates with non-void return values are combined, the compiler will not be able to do a proper assignment if the return value of the delegate is used. -The following sample generates C4358: +## Example + +The following example generates C4358: ```cpp // C4358.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4364.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4364.md index 3b84470325b..43cd2ffc11f 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4364.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4364.md @@ -1,22 +1,23 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4364" title: "Compiler Warning (level 1) C4364" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4364" +ms.date: 11/04/2016 f1_keywords: ["C4364"] helpviewer_keywords: ["C4364"] -ms.assetid: 1477634c-d60f-4570-ad16-1aaeae24ac7f --- # Compiler Warning (level 1) C4364 -\#using for assembly 'file' previously seen at location(line_number) without as_friend attribute; as_friend not applied +> #using for assembly 'file' previously seen at location(line_number) without as_friend attribute; as_friend not applied + +## Remarks A `#using` directive was repeated for a given metadata file, but the **`as_friend`** qualifier was not used in the first occurrence; the compiler will ignore the second **`as_friend`**. For more information, see [Friend Assemblies (C++)](../../dotnet/friend-assemblies-cpp.md). -## Examples +## Example -The following sample creates a component. +The following example creates a component. ```cpp // C4364.cpp @@ -24,7 +25,7 @@ The following sample creates a component. ref class A {}; ``` -The following sample generates C4364. +The following example generates C4364. ```cpp // C4364_b.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4369.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4369.md index d3d741d7755..23fc40ea41b 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4369.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4369.md @@ -1,20 +1,21 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4369" title: "Compiler Warning (level 1) C4369" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4369" +ms.date: 11/04/2016 f1_keywords: ["C4369"] helpviewer_keywords: ["C4369"] -ms.assetid: ade87e84-36be-4e00-be99-2930af848feb --- # Compiler Warning (level 1) C4369 -'enumerator' : enumerator value 'value' cannot be represented as 'type', value is 'new_value' +> 'enumerator' : enumerator value 'value' cannot be represented as 'type', value is 'new_value' + +## Remarks An enumerator was calculated to be greater than the greatest value for the specified underlying type. This caused an overflow and the compiler wrapped the enumerator value to the lowest possible value for the type. ## Example -The following sample generates C4369. +The following example generates C4369. ```cpp // C4369.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4374.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4374.md index 836a46f41a8..4341cfc2032 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4374.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4374.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4374" title: "Compiler Warning (level 1) C4374" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4374" +ms.date: 11/04/2016 f1_keywords: ["C4374"] helpviewer_keywords: ["C4374"] -ms.assetid: 4ac9aaec-d815-4b6e-825f-fa872092dd3b --- # Compiler Warning (level 1) C4374 -'function1': interface method will not be implemented by non-virtual method 'function2' +> 'function1': interface method will not be implemented by non-virtual method 'function2' + +## Remarks The compiler expected to find the [virtual](../../cpp/virtual-specifier.md) keyword on a method definition. -The following sample generates C4374: +## Example + +The following example generates C4374: ```cpp // C4374.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4375.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4375.md index ccd68495cc6..33fe16a7dfc 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4375.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4375.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4375" title: "Compiler Warning (level 1) C4375" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4375" +ms.date: 11/04/2016 f1_keywords: ["C4375"] helpviewer_keywords: ["C4375"] -ms.assetid: a19821b5-e9b6-4228-abe7-d812507d6a2a --- # Compiler Warning (level 1) C4375 -non-public method 'method2' does not override 'method1' +> non-public method 'method2' does not override 'method1' + +## Remarks A type that implements another type defined an override method, but the override was not public. Therefore, the method does not override the base type method. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4376.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4376.md index fd0d5d27dde..ad88d8b6893 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4376.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4376.md @@ -1,20 +1,21 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4376" title: "Compiler Warning (level 1) C4376" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4376" +ms.date: 11/04/2016 f1_keywords: ["C4376"] helpviewer_keywords: ["C4376"] -ms.assetid: 5f202c74-9489-48fe-b36f-19cd882b1589 --- # Compiler Warning (level 1) C4376 -access specifier 'old_specifier:' is no longer supported: please use 'new_specifier:' instead +> access specifier 'old_specifier:' is no longer supported: please use 'new_specifier:' instead + +## Remarks For more information on specifying type and member accessibility in metadata, see [Type visibility](../../dotnet/how-to-define-and-consume-classes-and-structs-cpp-cli.md#BKMK_Type_visibility) and [Member visibility](../../dotnet/how-to-define-and-consume-classes-and-structs-cpp-cli.md#BKMK_Member_visibility) in [How to: Define and Consume Classes and Structs (C++/CLI)](../../dotnet/how-to-define-and-consume-classes-and-structs-cpp-cli.md). ## Example -The following sample generates C4376. +The following example generates C4376. ```cpp // C4376.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4377.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4377.md index 2c5b708fa07..1c326f787a2 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4377.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4377.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4377" title: "Compiler Warning (level 1) C4377" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4377" +ms.date: 11/04/2016 f1_keywords: ["C4377"] helpviewer_keywords: ["C4377"] -ms.assetid: a1c797b8-cd5e-4a56-b430-d07932e811cf --- # Compiler Warning (level 1) C4377 -native types are private by default; -d1PrivateNativeTypes is deprecated +> native types are private by default; -d1PrivateNativeTypes is deprecated + +## Remarks In previous releases, native types in assemblies were public by default, and an internal, undocumented compiler option (**/d1PrivateNativeTypes**) was used to make them private. @@ -16,7 +17,7 @@ All types, native and CLR, are now private by default in an assembly, so **/d1Pr ## Example -The following sample generates C4377. +The following example generates C4377. ```cpp // C4377.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4378.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4378.md index d46842152e7..2573597b3fc 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4378.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4378.md @@ -1,20 +1,21 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4378" title: "Compiler Warning (level 1) C4378" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4378" +ms.date: 11/04/2016 f1_keywords: ["C4378"] helpviewer_keywords: ["C4378"] -ms.assetid: d08e11ef-891a-4752-9a5e-360e7394acf7 --- # Compiler Warning (level 1) C4378 -Must obtain function pointers to run initializers; consider System::ModuleHandle::ResolveMethodHandle +> Must obtain function pointers to run initializers; consider System::ModuleHandle::ResolveMethodHandle + +## Remarks Under **/clr**, initializer symbols contain function tokens, not functions pointers. You need to convert tokens to pointers using . -## Examples +## Example -The following sample generates C4378. +The following example generates C4378. ```cpp // C4378.cpp @@ -56,7 +57,7 @@ int main () { } ``` -The following sample shows how to resolve C4378. +The following example shows how to resolve C4378. ```cpp // C4378_b.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4379.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4379.md index 8f56e1419a0..9ed0d1e208b 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4379.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4379.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4379" title: "Compiler Warning (level 1) C4379" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4379" +ms.date: 11/04/2016 f1_keywords: ["C4379"] helpviewer_keywords: ["C4379"] -ms.assetid: b23e8132-69aa-4649-9c1e-09813b9fb5b7 --- # Compiler Warning (level 1) C4379 -Version version of the common language runtime is not supported by this compiler. Using this version may cause unexpected results. +> Version version of the common language runtime is not supported by this compiler. Using this version may cause unexpected results. + +## Remarks You have a previous version of the common language runtime on your machine, but not the current version. To resolve C4379, install the version of the common language runtime that shipped with your compiler. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4381.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4381.md index 29e6cc6ddcc..40eb33d0d75 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4381.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4381.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4381" title: "Compiler Warning (level 1) C4381" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4381" +ms.date: 11/04/2016 f1_keywords: ["C4381"] helpviewer_keywords: ["C4381"] -ms.assetid: f67a6db3-b334-4b2e-8182-b30c7a3c7c32 --- # Compiler Warning (level 1) C4381 -'function1': interface method will not be implemented by non-public method 'function2' +> 'function1': interface method will not be implemented by non-public method 'function2' + +## Remarks A class must implement all function in an interface. A class can satisfy this condition if one of its base classes implements the function. However, the function must be implemented as a public function. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4382.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4382.md index a0ba7993101..18d02708b01 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4382.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4382.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4382" title: "Compiler Warning (level 1) C4382" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4382" +ms.date: 11/04/2016 f1_keywords: ["C4382"] helpviewer_keywords: ["C4382"] -ms.assetid: 34be9ad3-bae6-411a-8f80-0c8fd0d2c092 --- # Compiler Warning (level 1) C4382 @@ -22,7 +21,7 @@ For more information, see [/clr (Common Language Runtime Compilation)](../../bui ## Example -The following sample generates C4382. +The following example generates C4382. ```cpp // C4382.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4383.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4383.md index bd6efac7c97..77526a9e69a 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4383.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4383.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4383" title: "Compiler Warning (level 1) C4383" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4383" +ms.date: 11/04/2016 f1_keywords: ["C4383"] helpviewer_keywords: ["C4383"] -ms.assetid: 96c0e52d-874e-4b57-a154-0e49b6a00fae --- # Compiler Warning (level 1) C4383 -'instance_dereference_operator' : the meaning of dereferencing a handle can change, when a user-defined 'operator' operator exists; write the operator as a static function to be explicit about the operand +> 'instance_dereference_operator' : the meaning of dereferencing a handle can change, when a user-defined 'operator' operator exists; write the operator as a static function to be explicit about the operand + +## Remarks When you add a user-defined instance override of the dereference operator in a managed type, you potentially override the ability of the type's dereference operator to return the handle's object. Consider writing a static, user-defined dereference operator. @@ -18,7 +19,7 @@ Also, an instance operator is not available to other language compilers via refe ## Example -The following sample generates C4383. +The following example generates C4383. ```cpp // C4383.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4384.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4384.md index ee4ea781781..bc7bcf67f1e 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4384.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4384.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4384" title: "Compiler Warning (level 1) C4384" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4384" +ms.date: 11/04/2016 f1_keywords: ["C4384"] helpviewer_keywords: ["C4384"] --- @@ -9,6 +9,8 @@ helpviewer_keywords: ["C4384"] > `#pragma` '*pragma_name*' should only be used at global scope +## Remarks + A `pragma` directive that must be applied at a global scope, was found in a different scope. The warning applies to the following `pragma` directives: @@ -18,7 +20,7 @@ The warning applies to the following `pragma` directives: ## Example -The following sample generates C4384. +The following example generates C4384. ```cpp // C4384.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4391.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4391.md index be45ba9d293..fd71f025e23 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4391.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4391.md @@ -1,20 +1,23 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4391" title: "Compiler Warning (level 1) C4391" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4391" +ms.date: 11/04/2016 f1_keywords: ["C4391"] helpviewer_keywords: ["C4391"] -ms.assetid: 95c6182c-fae9-4174-8f7b-98aa352e68ca --- # Compiler Warning (level 1) C4391 -'signature' : incorrect return type for intrinsic function, expected 'type' +> 'signature' : incorrect return type for intrinsic function, expected 'type' + +## Remarks A function declaration for a compiler intrinsic had the wrong return type. The resulting image may not run correctly. To fix this warning, either correct the declaration or delete the declaration and simply #include the appropriate header file. -The following sample generates C4391: +## Example + +The following example generates C4391: ```cpp // C4391.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4392.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4392.md index 79d7ebd0205..01aadb254d1 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4392.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4392.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: Compiler Warning (level 1, Error) C4392" title: "Compiler Warning (level 1, Error) C4392" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1, Error) C4392" +ms.date: 11/04/2016 f1_keywords: ["C4392"] helpviewer_keywords: ["C4392"] --- @@ -9,11 +9,15 @@ helpviewer_keywords: ["C4392"] > 'signature' : incorrect number of arguments for intrinsic function, expected 'number' arguments +## Remarks + A function declaration for a compiler intrinsic had the wrong number of arguments. The resulting image may not run correctly. To fix this warning, either correct the declaration or delete the declaration and `#include` the appropriate header file. This warning is always issued as an error. Use the [warning](../../preprocessor/warning.md) pragma to disable or change the warning level. -The following sample generates C4392: +## Example + +The following example generates C4392: ```cpp // C4392.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4393.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4393.md index 2e0d6b6e8e9..82cf3e5048c 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4393.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4393.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4393" title: "Compiler Warning (level 1) C4393" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4393" +ms.date: 11/04/2016 f1_keywords: ["C4393"] helpviewer_keywords: ["C4393"] -ms.assetid: 353a0539-d1ea-4c1b-8849-c9b321ec9842 --- # Compiler Warning (level 1) C4393 -'var' : const has no effect on literal data member; ignored +> 'var' : const has no effect on literal data member; ignored + +## Remarks A [literal](../../extensions/literal-cpp-component-extensions.md) data member was also specified as const. Since a literal data member implies const, you do not need to add const to the declaration. -The following sample generates C4393: +## Example + +The following example generates C4393: ```cpp // C4393.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4395.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4395.md index 98523b30ba7..eb6c4a27418 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4395.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4395.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4395" title: "Compiler Warning (level 1) C4395" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4395" +ms.date: 11/04/2016 f1_keywords: ["C4395"] helpviewer_keywords: ["C4395"] -ms.assetid: 8051469a-3a39-4677-80f7-1300fbffe8ea --- # Compiler Warning (level 1) C4395 -'function' : member function will be invoked on a copy of the initonly data member 'member' +> 'function' : member function will be invoked on a copy of the initonly data member 'member' + +## Remarks A member function was called on an [initonly (C++/CLI)](../../dotnet/initonly-cpp-cli.md) data member. C4395 warns that the **initonly** data member cannot be modified by the function. -The following sample generates C4395: +## Example + +The following example generates C4395: ```cpp // C4395.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4397.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4397.md index f957af30e6f..2e639136c27 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4397.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4397.md @@ -1,20 +1,21 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4397" title: "Compiler Warning (level 1) C4397" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4397" +ms.date: 11/04/2016 f1_keywords: ["C4397"] helpviewer_keywords: ["C4397"] -ms.assetid: 6346fdc2-dbbf-4fba-803a-32b0d0a707be --- # Compiler Warning (level 1) C4397 -DefaultCharSetAttribute is ignored +> DefaultCharSetAttribute is ignored + +## Remarks is ignored by the Microsoft C++ compiler. To specify a character set for the DLL, use the CharSet option of DllImport. For more information, see [Using C++ Interop (Implicit PInvoke)](../../dotnet/using-cpp-interop-implicit-pinvoke.md). ## Example -The following sample generates C4397. +The following example generates C4397. ```cpp // C4397.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4399.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4399.md index 39947ec8180..b3d523f9ed6 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4399.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4399.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1, Error) C4399" title: "Compiler Warning (level 1, Error) C4399" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1, Error) C4399" +ms.date: 11/04/2016 f1_keywords: ["C4399"] helpviewer_keywords: ["C4399"] -ms.assetid: f58d9ba7-71a0-4c3b-b26f-f946dda8af30 --- # Compiler Warning (level 1, Error) C4399 @@ -20,7 +19,7 @@ This warning can be issued as an error. Use the [warning](../../preprocessor/war ## Example -The following sample generates C4399. +The following example generates C4399. ```cpp // C4399.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4401.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4401.md index 8bc6447524d..0e77fd61c51 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4401.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4401.md @@ -1,18 +1,23 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4401" title: "Compiler Warning (level 1) C4401" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4401" +ms.date: 11/04/2016 f1_keywords: ["C4401"] helpviewer_keywords: ["C4401"] -ms.assetid: 2e7ca136-f144-4b40-b847-82976e8643fc --- # Compiler Warning (level 1) C4401 -'bitfield' : member is bit field +> 'bitfield' : member is bit field + +## Remarks Inline assembly code tries to access a bit-field member. Inline assembly cannot access bit-field members, so the last packing boundary before the bit-field member is used. -To avoid this warning, cast the bit field to an appropriate type before making the reference in inline assembly code. The following sample generates C4401: +To avoid this warning, cast the bit field to an appropriate type before making the reference in inline assembly code. + +## Example + +The following example generates C4401: ```cpp // C4401.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4402.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4402.md index 564054771a1..986cfddad83 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4402.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4402.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4402" title: "Compiler Warning (level 1) C4402" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4402" +ms.date: 11/04/2016 f1_keywords: ["C4402"] helpviewer_keywords: ["C4402"] -ms.assetid: 2aaecfae-1e79-4787-87e8-0973f7ec0efe --- # Compiler Warning (level 1) C4402 -must use PTR operator +> must use PTR operator + +## Remarks A type is used on an operand without a PTR operator when referring to or casting to a type in inline assembly code. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4403.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4403.md index 1d3e599dcba..afb02f7bd0b 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4403.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4403.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4403" title: "Compiler Warning (level 1) C4403" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4403" +ms.date: 11/04/2016 f1_keywords: ["C4403"] helpviewer_keywords: ["C4403"] -ms.assetid: d95597c9-4762-4f33-86e4-1d98f0e80d52 --- # Compiler Warning (level 1) C4403 -illegal PTR operator +> illegal PTR operator + +## Remarks A PTR operator is used inappropriately in inline assembler code. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4405.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4405.md index b2ad983ac70..92efb9f9abd 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4405.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4405.md @@ -1,16 +1,21 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4405" title: "Compiler Warning (level 1) C4405" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4405" +ms.date: 11/04/2016 f1_keywords: ["C4405"] helpviewer_keywords: ["C4405"] -ms.assetid: 155c64d6-58ae-4455-b61f-ccd711c5da96 --- # Compiler Warning (level 1) C4405 -'identifier' : identifier is reserved word +> 'identifier' : identifier is reserved word + +## Remarks + +A word reserved for inline assembly is used as a variable name. This may cause unpredictable results. To fix this warning, avoid naming variables with words reserved for inline assembly. + +## Example -A word reserved for inline assembly is used as a variable name. This may cause unpredictable results. To fix this warning, avoid naming variables with words reserved for inline assembly. The following sample generates C4405: +The following example generates C4405: ```cpp // C4405.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4406.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4406.md index 56566edc0fe..e600ed36ea4 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4406.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4406.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4406" title: "Compiler Warning (level 1) C4406" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4406" +ms.date: 11/04/2016 f1_keywords: ["C4406"] helpviewer_keywords: ["C4406"] -ms.assetid: a3204731-2285-401c-b73b-af98586a86fa --- # Compiler Warning (level 1) C4406 -operand on directive ignored +> operand on directive ignored + +## Remarks The directive does not take any operands, but an operand was specified. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4407.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4407.md index c206a7b8cda..88b9df38c30 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4407.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4407.md @@ -1,6 +1,6 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4407" title: "Compiler Warning (level 1) C4407" +description: "Learn more about: Compiler Warning (level 1) C4407" ms.date: 04/13/2021 f1_keywords: ["C4407"] helpviewer_keywords: ["C4407"] @@ -9,17 +9,17 @@ helpviewer_keywords: ["C4407"] > cast between different pointer to member representations, compiler may generate incorrect code -An incorrect cast between pointer-to-member types was detected. - ## Remarks +An incorrect cast between pointer-to-member types was detected. + C4407 can be generated because of compiler conformance work that was done in Visual Studio 2005. Pointer-to-member now requires a qualified name and the address-of operator (&). C4407 can occur if you cast between a multiple inheritance pointer-to-member to a single inheritance pointer-to-member. Sometimes this can work, but sometimes it can't because the single inheritance pointer-to-member representation doesn't hold sufficient information. Compiling with the **`/vmm`** might help. For more information, see [`/vmm`, `/vms`, `/vmv` (General purpose representation)](../../build/reference/vmm-vms-vmv-general-purpose-representation.md). You can also try rearranging your base classes; the compiler is detecting a loss of information in the conversion because a base class is at a non-zero offset from the derived. ## Example -The following sample generates C4407 and shows how to fix it: +The following example generates C4407 and shows how to fix it: ```cpp // C4407.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4409.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4409.md index 66f2c9b2a9e..6f4a121e0bc 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4409.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4409.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4409" title: "Compiler Warning (level 1) C4409" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4409" +ms.date: 11/04/2016 f1_keywords: ["C4409"] helpviewer_keywords: ["C4409"] -ms.assetid: 2be63c86-d9c9-4073-ab71-e654dd9f450f --- # Compiler Warning (level 1) C4409 -illegal instruction size +> illegal instruction size + +## Remarks The instruction did not have a form with the specified size. The smallest legal size was used. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4410.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4410.md index 99784780d9a..391e7ca2304 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4410.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4410.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4410" title: "Compiler Warning (level 1) C4410" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4410" +ms.date: 11/04/2016 f1_keywords: ["C4410"] helpviewer_keywords: ["C4410"] -ms.assetid: 7dcdb720-118a-4823-ba73-575f6ad79a71 --- # Compiler Warning (level 1) C4410 -illegal size for operand +> illegal size for operand + +## Remarks One of the operands on the instruction had an incorrect size. The smallest legal size for the operand was used. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4411.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4411.md index 3170200a5f5..04ee68c961b 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4411.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4411.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4411" title: "Compiler Warning (level 1) C4411" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4411" +ms.date: 11/04/2016 f1_keywords: ["C4411"] helpviewer_keywords: ["C4411"] -ms.assetid: d209452c-83bd-4333-8d0b-759ca9b4864e --- # Compiler Warning (level 1) C4411 -'identifier' : symbol resolves to displacement register +> 'identifier' : symbol resolves to displacement register + +## Remarks The identifier is a local symbol that resolves to a displacement register and therefore may be used on an operand with another symbol. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4420.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4420.md index e506c3e258f..912f91fef5e 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4420.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4420.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4420" title: "Compiler Warning (level 1) C4420" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4420" +ms.date: 11/04/2016 f1_keywords: ["C4420"] helpviewer_keywords: ["C4420"] -ms.assetid: 44a37754-7ddd-4764-a5f7-d33e05c20091 --- # Compiler Warning (level 1) C4420 -'operator' : operator not available, using 'operator' instead; run-time checking may be compromised +> 'operator' : operator not available, using 'operator' instead; run-time checking may be compromised + +## Remarks This warning is generated when you use the [/RTCv](../../build/reference/rtc-run-time-error-checks.md) (vector new/delete checking) and when no vector form is found. In this case, the non-vector form is used. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4436.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4436.md index 2e6e126eadc..e2565cf0115 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4436.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4436.md @@ -1,35 +1,33 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4436" -title: "Compiler Warning (level 1) C4436" -ms.date: "11/04/2016" +title: "Compiler warning (level 1 and level 4) C4436" +description: "Learn more about: Compiler Warning (level 1 and level 4) C4436" +ms.date: 1/22/2025 f1_keywords: ["C4436"] helpviewer_keywords: ["C4436"] -ms.assetid: 2b54a1fc-c9c6-4cc9-90be-faa44fc715d5 --- -# Compiler Warning (level 1) C4436 +# Compiler warning (level 1) C4436 -dynamic_cast from virtual base 'class1' to 'class2' in constructor or destructor could fail with partially-constructed object Compile with /vd2 or define 'class2' with #pragma vtordisp(2) in effect +> `dynamic_cast` from virtual base '*base_class*' to '*derived_class*' in constructor or destructor could fail with partially-constructed object -The compiler has encountered a **`dynamic_cast`** operation with the following characteristics. +## Remarks -- The cast is from a base class pointer to a derived class pointer. +A `dynamic_cast` operation is used when: +- The cast is from a base class pointer to a derived class pointer. - The derived class virtually inherits the base class. +- The derived class doesn't have a `vtordisp` field for the virtual base. +- The cast is found in a constructor or destructor of the derived class, or a class that inherits from the derived class. -- The derived class does not have a `vtordisp` field for the virtual base. - -- The cast is found in a constructor or destructor of the derived class, or some class which further inherits from the derived class. - -The warning indicates the **`dynamic_cast`** might not perform correctly, if it is operating on a partially-constructed object. That happens if the derived constructor/destructor is operating on a sub-object of some further derived object. If the derived class named in the warning is never further derived, the warning can be ignored. +This warning indicates that the `dynamic_cast` might not perform correctly if it is applied to a partially constructed object. Which happens if the derived constructor/destructor is operating on a subobject of some further derived object. If the derived class named in the warning isn't further derived, you can ignore the warning. ## Example -The following sample generates C4436 and demonstrates the code generation issue that arises from the missing `vtordisp` field. +The following example generates C4436 and demonstrates the code generation issue due to the missing `vtordisp` field: ```cpp // C4436.cpp // To see the warning and runtime assert, compile with: /W1 -// To eliminate the warning and assert, compile with: /W1 /vd2 +// To eliminate the warning and assert, compile with: /W1 /vd2 // or compile with: /W1 /DFIX #include @@ -48,7 +46,7 @@ struct B : virtual A { A* a = static_cast(this); B* b = dynamic_cast(a); // C4436 - assert(this == b); // assert unless compiled with /vd2 + assert(this == b); // asserts unless compiled with /vd2 } }; #if defined(FIX) @@ -68,6 +66,6 @@ int main() ## See also -[dynamic_cast Operator](../../cpp/dynamic-cast-operator.md)
-[vtordisp](../../preprocessor/vtordisp.md)
-[Compiler Warning (level 4) C4437](../../error-messages/compiler-warnings/compiler-warning-level-4-c4437.md) +[`dynamic_cast` Operator](../../cpp/dynamic-cast-operator.md)\ +[`vtordisp`](../../preprocessor/vtordisp.md)\ +[Compiler Warning (level 1 and level 4, off) C4437](compiler-warning-level-4-c4437.md) diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4440.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4440.md index a85bcc3b98c..27027d44236 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4440.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4440.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4440" title: "Compiler Warning (level 1) C4440" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4440" +ms.date: 11/04/2016 f1_keywords: ["C4440"] helpviewer_keywords: ["C4440"] -ms.assetid: 78b9642a-a93e-401e-9d92-372f6451bc5d --- # Compiler Warning (level 1) C4440 -calling convention redefinition from 'calling_convention1' to 'calling_convention2' ignored +> calling convention redefinition from 'calling_convention1' to 'calling_convention2' ignored + +## Remarks An attempt to change the calling convention was ignored. -The following sample generates C4440: +## Example + +The following example generates C4440: ```cpp // C4440.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4441.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4441.md index be07663a0d2..d4c727635c3 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4441.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4441.md @@ -1,20 +1,21 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4441" title: "Compiler Warning (level 1) C4441" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4441" +ms.date: 11/04/2016 f1_keywords: ["C4441"] helpviewer_keywords: ["C4441"] -ms.assetid: 7fc540a5-e41f-47cf-aa37-b2b699c2685e --- # Compiler Warning (level 1) C4441 -calling convention of 'cc1' ignored; 'cc2' used instead +> calling convention of 'cc1' ignored; 'cc2' used instead + +## Remarks Member functions in managed user-defined types and global function generics must use the [__clrcall](../../cpp/clrcall.md) calling convention. The compiler used `__clrcall`. ## Example -The following sample generates C4441. +The following example generates C4441. ```cpp // C4441.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4445.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4445.md index 4312f592b2f..d50740c4fd0 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4445.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4445.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4445" title: "Compiler Warning (level 1) C4445" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4445" +ms.date: 11/04/2016 f1_keywords: ["C4445"] helpviewer_keywords: ["C4445"] -ms.assetid: 535e92a0-ba08-4dfc-89b2-af2dcdd7caeb --- # Compiler Warning (level 1) C4445 -'function' : in a WinRT or managed type a virtual method cannot be private +> 'function' : in a WinRT or managed type a virtual method cannot be private + +## Remarks If a virtual function is private, it cannot be accessed by a derived type. To fix this error, change the accessibility of the virtual member function to protected or public. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4461.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4461.md index ec88b65c40d..62fa36aa89a 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4461.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4461.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4461" title: "Compiler Warning (level 1) C4461" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4461" +ms.date: 11/04/2016 f1_keywords: ["C4461"] helpviewer_keywords: ["C4461"] -ms.assetid: 104ffecc-3dd4-4cb1-89a8-81154fbe46d9 --- # Compiler Warning (level 1) C4461 -'type' : this class has a finalizer 'finalizer' but no destructor 'dtor' +> 'type' : this class has a finalizer 'finalizer' but no destructor 'dtor' + +## Remarks The presence of a finalizer in a type implies resources to delete. Unless a finalizer is explicitly called from the type's destructor, the common language runtime determines when to run the finalizer, after your object goes out of scope. @@ -18,7 +19,7 @@ For more information, see [Destructors and finalizers](../../dotnet/how-to-defin ## Example -The following sample generates C4461. +The following example generates C4461. ```cpp // C4461.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4462.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4462.md index 63d4762be21..ce4fe63e11b 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4462.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4462.md @@ -1,15 +1,16 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4462" title: "Compiler Warning (level 1) C4462" -ms.date: "10/25/2017" +description: "Learn more about: Compiler Warning (level 1) C4462" +ms.date: 10/25/2017 f1_keywords: ["C4462"] helpviewer_keywords: ["C4462"] -ms.assetid: 4e20aca4-293e-4c75-a83d-961c27ab7840 --- # Compiler Warning (level 1) C4462 > cannot determine the GUID of the type. Program may fail at runtime. +## Remarks + Warning C4462 occurs in a Windows Runtime app or component when a public `TypedEventHandler` has as one of its type parameters a reference to the enclosing class. This warning is automatically promoted to an error. If you wish to modify this behavior, use [#pragma warning](../../preprocessor/warning.md). For example, to make C4462 into a level 4 warning issue, add this line to your source code file: @@ -20,7 +21,7 @@ This warning is automatically promoted to an error. If you wish to modify this b ## Example -This sample generates warning C4462: +This example generates warning C4462: ```cpp namespace N diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4470.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4470.md index 74f847fd992..8cc35e1f593 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4470.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4470.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4470" title: "Compiler Warning (level 1) C4470" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4470" +ms.date: 11/04/2016 f1_keywords: ["C4470"] helpviewer_keywords: ["C4470"] -ms.assetid: f52a3eaa-a235-4747-a47d-9ec4ad4cb0ea --- # Compiler Warning (level 1) C4470 -floating-point control pragmas ignored under /clr +> floating-point control pragmas ignored under /clr + +## Remarks The float-control pragmas: @@ -20,7 +21,9 @@ The float-control pragmas: have no effect under [/clr](../../build/reference/clr-common-language-runtime-compilation.md). -The following sample generates C4470: +## Example + +The following example generates C4470: ```cpp // C4470.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4486.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4486.md index 319dbc7c1d9..0d0fc68d539 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4486.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4486.md @@ -1,20 +1,21 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4486" title: "Compiler Warning (level 1) C4486" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4486" +ms.date: 11/04/2016 f1_keywords: ["C4486"] helpviewer_keywords: ["C4486"] -ms.assetid: 2c0c59e3-d025-4d97-8da2-fa27df1402fc --- # Compiler Warning (level 1) C4486 -'function' : a private virtual method of a ref class or value class should be marked 'sealed' +> 'function' : a private virtual method of a ref class or value class should be marked 'sealed' + +## Remarks Since a private virtual member function of a managed class or struct cannot be accessed or overridden, it should be marked [sealed](../../extensions/sealed-cpp-component-extensions.md). -## Examples +## Example -The following sample generates C4486. +The following example generates C4486. ```cpp // C4486.cpp @@ -26,7 +27,7 @@ private: }; ``` -The following sample shows one possible use of a private sealed, virtual function. +The following example shows one possible use of a private sealed, virtual function. ```cpp // C4486_b.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4488.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4488.md index 9faef2a3235..972d534a5a2 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4488.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4488.md @@ -1,20 +1,21 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4488" title: "Compiler Warning (level 1) C4488" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4488" +ms.date: 11/04/2016 f1_keywords: ["C4488"] helpviewer_keywords: ["C4488"] -ms.assetid: 55625e46-ddb5-4c7c-99c7-cd4aa9f879bd --- # Compiler Warning (level 1) C4488 -'function' : requires 'keyword' keyword to implement the interface method 'interface_method' +> 'function' : requires 'keyword' keyword to implement the interface method 'interface_method' + +## Remarks A class must implement all members of an interface from which it directly inherits. An implemented member must have public accessibility, and must be marked virtual. ## Examples -C4488 can occur if an implemented member is not public. The following sample generates C4488. +C4488 can occur if an implemented member is not public. The following example generates C4488. ```cpp // C4488.cpp @@ -33,7 +34,7 @@ public: }; ``` -C4488 can occur if an implemented member is not marked virtual. The following sample generates C4488. +C4488 can occur if an implemented member is not marked virtual. The following example generates C4488. ```cpp // C4488_b.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4489.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4489.md index e0882054020..a5709ed8687 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4489.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4489.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4489" title: "Compiler Warning (level 1) C4489" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4489" +ms.date: 11/04/2016 f1_keywords: ["C4489"] helpviewer_keywords: ["C4489"] -ms.assetid: 43b51c8c-27b5-44c9-b974-fe4b48f4896f --- # Compiler Warning (level 1) C4489 -'specifier' : not allowed on interface method 'method'; override specifiers are only allowed on ref class and value class methods +> 'specifier' : not allowed on interface method 'method'; override specifiers are only allowed on ref class and value class methods + +## Remarks A specifier keyword was incorrectly used on an interface method. @@ -16,7 +17,7 @@ For more information, see [Override Specifiers](../../extensions/override-specif ## Example -The following sample generates C4489. +The following example generates C4489. ```cpp // C4489.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4490.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4490.md index 533ee9f3bb5..cf731a936b9 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4490.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4490.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4490" title: "Compiler Warning (level 1) C4490" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4490" +ms.date: 11/04/2016 f1_keywords: ["C4490"] helpviewer_keywords: ["C4490"] -ms.assetid: f9b03ecf-41a1-4f4d-a74c-2c1e88234ccc --- # Compiler Warning (level 1) C4490 -'override' : incorrect use of override specifier; 'function' does not match a base ref class method +> 'override' : incorrect use of override specifier; 'function' does not match a base ref class method + +## Remarks An override specifier was used incorrectly. For example, you do not override an interface function, you implement it. @@ -16,7 +17,7 @@ For more information, see [Override Specifiers](../../extensions/override-specif ## Example -The following sample generates C4490. +The following example generates C4490. ```cpp // C4490.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4502.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4502.md index 7ed4e44ea8e..febc9be3e3b 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4502.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4502.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4502" title: "Compiler Warning (level 1) C4502" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4502" +ms.date: 11/04/2016 f1_keywords: ["C4502"] helpviewer_keywords: ["C4502"] -ms.assetid: d8d43153-a40c-4b96-bc11-64028a144d70 --- # Compiler Warning (level 1) C4502 -'linkage specification' requires use of keyword 'extern' and must precede all other specifiers +> 'linkage specification' requires use of keyword 'extern' and must precede all other specifiers + +## Remarks A linkage was specified without the **`extern`** keyword. Linkage is not relevant to non-extern types. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4503.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4503.md index 866586d4ea8..bd1f2733869 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4503.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4503.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4503" title: "Compiler Warning (level 1) C4503" -ms.date: "05/14/2018" +description: "Learn more about: Compiler Warning (level 1) C4503" +ms.date: 05/14/2018 f1_keywords: ["C4503"] helpviewer_keywords: ["C4503"] -ms.assetid: 7c5a98ae-5b6d-41d8-b881-12d3ffd5e392 --- # Compiler Warning (level 1) C4503 @@ -22,7 +21,7 @@ You might, however, decide to not restructure your code. It is possible to ship ## Example -The following sample generates C4503 in compilers before Visual Studio 2017: +The following example generates C4503 in compilers before Visual Studio 2017: ```cpp // C4503.cpp @@ -40,7 +39,7 @@ typedef std::map Hello; Hello MyWAT; ``` -This sample shows one way to rewrite your code to resolve C4503: +This example shows one way to rewrite your code to resolve C4503: ```cpp // C4503b.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4506.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4506.md index 85662502e78..d2960d7acf3 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4506.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4506.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4506" title: "Compiler Warning (level 1) C4506" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4506" +ms.date: 11/04/2016 f1_keywords: ["C4506"] helpviewer_keywords: ["C4506"] -ms.assetid: aa682869-65d1-4dad-ba32-198f10b44f91 --- # Compiler Warning (level 1) C4506 -no definition for inline function 'function' +> no definition for inline function 'function' + +## Remarks The given function was declared and marked for inlining but was not defined. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4508.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4508.md index f4ce654e68a..34c87bb27a2 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4508.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4508.md @@ -1,20 +1,23 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4508" title: "Compiler Warning (level 1) C4508" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4508" +ms.date: 11/04/2016 f1_keywords: ["C4508"] helpviewer_keywords: ["C4508"] -ms.assetid: c05f113b-b789-4df0-a4ef-78bce4767021 --- # Compiler Warning (level 1) C4508 -'function' : function should return a value; 'void' return type assumed +> 'function' : function should return a value; 'void' return type assumed + +## Remarks The function has no return type specified. In this case, C4430 should also fire and the compiler implements the fix reported by C4430 (default value is int). To resolve this warning, explicitly declare the return type of functions. -The following sample generates C4508: +## Example + +The following example generates C4508: ```cpp // C4508.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4518.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4518.md index 717e2457340..d63e8b14aaf 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4518.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4518.md @@ -1,16 +1,17 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4518" title: "Compiler Warning (level 1) C4518" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4518" +ms.date: 11/04/2016 f1_keywords: ["C4518"] helpviewer_keywords: ["C4518"] -ms.assetid: 4ad21004-f076-43fd-99f4-4bf1f9be4c0b --- # Compiler Warning (level 1) C4518 -'specifier' : storage-class or type specifier(s) unexpected here; ignored +> 'specifier' : storage-class or type specifier(s) unexpected here; ignored + +## Example -The following sample generates C4518: +The following example generates C4518: ```cpp // C4518.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4526.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4526.md index f3b0427593c..ea7f5d89922 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4526.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4526.md @@ -1,17 +1,20 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4526" title: "Compiler Warning (level 1) C4526" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4526" +ms.date: 11/04/2016 f1_keywords: ["C4526"] helpviewer_keywords: ["C4526"] -ms.assetid: 490f8916-5fdc-4cad-b412-76c3382a5976 --- # Compiler Warning (level 1) C4526 -'function' : static member function cannot override virtual function 'virtual function'override ignored, virtual function will be hidden +> 'function' : static member function cannot override virtual function 'virtual function'override ignored, virtual function will be hidden + +## Remarks The static member function meets the criteria to override the virtual function, which makes the member function both virtual and static. +## Example + The following code generates C4526: ```cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4530.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4530.md index 0575689ff83..a1b5e544b17 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4530.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4530.md @@ -1,19 +1,18 @@ --- title: "Compiler Warning (level 1) C4530" description: "Reference guide to Microsoft C++ compiler warning C4530." -ms.date: "04/02/2020" +ms.date: 04/02/2020 f1_keywords: ["C4530"] helpviewer_keywords: ["C4530"] -ms.assetid: a04dcdb2-84db-459d-9e5e-4e743887465f --- # Compiler Warning (level 1) C4530 > C++ exception handler used, but unwind semantics are not enabled. Specify /EHsc -The code uses C++ exception handling, but [/EHsc](../../build/reference/eh-exception-handling-model.md) wasn't included in the compiler options. - ## Remarks +The code uses C++ exception handling, but [/EHsc](../../build/reference/eh-exception-handling-model.md) wasn't included in the compiler options. + The compiler requires the **`/EHsc`** option to build C++ code that follows the C++ standard for exception handling. Standard C++ *unwind semantics* specifies that objects and stack frames constructed between where an exception is thrown and where it's caught must be destroyed and their resources recovered. This process is known as *unwinding the stack*. The **`/EHsc`** option tells the compiler to generate code that calls the destructors on automatic storage objects when an exception passes through the containing stack frame. *Automatic storage* objects are objects allocated on the stack, such as local variables. It's called automatic storage because it's allocated automatically when functions are called, and released automatically when they return. A *stack frame* is the data placed on the stack when a function is called, along with its automatic storage. @@ -26,7 +25,7 @@ If no exceptions can possibly be thrown in your executable, you may safely ignor ## Example -The following sample generates C4530: +The following example generates C4530: ```cpp // C4530.cpp @@ -36,4 +35,4 @@ int main() { } ``` -Compile the sample with **`/EHsc`** to resolve the warning. +Compile the example with **`/EHsc`** to resolve the warning. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4532.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4532.md index 000e2059c5b..ec19e1c3051 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4532.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4532.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4532" title: "Compiler Warning (level 1) C4532" +description: "Learn more about: Compiler Warning (level 1) C4532" ms.date: 08/30/2022 f1_keywords: ["C4532"] helpviewer_keywords: ["C4532"] -ms.assetid: 4e2a286a-d233-4106-9f65-29be1a94ca02 --- # Compiler Warning (level 1) C4532 @@ -30,7 +29,7 @@ The [`/sdl` (Enable Additional Security Checks)](../../build/reference/sdl-enabl ## Example -The following sample generates C4532; delete or comment out the jump statements to resolve the warnings. +The following example generates C4532; delete or comment out the jump statements to resolve the warnings. ```cpp // C4532.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4533.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4533.md index 11ebe5d5943..9a446f09372 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4533.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4533.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4533" title: "Compiler Warning (level 1) C4533" +description: "Learn more about: Compiler Warning (level 1) C4533" ms.date: 08/30/2022 f1_keywords: ["C4533"] helpviewer_keywords: ["C4533"] -ms.assetid: 359fecda-d540-46e5-b214-dbabe9ef50d2 --- # Compiler Warning (level 1) C4533 @@ -18,7 +17,7 @@ The [`/sdl` (Enable Additional Security Checks)](../../build/reference/sdl-enabl ## Example -The following sample generates C4533. To resolve the issue, move the initialization before the jump instruction or after the target of the jump. +The following example generates C4533. To resolve the issue, move the initialization before the jump instruction or after the target of the jump. ```cpp // C4533.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4537.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4537.md index 36bf23c975a..9c20b0c8ca1 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4537.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4537.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4537" title: "Compiler Warning (level 1) C4537" -ms.date: "08/27/2018" +description: "Learn more about: Compiler Warning (level 1) C4537" +ms.date: 08/27/2018 f1_keywords: ["C4537"] helpviewer_keywords: ["C4537"] -ms.assetid: 9454493c-d419-475e-8f35-9c00233c9329 --- # Compiler Warning (level 1) C4537 @@ -16,7 +15,7 @@ A reference was passed where an object (user-defined type) was expected. A refer ## Example -The following sample generates C4537 and shows how to fix it: +The following example generates C4537 and shows how to fix it: ```cpp // C4537.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4540.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4540.md index cdbd4967530..d14b6b6e38a 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4540.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4540.md @@ -1,17 +1,20 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4540" title: "Compiler Warning (level 1) C4540" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4540" +ms.date: 11/04/2016 f1_keywords: ["C4540"] helpviewer_keywords: ["C4540"] -ms.assetid: 8085e748-5f4d-43c2-b06d-eaf794edbf72 --- # Compiler Warning (level 1) C4540 -dynamic_cast used to convert to inaccessible or ambiguous base; run-time test will fail ('type1' to 'type2') +> dynamic_cast used to convert to inaccessible or ambiguous base; run-time test will fail ('type1' to 'type2') + +## Remarks You used **`dynamic_cast`** to convert from one type to another. The compiler determined that the cast would always fail (return **NULL**) because a base class is inaccessible (**`private`**, for instance) or ambiguous (appears more than once in the class hierarchy, for instance). +## Example + The following shows an example of this warning. Class **B** is derived from class **A**. The program uses **`dynamic_cast`** to cast from class **B** (the derived class) to class **A**, which will always fail because class **B** is **`private`** and thus inaccessible. Changing the access of **A** to **`public`** will resolve the warning. ```cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4541.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4541.md index ed2547e029a..5b5982d38a6 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4541.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4541.md @@ -1,13 +1,43 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4541" title: "Compiler Warning (level 1) C4541" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4541" +ms.date: 08/24/2025 f1_keywords: ["C4541"] helpviewer_keywords: ["C4541"] -ms.assetid: b57b8f3e-117d-4fc2-bba6-faec17e5fa9d --- # Compiler Warning (level 1) C4541 -'identifier' used on polymorphic type 'type' with /GR-; unpredictable behavior may result +> '*operator*' used on polymorphic type '*type*' with /GR-; unpredictable behavior may result + +## Remarks + +You tried to use the [`dynamic_cast` operator](../../cpp/dynamic-cast-operator.md) or [`typeid` operator](../../cpp/typeid-operator.md), which requires [Run-Time Type Information](../../cpp/run-time-type-information.md) (RTTI), without enabling it. To enable RTTI, recompile with [`/GR`](../../build/reference/gr-enable-run-time-type-information.md). + +## Example + +The following example generates C4541: + +```cpp +// C4541.cpp +// compile with: /W1 /GR- + +#include + +struct Base +{ + virtual ~Base() {} +}; + +struct Derived : Base {}; + +int main() +{ + Derived derived; + Base* pointer_to_base = &derived; + + dynamic_cast(pointer_to_base); // C4541 -You tried to use a feature that requires run-time type information without enabling run-time type information. Recompile with [/GR](../../build/reference/gr-enable-run-time-type-information.md). + typeid(*pointer_to_base); // C4541 + typeid(pointer_to_base); // OK +} +``` diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4544.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4544.md index 8d72e0375aa..d8c3396c024 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4544.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4544.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4544" title: "Compiler Warning (level 1) C4544" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4544" +ms.date: 11/04/2016 f1_keywords: ["C4544"] helpviewer_keywords: ["C4544"] -ms.assetid: 11ee04df-41ae-435f-af44-881e801315a8 --- # Compiler Warning (level 1) C4544 -'declaration': Default template argument ignored on this template declaration +> 'declaration': Default template argument ignored on this template declaration + +## Remarks A default template argument was specified in an incorrect location and was ignored. A default template argument for a class template can only be specified in the declaration or definition of the class template and not on a member of the class template. -This sample generates C4545, and the next sample shows how to fix it: +## Example + +This example generates C4544, and the next example shows how to fix it: ```cpp // C4544.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4545.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4545.md index 747aeba94f2..6add8aa635e 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4545.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4545.md @@ -1,20 +1,23 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4545" title: "Compiler Warning (level 1) C4545" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4545" +ms.date: 11/04/2016 f1_keywords: ["C4545"] helpviewer_keywords: ["C4545"] -ms.assetid: 43f8f34f-ed46-4661-95c0-c588c577ff73 --- # Compiler Warning (level 1) C4545 -expression before comma evaluates to a function which is missing an argument list +> expression before comma evaluates to a function which is missing an argument list + +## Remarks The compiler detected an ill-formed comma expression. This warning is off by default. For more information, see [Compiler Warnings That Are Off by Default](../../preprocessor/compiler-warnings-that-are-off-by-default.md). -The following sample generates C4545: +## Example + +The following example generates C4545: ```cpp // C4545.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4546.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4546.md index e79fac645f6..bb9d1835428 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4546.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4546.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4546" title: "Compiler Warning (level 1) C4546" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4546" +ms.date: 11/04/2016 f1_keywords: ["C4546"] helpviewer_keywords: ["C4546"] -ms.assetid: 071e1709-3841-46c1-8e71-96109cd22041 --- # Compiler Warning (level 1) C4546 -function call before comma missing argument list +> function call before comma missing argument list + +## Remarks The compiler detected an ill-formed comma expression. @@ -16,7 +17,7 @@ This warning is off by default. For more information, see [Compiler Warnings Tha ## Example -The following sample generates C4546: +The following example generates C4546: ```cpp // C4546.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4547.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4547.md index 8f29a08438b..fcf23c66dda 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4547.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4547.md @@ -1,20 +1,23 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4547" title: "Compiler Warning (level 1) C4547" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4547" +ms.date: 11/04/2016 f1_keywords: ["C4547"] helpviewer_keywords: ["C4547"] -ms.assetid: 3edf1c2e-c0d5-444d-ae83-44a7cce24bb2 --- # Compiler Warning (level 1) C4547 -'operator' : operator before comma has no effect; expected operator with side-effect +> 'operator' : operator before comma has no effect; expected operator with side-effect + +## Remarks The compiler detected an ill-formed comma expression. This warning is off by default. For more information, see [Compiler Warnings That Are Off by Default](../../preprocessor/compiler-warnings-that-are-off-by-default.md). -The following sample generates C4547: +## Example + +The following example generates C4547: ```cpp // C4547.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4548.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4548.md index c5ca0459485..62d604feaa4 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4548.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4548.md @@ -1,20 +1,23 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4548" title: "Compiler Warning (level 1) C4548" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4548" +ms.date: 11/04/2016 f1_keywords: ["C4548"] helpviewer_keywords: ["C4548"] -ms.assetid: 2cee817e-e463-4d90-bbd2-de120d48c101 --- # Compiler Warning (level 1) C4548 -expression before comma has no effect; expected expression with side-effect +> expression before comma has no effect; expected expression with side-effect + +## Remarks The compiler detected an ill-formed comma expression. This warning is off by default. For more information, see [Compiler Warnings That Are Off by Default](../../preprocessor/compiler-warnings-that-are-off-by-default.md). -The following sample generates C4548: +## Example + +The following example generates C4548: ```cpp // C4548.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4549.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4549.md index fd330c52a08..fb6610064fa 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4549.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4549.md @@ -1,20 +1,23 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4549" title: "Compiler Warning (level 1) C4549" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4549" +ms.date: 11/04/2016 f1_keywords: ["C4549"] helpviewer_keywords: ["C4549"] -ms.assetid: 81a07676-625b-4f58-9b0c-3ee22830b04a --- # Compiler Warning (level 1) C4549 -'operator' : operator before comma has no effect; did you intend 'operator'? +> 'operator' : operator before comma has no effect; did you intend 'operator'? + +## Remarks The compiler detected an ill-formed comma expression. This warning is off by default. For more information, see [Compiler Warnings That Are Off by Default](../../preprocessor/compiler-warnings-that-are-off-by-default.md). -The following sample generates C4549: +## Example + +The following example generates C4549: ```cpp // C4549.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4550.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4550.md index 11dd28ec1b2..f9c004fec9c 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4550.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4550.md @@ -1,19 +1,22 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4550" title: "Compiler Warning (level 1) C4550" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4550" +ms.date: 11/04/2016 f1_keywords: ["C4550"] helpviewer_keywords: ["C4550"] -ms.assetid: f902b4ed-5f17-48ea-b693-92f4fb8c8054 --- # Compiler Warning (level 1) C4550 -expression evaluates to a function which is missing an argument list +> expression evaluates to a function which is missing an argument list + +## Remarks A dereferenced pointer to a function is missing an argument list. ## Example +The following example generates C4550: + ```cpp // C4550.cpp // compile with: /W1 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4551.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4551.md index 2ac75c88a32..a7e1b9fe013 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4551.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4551.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4551" title: "Compiler Warning (level 1) C4551" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4551" +ms.date: 11/04/2016 f1_keywords: ["C4551"] helpviewer_keywords: ["C4551"] -ms.assetid: 458b59bd-e2d7-425f-9ba6-268ff200424f --- # Compiler Warning (level 1) C4551 -function call missing argument list +> function call missing argument list + +## Remarks A function call must include the open and close parentheses after the function name even if the function takes no parameters. -The following sample generates C4551: +## Example + +The following example generates C4551: ```cpp // C4551.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4552.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4552.md index a48817856db..6cea7cc2d46 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4552.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4552.md @@ -1,20 +1,23 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4552" title: "Compiler Warning (level 1) C4552" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4552" +ms.date: 11/04/2016 f1_keywords: ["C4552"] helpviewer_keywords: ["C4552"] -ms.assetid: ebbbb5ee-1c19-45bd-b386-41a19630fc76 --- # Compiler Warning (level 1) C4552 -'operator' : operator has no effect; expected operator with side-effect +> 'operator' : operator has no effect; expected operator with side-effect + +## Remarks If an expression statement has an operator with no side effect as the top of the expression, it's probably a mistake. To override this warning, put the expression in parentheses. -The following sample generates C4552: +## Example + +The following example generates C4552: ```cpp // C4552.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4553.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4553.md index d8ded153113..c8c357eb293 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4553.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4553.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4553" title: "Compiler Warning (level 1) C4553" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4553" +ms.date: 11/04/2016 f1_keywords: ["C4553"] helpviewer_keywords: ["C4553"] -ms.assetid: d8aacbe0-3cb5-4367-a6e5-fd7e28f0ff9d --- # Compiler Warning (level 1) C4553 -'operator' : operator has no effect; did you intend 'operator'? +> 'operator' : operator has no effect; did you intend 'operator'? + +## Remarks If an expression statement has an operator with no side effect as the top of the expression, it's probably a mistake. -The following sample generates C4553: +## Example + +The following example generates C4553: ```cpp // C4553.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4555.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4555.md index f00425ae350..f98f2f75afb 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4555.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4555.md @@ -1,19 +1,22 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4555" title: "Compiler Warning (level 1) C4555" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4555" +ms.date: 11/04/2016 f1_keywords: ["C4555"] helpviewer_keywords: ["C4555"] -ms.assetid: 50b286c1-f7bf-4292-b1fa-baaac9538611 --- # Compiler Warning (level 1) C4555 -expression has no effect; expected expression with side-effect +> expression has no effect; expected expression with side-effect + +## Remarks This warning informs you when an expression has no effect. This warning is off by default. See [Compiler Warnings That Are Off by Default](../../preprocessor/compiler-warnings-that-are-off-by-default.md) for more information. +## Example + For example: ```cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4556.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4556.md index 371adf13d23..361ee46a496 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4556.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4556.md @@ -1,14 +1,13 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4556" title: "Compiler Warning (level 1) C4556" -ms.date: "08/27/2018" +description: "Learn more about: Compiler Warning (level 1) C4556" +ms.date: 03/28/2025 f1_keywords: ["C4556"] helpviewer_keywords: ["C4556"] -ms.assetid: e4c0e296-b747-4db1-9608-30b8b74feac2 --- # Compiler Warning (level 1) C4556 -> value of intrinsic immediate argument '*value*' is out of range '*lowerbound* - *upperbound*' +> value of intrinsic immediate argument '*value*' is out of range '*lower_bound* - *upper_bound*' ## Remarks @@ -16,21 +15,18 @@ An intrinsic matches a hardware instruction. The hardware instruction has a fixe ## Example -The following sample generates C4556: +The following example generates C4556: ```cpp // C4556.cpp // compile with: /W1 -// processor: x86 IPF +// processor: x86 #include -void test() -{ - __m64 m; - _m_pextrw(m, 5); // C4556 -} - int main() { + __m64 m = _mm_setzero_si64(); + _m_pextrw(m, 5); // C4556 + _mm_empty(); } ``` diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4558.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4558.md index 33ca5b15716..730b37887ab 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4558.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4558.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4558" title: "Compiler Warning (level 1) C4558" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4558" +ms.date: 11/04/2016 f1_keywords: ["C4558"] helpviewer_keywords: ["C4558"] -ms.assetid: 52bb0324-7bec-468c-b35b-13a08d38e578 --- # Compiler Warning (level 1) C4558 -value of operand 'value' is out of range 'lowerbound - upperbound' +> value of operand 'value' is out of range 'lowerbound - upperbound' + +## Remarks The value passed to an assembly language instruction is out of the range specified for the parameter. The value will be truncated. -The following sample generates C4558: +## Example + +The following example generates C4558: ```cpp // C4558.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4561.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4561.md index 5b0d3ae7272..9c92d5ffb96 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4561.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4561.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4561" title: "Compiler Warning (level 1) C4561" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4561" +ms.date: 11/04/2016 f1_keywords: ["C4561"] helpviewer_keywords: ["C4561"] -ms.assetid: 3a10c12c-601b-4b6c-9861-331fd022e021 --- # Compiler Warning (level 1) C4561 -'__fastcall' incompatible with the '/clr' option: converting to '\__stdcall' +> '__fastcall' incompatible with the '/clr' option: converting to '\__stdcall' + +## Remarks The [__fastcall](../../cpp/fastcall.md) function-calling convention cannot be used with the [/clr](../../build/reference/clr-common-language-runtime-compilation.md) compiler option. The compiler ignores the calls to **`__fastcall`**. To fix this warning, either remove the calls to **`__fastcall`** or compile without **/clr**. -The following sample generates C4561: +## Example + +The following example generates C4561: ```cpp // C4561.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4566.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4566.md index 425026f9603..b20a4c38cdb 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4566.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4566.md @@ -1,20 +1,23 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4566" title: "Compiler Warning (level 1) C4566" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4566" +ms.date: 11/04/2016 f1_keywords: ["C4566"] helpviewer_keywords: ["C4566"] -ms.assetid: 65f40730-e86f-447c-b37b-16caadcfe311 --- # Compiler Warning (level 1) C4566 -character represented by universal-character-name 'char' cannot be represented in the current code page (page) +> character represented by universal-character-name 'char' cannot be represented in the current code page (page) + +## Remarks Not every Unicode character can be represented in your current ANSI code page. Narrow strings (one-byte characters) are converted to multi-byte characters whereas wide strings (two-byte characters) are not. -The following sample generates C4566: +## Example + +The following example generates C4566: ```cpp // C4566.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4572.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4572.md index 2ecaa73a316..6e42a081081 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4572.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4572.md @@ -1,20 +1,21 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4572" title: "Compiler Warning (level 1) C4572" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4572" +ms.date: 11/04/2016 f1_keywords: ["C4572"] helpviewer_keywords: ["C4572"] -ms.assetid: 482dee5a-29bd-4fc3-b769-9dfd4cd2a964 --- # Compiler Warning (level 1) C4572 -[ParamArray] attribute is deprecated under /clr, use '...' instead +> [ParamArray] attribute is deprecated under /clr, use '...' instead + +## Remarks An obsolete style for specifying a variable argument list was used. When compiling for the CLR, use ellipsis syntax instead of . For more information, see [Variable Argument Lists (...) (C++/CLI)](../../extensions/variable-argument-lists-dot-dot-dot-cpp-cli.md). ## Example -The following sample generates C4572. +The following example generates C4572. ```cpp // C4572.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4577.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4577.md index f6b51626645..9ba3d67ccb1 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4577.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4577.md @@ -1,7 +1,7 @@ --- title: "Compiler Warning C4577" -description: Compiler warning C4577 description and solution. -ms.date: "09/18/2019" +description: "Compiler warning C4577 description and solution." +ms.date: 09/18/2019 f1_keywords: ["C4577"] helpviewer_keywords: ["C4577"] --- @@ -9,6 +9,8 @@ helpviewer_keywords: ["C4577"] > 'noexcept' used with no exception handling mode specified; termination on exception is not guaranteed. Specify /EHsc +## Remarks + The compiler detected a **`noexcept`** specification, but standard C++ exception handling wasn't specified. The compiler doesn't fully support exception handling according to the C++ standard unless the [/EHsc](../../build/reference/eh-exception-handling-model.md) compiler option is specified. To resolve this issue, set the **/EHsc** compiler option. This warning is new in Visual Studio 2015, and is off by default. For more information, see [Compiler warnings that are off by default](../../preprocessor/compiler-warnings-that-are-off-by-default.md). diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4581.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4581.md index acdece26660..f68c67ae615 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4581.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4581.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4581" title: "Compiler Warning (level 1) C4581" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4581" +ms.date: 11/04/2016 f1_keywords: ["C4581"] helpviewer_keywords: ["C4581"] -ms.assetid: 598bcd87-257d-4eb3-94e4-15bb31aadc99 --- # Compiler Warning (level 1) C4581 -deprecated behavior: '"string1"' replaced with 'string2' to process attribute +> deprecated behavior: '"string1"' replaced with 'string2' to process attribute + +## Remarks This error can be generated as a result of compiler conformance work that was done for Visual Studio 2005: parameter checking for Visual C++ attributes. @@ -16,7 +17,7 @@ In previous versions, attribute values were accepted whether or not they were en ## Example -The following sample generates C4581. +The following example generates C4581. ```cpp // C4581.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4584.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4584.md index 4db3442c590..92ff0980142 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4584.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4584.md @@ -1,16 +1,21 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4584" title: "Compiler Warning (level 1) C4584" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4584" +ms.date: 11/04/2016 f1_keywords: ["C4584"] helpviewer_keywords: ["C4584"] -ms.assetid: ad86582f-cb8c-4d21-8c4c-a6c800059e25 --- # Compiler Warning (level 1) C4584 -'class1' : base-class 'class2' is already a base-class of 'class3' +> 'class1' : base-class 'class2' is already a base-class of 'class3' + +## Remarks + +The class you defined inherits from two classes, one of which inherits from the other. + +## Example -The class you defined inherits from two classes, one of which inherits from the other. For example: +For example: ```cpp // C4584.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4600.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4600.md index 446ec164f35..187cda9ee3e 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4600.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4600.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4600" title: "Compiler Warning (level 1) C4600" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4600" +ms.date: 11/04/2016 f1_keywords: ["C4600"] helpviewer_keywords: ["C4600"] -ms.assetid: f023a2a1-7fc4-463f-a434-dc93fcd3f4e9 --- # Compiler Warning (level 1) C4600 -\#pragma 'macro name' : expected a valid non-empty string +> #pragma 'macro name' : expected a valid non-empty string + +## Remarks You cannot specify an empty string when you push or pop a macro name with either the [pop_macro](../../preprocessor/pop-macro.md) or [push_macro](../../preprocessor/push-macro.md). -The following sample generates C4600: +## Example + +The following example generates C4600: ```cpp // C4600.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4602.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4602.md index a8a3b121f42..215e76f9799 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4602.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4602.md @@ -1,16 +1,21 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4602" title: "Compiler Warning (level 1) C4602" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4602" +ms.date: 11/04/2016 f1_keywords: ["C4602"] helpviewer_keywords: ["C4602"] -ms.assetid: c1f0300f-e2a2-4c9e-a7c3-4c7318d10509 --- # Compiler Warning (level 1) C4602 -\#pragma pop_macro : 'macro name' no previous #pragma push_macro for this identifier +> #pragma pop_macro : 'macro name' no previous #pragma push_macro for this identifier + +## Remarks + +If you use [pop_macro](../../preprocessor/pop-macro.md) for a particular macro, you must first have passed that macro name to [push_macro](../../preprocessor/push-macro.md). + +## Example -If you use [pop_macro](../../preprocessor/pop-macro.md) for a particular macro, you must first have passed that macro name to [push_macro](../../preprocessor/push-macro.md). For example, the following sample generates C4602: +For example, the following example generates C4602: ```cpp // C4602.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4603.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4603.md index a8b8f597828..56bb27c36d7 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4603.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4603.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4603" title: "Compiler Warning (level 1) C4603" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4603" +ms.date: 11/04/2016 f1_keywords: ["C4603"] helpviewer_keywords: ["C4603"] -ms.assetid: f065994e-e3e5-4694-b868-c124472b3342 --- # Compiler Warning (level 1) C4603 -'\' : macro is not defined or definition is different after precompiled header use +> '\' : macro is not defined or definition is different after precompiled header use + +## Remarks The macro specified by the *identifier* placeholder is either different or no longer defined after the precompiler header is used. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4606.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4606.md index 1eeecf2f663..acfb5694aae 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4606.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4606.md @@ -1,20 +1,21 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4606" title: "Compiler Warning (level 1) C4606" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4606" +ms.date: 11/04/2016 f1_keywords: ["C4606"] helpviewer_keywords: ["C4606"] -ms.assetid: c1b45fb6-672b-42eb-9e1c-c67b3e4150d3 --- # Compiler Warning (level 1) C4606 -\#pragma warning : 'warning_number' ignored; Code Analysis warnings are not associated with warning levels +> #pragma warning : 'warning_number' ignored; Code Analysis warnings are not associated with warning levels + +## Remarks For Code Analysis warnings, only `error`, `once`, and `default` are supported with the [warning](../../preprocessor/warning.md) pragma. ## Example -The following sample generates C4606. +The following example generates C4606. ```cpp // C4606.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4612.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4612.md index 49a8294c0ff..461fe57021d 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4612.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4612.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4612" title: "Compiler Warning (level 1) C4612" -ms.date: "08/27/2018" +description: "Learn more about: Compiler Warning (level 1) C4612" +ms.date: 08/27/2018 f1_keywords: ["C4612"] helpviewer_keywords: ["C4612"] -ms.assetid: 21ac02b2-51cd-4aff-9b70-d543511d5962 --- # Compiler Warning (level 1) C4612 @@ -18,6 +17,8 @@ The arguments to the **#pragma include_alias** statement can use the quote form ## Example +The following example generates C4612: + ```cpp // C4612.cpp // compile with: /W1 /LD diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4613.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4613.md index a1d1ba5b233..b38c95c4b13 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4613.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4613.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4613" title: "Compiler Warning (level 1) C4613" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4613" +ms.date: 11/04/2016 f1_keywords: ["C4613"] helpviewer_keywords: ["C4613"] -ms.assetid: 399f521b-651c-4997-bc91-f40198e9a4d4 --- # Compiler Warning (level 1) C4613 -'segment' : class of segment cannot be changed +> 'segment' : class of segment cannot be changed + +## Remarks You tried to create a segment with the same class name as a segment used by the compiler. No new segment class was created. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4615.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4615.md index 8f4b9c9c1c2..9fa4a67263d 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4615.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4615.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4615" title: "Compiler Warning (level 1) C4615" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4615" +ms.date: 11/04/2016 f1_keywords: ["C4615"] helpviewer_keywords: ["C4615"] -ms.assetid: 7b107c01-0da2-4e01-8b40-93813e30b94c --- # Compiler Warning (level 1) C4615 -\#pragma warning : unknown user warning type +> #pragma warning : unknown user warning type + +## Remarks An invalid warning specifier was used with **pragma** [warning](../../preprocessor/warning.md). To resolve the error, use a valid warning specifier. -The following sample generates C4615: +## Example + +The following example generates C4615: ```cpp // C4615.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4616.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4616.md index b3228cd32c3..1fb7f99a29e 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4616.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4616.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4616" title: "Compiler Warning (level 1) C4616" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4616" +ms.date: 11/04/2016 f1_keywords: ["C4616"] helpviewer_keywords: ["C4616"] -ms.assetid: 71e15265-c5bc-42ce-a6a9-4879892472b1 --- # Compiler Warning (level 1) C4616 -\#pragma warning : warning number 'number' not a valid compiler warning +> #pragma warning : warning number 'number' not a valid compiler warning + +## Remarks The warning number specified in the [warning](../../preprocessor/warning.md) pragma cannot be reassigned. The pragma was ignored. -The following sample generates C4616: +## Example + +The following example generates C4616: ```cpp // C4616.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4618.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4618.md index 577c7875f91..ef7b1fba645 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4618.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4618.md @@ -1,20 +1,23 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4618" title: "Compiler Warning (level 1) C4618" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4618" +ms.date: 11/04/2016 f1_keywords: ["C4618"] helpviewer_keywords: ["C4618"] -ms.assetid: 6ff10d0a-6d5b-4373-8196-1d57bb6b1611 --- # Compiler Warning (level 1) C4618 -pragma parameters included an empty string; pragma ignored +> pragma parameters included an empty string; pragma ignored + +## Remarks A null string was given as an argument to a **#pragma**. The pragma was processed without the argument. -The following sample generates C4618: +## Example + +The following example generates C4618: ```cpp // C4618.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4620.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4620.md index c70c10ef526..76b04214dec 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4620.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4620.md @@ -1,17 +1,20 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4620" title: "Compiler Warning (level 1) C4620" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4620" +ms.date: 11/04/2016 f1_keywords: ["C4620"] helpviewer_keywords: ["C4620"] -ms.assetid: fed29934-b797-47e8-bbea-c7e5f8dd6e93 --- # Compiler Warning (level 1) C4620 -no postfix form of 'operator ++' found for type 'type', using prefix form +> no postfix form of 'operator ++' found for type 'type', using prefix form + +## Remarks There is no postfix increment operator defined for the given type. The compiler used the overloaded prefix operator. +## Example + This warning can be avoided by defining a postfix `++` operator. Create a two-argument version of the `++` operator as shown here: ```cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4621.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4621.md index 575f6c2d426..f32fce06aad 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4621.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4621.md @@ -1,17 +1,20 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4621" title: "Compiler Warning (level 1) C4621" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4621" +ms.date: 11/04/2016 f1_keywords: ["C4621"] helpviewer_keywords: ["C4621"] -ms.assetid: 40931bd9-cb89-497e-86f0-cec9f016c63c --- # Compiler Warning (level 1) C4621 -no postfix form of 'operator --' found for type 'type', using prefix form +> no postfix form of 'operator --' found for type 'type', using prefix form + +## Remarks There was no postfix decrement operator defined for the given type. The compiler used the overloaded prefix operator. +## Example + This warning can be avoided by defining a postfix `--` operator. Create a two-argument version of the `--` operator as shown below: ```cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4624.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4624.md index 977cd630768..d3bb234530d 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4624.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4624.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4624" title: "Compiler Warning (level 1) C4624" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4624" +ms.date: 11/04/2016 f1_keywords: ["C4624"] helpviewer_keywords: ["C4624"] -ms.assetid: 14f61769-d92e-482b-9515-debd87b30a66 --- # Compiler Warning (level 1) C4624 -'derived class' : destructor was implicitly defined as deleted because a base class destructor is inaccessible or deleted +> 'derived class' : destructor was implicitly defined as deleted because a base class destructor is inaccessible or deleted + +## Remarks A destructor was not accessible or deleted in a base class and was therefore not generated for a derived class. Any attempt to create an object of this type on the stack will cause a compiler error. -The following sample generates C4624 and shows how to fix it: +## Example + +The following example generates C4624 and shows how to fix it: ```cpp // C4624.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4627.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4627.md index d8e7bfaf5d0..6689bdba0b9 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4627.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4627.md @@ -1,20 +1,21 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4627" title: "Compiler Warning (level 1) C4627" -ms.date: "09/09/2018" +description: "Learn more about: Compiler Warning (level 1) C4627" +ms.date: 09/09/2018 f1_keywords: ["C4627"] helpviewer_keywords: ["C4627"] -ms.assetid: 8840f3e6-b496-423a-8635-eb55d5f854a2 --- # Compiler Warning (level 1) C4627 > '*header_file*': skipped when looking for precompiled header use +## Remarks + If the current source file has the [/Yu \(Use precompiled header file)](../../build/reference/yu-use-precompiled-header-file.md) option set, then the compiler ignores everything in the file before the precompiled header is included. Warning **C4627** is generated in Visual Studio 2015 and earlier versions if *header_file* is included before the precompiled header file, and if the precompiled header does not also include *header_file*. ## Example -This sample demonstrates how the error can occur, and shows how to fix it: +This example demonstrates how the error can occur, and shows how to fix it: ```cpp // c4627.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4628.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4628.md index 98acc3132b9..e66578e986d 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4628.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4628.md @@ -1,20 +1,23 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4628" title: "Compiler Warning (level 1) C4628" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4628" +ms.date: 11/04/2016 f1_keywords: ["C4628"] helpviewer_keywords: ["C4628"] -ms.assetid: 20fdc6f8-5f6a-40cc-aff8-c7ccf3d8ec26 --- # Compiler Warning (level 1) C4628 -digraphs not supported with -Ze. Character sequence 'digraph' not interpreted as alternate token for 'char' +> digraphs not supported with -Ze. Character sequence 'digraph' not interpreted as alternate token for 'char' + +## Remarks Digraphs are not supported under [/Ze](../../build/reference/za-ze-disable-language-extensions.md). This warning will be followed by an error. This warning is off by default. See [Compiler Warnings That Are Off by Default](../../preprocessor/compiler-warnings-that-are-off-by-default.md) for more information. -The following sample generates C4628: +## Example + +The following example generates C4628: ```cpp // C4628.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4630.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4630.md index 3f80c7b419e..43df3fea625 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4630.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4630.md @@ -1,16 +1,21 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4630" title: "Compiler Warning (level 1) C4630" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4630" +ms.date: 11/04/2016 f1_keywords: ["C4630"] helpviewer_keywords: ["C4630"] -ms.assetid: d8926376-7acc-4fc7-8438-6f0de3468870 --- # Compiler Warning (level 1) C4630 -'symbol' : 'extern' storage class specifier illegal on member definition +> 'symbol' : 'extern' storage class specifier illegal on member definition + +## Remarks + +A data member or member function is defined as **`extern`**. Members cannot be external, although entire objects can. The compiler ignores the **`extern`** keyword. + +## Example -A data member or member function is defined as **`extern`**. Members cannot be external, although entire objects can. The compiler ignores the **`extern`** keyword. The following sample generates C4630: +The following example generates C4630: ```cpp // C4630.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4631.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4631.md index 63815b39c47..894e783d2c9 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4631.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4631.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4631" title: "Compiler Warning (level 1) C4631" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4631" +ms.date: 11/04/2016 f1_keywords: ["C4631"] helpviewer_keywords: ["C4631"] -ms.assetid: d8636ff6-29a7-4fec-b9a6-e201d121c3ca --- # Compiler Warning (level 1) C4631 -MSXML or XPath unavailable, XML document comments will not be processed. reason +> MSXML or XPath unavailable, XML document comments will not be processed. reason + +## Remarks Your common language runtime installation did not have the necessary files to support processing doc comment. Reinstall the common language runtime. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4632.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4632.md index eb92db81390..7d4b05da68b 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4632.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4632.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4632" title: "Compiler Warning (level 1) C4632" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4632" +ms.date: 11/04/2016 f1_keywords: ["C4632"] helpviewer_keywords: ["C4632"] -ms.assetid: 9e35d205-cf21-4e34-8bd5-e1e7b0e2cdd3 --- # Compiler Warning (level 1) C4632 -XML document comment: file - access denied: reason +> XML document comment: file - access denied: reason + +## Remarks The path to .xdc file (`file`) was not valid, and no .xdc file created. -The following sample generates C4632: +## Example + +The following example generates C4632: ```cpp // C4632.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4650.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4650.md index 6eb867c876c..ded99d3b702 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4650.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4650.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4650" title: "Compiler Warning (level 1) C4650" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4650" +ms.date: 11/04/2016 f1_keywords: ["C4650"] helpviewer_keywords: ["C4650"] -ms.assetid: 3190b3e3-dcd6-4846-939b-f900ab652b2a --- # Compiler Warning (level 1) C4650 -debugging information not in precompiled header; only global symbols from the header will be available +> debugging information not in precompiled header; only global symbols from the header will be available + +## Remarks The precompiled header file was not compiled with Microsoft symbolic debugging information. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4651.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4651.md index ad0334aba73..34a4d06f1e6 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4651.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4651.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4651" title: "Compiler Warning (level 1) C4651" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4651" +ms.date: 11/04/2016 f1_keywords: ["C4651"] helpviewer_keywords: ["C4651"] -ms.assetid: f1ea82aa-4dc1-4972-b55a-57fdb962f0dd --- # Compiler Warning (level 1) C4651 -'definition' specified for precompiled header but not for current compile +> 'definition' specified for precompiled header but not for current compile + +## Remarks The definition was specified when the precompiled header was generated, but not in this compilation. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4652.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4652.md index b8130b1bd48..a70abbd28b7 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4652.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4652.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4652" title: "Compiler Warning (level 1) C4652" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4652" +ms.date: 11/04/2016 f1_keywords: ["C4652"] helpviewer_keywords: ["C4652"] -ms.assetid: 2cf2c666-8cdd-4dd9-bda0-662921498b03 --- # Compiler Warning (level 1) C4652 -compiler option 'option' inconsistent with precompiled header; current command-line option will override that defined in the precompiled header +> compiler option 'option' inconsistent with precompiled header; current command-line option will override that defined in the precompiled header + +## Remarks The given command-line option differed from that given when the precompiled header (.pch) was created. The option specified in the current command line was used. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4655.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4655.md index 7a3e26979a8..f8d307ae981 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4655.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4655.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4655" title: "Compiler Warning (level 1) C4655" -ms.date: "08/27/2018" +description: "Learn more about: Compiler Warning (level 1) C4655" +ms.date: 08/27/2018 f1_keywords: ["C4655"] helpviewer_keywords: ["C4655"] -ms.assetid: 540f2c7a-e4a1-49af-84b4-03eeea1bbf41 --- # Compiler Warning (level 1) C4655 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4656.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4656.md index 4d7a41a0736..cf56b54f864 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4656.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4656.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4656" title: "Compiler Warning (level 1) C4656" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4656" +ms.date: 11/04/2016 f1_keywords: ["C4656"] helpviewer_keywords: ["C4656"] -ms.assetid: b5aaef74-2320-4345-a6ae-b813881a491c --- # Compiler Warning (level 1) C4656 -'symbol' : data type is new or has changed since the last build, or is defined differently elsewhere +> 'symbol' : data type is new or has changed since the last build, or is defined differently elsewhere + +## Remarks You added or changed a data type, making it new to your source code since the last successful build. Edit and Continue does not support changes to existing data types. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4657.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4657.md index 2fe16f7f35d..2122b6d551a 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4657.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4657.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4657" title: "Compiler Warning (level 1) C4657" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4657" +ms.date: 11/04/2016 f1_keywords: ["C4657"] helpviewer_keywords: ["C4657"] -ms.assetid: eb750050-cea6-4ead-b80c-d5dcd4971cfc --- # Compiler Warning (level 1) C4657 -expression involves a data type that is new since the last build +> expression involves a data type that is new since the last build + +## Remarks You added or changed a data type, making it new to your source code since the last successful build. Edit and Continue does not support changes to existing data types. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4659.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4659.md index 88e61092e69..a38cf4cf7ae 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4659.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4659.md @@ -1,17 +1,22 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4659" title: "Compiler Warning (level 1) C4659" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4659" +ms.date: 11/04/2016 f1_keywords: ["C4659"] helpviewer_keywords: ["C4659"] -ms.assetid: e29ba8db-7917-43f6-8e34-868b752279ae --- # Compiler Warning (level 1) C4659 -\#pragma 'pragma' : use of reserved segment 'segment' has undefined behavior, use #pragma comment(linker, ...) +> #pragma 'pragma' : use of reserved segment 'segment' has undefined behavior, use #pragma comment(linker, ...) + +## Remarks The .drectve option was used to pass an option to the linker. Instead use pragma [comment](../../preprocessor/comment-c-cpp.md) for passing a linker option. +## Example + +The following example generates C4659: + ```cpp // C4659.cpp // compile with: /W1 /LD diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4661.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4661.md index e3f0cbbf69d..b4d9e92a60c 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4661.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4661.md @@ -1,19 +1,22 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4661" title: "Compiler Warning (level 1) C4661" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4661" +ms.date: 11/04/2016 f1_keywords: ["C4661"] helpviewer_keywords: ["C4661"] -ms.assetid: 603bb8b7-356d-4eef-924b-64d769bac5bd --- # Compiler Warning (level 1) C4661 -'identifier' : no suitable definition provided for explicit template instantiation request +> 'identifier' : no suitable definition provided for explicit template instantiation request + +## Remarks A member of the template class is not defined. ## Example +The following example generates C4661: + ```cpp // C4661.cpp // compile with: /W1 /LD diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4662.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4662.md index 3d92cd2b859..68beca85087 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4662.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4662.md @@ -1,19 +1,22 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4662" title: "Compiler Warning (level 1) C4662" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4662" +ms.date: 11/04/2016 f1_keywords: ["C4662"] helpviewer_keywords: ["C4662"] -ms.assetid: 7efda273-d04a-47b7-ad65-ff1ff94b5ffc --- # Compiler Warning (level 1) C4662 -explicit instantiation; template-class 'identifier1' has no definition from which to specialize 'identifier2' +> explicit instantiation; template-class 'identifier1' has no definition from which to specialize 'identifier2' + +## Remarks The specified template-class was declared, but not defined. ## Example +The following example generates C4662: + ```cpp // C4662.cpp // compile with: /W1 /LD diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4667.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4667.md index 2170e220116..6de3394c5d8 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4667.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4667.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4667" title: "Compiler Warning (level 1) C4667" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4667" +ms.date: 11/04/2016 f1_keywords: ["C4667"] helpviewer_keywords: ["C4667"] -ms.assetid: 5d2b7fe0-4f0e-4cd6-b432-ca02c3d194ab --- # Compiler Warning (level 1) C4667 -'function' : no function template defined that matches forced instantiation +> 'function' : no function template defined that matches forced instantiation + +## Remarks You cannot instantiate a function template that has not been declared. -The following sample will cause C4667: +## Example + +The following example will cause C4667: ```cpp // C4667a.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4669.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4669.md index ff9b92c50a9..3d19bad6cd0 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4669.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4669.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4669" title: "Compiler Warning (level 1) C4669" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4669" +ms.date: 11/04/2016 f1_keywords: ["C4669"] helpviewer_keywords: ["C4669"] -ms.assetid: 97730679-e3dc-44d4-b2a8-aa65badc17f2 --- # Compiler Warning (level 1) C4669 -'cast' : unsafe conversion: 'class' is a managed or WinRT type object +> 'cast' : unsafe conversion: 'class' is a managed or WinRT type object + +## Remarks A cast contains a Windows Runtime or managed type. The compiler completes the cast by performing a bit-wise copy of one pointer to the other, but provides no other checking. To resolve this warning, do not cast classes containing managed members or Windows Runtime types. -The following sample generates C4669 and shows how to fix it: +## Example + +The following example generates C4669 and shows how to fix it: ```cpp // C4669.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4674.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4674.md index 5bdc7b61cab..37e020cd33e 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4674.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4674.md @@ -1,20 +1,21 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4674" title: "Compiler Warning (level 1) C4674" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4674" +ms.date: 11/04/2016 f1_keywords: ["C4674"] helpviewer_keywords: ["C4674"] -ms.assetid: 638dae0b-b82c-4865-9599-72630827ca09 --- # Compiler Warning (level 1) C4674 -'method' should be declared 'static' and have exactly one parameter +> 'method' should be declared 'static' and have exactly one parameter + +## Remarks The signature of a conversion operator was not correct. The method is not considered a user-defined conversion. For more information on defining operators, see [User-Defined Operators (C++/CLI)](../../dotnet/user-defined-operators-cpp-cli.md) and [User-Defined Conversions (C++/CLI)](../../dotnet/user-defined-conversions-cpp-cli.md). ## Example -The following sample generates C4674. +The following example generates C4674. ```cpp // C4674.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4677.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4677.md index 40eb235d544..1a86bd31b69 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4677.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4677.md @@ -1,20 +1,21 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4677" title: "Compiler Warning (level 1) C4677" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4677" +ms.date: 11/04/2016 f1_keywords: ["C4677"] helpviewer_keywords: ["C4677"] -ms.assetid: a8d656a1-e2ff-4f8b-9028-201765131026 --- # Compiler Warning (level 1) C4677 -'function': signature of non-private member contains assembly private type 'private_type' +> 'function': signature of non-private member contains assembly private type 'private_type' + +## Remarks A type that has public accessibility outside the assembly uses a type that has private access outside the assembly. A component that references the public assembly type will not be able to use the type member or members that reference the assembly private type. ## Example -The following sample generates C4677. +The following example generates C4677. ```cpp // C4677.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4678.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4678.md index ef63fce96f9..cfe99eaf282 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4678.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4678.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4678" title: "Compiler Warning (level 1) C4678" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4678" +ms.date: 11/04/2016 f1_keywords: ["C4678"] helpviewer_keywords: ["C4678"] -ms.assetid: 0c588f34-595d-4e5c-9470-8723fca2cc06 --- # Compiler Warning (level 1) C4678 -base class 'base_type' is less accessible than 'derived_type' +> base class 'base_type' is less accessible than 'derived_type' + +## Remarks A public type derives from a private type. If the public type is instantiated in a referenced assembly, members of the private base type will not be accessible. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4679.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4679.md index 60432e84ec0..ada9e31dc9c 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4679.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4679.md @@ -1,15 +1,16 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4679" title: "Compiler Warning (level 1) C4679" -ms.date: "08/27/2018" +description: "Learn more about: Compiler Warning (level 1) C4679" +ms.date: 08/27/2018 f1_keywords: ["C4679"] helpviewer_keywords: ["C4679"] -ms.assetid: 3cc74150-42a8-4116-94cd-4ef0fd6dcf32 --- # Compiler Warning (level 1) C4679 > '*member*' : could not import member +## Remarks + The compiler encountered a construct that it cannot support, that cannot be imported from metadata. Do not try to use the construct. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4683.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4683.md index 4e49d32e524..f403e48f03d 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4683.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4683.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4683" title: "Compiler Warning (level 1) C4683" -ms.date: "08/27/2018" +description: "Learn more about: Compiler Warning (level 1) C4683" +ms.date: 08/27/2018 f1_keywords: ["C4683"] helpviewer_keywords: ["C4683"] -ms.assetid: e6e77364-dba1-46dd-ae1d-03da23070bce --- # Compiler Warning (level 1) C4683 @@ -24,7 +23,7 @@ The reason for the leak is that the out parameter will be set by more than one h ## Example -The following sample generates C4683 and shows how to fix it: +The following example generates C4683 and shows how to fix it: ```cpp // C4683.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4684.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4684.md index d48b01c07b8..ab66c25bf43 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4684.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4684.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4684" title: "Compiler Warning (level 1) C4684" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4684" +ms.date: 11/04/2016 f1_keywords: ["C4684"] helpviewer_keywords: ["C4684"] -ms.assetid: e95f1a83-2784-4b05-ae94-12148e056e26 --- # Compiler Warning (level 1) C4684 -'attribute' : WARNING!! attribute may cause invalid code generation: use with caution +> 'attribute' : WARNING!! attribute may cause invalid code generation: use with caution + +## Remarks You used an attribute that should not commonly be used. -The following sample generates C4684: +## Example + +The following example generates C4684: ```cpp // C4684.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4685.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4685.md index 484436b8714..a9fdc182960 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4685.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4685.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4685" title: "Compiler Warning (level 1) C4685" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4685" +ms.date: 11/04/2016 f1_keywords: ["C4685"] helpviewer_keywords: ["C4685"] -ms.assetid: 16e859b8-a8e8-4a0d-a1d0-37ec4e59a9d7 --- # Compiler Warning (level 1) C4685 -expecting '> >' found '>>' when parsing template parameters +> expecting '> >' found '>>' when parsing template parameters + +## Remarks A template definition was not terminated correctly. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4688.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4688.md index 59bedf3f0fb..d257f2f4acc 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4688.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4688.md @@ -1,20 +1,21 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4688" title: "Compiler Warning (level 1) C4688" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4688" +ms.date: 11/04/2016 f1_keywords: ["C4688"] helpviewer_keywords: ["C4688"] -ms.assetid: a027df3c-b2b8-4c49-8539-c2bc42db74e8 --- # Compiler Warning (level 1) C4688 -'constraint': constraint list contains assembly private type 'type' +> 'constraint': constraint list contains assembly private type 'type' + +## Remarks A constraint list has an assembly private type, meaning it will not be available when the type is accessed from outside the assembly. For more information, see [Generics](../../extensions/generics-cpp-component-extensions.md). ## Example -The following sample generates C4688. +The following example generates C4688. ```cpp // C4688.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4691.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4691.md index 16750c821ca..ae062d85d15 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4691.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4691.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4691" title: "Compiler Warning (level 1) C4691" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4691" +ms.date: 11/04/2016 f1_keywords: ["C4691"] helpviewer_keywords: ["C4691"] -ms.assetid: 722133d9-87f6-46c1-9e86-9825453d6999 --- # Compiler Warning (level 1) C4691 -'type' : type referenced was expected in unreferenced assembly 'file', type defined in current translation unit used instead +> 'type' : type referenced was expected in unreferenced assembly 'file', type defined in current translation unit used instead + +## Remarks The metadata file containing the original type definition is not referenced, and the compiler is using a local type definition. @@ -16,9 +17,9 @@ In the case where you are rebuilding *file*, C4691 can be ignored or turned off However, unexpected behavior can occur if the compiler uses a definition that is not from the same assembly that is referenced in metadata; CLR types are typed not only by the name of the type, but also by the assembly. That is, a type Z from assembly z.dll is different from a type Z from assembly y.dll. -## Examples +## Example -This sample contains the original type definition. +This example contains the original type definition. ```cpp // C4691_a.cpp @@ -26,7 +27,7 @@ This sample contains the original type definition. public ref class Original_Type {}; ``` -This sample references C4691_a.dll and declares a field of type Original_Type. +This example references C4691_a.dll and declares a field of type Original_Type. ```cpp // C4691_b.cpp @@ -38,7 +39,7 @@ public: }; ``` -The following sample generates C4691. Notice this sample contains a definition for Original_Type and does not reference C4691a.dll. +The following example generates C4691. Notice this example contains a definition for Original_Type and does not reference C4691a.dll. To resolve, reference the metadata file that contains the original type definition and remove the local declaration and definition. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4692.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4692.md index d9421493012..44cc03e03b4 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4692.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4692.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4692" title: "Compiler Warning (level 1) C4692" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4692" +ms.date: 11/04/2016 f1_keywords: ["C4692"] helpviewer_keywords: ["C4692"] -ms.assetid: f6fb3acc-8228-491a-9c30-ce302d8a9c75 --- # Compiler Warning (level 1) C4692 -'function': signature of non-private member contains assembly private native type 'native_type' +> 'function': signature of non-private member contains assembly private native type 'native_type' + +## Remarks A type that is visible outside the assembly contains a member function whose signature contains a native type that is not visible outside the assembly. Therefore, the member function should not be called if its containing type is instantiated outside the assembly. @@ -18,7 +19,7 @@ This warning is off by default. For more information, see [Compiler Warnings Tha ## Example -The following sample generates C4692. +The following example generates C4692. ```cpp // C4692.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4711.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4711.md index 264ef9afb52..1f8acf57625 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4711.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4711.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4711" title: "Compiler Warning (level 1) C4711" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4711" +ms.date: 11/04/2016 f1_keywords: ["C4711"] helpviewer_keywords: ["C4711"] -ms.assetid: 270506ab-fead-4328-b714-2978113be238 --- # Compiler Warning (level 1) C4711 -function 'function' selected for inline expansion +> function 'function' selected for inline expansion + +## Remarks The compiler performed inlining on the given function, although it was not marked for inlining. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4715.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4715.md index c4f1d16eda7..7350b2edfe6 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4715.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4715.md @@ -1,19 +1,22 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4715" title: "Compiler Warning (level 1) C4715" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4715" +ms.date: 11/04/2016 f1_keywords: ["C4715"] helpviewer_keywords: ["C4715"] -ms.assetid: 1c819bf7-0d8b-4f5e-b338-9cc292870439 --- # Compiler Warning (level 1) C4715 -'function' : not all control paths return a value +> 'function' : not all control paths return a value + +## Remarks The specified function can potentially not return a value. ## Example +The following example generates C4715: + ```cpp // C4715a.cpp // compile with: /W1 /LD diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4716.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4716.md index a01e32efc2c..ed6196b2104 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4716.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4716.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4716" title: "Compiler Warning (level 1) C4716" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4716" +ms.date: 11/04/2016 f1_keywords: ["C4716"] helpviewer_keywords: ["C4716"] -ms.assetid: d95ecfe5-870f-461f-a746-7913af98414b --- # Compiler Warning (level 1) C4716 -'function' must return a value +> 'function' must return a value + +## Remarks The given function did not return a value. @@ -18,7 +19,9 @@ An undefined value will be returned when this function is called. This warning is automatically promoted to an error. If you wish to modify this behavior, use [#pragma warning](../../preprocessor/warning.md). -The following sample generates C4716: +## Example + +The following example generates C4716: ```cpp // C4716.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4717.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4717.md index 3a0de8742fd..a546f804471 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4717.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4717.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4717" title: "Compiler Warning (level 1) C4717" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4717" +ms.date: 11/04/2016 f1_keywords: ["C4717"] helpviewer_keywords: ["C4717"] -ms.assetid: 5ef3c6c7-8599-4714-a973-0f5b69cdab3c --- # Compiler Warning (level 1) C4717 -'function' : recursive on all control paths, function will cause runtime stack overflow +> 'function' : recursive on all control paths, function will cause runtime stack overflow + +## Remarks Every path through a function contains a call to the function. Since there is no way to exit the function without first calling itself recursively, the function will never exit. -The following sample generates C4717: +## Example + +The following example generates C4717: ```cpp // C4717.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4722.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4722.md index 14ff9e25bdb..badb5a14db1 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4722.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4722.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4722" title: "Compiler Warning (level 1) C4722" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4722" +ms.date: 11/04/2016 f1_keywords: ["C4722"] helpviewer_keywords: ["C4722"] -ms.assetid: d8660710-f67b-4f59-a5fd-59259475529e --- # Compiler Warning (level 1) C4722 -'function' : destructor never returns, potential memory leak +> 'function' : destructor never returns, potential memory leak + +## Remarks The flow of control terminates in a destructor. The thread or the entire program will terminate and allocated resources may not be released. Furthermore, if a destructor will be called for stack unwinding during exception processing, the behavior of executable is undefined. @@ -16,7 +17,7 @@ To resolve, remove the function call that causes the destructor to not return. ## Example -The following sample generates C4722: +The following example generates C4722: ```cpp // C4722.cpp @@ -25,7 +26,7 @@ The following sample generates C4722: class C { public: C(); - ~C() { exit(1); }; // C4722 + ~C() { exit(1); } // C4722 }; extern void func (C*); diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4727.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4727.md index 821b7447a7f..d791c9190ce 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4727.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4727.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4727" title: "Compiler Warning (level 1) C4727" -ms.date: "08/19/2019" +description: "Learn more about: Compiler Warning (level 1) C4727" +ms.date: 08/19/2019 f1_keywords: ["C4727"] helpviewer_keywords: ["C4727"] -ms.assetid: 991b0087-3a50-40f5-9cdb-cdc367cd472c --- # Compiler Warning (level 1) C4727 -"PCH named pch_file with same timestamp found in obj_file_1 and obj_file_2. Using first PCH. +> "PCH named pch_file with same timestamp found in obj_file_1 and obj_file_2. Using first PCH. + +## Remarks > [!NOTE] > In Visual Studio 2017 and earlier, the precompiled header is called *stdafx.h* by default, and in Visual Studio 2019 and later, it is called *pch.h* by default. @@ -17,6 +18,8 @@ C4727 occurs when compiling multiple compilands with **/Yc**, and where the comp To resolve, compile one source file with **/Yc /c** (creates pch), and the others compile separately with **/Yu /c** (uses pch), then link them together. +## Example + So, if you did the following and it generates C4727: ::: moniker range="<=msvc-150" diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4729.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4729.md index 5bb7c836a4f..d8b24fc3922 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4729.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4729.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Warning (Level 1) C4729" title: "Compiler Warning (Level 1) C4729" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (Level 1) C4729" +ms.date: 11/04/2016 f1_keywords: ["C4729"] helpviewer_keywords: ["C4729"] -ms.assetid: 36a0151f-f258-48d9-9444-ae6d41ff70a4 --- # Compiler Warning (Level 1) C4729 -function too big for flow graph based warnings +> function too big for flow graph based warnings + +## Remarks This warning is generated when a function is too big to be compiled with reliable checking for situations that would generate a warning. This warning is only generated when the [/Od](../../build/reference/od-disable-debug.md) compiler option used. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4730.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4730.md index 69e3190a359..3856100db3a 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4730.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4730.md @@ -1,20 +1,23 @@ --- -description: "Learn more about: Compiler Warning (Level 1) C4730" title: "Compiler Warning (Level 1) C4730" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (Level 1) C4730" +ms.date: 11/04/2016 f1_keywords: ["C4730"] helpviewer_keywords: ["C4730"] -ms.assetid: 11303e3f-162b-4b19-970a-479686123a68 --- # Compiler Warning (Level 1) C4730 -'main' : mixing _m64 and floating point expressions may result in incorrect code +> 'main' : mixing _m64 and floating point expressions may result in incorrect code + +## Remarks A function uses [__m64](../../cpp/m64.md) and **`float`**/**`double`** types. Because the MMX and floating-point registers share the same physical register space (cannot be used simultaneously), using **`__m64`** and **`float`**/**`double`** types in the same function can result in data corruption, possibly causing an exception. To safely use **`__m64`** types and floating-point types in the same function, each instruction that uses one of the types should be separated by the **_m_empty()** (for MMX) or **_m_femms()** (for 3DNow!) intrinsic. -The following sample generates C4730: +## Example + +The following example generates C4730: ```cpp // C4730.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4731.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4731.md index 4e758090b5a..cdefa78d6b8 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4731.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4731.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Warning (Level 1) C4731" title: "Compiler Warning (Level 1) C4731" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (Level 1) C4731" +ms.date: 11/04/2016 f1_keywords: ["C4731"] helpviewer_keywords: ["C4731"] -ms.assetid: 5658c24c-3e6f-4505-835b-1fb92d47cab0 --- # Compiler Warning (Level 1) C4731 -'pointer' : frame pointer register 'register' modified by inline assembly code +> 'pointer' : frame pointer register 'register' modified by inline assembly code + +## Remarks A frame pointer register was modified. You must save and restore the register in your inline assembly block or frame variable (local or parameter, depending on the register modified), or your code may not work properly. -The following sample generates C4731: +## Example + +The following example generates C4731: ```cpp // C4731.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4733.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4733.md index 1c64dd7cbb5..d4e0f431ea3 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4733.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4733.md @@ -1,20 +1,23 @@ --- -description: "Learn more about: Compiler Warning (Level 1) C4733" title: "Compiler Warning (Level 1) C4733" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (Level 1) C4733" +ms.date: 11/04/2016 f1_keywords: ["C4733"] helpviewer_keywords: ["C4733"] -ms.assetid: 7ef4f577-772d-4b66-a7bf-8958a6b250bc --- # Compiler Warning (Level 1) C4733 -Inline asm assigning to 'FS:0' : handler not registered as safe handler +> Inline asm assigning to 'FS:0' : handler not registered as safe handler + +## Remarks A function modifying the value at FS:0 to add a new exception handler may not work with Safe Exceptions, because the handler may not be registered as a valid exception handler (see [/SAFESEH](../../build/reference/safeseh-image-has-safe-exception-handlers.md)). To resolve this warning, either remove the FS:0 definition or turn off this warning and use [.SAFESEH](../../assembler/masm/dot-safeseh.md) to specify the safe exception handlers. -The following sample generates C4733: +## Example + +The following example generates C4733: ```cpp // C4733.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4739.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4739.md index 83340c734c5..d9fb0cb42b1 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4739.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4739.md @@ -1,20 +1,23 @@ --- -description: "Learn more about: Compiler Warning (Level 1) C4739" title: "Compiler Warning (Level 1) C4739" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (Level 1) C4739" +ms.date: 11/04/2016 f1_keywords: ["C4739"] helpviewer_keywords: ["C4739"] -ms.assetid: 600873b3-7c85-4cd4-944e-cd8e01bfcbb0 --- # Compiler Warning (Level 1) C4739 -reference to variable 'var' exceeds its storage space +> reference to variable 'var' exceeds its storage space + +## Remarks A value was assigned to a variable, but the value is greater than the size of the variable. Memory will be written beyond the variable's memory location, and data loss is possible. To resolve this warning, only assign a value to a variable whose size can accommodate the value. -The following sample generates C4739: +## Example + +The following example generates C4739: ```cpp // C4739.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4742.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4742.md index c25caf63912..65aee758f44 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4742.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4742.md @@ -1,19 +1,18 @@ --- -description: "Learn more about: Compiler Warning (Level 1) C4742" title: "Compiler Warning (Level 1) C4742" +description: "Learn more about: Compiler Warning (Level 1) C4742" ms.date: 07/22/2020 f1_keywords: ["C4742"] helpviewer_keywords: ["C4742"] -ms.assetid: e520881d-1eeb-48b1-9df0-8017ee8ba076 --- # Compiler Warning (Level 1) C4742 > '*variable*' has different alignment in '*file1*' and '*file2*': *number1* and *number2* -An external variable that was referenced or defined in two files has different alignment in those files. - ## Remarks +An external variable that was referenced or defined in two files has different alignment in those files. + This warning is emitted when compiler finds that **`alignof`** for the variable in *file1* differs from **`alignof`** for the variable in *file2*. This can be caused by using incompatible types when declaring variable in different files, or by using non-matching `#pragma pack` in different files. To resolve this warning, either use the same type definition or use different names for the variables. @@ -32,7 +31,7 @@ struct X { } global; ``` -The following sample generates C4742. +The following example generates C4742. ```c // C4742b.c diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4743.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4743.md index 7587043b9dc..3eb845751b1 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4743.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4743.md @@ -1,26 +1,25 @@ --- -description: "Learn more about: Compiler Warning (Level 1) C4743" title: "Compiler Warning (Level 1) C4743" +description: "Learn more about: Compiler Warning (Level 1) C4743" ms.date: 06/16/2022 f1_keywords: ["C4743"] helpviewer_keywords: ["C4743"] -ms.assetid: 2ee76ea3-77f3-4c2f-9a57-0751823c89fd --- # Compiler Warning (Level 1) C4743 > '*type*' has different size in '*file1*' and '*file2*': *size_1* and *size_2* bytes -An external variable referenced or defined in two files has different types in those files, and the compiler determined that the size of the variable in *file1* differs from the size of the variable in *file2*. - ## Remarks +An external variable referenced or defined in two files has different types in those files, and the compiler determined that the size of the variable in *file1* differs from the size of the variable in *file2*. + There's an important case when this warning can be emitted for C++. If you declare class types with the same name in two different files, if those declarations contain virtual functions, and if the declarations aren't the same, then the compiler can emit warning C4744 for the virtual function tables. The warning occurs because there are two different-sized virtual function tables for the same type, and the linker must choose one of them to incorporate into the executable. It's possible that it can result in your program calling the wrong virtual function. To resolve this warning, either use the same type definition or use different names for the types or variables. ## Example -The following sample generates C4743. To compile it, place both files in the same folder, then run this command in a developer command prompt: +The following example generates C4743. To compile it, place both files in the same folder, then run this command in a developer command prompt: ```cmd cl /EHsc /W1 /GL /O2 C4743a.cpp C4743b.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4744.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4744.md index 3c788f2d519..df60c3ad08e 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4744.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4744.md @@ -1,25 +1,26 @@ --- -description: "Learn more about: Compiler Warning (Level 1) C4744" title: "Compiler Warning (Level 1) C4744" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (Level 1) C4744" +ms.date: 11/04/2016 f1_keywords: ["C4744"] helpviewer_keywords: ["C4744"] -ms.assetid: f2a7d0b5-afd5-4926-abc3-cfbd367e3ff5 --- # Compiler Warning (Level 1) C4744 -'var' has different type in 'file1' and 'file2': 'type1' and 'type2' +> 'var' has different type in 'file1' and 'file2': 'type1' and 'type2' + +## Remarks An external variable referenced or defined in two files has different types in those files. To resolve, either make the type definitions the same, or change variable name in one of the files. C4744 is emitted only when files are compiled with /GL. For more information, see [/GL (Whole Program Optimization)](../../build/reference/gl-whole-program-optimization.md). > [!NOTE] -> C4744 usually occurs in C (not C++) files, because in C++ a variable name is decorated with type information. When the sample (below) is compiles as C++, you'll get linker error LNK2019. +> C4744 usually occurs in C (not C++) files, because in C++ a variable name is decorated with type information. When the example (below) is compiles as C++, you'll get linker error LNK2019. -## Examples +## Example -This sample contains the first definition. +This example contains the first definition. ```c // C4744.c @@ -27,7 +28,7 @@ This sample contains the first definition. int global; ``` -The following sample generates C4744. +The following example generates C4744. ```c // C4744b.c @@ -37,7 +38,7 @@ The following sample generates C4744. extern unsigned global; -main() +int main() { printf_s("%d\n", global); } diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4747.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4747.md index 9b7dd217972..4354ddd8827 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4747.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4747.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4747" title: "Compiler Warning (level 1) C4747" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4747" +ms.date: 11/04/2016 f1_keywords: ["C4747"] helpviewer_keywords: ["C4747"] -ms.assetid: af37befd-ba1f-4bdc-96e1-a953f7a2ad9c --- # Compiler Warning (level 1) C4747 -Calling managed 'entrypoint': Managed code may not be run under loader lock, including the DLL entrypoint and calls reached from the DLL entrypoint +> Calling managed 'entrypoint': Managed code may not be run under loader lock, including the DLL entrypoint and calls reached from the DLL entrypoint + +## Remarks The compiler found a (probable) DLL entry point compiled to MSIL. Because of potential problems with loading a DLL whose entry point has been compiled to MSIL, you are strongly discouraged from compiling a DLL entry point function to MSIL. @@ -22,7 +23,7 @@ For more information, see [Initialization of Mixed Assemblies](../../dotnet/init ## Example -The following sample generates C4747. +The following example generates C4747. ```cpp // C4747.cpp @@ -35,5 +36,5 @@ The following sample generates C4747. BOOL WINAPI DllMain(HANDLE hInstance, ULONG Command, LPVOID Reserved) { return TRUE; -}; +} ``` diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4750.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4750.md index da0b7a82489..8739b355309 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4750.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4750.md @@ -4,7 +4,6 @@ description: "Describes MSVC compiler warning C4750 about a possible stack overf ms.date: 07/08/2020 f1_keywords: ["C4750"] helpviewer_keywords: ["C4750"] -ms.assetid: b0b2c938-7d2a-4c36-8270-7daee15ffee3 --- # Compiler Warning (level 1) C4750 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4772.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4772.md index efe45fc03e2..4f8fba1457b 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4772.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4772.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4772" title: "Compiler Warning (level 1) C4772" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4772" +ms.date: 11/04/2016 f1_keywords: ["C4772"] helpviewer_keywords: ["C4772"] -ms.assetid: dafe6fd8-9faf-41f5-9d66-a55838742c14 --- # Compiler Warning (level 1) C4772 -> \#import referenced a type from a missing type library; '*missing-type*' used as a placeholder +> #import referenced a type from a missing type library; '*missing-type*' used as a placeholder + +## Remarks A type library was referenced with the [#import](../../preprocessor/hash-import-directive-cpp.md) directive. However, the type library contained a reference to another type library that was not referenced with `#import`. This other .tlb file was not found by the compiler. @@ -51,7 +52,7 @@ library C4772bLib }; ``` -The following sample generates C4772: +The following example generates C4772: ```cpp // C4772.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4788.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4788.md index 4d871d446c9..a9c8bdd271a 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4788.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4788.md @@ -1,20 +1,25 @@ --- -description: "Learn more about: Compiler Warning (Level 1) C4788" title: "Compiler Warning (Level 1) C4788" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (Level 1) C4788" +ms.date: 11/04/2016 f1_keywords: ["C4788"] helpviewer_keywords: ["C4788"] -ms.assetid: 47d75bda-f833-4bdd-93a0-a134df0cd303 --- # Compiler Warning (Level 1) C4788 -'identifier' : identifier was truncated to 'number' characters +> 'identifier' : identifier was truncated to 'number' characters + +## Remarks The compiler limits the maximum length allowed for a function name. When the compiler generates funclets for EH/SEH code, it forms the funclet name by prepending the function name with some text, for example "__catch", "\__unwind", or another string. The resulting funclet name can be too long, and the compiler will truncate it and generate C4788. -To resolve this warning, shorten the original function name. If the function is a C++ function template or method, use a typedef for part of the name. For example: +To resolve this warning, shorten the original function name. If the function is a C++ function template or method, use a typedef for part of the name. + +## Example + +For example: ```cpp C1>::C2::f diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4789.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4789.md index 279721640b6..65ff8705ae4 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4789.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4789.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (Level 1) C4789" title: "Compiler Warning (Level 1) C4789" +description: "Learn more about: Compiler Warning (Level 1) C4789" ms.date: 08/30/2022 f1_keywords: ["C4789"] helpviewer_keywords: ["C4789"] -ms.assetid: 5800c301-5afb-4af0-85c1-ceb54d775234 --- # Compiler Warning (Level 1) C4789 @@ -19,9 +18,7 @@ ms.assetid: 5800c301-5afb-4af0-85c1-ceb54d775234 The warning occurs if the copy uses the intrinsic form of one of these CRT functions: - [`strcpy`](../../c-runtime-library/reference/strcpy-wcscpy-mbscpy.md) - - [`memset`](../../c-runtime-library/reference/memset-wmemset.md) - - [`memcpy`](../../c-runtime-library/reference/memcpy-wmemcpy.md), [`wmemcpy`](../../c-runtime-library/reference/memcpy-wmemcpy.md) The warning also appears when you cast a parameter to a larger data type, and then make a copy assignment from an lvalue reference. @@ -31,17 +28,17 @@ Visual C++ might generate this warning for a code path that never executes. You ```cpp #pragma warning( push ) #pragma warning( disable : 4789 ) -// unused code that generates compiler warning C4789` +// unused code that generates compiler warning C4789 #pragma warning( pop ) ``` -This idiom keeps Visual C++ from generating the warning for that specific block of code. The `#pragma warning(push)` preserves the existing state before `#pragma warning(disable: 4789)` changes it. The `#pragma warning(pop)` restores the pushed state, and removes the effects of the `#pragma warning(disable:4789)`. For more information about the C++ preprocessor directive `#pragma`, see [`warning`](../../preprocessor/warning.md) and [Pragma Directives and the `__Pragma` Keyword](../../preprocessor/pragma-directives-and-the-pragma-keyword.md). +This idiom keeps Visual C++ from generating the warning for that specific block of code. The `#pragma warning(push)` preserves the existing state before `#pragma warning(disable: 4789)` changes it. The `#pragma warning(pop)` restores the pushed state, and removes the effects of the `#pragma warning(disable:4789)`. For more information about the C++ preprocessor directive `#pragma`, see [`warning`](../../preprocessor/warning.md) and [Pragma directives and the `__pragma` and `_Pragma` keywords](../../preprocessor/pragma-directives-and-the-pragma-keyword.md). The [`/sdl` (Enable Additional Security Checks)](../../build/reference/sdl-enable-additional-security-checks.md) compiler option elevates this warning to an error. ## Examples -The following sample generates C4789. +The following example generates C4789: ```cpp // C4789.cpp @@ -63,7 +60,7 @@ int main() } ``` -The following sample also generates C4789. +The following example also generates C4789: ```cpp // C4789b.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4794.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4794.md index 909387c2dc9..fec3c297b94 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4794.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4794.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4794" title: "Compiler Warning (level 1) C4794" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4794" +ms.date: 11/04/2016 f1_keywords: ["C4794"] helpviewer_keywords: ["C4794"] -ms.assetid: badc9c36-fa1a-4fec-929b-7bfda7a7b79f --- # Compiler Warning (level 1) C4794 -segment of thread local storage variable 'variable' changed from 'section name' to '.tls$' +> segment of thread local storage variable 'variable' changed from 'section name' to '.tls$' + +## Remarks You used [#pragma data_seg](../../preprocessor/data-seg.md) to put a tls variable in a section not starting with .tls$. @@ -16,7 +17,7 @@ The .tls$*x* section will exist in the object file where [__declspec(thread)](.. ## Example -The following sample generates C4794: +The following example generates C4794: ```cpp // C4794.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4799.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4799.md index ec6ba0260ef..4de2401b823 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4799.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4799.md @@ -1,17 +1,37 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4799" title: "Compiler Warning (level 1) C4799" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4799" +ms.date: 03/28/2025 f1_keywords: ["C4799"] helpviewer_keywords: ["C4799"] -ms.assetid: 8ecbd06f-c778-4371-a2fb-c690b6743ec8 --- # Compiler Warning (level 1) C4799 -> No EMMS at end of function '*function*' +> function '*function*' has no EMMS instruction -The function has at least one MMX instruction, but does not have an `EMMS` instruction. When a multimedia instruction is used, an `EMMS` instruction or `_mm_empty` intrinsic should also be used to clear the multimedia tag word at the end of the MMX code. +## Remarks -You may get C4799 when using ivec.h, indicating that the code does not use properly execute the EMMS instruction before returning. This is a false warning for these headers. You may turn these off by defining _SILENCE_IVEC_C4799 in ivec.h. However, be aware that this will also keep the compiler from giving correct warnings of this type. +The function has at least one MMX instruction, but does not have an `EMMS` instruction. When a multimedia instruction is used, an `EMMS` instruction or [`_mm_empty`](https://www.intel.com/content/www/us/en/docs/intrinsics-guide/index.html#text=_mm_empty) intrinsic should also be used to clear the multimedia tag word at the end of the MMX code. + +You may get C4799 when using `ivec.h`, indicating that the code does not properly execute the `EMMS` instruction before returning. This is a false warning for these headers. You may turn these off by defining `_SILENCE_IVEC_C4799` in `ivec.h`. However, be aware that this will also keep the compiler from giving correct warnings of this type. For related information, see [Intel's MMX Instruction Set](../../assembler/inline/intel-s-mmx-instruction-set.md). + +## Example + +The following example generates C4799: + +```cpp +// C4799.cpp +// compile with: /W1 +// processor: x86 +#include + +int main() +{ + __m64 m = _mm_setzero_si64(); + + // Uncomment the following line to resolve the warning: + // _mm_empty(); +} // C4799 +``` diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4803.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4803.md index 8a242d9c74d..160cd494ab1 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4803.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4803.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4803" title: "Compiler Warning (level 1) C4803" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4803" +ms.date: 11/04/2016 f1_keywords: ["C4803"] helpviewer_keywords: ["C4803"] -ms.assetid: 2552f3a6-c418-49f4-98a2-a929857be658 --- # Compiler Warning (level 1) C4803 -'method' : the raise method has a different storage class from that of the event, 'event' +> 'method' : the raise method has a different storage class from that of the event, 'event' + +## Remarks Event methods must have the same storage class as the event declaration. The compiler adjusts the event's methods so that the storage classes are the same. @@ -18,7 +19,7 @@ See [warning](../../preprocessor/warning.md) pragma for information on how to tu ## Example -The following sample generates C4803. +The following example generates C4803. ```cpp // C4803.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4804.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4804.md index 3d6298288d6..a8d9c239b19 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4804.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4804.md @@ -1,20 +1,21 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4804" title: "Compiler Warning (level 1) C4804" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4804" +ms.date: 11/04/2016 f1_keywords: ["C4804"] helpviewer_keywords: ["C4804"] -ms.assetid: 069e8f44-3ef6-43bb-8524-4116fc6eea83 --- # Compiler Warning (level 1) C4804 -'operation' : unsafe use of type 'bool' in operation +> 'operation' : unsafe use of type 'bool' in operation + +## Remarks This warning is for when you used a **`bool`** variable or value in an unexpected way. For example, C4804 is generated if you use operators such as the negative unary operator (**-**) or the complement operator (`~`). The compiler evaluates the expression. ## Example -The following sample generates C4804: +The following example generates C4804: ```cpp // C4804.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4805.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4805.md index 02304303c4f..e85756333b8 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4805.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4805.md @@ -1,16 +1,21 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4805" title: "Compiler Warning (level 1) C4805" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4805" +ms.date: 11/04/2016 f1_keywords: ["C4805"] helpviewer_keywords: ["C4805"] -ms.assetid: 99c7b7e2-272e-4ab5-8580-17c42e62e2ef --- # Compiler Warning (level 1) C4805 -'operation' : unsafe mix of type 'type' and type 'type' in operation +> 'operation' : unsafe mix of type 'type' and type 'type' in operation + +## Remarks + +This warning is generated for comparison operations between [bool](../../cpp/bool-cpp.md) and [int](../../c-language/integer-types.md). + +## Example -This warning is generated for comparison operations between [bool](../../cpp/bool-cpp.md) and [int](../../c-language/integer-types.md). The following sample generates C4805: +The following example generates C4805: ```cpp // C4805.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4806.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4806.md index 276e5adc69e..a86050abde4 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4806.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4806.md @@ -1,16 +1,21 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4806" title: "Compiler Warning (level 1) C4806" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4806" +ms.date: 11/04/2016 f1_keywords: ["C4806"] helpviewer_keywords: ["C4806"] -ms.assetid: 79eb74cd-b925-4b5b-84e1-8ae6f33e38b3 --- # Compiler Warning (level 1) C4806 -'operation' : unsafe operation: no value of type 'type' promoted to type 'type' can equal the given constant +> 'operation' : unsafe operation: no value of type 'type' promoted to type 'type' can equal the given constant + +## Remarks + +This message warns against code such as `b == 3`, where `b` has type **`bool`**. The promotion rules cause **`bool`** to be promoted to **`int`**. This is legal, but it can never be **`true`**. + +## Example -This message warns against code such as `b == 3`, where `b` has type **`bool`**. The promotion rules cause **`bool`** to be promoted to **`int`**. This is legal, but it can never be **`true`**. The following sample generates C4806: +The following example generates C4806: ```cpp // C4806.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4807.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4807.md index 1bfb761d9af..9696970dd32 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4807.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4807.md @@ -1,20 +1,21 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4807" title: "Compiler Warning (level 1) C4807" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4807" +ms.date: 11/04/2016 f1_keywords: ["C4807"] helpviewer_keywords: ["C4807"] -ms.assetid: 089c9f87-fd81-402e-9826-66a8ef1ef1fe --- # Compiler Warning (level 1) C4807 -'operation' : unsafe mix of type 'type' and signed bitfield of type 'type' +> 'operation' : unsafe mix of type 'type' and signed bitfield of type 'type' + +## Remarks This warning is generated when comparing a one-bit signed bit field to a **`bool`** variable. Because a one-bit, signed bit field can only contain the values -1 or 0, it is dangerous to compare it to **`bool`**. No warnings are generated about mixing **`bool`** and one-bit, unsigned bitfields since they are identical to **`bool`** and can only hold 0 or 1. ## Example -The following sample generates C4807: +The following example generates C4807: ```cpp // C4807.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4810.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4810.md index 50bdb9be685..81d413dedb2 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4810.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4810.md @@ -1,17 +1,20 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4810" title: "Compiler Warning (level 1) C4810" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4810" +ms.date: 11/04/2016 f1_keywords: ["C4810"] helpviewer_keywords: ["C4810"] -ms.assetid: 39e2cae0-9c1c-4ac1-aaa0-5f661d06085b --- # Compiler Warning (level 1) C4810 -value of pragma pack(show) == n +> value of pragma pack(show) == n + +## Remarks This warning is issued when you use the **show** option of the [pack](../../preprocessor/pack.md) pragma. *n* is the current pack value. +## Example + For example, the following code shows how the C4810 warning works with the pack pragma: ```cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4811.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4811.md index 5a5797e5809..dc0f0521926 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4811.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4811.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4811" title: "Compiler Warning (level 1) C4811" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4811" +ms.date: 11/04/2016 f1_keywords: ["C4811"] helpviewer_keywords: ["C4811"] -ms.assetid: fbd79351-3dc1-45cf-b5b3-411f48c1590f --- # Compiler Warning (level 1) C4811 -value of pragma conform(forScope, show) == value +> value of pragma conform(forScope, show) == value + +## Remarks This warning is issued when you use the **show** option of the [conform](../../preprocessor/conform.md) pragma. *value* is the current conform value. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4812.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4812.md index 07221f45109..5c5d3d2394d 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4812.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4812.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4812" title: "Compiler Warning (level 1) C4812" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4812" +ms.date: 11/04/2016 f1_keywords: ["C4812"] helpviewer_keywords: ["C4812"] -ms.assetid: a7f5721f-2019-44de-ad62-ed30bac8b1f3 --- # Compiler Warning (level 1) C4812 -obsolete declaration style: please use 'new_syntax' instead +> obsolete declaration style: please use 'new_syntax' instead + +## Remarks In the current release of Visual C++, the explicit constructor specialization is still supported, but it may not be supported in a future release. -The following sample generates C4812: +## Example + +The following example generates C4812: ```cpp // C4812.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4813.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4813.md index 532b62c42aa..a2d30e711ae 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4813.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4813.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4813" title: "Compiler Warning (level 1) C4813" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4813" +ms.date: 11/04/2016 f1_keywords: ["C4813"] helpviewer_keywords: ["C4813"] -ms.assetid: c30bf877-ab04-4fe4-897e-8162092426f0 --- # Compiler Warning (level 1) C4813 -'function' : a friend function of a local class must have been previously declared +> 'function' : a friend function of a local class must have been previously declared + +## Remarks A friend function in an inner class was not declared in the outer class. -The following sample generates C4813: +## Example + +The following example generates C4813: ```cpp // C4813.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4817.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4817.md index 1bd7d8b68af..9273163849b 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4817.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4817.md @@ -1,20 +1,21 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4817" title: "Compiler Warning (level 1) C4817" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4817" +ms.date: 11/04/2016 f1_keywords: ["C4817"] helpviewer_keywords: ["C4817"] -ms.assetid: a68f5486-6940-4934-9f93-bfd4d71f92a9 --- # Compiler Warning (level 1) C4817 -'member' : illegal use of '.' to access this member; compiler replaced with '->' +> 'member' : illegal use of '.' to access this member; compiler replaced with '->' + +## Remarks The wrong member access operator was used. ## Example -The following sample generates C4817. +The following example generates C4817. ```cpp // C4817.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4819.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4819.md index 46f611babf6..a55bf43ca8c 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4819.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4819.md @@ -1,15 +1,16 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4819" title: "Compiler Warning (level 1) C4819" -ms.date: "04/08/2019" +description: "Learn more about: Compiler Warning (level 1) C4819" +ms.date: 04/08/2019 f1_keywords: ["C4819"] helpviewer_keywords: ["C4819"] -ms.assetid: c0316e85-249c-414d-9df0-622d077c6bc2 --- # Compiler Warning (level 1) C4819 > The file contains a character that cannot be represented in the current code page (*number*). Save the file in Unicode format to prevent data loss. +## Remarks + C4819 occurs when you compile an ANSI source file on a system using a codepage that can't represent all characters in the file. There are several ways to resolve C4819. One simple way is to remove the offending character, if you don't need it, for example, if it's in a comment. You can set the system codepage in the Control Panel to one that supports the character set used by your source code. You can use Unicode [escape sequences](../../c-language/escape-sequences.md) to create characters or strings that use only the basic ANSI character set in your source code. Finally, you can save the file in a Unicode format with a signature, also known as a byte-order mark (BOM). diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4821.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4821.md index 0cb5746cef3..fbd1d0e8f17 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4821.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4821.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4821" title: "Compiler Warning (level 1) C4821" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4821" +ms.date: 11/04/2016 f1_keywords: ["C4821"] helpviewer_keywords: ["C4821"] -ms.assetid: c7768e77-0ee5-491e-8aa4-3915bf5bcbdf --- # Compiler Warning (level 1) C4821 > Unable to determine Unicode encoding type, please save the file with signature (BOM) +## Remarks + The compiler could not determine the encoding type for a file. To resolve this warning, save the file with a byte order marker. See [Manage Files with Encoding](/sql/ssms/solution/manage-files-with-encoding) for more information. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4822.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4822.md index 51968a971dc..47a396a2d93 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4822.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4822.md @@ -1,14 +1,13 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4822" title: "Compiler Warning (level 1) C4822" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4822" +ms.date: 11/04/2016 f1_keywords: ["C4822"] helpviewer_keywords: ["C4822"] -ms.assetid: 0f231a30-2eb0-4722-aaa0-e2d19d3e7eea --- # Compiler Warning (level 1) C4822 -'member' : local class member function does not have a body +> 'member' : local class member function does not have a body ## Remarks @@ -20,7 +19,7 @@ In Visual Studio 2019 and later, C4822 is an [off-by-default](../../preprocessor ## Example -The following sample generates C4822: +The following example generates C4822: ```cpp // C4822.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4829.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4829.md index 42a6d4cced6..7b3a1ffe750 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4829.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4829.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4829" title: "Compiler Warning (level 1) C4829" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4829" +ms.date: 11/04/2016 f1_keywords: ["C4829"] helpviewer_keywords: ["C4829"] -ms.assetid: 4ffabe2b-2ddc-4c52-8564-d1355c93cfa6 --- # Compiler Warning (level 1) C4829 -Possibly incorrect parameters to function main. Consider 'intmain(Platform::Array\^ argv)' +> Possibly incorrect parameters to function main. Consider 'intmain(Platform::Array\^ argv)' + +## Remarks Certain functions, such as main, cannot take reference type parameters. While compilation will succeed, the resulting image will probably not run. -The following sample generates C4829: +## Example + +The following example generates C4829: ```cpp // C4829.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4835.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4835.md index 220089e424e..f3b67e23a05 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4835.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4835.md @@ -1,20 +1,21 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4835" title: "Compiler Warning (level 1) C4835" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4835" +ms.date: 11/04/2016 f1_keywords: ["C4835"] helpviewer_keywords: ["C4835"] -ms.assetid: d2e44c62-7b0e-4a45-943d-97903e27ed9d --- # Compiler Warning (level 1) C4835 -'variable' : the initializer for exported data will not be run until managed code is first executed in the host assembly +> 'variable' : the initializer for exported data will not be run until managed code is first executed in the host assembly + +## Remarks When accessing data between managed components, it is recommended that you not use native C++ import and export mechanisms. Instead, declare your data members inside a managed type and reference the metadata with `#using` in the client. For more information, see [#using Directive](../../preprocessor/hash-using-directive-cpp.md). ## Examples -The following sample generates C4835. +The following example generates C4835. ```cpp // C4835.cpp @@ -26,7 +27,7 @@ __declspec(dllexport) int m = f(); // C4835 __declspec(dllexport) int *p = &n; // C4835 ``` -The following sample consumes the component built in the previous sample, showing that the value of the variables is not as expected. +The following example consumes the component built in the previous example, showing that the value of the variables is not as expected. ```cpp // C4835_b.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4838.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4838.md index 0c5faf751c8..ed58e4bc6ab 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4838.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4838.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4838" title: "Compiler Warning (level 1) C4838" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4838" +ms.date: 11/04/2016 f1_keywords: ["C4838"] helpviewer_keywords: ["C4838"] -ms.assetid: fea07924-5feb-4ed4-99b5-1a8c41d28db6 --- # Compiler Warning (level 1) C4838 -conversion from 'type_1' to 'type_2' requires a narrowing conversion +> conversion from 'type_1' to 'type_2' requires a narrowing conversion + +## Remarks An implicit narrowing conversion was found when using aggregate or list initialization. @@ -16,7 +17,9 @@ The C language allows implicit narrowing conversions in assignments and initiali A narrowing conversion can be okay when you know the possible range of converted values can fit in the target. In this case, you know more than the compiler does. If you make a narrowing conversion intentionally, make your intentions explicit by using a static cast. Otherwise, this warning message almost always indicates that you have a bug in your code. You can fix it by making sure the objects you initialize have types that are large enough to handle the inputs. -The following sample generates C4838 and shows one way to fix it: +## Example + +The following example generates C4838 and shows one way to fix it: ```cpp // C4838.cpp -- C++ narrowing conversion diagnostics diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4900.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4900.md index 7ab98d4f470..9d0a5cc4187 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4900.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4900.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4900" title: "Compiler Warning (level 1) C4900" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4900" +ms.date: 11/04/2016 f1_keywords: ["C4900"] helpviewer_keywords: ["C4900"] -ms.assetid: 826997ec-0803-4794-ad35-bb463f679658 --- # Compiler Warning (level 1) C4900 -intermediate language mismatch between 'tool1' version 'version1' and 'tool2' version 'version2' +> intermediate language mismatch between 'tool1' version 'version1' and 'tool2' version 'version2' + +## Remarks The intermediate language used in *tool1* and *tool2* did not match. Check that the most current version of each tool has been installed. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4905.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4905.md index c8dd24cadec..43a136c259d 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4905.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4905.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4905" title: "Compiler Warning (level 1) C4905" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4905" +ms.date: 11/04/2016 f1_keywords: ["C4905"] helpviewer_keywords: ["C4905"] -ms.assetid: 40240bf4-b14e-4c22-aeb2-52f2851532f6 --- # Compiler Warning (level 1) C4905 -wide string literal cast to 'LPSTR' +> wide string literal cast to 'LPSTR' + +## Remarks The compiler detected an unsafe cast. The cast did succeed, but you should use a conversion routine. @@ -16,7 +17,7 @@ This warning is off by default. See [Compiler Warnings That Are Off by Default]( ## Example -The following sample generates C4905. +The following example generates C4905. ```cpp // C4905.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4906.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4906.md index 395fe28c5d5..8e2c92d2274 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4906.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4906.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4906" title: "Compiler Warning (level 1) C4906" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4906" +ms.date: 11/04/2016 f1_keywords: ["C4906"] helpviewer_keywords: ["C4906"] -ms.assetid: 05318e74-799b-412a-9dce-f02b8161d762 --- # Compiler Warning (level 1) C4906 -string literal cast to 'LPWSTR' +> string literal cast to 'LPWSTR' + +## Remarks The compiler detected an unsafe cast. The cast did succeed, but you should use a conversion routine. @@ -16,7 +17,7 @@ This warning is off by default. See [Compiler Warnings That Are Off by Default]( ## Example -The following sample generates C4906: +The following example generates C4906: ```cpp // C4906.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4910.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4910.md index b923b43d27e..588f5372c28 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4910.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4910.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4910" title: "Compiler Warning (level 1) C4910" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4910" +ms.date: 11/04/2016 f1_keywords: ["C4910"] helpviewer_keywords: ["C4910"] -ms.assetid: 67963560-fbca-4ca7-93db-06beaf7055f0 --- # Compiler Warning (level 1) C4910 -'\' : '__declspec(dllexport)' and 'extern' are incompatible on an explicit instantiation +> '\' : '__declspec(dllexport)' and 'extern' are incompatible on an explicit instantiation + +## Remarks The explicit template instantiation named *\* is modified by both the `__declspec(dllexport)` and **`extern`** keywords. However, these keywords are mutually exclusive. The `__declspec(dllexport)` keyword means instantiate the template class, while the **`extern`** keyword means do not automatically instantiate the template class. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4912.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4912.md index fbaf6ce0afc..1bfd258713c 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4912.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4912.md @@ -1,17 +1,20 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4912" title: "Compiler Warning (level 1) C4912" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4912" +ms.date: 11/04/2016 f1_keywords: ["C4912"] helpviewer_keywords: ["C4912"] -ms.assetid: ba1f1a66-8c20-4792-9ac8-43e49f729ae2 --- # Compiler Warning (level 1) C4912 -'attribute': attribute has undefined behavior on a nested UDT +> 'attribute': attribute has undefined behavior on a nested UDT + +## Remarks Attributes that apply to nested UDTs (user-defined type, which could be a typedef, union, or struct) may be ignored. +## Example + The following code shows how this warning would be generated: ```cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4917.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4917.md index e0be915a7cf..5174941c517 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4917.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4917.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4917" title: "Compiler Warning (level 1) C4917" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4917" +ms.date: 11/04/2016 f1_keywords: ["C4917"] helpviewer_keywords: ["C4917"] -ms.assetid: c05e2610-4a5d-4f4b-a99b-c15fd7f1d5f1 --- # Compiler Warning (level 1) C4917 -'declarator' : a GUID can only be associated with a class, interface or namespace +> 'declarator' : a GUID can only be associated with a class, interface or namespace + +## Remarks A user-defined structure other than [class](../../cpp/class-cpp.md), [interface](../../cpp/interface.md), or [namespace](../../cpp/namespaces-cpp.md) cannot have a GUID. @@ -16,7 +17,7 @@ This warning is off by default. See [Compiler Warnings That Are Off by Default]( ## Example -The following code sample generates C4917: +The following code example generates C4917: ```cpp // C4917.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4920.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4920.md index dc1fc90aba8..cd04ce20506 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4920.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4920.md @@ -1,17 +1,20 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4920" title: "Compiler Warning (level 1) C4920" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4920" +ms.date: 11/04/2016 f1_keywords: ["C4920"] helpviewer_keywords: ["C4920"] -ms.assetid: 1e501f2e-93c1-4d27-a4fa-54fc86271ae7 --- # Compiler Warning (level 1) C4920 -enum enum member member=value already seen in enum enum as member=value +> enum enum member member=value already seen in enum enum as member=value + +## Remarks If a .tlb that you pass to #import has the same symbol defined in two or more enums, this warning indicates that subsequent identical symbols are ignored and will be commented out in the .tlh file. +## Example + Assuming a .tlb that contains: ``` @@ -27,7 +30,7 @@ library MyLib }; ``` -the following samples generates C4920, +the following example generates C4920, ```cpp // C4920.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4925.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4925.md index fefc0eea093..70e1c27766b 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4925.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4925.md @@ -1,20 +1,23 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4925" title: "Compiler Warning (level 1) C4925" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4925" +ms.date: 11/04/2016 f1_keywords: ["C4925"] helpviewer_keywords: ["C4925"] -ms.assetid: a4b206c0-016a-4f28-873a-bb8bb41bad50 --- # Compiler Warning (level 1) C4925 -'method': dispinterface method cannot be called from script +> 'method': dispinterface method cannot be called from script + +## Remarks Scripting languages cannot create a VT_BYREF 'in' parameter, it can only create VT_BYREF 'out' parameters. Another way to resolve this warning is not make the parameter (in the definition and implementation) a pointer type. -The following sample generates C4925: +## Example + +The following example generates C4925: ```cpp // C4925.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4926.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4926.md index e1b980f6b58..2ef1c363482 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4926.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4926.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4926" title: "Compiler Warning (level 1) C4926" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4926" +ms.date: 11/04/2016 f1_keywords: ["C4926"] helpviewer_keywords: ["C4926"] -ms.assetid: 5717fce0-146f-4ef2-bde0-e9a01c0922d1 --- # Compiler Warning (level 1) C4926 -'identifier': symbol is already defined: attributes ignored +> 'identifier': symbol is already defined: attributes ignored + +## Remarks A forward declaration was found but an attributed construct with the same name already exists. The attributes for the forward declaration are ignored. -The following sample generates C4926: +## Example + +The following example generates C4926: ```cpp // C4926.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4927.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4927.md index 1edc84ab0e3..97680f685f0 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4927.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4927.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4927" title: "Compiler Warning (level 1) C4927" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4927" +ms.date: 11/04/2016 f1_keywords: ["C4927"] helpviewer_keywords: ["C4927"] -ms.assetid: 7009e740-a2ef-4130-96ba-482e092f717a --- # Compiler Warning (level 1) C4927 -illegal conversion; more than one user-defined conversion has been implicitly applied +> illegal conversion; more than one user-defined conversion has been implicitly applied + +## Remarks More than one user-defined conversion is implicitly applied to a single value -- the compiler did not find an explicit conversion but did find a conversion, which it used. -The following sample generates C4927: +## Example + +The following example generates C4927: ```cpp // C4927.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4928.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4928.md index 2842251ec40..7ad37a31713 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4928.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4928.md @@ -1,20 +1,23 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4928" title: "Compiler Warning (level 1) C4928" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4928" +ms.date: 11/04/2016 f1_keywords: ["C4928"] helpviewer_keywords: ["C4928"] -ms.assetid: 77235d7f-9360-45cb-8348-d148c605c4a3 --- # Compiler Warning (level 1) C4928 -illegal copy-initialization; more than one user-defined conversion has been implicitly applied +> illegal copy-initialization; more than one user-defined conversion has been implicitly applied + +## Remarks More than one user-defined conversion routine was found. The compiler executed the code in all such routines. This warning is off by default. See [Compiler Warnings That Are Off by Default](../../preprocessor/compiler-warnings-that-are-off-by-default.md) for more information. -The following sample generates C4928: +## Example + +The following example generates C4928: ```cpp // C4928.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4929.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4929.md index 96e3168e904..0914856a997 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4929.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4929.md @@ -1,20 +1,21 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4929" title: "Compiler Warning (level 1) C4929" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4929" +ms.date: 11/04/2016 f1_keywords: ["C4929"] helpviewer_keywords: ["C4929"] -ms.assetid: 95f8ab4f-4468-4caa-acd5-8f4592f03b3c --- # Compiler Warning (level 1) C4929 -'file': typelibrary contains a union; ignoring the 'embedded_idl' qualifier +> 'file': typelibrary contains a union; ignoring the 'embedded_idl' qualifier + +## Remarks The embedded_idl attribute of [#import](../../preprocessor/hash-import-directive-cpp.md) could not be applied to the type library because a union is present in the type library. To resolve this warning, don't use embedded_idl. -## Examples +## Example -The following sample defines a component. +The following example defines a component. ```cpp // C4929a.cpp @@ -46,7 +47,7 @@ struct C : I { }; ``` -The following sample generates C4929. +The following example generates C4929. ```cpp // C4929b.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4930.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4930.md index 7d708e9b826..261fff84ad3 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4930.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4930.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4930" title: "Compiler Warning (level 1) C4930" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4930" +ms.date: 11/04/2016 f1_keywords: ["C4930"] helpviewer_keywords: ["C4930"] -ms.assetid: 89a206c9-c536-4186-8e81-1cde3e7f4f5b --- # Compiler Warning (level 1) C4930 -'prototype': prototyped function not called (was a variable definition intended?) +> 'prototype': prototyped function not called (was a variable definition intended?) + +## Remarks The compiler detected an unused function prototype. If the prototype was intended as a variable declaration, remove the open/close parentheses. -The following sample generates C4930: +## Examples + +The following example generates C4930: ```cpp // C4930.cpp @@ -34,7 +37,7 @@ int main() { C4930 can also occur when the compiler cannot distinguish between a function prototype declaration and a function call. -The following sample generates C4930: +The following example generates C4930: ```cpp // C4930b.cpp @@ -105,4 +108,4 @@ int main() } ``` -In the above sample, the result of a method that takes zero arguments is passed as an argument to the constructor of an unnamed local class variable. The call can be disambiguated by either naming the local variable or prefixing the method call with an object instance along with the appropriate pointer-to-member operator. +In the above example, the result of a method that takes zero arguments is passed as an argument to the constructor of an unnamed local class variable. The call can be disambiguated by either naming the local variable or prefixing the method call with an object instance along with the appropriate pointer-to-member operator. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4935.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4935.md index 09fadd7e4d9..a37cde7e6c5 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4935.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4935.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4935" title: "Compiler Warning (level 1) C4935" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4935" +ms.date: 11/04/2016 f1_keywords: ["C4935"] helpviewer_keywords: ["C4935"] -ms.assetid: a36c56d3-571a-44dd-bb0f-bcc6b020e134 --- # Compiler Warning (level 1) C4935 -assembly access specifier modified from 'access' +> assembly access specifier modified from 'access' + +## Remarks The assembly visibility of a type was modified. The compiler uses the last specifier that it encounters. For example, the assembly visibility of a forward declaration may be different from the assembly visibility of the class definition. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4939.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4939.md index 97fffd379e0..4568b2300b1 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4939.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4939.md @@ -1,20 +1,21 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4939" title: "Compiler Warning (level 1) C4939" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4939" +ms.date: 11/04/2016 f1_keywords: ["C4939"] helpviewer_keywords: ["C4939"] -ms.assetid: 07096008-ba47-436c-a84c-2b03ad90d0b3 --- # Compiler Warning (level 1) C4939 -\#pragma vtordisp is deprecated and will be removed in a future release of Visual C++ +> #pragma vtordisp is deprecated and will be removed in a future release of Visual C++ + +## Remarks The [vtordisp](../../preprocessor/vtordisp.md) pragma will be removed in a future release of Visual C++. ## Example -The following sample generates C4939. +The following example generates C4939. ```cpp // C4939.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4944.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4944.md index ab27de2d54f..6d314e924af 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4944.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4944.md @@ -1,20 +1,21 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4944" title: "Compiler Warning (level 1) C4944" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4944" +ms.date: 11/04/2016 f1_keywords: ["C4944"] helpviewer_keywords: ["C4944"] -ms.assetid: e2905eb1-2e3b-4fab-a48b-c0cae0fd997f --- # Compiler Warning (level 1) C4944 -'symbol' : cannot import symbol from 'assembly1': as 'symbol' already exists in the current scope +> 'symbol' : cannot import symbol from 'assembly1': as 'symbol' already exists in the current scope + +## Remarks A symbol was defined in a source code file and then a #using statement referenced an assembly that also defined the symbol. The symbol in the assembly is ignored. -## Examples +## Example -The following sample creates a component with a type called ClassA. +The following example creates a component with a type called ClassA. ```csharp // C4944.cs @@ -25,7 +26,7 @@ public class ClassA { } ``` -The following samples generate C4944. +The following example generate C4944. ```cpp // C4944b.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4945.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4945.md index 501700a2582..8b96288228f 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4945.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4945.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4945" title: "Compiler Warning (level 1) C4945" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4945" +ms.date: 11/04/2016 f1_keywords: ["C4945"] helpviewer_keywords: ["C4945"] -ms.assetid: 6d2079ea-dc59-4611-bc68-9a22c06f7587 --- # Compiler Warning (level 1) C4945 -'symbol' : cannot import symbol from 'assembly2': as 'symbol' has already been imported from another assembly 'assembly1' +> 'symbol' : cannot import symbol from 'assembly2': as 'symbol' has already been imported from another assembly 'assembly1' + +## Remarks A symbol was imported from a referenced assembly but that symbol was already imported from another referenced assembly. Either do not reference one of the assemblies or get the symbol name changed in one of the assemblies. -The following samples generate C4945. +## Example + +The following example generate C4945. ```csharp // C4945a.cs diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4946.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4946.md index 2ef397abc1c..284b2424ac7 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4946.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4946.md @@ -1,19 +1,22 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4946" title: "Compiler Warning (level 1) C4946" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4946" +ms.date: 11/04/2016 f1_keywords: ["C4946"] helpviewer_keywords: ["C4946"] -ms.assetid: b85cbef0-e053-4de6-9b14-7b0f82d40495 --- # Compiler Warning (level 1) C4946 -reinterpret_cast used between related classes: 'class1' and 'class2' +> reinterpret_cast used between related classes: 'class1' and 'class2' + +## Remarks Do not use [reinterpret_cast](../../cpp/reinterpret-cast-operator.md) to cast between related types. Use [static_cast](../../cpp/static-cast-operator.md) instead, or for polymorphic types, use [dynamic_cast](../../cpp/dynamic-cast-operator.md). By default, this warning is off. For more information, see [Compiler Warnings That Are Off by Default](../../preprocessor/compiler-warnings-that-are-off-by-default.md). +## Example + The following code example generates C4946: ```cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4947.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4947.md index 84cfafa4c9c..db09f0cf6ad 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4947.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4947.md @@ -1,20 +1,21 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4947" title: "Compiler Warning (level 1) C4947" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4947" +ms.date: 11/04/2016 f1_keywords: ["C4947"] helpviewer_keywords: ["C4947"] -ms.assetid: 5a1d484e-b4c7-4de2-a145-d8dcfc2fc1d2 --- # Compiler Warning (level 1) C4947 -'type_or_member' : marked as obsolete +> 'type_or_member' : marked as obsolete + +## Remarks A member or type was marked as obsolete with the class. ## Example -The following sample generates C4947: +The following example generates C4947: ```cpp // C4947.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4951.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4951.md index ed00316f198..a9b0be26170 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4951.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4951.md @@ -1,15 +1,16 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4951" title: "Compiler Warning (level 1) C4951" -ms.date: "08/27/2018" +description: "Learn more about: Compiler Warning (level 1) C4951" +ms.date: 08/27/2018 f1_keywords: ["C4951"] helpviewer_keywords: ["C4951"] -ms.assetid: 669d8bb7-5efa-4ba9-99db-4e65addbf054 --- # Compiler Warning (level 1) C4951 > '*function*' has been edited since profile data was collected, function profile data not used +## Remarks + A function has been edited in an input module to [/LTCG:PGUPDATE](../../build/reference/ltcg-link-time-code-generation.md), so that the profile data is now not valid. The input module was recompiled after **/LTCG:PGINSTRUMENT** and has a function (*function*) with a different flow of control than was in the module at the time of the **/LTCG:PGINSTRUMENT** operation. This warning is informational. To resolve this warning, run **/LTCG:PGINSTRUMENT**, redo all test runs, and run **/LTCG:PGOPTIMIZE**. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4952.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4952.md index 5ad02204e02..fbf7a1a79f8 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4952.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4952.md @@ -1,15 +1,16 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4952" title: "Compiler Warning (level 1) C4952" -ms.date: "08/27/2018" +description: "Learn more about: Compiler Warning (level 1) C4952" +ms.date: 08/27/2018 f1_keywords: ["C4952"] helpviewer_keywords: ["C4952"] -ms.assetid: 593324f0-5cfe-42fb-b221-2f71308765dd --- # Compiler Warning (level 1) C4952 > '*function*' : no profile data found in program database '*pgd_file*' +## Remarks + When using [/LTCG:PGUPDATE](../../build/reference/ltcg-link-time-code-generation.md), the compiler detected an input module that was recompiled after `/LTCG:PGINSTRUMENT` and has a new function (*function*) present. This warning is informational. To resolve this warning, run `/LTCG:PGINSTRUMENT`, redo all test runs, and run `/LTCG:PGOPTIMIZE`. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4953.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4953.md index 4f6f49e7184..4fb025030e8 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4953.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4953.md @@ -1,15 +1,16 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4953" title: "Compiler Warning (level 1) C4953" -ms.date: "08/27/2018" +description: "Learn more about: Compiler Warning (level 1) C4953" +ms.date: 08/27/2018 f1_keywords: ["C4953"] helpviewer_keywords: ["C4953"] -ms.assetid: 3c4f6ac6-3976-41ab-8a27-3c41d7472ea7 --- # Compiler Warning (level 1) C4953 > Inlinee '*function*' has been edited since profile data was collected, profile data not used +## Remarks + When using [/LTCG:PGUPDATE](../../build/reference/ltcg-link-time-code-generation.md), the compiler detected an input module that was recompiled after `/LTCG:PGINSTRUMENT` and has a function (*function*) that was edited and where existing test runs identified the function as a candidate for inlining. However, as a result of recompiling the module, the function will no longer be a candidate for inlining. This warning is informational. To resolve this warning, run `/LTCG:PGINSTRUMENT`, redo all test runs, and run `/LTCG:PGOPTIMIZE`. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4964.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4964.md index e97a33d9184..9eb7097fa26 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4964.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4964.md @@ -1,20 +1,23 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4964" title: "Compiler Warning (level 1) C4964" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4964" +ms.date: 11/04/2016 f1_keywords: ["C4964"] helpviewer_keywords: ["C4964"] -ms.assetid: b89c9274-8a92-4b7c-aa30-3fbb1b68ac73 --- # Compiler Warning (level 1) C4964 -No optimization options were specified; profile info will not be collected +> No optimization options were specified; profile info will not be collected + +## Remarks [/GL](../../build/reference/gl-whole-program-optimization.md) and [/LTCG](../../build/reference/ltcg-link-time-code-generation.md) were specified, but no optimizations were requested, so no .pgc files will be generated and, therefore, no profile-guided optimizations will be possible. If you want .pgc files to be generated when you run your application, specify one of the [/O](../../build/reference/o-options-optimize-code.md) compiler options. -The following sample generates C4964: +## Example + +The following example generates C4964: ```cpp // C4964.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4965.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4965.md index b7f9f1365af..384ae158bc3 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4965.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4965.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4965" title: "Compiler Warning (level 1) C4965" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4965" +ms.date: 11/04/2016 f1_keywords: ["C4965"] helpviewer_keywords: ["C4965"] -ms.assetid: 47f3f6dc-459b-4a25-9947-f394c8966cb5 --- # Compiler Warning (level 1) C4965 -implicit box of integer 0; use nullptr or explicit cast +> implicit box of integer 0; use nullptr or explicit cast + +## Remarks Visual C++ features implicit boxing of value types. An instruction that resulted in a null assignment using Managed Extensions for C++ now becomes an assignment to a boxed int. @@ -16,7 +17,7 @@ For more information, see [Boxing](../../extensions/boxing-cpp-component-extensi ## Example -The following sample generates C4965. +The following example generates C4965. ```cpp // C4965.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4997.md b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4997.md index 22694be7d30..2741b6f61ef 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4997.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-1-c4997.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Warning (level 1) C4997" title: "Compiler Warning (level 1) C4997" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1) C4997" +ms.date: 11/04/2016 f1_keywords: ["C4997"] helpviewer_keywords: ["C4997"] -ms.assetid: d39678fd-0c1a-4104-8a45-9e3f20de0407 --- # Compiler Warning (level 1) C4997 -'class': coclass does not implement a COM interface or pseudo-interface +> 'class': coclass does not implement a COM interface or pseudo-interface + +## Remarks A class marked with the [coclass](../../windows/attributes/coclass.md) attribute did not implement an interface. -The following sample generates C4997: +## Example + +The following example generates C4997: ```cpp // C4997.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4007.md b/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4007.md index 336918d5ce0..b9e5c6c8da4 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4007.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4007.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: Compiler Warning (level 3) C4007" title: "Compiler Warning (level 3) C4007" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 3) C4007" +ms.date: 11/04/2016 f1_keywords: ["C4007"] helpviewer_keywords: ["C4007"] --- @@ -9,4 +9,6 @@ helpviewer_keywords: ["C4007"] > '*function*': must be '*attribute*' +## Remarks + A required attribute for a function isn't explicitly stated. For example, the function `main` must have the `__cdecl` attribute. The compiler forces the attribute. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4051.md b/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4051.md index d512d8c5c57..8d405b80739 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4051.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4051.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Warning (level 2) C4051" title: "Compiler Warning (level 2) C4051" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 2) C4051" +ms.date: 11/04/2016 f1_keywords: ["C4051"] helpviewer_keywords: ["C4051"] -ms.assetid: 8c964e70-df12-45ff-93b9-496ad4271191 --- # Compiler Warning (level 2) C4051 -type conversion; possible loss of data +> type conversion; possible loss of data + +## Remarks An expression contains two data items with different base types. Converting one type causes the data item to be truncated. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4056.md b/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4056.md index e619ad2ebb1..f327965b82d 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4056.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4056.md @@ -1,20 +1,23 @@ --- -description: "Learn more about: Compiler Warning (level 2) C4056" title: "Compiler Warning (level 2) C4056" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 2) C4056" +ms.date: 11/04/2016 f1_keywords: ["C4056"] helpviewer_keywords: ["C4056"] -ms.assetid: a3c3a9b8-ec30-452d-96cb-3694adcce789 --- # Compiler Warning (level 2) C4056 -overflow in floating point constant arithmetic +> overflow in floating point constant arithmetic + +## Remarks Floating-point constant arithmetic generates a result that exceeds the maximum allowable value. This warning can be caused by compiler optimizations performed during constant arithmetic. You can safely ignore this warning if it goes away when you turn off optimization ([/Od](../../build/reference/od-disable-debug.md)). -The following sample generates C4056: +## Example + +The following example generates C4056: ```cpp // C4056.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4094.md b/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4094.md index fe8f42e4001..aa4ef8419c3 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4094.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4094.md @@ -1,19 +1,22 @@ --- -description: "Learn more about: Compiler Warning (level 2) C4094" title: "Compiler Warning (level 2) C4094" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 2) C4094" +ms.date: 11/04/2016 f1_keywords: ["C4094"] helpviewer_keywords: ["C4094"] -ms.assetid: e68929fb-3a1c-4be7-920b-d5f79f534f99 --- # Compiler Warning (level 2) C4094 -untagged 'token' declared no symbols +> untagged 'token' declared no symbols + +## Remarks The compiler detected an empty declaration using an untagged structure, union, or class. The declaration is ignored. ## Example +The following example generates C4094: + ```cpp // C4094.cpp // compile with: /W2 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4099.md b/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4099.md index 40fd5f19018..1739a47480f 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4099.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4099.md @@ -1,24 +1,25 @@ --- -description: "Learn more about: Compiler Warning (level 2) C4099" title: "Compiler Warning (level 2) C4099" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 2) C4099" +ms.date: 11/04/2016 f1_keywords: ["C4099"] helpviewer_keywords: ["C4099"] -ms.assetid: 00bb803d-cae7-4ab8-8969-b46f54139ac8 --- # Compiler Warning (level 2) C4099 -'identifier' : type name first seen using 'objecttype1' now seen using 'objecttype2' +> '*identifier*': type name first seen using '*object_type1*' now seen using '*object_type2*' + +## Remarks An object declared as a structure is defined as a class, or an object declared as a class is defined as a structure. The compiler uses the type given in the definition. ## Example -The following sample generates C4099. +The following example generates C4099. ```cpp // C4099.cpp // compile with: /W2 /c struct A; -class A {}; // C4099, use different identifer or use same object type +class A {}; // C4099, use different identifier or use same object type ``` diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4146.md b/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4146.md index 3540ce83ae8..42ff1e16f22 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4146.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4146.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: Compiler warning (level 2) C4146" title: "Compiler warning (level 2) C4146" -ms.date: 08/30/2022 +description: "Learn more about: Compiler warning (level 2) C4146" +ms.date: 04/22/2025 f1_keywords: ["C4146"] helpviewer_keywords: ["C4146"] --- @@ -9,27 +9,26 @@ helpviewer_keywords: ["C4146"] > unary minus operator applied to unsigned type, result still unsigned -Unsigned types can hold only non-negative values, so unary minus (negation) usually doesn't make sense when applied to an unsigned type. Both the operand and the result are non-negative. - ## Remarks -When you express a negative integer literal, the **`-`** in front of the value is parsed as a [unary negation](../../cpp/unary-plus-and-negation-operators-plus-and.md) operator. The compiler applies the operator after it parses the numeric value. If the numeric value fits in the range of an unsigned integer type, but not the corresponding signed integer type, the compiler interprets the value as unsigned. An unsigned value is unchanged by the unary negation operator. +Unsigned types only hold non-negative values. So unary minus (negation) usually doesn't make sense when applied to an unsigned type. Both the operand and the result are non-negative. -This warning often occurs when you try to express the minimum **`int`** value, -2147483648, or the minimum **`long long`** value, -9223372036854775808. These values can't be written as -2147483648 or -9223372036854775808ll, respectively. The reason is because the compiler processes the expression in two stages: first, it parses the numeric value, then it applies the negation operator. For example, when the compiler parses -2147483648, it follows these steps: +When you express a negative integer literal, the **`-`** in front of the value is parsed as a [unary negation](../../cpp/unary-plus-and-negation-operators-plus-and.md) operator. The compiler applies the operator after it parses the numeric value. If the numeric value fits in the range of an unsigned integer type, but not the corresponding signed integer type, the compiler interprets the value as unsigned. -1. The number 2147483648 is evaluated. Because it's greater than the maximum **`int`** value of 2147483647, but still fits in an **`unsigned int`**, the type of 2147483648 is **`unsigned int`**. +This warning often occurs when you try to express the minimum **`int`** value, -2147483648, or the minimum **`long long`** value, -9223372036854775808. These values can't be written as -2147483648 or -9223372036854775808ll. The reason is because the compiler processes the expression in two stages: first, it parses the numeric value, then it applies the negation operator. For example, when the compiler parses -2147483648, it follows these steps: +1. The number 2147483648 is evaluated. Because it's greater than the maximum **`int`** value of 2147483647, but still fits in an **`unsigned int`**, the type of 2147483648 is **`unsigned int`**. 1. Unary minus is applied to the unsigned value, with an unsigned result, which also happens to be 2147483648. The unsigned type of the result can cause unexpected behavior. If the result is used in a comparison, then an unsigned comparison might be used, for example, when the other operand is an **`int`**. -You can avoid C4146 by using `INT_MIN` or `LLONG_MIN` from *``* or the C++ equivalent, *``*. These values have signed types. +You can avoid **C4146** by using `INT_MIN` or `LLONG_MIN` from *``* or the C++ equivalent, *``*. These values have signed types. The [`/sdl` (Enable Additional Security Checks)](../../build/reference/sdl-enable-additional-security-checks.md) compiler option elevates this warning to an error. ## Example -The following sample demonstrates the unexpected behavior that can happen when the compiler generates warning C4146: +The following example demonstrates the unexpected behavior that can happen when the compiler generates warning C4146: ```cpp // C4146.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4150.md b/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4150.md index 9d0fbe858c0..4e373271a61 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4150.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4150.md @@ -1,7 +1,7 @@ --- +title: "Compiler warning (level 2) C4150" description: "Learn more about: Compiler Warning (level 2) C4150" -title: Compiler warning (level 2) C4150 -ms.date: "11/04/2016" +ms.date: 11/04/2016 f1_keywords: ["C4150"] helpviewer_keywords: ["C4150"] --- @@ -9,11 +9,13 @@ helpviewer_keywords: ["C4150"] > deletion of pointer to incomplete type 'type'; no destructor called +## Remarks + The `delete` operator is called to delete a type that was declared but not defined. The compiler can't find the destructor to call because the definition isn't in the same translation unit as the `delete`. ## Example -The following sample generates C4150 by declaring but not defining `class IncClass`: +The following example generates C4150 by declaring but not defining `class IncClass`: ```cpp // compile with: /W2 @@ -75,7 +77,6 @@ void NoDestruct( IncClass* pIncClass ) { delete pIncClass; } - ``` ## See also diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4156.md b/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4156.md index c2b9d9baa66..c72e3d2f1da 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4156.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4156.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Warning (level 2) C4156" title: "Compiler Warning (level 2) C4156" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 2) C4156" +ms.date: 11/04/2016 f1_keywords: ["C4156"] helpviewer_keywords: ["C4156"] -ms.assetid: 9adf3acb-c0fe-42a8-a4db-5822b1493f77 --- # Compiler Warning (level 2) C4156 -deletion of an array expression without using the array form of 'delete'; array form substituted +> deletion of an array expression without using the array form of 'delete'; array form substituted + +## Remarks The non-array form of **`delete`** cannot delete an array. The compiler translated **`delete`** to the array form. @@ -16,6 +17,8 @@ This warning occurs only under Microsoft extensions (/Ze). ## Example +The following example generates C4156: + ```cpp // C4156.cpp // compile with: /W2 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4244.md b/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4244.md index f1b15944392..e2c76f5572e 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4244.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4244.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Warning (level 2) C4244" title: "Compiler Warning (level 2) C4244" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 2) C4244" +ms.date: 11/04/2016 f1_keywords: ["C4244"] helpviewer_keywords: ["C4244"] -ms.assetid: 2c19d157-21d1-42c2-a6c0-3f30f2ce3813 --- # Compiler Warning (level 2) C4244 -'argument' : conversion from 'type1' to 'type2', possible loss of data +> 'argument' : conversion from 'type1' to 'type2', possible loss of data + +## Remarks A floating point type was converted to an integer type. A possible loss of data may have occurred. @@ -18,7 +19,7 @@ C4244 can also fire at level 3, and 4; see [Compiler Warning (levels 3 and 4) C4 ## Example -The following sample generates C4244: +The following example generates C4244: ```cpp // C4244_level2.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4250.md b/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4250.md index 3ec69fa0134..b42f61f058e 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4250.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4250.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Warning (level 2) C4250" title: "Compiler Warning (level 2) C4250" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 2) C4250" +ms.date: 11/04/2016 f1_keywords: ["C4250"] helpviewer_keywords: ["C4250"] -ms.assetid: d47f7249-6b5a-414b-b2d4-56e5d246a782 --- # Compiler Warning (level 2) C4250 -'class1' : inherits 'class2::member' via dominance +> 'class1' : inherits 'class2::member' via dominance + +## Remarks Two or more members have the same name. The one in `class2` is inherited because it is a base class for the other classes that contained this member. @@ -18,6 +19,8 @@ Because a virtual base class is shared among multiple derived classes, a name in ## Examples +The following example generates C4250: + ```cpp // C4250.cpp // compile with: /c /W2 @@ -40,7 +43,7 @@ int main() { } ``` -The following sample generates C4250. +The following example generates C4250. ```cpp // C4250_b.cpp @@ -71,7 +74,7 @@ int main() { } ``` -This sample shows a more complex situation. The following sample generates C4250. +This example shows a more complex situation. The following example generates C4250. ```cpp // C4250_c.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4275.md b/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4275.md index cd48f23132a..1488b7a2b6d 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4275.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4275.md @@ -1,15 +1,16 @@ --- -description: "Learn more about: Compiler Warning (level 2) C4275" title: "Compiler Warning (level 2) C4275" -ms.date: "02/08/2019" +description: "Learn more about: Compiler Warning (level 2) C4275" +ms.date: 02/08/2019 f1_keywords: ["C4275"] helpviewer_keywords: ["C4275"] -ms.assetid: 18de967a-0a44-4dbc-a2e8-fc4c067ba909 --- # Compiler Warning (level 2) C4275 > non - DLL-interface class '*class_1*' used as base for DLL-interface class '*class_2*' +## Remarks + An exported class was derived from a class that wasn't exported. To minimize the possibility of data corruption when exporting a class with [__declspec(dllexport)](../../cpp/dllexport-dllimport.md), make sure that: @@ -28,6 +29,10 @@ You can avoid exporting classes by defining a DLL that defines a class with virt C4275 can be ignored in Visual C++ if you are deriving from a type in the C++ Standard Library, compiling a debug release (**/MTd**) and where the compiler error message refers to `_Container_base`. +## Example + +The following example generates C4275: + ```cpp // C4275.cpp // compile with: /EHsc /MTd /W2 /c diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4285.md b/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4285.md index 7b65391add0..dec38cac563 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4285.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4285.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Warning (level 2) C4285" title: "Compiler Warning (level 2) C4285" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 2) C4285" +ms.date: 11/04/2016 f1_keywords: ["C4285"] helpviewer_keywords: ["C4285"] -ms.assetid: fa14de1f-fc19-4eec-8bea-81003636e12f --- # Compiler Warning (level 2) C4285 -return type for 'identifier::operator ->' is recursive if applied using infix notation +> return type for 'identifier::operator ->' is recursive if applied using infix notation + +## Remarks The specified **operator->()** function cannot return the type for which it is defined or a reference to the type for which it is defined. -The following sample generates C4285: +## Example + +The following example generates C4285: ```cpp // C4285.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4302.md b/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4302.md index 92c0d2d4556..9631ebfbff3 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4302.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4302.md @@ -1,20 +1,23 @@ --- -description: "Learn more about: Compiler Warning (level 2) C4302" title: "Compiler Warning (level 2) C4302" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 2) C4302" +ms.date: 11/04/2016 f1_keywords: ["C4302"] helpviewer_keywords: ["C4302"] -ms.assetid: f5e1c939-e134-4cca-ba1e-9b15a81549ae --- # Compiler Warning (level 2) C4302 -'conversion' : truncation from 'type 1' to 'type 2' +> 'conversion' : truncation from 'type 1' to 'type 2' + +## Remarks The compiler detected a conversion from a larger type to a smaller type. Information may be lost. This warning is off by default. See [Compiler Warnings That Are Off by Default](../../preprocessor/compiler-warnings-that-are-off-by-default.md) for more information. -The following sample generates C4302: +## Example + +The following example generates C4302: ```cpp // C4302.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4307.md b/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4307.md index c2561f469e3..8dffb8c1508 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4307.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4307.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Warning (level 2) C4307" title: "Compiler Warning (level 2) C4307" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 2) C4307" +ms.date: 11/04/2016 f1_keywords: ["C4307"] helpviewer_keywords: ["C4307"] -ms.assetid: 7cca11e9-be61-49e4-8b15-88b84f0cbf07 --- # Compiler Warning (level 2) C4307 -'operator' : signed integral constant overflow +> 'operator' : signed integral constant overflow + +## Remarks The operator is used in an expression that results in an integer constant overflowing the space allocated for it. You may need to use a larger type for the constant. A **`signed int`** holds a smaller value than an **`unsigned int`** because the **`signed int`** uses one bit to represent the sign. -The following sample generates C4307: +## Example + +The following example generates C4307: ```cpp // C4307.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4308.md b/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4308.md index 0f1b82759f9..10ca720e0fa 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4308.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4308.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 2) C4308" title: "Compiler Warning (level 2) C4308" +description: "Learn more about: Compiler Warning (level 2) C4308" ms.date: 08/30/2022 f1_keywords: ["C4308"] helpviewer_keywords: ["C4308"] -ms.assetid: d4e5c53c-71b2-4bbc-8a7c-3a2a3180d9d9 --- # Compiler Warning (level 2) C4308 @@ -18,6 +17,8 @@ The [`/sdl` (Enable Additional Security Checks)](../../build/reference/sdl-enabl ## Example +The following example generates C4308: + ```cpp // C4308.cpp // compile with: /W2 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4309.md b/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4309.md index 5ae796582c4..fecac92eab3 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4309.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4309.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Warning (level 2) C4309" title: "Compiler Warning (level 2) C4309" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 2) C4309" +ms.date: 11/04/2016 f1_keywords: ["C4309"] helpviewer_keywords: ["C4309"] -ms.assetid: cb3f41ef-fd8a-4def-baa1-924e751fca68 --- # Compiler Warning (level 2) C4309 -'conversion' : truncation of constant value +> 'conversion' : truncation of constant value + +## Remarks The type conversion causes a constant to exceed the space allocated for it. You may need to use a larger type for the constant. -The following sample generates C4309: +## Example + +The following example generates C4309: ```cpp // C4309.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4356.md b/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4356.md index 9134afc4376..1b77d903071 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4356.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4356.md @@ -1,20 +1,23 @@ --- -description: "Learn more about: Compiler Warning (level 2) C4356" title: "Compiler Warning (level 2) C4356" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 2) C4356" +ms.date: 11/04/2016 f1_keywords: ["C4356"] helpviewer_keywords: ["C4356"] -ms.assetid: 3af3defe-de33-43b6-bd6c-2c2e09e34f3f --- # Compiler Warning (level 2) C4356 -'member' : static data member cannot be initialized via derived class +> 'member' : static data member cannot be initialized via derived class + +## Remarks The initialization of a static data member was ill formed. The compiler accepted the initialization. To avoid the warning, initialize the member through the base class. Use the [warning](../../preprocessor/warning.md) pragma to suppress this warning. -The following sample generates C4356: +## Example + +The following example generates C4356: ```cpp // C4356.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4396.md b/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4396.md index e4306463bc4..5bb56d3be8f 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4396.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4396.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Warning (level 2) C4396" title: "Compiler Warning (level 2) C4396" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 2) C4396" +ms.date: 11/04/2016 f1_keywords: ["C4396"] helpviewer_keywords: ["C4396"] -ms.assetid: 7cd6b283-db17-4574-b299-03e0b913ad70 --- # Compiler Warning (level 2) C4396 -"name" : the inline specifier cannot be used when a friend declaration refers to a specialization of a function template +> "name" : the inline specifier cannot be used when a friend declaration refers to a specialization of a function template + +## Remarks A specialization of a function template cannot specify any of the [inline](../../cpp/inline-functions-cpp.md) specifiers. The compiler issues warning C4396 and ignores the inline specifier. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4412.md b/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4412.md index 2c6d5bb4fa7..a8072422312 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4412.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4412.md @@ -1,35 +1,33 @@ --- -description: "Learn more about: Compiler Warning (level 2) C4412" -title: "Compiler Warning (level 2) C4412" -ms.date: "11/04/2016" +title: "Compiler warning (level 2, off) C4412" +description: "Learn more about: Compiler Warning (level 2, off) C4412" +ms.date: 1/22/2025 f1_keywords: ["C4412"] helpviewer_keywords: ["C4412"] -ms.assetid: f28dc531-1a98-497b-a366-0a13e1bc81c7 --- -# Compiler Warning (level 2) C4412 +# Compiler warning (level 2, off) C4412 -> '*function*' : function signature contains type '*type*'; C++ objects are unsafe to pass between pure code and mixed or native. +> '*function*': function signature contains type '*type*'; C++ objects are unsafe to pass between pure code and mixed or native. ## Remarks -The **/clr:pure** compiler option is deprecated in Visual Studio 2015 and unsupported in Visual Studio 2017. If you have code that needs to be pure, we recommend that you port it to C#. +The `/clr:pure` compiler option is deprecated in Visual Studio 2015, and unsupported starting in Visual Studio 2017. If you have code that needs to be CLR pure, we recommend that you port it to C#. -The compiler detected a potentially unsafe situation that could result in a runtime error: a call is being made from a **/clr:pure** compiland to a function that was imported via dllimport and the function signature contains an unsafe type. A type is unsafe if it contains a member function or has a data member that is an unsafe type or an indirection to an unsafe type. +The compiler detected a potentially unsafe situation that could result in a runtime error: a call is being made from code compiled with `/clr:pure` to a function imported via `dllimport`, and the function signature contains an unsafe type. A type is unsafe if it contains a member function or has a data member that is an unsafe type or an indirection to an unsafe type. -This is unsafe because of the difference in the default calling conventions between pure and native code (or mixed native and managed). When importing (via `dllimport`) a function into a **/clr:pure** compiland, ensure that the declarations of each type in the signature are identical to those in the compiland that exports the function (being especially careful about differences in implicit calling conventions). +This pattern is unsafe because of the difference in the default calling conventions between pure and native code (or mixed native and managed). When importing a function via `dllimport` into code compiled with `/clr:pure`, ensure that the declarations of each type in the signature are identical to the signature in the compiland that exports the function (being especially careful about differences in implicit calling conventions). -A virtual member function is especially prone to give unexpected results. However, even a non-virtual function should be tested to ensure that you get the correct results. If you are sure that you are getting the correct results, you can ignore this warning. +A virtual member function is especially prone to give unexpected results. However, even a nonvirtual function should be tested to ensure that you get the correct results. This warning can be ignored once you ensure the result is correct. -C4412 is off by default. See [Compiler Warnings That Are Off by Default](../../preprocessor/compiler-warnings-that-are-off-by-default.md) and [dllexport, dllimport](../../cpp/dllexport-dllimport.md) for more information. +C4412 is off by default. For more information, see [Compiler Warnings That Are Off by Default](../../preprocessor/compiler-warnings-that-are-off-by-default.md) and [`dllexport`, `dllimport`](../../cpp/dllexport-dllimport.md). To resolve this warning, remove all functions from the type. ## Examples -The following sample generates C4412. +The following example generates C4412: ```cpp -// C4412.cpp // compile with: /c /W2 /clr:pure #pragma warning (default : 4412) @@ -52,7 +50,7 @@ int main() { } ``` -The following sample is a header file that declares two types. The `Unsafe` type is unsafe because it has a member function. +The following example is a header file that declares two types. The `Unsafe` type is unsafe because it has a member function: ```cpp // C4412.h @@ -70,7 +68,7 @@ struct Safe { }; ``` -This sample exports functions with the types defined in the header file. +This example exports functions with the types defined in the header file: ```cpp // C4412_2.cpp @@ -85,9 +83,9 @@ __declspec(dllexport) Unsafe * __cdecl func() { return new Unsafe; } __declspec(dllexport) Safe * __cdecl func2() { return new Safe; } ``` -The default calling convention in a **/clr:pure** compilation is different from a native compilation. When C4412.h is included, `Test` defaults to `__clrcall`. If you compile and run this program (do not use **/c**), the program will throw an exception. +The default calling convention in a `/clr:pure` compilation is different from a native compilation. When `C4412.h` is included, `Test` defaults to `__clrcall`. -The following sample generates C4412. +The following example generates C4412 and throws an exception at runtime: ```cpp // C4412_3.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4653.md b/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4653.md index f731d8824bb..45fc49654bb 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4653.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4653.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Warning (level 2) C4653" title: "Compiler Warning (level 2) C4653" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 2) C4653" +ms.date: 11/04/2016 f1_keywords: ["C4653"] helpviewer_keywords: ["C4653"] -ms.assetid: 90ec3317-3d39-4b4c-bcd1-97e7c799e1b6 --- # Compiler Warning (level 2) C4653 -compiler option 'option' inconsistent with precompiled header; current command-line option ignored +> compiler option 'option' inconsistent with precompiled header; current command-line option ignored + +## Remarks An option specified with the Use Precompiled Headers ([/Yu](../../build/reference/yu-use-precompiled-header-file.md)) option was inconsistent with the options specified when the precompiled header was created. This compilation used the option specified when the precompiled header was created. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4756.md b/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4756.md index 41c25723109..1e61db8e9b8 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4756.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4756.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Warning (level 2) C4756" title: "Compiler Warning (level 2) C4756" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 2) C4756" +ms.date: 11/04/2016 f1_keywords: ["C4756"] helpviewer_keywords: ["C4756"] -ms.assetid: 5a16df83-6b82-4619-83bd-319af4ef1d1d --- # Compiler Warning (level 2) C4756 -overflow in constant arithmetic +> overflow in constant arithmetic + +## Remarks The compiler generated an exception while doing constant arithmetic during compilation. -The following sample generates C4756: +## Example + +The following example generates C4756: ```cpp // C4756.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4948.md b/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4948.md index 26347529fbf..0fb05310069 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4948.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-2-c4948.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Warning (level 2) C4948" title: "Compiler Warning (level 2) C4948" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 2) C4948" +ms.date: 11/04/2016 f1_keywords: ["C4948"] helpviewer_keywords: ["C4948"] -ms.assetid: d006cb17-754a-4c70-ba7f-c3200e2cd8fa --- # Compiler Warning (level 2) C4948 -return type of 'accessor' does not match the last parameter type of the corresponding setter +> return type of 'accessor' does not match the last parameter type of the corresponding setter + +## Remarks The compiler found a mismatch between what data type is being get and set for an indexed property. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4013.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4013.md index 599a4caf8d4..d31e60b7584 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4013.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4013.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Warning (level 3) C4013" title: "Compiler Warning (level 3) C4013" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 3) C4013" +ms.date: 11/04/2016 f1_keywords: ["C4013"] helpviewer_keywords: ["C4013"] -ms.assetid: 9f9afc71-6e78-463d-9d66-3012d6a3cd5d --- # Compiler Warning (level 3) C4013 -'function' undefined; assuming extern returning int +> 'function' undefined; assuming extern returning int + +## Remarks The compiler encountered a call to an undefined function. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4018.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4018.md index 9dd5d2ec50a..83dab0c48c0 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4018.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4018.md @@ -9,15 +9,15 @@ helpviewer_keywords: ["C4018"] > '*token*' : signed/unsigned mismatch -Using the *token* operator to compare **`signed`** and **`unsigned`** numbers required the compiler to convert the **`signed`** value to **`unsigned`**. - ## Remarks +Using the *token* operator to compare **`signed`** and **`unsigned`** numbers required the compiler to convert the **`signed`** value to **`unsigned`**. + One way to fix this warning is if you cast one of the two types when you compare **`signed`** and **`unsigned`** types. ## Example -This sample generates C4018 and shows how to fix it: +This example generates C4018 and shows how to fix it: ```cpp // C4018.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4023.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4023.md index af8177c4fa2..f11f88a5ed2 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4023.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4023.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Warning (level 3) C4023" title: "Compiler Warning (level 3) C4023" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 3) C4023" +ms.date: 11/04/2016 f1_keywords: ["C4023"] helpviewer_keywords: ["C4023"] -ms.assetid: 615d5374-d7c1-42eb-acfd-917c053270c8 --- # Compiler Warning (level 3) C4023 -'symbol' : based pointer passed to unprototyped function : parameter number +> 'symbol' : based pointer passed to unprototyped function : parameter number + +## Remarks Passing a based pointer to an unprototyped function causes the pointer to be normalized, with unpredictable results. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4066.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4066.md index 11ddd3399f2..3fcd48bfc7d 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4066.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4066.md @@ -1,16 +1,22 @@ --- -description: "Learn more about: Compiler Warning (level 3) C4066" title: "Compiler Warning (level 3) C4066" -ms.date: "03/06/2024" +description: "Learn more about: Compiler Warning (level 3) C4066" +ms.date: 03/06/2024 f1_keywords: ["C4066"] helpviewer_keywords: ["C4066"] --- # Compiler Warning (level 3) C4066 -characters beyond first in wide-character constant ignored +> characters beyond first in wide-character constant ignored + +## Remarks The compiler processes only the first character of a wide-character constant. +## Example + +The following example generates C4066: + ```cpp // C4066.cpp // compile with: /W3 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4073.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4073.md index 18ebb50854c..eb4beeba089 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4073.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4073.md @@ -1,16 +1,21 @@ --- -description: "Learn more about: Compiler Warning (level 3) C4073" title: "Compiler Warning (level 3) C4073" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 3) C4073" +ms.date: 11/04/2016 f1_keywords: ["C4073"] helpviewer_keywords: ["C4073"] -ms.assetid: 50081a6e-6acd-45ff-8484-9b1ea926cc5c --- # Compiler Warning (level 3) C4073 -initializers put in library initialization area +> initializers put in library initialization area + +## Remarks + +Only third-party library developers should use the library initialization area, which is specified by [#pragma init_seg](../../preprocessor/init-seg.md). + +## Example -Only third-party library developers should use the library initialization area, which is specified by [#pragma init_seg](../../preprocessor/init-seg.md). The following sample generates C4073: +The following example generates C4073: ```cpp // C4073.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4101.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4101.md index 3199f6c3e53..bf61764db50 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4101.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4101.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: Compiler Warning (level 3 and level 4) C4101" title: "Compiler Warning (level 3 and level 4) C4101" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 3 and level 4) C4101" +ms.date: 11/04/2016 f1_keywords: ["C4101"] helpviewer_keywords: ["C4101"] --- @@ -9,7 +9,13 @@ helpviewer_keywords: ["C4101"] > '*identifier*': unreferenced local variable -The local variable is never used. This warning occurs in the obvious situation: +## Remarks + +The local variable is never used. + +## Examples + +This warning occurs in the obvious situation: ```cpp // C4101a.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4102.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4102.md index 379c3a7b12b..63b13fa15f5 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4102.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4102.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Warning (level 3) C4102" title: "Compiler Warning (level 3) C4102" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 3) C4102" +ms.date: 11/04/2016 f1_keywords: ["C4102"] helpviewer_keywords: ["C4102"] -ms.assetid: 349f308a-daf3-48c6-bd53-6c38b73f8880 --- # Compiler Warning (level 3) C4102 -'label' : unreferenced label +> 'label' : unreferenced label + +## Remarks The label is defined but never referenced. The compiler ignores the label. -The following sample generates C4102: +## Example + +The following example generates C4102: ```cpp // C4102.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4133.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4133.md index 48a818c0f07..adfd70c3826 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4133.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4133.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: Compiler Warning (level 1 and level 3) C4133" title: "Compiler Warning (level 1 and level 3) C4133" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1 and level 3) C4133" +ms.date: 11/04/2016 f1_keywords: ["C4133"] helpviewer_keywords: ["C4133"] --- @@ -9,6 +9,8 @@ helpviewer_keywords: ["C4133"] > '*expression*': incompatible types - from '*type1*' to '*type2*' +## Remarks + This warning is emitted when incompatible types are used in an expression. For example, doing arithmetic operations such as subtraction with different pointer types. To avoid this warning, provide an appropriate type cast. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4159.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4159.md index 6f6a163564f..74670b18999 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4159.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4159.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 3) C4159" title: "Compiler Warning (level 3) C4159" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 3) C4159" +ms.date: 11/04/2016 f1_keywords: ["C4159"] helpviewer_keywords: ["C4159"] -ms.assetid: e2cf964e-f4b8-4b2c-9569-1abb94307232 --- # Compiler Warning (level 3) C4159 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4161.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4161.md index c38bf184951..672a08b13f6 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4161.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4161.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 3) C4161" title: "Compiler Warning (level 3) C4161" -ms.date: "08/27/2018" +description: "Learn more about: Compiler Warning (level 3) C4161" +ms.date: 08/27/2018 f1_keywords: ["C4161"] helpviewer_keywords: ["C4161"] -ms.assetid: 03d3be61-83f1-4009-8310-8758ab67055f --- # Compiler Warning (level 3) C4161 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4191.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4191.md index fc3a8e001ca..db68e28e735 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4191.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4191.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: Compiler Warning (level 3, off) C4191" title: "Compiler Warning (level 3, off) C4191" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 3, off) C4191" +ms.date: 11/04/2016 f1_keywords: ["C4191"] helpviewer_keywords: ["C4191"] --- @@ -9,6 +9,8 @@ helpviewer_keywords: ["C4191"] > '*operation*': unsafe conversion from '*type_of_expression*' to '*type_required*'
Making a function call using the resulting pointer may cause your program to fail +## Remarks + Several operations involving function pointers are considered unsafe: - Function types with different calling conventions. @@ -27,7 +29,9 @@ Calling this function through the result pointer might cause your program to cra This warning is off by default. For more information, see [Compiler Warnings That Are Off by Default](../../preprocessor/compiler-warnings-that-are-off-by-default.md). -The following sample generates C4191: +## Example + +The following example generates C4191: ```cpp // C4191.cpp @@ -46,5 +50,5 @@ int main() { fnptr1 fp3 = (fnptr1) &f2; // C4191 fnptr2 fp4 = (fnptr2) &f1; // C4191 -}; +} ``` diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4192.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4192.md index 83450512bc4..c02e74aba58 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4192.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4192.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Warning (level 3) C4192" title: "Compiler Warning (level 3) C4192" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 3) C4192" +ms.date: 11/04/2016 f1_keywords: ["C4192"] helpviewer_keywords: ["C4192"] -ms.assetid: ea5f91fa-8c96-4f3f-ac42-0c8a86d4e5df --- # Compiler Warning (level 3) C4192 -automatically excluding 'name' while importing type library 'library' +> automatically excluding 'name' while importing type library 'library' + +## Remarks A `#import` library contains an item, *name*, that is also defined in the Win32 system headers. Due to limitations of type libraries, names such as **IUnknown** or GUID are often defined in a type library, duplicating the definition from the system headers. `#import` will detect these items and refuse to incorporate them in the .tlh and .tli header files. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4197.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4197.md index d6fb5bfb8b8..4fabcf299da 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4197.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4197.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Warning (level 3) C4197" title: "Compiler Warning (level 3) C4197" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 3) C4197" +ms.date: 11/04/2016 f1_keywords: ["C4197"] helpviewer_keywords: ["C4197"] -ms.assetid: f766feef-82b0-4d81-8a65-33628c7db196 --- # Compiler Warning (level 3) C4197 -'type' : top-level volatile in cast is ignored +> 'type' : top-level volatile in cast is ignored + +## Remarks The compiler detected a cast to an r-value type which is qualified with [volatile](../../cpp/volatile-cpp.md), or a cast of an r-value type to some type that is qualified with volatile. According to the C standard (6.5.3), properties associated with qualified types are meaningful only for l-value expressions. -The following sample generates C4197: +## Example + +The following example generates C4197: ```cpp // C4197.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4240.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4240.md index 66fc798b058..529f6f70f31 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4240.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4240.md @@ -1,19 +1,22 @@ --- -description: "Learn more about: Compiler Warning (level 3) C4240" title: "Compiler Warning (level 3) C4240" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 3) C4240" +ms.date: 11/04/2016 f1_keywords: ["C4240"] helpviewer_keywords: ["C4240"] -ms.assetid: a2657cdb-18e1-493f-882b-4e10c0bca71d --- # Compiler Warning (level 3) C4240 -nonstandard extension used : access to 'classname' now defined to be 'access specifier', previously it was defined to be 'access specifier' +> nonstandard extension used : access to 'classname' now defined to be 'access specifier', previously it was defined to be 'access specifier' + +## Remarks Under ANSI compatibility ([/Za](../../build/reference/za-ze-disable-language-extensions.md)), you cannot change the access to a nested class. Under the default Microsoft extensions (/Ze), you can, with this warning. ## Example +The following example generates C4240: + ```cpp // C4240.cpp // compile with: /W3 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4243.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4243.md index ea6813c8f3a..6b8dd2c801f 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4243.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4243.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Warning (level 3) C4243" title: "Compiler Warning (level 3) C4243" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 3) C4243" +ms.date: 11/04/2016 f1_keywords: ["C4243"] helpviewer_keywords: ["C4243"] -ms.assetid: ca72f9ad-ce0b-43a9-a68c-106e1f8b90ef --- # Compiler Warning (level 3) C4243 -'conversion type' conversion exists from 'type1' to 'type2', but is inaccessible +> 'conversion type' conversion exists from 'type1' to 'type2', but is inaccessible + +## Remarks A pointer to a derived class is converted to a pointer to a base class, but the derived class inherits the base class with private or protected access. -The following sample generates C4243: +## Example + +The following example generates C4243: ```cpp // C4243.cpp @@ -21,7 +24,7 @@ The following sample generates C4243: struct B { int f() { return 0; - }; + } }; struct D : private B {}; diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4265.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4265.md index fa20cef8113..7fecde7c7ef 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4265.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4265.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: Compiler Warning (level 3, off) C4265" title: "Compiler Warning (level 3, off) C4265" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 3, off) C4265" +ms.date: 11/04/2016 f1_keywords: ["C4265"] helpviewer_keywords: ["C4265"] --- @@ -9,11 +9,15 @@ helpviewer_keywords: ["C4265"] > '*classname*': class has virtual functions, but its non-trivial destructor is not virtual; instances of this class may not be destructed correctly +## Remarks + When a class has virtual functions but a nonvirtual destructor, objects of the type might not be destroyed properly when the class is destroyed through a base class pointer. This warning is off by default. For more information, see [Compiler Warnings That Are Off by Default](../../preprocessor/compiler-warnings-that-are-off-by-default.md). -The following sample generates C4265: +## Example + +The following example generates C4265: ```cpp // C4265.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4267.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4267.md index bca3c8da4a9..3b6989d6744 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4267.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4267.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Warning (level 3) C4267" title: "Compiler Warning (level 3) C4267" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 3) C4267" +ms.date: 11/04/2016 f1_keywords: ["C4267"] helpviewer_keywords: ["C4267"] -ms.assetid: 2fa2f13f-fa4f-47bb-ad8f-6cb19cfc91e6 --- # Compiler Warning (level 3) C4267 -'var' : conversion from 'size_t' to 'type', possible loss of data +> 'var' : conversion from 'size_t' to 'type', possible loss of data + +## Remarks The compiler detected a conversion from `size_t` to a smaller type. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4278.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4278.md index 464d6497f33..86dd293c9a9 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4278.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4278.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: Compiler Warning (level 3 and level 4) C4278" title: "Compiler Warning (level 3 and level 4) C4278" -ms.date: "08/27/2018" +description: "Learn more about: Compiler Warning (level 3 and level 4) C4278" +ms.date: 08/27/2018 f1_keywords: ["C4278"] helpviewer_keywords: ["C4278"] --- @@ -9,4 +9,6 @@ helpviewer_keywords: ["C4278"] > '*identifier*': identifier in type library '*tlb*' is already a macro; use the 'rename' qualifier +## Remarks + The [`#import`](../../preprocessor/hash-import-directive-cpp.md) is attempting to import an identifier into the translation unit. However, there's already a symbol with that name. Use the `#import` **rename** attribute to assign an alias to the symbol in the type library. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4280.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4280.md index 09130a82582..4ae40b56b8b 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4280.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4280.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Warning (level 3) C4280" title: "Compiler Warning (level 3) C4280" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 3) C4280" +ms.date: 11/04/2016 f1_keywords: ["C4280"] helpviewer_keywords: ["C4280"] -ms.assetid: 153fb639-3ee1-4fee-baf9-71420abcf3f6 --- # Compiler Warning (level 3) C4280 -'operator ->' was self recursive through type 'type' +> 'operator ->' was self recursive through type 'type' + +## Remarks Your code incorrectly allows **operator->** to call itself. -The following sample generates C4280: +## Example + +The following example generates C4280: ```cpp // C4280.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4281.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4281.md index 02df9c778a9..9426d177374 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4281.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4281.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Warning (level 3) C4281" title: "Compiler Warning (level 3) C4281" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 3) C4281" +ms.date: 11/04/2016 f1_keywords: ["C4281"] helpviewer_keywords: ["C4281"] -ms.assetid: a9771261-5725-4fc6-87b6-16cf92113a25 --- # Compiler Warning (level 3) C4281 -'operator ->' recursion occurred through type 'type' +> 'operator ->' recursion occurred through type 'type' + +## Remarks Your code allows **operator->** to call itself. -The following sample generates C4281: +## Example + +The following example generates C4281: ```cpp // C4281.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4282.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4282.md index 151121d5b21..397b03cdf2a 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4282.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4282.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Compiler Warning (level 3) C4282" title: "Compiler Warning (level 3) C4282" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 3) C4282" +ms.date: 11/04/2016 f1_keywords: ["C4282"] helpviewer_keywords: ["C4282"] -ms.assetid: 155bef24-7bd1-497b-a24b-4a0d784b44cd --- # Compiler Warning (level 3) C4282 -then through type 'type' +> then through type 'type' + +## Remarks This continuation of warning C4281shows that **operator->** calls itself through `type`. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4283.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4283.md index 0e2d86ccf6e..98f9c84badd 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4283.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4283.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Compiler Warning (level 3) C4283" title: "Compiler Warning (level 3) C4283" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 3) C4283" +ms.date: 11/04/2016 f1_keywords: ["C4283"] helpviewer_keywords: ["C4283"] -ms.assetid: c8823f1f-e746-42e2-85ef-270745764c05 --- # Compiler Warning (level 3) C4283 -and through type 'type' +> and through type 'type' + +## Remarks This continuation of warning [C4281](../../error-messages/compiler-warnings/compiler-warning-level-3-c4281.md) shows that **operator->** calls itself through `type`. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4287.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4287.md index 989066bb6b0..99d48f7475c 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4287.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4287.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: Compiler Warning (level 3, off) C4287" title: "Compiler Warning (level 3, off) C4287" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 3, off) C4287" +ms.date: 11/04/2016 f1_keywords: ["C4287"] helpviewer_keywords: ["C4287"] --- @@ -9,13 +9,15 @@ helpviewer_keywords: ["C4287"] > 'operator' : unsigned/negative constant mismatch +## Remarks + An unsigned variable was used in an operation with a negative number. This warning is off by default. For more information, see [Compiler Warnings That Are Off by Default](../../preprocessor/compiler-warnings-that-are-off-by-default.md). ## Example -The following sample generates C4287: +The following example generates C4287: ```cpp // C4287.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4290.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4290.md index aaa839fdef3..ad2acf66d4e 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4290.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4290.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Warning (level 3) C4290" title: "Compiler Warning (level 3) C4290" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 3) C4290" +ms.date: 11/04/2016 f1_keywords: ["C4290"] helpviewer_keywords: ["C4290"] -ms.assetid: d1c6d85b-28e0-4a1f-9d48-23593337a6fb --- # Compiler Warning (level 3) C4290 -C++ exception specification ignored except to indicate a function is not __declspec(nothrow) +> C++ exception specification ignored except to indicate a function is not __declspec(nothrow) + +## Remarks A function is declared using exception specification, which Visual C++ accepts but does not implement. Code with exception specifications that are ignored during compilation may need to be recompiled and linked to be reused in future versions supporting exception specifications. @@ -20,7 +21,9 @@ You can avoid this warning by using the [warning](../../preprocessor/warning.md) #pragma warning( disable : 4290 ) ``` -The following code sample generates C4290: +## Example + +The following example generates C4290: ```cpp // C4290.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4306.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4306.md index 0e334e644ec..aba692f1c11 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4306.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4306.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: Compiler Warning (level 4) C4306" title: "Compiler Warning (level 4) C4306" -ms.date: "08/27/2018" +description: "Learn more about: Compiler Warning (level 4) C4306" +ms.date: 08/27/2018 f1_keywords: ["C4306"] helpviewer_keywords: ["C4306"] --- @@ -9,6 +9,8 @@ helpviewer_keywords: ["C4306"] > '*conversion*': conversion from '*type1*' to '*type2*' of greater size +## Remarks + The identifier is type cast to a larger pointer. The unfilled high bits of the new type are zero-filled. This warning may indicate an unwanted conversion. The resulting pointer may not be valid. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4310.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4310.md index 97a146b5766..f929a873d2b 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4310.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4310.md @@ -1,6 +1,6 @@ --- -description: "Learn more about: Compiler Warning (level 4) C4310" title: "Compiler Warning (level 4) C4310" +description: "Learn more about: Compiler Warning (level 4) C4310" ms.date: 10/17/2023 f1_keywords: ["C4310"] helpviewer_keywords: ["C4310"] @@ -9,7 +9,13 @@ helpviewer_keywords: ["C4310"] > cast truncates constant value -A constant value is cast to a smaller type. The compiler performs the cast, which truncates data. The following sample generates C4310: +## Remarks + +A constant value is cast to a smaller type. The compiler performs the cast, which truncates data. + +## Example + +The following example generates C4310: ```cpp // C4310.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4316.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4316.md index 5094e9de73e..984e7f71f21 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4316.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4316.md @@ -1,16 +1,21 @@ --- title: "Compiler Warning (level 3) C4316" description: "Description of C++ compiler warning C4316" -ms.date: "11/04/2016" +ms.date: 11/04/2016 f1_keywords: ["C4316"] helpviewer_keywords: ["C4316"] -ms.assetid: 10371f01-aeb8-40ac-a290-59e63efa5ad4 --- # Compiler Warning (level 3) C4316 -Object allocated on the heap may not be aligned for this type. +> Object allocated on the heap may not be aligned for this type. -An over-aligned object allocated by using `operator new` may not have the specified alignment. Override [operator new](../../c-runtime-library/new-operator-crt.md) and [operator delete](../../c-runtime-library/delete-operator-crt.md) for over-aligned types so that they use the aligned allocation routines—for example, [_aligned_malloc](../../c-runtime-library/reference/aligned-malloc.md) and [_aligned_free](../../c-runtime-library/reference/aligned-free.md). The following sample generates C4316: +## Remarks + +An over-aligned object allocated by using `operator new` may not have the specified alignment. Override [operator new](../../c-runtime-library/new-operator-crt.md) and [operator delete](../../c-runtime-library/delete-operator-crt.md) for over-aligned types so that they use the aligned allocation routines—for example, [_aligned_malloc](../../c-runtime-library/reference/aligned-malloc.md) and [_aligned_free](../../c-runtime-library/reference/aligned-free.md). + +## Example + +The following example generates C4316: ```cpp // C4316.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4334.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4334.md index 7b3c4b482cf..6c410d831f7 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4334.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4334.md @@ -1,20 +1,21 @@ --- -description: "Learn more about: Compiler Warning (level 3) C4334" title: "Compiler Warning (level 3) C4334" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 3) C4334" +ms.date: 11/04/2016 f1_keywords: ["C4334"] helpviewer_keywords: ["C4334"] -ms.assetid: d845857f-bc95-4faf-a079-626a0cf935ba --- # Compiler Warning (level 3) C4334 -'operator': result of 32-bit shift implicitly converted to 64 bits (was 64-bit shift intended?) +> 'operator': result of 32-bit shift implicitly converted to 64 bits (was 64-bit shift intended?) + +## Remarks The result of 32-bit shift was converted to 64-bit, and the compiler suspects that a 64-bit shift was intended. Resolve this warning by using a 64-bit shift. If a 32-bit shift is intentional, then cast the shift result to 32-bit to make it clear to the compiler. ## Example -The following sample generates C4334. +The following example generates C4334. ```cpp // C4334.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4357.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4357.md index 008ffaca3b8..6e2208ff1fb 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4357.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4357.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Warning (level 3) C4357" title: "Compiler Warning (level 3) C4357" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 3) C4357" +ms.date: 11/04/2016 f1_keywords: ["C4357"] helpviewer_keywords: ["C4357"] -ms.assetid: 9259c633-3c02-4900-b94a-2d8d366d61cd --- # Compiler Warning (level 3) C4357 -param array argument in formal argument list for delegate 'del' ignored when generating 'function' +> param array argument in formal argument list for delegate 'del' ignored when generating 'function' + +## Remarks The `ParamArray` attribute was ignored, and `function` cannot be called with variable arguments. -The following sample generates C4357: +## Example + +The following example generates C4357: ```cpp // C4357.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4359.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4359.md index 1323cb6fe50..7058b2598e2 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4359.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4359.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: Compiler Warning (level 1 and level 3) C4359" title: "Compiler Warning (level 1 and level 3) C4359" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1 and level 3) C4359" +ms.date: 11/04/2016 f1_keywords: ["C4359"] helpviewer_keywords: ["C4359"] --- @@ -9,11 +9,13 @@ helpviewer_keywords: ["C4359"] > 'type': actual alignment (8) is greater than the value specified in __declspec(align()) +## Remarks + The alignment specified for a type is less than the alignment of the type of one of its data members. For more information, see [align](../../cpp/align-cpp.md). ## Example -The following sample generates C4359. +The following example generates C4359. ```cpp // C4359.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4373.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4373.md index 4bcae673036..1394a4e481f 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4373.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4373.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: Compiler Warning (level 4) C4373" title: "Compiler Warning (level 4) C4373" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 4) C4373" +ms.date: 11/04/2016 f1_keywords: ["C4373"] helpviewer_keywords: ["C4373"] --- @@ -21,7 +21,7 @@ The following code example generates warning C4373. To resolve this issue, make ```cpp // c4373.cpp -// compile with: /c /W3 +// compile with: /c /W4 #include struct Base { diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4390.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4390.md index 813df6cac74..6ed88b3ea82 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4390.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4390.md @@ -1,20 +1,23 @@ --- -description: "Learn more about: Compiler Warning (level 3) C4390" title: "Compiler Warning (level 3) C4390" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 3) C4390" +ms.date: 11/04/2016 f1_keywords: ["C4390"] helpviewer_keywords: ["C4390"] -ms.assetid: c95c2f1b-9bce-4b1f-a80c-565d4cde0b1e --- # Compiler Warning (level 3) C4390 -';' : empty controlled statement found; is this the intent? +> ';' : empty controlled statement found; is this the intent? + +## Remarks A semicolon was found after a control statement that contains no instructions. If you get C4390 because of a macro, you should use the [warning](../../preprocessor/warning.md) pragma to disable C4390 in the module containing the macro. -The following sample generates C4390: +## Example + +The following example generates C4390: ```cpp // C4390.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4398.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4398.md index 394219283d5..fd2f161dca1 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4398.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4398.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 3) C4398" title: "Compiler Warning (level 3) C4398" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 3) C4398" +ms.date: 11/04/2016 f1_keywords: ["C4398"] helpviewer_keywords: ["C4398"] -ms.assetid: b6221432-9fed-4272-a547-a73f587904e6 --- # Compiler Warning (level 3) C4398 @@ -20,7 +19,7 @@ For more information, see [appdomain](../../cpp/appdomain.md) and [Application D ## Example -The following sample generates C4398. +The following example generates C4398. ```cpp // C4398.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4404.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4404.md index 27677fa9728..9284eab853c 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4404.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4404.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Compiler Warning (level 3) C4404" title: "Compiler Warning (level 3) C4404" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 3) C4404" +ms.date: 11/04/2016 f1_keywords: ["C4404"] helpviewer_keywords: ["C4404"] -ms.assetid: 78ce9985-0ccd-4ec2-92bf-289475109cdd --- # Compiler Warning (level 3) C4404 -period on directive ignored +> period on directive ignored + +## Remarks The optional period preceding the directive is ignored. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4414.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4414.md index 0a4b595c122..e9002be53f4 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4414.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4414.md @@ -1,17 +1,20 @@ --- -description: "Learn more about: Compiler Warning (level 3) C4414" title: "Compiler Warning (level 3) C4414" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 3) C4414" +ms.date: 11/04/2016 f1_keywords: ["C4414"] helpviewer_keywords: ["C4414"] -ms.assetid: bc81d3ad-55dc-4a6b-a6f2-ec0ef38347df --- # Compiler Warning (level 3) C4414 -'function' : short jump to function converted to near +> 'function' : short jump to function converted to near + +## Remarks Short jumps generate compact instruction which branches to an address within a limited range from the instruction. The instruction includes a short offset that represents the distance between the jump and the target address, the function definition. During linking a function may be moved or subject to link-time optimizations that cause the function to be moved out of the range reachable from a short offset. The compiler must generate a special record for the jump, which requires the jmp instruction to be either NEAR or FAR. The compiler made the conversion. +## Example + For example, the following code generates C4414: ```cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4511.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4511.md index 198c5895880..609b70accec 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4511.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4511.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Compiler Warning (level 3) C4511" title: "Compiler Warning (level 3) C4511" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 3) C4511" +ms.date: 11/04/2016 f1_keywords: ["C4511"] helpviewer_keywords: ["C4511"] -ms.assetid: a01286b2-3dd9-4a97-a5ee-dd0e7b63ef8b --- # Compiler Warning (level 3) C4511 -'class' : copy constructor could not be generated +> 'class' : copy constructor could not be generated + +## Remarks The compiler could not generate a default copy-constructor for a class; a base class may have a private copy-constructor. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4521.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4521.md index fc0524f6646..835726ea232 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4521.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4521.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Warning (level 3) C4521" title: "Compiler Warning (level 3) C4521" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 3) C4521" +ms.date: 11/04/2016 f1_keywords: ["C4521"] helpviewer_keywords: ["C4521"] -ms.assetid: 057d770c-ebcf-44cd-b943-1b1bb1ceaa8c --- # Compiler Warning (level 3) C4521 -'class' : multiple copy constructors specified +> 'class' : multiple copy constructors specified + +## Remarks The class has multiple copy constructors of a single type. This warning is informational; the constructors are callable in your program. @@ -16,7 +17,7 @@ Use the [warning](../../preprocessor/warning.md) pragma to suppress this warning ## Example -The following sample generates C4521. +The following example generates C4521. ```cpp // C4521.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4522.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4522.md index 3930d4347d2..51cad339419 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4522.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4522.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Warning (level 3) C4522" title: "Compiler Warning (level 3) C4522" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 3) C4522" +ms.date: 11/04/2016 f1_keywords: ["C4522"] helpviewer_keywords: ["C4522"] -ms.assetid: 7065dc27-0b6c-4e68-a345-c51cdb99a20b --- # Compiler Warning (level 3) C4522 -'class' : multiple assignment operators specified +> 'class' : multiple assignment operators specified + +## Remarks The class has multiple assignment operators of a single type. This warning is informational; the constructors are callable in your program. @@ -16,7 +17,7 @@ Use the [warning](../../preprocessor/warning.md) pragma to suppress this warning ## Example -The following sample generates C4522. +The following example generates C4522. ```cpp // C4522.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4523.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4523.md index 1054bb6008c..1f9497e7f01 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4523.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4523.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Compiler Warning (level 3) C4523" title: "Compiler Warning (level 3) C4523" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 3) C4523" +ms.date: 11/04/2016 f1_keywords: ["C4523"] helpviewer_keywords: ["C4523"] -ms.assetid: 0f28761d-999f-43fe-9481-d02afd9b4f60 --- # Compiler Warning (level 3) C4523 -'class' : multiple destructors specified +> 'class' : multiple destructors specified + +## Remarks The class has multiple destructors. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4534.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4534.md index 9e5841e73a5..02b4492a1fd 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4534.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4534.md @@ -1,19 +1,23 @@ --- -description: "Learn more about: Compiler Warning (level 3) C4534" title: "Compiler Warning (level 3) C4534" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 3) C4534" +ms.date: 11/04/2016 f1_keywords: ["C4534"] helpviewer_keywords: ["C4534"] --- # Compiler Warning (level 3) C4534 -'constructor' will not be a default constructor for class 'class' due to the default argument +> 'constructor' will not be a default constructor for class 'class' due to the default argument + +## Remarks An unmanaged class can have a constructor with parameters that have default values and the compiler will use this as the default constructor. A class marked with the `value` keyword will not use a constructor with default values for its parameters as a default constructor. For more information, see [Classes and Structs](../../extensions/classes-and-structs-cpp-component-extensions.md). -The following sample generates C4534: +## Example + +The following example generates C4534: ```cpp // C4534.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4535.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4535.md index 254257c0bab..a98e2fb5ec1 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4535.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4535.md @@ -1,20 +1,21 @@ --- -description: "Learn more about: Compiler Warning (level 3) C4535" title: "Compiler Warning (level 3) C4535" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 3) C4535" +ms.date: 11/04/2016 f1_keywords: ["C4535"] helpviewer_keywords: ["C4535"] -ms.assetid: 2c5ad1aa-2558-41d1-8f06-47fef74c8d9b --- # Compiler Warning (level 3) C4535 -calling _set_se_translator() requires /EHa +> calling _set_se_translator() requires /EHa + +## Remarks The use of [_set_se_translator](../../c-runtime-library/reference/set-se-translator.md) requires the [/EHa](../../build/reference/eh-exception-handling-model.md) compiler option and not **/EHs**. ## Example -The following sample generates C4535. +The following example generates C4535. ```cpp // C4535.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4538.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4538.md index 255ed1ba17c..6bfa7556556 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4538.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4538.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Warning (level 3) C4538" title: "Compiler Warning (level 3) C4538" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 3) C4538" +ms.date: 11/04/2016 f1_keywords: ["C4538"] helpviewer_keywords: ["C4538"] -ms.assetid: 747e3d51-b6d0-41c1-a726-7af3253b59d7 --- # Compiler Warning (level 3) C4538 -'type' : const/volatile qualifiers on this type are not supported +> 'type' : const/volatile qualifiers on this type are not supported + +## Remarks A qualifier keyword was applied to an array incorrectly. For more information, see [array](../../extensions/arrays-cpp-component-extensions.md). -The following sample generates C4538: +## Example + +The following example generates C4538: ```cpp // C4538.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4543.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4543.md index 56157264165..a36b2bff456 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4543.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4543.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Warning (level 3) C4543" title: "Compiler Warning (level 3) C4543" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 3) C4543" +ms.date: 11/04/2016 f1_keywords: ["C4543"] helpviewer_keywords: ["C4543"] -ms.assetid: a09b39a7-d3b8-435c-86a3-2233c512f24b --- # Compiler Warning (level 3) C4543 -Injected text suppressed by attribute 'no_injected_text' +> Injected text suppressed by attribute 'no_injected_text' + +## Remarks The [no_injected_text](../../windows/attributes/no-injected-text.md) attribute appeared in source code, which means the compiler will prevent attributes from injecting code. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4554.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4554.md index 47742011a04..46786ef9159 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4554.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4554.md @@ -1,16 +1,17 @@ --- -description: "Learn more about: Compiler Warning (level 3) C4554" title: "Compiler Warning (level 3) C4554" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 3) C4554" +ms.date: 11/04/2016 f1_keywords: ["C4554"] helpviewer_keywords: ["C4554"] -ms.assetid: 55bb68f0-2e80-4330-8921-51083c4f8d53 --- # Compiler Warning (level 3) C4554 -'operator' : check operator precedence for possible error; use parentheses to clarify precedence +> 'operator' : check operator precedence for possible error; use parentheses to clarify precedence + +## Example -The following sample generates C4554: +The following example generates C4554: ```cpp // C4554.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4557.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4557.md index 45a74eb0f47..b6495e22283 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4557.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4557.md @@ -1,20 +1,23 @@ --- -description: "Learn more about: Compiler Warning (level 3) C4557" title: "Compiler Warning (level 3) C4557" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 3) C4557" +ms.date: 11/04/2016 f1_keywords: ["C4557"] helpviewer_keywords: ["C4557"] -ms.assetid: 7d9db716-03b2-4ee5-9b09-ba8aa5aa7e4c --- # Compiler Warning (level 3) C4557 -'__assume' contains effect 'effect' +> '__assume' contains effect 'effect' + +## Remarks The value passed to an [__assume](../../intrinsics/assume.md) statement2 was modified. This warning is off by default. See [Compiler Warnings That Are Off by Default](../../preprocessor/compiler-warnings-that-are-off-by-default.md) for more information. -The following sample generates C4557: +## Example + +The following example generates C4557: ```cpp // C4557.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4570.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4570.md index a3090361bf4..6ae41dad8d9 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4570.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4570.md @@ -1,20 +1,21 @@ --- -description: "Learn more about: Compiler Warning (level 3) C4570" title: "Compiler Warning (level 3) C4570" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 3) C4570" +ms.date: 11/04/2016 f1_keywords: ["C4570"] helpviewer_keywords: ["C4570"] -ms.assetid: feec1225-e6ad-4995-8d96-c22e864a77bd --- # Compiler Warning (level 3) C4570 -'type' : is not explicitly declared as abstract but has abstract functions +> 'type' : is not explicitly declared as abstract but has abstract functions + +## Remarks A type that contains [abstract](../../extensions/abstract-cpp-component-extensions.md) functions should itself be marked as abstract. ## Example -The following sample generates C4570. +The following example generates C4570. ```cpp // C4570.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4580.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4580.md index 5be25424956..f8d07e1f61a 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4580.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4580.md @@ -1,20 +1,21 @@ --- -description: "Learn more about: Compiler Warning (level 3) C4580" title: "Compiler Warning (level 3) C4580" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 3) C4580" +ms.date: 11/04/2016 f1_keywords: ["C4580"] helpviewer_keywords: ["C4580"] -ms.assetid: fef6e8e0-0d6a-44fa-b22a-2fe7ba2ef379 --- # Compiler Warning (level 3) C4580 -[attribute] is deprecated; instead specify System::Attribute or Platform::Metadata as a base class +> [attribute] is deprecated; instead specify System::Attribute or Platform::Metadata as a base class + +## Remarks [[attribute](../../windows/attributes/attribute.md)] is no longer the preferred syntax for creating user-defined attributes. For more information, see [User-Defined Attributes](../../extensions/user-defined-attributes-cpp-component-extensions.md). For CLR code, derive attributes from `System::Attribute`. For Windows Runtime code, derive attributes from `Platform::Metadata`. ## Example -The following sample generates C3454 and shows how to fix it. +The following example generates C4580 and shows how to fix it. ```cpp // C4580.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4608.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4608.md index 40bb5d55bdb..f924e7ab0e4 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4608.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4608.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Warning (level 3) C4608" title: "Compiler Warning (level 3) C4608" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 3) C4608" +ms.date: 11/04/2016 f1_keywords: ["C4608"] helpviewer_keywords: ["C4608"] -ms.assetid: 8b8f5f28-8ce9-457e-9d3d-a8c0efce9b6a --- # Compiler Warning (level 3) C4608 -'union_member' has already been initialized by another union member in the initializer list, 'union_member' +> 'union_member' has already been initialized by another union member in the initializer list, 'union_member' + +## Remarks Two members of the same union were initialized in an initialization list. You can only access one member of the union. -The following sample generates C4608: +## Example + +The following example generates C4608: ```cpp // C4608.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4619.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4619.md index d088f9e025e..fb98a1c9d61 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4619.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4619.md @@ -1,20 +1,23 @@ --- -description: "Learn more about: Compiler Warning (level 3) C4619" title: "Compiler Warning (level 3) C4619" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 3) C4619" +ms.date: 11/04/2016 f1_keywords: ["C4619"] helpviewer_keywords: ["C4619"] -ms.assetid: 701fea21-01aa-4bea-93d4-1cb8824170b0 --- # Compiler Warning (level 3) C4619 -\#pragma warning : there is no warning number 'number' +> #pragma warning : there is no warning number 'number' + +## Remarks An attempt was made to disable a warning that does not exist. This warning is off by default. See [Compiler Warnings That Are Off by Default](../../preprocessor/compiler-warnings-that-are-off-by-default.md) for more information. -The following sample generates C4619: +## Example + +The following example generates C4619: ```cpp // C4619.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4622.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4622.md index 2a33076a976..ba45d4c3827 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4622.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4622.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Warning (level 3) C4622" title: "Compiler Warning (level 3) C4622" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 3) C4622" +ms.date: 11/04/2016 f1_keywords: ["C4622"] helpviewer_keywords: ["C4622"] -ms.assetid: d3c879f0-4492-4f4b-b26d-230993f3a933 --- # Compiler Warning (level 3) C4622 -Overwriting debug information formed during creation of the precompiled header in object file: 'file' +> Overwriting debug information formed during creation of the precompiled header in object file: 'file' + +## Remarks CodeView information in the specified file was lost when it was compiled with the [/Yu](../../build/reference/yu-use-precompiled-header-file.md) (Use Precompiled Headers) option. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4633.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4633.md index 8a008df2686..5767c5613aa 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4633.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4633.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Warning (level 3) C4633" title: "Compiler Warning (level 3) C4633" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 3) C4633" +ms.date: 11/04/2016 f1_keywords: ["C4633"] helpviewer_keywords: ["C4633"] -ms.assetid: 6d76f268-ba8c-448b-8e83-b903a18b583b --- # Compiler Warning (level 3) C4633 -XML document comment target: error: reason +> XML document comment target: error: reason + +## Remarks A name passed to the [\](../../build/reference/param-visual-cpp.md) tag was not found by the compiler. -The following sample generates C4633: +## Example + +The following example generates C4633: ```cpp // C4633.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4635.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4635.md index dec16024a92..ea7c5b80a03 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4635.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4635.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Warning (level 3) C4635" title: "Compiler Warning (level 3) C4635" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 3) C4635" +ms.date: 11/04/2016 f1_keywords: ["C4635"] helpviewer_keywords: ["C4635"] -ms.assetid: b2ba90de-c093-4a76-8076-b65878467574 --- # Compiler Warning (level 3) C4635 -XML document comment target: badly-formed XML: reason +> XML document comment target: badly-formed XML: reason + +## Remarks The compiler found some problem with the XML tags. Fix the problem and recompile -The following sample generates C4635: +## Example + +The following example generates C4635: ```cpp // C4635.cpp @@ -26,6 +29,6 @@ The following sample generates C4635: public ref class Test {}; ``` -Notice that the output for this sample says: **End tag 'member' does not match the start tag 'summary'.** +Notice that the output for this example says: **End tag 'member' does not match the start tag 'summary'.** -The problem with this sample is that the end tag for \

is poorly formed, and the compiler does not recognize it as the \ end tag. The \ tag is embedded in the .xdc file by the compiler in every /doc compilation. So, the problem here is that the end tag \, does not match the previous start tag that the compiler processed (\. +The problem with this example is that the end tag for \ is poorly formed, and the compiler does not recognize it as the \ end tag. The \ tag is embedded in the .xdc file by the compiler in every /doc compilation. So, the problem here is that the end tag \, does not match the previous start tag that the compiler processed (\. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4636.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4636.md index 4591d9dcc8a..ee0b25a5f6b 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4636.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4636.md @@ -1,20 +1,21 @@ --- -description: "Learn more about: Compiler Warning (level 3) C4636" title: "Compiler Warning (level 3) C4636" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 3) C4636" +ms.date: 11/04/2016 f1_keywords: ["C4636"] helpviewer_keywords: ["C4636"] -ms.assetid: 59112a0f-850f-41c6-bd84-8ae8dc84706a --- # Compiler Warning (level 3) C4636 -XML document comment applied to 'construct': tag requires non-empty '' attribute. +> XML document comment applied to 'construct': tag requires non-empty '' attribute. + +## Remarks A tag, such as `cref`, did not have a value. ## Example -The following sample generates C4636. +The following example generates C4636. ```cpp // C4636.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4637.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4637.md index 3617d5b4ace..4426328632f 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4637.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4637.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Warning (level 3) C4637" title: "Compiler Warning (level 3) C4637" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 3) C4637" +ms.date: 11/04/2016 f1_keywords: ["C4637"] helpviewer_keywords: ["C4637"] -ms.assetid: 5fd347c1-2de9-408f-9136-1bf1ff273622 --- # Compiler Warning (level 3) C4637 -XML document comment target: \ tag discarded. reason +> XML document comment target: \ tag discarded. reason + +## Remarks The syntax of an [\](../../build/reference/include-visual-cpp.md) tag was not correct. -The following sample generates C4637: +## Example + +The following example generates C4637: ```cpp // C4637.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4638.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4638.md index cbe5cbcc601..1ac1da97a49 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4638.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4638.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 3) C4638" title: "Compiler Warning (level 3) C4638" -ms.date: "08/27/2018" +description: "Learn more about: Compiler Warning (level 3) C4638" +ms.date: 08/27/2018 f1_keywords: ["C4638"] helpviewer_keywords: ["C4638"] -ms.assetid: 2c07923a-e103-4e40-bd11-fdfed428a5ec --- # Compiler Warning (level 3) C4638 @@ -16,7 +15,7 @@ The compiler was unable to resolve a symbol (*symbol*). The symbol must be valid ## Example -The following sample generates C4638: +The following example generates C4638: ```cpp // C4638.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4640.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4640.md index 99e0026cb1a..f66a7e4ebda 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4640.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4640.md @@ -1,20 +1,23 @@ --- -description: "Learn more about: Compiler Warning (level 3) C4640" title: "Compiler Warning (level 3) C4640" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 3) C4640" +ms.date: 11/04/2016 f1_keywords: ["C4640"] helpviewer_keywords: ["C4640"] -ms.assetid: f76871f6-e436-4c35-9793-d2f22f7e1c7f --- # Compiler Warning (level 3) C4640 -'instance' : construction of local static object is not thread-safe +> 'instance' : construction of local static object is not thread-safe + +## Remarks A static instance of an object is not thread safe. This warning is off by default. See [Compiler Warnings That Are Off by Default](../../preprocessor/compiler-warnings-that-are-off-by-default.md) for more information. -The following sample generates C4640: +## Example + +The following example generates C4640: ```cpp // C4640.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4641.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4641.md index 86cf77948f0..5f110fcce54 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4641.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4641.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Warning (level 3) C4641" title: "Compiler Warning (level 3) C4641" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 3) C4641" +ms.date: 11/04/2016 f1_keywords: ["C4641"] helpviewer_keywords: ["C4641"] -ms.assetid: 28fe5c3e-6039-42da-9100-1312b5b15aea --- # Compiler Warning (level 3) C4641 -XML document comment has an ambiguous cross reference +> XML document comment has an ambiguous cross reference + +## Remarks The compiler was unable to unambiguously resolve a reference. To resolve this warning, specify the parameter information necessary to make the reference unambiguous. @@ -16,7 +17,7 @@ For more information, see [XML Documentation](../../build/reference/xml-document ## Example -The following sample generates C4641. +The following example generates C4641. ```cpp // C4641.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4645.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4645.md index 278a1ffe4c4..84ffd10a7f4 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4645.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4645.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Warning (level 3) C4645" title: "Compiler Warning (level 3) C4645" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 3) C4645" +ms.date: 11/04/2016 f1_keywords: ["C4645"] helpviewer_keywords: ["C4645"] -ms.assetid: fd7c1ddf-f0d0-4e10-bab9-ccb4c3476298 --- # Compiler Warning (level 3) C4645 -function declared with __declspec(noreturn) has a return statement +> function declared with __declspec(noreturn) has a return statement + +## Remarks A [return](../../cpp/program-termination.md) statement was found in a function that is marked with the [noreturn](../../cpp/noreturn.md) **`__declspec`** modifier. The **`return`** statement was ignored. -The following sample generates C4645: +## Example + +The following example generates C4645: ```cpp // C4645.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4646.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4646.md index 427f282b514..84233c3a05e 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4646.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4646.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Warning (level 3) C4646" title: "Compiler Warning (level 3) C4646" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 3) C4646" +ms.date: 11/04/2016 f1_keywords: ["C4646"] helpviewer_keywords: ["C4646"] -ms.assetid: 23677e8e-603e-40e0-b99a-2e4894a1278e --- # Compiler Warning (level 3) C4646 -function declared with __declspec(noreturn) has non-void return type +> function declared with __declspec(noreturn) has non-void return type + +## Remarks A function marked with the [noreturn](../../cpp/noreturn.md) **`__declspec`** modifier should have a [void](../../cpp/void-cpp.md) return type. -The following sample generates C4646: +## Example + +The following example generates C4646: ```cpp // C4646.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4686.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4686.md index 28ac87a590c..eeda17ff133 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4686.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4686.md @@ -4,7 +4,6 @@ description: "Microsoft C++ compiler warning C4686." ms.date: 08/29/2020 f1_keywords: ["C4686"] helpviewer_keywords: ["C4686"] -ms.assetid: 767c83c2-9e4b-4f9e-88c8-02128ba563f4 --- # Compiler Warning (level 3) C4686 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4723.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4723.md index 7893ae678ed..d41de92232c 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4723.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4723.md @@ -4,11 +4,12 @@ description: "Describes the MSVC compiler warning C4723 for potential divide by ms.date: 07/08/2020 f1_keywords: ["C4723"] helpviewer_keywords: ["C4723"] -ms.assetid: 07669d14-3fd8-4a43-94bc-b61c50e58460 --- # Compiler Warning (level 3) C4723 -> `potential divide by 0` +> potential divide by 0 + +## Remarks The second operand in a divide operation evaluated to zero at compile time, giving undefined results. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4724.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4724.md index e9bb992d3ad..d1cdf080f8a 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4724.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4724.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Compiler Warning (level 3) C4724" title: "Compiler Warning (level 3) C4724" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 3) C4724" +ms.date: 11/04/2016 f1_keywords: ["C4724"] helpviewer_keywords: ["C4724"] -ms.assetid: 3be4305b-e8fe-49a9-abbf-b20dfbd71a19 --- # Compiler Warning (level 3) C4724 -potential mod by 0 +> potential mod by 0 + +## Remarks The second operand in a remainder operation evaluated to zero at compile time, giving undefined results. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4738.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4738.md index b8ef08780a1..418c5042309 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4738.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4738.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Warning (Level 3) C4738" title: "Compiler Warning (Level 3) C4738" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (Level 3) C4738" +ms.date: 11/04/2016 f1_keywords: ["C4738"] helpviewer_keywords: ["C4738"] -ms.assetid: 9094895f-7eec-46c2-83d3-249b761d585e --- # Compiler Warning (Level 3) C4738 -storing 32-bit float result in memory, possible loss of performance +> storing 32-bit float result in memory, possible loss of performance + +## Remarks C4738 warns that the result of an assignment, cast, passed argument, or other operation may need to be rounded or that the operation ran out of registers and needed to use memory (spilling). This can result in performance loss. @@ -20,7 +21,7 @@ This warning is off by default. For more information, see [Compiler Warnings Tha ## Example -The following sample generates C4738: +The following example generates C4738: ```cpp // C4738.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4792.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4792.md index a4e6e483aea..ab042b9b95a 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4792.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4792.md @@ -1,20 +1,23 @@ --- -description: "Learn more about: Compiler Warning (level 3) C4792" title: "Compiler Warning (level 3) C4792" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 3) C4792" +ms.date: 11/04/2016 f1_keywords: ["C4792"] helpviewer_keywords: ["C4792"] -ms.assetid: c047ce69-a622-44e1-9425-d41aa9261c61 --- # Compiler Warning (level 3) C4792 -function 'function' declared using sysimport and referenced from native code; import library required to link +> function 'function' declared using sysimport and referenced from native code; import library required to link + +## Remarks A native function that was imported into the program with DllImport was called from an unmanaged function. Therefore, you must link to the import library for the DLL. This warning cannot be resolved in code or by changing the way you compile. Use the [warning](../../preprocessor/warning.md) pragma to disable this warning. -The following sample generates C4792: +## Example + +The following example generates C4792: ```cpp // C4792.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4800.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4800.md index 128c92c9bb6..7d0eaddd3ac 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4800.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4800.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 4) C4800" title: "Compiler Warning (level 4) C4800" -ms.date: "03/14/2019" +description: "Learn more about: Compiler Warning (level 4) C4800" +ms.date: 03/14/2019 f1_keywords: ["C4800"] helpviewer_keywords: ["C4800"] -ms.assetid: 4f409799-a250-45ed-bb5f-657691b0d9f7 --- # Compiler Warning (level 4) C4800 @@ -16,6 +15,8 @@ Visual Studio 2019 and later: C4800 is a level 3 warning in Visual Studio 2015 and earlier: > '*type*' : forcing value to bool 'true' or 'false' (performance warning) +## Remarks + This warning is generated when a value is implicitly converted into type **`bool`**. Typically, this message is caused by assigning **`int`** variables to **`bool`** variables where the **`int`** variable contains only values **`true`** and **`false`**, and could be redeclared as type **`bool`**. If you can't rewrite the expression to use type **`bool`**, then you can add "`!=0`" to the expression, which gives the expression type **`bool`**. Casting the expression to type **`bool`** doesn't disable the warning, which is by design. ::: moniker range=">= msvc-150" @@ -28,7 +29,7 @@ This warning is off by default starting in Visual Studio 2019. Use __/w__*n*__48 ## Example -The following sample generates C4800 and shows how to fix it: +The following example generates C4800 and shows how to fix it: ```cpp // C4800.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4823.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4823.md index 3a8f659d426..0e5cbf011de 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4823.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4823.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Warning (level 3) C4823" title: "Compiler Warning (level 3) C4823" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 3) C4823" +ms.date: 11/04/2016 f1_keywords: ["C4823"] helpviewer_keywords: ["C4823"] -ms.assetid: 8a77560d-dcea-4cae-aebb-8ebf1b4cef85 --- # Compiler Warning (level 3) C4823 -'function' : uses pinning pointers but unwind semantics are not enabled. Consider using /EHa +> 'function' : uses pinning pointers but unwind semantics are not enabled. Consider using /EHa + +## Remarks To unpin an object on the managed heap pointed to by a pinning pointer declared in a block scope, the compiler simulates the behavior of destructors of local classes, "pretending" the pinning pointer has a destructor that nullifies the pointer. To enable a call to a destructor after throwing an exception, you must enable object unwinding, which you can do by using [/EHsc](../../build/reference/eh-exception-handling-model.md). @@ -16,7 +17,7 @@ You can also manually unpin the object and ignore the warning. ## Example -The following sample generates C4823. +The following example generates C4823. ```cpp // C4823.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4839.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4839.md index 93f5ae72111..0179dad250c 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4839.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4839.md @@ -1,22 +1,23 @@ --- -description: "Learn more about: Compiler Warning (level 3) C4839" title: "Compiler Warning (level 3) C4839" -ms.date: "09/13/2018" +description: "Learn more about: Compiler Warning (level 3) C4839" +ms.date: 09/13/2018 f1_keywords: ["C4839"] helpviewer_keywords: ["C4839"] -ms.assetid: f4f99066-9258-4330-81a8-f4a75a1d95ee --- # Compiler Warning (level 3) C4839 > non-standard use of class '*type*' as an argument to a variadic function +## Remarks + Classes or structs that are passed to a variadic function such as `printf` must be trivially copyable. When passing such objects, the compiler simply makes a bitwise copy and does not call the constructor or destructor. This warning is available beginning in Visual Studio 2017. ## Example -The following sample generates C4839: +The following example generates C4839: ```cpp // C4839.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4995.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4995.md index a753799357c..76e0eb019a0 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4995.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4995.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 3) C4995" title: "Compiler Warning (level 3) C4995" +description: "Learn more about: Compiler Warning (level 3) C4995" ms.date: 08/30/2022 f1_keywords: ["C4995"] helpviewer_keywords: ["C4995"] -ms.assetid: c6b61755-4730-4947-ad4d-d1c2bc82585a --- # Compiler Warning (level 3) C4995 @@ -18,7 +17,7 @@ The [`/sdl` (Enable Additional Security Checks)](../../build/reference/sdl-enabl ## Example -The following sample generates C4995. Uncomment the `#pragma warning` line to disable the warning. +The following example generates C4995. Uncomment the `#pragma warning` line to disable the warning. ```cpp // C4995.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4996.md b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4996.md index db12f3841f9..2180d283941 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4996.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-3-c4996.md @@ -4,7 +4,6 @@ description: "Explains why Compiler warning C4996 happens, and describes what to ms.date: 08/30/2022 f1_keywords: ["C4996"] helpviewer_keywords: ["C4996"] -ms.assetid: 926c7cc2-921d-43ed-ae75-634f560dd317 --- # Compiler Warning (level 3) C4996 @@ -63,7 +62,7 @@ Here are some of the common sources of C4996 warnings and errors: ## POSIX function names -**`The POSIX name for this item is deprecated. Instead, use the ISO C and C++ conformant name:`** _`new-name.`_ **`See online help for details.`** +> The POSIX name for this item is deprecated. Instead, use the ISO C and C++ conformant name: *`new-name`*. See online help for details. Microsoft renamed some POSIX and Microsoft-specific library functions in the CRT to conform with C99 and C++03 constraints on reserved and global implementation-defined names. *Only the names are deprecated, not the functions themselves*. In most cases, a leading underscore was added to the function name to create a conforming name. The compiler issues a deprecation warning for the original function name, and suggests the preferred name. @@ -73,7 +72,7 @@ To turn off deprecation warnings for these functions, define the preprocessor ma ## Unsafe CRT Library functions -**`This function or variable may be unsafe. Consider using`** _`safe-version`_ **`instead. To disable deprecation, use _CRT_SECURE_NO_WARNINGS. See online help for details.`** +> This function or variable may be unsafe. Consider using *`safe-version`* instead. To disable deprecation, use _CRT_SECURE_NO_WARNINGS. See online help for details. Microsoft deprecated some CRT and C++ Standard Library functions and globals because more secure versions are available. Most of the deprecated functions allow unchecked read or write access to buffers. Their misuse can lead to serious security issues. The compiler issues a deprecation warning for these functions, and suggests the preferred function. @@ -87,7 +86,7 @@ For more information about these deprecated functions and globals, see [Security ## Unsafe Standard Library functions -**`'std::`** *`function_name`* **`::_Unchecked_iterators::_Deprecate' Call to std::`** *`function_name`* **`with parameters that may be unsafe - this call relies on the caller to check that the passed values are correct. To disable this warning, use -D_SCL_SECURE_NO_WARNINGS. See documentation on how to use Visual C++ 'Checked Iterators'`** +> 'std:: *`function_name`* ::_Unchecked_iterators::_Deprecate' Call to std:: *`function_name`* with parameters that may be unsafe - this call relies on the caller to check that the passed values are correct. To disable this warning, use -D_SCL_SECURE_NO_WARNINGS. See documentation on how to use Visual C++ 'Checked Iterators' In Visual Studio 2015, this warning appears in debug builds because certain C++ Standard Library function templates don't check parameters for correctness. Often it's because not enough information is available to the function to check container bounds. Or, because iterators may be used incorrectly with the function. This warning helps you identify these functions, because they may be a source of serious security holes in your program. For more information, see [Checked iterators](../../standard-library/checked-iterators.md). @@ -248,7 +247,7 @@ For information on how to suppress these warnings, see [`_AFX_SECURE_NO_WARNINGS ## Obsolete CRT functions and variables -**`This function or variable has been superseded by newer library or operating system functionality. Consider using`** *`new_item`* **`instead. See online help for details.`** +> This function or variable has been superseded by newer library or operating system functionality. Consider using *`new_item`* instead. See online help for details. Some library functions and global variables are deprecated as obsolete. These functions and variables may be removed in a future version of the library. The compiler issues a deprecation warning for these items, and suggests the preferred alternative. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4001.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4001.md index 73499a45793..f5c0cdd330b 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4001.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4001.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: Compiler Warning (level 4, no longer emitted) C4001" title: "Compiler Warning (level 4, no longer emitted) C4001" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 4, no longer emitted) C4001" +ms.date: 11/04/2016 f1_keywords: ["C4001"] helpviewer_keywords: ["C4001"] --- @@ -9,6 +9,8 @@ helpviewer_keywords: ["C4001"] > nonstandard extension 'single line comment' was used +## Remarks + > [!NOTE] > This warning is removed in Visual Studio 2017 version 15.5 because single-line comments are standard in C99. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4019.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4019.md index 60b67551c28..cdb8721b010 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4019.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4019.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Warning (level 4) C4019" title: "Compiler Warning (level 4) C4019" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 4) C4019" +ms.date: 11/04/2016 f1_keywords: ["C4019"] helpviewer_keywords: ["C4019"] -ms.assetid: 4ecfe85d-673f-4334-8154-36fe7f0b3444 --- # Compiler Warning (level 4) C4019 -empty statement at global scope +> empty statement at global scope + +## Remarks A semicolon at global scope isn't preceded by a statement. @@ -19,6 +20,8 @@ This warning may be fixed if you remove the extra semicolon. ## Example +The following example generates C4019: + ```c // C4019.c // compile with: /Za /W4 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4032.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4032.md index cfe32c9fdea..b5e045ee4f2 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4032.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4032.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Warning (level 4) C4032" title: "Compiler Warning (level 4) C4032" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 4) C4032" +ms.date: 11/04/2016 f1_keywords: ["C4032"] helpviewer_keywords: ["C4032"] -ms.assetid: 70dd0c85-0239-43f9-bb06-507f6a57d206 --- # Compiler Warning (level 4) C4032 -formal parameter 'number' has different type when promoted +> formal parameter 'number' has different type when promoted + +## Remarks The parameter type is not compatible, through default promotions, with the type in a previous declaration. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4053.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4053.md index dec8704399d..b18683f19f2 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4053.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4053.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Compiler Warning (level 4) C4053" title: "Compiler Warning (level 4) C4053" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 4) C4053" +ms.date: 11/04/2016 f1_keywords: ["C4053"] helpviewer_keywords: ["C4053"] -ms.assetid: e3b8c46e-e36d-412c-99b9-3db860b6e307 --- # Compiler Warning (level 4) C4053 -one void operand for '?:' +> one void operand for '?:' + +## Remarks The `?:` operator is given an expression of type **`void`**. The value of the **`void`** operand is undefined. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4057.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4057.md index d335a6fab05..a7cac9d610c 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4057.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4057.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Warning (level 4) C4057" title: "Compiler Warning (level 4) C4057" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 4) C4057" +ms.date: 11/04/2016 f1_keywords: ["C4057"] helpviewer_keywords: ["C4057"] -ms.assetid: e75d0645-84c9-4bef-a812-942ed9879aa3 --- # Compiler Warning (level 4) C4057 -'operator' : 'identifier1' indirection to slightly different base types from 'identifier2' +> 'operator' : 'identifier1' indirection to slightly different base types from 'identifier2' + +## Remarks Two pointer expressions refer to different base types. The expressions are used without conversion. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4061.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4061.md index a3649649a1c..828c339d2f7 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4061.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4061.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: Compiler Warning (level 4, off) C4061" title: "Compiler Warning (level 4, off) C4061" -ms.date: "04/05/2019" +description: "Learn more about: Compiler Warning (level 4, off) C4061" +ms.date: 04/05/2019 f1_keywords: ["C4061"] helpviewer_keywords: ["C4061"] --- @@ -9,13 +9,15 @@ helpviewer_keywords: ["C4061"] > enumerator '*identifier*' in switch of `enum` '*enumeration*' is not explicitly handled by a `case` label +## Remarks + The specified enumerator *identifier* has no associated handler in a `switch` statement that has a `default` case. The missing case might be an oversight, or it may not be an issue. Whether the missing `case` is an issue in practice depends on if the default case handles the enumerator. For a related warning on unused enumerators in `switch` statements that have no `default` case, see [C4062](compiler-warning-level-4-c4062.md). This warning is off by default. For more information about how to enable warnings that are off by default, see [Compiler Warnings That Are Off by Default](../../preprocessor/compiler-warnings-that-are-off-by-default.md). ## Example -The following sample generates C4061; add a case for the missing enumerator to fix: +The following example generates C4061; add a case for the missing enumerator to fix: ```cpp // C4061.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4062.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4062.md index e6430b05b84..2862f25d899 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4062.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4062.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: Compiler Warning (level 4, off) C4062" title: "Compiler Warning (level 4, off) C4062" -ms.date: "04/05/2019" +description: "Learn more about: Compiler Warning (level 4, off) C4062" +ms.date: 04/05/2019 f1_keywords: ["C4062"] helpviewer_keywords: ["C4062"] --- @@ -9,13 +9,15 @@ helpviewer_keywords: ["C4062"] > enumerator '*identifier*' in switch of `enum` '*enumeration*' is not handled +## Remarks + The enumerator *identifier* doesn't have a `case` handler associated with it in a **`switch`** statement, and there's no **`default`** label that can catch it. The missing case may be an oversight, and is a potential error in your code. For a related warning on unused enumerators in **`switch`** statements that have a **`default`** case, see [C4061](compiler-warning-level-4-c4061.md). This warning is off by default. For more information about how to enable warnings that are off by default, see [Compiler Warnings That Are Off by Default](../../preprocessor/compiler-warnings-that-are-off-by-default.md). ## Example -The following sample generates C4062, and shows how to fix it: +The following example generates C4062, and shows how to fix it: ```cpp // C4062.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4092.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4092.md index 5f3cc5c9b67..d926a41d768 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4092.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4092.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Compiler Warning (level 4) C4092" title: "Compiler Warning (level 4) C4092" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 4) C4092" +ms.date: 11/04/2016 f1_keywords: ["C4092"] helpviewer_keywords: ["C4092"] -ms.assetid: 396ae826-a892-4327-bd66-f4762376d72b --- # Compiler Warning (level 4) C4092 > sizeof returns 'unsigned long' +## Remarks + The operand of the **`sizeof`** operator was very large, so **`sizeof`** returned an **`unsigned long`**. This warning occurs under the Microsoft extensions ([`/Ze`](../../build/reference/za-ze-disable-language-extensions.md)). Under ANSI compatibility (**`/Za`**), the result is truncated instead. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4100.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4100.md index a899f9b1002..c0b6b54f40f 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4100.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4100.md @@ -1,26 +1,28 @@ --- -description: "Learn more about: Compiler Warning (level 4) C4100" title: "Compiler Warning (level 4) C4100" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 4) C4100" +ms.date: 04/22/2025 f1_keywords: ["C4100"] helpviewer_keywords: ["C4100"] -ms.assetid: 478ed97d-e502-49e4-9afb-ac2a6c61194b --- # Compiler Warning (level 4) C4100 -'identifier' : unreferenced formal parameter +> 'identifier' : unreferenced formal parameter + +## Remarks The formal parameter is not referenced in the body of the function. The unreferenced parameter is ignored. -C4100 can also be issued when code calls a destructor on a otherwise unreferenced parameter of primitive type. This is a limitation of the Microsoft C++ compiler. +C4100 can also be issued when code calls a destructor on an otherwise unreferenced parameter of primitive type. + +## Example -The following sample generates C4100: +The following example generates C4100: ```cpp // C4100.cpp // compile with: /W4 -void func(int i) { // C4100, delete the unreferenced parameter to - //resolve the warning +void func(int i) { // C4100, delete the unreferenced parameter to resolve the warning // i; // Or uncomment this line to add a reference } diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4121.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4121.md index ab0179a1064..0d8b34944c4 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4121.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4121.md @@ -1,16 +1,21 @@ --- -description: "Learn more about: Compiler Warning (level 4) C4121" title: "Compiler Warning (level 4) C4121" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 4) C4121" +ms.date: 11/04/2016 f1_keywords: ["C4121"] helpviewer_keywords: ["C4121"] -ms.assetid: 8c5b85c9-2543-426b-88bc-319c50158c7e --- # Compiler Warning (level 4) C4121 -'symbol' : alignment of a member was sensitive to packing +> 'symbol' : alignment of a member was sensitive to packing + +## Remarks + +The compiler added padding to align a structure member on the packing boundary but the packing value is less than the member's size. + +## Example -The compiler added padding to align a structure member on the packing boundary but the packing value is less than the member's size. For example, the following code snippet produces C4121: +For example, the following code snippet produces C4121: ```cpp // C4121.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4125.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4125.md index 8e5089b3f3d..78acc7ec0f4 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4125.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4125.md @@ -1,19 +1,22 @@ --- -description: "Learn more about: Compiler Warning (level 4) C4125" title: "Compiler Warning (level 4) C4125" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 4) C4125" +ms.date: 11/04/2016 f1_keywords: ["C4125"] helpviewer_keywords: ["C4125"] -ms.assetid: a081d1f4-0789-4915-91df-7ff0b28ca245 --- # Compiler Warning (level 4) C4125 -decimal digit terminates octal escape sequence +> decimal digit terminates octal escape sequence + +## Remarks The compiler evaluates the octal number without the decimal digit and assumes the decimal digit is a character. ## Example +The following example generates C4125: + ```cpp // C4125a.cpp // compile with: /W4 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4127.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4127.md index 6edd099df73..b1187b11e15 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4127.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4127.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 4) C4127" title: "Compiler Warning (level 4) C4127" -ms.date: "10/16/2019" +description: "Learn more about: Compiler Warning (level 4) C4127" +ms.date: 10/16/2019 f1_keywords: ["C4127"] helpviewer_keywords: ["C4127"] -ms.assetid: f59ded9e-5227-45bd-ac43-2aa861581363 --- # Compiler Warning (level 4) C4127 @@ -16,9 +15,9 @@ The controlling expression of an **`if`** statement or **`while`** loop evaluate If the controlling expression of a **`while`** loop is a constant because the loop exits in the middle, consider replacing the **`while`** loop with a **`for`** loop. You can omit the initialization, termination test and loop increment of a **`for`** loop, which causes the loop to be infinite, just like `while(1)`, and you can exit the loop from the body of the **`for`** statement. -## Example +## Examples -The following sample shows two ways C4127 is generated, and shows how to use a for loop to avoid the warning: +The following example shows two ways C4127 is generated, and shows how to use a for loop to avoid the warning: ```cpp // C4127.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4130.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4130.md index b50e7d32d72..ab33396c73f 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4130.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4130.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Warning (level 4) C4130" title: "Compiler Warning (level 4) C4130" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 4) C4130" +ms.date: 11/04/2016 f1_keywords: ["C4130"] helpviewer_keywords: ["C4130"] -ms.assetid: 45e4c7b2-6b51-41c7-ba5e-941aa5c7d3dc --- # Compiler Warning (level 4) C4130 -'operator' : logical operation on address of string constant +> 'operator' : logical operation on address of string constant + +## Remarks Using the operator with the address of a string literal produces unexpected code. -The following sample generates C4130: +## Example + +The following example generates C4130: ```cpp // C4130.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4131.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4131.md index 4104ac0109e..d02d901579d 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4131.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4131.md @@ -1,19 +1,22 @@ --- -description: "Learn more about: Compiler Warning (level 4) C4131" title: "Compiler Warning (level 4) C4131" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 4) C4131" +ms.date: 11/04/2016 f1_keywords: ["C4131"] helpviewer_keywords: ["C4131"] -ms.assetid: 7903b3e1-454f-4be2-aa9b-230992f96a2d --- # Compiler Warning (level 4) C4131 -'function' : uses old-style declarator +> 'function' : uses old-style declarator + +## Remarks The specified function declaration is not in prototype form. Old-style function declarations should be converted to prototype form. +## Example + The following example shows an old-style function declaration: ```c diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4132.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4132.md index 29b10b01926..a5cb7d8a4c9 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4132.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4132.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Compiler Warning (level 4) C4132" title: "Compiler Warning (level 4) C4132" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 4) C4132" +ms.date: 11/04/2016 f1_keywords: ["C4132"] helpviewer_keywords: ["C4132"] -ms.assetid: b60e5b4a-53ac-4503-8456-235477f48afd --- # Compiler Warning (level 4) C4132 -'object' : const object should be initialized +> 'object' : const object should be initialized + +## Remarks The constant is not initialized. The value of a symbol with the **`const`** attribute cannot be changed after its definition, it should be given an initialization value. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4152.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4152.md index 0209f54d2aa..de346a27ecd 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4152.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4152.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Compiler Warning (level 4) C4152" title: "Compiler Warning (level 4) C4152" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 4) C4152" +ms.date: 11/04/2016 f1_keywords: ["C4152"] helpviewer_keywords: ["C4152"] -ms.assetid: 6025ab70-d7cf-4730-913a-3ca0b1186a3a --- # Compiler Warning (level 4) C4152 -non standard extension, function/data ptr conversion in expression +> non standard extension, function/data ptr conversion in expression + +## Remarks A function pointer is converted to or from a data pointer. This conversion is allowed under Microsoft extensions (/Ze) but not under ANSI C. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4189.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4189.md index 6376aebe9d6..93423778f89 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4189.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4189.md @@ -1,6 +1,6 @@ --- -description: "Learn more about: Compiler Warning (level 3 and level 4) C4189" title: "Compiler Warning (level 3 and level 4) C4189" +description: "Learn more about: Compiler Warning (level 3 and level 4) C4189" ms.date: 05/03/2021 f1_keywords: ["C4189"] helpviewer_keywords: ["C4189"] @@ -9,11 +9,13 @@ helpviewer_keywords: ["C4189"] > '*identifier*' : local variable is initialized but not referenced +## Remarks + A variable is declared and initialized but not used. ## Examples -The following sample generates C4189: +The following example generates C4189: ```cpp // C4189.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4201.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4201.md index 1486e4023c5..ceebc5ca0a2 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4201.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4201.md @@ -1,19 +1,22 @@ --- -description: "Learn more about: Compiler Warning (level 4) C4201" title: "Compiler Warning (level 4) C4201" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 4) C4201" +ms.date: 11/04/2016 f1_keywords: ["C4201"] helpviewer_keywords: ["C4201"] -ms.assetid: 6156f508-9393-4d77-9e73-1ec3e1c32d0d --- # Compiler Warning (level 4) C4201 -nonstandard extension used : nameless struct/union +> nonstandard extension used : nameless struct/union + +## Remarks Under Microsoft extensions (/Ze), you can specify a structure without a declarator as members of another structure or union. These structures generate an error under ANSI compatibility ([/Za](../../build/reference/za-ze-disable-language-extensions.md)). ## Example +The following example generates C4201: + ```cpp // C4201.cpp // compile with: /W4 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4202.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4202.md index 4e740e1cfd7..a1ddd986de8 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4202.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4202.md @@ -1,19 +1,22 @@ --- -description: "Learn more about: Compiler Warning (level 4) C4202" title: "Compiler Warning (level 4) C4202" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 4) C4202" +ms.date: 11/04/2016 f1_keywords: ["C4202"] helpviewer_keywords: ["C4202"] -ms.assetid: 253293aa-97a3-4878-a2e8-c6cc9e20b1cb --- # Compiler Warning (level 4) C4202 -nonstandard extension used : '...': prototype parameter in name list illegal +> nonstandard extension used : '...': prototype parameter in name list illegal + +## Remarks An old-style function definition contains variable arguments. These definitions generate an error under ANSI compatibility ([/Za](../../build/reference/za-ze-disable-language-extensions.md)). ## Example +The following example generates C4202: + ```c // C4202.c // compile with: /W4 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4204.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4204.md index 6b59366825f..9ad06ae599c 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4204.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4204.md @@ -1,19 +1,22 @@ --- -description: "Learn more about: Compiler Warning (level 4) C4204" title: "Compiler Warning (level 4) C4204" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 4) C4204" +ms.date: 11/04/2016 f1_keywords: ["C4204"] helpviewer_keywords: ["C4204"] -ms.assetid: 298d2880-6737-448e-b711-15572d540200 --- # Compiler Warning (level 4) C4204 -nonstandard extension used : non-constant aggregate initializer +> nonstandard extension used : non-constant aggregate initializer + +## Remarks With Microsoft extensions (/Ze), you can initialize aggregate types (arrays, structures, unions, and classes) with values that are not constants. ## Example +The following example generates C4204: + ```c // C4204.c // compile with: /W4 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4205.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4205.md index 82848a4a960..0d25190bf0f 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4205.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4205.md @@ -1,26 +1,29 @@ --- -description: "Learn more about: Compiler Warning (level 4) C4205" title: "Compiler Warning (level 4) C4205" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 4) C4205" +ms.date: 11/04/2016 f1_keywords: ["C4205"] helpviewer_keywords: ["C4205"] -ms.assetid: 39b5108c-7230-41b4-b2fe-2293eb6aae28 --- # Compiler Warning (level 4) C4205 -nonstandard extension used : static function declaration in function scope +> nonstandard extension used : static function declaration in function scope + +## Remarks With Microsoft extensions (/Ze), **`static`** functions can be declared inside another function. The function is given global scope. ## Example +The following example generates C4205: + ```c // C4205.c // compile with: /W4 void func1() { static int func2(); // C4205 -}; +} int main() { diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4206.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4206.md index 524ca3cc46d..606a827b03a 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4206.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4206.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Warning (level 4) C4206" title: "Compiler Warning (level 4) C4206" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 4) C4206" +ms.date: 11/04/2016 f1_keywords: ["C4206"] helpviewer_keywords: ["C4206"] -ms.assetid: 3df97812-3ed7-4003-9769-057acf97ce3c --- # Compiler Warning (level 4) C4206 -**nonstandard extension used : translation unit is empty** +> nonstandard extension used : translation unit is empty + +## Remarks The file was empty after preprocessing. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4207.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4207.md index 42e3e542084..0d9439f1572 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4207.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4207.md @@ -1,19 +1,22 @@ --- -description: "Learn more about: Compiler Warning (level 4) C4207" title: "Compiler Warning (level 4) C4207" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 4) C4207" +ms.date: 11/04/2016 f1_keywords: ["C4207"] helpviewer_keywords: ["C4207"] -ms.assetid: f4e09e3e-ac87-4489-8e3f-c8f76b82e721 --- # Compiler Warning (level 4) C4207 -nonstandard extension used : extended initializer form +> nonstandard extension used : extended initializer form + +## Remarks With Microsoft extensions (/Ze), you can initialize an unsized array of **`char`** using a string within braces. ## Example +The following example generates C4207: + ```c // C4207.c // compile with: /W4 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4208.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4208.md index 401c638542e..2c0de261003 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4208.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4208.md @@ -1,17 +1,22 @@ --- -description: "Learn more about: Compiler Warning (level 4) C4208" title: "Compiler Warning (level 4) C4208" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 4) C4208" +ms.date: 11/04/2016 f1_keywords: ["C4208"] helpviewer_keywords: ["C4208"] -ms.assetid: 5cb0a36e-3fb5-422f-a5f9-e40b70776c27 --- # Compiler Warning (level 4) C4208 -nonstandard extension used : delete [exp] - exp evaluated but ignored +> nonstandard extension used : delete [exp] - exp evaluated but ignored + +## Remarks With Microsoft extensions (/Ze), you can delete an array using a value within brackets with the [delete operator](../../cpp/delete-operator-cpp.md). The value is ignored. +## Example + +The following example generates C4208: + ```cpp // C4208.cpp // compile with: /W4 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4210.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4210.md index ba96a096f66..95522de60e4 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4210.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4210.md @@ -1,17 +1,22 @@ --- -description: "Learn more about: Compiler Warning (level 4) C4210" title: "Compiler Warning (level 4) C4210" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 4) C4210" +ms.date: 11/04/2016 f1_keywords: ["C4210"] helpviewer_keywords: ["C4210"] -ms.assetid: f8600adf-dfe2-4022-a37a-3d4997641dfd --- # Compiler Warning (level 4) C4210 -nonstandard extension used : function given file scope +> nonstandard extension used : function given file scope + +## Remarks With the default Microsoft extensions ([/Ze](../../build/reference/za-ze-disable-language-extensions.md)), function declarations have file scope. +## Example + +The following example generates C4210: + ```c // C4210.c // compile with: /W4 /c diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4211.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4211.md index 59e1af613ce..98e88e30c24 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4211.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4211.md @@ -1,19 +1,22 @@ --- -description: "Learn more about: Compiler Warning (level 4) C4211" title: "Compiler Warning (level 4) C4211" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 4) C4211" +ms.date: 11/04/2016 f1_keywords: ["C4211"] helpviewer_keywords: ["C4211"] -ms.assetid: 3eea3455-6faa-4cdb-8730-73db7026bd1f --- # Compiler Warning (level 4) C4211 -nonstandard extension used : redefined extern to static +> nonstandard extension used : redefined extern to static + +## Remarks With the default Microsoft extensions (/Ze), you can redefine an **`extern`** identifier as **`static`**. ## Example +The following example generates C4211: + ```c // C4211.c // compile with: /W4 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4212.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4212.md index d780d7bba34..4509562c90a 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4212.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4212.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Warning (level 4) C4212" title: "Compiler Warning (level 4) C4212" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 4) C4212" +ms.date: 11/04/2016 f1_keywords: ["C4212"] helpviewer_keywords: ["C4212"] -ms.assetid: df781ea1-182d-4f9f-9a31-55b6ce80c711 --- # Compiler Warning (level 4) C4212 -nonstandard extension used : function declaration used ellipsis +> nonstandard extension used : function declaration used ellipsis + +## Remarks The function prototype has a variable number of arguments. The function definition does not. -The following sample generates C4212: +## Example + +The following example generates C4212: ```c // C4212.c diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4213.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4213.md index e36443c5d57..eda0670bcba 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4213.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4213.md @@ -1,19 +1,22 @@ --- -description: "Learn more about: Compiler Warning (level 4) C4213" title: "Compiler Warning (level 4) C4213" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 4) C4213" +ms.date: 11/04/2016 f1_keywords: ["C4213"] helpviewer_keywords: ["C4213"] -ms.assetid: 59fc3f61-ebd2-499e-99d7-f57bec11eda1 --- # Compiler Warning (level 4) C4213 -nonstandard extension used : cast on l-value +> nonstandard extension used : cast on l-value + +## Remarks With the default Microsoft extensions (/Ze), you can use casts on the left side of an assignment statement. ## Example +The following example generates C4213: + ```c // C4213.c // compile with: /W4 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4214.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4214.md index 06fb277525e..26e6071374a 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4214.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4214.md @@ -1,19 +1,22 @@ --- -description: "Learn more about: Compiler Warning (level 4) C4214" title: "Compiler Warning (level 4) C4214" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 4) C4214" +ms.date: 11/04/2016 f1_keywords: ["C4214"] helpviewer_keywords: ["C4214"] -ms.assetid: 9b8db279-1f12-4a6b-a923-2db22acd1947 --- # Compiler Warning (level 4) C4214 -nonstandard extension used : bit field types other than int +> nonstandard extension used : bit field types other than int + +## Remarks With the default Microsoft extensions (/Ze), bitfield structure members can be of any integer type. ## Example +The following example generates C4214: + ```c // C4214.c // compile with: /W4 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4220.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4220.md index bf894af5583..2eba4fa6522 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4220.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4220.md @@ -1,19 +1,22 @@ --- -description: "Learn more about: Compiler Warning (level 4) C4220" title: "Compiler Warning (level 4) C4220" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 4) C4220" +ms.date: 11/04/2016 f1_keywords: ["C4220"] helpviewer_keywords: ["C4220"] -ms.assetid: aba18868-825f-4763-9af6-3296406a80e4 --- # Compiler Warning (level 4) C4220 -varargs matches remaining parameters +> varargs matches remaining parameters + +## Remarks Under the default Microsoft extensions (/Ze), a pointer to a function matches a pointer to a function with similar, but variable, arguments. ## Example +The following example generates C4220: + ```c // C4220.c // compile with: /W4 @@ -23,7 +26,7 @@ int ( *pFunc2) ( int a, int b); int main() { - if ( pFunc1 != pFunc2 ) {}; // C4220 + if ( pFunc1 != pFunc2 ) {} // C4220 } ``` diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4221.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4221.md index e88f2068aa2..95c742a069a 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4221.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4221.md @@ -1,19 +1,22 @@ --- -description: "Learn more about: Compiler Warning (level 4) C4221" title: "Compiler Warning (level 4) C4221" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 4) C4221" +ms.date: 11/04/2016 f1_keywords: ["C4221"] helpviewer_keywords: ["C4221"] -ms.assetid: 8532bd68-54dc-4526-8597-f61dcb0a0129 --- # Compiler Warning (level 4) C4221 -nonstandard extension used : 'identifier' : cannot be initialized using address of automatic variable +> nonstandard extension used : 'identifier' : cannot be initialized using address of automatic variable + +## Remarks With the default Microsoft extensions (/Ze), you can initialize an aggregate type (**array**, **`struct`**, or **`union`**) with the address of a local (automatic) variable. ## Example +The following example generates C4221: + ```c // C4221.c // compile with: /W4 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4232.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4232.md index 78d4e5ed200..392aa103b9b 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4232.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4232.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Warning (level 4) C4232" title: "Compiler Warning (level 4) C4232" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 4) C4232" +ms.date: 11/04/2016 f1_keywords: ["C4232"] helpviewer_keywords: ["C4232"] -ms.assetid: f92028a5-4ddd-43c1-97f5-4f724e5e14af --- # Compiler Warning (level 4) C4232 -nonstandard extension used : 'identifier' : address of dllimport 'dllimport' is not static, identity not guaranteed +> nonstandard extension used : 'identifier' : address of dllimport 'dllimport' is not static, identity not guaranteed + +## Remarks Under Microsoft extensions (/Ze), you can give a nonstatic value as the address of a function declared with the **`dllimport`** modifier. Under ANSI compatibility ([/Za](../../build/reference/za-ze-disable-language-extensions.md)), this causes an error. -The following sample generates C4232: +## Example + +The following example generates C4232: ```c // C4232.c diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4233.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4233.md index 7987d2e583c..0ada63cf907 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4233.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4233.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: Compiler Warning (level 1, Error) C4233" title: "Compiler Warning (level 1, Error) C4233" -ms.date: "10/25/2017" +description: "Learn more about: Compiler Warning (level 1, Error) C4233" +ms.date: 10/25/2017 f1_keywords: ["C4233"] helpviewer_keywords: ["C4233"] --- @@ -9,6 +9,8 @@ helpviewer_keywords: ["C4233"] > nonstandard extension used: '*keyword*' keyword only supported in C++, not C +## Remarks + The compiler compiled your source code as C rather than C++, and you used a keyword that is only valid in C++. The compiler compiles your source file as C if the extension of the source file is .c or you use [/Tc](../../build/reference/tc-tp-tc-tp-specify-source-file-type.md). This warning is always issued as an error. Use the [warning](../../preprocessor/warning.md) pragma to disable. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4234.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4234.md index 3b2bc5eacb5..65c487e016e 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4234.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4234.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Warning (level 4) C4234" title: "Compiler Warning (level 4) C4234" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 4) C4234" +ms.date: 11/04/2016 f1_keywords: ["C4234"] helpviewer_keywords: ["C4234"] -ms.assetid: f7fecd5c-8248-4fde-8446-502aedc357ca --- # Compiler Warning (level 4) C4234 -nonstandard extension used: 'keyword' keyword reserved for future use +> nonstandard extension used: 'keyword' keyword reserved for future use + +## Remarks The compiler does not yet implement the keyword you used. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4238.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4238.md index 679d603ef69..686daa1f665 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4238.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4238.md @@ -1,19 +1,22 @@ --- -description: "Learn more about: Compiler Warning (level 4) C4238" title: "Compiler Warning (level 4) C4238" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 4) C4238" +ms.date: 11/04/2016 f1_keywords: ["C4238"] helpviewer_keywords: ["C4238"] -ms.assetid: 5d4051d3-7b0f-43ea-8c8d-d194bfdceb71 --- # Compiler Warning (level 4) C4238 -nonstandard extension used : class rvalue used as lvalue +> nonstandard extension used : class rvalue used as lvalue + +## Remarks For compatibility with previous versions of Visual C++, Microsoft extensions (**/Ze**) allow you to use a class type as an rvalue in a context that implicitly or explicitly takes its address. In some cases, such as the example below, this can be dangerous. ## Example +The following example generates C4238: + ```cpp // C4238.cpp // compile with: /W4 /c diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4239.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4239.md index c68de7e669a..ead032c4b05 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4239.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4239.md @@ -1,20 +1,21 @@ --- -description: "Learn more about: Compiler Warning (level 4) C4239" title: "Compiler Warning (level 4) C4239" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 4) C4239" +ms.date: 11/04/2016 f1_keywords: ["C4239"] helpviewer_keywords: ["C4239"] -ms.assetid: a23dc16a-649e-4870-9a24-275de1584fcd --- # Compiler Warning (level 4) C4239 -nonstandard extension used : 'token' : conversion from 'type' to 'type' +> nonstandard extension used : 'token' : conversion from 'type' to 'type' + +## Remarks This type conversion is not allowed by the C++ standard, but it is permitted here as an extension. This warning is always followed by at least one line of explanation describing the language rule being violated. ## Examples -The following sample generates C4239. +The following example generates C4239. ```cpp // C4239.cpp @@ -32,7 +33,7 @@ void func(void) { Conversion from integral type to enum type is not strictly allowed. -The following sample generates C4239. +The following example generates C4239. ```cpp // C4239b.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4242.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4242.md index f0d4ccb1061..e122d51b7c7 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4242.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4242.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: Compiler Warning (level 3, off) C4242" title: "Compiler Warning (level 3, off) C4242" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 3, off) C4242" +ms.date: 11/04/2016 f1_keywords: ["C4242"] helpviewer_keywords: ["C4242"] --- @@ -9,13 +9,17 @@ helpviewer_keywords: ["C4242"] > '*identifier*': conversion from '*type1*' to '*type2*', possible loss of data +## Remarks + The types are different. Type conversion may result in loss of data. The compiler makes the type conversion. This warning is off by default. For more information, see [Compiler Warnings That Are Off by Default](../../preprocessor/compiler-warnings-that-are-off-by-default.md). For more information on C4242, see [Common Compiler Errors](/windows/win32/WinProg64/common-compiler-errors). -The following sample generates C4242: +## Example + +The following example generates C4242: ```cpp // C4242.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4245.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4245.md index 45dd045a043..051b3240354 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4245.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4245.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Warning (level 4) C4245" title: "Compiler Warning (level 4) C4245" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 4) C4245" +ms.date: 11/04/2016 f1_keywords: ["C4245"] helpviewer_keywords: ["C4245"] -ms.assetid: 85083d53-9cc2-4d12-b58c-6dad28f15cbe --- # Compiler Warning (level 4) C4245 > '*conversion*' : conversion from '*type1*' to '*type2*', signed/unsigned mismatch +## Remarks + You tried to convert a **`signed const`** type that has a negative value to an **`unsigned`** type. -The following sample generates C4245: +## Example + +The following example generates C4245: ```cpp // C4245.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4254.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4254.md index 7a9386692c6..03aa6d9f421 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4254.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4254.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: Compiler Warning (level 4, off) C4254" title: "Compiler Warning (level 4, off) C4254" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 4, off) C4254" +ms.date: 11/04/2016 f1_keywords: ["C4254"] helpviewer_keywords: ["C4254"] --- @@ -9,11 +9,15 @@ helpviewer_keywords: ["C4254"] > '*operator*': conversion from '*type1*':'*field_bits*' to '*type2*':'*field_bits*', possible loss of data +## Remarks + A larger bit field was assigned to a smaller bit field. There could be a loss of data. This warning is off by default. For more information, see [Compiler Warnings That Are Off by Default](../../preprocessor/compiler-warnings-that-are-off-by-default.md). -The following sample generates C4254: +## Example + +The following example generates C4254: ```cpp // C4254.cpp @@ -31,5 +35,5 @@ int main() { x->a = 4; x->a = x->b; // OK x->b = x->a; // C4254 -}; +} ``` diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4255.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4255.md index 4358f2e093d..0627f04d951 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4255.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4255.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: Compiler Warning (level 4, off) C4255" title: "Compiler Warning (level 4, off) C4255" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 4, off) C4255" +ms.date: 11/04/2016 f1_keywords: ["C4255"] helpviewer_keywords: ["C4255"] --- @@ -9,11 +9,15 @@ helpviewer_keywords: ["C4255"] > 'function' : no function prototype given: converting '()' to '(void)' +## Remarks + The compiler didn't find an explicit list of arguments to a function. This warning is for the C compiler only. This warning is off by default. For more information, see [Compiler Warnings That Are Off by Default](../../preprocessor/compiler-warnings-that-are-off-by-default.md). -The following sample generates C4255: +## Example + +The following example generates C4255: ```c // C4255.c diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4256.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4256.md index 8ce1d40f266..c7a310e4c0d 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4256.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4256.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Warning (level 4) C4256" title: "Compiler Warning (level 4) C4256" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 4) C4256" +ms.date: 11/04/2016 f1_keywords: ["C4256"] helpviewer_keywords: ["C4256"] -ms.assetid: a755a32e-895a-4837-a2b5-4ea06b736798 --- # Compiler Warning (level 4) C4256 -'function' : constructor for class with virtual bases has '...'; calls may not be compatible with older versions of Visual C++ +> 'function' : constructor for class with virtual bases has '...'; calls may not be compatible with older versions of Visual C++ + +## Remarks Possible incompatibility. @@ -20,7 +21,9 @@ To fix this warning, 1. Make sure that all components in their project are built with the current version (including any libraries that may define or reference this class), then disable the warning using the [warning](../../preprocessor/warning.md) pragma. -The following sample generates C4256: +## Example + +The following example generates C4256: ```cpp // C4256.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4263.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4263.md index 7ea2676192a..a12a0c9846e 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4263.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4263.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: Compiler Warning (level 4, off) C4263" title: "Compiler Warning (level 4, off) C4263" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 4, off) C4263" +ms.date: 11/04/2016 f1_keywords: ["C4263"] helpviewer_keywords: ["C4263"] --- @@ -9,11 +9,15 @@ helpviewer_keywords: ["C4263"] > 'function' : member function does not override any base class virtual member function +## Remarks + A class function definition has the same name as a virtual function in a base class but not the same number or type of arguments. This pattern effectively hides the virtual function in the base class. This warning is off by default. For more information, see [Compiler Warnings That Are Off by Default](../../preprocessor/compiler-warnings-that-are-off-by-default.md). -The following sample generates C4263: +## Example + +The following example generates C4263: ```cpp // C4263.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4266.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4266.md index 88e8e554dfd..9d1dcb0c856 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4266.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4266.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: Compiler Warning (level 4, off) C4266" title: "Compiler Warning (level 4, off) C4266" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 4, off) C4266" +ms.date: 11/04/2016 f1_keywords: ["C4266"] helpviewer_keywords: ["C4266"] --- @@ -9,11 +9,15 @@ helpviewer_keywords: ["C4266"] > 'function' : no override available for virtual member function from base 'type'; function is hidden +## Remarks + A derived class didn't override all overloads of a virtual function. This warning is off by default. For more information, see [Compiler Warnings That Are Off by Default](../../preprocessor/compiler-warnings-that-are-off-by-default.md). -The following sample generates C4266: +## Example + +The following example generates C4266: ```cpp // C4266.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4268.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4268.md index 7ec668928d4..1ec1be39767 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4268.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4268.md @@ -1,19 +1,22 @@ --- -description: "Learn more about: Compiler Warning (level 4) C4268" title: "Compiler Warning (level 4) C4268" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 4) C4268" +ms.date: 11/04/2016 f1_keywords: ["C4268"] helpviewer_keywords: ["C4268"] -ms.assetid: d0511e80-904f-4ee1-b4d7-39b5c0bd8234 --- # Compiler Warning (level 4) C4268 -'identifier' : 'const' static/global data initialized with compiler generated default constructor fills the object with zeros +> 'identifier' : 'const' static/global data initialized with compiler generated default constructor fills the object with zeros + +## Remarks A **`const`** global or static instance of a non-trivial class is initialized with a compiler-generated default constructor. ## Example +The following example generates C4268: + ```cpp // C4268.cpp // compile with: /c /LD /W4 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4289.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4289.md index e12bb325ac9..62b99960d88 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4289.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4289.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: Compiler Warning (level 4, off) C4289" title: "Compiler Warning (level 4, off) C4289" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 4, off) C4289" +ms.date: 11/04/2016 f1_keywords: ["C4289"] helpviewer_keywords: ["C4289"] --- @@ -9,13 +9,17 @@ helpviewer_keywords: ["C4289"] > nonstandard extension used : 'var' : loop control variable declared in the `for`-loop is used outside the `for`-loop scope +## Remarks + When [/Ze](../../build/reference/za-ze-disable-language-extensions.md) and **/Zc:forScope-** are used in a build, a variable declared in a [`for`](../../cpp/for-statement-cpp.md) loop was used after the **`for`**-loop scope. See [/Zc:forScope](../../build/reference/zc-forscope-force-conformance-in-for-loop-scope.md) for information about how to specify standard behavior in **`for`** loops with **/Ze**. This warning is off by default. For more information, see [Compiler Warnings That Are Off by Default](../../preprocessor/compiler-warnings-that-are-off-by-default.md). -The following sample generates C4289: +## Example + +The following example generates C4289: ```cpp // C4289.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4295.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4295.md index f14ac9570c2..05a88c4b3b7 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4295.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4295.md @@ -1,20 +1,21 @@ --- -description: "Learn more about: Compiler Warning (level 4) C4295" title: "Compiler Warning (level 4) C4295" -ms.date: "01/09/2018" +description: "Learn more about: Compiler Warning (level 4) C4295" +ms.date: 01/09/2018 f1_keywords: ["C4295"] helpviewer_keywords: ["C4295"] -ms.assetid: 20dbff85-9f62-4ca3-8fe9-079d4512006d --- # Compiler Warning (level 4) C4295 > '*array*' : array is too small to include a terminating null character +## Remarks + An array was initialized but the last character in the array is not a null; accessing the array as a string may produce unexpected results. ## Example -The following sample generates C4295. To fix this issue, you could declare the array size larger, to hold a terminating null from the initializer string, or you could use an array initializer list to make the intent clear that this is an array of **`char`**, not a null-terminated string. +The following example generates C4295. To fix this issue, you could declare the array size larger, to hold a terminating null from the initializer string, or you could use an array initializer list to make the intent clear that this is an array of **`char`**, not a null-terminated string. ```C // C4295.c diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4296.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4296.md index 39cb0b6e93b..3f8d63d993a 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4296.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4296.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: Compiler Warning (level 4, off) C4296" title: "Compiler Warning (level 4, off) C4296" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 4, off) C4296" +ms.date: 11/04/2016 f1_keywords: ["C4296"] helpviewer_keywords: ["C4296"] --- @@ -9,11 +9,15 @@ helpviewer_keywords: ["C4296"] > 'operator' : expression is always false +## Remarks + An unsigned variable was used in a comparison operation with zero. This warning is off by default. For more information, see [Compiler Warnings That Are Off by Default](../../preprocessor/compiler-warnings-that-are-off-by-default.md). -The following sample generates C4296: +## Example + +The following example generates C4296: ```cpp // C4296.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4336.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4336.md index 4a777866930..2506a4b3f12 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4336.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4336.md @@ -1,17 +1,20 @@ --- -description: "Learn more about: Compiler Warning (level 4) C4336" title: "Compiler Warning (level 4) C4336" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 4) C4336" +ms.date: 11/04/2016 f1_keywords: ["C4336"] helpviewer_keywords: ["C4336"] -ms.assetid: 93f199dd-d6dd-42c0-82d8-c12d101a7235 --- # Compiler Warning (level 4) C4336 -import cross-referenced type library 'type_lib1' before importing 'type_lib2' +> import cross-referenced type library 'type_lib1' before importing 'type_lib2' + +## Remarks A type library was referenced with the [#import](../../preprocessor/hash-import-directive-cpp.md) directive. However, the type library contained a reference to another type library that was not referenced with `#import`. This other .tlb file was found by the compiler. +## Example + Given two type libraries on disk created from the following two files (compiled with midl.exe): ``` @@ -43,7 +46,7 @@ library C4336bLib }; ``` -The following sample generates C4336: +The following example generates C4336: ```cpp // C4336.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4337.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4337.md index ada48dd852b..6d7bd6bc2d7 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4337.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4337.md @@ -1,17 +1,20 @@ --- -description: "Learn more about: Compiler Warning (level 4) C4337" title: "Compiler Warning (level 4) C4337" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 4) C4337" +ms.date: 11/04/2016 f1_keywords: ["C4337"] helpviewer_keywords: ["C4337"] -ms.assetid: 70bc72d9-aac5-45cd-abd3-ebe42a05897b --- # Compiler Warning (level 4) C4337 -cross-referenced type library 'typelib1' in 'typelib2' is being automatically imported +> cross-referenced type library 'typelib1' in 'typelib2' is being automatically imported + +## Remarks The auto_search attribute of [the #import directive](../../preprocessor/hash-import-directive-cpp.md) caused a type library to be implicitly imported. +## Example + Given two type libraries on disk created from the following two files (compiled with midl.exe): ``` @@ -51,7 +54,7 @@ library C4337bLib }; ``` -The following sample generates C4337: +The following example generates C4337: ```cpp // C4337.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4339.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4339.md index 77a9a5a3e57..5b6c4e3b290 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4339.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4339.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: Compiler Warning (level 4, off) C4339" title: "Compiler Warning (level 4, off) C4339" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 4, off) C4339" +ms.date: 11/04/2016 f1_keywords: ["C4339"] helpviewer_keywords: ["C4339"] --- @@ -9,11 +9,15 @@ helpviewer_keywords: ["C4339"] > 'type' : use of undefined type detected in WinRT or CLR meta-data - use of this type may lead to a runtime exception +## Remarks + A type wasn't defined in code that was compiled for Windows Runtime or the common language runtime. Define the type to avoid a possible runtime exception. This warning is off by default. For more information, see [Compiler Warnings That Are Off by Default](../../preprocessor/compiler-warnings-that-are-off-by-default.md). -The following sample generates C4339 and shows how to fix it: +## Example + +The following example generates C4339 and shows how to fix it: ```cpp // C4339.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4343.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4343.md index 57b03021c75..675978f9976 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4343.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4343.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Warning (level 4) C4343" title: "Compiler Warning (level 4) C4343" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 4) C4343" +ms.date: 11/04/2016 f1_keywords: ["C4343"] helpviewer_keywords: ["C4343"] -ms.assetid: a721b710-e04f-4d15-b678-e4a2c8fd0181 --- # Compiler Warning (level 4) C4343 -\#pragma optimize("g",off) overrides /Og option +> #pragma optimize("g",off) overrides /Og option + +## Remarks This warning, only valid in the Itanium Processor Family (IPF) compiler, reports that a pragma [optimize](../../preprocessor/optimize.md) overrode a [/Og](../../build/reference/og-global-optimizations.md) compiler option. -The following sample generates C4343: +## Example + +The following example generates C4343: ```cpp // C4343.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4365.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4365.md index d26dec6ad77..25320e16d28 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4365.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4365.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: Compiler Warning (level 4, off) C4365" title: "Compiler Warning (level 4, off) C4365" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 4, off) C4365" +ms.date: 11/04/2016 f1_keywords: ["C4365"] helpviewer_keywords: ["C4365"] --- @@ -9,13 +9,15 @@ helpviewer_keywords: ["C4365"] > 'action' : conversion from 'type_1' to 'type_2', signed/unsigned mismatch +## Remarks + For example, you tried to convert an unsigned value to a signed value. This pattern can cause unexpected results when the source value at runtime in not in the range of the destination type. Such as a negative value being converted into a signed value. C4365 is off by default. For more information, see [Compiler Warnings That Are Off by Default](../../preprocessor/compiler-warnings-that-are-off-by-default.md). ## Example -The following sample generates C4365. +The following example generates C4365. ```cpp // C4365.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4366.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4366.md index 8ffd8a63f5d..91679dc7baf 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4366.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4366.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Warning (level 4) C4366" title: "Compiler Warning (level 4) C4366" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 4) C4366" +ms.date: 11/04/2016 f1_keywords: ["C4366"] helpviewer_keywords: ["C4366"] -ms.assetid: 65d2942f-3741-42f4-adf2-4920d5a055ca --- # Compiler Warning (level 4) C4366 -The result of the unary 'operator' operator may be unaligned +> The result of the unary 'operator' operator may be unaligned + +## Remarks If a structure member could ever be unaligned because of packing, the compiler will warn when that member's address is assigned to an aligned pointer. By default, all pointers are aligned. @@ -18,7 +19,7 @@ For more information, see __unaligned and [pack](../../preprocessor/pack.md). ## Example -The following sample generates C4366. +The following example generates C4366. ```cpp // C4366.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4389.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4389.md index ce2dce28c34..0de7bed8b0d 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4389.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4389.md @@ -9,15 +9,15 @@ helpviewer_keywords: ["C4389"] > '*equality-operator*' : signed/unsigned mismatch -An **`==`** or **`!=`** operation involved **`signed`** and **`unsigned`** variables. This could result in a loss of data. - ## Remarks +An **`==`** or **`!=`** operation involved **`signed`** and **`unsigned`** variables. This could result in a loss of data. + One way to fix this warning is if you cast one of the two types when you compare **`signed`** and **`unsigned`** types. ## Example -The following sample generates C4389: +The following example generates C4389: ```cpp // C4389.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4400.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4400.md index 071fc9c192d..75de9e5fcd0 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4400.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4400.md @@ -1,20 +1,21 @@ --- -description: "Learn more about: Compiler Warning (level 4) C4400" -title: "Compiler Warning (level 4) C4400" -ms.date: "11/04/2016" +title: "Compiler warning (level 4, error) C4400" +description: "Learn more about: Compiler Warning (level 4, error) C4400" +ms.date: 1/22/2025 f1_keywords: ["C4400"] helpviewer_keywords: ["C4400"] -ms.assetid: f135fe98-4f92-4e07-9d71-2621b36ee755 --- -# Compiler Warning (level 4) C4400 +# Compiler warning (level 4, error) C4400 -'type' : const/volatile qualifiers on this type are not supported +> '*type*': `const`/`volatile` qualifiers on this type are not supported -The [const](../../cpp/const-cpp.md)and [volatile](../../cpp/volatile-cpp.md)qualifiers will not work with variables of common language runtime types. +## Remarks + +The [`const`](../../cpp/const-cpp.md) and [`volatile`](../../cpp/volatile-cpp.md) qualifiers don't work with common language runtime typed variables. ## Example -The following sample generates C4400. +The following example generates C4400. ```cpp // C4400.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4408.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4408.md index b41f58b75a0..80c566c3d8a 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4408.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4408.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Warning (level 4) C4408" title: "Compiler Warning (level 4) C4408" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 4) C4408" +ms.date: 11/04/2016 f1_keywords: ["C4408"] helpviewer_keywords: ["C4408"] -ms.assetid: 8488a186-ed1d-425c-aaeb-c72472c1da68 --- # Compiler Warning (level 4) C4408 -anonymousstruct or union did not declare any data members +> anonymousstruct or union did not declare any data members + +## Remarks An anonymous struct or union must have at least one data member. -The following sample generates C4408: +## Example + +The following example generates C4408: ```cpp // C4408.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4429.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4429.md index 145ec9b1aa3..f4fae6bd4dc 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4429.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4429.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Warning (level 4) C4429" title: "Compiler Warning (level 4) C4429" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 4) C4429" +ms.date: 11/04/2016 f1_keywords: ["C4429"] helpviewer_keywords: ["C4429"] -ms.assetid: a3e4cf1f-a869-4e47-834a-850c21eb5297 --- # Compiler Warning (level 4) C4429 -possible incomplete or improperly formed universal-character-name +> possible incomplete or improperly formed universal-character-name + +## Remarks The compiler detected a character sequence that may be a badly formed universal character name. A universal character name is `\u` followed by four hex digits, or `\U` followed by eight hex digits. -The following sample generates C4429: +## Example + +The following example generates C4429: ```cpp // C4429.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4431.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4431.md index bba0bbce56a..68660c09337 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4431.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4431.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Warning (level 4) C4431" title: "Compiler Warning (level 4) C4431" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 4) C4431" +ms.date: 11/04/2016 f1_keywords: ["C4431"] helpviewer_keywords: ["C4431"] -ms.assetid: 58434ab6-dd8d-427b-953a-602fb7453ae6 --- # Compiler Warning (level 4) C4431 -missing type specifier - int assumed. Note: C no longer supports default-int +> missing type specifier - int assumed. Note: C no longer supports default-int + +## Remarks This error can be generated as a result of compiler conformance work that was done for Visual Studio 2005: Visual C++ no longer creates untyped identifiers as int by default. The type of an identifier must be specified explicitly. @@ -16,7 +17,7 @@ This warning is off by default. See [Compiler Warnings That Are Off by Default]( ## Example -The following sample generates C4431. +The following example generates C4431. ```c // C4431.c diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4434.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4434.md index 0315bf031dc..6b7e6b52ba9 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4434.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4434.md @@ -1,20 +1,21 @@ --- -description: "Learn more about: Compiler Warning (level 4) C4434" title: "Compiler Warning (level 4) C4434" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 4) C4434" +ms.date: 11/04/2016 f1_keywords: ["C4434"] helpviewer_keywords: ["C4434"] -ms.assetid: 24b8785e-353a-4c37-8bed-ed61001a871d --- # Compiler Warning (level 4) C4434 -a class constructor must have private accessibility; changing to private access +> a class constructor must have private accessibility; changing to private access + +## Remarks C4434 indicates that the compiler changed the accessibility of a static constructor. Static constructors must have private accessibility, as they are only meant to be called by the common language runtime. For more information, see [Static constructors](../../dotnet/how-to-define-and-consume-classes-and-structs-cpp-cli.md#BKMK_Static_constructors). ## Example -The following sample generates C4434. +The following example generates C4434. ```cpp // C4434.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4435.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4435.md index c60d859b888..aa094d91d24 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4435.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4435.md @@ -1,22 +1,23 @@ --- -description: "Learn more about: Compiler Warning (level 4) C4435" -title: "Compiler Warning (level 4) C4435" -ms.date: "11/04/2016" +title: "Compiler Warning (level 4, off) C4435" +description: "Learn more about: Compiler Warning (level 4, off) C4435" +ms.date: 1/22/2025 f1_keywords: ["C4435"] helpviewer_keywords: ["C4435"] -ms.assetid: a04524af-2b71-4ff9-9729-d9d1d1904ed7 --- -# Compiler Warning (level 4) C4435 +# Compiler warning (level 4, off) C4435 -'class1' : Object layout under /vd2 will change due to virtual base 'class2' +> '*derived_class*': Object layout under `/vd2` will change due to virtual base '*base_class*' -This warning is off by default. See [Compiler Warnings That Are Off by Default](../../preprocessor/compiler-warnings-that-are-off-by-default.md) for more information. +## Remarks -Under the default compile option of /vd1, the derived class does not have a `vtordisp` field for the indicated virtual base. If /vd2 or `#pragma vtordisp(2)` is in effect, a `vtordisp` field will be present, changing the object layout. This can lead to binary compatibility problems if interacting modules are compiled with different `vtordisp` settings. +This warning is off by default. For more information, see [Compiler Warnings That Are Off by Default](../../preprocessor/compiler-warnings-that-are-off-by-default.md). + +Under the default compile option of `/vd1`, the derived class doesn't have a `vtordisp` field for the indicated virtual base. If `/vd2` or `#pragma vtordisp(2)` is in effect, a `vtordisp` field is present, changing the object layout. This difference can lead to binary compatibility problems if interacting modules are compiled with different `vtordisp` settings. ## Example -The following sample generates C4435. +The following example generates C4435. ```cpp // C4435.cpp @@ -34,5 +35,5 @@ class B : public virtual A // C4435 ## See also -[vtordisp](../../preprocessor/vtordisp.md)
-[/vd (Disable Construction Displacements)](../../build/reference/vd-disable-construction-displacements.md) +[`vtordisp`](../../preprocessor/vtordisp.md)\ +[`/vd` (Disable Construction Displacements)](../../build/reference/vd-disable-construction-displacements.md) diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4437.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4437.md index a2207a1ad8e..5e09076edc4 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4437.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4437.md @@ -1,32 +1,30 @@ --- -description: "Learn more about: Compiler Warning (level 4) C4437" -title: "Compiler Warning (level 4) C4437" -ms.date: "11/04/2016" +title: "Compiler warning (level 1 and level 4, off) C4437" +description: "Learn more about: Compiler Warning (level 1 and level 4, off) C4437" +ms.date: 1/22/2025 f1_keywords: ["C4437"] helpviewer_keywords: ["C4437"] -ms.assetid: dc07e350-20eb-474c-a7ad-f841ae7ec339 --- -# Compiler Warning (level 4) C4437 +# Compiler warning (level 1 and level 4, off) C4437 -dynamic_cast from virtual base 'class1' to 'class2' could fail in some contexts Compile with /vd2 or define 'class2' with #pragma vtordisp(2) in effect +> `dynamic_cast` from virtual base '*base_class*' to '*derived_class*' could fail in some contexts -This warning is off by default. See [Compiler Warnings That Are Off by Default](../../preprocessor/compiler-warnings-that-are-off-by-default.md) for more information. +## Remarks -The compiler has encountered a **`dynamic_cast`** operation with the following characteristics. +This warning is off by default. For more information, see [Compiler Warnings That Are Off by Default](../../preprocessor/compiler-warnings-that-are-off-by-default.md). -- The cast is from a base class pointer to a derived class pointer. +A `dynamic_cast` operation is used when: +- The cast is from a base class pointer to a derived class pointer. - The derived class virtually inherits the base class. +- The derived class doesn't have a `vtordisp` field for the virtual base. +- The cast is found in a constructor or destructor of the derived class, or a class that inherits from the derived class. Otherwise, compiler warning [C4436](compiler-warning-level-1-c4436.md) is emitted issued of C4435. -- The derived class does not have a `vtordisp` field for the virtual base. - -- The cast is not found in a constructor or destructor of the derived class, or some class which further inherits from the derived class (otherwise, compiler warning C4436 will be issued). - -The warning indicates that the **`dynamic_cast`** might not perform correctly if it is operating on a partially-constructed object. This situation occurs when the enclosing function is called from a constructor or destructor of a class that inherits the derived class that is named in the warning. If the derived class that is named in the warning is never further derived, or the enclosing function is not called during object construction or destruction, the warning can be ignored. +This warning indicates that the `dynamic_cast` might not perform correctly when applied to a partially constructed object. This situation occurs when the enclosing function is called from a constructor or destructor of a class that inherits from *derived_class*. You can ignore the error if *derived_class* is never further derived, or the enclosing function isn't called during object construction or destruction. ## Example -The following sample generates C4437 and demonstrates the code generation issue that arises from the missing `vtordisp` field. +The following example generates C4437 and demonstrates the code generation issue that arises from the missing `vtordisp` field: ```cpp // C4437.cpp @@ -76,6 +74,6 @@ int main() ## See also -[dynamic_cast Operator](../../cpp/dynamic-cast-operator.md)
-[vtordisp](../../preprocessor/vtordisp.md)
-[Compiler Warning (level 1) C4436](../../error-messages/compiler-warnings/compiler-warning-level-1-c4436.md) +[`dynamic_cast` Operator](../../cpp/dynamic-cast-operator.md)\ +[`vtordisp`](../../preprocessor/vtordisp.md)\ +[Compiler Warning (level 1) C4436](compiler-warning-level-1-c4436.md) diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4456.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4456.md index 3860789485b..a86eb36dd45 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4456.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4456.md @@ -1,20 +1,21 @@ --- -description: "Learn more about: Compiler Warning (level 4) C4456" title: "Compiler Warning (level 4) C4456" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 4) C4456" +ms.date: 11/04/2016 f1_keywords: ["C4456"] helpviewer_keywords: ["C4456"] -ms.assetid: 5ab39fc1-0e19-461b-842b-4da80560b044 --- # Compiler Warning (level 4) C4456 > declaration of '*identifier*' hides previous local declaration +## Remarks + The declaration of *identifier* in the local scope hides the declaration of the previous local declaration of the same name. This warning lets you know that references to *identifier* in the local scope resolve to the locally declared version, not the previous local, which may or may not be your intent. To fix this issue, we recommend you give local variables names that do not conflict with other local names. ## Example -The following sample generates C4456 because the loop control variable `int x` and the local variable `double x` in `member_fn` have the same names. To fix this issue, use different names for the local variables. +The following example generates C4456 because the loop control variable `int x` and the local variable `double x` in `member_fn` have the same names. To fix this issue, use different names for the local variables. ```cpp // C4456_hide.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4457.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4457.md index af7a117ea6a..7f39af8da85 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4457.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4457.md @@ -1,20 +1,21 @@ --- -description: "Learn more about: Compiler Warning (level 4) C4457" title: "Compiler Warning (level 4) C4457" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 4) C4457" +ms.date: 11/04/2016 f1_keywords: ["C4457"] helpviewer_keywords: ["C4457"] -ms.assetid: 02fd149a-917d-4f67-97a6-eb714572271f --- # Compiler Warning (level 4) C4457 > declaration of '*identifier*' hides function parameter +## Remarks + The declaration of *identifier* in the local scope hides the declaration of the identically-named function parameter. This warning lets you know that references to *identifier* in the local scope resolve to the locally declared version, not the parameter, which may or may not be your intent. To fix this issue, we recommend you give local variables names that do not conflict with parameter names. ## Example -The following sample generates C4457 because the parameter `x` and the local variable `x` in `member_fn` have the same names. To fix this issue, use different names for the parameters and local variables. +The following example generates C4457 because the parameter `x` and the local variable `x` in `member_fn` have the same names. To fix this issue, use different names for the parameters and local variables. ```cpp // C4457_hide.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4458.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4458.md index 0aaf058dd0c..c1189b04ffb 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4458.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4458.md @@ -1,20 +1,21 @@ --- -description: "Learn more about: Compiler Warning (level 4) C4458" title: "Compiler Warning (level 4) C4458" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 4) C4458" +ms.date: 11/04/2016 f1_keywords: ["C4458"] helpviewer_keywords: ["C4458"] -ms.assetid: 7bdaa1b1-0caf-4d68-98c4-6bdd441c23fb --- # Compiler Warning (level 4) C4458 > declaration of '*identifier*' hides class member +## Remarks + The declaration of *identifier* in the local scope hides the declaration of the identically-named *identifier* at class scope. This warning lets you know that references to *identifier* in this scope resolve to the locally declared version, not the class member version, which may or may not be your intent. To fix this issue, we recommend you give local variables names that do not conflict with class member names. ## Example -The following sample generates C4458 because the parameter `x` and the local variable `y` in `member_fn` have the same names as data members in the class. To fix this issue, use different names for the parameters and local variables. +The following example generates C4458 because the parameter `x` and the local variable `y` in `member_fn` have the same names as data members in the class. To fix this issue, use different names for the parameters and local variables. ```cpp // C4458_hide.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4459.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4459.md index ec827f8b2f7..417dfe669c4 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4459.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4459.md @@ -1,22 +1,23 @@ --- -description: "Learn more about: Compiler Warning (level 4) C4459" title: "Compiler Warning (level 4) C4459" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 4) C4459" +ms.date: 11/04/2016 f1_keywords: ["C4459"] helpviewer_keywords: ["C4459"] -ms.assetid: ee9f6287-9c70-4b10-82a0-add82a13997f --- # Compiler Warning (level 4) C4459 > declaration of '*identifier*' hides global declaration +## Remarks + The declaration of *identifier* in the local scope hides the declaration of the identically-named *identifier* in global scope. This warning lets you know that references to *identifier* in this scope resolve to the locally declared version, not the global version, which may or may not be your intent. Generally, we recommend you minimize the use of global variables as a good engineering practice. To minimize pollution of the global namespace, we recommend use of a named namespace for global variables. This warning was new in Visual Studio 2015, in Microsoft C++ compiler version 18.00. To suppress warnings from that version of the compiler or later while migrating your code, use the [/Wv:18](../../build/reference/compiler-option-warning-level.md) compiler option. ## Example -The following sample generates C4459: +The following example generates C4459: ```cpp // C4459_hide.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4460.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4460.md index 6a990f6f678..df25079de59 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4460.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4460.md @@ -1,20 +1,21 @@ --- -description: "Learn more about: Compiler Warning (level 4) C4460" title: "Compiler Warning (level 4) C4460" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 4) C4460" +ms.date: 11/04/2016 f1_keywords: ["C4460"] helpviewer_keywords: ["C4460"] -ms.assetid: c97ac1c9-598d-479e-bfff-c993690c4f3d --- # Compiler Warning (level 4) C4460 -WinRT or CLR operator 'operator', has parameter passed by reference. WinRT or CLR operator 'operator' has different semantics from C++ operator 'operator', did you intend to pass by value? +> WinRT or CLR operator 'operator', has parameter passed by reference. WinRT or CLR operator 'operator' has different semantics from C++ operator 'operator', did you intend to pass by value? + +## Remarks You passed a value by reference to a user-defined Windows Runtime or CLR operator. If the value is changed inside the function, note that the value returned after the function call will be assigned the return value of the function. In standard C++, the changed value is reflected after the function call. ## Example -The following sample generates C4460 and shows how to fix it. +The following example generates C4460 and shows how to fix it. ```cpp // C4460.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4463.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4463.md index 11df8f1e4da..ea4619ef50c 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4463.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4463.md @@ -1,15 +1,16 @@ --- -description: "Learn more about: Compiler Warning (level 4) C4463" title: "Compiler Warning (level 4) C4463" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 4) C4463" +ms.date: 11/04/2016 f1_keywords: ["C4463"] helpviewer_keywords: ["C4463"] -ms.assetid: a07ae70c-db4e-472b-8b58-9137d9997323 --- # Compiler Warning (level 4) C4463 > overflow; assigning *value* to bit-field that can only hold values from *low_value* to *high_value* +## Remarks + The assigned *value* is outside the range of values that the bit-field can hold. Signed bit-field types use the high-order bit for the sign, so if *n* is the bit-field size, the range for signed bit-fields is -2n-1 to 2n-1-1, while unsigned bit-fields have a range from 0 to 2n-1. ## Example diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4464.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4464.md index ca3587adeaf..ed8362ff037 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4464.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4464.md @@ -1,6 +1,6 @@ --- -description: "Learn more about: Compiler Warning (level 4, off) C4464" title: "Compiler Warning (level 4) C4464" +description: "Learn more about: Compiler Warning (level 4, off) C4464" ms.date: 09/14/2022 f1_keywords: ["C4464"] helpviewer_keywords: ["C4464"] @@ -9,10 +9,10 @@ helpviewer_keywords: ["C4464"] > relative include path contains '..' -A `#include` directive has a path that includes a parent directory specifier (a `..` path segment). - ## Remarks +A `#include` directive has a path that includes a parent directory specifier (a `..` path segment). + In Visual Studio 2015 Update 1 and later versions, if enabled, the compiler can detect and issue a warning for a `#include` directive that contains a parent directory path segment (`..`). Code is sometimes written that uses parent directory relative paths to include headers from external libraries. When these parent directory-relative header paths are specified in source files, it creates a risk: The program could be compiled by including a different header file than the programmer intends. These relative paths may not be portable to other developers' build environments. Instead, we recommend you specify the paths to such headers in the build environment, such as in the `INCLUDE` environment variable or in parameters to the [`/I` (Additional include directories)](../../build/reference/i-additional-include-directories.md) compiler option. In the Visual Studio IDE, you can set the paths in your project's **Configuration Properties** > **C/C++** > **General** property page, in the **Additional Include Directories** property. Although there's no specific warning for it, we also don't recommend use of parent directory path segments when you specify your project's include directories. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4471.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4471.md index 958561ae411..fdba3fbfe5b 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4471.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4471.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Warning (level 4) C4471" title: "Compiler Warning (level 4) C4471" -ms.date: "04/24/2017" +description: "Learn more about: Compiler Warning (level 4) C4471" +ms.date: 04/24/2017 f1_keywords: ["C4471"] helpviewer_keywords: ["C4471"] -ms.assetid: ccfd8bd5-bc1b-4be7-a6ea-0e3a7add6607 --- # Compiler Warning (level 4) C4471 -'*enumeration*': a forward declaration of an unscoped enumeration must have an underlying type (int assumed) +> '*enumeration*': a forward declaration of an unscoped enumeration must have an underlying type (int assumed) + +## Remarks A forward declaration of an unscoped enumeration was found without a specifier for the underlying type. By default, Visual C++ assumes **`int`** is the underlying type for an enumeration. This can cause issues if a different type is used in the enumeration definition, for example, if a different explicit type is specified, or if a different type is implicitly set by an initializer. You may also have portability issues; other compilers do not assume **`int`** is the underlying type of an enumeration. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4481.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4481.md index 3320ac5730d..adcda6aff5f 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4481.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4481.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Warning (level 4) C4481" title: "Compiler Warning (level 4) C4481" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 4) C4481" +ms.date: 11/04/2016 f1_keywords: ["C4481"] helpviewer_keywords: ["C4481"] -ms.assetid: 7bfd4e0c-b452-4e6c-b7c4-ac5cc93fe4ea --- # Compiler Warning (level 4) C4481 -nonstandard extension used: override specifier 'keyword' +> nonstandard extension used: override specifier 'keyword' + +## Remarks A keyword was used that is not in the C++ standard, for example, one of the override specifiers that also works under /clr. For more information, see, @@ -18,7 +19,7 @@ A keyword was used that is not in the C++ standard, for example, one of the over ## Example -The following sample generates C4481. +The following example generates C4481. ```cpp // C4481.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4487.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4487.md index 376ae3a09e2..d51cec97ca6 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4487.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4487.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Warning (level 4) C4487" title: "Compiler Warning (level 4) C4487" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 4) C4487" +ms.date: 11/04/2016 f1_keywords: ["C4487"] helpviewer_keywords: ["C4487"] -ms.assetid: 796144cf-cd3c-4edc-b6a4-96192b7eb4f0 --- # Compiler Warning (level 4) C4487 -'derived_class_function' : matches inherited non-virtual method 'base_class_function' but is not explicitly marked 'new' +> 'derived_class_function' : matches inherited non-virtual method 'base_class_function' but is not explicitly marked 'new' + +## Remarks A function in a derived class has the same signature as a non-virtual base class function. C4487 reminds you that the derived class function does not override the base class function. Explicitly mark the derived class function as **`new`** to resolve this warning. @@ -16,7 +17,7 @@ For more information, see [new (new slot in vtable)](../../extensions/new-new-sl ## Example -The following sample generates C4487. +The following example generates C4487. ```cpp // C4487.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4505.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4505.md index 018e89e157d..9c7d9989148 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4505.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4505.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Warning (level 4) C4505" title: "Compiler Warning (level 4) C4505" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 4) C4505" +ms.date: 11/04/2016 f1_keywords: ["C4505"] helpviewer_keywords: ["C4505"] -ms.assetid: 068716a0-7dd2-40af-abf4-478f893b48c5 --- # Compiler Warning (level 4) C4505 -'function' : unreferenced local function has been removed +> 'function' : unreferenced local function has been removed + +## Remarks The given function is local and not referenced in the body of the module; therefore, the function is dead code. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4510.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4510.md index 7026350d29e..3ed173e3f0a 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4510.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4510.md @@ -1,15 +1,16 @@ --- title: "Compiler Warning (level 4) C4510" -description: Compiler warning C4510 description and solution. -ms.date: "09/22/2019" +description: "Compiler warning C4510 description and solution." +ms.date: 09/22/2019 f1_keywords: ["C4510"] helpviewer_keywords: ["C4510"] -ms.assetid: fd28d1d4-ad27-4dad-94c0-9dba46c93180 --- # Compiler Warning (level 4) C4510 > '*class*' : default constructor could not be generated +## Remarks + The compiler can't generate a default constructor for the specified class, which has no user-defined constructors. Objects of this type can't be created. There are several situations that prevent the compiler from generating a default constructor, including: diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4512.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4512.md index 2a43b103223..ab781a65058 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4512.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4512.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Warning (level 4) C4512" title: "Compiler Warning (level 4) C4512" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 4) C4512" +ms.date: 11/04/2016 f1_keywords: ["C4512"] helpviewer_keywords: ["C4512"] -ms.assetid: afb68995-684a-4be5-a73a-38d7a16dc030 --- # Compiler Warning (level 4) C4512 -'class' : assignment operator could not be generated +> 'class' : assignment operator could not be generated + +## Remarks The compiler cannot generate an assignment operator for the given class. No assignment operator was created. @@ -28,7 +29,7 @@ You can resolve the C4512 warning for your code in one of three ways: ## Example -The following sample generates C4512. +The following example generates C4512. ```cpp // C4512.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4513.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4513.md index ebc5ecc71f9..9261d6c13dd 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4513.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4513.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Compiler Warning (level 4) C4513" title: "Compiler Warning (level 4) C4513" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 4) C4513" +ms.date: 11/04/2016 f1_keywords: ["C4513"] helpviewer_keywords: ["C4513"] -ms.assetid: 6877334a-f30a-4184-9483-dac3348737a4 --- # Compiler Warning (level 4) C4513 -'class' : destructor could not be generated +> 'class' : destructor could not be generated + +## Remarks The compiler cannot generate a default destructor for the given class; no destructor was created. The destructor is in a base class that is not accessible to the derived class. If the base class has a private destructor, make it public or protected. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4514.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4514.md index ea7cba7688b..f0098802be9 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4514.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4514.md @@ -1,20 +1,23 @@ --- -description: "Learn more about: Compiler Warning (level 4) C4514" title: "Compiler Warning (level 4) C4514" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 4) C4514" +ms.date: 11/04/2016 f1_keywords: ["C4514"] helpviewer_keywords: ["C4514"] -ms.assetid: cdae966a-9cd4-4e31-af30-2a014e68f614 --- # Compiler Warning (level 4) C4514 -'function' : unreferenced inline function has been removed +> 'function' : unreferenced inline function has been removed + +## Remarks The optimizer removed an inline function that is not called. This warning is off by default. See [Compiler Warnings That Are Off by Default](../../preprocessor/compiler-warnings-that-are-off-by-default.md) for more information. -The following sample generates C4514: +## Example + +The following example generates C4514: ```cpp // C4514.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4515.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4515.md index 525da292979..b6633afa237 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4515.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4515.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Warning (level 4) C4515" title: "Compiler Warning (level 4) C4515" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 4) C4515" +ms.date: 11/04/2016 f1_keywords: ["C4515"] helpviewer_keywords: ["C4515"] -ms.assetid: 167b5177-3f89-418b-b6c8-7de634f6b28f --- # Compiler Warning (level 4) C4515 -'namespace' : namespace uses itself +> 'namespace' : namespace uses itself + +## Remarks A namespace is used recursively. -The following sample generates C4515: +## Example + +The following example generates C4515: ```cpp // C4515.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4516.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4516.md index 95e905c9ac8..0ac56deda3b 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4516.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4516.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Warning (level 4) C4516" title: "Compiler Warning (level 4) C4516" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 4) C4516" +ms.date: 11/04/2016 f1_keywords: ["C4516"] helpviewer_keywords: ["C4516"] -ms.assetid: 6677bb1f-d26e-4ab9-8644-6b5a2a8f4ff8 --- # Compiler Warning (level 4) C4516 -'class::symbol' : access-declarations are deprecated; member using-declarations provide a better alternative +> 'class::symbol' : access-declarations are deprecated; member using-declarations provide a better alternative + +## Remarks The ANSI C++ committee has declared access declarations (changing the access of a member in a derived class without the [using](../../cpp/using-declaration.md) keyword) to be outdated. Access declarations may not be supported by future versions of C++. -The following sample generates C4516: +## Example + +The following example generates C4516: ```cpp // C4516.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4517.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4517.md index bcc52f94383..b64a35c0020 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4517.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4517.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Compiler Warning (level 4) C4517" title: "Compiler Warning (level 4) C4517" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 4) C4517" +ms.date: 11/04/2016 f1_keywords: ["C4517"] helpviewer_keywords: ["C4517"] -ms.assetid: 87cc12b8-7331-4f3a-a863-d6a75d9599c3 --- # Compiler Warning (level 4) C4517 -access-declarations are deprecated; member using-declarations provide a better alternative +> access-declarations are deprecated; member using-declarations provide a better alternative + +## Remarks The ANSI C++ committee has declared access declarations (changing the access of a member in a derived class without the [using](../../cpp/using-declaration.md) keyword) to be outdated. Access declarations may not be supported by future versions of C++. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4536.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4536.md index 68bd5482f94..666741bf888 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4536.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4536.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Warning (level 4) C4536" title: "Compiler Warning (level 4) C4536" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 4) C4536" +ms.date: 11/04/2016 f1_keywords: ["C4536"] helpviewer_keywords: ["C4536"] -ms.assetid: ab4d0686-f813-4e88-a264-b40d3630ed6c --- # Compiler Warning (level 4) C4536 -'type name' : type-name exceeds meta-data limit of 'limit' characters +> 'type name' : type-name exceeds meta-data limit of 'limit' characters + +## Remarks A type name would be truncated in metadata if it was a managed type. See [C3180](../../error-messages/compiler-errors-2/compiler-error-c3180.md) for more information. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4559.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4559.md index 0a41fa8b052..342ceb0c727 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4559.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4559.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 4) C4559" title: "Compiler Warning (level 4) C4559" -ms.date: "08/27/2018" +description: "Learn more about: Compiler Warning (level 4) C4559" +ms.date: 08/27/2018 f1_keywords: ["C4559"] helpviewer_keywords: ["C4559"] -ms.assetid: ed542f60-454d-45cb-85da-987ede61b1ab --- # Compiler Warning (level 4) C4559 @@ -16,7 +15,7 @@ A function was redefined or redeclared and the second definition or declaration ## Example -The following sample generates C4559: +The following example generates C4559: ```cpp // C4559.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4564.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4564.md index 629202c137e..92a33b38705 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4564.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4564.md @@ -1,17 +1,20 @@ --- -description: "Learn more about: Compiler Warning (level 4) C4564" title: "Compiler Warning (level 4) C4564" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 4) C4564" +ms.date: 11/04/2016 f1_keywords: ["C4564"] helpviewer_keywords: ["C4564"] -ms.assetid: 555b301b-313e-4262-9f81-eb878674be60 --- # Compiler Warning (level 4) C4564 -method 'method' of class 'class' defines unsupported default parameter 'parameter' +> method 'method' of class 'class' defines unsupported default parameter 'parameter' + +## Remarks The compiler detected a method with one or more parameters with default values. The default value(s) for the parameters will be ignored when the method is invoked; explicitly specify values for those parameters. If you do not explicitly specify values for those parameters, the C++ compiler will generate an error. +## Example + Given the following .dll created with Visual Basic, which allows default parameters on method arguments: ```vb @@ -24,7 +27,7 @@ Public class TestClass End class ``` -And the following C++ sample that uses the .dll created with Visual Basic, +And the following C++ example that uses the .dll created with Visual Basic, ```cpp // C4564.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4565.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4565.md index 293f34c42c8..c1f9e7d3e2b 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4565.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4565.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 4) C4565" title: "Compiler Warning (level 4) C4565" -ms.date: "08/27/2018" +description: "Learn more about: Compiler Warning (level 4) C4565" +ms.date: 08/27/2018 f1_keywords: ["C4565"] helpviewer_keywords: ["C4565"] -ms.assetid: a71f1341-a4a1-4060-ad1e-9322531883ed --- # Compiler Warning (level 4) C4565 @@ -16,7 +15,7 @@ A symbol was redefined or redeclared and the second definition or declaration, u ## Example -The following sample generates C4565: +The following example generates C4565: ```cpp // C4565.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4571.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4571.md index 54845383a3c..a45338491c2 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4571.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4571.md @@ -4,16 +4,15 @@ description: "Documents the Microsoft C++ compiler warning C4571." ms.date: 08/24/2020 f1_keywords: ["C4571"] helpviewer_keywords: ["C4571"] -ms.assetid: 07aa17bd-b15c-4266-824c-57cc445e8edd --- # Compiler Warning (level 4) C4571 > Informational: `catch(...)` semantics changed since Visual C++ 7.1; structured exceptions (SEH) are no longer caught -C4571 is generated for every `catch(...)` block when you specify the **`/EHs`** compiler option. - ## Remarks +C4571 is generated for every `catch(...)` block when you specify the **`/EHs`** compiler option. + When you specify the **`/EHs`** compiler option, `catch(...)` blocks don't catch structured exceptions. (Divide by zero, or null pointer exceptions, for example.) A `catch(...)` block only catches explicitly thrown C++ exceptions. For more information, see [Exception Handling](../../cpp/exception-handling-in-visual-cpp.md). This warning is off by default. Turn this warning on to ensure that when you compile with **`/EHs`** your `catch (...)` blocks don't catch structured exceptions. For more information, see [Compiler warnings that are off by default](../../preprocessor/compiler-warnings-that-are-off-by-default.md). @@ -28,7 +27,7 @@ You can resolve C4571 in one of the following ways: ## Example -The following sample generates C4571. +The following example generates C4571. ```cpp // C4571.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4610.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4610.md index 4786d9b171f..7f3a940728a 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4610.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4610.md @@ -1,16 +1,21 @@ --- -description: "Learn more about: Compiler Warning (level 4) C4610" title: "Compiler Warning (level 4) C4610" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 4) C4610" +ms.date: 11/04/2016 f1_keywords: ["C4610"] helpviewer_keywords: ["C4610"] -ms.assetid: 23c1a16c-9ca9-4bf6-9911-a72b785560c2 --- # Compiler Warning (level 4) C4610 -object 'class' can never be instantiated - user-defined constructor required +> object 'class' can never be instantiated - user-defined constructor required + +## Remarks + +The class has no user-defined or default constructors. No instantiation is performed. + +## Example -The class has no user-defined or default constructors. No instantiation is performed. The following sample generates C4610: +The following example generates C4610: ```cpp // C4610.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4611.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4611.md index f584d23463c..0a08bc7d430 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4611.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4611.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Warning (level 4) C4611" title: "Compiler Warning (level 4) C4611" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 4) C4611" +ms.date: 11/04/2016 f1_keywords: ["C4611"] helpviewer_keywords: ["C4611"] -ms.assetid: bd90d0a6-75f9-4e97-968d-dda6773e9fd8 --- # Compiler Warning (level 4) C4611 -interaction between 'function' and C++ object destruction is non-portable +> interaction between 'function' and C++ object destruction is non-portable + +## Remarks On some platforms, functions that include **`catch`** may not support C++ object semantics of destruction when out of scope. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4623.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4623.md index 012e0513849..6cc61710058 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4623.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4623.md @@ -1,22 +1,23 @@ --- -description: "Learn more about: Compiler Warning (level 4) C4623" title: "Compiler Warning (level 4) C4623" +description: "Learn more about: Compiler Warning (level 4) C4623" ms.date: 10/27/2022 f1_keywords: ["C4623"] helpviewer_keywords: ["C4623"] -ms.assetid: e630d8d0-f6ea-469c-a74f-07b027587225 --- # Compiler Warning (level 4) C4623 > '`derived class`' : default constructor was implicitly defined as deleted +## Remarks + Because the default constructor is deleted or inaccessible in a base class, the compiler can't generate a default constructor for the derived class. Attempts to create an object of this type by using the default constructor (for example, in an array) cause a compiler error. This warning is off by default. For more information, see [Compiler warnings that are off by default](../../preprocessor/compiler-warnings-that-are-off-by-default.md). ## Example -The following sample generates C4623. +The following example generates C4623. ```cpp // C4623.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4625.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4625.md index 769736cbd7b..c066dbcd982 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4625.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4625.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Warning (level 4) C4625" title: "Compiler Warning (level 4) C4625" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 4) C4625" +ms.date: 11/04/2016 f1_keywords: ["C4625"] helpviewer_keywords: ["C4625"] -ms.assetid: 4cc99e50-846c-4784-97da-48b977067851 --- # Compiler Warning (level 4) C4625 -'derived class' : copy constructor was implicitly defined as deleted because a base class copy constructor is inaccessible or deleted +> 'derived class' : copy constructor was implicitly defined as deleted because a base class copy constructor is inaccessible or deleted + +## Remarks A copy constructor was deleted or not accessible in a base class and was therefore not generated for a derived class. Any attempt to copy an object of this type will cause a compiler error. @@ -16,7 +17,7 @@ This warning is off by default. See [Compiler Warnings That Are Off by Default]( ## Example -The following sample generates C4625 and shows how to fix it. +The following example generates C4625 and shows how to fix it. ```cpp // C4625.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4626.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4626.md index 289950c660d..7115d1f328a 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4626.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4626.md @@ -1,22 +1,25 @@ --- -description: "Learn more about: Compiler Warning (level 4) C4626" title: "Compiler Warning (level 4) C4626" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 4) C4626" +ms.date: 11/04/2016 f1_keywords: ["C4626"] helpviewer_keywords: ["C4626"] -ms.assetid: 7f822ff4-a4a3-4f17-b45b-e8b7b4659a14 --- # Compiler Warning (level 4) C4626 -'derived class' : assignment operator was implicitly defined as deleted because a base class assignment operator is inaccessible or deleted +> 'derived class' : assignment operator was implicitly defined as deleted because a base class assignment operator is inaccessible or deleted + +## Remarks An assignment operator was deleted or not accessible in a base class and was therefore not generated for a derived class. Any attempt to assign objects of this type will cause a compiler error. This warning is off by default. See [Compiler Warnings That Are Off by Default](../../preprocessor/compiler-warnings-that-are-off-by-default.md) for more information. -The following sample generates C4626 and shows how to fix it: +## Example -``` +The following example generates C4626 and shows how to fix it: + +```cpp // C4626 // compile with: /W4 #pragma warning(default : 4626) diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4629.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4629.md index 31618dd3700..39e76d38d59 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4629.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4629.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Warning (level 4) C4629" title: "Compiler Warning (level 4) C4629" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 4) C4629" +ms.date: 11/04/2016 f1_keywords: ["C4629"] helpviewer_keywords: ["C4629"] -ms.assetid: 158cde12-bae5-4d43-b575-b52b35aaa0b9 --- # Compiler Warning (level 4) C4629 -digraph used, character sequence 'digraph' interpreted as token 'char' (insert a space between the two characters if this is not what you intended) +> digraph used, character sequence 'digraph' interpreted as token 'char' (insert a space between the two characters if this is not what you intended) + +## Remarks Under [/Za](../../build/reference/za-ze-disable-language-extensions.md), the compiler warns when it detects a digraph. -The following sample generates C4629: +## Example + +The following example generates C4629: ```cpp // C4629.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4634.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4634.md index 9b1ac75158a..b0eb31c8844 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4634.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4634.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Warning (level 4) C4634" title: "Compiler Warning (level 4) C4634" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 4) C4634" +ms.date: 11/04/2016 f1_keywords: ["C4634"] helpviewer_keywords: ["C4634"] -ms.assetid: 3e3496ce-2ac7-43d0-a48a-f514c950e81d --- # Compiler Warning (level 4) C4634 -XML document comment: cannot be applied: reason +> XML document comment: cannot be applied: reason + +## Remarks XML documentation tags can not be applied to all C++ constructs. For example, you cannot add a documentation comment to a namespace or template. @@ -16,7 +17,7 @@ For more information, see [XML Documentation](../../build/reference/xml-document ## Examples -The following sample generates C4634. +The following example generates C4634. ```cpp // C4634.cpp @@ -27,7 +28,7 @@ namespace hello { }; ``` -The following sample generates C4634. +The following example generates C4634. ```cpp // C4634_b.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4639.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4639.md index 8d5ddea0f74..0f952a6f795 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4639.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4639.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Warning (level 4) C4639" title: "Compiler Warning (level 4) C4639" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 4) C4639" +ms.date: 11/04/2016 f1_keywords: ["C4639"] helpviewer_keywords: ["C4639"] -ms.assetid: f94f7392-cdbb-4bf4-8a00-20dc90d3efe9 --- # Compiler Warning (level 4) C4639 -MSXML error, XML document comments will not be processed. reason +> MSXML error, XML document comments will not be processed. reason + +## Remarks This warning can occur for any number of reasons. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4668.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4668.md index 691fe7a8f4b..ac3527c10fa 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4668.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4668.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Warning (level 4) C4668" title: "Compiler Warning (level 4) C4668" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 4) C4668" +ms.date: 11/04/2016 f1_keywords: ["C4668"] helpviewer_keywords: ["C4668"] -ms.assetid: c6585460-bc4a-4a15-9242-4cbfce53c961 --- # Compiler Warning (level 4) C4668 -'symbol' is not defined as a preprocessor macro, replacing with '0' for 'directives' +> 'symbol' is not defined as a preprocessor macro, replacing with '0' for 'directives' + +## Remarks A symbol that was not defined was used with a preprocessor directive. The symbol will evaluate to false. To define a symbol, you can use either the [#define directive](../../preprocessor/hash-define-directive-c-cpp.md) or [/D](../../build/reference/d-preprocessor-definitions.md) compiler option. @@ -16,7 +17,7 @@ This warning is off by default. See [Compiler Warnings That Are Off by Default]( ## Example -The following sample generates C4668: +The following example generates C4668: ```cpp // C4668.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4670.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4670.md index 16a09cd423c..0fe80da2049 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4670.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4670.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Warning (level 4) C4670" title: "Compiler Warning (level 4) C4670" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 4) C4670" +ms.date: 11/04/2016 f1_keywords: ["C4670"] helpviewer_keywords: ["C4670"] -ms.assetid: e172b134-b1fb-4dfe-8e9d-209ea08b73c7 --- # Compiler Warning (level 4) C4670 -'identifier' : this base class is inaccessible +> 'identifier' : this base class is inaccessible + +## Remarks The specified base class of an object to be thrown in a **`try`** block is not accessible. The object cannot be instantiated if it is thrown. Check that the base class is inherited with the correct access specifier. -The following sample generates C4670: +## Example + +The following example generates C4670: ```cpp // C4670.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4672.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4672.md index 71c8c6eabdb..79592299553 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4672.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4672.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Compiler Warning (level 4) C4672" title: "Compiler Warning (level 4) C4672" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 4) C4672" +ms.date: 11/04/2016 f1_keywords: ["C4672"] helpviewer_keywords: ["C4672"] -ms.assetid: 3ae1b9cd-e53e-41e7-a330-7238b7aa0679 --- # Compiler Warning (level 4) C4672 -'identifier1' : ambiguous. First seen as 'identifier2' +> 'identifier1' : ambiguous. First seen as 'identifier2' + +## Remarks The specified object to be thrown in a **`try`** block is ambiguous. The object cannot be disambiguated if it is thrown. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4673.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4673.md index 72d0d3c2645..e78645787d5 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4673.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4673.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Warning (level 4) C4673" title: "Compiler Warning (level 4) C4673" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 4) C4673" +ms.date: 11/04/2016 f1_keywords: ["C4673"] helpviewer_keywords: ["C4673"] -ms.assetid: 95626ec6-f05b-43c7-8b9a-a60a6f98dd30 --- # Compiler Warning (level 4) C4673 -throwing 'identifier' the following types will not be considered at the catch site +> throwing 'identifier' the following types will not be considered at the catch site + +## Remarks A throw object cannot be handled in the **`catch`** block. Each type that cannot be handled is listed in the error output immediately following the line containing this warning. Each unhandled type has its own warning. Read the warning for each specific type for more information. -The following sample generates C4673: +## Example + +The following example generates C4673: ```cpp // C4673.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4680.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4680.md index 84991356ab2..b1c2f47d90a 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4680.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4680.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Warning (level 4) C4680" title: "Compiler Warning (level 4) C4680" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 4) C4680" +ms.date: 11/04/2016 f1_keywords: ["C4680"] helpviewer_keywords: ["C4680"] -ms.assetid: 6e043f4c-c601-4b77-8130-920cff1d912e --- # Compiler Warning (level 4) C4680 -'class' : coclass does not specify a default interface +> 'class' : coclass does not specify a default interface + +## Remarks A [default](../../windows/attributes/default-cpp.md) interface was not specified for a class that was marked with the [coclass](../../windows/attributes/coclass.md) attribute. In order for an object to be useful, it must implement an interface. -The following sample generates C4680: +## Example + +The following example generates C4680: ```cpp // C4680.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4681.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4681.md index 111c36c8bba..361aa89790a 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4681.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4681.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Warning (level 4) C4681" title: "Compiler Warning (level 4) C4681" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 4) C4681" +ms.date: 11/04/2016 f1_keywords: ["C4681"] helpviewer_keywords: ["C4681"] -ms.assetid: a4e6d85f-3e21-4b45-a551-c23d3c554d3f --- # Compiler Warning (level 4) C4681 -'class' : coclass does not specify a default interface that is an event source +> 'class' : coclass does not specify a default interface that is an event source + +## Remarks A [source](../../windows/attributes/source-cpp.md) interface was not specified for a class. -The following sample generates C4681: +## Example + +The following example generates C4681: ```cpp // C4681.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4682.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4682.md index b0ca72b2f48..24a2e74a7f7 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4682.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4682.md @@ -1,20 +1,23 @@ --- -description: "Learn more about: Compiler Warning (level 4) C4682" title: "Compiler Warning (level 4) C4682" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 4) C4682" +ms.date: 11/04/2016 f1_keywords: ["C4682"] helpviewer_keywords: ["C4682"] -ms.assetid: 858ea157-1244-4a61-85df-97b3de43d418 --- # Compiler Warning (level 4) C4682 -'parameter' : no directional parameter attribute specified, defaulting to [in] +> 'parameter' : no directional parameter attribute specified, defaulting to [in] + +## Remarks A method on a parameter in an attributed interface does not have one of the directional attributes: [in](../../windows/attributes/in-cpp.md) or [out](../../windows/attributes/out-cpp.md). The parameter defaults to in. This warning is off by default. See [Compiler Warnings That Are Off by Default](../../preprocessor/compiler-warnings-that-are-off-by-default.md) for more information. -The following sample generates C4682: +## Example + +The following example generates C4682: ```cpp // C4682.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4690.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4690.md index 13c663986aa..2b60bad381f 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4690.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4690.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 4) C4690" title: "Compiler Warning (level 4) C4690" -ms.date: "07/03/2018" +description: "Learn more about: Compiler Warning (level 4) C4690" +ms.date: 07/03/2018 f1_keywords: ["C4690"] helpviewer_keywords: ["C4690"] -ms.assetid: 080a0ea1-458b-477b-a37a-4a34c94709ff --- # Compiler Warning (level 4) C4690 @@ -16,7 +15,7 @@ The [emitidl](../../windows/attributes/emitidl.md) attribute was popped one more ## Example -The following sample generates C4690. To fix this issue, make sure the attribute is popped exactly as many times as it is pushed. +The following example generates C4690. To fix this issue, make sure the attribute is popped exactly as many times as it is pushed. ```cpp // C4690.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4701.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4701.md index 9ebcdda802f..9200e630f18 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4701.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4701.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Warning (level 4) C4701" title: "Compiler Warning (level 4) C4701" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 4) C4701" +ms.date: 11/04/2016 f1_keywords: ["C4701"] helpviewer_keywords: ["C4701"] -ms.assetid: d7c76c66-1f3f-4d3c-abe4-5d94c84a5a1f --- # Compiler Warning (level 4) C4701 -Potentially uninitialized local variable 'name' used +> Potentially uninitialized local variable 'name' used + +## Remarks The local variable *name* might have been used without being assigned a value. This could lead to unpredictable results. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4702.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4702.md index c87a88e66cb..04cc02f7efe 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4702.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4702.md @@ -1,22 +1,23 @@ --- -description: "Learn more about: Compiler Warning (level 4) C4702" title: "Compiler Warning (level 4) C4702" +description: "Learn more about: Compiler Warning (level 4) C4702" ms.date: 09/20/2021 f1_keywords: ["C4702"] helpviewer_keywords: ["C4702"] -ms.assetid: d8198c1e-8762-42a6-9e6b-cb568b7a1686 --- # Compiler Warning (level 4) C4702 > unreachable code +## Remarks + When the compiler back end detects unreachable code, it generates C4702 as a level 4 warning. To address this warning, remove the unreachable code or assure that all source code is reachable by some flow of execution. ## Examples -The following sample generates C4702. To fix it, remove the unreachable code. +The following example generates C4702. To fix it, remove the unreachable code. ```cpp // C4702.cpp @@ -33,7 +34,7 @@ Error C4702 can occur in some versions of the compiler when you compile using th For more information, see [`/EH` (Exception Handling Model)](../../build/reference/eh-exception-handling-model.md). -The following sample generates C4702: +The following example generates C4702: ```cpp // C4702b.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4703.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4703.md index af2e4d53e94..b15a4cd6a68 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4703.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4703.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Compiler Warning (level 4) C4703" title: "Compiler Warning (level 4) C4703" +description: "Learn more about: Compiler Warning (level 4) C4703" ms.date: 08/30/2022 f1_keywords: ["C4703"] helpviewer_keywords: ["C4703"] -ms.assetid: 5dad454e-69e3-4931-9168-050a861c05f8 --- # Compiler Warning (level 4) C4703 diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4706.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4706.md index 6fa2feebb00..314f98a8a40 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4706.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4706.md @@ -1,70 +1,69 @@ --- -description: "Learn more about: Compiler Warning (level 4) C4706" title: "Compiler Warning (level 4) C4706" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 4) C4706" +ms.date: 3/5/2025 f1_keywords: ["C4706"] helpviewer_keywords: ["C4706"] -ms.assetid: 89cd3f4f-812c-4a4b-9426-65a5a6d1b99c --- # Compiler Warning (level 4) C4706 -assignment within conditional expression +> assignment used as a condition -The test value in a conditional expression was the result of an assignment. +## Remarks + +The test value in a conditional expression is the result of an assignment. An assignment has a value (the value on the left side of the assignment) that can be used legally in another expression, including a test expression. -The following sample generates C4706: +## Example + +The following example generates C4706: ```cpp -// C4706a.cpp // compile with: /W4 int main() { int a = 0, b = 0; - if ( a = b ) // C4706 + if (a = b) // C4706 { } } ``` -The warning will occur even if you double the parentheses around the test condition: +Suppress the warning with `((`*expression*`))`. For example: ```cpp -// C4706b.cpp // compile with: /W4 int main() { int a = 0, b = 0; - if ( ( a = b ) ) // C4706 + if ((a = b)) // No warning { } } ``` -If your intention is to test a relation and not to make an assignment, use the `==` operator. For example, the following line tests whether a and b are equal: +If your intention is to test a relation, not to make an assignment, use the `==` operator. For example, the following tests whether a and b are equal: ```cpp -// C4706c.cpp // compile with: /W4 int main() { int a = 0, b = 0; - if ( a == b ) + if (a == b) { } } ``` -If you intend to make your test value the result of an assignment, test to ensure that the assignment is non-zero or not null. For example, the following code will not generate this warning: +If you intend to make your test value the result of an assignment, test to ensure that the assignment is non-zero or non-null. For example, the following code doesn't generate this warning: ```cpp -// C4706d.cpp // compile with: /W4 int main() { int a = 0, b = 0; - if ( ( a = b ) != 0 ) + if ((a = b) != 0) { } } diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4709.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4709.md index ce1711cf545..4061b8eaabb 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4709.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4709.md @@ -1,20 +1,21 @@ --- -description: "Learn more about: Compiler Warning (level 4) C4709" title: "Compiler Warning (level 4) C4709" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 4) C4709" +ms.date: 11/04/2016 f1_keywords: ["C4709"] helpviewer_keywords: ["C4709"] -ms.assetid: 8abfdd45-8c70-4c27-b0fb-ca0c3f0fccf9 --- # Compiler Warning (level 4) C4709 -comma operator within array index expression +> comma operator within array index expression + +## Remarks When a comma occurs in an array index expression, the compiler uses the value after the last comma. ## Example -The following sample generates C4709: +The following example generates C4709: ```cpp // C4709.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4710.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4710.md index d2cc5e90759..7e6ab51b762 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4710.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4710.md @@ -1,15 +1,16 @@ --- -description: "Learn more about: Compiler Warning (level 4) C4710" title: "Compiler Warning (level 4) C4710" +description: "Learn more about: Compiler Warning (level 4) C4710" ms.date: 10/19/2021 f1_keywords: ["C4710"] helpviewer_keywords: ["C4710"] -ms.assetid: 76381ec7-3fc1-4bee-9a0a-c2c8307b92e2 --- # Compiler Warning (level 4) C4710 > '*function*' : function not inlined +## Remarks + The specified function was marked for inline expansion, but the compiler didn't inline the function. Inlining is done at the compiler's discretion. The **`inline`** keyword, like the deprecated (and, in C++17 and later standards, removed) **`register`** keyword, is used as a hint for the compiler. The compiler uses heuristics to determine if it should inline a particular function to speed up the code when it optimizes for speed, or if it should inline a particular function to make the code smaller when it optimizes for space. The compiler inlines only the smallest functions when compiling for space. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4714.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4714.md index 4742aa9d22e..1e8cb117833 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4714.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4714.md @@ -1,15 +1,16 @@ --- -description: "Learn more about: Compiler Warning (level 4) C4714" title: "Compiler Warning (level 4) C4714" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 4) C4714" +ms.date: 11/04/2016 f1_keywords: ["C4714"] helpviewer_keywords: ["C4714"] -ms.assetid: 22c7fd0c-899d-4e9b-95f3-725b2c49fb46 --- # Compiler Warning (level 4) C4714 > function 'function' marked as __forceinline not inlined +## Remarks + The given function was selected for inline expansion, but the compiler did not perform the inlining. Although **`__forceinline`** is a stronger indication to the compiler than **`__inline`**, inlining is still performed at the compiler's discretion, but no heuristics are used to determine the benefits from inlining this function. @@ -28,7 +29,9 @@ In some cases, the compiler will not inline a particular function for mechanical - A function with a **`try`** (C++ exception handling) statement. -The following sample generates C4714: +## Example + +The following example generates C4714: ```cpp // C4714.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4718.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4718.md index f5f3e29ecc3..0d1e87cd79d 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4718.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4718.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Compiler Warning (level 4) C4718" title: "Compiler Warning (level 4) C4718" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 4) C4718" +ms.date: 11/04/2016 f1_keywords: ["C4718"] helpviewer_keywords: ["C4718"] -ms.assetid: 29507f8a-b024-42c1-a3b8-f35d1f2641f3 --- # Compiler Warning (level 4) C4718 -'function call' : recursive call has no side effects, deleting +> 'function call' : recursive call has no side effects, deleting + +## Remarks A function contains a recursive call, but otherwise has no side effects. A call to this function is being deleted. The correctness of the program is not affected, but the behavior is. Whereas leaving the call in could result in a runtime stack overflow exception, deleting the call removes that possibility. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4725.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4725.md index 33d4ee8068d..e758e619545 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4725.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4725.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Warning (level 4) C4725" title: "Compiler Warning (level 4) C4725" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 4) C4725" +ms.date: 11/04/2016 f1_keywords: ["C4725"] helpviewer_keywords: ["C4725"] -ms.assetid: effa0335-71c3-4b3b-8618-da4b9b46a95d --- # Compiler Warning (level 4) C4725 -instruction may be inaccurate on some Pentiums +> instruction may be inaccurate on some Pentiums + +## Remarks Your code contains an inline assembly instruction that may not produce accurate results on some Pentium microprocessors. -The following sample generates C4725: +## Example + +The following example generates C4725: ```cpp // C4725.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4740.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4740.md index dbd34c62da4..9caf86e10b1 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4740.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4740.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Warning (Level 4) C4740" title: "Compiler Warning (Level 4) C4740" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (Level 4) C4740" +ms.date: 11/04/2016 f1_keywords: ["C4740"] helpviewer_keywords: ["C4740"] -ms.assetid: 85528969-966a-44b4-8a2f-971704c64477 --- # Compiler Warning (Level 4) C4740 -flow in or out of inline asm code suppresses global optimization +> flow in or out of inline asm code suppresses global optimization + +## Remarks When there is a jump in to or out of an **`asm`** block, global optimizations are disabled for that function. -The following sample generates C4740: +## Example + +The following example generates C4740: ```cpp // C4740.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4754.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4754.md index b5fcf28fe24..25e27f20145 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4754.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4754.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Warning (level 4) C4754" title: "Compiler Warning (level 4) C4754" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 4) C4754" +ms.date: 11/04/2016 f1_keywords: ["C4754"] helpviewer_keywords: ["C4754"] -ms.assetid: e0e4606a-754a-4f42-a274-21a34978d21d --- # Compiler Warning (level 4) C4754 -Conversion rules for arithmetic operations in a comparison mean that one branch cannot be executed. +> Conversion rules for arithmetic operations in a comparison mean that one branch cannot be executed. + +## Remarks The C4754 warning is issued because the result of the comparison is always the same. This indicates that one of the branches of the condition is never executed, most likely because the associated integer expression is incorrect. This code defect often occurs in incorrect integer overflow checks on 64-bit architectures. @@ -16,7 +17,7 @@ Integer conversion rules are complex and there are many subtle pitfalls. As an a ## Examples -This sample generates C4754: +This example generates C4754: ```cpp // C4754a.cpp @@ -52,7 +53,7 @@ unsigned long long x = (unsigned long long)a + (unsigned long long)b; ``` -The next sample also generates C4754. +The next example also generates C4754. ```cpp // C4754b.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4764.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4764.md index d1767d47506..7886044e2ab 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4764.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4764.md @@ -1,20 +1,21 @@ --- -description: "Learn more about: Compiler Warning (level 4) C4764" title: "Compiler Warning (level 4) C4764" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 4) C4764" +ms.date: 11/04/2016 f1_keywords: ["C4764"] helpviewer_keywords: ["C4764"] -ms.assetid: 7bd4296f-966b-484c-bf73-8dbc8e85b4a9 --- # Compiler Warning (level 4) C4764 -Cannot align catch objects to greater than 16 bytes +> Cannot align catch objects to greater than 16 bytes + +## Remarks An alignment greater than 16 was specified, but on some platforms, if the function throws an exception, the stack will force an alignment of not greater than 16. ## Example -The following sample generates C4764: +The following example generates C4764: ```cpp // C4764.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4816.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4816.md index 2adb8e107e5..f7046a8be89 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4816.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4816.md @@ -1,20 +1,21 @@ --- -description: "Learn more about: Compiler Warning (level 4) C4816" title: "Compiler Warning (level 4) C4816" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 4) C4816" +ms.date: 11/04/2016 f1_keywords: ["C4816"] helpviewer_keywords: ["C4816"] -ms.assetid: 60f730ae-d942-4db9-ab97-41d4a874d8da --- # Compiler Warning (level 4) C4816 -'param' : parameter has a zero-sized array which will be truncated (unless the object is passed by reference) +> 'param' : parameter has a zero-sized array which will be truncated (unless the object is passed by reference) + +## Remarks A parameter to an object with a zero-size array was not passed by reference. The array will not get copied when the object is passed. ## Example -The following sample generates C4816: +The following example generates C4816: ```cpp // C4816.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4820.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4820.md index 4a2288a609d..18f9f82fb36 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4820.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4820.md @@ -1,20 +1,23 @@ --- -description: "Learn more about: Compiler Warning (level 4) C4820" title: "Compiler Warning (level 4) C4820" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 4) C4820" +ms.date: 11/04/2016 f1_keywords: ["C4820"] helpviewer_keywords: ["C4820"] -ms.assetid: 17aa29f4-c287-49b8-bc43-8ed82ffed5ea --- # Compiler Warning (level 4) C4820 -'bytes' bytes padding added after construct 'member_name' +> 'bytes' bytes padding added after construct 'member_name' + +## Remarks The type and order of elements caused the compiler to add padding to the end of a struct. See [align](../../cpp/align-cpp.md) for more information on padding in a struct. This warning is off by default. See [Compiler Warnings That Are Off by Default](../../preprocessor/compiler-warnings-that-are-off-by-default.md) for more information. -The following sample generates C4820: +## Example + +The following example generates C4820: ```cpp // C4820.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4840.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4840.md index 417cd684ad3..0c10fc635b5 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4840.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4840.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: Compiler Warning (level 4) C4840" title: "Compiler Warning (level 4) C4840" -ms.date: "09/13/2018" +description: "Learn more about: Compiler Warning (level 4) C4840" +ms.date: 09/13/2018 f1_keywords: ["C4840"] helpviewer_keywords: ["C4840"] --- @@ -17,7 +17,7 @@ This warning is available beginning in Visual Studio 2017. ## Example -The following sample generates C4840 and shows how to fix it: +The following example generates C4840 and shows how to fix it: ```cpp // C4840.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4913.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4913.md index 4c7e6651a22..15d4c3e2211 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4913.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4913.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Warning (level 4) C4913" title: "Compiler Warning (level 4) C4913" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 4) C4913" +ms.date: 11/04/2016 f1_keywords: ["C4913"] helpviewer_keywords: ["C4913"] -ms.assetid: b94aa52e-6029-4170-9134-017714931546 --- # Compiler Warning (level 4) C4913 -**user defined binary operator ',' exists but no overload could convert all operands, default built-in binary operator ',' used** +> user defined binary operator ',' exists but no overload could convert all operands, default built-in binary operator ',' used + +## Remarks A call to the built-in comma operator occurred in a program that also had an overloaded comma operator; a conversion that you thought may have occurred did not. -The following code sample generates C4913: +## Example + +The following code example generates C4913: ```cpp // C4913.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4918.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4918.md index 1954636c04d..2b0b70e3636 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4918.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4918.md @@ -1,17 +1,20 @@ --- -description: "Learn more about: Compiler Warning (level 4) C4918" title: "Compiler Warning (level 4) C4918" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 4) C4918" +ms.date: 11/04/2016 f1_keywords: ["C4918"] helpviewer_keywords: ["C4918"] -ms.assetid: 1bcf6d35-3467-4aa8-b2ef-cb33f4e70238 --- # Compiler Warning (level 4) C4918 -'character' : invalid character in pragma optimization list +> 'character' : invalid character in pragma optimization list + +## Remarks An unknown character was found in the optimization list of an [optimize](../../preprocessor/optimize.md) pragma statement. +## Example + For example, the following statement generates C4918: ```cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4931.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4931.md index a6312926814..26f191977ec 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4931.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4931.md @@ -1,15 +1,16 @@ --- -description: "Learn more about: Compiler Warning (level 4) C4931" title: "Compiler Warning (level 4) C4931" -ms.date: "08/27/2018" +description: "Learn more about: Compiler Warning (level 4) C4931" +ms.date: 08/27/2018 f1_keywords: ["C4931"] helpviewer_keywords: ["C4931"] -ms.assetid: cfbf08c7-94e4-4a91-a691-479d1dbe527a --- # Compiler Warning (level 4) C4931 > we are assuming the type library was built for *number*-bit pointers +## Remarks + Explicit information was not supplied with the **ptrsize** attribute of the [#import](../../preprocessor/hash-import-directive-cpp.md) directive; the compiler concluded that pointer size of the type library is *number*. This warning is off by default. See [Compiler Warnings That Are Off by Default](../../preprocessor/compiler-warnings-that-are-off-by-default.md) for more information. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4932.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4932.md index 873855d305f..db065cb5d56 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4932.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4932.md @@ -4,15 +4,18 @@ description: "Describes Microsoft C/C++ compiler warning C4932." ms.date: 08/25/2020 f1_keywords: ["C4932"] helpviewer_keywords: ["C4932"] -ms.assetid: 0b8d88cc-21f6-45cb-a9f5-1795b7db0dfa --- # Compiler Warning (level 4) C4932 > `__identifier(identifier_1)` and `__identifier(identifier_2)` are indistinguishable +## Remarks + The compiler is unable to distinguish between **`_finally`** and **`__finally`** or **`__try`** and **`_try`** as a parameter passed to [`__identifier`](../../extensions/identifier-cpp-cli.md). You should not attempt to use them both as identifiers in the same program, as it will result in a [C2374](../../error-messages/compiler-errors-1/compiler-error-c2374.md) error. -The following sample generates C4932: +## Example + +The following example generates C4932: ```cpp // C4932.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4937.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4937.md index f6f28b3469d..5789faac8d6 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4937.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4937.md @@ -1,20 +1,23 @@ --- -description: "Learn more about: Compiler Warning (level 4) C4937" title: "Compiler Warning (level 4) C4937" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 4) C4937" +ms.date: 11/04/2016 f1_keywords: ["C4937"] helpviewer_keywords: ["C4937"] -ms.assetid: 2bb9f0e7-bbd6-4697-84de-95955e32ae29 --- # Compiler Warning (level 4) C4937 -'text1' and 'text2' are indistinguishable as arguments to 'directive' +> 'text1' and 'text2' are indistinguishable as arguments to 'directive' + +## Remarks Because of the way the compiler processes arguments to directives, names that have meaning to the compiler, such as keywords with multiple text representations (single and double underscore forms), cannot be distinguished. Examples of such strings are __cdecl and \__forceinline. Note, under /Za, only the double underscore forms are enabled. -The following sample generates C4937: +## Example + +The following example generates C4937: ```cpp // C4937.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4938.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4938.md index 86361dc2f44..d2fe0f2e961 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4938.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4938.md @@ -1,18 +1,21 @@ --- -description: "Learn more about: Compiler Warning (level 4) C4938" title: "Compiler Warning (level 4) C4938" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 4) C4938" +ms.date: 11/04/2016 f1_keywords: ["C4938"] helpviewer_keywords: ["C4938"] -ms.assetid: 6acac81a-9d23-465e-b700-ed4b6e8edcd0 --- # Compiler Warning (level 4) C4938 -'var' : Floating point reduction variable may cause inconsistent results under /fp:strict or #pragma fenv_access +> 'var' : Floating point reduction variable may cause inconsistent results under /fp:strict or #pragma fenv_access + +## Remarks You should not use [/fp:strict](../../build/reference/fp-specify-floating-point-behavior.md) or [fenv_access](../../preprocessor/fenv-access.md) with OpenMP floating-point reductions, because the sum is computed in a different order. Thus, results can differ from the results without /openmp. -The following sample generates C4938: +## Example + +The following example generates C4938: ```cpp // C4938.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4960.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4960.md index b2cef66503f..fb44b5e555c 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4960.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4960.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Warning (level 4) C4960" title: "Compiler Warning (level 4) C4960" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 4) C4960" +ms.date: 11/04/2016 f1_keywords: ["C4960"] helpviewer_keywords: ["C4960"] -ms.assetid: 3b4ed286-9e8d-46f1-af0c-00ba669693a9 --- # Compiler Warning (level 4) C4960 -'function' is too big to be profiled +> 'function' is too big to be profiled + +## Remarks When using [/LTCG:PGOPTIMIZE](../../build/reference/ltcg-link-time-code-generation.md), the compiler detected an input module with a function larger than 65,535 instructions. Such a large function is not available for profile-guided optimizations. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4985.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4985.md index c073d5dd2cd..4be7325fba3 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4985.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c4985.md @@ -1,15 +1,16 @@ --- -description: "Learn more about: Compiler Warning (level 4) C4985" title: "Compiler Warning (level 4) C4985" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 4) C4985" +ms.date: 11/04/2016 f1_keywords: ["C4985"] helpviewer_keywords: ["C4985"] -ms.assetid: 832f001c-afe7-403d-a8b4-02334724c79e --- # Compiler Warning (level 4) C4985 > '*symbol-name*': attributes not present on previous declaration. +## Remarks + The Microsoft source code annotation language (SAL) annotations on the current method declaration or definition differ from the annotations on an earlier declaration. The same SAL annotations must be used in the definition and declarations of a method. The SAL provides a set of annotations that you can use to describe how a function uses its parameters, the assumptions it makes about them, and the guarantees it makes on finishing. The annotations are defined in the sal.h header file. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c5266.md b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c5266.md index f4e794516d5..840a8a254bb 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-level-4-c5266.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-level-4-c5266.md @@ -1,6 +1,6 @@ --- -description: "Learn more about: Compiler Warning (level 4) C5266" title: "Compiler Warning (level 4) C5266" +description: "Learn more about: Compiler Warning (level 4) C5266" ms.date: 01/18/2024 f1_keywords: ["C5266"] helpviewer_keywords: ["C5266"] @@ -9,6 +9,8 @@ helpviewer_keywords: ["C5266"] > 'const' qualifier on return type has no effect +## Remarks + The C++ Standard specifies that a top-level const (or volatile) qualification on a function return type is ignored. This warning is off by default.\ @@ -16,7 +18,7 @@ This warning was introduced in Visual Studio 17.6 ## Example -The following sample generates C5266: +The following example generates C5266: ```cpp // compile with: /W4 /c diff --git a/docs/error-messages/compiler-warnings/compiler-warning-levels-1-and-4-c4112.md b/docs/error-messages/compiler-warnings/compiler-warning-levels-1-and-4-c4112.md index 6dc4a888bef..96a81a8c9a0 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-levels-1-and-4-c4112.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-levels-1-and-4-c4112.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: Compiler Warning (level 1 and level 4) C4112" title: "Compiler Warning (level 1 and level 4) C4112" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1 and level 4) C4112" +ms.date: 11/04/2016 f1_keywords: ["C4112"] helpviewer_keywords: ["C4112"] --- @@ -9,11 +9,15 @@ helpviewer_keywords: ["C4112"] > `#line` requires an integer between 1 and '*line_count*' +## Remarks + The [#line](../../preprocessor/hash-line-directive-c-cpp.md) directive specifies an integer parameter that is outside the allowable range. If the specified parameter is less than 1, the line counter is reset to 1. If the specified parameter is greater than *number*, which is the compiler-defined limit, the line counter is unchanged. This diagnostic is a level 1 warning under ANSI C compatibility ([/Za](../../build/reference/za-ze-disable-language-extensions.md)) and a level 4 warning with Microsoft extensions ([/Ze](../../build/reference/za-ze-disable-language-extensions.md)). -The following sample generates C4112: +## Example + +The following example generates C4112: ```cpp // C4112.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-levels-1-and-4-c4115.md b/docs/error-messages/compiler-warnings/compiler-warning-levels-1-and-4-c4115.md index d881c7f2c15..34868cd3197 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-levels-1-and-4-c4115.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-levels-1-and-4-c4115.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Warning (levels 1 and 4) C4115" title: "Compiler Warning (levels 1 and 4) C4115" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (levels 1 and 4) C4115" +ms.date: 11/04/2016 f1_keywords: ["C4115"] helpviewer_keywords: ["C4115"] -ms.assetid: f3f94e72-fc49-4d09-b3e7-23d68e61152f --- # Compiler Warning (levels 1 and 4) C4115 -'type' : named type definition in parentheses +> 'type' : named type definition in parentheses + +## Remarks The given symbol is used to define a structure, union, or enumerated type inside a parenthetical expression. The scope of the definition may be unexpected. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-levels-1-and-4-c4223.md b/docs/error-messages/compiler-warnings/compiler-warning-levels-1-and-4-c4223.md index bc05a609f2f..e9f2a839c88 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-levels-1-and-4-c4223.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-levels-1-and-4-c4223.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Compiler Warning (level 1 and level 4) C4223" title: "Compiler Warning (level 1 and level 4) C4223" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 1 and level 4) C4223" +ms.date: 11/04/2016 f1_keywords: ["C4223"] helpviewer_keywords: ["C4223"] -ms.assetid: 6fc44336-0250-4432-928b-fc5dbe7b7c1c --- # Compiler Warning (level 1 and level 4) C4223 > nonstandard extension used: non-lvalue array converted to pointer +## Remarks + In standard C, you can't convert a nonlvalue array to a pointer. With the default Microsoft extensions ([`/Ze`](../../build/reference/za-ze-disable-language-extensions.md)), you can. diff --git a/docs/error-messages/compiler-warnings/compiler-warning-levels-2-and-3-c4008.md b/docs/error-messages/compiler-warnings/compiler-warning-levels-2-and-3-c4008.md index fb62ce06ead..0b0adbc8898 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-levels-2-and-3-c4008.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-levels-2-and-3-c4008.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Compiler Warning (levels 2 and 3) C4008" title: "Compiler Warning (levels 2 and 3) C4008" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (levels 2 and 3) C4008" +ms.date: 11/04/2016 f1_keywords: ["C4008"] helpviewer_keywords: ["C4008"] -ms.assetid: fb45e535-cb68-4743-80e9-a6e34cfffeca --- # Compiler Warning (levels 2 and 3) C4008 -'identifier' : 'attribute' attribute ignored +> 'identifier' : 'attribute' attribute ignored + +## Remarks The compiler ignored the **`__fastcall`**, **`static`**, or **`inline`** attribute for a function (level 3 warning) or data (level 2 warning). diff --git a/docs/error-messages/compiler-warnings/compiler-warning-levels-2-and-4-c4200.md b/docs/error-messages/compiler-warnings/compiler-warning-levels-2-and-4-c4200.md index 309f2b0317e..b02bcecf7c6 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-levels-2-and-4-c4200.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-levels-2-and-4-c4200.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: Compiler Warning (level 2 and level 4) C4200" title: "Compiler Warning (level 2 and level 4) C4200" -ms.date: "11/04/2016" +description: "Learn more about: Compiler Warning (level 2 and level 4) C4200" +ms.date: 11/04/2016 f1_keywords: ["C4200"] helpviewer_keywords: ["C4200"] --- @@ -11,8 +11,14 @@ helpviewer_keywords: ["C4200"] C++ only: > This member will be ignored by a defaulted constructor or copy/move assignment operator - -This warning indicates that a structure or union contains an array that has zero size. Declaration of a zero-sized array is a nonstandard compiler extension. This causes a Level-2 warning when a C++ file is compiled and a Level-4 warning when a C file is compiled. This example generates warning C4200: + +## Remarks + +This warning indicates that a structure or union contains an array that has zero size. Declaration of a zero-sized array is a nonstandard compiler extension. This causes a Level-2 warning when a C++ file is compiled and a Level-4 warning when a C file is compiled. + +## Example + +This example generates warning C4200: ```cpp // C4200.cpp @@ -25,8 +31,6 @@ struct A { This nonstandard extension is often used to interface code with external data structures that have a variable length. If this scenario applies to your code, you can disable the warning: -## Example - ```cpp // C4200b.cpp // compile by using: cl /W4 c4200a.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warning-levels-3-and-4-c4244.md b/docs/error-messages/compiler-warnings/compiler-warning-levels-3-and-4-c4244.md index 75b41ea7dd5..68800ee8c01 100644 --- a/docs/error-messages/compiler-warnings/compiler-warning-levels-3-and-4-c4244.md +++ b/docs/error-messages/compiler-warnings/compiler-warning-levels-3-and-4-c4244.md @@ -1,11 +1,13 @@ --- -description: "Learn more about: Compiler Warning (levels 3 and 4) C4244" title: "Compiler Warning (levels 3 and 4) C4244" -ms.date: "11/6/2023" +description: "Learn more about: Compiler Warning (levels 3 and 4) C4244" +ms.date: 11/6/2023 --- # Compiler Warning (levels 3 and 4) C4244 -'conversion' conversion from 'type1' to 'type2', possible loss of data +> 'conversion' conversion from 'type1' to 'type2', possible loss of data + +## Remarks An integer type is converted to a smaller integer type. - This is a level-4 warning if *type1* is a signed or unsigned **`int`** and *type2* is a smaller, such as a signed or unsigned **`short`**. @@ -15,7 +17,9 @@ To fix this warning, either change your program to use compatible types, or add C4244 can also appear when the warning level is 2. For more information, see [Compiler Warning (level 2) C4244](../../error-messages/compiler-warnings/compiler-warning-level-2-c4244.md). -The following sample generates C4244: +## Examples + +The following example generates C4244: ```cpp // C4244_level4.cpp @@ -52,7 +56,7 @@ int main() { Warning C4244 can occur when building code for 64-bit targets that doesn't generate the warning when building for 32-bit targets. For example, pointer arithmetic results in a 32-bit quantity on 32-bit platforms, but a 64-bit quantity on 64-bit platforms. -The following sample generates C4244 when compiled for 64-bit targets: +The following example generates C4244 when compiled for 64-bit targets: ```cpp // C4244_level3_b.cpp diff --git a/docs/error-messages/compiler-warnings/compiler-warnings-by-compiler-version.md b/docs/error-messages/compiler-warnings/compiler-warnings-by-compiler-version.md index 87f1ff8efc4..f68e772b833 100644 --- a/docs/error-messages/compiler-warnings/compiler-warnings-by-compiler-version.md +++ b/docs/error-messages/compiler-warnings/compiler-warnings-by-compiler-version.md @@ -12,48 +12,50 @@ These versions of the compiler introduced new warnings: | Product | Compiler version number | |--|--| -| Visual Studio 2002 | 13.00.9466 | -| Visual Studio 2003 | 13.10.3077 | -| Visual Studio 2005 | 14.00.50727.762 | -| Visual Studio 2008 | 15.00.21022.08 | -| Visual Studio 2010 | 16.00.40219.01 | -| Visual Studio 2012 | 17.00.51106.1 | -| Visual Studio 2013 | 18.00.21005.1 | -| Visual Studio 2015 RTM | 19.00.23026.0 | -| Visual Studio 2015 Update 1 | 19.00.23506.0 | -| Visual Studio 2015 Update 2 | 19.00.23918.0 | -| Visual Studio 2015 Update 3 | 19.00.24215.1 | -| Visual Studio 2017 RTM | 19.10.25017.0 | -| Visual Studio 2017 version 15.3 | 19.11.25506.0 | -| Visual Studio 2017 version 15.5 | 19.12.25830.0 | -| Visual Studio 2017 version 15.6 | 19.13.26128.0 | -| Visual Studio 2017 version 15.7 | 19.14.26428.0 | -| Visual Studio 2017 version 15.8 | 19.15.26726.0 | -| Visual Studio 2017 version 15.9 | 19.16.26926.0 | -| Visual Studio 2019 RTM | 19.20.27004.0 | -| Visual Studio 2019 version 16.1 | 19.21.27702.0 | -| Visual Studio 2019 version 16.2 | 19.22.27905.0 | -| Visual Studio 2019 version 16.3 | 19.23.28105.0 | -| Visual Studio 2019 version 16.4 | 19.24.28314.0 | -| Visual Studio 2019 version 16.5 | 19.25.28610.0 | -| Visual Studio 2019 version 16.6 | 19.26.28805.0 | -| Visual Studio 2019 version 16.7 | 19.27.29112.0 | -| Visual Studio 2019 version 16.8 | 19.28.29333.0 | -| Visual Studio 2019 version 16.9 | 19.28.29700.0 | -| Visual Studio 2019 version 16.10 | 19.29.30000.0 | -| Visual Studio 2019 version 16.11 | 19.29.30100.0 | -| Visual Studio 2022 version 17.0 RTW | 19.30 | -| Visual Studio 2022 version 17.1 | 19.31 | -| Visual Studio 2022 version 17.2 | 19.32 | -| Visual Studio 2022 version 17.3 | 19.33 | -| Visual Studio 2022 version 17.4 | 19.34 | -| Visual Studio 2022 version 17.5 | 19.35 | -| Visual Studio 2022 version 17.6 | 19.36 | -| Visual Studio 2022 version 17.7 | 19.37 | -| Visual Studio 2022 version 17.8 | 19.38 | -| Visual Studio 2022 version 17.9 | 19.39 | +| Visual Studio 2022 version 17.13 | 19.43 | +| Visual Studio 2022 version 17.12 | 19.42 | +| Visual Studio 2022 version 17.11 | 19.41 | | Visual Studio 2022 version 17.10 | 19.40 | - +| Visual Studio 2022 version 17.9 | 19.39 | +| Visual Studio 2022 version 17.8 | 19.38 | +| Visual Studio 2022 version 17.7 | 19.37 | +| Visual Studio 2022 version 17.6 | 19.36 | +| Visual Studio 2022 version 17.5 | 19.35 | +| Visual Studio 2022 version 17.4 | 19.34 | +| Visual Studio 2022 version 17.3 | 19.33 | +| Visual Studio 2022 version 17.2 | 19.32 | +| Visual Studio 2022 version 17.1 | 19.31 | +| Visual Studio 2022 version 17.0 RTW | 19.30 | +| Visual Studio 2019 version 16.11 | 19.29.30100.0 | +| Visual Studio 2019 version 16.10 | 19.29.30000.0 | +| Visual Studio 2019 version 16.9 | 19.28.29700.0 | +| Visual Studio 2019 version 16.8 | 19.28.29333.0 | +| Visual Studio 2019 version 16.7 | 19.27.29112.0 | +| Visual Studio 2019 version 16.6 | 19.26.28805.0 | +| Visual Studio 2019 version 16.5 | 19.25.28610.0 | +| Visual Studio 2019 version 16.4 | 19.24.28314.0 | +| Visual Studio 2019 version 16.3 | 19.23.28105.0 | +| Visual Studio 2019 version 16.2 | 19.22.27905.0 | +| Visual Studio 2019 version 16.1 | 19.21.27702.0 | +| Visual Studio 2019 RTM | 19.20.27004.0 | +| Visual Studio 2017 version 15.9 | 19.16.26926.0 | +| Visual Studio 2017 version 15.8 | 19.15.26726.0 | +| Visual Studio 2017 version 15.7 | 19.14.26428.0 | +| Visual Studio 2017 version 15.6 | 19.13.26128.0 | +| Visual Studio 2017 version 15.5 | 19.12.25830.0 | +| Visual Studio 2017 version 15.3 | 19.11.25506.0 | +| Visual Studio 2017 RTM | 19.10.25017.0 | +| Visual Studio 2015 Update 3 | 19.00.24215.1 | +| Visual Studio 2015 Update 2 | 19.00.23918.0 | +| Visual Studio 2015 Update 1 | 19.00.23506.0 | +| Visual Studio 2015 RTM | 19.00.23026.0 | +| Visual Studio 2013 | 18.00.21005.1 | +| Visual Studio 2012 | 17.00.51106.1 | +| Visual Studio 2010 | 16.00.40219.01 | +| Visual Studio 2008 | 15.00.21022.08 | +| Visual Studio 2005 | 14.00.50727.762 | +| Visual Studio 2003 | 13.10.3077 | +| Visual Studio 2002 | 13.00.9466 | You can specify only the major number, the major and minor numbers, or the major, minor, and build numbers to the **`/Wv`** option. The compiler reports all warnings that match versions that begin with the specified number. It suppresses all warnings for versions greater than the specified number. For example, **`/Wv:17`** reports warnings introduced in or before any version of Visual Studio 2012, and suppresses warnings introduced by any compiler from Visual Studio 2013 (version 18) or later. To suppress warnings introduced in Visual Studio 2015 update 2 and later, you can use **`/Wv:19.00.23506`**. Use **`/Wv:19.11`** to report the warnings introduced in any version of Visual Studio before Visual Studio 2017 version 15.5, but suppress warnings introduced in Visual Studio 2017 version 15.5 and later. @@ -61,9 +63,35 @@ The following sections list the warnings introduced by each version of Visual C+ ::: moniker range=">= msvc-170" +## Warnings introduced in Visual Studio 2022 version 17.13 (compiler version 19.43) + +These warnings, and all warnings in later versions, are suppressed by using the compiler option **`/Wv:19.42`**. + +| Warning | Message | +|--|--| +|C5277| type trait optimization for '*class name*' is disabled +|C5308| Modifying reserved macro name '*macro name*' may cause undefined behavior +|C5309| literal suffix '*name*' requires at least '*language version*' + +## Warnings introduced in Visual Studio 2022 version 17.12 (compiler version 19.42) + +These warnings, and all warnings in later versions, are suppressed by using the compiler option **`/Wv:19.41`**. + +| Warning | Message | +|--|--| +|C5086| Arch setting *arch* and vector length *number* are not allowed. Using the default vector length - *number*. +|C5276| `/experimental:ifcDebugRecords` currently requires `/Z7` to be enabled. Please recompile with `/Z7` enabled. +|C5306| parameter array behavior change: overload '*identifier 1*' resolved to '*identifier 2*'; previously, it would have resolved to '*identifier 3*'. Use `/clr:ECMAParamArray` to revert to old behavior +|C5307| '*function*': argument (*argument number*) converted from '*type 1*' to '*type 2*'. Missing '`L`' encoding-prefix for character literal? + + +## Warnings introduced in Visual Studio 2022 version 17.11 (compiler version 19.41) + +There were no new warnings introduced in 17.11 + ## Warnings introduced in Visual Studio 2022 version 17.10 (compiler version 19.40) -These warnings, and all warnings in later versions, are suppressed by using the compiler option **`/Wv:19.40`**. +These warnings, and all warnings in later versions, are suppressed by using the compiler option **`/Wv:19.39`**. | Warning | Message | |--|--| @@ -78,7 +106,7 @@ These warnings, and all warnings in later versions, are suppressed by using the ## Warnings introduced in Visual Studio 2022 version 17.9 (compiler version 19.39) -These warnings, and all warnings in later versions, are suppressed by using the compiler option **`/Wv:19.39`**. +These warnings, and all warnings in later versions, are suppressed by using the compiler option **`/Wv:19.38`**. | Warning | Message | |--|--| @@ -87,7 +115,7 @@ These warnings, and all warnings in later versions, are suppressed by using the ## Warnings introduced in Visual Studio 2022 version 17.8 (compiler version 19.38) -These warnings, and all warnings in later versions, are suppressed by using the compiler option **`/Wv:19.38`**. +These warnings, and all warnings in later versions, are suppressed by using the compiler option **`/Wv:19.37`**. | Warning | Message | |--|--| @@ -925,7 +953,7 @@ These warnings, and all warnings in later versions, are suppressed by using the | [C4792](compiler-warning-level-3-c4792.md) | `function 'function' declared using sysimport and referenced from native code; import library required to link` | | [C4794](compiler-warning-level-1-c4794.md) | `segment of thread local storage variable 'name' changed from 'segment' to 'segment'` | | C4798 | `native code generated for p-code function 'name' with exception handler or unwind semantics` | -| [C4799](compiler-warning-level-1-c4799.md) | `function 'name' has no EMMS instruction` | +| [C4799](compiler-warning-level-1-c4799.md) | `function 'function' has no EMMS instruction` | | [C4803](compiler-warning-level-1-c4803.md) | `'declaration': the raise method has a different storage class from that of the event, 'declaration'` | | [C4810](compiler-warning-level-1-c4810.md) | `value of pragma pack(show) == number` | | [C4811](compiler-warning-level-1-c4811.md) | `value of pragma conform(forScope, show) == value` | diff --git a/docs/error-messages/compiler-warnings/compiler-warnings-c4000-through-c4199.md b/docs/error-messages/compiler-warnings/compiler-warnings-c4000-through-c4199.md index 6f687f9a8c1..83f1da2def0 100644 --- a/docs/error-messages/compiler-warnings/compiler-warnings-c4000-through-c4199.md +++ b/docs/error-messages/compiler-warnings/compiler-warnings-c4000-through-c4199.md @@ -1,8 +1,9 @@ --- -description: "Table of Microsoft C/C++ compiler (MSVC) warning messages C4000 through C4199" title: "Microsoft C/C++ compiler (MSVC) warnings C4000 through C4199" +description: "Table of Microsoft C/C++ compiler (MSVC) warning messages C4000 through C4199" ms.date: "04/21/2019" -f1_keywords: ["C4000", "C4035", "C4060", "C4063", "C4064", "C4065", "C4069", "C4123", "C4137", "C4181", "C4188", "C4193", "C4194", "C4195", "C4196", "C4199"] +f1_keywords: ["C4023", "C4035", "C4051", "C4060", "C4063", "C4064", "C4065", "C4069", "C4123", "C4137", "C4181", "C4188", "C4193", "C4194", "C4195", "C4196", "C4199"] +helpviewer_keywords: ["C4023", "C4035", "C4051", "C4060", "C4063", "C4064", "C4065", "C4069", "C4123", "C4137", "C4181", "C4188", "C4193", "C4194", "C4195", "C4196", "C4199"] --- # Microsoft C/C++ compiler warnings C4000 through C4199 @@ -15,8 +16,8 @@ The articles in this section describe Microsoft C/C++ compiler warning messages |Warning|Message| |-------------|-------------| |[Compiler warning (level 4, no longer emitted) C4001](compiler-warning-level-4-c4001.md)|nonstandard extension 'single line comment' was used| -|[Compiler warning (level 1, Error) C4002](compiler-warning-level-1-c4002.md)|too many arguments for function-like macro invocation '*identifier*'| -|[Compiler warning (level 1, Error) C4003](compiler-warning-level-1-c4003.md)|not enough arguments for function-like macro invocation '*identifier*'| +|[Compiler warning (level 1, error) C4002](compiler-warning-level-1-c4002.md)|too many arguments for function-like macro invocation '*identifier*'| +|[Compiler warning (level 1, error) C4003](compiler-warning-level-1-c4003.md)|not enough arguments for function-like macro invocation '*identifier*'| |[Compiler warning (level 1) C4005](compiler-warning-level-1-c4005.md)|'*identifier*': macro redefinition| |[Compiler warning (level 1) C4006](compiler-warning-level-1-c4006.md)|`#undef` expected an identifier| |[Compiler warning (level 3) C4007](compiler-warning-level-2-c4007.md)|'*function*': must be '*attribute*'| @@ -27,10 +28,10 @@ The articles in this section describe Microsoft C/C++ compiler warning messages |[Compiler warning (level 3) C4018](compiler-warning-level-3-c4018.md)|'*expression*': signed/unsigned mismatch| |[Compiler warning (level 4) C4019](compiler-warning-level-4-c4019.md)|empty statement at global scope| |[Compiler warning (level 1) C4020](compiler-warning-level-1-c4020.md)|'function': too many actual parameters| -|[Compiler warning (level 1) C4022](compiler-warning-level-1-c4022.md)|'*function*': pointer mismatch for actual parameter '*parameter_number*'| -|Compiler warning (level 1) C4023|'*function*': based pointer passed to unprototyped function: parameter '*parameter_number*'| -|[Compiler warning (level 1) C4024](compiler-warning-level-1-c4024.md)|'*function*': different types for formal and actual parameter '*parameter_number*'| -|[Compiler warning (level 1) C4025](compiler-warning-level-1-c4025.md)|'*function*': based pointer passed to function with variable arguments: parameter '*parameter_number*'| +|[Compiler warning (level 1) C4022](compiler-warning-level-1-c4022.md)|'*function*': pointer mismatch for actual parameter *parameter_number*| +|Compiler warning (level 1) C4023|'*function*': based pointer passed to unprototyped function: parameter *parameter_number*| +|[Compiler warning (level 1) C4024](compiler-warning-level-1-c4024.md)|'*function*': different types for formal and actual parameter *parameter_number*| +|[Compiler warning (level 1) C4025](compiler-warning-level-1-c4025.md)|'*function*': based pointer passed to function with variable arguments: parameter *parameter_number*| |[Compiler warning (level 1) C4026](compiler-warning-level-1-c4026.md)|function declared with formal parameter list| |[Compiler warning (level 1) C4027](compiler-warning-level-1-c4027.md)|function declared without formal parameter list| |[Compiler warning (level 1) C4028](compiler-warning-level-1-c4028.md)|formal parameter *parameter_number* different from declaration| @@ -68,7 +69,7 @@ The articles in this section describe Microsoft C/C++ compiler warning messages |[Compiler warning (level 3) C4073](compiler-warning-level-3-c4073.md)|initializers put in library initialization area| |[Compiler warning (level 1) C4074](compiler-warning-level-1-c4074.md)|initializers put in compiler reserved initialization area| |[Compiler warning (level 1) C4075](compiler-warning-level-1-c4075.md)|initializers put in unrecognized initialization area| -|[Compiler warning (level 1) C4076](compiler-warning-level-1-c4076.md)|'*type_modifier*': can't be used with type '*typename*'| +|[Compiler warning (level 1) C4076](compiler-warning-level-1-c4076.md)|'*type_modifier*': cannot be used with type '*typename*'| |[Compiler warning (level 1) C4077](compiler-warning-level-1-c4077.md)|unknown check_stack option| |[Compiler warning (level 1) C4079](compiler-warning-level-1-c4079.md)|unexpected token '*token*'| |[Compiler warning (level 1) C4080](compiler-warning-level-1-c4080.md)|expected identifier for segment name; found '*symbol*'| @@ -77,8 +78,8 @@ The articles in this section describe Microsoft C/C++ compiler warning messages |[Compiler warning (level 1) C4085](compiler-warning-level-1-c4085.md)|expected pragma parameter to be '`on`' or '`off`'| |[Compiler warning (level 1) C4086](compiler-warning-level-1-c4086.md)|expected pragma parameter to be '1', '2', '4', '8', or '16'| |[Compiler warning (level 1) C4087](compiler-warning-level-1-c4087.md)|'function': declared with '`void`' parameter list| -|[Compiler warning (level 1) C4088](compiler-warning-level-1-c4088.md)|'*function*': pointer mismatch in actual parameter '*parameter_number*', formal parameter '*parameter_number*'| -|[Compiler warning (level 1) C4089](compiler-warning-level-1-c4089.md)|'*function*': different types in actual parameter '*parameter_number*', formal parameter '*parameter_number*'| +|[Compiler warning (level 1) C4088](compiler-warning-level-1-c4088.md)|'*function*': pointer mismatch in actual parameter *parameter_number*, formal parameter *parameter_number*| +|[Compiler warning (level 1) C4089](compiler-warning-level-1-c4089.md)|'*function*': different types in actual parameter *parameter_number*, formal parameter *parameter_number*| |[Compiler warning (level 1) C4090](compiler-warning-level-1-c4090.md)|'*operation*': different '*modifier*' qualifiers| |[Compiler warning (level 1 and level 2) C4091](compiler-warning-level-1-c4091.md)|'*keyword*': ignored on left of '*type*' when no variable is declared| |[Compiler warning (level 4) C4092](compiler-warning-level-4-c4092.md)|sizeof returns 'unsigned long'| @@ -87,12 +88,12 @@ The articles in this section describe Microsoft C/C++ compiler warning messages |[Compiler warning (level 1) C4097](compiler-warning-level-1-c4097.md)|expected pragma parameter to be '`restore`' or '`off`'| |[Compiler warning (level 1) C4098](compiler-warning-level-1-c4098.md)|'*function*': '`void`' function returning a value| |[Compiler warning (level 2) C4099](compiler-warning-level-2-c4099.md)|'*identifier*': type name first seen using '*object_type1*' now seen using '*object_type2*'| -|[Compiler warning (level 4) C4100](compiler-warning-level-4-c4100.md)|'*identifier*': unreferenced formal parameter| +|[Compiler warning (level 4) C4100](compiler-warning-level-4-c4100.md)|'*identifier*': unreferenced parameter| |[Compiler warning (level 3 and level 4) C4101](compiler-warning-level-3-c4101.md)|'*identifier*': unreferenced local variable| |[Compiler warning (level 3) C4102](compiler-warning-level-3-c4102.md)|'*label*': unreferenced label| |[Compiler warning (level 1) C4103](compiler-warning-level-1-c4103.md)|alignment changed after including header, may be due to missing `#pragma pack(pop)`| |[Compiler warning (level 1) C4109](compiler-warning-level-1-c4109.md)|unexpected identifier '*identifier*'| -|[Compiler warning (level 1 and level 4) C4112](compiler-warning-levels-1-and-4-c4112.md)|`#line` requires an integer between 1 and '*line_count*'| +|[Compiler warning (level 1 and level 4) C4112](compiler-warning-levels-1-and-4-c4112.md)|`#line` requires an integer between 1 and *line_count*| |[Compiler warning (level 1) C4113](compiler-warning-level-1-c4113.md)|'*identifier1*' differs in parameter lists from '*identifier2*'| |[Compiler warning (level 1) C4114](compiler-warning-level-1-c4114.md)|same type qualifier used more than once| |[Compiler warning (level 1 and level 4) C4115](compiler-warning-levels-1-and-4-c4115.md)|'*type*': named type definition in parentheses| @@ -113,7 +114,7 @@ The articles in this section describe Microsoft C/C++ compiler warning messages |[Compiler warning (level 1 and level 3) C4133](compiler-warning-level-3-c4133.md)|'*expression*': incompatible types - from '*type1*' to '*type2*'| |Compiler warning C4137|'function': no return value from floating-point function| |[Compiler warning (level 1) C4138](compiler-warning-level-1-c4138.md)|'`*/`' found outside of comment| -|[Compiler warning (level 1, Error) C4141](compiler-warning-level-1-c4141.md)|'*modifier*': used more than once| +|[Compiler warning (level 1, error) C4141](compiler-warning-level-1-c4141.md)|'*modifier*': used more than once| |[Compiler warning (level 1) C4142](compiler-warning-level-1-c4142.md)|'*identifier*': benign redefinition of type| |[Compiler warning (level 1) C4143](compiler-warning-level-1-c4143.md)|`pragma` 'same_seg' not supported; use `__based` allocation| |[Compiler warning (level 1) C4144](compiler-warning-level-1-c4144.md)|'*expression*': relational expression as switch expression| @@ -126,10 +127,10 @@ The articles in this section describe Microsoft C/C++ compiler warning messages |[Compiler warning (level 1) C4155](compiler-warning-level-1-c4155.md)|deletion of an array expression without using the array form of 'delete'| |[Compiler warning (level 2) C4156](compiler-warning-level-2-c4156.md)|deletion of an array expression without using the array form of 'delete'; array form substituted| |[Compiler warning (level 1) C4157](compiler-warning-level-1-c4157.md)|pragma was ignored by C compiler| -|[Compiler warning (level 1) C4158](compiler-warning-level-1-c4158.md)|assuming `#pragma pointers_to_members(full_generality, `'*inheritance_type*'`)`| -|[Compiler warning (level 3) C4159](compiler-warning-level-3-c4159.md)|`#pragma `'*pragma*'`(pop,...)`: has popped previously pushed identifier '*identifier*'| -|[Compiler warning (level 1) C4160](compiler-warning-level-1-c4160.md)|`#pragma `'*pragma*'`(pop,...)`: did not find previously pushed identifier '*identifier*'| -|[Compiler warning (level 3) C4161](compiler-warning-level-3-c4161.md)|`#pragma `'*pragma*'`(pop...)`: more pops than pushes| +|[Compiler warning (level 1) C4158](compiler-warning-level-1-c4158.md)|assuming `#pragma pointers_to_members(full_generality, `*inheritance_type*`)`| +|[Compiler warning (level 3) C4159](compiler-warning-level-3-c4159.md)|`#pragma `*pragma*`(pop,...)`: has popped previously pushed identifier '*identifier*'| +|[Compiler warning (level 1) C4160](compiler-warning-level-1-c4160.md)|`#pragma `*pragma*`(pop,...)`: did not find previously pushed identifier '*identifier*'| +|[Compiler warning (level 3) C4161](compiler-warning-level-3-c4161.md)|`#pragma `*pragma*`(pop...)`: more pops than pushes| |[Compiler warning (level 1) C4162](compiler-warning-level-1-c4162.md)|'*identifier*': no function with C linkage found| |[Compiler warning (level 1) C4163](compiler-warning-level-1-c4163.md)|'*identifier*': not available as an intrinsic function| |[Compiler warning (level 1) C4164](compiler-warning-level-1-c4164.md)|'*function*': intrinsic function not declared| @@ -137,7 +138,7 @@ The articles in this section describe Microsoft C/C++ compiler warning messages |[Compiler warning (level 1) C4166](compiler-warning-level-1-c4166.md)|illegal calling convention for constructor/destructor| |[Compiler warning (level 1) C4167](compiler-warning-level-1-c4167.md)|'*function*': only available as an intrinsic function| |[Compiler warning (level 1) C4168](compiler-warning-level-1-c4168.md)|compiler limit: out of debugger types, delete program database '*database*' and rebuild| -|[Compiler warning (level 1) C4172](compiler-warning-level-1-c4172.md)|returning address of local variable or temporary *optional_context*| +|[Compiler warning (level 1) C4172](compiler-warning-level-1-c4172.md)|returning address of local variable or temporary : *optional_context*| |[Compiler warning (level 1) C4174](compiler-warning-level-1-c4174.md)|'*name*': not available as a `#pragma component`| |[Compiler warning (level 1) C4175](compiler-warning-level-1-c4175.md)|`#pragma component(browser, on)`: browser info must initially be specified on the command line| |[Compiler warning (level 1) C4176](compiler-warning-level-1-c4176.md)|'*subcomponent*': unknown subcomponent for `#pragma component` browser| @@ -148,12 +149,12 @@ The articles in this section describe Microsoft C/C++ compiler warning messages |Compiler warning C4181|qualifier applied to reference type; ignored| |[Compiler warning (level 1) C4182](compiler-warning-level-1-c4182.md)|`#include` nesting level is *nest_count* deep; possible infinite recursion| |[Compiler warning (level 1) C4183](compiler-warning-level-1-c4183.md)|'*identifier*': missing return type; assumed to be a member function returning '`int`'| -|[Compiler warning (level 1) C4185](compiler-warning-level-1-c4185.md)|ignoring unknown `#import` attribute '*attribute*'| -|[Compiler warning (level 1) C4186](compiler-warning-level-1-c4186.md)|`#`*import* attribute '*attribute*' requires '*argument_count*' arguments; ignored| +|[Compiler warning (level 1) C4185](compiler-warning-level-1-c4185.md)|ignoring unknown `#`*import* attribute '*attribute*'| +|[Compiler warning (level 1) C4186](compiler-warning-level-1-c4186.md)|`#`*import* attribute '*attribute*' requires *argument_count* arguments; ignored| |[Compiler warning (level 1) C4187](compiler-warning-level-1-c4187.md)|`#import` attributes '*attribute1*' and '*attribute2*' are incompatible; both ignored| |Compiler warning (level 1) C4188|constant expression is not integral| |[Compiler warning (level 3 and level 4) C4189](compiler-warning-level-4-c4189.md)|'*identifier*': local variable is initialized but not referenced| -|[Compiler warning (level 1) C4190](compiler-warning-level-1-c4190.md)|'*identifier1*' has C-linkage specified, but returns UDT '*identifier2*' which is incompatible with C| +|[Compiler warning (level 1) C4190](compiler-warning-level-1-c4190.md)|'*identifier1*' has C-linkage specified, but returns '*identifier2*' which is incompatible with C| |[Compiler warning (level 3, off) C4191](compiler-warning-level-3-c4191.md)|'*operation*': unsafe conversion from '*type_of_expression*' to '*type_required*'
Making a function call using the resulting pointer may cause your program to fail| |[Compiler warning (level 3) C4192](compiler-warning-level-3-c4192.md)|automatically excluding '*identifier*' while importing type library '*library*'| |Compiler warning (level 3) C4193|`#pragma warning(pop)`: no matching '`#pragma warning(push)`'| diff --git a/docs/error-messages/compiler-warnings/compiler-warnings-c4200-through-c4399.md b/docs/error-messages/compiler-warnings/compiler-warnings-c4200-through-c4399.md index 276cb8c9c9f..03ae1478d6a 100644 --- a/docs/error-messages/compiler-warnings/compiler-warnings-c4200-through-c4399.md +++ b/docs/error-messages/compiler-warnings/compiler-warnings-c4200-through-c4399.md @@ -3,6 +3,7 @@ title: "Microsoft C/C++ compiler (MSVC) warnings C4200 through C4399" description: "Table of Microsoft C/C++ compiler (MSVC) warnings C4200 through C4399." ms.date: 10/18/2020 f1_keywords: ["C4203", "C4277", "C4279", "C4298", "C4299", "C4301", "C4303", "C4314", "C4315", "C4317", "C4318", "C4321", "C4322", "C4323", "C4327", "C4328", "C4330", "C4338", "C4352", "C4362", "C4367", "C4370", "C4380", "C4387"] +helpviewer_keywords: ["C4203", "C4277", "C4279", "C4298", "C4299", "C4301", "C4303", "C4314", "C4315", "C4317", "C4318", "C4321", "C4322", "C4323", "C4327", "C4328", "C4330", "C4338", "C4352", "C4362", "C4367", "C4370", "C4380", "C4387"] --- # Microsoft C/C++ compiler warnings C4200 through C4399 @@ -54,7 +55,7 @@ The articles in this section describe Microsoft C/C++ compiler warning messages |[Compiler warning (level 2 and level 3 and level 4) C4244](compiler-warning-levels-3-and-4-c4244.md)|'*conversion_type*': conversion from '*type1*' to '*type2*', possible loss of data| |[Compiler warning (level 4) C4245](compiler-warning-level-4-c4245.md)|'*conversion_type*': conversion from '*type1*' to '*type2*', signed/unsigned mismatch| |[Compiler warning (level 2) C4250](compiler-warning-level-2-c4250.md)|'*classname*': inherits '*base_classname*::*member*' via dominance| -|[Compiler warning (level 2) C4251](compiler-warning-level-1-c4251.md)|'*object_type1*': '*identifier1*' needs to have dll-interface to be used by clients of '*identfier2*'| +|[Compiler warning (level 2) C4251](compiler-warning-level-1-c4251.md)|'*type*': '*type1*' needs to have dll-interface to be used by clients of '*type2*'| |[Compiler warning (level 4, off) C4254](compiler-warning-level-4-c4254.md)|'*operator*': conversion from '*type1*':'*field_bits*' to '*type2*':'*field_bits*', possible loss of data| |[Compiler warning (level 4, off) C4255](compiler-warning-level-4-c4255.md)|'*function*': no function prototype given: converting '()' to '(void)'| |[Compiler warning (level 4) C4256](compiler-warning-level-4-c4256.md)|'*function*': constructor for class with virtual bases has '`...`'; calls may not be compatible with older versions of Visual C++| @@ -125,7 +126,7 @@ The articles in this section describe Microsoft C/C++ compiler warning messages |[Compiler warning (level 4) C4336](compiler-warning-level-4-c4336.md)|import cross-referenced type library '*library1*' before importing '*library2*'| |[Compiler warning (level 4) C4337](compiler-warning-level-4-c4337.md)|cross-referenced type library '*library1*' in '*library2*' is being automatically imported| |Compiler warning (level 4) C4338|#pragma *directive*: standard section '*section*' is used| -|[Compiler warning (level 4, off) C4339](compiler-warning-level-4-c4339.md)|'*type*': use of undefined type detected in 'WinRT\|CLR' meta-data - use of this type may lead to a runtime exception| +|[Compiler warning (level 4, off) C4339](compiler-warning-level-4-c4339.md)|'*type*': use of undefined type detected in *WinRT/CLR* meta-data - use of this type may lead to a runtime exception| |[Compiler warning (level 1) C4340](compiler-warning-level-1-c4340.md)|'*value*': value wrapped from positive to negative value| |[Compiler warning (level 1, off, no longer emitted) C4342](compiler-warning-level-1-c4342.md)|behavior change: '*function*' called, but a member operator was called in previous versions| |[Compiler warning (level 4) C4343](compiler-warning-level-4-c4343.md)|`#pragma optimize("g",off)` overrides `/Og` option| @@ -135,7 +136,7 @@ The articles in this section describe Microsoft C/C++ compiler warning messages |[Compiler warning (level 1, off, no longer emitted) C4350](compiler-warning-level-1-c4350.md)|behavior change: '*member1*' called instead of '*member2*'| |Compiler warning (level 1) C4352|'*identifier*': intrinsic function already defined| |[Compiler warning (level 1) C4353](compiler-warning-level-1-c4353.md)|nonstandard extension used: constant 0 as function expression. Use '__noop' function intrinsic instead| -|[Compiler warning (level 1 and level 4, off) C4355](compiler-warning-c4355.md)Compiler warning (level 1 and level 4) C4355|'this': used in base member initializer list| +|[Compiler warning (level 1 and level 4, off) C4355](compiler-warning-c4355.md)|'this': used in base member initializer list| |[Compiler warning (level 2) C4356](compiler-warning-level-2-c4356.md)|'*member*': static data member cannot be initialized via derived class| |[Compiler warning (level 3) C4357](compiler-warning-level-3-c4357.md)|param array argument found in formal argument list for delegate '*delegate*' ignored when generating '*function*'| |[Compiler warning (level 1) C4358](compiler-warning-level-1-c4358.md)|'*operator*': return type of combined delegates is not 'void'; returned value is undefined| @@ -162,7 +163,7 @@ The articles in this section describe Microsoft C/C++ compiler warning messages |[Compiler warning (level 1) C4383](compiler-warning-level-1-c4383.md)|'*instance_dereference_operator*': the meaning of dereferencing a handle can change, when a user-defined '*instance_dereference_operator*' operator exists; write the operator as a static function to be explicit about the operand| |[Compiler warning (level 1) C4384](compiler-warning-level-1-c4384.md)|`#pragma` '*pragma_name*' should only be used at global scope| |Compiler warning (level 3) C4387|'*alternative*': was considered| -|[Compiler warning (level 4, off) C4388](./c4388.md))|'*expression*': signed/unsigned mismatch| +|[Compiler warning (level 4, off) C4388](./c4388.md)|'*expression*': signed/unsigned mismatch| |[Compiler warning (level 4) C4389](compiler-warning-level-4-c4389.md)|'*operator*': signed/unsigned mismatch| |[Compiler warning (level 3) C4390](compiler-warning-level-3-c4390.md)|';': empty controlled statement found; is this the intent?| |[Compiler warning (level 1) C4391](compiler-warning-level-1-c4391.md)|'*function_signature*': incorrect return type for intrinsic function, expected '*type*'| diff --git a/docs/error-messages/compiler-warnings/compiler-warnings-c4400-through-c4599.md b/docs/error-messages/compiler-warnings/compiler-warnings-c4400-through-c4599.md index 01f55ec3569..e0ce42c2539 100644 --- a/docs/error-messages/compiler-warnings/compiler-warnings-c4400-through-c4599.md +++ b/docs/error-messages/compiler-warnings/compiler-warnings-c4400-through-c4599.md @@ -1,7 +1,7 @@ --- title: "Microsoft C/C++ compiler (MSVC) warnings C4400 through C4599" description: "Table of Microsoft C/C++ compiler (MSVC) warnings C4400 through C4599" -ms.date: "04/21/2019" +ms.date: 1/22/2025 f1_keywords: ["C4413", "C4415", "C4416", "C4417", "C4418", "C4419", "C4421", "C4423", "C4424", "C4425", "C4426", "C4427", "C4438", "C4442", "C4443", "C4444", "C4446", "C4447", "C4448", "C4449", "C4450", "C4451", "C4452", "C4453", "C4454", "C4455", "C4466", "C4467", "C4468", "C4472", "C4474", "C4475", "C4476", "C4478", "C4480", "C4482", "C4483", "C4491", "C4492", "C4493", "C4494", "C4495", "C4496", "C4497", "C4498", "C4499", "C4509", "C4519", "C4531", "C4542", "C4562", "C4568", "C4569", "C4573", "C4574", "C4575", "C4576", "C4578", "C4582", "C4583", "C4585", "C4586", "C4587", "C4588", "C4589", "C4591", "C4592", "C4593", "C4594", "C4595", "C4598", "C4599"] helpviewer_keywords: ["C4413", "C4415", "C4416", "C4417", "C4418", "C4419", "C4421", "C4423", "C4424", "C4425", "C4426", "C4427", "C4438", "C4442", "C4443", "C4444", "C4446", "C4447", "C4448", "C4449", "C4450", "C4451", "C4452", "C4453", "C4454", "C4455", "C4466", "C4467", "C4468", "C4472", "C4474", "C4475", "C4476", "C4478", "C4480", "C4482", "C4483", "C4491", "C4492", "C4493", "C4494", "C4495", "C4496", "C4497", "C4498", "C4499", "C4509", "C4519", "C4531", "C4542", "C4562", "C4568", "C4569", "C4573", "C4574", "C4575", "C4576", "C4578", "C4582", "C4583", "C4585", "C4586", "C4587", "C4588", "C4589", "C4591", "C4592", "C4593", "C4594", "C4595", "C4598", "C4599"] --- @@ -15,186 +15,186 @@ The articles in this section describe Microsoft C/C++ compiler warning messages |Warning|Message| |-------------|-------------| -|[Compiler warning (level 1) C4600](compiler-warning-level-1-c4600.md)|#pragma '*macro name*': expected a valid non-empty string| -|[Compiler warning (level 4) C4400](../../error-messages/compiler-warnings/compiler-warning-level-4-c4400.md)|'*type*': const/volatile qualifiers on this type are not supported| -|[Compiler warning (level 1) C4401](../../error-messages/compiler-warnings/compiler-warning-level-1-c4401.md)|'*bitfield*': member is bit field| -|[Compiler warning (level 1) C4402](../../error-messages/compiler-warnings/compiler-warning-level-1-c4402.md)|must use PTR operator| -|[Compiler warning (level 1) C4403](../../error-messages/compiler-warnings/compiler-warning-level-1-c4403.md)|illegal PTR operator| -|[Compiler warning (level 3) C4404](../../error-messages/compiler-warnings/compiler-warning-level-3-c4404.md)|period on directive ignored| -|[Compiler warning (level 1) C4405](../../error-messages/compiler-warnings/compiler-warning-level-1-c4405.md)|'*identifier*': identifier is reserved word| -|[Compiler warning (level 1) C4406](../../error-messages/compiler-warnings/compiler-warning-level-1-c4406.md)|operand on directive ignored| -|[Compiler warning (level 1) C4407](../../error-messages/compiler-warnings/compiler-warning-level-1-c4407.md)|cast between different pointer to member representations, compiler may generate incorrect code| -|[Compiler warning (level 4) C4408](../../error-messages/compiler-warnings/compiler-warning-level-4-c4408.md)|anonymous 'struct\|union' did not declare any data members| -|[Compiler warning (level 1) C4409](../../error-messages/compiler-warnings/compiler-warning-level-1-c4409.md)|illegal instruction size| -|[Compiler warning (level 1) C4410](../../error-messages/compiler-warnings/compiler-warning-level-1-c4410.md)|illegal size for operand| -|[Compiler warning (level 1) C4411](../../error-messages/compiler-warnings/compiler-warning-level-1-c4411.md)|'*identifier*': symbol resolves to displacement register| -|[Compiler warning (level 2) C4412](../../error-messages/compiler-warnings/compiler-warning-level-2-c4412.md)|'*function*': function signature contains type '*type*'; C++ objects are unsafe to pass between pure code and mixed or native.| -|Compiler warning C4413|'classname::member': reference member is initialized to a temporary that doesn't persist after the constructor exits| -|[Compiler warning (level 3) C4414](../../error-messages/compiler-warnings/compiler-warning-level-3-c4414.md)|'*function*': short jump to function converted to near| -|Compiler warning (level 1) C4415|duplicate __declspec(code_seg('*name*'))| -|Compiler warning (level 1) C4416|__declspec(code_seg(...)) contains empty string: ignored| -|Compiler warning (level 1) C4417|an explicit template instantiation cannot have __declspec(code_seg(...)): ignored| -|Compiler warning (level 1) C4418|__declspec(code_seg(...)) ignored on an enum| -|Compiler warning (level 3) C4419|'*symbol*' has no effect when applied to private ref class '*class*'.| -|[Compiler warning (level 1) C4420](../../error-messages/compiler-warnings/compiler-warning-level-1-c4420.md)|'*checked_operator*': operator not available, using '*operator*' instead; run-time checking may be compromised| +|[Compiler warning (level 4, Error) C4400](compiler-warning-level-4-c4400.md)|'*type*': `const`/`volatile` qualifiers on this type are not supported| +|[Compiler warning (level 1) C4401](compiler-warning-level-1-c4401.md)|'*bitfield*': member is bit field| +|[Compiler warning (level 1) C4402](compiler-warning-level-1-c4402.md)|must use `PTR` operator| +|[Compiler warning (level 1) C4403](compiler-warning-level-1-c4403.md)|illegal `PTR` operator| +|[Compiler warning (level 3) C4404](compiler-warning-level-3-c4404.md)|period on directive ignored| +|[Compiler warning (level 1) C4405](compiler-warning-level-1-c4405.md)|'*identifier*': identifier is reserved word| +|[Compiler warning (level 1) C4406](compiler-warning-level-1-c4406.md)|operand on directive ignored| +|[Compiler warning (level 1) C4407](compiler-warning-level-1-c4407.md)|cast between different pointer to member representations, compiler may generate incorrect code| +|[Compiler warning (level 4) C4408](compiler-warning-level-4-c4408.md)|anonymous *struct/union* did not declare any data members| +|[Compiler warning (level 1) C4409](compiler-warning-level-1-c4409.md)|illegal instruction size| +|[Compiler warning (level 1) C4410](compiler-warning-level-1-c4410.md)|illegal size for operand| +|[Compiler warning (level 1) C4411](compiler-warning-level-1-c4411.md)|'*identifier*': symbol resolves to displacement register| +|[Compiler warning (level 2, off) C4412](compiler-warning-level-2-c4412.md)|'*function*': function signature contains type '*type*'; C++ objects are unsafe to pass between pure code and mixed or native.| +|Compiler warning (no longer emitted) C4413|'`classname::member`': reference member is initialized to a temporary that doesn't persist after the constructor exits| +|[Compiler warning (level 3) C4414](compiler-warning-level-3-c4414.md)|'*function*': short jump to function converted to near| +|Compiler warning (level 1) C4415|duplicate `__declspec(code_seg(`'*name*'`))`| +|Compiler warning (level 1) C4416|`__declspec(code_seg(...))` contains empty string: ignored| +|Compiler warning (level 1) C4417|an explicit template instantiation cannot have `__declspec(code_seg(...))`: ignored| +|Compiler warning (level 1) C4418|`__declspec(code_seg(...))` ignored on an `enum`| +|Compiler warning (level 3) C4419|'*symbol*' has no effect when applied to `private ref class` '*class*'.| +|[Compiler warning (level 1) C4420](compiler-warning-level-1-c4420.md)|'*checked_operator*': operator not available, using '*operator*' instead; run-time checking may be compromised| |Compiler warning (level 3) C4421|'*parameter*': a reference parameter on a resumable function is potentially unsafe| -|Compiler warning (level 3) C4423|'std::bad_alloc': will be caught by class ('*type*') on line *number*| -|Compiler warning (level 3) C4424|catch for '*type1*' preceded by '*type2*' on line *number*; unpredictable behavior may result if 'std::bad_alloc' is thrown| -|Compiler warning (level 1) C4425|A SAL annotation cannot be applied to '...'| -|Compiler warning (level 1) C4426|optimization flags changed after including header, may be due to #pragma optimize()| +|Compiler warning (level 3) C4423|'`std::bad_alloc`': will be caught by class ('*type*') on line *number*| +|Compiler warning (level 3) C4424|catch for '*type1*' preceded by '*type2*' on line *number*; unpredictable behavior may result if '`std::bad_alloc`' is thrown| +|Compiler warning (level 1) C4425|A SAL annotation cannot be applied to '`...`'| +|Compiler warning (level 1, off) C4426|optimization flags changed after including header, may be due to `#pragma optimize()`| |Compiler warning (level 1) C4427|'*operator*': overflow in constant division, undefined behavior| -|[Compiler warning (level 4) C4429](../../error-messages/compiler-warnings/compiler-warning-level-4-c4429.md)|possible incomplete or improperly formed universal-character-name| -|[Compiler warning (Error) C4430](../../error-messages/compiler-warnings/compiler-warning-c4430.md)|missing type specifier - int assumed. Note: C++ does not support default-int| -|[Compiler warning (level 4) C4431](../../error-messages/compiler-warnings/compiler-warning-level-4-c4431.md)|missing type specifier - int assumed. Note: C no longer supports default-int| -|[Compiler warning (level 4) C4434](../../error-messages/compiler-warnings/compiler-warning-level-4-c4434.md)|a static constructor must have private accessibility; changing to private access| -|[Compiler warning (level 4) C4435](../../error-messages/compiler-warnings/compiler-warning-level-4-c4435.md)|'*derived_class*': Object layout under /vd2 will change due to virtual base '*base_class*'| -|[Compiler warning (level 1) C4436](../../error-messages/compiler-warnings/compiler-warning-level-1-c4436.md)|dynamic\_cast from virtual base '*base_class*' to '*derived_class*' in constructor or destructor could fail with partially-constructed object| -|[Compiler warning (level 4) C4437](../../error-messages/compiler-warnings/compiler-warning-level-4-c4437.md)|dynamic\_cast from virtual base '*base_class*' to '*derived_class*' could fail in some contexts| -|Compiler warning C4438|'*function*': cannot be called safely in /await:clrcompat mode. If '*function*' calls into the CLR it may result in CLR head corruption| -|[Compiler warning (Error) C4439](../../error-messages/compiler-warnings/compiler-warning-c4439.md)|'*function*': function definition with a managed type in the signature must have a __clrcall calling convention| -|[Compiler warning (level 1) C4440](../../error-messages/compiler-warnings/compiler-warning-level-1-c4440.md)|calling convention redefinition from '*calling_convention1*' to '*calling_convenction2*' ignored| -|[Compiler warning (level 1) C4441](../../error-messages/compiler-warnings/compiler-warning-level-1-c4441.md)|calling convention of '*calling_convention1*' ignored; '*calling_convention2*' used instead| -|Compiler warning (level 1) C4442|embedded null terminator in __annotation argument. Value will be truncated.| -|Compiler warning (level 1) C4443|expected pragma parameter to be '0', '1', or '2'| -|Compiler warning (level 3) C4444|'*identifier*': top level '__unaligned' is not implemented in this context| -|[Compiler warning (level 1) C4445](../../error-messages/compiler-warnings/compiler-warning-level-1-c4445.md)|'*function*': in a 'WinRT\|managed' type a virtual method cannot be private| +|[Compiler warning (level 4) C4429](compiler-warning-level-4-c4429.md)|possible incomplete or improperly formed universal-character-name| +|[Compiler warning (level 1, Error) C4430](compiler-warning-c4430.md)|missing type specifier - int assumed. Note: C++ does not support default-int| +|[Compiler warning (level 4) C4431](compiler-warning-level-4-c4431.md)|missing type specifier - int assumed. Note: C no longer supports default-int| +|[Compiler warning (level 4) C4434](compiler-warning-level-4-c4434.md)|a static constructor must have private accessibility; changing to private access| +|[Compiler warning (level 4, off) C4435](compiler-warning-level-4-c4435.md)|'*derived_class*': Object layout under `/vd2` will change due to virtual base '*base_class*'| +|[Compiler warning (level 1 and level 4) C4436](compiler-warning-level-1-c4436.md)|`dynamic_cast` from virtual base '*base_class*' to '*derived_class*' in constructor or destructor could fail with partially-constructed object| +|[Compiler warning (level 1 and level 4, off) C4437](compiler-warning-level-4-c4437.md)|`dynamic_cast` from virtual base '*base_class*' to '*derived_class*' could fail in some contexts| +|Compiler warning C4438|'*function*': cannot be called safely in `/await:clrcompat` mode. If '*function*' calls into the CLR it may result in CLR head corruption| +|[Compiler warning (level 1, Error) C4439](compiler-warning-c4439.md)|'*function*': function definition with a managed type in the signature must have a `__clrcall` calling convention| +|[Compiler warning (level 1) C4440](compiler-warning-level-1-c4440.md)|calling convention redefinition from '*calling_convention1*' to '*calling_convenction2*' ignored| +|[Compiler warning (level 1) C4441](compiler-warning-level-1-c4441.md)|calling convention of '*calling_convention1*' ignored; '*calling_convention2*' used instead| +|Compiler warning (level 1) C4442|embedded null terminator in `__annotation` argument. Value will be truncated.| +|Compiler warning (level 1) C4443|expected pragma parameter to be '`0`', '`1`', or '`2`'| +|Compiler warning (level 3, off) C4444|'*identifier*': top level '`__unaligned`' is not implemented in this context| +|[Compiler warning (level 1) C4445](compiler-warning-level-1-c4445.md)|'*function*': in a *WinRT/managed* type a virtual method cannot be private| |Compiler warning (level 1) C4446|'*type*': cannot map member '*name1*' into this type, due to conflict with the type name. The method was renamed to '*name2*'| -|Compiler warning (level 1) C4447|'main' signature found without threading model. Consider using 'int main(Platform::Array\^ args)'.| -|Compiler warning C4448|'*type*1' does not have a default interface specified in metadata. Picking: '*type2*', which may fail at runtime.| -|Compiler warning C4449|'*type*' an unsealed type should be marked as '[WebHostHidden]'| -|Compiler warning C4450|'*type1*' should be marked as '[WebHostHidden]' because it derives from '*type2*'| -|Compiler warning (level 4) C4451|'classname1::member': Usage of ref class 'classname2::member' inside this context can lead to invalid marshaling of object across contexts| -|Compiler warning (level 1) C4452|'*identifier*': public type cannot be at global scope. It must be in a namespace that is a child of the name of the output .winmd file.| -|Compiler warning (level 1) C4453|'*type*': A '[WebHostHidden]' type should not be used on the published surface of a public type that is not '[WebHostHidden]'| -|Compiler warning (level 1) C4454|'*function*' is overloaded by more than the number of input parameters without having [DefaultOverload] specified. Picking '*declaration*' as the default overload| +|Compiler warning (level 1) C4447|'`main`' signature found without threading model. Consider using '`int main(Platform::Array^ args)`'.| +|Compiler warning (level 1) C4448|'*type1*' does not have a default interface specified in metadata. Picking: '*type2*', which may fail at runtime.| +|Compiler warning C4449|'*type*' an unsealed type should be marked as '`[WebHostHidden]`'| +|Compiler warning C4450|'*type1*' should be marked as '`[WebHostHidden]`' because it derives from '*type2*'| +|Compiler warning (level 3 and level 4) C4451|'*classname1::member*': Usage of ref class '*classname2::member*' inside this context can lead to invalid marshaling of object across contexts| +|Compiler warning (level 1, Error) C4452|'*identifier*': public type cannot be at global scope. It must be in a namespace that is a child of the name of the output `.winmd` file.| +|Compiler warning (level 1) C4453|'*type*': A '`[WebHostHidden]`' type should not be used on the published surface of a public type that is not '`[WebHostHidden]`'| +|Compiler warning (level 1) C4454|'*function*' is overloaded by more than the number of input parameters without having `[DefaultOverload]` specified. Picking '*declaration*' as the default overload| |Compiler warning (level 1) C4455|'operator *operator*': literal suffix identifiers that do not start with an underscore are reserved| -|[Compiler warning (level 4) C4456](compiler-warning-level-4-c4456.md)|declaration of '*identifier*' hides previous local declaration| -|[Compiler warning (level 4) C4457](compiler-warning-level-4-c4457.md)|declaration of '*identifier*' hides function parameter| -|[Compiler warning (level 4) C4458](compiler-warning-level-4-c4458.md)|declaration of '*identifier*' hides class member| -|[Compiler warning (level 4) C4459](compiler-warning-level-4-c4459.md)|declaration of '*identifier*' hides global declaration| -|[Compiler warning (level 4) C4460](../../error-messages/compiler-warnings/compiler-warning-level-4-c4460.md)|'WinRT\|managed' operator '*operator*', has parameter passed by reference. 'WinRT\|managed' operator '*operator*' has different semantics from C++ operator '*cpp_operator*', did you intend to pass by value?| -|[Compiler warning (level 1) C4461](../../error-messages/compiler-warnings/compiler-warning-level-1-c4461.md)|'*classname*': this class has a finalizer '!*finalizer*' but no destructor '~*dtor*'| -|[Compiler warning (level 1, Error) C4462](../../error-messages/compiler-warnings/compiler-warning-level-1-c4462.md)|'*type*' : cannot determine the GUID of the type. Program may fail at runtime.| -|[Compiler warning (level 4) C4463](compiler-warning-level-4-c4463.md)|overflow; assigning '*value*' to bit-field that can only hold values from '*min_value*' to '*max_value*'| -|[Compiler warning (level 4) C4464](../../error-messages/compiler-warnings/compiler-warning-level-4-c4464.md)|relative include path contains '..'| +|[Compiler warning (level 1 and level 4) C4456](compiler-warning-level-4-c4456.md)|declaration of '*identifier*' hides previous local declaration| +|[Compiler warning (level 1 and level 4) C4457](compiler-warning-level-4-c4457.md)|declaration of '*identifier*' hides function parameter| +|[Compiler warning (level 1 and level 4) C4458](compiler-warning-level-4-c4458.md)|declaration of '*identifier*' hides class member| +|[Compiler warning (level 1 and level 4) C4459](compiler-warning-level-4-c4459.md)|declaration of '*identifier*' hides global declaration| +|[Compiler warning (level 4) C4460](compiler-warning-level-4-c4460.md)|*WinRT/managed* operator '*operator*', has parameter passed by reference. *WinRT/managed* operator '*operator*' has different semantics from C++ operator '*cpp_operator*', did you intend to pass by value?| +|[Compiler warning (level 1) C4461](compiler-warning-level-1-c4461.md)|'*classname*': this class has a finalizer '`!`*finalizer*' but no destructor '`~`*dtor*'| +|[Compiler warning (level 1, Error) C4462](compiler-warning-level-1-c4462.md)|'*type*' : cannot determine the GUID of the type. Program may fail at runtime.| +|[Compiler warning (level 4) C4463](compiler-warning-level-4-c4463.md)|overflow; assigning *value* to bit-field that can only hold values from *min_value* to *max_value*| +|[Compiler warning (level 4, off) C4464](compiler-warning-level-4-c4464.md)|relative include path contains '`..`'| |Compiler warning C4466|Could not perform coroutine heap elision| +|Compiler warning (level 1) C4465|'*identifier*': use of dependent template requires `::template`| |Compiler warning (level 1) C4467|Usage of ATL attributes is deprecated| -|Compiler warning (level 1) C4468|The [[fallthrough]] attribute must be followed by a `case` label or a `default` label| -|[Compiler warning (level 1) C4470](../../error-messages/compiler-warnings/compiler-warning-level-1-c4470.md)|floating-point control pragmas ignored under /clr| -|[Compiler warning (level 4) C4471](compiler-warning-level-4-c4471.md)|'*enumeration*': a forward declaration of an unscoped enumeration must have an underlying type (int assumed)| -|Compiler warning (level 1) C4472|'*identifier*' is a native enum: add an access specifier (private/public) to declare a 'WinRT\|managed' enum| +|Compiler warning (level 1) C4468|The `[[fallthrough]]` attribute must be followed by a `case` label or a `default` label| +|[Compiler warning (level 1) C4470](compiler-warning-level-1-c4470.md)|floating-point control pragmas ignored under `/clr`| +|[Compiler warning (level 4, off) C4471](compiler-warning-level-4-c4471.md)|'*enumeration*': a forward declaration of an unscoped enumeration must have an underlying type| +|Compiler warning (level 1) C4472|'*identifier*' is a native enum: add an access specifier (private/public) to declare a 'WinRT/managed' enum| |[Compiler warning (level 1) C4473](c4473.md)|'*function*' : not enough arguments passed for format string| |Compiler warning (level 3) C4474|'*function*' : too many arguments passed for format string| |Compiler warning (level 3) C4475|'*function*' : length modifier '*modifier*' cannot be used with type field character '*character*' in format specifier| |Compiler warning (level 3) C4476|'*function*' : unknown type field character '*character*' in format specifier| |[Compiler warning (level 1) C4477](c4477.md)|'*function*' : format string '*string*' requires an argument of type '*type*', but variadic argument *number* has type '*type*'| |Compiler warning (level 1) C4478|'*function*' : positional and non-positional placeholders cannot be mixed in the same format string| -|Compiler warning (Error) C4480|nonstandard extension used: specifying underlying type for enum '*enumeration*'| -|[Compiler warning (level 4) C4481](../../error-messages/compiler-warnings/compiler-warning-level-4-c4481.md)|nonstandard extension used: override specifier '*keyword*'| -|Compiler warning C4482|nonstandard extension used: enum '*enumeration*' used in qualified name| +|Compiler warning (Error) C4480|nonstandard extension used: specifying underlying type for `enum` '*enumeration*'| +|[Compiler warning (level 4, Error) C4481](compiler-warning-level-4-c4481.md)|nonstandard extension used: override specifier '*keyword*'| +|Compiler warning C4482|nonstandard extension used: `enum` '*enumeration*' used in qualified name| |Compiler warning (level 1, Error) C4483|syntax error: expected C++ keyword| -|[Compiler warning (Error) C4484](../../error-messages/compiler-warnings/compiler-warning-c4484.md)|'*override_function*': matches base ref class method '*base_class_function*', but is not marked 'virtual', 'new' or 'override'; 'new' (and not 'virtual') is assumed| -|[Compiler warning (Error) C4485](../../error-messages/compiler-warnings/compiler-warning-c4485.md)|'*override_function*': matches base ref class method '*base_class_function*', but is not marked 'new' or 'override'; 'new' (and 'virtual') is assumed| -|[Compiler warning (level 1) C4486](../../error-messages/compiler-warnings/compiler-warning-level-1-c4486.md)|'*function*': a private virtual method of a ref class or value class should be marked 'sealed'| -|[Compiler warning (level 4) C4487](../../error-messages/compiler-warnings/compiler-warning-level-4-c4487.md)|'*derived_class_function*': matches inherited non-virtual method '*base_class_function*' but is not explicitly marked 'new'| -|[Compiler warning (level 1) C4488](../../error-messages/compiler-warnings/compiler-warning-level-1-c4488.md)|'*function*': requires '*keyword*' keyword to implement the interface method '*interface_method*'| -|[Compiler warning (level 1) C4489](../../error-messages/compiler-warnings/compiler-warning-level-1-c4489.md)|'*specifier*': not allowed on interface method '*method*'; override specifiers are only allowed on ref class and value class methods| -|[Compiler warning (level 1) C4490](../../error-messages/compiler-warnings/compiler-warning-level-1-c4490.md)|'override': incorrect use of override specifier; '*function*' does not match a base ref class method| +|[Compiler warning (level 1, Error) C4484](compiler-warning-c4484.md)|'*override_function*': matches base `ref class` method '*base_class_function*', but is not marked '`virtual`', '`new`' or '`override`'; '`new`' (and not '`virtual`') is assumed| +|[Compiler warning (level 1, Error) C4485](compiler-warning-c4485.md)|'*override_function*': matches base `ref class` method '*base_class_function*', but is not marked '`new`' or '`override`'; '`new`' (and '`virtual`') is assumed| +|[Compiler warning (level 1) C4486](compiler-warning-level-1-c4486.md)|'*function*': a private virtual method of a `ref class` or value class should be marked '`sealed`'| +|[Compiler warning (level 4) C4487](compiler-warning-level-4-c4487.md)|'*derived_class_function*': matches inherited non-virtual method '*base_class_function*' but is not explicitly marked '`new`'| +|[Compiler warning (level 1) C4488](compiler-warning-level-1-c4488.md)|'*function*': requires '*keyword*' keyword to implement the interface method '*interface_method*'| +|[Compiler warning (level 1) C4489](compiler-warning-level-1-c4489.md)|'*specifier*': not allowed on interface method '*method*'; override specifiers are only allowed on ref class and value class methods| +|[Compiler warning (level 1) C4490](compiler-warning-level-1-c4490.md)|'*override*': incorrect use of override specifier; '*function*' does not match a base ref class method| |Compiler warning (level 1) C4491|'*name*': has an illegal IDL version format| -|Compiler warning (level 1, Error) C4492|'*function1*': matches base ref class method '*function2*', but is not marked 'override'| -|Compiler warning (level 3, Error) C4493|delete expression has no effect as the destructor of '*type*' does not have 'public' accessibility| -|Compiler warning (level 1) C4494|'*function*' : Ignoring __declspec(allocator) because the function return type is not a pointer or reference| -|Compiler warning C4495|nonstandard extension '__super' used: replace with explicit base class name| -|Compiler warning C4496|nonstandard extension 'for each' used: replace with ranged-for statement| -|Compiler warning C4497|nonstandard extension 'sealed' used: replace with 'final'| -|Compiler warning C4498|nonstandard extension used: '*extension*'| -|Compiler warning (level 4) C4499|'*function*' : an explicit specialization cannot have a storage class (ignored)"| -|[Compiler warning (level 1) C4502](../../error-messages/compiler-warnings/compiler-warning-level-1-c4502.md)|'*linkage specification*' requires use of keyword 'extern' and must precede all other specifiers| -|[Compiler warning (level 1) C4503](../../error-messages/compiler-warnings/compiler-warning-level-1-c4503.md)|'*identifier*': decorated name length exceeded, name was truncated| -|[Compiler warning (level 4) C4505](../../error-messages/compiler-warnings/compiler-warning-level-4-c4505.md)|'*function*': unreferenced local function has been removed| -|[Compiler warning (level 1) C4506](../../error-messages/compiler-warnings/compiler-warning-level-1-c4506.md)|no definition for inline function '*function*'| -|[Compiler warning (level 1) C4508](../../error-messages/compiler-warnings/compiler-warning-level-1-c4508.md)|'*function*': function should return a value; 'void' return type assumed| +|Compiler warning (level 1, Error) C4492|'*function1*': matches base `ref class` method '*function2*', but is not marked '`override`'| +|Compiler warning (level 3, Error) C4493|delete expression has no effect as the destructor of '*type*' does not have '`public`' accessibility| +|Compiler warning (level 1) C4494|'*function*' : Ignoring `__declspec(allocator)` because the function return type is not a pointer or reference| +|Compiler warning (level 4, off) C4495|nonstandard extension '`__super`' used: replace with explicit base class name| +|Compiler warning (level 4, Error, off) C4496|nonstandard extension '`for each`' used: replace with ranged-for statement| +|Compiler warning (level 4, off) C4497|nonstandard extension '`sealed`' used: replace with '`final`'| +|Compiler warning (level 4, off) C4498|nonstandard extension used: '*extension*'| +|Compiler warning (level 4) C4499|'*function*': an explicit specialization cannot have a storage class (ignored)| +|[Compiler warning (level 1) C4502](compiler-warning-level-1-c4502.md)|'linkage specification' requires use of keyword '`extern`' and must precede all other specifiers| +|[Compiler warning (level 1) C4503](compiler-warning-level-1-c4503.md)|'*identifier*': decorated name length exceeded, name was truncated| +|[Compiler warning (level 4) C4505](compiler-warning-level-4-c4505.md)|'*function*': unreferenced function with internal linkage has been removed| +|[Compiler warning (level 1) C4506](compiler-warning-level-1-c4506.md)|no definition for inline function '*function*'| +|[Compiler warning (level 1) C4508](compiler-warning-level-1-c4508.md)|'*function*': function should return a value; '`void`' return type assumed| |Compiler warning C4509|nonstandard extension used: '*function*' uses SEH and '*object*' has destructor| -|[Compiler warning (level 4) C4510](../../error-messages/compiler-warnings/compiler-warning-level-4-c4510.md)|'*class*': default constructor was implicitly defined as deleted| -|[Compiler warning (level 3) C4511](../../error-messages/compiler-warnings/compiler-warning-level-3-c4511.md)|'*class*': copy constructor was implicitly defined as deleted| -|[Compiler warning (level 4) C4512](../../error-messages/compiler-warnings/compiler-warning-level-4-c4512.md)|'*class*': assignment operator was implicitly defined as deleted| -|[Compiler warning (level 4) C4513](../../error-messages/compiler-warnings/compiler-warning-level-4-c4513.md)|'*class*': destructor was implicitly defined as deleted| -|[Compiler warning (level 4) C4514](../../error-messages/compiler-warnings/compiler-warning-level-4-c4514.md)|'*function*': unreferenced inline function has been removed| -|[Compiler warning (level 4) C4515](../../error-messages/compiler-warnings/compiler-warning-level-4-c4515.md)|'*namespace*': namespace uses itself| -|[Compiler warning (level 4) C4516](../../error-messages/compiler-warnings/compiler-warning-level-4-c4516.md)|'class::symbol': access-declarations are deprecated; member using-declarations provide a better alternative| -|[Compiler warning (level 4) C4517](../../error-messages/compiler-warnings/compiler-warning-level-4-c4517.md)|access-declarations are deprecated; member using-declarations provide a better alternative| -|[Compiler warning (level 1) C4518](../../error-messages/compiler-warnings/compiler-warning-level-1-c4518.md)|'*specifier*': storage-class or type specifier(s) unexpected here; ignored| -|Compiler warning (Error) C4519|default template arguments are only allowed on a class template| -|[Compiler warning (level 3) C4521](../../error-messages/compiler-warnings/compiler-warning-level-3-c4521.md)|'*class*': multiple copy constructors specified| -|[Compiler warning (level 3) C4522](../../error-messages/compiler-warnings/compiler-warning-level-3-c4522.md)|'*class*': multiple assignment operators specified| -|[Compiler warning (level 3) C4523](../../error-messages/compiler-warnings/compiler-warning-level-3-c4523.md)|'*class*': multiple destructors specified| -|[Compiler warning (level 1) C4526](../../error-messages/compiler-warnings/compiler-warning-level-1-c4526.md)|'*function*': static member function cannot override virtual function '*virtual function*' override ignored, virtual function will be hidden| -|[Compiler warning (level 1) C4530](../../error-messages/compiler-warnings/compiler-warning-level-1-c4530.md)|C++ exception handler used, but unwind semantics are not enabled. Specify /EHsc| +|[Compiler warning (level 4) C4510](compiler-warning-level-4-c4510.md)|'*class*': default constructor was implicitly defined as deleted| +|[Compiler warning (level 4) C4511](compiler-warning-level-3-c4511.md)|'*class*': copy constructor was implicitly defined as deleted| +|[Compiler warning (level 4) C4512](compiler-warning-level-4-c4512.md)|'*class*': assignment operator was implicitly defined as deleted| +|[Compiler warning (level 4) C4513](compiler-warning-level-4-c4513.md)|'*class*': destructor was implicitly defined as deleted| +|[Compiler warning (level 4, off) C4514](compiler-warning-level-4-c4514.md)|'*function*': unreferenced inline function has been removed| +|[Compiler warning (level 4) C4515](compiler-warning-level-4-c4515.md)|'*namespace*': namespace uses itself| +|[Compiler warning (level 4) C4516](compiler-warning-level-4-c4516.md)|'*class*::*symbol*': access-declarations are deprecated; member using-declarations provide a better alternative| +|[Compiler warning (level 4) C4517](compiler-warning-level-4-c4517.md)|access-declarations are deprecated; member using-declarations provide a better alternative| +|[Compiler warning (level 1) C4518](compiler-warning-level-1-c4518.md)|'*specifier*': storage-class or type specifier(s) unexpected here; ignored| +|Compiler warning (level1, Error, no longer emitted) C4519|default template arguments are only allowed on a class template| +|[Compiler warning (level 3) C4521](compiler-warning-level-3-c4521.md)|'*class*': multiple copy constructors specified| +|[Compiler warning (level 3) C4522](compiler-warning-level-3-c4522.md)|'*class*': multiple assignment operators specified| +|[Compiler warning (level 3) C4523](compiler-warning-level-3-c4523.md)|'*class*': multiple destructors specified| +|[Compiler warning (level 1) C4526](compiler-warning-level-1-c4526.md)|'*function*': static member function cannot override virtual function '*virtual function*'
override ignored, virtual function will be hidden| +|[Compiler warning (level 1) C4530](compiler-warning-level-1-c4530.md)|C++ exception handler used, but unwind semantics are not enabled. Specify `/EHsc`| |Compiler warning (level 1) C4531|C++ exception handling not available on Windows CE. Use Structured Exception Handling| -|[Compiler warning (level 1) C4532](../../error-messages/compiler-warnings/compiler-warning-level-1-c4532.md)|'continue': jump out of '__finally/finally' block has undefined behavior during termination handling| -|[Compiler warning (level 1) C4533](../../error-messages/compiler-warnings/compiler-warning-level-1-c4533.md)|initialization of '*variable*' is skipped by '*goto label*'| -|[Compiler warning (level 3) C4534](../../error-messages/compiler-warnings/compiler-warning-level-3-c4534.md)|'*constructor*' will not be a default constructor for 'class/struct' '*identifier*' due to the default argument| -|[Compiler warning (level 3) C4535](../../error-messages/compiler-warnings/compiler-warning-level-3-c4535.md)|calling _set_se_translator() requires /EHa| -|[Compiler warning (level 4) C4536](../../error-messages/compiler-warnings/compiler-warning-level-4-c4536.md)|'*typename*': type-name exceeds meta-data limit of '*character_limit*' characters| -|[Compiler warning (level 1) C4537](../../error-messages/compiler-warnings/compiler-warning-level-1-c4537.md)|'*object*': '.' applied to non-UDT type| -|[Compiler warning (level 3) C4538](../../error-messages/compiler-warnings/compiler-warning-level-3-c4538.md)|'*type*': const/volatile qualifiers on this type are not supported| -|[Compiler warning (level 1) C4540](../../error-messages/compiler-warnings/compiler-warning-level-1-c4540.md)|dynamic_cast used to convert to inaccessible or ambiguous base; run-time test will fail ('*type1*' to '*type2*')| -|[Compiler warning (level 1) C4541](../../error-messages/compiler-warnings/compiler-warning-level-1-c4541.md)|'*identifier*' used on polymorphic type '*type*' with /GR-; unpredictable behavior may result| +|[Compiler warning (level 1) C4532](compiler-warning-level-1-c4532.md)|'*continue*': jump out of *__finally/finally* block has undefined behavior during termination handling| +|[Compiler warning (level 1) C4533](compiler-warning-level-1-c4533.md)|initialization of '*variable*' is skipped by '`goto` *label*'| +|[Compiler warning (level 3) C4534](compiler-warning-level-3-c4534.md)|'*constructor*' will not be a default constructor for *class/struct* '*identifier*' due to the default argument| +|[Compiler warning (level 3) C4535](compiler-warning-level-3-c4535.md)|calling `_set_se_translator()` requires `/EHa`| +|[Compiler warning (level 4, off) C4536](compiler-warning-level-4-c4536.md)|'*typename*': type-name exceeds meta-data limit of '*character_limit*' characters| +|[Compiler warning (level 1) C4537](compiler-warning-level-1-c4537.md)|'*object*': '`.`' applied to non-UDT type| +|[Compiler warning (level 3) C4538](compiler-warning-level-3-c4538.md)|'*type*': `const`/`volatile` qualifiers on this type are not supported| +|[Compiler warning (level 1) C4540](compiler-warning-level-1-c4540.md)|`dynamic_cast` used to convert to inaccessible or ambiguous base; run-time test will fail ('*type1*' to '*type2*')| +|[Compiler warning (level 1) C4541](compiler-warning-level-1-c4541.md)|'*operator*' used on polymorphic type '*type*' with /GR-; unpredictable behavior may result| |Compiler warning (level 1) C4542|Skipping generation of merged injected text file, cannot write *filetype* file: '*issue*': *message*| -|[Compiler warning (level 3) C4543](../../error-messages/compiler-warnings/compiler-warning-level-3-c4543.md)|Injected text suppressed by attribute 'no\_injected_text'| -|[Compiler warning (level 1) C4544](../../error-messages/compiler-warnings/compiler-warning-level-1-c4544.md)|'*declaration*': default template argument ignored on this template declaration| -|[Compiler warning (level 1) C4545](../../error-messages/compiler-warnings/compiler-warning-level-1-c4545.md)|expression before comma evaluates to a function which is missing an argument list| -|[Compiler warning (level 1) C4546](../../error-messages/compiler-warnings/compiler-warning-level-1-c4546.md)|function call before comma missing argument list| -|[Compiler warning (level 1) C4547](../../error-messages/compiler-warnings/compiler-warning-level-1-c4547.md)|'*operator*': operator before comma has no effect; expected operator with side-effect| -|[Compiler warning (level 1) C4548](../../error-messages/compiler-warnings/compiler-warning-level-1-c4548.md)|expression before comma has no effect; expected expression with side-effect| -|[Compiler warning (level 1) C4549](../../error-messages/compiler-warnings/compiler-warning-level-1-c4549.md)|'*operator*': operator before comma has no effect; did you intend '*operator*'?| -|[Compiler warning (level 1) C4550](../../error-messages/compiler-warnings/compiler-warning-level-1-c4550.md)|expression evaluates to a function which is missing an argument list| -|[Compiler warning (level 1) C4551](../../error-messages/compiler-warnings/compiler-warning-level-1-c4551.md)|function call missing argument list| -|[Compiler warning (level 1) C4552](../../error-messages/compiler-warnings/compiler-warning-level-1-c4552.md)|'*operator*': operator has no effect; expected operator with side-effect| -|[Compiler warning (level 1) C4553](../../error-messages/compiler-warnings/compiler-warning-level-1-c4553.md)|'*operator*': operator has no effect; did you intend 'operator'?| -|[Compiler warning (level 3) C4554](../../error-messages/compiler-warnings/compiler-warning-level-3-c4554.md) C4554|'*operator*': check operator precedence for possible error; use parentheses to clarify precedence| -|[Compiler warning (level 1) C4555](../../error-messages/compiler-warnings/compiler-warning-level-1-c4555.md)|expression has no effect; expected expression with side-effect| -|[Compiler warning (level 1) C4556](../../error-messages/compiler-warnings/compiler-warning-level-1-c4556.md)|value of intrinsic immediate argument '*value*' is out of range '*lower_bound* - *upper_bound*'| -|[Compiler warning (level 3) C4557](../../error-messages/compiler-warnings/compiler-warning-level-3-c4557.md)|'__assume' contains effect '*effect*'| -|[Compiler warning (level 1) C4558](../../error-messages/compiler-warnings/compiler-warning-level-1-c4558.md)|value of operand '*value*' is out of range '*lower_bound* - *upper_bound*'| -|[Compiler warning (level 4) C4559](../../error-messages/compiler-warnings/compiler-warning-level-4-c4559.md)|'*function*': redefinition; the function gains __declspec(modifier)| -|[Compiler warning (level 1) C4561](../../error-messages/compiler-warnings/compiler-warning-level-1-c4561.md)|'__fastcall' incompatible with the '/clr' option: converting to '__stdcall'| -|Compiler warning (level 4) C4562|fully prototyped functions are required with the '/clr' option: converting '()' to '(void)'| -|[Compiler warning (level 4) C4564](../../error-messages/compiler-warnings/compiler-warning-level-4-c4564.md)|method '*method*' of 'class' '*classname*' defines unsupported default parameter '*parameter*'| -|[Compiler warning (level 4) C4565](../../error-messages/compiler-warnings/compiler-warning-level-4-c4565.md)|'*function*': redefinition; the symbol was previously declared with __declspec(modifier)| -|[Compiler warning (level 1) C4566](../../error-messages/compiler-warnings/compiler-warning-level-1-c4566.md)|character represented by universal-character-name '*char*' cannot be represented in the current code page (*number*)| +|[Compiler warning (level 3) C4543](compiler-warning-level-3-c4543.md)|Injected text suppressed by attribute '`no_injected_text`'| +|[Compiler warning (level 1) C4544](compiler-warning-level-1-c4544.md)|the default template argument for '*declaration*' is ignored on this template declaration| +|[Compiler warning (level 1, off) C4545](compiler-warning-level-1-c4545.md)|expression before comma evaluates to a function which is missing an argument list| +|[Compiler warning (level 1, off) C4546](compiler-warning-level-1-c4546.md)|function call before comma missing argument list| +|[Compiler warning (level 1, off) C4547](compiler-warning-level-1-c4547.md)|'*operator*': operator before comma has no effect; expected operator with side-effect| +|[Compiler warning (level 1, off) C4548](compiler-warning-level-1-c4548.md)|expression before comma has no effect; expected expression with side-effect| +|[Compiler warning (level 1, off) C4549](compiler-warning-level-1-c4549.md)|'*operator*': operator before comma has no effect; did you intend '*operator*'?| +|[Compiler warning (level 1) C4550](compiler-warning-level-1-c4550.md)|expression evaluates to a function which is missing an argument list| +|[Compiler warning (level 1) C4551](compiler-warning-level-1-c4551.md)|function call missing argument list| +|[Compiler warning (level 1) C4552](compiler-warning-level-1-c4552.md)|'*operator*': result of expression not used| +|[Compiler warning (level 1) C4553](compiler-warning-level-1-c4553.md)|'*operator*': result of expression not used; did you intend '*operator*'?| +|[Compiler warning (level 3) C4554](compiler-warning-level-3-c4554.md) C4554|'*operator*': check operator precedence for possible error; use parentheses to clarify precedence| +|[Compiler warning (level 1, off) C4555](compiler-warning-level-1-c4555.md)|result of expression not used| +|[Compiler warning (level 1) C4556](compiler-warning-level-1-c4556.md)|value of intrinsic immediate argument '*value*' is out of range '*lower_bound* - *upper_bound*'| +|[Compiler warning (level 3, off) C4557](compiler-warning-level-3-c4557.md)|'`__assume`' contains effect '*effect*'| +|[Compiler warning (level 1) C4558](compiler-warning-level-1-c4558.md)|value of operand '*value*' is out of range '*lower_bound* - *upper_bound*'| +|[Compiler warning (level 4) C4559](compiler-warning-level-4-c4559.md)|'*function*': redefinition; the function gains `__declspec(`*modifier*`)`| +|[Compiler warning (level 1) C4561](compiler-warning-level-1-c4561.md)|'`__fastcall`' incompatible with the '`/clr`' option: converting to '`__stdcall`'| +|Compiler warning (level 4) C4562|fully prototyped functions are required with the '`/clr`' option: converting '`()`' to '`(void)`'| +|[Compiler warning (level 4) C4564](compiler-warning-level-4-c4564.md)|method '*method*' of *class* '*classname*' defines unsupported default parameter '*parameter*'| +|[Compiler warning (level 4) C4565](compiler-warning-level-4-c4565.md)|'*function*': redefinition; the symbol was previously declared with `__declspec(`*modifier*`)`| +|[Compiler warning (level 1) C4566](compiler-warning-level-1-c4566.md)|character represented by universal-character-name '*char*' cannot be represented in the current code page (*number*)| |Compiler warning (level 1) C4568|'*function*': no members match the signature of the explicit override| |Compiler warning (level 3) C4569|'*function*': no members match the signature of the explicit override| -|[Compiler warning (level 3) C4570](../../error-messages/compiler-warnings/compiler-warning-level-3-c4570.md)|'*type*': is not explicitly declared as abstract but has abstract functions| -|[Compiler warning (level 4) C4571](../../error-messages/compiler-warnings/compiler-warning-level-4-c4571.md)|Informational: catch(...) semantics changed since Visual C++ 7.1; structured exceptions (SEH) are no longer caught| -|[Compiler warning (level 1) C4572](../../error-messages/compiler-warnings/compiler-warning-level-1-c4572.md)|[ParamArray] attribute is deprecated under /clr, use '...' instead| -|Compiler warning (level 1) C4573|the usage of '*lambda function*' requires the compiler to capture 'this' but the current default capture mode does not allow it| -|Compiler warning (level 4) C4574|'*Identifier*' is defined to be '0': did you mean to use '#if identifier'?| -|Compiler warning (level 1) C4575|'__vectorcall' incompatible with the '/clr' option: converting to '__stdcall'| +|[Compiler warning (level 3) C4570](compiler-warning-level-3-c4570.md)|'*type*': is not explicitly declared as abstract but has abstract functions| +|[Compiler warning (level 4) C4571](compiler-warning-level-4-c4571.md)|Informational: `catch(...)` semantics changed since Visual C++ 7.1; structured exceptions (SEH) are no longer caught| +|[Compiler warning (level 1) C4572](compiler-warning-level-1-c4572.md)|`[ParamArray]` attribute is deprecated under `/clr`, use '`...`' instead| +|Compiler warning (level 1, Error) C4573|the usage of '*lambda function*' requires the compiler to capture '`this`' but the current default capture mode does not allow it| +|Compiler warning (level 4, off) C4574|'*Identifier*' is defined to be '`0`': did you mean to use '`#if` *identifier*'?| +|Compiler warning (level 1) C4575|'`__vectorcall`' incompatible with the '`/clr`' option: converting to '`__stdcall`'| |Compiler warning (level 1, Error) C4576|a parenthesized type followed by an initializer list is a non-standard explicit type conversion syntax| -|[Compiler warning (level 1, Off) C4577](../../error-messages/compiler-warnings/compiler-warning-level-1-c4577.md)|'noexcept' used with no exception handling mode specified; termination on exception is not guaranteed. Specify /EHsc| -|Compiler warning (level 1, Error) C4578|'abs': conversion from '*type1*' to '*type2*', possible loss of data (Did you mean to call '*function*' or to #include \?)| -|[Compiler warning (level 3) C4580](../../error-messages/compiler-warnings/compiler-warning-level-3-c4580.md)|[attribute] is deprecated; instead specify System::Attribute or Platform::Metadata as a base class| -|[Compiler warning (level 1) C4581](../../error-messages/compiler-warnings/compiler-warning-level-1-c4581.md)|deprecated behavior: '"*string*"' replaced with '*string*' to process attribute| -|Compiler warning (level 4) C4582|'*type*': constructor is not implicitly called| -|Compiler warning (level 4) C4583|'*type*': destructor is not implicitly called| -|[Compiler warning (level 1) C4584](../../error-messages/compiler-warnings/compiler-warning-level-1-c4584.md)|'*class1*': base-class '*class2*' is already a base-class of '*class3*'| -|Compiler warning (level 1, Error) C4585|'*class*': A WinRT 'public ref class' must either be sealed or derive from an existing unsealed class| -|Compiler warning (level 1, Error) C4586|'*type*': A public type cannot be declared in a top-level namespace called 'Windows'| -|Compiler warning (level 1) C4587|'*anonymous_structure*': behavior change: constructor is no longer implicitly called| -|Compiler warning (level 1) C4588|'*anonymous_structure*': behavior change: destructor is no longer implicitly called| +|[Compiler warning (level 1, Off) C4577](compiler-warning-level-1-c4577.md)|'`noexcept`' used with no exception handling mode specified; termination on exception is not guaranteed. Specify `/EHsc`| +|Compiler warning (level 1, Error) C4578|'`abs`': conversion from '*type1*' to '*type2*', possible loss of data (Did you mean to call '*function*' or to `#include `?)| +|[Compiler warning (level 3) C4580](compiler-warning-level-3-c4580.md)|`[attribute]` is deprecated; instead specify *namespace::*Attribute as a base class| +|[Compiler warning (level 1) C4581](compiler-warning-level-1-c4581.md)|deprecated behavior: '"*string*"' replaced with '*string*' to process attribute| +|Compiler warning (level 4, off) C4582|'*type*': constructor is not implicitly called| +|Compiler warning (level 4, off) C4583|'*type*': destructor is not implicitly called| +|[Compiler warning (level 1) C4584](compiler-warning-level-1-c4584.md)|'*class1*': base-class '*class2*' is already a base-class of '*class3*'| +|Compiler warning (level 1, Error) C4585|'*class*': A WinRT '`public ref class`' must either be sealed or derive from an existing unsealed class| +|Compiler warning (level 1, Error) C4586|'*type*': A public type cannot be declared in a top-level namespace called '`Windows`'| +|Compiler warning (level 1, off) C4587|'*anonymous_structure*': behavior change: constructor is no longer implicitly called| +|Compiler warning (level 1, off) C4588|'*anonymous_structure*': behavior change: destructor is no longer implicitly called| |Compiler warning (level 4) C4589|Constructor of abstract class '*class1*' ignores initializer for virtual base class '*class2*'| -|Compiler warning (level 1) C4591|'constexpr' call-depth limit of *number* exceeded (/constexpr:depth\)| -|Compiler warning (level 3) C4592|'*function*': 'constexpr' call evaluation failed; function will be called at run-time| -|Compiler warning (level 1) C4593|'*function*': 'constexpr' call evaluation step limit of '*limit*' exceeded; use /constexpr:steps\ to increase the limit| -|Compiler warning (level 3) C4594|'*type*': destructor will not be implicitly called if an exception is thrown| -|Compiler warning (level 1) C4595|'*type*': behavior change: destructor will no longer be implicitly called if an exception is thrown| -|[Compiler warning (level 4) C4596](../../error-messages/compiler-warnings/c4596.md)|'*identifier*': illegal qualified name in member declaration| -|[Compiler warning (error) C4597](c4597.md)|undefined behavior: offsetof applied to a member of a virtual base| -|Compiler warning (level 1 and level 3) C4598|'#include "*header*"': header number *number* in the precompiled header does not match current compilation at that position| -|Compiler warning (level 3) C4599|'*flag* *path*': command line argument number *number* does not match precompiled header| +|Compiler warning (level 1, no longer emitted) C4591|'`constexpr`' call-depth limit of *number* exceeded (`/constexpr:depth`)| +|Compiler warning (level 1, Error) C4592|'*name*': symbol will be dynamically initialized (implementation limitation)| +|Compiler warning (level 1, no longer emitted) C4593|'*function*': '`constexpr`' call evaluation step limit of '*limit*' exceeded; use `/constexpr:steps` to increase the limit| +|Compiler warning (level 1) C4594|class '*name*' can never be instantiated - indirect virtual base class '*name*' is inaccessible| +|Compiler warning (level 3) C4595|'*name*': non-member operator new or delete functions may not be declared inline| +|[Compiler warning (level 4, Error, off) C4596](c4596.md)|'*identifier*': illegal qualified name in member declaration| +|[Compiler warning (error) C4597](c4597.md)|undefined behavior: *message*| +|Compiler warning (level 1 and level 3) C4598|'`#include "`*header*`"`': header number *number* in the precompiled header does not match current compilation at that position| +|Compiler warning (level 3, off) C4599|'*flag* *path*': command line argument number *number* does not match precompiled header| ## See also -[C/C++ Compiler and build tools errors and warnings](../compiler-errors-1/c-cpp-build-errors.md) \ +[C/C++ Compiler and build tools errors and warnings](../compiler-errors-1/c-cpp-build-errors.md)\ [Compiler warnings C4000 - C5999](compiler-warnings-c4000-c5999.md) diff --git a/docs/error-messages/compiler-warnings/compiler-warnings-c4600-through-c4799.md b/docs/error-messages/compiler-warnings/compiler-warnings-c4600-through-c4799.md index 3bdb97c94b3..073da826414 100644 --- a/docs/error-messages/compiler-warnings/compiler-warnings-c4600-through-c4799.md +++ b/docs/error-messages/compiler-warnings/compiler-warnings-c4600-through-c4799.md @@ -15,162 +15,162 @@ The articles in this section describe Microsoft C/C++ compiler warning messages |Warning|Message| |-------------|-------------| -|[Compiler warning (level 1) C4600](../../error-messages/compiler-warnings/compiler-warning-level-1-c4600.md)|#pragma 'macro name': expected a valid non-empty string| -|[Compiler warning (level 1) C4602](compiler-warning-level-1-c4602.md)|#pragma pop_macro: 'macro name' no previous #pragma push_macro for this identifier| +|[Compiler warning (level 1) C4600](compiler-warning-level-1-c4600.md)|`#pragma `'*macro name*': expected a valid non-empty string| +|[Compiler warning (level 1) C4602](compiler-warning-level-1-c4602.md)|`#pragma pop_macro: `'*macro name*' no previous `#pragma push_macro` for this identifier| |[Compiler warning (level 1) C4603](compiler-warning-level-1-c4603.md)|'*identifier*': macro is not defined or definition is different after precompiled header use| -|Compiler warning (level 1) C4604|'*type*': passing argument by value across native and managed boundary requires valid copy constructor. Otherwise the runtime behavior is undefined| -|Compiler warning (level 1) C4605|'/D*macro*' specified on current command line, but was not specified when precompiled header was built| -|[Compiler warning (level 1) C4606](../../error-messages/compiler-warnings/compiler-warning-level-1-c4606.md)|#pragma warning: 'warning number' ignored; Code Analysis warnings are not associated with warning levels| -|[Compiler warning (level 3) C4608](../../error-messages/compiler-warnings/compiler-warning-level-3-c4608.md)|'union_member' has already been initialized by another union member in the initializer list, 'union_member'| -|Compiler warning (level 3, Error) C4609|'*type1*' derives from default interface '*interface*' on type '*type2*'. Use a different default interface for '*type1*', or break the base/derived relationship.| -|[Compiler warning (level 4) C4610](../../error-messages/compiler-warnings/compiler-warning-level-4-c4610.md)|object 'class' can never be instantiated - user defined constructor required| -|[Compiler warning (level 4) C4611](../../error-messages/compiler-warnings/compiler-warning-level-4-c4611.md)|interaction between 'function' and C++ object destruction is non-portable| +|Compiler warning (level 1) C4604|'*type*': passing an argument of this type by value across the native/managed boundary requires the type to be move- or copy-constructible. Otherwise, the runtime behavior is undefined| +|Compiler warning (level 1, off) C4605|'`/D`*macro*' specified on current command line, but was not specified when precompiled header was built| +|[Compiler warning (level 1) C4606](compiler-warning-level-1-c4606.md)|`#pragma warning:` '*warning number*' ignored; Code Analysis warnings are not associated with warning levels| +|[Compiler warning (level 3, off) C4608](compiler-warning-level-3-c4608.md)|Initializing multiple members of union: '*member1*' and '*member2*'| +|Compiler warning (level 3, error) C4609|'*type1*' derives from default interface '*interface*' on type '*type2*'. Use a different default interface for '*type1*', or break the base/derived relationship.| +|[Compiler warning (level 4) C4610](compiler-warning-level-4-c4610.md)|*class* '*name*' can never be instantiated - user defined constructor required| +|[Compiler warning (level 4) C4611](compiler-warning-level-4-c4611.md)|interaction between '*function*' and C++ object destruction is non-portable| |[Compiler warning (level 1) C4612](compiler-warning-level-1-c4612.md)|error in include filename| |[Compiler warning (level 1) C4613](compiler-warning-level-1-c4613.md)|'*symbol*': class of segment cannot be changed| -|[Compiler warning (level 1) C4615](../../error-messages/compiler-warnings/compiler-warning-level-1-c4615.md)|#pragma warning: unknown user warning type| -|[Compiler warning (level 1) C4616](../../error-messages/compiler-warnings/compiler-warning-level-1-c4616.md)|#pragma warning: warning number 'number' not a valid compiler warning| -|[Compiler warning (level 1) C4618](../../error-messages/compiler-warnings/compiler-warning-level-1-c4618.md)|pragma parameters included an empty string; pragma ignored| -|[Compiler warning (level 3) C4619](../../error-messages/compiler-warnings/compiler-warning-level-3-c4619.md)|#pragma warning: there is no warning number 'number'| -|[Compiler warning (level 1) C4620](compiler-warning-level-1-c4620.md)|no postfix form of 'operator ++' found for type 'type', using prefix form| -|[Compiler warning (level 1) C4621](../../error-messages/compiler-warnings/compiler-warning-level-1-c4621.md)|no postfix form of 'operator --' found for type 'type', using prefix form| -|[Compiler warning (level 3) C4622](compiler-warning-level-3-c4622.md)|overwriting debug information formed during creation of the precompiled header in object file: 'file'| -|[Compiler warning (level 4) C4623](../../error-messages/compiler-warnings/compiler-warning-level-4-c4623.md)|'derived class': default constructor was implicitly defined as deleted because a base class default constructor is inaccessible or deleted| -|[Compiler warning (level 1) C4624](../../error-messages/compiler-warnings/compiler-warning-level-1-c4624.md)|'derived class': destructor was implicitly defined as deleted because a base class destructor is inaccessible or deleted| -|[Compiler warning (level 4) C4625](../../error-messages/compiler-warnings/compiler-warning-level-4-c4625.md)|'derived class': copy constructor was implicitly defined as deleted because a base class copy constructor is inaccessible or deleted| -|[Compiler warning (level 4) C4626](../../error-messages/compiler-warnings/compiler-warning-level-4-c4626.md)|'derived class': assignment operator was implicitly defined as deleted because a base class assignment operator is inaccessible or deleted| -|[Compiler warning (level 1) C4627](../../error-messages/compiler-warnings/compiler-warning-level-1-c4627.md)|'\': skipped when looking for precompiled header use| -|[Compiler warning (level 1) C4628](../../error-messages/compiler-warnings/compiler-warning-level-1-c4628.md)|digraphs not supported with -Ze. Character sequence 'digraph' not interpreted as alternate token for '%s'| -|[Compiler warning (level 4) C4629](compiler-warning-level-4-c4629.md)|digraph used, character sequence 'digraph' interpreted as token 'char' (insert a space between the two characters if this is not what you intended)| -|[Compiler warning (level 1) C4630](../../error-messages/compiler-warnings/compiler-warning-level-1-c4630.md)|'symbol': 'extern' storage-class specifier illegal on member definition| -|Compiler warning (level 2) C4631|MSXML or XPath unavailable, XML document comments will not be processed. reason| -|[Compiler warning (level 1) C4632](../../error-messages/compiler-warnings/compiler-warning-level-1-c4632.md)|XML document comment: file - access denied: reason| -|[Compiler warning (level 3) C4633](../../error-messages/compiler-warnings/compiler-warning-level-3-c4633.md)|XML document comment target: error: reason| -|[Compiler warning (level 4) C4634](compiler-warning-level-4-c4634.md)|XML document comment target: cannot be applied: reason| -|[Compiler warning (level 3) C4635](compiler-warning-level-3-c4635.md)|XML document comment target: badly-formed XML: reason| -|[Compiler warning (level 3) C4636](compiler-warning-level-3-c4636.md)|XML document comment applied to construct: tag requires non-empty 'attribute' attribute.| -|[Compiler warning (level 3 and level 4) C4637](compiler-warning-level-3-c4637.md)|XML document comment target: \ tag discarded. Reason| -|[Compiler warning (level 3) C4638](compiler-warning-level-3-c4638.md)|XML document comment target: reference to unknown symbol 'symbol'.| -|[Compiler warning (level 4) C4639](../../error-messages/compiler-warnings/compiler-warning-level-4-c4639.md)|MSXML error, XML document comments will not be processed. Reason| -|[Compiler warning (level 3) C4640](../../error-messages/compiler-warnings/compiler-warning-level-3-c4640.md)|'instance': construction of local static object is not thread-safe| -|[Compiler warning (level 3) C4641](../../error-messages/compiler-warnings/compiler-warning-level-3-c4641.md)|XML document comment has an ambiguous cross reference:| +|[Compiler warning (level 1) C4615](compiler-warning-level-1-c4615.md)|`#pragma warning`: unknown user warning type| +|[Compiler warning (level 1) C4616](compiler-warning-level-1-c4616.md)|`#pragma warning`: warning number '*number*' not a valid compiler warning| +|[Compiler warning (level 1) C4618](compiler-warning-level-1-c4618.md)|pragma parameters included an empty string; pragma ignored| +|[Compiler warning (level 3, off) C4619](compiler-warning-level-3-c4619.md)|`#pragma warning`: there is no warning number '*number*'| +|[Compiler warning (level 1) C4620](compiler-warning-level-1-c4620.md)|no postfix form of '`operator ++`' found for type '*type*', using prefix form| +|[Compiler warning (level 1) C4621](compiler-warning-level-1-c4621.md)|no postfix form of '`operator --`' found for type '*type*', using prefix form| +|[Compiler warning (level 3) C4622](compiler-warning-level-3-c4622.md)|overwriting debug information formed during creation of the precompiled header in object file: '*file*'| +|[Compiler warning (level 1 and level 4, off) C4623](compiler-warning-level-4-c4623.md)|'*derived class*': default constructor was implicitly defined as deleted| +|[Compiler warning (level 1 and level 4) C4624](compiler-warning-level-1-c4624.md)|'*derived class*': destructor was implicitly defined as deleted| +|[Compiler warning (level 1 and level 4, off) C4625](compiler-warning-level-4-c4625.md)|'*derived class*': copy constructor was implicitly defined as deleted| +|[Compiler warning (level 1 and level 4, off) C4626](compiler-warning-level-4-c4626.md)|'*derived class*': assignment operator was implicitly defined as deleted| +|[Compiler warning (level 1, no longer emitted) C4627](compiler-warning-level-1-c4627.md)|'`identifier`': skipped when looking for precompiled header use| +|[Compiler warning (level 1, off) C4628](compiler-warning-level-1-c4628.md)|digraphs not supported with `-Ze`. Character sequence '*digraph*' not interpreted as alternate token for '*token*'| +|[Compiler warning (level 4, no longer emitted) C4629](compiler-warning-level-4-c4629.md)|digraph used, character sequence '*digraph*' interpreted as token '*char*' (insert a space between the two characters if this is not what you intended)| +|[Compiler warning (level 1) C4630](compiler-warning-level-1-c4630.md)|'*symbol*': '*extern*' storage-class specifier illegal on member definition| +|Compiler warning (level 2) C4631|`MSXML` or `XPath` unavailable, XML document comments will not be processed. *reason*| +|[Compiler warning (level 1) C4632](compiler-warning-level-1-c4632.md)|XML document comment: *file* - access denied: *reason*| +|[Compiler warning (level 3 and level 4) C4633](compiler-warning-level-3-c4633.md)|XML document comment *target*: error: *reason*| +|[Compiler warning (level 4) C4634](compiler-warning-level-4-c4634.md)|XML document comment *target*: cannot be applied: *reason*| +|[Compiler warning (level 3 and level 4) C4635](compiler-warning-level-3-c4635.md)|XML document comment *target*: badly-formed XML: *reason*| +|[Compiler warning (level 3) C4636](compiler-warning-level-3-c4636.md)|XML document comment *target*: tag requires non-empty '*attribute*' attribute.| +|[Compiler warning (level 3 and level 4) C4637](compiler-warning-level-3-c4637.md)|XML document comment *target*: `` tag discarded. *Reason*| +|[Compiler warning (level 3) C4638](compiler-warning-level-3-c4638.md)|XML document comment *target*: reference to unknown symbol '*symbol*'.| +|[Compiler warning (level 2) C4639](compiler-warning-level-4-c4639.md)|`MSXML` error, XML document comments will not be processed. *Reason*| +|[Compiler warning (level 3, off) C4640](compiler-warning-level-3-c4640.md)|'*instance*': construction of local static object is not thread-safe| +|[Compiler warning (level 3) C4641](compiler-warning-level-3-c4641.md)|XML document comment has an ambiguous cross reference:| |Compiler warning (level 1) C4642|'*class*': could not import the constraints for generic parameter '*name*'| |Compiler warning (level 4, off) C4643|Forward declaring '*identifier*' in namespace std is not permitted by the C++ Standard.| |Compiler warning (level 1) C4644|usage of the macro-based `offsetof` pattern in constant expressions is non-standard; use `offsetof` defined in the C++ standard library instead| -|[Compiler warning (level 3) C4645](compiler-warning-level-3-c4645.md)|function declared with __declspec(noreturn) has a return statement| -|[Compiler warning (level 3) C4646](compiler-warning-level-3-c4646.md)|function declared with __declspec(noreturn) has non-void return type| -|Compiler warning (level 3) C4647|behavior change: __is_pod(*type*) has different value in previous versions| -|Compiler warning (level 3) C4648|standard attribute 'carries_dependency' is ignored| +|[Compiler warning (level 3) C4645](compiler-warning-level-3-c4645.md)|function declared with '`noreturn`' has a return statement| +|[Compiler warning (level 3) C4646](compiler-warning-level-3-c4646.md)|function declared with '`noreturn`' has non-void return type| +|Compiler warning (level 3, off) C4647|behavior change: `__is_pod(`*type*`)` has different value in previous versions| +|Compiler warning (level 3) C4648|standard attribute `[[`*attribute*`]]` is ignored| |Compiler warning (level 3) C4649|attributes are ignored in this context| -|[Compiler warning (level 1) C4650](../../error-messages/compiler-warnings/compiler-warning-level-1-c4650.md)|debugging information not in precompiled header; only global symbols from the header will be available| -|[Compiler warning (level 1) C4651](../../error-messages/compiler-warnings/compiler-warning-level-1-c4651.md)|'definition' specified for precompiled header but not for current compile| -|[Compiler warning (level 1) C4652](../../error-messages/compiler-warnings/compiler-warning-level-1-c4652.md)|compiler option 'option' inconsistent with precompiled header; current command-line option will override that defined in the precompiled header| -|[Compiler warning (level 2) C4653](../../error-messages/compiler-warnings/compiler-warning-level-2-c4653.md)|compiler option 'option' inconsistent with precompiled header; current command-line option ignored| -|Compiler warning (level 4) C4654|Code placed before include of precompiled header line will be ignored. Add code to precompiled header.| -|[Compiler warning (level 1) C4655](compiler-warning-level-1-c4655.md)|'symbol': variable type is new since the latest build, or is defined differently elsewhere| -|[Compiler warning (level 1) C4656](../../error-messages/compiler-warnings/compiler-warning-level-1-c4656.md)|'symbol': data type is new or has changed since the latest build, or is defined differently elsewhere| +|[Compiler warning (level 1) C4650](compiler-warning-level-1-c4650.md)|debugging information not in precompiled header; only global symbols from the header will be available| +|[Compiler warning (level 1) C4651](compiler-warning-level-1-c4651.md)|'`/D`*definition*' specified for precompiled header but not for current compile| +|[Compiler warning (level 1) C4652](compiler-warning-level-1-c4652.md)|compiler option '*option*' inconsistent with precompiled header; current command-line option will override that defined in the precompiled header| +|[Compiler warning (level 1) C4653](compiler-warning-level-2-c4653.md)|compiler option '*option*' inconsistent with precompiled header; current command-line option ignored| +|Compiler warning (level 4, off) C4654|Code placed before include of precompiled header line will be ignored. Add code to precompiled header.| +|[Compiler warning (level 1) C4655](compiler-warning-level-1-c4655.md)|'*symbol*': variable type is new since the latest build, or is defined differently elsewhere| +|[Compiler warning (level 1) C4656](compiler-warning-level-1-c4656.md)|'*symbol*': data type is new or has changed since the latest build, or is defined differently elsewhere| |[Compiler warning (level 1) C4657](compiler-warning-level-1-c4657.md)|expression involves a data type that is new since the latest build| -|Compiler warning (level 1) C4658|'function': function prototype is new since the latest build, or is declared differently elsewhere| -|[Compiler warning (level 1) C4659](../../error-messages/compiler-warnings/compiler-warning-level-1-c4659.md)|#pragma 'pragma': use of reserved segment 'segment' has undefined behavior, use #pragma comment(linker, ...)| -|[Compiler warning (level 1) C4661](../../error-messages/compiler-warnings/compiler-warning-level-1-c4661.md)|'identifier': no suitable definition provided for explicit template instantiation request| -|[Compiler warning (level 1) C4662](compiler-warning-level-1-c4662.md)|explicit instantiation; template-class 'identifier1' has no definition from which to specialize 'identifier2'| -|[Compiler warning (level 1) C4667](../../error-messages/compiler-warnings/compiler-warning-level-1-c4667.md)|'function': no function template defined that matches forced instantiation| -|[Compiler warning (level 4) C4668](../../error-messages/compiler-warnings/compiler-warning-level-4-c4668.md)|'symbol' is not defined as a preprocessor macro, replacing with '0' for 'directive'| -|[Compiler warning (level 1) C4669](../../error-messages/compiler-warnings/compiler-warning-level-1-c4669.md)|'cast': unsafe conversion: 'class' is a managed type object| -|[Compiler warning (level 4) C4670](compiler-warning-level-4-c4670.md)|'identifier': this base class is inaccessible| -|Compiler warning (level 4) C4671|'identifier': the copy constructor is inaccessible| -|[Compiler warning (level 4) C4672](compiler-warning-level-4-c4672.md)|'identifier1': ambiguous. First seen as 'identifier2'| -|[Compiler warning (level 4) C4673](../../error-messages/compiler-warnings/compiler-warning-level-4-c4673.md)|throwing 'identifier' the following types will not be considered at the catch site| -|[Compiler warning (level 1) C4674](compiler-warning-level-1-c4674.md)|'method' should be declared 'static' and have exactly one parameter| -|Compiler warning (level 4) C4676|'%s': the destructor is inaccessible| -|[Compiler warning (level 1) C4677](../../error-messages/compiler-warnings/compiler-warning-level-1-c4677.md)|'function': signature of non-private member contains assembly private type 'private_type'| -|[Compiler warning (level 1) C4678](compiler-warning-level-1-c4678.md)|base class 'base_type' is less accessible than 'derived_type'| -|[Compiler warning (level 1) C4679](../../error-messages/compiler-warnings/compiler-warning-level-1-c4679.md)|'member': could not import member| -|[Compiler warning (level 4) C4680](../../error-messages/compiler-warnings/compiler-warning-level-4-c4680.md)|'class': coclass does not specify a default interface| -|[Compiler warning (level 4) C4681](compiler-warning-level-4-c4681.md)|'class': coclass does not specify a default interface that is an event source| -|[Compiler warning (level 4) C4682](compiler-warning-level-4-c4682.md)|'parameter': no directional parameter attribute specified, defaulting to [in]| -|[Compiler warning (level 1) C4683](../../error-messages/compiler-warnings/compiler-warning-level-1-c4683.md)|'function': event source has an 'out'-parameter; exercise caution when hooking multiple event handlers| -|[Compiler warning (level 1) C4684](../../error-messages/compiler-warnings/compiler-warning-level-1-c4684.md)|'attribute': WARNING!! attribute may cause invalid code generation: use with caution| -|[Compiler warning (level 1) C4685](compiler-warning-level-1-c4685.md)|expecting '> >' found '>>' when parsing template parameters| -|[Compiler warning (level 3) C4686](../../error-messages/compiler-warnings/compiler-warning-level-3-c4686.md)|'user-defined type': possible change in behavior, change in UDT return calling convention| -|[Compiler warning (Error) C4687](../../error-messages/compiler-warnings/compiler-warning-c4687.md)|'class': a sealed abstract class cannot implement an interface 'interface'| -|[Compiler warning (level 1) C4688](../../error-messages/compiler-warnings/compiler-warning-level-1-c4688.md)|'constraint': constraint list contains assembly private type 'type'| -|Compiler warning (level 1) C4689|'%c': unsupported character in #pragma detect_mismatch; #pragma ignored| -|[Compiler warning (level 4) C4690](../../error-messages/compiler-warnings/compiler-warning-level-4-c4690.md)|[ emitidl( pop ) ]: more pops than pushes| -|[Compiler warning (level 1) C4691](../../error-messages/compiler-warnings/compiler-warning-level-1-c4691.md)|'type': type referenced was expected in unreferenced assembly 'file', type defined in current translation unit used instead| -|[Compiler warning (level 1) C4692](../../error-messages/compiler-warnings/compiler-warning-level-1-c4692.md)|'function': signature of non-private member contains assembly private native type 'native_type'| -|[Compiler warning (level 1, Error) C4693](../../error-messages/compiler-warnings/compiler-warning-c4693.md)|'class': a sealed abstract class cannot have any instance members 'instance member'| -|[Compiler warning (level 1, Error) C4694](../../error-messages/compiler-warnings/compiler-warning-c4694.md)|'class': a sealed abstract class cannot have a base-class 'base_class'| -|Compiler warning (level 1) C4695|#pragma execution_character_set: 'character set' is not a supported argument: currently only 'UTF-8' is supported| -|Compiler warning (level 1) C4696|/ZBvalue1 option out of range; assuming 'value2'| -| [Compiler warning (level 3) C4698](../../error-messages/compiler-warnings/c4698.md) | '*feature*' is for evaluation purposes only and is subject to change or removal in future updates. | -|[Compiler warning (level 1 and level 4) C4700](../../error-messages/compiler-warnings/compiler-warning-level-1-and-level-4-c4700.md)|uninitialized local variable 'name' used| -|[Compiler warning (level 4) C4701](../../error-messages/compiler-warnings/compiler-warning-level-4-c4701.md)|potentially uninitialized local variable 'name' used| -|[Compiler warning (level 4) C4702](../../error-messages/compiler-warnings/compiler-warning-level-4-c4702.md)|unreachable code| -|[Compiler warning (level 4) C4703](../../error-messages/compiler-warnings/compiler-warning-level-4-c4703.md)|potentially uninitialized local pointer variable '%s' used| -|[Compiler warning (level 4) C4706](../../error-messages/compiler-warnings/compiler-warning-level-4-c4706.md)|assignment within conditional expression| -|[Compiler warning (level 4) C4709](../../error-messages/compiler-warnings/compiler-warning-level-4-c4709.md)|comma operator within array index expression| -|[Compiler warning (level 4) C4710](../../error-messages/compiler-warnings/compiler-warning-level-4-c4710.md)|'function': function not inlined| -|[Compiler warning (level 1) C4711](../../error-messages/compiler-warnings/compiler-warning-level-1-c4711.md)|function 'function' selected for automatic inline expansion| -|[Compiler warning (level 4) C4714](../../error-messages/compiler-warnings/compiler-warning-level-4-c4714.md)|function 'function' marked as __forceinline not inlined| -|[Compiler warning (level 1) C4715](../../error-messages/compiler-warnings/compiler-warning-level-1-c4715.md)|'function': not all control paths return a value| -|[Compiler warning (level 1, Error) C4716](../../error-messages/compiler-warnings/compiler-warning-level-1-c4716.md)|'function': must return a value| -|[Compiler warning (level 1) C4717](../../error-messages/compiler-warnings/compiler-warning-level-1-c4717.md)|'function': recursive on all control paths, function will cause runtime stack overflow| +|Compiler warning (level 1) C4658|'*function*': function prototype is new since the latest build, or is declared differently elsewhere| +|[Compiler warning (level 1) C4659](compiler-warning-level-1-c4659.md)|`#pragma `'*pragma*': use of reserved segment '*segment*' has undefined behavior, use `#pragma comment(linker, ...)`| +|[Compiler warning (level 1) C4661](compiler-warning-level-1-c4661.md)|'*identifier*': no suitable definition provided for explicit template instantiation request| +|[Compiler warning (level 1) C4662](compiler-warning-level-1-c4662.md)|explicit instantiation; template-class '*identifier1*' has no definition from which to specialize '*identifier2*'| +|[Compiler warning (level 1) C4667](compiler-warning-level-1-c4667.md)|'*function*': cannot find a function template that matches the explicit instantiation| +|[Compiler warning (level 4, off) C4668](compiler-warning-level-4-c4668.md)|'*symbol*' is not defined as a preprocessor macro, replacing with '`0`' for '*directive*'| +|[Compiler warning (level 1) C4669](compiler-warning-level-1-c4669.md)|'*cast*': unsafe conversion: '*class*' is a *managed/WinRT* type object| +|[Compiler warning (level 4) C4670](compiler-warning-level-4-c4670.md)|'*identifier*': this base class is inaccessible| +|Compiler warning (level 4) C4671|'*identifier*': the copy constructor is inaccessible| +|[Compiler warning (level 4) C4672](compiler-warning-level-4-c4672.md)|'*identifier1*': ambiguous. First seen as '*identifier2*'| +|[Compiler warning (level 4) C4673](compiler-warning-level-4-c4673.md)|throwing '*identifier*' the following types will not be considered at the catch site| +|[Compiler warning (level 1) C4674](compiler-warning-level-1-c4674.md)|'*method*' should be declared '`static`' and have exactly one parameter| +|Compiler warning (level 4) C4676|'*class*': the destructor is inaccessible| +|[Compiler warning (level 1) C4677](compiler-warning-level-1-c4677.md)|'*function*': signature of non-private member contains assembly private type '*private_type*'| +|[Compiler warning (level 1) C4678](compiler-warning-level-1-c4678.md)|base class '*base_type*' is less accessible than '*derived_type*'| +|[Compiler warning (level 1 and level 4) C4679](compiler-warning-level-1-c4679.md)|'*member*': could not import item or its associated custom attribute| +|[Compiler warning (level 4) C4680](compiler-warning-level-4-c4680.md)|'*class*': `coclass` does not specify a default interface| +|[Compiler warning (level 4) C4681](compiler-warning-level-4-c4681.md)|'*class*': `coclass` does not specify a default interface that is an event source| +|[Compiler warning (level 4, off) C4682](compiler-warning-level-4-c4682.md)|'*parameter*': no directional parameter attribute specified, defaulting to `[in]`| +|[Compiler warning (level 1) C4683](compiler-warning-level-1-c4683.md)|'*function*': event source has an 'out'-parameter; exercise caution when hooking multiple event handlers| +|[Compiler warning (level 1) C4684](compiler-warning-level-1-c4684.md)|'*attribute*': WARNING!! attribute may cause invalid code generation: use with caution| +|[Compiler warning (level 1, no longer emitted) C4685](compiler-warning-level-1-c4685.md)|expecting '`> >`' found '`>>`' when parsing template parameters| +|[Compiler warning (level 3, off) C4686](compiler-warning-level-3-c4686.md)|'*user-defined type*': possible change in behavior, change in UDT return calling convention| +|[Compiler warning (level 1, error) C4687](compiler-warning-c4687.md)|'*class*': a sealed abstract class cannot implement an interface '*interface*'| +|[Compiler warning (level 1) C4688](compiler-warning-level-1-c4688.md)|'*constraint*': constraint list contains assembly private type '*type*'| +|Compiler warning (level 1) C4689|'*character*': unsupported character in `#pragma detect_mismatch`; `#pragma` ignored| +|[Compiler warning (level 4) C4690](compiler-warning-level-4-c4690.md)|`[ emitidl( pop ) ]`: more pops than pushes| +|[Compiler warning (level 1) C4691](compiler-warning-level-1-c4691.md)|'*type*': type referenced was expected in unreferenced *assembly* '*file*', type defined in current translation unit used instead| +|[Compiler warning (level 1, off) C4692](compiler-warning-level-1-c4692.md)|'*function*': signature of non-private member contains assembly private native type '*native_type*'| +|[Compiler warning (level 1, error) C4693](compiler-warning-c4693.md)|'*class*': a sealed abstract class cannot have any instance members '*instance member*'| +|[Compiler warning (level 1, error) C4694](compiler-warning-c4694.md)|'*class*': a sealed abstract class cannot have a base-class '*base_class*'| +|Compiler warning (level 1) C4695|`#pragma execution_character_set`: '*character set*' is not a supported argument: currently only '`UTF-8`' is supported| +|Compiler warning (level 1) C4696|`/ZBvalue1` option out of range; assuming 'value2'| +| [Compiler warning (level 3) C4698](c4698.md) | '*feature*' is for evaluation purposes only and is subject to change or removal in future updates. | +|[Compiler warning (level 1 and level 4) C4700](compiler-warning-level-1-and-level-4-c4700.md)|uninitialized local variable 'name' used| +|[Compiler warning (level 4) C4701](compiler-warning-level-4-c4701.md)|potentially uninitialized local variable 'name' used| +|[Compiler warning (level 4) C4702](compiler-warning-level-4-c4702.md)|unreachable code| +|[Compiler warning (level 4) C4703](compiler-warning-level-4-c4703.md)|potentially uninitialized local pointer variable '*identifier*' used| +|[Compiler warning (level 4) C4706](compiler-warning-level-4-c4706.md)|assignment used as a condition| +|[Compiler warning (level 4) C4709](compiler-warning-level-4-c4709.md)|comma operator within array index expression| +|[Compiler warning (level 4, off) C4710](compiler-warning-level-4-c4710.md)|'*function*': function not inlined| +|[Compiler warning (level 1) C4711](compiler-warning-level-1-c4711.md)|function 'function' selected for automatic inline expansion| +|[Compiler warning (level 4) C4714](compiler-warning-level-4-c4714.md)|function '*function*' marked as `__forceinline` not inlined| +|[Compiler warning (level 1) C4715](compiler-warning-level-1-c4715.md)|'function': not all control paths return a value| +|[Compiler warning (level 1, error) C4716](compiler-warning-level-1-c4716.md)|'function': must return a value| +|[Compiler warning (level 1) C4717](compiler-warning-level-1-c4717.md)|'function': recursive on all control paths, function will cause runtime stack overflow| |[Compiler warning (level 4) C4718](compiler-warning-level-4-c4718.md)|'function call': recursive call has no side effects, deleting| |Compiler warning (level 1) C4719|Double constant found when Qfast specified - use 'f' as a suffix to indicate single precision| |Compiler warning (level 2) C4720|in-line assembler reports: 'message'| |Compiler warning (level 1) C4721|'function': not available as an intrinsic| |[Compiler warning (level 1) C4722](compiler-warning-level-1-c4722.md)|'function': destructor never returns, potential memory leak| -|[Compiler warning (level 3) C4723](../../error-messages/compiler-warnings/compiler-warning-level-3-c4723.md)|potential divide by 0| +|[Compiler warning (level 3) C4723](compiler-warning-level-3-c4723.md)|potential divide by 0| |[Compiler warning (level 3) C4724](compiler-warning-level-3-c4724.md)|potential mod by 0| |Compiler warning (level 3) C4725|instruction may be inaccurate on some Pentiums| -|Compiler warning C4726|ARM arch4/4T supports only ' or ' with immediate value| -|[Compiler warning (level 1) C4727](../../error-messages/compiler-warnings/compiler-warning-level-1-c4727.md)|PCH named pch_file with same timestamp found in obj_file_1 and obj_file_2. Using first PCH.| -|Compiler warning (level 1) C4728|/Yl- option ignored because PCH reference is required| +|Compiler warning C4726|ARM arch4/4T supports only '`` or ``' with immediate value| +|[Compiler warning (level 1) C4727](compiler-warning-level-1-c4727.md)|PCH named pch_file with same timestamp found in obj_file_1 and obj_file_2. Using first PCH.| +|Compiler warning (level 1) C4728|`/Yl-` option ignored because PCH reference is required| |Compiler warning (level 4) C4729|function too big for flow graph based warnings| -|[Compiler warning (Level 1) C4730](../../error-messages/compiler-warnings/compiler-warning-level-1-c4730.md)|'main': mixing _m64 and floating point expressions may result in incorrect code| -|[Compiler warning (Level 1) C4731](../../error-messages/compiler-warnings/compiler-warning-level-1-c4731.md)|'pointer': frame pointer register 'register' modified by inline assembly code| -|Compiler warning (level 1) C4732|intrinsic '%s' is not supported in this architecture| -|[Compiler warning (Level 1) C4733](../../error-messages/compiler-warnings/compiler-warning-level-1-c4733.md)|Inline asm assigning to 'FS:0': handler not registered as safe handler| +|[Compiler warning (Level 1) C4730](compiler-warning-level-1-c4730.md)|'main': mixing `_m64` and floating point expressions may result in incorrect code| +|[Compiler warning (Level 1) C4731](compiler-warning-level-1-c4731.md)|'pointer': frame pointer register 'register' modified by inline assembly code| +|Compiler warning (level 1) C4732|intrinsic '*identifier*' is not supported in this architecture| +|[Compiler warning (Level 1) C4733](compiler-warning-level-1-c4733.md)|Inline asm assigning to '`FS:0`': handler not registered as safe handler| |Compiler warning C4734|More than 64k line numbers in a COFF debug info section; stop emitting COFF debug line numbers for module 'module'| |Compiler warning C4735|`align_function` attribute argument '*argument*' is not a power of two and is not positive. Ignoring attribute| |Compiler warning C4736|`align_function` attribute ignored because `/Gy` was not specified| -|[Compiler warning (Level 3) C4738](../../error-messages/compiler-warnings/compiler-warning-level-3-c4738.md)|storing 32-bit float result in memory, possible loss of performance| +|[Compiler warning (Level 3) C4738](compiler-warning-level-3-c4738.md)|storing 32-bit float result in memory, possible loss of performance| |[Compiler warning (level 1) C4739](compiler-warning-level-1-c4739.md)|reference to variable 'var' exceeds its storage space| -|[Compiler warning (Level 4) C4740](../../error-messages/compiler-warnings/compiler-warning-level-4-c4740.md)|flow in or out of inline asm code suppresses global optimization| -|[Compiler warning (Level 1) C4742](../../error-messages/compiler-warnings/compiler-warning-level-1-c4742.md)|'var' has different alignment in 'file1' and 'file2': number and number| -|[Compiler warning (Level 1) C4743](../../error-messages/compiler-warnings/compiler-warning-level-1-c4743.md)|'type' has different size in 'file1' and 'file2': number and number bytes| -|[Compiler warning (Level 1) C4744](../../error-messages/compiler-warnings/compiler-warning-level-1-c4744.md)|'var' has different type in 'file1' and 'file2': 'type1' and 'type2'| +|[Compiler warning (Level 4) C4740](compiler-warning-level-4-c4740.md)|flow in or out of inline asm code suppresses global optimization| +|[Compiler warning (Level 1) C4742](compiler-warning-level-1-c4742.md)|'var' has different alignment in 'file1' and 'file2': number and number| +|[Compiler warning (Level 1) C4743](compiler-warning-level-1-c4743.md)|'type' has different size in 'file1' and 'file2': number and number bytes| +|[Compiler warning (Level 1) C4744](compiler-warning-level-1-c4744.md)|'var' has different type in 'file1' and 'file2': 'type1' and 'type2'| |Compiler warning C4745|volatile access of 'name' cannot be honored due to its size| -|[Compiler warning C4746](../../error-messages/compiler-warnings/compiler-warning-c4746.md)|volatile access of '*expression*' is subject to /volatile:\ setting; consider using __iso_volatile_load/store intrinsic functions| -|[Compiler warning (level 1) C4747](../../error-messages/compiler-warnings/compiler-warning-level-1-c4747.md)|Calling managed 'entrypoint': Managed code may not be run under loader lock, including the DLL entrypoint and calls reached from the DLL entrypoint| -|Compiler warning (level 4) C4749|conditionally supported: offsetof applied to non-standard-layout type '*type*'| -|[Compiler warning (level 1) C4750](compiler-warning-level-1-c4750.md)|'identifier': function with _alloca() inlined into a loop| -|Compiler warning (level 4) C4751|/arch:AVX does not apply to Intel(R) Streaming SIMD Extensions that are within inline ASM| -|Compiler warning (level 4) C4752|found Intel(R) Advanced Vector Extensions; consider using /arch:AVX| +|[Compiler warning C4746](compiler-warning-c4746.md)|volatile access of '*expression*' is subject to `/volatile:` setting; consider using `__iso_volatile_load/store intrinsic functions`| +|[Compiler warning (level 1) C4747](compiler-warning-level-1-c4747.md)|Calling managed 'entrypoint': Managed code may not be run under loader lock, including the DLL entrypoint and calls reached from the DLL entrypoint| +|Compiler warning (level 4, off) C4749|conditionally supported: *message*| +|[Compiler warning (level 1) C4750](compiler-warning-level-1-c4750.md)|'identifier': function with `_alloca()` inlined into a loop| +|Compiler warning (level 4) C4751|`/arch:AVX` does not apply to Intel(R) Streaming SIMD Extensions that are within inline ASM| +|Compiler warning (level 4) C4752|found Intel(R) Advanced Vector Extensions; consider using `/arch:AVX`| |Compiler warning C4753|Cannot find bounds for pointer; MPX intrinsic function ignored| |[Compiler warning (level 4) C4754](compiler-warning-level-4-c4754.md)|Conversion rules for arithmetic operations in the comparison at %s(%d) mean that one branch cannot be executed. Cast '%s' to '%s' (or similar type of %d bytes).| |Compiler warning C4755|Conversion rules for arithmetic operations in the comparison at %s(%d) mean that one branch cannot be executed in an inlined function. Cast '%s' to '%s' (or similar type of %d bytes).| -|[Compiler warning (level 2) C4756](../../error-messages/compiler-warnings/compiler-warning-level-2-c4756.md)|overflow in constant arithmetic| +|[Compiler warning (level 2) C4756](compiler-warning-level-2-c4756.md)|overflow in constant arithmetic| |Compiler warning (level 4) C4757|subscript is a large unsigned value, did you intend a negative constant?| |Compiler warning C4761|integral size mismatch in argument; conversion supplied| |[Compiler warning (level 4) C4764](compiler-warning-level-4-c4764.md)|Can not align catch objects to greater than 16 bytes| -|Compiler warning (level 4) C4767|section name '%s' is longer than 8 characters and will be truncated by the linker| -|[Compiler warning (level 3) C4768](c4768.md)|__declspec attributes before linkage specification are ignored| +|Compiler warning (level 4, off) C4767|section name '%s' is longer than 8 characters and will be truncated by the linker| +|[Compiler warning (level 3, off) C4768](c4768.md)|`__declspec` attributes before linkage specification are ignored| | [Compiler warning (level 4) C4770](./c4770.md) | partially validated enum '*name*' used as index | |Compiler warning C4771|Bounds must be created using a simple pointer; MPX intrinsic function ignored| -|[Compiler warning (level 1, Error) C4772](../../error-messages/compiler-warnings/compiler-warning-level-1-c4772.md)|#import referenced a type from a missing type library; 'missing_type' used as a placeholder| -|Compiler warning (level 4) C4774|'*string*' : format string expected in argument *number* is not a string literal| +|[Compiler warning (level 1, error) C4772](compiler-warning-level-1-c4772.md)|`#import` referenced a type from a missing type library; '*missing_type*' used as a placeholder| +|Compiler warning (level 4, off) C4774|'*string*' : format string expected in argument *number* is not a string literal| |Compiler warning (level 3) C4775|nonstandard extension used in format string '*string*' of function '*function*'| -|Compiler warning (level 1) C4776|'%*character*' is not allowed in the format string of function '*function*'| -|Compiler warning (level 4) C4777|'*function*' : format string '*string*' requires an argument of type '*type1*', but variadic argument *number* has type '*type2*'| +|Compiler warning (level 1) C4776|'`%`*character*' is not allowed in the format string of function '*function*'| +|Compiler warning (level 4, off) C4777|'*function*' : format string '*string*' requires an argument of type '*type1*', but variadic argument *number* has type '*type2*'| |Compiler warning (level 3) C4778|'*function*' : unterminated format string '*string*'| -|[Compiler warning (Level 1) C4788](../../error-messages/compiler-warnings/compiler-warning-level-1-c4788.md)|'identifier': identifier was truncated to 'number' characters| -|[Compiler warning (Level 1) C4789](../../error-messages/compiler-warnings/compiler-warning-level-1-c4789.md)|buffer 'identifier' of size N bytes will be overrun; M bytes will be written starting at offset L| -|Compiler warning (level 2) C4792|function '%s' declared using sysimport and referenced from native code; import library required to link| -|[Compiler warning (level 1 and 3) C4793](../../error-messages/compiler-warnings/compiler-warning-level-1-and-3-c4793.md)|'function': function compiled as native: 'reason'| +|[Compiler warning (Level 1) C4788](compiler-warning-level-1-c4788.md)|'identifier': identifier was truncated to 'number' characters| +|[Compiler warning (Level 1) C4789](compiler-warning-level-1-c4789.md)|buffer 'identifier' of size N bytes will be overrun; M bytes will be written starting at offset L| +|Compiler warning (level 2) C4792|function '%s' declared using `sysimport` and referenced from native code; import library required to link| +|[Compiler warning (level 1 and level 3) C4793](compiler-warning-level-1-and-3-c4793.md)|'*function*': function compiled as native:
*reason*| |[Compiler warning (level 1) C4794](compiler-warning-level-1-c4794.md)|segment of thread local storage variable '%s' changed from '%s' to '%s'| |Compiler warning C4798|native code generated for p-code function 'name' with exception handler or unwind semantics| -|[Compiler warning (level 1) C4799](../../error-messages/compiler-warnings/compiler-warning-level-1-c4799.md)|function 'function' has no EMMS instruction| +|[Compiler warning (level 1) C4799](compiler-warning-level-1-c4799.md)|function '*function*' has no EMMS instruction| ## See also diff --git a/docs/error-messages/compiler-warnings/compiler-warnings-c4800-through-c4999.md b/docs/error-messages/compiler-warnings/compiler-warnings-c4800-through-c4999.md index b33c69c14f3..604fdbc580c 100644 --- a/docs/error-messages/compiler-warnings/compiler-warnings-c4800-through-c4999.md +++ b/docs/error-messages/compiler-warnings/compiler-warnings-c4800-through-c4999.md @@ -2,8 +2,8 @@ title: "Microsoft C/C++ compiler (MSVC) warnings C4800 through C4999" description: "Table of Microsoft C/C++ compiler (MSVC) warnings C4800 through C4999." ms.date: 04/17/2024 -f1_keywords: ["C4801", "C4808", "C4809", "C4815", "C4827", "C4828", "C4837", "C4842", "C4844", "C4845", "C4846", "C4847", "C4848", "C4849", "C4854", "C4855", "C4856", "C4857", "C4858", "C4859", "C4860", "C4861", "C4869", "C4872", "C4880", "C4881", "C4882", "C4883", "C4907", "C4916", "C4921", "C4934", "C4954", "C4955", "C4963", "C4966", "C4970", "C4971", "C4973", "C4974", "C4975", "C4976", "C4981", "C4983", "C4987", "C4988", "C4989", "C4990", "C4991", "C4992", "C4998"] -helpviewer_keywords: ["C4801", "C4808", "C4809", "C4815", "C4827", "C4828", "C4837", "C4842", "C4844", "C4845", "C4846", "C4847", "C4848", "C4849", "C4854", "C4855", "C4856", "C4857", "C4858", "C4859", "C4860", "C4861", "C4869", "C4872", "C4880", "C4881", "C4882", "C4883", "C4907", "C4916", "C4921", "C4934", "C4954", "C4955", "C4963", "C4966", "C4970", "C4971", "C4973", "C4974", "C4975", "C4976", "C4981", "C4983", "C4987", "C4988", "C4989", "C4990", "C4991", "C4992", "C4998"] +f1_keywords: ["C4801", "C4808", "C4809", "C4815", "C4826", "C4827", "C4828", "C4837", "C4842", "C4844", "C4845", "C4846", "C4847", "C4848", "C4849", "C4854", "C4855", "C4856", "C4857", "C4858", "C4859", "C4860", "C4861", "C4869", "C4872", "C4880", "C4881", "C4882", "C4883", "C4907", "C4916", "C4921", "C4934", "C4954", "C4955", "C4963", "C4966", "C4970", "C4971", "C4973", "C4974", "C4975", "C4976", "C4981", "C4983", "C4987", "C4988", "C4989", "C4990", "C4991", "C4992", "C4998"] +helpviewer_keywords: ["C4801", "C4808", "C4809", "C4815", "C4826", "C4827", "C4828", "C4837", "C4842", "C4844", "C4845", "C4846", "C4847", "C4848", "C4849", "C4854", "C4855", "C4856", "C4857", "C4858", "C4859", "C4860", "C4861", "C4869", "C4872", "C4880", "C4881", "C4882", "C4883", "C4907", "C4916", "C4921", "C4934", "C4954", "C4955", "C4963", "C4966", "C4970", "C4971", "C4973", "C4974", "C4975", "C4976", "C4981", "C4983", "C4987", "C4988", "C4989", "C4990", "C4991", "C4992", "C4998"] --- # Microsoft C/C++ compiler warnings C4800 through C4999 @@ -24,124 +24,124 @@ The articles in this section describe Microsoft C/C++ compiler warning messages | [Compiler warning (level 1) C4807](compiler-warning-level-1-c4807.md) | '*operation*': unsafe mix of type '*type1*' and signed bit field of type '*type2*' | | Compiler warning (level 1) C4808 | `case` '*value*' is not a valid value for `switch` condition of type '`bool`' | | Compiler warning (level 1) C4809 | `switch` statement has redundant '`default`' label; all possible '`case`' labels are given | -| [Compiler warning (level 1) C4810](compiler-warning-level-1-c4810.md) | value of `pragma pack(show)` == n | +| [Compiler warning (level 1) C4810](compiler-warning-level-1-c4810.md) | value of `pragma pack(show)` == *number* | | [Compiler warning (level 1) C4811](compiler-warning-level-1-c4811.md) | value of `pragma conform(forScope, show)` == *value* | | [Compiler warning (level 1) C4812](compiler-warning-level-1-c4812.md) | obsolete declaration style: please use '*new_syntax*' instead | | [Compiler warning (level 1) C4813](compiler-warning-level-1-c4813.md) | '*function*': a friend function of a local class must have been previously declared | | Compiler warning (level 4) C4815 | '*object name*': zero-sized array in stack object will have no elements (unless the object is an aggregate that has been aggregate initialized) | | [Compiler warning (level 4) C4816](compiler-warning-level-4-c4816.md) | '*param*': parameter has a zero-sized array which will be truncated (unless the object is passed by reference) | -| [Compiler warning (level 1) C4817](compiler-warning-level-1-c4817.md) | '*member*': illegal use of '.' to access this member; compiler replaced with '->' | -| [Compiler warning (level 1) C4819](compiler-warning-level-1-c4819.md) | The file contains a character that cannot be represented in the current code page (number). Save the file in Unicode format to prevent data loss | -| [Compiler warning (level 4, off) C4820](compiler-warning-level-4-c4820.md) | '*bytes*' bytes padding added after construct '*member_name*' | +| [Compiler warning (level 1) C4817](compiler-warning-level-1-c4817.md) | '*member*': illegal use of '`.`' to access this member; compiler replaced with '`->`' | +| [Compiler warning (level 1) C4819](compiler-warning-level-1-c4819.md) | The file contains a character that cannot be represented in the current code page (*number*). Save the file in Unicode format to prevent data loss | +| [Compiler warning (level 4, off) C4820](compiler-warning-level-4-c4820.md) |'*type*': '*bytes*' bytes padding added after *class* '*member_name*'| | [Compiler warning (level 1) C4821](compiler-warning-level-1-c4821.md) | Unable to determine Unicode encoding type, please save the file with signature (BOM) | -| [Compiler warning (level 1, off) C4822](compiler-warning-level-1-c4822.md) | 'member function': local class member function does not have a body | +| [Compiler warning (level 4, off) C4822](compiler-warning-level-1-c4822.md) | '*member function*': local class member function does not have a body | | [Compiler warning (level 3) C4823](compiler-warning-level-3-c4823.md) | '*function*': uses pinning pointers but unwind semantics are not enabled. Consider using `/EHa` | | Compiler warning (level 2, off) C4826 | Conversion from '*type1*' to '*type2*' is sign-extended. This may cause unexpected runtime behavior. | | Compiler warning (level 3) C4827 | A public '`ToString`' method with 0 parameters should be marked as `virtual` and `override` | -| Compiler warning (level 1) C4828 | The file contains a character starting at offset 0x*HexOffset* that is illegal in the current source character set (codepage *codepage*). | +| Compiler warning (level 1) C4828 | The file contains a character starting at offset `0x`*HexOffset* that is illegal in the current source character set (codepage *codepage*). | | [Compiler warning (level 1) C4829](compiler-warning-level-1-c4829.md) | Possibly incorrect parameters to function `main`. Consider '`int main(Platform::Array^ argv)`' | -| [Compiler warning (level 1) C4834](c4834.md) | discarding return value of function with 'nodiscard' attribute | +| [Compiler warning (level 1) C4834](c4834.md) |discarding return value of function with `[[nodiscard]]` attribute| | [Compiler warning (level 1) C4835](compiler-warning-level-1-c4835.md) | '*variable*': the initializer for exported data will not be run until managed code is first executed in the host assembly | | Compiler warning (level 4, off) C4837 | trigraph detected: '`??`*character*' replaced by '*character*' | | [Compiler warning (level 1) C4838](compiler-warning-level-1-c4838.md) | conversion from '*type_1*' to '*type_2*' requires a narrowing conversion | -| [Compiler warning (level 3) C4839](compiler-warning-level-3-c4839.md) | non-standard use of class '*type*' as an argument to a variadic function | +| [Compiler warning (level 3, error) C4839](compiler-warning-level-3-c4839.md) | non-standard use of class '*type*' as an argument to a variadic function | | [Compiler warning (level 4) C4840](compiler-warning-level-4-c4840.md) | non-portable use of class '*type*' as an argument to a variadic function | -| [Compiler warning (level 4, off) C4841](c4841.md) | non-standard extension used: compound member designator used in `offsetof` | +| [Compiler warning (level 4, off) C4841](c4841.md) | non-standard extension used: *message* | | Compiler warning (level 4, off) C4842 | the result of '`offsetof`' applied to a type using multiple inheritance is not guaranteed to be consistent between compiler releases | | [Compiler warning (level 4) C4843](c4843.md) | '*type1*': An exception handler of reference to array or function type is unreachable, use '*type2*' instead | | Compiler warning (level 1) C4844 | '`export module` *`module_name`*`;`' is now the preferred syntax for declaring a module interface | -| Compiler warning (level 4) C4845 | '`__declspec(no_init_all)`' is ignored if '`/d1initall[0|1|2|3]`' was not specified on the command line | +| Compiler warning (level 4) C4845 |'`__declspec(no_init_all)`' is ignored unless '`/d1initall[0|1|2|3]`' or '`/presetPadding`' is specified on the command line| | Compiler warning (level 4) C4846 | '*value*' is not a valid argument for '`/d1initall`': command-line flag ignored | -| Compiler warning (level 4) C4847 | '`__declspec(no_init_all)`' can only be applied to a function, a class type, or a local variable: ignored | -| Compiler warning (level 1) C4848 | support for standard attribute '`no_unique_address`' in C++17 and earlier is a vendor extension | +| Compiler warning (level 4) C4847 |'*identifier*': '`__declspec(no_init_all)`' can only be applied to a function, a class type, or a local variable: ignored | +| Compiler warning (level 1) C4848 | support for attribute `[[`*attribute*`]]` in C++17 and earlier is a vendor extension | | Compiler warning (level 1) C4849 | OpenMP '*clause*' clause ignored in '*directive*' directive | | Compiler warning (Level 1, error) C4854 | binding dereferenced null pointer to reference has undefined behavior | -| Compiler warning (level 1, off) C4855 | implicit capture of '`this`' via '`[=]`' is deprecated in 'version' | -| Compiler warning (level 4) C4856 | '*value*' is not a valid argument for '`/d1initAll:FillPattern`' (value must be between 0 and 255). Command-line flag ignored | -| Compiler warning (level 1) C4857 | C++/CLI mode does not support C++ versions newer than C++17; setting language to `/std:c++17` | +| Compiler warning (level 1, off) C4855 | implicit capture of '`this`' via '`[=]`' is deprecated in '*version*' | +| Compiler warning (level 4) C4856 | '*value*' is not a valid argument for '`/d1initAll:FillPattern`' (value must be between `0` and `255`). Command-line flag ignored | +| Compiler warning (level 1) C4857 | C++/CLI mode does not support C++ versions newer than C++*ver*; setting language to `/std:c++`*ver* | | Compiler warning (level 1) C4858 | discarding return value: *function name* | | Compiler warning (level 4) C4859 | '*value*' is not a valid argument for '`/presetWarn`': it must be a decimal value > 0. Command-line flag ignored | | Compiler warning (level 4) C4860 | '*object name*': compiler zero initialized '*number*' bytes of storage | | Compiler warning (level 4) C4861 | compiler zero initialized '*number*' bytes of storage | | [Compiler warning (level 4) C4866](c4866.md) | compiler may not enforce left-to-right evaluation order for call to *operator_name* | -| [Compiler warning (level 1, error) C4867](compiler-warning-c4867.md) | '*function*': function call missing argument list; use '*call*' to create a pointer to member | +| [Compiler warning (level 1, error) C4867](compiler-warning-c4867.md) |'*function name*': non-standard syntax; use '`&`' to create a pointer to member| | [Compiler warning (level 4) C4868](compiler-warning-c4868.md) | '*file*(*line_number*)' compiler may not enforce left-to-right evaluation order in braced initialization list | | Compiler warning (level 3) C4869 | '`nodiscard`' may only be applied to classes, enumerations, and functions | | Compiler warning (level 2) C4872 | floating point division by zero detected when compiling the call graph for the `concurrency::parallel_for_each` at: '*location*' | -| Compiler warning (level 1) C4880 | casting from 'const *type_1*' to '*type_2*': casting away constness from a pointer or reference may result in undefined behavior in an amp restricted function | +| Compiler warning (level 1) C4880 | casting from '*const type_1*' to '*type_2*': casting away constness from a pointer or reference may result in undefined behavior in an `amp` restricted function | | Compiler warning (level 4) C4881 | the constructor and/or the destructor will not be invoked for `tile_static` variable '*variable-name*' | | Compiler warning (level 1) C4882 | passing functors with non-const call operators to `concurrency::parallel_for_each` is deprecated | | Compiler warning C4883 | '*function name*': function size suppresses optimizations | | [Compiler warning C4900](compiler-warning-level-1-c4900.md) | Il mismatch between '*tool1*' version '*version1*' and '*tool2*' version '*version2*' | -| [Compiler warning (level 1, off) C4905](compiler-warning-level-1-c4905.md) | wide string literal cast to '`LPSTR`' | -| [Compiler warning (level 1, off) C4906](compiler-warning-level-1-c4906.md) | string literal cast to '`LPWSTR`' | -| Compiler warning (Error) C4907 | multiple calling conventions cannot be specified; last given will be used | -| [Compiler warning (level 1) C4910](compiler-warning-level-1-c4910.md) | '\: '__declspec(dllexport)' and 'extern' are incompatible on an explicit instantiation | +| [Compiler warning (level 1, off) C4905](compiler-warning-level-1-c4905.md) | wide string literal cast to '*type*' | +| [Compiler warning (level 1, off) C4906](compiler-warning-level-1-c4906.md) | string literal cast to '*type*' | +| Compiler warning (error) C4907 | multiple calling conventions cannot be specified; last given will be used | +| [Compiler warning (level 1) C4910](compiler-warning-level-1-c4910.md) |'*identifier*': '`__declspec(dllexport)`' and '`extern`' are incompatible on an explicit instantiation| | [Compiler warning (level 1) C4912](compiler-warning-level-1-c4912.md) | '*attribute*': attribute has undefined behavior on a nested UDT | | [Compiler warning (level 4) C4913](compiler-warning-level-4-c4913.md) | user defined binary operator '`,`' exists but no overload could convert all operands, default built-in binary operator '`,`' used | | Compiler warning (level 1) C4916 | in order to have a `dispid`, '*description*': must be introduced by an interface | | [Compiler warning (level 1, off) C4917](compiler-warning-level-1-c4917.md) | '*declarator*': a GUID can only be associated with a class, interface or namespace | | [Compiler warning (level 4) C4918](compiler-warning-level-4-c4918.md) | '*character*': invalid character in pragma optimization list | -| [Compiler warning (level 1) C4920](compiler-warning-level-1-c4920.md) | enum *enum-name* member *member_1*=*value_1* already seen in enum *enum-name* as *member_2*=*value_2* | +| [Compiler warning (level 1) C4920](compiler-warning-level-1-c4920.md) | `enum` *enum-name* member *member_1*`=`*value_1* already seen in `enum` *enum-name* as *member_2*`=`*value_2* | | Compiler warning (level 3) C4921 | '*description*': attribute value '*attribute*' should not be multiply specified | -| [Compiler warning (level 1) C4925](compiler-warning-level-1-c4925.md) | '*method*': dispinterface method cannot be called from script | +| [Compiler warning (level 1) C4925](compiler-warning-level-1-c4925.md) | '*method*': `dispinterface` method cannot be called from script | | [Compiler warning (level 1) C4926](compiler-warning-level-1-c4926.md) | '*identifier*': symbol is already defined: attributes ignored | | [Compiler warning (level 1) C4927](compiler-warning-level-1-c4927.md) | illegal conversion; more than one user-defined conversion has been implicitly applied | | [Compiler warning (level 1, off) C4928](compiler-warning-level-1-c4928.md) | illegal copy-initialization; more than one user-defined conversion has been implicitly applied | -| [Compiler warning (level 1) C4929](compiler-warning-level-1-c4929.md) | '*file*': typelibrary contains a union; ignoring the 'embedded_idl' qualifier | +| [Compiler warning (level 1) C4929](compiler-warning-level-1-c4929.md) | '*file*': `typelibrary` contains a union; ignoring the '`embedded_idl`' qualifier | | [Compiler warning (level 1) C4930](compiler-warning-level-1-c4930.md) | '*prototype*': prototyped function not called (was a variable definition intended?) | | [Compiler warning (level 4, off) C4931](compiler-warning-level-4-c4931.md) | we are assuming the type library was built for *number*-bit pointers | | [Compiler warning (level 4) C4932](compiler-warning-level-4-c4932.md) | `__identifier(`*identifier*`)` and `__identifier(`*identifier*`)` are indistinguishable | | Compiler warning (level 1) C4934 | '`__delegate(multicast)`' is deprecated, use '`__delegate`' instead | | [Compiler warning (level 1) C4935](compiler-warning-level-1-c4935.md) | assembly access specifier modified from '*access*' | -| [Compiler warning (level 1, Error) C4936](compiler-warning-c4936.md) | this __declspec is supported only when compiled with `/clr` or `/clr:pure` | +| [Compiler warning (level 1, error) C4936](compiler-warning-c4936.md) | this `__declspec` is supported only when compiled with `/clr` or `/clr:pure` | | [Compiler warning (level 4) C4937](compiler-warning-level-4-c4937.md) | '*text1*' and '*text2*' are indistinguishable as arguments to '*directive*' | | [Compiler warning (level 4) C4938](compiler-warning-level-4-c4938.md) | '*var*': Floating point reduction variable may cause inconsistent results under `/fp:strict` or `#pragma fenv_access` | -| [Compiler warning C4939](compiler-warning-level-1-c4939.md) | #pragma vtordisp is deprecated and will be removed in a future release of Visual C++ | +| [Compiler warning (level 1) C4939](compiler-warning-level-1-c4939.md) | `#pragma vtordisp` is deprecated and will be removed in a future release of Visual C++ | | [Compiler warning (level 1) C4944](compiler-warning-level-1-c4944.md) | '*symbol*': cannot import symbol from '*assembly1*': as '*symbol*' already exists in the current scope | | [Compiler warning (level 1) C4945](compiler-warning-level-1-c4945.md) | '*symbol*': cannot import symbol from '*assembly1*': as '*symbol*' has already been imported from another assembly '*assembly2*' | | [Compiler warning (level 1, off) C4946](compiler-warning-level-1-c4946.md) | `reinterpret_cast` used between related classes: '*class1*' and '*class2*' | | [Compiler warning (level 1) C4947](compiler-warning-level-1-c4947.md) | '*type_or_member*': marked as obsolete | | [Compiler warning (level 2) C4948](compiler-warning-level-2-c4948.md) | return type of '*accessor*' does not match the last parameter type of the corresponding setter | -| [Compiler warning (level 1 and level 4) C4949](compiler-warning-level-1-and-level-4-c4949.md) | pragmas '`managed`' and '`unmanaged`' are meaningful only when compiled with '`/clr[:option]`' | -| [Compiler warning (level 1, Error) C4950](compiler-warning-c4950.md) | '*type_or_member*': marked as obsolete | +| [Compiler warning (level 1 and level 4) C4949](compiler-warning-level-1-and-level-4-c4949.md) | `pragma` '*pragma*' is meaningful only when compiled with '`/clr[:option]`'| +| [Compiler warning (level 1, error) C4950](compiler-warning-c4950.md) | '*type_or_member*': marked as obsolete | | [Compiler warning (level 1) C4951](compiler-warning-level-1-c4951.md) | '*function*' has been edited since profile data was collected, function profile data not used | | [Compiler warning (level 1) C4952](compiler-warning-level-1-c4952.md) | '*function*': no profile data found in program database '*pgd-file*' | | [Compiler warning (level 1) C4953](compiler-warning-level-1-c4953.md) | Inlinee '*function*' has been edited since profile data was collected, profile data not used | | Compiler warning C4954 | '*function*': not profiled (contains `__int64` switch expression) | | Compiler warning C4955 | '*import2*': import ignored; already imported from '*import1*' | -| [Compiler warning (level 1, Error) C4956](compiler-warning-c4956.md) | '*type*': this type is not verifiable | -| [Compiler warning (level 1, Error) C4957](compiler-warning-c4957.md) | '*cast*': explicit cast from '*cast_from*' to '*cast_to*' is not verifiable | -| [Compiler warning (level 1, Error) C4958](compiler-warning-c4958.md) | '*operation*': pointer arithmetic is not verifiable | -| [Compiler warning (level 1, Error) C4959](compiler-warning-c4959.md) | cannot define unmanaged type '*type*' in `/clr:safe` because accessing its members yields unverifiable code | +| [Compiler warning (level 1, error) C4956](compiler-warning-c4956.md) | '*type*': this type is not verifiable | +| [Compiler warning (level 1, error) C4957](compiler-warning-c4957.md) | '*cast*': explicit cast from '*cast_from*' to '*cast_to*' is not verifiable | +| [Compiler warning (level 1, error) C4958](compiler-warning-c4958.md) | '*operation*': pointer arithmetic is not verifiable | +| [Compiler warning (level 1, error) C4959](compiler-warning-c4959.md) | cannot define unmanaged *type* '*identifier*' in `/clr:safe` because accessing its members yields unverifiable code | | [Compiler warning (level 4) C4960](compiler-warning-level-4-c4960.md) | '*function*' is too big to be profiled | | [Compiler warning (level 1) C4961](compiler-warning-c4961.md) | No profile data was merged into '*pgd-file*', profile-guided optimizations disabled | | [Compiler warning (level 4, off) C4962](compiler-warning-c4962.md) | '*function*': Profile-guided optimizations disabled because optimizations caused profile data to become inconsistent | | Compiler warning (level 1) C4963 | '*description*': no profile data found; different compiler options were used in instrumented build | | [Compiler warning (level 1) C4964](compiler-warning-level-1-c4964.md) | No optimization options were specified; profile info will not be collected | -| [Compiler warning (level 1) C4965](compiler-warning-level-1-c4965.md) | implicit box of integer 0; use nullptr or explicit cast | +| [Compiler warning (level 1) C4965](compiler-warning-level-1-c4965.md) | implicit box of integer `0`; use `nullptr` or explicit cast | | Compiler warning (level 1) C4966 | '*function*' has `__code_seg` annotation with unsupported segment name, annotation ignored | | Compiler warning C4970 | delegate constructor: target object ignored since '*type*' is static | -| Compiler warning (level 1) C4971 | Argument order: \, \ for delegate constructor is deprecated, use \, \ | -| [Compiler warning (level 1, Error) C4972](compiler-warning-c4972.md) | Directly modifying or treating the result of an unbox operation as an lvalue is unverifiable | +| Compiler warning (level 1, no longer emitted) C4971 |Argument order: ``, `` for delegate constructor is deprecated, use ``, ``| +| [Compiler warning (level 1, error) C4972](compiler-warning-c4972.md) | Directly modifying or treating the result of an unbox operation as an lvalue is unverifiable | | Compiler warning (level 1) C4973 | '*symbol*': marked as deprecated | | Compiler warning (level 1) C4974 | '*symbol*': marked as deprecated | | Compiler warning (level 1) C4975 | modopt '[*modifier*]' was ignored for formal parameter '*parameter*' | -| Compiler warning (level 1) C4976 | invalid value '*value*' for '`/W`'; assuming '1' | -| Compiler warning (level 3) C4981 | Warbird: function '*function*' marked as __forceinline not inlined because it contains exception semantics | -| Compiler warning (level 3) C4983 | '/analyze:sarif:hashname' ignored because the argument to '/analyze:log' is a single file rather than a directory | -| [Compiler warning C4984](compiler-warning-c4984.md) | '`if constexpr`' is a C++17 language extension | -| [Compiler warning (level 4) C4985](compiler-warning-level-4-c4985.md) | '*symbol_name*': attributes not present on previous declaration. | -| [Compiler warning (level 4, off) C4986](compiler-warning-c4986.md) | '*declaration*': exception specification does not match previous declaration | +| Compiler warning (level 1) C4976 | invalid value '*value*' for '`/W`'; assuming '`1`' | +| Compiler warning (level 3) C4981 | Warbird: function '*function*' marked as `__forceinline` not inlined because it contains exception semantics | +| Compiler warning (level 3) C4983 | '`/analyze:sarif:hashname`' ignored because the argument to '`/analyze:log`' is a single file rather than a directory | +| [Compiler warning (level 1) C4984](compiler-warning-c4984.md) | '`if constexpr`' is a C++17 language extension | +| [Compiler warning (level 3) C4985](compiler-warning-level-4-c4985.md) | '*symbol_name*': attributes not present on previous declaration. | +| [Compiler warning (level 2 and level 4, off) C4986](compiler-warning-c4986.md) | '*declaration*': exception specification does not match previous declaration | | Compiler warning (level 4, off) C4987 | nonstandard extension used: '`throw (...)`' | | Compiler warning (level 4, off) C4988 | '*variable*': variable declared outside class/function scope | | Compiler warning (level 4) C4989 | '*type*': type has conflicting definitions. | | Compiler warning (level 3) C4990 | Warbird: *message* | | Compiler warning (level 3) C4991 | Warbird: function '*function*' marked as `__forceinline` not inlined because protection level of inlinee is greater than the parent | | Compiler warning (level 3) C4992 | Warbird: function '*function-name*' marked as `__forceinline` not inlined because it contains inline assembly which cannot be protected | -| [Compiler warning (level 3) C4995](compiler-warning-level-3-c4995.md) | '*function*': name was marked as #pragma deprecated | -| [Compiler warning (level 3) C4996](compiler-warning-level-3-c4996.md) | '*deprecated-declaration*': *deprecation-message* (or "was declared deprecated") | -| [Compiler warning (level 1) C4997](compiler-warning-level-1-c4997.md) | '*class*': coclass does not implement a COM interface or pseudo-interface | +| [Compiler warning (level 3) C4995](compiler-warning-level-3-c4995.md) | '*function*': name was marked as `#pragma deprecated` | +| [Compiler warning (level 3) C4996](compiler-warning-level-3-c4996.md) | '*deprecated-declaration*': *deprecation-message* | +| [Compiler warning (level 1) C4997](compiler-warning-level-1-c4997.md) | '*class*': `coclass` does not implement a COM interface or pseudo-interface | | Compiler warning (level 1) C4998 | EXPECTATION FAILED: *expectation*(*value*) | ## See also diff --git a/docs/error-messages/compiler-warnings/compiler-warnings-c5000-through-c5199.md b/docs/error-messages/compiler-warnings/compiler-warnings-c5000-through-c5199.md index 5fd8d8a5fdb..38f4e448954 100644 --- a/docs/error-messages/compiler-warnings/compiler-warnings-c5000-through-c5199.md +++ b/docs/error-messages/compiler-warnings/compiler-warnings-c5000-through-c5199.md @@ -23,39 +23,39 @@ The articles in this section describe Microsoft C/C++ compiler warning messages | Compiler warning (level 1 and level 4, off) C5027 | '*type*': move assignment operator was implicitly defined as deleted | | Compiler warning (level 1) C5028 | '*name*': Alignment specified in prior declaration (*number*) not specified in definition | | Compiler warning (level 4, off) C5029 | nonstandard extension used: alignment attributes in C++ apply to variables, data members and tag types only | -| Compiler warning (level 3) C5030 | attribute '*attribute-name*' is not recognized | +| Compiler warning (level 3) C5030 | attribute `[[`*attribute_name*`]]` is not recognized | | Compiler warning (level 4, off) C5031 | `#pragma warning(pop)`: likely mismatch, popping warning state pushed in different file | | Compiler warning (level 4, off) C5032 | detected `#pragma warning(push)` with no corresponding `#pragma warning(pop)` | | [Compiler warning (level 1) C5033](c5033.md) | '*storage-class*' is no longer a supported storage class | -| Compiler warning (level 5, off) C5034 | use of intrinsic '*intrinsic*' causes function *function-name* to be compiled as guest code | -| Compiler warning (level 5, off) C5035 | use of feature '*feature*' causes function *function-name* to be compiled as guest code | -| Compiler warning (level 1) C5036 | varargs function pointer conversion when compiling with `/hybrid:x86arm64` '*type1*' to '*type2*' | -| [Compiler warning (error) C5037](c5037.md) | '*member-function*': an out-of-line definition of a member of a class template cannot have default arguments | -| [Compiler warning (level 4, off) C5038](c5038.md) | data member '*member1*' will be initialized after data member '*member2*' | -| Compiler warning (level 4, off) C5039 | '*function*': pointer or reference to potentially throwing function passed to `extern C` function under `-EHc`. Undefined behavior may occur if this function throws an exception. | +| Compiler warning (level 4, off) C5034 | use of intrinsic '*intrinsic*' causes function *function-name* to be compiled as guest code | +| Compiler warning (level 4, off) C5035 | use of feature '*feature*' causes function *function-name* to be compiled as guest code | +| Compiler warning (level 1) C5036 | `varargs` function pointer conversion when compiling with /hybrid:x86arm64 from type '*type1*' to type '*type2*' | +| [Compiler warning (level 3, error) C5037](c5037.md) | '*member-function*': an out-of-line definition of a member of a class template cannot have default arguments | +| [Compiler warning (level 4, off) C5038](c5038.md) | *data member* '*member1*' will be initialized after *data member* '*member2*' | +| Compiler warning (level 4, off) C5039 | '*function*': pointer or reference to potentially throwing function passed to '`extern "C"`' function under `-EHc`. Undefined behavior may occur if this function throws an exception. | | Compiler warning (level 3) C5040 | dynamic exception specifications are valid only in C++14 and earlier; treating as noexcept(false) | -| Compiler warning (level 1, off) C5041 | '*definition*': out-of-line definition for constexpr static data member is not needed and is deprecated in C++17 | -| Compiler warning (level 3, off) C5042 | '*declaration*': function declarations at block scope cannot be specified 'inline' in standard C++; remove 'inline' specifier | +| Compiler warning (level 4, off) C5041 | '*definition*': out-of-line definition for `constexpr` static data member is not needed and is deprecated in C++17 | +| Compiler warning (level 3, off) C5042 | '*declaration*': function declarations at block scope cannot be specified '`inline`' in standard C++; remove '`inline`' specifier | | Compiler warning (level 2) C5043 | '*specification*': exception specification does not match previous declaration | | Compiler warning (level 4) C5044 | An argument to command-line option *option-name* points to a path '*path-name*' that does not exist | -| [Compiler warning (level 4) C5045](c5045.md) | Compiler will insert Spectre mitigation for memory load if /Qspectre switch specified | +| [Compiler warning (level 4) C5045](c5045.md) | Compiler will insert Spectre mitigation for memory load if `/Qspectre` switch specified | | [Compiler warning (level 2) C5046](c5046.md) | '*function*': Symbol involving type with internal linkage not defined | -| Compiler warning (level 1) C5047 | use of nonstandard `__if_exists` with modules is not supported | +| Compiler warning (level 1, error) C5047 | use of nonstandard '*keyword*' with modules is not supported | | Compiler warning (level 1) C5048 | Use of macro '*macroname*' may result in non-deterministic output | | Compiler warning (level 1) C5049 | '*string*': Embedding a full path may result in machine-dependent output | | [Compiler warning (level 1) C5050](c5050.md) | Possible incompatible environment while importing module '*module_name*': *issue* | -| Compiler warning (level 1) C5051 | attribute 'attribute-name' requires at least 'standard-level'; ignored | -| Compiler warning (level 3, off) C5052 | Keyword 'keyword-name' was introduced in C++\ and requires use of the 'option-name' command-line option | +| Compiler warning (level 1) C5051 | attribute `[[`*attribute-name*`]]` requires at least '*standard_version*'; ignored | +| Compiler warning (level 3, off) C5052 | Keyword '*keyword-name*' was introduced in `C++`*version* and requires use of the '*switch*' command-line option | | Compiler warning (level 1) C5053 | support for '`explicit()`' in C++17 and earlier is a vendor extension | -| [Compiler warning (level 4) C5054](c5054.md) | operator 'operator-name': deprecated between enumerations of different types | -| [Compiler warning (level 1) C5055](c5055.md) | operator 'operator-name': deprecated between enumerations and floating-point types | -| [Compiler warning (level 1) C5056](c5056.md) | operator 'operator-name': deprecated for array types | -| Compiler warning (level 1) C5057 | header unit reference to 'name' already exists. Ignoring header unit 'header-name' | -| Compiler warning (level 1) C5058 | file system error: cannot find header file 'file-name' for header unit 'unit-name' | +| [Compiler warning (level 4) C5054](c5054.md) | operator '*operator-name*': deprecated between enumerations of different types | +| [Compiler warning (level 1) C5055](c5055.md) | operator '*operator-name*': deprecated between enumerations and floating-point types | +| [Compiler warning (level 1) C5056](c5056.md) | operator '*operator-name*': deprecated for array types | +| Compiler warning (level 1) C5057 | header unit reference to '*name*' already exists. Ignoring header unit '*header-name*' | +| Compiler warning (level 1) C5058 | file system error: cannot find header file '*file-name*' for header unit '*unit-name*' | | Compiler warning C5059 | runtime checks and address sanitizer is not currently supported - disabling runtime checks | | Compiler warning (level 4) C5060 | `/Qpar` and address sanitizer not currently supported - disabling auto-parallelization | | Compiler warning (level 4) C5061 | the use of a comma operator as a subscript expression has been deprecated | -| Compiler warning (level 4) C5062 | enum direct list initialization between 'type-1' and 'type-2' is no longer supported | +| Compiler warning (level 4) C5062 | `enum` direct list initialization between '*type-1*' and '*type-2*' is no longer supported | | Compiler warning (level 1) C5063 | '`std::is_constant_evaluated`' always evaluates to true in manifestly constant-evaluated expressions | | [Compiler warning (level 1) C5072](compiler-warning-c5072.md) | ASAN enabled without debug information emission. Enable debug info for better ASAN error reporting | | Compiler warning (level 1) C5081 | Secure hotpatch is not supported with `/GENPROFILE`, `/FASTGENPROFILE` or `/LTCG:PGI`, disabling secure hotpatch. | diff --git a/docs/error-messages/compiler-warnings/compiler-warnings-c5200-through-c5399.md b/docs/error-messages/compiler-warnings/compiler-warnings-c5200-through-c5399.md index 43dea219e00..0bebc97caa6 100644 --- a/docs/error-messages/compiler-warnings/compiler-warnings-c5200-through-c5399.md +++ b/docs/error-messages/compiler-warnings/compiler-warnings-c5200-through-c5399.md @@ -2,8 +2,8 @@ title: "Microsoft C/C++ compiler (MSVC) compiler warnings C5200 through C5399" description: "Table of Microsoft C/C++ compiler (MSVC) warnings C5200 through C5399." ms.date: 04/19/2024 -f1_keywords: ["C5200", "C5201", "C5202", "C5203", "C5204", "C5205", "C5206", "C5207", "C5209", "C5210", "C5211", "C5212", "C5213", "C5214", "C5215", "C5216", "C5217", "C5218", "C5219", "C5220", "C5221", "C5222", "C5223", "C5224", "C5225", "C5226", "C5227", "C5228", "C5229", "C5230", "C5231", "C5232", "C5233", "C5234", "C5235", "C5236", "C5237", "C5238", "C5239", "C5241", "C5242", "C5244", "C5245", "C5246", "C5249", "C5250", "C5251", "C5252", "C5253", "C5254", "C5255", "C5256", "C5257", "C5258", "C5259", "C5260", "C5261", "C5263", "C5264", "C5265", "C5268", "C5269", "C5270", "C5271", "C5272", "C5273", "C5274", "C5275", "C5300", "C5303", "C5304", "C5305"] -helpviewer_keywords: ["C5200", "C5201", "C5202", "C5203", "C5204", "C5205", "C5206", "C5207", "C5209", "C5210", "C5211", "C5212", "C5213", "C5214", "C5215", "C5216", "C5217", "C5218", "C5219", "C5220", "C5221", "C5222", "C5223", "C5224", "C5225", "C5226", "C5227", "C5228", "C5229", "C5230", "C5231", "C5232", "C5233", "C5234", "C5235", "C5236", "C5237", "C5238", "C5239", "C5241", "C5242", "C5244", "C5245", "C5246", "C5249", "C5250", "C5251", "C5252", "C5253", "C5254", "C5255", "C5256", "C5257", "C5258", "C5259", "C5260", "C5261", "C5263", "C5264", "C5265", "C5268", "C5269", "C5270", "C5271", "C5272", "C5273", "C5274", "C5275", "C5300", "C5303", "C5304", "C5305"] +f1_keywords: ["C5200", "C5201", "C5202", "C5203", "C5204", "C5205", "C5206", "C5207", "C5209", "C5210", "C5212", "C5213", "C5214", "C5215", "C5216", "C5217", "C5218", "C5219", "C5220", "C5221", "C5222", "C5223", "C5224", "C5225", "C5226", "C5227", "C5228", "C5229", "C5230", "C5231", "C5232", "C5233", "C5234", "C5235", "C5236", "C5237", "C5238", "C5239", "C5241", "C5242", "C5244", "C5245", "C5246", "C5249", "C5250", "C5251", "C5252", "C5253", "C5254", "C5255", "C5256", "C5257", "C5258", "C5259", "C5260", "C5261", "C5263", "C5264", "C5265", "C5268", "C5269", "C5270", "C5271", "C5272", "C5273", "C5274", "C5275", "C5276", "C5277", "C5278", "C5279", "C5280", "C5281", "C5282", "C5283", "C5284", "C5285", "C5286", "C5287", "C5300", "C5303", "C5304", "C5305", "C5306", "C5307", "C5308", "C5309"] +helpviewer_keywords: ["C5200", "C5201", "C5202", "C5203", "C5204", "C5205", "C5206", "C5207", "C5209", "C5210", "C5212", "C5213", "C5214", "C5215", "C5216", "C5217", "C5218", "C5219", "C5220", "C5221", "C5222", "C5223", "C5224", "C5225", "C5226", "C5227", "C5228", "C5229", "C5230", "C5231", "C5232", "C5233", "C5234", "C5235", "C5236", "C5237", "C5238", "C5239", "C5241", "C5242", "C5244", "C5245", "C5246", "C5249", "C5250", "C5251", "C5252", "C5253", "C5254", "C5255", "C5256", "C5257", "C5258", "C5259", "C5260", "C5261", "C5263", "C5264", "C5265", "C5268", "C5269", "C5270", "C5271", "C5272", "C5273", "C5274", "C5275", "C5276", "C5277", "C5278", "C5279", "C5280", "C5281", "C5282", "C5283", "C5284", "C5285", "C5286", "C5287", "C5300", "C5303", "C5304", "C5305", "C5306", "C5307", "C5308", "C5309"] --- # Microsoft C/C++ compiler warnings C5200 through C5399 @@ -15,29 +15,29 @@ The articles in this section describe Microsoft C/C++ compiler warning messages | Warning | Message | |--|--| -| Compiler warning (level 1) C5200 | feature 'feature-name' requires compiler flag 'option-name' | +| Compiler warning (level 1) C5200 | *feature* '*feature-name*' requires compiler flag '*option-name*' | | Compiler warning (level 1) C5201 | a module declaration can appear only at the start of a translation unit unless a global module fragment is used | | Compiler warning (level 1) C5202 | a global module fragment can only contain preprocessor directives | -| Compiler warning (level 1) C5203 | a parenthesized declarator name after 'explicit' will be considered an explicit-specifier in C++20 | -| Compiler warning (level 3, off) C5204 | 'type-name': class has virtual functions, but its trivial destructor is not virtual; instances of objects derived from this class may not be destructed correctly | -| Compiler warning (level 4) C5205 | delete of an abstract class 'type-name' that has a non-virtual destructor results in undefined behavior | +| Compiler warning (level 1) C5203 | a parenthesized declarator name after '`explicit`' will be considered an explicit-specifier in C++20 | +| Compiler warning (level 3, off) C5204 | '*type-name*': class has virtual functions, but its trivial destructor is not virtual; instances of objects derived from this class may not be destructed correctly | +| Compiler warning (level 4) C5205 | delete of an abstract class '*type-name*' that has a non-virtual destructor results in undefined behavior | | Compiler warning (level 3) C5206 | deduced return types for coroutines is a non-standard extension | | Compiler warning (level 1) C5207 | the simple requirement asserts the validity of expression '`e->id`'. Did you mean '`{ e } -> id`'? You can suppress the warning using '`{ e->id }`' | -| [Compiler warning (level 1) C5208](c5208.md) | unnamed class used in `typedef` name cannot declare members other than non-static data members, member enumerations, or member classes | -| Compiler warning (level 1) C5209 | the C++20 syntax for an init-capture has changed to '& ...opt identifier initializer' | +| [Compiler warning (level 1, error) C5208](c5208.md) | unnamed class used in `typedef` name cannot declare members other than non-static data members, member enumerations, or member classes | +| Compiler warning (level 1) C5209 | the C++20 syntax for an init-capture has changed to '`& ...opt identifier initializer`' | | Compiler warning (level 1) C5210 | '*name*' is not a valid header unit reference; ignoring | | Compiler warning (level 1) C5212 | '*name*' is not a valid named reference; treating as reference to file | -| Compiler warning (level 1) C5213 | '*name*' named reference is treated as a named partition but the name is not specified; treating as reference to file | +| Compiler warning (level 1) C5213 | '*name*' named reference is treated as a named partition but the *module* name is not specified; treating as reference to file | | Compiler warning (level 4, off) C5214 | applying '*modifier*' to an operand with a volatile qualified type is deprecated in C++20 | | Compiler warning (level 4, off) C5215 | '*name*' a function parameter with a volatile qualified type is deprecated in C++20 | | Compiler warning (level 4, off) C5216 | '*name*' a volatile qualified return type is deprecated in C++20 | | Compiler warning (level 4, off) C5217 | a structured binding declaration that includes volatile is deprecated in C++20 | | Compiler warning (level 1) C5218 | destroying delete may not behave as intended when non-conforming switches '`/Zc:sizedDealloc-`' or '`/Zc:alignedNew-`' are used | | Compiler warning (level 2, off) C5219 | implicit conversion from '*type-1*' to '*type-2*', possible loss of data | -| Compiler warning (level 4, off) C5220 | '*name*': a non-static data member with a volatile qualified type no longer implies that compiler generated copy/move constructors and copy/move assignment operators are not trivial | -| Compiler warning (level 1) C5221 | xfg::rename is deprecated. | +| Compiler warning (level 4, off) C5220 | '*name*': a non-static data member with a volatile qualified type no longer implies
that compiler generated copy/move constructors and copy/move assignment operators are not trivial | +| Compiler warning (level 1) C5221 | `xfg::rename` is deprecated. | | Compiler warning (level 3) C5222 | '*attribute-name*': all unscoped attribute names are reserved for future standardization | -| Compiler warning (level 3) C5223 | all attribute names in the attribute namespace 'msvc' are reserved for the implementation | +| Compiler warning (level 3) C5223 | all attribute names in the attribute namespace '`msvc`' are reserved for the implementation | | Compiler warning (level 3) C5224 | all attribute names in the attribute namespace '*namespace-name*' are reserved for future standardization | | Compiler warning (level 1) C5225 | '*symbol*': exported inline function defined in a private module fragment is a non-standard extension | | Compiler warning (level 1) C5226 | '*symbol*': exported template defined in private module fragment has no reachable instantiation | @@ -45,7 +45,7 @@ The articles in this section describe Microsoft C/C++ compiler warning messages | Compiler warning (level 4) C5228 | nonstandard extension, '*identifier*' resolved to a member of a dependent base. This lookup is not allowed under `/permissive-`. | | Compiler warning (level 4) C5229 | nonstandard extension, the hidden friend function '*function-name*' was found by name lookup which isn't allowed under `/permissive-`. | | Compiler warning C5230 | nonstandard extension, '*identifier*' was resolved to '*symbol-1*' under `/permissive`. Under `/permissive-` it would resolve to '*symbol-2*'. | -| Compiler warning (level 3) C5231 | the expression '`co_await promise.final_suspend()`' must be non-throwing | +| Compiler warning (level 3, error) C5231 | the expression '`co_await promise.final_suspend()`' must be non-throwing | | Compiler warning (level 1) C5232 | in C++20 this comparison calls '*name*' recursively | | Compiler warning (level 4, off) C5233 | explicit lambda capture '*identifier*' is not used | | Compiler warning (level 1) C5234 | file system error: '*filename*' is not a valid header-name; ignoring | @@ -53,35 +53,35 @@ The articles in this section describe Microsoft C/C++ compiler warning messages | Compiler warning (level 1) C5236 | JSON ill-formed: *message*; ignoring '*filename*' | | Compiler warning (level 1) C5237 | cannot resolve header unit entry '*name*' to a header file in '*filename*'; ignoring entry | | Compiler warning (level 1) C5238 | file system error: cannot open '*filename*' for reading; ignoring | -| Compiler warning (level 4) C5239 | '*symbol*': potentially throwing function called from a function declared `__declspec(nothrow)`. Undefined behavior may occur if an exception is thrown. | -| [Compiler warning (level 4) C5240](c5240.md) | '*attribute-name*': attribute is ignored in this syntactic position | -| Compiler warning (level 1) C5241 | '`/exportHeader`' usage to lookup header-name is deprecated; prefer '/headerName:name value=filename' | +| Compiler warning (level 4) C5239 | '*symbol*': potentially-throwing function called from a function declared `__declspec(nothrow)`. Undefined behavior may occur if an exception is thrown. | +| [Compiler warning (level 4, off) C5240](c5240.md) | '*attribute-name*': attribute is ignored in this syntactic position | +| Compiler warning (level 1) C5241 | '`/exportHeader`' usage to lookup header-name is deprecated; prefer '`/headerName:`*name* *value*`=`*filename*' | | Compiler warning (level 1) C5242 | syntax error in pragma '*identifier*' | -| [Compiler warning (level 1, off) C5243](c5243.md) | '*type-name*': using incomplete class 'class-name' can cause potential one definition rule violation due to ABI limitation | -| Compiler warning (level 1) C5244 | '#include \<*filename*>' in the purview of module '*module-name-1*' appears erroneous. Consider moving that directive before the module declaration, or replace the textual inclusion with 'import \<*module-name-2*>;'. | +| [Compiler warning (level 1, off) C5243](c5243.md) | '*type-name*': using incomplete class '*class-name*' can cause potential one definition rule violation due to ABI limitation | +| Compiler warning (level 1) C5244 | '`#include <`*filename*`>`' in the purview of module '*module-name-1*' appears erroneous. Consider moving that directive before the module declaration, or replace the textual inclusion with '`import <`*module-name-2*`>;`'. | | Compiler warning (level 4, off) C5245 | '*function*': unreferenced function with internal linkage has been removed | | Compiler warning (level 1, off) C5246 | '*member*': the initialization of a subobject should be wrapped in braces | | [Compiler warning (level 1, off) C5247](c5247.md) | section '*section-name*' is reserved for C++ dynamic initialization. Manually creating the section will interfere with C++ dynamic initialization and may lead to undefined behavior | -| [Compiler warning (level 1, off) C5248](c5248.md) | section '*section-name*' is reserved for C++ dynamic initialization. Variables manually put into the section may be optimized out and their order relative to compiler generated dynamic initializers is unspecified. | +| [Compiler warning (level 1, off) C5248](c5248.md) | section '*section-name*' is reserved for C++ dynamic initialization. Variables manually put into the section may be optimized out and their order relative to compiler generated dynamic initializers is unspecified | | Compiler warning (level 1, off) C5249 | '*bitfield*' of type '*enumeration_name*' has named enumerators with values that cannot be represented in the given bit field width of '*bitfield_width*'. | -| Compiler warning (level 3, off) C5250 | '*function_name*': intrinsic function not declared. | -| Compiler warning (level 4, off) C5251 | *segment-name* changed after including header | +| Compiler warning (level 3, off) C5250 | '*function_name*': intrinsic function not declared | +| Compiler warning (level 4, off) C5251 | the value of `#pragma` *pragma name* changed after `#include`; `#pragma `*pragma name*`(pop)` missing in this header? | | Compiler warning (level 4) C5252 | Multiple different types resulted in the same XFG type-hash *hash-value*; the PDB will only record information for one of them | | Compiler warning (level 4) C5253 | a non-local lambda cannot have a capture default | -| Compiler warning (level 4, off) C5254 | language feature 'terse static assert' requires compiler flag '/std:c++17' | -| Compiler warning (level 3) C5255 | unterminated bidirectional character encountered: 'U+XXXX' | +| Compiler warning (level 4, off) C5254 | language feature 'terse static assert' requires compiler flag '*/std:c++17*' | +| Compiler warning (level 3) C5255 | unterminated bidirectional character encountered: '`U+`*XXXX*' | | Compiler warning (level 1, off) C5256 | '*enumeration*': a non-defining declaration of an enumeration with a fixed underlying type is only permitted as a standalone declaration | -| Compiler warning (level 1 or 4) C5257 | '*enumeration*': enumeration was previously declared without a fixed underlying type | +| Compiler warning (level 1 and level 4) C5257 | '*enumeration*': enumeration was previously declared without a fixed underlying type | | Compiler warning (level 4, off) C5258 | explicit capture of '*symbol*' is not required for this use | | Compiler warning (level 4, off) C5259 | '*specialized-type*': explicit specialization requires 'template <>' | | Compiler warning (level 1) C5260 | the constant variable '*variable-name*' has internal linkage in an included header file context, but external linkage in imported header unit context; consider declaring it 'inline' as well if it will be shared across translation units, or 'static' to express intent to use it local to this translation unit | | Compiler warning (level 2) C5261 | no integer type can represent all enumerator values in enumeration '*enum-name*' | -| [Compiler warning (level 1, error, off) C5262](c5262.md) | implicit fall-through occurs here; are you missing a break statement? Use `[[fallthrough]]` when a `break` statement is intentionally omitted between cases | +| [Compiler warning (level 1, off) C5262](c5262.md) | implicit fall-through occurs here; are you missing a break statement? Use `[[fallthrough]]` when a `break` statement is intentionally omitted between cases | | Compiler warning (level 4, off) C5263 | calling '`std::move`' on a temporary object prevents copy elision | | Compiler warning (level 4, off) C5264 | '*variable-name*': 'const' variable is not used | | Compiler warning (level 1) C5265 | cannot open search path '*path*' | -| [Compiler warning (level 4, off) C5266](compiler-warning-level-4-c5266.md) | 'const' qualifier on return type has no effect | -| [Compiler warning C5267](c5267.md) | definition of implicit copy constructor/assignment operator for '*type*' is deprecated because it has a user-provided assignment operator/copy constructor | +| [Compiler warning (level 4, off) C5266](compiler-warning-level-4-c5266.md) | '*const*' qualifier on return type has no effect | +| [Compiler warning (level 4, off) C5267](c5267.md) | definition of implicit *copy constructor/assignment operator* for '*type*' is deprecated because it has a user-provided *assignment operator/copy constructor* | | Compiler warning (level 1) C5268 | Failed to allocate memory at fixed address 0x*address*. Use `/Yb` to specify a specific address base if bit-identical .pch files are required. | | Compiler warning (level 1) C5269 | Failed to allocate PCH memory at fixed address 0x*address*. Use `/Ym` to specify a specific address base if bit-identical .pch files are required. | | Compiler warning (level 3) C5270 | '*value*' is not allowed for option '*switch name*'; allowed values are: *value list* | @@ -89,13 +89,29 @@ The articles in this section describe Microsoft C/C++ compiler warning messages | Compiler warning (level 1) C5272 | throwing an object of non-copyable type '*type*' is non-standard. If a copy is needed at runtime it will be made as if by `memcpy`. | | Compiler warning (level 1) C5273 | behavior change: `_Alignas` on anonymous type no longer ignored (promoted members will align) | | Compiler warning (level 1) C5274 | behavior change: `_Alignas` no longer applies to the type '*type*' (only applies to declared data objects) | -| Compiler warning (Error) C5275 | facade assembly '*name*' being imported under '`/clr`'; missing option '`/clr:netcore`'? | -| Compiler warning (level 1, error) C5300 | '#pragma omp atomic': left operand of '*operator*' must match left hand side of assignment-expression | -| [Compiler warning (level 1) C5301](c5301-c5302.md) | '#pragma omp for': '*loop-index*' increases while loop condition uses '*comparison*'; non-terminating loop? | -| [Compiler warning (level 1) C5302](c5301-c5302.md) | '#pragma omp for': '*loop-index*' decreases while loop condition uses '*comparison*'; non-terminating loop? | +| Compiler warning (error) C5275 | assembly '*name*' being imported under '*/clr*' does not contain the required fundamental types | +| Compiler warning (level 1) C5276 | `/experimental:ifcDebugRecords` currently requires `/Z7` to be enabled. Please recompile with `/Z7` enabled.| +| Compiler warning (level 1) C5277 | type trait optimization for '*class name*' is disabled | +| Compiler warning (level 1) C5278 | adding a specialization for '*type*' has undefined behavior | +| Compiler warning (level 1) C5279 | a lambda declarator without a parameter list requires at least '*language version*' | +| Compiler warning (level 1) C5280 | a static operator '*operator name*' requires at least '*language version*'| +| Compiler warning (level 1) C5281 | a static lambda requires at least '*language version*' | +| Compiler warning (level 1) C5282 | '`if consteval`' requires at least '*language version*' | +| Compiler warning (level 1) C5283 | an attribute in this position requires at least '*language version*' | +| Compiler warning (level 4) C5284 | conversion from value '*value*' of type '*type 1*' to '*type 2*' requires a narrowing conversion | +| Compiler warning (level 1) C5285 | cannot declare a specialization for '*template name*': *template argument* | +| Compiler warning (level 1) C5286 | implicit conversion from `enum` type '*type 1*' to `enum` type '*type 2*'; use an explicit cast to silence this warning | +| Compiler warning (level 1) C5287 | operands are different `enum` types '*type 1*' and '*type 2*'; use an explicit cast to silence this warning | +| Compiler warning (error) C5300 | '`#pragma omp atomic` *clause*': expression mismatch for lvalue being updated | +| [Compiler warning (level 1) C5301](c5301-c5302.md) | '`#pragma omp for`': '*loop-index*' increases while loop condition uses '*comparison*'; non-terminating loop? | +| [Compiler warning (level 1) C5302](c5301-c5302.md) | '`#pragma omp for`': '*loop-index*' decreases while loop condition uses '*comparison*'; non-terminating loop? | | Compiler warning (level 1) C5303 | function marked with `[[msvc::intrinsic]]` did not result in a no-op cast | | Compiler warning (level 1) C5304 | a declaration designated by the using-declaration '*name1*' exported from this module has internal linkage and using such a name outside the module is ill-formed; consider declaring '*name2*' '`inline`' to use it outside of this module | | Compiler warning (level 1) C5305 | '*name*': an explicit instantiation declaration that follows an explicit instantiation definition is ignored | +| Compiler warning (level 1) C5306 | parameter array behavior change: overload '*identifier 1*' resolved to '*identifier 2*'; previously, it would have resolved to '*identifier 3*'. Use `/clr:ECMAParamArray` to revert to old behavior | +| Compiler warning (level 3) C5307 | '*function*': argument (*argument number*) converted from '*type 1*' to '*type 2*'. Missing '`L`' encoding-prefix for character literal? | +| Compiler warning (level 1, error) C5308 | Modifying reserved macro name '*macro name*' may cause undefined behavior | +| Compiler warning (level 1, error) C5309 | literal suffix '*name*' requires at least '*language version*'| ## See also diff --git a/docs/error-messages/includes/error-boilerplate.md b/docs/error-messages/includes/error-boilerplate.md index a344d4e6b57..d7eba2d5c8c 100644 --- a/docs/error-messages/includes/error-boilerplate.md +++ b/docs/error-messages/includes/error-boilerplate.md @@ -1,11 +1,11 @@ > [!IMPORTANT] -> The Visual Studio compilers and build tools can report many kinds of errors and warnings. After an error or warning is found, the build tools may make assumptions about code intent and attempt to continue, so that more issues can be reported at the same time. If the tools make the wrong assumption, later errors or warnings may not apply to your project. When you correct issues in your project, always start with the first error or warning that's reported, and rebuild often. One fix may make many subsequent errors go away. +> The Visual Studio compilers and build tools can report many kinds of errors and warnings. After an error or warning is found, the build tools may make assumptions about code intent and attempt to continue, so that more issues can be reported at the same time. If the tools make the wrong assumption, later errors or warnings may not apply to your project. When you correct issues in your project, always start with the first error or warning that's reported, and rebuild often. One fix may resolve multiple subsequent errors. To get help on a particular diagnostic message in Visual Studio, select it in the **Output** window and press the **F1** key. Visual Studio opens the documentation page for that error, if one exists. You can also use the search tool at the top of the page to find articles about specific errors or warnings. Or, browse the list of errors and warnings by tool and type in the table of contents on this page. > [!NOTE] -> Not every Visual Studio error or warning is documented. In many cases, the diagnostic message provides all of the information that's available. If you landed on this page when you used **F1** and you think the error or warning message needs additional explanation, let us know. You can use the feedback buttons on this page to raise a documentation issue on [GitHub](https://github.com/MicrosoftDocs/cpp-docs/issues). If you think the error or warning is wrong, or you've found another problem with the toolset, report a product issue on the [Developer Community](https://aka.ms/feedback/report?space=62) site. You can also send feedback and enter bugs within the IDE. In Visual Studio, go to the menu bar and choose **Help > Send Feedback > Report a Problem**, or submit a suggestion by using **Help > Send Feedback > Send a Suggestion**. Some compiler error topics were created that are not emitted by the compiler and now redirect to this page instead. +> Not every Visual Studio error or warning is documented. In many cases, the diagnostic message provides all of the information that's available. If you landed on this page and think the error or warning message needs additional explanation, let us know by using the feedback buttons on this page. If you think the error or warning is wrong, or you've found another problem with the toolset, report a product issue on the [Developer Community](https://aka.ms/feedback/report?space=62) site. You can also send feedback and enter bugs within the IDE. In Visual Studio, go to the menu bar and choose **Help > Send Feedback > Report a Problem**, or submit a suggestion by using **Help > Send Feedback > Suggest a Feature**. Some compiler error topics were created that are not emitted by the compiler and now redirect to this page instead. -You may find additional assistance for errors and warnings in [Microsoft Learn Q&A](/answers/topics/c%2B%2B.html) forums. Or, search for the error or warning number on the Visual Studio C++ [Developer Community](https://aka.ms/vsfeedback/browsecpp) site. You can also search [Stack Overflow](https://stackoverflow.com/) to find solutions. +You may find additional assistance for errors and warnings in [Microsoft Q&A C++](/answers/tags/314/cpp) forums. Or, search for the error or warning number on the Visual Studio C++ [Developer Community](https://aka.ms/vsfeedback/browsecpp) site. You can also search [Stack Overflow](https://stackoverflow.com/) to find solutions. For links to additional help and community resources, see [Visual C++ Help and Community](../../overview/visual-cpp-help-and-community.md). diff --git a/docs/error-messages/toc.yml b/docs/error-messages/toc.yml index ad851c5bbbd..acb65fcdd54 100644 --- a/docs/error-messages/toc.yml +++ b/docs/error-messages/toc.yml @@ -86,7 +86,7 @@ items: - name: Compiler fatal errors expanded: false items: - - name: Compiler fatal errors C999 through C1999 + - name: Compiler fatal errors C1001 through C1907 href: compiler-errors-1/compiler-fatal-errors-c999-through-c1999.md - name: Fatal error C1001 href: compiler-errors-1/fatal-error-c1001.md @@ -3167,6 +3167,10 @@ items: href: compiler-errors-2/compiler-error-c7553.md - name: Compiler error C7626 href: compiler-warnings/c5208.md + - name: Compiler error C7688 + href: compiler-errors-2/compiler-error-c7688.md + - name: Compiler error C7742 + href: compiler-errors-2/compiler-error-c7742.md - name: Compiler warnings C4000 through C5999 expanded: false items: @@ -3725,7 +3729,7 @@ items: items: - name: Compiler warnings C4400 through C4599 href: compiler-warnings/compiler-warnings-c4400-through-c4599.md - - name: Compiler warning (level 4) C4400 + - name: Compiler warning (level 4, Error) C4400 href: compiler-warnings/compiler-warning-level-4-c4400.md - name: Compiler warning (level 1) C4401 href: compiler-warnings/compiler-warning-level-1-c4401.md @@ -3749,7 +3753,7 @@ items: href: compiler-warnings/compiler-warning-level-1-c4410.md - name: Compiler warning (level 1) C4411 href: compiler-warnings/compiler-warning-level-1-c4411.md - - name: Compiler warning (level 2) C4412 + - name: Compiler warning (level 2, off) C4412 href: compiler-warnings/compiler-warning-level-2-c4412.md - name: Compiler warning (level 3) C4414 href: compiler-warnings/compiler-warning-level-3-c4414.md @@ -3757,19 +3761,19 @@ items: href: compiler-warnings/compiler-warning-level-1-c4420.md - name: Compiler warning (level 4) C4429 href: compiler-warnings/compiler-warning-level-4-c4429.md - - name: Compiler warning C4430 + - name: Compiler warning (level 1, Error) C4430 href: compiler-warnings/compiler-warning-c4430.md - name: Compiler warning (level 4) C4431 href: compiler-warnings/compiler-warning-level-4-c4431.md - name: Compiler warning (level 4) C4434 href: compiler-warnings/compiler-warning-level-4-c4434.md - - name: Compiler warning (level 4) C4435 + - name: Compiler warning (level 4, off) C4435 href: compiler-warnings/compiler-warning-level-4-c4435.md - - name: Compiler warning (level 1) C4436 + - name: Compiler warning (level 1 and level 4) C4436 href: compiler-warnings/compiler-warning-level-1-c4436.md - - name: Compiler warning (level 4) C4437 + - name: Compiler warning (level 1 and level 4, off) C4437 href: compiler-warnings/compiler-warning-level-4-c4437.md - - name: Compiler warning C4439 + - name: Compiler warning (level 1, Error) C4439 href: compiler-warnings/compiler-warning-c4439.md - name: Compiler warning (level 1) C4440 href: compiler-warnings/compiler-warning-level-1-c4440.md @@ -3777,13 +3781,13 @@ items: href: compiler-warnings/compiler-warning-level-1-c4441.md - name: Compiler warning (level 1) C4445 href: compiler-warnings/compiler-warning-level-1-c4445.md - - name: Compiler warning (level 4) C4456 + - name: Compiler warning (level 1 and level 4) C4456 href: compiler-warnings/compiler-warning-level-4-c4456.md - - name: Compiler warning (level 4) C4457 + - name: Compiler warning (level 1 and level 4) C4457 href: compiler-warnings/compiler-warning-level-4-c4457.md - - name: Compiler warning (level 4) C4458 + - name: Compiler warning (level 1 and level 4) C4458 href: compiler-warnings/compiler-warning-level-4-c4458.md - - name: Compiler warning (level 4) C4459 + - name: Compiler warning (level 1 and level 4) C4459 href: compiler-warnings/compiler-warning-level-4-c4459.md - name: Compiler warning (level 4) C4460 href: compiler-warnings/compiler-warning-level-4-c4460.md @@ -3793,21 +3797,21 @@ items: href: compiler-warnings/compiler-warning-level-1-c4462.md - name: Compiler warning (level 4) C4463 href: compiler-warnings/compiler-warning-level-4-c4463.md - - name: Compiler warning (level 4) C4464 + - name: Compiler warning (level 4, off) C4464 href: compiler-warnings/compiler-warning-level-4-c4464.md - name: Compiler warning (level 1) C4470 href: compiler-warnings/compiler-warning-level-1-c4470.md - - name: Compiler warning (level 4) C4471 + - name: Compiler warning (level 4, off) C4471 href: compiler-warnings/compiler-warning-level-4-c4471.md - name: Compiler warning (level 1) C4473 href: compiler-warnings/c4473.md - name: Compiler warning (level 1) C4477 href: compiler-warnings/c4477.md - - name: Compiler warning (level 4) C4481 + - name: Compiler warning (level 4, Error) C4481 href: compiler-warnings/compiler-warning-level-4-c4481.md - - name: Compiler warning C4484 + - name: Compiler warning (level 1, Error) C4484 href: compiler-warnings/compiler-warning-c4484.md - - name: Compiler warning C4485 + - name: Compiler warning (level 1, Error) C4485 href: compiler-warnings/compiler-warning-c4485.md - name: Compiler warning (level 1) C4486 href: compiler-warnings/compiler-warning-level-1-c4486.md @@ -3831,13 +3835,13 @@ items: href: compiler-warnings/compiler-warning-level-1-c4508.md - name: Compiler warning (level 4) C4510 href: compiler-warnings/compiler-warning-level-4-c4510.md - - name: Compiler warning (level 3) C4511 + - name: Compiler warning (level 4) C4511 href: compiler-warnings/compiler-warning-level-3-c4511.md - name: Compiler warning (level 4) C4512 href: compiler-warnings/compiler-warning-level-4-c4512.md - name: Compiler warning (level 4) C4513 href: compiler-warnings/compiler-warning-level-4-c4513.md - - name: Compiler warning (level 4) C4514 + - name: Compiler warning (level 4, off) C4514 href: compiler-warnings/compiler-warning-level-4-c4514.md - name: Compiler warning (level 4) C4515 href: compiler-warnings/compiler-warning-level-4-c4515.md @@ -3865,7 +3869,7 @@ items: href: compiler-warnings/compiler-warning-level-3-c4534.md - name: Compiler warning (level 3) C4535 href: compiler-warnings/compiler-warning-level-3-c4535.md - - name: Compiler warning (level 4) C4536 + - name: Compiler warning (level 4, off) C4536 href: compiler-warnings/compiler-warning-level-4-c4536.md - name: Compiler warning (level 1) C4537 href: compiler-warnings/compiler-warning-level-1-c4537.md @@ -3879,15 +3883,15 @@ items: href: compiler-warnings/compiler-warning-level-3-c4543.md - name: Compiler warning (level 1) C4544 href: compiler-warnings/compiler-warning-level-1-c4544.md - - name: Compiler warning (level 1) C4545 + - name: Compiler warning (level 1, off) C4545 href: compiler-warnings/compiler-warning-level-1-c4545.md - - name: Compiler warning (level 1) C4546 + - name: Compiler warning (level 1, off) C4546 href: compiler-warnings/compiler-warning-level-1-c4546.md - - name: Compiler warning (level 1) C4547 + - name: Compiler warning (level 1, off) C4547 href: compiler-warnings/compiler-warning-level-1-c4547.md - - name: Compiler warning (level 1) C4548 + - name: Compiler warning (level 1, off) C4548 href: compiler-warnings/compiler-warning-level-1-c4548.md - - name: Compiler warning (level 1) C4549 + - name: Compiler warning (level 1, off) C4549 href: compiler-warnings/compiler-warning-level-1-c4549.md - name: Compiler warning (level 1) C4550 href: compiler-warnings/compiler-warning-level-1-c4550.md @@ -3899,11 +3903,11 @@ items: href: compiler-warnings/compiler-warning-level-1-c4553.md - name: Compiler warning (level 3) C4554 href: compiler-warnings/compiler-warning-level-3-c4554.md - - name: Compiler warning (level 1) C4555 + - name: Compiler warning (level 1, off) C4555 href: compiler-warnings/compiler-warning-level-1-c4555.md - name: Compiler warning (level 1) C4556 href: compiler-warnings/compiler-warning-level-1-c4556.md - - name: Compiler warning (level 3) C4557 + - name: Compiler warning (level 3, off) C4557 href: compiler-warnings/compiler-warning-level-3-c4557.md - name: Compiler warning (level 1) C4558 href: compiler-warnings/compiler-warning-level-1-c4558.md @@ -3931,7 +3935,7 @@ items: href: compiler-warnings/compiler-warning-level-1-c4581.md - name: Compiler warning (level 1) C4584 href: compiler-warnings/compiler-warning-level-1-c4584.md - - name: Compiler warning (level 4) C4596 + - name: Compiler warning (level 4, Error, off) C4596 href: compiler-warnings/c4596.md - name: Compiler warning (level 4) C4597 href: compiler-warnings/c4597.md @@ -4433,7 +4437,7 @@ items: href: tool-errors/cvtres-fatal-error-cvt1105.md - name: CVTRES warning CVT4001 href: tool-errors/cvtres-warning-cvt4001.md -- name: Expression evaluator errors +- name: Expression evaluator errors expanded: false items: - name: Expression evaluator errors (CXXxxxx) @@ -4844,7 +4848,7 @@ items: - name: Math errors expanded: false items: - - name: Math errors (Mxxxx) + - name: Math errors (M6101 through M6205) href: tool-errors/math-errors-m6101-through-m6205.md - name: Math error M6101 href: tool-errors/math-error-m6101.md diff --git a/docs/error-messages/tool-errors/bscmake-error-bk1503.md b/docs/error-messages/tool-errors/bscmake-error-bk1503.md index 64c12bd2413..2a3e2f43d4e 100644 --- a/docs/error-messages/tool-errors/bscmake-error-bk1503.md +++ b/docs/error-messages/tool-errors/bscmake-error-bk1503.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: BSCMAKE Error BK1503" title: "BSCMAKE Error BK1503" -ms.date: "11/04/2016" +description: "Learn more about: BSCMAKE Error BK1503" +ms.date: 11/04/2016 f1_keywords: ["BK1503"] helpviewer_keywords: ["BK1503"] -ms.assetid: e6582344-b91e-486f-baf3-4f9028d83c3b --- # BSCMAKE Error BK1503 -cannot write to file 'filename' [: reason] +> cannot write to file 'filename' [: reason] + +## Remarks BSCMAKE combines the .sbr files generated during compilation into one browser database. If the resulting browser database exceeds 64 MB, or if the number of input (.sbr) files exceeds 4092, this error will be emitted. diff --git a/docs/error-messages/tool-errors/bscmake-error-bk1504.md b/docs/error-messages/tool-errors/bscmake-error-bk1504.md index ec37c7671e0..80c657373fe 100644 --- a/docs/error-messages/tool-errors/bscmake-error-bk1504.md +++ b/docs/error-messages/tool-errors/bscmake-error-bk1504.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: BSCMAKE Error BK1504" title: "BSCMAKE Error BK1504" -ms.date: "11/04/2016" +description: "Learn more about: BSCMAKE Error BK1504" +ms.date: 11/04/2016 f1_keywords: ["BK1504"] helpviewer_keywords: ["BK1504"] -ms.assetid: e6d1a171-1472-4b7e-a04b-1a68a561675f --- # BSCMAKE Error BK1504 -cannot position in file 'filename' [: reason] +> cannot position in file 'filename' [: reason] + +## Remarks BSCMAKE could not move to a location in the file. diff --git a/docs/error-messages/tool-errors/bscmake-error-bk1505.md b/docs/error-messages/tool-errors/bscmake-error-bk1505.md index 5d63471bec0..2b06a6fcb9b 100644 --- a/docs/error-messages/tool-errors/bscmake-error-bk1505.md +++ b/docs/error-messages/tool-errors/bscmake-error-bk1505.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: BSCMAKE Error BK1505" title: "BSCMAKE Error BK1505" -ms.date: "11/04/2016" +description: "Learn more about: BSCMAKE Error BK1505" +ms.date: 11/04/2016 f1_keywords: ["BK1505"] helpviewer_keywords: ["BK1505"] -ms.assetid: a25765f8-e950-4ca8-9f16-419d779e2744 --- # BSCMAKE Error BK1505 -cannot read from file 'filename' [: reason] +> cannot read from file 'filename' [: reason] + +## Remarks BSCMAKE cannot read from the file. diff --git a/docs/error-messages/tool-errors/bscmake-error-bk1506.md b/docs/error-messages/tool-errors/bscmake-error-bk1506.md index 158a93e679f..b95c897bc0a 100644 --- a/docs/error-messages/tool-errors/bscmake-error-bk1506.md +++ b/docs/error-messages/tool-errors/bscmake-error-bk1506.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: BSCMAKE Error BK1506" title: "BSCMAKE Error BK1506" -ms.date: "11/04/2016" +description: "Learn more about: BSCMAKE Error BK1506" +ms.date: 11/04/2016 f1_keywords: ["BK1506"] helpviewer_keywords: ["BK1506"] -ms.assetid: f51f8cea-f8fc-4323-bcf2-b7bd119792ee --- # BSCMAKE Error BK1506 -cannot open file 'filename' [: reason] +> cannot open file 'filename' [: reason] + +## Remarks BSCMAKE cannot open the file. diff --git a/docs/error-messages/tool-errors/bscmake-error-bk1507.md b/docs/error-messages/tool-errors/bscmake-error-bk1507.md index 6ad648f99d8..520aed46343 100644 --- a/docs/error-messages/tool-errors/bscmake-error-bk1507.md +++ b/docs/error-messages/tool-errors/bscmake-error-bk1507.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: BSCMAKE Error BK1507" title: "BSCMAKE Error BK1507" -ms.date: "11/04/2016" +description: "Learn more about: BSCMAKE Error BK1507" +ms.date: 11/04/2016 f1_keywords: ["BK1507"] helpviewer_keywords: ["BK1507"] -ms.assetid: 3c5220d7-ccb3-45b4-9da0-cb06147311f6 --- # BSCMAKE Error BK1507 -cannot open temporary file 'filename' [: reason] +> cannot open temporary file 'filename' [: reason] + +## Remarks BSCMAKE cannot open a temporary file. diff --git a/docs/error-messages/tool-errors/bscmake-error-bk1508.md b/docs/error-messages/tool-errors/bscmake-error-bk1508.md index 1e278052eca..123e73b57ce 100644 --- a/docs/error-messages/tool-errors/bscmake-error-bk1508.md +++ b/docs/error-messages/tool-errors/bscmake-error-bk1508.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: BSCMAKE Error BK1508" title: "BSCMAKE Error BK1508" -ms.date: "11/04/2016" +description: "Learn more about: BSCMAKE Error BK1508" +ms.date: 11/04/2016 f1_keywords: ["BK1508"] helpviewer_keywords: ["BK1508"] -ms.assetid: 03ea22b8-c7b4-4e73-8553-35b41112e066 --- # BSCMAKE Error BK1508 -cannot delete temporary file 'filename' [: reason] +> cannot delete temporary file 'filename' [: reason] + +## Remarks BSCMAKE cannot delete one of its temporary files. diff --git a/docs/error-messages/tool-errors/bscmake-error-bk1509.md b/docs/error-messages/tool-errors/bscmake-error-bk1509.md index c998612a2ef..b25c7cf5d4a 100644 --- a/docs/error-messages/tool-errors/bscmake-error-bk1509.md +++ b/docs/error-messages/tool-errors/bscmake-error-bk1509.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: BSCMAKE Error BK1509" title: "BSCMAKE Error BK1509" -ms.date: "11/04/2016" +description: "Learn more about: BSCMAKE Error BK1509" +ms.date: 11/04/2016 f1_keywords: ["BK1509"] helpviewer_keywords: ["BK1509"] -ms.assetid: 53df7037-1913-4b63-b425-c0bf44081792 --- # BSCMAKE Error BK1509 -out of heap space +> out of heap space + +## Remarks BSCMAKE ran out of memory, including virtual memory. diff --git a/docs/error-messages/tool-errors/bscmake-error-bk1510.md b/docs/error-messages/tool-errors/bscmake-error-bk1510.md index c4ec735b4ff..59159959d58 100644 --- a/docs/error-messages/tool-errors/bscmake-error-bk1510.md +++ b/docs/error-messages/tool-errors/bscmake-error-bk1510.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: BSCMAKE Error BK1510" title: "BSCMAKE Error BK1510" -ms.date: "11/04/2016" +description: "Learn more about: BSCMAKE Error BK1510" +ms.date: 11/04/2016 f1_keywords: ["BK1510"] helpviewer_keywords: ["BK1510"] -ms.assetid: e67290c0-58cf-44da-ad01-f8dffc34ea2d --- # BSCMAKE Error BK1510 -corrupt .SBR file filename +> corrupt .SBR file filename + +## Remarks The given .sbr file does not have the expected format. Recompile to create a new .sbr. diff --git a/docs/error-messages/tool-errors/bscmake-error-bk1512.md b/docs/error-messages/tool-errors/bscmake-error-bk1512.md index 0b701544058..912758c02a0 100644 --- a/docs/error-messages/tool-errors/bscmake-error-bk1512.md +++ b/docs/error-messages/tool-errors/bscmake-error-bk1512.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: BSCMAKE Error BK1512" title: "BSCMAKE Error BK1512" -ms.date: "11/04/2016" +description: "Learn more about: BSCMAKE Error BK1512" +ms.date: 11/04/2016 f1_keywords: ["BK1512"] helpviewer_keywords: ["BK1512"] -ms.assetid: 0a626ff3-63db-4797-abe4-31545ce2c2c1 --- # BSCMAKE Error BK1512 -filename: capacity exceeded +> filename: capacity exceeded + +## Remarks BSCMAKE cannot build a browse information file because the number of definitions, references, modules, or other information exceeds the limit. diff --git a/docs/error-messages/tool-errors/bscmake-error-bk1513.md b/docs/error-messages/tool-errors/bscmake-error-bk1513.md index 0ebe59771f8..c08f45b6cce 100644 --- a/docs/error-messages/tool-errors/bscmake-error-bk1513.md +++ b/docs/error-messages/tool-errors/bscmake-error-bk1513.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: BSCMAKE Error BK1513" title: "BSCMAKE Error BK1513" -ms.date: "11/04/2016" +description: "Learn more about: BSCMAKE Error BK1513" +ms.date: 11/04/2016 f1_keywords: ["BK1513"] helpviewer_keywords: ["BK1513"] -ms.assetid: 9ba87c09-8d82-4c80-b0cf-a8de63dcf9da --- # BSCMAKE Error BK1513 -nonincremental update requires all .SBR files +> nonincremental update requires all .SBR files + +## Remarks BSCMAKE cannot build a new browse information (.bsc) file because one or more .sbr files are truncated. To find the names of the truncated .sbr files, read the [BK4502](../../error-messages/tool-errors/bscmake-warning-bk4502.md) warnings that accompany this error. diff --git a/docs/error-messages/tool-errors/bscmake-error-bk1514.md b/docs/error-messages/tool-errors/bscmake-error-bk1514.md index ab008394b13..4ee5c208140 100644 --- a/docs/error-messages/tool-errors/bscmake-error-bk1514.md +++ b/docs/error-messages/tool-errors/bscmake-error-bk1514.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: BSCMAKE Error BK1514" title: "BSCMAKE Error BK1514" -ms.date: "11/04/2016" +description: "Learn more about: BSCMAKE Error BK1514" +ms.date: 11/04/2016 f1_keywords: ["BK1514"] helpviewer_keywords: ["BK1514"] -ms.assetid: 7c7e2504-a490-44ab-bb1f-47385ee2f4b0 --- # BSCMAKE Error BK1514 -all .SBR files truncated, none found in filename +> all .SBR files truncated, none found in filename + +## Remarks None of the .sbr files specified for an update were part of the original browse information (.bsc) file. To find the names of the .sbr files that caused this error, read the [BK4502](../../error-messages/tool-errors/bscmake-warning-bk4502.md) warnings that precede it. diff --git a/docs/error-messages/tool-errors/bscmake-error-bk1515.md b/docs/error-messages/tool-errors/bscmake-error-bk1515.md index 23050c88db7..d0a082d2e7a 100644 --- a/docs/error-messages/tool-errors/bscmake-error-bk1515.md +++ b/docs/error-messages/tool-errors/bscmake-error-bk1515.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: BSCMAKE Error BK1515" title: "BSCMAKE Error BK1515" -ms.date: "11/04/2016" +description: "Learn more about: BSCMAKE Error BK1515" +ms.date: 11/04/2016 f1_keywords: ["BK1515"] helpviewer_keywords: ["BK1515"] -ms.assetid: 4cf2aedb-10c4-4ae8-abe6-c681fd4d617d --- # BSCMAKE Error BK1515 -bscfile: incompatible version: cannot incrementally update +> bscfile: incompatible version: cannot incrementally update + +## Remarks The .bsc file was created with another version of BSCMAKE. Recreate the .bsc file. diff --git a/docs/error-messages/tool-errors/bscmake-error-bk1516.md b/docs/error-messages/tool-errors/bscmake-error-bk1516.md index a21e9704718..2b9fce5d192 100644 --- a/docs/error-messages/tool-errors/bscmake-error-bk1516.md +++ b/docs/error-messages/tool-errors/bscmake-error-bk1516.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: BSCMAKE Error BK1516" title: "BSCMAKE Error BK1516" -ms.date: "11/04/2016" +description: "Learn more about: BSCMAKE Error BK1516" +ms.date: 11/04/2016 f1_keywords: ["BK1516"] helpviewer_keywords: ["BK1516"] -ms.assetid: 7f4a8391-f857-4ee8-8e26-34868ca84e29 --- # BSCMAKE Error BK1516 -bscfile corrupt; cannot incrementally update +> bscfile corrupt; cannot incrementally update + +## Remarks The .bsc file was corrupted, possibly due to a system failure during the build. Delete the .bsc file, rebuild all .sbr files, then rebuild the .bsc file. diff --git a/docs/error-messages/tool-errors/bscmake-error-bk1517.md b/docs/error-messages/tool-errors/bscmake-error-bk1517.md index a8d301b2354..e4a4b9fa70f 100644 --- a/docs/error-messages/tool-errors/bscmake-error-bk1517.md +++ b/docs/error-messages/tool-errors/bscmake-error-bk1517.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: BSCMAKE Error BK1517" title: "BSCMAKE Error BK1517" -ms.date: "11/04/2016" +description: "Learn more about: BSCMAKE Error BK1517" +ms.date: 11/04/2016 f1_keywords: ["BK1517"] helpviewer_keywords: ["BK1517"] -ms.assetid: 24391f42-0a3e-40a9-9991-c8b9a6a7b1c7 --- # BSCMAKE Error BK1517 -source file for sbrfile compiled with both /Yc and /Yu +> source file for sbrfile compiled with both /Yc and /Yu + +## Remarks The .sbr file refers to itself. It was probably recompiled with /Yu after compiling with /Yc. Reset the compiler option for the source file to /Yc, then select **Rebuild** to generate new .sbr files. Do not recompile the source file with /Yu. diff --git a/docs/error-messages/tool-errors/bscmake-errors-bk1500-through-bk4505.md b/docs/error-messages/tool-errors/bscmake-errors-bk1500-through-bk4505.md index cf53a0fd929..59030414a39 100644 --- a/docs/error-messages/tool-errors/bscmake-errors-bk1500-through-bk4505.md +++ b/docs/error-messages/tool-errors/bscmake-errors-bk1500-through-bk4505.md @@ -1,39 +1,42 @@ --- -description: "Learn more about: BSCMAKE errors and warnings (BKxxxx)" title: "BSCMAKE errors and warnings" -ms.date: "04/16/2019" -ms.assetid: 3767baa6-e639-472e-99fd-7543fd945cd3 +description: "Learn more about: BSCMAKE errors and warnings (BKxxxx)" +ms.date: 04/16/2019 --- # BSCMAKE errors and warnings (BKxxxx) This section is a reference to the errors and warnings generated by the BSCMAKE build tool. BSCMAKE errors and warnings have the form BK*xxxx*, where *xxxx* is a four-digit number. -[!INCLUDE[error-boilerplate](../../error-messages/includes/error-boilerplate.md)] +[!INCLUDE[error-boilerplate](../includes/error-boilerplate.md)] ## Error messages -[BSCMAKE error BK1503](bscmake-error-bk1503.md) \ -[BSCMAKE error BK1504](bscmake-error-bk1504.md) \ -[BSCMAKE error BK1505](bscmake-error-bk1505.md) \ -[BSCMAKE error BK1506](bscmake-error-bk1506.md) \ -[BSCMAKE error BK1507](bscmake-error-bk1507.md) \ -[BSCMAKE error BK1508](bscmake-error-bk1508.md) \ -[BSCMAKE error BK1509](bscmake-error-bk1509.md) \ -[BSCMAKE error BK1510](bscmake-error-bk1510.md) \ -[BSCMAKE error BK1512](bscmake-error-bk1512.md) \ -[BSCMAKE error BK1513](bscmake-error-bk1513.md) \ -[BSCMAKE error BK1514](bscmake-error-bk1514.md) \ -[BSCMAKE error BK1515](bscmake-error-bk1515.md) \ -[BSCMAKE error BK1516](bscmake-error-bk1516.md) \ -[BSCMAKE error BK1517](bscmake-error-bk1517.md) +| Error | Message | +|--|--| +| [BSCMAKE error BK1503](bscmake-error-bk1503.md) | cannot write to file 'filename' [: reason] | +| [BSCMAKE error BK1504](bscmake-error-bk1504.md) | cannot position in file 'filename' [: reason] | +| [BSCMAKE error BK1505](bscmake-error-bk1505.md) | cannot read from file 'filename' [: reason] | +| [BSCMAKE error BK1506](bscmake-error-bk1506.md) | cannot open file 'filename' [: reason] | +| [BSCMAKE error BK1507](bscmake-error-bk1507.md) | cannot open temporary file 'filename' [: reason] | +| [BSCMAKE error BK1508](bscmake-error-bk1508.md) | cannot delete temporary file 'filename' [: reason] | +| [BSCMAKE error BK1509](bscmake-error-bk1509.md) | out of heap space | +| [BSCMAKE error BK1510](bscmake-error-bk1510.md) | corrupt .SBR file filename | +| [BSCMAKE error BK1512](bscmake-error-bk1512.md) | filename: capacity exceeded | +| [BSCMAKE error BK1513](bscmake-error-bk1513.md) | nonincremental update requires all .SBR files | +| [BSCMAKE error BK1514](bscmake-error-bk1514.md) | all .SBR files truncated, none found in filename | +| [BSCMAKE error BK1515](bscmake-error-bk1515.md) | bscfile: incompatible version: cannot incrementally update | +| [BSCMAKE error BK1516](bscmake-error-bk1516.md) | bscfile corrupt; cannot incrementally update | +| [BSCMAKE error BK1517](bscmake-error-bk1517.md) | source file for sbrfile compiled with both /Yc and /Yu | ## Warning messages -[BSCMAKE warning BK4502](bscmake-warning-bk4502.md) \ -[BSCMAKE warning BK4503](bscmake-warning-bk4503.md) \ -[BSCMAKE warning BK4504](bscmake-warning-bk4504.md) +| Warning | Message | +|--|--| +| [BSCMAKE warning BK4502](bscmake-warning-bk4502.md) | truncated .SBR file 'filename' not in filename | +| [BSCMAKE warning BK4503](bscmake-warning-bk4503.md) | minor error in .SBR file filename ignored | +| [BSCMAKE warning BK4504](bscmake-warning-bk4504.md) | file contains too many references; ignoring further references from this source | ## See also -[C/C++ Compiler and build tools errors and warnings](../compiler-errors-1/c-cpp-build-errors.md) \ +[C/C++ Compiler and build tools errors and warnings](../compiler-errors-1/c-cpp-build-errors.md)\ [BSCMake reference](../../build/reference/bscmake-reference.md) diff --git a/docs/error-messages/tool-errors/bscmake-warning-bk4502.md b/docs/error-messages/tool-errors/bscmake-warning-bk4502.md index 3833aaf85e3..611b37bdcf7 100644 --- a/docs/error-messages/tool-errors/bscmake-warning-bk4502.md +++ b/docs/error-messages/tool-errors/bscmake-warning-bk4502.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: BSCMAKE Warning BK4502" title: "BSCMAKE Warning BK4502" -ms.date: "11/04/2016" +description: "Learn more about: BSCMAKE Warning BK4502" +ms.date: 11/04/2016 f1_keywords: ["BK4502"] helpviewer_keywords: ["BK4502"] -ms.assetid: ee412ec8-df03-4cdb-91ee-5d609ded8691 --- # BSCMAKE Warning BK4502 -truncated .SBR file 'filename' not in filename +> truncated .SBR file 'filename' not in filename + +## Remarks A zero-length .sbr file that was not originally part of the .bsc file was specified during an update. diff --git a/docs/error-messages/tool-errors/bscmake-warning-bk4503.md b/docs/error-messages/tool-errors/bscmake-warning-bk4503.md index cf38c46292b..3baa637cf37 100644 --- a/docs/error-messages/tool-errors/bscmake-warning-bk4503.md +++ b/docs/error-messages/tool-errors/bscmake-warning-bk4503.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: BSCMAKE Warning BK4503" title: "BSCMAKE Warning BK4503" -ms.date: "11/04/2016" +description: "Learn more about: BSCMAKE Warning BK4503" +ms.date: 11/04/2016 f1_keywords: ["BK4503"] helpviewer_keywords: ["BK4503"] -ms.assetid: 68abcf23-6987-4bc5-9745-8b65d2578bbc --- # BSCMAKE Warning BK4503 -minor error in .SBR file filename ignored +> minor error in .SBR file filename ignored + +## Remarks The .sbr file contained an error that did not halt the build, but the resulting .bsc file may be incorrect. To fix this issue, recompile to create a new .sbr. diff --git a/docs/error-messages/tool-errors/bscmake-warning-bk4504.md b/docs/error-messages/tool-errors/bscmake-warning-bk4504.md index 7bb4fbdd2d2..de69a7e2c05 100644 --- a/docs/error-messages/tool-errors/bscmake-warning-bk4504.md +++ b/docs/error-messages/tool-errors/bscmake-warning-bk4504.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: BSCMAKE Warning BK4504" title: "BSCMAKE Warning BK4504" -ms.date: "11/04/2016" +description: "Learn more about: BSCMAKE Warning BK4504" +ms.date: 11/04/2016 f1_keywords: ["BK4504"] helpviewer_keywords: ["BK4504"] -ms.assetid: b56ee2d4-ad44-40f4-98c0-75934ea44a6c --- # BSCMAKE Warning BK4504 -file contains too many references; ignoring further references from this source +> file contains too many references; ignoring further references from this source + +## Remarks The .cpp file contains more than 64,000 symbol references. When BSCMAKE has encountered 64,000 references in a file, it ignores all further references. diff --git a/docs/error-messages/tool-errors/c-runtime-error-r6002.md b/docs/error-messages/tool-errors/c-runtime-error-r6002.md index c6ecb60c462..99e8028297a 100644 --- a/docs/error-messages/tool-errors/c-runtime-error-r6002.md +++ b/docs/error-messages/tool-errors/c-runtime-error-r6002.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: C Runtime Error R6002" title: "C Runtime Error R6002" -ms.date: "11/04/2016" +description: "Learn more about: C Runtime Error R6002" +ms.date: 11/04/2016 f1_keywords: ["R6002"] helpviewer_keywords: ["R6002"] -ms.assetid: 8fbbe65a-9c43-459e-8342-e1f6d1cef7d0 --- # C Runtime Error R6002 -floating-point support not loaded +> floating-point support not loaded + +## Remarks The necessary floating-point library was not linked. diff --git a/docs/error-messages/tool-errors/c-runtime-error-r6008.md b/docs/error-messages/tool-errors/c-runtime-error-r6008.md index 16ca16630ab..d2cd9fc478a 100644 --- a/docs/error-messages/tool-errors/c-runtime-error-r6008.md +++ b/docs/error-messages/tool-errors/c-runtime-error-r6008.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: C Runtime Error R6008" title: "C Runtime Error R6008" -ms.date: "11/04/2016" +description: "Learn more about: C Runtime Error R6008" +ms.date: 11/04/2016 f1_keywords: ["R6008"] helpviewer_keywords: ["R6008"] -ms.assetid: f0f304fc-709a-4843-bc7e-bad1ae0d1649 --- # C Runtime Error R6008 -not enough space for arguments +> not enough space for arguments + +## Remarks > [!NOTE] > If you encounter this error message while running an app, the app was shut down because it has an internal memory problem. There are several possible reasons for this error, but often it's caused by an extremely low memory condition, too much memory taken by environment variables, or a bug in the program. diff --git a/docs/error-messages/tool-errors/c-runtime-error-r6009.md b/docs/error-messages/tool-errors/c-runtime-error-r6009.md index 9b67d996f5f..e064cc34025 100644 --- a/docs/error-messages/tool-errors/c-runtime-error-r6009.md +++ b/docs/error-messages/tool-errors/c-runtime-error-r6009.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: C Runtime Error R6009" title: "C Runtime Error R6009" -ms.date: "11/04/2016" +description: "Learn more about: C Runtime Error R6009" +ms.date: 11/04/2016 f1_keywords: ["R6009"] helpviewer_keywords: ["R6009"] -ms.assetid: edfb1f8b-3807-48f4-a994-318923b747ae --- # C Runtime Error R6009 -not enough space for environment +> not enough space for environment + +## Remarks > [!NOTE] > If you encounter this error message while running an app, the app was shut down because it has an internal memory problem. There are several possible reasons for this error, but often it's caused by an extremely low memory condition, too much memory taken by environment variables, or a bug in the program. diff --git a/docs/error-messages/tool-errors/c-runtime-error-r6016.md b/docs/error-messages/tool-errors/c-runtime-error-r6016.md index 245c9bae9df..2398a1e6028 100644 --- a/docs/error-messages/tool-errors/c-runtime-error-r6016.md +++ b/docs/error-messages/tool-errors/c-runtime-error-r6016.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: C Runtime Error R6016" title: "C Runtime Error R6016" -ms.date: "11/04/2016" +description: "Learn more about: C Runtime Error R6016" +ms.date: 11/04/2016 f1_keywords: ["R6016"] helpviewer_keywords: ["R6016"] -ms.assetid: 7bd3f274-d9c4-4bc4-8252-80bf168c4c3a --- # C Runtime Error R6016 -not enough space for thread data +> not enough space for thread data + +## Remarks > [!NOTE] > If you encounter this error message while running an app, the app was shut down because it has an internal memory problem. There are many possible reasons for this error, but often it's caused by an extremely low memory condition, a bug in the app, or by a bug in an add-in or extension used by the app. diff --git a/docs/error-messages/tool-errors/c-runtime-error-r6017.md b/docs/error-messages/tool-errors/c-runtime-error-r6017.md index b6c878e78a5..737bf6e90f6 100644 --- a/docs/error-messages/tool-errors/c-runtime-error-r6017.md +++ b/docs/error-messages/tool-errors/c-runtime-error-r6017.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: C Runtime Error R6017" title: "C Runtime Error R6017" -ms.date: "11/04/2016" +description: "Learn more about: C Runtime Error R6017" +ms.date: 11/04/2016 f1_keywords: ["R6017"] helpviewer_keywords: ["R6017"] -ms.assetid: df3ec5f5-6771-4648-ba06-0e26c6a1cc6a --- # C Runtime Error R6017 -unexpected multithread lock error +> unexpected multithread lock error + +## Remarks > [!NOTE] > If you encounter this error message while running an app, the app was shut down because it has an internal problem. There are several possible reasons for this error, but often it's caused by a defect in the app's code. diff --git a/docs/error-messages/tool-errors/c-runtime-error-r6018.md b/docs/error-messages/tool-errors/c-runtime-error-r6018.md index 97361514101..e2010a13a18 100644 --- a/docs/error-messages/tool-errors/c-runtime-error-r6018.md +++ b/docs/error-messages/tool-errors/c-runtime-error-r6018.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: C Runtime Error R6018" title: "C Runtime Error R6018" -ms.date: "11/04/2016" +description: "Learn more about: C Runtime Error R6018" +ms.date: 11/04/2016 f1_keywords: ["R6018"] helpviewer_keywords: ["R6018"] -ms.assetid: f6dd40d1-a119-4d8b-b39e-97350ea23349 --- # C Runtime Error R6018 -unexpected heap error +> unexpected heap error + +## Remarks > [!NOTE] > If you encounter this error message while running an app, the app was shut down because it has an internal problem. There are several possible reasons for this error, but often it's caused by a defect in the app's code. diff --git a/docs/error-messages/tool-errors/c-runtime-error-r6019.md b/docs/error-messages/tool-errors/c-runtime-error-r6019.md index 5c5bd53c170..51987fa5a60 100644 --- a/docs/error-messages/tool-errors/c-runtime-error-r6019.md +++ b/docs/error-messages/tool-errors/c-runtime-error-r6019.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: C Runtime Error R6019" title: "C Runtime Error R6019" -ms.date: "11/04/2016" +description: "Learn more about: C Runtime Error R6019" +ms.date: 11/04/2016 f1_keywords: ["R6019"] helpviewer_keywords: ["R6019"] -ms.assetid: 8129923e-7db2-40ee-9602-def9365f8d28 --- # C Runtime Error R6019 -unable to open console device +> unable to open console device + +## Remarks > [!NOTE] > If you encounter this error message while running an app, the app was shut down because it attempted to access the console, but it didn't have sufficient permission. There are several possible reasons for this error, but it's usually because the program must be run as an administrator, or there is a bug in the program. diff --git a/docs/error-messages/tool-errors/c-runtime-error-r6024.md b/docs/error-messages/tool-errors/c-runtime-error-r6024.md index 7df58f0607f..d9657a8a397 100644 --- a/docs/error-messages/tool-errors/c-runtime-error-r6024.md +++ b/docs/error-messages/tool-errors/c-runtime-error-r6024.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: C Runtime Error R6024" title: "C Runtime Error R6024" -ms.date: "11/04/2016" +description: "Learn more about: C Runtime Error R6024" +ms.date: 11/04/2016 f1_keywords: ["R6024"] helpviewer_keywords: ["R6024"] -ms.assetid: 0fb11c0f-9b81-4cab-81bd-4785742946a5 --- # C Runtime Error R6024 -not enough space for _onexit/atexit table +> not enough space for _onexit/atexit table + +## Remarks > [!NOTE] > If you encounter this error message while running an app, the app was shut down because it has an internal memory problem. This error is usually caused by an extremely low memory condition, or rarely, by a bug in the program or by corruption of the Visual C++ libraries that it uses. diff --git a/docs/error-messages/tool-errors/c-runtime-error-r6025.md b/docs/error-messages/tool-errors/c-runtime-error-r6025.md index 42a2c6f4a3a..c081ab74720 100644 --- a/docs/error-messages/tool-errors/c-runtime-error-r6025.md +++ b/docs/error-messages/tool-errors/c-runtime-error-r6025.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: C Runtime Error R6025" title: "C Runtime Error R6025" -ms.date: "11/04/2016" +description: "Learn more about: C Runtime Error R6025" +ms.date: 11/04/2016 f1_keywords: ["R6025"] helpviewer_keywords: ["R6025"] -ms.assetid: afa06d98-9c36-445b-b3e7-b6409bc8e779 --- # C Runtime Error R6025 -pure virtual function call +> pure virtual function call + +## Remarks > [!NOTE] > If you encounter this error message while running an app, the app was shut down because it has an internal problem. The most common reason for this error is a bug in the app, or a corrupted installation. diff --git a/docs/error-messages/tool-errors/c-runtime-error-r6026.md b/docs/error-messages/tool-errors/c-runtime-error-r6026.md index b1074266a4b..f54bf8f33ba 100644 --- a/docs/error-messages/tool-errors/c-runtime-error-r6026.md +++ b/docs/error-messages/tool-errors/c-runtime-error-r6026.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: C Runtime Error R6026" title: "C Runtime Error R6026" -ms.date: "11/04/2016" +description: "Learn more about: C Runtime Error R6026" +ms.date: 11/04/2016 f1_keywords: ["R6026"] helpviewer_keywords: ["R6026"] -ms.assetid: 7ea751f8-fc20-46ab-99ef-84c95ca0b6b4 --- # C Runtime Error R6026 -not enough space for stdio initialization +> not enough space for stdio initialization + +## Remarks > [!NOTE] > If you encounter this error message while running an app, the app was shut down because it has an internal memory problem. There are several possible reasons for this error, but usually it's caused by an extremely low memory condition. It can also be caused by a bug in the app, by corruption of the Visual C++ libraries that it uses, or by a driver. diff --git a/docs/error-messages/tool-errors/c-runtime-error-r6027.md b/docs/error-messages/tool-errors/c-runtime-error-r6027.md index 69dae0ca617..f399ec1a9ad 100644 --- a/docs/error-messages/tool-errors/c-runtime-error-r6027.md +++ b/docs/error-messages/tool-errors/c-runtime-error-r6027.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: C Runtime Error R6027" title: "C Runtime Error R6027" -ms.date: "11/04/2016" +description: "Learn more about: C Runtime Error R6027" +ms.date: 11/04/2016 f1_keywords: ["R6027"] helpviewer_keywords: ["R6027"] -ms.assetid: c06a62b3-08d9-4bf5-bcad-8340ec552f69 --- # C Runtime Error R6027 -not enough space for lowio initialization +> not enough space for lowio initialization + +## Remarks > [!NOTE] > If you encounter this error message while running an app, the app was shut down because it has an internal memory problem. There are several possible reasons for this error, but usually it's caused by an extremely low memory condition. It can also be caused by a bug in the app, by corruption of the Visual C++ libraries that it uses, or by a driver. diff --git a/docs/error-messages/tool-errors/c-runtime-error-r6028.md b/docs/error-messages/tool-errors/c-runtime-error-r6028.md index 1f93ef783ed..cb4c0697bf0 100644 --- a/docs/error-messages/tool-errors/c-runtime-error-r6028.md +++ b/docs/error-messages/tool-errors/c-runtime-error-r6028.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: C Runtime Error R6028" title: "C Runtime Error R6028" -ms.date: "11/04/2016" +description: "Learn more about: C Runtime Error R6028" +ms.date: 11/04/2016 f1_keywords: ["R6028"] helpviewer_keywords: ["R6028"] -ms.assetid: 81e99079-4388-4244-a4f7-4641c508871c --- # C Runtime Error R6028 -unable to initialize heap +> unable to initialize heap + +## Remarks > [!NOTE] > If you encounter this error message while running an app, the app was shut down because it has an internal memory problem. There are many possible reasons for this error, but often it's caused by an extremely low memory condition, a bug in the program, or by defective hardware drivers. diff --git a/docs/error-messages/tool-errors/c-runtime-error-r6030.md b/docs/error-messages/tool-errors/c-runtime-error-r6030.md index f190792505a..ad7dc5bd756 100644 --- a/docs/error-messages/tool-errors/c-runtime-error-r6030.md +++ b/docs/error-messages/tool-errors/c-runtime-error-r6030.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: C Runtime Error R6030" title: "C Runtime Error R6030" -ms.date: "11/04/2016" +description: "Learn more about: C Runtime Error R6030" +ms.date: 11/04/2016 f1_keywords: ["R6030"] helpviewer_keywords: ["R6030"] -ms.assetid: 0238a6c3-a033-4046-8adc-f8f99d961153 --- # C Runtime Error R6030 -CRT not initialized +> CRT not initialized + +## Remarks > [!NOTE] > If you encounter this error message while running an app, the app was shut down because it has an internal problem. This problem is most often caused by certain security software programs, or rarely, by a bug in the program. diff --git a/docs/error-messages/tool-errors/c-runtime-error-r6031.md b/docs/error-messages/tool-errors/c-runtime-error-r6031.md index 94855e80c82..2a362dcdfad 100644 --- a/docs/error-messages/tool-errors/c-runtime-error-r6031.md +++ b/docs/error-messages/tool-errors/c-runtime-error-r6031.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: C Runtime Error R6031" title: "C Runtime Error R6031" -ms.date: "11/04/2016" +description: "Learn more about: C Runtime Error R6031" +ms.date: 11/04/2016 f1_keywords: ["R6031"] helpviewer_keywords: ["R6031"] -ms.assetid: 805d4cd1-cb2f-43fe-87e6-e7bd5b7329c5 --- # C Runtime Error R6031 -Attempt to initialize the CRT more than once. This indicates a bug in your application. +> Attempt to initialize the CRT more than once. This indicates a bug in your application. + +## Remarks > [!NOTE] > If you encounter this error message while running an app, the app was shut down because it has an internal problem. This may be caused bug in the app, or by a bug in an add-on or extension that the app uses. diff --git a/docs/error-messages/tool-errors/c-runtime-error-r6032.md b/docs/error-messages/tool-errors/c-runtime-error-r6032.md index 85bf96da8f0..e50b73b5f87 100644 --- a/docs/error-messages/tool-errors/c-runtime-error-r6032.md +++ b/docs/error-messages/tool-errors/c-runtime-error-r6032.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: C Runtime Error R6032" title: "C Runtime Error R6032" -ms.date: "11/04/2016" +description: "Learn more about: C Runtime Error R6032" +ms.date: 11/04/2016 f1_keywords: ["R6032"] helpviewer_keywords: ["R6032"] -ms.assetid: 52092a63-cc51-444a-bfc3-fad965a3558e --- # C Runtime Error R6032 -Not enough space for locale information +> Not enough space for locale information + +## Remarks > [!NOTE] > If you encounter this error message while running an app, the app was shut down because it has an internal memory problem. There are several possible reasons for this error, but often it's caused by an extremely low memory condition, or by a bug in the program. diff --git a/docs/error-messages/tool-errors/c-runtime-error-r6033.md b/docs/error-messages/tool-errors/c-runtime-error-r6033.md index fd113c60325..b308f6db468 100644 --- a/docs/error-messages/tool-errors/c-runtime-error-r6033.md +++ b/docs/error-messages/tool-errors/c-runtime-error-r6033.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: C Runtime Error R6033" title: "C Runtime Error R6033" -ms.date: "11/04/2016" +description: "Learn more about: C Runtime Error R6033" +ms.date: 11/04/2016 f1_keywords: ["R6033"] helpviewer_keywords: ["R6033"] -ms.assetid: f9cffdc9-81bd-4a64-a698-02762cbd82c9 --- # C Runtime Error R6033 -Attempt to use MSIL code from this assembly during native code initialization. This indicates a bug in your application. It is most likely the result of calling an MSIL-compiled (/clr) function from a native constructor or from DllMain. +> Attempt to use MSIL code from this assembly during native code initialization. This indicates a bug in your application. It is most likely the result of calling an MSIL-compiled (/clr) function from a native constructor or from DllMain. + +## Remarks > [!NOTE] > If you encounter this error message while running an app, the app was shut down because it has an internal problem. This error can be caused by a bug in the app, or by a bug in an add-in or extension that it uses. diff --git a/docs/error-messages/tool-errors/c-runtime-error-r6035.md b/docs/error-messages/tool-errors/c-runtime-error-r6035.md index 7fba797b1e2..4dd704a367b 100644 --- a/docs/error-messages/tool-errors/c-runtime-error-r6035.md +++ b/docs/error-messages/tool-errors/c-runtime-error-r6035.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: C Runtime Error R6035" title: "C Runtime Error R6035" -ms.date: "11/04/2016" +description: "Learn more about: C Runtime Error R6035" +ms.date: 11/04/2016 f1_keywords: ["R6035"] helpviewer_keywords: ["R6035"] -ms.assetid: f8fb50b8-18bf-4258-b96a-b0a9de468d16 --- # C Runtime Error R6035 -Microsoft Visual C++ Runtime Library, Error R6035 - A module in this application is initializing the module's global security cookie while a function relying on that security cookie is active. Call __security_init_cookie earlier. +> A module in this application is initializing the module's global security cookie while a function relying on that security cookie is active. Call __security_init_cookie earlier. + +## Remarks [__security_init_cookie](../../c-runtime-library/reference/security-init-cookie.md) must be called before the first use of the global security cookie. @@ -16,6 +17,8 @@ The global security cookie is used for buffer overrun protection in code compile Error R6035 indicates that a call to `__security_init_cookie` was made after a protected function was entered. If execution were to continue, a spurious buffer overrun would be detected because the cookie on the stack would no longer match the global cookie. +## Example + Consider the following DLL example. The DLL entry point is set to DllEntryPoint through the linker [/ENTRY (Entry-Point Symbol)](../../build/reference/entry-entry-point-symbol.md) option. This bypasses the CRT's initialization which would ordinarily initialize the global security cookie, so the DLL itself must call `__security_init_cookie`. ``` diff --git a/docs/error-messages/tool-errors/c-runtime-errors-r6002-through-r6035.md b/docs/error-messages/tool-errors/c-runtime-errors-r6002-through-r6035.md index 97bc308ef10..8eac48f7d14 100644 --- a/docs/error-messages/tool-errors/c-runtime-errors-r6002-through-r6035.md +++ b/docs/error-messages/tool-errors/c-runtime-errors-r6002-through-r6035.md @@ -1,33 +1,36 @@ --- -description: "Learn more about: C Runtime errors (Rxxxx)" title: "C Runtime errors" -ms.date: "04/16/2019" +description: "Learn more about: C Runtime errors (Rxxxx)" +ms.date: 04/16/2019 f1_keywords: ["c.errors", "R6000", "R6003", "R6010", "R6022", "R6023", "R6034"] -ms.assetid: 78019050-9a30-4b61-8250-a5702e0e2393 --- # C Runtime errors (Rxxxx) The C Runtime library (CRT) may report a runtime error when your app is loaded or running. Even though each message refers to the Microsoft Visual C++ runtime library, it doesn't mean there's a bug in the library. These errors indicate either a bug in your app's code, or a condition that the runtime library can't handle, such as low memory. End users of your app may see these errors unless your write your app to prevent them, or to capture the errors and present a friendly error message to your users instead. -[!INCLUDE[error-boilerplate](../../error-messages/includes/error-boilerplate.md)] +[!INCLUDE[error-boilerplate](../includes/error-boilerplate.md)] ## C Runtime errors -[C Runtime Error R6002](../../error-messages/tool-errors/c-runtime-error-r6002.md) \ -[C Runtime Error R6008](../../error-messages/tool-errors/c-runtime-error-r6008.md) \ -[C Runtime Error R6009](../../error-messages/tool-errors/c-runtime-error-r6009.md) \ -[C Runtime Error R6016](../../error-messages/tool-errors/c-runtime-error-r6016.md) \ -[C Runtime Error R6017](../../error-messages/tool-errors/c-runtime-error-r6017.md) \ -[C Runtime Error R6018](../../error-messages/tool-errors/c-runtime-error-r6018.md) \ -[C Runtime Error R6019](../../error-messages/tool-errors/c-runtime-error-r6019.md) \ -[C Runtime Error R6024](../../error-messages/tool-errors/c-runtime-error-r6024.md) \ -[C Runtime Error R6025](../../error-messages/tool-errors/c-runtime-error-r6025.md) \ -[C Runtime Error R6028](../../error-messages/tool-errors/c-runtime-error-r6028.md) \ -[C Runtime Error R6030](../../error-messages/tool-errors/c-runtime-error-r6030.md) \ -[C Runtime Error R6031](../../error-messages/tool-errors/c-runtime-error-r6031.md) \ -[C Runtime Error R6032](../../error-messages/tool-errors/c-runtime-error-r6032.md) \ -[C Runtime Error R6033](../../error-messages/tool-errors/c-runtime-error-r6033.md) \ -[C Runtime Error R6035](../../error-messages/tool-errors/c-runtime-error-r6035.md) +| Error | Message | +|--|--| +| [C Runtime Error R6002](c-runtime-error-r6002.md) | floating-point support not loaded | +| [C Runtime Error R6008](c-runtime-error-r6008.md) | not enough space for arguments | +| [C Runtime Error R6009](c-runtime-error-r6009.md) | not enough space for environment | +| [C Runtime Error R6016](c-runtime-error-r6016.md) | not enough space for thread data | +| [C Runtime Error R6017](c-runtime-error-r6017.md) | unexpected multithread lock error | +| [C Runtime Error R6018](c-runtime-error-r6018.md) | unexpected heap error | +| [C Runtime Error R6019](c-runtime-error-r6019.md) | unable to open console device | +| [C Runtime Error R6024](c-runtime-error-r6024.md) | not enough space for _onexit/atexit table | +| [C Runtime Error R6025](c-runtime-error-r6025.md) | pure virtual function call | +| [C Runtime Error R6026](c-runtime-error-r6026.md) | not enough space for stdio initialization | +| [C Runtime Error R6027](c-runtime-error-r6027.md) | not enough space for lowio initialization | +| [C Runtime Error R6028](c-runtime-error-r6028.md) | unable to initialize heap | +| [C Runtime Error R6030](c-runtime-error-r6030.md) | CRT not initialized | +| [C Runtime Error R6031](c-runtime-error-r6031.md) | Attempt to initialize the CRT more than once. This indicates a bug in your application. | +| [C Runtime Error R6032](c-runtime-error-r6032.md) | Not enough space for locale information | +| [C Runtime Error R6033](c-runtime-error-r6033.md) | Attempt to use MSIL code from this assembly during native code initialization. This indicates a bug in your application. It is most likely the result of calling an MSIL-compiled (/clr) function from a native constructor or from DllMain. | +| [C Runtime Error R6035](c-runtime-error-r6035.md) | A module in this application is initializing the module's global security cookie while a function relying on that security cookie is active. Call __security_init_cookie earlier. | ## See also diff --git a/docs/error-messages/tool-errors/command-line-error-d8016.md b/docs/error-messages/tool-errors/command-line-error-d8016.md index e71b3d6cd07..6378c6f5ad7 100644 --- a/docs/error-messages/tool-errors/command-line-error-d8016.md +++ b/docs/error-messages/tool-errors/command-line-error-d8016.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Command-Line Error D8016" title: "Command-Line Error D8016" -ms.date: "11/04/2016" +description: "Learn more about: Command-Line Error D8016" +ms.date: 11/04/2016 f1_keywords: ["D8016"] helpviewer_keywords: ["D8016"] -ms.assetid: eec51312-7471-4f92-94b2-d517cafc8ef5 --- # Command-Line Error D8016 -'option1' and 'option2' command-line options are incompatible +> 'option1' and 'option2' command-line options are incompatible + +## Remarks The command-line options cannot be specified together. diff --git a/docs/error-messages/tool-errors/command-line-error-d8021.md b/docs/error-messages/tool-errors/command-line-error-d8021.md index 5daada8340c..67f23270441 100644 --- a/docs/error-messages/tool-errors/command-line-error-d8021.md +++ b/docs/error-messages/tool-errors/command-line-error-d8021.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Command-Line Error D8021" title: "Command-Line Error D8021" -ms.date: "11/04/2016" +description: "Learn more about: Command-Line Error D8021" +ms.date: 11/04/2016 f1_keywords: ["D8021"] helpviewer_keywords: ["D8021"] -ms.assetid: 8ec85441-d0d8-42d8-b777-1e4636ea9878 --- # Command-Line Error D8021 -invalid numeric argument 'number' +> invalid numeric argument 'number' + +## Remarks A number greater than 65,534 was specified as a numeric argument. diff --git a/docs/error-messages/tool-errors/command-line-error-d8022.md b/docs/error-messages/tool-errors/command-line-error-d8022.md index 0fde42f9251..430d8c3d87a 100644 --- a/docs/error-messages/tool-errors/command-line-error-d8022.md +++ b/docs/error-messages/tool-errors/command-line-error-d8022.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Command-Line Error D8022" title: "Command-Line Error D8022" -ms.date: "11/04/2016" +description: "Learn more about: Command-Line Error D8022" +ms.date: 11/04/2016 f1_keywords: ["D8022"] helpviewer_keywords: ["D8022"] -ms.assetid: eb18ec34-d32d-4636-a852-abf2063e886b --- # Command-Line Error D8022 -cannot open 'messagefile' +> cannot open 'messagefile' + +## Remarks The given file was not in the current directory or in a directory specified in the PATH environment variable. The message file contains a brief summary of compiler command-line syntax and options. diff --git a/docs/error-messages/tool-errors/command-line-error-d8027.md b/docs/error-messages/tool-errors/command-line-error-d8027.md index 9fb55846634..886b134653b 100644 --- a/docs/error-messages/tool-errors/command-line-error-d8027.md +++ b/docs/error-messages/tool-errors/command-line-error-d8027.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Command-Line Error D8027" title: "Command-Line Error D8027" -ms.date: "11/04/2016" +description: "Learn more about: Command-Line Error D8027" +ms.date: 11/04/2016 f1_keywords: ["D8027"] helpviewer_keywords: ["D8027"] -ms.assetid: f228220f-0c7f-49a6-a6e0-1f7bd4745aa6 --- # Command-Line Error D8027 -cannot execute 'component' +> cannot execute 'component' + +## Remarks The compiler could not run the given compiler component or linker. diff --git a/docs/error-messages/tool-errors/command-line-error-d8036.md b/docs/error-messages/tool-errors/command-line-error-d8036.md index 86973440583..986134ce3d3 100644 --- a/docs/error-messages/tool-errors/command-line-error-d8036.md +++ b/docs/error-messages/tool-errors/command-line-error-d8036.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Command-Line Error D8036" title: "Command-Line Error D8036" -ms.date: "11/04/2016" +description: "Learn more about: Command-Line Error D8036" +ms.date: 11/04/2016 f1_keywords: ["D8036"] helpviewer_keywords: ["D8036"] -ms.assetid: 420a8daf-1873-49cd-95ea-a603d77b9410 --- # Command-Line Error D8036 -'/option' not allowed with multiple source files +> '/option' not allowed with multiple source files + +## Remarks These compiler options cannot be used with multiple source files: diff --git a/docs/error-messages/tool-errors/command-line-error-d8037.md b/docs/error-messages/tool-errors/command-line-error-d8037.md index d85b75168da..be3f25d3a85 100644 --- a/docs/error-messages/tool-errors/command-line-error-d8037.md +++ b/docs/error-messages/tool-errors/command-line-error-d8037.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Command-Line Error D8037" title: "Command-Line Error D8037" -ms.date: "11/04/2016" +description: "Learn more about: Command-Line Error D8037" +ms.date: 11/04/2016 f1_keywords: ["D8037"] helpviewer_keywords: ["D8037"] -ms.assetid: acddaaa0-bd84-426f-a37b-8f680b379c9d --- # Command-Line Error D8037 -cannot create temporary il file; clean temp directory of old il files +> cannot create temporary il file; clean temp directory of old il files + +## Remarks There is not enough space to create temporary compiler intermediate files. To remedy this error, remove any old MSIL files in the directory specified by the **TMP** environment variable. These files will be of the form _CL_hhhhhhhh.ss, where h represents a random hexadecimal digit and ss represents the type of IL file. Also, be sure to update your machine with the latest operating system patches. diff --git a/docs/error-messages/tool-errors/command-line-error-d8045.md b/docs/error-messages/tool-errors/command-line-error-d8045.md index fad1a656cf8..0297b0dbfcc 100644 --- a/docs/error-messages/tool-errors/command-line-error-d8045.md +++ b/docs/error-messages/tool-errors/command-line-error-d8045.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Command-Line Error D8045" title: "Command-Line Error D8045" -ms.date: "11/04/2016" +description: "Learn more about: Command-Line Error D8045" +ms.date: 11/04/2016 f1_keywords: ["D8045"] helpviewer_keywords: ["D8045"] -ms.assetid: 01c8808c-bac1-4b4d-8a90-b595f95e9318 --- # Command-Line Error D8045 -cannot compile C file 'file' with the /clr option +> cannot compile C file 'file' with the /clr option + +## Remarks Only C++ source code files can be passed to a compilation that uses **/clr**. Use **/TP** to compile a .c file as a .cpp file; see [/Tc, /Tp, /TC, /TP (Specify Source File Type)](../../build/reference/tc-tp-tc-tp-specify-source-file-type.md) for more information. diff --git a/docs/error-messages/tool-errors/command-line-error-d8048.md b/docs/error-messages/tool-errors/command-line-error-d8048.md index 65fa5514cab..39dcd944558 100644 --- a/docs/error-messages/tool-errors/command-line-error-d8048.md +++ b/docs/error-messages/tool-errors/command-line-error-d8048.md @@ -1,6 +1,6 @@ --- -description: "Learn about causes and solutions for command-line error D8048" title: "Command-Line Error D8048" +description: "Learn about causes and solutions for command-line error D8048" ms.date: 04/18/2021 f1_keywords: ["D8048"] helpviewer_keywords: ["D8048"] @@ -9,10 +9,10 @@ helpviewer_keywords: ["D8048"] > cannot compile C file '*file-name*' with /ZW option -Only C++ source code files can be passed to the compiler when you use the [`/ZW` (Windows Runtime compilation)](../../build/reference/zw-windows-runtime-compilation.md) compiler option. - ## Remarks +Only C++ source code files can be passed to the compiler when you use the [`/ZW` (Windows Runtime compilation)](../../build/reference/zw-windows-runtime-compilation.md) compiler option. + By default, all files in a C++ Universal Windows platform (UWP) project are compiled by using the **`/ZW`** compiler option. The **`/ZW`** option enables the Windows Runtime compiler extensions, or C++/CX. Unfortunately, **`/ZW`** doesn't work on C source files. You can disable C++/CX compilation selectively for C files in Visual Studio projects. Select your C file in Solution Explorer, then right-click to choose **Properties** from the shortcut menu. In the **Property Pages** dialog, select the **Configuration Properties** > **C/C++** -> **General** property page. Set the **Consume Windows Runtime Extension** property to *`No`*. Choose **OK** to save your changes. diff --git a/docs/error-messages/tool-errors/command-line-error-d8049.md b/docs/error-messages/tool-errors/command-line-error-d8049.md index ec848363813..24c359f7583 100644 --- a/docs/error-messages/tool-errors/command-line-error-d8049.md +++ b/docs/error-messages/tool-errors/command-line-error-d8049.md @@ -1,6 +1,6 @@ --- -description: "Learn about the cause and solutions for command-line error D8049" title: "Command-Line Error D8049" +description: "Learn about the cause and solutions for command-line error D8049" ms.date: 10/28/2021 f1_keywords: ["D8049"] helpviewer_keywords: ["D8049"] @@ -9,10 +9,10 @@ helpviewer_keywords: ["D8049"] > cannot execute '*compiler-component*': command line is too long to fit in debug record -An internal length limit on debug record include paths was exceeded. - ## Remarks +An internal length limit on debug record include paths was exceeded. + When the compiler creates debug records in an object file, it uses the full path for each included file. Absolute paths are recorded as specified. For relative include paths, the debug record prepends the build's current working directory to the relative path. If your build runs in a relatively deep path, the corresponding path records get longer. The total length of too many long paths can exceed the internal limits of the compiler. ## To resolve this issue diff --git a/docs/error-messages/tool-errors/command-line-errors-d8000-through-d9999.md b/docs/error-messages/tool-errors/command-line-errors-d8000-through-d9999.md index 5eb48e048e6..14a992e335f 100644 --- a/docs/error-messages/tool-errors/command-line-errors-d8000-through-d9999.md +++ b/docs/error-messages/tool-errors/command-line-errors-d8000-through-d9999.md @@ -1,39 +1,43 @@ --- -description: "Learn more about: Command-line errors and warnings" title: "Command-line errors and warnings" -ms.date: "04/17/2019" -ms.assetid: d02ec7df-26a5-4198-ac92-87b29ec9d5c8 +description: "Learn more about: Command-line errors and warnings" +ms.date: 04/17/2019 --- # Command-line errors and warnings The articles in this section provide a reference to the command-line errors and warnings generated by the build tools. These messages have the form `Dxxxx`, where *xxxx* is a four-digit number. -[!INCLUDE[error-boilerplate](../../error-messages/includes/error-boilerplate.md)] +[!INCLUDE[error-boilerplate](../includes/error-boilerplate.md)] ## Command-line error messages -[Command-Line Error D8016](../../error-messages/tool-errors/command-line-error-d8016.md) \ -[Command-Line Error D8021](../../error-messages/tool-errors/command-line-error-d8021.md) \ -[Command-Line Error D8022](../../error-messages/tool-errors/command-line-error-d8022.md) \ -[Command-Line Error D8027](../../error-messages/tool-errors/command-line-error-d8027.md) \ -[Command-Line Error D8036](../../error-messages/tool-errors/command-line-error-d8036.md) \ -[Command-Line Error D8037](../../error-messages/tool-errors/command-line-error-d8037.md) \ -[Command-Line Error D8045](../../error-messages/tool-errors/command-line-error-d8045.md) \ -[Command-Line Error D8048](../../error-messages/tool-errors/command-line-error-d8048.md) \ -[Command-Line Error D8049](../../error-messages/tool-errors/command-line-error-d8049.md) +| Error | Message | +|--|--| +| [Command-Line Error D8016](command-line-error-d8016.md) | 'option1' and 'option2' command-line options are incompatible | +| [Command-Line Error D8021](command-line-error-d8021.md) | invalid numeric argument 'number' | +| [Command-Line Error D8022](command-line-error-d8022.md) | cannot open 'messagefile' | +| [Command-Line Error D8027](command-line-error-d8027.md) | cannot execute 'component' | +| [Command-Line Error D8036](command-line-error-d8036.md) | '/option' not allowed with multiple source files | +| [Command-Line Error D8037](command-line-error-d8037.md) | cannot create temporary il file; clean temp directory of old il files | +| [Command-Line Error D8045](command-line-error-d8045.md) | cannot compile C file 'file' with the /clr option | +| [Command-Line Error D8048](command-line-error-d8048.md) | cannot compile C file '*file-name*' with /ZW option | +| [Command-Line Error D8049](command-line-error-d8049.md) | cannot execute '*compiler-component*': command line is too long to fit in debug record | ## Command-line warning messages -[Command-Line Warning D9024](../../error-messages/tool-errors/command-line-warning-d9024.md) \ -[Command-Line Warning D9025](../../error-messages/tool-errors/command-line-warning-d9025.md) \ -[Command-Line Warning D9026](../../error-messages/tool-errors/command-line-warning-d9026.md) \ -[Command-Line Warning D9027](../../error-messages/tool-errors/command-line-warning-d9027.md) \ -[Command-Line Warning D9028](../../error-messages/tool-errors/command-line-warning-d9028.md) \ -[Command-Line Warning D9035](../../error-messages/tool-errors/command-line-warning-d9035.md) \ -[Command-Line Warning D9036](../../error-messages/tool-errors/command-line-warning-d9036.md) \ -[Command-Line Warning D9040](../../error-messages/tool-errors/command-line-warning-d9040.md) \ -[Command-Line Warning D9041](../../error-messages/tool-errors/command-line-warning-d9041.md) \ -[Command-Line Warning D9043](../../error-messages/tool-errors/command-line-warning-d9043.md) +| Warning | Message | +|--|--| +| Command-Line Warning D9014 | invalid value for 'processMax'. The compiler ignores the invalid value and assumes a value of 1.| +| [Command-Line Warning D9024](command-line-warning-d9024.md) | unrecognized source file type 'filename', object file assumed. Occurs when a command‑line argument looks like a filename but doesn’t match a recognized source or object file extension. The compiler assumes it's an object file and passes it to the linker. | +| [Command-Line Warning D9025](command-line-warning-d9025.md) | overriding 'option1' with 'option2' | +| [Command-Line Warning D9026](command-line-warning-d9026.md) | options apply to entire command line | +| [Command-Line Warning D9027](command-line-warning-d9027.md) | source file '\' ignored | +| [Command-Line Warning D9028](command-line-warning-d9028.md) | minimal rebuild failure, reverting to normal build | +| [Command-Line Warning D9035](command-line-warning-d9035.md) | option '*option*' has been deprecated and will be removed in a future release | +| [Command-Line Warning D9036](command-line-warning-d9036.md) | '*option\_2*' instead of '*option\_1*' | +| [Command-Line Warning D9040](command-line-warning-d9040.md) | ignoring option '/analyze'; Code Analysis warnings are not available in this edition of the compiler | +| [Command-Line Warning D9041](command-line-warning-d9041.md) | invalid value '*option-value*' for '/*option-name*'; assuming '*assumed-value*'; add '/analyze' to command-line options when specifying this warning | +| [Command-Line Warning D9043](command-line-warning-d9043.md) | invalid value 'warning_level' for 'compiler_option'; assuming '4999'; Code Analysis warnings are not associated with warning levels | ## See also diff --git a/docs/error-messages/tool-errors/command-line-warning-d9024.md b/docs/error-messages/tool-errors/command-line-warning-d9024.md index e161eb89438..5af7073689e 100644 --- a/docs/error-messages/tool-errors/command-line-warning-d9024.md +++ b/docs/error-messages/tool-errors/command-line-warning-d9024.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Command-Line Warning D9024" title: "Command-Line Warning D9024" -ms.date: "11/04/2016" +description: "Learn more about: Command-Line Warning D9024" +ms.date: 11/04/2016 f1_keywords: ["D9024"] helpviewer_keywords: ["D9024"] -ms.assetid: daf4896d-223d-4af0-9b6d-89109cf3d1bb --- # Command-Line Warning D9024 -unrecognized source file type 'filename', object file assumed +> unrecognized source file type 'filename', object file assumed + +## Remarks The extension of the specified file was not recognized. The file was assumed to be an object file and was passed to the linker. diff --git a/docs/error-messages/tool-errors/command-line-warning-d9025.md b/docs/error-messages/tool-errors/command-line-warning-d9025.md index 156400af5db..43d872d40fc 100644 --- a/docs/error-messages/tool-errors/command-line-warning-d9025.md +++ b/docs/error-messages/tool-errors/command-line-warning-d9025.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Command-Line Warning D9025" title: "Command-Line Warning D9025" -ms.date: "11/04/2016" +description: "Learn more about: Command-Line Warning D9025" +ms.date: 11/04/2016 f1_keywords: ["D9025"] helpviewer_keywords: ["D9025"] -ms.assetid: 6edff72c-1508-46c2-99f4-0e4b3c5e60c9 --- # Command-Line Warning D9025 -overriding 'option1' with 'option2' +> overriding 'option1' with 'option2' + +## Remarks The *option1* option was specified but was then overridden by *option2*. The *option2* option was used. diff --git a/docs/error-messages/tool-errors/command-line-warning-d9026.md b/docs/error-messages/tool-errors/command-line-warning-d9026.md index 1b28c6a30e2..ec76878b14d 100644 --- a/docs/error-messages/tool-errors/command-line-warning-d9026.md +++ b/docs/error-messages/tool-errors/command-line-warning-d9026.md @@ -1,17 +1,20 @@ --- -description: "Learn more about: Command-line warning D9026" title: "Command-line warning D9026" +description: "Learn more about: Command-line warning D9026" ms.date: 12/09/2021 f1_keywords: ["D9026"] helpviewer_keywords: ["D9026"] -ms.assetid: 149fe5e3-5329-4be8-b871-49dfd423aaba --- # Command-line warning D9026 > options apply to entire command line +## Remarks + A global option was specified after one or more filenames were specified. The option was also applied to the files that preceded it. +## Example + For example, consider this command line: `CL verdi.c /O2 puccini.c` diff --git a/docs/error-messages/tool-errors/command-line-warning-d9027.md b/docs/error-messages/tool-errors/command-line-warning-d9027.md index a4eefa41805..89064f31aa7 100644 --- a/docs/error-messages/tool-errors/command-line-warning-d9027.md +++ b/docs/error-messages/tool-errors/command-line-warning-d9027.md @@ -1,25 +1,30 @@ --- -description: "Learn more about: Command-Line Warning D9027" title: "Command-Line Warning D9027" -ms.date: "11/04/2016" +description: "Learn more about: Command-Line Warning D9027" +ms.date: 11/04/2016 f1_keywords: ["D9027"] helpviewer_keywords: ["D9027"] -ms.assetid: 2a29edc5-5649-48f2-9058-2057c747284c --- # Command-Line Warning D9027 -source file '\' ignored +> source file '\' ignored + +## Remarks CL.exe ignored the input source file. -This warning can be caused by a space between the /Fo option and an output filename on a command line with the /c option. For example: +This warning can be caused by a space between the /Fo option and an output filename on a command line with the /c option. -``` +## Example + +For example: + +```cmd cl /c /Fo output.obj input.c ``` Because there is a space between /Fo and `output.obj`, CL.exe takes `output.obj` as the name of the input file. To fix the problem, remove the space: -``` +```cmd cl /c /Fooutput.obj input.c ``` diff --git a/docs/error-messages/tool-errors/command-line-warning-d9028.md b/docs/error-messages/tool-errors/command-line-warning-d9028.md index 0c538f76ea5..35b38a28518 100644 --- a/docs/error-messages/tool-errors/command-line-warning-d9028.md +++ b/docs/error-messages/tool-errors/command-line-warning-d9028.md @@ -1,15 +1,16 @@ --- -description: "Learn more about: Command-Line Warning D9028" title: "Command-Line Warning D9028" -ms.date: "04/08/2019" +description: "Learn more about: Command-Line Warning D9028" +ms.date: 04/08/2019 f1_keywords: ["D9028"] helpviewer_keywords: ["D9028"] -ms.assetid: 03852b51-fa59-4114-ab1f-2af0509119af --- # Command-Line Warning D9028 > minimal rebuild failure, reverting to normal build +## Remarks + The project .idb file is corrupt. Delete the file and rebuild. For more information on minimal rebuilds and the .idb file, see the deprecated [/Gm compiler option](../../build/reference/gm-enable-minimal-rebuild.md). diff --git a/docs/error-messages/tool-errors/command-line-warning-d9035.md b/docs/error-messages/tool-errors/command-line-warning-d9035.md index d7d3262869e..eb8cf111ac6 100644 --- a/docs/error-messages/tool-errors/command-line-warning-d9035.md +++ b/docs/error-messages/tool-errors/command-line-warning-d9035.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Command-Line Warning D9035" title: "Command-Line Warning D9035" -ms.date: "12/10/2018" +description: "Learn more about: Command-Line Warning D9035" +ms.date: 12/10/2018 f1_keywords: ["D9035"] helpviewer_keywords: ["D9035"] -ms.assetid: 6254f933-e37a-45ba-b860-1a870d1bc8e8 --- # Command-Line Warning D9035 diff --git a/docs/error-messages/tool-errors/command-line-warning-d9036.md b/docs/error-messages/tool-errors/command-line-warning-d9036.md index d26818460c1..6f1363ee3b9 100644 --- a/docs/error-messages/tool-errors/command-line-warning-d9036.md +++ b/docs/error-messages/tool-errors/command-line-warning-d9036.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Command-Line Warning D9036" title: "Command-Line Warning D9036" -ms.date: "12/10/2018" +description: "Learn more about: Command-Line Warning D9036" +ms.date: 12/10/2018 f1_keywords: ["D9036"] helpviewer_keywords: ["D9036"] -ms.assetid: 68276e84-8d4e-4d4a-a9db-2874c81dfe66 --- # Command-Line Warning D9036 diff --git a/docs/error-messages/tool-errors/command-line-warning-d9040.md b/docs/error-messages/tool-errors/command-line-warning-d9040.md index 3f9c925fb41..900922a82cd 100644 --- a/docs/error-messages/tool-errors/command-line-warning-d9040.md +++ b/docs/error-messages/tool-errors/command-line-warning-d9040.md @@ -1,15 +1,16 @@ --- -description: "Learn more about: Command-Line Warning D9040" title: "Command-Line Warning D9040" -ms.date: "11/04/2016" +description: "Learn more about: Command-Line Warning D9040" +ms.date: 11/04/2016 f1_keywords: ["D9040"] helpviewer_keywords: ["D9040"] -ms.assetid: 415e7f04-c1bd-4ac1-924a-03efa4645140 --- # Command-Line Warning D9040 > ignoring option '/analyze'; Code Analysis warnings are not available in this edition of the compiler +## Remarks + The **`/analyze`** command line option is not available in all editions of Visual Studio. To remedy this warning, either switch to a supported edition of Visual Studio, or remove the command line option. ## See also diff --git a/docs/error-messages/tool-errors/command-line-warning-d9041.md b/docs/error-messages/tool-errors/command-line-warning-d9041.md index b477d13c8c7..80f0bb4e6da 100644 --- a/docs/error-messages/tool-errors/command-line-warning-d9041.md +++ b/docs/error-messages/tool-errors/command-line-warning-d9041.md @@ -1,15 +1,16 @@ --- -description: "Learn more about: Command-Line Warning D9041" title: "Command-Line Warning D9041" -ms.date: "11/04/2016" +description: "Learn more about: Command-Line Warning D9041" +ms.date: 11/04/2016 f1_keywords: ["D9041"] helpviewer_keywords: ["D9041"] -ms.assetid: ada8815f-4246-4e25-b57d-a7f16fa107cc --- # Command-Line Warning D9041 > invalid value '*option-value*' for '/*option-name*'; assuming '*assumed-value*'; add '/analyze' to command-line options when specifying this warning +## Remarks + A Code Analysis warning number was added to the **`/wd`**, **`/we`**, **`/wo`**, or **`/wl`** command line option without also specifying the **`/analyze`** command line option. To remedy this error, either add the **`/analyze`** command line option, or remove the invalid warning number from the appropriate **`/w`** command line option. ## Example diff --git a/docs/error-messages/tool-errors/command-line-warning-d9043.md b/docs/error-messages/tool-errors/command-line-warning-d9043.md index 44bc3eb9b8f..099489e25ac 100644 --- a/docs/error-messages/tool-errors/command-line-warning-d9043.md +++ b/docs/error-messages/tool-errors/command-line-warning-d9043.md @@ -1,18 +1,17 @@ --- -description: "Learn more about: Command-Line Warning D9043" title: "Command-Line Warning D9043" -ms.date: "11/04/2016" +description: "Learn more about: Command-Line Warning D9043" +ms.date: 11/04/2016 f1_keywords: ["D9043"] helpviewer_keywords: ["D9043"] -ms.assetid: 9263e28d-217b-414c-bfb6-86efd3c27a77 --- # Command-Line Warning D9043 -invalid value 'warning_level' for 'compiler_option'; assuming '4999'; Code Analysis warnings are not associated with warning levels +> invalid value 'warning_level' for 'compiler_option'; assuming '4999'; Code Analysis warnings are not associated with warning levels ## Example -The following sample generates C9043. +The following example generates D9043. ```cpp // D9043.cpp diff --git a/docs/error-messages/tool-errors/cvtres-errors-cvt1100-through-cvt4001.md b/docs/error-messages/tool-errors/cvtres-errors-cvt1100-through-cvt4001.md index 633159c3ad0..0b2040cb66b 100644 --- a/docs/error-messages/tool-errors/cvtres-errors-cvt1100-through-cvt4001.md +++ b/docs/error-messages/tool-errors/cvtres-errors-cvt1100-through-cvt4001.md @@ -1,9 +1,8 @@ --- -description: "Learn more about: CVTRES errors and warnings (CVTxxxx)" title: "CVTRES errors and warnings" -ms.date: "04/16/2019" +description: "Learn more about: CVTRES errors and warnings (CVTxxxx)" +ms.date: 04/16/2019 f1_keywords: ["CVT1101", "CVT1102", "CVT1104", "CVT1106", "CVT1107", "CVT1108", "CVT1109", "CVT1110"] -ms.assetid: ac94d0fb-0da3-4327-b3d9-ceaeb3fc2e4d --- # CVTRES errors and warnings (CVTxxxx) @@ -13,13 +12,17 @@ This section is a reference to the errors and warnings generated by the CVTRES b ## Fatal error messages -[CVTRES fatal error CVT1100](cvtres-fatal-error-cvt1100.md) \ -[CVTRES fatal error CVT1103](cvtres-fatal-error-cvt1103.md) \ -[CVTRES fatal error CVT1105](cvtres-fatal-error-cvt1105.md) +| Error | Message | +|--|--| +| [CVTRES fatal error CVT1100](cvtres-fatal-error-cvt1100.md) | duplicate resource — type:type, name:name, language:language, flags:flags, size:size | +| [CVTRES fatal error CVT1103](cvtres-fatal-error-cvt1103.md) | cannot read filename | +| [CVTRES fatal error CVT1105](cvtres-fatal-error-cvt1105.md) | cannot seek in file | ## Warning messages -[CVTRES warning CVT4001](cvtres-warning-cvt4001.md) +| Warning | Message | +|--|--| +| [CVTRES warning CVT4001](cvtres-warning-cvt4001.md) | machine type not specified; assumed *type* | ## See also diff --git a/docs/error-messages/tool-errors/cvtres-fatal-error-cvt1100.md b/docs/error-messages/tool-errors/cvtres-fatal-error-cvt1100.md index d4f1ee842da..29fd15d3c3d 100644 --- a/docs/error-messages/tool-errors/cvtres-fatal-error-cvt1100.md +++ b/docs/error-messages/tool-errors/cvtres-fatal-error-cvt1100.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: CVTRES Fatal Error CVT1100" title: "CVTRES Fatal Error CVT1100" -ms.date: "11/04/2016" +description: "Learn more about: CVTRES Fatal Error CVT1100" +ms.date: 11/04/2016 f1_keywords: ["CVT1100"] helpviewer_keywords: ["CVT1100"] -ms.assetid: 886e88dd-5818-4b5f-84f2-d2a3d75f0aaf --- # CVTRES Fatal Error CVT1100 -duplicate resource — type:type, name:name, language:language, flags:flags, size:size +> duplicate resource — type:type, name:name, language:language, flags:flags, size:size + +## Remarks The given resource was specified more than once. diff --git a/docs/error-messages/tool-errors/cvtres-fatal-error-cvt1103.md b/docs/error-messages/tool-errors/cvtres-fatal-error-cvt1103.md index 5ca0766f957..b73038b1032 100644 --- a/docs/error-messages/tool-errors/cvtres-fatal-error-cvt1103.md +++ b/docs/error-messages/tool-errors/cvtres-fatal-error-cvt1103.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: CVTRES Fatal Error CVT1103" title: "CVTRES Fatal Error CVT1103" -ms.date: "11/04/2016" +description: "Learn more about: CVTRES Fatal Error CVT1103" +ms.date: 11/04/2016 f1_keywords: ["CVT1103"] helpviewer_keywords: ["CVT1103"] -ms.assetid: 5ba5f44c-c3c3-4861-92c5-13c51ee667ef --- # CVTRES Fatal Error CVT1103 -cannot read filename +> cannot read filename + +## Remarks An unrecoverable error occurred when CVTRES attempted to read the given file. diff --git a/docs/error-messages/tool-errors/cvtres-fatal-error-cvt1105.md b/docs/error-messages/tool-errors/cvtres-fatal-error-cvt1105.md index bc43ec10d2a..8bedfeeb3eb 100644 --- a/docs/error-messages/tool-errors/cvtres-fatal-error-cvt1105.md +++ b/docs/error-messages/tool-errors/cvtres-fatal-error-cvt1105.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: CVTRES Fatal Error CVT1105" title: "CVTRES Fatal Error CVT1105" -ms.date: "11/04/2016" +description: "Learn more about: CVTRES Fatal Error CVT1105" +ms.date: 11/04/2016 f1_keywords: ["CVT1105"] helpviewer_keywords: ["CVT1105"] -ms.assetid: 6fb98e2b-836e-4e1e-9bd8-4e1465ad4e85 --- # CVTRES Fatal Error CVT1105 -cannot seek in file +> cannot seek in file + +## Remarks CVTRES could not go to a location in the file. diff --git a/docs/error-messages/tool-errors/cvtres-warning-cvt4001.md b/docs/error-messages/tool-errors/cvtres-warning-cvt4001.md index c5a1257e706..31ce4a14981 100644 --- a/docs/error-messages/tool-errors/cvtres-warning-cvt4001.md +++ b/docs/error-messages/tool-errors/cvtres-warning-cvt4001.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: CVTRES Warning CVT4001" title: "CVTRES Warning CVT4001" -ms.date: "08/27/2018" +description: "Learn more about: CVTRES Warning CVT4001" +ms.date: 08/27/2018 f1_keywords: ["CVT4001"] helpviewer_keywords: ["CVT4001"] -ms.assetid: 39c13bc2-92fa-4d79-8171-039b27329dcc --- # CVTRES Warning CVT4001 > machine type not specified; assumed *type* +## Remarks + CVTRES did not find a machine specification. It assumed the given machine type. If the default is incorrect, rerun CVTRES using the /MACHINE option. diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0000.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0000.md index cfc74ee7552..36257d65814 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0000.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0000.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Expression Evaluator Error CXX0000" title: "Expression Evaluator Error CXX0000" -ms.date: "11/04/2016" +description: "Learn more about: Expression Evaluator Error CXX0000" +ms.date: 11/04/2016 f1_keywords: ["CXX0000"] helpviewer_keywords: ["CAN0000", "CXX0000"] -ms.assetid: 95a7f17d-88ea-4a6c-a3af-2289bf0529fe --- # Expression Evaluator Error CXX0000 -no error condition +> no error condition + +## Remarks No error has occurred. You can continue debugging normally. diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0001.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0001.md index 73944dbf0b0..6eaffca2052 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0001.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0001.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Expression Evaluator Error CXX0001" title: "Expression Evaluator Error CXX0001" -ms.date: "11/04/2016" +description: "Learn more about: Expression Evaluator Error CXX0001" +ms.date: 11/04/2016 f1_keywords: ["CXX0001"] helpviewer_keywords: ["CXX0001", "CAN0001"] -ms.assetid: 39cdf175-e4b8-49c1-bf84-ed41e0fd8600 --- # Expression Evaluator Error CXX0001 -exception executing user function +> exception executing user function + +## Remarks The code being executed caused a general protection fault. This error is identical to CAN0001. diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0002.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0002.md index 8070e98c160..5cdf941c8d9 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0002.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0002.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Expression Evaluator Error CXX0002" title: "Expression Evaluator Error CXX0002" -ms.date: "11/04/2016" +description: "Learn more about: Expression Evaluator Error CXX0002" +ms.date: 11/04/2016 f1_keywords: ["CXX0002"] helpviewer_keywords: ["CXX0002", "CAN0002"] -ms.assetid: 5f136470-505f-4224-a29a-2d34e896d78b --- # Expression Evaluator Error CXX0002 -error accessing user memory +> error accessing user memory + +## Remarks The expression attempts to reference memory that is not allocated to the program being debugged. diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0004.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0004.md index 1bac7f4b77c..dbf174f51fe 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0004.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0004.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Expression Evaluator Error CXX0004" title: "Expression Evaluator Error CXX0004" -ms.date: "11/04/2016" +description: "Learn more about: Expression Evaluator Error CXX0004" +ms.date: 11/04/2016 f1_keywords: ["CXX0004"] helpviewer_keywords: ["CAN0004", "CXX0004"] -ms.assetid: a4063eda-0335-4ae7-9595-29cf10669376 --- # Expression Evaluator Error CXX0004 -syntax error +> syntax error + +## Remarks The syntax of the expression is incorrect. diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0005.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0005.md index b7c786053a7..9aac32814d1 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0005.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0005.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Expression Evaluator Error CXX0005" title: "Expression Evaluator Error CXX0005" -ms.date: "11/04/2016" +description: "Learn more about: Expression Evaluator Error CXX0005" +ms.date: 11/04/2016 f1_keywords: ["CXX0005"] helpviewer_keywords: ["CXX0005", "CAN0005"] -ms.assetid: b88e83e4-10aa-4e9c-94d3-92aa8c688748 --- # Expression Evaluator Error CXX0005 -operator not supported +> operator not supported + +## Remarks An unsupported C operator was specified in an expression. Write an equivalent expression using the supported C operators. diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0006.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0006.md index bd78c131518..2a172e02f87 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0006.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0006.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Expression Evaluator Error CXX0006" title: "Expression Evaluator Error CXX0006" -ms.date: "11/04/2016" +description: "Learn more about: Expression Evaluator Error CXX0006" +ms.date: 11/04/2016 f1_keywords: ["CXX0006"] helpviewer_keywords: ["CAN0006", "CXX0006"] -ms.assetid: 34a8e21c-5443-4817-aad9-bb3143cfcaa6 --- # Expression Evaluator Error CXX0006 -missing left parenthesis +> missing left parenthesis + +## Remarks Unbalanced parentheses were found in the expression. Retype the expression with balanced parentheses. diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0007.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0007.md index 27956d6b228..886c1987ad8 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0007.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0007.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Expression Evaluator Error CXX0007" title: "Expression Evaluator Error CXX0007" -ms.date: "11/04/2016" +description: "Learn more about: Expression Evaluator Error CXX0007" +ms.date: 11/04/2016 f1_keywords: ["CXX0007"] helpviewer_keywords: ["CXX0007", "CAN0007"] -ms.assetid: 270a6d2d-ea6b-4a94-9871-841a6a133292 --- # Expression Evaluator Error CXX0007 -missing right parenthesis +> missing right parenthesis + +## Remarks Unbalanced parentheses were found in the expression. Retype the expression with balanced parentheses. diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0008.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0008.md index bca96bf5fa0..201553ebca2 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0008.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0008.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Expression Evaluator Error CXX0008" title: "Expression Evaluator Error CXX0008" -ms.date: "11/04/2016" +description: "Learn more about: Expression Evaluator Error CXX0008" +ms.date: 11/04/2016 f1_keywords: ["CXX0008"] helpviewer_keywords: ["CXX0008", "CAN0008"] -ms.assetid: 49e0968c-a6ce-4ba9-9762-02a55c08124e --- # Expression Evaluator Error CXX0008 -**missing " at end of string** +> missing " at end of string + +## Remarks The double quote expected at the end of the string literal was missing. Retype the expression, enclosing the string literal in double quotation marks. diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0009.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0009.md index 74dc99854fd..22cebf0aa8c 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0009.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0009.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Expression Evaluator Error CXX0009" title: "Expression Evaluator Error CXX0009" -ms.date: "11/04/2016" +description: "Learn more about: Expression Evaluator Error CXX0009" +ms.date: 11/04/2016 f1_keywords: ["CXX0009"] helpviewer_keywords: ["CXX0009", "CAN0009"] -ms.assetid: b6f26a46-56f3-430f-a6db-b42934ddf331 --- # Expression Evaluator Error CXX0009 -missing ' after character constant +> missing ' after character constant + +## Remarks The single quote expected at the end of the character constant was missing. Retype the expression, enclosing the character constant in single quotation marks. diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0010.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0010.md index 9412b3c4c7b..d3eb52bb8cc 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0010.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0010.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Expression Evaluator Error CXX0010" title: "Expression Evaluator Error CXX0010" -ms.date: "11/04/2016" +description: "Learn more about: Expression Evaluator Error CXX0010" +ms.date: 11/04/2016 f1_keywords: ["CXX0010"] helpviewer_keywords: ["CAN0010", "CXX0010"] -ms.assetid: 8bd474b0-da12-4990-8569-6392f09f05f6 --- # Expression Evaluator Error CXX0010 -missing left bracket +> missing left bracket + +## Remarks The expression contains unbalanced square brackets. Retype the expression with balanced square brackets. diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0011.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0011.md index f2eda30c029..73e96763e91 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0011.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0011.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Expression Evaluator Error CXX0011" title: "Expression Evaluator Error CXX0011" -ms.date: "11/04/2016" +description: "Learn more about: Expression Evaluator Error CXX0011" +ms.date: 11/04/2016 f1_keywords: ["CXX0011"] helpviewer_keywords: ["CAN0011", "CXX0011"] -ms.assetid: c2252e89-ad66-43fc-93e4-b886dcbd3f19 --- # Expression Evaluator Error CXX0011 -missing right bracket +> missing right bracket + +## Remarks The expression contains unbalanced square brackets. Retype the expression with balanced square brackets. diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0012.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0012.md index f35e2ee2907..367224bbc98 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0012.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0012.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Expression Evaluator Error CXX0012" title: "Expression Evaluator Error CXX0012" -ms.date: "11/04/2016" +description: "Learn more about: Expression Evaluator Error CXX0012" +ms.date: 11/04/2016 f1_keywords: ["CXX0012"] helpviewer_keywords: ["CXX0012", "CAN0012"] -ms.assetid: bf547e21-6708-4854-ad23-2ae5a889fd82 --- # Expression Evaluator Error CXX0012 -missing left curly brace +> missing left curly brace + +## Remarks The expression contains an unbalanced curly brace. Retype the expression with balanced curly braces. diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0013.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0013.md index 0b88ec11273..91bcbb1a834 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0013.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0013.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Expression Evaluator Error CXX0013" title: "Expression Evaluator Error CXX0013" -ms.date: "11/04/2016" +description: "Learn more about: Expression Evaluator Error CXX0013" +ms.date: 11/04/2016 f1_keywords: ["CXX0013"] helpviewer_keywords: ["CAN0013", "CXX0013"] -ms.assetid: cf571e37-008d-47cd-80fa-59e96b1146e1 --- # Expression Evaluator Error CXX0013 -missing operator +> missing operator + +## Remarks An operator was expected in the expression but was not found. Check the syntax of the expression. diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0014.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0014.md index 640a86da34f..9876536b5c0 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0014.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0014.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Expression Evaluator Error CXX0014" title: "Expression Evaluator Error CXX0014" -ms.date: "11/04/2016" +description: "Learn more about: Expression Evaluator Error CXX0014" +ms.date: 11/04/2016 f1_keywords: ["CXX0014"] helpviewer_keywords: ["CAN0014", "CXX0014"] -ms.assetid: 3bb0278d-3dd6-4626-9945-3cf29afbbacb --- # Expression Evaluator Error CXX0014 -missing operand +> missing operand + +## Remarks An operator was specified without a required operand. Check the syntax of the expression. diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0015.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0015.md index 31160b46a72..bb5d1ed5373 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0015.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0015.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Expression Evaluator Error CXX0015" title: "Expression Evaluator Error CXX0015" -ms.date: "11/04/2016" +description: "Learn more about: Expression Evaluator Error CXX0015" +ms.date: 11/04/2016 f1_keywords: ["CXX0015"] helpviewer_keywords: ["CXX0015", "CAN0015"] -ms.assetid: 35efaf77-d578-48d8-bfc5-fdeb2a46a8b5 --- # Expression Evaluator Error CXX0015 -expression too complex (stack overflow) +> expression too complex (stack overflow) + +## Remarks The expression entered was too complex or nested too deeply for the amount of storage available to the C expression evaluator. diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0016.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0016.md index 4feb05578b6..b1707a48dd8 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0016.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0016.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Expression Evaluator Error CXX0016" title: "Expression Evaluator Error CXX0016" -ms.date: "11/04/2016" +description: "Learn more about: Expression Evaluator Error CXX0016" +ms.date: 11/04/2016 f1_keywords: ["CXX0016"] helpviewer_keywords: ["CAN0016", "CXX0016"] -ms.assetid: af94a2ae-e835-4da6-8d2f-5c879f72eda2 --- # Expression Evaluator Error CXX0016 -constant too big +> constant too big + +## Remarks The C expression evaluator cannot accept an unsigned integer constant larger than 4,294,967,295 (0FFFFFFFF hexadecimal), or a floating-point constant whose magnitude is larger than approximately 1.8E+308. diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0017.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0017.md index f6c81de30cc..6c938f71ef0 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0017.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0017.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Expression Evaluator Error CXX0017" title: "Expression Evaluator Error CXX0017" -ms.date: "11/04/2016" +description: "Learn more about: Expression Evaluator Error CXX0017" +ms.date: 11/04/2016 f1_keywords: ["CXX0017"] helpviewer_keywords: ["CAN0017", "CXX0017"] -ms.assetid: af74db02-a64d-49ca-8363-3e044a107580 --- # Expression Evaluator Error CXX0017 -symbol not found +> symbol not found + +## Remarks A symbol specified in an expression could not be found. diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0018.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0018.md index 9f7e92345ca..dac98b60f4d 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0018.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0018.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Expression Evaluator Error CXX0018" title: "Expression Evaluator Error CXX0018" -ms.date: "11/04/2016" +description: "Learn more about: Expression Evaluator Error CXX0018" +ms.date: 11/04/2016 f1_keywords: ["CXX0018"] helpviewer_keywords: ["CAN0018", "CXX0018"] -ms.assetid: d3d115d6-8981-4651-b615-566de867a263 --- # Expression Evaluator Error CXX0018 -bad register name +> bad register name + +## Remarks A specified register does not exist or cannot be displayed. diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0019.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0019.md index 680e0ee45f5..80ad76d78e5 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0019.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0019.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Expression Evaluator Error CXX0019" title: "Expression Evaluator Error CXX0019" -ms.date: "11/04/2016" +description: "Learn more about: Expression Evaluator Error CXX0019" +ms.date: 11/04/2016 f1_keywords: ["CXX0019"] helpviewer_keywords: ["CXX0019", "CAN0019"] -ms.assetid: 4c6431fd-3310-4a61-934d-58b070b330fe --- # Expression Evaluator Error CXX0019 -bad type cast +> bad type cast + +## Remarks The C expression evaluator cannot perform the type cast as written. diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0020.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0020.md index c34f0f55823..2b553478ee1 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0020.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0020.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Expression Evaluator Error CXX0020" title: "Expression Evaluator Error CXX0020" -ms.date: "11/04/2016" +description: "Learn more about: Expression Evaluator Error CXX0020" +ms.date: 11/04/2016 f1_keywords: ["CXX0020"] helpviewer_keywords: ["CXX0020", "CAN0020"] -ms.assetid: 9dc57c25-e976-44e8-9a4e-db5a79e35bd7 --- # Expression Evaluator Error CXX0020 -operand types bad for this operation +> operand types bad for this operation + +## Remarks An operator was applied to an expression with an invalid type for that operator. diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0021.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0021.md index 162380237e5..1b1bbf92e52 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0021.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0021.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Expression Evaluator Error CXX0021" title: "Expression Evaluator Error CXX0021" -ms.date: "11/04/2016" +description: "Learn more about: Expression Evaluator Error CXX0021" +ms.date: 11/04/2016 f1_keywords: ["CXX0021"] helpviewer_keywords: ["CXX0021", "CAN0021"] -ms.assetid: d6c0c35a-16c2-42c0-a7d2-e910350a47f0 --- # Expression Evaluator Error CXX0021 -struct or union used as scalar +> struct or union used as scalar + +## Remarks A structure or union was used in an expression, but no element was specified. diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0022.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0022.md index 1c06fe8c2a0..9e22b714a45 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0022.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0022.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Expression Evaluator Error CXX0022" title: "Expression Evaluator Error CXX0022" -ms.date: "11/04/2016" +description: "Learn more about: Expression Evaluator Error CXX0022" +ms.date: 11/04/2016 f1_keywords: ["CXX0022"] helpviewer_keywords: ["CXX0022", "CAN0022"] -ms.assetid: f6b299ac-a4ee-492c-bd9f-6fff005bc537 --- # Expression Evaluator Error CXX0022 -function call before _main +> function call before _main + +## Remarks The C expression evaluator cannot evaluate a function before the debugger has entered the function **_main**. The program is not properly initialized until **_main** has been called. diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0023.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0023.md index d71fb7f9703..b052cd60af5 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0023.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0023.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Expression Evaluator Error CXX0023" title: "Expression Evaluator Error CXX0023" -ms.date: "11/04/2016" +description: "Learn more about: Expression Evaluator Error CXX0023" +ms.date: 11/04/2016 f1_keywords: ["CXX0023"] helpviewer_keywords: ["CXX0023", "CAN0023"] -ms.assetid: 2de27692-dfb5-433f-82b3-80f118756eec --- # Expression Evaluator Error CXX0023 -bad radix +> bad radix + +## Remarks The C expression evaluator does not recognize the radix specified. Only decimal, hexadecimal, and octal radixes are valid. diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0024.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0024.md index 92cf0e9e802..e43cd889199 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0024.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0024.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Expression Evaluator Error CXX0024" title: "Expression Evaluator Error CXX0024" -ms.date: "11/04/2016" +description: "Learn more about: Expression Evaluator Error CXX0024" +ms.date: 11/04/2016 f1_keywords: ["CXX0024"] helpviewer_keywords: ["CXX0024", "CAN0024"] -ms.assetid: eca6adbd-8ff2-4f51-a1cc-a2e9d5d0a47d --- # Expression Evaluator Error CXX0024 -operation needs l-value +> operation needs l-value + +## Remarks An expression that does not evaluate to an l-value was specified for an operation that requires an l-value. diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0025.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0025.md index 10467f5b2ab..ed2c8ec0b45 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0025.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0025.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Expression Evaluator Error CXX0025" title: "Expression Evaluator Error CXX0025" -ms.date: "11/04/2016" +description: "Learn more about: Expression Evaluator Error CXX0025" +ms.date: 11/04/2016 f1_keywords: ["CXX0025"] helpviewer_keywords: ["CAN0025", "CXX0025"] -ms.assetid: 3e2fb541-63b3-46ac-9f93-3dadb253bcf6 --- # Expression Evaluator Error CXX0025 -operator needs struct/union +> operator needs struct/union + +## Remarks An operator that takes an expression of **`struct`** or **`union`** type was applied to an expression that is not a **`struct`** or **`union`**. diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0026.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0026.md index ed489fd094c..2cc930c9869 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0026.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0026.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Expression Evaluator Error CXX0026" title: "Expression Evaluator Error CXX0026" -ms.date: "11/04/2016" +description: "Learn more about: Expression Evaluator Error CXX0026" +ms.date: 11/04/2016 f1_keywords: ["CXX0026"] helpviewer_keywords: ["CXX0026", "CAN0026"] -ms.assetid: b5bc15f2-f179-4b87-ae88-a57e08e43bfa --- # Expression Evaluator Error CXX0026 -bad format string +> bad format string + +## Remarks A format string was improperly specified. Check the syntax of the expression. diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0027.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0027.md index 20755a40dbe..d69c9d7659d 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0027.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0027.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Expression Evaluator Error CXX0027" title: "Expression Evaluator Error CXX0027" -ms.date: "11/04/2016" +description: "Learn more about: Expression Evaluator Error CXX0027" +ms.date: 11/04/2016 f1_keywords: ["CXX0027"] helpviewer_keywords: ["CAN0027", "CXX0027"] -ms.assetid: 0127cfc0-c292-4923-a58b-25542343cdad --- # Expression Evaluator Error CXX0027 -tp addr not l-value +> tp addr not l-value + +## Remarks Check the syntax of the expression. diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0028.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0028.md index 78d2a0aa519..8cfb6900d31 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0028.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0028.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Expression Evaluator Error CXX0028" title: "Expression Evaluator Error CXX0028" -ms.date: "11/04/2016" +description: "Learn more about: Expression Evaluator Error CXX0028" +ms.date: 11/04/2016 f1_keywords: ["CXX0028"] helpviewer_keywords: ["CAN0028", "CXX0028"] -ms.assetid: 172eb81f-c0b0-43b1-b418-766f35f1a561 --- # Expression Evaluator Error CXX0028 -not struct/union element +> not struct/union element + +## Remarks An expression of the form 'Struct.Member' or 'pStruct->Member' was specified, but \ is not an element of the structure. diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0029.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0029.md index 2e7ea0170bb..6ca03e1d0e0 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0029.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0029.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Expression Evaluator Error CXX0029" title: "Expression Evaluator Error CXX0029" -ms.date: "11/04/2016" +description: "Learn more about: Expression Evaluator Error CXX0029" +ms.date: 11/04/2016 f1_keywords: ["CXX0029"] helpviewer_keywords: ["CXX0029", "CAN0029"] -ms.assetid: 562b2132-e9cb-4591-a5bf-bc7179a7f40e --- # Expression Evaluator Error CXX0029 -not struct pointer +> not struct pointer + +## Remarks The member-selection operator (**->**) was applied to an expression that is not a pointer to a structure. diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0030.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0030.md index 64a58f4ddbf..8c980d87cca 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0030.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0030.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Expression Evaluator Error CXX0030" title: "Expression Evaluator Error CXX0030" -ms.date: "11/04/2016" +description: "Learn more about: Expression Evaluator Error CXX0030" +ms.date: 11/04/2016 f1_keywords: ["CXX0030"] helpviewer_keywords: ["CAN0030", "CXX0030"] -ms.assetid: ada8b48c-09c8-49bf-ae23-313ed663c4fe --- # Expression Evaluator Error CXX0030 -expression not evaluatable +> expression not evaluatable + +## Remarks The debugger's expression evaluator could not obtain a value for the expression as written. One likely cause is that the expression refers to memory that is outside the program's address space (dereferencing a null pointer is one example). Windows does not allow access to memory that is outside of the program's address space. diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0031.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0031.md index 255307a8bbf..6b95122dad0 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0031.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0031.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Expression Evaluator Error CXX0031" title: "Expression Evaluator Error CXX0031" -ms.date: "11/04/2016" +description: "Learn more about: Expression Evaluator Error CXX0031" +ms.date: 11/04/2016 f1_keywords: ["CXX0031"] helpviewer_keywords: ["CAN0031", "CXX0031"] -ms.assetid: adafbcb7-982f-495f-a34d-72e95d7e54c7 --- # Expression Evaluator Error CXX0031 -expression not expandable +> expression not expandable + +## Remarks The expression evaluator encountered an internal error. diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0032.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0032.md index a9902fe416c..505f99fbb2b 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0032.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0032.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Expression Evaluator Error CXX0032" title: "Expression Evaluator Error CXX0032" -ms.date: "11/04/2016" +description: "Learn more about: Expression Evaluator Error CXX0032" +ms.date: 11/04/2016 f1_keywords: ["CXX0032"] helpviewer_keywords: ["CXX0032", "CAN0032"] -ms.assetid: 78f56977-6b6d-42e2-b71d-c392525bb18b --- # Expression Evaluator Error CXX0032 -divide by 0 +> divide by 0 + +## Remarks The expression contains a divisor of zero, which is illegal. This divisor may be the literal number zero, or it may be an expression that evaluates to zero. diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0033.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0033.md index 198a6def252..759e150bbef 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0033.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0033.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Expression Evaluator Error CXX0033" title: "Expression Evaluator Error CXX0033" -ms.date: "11/04/2016" +description: "Learn more about: Expression Evaluator Error CXX0033" +ms.date: 11/04/2016 f1_keywords: ["CXX0033"] helpviewer_keywords: ["CAN0033", "CXX0033"] -ms.assetid: 0bd62c5b-de89-481f-9b12-88fe84805afe --- # Expression Evaluator Error CXX0033 -error in OMF type information +> error in OMF type information + +## Remarks The executable file did not have a valid object module format (OMF) for debugging. diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0034.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0034.md index 829dacf515a..ef6ccecab13 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0034.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0034.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Expression Evaluator Error CXX0034" title: "Expression Evaluator Error CXX0034" -ms.date: "11/04/2016" +description: "Learn more about: Expression Evaluator Error CXX0034" +ms.date: 11/04/2016 f1_keywords: ["CXX0034"] helpviewer_keywords: ["CAN0034", "CXX0034"] -ms.assetid: afcee5f1-beff-489f-aea6-04f55e76364f --- # Expression Evaluator Error CXX0034 -**types incompatible with operator** +> types incompatible with operator + +## Remarks The operand types specified are not legal for the operation. diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0036.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0036.md index 6c86cd2b0b7..d9f203ab553 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0036.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0036.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Expression Evaluator Error CXX0036" title: "Expression Evaluator Error CXX0036" -ms.date: "11/04/2016" +description: "Learn more about: Expression Evaluator Error CXX0036" +ms.date: 11/04/2016 f1_keywords: ["CXX0036"] helpviewer_keywords: ["CXX0036", "CAN0036"] -ms.assetid: 383404be-df5b-4eec-b113-df21bb5d269d --- # Expression Evaluator Error CXX0036 -bad context {...} specification +> bad context {...} specification + +## Remarks This message can be generated by any of several errors in the use of the context operator (**{}**). diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0037.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0037.md index 48e93579abb..f09a73432f8 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0037.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0037.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Expression Evaluator Error CXX0037" title: "Expression Evaluator Error CXX0037" -ms.date: "11/04/2016" +description: "Learn more about: Expression Evaluator Error CXX0037" +ms.date: 11/04/2016 f1_keywords: ["CXX0037"] helpviewer_keywords: ["CAN0037", "CXX0037"] -ms.assetid: 8059ad65-78b7-465a-98fa-387fd5873ea6 --- # Expression Evaluator Error CXX0037 -out of memory +> out of memory + +## Remarks The C expression evaluator ran out of memory evaluating the expression. diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0038.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0038.md index 51969d57d34..e1dfdca5443 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0038.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0038.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Expression Evaluator Error CXX0038" title: "Expression Evaluator Error CXX0038" -ms.date: "11/04/2016" +description: "Learn more about: Expression Evaluator Error CXX0038" +ms.date: 11/04/2016 f1_keywords: ["CXX0038"] helpviewer_keywords: ["CXX0038", "CAN0038"] -ms.assetid: 3327dc4e-1726-4924-a519-6ffd766a389c --- # Expression Evaluator Error CXX0038 -function argument count and/or type mismatch +> function argument count and/or type mismatch + +## Remarks The function call as specified does not match the prototype for the function. diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0039.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0039.md index 8b0274bd435..b6aeebdb00f 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0039.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0039.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Expression Evaluator Error CXX0039" title: "Expression Evaluator Error CXX0039" -ms.date: "11/04/2016" +description: "Learn more about: Expression Evaluator Error CXX0039" +ms.date: 11/04/2016 f1_keywords: ["CXX0039"] helpviewer_keywords: ["CXX0039", "CAN0039"] -ms.assetid: 8bf698d2-e015-4595-944f-72b81aa43d22 --- # Expression Evaluator Error CXX0039 -symbol is ambiguous +> symbol is ambiguous + +## Remarks The C expression evaluator cannot determine which instance of a symbol to use in an expression. The symbol occurs more than once in the inheritance tree. diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0040.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0040.md index b1cb02f95b6..448fd76bc9e 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0040.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0040.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Expression Evaluator Error CXX0040" title: "Expression Evaluator Error CXX0040" -ms.date: "11/04/2016" +description: "Learn more about: Expression Evaluator Error CXX0040" +ms.date: 11/04/2016 f1_keywords: ["CXX0040"] helpviewer_keywords: ["CXX0040", "CAN0040"] -ms.assetid: 1914e605-d80b-4abc-9e8f-dbcbefec095b --- # Expression Evaluator Error CXX0040 -function requires implicit conversion +> function requires implicit conversion + +## Remarks The C expression evaluator does not support implicit conversions involving constructor calls. diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0041.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0041.md index cd956d21484..37a50b38381 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0041.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0041.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Expression Evaluator Error CXX0041" title: "Expression Evaluator Error CXX0041" -ms.date: "11/04/2016" +description: "Learn more about: Expression Evaluator Error CXX0041" +ms.date: 11/04/2016 f1_keywords: ["CXX0041"] helpviewer_keywords: ["CAN0041", "CXX0041"] -ms.assetid: ce8a2366-758f-481b-8c03-ed7d779091b2 --- # Expression Evaluator Error CXX0041 -class element must be static member or member function +> class element must be static member or member function + +## Remarks A nonstatic member of a class (or structure or union) was used without specifying which instantiation of the class to use. diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0043.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0043.md index 9ee2d06229f..97a455ab4d8 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0043.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0043.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Expression Evaluator Error CXX0043" title: "Expression Evaluator Error CXX0043" -ms.date: "11/04/2016" +description: "Learn more about: Expression Evaluator Error CXX0043" +ms.date: 11/04/2016 f1_keywords: ["CXX0043"] helpviewer_keywords: ["CXX0043", "CAN0043"] -ms.assetid: 5e5d55bb-0f3e-40e6-b3c3-d0dfb701a65c --- # Expression Evaluator Error CXX0043 -this pointer used outside member function +> this pointer used outside member function + +## Remarks The **`this`** pointer can only be used for nonstatic member functions. diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0044.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0044.md index b71528aecc9..ebb048927d8 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0044.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0044.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Expression Evaluator Error CXX0044" title: "Expression Evaluator Error CXX0044" -ms.date: "11/04/2016" +description: "Learn more about: Expression Evaluator Error CXX0044" +ms.date: 11/04/2016 f1_keywords: ["CXX0044"] helpviewer_keywords: ["CXX0044", "CAN0044"] -ms.assetid: d59868b5-c1ec-46ac-91d6-5d575a4d6b49 --- # Expression Evaluator Error CXX0044 -use of _based(void) pointer requires :> operator +> use of _based(void) pointer requires :> operator + +## Remarks A pointer based on **`void`** cannot be used directly. You must form a complete pointer using the **:>** operator. diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0045.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0045.md index b6e4004e883..1bf5578f642 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0045.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0045.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Expression Evaluator Error CXX0045" title: "Expression Evaluator Error CXX0045" -ms.date: "11/04/2016" +description: "Learn more about: Expression Evaluator Error CXX0045" +ms.date: 11/04/2016 f1_keywords: ["CXX0045"] helpviewer_keywords: ["CXX0045", "CAN0045"] -ms.assetid: 32181bc8-e79c-4ad7-a82f-47c62ec06d7d --- # Expression Evaluator Error CXX0045 -not a function +> not a function + +## Remarks An argument list was supplied for a symbol in the program that is not the name of a function. diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0046.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0046.md index cd6e216b644..e3d1398c1d7 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0046.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0046.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Expression Evaluator Error CXX0046" title: "Expression Evaluator Error CXX0046" -ms.date: "11/04/2016" +description: "Learn more about: Expression Evaluator Error CXX0046" +ms.date: 11/04/2016 f1_keywords: ["CXX0046"] helpviewer_keywords: ["CXX0046", "CAN0046"] -ms.assetid: a76e657b-c018-415b-b426-ce9e72eb645d --- # Expression Evaluator Error CXX0046 -argument list required for member function +> argument list required for member function + +## Remarks An expression called a member function but did not specify any actual parameters. diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0047.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0047.md index 09112a2f074..ac89429f3cf 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0047.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0047.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Expression Evaluator Error CXX0047" title: "Expression Evaluator Error CXX0047" -ms.date: "11/04/2016" +description: "Learn more about: Expression Evaluator Error CXX0047" +ms.date: 11/04/2016 f1_keywords: ["CXX0047"] helpviewer_keywords: ["CAN0047", "CXX0047"] -ms.assetid: db23d0db-fce2-4d86-b391-6e1d6ad13fd4 --- # Expression Evaluator Error CXX0047 -argument list does not match a function +> argument list does not match a function + +## Remarks An expression called a function with an actual parameter list that did not match the formal parameter list of any function with the same name defined in the program. diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0048.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0048.md index 5effef18e61..c081babcfb8 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0048.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0048.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Expression Evaluator Error CXX0048" title: "Expression Evaluator Error CXX0048" -ms.date: "11/04/2016" +description: "Learn more about: Expression Evaluator Error CXX0048" +ms.date: 11/04/2016 f1_keywords: ["CXX0048"] helpviewer_keywords: ["CAN0048", "CXX0048"] -ms.assetid: 294416f9-5e38-4450-8713-c13bcbaaf615 --- # Expression Evaluator Error CXX0048 -calling sequence not supported +> calling sequence not supported + +## Remarks A function specified in the expression uses a calling sequence not supported by the C expression evaluator. You cannot call this function in a Watch window expression. diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0049.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0049.md index 621a8825611..a064fa348cd 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0049.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0049.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Expression Evaluator Error CXX0049" title: "Expression Evaluator Error CXX0049" -ms.date: "11/04/2016" +description: "Learn more about: Expression Evaluator Error CXX0049" +ms.date: 11/04/2016 f1_keywords: ["CXX0049"] helpviewer_keywords: ["CXX0049", "CAN0049"] -ms.assetid: 6dcfece4-39ed-489d-b7be-2a17c7b94656 --- # Expression Evaluator Error CXX0049 -obsolete OMF - please relink program +> obsolete OMF - please relink program + +## Remarks The program used an old OMF (Object Module Format). diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0050.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0050.md index e096ec70438..689436e2b00 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0050.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0050.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Expression Evaluator Error CXX0050" title: "Expression Evaluator Error CXX0050" -ms.date: "11/04/2016" +description: "Learn more about: Expression Evaluator Error CXX0050" +ms.date: 11/04/2016 f1_keywords: ["CXX0050"] helpviewer_keywords: ["CAN0050", "CXX0050"] -ms.assetid: 214cd193-c6dc-41b9-9ebe-5a4b1689d3ab --- # Expression Evaluator Error CXX0050 -left side of :: must be class/struct/union +> left side of :: must be class/struct/union + +## Remarks The symbol on the left side of the scope-resolution operator (`::`) was not a class, structure, or union. diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0051.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0051.md index 5b1d1ec0327..fc6eec58a37 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0051.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0051.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Expression Evaluator Error CXX0051" title: "Expression Evaluator Error CXX0051" -ms.date: "11/04/2016" +description: "Learn more about: Expression Evaluator Error CXX0051" +ms.date: 11/04/2016 f1_keywords: ["CXX0051"] helpviewer_keywords: ["CAN0051", "CXX0051"] -ms.assetid: 031cd2ed-d9bb-4aa5-9858-71581bcca49c --- # Expression Evaluator Error CXX0051 -more than one overloaded symbol specified in breakpoint +> more than one overloaded symbol specified in breakpoint + +## Remarks The expression evaluator could not determine which of more than one overloaded symbol to use as a breakpoint. diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0052.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0052.md index d8b78b97660..dc68472dc00 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0052.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0052.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Expression Evaluator Error CXX0052" title: "Expression Evaluator Error CXX0052" -ms.date: "11/04/2016" +description: "Learn more about: Expression Evaluator Error CXX0052" +ms.date: 11/04/2016 f1_keywords: ["CXX0052"] helpviewer_keywords: ["CXX0052", "CAN0052"] -ms.assetid: 5060d479-d0a4-4682-b858-c8b9a4f324e6 --- # Expression Evaluator Error CXX0052 -member function not present +> member function not present + +## Remarks A member function was specified as a breakpoint but could not be found. Setting a breakpoint at a function that has been inlined can cause this error. diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0053.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0053.md index 7760402f7fc..377bf54a6d7 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0053.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0053.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Expression Evaluator Error CXX0053" title: "Expression Evaluator Error CXX0053" -ms.date: "11/04/2016" +description: "Learn more about: Expression Evaluator Error CXX0053" +ms.date: 11/04/2016 f1_keywords: ["CXX0053"] helpviewer_keywords: ["CAN0053", "CXX0053"] -ms.assetid: fe74ed9e-9241-4df1-881f-104348e296c6 --- # Expression Evaluator Error CXX0053 -nonfunction symbol match while binding breakpoints +> nonfunction symbol match while binding breakpoints + +## Remarks A symbol used as a breakpoint was not a function. Specifying a data member as a breakpoint can cause this error. diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0054.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0054.md index 2e504742e30..d8c42073585 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0054.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0054.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Expression Evaluator Error CXX0054" title: "Expression Evaluator Error CXX0054" -ms.date: "11/04/2016" +description: "Learn more about: Expression Evaluator Error CXX0054" +ms.date: 11/04/2016 f1_keywords: ["CXX0054"] helpviewer_keywords: ["CXX0054", "CAN0054"] -ms.assetid: d5d4a093-6a7a-45c0-8aa7-e555023353ef --- # Expression Evaluator Error CXX0054 -register in breakpoint expression illegal +> register in breakpoint expression illegal + +## Remarks A register cannot be used in a breakpoint expression. diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0055.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0055.md index 3a625d08968..c0539bf5118 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0055.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0055.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Expression Evaluator Error CXX0055" title: "Expression Evaluator Error CXX0055" -ms.date: "11/04/2016" +description: "Learn more about: Expression Evaluator Error CXX0055" +ms.date: 11/04/2016 f1_keywords: ["CXX0055"] helpviewer_keywords: ["CAN0055", "CXX0055"] -ms.assetid: bb2a81f9-35ea-4b02-a49e-6b2c7023aebd --- # Expression Evaluator Error CXX0055 -ambiguous symbol in context operator +> ambiguous symbol in context operator + +## Remarks A symbol in the context operator (**{}**) referred to more than one symbol in the program. diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0056.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0056.md index 5c0937c856a..2c5f48a2a20 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0056.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0056.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Expression Evaluator Error CXX0056" title: "Expression Evaluator Error CXX0056" -ms.date: "11/04/2016" +description: "Learn more about: Expression Evaluator Error CXX0056" +ms.date: 11/04/2016 f1_keywords: ["CXX0056"] helpviewer_keywords: ["CXX0056", "CAN0056"] -ms.assetid: a67c90e0-933c-43f2-a548-0ba272920331 --- # Expression Evaluator Error CXX0056 -error in line number +> error in line number + +## Remarks An invalid line number was specified. diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0057.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0057.md index b3fec54b4e8..5b31455260d 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0057.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0057.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Expression Evaluator Error CXX0057" title: "Expression Evaluator Error CXX0057" -ms.date: "11/04/2016" +description: "Learn more about: Expression Evaluator Error CXX0057" +ms.date: 11/04/2016 f1_keywords: ["CXX0057"] helpviewer_keywords: ["CAN0057", "CXX0057"] -ms.assetid: b1a86998-c642-4061-9f37-9c493f3852cc --- # Expression Evaluator Error CXX0057 -no code at line number +> no code at line number + +## Remarks No code was generated for the specified line number. It cannot be used as a breakpoint. diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0058.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0058.md index 01b1de640fd..e96576696fb 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0058.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0058.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Expression Evaluator Error CXX0058" title: "Expression Evaluator Error CXX0058" -ms.date: "11/04/2016" +description: "Learn more about: Expression Evaluator Error CXX0058" +ms.date: 11/04/2016 f1_keywords: ["CXX0058"] helpviewer_keywords: ["CXX0058", "CAN0058"] -ms.assetid: b6246c6e-5845-4ad5-ac2a-e6c4faf8f3f9 --- # Expression Evaluator Error CXX0058 -overloaded operator not found +> overloaded operator not found + +## Remarks A class type was specified as the left operand in an expression, but an overloaded operator was not defined for the class. diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0059.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0059.md index bf9ea31ecda..67c0a953c68 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0059.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0059.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Expression Evaluator Error CXX0059" title: "Expression Evaluator Error CXX0059" -ms.date: "11/04/2016" +description: "Learn more about: Expression Evaluator Error CXX0059" +ms.date: 11/04/2016 f1_keywords: ["CXX0059"] helpviewer_keywords: ["CXX0059", "CAN0059"] -ms.assetid: e8bdcb74-1315-4083-b24d-e47eac7d1ec0 --- # Expression Evaluator Error CXX0059 -left operand is class not a function name +> left operand is class not a function name + +## Remarks The left operand of a function call was a class name and could not be resolved to a function call. Omitting the name of a member function in an expression can cause this error. diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0060.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0060.md index d4796731c77..e3daf580ae6 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0060.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0060.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Expression Evaluator Error CXX0060" title: "Expression Evaluator Error CXX0060" -ms.date: "11/04/2016" +description: "Learn more about: Expression Evaluator Error CXX0060" +ms.date: 11/04/2016 f1_keywords: ["CXX0060"] helpviewer_keywords: ["CAN0060", "CXX0060"] -ms.assetid: 40c0ff02-ca6b-4232-b1e3-1f3a213ee2a3 --- # Expression Evaluator Error CXX0060 -register is not available +> register is not available + +## Remarks An expression specified a register that cannot be used. This error can be caused by trying to access a register that does not exist on the machine running. diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0061.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0061.md index 7afc6294ae4..35275227563 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0061.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0061.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Expression Evaluator Error CXX0061" title: "Expression Evaluator Error CXX0061" -ms.date: "11/04/2016" +description: "Learn more about: Expression Evaluator Error CXX0061" +ms.date: 11/04/2016 f1_keywords: ["CXX0061"] helpviewer_keywords: ["CXX0061", "CAN0061"] -ms.assetid: fa84dcca-87ef-4546-9dce-636ed39e0713 --- # Expression Evaluator Error CXX0061 -function nesting depth exceeded +> function nesting depth exceeded + +## Remarks The expression contains a function nesting depth greater than the limit. Modify the expression to reduce the nesting depth. diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0062.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0062.md index 72ec432ce17..3265d6746bc 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0062.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0062.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Expression Evaluator Error CXX0062" title: "Expression Evaluator Error CXX0062" -ms.date: "11/04/2016" +description: "Learn more about: Expression Evaluator Error CXX0062" +ms.date: 11/04/2016 f1_keywords: ["CXX0062"] helpviewer_keywords: ["CAN0062", "CGopherFile class, operations"] -ms.assetid: 8e4165c4-7753-4f45-90e9-4542cbb9fc7a --- # Expression Evaluator Error CXX0062 -constructor calls not supported +> constructor calls not supported + +## Remarks An expression made a call to a constructor. Expressions cannot make explicit calls to constructors or make conversions that require a call to a constructor. diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0063.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0063.md index 34e824c32bd..4e753d841e6 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0063.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0063.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Expression Evaluator Error CXX0063" title: "Expression Evaluator Error CXX0063" -ms.date: "11/04/2016" +description: "Learn more about: Expression Evaluator Error CXX0063" +ms.date: 11/04/2016 f1_keywords: ["CXX0063"] helpviewer_keywords: ["CXX0063", "CAN0063"] -ms.assetid: 2e131b7a-9c8f-4aa1-acac-8d87f602c24c --- # Expression Evaluator Error CXX0063 -overloaded operator -> not supported +> overloaded operator -> not supported + +## Remarks The expression used an overloaded class member access operator (**->**). diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0064.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0064.md index 74c67df4ac8..ceebc4c6727 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0064.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0064.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Expression Evaluator Error CXX0064" title: "Expression Evaluator Error CXX0064" -ms.date: "11/04/2016" +description: "Learn more about: Expression Evaluator Error CXX0064" +ms.date: 11/04/2016 f1_keywords: ["CXX0064"] helpviewer_keywords: ["CAN0064", "CXX0064"] -ms.assetid: aa509e71-0616-41ca-a94e-6c376b041e57 --- # Expression Evaluator Error CXX0064 -can't set breakpoint on bound virtual member function +> can't set breakpoint on bound virtual member function + +## Example A breakpoint was set on a virtual member function through a pointer to an object, such as: diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0065.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0065.md index f768cdc47b6..494f6ff1bfc 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0065.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0065.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Expression Evaluator Error CXX0065" title: "Expression Evaluator Error CXX0065" -ms.date: "11/04/2016" +description: "Learn more about: Expression Evaluator Error CXX0065" +ms.date: 11/04/2016 f1_keywords: ["CXX0065"] helpviewer_keywords: ["CAN0065", "CXX0065"] -ms.assetid: aac68f87-0b90-4c19-afa6-1c587625a5fd --- # Expression Evaluator Error CXX0065 -variable needs stack frame +> variable needs stack frame + +## Remarks An expression contained a variable that exists within the current scope but hasn't been created yet. diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0066.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0066.md index 0ef4bf1d8c0..e31743fe4a9 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0066.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0066.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Expression Evaluator Error CXX0066" title: "Expression Evaluator Error CXX0066" -ms.date: "11/04/2016" +description: "Learn more about: Expression Evaluator Error CXX0066" +ms.date: 11/04/2016 f1_keywords: ["CXX0066"] helpviewer_keywords: ["CXX0066", "CAN0066"] -ms.assetid: 1321e4e1-b441-424b-9e76-c208d4a6f6ea --- # Expression Evaluator Error CXX0066 -static member not present +> static member not present + +## Remarks A static member of a class could not be found or was not defined. This error can result from a static class member that is declared but not defined, or is only defined and referenced in modules that do not contain debug information. diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0067.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0067.md index daa7e12991d..27d75853cce 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0067.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0067.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Expression Evaluator Error CXX0067" title: "Expression Evaluator Error CXX0067" -ms.date: "11/04/2016" +description: "Learn more about: Expression Evaluator Error CXX0067" +ms.date: 11/04/2016 f1_keywords: ["CXX0067"] helpviewer_keywords: ["CXX0067", "CAN0067"] -ms.assetid: 9a3e642b-4746-41ac-b665-bd98a6fa0cb3 --- # Expression Evaluator Error CXX0067 -function evaluation not supported +> function evaluation not supported + +## Remarks The expression contained a function call. Some expression evaluators do not support function calls. diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0069.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0069.md index 70808d356e4..0fefde08dbf 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0069.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0069.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Expression Evaluator Error CXX0069" title: "Expression Evaluator Error CXX0069" -ms.date: "11/04/2016" +description: "Learn more about: Expression Evaluator Error CXX0069" +ms.date: 11/04/2016 f1_keywords: ["CXX0069"] helpviewer_keywords: ["CXX0069"] -ms.assetid: cf334b23-1e17-4d37-acc5-18597ee84164 --- # Expression Evaluator Error CXX0069 -variable needs stack frame +> variable needs stack frame + +## Remarks The expression evaluator cannot evaluate the variable because it does not occur in a stack frame. This may be caused by variables declared as part of an inline function. diff --git a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0072.md b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0072.md index b731c03e1db..e7abb58a2dd 100644 --- a/docs/error-messages/tool-errors/expression-evaluator-error-cxx0072.md +++ b/docs/error-messages/tool-errors/expression-evaluator-error-cxx0072.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Expression Evaluator Error CXX0072" title: "Expression Evaluator Error CXX0072" -ms.date: "11/04/2016" +description: "Learn more about: Expression Evaluator Error CXX0072" +ms.date: 11/04/2016 f1_keywords: ["CXX0072"] helpviewer_keywords: ["CAN0072", "CXX0072"] -ms.assetid: fd04e197-cfa9-4097-a070-8fa2111e876d --- # Expression Evaluator Error CXX0072 -Error: type information missing or unknown +> Error: type information missing or unknown + +## Remarks The .pch file did not get linked in, or the code has a reference to a type that is in a module not compiled with /Zi. diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk1000.md b/docs/error-messages/tool-errors/linker-tools-error-lnk1000.md index 31e9114a632..d769aac9547 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk1000.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk1000.md @@ -1,15 +1,16 @@ --- -description: "Learn more about: Linker Tools Error LNK1000" title: "Linker Tools Error LNK1000" -ms.date: "06/18/2018" +description: "Learn more about: Linker Tools Error LNK1000" +ms.date: 06/18/2018 f1_keywords: ["LNK1000"] helpviewer_keywords: ["LNK1000"] -ms.assetid: 86421b9a-460a-4285-8dce-9b8257d78122 --- # Linker Tools Error LNK1000 > unknown error; consult documentation for technical support options +## Remarks + Note the circumstances of the error, then try to isolate the problem and create a reproducible test case. For information on how to investigate and report these errors, see [How to report a problem with the Visual C++ toolset or documentation](../../overview/how-to-report-a-problem-with-the-visual-cpp-toolset.md). You may get this error if you mix standard header files (for example, Windows.h) and your own files. Include a precompiled header, if any, first, then the standard headers, followed by your own header files. diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk1103.md b/docs/error-messages/tool-errors/linker-tools-error-lnk1103.md index 69a19334cb3..f49a578deee 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk1103.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk1103.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Linker Tools Error LNK1103" title: "Linker Tools Error LNK1103" -ms.date: "11/04/2016" +description: "Learn more about: Linker Tools Error LNK1103" +ms.date: 11/04/2016 f1_keywords: ["LNK1103"] helpviewer_keywords: ["LNK1103"] -ms.assetid: c8e9bc54-6a71-471c-899e-6f98122ee3c4 --- # Linker Tools Error LNK1103 -debugging information corrupt; recompile module +> debugging information corrupt; recompile module + +## Remarks This error can be caused because the compilation was terminated before a valid object file was created. diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk1104.md b/docs/error-messages/tool-errors/linker-tools-error-lnk1104.md index dd6c44187f2..cade1e6b606 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk1104.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk1104.md @@ -1,15 +1,16 @@ --- title: "Linker Tools Error LNK1104" description: "Describes the Microsoft C and C++ (MSVC) linker error LNK1104, its causes, and possible solutions." -ms.date: "12/13/2019" +ms.date: 12/13/2019 f1_keywords: ["LNK1104"] helpviewer_keywords: ["LNK1104"] -ms.assetid: 9ca6f929-0efc-4055-8354-3cf5b4e636dc --- # Linker Tools Error LNK1104 > cannot open file '*filename*' +## Remarks + This error is reported when the linker fails to open a file, either for reading or for writing. The two most common causes of the issue are: - your program is already running or is loaded in the debugger, and diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk1106.md b/docs/error-messages/tool-errors/linker-tools-error-lnk1106.md index f1227a53aa8..662214bd59b 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk1106.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk1106.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Linker Tools Error LNK1106" title: "Linker Tools Error LNK1106" -ms.date: "11/04/2016" +description: "Learn more about: Linker Tools Error LNK1106" +ms.date: 11/04/2016 f1_keywords: ["LNK1106"] helpviewer_keywords: ["LNK1106"] -ms.assetid: 528f7e65-04be-4966-b8af-9276837c7cda --- # Linker Tools Error LNK1106 -invalid file or disk full: cannot seek to location +> invalid file or disk full: cannot seek to location + +## Remarks The tool could not read or write to `location` in a memory-mapped file. diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk1107.md b/docs/error-messages/tool-errors/linker-tools-error-lnk1107.md index af391885733..75ae3cc8c30 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk1107.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk1107.md @@ -1,6 +1,6 @@ --- -description: "Learn more about: Linker tools error LNK1107" title: "Linker tools error LNK1107" +description: "Learn more about: Linker tools error LNK1107" ms.date: 12/10/2021 f1_keywords: ["LNK1107"] helpviewer_keywords: ["LNK1107"] @@ -9,10 +9,10 @@ helpviewer_keywords: ["LNK1107"] > invalid or corrupt file: cannot read at location *address* -The tool couldn't read the file. The file may be corrupt, or have an unexpected file type. - ## Remarks +The tool couldn't read the file. The file may be corrupt, or have an unexpected file type. + LNK1107 can occur if a file passed to the linker or related tools is corrupt. To resolve this issue, rebuild the file. LNK1107 can also occur if your build process puts an unexpected file type in the list of files passed to the tool. The linker and related tools expect to work on specific file types. For example, the linker can use object files, library files, compiled resources, and manifests to create an executable. It can't create an executable by using source files or DLLs. To resolve this issue, verify that your build process passes only the expected file types to the tool. For example, pass *`.obj`*, *`.lib`*, and *`.res`* files, not *`.cpp`*, *`.h`*, *`.dll`*, or *`.rc`* files. diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk1112.md b/docs/error-messages/tool-errors/linker-tools-error-lnk1112.md index 0e62d587977..67286e66572 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk1112.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk1112.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Linker Tools Error LNK1112" title: "Linker Tools Error LNK1112" +description: "Learn more about: Linker Tools Error LNK1112" ms.date: 05/23/2022 f1_keywords: ["LNK1112"] helpviewer_keywords: ["LNK1112"] -ms.assetid: 425793d8-37e6-4072-9b6e-c3d4e9c12562 --- # Linker Tools Error LNK1112 diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk1113.md b/docs/error-messages/tool-errors/linker-tools-error-lnk1113.md index aaafcbbcded..feb9df5031f 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk1113.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk1113.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Linker Tools Error LNK1113" title: "Linker Tools Error LNK1113" -ms.date: "11/04/2016" +description: "Learn more about: Linker Tools Error LNK1113" +ms.date: 11/04/2016 f1_keywords: ["LNK1113"] helpviewer_keywords: ["LNK1113"] -ms.assetid: 269ff166-b143-48e9-bdf7-db6a0db59fe4 --- # Linker Tools Error LNK1113 -invalid machine type type +> invalid machine type type + +## Remarks The machine type specified in the object header is not valid. diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk1120.md b/docs/error-messages/tool-errors/linker-tools-error-lnk1120.md index 62a290603e5..852a5668232 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk1120.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk1120.md @@ -1,15 +1,16 @@ --- title: "Linker tools error LNK1120" description: "Describes the LNK1120 linker error, which reports the number of unresolved external symbol errors in the link." -ms.date: "10/31/2019" +ms.date: 10/31/2019 f1_keywords: ["LNK1120"] helpviewer_keywords: ["LNK1120"] -ms.assetid: 56aa7d36-921f-4daf-b44d-cca0d4fb1b51 --- # Linker tools error LNK1120 > *number* unresolved externals +## Remarks + Error LNK1120 reports the number of [unresolved external symbol](linker-tools-error-lnk2001.md#what-is-an-unresolved-external-symbol) errors in the current link. Each unresolved external symbol first gets reported by a [LNK2001](linker-tools-error-lnk2001.md) or [LNK2019](linker-tools-error-lnk2019.md) error. The LNK1120 message comes last, and shows the unresolved symbol error count. diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk1123.md b/docs/error-messages/tool-errors/linker-tools-error-lnk1123.md index 07bfa2d8cc8..3059a757de8 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk1123.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk1123.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: Linker Tools Error LNK1123" title: "Linker Tools Error LNK1123" -ms.date: "12/29/2017" +description: "Learn more about: Linker Tools Error LNK1123" +ms.date: 12/29/2017 f1_keywords: ["LNK1123"] helpviewer_keywords: ["LNK1123"] --- @@ -9,6 +9,8 @@ helpviewer_keywords: ["LNK1123"] > failure during conversion to COFF: file invalid or corrupt +## Remarks + Input files must have the Common Object File Format (COFF) format. If an input file is not COFF, the linker automatically tries to convert 32-bit OMF objects to COFF, or runs CVTRES.EXE to convert resource files. This message indicates that the linker could not convert the file. This can also occur when using an incompatible version of CVTRES.EXE from another installation of Visual Studio, the Windows Development Kit, or .NET Framework. > [!NOTE] diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk1127.md b/docs/error-messages/tool-errors/linker-tools-error-lnk1127.md index 85695de1e0c..d2acd271220 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk1127.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk1127.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Linker Tools Error LNK1127" title: "Linker Tools Error LNK1127" -ms.date: "11/04/2016" +description: "Learn more about: Linker Tools Error LNK1127" +ms.date: 11/04/2016 f1_keywords: ["LNK1127"] helpviewer_keywords: ["LNK1127"] -ms.assetid: 45404700-1420-4f24-97e1-efb7252ffd8f --- # Linker Tools Error LNK1127 -library is corrupt +> library is corrupt + +## Remarks The library file is corrupt. Rebuild the library. diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk1136.md b/docs/error-messages/tool-errors/linker-tools-error-lnk1136.md index 3178558c899..0c4dee8bb92 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk1136.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk1136.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Linker Tools Error LNK1136" title: "Linker Tools Error LNK1136" -ms.date: "11/04/2016" +description: "Learn more about: Linker Tools Error LNK1136" +ms.date: 11/04/2016 f1_keywords: ["LNK1136"] helpviewer_keywords: ["LNK1136"] -ms.assetid: 40c6d909-eb3f-4045-a0fc-4caa2f6db506 --- # Linker Tools Error LNK1136 -invalid or corrupt file +> invalid or corrupt file + +## Remarks The input file either has a corrupt header or is zero size or abnormally small. diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk1140.md b/docs/error-messages/tool-errors/linker-tools-error-lnk1140.md index 122f869f78d..32776a589dc 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk1140.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk1140.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Linker Tools Error LNK1140" title: "Linker Tools Error LNK1140" -ms.date: "11/04/2016" +description: "Learn more about: Linker Tools Error LNK1140" +ms.date: 11/04/2016 f1_keywords: ["LNK1140"] helpviewer_keywords: ["LNK1140"] -ms.assetid: 468d7651-a7cd-47b9-aead-5bb2fab56121 --- # Linker Tools Error LNK1140 -too many modules for program database; link with /PDB:NONE +> too many modules for program database; link with /PDB:NONE + +## Remarks The project contains more than 4096 modules. diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk1141.md b/docs/error-messages/tool-errors/linker-tools-error-lnk1141.md index 6f75fcc90a4..11f1c42106c 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk1141.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk1141.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Linker Tools Error LNK1141" title: "Linker Tools Error LNK1141" -ms.date: "11/04/2016" +description: "Learn more about: Linker Tools Error LNK1141" +ms.date: 11/04/2016 f1_keywords: ["LNK1141"] helpviewer_keywords: ["LNK1141"] -ms.assetid: 83b78606-6dd3-43a7-88e2-152f5359cbd8 --- # Linker Tools Error LNK1141 -failure during build of exports file +> failure during build of exports file + +## Remarks [LINK](../../build/reference/linking.md) could not build the exports (.exp) file. diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk1143.md b/docs/error-messages/tool-errors/linker-tools-error-lnk1143.md index 0e06f04ee32..3d852635bb1 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk1143.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk1143.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Linker Tools Error LNK1143" title: "Linker Tools Error LNK1143" -ms.date: "11/04/2016" +description: "Learn more about: Linker Tools Error LNK1143" +ms.date: 11/04/2016 f1_keywords: ["LNK1143"] helpviewer_keywords: ["LNK1143"] -ms.assetid: 5dc6b634-d142-4448-b5ea-48e8fb10c10a --- # Linker Tools Error LNK1143 -invalid or corrupt file: no symbol for COMDAT section number +> invalid or corrupt file: no symbol for COMDAT section number + +## Remarks This error can be caused if the object file is corrupt. diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk1152.md b/docs/error-messages/tool-errors/linker-tools-error-lnk1152.md index 5929d7abbf6..94733880e80 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk1152.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk1152.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Linker Tools Error LNK1152" title: "Linker Tools Error LNK1152" -ms.date: "11/04/2016" +description: "Learn more about: Linker Tools Error LNK1152" +ms.date: 11/04/2016 f1_keywords: ["LNK1152"] helpviewer_keywords: ["LNK1152"] -ms.assetid: 2523b61a-1359-4612-9c16-7d1f705f32e6 --- # Linker Tools Error LNK1152 -cannot resolve one or more undecorated symbols +> cannot resolve one or more undecorated symbols + +## Remarks This error is preceded by one warning [LNK4022](../../error-messages/tool-errors/linker-tools-warning-lnk4022.md) for each undecorated symbol that could not be resolved and by at least two warnings [LNK4002](../../error-messages/tool-errors/linker-tools-warning-lnk4002.md) for the duplicate symbols found for the undecorated symbol. diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk1158.md b/docs/error-messages/tool-errors/linker-tools-error-lnk1158.md index f2350017bc0..c439b181dde 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk1158.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk1158.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Linker Tools Error LNK1158" title: "Linker Tools Error LNK1158" -ms.date: "11/04/2016" +description: "Learn more about: Linker Tools Error LNK1158" +ms.date: 11/04/2016 f1_keywords: ["LNK1158"] helpviewer_keywords: ["LNK1158"] -ms.assetid: 45febf16-d9e1-42db-af91-532e2717fd6a --- # Linker Tools Error LNK1158 -cannot run 'filename' +> cannot run 'filename' + +## Remarks The given executable file called by [LINK](../../build/reference/linking.md) is not in the directory that contains LINK nor in a directory specified in the PATH environment variable. diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk1164.md b/docs/error-messages/tool-errors/linker-tools-error-lnk1164.md index dbcffd442ea..065ff3d8f75 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk1164.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk1164.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Linker Tools Error LNK1164" title: "Linker Tools Error LNK1164" -ms.date: "11/04/2016" +description: "Learn more about: Linker Tools Error LNK1164" +ms.date: 11/04/2016 f1_keywords: ["LNK1164"] helpviewer_keywords: ["LNK1164"] -ms.assetid: da89765c-affa-4f88-b170-6d6b19a577cf --- # Linker Tools Error LNK1164 -section section alignment (number) greater than /ALIGN value +> section section alignment (number) greater than /ALIGN value + +## Remarks The alignment size for the given section in the object file exceeds the value specified with the [/ALIGN](../../build/reference/align-section-alignment.md) option. The **/ALIGN** value must be a power of 2 and must equal or exceed the section alignment given in the object file. diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk1166.md b/docs/error-messages/tool-errors/linker-tools-error-lnk1166.md index b67c5fb58e5..e9afdd5624e 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk1166.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk1166.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Linker Tools Error LNK1166" title: "Linker Tools Error LNK1166" -ms.date: "11/04/2016" +description: "Learn more about: Linker Tools Error LNK1166" +ms.date: 11/04/2016 f1_keywords: ["LNK1166"] helpviewer_keywords: ["LNK1166"] -ms.assetid: d69548a8-0efb-44e1-90b7-b27636a4b575 --- # Linker Tools Error LNK1166 -cannot adjust code at offset=offset, va=value +> cannot adjust code at offset=offset, va=value + +## Remarks LINK was unable to pad the code as required. diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk1168.md b/docs/error-messages/tool-errors/linker-tools-error-lnk1168.md index 78fddef3f0a..fd72aa34b40 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk1168.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk1168.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Linker Tools Error LNK1168" title: "Linker Tools Error LNK1168" -ms.date: "11/04/2016" +description: "Learn more about: Linker Tools Error LNK1168" +ms.date: 11/04/2016 f1_keywords: ["LNK1168"] helpviewer_keywords: ["LNK1168"] -ms.assetid: 97ead151-fd99-46fe-9a1d-7e84dc0b8cc8 --- # Linker Tools Error LNK1168 -cannot open filename for writing +> cannot open filename for writing + +## Remarks The linker can't write to `filename`. The file may be in use and its file handle locked by another process, or you may not have write permission for the file, or for the directory or network share it is located in. This error is often caused by a transient condition—for example, a lock held by an anti-virus program, a file search indexing process, or a delay in releasing a lock held by the Visual Studio build system. diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk1169.md b/docs/error-messages/tool-errors/linker-tools-error-lnk1169.md index f3355d082cd..20e35c0d767 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk1169.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk1169.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Linker Tools Error LNK1169" title: "Linker Tools Error LNK1169" -ms.date: "11/04/2016" +description: "Learn more about: Linker Tools Error LNK1169" +ms.date: 11/04/2016 f1_keywords: ["LNK1169"] helpviewer_keywords: ["LNK1169"] -ms.assetid: e079d518-f184-48cd-8b38-969bf137af54 --- # Linker Tools Error LNK1169 -one or more multiply defined symbols found +> one or more multiply defined symbols found + +## Remarks The build failed due to multiple definitions of one or more symbols. This error is preceded by error [LNK2005](../../error-messages/tool-errors/linker-tools-error-lnk2005.md). diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk1170.md b/docs/error-messages/tool-errors/linker-tools-error-lnk1170.md index 7b4979f8e5b..1bfdd6a7cb1 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk1170.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk1170.md @@ -1,15 +1,16 @@ --- -description: "Learn more about: Linker tools Error LNK1170" title: "Linker tools Error LNK1170" +description: "Learn more about: Linker tools Error LNK1170" ms.date: 05/17/2022 f1_keywords: ["LNK1170"] helpviewer_keywords: ["LNK1170"] -ms.assetid: e079d518-f184-48cd-8b38-969bf137af54 --- # Linker tools Error LNK1170 > line in command file contains *maximum-length* or more characters +## Remarks + The build failed because a line in a command response file was too long. A line in an automatically generated response file may be too long for many reasons. For example, this error may occur if the number of object file names is too high. Or, if the combined lengths of the paths included in object file names is too long. The appropriate fix for this issue depends on the cause. For example, if it's caused by long paths in object file names, you may try to shorten the directory names in the path. Or, move the project tree into a directory closer to the root of the drive. You may want to break up how response files are generated and consumed by your build system, for instance, by generating some code as static libraries. diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk1179.md b/docs/error-messages/tool-errors/linker-tools-error-lnk1179.md index 6b95e3bc95d..9007d33d95c 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk1179.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk1179.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Linker Tools Error LNK1179" title: "Linker Tools Error LNK1179" -ms.date: "11/04/2016" +description: "Learn more about: Linker Tools Error LNK1179" +ms.date: 11/04/2016 f1_keywords: ["LNK1179"] helpviewer_keywords: ["LNK1179"] -ms.assetid: 4b1536d7-0d3d-4f29-a9c1-6fa5cf6cb665 --- # Linker Tools Error LNK1179 -invalid or corrupt file: duplicate COMDAT 'filename' +> invalid or corrupt file: duplicate COMDAT 'filename' + +## Remarks An object module contains two or more COMDATs with the same name. diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk1181.md b/docs/error-messages/tool-errors/linker-tools-error-lnk1181.md index 0a8bdc45693..3212fbf52a1 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk1181.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk1181.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Linker Tools Error LNK1181" title: "Linker Tools Error LNK1181" -ms.date: "08/22/2018" +description: "Learn more about: Linker Tools Error LNK1181" +ms.date: 08/22/2018 f1_keywords: ["LNK1181"] helpviewer_keywords: ["LNK1181"] -ms.assetid: 984b0db6-e331-4284-b2a7-a212fe96c486 --- # Linker Tools Error LNK1181 -cannot open input file 'filename' +> cannot open input file 'filename' + +## Remarks The linker could not find `filename` because it does not exist or the path was not found. diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk1188.md b/docs/error-messages/tool-errors/linker-tools-error-lnk1188.md index f5800616ee0..fa68aa2479c 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk1188.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk1188.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Linker Tools Error LNK1188" title: "Linker Tools Error LNK1188" -ms.date: "11/04/2016" +description: "Learn more about: Linker Tools Error LNK1188" +ms.date: 11/04/2016 f1_keywords: ["LNK1188"] helpviewer_keywords: ["LNK1188"] -ms.assetid: 4af574b0-5b41-4580-9a37-52a634add995 --- # Linker Tools Error LNK1188 -BADFIXUPSECTION:: invalid fixup target 'symbol'; possible zero length section +> BADFIXUPSECTION:: invalid fixup target 'symbol'; possible zero length section + +## Remarks During a VxD link, the target of a relocation did not have a section. With LINK386 (an older version), an OMF GROUP record (generated by a MASM GROUP directive) may have been used to combine the zero length section with another non-zero length section. COFF format does not support the GROUP directive and zero-length sections. When LINK automatically converts this type of OMF objects to COFF, this error may occur. diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk1189.md b/docs/error-messages/tool-errors/linker-tools-error-lnk1189.md index fc1bfb4f8d4..3638265d0cc 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk1189.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk1189.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Linker Tools Error LNK1189" title: "Linker Tools Error LNK1189" -ms.date: "11/04/2016" +description: "Learn more about: Linker Tools Error LNK1189" +ms.date: 11/04/2016 f1_keywords: ["LNK1189"] helpviewer_keywords: ["LNK1189"] -ms.assetid: 40c45302-6967-497e-9a6e-c2ca039fc1ed --- # Linker Tools Error LNK1189 -LIBTOOMANYMEMBERS:: library limit of number objects exceeded +> LIBTOOMANYMEMBERS:: library limit of number objects exceeded + +## Remarks The limit of 65535 objects or members in a library has been exceeded. diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk1196.md b/docs/error-messages/tool-errors/linker-tools-error-lnk1196.md index 050af899a89..8b9f7cff7de 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk1196.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk1196.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Linker Tools Error LNK1196" title: "Linker Tools Error LNK1196" -ms.date: "11/04/2016" +description: "Learn more about: Linker Tools Error LNK1196" +ms.date: 11/04/2016 f1_keywords: ["LNK1196"] helpviewer_keywords: ["LNK1196"] -ms.assetid: d0c6859b-85aa-45cc-9f5f-fc1f7070ab5a --- # Linker Tools Error LNK1196 -invalid or corrupt import object: unknown version +> invalid or corrupt import object: unknown version + +## Remarks The import library is corrupted. Rebuild the library. diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk1200.md b/docs/error-messages/tool-errors/linker-tools-error-lnk1200.md index c07c0b16e83..cbf43a2a49b 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk1200.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk1200.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Linker Tools Error LNK1200" title: "Linker Tools Error LNK1200" -ms.date: "11/04/2016" +description: "Learn more about: Linker Tools Error LNK1200" +ms.date: 11/04/2016 f1_keywords: ["LNK1200"] helpviewer_keywords: ["LNK1200"] -ms.assetid: 55771145-915e-4006-ac6c-ac702041eb2f --- # Linker Tools Error LNK1200 -error reading program database 'filename' +> error reading program database 'filename' + +## Remarks The program database (PDB) could not be read. diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk1201.md b/docs/error-messages/tool-errors/linker-tools-error-lnk1201.md index 8e8f1888c04..4dc5e1a5bce 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk1201.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk1201.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Linker Tools Error LNK1201" title: "Linker Tools Error LNK1201" -ms.date: "11/04/2016" +description: "Learn more about: Linker Tools Error LNK1201" +ms.date: 11/04/2016 f1_keywords: ["LNK1201"] helpviewer_keywords: ["LNK1201"] -ms.assetid: 64c3f496-a428-4b54-981e-faa82ef9c8a1 --- # Linker Tools Error LNK1201 -error writing to program database 'filename'; check for insufficient disk space, invalid path, or insufficient privilege +> error writing to program database 'filename'; check for insufficient disk space, invalid path, or insufficient privilege + +## Remarks LINK could not write to the program database (PDB) for the output file. diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk1211.md b/docs/error-messages/tool-errors/linker-tools-error-lnk1211.md index 0cdaf996a71..dffce63c093 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk1211.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk1211.md @@ -1,15 +1,16 @@ --- -description: "Learn more about: Linker Tools Error LNK1211" title: "Linker Tools Error LNK1211" -ms.date: "12/05/2017" +description: "Learn more about: Linker Tools Error LNK1211" +ms.date: 12/05/2017 f1_keywords: ["LNK1211"] helpviewer_keywords: ["LNK1211"] -ms.assetid: 607400eb-4180-4892-817f-eedfa628af61 --- # Linker Tools Error LNK1211 > precompiled type information not found; '*filename*' not linked or overwritten +## Remarks + The *filename* object file, compiled by using [/Yc](../../build/reference/yc-create-precompiled-header-file.md), was not specified in the LINK command or was overwritten. If you are creating a debug library that uses precompiled headers and if you specify **/Yc** and [/Z7](../../build/reference/z7-zi-zi-debug-information-format.md), Visual C++ generates a precompiled object file that contains debug information. The error occurs only when you store the precompiled object file in a library, use the library to build an executable image, and the object files that are referenced have no transitive references to any of the functions the precompiled object file defines. diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk1215.md b/docs/error-messages/tool-errors/linker-tools-error-lnk1215.md index 2323a27f564..96a368bdc10 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk1215.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk1215.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Linker Tools Error LNK1215" title: "Linker Tools Error LNK1215" -ms.date: "11/04/2016" +description: "Learn more about: Linker Tools Error LNK1215" +ms.date: 11/04/2016 f1_keywords: ["LNK1215"] helpviewer_keywords: ["LNK1215"] -ms.assetid: 0774d8e6-f0c1-4efb-8723-7e1be6863d81 --- # Linker Tools Error LNK1215 -metadata operation failed (HRESULT) : error +> metadata operation failed (HRESULT) : error + +## Remarks The linker received an error from the .NET runtime while attempting to do a metadata update through the .NET runtime. diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk1218.md b/docs/error-messages/tool-errors/linker-tools-error-lnk1218.md index 624fcb6ca33..cd40d43678a 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk1218.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk1218.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Linker Tools Error LNK1218" title: "Linker Tools Error LNK1218" -ms.date: "11/04/2016" +description: "Learn more about: Linker Tools Error LNK1218" +ms.date: 11/04/2016 f1_keywords: ["LNK1218"] helpviewer_keywords: ["LNK1218"] -ms.assetid: bf599350-be03-4344-be43-91e29c4f1556 --- # Linker Tools Error LNK1218 -warning treated as error; no output file generated +> warning treated as error; no output file generated + +## Remarks When you link with **/WX**, any linker warnings will be treated as errors, and no output file will be created. diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk1221.md b/docs/error-messages/tool-errors/linker-tools-error-lnk1221.md index f200e10465f..cf0e8c002f1 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk1221.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk1221.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Linker Tools Error LNK1221" title: "Linker Tools Error LNK1221" -ms.date: "11/04/2016" +description: "Learn more about: Linker Tools Error LNK1221" +ms.date: 11/04/2016 f1_keywords: ["LNK1221"] helpviewer_keywords: ["LNK1221"] -ms.assetid: 70654bf9-1520-4fa3-a063-1219dd88abf7 --- # Linker Tools Error LNK1221 -a subsystem can't be inferred and must be defined +> a subsystem can't be inferred and must be defined + +## Remarks The linker does not have enough information to infer which subsystem you want to target. diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk1223.md b/docs/error-messages/tool-errors/linker-tools-error-lnk1223.md index 54a615674d0..5f13930590d 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk1223.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk1223.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Linker Tools Error LNK1223" title: "Linker Tools Error LNK1223" -ms.date: "11/04/2016" +description: "Learn more about: Linker Tools Error LNK1223" +ms.date: 11/04/2016 f1_keywords: ["LNK1223"] helpviewer_keywords: ["LNK1223"] -ms.assetid: c4728c36-daee-462f-a1c7-8733dcdec88e --- # Linker Tools Error LNK1223 -invalid or corrupt file: file contains invalid .pdata contributions +> invalid or corrupt file: file contains invalid .pdata contributions + +## Remarks For RISC platforms that use pdata, this error will occur if the compiler emitted a .pdata section with unsorted entries. diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk1224.md b/docs/error-messages/tool-errors/linker-tools-error-lnk1224.md index 36dd5b331dc..49e0c86b868 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk1224.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk1224.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Linker Tools Error LNK1224" title: "Linker Tools Error LNK1224" -ms.date: "11/04/2016" +description: "Learn more about: Linker Tools Error LNK1224" +ms.date: 11/04/2016 f1_keywords: ["LNK1224"] helpviewer_keywords: ["LNK1224"] -ms.assetid: e190b5d0-ce0c-4f65-8cc0-753f1cc9758a --- # Linker Tools Error LNK1224 -invalid image base address +> invalid image base address + +## Remarks You specified an invalid base address for the image. Base addresses must be 64KB aligned (the last four hex digits must be zero) and image base must fit within a 32-bit signed or unsigned value. diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk1237.md b/docs/error-messages/tool-errors/linker-tools-error-lnk1237.md index 46248f9a0b2..153938e7ce3 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk1237.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk1237.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Linker Tools Error LNK1237" title: "Linker Tools Error LNK1237" +description: "Learn more about: Linker Tools Error LNK1237" ms.date: 06/29/2022 f1_keywords: ["LNK1237"] helpviewer_keywords: ["LNK1237"] -ms.assetid: 8722ffa8-096a-4bb0-85f9-f3aa0e10872a --- # Linker Tools Error LNK1237 @@ -20,7 +19,7 @@ To resolve LNK1237, don't use **`/GL`** to compile the symbol, or use [`/INCLUDE ## Example -The following sample generates LNK1237. To resolve this error, don't initialize the array in `LNK1237_a.cpp` and add **`/include:__chkstk`** to the link command. +The following example generates LNK1237. To resolve this error, don't initialize the array in `LNK1237_a.cpp` and add **`/include:__chkstk`** to the link command. Source file `LNK1237_a.cpp`: diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk1240.md b/docs/error-messages/tool-errors/linker-tools-error-lnk1240.md index d899064a26b..74f3f8900d1 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk1240.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk1240.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Linker Tools Error LNK1240" title: "Linker Tools Error LNK1240" -ms.date: "11/04/2016" +description: "Learn more about: Linker Tools Error LNK1240" +ms.date: 11/04/2016 f1_keywords: ["LNK1240"] helpviewer_keywords: ["LNK1240"] -ms.assetid: 7d0e065d-1015-4df0-8370-79c3cf045e1c --- # Linker Tools Error LNK1240 -failed to compile IDL content +> failed to compile IDL content + +## Remarks The linker spawned MIDL to compile embedded IDL but there was a problem. Check the errors specified by MIDL. diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk1241.md b/docs/error-messages/tool-errors/linker-tools-error-lnk1241.md index 2b423a6bec7..1c3975105b1 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk1241.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk1241.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Linker Tools Error LNK1241" title: "Linker Tools Error LNK1241" -ms.date: "11/04/2016" +description: "Learn more about: Linker Tools Error LNK1241" +ms.date: 11/04/2016 f1_keywords: ["LNK1241"] helpviewer_keywords: ["LNK1241"] -ms.assetid: 7b8b52eb-0231-4521-b52a-2bce8d3e8956 --- # Linker Tools Error LNK1241 -resource file 'resource file' already specified +> resource file 'resource file' already specified + +## Remarks This error is generated if you run **cvtres** manually from the command line and if you then pass the resulting .obj file to the linker in addition to other .res files. diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk1245.md b/docs/error-messages/tool-errors/linker-tools-error-lnk1245.md index 4622d688ed5..5ef7756cbed 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk1245.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk1245.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Linker Tools Error LNK1245" title: "Linker Tools Error LNK1245" -ms.date: "11/04/2016" +description: "Learn more about: Linker Tools Error LNK1245" +ms.date: 11/04/2016 f1_keywords: ["LNK1245"] helpviewer_keywords: ["LNK1245"] -ms.assetid: 179c8165-ffbb-44cd-9f24-5250f29577cc --- # Linker Tools Error LNK1245 -invalid subsystem 'subsystem' specified; /SUBSYSTEM must be WINDOWS, WINDOWSCE, or CONSOLE +> invalid subsystem 'subsystem' specified; /SUBSYSTEM must be WINDOWS, WINDOWSCE, or CONSOLE + +## Remarks [/clr](../../build/reference/clr-common-language-runtime-compilation.md) was used to compile the object and one of the following conditions was true: diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk1248.md b/docs/error-messages/tool-errors/linker-tools-error-lnk1248.md index dcdb91e7292..f0beb0694ef 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk1248.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk1248.md @@ -1,6 +1,6 @@ --- -description: "Learn more about: Linker Tools Error LNK1248" title: "Linker Tools Error LNK1248" +description: "Learn more about: Linker Tools Error LNK1248" ms.date: 08/31/2022 f1_keywords: ["LNK1248"] helpviewer_keywords: ["LNK1248"] diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk1256.md b/docs/error-messages/tool-errors/linker-tools-error-lnk1256.md index 8d1a5d87b2d..f2b1838e570 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk1256.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk1256.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Linker Tools Error LNK1256" title: "Linker Tools Error LNK1256" -ms.date: "11/04/2016" +description: "Learn more about: Linker Tools Error LNK1256" +ms.date: 11/04/2016 f1_keywords: ["LNK1256"] helpviewer_keywords: ["LNK1256"] -ms.assetid: 55b64b2b-a56b-436c-a55e-ec9c6dcb050e --- # Linker Tools Error LNK1256 -ALINK operation failed : reason +> ALINK operation failed : reason + +## Remarks A common reason for LNK1256 is an incorrect version number for an assembly. The value 65535 is not allowed for any part of the assembly version number. The valid range for assembly versions is 0 - 65534. @@ -16,7 +17,9 @@ LNK1256 can also be caused if ALINK could not find the named key container. Dele Another reason for LNK1256 is a version mismatch between the linker and Alink.dll. This can be caused by a corrupted Visual Studio installation. Use **Programs and Features** in the Windows Control Panel to repair or reinstall Visual Studio. -The following sample generates LNK1256: +## Example + +The following example generates LNK1256: ```cpp // LNK1256.cpp diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk1264.md b/docs/error-messages/tool-errors/linker-tools-error-lnk1264.md index 56602f576dc..b95262a2d15 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk1264.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk1264.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Linker Tools Error LNK1264" title: "Linker Tools Error LNK1264" -ms.date: "11/04/2016" +description: "Learn more about: Linker Tools Error LNK1264" +ms.date: 11/04/2016 f1_keywords: ["LNK1264"] helpviewer_keywords: ["LNK1264"] -ms.assetid: 23b1aad7-d382-42c1-bae8-db68575c57a8 --- # Linker Tools Error LNK1264 -/LTCG:PGINSTRUMENT specified but no code generation required; instrumentation failed +> /LTCG:PGINSTRUMENT specified but no code generation required; instrumentation failed + +## Remarks **/LTCG:PGINSTRUMENT** was specified but no .obj files were found that were compiled with [/GL](../../build/reference/gl-whole-program-optimization.md). Instrumentation cannot take place and the link failed. There must be at least one .obj file on the command line that is compiled with **/GL** so that the instrumentation can occur. diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk1277.md b/docs/error-messages/tool-errors/linker-tools-error-lnk1277.md index b7b4ad87f8b..79b41ded64f 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk1277.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk1277.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Linker Tools Error LNK1277" title: "Linker Tools Error LNK1277" -ms.date: "11/04/2016" +description: "Learn more about: Linker Tools Error LNK1277" +ms.date: 11/04/2016 f1_keywords: ["LNK1277"] helpviewer_keywords: ["LNK1277"] -ms.assetid: afca3de0-50cc-4140-af7a-13493a170835 --- # Linker Tools Error LNK1277 -object record not found in pgd (filename) +> object record not found in pgd (filename) + +## Remarks When using [/LTCG:PGOPTIMZE](../../build/reference/ltcg-link-time-code-generation.md), the path of one of the input .lib, def, or .obj files was different from the path on which they were found during /LTCG:PGINSTRUMENT. This may be explained by a change in the LIB environment variable after /LTCG:PGINSTRUMENT. The full path to the input files is stored in the .pgd file. diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk1282.md b/docs/error-messages/tool-errors/linker-tools-error-lnk1282.md index f5a4ef3c70b..2b61b724474 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk1282.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk1282.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Linker Tools Error LNK1282" title: "Linker Tools Error LNK1282" -ms.date: "11/04/2016" +description: "Learn more about: Linker Tools Error LNK1282" +ms.date: 11/04/2016 f1_keywords: ["LNK1282"] helpviewer_keywords: ["LNK1282"] -ms.assetid: 99c13f52-eb80-46ce-a5b9-4537583e32a9 --- # Linker Tools Error LNK1282 -unable to /REBASE file; it has been signed +> unable to /REBASE file; it has been signed + +## Remarks You attempted to change the base address of a signed assembly with the /REBASE option for [editbin](../../build/reference/editbin-reference.md). To do this, first change the base address and then sign the assembly. diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk1287.md b/docs/error-messages/tool-errors/linker-tools-error-lnk1287.md index 0e007f7611e..00f78ebdfb7 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk1287.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk1287.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Linker Tools Error LNK1287" title: "Linker Tools Error LNK1287" -ms.date: "11/04/2016" +description: "Learn more about: Linker Tools Error LNK1287" +ms.date: 11/04/2016 f1_keywords: ["LNK1287"] helpviewer_keywords: ["LNK1287"] -ms.assetid: 48dc379d-370c-42f6-8028-5bbcf1cc88bd --- # Linker Tools Error LNK1287 -invalid managed entry point function +> invalid managed entry point function + +## Remarks The entry point is not valid for a managed image. The return type of a managed entry point function can only be **`void`** or **`int`**. The type of the parameter of a managed entry point function can only be **`void`** or `String []`. diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk1296.md b/docs/error-messages/tool-errors/linker-tools-error-lnk1296.md index ae48da8e2e0..608d27548f6 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk1296.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk1296.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Linker Tools Error LNK1296" title: "Linker Tools Error LNK1296" -ms.date: "11/04/2016" +description: "Learn more about: Linker Tools Error LNK1296" +ms.date: 11/04/2016 f1_keywords: ["LNK1296"] helpviewer_keywords: ["LNK1296"] -ms.assetid: f94a3d18-5411-456b-966f-89810fdcfe60 --- # Linker Tools Error LNK1296 -unable to load filename +> unable to load filename + +## Remarks The given DLL was unavailable. diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk1301.md b/docs/error-messages/tool-errors/linker-tools-error-lnk1301.md index 32ddbeb1ea6..7cb0c945cef 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk1301.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk1301.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Linker Tools Error LNK1301" title: "Linker Tools Error LNK1301" -ms.date: "11/04/2016" +description: "Learn more about: Linker Tools Error LNK1301" +ms.date: 11/04/2016 f1_keywords: ["LNK1301"] helpviewer_keywords: ["LNK1301"] -ms.assetid: 760da428-7182-4b25-b20a-de90d4b9a9cd --- # Linker Tools Error LNK1301 -LTCG clr modules found, incompatible with /LTCG:parameter +> LTCG clr modules found, incompatible with /LTCG:parameter + +## Remarks A module compiled with /clr and /GL was passed to the linker along with one of the profile guided optimizations (PGO) parameters of /LTCG. @@ -30,7 +31,7 @@ For more information, see: ## Example -The following sample generates LNK1301: +The following example generates LNK1301: ```cpp // LNK1301.cpp diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk1302.md b/docs/error-messages/tool-errors/linker-tools-error-lnk1302.md index 575fa0381d0..8a3ef7ae5a2 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk1302.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk1302.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Linker Tools Error LNK1302" title: "Linker Tools Error LNK1302" -ms.date: "11/04/2016" +description: "Learn more about: Linker Tools Error LNK1302" +ms.date: 11/04/2016 f1_keywords: ["LNK1302"] helpviewer_keywords: ["LNK1302"] -ms.assetid: aea3c753-c2c4-4249-bbc3-f2d4f0164b5e --- # Linker Tools Error LNK1302 -only support linking safe .netmodules; unable to link file .netmodule +> only support linking safe .netmodules; unable to link file .netmodule + +## Remarks A .netmodule (compiled with **/LN**) was passed to the linker in a user attempt to invoke MSIL linking. A C++ module is valid for MSIL linking if it is compiled with **/clr:safe**. diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk1306.md b/docs/error-messages/tool-errors/linker-tools-error-lnk1306.md index 81531f6bc3c..eb8fec1dbf8 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk1306.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk1306.md @@ -1,15 +1,16 @@ --- -description: "Learn more about: Linker Tools Error LNK1306" title: "Linker Tools Error LNK1306" -ms.date: "11/04/2016" +description: "Learn more about: Linker Tools Error LNK1306" +ms.date: 11/04/2016 f1_keywords: ["LNK1306"] helpviewer_keywords: ["LNK1306"] -ms.assetid: fad1df6a-0bd9-412f-b0d1-7c9bc749c584 --- # Linker Tools Error LNK1306 > DLL entry point function cannot be managed; compile to native +## Remarks + `DllMain` cannot be compiled to MSIL; it must be compiled to native. To resolve this issue, @@ -30,7 +31,7 @@ For more information, see: ## Example -The following sample generates LNK1306. +The following example generates LNK1306. ```cpp // LNK1306.cpp diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk1309.md b/docs/error-messages/tool-errors/linker-tools-error-lnk1309.md index 3d4c3acd986..821728c7960 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk1309.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk1309.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Linker Tools Error LNK1309" title: "Linker Tools Error LNK1309" -ms.date: "11/04/2016" +description: "Learn more about: Linker Tools Error LNK1309" +ms.date: 11/04/2016 f1_keywords: ["LNK1309"] helpviewer_keywords: ["LNK1309"] -ms.assetid: 10146071-883f-4849-97d1-c7468f90efbb --- # Linker Tools Error LNK1309 diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk1312.md b/docs/error-messages/tool-errors/linker-tools-error-lnk1312.md index c4a7b56c971..06fc1cabccd 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk1312.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk1312.md @@ -1,20 +1,21 @@ --- -description: "Learn more about: Linker Tools Error LNK1312" title: "Linker Tools Error LNK1312" -ms.date: "11/04/2016" +description: "Learn more about: Linker Tools Error LNK1312" +ms.date: 11/04/2016 f1_keywords: ["LNK1312"] helpviewer_keywords: ["LNK1312"] -ms.assetid: 48284abb-d849-43fc-ab53-45aded14fd8a --- # Linker Tools Error LNK1312 -invalid or corrupt file: unable to import assembly +> invalid or corrupt file: unable to import assembly + +## Remarks When building an assembly, a file other than a module or assembly compiled with **/clr** was passed to the **/ASSEMBLYMODULE** linker option. If you passed an object file to **/ASSEMBLYMODULE**, just pass the object directly to the linker, instead of to **/ASSEMBLYMODULE**. -## Examples +## Example -The following sample created the .obj file. +The following example created the .obj file. ```cpp // LNK1312.cpp @@ -25,7 +26,7 @@ public: }; ``` -The following sample generates LNK1312. +The following example generates LNK1312. ```cpp // LNK1312_b.cpp diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk1313.md b/docs/error-messages/tool-errors/linker-tools-error-lnk1313.md index 0028bd2e487..d32e1e04cdd 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk1313.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk1313.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Linker Tools Error LNK1313" title: "Linker Tools Error LNK1313" +description: "Learn more about: Linker Tools Error LNK1313" ms.date: 06/29/2022 f1_keywords: ["LNK1313"] helpviewer_keywords: ["LNK1313"] -ms.assetid: 5df0b72e-bb3f-428c-8d84-6084238f9827 --- # Linker Tools Error LNK1313 @@ -16,7 +15,7 @@ The current version of Visual C++ does not support linking native or mixed manag The **`/clr:pure`** compiler option is deprecated in Visual Studio 2015 and unsupported in Visual Studio 2017 and later. -## Examples +## Example Source file `LNK1313.cpp`: @@ -36,7 +35,7 @@ Source file `LNK1313_b.cpp`: void test(){} ``` -The following sample will generate LNK1313. +The following example will generate LNK1313. ```cpp // LNK1313_c.cpp diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk1314.md b/docs/error-messages/tool-errors/linker-tools-error-lnk1314.md index 91bcd50de0c..aaa27458f30 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk1314.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk1314.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Linker Tools Error LNK1314" title: "Linker Tools Error LNK1314" -ms.date: "11/04/2016" +description: "Learn more about: Linker Tools Error LNK1314" +ms.date: 11/04/2016 f1_keywords: ["LNK1314"] helpviewer_keywords: ["LNK1314"] -ms.assetid: 0b5cd599-61ea-4ac7-8f25-c6d3a8b14655 --- # Linker Tools Error LNK1314 -corrupt or invalid COFF symbol table (undefined static or label symbol) +> corrupt or invalid COFF symbol table (undefined static or label symbol) + +## Remarks The compiler-generated content for a section in the given object appears to be corrupt. diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk1318.md b/docs/error-messages/tool-errors/linker-tools-error-lnk1318.md index 8724382c59b..cf8a6f59de0 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk1318.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk1318.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: Linker Tools Error LNK1318" title: "Linker Tools Error LNK1318" -ms.date: "05/29/2018" +description: "Learn more about: Linker Tools Error LNK1318" +ms.date: 05/29/2018 f1_keywords: ["LNK1318"] helpviewer_keywords: ["LNK1318"] --- @@ -9,6 +9,8 @@ helpviewer_keywords: ["LNK1318"] > Unexpected PDB error; *cause* '*details*' +## Remarks + The linker encountered an unexpected error when opening, reading, or writing to a PDB file. This error message is produced for uncommon issues in PDB files. The *cause* and *details* represent the information available to the linker when the failure occurred. This may not be very useful, as common errors when dealing with PDB files have separate, more informative error messages. diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk1332.md b/docs/error-messages/tool-errors/linker-tools-error-lnk1332.md index ff537294c8d..1c650843fc0 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk1332.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk1332.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Linker Tools Error LNK1332" title: "Linker Tools Error LNK1332" -ms.date: "11/04/2016" +description: "Learn more about: Linker Tools Error LNK1332" +ms.date: 11/04/2016 f1_keywords: ["LNK1332"] helpviewer_keywords: ["LNK1332"] -ms.assetid: b31d5ca0-c27f-4177-896b-2637dccbde24 --- # Linker Tools Error LNK1332 -detected\ Windows Runtime types imported in one module and defined in another module +> detected\ Windows Runtime types imported in one module and defined in another module + +## Remarks When it produced the current target, the linker detected <`count`> Windows Runtime types, each of which is imported in one module and also defined in another module. diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk1352.md b/docs/error-messages/tool-errors/linker-tools-error-lnk1352.md index c3d83f4fe6f..387d5699946 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk1352.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk1352.md @@ -1,7 +1,7 @@ --- title: "Linker Tools Error LNK1352" -description: Linker Tools Error LNK1352 occurs when an unsupported section merge is attempted. -ms.date: "09/10/2019" +description: "Linker Tools Error LNK1352 occurs when an unsupported section merge is attempted." +ms.date: 09/10/2019 f1_keywords: ["LNK1352"] helpviewer_keywords: ["LNK1352"] --- diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk1561.md b/docs/error-messages/tool-errors/linker-tools-error-lnk1561.md index 02cda93ab58..38e2cf273a2 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk1561.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk1561.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Linker Tools Error LNK1561" title: "Linker Tools Error LNK1561" -ms.date: "11/04/2016" +description: "Learn more about: Linker Tools Error LNK1561" +ms.date: 11/04/2016 f1_keywords: ["LNK1561"] helpviewer_keywords: ["LNK1561"] -ms.assetid: cb0b709b-7c9c-4496-8a4e-9e1e4aefe447 --- # Linker Tools Error LNK1561 -entry point must be defined +> entry point must be defined + +## Remarks The linker did not find an *entry point*, the initial function to call in your executable. By default, the linker looks for a `main` or `wmain` function for a console app, a `WinMain` or `wWinMain` function for a Windows app, or `DllMain` for a DLL that requires initialization. You can specify another function by using the [/ENTRY](../../build/reference/entry-entry-point-symbol.md) linker option. @@ -24,7 +25,7 @@ When building an app, the linker looks for an entry point function to call to st ## Example -The following sample generates LNK1561: +The following example generates LNK1561: ```cpp // LNK1561.cpp diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk2001.md b/docs/error-messages/tool-errors/linker-tools-error-lnk2001.md index 4b3626bc8fe..15a53502f97 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk2001.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk2001.md @@ -1,15 +1,16 @@ --- -description: "Learn more about: Linker Tools Error LNK2001" title: "Linker Tools Error LNK2001" +description: "Learn more about: Linker Tools Error LNK2001" ms.date: 10/22/2021 f1_keywords: ["LNK2001"] helpviewer_keywords: ["LNK2001"] -ms.assetid: dc1cf267-c984-486c-abd2-fd07c799f7ef --- # Linker Tools Error LNK2001 > unresolved external symbol "*symbol*" +## Remarks + The compiled code makes a reference or call to *symbol*. The symbol isn't defined in any libraries or object files searched by the linker. This error message is followed by fatal error [LNK1120](../../error-messages/tool-errors/linker-tools-error-lnk1120.md). To fix error LNK1120, first fix all LNK2001 and LNK2019 errors. diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk2004.md b/docs/error-messages/tool-errors/linker-tools-error-lnk2004.md index 79d704a0dc4..2d6d59c7ec4 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk2004.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk2004.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Linker Tools Error LNK2004" title: "Linker Tools Error LNK2004" -ms.date: "11/04/2016" +description: "Learn more about: Linker Tools Error LNK2004" +ms.date: 11/04/2016 f1_keywords: ["LNK2004"] helpviewer_keywords: ["LNK2004"] -ms.assetid: 07645371-e67b-4a2c-b0e0-dde24c94ef7e --- # Linker Tools Error LNK2004 -gp relative fixup overflow to 'target'; short section 'section' is too large or out of range. +> gp relative fixup overflow to 'target'; short section 'section' is too large or out of range. + +## Remarks The section was too large. diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk2005.md b/docs/error-messages/tool-errors/linker-tools-error-lnk2005.md index 68ddf0e345b..32354e573ea 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk2005.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk2005.md @@ -1,15 +1,16 @@ --- -description: "Learn more about: Linker Tools Error LNK2005" title: "Linker Tools Error LNK2005" -ms.date: "11/04/2016" +description: "Learn more about: Linker Tools Error LNK2005" +ms.date: 11/04/2016 f1_keywords: ["LNK2005"] helpviewer_keywords: ["LNK2005"] -ms.assetid: d9587adc-68be-425c-8a30-15dbc86717a4 --- # Linker Tools Error LNK2005 > *symbol* already defined in object +## Remarks + The symbol *symbol* was defined more than once. This error is followed by fatal error [LNK1169](../../error-messages/tool-errors/linker-tools-error-lnk1169.md). diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk2008.md b/docs/error-messages/tool-errors/linker-tools-error-lnk2008.md index 1d56c3f3aaf..e5cf01c5917 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk2008.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk2008.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Linker Tools Error LNK2008" title: "Linker Tools Error LNK2008" -ms.date: "11/04/2016" +description: "Learn more about: Linker Tools Error LNK2008" +ms.date: 11/04/2016 f1_keywords: ["LNK2008"] helpviewer_keywords: ["LNK2008"] -ms.assetid: bbcd83c5-c8ae-439e-a033-63643a5bb373 --- # Linker Tools Error LNK2008 -Fixup target is not aligned 'symbol_name' +> Fixup target is not aligned 'symbol_name' + +## Remarks LINK found a fixup target in your object file that was not aligned properly. diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk2011.md b/docs/error-messages/tool-errors/linker-tools-error-lnk2011.md index aee174c7840..1e4c6ffb5ee 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk2011.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk2011.md @@ -1,20 +1,23 @@ --- -description: "Learn more about: Linker Tools Error LNK2011" title: "Linker Tools Error LNK2011" -ms.date: "11/04/2016" +description: "Learn more about: Linker Tools Error LNK2011" +ms.date: 11/04/2016 f1_keywords: ["LNK2011"] helpviewer_keywords: ["LNK2011"] -ms.assetid: 04991ef5-49d5-46c7-8eee-a9d1d3fc541e --- # Linker Tools Error LNK2011 -precompiled object not linked in; image may not run +> precompiled object not linked in; image may not run + +## Remarks If you use precompiled headers, LINK requires that all of the object files created with precompiled headers must be linked in. If you have a source file that you use to generate a precompiled header for use with other source files, you now must include the object file created along with the precompiled header. +## Example + For example, if you compile a file called STUB.cpp to create a precompiled header for use with other source files, you must link with STUB.obj or you will get this error. In the following command lines, line one is used to create a precompiled header, COMMON.pch, which is used with PROG1.cpp and PROG2.cpp in lines two and three. The file STUB.cpp contains only `#include` lines (the same `#include` lines as in PROG1.cpp and PROG2.cpp) and is used only to generate precompiled headers. In the last line, STUB.obj must be linked in to avoid LNK2011. -``` +```cmd cl /c /Yccommon.h stub.cpp cl /c /Yucommon.h prog1.cpp cl /c /Yucommon.h prog2.cpp diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk2013.md b/docs/error-messages/tool-errors/linker-tools-error-lnk2013.md index c977734a5a8..c45fba1baeb 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk2013.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk2013.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Linker Tools Error LNK2013" title: "Linker Tools Error LNK2013" -ms.date: "11/04/2016" +description: "Learn more about: Linker Tools Error LNK2013" +ms.date: 11/04/2016 f1_keywords: ["LNK2013"] helpviewer_keywords: ["LNK2013"] -ms.assetid: 21408e2d-3f56-4d1f-a031-00df70785ed4 --- # Linker Tools Error LNK2013 -fixup type fixup overflow. Target 'symbol name' is out of range +> fixup type fixup overflow. Target 'symbol name' is out of range + +## Remarks The linker cannot fit the necessary address or offset into the given instruction because the target symbol is too far away from the instruction's location. diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk2017.md b/docs/error-messages/tool-errors/linker-tools-error-lnk2017.md index b0b30a605a4..8ec341849b6 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk2017.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk2017.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Linker Tools Error LNK2017" title: "Linker Tools Error LNK2017" -ms.date: "11/04/2016" +description: "Learn more about: Linker Tools Error LNK2017" +ms.date: 11/04/2016 f1_keywords: ["LNK2017"] helpviewer_keywords: ["LNK2017"] -ms.assetid: f7c21733-b0fb-4888-a295-9b453ba6ee77 --- # Linker Tools Error LNK2017 -'symbol' relocation to 'segment' invalid without /LARGEADDRESSAWARE:NO +> 'symbol' relocation to 'segment' invalid without /LARGEADDRESSAWARE:NO + +## Remarks You are trying to build a 64-bit image with 32-bit addresses. To do this, you must: diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk2019.md b/docs/error-messages/tool-errors/linker-tools-error-lnk2019.md index 932be366f56..8c07ef83d0f 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk2019.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk2019.md @@ -10,6 +10,8 @@ no-loc: [main, WinMain, wmain, wWinMain, __cdecl, __stdcall, __fastcall, __vecto > unresolved external symbol '*symbol*' referenced in function '*function*' +## Remarks + The compiled code for *function* makes a reference or call to *symbol*, but the linker can't find the symbol definition in any of the libraries or object files. This error message is followed by fatal error [LNK1120](../../error-messages/tool-errors/linker-tools-error-lnk1120.md). To fix error LNK1120, you must fix all LNK2001 and LNK2019 errors first. @@ -88,9 +90,9 @@ For example, if you use an AVX2 intrinsic, but don't specify the [`/ARCH:AVX2`]( C++ language conformance work that was done in Visual Studio 2005 made **`wchar_t`** a native type by default. If not all files have been compiled by using the same **`/Zc:wchar_t`** settings, type references might not resolve to compatible types. Make sure **`wchar_t`** types in all library and object files are compatible. Either update from a **`wchar_t`** typedef, or use consistent **/Zc:wchar_t** settings when you compile. -### You get errors for `*printf*` and `*scanf*` functions when you link a legacy static library +### You get errors for *`printf`* and *`scanf`* functions when you link a legacy static library -A static library that was built using a version of Visual Studio before Visual Studio 2015 might cause LNK2019 errors when linked with the UCRT. The UCRT header files ``, ``, and ``now define many `*printf*` and `*scanf*` variations as **`inline`** functions. The inlined functions are implemented by a smaller set of common functions. Individual exports for the inlined functions aren't available in the standard UCRT libraries, which only export the common functions. There are a couple of ways to resolve this issue. The method we recommend is to rebuild the legacy library with your current version of Visual Studio. Make sure the library code uses the standard headers for the definitions of the `*printf*` and `*scanf*` functions that caused the errors. Another option for a legacy library that you can't rebuild is to add `legacy_stdio_definitions.lib` to the list of libraries you link. This library file provides symbols for the `*printf*` and `*scanf*` functions that are inlined in the UCRT headers. For more information, see the **Libraries** section in [Overview of potential upgrade issues](../../porting/overview-of-potential-upgrade-issues-visual-cpp.md#libraries). +A static library that was built using a version of Visual Studio before Visual Studio 2015 might cause LNK2019 errors when linked with the UCRT. The UCRT header files ``, ``, and ``now define many *`printf`* and *`scanf`* variations as **`inline`** functions. The inlined functions are implemented by a smaller set of common functions. Individual exports for the inlined functions aren't available in the standard UCRT libraries, which only export the common functions. There are a couple of ways to resolve this issue. The method we recommend is to rebuild the legacy library with your current version of Visual Studio. Make sure the library code uses the standard headers for the definitions of the *`printf`* and *`scanf`* functions that caused the errors. Another option for a legacy library that you can't rebuild is to add `legacy_stdio_definitions.lib` to the list of libraries you link. This library file provides symbols for the *`printf`* and *`scanf`* functions that are inlined in the UCRT headers. For more information, see the **Libraries** section in [Overview of potential upgrade issues](../../porting/overview-of-potential-upgrade-issues-visual-cpp.md#libraries). ## Third-party library issues and vcpkg @@ -143,7 +145,7 @@ Unless `i` and `g` are defined in one of the files included in the build, the li ### A static data member is declared but not defined -LNK2019 can also occur when a static data member is declared but not defined. The following sample generates LNK2019, and shows how to fix it. +LNK2019 can also occur when a static data member is declared but not defined. The following example generates LNK2019, and shows how to fix it. ```cpp // LNK2019b.cpp @@ -164,7 +166,7 @@ int main() { ### Declaration parameters don't match the definition -Code that invokes function templates must have matching function template declarations. Declarations must include the same template parameters as the definition. The following sample generates LNK2019 on a user-defined operator, and shows how to fix it. +Code that invokes function templates must have matching function template declarations. Declarations must include the same template parameters as the definition. The following example generates LNK2019 on a user-defined operator, and shows how to fix it. ```cpp // LNK2019e.cpp @@ -194,7 +196,7 @@ int main() { ### Inconsistent wchar_t type definitions -This sample creates a DLL that has an export that uses `WCHAR`, which resolves to **`wchar_t`**. +This example creates a DLL that has an export that uses `WCHAR`, which resolves to **`wchar_t`**. ```cpp // LNK2019g.cpp @@ -204,7 +206,7 @@ This sample creates a DLL that has an export that uses `WCHAR`, which resolves t __declspec(dllexport) void func(WCHAR*) {} ``` -The next sample uses the DLL in the previous sample, and generates LNK2019 because the types `unsigned short*` and `WCHAR*` aren't the same. +The next example uses the DLL in the previous example, and generates LNK2019 because the types `unsigned short*` and `WCHAR*` aren't the same. ```cpp // LNK2019h.cpp diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk2020.md b/docs/error-messages/tool-errors/linker-tools-error-lnk2020.md index 36de7722e04..67a107c88ec 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk2020.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk2020.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Linker Tools Error LNK2020" title: "Linker Tools Error LNK2020" -ms.date: "11/04/2016" +description: "Learn more about: Linker Tools Error LNK2020" +ms.date: 11/04/2016 f1_keywords: ["LNK2020"] helpviewer_keywords: ["LNK2020"] -ms.assetid: 4dd017d0-5e83-471b-ac8a-538ac1ed6870 --- # Linker Tools Error LNK2020 -unresolved token 'token' +> unresolved token 'token' + +## Remarks Similar to an undefined external error, except that the reference is via metadata. In metadata, all functions and data must be defined. @@ -20,7 +21,7 @@ To resolve: ## Examples -The following sample generates LNK2020. +The following example generates LNK2020. ```cpp // LNK2020.cpp @@ -39,7 +40,7 @@ ref struct B { LNK2020 will also occur if you create a variable of a managed template type, but do not also instantiate the type. -The following sample generates LNK2020. +The following example generates LNK2020. ```cpp // LNK2020_b.cpp @@ -47,16 +48,16 @@ The following sample generates LNK2020. template ref struct Base { - virtual void f1() {}; + virtual void f1() {} }; template ref struct Base2 { - virtual void f1() {}; + virtual void f1() {} }; int main() { Base^ p; // LNK2020 Base2^ p2 = gcnew Base2(); // OK -}; +} ``` diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk2022.md b/docs/error-messages/tool-errors/linker-tools-error-lnk2022.md index eee9aa2821e..56c9f16627b 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk2022.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk2022.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Linker Tools Error LNK2022" title: "Linker Tools Error LNK2022" -ms.date: "11/04/2016" +description: "Learn more about: Linker Tools Error LNK2022" +ms.date: 11/04/2016 f1_keywords: ["LNK2022"] helpviewer_keywords: ["LNK2022"] -ms.assetid: d2128c73-dde3-4b8e-a9b2-0a153acefb3b --- # Linker Tools Error LNK2022 @@ -16,7 +15,7 @@ One way to diagnose this problem is to run **ildasm -tokens** on the object file One reason for LNK2022 is when a type (such as a struct) exists in multiple compilands with the same name, but with conflicting definitions, and when you compile with [/clr](../../build/reference/clr-common-language-runtime-compilation.md). In this case, make sure that the type has an identical definition in all compilands. The type name is listed in `error_message`. -Another possible cause for LNK2022 is when the linker finds a metadata file in a different location than was specified to the compiler (with [#using](../../preprocessor/hash-using-directive-cpp.md) ). Make sure that the metadata file (.dll or .netmodule) is in the same location when passed to the linker, as it was when it was passed to the compiler. +Another possible cause for LNK2022 is when the linker finds a metadata file in a different location than was specified to the compiler (with [#using](../../preprocessor/hash-using-directive-cpp.md)). Make sure that the metadata file (.dll or .netmodule) is in the same location when passed to the linker, as it was when it was passed to the compiler. When building an ATL application, the use of the macro `_ATL_MIXED` is required in all compilands, if it is used in at least one. diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk2023.md b/docs/error-messages/tool-errors/linker-tools-error-lnk2023.md index 3294c30bff2..9cafc696e3a 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk2023.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk2023.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Linker Tools Error LNK2023" title: "Linker Tools Error LNK2023" -ms.date: "11/04/2016" +description: "Learn more about: Linker Tools Error LNK2023" +ms.date: 11/04/2016 f1_keywords: ["LNK2023"] helpviewer_keywords: ["LNK2023"] -ms.assetid: c99e35a8-739a-4a20-a715-29b8c3744703 --- # Linker Tools Error LNK2023 -bad dll or entry point \ +> bad dll or entry point \ + +## Remarks The linker is loading an incorrect version of msobj90.dll. Ensure that link.exe and msobj90.dll in your path have the same version. diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk2026.md b/docs/error-messages/tool-errors/linker-tools-error-lnk2026.md index f1018137f86..13bf2776bd7 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk2026.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk2026.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Linker Tools Error LNK2026" title: "Linker Tools Error LNK2026" -ms.date: "11/04/2016" +description: "Learn more about: Linker Tools Error LNK2026" +ms.date: 11/04/2016 f1_keywords: ["LNK2026"] helpviewer_keywords: ["LNK2026"] -ms.assetid: 9955bf7c-59b5-4fa1-8481-147db0d7df45 --- # Linker Tools Error LNK2026 -module unsafe for SAFESEH image +> module unsafe for SAFESEH image + +## Remarks [/SAFESEH](../../build/reference/safeseh-image-has-safe-exception-handlers.md) was specified, but a module was not compatible with the safe exception handling feature. If you want to use this module with **/SAFESEH**, then you will need to recompile the module. diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk2027.md b/docs/error-messages/tool-errors/linker-tools-error-lnk2027.md index 7b2c24ce08e..c95f4d0ad62 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk2027.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk2027.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Linker Tools Error LNK2027" title: "Linker Tools Error LNK2027" -ms.date: "11/04/2016" +description: "Learn more about: Linker Tools Error LNK2027" +ms.date: 11/04/2016 f1_keywords: ["LNK2027"] helpviewer_keywords: ["LNK2027"] -ms.assetid: e2f857a8-8e8a-4697-bbff-12ccb84a35c1 --- # Linker Tools Error LNK2027 -unresolved module reference 'module' +> unresolved module reference 'module' + +## Remarks A file passed to the linker has a dependency on a module that was neither specified with **/ASSEMBLYMODULE** nor passed directly to the linker. diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk2028.md b/docs/error-messages/tool-errors/linker-tools-error-lnk2028.md index a43928ba548..82760815f9d 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk2028.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk2028.md @@ -1,14 +1,13 @@ --- -description: "Learn more about: Linker Tools Error LNK2028" title: "Linker Tools Error LNK2028" -ms.date: "11/04/2016" +description: "Learn more about: Linker Tools Error LNK2028" +ms.date: 11/04/2016 f1_keywords: ["LNK2028"] helpviewer_keywords: ["LNK2028"] -ms.assetid: e2b03293-6066-464d-a050-ce747bcf7f0e --- # Linker Tools Error LNK2028 -"*exported_function*" (*decorated_name*) referenced in function "*function_containing_function_call*" (*decorated_name*) +> "*exported_function*" (*decorated_name*) referenced in function "*function_containing_function_call*" (*decorated_name*) ## Remarks @@ -18,7 +17,7 @@ The **/clr:pure** compiler option is deprecated in Visual Studio 2015 and unsupp ## Examples -This code sample generates a component with an exported, native, function whose calling convention is implicitly [__cdecl](../../cpp/cdecl.md). +This code example generates a component with an exported, native, function whose calling convention is implicitly [__cdecl](../../cpp/cdecl.md). ```cpp // LNK2028.cpp @@ -28,7 +27,7 @@ __declspec(dllexport) int func() { } ``` -The following sample creates a pure client that consumes the native function. However, the calling convention under **/clr:pure** is [__clrcall](../../cpp/clrcall.md). The following sample generates LNK2028. +The following example creates a pure client that consumes the native function. However, the calling convention under **/clr:pure** is [__clrcall](../../cpp/clrcall.md). The following example generates LNK2028. ```cpp // LNK2028_b.cpp diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk2031.md b/docs/error-messages/tool-errors/linker-tools-error-lnk2031.md index f95b8cc24b0..69581fa9667 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk2031.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk2031.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Linker Tools Error LNK2031" title: "Linker Tools Error LNK2031" -ms.date: "11/04/2016" +description: "Learn more about: Linker Tools Error LNK2031" +ms.date: 11/04/2016 f1_keywords: ["LNK2031"] helpviewer_keywords: ["LNK2031"] -ms.assetid: 18ed4b6e-3e75-443c-bbd8-2f6030dc89ee --- # Linker Tools Error LNK2031 @@ -18,7 +17,7 @@ The **/clr:pure** compiler option is deprecated in Visual Studio 2015 and unsupp ## Examples -This code sample generates a component with an exported, native, function whose calling convention is implicitly [__cdecl](../../cpp/cdecl.md). +This code example generates a component with an exported, native, function whose calling convention is implicitly [__cdecl](../../cpp/cdecl.md). ```cpp // LNK2031.cpp @@ -28,7 +27,7 @@ extern "C" { }; ``` -The following sample creates a pure client that consumes the native function. However, the calling convention under **/clr:pure** is [__clrcall](../../cpp/clrcall.md). The following sample generates LNK2031. +The following example creates a pure client that consumes the native function. However, the calling convention under **/clr:pure** is [__clrcall](../../cpp/clrcall.md). The following example generates LNK2031. ```cpp // LNK2031_b.cpp @@ -41,7 +40,7 @@ int main() { } ``` -The following sample shows how to consume the native function from a pure image. Note the explicit **`__cdecl`** calling convention specifier. +The following example shows how to consume the native function from a pure image. Note the explicit **`__cdecl`** calling convention specifier. ```cpp // LNK2031_c.cpp diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk2033.md b/docs/error-messages/tool-errors/linker-tools-error-lnk2033.md index 74ff15798fc..2e84c4cfbc7 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk2033.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk2033.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Linker Tools Error LNK2033" title: "Linker Tools Error LNK2033" -ms.date: "11/04/2016" +description: "Learn more about: Linker Tools Error LNK2033" +ms.date: 11/04/2016 f1_keywords: ["LNK2033"] helpviewer_keywords: ["LNK2033"] -ms.assetid: d61db467-9328-4788-bf54-e2a20537f13f --- # Linker Tools Error LNK2033 -unresolved typeref token (token) for 'type' +> unresolved typeref token (token) for 'type' + +## Remarks A type doesn't have a definition in MSIL metadata. @@ -20,7 +21,7 @@ For more information, see [/clr (Common Language Runtime Compilation)](../../bui ## Example -The following sample generates LNK2033. +The following example generates LNK2033. ```cpp // LNK2033.cpp @@ -32,5 +33,5 @@ ref class B {}; int main() { A ^ aa = nullptr; B ^ bb = nullptr; // OK -}; +} ``` diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk2038.md b/docs/error-messages/tool-errors/linker-tools-error-lnk2038.md index 8162a57997d..64c8c87a92e 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk2038.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk2038.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: Linker Tools Error LNK2038" title: "Linker Tools Error LNK2038" -ms.date: "12/15/2017" +description: "Learn more about: Linker Tools Error LNK2038" +ms.date: 12/15/2017 f1_keywords: ["LNK2038"] helpviewer_keywords: ["LNK2038"] --- @@ -9,6 +9,8 @@ helpviewer_keywords: ["LNK2038"] > mismatch detected for '*name*': value '*value_1*' doesn't match value '*value_2*' in *filename.obj* +## Remarks + A symbol mismatch has been detected by the linker. This error indicates that different parts of an app, including libraries or other object code that the app links to, use conflicting definitions of the symbol. The [detect mismatch](../../preprocessor/detect-mismatch.md) pragma is used to define such symbols and detect their conflicting values. ## Possible causes and solutions diff --git a/docs/error-messages/tool-errors/linker-tools-error-lnk2039.md b/docs/error-messages/tool-errors/linker-tools-error-lnk2039.md index 1f0ffa47935..6f441c91161 100644 --- a/docs/error-messages/tool-errors/linker-tools-error-lnk2039.md +++ b/docs/error-messages/tool-errors/linker-tools-error-lnk2039.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Linker Tools Error LNK2039" title: "Linker Tools Error LNK2039" -ms.date: "11/04/2016" +description: "Learn more about: Linker Tools Error LNK2039" +ms.date: 11/04/2016 f1_keywords: ["LNK2039"] helpviewer_keywords: ["LNK2039"] -ms.assetid: eaa296bd-4901-41f6-8410-6d03ee827144 --- # Linker Tools Error LNK2039 -importing ref class '\' that is defined in another.obj; it should be either imported or defined, but not both +> importing ref class '\' that is defined in another.obj; it should be either imported or defined, but not both + +## Remarks The ref class '<`type`>' is imported in the specified .obj file but is also defined in another .obj file. This condition can cause runtime failure or other unexpected behavior. diff --git a/docs/error-messages/tool-errors/linker-tools-errors-and-warnings.md b/docs/error-messages/tool-errors/linker-tools-errors-and-warnings.md index 85801f1d358..102d426b6e8 100644 --- a/docs/error-messages/tool-errors/linker-tools-errors-and-warnings.md +++ b/docs/error-messages/tool-errors/linker-tools-errors-and-warnings.md @@ -1,146 +1,149 @@ --- -description: "Learn more about: Linker tools errors and warnings (LNKxxxx)" title: "Linker tools errors and warnings" +description: "Learn more about: Linker tools errors and warnings (LNKxxxx)" ms.date: 01/30/2024 -f1_keywords: ["LNK1100", "LNK1101", "LNK1102", "LNK1105", "LNK1108", "LNK1109", "LNK1111", "LNK1114", "LNK1115", "LNK1117", "LNK1118", "LNK1119", "LNK1121", "LNK1129", "LNK1130", "LNK1131", "LNK1132", "LNK1137", "LNK1144", "LNK1145", "LNK1146", "LNK1147", "LNK1148", "LNK1149", "LNK1154", "LNK1155", "LNK1156", "LNK1159", "LNK1160", "LNK1161", "LNK1162", "LNK1163", "LNK1165", "LNK1167", "LNK1171", "LNK1172", "LNK1173", "LNK1174", "LNK1175", "LNK1178", "LNK1180", "LNK1182", "LNK1183", "LNK1184", "LNK1185", "LNK1186", "LNK1187", "LNK1190", "LNK1194", "LNK1195", "LNK1197", "LNK1198", "LNK1199", "LNK1207", "LNK1209", "LNK1210", "LNK1212", "LNK1213", "LNK1214", "LNK1216", "LNK1219", "LNK1220", "LNK1227", "LNK1229", "LNK1230", "LNK1232", "LNK1233", "LNK1234", "LNK1235", "LNK1236", "LNK1242", "LNK1243", "LNK1244", "LNK1246", "LNK1247", "LNK1249", "LNK1250", "LNK1252", "LNK1253", "LNK1255", "LNK1257", "LNK1258", "LNK1260", "LNK1261", "LNK1262", "LNK1263", "LNK1265", "LNK1266", "LNK1267", "LNK1268", "LNK1269", "LNK1270", "LNK1272", "LNK1274", "LNK1276", "LNK1279", "LNK1280", "LNK1281", "LNK1283", "LNK1285", "LNK1286", "LNK1289", "LNK1290", "LNK1291", "LNK1292", "LNK1293", "LNK1294", "LNK1295", "LNK1297", "LNK1298", "LNK1299", "LNK1300", "LNK1303", "LNK1304", "LNK1305", "LNK1307", "LNK1308", "LNK1310", "LNK1311", "LNK1315", "LNK1316", "LNK1317", "LNK1319", "LNK1320", "LNK1321", "LNK1322", "LNK1323", "LNK1324", "LNK1325", "LNK1327", "LNK1328", "LNK1329", "LNK1330", "LNK1331", "LNK1333", "LNK1334", "LNK1335", "LNK1336", "LNK1337", "LNK1338", "LNK1339", "LNK1340", "LNK1341", "LNK1342", "LNK1343", "LNK1344", "LNK1345", "LNK1346", "LNK1347", "LNK1348", "LNK1349", "LNK1350", "LNK1351", "LNK1353", "LNK1354", "LNK1355", "LNK1356", "LNK1360", "LNK1361", "LNK1362", "LNK1363", "LNK1364", "LNK1365", "LNK1366", "LNK1367", "LNK1368", "LNK1369", "LNK1370", "LNK1371", "LNK1372", "LNK1373", "LNK1375", "LNK1376", "LNK1377", "LNK1378", "LNK1379", "LNK1380", "LNK1381", "LNK1382", "LNK1383", "LNK1384", "LNK1385", "LNK2002", "LNK2003", "LNK2009", "LNK2014", "LNK2015", "LNK2016", "LNK2018", "LNK2021", "LNK2024", "LNK2029", "LNK2030", "LNK2032", "LNK2034", "LNK2035", "LNK2036", "LNK2037", "LNK2040", "LNK2041", "LNK2042", "LNK2043", "LNK2044", "LNK2045", "LNK4003", "LNK4012", "LNK4013", "LNK4017", "LNK4018", "LNK4019", "LNK4030", "LNK4031", "LNK4038", "LNK4040", "LNK4041", "LNK4042", "LNK4043", "LNK4046", "LNK4047", "LNK4048", "LNK4051", "LNK4052", "LNK4056", "LNK4060", "LNK4061", "LNK4062", "LNK4066", "LNK4067", "LNK4068", "LNK4069", "LNK4072", "LNK4077", "LNK4079", "LNK4081", "LNK4085", "LNK4087", "LNK4088", "LNK4093", "LNK4094", "LNK4097", "LNK4103", "LNK4108", "LNK4195", "LNK4196", "LNK4198", "LNK4202", "LNK4203", "LNK4207", "LNK4208", "LNK4209", "LNK4223", "LNK4225", "LNK4226", "LNK4228", "LNK4232", "LNK4233", "LNK4236", "LNK4238", "LNK4239", "LNK4240", "LNK4241", "LNK4242", "LNK4243", "LNK4244", "LNK4245", "LNK4246", "LNK4249", "LNK4250", "LNK4251", "LNK4252", "LNK4255", "LNK4256", "LNK4257", "LNK4258", "LNK4259", "LNK4260", "LNK4261", "LNK4262", "LNK4263", "LNK4264", "LNK4265", "LNK4266", "LNK4267", "LNK4268", "LNK4269", "LNK4270", "LNK4271", "LNK4272", "LNK4273", "LNK4274", "LNK4275", "LNK4276", "LNK4277", "LNK4278", "LNK4279", "LNK4280", "LNK4281", "LNK4282", "LNK4283", "LNK4284", "LNK4285", "LNK4287", "LNK4288", "LNK4289", "LNK4290", "LNK4306", -"LNK4307" ] +f1_keywords: ["LNK1100", "LNK1101", "LNK1102", "LNK1105", "LNK1108", "LNK1109", "LNK1111", "LNK1114", "LNK1115", "LNK1117", "LNK1118", "LNK1119", "LNK1121", "LNK1129", "LNK1130", "LNK1131", "LNK1132", "LNK1137", "LNK1144", "LNK1145", "LNK1146", "LNK1147", "LNK1148", "LNK1149", "LNK1154", "LNK1155", "LNK1156", "LNK1159", "LNK1160", "LNK1161", "LNK1162", "LNK1163", "LNK1165", "LNK1167", "LNK1171", "LNK1172", "LNK1173", "LNK1174", "LNK1175", "LNK1178", "LNK1180", "LNK1182", "LNK1183", "LNK1184", "LNK1185", "LNK1186", "LNK1187", "LNK1190", "LNK1194", "LNK1195", "LNK1197", "LNK1198", "LNK1199", "LNK1207", "LNK1209", "LNK1210", "LNK1212", "LNK1213", "LNK1214", "LNK1216", "LNK1219", "LNK1220", "LNK1227", "LNK1229", "LNK1230", "LNK1232", "LNK1233", "LNK1234", "LNK1235", "LNK1236", "LNK1242", "LNK1243", "LNK1244", "LNK1246", "LNK1247", "LNK1249", "LNK1250", "LNK1252", "LNK1253", "LNK1255", "LNK1257", "LNK1258", "LNK1260", "LNK1261", "LNK1262", "LNK1263", "LNK1265", "LNK1266", "LNK1267", "LNK1268", "LNK1269", "LNK1270", "LNK1272", "LNK1274", "LNK1276", "LNK1279", "LNK1280", "LNK1281", "LNK1283", "LNK1285", "LNK1286", "LNK1289", "LNK1290", "LNK1291", "LNK1292", "LNK1293", "LNK1294", "LNK1295", "LNK1297", "LNK1298", "LNK1299", "LNK1300", "LNK1303", "LNK1304", "LNK1305", "LNK1307", "LNK1308", "LNK1310", "LNK1311", "LNK1315", "LNK1316", "LNK1317", "LNK1319", "LNK1320", "LNK1321", "LNK1322", "LNK1323", "LNK1324", "LNK1325", "LNK1327", "LNK1328", "LNK1329", "LNK1330", "LNK1331", "LNK1333", "LNK1334", "LNK1335", "LNK1336", "LNK1337", "LNK1338", "LNK1339", "LNK1340", "LNK1341", "LNK1342", "LNK1343", "LNK1344", "LNK1345", "LNK1346", "LNK1347", "LNK1348", "LNK1349", "LNK1350", "LNK1351", "LNK1353", "LNK1354", "LNK1355", "LNK1356", "LNK1360", "LNK1361", "LNK1362", "LNK1363", "LNK1364", "LNK1365", "LNK1366", "LNK1367", "LNK1368", "LNK1369", "LNK1370", "LNK1371", "LNK1372", "LNK1373", "LNK1375", "LNK1376", "LNK1377", "LNK1378", "LNK1379", "LNK1380", "LNK1381", "LNK1382", "LNK1383", "LNK1384", "LNK1385", "LNK2002", "LNK2003", "LNK2009", "LNK2014", "LNK2015", "LNK2016", "LNK2018", "LNK2021", "LNK2024", "LNK2029", "LNK2030", "LNK2032", "LNK2034", "LNK2035", "LNK2036", "LNK2037", "LNK2040", "LNK2041", "LNK2042", "LNK2043", "LNK2044", "LNK2045", "LNK4003", "LNK4012", "LNK4013", "LNK4017", "LNK4018", "LNK4019", "LNK4030", "LNK4031", "LNK4038", "LNK4040", "LNK4041", "LNK4042", "LNK4043", "LNK4046", "LNK4047", "LNK4048", "LNK4051", "LNK4052", "LNK4056", "LNK4060", "LNK4061", "LNK4062", "LNK4066", "LNK4067", "LNK4068", "LNK4069", "LNK4072", "LNK4077", "LNK4079", "LNK4081", "LNK4085", "LNK4087", "LNK4088", "LNK4093", "LNK4094", "LNK4097", "LNK4103", "LNK4108", "LNK4195", "LNK4196", "LNK4198", "LNK4202", "LNK4203", "LNK4207", "LNK4208", "LNK4209", "LNK4223", "LNK4225", "LNK4226", "LNK4228", "LNK4232", "LNK4233", "LNK4236", "LNK4238", "LNK4239", "LNK4240", "LNK4241", "LNK4242", "LNK4243", "LNK4244", "LNK4245", "LNK4246", "LNK4249", "LNK4250", "LNK4251", "LNK4252", "LNK4255", "LNK4256", "LNK4257", "LNK4258", "LNK4259", "LNK4260", "LNK4261", "LNK4262", "LNK4263", "LNK4264", "LNK4265", "LNK4266", "LNK4267", "LNK4268", "LNK4269", "LNK4270", "LNK4271", "LNK4272", "LNK4273", "LNK4274", "LNK4275", "LNK4276", "LNK4277", "LNK4278", "LNK4279", "LNK4280", "LNK4281", "LNK4282", "LNK4283", "LNK4284", "LNK4285", "LNK4287", "LNK4288", "LNK4289", "LNK4290", "LNK4306", "LNK4307"] helpviewer_keywords: ["errors [C++]", "linker [C++], errors and warnings", "errors [C++], linker"] --- # Linker tools errors and warnings (LNKxxxx) The linker tools LINK, LIB, DUMPBIN, and EDITBIN share a common executable that generates these errors and warnings. The tools generate warnings of the form LNK*xxxx*, where *xxxx* is a four-digit number. -[!INCLUDE[error-boilerplate](../../error-messages/includes/error-boilerplate.md)] +[!INCLUDE[error-boilerplate](../includes/error-boilerplate.md)] ## Linker tools errors -[Linker Tools Error LNK1000](../../error-messages/tool-errors/linker-tools-error-lnk1000.md) \ -[Linker Tools Error LNK1103](../../error-messages/tool-errors/linker-tools-error-lnk1103.md) \ -[Linker Tools Error LNK1104](../../error-messages/tool-errors/linker-tools-error-lnk1104.md) \ -[Linker Tools Error LNK1106](../../error-messages/tool-errors/linker-tools-error-lnk1106.md) \ -[Linker Tools Error LNK1107](../../error-messages/tool-errors/linker-tools-error-lnk1107.md) \ -[Linker Tools Error LNK1112](../../error-messages/tool-errors/linker-tools-error-lnk1112.md) \ -[Linker Tools Error LNK1113](../../error-messages/tool-errors/linker-tools-error-lnk1113.md) \ -[Linker Tools Error LNK1120](../../error-messages/tool-errors/linker-tools-error-lnk1120.md) \ -[Linker Tools Error LNK1123](../../error-messages/tool-errors/linker-tools-error-lnk1123.md) \ -[Linker Tools Error LNK1127](../../error-messages/tool-errors/linker-tools-error-lnk1127.md) \ -[Linker Tools Error LNK1136](../../error-messages/tool-errors/linker-tools-error-lnk1136.md) \ -[Linker Tools Error LNK1140](../../error-messages/tool-errors/linker-tools-error-lnk1140.md) \ -[Linker Tools Error LNK1141](../../error-messages/tool-errors/linker-tools-error-lnk1141.md) \ -[Linker Tools Error LNK1143](../../error-messages/tool-errors/linker-tools-error-lnk1143.md) \ -[Linker Tools Error LNK1152](../../error-messages/tool-errors/linker-tools-error-lnk1152.md) \ -[Linker Tools Error LNK1158](../../error-messages/tool-errors/linker-tools-error-lnk1158.md) \ -[Linker Tools Error LNK1164](../../error-messages/tool-errors/linker-tools-error-lnk1164.md) \ -[Linker Tools Error LNK1166](../../error-messages/tool-errors/linker-tools-error-lnk1166.md) \ -[Linker Tools Error LNK1168](../../error-messages/tool-errors/linker-tools-error-lnk1168.md) \ -[Linker Tools Error LNK1169](../../error-messages/tool-errors/linker-tools-error-lnk1169.md) \ -[Linker Tools Error LNK1170](../../error-messages/tool-errors/linker-tools-error-lnk1170.md) \ -[Linker Tools Error LNK1179](../../error-messages/tool-errors/linker-tools-error-lnk1179.md) \ -[Linker Tools Error LNK1181](../../error-messages/tool-errors/linker-tools-error-lnk1181.md) \ -[Linker Tools Error LNK1188](../../error-messages/tool-errors/linker-tools-error-lnk1188.md) \ -[Linker Tools Error LNK1189](../../error-messages/tool-errors/linker-tools-error-lnk1189.md) \ -[Linker Tools Error LNK1196](../../error-messages/tool-errors/linker-tools-error-lnk1196.md) \ -[Linker Tools Error LNK1200](../../error-messages/tool-errors/linker-tools-error-lnk1200.md) \ -[Linker Tools Error LNK1201](../../error-messages/tool-errors/linker-tools-error-lnk1201.md) \ -[Linker Tools Error LNK1211](../../error-messages/tool-errors/linker-tools-error-lnk1211.md) \ -[Linker Tools Error LNK1215](../../error-messages/tool-errors/linker-tools-error-lnk1215.md) \ -[Linker Tools Error LNK1218](../../error-messages/tool-errors/linker-tools-error-lnk1218.md) \ -[Linker Tools Error LNK1221](../../error-messages/tool-errors/linker-tools-error-lnk1221.md) \ -[Linker Tools Error LNK1223](../../error-messages/tool-errors/linker-tools-error-lnk1223.md) \ -[Linker Tools Error LNK1224](../../error-messages/tool-errors/linker-tools-error-lnk1224.md) \ -[Linker Tools Error LNK1237](../../error-messages/tool-errors/linker-tools-error-lnk1237.md) \ -[Linker Tools Error LNK1240](../../error-messages/tool-errors/linker-tools-error-lnk1240.md) \ -[Linker Tools Error LNK1241](../../error-messages/tool-errors/linker-tools-error-lnk1241.md) \ -[Linker Tools Error LNK1245](../../error-messages/tool-errors/linker-tools-error-lnk1245.md) \ -[Linker Tools Error LNK1248](../../error-messages/tool-errors/linker-tools-error-lnk1248.md) \ -[Linker Tools Error LNK1256](../../error-messages/tool-errors/linker-tools-error-lnk1256.md) \ -[Linker Tools Error LNK1264](../../error-messages/tool-errors/linker-tools-error-lnk1264.md) \ -[Linker Tools Error LNK1277](../../error-messages/tool-errors/linker-tools-error-lnk1277.md) \ -[Linker Tools Error LNK1282](../../error-messages/tool-errors/linker-tools-error-lnk1282.md) \ -[Linker Tools Error LNK1287](../../error-messages/tool-errors/linker-tools-error-lnk1287.md) \ -[Linker Tools Error LNK1296](../../error-messages/tool-errors/linker-tools-error-lnk1296.md) \ -[Linker Tools Error LNK1301](../../error-messages/tool-errors/linker-tools-error-lnk1301.md) \ -[Linker Tools Error LNK1302](../../error-messages/tool-errors/linker-tools-error-lnk1302.md) \ -[Linker Tools Error LNK1306](../../error-messages/tool-errors/linker-tools-error-lnk1306.md) \ -[Linker Tools Error LNK1309](../../error-messages/tool-errors/linker-tools-error-lnk1309.md) \ -[Linker Tools Error LNK1312](../../error-messages/tool-errors/linker-tools-error-lnk1312.md) \ -[Linker Tools Error LNK1313](../../error-messages/tool-errors/linker-tools-error-lnk1313.md) \ -[Linker Tools Error LNK1314](../../error-messages/tool-errors/linker-tools-error-lnk1314.md) \ -[Linker Tools Error LNK1318](../../error-messages/tool-errors/linker-tools-error-lnk1318.md) \ -[Linker Tools Error LNK1332](../../error-messages/tool-errors/linker-tools-error-lnk1332.md) \ -[Linker Tools Error LNK1352](../../error-messages/tool-errors/linker-tools-error-lnk1352.md) \ -[Linker Tools Error LNK1561](../../error-messages/tool-errors/linker-tools-error-lnk1561.md) \ -[Linker Tools Error LNK2001](../../error-messages/tool-errors/linker-tools-error-lnk2001.md) \ -[Linker Tools Error LNK2004](../../error-messages/tool-errors/linker-tools-error-lnk2004.md) \ -[Linker Tools Error LNK2005](../../error-messages/tool-errors/linker-tools-error-lnk2005.md) \ -[Linker Tools Error LNK2008](../../error-messages/tool-errors/linker-tools-error-lnk2008.md) \ -[Linker Tools Error LNK2011](../../error-messages/tool-errors/linker-tools-error-lnk2011.md) \ -[Linker Tools Error LNK2013](../../error-messages/tool-errors/linker-tools-error-lnk2013.md) \ -[Linker Tools Error LNK2017](../../error-messages/tool-errors/linker-tools-error-lnk2017.md) \ -[Linker Tools Error LNK2019](../../error-messages/tool-errors/linker-tools-error-lnk2019.md) \ -[Linker Tools Error LNK2020](../../error-messages/tool-errors/linker-tools-error-lnk2020.md) \ -[Linker Tools Error LNK2022](../../error-messages/tool-errors/linker-tools-error-lnk2022.md) \ -[Linker Tools Error LNK2023](../../error-messages/tool-errors/linker-tools-error-lnk2023.md) \ -[Linker Tools Error LNK2026](../../error-messages/tool-errors/linker-tools-error-lnk2026.md) \ -[Linker Tools Error LNK2027](../../error-messages/tool-errors/linker-tools-error-lnk2027.md) \ -[Linker Tools Error LNK2028](../../error-messages/tool-errors/linker-tools-error-lnk2028.md) \ -[Linker Tools Error LNK2031](../../error-messages/tool-errors/linker-tools-error-lnk2031.md) \ -[Linker Tools Error LNK2033](../../error-messages/tool-errors/linker-tools-error-lnk2033.md) \ -[Linker Tools Error LNK2038](../../error-messages/tool-errors/linker-tools-error-lnk2038.md) \ -[Linker Tools Error LNK2039](../../error-messages/tool-errors/linker-tools-error-lnk2039.md) +| Error | Message | +|--|--| +| [Linker Tools Error LNK1000](linker-tools-error-lnk1000.md) | unknown error; consult documentation for technical support options | +| [Linker Tools Error LNK1103](linker-tools-error-lnk1103.md) | debugging information corrupt; recompile module | +| [Linker Tools Error LNK1104](linker-tools-error-lnk1104.md) | cannot open file '*filename*' | +| [Linker Tools Error LNK1106](linker-tools-error-lnk1106.md) | invalid file or disk full: cannot seek to location | +| [Linker Tools Error LNK1107](linker-tools-error-lnk1107.md) | invalid or corrupt file: cannot read at location *address* | +| [Linker Tools Error LNK1112](linker-tools-error-lnk1112.md) | module machine type '*type1*' conflicts with target machine type '*type2*' | +| [Linker Tools Error LNK1113](linker-tools-error-lnk1113.md) | invalid machine type type | +| [Linker Tools Error LNK1120](linker-tools-error-lnk1120.md) | *number* unresolved externals | +| [Linker Tools Error LNK1123](linker-tools-error-lnk1123.md) | failure during conversion to COFF: file invalid or corrupt | +| [Linker Tools Error LNK1127](linker-tools-error-lnk1127.md) | library is corrupt | +| [Linker Tools Error LNK1136](linker-tools-error-lnk1136.md) | invalid or corrupt file | +| [Linker Tools Error LNK1140](linker-tools-error-lnk1140.md) | too many modules for program database; link with /PDB:NONE | +| [Linker Tools Error LNK1141](linker-tools-error-lnk1141.md) | failure during build of exports file | +| [Linker Tools Error LNK1143](linker-tools-error-lnk1143.md) | invalid or corrupt file: no symbol for COMDAT section number | +| [Linker Tools Error LNK1152](linker-tools-error-lnk1152.md) | cannot resolve one or more undecorated symbols | +| [Linker Tools Error LNK1158](linker-tools-error-lnk1158.md) | cannot run 'filename' | +| [Linker Tools Error LNK1164](linker-tools-error-lnk1164.md) | section section alignment (number) greater than /ALIGN value | +| [Linker Tools Error LNK1166](linker-tools-error-lnk1166.md) | cannot adjust code at offset=offset, va=value | +| [Linker Tools Error LNK1168](linker-tools-error-lnk1168.md) | cannot open filename for writing | +| [Linker Tools Error LNK1169](linker-tools-error-lnk1169.md) | one or more multiply defined symbols found | +| [Linker Tools Error LNK1170](linker-tools-error-lnk1170.md) | line in command file contains *maximum-length* or more characters | +| [Linker Tools Error LNK1179](linker-tools-error-lnk1179.md) | invalid or corrupt file: duplicate COMDAT 'filename' | +| [Linker Tools Error LNK1181](linker-tools-error-lnk1181.md) | cannot open input file 'filename' | +| [Linker Tools Error LNK1188](linker-tools-error-lnk1188.md) | BADFIXUPSECTION:: invalid fixup target 'symbol'; possible zero length section | +| [Linker Tools Error LNK1189](linker-tools-error-lnk1189.md) | LIBTOOMANYMEMBERS:: library limit of number objects exceeded | +| [Linker Tools Error LNK1196](linker-tools-error-lnk1196.md) | invalid or corrupt import object: unknown version | +| [Linker Tools Error LNK1200](linker-tools-error-lnk1200.md) | error reading program database 'filename' | +| [Linker Tools Error LNK1201](linker-tools-error-lnk1201.md) | error writing to program database 'filename'; check for insufficient disk space, invalid path, or insufficient privilege | +| [Linker Tools Error LNK1211](linker-tools-error-lnk1211.md) | precompiled type information not found; '*filename*' not linked or overwritten | +| [Linker Tools Error LNK1215](linker-tools-error-lnk1215.md) | metadata operation failed (HRESULT) : error | +| [Linker Tools Error LNK1218](linker-tools-error-lnk1218.md) | warning treated as error; no output file generated | +| [Linker Tools Error LNK1221](linker-tools-error-lnk1221.md) | a subsystem can't be inferred and must be defined | +| [Linker Tools Error LNK1223](linker-tools-error-lnk1223.md) | invalid or corrupt file: file contains invalid .pdata contributions | +| [Linker Tools Error LNK1224](linker-tools-error-lnk1224.md) | invalid image base address | +| [Linker Tools Error LNK1237](linker-tools-error-lnk1237.md) | during code generation, compiler introduced reference to symbol 'symbol' defined in module 'module' compiled with /GL | +| [Linker Tools Error LNK1240](linker-tools-error-lnk1240.md) | failed to compile IDL content | +| [Linker Tools Error LNK1241](linker-tools-error-lnk1241.md) | resource file 'resource file' already specified | +| [Linker Tools Error LNK1245](linker-tools-error-lnk1245.md) | invalid subsystem 'subsystem' specified; /SUBSYSTEM must be WINDOWS, WINDOWSCE, or CONSOLE | +| [Linker Tools Error LNK1248](linker-tools-error-lnk1248.md) | image size ('*output_size*') exceeds maximum allowable size (*maximum_size*) | +| [Linker Tools Error LNK1256](linker-tools-error-lnk1256.md) | ALINK operation failed : reason | +| [Linker Tools Error LNK1264](linker-tools-error-lnk1264.md) | /LTCG:PGINSTRUMENT specified but no code generation required; instrumentation failed | +| [Linker Tools Error LNK1277](linker-tools-error-lnk1277.md) | object record not found in pgd (filename) | +| [Linker Tools Error LNK1282](linker-tools-error-lnk1282.md) | unable to /REBASE file; it has been signed | +| [Linker Tools Error LNK1287](linker-tools-error-lnk1287.md) | invalid managed entry point function | +| [Linker Tools Error LNK1296](linker-tools-error-lnk1296.md) | unable to load filename | +| [Linker Tools Error LNK1301](linker-tools-error-lnk1301.md) | LTCG clr modules found, incompatible with /LTCG:parameter | +| [Linker Tools Error LNK1302](linker-tools-error-lnk1302.md) | only support linking safe .netmodules; unable to link file .netmodule | +| [Linker Tools Error LNK1306](linker-tools-error-lnk1306.md) | DLL entry point function cannot be managed; compile to native | +| [Linker Tools Error LNK1309](linker-tools-error-lnk1309.md) | *type1* module detected; invalid with switch /CLRIMAGETYPE:*type2* | +| [Linker Tools Error LNK1312](linker-tools-error-lnk1312.md) | invalid or corrupt file: unable to import assembly | +| [Linker Tools Error LNK1313](linker-tools-error-lnk1313.md) | ijw/native module detected; cannot link with pure modules | +| [Linker Tools Error LNK1314](linker-tools-error-lnk1314.md) | corrupt or invalid COFF symbol table (undefined static or label symbol) | +| [Linker Tools Error LNK1318](linker-tools-error-lnk1318.md) | Unexpected PDB error; *cause* '*details*' | +| [Linker Tools Error LNK1332](linker-tools-error-lnk1332.md) | detected \ Windows Runtime types imported in one module and defined in another module | +| [Linker Tools Error LNK1352](linker-tools-error-lnk1352.md) | '*section_name_1*' and '*section_name_2*' cannot be merged into different sections | +| [Linker Tools Error LNK1561](linker-tools-error-lnk1561.md) | entry point must be defined | +| [Linker Tools Error LNK2001](linker-tools-error-lnk2001.md) | unresolved external symbol "*symbol*" | +| [Linker Tools Error LNK2004](linker-tools-error-lnk2004.md) | gp relative fixup overflow to 'target'; short section 'section' is too large or out of range. | +| [Linker Tools Error LNK2005](linker-tools-error-lnk2005.md) | *symbol* already defined in object | +| [Linker Tools Error LNK2008](linker-tools-error-lnk2008.md) | Fixup target is not aligned 'symbol_name' | +| [Linker Tools Error LNK2011](linker-tools-error-lnk2011.md) | precompiled object not linked in; image may not run | +| [Linker Tools Error LNK2013](linker-tools-error-lnk2013.md) | fixup type fixup overflow. Target 'symbol name' is out of range | +| [Linker Tools Error LNK2017](linker-tools-error-lnk2017.md) | 'symbol' relocation to 'segment' invalid without /LARGEADDRESSAWARE:NO | +| [Linker Tools Error LNK2019](linker-tools-error-lnk2019.md) | unresolved external symbol '*symbol*' referenced in function '*function*' | +| [Linker Tools Error LNK2020](linker-tools-error-lnk2020.md) | unresolved token 'token' | +| [Linker Tools Error LNK2022](linker-tools-error-lnk2022.md) | metadata operation failed (*HRESULT*) : *error_message* | +| [Linker Tools Error LNK2023](linker-tools-error-lnk2023.md) | bad dll or entry point \ | +| [Linker Tools Error LNK2026](linker-tools-error-lnk2026.md) | module unsafe for SAFESEH image | +| [Linker Tools Error LNK2027](linker-tools-error-lnk2027.md) | unresolved module reference 'module' | +| [Linker Tools Error LNK2028](linker-tools-error-lnk2028.md) | "*exported_function*" (*decorated_name*) referenced in function "*function_containing_function_call*" (*decorated_name*) | +| [Linker Tools Error LNK2031](linker-tools-error-lnk2031.md) | unable to generate p/invoke for "*function_declaration*" *decorated_name*; calling convention missing in metadata | +| [Linker Tools Error LNK2033](linker-tools-error-lnk2033.md) | unresolved typeref token (token) for 'type' | +| [Linker Tools Error LNK2038](linker-tools-error-lnk2038.md) | mismatch detected for '*name*': value '*value_1*' doesn't match value '*value_2*' in *filename.obj* | +| [Linker Tools Error LNK2039](linker-tools-error-lnk2039.md) | importing ref class \ that is defined in another.obj; it should be either imported or defined, but not both | ## Linker tools warnings -[Linker Tools Warning LNK4001](../../error-messages/tool-errors/linker-tools-warning-lnk4001.md) \ -[Linker Tools Warning LNK4002](../../error-messages/tool-errors/linker-tools-warning-lnk4002.md) \ -[Linker Tools Warning LNK4006](../../error-messages/tool-errors/linker-tools-warning-lnk4006.md) \ -[Linker Tools Warning LNK4010](../../error-messages/tool-errors/linker-tools-warning-lnk4010.md) \ -[Linker Tools Warning LNK4014](../../error-messages/tool-errors/linker-tools-warning-lnk4014.md) \ -[Linker Tools Warning LNK4020](../../error-messages/tool-errors/linker-tools-warning-lnk4020.md) \ -[Linker Tools Warning LNK4022](../../error-messages/tool-errors/linker-tools-warning-lnk4022.md) \ -[Linker Tools Warning LNK4039](../../error-messages/tool-errors/linker-tools-warning-lnk4039.md) \ -[Linker Tools Warning LNK4044](../../error-messages/tool-errors/linker-tools-warning-lnk4044.md) \ -[Linker Tools Warning LNK4049](../../error-messages/tool-errors/linker-tools-warning-lnk4049.md) \ -[Linker Tools Warning LNK4065](../../error-messages/tool-errors/linker-tools-warning-lnk4065.md) \ -[Linker Tools Warning LNK4070](../../error-messages/tool-errors/linker-tools-warning-lnk4070.md) \ -[Linker Tools Warning LNK4071](../../error-messages/tool-errors/linker-tools-warning-lnk4071.md) \ -[Linker Tools Warning LNK4073](../../error-messages/tool-errors/linker-tools-warning-lnk4073.md) \ -[Linker Tools Warning LNK4075](../../error-messages/tool-errors/linker-tools-warning-lnk4075.md) \ -[Linker Tools Warning LNK4076](../../error-messages/tool-errors/linker-tools-warning-lnk4076.md) \ -[Linker Tools Warning LNK4078](../../error-messages/tool-errors/linker-tools-warning-lnk4078.md) \ -[Linker Tools Warning LNK4086](../../error-messages/tool-errors/linker-tools-warning-lnk4086.md) \ -[Linker Tools Warning LNK4092](../../error-messages/tool-errors/linker-tools-warning-lnk4092.md) \ -[Linker Tools Warning LNK4096](../../error-messages/tool-errors/linker-tools-warning-lnk4096.md) \ -[Linker Tools Warning LNK4098](../../error-messages/tool-errors/linker-tools-warning-lnk4098.md) \ -[Linker Tools Warning LNK4099](../../error-messages/tool-errors/linker-tools-warning-lnk4099.md) \ -[Linker Tools Warning LNK4102](../../error-messages/tool-errors/linker-tools-warning-lnk4102.md) \ -[Linker Tools Warning LNK4104](../../error-messages/tool-errors/linker-tools-warning-lnk4104.md) \ -[Linker Tools Warning LNK4105](../../error-messages/tool-errors/linker-tools-warning-lnk4105.md) \ -[Linker Tools Warning LNK4194](../../error-messages/tool-errors/linker-tools-warning-lnk4194.md) \ -[Linker Tools Warning LNK4197](../../error-messages/tool-errors/linker-tools-warning-lnk4197.md) \ -[Linker Tools Warning LNK4199](../../error-messages/tool-errors/linker-tools-warning-lnk4199.md) \ -[Linker Tools Warning LNK4200](../../error-messages/tool-errors/linker-tools-warning-lnk4200.md) \ -[Linker Tools Warning LNK4204](../../error-messages/tool-errors/linker-tools-warning-lnk4204.md) \ -[Linker Tools Warning LNK4205](../../error-messages/tool-errors/linker-tools-warning-lnk4205.md) \ -[Linker Tools Warning LNK4206](../../error-messages/tool-errors/linker-tools-warning-lnk4206.md) \ -[Linker Tools Warning LNK4210](../../error-messages/tool-errors/linker-tools-warning-lnk4210.md) \ -[Linker Tools Warning LNK4216](../../error-messages/tool-errors/linker-tools-warning-lnk4216.md) \ -[Linker Tools Warning LNK4217](../../error-messages/tool-errors/linker-tools-warning-lnk4217.md) \ -[Linker Tools Warning LNK4219](../../error-messages/tool-errors/linker-tools-warning-lnk4219.md) \ -[Linker Tools Warning LNK4220](../../error-messages/tool-errors/linker-tools-warning-lnk4220.md) \ -[Linker Tools Warning LNK4221](../../error-messages/tool-errors/linker-tools-warning-lnk4221.md) \ -[Linker Tools Warning LNK4222](../../error-messages/tool-errors/linker-tools-warning-lnk4222.md) \ -[Linker Tools Warning LNK4224](../../error-messages/tool-errors/linker-tools-warning-lnk4224.md) \ -[Linker Tools Warning LNK4227](../../error-messages/tool-errors/linker-tools-warning-lnk4227.md) \ -[Linker Tools Warning LNK4229](../../error-messages/tool-errors/linker-tools-warning-lnk4229.md) \ -[Linker Tools Warning LNK4237](../../error-messages/tool-errors/linker-tools-warning-lnk4237.md) \ -[Linker Tools Warning LNK4247](../../error-messages/tool-errors/linker-tools-warning-lnk4247.md) \ -[Linker Tools Warning LNK4248](../../error-messages/tool-errors/linker-tools-warning-lnk4248.md) \ -[Linker Tools Warning LNK4253](../../error-messages/tool-errors/linker-tools-warning-lnk4253.md) \ -[Linker Tools Warning LNK4254](../../error-messages/tool-errors/linker-tools-warning-lnk4254.md) \ -[Linker Tools Warning LNK4286](../../error-messages/tool-errors/linker-tools-warning-lnk4286.md) \ -[Linker Tools Warning LNK4306](../../error-messages/tool-errors/linker-tools-warning-lnk4306.md) \ -[Linker Tools Warning LNK4307](../../error-messages/tool-errors/linker-tools-warning-lnk4307.md) +| Warning | Message | +|--|--| +| [Linker Tools Warning LNK4001](linker-tools-warning-lnk4001.md) | no object files specified; libraries used | +| [Linker Tools Warning LNK4002](linker-tools-warning-lnk4002.md) | symbol defined in object | +| [Linker Tools Warning LNK4006](linker-tools-warning-lnk4006.md) | symbol already defined in object; second definition ignored | +| [Linker Tools Warning LNK4010](linker-tools-warning-lnk4010.md) | invalid subsystem version number number; default subsystem version assumed | +| [Linker Tools Warning LNK4014](linker-tools-warning-lnk4014.md) | cannot find member object "objectname" | +| [Linker Tools Warning LNK4020](linker-tools-warning-lnk4020.md) | a type record in '*filename*' is corrupted; some symbols and types may not be accessible from the debugger | +| [Linker Tools Warning LNK4022](linker-tools-warning-lnk4022.md) | cannot find unique match for symbol 'symbol' | +| [Linker Tools Warning LNK4039](linker-tools-warning-lnk4039.md) | section 'name' specified with /SECTION option does not exist | +| [Linker Tools Warning LNK4044](linker-tools-warning-lnk4044.md) | unrecognized option 'option'; ignored | +| [Linker Tools Warning LNK4049](linker-tools-warning-lnk4049.md) | symbol '*symbol*' defined in '*filename.obj*' is imported | +| [Linker Tools Warning LNK4065](linker-tools-warning-lnk4065.md) | 'function' cannot be ordered; ignored | +| [Linker Tools Warning LNK4070](linker-tools-warning-lnk4070.md) | /OUT:filename directive in .EXP differs from output filename 'filename'; ignoring directive | +| [Linker Tools Warning LNK4071](linker-tools-warning-lnk4071.md) | cannot be incrementally linked on subsequent links | +| [Linker Tools Warning LNK4073](linker-tools-warning-lnk4073.md) | cannot create map for .ilk file; linking nonincrementally | +| [Linker Tools Warning LNK4075](linker-tools-warning-lnk4075.md) | ignoring "option1" due to "option2" specification | +| [Linker Tools Warning LNK4076](linker-tools-warning-lnk4076.md) | invalid incremental status file 'filename'; linking nonincrementally | +| [Linker Tools Warning LNK4078](linker-tools-warning-lnk4078.md) | multiple 'section name' sections found with different attributes | +| [Linker Tools Warning LNK4086](linker-tools-warning-lnk4086.md) | entrypoint 'function' is not __stdcall with 'number' bytes of arguments; image may not run | +| [Linker Tools Warning LNK4092](linker-tools-warning-lnk4092.md) | shared writable section 'section' contains relocations; image may not run correctly | +| [Linker Tools Warning LNK4096](linker-tools-warning-lnk4096.md) | /BASE value "number" is invalid for Windows 95 and Windows 98; image may not run | +| [Linker Tools Warning LNK4098](linker-tools-warning-lnk4098.md) | defaultlib '*library*' conflicts with use of other libs; use /NODEFAULTLIB:*library* | +| [Linker Tools Warning LNK4099](linker-tools-warning-lnk4099.md) | PDB 'filename' was not found with 'object/library' or at 'path'; linking object as if no debug info | +| [Linker Tools Warning LNK4102](linker-tools-warning-lnk4102.md) | export of deleting destructor 'name'; image may not run correctly | +| [Linker Tools Warning LNK4104](linker-tools-warning-lnk4104.md) | export of symbol 'symbol' should be PRIVATE | +| [Linker Tools Warning LNK4105](linker-tools-warning-lnk4105.md) | no argument specified with option 'option'; ignoring option | +| [Linker Tools Warning LNK4194](linker-tools-warning-lnk4194.md) | /DELAYLOAD:dll name ignored | +| [Linker Tools Warning LNK4197](linker-tools-warning-lnk4197.md) | export '*exportname*' specified multiple times; using first specification | +| [Linker Tools Warning LNK4199](linker-tools-warning-lnk4199.md) | /DELAYLOAD:dllname ignored; no imports found from dllname | +| [Linker Tools Warning LNK4200](linker-tools-warning-lnk4200.md) | corrupt line number information in object file; ignored | +| [Linker Tools Warning LNK4204](linker-tools-warning-lnk4204.md) | 'filename' is missing debugging information for referencing module; linking object as if no debug info | +| [Linker Tools Warning LNK4205](linker-tools-warning-lnk4205.md) | 'filename' is missing current debugging information for referencing module; linking object as if no debug info | +| [Linker Tools Warning LNK4206](linker-tools-warning-lnk4206.md) | precompiled type information not found; '*filename*' not linked or overwritten; linking object as if no debug info | +| [Linker Tools Warning LNK4210](linker-tools-warning-lnk4210.md) | section *section* exists; there may be unhandled static initializers or terminators | +| [Linker Tools Warning LNK4216](linker-tools-warning-lnk4216.md) | Exported entry point entry | +| [Linker Tools Warning LNK4217](linker-tools-warning-lnk4217.md) | symbol '*symbol*' defined in '*filename_1.obj*' is imported by '*filename_2.obj*' in function '*function*' | +| [Linker Tools Warning LNK4219](linker-tools-warning-lnk4219.md) | fixup name fixup overflow. Target 'target symbol name' is out of range, inserting thunk | +| [Linker Tools Warning LNK4220](linker-tools-warning-lnk4220.md) | invalid 'linker option' value 'value'; assumed default | +| [Linker Tools Warning LNK4221](linker-tools-warning-lnk4221.md) | This object file does not define any previously undefined public symbols, so it will not be used by any link operation that consumes this library | +| [Linker Tools Warning LNK4222](linker-tools-warning-lnk4222.md) | exported symbol 'symbol' should not be assigned an ordinal | +| [Linker Tools Warning LNK4224](linker-tools-warning-lnk4224.md) | *option* is no longer supported; ignored | +| [Linker Tools Warning LNK4227](linker-tools-warning-lnk4227.md) | metadata operation warning (*HRESULT*) : *warning_message* | +| [Linker Tools Warning LNK4229](linker-tools-warning-lnk4229.md) | invalid directive /directive found; ignored | +| [Linker Tools Warning LNK4237](linker-tools-warning-lnk4237.md) | /SUBSYSTEM:NATIVE specified when importing from 'dll'; Use /SUBSYSTEM:CONSOLE or /SUBSYSTEM:WINDOWS. | +| [Linker Tools Warning LNK4247](linker-tools-warning-lnk4247.md) | entry point 'decorated_function_name' already has a thread attribute; 'attribute' ignored | +| [Linker Tools Warning LNK4248](linker-tools-warning-lnk4248.md) | unresolved typeref token (token) for 'type'; image may not run | +| [Linker Tools Warning LNK4253](linker-tools-warning-lnk4253.md) | section 'section1' not merged into 'section2'; already merged into 'section3' | +| [Linker Tools Warning LNK4254](linker-tools-warning-lnk4254.md) | section 'section1' (offset) merged into 'section2' (offset) with different attributes | +| [Linker Tools Warning LNK4286](linker-tools-warning-lnk4286.md) | symbol '*symbol*' defined in '*filename_1.obj*' is imported by '*filename_2.obj*' | +| [Linker Tools Warning LNK4306](linker-tools-warning-lnk4306.md) | The auxiliary delayload import address table is not properly aligned with the primary delayload import address table. This may have negative perf impact. | +| [Linker Tools Warning LNK4307](linker-tools-warning-lnk4307.md) | The auxiliary delayload import address table copy is not properly aligned with the auxiliary delayload import address table. This may have negative perf impact. | ## See also diff --git a/docs/error-messages/tool-errors/linker-tools-warning-lnk4001.md b/docs/error-messages/tool-errors/linker-tools-warning-lnk4001.md index acead2979da..5a3f63068cc 100644 --- a/docs/error-messages/tool-errors/linker-tools-warning-lnk4001.md +++ b/docs/error-messages/tool-errors/linker-tools-warning-lnk4001.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Linker Tools Warning LNK4001" title: "Linker Tools Warning LNK4001" -ms.date: "11/04/2016" +description: "Learn more about: Linker Tools Warning LNK4001" +ms.date: 11/04/2016 f1_keywords: ["LNK4001"] helpviewer_keywords: ["LNK4001"] -ms.assetid: 0a8b1c3a-64ce-4311-b7c0-065995059246 --- # Linker Tools Warning LNK4001 -no object files specified; libraries used +> no object files specified; libraries used + +## Remarks The linker was passed one or more .lib files, but no .obj files. diff --git a/docs/error-messages/tool-errors/linker-tools-warning-lnk4002.md b/docs/error-messages/tool-errors/linker-tools-warning-lnk4002.md index ac15b1573cc..71cff124cea 100644 --- a/docs/error-messages/tool-errors/linker-tools-warning-lnk4002.md +++ b/docs/error-messages/tool-errors/linker-tools-warning-lnk4002.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Linker Tools Warning LNK4002" title: "Linker Tools Warning LNK4002" -ms.date: "11/04/2016" +description: "Learn more about: Linker Tools Warning LNK4002" +ms.date: 11/04/2016 f1_keywords: ["LNK4002"] helpviewer_keywords: ["LNK4002"] -ms.assetid: 09f81af5-e51c-496c-a6eb-2863e85375c3 --- # Linker Tools Warning LNK4002 -symbol defined in object +> symbol defined in object + +## Remarks The symbol, displayed in its decorated form, was specified in its undecorated form in `object`, but a unique match to a decorated symbol could not be found. This warning is always preceded by warning [LNK4022](../../error-messages/tool-errors/linker-tools-warning-lnk4022.md) and followed by fatal error [LNK1152](../../error-messages/tool-errors/linker-tools-error-lnk1152.md). diff --git a/docs/error-messages/tool-errors/linker-tools-warning-lnk4006.md b/docs/error-messages/tool-errors/linker-tools-warning-lnk4006.md index b53d91f7c4a..8fd9e721fe0 100644 --- a/docs/error-messages/tool-errors/linker-tools-warning-lnk4006.md +++ b/docs/error-messages/tool-errors/linker-tools-warning-lnk4006.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Linker Tools Warning LNK4006" title: "Linker Tools Warning LNK4006" -ms.date: "11/04/2016" +description: "Learn more about: Linker Tools Warning LNK4006" +ms.date: 11/04/2016 f1_keywords: ["LNK4006"] helpviewer_keywords: ["LNK4006"] -ms.assetid: 3a637d17-1676-4ea6-bd8b-290137d28d3b --- # Linker Tools Warning LNK4006 -symbol already defined in object; second definition ignored +> symbol already defined in object; second definition ignored + +## Remarks The given `symbol`, displayed in its decorated form, was multiply defined. When this warning is encountered, `symbol` will be added twice, but only its first form will be used. diff --git a/docs/error-messages/tool-errors/linker-tools-warning-lnk4010.md b/docs/error-messages/tool-errors/linker-tools-warning-lnk4010.md index 64f217c9de3..a586214ca26 100644 --- a/docs/error-messages/tool-errors/linker-tools-warning-lnk4010.md +++ b/docs/error-messages/tool-errors/linker-tools-warning-lnk4010.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Linker Tools Warning LNK4010" title: "Linker Tools Warning LNK4010" -ms.date: "11/04/2016" +description: "Learn more about: Linker Tools Warning LNK4010" +ms.date: 11/04/2016 f1_keywords: ["LNK4010"] helpviewer_keywords: ["LNK4010"] -ms.assetid: 2824cf99-4174-4b60-a6e2-c01e9f1ee52d --- # Linker Tools Warning LNK4010 -invalid subsystem version number number; default subsystem version assumed +> invalid subsystem version number number; default subsystem version assumed + +## Remarks You can specify a version for the image's subsystem ([/SUBSYSTEM](../../build/reference/subsystem-specify-subsystem.md)). Each subsystem has a minimum version requirement. If the specified version is lower than the minimum, this warning will occur and the linker will just use the default subsystem. diff --git a/docs/error-messages/tool-errors/linker-tools-warning-lnk4014.md b/docs/error-messages/tool-errors/linker-tools-warning-lnk4014.md index fed59984e71..d073124ac8c 100644 --- a/docs/error-messages/tool-errors/linker-tools-warning-lnk4014.md +++ b/docs/error-messages/tool-errors/linker-tools-warning-lnk4014.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Linker Tools Warning LNK4014" title: "Linker Tools Warning LNK4014" -ms.date: "11/04/2016" +description: "Learn more about: Linker Tools Warning LNK4014" +ms.date: 11/04/2016 f1_keywords: ["LNK4014"] helpviewer_keywords: ["LNK4014"] -ms.assetid: 394903e9-3ded-4ea4-b7c0-a3535d4b4da4 --- # Linker Tools Warning LNK4014 -cannot find member object "objectname" +> cannot find member object "objectname" + +## Remarks LIB could not find `objectname` in the library. diff --git a/docs/error-messages/tool-errors/linker-tools-warning-lnk4020.md b/docs/error-messages/tool-errors/linker-tools-warning-lnk4020.md index 264bda4b079..913227f12fa 100644 --- a/docs/error-messages/tool-errors/linker-tools-warning-lnk4020.md +++ b/docs/error-messages/tool-errors/linker-tools-warning-lnk4020.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: Linker Tools Warning LNK4020" title: "Linker Tools Warning LNK4020" -ms.date: "05/29/2018" +description: "Learn more about: Linker Tools Warning LNK4020" +ms.date: 05/29/2018 f1_keywords: ["LNK4020"] helpviewer_keywords: ["LNK4020"] --- @@ -9,6 +9,8 @@ helpviewer_keywords: ["LNK4020"] > a type record in '*filename*' is corrupted; some symbols and types may not be accessible from the debugger +## Remarks + The PDB file *filename* has a corrupted type record. This issue is often secondary to other build issues; unless this is the first reported build issue, deal with the other errors and warnings first. If this is the first reported issue, you may need to clean your build directories and rebuild your project. If you use parallel build processes, see if the error persists when you serialize your build. diff --git a/docs/error-messages/tool-errors/linker-tools-warning-lnk4022.md b/docs/error-messages/tool-errors/linker-tools-warning-lnk4022.md index 49b2a8b1866..b8629ec6796 100644 --- a/docs/error-messages/tool-errors/linker-tools-warning-lnk4022.md +++ b/docs/error-messages/tool-errors/linker-tools-warning-lnk4022.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Linker Tools Warning LNK4022" title: "Linker Tools Warning LNK4022" -ms.date: "11/04/2016" +description: "Learn more about: Linker Tools Warning LNK4022" +ms.date: 11/04/2016 f1_keywords: ["LNK4022"] helpviewer_keywords: ["LNK4022"] -ms.assetid: 890f487e-db98-45dd-a226-c7ccead82b1e --- # Linker Tools Warning LNK4022 -cannot find unique match for symbol 'symbol' +> cannot find unique match for symbol 'symbol' + +## Remarks LINK or LIB found multiple matches for the given undecorated symbol and it could not resolve the ambiguity. No output file (.exe, .dll, .exp, or .lib) is produced. This warning is followed by one warning [LNK4002](../../error-messages/tool-errors/linker-tools-warning-lnk4002.md) for each duplicate symbol and is finally followed by fatal error [LNK1152](../../error-messages/tool-errors/linker-tools-error-lnk1152.md). diff --git a/docs/error-messages/tool-errors/linker-tools-warning-lnk4037.md b/docs/error-messages/tool-errors/linker-tools-warning-lnk4037.md index 271d321252a..2eafbb1026b 100644 --- a/docs/error-messages/tool-errors/linker-tools-warning-lnk4037.md +++ b/docs/error-messages/tool-errors/linker-tools-warning-lnk4037.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Linker Tools Warning LNK4037" title: "Linker Tools Warning LNK4037" -ms.date: "10/04/2017" +description: "Learn more about: Linker Tools Warning LNK4037" +ms.date: 10/04/2017 f1_keywords: ["LNK4037"] helpviewer_keywords: ["LNK4037"] -ms.assetid: 9ba02fd3-b04f-4679-bab9-26fa82cf09bb --- # Linker Tools Warning LNK4037 ->'*symbol*' does not exist; ignored +> '*symbol*' does not exist; ignored + +## Remarks The decorated name *symbol* could not be ordered by using the [/ORDER](../../build/reference/order-put-functions-in-order.md) option because it could not be found in the program. Check the specification of *symbol* in the order response file. For more information, see the [/ORDER (Put functions in order)](../../build/reference/order-put-functions-in-order.md) linker option. diff --git a/docs/error-messages/tool-errors/linker-tools-warning-lnk4039.md b/docs/error-messages/tool-errors/linker-tools-warning-lnk4039.md index 408939d9f3f..c86c2783939 100644 --- a/docs/error-messages/tool-errors/linker-tools-warning-lnk4039.md +++ b/docs/error-messages/tool-errors/linker-tools-warning-lnk4039.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Linker Tools Warning LNK4039" title: "Linker Tools Warning LNK4039" -ms.date: "11/04/2016" +description: "Learn more about: Linker Tools Warning LNK4039" +ms.date: 11/04/2016 f1_keywords: ["LNK4039"] helpviewer_keywords: ["LNK4039"] -ms.assetid: ed7b1783-a7b2-4d3e-8afb-ca1648dae2c2 --- # Linker Tools Warning LNK4039 -section 'name' specified with /SECTION option does not exist +> section 'name' specified with /SECTION option does not exist + +## Remarks [DUMPBIN](../../build/reference/dumpbin-reference.md) or [EDITBIN](../../build/reference/editbin-reference.md) could not find a section called `name` in the input file. diff --git a/docs/error-messages/tool-errors/linker-tools-warning-lnk4044.md b/docs/error-messages/tool-errors/linker-tools-warning-lnk4044.md index 6f46ad0a097..3852e8bb3b7 100644 --- a/docs/error-messages/tool-errors/linker-tools-warning-lnk4044.md +++ b/docs/error-messages/tool-errors/linker-tools-warning-lnk4044.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Linker Tools Warning LNK4044" title: "Linker Tools Warning LNK4044" -ms.date: "11/04/2016" +description: "Learn more about: Linker Tools Warning LNK4044" +ms.date: 11/04/2016 f1_keywords: ["LNK4044"] helpviewer_keywords: ["LNK4044"] -ms.assetid: f3a67a15-98c0-42ed-afcb-f5f9540e2671 --- # Linker Tools Warning LNK4044 -unrecognized option 'option'; ignored +> unrecognized option 'option'; ignored + +## Remarks The given option is not a valid option for this tool. The tool ignored the option. diff --git a/docs/error-messages/tool-errors/linker-tools-warning-lnk4049.md b/docs/error-messages/tool-errors/linker-tools-warning-lnk4049.md index 2a99ccb7648..7f6c8738fa3 100644 --- a/docs/error-messages/tool-errors/linker-tools-warning-lnk4049.md +++ b/docs/error-messages/tool-errors/linker-tools-warning-lnk4049.md @@ -1,19 +1,18 @@ --- -description: "Learn more about: Linker Tools Warning LNK4049" title: "Linker Tools Warning LNK4049" -ms.date: "04/15/2019" +description: "Learn more about: Linker Tools Warning LNK4049" +ms.date: 04/15/2019 f1_keywords: ["LNK4049"] helpviewer_keywords: ["LNK4049"] -ms.assetid: 5fd5fb24-c860-4149-a557-0ac26a65d97c --- # Linker Tools Warning LNK4049 > symbol '*symbol*' defined in '*filename.obj*' is imported -[__declspec(dllimport)](../../cpp/dllexport-dllimport.md) was specified for *symbol* even though the symbol is defined in object file *filename.obj* in the same image. Remove the `__declspec(dllimport)` modifier to resolve this warning. - ## Remarks +[__declspec(dllimport)](../../cpp/dllexport-dllimport.md) was specified for *symbol* even though the symbol is defined in object file *filename.obj* in the same image. Remove the `__declspec(dllimport)` modifier to resolve this warning. + This warning is generated by the linker when you define a symbol in one object file and reference it by using the `__declspec(dllimport)` declaration modifier in another. Warning LNK4049 is a more general version of [Linker Tools Warning LNK4217](linker-tools-warning-lnk4217.md). The linker generates warning LNK4049 when it can't determine which function or object file referenced the imported symbol. diff --git a/docs/error-messages/tool-errors/linker-tools-warning-lnk4065.md b/docs/error-messages/tool-errors/linker-tools-warning-lnk4065.md index 0313df14016..866c8e515fb 100644 --- a/docs/error-messages/tool-errors/linker-tools-warning-lnk4065.md +++ b/docs/error-messages/tool-errors/linker-tools-warning-lnk4065.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Linker Tools Warning LNK4065" title: "Linker Tools Warning LNK4065" -ms.date: "11/04/2016" +description: "Learn more about: Linker Tools Warning LNK4065" +ms.date: 11/04/2016 f1_keywords: ["LNK4065"] helpviewer_keywords: ["LNK4065"] -ms.assetid: aa5c9e2c-9ad3-4460-8605-4c12bbc6d423 --- # Linker Tools Warning LNK4065 -'function' cannot be ordered; ignored +> 'function' cannot be ordered; ignored + +## Remarks The given function was not compiled as a packaged function. Recompile using [/Gy](../../build/reference/gy-enable-function-level-linking.md). diff --git a/docs/error-messages/tool-errors/linker-tools-warning-lnk4070.md b/docs/error-messages/tool-errors/linker-tools-warning-lnk4070.md index 2d4a8c774ae..73002b55e0a 100644 --- a/docs/error-messages/tool-errors/linker-tools-warning-lnk4070.md +++ b/docs/error-messages/tool-errors/linker-tools-warning-lnk4070.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Linker Tools Warning LNK4070" title: "Linker Tools Warning LNK4070" -ms.date: "11/04/2016" +description: "Learn more about: Linker Tools Warning LNK4070" +ms.date: 11/04/2016 f1_keywords: ["LNK4070"] helpviewer_keywords: ["LNK4070"] -ms.assetid: f95f179a-fff9-427e-bd51-466b3934517f --- # Linker Tools Warning LNK4070 -/OUT:filename directive in .EXP differs from output filename 'filename'; ignoring directive +> /OUT:filename directive in .EXP differs from output filename 'filename'; ignoring directive + +## Remarks The `filename` specified in the [NAME](../../build/reference/name-c-cpp.md) or [LIBRARY](../../build/reference/library.md) statement when the .exp file was created differs from the output `filename` that was either assumed by default or specified with the [/OUT](../../build/reference/out-output-file-name.md) option. diff --git a/docs/error-messages/tool-errors/linker-tools-warning-lnk4071.md b/docs/error-messages/tool-errors/linker-tools-warning-lnk4071.md index 83437b5126a..f11ad7b9b8f 100644 --- a/docs/error-messages/tool-errors/linker-tools-warning-lnk4071.md +++ b/docs/error-messages/tool-errors/linker-tools-warning-lnk4071.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Linker Tools Warning LNK4071" title: "Linker Tools Warning LNK4071" -ms.date: "11/04/2016" +description: "Learn more about: Linker Tools Warning LNK4071" +ms.date: 11/04/2016 f1_keywords: ["LNK4071"] helpviewer_keywords: ["LNK4071"] -ms.assetid: 803f8c34-8219-4f55-a4ae-7133ceff2ba3 --- # Linker Tools Warning LNK4071 -cannot be incrementally linked on subsequent links +> cannot be incrementally linked on subsequent links + +## Remarks LINK found multiple definitions for one or more symbols, but [/FORCE](../../build/reference/force-force-file-output.md) or **/FORCE:MULTIPLE** was used to create an output file regardless of errors. LINK deleted the incremental status (.ilk) file. diff --git a/docs/error-messages/tool-errors/linker-tools-warning-lnk4073.md b/docs/error-messages/tool-errors/linker-tools-warning-lnk4073.md index 121c6eaadbc..0347c6cd330 100644 --- a/docs/error-messages/tool-errors/linker-tools-warning-lnk4073.md +++ b/docs/error-messages/tool-errors/linker-tools-warning-lnk4073.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Linker Tools Warning LNK4073" title: "Linker Tools Warning LNK4073" -ms.date: "11/04/2016" +description: "Learn more about: Linker Tools Warning LNK4073" +ms.date: 11/04/2016 f1_keywords: ["LNK4073"] helpviewer_keywords: ["LNK4073"] -ms.assetid: a0c80242-3395-45bd-bbe7-4f31d7ac9e3a --- # Linker Tools Warning LNK4073 -cannot create map for .ilk file; linking nonincrementally +> cannot create map for .ilk file; linking nonincrementally + +## Remarks There was not a large enough contiguous space in shared memory for LINK to create the incremental status (.ilk) file. LINK performed a nonincremental build. diff --git a/docs/error-messages/tool-errors/linker-tools-warning-lnk4075.md b/docs/error-messages/tool-errors/linker-tools-warning-lnk4075.md index d68c11580e0..30c7c247f9c 100644 --- a/docs/error-messages/tool-errors/linker-tools-warning-lnk4075.md +++ b/docs/error-messages/tool-errors/linker-tools-warning-lnk4075.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Linker Tools Warning LNK4075" title: "Linker Tools Warning LNK4075" -ms.date: "11/04/2016" +description: "Learn more about: Linker Tools Warning LNK4075" +ms.date: 11/04/2016 f1_keywords: ["LNK4075"] helpviewer_keywords: ["LNK4075"] -ms.assetid: f39ad3f9-c263-4cf0-9d70-259fc56ac96d --- # Linker Tools Warning LNK4075 -ignoring "option1" due to "option2" specification +> ignoring "option1" due to "option2" specification + +## Remarks The second option overrides the first. diff --git a/docs/error-messages/tool-errors/linker-tools-warning-lnk4076.md b/docs/error-messages/tool-errors/linker-tools-warning-lnk4076.md index 34b7ca35901..2f5ab3ac799 100644 --- a/docs/error-messages/tool-errors/linker-tools-warning-lnk4076.md +++ b/docs/error-messages/tool-errors/linker-tools-warning-lnk4076.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Linker Tools Warning LNK4076" title: "Linker Tools Warning LNK4076" -ms.date: "11/04/2016" +description: "Learn more about: Linker Tools Warning LNK4076" +ms.date: 11/04/2016 f1_keywords: ["LNK4076"] helpviewer_keywords: ["LNK4076"] -ms.assetid: c424d43b-abb3-4df4-be66-8907b859a555 --- # Linker Tools Warning LNK4076 -invalid incremental status file 'filename'; linking nonincrementally +> invalid incremental status file 'filename'; linking nonincrementally + +## Remarks LINK cannot write to the incremental status (.ilk) file. Either `filename` is corrupt or it is not an incremental linking database. Remove the file and relink. diff --git a/docs/error-messages/tool-errors/linker-tools-warning-lnk4078.md b/docs/error-messages/tool-errors/linker-tools-warning-lnk4078.md index 407078f7750..977fec14c67 100644 --- a/docs/error-messages/tool-errors/linker-tools-warning-lnk4078.md +++ b/docs/error-messages/tool-errors/linker-tools-warning-lnk4078.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Linker Tools Warning LNK4078" title: "Linker Tools Warning LNK4078" -ms.date: "11/04/2016" +description: "Learn more about: Linker Tools Warning LNK4078" +ms.date: 11/04/2016 f1_keywords: ["LNK4078"] helpviewer_keywords: ["LNK4078"] -ms.assetid: 5a16796d-6caf-42d9-8f65-b042843eafb8 --- # Linker Tools Warning LNK4078 -multiple 'section name' sections found with different attributes +> multiple 'section name' sections found with different attributes + +## Remarks LINK found two or more sections that have the same name but different attributes. @@ -20,7 +21,7 @@ Recreate the file and relink. LNK4078 can also be caused by a breaking change: the section named by [init_seg](../../preprocessor/init-seg.md) on x86 was read/write, it is now read only. -The following sample generates LNK4078. +The following example generates LNK4078. ```cpp // LNK4078.cpp diff --git a/docs/error-messages/tool-errors/linker-tools-warning-lnk4086.md b/docs/error-messages/tool-errors/linker-tools-warning-lnk4086.md index c41c539e819..3e04f4741cd 100644 --- a/docs/error-messages/tool-errors/linker-tools-warning-lnk4086.md +++ b/docs/error-messages/tool-errors/linker-tools-warning-lnk4086.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Linker Tools Warning LNK4086" title: "Linker Tools Warning LNK4086" -ms.date: "11/04/2016" +description: "Learn more about: Linker Tools Warning LNK4086" +ms.date: 11/04/2016 f1_keywords: ["LNK4086"] helpviewer_keywords: ["LNK4086"] -ms.assetid: ea1eecbb-ba2c-41bb-9a4f-fa0808a4b92d --- # Linker Tools Warning LNK4086 -entrypoint 'function' is not __stdcall with 'number' bytes of arguments; image may not run +> entrypoint 'function' is not __stdcall with 'number' bytes of arguments; image may not run + +## Remarks The entry point for a DLL must be **`__stdcall`**. Either recompile the function with the [/Gz](../../build/reference/gd-gr-gv-gz-calling-convention.md) option or specify **`__stdcall`** or WINAPI when you define the function. diff --git a/docs/error-messages/tool-errors/linker-tools-warning-lnk4092.md b/docs/error-messages/tool-errors/linker-tools-warning-lnk4092.md index 952fb421cd8..8db800d129a 100644 --- a/docs/error-messages/tool-errors/linker-tools-warning-lnk4092.md +++ b/docs/error-messages/tool-errors/linker-tools-warning-lnk4092.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Linker Tools Warning LNK4092" title: "Linker Tools Warning LNK4092" -ms.date: "11/04/2016" +description: "Learn more about: Linker Tools Warning LNK4092" +ms.date: 11/04/2016 f1_keywords: ["LNK4092"] helpviewer_keywords: ["LNK4092"] -ms.assetid: d569ec47-a338-40e1-940b-8a8061459acb --- # Linker Tools Warning LNK4092 -shared writable section 'section' contains relocations; image may not run correctly +> shared writable section 'section' contains relocations; image may not run correctly + +## Remarks The linker emits this warning whenever you have a shared section to warn you of a potentially serious problem. diff --git a/docs/error-messages/tool-errors/linker-tools-warning-lnk4096.md b/docs/error-messages/tool-errors/linker-tools-warning-lnk4096.md index 51afe7b4cf2..239b7d127b1 100644 --- a/docs/error-messages/tool-errors/linker-tools-warning-lnk4096.md +++ b/docs/error-messages/tool-errors/linker-tools-warning-lnk4096.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Linker Tools Warning LNK4096" title: "Linker Tools Warning LNK4096" -ms.date: "11/04/2016" +description: "Learn more about: Linker Tools Warning LNK4096" +ms.date: 11/04/2016 f1_keywords: ["LNK4096"] helpviewer_keywords: ["LNK4096"] -ms.assetid: ef6fba38-59a1-4d86-bcac-cadf44d87a36 --- # Linker Tools Warning LNK4096 -/BASE value "number" is invalid for Windows 95 and Windows 98; image may not run +> /BASE value "number" is invalid for Windows 95 and Windows 98; image may not run + +## Remarks The base address you specified is invalid. Windows 95 and Windows 98 executable files must have a base address greater than 0x400000. For more information on base addresses, see the [/BASE](../../build/reference/base-base-address.md) linker option. diff --git a/docs/error-messages/tool-errors/linker-tools-warning-lnk4098.md b/docs/error-messages/tool-errors/linker-tools-warning-lnk4098.md index 114be4256bc..d978b129442 100644 --- a/docs/error-messages/tool-errors/linker-tools-warning-lnk4098.md +++ b/docs/error-messages/tool-errors/linker-tools-warning-lnk4098.md @@ -1,15 +1,16 @@ --- title: "Linker Tools Warning LNK4098" description: "Describes how incompatible libraries cause linker tools warning LNK4098, and how to use /NODEFAULTLIB to fix it." -ms.date: "12/02/2019" +ms.date: 12/02/2019 f1_keywords: ["LNK4098"] helpviewer_keywords: ["LNK4098"] -ms.assetid: 1f1b1408-1316-4e34-80f5-6a02f2db0ac1 --- # Linker Tools Warning LNK4098 > defaultlib '*library*' conflicts with use of other libs; use /NODEFAULTLIB:*library* +## Remarks + You're trying to link with incompatible libraries. > [!NOTE] diff --git a/docs/error-messages/tool-errors/linker-tools-warning-lnk4099.md b/docs/error-messages/tool-errors/linker-tools-warning-lnk4099.md index 1883d934dfa..658a4303a78 100644 --- a/docs/error-messages/tool-errors/linker-tools-warning-lnk4099.md +++ b/docs/error-messages/tool-errors/linker-tools-warning-lnk4099.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Linker Tools Warning LNK4099" title: "Linker Tools Warning LNK4099" -ms.date: "11/04/2016" +description: "Learn more about: Linker Tools Warning LNK4099" +ms.date: 11/04/2016 f1_keywords: ["LNK4099"] helpviewer_keywords: ["LNK4099"] -ms.assetid: 358170a4-07cd-43fe-918f-82c32757ffc5 --- # Linker Tools Warning LNK4099 -PDB 'filename' was not found with 'object/library' or at 'path'; linking object as if no debug info +> PDB 'filename' was not found with 'object/library' or at 'path'; linking object as if no debug info + +## Remarks The linker was unable to find your .pdb file. Copy it into the directory that contains `object/library`. diff --git a/docs/error-messages/tool-errors/linker-tools-warning-lnk4102.md b/docs/error-messages/tool-errors/linker-tools-warning-lnk4102.md index 126e92d5743..946bbf5a630 100644 --- a/docs/error-messages/tool-errors/linker-tools-warning-lnk4102.md +++ b/docs/error-messages/tool-errors/linker-tools-warning-lnk4102.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Linker Tools Warning LNK4102" title: "Linker Tools Warning LNK4102" -ms.date: "11/04/2016" +description: "Learn more about: Linker Tools Warning LNK4102" +ms.date: 11/04/2016 f1_keywords: ["LNK4102"] helpviewer_keywords: ["LNK4102"] -ms.assetid: bfd1b17e-05c7-4bc2-80d6-2888b1a425b2 --- # Linker Tools Warning LNK4102 -export of deleting destructor 'name'; image may not run correctly +> export of deleting destructor 'name'; image may not run correctly + +## Remarks The program has attempted to export a deleting destructor. The resulting delete may occur across a DLL boundary such that a process can free memory that it does not own. Make sure that the given symbol is not listed in your .def file, and that the symbol is not listed as an argument of the **/IMPORT** or **/EXPORT** option in the linker command line. diff --git a/docs/error-messages/tool-errors/linker-tools-warning-lnk4104.md b/docs/error-messages/tool-errors/linker-tools-warning-lnk4104.md index 3b3226b097e..f606c690933 100644 --- a/docs/error-messages/tool-errors/linker-tools-warning-lnk4104.md +++ b/docs/error-messages/tool-errors/linker-tools-warning-lnk4104.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Linker Tools Warning LNK4104" title: "Linker Tools Warning LNK4104" -ms.date: "11/04/2016" +description: "Learn more about: Linker Tools Warning LNK4104" +ms.date: 11/04/2016 f1_keywords: ["LNK4104"] helpviewer_keywords: ["LNK4104"] -ms.assetid: ca6728db-d616-419a-a570-65e8445c6079 --- # Linker Tools Warning LNK4104 -export of symbol 'symbol' should be PRIVATE +> export of symbol 'symbol' should be PRIVATE + +## Remarks The `symbol` can be one of the following: diff --git a/docs/error-messages/tool-errors/linker-tools-warning-lnk4105.md b/docs/error-messages/tool-errors/linker-tools-warning-lnk4105.md index eb82ea21e7c..aebda983258 100644 --- a/docs/error-messages/tool-errors/linker-tools-warning-lnk4105.md +++ b/docs/error-messages/tool-errors/linker-tools-warning-lnk4105.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Linker Tools Warning LNK4105" title: "Linker Tools Warning LNK4105" -ms.date: "11/04/2016" +description: "Learn more about: Linker Tools Warning LNK4105" +ms.date: 11/04/2016 f1_keywords: ["LNK4105"] helpviewer_keywords: ["LNK4105"] -ms.assetid: 6c7bebf4-4ea6-4533-a6ed-e563d43abbd7 --- # Linker Tools Warning LNK4105 -no argument specified with option 'option'; ignoring option +> no argument specified with option 'option'; ignoring option + +## Remarks This warning occurs only when the [/LIBPATH](../../build/reference/libpath-additional-libpath.md) option is set. If no directory is specified with this option, then the linker ignores the option and generates this warning message. @@ -16,7 +17,7 @@ If you do not need to override the existing environmental library settings, remo ## Example -``` +```cmd link /libpath:c:\filepath\lib bar.obj ``` diff --git a/docs/error-messages/tool-errors/linker-tools-warning-lnk4194.md b/docs/error-messages/tool-errors/linker-tools-warning-lnk4194.md index f22bd2a4fc2..c9c5896215b 100644 --- a/docs/error-messages/tool-errors/linker-tools-warning-lnk4194.md +++ b/docs/error-messages/tool-errors/linker-tools-warning-lnk4194.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Linker Tools Warning LNK4194" title: "Linker Tools Warning LNK4194" -ms.date: "11/04/2016" +description: "Learn more about: Linker Tools Warning LNK4194" +ms.date: 11/04/2016 f1_keywords: ["LNK4194"] helpviewer_keywords: ["LNK4194"] -ms.assetid: a45f437e-33b5-487e-b3cd-ff1560041e7e --- # Linker Tools Warning LNK4194 -/DELAYLOAD:dll name ignored +> /DELAYLOAD:dll name ignored + +## Remarks The linker cannot [delay load](../../build/reference/delayload-delay-load-import.md) the requested DLL. diff --git a/docs/error-messages/tool-errors/linker-tools-warning-lnk4197.md b/docs/error-messages/tool-errors/linker-tools-warning-lnk4197.md index 2bddca715ac..9bbeb584794 100644 --- a/docs/error-messages/tool-errors/linker-tools-warning-lnk4197.md +++ b/docs/error-messages/tool-errors/linker-tools-warning-lnk4197.md @@ -1,15 +1,16 @@ --- -description: "Learn more about: Linker Tools Warning LNK4197" title: "Linker Tools Warning LNK4197" -ms.date: "09/05/2018" +description: "Learn more about: Linker Tools Warning LNK4197" +ms.date: 09/05/2018 f1_keywords: ["LNK4197"] helpviewer_keywords: ["LNK4197"] -ms.assetid: 8a976fd7-a74b-4c83-ab66-a9e7d7073c4a --- # Linker Tools Warning LNK4197 > export '*exportname*' specified multiple times; using first specification +## Remarks + An export is specified in multiple and different ways. The linker uses the first specification and ignores the rest. If you are rebuilding the C run-time library, you can ignore this message. diff --git a/docs/error-messages/tool-errors/linker-tools-warning-lnk4199.md b/docs/error-messages/tool-errors/linker-tools-warning-lnk4199.md index 04a8983c778..e4656fa2516 100644 --- a/docs/error-messages/tool-errors/linker-tools-warning-lnk4199.md +++ b/docs/error-messages/tool-errors/linker-tools-warning-lnk4199.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Linker Tools Warning LNK4199" title: "Linker Tools Warning LNK4199" -ms.date: "11/04/2016" +description: "Learn more about: Linker Tools Warning LNK4199" +ms.date: 11/04/2016 f1_keywords: ["LNK4199"] helpviewer_keywords: ["LNK4199"] -ms.assetid: 724f1ca8-ee9a-4ca3-b5c6-c0284a5195e7 --- # Linker Tools Warning LNK4199 -/DELAYLOAD:dllname ignored; no imports found from dllname +> /DELAYLOAD:dllname ignored; no imports found from dllname + +## Remarks The linker ignores `dllname` because it does not need any of the functions that `dllname` exports. diff --git a/docs/error-messages/tool-errors/linker-tools-warning-lnk4200.md b/docs/error-messages/tool-errors/linker-tools-warning-lnk4200.md index 558e5ec0f5e..d9c40abaeb2 100644 --- a/docs/error-messages/tool-errors/linker-tools-warning-lnk4200.md +++ b/docs/error-messages/tool-errors/linker-tools-warning-lnk4200.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Linker Tools Warning LNK4200" title: "Linker Tools Warning LNK4200" -ms.date: "11/04/2016" +description: "Learn more about: Linker Tools Warning LNK4200" +ms.date: 11/04/2016 f1_keywords: ["LNK4200"] helpviewer_keywords: ["LNK4200"] -ms.assetid: 0d335e69-8766-455b-beb5-a3ba6247274e --- # Linker Tools Warning LNK4200 -corrupt line number information in object file; ignored +> corrupt line number information in object file; ignored + +## Remarks The line number information in the object file is corrupt. Rebuild. diff --git a/docs/error-messages/tool-errors/linker-tools-warning-lnk4204.md b/docs/error-messages/tool-errors/linker-tools-warning-lnk4204.md index f9949c94b46..96f393a24fa 100644 --- a/docs/error-messages/tool-errors/linker-tools-warning-lnk4204.md +++ b/docs/error-messages/tool-errors/linker-tools-warning-lnk4204.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Linker Tools Warning LNK4204" title: "Linker Tools Warning LNK4204" -ms.date: "11/04/2016" +description: "Learn more about: Linker Tools Warning LNK4204" +ms.date: 11/04/2016 f1_keywords: ["LNK4204"] helpviewer_keywords: ["LNK4204"] -ms.assetid: 14adda20-0cbe-407b-90f6-9f81c93530e2 --- # Linker Tools Warning LNK4204 -'filename' is missing debugging information for referencing module; linking object as if no debug info +> 'filename' is missing debugging information for referencing module; linking object as if no debug info + +## Remarks The .pdb file has an erroneous signature. The linker will continue to link the object without debug information. You may want to recompile the object file using the [/Zi](../../build/reference/z7-zi-zi-debug-information-format.md) option. diff --git a/docs/error-messages/tool-errors/linker-tools-warning-lnk4205.md b/docs/error-messages/tool-errors/linker-tools-warning-lnk4205.md index 6f77534f6fc..f693330b8d4 100644 --- a/docs/error-messages/tool-errors/linker-tools-warning-lnk4205.md +++ b/docs/error-messages/tool-errors/linker-tools-warning-lnk4205.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Linker Tools Warning LNK4205" title: "Linker Tools Warning LNK4205" -ms.date: "11/04/2016" +description: "Learn more about: Linker Tools Warning LNK4205" +ms.date: 11/04/2016 f1_keywords: ["LNK4205"] helpviewer_keywords: ["LNK4205"] -ms.assetid: d63b9d18-ef3c-4081-9d8d-93077dad13c2 --- # Linker Tools Warning LNK4205 -'filename' is missing current debugging information for referencing module; linking object as if no debug info +> 'filename' is missing current debugging information for referencing module; linking object as if no debug info + +## Remarks The .pdb file has out-of-date information. The linker will continue to link object without debug information. You may want to recompile the object file using the [/Zi](../../build/reference/z7-zi-zi-debug-information-format.md) option. diff --git a/docs/error-messages/tool-errors/linker-tools-warning-lnk4206.md b/docs/error-messages/tool-errors/linker-tools-warning-lnk4206.md index 6d954982e46..61b490f8294 100644 --- a/docs/error-messages/tool-errors/linker-tools-warning-lnk4206.md +++ b/docs/error-messages/tool-errors/linker-tools-warning-lnk4206.md @@ -1,15 +1,16 @@ --- -description: "Learn more about: Linker Tools Warning LNK4206" title: "Linker Tools Warning LNK4206" -ms.date: "12/05/2017" +description: "Learn more about: Linker Tools Warning LNK4206" +ms.date: 12/05/2017 f1_keywords: ["LNK4206"] helpviewer_keywords: ["LNK4206"] -ms.assetid: 6c108e33-00cf-4c5a-830d-d65d470930a7 --- # Linker Tools Warning LNK4206 > precompiled type information not found; '*filename*' not linked or overwritten; linking object as if no debug info +## Remarks + The *filename* object file, compiled by using [/Yc](../../build/reference/yc-create-precompiled-header-file.md), was either not specified in the LINK command or was overwritten. A common scenario for this warning is when the .obj that was compiled with /Yc is in a library, and where there are no symbol references to that .obj from your code. In that case, the linker will not use (or even see) the .obj file. In this situation, you should recompile your code and use [/Yl](../../build/reference/yl-inject-pch-reference-for-debug-library.md) for the objects compiled by using [/Yu](../../build/reference/yu-use-precompiled-header-file.md). diff --git a/docs/error-messages/tool-errors/linker-tools-warning-lnk4210.md b/docs/error-messages/tool-errors/linker-tools-warning-lnk4210.md index 437489e9ad0..56405b00d56 100644 --- a/docs/error-messages/tool-errors/linker-tools-warning-lnk4210.md +++ b/docs/error-messages/tool-errors/linker-tools-warning-lnk4210.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Linker Tools Warning LNK4210" title: "Linker Tools Warning LNK4210" -ms.date: "11/04/2016" +description: "Learn more about: Linker Tools Warning LNK4210" +ms.date: 11/04/2016 f1_keywords: ["LNK4210"] helpviewer_keywords: ["LNK4210"] -ms.assetid: db48cff8-a2be-4a77-8d03-552b42c228fa --- # Linker Tools Warning LNK4210 diff --git a/docs/error-messages/tool-errors/linker-tools-warning-lnk4216.md b/docs/error-messages/tool-errors/linker-tools-warning-lnk4216.md index 167ab652430..4b1dddb3f23 100644 --- a/docs/error-messages/tool-errors/linker-tools-warning-lnk4216.md +++ b/docs/error-messages/tool-errors/linker-tools-warning-lnk4216.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Linker Tools Warning LNK4216" title: "Linker Tools Warning LNK4216" -ms.date: "11/04/2016" +description: "Learn more about: Linker Tools Warning LNK4216" +ms.date: 11/04/2016 f1_keywords: ["LNK4216"] helpviewer_keywords: ["LNK4216"] -ms.assetid: 68512095-acbc-47aa-96bf-9eb0e73b24a3 --- # Linker Tools Warning LNK4216 -Exported entry point entry +> Exported entry point entry + +## Remarks An entry point was exported from a DLL. The entry point of a DLL does not need to be exported. diff --git a/docs/error-messages/tool-errors/linker-tools-warning-lnk4217.md b/docs/error-messages/tool-errors/linker-tools-warning-lnk4217.md index 94497411316..b1dfa793fb4 100644 --- a/docs/error-messages/tool-errors/linker-tools-warning-lnk4217.md +++ b/docs/error-messages/tool-errors/linker-tools-warning-lnk4217.md @@ -1,23 +1,24 @@ --- -description: "Learn more about: Linker Tools Warning LNK4217" title: "Linker Tools Warning LNK4217" -ms.date: "07/23/2019" +description: "Learn more about: Linker Tools Warning LNK4217" +ms.date: 07/23/2019 f1_keywords: ["LNK4217"] helpviewer_keywords: ["LNK4217"] -ms.assetid: 280dc03e-5933-4e8d-bb8c-891fbe788738 --- # Linker Tools Warning LNK4217 > symbol '*symbol*' defined in '*filename_1.obj*' is imported by '*filename_2.obj*' in function '*function*' -[__declspec(dllimport)](../../cpp/dllexport-dllimport.md) was specified for a symbol even though the symbol is defined in an object file in the same image. Remove the `__declspec(dllimport)` modifier to resolve this warning. - ## Remarks +[__declspec(dllimport)](../../cpp/dllexport-dllimport.md) was specified for a symbol even though the symbol is defined in an object file in the same image. Remove the `__declspec(dllimport)` modifier to resolve this warning. + *symbol* is the symbol name that's defined within the image. *function* is the function that's importing the symbol. This warning doesn't appear when you compile by using the [/clr](../../build/reference/clr-common-language-runtime-compilation.md) option. +## Example + LNK4217 can also occur if you attempt to link two modules together, when instead you should compile the second module with the import library of the first module. ```cpp diff --git a/docs/error-messages/tool-errors/linker-tools-warning-lnk4219.md b/docs/error-messages/tool-errors/linker-tools-warning-lnk4219.md index ca1f30a8c38..1088a47bd68 100644 --- a/docs/error-messages/tool-errors/linker-tools-warning-lnk4219.md +++ b/docs/error-messages/tool-errors/linker-tools-warning-lnk4219.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Linker Tools Warning LNK4219" title: "Linker Tools Warning LNK4219" -ms.date: "11/04/2016" +description: "Learn more about: Linker Tools Warning LNK4219" +ms.date: 11/04/2016 f1_keywords: ["LNK4219"] helpviewer_keywords: ["LNK4219"] -ms.assetid: 363fedf4-b10c-4985-811a-55a9fba688d6 --- # Linker Tools Warning LNK4219 -fixup name fixup overflow. Target 'target symbol name' is out of range, inserting thunk +> fixup name fixup overflow. Target 'target symbol name' is out of range, inserting thunk + +## Remarks The linker inserted a thunk in a situation where the address or offset was unable to fit in the given instruction because the target symbol is too far away from the instruction's location. diff --git a/docs/error-messages/tool-errors/linker-tools-warning-lnk4220.md b/docs/error-messages/tool-errors/linker-tools-warning-lnk4220.md index 3bd2a43b6ec..11b83b45f5e 100644 --- a/docs/error-messages/tool-errors/linker-tools-warning-lnk4220.md +++ b/docs/error-messages/tool-errors/linker-tools-warning-lnk4220.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Linker Tools Warning LNK4220" title: "Linker Tools Warning LNK4220" -ms.date: "11/04/2016" +description: "Learn more about: Linker Tools Warning LNK4220" +ms.date: 11/04/2016 f1_keywords: ["LNK4220"] helpviewer_keywords: ["LNK4220"] -ms.assetid: ba0cddfc-9c56-4a09-8207-f7b840a24b4d --- # Linker Tools Warning LNK4220 -invalid 'linker option' value 'value'; assumed default +> invalid 'linker option' value 'value'; assumed default + +## Remarks An out-of-range value was specified with the [/TLBID](../../build/reference/tlbid-specify-resource-id-for-typelib.md) option. The default value for **/TLBID** is 1. diff --git a/docs/error-messages/tool-errors/linker-tools-warning-lnk4221.md b/docs/error-messages/tool-errors/linker-tools-warning-lnk4221.md index 9fae0c56fd9..e137bfa2f46 100644 --- a/docs/error-messages/tool-errors/linker-tools-warning-lnk4221.md +++ b/docs/error-messages/tool-errors/linker-tools-warning-lnk4221.md @@ -1,15 +1,16 @@ --- -description: "Learn more about: Linker Tools Warning LNK4221" title: "Linker Tools Warning LNK4221" +description: "Learn more about: Linker Tools Warning LNK4221" ms.date: 06/29/2022 f1_keywords: ["LNK4221"] helpviewer_keywords: ["LNK4221"] -ms.assetid: 8e2eb2de-9532-4b85-908a-8c9ff5c4cccb --- # Linker Tools Warning LNK4221 > This object file does not define any previously undefined public symbols, so it will not be used by any link operation that consumes this library +## Example + Consider the following two code snippets, `a.cpp`: ```cpp diff --git a/docs/error-messages/tool-errors/linker-tools-warning-lnk4222.md b/docs/error-messages/tool-errors/linker-tools-warning-lnk4222.md index e55acea5515..3f20f3c7ae0 100644 --- a/docs/error-messages/tool-errors/linker-tools-warning-lnk4222.md +++ b/docs/error-messages/tool-errors/linker-tools-warning-lnk4222.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Linker Tools Warning LNK4222" title: "Linker Tools Warning LNK4222" -ms.date: "11/04/2016" +description: "Learn more about: Linker Tools Warning LNK4222" +ms.date: 11/04/2016 f1_keywords: ["LNK4222"] helpviewer_keywords: ["LNK4222"] -ms.assetid: b7bb1794-41fb-4c83-b9b0-59c0d786a7da --- # Linker Tools Warning LNK4222 -exported symbol 'symbol' should not be assigned an ordinal +> exported symbol 'symbol' should not be assigned an ordinal + +## Remarks The following symbols should not be exported by ordinal: diff --git a/docs/error-messages/tool-errors/linker-tools-warning-lnk4224.md b/docs/error-messages/tool-errors/linker-tools-warning-lnk4224.md index 0c52b3130a7..a9794db869a 100644 --- a/docs/error-messages/tool-errors/linker-tools-warning-lnk4224.md +++ b/docs/error-messages/tool-errors/linker-tools-warning-lnk4224.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Linker Tools Warning LNK4224" title: "Linker Tools Warning LNK4224" -ms.date: "11/04/2016" +description: "Learn more about: Linker Tools Warning LNK4224" +ms.date: 11/04/2016 f1_keywords: ["LNK4224"] helpviewer_keywords: ["LNK4224"] -ms.assetid: 8624b70e-0b93-43cf-b457-834d38632d0b --- # Linker Tools Warning LNK4224 @@ -20,7 +19,7 @@ If possible, modify the source for the .obj and remove the pragma. If you do ign ## Example -The following sample generates LNK4224. +The following example generates LNK4224. ```cpp // LNK4224.cpp diff --git a/docs/error-messages/tool-errors/linker-tools-warning-lnk4227.md b/docs/error-messages/tool-errors/linker-tools-warning-lnk4227.md index 4437621ee75..6cab69aeb42 100644 --- a/docs/error-messages/tool-errors/linker-tools-warning-lnk4227.md +++ b/docs/error-messages/tool-errors/linker-tools-warning-lnk4227.md @@ -1,15 +1,16 @@ --- -description: "Learn more about: Linker Tools Warning LNK4227" title: "Linker Tools Warning LNK4227" -ms.date: "11/04/2016" +description: "Learn more about: Linker Tools Warning LNK4227" +ms.date: 11/04/2016 f1_keywords: ["LNK4227"] helpviewer_keywords: ["LNK4227"] -ms.assetid: 941a0414-9964-4e02-8487-f9daa42ef7f9 --- # Linker Tools Warning LNK4227 > metadata operation warning (*HRESULT*) : *warning_message* +## Remarks + The linker detected metadata differences when merging: - One or more referenced assemblies with the assembly currently being built. @@ -26,7 +27,7 @@ The metadata problems must be fixed to resolve the warning. LNK4227 is generated when a referenced assembly was signed differently than the assembly that references it. -The following sample generates LNK4227: +The following example generates LNK4227: ```cpp // LNK4227.cpp @@ -57,7 +58,7 @@ ref class MyClass LNK4227 can also be generated when version numbers in the wrong format are passed to assembly attributes. The '*' notation is specific to the `AssemblyVersionAttribute`. To resolve this warning, use only numbers in the version attributes other than `AssemblyVersionAttribute`. -The following sample generates LNK4227: +The following example generates LNK4227: ```cpp // LNK4227e.cpp diff --git a/docs/error-messages/tool-errors/linker-tools-warning-lnk4229.md b/docs/error-messages/tool-errors/linker-tools-warning-lnk4229.md index 1000e70de37..7452fa173e5 100644 --- a/docs/error-messages/tool-errors/linker-tools-warning-lnk4229.md +++ b/docs/error-messages/tool-errors/linker-tools-warning-lnk4229.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Linker Tools Warning LNK4229" title: "Linker Tools Warning LNK4229" -ms.date: "11/04/2016" +description: "Learn more about: Linker Tools Warning LNK4229" +ms.date: 11/04/2016 f1_keywords: ["LNK4229"] helpviewer_keywords: ["LNK4229"] -ms.assetid: 00e70d09-efd8-4e4e-8d48-6ba282c32ec1 --- # Linker Tools Warning LNK4229 -invalid directive /directive found; ignored +> invalid directive /directive found; ignored + +## Remarks A directive passed via the [comment](../../preprocessor/comment-c-cpp.md) pragma was not valid. The linker ignores `/directive`. diff --git a/docs/error-messages/tool-errors/linker-tools-warning-lnk4237.md b/docs/error-messages/tool-errors/linker-tools-warning-lnk4237.md index 412f1348d52..3cc9490ee77 100644 --- a/docs/error-messages/tool-errors/linker-tools-warning-lnk4237.md +++ b/docs/error-messages/tool-errors/linker-tools-warning-lnk4237.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Linker Tools Warning LNK4237" title: "Linker Tools Warning LNK4237" -ms.date: "11/04/2016" +description: "Learn more about: Linker Tools Warning LNK4237" +ms.date: 11/04/2016 f1_keywords: ["LNK4237"] helpviewer_keywords: ["LNK4237"] -ms.assetid: 87bfec39-5241-464f-9feb-517b49f352ea --- # Linker Tools Warning LNK4237 -/SUBSYSTEM:NATIVE specified when importing from 'dll'; Use /SUBSYSTEM:CONSOLE or /SUBSYSTEM:WINDOWS. +> /SUBSYSTEM:NATIVE specified when importing from 'dll'; Use /SUBSYSTEM:CONSOLE or /SUBSYSTEM:WINDOWS. + +## Remarks [/SUBSYSTEM:NATIVE](../../build/reference/subsystem-specify-subsystem.md) was specified when building a windows (Win32) application that directly uses one or more of the following: diff --git a/docs/error-messages/tool-errors/linker-tools-warning-lnk4247.md b/docs/error-messages/tool-errors/linker-tools-warning-lnk4247.md index f0f4ec5f2ce..c72d8eb71d3 100644 --- a/docs/error-messages/tool-errors/linker-tools-warning-lnk4247.md +++ b/docs/error-messages/tool-errors/linker-tools-warning-lnk4247.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Linker Tools Warning LNK4247" title: "Linker Tools Warning LNK4247" -ms.date: "11/04/2016" +description: "Learn more about: Linker Tools Warning LNK4247" +ms.date: 11/04/2016 f1_keywords: ["LNK4247"] helpviewer_keywords: ["LNK4247"] -ms.assetid: 085d7fdf-9eaf-4641-8473-6eaadd073c7b --- # Linker Tools Warning LNK4247 -entry point 'decorated_function_name' already has a thread attribute; 'attribute' ignored +> entry point 'decorated_function_name' already has a thread attribute; 'attribute' ignored + +## Remarks An entry point, specified with [/ENTRY (Entry-Point Symbol)](../../build/reference/entry-entry-point-symbol.md), had a threading attribute, but [/CLRTHREADATTRIBUTE (Set CLR Thread Attribute)](../../build/reference/clrthreadattribute-set-clr-thread-attribute.md) was also specified, with a different threading model. @@ -26,7 +27,9 @@ To resolve this warning: - Change the attribute in source, such that, it agrees with the value passed to /CLRTHREADATTRIBUTE. -The following sample generates LNK4247 +## Example + +The following example generates LNK4247 ```cpp // LNK4247.cpp diff --git a/docs/error-messages/tool-errors/linker-tools-warning-lnk4248.md b/docs/error-messages/tool-errors/linker-tools-warning-lnk4248.md index 17b02f0c4fd..6cf871ff31f 100644 --- a/docs/error-messages/tool-errors/linker-tools-warning-lnk4248.md +++ b/docs/error-messages/tool-errors/linker-tools-warning-lnk4248.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Linker Tools Warning LNK4248" title: "Linker Tools Warning LNK4248" -ms.date: "11/04/2016" +description: "Learn more about: Linker Tools Warning LNK4248" +ms.date: 11/04/2016 f1_keywords: ["LNK4248"] helpviewer_keywords: ["LNK4248"] -ms.assetid: e40523ff-e3cb-4ba6-ab79-23f0f339f6cf --- # Linker Tools Warning LNK4248 -unresolved typeref token (token) for 'type'; image may not run +> unresolved typeref token (token) for 'type'; image may not run + +## Remarks A type doesn't have a definition in MSIL metadata. @@ -26,7 +27,7 @@ For more information, see [/clr (Common Language Runtime Compilation)](../../bui ## Examples -The following sample generates LNK4248. Define struct A to resolve. +The following example generates LNK4248. Define struct A to resolve. ```cpp // LNK4248.cpp @@ -40,7 +41,7 @@ int main() { } ``` -The following sample has a forward definition of a type. +The following example has a forward definition of a type. ```cpp // LNK4248_2.cpp @@ -55,7 +56,7 @@ int main() { } ``` -The following sample generates LNK4248. +The following example generates LNK4248. ```cpp // LNK4248_3.cpp diff --git a/docs/error-messages/tool-errors/linker-tools-warning-lnk4253.md b/docs/error-messages/tool-errors/linker-tools-warning-lnk4253.md index 38406cb0aca..5ccccd7822f 100644 --- a/docs/error-messages/tool-errors/linker-tools-warning-lnk4253.md +++ b/docs/error-messages/tool-errors/linker-tools-warning-lnk4253.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Linker Tools Warning LNK4253" title: "Linker Tools Warning LNK4253" -ms.date: "11/04/2016" +description: "Learn more about: Linker Tools Warning LNK4253" +ms.date: 11/04/2016 f1_keywords: ["LNK4253"] helpviewer_keywords: ["LNK4253"] -ms.assetid: ec7433a9-aa9c-495a-a9f2-075e7bc3e7bc --- # Linker Tools Warning LNK4253 -section 'section1' not merged into 'section2'; already merged into 'section3' +> section 'section1' not merged into 'section2'; already merged into 'section3' + +## Remarks The linker detected multiple, conflicting merge requests. The linker will ignore one of the requests. @@ -26,7 +27,7 @@ For more information, see, ## Example -In the following sample, the linker is instructed to merge the `.rdata` section twice, but into different sections. The following sample generates LNK4253. +In the following example, the linker is instructed to merge the `.rdata` section twice, but into different sections. The following example generates LNK4253. ```cpp // LNK4253.cpp diff --git a/docs/error-messages/tool-errors/linker-tools-warning-lnk4254.md b/docs/error-messages/tool-errors/linker-tools-warning-lnk4254.md index cad2b204d0a..a43282f7879 100644 --- a/docs/error-messages/tool-errors/linker-tools-warning-lnk4254.md +++ b/docs/error-messages/tool-errors/linker-tools-warning-lnk4254.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Linker Tools Warning LNK4254" title: "Linker Tools Warning LNK4254" -ms.date: "11/04/2016" +description: "Learn more about: Linker Tools Warning LNK4254" +ms.date: 11/04/2016 f1_keywords: ["LNK4254"] helpviewer_keywords: ["LNK4254"] -ms.assetid: 6f41dfb3-ca21-40d3-bac7-b637e578efa4 --- # Linker Tools Warning LNK4254 -section 'section1' (offset) merged into 'section2' (offset) with different attributes +> section 'section1' (offset) merged into 'section2' (offset) with different attributes + +## Remarks The contents of one section were merged into another, but the attributes of the two sections are different. Your program may give unexpected results. For example, data you wanted to be read only may now be in a writable section. @@ -24,7 +25,7 @@ For more information, see, ## Example -The following sample generates LNK4254. +The following example generates LNK4254. ```cpp // LNK4254.cpp diff --git a/docs/error-messages/tool-errors/linker-tools-warning-lnk4286.md b/docs/error-messages/tool-errors/linker-tools-warning-lnk4286.md index 7ba15860964..41cd2a2ed46 100644 --- a/docs/error-messages/tool-errors/linker-tools-warning-lnk4286.md +++ b/docs/error-messages/tool-errors/linker-tools-warning-lnk4286.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: Linker Tools Warning LNK4286" title: "Linker Tools Warning LNK4286" -ms.date: "04/15/2019" +description: "Learn more about: Linker Tools Warning LNK4286" +ms.date: 04/15/2019 f1_keywords: ["LNK4286"] helpviewer_keywords: ["LNK4286"] --- @@ -9,10 +9,10 @@ helpviewer_keywords: ["LNK4286"] > symbol '*symbol*' defined in '*filename_1.obj*' is imported by '*filename_2.obj*' -[__declspec(dllimport)](../../cpp/dllexport-dllimport.md) was specified for *symbol* even though the symbol is defined in object file *filename_1.obj* in the same image. Remove the `__declspec(dllimport)` modifier to resolve this warning. - ## Remarks +[__declspec(dllimport)](../../cpp/dllexport-dllimport.md) was specified for *symbol* even though the symbol is defined in object file *filename_1.obj* in the same image. Remove the `__declspec(dllimport)` modifier to resolve this warning. + Warning LNK4286 is a more general version of [Linker Tools Warning LNK4217](linker-tools-warning-lnk4217.md). The linker generates Warning LNK4286 when it can tell which object file referenced the symbol, but not which function. To resolve LNK4286, remove the `__declspec(dllimport)` declaration modifier from the forward declaration of *symbol* referenced in *filename_2.obj*. diff --git a/docs/error-messages/tool-errors/linker-tools-warning-lnk4306.md b/docs/error-messages/tool-errors/linker-tools-warning-lnk4306.md index 585f5078112..399ff2c7d4c 100644 --- a/docs/error-messages/tool-errors/linker-tools-warning-lnk4306.md +++ b/docs/error-messages/tool-errors/linker-tools-warning-lnk4306.md @@ -1,6 +1,6 @@ --- -description: "Learn more about: Linker tools warning LNK4306" title: "Linker tools warning LNK4306" +description: "Learn more about: Linker tools warning LNK4306" ms.date: 01/30/2024 f1_keywords: ["LNK4306"] helpviewer_keywords: ["LNK4306"] @@ -9,6 +9,8 @@ helpviewer_keywords: ["LNK4306"] > The auxiliary delayload import address table is not properly aligned with the primary delayload import address table. This may have negative perf impact. +## Remarks + This warning indicates a problem has occurred within the linker. Please report the issue and how you ran into it in the [C++ Developer Community channel](https://developercommunity.visualstudio.com/cpp). Add the tag `ARM64EC` to your issue to help us find the issue. \ No newline at end of file diff --git a/docs/error-messages/tool-errors/linker-tools-warning-lnk4307.md b/docs/error-messages/tool-errors/linker-tools-warning-lnk4307.md index 97bf46196a6..3c9e72ff11c 100644 --- a/docs/error-messages/tool-errors/linker-tools-warning-lnk4307.md +++ b/docs/error-messages/tool-errors/linker-tools-warning-lnk4307.md @@ -1,6 +1,6 @@ --- -description: "Learn more about: Linker Tools warning LNK4307" title: "Linker Tools warning LNK4307" +description: "Learn more about: Linker Tools warning LNK4307" ms.date: 01/30/2024 f1_keywords: ["LNK4307"] helpviewer_keywords: ["LNK4307"] @@ -9,6 +9,8 @@ helpviewer_keywords: ["LNK4307"] > The auxiliary delayload import address table copy is not properly aligned with the auxiliary delayload import address table. This may have negative perf impact. +## Remarks + This warning indicates a problem has occurred within the linker. Please report the issue and how you ran into it in the [C++ Developer Community channel](https://developercommunity.visualstudio.com/cpp). Add the tag `ARM64EC` to your issue to help us find the issue. \ No newline at end of file diff --git a/docs/error-messages/tool-errors/math-error-m6101.md b/docs/error-messages/tool-errors/math-error-m6101.md index 2a134c383a9..97393e3598c 100644 --- a/docs/error-messages/tool-errors/math-error-m6101.md +++ b/docs/error-messages/tool-errors/math-error-m6101.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Math Error M6101" title: "Math Error M6101" -ms.date: "11/04/2016" +description: "Learn more about: Math Error M6101" +ms.date: 11/04/2016 f1_keywords: ["M6101"] helpviewer_keywords: ["M6101"] -ms.assetid: 8c8d5097-d725-4a2c-92e9-fcf28c871d74 --- # Math Error M6101 -invalid +> invalid + +## Remarks Invalid operation. diff --git a/docs/error-messages/tool-errors/math-error-m6102.md b/docs/error-messages/tool-errors/math-error-m6102.md index 0500853cac0..d9503b18f96 100644 --- a/docs/error-messages/tool-errors/math-error-m6102.md +++ b/docs/error-messages/tool-errors/math-error-m6102.md @@ -1,15 +1,16 @@ --- -description: "Learn more about: Math Error M6102" title: "Math Error M6102" -ms.date: "11/04/2016" +description: "Learn more about: Math Error M6102" +ms.date: 11/04/2016 f1_keywords: ["M6102"] helpviewer_keywords: ["M6102"] -ms.assetid: dbd2241f-6595-431e-9597-d9dbdb3a0ca2 --- # Math Error M6102 -denormal +> denormal + +## Remarks -An operation generated a very small floating-point number, which be invalid due loss of significance. Denormal floating-point exceptions are usually masked, causing them to be trapped and operated upon. +An operation generated a very small floating-point number, which may be invalid due to loss of significance. Denormal floating-point exceptions are usually masked, causing them to be trapped and operated upon. Program terminates with exit code 130. diff --git a/docs/error-messages/tool-errors/math-error-m6107.md b/docs/error-messages/tool-errors/math-error-m6107.md index bf01ca4d03e..96e69ec23ae 100644 --- a/docs/error-messages/tool-errors/math-error-m6107.md +++ b/docs/error-messages/tool-errors/math-error-m6107.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Math Error M6107" title: "Math Error M6107" -ms.date: "11/04/2016" +description: "Learn more about: Math Error M6107" +ms.date: 11/04/2016 f1_keywords: ["M6107"] helpviewer_keywords: ["M6107"] -ms.assetid: a827a2a4-40b7-4e28-8e8d-530c6ffcf0c9 --- # Math Error M6107 -unemulated +> unemulated + +## Remarks An attempt was made to execute a coprocessor instruction that is invalid or is not supported by the emulator. diff --git a/docs/error-messages/tool-errors/math-error-m6108.md b/docs/error-messages/tool-errors/math-error-m6108.md index 7155419b33d..c0fd950f914 100644 --- a/docs/error-messages/tool-errors/math-error-m6108.md +++ b/docs/error-messages/tool-errors/math-error-m6108.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Math Error M6108" title: "Math Error M6108" -ms.date: "11/04/2016" +description: "Learn more about: Math Error M6108" +ms.date: 11/04/2016 f1_keywords: ["M6108"] helpviewer_keywords: ["M6108"] -ms.assetid: 054893b4-49bc-45d9-882f-7cb50ba387c0 --- # Math Error M6108 -square root +> square root + +## Remarks The operand in a square-root operation was negative. diff --git a/docs/error-messages/tool-errors/math-error-m6110.md b/docs/error-messages/tool-errors/math-error-m6110.md index cbc7337ca7b..6d6b24e2d75 100644 --- a/docs/error-messages/tool-errors/math-error-m6110.md +++ b/docs/error-messages/tool-errors/math-error-m6110.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Math Error M6110" title: "Math Error M6110" -ms.date: "11/04/2016" +description: "Learn more about: Math Error M6110" +ms.date: 11/04/2016 f1_keywords: ["M6110"] helpviewer_keywords: ["M6110"] -ms.assetid: aac9ae37-6a6d-46e9-85d4-dfe03f1c3e11 --- # Math Error M6110 -stack overflow +> stack overflow + +## Remarks A floating-point expression caused a floating-point stack overflow. diff --git a/docs/error-messages/tool-errors/math-error-m6111.md b/docs/error-messages/tool-errors/math-error-m6111.md index 123e1601bee..a63eb57ba48 100644 --- a/docs/error-messages/tool-errors/math-error-m6111.md +++ b/docs/error-messages/tool-errors/math-error-m6111.md @@ -1,22 +1,27 @@ --- -description: "Learn more about: Math Error M6111" title: "Math Error M6111" -ms.date: "11/04/2016" +description: "Learn more about: Math Error M6111" +ms.date: 11/04/2016 f1_keywords: ["M6111"] helpviewer_keywords: ["M6111"] -ms.assetid: c0fc13f8-33c8-4e3f-a440-126cc623441b --- # Math Error M6111 -stack underflow +> stack underflow + +## Remarks A floating-point operation resulted in a stack underflow on the 8087/287/387 coprocessor or the emulator. -This error is often caused by a call to a **`long double`** function that does not return a value. For example, the following generates this error when compiled and run: +This error is often caused by a call to a **`long double`** function that does not return a value. -``` -long double ld() {}; -main () +## Example + +For example, the following generates this error when compiled and run: + +```c +long double ld() {} +int main () { ld(); } diff --git a/docs/error-messages/tool-errors/math-error-m6201.md b/docs/error-messages/tool-errors/math-error-m6201.md index 5bc92535e0e..02fe9b07f20 100644 --- a/docs/error-messages/tool-errors/math-error-m6201.md +++ b/docs/error-messages/tool-errors/math-error-m6201.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Math Error M6201" title: "Math Error M6201" -ms.date: "11/04/2016" +description: "Learn more about: Math Error M6201" +ms.date: 11/04/2016 f1_keywords: ["M6201"] helpviewer_keywords: ["M6201"] -ms.assetid: 4041c331-d9aa-4dd4-b565-7dbe0218538c --- # Math Error M6201 -'function' : _DOMAIN error +> 'function' : _DOMAIN error + +## Remarks An argument to the given function was outside the domain of legal input values for that function. diff --git a/docs/error-messages/tool-errors/math-error-m6202.md b/docs/error-messages/tool-errors/math-error-m6202.md index 1f9514fda1c..b26b2653ddc 100644 --- a/docs/error-messages/tool-errors/math-error-m6202.md +++ b/docs/error-messages/tool-errors/math-error-m6202.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Math Error M6202" title: "Math Error M6202" -ms.date: "11/04/2016" +description: "Learn more about: Math Error M6202" +ms.date: 11/04/2016 f1_keywords: ["M6202"] helpviewer_keywords: ["M6202"] -ms.assetid: 4d17045f-c6dc-4705-9512-e9af12c35fb4 --- # Math Error M6202 -'function' : _SING error +> 'function' : _SING error + +## Remarks An argument to the given function was a singularity value for this function. The function is not defined for that argument. diff --git a/docs/error-messages/tool-errors/math-error-m6203.md b/docs/error-messages/tool-errors/math-error-m6203.md index 7677ddc0174..d2d66863f38 100644 --- a/docs/error-messages/tool-errors/math-error-m6203.md +++ b/docs/error-messages/tool-errors/math-error-m6203.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Math Error M6203" title: "Math Error M6203" -ms.date: "11/04/2016" +description: "Learn more about: Math Error M6203" +ms.date: 11/04/2016 f1_keywords: ["M6203"] helpviewer_keywords: ["M6203"] -ms.assetid: bd7fdd1c-83e4-4d6a-901e-10a0308bf5be --- # Math Error M6203 -'function' : _OVERFLOW error +> 'function' : _OVERFLOW error + +## Remarks The given function result was too large to be represented. diff --git a/docs/error-messages/tool-errors/math-error-m6205.md b/docs/error-messages/tool-errors/math-error-m6205.md index a65999a49ef..2b92bda1950 100644 --- a/docs/error-messages/tool-errors/math-error-m6205.md +++ b/docs/error-messages/tool-errors/math-error-m6205.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Math Error M6205" title: "Math Error M6205" -ms.date: "11/04/2016" +description: "Learn more about: Math Error M6205" +ms.date: 11/04/2016 f1_keywords: ["M6205"] helpviewer_keywords: ["M6205"] -ms.assetid: fd28e7c9-a463-4a9c-a863-cc9e75315550 --- # Math Error M6205 -'function' : _TLOSS error +> 'function' : _TLOSS error + +## Remarks A total loss of significance (precision) occurred. diff --git a/docs/error-messages/tool-errors/math-errors-m6101-through-m6205.md b/docs/error-messages/tool-errors/math-errors-m6101-through-m6205.md index 5c934acfb5a..f376b2a389d 100644 --- a/docs/error-messages/tool-errors/math-errors-m6101-through-m6205.md +++ b/docs/error-messages/tool-errors/math-errors-m6101-through-m6205.md @@ -1,29 +1,30 @@ --- +title: "Math errors (M6101 through M6205)" description: "Learn more about: Math errors (Mxxxx)" -title: "Math errors" -ms.date: "04/16/2019" -ms.assetid: bdf3dc2a-d993-4f53-b0f2-9604e4914127 +ms.date: 04/16/2019 --- -# Math errors (Mxxxx) +# Math errors (M6101 through M6205) This section is a reference to the errors generated by the runtime floating-point math library. Math runtime errors and warnings have the form M*xxxx*, where *xxxx* is a four-digit number. -[!INCLUDE[error-boilerplate](../../error-messages/includes/error-boilerplate.md)] +[!INCLUDE[error-boilerplate](../includes/error-boilerplate.md)] ## Math errors -[Math error M6101](math-error-m6101.md) \ -[Math error M6102](math-error-m6102.md) \ -[Math error M6107](math-error-m6107.md) \ -[Math error M6108](math-error-m6108.md) \ -[Math error M6110](math-error-m6110.md) \ -[Math error M6111](math-error-m6111.md) \ -[Math error M6201](math-error-m6201.md) \ -[Math error M6202](math-error-m6202.md) \ -[Math error M6203](math-error-m6203.md) \ -[Math error M6205](math-error-m6205.md) +| Error | Message | +|--|--| +| [Math error M6101](math-error-m6101.md) | invalid | +| [Math error M6102](math-error-m6102.md) | denormal | +| [Math error M6107](math-error-m6107.md) | unemulated | +| [Math error M6108](math-error-m6108.md) | square root | +| [Math error M6110](math-error-m6110.md) | stack overflow | +| [Math error M6111](math-error-m6111.md) | stack underflow | +| [Math error M6201](math-error-m6201.md) | 'function' : _DOMAIN error | +| [Math error M6202](math-error-m6202.md) | 'function' : _SING error | +| [Math error M6203](math-error-m6203.md) | 'function' : _OVERFLOW error | +| [Math error M6205](math-error-m6205.md) | 'function' : _TLOSS error | ## See also -[C/C++ Compiler and build tools errors and warnings](../compiler-errors-1/c-cpp-build-errors.md) \ +[C/C++ Compiler and build tools errors and warnings](../compiler-errors-1/c-cpp-build-errors.md)\ [Math and floating-point support](../../c-runtime-library/floating-point-support.md) diff --git a/docs/error-messages/tool-errors/name-decoration.md b/docs/error-messages/tool-errors/name-decoration.md index b6f77174881..2a4b3e4f6cf 100644 --- a/docs/error-messages/tool-errors/name-decoration.md +++ b/docs/error-messages/tool-errors/name-decoration.md @@ -19,6 +19,7 @@ The following table shows the linker name for various calling conventions. |Fast call naming convention (**`__fastcall`**)|`@test@0`|`?test@@YIXXZ`| |Standard call naming convention (**`__stdcall`**)|`_test@0`|`?test@@YGXXZ`| |Vector call naming convention (**`__vectorcall`**)|`test@@0`|`?test@@YQXXZ`| +|Preserve None naming convention (**`__preserve_none`**)|`test@@_A`|`NA`| Use `extern "C"` to call a C function from C++. `extern "C"` forces use of the C naming convention for non-class C++ functions. Be aware of compiler switches **/Tc** or **/Tp**, which tell the compiler to ignore the filename extension and compile the file as C or C++, respectively. These options may cause linker names you don't expect. diff --git a/docs/error-messages/tool-errors/nmake-errors-u1000-through-u4011.md b/docs/error-messages/tool-errors/nmake-errors-u1000-through-u4011.md index 6b68d4ece1f..f0d916c427b 100644 --- a/docs/error-messages/tool-errors/nmake-errors-u1000-through-u4011.md +++ b/docs/error-messages/tool-errors/nmake-errors-u1000-through-u4011.md @@ -1,60 +1,63 @@ --- -description: "Learn more about: NMAKE errors and warnings (Uxxxx)" title: "NMAKE errors and warnings" -ms.date: "04/16/2019" +description: "Learn more about: NMAKE errors and warnings (Uxxxx)" +ms.date: 04/16/2019 f1_keywords: ["nmake"] -ms.assetid: 9dbe2e12-88ca-4df4-b935-17756112bb79 --- # NMAKE errors and warnings (Uxxxx) This section is a reference to the errors and warnings generated by the NMAKE build tool. NMAKE errors and warnings have the form U*xxxx*, where *xxxx* is a four-digit number. -[!INCLUDE[error-boilerplate](../../error-messages/includes/error-boilerplate.md)] +[!INCLUDE[error-boilerplate](../includes/error-boilerplate.md)] ## NMAKE fatal errors -[NMAKE fatal error U1000](nmake-fatal-error-u1000.md) \ -[NMAKE fatal error U1001](nmake-fatal-error-u1001.md) \ -[NMAKE fatal error U1007](nmake-fatal-error-u1007.md) \ -[NMAKE fatal error U1023](nmake-fatal-error-u1023.md) \ -[NMAKE fatal error U1033](nmake-fatal-error-u1033.md) \ -[NMAKE fatal error U1034](nmake-fatal-error-u1034.md) \ -[NMAKE fatal error U1035](nmake-fatal-error-u1035.md) \ -[NMAKE fatal error U1036](nmake-fatal-error-u1036.md) \ -[NMAKE fatal error U1045](nmake-fatal-error-u1045.md) \ -[NMAKE fatal error U1050](nmake-fatal-error-u1050.md) \ -[NMAKE fatal error U1051](nmake-fatal-error-u1051.md) \ -[NMAKE fatal error U1052](nmake-fatal-error-u1052.md) \ -[NMAKE fatal error U1055](nmake-fatal-error-u1055.md) \ -[NMAKE fatal error U1056](nmake-fatal-error-u1056.md) \ -[NMAKE fatal error U1059](nmake-fatal-error-u1059.md) \ -[NMAKE fatal error U1064](nmake-fatal-error-u1064.md) \ -[NMAKE fatal error U1065](nmake-fatal-error-u1065.md) \ -[NMAKE fatal error U1070](nmake-fatal-error-u1070.md) \ -[NMAKE fatal error U1071](nmake-fatal-error-u1071.md) \ -[NMAKE fatal error U1073](nmake-fatal-error-u1073.md) \ -[NMAKE fatal error U1076](nmake-fatal-error-u1076.md) \ -[NMAKE fatal error U1077](nmake-fatal-error-u1077.md) \ -[NMAKE fatal error U1078](nmake-fatal-error-u1078.md) \ -[NMAKE fatal error U1083](nmake-fatal-error-u1083.md) \ -[NMAKE fatal error U1086](nmake-fatal-error-u1086.md) \ -[NMAKE fatal error U1087](nmake-fatal-error-u1087.md) \ -[NMAKE fatal error U1088](nmake-fatal-error-u1088.md) \ -[NMAKE fatal error U1095](nmake-fatal-error-u1095.md) \ -[NMAKE fatal error U1097](nmake-fatal-error-u1097.md) \ -[NMAKE fatal error U1099](nmake-fatal-error-u1099.md) \ -[NMAKE fatal error U1100](nmake-fatal-error-u1100.md) +| Error | Message | +|--|--| +| [NMAKE fatal error U1000](nmake-fatal-error-u1000.md) | syntax error : ')' missing in macro invocation | +| [NMAKE fatal error U1001](nmake-fatal-error-u1001.md) | syntax error : illegal character 'character' in macro | +| [NMAKE fatal error U1007](nmake-fatal-error-u1007.md) | double quotation mark not allowed in name | +| [NMAKE fatal error U1023](nmake-fatal-error-u1023.md) | syntax error in expression | +| [NMAKE fatal error U1033](nmake-fatal-error-u1033.md) | syntax error : 'string' unexpected | +| [NMAKE fatal error U1034](nmake-fatal-error-u1034.md) | syntax error : separator missing | +| [NMAKE fatal error U1035](nmake-fatal-error-u1035.md) | syntax error : expected ':' or '=' separator | +| [NMAKE fatal error U1036](nmake-fatal-error-u1036.md) | syntax error : too many names to left of '=' | +| [NMAKE fatal error U1045](nmake-fatal-error-u1045.md) | spawn failed : *message* | +| [NMAKE fatal error U1050](nmake-fatal-error-u1050.md) | *message* | +| [NMAKE fatal error U1051](nmake-fatal-error-u1051.md) | out of memory | +| [NMAKE fatal error U1052](nmake-fatal-error-u1052.md) | file '*filename*' not found | +| [NMAKE fatal error U1055](nmake-fatal-error-u1055.md) | out of environment space | +| [NMAKE fatal error U1056](nmake-fatal-error-u1056.md) | cannot find command processor | +| [NMAKE fatal error U1059](nmake-fatal-error-u1059.md) | syntax error : '}' missing in dependent | +| [NMAKE fatal error U1064](nmake-fatal-error-u1064.md) | MAKEFILE not found and no target specified | +| [NMAKE fatal error U1065](nmake-fatal-error-u1065.md) | invalid option 'option' | +| [NMAKE fatal error U1070](nmake-fatal-error-u1070.md) | cycle in macro definition 'macroname' | +| [NMAKE fatal error U1071](nmake-fatal-error-u1071.md) | cycle in dependency tree for target 'targetname' | +| [NMAKE fatal error U1073](nmake-fatal-error-u1073.md) | don't know how to make 'targetname' | +| [NMAKE fatal error U1076](nmake-fatal-error-u1076.md) | name too long | +| [NMAKE fatal error U1077](nmake-fatal-error-u1077.md) | 'program' : return code 'value' | +| [NMAKE fatal error U1078](nmake-fatal-error-u1078.md) | constant overflow at 'expression' | +| [NMAKE fatal error U1083](nmake-fatal-error-u1083.md) | target macro 'target' expands to nothing | +| [NMAKE fatal error U1086](nmake-fatal-error-u1086.md) | inference rule cannot have dependents | +| [NMAKE fatal error U1087](nmake-fatal-error-u1087.md) | cannot have : and :: dependents for same target | +| [NMAKE fatal error U1088](nmake-fatal-error-u1088.md) | invalid separator '::' on inference rule | +| [NMAKE fatal error U1095](nmake-fatal-error-u1095.md) | expanded command line 'commandline' too long | +| [NMAKE fatal error U1097](nmake-fatal-error-u1097.md) | filename-parts syntax requires dependent | +| [NMAKE fatal error U1099](nmake-fatal-error-u1099.md) | stack overflow | +| [NMAKE fatal error U1100](nmake-fatal-error-u1100.md) | macro '*macro-name*' is illegal in the context of batch rule '*rule-name*' | ## NMAKE warnings -[NMAKE warning U4001](nmake-warning-u4001.md) \ -[NMAKE warning U4004](nmake-warning-u4004.md) \ -[NMAKE warning U4006](nmake-warning-u4006.md) \ -[NMAKE warning U4007](nmake-warning-u4007.md) \ -[NMAKE warning U4010](nmake-warning-u4010.md) \ -[NMAKE warning U4011](nmake-warning-u4011.md) +| Warning | Message | +|--|--| +| [NMAKE warning U4001](nmake-warning-u4001.md) | command file can be invoked only from command line | +| [NMAKE warning U4004](nmake-warning-u4004.md) | too many rules for target 'targetname' | +| [NMAKE warning U4006](nmake-warning-u4006.md) | special macro undefined : 'macroname' | +| [NMAKE warning U4007](nmake-warning-u4007.md) | filename 'filename' too long; truncating to 8.3 | +| [NMAKE warning U4010](nmake-warning-u4010.md) | 'target' : build failed; /K specified, continuing ... | +| [NMAKE warning U4011](nmake-warning-u4011.md) | 'target' : not all dependents available; target not built | ## See also -[C/C++ Compiler and build tools errors and warnings](../compiler-errors-1/c-cpp-build-errors.md) \ +[C/C++ Compiler and build tools errors and warnings](../compiler-errors-1/c-cpp-build-errors.md)\ [NMAKE reference](../../build/reference/nmake-reference.md) diff --git a/docs/error-messages/tool-errors/nmake-fatal-error-u1000.md b/docs/error-messages/tool-errors/nmake-fatal-error-u1000.md index f30b782f076..24a842f48bd 100644 --- a/docs/error-messages/tool-errors/nmake-fatal-error-u1000.md +++ b/docs/error-messages/tool-errors/nmake-fatal-error-u1000.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: NMAKE Fatal Error U1000" title: "NMAKE Fatal Error U1000" -ms.date: "08/27/2018" +description: "Learn more about: NMAKE Fatal Error U1000" +ms.date: 08/27/2018 f1_keywords: ["U1000"] helpviewer_keywords: ["U1000"] -ms.assetid: 49b9bd9e-f1bc-4b55-a171-c748e40b195e --- # NMAKE Fatal Error U1000 > syntax error : ')' missing in macro invocation +## Remarks + A left parenthesis, **(**, appeared without a matching right parenthesis, **)**, in a macro invocation. The correct form is **$(**name**)**; **$**n is allowed for one-character names. diff --git a/docs/error-messages/tool-errors/nmake-fatal-error-u1001.md b/docs/error-messages/tool-errors/nmake-fatal-error-u1001.md index 2b0e13a756c..08ea984cff1 100644 --- a/docs/error-messages/tool-errors/nmake-fatal-error-u1001.md +++ b/docs/error-messages/tool-errors/nmake-fatal-error-u1001.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: NMAKE Fatal Error U1001" title: "NMAKE Fatal Error U1001" -ms.date: "11/04/2016" +description: "Learn more about: NMAKE Fatal Error U1001" +ms.date: 11/04/2016 f1_keywords: ["U1001"] helpviewer_keywords: ["U1001"] -ms.assetid: 5d7da559-6cbd-44d6-848c-aaf54cae0d1a --- # NMAKE Fatal Error U1001 -syntax error : illegal character 'character' in macro +> syntax error : illegal character 'character' in macro + +## Remarks The given character appears in a macro but is not a letter, number, or underscore. diff --git a/docs/error-messages/tool-errors/nmake-fatal-error-u1007.md b/docs/error-messages/tool-errors/nmake-fatal-error-u1007.md index 2b2e8d222f2..60ea2b957f9 100644 --- a/docs/error-messages/tool-errors/nmake-fatal-error-u1007.md +++ b/docs/error-messages/tool-errors/nmake-fatal-error-u1007.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: NMAKE Fatal Error U1007" title: "NMAKE Fatal Error U1007" -ms.date: "11/04/2016" +description: "Learn more about: NMAKE Fatal Error U1007" +ms.date: 11/04/2016 f1_keywords: ["U1007"] helpviewer_keywords: ["U1007"] -ms.assetid: 64fd78a6-5b27-4aa8-92ea-f1c55e6e5edd --- # NMAKE Fatal Error U1007 -double quotation mark not allowed in name +> double quotation mark not allowed in name + +## Remarks The specified target name or filename contained a double quotation mark (**"**). diff --git a/docs/error-messages/tool-errors/nmake-fatal-error-u1023.md b/docs/error-messages/tool-errors/nmake-fatal-error-u1023.md index a3bbd00e45e..9588301e045 100644 --- a/docs/error-messages/tool-errors/nmake-fatal-error-u1023.md +++ b/docs/error-messages/tool-errors/nmake-fatal-error-u1023.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: NMAKE Fatal Error U1023" title: "NMAKE Fatal Error U1023" -ms.date: "11/04/2016" +description: "Learn more about: NMAKE Fatal Error U1023" +ms.date: 11/04/2016 f1_keywords: ["U1023"] helpviewer_keywords: ["U1023"] -ms.assetid: 22d4c469-85da-43ee-86d1-171b1b99217d --- # NMAKE Fatal Error U1023 -syntax error in expression +> syntax error in expression + +## Remarks An expression is invalid. diff --git a/docs/error-messages/tool-errors/nmake-fatal-error-u1033.md b/docs/error-messages/tool-errors/nmake-fatal-error-u1033.md index 5eff0091be8..ddb90f3b15f 100644 --- a/docs/error-messages/tool-errors/nmake-fatal-error-u1033.md +++ b/docs/error-messages/tool-errors/nmake-fatal-error-u1033.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: NMAKE Fatal Error U1033" title: "NMAKE Fatal Error U1033" -ms.date: "11/04/2016" +description: "Learn more about: NMAKE Fatal Error U1033" +ms.date: 11/04/2016 f1_keywords: ["U1033"] helpviewer_keywords: ["U1033"] -ms.assetid: c146f7b5-7d5c-4329-a522-28a648546016 --- # NMAKE Fatal Error U1033 -syntax error : 'string' unexpected +> syntax error : 'string' unexpected + +## Remarks The string is not part of the valid syntax for a makefile. diff --git a/docs/error-messages/tool-errors/nmake-fatal-error-u1034.md b/docs/error-messages/tool-errors/nmake-fatal-error-u1034.md index 5388c11124a..038db41936b 100644 --- a/docs/error-messages/tool-errors/nmake-fatal-error-u1034.md +++ b/docs/error-messages/tool-errors/nmake-fatal-error-u1034.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: NMAKE Fatal Error U1034" title: "NMAKE Fatal Error U1034" -ms.date: "11/04/2016" +description: "Learn more about: NMAKE Fatal Error U1034" +ms.date: 11/04/2016 f1_keywords: ["U1034"] helpviewer_keywords: ["U1034"] -ms.assetid: 27e678c2-23e2-4247-87f7-66493784af33 --- # NMAKE Fatal Error U1034 -syntax error : separator missing +> syntax error : separator missing + +## Remarks The colon (**:**) that separates targets and dependents is missing. diff --git a/docs/error-messages/tool-errors/nmake-fatal-error-u1035.md b/docs/error-messages/tool-errors/nmake-fatal-error-u1035.md index 88c3fedee2d..3b552b7199a 100644 --- a/docs/error-messages/tool-errors/nmake-fatal-error-u1035.md +++ b/docs/error-messages/tool-errors/nmake-fatal-error-u1035.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: NMAKE Fatal Error U1035" title: "NMAKE Fatal Error U1035" -ms.date: "11/04/2016" +description: "Learn more about: NMAKE Fatal Error U1035" +ms.date: 11/04/2016 f1_keywords: ["U1035"] helpviewer_keywords: ["U1035"] -ms.assetid: 68f0cc59-007e-4109-ac30-7ac4ac447e6d --- # NMAKE Fatal Error U1035 -syntax error : expected ':' or '=' separator +> syntax error : expected ':' or '=' separator + +## Remarks Either a colon (**:**) or an equal sign (**=**) was expected. diff --git a/docs/error-messages/tool-errors/nmake-fatal-error-u1036.md b/docs/error-messages/tool-errors/nmake-fatal-error-u1036.md index 4d738221c3b..23cb6149762 100644 --- a/docs/error-messages/tool-errors/nmake-fatal-error-u1036.md +++ b/docs/error-messages/tool-errors/nmake-fatal-error-u1036.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: NMAKE Fatal Error U1036" title: "NMAKE Fatal Error U1036" -ms.date: "11/04/2016" +description: "Learn more about: NMAKE Fatal Error U1036" +ms.date: 11/04/2016 f1_keywords: ["U1036"] helpviewer_keywords: ["U1036"] -ms.assetid: b1d03b6b-ce82-4bbb-9904-d392ba72b437 --- # NMAKE Fatal Error U1036 -syntax error : too many names to left of '=' +> syntax error : too many names to left of '=' + +## Remarks Only one string is allowed to the left of a macro definition. diff --git a/docs/error-messages/tool-errors/nmake-fatal-error-u1045.md b/docs/error-messages/tool-errors/nmake-fatal-error-u1045.md index 06ea660ec4e..28278195d4d 100644 --- a/docs/error-messages/tool-errors/nmake-fatal-error-u1045.md +++ b/docs/error-messages/tool-errors/nmake-fatal-error-u1045.md @@ -1,15 +1,16 @@ --- -description: "Learn more about: NMAKE Fatal Error U1045" title: "NMAKE Fatal Error U1045" -ms.date: "08/11/2019" +description: "Learn more about: NMAKE Fatal Error U1045" +ms.date: 08/11/2019 f1_keywords: ["U1045"] helpviewer_keywords: ["U1045"] -ms.assetid: dc70d162-14b9-4107-9237-7514044d72e3 --- # NMAKE Fatal Error U1045 > spawn failed : *message* +## Remarks + A program or command called by NMAKE failed for reason in *message*. When NMAKE calls another program, for example, the compiler or linker, the call may fail. Or, an error may be returned by the called program. This message is used to report the error. To fix this issue, first determine the cause of the error. You can use the commands reported by the NMAKE [/N](../../build/reference/running-nmake.md#nmake-options) option to verify the environment settings and to repeat the actions done by NMAKE on the command line. diff --git a/docs/error-messages/tool-errors/nmake-fatal-error-u1050.md b/docs/error-messages/tool-errors/nmake-fatal-error-u1050.md index a8872865701..a1e59028650 100644 --- a/docs/error-messages/tool-errors/nmake-fatal-error-u1050.md +++ b/docs/error-messages/tool-errors/nmake-fatal-error-u1050.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: NMAKE Fatal Error U1050" title: "NMAKE Fatal Error U1050" -ms.date: "11/04/2016" +description: "Learn more about: NMAKE Fatal Error U1050" +ms.date: 11/04/2016 f1_keywords: ["U1050"] helpviewer_keywords: ["U1050"] -ms.assetid: 3bb2937e-a804-4592-a9e6-afb63360f554 --- # NMAKE Fatal Error U1050 -message +> message + +## Remarks The message specified with the **!ERROR** directive was displayed. diff --git a/docs/error-messages/tool-errors/nmake-fatal-error-u1051.md b/docs/error-messages/tool-errors/nmake-fatal-error-u1051.md index 4d4aa782c14..14d5188d58a 100644 --- a/docs/error-messages/tool-errors/nmake-fatal-error-u1051.md +++ b/docs/error-messages/tool-errors/nmake-fatal-error-u1051.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: NMAKE Fatal Error U1051" title: "NMAKE Fatal Error U1051" -ms.date: "11/04/2016" +description: "Learn more about: NMAKE Fatal Error U1051" +ms.date: 11/04/2016 f1_keywords: ["U1051"] helpviewer_keywords: ["U1051"] -ms.assetid: fede5cd5-dac3-47b7-b86d-e1acfb78699f --- # NMAKE Fatal Error U1051 -out of memory +> out of memory + +## Remarks NMAKE ran out of memory, including virtual memory, because the makefile was too large or complex. diff --git a/docs/error-messages/tool-errors/nmake-fatal-error-u1052.md b/docs/error-messages/tool-errors/nmake-fatal-error-u1052.md index 2db5efd3c49..3a75ff6737c 100644 --- a/docs/error-messages/tool-errors/nmake-fatal-error-u1052.md +++ b/docs/error-messages/tool-errors/nmake-fatal-error-u1052.md @@ -1,15 +1,16 @@ --- -description: "Learn more about: NMAKE Fatal Error U1052" title: "NMAKE Fatal Error U1052" -ms.date: "09/05/2018" +description: "Learn more about: NMAKE Fatal Error U1052" +ms.date: 09/05/2018 f1_keywords: ["U1052"] helpviewer_keywords: ["U1052"] -ms.assetid: b19b3691-e60b-46bd-8822-8426740a9bc7 --- # NMAKE Fatal Error U1052 > file '*filename*' not found +## Remarks + NMAKE could not find the file specified with one of the following: - **/F** option diff --git a/docs/error-messages/tool-errors/nmake-fatal-error-u1055.md b/docs/error-messages/tool-errors/nmake-fatal-error-u1055.md index 2d6990c1b7d..de37ff89129 100644 --- a/docs/error-messages/tool-errors/nmake-fatal-error-u1055.md +++ b/docs/error-messages/tool-errors/nmake-fatal-error-u1055.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: NMAKE Fatal Error U1055" title: "NMAKE Fatal Error U1055" -ms.date: "11/04/2016" +description: "Learn more about: NMAKE Fatal Error U1055" +ms.date: 11/04/2016 f1_keywords: ["U1055"] helpviewer_keywords: ["U1055"] -ms.assetid: 1d453922-ba7e-497f-a795-d8d959c40555 --- # NMAKE Fatal Error U1055 -out of environment space +> out of environment space + +## Remarks The operating system ran out of room for environment variables. diff --git a/docs/error-messages/tool-errors/nmake-fatal-error-u1056.md b/docs/error-messages/tool-errors/nmake-fatal-error-u1056.md index 21829ca80bb..06285d3dc4d 100644 --- a/docs/error-messages/tool-errors/nmake-fatal-error-u1056.md +++ b/docs/error-messages/tool-errors/nmake-fatal-error-u1056.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: NMAKE Fatal Error U1056" title: "NMAKE Fatal Error U1056" -ms.date: "11/04/2016" +description: "Learn more about: NMAKE Fatal Error U1056" +ms.date: 11/04/2016 f1_keywords: ["U1056"] helpviewer_keywords: ["U1056"] -ms.assetid: da855728-b69e-413c-83ed-df912126215e --- # NMAKE Fatal Error U1056 -cannot find command processor +> cannot find command processor + +## Remarks The command processor was not in the path specified in the **COMSPEC** or **PATH** environment variables. diff --git a/docs/error-messages/tool-errors/nmake-fatal-error-u1059.md b/docs/error-messages/tool-errors/nmake-fatal-error-u1059.md index b6492fff8af..2918a3f6507 100644 --- a/docs/error-messages/tool-errors/nmake-fatal-error-u1059.md +++ b/docs/error-messages/tool-errors/nmake-fatal-error-u1059.md @@ -1,15 +1,16 @@ --- -description: "Learn more about: NMAKE Fatal Error U1059" title: "NMAKE Fatal Error U1059" -ms.date: "08/27/2018" +description: "Learn more about: NMAKE Fatal Error U1059" +ms.date: 08/27/2018 f1_keywords: ["U1059"] helpviewer_keywords: ["U1059"] -ms.assetid: b21d9198-9c63-40d0-b589-80e17294ce24 --- # NMAKE Fatal Error U1059 > syntax error : '}' missing in dependent +## Remarks + A search path for a dependent was incorrectly specified. Either a space existed in the path or the closing brace (**}**) was omitted. The syntax for a directory specification for a dependent is diff --git a/docs/error-messages/tool-errors/nmake-fatal-error-u1064.md b/docs/error-messages/tool-errors/nmake-fatal-error-u1064.md index cd17c2018a2..79fe444306d 100644 --- a/docs/error-messages/tool-errors/nmake-fatal-error-u1064.md +++ b/docs/error-messages/tool-errors/nmake-fatal-error-u1064.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: NMAKE Fatal Error U1064" title: "NMAKE Fatal Error U1064" -ms.date: "11/04/2016" +description: "Learn more about: NMAKE Fatal Error U1064" +ms.date: 11/04/2016 f1_keywords: ["U1064"] helpviewer_keywords: ["U1064"] -ms.assetid: 7141e66e-cde6-4173-84df-a391f3ebcdd1 --- # NMAKE Fatal Error U1064 -MAKEFILE not found and no target specified +> MAKEFILE not found and no target specified + +## Remarks The NMAKE command line did not specify a makefile or a target, and the current directory did not contain a file named MAKEFILE. diff --git a/docs/error-messages/tool-errors/nmake-fatal-error-u1065.md b/docs/error-messages/tool-errors/nmake-fatal-error-u1065.md index be07276b6aa..77762393f2b 100644 --- a/docs/error-messages/tool-errors/nmake-fatal-error-u1065.md +++ b/docs/error-messages/tool-errors/nmake-fatal-error-u1065.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: NMAKE Fatal Error U1065" title: "NMAKE Fatal Error U1065" -ms.date: "11/04/2016" +description: "Learn more about: NMAKE Fatal Error U1065" +ms.date: 11/04/2016 f1_keywords: ["U1065"] helpviewer_keywords: ["U1065"] -ms.assetid: bc890f20-ff46-4073-ab3b-4a5db879f9bd --- # NMAKE Fatal Error U1065 -invalid option 'option' +> invalid option 'option' + +## Remarks The option is not valid for NMAKE. diff --git a/docs/error-messages/tool-errors/nmake-fatal-error-u1070.md b/docs/error-messages/tool-errors/nmake-fatal-error-u1070.md index 3636b2a3f10..b2691ac1dfa 100644 --- a/docs/error-messages/tool-errors/nmake-fatal-error-u1070.md +++ b/docs/error-messages/tool-errors/nmake-fatal-error-u1070.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: NMAKE Fatal Error U1070" title: "NMAKE Fatal Error U1070" -ms.date: "11/04/2016" +description: "Learn more about: NMAKE Fatal Error U1070" +ms.date: 11/04/2016 f1_keywords: ["U1070"] helpviewer_keywords: ["U1070"] -ms.assetid: 8639fc39-b4b1-48f5-ac91-0e9fb61680fd --- # NMAKE Fatal Error U1070 -cycle in macro definition 'macroname' +> cycle in macro definition 'macroname' + +## Remarks The given macro definition contained a macro whose definition contained the given macro. Circular macro definitions are invalid. diff --git a/docs/error-messages/tool-errors/nmake-fatal-error-u1071.md b/docs/error-messages/tool-errors/nmake-fatal-error-u1071.md index fd851f84ff0..1f2a4cedcee 100644 --- a/docs/error-messages/tool-errors/nmake-fatal-error-u1071.md +++ b/docs/error-messages/tool-errors/nmake-fatal-error-u1071.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: NMAKE Fatal Error U1071" title: "NMAKE Fatal Error U1071" -ms.date: "11/04/2016" +description: "Learn more about: NMAKE Fatal Error U1071" +ms.date: 11/04/2016 f1_keywords: ["U1071"] helpviewer_keywords: ["U1071"] -ms.assetid: 328a0c1f-a867-410e-943d-7b6b75a975ab --- # NMAKE Fatal Error U1071 -cycle in dependency tree for target 'targetname' +> cycle in dependency tree for target 'targetname' + +## Remarks A circular dependency exists in the dependency tree for the given target. The given target is a dependent of one of the dependents of the given target. Circular dependencies are invalid. diff --git a/docs/error-messages/tool-errors/nmake-fatal-error-u1073.md b/docs/error-messages/tool-errors/nmake-fatal-error-u1073.md index 572d421d61a..84cb579e0ce 100644 --- a/docs/error-messages/tool-errors/nmake-fatal-error-u1073.md +++ b/docs/error-messages/tool-errors/nmake-fatal-error-u1073.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: NMAKE Fatal Error U1073" title: "NMAKE Fatal Error U1073" -ms.date: "11/04/2016" +description: "Learn more about: NMAKE Fatal Error U1073" +ms.date: 11/04/2016 f1_keywords: ["U1073"] helpviewer_keywords: ["U1073"] -ms.assetid: d46bf2dd-400a-4802-9db2-f832e1c97f02 --- # NMAKE Fatal Error U1073 -don't know how to make 'targetname' +> don't know how to make 'targetname' + +## Remarks The specified target does not exist, and there is no command to execute or inference rule to apply. diff --git a/docs/error-messages/tool-errors/nmake-fatal-error-u1076.md b/docs/error-messages/tool-errors/nmake-fatal-error-u1076.md index 8c95ad3f7dd..5015af36911 100644 --- a/docs/error-messages/tool-errors/nmake-fatal-error-u1076.md +++ b/docs/error-messages/tool-errors/nmake-fatal-error-u1076.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: NMAKE Fatal Error U1076" title: "NMAKE Fatal Error U1076" -ms.date: "11/04/2016" +description: "Learn more about: NMAKE Fatal Error U1076" +ms.date: 11/04/2016 f1_keywords: ["U1076"] helpviewer_keywords: ["U1076"] -ms.assetid: f8a6c646-0c49-4ee3-bb74-ab916a7aa6ff --- # NMAKE Fatal Error U1076 -name too long +> name too long + +## Remarks A string exceeded one of the following limits: diff --git a/docs/error-messages/tool-errors/nmake-fatal-error-u1077.md b/docs/error-messages/tool-errors/nmake-fatal-error-u1077.md index 57120c5e205..cf389cf8dd7 100644 --- a/docs/error-messages/tool-errors/nmake-fatal-error-u1077.md +++ b/docs/error-messages/tool-errors/nmake-fatal-error-u1077.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: NMAKE Fatal Error U1077" title: "NMAKE Fatal Error U1077" -ms.date: "11/04/2016" +description: "Learn more about: NMAKE Fatal Error U1077" +ms.date: 11/04/2016 f1_keywords: ["U1077"] helpviewer_keywords: ["U1077"] -ms.assetid: 70d989f8-ef34-4ad7-8fe0-5b800556b2a1 --- # NMAKE Fatal Error U1077 -'program' : return code 'value' +> 'program' : return code 'value' + +## Remarks The given command or program called by NMAKE failed and returned the given exit code. diff --git a/docs/error-messages/tool-errors/nmake-fatal-error-u1078.md b/docs/error-messages/tool-errors/nmake-fatal-error-u1078.md index efcae0f8b0d..ee1e637a341 100644 --- a/docs/error-messages/tool-errors/nmake-fatal-error-u1078.md +++ b/docs/error-messages/tool-errors/nmake-fatal-error-u1078.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: NMAKE Fatal Error U1078" title: "NMAKE Fatal Error U1078" -ms.date: "11/04/2016" +description: "Learn more about: NMAKE Fatal Error U1078" +ms.date: 11/04/2016 f1_keywords: ["U1078"] helpviewer_keywords: ["U1078"] -ms.assetid: 24087955-9362-4ddf-9966-e0de43ea4647 --- # NMAKE Fatal Error U1078 -constant overflow at 'expression' +> constant overflow at 'expression' + +## Remarks The given expression contained a constant that exceeded the range - 2,147,483,648 to 2,147,483,647. The constant appeared in one of the following situations: diff --git a/docs/error-messages/tool-errors/nmake-fatal-error-u1083.md b/docs/error-messages/tool-errors/nmake-fatal-error-u1083.md index 2b42dcbecf5..22be01d0e95 100644 --- a/docs/error-messages/tool-errors/nmake-fatal-error-u1083.md +++ b/docs/error-messages/tool-errors/nmake-fatal-error-u1083.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: NMAKE Fatal Error U1083" title: "NMAKE Fatal Error U1083" -ms.date: "11/04/2016" +description: "Learn more about: NMAKE Fatal Error U1083" +ms.date: 11/04/2016 f1_keywords: ["U1083"] helpviewer_keywords: ["U1083"] -ms.assetid: b09bc34d-35d5-4676-b000-fd7d434400d9 --- # NMAKE Fatal Error U1083 -target macro 'target' expands to nothing +> target macro 'target' expands to nothing + +## Remarks The given target is an invocation of a macro that has not been defined or has a null value. NMAKE cannot process a null target. diff --git a/docs/error-messages/tool-errors/nmake-fatal-error-u1086.md b/docs/error-messages/tool-errors/nmake-fatal-error-u1086.md index 6143eaf3d76..4705fc28e11 100644 --- a/docs/error-messages/tool-errors/nmake-fatal-error-u1086.md +++ b/docs/error-messages/tool-errors/nmake-fatal-error-u1086.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: NMAKE Fatal Error U1086" title: "NMAKE Fatal Error U1086" -ms.date: "11/04/2016" +description: "Learn more about: NMAKE Fatal Error U1086" +ms.date: 11/04/2016 f1_keywords: ["U1086"] helpviewer_keywords: ["U1086"] -ms.assetid: 6d3cd68a-ead6-4a6d-a205-01324785de7e --- # NMAKE Fatal Error U1086 -**inference rule cannot have dependents** +> inference rule cannot have dependents + +## Remarks The colon (**:**) in an inference rule must be followed by one of these: diff --git a/docs/error-messages/tool-errors/nmake-fatal-error-u1087.md b/docs/error-messages/tool-errors/nmake-fatal-error-u1087.md index 6f5406a2315..7082f6c6d19 100644 --- a/docs/error-messages/tool-errors/nmake-fatal-error-u1087.md +++ b/docs/error-messages/tool-errors/nmake-fatal-error-u1087.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: NMAKE Fatal Error U1087" title: "NMAKE Fatal Error U1087" -ms.date: "11/04/2016" +description: "Learn more about: NMAKE Fatal Error U1087" +ms.date: 11/04/2016 f1_keywords: ["U1087"] helpviewer_keywords: ["U1087"] -ms.assetid: 5236ab54-e117-484d-99c3-852b061fd3d0 --- # NMAKE Fatal Error U1087 -cannot have : and :: dependents for same target +> cannot have : and :: dependents for same target + +## Remarks A target cannot be specified in both a single-colon (**:**) and a double-colon (`::`) dependency. diff --git a/docs/error-messages/tool-errors/nmake-fatal-error-u1088.md b/docs/error-messages/tool-errors/nmake-fatal-error-u1088.md index 6ed23ef6eef..5f62fb6e7af 100644 --- a/docs/error-messages/tool-errors/nmake-fatal-error-u1088.md +++ b/docs/error-messages/tool-errors/nmake-fatal-error-u1088.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: NMAKE Fatal Error U1088" title: "NMAKE Fatal Error U1088" -ms.date: "11/04/2016" +description: "Learn more about: NMAKE Fatal Error U1088" +ms.date: 11/04/2016 f1_keywords: ["U1088"] helpviewer_keywords: ["U1088"] -ms.assetid: 75f3527b-9923-408b-a66e-701322c63803 --- # NMAKE Fatal Error U1088 -invalid separator '::' on inference rule +> invalid separator '::' on inference rule + +## Remarks An inference rule must be followed by a single colon (**:**). diff --git a/docs/error-messages/tool-errors/nmake-fatal-error-u1095.md b/docs/error-messages/tool-errors/nmake-fatal-error-u1095.md index 012f7e0d104..87e702a9d06 100644 --- a/docs/error-messages/tool-errors/nmake-fatal-error-u1095.md +++ b/docs/error-messages/tool-errors/nmake-fatal-error-u1095.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: NMAKE Fatal Error U1095" title: "NMAKE Fatal Error U1095" -ms.date: "11/04/2016" +description: "Learn more about: NMAKE Fatal Error U1095" +ms.date: 11/04/2016 f1_keywords: ["U1095"] helpviewer_keywords: ["U1095"] -ms.assetid: a392582b-06db-4568-9c13-450293a4fbda --- # NMAKE Fatal Error U1095 -expanded command line 'commandline' too long +> expanded command line 'commandline' too long + +## Remarks After macro expansion, the given command line exceeded the limit on length of command lines for the operating system. diff --git a/docs/error-messages/tool-errors/nmake-fatal-error-u1097.md b/docs/error-messages/tool-errors/nmake-fatal-error-u1097.md index 1dd82ea7b90..7c9958d77e2 100644 --- a/docs/error-messages/tool-errors/nmake-fatal-error-u1097.md +++ b/docs/error-messages/tool-errors/nmake-fatal-error-u1097.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: NMAKE Fatal Error U1097" title: "NMAKE Fatal Error U1097" -ms.date: "11/04/2016" +description: "Learn more about: NMAKE Fatal Error U1097" +ms.date: 11/04/2016 f1_keywords: ["U1097"] helpviewer_keywords: ["U1097"] -ms.assetid: dc6868b3-8425-4920-858a-774ad0c4c5f1 --- # NMAKE Fatal Error U1097 -filename-parts syntax requires dependent +> filename-parts syntax requires dependent + +## Remarks The current dependency does not have either an explicit dependent or an implicit dependent. Filename-parts syntax, which uses the percent (`%`) specifier, represents components of the first dependent of the current target. diff --git a/docs/error-messages/tool-errors/nmake-fatal-error-u1099.md b/docs/error-messages/tool-errors/nmake-fatal-error-u1099.md index bd672f6cf98..d2645925c72 100644 --- a/docs/error-messages/tool-errors/nmake-fatal-error-u1099.md +++ b/docs/error-messages/tool-errors/nmake-fatal-error-u1099.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: NMAKE Fatal Error U1099" title: "NMAKE Fatal Error U1099" -ms.date: "11/04/2016" +description: "Learn more about: NMAKE Fatal Error U1099" +ms.date: 11/04/2016 f1_keywords: ["U1099"] helpviewer_keywords: ["U1099"] -ms.assetid: 6688a805-43e6-4247-a2d0-14be082f0b13 --- # NMAKE Fatal Error U1099 -stack overflow +> stack overflow + +## Remarks The makefile being processed was too complex for the current stack allocation in NMAKE. NMAKE has an allocation of 0x3000 (12K). diff --git a/docs/error-messages/tool-errors/nmake-fatal-error-u1100.md b/docs/error-messages/tool-errors/nmake-fatal-error-u1100.md index 497a02ea3dc..4ae01cd7b7e 100644 --- a/docs/error-messages/tool-errors/nmake-fatal-error-u1100.md +++ b/docs/error-messages/tool-errors/nmake-fatal-error-u1100.md @@ -4,12 +4,13 @@ description: "A description of the causes of Microsoft NMAKE fatal error U1100." ms.date: 07/17/2020 f1_keywords: ["U1100"] helpviewer_keywords: ["U1100"] -ms.assetid: c71910a7-c581-4d9c-a38c-d2d557d56289 --- # NMAKE Fatal Error U1100 > macro '*macro-name*' is illegal in the context of batch rule '*rule-name*' +## Remarks + NMAKE generates this error when the command block of a batch-mode rule directly or indirectly references a special file macro that isn't `$<`. `$<` is the only allowed macro for batch-mode rules. diff --git a/docs/error-messages/tool-errors/nmake-warning-u4001.md b/docs/error-messages/tool-errors/nmake-warning-u4001.md index 950ef74f800..a23091484ad 100644 --- a/docs/error-messages/tool-errors/nmake-warning-u4001.md +++ b/docs/error-messages/tool-errors/nmake-warning-u4001.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: NMAKE Warning U4001" title: "NMAKE Warning U4001" -ms.date: "09/05/2018" +description: "Learn more about: NMAKE Warning U4001" +ms.date: 09/05/2018 f1_keywords: ["U4001"] helpviewer_keywords: ["U4001"] -ms.assetid: ed3b4068-2ad8-4ffc-b7c7-33897d2a55d7 --- # NMAKE Warning U4001 > command file can be invoked only from command line +## Remarks + A command file, which is invoked by the at sign (**\@**) specifier, cannot contain a specification for another command file. Such nesting is not allowed. The specification was ignored. diff --git a/docs/error-messages/tool-errors/nmake-warning-u4004.md b/docs/error-messages/tool-errors/nmake-warning-u4004.md index 4ab084062d1..93f0ea200fe 100644 --- a/docs/error-messages/tool-errors/nmake-warning-u4004.md +++ b/docs/error-messages/tool-errors/nmake-warning-u4004.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: NMAKE Warning U4004" title: "NMAKE Warning U4004" -ms.date: "11/04/2016" +description: "Learn more about: NMAKE Warning U4004" +ms.date: 11/04/2016 f1_keywords: ["U4004"] helpviewer_keywords: ["U4004"] -ms.assetid: 5086bbcb-42d7-4677-a877-1a02202a86a2 --- # NMAKE Warning U4004 -too many rules for target 'targetname' +> too many rules for target 'targetname' + +## Remarks More than one description block was specified for the given target using single colons (**:**) as separators. NMAKE executed the commands in the first description block and ignored later blocks. diff --git a/docs/error-messages/tool-errors/nmake-warning-u4006.md b/docs/error-messages/tool-errors/nmake-warning-u4006.md index 8ed54357ead..7a0b31901f0 100644 --- a/docs/error-messages/tool-errors/nmake-warning-u4006.md +++ b/docs/error-messages/tool-errors/nmake-warning-u4006.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: NMAKE Warning U4006" title: "NMAKE Warning U4006" -ms.date: "11/04/2016" +description: "Learn more about: NMAKE Warning U4006" +ms.date: 11/04/2016 f1_keywords: ["U4006"] helpviewer_keywords: ["U4006"] -ms.assetid: 830ad63c-d454-47a3-840c-c272f29ef3d2 --- # NMAKE Warning U4006 -special macro undefined : 'macroname' +> special macro undefined : 'macroname' + +## Remarks The given special macro name is undefined and expands to nothing. diff --git a/docs/error-messages/tool-errors/nmake-warning-u4007.md b/docs/error-messages/tool-errors/nmake-warning-u4007.md index 15e4b79e462..392d4529ecd 100644 --- a/docs/error-messages/tool-errors/nmake-warning-u4007.md +++ b/docs/error-messages/tool-errors/nmake-warning-u4007.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: NMAKE Warning U4007" title: "NMAKE Warning U4007" -ms.date: "11/04/2016" +description: "Learn more about: NMAKE Warning U4007" +ms.date: 11/04/2016 f1_keywords: ["U4007"] helpviewer_keywords: ["U4007"] -ms.assetid: 61ec0417-6961-43c1-ade8-f9d6e93289e9 --- # NMAKE Warning U4007 -filename 'filename' too long; truncating to 8.3 +> filename 'filename' too long; truncating to 8.3 + +## Remarks The base name of the given file has more than eight characters, or the extension has more than three characters. NMAKE truncated the name to an eight-character base and a three-character extension. diff --git a/docs/error-messages/tool-errors/nmake-warning-u4010.md b/docs/error-messages/tool-errors/nmake-warning-u4010.md index 99cc38a56ff..44fa515eee6 100644 --- a/docs/error-messages/tool-errors/nmake-warning-u4010.md +++ b/docs/error-messages/tool-errors/nmake-warning-u4010.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: NMAKE Warning U4010" title: "NMAKE Warning U4010" -ms.date: "11/04/2016" +description: "Learn more about: NMAKE Warning U4010" +ms.date: 11/04/2016 f1_keywords: ["U4010"] helpviewer_keywords: ["U4010"] -ms.assetid: 99d8eb9a-ae31-40d1-b8c5-8c66732127d3 --- # NMAKE Warning U4010 -'target' : build failed; /K specified, continuing ... +> 'target' : build failed; /K specified, continuing ... + +## Remarks A command in the commands block for the given target returned a nonzero exit code. The /K option told NMAKE to continue processing unrelated parts of the build and to issue an exit code 1 when the NMAKE session is finished. diff --git a/docs/error-messages/tool-errors/nmake-warning-u4011.md b/docs/error-messages/tool-errors/nmake-warning-u4011.md index cde7c27e7d4..9e8040a5f54 100644 --- a/docs/error-messages/tool-errors/nmake-warning-u4011.md +++ b/docs/error-messages/tool-errors/nmake-warning-u4011.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: NMAKE Warning U4011" title: "NMAKE Warning U4011" -ms.date: "11/04/2016" +description: "Learn more about: NMAKE Warning U4011" +ms.date: 11/04/2016 f1_keywords: ["U4011"] helpviewer_keywords: ["U4011"] -ms.assetid: e8244514-eba6-4285-8853-7baeefdcd8a4 --- # NMAKE Warning U4011 -'target' : not all dependents available; target not built +> 'target' : not all dependents available; target not built + +## Remarks A dependent of the given target either did not exist or was out-of-date, and a command for updating the dependent returned a nonzero exit code. The /K option told NMAKE to continue processing unrelated parts of the build and to issue an exit code 1 when the NMAKE session is finished. diff --git a/docs/error-messages/tool-errors/profile-guided-optimization-errors-and-warnings.md b/docs/error-messages/tool-errors/profile-guided-optimization-errors-and-warnings.md index d3eae644ae7..9afd0a1d993 100644 --- a/docs/error-messages/tool-errors/profile-guided-optimization-errors-and-warnings.md +++ b/docs/error-messages/tool-errors/profile-guided-optimization-errors-and-warnings.md @@ -1,26 +1,29 @@ --- -description: "Learn more about: Profile-Guided Optimization errors and warnings (PGxxxx)" title: "Profile-Guided Optimization errors and warnings" -ms.date: "04/17/2019" +description: "Learn more about: Profile-Guided Optimization errors and warnings (PGxxxx)" +ms.date: 04/17/2019 f1_keywords: ["PG0001", "PG0002", "PG0003", "PG0061", "PG0062", "PG0063", "PG0065", "PG0066", "PG0067", "PG0068", "PG0069", "PG0070", "PG0071", "PG0081", "PG0087", "PG0090", "PG0091", "PG0092", "PG0094", "PG0096", "PG0168", "PG0169", "PG0181", "PG0188", "PG1000", "PG1001", "PG1032", "PG1033", "PG1035", "PG1036", "PG1038", "PG1051", "PG1052", "PG1053", "PG1056", "PG1058", "PG1060", "PG1061", "PG1065", "PG1066", "PG1067"] -ms.assetid: f67b1011-fb64-4df3-9356-d52c9423ff3f --- # Profile-Guided Optimization errors and warnings (PGxxxx) This section is a reference to the errors generated by the Profile-Guided Optimization (PGO) tools. PGO errors and warnings have the form PG*xxxx*, where *xxxx* is a four-digit number. -[!INCLUDE[error-boilerplate](../../error-messages/includes/error-boilerplate.md)] +[!INCLUDE[error-boilerplate](../includes/error-boilerplate.md)] ## PGO errors -[Profile-Guided Optimization Error PG0165](../../error-messages/tool-errors/profile-guided-optimization-error-pg0165.md) +| Error | Message | +|--|--| +| [Profile-Guided Optimization Error PG0165](profile-guided-optimization-error-pg0165.md) | Reading '*filename.pgd*' : '*message*'. | ## PGO warnings -[Profile-Guided Optimization Warning PG1039](../../error-messages/tool-errors/profile-guided-optimization-warning-pg1039.md) \ -[Profile-Guided Optimization Warning PG1087](../../error-messages/tool-errors/profile-guided-optimization-warning-pg1087.md) +| Warning | Message | +|--|--| +| [Profile-Guided Optimization Warning PG1039](profile-guided-optimization-warning-pg1039.md) | Failed waiting for quiet time to sweep. | +| [Profile-Guided Optimization Warning PG1087](profile-guided-optimization-warning-pg1087.md) | The PGC file 'file' is not valid. | ## See also -[C/C++ Compiler and build tools errors and warnings](../compiler-errors-1/c-cpp-build-errors.md) \ +[C/C++ Compiler and build tools errors and warnings](../compiler-errors-1/c-cpp-build-errors.md)\ [Profile-Guided Optimizations](../../build/profile-guided-optimizations.md) diff --git a/docs/error-messages/tool-errors/profile-guided-optimization-warning-pg1039.md b/docs/error-messages/tool-errors/profile-guided-optimization-warning-pg1039.md index 1bab31de79d..1205a811698 100644 --- a/docs/error-messages/tool-errors/profile-guided-optimization-warning-pg1039.md +++ b/docs/error-messages/tool-errors/profile-guided-optimization-warning-pg1039.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Profile-Guided Optimization Warning PG1039" title: "Profile-Guided Optimization Warning PG1039" -ms.date: "11/04/2016" +description: "Learn more about: Profile-Guided Optimization Warning PG1039" +ms.date: 11/04/2016 f1_keywords: ["PG1039"] helpviewer_keywords: ["PG1039"] -ms.assetid: a67dfd66-b610-4d78-9658-2bcf7a506b9f --- # Profile-Guided Optimization Warning PG1039 -Failed waiting for quiet time to sweep. +> Failed waiting for quiet time to sweep. + +## Remarks The application did not allow [pgosweep](../../build/pgosweep.md) to run. If possible, run pgosweep when the application is in an idle state. diff --git a/docs/error-messages/tool-errors/profile-guided-optimization-warning-pg1087.md b/docs/error-messages/tool-errors/profile-guided-optimization-warning-pg1087.md index 873b38173a2..d68d8413ca6 100644 --- a/docs/error-messages/tool-errors/profile-guided-optimization-warning-pg1087.md +++ b/docs/error-messages/tool-errors/profile-guided-optimization-warning-pg1087.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Profile-Guided Optimization Warning PG1087" title: "Profile-Guided Optimization Warning PG1087" -ms.date: "11/04/2016" +description: "Learn more about: Profile-Guided Optimization Warning PG1087" +ms.date: 11/04/2016 f1_keywords: ["PG1087"] helpviewer_keywords: ["PG1087"] -ms.assetid: 50785d68-17a2-4d82-bee2-8c514faf61c6 --- # Profile-Guided Optimization Warning PG1087 -The PGC file 'file' is not valid. +> The PGC file 'file' is not valid. + +## Remarks A .pgc file is corrupt, possibly due to an abnormal end to a profiling session. Rerun the profiling scenario and terminate normally. diff --git a/docs/error-messages/tool-errors/project-build-error-prj0002.md b/docs/error-messages/tool-errors/project-build-error-prj0002.md index b61c38b32bb..25cdd328c58 100644 --- a/docs/error-messages/tool-errors/project-build-error-prj0002.md +++ b/docs/error-messages/tool-errors/project-build-error-prj0002.md @@ -1,15 +1,16 @@ --- -description: "Learn more about: Project Build Error PRJ0002" title: "Project Build Error PRJ0002" -ms.date: "08/27/2018" +description: "Learn more about: Project Build Error PRJ0002" +ms.date: 08/27/2018 f1_keywords: ["PRJ0002"] helpviewer_keywords: ["PRJ0002"] -ms.assetid: 1c820b1f-9a24-4681-80ed-4fcbfd7caa00 --- # Project Build Error PRJ0002 > error result returned from '*command line*'. +## Remarks + A command, *command line*, which was formed from user input in the **Property Pages** dialog box, returned an error code but no information will appear in the **Output** window. The resolution to this error depends on which tool generated the error. For MIDL, you will get an idea of what went wrong if /o (Redirect Output) is defined. diff --git a/docs/error-messages/tool-errors/project-build-error-prj0003.md b/docs/error-messages/tool-errors/project-build-error-prj0003.md index 0ae0473610d..3a8e09419da 100644 --- a/docs/error-messages/tool-errors/project-build-error-prj0003.md +++ b/docs/error-messages/tool-errors/project-build-error-prj0003.md @@ -1,15 +1,16 @@ --- -description: "Learn more about: Project Build Error PRJ0003" title: "Project Build Error PRJ0003" -ms.date: "11/04/2016" +description: "Learn more about: Project Build Error PRJ0003" +ms.date: 11/04/2016 f1_keywords: ["PRJ0003"] helpviewer_keywords: ["PRJ0003"] -ms.assetid: fc5a84bb-c6d3-41d6-8dd6-475455820778 --- # Project Build Error PRJ0003 > Error spawning '*command line*'. +## Remarks + The *command line* command formed from input in the **Property Pages** dialog box returned an error code, but no information appears in the **Output** window. Possible reasons for this error include: diff --git a/docs/error-messages/tool-errors/project-build-error-prj0004.md b/docs/error-messages/tool-errors/project-build-error-prj0004.md index 387c00e6be2..07cfd3b1d1c 100644 --- a/docs/error-messages/tool-errors/project-build-error-prj0004.md +++ b/docs/error-messages/tool-errors/project-build-error-prj0004.md @@ -1,15 +1,16 @@ --- -description: "Learn more about: Project Build Error PRJ0004" title: "Project Build Error PRJ0004" -ms.date: "08/27/2018" +description: "Learn more about: Project Build Error PRJ0004" +ms.date: 08/27/2018 f1_keywords: ["PRJ0004"] helpviewer_keywords: ["PRJ0004"] -ms.assetid: 1858769f-0be4-40ed-ab70-2cee550488c7 --- # Project Build Error PRJ0004 > Could not generate command line for the '*tool*' tool. +## Remarks + One or more properties were specified in such a way as to make the syntax of the call to *tool* illegal: - You may have specified badly formed or unknown macros. diff --git a/docs/error-messages/tool-errors/project-build-error-prj0005.md b/docs/error-messages/tool-errors/project-build-error-prj0005.md index 8e2e34587c2..1daca41960c 100644 --- a/docs/error-messages/tool-errors/project-build-error-prj0005.md +++ b/docs/error-messages/tool-errors/project-build-error-prj0005.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Project Build Error PRJ0005" title: "Project Build Error PRJ0005" -ms.date: "11/04/2016" +description: "Learn more about: Project Build Error PRJ0005" +ms.date: 11/04/2016 f1_keywords: ["PRJ0005"] helpviewer_keywords: ["PRJ0005"] -ms.assetid: 00c1821b-16aa-4bd9-9cf6-a778e5ed4ad9 --- # Project Build Error PRJ0005 -Unable to create a temporary file in directory 'directory'. +> Unable to create a temporary file in directory 'directory'. + +## Remarks The call to create a temporary file failed. Reasons for failure include: diff --git a/docs/error-messages/tool-errors/project-build-error-prj0006.md b/docs/error-messages/tool-errors/project-build-error-prj0006.md index 9a98972aba4..c5ddbebb489 100644 --- a/docs/error-messages/tool-errors/project-build-error-prj0006.md +++ b/docs/error-messages/tool-errors/project-build-error-prj0006.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Project Build Error PRJ0006" title: "Project Build Error PRJ0006" -ms.date: "11/04/2016" +description: "Learn more about: Project Build Error PRJ0006" +ms.date: 11/04/2016 f1_keywords: ["PRJ0006"] helpviewer_keywords: ["PRJ0006"] -ms.assetid: ce092be4-1652-414f-8cb5-b97ef5841f89 --- # Project Build Error PRJ0006 -Could not open the temporary file 'file'. Make sure the file exists and that the directory is not write-protected. +> Could not open the temporary file 'file'. Make sure the file exists and that the directory is not write-protected. + +## Remarks Visual C++ could not create a temporary file during the build process. Reasons for this include: diff --git a/docs/error-messages/tool-errors/project-build-error-prj0007.md b/docs/error-messages/tool-errors/project-build-error-prj0007.md index 5c661e392d1..315b84e1a2e 100644 --- a/docs/error-messages/tool-errors/project-build-error-prj0007.md +++ b/docs/error-messages/tool-errors/project-build-error-prj0007.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Project Build Error PRJ0007" title: "Project Build Error PRJ0007" -ms.date: "11/04/2016" +description: "Learn more about: Project Build Error PRJ0007" +ms.date: 11/04/2016 f1_keywords: ["PRJ0007"] helpviewer_keywords: ["PRJ0007"] -ms.assetid: d923948b-acc9-498f-bf3b-f14e41bed61a --- # Project Build Error PRJ0007 -Could not create output directory 'directory'. +> Could not create output directory 'directory'. + +## Remarks Visual C++ failed to create an output directory. Possible reasons include: diff --git a/docs/error-messages/tool-errors/project-build-error-prj0008.md b/docs/error-messages/tool-errors/project-build-error-prj0008.md index 9371e7b0056..ab916e188be 100644 --- a/docs/error-messages/tool-errors/project-build-error-prj0008.md +++ b/docs/error-messages/tool-errors/project-build-error-prj0008.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Project Build Error PRJ0008" title: "Project Build Error PRJ0008" -ms.date: "11/04/2016" +description: "Learn more about: Project Build Error PRJ0008" +ms.date: 11/04/2016 f1_keywords: ["PRJ0008"] helpviewer_keywords: ["PRJ0008"] -ms.assetid: 6bf7f17a-d2a8-4826-99c7-d600d846952f --- # Project Build Error PRJ0008 -Could not delete file 'file'. +> Could not delete file 'file'. + +## Remarks **Make sure that the file is not open by another process and is not write-protected.** diff --git a/docs/error-messages/tool-errors/project-build-error-prj0009.md b/docs/error-messages/tool-errors/project-build-error-prj0009.md index e2ba86e6546..cb3d58ba79c 100644 --- a/docs/error-messages/tool-errors/project-build-error-prj0009.md +++ b/docs/error-messages/tool-errors/project-build-error-prj0009.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Project Build Error PRJ0009" title: "Project Build Error PRJ0009" -ms.date: "11/04/2016" +description: "Learn more about: Project Build Error PRJ0009" +ms.date: 11/04/2016 f1_keywords: ["PRJ0009"] helpviewer_keywords: ["PRJ0009"] -ms.assetid: 89291778-cda4-495d-983f-ddcc06dfc98b --- # Project Build Error PRJ0009 -Build log could not be opened for writing. +> Build log could not be opened for writing. + +## Remarks **Make sure that the file is not open by another process and is not write-protected.** diff --git a/docs/error-messages/tool-errors/project-build-error-prj0013.md b/docs/error-messages/tool-errors/project-build-error-prj0013.md index 9c83ecf9f8b..004cd1fa41c 100644 --- a/docs/error-messages/tool-errors/project-build-error-prj0013.md +++ b/docs/error-messages/tool-errors/project-build-error-prj0013.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Project Build Error PRJ0013" title: "Project Build Error PRJ0013" -ms.date: "11/04/2016" +description: "Learn more about: Project Build Error PRJ0013" +ms.date: 11/04/2016 f1_keywords: ["PRJ0013"] helpviewer_keywords: ["PRJ0013"] -ms.assetid: 95e7bafd-63c8-4b2d-b778-f19cdf9ba36c --- # Project Build Error PRJ0013 -System resource could be critically low. Unable to create a pipe required to launch a build. +> System resource could be critically low. Unable to create a pipe required to launch a build. + +## Remarks This error indicates that system resources are low. To resolve this error, decrease system resource usage by other processes/applications. diff --git a/docs/error-messages/tool-errors/project-build-error-prj0014.md b/docs/error-messages/tool-errors/project-build-error-prj0014.md index c865d37ae13..e2a69bf636d 100644 --- a/docs/error-messages/tool-errors/project-build-error-prj0014.md +++ b/docs/error-messages/tool-errors/project-build-error-prj0014.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Project Build Error PRJ0014" title: "Project Build Error PRJ0014" -ms.date: "11/04/2016" +description: "Learn more about: Project Build Error PRJ0014" +ms.date: 11/04/2016 f1_keywords: ["PRJ0014"] helpviewer_keywords: ["PRJ0014"] -ms.assetid: b08c6df1-1df1-4573-9fca-49de6c5a0c17 --- # Project Build Error PRJ0014 -The job object used to control the spawned processes has failed. The build cannot continue. +> The job object used to control the spawned processes has failed. The build cannot continue. + +## Remarks An error occurred in the development environment. diff --git a/docs/error-messages/tool-errors/project-build-error-prj0015.md b/docs/error-messages/tool-errors/project-build-error-prj0015.md index 06083644403..7cf85655166 100644 --- a/docs/error-messages/tool-errors/project-build-error-prj0015.md +++ b/docs/error-messages/tool-errors/project-build-error-prj0015.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Project Build Error PRJ0015" title: "Project Build Error PRJ0015" -ms.date: "11/04/2016" +description: "Learn more about: Project Build Error PRJ0015" +ms.date: 11/04/2016 f1_keywords: ["PRJ0015"] helpviewer_keywords: ["PRJ0015"] -ms.assetid: 2096c8f1-e96c-49a4-a690-1cb893a8bf6f --- # Project Build Error PRJ0015 -The NULL device is missing from your system. We are unable to launch a build. +> The NULL device is missing from your system. We are unable to launch a build. + +## Remarks This error can be caused by low system resources. Close some applications or reboot. diff --git a/docs/error-messages/tool-errors/project-build-error-prj0016.md b/docs/error-messages/tool-errors/project-build-error-prj0016.md index d187b7b7db7..a4432287490 100644 --- a/docs/error-messages/tool-errors/project-build-error-prj0016.md +++ b/docs/error-messages/tool-errors/project-build-error-prj0016.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Project Build Error PRJ0016" title: "Project Build Error PRJ0016" -ms.date: "11/04/2016" +description: "Learn more about: Project Build Error PRJ0016" +ms.date: 11/04/2016 f1_keywords: ["PRJ0016"] helpviewer_keywords: ["PRJ0016"] -ms.assetid: e9745336-883a-4c70-9c40-7753e02f0325 --- # Project Build Error PRJ0016 -The user's security settings prevent the process from being created. These settings are required for building. +> The user's security settings prevent the process from being created. These settings are required for building. + +## Remarks You are logged in as a user who does not have permissions to create processes using a process. You must change the permission levels for this user account, or contact your account administrator. diff --git a/docs/error-messages/tool-errors/project-build-error-prj0017.md b/docs/error-messages/tool-errors/project-build-error-prj0017.md index 58cc800c983..4f5d3e8d954 100644 --- a/docs/error-messages/tool-errors/project-build-error-prj0017.md +++ b/docs/error-messages/tool-errors/project-build-error-prj0017.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Project Build Error PRJ0017" title: "Project Build Error PRJ0017" -ms.date: "11/04/2016" +description: "Learn more about: Project Build Error PRJ0017" +ms.date: 11/04/2016 f1_keywords: ["PRJ0017"] helpviewer_keywords: ["PRJ0017"] -ms.assetid: a192729f-bb10-486a-bfda-a7843fa259b2 --- # Project Build Error PRJ0017 -The current working directory is invalid. +> The current working directory is invalid. + +## Remarks The path to the current working directory is longer than _MAXPATH. To resolve this error, do not create your project at such a deep level. diff --git a/docs/error-messages/tool-errors/project-build-error-prj0019.md b/docs/error-messages/tool-errors/project-build-error-prj0019.md index 1945c29a55c..5780072ddec 100644 --- a/docs/error-messages/tool-errors/project-build-error-prj0019.md +++ b/docs/error-messages/tool-errors/project-build-error-prj0019.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Project Build Error PRJ0019" title: "Project Build Error PRJ0019" -ms.date: "11/04/2016" +description: "Learn more about: Project Build Error PRJ0019" +ms.date: 11/04/2016 f1_keywords: ["PRJ0019"] helpviewer_keywords: ["PRJ0019"] -ms.assetid: 5390a62b-aacf-4bc8-b9d7-08f1e0233423 --- # Project Build Error PRJ0019 -A tool returned an error code from +> A tool returned an error code from + +## Remarks An error level was nonzero for a custom build step or build event. diff --git a/docs/error-messages/tool-errors/project-build-error-prj0020.md b/docs/error-messages/tool-errors/project-build-error-prj0020.md index f853411257b..2dbf934ea7d 100644 --- a/docs/error-messages/tool-errors/project-build-error-prj0020.md +++ b/docs/error-messages/tool-errors/project-build-error-prj0020.md @@ -1,15 +1,16 @@ --- -description: "Learn more about: Project Build Error PRJ0020" title: "Project Build Error PRJ0020" -ms.date: "08/27/2018" +description: "Learn more about: Project Build Error PRJ0020" +ms.date: 08/27/2018 f1_keywords: ["PRJ0020"] helpviewer_keywords: ["PRJ0020"] -ms.assetid: 54bb8cd4-af7c-4d62-8125-3ab5ff5f2cc4 --- # Project Build Error PRJ0020 > Tool '*tool*', Property '*property*' contains invalid file name '*file*'. +## Remarks + The file name *file*, specified in the property *property* for the tool *tool*, was invalid. You may have used an unknown or invalid macro. diff --git a/docs/error-messages/tool-errors/project-build-error-prj0021.md b/docs/error-messages/tool-errors/project-build-error-prj0021.md index 335cba2b63a..ca4900c35c4 100644 --- a/docs/error-messages/tool-errors/project-build-error-prj0021.md +++ b/docs/error-messages/tool-errors/project-build-error-prj0021.md @@ -1,15 +1,16 @@ --- -description: "Learn more about: Project Build Error PRJ0021" title: "Project Build Error PRJ0021" -ms.date: "08/27/2018" +description: "Learn more about: Project Build Error PRJ0021" +ms.date: 08/27/2018 f1_keywords: ["PRJ0021"] helpviewer_keywords: ["PRJ0021"] -ms.assetid: bcab794d-4a6d-4b4d-aaca-73676c0cec75 --- # Project Build Error PRJ0021 > Tool '*tool*', Property '*property*' contains invalid file name. +## Remarks + The file name specified in the property *property* for the tool *tool* was invalid. You may have used an unknown or invalid macro. diff --git a/docs/error-messages/tool-errors/project-build-error-prj0022.md b/docs/error-messages/tool-errors/project-build-error-prj0022.md index 7d1cf48c185..2dd36de88b6 100644 --- a/docs/error-messages/tool-errors/project-build-error-prj0022.md +++ b/docs/error-messages/tool-errors/project-build-error-prj0022.md @@ -1,15 +1,16 @@ --- -description: "Learn more about: Project Build Error PRJ0022" title: "Project Build Error PRJ0022" -ms.date: "08/27/2018" +description: "Learn more about: Project Build Error PRJ0022" +ms.date: 08/27/2018 f1_keywords: ["PRJ0022"] helpviewer_keywords: ["PRJ0022"] -ms.assetid: 691344a8-fc70-4aeb-9372-dde72f4588a4 --- # Project Build Error PRJ0022 > Unknown Tool, Property '*property*' contains invalid file name '*file*'. +## Remarks + The file name *file* specified in the property *property* was invalid. You may have used an unknown or invalid macro. diff --git a/docs/error-messages/tool-errors/project-build-error-prj0023.md b/docs/error-messages/tool-errors/project-build-error-prj0023.md index 377423e3135..a0604f9e768 100644 --- a/docs/error-messages/tool-errors/project-build-error-prj0023.md +++ b/docs/error-messages/tool-errors/project-build-error-prj0023.md @@ -1,15 +1,16 @@ --- -description: "Learn more about: Project Build Error PRJ0023" title: "Project Build Error PRJ0023" -ms.date: "08/27/2018" +description: "Learn more about: Project Build Error PRJ0023" +ms.date: 08/27/2018 f1_keywords: ["PRJ0023"] helpviewer_keywords: ["PRJ0023"] -ms.assetid: ed55a320-e7c8-489f-886e-825feee0d576 --- # Project Build Error PRJ0023 > Tool '*tool*', Unknown Property contains invalid file name '*file*'. +## Remarks + The file name *file* specified for the tool *tool* was invalid. You may have used an unknown or invalid macro. diff --git a/docs/error-messages/tool-errors/project-build-error-prj0024.md b/docs/error-messages/tool-errors/project-build-error-prj0024.md index 600cb4212a7..0511d1e1f07 100644 --- a/docs/error-messages/tool-errors/project-build-error-prj0024.md +++ b/docs/error-messages/tool-errors/project-build-error-prj0024.md @@ -1,15 +1,16 @@ --- -description: "Learn more about: Project Build Error PRJ0024" title: "Project Build Error PRJ0024" -ms.date: "08/27/2018" +description: "Learn more about: Project Build Error PRJ0024" +ms.date: 08/27/2018 f1_keywords: ["PRJ0024"] helpviewer_keywords: ["PRJ0024"] -ms.assetid: 8bde6368-6c1b-4e04-bc5e-3c6d0b8fa1d7 --- # Project Build Error PRJ0024 > Unicode path '*path*' could not be translated to user's ANSI code page. +## Remarks + *path* is the original Unicode version of the path string. This error can occur in cases where there is a Unicode path that cannot be directly translated to ANSI for the current system code page. This error may occur if you are working with a project that was developed on a system using a code page that is not on your computer. diff --git a/docs/error-messages/tool-errors/project-build-error-prj0025.md b/docs/error-messages/tool-errors/project-build-error-prj0025.md index 835df947fff..44c275ba9e7 100644 --- a/docs/error-messages/tool-errors/project-build-error-prj0025.md +++ b/docs/error-messages/tool-errors/project-build-error-prj0025.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Project Build Error PRJ0025" title: "Project Build Error PRJ0025" -ms.date: "08/27/2018" +description: "Learn more about: Project Build Error PRJ0025" +ms.date: 08/27/2018 f1_keywords: ["PRJ0025"] helpviewer_keywords: ["PRJ0025"] -ms.assetid: 57725c78-bc63-44f3-9667-2969b2d7c41d --- # Project Build Error PRJ0025 @@ -12,6 +11,8 @@ ms.assetid: 57725c78-bc63-44f3-9667-2969b2d7c41d > > *UNICODE contents of file* +## Remarks + The project system found Unicode contents in a custom build rule or build event that cannot be translated properly to the user's current ANSI code page. The resolution for this error is to update the contents of the build rule or build event to use ANSI or to install the code page on your computer and set it as the system default. diff --git a/docs/error-messages/tool-errors/project-build-error-prj0026.md b/docs/error-messages/tool-errors/project-build-error-prj0026.md index b839afbf8bf..3e31ffebaf3 100644 --- a/docs/error-messages/tool-errors/project-build-error-prj0026.md +++ b/docs/error-messages/tool-errors/project-build-error-prj0026.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Project Build Error PRJ0026" title: "Project Build Error PRJ0026" -ms.date: "08/27/2018" +description: "Learn more about: Project Build Error PRJ0026" +ms.date: 08/27/2018 f1_keywords: ["PRJ0026"] helpviewer_keywords: ["PRJ0026"] -ms.assetid: c52bc9b5-8b22-4015-b477-8645ae56c489 --- # Project Build Error PRJ0026 @@ -12,6 +11,8 @@ ms.assetid: c52bc9b5-8b22-4015-b477-8645ae56c489 > > *UNICODE contents of file* +## Remarks + The project system found Unicode contents in a response file that cannot be translated properly to the user's current ANSI code page. The resolution for this error is to update the contents of the response file to use ANSI or to install the code page on your computer and set it as the system default. diff --git a/docs/error-messages/tool-errors/project-build-error-prj0027.md b/docs/error-messages/tool-errors/project-build-error-prj0027.md index 36d7d27b448..d6a3617908f 100644 --- a/docs/error-messages/tool-errors/project-build-error-prj0027.md +++ b/docs/error-messages/tool-errors/project-build-error-prj0027.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Project Build Error PRJ0027" title: "Project Build Error PRJ0027" -ms.date: "11/04/2016" +description: "Learn more about: Project Build Error PRJ0027" +ms.date: 11/04/2016 f1_keywords: ["PRJ0027"] helpviewer_keywords: ["PRJ0027"] -ms.assetid: 85d73a78-4b9e-4553-9f5d-2d76c48a790a --- # Project Build Error PRJ0027 -Unicode log message 'contents' contains content that could not be translated to the user's ANSI code page. +> Unicode log message 'contents' contains content that could not be translated to the user's ANSI code page. + +## Remarks You will typically only see this warning in conjunction with errors in creating batch and/or response files. diff --git a/docs/error-messages/tool-errors/project-build-error-prj0028.md b/docs/error-messages/tool-errors/project-build-error-prj0028.md index f6beac1e882..a161469f323 100644 --- a/docs/error-messages/tool-errors/project-build-error-prj0028.md +++ b/docs/error-messages/tool-errors/project-build-error-prj0028.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Project Build Error PRJ0028" title: "Project Build Error PRJ0028" -ms.date: "11/04/2016" +description: "Learn more about: Project Build Error PRJ0028" +ms.date: 11/04/2016 f1_keywords: ["PRJ0028"] helpviewer_keywords: ["PRJ0028"] -ms.assetid: 0a6e0da7-cb3d-40b6-81a6-6196a9c2526b --- # Project Build Error PRJ0028 -Temporary file 'file' contains Unicode contents that could not be translated to user's ANSI code page. +> Temporary file 'file' contains Unicode contents that could not be translated to user's ANSI code page. + +## Remarks A value was specified with the [/MIDL (Specify MIDL Command Line Options)](../../build/reference/midl-specify-midl-command-line-options.md) linker option that could not be resolved by the system code page. diff --git a/docs/error-messages/tool-errors/project-build-error-prj0030.md b/docs/error-messages/tool-errors/project-build-error-prj0030.md index 74d695229ae..0484a509b7f 100644 --- a/docs/error-messages/tool-errors/project-build-error-prj0030.md +++ b/docs/error-messages/tool-errors/project-build-error-prj0030.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Project Build Error PRJ0030" title: "Project Build Error PRJ0030" -ms.date: "11/04/2016" +description: "Learn more about: Project Build Error PRJ0030" +ms.date: 11/04/2016 f1_keywords: ["PRJ0030"] helpviewer_keywords: ["PRJ0030"] -ms.assetid: c48b3727-e166-46e7-bcd7-3e5b2ac5c1d4 --- # Project Build Error PRJ0030 -Macro expansion error. Evaluate recursion exceeded 32 levels for $(macro). +> Macro expansion error. Evaluate recursion exceeded 32 levels for $(macro). + +## Remarks This error is caused by recursion in your macros. For example, if you set the **Intermediate Directory** property (see [General Property Page (Project)](../../build/reference/general-property-page-project.md)) to $(IntDir), you will have recursion. diff --git a/docs/error-messages/tool-errors/project-build-error-prj0031.md b/docs/error-messages/tool-errors/project-build-error-prj0031.md index 5b40281db8b..7584eabdb47 100644 --- a/docs/error-messages/tool-errors/project-build-error-prj0031.md +++ b/docs/error-messages/tool-errors/project-build-error-prj0031.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Project Build Error PRJ0031" title: "Project Build Error PRJ0031" -ms.date: "11/04/2016" +description: "Learn more about: Project Build Error PRJ0031" +ms.date: 11/04/2016 f1_keywords: ["PRJ0031"] helpviewer_keywords: ["PRJ0031"] -ms.assetid: b42435c6-e570-4f8e-9ad5-12a7ea69ccb2 --- # Project Build Error PRJ0031 -The 'Outputs' property for the custom build step for file 'file' contained 'macro' which evaluates out to 'macro_expansion'. +> The 'Outputs' property for the custom build step for file 'file' contained 'macro' which evaluates out to 'macro_expansion'. + +## Remarks A custom build step on a file had bad output probably due to a macro evaluation problem. This error could also mean that the path is badly formed, containing characters or combinations of characters that are illegal in a file path. diff --git a/docs/error-messages/tool-errors/project-build-error-prj0032.md b/docs/error-messages/tool-errors/project-build-error-prj0032.md index 2659dca6ce3..d324d45d78c 100644 --- a/docs/error-messages/tool-errors/project-build-error-prj0032.md +++ b/docs/error-messages/tool-errors/project-build-error-prj0032.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Project Build Error PRJ0032" title: "Project Build Error PRJ0032" -ms.date: "11/04/2016" +description: "Learn more about: Project Build Error PRJ0032" +ms.date: 11/04/2016 f1_keywords: ["PRJ0032"] helpviewer_keywords: ["PRJ0032"] -ms.assetid: bc6acbea-4041-4237-8b5a-f0434705d89f --- # Project Build Error PRJ0032 -The 'Outputs' property for the project-level custom build step contained 'macro' which evaluates out to 'macro_expansion'. +> The 'Outputs' property for the project-level custom build step contained 'macro' which evaluates out to 'macro_expansion'. + +## Remarks A custom build step on a project had bad output probably due to a macro evaluation problem. This error could also mean that the path is badly formed, containing characters or combinations of characters that are illegal in a file path. diff --git a/docs/error-messages/tool-errors/project-build-error-prj0033.md b/docs/error-messages/tool-errors/project-build-error-prj0033.md index 445a667d8d8..66b3196d043 100644 --- a/docs/error-messages/tool-errors/project-build-error-prj0033.md +++ b/docs/error-messages/tool-errors/project-build-error-prj0033.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Project Build Error PRJ0033" title: "Project Build Error PRJ0033" -ms.date: "11/04/2016" +description: "Learn more about: Project Build Error PRJ0033" +ms.date: 11/04/2016 f1_keywords: ["PRJ0033"] helpviewer_keywords: ["PRJ0033"] -ms.assetid: 84d4a052-0586-4b78-9315-81c1e8386c1e --- # Project Build Error PRJ0033 -The 'Additional Dependencies' property for the custom build step for file 'file' contained 'macro' which evaluates out to 'macro_expansion'. +> The 'Additional Dependencies' property for the custom build step for file 'file' contained 'macro' which evaluates out to 'macro_expansion'. + +## Remarks A custom build step on a file contained an error in its additional dependency probably due to a macro evaluation problem. This error could also mean that the path is badly formed, containing characters or combinations of characters that are illegal in a file path. diff --git a/docs/error-messages/tool-errors/project-build-error-prj0034.md b/docs/error-messages/tool-errors/project-build-error-prj0034.md index dcfc2b8fb53..00b59e0ae24 100644 --- a/docs/error-messages/tool-errors/project-build-error-prj0034.md +++ b/docs/error-messages/tool-errors/project-build-error-prj0034.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Project Build Error PRJ0034" title: "Project Build Error PRJ0034" -ms.date: "11/04/2016" +description: "Learn more about: Project Build Error PRJ0034" +ms.date: 11/04/2016 f1_keywords: ["PRJ0034"] helpviewer_keywords: ["PRJ0034"] -ms.assetid: 1da4a55b-231b-4476-8545-6997628fbc00 --- # Project Build Error PRJ0034 -The 'Additional Dependencies' property for the project-level custom build step contained 'macro' which evaluates out to 'macro_expansion'. +> The 'Additional Dependencies' property for the project-level custom build step contained 'macro' which evaluates out to 'macro_expansion'. + +## Remarks A custom build step on a project contained an error in its additional dependency probably due to a macro evaluation problem. This error could also mean that the path is badly formed, containing characters or combinations of characters that are illegal in a file path. diff --git a/docs/error-messages/tool-errors/project-build-error-prj0035.md b/docs/error-messages/tool-errors/project-build-error-prj0035.md index ecfd160c80a..0bfd95e4b65 100644 --- a/docs/error-messages/tool-errors/project-build-error-prj0035.md +++ b/docs/error-messages/tool-errors/project-build-error-prj0035.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Project Build Error PRJ0035" title: "Project Build Error PRJ0035" -ms.date: "08/27/2018" +description: "Learn more about: Project Build Error PRJ0035" +ms.date: 08/27/2018 f1_keywords: ["PRJ0035"] helpviewer_keywords: ["PRJ0035"] -ms.assetid: 0667116d-338c-40a4-972c-da875f778cb5 --- # Project Build Error PRJ0035 @@ -12,6 +11,8 @@ ms.assetid: 0667116d-338c-40a4-972c-da875f778cb5 > > *UNICODE contents of file* +## Remarks + *file* is the XML file created as the command line to the Web Deployment tool. The project system found Unicode characters in some property on the Web Deployment property page that can't properly be translated to ANSI. diff --git a/docs/error-messages/tool-errors/project-build-error-prj0036.md b/docs/error-messages/tool-errors/project-build-error-prj0036.md index 078ae4b5220..51622101d0b 100644 --- a/docs/error-messages/tool-errors/project-build-error-prj0036.md +++ b/docs/error-messages/tool-errors/project-build-error-prj0036.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Project Build Error PRJ0036" title: "Project Build Error PRJ0036" -ms.date: "11/04/2016" +description: "Learn more about: Project Build Error PRJ0036" +ms.date: 11/04/2016 f1_keywords: ["PRJ0036"] helpviewer_keywords: ["PRJ0036"] -ms.assetid: ee215cd1-2d66-474d-9a63-b9096f1c4923 --- # Project Build Error PRJ0036 -The 'Additional Files' property for the Web Deployment Tool contained an invalid entry. +> The 'Additional Files' property for the Web Deployment Tool contained an invalid entry. + +## Remarks The Additional Files property on the Web Deployment property page contained an error, possibly due to a macro evaluation problem. This error could also mean that the path is badly formed, containing characters or combinations of characters that are illegal in a file path. diff --git a/docs/error-messages/tool-errors/project-build-error-prj0040.md b/docs/error-messages/tool-errors/project-build-error-prj0040.md index c9d2860e395..5007bb30d4d 100644 --- a/docs/error-messages/tool-errors/project-build-error-prj0040.md +++ b/docs/error-messages/tool-errors/project-build-error-prj0040.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Project Build Error PRJ0040" title: "Project Build Error PRJ0040" -ms.date: "11/04/2016" +description: "Learn more about: Project Build Error PRJ0040" +ms.date: 11/04/2016 f1_keywords: ["PRJ0040"] helpviewer_keywords: ["PRJ0040"] -ms.assetid: 6549ac62-c87b-4edf-b541-32221abe97ec --- # Project Build Error PRJ0040 -Internal error on build. Cannot continue. Please reload project and try again. +> Internal error on build. Cannot continue. Please reload project and try again. + +## Remarks The project system was unable to process your project. diff --git a/docs/error-messages/tool-errors/project-build-error-prj0044.md b/docs/error-messages/tool-errors/project-build-error-prj0044.md index 0168bd57f8d..1521e028e80 100644 --- a/docs/error-messages/tool-errors/project-build-error-prj0044.md +++ b/docs/error-messages/tool-errors/project-build-error-prj0044.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Project Build Error PRJ0044" title: "Project Build Error PRJ0044" -ms.date: "11/04/2016" +description: "Learn more about: Project Build Error PRJ0044" +ms.date: 11/04/2016 f1_keywords: ["PRJ0044"] helpviewer_keywords: ["PRJ0044"] -ms.assetid: 5d78c45a-f9e9-4d2b-a3b6-5a5d1421ab84 --- # Project Build Error PRJ0044 -The 'Additional Dependencies' property for custom build rule 'rule' assigned to file 'file' is invalid. The property contained 'string' which evaluates to 'value'. +> The 'Additional Dependencies' property for custom build rule 'rule' assigned to file 'file' is invalid. The property contained 'string' which evaluates to 'value'. + +## Remarks The **Additional Dependencies** property evaluated to an empty string, or to a string that contained invalid characters (any character that could not be in a file or directory name). Custom build rules need the output of the build action. diff --git a/docs/error-messages/tool-errors/project-build-error-prj0046.md b/docs/error-messages/tool-errors/project-build-error-prj0046.md index 4c773d14331..85972cd2536 100644 --- a/docs/error-messages/tool-errors/project-build-error-prj0046.md +++ b/docs/error-messages/tool-errors/project-build-error-prj0046.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Project Build Error PRJ0046" title: "Project Build Error PRJ0046" -ms.date: "11/04/2016" +description: "Learn more about: Project Build Error PRJ0046" +ms.date: 11/04/2016 f1_keywords: ["PRJ0046"] helpviewer_keywords: ["PRJ0046"] -ms.assetid: 59442319-4481-4b97-a4a5-16f52fc718e7 --- # Project Build Error PRJ0046 -Could not spawn command line because the one specified was empty. +> Could not spawn command line because the one specified was empty. + +## Remarks An empty command line was specified for a makefile configuration; the command line is required. diff --git a/docs/error-messages/tool-errors/project-build-error-prj0047.md b/docs/error-messages/tool-errors/project-build-error-prj0047.md index 77037f5823a..74eeb76498a 100644 --- a/docs/error-messages/tool-errors/project-build-error-prj0047.md +++ b/docs/error-messages/tool-errors/project-build-error-prj0047.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Project Build Error PRJ0047" title: "Project Build Error PRJ0047" -ms.date: "11/04/2016" +description: "Learn more about: Project Build Error PRJ0047" +ms.date: 11/04/2016 f1_keywords: ["PRJ0047"] helpviewer_keywords: ["PRJ0047"] -ms.assetid: 7c79149d-4b7c-4a24-830e-904d92c1f0b4 --- # Project Build Error PRJ0047 -Could not resume the suspended process. The build has failed. +> Could not resume the suspended process. The build has failed. + +## Remarks An error occurred in the development environment. diff --git a/docs/error-messages/tool-errors/project-build-error-prj0050.md b/docs/error-messages/tool-errors/project-build-error-prj0050.md index 1d7c06e4027..842578f2ae6 100644 --- a/docs/error-messages/tool-errors/project-build-error-prj0050.md +++ b/docs/error-messages/tool-errors/project-build-error-prj0050.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Project Build Error PRJ0050" title: "Project Build Error PRJ0050" -ms.date: "11/04/2016" +description: "Learn more about: Project Build Error PRJ0050" +ms.date: 11/04/2016 f1_keywords: ["PRJ0050"] helpviewer_keywords: ["PRJ0050"] -ms.assetid: ceef3b37-0acf-4abd-ac62-aa830b4fa145 --- # Project Build Error PRJ0050 -Failed to register output. Please ensure you have the appropriate permissions to modify the registry. +> Failed to register output. Please ensure you have the appropriate permissions to modify the registry. + +## Remarks The Visual C++ build system was not able to register the output of the build (dll or .exe). You need to be logged on as an administrator to modify the registry. diff --git a/docs/error-messages/tool-errors/project-build-errors-and-warnings-prjxxxx.md b/docs/error-messages/tool-errors/project-build-errors-and-warnings-prjxxxx.md index 8622e006449..e05ebacd66b 100644 --- a/docs/error-messages/tool-errors/project-build-errors-and-warnings-prjxxxx.md +++ b/docs/error-messages/tool-errors/project-build-errors-and-warnings-prjxxxx.md @@ -1,62 +1,65 @@ --- -description: "Learn more about: Project build errors and warnings (PRJxxxx)" title: "Project build errors and warnings" -ms.date: "04/16/2019" -ms.assetid: 79d223ed-986a-4536-8299-aec8356b449c +description: "Learn more about: Project build errors and warnings (PRJxxxx)" +ms.date: 04/16/2019 --- # Project build errors and warnings (PRJxxxx) This section is a reference to the errors generated by the Project build tools. Project build errors and warnings have the form PRJ*xxxx*, where *xxxx* is a four-digit number. -[!INCLUDE[error-boilerplate](../../error-messages/includes/error-boilerplate.md)] +[!INCLUDE[error-boilerplate](../includes/error-boilerplate.md)] ## Project build errors -[Project build error PRJ0002](project-build-error-prj0002.md) \ -[Project build error PRJ0003](project-build-error-prj0003.md) \ -[Project build error PRJ0004](project-build-error-prj0004.md) \ -[Project build error PRJ0005](project-build-error-prj0005.md) \ -[Project build error PRJ0006](project-build-error-prj0006.md) \ -[Project build error PRJ0007](project-build-error-prj0007.md) \ -[Project build error PRJ0008](project-build-error-prj0008.md) \ -[Project build error PRJ0009](project-build-error-prj0009.md) \ -[Project build error PRJ0013](project-build-error-prj0013.md) \ -[Project build error PRJ0014](project-build-error-prj0014.md) \ -[Project build error PRJ0015](project-build-error-prj0015.md) \ -[Project build error PRJ0016](project-build-error-prj0016.md) \ -[Project build error PRJ0017](project-build-error-prj0017.md) \ -[Project build error PRJ0019](project-build-error-prj0019.md) \ -[Project build error PRJ0020](project-build-error-prj0020.md) \ -[Project build error PRJ0021](project-build-error-prj0021.md) \ -[Project build error PRJ0022](project-build-error-prj0022.md) \ -[Project build error PRJ0023](project-build-error-prj0023.md) \ -[Project build error PRJ0024](project-build-error-prj0024.md) \ -[Project build error PRJ0025](project-build-error-prj0025.md) \ -[Project build error PRJ0026](project-build-error-prj0026.md) \ -[Project build error PRJ0027](project-build-error-prj0027.md) \ -[Project build error PRJ0028](project-build-error-prj0028.md) \ -[Project build error PRJ0030](project-build-error-prj0030.md) \ -[Project build error PRJ0031](project-build-error-prj0031.md) \ -[Project build error PRJ0032](project-build-error-prj0032.md) \ -[Project build error PRJ0033](project-build-error-prj0033.md) \ -[Project build error PRJ0034](project-build-error-prj0034.md) \ -[Project build error PRJ0035](project-build-error-prj0035.md) \ -[Project build error PRJ0036](project-build-error-prj0036.md) \ -[Project build error PRJ0040](project-build-error-prj0040.md) \ -[Project build error PRJ0044](project-build-error-prj0044.md) \ -[Project build error PRJ0046](project-build-error-prj0046.md) \ -[Project build error PRJ0047](project-build-error-prj0047.md) \ -[Project build error PRJ0050](project-build-error-prj0050.md) +| Error | Message | +|--|--| +| [Project build error PRJ0002](project-build-error-prj0002.md) | error result returned from '*command line*'. | +| [Project build error PRJ0003](project-build-error-prj0003.md) | Error spawning '*command line*'. | +| [Project build error PRJ0004](project-build-error-prj0004.md) | Could not generate command line for the '*tool*' tool. | +| [Project build error PRJ0005](project-build-error-prj0005.md) | Unable to create a temporary file in directory 'directory'. | +| [Project build error PRJ0006](project-build-error-prj0006.md) | Could not open the temporary file 'file'. Make sure the file exists and that the directory is not write-protected. | +| [Project build error PRJ0007](project-build-error-prj0007.md) | Could not create output directory 'directory'. | +| [Project build error PRJ0008](project-build-error-prj0008.md) | Could not delete file 'file'. | +| [Project build error PRJ0009](project-build-error-prj0009.md) | Build log could not be opened for writing. | +| [Project build error PRJ0013](project-build-error-prj0013.md) | System resource could be critically low. Unable to create a pipe required to launch a build. | +| [Project build error PRJ0014](project-build-error-prj0014.md) | The job object used to control the spawned processes has failed. The build cannot continue. | +| [Project build error PRJ0015](project-build-error-prj0015.md) | The NULL device is missing from your system. We are unable to launch a build. | +| [Project build error PRJ0016](project-build-error-prj0016.md) | The user's security settings prevent the process from being created. These settings are required for building. | +| [Project build error PRJ0017](project-build-error-prj0017.md) | The current working directory is invalid. | +| [Project build error PRJ0019](project-build-error-prj0019.md) | A tool returned an error code from | +| [Project build error PRJ0020](project-build-error-prj0020.md) | Tool '*tool*', Property '*property*' contains invalid file name '*file*'. | +| [Project build error PRJ0021](project-build-error-prj0021.md) | Tool '*tool*', Property '*property*' contains invalid file name. | +| [Project build error PRJ0022](project-build-error-prj0022.md) | Unknown Tool, Property '*property*' contains invalid file name '*file*'. | +| [Project build error PRJ0023](project-build-error-prj0023.md) | Tool '*tool*', Unknown Property contains invalid file name '*file*'. | +| [Project build error PRJ0024](project-build-error-prj0024.md) | Unicode path '*path*' could not be translated to user's ANSI code page. | +| [Project build error PRJ0025](project-build-error-prj0025.md) | Batch file '*file*' contains Unicode contents that could not be translated to user's ANSI code page. | +| [Project build error PRJ0026](project-build-error-prj0026.md) | Response file '*file*' contains Unicode contents that could not be translated to user's ANSI code page. | +| [Project build error PRJ0027](project-build-error-prj0027.md) | Unicode log message 'contents' contains content that could not be translated to the user's ANSI code page. | +| [Project build error PRJ0028](project-build-error-prj0028.md) | Temporary file 'file' contains Unicode contents that could not be translated to user's ANSI code page. | +| [Project build error PRJ0030](project-build-error-prj0030.md) | Macro expansion error. Evaluate recursion exceeded 32 levels for $(macro). | +| [Project build error PRJ0031](project-build-error-prj0031.md) | The 'Outputs' property for the custom build step for file 'file' contained 'macro' which evaluates out to 'macro_expansion'. | +| [Project build error PRJ0032](project-build-error-prj0032.md) | The 'Outputs' property for the project-level custom build step contained 'macro' which evaluates out to 'macro_expansion'. | +| [Project build error PRJ0033](project-build-error-prj0033.md) | The 'Additional Dependencies' property for the custom build step for file 'file' contained 'macro' which evaluates out to 'macro_expansion'. | +| [Project build error PRJ0034](project-build-error-prj0034.md) | The 'Additional Dependencies' property for the project-level custom build step contained 'macro' which evaluates out to 'macro_expansion'. | +| [Project build error PRJ0035](project-build-error-prj0035.md) | XML file '*file*' contains Unicode contents that could not be translated to user's ANSI code page. | +| [Project build error PRJ0036](project-build-error-prj0036.md) | The 'Additional Files' property for the Web Deployment Tool contained an invalid entry. | +| [Project build error PRJ0040](project-build-error-prj0040.md) | Internal error on build. Cannot continue. Please reload project and try again. | +| [Project build error PRJ0044](project-build-error-prj0044.md) | The 'Additional Dependencies' property for custom build rule 'rule' assigned to file 'file' is invalid. The property contained 'string' which evaluates to 'value'. | +| [Project build error PRJ0046](project-build-error-prj0046.md) | Could not spawn command line because the one specified was empty. | +| [Project build error PRJ0047](project-build-error-prj0047.md) | Could not resume the suspended process. The build has failed. | +| [Project build error PRJ0050](project-build-error-prj0050.md) | Failed to register output. Please ensure you have the appropriate permissions to modify the registry. | ## Project build warnings -[Project build warning PRJ0018](project-build-warning-prj0018.md) \ -[Project build warning PRJ0029](project-build-warning-prj0029.md) \ -[Project build warning PRJ0041](project-build-warning-prj0041.md) \ -[Project build warning PRJ0042](project-build-warning-prj0042.md) \ -[Project build warning PRJ0049](project-build-warning-prj0049.md) +| Warning | Message | +|--|--| +| [Project build warning PRJ0018](project-build-warning-prj0018.md) | The following environment variables were not found: | +| [Project build warning PRJ0029](project-build-warning-prj0029.md) | The 'Outputs' property for the project-level custom build step is not set. The custom build step will be skipped. | +| [Project build warning PRJ0041](project-build-warning-prj0041.md) | Cannot find missing dependency 'dependency' for file 'file'. Your project may still build, but may continue to appear out of date until this file is found. | +| [Project build warning PRJ0042](project-build-warning-prj0042.md) | The 'Outputs' property for the custom build step for file '*file*' is not set. The custom build step will be skipped. | +| [Project build warning PRJ0049](project-build-warning-prj0049.md) | Referenced target '\' requires .NET Framework \ and will fail to run on this project's target framework | ## See also -[C/C++ Compiler and build tools errors and warnings](../compiler-errors-1/c-cpp-build-errors.md) \ +[C/C++ Compiler and build tools errors and warnings](../compiler-errors-1/c-cpp-build-errors.md)\ [Visual Studio projects | C++](../../build/creating-and-managing-visual-cpp-projects.md) diff --git a/docs/error-messages/tool-errors/project-build-warning-prj0018.md b/docs/error-messages/tool-errors/project-build-warning-prj0018.md index e02b3c1b322..a5ec336c93a 100644 --- a/docs/error-messages/tool-errors/project-build-warning-prj0018.md +++ b/docs/error-messages/tool-errors/project-build-warning-prj0018.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Project Build Warning PRJ0018" title: "Project Build Warning PRJ0018" -ms.date: "11/04/2016" +description: "Learn more about: Project Build Warning PRJ0018" +ms.date: 11/04/2016 f1_keywords: ["PRJ0018"] helpviewer_keywords: ["PRJ0018"] -ms.assetid: 1a3d9e40-6a35-4a74-b6ba-8079f7a82217 --- # Project Build Warning PRJ0018 -The following environment variables were not found: +> The following environment variables were not found: + +## Remarks An environment variable is not defined. This error lists the environment variables that were not defined. diff --git a/docs/error-messages/tool-errors/project-build-warning-prj0029.md b/docs/error-messages/tool-errors/project-build-warning-prj0029.md index cebf87396e8..78a22ac3bac 100644 --- a/docs/error-messages/tool-errors/project-build-warning-prj0029.md +++ b/docs/error-messages/tool-errors/project-build-warning-prj0029.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Project Build Warning PRJ0029" title: "Project Build Warning PRJ0029" -ms.date: "11/04/2016" +description: "Learn more about: Project Build Warning PRJ0029" +ms.date: 11/04/2016 f1_keywords: ["PRJ0029"] helpviewer_keywords: ["PRJ0029"] -ms.assetid: f02c09c6-09f3-4d44-8cd4-9a25336be1ea --- # Project Build Warning PRJ0029 -The 'Outputs' property for the project-level custom build step is not set. The custom build step will be skipped. +> The 'Outputs' property for the project-level custom build step is not set. The custom build step will be skipped. + +## Remarks A custom build step was not executed because no output was specified. diff --git a/docs/error-messages/tool-errors/project-build-warning-prj0041.md b/docs/error-messages/tool-errors/project-build-warning-prj0041.md index 7241c771d4a..4a500c4ce83 100644 --- a/docs/error-messages/tool-errors/project-build-warning-prj0041.md +++ b/docs/error-messages/tool-errors/project-build-warning-prj0041.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Project Build Warning PRJ0041" title: "Project Build Warning PRJ0041" -ms.date: "11/04/2016" +description: "Learn more about: Project Build Warning PRJ0041" +ms.date: 11/04/2016 f1_keywords: ["PRJ0041"] helpviewer_keywords: ["PRJ0041"] -ms.assetid: dc9f4cf9-6bd5-4222-89e8-7802a59bb96b --- # Project Build Warning PRJ0041 -Cannot find missing dependency 'dependency' for file 'file'. Your project may still build, but may continue to appear out of date until this file is found. +> Cannot find missing dependency 'dependency' for file 'file'. Your project may still build, but may continue to appear out of date until this file is found. + +## Remarks A file (resource file or .idl/.odl file, for example, contained an include statement that the project system could not resolve. diff --git a/docs/error-messages/tool-errors/project-build-warning-prj0042.md b/docs/error-messages/tool-errors/project-build-warning-prj0042.md index 3951812d71c..a85189952fa 100644 --- a/docs/error-messages/tool-errors/project-build-warning-prj0042.md +++ b/docs/error-messages/tool-errors/project-build-warning-prj0042.md @@ -1,15 +1,16 @@ --- -description: "Learn more about: Project Build Warning PRJ0042" title: "Project Build Warning PRJ0042" -ms.date: "08/27/2018" +description: "Learn more about: Project Build Warning PRJ0042" +ms.date: 08/27/2018 f1_keywords: ["PRJ0042"] helpviewer_keywords: ["PRJ0042"] -ms.assetid: 682c9999-6f85-409f-b102-00c93243f74f --- # Project Build Warning PRJ0042 > The 'Outputs' property for the custom build step for file '*file*' is not set. The custom build step will be skipped. +## Remarks + A custom build step was not executed because no output was specified. To resolve this error, do one the following: diff --git a/docs/error-messages/tool-errors/project-build-warning-prj0049.md b/docs/error-messages/tool-errors/project-build-warning-prj0049.md index ee21f0e2b2a..0073df2310b 100644 --- a/docs/error-messages/tool-errors/project-build-warning-prj0049.md +++ b/docs/error-messages/tool-errors/project-build-warning-prj0049.md @@ -1,13 +1,15 @@ --- -description: "Learn more about: Project Build Warning PRJ0049" title: "Project Build Warning PRJ0049" -ms.date: "11/04/2016" +description: "Learn more about: Project Build Warning PRJ0049" +ms.date: 11/04/2016 +f1_keywords: ["PRJ0049"] helpviewer_keywords: ["PRJ0049"] -ms.assetid: 8b38afa1-e080-4efd-ae89-776cfd044413 --- # Project Build Warning PRJ0049 -Referenced target '\' requires .NET Framework \ and will fail to run on this project's target framework +> Referenced target '\' requires .NET Framework \ and will fail to run on this project's target framework + +## Remarks Applications created by using Visual Studio 2008 can specify which version of the .NET Framework they should target. If you add a reference to an assembly or project that depends on a version of the .NET Framework that is later than the targeted version, you will get this warning at compile time. diff --git a/docs/error-messages/tool-errors/resource-compiler-error-rc2001.md b/docs/error-messages/tool-errors/resource-compiler-error-rc2001.md index a6dc03c0ac6..b807eea4e4a 100644 --- a/docs/error-messages/tool-errors/resource-compiler-error-rc2001.md +++ b/docs/error-messages/tool-errors/resource-compiler-error-rc2001.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Resource Compiler Error RC2001" title: "Resource Compiler Error RC2001" -ms.date: "11/04/2016" +description: "Learn more about: Resource Compiler Error RC2001" +ms.date: 11/04/2016 f1_keywords: ["RC2001"] helpviewer_keywords: ["RC2001"] -ms.assetid: 92bfb4c0-1879-4606-bb9f-ef7368707b4a --- # Resource Compiler Error RC2001 -newline in constant +> newline in constant + +## Remarks A string constant was continued on a second line without either a backslash (**\\**) or closing and opening double quotation marks (**"**). diff --git a/docs/error-messages/tool-errors/resource-compiler-error-rc2007.md b/docs/error-messages/tool-errors/resource-compiler-error-rc2007.md index 7273ed71fdf..dbfac5c5bfb 100644 --- a/docs/error-messages/tool-errors/resource-compiler-error-rc2007.md +++ b/docs/error-messages/tool-errors/resource-compiler-error-rc2007.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Resource Compiler Error RC2007" title: "Resource Compiler Error RC2007" -ms.date: "11/04/2016" +description: "Learn more about: Resource Compiler Error RC2007" +ms.date: 11/04/2016 f1_keywords: ["RC2007"] helpviewer_keywords: ["RC2007"] -ms.assetid: a616e506-bef2-4155-9fe0-dbccac8954d3 --- # Resource Compiler Error RC2007 -\#define syntax +> #define syntax + +## Remarks An identifier was expected following `#define` in a preprocessing directive. diff --git a/docs/error-messages/tool-errors/resource-compiler-error-rc2015.md b/docs/error-messages/tool-errors/resource-compiler-error-rc2015.md index 5b717ab7cbc..035bfd9f4fd 100644 --- a/docs/error-messages/tool-errors/resource-compiler-error-rc2015.md +++ b/docs/error-messages/tool-errors/resource-compiler-error-rc2015.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Resource Compiler Error RC2015" title: "Resource Compiler Error RC2015" -ms.date: "11/04/2016" +description: "Learn more about: Resource Compiler Error RC2015" +ms.date: 11/04/2016 f1_keywords: ["RC2015"] helpviewer_keywords: ["RC2015"] -ms.assetid: 99691683-fb9e-4e61-beb1-12e484858570 --- # Resource Compiler Error RC2015 -too many chars in constant +> too many chars in constant + +## Remarks A character constant contained more than two characters. diff --git a/docs/error-messages/tool-errors/resource-compiler-error-rc2017.md b/docs/error-messages/tool-errors/resource-compiler-error-rc2017.md index abba418bcbe..f0ea17ecac3 100644 --- a/docs/error-messages/tool-errors/resource-compiler-error-rc2017.md +++ b/docs/error-messages/tool-errors/resource-compiler-error-rc2017.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Resource Compiler Error RC2017" title: "Resource Compiler Error RC2017" -ms.date: "11/04/2016" +description: "Learn more about: Resource Compiler Error RC2017" +ms.date: 11/04/2016 f1_keywords: ["RC2017"] helpviewer_keywords: ["RC2017"] -ms.assetid: 5fcc0135-cd60-4b1d-a7dd-8a4f2312697b --- # Resource Compiler Error RC2017 -illegal escape sequence +> illegal escape sequence + +## Remarks An escape sequence appeared where one was not expected. diff --git a/docs/error-messages/tool-errors/resource-compiler-error-rc2101.md b/docs/error-messages/tool-errors/resource-compiler-error-rc2101.md index 90d7026affd..95a520dc668 100644 --- a/docs/error-messages/tool-errors/resource-compiler-error-rc2101.md +++ b/docs/error-messages/tool-errors/resource-compiler-error-rc2101.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Resource Compiler Error RC2101" title: "Resource Compiler Error RC2101" -ms.date: "11/04/2016" +description: "Learn more about: Resource Compiler Error RC2101" +ms.date: 11/04/2016 f1_keywords: ["RC2101"] helpviewer_keywords: ["RC2101"] -ms.assetid: 580f9d74-162f-41e9-9438-ddbe3457c359 --- # Resource Compiler Error RC2101 -Invalid directive in preprocessed RC file +> Invalid directive in preprocessed RC file + +## Remarks The Resource Compiler file contains a **#pragma** directive. diff --git a/docs/error-messages/tool-errors/resource-compiler-error-rc2103.md b/docs/error-messages/tool-errors/resource-compiler-error-rc2103.md index c49524f2c12..2399c255c57 100644 --- a/docs/error-messages/tool-errors/resource-compiler-error-rc2103.md +++ b/docs/error-messages/tool-errors/resource-compiler-error-rc2103.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Resource Compiler Error RC2103" title: "Resource Compiler Error RC2103" -ms.date: "11/04/2016" +description: "Learn more about: Resource Compiler Error RC2103" +ms.date: 11/04/2016 f1_keywords: ["RC2103"] helpviewer_keywords: ["RC2103"] -ms.assetid: eedf2366-d1c3-4e7e-815c-d367d976b3f6 --- # Resource Compiler Error RC2103 -unexpected end of file in string literal +> unexpected end of file in string literal + +## Remarks An end of file was found before the end of a string. The string is probably missing a closing double quotation mark (**"**). diff --git a/docs/error-messages/tool-errors/resource-compiler-error-rc2104.md b/docs/error-messages/tool-errors/resource-compiler-error-rc2104.md index eb9bbcda543..1ce67b04525 100644 --- a/docs/error-messages/tool-errors/resource-compiler-error-rc2104.md +++ b/docs/error-messages/tool-errors/resource-compiler-error-rc2104.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Resource Compiler Error RC2104" title: "Resource Compiler Error RC2104" -ms.date: "11/04/2016" +description: "Learn more about: Resource Compiler Error RC2104" +ms.date: 11/04/2016 f1_keywords: ["RC2104"] helpviewer_keywords: ["RC2104"] -ms.assetid: 792a3bd8-cb4c-4817-b288-4ce37082b582 --- # Resource Compiler Error RC2104 -undefined keyword or key name: key +> undefined keyword or key name: key + +## Remarks The specified keyword or key name is not defined. diff --git a/docs/error-messages/tool-errors/resource-compiler-error-rc2107.md b/docs/error-messages/tool-errors/resource-compiler-error-rc2107.md index 329977b1988..9258f3d82c9 100644 --- a/docs/error-messages/tool-errors/resource-compiler-error-rc2107.md +++ b/docs/error-messages/tool-errors/resource-compiler-error-rc2107.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Resource Compiler Error RC2107" title: "Resource Compiler Error RC2107" -ms.date: "11/04/2016" +description: "Learn more about: Resource Compiler Error RC2107" +ms.date: 11/04/2016 f1_keywords: ["RC2107"] helpviewer_keywords: ["RC2107"] -ms.assetid: f1786128-aa86-4cdb-a095-05a0b66b5608 --- # Resource Compiler Error RC2107 -**expected numeric command value** +> expected numeric command value + +## Remarks The Resource Compiler was expecting a numeric *idvalue* field in the **ACCELERATORS** statement. Make sure that you have used a `#define` constant to specify the value and that the constant is spelled correctly. diff --git a/docs/error-messages/tool-errors/resource-compiler-error-rc2109.md b/docs/error-messages/tool-errors/resource-compiler-error-rc2109.md index f94aac2e868..28eaffebead 100644 --- a/docs/error-messages/tool-errors/resource-compiler-error-rc2109.md +++ b/docs/error-messages/tool-errors/resource-compiler-error-rc2109.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Resource Compiler Error RC2109" title: "Resource Compiler Error RC2109" -ms.date: "11/04/2016" +description: "Learn more about: Resource Compiler Error RC2109" +ms.date: 11/04/2016 f1_keywords: ["RC2109"] helpviewer_keywords: ["RC2109"] -ms.assetid: b800aa67-33c0-42f5-81a2-7a64a3b6b824 --- # Resource Compiler Error RC2109 -expected numerical dialog constant +> expected numerical dialog constant + +## Remarks A **DIALOG** statement requires integer values for the *x, y, width*, and *height* fields. Make sure these values are included after the **DIALOG** keyword and that they are not negative. diff --git a/docs/error-messages/tool-errors/resource-compiler-error-rc2111.md b/docs/error-messages/tool-errors/resource-compiler-error-rc2111.md index 20b4cc9b36d..159bd5e1ed8 100644 --- a/docs/error-messages/tool-errors/resource-compiler-error-rc2111.md +++ b/docs/error-messages/tool-errors/resource-compiler-error-rc2111.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Resource Compiler Error RC2111" title: "Resource Compiler Error RC2111" -ms.date: "11/04/2016" +description: "Learn more about: Resource Compiler Error RC2111" +ms.date: 11/04/2016 f1_keywords: ["RC2111"] helpviewer_keywords: ["RC2111"] -ms.assetid: 118cba57-82a4-4199-acf4-9d9561946218 --- # Resource Compiler Error RC2111 -invalid control type +> invalid control type + +## Remarks Each CONTROL statement in a **DIALOG** statement must be one of the following: 3STATE, AUTO3, AUTOCHECK, AUTORADIO, BEDIT, CHECKBOX, COMBOBOX, CONTROL, CTEXT, DEFPUSHBUTTON, EDITTEXT, GROUPBOX, HEDIT, ICON, IEDIT, LISTBOX, LTEXT, PUSHBOX, PUSHBUTTON, RADIOBUTTON, RTEXT, SCROLLBAR, USERBUTTON. diff --git a/docs/error-messages/tool-errors/resource-compiler-error-rc2112.md b/docs/error-messages/tool-errors/resource-compiler-error-rc2112.md index 452c0280680..e03480d20e3 100644 --- a/docs/error-messages/tool-errors/resource-compiler-error-rc2112.md +++ b/docs/error-messages/tool-errors/resource-compiler-error-rc2112.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Resource Compiler Error RC2112" title: "Resource Compiler Error RC2112" -ms.date: "11/04/2016" +description: "Learn more about: Resource Compiler Error RC2112" +ms.date: 11/04/2016 f1_keywords: ["RC2112"] helpviewer_keywords: ["RC2112"] -ms.assetid: e9f29540-a90d-4989-a6e8-5f8f32015bd9 --- # Resource Compiler Error RC2112 -BEGIN expected in dialog +> BEGIN expected in dialog + +## Remarks The **BEGIN** keyword must immediately follow the **DIALOG** keyword. diff --git a/docs/error-messages/tool-errors/resource-compiler-error-rc2113.md b/docs/error-messages/tool-errors/resource-compiler-error-rc2113.md index c62fc7fcbf1..d33a9cd82ca 100644 --- a/docs/error-messages/tool-errors/resource-compiler-error-rc2113.md +++ b/docs/error-messages/tool-errors/resource-compiler-error-rc2113.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Resource Compiler Error RC2113" title: "Resource Compiler Error RC2113" -ms.date: "11/04/2016" +description: "Learn more about: Resource Compiler Error RC2113" +ms.date: 11/04/2016 f1_keywords: ["RC2113"] helpviewer_keywords: ["RC2113"] -ms.assetid: cbf52e93-ab14-49b7-9ce8-fb55877602ec --- # Resource Compiler Error RC2113 -END expected in dialog +> END expected in dialog + +## Remarks The **END** keyword must occur at the end of a **DIALOG** statement. Make sure there are no open quotes left from the preceding statement. diff --git a/docs/error-messages/tool-errors/resource-compiler-error-rc2114.md b/docs/error-messages/tool-errors/resource-compiler-error-rc2114.md index 87705494bec..d43e41ab86f 100644 --- a/docs/error-messages/tool-errors/resource-compiler-error-rc2114.md +++ b/docs/error-messages/tool-errors/resource-compiler-error-rc2114.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Resource Compiler Error RC2114" title: "Resource Compiler Error RC2114" -ms.date: "11/04/2016" +description: "Learn more about: Resource Compiler Error RC2114" +ms.date: 11/04/2016 f1_keywords: ["RC2114"] helpviewer_keywords: ["RC2114"] -ms.assetid: abdfdc46-6601-451f-8e81-81e92bcd2208 --- # Resource Compiler Error RC2114 -expected control class name +> expected control class name + +## Remarks The `class` field of a CONTROL statement in the **DIALOG** statement must be one of the following types: BUTTON, COMBOBOX, EDIT, LISTBOX, SCROLLBAR, STATIC, or user-defined. Make sure the class is spelled correctly. diff --git a/docs/error-messages/tool-errors/resource-compiler-error-rc2116.md b/docs/error-messages/tool-errors/resource-compiler-error-rc2116.md index c43b2deabbb..1b227079bfe 100644 --- a/docs/error-messages/tool-errors/resource-compiler-error-rc2116.md +++ b/docs/error-messages/tool-errors/resource-compiler-error-rc2116.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Resource Compiler Error RC2116" title: "Resource Compiler Error RC2116" -ms.date: "11/04/2016" +description: "Learn more about: Resource Compiler Error RC2116" +ms.date: 11/04/2016 f1_keywords: ["RC2116"] helpviewer_keywords: ["RC2116"] -ms.assetid: d9203ddf-798d-490b-be41-0dd3f7d53653 --- # Resource Compiler Error RC2116 -expecting number for ID +> expecting number for ID + +## Remarks Expecting a number for the `id` field of a control statement in the **DIALOG** statement. Make sure you have a number or `#define` statement for the control ID. diff --git a/docs/error-messages/tool-errors/resource-compiler-error-rc2122.md b/docs/error-messages/tool-errors/resource-compiler-error-rc2122.md index 7a8d7e682d3..d275f06f2a9 100644 --- a/docs/error-messages/tool-errors/resource-compiler-error-rc2122.md +++ b/docs/error-messages/tool-errors/resource-compiler-error-rc2122.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Resource Compiler Error RC2122" title: "Resource Compiler Error RC2122" -ms.date: "11/04/2016" +description: "Learn more about: Resource Compiler Error RC2122" +ms.date: 11/04/2016 f1_keywords: ["RC2122"] helpviewer_keywords: ["RC2122"] -ms.assetid: c2f02ec1-1ce8-4a13-b35e-7cd416fa9f41 --- # Resource Compiler Error RC2122 -unknown menu subtype +> unknown menu subtype + +## Remarks The *item-definition* field of the **MENU** statement can contain only **MENUITEM** and **POPUP** statements. diff --git a/docs/error-messages/tool-errors/resource-compiler-error-rc2124.md b/docs/error-messages/tool-errors/resource-compiler-error-rc2124.md index a7b4b921d33..eb59025dd5f 100644 --- a/docs/error-messages/tool-errors/resource-compiler-error-rc2124.md +++ b/docs/error-messages/tool-errors/resource-compiler-error-rc2124.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Resource Compiler Error RC2124" title: "Resource Compiler Error RC2124" -ms.date: "11/04/2016" +description: "Learn more about: Resource Compiler Error RC2124" +ms.date: 11/04/2016 f1_keywords: ["RC2124"] helpviewer_keywords: ["RC2124"] -ms.assetid: 4eb5c4ec-ca9b-46a0-805b-35e040e9ed41 --- # Resource Compiler Error RC2124 -empty menus not allowed +> empty menus not allowed + +## Remarks An **END** keyword appears before any menu items are defined in the **MENU** statement. The Resource Compiler does not permit empty menus. Make sure you do not have any open quotation marks within the **MENU** statement. diff --git a/docs/error-messages/tool-errors/resource-compiler-error-rc2127.md b/docs/error-messages/tool-errors/resource-compiler-error-rc2127.md index c3a1a1018d4..a82cf52c6db 100644 --- a/docs/error-messages/tool-errors/resource-compiler-error-rc2127.md +++ b/docs/error-messages/tool-errors/resource-compiler-error-rc2127.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Resource Compiler Error RC2127" title: "Resource Compiler Error RC2127" -ms.date: "11/04/2016" +description: "Learn more about: Resource Compiler Error RC2127" +ms.date: 11/04/2016 f1_keywords: ["RC2127"] helpviewer_keywords: ["RC2127"] -ms.assetid: 13c1599d-ac4c-4044-a59a-48e69511ef7e --- # Resource Compiler Error RC2127 -version WORDs separated by commas expected +> version WORDs separated by commas expected + +## Remarks Version numbers in a version resource should be of type **WORD**, and separated by commas. diff --git a/docs/error-messages/tool-errors/resource-compiler-error-rc2135.md b/docs/error-messages/tool-errors/resource-compiler-error-rc2135.md index 81091b335fb..e4a11942710 100644 --- a/docs/error-messages/tool-errors/resource-compiler-error-rc2135.md +++ b/docs/error-messages/tool-errors/resource-compiler-error-rc2135.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Resource Compiler Error RC2135" title: "Resource Compiler Error RC2135" -ms.date: "11/04/2016" +description: "Learn more about: Resource Compiler Error RC2135" +ms.date: 11/04/2016 f1_keywords: ["RC2135"] helpviewer_keywords: ["RC2135"] -ms.assetid: 1509a0fa-1cb7-4654-bcb3-ad5ac973e659 --- # Resource Compiler Error RC2135 -file not found: filename +> file not found: filename + +## Remarks The file specified in the Resource Compiler command line was not found. Check to see whether the file has been moved to another directory and whether the file name and path are typed correctly. diff --git a/docs/error-messages/tool-errors/resource-compiler-error-rc2144.md b/docs/error-messages/tool-errors/resource-compiler-error-rc2144.md index 18382c57438..7fe5c107fca 100644 --- a/docs/error-messages/tool-errors/resource-compiler-error-rc2144.md +++ b/docs/error-messages/tool-errors/resource-compiler-error-rc2144.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Resource Compiler Error RC2144" title: "Resource Compiler Error RC2144" -ms.date: "11/04/2016" +description: "Learn more about: Resource Compiler Error RC2144" +ms.date: 11/04/2016 f1_keywords: ["RC2144"] helpviewer_keywords: ["RC2144"] -ms.assetid: 1b3ff39a-92cd-4a04-b1a3-b1fa6a805813 --- # Resource Compiler Error RC2144 -PRIMARY LANGUAGE ID not a number +> PRIMARY LANGUAGE ID not a number + +## Remarks The PRIMARY LANGUAGE ID must be a hexadecimal language ID. See [Language and Country/Region Strings](../../c-runtime-library/locale-names-languages-and-country-region-strings.md) in the *Run-Time Library Reference* for a list of valid Language IDs. diff --git a/docs/error-messages/tool-errors/resource-compiler-error-rc2147.md b/docs/error-messages/tool-errors/resource-compiler-error-rc2147.md index 6e29e0a636e..09009bcb002 100644 --- a/docs/error-messages/tool-errors/resource-compiler-error-rc2147.md +++ b/docs/error-messages/tool-errors/resource-compiler-error-rc2147.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Resource Compiler Error RC2147" title: "Resource Compiler Error RC2147" -ms.date: "11/04/2016" +description: "Learn more about: Resource Compiler Error RC2147" +ms.date: 11/04/2016 f1_keywords: ["RC2147"] helpviewer_keywords: ["RC2147"] -ms.assetid: 09974f06-1731-4e70-b373-f9218e0ee8d9 --- # Resource Compiler Error RC2147 -SUBLANGUAGE ID not a number +> SUBLANGUAGE ID not a number + +## Remarks The SUBLANGUAGE ID value must be a number. diff --git a/docs/error-messages/tool-errors/resource-compiler-error-rc2148.md b/docs/error-messages/tool-errors/resource-compiler-error-rc2148.md index a5db826be2f..40d6110c5cc 100644 --- a/docs/error-messages/tool-errors/resource-compiler-error-rc2148.md +++ b/docs/error-messages/tool-errors/resource-compiler-error-rc2148.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Resource Compiler Error RC2148" title: "Resource Compiler Error RC2148" -ms.date: "11/04/2016" +description: "Learn more about: Resource Compiler Error RC2148" +ms.date: 11/04/2016 f1_keywords: ["RC2148"] helpviewer_keywords: ["RC2148"] -ms.assetid: 0290065c-35d3-4815-80c5-40bf7132ae1d --- # Resource Compiler Error RC2148 -SUBLANGUAGE ID too large +> SUBLANGUAGE ID too large + +## Remarks The SUBLANGUAGE ID value was out of range. diff --git a/docs/error-messages/tool-errors/resource-compiler-error-rc2151.md b/docs/error-messages/tool-errors/resource-compiler-error-rc2151.md index 5f5b597acdd..3ed804bfabf 100644 --- a/docs/error-messages/tool-errors/resource-compiler-error-rc2151.md +++ b/docs/error-messages/tool-errors/resource-compiler-error-rc2151.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Resource Compiler Error RC2151" title: "Resource Compiler Error RC2151" -ms.date: "11/04/2016" +description: "Learn more about: Resource Compiler Error RC2151" +ms.date: 11/04/2016 f1_keywords: ["RC2151"] helpviewer_keywords: ["RC2151"] -ms.assetid: 3c47e535-c78d-4338-aab9-9b47e2c34728 --- # Resource Compiler Error RC2151 -cannot re-use string constants +> cannot re-use string constants + +## Remarks You are using the same value twice in a **STRINGTABLE** statement. Make sure you are not mixing overlapping decimal and hexadecimal values. diff --git a/docs/error-messages/tool-errors/resource-compiler-error-rc2152.md b/docs/error-messages/tool-errors/resource-compiler-error-rc2152.md index 543e1ca9945..ff275d02746 100644 --- a/docs/error-messages/tool-errors/resource-compiler-error-rc2152.md +++ b/docs/error-messages/tool-errors/resource-compiler-error-rc2152.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Resource Compiler Error RC2152" title: "Resource Compiler Error RC2152" -ms.date: "11/04/2016" +description: "Learn more about: Resource Compiler Error RC2152" +ms.date: 11/04/2016 f1_keywords: ["RC2152"] helpviewer_keywords: ["RC2152"] -ms.assetid: 8efcba8f-9971-43cc-a1cd-8d7c9aec133c --- # Resource Compiler Error RC2152 -invalid control character +> invalid control character + +## Remarks A control character in the **ACCELERATORS** statement is invalid. A valid control character consists of one letter (only) following a caret (**^**). diff --git a/docs/error-messages/tool-errors/resource-compiler-error-rc2162.md b/docs/error-messages/tool-errors/resource-compiler-error-rc2162.md index b88dac5c06d..9a45dc6be3e 100644 --- a/docs/error-messages/tool-errors/resource-compiler-error-rc2162.md +++ b/docs/error-messages/tool-errors/resource-compiler-error-rc2162.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Resource Compiler Error RC2162" title: "Resource Compiler Error RC2162" -ms.date: "11/04/2016" +description: "Learn more about: Resource Compiler Error RC2162" +ms.date: 11/04/2016 f1_keywords: ["RC2162"] helpviewer_keywords: ["RC2162"] -ms.assetid: 4ac713b7-3067-436c-83fd-4180438c4f2c --- # Resource Compiler Error RC2162 -expected macro formal parameter +> expected macro formal parameter + +## Remarks The token following a stringizing operator (**#**) was not a formal parameter name. diff --git a/docs/error-messages/tool-errors/resource-compiler-error-rc2163.md b/docs/error-messages/tool-errors/resource-compiler-error-rc2163.md index 236af060128..6db89f5ffed 100644 --- a/docs/error-messages/tool-errors/resource-compiler-error-rc2163.md +++ b/docs/error-messages/tool-errors/resource-compiler-error-rc2163.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Resource Compiler Error RC2163" title: "Resource Compiler Error RC2163" -ms.date: "11/04/2016" +description: "Learn more about: Resource Compiler Error RC2163" +ms.date: 11/04/2016 f1_keywords: ["RC2163"] helpviewer_keywords: ["RC2163"] -ms.assetid: a7e95939-9267-4262-9b49-90dc4157a7da --- # Resource Compiler Error RC2163 -accelerator type required [ASCII or VIRTKEY] +> accelerator type required [ASCII or VIRTKEY] + +## Remarks The `type` field in the **ACCELERATORS** statement must contain either the ASCII or VIRTKEY value. diff --git a/docs/error-messages/tool-errors/resource-compiler-error-rc2164.md b/docs/error-messages/tool-errors/resource-compiler-error-rc2164.md index b6ea0321840..532f85db497 100644 --- a/docs/error-messages/tool-errors/resource-compiler-error-rc2164.md +++ b/docs/error-messages/tool-errors/resource-compiler-error-rc2164.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Resource Compiler Error RC2164" title: "Resource Compiler Error RC2164" -ms.date: "11/04/2016" +description: "Learn more about: Resource Compiler Error RC2164" +ms.date: 11/04/2016 f1_keywords: ["RC2164"] helpviewer_keywords: ["RC2164"] -ms.assetid: 23d7691d-80f3-4979-a519-378e5498d2d1 --- # Resource Compiler Error RC2164 -unexpected value in RCDATA +> unexpected value in RCDATA + +## Remarks The *raw-data* values in the **RCDATA** statement must be integers or strings, each separated by a comma. Make sure you did not leave out a comma or leave out a quotation mark around a string. diff --git a/docs/error-messages/tool-errors/resource-compiler-error-rc2165.md b/docs/error-messages/tool-errors/resource-compiler-error-rc2165.md index d0fc2be2f2b..f18cebc686b 100644 --- a/docs/error-messages/tool-errors/resource-compiler-error-rc2165.md +++ b/docs/error-messages/tool-errors/resource-compiler-error-rc2165.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Resource Compiler Error RC2165" title: "Resource Compiler Error RC2165" -ms.date: "11/04/2016" +description: "Learn more about: Resource Compiler Error RC2165" +ms.date: 11/04/2016 f1_keywords: ["RC2165"] helpviewer_keywords: ["RC2165"] -ms.assetid: bf7d4630-9355-47e3-87fa-6693fcf0ef0d --- # Resource Compiler Error RC2165 -string not found in DLGINCLUDE statement +> string not found in DLGINCLUDE statement + +## Remarks The statement did not specify a valid include file. diff --git a/docs/error-messages/tool-errors/resource-compiler-error-rc2167.md b/docs/error-messages/tool-errors/resource-compiler-error-rc2167.md index 930bd48228a..ac84004be8e 100644 --- a/docs/error-messages/tool-errors/resource-compiler-error-rc2167.md +++ b/docs/error-messages/tool-errors/resource-compiler-error-rc2167.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Resource Compiler Error RC2167" title: "Resource Compiler Error RC2167" -ms.date: "11/04/2016" +description: "Learn more about: Resource Compiler Error RC2167" +ms.date: 11/04/2016 f1_keywords: ["RC2167"] helpviewer_keywords: ["RC2167"] -ms.assetid: 9b24a8eb-367b-4ff6-8266-b0c215f32d6a --- # Resource Compiler Error RC2167 -unrecognized VERSIONINFO field; BEGIN or comma expected +> unrecognized VERSIONINFO field; BEGIN or comma expected + +## Remarks An unrecognized field was found in the **FIXED** part of a **VERSIONINFO** structure declaration. A **VERSIONINFO** field must be DWORDS separated by a comma. diff --git a/docs/error-messages/tool-errors/resource-compiler-error-rc2169.md b/docs/error-messages/tool-errors/resource-compiler-error-rc2169.md index 361c09d9706..78767f39494 100644 --- a/docs/error-messages/tool-errors/resource-compiler-error-rc2169.md +++ b/docs/error-messages/tool-errors/resource-compiler-error-rc2169.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Resource Compiler Error RC2169" title: "Resource Compiler Error RC2169" -ms.date: "11/04/2016" +description: "Learn more about: Resource Compiler Error RC2169" +ms.date: 11/04/2016 f1_keywords: ["RC2169"] helpviewer_keywords: ["RC2169"] -ms.assetid: 832c19ad-a2e2-4f50-b493-26b791877600 --- # Resource Compiler Error RC2169 -resource file filename is not in 2.03 format +> resource file filename is not in 2.03 format + +## Remarks The specified resource used a format earlier than version 2.03. The resource file must be converted or recreated using the format for version 3.00 or later. diff --git a/docs/error-messages/tool-errors/resource-compiler-error-rc2170.md b/docs/error-messages/tool-errors/resource-compiler-error-rc2170.md index 4aba900e450..c0ed41f444d 100644 --- a/docs/error-messages/tool-errors/resource-compiler-error-rc2170.md +++ b/docs/error-messages/tool-errors/resource-compiler-error-rc2170.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Resource Compiler Error RC2170" title: "Resource Compiler Error RC2170" -ms.date: "11/04/2016" +description: "Learn more about: Resource Compiler Error RC2170" +ms.date: 11/04/2016 f1_keywords: ["RC2170"] helpviewer_keywords: ["RC2170"] -ms.assetid: 6ea80c98-0942-41a8-b0b2-2c16c255adf5 --- # Resource Compiler Error RC2170 -bitmap file filename is not in 3.00 format +> bitmap file filename is not in 3.00 format + +## Remarks Bitmaps using the Windows version 2.x format cannot be used in version 3.x resource files. diff --git a/docs/error-messages/tool-errors/resource-compiler-error-rc2171.md b/docs/error-messages/tool-errors/resource-compiler-error-rc2171.md index 13e76b8e9c9..c8b1c0605d8 100644 --- a/docs/error-messages/tool-errors/resource-compiler-error-rc2171.md +++ b/docs/error-messages/tool-errors/resource-compiler-error-rc2171.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Resource Compiler Error RC2171" title: "Resource Compiler Error RC2171" -ms.date: "11/04/2016" +description: "Learn more about: Resource Compiler Error RC2171" +ms.date: 11/04/2016 f1_keywords: ["RC2171"] helpviewer_keywords: ["RC2171"] -ms.assetid: 0c959938-e744-43f3-b460-f05547ffea2a --- # Resource Compiler Error RC2171 -unknown DIB header format +> unknown DIB header format + +## Remarks The bitmap header is not a **BITMAPCOREHEADER** or **BITMAPINFOHEADER** structure. diff --git a/docs/error-messages/tool-errors/resource-compiler-error-rc2175.md b/docs/error-messages/tool-errors/resource-compiler-error-rc2175.md index 41d4e56fa14..3c74a7ea3c4 100644 --- a/docs/error-messages/tool-errors/resource-compiler-error-rc2175.md +++ b/docs/error-messages/tool-errors/resource-compiler-error-rc2175.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Resource Compiler Error RC2175" title: "Resource Compiler Error RC2175" -ms.date: "11/04/2016" +description: "Learn more about: Resource Compiler Error RC2175" +ms.date: 11/04/2016 f1_keywords: ["RC2175"] helpviewer_keywords: ["RC2175"] -ms.assetid: 3864a371-dba8-41a7-962c-e792709774f1 --- # Resource Compiler Error RC2175 -resource file filename is not in 3.00 format +> resource file filename is not in 3.00 format + +## Remarks The specified resource used a format earlier than version 3.00. The resource file must be converted or recreated using the format for version 3.00 or later. diff --git a/docs/error-messages/tool-errors/resource-compiler-error-rw2001.md b/docs/error-messages/tool-errors/resource-compiler-error-rw2001.md index 197696abe86..c4ae99cc7aa 100644 --- a/docs/error-messages/tool-errors/resource-compiler-error-rw2001.md +++ b/docs/error-messages/tool-errors/resource-compiler-error-rw2001.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Resource Compiler Error RW2001" title: "Resource Compiler Error RW2001" -ms.date: "11/04/2016" +description: "Learn more about: Resource Compiler Error RW2001" +ms.date: 11/04/2016 f1_keywords: ["RW2001"] helpviewer_keywords: ["RW2001"] -ms.assetid: 963bdc7d-6ebe-4378-8bbc-47dfcf5d330c --- # Resource Compiler Error RW2001 -Invalid directive in preprocessed RC file +> Invalid directive in preprocessed RC file + +## Remarks The RC file contains a **#pragma** directive. diff --git a/docs/error-messages/tool-errors/resource-compiler-error-rw2002.md b/docs/error-messages/tool-errors/resource-compiler-error-rw2002.md index c2e99143b32..f840e80f4ea 100644 --- a/docs/error-messages/tool-errors/resource-compiler-error-rw2002.md +++ b/docs/error-messages/tool-errors/resource-compiler-error-rw2002.md @@ -1,14 +1,13 @@ --- -description: "Learn more about: Resource Compiler Error RW2002" title: "Resource Compiler Error RW2002" -ms.date: "11/04/2016" +description: "Learn more about: Resource Compiler Error RW2002" +ms.date: 11/04/2016 f1_keywords: ["RW2002"] helpviewer_keywords: ["RW2002"] -ms.assetid: b1d1a49b-b50b-4b0b-9f09-c7762e2dbe8f --- # Resource Compiler Error RW2002 -Parsing error +> Parsing error ### To fix by checking the following possible causes diff --git a/docs/error-messages/tool-errors/resource-compiler-error-rw2003.md b/docs/error-messages/tool-errors/resource-compiler-error-rw2003.md index 13968d07395..22346f8261c 100644 --- a/docs/error-messages/tool-errors/resource-compiler-error-rw2003.md +++ b/docs/error-messages/tool-errors/resource-compiler-error-rw2003.md @@ -1,14 +1,13 @@ --- -description: "Learn more about: Resource Compiler Error RW2003" title: "Resource Compiler Error RW2003" -ms.date: "11/04/2016" +description: "Learn more about: Resource Compiler Error RW2003" +ms.date: 11/04/2016 f1_keywords: ["RW2003"] helpviewer_keywords: ["RW2003"] -ms.assetid: 9dc0ba70-6776-4aef-b316-5f1711d8e42e --- # Resource Compiler Error RW2003 -Generation Error +> Generation Error ### To fix by checking the following possible causes diff --git a/docs/error-messages/tool-errors/resource-compiler-errors-rc1000-through-rc4413.md b/docs/error-messages/tool-errors/resource-compiler-errors-rc1000-through-rc4413.md index 86313c39160..74e0908987d 100644 --- a/docs/error-messages/tool-errors/resource-compiler-errors-rc1000-through-rc4413.md +++ b/docs/error-messages/tool-errors/resource-compiler-errors-rc1000-through-rc4413.md @@ -1,98 +1,103 @@ --- -description: "Learn more about: Resource compiler errors and warnings (RCxxxx, RWxxxx)" title: "Resource compiler errors and warnings" -ms.date: "04/17/2019" -ms.assetid: 0819f955-0561-491d-af3d-2453f4e2d035 +description: "Learn more about: Resource compiler errors and warnings (RCxxxx, RWxxxx)" +ms.date: 04/17/2019 --- # Resource compiler errors and warnings (RCxxxx, RWxxxx) This section is a reference to the errors generated by the resource compiler. Resource compiler errors and warnings have the form RC*xxxx* or RW*xxxx*, where *xxxx* is a four-digit number. -[!INCLUDE[error-boilerplate](../../error-messages/includes/error-boilerplate.md)] +[!INCLUDE[error-boilerplate](../includes/error-boilerplate.md)] ## Resource compiler fatal errors -[Resource compiler fatal error RC1002](resource-compiler-fatal-error-rc1002.md) \ -[Resource compiler fatal error RC1004](resource-compiler-fatal-error-rc1004.md) \ -[Resource compiler fatal error RC1009](resource-compiler-fatal-error-rc1009.md) \ -[Resource compiler fatal error RC1011](resource-compiler-fatal-error-rc1011.md) \ -[Resource compiler fatal error RC1015](resource-compiler-fatal-error-rc1015.md) \ -[Resource compiler fatal error RC1017](resource-compiler-fatal-error-rc1017.md) \ -[Resource compiler fatal error RC1018](resource-compiler-fatal-error-rc1018.md) \ -[Resource compiler fatal error RC1019](resource-compiler-fatal-error-rc1019.md) \ -[Resource compiler fatal error RC1020](resource-compiler-fatal-error-rc1020.md) \ -[Resource compiler fatal error RC1021](resource-compiler-fatal-error-rc1021.md) \ -[Resource compiler fatal error RC1022](resource-compiler-fatal-error-rc1022.md) \ -[Resource compiler fatal error RC1047](resource-compiler-fatal-error-rc1047.md) \ -[Resource compiler fatal error RC1052](resource-compiler-fatal-error-rc1052.md) \ -[Resource compiler fatal error RC1067](resource-compiler-fatal-error-rc1067.md) \ -[Resource compiler fatal error RC1101](resource-compiler-fatal-error-rc1101.md) \ -[Resource compiler fatal error RC1102](resource-compiler-fatal-error-rc1102.md) \ -[Resource compiler fatal error RC1105](resource-compiler-fatal-error-rc1105.md) \ -[Resource compiler fatal error RC1109](resource-compiler-fatal-error-rc1109.md) \ -[Resource compiler fatal error RC1116](resource-compiler-fatal-error-rc1116.md) \ -[Resource compiler fatal error RC1120](resource-compiler-fatal-error-rc1120.md) \ -[Resource compiler fatal error RC1121](resource-compiler-fatal-error-rc1121.md) \ -[Resource compiler fatal error RC1203](resource-compiler-fatal-error-rc1203.md) \ -[Resource compiler fatal error RC1205](resource-compiler-fatal-error-rc1205.md) \ -[Resource compiler fatal error RC1208](resource-compiler-fatal-error-rc1208.md) \ -[Resource compiler fatal error RW1004](resource-compiler-fatal-error-rw1004.md) \ -[Resource compiler fatal error RW1009](resource-compiler-fatal-error-rw1009.md) \ -[Resource compiler fatal error RW1016](resource-compiler-fatal-error-rw1016.md) \ -[Resource compiler fatal error RW1022](resource-compiler-fatal-error-rw1022.md) \ -[Resource compiler fatal error RW1023](resource-compiler-fatal-error-rw1023.md) \ -[Resource compiler fatal error RW1025](resource-compiler-fatal-error-rw1025.md) \ -[Resource compiler fatal error RW1030](resource-compiler-fatal-error-rw1030.md) +| Error | Message | +|--|--| +| [Resource compiler fatal error RC1002](resource-compiler-fatal-error-rc1002.md) | out of heap space | +| [Resource compiler fatal error RC1004](resource-compiler-fatal-error-rc1004.md) | unexpected end of file found | +| [Resource compiler fatal error RC1009](resource-compiler-fatal-error-rc1009.md) | compiler limit : macros too deeply nested 'macro' | +| [Resource compiler fatal error RC1011](resource-compiler-fatal-error-rc1011.md) | compiler limit : 'identifier' : macro definition too big | +| [Resource compiler fatal error RC1015](resource-compiler-fatal-error-rc1015.md) | cannot open include file 'filename' | +| [Resource compiler fatal error RC1017](resource-compiler-fatal-error-rc1017.md) | invalid integer constant expression | +| [Resource compiler fatal error RC1018](resource-compiler-fatal-error-rc1018.md) | unexpected '#elif' | +| [Resource compiler fatal error RC1019](resource-compiler-fatal-error-rc1019.md) | unexpected '#else' | +| [Resource compiler fatal error RC1020](resource-compiler-fatal-error-rc1020.md) | unexpected '#endif' | +| [Resource compiler fatal error RC1021](resource-compiler-fatal-error-rc1021.md) | invalid preprocessor command 'string' | +| [Resource compiler fatal error RC1022](resource-compiler-fatal-error-rc1022.md) | expected '#endif' | +| [Resource compiler fatal error RC1047](resource-compiler-fatal-error-rc1047.md) | too many option options, 'string' | +| [Resource compiler fatal error RC1052](resource-compiler-fatal-error-rc1052.md) | compiler limit : `#if` or `#ifdef` blocks nested too deeply | +| [Resource compiler fatal error RC1067](resource-compiler-fatal-error-rc1067.md) | compiler limit : identifier overflowed internal buffer | +| [Resource compiler fatal error RC1101](resource-compiler-fatal-error-rc1101.md) | no resource binary filename specified | +| [Resource compiler fatal error RC1102](resource-compiler-fatal-error-rc1102.md) | internal error : too many arguments to RCPP | +| [Resource compiler fatal error RC1105](resource-compiler-fatal-error-rc1105.md) | invalid switch, option: too many /d switches | +| [Resource compiler fatal error RC1109](resource-compiler-fatal-error-rc1109.md) | error creating resource-name | +| [Resource compiler fatal error RC1116](resource-compiler-fatal-error-rc1116.md) | RC terminating after preprocessor errors | +| [Resource compiler fatal error RC1120](resource-compiler-fatal-error-rc1120.md) | out of memory, needed number bytes | +| [Resource compiler fatal error RC1121](resource-compiler-fatal-error-rc1121.md) | I/O error reading file | +| [Resource compiler fatal error RC1203](resource-compiler-fatal-error-rc1203.md) | invalid hexadecimal default language ID specified. | +| [Resource compiler fatal error RC1205](resource-compiler-fatal-error-rc1205.md) | invalid code page | +| [Resource compiler fatal error RC1208](resource-compiler-fatal-error-rc1208.md) | input file has .RES extension | +| [Resource compiler fatal error RW1004](resource-compiler-fatal-error-rw1004.md) | Unexpected end of file | +| [Resource compiler fatal error RW1009](resource-compiler-fatal-error-rw1009.md) | Error creating resource-name | +| [Resource compiler fatal error RW1016](resource-compiler-fatal-error-rw1016.md) | RC terminating after preprocessor errors | +| [Resource compiler fatal error RW1022](resource-compiler-fatal-error-rw1022.md) | I/O error writing file | +| [Resource compiler fatal error RW1023](resource-compiler-fatal-error-rw1023.md) | I/O error writing file, drive full | +| [Resource compiler fatal error RW1025](resource-compiler-fatal-error-rw1025.md) | Out of far heap memory | +| [Resource compiler fatal error RW1030](resource-compiler-fatal-error-rw1030.md) | Output Error | ## Resource compiler errors -[Resource compiler error RC2001](resource-compiler-error-rc2001.md) \ -[Resource compiler error RC2007](resource-compiler-error-rc2007.md) \ -[Resource compiler error RC2015](resource-compiler-error-rc2015.md) \ -[Resource compiler error RC2017](resource-compiler-error-rc2017.md) \ -[Resource compiler error RC2101](resource-compiler-error-rc2101.md) \ -[Resource compiler error RC2103](resource-compiler-error-rc2103.md) \ -[Resource compiler error RC2104](resource-compiler-error-rc2104.md) \ -[Resource compiler error RC2107](resource-compiler-error-rc2107.md) \ -[Resource compiler error RC2109](resource-compiler-error-rc2109.md) \ -[Resource compiler error RC2111](resource-compiler-error-rc2111.md) \ -[Resource compiler error RC2112](resource-compiler-error-rc2112.md) \ -[Resource compiler error RC2113](resource-compiler-error-rc2113.md) \ -[Resource compiler error RC2114](resource-compiler-error-rc2114.md) \ -[Resource compiler error RC2116](resource-compiler-error-rc2116.md) \ -[Resource compiler error RC2122](resource-compiler-error-rc2122.md) \ -[Resource compiler error RC2124](resource-compiler-error-rc2124.md) \ -[Resource compiler error RC2127](resource-compiler-error-rc2127.md) \ -[Resource compiler error RC2135](resource-compiler-error-rc2135.md) \ -[Resource compiler error RC2144](resource-compiler-error-rc2144.md) \ -[Resource compiler error RC2147](resource-compiler-error-rc2147.md) \ -[Resource compiler error RC2148](resource-compiler-error-rc2148.md) \ -[Resource compiler error RC2151](resource-compiler-error-rc2151.md) \ -[Resource compiler error RC2152](resource-compiler-error-rc2152.md) \ -[Resource compiler error RC2162](resource-compiler-error-rc2162.md) \ -[Resource compiler error RC2163](resource-compiler-error-rc2163.md) \ -[Resource compiler error RC2164](resource-compiler-error-rc2164.md) \ -[Resource compiler error RC2165](resource-compiler-error-rc2165.md) \ -[Resource compiler error RC2167](resource-compiler-error-rc2167.md) \ -[Resource compiler error RC2169](resource-compiler-error-rc2169.md) \ -[Resource compiler error RC2170](resource-compiler-error-rc2170.md) \ -[Resource compiler error RC2171](resource-compiler-error-rc2171.md) \ -[Resource compiler error RC2175](resource-compiler-error-rc2175.md) \ -[Resource compiler error RW2001](resource-compiler-error-rw2001.md) \ -[Resource compiler error RW2002](resource-compiler-error-rw2002.md) \ -[Resource compiler error RW2003](resource-compiler-error-rw2003.md) +| Error | Message | +|--|--| +| [Resource compiler error RC2001](resource-compiler-error-rc2001.md) | newline in constant | +| [Resource compiler error RC2007](resource-compiler-error-rc2007.md) | #define syntax | +| [Resource compiler error RC2015](resource-compiler-error-rc2015.md) | too many chars in constant | +| [Resource compiler error RC2017](resource-compiler-error-rc2017.md) | illegal escape sequence | +| [Resource compiler error RC2101](resource-compiler-error-rc2101.md) | Invalid directive in preprocessed RC file | +| [Resource compiler error RC2103](resource-compiler-error-rc2103.md) | unexpected end of file in string literal | +| [Resource compiler error RC2104](resource-compiler-error-rc2104.md) | undefined keyword or key name: key | +| [Resource compiler error RC2107](resource-compiler-error-rc2107.md) | expected numeric command value | +| [Resource compiler error RC2109](resource-compiler-error-rc2109.md) | expected numerical dialog constant | +| [Resource compiler error RC2111](resource-compiler-error-rc2111.md) | invalid control type | +| [Resource compiler error RC2112](resource-compiler-error-rc2112.md) | `BEGIN` expected in dialog | +| [Resource compiler error RC2113](resource-compiler-error-rc2113.md) | `END` expected in dialog | +| [Resource compiler error RC2114](resource-compiler-error-rc2114.md) | expected control class name | +| [Resource compiler error RC2116](resource-compiler-error-rc2116.md) | expecting number for ID | +| [Resource compiler error RC2122](resource-compiler-error-rc2122.md) | unknown menu subtype | +| [Resource compiler error RC2124](resource-compiler-error-rc2124.md) | empty menus not allowed | +| [Resource compiler error RC2127](resource-compiler-error-rc2127.md) | version WORDs separated by commas expected | +| [Resource compiler error RC2135](resource-compiler-error-rc2135.md) | file not found: filename | +| [Resource compiler error RC2144](resource-compiler-error-rc2144.md) | PRIMARY LANGUAGE ID not a number | +| [Resource compiler error RC2147](resource-compiler-error-rc2147.md) | SUBLANGUAGE ID not a number | +| [Resource compiler error RC2148](resource-compiler-error-rc2148.md) | SUBLANGUAGE ID too large | +| [Resource compiler error RC2151](resource-compiler-error-rc2151.md) | cannot re-use string constants | +| [Resource compiler error RC2152](resource-compiler-error-rc2152.md) | invalid control character | +| [Resource compiler error RC2162](resource-compiler-error-rc2162.md) | expected macro formal parameter | +| [Resource compiler error RC2163](resource-compiler-error-rc2163.md) | accelerator type required [ASCII or VIRTKEY] | +| [Resource compiler error RC2164](resource-compiler-error-rc2164.md) | unexpected value in `RCDATA` | +| [Resource compiler error RC2165](resource-compiler-error-rc2165.md) | string not found in `DLGINCLUDE` statement | +| [Resource compiler error RC2167](resource-compiler-error-rc2167.md) | unrecognized `VERSIONINFO` field; `BEGIN` or comma expected | +| [Resource compiler error RC2169](resource-compiler-error-rc2169.md) | resource file filename is not in 2.03 format | +| [Resource compiler error RC2170](resource-compiler-error-rc2170.md) | bitmap file filename is not in 3.00 format | +| [Resource compiler error RC2171](resource-compiler-error-rc2171.md) | unknown DIB header format | +| [Resource compiler error RC2175](resource-compiler-error-rc2175.md) | resource file filename is not in 3.00 format | +| [Resource compiler error RW2001](resource-compiler-error-rw2001.md) | Invalid directive in preprocessed RC file | +| [Resource compiler error RW2002](resource-compiler-error-rw2002.md) | Parsing error | +| [Resource compiler error RW2003](resource-compiler-error-rw2003.md) | Generation Error | ## Resource compiler warnings -[Resource compiler warning RC4002](resource-compiler-warning-rc4002.md) \ -[Resource compiler warning RC4005](resource-compiler-warning-rc4005.md) \ -[Resource compiler warning RC4093](resource-compiler-warning-rc4093.md) \ -[Resource compiler warning RC4214](resource-compiler-warning-rc4214.md) \ -[Resource compiler warning RW4001](resource-compiler-warning-rw4001.md) \ -[Resource compiler warning RW4003](resource-compiler-warning-rw4003.md) \ -[Resource compiler warning RW4004](resource-compiler-warning-rw4004.md) +| Warning | Message | +|--|--| +| [Resource compiler warning RC4002](resource-compiler-warning-rc4002.md) | too many actual parameters for macro 'identifier' | +| [Resource compiler warning RC4005](resource-compiler-warning-rc4005.md) | 'identifier' : macro redefinition | +| [Resource compiler warning RC4093](resource-compiler-warning-rc4093.md) | unescaped newline in character constant in inactive code | +| [Resource compiler warning RC4214](resource-compiler-warning-rc4214.md) | Codepage not valid : ignored | +| [Resource compiler warning RW4001](resource-compiler-warning-rw4001.md) | .EXE processing options (/L /M /P /T /K /E /31 or /30) | +| [Resource compiler warning RW4003](resource-compiler-warning-rw4003.md) | `SHIFT` or `CONTROL` used without `VIRTKEY` | +| [Resource compiler warning RW4004](resource-compiler-warning-rw4004.md) | ASCII character not equivalent to virtual key code | ## See also -[C/C++ Compiler and build tools errors and warnings](../compiler-errors-1/c-cpp-build-errors.md) +[C/C++ Compiler and build tools errors and warnings](../compiler-errors-1/c-cpp-build-errors.md)\ [Resource compiler](/windows/win32/menurc/resource-compiler) diff --git a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1002.md b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1002.md index fbff190aed7..7c7a2f888cc 100644 --- a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1002.md +++ b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1002.md @@ -1,14 +1,13 @@ --- -description: "Learn more about: Resource Compiler Fatal Error RC1002" title: "Resource Compiler Fatal Error RC1002" -ms.date: "11/04/2016" +description: "Learn more about: Resource Compiler Fatal Error RC1002" +ms.date: 11/04/2016 f1_keywords: ["RC1002"] helpviewer_keywords: ["RC1002"] -ms.assetid: b43dfece-0dc3-4d0b-9d8f-509699b9ae80 --- # Resource Compiler Fatal Error RC1002 -out of heap space +> out of heap space ### To fix by using the following possible solutions diff --git a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1004.md b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1004.md index 22db02bbda8..ad47b438b10 100644 --- a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1004.md +++ b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1004.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Resource Compiler Fatal Error RC1004" title: "Resource Compiler Fatal Error RC1004" -ms.date: "11/04/2016" +description: "Learn more about: Resource Compiler Fatal Error RC1004" +ms.date: 11/04/2016 f1_keywords: ["RC1004"] helpviewer_keywords: ["RC1004"] -ms.assetid: f9b703d4-6767-4721-9450-37079bcc7152 --- # Resource Compiler Fatal Error RC1004 -unexpected end of file found +> unexpected end of file found + +## Remarks This error can be caused by missing line feed and carriage return characters on the last line of a text file. diff --git a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1009.md b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1009.md index 2f39079e129..edebbfee426 100644 --- a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1009.md +++ b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1009.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Resource Compiler Fatal Error RC1009" title: "Resource Compiler Fatal Error RC1009" -ms.date: "11/04/2016" +description: "Learn more about: Resource Compiler Fatal Error RC1009" +ms.date: 11/04/2016 f1_keywords: ["RC1009"] helpviewer_keywords: ["RC1009"] -ms.assetid: c377a068-bcc3-4ec4-b725-eb6927e10128 --- # Resource Compiler Fatal Error RC1009 -compiler limit : macros too deeply nested 'macro' +> compiler limit : macros too deeply nested 'macro' + +## Remarks The file exceeds the Resource Compiler limit for macro nesting. Revise the specified source file to decrease the nesting depth of its macros. diff --git a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1011.md b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1011.md index b734e138b82..bcfe253dd25 100644 --- a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1011.md +++ b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1011.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Resource Compiler Fatal Error RC1011" title: "Resource Compiler Fatal Error RC1011" -ms.date: "11/04/2016" +description: "Learn more about: Resource Compiler Fatal Error RC1011" +ms.date: 11/04/2016 f1_keywords: ["RC1011"] helpviewer_keywords: ["RC1011"] -ms.assetid: ae0b89ec-0a31-4f8e-b9d0-f974152c185e --- # Resource Compiler Fatal Error RC1011 -compiler limit : 'identifier' : macro definition too big +> compiler limit : 'identifier' : macro definition too big + +## Remarks Try to split the definition into shorter definitions. diff --git a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1015.md b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1015.md index b7031ac9c68..71057ea62f5 100644 --- a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1015.md +++ b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1015.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Resource Compiler Fatal Error RC1015" title: "Resource Compiler Fatal Error RC1015" -ms.date: "11/04/2016" +description: "Learn more about: Resource Compiler Fatal Error RC1015" +ms.date: 11/04/2016 f1_keywords: ["RC1015"] helpviewer_keywords: ["RC1015"] -ms.assetid: 23f187e1-5538-40b5-9042-edd2888f55c2 --- # Resource Compiler Fatal Error RC1015 -cannot open include file 'filename' +> cannot open include file 'filename' + +## Remarks The given include file does not exist, could not be opened, or was not found. diff --git a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1017.md b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1017.md index d27bdb374da..361883e2bc9 100644 --- a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1017.md +++ b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1017.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Resource Compiler Fatal Error RC1017" title: "Resource Compiler Fatal Error RC1017" -ms.date: "11/04/2016" +description: "Learn more about: Resource Compiler Fatal Error RC1017" +ms.date: 11/04/2016 f1_keywords: ["RC1017"] helpviewer_keywords: ["RC1017"] -ms.assetid: 62ac1356-4481-49a0-8873-36daf42ffdcd --- # Resource Compiler Fatal Error RC1017 -invalid integer constant expression +> invalid integer constant expression + +## Remarks The expression in an `#if` directive either did not exist or does not evaluate to a constant. diff --git a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1018.md b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1018.md index 0917185e27d..1f3808ee3ee 100644 --- a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1018.md +++ b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1018.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Resource Compiler Fatal Error RC1018" title: "Resource Compiler Fatal Error RC1018" -ms.date: "11/04/2016" +description: "Learn more about: Resource Compiler Fatal Error RC1018" +ms.date: 11/04/2016 f1_keywords: ["RC1018"] helpviewer_keywords: ["RC1018"] -ms.assetid: bb1d2efd-6898-412f-bb03-9ff94c54e4dc --- # Resource Compiler Fatal Error RC1018 -unexpected '#elif' +> unexpected '#elif' + +## Remarks The `#elif` directive did not appear within an `#if`, **#ifdef**, or **#ifndef** construct. diff --git a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1019.md b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1019.md index b6056dd12f1..2ce46126549 100644 --- a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1019.md +++ b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1019.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Resource Compiler Fatal Error RC1019" title: "Resource Compiler Fatal Error RC1019" -ms.date: "11/04/2016" +description: "Learn more about: Resource Compiler Fatal Error RC1019" +ms.date: 11/04/2016 f1_keywords: ["RC1019"] helpviewer_keywords: ["RC1019"] -ms.assetid: 432fff44-04a9-4e13-91c6-870df6f0b4e4 --- # Resource Compiler Fatal Error RC1019 -unexpected '#else' +> unexpected '#else' + +## Remarks The `#else` directive did not appear within an `#if`, **#ifdef**, or **#ifndef** construct. diff --git a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1020.md b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1020.md index bc34220daff..5454a1ef52e 100644 --- a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1020.md +++ b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1020.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Resource Compiler Fatal Error RC1020" title: "Resource Compiler Fatal Error RC1020" -ms.date: "11/04/2016" +description: "Learn more about: Resource Compiler Fatal Error RC1020" +ms.date: 11/04/2016 f1_keywords: ["RC1020"] helpviewer_keywords: ["RC1020"] -ms.assetid: 3e073ebf-9136-4bf8-ac6a-3c642ed64594 --- # Resource Compiler Fatal Error RC1020 -unexpected '#endif' +> unexpected '#endif' + +## Remarks An `#endif` directive appeared without a matching `#if`, **#ifdef**, or **#ifndef** directive. diff --git a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1021.md b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1021.md index 1a2f34d860e..ccaa3ab1152 100644 --- a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1021.md +++ b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1021.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Resource Compiler Fatal Error RC1021" title: "Resource Compiler Fatal Error RC1021" -ms.date: "11/04/2016" +description: "Learn more about: Resource Compiler Fatal Error RC1021" +ms.date: 11/04/2016 f1_keywords: ["RC1021"] helpviewer_keywords: ["RC1021"] -ms.assetid: 9bc8858c-aa50-4b94-b60e-daf75ab45d77 --- # Resource Compiler Fatal Error RC1021 -invalid preprocessor command 'string' +> invalid preprocessor command 'string' + +## Remarks The characters following the number sign (**#**) did not form a valid preprocessor directive. diff --git a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1022.md b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1022.md index dc3ef2c2b15..b85384b0a86 100644 --- a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1022.md +++ b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1022.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Resource Compiler Fatal Error RC1022" title: "Resource Compiler Fatal Error RC1022" -ms.date: "11/04/2016" +description: "Learn more about: Resource Compiler Fatal Error RC1022" +ms.date: 11/04/2016 f1_keywords: ["RC1022"] helpviewer_keywords: ["RC1022"] -ms.assetid: 30a0f3c7-08a8-4c40-b0de-46ee5feb789d --- # Resource Compiler Fatal Error RC1022 -expected '#endif' +> expected '#endif' + +## Remarks An `#if`, **#ifdef**, or **#ifndef** directive was not terminated with an `#endif` directive. diff --git a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1047.md b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1047.md index 08e433d25b4..a3b544b8fb5 100644 --- a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1047.md +++ b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1047.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Resource Compiler Fatal Error RC1047" title: "Resource Compiler Fatal Error RC1047" -ms.date: "11/04/2016" +description: "Learn more about: Resource Compiler Fatal Error RC1047" +ms.date: 11/04/2016 f1_keywords: ["RC1047"] helpviewer_keywords: ["RC1047"] -ms.assetid: cd794a87-2634-4d25-9fd3-8c934e3c4d1e --- # Resource Compiler Fatal Error RC1047 -"too many option options, 'string'" +> "too many option options, 'string'" + +## Remarks The given option was specified too many times. The given string is the argument to the option that caused the error. diff --git a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1052.md b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1052.md index c537dcb4165..ddda49f8d46 100644 --- a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1052.md +++ b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1052.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Resource Compiler Fatal Error RC1052" title: "Resource Compiler Fatal Error RC1052" -ms.date: "11/04/2016" +description: "Learn more about: Resource Compiler Fatal Error RC1052" +ms.date: 11/04/2016 f1_keywords: ["RC1052"] helpviewer_keywords: ["RC1052"] -ms.assetid: 59803673-492b-44fa-80fa-df93b8aaf9fb --- # Resource Compiler Fatal Error RC1052 -compiler limit : #if or #ifdef blocks nested too deeply +> compiler limit : #if or #ifdef blocks nested too deeply + +## Remarks The program exceeded the maximum allowable nesting levels for `#if` and `#ifdef` directives. diff --git a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1067.md b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1067.md index 56528097fbf..a8a87351368 100644 --- a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1067.md +++ b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1067.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Resource Compiler Fatal Error RC1067" title: "Resource Compiler Fatal Error RC1067" -ms.date: "11/04/2016" +description: "Learn more about: Resource Compiler Fatal Error RC1067" +ms.date: 11/04/2016 f1_keywords: ["RC1067"] helpviewer_keywords: ["RC1067"] -ms.assetid: 6b23677d-428d-47c6-9207-8b85f7718e03 --- # Resource Compiler Fatal Error RC1067 -compiler limit : identifier overflowed internal buffer +> compiler limit : identifier overflowed internal buffer + +## Remarks An internal compiler limit was exceeded. diff --git a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1101.md b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1101.md index df4bef463ad..889f6601ddd 100644 --- a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1101.md +++ b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1101.md @@ -1,15 +1,16 @@ --- -description: "Learn more about: Resource Compiler Fatal Error RC1101" title: "Resource Compiler Fatal Error RC1101" -ms.date: "08/27/2018" +description: "Learn more about: Resource Compiler Fatal Error RC1101" +ms.date: 08/27/2018 f1_keywords: ["RC1101"] helpviewer_keywords: ["RC1101"] -ms.assetid: ff273384-b819-464a-8c0e-d5951e4a28b4 --- # Resource Compiler Fatal Error RC1101 > no resource binary filename specified +## Remarks + The Rename Output (/fo) option was not followed by a filename. Use the following syntax for the /fo option: diff --git a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1102.md b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1102.md index ff54132abfa..9074d14d03f 100644 --- a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1102.md +++ b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1102.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Resource Compiler Fatal Error RC1102" title: "Resource Compiler Fatal Error RC1102" -ms.date: "11/04/2016" +description: "Learn more about: Resource Compiler Fatal Error RC1102" +ms.date: 11/04/2016 f1_keywords: ["RC1102"] helpviewer_keywords: ["RC1102"] -ms.assetid: bd2091f8-ef5e-4151-a8d6-98043e9422b6 --- # Resource Compiler Fatal Error RC1102 -internal error : too many arguments to RCPP +> internal error : too many arguments to RCPP + +## Remarks Too many arguments were passed to the Resource Compiler preprocessor. Reduce the number of symbols defined with the Define Symbols (/d) option by defining them in your source. This error can also be caused by specifying too many include file search paths using the Include Search Path option (/i). diff --git a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1105.md b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1105.md index 1bdddf86718..0e0c81d1668 100644 --- a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1105.md +++ b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1105.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Resource Compiler Fatal Error RC1105" title: "Resource Compiler Fatal Error RC1105" -ms.date: "11/04/2016" +description: "Learn more about: Resource Compiler Fatal Error RC1105" +ms.date: 11/04/2016 f1_keywords: ["RC1105"] helpviewer_keywords: ["RC1105"] -ms.assetid: 80ce18e7-44ee-4844-bede-321fe0844d56 --- # Resource Compiler Fatal Error RC1105 -invalid switch, option: too many /d switches +> invalid switch, option: too many /d switches + +## Remarks Too many symbols were defined using the Define Symbols (/d) option. Define some symbols in your source and recompile. diff --git a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1109.md b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1109.md index 37e4d29ac92..0e23c8176dd 100644 --- a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1109.md +++ b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1109.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Resource Compiler Fatal Error RC1109" title: "Resource Compiler Fatal Error RC1109" -ms.date: "11/04/2016" +description: "Learn more about: Resource Compiler Fatal Error RC1109" +ms.date: 11/04/2016 f1_keywords: ["RC1109"] helpviewer_keywords: ["RC1109"] -ms.assetid: 2d3ec1c9-86fd-4d53-aa52-840c310b8328 --- # Resource Compiler Fatal Error RC1109 -error creating resource-name +> error creating resource-name + +## Remarks Could not create specified .res file. Make sure it is not being created on a read-only drive. Use the /V option to find out whether the file is being created. diff --git a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1116.md b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1116.md index a2799212719..50acf9d9525 100644 --- a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1116.md +++ b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1116.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Resource Compiler Fatal Error RC1116" title: "Resource Compiler Fatal Error RC1116" -ms.date: "11/04/2016" +description: "Learn more about: Resource Compiler Fatal Error RC1116" +ms.date: 11/04/2016 f1_keywords: ["RC1116"] helpviewer_keywords: ["RC1116"] -ms.assetid: 1eacc5c3-d946-4615-83e4-1b8ebd472139 --- # Resource Compiler Fatal Error RC1116 -RC terminating after preprocessor errors +> RC terminating after preprocessor errors + +## Remarks The Resource Compiler halted due to other errors. Fix the other errors and recompile. diff --git a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1120.md b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1120.md index 383bf936aee..cda7bd1fa63 100644 --- a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1120.md +++ b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1120.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Resource Compiler Fatal Error RC1120" title: "Resource Compiler Fatal Error RC1120" -ms.date: "11/04/2016" +description: "Learn more about: Resource Compiler Fatal Error RC1120" +ms.date: 11/04/2016 f1_keywords: ["RC1120"] helpviewer_keywords: ["RC1120"] -ms.assetid: 4e462931-e42e-42e3-8bfc-847677194286 --- # Resource Compiler Fatal Error RC1120 -out of memory, needed number bytes +> out of memory, needed number bytes + +## Remarks The Resource Compiler ran out of storage for items that it stores in its heap. Usually this is the result of having too many symbols. diff --git a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1121.md b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1121.md index e8530fad72c..c9fc4d8f16a 100644 --- a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1121.md +++ b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1121.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Resource Compiler Fatal Error RC1121" title: "Resource Compiler Fatal Error RC1121" -ms.date: "11/04/2016" +description: "Learn more about: Resource Compiler Fatal Error RC1121" +ms.date: 11/04/2016 f1_keywords: ["RC1121"] helpviewer_keywords: ["RC1121"] -ms.assetid: 19ed8c71-d63a-4ff4-8652-a3ef52318a55 --- # Resource Compiler Fatal Error RC1121 -I/O error reading file +> I/O error reading file + +## Remarks The Resource Compiler was not able to read a file. Check that the drive containing the file is available and that the file is valid. diff --git a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1203.md b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1203.md index 963dc534d54..405a2606b77 100644 --- a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1203.md +++ b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1203.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Resource Compiler Fatal Error RC1203" title: "Resource Compiler Fatal Error RC1203" -ms.date: "11/04/2016" +description: "Learn more about: Resource Compiler Fatal Error RC1203" +ms.date: 11/04/2016 f1_keywords: ["RC1203"] helpviewer_keywords: ["RC1203"] -ms.assetid: 60d08fb1-6a51-407c-854e-9a68080cfe2d --- # Resource Compiler Fatal Error RC1203 -invalid hexadecimal default language ID specified. +> invalid hexadecimal default language ID specified. + +## Remarks The Specify Default Language (/l) option was followed by an invalid hexadecimal language ID. See [Language and Country/Region Strings](../../c-runtime-library/locale-names-languages-and-country-region-strings.md) in the *Run-Time Library Reference* for a list of valid language IDs. diff --git a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1205.md b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1205.md index abdce3697b0..445ae2739e7 100644 --- a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1205.md +++ b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1205.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Resource Compiler Fatal Error RC1205" title: "Resource Compiler Fatal Error RC1205" -ms.date: "11/04/2016" +description: "Learn more about: Resource Compiler Fatal Error RC1205" +ms.date: 11/04/2016 f1_keywords: ["RC1205"] helpviewer_keywords: ["RC1205"] -ms.assetid: 6cfbe019-ad8a-4267-b4b9-0d675bb3819a --- # Resource Compiler Fatal Error RC1205 -invalid code page +> invalid code page + +## Remarks The Specify Code Page (/c) option was followed by an invalid code page. See [Code Pages](../../c-runtime-library/code-pages.md) in the *Run-Time Library Reference* for more information. diff --git a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1208.md b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1208.md index 1ceb943027e..4e98e6ab616 100644 --- a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1208.md +++ b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rc1208.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Resource Compiler Fatal Error RC1208" title: "Resource Compiler Fatal Error RC1208" -ms.date: "11/04/2016" +description: "Learn more about: Resource Compiler Fatal Error RC1208" +ms.date: 11/04/2016 f1_keywords: ["RC1208"] helpviewer_keywords: ["RC1208"] -ms.assetid: 7dacc4ec-3ebd-49b3-ba4c-1a2982bac720 --- # Resource Compiler Fatal Error RC1208 -input file has .RES extension +> input file has .RES extension + +## Remarks The .RES extension is used for Resource Compiler output. The .RC extension should be used for Resource Compiler scripts. diff --git a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rw1004.md b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rw1004.md index 9c5b2e88282..be2236c6d44 100644 --- a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rw1004.md +++ b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rw1004.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Resource Compiler Fatal Error RW1004" title: "Resource Compiler Fatal Error RW1004" -ms.date: "11/04/2016" +description: "Learn more about: Resource Compiler Fatal Error RW1004" +ms.date: 11/04/2016 f1_keywords: ["RW1004"] helpviewer_keywords: ["RW1004"] -ms.assetid: 89cfcb02-a5d3-4271-be4f-df2ec3f94f3e --- # Resource Compiler Fatal Error RW1004 -Unexpected end of file +> Unexpected end of file + +## Remarks This error can be caused by missing line feed and carriage-return characters on the last line of a text file. diff --git a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rw1009.md b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rw1009.md index b67063c43d9..c3865536102 100644 --- a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rw1009.md +++ b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rw1009.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Resource Compiler Fatal Error RW1009" title: "Resource Compiler Fatal Error RW1009" -ms.date: "11/04/2016" +description: "Learn more about: Resource Compiler Fatal Error RW1009" +ms.date: 11/04/2016 f1_keywords: ["RW1009"] helpviewer_keywords: ["RW1009"] -ms.assetid: c11aceaf-3527-4509-867d-e7b22254e276 --- # Resource Compiler Fatal Error RW1009 -Error creating resource-name +> Error creating resource-name + +## Remarks Could not create specified .res file. Make sure it is not being created on a read-only drive. Use /V to find out whether the file is being created. diff --git a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rw1016.md b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rw1016.md index a7267fa6023..1475a9c5de5 100644 --- a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rw1016.md +++ b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rw1016.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Resource Compiler Fatal Error RW1016" title: "Resource Compiler Fatal Error RW1016" -ms.date: "11/04/2016" +description: "Learn more about: Resource Compiler Fatal Error RW1016" +ms.date: 11/04/2016 f1_keywords: ["RW1016"] helpviewer_keywords: ["RW1016"] -ms.assetid: 7c93b6b6-3684-4b09-b71d-160c400f75a5 --- # Resource Compiler Fatal Error RW1016 -RC terminating after preprocessor errors +> RC terminating after preprocessor errors + +## Remarks The Resource Compiler halted due to other errors. Fix the other errors and recompile. diff --git a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rw1022.md b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rw1022.md index 1831781a0d5..c30a6760206 100644 --- a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rw1022.md +++ b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rw1022.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Resource Compiler Fatal Error RW1022" title: "Resource Compiler Fatal Error RW1022" -ms.date: "11/04/2016" +description: "Learn more about: Resource Compiler Fatal Error RW1022" +ms.date: 11/04/2016 f1_keywords: ["RW1022"] helpviewer_keywords: ["RW1022"] -ms.assetid: 6747c8a9-9c9b-4422-b414-0645d22092d0 --- # Resource Compiler Fatal Error RW1022 -**I/O error writing file** +> I/O error writing file + +## Remarks The Resource Compiler could not write to a file. diff --git a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rw1023.md b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rw1023.md index 6a5c84c99e7..1d72a674995 100644 --- a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rw1023.md +++ b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rw1023.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Resource Compiler Fatal Error RW1023" title: "Resource Compiler Fatal Error RW1023" -ms.date: "11/04/2016" +description: "Learn more about: Resource Compiler Fatal Error RW1023" +ms.date: 11/04/2016 f1_keywords: ["RW1023"] helpviewer_keywords: ["RW1023"] -ms.assetid: 1fe0964a-a8cc-4ffa-a427-dbce39f23173 --- # Resource Compiler Fatal Error RW1023 -I/O error writing file, drive full +> I/O error writing file, drive full + +## Remarks Free space must equal at least twice the size of the executable file you are creating. diff --git a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rw1025.md b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rw1025.md index 4e3a45b966d..036bafa0f34 100644 --- a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rw1025.md +++ b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rw1025.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Resource Compiler Fatal Error RW1025" title: "Resource Compiler Fatal Error RW1025" -ms.date: "11/04/2016" +description: "Learn more about: Resource Compiler Fatal Error RW1025" +ms.date: 11/04/2016 f1_keywords: ["RW1025"] helpviewer_keywords: ["RW1025"] -ms.assetid: 561a02af-e7e0-442a-8ad3-a00b2ca1b62e --- # Resource Compiler Fatal Error RW1025 -Out of far heap memory +> Out of far heap memory + +## Remarks Check for memory-resident software that might be taking up too much space. Use the CHKDSK program to find out how much memory you have. diff --git a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rw1030.md b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rw1030.md index b737df8c45d..35842f821ab 100644 --- a/docs/error-messages/tool-errors/resource-compiler-fatal-error-rw1030.md +++ b/docs/error-messages/tool-errors/resource-compiler-fatal-error-rw1030.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Resource Compiler Fatal Error RW1030" title: "Resource Compiler Fatal Error RW1030" -ms.date: "11/04/2016" +description: "Learn more about: Resource Compiler Fatal Error RW1030" +ms.date: 11/04/2016 f1_keywords: ["RW1030"] helpviewer_keywords: ["RW1030"] -ms.assetid: 10727997-9ded-4afc-93b3-58fb435c3da8 --- # Resource Compiler Fatal Error RW1030 -Output Error +> Output Error + +## Remarks This error can be caused if the Resource Compiler was not able to create the destination file. Make sure that there is enough disk space and that you have write permission on the volume. diff --git a/docs/error-messages/tool-errors/resource-compiler-warning-rc4002.md b/docs/error-messages/tool-errors/resource-compiler-warning-rc4002.md index 7c41643dbe8..e85fed2d962 100644 --- a/docs/error-messages/tool-errors/resource-compiler-warning-rc4002.md +++ b/docs/error-messages/tool-errors/resource-compiler-warning-rc4002.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Resource Compiler Warning RC4002" title: "Resource Compiler Warning RC4002" -ms.date: "11/04/2016" +description: "Learn more about: Resource Compiler Warning RC4002" +ms.date: 11/04/2016 f1_keywords: ["RC4002"] helpviewer_keywords: ["RC4002"] -ms.assetid: a157bc55-1a75-4337-aee4-e2ba61ff8cfa --- # Resource Compiler Warning RC4002 -too many actual parameters for macro 'identifier' +> too many actual parameters for macro 'identifier' + +## Remarks The number of actual parameters specified with the given identifier was greater than the number of formal parameters given in the macro definition of the identifier. diff --git a/docs/error-messages/tool-errors/resource-compiler-warning-rc4005.md b/docs/error-messages/tool-errors/resource-compiler-warning-rc4005.md index 15f614c9056..fba7a496464 100644 --- a/docs/error-messages/tool-errors/resource-compiler-warning-rc4005.md +++ b/docs/error-messages/tool-errors/resource-compiler-warning-rc4005.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Resource Compiler Warning RC4005" title: "Resource Compiler Warning RC4005" -ms.date: "11/04/2016" +description: "Learn more about: Resource Compiler Warning RC4005" +ms.date: 11/04/2016 f1_keywords: ["RC4005"] helpviewer_keywords: ["RC4005"] -ms.assetid: 71f03b4a-c9a9-415d-920f-bf2e58507f93 --- # Resource Compiler Warning RC4005 -'identifier' : macro redefinition +> 'identifier' : macro redefinition + +## Remarks The identifier is defined twice. The compiler used the second macro definition. diff --git a/docs/error-messages/tool-errors/resource-compiler-warning-rc4093.md b/docs/error-messages/tool-errors/resource-compiler-warning-rc4093.md index ac1b20c66e7..a5729c8a6bf 100644 --- a/docs/error-messages/tool-errors/resource-compiler-warning-rc4093.md +++ b/docs/error-messages/tool-errors/resource-compiler-warning-rc4093.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Resource Compiler Warning RC4093" title: "Resource Compiler Warning RC4093" -ms.date: "11/04/2016" +description: "Learn more about: Resource Compiler Warning RC4093" +ms.date: 11/04/2016 f1_keywords: ["RC4093"] helpviewer_keywords: ["RC4093"] -ms.assetid: 3c61b4a4-b418-465b-a4fd-cb1ff0adb8dd --- # Resource Compiler Warning RC4093 -unescaped newline in character constant in inactive code +> unescaped newline in character constant in inactive code + +## Remarks The constant expression of an `#if`, `#elif`, **#ifdef**, or **#ifndef** preprocessor directive evaluated to zero, making the code that follows inactive. Within that inactive code, a newline character appeared within a set of single or double quotation marks. diff --git a/docs/error-messages/tool-errors/resource-compiler-warning-rc4214.md b/docs/error-messages/tool-errors/resource-compiler-warning-rc4214.md index d1ba52ccd48..e8612428191 100644 --- a/docs/error-messages/tool-errors/resource-compiler-warning-rc4214.md +++ b/docs/error-messages/tool-errors/resource-compiler-warning-rc4214.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Resource Compiler Warning RC4214" title: "Resource Compiler Warning RC4214" -ms.date: "11/04/2016" +description: "Learn more about: Resource Compiler Warning RC4214" +ms.date: 11/04/2016 f1_keywords: ["RC4214"] helpviewer_keywords: ["RC4214"] -ms.assetid: 79a8bf0d-8cc7-4159-a6a2-d0e543749069 --- # Resource Compiler Warning RC4214 -Codepage not valid : ignored +> Codepage not valid : ignored + +## Remarks The .rc file contained a codepage argument and the codepage specified is invalid. See [IsValidCodePage](/windows/win32/api/winnls/nf-winnls-isvalidcodepage) for more information. diff --git a/docs/error-messages/tool-errors/resource-compiler-warning-rw4001.md b/docs/error-messages/tool-errors/resource-compiler-warning-rw4001.md index 1218c5f7b8a..e800d8c2c8b 100644 --- a/docs/error-messages/tool-errors/resource-compiler-warning-rw4001.md +++ b/docs/error-messages/tool-errors/resource-compiler-warning-rw4001.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Resource Compiler Warning RW4001" title: "Resource Compiler Warning RW4001" -ms.date: "11/04/2016" +description: "Learn more about: Resource Compiler Warning RW4001" +ms.date: 11/04/2016 f1_keywords: ["RW4001"] helpviewer_keywords: ["RW4001"] -ms.assetid: 7c2d35eb-9899-46f5-848d-7ef49c39d706 --- # Resource Compiler Warning RW4001 -.EXE processing options (/L /M /P /T /K /E /31 or /30) +> .EXE processing options (/L /M /P /T /K /E /31 or /30) + +## Remarks You specified EXE processing options, but there was no executable file to process. Don't use these options with a .res file. diff --git a/docs/error-messages/tool-errors/resource-compiler-warning-rw4003.md b/docs/error-messages/tool-errors/resource-compiler-warning-rw4003.md index 2ff11e08bfe..5d5c68ffcc1 100644 --- a/docs/error-messages/tool-errors/resource-compiler-warning-rw4003.md +++ b/docs/error-messages/tool-errors/resource-compiler-warning-rw4003.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: Resource Compiler Warning RW4003" title: "Resource Compiler Warning RW4003" -ms.date: "11/04/2016" +description: "Learn more about: Resource Compiler Warning RW4003" +ms.date: 11/04/2016 f1_keywords: ["RW4003"] helpviewer_keywords: ["RW4003"] -ms.assetid: e9c289f2-c065-4f26-bc24-991953742abc --- # Resource Compiler Warning RW4003 -SHIFT or CONTROL used without VIRTKEY +> SHIFT or CONTROL used without VIRTKEY + +## Remarks In an accelerator table resource, SHIFT or CONTROL requires VIRTKEY. Because SHIFT and CONTROL are indicated as flag bits in a VIRTKEY type accelerator, they cannot exist independent from a VIRTKEY. diff --git a/docs/error-messages/tool-errors/resource-compiler-warning-rw4004.md b/docs/error-messages/tool-errors/resource-compiler-warning-rw4004.md index 16d53e49d0d..e54b5ee855d 100644 --- a/docs/error-messages/tool-errors/resource-compiler-warning-rw4004.md +++ b/docs/error-messages/tool-errors/resource-compiler-warning-rw4004.md @@ -1,14 +1,15 @@ --- -description: "Learn more about: Resource Compiler Warning RW4004" title: "Resource Compiler Warning RW4004" -ms.date: "11/04/2016" +description: "Learn more about: Resource Compiler Warning RW4004" +ms.date: 11/04/2016 f1_keywords: ["RW4004"] helpviewer_keywords: ["RW4004"] -ms.assetid: 596b6a89-9ce7-4ba7-bdcb-e8054c7efafa --- # Resource Compiler Warning RW4004 -ASCII character not equivalent to virtual key code +> ASCII character not equivalent to virtual key code + +## Remarks A string literal was used for the virtual key code in a VIRTKEY type accelerator. diff --git a/docs/error-messages/tool-errors/vectorizer-and-parallelizer-messages.md b/docs/error-messages/tool-errors/vectorizer-and-parallelizer-messages.md index 07ff21fb4e3..c364ea1966d 100644 --- a/docs/error-messages/tool-errors/vectorizer-and-parallelizer-messages.md +++ b/docs/error-messages/tool-errors/vectorizer-and-parallelizer-messages.md @@ -30,12 +30,16 @@ The 5*xx* reason codes apply to both the parallelizer and the vectorizer. | Reason code | Explanation | |--|--| -| 500 | A generic message that covers several cases: For example, the loop includes multiple exits, or the loop header doesn't end by incrementing the induction variable. | +| 500 | Induction variable discovery or recurrence failure. | | 501 | Induction variable isn't local; or upper bound isn't loop-invariant. | | 502 | Induction variable is stepped in some manner other than a simple +1. | | 503 | Loop includes exception-handling or switch statements. | | 504 | Loop body may throw an exception that requires destruction of a C++ object. | | 505 | Outer loop has a pre-incremented induction variable. Exiting analysis. | +| 506 | Loop structural or canonical form failure. | +| 507 | Bounds, initialization, termination, or compare consistency failure. | +| 508 | Stride derivation or usage failure | +| 509 | Loop direction acceptability failure. | ```cpp void code_500(int *A) diff --git a/docs/extensions/abstract-cpp-component-extensions.md b/docs/extensions/abstract-cpp-component-extensions.md index 54e681d6cf9..495eb80faf8 100644 --- a/docs/extensions/abstract-cpp-component-extensions.md +++ b/docs/extensions/abstract-cpp-component-extensions.md @@ -1,13 +1,12 @@ --- -description: "Learn more about: abstract (C++/CLI and C++/CX)" -title: "abstract (C++/CLI and C++/CX)" -ms.date: "10/12/2018" +title: "abstract (C++/CLI and C++/CX)" +description: "Learn more about: abstract (C++/CLI and C++/CX)" +ms.date: 10/12/2018 ms.topic: "reference" f1_keywords: ["abstract", "abstract_cpp"] helpviewer_keywords: ["abstract keyword [C++]"] -ms.assetid: cbae3408-0378-4ac8-b70d-c016b381a6d5 --- -# abstract (C++/CLI and C++/CX) +# abstract (C++/CLI and C++/CX) The **abstract** keyword declares either: diff --git a/docs/extensions/attribute-parameter-types-cpp-component-extensions.md b/docs/extensions/attribute-parameter-types-cpp-component-extensions.md index fd508895ddc..6b54f8b8807 100644 --- a/docs/extensions/attribute-parameter-types-cpp-component-extensions.md +++ b/docs/extensions/attribute-parameter-types-cpp-component-extensions.md @@ -1,12 +1,11 @@ --- -description: "Learn more about: Attribute Parameter Types (C++/CLI and C++/CX)" -title: "Attribute Parameter Types (C++/CLI and C++/CX)" -ms.date: "10/12/2018" +title: "Attribute Parameter Types (C++/CLI and C++/CX)" +description: "Learn more about: Attribute Parameter Types (C++/CLI and C++/CX)" +ms.date: 10/12/2018 ms.topic: "reference" helpviewer_keywords: ["custom attributes, parameter types"] -ms.assetid: d9f127a3-7f08-456f-acc6-256805632712 --- -# Attribute Parameter Types (C++/CLI and C++/CX) +# Attribute Parameter Types (C++/CLI and C++/CX) Values passed to attributes must be known to the compiler at compile time. Attribute parameters can be of the following types: diff --git a/docs/extensions/boxing-cpp-component-extensions.md b/docs/extensions/boxing-cpp-component-extensions.md index 6de754d4753..a25066d75d9 100644 --- a/docs/extensions/boxing-cpp-component-extensions.md +++ b/docs/extensions/boxing-cpp-component-extensions.md @@ -1,12 +1,11 @@ --- -description: "Learn more about: Boxing (C++/CLI and C++/CX)" -title: "Boxing (C++/CLI and C++/CX)" -ms.date: "10/12/2018" +title: "Boxing (C++/CLI and C++/CX)" +description: "Learn more about: Boxing (C++/CLI and C++/CX)" +ms.date: 10/12/2018 ms.topic: "reference" helpviewer_keywords: ["boxing, C++"] -ms.assetid: b5fd2c98-c578-4f83-8257-6dd663478665 --- -# Boxing (C++/CLI and C++/CX) +# Boxing (C++/CLI and C++/CX) The conversion of value types to objects is called *boxing*, and the conversion of objects to value types is called *unboxing*. diff --git a/docs/extensions/classes-and-structs-cpp-component-extensions.md b/docs/extensions/classes-and-structs-cpp-component-extensions.md index 7f1310a5b73..43ca041916a 100644 --- a/docs/extensions/classes-and-structs-cpp-component-extensions.md +++ b/docs/extensions/classes-and-structs-cpp-component-extensions.md @@ -1,13 +1,12 @@ --- -description: "Learn more about: ref class and ref struct (C++/CLI and C++/CX)" title: "ref class and ref struct (C++/CLI and C++/CX)" -ms.date: "05/30/2019" +description: "Learn more about: ref class and ref struct (C++/CLI and C++/CX)" +ms.date: 05/30/2019 ms.topic: "reference" f1_keywords: ["ref class", "value class", "ref struct", "value struct",] helpviewer_keywords: ["ref class keyword [C++]", "value class keyword [C++]", "value struct keyword [C++]", "ref struct keyword [C++]"] -ms.assetid: 5c360764-b229-49c6-9357-66213afbc372 --- -# ref class and ref struct (C++/CLI and C++/CX) +# ref class and ref struct (C++/CLI and C++/CX) The **ref class** or **ref struct** extensions declare a class or struct whose *object lifetime* is administered automatically. When the object is no longer accessible or goes out of scope, the memory is released. diff --git a/docs/extensions/compiler-support-for-type-traits-cpp-component-extensions.md b/docs/extensions/compiler-support-for-type-traits-cpp-component-extensions.md index df9bc0d8cf9..c88366385c7 100644 --- a/docs/extensions/compiler-support-for-type-traits-cpp-component-extensions.md +++ b/docs/extensions/compiler-support-for-type-traits-cpp-component-extensions.md @@ -1,11 +1,10 @@ --- -description: "Learn more about: Compiler Support for Type Traits (C++/CLI and C++/CX)" title: "Compiler Support for Type Traits (C++/CLI and C++/CX)" +description: "Learn more about: Compiler Support for Type Traits (C++/CLI and C++/CX)" ms.date: "10/12/2018" ms.topic: "reference" f1_keywords: ["__is_simple_value_class", "__has_trivial_destructor", "__has_assign", "__is_union", "__is_class", "__is_abstract", "__has_trivial_assign", "__has_virtual_destructor", "__is_ref_array", "__is_base_of", "__has_copy", "__is_polymorphic", "__has_nothrow_constructor", "__is_ref_class", "__is_delegate", "__is_convertible_to", "__is_value_class", "__is_interface_class", "__has_nothrow_copy", "__is_sealed", "__has_trivial_constructor", "__has_trivial_copy", "__is_enum", "__has_nothrow_assign", "__has_finalizer", "__is_empty", "__is_pod", "__has_user_destructor"] helpviewer_keywords: ["__is_class keyword [C++]", "__is_pod keyword [C++]", "__is_delegate keyword [C++]", "__is_value_class keyword [C++]", "__has_copy keyword [C++]", "__has_nothrow_copy keyword [C++]", "__is_interface_class keyword [C++]", "__is_sealed keyword [C++]", "__is_convertible_to keyword [C++]", "__is_ref_class keyword [C++]", "__has_trivial_copy keyword [C++]", "__has_user_destructor keyword [C++]", "__is_abstract keyword [C++]", "__is_empty keyword [C++]", "__has_trivial_assign keyword [C++]", "__has_nothrow_constructor keyword [C++]", "__is_ref_array keyword [C++]", "__is_base_of keyword [C++]", "__has_nothrow_assign keyword [C++]", "__has_virtual_destructor keyword [C++]", "__has_finalizer keyword [C++]", "__is_union keyword [C++]", "__has_assign keyword [C++]", "__has_trivial_destructor keyword [C++]", "__is_polymorphic keyword [C++]", "__is_enum keyword [C++]", "__is_simple_value_class keyword [C++]", "__has_trivial_constructor keyword [C++]"] -ms.assetid: cd440630-0394-48c0-a16b-1580b6ef5844 --- # Compiler Support for Type Traits (C++/CLI and C++/CX) @@ -160,7 +159,7 @@ The following list contains the type traits that are supported by the compiler. Returns **`true`** if the type has a trivial, compiler-generated destructor. - ``` cpp + ```cpp // has_trivial_destructor.cpp #include struct S {}; diff --git a/docs/extensions/context-sensitive-keywords-cpp-component-extensions.md b/docs/extensions/context-sensitive-keywords-cpp-component-extensions.md index 443571ea5e2..8205699fbb6 100644 --- a/docs/extensions/context-sensitive-keywords-cpp-component-extensions.md +++ b/docs/extensions/context-sensitive-keywords-cpp-component-extensions.md @@ -1,13 +1,12 @@ --- -description: "Learn more about: Context-Sensitive Keywords (C++/CLI and C++/CX)" -title: "Context-Sensitive Keywords (C++/CLI and C++/CX)" -ms.date: "10/12/2018" +title: "Context-Sensitive Keywords (C++/CLI and C++/CX)" +description: "Learn more about: Context-Sensitive Keywords (C++/CLI and C++/CX)" +ms.date: 10/12/2018 ms.topic: "reference" f1_keywords: ["internal_CPP"] helpviewer_keywords: ["context-sensitive keywords"] -ms.assetid: e33da089-f434-44e9-8cce-4668d05a8939 --- -# Context-Sensitive Keywords (C++/CLI and C++/CX) +# Context-Sensitive Keywords (C++/CLI and C++/CX) *Context-sensitive keywords* are language elements that are recognized only in specific contexts. Outside the specific context, a context-sensitive keyword can be a user-defined symbol. diff --git a/docs/extensions/delegate-cpp-component-extensions.md b/docs/extensions/delegate-cpp-component-extensions.md index 127af663e74..917f4954096 100644 --- a/docs/extensions/delegate-cpp-component-extensions.md +++ b/docs/extensions/delegate-cpp-component-extensions.md @@ -1,13 +1,12 @@ --- -description: "Learn more about: delegate (C++/CLI and C++/CX)" -title: "delegate (C++/CLI and C++/CX)" -ms.date: "10/12/2018" +title: "delegate (C++/CLI and C++/CX)" +description: "Learn more about: delegate (C++/CLI and C++/CX)" +ms.date: 10/12/2018 ms.topic: "reference" f1_keywords: ["delegate_cpp", "delegate"] helpviewer_keywords: ["delegate keyword [C++]"] -ms.assetid: 03caf23d-7873-4a23-9b34-becf42aaf429 --- -# delegate (C++/CLI and C++/CX) +# delegate (C++/CLI and C++/CX) Declares a type that represents a function pointer. diff --git a/docs/extensions/enum-class-cpp-component-extensions.md b/docs/extensions/enum-class-cpp-component-extensions.md index 38e1b9b11f0..9d90a533304 100644 --- a/docs/extensions/enum-class-cpp-component-extensions.md +++ b/docs/extensions/enum-class-cpp-component-extensions.md @@ -1,11 +1,10 @@ --- -description: "Learn more about: enum class (C++/CLI and C++/CX)" -title: "enum class (C++/CLI and C++/CX)" -ms.date: "10/12/2018" +title: "enum class (C++/CLI and C++/CX)" +description: "Learn more about: enum class (C++/CLI and C++/CX)" +ms.date: 10/12/2018 ms.topic: "reference" -ms.assetid: 8010fa8c-bad6-45b4-8214-b4db64d7ffe1 --- -# enum class (C++/CLI and C++/CX) +# enum class (C++/CLI and C++/CX) Declares an enumeration at namespace scope, which is a user-defined type consisting of a set of named constants called enumerators. diff --git a/docs/extensions/exception-handling-cpp-component-extensions.md b/docs/extensions/exception-handling-cpp-component-extensions.md index 3c16ee20c28..56a65971ca7 100644 --- a/docs/extensions/exception-handling-cpp-component-extensions.md +++ b/docs/extensions/exception-handling-cpp-component-extensions.md @@ -1,12 +1,11 @@ --- -description: "Learn more about: Exception Handling (C++/CLI and C++/CX)" -title: "Exception Handling (C++/CLI and C++/CX)" -ms.date: "10/12/2018" +title: "Exception Handling (C++/CLI and C++/CX)" +description: "Learn more about: Exception Handling (C++/CLI and C++/CX)" +ms.date: 10/12/2018 ms.topic: "reference" helpviewer_keywords: ["structured exception handling [C++], managed exceptions", "Exception class, managed applications", "exception handling", "C++ exception handling", "exception handling, types of", "System::Exception class in managed applications"] -ms.assetid: ccb11fe8-6938-41ac-b477-a183e85865b9 --- -# Exception Handling (C++/CLI and C++/CX) +# Exception Handling (C++/CLI and C++/CX) Applications compiled with the `/ZW` compiler option or `/clr` compiler option both use *exceptions* to handle unexpected errors during program execution. The following topics discuss exception handling in either C++/CX or C++/CLI applications. diff --git a/docs/extensions/explicit-overrides-cpp-component-extensions.md b/docs/extensions/explicit-overrides-cpp-component-extensions.md index cb5e4288ab6..7a5a8f8bb22 100644 --- a/docs/extensions/explicit-overrides-cpp-component-extensions.md +++ b/docs/extensions/explicit-overrides-cpp-component-extensions.md @@ -1,12 +1,11 @@ --- -description: "Learn more about: Explicit Overrides (C++/CLI and C++/CX)" -title: "Explicit Overrides (C++/CLI and C++/CX)" -ms.date: "10/12/2018" +title: "Explicit Overrides (C++/CLI and C++/CX)" +description: "Learn more about: Explicit Overrides (C++/CLI and C++/CX)" +ms.date: 10/12/2018 ms.topic: "reference" helpviewer_keywords: ["overriding, override [C++]"] -ms.assetid: 4ec3eaf5-163b-4df8-8f16-7a2ec04c3d0f --- -# Explicit Overrides (C++/CLI and C++/CX) +# Explicit Overrides (C++/CLI and C++/CX) This topic discusses how to explicitly override a member of a base class or interface. A named (explicit) override should only be used to override a method with a derived method that has a different name. diff --git a/docs/extensions/generic-interfaces-visual-cpp.md b/docs/extensions/generic-interfaces-visual-cpp.md index 29f3456ca9a..5fa795e2ef7 100644 --- a/docs/extensions/generic-interfaces-visual-cpp.md +++ b/docs/extensions/generic-interfaces-visual-cpp.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: Generic Interfaces (C++/CLI)" title: "Generic Interfaces (C++/CLI)" -ms.date: "10/12/2018" +description: "Learn more about: Generic Interfaces (C++/CLI)" +ms.date: 10/12/2018 ms.topic: "reference" -helpviewer_keywords: ["generic interfaces", "interfaces, generic [C++}"] -ms.assetid: f3da788a-ba83-4db7-9dcf-9b95a8fb9d1a +helpviewer_keywords: ["generic interfaces", "interfaces, generic [C++]"] --- # Generic Interfaces (C++/CLI) diff --git a/docs/extensions/generics-cpp-component-extensions.md b/docs/extensions/generics-cpp-component-extensions.md index 6d268126910..3826f8d3dbe 100644 --- a/docs/extensions/generics-cpp-component-extensions.md +++ b/docs/extensions/generics-cpp-component-extensions.md @@ -1,13 +1,12 @@ --- -title: "Generics (C++/CLI and C++/CX)" +title: "Generics (C++/CLI and C++/CX)" description: "Links to content about the C++/CLI and C++/CX generics features, types, and methods." ms.date: 09/25/2020 ms.topic: "reference" f1_keywords: ["generic_cpp", "generic"] helpviewer_keywords: ["generics [C++]"] -ms.assetid: c7ccc316-a411-4c00-b2e2-f0c0eadc6cfd --- -# Generics (C++/CLI and C++/CX) +# Generics (C++/CLI and C++/CX) Generics are parameterized types and methods. In this section, find out which generic features both the Windows Runtime and the common language runtime support, and which ones only the common language runtime supports. You'll also find out how to author your own generic methods and types in C++/CLI, and how to use generic types authored in a .NET Framework language in C++/CLI. Finally, this section provides a comparison of generics and C++ templates. diff --git a/docs/extensions/handle-to-object-operator-hat-cpp-component-extensions.md b/docs/extensions/handle-to-object-operator-hat-cpp-component-extensions.md index 089f64f26e2..8bed5655da4 100644 --- a/docs/extensions/handle-to-object-operator-hat-cpp-component-extensions.md +++ b/docs/extensions/handle-to-object-operator-hat-cpp-component-extensions.md @@ -1,12 +1,11 @@ --- -description: "Learn more about: Handle to Object Operator (^) (C++/CLI and C++/CX)" -title: "Handle to Object Operator (^) (C++/CLI and C++/CX)" -ms.date: "10/12/2018" +title: "Handle to Object Operator (^) (C++/CLI and C++/CX)" +description: "Learn more about: Handle to Object Operator (^) (C++/CLI and C++/CX)" +ms.date: 10/12/2018 ms.topic: "reference" helpviewer_keywords: ["^ handle to object [C++]"] -ms.assetid: 70c411e6-be57-4468-a944-6ea7be89f392 --- -# Handle to Object Operator (^) (C++/CLI and C++/CX) +# Handle to Object Operator (^) (C++/CLI and C++/CX) The *handle declarator* (`^`, pronounced "hat"), modifies the type [specifier](../cpp/declarations-and-definitions-cpp.md) to mean that the declared object should be automatically deleted when the system determines that the object is no longer accessible. diff --git a/docs/extensions/how-to-declare-interior-pointers-with-the-const-keyword-cpp-cli.md b/docs/extensions/how-to-declare-interior-pointers-with-the-const-keyword-cpp-cli.md index 85f3d4fba8e..7a4bb01bf45 100644 --- a/docs/extensions/how-to-declare-interior-pointers-with-the-const-keyword-cpp-cli.md +++ b/docs/extensions/how-to-declare-interior-pointers-with-the-const-keyword-cpp-cli.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: How to: Declare Interior Pointers with the const Keyword (C++/CLI)" title: "How to: Declare Interior Pointers with the const Keyword (C++/CLI)" -ms.date: "10/12/2018" +description: "Learn more about: How to: Declare Interior Pointers with the const Keyword (C++/CLI)" +ms.date: 10/12/2018 ms.topic: "reference" helpviewer_keywords: ["pointers, interior"] -ms.assetid: 64e08b0e-9396-4046-ab51-8f6588f32330 --- # How to: Declare Interior Pointers with the const Keyword (C++/CLI) @@ -69,7 +68,7 @@ int main() { G ^ const h_G2 = gcnew G; // interior pointers to this object cannot be dereferenced and changed h_G2->msg = "test"; interior_ptr int_ptr_G2 = &(h_G->msg); -}; +} ``` ## See also diff --git a/docs/extensions/how-to-overload-functions-with-interior-pointers-and-native-pointers-cpp-cli.md b/docs/extensions/how-to-overload-functions-with-interior-pointers-and-native-pointers-cpp-cli.md index 0065f44486a..5caafaeebf6 100644 --- a/docs/extensions/how-to-overload-functions-with-interior-pointers-and-native-pointers-cpp-cli.md +++ b/docs/extensions/how-to-overload-functions-with-interior-pointers-and-native-pointers-cpp-cli.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: How to: Overload Functions with Interior Pointers and Native Pointers (C++/CLI)" title: "How to: Overload Functions with Interior Pointers and Native Pointers (C++/CLI)" -ms.date: "10/12/2018" +description: "Learn more about: How to: Overload Functions with Interior Pointers and Native Pointers (C++/CLI)" +ms.date: 10/12/2018 ms.topic: "reference" helpviewer_keywords: ["Functions with interior and native pointers, overloading"] -ms.assetid: d70df625-4aad-457c-84f5-70a0a290cc1f --- # How to: Overload Functions with Interior Pointers and Native Pointers (C++/CLI) @@ -49,7 +48,7 @@ int main() { G ^pG = gcnew G; // common language runtime heap f( &pS->i ); f( &pG->i ); -}; +} ``` ```Output diff --git a/docs/extensions/interface-class-cpp-component-extensions.md b/docs/extensions/interface-class-cpp-component-extensions.md index 9688279ef0a..d4e614dc8ac 100644 --- a/docs/extensions/interface-class-cpp-component-extensions.md +++ b/docs/extensions/interface-class-cpp-component-extensions.md @@ -1,13 +1,12 @@ --- +title: "interface class (C++/CLI and C++/CX)" description: "Learn more about: interface class (C++/CLI and C++/CX)" -title: "interface class (C++/CLI and C++/CX)" ms.date: 04/15/2022 ms.topic: "reference" f1_keywords: ["interface_CPP", "interface class", "interface class_CPP"] helpviewer_keywords: ["interface class keyword", "interface struct keyword"] -ms.assetid: 3ccea701-f50b-4da7-ad6b-f0ee1203e2b9 --- -# `interface class` (C++/CLI and C++/CX) +# `interface class` (C++/CLI and C++/CX) Declares an interface. For information on native interfaces, see [`__interface`](../cpp/interface.md). diff --git a/docs/extensions/new-new-slot-in-vtable-cpp-component-extensions.md b/docs/extensions/new-new-slot-in-vtable-cpp-component-extensions.md index adba09017e4..4c1932c3068 100644 --- a/docs/extensions/new-new-slot-in-vtable-cpp-component-extensions.md +++ b/docs/extensions/new-new-slot-in-vtable-cpp-component-extensions.md @@ -1,12 +1,11 @@ --- -description: "Learn more about: new (new slot in vtable) (C++/CLI and C++/CX)" -title: "new (new slot in vtable) (C++/CLI and C++/CX)" -ms.date: "10/12/2018" +title: "new (new slot in vtable) (C++/CLI and C++/CX)" +description: "Learn more about: new (new slot in vtable) (C++/CLI and C++/CX)" +ms.date: 10/12/2018 ms.topic: "reference" helpviewer_keywords: ["new keyword [C++]"] -ms.assetid: 1a9a5704-f02f-46ae-ad65-f0f2b6dbabc3 --- -# new (new slot in vtable) (C++/CLI and C++/CX) +# new (new slot in vtable) (C++/CLI and C++/CX) The **`new`** keyword indicates that a virtual member will get a new slot in the vtable. diff --git a/docs/extensions/nullptr-cpp-component-extensions.md b/docs/extensions/nullptr-cpp-component-extensions.md index e9972a7c692..e0784388095 100644 --- a/docs/extensions/nullptr-cpp-component-extensions.md +++ b/docs/extensions/nullptr-cpp-component-extensions.md @@ -1,12 +1,11 @@ --- -description: "Learn more about: nullptr (C++/CLI and C++/CX)" -title: "nullptr (C++/CLI and C++/CX)" -ms.date: "10/12/2018" +title: "nullptr (C++/CLI and C++/CX)" +description: "Learn more about: nullptr (C++/CLI and C++/CX)" +ms.date: 10/12/2018 ms.topic: "reference" helpviewer_keywords: ["__nullptr keyword (C++)", "nullptr keyword [C++]"] -ms.assetid: 594cfbf7-06cb-4366-9ede-c0b703e1d095 --- -# nullptr (C++/CLI and C++/CX) +# nullptr (C++/CLI and C++/CX) The **`nullptr`** keyword represents a *null pointer value*. Use a null pointer value to indicate that an object handle, interior pointer, or native pointer type does not point to an object. diff --git a/docs/extensions/override-cpp-component-extensions.md b/docs/extensions/override-cpp-component-extensions.md index 5f6305c840c..3dbe034d525 100644 --- a/docs/extensions/override-cpp-component-extensions.md +++ b/docs/extensions/override-cpp-component-extensions.md @@ -1,12 +1,11 @@ --- -description: "Learn more about: override (C++/CLI and C++/CX)" -title: "override (C++/CLI and C++/CX)" -ms.date: "11/04/2016" +title: "override (C++/CLI and C++/CX)" +description: "Learn more about: override (C++/CLI and C++/CX)" +ms.date: 11/04/2016 ms.topic: "reference" helpviewer_keywords: ["overriding, override keyword [C++]", "override keyword [C++]"] -ms.assetid: 34d19257-1686-4fcd-96f5-af07c70ba914 --- -# override (C++/CLI and C++/CX) +# override (C++/CLI and C++/CX) The **override** context-sensitive keyword indicates that a member of a type overrides a base class or a base interface member. diff --git a/docs/extensions/override-specifiers-cpp-component-extensions.md b/docs/extensions/override-specifiers-cpp-component-extensions.md index 0534d54ecb9..ea644986a34 100644 --- a/docs/extensions/override-specifiers-cpp-component-extensions.md +++ b/docs/extensions/override-specifiers-cpp-component-extensions.md @@ -1,12 +1,11 @@ --- -description: "Learn more about: Override Specifiers (C++/CLI and C++/CX)" -title: "Override Specifiers (C++/CLI and C++/CX)" -ms.date: "10/12/2018" +title: "Override Specifiers (C++/CLI and C++/CX)" +description: "Learn more about: Override Specifiers (C++/CLI and C++/CX)" +ms.date: 10/12/2018 ms.topic: "reference" helpviewer_keywords: ["override specifiers, C++", "override specifiers"] -ms.assetid: 155bbf6f-4722-4654-afb1-9cb52af799fb --- -# Override Specifiers (C++/CLI and C++/CX) +# Override Specifiers (C++/CLI and C++/CX) *Override specifiers* modify how inherited types and members of inherited types behave in derived types. diff --git a/docs/extensions/partial-cpp-component-extensions.md b/docs/extensions/partial-cpp-component-extensions.md index 90084a64c30..4a133fd0ded 100644 --- a/docs/extensions/partial-cpp-component-extensions.md +++ b/docs/extensions/partial-cpp-component-extensions.md @@ -1,13 +1,12 @@ --- -description: "Learn more about: partial (C++/CLI and C++/CX)" -title: "partial (C++/CLI and C++/CX)" -ms.date: "10/12/2018" +title: "partial (C++/CLI and C++/CX)" +description: "Learn more about: partial (C++/CLI and C++/CX)" +ms.date: 10/12/2018 ms.topic: "reference" f1_keywords: ["partial_CPP"] helpviewer_keywords: ["partial", "C++/CX, partial"] -ms.assetid: 43adf1f5-10c5-44aa-a66f-7507e2bdabf8 --- -# partial (C++/CLI and C++/CX) +# partial (C++/CLI and C++/CX) The **partial** keyword enables different parts of the same ref class to be authored independently and in different files. @@ -45,7 +44,7 @@ The name of the defined type. A partial class supports scenarios where you modify one part of a class definition in one file, and automatic code-generating software—for example, the XAML designer—modifies code in the same class in another file. By using a partial class, you can prevent the automatic code generator from overwriting your code. In a Visual Studio project, the **partial** modifier is applied automatically to the generated file. -Contents: With two exceptions, a partial class definition can contain anything that the full class definition could contain if the **partial** keyword was omitted. However, you can't specify class accessibility (for example, `public partial class X { ... };`), or a **declspec**. +Contents: With two exceptions, a partial class definition can contain anything that the full class definition could contain if the **partial** keyword was omitted. However, you can't specify class accessibility (for example, `public partial class X { ... };`), or a **declspec**. Access specifiers used in a partial class definition for *identifier* do not affect the default accessibility in a subsequent partial or full class definition for *identifier*. Inline definitions of static data members are allowed. diff --git a/docs/extensions/pin-ptr-cpp-cli.md b/docs/extensions/pin-ptr-cpp-cli.md index c5c3f29afd2..ea3baddba4c 100644 --- a/docs/extensions/pin-ptr-cpp-cli.md +++ b/docs/extensions/pin-ptr-cpp-cli.md @@ -1,11 +1,10 @@ --- -description: "Learn more about: pin_ptr (C++/CLI)" title: "pin_ptr (C++/CLI)" -ms.date: "10/12/2018" +description: "Learn more about: pin_ptr (C++/CLI)" +ms.date: 10/12/2018 ms.topic: "reference" f1_keywords: ["pin_ptr_cpp", "stdcli::language::pin_ptr", "pin_ptr"] helpviewer_keywords: ["pinning pointers", "pin_ptr keyword [C++]"] -ms.assetid: 6c2e6c73-4ec2-4dce-8e1f-ccf3a9f9d0aa --- # pin_ptr (C++/CLI) @@ -164,7 +163,7 @@ int main() { k = l; // ok Console::WriteLine(*k); -}; +} ``` ```Output diff --git a/docs/extensions/platform-default-and-cli-namespaces-cpp-component-extensions.md b/docs/extensions/platform-default-and-cli-namespaces-cpp-component-extensions.md index 7915908d659..ee36ff73725 100644 --- a/docs/extensions/platform-default-and-cli-namespaces-cpp-component-extensions.md +++ b/docs/extensions/platform-default-and-cli-namespaces-cpp-component-extensions.md @@ -1,13 +1,12 @@ --- -description: "Learn more about: Platform, default, and cli Namespaces (C++/CLI and C++/CX)" -title: "Platform, default, and cli Namespaces (C++/CLI and C++/CX)" -ms.date: "10/12/2018" +title: "Platform, default, and cli Namespaces (C++/CLI and C++/CX)" +description: "Learn more about: Platform, default, and cli Namespaces (C++/CLI and C++/CX)" +ms.date: 10/12/2018 ms.topic: "reference" f1_keywords: ["lang", "cli"] helpviewer_keywords: ["lang namespace", "cli namespace"] -ms.assetid: 9d38bd1e-dc78-47d1-a84b-9b4683e52c9c --- -# Platform, default, and cli Namespaces (C++/CLI and C++/CX) +# Platform, default, and cli Namespaces (C++/CLI and C++/CX) A namespace qualifies the names of language elements so the names do not conflict with otherwise identical names elsewhere in the source code. For example, a name collision might prevent the compiler from recognizing [Context-Sensitive Keywords](context-sensitive-keywords-cpp-component-extensions.md). Namespaces are used by the compiler but are not preserved in the compiled assembly. diff --git a/docs/extensions/ref-new-gcnew-cpp-component-extensions.md b/docs/extensions/ref-new-gcnew-cpp-component-extensions.md index c2a9a423422..13c1a6812be 100644 --- a/docs/extensions/ref-new-gcnew-cpp-component-extensions.md +++ b/docs/extensions/ref-new-gcnew-cpp-component-extensions.md @@ -1,13 +1,12 @@ --- -description: "Learn more about: ref new, gcnew (C++/CLI and C++/CX)" -title: "ref new, gcnew (C++/CLI and C++/CX)" -ms.date: "10/12/2018" +title: "ref new, gcnew (C++/CLI and C++/CX)" +description: "Learn more about: ref new, gcnew (C++/CLI and C++/CX)" +ms.date: 10/12/2018 ms.topic: "reference" f1_keywords: ["gcnew", "ref new", "gcnew_cpp"] helpviewer_keywords: ["ref new keyword (C++)", "gcnew keyword [C++]"] -ms.assetid: 388a62da-c2df-4a94-a9a2-205b53e577da --- -# ref new, gcnew (C++/CLI and C++/CX) +# ref new, gcnew (C++/CLI and C++/CX) The **ref new** aggregate keyword allocates an instance of a type that is garbage collected when the object becomes inaccessible, and that returns a handle ([^](handle-to-object-operator-hat-cpp-component-extensions.md)) to the allocated object. diff --git a/docs/extensions/safe-cast-cpp-component-extensions.md b/docs/extensions/safe-cast-cpp-component-extensions.md index 800fe8605f3..a35a3a2af94 100644 --- a/docs/extensions/safe-cast-cpp-component-extensions.md +++ b/docs/extensions/safe-cast-cpp-component-extensions.md @@ -5,11 +5,10 @@ ms.date: "10/12/2018" ms.topic: "reference" f1_keywords: ["safe_cast", "safe_cast_cpp", "stdcli::language::safe_cast"] helpviewer_keywords: ["safe_cast keyword [C++]"] -ms.assetid: 4fa688bf-a8ec-49bc-a4c5-f48134efa4f7 --- # safe_cast (C++/CLI and C++/CX) -The **safe_cast** operation returns the specified expression as the specified type, if successful; otherwise, throws `InvalidCastException`. +The **`safe_cast`** operation returns the specified expression as the specified type. If the operation isn't successful, it throws an `InvalidCastException`. ## All Runtimes @@ -23,7 +22,7 @@ The **safe_cast** operation returns the specified expression as the specified ty ## Windows Runtime -**safe_cast** allows you to change the type of a specified expression. In situations where you fully expect a variable or parameter to be convertible to a certain type, you can use **safe_cast** without a **try-catch** block to detect programming errors during development. For more information, see [Casting (C++/CX)](../cppcx/casting-c-cx.md). +Use **`safe_cast`** to change the type of a specified expression. If you expect a variable or parameter to be convertible to a certain type, use **`safe_cast`** without a **try-catch** block to detect programming errors during development. For more information, see [Casting (C++/CX)](../cppcx/casting-c-cx.md). ### Syntax @@ -41,7 +40,7 @@ An expression that evaluates to a handle to a reference or value type, a value t ### Remarks -**safe_cast** throws `InvalidCastException` if it cannot convert *expression* to the type specified by *type-id*. To catch `InvalidCastException`, specify the [/EH (Exception Handling Model)](../build/reference/eh-exception-handling-model.md) compiler option, and use a **try/catch** statement. +**`safe_cast`** throws `InvalidCastException` if it can't convert *expression* to the type specified by *type-id*. To catch `InvalidCastException`, specify the [/EH (Exception Handling Model)](../build/reference/eh-exception-handling-model.md) compiler option, and use a **try/catch** statement. ### Requirements @@ -49,7 +48,7 @@ Compiler option: `/ZW` ### Examples -The following code example demonstrates how to use **safe_cast** with the Windows Runtime. +The following code example demonstrates how to use **`safe_cast`** with the Windows Runtime. ```cpp // safe_cast_ZW.cpp @@ -83,7 +82,7 @@ Caught expected exception: InvalidCastException ## Common Language Runtime -**safe_cast** allows you to change the type of an expression and generate verifiable MSIL code. +**`safe_cast`** changes the type of an expression and generates verifiable MSIL code. ### Syntax @@ -93,30 +92,29 @@ Caught expected exception: InvalidCastException ### Parameters -*type-id*
+*`type-id`*\ A handle to a reference or value type, a value type, or a tracking reference to a reference or value type. -*expression*
+*`expression`* An expression that evaluates to a handle to a reference or value type, a value type, or a tracking reference to a reference or value type. ### Remarks The expression `safe_cast<`*type-id*`>(`*expression*`)` converts the operand *expression* to an object of type *type-id*. -The compiler will accept a [static_cast](../cpp/static-cast-operator.md) in most places that it will accept a **safe_cast**. However, **safe_cast** is guaranteed to produce verifiable MSIL, whereas a **`static_cast`** could produce unverifiable MSIL. See [Pure and Verifiable Code (C++/CLI)](../dotnet/pure-and-verifiable-code-cpp-cli.md) and [Peverify.exe (PEVerify Tool)](/dotnet/framework/tools/peverify-exe-peverify-tool) for more information on verifiable code. +The compiler accepts a [`static_cast`](../cpp/static-cast-operator.md) in most places that it accepts a **`safe_cast`**. However, **`safe_cast`** always produces verifiable MSIL, whereas a **`static_cast`** might produce unverifiable MSIL. For more information on verifiable code, see [Pure and Verifiable Code (C++/CLI)](../dotnet/pure-and-verifiable-code-cpp-cli.md) and [`Peverify.exe` (PEVerify Tool)](/dotnet/framework/tools/peverify-exe-peverify-tool). -Like **`static_cast`**, **safe_cast** invokes user-defined conversions. +Like **`static_cast`**, **`safe_cast`** invokes user-defined conversions. For more information about casts, see [Casting Operators](../cpp/casting-operators.md). -**safe_cast** does not apply a **`const_cast`** (cast away **`const`**). +**`safe_cast`** doesn't apply a **`const_cast`** (cast away **`const`**). -**safe_cast** is in the cli namespace. See [Platform, default, and cli Namespaces](platform-default-and-cli-namespaces-cpp-component-extensions.md) for more information. +**`safe_cast`** is in the cli namespace. For more information, see [Platform, default, and cli Namespaces](platform-default-and-cli-namespaces-cpp-component-extensions.md). -For more information on **safe_cast**, see: +For more information on **`safe_cast`**, see: - [C-Style Casts with /clr (C++/CLI)](c-style-casts-with-clr-cpp-cli.md) - - [How to: Use safe_cast in C++/CLI](../dotnet/how-to-use-safe-cast-in-cpp-cli.md) ### Requirements @@ -125,7 +123,7 @@ Compiler option: `/clr` ### Examples -One example of where the compiler will not accept a **`static_cast`** but will accept a **safe_cast** is for casts between unrelated interface types. With **safe_cast**, the compiler will not issue a conversion error and will perform a check at runtime to see if the cast is possible +One example of where the compiler doesn't accept a **`static_cast`** but accepts a **`safe_cast`** is for casts between unrelated interface types. With **`safe_cast`**, the compiler doesn't issue a conversion error and performs a check at runtime to see if the cast is possible. ```cpp // safe_cast.cpp diff --git a/docs/extensions/sealed-cpp-component-extensions.md b/docs/extensions/sealed-cpp-component-extensions.md index 1229c6747d0..e44afac2b7d 100644 --- a/docs/extensions/sealed-cpp-component-extensions.md +++ b/docs/extensions/sealed-cpp-component-extensions.md @@ -1,13 +1,12 @@ --- -description: "Learn more about: sealed (C++/CLI and C++/CX)" -title: "sealed (C++/CLI and C++/CX)" -ms.date: "10/12/2018" +title: "sealed (C++/CLI and C++/CX)" +description: "Learn more about: sealed (C++/CLI and C++/CX)" +ms.date: 10/12/2018 ms.topic: "reference" f1_keywords: ["sealed_cpp", "sealed"] helpviewer_keywords: ["sealed keyword [C++]"] -ms.assetid: 3d0d688a-41aa-45f5-a25a-65c44206521e --- -# sealed (C++/CLI and C++/CX) +# sealed (C++/CLI and C++/CX) **sealed** is a context-sensitive keyword for ref classes that indicates that a virtual member cannot be overridden, or that a type cannot be used as a base type. diff --git a/docs/extensions/string-cpp-component-extensions.md b/docs/extensions/string-cpp-component-extensions.md index 57a1c3d6380..972ab5c2329 100644 --- a/docs/extensions/string-cpp-component-extensions.md +++ b/docs/extensions/string-cpp-component-extensions.md @@ -1,12 +1,11 @@ --- -description: "Learn more about: String (C++/CLI and C++/CX)" -title: "String (C++/CLI and C++/CX)" -ms.date: "10/08/2018" +title: "String (C++/CLI and C++/CX)" +description: "Learn more about: String (C++/CLI and C++/CX)" +ms.date: 10/08/2018 ms.topic: "reference" helpviewer_keywords: ["string support with /clr", "/clr compiler option [C++], string support"] -ms.assetid: c695f965-9be0-4e20-9661-373bfee6557e --- -# String (C++/CLI and C++/CX) +# String (C++/CLI and C++/CX) The Windows Runtime and common language runtime represent strings as objects whose allocated memory is managed automatically. That is, you are not required to explicitly discard the memory for a string when the string variable goes out of scope or your application ends. To indicate that the lifetime of a string object is to be managed automatically, declare the string type with the [handle-to-object (^)](handle-to-object-operator-hat-cpp-component-extensions.md) modifier. @@ -50,7 +49,7 @@ When passed a , the compiler will box, if necessary, and the > [!NOTE] > The caret ("^") indicates that the declared variable is a handle to a C++/CLI managed object. -For more information see [String and Character Literals](../cpp/string-and-character-literals-cpp.md). +For more information, see [String and Character Literals](../cpp/string-and-character-literals-cpp.md). ### Requirements @@ -104,7 +103,7 @@ int main() { if (a != b) Console::WriteLine("a and b are not equal"); - // System:String^ and tracking reference + // System::String^ and tracking reference String^% rstr1 = a; Console::WriteLine(rstr1); @@ -211,11 +210,11 @@ The following sample shows that the compiler distinguishes between native string using namespace System; int func() { throw "simple string"; // const char * -}; +} int func2() { throw "string" + "string"; // returns System::String -}; +} template void func3(T t) { @@ -254,6 +253,6 @@ System.String ## See also -[Component Extensions for .NET and UWP](component-extensions-for-runtime-platforms.md)
-[String and Character Literals](../cpp/string-and-character-literals-cpp.md)
+[Component Extensions for .NET and UWP](component-extensions-for-runtime-platforms.md)\ +[String and Character Literals](../cpp/string-and-character-literals-cpp.md)\ [/clr (Common Language Runtime Compilation)](../build/reference/clr-common-language-runtime-compilation.md) diff --git a/docs/extensions/typeid-cpp-component-extensions.md b/docs/extensions/typeid-cpp-component-extensions.md index 3d8cb2389cd..fe3b1ffcb1e 100644 --- a/docs/extensions/typeid-cpp-component-extensions.md +++ b/docs/extensions/typeid-cpp-component-extensions.md @@ -1,12 +1,11 @@ --- -description: "Learn more about: typeid (C++/CLI and C++/CX)" -title: "typeid (C++/CLI and C++/CX)" -ms.date: "10/12/2018" +title: "typeid (C++/CLI and C++/CX)" +description: "Learn more about: typeid (C++/CLI and C++/CX)" +ms.date: 10/12/2018 ms.topic: "reference" helpviewer_keywords: ["typeid keyword [C++]"] -ms.assetid: e9706cae-e7c4-4d6d-b474-646d73df3e70 --- -# typeid (C++/CLI and C++/CX) +# typeid (C++/CLI and C++/CX) Gets a value that indicates the type of an object. @@ -41,7 +40,7 @@ A type name. ### Remarks -In C++/CX, typeid returns a [Platform::Type](../cppcx/platform-type-class.md) that is constructed from runtime type information. +In C++/CX, typeid returns a [Platform::Type](../cppcx/platform-type-class.md) that is constructed from runtime type information. ### Requirements diff --git a/docs/extensions/user-defined-attributes-cpp-component-extensions.md b/docs/extensions/user-defined-attributes-cpp-component-extensions.md index bf6add627c2..f9f9b7c0346 100644 --- a/docs/extensions/user-defined-attributes-cpp-component-extensions.md +++ b/docs/extensions/user-defined-attributes-cpp-component-extensions.md @@ -1,12 +1,11 @@ --- -description: "Learn more about: User-Defined Attributes (C++/CLI and C++/CX)" -title: "User-Defined Attributes (C++/CLI and C++/CX)" -ms.date: "10/12/2018" +title: "User-Defined Attributes (C++/CLI and C++/CX)" +description: "Learn more about: User-Defined Attributes (C++/CLI and C++/CX)" +ms.date: 10/12/2018 ms.topic: "reference" helpviewer_keywords: ["metadata, extending", "custom attributes, extending metadata"] -ms.assetid: 98b29048-a3ea-4698-8441-f149cdaec9fb --- -# User-Defined Attributes (C++/CLI and C++/CX) +# User-Defined Attributes (C++/CLI and C++/CX) C++/CLI and C++/CX enable you to create platform-specific attributes that extend the metadata of an interface, class or structure, method, parameter, or enumeration. These attributes are distinct from the [standard C++ attributes](../cpp/attributes.md). diff --git a/docs/get-started/index.yml b/docs/get-started/index.yml index d338b6c128e..f179d269b5f 100644 --- a/docs/get-started/index.yml +++ b/docs/get-started/index.yml @@ -1,6 +1,6 @@ ### YamlMime:Landing -title: Visual Studio tutorials | C++ +title: Visual Studio tutorials | C++ summary: Create C++ apps with Visual Studio. metadata: @@ -10,7 +10,7 @@ metadata: ms.topic: landing-page ms.date: 12/06/2021 author: tylermsft - ms.author: twhitney + ms.author: twhitney manager: coxford ms.service: visual-cpp dev_langs: diff --git a/docs/get-started/toc.yml b/docs/get-started/toc.yml index 224ea3f49a3..32d38ad40ef 100644 --- a/docs/get-started/toc.yml +++ b/docs/get-started/toc.yml @@ -1,11 +1,13 @@ items: -- name: Get started with Visual C++ +- name: Get started with Microsoft C++ expanded: true items: - name: Install C++ support in Visual Studio href: ../build/vscpp-step-0-installation.md - name: Visual Studio guided tour href: /visualstudio/get-started/visual-studio-ide + - name: Use AI to create a C++ console application in Visual Studio + href: ../build/use-github-copilot-create-cpp-console-app.md - name: Create and edit a C++ console app project href: ../build/vscpp-step-1-create.md - name: Build and run a C++ console app project @@ -25,7 +27,7 @@ items: items: - name: Create a console app href: tutorial-console-cpp.md - - name: Create a Universal Windows Platform app + - name: Create a Universal Windows Platform app href: /windows/uwp/cpp-and-winrt-apis/get-started - name: Create a Windows Desktop app href: /windows/desktop/learnwin32/learn-to-program-for-windows @@ -44,9 +46,9 @@ items: items: - name: Open code from a repo href: /visualstudio/get-started/tutorial-open-project-from-repo - - name: Write and edit code + - name: Write and edit code href: /visualstudio/get-started/tutorial-editor - - name: Compile and build + - name: Compile and build href: /visualstudio/ide/compiling-and-building-in-visual-studio - name: Debug your C++ code href: /visualstudio/debugger/quickstart-debug-with-cplusplus diff --git a/docs/get-started/tutorial-console-cpp.md b/docs/get-started/tutorial-console-cpp.md index 9ae384bf2c4..608ab706e06 100644 --- a/docs/get-started/tutorial-console-cpp.md +++ b/docs/get-started/tutorial-console-cpp.md @@ -1,6 +1,6 @@ --- title: "Create a console calculator in C++" -description: "Create a Hello World console app and a calculator app in Visual C++" +description: "Create a Hello World console app and a calculator app in Visual Studio C++" ms.custom: "acquisition, mvc" ms.date: 10/08/2024 ms.topic: "tutorial" @@ -27,7 +27,7 @@ Visual Studio uses *projects* to organize the code for an app, and *solutions* t The dialog has options to clone a repository, open a project or solution, open a local folder, and create a new project." :::image-end::: -1. In the **Create a new project** dialog, set the language dropdown to **C++**, set the platform dropdown to **Windows**, select **Console App** from the list of project types, then select **Next**. +1. In the **Create a new project** dialog, set the language dropdown to **C++**, set the platform dropdown to **Windows**, select **Console App** from the list of project types, then select **Next**. :::image type="complex" source="./media/calc-vs2022-choose-console-app.png" alt-text="Screenshot of the Visual Studio Create a new project dialog."::: The language dropdown is set to C++, the platform dropdown is set to Windows, and project types like Empty Project, Console App, CMake Project, Windows Desktop Wizard, and so on, appear in the list of project types." @@ -433,7 +433,8 @@ Visual Studio uses *projects* to organize the code for an app, and *solutions* t 3. In the **Name** textbox at the bottom, name the new project *CalculatorTutorial*, then select **OK**. :::image type="complex" source="./media/calc-vs2017-new-project-dialog.png" alt-text="Screenshot of the New Project dialog."::: - On the left, Other Languages > Visual C++ is selected. In the center, the Console App project type is selected. The Name text box contains CalculatorTutorial."::: + On the left, Other Languages > Visual C++ is selected. In the center, the Console App project type is selected. The Name text box contains CalculatorTutorial. + :::image-end::: An empty C++ Windows console application 'Hello World' app is created. Console applications use a Windows console window to display output and accept user input. In Visual Studio, an editor window opens and shows the generated code: diff --git a/docs/ide/add-interface-definition-library-method-wizard.md b/docs/ide/add-interface-definition-library-method-wizard.md index 6f4430b635b..af92363f297 100644 --- a/docs/ide/add-interface-definition-library-method-wizard.md +++ b/docs/ide/add-interface-definition-library-method-wizard.md @@ -5,6 +5,7 @@ ms.date: "04/13/2022" f1_keywords: ["vc.codewiz.method.overview", "vc.codewiz.method.idlattrib"] helpviewer_keywords: ["add IDL method wizard [C++]", "IDL methods [C++], adding", "methods [C++], adding using wizards", "IDL attributes, add an IDL method wizard"] ms.custom: devdivchpfy22 +ms.topic: how-to --- # Add an IDL method diff --git a/docs/ide/add-interface-definition-library-property-wizard.md b/docs/ide/add-interface-definition-library-property-wizard.md index c12abece36d..8391d750929 100644 --- a/docs/ide/add-interface-definition-library-property-wizard.md +++ b/docs/ide/add-interface-definition-library-property-wizard.md @@ -5,6 +5,7 @@ ms.date: 04/14/2022 f1_keywords: ["vc.codewiz.prop.overview", "vc.codewiz.prop.idlattributes"] helpviewer_keywords: ["interfaces, adding properties", "properties [C++], adding to interfaces", "names, add property wizard", "IDL attributes", "stock properties, about stock properties", "stock properties"] ms.custom: devdivchpfy22 +ms.topic: how-to --- # Add an IDL property diff --git a/docs/ide/adding-a-class-from-an-activex-control-visual-cpp.md b/docs/ide/adding-a-class-from-an-activex-control-visual-cpp.md index 5fb6833df0d..7fceea68e7c 100644 --- a/docs/ide/adding-a-class-from-an-activex-control-visual-cpp.md +++ b/docs/ide/adding-a-class-from-an-activex-control-visual-cpp.md @@ -5,6 +5,7 @@ ms.date: 04/28/2023 f1_keywords: ["vc.codewiz.class.axcontrol"] helpviewer_keywords: ["ActiveX controls [C++], adding classes", "classes [C++], creating", "ActiveX Control Wizard", "add class from ActiveX control wizard [C++]"] ms.custom: devdivchpfy22 +ms.topic: how-to --- # Add a class from an ActiveX control diff --git a/docs/ide/adding-a-generic-cpp-class.md b/docs/ide/adding-a-generic-cpp-class.md index 9d7342c49c2..48e95baf99b 100644 --- a/docs/ide/adding-a-generic-cpp-class.md +++ b/docs/ide/adding-a-generic-cpp-class.md @@ -1,10 +1,10 @@ --- -description: "Learn more about: Add a generic C++ class" title: "Add a generic C++ class" -ms.date: "11/09/2018" +description: "Learn more about: Add a generic C++ class" +ms.date: 11/09/2018 +ms.topic: how-to f1_keywords: ["vc.codewiz.classes.adding.generic", "vc.codewiz.class.generic"] helpviewer_keywords: ["Visual C++, classes", "generic classes, adding", "generic classes", "generic C++ class wizard [C++]"] -ms.assetid: e95a5a14-dbed-4edc-8551-344fe48613cb --- # Add a generic C++ class @@ -12,7 +12,7 @@ You can add a generic C++ class by using **Class View**. A generic C++ class is ::: moniker range="msvc-140" -## To add a generic C++ class to a project: +## To add a generic C++ class to a project 1. In **Class View**, right-click the project to which you want to add the new class, choose **Add**, and then choose **Class**. diff --git a/docs/ide/adding-a-member-function-visual-cpp.md b/docs/ide/adding-a-member-function-visual-cpp.md index 4dd50a46717..0ae5d7ab880 100644 --- a/docs/ide/adding-a-member-function-visual-cpp.md +++ b/docs/ide/adding-a-member-function-visual-cpp.md @@ -5,6 +5,7 @@ ms.date: "11/09/2018" f1_keywords: ["vc.codewiz.classes.member.function", "vc.codewiz.function.overview"] helpviewer_keywords: ["member functions, adding to classes", "classes [C++], adding members", "add member function wizard [C++]"] ms.assetid: 55b25ddb-541d-44ed-957c-974ef91cfc85 +ms.topic: how-to --- # Add a member function diff --git a/docs/ide/adding-a-member-variable-visual-cpp.md b/docs/ide/adding-a-member-variable-visual-cpp.md index 853f4385133..76a6a69fd16 100644 --- a/docs/ide/adding-a-member-variable-visual-cpp.md +++ b/docs/ide/adding-a-member-variable-visual-cpp.md @@ -5,6 +5,7 @@ ms.date: "11/09/2018" f1_keywords: ["vc.codewiz.classes.member.variable", "vc.codewiz.variable.overview"] helpviewer_keywords: ["member variables, adding", "member variables", "add member variable wizard [C++]", "dialog box controls, member variables", "dialog box controls, variable types", "variables, dialog box control member variables"] ms.assetid: 437783bd-8eb4-4508-8b73-7380116e9d71 +ms.topic: how-to --- # Add a member variable diff --git a/docs/ide/adding-a-method-visual-cpp.md b/docs/ide/adding-a-method-visual-cpp.md index 6fdc77ce36e..c5e2c1e9944 100644 --- a/docs/ide/adding-a-method-visual-cpp.md +++ b/docs/ide/adding-a-method-visual-cpp.md @@ -5,6 +5,7 @@ ms.date: "03/31/2022" f1_keywords: ["vc.codewiz.method.overview", "vc.codewiz.method.idlattrib"] helpviewer_keywords: ["add method wizard [C++]", "methods [C++], adding", "methods [C++], adding using wizards", "IDL attributes, add method wizard"] ms.custom: devdivchpfy22 +ms.topic: how-to --- # Add a method @@ -59,4 +60,4 @@ Add a method to an interface by using the add method wizard: [Add an IDL method wizard](add-interface-definition-library-method-wizard.md)\ [Add an IDL MFC method wizard](../mfc/reference/add-idl-mfc-method-wizard.md)\ -[Adding functionality with code wizards](adding-functionality-with-code-wizards-cpp.md) \ No newline at end of file +[Adding functionality with code wizards](adding-functionality-with-code-wizards-cpp.md) diff --git a/docs/ide/adding-a-property-visual-cpp.md b/docs/ide/adding-a-property-visual-cpp.md index f710a05befb..4ec27fc8d6f 100644 --- a/docs/ide/adding-a-property-visual-cpp.md +++ b/docs/ide/adding-a-property-visual-cpp.md @@ -1,10 +1,11 @@ --- -description: "Learn more about: Add a property to an interface in a Microsoft Visual Studio C++ project" title: "Add a property" +description: "Learn more about: Add a property to an interface in a Microsoft Visual Studio C++ project" ms.date: 04/12/2022 f1_keywords: ["vc.codewiz.prop.overview"] helpviewer_keywords: ["interfaces, adding properties", "properties [C++], adding to interfaces", "names, add property wizard", "add property wizard", "stock properties, about stock properties", "stock properties"] ms.custom: devdivchpfy22 +ms.topic: how-to --- # Add a property @@ -52,8 +53,8 @@ The following section describes the UI that you'll use to add a property: For ATL interfaces **Put function** makes the property writable; that is, it creates the `Put` method for setting, or "putting," this property of the object. Select **Get**, **Put**, or both. -## See Also +## See also [Add IDL Property](add-interface-definition-library-property-wizard.md) -[Add IDL MFC Property](../mfc/reference/add-interface-definition-library-mfc-property-wizard.md) \ No newline at end of file +[Add IDL MFC Property](../mfc/reference/add-interface-definition-library-mfc-property-wizard.md) diff --git a/docs/ide/adding-an-event-handler-visual-cpp.md b/docs/ide/adding-an-event-handler-visual-cpp.md index b5bb5ac8e0b..0990bfb6222 100644 --- a/docs/ide/adding-an-event-handler-visual-cpp.md +++ b/docs/ide/adding-an-event-handler-visual-cpp.md @@ -5,6 +5,7 @@ ms.date: "11/12/2018" f1_keywords: ["vc.codewiz.eventhandler.overview"] helpviewer_keywords: ["event handlers, adding", "properties [Visual Studio], MSBuild", "MSBuild, properties", "event handler wizard [C++]"] ms.assetid: 050bebf0-a9e0-474b-905c-796fe5ac8fc3 +ms.topic: how-to --- # Add an event handler diff --git a/docs/ide/adding-an-event-visual-cpp.md b/docs/ide/adding-an-event-visual-cpp.md index 68c78c71bde..7a28e7de1ad 100644 --- a/docs/ide/adding-an-event-visual-cpp.md +++ b/docs/ide/adding-an-event-visual-cpp.md @@ -5,6 +5,7 @@ ms.date: "11/12/2018" f1_keywords: ["vc.codewiz.event.overview"] helpviewer_keywords: ["ActiveX controls [C++], adding events to", "MFC ActiveX controls [C++], adding events", "events [C++], ActiveX controls", "add event wizard [C++]"] ms.assetid: fe34832a-edfc-4f86-aacb-8df77001873d +ms.topic: how-to --- # Add an event diff --git a/docs/ide/adding-functionality-with-code-wizards-cpp.md b/docs/ide/adding-functionality-with-code-wizards-cpp.md index a5088db657d..4921258492d 100644 --- a/docs/ide/adding-functionality-with-code-wizards-cpp.md +++ b/docs/ide/adding-functionality-with-code-wizards-cpp.md @@ -4,6 +4,7 @@ title: "Adding Functionality with Code Wizards (C++)" ms.date: "05/14/2019" helpviewer_keywords: ["code wizards [C++]"] ms.assetid: 6afb7ef9-7056-423d-b244-91bb4236d1d7 +ms.topic: concept-article --- # Adding Functionality with Code Wizards (C++) diff --git a/docs/ide/cpp-linter-overview.md b/docs/ide/cpp-linter-overview.md index 07057453ac3..e6c987576c8 100644 --- a/docs/ide/cpp-linter-overview.md +++ b/docs/ide/cpp-linter-overview.md @@ -2,7 +2,7 @@ description: "Learn more about: IntelliSense code linter for C++" title: IntelliSense code linter for C++ overview ms.date: 09/30/2021 -ms.topic: conceptual +ms.topic: overview helpviewer_keywords: - "C/C++, linter" - "C++, linter" diff --git a/docs/ide/implementing-a-connection-point-visual-cpp.md b/docs/ide/implementing-a-connection-point-visual-cpp.md index 20e7d83b8aa..252f5ff9310 100644 --- a/docs/ide/implementing-a-connection-point-visual-cpp.md +++ b/docs/ide/implementing-a-connection-point-visual-cpp.md @@ -4,6 +4,7 @@ title: "Implement a connection point" ms.date: "05/14/2019" helpviewer_keywords: ["connection points [C++], implementing", "implement connection point wizard [C++]"] ms.assetid: 5b37e4f9-73c9-4bef-b26d-365bc0662260 +ms.topic: how-to --- # Implement a connection point diff --git a/docs/ide/implementing-an-interface-visual-cpp.md b/docs/ide/implementing-an-interface-visual-cpp.md index 7696bdfd9a2..fcb5cb92f34 100644 --- a/docs/ide/implementing-an-interface-visual-cpp.md +++ b/docs/ide/implementing-an-interface-visual-cpp.md @@ -5,6 +5,7 @@ ms.date: "11/12/2018" f1_keywords: ["vc.codewiz.impl.interface.overview"] helpviewer_keywords: ["interfaces, implementing", "implement interface wizard [C++]"] ms.assetid: 72f8731b-7e36-45db-8b10-7ef211a773cd +ms.topic: how-to --- # Implement an interface diff --git a/docs/ide/include-cleanup-config.md b/docs/ide/include-cleanup-config.md index 477149438f8..0f2b6d59871 100644 --- a/docs/ide/include-cleanup-config.md +++ b/docs/ide/include-cleanup-config.md @@ -1,7 +1,7 @@ --- title: "Configure C/C++ Include Cleanup in Visual Studio" description: "Learn how to configure C/C++ Include Cleanup." -ms.date: 10/10/2023 +ms.date: 01/23/2026 ms.topic: "how-to" f1_keywords: ["config include cleanup"] helpviewer_keywords: ["config include cleanup"] @@ -56,10 +56,10 @@ The `.editorconfig` settings that you can use with Include Cleanup are: |--|--|--|--| | `cpp_include_cleanup_add_missing_error_tag_type`

Sets the error level of add transitive include messages. | `none`
`suggestion`
`warning`
`error` | `cpp_include_cleanup_add_missing_error_tag_type = suggestion` | | `cpp_include_cleanup_remove_unused_error_tag_type`

Sets the error level of remove unused include messages. | `none`
`suggestion`
`warning`
`error`
`dimmed` | `cpp_include_cleanup_remove_unused_error_tag_type = dimmed` | -| `cpp_include_cleanup_excluded_files`

Excludes the specified files from Include Cleanup messages. You won’t get a suggestion related to the header at all, whether to add it or that it's unused. | *filename* | `cpp_include_cleanup_excluded_files = vcruntime.h, vcruntime_string.h` | +| `cpp_include_cleanup_excluded_files`

Excludes the specified files from Include Cleanup messages. You won't get a suggestion related to the header at all, whether to add it or that it's unused. | *filename* | `cpp_include_cleanup_excluded_files = vcruntime.h, vcruntime_string.h` | | `cpp_include_cleanup_required_files`

Specify that usage of *file1* requires *file2*. For example, specify that if you use `atlwin.h` that `altbase.h` must also be included. | *file1*:*file2* | `cpp_include_cleanup_required_files = atlwin.h:altbase.h, atlcom.h:altbase.h` | | `cpp_include_cleanup_replacement_files`

Replaces *file1* with *file2* during Include Cleanup processing. For example, you may prefer using `cstdio` over `stdio.h`. If you have a file with both `#include ` and `#include ` and you consume content only from `stdio.h`, with this setting Include Cleanup will tell you to remove `stdio.h` because it replaced the usage of `cstdio` with `stdio.h` during processing. If you don't use the contents from either, Include Cleanup will tell you to remove both.| *file1*:*file2* | `cpp_include_cleanup_replacement_files = stdio.h:cstdio,stdint.h:cstdint` | -| `cpp_include_cleanup_alternate_files`

Don't generate a message for indirect include *file2* if *file1* is included. For example, if you `#include ` and are only using something from its indirectly included header `winerror.h`, Include Cleanup won't prompt to add `winerror.h`. Useful when you prefer to include a facade header file instead of the indirect includes it contains. | *file1*:*file2* | `cpp_include_cleanup_alternate_files = windows.h:winerror.h, windows.h:minwindef.h` | +| `cpp_include_cleanup_alternate_files`

Suppress messages for indirect includes. For example, if you `#include ` and only use content from its indirectly included headers `winerror.h` or `minwindef.h`, the tool won't suggest adding them. | *file1*:*file2*[:*file3*...][,*file4*:*file5*...] | `cpp_include_cleanup_alternate_files = windows.h:winerror.h:minwindef.h`
or
`cpp_include_cleanup_alternate_files = windows.h:winerror.h:minwindef.h,umbrella.h:internal.h`| ## See also diff --git a/docs/ide/include-cleanup-overview.md b/docs/ide/include-cleanup-overview.md index 8bfcaa921ba..423b16a3440 100644 --- a/docs/ide/include-cleanup-overview.md +++ b/docs/ide/include-cleanup-overview.md @@ -56,7 +56,7 @@ int main() The issue is that `myProgram.cpp` uses `std::string` and `std::cout`, but doesn't directly include the headers that define them. This code happens to compile because `myHeader.h` includes those headers. This code is brittle because if `myHeader.h` ever stopped including either one, `myProgram.cpp` wouldn't compile anymore. -Per the C++ guidelines, it's better to explicitly include headers for all of your dependencies so that your code isn't subject to brittleness caused by changes to header files. For more information, see [C++ Core Guidelines SF.10](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#sf10-avoid-dependencies-on-implicitly-included-names). +Per the C++ guidelines, it's better to explicitly include headers for all of your dependencies so that your code isn't subject to brittleness caused by changes to header files. For more information, see [SF.10: Avoid dependencies on implicitly `#include`d names](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#sf10-avoid-dependencies-on-implicitly-included-names) in the C++ Core Guidelines. Include Cleanup analyzes your code to identify unused and indirectly included headers. It provides feedback based on the settings described in [Config the C++ #include tool in Visual Studio](include-cleanup-config.md). Feedback can be in the form of error list warnings, suggestions, etc. For more details on the feedback provided by Include Cleanup, refer [Include Cleanup messages](include-cleanup-messages.md). diff --git a/docs/ide/live-share-cpp.md b/docs/ide/live-share-cpp.md index 4a5fecdd502..6825a02fc28 100644 --- a/docs/ide/live-share-cpp.md +++ b/docs/ide/live-share-cpp.md @@ -1,7 +1,7 @@ --- title: "Collaborate with Live Share for C++ in Visual Studio" description: "Use Live Share for C++ in Visual Studio to collaborate and share code in real time." -ms.date: "05/24/2019" +ms.date: 05/24/2019 --- # Collaborate using Live Share for C++ @@ -44,7 +44,7 @@ To end a session, select **End Collaboration Session** from the **Sharing** drop For more information about **Live Share** in Visual Studio, see [What is Visual Studio Live Share?](/visualstudio/liveshare/). For more information about Live Share in Visual Studio Code, see [ Live Share](https://marketplace.visualstudio.com/items?itemName=ms-vsliveshare.vsliveshare). -## See Also +## See also [Edit and refactor code (C++)](writing-and-refactoring-code-cpp.md)
[Navigate your C++ code base in Visual Studio](navigate-code-cpp.md)
diff --git a/docs/ide/lnt-make-member-function-const.md b/docs/ide/lnt-make-member-function-const.md index 9e419bf9193..1e3439c952e 100644 --- a/docs/ide/lnt-make-member-function-const.md +++ b/docs/ide/lnt-make-member-function-const.md @@ -8,7 +8,7 @@ monikerRange: ">=msvc-170" --- # `lnt-make-member-function-const` -When a member function doesn’t modify the object's state, annotate it with the `const` keyword. This guidance comes from the [C++ Core Guideline Con.2](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#con2-by-default-make-member-functions-const). +When a member function doesn't modify the object's state, annotate it with the `const` keyword. This guidance comes from [Con.2: By default, make member functions `const`](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#con2-by-default-make-member-functions-const) in the C++ Core Guidelines. ## Example @@ -19,8 +19,8 @@ class MyClass { public: - int getValue() { return value; } // Flagged: ‘getValue’ doesn't modify the object's state. - void setValue(int newValue) { value = newValue; } // OK: ‘setValue’ modifies the object's state. + int getValue() { return value; } // Flagged: 'getValue' doesn't modify the object's state. + void setValue(int newValue) { value = newValue; } // OK: 'setValue' modifies the object's state. private: @@ -28,7 +28,7 @@ private: }; double getRadius() -{ // Flagged: ‘getRadius’ doesn't modify the object's state. +{ // Flagged: 'getRadius' doesn't modify the object's state. return radius; } ``` @@ -45,7 +45,7 @@ class MyClass public: int getValue() const { return value; } // Added const - void setValue(int newValue) { value = newValue; } // OK: ‘setValue’ modifies the object's state. + void setValue(int newValue) { value = newValue; } // OK: 'setValue' modifies the object's state. private: @@ -54,7 +54,7 @@ private: }; double getRadius() const // added const -{ // ‘getRadius’ doesn't modify the object's state. +{ // 'getRadius' doesn't modify the object's state. return radius; } ``` @@ -75,4 +75,4 @@ The current implementation of this check allows you to add `const` to member fun ## See also -[IntelliSense code linter for C++ overview](cpp-linter-overview.md) \ No newline at end of file +[IntelliSense code linter for C++ overview](cpp-linter-overview.md) diff --git a/docs/ide/lnt-uninitialized-local.md b/docs/ide/lnt-uninitialized-local.md index 4a4f223534b..1be51a46df0 100644 --- a/docs/ide/lnt-uninitialized-local.md +++ b/docs/ide/lnt-uninitialized-local.md @@ -10,7 +10,7 @@ monikerRange: ">=msvc-160" Local variables should be initialized when they're declared. -This guidance comes from the [C++ Core Guideline ES.20](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#es20-always-initialize-an-object). +This guidance comes from [ES.20: Always initialize an object](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#es20-always-initialize-an-object) in the C++ Core Guidelines. The `lnt-uninitialized-local` check is controlled by the **Uninitialized Local Variable** setting in the C/C++ Code Style options. For information on how to change this setting, see [Configure the linter](cpp-linter-overview.md#configure-the-linter). @@ -55,5 +55,5 @@ Using "Almost Always Auto" for declarations requires initialization at declarati ## See also [IntelliSense code linter for C++ overview](cpp-linter-overview.md)\ -[C++ Core Guidelines](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#es20-always-initialize-an-object)\ +[ES.20: Always initialize an object](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#es20-always-initialize-an-object)\ [Almost Always Auto - Herb Sutter](https://herbsutter.com/2013/08/12/gotw-94-solution-aaa-style-almost-always-auto/) diff --git a/docs/ide/navigate-code-cpp.md b/docs/ide/navigate-code-cpp.md index 142af682bd9..4838fd20573 100644 --- a/docs/ide/navigate-code-cpp.md +++ b/docs/ide/navigate-code-cpp.md @@ -11,7 +11,7 @@ Visual Studio provides a suite of tools that you can use to navigate around your Right-click an `#include` directive, and select **Go To Document**. Or, select **F12** with the cursor over that line to open the file. -![Screenshot of the C plus plus Go To Document menu option in the context of some include statements.](../ide/media/go-to-document.png) +![Screenshot of the C plus plus Go To Document menu option in the context of some include statements.](media/go-to-document.png) ## Toggle Header/Code File @@ -21,7 +21,7 @@ You can switch between a header file and its corresponding source file. Right-cl You can navigate to the definition of a code element with a right-click in the editor and selecting **Go To Definition**, or by selecting **F12**. You can navigate to a declaration similarly by right-clicking to open the context menu, or by selecting **Ctrl+F12**. -![Screenshot of options that appear when you right-click a code element. Includes Go To Definition, Peek Definition, and Go To Declaration.](../ide/media/go-to-def.png) +![Screenshot of options that appear when you right-click a code element. Includes Go To Definition, Peek Definition, and Go To Declaration.](media/go-to-def.png) ## Go To @@ -29,7 +29,7 @@ You can navigate to the definition of a code element with a right-click in the e You can open **Go To** with **Ctrl+,**. This action creates a search box over the document you're editing. -![Screenshot of the search box that appears when you open Go To. There's a text box for your search terms, and filters for types, recent files, etc.](../ide/media/go-to-cpp.png) +![Screenshot of the search box that appears when you open Go To. There's a text box for your search terms, and filters for types, recent files, etc.](media/go-to-cpp.png) **Go To** includes these search filters: @@ -62,11 +62,11 @@ To apply a text filter, start your search query with the filter's corresponding The following example shows results from a *Go To Files* operation by using the "f" filter: -![Screenshot of Go to Files results. The user typed 'f str' and string_utils.cpp and string_utils.h appear because they contain `str` in the name.](../ide/media/vs2017-go-to-results.png "Go To Menu") +![Screenshot of Go to Files results. The user typed 'f str' and string_utils.cpp and string_utils.h appear because they contain `str` in the name.](media/vs2017-go-to-results.png "Go To Menu") To see the list of text filters, type a ? followed by a space. You also can access the **Go To** commands with the **Edit** menu. This is another way to remind yourself of the main **Go To** keyboard shortcuts. -![Screenshot of the Go To menu which has options like Go To Line (Ctrl + G), Go to File (Ctrl + 1, Ctrl + F), and more.](../ide/media/go-to-menu-cpp.png "Go To Menu") +![Screenshot of the Go To menu which has options like Go To Line (Ctrl + G), Go to File (Ctrl + 1, Ctrl + F), and more.](media/go-to-menu-cpp.png "Go To Menu") ## Find or Find in Files @@ -74,15 +74,15 @@ You can run a text search for anything in your solution with **Find** (**Ctrl+F* **Find** can be scoped to a selection, the current document, all open documents, the current project, or the entire solution. You can use regular expressions and plain text. It also highlights all matches automatically in the IDE. -![Screenshot of the Find dialog. The user has searched `channel`. Yellow highlights in the file show all the places `Channel` is found.](../ide/media/find-cpp.png) +![Screenshot of the Find dialog. The user has searched `channel`. Yellow highlights in the file show all the places `Channel` is found.](media/find-cpp.png) **Find in Files** is a more powerful version of **Find** that displays results in the **Find Results** window. You can search external code dependencies, filter by file types, and more. -![Screenshot of the Find and Replace dialog. The Find in Files page is selected. Options are shown for matching case, the whole word, and so on.](../ide/media/find-in-files-cpp.png "Find in Files") +![Screenshot of the Find and Replace dialog. The Find in Files page is selected. Options are shown for matching case, the whole word, and so on.](media/find-in-files-cpp.png "Find in Files") You can organize **Find in Files** results in two windows. You can append results from multiple searches together. Select a result to go to that location in the file. -![Screenshot showing a Find in Files search result listing files containing text that matches the search string and an excerpt of each match.](../ide/media/vs2017-find-in-files-results.png "Find in Files") +![Screenshot showing a Find in Files search result listing files containing text that matches the search string and an excerpt of each match.](media/vs2017-find-in-files-results.png "Find in Files") For more information, see [Find in Files](/visualstudio/ide/find-in-files) in the Visual Studio documentation. @@ -90,7 +90,7 @@ For more information, see [Find in Files](/visualstudio/ide/find-in-files) in th To find all usages of a symbol in your codebase, place the caret in or just after the symbol, right-click, and then select **Find All References**. You can filter, sort, or group results in many different ways. Results populate incrementally. They're classified as Reads or Writes to help you see what's in your solution as opposed to system headers or other libraries. -![Screenshot of Find all references results which shows the line where the symbol was found, which file and project it is located in, and so on.](../ide/media/find-all-references-results-cpp.png) +![Screenshot of Find all references results which shows the line where the symbol was found, which file and project it is located in, and so on.](media/find-all-references-results-cpp.png) You can group results by the following categories: @@ -104,7 +104,7 @@ You can group results by the following categories: To filter results, hover over a column and select the filtering icon that pops up. You can filter results from the first column to hide things like string and comment references that you might not want to see. -![Screenshot of filtering options. Includes Confirmed, Disconfirmed, In comment, and unprocessed. Each shows how many results apply to that category.](../ide/media/find-all-references-filters-cpp.png) +![Screenshot of filtering options. Includes Confirmed, Disconfirmed, In comment, and unprocessed. Each shows how many results apply to that category.](media/find-all-references-filters-cpp.png) - **Confirmed results**: Actual code references to the symbol being searched for. For example, searching for a member function called `Size` returns all references to `Size` that match the scope of the class that defines `Size`. @@ -120,10 +120,10 @@ You can sort results by any column by selecting that column. You can swap betwee You can navigate to the definition of a type in a file, or to type members, by using the **Navigation Bar** that's above the editor window. -![Screenshot of the Navigation Bar above the editor window. It shows cryptlib > ChannelSwitch > ChannelMessageSeriesEnd().](../ide/media/navbar-cpp.png) +![Screenshot of the Navigation Bar above the editor window. It shows cryptlib > ChannelSwitch > ChannelMessageSeriesEnd().](media/navbar-cpp.png) ## See also -- [Read and understand C++ code](read-and-understand-code-cpp.md)\ -- [Edit and refactor C++ code](read-and-understand-code-cpp.md)\ +- [Read and understand C++ code](read-and-understand-code-cpp.md) +- [Edit and refactor C++ code](read-and-understand-code-cpp.md) - [Collaborate with Live Share for C++](live-share-cpp.md) diff --git a/docs/ide/overriding-a-virtual-function-visual-cpp.md b/docs/ide/overriding-a-virtual-function-visual-cpp.md index 3f552708ee2..e681a20f791 100644 --- a/docs/ide/overriding-a-virtual-function-visual-cpp.md +++ b/docs/ide/overriding-a-virtual-function-visual-cpp.md @@ -5,6 +5,7 @@ ms.date: "11/12/2018" f1_keywords: ["vc.codewiz.virtualfunc.override"] helpviewer_keywords: ["virtual functions, overriding", "base classes, overriding virtual functions defined in", "Properties window, overriding virtual functions in"] ms.assetid: 2d8c76f2-7a6b-4c9c-8de5-4282ce7755b6 +ms.topic: how-to --- # Override a virtual function diff --git a/docs/ide/read-and-understand-code-cpp.md b/docs/ide/read-and-understand-code-cpp.md index cdf11a2cd64..ff4d5bdb93a 100644 --- a/docs/ide/read-and-understand-code-cpp.md +++ b/docs/ide/read-and-understand-code-cpp.md @@ -1,7 +1,8 @@ --- title: "Read and understand C++ code in Visual Studio" description: "Use the C++ code editor in Visual Studio to format, and understand your code." -ms.date: "05/28/2019" +ms.date: 05/28/2019 +ms.topic: concept-article --- # Read and understand C++ code in Visual Studio @@ -97,7 +98,7 @@ Place the cursor on or just after any type, keyword or function and press **F1** Right click on a code file in your project and choose **Generate graph of include files** to see a graph of which files are included by other files. -![Screenshot of a graph of include files. The graph shows that NAMSPACE DLL .CPP includes Namespace DLL .h, which includes V_10 .H, among other files.](../ide/media/vs2015_cpp_include_graph.png) +![Screenshot of a graph of include files. The graph shows that NAMESPACE DLL .CPP includes Namespace DLL .h, which includes V_10 .H, among other files.](../ide/media/vs2015_cpp_include_graph.png) ## View Call Hierarchy @@ -105,7 +106,7 @@ Right click on any function call and view a recursive list of all the functions ![Screenshot of the Call Hierarchy window which shows calls to and from Floating_to_wstring(). For example, to_wstring() calls Floating_to_wstring().](../ide/media/vs2015_cpp_call_hierarchy.png) -## See Also +## See also [Edit and refactor code (C++)](writing-and-refactoring-code-cpp.md)
[Navigate your C++ code base in Visual Studio](navigate-code-cpp.md)
diff --git a/docs/ide/refactoring/change-signature.md b/docs/ide/refactoring/change-signature.md index df104d59767..e8b15f90056 100644 --- a/docs/ide/refactoring/change-signature.md +++ b/docs/ide/refactoring/change-signature.md @@ -2,6 +2,7 @@ description: "Learn more about: Change Signature" title: "Change Signature" ms.date: "09/18/2022" +f1_keywords: ["vc.pkg.refactoring.changesignaturedlg"] --- # Change Signature diff --git a/docs/ide/refactoring/extract-function.md b/docs/ide/refactoring/extract-function.md index 634dc9f291b..91a9fc7d797 100644 --- a/docs/ide/refactoring/extract-function.md +++ b/docs/ide/refactoring/extract-function.md @@ -2,6 +2,7 @@ description: "Learn more about: Extract Function" title: "Extract Function" ms.date: "09/18/2022" +f1_keywords: ["vc.pkg.refactoring.extractfuncdlg"] --- # Extract Function diff --git a/docs/ide/refactoring/rename.md b/docs/ide/refactoring/rename.md index 512ae624ea8..69bf660156c 100644 --- a/docs/ide/refactoring/rename.md +++ b/docs/ide/refactoring/rename.md @@ -2,6 +2,7 @@ description: "Learn more about: Rename" title: "Rename" ms.date: "09/19/2022" +f1_keywords: ["vc.pkg.refactoring.renamedlg"] --- # Rename diff --git a/docs/ide/toc.yml b/docs/ide/toc.yml index c208f599e60..0b58b7607e9 100644 --- a/docs/ide/toc.yml +++ b/docs/ide/toc.yml @@ -93,7 +93,7 @@ items: - name: Add a method href: ../ide/adding-a-method-visual-cpp.md - name: Add an IDL method - href: ../ide/add-interface-definition-library-method-wizard.md + href: ../ide/add-interface-definition-library-method-wizard.md - name: Add a property href: ../ide/adding-a-property-visual-cpp.md - name: Add an IDL property diff --git a/docs/ide/using-the-visual-studio-ide-for-cpp-desktop-development.md b/docs/ide/using-the-visual-studio-ide-for-cpp-desktop-development.md index 330552cf38a..5f115d743cc 100644 --- a/docs/ide/using-the-visual-studio-ide-for-cpp-desktop-development.md +++ b/docs/ide/using-the-visual-studio-ide-for-cpp-desktop-development.md @@ -4,6 +4,7 @@ title: "Using the Visual Studio IDE for C++ Desktop Development" ms.date: "04/25/2019" helpviewer_keywords: ["IDE [C++]", "Visual Studio IDE [C++]"] ms.assetid: d985c230-8e81-49d6-92be-2db9cac8d023 +ms.topic: concept-article --- # Using the Visual Studio IDE for C++ Desktop Development @@ -15,7 +16,7 @@ If you haven't installed Visual Studio yet, now is the time. For download links These walkthroughs assume that you've installed Visual Studio and the C++ components required for Windows Desktop development. We also assume you understand the fundamentals of the C++ language. If you need to learn C++, there are many books and web resources available. One good place to start is the [Get Started](https://isocpp.org/get-started) page of the Standard C++ Foundation website. -In general, we highly recommend that you use the latest version of Visual Studio even if you need to compile your code using an earlier version of the compiler toolset. For more information, see [Use native multi-targeting in Visual Studio to build old projects](../porting/use-native-multi-targeting.md). +In general, we highly recommend that you use the latest version of Visual Studio even if you need to compile your code using an earlier version of the Microsoft C++ (MSVC) Build Tools. For more information, see [Use native multi-targeting in Visual Studio to build old projects](../porting/use-native-multi-targeting.md). Once your Visual Studio installation is complete, you are ready to continue. @@ -35,7 +36,7 @@ To get started using the Visual Studio IDE to build C++ apps, work through each ## Next steps -Once you've completed these walkthroughs, you're ready to start building your own projects. For more information and resources for C++ development, see [Visual C++ in Visual Studio](../overview/visual-cpp-in-visual-studio.md). +Once you've completed these walkthroughs, you're ready to start building your own projects. For more information and resources for C++ development, see [Microsoft C++ in Visual Studio](../overview/visual-cpp-in-visual-studio.md). ## See also diff --git a/docs/ide/visualize-macro-expansion.md b/docs/ide/visualize-macro-expansion.md index 0a8071e0a94..fffabf0ef07 100644 --- a/docs/ide/visualize-macro-expansion.md +++ b/docs/ide/visualize-macro-expansion.md @@ -52,7 +52,7 @@ You can inspect a macro's expanded value, even when several preprocessor steps a :::image-end::: 1. Choose **Copy**. -1. Create a comment following the `POWER` line and choose paste (CTRL+V). The expansion of the macro, as a comment near your macro, looks like: `// (((10.0 * 20.0)* (5.0 * 2.0)) / 2.0).` The keyboard shortcut for this action is CTRL+M, CTRL+C. +1. Create a comment following the `POWER` line and choose paste (CTRL+V). The expansion of the macro, as a comment near your macro, looks like: `// (((10.0 * 20.0)* (5.0 * 2.0)) / 2.0)`. The keyboard shortcut for this action is CTRL+M, CTRL+C. ## Expand a macro inline diff --git a/docs/ide/writing-and-refactoring-code-cpp.md b/docs/ide/writing-and-refactoring-code-cpp.md index 7c3edfb3dae..cfb3dbfdead 100644 --- a/docs/ide/writing-and-refactoring-code-cpp.md +++ b/docs/ide/writing-and-refactoring-code-cpp.md @@ -1,7 +1,7 @@ --- title: "Edit and refactor C++ code in Visual Studio" description: "Use the C++ code editor in Visual Studio to format, navigate, understand and refactor your code." -ms.date: "09/20/2022" +ms.date: 09/20/2022 ms.topic: "overview" ms.custom: intro-overview --- @@ -22,7 +22,7 @@ search for "IntelliSense" in **Quick Launch** (Ctrl + Q) and choose the **Text E The **Member List Filter Mode** option controls what kinds of IntelliSense autocomplete suggestions you see. By default, it's set to **Fuzzy**. In a fuzzy search, if you have a symbol called *MyAwesomeClass*, you can type "MAC" and find the class in your autocomplete suggestions. The fuzzy algorithm sets a minimum threshold that symbols must meet to show up in the list. **Smart** filtering displays all symbols containing substrings that match what you typed. **Prefix** filtering searches for strings that begin with what you typed. -For more information about C++ IntelliSense, see [Visual C++ IntelliSense](/visualstudio/ide/visual-cpp-intellisense) and [Configure a C++ project for IntelliSense](/visualstudio/ide/visual-cpp-intellisense-configuration). +For more information about C++ IntelliSense, see [Visual Studio C++ IntelliSense](/visualstudio/ide/visual-cpp-intellisense) and [Configure a C++ project for IntelliSense](/visualstudio/ide/visual-cpp-intellisense-configuration). ## IntelliCode @@ -178,7 +178,7 @@ Options for enabling and configuring C++-specific editing features are located u Experimental features, which may or may not be included in a future version of Visual Studio, are found in the [Text Editor C++ Experimental](/visualstudio/ide/reference/options-text-editor-c-cpp-experimental) dialog. In Visual Studio 2017 and later you can enable **Predictive IntelliSense** in this dialog. -## See Also +## See also [Read and understand C++ code](read-and-understand-code-cpp.md)
[Navigate your C++ code base in Visual Studio](navigate-code-cpp.md)
diff --git a/docs/index.yml b/docs/index.yml index ef1c16e4cf9..a2bdc2a4d8b 100644 --- a/docs/index.yml +++ b/docs/index.yml @@ -1,7 +1,7 @@ ### YamlMime:Hub title: Microsoft C++, C, and Assembler documentation summary: Learn how to use C++, C, and assembly language to develop applications, services, and tools for your platforms and devices. -# brand: aspnet | azure | dotnet | dynamics | m365 | ms-graph | office | power-platform | sql | sql-server | vs | visual-studio | windows | xamarin +# brand: aspnet | azure | dotnet | dynamics | m365 | ms-graph | office | power-platform | sql | sql-server | vs | visual-studio | windows brand: visual-studio metadata: title: Microsoft C/C++ Documentation @@ -10,7 +10,7 @@ metadata: ms.topic: hub-page author: tylermsft ms.author: twhitney - ms.date: 06/04/2020 + ms.date: 11/06/2025 ms.custom: intro-landing-hub # highlightedContent section (optional) @@ -172,7 +172,7 @@ additionalContent: - text: Mobile development url: cross-platform/index.yml - text: Game development - url: /windows/uwp/gaming/e2e/ + url: /visualstudio/gamedev/ # Card - title: Features links: @@ -205,6 +205,8 @@ additionalContent: url: parallel/parallel-programming-in-visual-cpp.md - text: Cloud and networking libraries url: cloud/cloud-and-web-programming-in-visual-cpp.md + - text: Azure SDK for C++ + url: /azure/developer/cpp/sdk/overview/ - text: Universal Windows Platform libraries url: cppcx/namespaces-reference-c-cx.md - text: vcpkg package manager diff --git a/docs/intrinsics/arm-intrinsics.md b/docs/intrinsics/arm-intrinsics.md index 58a6eb6738b..bde0f7c5627 100644 --- a/docs/intrinsics/arm-intrinsics.md +++ b/docs/intrinsics/arm-intrinsics.md @@ -4,11 +4,10 @@ description: "Reference list of ARM intrinsics supported by the Microsoft C++ co ms.date: "09/02/2019" f1_keywords: ["arm_neon/vsetq_lane_p8", "armintr/_arm_uxtb", "arm_neon/vld4_lane_p8", "arm_neon/vrshrn_n_s64", "arm_neon/vsli_n_u32", "arm_neon/vsraq_n_u16", "arm_neon/vcgt_f32", "armintr/__iso_volatile_store32", "arm_neon/vceqq_f32", "armintr/_arm_smlal", "arm_neon/vmull_n_s32", "arm_neon/vmax_s8", "arm_neon/vmvn_u32", "arm_neon/vrshl_u32", "arm_neon/int32x2_t", "arm_neon/vdupq_n_p8", "arm_neon/vpmax_u16", "arm_neon/vtrnq_s32", "arm_neon/vset_lane_f32", "arm_neon/vrev64_s8", "arm_neon/vtrnq_p8", "arm_neon/vqshlq_u64", "arm_neon/vld1q_dup_s64", "arm_neon/vmovq_n_u64", "arm_neon/vqshrn_n_u16", "arm_neon/vhadd_s32", "arm_neon/vrhaddq_u32", "arm_neon/vst1q_p8", "arm_neon/vshrn_n_s16", "arm_neon/vget_high_f32", "arm_neon/vuzpq_s16", "arm_neon/vand_u16", "arm_neon/vmulq_s32", "arm_neon/vrsraq_n_s64", "arm_neon/vceqq_s8", "arm_neon/uint64x1x3_t", "arm_neon/veor_u32", "armintr/_arm_pkhtb", "arm_neon/vorrq_u16", "arm_neon/vpaddl_s8", "arm_neon/vmla_n_s16", "arm_neon/vqdmlal_lane_s32", "arm_neon/vshlq_n_u8", "arm_neon/vst2_lane_p8", "arm_neon/vld3q_u16", "arm_neon/vandq_u8", "arm_neon/vst1_u64", "arm_neon/vaddq_s64", "arm_neon/vuzpq_u32", "arm_neon/vld3_lane_p8", "arm_neon/vminq_s32", "arm_neon/vabd_u16", "arm_neon/vdup_n_u32", "arm_neon/vmul_p8", "arm_neon/vsra_n_u16", "arm_neon/vst3q_u16", "arm_neon/int32x2x3_t", "arm_neon/vld2_dup_u16", "arm_neon/vrhaddq_u8", "arm_neon/vhadd_u8", "arm_neon/vgetq_lane_s32", "arm_neon/vcleq_u16", "arm_neon/vabdq_s8", "arm_neon/vrev16q_u8", "arm_neon/vqshlu_n_s64", "arm_neon/vcvt_n_s32_f32", "arm_neon/vqrshrn_n_s64", "arm_neon/vst1q_p16", "arm_neon/vgetq_lane_s16", "arm_neon/vtstq_u32", "arm_neon/vmlsl_n_s16", "arm_neon/vcge_s8", "arm_neon/vshr_n_s16", "armintr/_arm_rbit", "arm_neon/vmls_u32", "arm_neon/vmls_lane_u32", "arm_neon/vcvtq_n_s32_f32", "arm_neon/vqshl_n_s8", "arm_neon/vst1q_s16", "armintr/__emit", "arm_neon/vshlq_s64", "arm_neon/vuzp_s8", "arm_neon/vld1q_lane_s64", "arm_neon/veorq_s32", "arm_neon/vaddq_u64", "arm_neon/vceq_s32", "arm_neon/vmovn_u16", "arm_neon/vabal_s8", "arm_neon/vabsq_f32", "armintr/_arm_smuad", "arm_neon/veor_u8", "arm_neon/int16x4_t", "arm_neon/vsraq_n_s16", "arm_neon/vshlq_s8", "arm_neon/vcreate_u32", "arm_neon/vzipq_s8", "arm_neon/vst3q_u8", "arm_neon/int64x1x4_t", "armintr/__iso_volatile_store16", "arm_neon/vst4_lane_p16", "arm_neon/vld1_dup_p16", "arm_neon/vhadd_s16", "arm_neon/vtbl2_s8", "arm_neon/veorq_u32", "arm_neon/vqdmlal_lane_s16", "arm_neon/vrsra_n_u8", "arm_neon/vbslq_u16", "arm_neon/vget_low_s64", "arm_neon/vceq_u16", "arm_neon/vdupq_lane_u32", "arm_neon/vabdl_u32", "arm_neon/vmlal_s32", "arm_neon/vst1_lane_u8", "arm_neon/vld4q_f16", "arm_neon/vqdmlsl_s32", "arm_neon/vqrdmulh_s32", "arm_neon/vqrshl_u8", "arm_neon/uint32x4x4_t", "arm_neon/vabaq_u16", "arm_neon/vcnt_p8", "arm_neon/vld3q_s16", "arm_neon/vshl_n_u32", "arm_neon/vrev64q_u16", "arm_neon/vextq_s64", "arm_neon/vhsubq_s8", "arm_neon/vld2_dup_u8", "arm_neon/vst3_s16", "arm_neon/vorn_u16", "arm_neon/vst4_f16", "arm_neon/vpadalq_u8", "armintr/__iso_volatile_load8", "arm_neon/vmovl_u16", "arm_neon/vld4q_u32", "arm_neon/vcgt_u32", "arm_neon/vmlaq_n_u32", "arm_neon/vrsra_n_u64", "arm_neon/vst4_s8", "arm_neon/vcvtq_n_f32_u32", "arm_neon/vst2q_u16", "arm_neon/vqshrn_n_s16", "arm_neon/vld4_s16", "arm_neon/uint16x8x4_t", "arm_neon/vrsqrte_u32", "arm_neon/vcltq_s8", "arm_neon/vst3_u16", "arm_neon/vst2_f32", "arm_neon/vld2_u64", "arm_neon/vst1_u16", "arm_neon/vmls_s16", "arm_neon/vqrshlq_s32", "arm_neon/vqdmull_s16", "arm_neon/vld2_lane_p16", "arm_neon/vpaddlq_u8", "arm_neon/vcvt_n_f32_u32", "arm_neon/vcgtq_u8", "arm_neon/vshl_s32", "arm_neon/vtbx3_p8", "arm_neon/vld3_dup_s32", "arm_neon/int16x4x3_t", "arm_neon/vcale_f32", "arm_neon/vqabsq_s32", "arm_neon/vmulq_u16", "arm_neon/vst1_s8", "arm_neon/vclt_u8", "armintr/_arm_sxtb16", "arm_neon/vshr_n_s8", "arm_neon/vst1_lane_f16", "arm_neon/vorn_s64", "armintr/_arm_usub8", "arm_neon/vst4_lane_f32", "arm_neon/vmls_lane_u16", "arm_neon/vpaddl_u32", "arm_neon/vdup_lane_u64", "arm_neon/vsri_n_p16", "arm_neon/vqrshlq_u64", "arm_neon/vclz_s16", "arm_neon/vsra_n_u32", "arm_neon/vabaq_s8", "arm_neon/vst2_lane_s8", "arm_neon/vcvt_n_u32_f32", "arm_neon/vst3_u32", "arm_neon/vcvtq_f32_u32", "arm_neon/vraddhn_s64", "armintr/_arm_uqsax", "arm_neon/vshl_u8", "armintr/_arm_uqadd16", "arm_neon/vrsra_n_u16", "arm_neon/vrshl_u64", "arm_neon/int32x4x3_t", "arm_neon/vmull_u8", "arm_neon/vcombine_u64", "arm_neon/vmull_u16", "arm_neon/vld1_dup_s8", "armintr/_CountLeadingSigns64", "arm_neon/vqshlq_n_s32", "arm_neon/vrecpe_f32", "arm_neon/vsri_n_u32", "arm_neon/vrsraq_n_s8", "arm_neon/vsetq_lane_s16", "arm_neon/vget_high_u32", "arm_neon/vmlal_u32", "arm_neon/vdupq_lane_s16", "arm_neon/vsubq_u64", "arm_neon/vext_p8", "arm_neon/vshl_u16", "arm_neon/vmls_n_u16", "arm_neon/vmull_s16", "arm_neon/vmovq_n_s64", "arm_neon/vaddq_f32", "arm_neon/vshl_n_s16", "arm_neon/vext_p16", "arm_neon/vextq_u32", "arm_neon/vld1_p8", "arm_neon/veor_s32", "arm_neon/int16x8x4_t", "arm_neon/vst1q_u16", "arm_neon/vzipq_p8", "arm_neon/int32x4x4_t", "arm_neon/vqdmulhq_lane_s32", "arm_neon/vst3_lane_u32", "arm_neon/vhsubq_s32", "armintr/__static_assert", "arm_neon/vst3q_lane_u16", "arm_neon/vpmin_u32", "arm_neon/vrev64q_p16", "arm_neon/vcleq_f32", "arm_neon/vhsub_u16", "arm_neon/vld2_lane_s32", "arm_neon/vmlsl_s32", "armintr/_arm_rev", "arm_neon/vcgeq_s16", "arm_neon/vmulq_s8", "arm_neon/vsri_n_s8", "arm_neon/vpadd_f32", "arm_neon/vld1q_lane_f16", "arm_neon/vmls_u16", "arm_neon/vld1_lane_f32", "arm_neon/vmlaq_lane_s16", "arm_neon/vqadd_u32", "arm_neon/vmul_n_s32", "arm_neon/vld1q_dup_p8", "arm_neon/vtrnq_s8", "arm_neon/vbslq_p8", "arm_neon/vget_lane_s8", "arm_neon/vext_u16", "arm_neon/vsubq_s16", "arm_neon/vld4_lane_s8", "arm_neon/uint32x2x2_t", "arm_neon/vdup_n_s8", "arm_neon/vld4_lane_u16", "arm_neon/vmovq_n_s16", "arm_neon/vst4q_s32", "arm_neon/vst2q_f16", "arm_neon/vbslq_s16", "arm_neon/vand_u64", "arm_neon/poly16_t", "arm_neon/vaba_u16", "arm_neon/vqshlq_s64", "armintr/_arm_uxth", "arm_neon/vst2_lane_s16", "arm_neon/vand_u8", "arm_neon/int8x16x3_t", "arm_neon/vrev64_u16", "arm_neon/vld2_lane_s16", "arm_neon/vabaq_s16", "arm_neon/vsli_n_u8", "arm_neon/vsraq_n_u64", "arm_neon/vmlsl_s16", "arm_neon/vmovn_u64", "arm_neon/vld4_f32", "arm_neon/vst2q_f32", "arm_neon/vtbx3_u8", "arm_neon/vcombine_s8", "arm_neon/vqdmulhq_s32", "arm_neon/vgetq_lane_p8", "armintr/_arm_smusd", "arm_neon/vpmax_u32", "arm_neon/vceq_f32", "arm_neon/vsri_n_p8", "arm_neon/vhsubq_u8", "arm_neon/vuzp_s16", "arm_neon/uint32x2x4_t", "arm_neon/vst4_lane_s32", "arm_neon/vsli_n_p8", "arm_neon/vld3_lane_f16", "arm_neon/vbic_u64", "arm_neon/vmlal_u16", "arm_neon/vmvn_s8", "arm_neon/vtstq_s8", "arm_neon/vmaxq_s32", "arm_neon/vqmovn_u64", "armintr/_arm_ssax", "arm_neon/vext_u32", "arm_neon/vld1_dup_u64", "arm_neon/vmlal_n_s16", "armintr/_arm_smulbb", "arm_neon/vqrdmulhq_lane_s16", "arm_neon/vdup_n_p8", "arm_neon/vaba_s8", "arm_neon/vrshrq_n_s32", "arm_neon/vmvnq_s32", "arm_neon/vpadal_s32", "arm_neon/vqshl_s16", "arm_neon/vtrn_p8", "arm_neon/vzip_s16", "arm_neon/vcge_f32", "armintr/_arm_sxtab16", "arm_neon/vst1q_lane_u64", "arm_neon/vqrshlq_u16", "arm_neon/int8x8_t", "arm_neon/vorr_u8", "arm_neon/vrev64_f32", "arm_neon/vpaddlq_s16", "arm_neon/vdupq_lane_u64", "arm_neon/vcltq_u16", "arm_neon/vst3_lane_f32", "arm_neon/vld2_dup_f32", "armintr/_arm_smmul", "arm_neon/vbsl_s16", "arm_neon/vld1_lane_u8", "arm_neon/vld2q_lane_u16", "arm_neon/vqshlu_n_s32", "armintr/_arm_smlalbt", "arm_neon/vmla_s8", "arm_neon/vsli_n_p16", "arm_neon/vmla_u8", "arm_neon/vqaddq_s16", "arm_neon/vld3_p16", "arm_neon/uint64x2x4_t", "arm_neon/vcnt_u8", "arm_neon/vcltq_u8", "arm_neon/vtbx1_p8", "arm_neon/vrev32q_u16", "arm_neon/vld1_lane_u16", "arm_neon/vqadd_s16", "arm_neon/vcnt_s8", "armintr/_MulUnsignedHigh", "arm_neon/vsliq_n_u8", "arm_neon/vpmin_s16", "armintr/__iso_volatile_load16", "arm_neon/vst2_lane_f32", "arm_neon/vqsubq_s32", "arm_neon/vqshl_s32", "arm_neon/vsraq_n_u32", "arm_neon/vcreate_s32", "arm_neon/vld3q_lane_u32", "arm_neon/vaddq_u16", "arm_neon/vand_s32", "arm_neon/vbicq_s32", "armintr/_arm_smulbt", "arm_neon/vrsra_n_s8", "arm_neon/vshrq_n_u32", "arm_neon/vld4_f16", "arm_neon/vcagtq_f32", "arm_neon/vaddw_u32", "armintr/_arm_uxtah", "arm_neon/vtstq_u8", "arm_neon/vld1_dup_u16", "arm_neon/int16x4x4_t", "arm_neon/vqshluq_n_s8", "arm_neon/vqdmulhq_n_s32", "arm_neon/vst1_s64", "arm_neon/vrsubhn_u16", "arm_neon/vld4_dup_p16", "arm_neon/vmlaq_s32", "arm_neon/vnegq_s32", "arm_neon/vst2q_u8", "arm_neon/vget_low_s32", "arm_neon/vorn_u32", "arm_neon/vld1q_s8", "arm_neon/vandq_s64", "arm_neon/vmvn_p8", "arm_neon/vabdl_s16", "arm_neon/vqshl_u32", "arm_neon/vld3_dup_u16", "arm_neon/vmov_n_f32", "arm_neon/vcvt_f32_u32", "arm_neon/vrhadd_s8", "arm_neon/vpadal_u32", "armintr/_arm_ubfx", "arm_neon/vcgt_s8", "arm_neon/vget_lane_f32", "arm_neon/vcge_s16", "arm_neon/vmov_n_s64", "arm_neon/vmulq_n_f32", "arm_neon/vpadalq_u32", "armintr/_arm_smlaldx", "arm_neon/vtst_u16", "arm_neon/vmls_n_s16", "arm_neon/vcombine_f32", "arm_neon/vld1q_p16", "armintr/_arm_ssat", "arm_neon/vextq_s8", "arm_neon/vmax_u32", "arm_neon/vqsubq_s64", "arm_neon/vcltq_s16", "arm_neon/vst2q_s8", "arm_neon/vpmax_u8", "arm_neon/vld4_dup_p8", "arm_neon/vrshr_n_u64", "arm_neon/vqrshrun_n_s16", "arm_neon/vget_low_u64", "arm_neon/vst2q_s32", "arm_neon/vst4_s32", "arm_neon/vrshrq_n_u8", "arm_neon/vdupq_n_u64", "arm_neon/vsriq_n_u8", "arm_neon/vdupq_lane_u8", "arm_neon/vsriq_n_s64", "arm_neon/vget_low_u8", "arm_neon/vst1_lane_p16", "arm_neon/vld1q_lane_u8", "arm_neon/vcgt_s32", "arm_neon/vst1_lane_u32", "arm_neon/vzipq_p16", "arm_neon/vmvn_u16", "arm_neon/vld1q_lane_u16", "armintr/_MoveToCoprocessor64", "arm_neon/vdup_n_u16", "arm_neon/vzipq_f32", "arm_neon/vshl_s16", "arm_neon/vmlaq_n_s16", "arm_neon/vget_lane_s64", "arm_neon/vld1q_lane_f32", "arm_neon/vnegq_s16", "armintr/_arm_usax", "arm_neon/vabd_s16", "arm_neon/vmovq_n_u32", "arm_neon/vshlq_n_u16", "armintr/_CountLeadingSigns", "arm_neon/vld3q_f16", "arm_neon/vceqq_u32", "arm_neon/int8x8x2_t", "arm_neon/vst2_s64", "arm_neon/vst4q_lane_s16", "arm_neon/vorn_s32", "arm_neon/vcle_f32", "arm_neon/vld1_p16", "arm_neon/vtrn_u32", "arm_neon/vbsl_s32", "arm_neon/float32x2_t", "arm_neon/vmvn_s32", "arm_neon/vqdmlsl_lane_s16", "arm_neon/vtbl3_s8", "arm_neon/vsra_n_u8", "arm_neon/vcvtq_u32_f32", "arm_neon/vst1_p8", "arm_neon/vrev64_p16", "armintr/__ldrexd", "arm_neon/vcgeq_u8", "arm_neon/vmlal_n_s32", "arm_neon/vst1q_lane_p8", "arm_neon/vpadalq_s32", "arm_neon/vtstq_p8", "arm_neon/vld4_lane_u8", "armintr/_arm_ssub16", "arm_neon/vpaddlq_u16", "armintr/_arm_udiv", "arm_neon/vld1_lane_p8", "arm_neon/vst1q_u32", "arm_neon/vld1_f32", "arm_neon/uint64x2x2_t", "arm_neon/vqsubq_u64", "arm_neon/vld4q_s32", "arm_neon/vceq_s16", "arm_neon/vst3_s64", "arm_neon/vext_s8", "armintr/_arm_smlsd", "arm_neon/vpadal_s16", "arm_neon/vbic_s32", "arm_neon/vld1_dup_u8", "arm_neon/vclt_f32", "arm_neon/vrev64_s16", "arm_neon/vrshlq_s64", "arm_neon/vdupq_n_s64", "arm_neon/vuzp_p16", "arm_neon/vld3_dup_p16", "arm_neon/vcreate_s8", "armintr/_arm_smlatt", "arm_neon/vtst_s32", "arm_neon/vshrq_n_s64", "arm_neon/vqshlq_n_s64", "arm_neon/vqshlu_n_s16", "arm_neon/vcleq_s16", "arm_neon/vmull_lane_s16", "arm_neon/int32x4_t", "arm_neon/vqadd_s8", "arm_neon/vld2q_f16", "arm_neon/vld2q_lane_p16", "arm_neon/vadd_u32", "arm_neon/vcntq_u8", "arm_neon/vst1_f32", "arm_neon/vmaxq_u32", "arm_neon/vsub_u64", "arm_neon/vsubl_s32", "arm_neon/poly16x4_t", "arm_neon/vgetq_lane_u16", "arm_neon/vdup_lane_s32", "arm_neon/vrhadd_s32", "arm_neon/veorq_u8", "arm_neon/vclzq_s8", "arm_neon/vsliq_n_s64", "arm_neon/vpadalq_s16", "arm_neon/vmla_n_f32", "arm_neon/vcgt_u16", "armintr/_arm_usada8", "arm_neon/vabd_u32", "arm_neon/vgetq_lane_s8", "arm_neon/vqshlq_n_u64", "arm_neon/vabaq_u32", "armintr/_arm_uhsax", "arm_neon/vmulq_f32", "arm_neon/vld3_dup_s16", "arm_neon/vst3_f16", "arm_neon/vrshrq_n_s64", "armintr/__rdpmccntr64", "arm_neon/vclsq_s32", "arm_neon/vmax_u16", "arm_neon/vmvnq_p8", "arm_neon/veor_u16", "arm_neon/vqshrn_n_u32", "arm_neon/vextq_u64", "arm_neon/vld1q_f32", "arm_neon/vget_low_u32", "arm_neon/vhaddq_s32", "arm_neon/vminq_u16", "arm_neon/vqrdmulhq_lane_s32", "arm_neon/vmla_s16", "arm_neon/vadd_s16", "arm_neon/vbsl_u16", "arm_neon/vhsub_s8", "arm_neon/vld4q_lane_p16", "arm_neon/vld1_s16", "arm_neon/vst2q_lane_p16", "arm_neon/vld2_dup_s8", "arm_neon/vst3q_s16", "arm_neon/vcgeq_u32", "arm_neon/vabdq_s16", "arm_neon/vrhadd_u16", "arm_neon/vqshlq_n_u32", "arm_neon/vst4q_lane_u32", "arm_neon/vrsraq_n_u64", "arm_neon/vmlsq_n_s32", "arm_neon/vld4_u8", "arm_neon/vld2_f16", "arm_neon/vqshlq_u8", "arm_neon/vorrq_u64", "arm_neon/vmin_u16", "arm_neon/vext_u8", "arm_neon/vpaddl_s32", "arm_neon/vshlq_u64", "arm_neon/vst2q_lane_f16", "armintr/_arm_sbfx", "arm_neon/vld3_dup_f16", "armintr/_arm_uhasx", "arm_neon/vst2_lane_u8", "armintr/_arm_smultb", "arm_neon/vdup_n_p16", "arm_neon/vtrnq_u32", "arm_neon/vrshlq_u8", "arm_neon/vld4_lane_p16", "arm_neon/vsraq_n_s32", "arm_neon/vclt_s16", "arm_neon/vzip_u8", "arm_neon/vld3_lane_s16", "arm_neon/vceqq_s32", "arm_neon/vld3_dup_f32", "arm_neon/vld4q_lane_s32", "arm_neon/poly8x16x4_t", "arm_neon/uint64x1x2_t", "arm_neon/vqdmlal_n_s16", "arm_neon/vld2_dup_f16", "arm_neon/vshrq_n_s32", "arm_neon/vcleq_s8", "arm_neon/vld3_s32", "arm_neon/vqrshlq_s64", "arm_neon/vbsl_f32", "arm_neon/vext_s64", "arm_neon/vabaq_s32", "arm_neon/vmulq_s16", "arm_neon/vld3_lane_u16", "arm_neon/vld3q_lane_u16", "armintr/_arm_smlaltt", "arm_neon/poly8x8x2_t", "arm_neon/vst3q_u32", "armintr/_arm_smlsdx", "arm_neon/vqrshl_s64", "arm_neon/vextq_p8", "armintr/_arm_uhsub16", "arm_neon/vld3q_p8", "armintr/_arm_smlawt", "armintr/_arm_smlawb", "arm_neon/vdupq_lane_s8", "arm_neon/vaddl_s16", "arm_neon/vcombine_p16", "arm_neon/vzipq_u32", "arm_neon/poly16x8_t", "arm_neon/vshlq_n_s32", "arm_neon/vrshl_s8", "arm_neon/vst2_u64", "arm_neon/vrev64q_s8", "arm_neon/vst2q_lane_s32", "arm_neon/vld2_dup_s16", "arm_neon/vclt_u16", "arm_neon/vuzp_p8", "arm_neon/vshrq_n_s16", "arm_neon/vst3_u64", "arm_neon/vpmin_u16", "arm_neon/vld3q_lane_s32", "arm_neon/vmlal_s16", "arm_neon/poly16x4x4_t", "arm_neon/vorr_u16", "arm_neon/vsliq_n_s16", "arm_neon/vaddl_u8", "arm_neon/vld4_dup_s32", "arm_neon/vld2_f32", "arm_neon/vclt_u32", "arm_neon/vmull_lane_u16", "arm_neon/vsubw_u32", "arm_neon/vld2_dup_s32", "arm_neon/vuzp_s32", "arm_neon/vcge_s32", "arm_neon/vdup_lane_p16", "arm_neon/vpmin_s8", "arm_neon/vpaddlq_u32", "arm_neon/vmlaq_n_s32", "arm_neon/vshrn_n_u64", "arm_neon/vrshr_n_u16", "arm_neon/vld1_s64", "arm_neon/vbsl_u64", "armintr/_arm_smlad", "arm_neon/vqsub_s16", "arm_neon/vld4_p8", "arm_neon/vqdmulh_lane_s32", "arm_neon/vld3_dup_s64", "arm_neon/vornq_s32", "arm_neon/vpadd_u8", "arm_neon/vld3_lane_p16", "arm_neon/uint64x1x4_t", "arm_neon/vld3_u16", "armintr/_arm_shsax", "arm_neon/vabdq_u16", "arm_neon/vcgtq_f32", "arm_neon/vsubq_s8", "arm_neon/vget_low_f16", "arm_neon/vld4_dup_u64", "arm_neon/vst3_lane_s8", "armintr/_arm_ssat16", "arm_neon/vmlaq_f32", "arm_neon/vsri_n_s32", "arm_neon/vmax_u8", "arm_neon/vqadd_u8", "armintr/_arm_uqsub8", "armintr/_arm_clz", "arm_neon/vcgtq_s32", "arm_neon/vraddhn_s32", "arm_neon/vzip_s8", "arm_neon/veorq_s16", "arm_neon/vsetq_lane_s32", "arm_neon/vmul_n_u16", "armintr/_ReadBankedReg", "arm_neon/vld1q_u8", "arm_neon/vld4_p16", "arm_neon/int64x2x2_t", "arm_neon/vmaxq_s8", "arm_neon/vpmax_s16", "arm_neon/vshlq_u16", "arm_neon/vtrnq_p16", "arm_neon/vabal_u16", "arm_neon/vld2_lane_u16", "arm_neon/vrev32_u8", "arm_neon/vrshl_s32", "arm_neon/vget_low_f32", "arm_neon/vld2_s8", "arm_neon/vclzq_s16", "arm_neon/vqdmulhq_n_s16", "arm_neon/vset_lane_u64", "arm_neon/vld2_dup_p16", "arm_neon/vpaddlq_s32", "arm_neon/vld2q_p8", "arm_neon/vst3_lane_u8", "arm_neon/vld4_dup_f32", "arm_neon/vld2_s64", "arm_neon/vmls_u8", "arm_neon/vtbx4_u8", "arm_neon/vsetq_lane_f32", "arm_neon/vcvt_s32_f32", "arm_neon/vst3q_s32", "arm_neon/vmlsq_s8", "arm_neon/vmlaq_n_u16", "armintr/__iso_volatile_load64", "arm_neon/vcgt_u8", "arm_neon/vld2_dup_p8", "arm_neon/vmov_n_u8", "armintr/_arm_sasx", "arm_neon/vmovq_n_p16", "arm_neon/vmlaq_u32", "arm_neon/vst3_f32", "arm_neon/int32x2x4_t", "arm_neon/vld1q_lane_u64", "arm_neon/vclz_u16", "arm_neon/uint8x8_t", "arm_neon/vsub_u32", "arm_neon/vorn_u8", "armintr/__wfe", "arm_neon/vget_high_s16", "arm_neon/vzip_p8", "arm_neon/vmlal_lane_s16", "arm_neon/vmulq_u8", "armintr/_isunordered", "arm_neon/vld1_dup_f32", "arm_neon/vld4_lane_s16", "arm_neon/vdupq_n_s16", "arm_neon/vst3q_p16", "arm_neon/vst1_lane_f32", "arm_neon/float32x4x3_t", "arm_neon/vand_s8", "arm_neon/float32x2x4_t", "arm_neon/vld3_p8", "arm_neon/vmlaq_lane_u16", "armintr/_arm_uqsub16", "arm_neon/vget_high_s32", "arm_neon/vshl_n_s32", "arm_neon/vornq_s8", "arm_neon/vmlsl_n_u32", "arm_neon/vqshlq_n_s8", "arm_neon/int32x2x2_t", "arm_neon/int16x4x2_t", "arm_neon/vceqq_u8", "arm_neon/vcreate_f16", "arm_neon/vorn_s16", "arm_neon/vqmovn_s32", "arm_neon/vextq_u8", "arm_neon/vld4_s32", "armintr/_WriteStatusReg", "arm_neon/uint8x16_t", "arm_neon/vshrn_n_s64", "arm_neon/vmul_n_u32", "arm_neon/vabdl_u8", "arm_neon/vtbx3_s8", "arm_neon/vaddhn_s16", "arm_neon/vld3q_s8", "arm_neon/vmlsl_n_u16", "arm_neon/vrev64q_s32", "arm_neon/int16x8_t", "arm_neon/vext_s32", "arm_neon/vdupq_n_f32", "arm_neon/vld1q_lane_s32", "arm_neon/vqrshlq_u32", "arm_neon/vtbl2_u8", "arm_neon/vgetq_lane_u8", "arm_neon/veorq_u64", "arm_neon/vcntq_s8", "arm_neon/vbslq_p16", "arm_neon/vqnegq_s32", "arm_neon/vaddw_s32", "arm_neon/vmov_n_p8", "arm_neon/vmull_p8", "arm_neon/vld1_lane_u32", "arm_neon/vcombine_s16", "arm_neon/vqshrn_n_s64", "arm_neon/vceqq_s16", "arm_neon/vld4q_p16", "armintr/_ReadStatusReg", "armintr/_arm_qdadd", "arm_neon/uint32x4x2_t", "arm_neon/vcleq_u8", "armintr/_arm_sxtah", "arm_neon/vrhaddq_s32", "arm_neon/vset_lane_s64", "arm_neon/vld4_s64", "armintr/_DAddSatInt", "arm_neon/vorr_s8", "arm_neon/vst2_u32", "arm_neon/vshll_n_u16", "arm_neon/vld2_dup_u32", "arm_neon/vst3q_lane_s32", "arm_neon/vst3q_p8", "armintr/_MoveFromCoprocessor", "arm_neon/uint32x4_t", "arm_neon/vuzpq_s8", "arm_neon/vrecps_f32", "arm_neon/vst1_lane_s8", "arm_neon/vtbx1_s8", "arm_neon/uint16x8x3_t", "arm_neon/vpaddl_s16", "arm_neon/vsubq_s64", "arm_neon/vrsraq_n_u8", "arm_neon/vqadd_s64", "arm_neon/vst4_lane_s16", "arm_neon/vqadd_u16", "arm_neon/vset_lane_u32", "arm_neon/vand_u32", "arm_neon/vrsqrtsq_f32", "arm_neon/vqaddq_u32", "arm_neon/vsra_n_s64", "armintr/_arm_umlal", "arm_neon/vcvt_f32_f16", "arm_neon/vget_lane_u32", "arm_neon/vbsl_s8", "arm_neon/vrshlq_u32", "arm_neon/vqdmull_lane_s16", "arm_neon/vabsq_s32", "arm_neon/vld3_s8", "arm_neon/vst3q_lane_s16", "arm_neon/vld2q_lane_s16", "arm_neon/vst1_lane_s64", "arm_neon/vmov_n_u16", "arm_neon/vst4_lane_u8", "arm_neon/vshll_n_u32", "arm_neon/vqabs_s8", "arm_neon/vmvnq_u8", "arm_neon/vpadalq_u16", "arm_neon/vbsl_p16", "arm_neon/vqrshrn_n_u16", "arm_neon/vld3q_u32", "arm_neon/vcgeq_f32", "armintr/__iso_volatile_load32", "arm_neon/vrecpe_u32", "arm_neon/vld2_dup_u64", "arm_neon/vld3q_f32", "armintr/_arm_shsub8", "arm_neon/vdup_lane_s64", "arm_neon/vqrshl_s8", "arm_neon/vsliq_n_u16", "arm_neon/vld1q_u16", "arm_neon/vorr_u32", "arm_neon/vqrshl_s32", "armintr/__dmb", "arm_neon/veorq_s8", "arm_neon/vld1_u16", "arm_neon/vmov_n_u32", "arm_neon/vhsub_s16", "arm_neon/vst4q_lane_u16", "arm_neon/vbsl_u8", "armintr/_arm_uxtab", "arm_neon/vld2q_lane_f32", "arm_neon/vst2_p8", "armintr/_arm_smmla", "arm_neon/vaddw_u16", "arm_neon/vmlal_s8", "arm_neon/vtst_u32", "arm_neon/vtbl4_u8", "arm_neon/vcvt_n_f32_s32", "arm_neon/vcageq_f32", "arm_neon/vget_low_s16", "arm_neon/vdupq_n_u8", "arm_neon/vorn_s8", "arm_neon/uint8x16x3_t", "arm_neon/vabdq_u32", "arm_neon/vrev64_p8", "arm_neon/vqsubq_s8", "armintr/_arm_smlabb", "arm_neon/vbicq_s64", "arm_neon/vmaxq_u16", "arm_neon/vdup_n_u8", "arm_neon/veor_s8", "arm_neon/int16x8x2_t", "arm_neon/vcvtq_s32_f32", "arm_neon/vtrn_u16", "arm_neon/vbslq_s32", "arm_neon/vld1q_dup_u32", "arm_neon/vmul_n_f32", "arm_neon/vqrshl_u32", "arm_neon/vqsubq_s16", "arm_neon/vst2_lane_f16", "armintr/_arm_smulwt", "arm_neon/vrshrn_n_u32", "arm_neon/vget_high_p16", "arm_neon/vqadd_u64", "arm_neon/vsli_n_s32", "arm_neon/vhadd_u32", "arm_neon/vmlsl_lane_u16", "arm_neon/vclzq_u32", "arm_neon/vqshrun_n_s64", "arm_neon/vrev64q_u32", "arm_neon/vqshrun_n_s16", "arm_neon/vrev32q_s8", "armintr/_arm_shasx", "arm_neon/vaddl_s8", "armintr/_arm_smull", "arm_neon/vabaq_u8", "armintr/_arm_revsh", "arm_neon/vsubq_f32", "arm_neon/poly16x4x2_t", "arm_neon/poly8x8x3_t", "arm_neon/vsubhn_s64", "arm_neon/vcle_u16", "arm_neon/poly8x16x3_t", "arm_neon/vqdmlsl_n_s16", "arm_neon/vqshl_u64", "arm_neon/vcge_u16", "armintr/_arm_uasx", "arm_neon/vmovl_s32", "arm_neon/vst1q_lane_u16", "arm_neon/vbic_u32", "arm_neon/vld2_s16", "armintr/_arm_qasx", "arm_neon/vorrq_u8", "arm_neon/vst2_s32", "armintr/_WriteBankedReg", "arm_neon/veorq_s64", "arm_neon/vld4_lane_f32", "arm_neon/vcreate_u8", "arm_neon/vset_lane_u8", "arm_neon/vandq_u16", "arm_neon/vrsubhn_s64", "arm_neon/vst1q_lane_p16", "arm_neon/uint8x8x2_t", "arm_neon/vmlsl_s8", "arm_neon/vmax_s32", "arm_neon/uint32x4x3_t", "arm_neon/vld4_dup_u16", "arm_neon/vabs_s32", "arm_neon/vld3_dup_u32", "arm_neon/vrshl_u16", "arm_neon/vcle_u8", "arm_neon/vqshl_n_u16", "arm_neon/vbic_s8", "arm_neon/float32x4x2_t", "arm_neon/vmls_f32", "arm_neon/vshll_n_u8", "arm_neon/vminq_s8", "arm_neon/vmlsq_lane_f32", "arm_neon/vst1q_f16", "arm_neon/vst1_lane_u64", "arm_neon/vrhadd_u8", "arm_neon/vclt_s32", "arm_neon/vst2_p16", "arm_neon/vrshrq_n_u16", "arm_neon/vneg_s32", "arm_neon/vmovl_s16", "arm_neon/vqshlq_s8", "arm_neon/vld1_s8", "arm_neon/vqdmulh_s32", "arm_neon/vcls_s8", "armintr/__trap", "arm_neon/vuzp_u32", "armintr/_CopyInt64FromDouble", "arm_neon/int8x16x2_t", "arm_neon/vmovn_s32", "arm_neon/vget_high_s8", "arm_neon/veor_s64", "armintr/_arm_uadd8", "arm_neon/vrev16_u8", "arm_neon/vbicq_u64", "arm_neon/vst4_lane_f16", "arm_neon/vst3_s32", "arm_neon/poly8x8_t", "arm_neon/vtstq_u16", "arm_neon/vld1_lane_s8", "arm_neon/float32x4x4_t", "arm_neon/vst2_s16", "arm_neon/vqrdmulhq_s32", "arm_neon/vqdmulhq_s16", "arm_neon/vrshrq_n_s8", "arm_neon/vcle_s32", "arm_neon/vtbl3_p8", "arm_neon/vbslq_u8", "arm_neon/vst4_u64", "armintr/_arm_umaal", "arm_neon/vshll_n_s8", "arm_neon/vcvt_u32_f32", "arm_neon/vld4q_p8", "arm_neon/vsetq_lane_u16", "arm_neon/vabd_u8", "arm_neon/vclz_u8", "arm_neon/vsubq_u32", "arm_neon/vld1q_lane_p16", "arm_neon/vcgtq_s16", "arm_neon/vmla_lane_s32", "arm_neon/vshlq_n_s64", "arm_neon/vbsl_u32", "arm_neon/vqshlq_s16", "armintr/_arm_qadd8", "arm_neon/vrshr_n_s32", "armintr/_CountOneBits64", "arm_neon/vceq_u32", "arm_neon/vbsl_p8", "arm_neon/uint16x8x2_t", "arm_neon/vsli_n_s16", "arm_neon/vmla_n_s32", "arm_neon/vld4_dup_u32", "arm_neon/vshrq_n_s8", "arm_neon/vqaddq_s8", "arm_neon/vshl_n_u64", "arm_neon/vtbl2_p8", "arm_neon/vcleq_u32", "arm_neon/vqsub_u32", "arm_neon/vmovl_u8", "arm_neon/vmlal_u8", "arm_neon/vmul_s8", "armintr/_MoveFromCoprocessor64", "arm_neon/vrsraq_n_s16", "arm_neon/vdupq_n_u32", "arm_neon/vmov_n_s16", "arm_neon/vst4_lane_p8", "arm_neon/vld1_s32", "arm_neon/vst4_p8", "arm_neon/vsriq_n_u32", "arm_neon/vqdmull_n_s16", "arm_neon/vshlq_u32", "arm_neon/vld3_u8", "armintr/_arm_usub16", "arm_neon/vmlsq_lane_s16", "arm_neon/vmovq_n_s8", "arm_neon/int32x4x2_t", "arm_neon/vld4q_u8", "arm_neon/poly16x8x2_t", "arm_neon/vld1q_u64", "arm_neon/vld3q_lane_s16", "arm_neon/int64x1x2_t", "arm_neon/vshlq_n_s8", "arm_neon/vrshl_s64", "arm_neon/vqshl_n_u8", "armintr/_arm_qadd", "armintr/_DSubSatInt", "armintr/_arm_usat16", "arm_neon/vmull_s8", "arm_neon/vsub_s8", "arm_neon/vmovq_n_u16", "arm_neon/vst4_u16", "arm_neon/vmlsl_lane_u32", "arm_neon/vsliq_n_p16", "arm_neon/vmovn_u32", "arm_neon/vbic_u16", "arm_neon/vtbx2_p8", "arm_neon/vrsubhn_s32", "armintr/_SubSatInt", "arm_neon/vst3_u8", "arm_neon/vdupq_n_s32", "arm_neon/vcntq_p8", "arm_neon/vst4_f32", "arm_neon/vbic_s64", "arm_neon/vld3_s64", "arm_neon/vrsra_n_s64", "arm_neon/vqabsq_s16", "arm_neon/vsriq_n_p8", "arm_neon/vst2_lane_p16", "arm_neon/vabsq_s16", "arm_neon/vcombine_u8", "arm_neon/vld2q_p16", "armintr/_CountOneBits", "armintr/__prefetch", "arm_neon/vld3_dup_u64", "arm_neon/vld2q_s16", "arm_neon/vget_low_p16", "arm_neon/vuzpq_u8", "arm_neon/vrev32q_s16", "armintr/_AddSatInt", "arm_neon/uint16x4x2_t", "arm_neon/vmov_n_s32", "arm_neon/vaddl_u16", "arm_neon/vqaddq_s64", "arm_neon/vmlaq_u16", "arm_neon/vsli_n_s8", "armintr/_arm_sxth", "arm_neon/vorr_s32", "arm_neon/vsra_n_u64", "arm_neon/vst2_f16", "arm_neon/vcombine_u16", "arm_neon/vabs_s16", "arm_neon/vsubhn_s32", "arm_neon/vst1q_lane_u32", "arm_neon/vst3_p8", "arm_neon/vqshrun_n_s32", "arm_neon/vcreate_s64", "arm_neon/vld4q_lane_s16", "arm_neon/vzipq_u16", "arm_neon/vmin_s32", "armintr/_CopyInt32FromFloat", "arm_neon/vcgtq_u32", "arm_neon/vabdl_s32", "arm_neon/vqshlq_n_u16", "arm_neon/int8x16x4_t", "arm_neon/vqrdmulh_n_s32", "arm_neon/vqaddq_u64", "arm_neon/vhaddq_s8", "arm_neon/vshll_n_s16", "arm_neon/vuzp_u8", "arm_neon/vaddl_u32", "arm_neon/vld4q_s16", "arm_neon/vqmovun_s16", "arm_neon/vld1q_lane_s8", "arm_neon/vld2_lane_u32", "arm_neon/vrshr_n_s8", "arm_neon/vmlaq_s16", "armintr/_CopyFloatFromInt32", "arm_neon/vmul_f32", "arm_neon/vmlaq_n_f32", "arm_neon/vst4_s16", "arm_neon/vld1_dup_s32", "arm_neon/vmul_u16", "arm_neon/vhaddq_s16", "arm_neon/vst1q_lane_f32", "arm_neon/vrhaddq_u16", "arm_neon/vbicq_u32", "arm_neon/vrev32_s8", "arm_neon/vmlaq_s8", "arm_neon/vmin_s16", "arm_neon/vst3_lane_p16", "arm_neon/vst2q_lane_f32", "arm_neon/vld4q_lane_f32", "arm_neon/vget_low_u16", "arm_neon/vqsub_s32", "arm_neon/vtbl1_s8", "arm_neon/vmovn_s64", "arm_neon/vpmax_s8", "arm_neon/int8x16_t", "arm_neon/vpmin_u8", "arm_neon/vdup_lane_p8", "arm_neon/vsetq_lane_u64", "arm_neon/vuzpq_u16", "arm_neon/vcgeq_u16", "arm_neon/uint8x16x2_t", "armintr/_arm_rev16", "armintr/_arm_sxtb", "arm_neon/vsliq_n_u64", "arm_neon/vmovq_n_u8", "arm_neon/vshlq_n_u32", "arm_neon/vcombine_s64", "armintr/_arm_qsax", "arm_neon/vmin_f32", "armintr/_arm_sadd16", "arm_neon/vmlsq_n_s16", "arm_neon/vorr_u64", "arm_neon/vqrshrun_n_s64", "arm_neon/vld2q_lane_s32", "arm_neon/vgetq_lane_p16", "arm_neon/vrev32_s16", "arm_neon/vqshl_u16", "arm_neon/vtrn_s8", "arm_neon/vst1q_lane_s64", "arm_neon/vtbl4_p8", "arm_neon/vst1_p16", "arm_neon/vmvn_u8", "arm_neon/vld2_lane_u8", "arm_neon/vld2q_u16", "arm_neon/vmovl_s8", "arm_neon/vbslq_u64", "arm_neon/vmls_s8", "arm_neon/vld3q_p16", "arm_neon/vtbl3_u8", "arm_neon/vabs_f32", "arm_neon/vsraq_n_s8", "arm_neon/vqadd_s32", "arm_neon/vmulq_n_s16", "arm_neon/vst3q_s8", "arm_neon/vaddhn_s64", "arm_neon/vmul_n_s16", "arm_neon/vtbl1_p8", "arm_neon/uint64x2x3_t", "arm_neon/vmlsq_s32", "arm_neon/vld2q_lane_u32", "arm_neon/vaddq_u8", "arm_neon/vcombine_f16", "arm_neon/vandq_s16", "arm_neon/vst4q_lane_p16", "arm_neon/vsri_n_u8", "arm_neon/vst3_lane_p8", "arm_neon/vst3_lane_s16", "arm_neon/vdup_n_s16", "arm_neon/vbicq_s8", "arm_neon/vdup_lane_u8", "arm_neon/vst4q_lane_s32", "arm_neon/vqrshl_u16", "arm_neon/vrsra_n_u32", "arm_neon/vdupq_lane_p8", "arm_neon/vld3_lane_u8", "arm_neon/vqrdmulh_n_s16", "arm_neon/vpmin_s32", "armintr/__cps", "arm_neon/vshl_u32", "armintr/_arm_uadd16", "arm_neon/vld3_s16", "arm_neon/vcvt_f32_s32", "arm_neon/vshlq_n_u64", "arm_neon/vrev64q_u8", "arm_neon/vextq_u16", "arm_neon/vsubl_s16", "arm_neon/vget_lane_p8", "arm_neon/vabal_s16", "arm_neon/vrecpeq_u32", "arm_neon/vminq_u8", "arm_neon/veor_s16", "arm_neon/vmull_n_u16", "arm_neon/vshl_n_u8", "arm_neon/vrev32q_u8", "arm_neon/vandq_s8", "arm_neon/vrshlq_s16", "arm_neon/vst4q_p16", "arm_neon/vandq_s32", "armintr/_MoveToCoprocessor2", "arm_neon/vqdmlsl_lane_s32", "arm_neon/vld1q_s64", "arm_neon/vmull_n_s16", "arm_neon/vneg_s16", "arm_neon/vqshluq_n_s64", "arm_neon/vst2_lane_s32", "arm_neon/vmvnq_u16", "arm_neon/vshll_n_s32", "arm_neon/vld3_dup_s8", "arm_neon/vtstq_s32", "arm_neon/vmlsl_u32", "arm_neon/vqdmulhq_lane_s16", "arm_neon/vaddl_s32", "armintr/_CountLeadingZeros", "arm_neon/vqrshrn_n_s16", "arm_neon/vmla_lane_u32", "arm_neon/vst1_u8", "arm_neon/vshl_u64", "arm_neon/vshr_n_u8", "arm_neon/vmull_lane_s32", "arm_neon/vmlal_lane_u32", "arm_neon/vsubl_s8", "arm_neon/float32x2x2_t", "armintr/_arm_bfc", "arm_neon/vaddq_s16", "arm_neon/vmlal_lane_s32", "arm_neon/vpadd_u16", "arm_neon/vst2q_lane_u16", "arm_neon/vld4_s8", "arm_neon/vst1q_s8", "arm_neon/vshrq_n_u64", "arm_neon/vsli_n_u16", "arm_neon/vqrdmulh_lane_s32", "arm_neon/vst4_lane_u16", "arm_neon/vabdq_f32", "arm_neon/vld2_lane_f16", "arm_neon/vqsub_u64", "arm_neon/vsub_f32", "arm_neon/vld1q_s16", "arm_neon/vmaxq_s16", "arm_neon/vcombine_u32", "arm_neon/vrsraq_n_u32", "armintr/_arm_smusdx", "arm_neon/vrev16_s8", "arm_neon/vqdmulh_n_s32", "arm_neon/vmul_s32", "arm_neon/vabdq_s32", "arm_neon/veor_u64", "arm_neon/vmlsl_n_s32", "arm_neon/vsub_s16", "arm_neon/vadd_u16", "arm_neon/vsriq_n_u16", "arm_neon/vmla_u32", "arm_neon/vuzpq_s32", "arm_neon/vst4q_s8", "arm_neon/vaddhn_u32", "arm_neon/vmlaq_lane_f32", "arm_neon/vld3_lane_s8", "arm_neon/vsliq_n_u32", "arm_neon/vqrshlq_s8", "arm_neon/vqdmlal_n_s32", "arm_neon/uint8x16x4_t", "arm_neon/vcgtq_u16", "arm_neon/vandq_u32", "arm_neon/vld4q_lane_u32", "arm_neon/vzip_p16", "arm_neon/vget_low_p8", "armintr/_arm_shadd8", "arm_neon/vmovn_s16", "arm_neon/vcge_u8", "arm_neon/vld2q_f32", "arm_neon/vaba_u32", "armintr/__iso_volatile_store8", "arm_neon/vst2q_p16", "arm_neon/vmul_s16", "arm_neon/vand_s16", "arm_neon/vtbx4_p8", "arm_neon/vceq_u8", "arm_neon/vrhaddq_s16", "arm_neon/vgetq_lane_f32", "arm_neon/vqshl_s8", "arm_neon/vbslq_f32", "arm_neon/vrsqrts_f32", "arm_neon/vld2q_s8", "arm_neon/vtbl1_u8", "arm_neon/vtst_u8", "arm_neon/vrev64q_f32", "arm_neon/vcle_s8", "arm_neon/vsetq_lane_p16", "arm_neon/vcreate_p16", "arm_neon/vabal_s32", "armintr/_arm_smlald", "arm_neon/vmla_f32", "arm_neon/vtbx2_s8", "arm_neon/int64x1x3_t", "arm_neon/vclz_s8", "arm_neon/vorr_s16", "arm_neon/vornq_s64", "arm_neon/vst1q_u64", "arm_neon/vdupq_n_s8", "armintr/_arm_sadd8", "arm_neon/vextq_s32", "armintr/_arm_smuadx", "armintr/_arm_qsub", "arm_neon/vadd_f32", "arm_neon/vrshrq_n_s16", "arm_neon/vqsub_s8", "arm_neon/vld3_f32", "arm_neon/vhadd_s8", "arm_neon/vmull_n_u32", "arm_neon/vdup_n_u64", "arm_neon/vsubw_s32", "armintr/_arm_sxtab", "armintr/_arm_uxtb16", "arm_neon/vmvn_s16", "arm_neon/vst1_lane_s16", "arm_neon/vqrdmulhq_n_s32", "arm_neon/vsriq_n_s32", "arm_neon/poly8x16x2_t", "arm_neon/vadd_u8", "arm_neon/vuzpq_p8", "arm_neon/vst2q_p8", "armintr/__wfi", "arm_neon/vget_high_u16", "arm_neon/vqrshl_u64", "arm_neon/vld1_dup_s64", "arm_neon/vqrshrn_n_s32", "arm_neon/vrshr_n_s64", "arm_neon/vst3_s8", "arm_neon/poly16x4x3_t", "arm_neon/vqrdmulh_lane_s16", "arm_neon/vmvnq_u32", "arm_neon/vqsubq_u32", "arm_neon/vmovq_n_p8", "arm_neon/vtrn_s16", "arm_neon/vld2q_u32", "arm_neon/vqsubq_u16", "arm_neon/vrsqrteq_u32", "arm_neon/vadd_u64", "armintr/_arm_usat", "arm_neon/vcvtq_n_u32_f32", "arm_neon/vaddq_s8", "arm_neon/vrsraq_n_u16", "arm_neon/vqabs_s16", "arm_neon/vsra_n_s8", "arm_neon/vsra_n_s16", "arm_neon/vqshlq_n_u8", "arm_neon/vpadal_s8", "arm_neon/vmlal_n_u16", "armintr/_CopyDoubleFromInt64", "arm_neon/vaddw_u8", "arm_neon/vmulq_n_s32", "arm_neon/vqaddq_s32", "arm_neon/vmla_lane_f32", "arm_neon/vmlaq_lane_s32", "arm_neon/vld1q_dup_u64", "arm_neon/uint16x8_t", "arm_neon/vld2_s32", "arm_neon/vcltq_f32", "arm_neon/vst4q_f32", "arm_neon/vsri_n_u16", "arm_neon/vshlq_s32", "arm_neon/vgetq_lane_u32", "arm_neon/vld1q_dup_f16", "arm_neon/vrev64q_s16", "arm_neon/vrshrq_n_u32", "arm_neon/vld2q_s32", "arm_neon/vcgtq_s8", "arm_neon/vsubhn_u64", "arm_neon/vmls_n_s32", "armintr/_arm_smmlar", "arm_neon/vld3_dup_u8", "arm_neon/vld3q_lane_p16", "arm_neon/vld2_dup_s64", "arm_neon/vqabs_s32", "arm_neon/vqaddq_u8", "arm_neon/vminq_u32", "arm_neon/vpaddl_u16", "arm_neon/vaba_s16", "arm_neon/vmul_u32", "arm_neon/vst1_lane_u16", "arm_neon/vcreate_f32", "arm_neon/vcvt_f16_f32", "arm_neon/vset_lane_s32", "arm_neon/vshl_s8", "arm_neon/vcgt_s16", "arm_neon/vtrn_f32", "arm_neon/vget_high_s64", "arm_neon/vld3_dup_p8", "arm_neon/vcreate_u64", "arm_neon/vext_u64", "arm_neon/vld1q_dup_s16", "arm_neon/vget_lane_s16", "arm_neon/vqdmlal_s16", "arm_neon/vld2_p16", "arm_neon/vld4_u16", "armintr/_arm_smlalbb", "arm_neon/vrev64_u8", "arm_neon/vbslq_s64", "arm_neon/vsubw_u16", "arm_neon/vrsubhn_u32", "arm_neon/vabdq_u8", "arm_neon/vmls_n_u32", "arm_neon/vshr_n_s32", "arm_neon/vmulq_n_u32", "arm_neon/vst3_p16", "arm_neon/vrev32_u16", "arm_neon/int8x8x3_t", "arm_neon/vst2q_lane_u32", "arm_neon/vextq_p16", "arm_neon/vtrnq_f32", "armintr/_arm_smultt", "arm_neon/vqneg_s8", "arm_neon/vmlsq_lane_s32", "arm_neon/vmov_n_p16", "arm_neon/vraddhn_u64", "arm_neon/vrhadd_u32", "arm_neon/vrev64_u32", "arm_neon/vrshrn_n_s32", "arm_neon/vld4q_f32", "arm_neon/vst2_s8", "arm_neon/vrsqrteq_f32", "arm_neon/uint16x4_t", "arm_neon/vget_low_s8", "arm_neon/vst2_lane_u32", "arm_neon/vhsub_s32", "arm_neon/vqdmull_lane_s32", "armintr/_arm_smulwb", "arm_neon/vmlsl_u8", "arm_neon/vdup_lane_s16", "arm_neon/vtbx4_s8", "arm_neon/vld4q_lane_u16", "arm_neon/vget_high_u8", "arm_neon/vclzq_s32", "arm_neon/vld1q_dup_f32", "arm_neon/vtrn_u8", "arm_neon/vqabsq_s8", "arm_neon/vdup_lane_f32", "arm_neon/vqrdmulh_s16", "arm_neon/vst4_u32", "arm_neon/vdup_lane_u32", "arm_neon/vst4_u8", "arm_neon/vmovq_n_s32", "arm_neon/vld2_lane_s8", "arm_neon/vld3_u32", "arm_neon/vsubl_u16", "arm_neon/vqshlu_n_s8", "arm_neon/float32x4_t", "arm_neon/vqshl_n_s32", "arm_neon/float32x2x3_t", "armintr/__hvc", "arm_neon/vst1q_lane_f16", "arm_neon/vmvnq_s16", "arm_neon/vst3q_lane_f32", "arm_neon/vld1q_dup_u8", "arm_neon/vmlsq_s16", "arm_neon/vget_lane_u8", "arm_neon/vld1_lane_s32", "arm_neon/vst4q_s16", "armintr/_arm_qsub8", "arm_neon/vorrq_s32", "arm_neon/vsriq_n_s8", "arm_neon/vqshrn_n_u64", "arm_neon/vdup_n_s32", "armintr/_arm_uhsub8", "arm_neon/vld3_lane_s32", "arm_neon/vbsl_s64", "arm_neon/vld1_dup_f16", "arm_neon/vsli_n_u64", "arm_neon/vraddhn_u32", "arm_neon/vsub_u16", "arm_neon/vcltq_u32", "arm_neon/vminq_f32", "arm_neon/vshl_n_s64", "arm_neon/vld4_u32", "arm_neon/vld1_u32", "arm_neon/vaddhn_u16", "arm_neon/vcvtq_n_f32_s32", "arm_neon/vorn_u64", "arm_neon/vsubhn_u16", "arm_neon/int64x1_t", "arm_neon/vst1q_lane_s8", "arm_neon/vld1q_dup_s32", "arm_neon/vrev32_p8", "arm_neon/vst3q_lane_p16", "arm_neon/vrecpeq_f32", "arm_neon/int8x8x4_t", "arm_neon/vshr_n_u32", "arm_neon/vdupq_lane_s64", "arm_neon/vpaddlq_s8", "arm_neon/vqshl_n_u32", "arm_neon/vmul_u8", "arm_neon/vtbx2_u8", "arm_neon/vshr_n_u64", "arm_neon/vqrshlq_s16", "arm_neon/vst3_lane_u16", "arm_neon/vqsub_u8", "arm_neon/vrsra_n_s16", "arm_neon/vaba_s32", "arm_neon/vsri_n_u64", "arm_neon/vst3q_lane_u32", "arm_neon/vmlsq_n_u32", "arm_neon/poly8x16_t", "arm_neon/vld2_u8", "armintr/_arm_smmulr", "arm_neon/vtst_s16", "armintr/_arm_smmls", "arm_neon/vqdmulh_s16", "arm_neon/vtrnq_u8", "arm_neon/vset_lane_p8", "arm_neon/vmlsl_u16", "arm_neon/vshrn_n_u16", "arm_neon/vld1_dup_p8", "arm_neon/vrev16q_s8", "arm_neon/vmov_n_s8", "arm_neon/vld1_u64", "arm_neon/vpmin_f32", "arm_neon/vmla_n_u16", "arm_neon/vst1_f16", "arm_neon/vqdmlsl_s16", "arm_neon/vmin_u32", "armintr/_arm_qsub16", "arm_neon/vcage_f32", "arm_neon/vornq_u32", "arm_neon/vpadd_s16", "arm_neon/vld1_u8", "arm_neon/vhsubq_s16", "arm_neon/vld1_dup_u32", "arm_neon/vld4_u64", "armintr/_MulHigh", "arm_neon/vmaxq_u8", "arm_neon/vget_lane_u16", "arm_neon/vld2q_u8", "arm_neon/vld1q_dup_p16", "arm_neon/vsraq_n_u8", "arm_neon/vqdmlsl_n_s32", "arm_neon/vst1_s16", "arm_neon/vst1q_s32", "arm_neon/vmaxq_f32", "arm_neon/vqdmulh_lane_s16", "armintr/__isb", "arm_neon/vuzpq_p16", "arm_neon/vmls_lane_s16", "arm_neon/vtbl4_s8", "arm_neon/vst1_lane_p8", "arm_neon/vsubw_s8", "arm_neon/vmin_u8", "arm_neon/vzip_u16", "arm_neon/vld4q_u16", "arm_neon/vshrn_n_s32", "arm_neon/vpadal_u16", "arm_neon/vorrq_s8", "arm_neon/vrshlq_u64", "arm_neon/vst3_lane_s32", "arm_neon/vqshluq_n_s32", "armintr/_arm_shsub16", "arm_neon/vst1_u32", "arm_neon/vrhadd_s16", "arm_neon/vzipq_s32", "arm_neon/vshrq_n_u16", "arm_neon/vcls_s32", "arm_neon/vceq_s8", "arm_neon/vld2q_lane_f16", "arm_neon/vst4q_u8", "arm_neon/vraddhn_u16", "arm_neon/vget_lane_u64", "armintr/_arm_smlsld", "arm_neon/vld3_u64", "arm_neon/vld1_lane_s16", "arm_neon/vabd_f32", "arm_neon/vdupq_n_u16", "armintr/__iso_volatile_store64", "arm_neon/vqsubq_u8", "arm_neon/poly16x8x3_t", "arm_neon/vcltq_s32", "arm_neon/vqnegq_s16", "arm_neon/vqsub_u16", "arm_neon/vaddq_s32", "arm_neon/vqshl_n_s64", "arm_neon/vabdl_s8", "arm_neon/vclsq_s16", "arm_neon/vpaddl_u8", "arm_neon/vmlsq_n_u16", "armintr/_arm_uqadd8", "arm_neon/vhsub_u32", "arm_neon/vset_lane_s16", "arm_neon/vsubl_u32", "arm_neon/vld3_lane_f32", "arm_neon/vcle_s16", "arm_neon/vmovl_u32", "arm_neon/vst3_lane_f16", "arm_neon/vcaltq_f32", "arm_neon/vsubq_s32", "arm_neon/vand_s64", "arm_neon/vst2_u8", "arm_neon/vcombine_p8", "arm_neon/vqdmlal_s32", "arm_neon/vsub_s32", "armintr/_arm_uxtab16", "arm_neon/vmlsq_n_f32", "armintr/_arm_qdsub", "arm_neon/vhaddq_u32", "arm_neon/vhsubq_u16", "arm_neon/vmlsq_lane_u16", "arm_neon/vst4_s64", "armintr/_CountLeadingOnes", "armintr/_arm_smlabt", "arm_neon/vcombine_s32", "arm_neon/vld4_lane_f16", "arm_neon/vadd_s64", "arm_neon/vorrq_u32", "armintr/__sev", "arm_neon/vdupq_lane_s32", "arm_neon/vrecpsq_f32", "arm_neon/vbicq_u16", "arm_neon/vld1_lane_p16", "arm_neon/vrshr_n_u32", "arm_neon/vcgeq_s32", "arm_neon/vld4_dup_s16", "arm_neon/vld1q_p8", "arm_neon/vrshlq_u16", "arm_neon/vmlaq_lane_u32", "arm_neon/vsub_s64", "arm_neon/vcreate_u16", "arm_neon/vget_lane_s32", "arm_neon/vuzp_f32", "arm_neon/vld2_lane_p8", "arm_neon/vuzp_u16", "arm_neon/vorrq_s16", "armintr/_arm_smlaltb", "arm_neon/vrshrn_n_s16", "arm_neon/vabd_s8", "arm_neon/vnegq_s8", "arm_neon/vst4q_u16", "arm_neon/vst1q_lane_s32", "arm_neon/vst1_lane_s32", "arm_neon/vmla_u16", "arm_neon/vmls_lane_s32", "arm_neon/vtst_s8", "arm_neon/vcgeq_s8", "arm_neon/poly8x8x4_t", "arm_neon/vqsub_s64", "armintr/_arm_uqasx", "arm_neon/vld1_lane_u64", "arm_neon/vminq_s16", "arm_neon/vmulq_u32", "arm_neon/vqrshlq_u8", "arm_neon/vdupq_n_p16", "arm_neon/vld4_dup_f16", "arm_neon/vcls_s16", "arm_neon/vmov_n_u64", "arm_neon/vmla_s32", "arm_neon/vrshl_s16", "arm_neon/vcalt_f32", "arm_neon/int64x2x3_t", "arm_neon/vsub_u8", "arm_neon/vzipq_u8", "arm_neon/vrshrn_n_u64", "arm_neon/vrshlq_s32", "arm_neon/vorr_s64", "arm_neon/vqrshl_s16", "arm_neon/vceqq_u16", "arm_neon/vmulq_n_u16", "arm_neon/vmlaq_u8", "arm_neon/vsri_n_s64", "arm_neon/vld3q_u8", "arm_neon/vld1_dup_s16", "arm_neon/vld1q_s32", "arm_neon/vsri_n_s16", "arm_neon/vshlq_u8", "arm_neon/vsli_n_s64", "arm_neon/vmull_lane_u32", "arm_neon/vshl_s64", "arm_neon/vcreate_s16", "arm_neon/uint8x8x4_t", "arm_neon/vqshrn_n_s32", "arm_neon/vqshlq_u32", "arm_neon/vmlal_n_u32", "arm_neon/vtrnq_s16", "arm_neon/vshr_n_s64", "arm_neon/vst2_u16", "arm_neon/vtrn_s32", "arm_neon/vsubhn_u32", "arm_neon/vbicq_s16", "arm_neon/vsetq_lane_s8", "arm_neon/vrsubhn_s16", "arm_neon/vhsub_u8", "arm_neon/vcleq_s32", "arm_neon/vld4_dup_s8", "arm_neon/vmull_u32", "arm_neon/vrshr_n_s16", "arm_neon/vst1q_lane_s16", "arm_neon/vmlsq_lane_u32", "arm_neon/vnegq_f32", "arm_neon/vmin_s8", "arm_neon/vrev16_p8", "arm_neon/vbic_u8", "arm_neon/vclzq_u16", "arm_neon/vcge_u32", "arm_neon/vget_high_u64", "arm_neon/vabsq_s8", "arm_neon/vhaddq_u16", "arm_neon/vsraq_n_s64", "arm_neon/vld2_u32", "arm_neon/vld2_lane_f32", "arm_neon/vqrshrn_n_u32", "arm_neon/vbslq_s8", "armintr/_CountLeadingZeros64", "arm_neon/vbicq_u8", "arm_neon/vdup_lane_s8", "arm_neon/vpadd_s32", "arm_neon/vld3q_lane_f16", "arm_neon/vaba_u8", "arm_neon/vqshlq_u16", "arm_neon/vst1q_u8", "arm_neon/vst4q_lane_f16", "arm_neon/vshl_n_u16", "armintr/_arm_smladx", "arm_neon/vmla_lane_s16", "arm_neon/vornq_u8", "arm_neon/vqneg_s32", "arm_neon/vadd_s8", "arm_neon/vcle_u32", "arm_neon/vclzq_u8", "arm_neon/vtbx1_u8", "armintr/_CountLeadingOnes64", "armintr/__dsb", "arm_neon/vaddq_u32", "arm_neon/vclsq_s8", "arm_neon/vdup_n_s64", "arm_neon/vmax_s16", "arm_neon/vst2q_u32", "arm_neon/vsetq_lane_s64", "arm_neon/vtst_p8", "arm_neon/vabs_s8", "arm_neon/vqshl_n_s16", "arm_neon/vqrshrn_n_u64", "arm_neon/vaddw_s8", "armintr/_arm_uhadd16", "arm_neon/vsriq_n_p16", "arm_neon/vld4_lane_u32", "arm_neon/vneg_f32", "armintr/_MoveToCoprocessor", "arm_neon/vmvnq_s8", "arm_neon/vld1q_lane_p8", "arm_neon/uint32x2x3_t", "arm_neon/vrshrn_n_u16", "arm_neon/vld3_f16", "arm_neon/vsriq_n_s16", "arm_neon/vshlq_n_s16", "arm_neon/vabal_u8", "arm_neon/vqshluq_n_s16", "arm_neon/vst2_lane_u16", "arm_neon/vbic_s16", "arm_neon/vqshl_n_u64", "arm_neon/vcagt_f32", "arm_neon/vpadalq_s8", "arm_neon/vclz_s32", "arm_neon/vld1_lane_s64", "arm_neon/vget_high_p8", "arm_neon/uint64x1_t", "arm_neon/vextq_s16", "arm_neon/vpadd_s8", "arm_neon/vrsubhn_u64", "arm_neon/vst3q_f16", "arm_neon/vdupq_lane_u16", "arm_neon/vrshrq_n_u64", "arm_neon/vmovq_n_f32", "arm_neon/vld1q_dup_u16", "arm_neon/vshr_n_u16", "arm_neon/uint32x2_t", "armintr/_arm_umull", "arm_neon/vtrnq_u16", "arm_neon/vsetq_lane_u32", "arm_neon/vneg_s8", "arm_neon/vsetq_lane_u8", "arm_neon/vst2q_lane_s16", "arm_neon/vqmovun_s32", "armintr/_arm_usad8", "armintr/_arm_pkhbt", "arm_neon/uint16x4x3_t", "arm_neon/vsra_n_s32", "arm_neon/vqmovun_s64", "arm_neon/vld1q_dup_s8", "arm_neon/vaddhn_s32", "arm_neon/vpmax_f32", "arm_neon/vpadd_u32", "arm_neon/vhsubq_u32", "arm_neon/vqrshrun_n_s32", "arm_neon/vadd_s32", "arm_neon/vclt_s8", "arm_neon/vorrq_s64", "arm_neon/vst4q_f16", "arm_neon/vst1_s32", "arm_neon/vceq_p8", "arm_neon/vsubw_s16", "arm_neon/vgetq_lane_u64", "arm_neon/vmla_n_u32", "arm_neon/vcvtq_f32_s32", "arm_neon/vld1q_u32", "arm_neon/vmax_f32", "armintr/_isunorderedf", "arm_neon/vrshl_u8", "arm_neon/vld4_dup_s64", "arm_neon/vqaddq_u16", "arm_neon/vld4q_lane_f16", "arm_neon/vceqq_p8", "arm_neon/vsubw_u8", "arm_neon/vqmovn_u16", "armintr/_arm_smlsldx", "arm_neon/vcreate_p8", "arm_neon/vqdmull_n_s32", "arm_neon/uint64x2_t", "arm_neon/vmls_s32", "arm_neon/vst3q_f32", "armintr/_arm_bfi", "armintr/_arm_qadd16", "arm_neon/vrshlq_s8", "arm_neon/vget_lane_p16", "arm_neon/vld2_p8", "arm_neon/vld3_lane_u32", "armintr/_MoveFromCoprocessor2", "arm_neon/vqshl_u8", "arm_neon/poly8_t", "arm_neon/vhadd_u16", "arm_neon/vmla_lane_u16", "arm_neon/vshrq_n_u8", "arm_neon/vuzpq_f32", "arm_neon/vmls_lane_f32", "arm_neon/vqneg_s16", "arm_neon/vtrn_p16", "arm_neon/vshrn_n_u32", "arm_neon/vaddhn_u64", "arm_neon/vabal_u32", "arm_neon/vld1q_lane_u32", "arm_neon/vrsraq_n_s32", "arm_neon/vandq_u64", "arm_neon/vqdmull_s32", "arm_neon/vext_s16", "arm_neon/vaddw_s16", "arm_neon/vrev64q_p8", "arm_neon/uint8x8x3_t", "arm_neon/vzip_f32", "armintr/_arm_ssub8", "arm_neon/uint16x4x4_t", "armintr/__swi", "armintr/_arm_smlatb", "arm_neon/vrhaddq_s8", "arm_neon/vpmax_s32", "arm_neon/vqshl_s64", "arm_neon/vrev16q_p8", "arm_neon/vqmovn_u32", "arm_neon/vld1q_f16", "arm_neon/vornq_u64", "arm_neon/vqshlq_n_s16", "arm_neon/vld1_f16", "armintr/_arm_smmlsr", "arm_neon/vshlq_s16", "arm_neon/vsubhn_s16", "arm_neon/vmulq_p8", "arm_neon/vdupq_lane_f32", "armintr/_arm_shadd16", "arm_neon/vornq_s16", "arm_neon/vst1q_lane_u8", "arm_neon/vcaleq_f32", "arm_neon/vst3q_lane_f16", "armintr/_arm_sdiv", "arm_neon/vld2_u16", "arm_neon/vdup_lane_u16", "arm_neon/vst4q_lane_f32", "arm_neon/vdup_n_f32", "arm_neon/vsubq_u8", "arm_neon/vset_lane_p16", "arm_neon/vrsqrte_f32", "arm_neon/vsubl_u8", "arm_neon/vld3q_lane_f32", "arm_neon/vqnegq_s8", "arm_neon/vqmovn_s16", "arm_neon/int16x8x3_t", "arm_neon/veorq_u16", "arm_neon/vqdmulh_n_s16", "arm_neon/vhaddq_u8", "arm_neon/vpadal_u8", "arm_neon/vst2q_s16", "arm_neon/poly16x8x4_t", "arm_neon/int64x2_t", "arm_neon/vmull_s32", "arm_neon/vld4_lane_s32", "arm_neon/vst4q_p8", "arm_neon/vmlal_lane_u16", "arm_neon/vclz_u32", "arm_neon/vsliq_n_s8", "arm_neon/vmls_n_f32", "arm_neon/vmlsl_lane_s16", "arm_neon/vst4q_u32", "arm_neon/vld1q_lane_s16", "arm_neon/vst1q_f32", "arm_neon/vrshr_n_u8", "arm_neon/vst1q_s64", "arm_neon/vbslq_u32", "arm_neon/vset_lane_s8", "arm_neon/vdupq_lane_p16", "arm_neon/vtstq_s16", "arm_neon/vshl_n_s8", "arm_neon/vqrdmulhq_n_s16", "arm_neon/vget_high_f16", "arm_neon/vst4_lane_u32", "arm_neon/vraddhn_s16", "arm_neon/vmlsl_lane_s32", "arm_neon/vld3q_s32", "arm_neon/vsriq_n_u64", "arm_neon/vld4_dup_u8", "arm_neon/vld4q_s8", "arm_neon/vqmovn_s64", "arm_neon/vrev32q_p8", "arm_neon/vsliq_n_p8", "arm_neon/vzipq_s16", "arm_neon/vgetq_lane_s64", "arm_neon/vst4_p16", "arm_neon/vsubq_u16", "arm_neon/vrev64_s32", "armintr/_arm_uhadd8", "arm_neon/vornq_u16", "arm_neon/vst4_lane_s8", "arm_neon/vabd_s32", "arm_neon/vqrdmulhq_s16", "arm_neon/vqshlq_s32", "arm_neon/int64x2x4_t", "arm_neon/vset_lane_u16", "arm_neon/vrsra_n_s32", "arm_neon/vabdl_u16", "arm_neon/vsliq_n_s32"] helpviewer_keywords: ["cl.exe compiler, ARM intrinsics", "intrinsics, ARM", "__cps ARM intrinsic", "__dmb ARM intrinsic", "__dsb ARM intrinsic", "__emit ARM intrinsic", "__hvc ARM intrinsic", "__isb ARM intrinsic", "__iso_volatile_load16 ARM intrinsic", "__iso_volatile_load32 ARM intrinsic", "__iso_volatile_load64 ARM intrinsic", "__iso_volatile_load8 ARM intrinsic", "__iso_volatile_store16 ARM intrinsic", "__iso_volatile_store32 ARM intrinsic", "__iso_volatile_store64 ARM intrinsic", "__iso_volatile_store8 ARM intrinsic", "__ldrexd ARM intrinsic", "__prefetch ARM intrinsic", "__rdpmccntr64 ARM intrinsic", "__sev ARM intrinsic", "__static_assert ARM intrinsic", "__swi ARM intrinsic", "__trap ARM intrinsic", "__wfe ARM intrinsic", "__wfi ARM intrinsic", "_AddSatInt ARM intrinsic", "_arm_bfc ARM intrinsic", "_arm_bfi ARM intrinsic", "_arm_clz ARM intrinsic", "_arm_pkhbt ARM intrinsic", "_arm_pkhtb ARM intrinsic", "_arm_qadd ARM intrinsic", "_arm_qadd16 ARM intrinsic", "_arm_qadd8 ARM intrinsic", "_arm_qasx ARM intrinsic", "_arm_qdadd ARM intrinsic", "_arm_qdsub ARM intrinsic", "_arm_qsax ARM intrinsic", "_arm_qsub ARM intrinsic", "_arm_qsub16 ARM intrinsic", "_arm_qsub8 ARM intrinsic", "_arm_rbit ARM intrinsic", "_arm_rev ARM intrinsic", "_arm_rev16 ARM intrinsic", "_arm_revsh ARM intrinsic", "_arm_sadd16 ARM intrinsic", "_arm_sadd8 ARM intrinsic", "_arm_sasx ARM intrinsic", "_arm_sbfx ARM intrinsic", "_arm_sdiv ARM intrinsic", "_arm_shadd16 ARM intrinsic", "_arm_shadd8 ARM intrinsic", "_arm_shasx ARM intrinsic", "_arm_shsax ARM intrinsic", "_arm_shsub16 ARM intrinsic", "_arm_shsub8 ARM intrinsic", "_arm_smlabb ARM intrinsic", "_arm_smlabt ARM intrinsic", "_arm_smlad ARM intrinsic", "_arm_smladx ARM intrinsic", "_arm_smlal ARM intrinsic", "_arm_smlalbb ARM intrinsic", "_arm_smlalbt ARM intrinsic", "_arm_smlald ARM intrinsic", "_arm_smlaldx ARM intrinsic", "_arm_smlaltb ARM intrinsic", "_arm_smlaltt ARM intrinsic", "_arm_smlatb ARM intrinsic", "_arm_smlatt ARM intrinsic", "_arm_smlawb ARM intrinsic", "_arm_smlawt ARM intrinsic", "_arm_smlsd ARM intrinsic", "_arm_smlsdx ARM intrinsic", "_arm_smlsld ARM intrinsic", "_arm_smlsldx ARM intrinsic", "_arm_smmla ARM intrinsic", "_arm_smmlar ARM intrinsic", "_arm_smmls ARM intrinsic", "_arm_smmlsr ARM intrinsic", "_arm_smmul ARM intrinsic", "_arm_smmulr ARM intrinsic", "_arm_smuad ARM intrinsic", "_arm_smuadx ARM intrinsic", "_arm_smulbb ARM intrinsic", "_arm_smulbt ARM intrinsic", "_arm_smull ARM intrinsic", "_arm_smultb ARM intrinsic", "_arm_smultt ARM intrinsic", "_arm_smulwb ARM intrinsic", "_arm_smulwt ARM intrinsic", "_arm_smusd ARM intrinsic", "_arm_smusdx ARM intrinsic", "_arm_ssat ARM intrinsic", "_arm_ssat16 ARM intrinsic", "_arm_ssax ARM intrinsic", "_arm_ssub16 ARM intrinsic", "_arm_ssub8 ARM intrinsic", "_arm_sxtab ARM intrinsic", "_arm_sxtab16 ARM intrinsic", "_arm_sxtah ARM intrinsic", "_arm_sxtb ARM intrinsic", "_arm_sxtb16 ARM intrinsic", "_arm_sxth ARM intrinsic", "_arm_uadd16 ARM intrinsic", "_arm_uadd8 ARM intrinsic", "_arm_uasx ARM intrinsic", "_arm_ubfx ARM intrinsic", "_arm_udiv ARM intrinsic", "_arm_uhadd16 ARM intrinsic", "_arm_uhadd8 ARM intrinsic", "_arm_uhasx ARM intrinsic", "_arm_uhsax ARM intrinsic", "_arm_uhsub16 ARM intrinsic", "_arm_uhsub8 ARM intrinsic", "_arm_umaal ARM intrinsic", "_arm_umlal ARM intrinsic", "_arm_umull ARM intrinsic", "_arm_uqadd16 ARM intrinsic", "_arm_uqadd8 ARM intrinsic", "_arm_uqasx ARM intrinsic", "_arm_uqsax ARM intrinsic", "_arm_uqsub16 ARM intrinsic", "_arm_uqsub8 ARM intrinsic", "_arm_usad8 ARM intrinsic", "_arm_usada8 ARM intrinsic", "_arm_usat ARM intrinsic", "_arm_usat16 ARM intrinsic", "_arm_usax ARM intrinsic", "_arm_usub16 ARM intrinsic", "_arm_usub8 ARM intrinsic", "_arm_uxtab ARM intrinsic", "_arm_uxtab16 ARM intrinsic", "_arm_uxtah ARM intrinsic", "_arm_uxtb ARM intrinsic", "_arm_uxtb16 ARM intrinsic", "_arm_uxth ARM intrinsic", "_CopyDoubleFromInt64 ARM intrinsic", "_CopyFloatFromInt32 ARM intrinsic", "_CopyInt32FromFloat ARM intrinsic", "_CopyInt64FromDouble ARM intrinsic", "_CountLeadingOnes ARM intrinsic", "_CountLeadingOnes64 ARM intrinsic", "_CountLeadingSigns ARM intrinsic", "_CountLeadingSigns64 ARM intrinsic", "_CountLeadingZeros ARM intrinsic", "_CountLeadingZeros64 ARM intrinsic", "_CountOneBits ARM intrinsic", "_CountOneBits64 ARM intrinsic", "_DAddSatInt ARM intrinsic", "_DSubSatInt ARM intrinsic", "_isunordered ARM intrinsic", "_isunorderedf ARM intrinsic", "_MoveFromCoprocessor ARM intrinsic", "_MoveFromCoprocessor2 ARM intrinsic", "_MoveFromCoprocessor64 ARM intrinsic", "_MoveToCoprocessor ARM intrinsic", "_MoveToCoprocessor2 ARM intrinsic", "_MoveToCoprocessor64 ARM intrinsic", "_MulHigh ARM intrinsic", "_MulUnsignedHigh ARM intrinsic", "_ReadBankedReg ARM intrinsic", "_ReadStatusReg ARM intrinsic", "_SubSatInt ARM intrinsic", "_WriteBankedReg ARM intrinsic", "_WriteStatusReg ARM intrinsic", "float32x2_t ARM intrinsic", "float32x2x2_t ARM intrinsic", "float32x2x3_t ARM intrinsic", "float32x2x4_t ARM intrinsic", "float32x4_t ARM intrinsic", "float32x4x2_t ARM intrinsic", "float32x4x3_t ARM intrinsic", "float32x4x4_t ARM intrinsic", "int16x4_t ARM intrinsic", "int16x4x2_t ARM intrinsic", "int16x4x3_t ARM intrinsic", "int16x4x4_t ARM intrinsic", "int16x8_t ARM intrinsic", "int16x8x2_t ARM intrinsic", "int16x8x3_t ARM intrinsic", "int16x8x4_t ARM intrinsic", "int32x2_t ARM intrinsic", "int32x2x2_t ARM intrinsic", "int32x2x3_t ARM intrinsic", "int32x2x4_t ARM intrinsic", "int32x4_t ARM intrinsic", "int32x4x2_t ARM intrinsic", "int32x4x3_t ARM intrinsic", "int32x4x4_t ARM intrinsic", "int64x1_t ARM intrinsic", "int64x1x2_t ARM intrinsic", "int64x1x3_t ARM intrinsic", "int64x1x4_t ARM intrinsic", "int64x2_t ARM intrinsic", "int64x2x2_t ARM intrinsic", "int64x2x3_t ARM intrinsic", "int64x2x4_t ARM intrinsic", "int8x16_t ARM intrinsic", "int8x16x2_t ARM intrinsic", "int8x16x3_t ARM intrinsic", "int8x16x4_t ARM intrinsic", "int8x8_t ARM intrinsic", "int8x8x2_t ARM intrinsic", "int8x8x3_t ARM intrinsic", "int8x8x4_t ARM intrinsic", "poly16_t ARM intrinsic", "poly16x4_t ARM intrinsic", "poly16x4x2_t ARM intrinsic", "poly16x4x3_t ARM intrinsic", "poly16x4x4_t ARM intrinsic", "poly16x8_t ARM intrinsic", "poly16x8x2_t ARM intrinsic", "poly16x8x3_t ARM intrinsic", "poly16x8x4_t ARM intrinsic", "poly8_t ARM intrinsic", "poly8x16_t ARM intrinsic", "poly8x16x2_t ARM intrinsic", "poly8x16x3_t ARM intrinsic", "poly8x16x4_t ARM intrinsic", "poly8x8_t ARM intrinsic", "poly8x8x2_t ARM intrinsic", "poly8x8x3_t ARM intrinsic", "poly8x8x4_t ARM intrinsic", "uint16x4_t ARM intrinsic", "uint16x4x2_t ARM intrinsic", "uint16x4x3_t ARM intrinsic", "uint16x4x4_t ARM intrinsic", "uint16x8_t ARM intrinsic", "uint16x8x2_t ARM intrinsic", "uint16x8x3_t ARM intrinsic", "uint16x8x4_t ARM intrinsic", "uint32x2_t ARM intrinsic", "uint32x2x2_t ARM intrinsic", "uint32x2x3_t ARM intrinsic", "uint32x2x4_t ARM intrinsic", "uint32x4_t ARM intrinsic", "uint32x4x2_t ARM intrinsic", "uint32x4x3_t ARM intrinsic", "uint32x4x4_t ARM intrinsic", "uint64x1_t ARM intrinsic", "uint64x1x2_t ARM intrinsic", "uint64x1x3_t ARM intrinsic", "uint64x1x4_t ARM intrinsic", "uint64x2_t ARM intrinsic", "uint64x2x2_t ARM intrinsic", "uint64x2x3_t ARM intrinsic", "uint64x2x4_t ARM intrinsic", "uint8x16_t ARM intrinsic", "uint8x16x2_t ARM intrinsic", "uint8x16x3_t ARM intrinsic", "uint8x16x4_t ARM intrinsic", "uint8x8_t ARM intrinsic", "uint8x8x2_t ARM intrinsic", "uint8x8x3_t ARM intrinsic", "uint8x8x4_t ARM intrinsic", "vaba_s16 ARM intrinsic", "vaba_s32 ARM intrinsic", "vaba_s8 ARM intrinsic", "vaba_u16 ARM intrinsic", "vaba_u32 ARM intrinsic", "vaba_u8 ARM intrinsic", "vabal_s16 ARM intrinsic", "vabal_s32 ARM intrinsic", "vabal_s8 ARM intrinsic", "vabal_u16 ARM intrinsic", "vabal_u32 ARM intrinsic", "vabal_u8 ARM intrinsic", "vabaq_s16 ARM intrinsic", "vabaq_s32 ARM intrinsic", "vabaq_s8 ARM intrinsic", "vabaq_u16 ARM intrinsic", "vabaq_u32 ARM intrinsic", "vabaq_u8 ARM intrinsic", "vabd_f32 ARM intrinsic", "vabd_s16 ARM intrinsic", "vabd_s32 ARM intrinsic", "vabd_s8 ARM intrinsic", "vabd_u16 ARM intrinsic", "vabd_u32 ARM intrinsic", "vabd_u8 ARM intrinsic", "vabdl_s16 ARM intrinsic", "vabdl_s32 ARM intrinsic", "vabdl_s8 ARM intrinsic", "vabdl_u16 ARM intrinsic", "vabdl_u32 ARM intrinsic", "vabdl_u8 ARM intrinsic", "vabdq_f32 ARM intrinsic", "vabdq_s16 ARM intrinsic", "vabdq_s32 ARM intrinsic", "vabdq_s8 ARM intrinsic", "vabdq_u16 ARM intrinsic", "vabdq_u32 ARM intrinsic", "vabdq_u8 ARM intrinsic", "vabs_f32 ARM intrinsic", "vabs_s16 ARM intrinsic", "vabs_s32 ARM intrinsic", "vabs_s8 ARM intrinsic", "vabsq_f32 ARM intrinsic", "vabsq_s16 ARM intrinsic", "vabsq_s32 ARM intrinsic", "vabsq_s8 ARM intrinsic", "vadd_f32 ARM intrinsic", "vadd_s16 ARM intrinsic", "vadd_s32 ARM intrinsic", "vadd_s64 ARM intrinsic", "vadd_s8 ARM intrinsic", "vadd_u16 ARM intrinsic", "vadd_u32 ARM intrinsic", "vadd_u64 ARM intrinsic", "vadd_u8 ARM intrinsic", "vaddhn_s16 ARM intrinsic", "vaddhn_s32 ARM intrinsic", "vaddhn_s64 ARM intrinsic", "vaddhn_u16 ARM intrinsic", "vaddhn_u32 ARM intrinsic", "vaddhn_u64 ARM intrinsic", "vaddl_s16 ARM intrinsic", "vaddl_s32 ARM intrinsic", "vaddl_s8 ARM intrinsic", "vaddl_u16 ARM intrinsic", "vaddl_u32 ARM intrinsic", "vaddl_u8 ARM intrinsic", "vaddq_f32 ARM intrinsic", "vaddq_s16 ARM intrinsic", "vaddq_s32 ARM intrinsic", "vaddq_s64 ARM intrinsic", "vaddq_s8 ARM intrinsic", "vaddq_u16 ARM intrinsic", "vaddq_u32 ARM intrinsic", "vaddq_u64 ARM intrinsic", "vaddq_u8 ARM intrinsic", "vaddw_s16 ARM intrinsic", "vaddw_s32 ARM intrinsic", "vaddw_s8 ARM intrinsic", "vaddw_u16 ARM intrinsic", "vaddw_u32 ARM intrinsic", "vaddw_u8 ARM intrinsic", "vand_s16 ARM intrinsic", "vand_s32 ARM intrinsic", "vand_s64 ARM intrinsic", "vand_s8 ARM intrinsic", "vand_u16 ARM intrinsic", "vand_u32 ARM intrinsic", "vand_u64 ARM intrinsic", "vand_u8 ARM intrinsic", "vandq_s16 ARM intrinsic", "vandq_s32 ARM intrinsic", "vandq_s64 ARM intrinsic", "vandq_s8 ARM intrinsic", "vandq_u16 ARM intrinsic", "vandq_u32 ARM intrinsic", "vandq_u64 ARM intrinsic", "vandq_u8 ARM intrinsic", "vbic_s16 ARM intrinsic", "vbic_s32 ARM intrinsic", "vbic_s64 ARM intrinsic", "vbic_s8 ARM intrinsic", "vbic_u16 ARM intrinsic", "vbic_u32 ARM intrinsic", "vbic_u64 ARM intrinsic", "vbic_u8 ARM intrinsic", "vbicq_s16 ARM intrinsic", "vbicq_s32 ARM intrinsic", "vbicq_s64 ARM intrinsic", "vbicq_s8 ARM intrinsic", "vbicq_u16 ARM intrinsic", "vbicq_u32 ARM intrinsic", "vbicq_u64 ARM intrinsic", "vbicq_u8 ARM intrinsic", "vbsl_f32 ARM intrinsic", "vbsl_p16 ARM intrinsic", "vbsl_p8 ARM intrinsic", "vbsl_s16 ARM intrinsic", "vbsl_s32 ARM intrinsic", "vbsl_s64 ARM intrinsic", "vbsl_s8 ARM intrinsic", "vbsl_u16 ARM intrinsic", "vbsl_u32 ARM intrinsic", "vbsl_u64 ARM intrinsic", "vbsl_u8 ARM intrinsic", "vbslq_f32 ARM intrinsic", "vbslq_p16 ARM intrinsic", "vbslq_p8 ARM intrinsic", "vbslq_s16 ARM intrinsic", "vbslq_s32 ARM intrinsic", "vbslq_s64 ARM intrinsic", "vbslq_s8 ARM intrinsic", "vbslq_u16 ARM intrinsic", "vbslq_u32 ARM intrinsic", "vbslq_u64 ARM intrinsic", "vbslq_u8 ARM intrinsic", "vcage_f32 ARM intrinsic", "vcageq_f32 ARM intrinsic", "vcagt_f32 ARM intrinsic", "vcagtq_f32 ARM intrinsic", "vcale_f32 ARM intrinsic", "vcaleq_f32 ARM intrinsic", "vcalt_f32 ARM intrinsic", "vcaltq_f32 ARM intrinsic", "vceq_f32 ARM intrinsic", "vceq_p8 ARM intrinsic", "vceq_s16 ARM intrinsic", "vceq_s32 ARM intrinsic", "vceq_s8 ARM intrinsic", "vceq_u16 ARM intrinsic", "vceq_u32 ARM intrinsic", "vceq_u8 ARM intrinsic", "vceqq_f32 ARM intrinsic", "vceqq_p8 ARM intrinsic", "vceqq_s16 ARM intrinsic", "vceqq_s32 ARM intrinsic", "vceqq_s8 ARM intrinsic", "vceqq_u16 ARM intrinsic", "vceqq_u32 ARM intrinsic", "vceqq_u8 ARM intrinsic", "vcge_f32 ARM intrinsic", "vcge_s16 ARM intrinsic", "vcge_s32 ARM intrinsic", "vcge_s8 ARM intrinsic", "vcge_u16 ARM intrinsic", "vcge_u32 ARM intrinsic", "vcge_u8 ARM intrinsic", "vcgeq_f32 ARM intrinsic", "vcgeq_s16 ARM intrinsic", "vcgeq_s32 ARM intrinsic", "vcgeq_s8 ARM intrinsic", "vcgeq_u16 ARM intrinsic", "vcgeq_u32 ARM intrinsic", "vcgeq_u8 ARM intrinsic", "vcgt_f32 ARM intrinsic", "vcgt_s16 ARM intrinsic", "vcgt_s32 ARM intrinsic", "vcgt_s8 ARM intrinsic", "vcgt_u16 ARM intrinsic", "vcgt_u32 ARM intrinsic", "vcgt_u8 ARM intrinsic", "vcgtq_f32 ARM intrinsic", "vcgtq_s16 ARM intrinsic", "vcgtq_s32 ARM intrinsic", "vcgtq_s8 ARM intrinsic", "vcgtq_u16 ARM intrinsic", "vcgtq_u32 ARM intrinsic", "vcgtq_u8 ARM intrinsic", "vcle_f32 ARM intrinsic", "vcle_s16 ARM intrinsic", "vcle_s32 ARM intrinsic", "vcle_s8 ARM intrinsic", "vcle_u16 ARM intrinsic", "vcle_u32 ARM intrinsic", "vcle_u8 ARM intrinsic", "vcleq_f32 ARM intrinsic", "vcleq_s16 ARM intrinsic", "vcleq_s32 ARM intrinsic", "vcleq_s8 ARM intrinsic", "vcleq_u16 ARM intrinsic", "vcleq_u32 ARM intrinsic", "vcleq_u8 ARM intrinsic", "vcls_s16 ARM intrinsic", "vcls_s32 ARM intrinsic", "vcls_s8 ARM intrinsic", "vclsq_s16 ARM intrinsic", "vclsq_s32 ARM intrinsic", "vclsq_s8 ARM intrinsic", "vclt_f32 ARM intrinsic", "vclt_s16 ARM intrinsic", "vclt_s32 ARM intrinsic", "vclt_s8 ARM intrinsic", "vclt_u16 ARM intrinsic", "vclt_u32 ARM intrinsic", "vclt_u8 ARM intrinsic", "vcltq_f32 ARM intrinsic", "vcltq_s16 ARM intrinsic", "vcltq_s32 ARM intrinsic", "vcltq_s8 ARM intrinsic", "vcltq_u16 ARM intrinsic", "vcltq_u32 ARM intrinsic", "vcltq_u8 ARM intrinsic", "vclz_s16 ARM intrinsic", "vclz_s32 ARM intrinsic", "vclz_s8 ARM intrinsic", "vclz_u16 ARM intrinsic", "vclz_u32 ARM intrinsic", "vclz_u8 ARM intrinsic", "vclzq_s16 ARM intrinsic", "vclzq_s32 ARM intrinsic", "vclzq_s8 ARM intrinsic", "vclzq_u16 ARM intrinsic", "vclzq_u32 ARM intrinsic", "vclzq_u8 ARM intrinsic", "vcnt_p8 ARM intrinsic", "vcnt_s8 ARM intrinsic", "vcnt_u8 ARM intrinsic", "vcntq_p8 ARM intrinsic", "vcntq_s8 ARM intrinsic", "vcntq_u8 ARM intrinsic", "vcombine_f16 ARM intrinsic", "vcombine_f32 ARM intrinsic", "vcombine_p16 ARM intrinsic", "vcombine_p8 ARM intrinsic", "vcombine_s16 ARM intrinsic", "vcombine_s32 ARM intrinsic", "vcombine_s64 ARM intrinsic", "vcombine_s8 ARM intrinsic", "vcombine_u16 ARM intrinsic", "vcombine_u32 ARM intrinsic", "vcombine_u64 ARM intrinsic", "vcombine_u8 ARM intrinsic", "vcreate_f16 ARM intrinsic", "vcreate_f32 ARM intrinsic", "vcreate_p16 ARM intrinsic", "vcreate_p8 ARM intrinsic", "vcreate_s16 ARM intrinsic", "vcreate_s32 ARM intrinsic", "vcreate_s64 ARM intrinsic", "vcreate_s8 ARM intrinsic", "vcreate_u16 ARM intrinsic", "vcreate_u32 ARM intrinsic", "vcreate_u64 ARM intrinsic", "vcreate_u8 ARM intrinsic", "vcvt_f16_f32 ARM intrinsic", "vcvt_f32_f16 ARM intrinsic", "vcvt_f32_s32 ARM intrinsic", "vcvt_f32_u32 ARM intrinsic", "vcvt_n_f32_s32 ARM intrinsic", "vcvt_n_f32_u32 ARM intrinsic", "vcvt_n_s32_f32 ARM intrinsic", "vcvt_n_u32_f32 ARM intrinsic", "vcvt_s32_f32 ARM intrinsic", "vcvt_u32_f32 ARM intrinsic", "vcvtq_f32_s32 ARM intrinsic", "vcvtq_f32_u32 ARM intrinsic", "vcvtq_n_f32_s32 ARM intrinsic", "vcvtq_n_f32_u32 ARM intrinsic", "vcvtq_n_s32_f32 ARM intrinsic", "vcvtq_n_u32_f32 ARM intrinsic", "vcvtq_s32_f32 ARM intrinsic", "vcvtq_u32_f32 ARM intrinsic", "vdup_lane_f32 ARM intrinsic", "vdup_lane_p16 ARM intrinsic", "vdup_lane_p8 ARM intrinsic", "vdup_lane_s16 ARM intrinsic", "vdup_lane_s32 ARM intrinsic", "vdup_lane_s64 ARM intrinsic", "vdup_lane_s8 ARM intrinsic", "vdup_lane_u16 ARM intrinsic", "vdup_lane_u32 ARM intrinsic", "vdup_lane_u64 ARM intrinsic", "vdup_lane_u8 ARM intrinsic", "vdup_n_f32 ARM intrinsic", "vdup_n_p16 ARM intrinsic", "vdup_n_p8 ARM intrinsic", "vdup_n_s16 ARM intrinsic", "vdup_n_s32 ARM intrinsic", "vdup_n_s64 ARM intrinsic", "vdup_n_s8 ARM intrinsic", "vdup_n_u16 ARM intrinsic", "vdup_n_u32 ARM intrinsic", "vdup_n_u64 ARM intrinsic", "vdup_n_u8 ARM intrinsic", "vdupq_lane_f32 ARM intrinsic", "vdupq_lane_p16 ARM intrinsic", "vdupq_lane_p8 ARM intrinsic", "vdupq_lane_s16 ARM intrinsic", "vdupq_lane_s32 ARM intrinsic", "vdupq_lane_s64 ARM intrinsic", "vdupq_lane_s8 ARM intrinsic", "vdupq_lane_u16 ARM intrinsic", "vdupq_lane_u32 ARM intrinsic", "vdupq_lane_u64 ARM intrinsic", "vdupq_lane_u8 ARM intrinsic", "vdupq_n_f32 ARM intrinsic", "vdupq_n_p16 ARM intrinsic", "vdupq_n_p8 ARM intrinsic", "vdupq_n_s16 ARM intrinsic", "vdupq_n_s32 ARM intrinsic", "vdupq_n_s64 ARM intrinsic", "vdupq_n_s8 ARM intrinsic", "vdupq_n_u16 ARM intrinsic", "vdupq_n_u32 ARM intrinsic", "vdupq_n_u64 ARM intrinsic", "vdupq_n_u8 ARM intrinsic", "veor_s16 ARM intrinsic", "veor_s32 ARM intrinsic", "veor_s64 ARM intrinsic", "veor_s8 ARM intrinsic", "veor_u16 ARM intrinsic", "veor_u32 ARM intrinsic", "veor_u64 ARM intrinsic", "veor_u8 ARM intrinsic", "veorq_s16 ARM intrinsic", "veorq_s32 ARM intrinsic", "veorq_s64 ARM intrinsic", "veorq_s8 ARM intrinsic", "veorq_u16 ARM intrinsic", "veorq_u32 ARM intrinsic", "veorq_u64 ARM intrinsic", "veorq_u8 ARM intrinsic", "vext_p16 ARM intrinsic", "vext_p8 ARM intrinsic", "vext_s16 ARM intrinsic", "vext_s32 ARM intrinsic", "vext_s64 ARM intrinsic", "vext_s8 ARM intrinsic", "vext_u16 ARM intrinsic", "vext_u32 ARM intrinsic", "vext_u64 ARM intrinsic", "vext_u8 ARM intrinsic", "vextq_p16 ARM intrinsic", "vextq_p8 ARM intrinsic", "vextq_s16 ARM intrinsic", "vextq_s32 ARM intrinsic", "vextq_s64 ARM intrinsic", "vextq_s8 ARM intrinsic", "vextq_u16 ARM intrinsic", "vextq_u32 ARM intrinsic", "vextq_u64 ARM intrinsic", "vextq_u8 ARM intrinsic", "vget_high_f16 ARM intrinsic", "vget_high_f32 ARM intrinsic", "vget_high_p16 ARM intrinsic", "vget_high_p8 ARM intrinsic", "vget_high_s16 ARM intrinsic", "vget_high_s32 ARM intrinsic", "vget_high_s64 ARM intrinsic", "vget_high_s8 ARM intrinsic", "vget_high_u16 ARM intrinsic", "vget_high_u32 ARM intrinsic", "vget_high_u64 ARM intrinsic", "vget_high_u8 ARM intrinsic", "vget_lane_f32 ARM intrinsic", "vget_lane_p16 ARM intrinsic", "vget_lane_p8 ARM intrinsic", "vget_lane_s16 ARM intrinsic", "vget_lane_s32 ARM intrinsic", "vget_lane_s64 ARM intrinsic", "vget_lane_s8 ARM intrinsic", "vget_lane_u16 ARM intrinsic", "vget_lane_u32 ARM intrinsic", "vget_lane_u64 ARM intrinsic", "vget_lane_u8 ARM intrinsic", "vget_low_f16 ARM intrinsic", "vget_low_f32 ARM intrinsic", "vget_low_p16 ARM intrinsic", "vget_low_p8 ARM intrinsic", "vget_low_s16 ARM intrinsic", "vget_low_s32 ARM intrinsic", "vget_low_s64 ARM intrinsic", "vget_low_s8 ARM intrinsic", "vget_low_u16 ARM intrinsic", "vget_low_u32 ARM intrinsic", "vget_low_u64 ARM intrinsic", "vget_low_u8 ARM intrinsic", "vgetq_lane_f32 ARM intrinsic", "vgetq_lane_p16 ARM intrinsic", "vgetq_lane_p8 ARM intrinsic", "vgetq_lane_s16 ARM intrinsic", "vgetq_lane_s32 ARM intrinsic", "vgetq_lane_s64 ARM intrinsic", "vgetq_lane_s8 ARM intrinsic", "vgetq_lane_u16 ARM intrinsic", "vgetq_lane_u32 ARM intrinsic", "vgetq_lane_u64 ARM intrinsic", "vgetq_lane_u8 ARM intrinsic", "vhadd_s16 ARM intrinsic", "vhadd_s32 ARM intrinsic", "vhadd_s8 ARM intrinsic", "vhadd_u16 ARM intrinsic", "vhadd_u32 ARM intrinsic", "vhadd_u8 ARM intrinsic", "vhaddq_s16 ARM intrinsic", "vhaddq_s32 ARM intrinsic", "vhaddq_s8 ARM intrinsic", "vhaddq_u16 ARM intrinsic", "vhaddq_u32 ARM intrinsic", "vhaddq_u8 ARM intrinsic", "vhsub_s16 ARM intrinsic", "vhsub_s32 ARM intrinsic", "vhsub_s8 ARM intrinsic", "vhsub_u16 ARM intrinsic", "vhsub_u32 ARM intrinsic", "vhsub_u8 ARM intrinsic", "vhsubq_s16 ARM intrinsic", "vhsubq_s32 ARM intrinsic", "vhsubq_s8 ARM intrinsic", "vhsubq_u16 ARM intrinsic", "vhsubq_u32 ARM intrinsic", "vhsubq_u8 ARM intrinsic", "vld1_dup_f16 ARM intrinsic", "vld1_dup_f32 ARM intrinsic", "vld1_dup_p16 ARM intrinsic", "vld1_dup_p8 ARM intrinsic", "vld1_dup_s16 ARM intrinsic", "vld1_dup_s32 ARM intrinsic", "vld1_dup_s64 ARM intrinsic", "vld1_dup_s8 ARM intrinsic", "vld1_dup_u16 ARM intrinsic", "vld1_dup_u32 ARM intrinsic", "vld1_dup_u64 ARM intrinsic", "vld1_dup_u8 ARM intrinsic", "vld1_f16 ARM intrinsic", "vld1_f32 ARM intrinsic", "vld1_lane_f32 ARM intrinsic", "vld1_lane_p16 ARM intrinsic", "vld1_lane_p8 ARM intrinsic", "vld1_lane_s16 ARM intrinsic", "vld1_lane_s32 ARM intrinsic", "vld1_lane_s64 ARM intrinsic", "vld1_lane_s8 ARM intrinsic", "vld1_lane_u16 ARM intrinsic", "vld1_lane_u32 ARM intrinsic", "vld1_lane_u64 ARM intrinsic", "vld1_lane_u8 ARM intrinsic", "vld1_p16 ARM intrinsic", "vld1_p8 ARM intrinsic", "vld1_s16 ARM intrinsic", "vld1_s32 ARM intrinsic", "vld1_s64 ARM intrinsic", "vld1_s8 ARM intrinsic", "vld1_u16 ARM intrinsic", "vld1_u32 ARM intrinsic", "vld1_u64 ARM intrinsic", "vld1_u8 ARM intrinsic", "vld1q_dup_f16 ARM intrinsic", "vld1q_dup_f32 ARM intrinsic", "vld1q_dup_p16 ARM intrinsic", "vld1q_dup_p8 ARM intrinsic", "vld1q_dup_s16 ARM intrinsic", "vld1q_dup_s32 ARM intrinsic", "vld1q_dup_s64 ARM intrinsic", "vld1q_dup_s8 ARM intrinsic", "vld1q_dup_u16 ARM intrinsic", "vld1q_dup_u32 ARM intrinsic", "vld1q_dup_u64 ARM intrinsic", "vld1q_dup_u8 ARM intrinsic", "vld1q_f16 ARM intrinsic", "vld1q_f32 ARM intrinsic", "vld1q_lane_f16 ARM intrinsic", "vld1q_lane_f32 ARM intrinsic", "vld1q_lane_p16 ARM intrinsic", "vld1q_lane_p8 ARM intrinsic", "vld1q_lane_s16 ARM intrinsic", "vld1q_lane_s32 ARM intrinsic", "vld1q_lane_s64 ARM intrinsic", "vld1q_lane_s8 ARM intrinsic", "vld1q_lane_u16 ARM intrinsic", "vld1q_lane_u32 ARM intrinsic", "vld1q_lane_u64 ARM intrinsic", "vld1q_lane_u8 ARM intrinsic", "vld1q_p16 ARM intrinsic", "vld1q_p8 ARM intrinsic", "vld1q_s16 ARM intrinsic", "vld1q_s32 ARM intrinsic", "vld1q_s64 ARM intrinsic", "vld1q_s8 ARM intrinsic", "vld1q_u16 ARM intrinsic", "vld1q_u32 ARM intrinsic", "vld1q_u64 ARM intrinsic", "vld1q_u8 ARM intrinsic", "vld2_dup_f16 ARM intrinsic", "vld2_dup_f32 ARM intrinsic", "vld2_dup_p16 ARM intrinsic", "vld2_dup_p8 ARM intrinsic", "vld2_dup_s16 ARM intrinsic", "vld2_dup_s32 ARM intrinsic", "vld2_dup_s64 ARM intrinsic", "vld2_dup_s8 ARM intrinsic", "vld2_dup_u16 ARM intrinsic", "vld2_dup_u32 ARM intrinsic", "vld2_dup_u64 ARM intrinsic", "vld2_dup_u8 ARM intrinsic", "vld2_f16 ARM intrinsic", "vld2_f32 ARM intrinsic", "vld2_lane_f16 ARM intrinsic", "vld2_lane_f32 ARM intrinsic", "vld2_lane_p16 ARM intrinsic", "vld2_lane_p8 ARM intrinsic", "vld2_lane_s16 ARM intrinsic", "vld2_lane_s32 ARM intrinsic", "vld2_lane_s8 ARM intrinsic", "vld2_lane_u16 ARM intrinsic", "vld2_lane_u32 ARM intrinsic", "vld2_lane_u8 ARM intrinsic", "vld2_p16 ARM intrinsic", "vld2_p8 ARM intrinsic", "vld2_s16 ARM intrinsic", "vld2_s32 ARM intrinsic", "vld2_s64 ARM intrinsic", "vld2_s8 ARM intrinsic", "vld2_u16 ARM intrinsic", "vld2_u32 ARM intrinsic", "vld2_u64 ARM intrinsic", "vld2_u8 ARM intrinsic", "vld2q_f16 ARM intrinsic", "vld2q_f32 ARM intrinsic", "vld2q_lane_f16 ARM intrinsic", "vld2q_lane_f32 ARM intrinsic", "vld2q_lane_p16 ARM intrinsic", "vld2q_lane_s16 ARM intrinsic", "vld2q_lane_s32 ARM intrinsic", "vld2q_lane_u16 ARM intrinsic", "vld2q_lane_u32 ARM intrinsic", "vld2q_p16 ARM intrinsic", "vld2q_p8 ARM intrinsic", "vld2q_s16 ARM intrinsic", "vld2q_s32 ARM intrinsic", "vld2q_s8 ARM intrinsic", "vld2q_u16 ARM intrinsic", "vld2q_u32 ARM intrinsic", "vld2q_u8 ARM intrinsic", "vld3_dup_f16 ARM intrinsic", "vld3_dup_f32 ARM intrinsic", "vld3_dup_p16 ARM intrinsic", "vld3_dup_p8 ARM intrinsic", "vld3_dup_s16 ARM intrinsic", "vld3_dup_s32 ARM intrinsic", "vld3_dup_s64 ARM intrinsic", "vld3_dup_s8 ARM intrinsic", "vld3_dup_u16 ARM intrinsic", "vld3_dup_u32 ARM intrinsic", "vld3_dup_u64 ARM intrinsic", "vld3_dup_u8 ARM intrinsic", "vld3_f16 ARM intrinsic", "vld3_f32 ARM intrinsic", "vld3_lane_f16 ARM intrinsic", "vld3_lane_f32 ARM intrinsic", "vld3_lane_p16 ARM intrinsic", "vld3_lane_p8 ARM intrinsic", "vld3_lane_s16 ARM intrinsic", "vld3_lane_s32 ARM intrinsic", "vld3_lane_s8 ARM intrinsic", "vld3_lane_u16 ARM intrinsic", "vld3_lane_u32 ARM intrinsic", "vld3_lane_u8 ARM intrinsic", "vld3_p16 ARM intrinsic", "vld3_p8 ARM intrinsic", "vld3_s16 ARM intrinsic", "vld3_s32 ARM intrinsic", "vld3_s64 ARM intrinsic", "vld3_s8 ARM intrinsic", "vld3_u16 ARM intrinsic", "vld3_u32 ARM intrinsic", "vld3_u64 ARM intrinsic", "vld3_u8 ARM intrinsic", "vld3q_f16 ARM intrinsic", "vld3q_f32 ARM intrinsic", "vld3q_lane_f16 ARM intrinsic", "vld3q_lane_f32 ARM intrinsic", "vld3q_lane_p16 ARM intrinsic", "vld3q_lane_s16 ARM intrinsic", "vld3q_lane_s32 ARM intrinsic", "vld3q_lane_u16 ARM intrinsic", "vld3q_lane_u32 ARM intrinsic", "vld3q_p16 ARM intrinsic", "vld3q_p8 ARM intrinsic", "vld3q_s16 ARM intrinsic", "vld3q_s32 ARM intrinsic", "vld3q_s8 ARM intrinsic", "vld3q_u16 ARM intrinsic", "vld3q_u32 ARM intrinsic", "vld3q_u8 ARM intrinsic", "vld4_dup_f16 ARM intrinsic", "vld4_dup_f32 ARM intrinsic", "vld4_dup_p16 ARM intrinsic", "vld4_dup_p8 ARM intrinsic", "vld4_dup_s16 ARM intrinsic", "vld4_dup_s32 ARM intrinsic", "vld4_dup_s64 ARM intrinsic", "vld4_dup_s8 ARM intrinsic", "vld4_dup_u16 ARM intrinsic", "vld4_dup_u32 ARM intrinsic", "vld4_dup_u64 ARM intrinsic", "vld4_dup_u8 ARM intrinsic", "vld4_f16 ARM intrinsic", "vld4_f32 ARM intrinsic", "vld4_lane_f16 ARM intrinsic", "vld4_lane_f32 ARM intrinsic", "vld4_lane_p16 ARM intrinsic", "vld4_lane_p8 ARM intrinsic", "vld4_lane_s16 ARM intrinsic", "vld4_lane_s32 ARM intrinsic", "vld4_lane_s8 ARM intrinsic", "vld4_lane_u16 ARM intrinsic", "vld4_lane_u32 ARM intrinsic", "vld4_lane_u8 ARM intrinsic", "vld4_p16 ARM intrinsic", "vld4_p8 ARM intrinsic", "vld4_s16 ARM intrinsic", "vld4_s32 ARM intrinsic", "vld4_s64 ARM intrinsic", "vld4_s8 ARM intrinsic", "vld4_u16 ARM intrinsic", "vld4_u32 ARM intrinsic", "vld4_u64 ARM intrinsic", "vld4_u8 ARM intrinsic", "vld4q_f16 ARM intrinsic", "vld4q_f32 ARM intrinsic", "vld4q_lane_f16 ARM intrinsic", "vld4q_lane_f32 ARM intrinsic", "vld4q_lane_p16 ARM intrinsic", "vld4q_lane_s16 ARM intrinsic", "vld4q_lane_s32 ARM intrinsic", "vld4q_lane_u16 ARM intrinsic", "vld4q_lane_u32 ARM intrinsic", "vld4q_p16 ARM intrinsic", "vld4q_p8 ARM intrinsic", "vld4q_s16 ARM intrinsic", "vld4q_s32 ARM intrinsic", "vld4q_s8 ARM intrinsic", "vld4q_u16 ARM intrinsic", "vld4q_u32 ARM intrinsic", "vld4q_u8 ARM intrinsic", "vmax_f32 ARM intrinsic", "vmax_s16 ARM intrinsic", "vmax_s32 ARM intrinsic", "vmax_s8 ARM intrinsic", "vmax_u16 ARM intrinsic", "vmax_u32 ARM intrinsic", "vmax_u8 ARM intrinsic", "vmaxq_f32 ARM intrinsic", "vmaxq_s16 ARM intrinsic", "vmaxq_s32 ARM intrinsic", "vmaxq_s8 ARM intrinsic", "vmaxq_u16 ARM intrinsic", "vmaxq_u32 ARM intrinsic", "vmaxq_u8 ARM intrinsic", "vmin_f32 ARM intrinsic", "vmin_s16 ARM intrinsic", "vmin_s32 ARM intrinsic", "vmin_s8 ARM intrinsic", "vmin_u16 ARM intrinsic", "vmin_u32 ARM intrinsic", "vmin_u8 ARM intrinsic", "vminq_f32 ARM intrinsic", "vminq_s16 ARM intrinsic", "vminq_s32 ARM intrinsic", "vminq_s8 ARM intrinsic", "vminq_u16 ARM intrinsic", "vminq_u32 ARM intrinsic", "vminq_u8 ARM intrinsic", "vmla_f32 ARM intrinsic", "vmla_lane_f32 ARM intrinsic", "vmla_lane_s16 ARM intrinsic", "vmla_lane_s32 ARM intrinsic", "vmla_lane_u16 ARM intrinsic", "vmla_lane_u32 ARM intrinsic", "vmla_n_f32 ARM intrinsic", "vmla_n_s16 ARM intrinsic", "vmla_n_s32 ARM intrinsic", "vmla_n_u16 ARM intrinsic", "vmla_n_u32 ARM intrinsic", "vmla_s16 ARM intrinsic", "vmla_s32 ARM intrinsic", "vmla_s8 ARM intrinsic", "vmla_u16 ARM intrinsic", "vmla_u32 ARM intrinsic", "vmla_u8 ARM intrinsic", "vmlal_lane_s16 ARM intrinsic", "vmlal_lane_s32 ARM intrinsic", "vmlal_lane_u16 ARM intrinsic", "vmlal_lane_u32 ARM intrinsic", "vmlal_n_s16 ARM intrinsic", "vmlal_n_s32 ARM intrinsic", "vmlal_n_u16 ARM intrinsic", "vmlal_n_u32 ARM intrinsic", "vmlal_s16 ARM intrinsic", "vmlal_s32 ARM intrinsic", "vmlal_s8 ARM intrinsic", "vmlal_u16 ARM intrinsic", "vmlal_u32 ARM intrinsic", "vmlal_u8 ARM intrinsic", "vmlaq_f32 ARM intrinsic", "vmlaq_lane_f32 ARM intrinsic", "vmlaq_lane_s16 ARM intrinsic", "vmlaq_lane_s32 ARM intrinsic", "vmlaq_lane_u16 ARM intrinsic", "vmlaq_lane_u32 ARM intrinsic", "vmlaq_n_f32 ARM intrinsic", "vmlaq_n_s16 ARM intrinsic", "vmlaq_n_s32 ARM intrinsic", "vmlaq_n_u16 ARM intrinsic", "vmlaq_n_u32 ARM intrinsic", "vmlaq_s16 ARM intrinsic", "vmlaq_s32 ARM intrinsic", "vmlaq_s8 ARM intrinsic", "vmlaq_u16 ARM intrinsic", "vmlaq_u32 ARM intrinsic", "vmlaq_u8 ARM intrinsic", "vmls_f32 ARM intrinsic", "vmls_lane_f32 ARM intrinsic", "vmls_lane_s16 ARM intrinsic", "vmls_lane_s32 ARM intrinsic", "vmls_lane_u16 ARM intrinsic", "vmls_lane_u32 ARM intrinsic", "vmls_n_f32 ARM intrinsic", "vmls_n_s16 ARM intrinsic", "vmls_n_s32 ARM intrinsic", "vmls_n_u16 ARM intrinsic", "vmls_n_u32 ARM intrinsic", "vmls_s16 ARM intrinsic", "vmls_s32 ARM intrinsic", "vmls_s8 ARM intrinsic", "vmls_u16 ARM intrinsic", "vmls_u32 ARM intrinsic", "vmls_u8 ARM intrinsic", "vmlsl_lane_s16 ARM intrinsic", "vmlsl_lane_s32 ARM intrinsic", "vmlsl_lane_u16 ARM intrinsic", "vmlsl_lane_u32 ARM intrinsic", "vmlsl_n_s16 ARM intrinsic", "vmlsl_n_s32 ARM intrinsic", "vmlsl_n_u16 ARM intrinsic", "vmlsl_n_u32 ARM intrinsic", "vmlsl_s16 ARM intrinsic", "vmlsl_s32 ARM intrinsic", "vmlsl_s8 ARM intrinsic", "vmlsl_u16 ARM intrinsic", "vmlsl_u32 ARM intrinsic", "vmlsl_u8 ARM intrinsic", "vmlsq_lane_f32 ARM intrinsic", "vmlsq_lane_s16 ARM intrinsic", "vmlsq_lane_s32 ARM intrinsic", "vmlsq_lane_u16 ARM intrinsic", "vmlsq_lane_u32 ARM intrinsic", "vmlsq_n_f32 ARM intrinsic", "vmlsq_n_s16 ARM intrinsic", "vmlsq_n_s32 ARM intrinsic", "vmlsq_n_u16 ARM intrinsic", "vmlsq_n_u32 ARM intrinsic", "vmlsq_s16 ARM intrinsic", "vmlsq_s32 ARM intrinsic", "vmlsq_s8 ARM intrinsic", "vmov_n_f32 ARM intrinsic", "vmov_n_p16 ARM intrinsic", "vmov_n_p8 ARM intrinsic", "vmov_n_s16 ARM intrinsic", "vmov_n_s32 ARM intrinsic", "vmov_n_s64 ARM intrinsic", "vmov_n_s8 ARM intrinsic", "vmov_n_u16 ARM intrinsic", "vmov_n_u32 ARM intrinsic", "vmov_n_u64 ARM intrinsic", "vmov_n_u8 ARM intrinsic", "vmovl_s16 ARM intrinsic", "vmovl_s32 ARM intrinsic", "vmovl_s8 ARM intrinsic", "vmovl_u16 ARM intrinsic", "vmovl_u32 ARM intrinsic", "vmovl_u8 ARM intrinsic", "vmovn_s16 ARM intrinsic", "vmovn_s32 ARM intrinsic", "vmovn_s64 ARM intrinsic", "vmovn_u16 ARM intrinsic", "vmovn_u32 ARM intrinsic", "vmovn_u64 ARM intrinsic", "vmovq_n_f32 ARM intrinsic", "vmovq_n_p16 ARM intrinsic", "vmovq_n_p8 ARM intrinsic", "vmovq_n_s16 ARM intrinsic", "vmovq_n_s32 ARM intrinsic", "vmovq_n_s64 ARM intrinsic", "vmovq_n_s8 ARM intrinsic", "vmovq_n_u16 ARM intrinsic", "vmovq_n_u32 ARM intrinsic", "vmovq_n_u64 ARM intrinsic", "vmovq_n_u8 ARM intrinsic", "vmul_f32 ARM intrinsic", "vmul_n_f32 ARM intrinsic", "vmul_n_s16 ARM intrinsic", "vmul_n_s32 ARM intrinsic", "vmul_n_u16 ARM intrinsic", "vmul_n_u32 ARM intrinsic", "vmul_p8 ARM intrinsic", "vmul_s16 ARM intrinsic", "vmul_s32 ARM intrinsic", "vmul_s8 ARM intrinsic", "vmul_u16 ARM intrinsic", "vmul_u32 ARM intrinsic", "vmul_u8 ARM intrinsic", "vmull_lane_s16 ARM intrinsic", "vmull_lane_s32 ARM intrinsic", "vmull_lane_u16 ARM intrinsic", "vmull_lane_u32 ARM intrinsic", "vmull_n_s16 ARM intrinsic", "vmull_n_s32 ARM intrinsic", "vmull_n_u16 ARM intrinsic", "vmull_n_u32 ARM intrinsic", "vmull_p8 ARM intrinsic", "vmull_s16 ARM intrinsic", "vmull_s32 ARM intrinsic", "vmull_s8 ARM intrinsic", "vmull_u16 ARM intrinsic", "vmull_u32 ARM intrinsic", "vmull_u8 ARM intrinsic", "vmulq_f32 ARM intrinsic", "vmulq_n_f32 ARM intrinsic", "vmulq_n_s16 ARM intrinsic", "vmulq_n_s32 ARM intrinsic", "vmulq_n_u16 ARM intrinsic", "vmulq_n_u32 ARM intrinsic", "vmulq_p8 ARM intrinsic", "vmulq_s16 ARM intrinsic", "vmulq_s32 ARM intrinsic", "vmulq_s8 ARM intrinsic", "vmulq_u16 ARM intrinsic", "vmulq_u32 ARM intrinsic", "vmulq_u8 ARM intrinsic", "vmvn_p8 ARM intrinsic", "vmvn_s16 ARM intrinsic", "vmvn_s32 ARM intrinsic", "vmvn_s8 ARM intrinsic", "vmvn_u16 ARM intrinsic", "vmvn_u32 ARM intrinsic", "vmvn_u8 ARM intrinsic", "vmvnq_p8 ARM intrinsic", "vmvnq_s16 ARM intrinsic", "vmvnq_s32 ARM intrinsic", "vmvnq_s8 ARM intrinsic", "vmvnq_u16 ARM intrinsic", "vmvnq_u32 ARM intrinsic", "vmvnq_u8 ARM intrinsic", "vneg_f32 ARM intrinsic", "vneg_s16 ARM intrinsic", "vneg_s32 ARM intrinsic", "vneg_s8 ARM intrinsic", "vnegq_f32 ARM intrinsic", "vnegq_s16 ARM intrinsic", "vnegq_s32 ARM intrinsic", "vnegq_s8 ARM intrinsic", "vorn_s16 ARM intrinsic", "vorn_s32 ARM intrinsic", "vorn_s64 ARM intrinsic", "vorn_s8 ARM intrinsic", "vorn_u16 ARM intrinsic", "vorn_u32 ARM intrinsic", "vorn_u64 ARM intrinsic", "vorn_u8 ARM intrinsic", "vornq_s16 ARM intrinsic", "vornq_s32 ARM intrinsic", "vornq_s64 ARM intrinsic", "vornq_s8 ARM intrinsic", "vornq_u16 ARM intrinsic", "vornq_u32 ARM intrinsic", "vornq_u64 ARM intrinsic", "vornq_u8 ARM intrinsic", "vorr_s16 ARM intrinsic", "vorr_s32 ARM intrinsic", "vorr_s64 ARM intrinsic", "vorr_s8 ARM intrinsic", "vorr_u16 ARM intrinsic", "vorr_u32 ARM intrinsic", "vorr_u64 ARM intrinsic", "vorr_u8 ARM intrinsic", "vorrq_s16 ARM intrinsic", "vorrq_s32 ARM intrinsic", "vorrq_s64 ARM intrinsic", "vorrq_s8 ARM intrinsic", "vorrq_u16 ARM intrinsic", "vorrq_u32 ARM intrinsic", "vorrq_u64 ARM intrinsic", "vorrq_u8 ARM intrinsic", "vpadal_s16 ARM intrinsic", "vpadal_s32 ARM intrinsic", "vpadal_s8 ARM intrinsic", "vpadal_u16 ARM intrinsic", "vpadal_u32 ARM intrinsic", "vpadal_u8 ARM intrinsic", "vpadalq_s16 ARM intrinsic", "vpadalq_s32 ARM intrinsic", "vpadalq_s8 ARM intrinsic", "vpadalq_u16 ARM intrinsic", "vpadalq_u32 ARM intrinsic", "vpadalq_u8 ARM intrinsic", "vpadd_f32 ARM intrinsic", "vpadd_s16 ARM intrinsic", "vpadd_s32 ARM intrinsic", "vpadd_s8 ARM intrinsic", "vpadd_u16 ARM intrinsic", "vpadd_u32 ARM intrinsic", "vpadd_u8 ARM intrinsic", "vpaddl_s16 ARM intrinsic", "vpaddl_s32 ARM intrinsic", "vpaddl_s8 ARM intrinsic", "vpaddl_u16 ARM intrinsic", "vpaddl_u32 ARM intrinsic", "vpaddl_u8 ARM intrinsic", "vpaddlq_s16 ARM intrinsic", "vpaddlq_s32 ARM intrinsic", "vpaddlq_s8 ARM intrinsic", "vpaddlq_u16 ARM intrinsic", "vpaddlq_u32 ARM intrinsic", "vpaddlq_u8 ARM intrinsic", "vpmax_f32 ARM intrinsic", "vpmax_s16 ARM intrinsic", "vpmax_s32 ARM intrinsic", "vpmax_s8 ARM intrinsic", "vpmax_u16 ARM intrinsic", "vpmax_u32 ARM intrinsic", "vpmax_u8 ARM intrinsic", "vpmin_f32 ARM intrinsic", "vpmin_s16 ARM intrinsic", "vpmin_s32 ARM intrinsic", "vpmin_s8 ARM intrinsic", "vpmin_u16 ARM intrinsic", "vpmin_u32 ARM intrinsic", "vpmin_u8 ARM intrinsic", "vqabs_s16 ARM intrinsic", "vqabs_s32 ARM intrinsic", "vqabs_s8 ARM intrinsic", "vqabsq_s16 ARM intrinsic", "vqabsq_s32 ARM intrinsic", "vqabsq_s8 ARM intrinsic", "vqadd_s16 ARM intrinsic", "vqadd_s32 ARM intrinsic", "vqadd_s64 ARM intrinsic", "vqadd_s8 ARM intrinsic", "vqadd_u16 ARM intrinsic", "vqadd_u32 ARM intrinsic", "vqadd_u64 ARM intrinsic", "vqadd_u8 ARM intrinsic", "vqaddq_s16 ARM intrinsic", "vqaddq_s32 ARM intrinsic", "vqaddq_s64 ARM intrinsic", "vqaddq_s8 ARM intrinsic", "vqaddq_u16 ARM intrinsic", "vqaddq_u32 ARM intrinsic", "vqaddq_u64 ARM intrinsic", "vqaddq_u8 ARM intrinsic", "vqdmlal_lane_s16 ARM intrinsic", "vqdmlal_lane_s32 ARM intrinsic", "vqdmlal_n_s16 ARM intrinsic", "vqdmlal_n_s32 ARM intrinsic", "vqdmlal_s16 ARM intrinsic", "vqdmlal_s32 ARM intrinsic", "vqdmlsl_lane_s16 ARM intrinsic", "vqdmlsl_lane_s32 ARM intrinsic", "vqdmlsl_n_s16 ARM intrinsic", "vqdmlsl_n_s32 ARM intrinsic", "vqdmlsl_s16 ARM intrinsic", "vqdmlsl_s32 ARM intrinsic", "vqdmulh_lane_s16 ARM intrinsic", "vqdmulh_lane_s32 ARM intrinsic", "vqdmulh_n_s16 ARM intrinsic", "vqdmulh_n_s32 ARM intrinsic", "vqdmulh_s16 ARM intrinsic", "vqdmulh_s32 ARM intrinsic", "vqdmulhq_lane_s16 ARM intrinsic", "vqdmulhq_lane_s32 ARM intrinsic", "vqdmulhq_n_s16 ARM intrinsic", "vqdmulhq_n_s32 ARM intrinsic", "vqdmulhq_s16 ARM intrinsic", "vqdmulhq_s32 ARM intrinsic", "vqdmull_lane_s16 ARM intrinsic", "vqdmull_lane_s32 ARM intrinsic", "vqdmull_n_s16 ARM intrinsic", "vqdmull_n_s32 ARM intrinsic", "vqdmull_s16 ARM intrinsic", "vqdmull_s32 ARM intrinsic", "vqmovn_s16 ARM intrinsic", "vqmovn_s32 ARM intrinsic", "vqmovn_s64 ARM intrinsic", "vqmovn_u16 ARM intrinsic", "vqmovn_u32 ARM intrinsic", "vqmovn_u64 ARM intrinsic", "vqmovun_s16 ARM intrinsic", "vqmovun_s32 ARM intrinsic", "vqmovun_s64 ARM intrinsic", "vqneg_s16 ARM intrinsic", "vqneg_s32 ARM intrinsic", "vqneg_s8 ARM intrinsic", "vqnegq_s16 ARM intrinsic", "vqnegq_s32 ARM intrinsic", "vqnegq_s8 ARM intrinsic", "vqrdmulh_lane_s16 ARM intrinsic", "vqrdmulh_lane_s32 ARM intrinsic", "vqrdmulh_n_s16 ARM intrinsic", "vqrdmulh_n_s32 ARM intrinsic", "vqrdmulh_s16 ARM intrinsic", "vqrdmulh_s32 ARM intrinsic", "vqrdmulhq_lane_s16 ARM intrinsic", "vqrdmulhq_lane_s32 ARM intrinsic", "vqrdmulhq_n_s16 ARM intrinsic", "vqrdmulhq_n_s32 ARM intrinsic", "vqrdmulhq_s16 ARM intrinsic", "vqrdmulhq_s32 ARM intrinsic", "vqrshl_s16 ARM intrinsic", "vqrshl_s32 ARM intrinsic", "vqrshl_s64 ARM intrinsic", "vqrshl_s8 ARM intrinsic", "vqrshl_u16 ARM intrinsic", "vqrshl_u32 ARM intrinsic", "vqrshl_u64 ARM intrinsic", "vqrshl_u8 ARM intrinsic", "vqrshlq_s16 ARM intrinsic", "vqrshlq_s32 ARM intrinsic", "vqrshlq_s64 ARM intrinsic", "vqrshlq_s8 ARM intrinsic", "vqrshlq_u16 ARM intrinsic", "vqrshlq_u32 ARM intrinsic", "vqrshlq_u64 ARM intrinsic", "vqrshlq_u8 ARM intrinsic", "vqrshrn_n_s16 ARM intrinsic", "vqrshrn_n_s32 ARM intrinsic", "vqrshrn_n_s64 ARM intrinsic", "vqrshrn_n_u16 ARM intrinsic", "vqrshrn_n_u32 ARM intrinsic", "vqrshrn_n_u64 ARM intrinsic", "vqrshrun_n_s16 ARM intrinsic", "vqrshrun_n_s32 ARM intrinsic", "vqrshrun_n_s64 ARM intrinsic", "vqshl_n_s16 ARM intrinsic", "vqshl_n_s32 ARM intrinsic", "vqshl_n_s64 ARM intrinsic", "vqshl_n_s8 ARM intrinsic", "vqshl_n_u16 ARM intrinsic", "vqshl_n_u32 ARM intrinsic", "vqshl_n_u64 ARM intrinsic", "vqshl_n_u8 ARM intrinsic", "vqshl_s16 ARM intrinsic", "vqshl_s32 ARM intrinsic", "vqshl_s64 ARM intrinsic", "vqshl_s8 ARM intrinsic", "vqshl_u16 ARM intrinsic", "vqshl_u32 ARM intrinsic", "vqshl_u64 ARM intrinsic", "vqshl_u8 ARM intrinsic", "vqshlq_n_s16 ARM intrinsic", "vqshlq_n_s32 ARM intrinsic", "vqshlq_n_s64 ARM intrinsic", "vqshlq_n_s8 ARM intrinsic", "vqshlq_n_u16 ARM intrinsic", "vqshlq_n_u32 ARM intrinsic", "vqshlq_n_u64 ARM intrinsic", "vqshlq_n_u8 ARM intrinsic", "vqshlq_s16 ARM intrinsic", "vqshlq_s32 ARM intrinsic", "vqshlq_s64 ARM intrinsic", "vqshlq_s8 ARM intrinsic", "vqshlq_u16 ARM intrinsic", "vqshlq_u32 ARM intrinsic", "vqshlq_u64 ARM intrinsic", "vqshlq_u8 ARM intrinsic", "vqshlu_n_s16 ARM intrinsic", "vqshlu_n_s32 ARM intrinsic", "vqshlu_n_s64 ARM intrinsic", "vqshlu_n_s8 ARM intrinsic", "vqshluq_n_s16 ARM intrinsic", "vqshluq_n_s32 ARM intrinsic", "vqshluq_n_s64 ARM intrinsic", "vqshluq_n_s8 ARM intrinsic", "vqshrn_n_s16 ARM intrinsic", "vqshrn_n_s32 ARM intrinsic", "vqshrn_n_s64 ARM intrinsic", "vqshrn_n_u16 ARM intrinsic", "vqshrn_n_u32 ARM intrinsic", "vqshrn_n_u64 ARM intrinsic", "vqshrun_n_s16 ARM intrinsic", "vqshrun_n_s32 ARM intrinsic", "vqshrun_n_s64 ARM intrinsic", "vqsub_s16 ARM intrinsic", "vqsub_s32 ARM intrinsic", "vqsub_s64 ARM intrinsic", "vqsub_s8 ARM intrinsic", "vqsub_u16 ARM intrinsic", "vqsub_u32 ARM intrinsic", "vqsub_u64 ARM intrinsic", "vqsub_u8 ARM intrinsic", "vqsubq_s16 ARM intrinsic", "vqsubq_s32 ARM intrinsic", "vqsubq_s64 ARM intrinsic", "vqsubq_s8 ARM intrinsic", "vqsubq_u16 ARM intrinsic", "vqsubq_u32 ARM intrinsic", "vqsubq_u64 ARM intrinsic", "vqsubq_u8 ARM intrinsic", "vraddhn_s16 ARM intrinsic", "vraddhn_s32 ARM intrinsic", "vraddhn_s64 ARM intrinsic", "vraddhn_u16 ARM intrinsic", "vraddhn_u32 ARM intrinsic", "vraddhn_u64 ARM intrinsic", "vrecpe_f32 ARM intrinsic", "vrecpe_u32 ARM intrinsic", "vrecpeq_f32 ARM intrinsic", "vrecpeq_u32 ARM intrinsic", "vrecps_f32 ARM intrinsic", "vrecpsq_f32 ARM intrinsic", "vrev16_p8 ARM intrinsic", "vrev16_s8 ARM intrinsic", "vrev16_u8 ARM intrinsic", "vrev16q_p8 ARM intrinsic", "vrev16q_s8 ARM intrinsic", "vrev16q_u8 ARM intrinsic", "vrev32_p8 ARM intrinsic", "vrev32_s16 ARM intrinsic", "vrev32_s8 ARM intrinsic", "vrev32_u16 ARM intrinsic", "vrev32_u8 ARM intrinsic", "vrev32q_p8 ARM intrinsic", "vrev32q_s16 ARM intrinsic", "vrev32q_s8 ARM intrinsic", "vrev32q_u16 ARM intrinsic", "vrev32q_u8 ARM intrinsic", "vrev64_f32 ARM intrinsic", "vrev64_p16 ARM intrinsic", "vrev64_p8 ARM intrinsic", "vrev64_s16 ARM intrinsic", "vrev64_s32 ARM intrinsic", "vrev64_s8 ARM intrinsic", "vrev64_u16 ARM intrinsic", "vrev64_u32 ARM intrinsic", "vrev64_u8 ARM intrinsic", "vrev64q_f32 ARM intrinsic", "vrev64q_p16 ARM intrinsic", "vrev64q_p8 ARM intrinsic", "vrev64q_s16 ARM intrinsic", "vrev64q_s32 ARM intrinsic", "vrev64q_s8 ARM intrinsic", "vrev64q_u16 ARM intrinsic", "vrev64q_u32 ARM intrinsic", "vrev64q_u8 ARM intrinsic", "vrhadd_s16 ARM intrinsic", "vrhadd_s32 ARM intrinsic", "vrhadd_s8 ARM intrinsic", "vrhadd_u16 ARM intrinsic", "vrhadd_u32 ARM intrinsic", "vrhadd_u8 ARM intrinsic", "vrhaddq_s16 ARM intrinsic", "vrhaddq_s32 ARM intrinsic", "vrhaddq_s8 ARM intrinsic", "vrhaddq_u16 ARM intrinsic", "vrhaddq_u32 ARM intrinsic", "vrhaddq_u8 ARM intrinsic", "vrshl_s16 ARM intrinsic", "vrshl_s32 ARM intrinsic", "vrshl_s64 ARM intrinsic", "vrshl_s8 ARM intrinsic", "vrshl_u16 ARM intrinsic", "vrshl_u32 ARM intrinsic", "vrshl_u64 ARM intrinsic", "vrshl_u8 ARM intrinsic", "vrshlq_s16 ARM intrinsic", "vrshlq_s32 ARM intrinsic", "vrshlq_s64 ARM intrinsic", "vrshlq_s8 ARM intrinsic", "vrshlq_u16 ARM intrinsic", "vrshlq_u32 ARM intrinsic", "vrshlq_u64 ARM intrinsic", "vrshlq_u8 ARM intrinsic", "vrshr_n_s16 ARM intrinsic", "vrshr_n_s32 ARM intrinsic", "vrshr_n_s64 ARM intrinsic", "vrshr_n_s8 ARM intrinsic", "vrshr_n_u16 ARM intrinsic", "vrshr_n_u32 ARM intrinsic", "vrshr_n_u64 ARM intrinsic", "vrshr_n_u8 ARM intrinsic", "vrshrn_n_s16 ARM intrinsic", "vrshrn_n_s32 ARM intrinsic", "vrshrn_n_s64 ARM intrinsic", "vrshrn_n_u16 ARM intrinsic", "vrshrn_n_u32 ARM intrinsic", "vrshrn_n_u64 ARM intrinsic", "vrshrq_n_s16 ARM intrinsic", "vrshrq_n_s32 ARM intrinsic", "vrshrq_n_s64 ARM intrinsic", "vrshrq_n_s8 ARM intrinsic", "vrshrq_n_u16 ARM intrinsic", "vrshrq_n_u32 ARM intrinsic", "vrshrq_n_u64 ARM intrinsic", "vrshrq_n_u8 ARM intrinsic", "vrsqrte_f32 ARM intrinsic", "vrsqrte_u32 ARM intrinsic", "vrsqrteq_f32 ARM intrinsic", "vrsqrteq_u32 ARM intrinsic", "vrsqrts_f32 ARM intrinsic", "vrsqrtsq_f32 ARM intrinsic", "vrsra_n_s16 ARM intrinsic", "vrsra_n_s32 ARM intrinsic", "vrsra_n_s64 ARM intrinsic", "vrsra_n_s8 ARM intrinsic", "vrsra_n_u16 ARM intrinsic", "vrsra_n_u32 ARM intrinsic", "vrsra_n_u64 ARM intrinsic", "vrsra_n_u8 ARM intrinsic", "vrsraq_n_s16 ARM intrinsic", "vrsraq_n_s32 ARM intrinsic", "vrsraq_n_s64 ARM intrinsic", "vrsraq_n_s8 ARM intrinsic", "vrsraq_n_u16 ARM intrinsic", "vrsraq_n_u32 ARM intrinsic", "vrsraq_n_u64 ARM intrinsic", "vrsraq_n_u8 ARM intrinsic", "vrsubhn_s16 ARM intrinsic", "vrsubhn_s32 ARM intrinsic", "vrsubhn_s64 ARM intrinsic", "vrsubhn_u16 ARM intrinsic", "vrsubhn_u32 ARM intrinsic", "vrsubhn_u64 ARM intrinsic", "vset_lane_f32 ARM intrinsic", "vset_lane_p16 ARM intrinsic", "vset_lane_p8 ARM intrinsic", "vset_lane_s16 ARM intrinsic", "vset_lane_s32 ARM intrinsic", "vset_lane_s64 ARM intrinsic", "vset_lane_s8 ARM intrinsic", "vset_lane_u16 ARM intrinsic", "vset_lane_u32 ARM intrinsic", "vset_lane_u64 ARM intrinsic", "vset_lane_u8 ARM intrinsic", "vsetq_lane_f32 ARM intrinsic", "vsetq_lane_p16 ARM intrinsic", "vsetq_lane_p8 ARM intrinsic", "vsetq_lane_s16 ARM intrinsic", "vsetq_lane_s32 ARM intrinsic", "vsetq_lane_s64 ARM intrinsic", "vsetq_lane_s8 ARM intrinsic", "vsetq_lane_u16 ARM intrinsic", "vsetq_lane_u32 ARM intrinsic", "vsetq_lane_u64 ARM intrinsic", "vsetq_lane_u8 ARM intrinsic", "vshl_n_s16 ARM intrinsic", "vshl_n_s32 ARM intrinsic", "vshl_n_s64 ARM intrinsic", "vshl_n_s8 ARM intrinsic", "vshl_n_u16 ARM intrinsic", "vshl_n_u32 ARM intrinsic", "vshl_n_u64 ARM intrinsic", "vshl_n_u8 ARM intrinsic", "vshl_s16 ARM intrinsic", "vshl_s32 ARM intrinsic", "vshl_s64 ARM intrinsic", "vshl_s8 ARM intrinsic", "vshl_u16 ARM intrinsic", "vshl_u32 ARM intrinsic", "vshl_u64 ARM intrinsic", "vshl_u8 ARM intrinsic", "vshll_n_s16 ARM intrinsic", "vshll_n_s32 ARM intrinsic", "vshll_n_s8 ARM intrinsic", "vshll_n_u16 ARM intrinsic", "vshll_n_u32 ARM intrinsic", "vshll_n_u8 ARM intrinsic", "vshlq_n_s16 ARM intrinsic", "vshlq_n_s32 ARM intrinsic", "vshlq_n_s64 ARM intrinsic", "vshlq_n_s8 ARM intrinsic", "vshlq_n_u16 ARM intrinsic", "vshlq_n_u32 ARM intrinsic", "vshlq_n_u64 ARM intrinsic", "vshlq_n_u8 ARM intrinsic", "vshlq_s16 ARM intrinsic", "vshlq_s32 ARM intrinsic", "vshlq_s64 ARM intrinsic", "vshlq_s8 ARM intrinsic", "vshlq_u16 ARM intrinsic", "vshlq_u32 ARM intrinsic", "vshlq_u64 ARM intrinsic", "vshlq_u8 ARM intrinsic", "vshr_n_s16 ARM intrinsic", "vshr_n_s32 ARM intrinsic", "vshr_n_s64 ARM intrinsic", "vshr_n_s8 ARM intrinsic", "vshr_n_u16 ARM intrinsic", "vshr_n_u32 ARM intrinsic", "vshr_n_u64 ARM intrinsic", "vshr_n_u8 ARM intrinsic", "vshrn_n_s16 ARM intrinsic", "vshrn_n_s32 ARM intrinsic", "vshrn_n_s64 ARM intrinsic", "vshrn_n_u16 ARM intrinsic", "vshrn_n_u32 ARM intrinsic", "vshrn_n_u64 ARM intrinsic", "vshrq_n_s16 ARM intrinsic", "vshrq_n_s32 ARM intrinsic", "vshrq_n_s64 ARM intrinsic", "vshrq_n_s8 ARM intrinsic", "vshrq_n_u16 ARM intrinsic", "vshrq_n_u32 ARM intrinsic", "vshrq_n_u64 ARM intrinsic", "vshrq_n_u8 ARM intrinsic", "vsli_n_p16 ARM intrinsic", "vsli_n_p8 ARM intrinsic", "vsli_n_s16 ARM intrinsic", "vsli_n_s32 ARM intrinsic", "vsli_n_s64 ARM intrinsic", "vsli_n_s8 ARM intrinsic", "vsli_n_u16 ARM intrinsic", "vsli_n_u32 ARM intrinsic", "vsli_n_u64 ARM intrinsic", "vsli_n_u8 ARM intrinsic", "vsliq_n_p16 ARM intrinsic", "vsliq_n_p8 ARM intrinsic", "vsliq_n_s16 ARM intrinsic", "vsliq_n_s32 ARM intrinsic", "vsliq_n_s64 ARM intrinsic", "vsliq_n_s8 ARM intrinsic", "vsliq_n_u16 ARM intrinsic", "vsliq_n_u32 ARM intrinsic", "vsliq_n_u64 ARM intrinsic", "vsliq_n_u8 ARM intrinsic", "vsra_n_s16 ARM intrinsic", "vsra_n_s32 ARM intrinsic", "vsra_n_s64 ARM intrinsic", "vsra_n_s8 ARM intrinsic", "vsra_n_u16 ARM intrinsic", "vsra_n_u32 ARM intrinsic", "vsra_n_u64 ARM intrinsic", "vsra_n_u8 ARM intrinsic", "vsraq_n_s16 ARM intrinsic", "vsraq_n_s32 ARM intrinsic", "vsraq_n_s64 ARM intrinsic", "vsraq_n_s8 ARM intrinsic", "vsraq_n_u16 ARM intrinsic", "vsraq_n_u32 ARM intrinsic", "vsraq_n_u64 ARM intrinsic", "vsraq_n_u8 ARM intrinsic", "vsri_n_p16 ARM intrinsic", "vsri_n_p8 ARM intrinsic", "vsri_n_s16 ARM intrinsic", "vsri_n_s32 ARM intrinsic", "vsri_n_s64 ARM intrinsic", "vsri_n_s8 ARM intrinsic", "vsri_n_u16 ARM intrinsic", "vsri_n_u32 ARM intrinsic", "vsri_n_u64 ARM intrinsic", "vsri_n_u8 ARM intrinsic", "vsriq_n_p16 ARM intrinsic", "vsriq_n_p8 ARM intrinsic", "vsriq_n_s16 ARM intrinsic", "vsriq_n_s32 ARM intrinsic", "vsriq_n_s64 ARM intrinsic", "vsriq_n_s8 ARM intrinsic", "vsriq_n_u16 ARM intrinsic", "vsriq_n_u32 ARM intrinsic", "vsriq_n_u64 ARM intrinsic", "vsriq_n_u8 ARM intrinsic", "vst1_f16 ARM intrinsic", "vst1_f32 ARM intrinsic", "vst1_lane_f16 ARM intrinsic", "vst1_lane_f32 ARM intrinsic", "vst1_lane_p16 ARM intrinsic", "vst1_lane_p8 ARM intrinsic", "vst1_lane_s16 ARM intrinsic", "vst1_lane_s32 ARM intrinsic", "vst1_lane_s64 ARM intrinsic", "vst1_lane_s8 ARM intrinsic", "vst1_lane_u16 ARM intrinsic", "vst1_lane_u32 ARM intrinsic", "vst1_lane_u64 ARM intrinsic", "vst1_lane_u8 ARM intrinsic", "vst1_p16 ARM intrinsic", "vst1_p8 ARM intrinsic", "vst1_s16 ARM intrinsic", "vst1_s32 ARM intrinsic", "vst1_s64 ARM intrinsic", "vst1_s8 ARM intrinsic", "vst1_u16 ARM intrinsic", "vst1_u32 ARM intrinsic", "vst1_u64 ARM intrinsic", "vst1_u8 ARM intrinsic", "vst1q_f16 ARM intrinsic", "vst1q_f32 ARM intrinsic", "vst1q_lane_f16 ARM intrinsic", "vst1q_lane_f32 ARM intrinsic", "vst1q_lane_p16 ARM intrinsic", "vst1q_lane_p8 ARM intrinsic", "vst1q_lane_s16 ARM intrinsic", "vst1q_lane_s32 ARM intrinsic", "vst1q_lane_s64 ARM intrinsic", "vst1q_lane_s8 ARM intrinsic", "vst1q_lane_u16 ARM intrinsic", "vst1q_lane_u32 ARM intrinsic", "vst1q_lane_u64 ARM intrinsic", "vst1q_lane_u8 ARM intrinsic", "vst1q_p16 ARM intrinsic", "vst1q_p8 ARM intrinsic", "vst1q_s16 ARM intrinsic", "vst1q_s32 ARM intrinsic", "vst1q_s64 ARM intrinsic", "vst1q_s8 ARM intrinsic", "vst1q_u16 ARM intrinsic", "vst1q_u32 ARM intrinsic", "vst1q_u64 ARM intrinsic", "vst1q_u8 ARM intrinsic", "vst2_f16 ARM intrinsic", "vst2_f32 ARM intrinsic", "vst2_lane_f16 ARM intrinsic", "vst2_lane_f32 ARM intrinsic", "vst2_lane_p16 ARM intrinsic", "vst2_lane_p8 ARM intrinsic", "vst2_lane_s16 ARM intrinsic", "vst2_lane_s32 ARM intrinsic", "vst2_lane_s8 ARM intrinsic", "vst2_lane_u16 ARM intrinsic", "vst2_lane_u32 ARM intrinsic", "vst2_lane_u8 ARM intrinsic", "vst2_p16 ARM intrinsic", "vst2_p8 ARM intrinsic", "vst2_s16 ARM intrinsic", "vst2_s32 ARM intrinsic", "vst2_s64 ARM intrinsic", "vst2_s8 ARM intrinsic", "vst2_u16 ARM intrinsic", "vst2_u32 ARM intrinsic", "vst2_u64 ARM intrinsic", "vst2_u8 ARM intrinsic", "vst2q_f16 ARM intrinsic", "vst2q_f32 ARM intrinsic", "vst2q_lane_f16 ARM intrinsic", "vst2q_lane_f32 ARM intrinsic", "vst2q_lane_p16 ARM intrinsic", "vst2q_lane_s16 ARM intrinsic", "vst2q_lane_s32 ARM intrinsic", "vst2q_lane_u16 ARM intrinsic", "vst2q_lane_u32 ARM intrinsic", "vst2q_p16 ARM intrinsic", "vst2q_p8 ARM intrinsic", "vst2q_s16 ARM intrinsic", "vst2q_s32 ARM intrinsic", "vst2q_s8 ARM intrinsic", "vst2q_u16 ARM intrinsic", "vst2q_u32 ARM intrinsic", "vst2q_u8 ARM intrinsic", "vst3_f16 ARM intrinsic", "vst3_f32 ARM intrinsic", "vst3_lane_f16 ARM intrinsic", "vst3_lane_f32 ARM intrinsic", "vst3_lane_p16 ARM intrinsic", "vst3_lane_p8 ARM intrinsic", "vst3_lane_s16 ARM intrinsic", "vst3_lane_s32 ARM intrinsic", "vst3_lane_s8 ARM intrinsic", "vst3_lane_u16 ARM intrinsic", "vst3_lane_u32 ARM intrinsic", "vst3_lane_u8 ARM intrinsic", "vst3_p16 ARM intrinsic", "vst3_p8 ARM intrinsic", "vst3_s16 ARM intrinsic", "vst3_s32 ARM intrinsic", "vst3_s64 ARM intrinsic", "vst3_s8 ARM intrinsic", "vst3_u16 ARM intrinsic", "vst3_u32 ARM intrinsic", "vst3_u64 ARM intrinsic", "vst3_u8 ARM intrinsic", "vst3q_f16 ARM intrinsic", "vst3q_f32 ARM intrinsic", "vst3q_lane_f16 ARM intrinsic", "vst3q_lane_f32 ARM intrinsic", "vst3q_lane_p16 ARM intrinsic", "vst3q_lane_s16 ARM intrinsic", "vst3q_lane_s32 ARM intrinsic", "vst3q_lane_u16 ARM intrinsic", "vst3q_lane_u32 ARM intrinsic", "vst3q_p16 ARM intrinsic", "vst3q_p8 ARM intrinsic", "vst3q_s16 ARM intrinsic", "vst3q_s32 ARM intrinsic", "vst3q_s8 ARM intrinsic", "vst3q_u16 ARM intrinsic", "vst3q_u32 ARM intrinsic", "vst3q_u8 ARM intrinsic", "vst4_f16 ARM intrinsic", "vst4_f32 ARM intrinsic", "vst4_lane_f16 ARM intrinsic", "vst4_lane_f32 ARM intrinsic", "vst4_lane_p16 ARM intrinsic", "vst4_lane_p8 ARM intrinsic", "vst4_lane_s16 ARM intrinsic", "vst4_lane_s32 ARM intrinsic", "vst4_lane_s8 ARM intrinsic", "vst4_lane_u16 ARM intrinsic", "vst4_lane_u32 ARM intrinsic", "vst4_lane_u8 ARM intrinsic", "vst4_p16 ARM intrinsic", "vst4_p8 ARM intrinsic", "vst4_s16 ARM intrinsic", "vst4_s32 ARM intrinsic", "vst4_s64 ARM intrinsic", "vst4_s8 ARM intrinsic", "vst4_u16 ARM intrinsic", "vst4_u32 ARM intrinsic", "vst4_u64 ARM intrinsic", "vst4_u8 ARM intrinsic", "vst4q_f16 ARM intrinsic", "vst4q_f32 ARM intrinsic", "vst4q_lane_f16 ARM intrinsic", "vst4q_lane_f32 ARM intrinsic", "vst4q_lane_p16 ARM intrinsic", "vst4q_lane_s16 ARM intrinsic", "vst4q_lane_s32 ARM intrinsic", "vst4q_lane_u16 ARM intrinsic", "vst4q_lane_u32 ARM intrinsic", "vst4q_p16 ARM intrinsic", "vst4q_p8 ARM intrinsic", "vst4q_s16 ARM intrinsic", "vst4q_s32 ARM intrinsic", "vst4q_s8 ARM intrinsic", "vst4q_u16 ARM intrinsic", "vst4q_u32 ARM intrinsic", "vst4q_u8 ARM intrinsic", "vsub_f32 ARM intrinsic", "vsub_s16 ARM intrinsic", "vsub_s32 ARM intrinsic", "vsub_s64 ARM intrinsic", "vsub_s8 ARM intrinsic", "vsub_u16 ARM intrinsic", "vsub_u32 ARM intrinsic", "vsub_u64 ARM intrinsic", "vsub_u8 ARM intrinsic", "vsubhn_s16 ARM intrinsic", "vsubhn_s32 ARM intrinsic", "vsubhn_s64 ARM intrinsic", "vsubhn_u16 ARM intrinsic", "vsubhn_u32 ARM intrinsic", "vsubhn_u64 ARM intrinsic", "vsubl_s16 ARM intrinsic", "vsubl_s32 ARM intrinsic", "vsubl_s8 ARM intrinsic", "vsubl_u16 ARM intrinsic", "vsubl_u32 ARM intrinsic", "vsubl_u8 ARM intrinsic", "vsubq_f32 ARM intrinsic", "vsubq_s16 ARM intrinsic", "vsubq_s32 ARM intrinsic", "vsubq_s64 ARM intrinsic", "vsubq_s8 ARM intrinsic", "vsubq_u16 ARM intrinsic", "vsubq_u32 ARM intrinsic", "vsubq_u64 ARM intrinsic", "vsubq_u8 ARM intrinsic", "vsubw_s16 ARM intrinsic", "vsubw_s32 ARM intrinsic", "vsubw_s8 ARM intrinsic", "vsubw_u16 ARM intrinsic", "vsubw_u32 ARM intrinsic", "vsubw_u8 ARM intrinsic", "vtbl1_p8 ARM intrinsic", "vtbl1_s8 ARM intrinsic", "vtbl1_u8 ARM intrinsic", "vtbl2_p8 ARM intrinsic", "vtbl2_s8 ARM intrinsic", "vtbl2_u8 ARM intrinsic", "vtbl3_p8 ARM intrinsic", "vtbl3_s8 ARM intrinsic", "vtbl3_u8 ARM intrinsic", "vtbl4_p8 ARM intrinsic", "vtbl4_s8 ARM intrinsic", "vtbl4_u8 ARM intrinsic", "vtbx1_p8 ARM intrinsic", "vtbx1_s8 ARM intrinsic", "vtbx1_u8 ARM intrinsic", "vtbx2_p8 ARM intrinsic", "vtbx2_s8 ARM intrinsic", "vtbx2_u8 ARM intrinsic", "vtbx3_p8 ARM intrinsic", "vtbx3_s8 ARM intrinsic", "vtbx3_u8 ARM intrinsic", "vtbx4_p8 ARM intrinsic", "vtbx4_s8 ARM intrinsic", "vtbx4_u8 ARM intrinsic", "vtrn_f32 ARM intrinsic", "vtrn_p16 ARM intrinsic", "vtrn_p8 ARM intrinsic", "vtrn_s16 ARM intrinsic", "vtrn_s32 ARM intrinsic", "vtrn_s8 ARM intrinsic", "vtrn_u16 ARM intrinsic", "vtrn_u32 ARM intrinsic", "vtrn_u8 ARM intrinsic", "vtrnq_f32 ARM intrinsic", "vtrnq_p16 ARM intrinsic", "vtrnq_p8 ARM intrinsic", "vtrnq_s16 ARM intrinsic", "vtrnq_s32 ARM intrinsic", "vtrnq_s8 ARM intrinsic", "vtrnq_u16 ARM intrinsic", "vtrnq_u32 ARM intrinsic", "vtrnq_u8 ARM intrinsic", "vtst_p8 ARM intrinsic", "vtst_s16 ARM intrinsic", "vtst_s32 ARM intrinsic", "vtst_s8 ARM intrinsic", "vtst_u16 ARM intrinsic", "vtst_u32 ARM intrinsic", "vtst_u8 ARM intrinsic", "vtstq_p8 ARM intrinsic", "vtstq_s16 ARM intrinsic", "vtstq_s32 ARM intrinsic", "vtstq_s8 ARM intrinsic", "vtstq_u16 ARM intrinsic", "vtstq_u32 ARM intrinsic", "vtstq_u8 ARM intrinsic", "vuzp_f32 ARM intrinsic", "vuzp_p16 ARM intrinsic", "vuzp_p8 ARM intrinsic", "vuzp_s16 ARM intrinsic", "vuzp_s32 ARM intrinsic", "vuzp_s8 ARM intrinsic", "vuzp_u16 ARM intrinsic", "vuzp_u32 ARM intrinsic", "vuzp_u8 ARM intrinsic", "vuzpq_f32 ARM intrinsic", "vuzpq_p16 ARM intrinsic", "vuzpq_p8 ARM intrinsic", "vuzpq_s16 ARM intrinsic", "vuzpq_s32 ARM intrinsic", "vuzpq_s8 ARM intrinsic", "vuzpq_u16 ARM intrinsic", "vuzpq_u32 ARM intrinsic", "vuzpq_u8 ARM intrinsic", "vzip_f32 ARM intrinsic", "vzip_p16 ARM intrinsic", "vzip_p8 ARM intrinsic", "vzip_s16 ARM intrinsic", "vzip_s8 ARM intrinsic", "vzip_u16 ARM intrinsic", "vzip_u8 ARM intrinsic", "vzipq_f32 ARM intrinsic", "vzipq_p16 ARM intrinsic", "vzipq_p8 ARM intrinsic", "vzipq_s16 ARM intrinsic", "vzipq_s32 ARM intrinsic", "vzipq_s8 ARM intrinsic", "vzipq_u16 ARM intrinsic", "vzipq_u32 ARM intrinsic", "vzipq_u8 ARM intrinsic"] -ms.assetid: d3d7dadd-7bd5-4508-8bff-371a66913e20 --- # ARM intrinsics -The Microsoft C++ compiler (MSVC) makes the following intrinsics available on the ARM architecture. For more information about ARM, see the Architecture and Software Development Tools sections of the [ARM Developer Documentation](https://developer.arm.com/docs) website. +The Microsoft C++ (MSVC) compiler makes the following intrinsics available on the ARM architecture. For more information about ARM, see the Architecture and Software Development Tools sections of the [ARM Developer Documentation](https://developer.arm.com/docs) website. ## NEON @@ -305,7 +304,7 @@ Reads data from ARM coprocessors by using the coprocessor data transfer instruct unsigned __int64 _MoveFromCoprocessor64( unsigned int coproc, unsigned int opcode1, - unsigned int crm, + unsigned int crm ); ``` @@ -393,7 +392,7 @@ void _MoveFromCoprocessor64( unsigned __int64 value, unsigned int coproc, unsigned int opcode1, - unsigned int crm, + unsigned int crm ); ``` diff --git a/docs/intrinsics/arm64-intrinsics.md b/docs/intrinsics/arm64-intrinsics.md index 8300ceea360..c610e426be3 100644 --- a/docs/intrinsics/arm64-intrinsics.md +++ b/docs/intrinsics/arm64-intrinsics.md @@ -9,7 +9,7 @@ ms.date: "11/14/2019" --- # ARM64 intrinsics -The Microsoft C++ compiler (MSVC) makes the following intrinsics available on the ARM64 architecture. For more information about ARM, see the Architecture and Software Development Tools sections of the [ARM Developer Documentation](https://developer.arm.com/docs) website. +The Microsoft C++ (MSVC) compiler makes the following intrinsics available on the ARM64 architecture. For more information about ARM, see the Architecture and Software Development Tools sections of the [ARM Developer Documentation](https://developer.arm.com/docs) website. ## NEON diff --git a/docs/intrinsics/compiler-intrinsics.md b/docs/intrinsics/compiler-intrinsics.md index ea886301346..381e8610042 100644 --- a/docs/intrinsics/compiler-intrinsics.md +++ b/docs/intrinsics/compiler-intrinsics.md @@ -13,7 +13,7 @@ Most functions are contained in libraries, but some functions are built in (that If a function is an intrinsic, the code for that function is usually inserted inline, avoiding the overhead of a function call and allowing highly efficient machine instructions to be emitted for that function. An intrinsic is often faster than the equivalent inline assembly, because the optimizer has a built-in knowledge of how many intrinsics behave, so some optimizations can be available that are not available when inline assembly is used. Also, the optimizer can expand the intrinsic differently, align buffers differently, or make other adjustments depending on the context and arguments of the call. -The use of intrinsics affects the portability of code, because intrinsics that are available in Visual C++ might not be available if the code is compiled with other compilers and some intrinsics that might be available for some target architectures are not available for all architectures. However, intrinsics are usually more portable than inline assembly. The intrinsics are required on 64-bit architectures where inline assembly is not supported. +The use of intrinsics affects the portability of code, because intrinsics that are available in Microsoft C++ might not be available if the code is compiled with other compilers and some intrinsics that might be available for some target architectures are not available for all architectures. However, intrinsics are usually more portable than inline assembly. The intrinsics are required on 64-bit architectures where inline assembly is not supported. Some intrinsics, such as **`__assume`** and `__ReadWriteBarrier`, provide information to the compiler, which affects the behavior of the optimizer. diff --git a/docs/intrinsics/debugbreak.md b/docs/intrinsics/debugbreak.md index 4b752926d38..ed576d932d1 100644 --- a/docs/intrinsics/debugbreak.md +++ b/docs/intrinsics/debugbreak.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: __debugbreak" title: "__debugbreak" -ms.date: "09/02/2019" +description: "Learn more about: __debugbreak" +ms.date: 09/02/2019 f1_keywords: ["__debugbreak_cpp", "__debugbreak"] helpviewer_keywords: ["breakpoints, __debugbreak intrinsic", "__debugbreak intrinsic"] -ms.assetid: 1d1e1c0c-891a-4613-ae4b-d790094ba830 --- # __debugbreak @@ -34,7 +33,7 @@ The `__debugbreak` compiler intrinsic, similar to [DebugBreak](/windows/win32/ap For example: ```C -main() { +int main() { __debugbreak(); } ``` @@ -42,7 +41,7 @@ main() { is similar to: ```C -main() { +int main() { __asm { int 3 } diff --git a/docs/intrinsics/mm-insert-si64-mm-inserti-si64.md b/docs/intrinsics/mm-insert-si64-mm-inserti-si64.md index 3c6f905373e..aad03f0a479 100644 --- a/docs/intrinsics/mm-insert-si64-mm-inserti-si64.md +++ b/docs/intrinsics/mm-insert-si64-mm-inserti-si64.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: _mm_insert_si64, _mm_inserti_si64" title: "_mm_insert_si64, _mm_inserti_si64" +description: "Learn more about: _mm_insert_si64, _mm_inserti_si64" ms.date: "09/02/2019" f1_keywords: ["_mm_inserti_si64", "_mm_insert_si64"] helpviewer_keywords: ["insertq instruction", "_mm_insert_si64 intrinsic", "_mm_inserti_si64 intrinsic"] -ms.assetid: 897a4b36-8b08-4b00-a18f-7850f5732d7d --- # _mm_insert_si64, _mm_inserti_si64 @@ -21,7 +20,7 @@ __m128i _mm_insert_si64( ); __m128i _mm_inserti_si64( __m128i Source1, - __m128i Source2 + __m128i Source2, int Length, int Index ); diff --git a/docs/intrinsics/rotl8-rotl16.md b/docs/intrinsics/rotl8-rotl16.md index 7c12f13c465..e7316f19589 100644 --- a/docs/intrinsics/rotl8-rotl16.md +++ b/docs/intrinsics/rotl8-rotl16.md @@ -1,12 +1,11 @@ --- -description: "Learn more about: _rotl8, _rotl16" title: "_rotl8, _rotl16" -ms.date: "09/02/2019" +description: "Learn more about: _rotl8, _rotl16" +ms.date: 09/02/2019 f1_keywords: ["_rotl8", "_rotl16"] helpviewer_keywords: ["_rotl8 intrinsic", "_rotl16 intrinsic"] -ms.assetid: 8c519ab6-aef9-4f07-a387-daee8408368f --- -# _rotl8, _rotl16 +# `_rotl8`, `_rotl16` **Microsoft Specific** @@ -27,10 +26,10 @@ unsigned short _rotl16( ### Parameters -*value*\ +*`value`*\ [in] The value to rotate. -*shift*\ +*`shift`*\ [in] The number of bits to rotate. ## Return value @@ -44,7 +43,7 @@ The rotated value. |`_rotl8`|x86, ARM, x64, ARM64| |`_rotl16`|x86, ARM, x64, ARM64| -**Header file** \ +**Header file**: `` ## Remarks @@ -61,7 +60,7 @@ Unlike a left-shift operation, when executing a left rotation, the high-order bi int main() { - unsigned char c = 'A', c1, c2; + unsigned char c = 'A'; for (int i = 0; i < 8; i++) { @@ -93,5 +92,5 @@ Rotating unsigned short 0x12 left by 10 bits gives 0x4800 ## See also -[_rotr8, _rotr16](../intrinsics/rotr8-rotr16.md)\ -[Compiler intrinsics](../intrinsics/compiler-intrinsics.md) +[`_rotr8`, `_rotr16`](rotr8-rotr16.md)\ +[Compiler intrinsics](compiler-intrinsics.md) diff --git a/docs/intrinsics/rotr8-rotr16.md b/docs/intrinsics/rotr8-rotr16.md index fcc9a07e5aa..71a519a1793 100644 --- a/docs/intrinsics/rotr8-rotr16.md +++ b/docs/intrinsics/rotr8-rotr16.md @@ -1,12 +1,11 @@ --- -description: "Learn more about: _rotr8, _rotr16" title: "_rotr8, _rotr16" -ms.date: "09/02/2019" +description: "Learn more about: _rotr8, _rotr16" +ms.date: 09/02/2019 f1_keywords: ["_rotr16", "_rotr8"] helpviewer_keywords: ["_rotr8 intrinsic", "_rotr16 intrinsic"] -ms.assetid: dfbd2c82-82b4-427a-ad52-51609027ebff --- -# _rotr8, _rotr16 +# `_rotr8`, `_rotr16` **Microsoft Specific** @@ -27,10 +26,10 @@ unsigned short _rotr16( ### Parameters -*value*\ +*`value`*\ [in] The value to rotate. -*shift*\ +*`shift`*\ [in] The number of bits to rotate. ## Return value @@ -44,7 +43,7 @@ The rotated value. |`_rotr8`|x86, ARM, x64, ARM64| |`_rotr16`|x86, ARM, x64, ARM64| -**Header file** \ +**Header file**: `` ## Remarks @@ -61,7 +60,7 @@ Unlike a right-shift operation, when executing a right rotation, the low-order b int main() { - unsigned char c = 'A', c1, c2; + unsigned char c = 'A'; for (int i = 0; i < 8; i++) { @@ -94,5 +93,5 @@ Rotating unsigned short 0x12 right by 10 bits gives 0x480 ## See also -[_rotl8, _rotl16](../intrinsics/rotl8-rotl16.md)\ -[Compiler intrinsics](../intrinsics/compiler-intrinsics.md) +[`_rotl8`, `_rotl16`](rotl8-rotl16.md)\ +[Compiler intrinsics](compiler-intrinsics.md) diff --git a/docs/intrinsics/toc.yml b/docs/intrinsics/toc.yml index eb04364ed40..0c9053c8c38 100644 --- a/docs/intrinsics/toc.yml +++ b/docs/intrinsics/toc.yml @@ -40,7 +40,7 @@ items: - name: _bittestandset, _bittestandset64 href: ../intrinsics/bittestandset-bittestandset64.md - name: __check_isa_support, __check_arch_support - href: ../intrinsics/check-isa-arch-support.md + href: ../intrinsics/check-isa-arch-support.md - name: __cpuid, __cpuidex href: ../intrinsics/cpuid-cpuidex.md - name: __debugbreak diff --git a/docs/intrinsics/x64-amd64-intrinsics-list.md b/docs/intrinsics/x64-amd64-intrinsics-list.md index 555087d4d50..948b93ee9d9 100644 --- a/docs/intrinsics/x64-amd64-intrinsics-list.md +++ b/docs/intrinsics/x64-amd64-intrinsics-list.md @@ -13,7 +13,7 @@ For information about individual intrinsics, see these resources, as appropriate - The header file. Many intrinsics are documented in comments in the header file. -- [Intel Intrinsics Guide](https://software.intel.com/sites/landingpage/IntrinsicsGuide). Use the search box to find specific intrinsics. +- [Intel Intrinsics Guide](https://www.intel.com/content/www/us/en/docs/intrinsics-guide/index.html). Use the search box to find specific intrinsics. - [Intel 64 and IA-32 Architectures Software Developer Manuals](https://software.intel.com/articles/intel-sdm) @@ -102,7 +102,7 @@ The following table lists the intrinsics available on x64 processors. The Techno | [`_fxrstor64`](https://www.intel.com/content/www/us/en/docs/intrinsics-guide/index.html#text=_fxrstor64) | FXSR | immintrin.h | `void _fxrstor64(void const*);` | | [`_fxsave`](https://www.intel.com/content/www/us/en/docs/intrinsics-guide/index.html#text=_fxsave) | FXSR | immintrin.h | `void _fxsave(void*);` | | [`_fxsave64`](https://www.intel.com/content/www/us/en/docs/intrinsics-guide/index.html#text=_fxsave64) | FXSR | immintrin.h | `void _fxsave64(void*);` | -| [`__getcallerseflags`](getcallerseflags.md) | | intrin.h | `(unsigned int __getcallerseflags());` | +| [`__getcallerseflags`](getcallerseflags.md) | | intrin.h | `unsigned int __getcallerseflags();` | | [`__halt`](halt.md) | | intrin.h | `void __halt(void);` | | [`__inbyte`](inbyte.md) | | intrin.h | `unsigned char __inbyte(unsigned short);` | | [`__inbytestring`](inbytestring.md) | | intrin.h | `void __inbytestring(unsigned short, unsigned char *, unsigned long);` | @@ -1033,7 +1033,7 @@ The following table lists the intrinsics available on x64 processors. The Techno | [`_mm256_round_ps`](https://www.intel.com/content/www/us/en/docs/intrinsics-guide/index.html#text=_mm256_round_ps) | AVX | immintrin.h | `__m256 _mm256_round_ps(__m256, int);` | | [`_mm256_rsqrt_ps`](https://www.intel.com/content/www/us/en/docs/intrinsics-guide/index.html#text=_mm256_rsqrt_ps) | AVX | immintrin.h | `__m256 _mm256_rsqrt_ps(__m256);` | | [`_mm256_sad_epu8`](https://www.intel.com/content/www/us/en/docs/intrinsics-guide/index.html#text=_mm256_sad_epu8) | AVX2 | immintrin.h | `__m256i _mm256_sad_epu8(__m256i, __m256i);` | -| [`_mm256_set_epi16`](https://www.intel.com/content/www/us/en/docs/intrinsics-guide/index.html#text=_mm256_set_epi16) | AVX | immintrin.h | `(__m256i _mm256_set_epi16(short, short, short, short, short, short, short, short, short, short, short, short, short, short, short, short);` | +| [`_mm256_set_epi16`](https://www.intel.com/content/www/us/en/docs/intrinsics-guide/index.html#text=_mm256_set_epi16) | AVX | immintrin.h | `__m256i _mm256_set_epi16(short, short, short, short, short, short, short, short, short, short, short, short, short, short, short, short);` | | [`_mm256_set_epi32`](https://www.intel.com/content/www/us/en/docs/intrinsics-guide/index.html#text=_mm256_set_epi32) | AVX | immintrin.h | `__m256i _mm256_set_epi32(int, int, int, int, int, int, int, int);` | | [`_mm256_set_epi64x`](https://www.intel.com/content/www/us/en/docs/intrinsics-guide/index.html#text=_mm256_set_epi64x) | AVX | immintrin.h | `__m256i _mm256_set_epi64x(long long, long long, long long, long long);` | | [`_mm256_set_epi8`](https://www.intel.com/content/www/us/en/docs/intrinsics-guide/index.html#text=_mm256_set_epi8) | AVX | immintrin.h | `__m256i _mm256_set_epi8(char, char, char, char, char, char, char, char, char, char, char, char, char, char, char, char, char, char, char, char, char, char, char, char, char, char, char, char, char, char, char, char);` | @@ -1045,10 +1045,10 @@ The following table lists the intrinsics available on x64 processors. The Techno | [`_mm256_set1_epi8`](https://www.intel.com/content/www/us/en/docs/intrinsics-guide/index.html#text=_mm256_set1_epi8) | AVX | immintrin.h | `__m256i _mm256_set1_epi8(char);` | | [`_mm256_set1_pd`](https://www.intel.com/content/www/us/en/docs/intrinsics-guide/index.html#text=_mm256_set1_pd) | AVX | immintrin.h | `__m256d _mm256_set1_pd(double);` | | [`_mm256_set1_ps`](https://www.intel.com/content/www/us/en/docs/intrinsics-guide/index.html#text=_mm256_set1_ps) | AVX | immintrin.h | `__m256 _mm256_set1_ps(float);` | -| [`_mm256_setr_epi16`](https://www.intel.com/content/www/us/en/docs/intrinsics-guide/index.html#text=_mm256_setr_epi16) | AVX | immintrin.h | `(__m256i _mm256_setr_epi16(short, short, short, short, short, short, short, short, short, short, short, short, short, short, short, short);` | +| [`_mm256_setr_epi16`](https://www.intel.com/content/www/us/en/docs/intrinsics-guide/index.html#text=_mm256_setr_epi16) | AVX | immintrin.h | `__m256i _mm256_setr_epi16(short, short, short, short, short, short, short, short, short, short, short, short, short, short, short, short);` | | [`_mm256_setr_epi32`](https://www.intel.com/content/www/us/en/docs/intrinsics-guide/index.html#text=_mm256_setr_epi32) | AVX | immintrin.h | `__m256i _mm256_setr_epi32(int, int, int, int, int, int, int, int);` | | [`_mm256_setr_epi64x`](https://www.intel.com/content/www/us/en/docs/intrinsics-guide/index.html#text=_mm256_setr_epi64x) | AVX | immintrin.h | `__m256i _mm256_setr_epi64x(long long, long long, long long, long long);` | -| [`_mm256_setr_epi8`](https://www.intel.com/content/www/us/en/docs/intrinsics-guide/index.html#text=_mm256_setr_epi8) | AVX | immintrin.h | `(__m256i _mm256_setr_epi8(char, char, char, char, char, char, char, char, char, char, char, char, char, char, char, char, char, char, char, char, char, char, char, char, char, char, char, char, char, char, char, char);` | +| [`_mm256_setr_epi8`](https://www.intel.com/content/www/us/en/docs/intrinsics-guide/index.html#text=_mm256_setr_epi8) | AVX | immintrin.h | `__m256i _mm256_setr_epi8(char, char, char, char, char, char, char, char, char, char, char, char, char, char, char, char, char, char, char, char, char, char, char, char, char, char, char, char, char, char, char, char);` | | [`_mm256_setr_pd`](https://www.intel.com/content/www/us/en/docs/intrinsics-guide/index.html#text=_mm256_setr_pd) | AVX | immintrin.h | `__m256d _mm256_setr_pd(double, double, double, double);` | | [`_mm256_setr_ps`](https://www.intel.com/content/www/us/en/docs/intrinsics-guide/index.html#text=_mm256_setr_ps) | AVX | immintrin.h | `__m256 _mm256_setr_ps(float, float, float, float, float, float, float, float);` | | [`_mm256_setzero_pd`](https://www.intel.com/content/www/us/en/docs/intrinsics-guide/index.html#text=_mm256_setzero_pd) | AVX | immintrin.h | `__m256d _mm256_setzero_pd(void);` | diff --git a/docs/intrinsics/x86-intrinsics-list.md b/docs/intrinsics/x86-intrinsics-list.md index 4c494efabcb..0cc8c485387 100644 --- a/docs/intrinsics/x86-intrinsics-list.md +++ b/docs/intrinsics/x86-intrinsics-list.md @@ -75,7 +75,7 @@ The following table lists the intrinsics available on x86 processors. The Techno | [`__fastfail`](fastfail.md) | | intrin.h | `void __fastfail(unsigned int);` | | [`_fxrstor`](https://www.intel.com/content/www/us/en/docs/intrinsics-guide/index.html#text=_fxrstor) | FXSR | immintrin.h | `void _fxrstor(void const*);` | | [`_fxsave`](https://www.intel.com/content/www/us/en/docs/intrinsics-guide/index.html#text=_fxsave) | FXSR | immintrin.h | `void _fxsave(void*);` | -| [`__getcallerseflags`](getcallerseflags.md) | | intrin.h | `(unsigned int __getcallerseflags());` | +| [`__getcallerseflags`](getcallerseflags.md) | | intrin.h | `unsigned int __getcallerseflags();` | | [`__halt`](halt.md) | | intrin.h | `void __halt(void);` | | [`__inbyte`](inbyte.md) | | intrin.h | `unsigned char __inbyte(unsigned short);` | | [`__inbytestring`](inbytestring.md) | | intrin.h | `void __inbytestring(unsigned short, unsigned char *, unsigned long);` | @@ -1127,7 +1127,7 @@ The following table lists the intrinsics available on x86 processors. The Techno | [`_mm256_round_ps`](https://www.intel.com/content/www/us/en/docs/intrinsics-guide/index.html#text=_mm256_round_ps) | AVX | immintrin.h | `__m256 _mm256_round_ps(__m256, int);` | | [`_mm256_rsqrt_ps`](https://www.intel.com/content/www/us/en/docs/intrinsics-guide/index.html#text=_mm256_rsqrt_ps) | AVX | immintrin.h | `__m256 _mm256_rsqrt_ps(__m256);` | | [`_mm256_sad_epu8`](https://www.intel.com/content/www/us/en/docs/intrinsics-guide/index.html#text=_mm256_sad_epu8) | AVX2 | immintrin.h | `__m256i _mm256_sad_epu8(__m256i, __m256i);` | -| [`_mm256_set_epi16`](https://www.intel.com/content/www/us/en/docs/intrinsics-guide/index.html#text=_mm256_set_epi16) | AVX | immintrin.h | `(__m256i _mm256_set_epi16(short, short, short, short, short, short, short, short, short, short, short, short, short, short, short, short);` | +| [`_mm256_set_epi16`](https://www.intel.com/content/www/us/en/docs/intrinsics-guide/index.html#text=_mm256_set_epi16) | AVX | immintrin.h | `__m256i _mm256_set_epi16(short, short, short, short, short, short, short, short, short, short, short, short, short, short, short, short);` | | [`_mm256_set_epi32`](https://www.intel.com/content/www/us/en/docs/intrinsics-guide/index.html#text=_mm256_set_epi32) | AVX | immintrin.h | `__m256i _mm256_set_epi32(int, int, int, int, int, int, int, int);` | | [`_mm256_set_epi8`](https://www.intel.com/content/www/us/en/docs/intrinsics-guide/index.html#text=_mm256_set_epi8) | AVX | immintrin.h | `__m256i _mm256_set_epi8(char, char, char, char, char, char, char, char, char, char, char, char, char, char, char, char, char, char, char, char, char, char, char, char, char, char, char, char, char, char, char, char);` | | [`_mm256_set_pd`](https://www.intel.com/content/www/us/en/docs/intrinsics-guide/index.html#text=_mm256_set_pd) | AVX | immintrin.h | `__m256d _mm256_set_pd(double, double, double, double);` | @@ -1137,9 +1137,9 @@ The following table lists the intrinsics available on x86 processors. The Techno | [`_mm256_set1_epi8`](https://www.intel.com/content/www/us/en/docs/intrinsics-guide/index.html#text=_mm256_set1_epi8) | AVX | immintrin.h | `__m256i _mm256_set1_epi8(char);` | | [`_mm256_set1_pd`](https://www.intel.com/content/www/us/en/docs/intrinsics-guide/index.html#text=_mm256_set1_pd) | AVX | immintrin.h | `__m256d _mm256_set1_pd(double);` | | [`_mm256_set1_ps`](https://www.intel.com/content/www/us/en/docs/intrinsics-guide/index.html#text=_mm256_set1_ps) | AVX | immintrin.h | `__m256 _mm256_set1_ps(float);` | -| [`_mm256_setr_epi16`](https://www.intel.com/content/www/us/en/docs/intrinsics-guide/index.html#text=_mm256_setr_epi16) | AVX | immintrin.h | `(__m256i _mm256_setr_epi16(short, short, short, short, short, short, short, short, short, short, short, short, short, short, short, short);` | +| [`_mm256_setr_epi16`](https://www.intel.com/content/www/us/en/docs/intrinsics-guide/index.html#text=_mm256_setr_epi16) | AVX | immintrin.h | `__m256i _mm256_setr_epi16(short, short, short, short, short, short, short, short, short, short, short, short, short, short, short, short);` | | [`_mm256_setr_epi32`](https://www.intel.com/content/www/us/en/docs/intrinsics-guide/index.html#text=_mm256_setr_epi32) | AVX | immintrin.h | `__m256i _mm256_setr_epi32(int, int, int, int, int, int, int, int);` | -| [`_mm256_setr_epi8`](https://www.intel.com/content/www/us/en/docs/intrinsics-guide/index.html#text=_mm256_setr_epi8) | AVX | immintrin.h | `(__m256i _mm256_setr_epi8(char, char, char, char, char, char, char, char, char, char, char, char, char, char, char, char, char, char, char, char, char, char, char, char, char, char, char, char, char, char, char, char,);` | +| [`_mm256_setr_epi8`](https://www.intel.com/content/www/us/en/docs/intrinsics-guide/index.html#text=_mm256_setr_epi8) | AVX | immintrin.h | `__m256i _mm256_setr_epi8(char, char, char, char, char, char, char, char, char, char, char, char, char, char, char, char, char, char, char, char, char, char, char, char, char, char, char, char, char, char, char, char);` | | [`_mm256_setr_pd`](https://www.intel.com/content/www/us/en/docs/intrinsics-guide/index.html#text=_mm256_setr_pd) | AVX | immintrin.h | `__m256d _mm256_setr_pd(double, double, double, double);` | | [`_mm256_setr_ps`](https://www.intel.com/content/www/us/en/docs/intrinsics-guide/index.html#text=_mm256_setr_ps) | AVX | immintrin.h | `__m256 _mm256_setr_ps(float, float, float, float, float, float, float, float);` | | [`_mm256_setzero_pd`](https://www.intel.com/content/www/us/en/docs/intrinsics-guide/index.html#text=_mm256_setzero_pd) | AVX | immintrin.h | `__m256d _mm256_setzero_pd(void);` | diff --git a/docs/linux/cmake-linux-configure.md b/docs/linux/cmake-linux-configure.md index c25b94031e9..195a0cbd832 100644 --- a/docs/linux/cmake-linux-configure.md +++ b/docs/linux/cmake-linux-configure.md @@ -2,6 +2,7 @@ title: "Configure a Linux CMake project in Visual Studio" description: "How to configure Linux CMake settings in Visual Studio" ms.date: 01/03/2022 +ms.topic: how-to --- # Configure a Linux CMake project in Visual Studio @@ -129,7 +130,7 @@ To target WSL, select **Manage Configurations** in the configuration dropdown in The **CMakeSettings.json** window appears. -![CMake settings dialog with the plus button highlighted which adds the selected configuration, which is Linux-GCC-debug.](media/cmake-linux-configurations.png ) +![CMake settings dialog with the plus button highlighted which adds the selected configuration, which is Linux-GCC-debug.](media/cmake-linux-configurations.png) Press **Add Configuration** (the green '+' button) and then choose **Linux-GCC-Debug** or **Linux-GCC-Release** if using GCC. Use the Clang variants if you're using the Clang/LLVM toolset. Press **Select** and then **Ctrl+S** to save the configuration. diff --git a/docs/linux/cmake-linux-project.md b/docs/linux/cmake-linux-project.md index 821cbc5e046..538d0fb2005 100644 --- a/docs/linux/cmake-linux-project.md +++ b/docs/linux/cmake-linux-project.md @@ -3,6 +3,7 @@ title: "Create a CMake Linux project in Visual Studio" description: "How to create a Linux CMake project in Visual Studio" ms.date: "08/06/2020" ms.assetid: f8707b32-f90d-494d-ae0b-1d44425fdc25 +ms.topic: how-to --- # Create a CMake Linux project in Visual Studio diff --git a/docs/linux/configure-a-linux-project.md b/docs/linux/configure-a-linux-project.md index 88ef152274b..ac65f32b525 100644 --- a/docs/linux/configure-a-linux-project.md +++ b/docs/linux/configure-a-linux-project.md @@ -3,6 +3,7 @@ title: "Configure a Linux MSBuild C++ project in Visual Studio" ms.date: "10/16/2020" description: "Configure a MSBuild-based Linux project in Visual Studio so you can build it." ms.assetid: 4d7c6adf-54b9-4b23-bd23-5de0c825b768 +ms.custom: sfi-image-nochange --- # Configure a Linux MSBuild C++ project in Visual Studio diff --git a/docs/linux/connect-to-your-remote-linux-computer.md b/docs/linux/connect-to-your-remote-linux-computer.md index ff7c061c283..0ffc8a5aba9 100644 --- a/docs/linux/connect-to-your-remote-linux-computer.md +++ b/docs/linux/connect-to-your-remote-linux-computer.md @@ -1,9 +1,11 @@ --- -title: "Connect to your target Linux system in Visual Studio" -description: "How to connect to a remote Linux machine or Windows Subsystem for Linux from inside a Visual Studio C++ project." -ms.date: 03/14/2022 +title: "Connect to a Target Linux System by Using Visual Studio" +description: "Learn how to connect to a remote Linux machine or Windows Subsystem for Linux from inside a Visual Studio C++ project." +ms.topic: tutorial +ms.date: 03/21/2025 +ms.custom: sfi-image-nochange --- -# Connect to your target Linux system in Visual Studio +# Connect to your remote Linux system by using Visual Studio ::: moniker range="msvc-140" @@ -26,6 +28,7 @@ You can configure a Linux project to target a remote machine or the Windows Subs ::: moniker range=">=msvc-150" When using a remote connection, Visual Studio builds C++ Linux projects on the remote machine. It doesn't matter if it's a physical machine, a virtual machine in the cloud, or WSL. + To build the project, Visual Studio copies the source code to your remote Linux computer. Then, the code gets compiled based on Visual Studio settings. ::: moniker-end @@ -39,7 +42,7 @@ To build the project, Visual Studio copies the source code to your remote Linux ::: moniker range=">=msvc-150" -## Set up the SSH server on the remote system +## Set up the SSH server on the remote machine If `ssh` isn't already set up and running on your Linux system, follow these steps to install it. The examples in this article use Ubuntu 18.04 LTS with OpenSSH server version 7.6. However, the instructions should be the same for any distro using a moderately recent version of OpenSSH. @@ -58,7 +61,7 @@ If `ssh` isn't already set up and running on your Linux system, follow these ste ## Set up the remote connection -1. In Visual Studio, choose **Tools > Options** on the menu bar to open the **Options** dialog. Then select **Cross Platform > Connection Manager** to open the Connection Manager dialog. +1. In Visual Studio on your local Windows system, choose **Tools > Options** on the menu bar to open the **Options** dialog. Then select **Cross Platform > Connection Manager** to open the Connection Manager dialog. If you haven't set up a connection in Visual Studio before, when you build your project for the first time, Visual Studio opens the Connection Manager dialog for you. @@ -69,11 +72,11 @@ If `ssh` isn't already set up and running on your Linux system, follow these ste :::image-end::: To edit an existing connection, choose **Edit**. In either scenario, the **Connect to Remote System** window is displayed. - + :::image type="complex" source="media/connect-to-your-remote-linux-computer/connect-updated.png" alt-text="Screenshot of the Visual Studio Connect to Remote System window."::: In the Connect to Remote System window, there are fields for host name, port, user name, authentication type, and password. Port is set to 22. Authentication type is set to 'Password'. :::image-end::: - + 1. Enter the following information: | Entry | Description | @@ -84,23 +87,23 @@ If `ssh` isn't already set up and running on your Linux system, follow these ste | **Authentication type** | Password and Private Key are both supported | | **Password** | Password for the entered user name | | **Private key file** | Private key file created for ssh connection | - | **Passphrase** | Passphrase used with private key selected above | + | **Passphrase** | Passphrase used with private key selected previously | - You can't click the **Connect** button until all the required fields are completed and the port is set to an integer between 1 and 65535. + You can't select the **Connect** button until all the required fields are completed and the port is set to an integer between 1 and 65535. You can use either a password or a key file and passphrase for authentication. Key files are more secure than username/password. If you already have a key pair, it's possible to reuse it. - Versions of Visual Studio before 17.10 support Elliptic Curve (EC), Rivert-Shamir-Adleman (RSA), and Digital signature algorithm (DSA) keys for remote connections. Because of security concerns, DSA keys are no longer supported in VS 17.10 and later. RSA keys were also not supported in VS 17.10 and VS 17.11 but are supported again in VS 17.12 and later. To create a key pair compatible with the connection manager you can use the command: + Versions of Visual Studio before 17.10 support Elliptic Curve (EC), Rivert-Shamir-Adleman (RSA), and Digital signature algorithm (DSA) keys for remote connections. Because of security concerns, DSA keys are no longer supported in VS 17.10 and later. RSA keys were also not supported in VS 17.10 and VS 17.11 but some types are supported again in VS 17.12 and later. To create a key pair compatible with the connection manager, you can use the command: `ssh-keygen -m pem -t ecdsa -f ` > [!NOTE] - > If using `ssh-keygen` to create the private key, you must specify the switch `-m pem`, or the key will not be accepted by Visual Studio. If your private key begins with `-----BEGIN OPENSSH PRIVATE KEY-----`, you must convert it with `ssh-keygen -p -f -m pem`. + > If using `ssh-keygen` to create the private key, you must specify the switch `-m pem`, or the key isn't accepted by Visual Studio. If your private key begins with `-----BEGIN OPENSSH PRIVATE KEY-----`, you must convert it with `ssh-keygen -p -f -m pem`. 1. Choose the **Connect** button to attempt a connection to the remote computer. If the connection succeeds, Visual Studio configures IntelliSense to use the remote headers. For more information, see [IntelliSense for headers on remote systems](configure-a-linux-project.md#remote_intellisense). - If the connection fails, an info bar with error information appears and the fields that you may need to change are outlined in red. + If the connection fails, an info bar with error information appears and the fields that you might need to change are outlined in red. :::image type="content" source="media/connect-to-your-remote-linux-computer/settings-connection-manager-error-updated.png" alt-text="Screenshot of the Visual Studio Connect to Remote System window. The host name and port fields are outlined in red to indicate incorrect entries."::: @@ -114,13 +117,13 @@ If `ssh` isn't already set up and running on your Linux system, follow these ste ## Host key verification -In Visual Studio version 16.10 or later, you're asked to verify the server's host key fingerprint whenever Visual Studio connects to a remote system for the first time. You may be familiar with this process if you've used the OpenSSH command-line client or PuTTY before. The fingerprint identifies the server. Visual Studio uses the fingerprint to ensure it's connecting to the intended and trusted server. +In Visual Studio version 16.10 or later, you're asked to verify the server's host key fingerprint whenever Visual Studio connects to a remote system for the first time. You might be familiar with this process if you've used the OpenSSH command-line client or PuTTY before. The fingerprint identifies the server. Visual Studio uses the fingerprint to ensure it connects to the intended and trusted server. The first time Visual Studio establishes a new remote connection, you're asked to accept or deny the host key fingerprint presented by the server. Or, anytime there are changes to a cached fingerprint. You can also verify a fingerprint on demand: select a connection in the Connection Manager and choose **Verify**. If you upgrade to Visual Studio 16.10 or later from an older version, it treats any existing remote connections as new connections. You're prompted to accept the host key fingerprint first. Then, Visual Studio establishes a connection and caches the accepted fingerprint. -You can also update remote connections from `ConnectionManager.exe` using the `update` argument. +You can also update remote connections from *`ConnectionManager.exe`* using the `update` argument. ## Supported SSH algorithms @@ -131,19 +134,19 @@ Starting in Visual Studio version 16.9, support for older, insecure SSH algorith | Encryption | `aes128-cbc`
`aes128-ctr`
`aes192-cbc`
`aes192-ctr`
`aes256-cbc`
`aes256-ctr` | | HMAC | `hmac-sha2-256`
`hmac-sha2-512` | | Key exchange | `diffie-hellman-group14-sha256`
`diffie-hellman-group16-sha512`
`diffie-hellman-group-exchange-sha256`
`ecdh-sha2-nistp256`
`ecdh-sha2-nistp384`
`ecdh-sha2-nistp521` | -| Host key | `ecdsa-sha2-nistp256`
`ecdsa-sha2-nistp384`
`ecdsa-sha2-nistp521`
`rsa-sha2-512`
`rsa-sha2-256`
`ssh-rsa` | +| Host key | `ecdsa-sha2-nistp256`
`ecdsa-sha2-nistp384`
`ecdsa-sha2-nistp521`
`rsa-sha2-512`
`rsa-sha2-256` | ### Configure the SSH server First, a little background. You can't select the SSH algorithm to use from Visual Studio. Instead, the algorithm is determined during the initial handshake with the SSH server. Each side (client and server) provides a list of algorithms it supports, and then the first algorithm common to both is selected. The connection succeeds as long as there's at least one algorithm in common between Visual Studio and the server for encryption, HMAC, key exchange, and so on. -The Open SSH configuration file (*`sshd_config`*) doesn't configure which algorithm to use by default. The SSH server should use secure defaults when no algorithms are specified. Those defaults depend on the version and vendor of the SSH server. If Visual Studio doesn't support those defaults, you'll likely see an error like: "Could not connect to the remote system. No common client to server HMAC algorithm was found." The error may also appear if the SSH server is configured to use algorithms that Visual Studio doesn't support. +The Open SSH configuration file (*`sshd_config`*) doesn't configure which algorithm to use by default. The SSH server should use secure defaults when no algorithms are specified. Those defaults depend on the version and vendor of the SSH server. If Visual Studio doesn't support those defaults, you'll likely see an error like: *Could not connect to the remote system. No common client to server HMAC algorithm was found.* The error might also appear if the SSH server is configured to use algorithms that Visual Studio doesn't support. -The default SSH server on most modern Linux distributions should work with Visual Studio. However, you may be running an older SSH server that's configured to use older, insecure algorithms. The following example explains how to update to more secure versions. +The default SSH server on most modern Linux distributions should work with Visual Studio. However, you might be running an older SSH server that's configured to use older, insecure algorithms. The following example explains how to update to more secure versions. -In the following example, the SSH server uses the insecure `hmac-sha1` algorithm, which Visual Studio 16.9 doesn't support. If the SSH server uses OpenSSH, you can edit the `/etc/ssh/sshd_config` file as shown below to enable more secure algorithms. For other SSH servers, refer to the server's documentation for how to configure them. +In this example, the SSH server uses the insecure `hmac-sha1` algorithm, which Visual Studio 16.9 doesn't support. If the SSH server uses OpenSSH, you can edit the `/etc/ssh/sshd_config` file to enable more secure algorithms. For other SSH servers, refer to the server's documentation for how to configure them. -First, verify that the set of algorithms your server is using includes algorithms supported by Visual Studio. Run the following command on the remote machine to list the algorithms supported by the server: +First, verify that the set of algorithms your server is using includes algorithms supported by Visual Studio. Run the following command on the remote machine to list the algorithms supported by the server: ```bash ssh -Q cipher; ssh -Q mac; ssh -Q kex; ssh -Q key @@ -169,7 +172,7 @@ These examples can be added anywhere in `/etc/ssh/sshd_config`. Ensure that they After editing the file, restart the SSH server (`sudo service ssh restart` on Ubuntu) and attempt to connect again from Visual Studio. -#### Cipher example +#### Cipher example Add: `Ciphers ` For example: `Ciphers aes128-cbc,aes256-cbc` @@ -191,25 +194,25 @@ For example: `HostKeyAlgorithms ecdsa-sha2-nistp256,ecdsa-sha2-nistp384` ## Logging for remote connections - You can enable logging to help troubleshoot connection problems. On the menu bar, select **Tools > Options**. In the **Options** dialog, select **Cross Platform > Logging**: +You can enable logging to help troubleshoot connection problems. On the menu bar, select **Tools > Options**. In the **Options** dialog, select **Cross Platform > Logging**: - :::image type="complex" source="media/remote-logging-vs2019.png" alt-text="Screenshot of the Visual Studio options screen."::: - The options are open to Cross Platform > Connection Manager > Logging. Enable logging is checked, log to a file is checked, the logfile directory is set the documents folder, and log to the 'Cross Platform Logging' pane in the output window is checked. - :::image-end::: +:::image type="complex" source="media/remote-logging-vs2019.png" alt-text="Screenshot of the Visual Studio options screen."::: +The options are open to Cross Platform > Connection Manager > Logging. Enable logging is checked, log to a file is checked, the logfile directory is set the documents folder, and log to the 'Cross Platform Logging' pane in the output window is checked. +:::image-end::: - Logs include connections, all commands sent to the remote machine (their text, exit code and execution time), and all output from Visual Studio to the shell. Logging works for any cross-platform CMake project or MSBuild-based Linux project in Visual Studio. +Logs include connections, all commands sent to the remote machine (their text, exit code and execution time), and all output from Visual Studio to the shell. Logging works for any cross-platform CMake project or MSBuild-based Linux project in Visual Studio. - You can configure the output to go to a file or to the **Cross Platform Logging** pane in the Output window. For MSBuild-based Linux projects, MSBuild commands sent to the remote machine aren't routed to the **Output Window** because they're emitted out-of-process. Instead, they're logged to a file, with a prefix of "msbuild_". +You can configure the output to go to a file or to the **Cross Platform Logging** pane in the Output window. For MSBuild-based Linux projects, MSBuild commands sent to the remote machine aren't routed to the **Output Window** because they're emitted out-of-process. Instead, they're logged to a file, with a prefix of `msbuild_`. -## Command-line utility for the Connection Manager +## Command-line utility for the Connection Manager -**Visual Studio 2019 version 16.5 or later**: `ConnectionManager.exe` is a command-line utility to manage remote development connections outside of Visual Studio. It's useful for tasks such as provisioning a new development machine. Or, you can use it to set up Visual Studio for continuous integration. For examples and a complete reference to the ConnectionManager command, see [ConnectionManager reference](connectionmanager-reference.md). +**Visual Studio 2019 version 16.5 or later**: *`ConnectionManager.exe`* is a command-line utility to manage remote development connections outside of Visual Studio. It's useful for tasks such as provisioning a new development machine. Or, you can use it to set up Visual Studio for continuous integration. For examples and a complete reference to the `ConnectionManager` command, see [ConnectionManager reference](connectionmanager-reference.md). ::: moniker-end ::: moniker range=">=msvc-150" -## TCP Port Forwarding +## TCP port forwarding The `rsync` command is used by both MSBuild-based Linux projects and CMake projects to [copy headers from your remote system to Windows for use by IntelliSense](configure-a-linux-project.md#remote_intellisense). When you can't enable TCP port forwarding, disable the automatic download of remote headers. To disable it, use **Tools > Options > Cross Platform > Connection Manager > Remote Headers IntelliSense Manager**. If the remote system doesn't have TCP port forwarding enabled, this error appears when the download of remote headers for IntelliSense begins: @@ -231,7 +234,7 @@ Visual Studio's Linux support has a dependency on TCP port forwarding. Both `rsy ::: moniker range="msvc-150" -In Visual Studio 2017, you use the same steps to connect to WSL as you use for a remote Linux machine. Use `localhost` for the **Host Name**. +In Visual Studio 2017, you use the same steps to connect to Windows Subsystem for Linux (WSL) as you use for a remote Linux machine. Use `localhost` for the **Host Name**. ::: moniker-end @@ -247,7 +250,7 @@ sudo apt install g++ gdb make ninja-build rsync zip ### Fix WSL `localhost` connection problems -When connecting to Windows Subsystem for Linux (WSL) on `localhost`, you may run into a conflict with the Windows `ssh` client on port 22. In WSL, change the port that `ssh` expects requests from to 23 in `/etc/ssh/sshd_config`: +When connecting to WSL on `localhost`, you might run into a conflict with the Windows `ssh` client on port 22. In WSL, change the port that `ssh` expects requests from to 23 in `/etc/ssh/sshd_config`: ```bash Port 23 @@ -270,9 +273,9 @@ To configure an MSBuild project for WSL, see [Configure a Linux project](configu ::: moniker-end -## See Also +## See also -[Configure a Linux project](configure-a-linux-project.md)\ -[Configure a Linux CMake project](cmake-linux-project.md)\ -[Deploy, run, and debug your Linux project](deploy-run-and-debug-your-linux-project.md)\ -[Configure CMake debugging sessions](../build/configure-cmake-debugging-sessions.md) \ No newline at end of file +- [Configure a Linux MSBuild C++ project in Visual Studio](configure-a-linux-project.md) +- [Create a CMake Linux project in Visual Studio](cmake-linux-project.md) +- [Deploy, run, and debug your Linux MSBuild project](deploy-run-and-debug-your-linux-project.md) +- [Configure CMake debugging sessions](../build/configure-cmake-debugging-sessions.md) \ No newline at end of file diff --git a/docs/linux/create-a-new-linux-project.md b/docs/linux/create-a-new-linux-project.md index 7002e23eefd..20a574b8603 100644 --- a/docs/linux/create-a-new-linux-project.md +++ b/docs/linux/create-a-new-linux-project.md @@ -2,6 +2,7 @@ title: "Create a Linux MSBuild C++ project in Visual Studio" ms.date: "10/15/2020" description: "Create a new MSBuild-based Linux project in Visual Studio." +ms.topic: how-to --- # Create a Linux MSBuild C++ project in Visual Studio diff --git a/docs/linux/deploy-run-and-debug-your-linux-project.md b/docs/linux/deploy-run-and-debug-your-linux-project.md index ab59ede9d1d..999f3e19c0d 100644 --- a/docs/linux/deploy-run-and-debug-your-linux-project.md +++ b/docs/linux/deploy-run-and-debug-your-linux-project.md @@ -2,7 +2,9 @@ title: "Deploy, run, and debug your Linux MSBuild C++ project in Visual Studio" description: "Describes how to compile, execute, and debug code on the remote target from inside a MSBuild-based Linux C++ project in Visual Studio." ms.date: 12/5/2024 -ms.custom: intro-deployment +ms.custom: + - intro-deployment + - sfi-image-nochange --- # Deploy, run, and debug your Linux MSBuild project @@ -135,7 +137,6 @@ The **Content** property specifies whether the file will be deployed to the remo In some cases, you may require more control over your project's deployment. For example, some files that you want to deploy might be outside of your solution or you want to customize your remote deploy directory per file or directory. In these cases, append the following code block(s) to your .vcxproj file and replace "example.cpp" with the actual file names: ```xml - @@ -183,4 +184,4 @@ If you want complete control over your deployment, you can append the following ## See also -[C++ Debugging Properties (Linux C++)](prop-pages/debugging-linux.md) \ No newline at end of file +[C++ Debugging Properties (Linux C++)](prop-pages/debugging-linux.md) diff --git a/docs/linux/download-install-and-setup-the-linux-development-workload.md b/docs/linux/download-install-and-setup-the-linux-development-workload.md index 7bd57ecbe56..7187b8f44d6 100644 --- a/docs/linux/download-install-and-setup-the-linux-development-workload.md +++ b/docs/linux/download-install-and-setup-the-linux-development-workload.md @@ -1,14 +1,15 @@ --- -title: "Install the C++ Linux workload in Visual Studio" -description: "How to download, install, and set up the Linux workload for C++ in Visual Studio." -ms.date: "05/03/2020" +title: "Install the C++ Linux Workload in Visual Studio" +description: "Learn how to download, install, and set up the Linux workload for C++ in Visual Studio." +ms.date: 03/25/2025 +ms.topic: how-to ms.custom: intro-installation --- # Download, install, and set up the Linux workload ::: moniker range="msvc-140" -Linux projects are supported in Visual Studio 2017 and later. To see the documentation for these versions, set the Visual Studio **Version** selector control for this article to Visual Studio 2017 or Visual Studio 2019. It's found at the top of the table of contents on this page. +Linux projects are supported in Visual Studio 2017 and later. To see the documentation for these versions, set the Visual Studio **Version** selector for this article to Visual Studio 2017, Visual Studio 2019, or Visual Studio 2022. It's found at the top of the table of contents on this page. ::: moniker-end @@ -18,7 +19,7 @@ You can use the Visual Studio IDE on Windows to create, edit, and debug C++ proj You can work on your existing code base that uses CMake without having to convert it to a Visual Studio project. If your code base is cross-platform, you can target both Windows and Linux from within Visual Studio. For example, you can edit, build, and debug your code on Windows using Visual Studio. Then, quickly retarget the project for Linux to build and debug in a Linux environment. Linux header files are automatically copied to your local machine. Visual Studio uses them to provide full IntelliSense support (Statement Completion, Go to Definition, and so on). -For any of these scenarios, the **Linux development with C++** workload is required. +For any of these scenarios, the **Linux and embedded development with C++** workload is required. ::: moniker-end @@ -26,25 +27,25 @@ For any of these scenarios, the **Linux development with C++** workload is requi ## Visual Studio setup -1. Type "Visual Studio Installer" in the Windows search box: +1. Open the Visual Studio Installer from your Start menu. If you can't find it, type *Visual Studio Installer* in the Windows search box and look for the installer under the **Apps** results. - ![Screenshot of the Windows search box which contains the text: visual studio installer.](media/visual-studio-installer-search.png) + :::image type="content" source="media/visual-studio-installer-search.png" alt-text="Screenshot of the Windows search box that contains the text visual studio installer."::: -1. Look for the installer under the **Apps** results and double-click it. When the installer opens, choose **Modify**, and then click on the **Workloads** tab. Scroll down to **Other toolsets** and select the **Linux development with C++** workload. +1. When the installer opens, choose **Modify**, and then click on the **Workloads** tab. Scroll down to **Other toolsets** and select the **Linux and embedded development with C++** workload. - :::image type="complex" source="./media/linuxworkload.png" alt-text="Screenshot highlighting the Visual C++ for Linux Development workload item in Visual Studio Installer."::: - The Linux Development workload is selected. The Installation details pane is highlighted, which lists what's included in the workload. Which includes: Visual Studio C++ core features, Windows Universal C runtime, Visual C++ for Linux development. An optional component is also selected: Visual C++ tools for CMake and Linux. + :::image type="complex" source="./media/linux-workload.png" alt-text="Screenshot highlighting the Visual C++ for Linux and embedded development workload item in Visual Studio Installer."::: + The Linux and embedded development workload is selected. The Installation details pane is highlighted, which lists what's included in the workload. Which includes: Visual Studio C++ core features, Windows Universal C runtime, Visual C++ for Linux development. An optional component is also selected: Visual C++ tools for CMake and Linux. :::image-end::: -1. If you're targeting IoT or embedded platforms, go to the **Installation details** pane on the right. Under **Linux development with C++**, expand **Optional Components**, and choose the components you need. CMake support for Linux is selected by default. +1. If you're targeting IoT or embedded platforms, go to the **Installation details** pane on the right. Under **Linux and embedded development with C++**, expand **Optional Components**, and choose the components you need. CMake support for Linux is selected by default. 1. Click **Modify** to continue with the installation. ## Options for creating a Linux environment -If you don't already have a Linux machine, you can create a Linux Virtual Machine on Azure. For more information, see [Quickstart: Create a Linux virtual machine in the Azure portal](/azure/virtual-machines/linux/quick-create-portal). +If you don't already have a Linux machine, you can create a Linux virtual machine on Azure. For more information, see [Quickstart: Create a Linux virtual machine in the Azure portal](/azure/virtual-machines/linux/quick-create-portal). -On Windows 10 and later, you can install and target your favorite Linux distro on the Windows Subsystem for Linux (WSL). For more information, see [Windows Subsystem for Linux Installation Guide for Windows 10](/windows/wsl/install-win10). If you're unable to access the Windows Store, you can [manually download the WSL distro packages](/windows/wsl/install-manual). WSL is a convenient console environment, but it's not recommended for graphical applications. +On Windows 10 and later, you can install and target your favorite Linux distro on the Windows Subsystem for Linux (WSL). For more information, see [How to install Linux on Windows with WSL](/windows/wsl/install). If you're unable to access the Windows Store, you can [manually download the WSL distro packages](/windows/wsl/install-manual). WSL is a convenient console environment, but it's not recommended for graphical applications. ::: moniker-end @@ -103,7 +104,7 @@ The target Linux system must have **openssh-server**, **g++**, **gdb**, and **ma You might be prompted for your root password to run the `sudo` command. If so, enter it and continue. Once complete, the required services and tools are installed. -1. Ensure the ssh service is running on your Linux computer by running: +1. Ensure the ssh service is running on your Linux computer: ```bash sudo service ssh start @@ -141,7 +142,7 @@ The target machine running Fedora uses the **dnf** package installer. To downloa You might be prompted for your root password to run the sudo command. If so, enter it and continue. Once complete, the required services and tools are installed. -1. Ensure the ssh service is running on your Linux computer by running: +1. Ensure the ssh service is running on your Linux computer: ```bash sudo systemctl start sshd @@ -149,11 +150,9 @@ The target machine running Fedora uses the **dnf** package installer. To downloa This command starts the service and runs it in the background, ready to accept connections. -## Next Steps +## Related content -You're now ready to create or open a Linux project and configure it to run on the target system. For more information, see: - -- [Create a new Linux MSBuild C++ project](create-a-new-linux-project.md) -- [Configure a Linux CMake project](cmake-linux-project.md) +- [Create a Linux MSBuild C++ project in Visual Studio](create-a-new-linux-project.md) +- [Create a CMake Linux project in Visual Studio](cmake-linux-project.md) ::: moniker-end diff --git a/docs/linux/linux-asan-configuration.md b/docs/linux/linux-asan-configuration.md index 115a3a94c12..11c959116f9 100644 --- a/docs/linux/linux-asan-configuration.md +++ b/docs/linux/linux-asan-configuration.md @@ -2,6 +2,7 @@ title: "Configure Linux projects to use Address Sanitizer" description: "Describes how to configure C++ Linux projects in Visual Studio to use Address Sanitizer." ms.date: "10/7/2020" +ms.topic: how-to --- # Configure Linux projects to use Address Sanitizer diff --git a/docs/linux/media/linux-workload.png b/docs/linux/media/linux-workload.png new file mode 100644 index 00000000000..8a8baa1142d Binary files /dev/null and b/docs/linux/media/linux-workload.png differ diff --git a/docs/linux/media/linuxworkload.png b/docs/linux/media/linuxworkload.png deleted file mode 100644 index 5904de11ec7..00000000000 Binary files a/docs/linux/media/linuxworkload.png and /dev/null differ diff --git a/docs/linux/media/remote-file-explorer-download.png b/docs/linux/media/remote-file-explorer-download.png new file mode 100644 index 00000000000..befc41cb081 Binary files /dev/null and b/docs/linux/media/remote-file-explorer-download.png differ diff --git a/docs/linux/media/remote-file-explorer-menu-item.png b/docs/linux/media/remote-file-explorer-menu-item.png new file mode 100644 index 00000000000..a118df5a61a Binary files /dev/null and b/docs/linux/media/remote-file-explorer-menu-item.png differ diff --git a/docs/linux/media/remote-file-explorer-progress.png b/docs/linux/media/remote-file-explorer-progress.png new file mode 100644 index 00000000000..95e524bf70f Binary files /dev/null and b/docs/linux/media/remote-file-explorer-progress.png differ diff --git a/docs/linux/media/remote-file-explorer-toolbar.png b/docs/linux/media/remote-file-explorer-toolbar.png new file mode 100644 index 00000000000..16ea87e721b Binary files /dev/null and b/docs/linux/media/remote-file-explorer-toolbar.png differ diff --git a/docs/linux/media/remote-file-explorer-upload.png b/docs/linux/media/remote-file-explorer-upload.png new file mode 100644 index 00000000000..062b589e60b Binary files /dev/null and b/docs/linux/media/remote-file-explorer-upload.png differ diff --git a/docs/linux/media/remote-file-explorer.png b/docs/linux/media/remote-file-explorer.png new file mode 100644 index 00000000000..db9ab3b2225 Binary files /dev/null and b/docs/linux/media/remote-file-explorer.png differ diff --git a/docs/linux/media/vs2019-debugger-settings.png b/docs/linux/media/vs2019-debugger-settings.png index 43d7f8787be..676aa732cbd 100644 Binary files a/docs/linux/media/vs2019-debugger-settings.png and b/docs/linux/media/vs2019-debugger-settings.png differ diff --git a/docs/linux/remote-file-explorer.md b/docs/linux/remote-file-explorer.md new file mode 100644 index 00000000000..2f4ca5327eb --- /dev/null +++ b/docs/linux/remote-file-explorer.md @@ -0,0 +1,112 @@ +--- +title: "Remote file explorer" +description: "Learn how to use Remote File Explorer to view, upload, and download files on a remote machine form within Visual Studio." +ms.topic: how-to +ms.date: 06/02/2025 +--- +# Remote File Explorer + +Learn how to use **Remote File Explorer** to view, upload, and download files on a remote machine from Visual Studio. With **Remote File Explorer**, perform common file operations such as: + +- Upload files from your local machine to a remote machine +- Download files from a remote machine to your local machine +- Create folders on a remote machine +- Delete files and folders on a remote machine +- Rename files and folders on a remote machine +- Search for files and folders on a remote machine + +## Prerequisites + +Visual Studio version 17.6 or later. + +Ensure that the **Linux and embedded development with C++** workload is installed. Run the Visual Studio Installer and ensure that the **Linux and embedded development with C++** workload is selected. Also ensure that the **Remote File Explorer for Linux** component is selected, and update your installation if necessary. + +:::image type="content" source="media/linux-workload.png" alt-text="Screenshot of the Visual Studio Installer. The **Linux and embedded development with C++** workload is selected. In the installation details pane, Remote File Explorer for Linux is selected."::: + +Install and configure Secure Shell (SSH) on the remote machine. To install SSH on Linux, run these commands on the remote machine: + +```bash +sudo apt update +sudo apt install openssh-server +sudo systemctl start ssh +sudo systemctl status ssh +``` + +## View and edit files on a remote machine + +In these examples, the remote machine is a Windows Subsystem for Linux instance running on localhost port 22. The project is a new CMake project created in Visual Studio. The sample project is on the remote machine in the `C:\Users\{username}\projects\` folder. + +To open the **Remote File Explorer** in Visual Studio, choose **View** > **Other Windows** > **Remote File Explorer**. + +:::image type="content" source="media/remote-file-explorer-menu-item.png" alt-text="Screenshot of the Visual Studio View menu. Remote File Explorer is highlighted."::: + +The **Remote File Explorer** window opens: + +:::image type="content" source="media/remote-file-explorer.png" alt-text="Screenshot of the Remote File Explorer. The folder system on the remote machine is visible."::: + +If you see a message to select or create a new connection in the **Connection Manager**, ensure that the SSH server is running on the remote machine. If your remote machine is running on Windows Subsystem for Linux (WSL), ensure that the WSL instance is running. Make sure the Visual Studio debug target dropdown is set to the remote instance. To connect to a different remote machine, in the **Remote File Explorer** window's **Select the host target** dropdown, select the remote target. It may appear in a form such as `username@hostname:port`. For example, `username@localhost:22`. You can also select **Add new connection** to add a new connection to the **Connection Manager**. For more information, see [Connection manager](connect-to-your-remote-linux-computer.md). + +Open and edit files directly from the **Remote File Explorer**. To open a file, double-click the file in the **Remote File Explorer** window. The file opens in the editor window. You can also right-click the file and select **Open** from the context menu or press **Ctrl+Enter**. When you save the file, the changes are saved directly to the remote machine. + +## Upload files to a remote machine + +To upload files or directories to the remote machine, right-click the folder in the **Remote File Explorer** window where you want to upload files, and select **Upload**. + +:::image type="content" source="media/remote-file-explorer-upload.png" alt-text="Screenshot of the Remote File Explorer showing the Upload a directory and Upload files menu options."::: + +Use the folder explorer window that opens to select the file or folder you want to upload. You can drag and drop files from your local machine onto the **Remote File Explorer** window. Alternatively, use the **Upload Files** or **Upload Folder** buttons to choose the items to upload: + +## Download files from a remote machine + +To download files or directories from the remote machine, right-click the folder or file in the **Remote File Explorer** window that you want to download and select **Download**. + +:::image type="content" source="media/remote-file-explorer-download.png" alt-text="Screenshot of the Remote File Explorer displaying the menu option: Download 'asset.txt'."::: + +Use the folder explorer window that opens to select where to download the file or folder. You can also use the **Download Item** button to choose the item you want to download. + +## Monitor and cancel file operations + +Monitor the progress of uploading or downloading items in the status window at the bottom of the **Remote File Explorer** window. Select the **Cancel** button to stop the operation. + +:::image type="content" source="media/remote-file-explorer-progress.png" alt-text="Screenshot of the Remote File Explorer showing the progress indicator. The Cancel button is highlighted."::: + +## Other file operations + +Rename files and folders, create new folders, delete files and folders, and search for files and folders. + +- Rename a file or folder: right-click the file or folder and select **Rename** from the context menu, or select the rename button on the toolbar. The filename becomes editable. Type the new name for the item and press **Enter**. +- Create a new folder: right-click in the **Remote File Explorer** window and select **New Folder**. Enter a name for the new folder and press **Enter**. +- Delete a file or folder: right-click the file or folder and select **Delete** from the context menu, or select the delete button on the toolbar. Confirm the deletion in the dialog that appears. Deleting files or folders from the remote machine is a permanent action and can't be undone. +- Refresh the view: right-click in the **Remote File Explorer** window and select **Refresh** from the context menu, or select the refresh button on the toolbar, or press **F5**. It only refreshes the view of what is selected. If you have a folder selected, it refreshes the view of that folder. If you have a file selected, it refreshes the view of that file. +- Search for files: enter text in the search box at the top of the **Remote File Explorer** window to find folders or files. The search is case-insensitive and searches all files and folders under the selected item. If a folder is selected, it searches all files and folders in that folder. If a file is selected, it searches all files and folders in the same directory as that file. + +## Remote File Explorer toolbar buttons + +The **Remote File Explorer** toolbar lets you access remote file operations: + +:::image type="content" source="media/remote-file-explorer-toolbar.png" alt-text="Screenshot of the Remote File Explorer toolbar." ::: + +The highlighted buttons are, from left to right: + +- **+**: Create a new Remote Explorer window. +- **Home**: Go to the `$HOME` directory of the currently signed-in user on the remote machine. +- **Settings**: Open the settings for the **Remote File Explorer**. +- **Upload Files**: Upload files from your local machine to the remote machine. +- **Upload Folder**: Upload a folder from your local machine to the remote machine. +- **Download Item**: Download a file or folder from the remote machine to your local machine. +- **Refresh Item**: Refresh the view of the selected item. +- **Rename Item**: Rename a file or folder on the remote machine. +- **Delete Item**: Delete a file or folder on the remote machine. +- **Search**: Search for files or folders on the remote machine. + +## Remote File Explorer settings + +To change the settings for the **Remote File Explorer**, select the **Settings** button on the toolbar. The **Remote File Explorer Settings** dialog opens with the following option: + +- **Enable Dynamic File Icons for Extension-less Files**: Shows icons based on file type by checking the mime-type. Useful for Linux files without extensions so that a correct file icon is shown instead of a generic document icon. May impact performance. + +## See also + +- [The Remote File Explorer tool window of Visual Studio (video)](/shows/pure-virtual-cpp-2023/the-remote-file-explorer-tool-window-of-visual-studio) +- [Connection manager](connect-to-your-remote-linux-computer.md) +- [Create a CMake Linux project in Visual Studio](cmake-linux-project.md) \ No newline at end of file diff --git a/docs/linux/set-up-fips-compliant-secure-remote-linux-development.md b/docs/linux/set-up-fips-compliant-secure-remote-linux-development.md index fbfacf7a4f0..aa4ba4bf66e 100644 --- a/docs/linux/set-up-fips-compliant-secure-remote-linux-development.md +++ b/docs/linux/set-up-fips-compliant-secure-remote-linux-development.md @@ -2,6 +2,8 @@ title: "Set up FIPS-compliant secure remote Linux development" description: "How to set up a FIPS-compliant cryptographic connection between Visual Studio and a Linux machine for remote development." ms.date: 07/06/2022 +ms.topic: how-to +ms.custom: sfi-image-nochange --- # Set up FIPS-compliant secure remote Linux development @@ -128,7 +130,7 @@ You've successfully set up `ssh`, created and deployed encryption keys, and test For more information on troubleshooting your connection, see [Connect to your remote Linux computer](connect-to-your-remote-linux-computer.md). -## Command-line utility for the Connection Manager +## Command-line utility for the Connection Manager **Visual Studio 2019 version 16.5 or later**: `ConnectionManager.exe` is a command-line utility to manage remote development connections outside of Visual Studio. It's useful for tasks such as provisioning a new development machine. Or, you can use it to set up Visual Studio for continuous integration. For examples and a complete reference to the ConnectionManager command, see [ConnectionManager reference](connectionmanager-reference.md). @@ -159,7 +161,7 @@ Microsoft blog post on [Why We're Not Recommending "FIPS mode" Anymore](https:// [SSH Server Configuration](https://www.ssh.com/ssh/sshd_config) -## See Also +## See also [Configure a Linux project](configure-a-linux-project.md)\ [Configure a Linux CMake project](cmake-linux-project.md)\ diff --git a/docs/linux/toc.yml b/docs/linux/toc.yml index 06e66952719..34c5c53245d 100644 --- a/docs/linux/toc.yml +++ b/docs/linux/toc.yml @@ -7,6 +7,8 @@ items: items: - name: Connect to your remote Linux computer href: ../linux/connect-to-your-remote-linux-computer.md + - name: Remote File Explorer + href: ../linux/remote-file-explorer.md - name: Set up FIPS-compliant secure remote Linux development href: ../linux/set-up-fips-compliant-secure-remote-linux-development.md - name: ConnectionManager reference diff --git a/docs/mfc/accessing-all-members-of-a-collection.md b/docs/mfc/accessing-all-members-of-a-collection.md index df7b900c87a..0cd39499410 100644 --- a/docs/mfc/accessing-all-members-of-a-collection.md +++ b/docs/mfc/accessing-all-members-of-a-collection.md @@ -4,6 +4,7 @@ title: "Accessing All Members of a Collection" ms.date: "11/04/2016" helpviewer_keywords: ["MFC, collections", "enumerations [MFC]", "enumerating collections [MFC]", "collections [MFC], accessing", "collection classes [MFC]", ", ", ", ", ", ", ", ", ", ", ", ", ", "] ms.assetid: 7bbae518-062e-4393-81f9-b22abd2e5f59 +ms.topic: how-to --- # Accessing All Members of a Collection diff --git a/docs/mfc/accessing-file-status.md b/docs/mfc/accessing-file-status.md index e6b649aa51d..f582a6558bc 100644 --- a/docs/mfc/accessing-file-status.md +++ b/docs/mfc/accessing-file-status.md @@ -4,6 +4,7 @@ title: "Accessing File Status" ms.date: "11/04/2016" helpviewer_keywords: ["files [MFC], status information", "examples [MFC], file status", "files [MFC], accessing", "file status [MFC]", "status of files [MFC]"] ms.assetid: 1b8891d6-eb0f-4037-a837-4928fe595222 +ms.topic: how-to --- # Accessing File Status diff --git a/docs/mfc/accessing-run-time-class-information.md b/docs/mfc/accessing-run-time-class-information.md index c8891bb05ce..e0981fe062a 100644 --- a/docs/mfc/accessing-run-time-class-information.md +++ b/docs/mfc/accessing-run-time-class-information.md @@ -4,6 +4,7 @@ title: "Accessing Run-Time Class Information" ms.date: "11/04/2016" helpviewer_keywords: ["CObject class [MFC], and RTTI", "CObject class [MFC], using IsKindOf method [MFC]", "run time [MFC], class information", "RUNTIME_CLASS macro [MFC]", "CObject class [MFC], using RUNTIME_CLASS macro [MFC]", "RTTI compiler option [MFC]", "CObject class [MFC], accessing run-time class information", "run time [MFC]", "IsKindOf method method [MFC]", "run-time class [MFC], accessing information", "classes [MFC], run-time class information", "run-time class [MFC]", "RUNTIME_CLASS macro, using"] ms.assetid: 3445a9af-0bd6-4496-95c3-aa59b964570b +ms.topic: how-to --- # Accessing Run-Time Class Information diff --git a/docs/mfc/accessing-the-embedded-month-calendar-control.md b/docs/mfc/accessing-the-embedded-month-calendar-control.md index 05c19058476..c8c09084768 100644 --- a/docs/mfc/accessing-the-embedded-month-calendar-control.md +++ b/docs/mfc/accessing-the-embedded-month-calendar-control.md @@ -4,6 +4,7 @@ title: "Accessing the Embedded Month Calendar Control" ms.date: "11/04/2016" helpviewer_keywords: ["DateTimePicker control [MFC], accessing month calendar", "CDateTimeCtrl class [MFC], accessing embedded control", "month calendar controls [MFC], embedded in date/time picker", "CMonthCalCtrl class [MFC], changing the font", "month calendar controls [MFC], changing the font", "DateTimePicker control [MFC]"] ms.assetid: 355e97ed-cf81-4df3-a2f8-9ddbbde93227 +ms.topic: concept-article --- # Accessing the Embedded Month Calendar Control diff --git a/docs/mfc/activation-verbs.md b/docs/mfc/activation-verbs.md index 5c97e74cb58..31e35ddfed5 100644 --- a/docs/mfc/activation-verbs.md +++ b/docs/mfc/activation-verbs.md @@ -1,9 +1,8 @@ --- -description: "Learn more about: Activation: Verbs" title: "Activation: Verbs" -ms.date: "11/04/2016" -helpviewer_keywords: ["verbs [MFC]", "OLE [MFC], activation", "edit verb [MFC]", "activation [MFC], verbs", "OLE [MFC], editing", "Primary verb [MFC]", "OLE activation {MFC]"] -ms.assetid: eb56ff23-1de8-43ad-abeb-dc7346ba7b70 +description: "Learn more about: Activation: Verbs" +ms.date: 11/04/2016 +helpviewer_keywords: ["verbs [MFC]", "OLE [MFC], activation", "edit verb [MFC]", "activation [MFC], verbs", "OLE [MFC], editing", "Primary verb [MFC]", "OLE activation [MFC]"] --- # Activation: Verbs diff --git a/docs/mfc/activex-control-containers-handling-events-from-an-activex-control.md b/docs/mfc/activex-control-containers-handling-events-from-an-activex-control.md index 5052a8c4c3d..90af06c7fc7 100644 --- a/docs/mfc/activex-control-containers-handling-events-from-an-activex-control.md +++ b/docs/mfc/activex-control-containers-handling-events-from-an-activex-control.md @@ -15,7 +15,7 @@ This article discusses using the **Properties** window (in **Class View**) to in > [!NOTE] > This article uses a dialog-based ActiveX control container project named Container and an embedded control named Circ as examples in the procedures and code. -Using the Events button in the **Properties** window (in **Class View**), you can create a map of events that can occur in your ActiveX control container application. This map, called an "event sink map,'' is created and maintained by Visual C++ when you add event handlers to the control container class. Each event handler, implemented with an event map entry, maps a specific event to a container event handler member function. This event handler function is called when the specified event is fired by the ActiveX control object. +Using the Events button in the **Properties** window (in **Class View**), you can create a map of events that can occur in your ActiveX control container application. This map, called an "event sink map,'' is created and maintained by Visual Studio when you add event handlers to the control container class. Each event handler, implemented with an event map entry, maps a specific event to a container event handler member function. This event handler function is called when the specified event is fired by the ActiveX control object. For more information on event sink maps, see [Event Sink Maps](reference/event-sink-maps.md) in the *Class Library Reference*. diff --git a/docs/mfc/activex-control-containers-using-controls-in-a-non-dialog-container.md b/docs/mfc/activex-control-containers-using-controls-in-a-non-dialog-container.md index 9c54a250016..5c203ddbf53 100644 --- a/docs/mfc/activex-control-containers-using-controls-in-a-non-dialog-container.md +++ b/docs/mfc/activex-control-containers-using-controls-in-a-non-dialog-container.md @@ -7,7 +7,7 @@ ms.assetid: 46f195b0-b8ca-4409-8cca-fbfaf2c9ab9f --- # ActiveX Control Containers: Using Controls in a Non-Dialog Container -In some applications, such as an SDI or MDI application, you will want to embed a control in a window of the application. The **Create** member function of the wrapper class, inserted by Visual C++, can create an instance of the control dynamically, without the need for a dialog box. +In some applications, such as an SDI or MDI application, you will want to embed a control in a window of the application. The **Create** member function of the wrapper class, inserted by Visual Studio, can create an instance of the control dynamically, without the need for a dialog box. The **Create** member function has the following parameters: diff --git a/docs/mfc/activex-control-containers-viewing-and-modifying-control-properties.md b/docs/mfc/activex-control-containers-viewing-and-modifying-control-properties.md index a9609867536..2cd819edbd2 100644 --- a/docs/mfc/activex-control-containers-viewing-and-modifying-control-properties.md +++ b/docs/mfc/activex-control-containers-viewing-and-modifying-control-properties.md @@ -7,7 +7,7 @@ ms.assetid: 14ce5152-742b-4e0d-a9ab-c7b456e32918 --- # ActiveX Control Containers: Viewing and Modifying Control Properties -When you insert an ActiveX control into a project, it is useful to view and change the properties supported by the ActiveX control. This article discusses how to use the Visual C++ resource editor to do this. +When you insert an ActiveX control into a project, it is useful to view and change the properties supported by the ActiveX control. This article discusses how to use the Visual Studio resource editor to do this. If your ActiveX control container application uses embedded controls, you can view and modify the control's properties while in the resource editor. You can also use the resource editor to set property values during design time. The resource editor then automatically saves these values in the project's resource file. Any instance of the control will then have its properties initialized to these values. diff --git a/docs/mfc/activex-control-containers.md b/docs/mfc/activex-control-containers.md index 0201f13955c..25f68beb623 100644 --- a/docs/mfc/activex-control-containers.md +++ b/docs/mfc/activex-control-containers.md @@ -20,7 +20,7 @@ Control containers typically take two forms in a project: The ActiveX control container interacts with the control via exposed [methods](mfc-activex-controls-methods.md) and [properties](mfc-activex-controls-properties.md). These methods and properties, which can be accessed and modified by the control container, are accessed through a wrapper class in the ActiveX control container project. The embedded ActiveX control can also interact with the container by firing (sending) [events](mfc-activex-controls-events.md) to notify the container that an action has occurred. The control container can choose to act upon these notifications or not. -Additional articles discuss several topics, from creating an ActiveX control container project to basic implementation issues related to ActiveX control containers built with Visual C++: +Additional articles discuss several topics, from creating an ActiveX control container project to basic implementation issues related to ActiveX control containers built with Visual Studio: - [Creating an MFC ActiveX Control Container](reference/creating-an-mfc-activex-control-container.md) @@ -42,7 +42,7 @@ Additional articles discuss several topics, from creating an ActiveX control con For more information about using ActiveX controls in a dialog box, see the [Dialog Editor](../windows/dialog-editor.md) topics. -For a list of articles that explain the details of developing ActiveX controls using Visual C++ and the MFC ActiveX control classes, see [MFC ActiveX controls](mfc-activex-controls.md). The articles are grouped by functional categories. +For a list of articles that explain the details of developing ActiveX controls using Visual Studio and the MFC ActiveX control classes, see [MFC ActiveX controls](mfc-activex-controls.md). The articles are grouped by functional categories. ## See also diff --git a/docs/mfc/activex-controls.md b/docs/mfc/activex-controls.md index af9ca221c6c..a2beb263314 100644 --- a/docs/mfc/activex-controls.md +++ b/docs/mfc/activex-controls.md @@ -7,7 +7,7 @@ ms.assetid: 52aaec4d-3889-402e-b57d-758078f8ac57 --- # ActiveX Controls -In Visual C++ you can create ActiveX controls using MFC or ATL. +In Visual Studio you can create ActiveX controls using MFC or ATL. >[!IMPORTANT] > ActiveX is a legacy technology that should not be used for new development. Many capabilities of ActiveX controls can be performed in a simpler and much more secure way with modern technologies such as HTML5 and JavaScript, modern browser extensions, or WebAssembly modules. For more information, see [A break from the past, part 2: Saying goodbye to ActiveX, VBScript, attachEvent](https://blogs.windows.com/msedgedev/2015/05/06/a-break-from-the-past-part-2-saying-goodbye-to-activex-vbscript-attachevent/) and [Native Messaging](/microsoft-edge/extensions/guides/native-messaging) and [Microsoft Edge extensions](/microsoft-edge/extensions) and [WebAssembly](https://webassembly.org/). diff --git a/docs/mfc/adding-columns-to-the-control-report-view.md b/docs/mfc/adding-columns-to-the-control-report-view.md index a2bf092bca5..829a912284b 100644 --- a/docs/mfc/adding-columns-to-the-control-report-view.md +++ b/docs/mfc/adding-columns-to-the-control-report-view.md @@ -4,6 +4,7 @@ title: "Adding Columns to the Control (Report View)" ms.date: "11/04/2016" helpviewer_keywords: ["CListCtrl class [MFC], adding columns", "report view in CListCtrl class [MFC]", "views [MFC], report", "columns [MFC], adding to CListCtrl", "CListCtrl class [MFC], report view"] ms.assetid: 7392c0d7-f8a5-4e7b-9ae7-b53dc9dd80ae +ms.topic: concept-article --- # Adding Columns to the Control (Report View) diff --git a/docs/mfc/adding-controls-by-hand.md b/docs/mfc/adding-controls-by-hand.md index 74ae5dee489..8945ca7e2a3 100644 --- a/docs/mfc/adding-controls-by-hand.md +++ b/docs/mfc/adding-controls-by-hand.md @@ -4,6 +4,7 @@ title: "Adding Controls By Hand" ms.date: "11/04/2016" helpviewer_keywords: ["Windows common controls [MFC], adding", "dialog box controls [MFC], adding to dialog boxes", "controlling input focus", "input focus control", "focus, controlling input [MFC]", "controls [MFC], adding to dialog boxes", "common controls [MFC], adding"] ms.assetid: bc843e59-0c51-4b5b-8bf2-343f716469d2 +ms.topic: concept-article --- # Adding Controls By Hand diff --git a/docs/mfc/adding-controls-to-a-property-sheet.md b/docs/mfc/adding-controls-to-a-property-sheet.md index b11b5c5177d..f9fd7130061 100644 --- a/docs/mfc/adding-controls-to-a-property-sheet.md +++ b/docs/mfc/adding-controls-to-a-property-sheet.md @@ -4,6 +4,7 @@ title: "Adding Controls to a Property Sheet" ms.date: "11/04/2016" helpviewer_keywords: ["controls [MFC], adding to property sheets", "property sheets, adding controls"] ms.assetid: 24ad4c0b-c1db-4850-b9f0-34aae8d74571 +ms.topic: concept-article --- # Adding Controls to a Property Sheet diff --git a/docs/mfc/adding-items-to-the-control.md b/docs/mfc/adding-items-to-the-control.md index 4f98db97a09..9019df5d8f5 100644 --- a/docs/mfc/adding-items-to-the-control.md +++ b/docs/mfc/adding-items-to-the-control.md @@ -4,6 +4,7 @@ title: "Adding Items to the Control" ms.date: "11/04/2016" helpviewer_keywords: ["CListCtrl class [MFC], adding items"] ms.assetid: 715994bd-340d-4ad2-9882-411654137830 +ms.topic: concept-article --- # Adding Items to the Control diff --git a/docs/mfc/adding-items-to-the-header-control.md b/docs/mfc/adding-items-to-the-header-control.md index 6b7b7469978..ad9b3d20dc5 100644 --- a/docs/mfc/adding-items-to-the-header-control.md +++ b/docs/mfc/adding-items-to-the-header-control.md @@ -4,6 +4,7 @@ title: "Adding Items to the Header Control" ms.date: "11/04/2016" helpviewer_keywords: ["controls [MFC], header", "CHeaderCtrl class [MFC], adding items", "header controls [MFC], adding items to"] ms.assetid: 2e9a28b1-7302-4a93-8037-c5a4183e589a +ms.topic: how-to --- # Adding Items to the Header Control diff --git a/docs/mfc/adding-multiple-views-to-a-single-document.md b/docs/mfc/adding-multiple-views-to-a-single-document.md index 1f808c9a0e8..b8e7fd427b4 100644 --- a/docs/mfc/adding-multiple-views-to-a-single-document.md +++ b/docs/mfc/adding-multiple-views-to-a-single-document.md @@ -4,6 +4,7 @@ title: "Adding Multiple Views to a Single Document" ms.date: "11/04/2016" helpviewer_keywords: ["multiple views [MFC], SDI applications", "documents [MFC], multiple views", "single document interface (SDI), adding views", "views [MFC], SDI applications"] ms.assetid: 86d0c134-01d5-429c-b672-36cfb956dc01 +ms.topic: concept-article --- # Adding Multiple Views to a Single Document diff --git a/docs/mfc/adding-tabs-to-a-tab-control.md b/docs/mfc/adding-tabs-to-a-tab-control.md index c0d93509083..b4312763c36 100644 --- a/docs/mfc/adding-tabs-to-a-tab-control.md +++ b/docs/mfc/adding-tabs-to-a-tab-control.md @@ -4,6 +4,7 @@ title: "Adding Tabs to a Tab Control" ms.date: "11/04/2016" helpviewer_keywords: ["tab controls [MFC], adding tabs", "putting tabs on CTabCtrls [MFC]", "CTabCtrl class [MFC], adding tabs", "tabs [MFC], adding to CTabCtrl class [MFC]"] ms.assetid: 7f3d9340-e3c7-4c71-9912-be57534ecc78 +ms.topic: how-to --- # Adding Tabs to a Tab Control diff --git a/docs/mfc/allocating-and-deallocating-window-memory.md b/docs/mfc/allocating-and-deallocating-window-memory.md index f3992156864..5e5645446a9 100644 --- a/docs/mfc/allocating-and-deallocating-window-memory.md +++ b/docs/mfc/allocating-and-deallocating-window-memory.md @@ -4,6 +4,7 @@ title: "Allocating and Deallocating Window Memory" ms.date: "11/04/2016" helpviewer_keywords: ["memory allocation, window objects", "memory deallocation", "storage for window objects [MFC]", "memory deallocation, window memory", "window objects [MFC], deallocating memory for", "storage for window objects [MFC], allocating"] ms.assetid: 7c962539-8461-4846-b5ca-fe3b15c313dc +ms.topic: concept-article --- # Allocating and Deallocating Window Memory diff --git a/docs/mfc/allocating-gdi-resources.md b/docs/mfc/allocating-gdi-resources.md index 1a1e83e8231..d9b1a739458 100644 --- a/docs/mfc/allocating-gdi-resources.md +++ b/docs/mfc/allocating-gdi-resources.md @@ -4,6 +4,7 @@ title: "Allocating GDI Resources" ms.date: "06/03/2019" helpviewer_keywords: ["resources [MFC], printing", "GDI objects [MFC], allocating during printing", "printing [MFC], allocating GDI resources"] ms.assetid: cef7e94d-5a27-4aea-a9ee-8369fc895d3a +ms.topic: concept-article --- # Allocating GDI Resources diff --git a/docs/mfc/alternatives-to-the-document-view-architecture.md b/docs/mfc/alternatives-to-the-document-view-architecture.md index 5254b76bd37..b89b6dbc905 100644 --- a/docs/mfc/alternatives-to-the-document-view-architecture.md +++ b/docs/mfc/alternatives-to-the-document-view-architecture.md @@ -22,7 +22,7 @@ To create an application that does not use the document/view architecture, clear > [!NOTE] > Dialog-based applications produced by the MFC Application Wizard do not use the document/view architecture, so the **Document/View architecture support** check box is disabled if you select the dialog application type. -The Visual C++ wizards, as well as the source and dialog editors, work with the generated application just as they would with any other Wizard-generated application. The application can support toolbars, scrollbars, and a status bar, and has an **About** box. Your application will not register any document templates, and it will not contain a document class. +The Visual Studio wizards, as well as the source and dialog editors, work with the generated application just as they would with any other Wizard-generated application. The application can support toolbars, scrollbars, and a status bar, and has an **About** box. Your application will not register any document templates, and it will not contain a document class. Note that your generated application has a view class, `CChildView`, derived from `CWnd`. MFC creates and positions one instance of the view class within the frame windows created by your application. MFC still enforces using a view window, because it simplifies positioning and managing the application's content. You can add painting code to the `OnPaint` member of this class. Your code should add scrollbars to the view rather than to the frame. diff --git a/docs/mfc/automation-clients-using-type-libraries.md b/docs/mfc/automation-clients-using-type-libraries.md index d5c6ccb2cc8..4c8eb1cb81e 100644 --- a/docs/mfc/automation-clients-using-type-libraries.md +++ b/docs/mfc/automation-clients-using-type-libraries.md @@ -14,9 +14,9 @@ This type information can be made known in several ways. The recommended way is For information on [MkTypLib](/windows/win32/Midl/differences-between-midl-and-mktyplib), see the Windows SDK. -Visual C++ can read a type-library file and create a dispatch class derived from [COleDispatchDriver](reference/coledispatchdriver-class.md). An object of that class has properties and operations duplicating those of the server object. Your application calls this object's properties and operations, and functionality inherited from `COleDispatchDriver` routes these calls to the OLE system, which in turn routes them to the server object. +Visual Studio can read a type-library file and create a dispatch class derived from [COleDispatchDriver](reference/coledispatchdriver-class.md). An object of that class has properties and operations duplicating those of the server object. Your application calls this object's properties and operations, and functionality inherited from `COleDispatchDriver` routes these calls to the OLE system, which in turn routes them to the server object. -Visual C++ automatically maintains this type-library file for you if you chose to include Automation when the project was created. As part of each build, the .tlb file will be built with MkTypLib. +Visual Studio automatically maintains this type-library file for you if you chose to include Automation when the project was created. As part of each build, the .tlb file will be built with MkTypLib. ### To create a dispatch class from a type-library (.tlb) file diff --git a/docs/mfc/automation-servers.md b/docs/mfc/automation-servers.md index 5a8b3b31a32..848c8d97b37 100644 --- a/docs/mfc/automation-servers.md +++ b/docs/mfc/automation-servers.md @@ -20,7 +20,7 @@ By exposing application functionality through a common, well-defined interface, ## Support for Automation Servers -Visual C++ and the MFC framework provide extensive support for Automation servers. They handle much of the overhead involved in making an Automation server, so you can focus your efforts on the functionality of your application. +Visual Studio and the MFC framework provide extensive support for Automation servers. They handle much of the overhead involved in making an Automation server, so you can focus your efforts on the functionality of your application. The framework's principal mechanism for supporting Automation is the dispatch map, a set of macros that expands into the declarations and calls needed to expose methods and properties for OLE. A typical dispatch map looks like this: diff --git a/docs/mfc/automation.md b/docs/mfc/automation.md index beca853d89d..9951fd3eff3 100644 --- a/docs/mfc/automation.md +++ b/docs/mfc/automation.md @@ -23,7 +23,7 @@ As another example, a word processor might expose its spell-checking functionali More important is the support Automation provides to users and solution providers. By exposing application functionality through a common, well-defined interface, Automation makes it possible to build comprehensive solutions in a single general programming language, such as Microsoft Visual Basic, instead of in diverse application-specific macro languages. -Many commercial applications, such as Microsoft Excel and Microsoft Visual C++, allow you to automate much of their functionality. For example, in Visual C++, you can write VBScript macros to automate builds, aspects of code editing, or debugging tasks. +Many commercial applications, such as Microsoft Excel and Visual Studio, allow you to automate much of their functionality. For example, in Visual Studio, you can write VBScript macros to automate builds, aspects of code editing, or debugging tasks. ## Passing Parameters in Automation diff --git a/docs/mfc/build-requirements-for-windows-vista-common-controls.md b/docs/mfc/build-requirements-for-windows-vista-common-controls.md index 57617f2e267..1120d633c74 100644 --- a/docs/mfc/build-requirements-for-windows-vista-common-controls.md +++ b/docs/mfc/build-requirements-for-windows-vista-common-controls.md @@ -4,6 +4,7 @@ title: "Build Requirements for Windows Common Controls" ms.date: "08/19/2019" helpviewer_keywords: ["Common Controls (MFC), build requirements", "Common Controls (MFC)"] ms.assetid: 025f7d55-55a2-4dcd-8f62-02424e3dcc04 +ms.topic: how-to --- # Build Requirements for Windows Common Controls diff --git a/docs/mfc/building-on-the-framework.md b/docs/mfc/building-on-the-framework.md index 1cd5cb09897..7b339c588e9 100644 --- a/docs/mfc/building-on-the-framework.md +++ b/docs/mfc/building-on-the-framework.md @@ -4,6 +4,7 @@ title: "Building on the Framework" ms.date: "11/04/2016" helpviewer_keywords: ["application-specific classes [MFC]", "application framework [MFC], building applications", "applications [MFC]", "MFC, application development"] ms.assetid: 883f0f19-866f-4221-8a3d-5607941dc8d0 +ms.topic: concept-article --- # Building on the Framework diff --git a/docs/mfc/bypassing-the-serialization-mechanism.md b/docs/mfc/bypassing-the-serialization-mechanism.md index ff376ebe45d..045392c70cc 100644 --- a/docs/mfc/bypassing-the-serialization-mechanism.md +++ b/docs/mfc/bypassing-the-serialization-mechanism.md @@ -4,6 +4,7 @@ title: "Bypassing the Serialization Mechanism" ms.date: "11/04/2016" helpviewer_keywords: ["archive objects [MFC]", "bypassing serialization", "archives [MFC], serialization", "serialization [MFC], bypassing", "archives [MFC]", "serialization [MFC], role of framework", "serialization [MFC], overriding"] ms.assetid: 48d4a279-b51c-4ba5-81cd-ed043312b582 +ms.topic: concept-article --- # Bypassing the Serialization Mechanism diff --git a/docs/mfc/changing-list-control-styles.md b/docs/mfc/changing-list-control-styles.md index 37be34f1043..3f64060811f 100644 --- a/docs/mfc/changing-list-control-styles.md +++ b/docs/mfc/changing-list-control-styles.md @@ -4,6 +4,7 @@ title: "Changing List Control Styles" ms.date: "11/04/2016" helpviewer_keywords: ["styles [MFC], CListCtrl", "CListCtrl class [MFC], styles", "CListCtrl class [MFC], changing styles"] ms.assetid: be74a005-0795-417c-9056-f6342aa74b26 +ms.topic: concept-article --- # Changing List Control Styles diff --git a/docs/mfc/changing-the-styles-of-a-window-created-by-mfc.md b/docs/mfc/changing-the-styles-of-a-window-created-by-mfc.md index 772b7b1a296..eb6d87a53c4 100644 --- a/docs/mfc/changing-the-styles-of-a-window-created-by-mfc.md +++ b/docs/mfc/changing-the-styles-of-a-window-created-by-mfc.md @@ -4,6 +4,7 @@ title: "Changing the Styles of a Window Created by MFC" ms.date: "11/04/2016" helpviewer_keywords: ["window styles [MFC]", "WS_OVERLAPPEDWINDOW macro [MFC]", "single document interface (SDI), changing window attributes", "MDI [MFC], window styles", "windows [MFC], MFC", "child windows [MFC], styles", "MFC, windows", "CFrameWnd class [MFC], window styles", "CREATESTRUCT macro [MFC]", "CMDIChildWnd class [MFC], changing window styles", "multidocument interface style", "PreCreateWindow method [MFC], window styles", "single document interface (SDI), style", "default window style", "defaults [MFC], window style", "PreCreateWindow method [MFC], changing window styles", "CMainFrame class [MFC]", "styles [MFC], windows"] ms.assetid: 77fa4f03-96b4-4687-9ade-41e46f7e4b0a +ms.topic: concept-article --- # Changing the Styles of a Window Created by MFC diff --git a/docs/mfc/class-library-overview.md b/docs/mfc/class-library-overview.md index f30e76f9ec3..514443b1180 100644 --- a/docs/mfc/class-library-overview.md +++ b/docs/mfc/class-library-overview.md @@ -5,6 +5,7 @@ ms.date: "09/17/2019" f1_keywords: ["vc.classes.mfc"] helpviewer_keywords: ["grouping MFC classes", "MFC, class library", "classes [MFC], MFC", "class libraries, MFC", "class libraries"] ms.assetid: 9b0e3152-ac39-4f52-91b4-f20aa3a674aa +ms.topic: concept-article --- # Class Library Overview diff --git a/docs/mfc/cleaning-up-documents-and-views.md b/docs/mfc/cleaning-up-documents-and-views.md index 9903e1e53d8..ff3d94b0ca2 100644 --- a/docs/mfc/cleaning-up-documents-and-views.md +++ b/docs/mfc/cleaning-up-documents-and-views.md @@ -4,6 +4,7 @@ title: "Cleaning Up Documents and Views" ms.date: "11/04/2016" helpviewer_keywords: ["views [MFC], cleaning up", "documents [MFC], cleaning up", "documents [MFC], closing"] ms.assetid: 0c454db2-3644-434d-9e53-8108a7aedfe1 +ms.topic: concept-article --- # Cleaning Up Documents and Views diff --git a/docs/mfc/clipboard-using-the-windows-clipboard.md b/docs/mfc/clipboard-using-the-windows-clipboard.md index 64d3123609b..e07d461aecc 100644 --- a/docs/mfc/clipboard-using-the-windows-clipboard.md +++ b/docs/mfc/clipboard-using-the-windows-clipboard.md @@ -19,7 +19,7 @@ The Cut, Copy, and Paste commands are only meaningful in certain contexts. The C The Microsoft Foundation Class Library does provide Clipboard support for text editing with the `CEdit` and `CEditView` classes. The OLE classes also simplify implementing Clipboard operations that involve OLE items. For more information on the OLE classes, see [Clipboard: Using the OLE Clipboard Mechanism](clipboard-using-the-ole-clipboard-mechanism.md). -Implementing other Edit menu commands, such as Undo (**ID_EDIT_UNDO**) and Redo (**ID_EDIT_REDO**), is also left to you. If your application does not support these commands, you can easily delete them from your resource file using the Visual C++ resource editors. +Implementing other Edit menu commands, such as Undo (**ID_EDIT_UNDO**) and Redo (**ID_EDIT_REDO**), is also left to you. If your application does not support these commands, you can easily delete them from your resource file using the Visual Studio resource editors. ## What do you want to know more about diff --git a/docs/mfc/closing-files.md b/docs/mfc/closing-files.md index 19a3e35aa51..2e72fde16a9 100644 --- a/docs/mfc/closing-files.md +++ b/docs/mfc/closing-files.md @@ -4,6 +4,7 @@ title: "Closing Files" ms.date: "11/04/2016" helpviewer_keywords: ["MFC, file operations", "files [MFC], closing"] ms.assetid: 8415a3a8-3c75-45b0-ac2a-d5385f49bdb3 +ms.topic: how-to --- # Closing Files diff --git a/docs/mfc/closing-the-dialog-box.md b/docs/mfc/closing-the-dialog-box.md index aa6b937c30c..38ab0e8290a 100644 --- a/docs/mfc/closing-the-dialog-box.md +++ b/docs/mfc/closing-the-dialog-box.md @@ -4,6 +4,7 @@ title: "Closing the Dialog Box" ms.date: "11/04/2016" helpviewer_keywords: ["MFC dialog boxes [MFC], closing", "dialog boxes [MFC], closing"] ms.assetid: 946f5675-c482-46a4-a5dd-34fe138ffae5 +ms.topic: concept-article --- # Closing the Dialog Box diff --git a/docs/mfc/cobject-class-frequently-asked-questions.md b/docs/mfc/cobject-class-frequently-asked-questions.md index 564c284e612..2689374466d 100644 --- a/docs/mfc/cobject-class-frequently-asked-questions.md +++ b/docs/mfc/cobject-class-frequently-asked-questions.md @@ -4,6 +4,7 @@ title: "CObject Class: Frequently Asked Questions" ms.date: "11/04/2016" helpviewer_keywords: ["CObject class [MFC], FAQ"] ms.assetid: 809a8b99-a2f8-4e16-8b4b-023c94f4125c +ms.topic: faq --- # CObject Class: Frequently Asked Questions diff --git a/docs/mfc/codesnippet/CPP/accessing-the-embedded-month-calendar-control_2.cpp b/docs/mfc/codesnippet/CPP/accessing-the-embedded-month-calendar-control_2.cpp index 240dd065e73..fbc30334bf0 100644 --- a/docs/mfc/codesnippet/CPP/accessing-the-embedded-month-calendar-control_2.cpp +++ b/docs/mfc/codesnippet/CPP/accessing-the-embedded-month-calendar-control_2.cpp @@ -1,4 +1,3 @@ - //create and initialize the font to be used LOGFONT logFont = {0}; logFont.lfHeight = -12; diff --git a/docs/mfc/codesnippet/CPP/activex-control-containers-using-controls-in-a-non-dialog-container_3.h b/docs/mfc/codesnippet/CPP/activex-control-containers-using-controls-in-a-non-dialog-container_3.h index b28bf3a66d0..bdd7ac78c82 100644 --- a/docs/mfc/codesnippet/CPP/activex-control-containers-using-controls-in-a-non-dialog-container_3.h +++ b/docs/mfc/codesnippet/CPP/activex-control-containers-using-controls-in-a-non-dialog-container_3.h @@ -3,5 +3,4 @@ CCirc m_myCtl; public: afx_msg void OnViewCircdlg(); -} -; \ No newline at end of file +}; diff --git a/docs/mfc/codesnippet/CPP/cbitmapbutton-class_3.cpp b/docs/mfc/codesnippet/CPP/cbitmapbutton-class_3.cpp index 5bb7063b2af..a54aeb90492 100644 --- a/docs/mfc/codesnippet/CPP/cbitmapbutton-class_3.cpp +++ b/docs/mfc/codesnippet/CPP/cbitmapbutton-class_3.cpp @@ -1,4 +1,3 @@ - // Create the bitmap button (must include the BS_OWNERDRAW style). pmyButton->Create(NULL, WS_CHILD | WS_VISIBLE | BS_OWNERDRAW, CRect(10, 10, 100, 100), pParentWnd, 1); diff --git a/docs/mfc/codesnippet/CPP/cdialog-class_2.cpp b/docs/mfc/codesnippet/CPP/cdialog-class_2.cpp index 3c7a6357e16..e3100864ebd 100644 --- a/docs/mfc/codesnippet/CPP/cdialog-class_2.cpp +++ b/docs/mfc/codesnippet/CPP/cdialog-class_2.cpp @@ -26,5 +26,5 @@ void CMyDialog::OnMenuShowAboutDialog() default: // Do something break; - }; + } } \ No newline at end of file diff --git a/docs/mfc/codesnippet/CPP/clistbox-class_23.cpp b/docs/mfc/codesnippet/CPP/clistbox-class_23.cpp index 7301b4da087..f7c839534b6 100644 --- a/docs/mfc/codesnippet/CPP/clistbox-class_23.cpp +++ b/docs/mfc/codesnippet/CPP/clistbox-class_23.cpp @@ -1,6 +1,6 @@ -// Initialize the storage of the list box to be 256 strings with -// about 10 characters per string, performance improvement. -int n = m_myListBox.InitStorage(256, 16 * sizeof(TCHAR)); +// Reserve space in the list box for 256 additional strings with +// about 15 characters per string. +int n = m_myListBox.InitStorage(256, 256 * (15 + 1) * sizeof(TCHAR)); ASSERT(n != LB_ERRSPACE); // Add 256 items to the list box. diff --git a/docs/mfc/codesnippet/CPP/cmultidoctemplate-class_2.cpp b/docs/mfc/codesnippet/CPP/cmultidoctemplate-class_2.cpp index 0583ae03fbc..63f44247ad4 100644 --- a/docs/mfc/codesnippet/CPP/cmultidoctemplate-class_2.cpp +++ b/docs/mfc/codesnippet/CPP/cmultidoctemplate-class_2.cpp @@ -23,7 +23,7 @@ return FALSE; // After the following call, MFC is aware of the doc // template and will free it when the application is // shut down. The doc templates known to MFC will -// automatically be used when CWinApp:OnFileOpen() +// automatically be used when CWinApp::OnFileOpen() // or CWinApp::OnFileNew() are called. AddDocTemplate(pDocTemplate); \ No newline at end of file diff --git a/docs/mfc/codesnippet/CPP/connection-maps_3.cpp b/docs/mfc/codesnippet/CPP/connection-maps_3.cpp index cffe2a236b3..cab527dac6f 100644 --- a/docs/mfc/codesnippet/CPP/connection-maps_3.cpp +++ b/docs/mfc/codesnippet/CPP/connection-maps_3.cpp @@ -10,4 +10,4 @@ IUnknown* pUnkSink = mysink.GetInterface(&iid); //pUnkSrc is IUnknown of server obtained by CoCreateInstance(). //dwCookie is a cookie identifying the connection, and is needed //to terminate this connection. -AfxConnectionAdvise(pUnkSrc, IID_ISampleSink, pUnkSink, FALSE, &dwCookie); \ No newline at end of file +AfxConnectionAdvise(pUnkSrc, IID_ISampleSink, pUnkSink, TRUE, &dwCookie); \ No newline at end of file diff --git a/docs/mfc/codesnippet/CPP/connection-maps_4.cpp b/docs/mfc/codesnippet/CPP/connection-maps_4.cpp index 7fd1ae018ac..8e5eed54a3a 100644 --- a/docs/mfc/codesnippet/CPP/connection-maps_4.cpp +++ b/docs/mfc/codesnippet/CPP/connection-maps_4.cpp @@ -6,4 +6,4 @@ IUnknown* pUnkSink = mysink.GetInterface(&iid); //Terminate a connection between source and sink. //pUnkSrc is IUnknown of server obtained by CoCreateInstance(). //dwCookie is a value obtained through AfxConnectionAdvise(). -AfxConnectionUnadvise(pUnkSrc, IID_ISampleSink, pUnkSink, FALSE, dwCookie); \ No newline at end of file +AfxConnectionUnadvise(pUnkSrc, IID_ISampleSink, pUnkSink, TRUE, dwCookie); \ No newline at end of file diff --git a/docs/mfc/codesnippet/CPP/csingledoctemplate-class_2.cpp b/docs/mfc/codesnippet/CPP/csingledoctemplate-class_2.cpp index e8114302897..bcd02c9f95b 100644 --- a/docs/mfc/codesnippet/CPP/csingledoctemplate-class_2.cpp +++ b/docs/mfc/codesnippet/CPP/csingledoctemplate-class_2.cpp @@ -25,6 +25,6 @@ return FALSE; // After the following call, MFC is aware of the doc // template and will free it when the application is // shut down. The doc templates known to MFC will -// automatically be used when CWinApp:OnFileOpen() or +// automatically be used when CWinApp::OnFileOpen() or // CWinApp::OnFileNew() are called. AddDocTemplate(pDocTemplate); \ No newline at end of file diff --git a/docs/mfc/command-ids.md b/docs/mfc/command-ids.md index aacb5c805f9..d5508f8a545 100644 --- a/docs/mfc/command-ids.md +++ b/docs/mfc/command-ids.md @@ -11,7 +11,7 @@ A command is fully described by its command ID alone (encoded in the **WM_COMMAN For example, a Clear All item in the Edit menu might be assigned an ID such as **ID_EDIT_CLEAR_ALL**. The class library predefines some IDs, particularly for commands that the framework handles itself, such as **ID_EDIT_CLEAR_ALL** or **ID_FILE_OPEN**. You will create other command IDs yourself. -When you create your own menus in the Visual C++ menu editor, it is a good idea to follow the class library's naming convention as illustrated by **ID_FILE_OPEN**. [Standard Commands](standard-commands.md) explains the standard commands defined by the class library. +When you create your own menus in the Visual Studio menu editor, it is a good idea to follow the class library's naming convention as illustrated by **ID_FILE_OPEN**. [Standard Commands](standard-commands.md) explains the standard commands defined by the class library. ## See also diff --git a/docs/mfc/command-routing-illustration.md b/docs/mfc/command-routing-illustration.md index 53adb566465..29ae9a7f00a 100644 --- a/docs/mfc/command-routing-illustration.md +++ b/docs/mfc/command-routing-illustration.md @@ -4,6 +4,7 @@ title: "Command Routing Illustration" ms.date: "11/04/2016" helpviewer_keywords: ["MFC, command routing", "command handling [MFC], routing commands", "command routing [MFC], OnCmdMsg handler"] ms.assetid: 4b7b4741-565f-4878-b076-fd85c670f87f +ms.topic: how-to --- # Command Routing Illustration diff --git a/docs/mfc/command-routing.md b/docs/mfc/command-routing.md index edb23094cdc..a3514eb4e28 100644 --- a/docs/mfc/command-routing.md +++ b/docs/mfc/command-routing.md @@ -4,6 +4,7 @@ title: "Command Routing" ms.date: "09/06/2019" helpviewer_keywords: ["MFC, command routing", "command handling [MFC], routing commands", "handlers [MFC]", "handlers, command [MFC]", "command routing"] ms.assetid: 9393a956-bdd4-47c5-9013-dbd680433f93 +ms.topic: how-to --- # Command Routing diff --git a/docs/mfc/communicating-with-a-tree-control.md b/docs/mfc/communicating-with-a-tree-control.md index 621df475e70..959c9f1fbd6 100644 --- a/docs/mfc/communicating-with-a-tree-control.md +++ b/docs/mfc/communicating-with-a-tree-control.md @@ -4,6 +4,7 @@ title: "Communicating with a Tree Control" ms.date: "11/04/2016" helpviewer_keywords: ["tree controls [MFC], communicating with", "CTreeCtrl class [MFC], calling member functions", "communications, tree controls", "tree controls"] ms.assetid: 680ad9ee-b11f-452d-93fa-501ca7d7e069 +ms.topic: concept-article --- # Communicating with a Tree Control diff --git a/docs/mfc/containers-for-activex-controls.md b/docs/mfc/containers-for-activex-controls.md index 6f6926c793a..8b5adeba287 100644 --- a/docs/mfc/containers-for-activex-controls.md +++ b/docs/mfc/containers-for-activex-controls.md @@ -7,7 +7,7 @@ ms.assetid: 5ff0bf37-07f4-49aa-ad9c-c63d3756243a --- # Containers for ActiveX Controls -You can use ActiveX controls developed in Visual C++ in other applications, as long as they support ActiveX control containment. A number of Microsoft applications, beginning with the versions listed, support ActiveX control containment. +You can use ActiveX controls developed in Visual Studio in other applications, as long as they support ActiveX control containment. A number of Microsoft applications, beginning with the versions listed, support ActiveX control containment. >[!IMPORTANT] > ActiveX is a legacy technology that should not be used for new development. For more information about modern technologies that supersede ActiveX, see [ActiveX Controls](activex-controls.md). diff --git a/docs/mfc/controls-mfc.md b/docs/mfc/controls-mfc.md index fda1eeccf12..2fe0a205f76 100644 --- a/docs/mfc/controls-mfc.md +++ b/docs/mfc/controls-mfc.md @@ -17,7 +17,7 @@ Controls are objects that users can interact with to enter or manipulate data. T ## Windows Common Controls -The Windows operating system has always provided a number of Windows common controls. These control objects are programmable, and the Visual C++ dialog editor supports adding them to your dialog boxes. The Microsoft Foundation Class Library (MFC) supplies classes that encapsulate each of these controls, as shown in the table [Windows Common Controls and MFC Classes](#_core_windows_common_controls_and_mfc_classes). (Some items in the table have related topics that describe them further. For controls that lack topics, see the documentation for the MFC class.) +The Windows operating system has always provided a number of Windows common controls. These control objects are programmable, and the Visual Studio dialog editor supports adding them to your dialog boxes. The Microsoft Foundation Class Library (MFC) supplies classes that encapsulate each of these controls, as shown in the table [Windows Common Controls and MFC Classes](#_core_windows_common_controls_and_mfc_classes). (Some items in the table have related topics that describe them further. For controls that lack topics, see the documentation for the MFC class.) Class [CWnd](reference/cwnd-class.md) is the base class of all window classes, including all of the control classes. diff --git a/docs/mfc/creating-a-ctoolbarctrl-object.md b/docs/mfc/creating-a-ctoolbarctrl-object.md index 8e8af2739ef..a474106b412 100644 --- a/docs/mfc/creating-a-ctoolbarctrl-object.md +++ b/docs/mfc/creating-a-ctoolbarctrl-object.md @@ -4,6 +4,7 @@ title: "Creating a CToolBarCtrl Object" ms.date: "11/04/2016" helpviewer_keywords: ["toolbar controls [MFC], creating", "CToolBarCtrl class [MFC], creating toolbars"] ms.assetid: a4f6bf0c-0195-4dbf-a09e-aee503e19dc3 +ms.topic: how-to --- # Creating a CToolBarCtrl Object diff --git a/docs/mfc/creating-a-dialog-class-with-code-wizards.md b/docs/mfc/creating-a-dialog-class-with-code-wizards.md index 372dc65cd7b..b57a8a37d9f 100644 --- a/docs/mfc/creating-a-dialog-class-with-code-wizards.md +++ b/docs/mfc/creating-a-dialog-class-with-code-wizards.md @@ -4,6 +4,7 @@ title: "Creating a Dialog Class with Code Wizards" ms.date: "11/04/2016" helpviewer_keywords: ["dialog boxes [MFC], creating", "MFC dialog boxes, creating", "code wizards", "dialog classes [MFC], creating"] ms.assetid: a7157b9d-f1a8-4381-a4cf-180cd2c7f1b2 +ms.topic: concept-article --- # Creating a Dialog Class with Code Wizards diff --git a/docs/mfc/creating-a-modeless-property-sheet.md b/docs/mfc/creating-a-modeless-property-sheet.md index 83f9ef25951..923076c45a7 100644 --- a/docs/mfc/creating-a-modeless-property-sheet.md +++ b/docs/mfc/creating-a-modeless-property-sheet.md @@ -4,6 +4,7 @@ title: "Creating a Modeless Property Sheet" ms.date: "11/04/2016" helpviewer_keywords: ["modeless property sheets", "property sheets, modeless", "Create method [MFC], property sheets"] ms.assetid: eafd8a92-cc67-4a69-a5fb-742c920d1ae8 +ms.topic: concept-article --- # Creating a Modeless Property Sheet diff --git a/docs/mfc/creating-a-rebar-control.md b/docs/mfc/creating-a-rebar-control.md index 8aec855df37..ecbd59c97a3 100644 --- a/docs/mfc/creating-a-rebar-control.md +++ b/docs/mfc/creating-a-rebar-control.md @@ -4,6 +4,7 @@ title: "Creating a Rebar Control" ms.date: "11/04/2016" helpviewer_keywords: ["rebar controls [MFC], creating", "CReBarCtrl class [MFC], creating"] ms.assetid: 0a012e08-772b-4f6a-af86-7cb651d11d3e +ms.topic: how-to --- # Creating a Rebar Control diff --git a/docs/mfc/creating-an-active-document-container-application.md b/docs/mfc/creating-an-active-document-container-application.md index f0cd926a641..c1ef6e9ac2d 100644 --- a/docs/mfc/creating-an-active-document-container-application.md +++ b/docs/mfc/creating-an-active-document-container-application.md @@ -4,6 +4,7 @@ title: "Creating an Active Document Container Application" ms.date: "11/04/2016" helpviewer_keywords: ["active documents [MFC], containers", "containers [MFC], active document", "active document containers [MFC], creating", "MFC COM, active document containment", "applications [MFC], active document container"] ms.assetid: 14e2d022-a6c5-4249-8712-706b0f4433f7 +ms.topic: how-to --- # Creating an Active Document Container Application diff --git a/docs/mfc/creating-an-extended-combo-box-control.md b/docs/mfc/creating-an-extended-combo-box-control.md index 9f266d75164..c39f606ba2e 100644 --- a/docs/mfc/creating-an-extended-combo-box-control.md +++ b/docs/mfc/creating-an-extended-combo-box-control.md @@ -4,6 +4,7 @@ title: "Creating an Extended Combo Box Control" ms.date: "11/04/2016" helpviewer_keywords: ["extended combo boxes", "CComboBoxEx class [MFC], creating extended combo box controls", "extended combo boxes [MFC], creating"] ms.assetid: a964267e-97b6-4e77-9f89-55bb5c68913f +ms.topic: how-to --- # Creating an Extended Combo Box Control diff --git a/docs/mfc/creating-and-displaying-dialog-boxes.md b/docs/mfc/creating-and-displaying-dialog-boxes.md index 918e0c938bd..233faf62b31 100644 --- a/docs/mfc/creating-and-displaying-dialog-boxes.md +++ b/docs/mfc/creating-and-displaying-dialog-boxes.md @@ -4,6 +4,7 @@ title: "Creating and Displaying Dialog Boxes" ms.date: "11/04/2016" helpviewer_keywords: ["modal dialog boxes [MFC], creating", "opening dialog boxes", "modeless dialog boxes [MFC], creating", "MFC dialog boxes [MFC], creating", "MFC dialog boxes [MFC], displaying"] ms.assetid: 1c5219ee-8b46-44bc-9708-83705d4f248b +ms.topic: concept-article --- # Creating and Displaying Dialog Boxes diff --git a/docs/mfc/creating-document-frame-windows.md b/docs/mfc/creating-document-frame-windows.md index b79b488838c..5c2f43a082b 100644 --- a/docs/mfc/creating-document-frame-windows.md +++ b/docs/mfc/creating-document-frame-windows.md @@ -4,6 +4,7 @@ title: "Creating Document Frame Windows" ms.date: "11/04/2016" helpviewer_keywords: ["frame windows [MFC], creating", "document templates [MFC], and document frame windows", "windows [MFC], creating", "runtime, class information", "run-time class [MFC], and document frame window creation", "document frame windows [MFC], creating", "MFC, frame windows"] ms.assetid: 8671e239-b76f-4dea-afa8-7024e6e58ff5 +ms.topic: concept-article --- # Creating Document Frame Windows diff --git a/docs/mfc/creating-modal-dialog-boxes.md b/docs/mfc/creating-modal-dialog-boxes.md index 269f02812d0..6275a7e461f 100644 --- a/docs/mfc/creating-modal-dialog-boxes.md +++ b/docs/mfc/creating-modal-dialog-boxes.md @@ -4,6 +4,7 @@ title: "Creating Modal Dialog Boxes" ms.date: "11/04/2016" helpviewer_keywords: ["modal dialog boxes [MFC], creating", "MFC dialog boxes [MFC], creating", "MFC dialog boxes [MFC], modal"] ms.assetid: 26c7a68c-79f6-4862-a5a8-6024984644d2 +ms.topic: concept-article --- # Creating Modal Dialog Boxes diff --git a/docs/mfc/creating-modeless-dialog-boxes.md b/docs/mfc/creating-modeless-dialog-boxes.md index 44fdf5e7405..92236e26218 100644 --- a/docs/mfc/creating-modeless-dialog-boxes.md +++ b/docs/mfc/creating-modeless-dialog-boxes.md @@ -4,6 +4,7 @@ title: "Creating Modeless Dialog Boxes" ms.date: "11/04/2016" helpviewer_keywords: ["MFC dialog boxes [MFC], modeless", "modeless dialog boxes [MFC], creating", "MFC dialog boxes [MFC], creating"] ms.assetid: 70d78c7f-3d40-477b-9f78-0f33c359f88b +ms.topic: concept-article --- # Creating Modeless Dialog Boxes diff --git a/docs/mfc/creating-new-documents-windows-and-views.md b/docs/mfc/creating-new-documents-windows-and-views.md index 2137a6f149a..c5a9792921f 100644 --- a/docs/mfc/creating-new-documents-windows-and-views.md +++ b/docs/mfc/creating-new-documents-windows-and-views.md @@ -4,6 +4,7 @@ title: "Creating New Documents, Windows, and Views" ms.date: "11/19/2018" helpviewer_keywords: ["MDI [MFC], creating windows", "window objects [MFC], creating", "objects [MFC], creating document objects", "MFC default objects", "frame windows [MFC], creating", "windows [MFC], MDI", "MFC, documents", "view objects [MFC], creating", "windows [MFC], creating", "overriding, default view behavior", "views [MFC], initializing", "customizing MFC default objects", "MFC, frame windows", "MFC, views", "MDI [MFC], frame windows", "child windows [MFC], creating MDI", "view objects [MFC]", "document objects [MFC], creating", "MFC default objects [MFC], customizing", "views [MFC], overriding default behavior", "initializing views [MFC]"] ms.assetid: 88aa1f5f-2078-4603-b16b-a2b4c7b4a2a3 +ms.topic: concept-article --- # Creating New Documents, Windows, and Views diff --git a/docs/mfc/creating-stack-and-queue-collections.md b/docs/mfc/creating-stack-and-queue-collections.md index 36c7c40c713..e0e1c818970 100644 --- a/docs/mfc/creating-stack-and-queue-collections.md +++ b/docs/mfc/creating-stack-and-queue-collections.md @@ -4,6 +4,7 @@ title: "Creating Stack and Queue Collections" ms.date: "11/04/2016" helpviewer_keywords: ["MFC collection classes [MFC], stack collections", "collections, stack", "stack", "collection classes [MFC], creating", "queue collections", "MFC collection classes [MFC], queue collections", "stack collections", "collections, queue"] ms.assetid: 3c7bc198-35f0-4fc3-aaed-6005a0f22638 +ms.topic: how-to --- # Creating Stack and Queue Collections diff --git a/docs/mfc/creating-the-date-and-time-picker-control.md b/docs/mfc/creating-the-date-and-time-picker-control.md index 7e9b2348967..1c30cd048b0 100644 --- a/docs/mfc/creating-the-date-and-time-picker-control.md +++ b/docs/mfc/creating-the-date-and-time-picker-control.md @@ -4,6 +4,7 @@ title: "Creating the Date and Time Picker Control" ms.date: "11/04/2016" helpviewer_keywords: ["DateTimePicker control [MFC], creating", "CDateTimeCtrl class [MFC], creating"] ms.assetid: 764ec2fb-98cd-478b-a5f2-d63f0bb12279 +ms.topic: how-to --- # Creating the Date and Time Picker Control diff --git a/docs/mfc/creating-the-dialog-resource.md b/docs/mfc/creating-the-dialog-resource.md index 7ccf5adb5b8..7aa4d5179b2 100644 --- a/docs/mfc/creating-the-dialog-resource.md +++ b/docs/mfc/creating-the-dialog-resource.md @@ -4,6 +4,7 @@ title: "Creating the Dialog Resource" ms.date: "11/04/2016" helpviewer_keywords: ["dialog resources", "MFC dialog boxes [MFC], creating", "dialog templates [MFC], creating dialog resource", "templates [MFC], creating", "resources [MFC], creating dialog boxes", "MFC dialog boxes [MFC], dialog resource"] ms.assetid: 0b83bd33-14d3-4611-8129-fccdae18053e +ms.topic: concept-article --- # Creating the Dialog Resource diff --git a/docs/mfc/creating-the-header-control.md b/docs/mfc/creating-the-header-control.md index 2afab96c98b..e16b83e1204 100644 --- a/docs/mfc/creating-the-header-control.md +++ b/docs/mfc/creating-the-header-control.md @@ -4,6 +4,7 @@ title: "Creating the Header Control" ms.date: "11/04/2016" helpviewer_keywords: ["CHeaderCtrl class [MFC], creating", "header controls [MFC], creating"] ms.assetid: 7864d9d2-4a2c-4622-b58b-7b110a1e28d2 +ms.topic: how-to --- # Creating the Header Control diff --git a/docs/mfc/creating-the-image-lists.md b/docs/mfc/creating-the-image-lists.md index 537f21582c2..da8197206e5 100644 --- a/docs/mfc/creating-the-image-lists.md +++ b/docs/mfc/creating-the-image-lists.md @@ -4,6 +4,7 @@ title: "Creating the Image Lists" ms.date: "11/04/2016" helpviewer_keywords: ["CListCtrl class [MFC], creating image lists for", "image lists [MFC], creating for CListCtrl", "lists [MFC], image"] ms.assetid: c2768515-deba-49e8-a6f3-5be6482afb19 +ms.topic: concept-article --- # Creating the Image Lists diff --git a/docs/mfc/creating-the-list-control.md b/docs/mfc/creating-the-list-control.md index 3d3ae78237d..cd17ed745c3 100644 --- a/docs/mfc/creating-the-list-control.md +++ b/docs/mfc/creating-the-list-control.md @@ -4,6 +4,7 @@ title: "Creating the List Control" ms.date: "11/04/2016" helpviewer_keywords: ["CListCtrl class [MFC], creating control", "list controls [MFC]"] ms.assetid: a4cb1729-31b6-4d2b-a44b-367474848a39 +ms.topic: how-to --- # Creating the List Control diff --git a/docs/mfc/creating-the-month-calendar-control.md b/docs/mfc/creating-the-month-calendar-control.md index 623738f5816..21319b9e5bf 100644 --- a/docs/mfc/creating-the-month-calendar-control.md +++ b/docs/mfc/creating-the-month-calendar-control.md @@ -4,6 +4,7 @@ title: "Creating the Month Calendar Control" ms.date: "11/04/2016" helpviewer_keywords: ["CMonthCalCtrl class [MFC], creating", "month calendar controls [MFC], creating", "month calendar controls [MFC]"] ms.assetid: 185cc642-85e9-4365-8a4c-d90b75b010f7 +ms.topic: how-to --- # Creating the Month Calendar Control diff --git a/docs/mfc/creating-the-tab-control.md b/docs/mfc/creating-the-tab-control.md index 4cad7fbd53d..ec4d8a7626b 100644 --- a/docs/mfc/creating-the-tab-control.md +++ b/docs/mfc/creating-the-tab-control.md @@ -5,6 +5,7 @@ ms.date: "11/04/2016" f1_keywords: ["TCS_EX_REGISTERDROP", "TCS_EX_FLATSEPARATORS"] helpviewer_keywords: ["TCS_EX_REGISTERDROP extended style [MFC]", "tab controls [MFC], creating", "CTabCtrl class [MFC], creating", "TCS_EX_FLATSEPARATORS extended style"] ms.assetid: 3a9c2d64-f5f4-41ea-84ab-fceb73c3dbdc +ms.topic: how-to --- # Creating the Tab Control diff --git a/docs/mfc/creating-windows.md b/docs/mfc/creating-windows.md index 93dd62fceb4..ffa63d22eda 100644 --- a/docs/mfc/creating-windows.md +++ b/docs/mfc/creating-windows.md @@ -4,6 +4,7 @@ title: "Creating Windows" ms.date: "11/04/2016" helpviewer_keywords: ["object creation [MFC], windows", "windows [MFC], creating", "CWnd objects [MFC]", "CWnd objects [MFC], creating"] ms.assetid: f5ff91a6-4069-47d7-9177-1e6c80d3792c +ms.topic: concept-article --- # Creating Windows diff --git a/docs/mfc/creating-your-dialog-class.md b/docs/mfc/creating-your-dialog-class.md index 2c750d4504c..904e6f42875 100644 --- a/docs/mfc/creating-your-dialog-class.md +++ b/docs/mfc/creating-your-dialog-class.md @@ -4,6 +4,7 @@ title: "Creating Your Dialog Class" ms.date: "09/06/2019" helpviewer_keywords: ["dialog boxes [MFC], creating", "MFC dialog boxes [MFC], creating", "files [MFC], creating", "dialog classes [MFC], Add Class Wizard", "dialog classes [MFC], creating"] ms.assetid: d5321741-da41-47a8-bb1c-6a0e8b28c4c1 +ms.topic: concept-article --- # Creating Your Dialog Class diff --git a/docs/mfc/crebar-vs-crebarctrl.md b/docs/mfc/crebar-vs-crebarctrl.md index 6750c3db526..34ddc168552 100644 --- a/docs/mfc/crebar-vs-crebarctrl.md +++ b/docs/mfc/crebar-vs-crebarctrl.md @@ -11,7 +11,7 @@ MFC provides two classes to create rebars: [CReBar](reference/crebar-class.md) a `CReBarCtrl` is a wrapper class for the Win32 rebar control, and therefore may be easier to implement if you do not intend to integrate the rebar into the MFC architecture. If you plan to use `CReBarCtrl` and integrate the rebar into the MFC architecture, you must take additional care to communicate rebar control manipulations to MFC. This communication is not difficult; however, it is additional work that is unneeded when you use `CReBar`. -Visual C++ provides two ways to take advantage of the rebar common control. +Visual Studio provides two ways to take advantage of the rebar common control. - Create the rebar using `CReBar`, and then call [CReBar::GetReBarCtrl](reference/crebar-class.md#getrebarctrl) to get access to the `CReBarCtrl` member functions. diff --git a/docs/mfc/customizing-the-appearance-of-a-toolbar-control.md b/docs/mfc/customizing-the-appearance-of-a-toolbar-control.md index f69fbb571af..7a40c5a6116 100644 --- a/docs/mfc/customizing-the-appearance-of-a-toolbar-control.md +++ b/docs/mfc/customizing-the-appearance-of-a-toolbar-control.md @@ -5,6 +5,7 @@ ms.date: "11/04/2016" f1_keywords: ["TBSTYLE_"] helpviewer_keywords: ["flat toolbars", "CToolBar class [MFC], styles", "transparent toolbars", "TBSTYLE_ styles [MFC]", "CToolBarCtrl class [MFC], object styles", "toolbar controls [MFC], style"] ms.assetid: fd0a73db-7ad1-4fe4-889b-02c3980f49e8 +ms.topic: concept-article --- # Customizing the Appearance of a Toolbar Control diff --git a/docs/mfc/customizing-the-header-item-s-appearance.md b/docs/mfc/customizing-the-header-item-s-appearance.md index 8a47aec3d32..7324136f93a 100644 --- a/docs/mfc/customizing-the-header-item-s-appearance.md +++ b/docs/mfc/customizing-the-header-item-s-appearance.md @@ -4,6 +4,7 @@ title: "Customizing the Header Item's Appearance" ms.date: "11/04/2016" helpviewer_keywords: ["header controls [MFC], customization of items", "CHeaderCtrl class [MFC], customizing the items", "HDS_ styles"] ms.assetid: b1e1e326-ec7d-4dbd-a46f-96a3e2055618 +ms.topic: concept-article --- # Customizing the Header Item's Appearance diff --git a/docs/mfc/cwinapp-the-application-class.md b/docs/mfc/cwinapp-the-application-class.md index ba5a5f0062f..a34f9b55a13 100644 --- a/docs/mfc/cwinapp-the-application-class.md +++ b/docs/mfc/cwinapp-the-application-class.md @@ -19,7 +19,7 @@ Like any program for the Windows operating system, your framework application ha To initialize the application, `WinMain` calls your application object's `InitApplication` and `InitInstance` member functions. To run the application's message loop, `WinMain` calls the **Run** member function. On termination, `WinMain` calls the application object's `ExitInstance` member function. > [!NOTE] -> Names shown in **bold** in this documentation indicate elements supplied by the Microsoft Foundation Class Library and Visual C++. Names shown in `monospaced` type indicate elements that you create or override. +> Names shown in **bold** in this documentation indicate elements supplied by the Microsoft Foundation Class Library and Visual Studio. Names shown in `monospaced` type indicate elements that you create or override. ## See also diff --git a/docs/mfc/dao-classes.md b/docs/mfc/dao-classes.md index ad16f3fe673..85553ceccae 100644 --- a/docs/mfc/dao-classes.md +++ b/docs/mfc/dao-classes.md @@ -14,7 +14,7 @@ These classes work with the other application framework classes to give easy acc Programs that use DAO databases will have at least a `CDaoDatabase` object and a `CDaoRecordset` object. > [!NOTE] -> The Visual C++ environment and wizards no longer support DAO (although the DAO classes are included and you can still use them). Microsoft recommends that you use ODBC for new MFC projects. You should only use DAO in maintaining existing applications. +> The Visual Studio environment and wizards no longer support DAO (although the DAO classes are included and you can still use them). Microsoft recommends that you use ODBC for new MFC projects. You should only use DAO in maintaining existing applications. [CDaoWorkspace](reference/cdaoworkspace-class.md)
Manages a named, password-protected database session from login to logoff. Most programs use the default workspace. diff --git a/docs/mfc/debugging-and-exception-classes.md b/docs/mfc/debugging-and-exception-classes.md index 74df8a9f60a..95670e20ee0 100644 --- a/docs/mfc/debugging-and-exception-classes.md +++ b/docs/mfc/debugging-and-exception-classes.md @@ -5,6 +5,7 @@ ms.date: "11/04/2016" f1_keywords: ["vc.classes.debug"] helpviewer_keywords: ["debugging [MFC], exception classes", "debugging [MFC], classes for debugging"] ms.assetid: 0d158efd-2e62-452e-9d2a-d3c30dfee7f9 +ms.topic: concept-article --- # Debugging and Exception Classes diff --git a/docs/mfc/debugging-support-classes.md b/docs/mfc/debugging-support-classes.md index 558f225543e..e9b03065b8c 100644 --- a/docs/mfc/debugging-support-classes.md +++ b/docs/mfc/debugging-support-classes.md @@ -4,6 +4,7 @@ title: "Debugging Support Classes" ms.date: "11/04/2016" helpviewer_keywords: ["debugging memory leaks, MFC", "memory allocation, debugging dynamic", "debugging [MFC], classes for debugging", "memory allocation, debugging dynamic allocation", "dynamic memory allocation", "debugging [MFC], memory leaks", "memory leaks, MFC debug classes"] ms.assetid: d79e084a-8326-4251-8700-4efac07c511e +ms.topic: concept-article --- # Debugging Support Classes diff --git a/docs/mfc/declaring-message-handler-functions.md b/docs/mfc/declaring-message-handler-functions.md index 04adeb9627f..cc9258d87a0 100644 --- a/docs/mfc/declaring-message-handler-functions.md +++ b/docs/mfc/declaring-message-handler-functions.md @@ -4,6 +4,7 @@ title: "Declaring Message Handler Functions" ms.date: "11/04/2016" helpviewer_keywords: ["declaring functions, message handler functions [MFC]"] ms.assetid: f8d3dbc1-4500-4f1e-a18d-7371edf36386 +ms.topic: concept-article --- # Declaring Message Handler Functions diff --git a/docs/mfc/deleting-all-objects-in-a-cobject-collection.md b/docs/mfc/deleting-all-objects-in-a-cobject-collection.md index 116c8782044..d57fae1c586 100644 --- a/docs/mfc/deleting-all-objects-in-a-cobject-collection.md +++ b/docs/mfc/deleting-all-objects-in-a-cobject-collection.md @@ -4,6 +4,7 @@ title: "Deleting All Objects in a CObject Collection" ms.date: "11/04/2016" helpviewer_keywords: ["objects [MFC], deleting in collections", "objects in CObject collections, deleting", "CObject class [MFC], deleting in collection", "collection classes [MFC], deleting all objects", "CObject class collection", "objects in CObject collections", "collection classes [MFC], shared objects"] ms.assetid: 81d2c1d5-a0a5-46e1-8ab9-82b45cf7afd2 +ms.topic: how-to --- # Deleting All Objects in a CObject Collection diff --git a/docs/mfc/derived-view-classes-available-in-mfc.md b/docs/mfc/derived-view-classes-available-in-mfc.md index e0831af6ac6..90f9c090011 100644 --- a/docs/mfc/derived-view-classes-available-in-mfc.md +++ b/docs/mfc/derived-view-classes-available-in-mfc.md @@ -18,7 +18,7 @@ The following table shows MFC's view classes and their relationships to one anot |[CEditView](reference/ceditview-class.md)|A simple view based on the Windows edit box control. Allows entering and editing text and can be used as the basis for a simple text editor application. See also `CRichEditView`.| |[CRichEditView](reference/cricheditview-class.md)|A view containing a [CRichEditCtrl](reference/cricheditctrl-class.md) object. This class is analogous to `CEditView`, but unlike `CEditView`, `CRichEditView` handles formatted text.| |[CListView](reference/clistview-class.md)|A view containing a [CListCtrl](reference/clistctrl-class.md) object.| -|[CTreeView](reference/ctreeview-class.md)|A view containing a [CTreeCtrl](reference/ctreectrl-class.md) object, for views that resemble the Solution Explorer window in Visual C++.| +|[CTreeView](reference/ctreeview-class.md)|A view containing a [CTreeCtrl](reference/ctreectrl-class.md) object, for views that resemble the Solution Explorer window in Visual Studio.| |[CScrollView](reference/cscrollview-class.md)|Base class of `CFormView`, `CRecordView`, and `CDaoRecordView`. Implements scrolling the view's contents.| |[CFormView](reference/cformview-class.md)|A form view, a view that contains controls. A forms-based application provides one or more such form interfaces.| |[CHtmlView](reference/chtmlview-class.md)|A Web browser view with which the application's user can browse sites on the World Wide Web, as well as folders in the local file system and on a network. The Web browser view can also work as an Active document container.| diff --git a/docs/mfc/deriving-a-class-from-cobject.md b/docs/mfc/deriving-a-class-from-cobject.md index 3e290c2a4c5..bde7b72bbb9 100644 --- a/docs/mfc/deriving-a-class-from-cobject.md +++ b/docs/mfc/deriving-a-class-from-cobject.md @@ -4,6 +4,7 @@ title: "Deriving a Class from CObject" ms.date: "11/04/2016" helpviewer_keywords: ["DECLARE_DYNCREATE macro [MFC]", "DECLARE_SERIAL macro [MFC]", "macros [MFC], serialization", "serialization [MFC], macros", "DECLARE_DYNAMIC macro [MFC]", "derived classes [MFC], from CObject", "CObject class [MFC], deriving serializable classes", "CObject class [MFC], deriving from"] ms.assetid: 5ea4ea41-08b5-4bd8-b247-c5de8c152a27 +ms.topic: how-to --- # Deriving a Class from CObject diff --git a/docs/mfc/deriving-a-document-class-from-cdocument.md b/docs/mfc/deriving-a-document-class-from-cdocument.md index db461ebc77c..1184517b913 100644 --- a/docs/mfc/deriving-a-document-class-from-cdocument.md +++ b/docs/mfc/deriving-a-document-class-from-cdocument.md @@ -4,6 +4,7 @@ title: "Deriving a Document Class from CDocument" ms.date: "11/04/2016" helpviewer_keywords: ["CDocument class [MFC], deriving from", "classes [MFC], deriving from CDocument", "document objects [MFC], derived", "derived classes [MFC], functions often overridden", "document classes [MFC], functions often overridden"] ms.assetid: e6a198e0-9799-43c0-83c5-04174d8b532c +ms.topic: concept-article --- # Deriving a Document Class from CDocument diff --git a/docs/mfc/deriving-controls-from-a-standard-control.md b/docs/mfc/deriving-controls-from-a-standard-control.md index 87576b2f0fb..3489abe0ff7 100644 --- a/docs/mfc/deriving-controls-from-a-standard-control.md +++ b/docs/mfc/deriving-controls-from-a-standard-control.md @@ -4,6 +4,7 @@ title: "Deriving Controls from a Standard Control" ms.date: "11/04/2016" helpviewer_keywords: ["standard controls [MFC], deriving controls from", "common controls [MFC], deriving from", "derived controls", "controls [MFC], derived", "Windows common controls [MFC], deriving from", "standard controls"] ms.assetid: a6f84315-7007-4e0e-8576-78be81254802 +ms.topic: how-to --- # Deriving Controls from a Standard Control diff --git a/docs/mfc/destroying-frame-windows.md b/docs/mfc/destroying-frame-windows.md index a640fe5351f..4bd96d2b29f 100644 --- a/docs/mfc/destroying-frame-windows.md +++ b/docs/mfc/destroying-frame-windows.md @@ -5,6 +5,7 @@ ms.date: "11/04/2016" f1_keywords: ["PostNcDestroy"] helpviewer_keywords: ["Default method [MFC]", "DestroyWindow method [MFC]", "frame windows [MFC], destroying", "OnNcDestroy method, and frame windows", "document frame windows [MFC], destroying", "destroying frame windows", "MFC, frame windows", "windows [MFC], destroying", "OnClose method [MFC]", "PostNcDestroy method [MFC]"] ms.assetid: 5affca77-1999-4507-a2b2-9aa226611b4b +ms.topic: concept-article --- # Destroying Frame Windows diff --git a/docs/mfc/destroying-the-dialog-box.md b/docs/mfc/destroying-the-dialog-box.md index 1c0da1b3a81..c8a2f0dbfbf 100644 --- a/docs/mfc/destroying-the-dialog-box.md +++ b/docs/mfc/destroying-the-dialog-box.md @@ -4,6 +4,7 @@ title: "Destroying the Dialog Box" ms.date: "11/04/2016" helpviewer_keywords: ["dialog boxes [MFC], deleting", "destruction, dialog box", "dialog boxes [MFC], destroying", "dialog boxes [MFC], removing", "modeless dialog boxes [MFC], destroying", "MFC dialog boxes [MFC], destroying", "modal dialog boxes [MFC], destroying"] ms.assetid: dabceee7-3639-4d85-bf34-73515441b3d0 +ms.topic: concept-article --- # Destroying the Dialog Box diff --git a/docs/mfc/destroying-the-list-control.md b/docs/mfc/destroying-the-list-control.md index ac0a7fbcdf0..760823ee5d8 100644 --- a/docs/mfc/destroying-the-list-control.md +++ b/docs/mfc/destroying-the-list-control.md @@ -4,6 +4,7 @@ title: "Destroying the List Control" ms.date: "11/04/2016" helpviewer_keywords: ["list controls [MFC], destroying", "CListCtrl class [MFC], destroying controls"] ms.assetid: 513ec820-3a02-49d2-b073-a6a7a3fc91b3 +ms.topic: concept-article --- # Destroying the List Control diff --git a/docs/mfc/destroying-window-objects.md b/docs/mfc/destroying-window-objects.md index 462e4a379f5..3a02e91f0bc 100644 --- a/docs/mfc/destroying-window-objects.md +++ b/docs/mfc/destroying-window-objects.md @@ -4,6 +4,7 @@ title: "Destroying Window Objects" ms.date: "11/04/2016" helpviewer_keywords: ["frame windows [MFC], destroying", "window objects [MFC], deleting", "window objects [MFC], destroying", "window objects [MFC], removing"] ms.assetid: 3241fea0-c614-4a25-957d-20f21bd5fd0c +ms.topic: concept-article --- # Destroying Window Objects diff --git a/docs/mfc/detaching-a-cwnd-from-its-hwnd.md b/docs/mfc/detaching-a-cwnd-from-its-hwnd.md index 213b8ed1995..abacdcd81f5 100644 --- a/docs/mfc/detaching-a-cwnd-from-its-hwnd.md +++ b/docs/mfc/detaching-a-cwnd-from-its-hwnd.md @@ -4,6 +4,7 @@ title: "Detaching a CWnd from Its HWND" ms.date: "11/04/2016" helpviewer_keywords: ["HWND, detaching CWnd from", "removing HWNDs from CWnds", "CWnd objects [MFC], detaching from HWND", "detaching CWnds from HWNDs", "Detach method (CWnd class)"] ms.assetid: 6efadf84-0517-4a3f-acfd-216e088f19c6 +ms.topic: concept-article --- # Detaching a CWnd from Its HWND diff --git a/docs/mfc/dialog-bars.md b/docs/mfc/dialog-bars.md index 3e1b3cb5fba..f1d629b751a 100644 --- a/docs/mfc/dialog-bars.md +++ b/docs/mfc/dialog-bars.md @@ -9,7 +9,7 @@ ms.assetid: 485c8055-6bb0-4051-8417-dd2971499321 A dialog bar is a toolbar, a kind of [control bar](control-bars.md) that can contain any kind of control. Because it has the characteristics of a modeless dialog box, a [CDialogBar](reference/cdialogbar-class.md) object provides a more powerful toolbar. -There are several key differences between a toolbar and a `CDialogBar` object. A `CDialogBar` object is created from a dialog-template resource, which you can create with the Visual C++ dialog editor and which can contain any kind of Windows control. The user can tab from control to control. And you can specify an alignment style to align the dialog bar with any part of the parent frame window or even to leave it in place if the parent is resized. The following figure shows a dialog bar with a variety of controls. +There are several key differences between a toolbar and a `CDialogBar` object. A `CDialogBar` object is created from a dialog-template resource, which you can create with the Visual Studio dialog editor and which can contain any kind of Windows control. The user can tab from control to control. And you can specify an alignment style to align the dialog bar with any part of the parent frame window or even to leave it in place if the parent is resized. The following figure shows a dialog bar with a variety of controls. ![Example of a VC Dialog Bar.](../mfc/media/vc378t1.gif "VC Dialog Bar")
A Dialog Bar diff --git a/docs/mfc/dialog-boxes.md b/docs/mfc/dialog-boxes.md index 780520efb62..52ff46b668e 100644 --- a/docs/mfc/dialog-boxes.md +++ b/docs/mfc/dialog-boxes.md @@ -7,7 +7,7 @@ ms.assetid: e4feea1a-8360-4ccb-9b84-507f1ccd9ef3 --- # Dialog Boxes -Applications for Windows frequently communicate with the user through dialog boxes. Class [CDialog](reference/cdialog-class.md) provides an interface for managing dialog boxes, the Visual C++ dialog editor makes it easy to design dialog boxes and create their dialog-template resources, and Code wizards simplify the process of initializing and validating the controls in a dialog box and of gathering the values entered by the user. +Applications for Windows frequently communicate with the user through dialog boxes. Class [CDialog](reference/cdialog-class.md) provides an interface for managing dialog boxes, the Visual Studio dialog editor makes it easy to design dialog boxes and create their dialog-template resources, and Code wizards simplify the process of initializing and validating the controls in a dialog box and of gathering the values entered by the user. Dialog boxes contain controls, including: diff --git a/docs/mfc/docking-and-floating-toolbars.md b/docs/mfc/docking-and-floating-toolbars.md index 06db3ca56cd..2dc9f54a2a7 100644 --- a/docs/mfc/docking-and-floating-toolbars.md +++ b/docs/mfc/docking-and-floating-toolbars.md @@ -5,6 +5,7 @@ ms.date: "11/04/2016" f1_keywords: ["CBRS_SIZE_DYNAMIC", "CBRS_SIZE_FIXED"] helpviewer_keywords: ["size [MFC], toolbars", "size", "frame windows [MFC], toolbar docking", "CBRS_ALIGN_ANY constant [MFC]", "palettes, floating", "toolbars [MFC], docking", "CBRS_SIZE_DYNAMIC constant [MFC]", "floating toolbars", "toolbars [MFC], size", "toolbars [MFC], floating", "fixed-size toolbars", "CBRS_SIZE_FIXED constant [MFC]", "toolbar controls [MFC], wrapping", "toolbars [MFC], wrapping", "floating palettes"] ms.assetid: b7f9f9d4-f629-47d2-a3c4-2b33fa6b51e4 +ms.topic: concept-article --- # Docking and Floating Toolbars diff --git a/docs/mfc/document-and-view-classes-created-by-the-mfc-application-wizard.md b/docs/mfc/document-and-view-classes-created-by-the-mfc-application-wizard.md index 6003a3f8dc8..5ebeea6596b 100644 --- a/docs/mfc/document-and-view-classes-created-by-the-mfc-application-wizard.md +++ b/docs/mfc/document-and-view-classes-created-by-the-mfc-application-wizard.md @@ -7,7 +7,7 @@ ms.assetid: 70c34a60-2701-4981-acea-c08a5787d8e6 --- # Document and View Classes Created by the MFC Application Wizard -The MFC Application Wizard gives you a head start on your program development by creating skeletal document and view classes for you. You can then [map commands and messages to these classes](reference/mapping-messages-to-functions.md) and use the Visual C++ source code editor to write their member functions. +The MFC Application Wizard gives you a head start on your program development by creating skeletal document and view classes for you. You can then [map commands and messages to these classes](reference/mapping-messages-to-functions.md) and use the Visual Studio source code editor to write their member functions. The document class created by the MFC Application Wizard is derived from class [CDocument](reference/cdocument-class.md). The view class is derived from [CView](reference/cview-class.md). The names that the Application Wizard gives these classes and the files that contain them are based on the project name you supply in the Application Wizard dialog box. In the Application Wizard, you can use the Generated Classes page to alter the default names. diff --git a/docs/mfc/document-template-creation.md b/docs/mfc/document-template-creation.md index e4506f1132f..5efdb1673b1 100644 --- a/docs/mfc/document-template-creation.md +++ b/docs/mfc/document-template-creation.md @@ -13,7 +13,7 @@ The document-template constructor specifies what types of documents, windows, an [!code-cpp[NVC_MFCDocView#7](codesnippet/cpp/document-template-creation_1.cpp)] -The pointer to a new `CMultiDocTemplate` object is used as an argument to [AddDocTemplate](reference/cwinapp-class.md#adddoctemplate). Arguments to the `CMultiDocTemplate` constructor include the resource ID associated with the document type's menus and accelerators, and three uses of the [RUNTIME_CLASS](reference/run-time-object-model-services.md#runtime_class) macro. `RUNTIME_CLASS` returns the [CRuntimeClass](reference/cruntimeclass-structure.md) object for the C++ class named as its argument. The three `CRuntimeClass` objects passed to the document-template constructor supply the information needed to create new objects of the specified classes during the document creation process. The example shows creation of a document template that creates `CScribDoc` objects with `CScribView` objects attached. The views are framed by standard MDI child frame windows. +The pointer to a new `CMultiDocTemplate` object is used as an argument to [AddDocTemplate](reference/cwinapp-class.md#adddoctemplate). Arguments to the `CMultiDocTemplate` constructor include the resource ID associated with the document type's menus and accelerators, and three uses of the [RUNTIME_CLASS](reference/run-time-object-model-services.md#runtime_class) macro. `RUNTIME_CLASS` returns the [CRuntimeClass](reference/cruntimeclass-structure.md) object for the C++ class named as its argument. The three `CRuntimeClass` objects passed to the document-template constructor supply the information needed to create new objects of the specified classes during the document creation process. The example shows creation of a document template that creates `CMyDoc` objects with `CMyView` objects attached. The views are framed by custom MDI child frame windows `CChildFrame`. ## See also diff --git a/docs/mfc/dragging-and-dropping-files-in-a-frame-window.md b/docs/mfc/dragging-and-dropping-files-in-a-frame-window.md index 0371f4f3556..f3ecc1650ed 100644 --- a/docs/mfc/dragging-and-dropping-files-in-a-frame-window.md +++ b/docs/mfc/dragging-and-dropping-files-in-a-frame-window.md @@ -4,6 +4,7 @@ title: "Dragging and Dropping Files in a Frame Window" ms.date: "11/04/2016" helpviewer_keywords: ["drag and drop [MFC], files", "drag and drop [MFC], File Manager", "Windows Explorer [MFC]", "File Manager drag and drop support [MFC]", "files [MFC], drag and drop", "frame windows [MFC], dragging and dropping files in", "drag and drop [MFC], Windows Explorer"] ms.assetid: 85560fe9-121b-4105-bd7b-216b966e19fa +ms.topic: concept-article --- # Dragging and Dropping Files in a Frame Window diff --git a/docs/mfc/dragging-images-from-an-image-list.md b/docs/mfc/dragging-images-from-an-image-list.md index d1978d040d1..ecea5051da3 100644 --- a/docs/mfc/dragging-images-from-an-image-list.md +++ b/docs/mfc/dragging-images-from-an-image-list.md @@ -4,6 +4,7 @@ title: "Dragging Images from an Image List" ms.date: "11/04/2016" helpviewer_keywords: ["CImageList class [MFC], dragging images from", "dragging images from image lists [MFC]", "image lists [MFC], dragging images from", "images [MFC], dragging from image lists"] ms.assetid: af691db8-e4f0-4046-b7b9-9acc68d3713d +ms.topic: concept-article --- # Dragging Images from an Image List diff --git a/docs/mfc/drawing-and-printing-classes.md b/docs/mfc/drawing-and-printing-classes.md index 69a545ce583..d43f6e9affa 100644 --- a/docs/mfc/drawing-and-printing-classes.md +++ b/docs/mfc/drawing-and-printing-classes.md @@ -4,6 +4,7 @@ title: "Drawing and Printing Classes" ms.date: "11/04/2016" helpviewer_keywords: ["output [MFC], graphical classes", "drawing [MFC], classes", "printing classes [MFC]", "graphics [MFC], graphical output classes"] ms.assetid: 2781c599-a038-462a-98ca-634b07ee22b0 +ms.topic: concept-article --- # Drawing and Printing Classes diff --git a/docs/mfc/drawing-images-from-an-image-list.md b/docs/mfc/drawing-images-from-an-image-list.md index 12206237232..0f0e5cd6019 100644 --- a/docs/mfc/drawing-images-from-an-image-list.md +++ b/docs/mfc/drawing-images-from-an-image-list.md @@ -4,6 +4,7 @@ title: "Drawing Images from an Image List" ms.date: "11/04/2016" helpviewer_keywords: ["CImageList class [MFC], drawing images from", "drawing [MFC], images from image lists", "image lists [MFC], drawing images from", "images [MFC], drawing"] ms.assetid: 2f6063fb-1c28-45f8-a333-008c064db11c +ms.topic: concept-article --- # Drawing Images from an Image List diff --git a/docs/mfc/drawing-in-a-view.md b/docs/mfc/drawing-in-a-view.md index 88d9d6fd1b5..ecd59ea9512 100644 --- a/docs/mfc/drawing-in-a-view.md +++ b/docs/mfc/drawing-in-a-view.md @@ -4,6 +4,7 @@ title: "Drawing in a View" ms.date: "11/04/2016" helpviewer_keywords: ["drawing [MFC], in views", "views [MFC], printing", "views [MFC], updating", "printing [MFC], views", "views [MFC], rendering", "printing views [MFC]", "paint messages in view class [MFC]", "device contexts, screen drawings"] ms.assetid: e3761db6-0f19-4482-a4cd-ac38ef7c4d3a +ms.topic: how-to --- # Drawing in a View diff --git a/docs/mfc/drawing-tool-classes.md b/docs/mfc/drawing-tool-classes.md index 3e7fda79fab..0e33ab2346e 100644 --- a/docs/mfc/drawing-tool-classes.md +++ b/docs/mfc/drawing-tool-classes.md @@ -5,6 +5,7 @@ ms.date: "11/04/2016" f1_keywords: ["vc.classes.drawing"] helpviewer_keywords: ["drawing [MFC], tool classes", "screen output classes [MFC]", "output classes [MFC]"] ms.assetid: e907bd89-38b5-47c9-b76a-95e0bf3bb41d +ms.topic: concept-article --- # Drawing Tool Classes diff --git a/docs/mfc/dynamic-object-creation.md b/docs/mfc/dynamic-object-creation.md index 508a2012a9e..a7e77c3fe66 100644 --- a/docs/mfc/dynamic-object-creation.md +++ b/docs/mfc/dynamic-object-creation.md @@ -1,9 +1,8 @@ --- -description: "Learn more about: Dynamic Object Creation" title: "Dynamic Object Creation" +description: "Learn more about: Dynamic Object Creation" ms.date: "03/27/2020" helpviewer_keywords: ["object creation [MFC], dynamically at run time", "CObject class [MFC], dynamic object creation", "objects [MFC], creating dynamically at run time", "dynamic object creation [MFC]"] -ms.assetid: 3e0f51cb-3e24-4231-817f-1c0ce9f2d5df --- # Dynamic Object Creation @@ -17,5 +16,5 @@ This article explains how to create an object dynamically at run time. The proce ## See also -[Destroying Window Objects](tn017-destroying-window-objects.md) +[Destroying Window Objects](tn017-destroying-window-objects.md)\ [Using CObject](using-cobject.md) diff --git a/docs/mfc/enabling-tool-tips.md b/docs/mfc/enabling-tool-tips.md index c101a6b1fb1..4f59728c5a1 100644 --- a/docs/mfc/enabling-tool-tips.md +++ b/docs/mfc/enabling-tool-tips.md @@ -4,6 +4,7 @@ title: "Enabling Tool Tips" ms.date: "11/04/2016" helpviewer_keywords: ["initializing tool tips [MFC]", "enabling tool tips [MFC]", "tool tips [MFC], initializing", "tool tips [MFC], enabling"] ms.assetid: 06b7c889-7722-4ce6-8b88-9efa50fe6369 +ms.topic: how-to --- # Enabling Tool Tips diff --git a/docs/mfc/exception-handling-in-mfc.md b/docs/mfc/exception-handling-in-mfc.md index 3d16c77f89e..29b8e759bf4 100644 --- a/docs/mfc/exception-handling-in-mfc.md +++ b/docs/mfc/exception-handling-in-mfc.md @@ -1,9 +1,8 @@ --- -description: "Learn more about: Exception Handling in MFC" title: "Exception Handling in MFC" -ms.date: "11/19/2019" +description: "Learn more about: Exception Handling in MFC" +ms.date: 11/19/2019 helpviewer_keywords: ["DAO [MFC], exceptions", "assertions [MFC], When to use exceptions", "exception handling [MFC], MFC", "resource allocation exception", "resources [MFC], allocating", "keywords [MFC], exception handling", "errors [MFC], detected by assertions", "ODBC exceptions [MFC]", "serialization [MFC], exceptions", "Automation [MFC], exceptions", "exception macros [MFC]", "predefined exceptions [MFC]", "C++ exception handling [MFC], enabling", "C++ exception handling [MFC], MFC applications", "requests for unsupported services [MFC]", "database exceptions [MFC]", "archive exceptions [MFC]", "MFC, exceptions", "C++ exception handling [MFC], types of", "macros [MFC], exception handling", "abnormal program execution [MFC]", "OLE exceptions [MFC], MFC exception handling", "error handling [MFC], exceptions and", "class libraries [MFC], exception support", "exceptions [MFC], MFC macros vs. C++ keywords", "memory [MFC], out-of-memory exceptions", "Windows [MFC], resource allocation exceptions", "macros [MFC], MFC exception macros", "function calls [MFC], results", "out-of-memory exceptions [MFC]"] -ms.assetid: 0926627d-2ba7-44a6-babe-d851a4a2517c --- # Exception Handling in MFC @@ -40,7 +39,7 @@ Three categories of outcomes can occur when a function is called during program - Erroneous execution - The caller makes some mistake in passing arguments to the function or calls the function in an inappropriate context. This situation causes an error, and it should be detected by an assertion during program development. (For more information on assertions, see [C/C++ Assertions](/visualstudio/debugger/c-cpp-assertions).) + The caller makes some mistake in passing arguments to the function or calls the function in an inappropriate context. This situation causes an error, and it should be detected by an assertion during program development. For more information on assertions, see [C/C++ Assertions](/visualstudio/debugger/c-cpp-assertions). - Abnormal execution diff --git a/docs/mfc/exchanging-data.md b/docs/mfc/exchanging-data.md index ad56d4f5976..8ea303ddf53 100644 --- a/docs/mfc/exchanging-data.md +++ b/docs/mfc/exchanging-data.md @@ -4,6 +4,7 @@ title: "Exchanging Data" ms.date: "11/04/2016" helpviewer_keywords: ["property sheets [MFC], data exchange", "exchanging data with property sheets [MFC]", "DDX (dialog data exchange) [MFC], property sheets"] ms.assetid: 689f02d0-51a9-455b-8ffb-5b44f0aefa28 +ms.topic: concept-article --- # Exchanging Data diff --git a/docs/mfc/form-views-mfc.md b/docs/mfc/form-views-mfc.md index 05801af5441..61a5a4bd8d9 100644 --- a/docs/mfc/form-views-mfc.md +++ b/docs/mfc/form-views-mfc.md @@ -7,14 +7,14 @@ ms.assetid: efbe73c1-4ca4-4613-aac2-30d916e92c0e --- # Form Views (MFC) -You can add forms to any Visual C++ application that supports the MFC libraries, including a [forms-based application](reference/creating-a-forms-based-mfc-application.md) (one whose view class is derived from `CFormView`). If you did not initially create your application to support forms, Visual C++ will add this support for you when you insert a new form. In an SDI or MDI application, which implements the default [document/view architecture](document-view-architecture.md), when the user chooses the **New** command (by default, on the **File** menu), Visual C++ prompts the user to choose from the available forms. +You can add forms to any Visual C++ application that supports the MFC libraries, including a [forms-based application](reference/creating-a-forms-based-mfc-application.md) (one whose view class is derived from `CFormView`). If you did not initially create your application to support forms, Visual Studio will add this support for you when you insert a new form. In an SDI or MDI application, which implements the default [document/view architecture](document-view-architecture.md), when the user chooses the **New** command (by default, on the **File** menu), Visual Studio prompts the user to choose from the available forms. With an SDI application, when the user chooses the **New** command, the current instance of the form continues to run but a new instance of the application with the selected form is created if one is not found. In an MDI application, the current instance of the form continues to run when the user chooses the **New** command. > [!NOTE] -> You can insert a form into a dialog-based application (one whose dialog class is based on `CDialog` and one in which no view class is implemented). However, without the document/view architecture, Visual C++ does not automatically implement the **File** > **New** functionality. You must create a way for the user to view additional forms, such as by implementing a tabbed dialog box with various property pages. +> You can insert a form into a dialog-based application (one whose dialog class is based on `CDialog` and one in which no view class is implemented). However, without the document/view architecture, Visual Studio does not automatically implement the **File** > **New** functionality. You must create a way for the user to view additional forms, such as by implementing a tabbed dialog box with various property pages. -When you insert a new form into your application, Visual C++ does the following: +When you insert a new form into your application, Visual Studio does the following: - Creates a class based on one of the form-style classes that you choose (`CFormView`, `CRecordView`, `CDaoRecordView`, or `CDialog`). @@ -42,7 +42,7 @@ For applications based on the document/view architecture, the **New Form** comma - Adds a call to `AddDocumentTemplate` in your application's `InitInstance` code. - Visual C++ adds this code for each new form you create, which adds the form to the list of available forms when the user chooses the **New** command. This code includes the form's associated resource ID and the names of the associated document, view, and frame classes that together make up the new form object. + Visual Studio adds this code for each new form you create, which adds the form to the list of available forms when the user chooses the **New** command. This code includes the form's associated resource ID and the names of the associated document, view, and frame classes that together make up the new form object. Document templates serve as the connection between documents, frame windows, and views. For a single document, you can create many templates. diff --git a/docs/mfc/handling-commands-in-the-document.md b/docs/mfc/handling-commands-in-the-document.md index 9d43c35b0d5..f821152d3ec 100644 --- a/docs/mfc/handling-commands-in-the-document.md +++ b/docs/mfc/handling-commands-in-the-document.md @@ -4,6 +4,7 @@ title: "Handling Commands in the Document" ms.date: "11/04/2016" helpviewer_keywords: ["message maps [MFC], in document class", "command handling [MFC]", "documents [MFC], message maps", "message handling [MFC], WM_COMMAND messages", "command handling [MFC], commands in documents", "documents [MFC], handling messages in"] ms.assetid: c7375584-27af-4275-b2fd-afea476785d0 +ms.topic: concept-article --- # Handling Commands in the Document diff --git a/docs/mfc/handling-customization-notifications.md b/docs/mfc/handling-customization-notifications.md index 86936b07f95..1d2ffb237db 100644 --- a/docs/mfc/handling-customization-notifications.md +++ b/docs/mfc/handling-customization-notifications.md @@ -5,6 +5,7 @@ ms.date: "11/04/2016" f1_keywords: ["TBN_CUSTHELP", "TBN_QUERYINSERT", "TBNOTIFY", "NMHDR", "TBN_TOOLBARCHANGE", "TBN_ENDDRAG", "NM_SETFOCUS", "TBN_RESET", "NM_RETURN", "NM_ENDWAIT", "NM_STARTWAIT", "TBN_BEGINDRAG", "NM_OUTOFMEMORY", "TBN_QUERYDELETE", "NM_DBLCLK", "TBN_ENDADJUST", "NM_KILLFOCUS", "NM_RCLICK", "TBN_BEGINADJUST", "NM_CLICK"] helpviewer_keywords: ["TBN_ENDADJUST notification [MFC]", "TBNOTIFY notification [MFC]", "TBN_BEGINDRAG notification [MFC]", "TBN_TOOLBARCHANGE notification [MFC]", "NM_CLICK notification [MFC]", "NM_RETURN notification [MFC]", "NM_RCLICK notification [MFC]", "TBN_ENDDRAG notification [MFC]", "TBN_BEGINADJUST notification [MFC]", "NM_ENDWAIT notification [MFC]", "NM_KILLFOCUS notification [MFC]", "NM_SETFOCUS notification [MFC]", "NM_OUTOFMEMORY notification [MFC]", "TBN_QUERYINSERT notification [MFC]", "NMHDR [MFC]", "NM_STARTWAIT notification [MFC]", "CToolBarCtrl class [MFC], handling notifications", "TBN_CUSTHELP notification [MFC]", "TBN_RESET notification [MFC]", "NM_DBLCLK notification [MFC]", "TBN_QUERYDELETE notification [MFC]", "NM_RDBLCLK notification [MFC]", "TBN_GETBUTTONINFO notification [MFC]"] ms.assetid: 219ea08e-7515-4b98-85cb-47120f08c0a2 +ms.topic: concept-article --- # Handling Customization Notifications diff --git a/docs/mfc/handling-reflected-messages.md b/docs/mfc/handling-reflected-messages.md index 95b15f8a980..f7d74de5c86 100644 --- a/docs/mfc/handling-reflected-messages.md +++ b/docs/mfc/handling-reflected-messages.md @@ -4,6 +4,7 @@ title: "Handling Reflected Messages" ms.date: "11/04/2016" helpviewer_keywords: ["message handling [MFC], reflected messages", "reflected messages, handling"] ms.assetid: 147a4e0c-51cc-4447-a8e1-c28b4cece578 +ms.topic: concept-article --- # Handling Reflected Messages diff --git a/docs/mfc/handling-the-apply-button.md b/docs/mfc/handling-the-apply-button.md index 0c1e31e8d0d..3cfdef6bf9d 100644 --- a/docs/mfc/handling-the-apply-button.md +++ b/docs/mfc/handling-the-apply-button.md @@ -4,6 +4,7 @@ title: "Handling the Apply Button" ms.date: "11/04/2016" helpviewer_keywords: ["Apply button in property sheet", "property sheets, Apply button"] ms.assetid: 7e977015-59b8-406f-b545-aad0bfd8d55b +ms.topic: concept-article --- # Handling the Apply Button diff --git a/docs/mfc/handling-tool-tip-notifications.md b/docs/mfc/handling-tool-tip-notifications.md index d950042ea4e..8c1ed327ee5 100644 --- a/docs/mfc/handling-tool-tip-notifications.md +++ b/docs/mfc/handling-tool-tip-notifications.md @@ -4,6 +4,7 @@ title: "Handling Tool Tip Notifications" ms.date: "11/04/2016" helpviewer_keywords: ["TOOLTIPTEXT structure [MFC]", "CToolBarCtrl class [MFC], handling notifications", "notifications [MFC], tool tips", "tool tips [MFC], notifications"] ms.assetid: ddb93b5f-2e4f-4537-8053-3453c86e2bbb +ms.topic: concept-article --- # Handling Tool Tip Notifications diff --git a/docs/mfc/handling-ttn-needtext-notification-for-tool-tips.md b/docs/mfc/handling-ttn-needtext-notification-for-tool-tips.md index 982332e7103..12058fb2d4e 100644 --- a/docs/mfc/handling-ttn-needtext-notification-for-tool-tips.md +++ b/docs/mfc/handling-ttn-needtext-notification-for-tool-tips.md @@ -5,6 +5,7 @@ ms.date: "11/04/2016" f1_keywords: ["TTN_NEEDTEXT"] helpviewer_keywords: ["TTN_NEEDTEXT message [MFC]", "notifications [MFC], tool tips", "tool tips [MFC], notifications"] ms.assetid: d0370a65-21ba-4676-bcc5-8cf851bbb15c +ms.topic: concept-article --- # Handling TTN_NEEDTEXT Notification for Tool Tips diff --git a/docs/mfc/handling-windows-messages-in-your-dialog-box.md b/docs/mfc/handling-windows-messages-in-your-dialog-box.md index 170b2d46512..66db7e66085 100644 --- a/docs/mfc/handling-windows-messages-in-your-dialog-box.md +++ b/docs/mfc/handling-windows-messages-in-your-dialog-box.md @@ -4,6 +4,7 @@ title: "Handling Windows Messages in Your Dialog Box" ms.date: "09/05/2019" helpviewer_keywords: ["MFC dialog boxes [MFC], Windows messages", "Windows messages [MFC], handling", "message handling [MFC], in dialog boxes"] ms.assetid: 4af0c9cb-09da-4b15-97df-a1cfb89def79 +ms.topic: concept-article --- # Handling Windows Messages in Your Dialog Box diff --git a/docs/mfc/idle-loop-processing.md b/docs/mfc/idle-loop-processing.md index 33d16f0956d..04bee6c2f4a 100644 --- a/docs/mfc/idle-loop-processing.md +++ b/docs/mfc/idle-loop-processing.md @@ -32,7 +32,7 @@ Another method for performing idle processing in an application involves embeddi [!code-cpp[NVC_MFCDocView#8](codesnippet/cpp/idle-loop-processing_1.cpp)] -This code, embedded in a function, loops as long as there is idle processing to do. Within that loop, a nested loop repeatedly calls `PeekMessage`. As long as that call returns a nonzero value, the loop calls `CWinThread::PumpMessage` to perform normal message translation and dispatching. Although `PumpMessage` is undocumented, you can examine its source code in the ThrdCore.Cpp file in the \atlmfc\src\mfc directory of your Visual C++ installation. +This code, embedded in a function, loops as long as there is idle processing to do. Within that loop, a nested loop repeatedly calls `PeekMessage`. As long as that call returns a nonzero value, the loop calls `CWinThread::PumpMessage` to perform normal message translation and dispatching. Although `PumpMessage` is undocumented, you can examine its source code in the ThrdCore.Cpp file in the \atlmfc\src\mfc directory of your Visual Studio installation. Once the inner loop ends, the outer loop performs idle processing with one or more calls to `OnIdle`. The first call is for MFC's purposes. You can make additional calls to `OnIdle` to do your own background work. diff --git a/docs/mfc/implementing-working-areas-in-list-controls.md b/docs/mfc/implementing-working-areas-in-list-controls.md index 9649cfcd2b5..0ee8d8fcbfa 100644 --- a/docs/mfc/implementing-working-areas-in-list-controls.md +++ b/docs/mfc/implementing-working-areas-in-list-controls.md @@ -4,6 +4,7 @@ title: "Implementing Working Areas in List Controls" ms.date: "11/04/2016" helpviewer_keywords: ["list controls [MFC], working areas", "working areas in list control [MFC]"] ms.assetid: fbbb356b-3359-4348-8603-f1cb114cadde +ms.topic: concept-article --- # Implementing Working Areas in List Controls diff --git a/docs/mfc/initializing-and-cleaning-up-documents-and-views.md b/docs/mfc/initializing-and-cleaning-up-documents-and-views.md index 4462b237bf1..9245198be4d 100644 --- a/docs/mfc/initializing-and-cleaning-up-documents-and-views.md +++ b/docs/mfc/initializing-and-cleaning-up-documents-and-views.md @@ -4,6 +4,7 @@ title: "Initializing and Cleaning Up Documents and Views" ms.date: "11/04/2016" helpviewer_keywords: ["initializing documents [MFC]", "views [MFC], cleaning up", "documents [MFC], initializing", "documents [MFC], cleaning up", "views [MFC], initializing", "initializing objects [MFC], document objects", "document objects [MFC], life cycle of", "initializing views [MFC]"] ms.assetid: 95d6f09b-a047-4079-856a-ae7d0548e9d2 +ms.topic: how-to --- # Initializing and Cleaning Up Documents and Views diff --git a/docs/mfc/initializing-documents-and-views.md b/docs/mfc/initializing-documents-and-views.md index 326411c8763..43ac07fab7a 100644 --- a/docs/mfc/initializing-documents-and-views.md +++ b/docs/mfc/initializing-documents-and-views.md @@ -4,6 +4,7 @@ title: "Initializing Documents and Views" ms.date: "11/04/2016" helpviewer_keywords: ["initializing documents [MFC]", "documents [MFC], initializing", "views [MFC], initializing", "initializing objects [MFC], document objects", "initializing views [MFC]"] ms.assetid: 33cb8643-8a16-478c-bc26-eccc734e3661 +ms.topic: concept-article --- # Initializing Documents and Views diff --git a/docs/mfc/initializing-the-dialog-box.md b/docs/mfc/initializing-the-dialog-box.md index f3fa2fa7af0..ba9d129545f 100644 --- a/docs/mfc/initializing-the-dialog-box.md +++ b/docs/mfc/initializing-the-dialog-box.md @@ -4,6 +4,7 @@ title: "Initializing the Dialog Box" ms.date: "11/04/2016" helpviewer_keywords: ["initializing dialog boxes [MFC]", "OnInitDialog method [MFC]", "modal dialog boxes [MFC], initializing", "modeless dialog boxes [MFC], initializing", "MFC dialog boxes [MFC], initializing"] ms.assetid: 968142f5-19f9-4b34-a1d4-8e6412d4379b +ms.topic: concept-article --- # Initializing the Dialog Box diff --git a/docs/mfc/initializing-the-parts-of-a-cstatusbarctrl-object.md b/docs/mfc/initializing-the-parts-of-a-cstatusbarctrl-object.md index c47acf19ddd..af5b7bc529b 100644 --- a/docs/mfc/initializing-the-parts-of-a-cstatusbarctrl-object.md +++ b/docs/mfc/initializing-the-parts-of-a-cstatusbarctrl-object.md @@ -4,6 +4,7 @@ title: "Initializing the Parts of a CStatusBarCtrl Object" ms.date: "11/04/2016" helpviewer_keywords: ["CStatusBarCtrl class [MFC], simple mode", "status bars [MFC], declaring parts of", "simple status bars [MFC]", "status bars [MFC], icons", "status bars [MFC], simple mode", "icons, using in status bars", "CStatusBarCtrl class [MFC], declaring parts of"] ms.assetid: 60e8f285-d2d8-424a-a6ea-2fc548370303 +ms.topic: concept-article --- # Initializing the Parts of a CStatusBarCtrl Object diff --git a/docs/mfc/inserting-a-form-into-a-project.md b/docs/mfc/inserting-a-form-into-a-project.md index 51e916c60c4..ad08c10130e 100644 --- a/docs/mfc/inserting-a-form-into-a-project.md +++ b/docs/mfc/inserting-a-form-into-a-project.md @@ -4,6 +4,7 @@ title: "Inserting a Form into a Project" ms.date: "11/04/2016" helpviewer_keywords: ["inserting forms [MFC]", "Insert New dialog box [MFC]", "forms, adding to projects"] ms.assetid: f3bd2998-3ce2-496d-ac5c-57ca70eec7cb +ms.topic: how-to --- # Inserting a Form into a Project @@ -21,7 +22,7 @@ Forms provide a convenient container for controls. You can easily insert an MFC- 1. Using the MFC Class Wizard, make the new class derive from [CFormView](reference/cformview-class.md). -Visual C++ adds the form to your application, opening it inside the Dialog editor so that you can begin adding controls and working on its overall design. +Visual Studio adds the form to your application, opening it inside the Dialog editor so that you can begin adding controls and working on its overall design. You may want to perform the following additional steps (not applicable for dialog-based applications): diff --git a/docs/mfc/interpreting-user-input-through-a-view.md b/docs/mfc/interpreting-user-input-through-a-view.md index 4a71432b222..6e1086bbe15 100644 --- a/docs/mfc/interpreting-user-input-through-a-view.md +++ b/docs/mfc/interpreting-user-input-through-a-view.md @@ -4,6 +4,7 @@ title: "Interpreting User Input Through a View" ms.date: "11/04/2016" helpviewer_keywords: ["interpreting user input through views [MFC]", "views [MFC], user interface and input", "input [MFC], view class [MFC]", "CView class [MFC], interpreting user input", "user input [MFC], interpreting through view class [MFC]"] ms.assetid: f0302a70-661f-4781-8fe7-78f082bef2a5 +ms.topic: concept-article --- # Interpreting User Input Through a View diff --git a/docs/mfc/life-cycle-of-a-dialog-box.md b/docs/mfc/life-cycle-of-a-dialog-box.md index 1375df3e61d..f178c1f0676 100644 --- a/docs/mfc/life-cycle-of-a-dialog-box.md +++ b/docs/mfc/life-cycle-of-a-dialog-box.md @@ -4,6 +4,7 @@ title: "Working with Dialog Boxes in MFC" ms.date: "09/27/2019" helpviewer_keywords: ["dialog boxes [MFC], life cycle", "modal dialog boxes [MFC], life cycle", "modeless dialog boxes [MFC], life cycle", "MFC dialog boxes [MFC], life cycle", "life cycle of dialog boxes [MFC]"] ms.assetid: e16fd78e-238d-4f31-8c9d-8564f3953bd9 +ms.topic: concept-article --- # Working with Dialog Boxes in MFC diff --git a/docs/mfc/making-and-using-controls.md b/docs/mfc/making-and-using-controls.md index 92fd5c28a69..8cba3f0fffc 100644 --- a/docs/mfc/making-and-using-controls.md +++ b/docs/mfc/making-and-using-controls.md @@ -4,10 +4,11 @@ title: "Making and Using Controls" ms.date: "11/04/2016" helpviewer_keywords: ["controls [MFC], creating for dialog boxes", "Windows common controls [MFC], about common controls", "common controls [MFC], about common controls"] ms.assetid: a252acad-3cc0-440e-bbc6-43eaaf8cb7bb +ms.topic: concept-article --- # Making and Using Controls -You make most controls for dialog boxes in the Visual C++ [dialog editor](../windows/dialog-editor.md). But you can also create controls in any dialog box or window. +You make most controls for dialog boxes in the Visual Studio [dialog editor](../windows/dialog-editor.md). But you can also create controls in any dialog box or window. ## What do you want to know more about diff --git a/docs/mfc/making-owner-drawn-header-controls.md b/docs/mfc/making-owner-drawn-header-controls.md index 121655e7e4e..68a3e251f9d 100644 --- a/docs/mfc/making-owner-drawn-header-controls.md +++ b/docs/mfc/making-owner-drawn-header-controls.md @@ -4,6 +4,7 @@ title: "Making Owner-Drawn Header Controls" ms.date: "11/04/2016" helpviewer_keywords: ["header controls [MFC], owner-drawn", "drawing [MFC], header controls", "CHeaderCtrl class [MFC], making owner-drawn", "controls [MFC], header", "owner-drawn header controls [MFC]"] ms.assetid: 455c113b-e8d0-400c-8690-dbb92cba0d05 +ms.topic: concept-article --- # Making Owner-Drawn Header Controls diff --git a/docs/mfc/making-owner-drawn-tabs.md b/docs/mfc/making-owner-drawn-tabs.md index f27d45d88ba..f3421ab838c 100644 --- a/docs/mfc/making-owner-drawn-tabs.md +++ b/docs/mfc/making-owner-drawn-tabs.md @@ -4,6 +4,7 @@ title: "Making Owner-Drawn Tabs" ms.date: "11/04/2016" helpviewer_keywords: ["owner-drawn tabs [MFC]", "tabs [MFC], owner-drawn", "CTabCtrl class [MFC], owner-drawn tabs", "drawing [MFC], tabs"] ms.assetid: 11af2926-41d7-47e3-9eec-c595283f6371 +ms.topic: concept-article --- # Making Owner-Drawn Tabs diff --git a/docs/mfc/managing-data-with-document-data-variables.md b/docs/mfc/managing-data-with-document-data-variables.md index 1d6951c2b7a..be73faee851 100644 --- a/docs/mfc/managing-data-with-document-data-variables.md +++ b/docs/mfc/managing-data-with-document-data-variables.md @@ -4,6 +4,7 @@ title: "Managing Data with Document Data Variables" ms.date: "11/04/2016" helpviewer_keywords: ["documents [MFC], data storage", "friend classes [MFC]", "classes [MFC], friend", "data [MFC]", "data [MFC], documents", "collection classes [MFC], used by document object", "document data [MFC]", "member variables [MFC], document class [MFC]"] ms.assetid: e70b87f4-8c30-49e5-8986-521c2ff91704 +ms.topic: concept-article --- # Managing Data with Document Data Variables diff --git a/docs/mfc/managing-mdi-child-windows.md b/docs/mfc/managing-mdi-child-windows.md index 378345309ed..beca42fc238 100644 --- a/docs/mfc/managing-mdi-child-windows.md +++ b/docs/mfc/managing-mdi-child-windows.md @@ -5,6 +5,7 @@ ms.date: "11/19/2018" f1_keywords: ["MDICLIENT"] helpviewer_keywords: ["MDI [MFC], child windows", "child windows [MFC], and MDICLIENT window", "MDICLIENT window [MFC]", "windows [MFC], MDI", "frame windows [MFC], MDI child windows", "child windows [MFC]", "MDI [MFC], frame windows"] ms.assetid: 1828d96e-a561-48ae-a661-ba9701de6bee +ms.topic: concept-article --- # Managing MDI Child Windows diff --git a/docs/mfc/managing-menus-control-bars-and-accelerators.md b/docs/mfc/managing-menus-control-bars-and-accelerators.md index bdd164b2c96..329610e659a 100644 --- a/docs/mfc/managing-menus-control-bars-and-accelerators.md +++ b/docs/mfc/managing-menus-control-bars-and-accelerators.md @@ -4,6 +4,7 @@ title: "Managing Menus, Control Bars, and Accelerators" ms.date: "11/04/2016" helpviewer_keywords: ["MDI [MFC], frame windows", "control bars [MFC], updating in frame windows", "menus [MFC], updating as context changes", "user interface objects [MFC], updating", "accelerator tables [MFC]", "sharing menus [MFC]", "updating user-interface objects [MFC]", "frame windows [MFC], updating", "status bars [MFC], updating"] ms.assetid: 97ca1997-06df-4373-b023-4f7ecd81047b +ms.topic: concept-article --- # Managing Menus, Control Bars, and Accelerators diff --git a/docs/mfc/managing-the-current-view.md b/docs/mfc/managing-the-current-view.md index 9a14f7cccde..ecd15ad51ec 100644 --- a/docs/mfc/managing-the-current-view.md +++ b/docs/mfc/managing-the-current-view.md @@ -4,6 +4,7 @@ title: "Managing the Current View" ms.date: "11/04/2016" helpviewer_keywords: ["views [MFC], and OnActivateView method [MFC]", "views [MFC], deactivating", "views [MFC], activating", "frame windows [MFC], current view", "OnActivateView method [MFC]", "views [MFC], current", "deactivating views [MFC]", "current view in frame window [MFC]"] ms.assetid: 0a1cc22d-d646-4536-9ad2-3cb6d7092e4a +ms.topic: concept-article --- # Managing the Current View diff --git a/docs/mfc/managing-the-state-data-of-mfc-modules.md b/docs/mfc/managing-the-state-data-of-mfc-modules.md index f40ff4f6b76..37c7bead209 100644 --- a/docs/mfc/managing-the-state-data-of-mfc-modules.md +++ b/docs/mfc/managing-the-state-data-of-mfc-modules.md @@ -4,6 +4,7 @@ title: "Managing the State Data of MFC Modules" ms.date: "11/19/2018" helpviewer_keywords: ["global state [MFC]", "data management [MFC], MFC modules", "window procedure entry points [MFC]", "exported interfaces and global state [MFC]", "module states [MFC], saving and restoring", "data management [MFC]", "MFC, managing state data", "multiple modules [MFC]", "module state restored [MFC]"] ms.assetid: 81889c11-0101-4a66-ab3c-f81cf199e1bb +ms.topic: concept-article --- # Managing the State Data of MFC Modules diff --git a/docs/mfc/manipulating-image-lists.md b/docs/mfc/manipulating-image-lists.md index 7b782d16ed5..6d92caf6d4f 100644 --- a/docs/mfc/manipulating-image-lists.md +++ b/docs/mfc/manipulating-image-lists.md @@ -4,6 +4,7 @@ title: "Manipulating Image Lists" ms.date: "11/04/2016" helpviewer_keywords: ["image lists [MFC], manipulating", "lists [MFC], image", "CImageList class [MFC], manipulating"] ms.assetid: 043418f8-077e-4dce-b8bb-2b7b0d7b5156 +ms.topic: concept-article --- # Manipulating Image Lists diff --git a/docs/mfc/manipulating-menus-during-program-execution.md b/docs/mfc/manipulating-menus-during-program-execution.md index 27ce44d928d..830ad98dea8 100644 --- a/docs/mfc/manipulating-menus-during-program-execution.md +++ b/docs/mfc/manipulating-menus-during-program-execution.md @@ -4,6 +4,7 @@ title: "Manipulating Menus During Program Execution" ms.date: "11/04/2016" helpviewer_keywords: ["menus [MFC], editing during execution", "menus during execution [MFC], deleting", "CMenu class [MFC], manipulating menus during execution", "menus [MFC], manipulating during execution", "menus during execution"] ms.assetid: 722c7c00-4be2-4967-877d-f96aaa604396 +ms.topic: concept-article --- # Manipulating Menus During Program Execution diff --git a/docs/mfc/manipulating-the-progress-control.md b/docs/mfc/manipulating-the-progress-control.md index 69a85df1a21..364d495b2c7 100644 --- a/docs/mfc/manipulating-the-progress-control.md +++ b/docs/mfc/manipulating-the-progress-control.md @@ -4,6 +4,7 @@ title: "Manipulating the Progress Control" ms.date: "11/04/2016" helpviewer_keywords: ["CProgressCtrl class [MFC], working with", "progress controls [MFC], manipulating", "CProgressCtrl class [MFC], manipulating", "controlling progress controls [MFC]", "CProgressCtrl class [MFC], using"] ms.assetid: 9af561d1-980b-4003-a6da-ff79be15bf23 +ms.topic: how-to --- # Manipulating the Progress Control diff --git a/docs/mfc/manipulating-the-tool-tip-control.md b/docs/mfc/manipulating-the-tool-tip-control.md index 0663d49d969..a368c8f8955 100644 --- a/docs/mfc/manipulating-the-tool-tip-control.md +++ b/docs/mfc/manipulating-the-tool-tip-control.md @@ -4,6 +4,7 @@ title: "Manipulating the Tool Tip Control" ms.date: "11/04/2016" helpviewer_keywords: ["CToolTipCtrl class [MFC], manipulating tool tip attributes", "tool tips [MFC], attributes"] ms.assetid: 3600afe5-712a-4b56-8456-96e85fe879af +ms.topic: concept-article --- # Manipulating the Tool Tip Control diff --git a/docs/mfc/mapi-support-in-mfc.md b/docs/mfc/mapi-support-in-mfc.md index cdb9d8b6388..10329e6fd07 100644 --- a/docs/mfc/mapi-support-in-mfc.md +++ b/docs/mfc/mapi-support-in-mfc.md @@ -21,7 +21,7 @@ MAPI needs to read the file to send the attachment. If the application keeps its #### To implement a Send Mail command with MFC -1. Use the Visual C++ menu editor to add a menu item whose command ID is ID_FILE_SEND_MAIL. +1. Use the Visual Studio menu editor to add a menu item whose command ID is ID_FILE_SEND_MAIL. This command ID is provided by the framework in AFXRES.H. The command can be added to any menu, but it is usually added to the **File** menu. diff --git a/docs/mfc/mapping-messages.md b/docs/mfc/mapping-messages.md index 58e53eb5f24..2f59ba6b40e 100644 --- a/docs/mfc/mapping-messages.md +++ b/docs/mfc/mapping-messages.md @@ -4,6 +4,7 @@ title: "Mapping Messages" ms.date: "11/04/2016" helpviewer_keywords: ["message maps [MFC], about message maps", "mappings [MFC], commands", "commands [MFC], mapping", "command mapping [MFC]", "message handling [MFC], connecting to handler functions", "commands [MFC], connecting to handler functions", "mappings [MFC], messages", "messages [MFC], mapping"] ms.assetid: 996f0652-0698-4b8c-b893-cdaa836d9d0f +ms.topic: concept-article --- # Mapping Messages diff --git a/docs/mfc/mapping-windows-messages-to-your-class.md b/docs/mfc/mapping-windows-messages-to-your-class.md index f8a7a8751e2..f34a3d5da29 100644 --- a/docs/mfc/mapping-windows-messages-to-your-class.md +++ b/docs/mfc/mapping-windows-messages-to-your-class.md @@ -4,6 +4,7 @@ title: "Mapping Windows Messages to Your Class" ms.date: "09/06/2019" helpviewer_keywords: ["MFC dialog boxes [MFC], Windows messages", "message maps [MFC], in dialog class", "Windows messages [MFC], mapping in dialog classes", "messages to dialog class [MFC]", "mappings [MFC], messages to dialog class [MFC]", "message maps [MFC], mapping Windows messages to classes", "messages to dialog class [MFC], mapping", "Class Wizard [MFC]"] ms.assetid: a4c6fd1f-1d33-47c9-baa0-001755746d6d +ms.topic: concept-article --- # Mapping Windows Messages to Your Class diff --git a/docs/mfc/menus-mfc.md b/docs/mfc/menus-mfc.md index 5cbfe9db0ff..8bbd4098c79 100644 --- a/docs/mfc/menus-mfc.md +++ b/docs/mfc/menus-mfc.md @@ -13,7 +13,7 @@ MFC supplies two elements to help you work with menus: - A mechanism for updating menus and toolbar buttons: enabling or disabling them on the fly to suit current program conditions. -Visual C++ also provides a [menu editor](../windows/menu-editor.md) for creating and editing your program's menu resources. +Visual Studio also provides a [menu editor](../windows/menu-editor.md) for creating and editing your program's menu resources. ## What do you want to know more about diff --git a/docs/mfc/message-categories.md b/docs/mfc/message-categories.md index 5bc141928a7..8f26f6242e0 100644 --- a/docs/mfc/message-categories.md +++ b/docs/mfc/message-categories.md @@ -4,6 +4,7 @@ title: "Message Categories" ms.date: "11/04/2016" helpviewer_keywords: ["messages [MFC], categories", "control-notification messages [MFC]", "Windows messages [MFC], categories", "controls [MFC], notifications", "command messages [MFC]", "messages [MFC], Windows", "message handling [MFC], message types"] ms.assetid: 68e1db75-9da6-4a4d-b2c2-dc4d59f8d87b +ms.topic: how-to --- # Message Categories diff --git a/docs/mfc/message-handlers.md b/docs/mfc/message-handlers.md index 80bf4659c7d..5e8c2495f70 100644 --- a/docs/mfc/message-handlers.md +++ b/docs/mfc/message-handlers.md @@ -13,7 +13,7 @@ Writing message handlers accounts for a large proportion of your work in writing What does the handler for a message do It does whatever you want done in response to that message. You can create the handlers by using the [Class Wizard](reference/mfc-class-wizard.md) of the class, and then fill in the handler's code using the source code editor. -You can use all of the facilities of Microsoft Visual C++ and MFC to write your handlers. For a list of all classes, see [Class Library Overview](class-library-overview.md) in the *MFC Reference*. +You can use all of the facilities of Visual Studio and MFC to write your handlers. For a list of all classes, see [Class Library Overview](class-library-overview.md) in the *MFC Reference*. ## See also diff --git a/docs/mfc/mfc-activex-controls-advanced-topics.md b/docs/mfc/mfc-activex-controls-advanced-topics.md index 12416853047..ecf01fac6b0 100644 --- a/docs/mfc/mfc-activex-controls-advanced-topics.md +++ b/docs/mfc/mfc-activex-controls-advanced-topics.md @@ -29,7 +29,7 @@ Because the ActiveX control classes are part of the class library, you can apply For a general overview of the MFC database classes, see [MFC Database Classes (DAO and ODBC)](../data/mfc-database-classes-odbc-and-dao.md). The article introduces both the MFC ODBC classes and the MFC DAO classes and directs you to more details on either. > [!NOTE] -> DAO is supported through Office 2013. DAO 3.6 is the final version, and it is considered obsolete. The Visual C++ environment and wizards do not support DAO (although the DAO classes are included and you can still use them). Microsoft recommends that you use [OLE DB Templates](../data/oledb/ole-db-programming.md) or [ODBC and MFC](../data/odbc/odbc-and-mfc.md) for new projects. You should only use DAO in maintaining existing applications. +> DAO is supported through Office 2013. DAO 3.6 is the final version, and it is considered obsolete. The Visual Studio environment and wizards do not support DAO (although the DAO classes are included and you can still use them). Microsoft recommends that you use [OLE DB Templates](../data/oledb/ole-db-programming.md) or [ODBC and MFC](../data/odbc/odbc-and-mfc.md) for new projects. You should only use DAO in maintaining existing applications. ## Implementing a Parameterized Property diff --git a/docs/mfc/mfc-activex-controls-returning-error-codes-from-a-method.md b/docs/mfc/mfc-activex-controls-returning-error-codes-from-a-method.md index aff377276ae..e657b702672 100644 --- a/docs/mfc/mfc-activex-controls-returning-error-codes-from-a-method.md +++ b/docs/mfc/mfc-activex-controls-returning-error-codes-from-a-method.md @@ -4,6 +4,7 @@ title: "MFC ActiveX Controls: Returning Error Codes From a Method" ms.date: "11/04/2016" helpviewer_keywords: ["MFC ActiveX controls [MFC], error codes", "SetNotSupported method, using", "errors [MFC], ActiveX control error codes", "GetNotSupported method [MFC]", "FireError method [MFC]", "SCODE, MFC ActiveX controls", "ThrowError method [MFC]"] ms.assetid: 771fb9c9-2413-4dcc-b386-7bc4c4adeafd +ms.topic: troubleshooting-error-codes --- # MFC ActiveX Controls: Returning Error Codes From a Method diff --git a/docs/mfc/mfc-activex-controls-using-stock-property-pages.md b/docs/mfc/mfc-activex-controls-using-stock-property-pages.md index e9553c4cef5..475aab0f011 100644 --- a/docs/mfc/mfc-activex-controls-using-stock-property-pages.md +++ b/docs/mfc/mfc-activex-controls-using-stock-property-pages.md @@ -30,7 +30,7 @@ Note that the count of property pages, in the BEGIN_PROPPAGEIDS macro, is 4. Thi After these modifications have been made, rebuild your project. Your control now has property pages for the font, picture, and color properties. > [!NOTE] -> If the control stock property pages cannot be accessed, it may be because the MFC DLL (MFCxx.DLL) has not been properly registered with the current operating system. This usually results from installing Visual C++ under an operating system different from the one currently running. +> If the control stock property pages cannot be accessed, it may be because the MFC DLL (MFCxx.DLL) has not been properly registered with the current operating system. This usually results from installing Visual Studio under an operating system different from the one currently running. > [!TIP] > If your stock property pages are not visible (see previous Note), register the DLL by running RegSvr32.exe from the command line with the full path name to the DLL. diff --git a/docs/mfc/mfc-activex-controls.md b/docs/mfc/mfc-activex-controls.md index fb744cd66d4..18ff2df6fdd 100644 --- a/docs/mfc/mfc-activex-controls.md +++ b/docs/mfc/mfc-activex-controls.md @@ -80,7 +80,7 @@ Note that a control is not responsible for obtaining access to the storage mediu ## Installing ActiveX Control Classes and Tools -When you install Visual C++, the MFC ActiveX control classes and retail and debug ActiveX control run-time DLLs are automatically installed if ActiveX controls are selected in Setup (they are selected by default). +When you install Visual Studio, the MFC ActiveX control classes and retail and debug ActiveX control run-time DLLs are automatically installed if ActiveX controls are selected in Setup (they are selected by default). By default, the ActiveX control classes and tools are installed in the following subdirectories under \Program Files\Microsoft Visual Studio .NET: diff --git a/docs/mfc/mfc-com.md b/docs/mfc/mfc-com.md index eb5282b585c..9f5a4136d12 100644 --- a/docs/mfc/mfc-com.md +++ b/docs/mfc/mfc-com.md @@ -1,16 +1,15 @@ --- -description: "Learn more about: MFC COM" title: "MFC COM" -ms.date: "09/12/2018" +description: "Learn more about: MFC COM" +ms.date: 09/12/2018 f1_keywords: ["MFC COM (MFC)"] helpviewer_keywords: ["MFC, COM support", "MFC ActiveX controls [MFC], COM support in MFC", "MFC COM [MFC]", "ActiveX controls [MFC], COM object model", "Active technology [MFC]", "COM [MFC], MFC support"] -ms.assetid: 7646bdcb-3a06-4ed5-9386-9b00f3979dcb --- # MFC COM A subset of MFC is designed to support COM, while most of the Active Template Library (ATL) is designed for COM programming. This section of topics describes MFC's support for COM. -Active technologies (such as ActiveX controls, Active document containment, OLE, and so on) use the Component Object Model (COM) to enable software components to interact with one another in a networked environment, regardless of the language with which they were created. Active technologies can be used to create applications that run on the desktop or the Internet. For more information see [Introduction to COM](../atl/introduction-to-com.md) or [The Component Object Model](/windows/win32/com/the-component-object-model). +Active technologies (such as ActiveX controls, Active document containment, OLE, and so on) use the Component Object Model (COM) to enable software components to interact with one another in a networked environment, regardless of the language with which they were created. Active technologies can be used to create applications that run on the desktop or the Internet. For more information, see [Introduction to COM](../atl/introduction-to-com.md) or [The Component Object Model](/windows/win32/com/the-component-object-model). Active technologies include both client and server technologies, including the following: diff --git a/docs/mfc/mfc-concepts.md b/docs/mfc/mfc-concepts.md index 3ff73e4812e..837ceb34f69 100644 --- a/docs/mfc/mfc-concepts.md +++ b/docs/mfc/mfc-concepts.md @@ -3,6 +3,7 @@ description: "Learn more about: MFC Concepts" title: "MFC Concepts" ms.date: "01/09/2018" f1_keywords: ["Concepts"] +ms.topic: concept-article --- # MFC Concepts diff --git a/docs/mfc/mfc-desktop-applications.md b/docs/mfc/mfc-desktop-applications.md index d1876d18607..873618fee18 100644 --- a/docs/mfc/mfc-desktop-applications.md +++ b/docs/mfc/mfc-desktop-applications.md @@ -72,8 +72,8 @@ Provides links to classes that are shared between MFC and ATL. [MFC Samples](../overview/visual-cpp-samples.md#mfc-samples)
Provides links to samples that demonstrate how to use MFC. -[Visual C++ Libraries Reference](../standard-library/cpp-standard-library-reference.md)
-Provides links to the various libraries provided with Visual C++, including ATL, MFC, OLE DB Templates, the C run-time library, and the C++ Standard Library. +[C++ Libraries Reference](../standard-library/cpp-standard-library-reference.md)
+Provides links to the various libraries provided with Visual Studio, including ATL, MFC, OLE DB Templates, the C run-time library, and the C++ Standard Library. [Debugging in Visual Studio](/visualstudio/debugger/debugging-in-visual-studio)
Provides links to using the Visual Studio debugger to correct logic errors in your application or stored procedures. diff --git a/docs/mfc/mfc-internet-programming-tasks.md b/docs/mfc/mfc-internet-programming-tasks.md index 7498fd45c93..c0911a53a89 100644 --- a/docs/mfc/mfc-internet-programming-tasks.md +++ b/docs/mfc/mfc-internet-programming-tasks.md @@ -9,7 +9,7 @@ ms.assetid: 6377e9b8-07c4-4380-b63b-05f5a9061313 This section contains detailed steps for adding Internet support to your applications. Topics include how to use the MFC classes to Internet-enable your existing applications, and how to add Active document support to your existing COM component. Do you want to create a document with up-to-the-minute stock quotes, Pittsburgh's football scores, and the latest temperature in Antarctica Microsoft provides a number of technologies to help you do that over the Internet. -Active technologies include ActiveX controls (formerly OLE controls) and Active documents; WinInet for easily retrieving and saving files across the Internet; and asynchronous monikers for efficient data downloading. Visual C++ provides wizards to help you get started quickly with a starter application. For an introduction to these technologies, see [MFC Internet Programming Basics](mfc-internet-programming-basics.md) and [MFC COM](mfc-com.md). +Active technologies include ActiveX controls (formerly OLE controls) and Active documents; WinInet for easily retrieving and saving files across the Internet; and asynchronous monikers for efficient data downloading. Visual Studio provides wizards to help you get started quickly with a starter application. For an introduction to these technologies, see [MFC Internet Programming Basics](mfc-internet-programming-basics.md) and [MFC COM](mfc-com.md). Have you always wanted to FTP a file but haven't learned WinSock and network programming protocols WinInet classes encapsulate these protocols, providing you with a simple set of functions you can use to write a client application on the Internet to download files using HTTP, FTP, and gopher. You can use WinInet to search directories on your hard drive or around the world. You can transparently collect data of several different types, and present it to the user in an integrated interface. diff --git a/docs/mfc/mfc-library-versions.md b/docs/mfc/mfc-library-versions.md index bafc3f49141..ff6462e70e0 100644 --- a/docs/mfc/mfc-library-versions.md +++ b/docs/mfc/mfc-library-versions.md @@ -100,7 +100,7 @@ Debugger files that have the same base name and a .pdb extension are also availa The MFC shared DLLs also follow a structured naming convention. This makes it easier to know which DLL or library you should be using for which purpose. -The MFC DLLs have *version* numbers that indicate binary compatibility. Use MFC DLLs that have the same version as your other libraries and compiler toolset to guarantee compatibility within a project. +The MFC DLLs have *version* numbers that indicate binary compatibility. Use MFC DLLs that have the same version as your other libraries and compiler build tools to guarantee compatibility within a project. |DLL|Description| |---------|-----------------| diff --git a/docs/mfc/mfc-mbcs-dll-add-on.md b/docs/mfc/mfc-mbcs-dll-add-on.md index 154e05d42f4..f64676d47cd 100644 --- a/docs/mfc/mfc-mbcs-dll-add-on.md +++ b/docs/mfc/mfc-mbcs-dll-add-on.md @@ -10,7 +10,7 @@ Support for MFC and its multibyte character set (MBCS) libraries requires an add **Visual Studio 2013**: By default, the MFC libraries installed in Visual Studio 2013 only support Unicode development. You need the MBCS DLLs in order to build an MFC project in Visual Studio 2013 that has the **Character Set** property set to **Use Multi-Byte Character Set** or **Not Set**. Download the DLL at [Multibyte MFC Library for Visual Studio 2013](https://www.microsoft.com/download/details.aspx?id=40770). -**Visual Studio 2015**: Both Unicode and MBCS MFC DLLs are included in the Visual C++ setup components, but support for MFC is not installed by default. Visual C++ and MFC are optional install configurations in Visual Studio setup. To make sure that MFC is installed, choose **Custom** in setup, and under **Programming Languages**, make sure that **Visual C++** and **Microsoft Foundation Classes for C++** are selected. If you have already installed Visual Studio, you will be prompted to install Visual C++ and/or MFC when you attempt to create an MFC project. +**Visual Studio 2015**: Both Unicode and MBCS MFC DLLs are included in the Visual C++ setup components, but support for MFC is not installed by default. Visual C++ and MFC are optional install configurations in Visual Studio setup. To make sure that MFC is installed, choose **Custom** in setup, and under **Programming Languages**, make sure that **Visual C++** and ****Microsoft Foundation Classes for C++** are selected. If you have already installed Visual Studio, you will be prompted to install Visual C++ and/or MFC when you attempt to create an MFC project. **Visual Studio 2017 and later**: The Unicode and MBCS MFC DLLs are installed with the **Desktop development with C++** workload when you select **MFC and ATL support** from the **Optional Components** pane in the Visual Studio Installer program. If your installation does not include these components, navigate to the **File | New Projects** dialog and click the **Open Visual Studio Installer** link. For more information, see [Install Visual Studio](/visualstudio/install/install-visual-studio). diff --git a/docs/mfc/mfc-toolbar-implementation.md b/docs/mfc/mfc-toolbar-implementation.md index 696dfdd3cd3..66b9d9ee497 100644 --- a/docs/mfc/mfc-toolbar-implementation.md +++ b/docs/mfc/mfc-toolbar-implementation.md @@ -69,7 +69,7 @@ Also see the MFC General sample [DOCKTOOL](../overview/visual-cpp-samples.md). ## The Toolbar Bitmap -Once constructed, a `CToolBar` object creates the toolbar image by loading a single bitmap that contains one image for each button. The Application Wizard creates a standard toolbar bitmap that you can customize with the Visual C++ [toolbar editor](../windows/toolbar-editor.md). +Once constructed, a `CToolBar` object creates the toolbar image by loading a single bitmap that contains one image for each button. The Application Wizard creates a standard toolbar bitmap that you can customize with the Visual Studio [toolbar editor](../windows/toolbar-editor.md). ### What do you want to know more about diff --git a/docs/mfc/multiple-document-types-views-and-frame-windows.md b/docs/mfc/multiple-document-types-views-and-frame-windows.md index f24bb3620a6..bca21f51732 100644 --- a/docs/mfc/multiple-document-types-views-and-frame-windows.md +++ b/docs/mfc/multiple-document-types-views-and-frame-windows.md @@ -64,7 +64,7 @@ In a splitter window, the window is, or can be, split into two or more scrollabl Dynamic splitter windows, with views of the same class, allow the user to split a window into multiple panes at will and then scroll different panes to see different parts of the document. The user can also unsplit the window to remove the additional views. The splitter windows added to the [Scribble sample](../overview/visual-cpp-samples.md) are an example. That topic describes the technique for creating dynamic splitter windows. A dynamic splitter window is shown in part b of the figure Multiple-View User Interfaces. -Static splitter windows, with views of different classes, start with the window split into multiple panes, each with a different purpose. For example, in the Visual C++ bitmap editor, the image window shows two panes side by side. The left-hand pane displays a life-sized image of the bitmap. The right-hand pane displays a zoomed or magnified image of the same bitmap. The panes are separated by a "splitter bar" that the user can drag to change the relative sizes of the panes. A static splitter window is shown in part c of the figure Multiple-View User Interfaces. +Static splitter windows, with views of different classes, start with the window split into multiple panes, each with a different purpose. For example, in the Visual Studio bitmap editor, the image window shows two panes side by side. The left-hand pane displays a life-sized image of the bitmap. The right-hand pane displays a zoomed or magnified image of the same bitmap. The panes are separated by a "splitter bar" that the user can drag to change the relative sizes of the panes. A static splitter window is shown in part c of the figure Multiple-View User Interfaces. For more information, see class [CSplitterWnd](reference/csplitterwnd-class.md) in the *MFC Reference* and [MFC Samples](../overview/visual-cpp-samples.md#mfc-samples). diff --git a/docs/mfc/on-update-command-ui-macro.md b/docs/mfc/on-update-command-ui-macro.md index b5eb0ecd791..12493f28551 100644 --- a/docs/mfc/on-update-command-ui-macro.md +++ b/docs/mfc/on-update-command-ui-macro.md @@ -5,6 +5,7 @@ ms.date: "09/06/2019" f1_keywords: ["ON_UPDATE_COMMAND_UI"] helpviewer_keywords: ["ON_UPDATE_COMMAND_UI macro [MFC]", "update handlers [MFC]", "command-handler macros", "updating user-interface objects [MFC]"] ms.assetid: 3e72b50f-4119-4c82-81cf-6e09b132de05 +ms.topic: reference --- # ON_UPDATE_COMMAND_UI Macro diff --git a/docs/mfc/opening-files.md b/docs/mfc/opening-files.md index c758c1bb9c6..1901d6e2ee4 100644 --- a/docs/mfc/opening-files.md +++ b/docs/mfc/opening-files.md @@ -4,6 +4,7 @@ title: "Opening Files" ms.date: "11/04/2016" helpviewer_keywords: ["Open member functions [MFC]", "CFile class [MFC], variable", "opening files, in MFC", "Open calls [MFC]", "Open method, CFile class [MFC]", "examples [MFC], opening files", "opening files, handling exceptions", "exception handling [MFC], when opening files", "files [MFC], opening", "file objects [MFC]", "MFC, file operations", "opening files [MFC]", "exception handling [MFC], opening files"] ms.assetid: a991b8ec-b04a-4766-b47e-7485b5dd0b01 +ms.topic: how-to --- # Opening Files diff --git a/docs/mfc/optimizing-control-drawing.md b/docs/mfc/optimizing-control-drawing.md index 389d769e750..f66c88ff25b 100644 --- a/docs/mfc/optimizing-control-drawing.md +++ b/docs/mfc/optimizing-control-drawing.md @@ -4,6 +4,7 @@ title: "Optimizing Control Drawing" ms.date: "11/04/2016" helpviewer_keywords: ["MFC ActiveX controls [MFC], optimizing"] ms.assetid: 29ff985d-9bf5-4678-b62d-aad12def75fb +ms.topic: concept-article --- # Optimizing Control Drawing diff --git a/docs/mfc/optimizing-persistence-and-initialization.md b/docs/mfc/optimizing-persistence-and-initialization.md index 51e8befc886..6fa231bfd5b 100644 --- a/docs/mfc/optimizing-persistence-and-initialization.md +++ b/docs/mfc/optimizing-persistence-and-initialization.md @@ -4,6 +4,7 @@ title: "Optimizing Persistence and Initialization" ms.date: "11/04/2016" helpviewer_keywords: ["MFC ActiveX controls [MFC], optimizing", "performance, ActiveX controls", "optimization, ActiveX controls", "optimizing performance, ActiveX controls"] ms.assetid: e821e19e-b9eb-49ab-b719-0743420ba80b +ms.topic: concept-article --- # Optimizing Persistence and Initialization diff --git a/docs/mfc/orchestrating-other-window-actions.md b/docs/mfc/orchestrating-other-window-actions.md index 41b8115884e..d58e98acd28 100644 --- a/docs/mfc/orchestrating-other-window-actions.md +++ b/docs/mfc/orchestrating-other-window-actions.md @@ -4,6 +4,7 @@ title: "Orchestrating Other Window Actions" ms.date: "11/04/2016" helpviewer_keywords: ["frame windows [MFC], print preview", "context-sensitive Help [MFC], frame windows", "print preview [MFC], and frame windows", "frame windows [MFC], context-sensitive Help", "frame windows [MFC], semimodal states", "context-sensitive Help [MFC]"] ms.assetid: 5f34eea8-2bf8-4479-95c7-45e8f443db8f +ms.topic: concept-article --- # Orchestrating Other Window Actions diff --git a/docs/mfc/ordering-items-in-the-header-control.md b/docs/mfc/ordering-items-in-the-header-control.md index 5dfc66ea144..8fecf83fd9a 100644 --- a/docs/mfc/ordering-items-in-the-header-control.md +++ b/docs/mfc/ordering-items-in-the-header-control.md @@ -5,6 +5,7 @@ ms.date: "11/04/2016" f1_keywords: ["DS_DRAGDROP"] helpviewer_keywords: ["sequence [MFC]", "sequence [MFC], header control items", "OrderToIndex method [MFC]", "DS_DRAGDROP notification [MFC]", "GetOrderArray method [MFC]", "SetOrderArray method [MFC]", "header controls [MFC], ordering items"] ms.assetid: 5aaef872-75b5-49c5-8fed-6f9a81fca812 +ms.topic: concept-article --- # Ordering Items in the Header Control diff --git a/docs/mfc/overriding-the-standard-command-routing.md b/docs/mfc/overriding-the-standard-command-routing.md index df1c2ddbd3c..ba18313793a 100644 --- a/docs/mfc/overriding-the-standard-command-routing.md +++ b/docs/mfc/overriding-the-standard-command-routing.md @@ -4,6 +4,7 @@ title: "Overriding the Standard Command Routing" ms.date: "11/04/2016" helpviewer_keywords: ["MFC, command routing", "command routing [MFC], overriding", "command handling [MFC], routing commands", "overriding, standard command routing"] ms.assetid: 872b698a-7432-40c4-9008-68721e8effa5 +ms.topic: concept-article --- # Overriding the Standard Command Routing diff --git a/docs/mfc/overview-of-the-rich-edit-control.md b/docs/mfc/overview-of-the-rich-edit-control.md index e14a976fb89..ae897f634ab 100644 --- a/docs/mfc/overview-of-the-rich-edit-control.md +++ b/docs/mfc/overview-of-the-rich-edit-control.md @@ -4,6 +4,7 @@ title: "Overview of the Rich Edit Control" ms.date: "11/04/2016" helpviewer_keywords: ["rich edit controls [MFC]"] ms.assetid: ad589b9f-a3fd-4820-bf1f-6b1965997e68 +ms.topic: concept-article --- # Overview of the Rich Edit Control diff --git a/docs/mfc/printing-and-print-preview.md b/docs/mfc/printing-and-print-preview.md index 5ad4329b9a7..b2ca6172204 100644 --- a/docs/mfc/printing-and-print-preview.md +++ b/docs/mfc/printing-and-print-preview.md @@ -4,6 +4,7 @@ title: "Printing and Print Preview" ms.date: "11/04/2016" helpviewer_keywords: ["printing [MFC]", "previewing printing", "printing [MFC]", "print preview", "printing [MFC], print preview"] ms.assetid: d15059cd-32de-4450-95f7-e73aece238f6 +ms.topic: concept-article --- # Printing and Print Preview diff --git a/docs/mfc/printing-in-rich-edit-controls.md b/docs/mfc/printing-in-rich-edit-controls.md index 21c9af612a1..b984736a3ff 100644 --- a/docs/mfc/printing-in-rich-edit-controls.md +++ b/docs/mfc/printing-in-rich-edit-controls.md @@ -4,6 +4,7 @@ title: "Printing in Rich Edit Controls" ms.date: "11/04/2016" helpviewer_keywords: ["printing [MFC], CRichEditCtrl", "rich edit controls [MFC], printing", "CRichEditCtrl class [MFC], printing"] ms.assetid: dbda0e40-018f-424e-b5d8-7b489aaf27af +ms.topic: concept-article --- # Printing in Rich Edit Controls diff --git a/docs/mfc/printing.md b/docs/mfc/printing.md index 2e4c83c98ff..58d2fd9d619 100644 --- a/docs/mfc/printing.md +++ b/docs/mfc/printing.md @@ -4,6 +4,7 @@ title: "Printing" ms.date: "11/04/2016" helpviewer_keywords: ["view classes [MFC], print operations", "documents [MFC], printing", "printing [MFC], from framework", "printing [MFC]"] ms.assetid: be465e8d-b0c9-4fc5-9fa8-d10486064f76 +ms.topic: concept-article --- # Printing diff --git a/docs/mfc/processing-header-control-notifications.md b/docs/mfc/processing-header-control-notifications.md index 5e4ec0c1a28..0c3aa456c2d 100644 --- a/docs/mfc/processing-header-control-notifications.md +++ b/docs/mfc/processing-header-control-notifications.md @@ -4,6 +4,7 @@ title: "Processing Header-Control Notifications" ms.date: "11/04/2016" helpviewer_keywords: ["CHeaderCtrl class [MFC], processing notifications", "controls [MFC], header", "notifications [MFC], processing for CHeaderCtrl", "header controls [MFC], processing notifications", "header control notifications"] ms.assetid: e6c6af7c-d458-4d33-85aa-48014ccde5f6 +ms.topic: concept-article --- # Processing Header-Control Notifications diff --git a/docs/mfc/processing-notification-messages-in-a-rebar-control.md b/docs/mfc/processing-notification-messages-in-a-rebar-control.md index 4a606ad68ea..d4b1a732bd9 100644 --- a/docs/mfc/processing-notification-messages-in-a-rebar-control.md +++ b/docs/mfc/processing-notification-messages-in-a-rebar-control.md @@ -4,6 +4,7 @@ title: "Processing Notification Messages in a Rebar Control" ms.date: "11/04/2016" helpviewer_keywords: ["RBN_ notification messages, description of", "CReBarCtrl class [MFC], notification messages sent by", "RBN_ notification messages [MFC]", "notifications [MFC], CReBarCtrl"] ms.assetid: 40f43a60-0c18-4d8d-8fab-213a095624f9 +ms.topic: concept-article --- # Processing Notification Messages in a Rebar Control diff --git a/docs/mfc/processing-notification-messages-in-date-and-time-picker-controls.md b/docs/mfc/processing-notification-messages-in-date-and-time-picker-controls.md index 40487fce818..e8d46f354f6 100644 --- a/docs/mfc/processing-notification-messages-in-date-and-time-picker-controls.md +++ b/docs/mfc/processing-notification-messages-in-date-and-time-picker-controls.md @@ -5,6 +5,7 @@ ms.date: "11/04/2016" f1_keywords: ["DTN_CLOSEUP", "DTN_DATETIMECHANGE", "DTN_DROPDOWN"] helpviewer_keywords: ["DTN_DROPDOWN notification [MFC]", "DTN_DATETIMECHANGE notification [MFC]", "DTN_CLOSEUP notification [MFC]", "DateTimePicker control [MFC], handling notifications", "CDateTimeCtrl class [MFC], handling notifications", "DTN_FORMAT notification [MFC]", "DateTimePicker control [MFC]"] ms.assetid: ffbe29ab-ff80-4609-89f7-260b404439c4 +ms.topic: concept-article --- # Processing Notification Messages in Date and Time Picker Controls diff --git a/docs/mfc/processing-notification-messages-in-extended-combo-box-controls.md b/docs/mfc/processing-notification-messages-in-extended-combo-box-controls.md index f6f17343c9d..17f7c1247f2 100644 --- a/docs/mfc/processing-notification-messages-in-extended-combo-box-controls.md +++ b/docs/mfc/processing-notification-messages-in-extended-combo-box-controls.md @@ -4,6 +4,7 @@ title: "Processing Notification Messages in Extended Combo Box Controls" ms.date: "11/04/2016" helpviewer_keywords: ["extended combo boxes [MFC], notifications", "notifications [MFC], extended combo box controls"] ms.assetid: 4e442758-d054-4746-bb1a-6ff84accb127 +ms.topic: concept-article --- # Processing Notification Messages in Extended Combo Box Controls diff --git a/docs/mfc/processing-notification-messages-in-list-controls.md b/docs/mfc/processing-notification-messages-in-list-controls.md index 2f76695521d..9381aeaa0e5 100644 --- a/docs/mfc/processing-notification-messages-in-list-controls.md +++ b/docs/mfc/processing-notification-messages-in-list-controls.md @@ -4,6 +4,7 @@ title: "Processing Notification Messages in List Controls" ms.date: "11/04/2016" helpviewer_keywords: ["processing notifications [MFC]", "CListCtrl class [MFC], processing notifications"] ms.assetid: 1f0e296e-d2a3-48fc-ae38-51d7fb096f51 +ms.topic: concept-article --- # Processing Notification Messages in List Controls diff --git a/docs/mfc/processing-notification-messages-in-month-calendar-controls.md b/docs/mfc/processing-notification-messages-in-month-calendar-controls.md index 2effdb45f93..7f2c355b6a3 100644 --- a/docs/mfc/processing-notification-messages-in-month-calendar-controls.md +++ b/docs/mfc/processing-notification-messages-in-month-calendar-controls.md @@ -4,6 +4,7 @@ title: "Processing Notification Messages in Month Calendar Controls" ms.date: "11/04/2016" helpviewer_keywords: ["CMonthCalCtrl class [MFC], notifications", "CMonthCalCtrl class [MFC], day states", "month calendar controls [MFC], notification messages", "notifications [MFC], for CMonthCalCtrl", "notifications [MFC], month calendar control"] ms.assetid: 607c3e90-0756-493b-9503-ce835a50c7ab +ms.topic: concept-article --- # Processing Notification Messages in Month Calendar Controls diff --git a/docs/mfc/processing-tab-control-notification-messages.md b/docs/mfc/processing-tab-control-notification-messages.md index a0abab7d8aa..04bb96866dd 100644 --- a/docs/mfc/processing-tab-control-notification-messages.md +++ b/docs/mfc/processing-tab-control-notification-messages.md @@ -4,6 +4,7 @@ title: "Processing Tab Control Notification Messages" ms.date: "11/04/2016" helpviewer_keywords: ["notifications [MFC], tab controls", "CTabCtrl class [MFC], processing notifications", "notifications [MFC], processing in CTabCtrl", "processing notifications [MFC]", "tab controls [MFC], processing notifications"] ms.assetid: 758ccb7a-9e73-48f8-9073-23f7cb09918c +ms.topic: concept-article --- # Processing Tab Control Notification Messages diff --git a/docs/mfc/programming-activex-controls-in-a-activex-control-container.md b/docs/mfc/programming-activex-controls-in-a-activex-control-container.md index 43334e14538..594f5d61f3c 100644 --- a/docs/mfc/programming-activex-controls-in-a-activex-control-container.md +++ b/docs/mfc/programming-activex-controls-in-a-activex-control-container.md @@ -44,7 +44,7 @@ Once the Circ control is inserted into the project (step 1), insert an instance ## Modifications to the Project -To enable the Container application to access the Circ control, Visual C++ automatically adds the wrapper class (`CCirc`) implementation file (.CPP) to the Container project and the wrapper class header (.H) file to the dialog box header file: +To enable the Container application to access the Circ control, Visual Studio automatically adds the wrapper class (`CCirc`) implementation file (.CPP) to the Container project and the wrapper class header (.H) file to the dialog box header file: [!code-cpp[NVC_MFC_AxCont#1](../mfc/codesnippet/cpp/programming-activex-controls-in-a-activex-control-container_1.h)] @@ -59,7 +59,7 @@ These functions can then be called from other of the application's procedures us ## Member Variable Modifications to the Project -Once the ActiveX control has been added to the project and embedded in a dialog box container, it can be accessed by other parts of the project. The easiest way to access the control is to [create a member variable](../mfc/activex-control-containers-connecting-an-activex-control-to-a-member-variable.md) of the dialog class, `CContainerDlg` (step 2), that is of the same type as the wrapper class added to the project by Visual C++. You can then use the member variable to access the embedded control at any time. +Once the ActiveX control has been added to the project and embedded in a dialog box container, it can be accessed by other parts of the project. The easiest way to access the control is to [create a member variable](../mfc/activex-control-containers-connecting-an-activex-control-to-a-member-variable.md) of the dialog class, `CContainerDlg` (step 2), that is of the same type as the wrapper class added to the project by Visual Studio. You can then use the member variable to access the embedded control at any time. When the **Add Member Variable** dialog box adds the *m_circctl* member variable to the project, it also adds the following lines to the header file (.H) of the `CContainerDlg` class: diff --git a/docs/mfc/property-sheets-and-property-pages-mfc.md b/docs/mfc/property-sheets-and-property-pages-mfc.md index 66e1363c041..6fa12970360 100644 --- a/docs/mfc/property-sheets-and-property-pages-mfc.md +++ b/docs/mfc/property-sheets-and-property-pages-mfc.md @@ -2,12 +2,12 @@ description: "Learn more about: Property Sheets and Property Pages (MFC)" title: "Property Sheets and Property Pages (MFC)" ms.date: "11/04/2016" -helpviewer_keywords: ["MFC dialog boxes [MFC], tabs", "property pages [MFC], property sheets", "CPropertyPage class [MFC], property sheets and pages", "CPropertySheet class [MFC], property sheets and pages", "property sheets, propert pages"] +helpviewer_keywords: ["MFC dialog boxes [MFC], tabs", "property pages [MFC], property sheets", "CPropertyPage class [MFC], property sheets and pages", "CPropertySheet class [MFC], property sheets and pages", "property sheets, property pages"] ms.assetid: de8fea12-6c35-4cef-8625-b8073a379446 --- # Property Sheets and Property Pages (MFC) -An MFC [dialog box](../mfc/dialog-boxes.md) can take on a "tab dialog" look by incorporating property sheets and property pages. Called a "property sheet" in MFC, this kind of dialog box, similar to many dialog boxes in Microsoft Word, Excel, and Visual C++, appears to contain a stack of tabbed sheets, much like a stack of file folders seen from front to back, or a group of cascaded windows. Controls on the front tab are visible; only the labeled tab is visible on the rear tabs. Property sheets are particularly useful for managing large numbers of properties or settings that fall fairly neatly into several groups. Typically, one property sheet can simplify a user interface by replacing several separate dialog boxes. +An MFC [dialog box](../mfc/dialog-boxes.md) can take on a "tab dialog" look by incorporating property sheets and property pages. Called a "property sheet" in MFC, this kind of dialog box, similar to many dialog boxes in Microsoft Word, Excel, and Visual Studio, appears to contain a stack of tabbed sheets, much like a stack of file folders seen from front to back, or a group of cascaded windows. Controls on the front tab are visible; only the labeled tab is visible on the rear tabs. Property sheets are particularly useful for managing large numbers of properties or settings that fall fairly neatly into several groups. Typically, one property sheet can simplify a user interface by replacing several separate dialog boxes. As of MFC version 4.0, property sheets and property pages are implemented using the common controls that come with Windows 95 and Windows NT version 3.51 and later. diff --git a/docs/mfc/providing-drag-and-drop-support-for-header-items.md b/docs/mfc/providing-drag-and-drop-support-for-header-items.md index e3c3b78cab3..0d8f5e116fa 100644 --- a/docs/mfc/providing-drag-and-drop-support-for-header-items.md +++ b/docs/mfc/providing-drag-and-drop-support-for-header-items.md @@ -4,6 +4,7 @@ title: "Providing Drag-and-Drop Support for Header Items" ms.date: "11/04/2016" helpviewer_keywords: ["HDS_DRAGDROP style", "header items in header controls", "CHeaderCtrl class [MFC], drag and drop support", "HDN_ notifications [MFC]"] ms.assetid: 93a152ec-804f-488f-b260-b3a438d0dc0f +ms.topic: concept-article --- # Providing Drag-and-Drop Support for Header Items diff --git a/docs/mfc/providing-flicker-free-activation.md b/docs/mfc/providing-flicker-free-activation.md index e4f3a54191d..177d650be4e 100644 --- a/docs/mfc/providing-flicker-free-activation.md +++ b/docs/mfc/providing-flicker-free-activation.md @@ -4,6 +4,7 @@ title: "Providing Flicker-Free Activation" ms.date: "11/04/2016" helpviewer_keywords: ["MFC ActiveX controls [MFC], flicker-free", "flicker, MFC ActiveX controls", "activation [MFC], flicker-free"] ms.assetid: bcb24b77-31d8-44a0-8c58-2ea6213b4c43 +ms.topic: concept-article --- # Providing Flicker-Free Activation diff --git a/docs/mfc/providing-mouse-interaction-while-inactive.md b/docs/mfc/providing-mouse-interaction-while-inactive.md index 0cc692d9e05..21a2b685851 100644 --- a/docs/mfc/providing-mouse-interaction-while-inactive.md +++ b/docs/mfc/providing-mouse-interaction-while-inactive.md @@ -4,6 +4,7 @@ title: "Providing Mouse Interaction While Inactive" ms.date: "11/04/2016" helpviewer_keywords: ["MFC ActiveX controls [MFC], mouse interaction"] ms.assetid: b09106bf-44c7-4b9b-a6d9-0d624f16f5b3 +ms.topic: concept-article --- # Providing Mouse Interaction While Inactive diff --git a/docs/mfc/providing-windowless-activation.md b/docs/mfc/providing-windowless-activation.md index b78c0e19c41..cf11fd11d9b 100644 --- a/docs/mfc/providing-windowless-activation.md +++ b/docs/mfc/providing-windowless-activation.md @@ -4,6 +4,7 @@ title: "Providing Windowless Activation" ms.date: "11/04/2016" helpviewer_keywords: ["windowless activation of MFC ActiveX controls", "activation [MFC], MFC ActiveX controls", "MFC ActiveX controls [MFC], activate options", "activation [MFC], windowless"] ms.assetid: 094903b5-c344-42fa-96ff-ce01e16891c5 +ms.topic: concept-article --- # Providing Windowless Activation diff --git a/docs/mfc/reading-and-writing-files.md b/docs/mfc/reading-and-writing-files.md index 0ef0ecd046b..22afa9e55f8 100644 --- a/docs/mfc/reading-and-writing-files.md +++ b/docs/mfc/reading-and-writing-files.md @@ -4,6 +4,7 @@ title: "Reading and Writing Files" ms.date: "11/04/2016" helpviewer_keywords: ["CFile class [MFC], objects", "examples [MFC], reading files", "files [MFC], writing to", "examples [MFC], writing to files", "files [MFC], reading", "MFC, file operations", "CFile class [MFC], reading and writing CFile objects", "reading files", "writing to files [MFC]"] ms.assetid: cac0c826-ba56-495f-99b3-ce6336f65763 +ms.topic: how-to --- # Reading and Writing Files diff --git a/docs/mfc/receiving-notification-from-common-controls.md b/docs/mfc/receiving-notification-from-common-controls.md index ee2aadff48d..8e783462914 100644 --- a/docs/mfc/receiving-notification-from-common-controls.md +++ b/docs/mfc/receiving-notification-from-common-controls.md @@ -4,6 +4,7 @@ title: "Receiving Notification from Common Controls" ms.date: "11/04/2016" helpviewer_keywords: ["OnNotify method [MFC]", "common controls [MFC], notifications", "ON_NOTIFY macro [MFC]", "controls [MFC], notifications", "receiving notifications from common controls", "notifications [MFC], common controls", "Windows common controls [MFC], notifications", "WM_NOTIFY message"] ms.assetid: 50194592-d60d-44d0-8ab3-338a2a2c63e7 +ms.topic: concept-article --- # Receiving Notification from Common Controls diff --git a/docs/mfc/reference/add-interface-definition-library-mfc-property-wizard.md b/docs/mfc/reference/add-interface-definition-library-mfc-property-wizard.md index 5ac27990ea7..91fc8ecb27e 100644 --- a/docs/mfc/reference/add-interface-definition-library-mfc-property-wizard.md +++ b/docs/mfc/reference/add-interface-definition-library-mfc-property-wizard.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: Use the Microsoft Visual Studio Add IDL MFC property wizard to add a property to an IDL interface in your MFC or ATL project" title: "Add an IDL MFC property" -ms.date: "04/14/2022" +description: "Learn more about: Use the Microsoft Visual Studio Add IDL MFC property wizard to add a property to an IDL interface in your MFC or ATL project" +ms.date: 04/14/2022 f1_keywords: ["vc.codewiz.prop.overview"] helpviewer_keywords: ["interfaces, adding properties", "properties [C++], adding to interfaces", "names, add property wizard", "add property wizard", "stock properties, about stock properties", "stock properties"] ms.custom: devdivchpfy22 @@ -167,7 +167,7 @@ If you're adding a property to an MFC dispinterface, you can choose one of the f |`ReadyState`|Returns or sets the control's `ReadyState` property.
A control can be uninitialized, initialized, loading, interactive, or complete.
For more information, see [READYSTATE](/previous-versions/aa768362\(v=vs.85\)) in the *Internet SDK*.| |`Text`|Returns or sets the text contained in a control.
Has no **Member variable** implementation type.| -## See Also +## See also [Add Property](../../ide/adding-a-property-visual-cpp.md) diff --git a/docs/mfc/reference/application-control.md b/docs/mfc/reference/application-control.md index 8c32271d69c..71d0ea63f2b 100644 --- a/docs/mfc/reference/application-control.md +++ b/docs/mfc/reference/application-control.md @@ -1,9 +1,8 @@ --- -description: "Learn more about: Application Control" title: "Application Control" -ms.date: "11/04/2016" +description: "Learn more about: Application Control" +ms.date: 11/04/2016 helpviewer_keywords: ["application control [MFC]"] -ms.assetid: c1f69f15-e0fe-4515-9f36-d63d31869deb --- # Application Control @@ -258,7 +257,7 @@ Nonzero if the server class is successfully registered; otherwise 0. Most applications can use `COleTemplateServer::Register` to register the application's document types. If your application's system-registry format does not fit the typical pattern, you can use `AfxOleRegisterServerClass` for more control. -The registry consists of a set of keys and values. The *rglpszRegister* and *rglpszOverwrite* arguments are arrays of pointers to strings, each consisting of a key and a value separated by a **NULL** character ( `'\0'`). Each of these strings can have replaceable parameters whose places are marked by the character sequences *%1* through *%5*. +The registry consists of a set of keys and values. The *rglpszRegister* and *rglpszOverwrite* arguments are arrays of pointers to strings, each consisting of a key and a value separated by a **NULL** character (`'\0'`). Each of these strings can have replaceable parameters whose places are marked by the character sequences *%1* through *%5*. The symbols are filled in as follows: diff --git a/docs/mfc/reference/application-information-and-management.md b/docs/mfc/reference/application-information-and-management.md index cffc7c4c52f..4c97fa5d41a 100644 --- a/docs/mfc/reference/application-information-and-management.md +++ b/docs/mfc/reference/application-information-and-management.md @@ -1,9 +1,8 @@ --- title: "Application Information and Management" description: "Reference to the Microsoft Foundation Class library (MFC) application information and management functions." -ms.date: "01/27/2020" +ms.date: 01/27/2020 helpviewer_keywords: ["applications [MFC], managing"] -ms.assetid: b72f4154-24db-4e75-bca3-6873e2459c15 --- # Application Information and Management @@ -173,6 +172,7 @@ HINSTANCE AFXAPI AfxFindResourceHandle( LPCTSTR lpszName, LPCTSTR lpszType ); *`lpszName`*\ A pointer to a string containing the resource ID. + *`lpszType`*\ A pointer to the type of resource. For a list of resource types, see [`FindResource`](/windows/win32/api/winbase/nf-winbase-findresourcea) in the Windows SDK. @@ -414,7 +414,7 @@ This function is provided for backward compatibility. New applications should us `AfxInitRichEdit` loads `RICHED32.DLL` to initialize version 1.0 of the rich edit control. To use version 2.0 and 3.0 of the rich edit control, `RICHED20.DLL` needs to be loaded. It's loaded by making a call to [`AfxInitRichEdit2`](#afxinitrichedit2). -To update rich edit controls in existing Visual C++ applications to version 2.0, open the .RC file as text, change the class name of each rich edit control from "`RICHEDIT`" to "`RichEdit20a`". Then replace the call to `AfxInitRichEdit` with `AfxInitRichEdit2`. +To update rich edit controls in existing Visual Studio applications to version 2.0, open the .RC file as text, change the class name of each rich edit control from "`RICHEDIT`" to "`RichEdit20a`". Then replace the call to `AfxInitRichEdit` with `AfxInitRichEdit2`. This function also initializes the common controls library, if the library hasn't already been initialized for the process. If you use the rich edit control directly from your MFC application, call this function to assure that MFC has properly initialized the rich edit control runtime. If you call the `Create` method of [`CRichEditCtrl`](../../mfc/reference/cricheditctrl-class.md), [`CRichEditView`](../../mfc/reference/cricheditview-class.md), or [`CRichEditDoc`](../../mfc/reference/cricheditdoc-class.md), you typically don't need to call this function, but in some cases it might be necessary. diff --git a/docs/mfc/reference/buffercommand-enumeration.md b/docs/mfc/reference/buffercommand-enumeration.md index 347d457d898..23d430be1aa 100644 --- a/docs/mfc/reference/buffercommand-enumeration.md +++ b/docs/mfc/reference/buffercommand-enumeration.md @@ -11,7 +11,7 @@ Used by [CMemFile::GetBufferPtr](cmemfile-class.md#getbufferptr) to determine wh ## Syntax -``` cpp +```cpp public enum BufferCommand { bufferRead, diff --git a/docs/mfc/reference/carchive-class.md b/docs/mfc/reference/carchive-class.md index 043ef933ebb..8d8f606693b 100644 --- a/docs/mfc/reference/carchive-class.md +++ b/docs/mfc/reference/carchive-class.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: CArchive Class" title: "CArchive Class" -ms.date: "11/04/2016" +description: "Learn more about: CArchive Class" +ms.date: 11/04/2016 f1_keywords: ["CArchive", "AFX/CArchive", "AFX/CArchive::CArchive", "AFX/CArchive::Abort", "AFX/CArchive::Close", "AFX/CArchive::Flush", "AFX/CArchive::GetFile", "AFX/CArchive::GetObjectSchema", "AFX/CArchive::IsBufferEmpty", "AFX/CArchive::IsLoading", "AFX/CArchive::IsStoring", "AFX/CArchive::MapObject", "AFX/CArchive::Read", "AFX/CArchive::ReadClass", "AFX/CArchive::ReadObject", "AFX/CArchive::ReadString", "AFX/CArchive::SerializeClass", "AFX/CArchive::SetLoadParams", "AFX/CArchive::SetObjectSchema", "AFX/CArchive::SetStoreParams", "AFX/CArchive::Write", "AFX/CArchive::WriteClass", "AFX/CArchive::WriteObject", "AFX/CArchive::WriteString", "AFX/CArchive::m_pDocument"] helpviewer_keywords: ["CArchive [MFC], CArchive", "CArchive [MFC], Abort", "CArchive [MFC], Close", "CArchive [MFC], Flush", "CArchive [MFC], GetFile", "CArchive [MFC], GetObjectSchema", "CArchive [MFC], IsBufferEmpty", "CArchive [MFC], IsLoading", "CArchive [MFC], IsStoring", "CArchive [MFC], MapObject", "CArchive [MFC], Read", "CArchive [MFC], ReadClass", "CArchive [MFC], ReadObject", "CArchive [MFC], ReadString", "CArchive [MFC], SerializeClass", "CArchive [MFC], SetLoadParams", "CArchive [MFC], SetObjectSchema", "CArchive [MFC], SetStoreParams", "CArchive [MFC], Write", "CArchive [MFC], WriteClass", "CArchive [MFC], WriteObject", "CArchive [MFC], WriteString", "CArchive [MFC], m_pDocument"] --- @@ -74,7 +74,7 @@ You must create a [`CFile`](../../mfc/reference/cfile-class.md) object before yo When you construct a `CArchive` object, you attach it to an object of class `CFile` (or a derived class) that represents an open file. You also specify whether the archive will be used for loading or storing. A `CArchive` object can process not only primitive types but also objects of [`CObject`](../../mfc/reference/cobject-class.md)-derived classes designed for serialization. A serializable class usually has a `Serialize` member function, and it usually uses the [`DECLARE_SERIAL`](../../mfc/reference/run-time-object-model-services.md#declare_serial) and [`IMPLEMENT_SERIAL`](../../mfc/reference/run-time-object-model-services.md#implement_serial) macros, as described under class `CObject`. -The overloaded extraction ( `>>`) and insertion ( `<<`) operators are convenient archive programming interfaces that support both primitive types and `CObject`-derived classes. +The overloaded extraction (`>>`) and insertion (`<<`) operators are convenient archive programming interfaces that support both primitive types and `CObject`-derived classes. `CArchive` also supports programming with the MFC Windows Sockets classes [`CSocket`](../../mfc/reference/csocket-class.md) and [`CSocketFile`](../../mfc/reference/csocketfile-class.md). The [`IsBufferEmpty`](#isbufferempty) member function supports that usage. @@ -570,7 +570,7 @@ A [`CObject`](../../mfc/reference/cobject-class.md) pointer that must be safely ### Remarks -This function is normally called by the `CArchive` extraction ( `>>`) operator overloaded for a [`CObject`](../../mfc/reference/cobject-class.md) pointer. `ReadObject`, in turn, calls the `Serialize` function of the archived class. +This function is normally called by the `CArchive` extraction (`>>`) operator overloaded for a [`CObject`](../../mfc/reference/cobject-class.md) pointer. `ReadObject`, in turn, calls the `Serialize` function of the archived class. If you supply a nonzero *`pClass`* parameter, which is obtained by the [`RUNTIME_CLASS`](../../mfc/reference/run-time-object-model-services.md#runtime_class) macro, then the function verifies the run-time class of the archived object. This assumes you have used the `IMPLEMENT_SERIAL` macro in the implementation of the class. @@ -781,7 +781,7 @@ A constant pointer to the object being stored. ### Remarks -This function is normally called by the `CArchive` insertion ( `<<`) operator overloaded for `CObject`. `WriteObject`, in turn, calls the `Serialize` function of the archived class. +This function is normally called by the `CArchive` insertion (`<<`) operator overloaded for `CObject`. `WriteObject`, in turn, calls the `Serialize` function of the archived class. You must use the `IMPLEMENT_SERIAL` macro to enable archiving. `WriteObject` writes the ASCII class name to the archive. This class name is validated later during the load process. A special encoding scheme prevents unnecessary duplication of the class name for multiple objects of the class. This scheme also prevents redundant storage of objects that are targets of more than one pointer. diff --git a/docs/mfc/reference/casyncsocket-class.md b/docs/mfc/reference/casyncsocket-class.md index d68ce7630fd..9d1d045acdd 100644 --- a/docs/mfc/reference/casyncsocket-class.md +++ b/docs/mfc/reference/casyncsocket-class.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: CAsyncSocket Class" title: "CAsyncSocket Class" -ms.date: "06/25/2020" +description: "Learn more about: CAsyncSocket Class" +ms.date: 06/25/2020 f1_keywords: ["CAsyncSocket", "AFXSOCK/CAsyncSocket", "AFXSOCK/CAsyncSocket::CAsyncSocket", "AFXSOCK/CAsyncSocket::Accept", "AFXSOCK/CAsyncSocket::AsyncSelect", "AFXSOCK/CAsyncSocket::Attach", "AFXSOCK/CAsyncSocket::Bind", "AFXSOCK/CAsyncSocket::Close", "AFXSOCK/CAsyncSocket::Connect", "AFXSOCK/CAsyncSocket::Create", "AFXSOCK/CAsyncSocket::Detach", "AFXSOCK/CAsyncSocket::FromHandle", "AFXSOCK/CAsyncSocket::GetLastError", "AFXSOCK/CAsyncSocket::GetPeerName", "AFXSOCK/CAsyncSocket::GetPeerNameEx", "AFXSOCK/CAsyncSocket::GetSockName", "AFXSOCK/CAsyncSocket::GetSockNameEx", "AFXSOCK/CAsyncSocket::GetSockOpt", "AFXSOCK/CAsyncSocket::IOCtl", "AFXSOCK/CAsyncSocket::Listen", "AFXSOCK/CAsyncSocket::Receive", "AFXSOCK/CAsyncSocket::ReceiveFrom", "AFXSOCK/CAsyncSocket::ReceiveFromEx", "AFXSOCK/CAsyncSocket::Send", "AFXSOCK/CAsyncSocket::SendTo", "AFXSOCK/CAsyncSocket::SendToEx", "AFXSOCK/CAsyncSocket::SetSockOpt", "AFXSOCK/CAsyncSocket::ShutDown", "AFXSOCK/CASyncSocket::Socket", "AFXSOCK/CAsyncSocket::OnAccept", "AFXSOCK/CAsyncSocket::OnClose", "AFXSOCK/CAsyncSocket::OnConnect", "AFXSOCK/CAsyncSocket::OnOutOfBandData", "AFXSOCK/CAsyncSocket::OnReceive", "AFXSOCK/CAsyncSocket::OnSend", "AFXSOCK/CAsyncSocket::m_hSocket"] helpviewer_keywords: ["CAsyncSocket [MFC], CAsyncSocket", "CAsyncSocket [MFC], Accept", "CAsyncSocket [MFC], AsyncSelect", "CAsyncSocket [MFC], Attach", "CAsyncSocket [MFC], Bind", "CAsyncSocket [MFC], Close", "CAsyncSocket [MFC], Connect", "CAsyncSocket [MFC], Create", "CAsyncSocket [MFC], Detach", "CAsyncSocket [MFC], FromHandle", "CAsyncSocket [MFC], GetLastError", "CAsyncSocket [MFC], GetPeerName", "CAsyncSocket [MFC], GetPeerNameEx", "CAsyncSocket [MFC], GetSockName", "CAsyncSocket [MFC], GetSockNameEx", "CAsyncSocket [MFC], GetSockOpt", "CAsyncSocket [MFC], IOCtl", "CAsyncSocket [MFC], Listen", "CAsyncSocket [MFC], Receive", "CAsyncSocket [MFC], ReceiveFrom", "CAsyncSocket [MFC], ReceiveFromEx", "CAsyncSocket [MFC], Send", "CAsyncSocket [MFC], SendTo", "CAsyncSocket [MFC], SendToEx", "CAsyncSocket [MFC], SetSockOpt", "CAsyncSocket [MFC], ShutDown", "CASyncSocket [MFC], Socket", "CAsyncSocket [MFC], OnAccept", "CAsyncSocket [MFC], OnClose", "CAsyncSocket [MFC], OnConnect", "CAsyncSocket [MFC], OnOutOfBandData", "CAsyncSocket [MFC], OnReceive", "CAsyncSocket [MFC], OnSend", "CAsyncSocket [MFC], m_hSocket"] -ms.assetid: cca4d5a1-aa0f-48bd-843e-ef0e2d7fc00b --- # `CAsyncSocket` Class @@ -844,7 +843,7 @@ This routine can be used on any socket in any state. It is used to get or retrie - `FIONREAD` Determine the maximum number of bytes that can be read with one `Receive` call from this socket. The *`lpArgument`* parameter points at a `DWORD` in which `IOCtl` stores the result. If this socket is of type `SOCK_STREAM`, `FIONREAD` returns the total amount of data which can be read in a single `Receive`; this is normally the same as the total amount of data queued on the socket. If this socket is of type `SOCK_DGRAM`, `FIONREAD` returns the size of the first datagram queued on the socket. -- `SIOCATMARK` Determine whether all out-of-band data has been read. This applies only to a socket of type `SOCK_STREAM` which has been configured for in-line reception of any out-of-band data ( `SO_OOBINLINE`). If no out-of-band data is waiting to be read, the operation returns nonzero. Otherwise it returns 0, and the next `Receive` or `ReceiveFrom` performed on the socket will retrieve some or all of the data preceding the "mark"; the application should use the `SIOCATMARK` operation to determine whether any data remains. If there is any normal data preceding the "urgent" (out-of-band) data, it will be received in order. (Note that a `Receive` or `ReceiveFrom` will never mix out-of-band and normal data in the same call.) The *`lpArgument`* parameter points at a `DWORD` in which `IOCtl` stores the result. +- `SIOCATMARK` Determine whether all out-of-band data has been read. This applies only to a socket of type `SOCK_STREAM` which has been configured for in-line reception of any out-of-band data (`SO_OOBINLINE`). If no out-of-band data is waiting to be read, the operation returns nonzero. Otherwise it returns 0, and the next `Receive` or `ReceiveFrom` performed on the socket will retrieve some or all of the data preceding the "mark"; the application should use the `SIOCATMARK` operation to determine whether any data remains. If there is any normal data preceding the "urgent" (out-of-band) data, it will be received in order. (Note that a `Receive` or `ReceiveFrom` will never mix out-of-band and normal data in the same call.) The *`lpArgument`* parameter points at a `DWORD` in which `IOCtl` stores the result. This function is a subset of `ioctl()` as used in Berkeley sockets. In particular, there is no command which is equivalent to `FIOASYNC`, while `SIOCATMARK` is the only socket-level command which is supported. diff --git a/docs/mfc/reference/cbasekeyframe-class.md b/docs/mfc/reference/cbasekeyframe-class.md index 03a3f495639..40785c05ad3 100644 --- a/docs/mfc/reference/cbasekeyframe-class.md +++ b/docs/mfc/reference/cbasekeyframe-class.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: CBaseKeyFrame Class" title: "CBaseKeyFrame Class" -ms.date: "11/04/2016" +description: "Learn more about: CBaseKeyFrame Class" +ms.date: 11/04/2016 f1_keywords: ["CBaseKeyFrame", "AFXANIMATIONCONTROLLER/CBaseKeyFrame", "AFXANIMATIONCONTROLLER/CBaseKeyFrame::CBaseKeyFrame", "AFXANIMATIONCONTROLLER/CBaseKeyFrame::AddToStoryboard", "AFXANIMATIONCONTROLLER/CBaseKeyFrame::GetAnimationKeyframe", "AFXANIMATIONCONTROLLER/CBaseKeyFrame::IsAdded", "AFXANIMATIONCONTROLLER/CBaseKeyFrame::IsKeyframeAtOffset", "AFXANIMATIONCONTROLLER/CBaseKeyFrame::m_bAdded", "AFXANIMATIONCONTROLLER/CBaseKeyFrame::m_bIsKeyframeAtOffset", "AFXANIMATIONCONTROLLER/CBaseKeyFrame::m_keyframe"] helpviewer_keywords: ["CBaseKeyFrame [MFC], CBaseKeyFrame", "CBaseKeyFrame [MFC], AddToStoryboard", "CBaseKeyFrame [MFC], GetAnimationKeyframe", "CBaseKeyFrame [MFC], IsAdded", "CBaseKeyFrame [MFC], IsKeyframeAtOffset", "CBaseKeyFrame [MFC], m_bAdded", "CBaseKeyFrame [MFC], m_bIsKeyframeAtOffset", "CBaseKeyFrame [MFC], m_keyframe"] -ms.assetid: 285a2eff-e7c4-43be-b5aa-737727e6866d --- # CBaseKeyFrame Class @@ -115,7 +114,7 @@ BOOL IsAdded() const; ### Return Value -TRUE if a keyframe is added to a storyboard; otehrwise FALSE. +TRUE if a keyframe is added to a storyboard; otherwise FALSE. ### Remarks diff --git a/docs/mfc/reference/cbasepane-class.md b/docs/mfc/reference/cbasepane-class.md index b2c88c5ae6d..de3b9ea5943 100644 --- a/docs/mfc/reference/cbasepane-class.md +++ b/docs/mfc/reference/cbasepane-class.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: CBasePane Class" title: "CBasePane Class" -ms.date: "11/06/2018" +description: "Learn more about: CBasePane Class" +ms.date: 11/06/2018 f1_keywords: ["CBasePane", "AFXBASEPANE/CBasePane", "AFXBASEPANE/CBasePane::AccNotifyObjectFocusEvent", "AFXBASEPANE/CBasePane::AddPane", "AFXBASEPANE/CBasePane::AdjustDockingLayout", "AFXBASEPANE/CBasePane::AdjustLayout", "AFXBASEPANE/CBasePane::CalcFixedLayout", "AFXBASEPANE/CBasePane::CanAcceptPane", "AFXBASEPANE/CBasePane::CanAutoHide", "AFXBASEPANE/CBasePane::CanBeAttached", "AFXBASEPANE/CBasePane::CanBeClosed", "AFXBASEPANE/CBasePane::CanBeDocked", "AFXBASEPANE/CBasePane::CanBeResized", "AFXBASEPANE/CBasePane::CanBeTabbedDocument", "AFXBASEPANE/CBasePane::CanFloat", "AFXBASEPANE/CBasePane::CanFocus", "AFXBASEPANE/CBasePane::CopyState", "AFXBASEPANE/CBasePane::CreateDefaultMiniframe", "AFXBASEPANE/CBasePane::CreateEx", "AFXBASEPANE/CBasePane::DockPane", "AFXBASEPANE/CBasePane::DockPaneUsingRTTI", "AFXBASEPANE/CBasePane::DockToFrameWindow", "AFXBASEPANE/CBasePane::DoesAllowDynInsertBefore", "AFXBASEPANE/CBasePane::EnableDocking", "AFXBASEPANE/CBasePane::EnableGripper", "AFXBASEPANE/CBasePane::FloatPane", "AFXBASEPANE/CBasePane::get_accHelpTopic", "AFXBASEPANE/CBasePane::get_accSelection", "AFXBASEPANE/CBasePane::GetCaptionHeight", "AFXBASEPANE/CBasePane::GetControlBarStyle", "AFXBASEPANE/CBasePane::GetCurrentAlignment", "AFXBASEPANE/CBasePane::GetDockingMode", "AFXBASEPANE/CBasePane::GetDockSiteFrameWnd", "AFXBASEPANE/CBasePane::GetEnabledAlignment", "AFXBASEPANE/CBasePane::GetMFCStyle", "AFXBASEPANE/CBasePane::GetPaneIcon", "AFXBASEPANE/CBasePane::GetPaneRow", "AFXBASEPANE/CBasePane::GetPaneStyle", "AFXBASEPANE/CBasePane::GetParentDockSite", "AFXBASEPANE/CBasePane::GetParentMiniFrame", "AFXBASEPANE/CBasePane::GetParentTabbedPane", "AFXBASEPANE/CBasePane::GetParentTabWnd", "AFXBASEPANE/CBasePane::GetRecentVisibleState", "AFXBASEPANE/CBasePane::HideInPrintPreviewMode", "AFXBASEPANE/CBasePane::InsertPane", "AFXBASEPANE/CBasePane::IsAccessibilityCompatible", "AFXBASEPANE/CBasePane::IsAutoHideMode", "AFXBASEPANE/CBasePane::IsDialogControl", "AFXBASEPANE/CBasePane::IsDocked", "AFXBASEPANE/CBasePane::IsFloating", "AFXBASEPANE/CBasePane::IsHorizontal", "AFXBASEPANE/CBasePane::IsInFloatingMultiPaneFrameWnd", "AFXBASEPANE/CBasePane::IsMDITabbed", "AFXBASEPANE/CBasePane::IsPaneVisible", "AFXBASEPANE/CBasePane::IsPointNearDockSite", "AFXBASEPANE/CBasePane::IsResizable", "AFXBASEPANE/CBasePane::IsRestoredFromRegistry", "AFXBASEPANE/CBasePane::IsTabbed", "AFXBASEPANE/CBasePane::IsVisible", "AFXBASEPANE/CBasePane::LoadState", "AFXBASEPANE/CBasePane::MoveWindow", "AFXBASEPANE/CBasePane::OnAfterChangeParent", "AFXBASEPANE/CBasePane::OnBeforeChangeParent", "AFXBASEPANE/CBasePane::OnDrawCaption", "AFXBASEPANE/CBasePane::OnMovePaneDivider", "AFXBASEPANE/CBasePane::OnPaneContextMenu", "AFXBASEPANE/CBasePane::OnRemoveFromMiniFrame", "AFXBASEPANE/CBasePane::OnSetAccData", "AFXBASEPANE/CBasePane::PaneFromPoint", "AFXBASEPANE/CBasePane::RecalcLayout", "AFXBASEPANE/CBasePane::RemovePaneFromDockManager", "AFXBASEPANE/CBasePane::SaveState", "AFXBASEPANE/CBasePane::SelectDefaultFont", "AFXBASEPANE/CBasePane::SetControlBarStyle", "AFXBASEPANE/CBasePane::SetDockingMode", "AFXBASEPANE/CBasePane::SetPaneAlignment", "AFXBASEPANE/CBasePane::SetPaneStyle", "AFXBASEPANE/CBasePane::SetWindowPos", "AFXBASEPANE/CBasePane::ShowPane", "AFXBASEPANE/CBasePane::StretchPane", "AFXBASEPANE/CBasePane::UndockPane", "AFXBASEPANE/CBasePane::DoPaint"] helpviewer_keywords: ["CBasePane [MFC], AccNotifyObjectFocusEvent", "CBasePane [MFC], AddPane", "CBasePane [MFC], AdjustDockingLayout", "CBasePane [MFC], AdjustLayout", "CBasePane [MFC], CalcFixedLayout", "CBasePane [MFC], CanAcceptPane", "CBasePane [MFC], CanAutoHide", "CBasePane [MFC], CanBeAttached", "CBasePane [MFC], CanBeClosed", "CBasePane [MFC], CanBeDocked", "CBasePane [MFC], CanBeResized", "CBasePane [MFC], CanBeTabbedDocument", "CBasePane [MFC], CanFloat", "CBasePane [MFC], CanFocus", "CBasePane [MFC], CopyState", "CBasePane [MFC], CreateDefaultMiniframe", "CBasePane [MFC], CreateEx", "CBasePane [MFC], DockPane", "CBasePane [MFC], DockPaneUsingRTTI", "CBasePane [MFC], DockToFrameWindow", "CBasePane [MFC], DoesAllowDynInsertBefore", "CBasePane [MFC], EnableDocking", "CBasePane [MFC], EnableGripper", "CBasePane [MFC], FloatPane", "CBasePane [MFC], get_accHelpTopic", "CBasePane [MFC], get_accSelection", "CBasePane [MFC], GetCaptionHeight", "CBasePane [MFC], GetControlBarStyle", "CBasePane [MFC], GetCurrentAlignment", "CBasePane [MFC], GetDockingMode", "CBasePane [MFC], GetDockSiteFrameWnd", "CBasePane [MFC], GetEnabledAlignment", "CBasePane [MFC], GetMFCStyle", "CBasePane [MFC], GetPaneIcon", "CBasePane [MFC], GetPaneRow", "CBasePane [MFC], GetPaneStyle", "CBasePane [MFC], GetParentDockSite", "CBasePane [MFC], GetParentMiniFrame", "CBasePane [MFC], GetParentTabbedPane", "CBasePane [MFC], GetParentTabWnd", "CBasePane [MFC], GetRecentVisibleState", "CBasePane [MFC], HideInPrintPreviewMode", "CBasePane [MFC], InsertPane", "CBasePane [MFC], IsAccessibilityCompatible", "CBasePane [MFC], IsAutoHideMode", "CBasePane [MFC], IsDialogControl", "CBasePane [MFC], IsDocked", "CBasePane [MFC], IsFloating", "CBasePane [MFC], IsHorizontal", "CBasePane [MFC], IsInFloatingMultiPaneFrameWnd", "CBasePane [MFC], IsMDITabbed", "CBasePane [MFC], IsPaneVisible", "CBasePane [MFC], IsPointNearDockSite", "CBasePane [MFC], IsResizable", "CBasePane [MFC], IsRestoredFromRegistry", "CBasePane [MFC], IsTabbed", "CBasePane [MFC], IsVisible", "CBasePane [MFC], LoadState", "CBasePane [MFC], MoveWindow", "CBasePane [MFC], OnAfterChangeParent", "CBasePane [MFC], OnBeforeChangeParent", "CBasePane [MFC], OnDrawCaption", "CBasePane [MFC], OnMovePaneDivider", "CBasePane [MFC], OnPaneContextMenu", "CBasePane [MFC], OnRemoveFromMiniFrame", "CBasePane [MFC], OnSetAccData", "CBasePane [MFC], PaneFromPoint", "CBasePane [MFC], RecalcLayout", "CBasePane [MFC], RemovePaneFromDockManager", "CBasePane [MFC], SaveState", "CBasePane [MFC], SelectDefaultFont", "CBasePane [MFC], SetControlBarStyle", "CBasePane [MFC], SetDockingMode", "CBasePane [MFC], SetPaneAlignment", "CBasePane [MFC], SetPaneStyle", "CBasePane [MFC], SetWindowPos", "CBasePane [MFC], ShowPane", "CBasePane [MFC], StretchPane", "CBasePane [MFC], UndockPane", "CBasePane [MFC], DoPaint"] -ms.assetid: 8163dd51-d7c7-4def-9c74-61f8ecdfad82 --- # CBasePane Class @@ -80,7 +79,7 @@ class CBasePane : public CWnd |[CBasePane::GetMFCStyle](#getmfcstyle)|Returns the pane styles specific to MFC.| |[CBasePane::GetPaneIcon](#getpaneicon)|Returns a handle to the pane icon.| |`CBasePane::GetPaneRect`|Used internally.| -|[CBasePane::GetPaneRow](#getpanerow)|Returns a pointer to the [CDockingPanesRow](../../mfc/reference/cdockingpanesrow-class.md)object where the pane is docked.| +|[CBasePane::GetPaneRow](#getpanerow)|Returns a pointer to the [CDockingPanesRow](../../mfc/reference/cdockingpanesrow-class.md) object where the pane is docked.| |[CBasePane::GetPaneStyle](#getpanestyle)|Returns the pane style.| |[CBasePane::GetParentDockSite](#getparentdocksite)|Returns a pointer to the parent dock site.| |[CBasePane::GetParentMiniFrame](#getparentminiframe)|Returns a pointer to the parent mini-frame window.| @@ -566,8 +565,8 @@ The library adds several new styles for panes. The following table describes the |AFX_CBRS_RESIZE|The pane can be resized. **Important:** This style is not implemented.| |AFX_CBRS_CLOSE|The pane can be closed.| |AFX_CBRS_AUTO_ROLLUP|The pane can be rolled up when it floats.| -|AFX_CBRS_REGULAR_TABS|When one pane docks to another pane that has this style, a regular tabbed window is created. (For more information, see [CTabbedPane Class](../../mfc/reference/ctabbedpane-class.md).)| -|AFX_CBRS_OUTLOOK_TABS|When one pane docks to another pane that has this style, an Outlook-style tabbed window is created. (For more information, see [CMFCOutlookBar Class](../../mfc/reference/cmfcoutlookbar-class.md).)| +|AFX_CBRS_REGULAR_TABS|When one pane docks to another pane that has this style, a regular tabbed window is created. For more information, see [CTabbedPane Class](../../mfc/reference/ctabbedpane-class.md).| +|AFX_CBRS_OUTLOOK_TABS|When one pane docks to another pane that has this style, an Outlook-style tabbed window is created. For more information, see [CMFCOutlookBar Class](../../mfc/reference/cmfcoutlookbar-class.md).| To use the new styles, specify them in *dwControlBarStyle*. @@ -892,7 +891,7 @@ By setting *m_dockMode* or overriding `GetDockingMode` you can control the docki ## CBasePane::GetDockSiteFrameWnd -Returns a pointer to the [CDockingPanesRow](../../mfc/reference/cdockingpanesrow-class.md)object where the pane is docked. +Returns a pointer to the [CDockingPanesRow](../../mfc/reference/cdockingpanesrow-class.md) object where the pane is docked. ``` virtual CWnd* GetDockSiteFrameWnd() const; @@ -967,7 +966,7 @@ The default implementation calls [CWnd::GetIcon](../../mfc/reference/cwnd-class. ## CBasePane::GetPaneRow -Returns a pointer to the [CDockingPanesRow](../../mfc/reference/cdockingpanesrow-class.md)object where the pane is docked. +Returns a pointer to the [CDockingPanesRow](../../mfc/reference/cdockingpanesrow-class.md) object where the pane is docked. ``` CDockingPanesRow* GetPaneRow(); diff --git a/docs/mfc/reference/ccmdtarget-class.md b/docs/mfc/reference/ccmdtarget-class.md index 6d4a3bb06a6..6c3bdf1fc05 100644 --- a/docs/mfc/reference/ccmdtarget-class.md +++ b/docs/mfc/reference/ccmdtarget-class.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: CCmdTarget Class" title: "CCmdTarget Class" -ms.date: "11/04/2016" +description: "Learn more about: CCmdTarget Class" +ms.date: 11/04/2016 f1_keywords: ["CCmdTarget", "AFXWIN/CCmdTarget", "AFXWIN/CCmdTarget::CCmdTarget", "AFXWIN/CCmdTarget::BeginWaitCursor", "AFXWIN/CCmdTarget::DoOleVerb", "AFXWIN/CCmdTarget::EnableAutomation", "AFXWIN/CCmdTarget::EnableConnections", "AFXWIN/CCmdTarget::EnableTypeLib", "AFXWIN/CCmdTarget::EndWaitCursor", "AFXWIN/CCmdTarget::EnumOleVerbs", "AFXWIN/CCmdTarget::FromIDispatch", "AFXWIN/CCmdTarget::GetDispatchIID", "AFXWIN/CCmdTarget::GetIDispatch", "AFXWIN/CCmdTarget::GetTypeInfoCount", "AFXWIN/CCmdTarget::GetTypeInfoOfGuid", "AFXWIN/CCmdTarget::GetTypeLib", "AFXWIN/CCmdTarget::GetTypeLibCache", "AFXWIN/CCmdTarget::IsInvokeAllowed", "AFXWIN/CCmdTarget::IsResultExpected", "AFXWIN/CCmdTarget::OnCmdMsg", "AFXWIN/CCmdTarget::OnFinalRelease", "AFXWIN/CCmdTarget::RestoreWaitCursor"] helpviewer_keywords: ["CCmdTarget [MFC], CCmdTarget", "CCmdTarget [MFC], BeginWaitCursor", "CCmdTarget [MFC], DoOleVerb", "CCmdTarget [MFC], EnableAutomation", "CCmdTarget [MFC], EnableConnections", "CCmdTarget [MFC], EnableTypeLib", "CCmdTarget [MFC], EndWaitCursor", "CCmdTarget [MFC], EnumOleVerbs", "CCmdTarget [MFC], FromIDispatch", "CCmdTarget [MFC], GetDispatchIID", "CCmdTarget [MFC], GetIDispatch", "CCmdTarget [MFC], GetTypeInfoCount", "CCmdTarget [MFC], GetTypeInfoOfGuid", "CCmdTarget [MFC], GetTypeLib", "CCmdTarget [MFC], GetTypeLibCache", "CCmdTarget [MFC], IsInvokeAllowed", "CCmdTarget [MFC], IsResultExpected", "CCmdTarget [MFC], OnCmdMsg", "CCmdTarget [MFC], OnFinalRelease", "CCmdTarget [MFC], RestoreWaitCursor"] --- @@ -299,7 +299,7 @@ HRESULT GetTypeInfoOfGuid( ### Parameters *`lcid`*\ -A locale identifier ( `LCID`). +A locale identifier (`LCID`). *`guid`*\ The [GUID](/windows/win32/api/guiddef/ns-guiddef-guid) of the type description. diff --git a/docs/mfc/reference/ccombobox-class.md b/docs/mfc/reference/ccombobox-class.md index 02046d4a906..ca740d929f8 100644 --- a/docs/mfc/reference/ccombobox-class.md +++ b/docs/mfc/reference/ccombobox-class.md @@ -1,10 +1,9 @@ --- title: "CComboBox Class" description: "API reference for the MFC Windows combo box class CComboBox" -ms.date: "08/27/2020" +ms.date: 08/27/2020 f1_keywords: ["CComboBox", "AFXWIN/CComboBox", "AFXWIN/CComboBox::CComboBox", "AFXWIN/CComboBox::AddString", "AFXWIN/CComboBox::Clear", "AFXWIN/CComboBox::CompareItem", "AFXWIN/CComboBox::Copy", "AFXWIN/CComboBox::Create", "AFXWIN/CComboBox::Cut", "AFXWIN/CComboBox::DeleteItem", "AFXWIN/CComboBox::DeleteString", "AFXWIN/CComboBox::Dir", "AFXWIN/CComboBox::DrawItem", "AFXWIN/CComboBox::FindString", "AFXWIN/CComboBox::FindStringExact", "AFXWIN/CComboBox::GetComboBoxInfo", "AFXWIN/CComboBox::GetCount", "AFXWIN/CComboBox::GetCueBanner", "AFXWIN/CComboBox::GetCurSel", "AFXWIN/CComboBox::GetDroppedControlRect", "AFXWIN/CComboBox::GetDroppedState", "AFXWIN/CComboBox::GetDroppedWidth", "AFXWIN/CComboBox::GetEditSel", "AFXWIN/CComboBox::GetExtendedUI", "AFXWIN/CComboBox::GetHorizontalExtent", "AFXWIN/CComboBox::GetItemData", "AFXWIN/CComboBox::GetItemDataPtr", "AFXWIN/CComboBox::GetItemHeight", "AFXWIN/CComboBox::GetLBText", "AFXWIN/CComboBox::GetLBTextLen", "AFXWIN/CComboBox::GetLocale", "AFXWIN/CComboBox::GetMinVisible", "AFXWIN/CComboBox::GetTopIndex", "AFXWIN/CComboBox::InitStorage", "AFXWIN/CComboBox::InsertString", "AFXWIN/CComboBox::LimitText", "AFXWIN/CComboBox::MeasureItem", "AFXWIN/CComboBox::Paste", "AFXWIN/CComboBox::ResetContent", "AFXWIN/CComboBox::SelectString", "AFXWIN/CComboBox::SetCueBanner", "AFXWIN/CComboBox::SetCurSel", "AFXWIN/CComboBox::SetDroppedWidth", "AFXWIN/CComboBox::SetEditSel", "AFXWIN/CComboBox::SetExtendedUI", "AFXWIN/CComboBox::SetHorizontalExtent", "AFXWIN/CComboBox::SetItemData", "AFXWIN/CComboBox::SetItemDataPtr", "AFXWIN/CComboBox::SetItemHeight", "AFXWIN/CComboBox::SetLocale", "AFXWIN/CComboBox::SetMinVisibleItems", "AFXWIN/CComboBox::SetTopIndex", "AFXWIN/CComboBox::ShowDropDown"] helpviewer_keywords: ["CComboBox [MFC], CComboBox", "CComboBox [MFC], AddString", "CComboBox [MFC], Clear", "CComboBox [MFC], CompareItem", "CComboBox [MFC], Copy", "CComboBox [MFC], Create", "CComboBox [MFC], Cut", "CComboBox [MFC], DeleteItem", "CComboBox [MFC], DeleteString", "CComboBox [MFC], Dir", "CComboBox [MFC], DrawItem", "CComboBox [MFC], FindString", "CComboBox [MFC], FindStringExact", "CComboBox [MFC], GetComboBoxInfo", "CComboBox [MFC], GetCount", "CComboBox [MFC], GetCueBanner", "CComboBox [MFC], GetCurSel", "CComboBox [MFC], GetDroppedControlRect", "CComboBox [MFC], GetDroppedState", "CComboBox [MFC], GetDroppedWidth", "CComboBox [MFC], GetEditSel", "CComboBox [MFC], GetExtendedUI", "CComboBox [MFC], GetHorizontalExtent", "CComboBox [MFC], GetItemData", "CComboBox [MFC], GetItemDataPtr", "CComboBox [MFC], GetItemHeight", "CComboBox [MFC], GetLBText", "CComboBox [MFC], GetLBTextLen", "CComboBox [MFC], GetLocale", "CComboBox [MFC], GetMinVisible", "CComboBox [MFC], GetTopIndex", "CComboBox [MFC], InitStorage", "CComboBox [MFC], InsertString", "CComboBox [MFC], LimitText", "CComboBox [MFC], MeasureItem", "CComboBox [MFC], Paste", "CComboBox [MFC], ResetContent", "CComboBox [MFC], SelectString", "CComboBox [MFC], SetCueBanner", "CComboBox [MFC], SetCurSel", "CComboBox [MFC], SetDroppedWidth", "CComboBox [MFC], SetEditSel", "CComboBox [MFC], SetExtendedUI", "CComboBox [MFC], SetHorizontalExtent", "CComboBox [MFC], SetItemData", "CComboBox [MFC], SetItemDataPtr", "CComboBox [MFC], SetItemHeight", "CComboBox [MFC], SetLocale", "CComboBox [MFC], SetMinVisibleItems", "CComboBox [MFC], SetTopIndex", "CComboBox [MFC], ShowDropDown"] -ms.assetid: 4e73b5df-0d2e-4658-9706-38133fb10513 --- # `CComboBox` Class @@ -515,7 +514,7 @@ BOOL GetComboBoxInfo(PCOMBOBOXINFO pcbi) const; ### Parameters -*`pcbi*
+*`pcbi`*
A pointer to the [`COMBOBOXINFO`](/windows/win32/api/winuser/ns-winuser-comboboxinfo) structure. ### Return Value diff --git a/docs/mfc/reference/ccommandlineinfo-class.md b/docs/mfc/reference/ccommandlineinfo-class.md index 944fb85dd15..0702885e23c 100644 --- a/docs/mfc/reference/ccommandlineinfo-class.md +++ b/docs/mfc/reference/ccommandlineinfo-class.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: CCommandLineInfo Class" title: "CCommandLineInfo Class" -ms.date: "11/04/2016" +description: "Learn more about: CCommandLineInfo Class" +ms.date: 11/04/2016 f1_keywords: ["CCommandLineInfo", "AFXWIN/CCommandLineInfo", "AFXWIN/CCommandLineInfo::CCommandLineInfo", "AFXWIN/CCommandLineInfo::ParseParam", "AFXWIN/CCommandLineInfo::m_bRunAutomated", "AFXWIN/CCommandLineInfo::m_bRunEmbedded", "AFXWIN/CCommandLineInfo::m_bShowSplash", "AFXWIN/CCommandLineInfo::m_nShellCommand", "AFXWIN/CCommandLineInfo::m_strDriverName", "AFXWIN/CCommandLineInfo::m_strFileName", "AFXWIN/CCommandLineInfo::m_strPortName", "AFXWIN/CCommandLineInfo::m_strPrinterName", "AFXWIN/CCommandLineInfo::m_strRestartIdentifier"] helpviewer_keywords: ["CCommandLineInfo [MFC], CCommandLineInfo", "CCommandLineInfo [MFC], ParseParam", "CCommandLineInfo [MFC], m_bRunAutomated", "CCommandLineInfo [MFC], m_bRunEmbedded", "CCommandLineInfo [MFC], m_bShowSplash", "CCommandLineInfo [MFC], m_nShellCommand", "CCommandLineInfo [MFC], m_strDriverName", "CCommandLineInfo [MFC], m_strFileName", "CCommandLineInfo [MFC], m_strPortName", "CCommandLineInfo [MFC], m_strPrinterName", "CCommandLineInfo [MFC], m_strRestartIdentifier"] --- @@ -83,7 +83,7 @@ CCommandLineInfo(); ### Remarks -The default is to show the splash screen ( `m_bShowSplash=TRUE`) and to execute the **New** command on the **File** menu ( `m_nShellCommand`**`=NewFile`**). +The default is to show the splash screen (`m_bShowSplash=TRUE`) and to execute the **New** command on the **File** menu (`m_nShellCommand`**`=NewFile`**). The application framework calls [`ParseParam`](#parseparam) to fill data members of this object. diff --git a/docs/mfc/reference/cd2dbitmap-class.md b/docs/mfc/reference/cd2dbitmap-class.md index 47d1045b096..9527c8a6532 100644 --- a/docs/mfc/reference/cd2dbitmap-class.md +++ b/docs/mfc/reference/cd2dbitmap-class.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: CD2DBitmap Class" title: "CD2DBitmap Class" +description: "Learn more about: CD2DBitmap Class" ms.date: "11/04/2016" f1_keywords: ["CD2DBitmap", "AFXRENDERTARGET/CD2DBitmap", "AFXRENDERTARGET/CD2DBitmap::CD2DBitmap", "AFXRENDERTARGET/CD2DBitmap::Attach", "AFXRENDERTARGET/CD2DBitmap::CopyFromBitmap", "AFXRENDERTARGET/CD2DBitmap::CopyFromMemory", "AFXRENDERTARGET/CD2DBitmap::CopyFromRenderTarget", "AFXRENDERTARGET/CD2DBitmap::Create", "AFXRENDERTARGET/CD2DBitmap::Destroy", "AFXRENDERTARGET/CD2DBitmap::Detach", "AFXRENDERTARGET/CD2DBitmap::Get", "AFXRENDERTARGET/CD2DBitmap::GetDPI", "AFXRENDERTARGET/CD2DBitmap::GetPixelFormat", "AFXRENDERTARGET/CD2DBitmap::GetPixelSize", "AFXRENDERTARGET/CD2DBitmap::GetSize", "AFXRENDERTARGET/CD2DBitmap::IsValid", "AFXRENDERTARGET/CD2DBitmap::CommonInit", "AFXRENDERTARGET/CD2DBitmap::m_bAutoDestroyHBMP", "AFXRENDERTARGET/CD2DBitmap::m_hBmpSrc", "AFXRENDERTARGET/CD2DBitmap::m_lpszType", "AFXRENDERTARGET/CD2DBitmap::m_pBitmap", "AFXRENDERTARGET/CD2DBitmap::m_sizeDest", "AFXRENDERTARGET/CD2DBitmap::m_strPath", "AFXRENDERTARGET/CD2DBitmap::m_uiResID"] helpviewer_keywords: ["CD2DBitmap [MFC], CD2DBitmap", "CD2DBitmap [MFC], CD2DBitmap", "CD2DBitmap [MFC], Attach", "CD2DBitmap [MFC], CopyFromBitmap", "CD2DBitmap [MFC], CopyFromMemory", "CD2DBitmap [MFC], CopyFromRenderTarget", "CD2DBitmap [MFC], Create", "CD2DBitmap [MFC], Destroy", "CD2DBitmap [MFC], Detach", "CD2DBitmap [MFC], Get", "CD2DBitmap [MFC], GetDPI", "CD2DBitmap [MFC], GetPixelFormat", "CD2DBitmap [MFC], GetPixelSize", "CD2DBitmap [MFC], GetSize", "CD2DBitmap [MFC], IsValid", "CD2DBitmap [MFC], CommonInit", "CD2DBitmap [MFC], m_bAutoDestroyHBMP", "CD2DBitmap [MFC], m_hBmpSrc", "CD2DBitmap [MFC], m_lpszType", "CD2DBitmap [MFC], m_pBitmap", "CD2DBitmap [MFC], m_sizeDest", "CD2DBitmap [MFC], m_strPath", "CD2DBitmap [MFC], m_uiResID"] -ms.assetid: 2b3686f1-812c-462b-b449-9f0cb6949bf6 --- # CD2DBitmap Class @@ -327,7 +326,7 @@ CD2DSizeU GetPixelSize() const; ### Return Value -The size, in pixels, of the bitmap.. +The size, in pixels, of the bitmap. ## CD2DBitmap::GetSize diff --git a/docs/mfc/reference/cd2dpathgeometry-class.md b/docs/mfc/reference/cd2dpathgeometry-class.md index 40f5c337f60..c8a92594575 100644 --- a/docs/mfc/reference/cd2dpathgeometry-class.md +++ b/docs/mfc/reference/cd2dpathgeometry-class.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: CD2DPathGeometry Class" title: "CD2DPathGeometry Class" +description: "Learn more about: CD2DPathGeometry Class" ms.date: "11/04/2016" f1_keywords: ["CD2DPathGeometry", "AFXRENDERTARGET/CD2DPathGeometry", "AFXRENDERTARGET/CD2DPathGeometry::CD2DPathGeometry", "AFXRENDERTARGET/CD2DPathGeometry::Attach", "AFXRENDERTARGET/CD2DPathGeometry::Create", "AFXRENDERTARGET/CD2DPathGeometry::Destroy", "AFXRENDERTARGET/CD2DPathGeometry::Detach", "AFXRENDERTARGET/CD2DPathGeometry::GetFigureCount", "AFXRENDERTARGET/CD2DPathGeometry::GetSegmentCount", "AFXRENDERTARGET/CD2DPathGeometry::Open", "AFXRENDERTARGET/CD2DPathGeometry::Stream", "AFXRENDERTARGET/CD2DPathGeometry::m_pPathGeometry"] helpviewer_keywords: ["CD2DPathGeometry [MFC], CD2DPathGeometry", "CD2DPathGeometry [MFC], Attach", "CD2DPathGeometry [MFC], Create", "CD2DPathGeometry [MFC], Destroy", "CD2DPathGeometry [MFC], Detach", "CD2DPathGeometry [MFC], GetFigureCount", "CD2DPathGeometry [MFC], GetSegmentCount", "CD2DPathGeometry [MFC], Open", "CD2DPathGeometry [MFC], Stream", "CD2DPathGeometry [MFC], m_pPathGeometry"] -ms.assetid: 686216eb-5080-4242-ace5-8fa1ce96307c --- # CD2DPathGeometry Class @@ -127,7 +126,7 @@ Pointer to detached resource interface. ## CD2DPathGeometry::GetFigureCount -Retrieves tthe number of figures in the path geometry. +Retrieves the number of figures in the path geometry. ``` int GetFigureCount() const; diff --git a/docs/mfc/reference/cdaodatabase-class.md b/docs/mfc/reference/cdaodatabase-class.md index a59cea4963d..f1b5b85af32 100644 --- a/docs/mfc/reference/cdaodatabase-class.md +++ b/docs/mfc/reference/cdaodatabase-class.md @@ -4,6 +4,7 @@ title: "CDaoDatabase Class" ms.date: "09/17/2019" f1_keywords: ["CDaoDatabase", "AFXDAO/CDaoDatabase", "AFXDAO/CDaoDatabase::CDaoDatabase", "AFXDAO/CDaoDatabase::CanTransact", "AFXDAO/CDaoDatabase::CanUpdate", "AFXDAO/CDaoDatabase::Close", "AFXDAO/CDaoDatabase::Create", "AFXDAO/CDaoDatabase::CreateRelation", "AFXDAO/CDaoDatabase::DeleteQueryDef", "AFXDAO/CDaoDatabase::DeleteRelation", "AFXDAO/CDaoDatabase::DeleteTableDef", "AFXDAO/CDaoDatabase::Execute", "AFXDAO/CDaoDatabase::GetConnect", "AFXDAO/CDaoDatabase::GetName", "AFXDAO/CDaoDatabase::GetQueryDefCount", "AFXDAO/CDaoDatabase::GetQueryDefInfo", "AFXDAO/CDaoDatabase::GetQueryTimeout", "AFXDAO/CDaoDatabase::GetRecordsAffected", "AFXDAO/CDaoDatabase::GetRelationCount", "AFXDAO/CDaoDatabase::GetRelationInfo", "AFXDAO/CDaoDatabase::GetTableDefCount", "AFXDAO/CDaoDatabase::GetTableDefInfo", "AFXDAO/CDaoDatabase::GetVersion", "AFXDAO/CDaoDatabase::IsOpen", "AFXDAO/CDaoDatabase::Open", "AFXDAO/CDaoDatabase::SetQueryTimeout", "AFXDAO/CDaoDatabase::m_pDAODatabase", "AFXDAO/CDaoDatabase::m_pWorkspace"] helpviewer_keywords: ["CDaoDatabase [MFC], CDaoDatabase", "CDaoDatabase [MFC], CanTransact", "CDaoDatabase [MFC], CanUpdate", "CDaoDatabase [MFC], Close", "CDaoDatabase [MFC], Create", "CDaoDatabase [MFC], CreateRelation", "CDaoDatabase [MFC], DeleteQueryDef", "CDaoDatabase [MFC], DeleteRelation", "CDaoDatabase [MFC], DeleteTableDef", "CDaoDatabase [MFC], Execute", "CDaoDatabase [MFC], GetConnect", "CDaoDatabase [MFC], GetName", "CDaoDatabase [MFC], GetQueryDefCount", "CDaoDatabase [MFC], GetQueryDefInfo", "CDaoDatabase [MFC], GetQueryTimeout", "CDaoDatabase [MFC], GetRecordsAffected", "CDaoDatabase [MFC], GetRelationCount", "CDaoDatabase [MFC], GetRelationInfo", "CDaoDatabase [MFC], GetTableDefCount", "CDaoDatabase [MFC], GetTableDefInfo", "CDaoDatabase [MFC], GetVersion", "CDaoDatabase [MFC], IsOpen", "CDaoDatabase [MFC], Open", "CDaoDatabase [MFC], SetQueryTimeout", "CDaoDatabase [MFC], m_pDAODatabase", "CDaoDatabase [MFC], m_pWorkspace"] +ms.custom: sfi-ropc-nochange --- # CDaoDatabase Class diff --git a/docs/mfc/reference/cdaofieldexchange-class.md b/docs/mfc/reference/cdaofieldexchange-class.md index e38d0fa693a..47e1f63124f 100644 --- a/docs/mfc/reference/cdaofieldexchange-class.md +++ b/docs/mfc/reference/cdaofieldexchange-class.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: CDaoFieldExchange Class" title: "CDaoFieldExchange Class" -ms.date: "09/17/2019" +description: "Learn more about: CDaoFieldExchange Class" +ms.date: 09/17/2019 f1_keywords: ["CDaoFieldExchange", "AFXDAO/CDaoFieldExchange", "AFXDAO/CDaoFieldExchange::IsValidOperation", "AFXDAO/CDaoFieldExchange::SetFieldType", "AFXDAO/CDaoFieldExchange::m_nOperation", "AFXDAO/CDaoFieldExchange::m_prs"] helpviewer_keywords: ["CDaoFieldExchange [MFC], IsValidOperation", "CDaoFieldExchange [MFC], SetFieldType", "CDaoFieldExchange [MFC], m_nOperation", "CDaoFieldExchange [MFC], m_prs"] --- @@ -44,7 +44,7 @@ Use this class if you are writing data exchange routines for custom data types; > The DAO database classes are distinct from the MFC database classes based on Open Database Connectivity (ODBC). All DAO database class names have the "CDao" prefix. You can still access ODBC data sources with the DAO classes. In general, the MFC classes based on DAO are more capable than the MFC classes based on ODBC. The DAO-based classes can access data, including through ODBC drivers, via their own database engine. They also support Data Definition Language (DDL) operations, such as adding tables via the classes instead of having to call DAO yourself. > [!NOTE] -> DAO record field exchange (DFX) is very similar to record field exchange (RFX) in the ODBC-based MFC database classes ( `CDatabase`, `CRecordset`). If you understand RFX, you will find it easy to use DFX. +> DAO record field exchange (DFX) is very similar to record field exchange (RFX) in the ODBC-based MFC database classes (`CDatabase`, `CRecordset`). If you understand RFX, you will find it easy to use DFX. A `CDaoFieldExchange` object provides the context information needed for DAO record field exchange to take place. `CDaoFieldExchange` objects support a number of operations, including binding parameters and field data members and setting various flags on the fields of the current record. DFX operations are performed on recordset-class data members of types defined by the **`enum`** **FieldType** in `CDaoFieldExchange`. Possible **FieldType** values are: diff --git a/docs/mfc/reference/cdaorecordset-class.md b/docs/mfc/reference/cdaorecordset-class.md index 9614d6e5147..4525538078a 100644 --- a/docs/mfc/reference/cdaorecordset-class.md +++ b/docs/mfc/reference/cdaorecordset-class.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: CDaoRecordset Class" title: "CDaoRecordset Class" -ms.date: "08/27/2018" +description: "Learn more about: CDaoRecordset Class" +ms.date: 08/27/2018 f1_keywords: ["CDaoRecordset", "AFXDAO/CDaoRecordset", "AFXDAO/CDaoRecordset::CDaoRecordset", "AFXDAO/CDaoRecordset::AddNew", "AFXDAO/CDaoRecordset::CanAppend", "AFXDAO/CDaoRecordset::CanBookmark", "AFXDAO/CDaoRecordset::CancelUpdate", "AFXDAO/CDaoRecordset::CanRestart", "AFXDAO/CDaoRecordset::CanScroll", "AFXDAO/CDaoRecordset::CanTransact", "AFXDAO/CDaoRecordset::CanUpdate", "AFXDAO/CDaoRecordset::Close", "AFXDAO/CDaoRecordset::Delete", "AFXDAO/CDaoRecordset::DoFieldExchange", "AFXDAO/CDaoRecordset::Edit", "AFXDAO/CDaoRecordset::FillCache", "AFXDAO/CDaoRecordset::Find", "AFXDAO/CDaoRecordset::FindFirst", "AFXDAO/CDaoRecordset::FindLast", "AFXDAO/CDaoRecordset::FindNext", "AFXDAO/CDaoRecordset::FindPrev", "AFXDAO/CDaoRecordset::GetAbsolutePosition", "AFXDAO/CDaoRecordset::GetBookmark", "AFXDAO/CDaoRecordset::GetCacheSize", "AFXDAO/CDaoRecordset::GetCacheStart", "AFXDAO/CDaoRecordset::GetCurrentIndex", "AFXDAO/CDaoRecordset::GetDateCreated", "AFXDAO/CDaoRecordset::GetDateLastUpdated", "AFXDAO/CDaoRecordset::GetDefaultDBName", "AFXDAO/CDaoRecordset::GetDefaultSQL", "AFXDAO/CDaoRecordset::GetEditMode", "AFXDAO/CDaoRecordset::GetFieldCount", "AFXDAO/CDaoRecordset::GetFieldInfo", "AFXDAO/CDaoRecordset::GetFieldValue", "AFXDAO/CDaoRecordset::GetIndexCount", "AFXDAO/CDaoRecordset::GetIndexInfo", "AFXDAO/CDaoRecordset::GetLastModifiedBookmark", "AFXDAO/CDaoRecordset::GetLockingMode", "AFXDAO/CDaoRecordset::GetName", "AFXDAO/CDaoRecordset::GetParamValue", "AFXDAO/CDaoRecordset::GetPercentPosition", "AFXDAO/CDaoRecordset::GetRecordCount", "AFXDAO/CDaoRecordset::GetSQL", "AFXDAO/CDaoRecordset::GetType", "AFXDAO/CDaoRecordset::GetValidationRule", "AFXDAO/CDaoRecordset::GetValidationText", "AFXDAO/CDaoRecordset::IsBOF", "AFXDAO/CDaoRecordset::IsDeleted", "AFXDAO/CDaoRecordset::IsEOF", "AFXDAO/CDaoRecordset::IsFieldDirty", "AFXDAO/CDaoRecordset::IsFieldNull", "AFXDAO/CDaoRecordset::IsFieldNullable", "AFXDAO/CDaoRecordset::IsOpen", "AFXDAO/CDaoRecordset::Move", "AFXDAO/CDaoRecordset::MoveFirst", "AFXDAO/CDaoRecordset::MoveLast", "AFXDAO/CDaoRecordset::MoveNext", "AFXDAO/CDaoRecordset::MovePrev", "AFXDAO/CDaoRecordset::Open", "AFXDAO/CDaoRecordset::Requery", "AFXDAO/CDaoRecordset::Seek", "AFXDAO/CDaoRecordset::SetAbsolutePosition", "AFXDAO/CDaoRecordset::SetBookmark", "AFXDAO/CDaoRecordset::SetCacheSize", "AFXDAO/CDaoRecordset::SetCacheStart", "AFXDAO/CDaoRecordset::SetCurrentIndex", "AFXDAO/CDaoRecordset::SetFieldDirty", "AFXDAO/CDaoRecordset::SetFieldNull", "AFXDAO/CDaoRecordset::SetFieldValue", "AFXDAO/CDaoRecordset::SetFieldValueNull", "AFXDAO/CDaoRecordset::SetLockingMode", "AFXDAO/CDaoRecordset::SetParamValue", "AFXDAO/CDaoRecordset::SetParamValueNull", "AFXDAO/CDaoRecordset::SetPercentPosition", "AFXDAO/CDaoRecordset::Update", "AFXDAO/CDaoRecordset::m_bCheckCacheForDirtyFields", "AFXDAO/CDaoRecordset::m_nFields", "AFXDAO/CDaoRecordset::m_nParams", "AFXDAO/CDaoRecordset::m_pDAORecordset", "AFXDAO/CDaoRecordset::m_pDatabase", "AFXDAO/CDaoRecordset::m_strFilter", "AFXDAO/CDaoRecordset::m_strSort"] helpviewer_keywords: ["CDaoRecordset [MFC], CDaoRecordset", "CDaoRecordset [MFC], AddNew", "CDaoRecordset [MFC], CanAppend", "CDaoRecordset [MFC], CanBookmark", "CDaoRecordset [MFC], CancelUpdate", "CDaoRecordset [MFC], CanRestart", "CDaoRecordset [MFC], CanScroll", "CDaoRecordset [MFC], CanTransact", "CDaoRecordset [MFC], CanUpdate", "CDaoRecordset [MFC], Close", "CDaoRecordset [MFC], Delete", "CDaoRecordset [MFC], DoFieldExchange", "CDaoRecordset [MFC], Edit", "CDaoRecordset [MFC], FillCache", "CDaoRecordset [MFC], Find", "CDaoRecordset [MFC], FindFirst", "CDaoRecordset [MFC], FindLast", "CDaoRecordset [MFC], FindNext", "CDaoRecordset [MFC], FindPrev", "CDaoRecordset [MFC], GetAbsolutePosition", "CDaoRecordset [MFC], GetBookmark", "CDaoRecordset [MFC], GetCacheSize", "CDaoRecordset [MFC], GetCacheStart", "CDaoRecordset [MFC], GetCurrentIndex", "CDaoRecordset [MFC], GetDateCreated", "CDaoRecordset [MFC], GetDateLastUpdated", "CDaoRecordset [MFC], GetDefaultDBName", "CDaoRecordset [MFC], GetDefaultSQL", "CDaoRecordset [MFC], GetEditMode", "CDaoRecordset [MFC], GetFieldCount", "CDaoRecordset [MFC], GetFieldInfo", "CDaoRecordset [MFC], GetFieldValue", "CDaoRecordset [MFC], GetIndexCount", "CDaoRecordset [MFC], GetIndexInfo", "CDaoRecordset [MFC], GetLastModifiedBookmark", "CDaoRecordset [MFC], GetLockingMode", "CDaoRecordset [MFC], GetName", "CDaoRecordset [MFC], GetParamValue", "CDaoRecordset [MFC], GetPercentPosition", "CDaoRecordset [MFC], GetRecordCount", "CDaoRecordset [MFC], GetSQL", "CDaoRecordset [MFC], GetType", "CDaoRecordset [MFC], GetValidationRule", "CDaoRecordset [MFC], GetValidationText", "CDaoRecordset [MFC], IsBOF", "CDaoRecordset [MFC], IsDeleted", "CDaoRecordset [MFC], IsEOF", "CDaoRecordset [MFC], IsFieldDirty", "CDaoRecordset [MFC], IsFieldNull", "CDaoRecordset [MFC], IsFieldNullable", "CDaoRecordset [MFC], IsOpen", "CDaoRecordset [MFC], Move", "CDaoRecordset [MFC], MoveFirst", "CDaoRecordset [MFC], MoveLast", "CDaoRecordset [MFC], MoveNext", "CDaoRecordset [MFC], MovePrev", "CDaoRecordset [MFC], Open", "CDaoRecordset [MFC], Requery", "CDaoRecordset [MFC], Seek", "CDaoRecordset [MFC], SetAbsolutePosition", "CDaoRecordset [MFC], SetBookmark", "CDaoRecordset [MFC], SetCacheSize", "CDaoRecordset [MFC], SetCacheStart", "CDaoRecordset [MFC], SetCurrentIndex", "CDaoRecordset [MFC], SetFieldDirty", "CDaoRecordset [MFC], SetFieldNull", "CDaoRecordset [MFC], SetFieldValue", "CDaoRecordset [MFC], SetFieldValueNull", "CDaoRecordset [MFC], SetLockingMode", "CDaoRecordset [MFC], SetParamValue", "CDaoRecordset [MFC], SetParamValueNull", "CDaoRecordset [MFC], SetPercentPosition", "CDaoRecordset [MFC], Update", "CDaoRecordset [MFC], m_bCheckCacheForDirtyFields", "CDaoRecordset [MFC], m_nFields", "CDaoRecordset [MFC], m_nParams", "CDaoRecordset [MFC], m_pDAORecordset", "CDaoRecordset [MFC], m_pDatabase", "CDaoRecordset [MFC], m_strFilter", "CDaoRecordset [MFC], m_strSort"] --- @@ -1623,7 +1623,7 @@ You can move forward or backward. `Move( 1 )` is equivalent to `MoveNext`, and ` > Calling any of the `Move` functions throws an exception if the recordset has no records. In general, call both `IsBOF` and `IsEOF` before a Move operation to determine whether the recordset has any records. After you call `Open` or `Requery`, call either `IsBOF` or `IsEOF`. > [!NOTE] -> If you have scrolled past the beginning or end of the recordset ( `IsBOF` or `IsEOF` returns nonzero), a call to `Move` throws a `CDaoException`. +> If you have scrolled past the beginning or end of the recordset (`IsBOF` or `IsEOF` returns nonzero), a call to `Move` throws a `CDaoException`. > [!NOTE] > If you call any of the `Move` functions while the current record is being updated or added, the updates are lost without warning. diff --git a/docs/mfc/reference/cdaotabledef-class.md b/docs/mfc/reference/cdaotabledef-class.md index 5ad89da173c..8e9f63fcc55 100644 --- a/docs/mfc/reference/cdaotabledef-class.md +++ b/docs/mfc/reference/cdaotabledef-class.md @@ -4,6 +4,7 @@ title: "CDaoTableDef Class" ms.date: "11/04/2016" f1_keywords: ["CDaoTableDef", "AFXDAO/CDaoTableDef", "AFXDAO/CDaoTableDef::CDaoTableDef", "AFXDAO/CDaoTableDef::Append", "AFXDAO/CDaoTableDef::CanUpdate", "AFXDAO/CDaoTableDef::Close", "AFXDAO/CDaoTableDef::Create", "AFXDAO/CDaoTableDef::CreateField", "AFXDAO/CDaoTableDef::CreateIndex", "AFXDAO/CDaoTableDef::DeleteField", "AFXDAO/CDaoTableDef::DeleteIndex", "AFXDAO/CDaoTableDef::GetAttributes", "AFXDAO/CDaoTableDef::GetConnect", "AFXDAO/CDaoTableDef::GetDateCreated", "AFXDAO/CDaoTableDef::GetDateLastUpdated", "AFXDAO/CDaoTableDef::GetFieldCount", "AFXDAO/CDaoTableDef::GetFieldInfo", "AFXDAO/CDaoTableDef::GetIndexCount", "AFXDAO/CDaoTableDef::GetIndexInfo", "AFXDAO/CDaoTableDef::GetName", "AFXDAO/CDaoTableDef::GetRecordCount", "AFXDAO/CDaoTableDef::GetSourceTableName", "AFXDAO/CDaoTableDef::GetValidationRule", "AFXDAO/CDaoTableDef::GetValidationText", "AFXDAO/CDaoTableDef::IsOpen", "AFXDAO/CDaoTableDef::Open", "AFXDAO/CDaoTableDef::RefreshLink", "AFXDAO/CDaoTableDef::SetAttributes", "AFXDAO/CDaoTableDef::SetConnect", "AFXDAO/CDaoTableDef::SetName", "AFXDAO/CDaoTableDef::SetSourceTableName", "AFXDAO/CDaoTableDef::SetValidationRule", "AFXDAO/CDaoTableDef::SetValidationText", "AFXDAO/CDaoTableDef::m_pDAOTableDef", "AFXDAO/CDaoTableDef::m_pDatabase"] helpviewer_keywords: ["CDaoTableDef [MFC], CDaoTableDef", "CDaoTableDef [MFC], Append", "CDaoTableDef [MFC], CanUpdate", "CDaoTableDef [MFC], Close", "CDaoTableDef [MFC], Create", "CDaoTableDef [MFC], CreateField", "CDaoTableDef [MFC], CreateIndex", "CDaoTableDef [MFC], DeleteField", "CDaoTableDef [MFC], DeleteIndex", "CDaoTableDef [MFC], GetAttributes", "CDaoTableDef [MFC], GetConnect", "CDaoTableDef [MFC], GetDateCreated", "CDaoTableDef [MFC], GetDateLastUpdated", "CDaoTableDef [MFC], GetFieldCount", "CDaoTableDef [MFC], GetFieldInfo", "CDaoTableDef [MFC], GetIndexCount", "CDaoTableDef [MFC], GetIndexInfo", "CDaoTableDef [MFC], GetName", "CDaoTableDef [MFC], GetRecordCount", "CDaoTableDef [MFC], GetSourceTableName", "CDaoTableDef [MFC], GetValidationRule", "CDaoTableDef [MFC], GetValidationText", "CDaoTableDef [MFC], IsOpen", "CDaoTableDef [MFC], Open", "CDaoTableDef [MFC], RefreshLink", "CDaoTableDef [MFC], SetAttributes", "CDaoTableDef [MFC], SetConnect", "CDaoTableDef [MFC], SetName", "CDaoTableDef [MFC], SetSourceTableName", "CDaoTableDef [MFC], SetValidationRule", "CDaoTableDef [MFC], SetValidationText", "CDaoTableDef [MFC], m_pDAOTableDef", "CDaoTableDef [MFC], m_pDatabase"] +ms.custom: sfi-ropc-nochange --- # CDaoTableDef Class diff --git a/docs/mfc/reference/cdaoworkspace-class.md b/docs/mfc/reference/cdaoworkspace-class.md index 777678f429c..0f1ddba2a65 100644 --- a/docs/mfc/reference/cdaoworkspace-class.md +++ b/docs/mfc/reference/cdaoworkspace-class.md @@ -4,6 +4,7 @@ title: "CDaoWorkspace Class" ms.date: "11/04/2016" f1_keywords: ["CDaoWorkspace", "AFXDAO/CDaoWorkspace", "AFXDAO/CDaoWorkspace::CDaoWorkspace", "AFXDAO/CDaoWorkspace::Append", "AFXDAO/CDaoWorkspace::BeginTrans", "AFXDAO/CDaoWorkspace::Close", "AFXDAO/CDaoWorkspace::CommitTrans", "AFXDAO/CDaoWorkspace::CompactDatabase", "AFXDAO/CDaoWorkspace::Create", "AFXDAO/CDaoWorkspace::GetDatabaseCount", "AFXDAO/CDaoWorkspace::GetDatabaseInfo", "AFXDAO/CDaoWorkspace::GetIniPath", "AFXDAO/CDaoWorkspace::GetIsolateODBCTrans", "AFXDAO/CDaoWorkspace::GetLoginTimeout", "AFXDAO/CDaoWorkspace::GetName", "AFXDAO/CDaoWorkspace::GetUserName", "AFXDAO/CDaoWorkspace::GetVersion", "AFXDAO/CDaoWorkspace::GetWorkspaceCount", "AFXDAO/CDaoWorkspace::GetWorkspaceInfo", "AFXDAO/CDaoWorkspace::Idle", "AFXDAO/CDaoWorkspace::IsOpen", "AFXDAO/CDaoWorkspace::Open", "AFXDAO/CDaoWorkspace::RepairDatabase", "AFXDAO/CDaoWorkspace::Rollback", "AFXDAO/CDaoWorkspace::SetDefaultPassword", "AFXDAO/CDaoWorkspace::SetDefaultUser", "AFXDAO/CDaoWorkspace::SetIniPath", "AFXDAO/CDaoWorkspace::SetIsolateODBCTrans", "AFXDAO/CDaoWorkspace::SetLoginTimeout", "AFXDAO/CDaoWorkspace::m_pDAOWorkspace"] helpviewer_keywords: ["CDaoWorkspace [MFC], CDaoWorkspace", "CDaoWorkspace [MFC], Append", "CDaoWorkspace [MFC], BeginTrans", "CDaoWorkspace [MFC], Close", "CDaoWorkspace [MFC], CommitTrans", "CDaoWorkspace [MFC], CompactDatabase", "CDaoWorkspace [MFC], Create", "CDaoWorkspace [MFC], GetDatabaseCount", "CDaoWorkspace [MFC], GetDatabaseInfo", "CDaoWorkspace [MFC], GetIniPath", "CDaoWorkspace [MFC], GetIsolateODBCTrans", "CDaoWorkspace [MFC], GetLoginTimeout", "CDaoWorkspace [MFC], GetName", "CDaoWorkspace [MFC], GetUserName", "CDaoWorkspace [MFC], GetVersion", "CDaoWorkspace [MFC], GetWorkspaceCount", "CDaoWorkspace [MFC], GetWorkspaceInfo", "CDaoWorkspace [MFC], Idle", "CDaoWorkspace [MFC], IsOpen", "CDaoWorkspace [MFC], Open", "CDaoWorkspace [MFC], RepairDatabase", "CDaoWorkspace [MFC], Rollback", "CDaoWorkspace [MFC], SetDefaultPassword", "CDaoWorkspace [MFC], SetDefaultUser", "CDaoWorkspace [MFC], SetIniPath", "CDaoWorkspace [MFC], SetIsolateODBCTrans", "CDaoWorkspace [MFC], SetLoginTimeout", "CDaoWorkspace [MFC], m_pDAOWorkspace"] +ms.custom: sfi-ropc-nochange --- # CDaoWorkspace Class diff --git a/docs/mfc/reference/cdatabase-class.md b/docs/mfc/reference/cdatabase-class.md index 77fb3fd71c9..7258c18594b 100644 --- a/docs/mfc/reference/cdatabase-class.md +++ b/docs/mfc/reference/cdatabase-class.md @@ -4,6 +4,7 @@ title: "CDatabase Class" ms.date: "11/04/2016" f1_keywords: ["CDatabase", "AFXDB/CDatabase", "AFXDB/CDatabase::CDatabase", "AFXDB/CDatabase::BeginTrans", "AFXDB/CDatabase::BindParameters", "AFXDB/CDatabase::Cancel", "AFXDB/CDatabase::CanTransact", "AFXDB/CDatabase::CanUpdate", "AFXDB/CDatabase::Close", "AFXDB/CDatabase::CommitTrans", "AFXDB/CDatabase::ExecuteSQL", "AFXDB/CDatabase::GetBookmarkPersistence", "AFXDB/CDatabase::GetConnect", "AFXDB/CDatabase::GetCursorCommitBehavior", "AFXDB/CDatabase::GetCursorRollbackBehavior", "AFXDB/CDatabase::GetDatabaseName", "AFXDB/CDatabase::IsOpen", "AFXDB/CDatabase::OnSetOptions", "AFXDB/CDatabase::Open", "AFXDB/CDatabase::OpenEx", "AFXDB/CDatabase::Rollback", "AFXDB/CDatabase::SetLoginTimeout", "AFXDB/CDatabase::SetQueryTimeout", "AFXDB/CDatabase::m_hdbc"] helpviewer_keywords: ["CDatabase [MFC], CDatabase", "CDatabase [MFC], BeginTrans", "CDatabase [MFC], BindParameters", "CDatabase [MFC], Cancel", "CDatabase [MFC], CanTransact", "CDatabase [MFC], CanUpdate", "CDatabase [MFC], Close", "CDatabase [MFC], CommitTrans", "CDatabase [MFC], ExecuteSQL", "CDatabase [MFC], GetBookmarkPersistence", "CDatabase [MFC], GetConnect", "CDatabase [MFC], GetCursorCommitBehavior", "CDatabase [MFC], GetCursorRollbackBehavior", "CDatabase [MFC], GetDatabaseName", "CDatabase [MFC], IsOpen", "CDatabase [MFC], OnSetOptions", "CDatabase [MFC], Open", "CDatabase [MFC], OpenEx", "CDatabase [MFC], Rollback", "CDatabase [MFC], SetLoginTimeout", "CDatabase [MFC], SetQueryTimeout", "CDatabase [MFC], m_hdbc"] +ms.custom: sfi-ropc-nochange --- # `CDatabase` Class diff --git a/docs/mfc/reference/cdc-class.md b/docs/mfc/reference/cdc-class.md index 5c2e0f08479..69ea401ff76 100644 --- a/docs/mfc/reference/cdc-class.md +++ b/docs/mfc/reference/cdc-class.md @@ -1,7 +1,7 @@ --- title: "CDC Class" description: "Learn more about: CDC Class" -ms.date: "11/19/2018" +ms.date: 11/19/2018 f1_keywords: ["CDC", "AFXWIN/CDC", "AFXWIN/CDC::CDC", "AFXWIN/CDC::AbortDoc", "AFXWIN/CDC::AbortPath", "AFXWIN/CDC::AddMetaFileComment", "AFXWIN/CDC::AlphaBlend", "AFXWIN/CDC::AngleArc", "AFXWIN/CDC::Arc", "AFXWIN/CDC::ArcTo", "AFXWIN/CDC::Attach", "AFXWIN/CDC::BeginPath", "AFXWIN/CDC::BitBlt", "AFXWIN/CDC::Chord", "AFXWIN/CDC::CloseFigure", "AFXWIN/CDC::CreateCompatibleDC", "AFXWIN/CDC::CreateDC", "AFXWIN/CDC::CreateIC", "AFXWIN/CDC::DeleteDC", "AFXWIN/CDC::DeleteTempMap", "AFXWIN/CDC::Detach", "AFXWIN/CDC::DPtoHIMETRIC", "AFXWIN/CDC::DPtoLP", "AFXWIN/CDC::Draw3dRect", "AFXWIN/CDC::DrawDragRect", "AFXWIN/CDC::DrawEdge", "AFXWIN/CDC::DrawEscape", "AFXWIN/CDC::DrawFocusRect", "AFXWIN/CDC::DrawFrameControl", "AFXWIN/CDC::DrawIcon", "AFXWIN/CDC::DrawState", "AFXWIN/CDC::DrawText", "AFXWIN/CDC::DrawTextEx", "AFXWIN/CDC::Ellipse", "AFXWIN/CDC::EndDoc", "AFXWIN/CDC::EndPage", "AFXWIN/CDC::EndPath", "AFXWIN/CDC::EnumObjects", "AFXWIN/CDC::Escape", "AFXWIN/CDC::ExcludeClipRect", "AFXWIN/CDC::ExcludeUpdateRgn", "AFXWIN/CDC::ExtFloodFill", "AFXWIN/CDC::ExtTextOut", "AFXWIN/CDC::FillPath", "AFXWIN/CDC::FillRect", "AFXWIN/CDC::FillRgn", "AFXWIN/CDC::FillSolidRect", "AFXWIN/CDC::FlattenPath", "AFXWIN/CDC::FloodFill", "AFXWIN/CDC::FrameRect", "AFXWIN/CDC::FrameRgn", "AFXWIN/CDC::FromHandle", "AFXWIN/CDC::GetArcDirection", "AFXWIN/CDC::GetAspectRatioFilter", "AFXWIN/CDC::GetBkColor", "AFXWIN/CDC::GetBkMode", "AFXWIN/CDC::GetBoundsRect", "AFXWIN/CDC::GetBrushOrg", "AFXWIN/CDC::GetCharABCWidths", "AFXWIN/CDC::GetCharABCWidthsI", "AFXWIN/CDC::GetCharacterPlacement", "AFXWIN/CDC::GetCharWidth", "AFXWIN/CDC::GetCharWidthI", "AFXWIN/CDC::GetClipBox", "AFXWIN/CDC::GetColorAdjustment", "AFXWIN/CDC::GetCurrentBitmap", "AFXWIN/CDC::GetCurrentBrush", "AFXWIN/CDC::GetCurrentFont", "AFXWIN/CDC::GetCurrentPalette", "AFXWIN/CDC::GetCurrentPen", "AFXWIN/CDC::GetCurrentPosition", "AFXWIN/CDC::GetDCBrushColor", "AFXWIN/CDC::GetDCPenColor", "AFXWIN/CDC::GetDeviceCaps", "AFXWIN/CDC::GetFontData", "AFXWIN/CDC::GetFontLanguageInfo", "AFXWIN/CDC::GetGlyphOutline", "AFXWIN/CDC::GetGraphicsMode", "AFXWIN/CDC::GetHalftoneBrush", "AFXWIN/CDC::GetKerningPairs", "AFXWIN/CDC::GetLayout", "AFXWIN/CDC::GetMapMode", "AFXWIN/CDC::GetMiterLimit", "AFXWIN/CDC::GetNearestColor", "AFXWIN/CDC::GetOutlineTextMetrics", "AFXWIN/CDC::GetOutputCharWidth", "AFXWIN/CDC::GetOutputTabbedTextExtent", "AFXWIN/CDC::GetOutputTextExtent", "AFXWIN/CDC::GetOutputTextMetrics", "AFXWIN/CDC::GetPath", "AFXWIN/CDC::GetPixel", "AFXWIN/CDC::GetPolyFillMode", "AFXWIN/CDC::GetROP2", "AFXWIN/CDC::GetSafeHdc", "AFXWIN/CDC::GetStretchBltMode", "AFXWIN/CDC::GetTabbedTextExtent", "AFXWIN/CDC::GetTextAlign", "AFXWIN/CDC::GetTextCharacterExtra", "AFXWIN/CDC::GetTextColor", "AFXWIN/CDC::GetTextExtent", "AFXWIN/CDC::GetTextExtentExPointI", "AFXWIN/CDC::GetTextExtentPointI", "AFXWIN/CDC::GetTextFace", "AFXWIN/CDC::GetTextMetrics", "AFXWIN/CDC::GetViewportExt", "AFXWIN/CDC::GetViewportOrg", "AFXWIN/CDC::GetWindow", "AFXWIN/CDC::GetWindowExt", "AFXWIN/CDC::GetWindowOrg", "AFXWIN/CDC::GetWorldTransform", "AFXWIN/CDC::GradientFill", "AFXWIN/CDC::GrayString", "AFXWIN/CDC::HIMETRICtoDP", "AFXWIN/CDC::HIMETRICtoLP", "AFXWIN/CDC::IntersectClipRect", "AFXWIN/CDC::InvertRect", "AFXWIN/CDC::InvertRgn", "AFXWIN/CDC::IsPrinting", "AFXWIN/CDC::LineTo", "AFXWIN/CDC::LPtoDP", "AFXWIN/CDC::LPtoHIMETRIC", "AFXWIN/CDC::MaskBlt", "AFXWIN/CDC::ModifyWorldTransform", "AFXWIN/CDC::MoveTo", "AFXWIN/CDC::OffsetClipRgn", "AFXWIN/CDC::OffsetViewportOrg", "AFXWIN/CDC::OffsetWindowOrg", "AFXWIN/CDC::PaintRgn", "AFXWIN/CDC::PatBlt", "AFXWIN/CDC::Pie", "AFXWIN/CDC::PlayMetaFile", "AFXWIN/CDC::PlgBlt", "AFXWIN/CDC::PolyBezier", "AFXWIN/CDC::PolyBezierTo", "AFXWIN/CDC::PolyDraw", "AFXWIN/CDC::Polygon", "AFXWIN/CDC::Polyline", "AFXWIN/CDC::PolylineTo", "AFXWIN/CDC::PolyPolygon", "AFXWIN/CDC::PolyPolyline", "AFXWIN/CDC::PtVisible", "AFXWIN/CDC::RealizePalette", "AFXWIN/CDC::Rectangle", "AFXWIN/CDC::RectVisible", "AFXWIN/CDC::ReleaseAttribDC", "AFXWIN/CDC::ReleaseOutputDC", "AFXWIN/CDC::ResetDC", "AFXWIN/CDC::RestoreDC", "AFXWIN/CDC::RoundRect", "AFXWIN/CDC::SaveDC", "AFXWIN/CDC::ScaleViewportExt", "AFXWIN/CDC::ScaleWindowExt", "AFXWIN/CDC::ScrollDC", "AFXWIN/CDC::SelectClipPath", "AFXWIN/CDC::SelectClipRgn", "AFXWIN/CDC::SelectObject", "AFXWIN/CDC::SelectPalette", "AFXWIN/CDC::SelectStockObject", "AFXWIN/CDC::SetAbortProc", "AFXWIN/CDC::SetArcDirection", "AFXWIN/CDC::SetAttribDC", "AFXWIN/CDC::SetBkColor", "AFXWIN/CDC::SetBkMode", "AFXWIN/CDC::SetBoundsRect", "AFXWIN/CDC::SetBrushOrg", "AFXWIN/CDC::SetColorAdjustment", "AFXWIN/CDC::SetDCBrushColor", "AFXWIN/CDC::SetDCPenColor", "AFXWIN/CDC::SetGraphicsMode", "AFXWIN/CDC::SetLayout", "AFXWIN/CDC::SetMapMode", "AFXWIN/CDC::SetMapperFlags", "AFXWIN/CDC::SetMiterLimit", "AFXWIN/CDC::SetOutputDC", "AFXWIN/CDC::SetPixel", "AFXWIN/CDC::SetPixelV", "AFXWIN/CDC::SetPolyFillMode", "AFXWIN/CDC::SetROP2", "AFXWIN/CDC::SetStretchBltMode", "AFXWIN/CDC::SetTextAlign", "AFXWIN/CDC::SetTextCharacterExtra", "AFXWIN/CDC::SetTextColor", "AFXWIN/CDC::SetTextJustification", "AFXWIN/CDC::SetViewportExt", "AFXWIN/CDC::SetViewportOrg", "AFXWIN/CDC::SetWindowExt", "AFXWIN/CDC::SetWindowOrg", "AFXWIN/CDC::SetWorldTransform", "AFXWIN/CDC::StartDoc", "AFXWIN/CDC::StartPage", "AFXWIN/CDC::StretchBlt", "AFXWIN/CDC::StrokeAndFillPath", "AFXWIN/CDC::StrokePath", "AFXWIN/CDC::TabbedTextOut", "AFXWIN/CDC::TextOut", "AFXWIN/CDC::TransparentBlt", "AFXWIN/CDC::UpdateColors", "AFXWIN/CDC::WidenPath", "AFXWIN/CDC::m_hAttribDC", "AFXWIN/CDC::m_hDC"] helpviewer_keywords: ["CDC [MFC], CDC", "CDC [MFC], AbortDoc", "CDC [MFC], AbortPath", "CDC [MFC], AddMetaFileComment", "CDC [MFC], AlphaBlend", "CDC [MFC], AngleArc", "CDC [MFC], Arc", "CDC [MFC], ArcTo", "CDC [MFC], Attach", "CDC [MFC], BeginPath", "CDC [MFC], BitBlt", "CDC [MFC], Chord", "CDC [MFC], CloseFigure", "CDC [MFC], CreateCompatibleDC", "CDC [MFC], CreateDC", "CDC [MFC], CreateIC", "CDC [MFC], DeleteDC", "CDC [MFC], DeleteTempMap", "CDC [MFC], Detach", "CDC [MFC], DPtoHIMETRIC", "CDC [MFC], DPtoLP", "CDC [MFC], Draw3dRect", "CDC [MFC], DrawDragRect", "CDC [MFC], DrawEdge", "CDC [MFC], DrawEscape", "CDC [MFC], DrawFocusRect", "CDC [MFC], DrawFrameControl", "CDC [MFC], DrawIcon", "CDC [MFC], DrawState", "CDC [MFC], DrawText", "CDC [MFC], DrawTextEx", "CDC [MFC], Ellipse", "CDC [MFC], EndDoc", "CDC [MFC], EndPage", "CDC [MFC], EndPath", "CDC [MFC], EnumObjects", "CDC [MFC], Escape", "CDC [MFC], ExcludeClipRect", "CDC [MFC], ExcludeUpdateRgn", "CDC [MFC], ExtFloodFill", "CDC [MFC], ExtTextOut", "CDC [MFC], FillPath", "CDC [MFC], FillRect", "CDC [MFC], FillRgn", "CDC [MFC], FillSolidRect", "CDC [MFC], FlattenPath", "CDC [MFC], FloodFill", "CDC [MFC], FrameRect", "CDC [MFC], FrameRgn", "CDC [MFC], FromHandle", "CDC [MFC], GetArcDirection", "CDC [MFC], GetAspectRatioFilter", "CDC [MFC], GetBkColor", "CDC [MFC], GetBkMode", "CDC [MFC], GetBoundsRect", "CDC [MFC], GetBrushOrg", "CDC [MFC], GetCharABCWidths", "CDC [MFC], GetCharABCWidthsI", "CDC [MFC], GetCharacterPlacement", "CDC [MFC], GetCharWidth", "CDC [MFC], GetCharWidthI", "CDC [MFC], GetClipBox", "CDC [MFC], GetColorAdjustment", "CDC [MFC], GetCurrentBitmap", "CDC [MFC], GetCurrentBrush", "CDC [MFC], GetCurrentFont", "CDC [MFC], GetCurrentPalette", "CDC [MFC], GetCurrentPen", "CDC [MFC], GetCurrentPosition", "CDC [MFC], GetDCBrushColor", "CDC [MFC], GetDCPenColor", "CDC [MFC], GetDeviceCaps", "CDC [MFC], GetFontData", "CDC [MFC], GetFontLanguageInfo", "CDC [MFC], GetGlyphOutline", "CDC [MFC], GetGraphicsMode", "CDC [MFC], GetHalftoneBrush", "CDC [MFC], GetKerningPairs", "CDC [MFC], GetLayout", "CDC [MFC], GetMapMode", "CDC [MFC], GetMiterLimit", "CDC [MFC], GetNearestColor", "CDC [MFC], GetOutlineTextMetrics", "CDC [MFC], GetOutputCharWidth", "CDC [MFC], GetOutputTabbedTextExtent", "CDC [MFC], GetOutputTextExtent", "CDC [MFC], GetOutputTextMetrics", "CDC [MFC], GetPath", "CDC [MFC], GetPixel", "CDC [MFC], GetPolyFillMode", "CDC [MFC], GetROP2", "CDC [MFC], GetSafeHdc", "CDC [MFC], GetStretchBltMode", "CDC [MFC], GetTabbedTextExtent", "CDC [MFC], GetTextAlign", "CDC [MFC], GetTextCharacterExtra", "CDC [MFC], GetTextColor", "CDC [MFC], GetTextExtent", "CDC [MFC], GetTextExtentExPointI", "CDC [MFC], GetTextExtentPointI", "CDC [MFC], GetTextFace", "CDC [MFC], GetTextMetrics", "CDC [MFC], GetViewportExt", "CDC [MFC], GetViewportOrg", "CDC [MFC], GetWindow", "CDC [MFC], GetWindowExt", "CDC [MFC], GetWindowOrg", "CDC [MFC], GetWorldTransform", "CDC [MFC], GradientFill", "CDC [MFC], GrayString", "CDC [MFC], HIMETRICtoDP", "CDC [MFC], HIMETRICtoLP", "CDC [MFC], IntersectClipRect", "CDC [MFC], InvertRect", "CDC [MFC], InvertRgn", "CDC [MFC], IsPrinting", "CDC [MFC], LineTo", "CDC [MFC], LPtoDP", "CDC [MFC], LPtoHIMETRIC", "CDC [MFC], MaskBlt", "CDC [MFC], ModifyWorldTransform", "CDC [MFC], MoveTo", "CDC [MFC], OffsetClipRgn", "CDC [MFC], OffsetViewportOrg", "CDC [MFC], OffsetWindowOrg", "CDC [MFC], PaintRgn", "CDC [MFC], PatBlt", "CDC [MFC], Pie", "CDC [MFC], PlayMetaFile", "CDC [MFC], PlgBlt", "CDC [MFC], PolyBezier", "CDC [MFC], PolyBezierTo", "CDC [MFC], PolyDraw", "CDC [MFC], Polygon", "CDC [MFC], Polyline", "CDC [MFC], PolylineTo", "CDC [MFC], PolyPolygon", "CDC [MFC], PolyPolyline", "CDC [MFC], PtVisible", "CDC [MFC], RealizePalette", "CDC [MFC], Rectangle", "CDC [MFC], RectVisible", "CDC [MFC], ReleaseAttribDC", "CDC [MFC], ReleaseOutputDC", "CDC [MFC], ResetDC", "CDC [MFC], RestoreDC", "CDC [MFC], RoundRect", "CDC [MFC], SaveDC", "CDC [MFC], ScaleViewportExt", "CDC [MFC], ScaleWindowExt", "CDC [MFC], ScrollDC", "CDC [MFC], SelectClipPath", "CDC [MFC], SelectClipRgn", "CDC [MFC], SelectObject", "CDC [MFC], SelectPalette", "CDC [MFC], SelectStockObject", "CDC [MFC], SetAbortProc", "CDC [MFC], SetArcDirection", "CDC [MFC], SetAttribDC", "CDC [MFC], SetBkColor", "CDC [MFC], SetBkMode", "CDC [MFC], SetBoundsRect", "CDC [MFC], SetBrushOrg", "CDC [MFC], SetColorAdjustment", "CDC [MFC], SetDCBrushColor", "CDC [MFC], SetDCPenColor", "CDC [MFC], SetGraphicsMode", "CDC [MFC], SetLayout", "CDC [MFC], SetMapMode", "CDC [MFC], SetMapperFlags", "CDC [MFC], SetMiterLimit", "CDC [MFC], SetOutputDC", "CDC [MFC], SetPixel", "CDC [MFC], SetPixelV", "CDC [MFC], SetPolyFillMode", "CDC [MFC], SetROP2", "CDC [MFC], SetStretchBltMode", "CDC [MFC], SetTextAlign", "CDC [MFC], SetTextCharacterExtra", "CDC [MFC], SetTextColor", "CDC [MFC], SetTextJustification", "CDC [MFC], SetViewportExt", "CDC [MFC], SetViewportOrg", "CDC [MFC], SetWindowExt", "CDC [MFC], SetWindowOrg", "CDC [MFC], SetWorldTransform", "CDC [MFC], StartDoc", "CDC [MFC], StartPage", "CDC [MFC], StretchBlt", "CDC [MFC], StrokeAndFillPath", "CDC [MFC], StrokePath", "CDC [MFC], TabbedTextOut", "CDC [MFC], TextOut", "CDC [MFC], TransparentBlt", "CDC [MFC], UpdateColors", "CDC [MFC], WidenPath", "CDC [MFC], m_hAttribDC", "CDC [MFC], m_hDC"] --- @@ -590,7 +590,7 @@ Nonzero if the function is successful; otherwise 0. ### Remarks -This function is similar to `CDC::Arc`, except that the current position is updated. The points ( *`x1`*, *`y1`*) and ( *`x2`*, *`y2`*) specify the bounding rectangle. An ellipse formed by the given bounding rectangle defines the curve of the arc. The arc extends counterclockwise (the default arc direction) from the point where it intersects the radial line from the center of the bounding rectangle to ( *`x3*`, *`y3`*). The arc ends where it intersects the radial line from the center of the bounding rectangle to ( *`x4`*, *`y4`*). If the starting point and ending point are the same, a complete ellipse is drawn. +This function is similar to `CDC::Arc`, except that the current position is updated. The points ( *`x1`*, *`y1`*) and ( *`x2`*, *`y2`*) specify the bounding rectangle. An ellipse formed by the given bounding rectangle defines the curve of the arc. The arc extends counterclockwise (the default arc direction) from the point where it intersects the radial line from the center of the bounding rectangle to ( *`x3`*, *`y3`*). The arc ends where it intersects the radial line from the center of the bounding rectangle to ( *`x4`*, *`y4`*). If the starting point and ending point are the same, a complete ellipse is drawn. A line is drawn from the current position to the starting point of the arc. If no error occurs, the current position is set to the ending point of the arc. The arc is drawn using the current pen; it isn't filled. @@ -764,7 +764,7 @@ Specifies the bounding rectangle (in logical units). You can pass either a `LPRE *`ptStart`*\ Specifies the x- and y-coordinates of the point that defines the chord's starting point (in logical units). This point doesn't have to lie exactly on the chord. You can pass either a `POINT` structure or a `CPoint` object for this parameter. -*`ptEnd*`\ +*`ptEnd`*\ Specifies the x- and y-coordinates of the point that defines the chord's ending point (in logical units). This point doesn't have to lie exactly on the chord. You can pass either a [`POINT`](/windows/win32/api/windef/ns-windef-point) structure or a [`CPoint`](../../atl-mfc-shared/reference/cpoint-class.md) object for this parameter. ### Return Value @@ -1643,7 +1643,7 @@ Specifies the last value returned by the [callback function](callback-functions- For each object of a given type, the callback function that you pass is called with the information for that object. The system calls the callback function until there are no more objects or the callback function returns 0. -New features of Microsoft Visual C++ let you use an ordinary function as the function passed to `EnumObjects`. The address passed to `EnumObjects` is a pointer to a function exported with **`EXPORT`** and with the Pascal calling convention. In protect-mode applications, you don't have to create this function with the Windows `MakeProcInstance` function or free the function after use with the `FreeProcInstance` Windows function. +New features of Visual Studio let you use an ordinary function as the function passed to `EnumObjects`. The address passed to `EnumObjects` is a pointer to a function exported with **`EXPORT`** and with the Pascal calling convention. In protect-mode applications, you don't have to create this function with the Windows `MakeProcInstance` function or free the function after use with the `FreeProcInstance` Windows function. You also don't have to export the function name in an **`EXPORTS`** statement in your application's module-definition file. You can instead use the **`EXPORT`** function modifier, as in @@ -2999,7 +2999,7 @@ The function stores the values in the buffer pointed to by *`lpBuffer`*. This bu If a character in the consecutive group of characters doesn't exist in a particular font, it will be assigned the width value of the default character. -## `CDC::GetOutputTabbedTextExtent` +## `CDC::GetOutputTabbedTextExtent` Call this member function to compute the width and height of a character string using [`m_hDC`](#m_hdc), the output device context. @@ -3145,7 +3145,7 @@ The device context must contain a closed path. The points of the path are return ## `CDC::GetPixel` -Retrieves the RGB color value of the pixel at the point specified by *`x`* and *`y*`. +Retrieves the RGB color value of the pixel at the point specified by *`x`* and *`y`*. ``` COLORREF GetPixel( @@ -4588,7 +4588,7 @@ BOOL Polyline( *`lpPoints`*\ Points to an array of `POINT` structures or `CPoint` objects to be connected. -*`nCount`*`\ +*`nCount`*\ Specifies the number of points in the array. This value must be at least 2. ### Return Value @@ -5336,7 +5336,7 @@ Specifies the outcome of the `SetAbortProc` function. Some of the following valu If an application is to allow the print job to be canceled during spooling, it must set the abort function before the print job is started with the [`StartDoc`](#startdoc) member function. The Print Manager calls the abort function during spooling to allow the application to cancel the print job or to process out-of-disk-space conditions. If no abort function is set, the print job will fail if there isn't enough disk space for spooling. -The features of Microsoft Visual C++ simplify the creation of the callback function passed to `SetAbortProc`. The address passed to the `EnumObjects` member function is a pointer to a function exported with `__declspec(dllexport)` and with the **`__stdcall`** calling convention. +The features of Visual Studio simplify the creation of the callback function passed to `SetAbortProc`. The address passed to the `EnumObjects` member function is a pointer to a function exported with `__declspec(dllexport)` and with the **`__stdcall`** calling convention. You also don't have to export the function name in an **`EXPORTS`** statement in your application's module-definition file. You can instead use the **`EXPORT`** function modifier, as in diff --git a/docs/mfc/reference/cdialog-class.md b/docs/mfc/reference/cdialog-class.md index 099d0e3718e..fa6866e8b86 100644 --- a/docs/mfc/reference/cdialog-class.md +++ b/docs/mfc/reference/cdialog-class.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: CDialog Class" title: "CDialog Class" -ms.date: "09/07/2019" +description: "Learn more about: CDialog Class" +ms.date: 09/07/2019 f1_keywords: ["CDialog", "AFXWIN/CDialog", "AFXWIN/CDialog::CDialog", "AFXWIN/CDialog::Create", "AFXWIN/CDialog::CreateIndirect", "AFXWIN/CDialog::DoModal", "AFXWIN/CDialog::EndDialog", "AFXWIN/CDialog::GetDefID", "AFXWIN/CDialog::GotoDlgCtrl", "AFXWIN/CDialog::InitModalIndirect", "AFXWIN/CDialog::MapDialogRect", "AFXWIN/CDialog::NextDlgCtrl", "AFXWIN/CDialog::OnInitDialog", "AFXWIN/CDialog::OnSetFont", "AFXWIN/CDialog::PrevDlgCtrl", "AFXWIN/CDialog::SetDefID", "AFXWIN/CDialog::SetHelpID", "AFXWIN/CDialog::OnCancel", "AFXWIN/CDialog::OnOK"] helpviewer_keywords: ["CDialog [MFC], CDialog", "CDialog [MFC], Create", "CDialog [MFC], CreateIndirect", "CDialog [MFC], DoModal", "CDialog [MFC], EndDialog", "CDialog [MFC], GetDefID", "CDialog [MFC], GotoDlgCtrl", "CDialog [MFC], InitModalIndirect", "CDialog [MFC], MapDialogRect", "CDialog [MFC], NextDlgCtrl", "CDialog [MFC], OnInitDialog", "CDialog [MFC], OnSetFont", "CDialog [MFC], PrevDlgCtrl", "CDialog [MFC], SetDefID", "CDialog [MFC], SetHelpID", "CDialog [MFC], OnCancel", "CDialog [MFC], OnOK"] -ms.assetid: ca64b77e-2cd2-47e3-8eff-c2645ad578f9 --- # CDialog Class @@ -287,7 +286,7 @@ DWORD GetDefID() const; ### Return Value -A 32-bit value ( `DWORD`). If the default pushbutton has an ID value, the high-order word contains DC_HASDEFID and the low-order word contains the ID value. If the default pushbutton does not have an ID value, the return value is 0. +A 32-bit value (`DWORD`). If the default pushbutton has an ID value, the high-order word contains DC_HASDEFID and the low-order word contains the ID value. If the default pushbutton does not have an ID value, the return value is 0. ### Remarks diff --git a/docs/mfc/reference/cdialogbar-class.md b/docs/mfc/reference/cdialogbar-class.md index 8d8c5acd272..4b613e0fa29 100644 --- a/docs/mfc/reference/cdialogbar-class.md +++ b/docs/mfc/reference/cdialogbar-class.md @@ -39,7 +39,7 @@ Creating and using a dialog bar is similar to creating and using a `CFormView` o For more information on `CDialogBar`, see the article [Dialog Bars](../../mfc/dialog-bars.md) and [Technical Note 31](../../mfc/tn031-control-bars.md), Control Bars. > [!NOTE] -> In the current release, a `CDialogBar` object cannot host Windows Forms controls. For more information about Windows Forms controls in Visual C++, see [Using a Windows Form User Control in MFC](../../dotnet/using-a-windows-form-user-control-in-mfc.md). +> In the current release, a `CDialogBar` object cannot host Windows Forms controls. For more information about Windows Forms controls in Visual Studio, see [Using a Windows Form User Control in MFC](../../dotnet/using-a-windows-form-user-control-in-mfc.md). ## Inheritance Hierarchy diff --git a/docs/mfc/reference/cdockablepane-class.md b/docs/mfc/reference/cdockablepane-class.md index 159c429e7f6..cd6f7131161 100644 --- a/docs/mfc/reference/cdockablepane-class.md +++ b/docs/mfc/reference/cdockablepane-class.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: CDockablePane Class" title: "CDockablePane Class" -ms.date: "07/02/2019" +description: "Learn more about: CDockablePane Class" +ms.date: 07/02/2019 f1_keywords: ["CDockablePane", "AFXDOCKABLEPANE/CDockablePane", "AFXDOCKABLEPANE/CDockablePane::CDockablePane", "AFXDOCKABLEPANE/CDockablePane::AttachToTabWnd", "AFXDOCKABLEPANE/CDockablePane::CalcFixedLayout", "AFXDOCKABLEPANE/CDockablePane::CanAcceptMiniFrame", "AFXDOCKABLEPANE/CDockablePane::CanAcceptPane", "AFXDOCKABLEPANE/CDockablePane::CanAutoHide", "AFXDOCKABLEPANE/CDockablePane::CanBeAttached", "AFXDOCKABLEPANE/CDockablePane::ConvertToTabbedDocument", "AFXDOCKABLEPANE/CDockablePane::CopyState", "AFXDOCKABLEPANE/CDockablePane::Create", "AFXDOCKABLEPANE/CDockablePane::CreateDefaultPaneDivider", "AFXDOCKABLEPANE/CDockablePane::CreateEx", "AFXDOCKABLEPANE/CDockablePane::CreateTabbedPane", "AFXDOCKABLEPANE/CDockablePane::DockPaneContainer", "AFXDOCKABLEPANE/CDockablePane::DockPaneStandard", "AFXDOCKABLEPANE/CDockablePane::DockToRecentPos", "AFXDOCKABLEPANE/CDockablePane::DockToWindow", "AFXDOCKABLEPANE/CDockablePane::EnableAutohideAll", "AFXDOCKABLEPANE/CDockablePane::EnableGripper", "AFXDOCKABLEPANE/CDockablePane::GetAHRestoredRect", "AFXDOCKABLEPANE/CDockablePane::GetAHSlideMode", "AFXDOCKABLEPANE/CDockablePane::GetCaptionHeight", "AFXDOCKABLEPANE/CDockablePane::GetDefaultPaneDivider", "AFXDOCKABLEPANE/CDockablePane::GetDockingStatus", "AFXDOCKABLEPANE/CDockablePane::GetDragSensitivity", "AFXDOCKABLEPANE/CDockablePane::GetLastPercentInPaneContainer", "AFXDOCKABLEPANE/CDockablePane::GetTabArea", "AFXDOCKABLEPANE/CDockablePane::GetTabbedPaneRTC", "AFXDOCKABLEPANE/CDockablePane::HasAutoHideMode", "AFXDOCKABLEPANE/CDockablePane::HitTest", "AFXDOCKABLEPANE/CDockablePane::IsAutohideAllEnabled", "AFXDOCKABLEPANE/CDockablePane::IsAutoHideMode", "AFXDOCKABLEPANE/CDockablePane::IsDocked", "AFXDOCKABLEPANE/CDockablePane::IsHideInAutoHideMode", "AFXDOCKABLEPANE/CDockablePane::IsInFloatingMultiPaneFrameWnd", "AFXDOCKABLEPANE/CDockablePane::IsResizable", "AFXDOCKABLEPANE/CDockablePane::IsTabLocationBottom", "AFXDOCKABLEPANE/CDockablePane::IsTracked", "AFXDOCKABLEPANE/CDockablePane::IsVisible", "AFXDOCKABLEPANE/CDockablePane::OnAfterChangeParent", "AFXDOCKABLEPANE/CDockablePane::OnAfterDockFromMiniFrame", "AFXDOCKABLEPANE/CDockablePane::OnBeforeChangeParent", "AFXDOCKABLEPANE/CDockablePane::OnBeforeFloat", "AFXDOCKABLEPANE/CDockablePane::RemoveFromDefaultPaneDividier", "AFXDOCKABLEPANE/CDockablePane::ReplacePane", "AFXDOCKABLEPANE/CDockablePane::RestoreDefaultPaneDivider", "AFXDOCKABLEPANE/CDockablePane::SetAutoHideMode", "AFXDOCKABLEPANE/CDockablePane::SetAutoHideParents", "AFXDOCKABLEPANE/CDockablePane::SetLastPercentInPaneContainer", "AFXDOCKABLEPANE/CDockablePane::SetRestoredDefaultPaneDivider", "AFXDOCKABLEPANE/CDockablePane::SetTabbedPaneRTC", "AFXDOCKABLEPANE/CDockablePane::ShowPane", "AFXDOCKABLEPANE/CDockablePane::Slide", "AFXDOCKABLEPANE/CDockablePane::ToggleAutoHide", "AFXDOCKABLEPANE/CDockablePane::UndockPane", "AFXDOCKABLEPANE/CDockablePane::CheckAutoHideCondition", "AFXDOCKABLEPANE/CDockablePane::CheckStopSlideCondition", "AFXDOCKABLEPANE/CDockablePane::DrawCaption", "AFXDOCKABLEPANE/CDockablePane::OnPressButtons", "AFXDOCKABLEPANE/CDockablePane::OnSlide", "AFXDOCKABLEPANE/CDockablePane::m_bDisableAnimation", "AFXDOCKABLEPANE/CDockablePane::m_bHideInAutoHideMode", "AFXDOCKABLEPANE/CDockablePane::m_nSlideSteps"] helpviewer_keywords: ["CDockablePane [MFC], CDockablePane", "CDockablePane [MFC], AttachToTabWnd", "CDockablePane [MFC], CalcFixedLayout", "CDockablePane [MFC], CanAcceptMiniFrame", "CDockablePane [MFC], CanAcceptPane", "CDockablePane [MFC], CanAutoHide", "CDockablePane [MFC], CanBeAttached", "CDockablePane [MFC], ConvertToTabbedDocument", "CDockablePane [MFC], CopyState", "CDockablePane [MFC], Create", "CDockablePane [MFC], CreateDefaultPaneDivider", "CDockablePane [MFC], CreateEx", "CDockablePane [MFC], CreateTabbedPane", "CDockablePane [MFC], DockPaneContainer", "CDockablePane [MFC], DockPaneStandard", "CDockablePane [MFC], DockToRecentPos", "CDockablePane [MFC], DockToWindow", "CDockablePane [MFC], EnableAutohideAll", "CDockablePane [MFC], EnableGripper", "CDockablePane [MFC], GetAHRestoredRect", "CDockablePane [MFC], GetAHSlideMode", "CDockablePane [MFC], GetCaptionHeight", "CDockablePane [MFC], GetDefaultPaneDivider", "CDockablePane [MFC], GetDockingStatus", "CDockablePane [MFC], GetDragSensitivity", "CDockablePane [MFC], GetLastPercentInPaneContainer", "CDockablePane [MFC], GetTabArea", "CDockablePane [MFC], GetTabbedPaneRTC", "CDockablePane [MFC], HasAutoHideMode", "CDockablePane [MFC], HitTest", "CDockablePane [MFC], IsAutohideAllEnabled", "CDockablePane [MFC], IsAutoHideMode", "CDockablePane [MFC], IsDocked", "CDockablePane [MFC], IsHideInAutoHideMode", "CDockablePane [MFC], IsInFloatingMultiPaneFrameWnd", "CDockablePane [MFC], IsResizable", "CDockablePane [MFC], IsTabLocationBottom", "CDockablePane [MFC], IsTracked", "CDockablePane [MFC], IsVisible", "CDockablePane [MFC], OnAfterChangeParent", "CDockablePane [MFC], OnAfterDockFromMiniFrame", "CDockablePane [MFC], OnBeforeChangeParent", "CDockablePane [MFC], OnBeforeFloat", "CDockablePane [MFC], RemoveFromDefaultPaneDividier", "CDockablePane [MFC], ReplacePane", "CDockablePane [MFC], RestoreDefaultPaneDivider", "CDockablePane [MFC], SetAutoHideMode", "CDockablePane [MFC], SetAutoHideParents", "CDockablePane [MFC], SetLastPercentInPaneContainer", "CDockablePane [MFC], SetRestoredDefaultPaneDivider", "CDockablePane [MFC], SetTabbedPaneRTC", "CDockablePane [MFC], ShowPane", "CDockablePane [MFC], Slide", "CDockablePane [MFC], ToggleAutoHide", "CDockablePane [MFC], UndockPane", "CDockablePane [MFC], CheckAutoHideCondition", "CDockablePane [MFC], CheckStopSlideCondition", "CDockablePane [MFC], DrawCaption", "CDockablePane [MFC], OnPressButtons", "CDockablePane [MFC], OnSlide", "CDockablePane [MFC], m_bDisableAnimation", "CDockablePane [MFC], m_bHideInAutoHideMode", "CDockablePane [MFC], m_nSlideSteps"] --- @@ -874,7 +874,7 @@ One of the following status values: The framework calls this method to handle docking of a floating pane. -For floating toolbars or docking panes that use the `DT_IMMEDIATE` docking mode, the framework delays the dock command to enable the user to move the window out of the client area of the parent frame before docking occurs. The length of the delay is measured in milliseconds and is controlled by the [`CDockingManager::m_nTimeOutBeforeToolBarDock`](../../mfc/reference/cdockingmanager-class.md#m_ntimeoutbeforetoolbardock) data member.. The default value of [`CDockingManager::m_nTimeOutBeforeToolBarDock`](../../mfc/reference/cdockingmanager-class.md#m_ntimeoutbeforetoolbardock) is 200. This behavior emulates the docking behavior of Microsoft Word 2007. +For floating toolbars or docking panes that use the `DT_IMMEDIATE` docking mode, the framework delays the dock command to enable the user to move the window out of the client area of the parent frame before docking occurs. The length of the delay is measured in milliseconds and is controlled by the [`CDockingManager::m_nTimeOutBeforeToolBarDock`](../../mfc/reference/cdockingmanager-class.md#m_ntimeoutbeforetoolbardock) data member. The default value of [`CDockingManager::m_nTimeOutBeforeToolBarDock`](../../mfc/reference/cdockingmanager-class.md#m_ntimeoutbeforetoolbardock) is 200. This behavior emulates the docking behavior of Microsoft Word 2007. For delayed docking states (`CS_DELAY_DOCK` and `CS_DELAY_DOCK_TO_TAB`), the framework doesn't perform docking until the user releases the mouse button. If a pane uses the `DT_STANDARD` docking mode, the framework displays a rectangle at the projected docking location. If a pane uses the `DT_SMART` docking mode, the framework displays smart docking markers and semi-transparent rectangles at the projected docking location. To specify the docking mode for your pane, call the [`CBasePane::SetDockingMode`](../../mfc/reference/cbasepane-class.md#setdockingmode) method. For more information about smart docking, see [`CDockingManager::GetSmartDockingParams`](../../mfc/reference/cdockingmanager-class.md#getsmartdockingparams). @@ -1142,7 +1142,7 @@ If the dockable pane is in autohide mode and `IsHideInAutoHideMode` returns `TRU If the dockable pane isn't in autohide mode, the visibility state is determined by the [`CBasePane::IsVisible`](../../mfc/reference/cbasepane-class.md#isvisible) method. -## ## `CDockablePane::LoadState` +## `CDockablePane::LoadState` For internal use only. For more detail, see the source code located in the `mfc` folder of your Visual Studio installation. For example, `%ProgramFiles(x86)%\Microsoft Visual Studio\2019\Enterprise\VC\Tools\MSVC\14.29.30133\atlmfc\src\mfc`. @@ -1201,7 +1201,7 @@ virtual void OnAfterChangeParent(CWnd* pWndOldParent); ### Parameters -[in] *`pWndOldParent`*\ +[in] *`pWndOldParent`* ### Remarks diff --git a/docs/mfc/reference/cdocobjectserver-class.md b/docs/mfc/reference/cdocobjectserver-class.md index 70f2fed0871..b99f2715ac6 100644 --- a/docs/mfc/reference/cdocobjectserver-class.md +++ b/docs/mfc/reference/cdocobjectserver-class.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: CDocObjectServer Class" title: "CDocObjectServer Class" -ms.date: "09/12/2018" +description: "Learn more about: CDocObjectServer Class" +ms.date: 09/12/2018 f1_keywords: ["CDocObjectServer", "AFXDOCOB/CDocObjectServer", "AFXDOCOB/CDocObjectServer::CDocObjectServer", "AFXDOCOB/CDocObjectServer::ActivateDocObject", "AFXDOCOB/CDocObjectServer::OnActivateView", "AFXDOCOB/CDocObjectServer::OnApplyViewState", "AFXDOCOB/CDocObjectServer::OnSaveViewState"] helpviewer_keywords: ["CDocObjectServer [MFC], CDocObjectServer", "CDocObjectServer [MFC], ActivateDocObject", "CDocObjectServer [MFC], OnActivateView", "CDocObjectServer [MFC], OnApplyViewState", "CDocObjectServer [MFC], OnSaveViewState"] -ms.assetid: 18cd0dff-0616-4472-b8d9-66c081bc383a --- # CDocObjectServer Class @@ -94,7 +93,7 @@ A pointer to the `IOleDocumentSite` interface implemented by the container. ### Remarks -When a DocObject is active, the client site OLE interface ( `IOleDocumentSite`) is what allows the DocObject server to communicate with its client (the container). When a DocObject server is activated, it first checks that the container implements the `IOleDocumentSite` interface. If so, [COleServerDoc::GetDocObjectServer](../../mfc/reference/coleserverdoc-class.md#getdocobjectserver) is called to see if the container supports DocObjects. By default, `GetDocObjectServer` returns NULL. You must override `COleServerDoc::GetDocObjectServer` to construct a new `CDocObjectServer` object or a derived object of your own, with pointers to the `COleServerDoc` container and its `IOleDocumentSite` interface as arguments to the constructor. +When a DocObject is active, the client site OLE interface (`IOleDocumentSite`) is what allows the DocObject server to communicate with its client (the container). When a DocObject server is activated, it first checks that the container implements the `IOleDocumentSite` interface. If so, [COleServerDoc::GetDocObjectServer](../../mfc/reference/coleserverdoc-class.md#getdocobjectserver) is called to see if the container supports DocObjects. By default, `GetDocObjectServer` returns NULL. You must override `COleServerDoc::GetDocObjectServer` to construct a new `CDocObjectServer` object or a derived object of your own, with pointers to the `COleServerDoc` container and its `IOleDocumentSite` interface as arguments to the constructor. ## CDocObjectServer::OnActivateView diff --git a/docs/mfc/reference/ceditview-class.md b/docs/mfc/reference/ceditview-class.md index 618fca8547c..19e9d78e469 100644 --- a/docs/mfc/reference/ceditview-class.md +++ b/docs/mfc/reference/ceditview-class.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: CEditView Class" title: "CEditView Class" -ms.date: "11/04/2016" +description: "Learn more about: CEditView Class" +ms.date: 11/04/2016 f1_keywords: ["CEditView", "AFXEXT/CEditView", "AFXEXT/CEditView::CEditView", "AFXEXT/CEditView::FindText", "AFXEXT/CEditView::GetBufferLength", "AFXEXT/CEditView::GetEditCtrl", "AFXEXT/CEditView::GetPrinterFont", "AFXEXT/CEditView::GetSelectedText", "AFXEXT/CEditView::LockBuffer", "AFXEXT/CEditView::PrintInsideRect", "AFXEXT/CEditView::SerializeRaw", "AFXEXT/CEditView::SetPrinterFont", "AFXEXT/CEditView::SetTabStops", "AFXEXT/CEditView::UnlockBuffer", "AFXEXT/CEditView::OnFindNext", "AFXEXT/CEditView::OnReplaceAll", "AFXEXT/CEditView::OnReplaceSel", "AFXEXT/CEditView::OnTextNotFound", "AFXEXT/CEditView::dwStyleDefault"] helpviewer_keywords: ["CEditView [MFC], CEditView", "CEditView [MFC], FindText", "CEditView [MFC], GetBufferLength", "CEditView [MFC], GetEditCtrl", "CEditView [MFC], GetPrinterFont", "CEditView [MFC], GetSelectedText", "CEditView [MFC], LockBuffer", "CEditView [MFC], PrintInsideRect", "CEditView [MFC], SerializeRaw", "CEditView [MFC], SetPrinterFont", "CEditView [MFC], SetTabStops", "CEditView [MFC], UnlockBuffer", "CEditView [MFC], OnFindNext", "CEditView [MFC], OnReplaceAll", "CEditView [MFC], OnReplaceSel", "CEditView [MFC], OnTextNotFound", "CEditView [MFC], dwStyleDefault"] -ms.assetid: bf38255c-fcbe-450c-95b2-3c5e35f86c37 --- # CEditView Class @@ -427,7 +426,7 @@ Width of each tab stop, in dialog units. ### Remarks -Only a single tab-stop width is supported. ( `CEdit` objects support multiple tab widths.) Widths are in dialog units, which equal one-fourth of the average character width (based on uppercase and lowercase alphabetic characters only) of the font used at the time of printing or displaying. You should not use `CEdit::SetTabStops` because `CEditView` must cache the tab-stop value. +Only a single tab-stop width is supported. (`CEdit` objects support multiple tab widths.) Widths are in dialog units, which equal one-fourth of the average character width (based on uppercase and lowercase alphabetic characters only) of the font used at the time of printing or displaying. You should not use `CEdit::SetTabStops` because `CEditView` must cache the tab-stop value. This function modifies only the tabs of the object for which it is called. To change the tab stops for each `CEditView` object in your application, call each object's `SetTabStops` function. diff --git a/docs/mfc/reference/cfile-class.md b/docs/mfc/reference/cfile-class.md index 85224ecfbdc..1621e327467 100644 --- a/docs/mfc/reference/cfile-class.md +++ b/docs/mfc/reference/cfile-class.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: CFile Class" title: "CFile Class" -ms.date: "06/12/2018" +description: "Learn more about: CFile Class" +ms.date: 06/12/2018 f1_keywords: ["CFile", "AFX/CFile", "AFX/CFile::CFile", "AFX/CFile::Abort", "AFX/CFile::Close", "AFX/CFile::Duplicate", "AFX/CFile::Flush", "AFX/CFile::GetFileName", "AFX/CFile::GetFilePath", "AFX/CFile::GetFileTitle", "AFX/CFile::GetLength", "AFX/CFile::GetPosition", "AFX/CFile::GetStatus", "AFX/CFile::LockRange", "AFX/CFile::Open", "AFX/CFile::Read", "AFX/CFile::Remove", "AFX/CFile::Rename", "AFX/CFile::Seek", "AFX/CFile::SeekToBegin", "AFX/CFile::SeekToEnd", "AFX/CFile::SetFilePath", "AFX/CFile::SetLength", "AFX/CFile::SetStatus", "AFX/CFile::UnlockRange", "AFX/CFile::Write", "AFX/CFile::hFileNull", "AFX/CFile::m_hFile", "AFX/CFile::m_pTM"] helpviewer_keywords: ["CFile [MFC], CFile", "CFile [MFC], Abort", "CFile [MFC], Close", "CFile [MFC], Duplicate", "CFile [MFC], Flush", "CFile [MFC], GetFileName", "CFile [MFC], GetFilePath", "CFile [MFC], GetFileTitle", "CFile [MFC], GetLength", "CFile [MFC], GetPosition", "CFile [MFC], GetStatus", "CFile [MFC], LockRange", "CFile [MFC], Open", "CFile [MFC], Read", "CFile [MFC], Remove", "CFile [MFC], Rename", "CFile [MFC], Seek", "CFile [MFC], SeekToBegin", "CFile [MFC], SeekToEnd", "CFile [MFC], SetFilePath", "CFile [MFC], SetLength", "CFile [MFC], SetStatus", "CFile [MFC], UnlockRange", "CFile [MFC], Write", "CFile [MFC], hFileNull", "CFile [MFC], m_hFile", "CFile [MFC], m_pTM"] -ms.assetid: b2eb5757-d499-4e67-b044-dd7d1abaa0f8 --- # CFile Class @@ -277,7 +276,7 @@ The name of the file. For example, when you call `GetFileName` to generate a message to the user about the file `c:\windows\write\myfile.wri`, the filename, `myfile.wri`, is returned. -To return the entire path of the file, including the name, call [GetFilePath](#getfilepath). To return the title of the file ( `myfile`), call [GetFileTitle](#getfiletitle). +To return the entire path of the file, including the name, call [GetFilePath](#getfilepath). To return the title of the file (`myfile`), call [GetFileTitle](#getfiletitle). ### Example diff --git a/docs/mfc/reference/cfindreplacedialog-class.md b/docs/mfc/reference/cfindreplacedialog-class.md index e2354f49f94..e24c9f2471d 100644 --- a/docs/mfc/reference/cfindreplacedialog-class.md +++ b/docs/mfc/reference/cfindreplacedialog-class.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: CFindReplaceDialog Class" title: "CFindReplaceDialog Class" -ms.date: "11/04/2016" +description: "Learn more about: CFindReplaceDialog Class" +ms.date: 11/04/2016 f1_keywords: ["CFindReplaceDialog", "AFXDLGS/CFindReplaceDialog", "AFXDLGS/CFindReplaceDialog::CFindReplaceDialog", "AFXDLGS/CFindReplaceDialog::Create", "AFXDLGS/CFindReplaceDialog::FindNext", "AFXDLGS/CFindReplaceDialog::GetFindString", "AFXDLGS/CFindReplaceDialog::GetNotifier", "AFXDLGS/CFindReplaceDialog::GetReplaceString", "AFXDLGS/CFindReplaceDialog::IsTerminating", "AFXDLGS/CFindReplaceDialog::MatchCase", "AFXDLGS/CFindReplaceDialog::MatchWholeWord", "AFXDLGS/CFindReplaceDialog::ReplaceAll", "AFXDLGS/CFindReplaceDialog::ReplaceCurrent", "AFXDLGS/CFindReplaceDialog::SearchDown", "AFXDLGS/CFindReplaceDialog::m_fr"] helpviewer_keywords: ["CFindReplaceDialog [MFC], CFindReplaceDialog", "CFindReplaceDialog [MFC], Create", "CFindReplaceDialog [MFC], FindNext", "CFindReplaceDialog [MFC], GetFindString", "CFindReplaceDialog [MFC], GetNotifier", "CFindReplaceDialog [MFC], GetReplaceString", "CFindReplaceDialog [MFC], IsTerminating", "CFindReplaceDialog [MFC], MatchCase", "CFindReplaceDialog [MFC], MatchWholeWord", "CFindReplaceDialog [MFC], ReplaceAll", "CFindReplaceDialog [MFC], ReplaceCurrent", "CFindReplaceDialog [MFC], SearchDown", "CFindReplaceDialog [MFC], m_fr"] -ms.assetid: 610f0b5d-b398-4ef6-8c05-e9d6641e50a8 --- # CFindReplaceDialog Class @@ -142,7 +141,7 @@ Nonzero if the dialog box object was successfully created; otherwise 0. ### Remarks -In order for the parent window to be notified of find/replace requests, you must use the Windows [RegisterWindowMessage](/windows/win32/api/winuser/nf-winuser-registerwindowmessagew) function whose return value is a message number unique to the application's instance. Your frame window should have a message map entry that declares the callback function ( `OnFindReplace` in the example that follows) that handles this registered message. The following code fragment is an example of how to do this for a frame window class named `CMyRichEditView`: +In order for the parent window to be notified of find/replace requests, you must use the Windows [RegisterWindowMessage](/windows/win32/api/winuser/nf-winuser-registerwindowmessagew) function whose return value is a message number unique to the application's instance. Your frame window should have a message map entry that declares the callback function (`OnFindReplace` in the example that follows) that handles this registered message. The following code fragment is an example of how to do this for a frame window class named `CMyRichEditView`: [!code-cpp[NVC_MFCDocView#171](../../mfc/codesnippet/cpp/cfindreplacedialog-class_2.h)]   diff --git a/docs/mfc/reference/cfont-class.md b/docs/mfc/reference/cfont-class.md index 768ca7bd6af..6a91e72bb95 100644 --- a/docs/mfc/reference/cfont-class.md +++ b/docs/mfc/reference/cfont-class.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: CFont Class" title: "CFont Class" -ms.date: "11/04/2016" +description: "Learn more about: CFont Class" +ms.date: 11/04/2016 f1_keywords: ["CFont", "AFXWIN/CFont", "AFXWIN/CFont::CFont", "AFXWIN/CFont::CreateFont", "AFXWIN/CFont::CreateFontIndirect", "AFXWIN/CFont::CreatePointFont", "AFXWIN/CFont::CreatePointFontIndirect", "AFXWIN/CFont::FromHandle", "AFXWIN/CFont::GetLogFont"] helpviewer_keywords: ["CFont [MFC], CFont", "CFont [MFC], CreateFont", "CFont [MFC], CreateFontIndirect", "CFont [MFC], CreatePointFont", "CFont [MFC], CreatePointFontIndirect", "CFont [MFC], FromHandle", "CFont [MFC], GetLogFont"] -ms.assetid: 3fad6bfe-d6ce-4ab9-967a-5ce0aa102800 --- # `CFont` Class @@ -102,7 +101,7 @@ BOOL CreateFont( ### Parameters *`nHeight`*
-Specifies the desired height (in logical units) of the font. See the `lfHeight` member of the [`LOGFONT`](/windows/win32/api/wingdi/ns-wingdi-logfontw)structure in the Windows SDK for a description. The absolute value of *`nHeight`* must not exceed 16,384 device units after it is converted. For all height comparisons, the font mapper looks for the largest font that does not exceed the requested size or the smallest font if all the fonts exceed the requested size. +Specifies the desired height (in logical units) of the font. See the `lfHeight` member of the [`LOGFONT`](/windows/win32/api/wingdi/ns-wingdi-logfontw) structure in the Windows SDK for a description. The absolute value of *`nHeight`* must not exceed 16,384 device units after it is converted. For all height comparisons, the font mapper looks for the largest font that does not exceed the requested size or the smallest font if all the fonts exceed the requested size. *`nWidth`*
Specifies the average width (in logical units) of characters in the font. If *`nWidth`* is 0, the aspect ratio of the device will be matched against the digitization aspect ratio of the available fonts to find the closest match, which is determined by the absolute value of the difference. @@ -142,7 +141,7 @@ Specifies the desired clipping precision. The clipping precision defines how to To use an embedded read-only font, an application must specify `CLIP_ENCAPSULATE`. -To achieve consistent rotation of device, TrueType, and vector fonts, an application can use the bitwise OR operator (`|`) to combine the `CLIP_LH_ANGLES` value with any of the other *`nClipPrecision`* values. If the `CLIP_LH_ANGLES` bit is set, the rotation for all fonts depends on whether the orientation of the coordinate system is left-handed or right-handed. (For more information about the orientation of coordinate systems, see the description of the *`nOrientation`* parameter.) If `CLIP_LH_ANGLES` is not set, device fonts always rotate counterclockwise, but the rotation of other fonts is dependent on the orientation of the coordinate system. +To achieve consistent rotation of device, TrueType, and vector fonts, an application can use the bitwise OR operator (`|`) to combine the `CLIP_LH_ANGLES` value with any of the other *`nClipPrecision`* values. If the `CLIP_LH_ANGLES` bit is set, the rotation for all fonts depends on whether the orientation of the coordinate system is left-handed or right-handed. For more information about the orientation of coordinate systems, see the description of the *`nOrientation`* parameter. If `CLIP_LH_ANGLES` is not set, device fonts always rotate counterclockwise, but the rotation of other fonts is dependent on the orientation of the coordinate system. *`nQuality`*
Specifies the font's output quality, which defines how carefully the GDI must attempt to match the logical-font attributes to those of an actual physical font. See the `lfQuality` member in the `LOGFONT` structure in the Windows SDK for a list of values. @@ -173,7 +172,7 @@ When you finish with the `CFont` object created by the `CreateFont` function, us ## `CFont::CreateFontIndirect` -Initializes a `CFont` object with the characteristics given in a [`LOGFONT`](/windows/win32/api/wingdi/ns-wingdi-logfontw)structure. +Initializes a `CFont` object with the characteristics given in a [`LOGFONT`](/windows/win32/api/wingdi/ns-wingdi-logfontw) structure. ``` BOOL CreateFontIndirect(const LOGFONT* lpLogFont); diff --git a/docs/mfc/reference/cformview-class.md b/docs/mfc/reference/cformview-class.md index 2166ba0f16c..cb84a87b8d5 100644 --- a/docs/mfc/reference/cformview-class.md +++ b/docs/mfc/reference/cformview-class.md @@ -35,7 +35,7 @@ A form view is essentially a view that contains controls. These controls are lai When you're [Creating a Forms-Based Application](../../mfc/reference/creating-a-forms-based-mfc-application.md), you can base its view class on `CFormView`, making it a forms-based application. -You can also insert new [Form Topics](../../mfc/form-views-mfc.md) into document-view-based applications. Even if your application didn't initially support forms, Visual C++ will add this support when you insert a new form. +You can also insert new [Form Topics](../../mfc/form-views-mfc.md) into document-view-based applications. Even if your application didn't initially support forms, Visual Studio will add this support when you insert a new form. The MFC Application Wizard and the Add Class command are the preferred methods for creating forms-based applications. If you need to create a forms-based application without using these methods, see [Creating a Forms-Based Application](../../mfc/reference/creating-a-forms-based-mfc-application.md). diff --git a/docs/mfc/reference/cframewnd-class.md b/docs/mfc/reference/cframewnd-class.md index 969f96a322e..670db48714c 100644 --- a/docs/mfc/reference/cframewnd-class.md +++ b/docs/mfc/reference/cframewnd-class.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: CFrameWnd Class" title: "CFrameWnd Class" -ms.date: "11/04/2016" +description: "Learn more about: CFrameWnd Class" +ms.date: 11/04/2016 f1_keywords: ["CFrameWnd", "AFXWIN/CFrameWnd", "AFXWIN/CFrameWnd::CFrameWnd", "AFXWIN/CFrameWnd::ActivateFrame", "AFXWIN/CFrameWnd::BeginModalState", "AFXWIN/CFrameWnd::Create", "AFXWIN/CFrameWnd::CreateView", "AFXWIN/CFrameWnd::DockControlBar", "AFXWIN/CFrameWnd::EnableDocking", "AFXWIN/CFrameWnd::EndModalState", "AFXWIN/CFrameWnd::FloatControlBar", "AFXWIN/CFrameWnd::GetActiveDocument", "AFXWIN/CFrameWnd::GetActiveFrame", "AFXWIN/CFrameWnd::GetActiveView", "AFXWIN/CFrameWnd::GetControlBar", "AFXWIN/CFrameWnd::GetDockState", "AFXWIN/CFrameWnd::GetMenuBarState", "AFXWIN/CFrameWnd::GetMenuBarVisibility", "AFXWIN/CFrameWnd::GetMessageBar", "AFXWIN/CFrameWnd::GetMessageString", "AFXWIN/CFrameWnd::GetTitle", "AFXWIN/CFrameWnd::InitialUpdateFrame", "AFXWIN/CFrameWnd::InModalState", "AFXWIN/CFrameWnd::IsTracking", "AFXWIN/CFrameWnd::LoadAccelTable", "AFXWIN/CFrameWnd::LoadBarState", "AFXWIN/CFrameWnd::LoadFrame", "AFXWIN/CFrameWnd::NegotiateBorderSpace", "AFXWIN/CFrameWnd::OnBarCheck", "AFXWIN/CFrameWnd::OnContextHelp", "AFXWIN/CFrameWnd::OnSetPreviewMode", "AFXWIN/CFrameWnd::OnUpdateControlBarMenu", "AFXWIN/CFrameWnd::RecalcLayout", "AFXWIN/CFrameWnd::SaveBarState", "AFXWIN/CFrameWnd::SetActivePreviewView", "AFXWIN/CFrameWnd::SetActiveView", "AFXWIN/CFrameWnd::SetDockState", "AFXWIN/CFrameWnd::SetMenuBarState", "AFXWIN/CFrameWnd::SetMenuBarVisibility", "AFXWIN/CFrameWnd::SetMessageText", "AFXWIN/CFrameWnd::SetProgressBarPosition", "AFXWIN/CFrameWnd::SetProgressBarRange", "AFXWIN/CFrameWnd::SetProgressBarState", "AFXWIN/CFrameWnd::SetTaskbarOverlayIcon", "AFXWIN/CFrameWnd::SetTitle", "AFXWIN/CFrameWnd::ShowControlBar", "AFXWIN/CFrameWnd::ShowOwnedWindows", "AFXWIN/CFrameWnd::OnCreateClient", "AFXWIN/CFrameWnd::OnHideMenuBar", "AFXWIN/CFrameWnd::OnShowMenuBar", "AFXWIN/CFrameWnd::m_bAutoMenuEnable", "AFXWIN/CFrameWnd::rectDefault"] helpviewer_keywords: ["CFrameWnd [MFC], CFrameWnd", "CFrameWnd [MFC], ActivateFrame", "CFrameWnd [MFC], BeginModalState", "CFrameWnd [MFC], Create", "CFrameWnd [MFC], CreateView", "CFrameWnd [MFC], DockControlBar", "CFrameWnd [MFC], EnableDocking", "CFrameWnd [MFC], EndModalState", "CFrameWnd [MFC], FloatControlBar", "CFrameWnd [MFC], GetActiveDocument", "CFrameWnd [MFC], GetActiveFrame", "CFrameWnd [MFC], GetActiveView", "CFrameWnd [MFC], GetControlBar", "CFrameWnd [MFC], GetDockState", "CFrameWnd [MFC], GetMenuBarState", "CFrameWnd [MFC], GetMenuBarVisibility", "CFrameWnd [MFC], GetMessageBar", "CFrameWnd [MFC], GetMessageString", "CFrameWnd [MFC], GetTitle", "CFrameWnd [MFC], InitialUpdateFrame", "CFrameWnd [MFC], InModalState", "CFrameWnd [MFC], IsTracking", "CFrameWnd [MFC], LoadAccelTable", "CFrameWnd [MFC], LoadBarState", "CFrameWnd [MFC], LoadFrame", "CFrameWnd [MFC], NegotiateBorderSpace", "CFrameWnd [MFC], OnBarCheck", "CFrameWnd [MFC], OnContextHelp", "CFrameWnd [MFC], OnSetPreviewMode", "CFrameWnd [MFC], OnUpdateControlBarMenu", "CFrameWnd [MFC], RecalcLayout", "CFrameWnd [MFC], SaveBarState", "CFrameWnd [MFC], SetActivePreviewView", "CFrameWnd [MFC], SetActiveView", "CFrameWnd [MFC], SetDockState", "CFrameWnd [MFC], SetMenuBarState", "CFrameWnd [MFC], SetMenuBarVisibility", "CFrameWnd [MFC], SetMessageText", "CFrameWnd [MFC], SetProgressBarPosition", "CFrameWnd [MFC], SetProgressBarRange", "CFrameWnd [MFC], SetProgressBarState", "CFrameWnd [MFC], SetTaskbarOverlayIcon", "CFrameWnd [MFC], SetTitle", "CFrameWnd [MFC], ShowControlBar", "CFrameWnd [MFC], ShowOwnedWindows", "CFrameWnd [MFC], OnCreateClient", "CFrameWnd [MFC], OnHideMenuBar", "CFrameWnd [MFC], OnShowMenuBar", "CFrameWnd [MFC], m_bAutoMenuEnable", "CFrameWnd [MFC], rectDefault"] -ms.assetid: e2220aba-5bf4-4002-b960-fbcafcad01f1 --- # `CFrameWnd` Class @@ -420,7 +419,7 @@ If there is no active MDI child or the application is a single document interfac ## `CFrameWnd::GetActiveView` -Call this member function to obtain a pointer to the active view (if any) attached to a frame window ( `CFrameWnd`). +Call this member function to obtain a pointer to the active view (if any) attached to a frame window (`CFrameWnd`). ``` CView* GetActiveView() const; @@ -432,7 +431,7 @@ A pointer to the current [`CView`](../../mfc/reference/cview-class.md). If there ### Remarks -This function returns `NULL` when called for an MDI main frame window ( `CMDIFrameWnd`). In an MDI application, the MDI main frame window does not have a view associated with it. Instead, each individual child window ( `CMDIChildWnd`) has one or more associated views. The active view in an MDI application can be obtained by first finding the active MDI child window and then finding the active view for that child window. The active MDI child window can be found by calling the function `MDIGetActive` or `GetActiveFrame` as demonstrated in the following: +This function returns `NULL` when called for an MDI main frame window (`CMDIFrameWnd`). In an MDI application, the MDI main frame window does not have a view associated with it. Instead, each individual child window (`CMDIChildWnd`) has one or more associated views. The active view in an MDI application can be obtained by first finding the active MDI child window and then finding the active view for that child window. The active MDI child window can be found by calling the function `MDIGetActive` or `GetActiveFrame` as demonstrated in the following: [!code-cpp[NVC_MFCWindowing#2](../../mfc/reference/codesnippet/cpp/cframewnd-class_2.cpp)] @@ -512,7 +511,7 @@ This method returns one of the following values: - `AFX_MBV_DISPLAYONFOCUS` (0x02) - The menu is hidden by default. If the menu is hidden, press the ALT key to display the menu and give it the focus. If the menu is displayed, press the ALT or ESC key to hide it. -- `AFX_MBV_ DISPLAYONFOCUS | AFX_MBV_DISPLAYONF10` (0x06) - The menu is hidden by default. If the menu is hidden, press the F10 key to display the menu and give it the focus. If the menu is displayed, press the F10 key to toggle the focus on or off the menu. The menu is displayed until you press the ALT or ESC key to hide it. +- `AFX_MBV_DISPLAYONFOCUS | AFX_MBV_DISPLAYONF10` (0x06) - The menu is hidden by default. If the menu is hidden, press the F10 key to display the menu and give it the focus. If the menu is displayed, press the F10 key to toggle the focus on or off the menu. The menu is displayed until you press the ALT or ESC key to hide it. ### Remarks diff --git a/docs/mfc/reference/cgopherconnection-class.md b/docs/mfc/reference/cgopherconnection-class.md index 585855bbfe9..d05ead9a3a2 100644 --- a/docs/mfc/reference/cgopherconnection-class.md +++ b/docs/mfc/reference/cgopherconnection-class.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: CGopherConnection Class" title: "CGopherConnection Class" +description: "Learn more about: CGopherConnection Class" ms.date: "11/04/2016" f1_keywords: ["CGopherConnection", "AFXINET/CGopherConnection", "AFXINET/CGopherConnection::CGopherConnection", "AFXINET/CGopherConnection::CreateLocator", "AFXINET/CGopherConnection::GetAttribute", "AFXINET/CGopherConnection::OpenFile"] helpviewer_keywords: ["CGopherConnection [MFC], CGopherConnection", "CGopherConnection [MFC], CreateLocator", "CGopherConnection [MFC], GetAttribute", "CGopherConnection [MFC], OpenFile"] -ms.assetid: b5b96aea-ac99-430e-bd84-d1372b43f78f --- # CGopherConnection Class @@ -167,8 +166,9 @@ Call this member function to retrieve specific attribute information about an it ``` BOOL GetAttribute( - CGopherLocator& refLocator CString strRequestedAttributes, - CString& strResult,); + CGopherLocator& refLocator, + CString strRequestedAttributes, + CString& strResult); ``` ### Parameters @@ -222,11 +222,11 @@ Override the *dwContext* default to set the context identifier to a value of you ## See also -[CInternetConnection Class](../../mfc/reference/cinternetconnection-class.md)
-[Hierarchy Chart](../../mfc/hierarchy-chart.md)
-[CFtpConnection Class](../../mfc/reference/cftpconnection-class.md)
-[CHttpConnection Class](../../mfc/reference/chttpconnection-class.md)
-[CInternetConnection Class](../../mfc/reference/cinternetconnection-class.md)
-[CGopherLocator Class](../../mfc/reference/cgopherlocator-class.md)
-[CGopherFile Class](../../mfc/reference/cgopherfile-class.md)
+[CInternetConnection Class](../../mfc/reference/cinternetconnection-class.md)\ +[Hierarchy Chart](../../mfc/hierarchy-chart.md)\ +[CFtpConnection Class](../../mfc/reference/cftpconnection-class.md)\ +[CHttpConnection Class](../../mfc/reference/chttpconnection-class.md)\ +[CInternetConnection Class](../../mfc/reference/cinternetconnection-class.md)\ +[CGopherLocator Class](../../mfc/reference/cgopherlocator-class.md)\ +[CGopherFile Class](../../mfc/reference/cgopherfile-class.md)\ [CInternetSession Class](../../mfc/reference/cinternetsession-class.md) diff --git a/docs/mfc/reference/cimagelist-class.md b/docs/mfc/reference/cimagelist-class.md index 184a95db737..ca80bcc33ee 100644 --- a/docs/mfc/reference/cimagelist-class.md +++ b/docs/mfc/reference/cimagelist-class.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: CImageList Class" title: "CImageList Class" -ms.date: "11/04/2016" +description: "Learn more about: CImageList Class" +ms.date: 11/04/2016 f1_keywords: ["CImageList", "AFXCMN/CImageList", "AFXCMN/CImageList::CImageList", "AFXCMN/CImageList::Add", "AFXCMN/CImageList::Attach", "AFXCMN/CImageList::BeginDrag", "AFXCMN/CImageList::Copy", "AFXCMN/CImageList::Create", "AFXCMN/CImageList::DeleteImageList", "AFXCMN/CImageList::DeleteTempMap", "AFXCMN/CImageList::Detach", "AFXCMN/CImageList::DragEnter", "AFXCMN/CImageList::DragLeave", "AFXCMN/CImageList::DragMove", "AFXCMN/CImageList::DragShowNolock", "AFXCMN/CImageList::Draw", "AFXCMN/CImageList::DrawEx", "AFXCMN/CImageList::DrawIndirect", "AFXCMN/CImageList::EndDrag", "AFXCMN/CImageList::ExtractIcon", "AFXCMN/CImageList::FromHandle", "AFXCMN/CImageList::FromHandlePermanent", "AFXCMN/CImageList::GetBkColor", "AFXCMN/CImageList::GetDragImage", "AFXCMN/CImageList::GetImageCount", "AFXCMN/CImageList::GetImageInfo", "AFXCMN/CImageList::GetSafeHandle", "AFXCMN/CImageList::Read", "AFXCMN/CImageList::Remove", "AFXCMN/CImageList::Replace", "AFXCMN/CImageList::SetBkColor", "AFXCMN/CImageList::SetDragCursorImage", "AFXCMN/CImageList::SetImageCount", "AFXCMN/CImageList::SetOverlayImage", "AFXCMN/CImageList::Write", "AFXCMN/CImageList::m_hImageList"] helpviewer_keywords: ["CImageList [MFC], CImageList", "CImageList [MFC], Add", "CImageList [MFC], Attach", "CImageList [MFC], BeginDrag", "CImageList [MFC], Copy", "CImageList [MFC], Create", "CImageList [MFC], DeleteImageList", "CImageList [MFC], DeleteTempMap", "CImageList [MFC], Detach", "CImageList [MFC], DragEnter", "CImageList [MFC], DragLeave", "CImageList [MFC], DragMove", "CImageList [MFC], DragShowNolock", "CImageList [MFC], Draw", "CImageList [MFC], DrawEx", "CImageList [MFC], DrawIndirect", "CImageList [MFC], EndDrag", "CImageList [MFC], ExtractIcon", "CImageList [MFC], FromHandle", "CImageList [MFC], FromHandlePermanent", "CImageList [MFC], GetBkColor", "CImageList [MFC], GetDragImage", "CImageList [MFC], GetImageCount", "CImageList [MFC], GetImageInfo", "CImageList [MFC], GetSafeHandle", "CImageList [MFC], Read", "CImageList [MFC], Remove", "CImageList [MFC], Replace", "CImageList [MFC], SetBkColor", "CImageList [MFC], SetDragCursorImage", "CImageList [MFC], SetImageCount", "CImageList [MFC], SetOverlayImage", "CImageList [MFC], Write", "CImageList [MFC], m_hImageList"] -ms.assetid: b6d1a704-1c82-4548-8a8f-77972adc98a5 --- # `CImageList` Class @@ -359,7 +358,7 @@ Nonzero if successful; otherwise 0. ## `CImageList::DeleteTempMap` -Called automatically by the `CWinApp` idle-time handler, `DeleteTempMap` deletes any temporary `CImageList` objects created by [FromHandle](#fromhandle), but does not destroy any handles ( `hImageList`) temporarily associated with the `ImageList` objects. +Called automatically by the `CWinApp` idle-time handler, `DeleteTempMap` deletes any temporary `CImageList` objects created by [FromHandle](#fromhandle), but does not destroy any handles (`hImageList`) temporarily associated with the `ImageList` objects. ``` static void PASCAL DeleteTempMap(); diff --git a/docs/mfc/reference/cinternetexception-class.md b/docs/mfc/reference/cinternetexception-class.md index 9d9ccae4624..0af84f73031 100644 --- a/docs/mfc/reference/cinternetexception-class.md +++ b/docs/mfc/reference/cinternetexception-class.md @@ -90,7 +90,7 @@ DWORD m_dwError; This error value may be a system error code, found in WINERROR.H, or an error value from WININET.H. -For a list of Win32 error codes, see [Error Codes](/windows/win32/Debug/system-error-codes). For a list of Internet-specific error messages, see . Both topics are in the Windows SDK. +For a list of Win32 error codes, see [Error Codes](/windows/win32/Debug/system-error-codes). ## See also diff --git a/docs/mfc/reference/clistbox-class.md b/docs/mfc/reference/clistbox-class.md index 93f4efc5532..ffdca49e04e 100644 --- a/docs/mfc/reference/clistbox-class.md +++ b/docs/mfc/reference/clistbox-class.md @@ -873,10 +873,10 @@ int InitStorage( ### Parameters *`nItems`*
-Specifies the number of items to add. +Specifies the number of items to for which to reserve space. *`nBytes`*
-Specifies the amount of memory, in bytes, to allocate for item strings. +Specifies the amount of additional memory, in bytes, to allocate for item strings. ### Return Value @@ -884,9 +884,11 @@ If successful, the maximum number of items that the list box can store before a ### Remarks -Call this function before adding a large number of items to a `CListBox`. +You can call this function before adding a large number of items to a `CListBox`. -This function helps speed up the initialization of list boxes that have a large number of items (more than 100). It preallocates the specified amount of memory so that subsequent [`AddString`](#addstring), [`InsertString`](#insertstring), and [`Dir`](#dir) functions take the shortest possible time. You can use estimates for the parameters. If you overestimate, some extra memory is allocated; if you underestimate, the normal allocation is used for items that exceed the preallocated amount. +This function helps speed up the initialization of list boxes that have a large number of items (more than 100). It preallocates the specified amount of memory so that subsequent [`AddString`](#addstring), [`InsertString`](#insertstring), and [`Dir`](#dir) functions are more efficient. You can use estimates for the parameters. If you overestimate, the extra memory remains allocated; if you underestimate, the list box will allocate additional memory as necessary. + +The memory required to store a string includes the null terminator. Therefore, if you plan to add 100 strings, each with a length of 10 characters, you would pass a *wParam* of 100 and an *lParam* of 100 × (10 + 1) × sizeof(TCHAR). Windows 95/98 only: The *`nItems`* parameter is limited to 16-bit values. This means list boxes cannot contain more than 32,767 items. Although the number of items is restricted, the total size of the items in a list box is limited only by available memory. diff --git a/docs/mfc/reference/clistctrl-class.md b/docs/mfc/reference/clistctrl-class.md index 8ddf3770801..a9e92a75d11 100644 --- a/docs/mfc/reference/clistctrl-class.md +++ b/docs/mfc/reference/clistctrl-class.md @@ -1,6 +1,6 @@ --- -description: "Learn more about: CListCtrl Class" title: "CListCtrl Class" +description: "Learn more about: CListCtrl Class" ms.date: 06/29/2022 f1_keywords: ["CListCtrl", "AFXCMN/CListCtrl", "AFXCMN/CListCtrl::CListCtrl", "AFXCMN/CListCtrl::ApproximateViewRect", "AFXCMN/CListCtrl::Arrange", "AFXCMN/CListCtrl::CancelEditLabel", "AFXCMN/CListCtrl::Create", "AFXCMN/CListCtrl::CreateDragImage", "AFXCMN/CListCtrl::CreateEx", "AFXCMN/CListCtrl::DeleteAllItems", "AFXCMN/CListCtrl::DeleteColumn", "AFXCMN/CListCtrl::DeleteItem", "AFXCMN/CListCtrl::DrawItem", "AFXCMN/CListCtrl::EditLabel", "AFXCMN/CListCtrl::EnableGroupView", "AFXCMN/CListCtrl::EnsureVisible", "AFXCMN/CListCtrl::FindItem", "AFXCMN/CListCtrl::GetBkColor", "AFXCMN/CListCtrl::GetBkImage", "AFXCMN/CListCtrl::GetCallbackMask", "AFXCMN/CListCtrl::GetCheck", "AFXCMN/CListCtrl::GetColumn", "AFXCMN/CListCtrl::GetColumnOrderArray", "AFXCMN/CListCtrl::GetColumnWidth", "AFXCMN/CListCtrl::GetCountPerPage", "AFXCMN/CListCtrl::GetEditControl", "AFXCMN/CListCtrl::GetEmptyText", "AFXCMN/CListCtrl::GetExtendedStyle", "AFXCMN/CListCtrl::GetFirstSelectedItemPosition", "AFXCMN/CListCtrl::GetFocusedGroup", "AFXCMN/CListCtrl::GetGroupCount", "AFXCMN/CListCtrl::GetGroupInfo", "AFXCMN/CListCtrl::GetGroupInfoByIndex", "AFXCMN/CListCtrl::GetGroupMetrics", "AFXCMN/CListCtrl::GetGroupRect", "AFXCMN/CListCtrl::GetGroupState", "AFXCMN/CListCtrl::GetHeaderCtrl", "AFXCMN/CListCtrl::GetHotCursor", "AFXCMN/CListCtrl::GetHotItem", "AFXCMN/CListCtrl::GetHoverTime", "AFXCMN/CListCtrl::GetImageList", "AFXCMN/CListCtrl::GetInsertMark", "AFXCMN/CListCtrl::GetInsertMarkColor", "AFXCMN/CListCtrl::GetInsertMarkRect", "AFXCMN/CListCtrl::GetItem", "AFXCMN/CListCtrl::GetItemCount", "AFXCMN/CListCtrl::GetItemData", "AFXCMN/CListCtrl::GetItemIndexRect", "AFXCMN/CListCtrl::GetItemPosition", "AFXCMN/CListCtrl::GetItemRect", "AFXCMN/CListCtrl::GetItemSpacing", "AFXCMN/CListCtrl::GetItemState", "AFXCMN/CListCtrl::GetItemText", "AFXCMN/CListCtrl::GetNextItem", "AFXCMN/CListCtrl::GetNextItemIndex", "AFXCMN/CListCtrl::GetNextSelectedItem", "AFXCMN/CListCtrl::GetNumberOfWorkAreas", "AFXCMN/CListCtrl::GetOrigin", "AFXCMN/CListCtrl::GetOutlineColor", "AFXCMN/CListCtrl::GetSelectedColumn", "AFXCMN/CListCtrl::GetSelectedCount", "AFXCMN/CListCtrl::GetSelectionMark", "AFXCMN/CListCtrl::GetStringWidth", "AFXCMN/CListCtrl::GetSubItemRect", "AFXCMN/CListCtrl::GetTextBkColor", "AFXCMN/CListCtrl::GetTextColor", "AFXCMN/CListCtrl::GetTileInfo", "AFXCMN/CListCtrl::GetTileViewInfo", "AFXCMN/CListCtrl::GetToolTips", "AFXCMN/CListCtrl::GetTopIndex", "AFXCMN/CListCtrl::GetView", "AFXCMN/CListCtrl::GetViewRect", "AFXCMN/CListCtrl::GetWorkAreas", "AFXCMN/CListCtrl::HasGroup", "AFXCMN/CListCtrl::HitTest", "AFXCMN/CListCtrl::InsertColumn", "AFXCMN/CListCtrl::InsertGroup", "AFXCMN/CListCtrl::InsertGroupSorted", "AFXCMN/CListCtrl::InsertItem", "AFXCMN/CListCtrl::InsertMarkHitTest", "AFXCMN/CListCtrl::IsGroupViewEnabled", "AFXCMN/CListCtrl::IsItemVisible", "AFXCMN/CListCtrl::MapIDToIndex", "AFXCMN/CListCtrl::MapIndexToID", "AFXCMN/CListCtrl::MoveGroup", "AFXCMN/CListCtrl::MoveItemToGroup", "AFXCMN/CListCtrl::RedrawItems", "AFXCMN/CListCtrl::RemoveAllGroups", "AFXCMN/CListCtrl::RemoveGroup", "AFXCMN/CListCtrl::Scroll", "AFXCMN/CListCtrl::SetBkColor", "AFXCMN/CListCtrl::SetBkImage", "AFXCMN/CListCtrl::SetCallbackMask", "AFXCMN/CListCtrl::SetCheck", "AFXCMN/CListCtrl::SetColumn", "AFXCMN/CListCtrl::SetColumnOrderArray", "AFXCMN/CListCtrl::SetColumnWidth", "AFXCMN/CListCtrl::SetExtendedStyle", "AFXCMN/CListCtrl::SetGroupInfo", "AFXCMN/CListCtrl::SetGroupMetrics", "AFXCMN/CListCtrl::SetHotCursor", "AFXCMN/CListCtrl::SetHotItem", "AFXCMN/CListCtrl::SetHoverTime", "AFXCMN/CListCtrl::SetIconSpacing", "AFXCMN/CListCtrl::SetImageList", "AFXCMN/CListCtrl::SetInfoTip", "AFXCMN/CListCtrl::SetInsertMark", "AFXCMN/CListCtrl::SetInsertMarkColor", "AFXCMN/CListCtrl::SetItem", "AFXCMN/CListCtrl::SetItemCount", "AFXCMN/CListCtrl::SetItemCountEx", "AFXCMN/CListCtrl::SetItemData", "AFXCMN/CListCtrl::SetItemIndexState", "AFXCMN/CListCtrl::SetItemPosition", "AFXCMN/CListCtrl::SetItemState", "AFXCMN/CListCtrl::SetItemText", "AFXCMN/CListCtrl::SetOutlineColor", "AFXCMN/CListCtrl::SetSelectedColumn", "AFXCMN/CListCtrl::SetSelectionMark", "AFXCMN/CListCtrl::SetTextBkColor", "AFXCMN/CListCtrl::SetTextColor", "AFXCMN/CListCtrl::SetTileInfo", "AFXCMN/CListCtrl::SetTileViewInfo", "AFXCMN/CListCtrl::SetToolTips", "AFXCMN/CListCtrl::SetView", "AFXCMN/CListCtrl::SetWorkAreas", "AFXCMN/CListCtrl::SortGroups", "AFXCMN/CListCtrl::SortItems", "AFXCMN/CListCtrl::SortItemsEx", "AFXCMN/CListCtrl::SubItemHitTest", "AFXCMN/CListCtrl::Update"] helpviewer_keywords: ["CListCtrl [MFC], CListCtrl", "CListCtrl [MFC], ApproximateViewRect", "CListCtrl [MFC], Arrange", "CListCtrl [MFC], CancelEditLabel", "CListCtrl [MFC], Create", "CListCtrl [MFC], CreateDragImage", "CListCtrl [MFC], CreateEx", "CListCtrl [MFC], DeleteAllItems", "CListCtrl [MFC], DeleteColumn", "CListCtrl [MFC], DeleteItem", "CListCtrl [MFC], DrawItem", "CListCtrl [MFC], EditLabel", "CListCtrl [MFC], EnableGroupView", "CListCtrl [MFC], EnsureVisible", "CListCtrl [MFC], FindItem", "CListCtrl [MFC], GetBkColor", "CListCtrl [MFC], GetBkImage", "CListCtrl [MFC], GetCallbackMask", "CListCtrl [MFC], GetCheck", "CListCtrl [MFC], GetColumn", "CListCtrl [MFC], GetColumnOrderArray", "CListCtrl [MFC], GetColumnWidth", "CListCtrl [MFC], GetCountPerPage", "CListCtrl [MFC], GetEditControl", "CListCtrl [MFC], GetEmptyText", "CListCtrl [MFC], GetExtendedStyle", "CListCtrl [MFC], GetFirstSelectedItemPosition", "CListCtrl [MFC], GetFocusedGroup", "CListCtrl [MFC], GetGroupCount", "CListCtrl [MFC], GetGroupInfo", "CListCtrl [MFC], GetGroupInfoByIndex", "CListCtrl [MFC], GetGroupMetrics", "CListCtrl [MFC], GetGroupRect", "CListCtrl [MFC], GetGroupState", "CListCtrl [MFC], GetHeaderCtrl", "CListCtrl [MFC], GetHotCursor", "CListCtrl [MFC], GetHotItem", "CListCtrl [MFC], GetHoverTime", "CListCtrl [MFC], GetImageList", "CListCtrl [MFC], GetInsertMark", "CListCtrl [MFC], GetInsertMarkColor", "CListCtrl [MFC], GetInsertMarkRect", "CListCtrl [MFC], GetItem", "CListCtrl [MFC], GetItemCount", "CListCtrl [MFC], GetItemData", "CListCtrl [MFC], GetItemIndexRect", "CListCtrl [MFC], GetItemPosition", "CListCtrl [MFC], GetItemRect", "CListCtrl [MFC], GetItemSpacing", "CListCtrl [MFC], GetItemState", "CListCtrl [MFC], GetItemText", "CListCtrl [MFC], GetNextItem", "CListCtrl [MFC], GetNextItemIndex", "CListCtrl [MFC], GetNextSelectedItem", "CListCtrl [MFC], GetNumberOfWorkAreas", "CListCtrl [MFC], GetOrigin", "CListCtrl [MFC], GetOutlineColor", "CListCtrl [MFC], GetSelectedColumn", "CListCtrl [MFC], GetSelectedCount", "CListCtrl [MFC], GetSelectionMark", "CListCtrl [MFC], GetStringWidth", "CListCtrl [MFC], GetSubItemRect", "CListCtrl [MFC], GetTextBkColor", "CListCtrl [MFC], GetTextColor", "CListCtrl [MFC], GetTileInfo", "CListCtrl [MFC], GetTileViewInfo", "CListCtrl [MFC], GetToolTips", "CListCtrl [MFC], GetTopIndex", "CListCtrl [MFC], GetView", "CListCtrl [MFC], GetViewRect", "CListCtrl [MFC], GetWorkAreas", "CListCtrl [MFC], HasGroup", "CListCtrl [MFC], HitTest", "CListCtrl [MFC], InsertColumn", "CListCtrl [MFC], InsertGroup", "CListCtrl [MFC], InsertGroupSorted", "CListCtrl [MFC], InsertItem", "CListCtrl [MFC], InsertMarkHitTest", "CListCtrl [MFC], IsGroupViewEnabled", "CListCtrl [MFC], IsItemVisible", "CListCtrl [MFC], MapIDToIndex", "CListCtrl [MFC], MapIndexToID", "CListCtrl [MFC], MoveGroup", "CListCtrl [MFC], MoveItemToGroup", "CListCtrl [MFC], RedrawItems", "CListCtrl [MFC], RemoveAllGroups", "CListCtrl [MFC], RemoveGroup", "CListCtrl [MFC], Scroll", "CListCtrl [MFC], SetBkColor", "CListCtrl [MFC], SetBkImage", "CListCtrl [MFC], SetCallbackMask", "CListCtrl [MFC], SetCheck", "CListCtrl [MFC], SetColumn", "CListCtrl [MFC], SetColumnOrderArray", "CListCtrl [MFC], SetColumnWidth", "CListCtrl [MFC], SetExtendedStyle", "CListCtrl [MFC], SetGroupInfo", "CListCtrl [MFC], SetGroupMetrics", "CListCtrl [MFC], SetHotCursor", "CListCtrl [MFC], SetHotItem", "CListCtrl [MFC], SetHoverTime", "CListCtrl [MFC], SetIconSpacing", "CListCtrl [MFC], SetImageList", "CListCtrl [MFC], SetInfoTip", "CListCtrl [MFC], SetInsertMark", "CListCtrl [MFC], SetInsertMarkColor", "CListCtrl [MFC], SetItem", "CListCtrl [MFC], SetItemCount", "CListCtrl [MFC], SetItemCountEx", "CListCtrl [MFC], SetItemData", "CListCtrl [MFC], SetItemIndexState", "CListCtrl [MFC], SetItemPosition", "CListCtrl [MFC], SetItemState", "CListCtrl [MFC], SetItemText", "CListCtrl [MFC], SetOutlineColor", "CListCtrl [MFC], SetSelectedColumn", "CListCtrl [MFC], SetSelectionMark", "CListCtrl [MFC], SetTextBkColor", "CListCtrl [MFC], SetTextColor", "CListCtrl [MFC], SetTileInfo", "CListCtrl [MFC], SetTileViewInfo", "CListCtrl [MFC], SetToolTips", "CListCtrl [MFC], SetView", "CListCtrl [MFC], SetWorkAreas", "CListCtrl [MFC], SortGroups", "CListCtrl [MFC], SortItems", "CListCtrl [MFC], SortItemsEx", "CListCtrl [MFC], SubItemHitTest", "CListCtrl [MFC], Update"] @@ -427,7 +427,7 @@ CImageList* CreateDragImage( ### Parameters -*`nItem*`\ +*`nItem`*\ Index of the item whose drag image list is to be created. *`lpPoint`*\ diff --git a/docs/mfc/reference/cmapstringtoob-class.md b/docs/mfc/reference/cmapstringtoob-class.md index f48bf10173a..7d7404e9956 100644 --- a/docs/mfc/reference/cmapstringtoob-class.md +++ b/docs/mfc/reference/cmapstringtoob-class.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: CMapStringToOb Class" title: "CMapStringToOb Class" -ms.date: "11/04/2016" +description: "Learn more about: CMapStringToOb Class" +ms.date: 11/04/2016 f1_keywords: ["CMapStringToOb", "AFXCOLL/CMapStringToOb", "AFXCOLL/CMapStringToOb::CMapStringToOb", "AFXCOLL/CMapStringToOb::GetCount", "AFXCOLL/CMapStringToOb::GetHashTableSize", "AFXCOLL/CMapStringToOb::GetNextAssoc", "AFXCOLL/CMapStringToOb::GetSize", "AFXCOLL/CMapStringToOb::GetStartPosition", "AFXCOLL/CMapStringToOb::HashKey", "AFXCOLL/CMapStringToOb::InitHashTable", "AFXCOLL/CMapStringToOb::IsEmpty", "AFXCOLL/CMapStringToOb::Lookup", "AFXCOLL/CMapStringToOb::LookupKey", "AFXCOLL/CMapStringToOb::RemoveAll", "AFXCOLL/CMapStringToOb::RemoveKey", "AFXCOLL/CMapStringToOb::SetAt"] helpviewer_keywords: ["CMapStringToOb [MFC], CMapStringToOb", "CMapStringToOb [MFC], GetCount", "CMapStringToOb [MFC], GetHashTableSize", "CMapStringToOb [MFC], GetNextAssoc", "CMapStringToOb [MFC], GetSize", "CMapStringToOb [MFC], GetStartPosition", "CMapStringToOb [MFC], HashKey", "CMapStringToOb [MFC], InitHashTable", "CMapStringToOb [MFC], IsEmpty", "CMapStringToOb [MFC], Lookup", "CMapStringToOb [MFC], LookupKey", "CMapStringToOb [MFC], RemoveAll", "CMapStringToOb [MFC], RemoveKey", "CMapStringToOb [MFC], SetAt"] --- @@ -399,7 +399,7 @@ Nonzero if the element was found; otherwise 0. ### Remarks -`Lookup` uses a hashing algorithm to quickly find the map element with a key that matches exactly ( `CString` value). +`Lookup` uses a hashing algorithm to quickly find the map element with a key that matches exactly (`CString` value). The following table shows other member functions that are similar to `CMapStringToOb::LookUp`. diff --git a/docs/mfc/reference/cmdichildwndex-class.md b/docs/mfc/reference/cmdichildwndex-class.md index 69dede74255..b1f2e320dd5 100644 --- a/docs/mfc/reference/cmdichildwndex-class.md +++ b/docs/mfc/reference/cmdichildwndex-class.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: CMDIChildWndEx Class" title: "CMDIChildWndEx Class" +description: "Learn more about: CMDIChildWndEx Class" ms.date: "10/18/2018" f1_keywords: ["CMDIChildWndEx", "AFXMDICHILDWNDEX/CMDIChildWndEx", "AFXMDICHILDWNDEX/CMDIChildWndEx::ActivateTopLevelFrame", "AFXMDICHILDWNDEX/CMDIChildWndEx::AddPane", "AFXMDICHILDWNDEX/CMDIChildWndEx::AddTabbedPane", "AFXMDICHILDWNDEX/CMDIChildWndEx::AdjustDockingLayout", "AFXMDICHILDWNDEX/CMDIChildWndEx::CanShowOnMDITabs", "AFXMDICHILDWNDEX/CMDIChildWndEx::CanShowOnTaskBarTabs", "AFXMDICHILDWNDEX/CMDIChildWndEx::CanShowOnWindowsList", "AFXMDICHILDWNDEX/CMDIChildWndEx::DockPane", "AFXMDICHILDWNDEX/CMDIChildWndEx::DockPaneLeftOf", "AFXMDICHILDWNDEX/CMDIChildWndEx::EnableAutoHidePanes", "AFXMDICHILDWNDEX/CMDIChildWndEx::EnableDocking", "AFXMDICHILDWNDEX/CMDIChildWndEx::EnableTaskbarThumbnailClipRect", "AFXMDICHILDWNDEX/CMDIChildWndEx::GetDockingManager", "AFXMDICHILDWNDEX/CMDIChildWndEx::GetDocumentName", "AFXMDICHILDWNDEX/CMDIChildWndEx::GetFrameIcon", "AFXMDICHILDWNDEX/CMDIChildWndEx::GetFrameText", "AFXMDICHILDWNDEX/CMDIChildWndEx::GetPane", "AFXMDICHILDWNDEX/CMDIChildWndEx::GetRelatedTabGroup", "AFXMDICHILDWNDEX/CMDIChildWndEx::GetTabbedPane", "AFXMDICHILDWNDEX/CMDIChildWndEx::GetTabProxyWnd", "AFXMDICHILDWNDEX/CMDIChildWndEx::GetTaskbarPreviewWnd", "AFXMDICHILDWNDEX/CMDIChildWndEx::GetTaskbarThumbnailClipRect", "AFXMDICHILDWNDEX/CMDIChildWndEx::GetToolbarButtonToolTipText", "AFXMDICHILDWNDEX/CMDIChildWndEx::InsertPane", "AFXMDICHILDWNDEX/CMDIChildWndEx::InvalidateIconicBitmaps", "AFXMDICHILDWNDEX/CMDIChildWndEx::IsPointNearDockSite", "AFXMDICHILDWNDEX/CMDIChildWndEx::IsReadOnly", "AFXMDICHILDWNDEX/CMDIChildWndEx::IsRegisteredWithTaskbarTabs", "AFXMDICHILDWNDEX/CMDIChildWndEx::IsTabbedPane", "AFXMDICHILDWNDEX/CMDIChildWndEx::IsTaskbarTabsSupportEnabled", "AFXMDICHILDWNDEX/CMDIChildWndEx::IsTaskbarThumbnailClipRectEnabled", "AFXMDICHILDWNDEX/CMDIChildWndEx::m_dwDefaultTaskbarTabPropertyFlags", "AFXMDICHILDWNDEX/CMDIChildWndEx::OnGetIconicLivePreviewBitmap", "AFXMDICHILDWNDEX/CMDIChildWndEx::OnGetIconicThumbnail", "AFXMDICHILDWNDEX/CMDIChildWndEx::OnMoveMiniFrame", "AFXMDICHILDWNDEX/CMDIChildWndEx::OnPressTaskbarThmbnailCloseButton", "AFXMDICHILDWNDEX/CMDIChildWndEx::OnSetPreviewMode", "AFXMDICHILDWNDEX/CMDIChildWndEx::OnTaskbarTabThumbnailActivate", "AFXMDICHILDWNDEX/CMDIChildWndEx::OnTaskbarTabThumbnailMouseActivate", "AFXMDICHILDWNDEX/CMDIChildWndEx::OnTaskbarTabThumbnailStretch", "AFXMDICHILDWNDEX/CMDIChildWndEx::OnUpdateFrameTitle", "AFXMDICHILDWNDEX/CMDIChildWndEx::PaneFromPoint", "AFXMDICHILDWNDEX/CMDIChildWndEx::RecalcLayout", "AFXMDICHILDWNDEX/CMDIChildWndEx::RegisterTaskbarTab", "AFXMDICHILDWNDEX/CMDIChildWndEx::RemovePaneFromDockManager", "AFXMDICHILDWNDEX/CMDIChildWndEx::SetRelatedTabGroup", "AFXMDICHILDWNDEX/CMDIChildWndEx::SetTaskbarTabActive", "AFXMDICHILDWNDEX/CMDIChildWndEx::SetTaskbarTabOrder", "AFXMDICHILDWNDEX/CMDIChildWndEx::SetTaskbarTabProperties", "AFXMDICHILDWNDEX/CMDIChildWndEx::SetTaskbarThumbnailClipRect", "AFXMDICHILDWNDEX/CMDIChildWndEx::ShowPane", "AFXMDICHILDWNDEX/CMDIChildWndEx::UnregisterTaskbarTab", "AFXMDICHILDWNDEX/CMDIChildWndEx::UpdateTaskbarTabIcon"] helpviewer_keywords: ["CMDIChildWndEx [MFC], ActivateTopLevelFrame", "CMDIChildWndEx [MFC], AddPane", "CMDIChildWndEx [MFC], AddTabbedPane", "CMDIChildWndEx [MFC], AdjustDockingLayout", "CMDIChildWndEx [MFC], CanShowOnMDITabs", "CMDIChildWndEx [MFC], CanShowOnTaskBarTabs", "CMDIChildWndEx [MFC], CanShowOnWindowsList", "CMDIChildWndEx [MFC], DockPane", "CMDIChildWndEx [MFC], DockPaneLeftOf", "CMDIChildWndEx [MFC], EnableAutoHidePanes", "CMDIChildWndEx [MFC], EnableDocking", "CMDIChildWndEx [MFC], EnableTaskbarThumbnailClipRect", "CMDIChildWndEx [MFC], GetDockingManager", "CMDIChildWndEx [MFC], GetDocumentName", "CMDIChildWndEx [MFC], GetFrameIcon", "CMDIChildWndEx [MFC], GetFrameText", "CMDIChildWndEx [MFC], GetPane", "CMDIChildWndEx [MFC], GetRelatedTabGroup", "CMDIChildWndEx [MFC], GetTabbedPane", "CMDIChildWndEx [MFC], GetTabProxyWnd", "CMDIChildWndEx [MFC], GetTaskbarPreviewWnd", "CMDIChildWndEx [MFC], GetTaskbarThumbnailClipRect", "CMDIChildWndEx [MFC], GetToolbarButtonToolTipText", "CMDIChildWndEx [MFC], InsertPane", "CMDIChildWndEx [MFC], InvalidateIconicBitmaps", "CMDIChildWndEx [MFC], IsPointNearDockSite", "CMDIChildWndEx [MFC], IsReadOnly", "CMDIChildWndEx [MFC], IsRegisteredWithTaskbarTabs", "CMDIChildWndEx [MFC], IsTabbedPane", "CMDIChildWndEx [MFC], IsTaskbarTabsSupportEnabled", "CMDIChildWndEx [MFC], IsTaskbarThumbnailClipRectEnabled", "CMDIChildWndEx [MFC], m_dwDefaultTaskbarTabPropertyFlags", "CMDIChildWndEx [MFC], OnGetIconicLivePreviewBitmap", "CMDIChildWndEx [MFC], OnGetIconicThumbnail", "CMDIChildWndEx [MFC], OnMoveMiniFrame", "CMDIChildWndEx [MFC], OnPressTaskbarThmbnailCloseButton", "CMDIChildWndEx [MFC], OnSetPreviewMode", "CMDIChildWndEx [MFC], OnTaskbarTabThumbnailActivate", "CMDIChildWndEx [MFC], OnTaskbarTabThumbnailMouseActivate", "CMDIChildWndEx [MFC], OnTaskbarTabThumbnailStretch", "CMDIChildWndEx [MFC], OnUpdateFrameTitle", "CMDIChildWndEx [MFC], PaneFromPoint", "CMDIChildWndEx [MFC], RecalcLayout", "CMDIChildWndEx [MFC], RegisterTaskbarTab", "CMDIChildWndEx [MFC], RemovePaneFromDockManager", "CMDIChildWndEx [MFC], SetRelatedTabGroup", "CMDIChildWndEx [MFC], SetTaskbarTabActive", "CMDIChildWndEx [MFC], SetTaskbarTabOrder", "CMDIChildWndEx [MFC], SetTaskbarTabProperties", "CMDIChildWndEx [MFC], SetTaskbarThumbnailClipRect", "CMDIChildWndEx [MFC], ShowPane", "CMDIChildWndEx [MFC], UnregisterTaskbarTab", "CMDIChildWndEx [MFC], UpdateTaskbarTabIcon"] -ms.assetid: d39fec06-0bd6-4271-917d-35aae3b24d8e --- # CMDIChildWndEx Class @@ -62,7 +61,7 @@ class CMDIChildWndEx : public CMDIChildWnd |[CMDIChildWndEx::OnGetIconicLivePreviewBitmap](#ongeticoniclivepreviewbitmap)|Called by the framework when it needs to obtain a bitmap for live preview of MDI child.| |[CMDIChildWndEx::OnGetIconicThumbnail](#ongeticonicthumbnail)|Called by the framework when it needs to obtain a bitmap for iconic thumbnail of MDI child.| |[CMDIChildWndEx::OnMoveMiniFrame](#onmoveminiframe)|Called by the framework to move a mini-frame window.| -|[CMDIChildWndEx::OnPressTaskbarThmbnailCloseButton](#onpresstaskbarthmbnailclosebutton)|Called by the framework when the user presses close button on Taskbar tab thumbnail..| +|[CMDIChildWndEx::OnPressTaskbarThmbnailCloseButton](#onpresstaskbarthmbnailclosebutton)|Called by the framework when the user presses close button on Taskbar tab thumbnail.| |[CMDIChildWndEx::OnSetPreviewMode](#onsetpreviewmode)|Called by the framework to enter or exit print preview mode.| |[CMDIChildWndEx::OnTaskbarTabThumbnailActivate](#ontaskbartabthumbnailactivate)|Called by the framework when the Taskbar tab thumbnail should process WM_ACTIVATE message.| |[CMDIChildWndEx::OnTaskbarTabThumbnailMouseActivate](#ontaskbartabthumbnailmouseactivate)|Called by the framework when the Taskbar tab thumbnail should process WM_MOUSEACTIVATE message.| diff --git a/docs/mfc/reference/cmdiframewndex-class.md b/docs/mfc/reference/cmdiframewndex-class.md index cdf8a46ed9a..4cebc0fd4de 100644 --- a/docs/mfc/reference/cmdiframewndex-class.md +++ b/docs/mfc/reference/cmdiframewndex-class.md @@ -1,6 +1,6 @@ --- -description: "Learn more about: CMDIFrameWndEx class" title: "CMDIFrameWndEx Class" +description: "Learn more about: CMDIFrameWndEx class" ms.date: 08/16/2022 f1_keywords: ["CMDIFrameWndEx", "AFXMDIFRAMEWNDEX/CMDIFrameWndEx", "AFXMDIFRAMEWNDEX/CMDIFrameWndEx::ActiveItemRecalcLayout", "AFXMDIFRAMEWNDEX/CMDIFrameWndEx::AddPane", "AFXMDIFRAMEWNDEX/CMDIFrameWndEx::AdjustClientArea", "AFXMDIFRAMEWNDEX/CMDIFrameWndEx::AdjustDockingLayout", "AFXMDIFRAMEWNDEX/CMDIFrameWndEx::AreMDITabs", "AFXMDIFRAMEWNDEX/CMDIFrameWndEx::CanConvertControlBarToMDIChild", "AFXMDIFRAMEWNDEX/CMDIFrameWndEx::ControlBarToTabbedDocument", "AFXMDIFRAMEWNDEX/CMDIFrameWndEx::CreateDocumentWindow", "AFXMDIFRAMEWNDEX/CMDIFrameWndEx::CreateNewWindow", "AFXMDIFRAMEWNDEX/CMDIFrameWndEx::DockPane", "AFXMDIFRAMEWNDEX/CMDIFrameWndEx::DockPaneLeftOf", "AFXMDIFRAMEWNDEX/CMDIFrameWndEx::EnableAutoHidePanes", "AFXMDIFRAMEWNDEX/CMDIFrameWndEx::EnableDocking", "AFXMDIFRAMEWNDEX/CMDIFrameWndEx::EnableFullScreenMainMenu", "AFXMDIFRAMEWNDEX/CMDIFrameWndEx::EnableFullScreenMode", "AFXMDIFRAMEWNDEX/CMDIFrameWndEx::EnableLoadDockState", "AFXMDIFRAMEWNDEX/CMDIFrameWndEx::EnableMDITabbedGroups", "AFXMDIFRAMEWNDEX/CMDIFrameWndEx::EnableMDITabs", "AFXMDIFRAMEWNDEX/CMDIFrameWndEx::EnableMDITabsLastActiveActivation", "AFXMDIFRAMEWNDEX/CMDIFrameWndEx::EnablePaneMenu", "AFXMDIFRAMEWNDEX/CMDIFrameWndEx::EnableWindowsDialog", "AFXMDIFRAMEWNDEX/CMDIFrameWndEx::GetActivePopup", "AFXMDIFRAMEWNDEX/CMDIFrameWndEx::GetPane", "AFXMDIFRAMEWNDEX/CMDIFrameWndEx::GetDefaultResId", "AFXMDIFRAMEWNDEX/CMDIFrameWndEx::GetMDITabGroups", "AFXMDIFRAMEWNDEX/CMDIFrameWndEx::GetMDITabs", "AFXMDIFRAMEWNDEX/CMDIFrameWndEx::GetMDITabsContextMenuAllowedItems", "AFXMDIFRAMEWNDEX/CMDIFrameWndEx::GetMenuBar", "AFXMDIFRAMEWNDEX/CMDIFrameWndEx::GetRibbonBar", "AFXMDIFRAMEWNDEX/CMDIFrameWndEx::GetTearOffBars", "AFXMDIFRAMEWNDEX/CMDIFrameWndEx::GetToolbarButtonToolTipText", "AFXMDIFRAMEWNDEX/CMDIFrameWndEx::InsertPane", "AFXMDIFRAMEWNDEX/CMDIFrameWndEx::IsFullScreen", "AFXMDIFRAMEWNDEX/CMDIFrameWndEx::IsMDITabbedGroup", "AFXMDIFRAMEWNDEX/CMDIFrameWndEx::IsMemberOfMDITabGroup", "AFXMDIFRAMEWNDEX/CMDIFrameWndEx::IsMenuBarAvailable", "AFXMDIFRAMEWNDEX/CMDIFrameWndEx::IsPointNearDockSite", "AFXMDIFRAMEWNDEX/CMDIFrameWndEx::IsPrintPreview", "AFXMDIFRAMEWNDEX/CMDIFrameWndEx::LoadFrame", "AFXMDIFRAMEWNDEX/CMDIFrameWndEx::LoadMDIState", "AFXMDIFRAMEWNDEX/CMDIFrameWndEx::MDITabMoveToNextGroup", "AFXMDIFRAMEWNDEX/CMDIFrameWndEx::MDITabNewGroup", "AFXMDIFRAMEWNDEX/CMDIFrameWndEx::NegotiateBorderSpace", "AFXMDIFRAMEWNDEX/CMDIFrameWndEx::OnCloseDockingPane", "AFXMDIFRAMEWNDEX/CMDIFrameWndEx::OnCloseMiniFrame", "AFXMDIFRAMEWNDEX/CMDIFrameWndEx::OnClosePopupMenu", "AFXMDIFRAMEWNDEX/CMDIFrameWndEx::OnCmdMsg", "AFXMDIFRAMEWNDEX/CMDIFrameWndEx::OnDrawMenuImage", "AFXMDIFRAMEWNDEX/CMDIFrameWndEx::OnDrawMenuLogo", "AFXMDIFRAMEWNDEX/CMDIFrameWndEx::OnEraseMDIClientBackground", "AFXMDIFRAMEWNDEX/CMDIFrameWndEx::OnMenuButtonToolHitTest", "AFXMDIFRAMEWNDEX/CMDIFrameWndEx::OnMoveMiniFrame", "AFXMDIFRAMEWNDEX/CMDIFrameWndEx::OnSetPreviewMode", "AFXMDIFRAMEWNDEX/CMDIFrameWndEx::OnShowCustomizePane", "AFXMDIFRAMEWNDEX/CMDIFrameWndEx::OnShowMDITabContextMenu", "AFXMDIFRAMEWNDEX/CMDIFrameWndEx::OnShowPanes", "AFXMDIFRAMEWNDEX/CMDIFrameWndEx::OnShowPopupMenu", "AFXMDIFRAMEWNDEX/CMDIFrameWndEx::OnSizeMDIClient", "AFXMDIFRAMEWNDEX/CMDIFrameWndEx::OnTearOffMenu", "AFXMDIFRAMEWNDEX/CMDIFrameWndEx::OnUpdateFrameMenu", "AFXMDIFRAMEWNDEX/CMDIFrameWndEx::PaneFromPoint", "AFXMDIFRAMEWNDEX/CMDIFrameWndEx::RecalcLayout", "AFXMDIFRAMEWNDEX/CMDIFrameWndEx::RemovePaneFromDockManager", "AFXMDIFRAMEWNDEX/CMDIFrameWndEx::SaveMDIState", "AFXMDIFRAMEWNDEX/CMDIFrameWndEx::SetPrintPreviewFrame", "AFXMDIFRAMEWNDEX/CMDIFrameWndEx::SetupToolbarMenu", "AFXMDIFRAMEWNDEX/CMDIFrameWndEx::ShowFullScreen", "AFXMDIFRAMEWNDEX/CMDIFrameWndEx::ShowPane", "AFXMDIFRAMEWNDEX/CMDIFrameWndEx::ShowWindowsDialog", "AFXMDIFRAMEWNDEX/CMDIFrameWndEx::TabbedDocumentToControlBar", "AFXMDIFRAMEWNDEX/CMDIFrameWndEx::UpdateCaption", "AFXMDIFRAMEWNDEX/CMDIFrameWndEx::UpdateMDITabbedBarsIcons", "AFXMDIFRAMEWNDEX/CMDIFrameWndEx::WinHelp", "AFXMDIFRAMEWNDEX/CMDIFrameWndEx::m_bCanConvertControlBarToMDIChild", "AFXMDIFRAMEWNDEX/CMDIFrameWndEx::m_bDisableSetRedraw"] helpviewer_keywords: ["CMDIFrameWndEx [MFC], ActiveItemRecalcLayout", "CMDIFrameWndEx [MFC], AddPane", "CMDIFrameWndEx [MFC], AdjustClientArea", "CMDIFrameWndEx [MFC], AdjustDockingLayout", "CMDIFrameWndEx [MFC], AreMDITabs", "CMDIFrameWndEx [MFC], CanConvertControlBarToMDIChild", "CMDIFrameWndEx [MFC], ControlBarToTabbedDocument", "CMDIFrameWndEx [MFC], CreateDocumentWindow", "CMDIFrameWndEx [MFC], CreateNewWindow", "CMDIFrameWndEx [MFC], DockPane", "CMDIFrameWndEx [MFC], DockPaneLeftOf", "CMDIFrameWndEx [MFC], EnableAutoHidePanes", "CMDIFrameWndEx [MFC], EnableDocking", "CMDIFrameWndEx [MFC], EnableFullScreenMainMenu", "CMDIFrameWndEx [MFC], EnableFullScreenMode", "CMDIFrameWndEx [MFC], EnableLoadDockState", "CMDIFrameWndEx [MFC], EnableMDITabbedGroups", "CMDIFrameWndEx [MFC], EnableMDITabs", "CMDIFrameWndEx [MFC], EnableMDITabsLastActiveActivation", "CMDIFrameWndEx [MFC], EnablePaneMenu", "CMDIFrameWndEx [MFC], EnableWindowsDialog", "CMDIFrameWndEx [MFC], GetActivePopup", "CMDIFrameWndEx [MFC], GetPane", "CMDIFrameWndEx [MFC], GetDefaultResId", "CMDIFrameWndEx [MFC], GetMDITabGroups", "CMDIFrameWndEx [MFC], GetMDITabs", "CMDIFrameWndEx [MFC], GetMDITabsContextMenuAllowedItems", "CMDIFrameWndEx [MFC], GetMenuBar", "CMDIFrameWndEx [MFC], GetRibbonBar", "CMDIFrameWndEx [MFC], GetTearOffBars", "CMDIFrameWndEx [MFC], GetToolbarButtonToolTipText", "CMDIFrameWndEx [MFC], InsertPane", "CMDIFrameWndEx [MFC], IsFullScreen", "CMDIFrameWndEx [MFC], IsMDITabbedGroup", "CMDIFrameWndEx [MFC], IsMemberOfMDITabGroup", "CMDIFrameWndEx [MFC], IsMenuBarAvailable", "CMDIFrameWndEx [MFC], IsPointNearDockSite", "CMDIFrameWndEx [MFC], IsPrintPreview", "CMDIFrameWndEx [MFC], LoadFrame", "CMDIFrameWndEx [MFC], LoadMDIState", "CMDIFrameWndEx [MFC], MDITabMoveToNextGroup", "CMDIFrameWndEx [MFC], MDITabNewGroup", "CMDIFrameWndEx [MFC], NegotiateBorderSpace", "CMDIFrameWndEx [MFC], OnCloseDockingPane", "CMDIFrameWndEx [MFC], OnCloseMiniFrame", "CMDIFrameWndEx [MFC], OnClosePopupMenu", "CMDIFrameWndEx [MFC], OnCmdMsg", "CMDIFrameWndEx [MFC], OnDrawMenuImage", "CMDIFrameWndEx [MFC], OnDrawMenuLogo", "CMDIFrameWndEx [MFC], OnEraseMDIClientBackground", "CMDIFrameWndEx [MFC], OnMenuButtonToolHitTest", "CMDIFrameWndEx [MFC], OnMoveMiniFrame", "CMDIFrameWndEx [MFC], OnSetPreviewMode", "CMDIFrameWndEx [MFC], OnShowCustomizePane", "CMDIFrameWndEx [MFC], OnShowMDITabContextMenu", "CMDIFrameWndEx [MFC], OnShowPanes", "CMDIFrameWndEx [MFC], OnShowPopupMenu", "CMDIFrameWndEx [MFC], OnSizeMDIClient", "CMDIFrameWndEx [MFC], OnTearOffMenu", "CMDIFrameWndEx [MFC], OnUpdateFrameMenu", "CMDIFrameWndEx [MFC], PaneFromPoint", "CMDIFrameWndEx [MFC], RecalcLayout", "CMDIFrameWndEx [MFC], RemovePaneFromDockManager", "CMDIFrameWndEx [MFC], SaveMDIState", "CMDIFrameWndEx [MFC], SetPrintPreviewFrame", "CMDIFrameWndEx [MFC], SetupToolbarMenu", "CMDIFrameWndEx [MFC], ShowFullScreen", "CMDIFrameWndEx [MFC], ShowPane", "CMDIFrameWndEx [MFC], ShowWindowsDialog", "CMDIFrameWndEx [MFC], TabbedDocumentToControlBar", "CMDIFrameWndEx [MFC], UpdateCaption", "CMDIFrameWndEx [MFC], UpdateMDITabbedBarsIcons", "CMDIFrameWndEx [MFC], WinHelp", "CMDIFrameWndEx [MFC], m_bCanConvertControlBarToMDIChild", "CMDIFrameWndEx [MFC], m_bDisableSetRedraw"] @@ -72,9 +72,9 @@ class CMDIFrameWndEx : public CMDIFrameWnd |[`CMDIFrameWndEx::OnClosePopupMenu`](#onclosepopupmenu)|Called by the framework when an active pop-up menu processes a `WM_DESTROY` message.| |[`CMDIFrameWndEx::OnCmdMsg`](#oncmdmsg)|Called by the framework to route and dispatch command messages and to update command user-interface objects.| |[`CMDIFrameWndEx::OnDrawMenuImage`](#ondrawmenuimage)|Called by the framework when the image associated with a menu item is drawn.| -|[`CMDIFrameWndEx::OnDrawMenuLogo`](#ondrawmenulogo)|Called by the framework when a [`CMFCPopupMenu`](../../mfc/reference/cmfcpopupmenu-class.md)processes a `WM_PAINT` message.| +|[`CMDIFrameWndEx::OnDrawMenuLogo`](#ondrawmenulogo)|Called by the framework when a [`CMFCPopupMenu`](../../mfc/reference/cmfcpopupmenu-class.md) processes a `WM_PAINT` message.| |[`CMDIFrameWndEx::OnEraseMDIClientBackground`](#onerasemdiclientbackground)|Called by the framework when the MDI frame window processes a `WM_ERASEBKGND` message.| -|[`CMDIFrameWndEx::OnMenuButtonToolHitTest`](#onmenubuttontoolhittest)|Called by the framework when a [`CMFCToolBarButton`](../../mfc/reference/cmfctoolbarbutton-class.md)object processes a `WM_NCHITTEST` message.| +|[`CMDIFrameWndEx::OnMenuButtonToolHitTest`](#onmenubuttontoolhittest)|Called by the framework when a [`CMFCToolBarButton`](../../mfc/reference/cmfctoolbarbutton-class.md) object processes a `WM_NCHITTEST` message.| |[`CMDIFrameWndEx::OnMoveMiniFrame`](#onmoveminiframe)|Called by the framework to move a mini-frame window.| |[`CMDIFrameWndEx::OnSetPreviewMode`](#onsetpreviewmode)|Sets the application's main frame window print-preview mode. (Overrides [`CFrameWnd::OnSetPreviewMode`](../../mfc/reference/cframewnd-class.md#onsetpreviewmode).)| |[`CMDIFrameWndEx::OnShowCustomizePane`](#onshowcustomizepane)|Called by the framework when a Quick Customize pane is activated.| @@ -1045,7 +1045,7 @@ virtual BOOL LoadMDIState(LPCTSTR lpszProfileName); To load or save the state of MDI tabs and groups and the list of opened documents, do the following: - Call [`CMDIFrameWndEx::SaveMDIState`](#savemdistate) when the main frame is being closed -- Call [`CMDIFrameWndEx::LoadMDIState`](#loadmdistate) when the main frame is being created. The recommended place for this call is before the main frame is displayed for the first time. Add `CWinAppEx::EnableLoadWindowPlacement` `(FALSE);` before `pMainFrame->LoadFrame (IDR_MAINFRAME);.` Add `CWinAppEx::ReloadWindowPlacement` `(pMainFrame);` after the call to `LoadMDIState` to display the main frame at the position that was stored in the registry. +- Call [`CMDIFrameWndEx::LoadMDIState`](#loadmdistate) when the main frame is being created. The recommended place for this call is before the main frame is displayed for the first time. Add `CWinAppEx::EnableLoadWindowPlacement` `(FALSE);` before `pMainFrame->LoadFrame (IDR_MAINFRAME);`. Add `CWinAppEx::ReloadWindowPlacement` `(pMainFrame);` after the call to `LoadMDIState` to display the main frame at the position that was stored in the registry. - Override `GetDocumentName` in the `CMDIChildWndEx`- derived class if your application displays documents that aren't stored as files. The returned string will be saved in the registry as the document identifier. The base implementation of [`CMDIChildWndEx::GetDocumentName`](../../mfc/reference/cmdichildwndex-class.md#getdocumentname) returns a value obtained from [`CDocument::GetPathName`](../../mfc/reference/cdocument-class.md#getpathname). - Override [`CMDIFrameWndEx::CreateDocumentWindow`](#createdocumentwindow) to correctly create documents when they're being loaded from the registry. The first parameter is the string that `GetDocumentName` returned. @@ -1282,7 +1282,7 @@ Override this method if you want to customize image rendering for the menu item ## `CMDIFrameWndEx::OnDrawMenuLogo` -Called by the framework when a [`CMFCPopupMenu`](../../mfc/reference/cmfcpopupmenu-class.md)processes a `WM_PAINT` message. +Called by the framework when a [`CMFCPopupMenu`](../../mfc/reference/cmfcpopupmenu-class.md) processes a `WM_PAINT` message. ```cpp virtual void OnDrawMenuLogo( @@ -1313,7 +1313,7 @@ Override this member function if you want to process the `WM_ERASEBKGND` message ## `CMDIFrameWndEx::OnMenuButtonToolHitTest` -Called by the framework when a [`CMFCToolBarButton`](../../mfc/reference/cmfctoolbarbutton-class.md)object processes a `WM_NCHITTEST` message. +Called by the framework when a [`CMFCToolBarButton`](../../mfc/reference/cmfctoolbarbutton-class.md) object processes a `WM_NCHITTEST` message. ```cpp virtual BOOL OnMenuButtonToolHitTest( diff --git a/docs/mfc/reference/cmditabinfo-class.md b/docs/mfc/reference/cmditabinfo-class.md index 1f9cfbb1760..f2c9ffc9a02 100644 --- a/docs/mfc/reference/cmditabinfo-class.md +++ b/docs/mfc/reference/cmditabinfo-class.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: CMDITabInfo Class" title: "CMDITabInfo Class" -ms.date: "11/04/2016" +description: "Learn more about: CMDITabInfo Class" +ms.date: 11/04/2016 f1_keywords: ["CMDITabInfo", "AFXMDICLIENTAREAWND/CMDITabInfo", "AFXMDICLIENTAREAWND/CMDITabInfo::Serialize", "AFXMDICLIENTAREAWND/CMDITabInfo::m_bAutoColor", "AFXMDICLIENTAREAWND/CMDITabInfo::m_bDocumentMenu", "AFXMDICLIENTAREAWND/CMDITabInfo::m_bEnableTabSwap", "AFXMDICLIENTAREAWND/CMDITabInfo::m_bFlatFrame", "AFXMDICLIENTAREAWND/CMDITabInfo::m_bTabCloseButton", "AFXMDICLIENTAREAWND/CMDITabInfo::m_bTabCustomTooltips", "AFXMDICLIENTAREAWND/CMDITabInfo::m_bTabIcons", "AFXMDICLIENTAREAWND/CMDITabInfo::m_nTabBorderSize", "AFXMDICLIENTAREAWND/CMDITabInfo::m_style", "AFXMDICLIENTAREAWND/CMDITabInfo::m_tabLocation"] helpviewer_keywords: ["CMDITabInfo [MFC], Serialize", "CMDITabInfo [MFC], m_bAutoColor", "CMDITabInfo [MFC], m_bDocumentMenu", "CMDITabInfo [MFC], m_bEnableTabSwap", "CMDITabInfo [MFC], m_bFlatFrame", "CMDITabInfo [MFC], m_bTabCloseButton", "CMDITabInfo [MFC], m_bTabCustomTooltips", "CMDITabInfo [MFC], m_bTabIcons", "CMDITabInfo [MFC], m_nTabBorderSize", "CMDITabInfo [MFC], m_style", "CMDITabInfo [MFC], m_tabLocation"] -ms.assetid: 988ae1b7-4f7f-4239-b88f-7e28b3291c5e --- # CMDITabInfo Class @@ -64,7 +63,7 @@ The following example demonstrates how to set the values of the various member v **Header:** afxmdiclientareawnd.h -## CMDITabInfo::m_bActiveTabCloseButton; +## CMDITabInfo::m_bActiveTabCloseButton Specifies whether a **Close** button is displayed on the label of the active tab. diff --git a/docs/mfc/reference/cmemfile-class.md b/docs/mfc/reference/cmemfile-class.md index cef271bf9c3..d6b8ff19954 100644 --- a/docs/mfc/reference/cmemfile-class.md +++ b/docs/mfc/reference/cmemfile-class.md @@ -1,10 +1,9 @@ --- title: "CMemFile Class" description: "Describes the functions available in the CMemFile class which allows you to work with memory files." -ms.date: "07/23/2020" -f1_keywords: ["CMemFile", "AFX/CMemFile", "AFX/CMemFile::CMemFile", "AFX/CMemFile::Attach", "AFX/CMemFile::Detach", "AFX/CMemFile::Alloc", "AFX/CMemFile::Free", "AFX/CmemFile::GetBufferPtr", AFX/CMemFile::GrowFile", "AFX/CMemFile::Memcpy", "AFX/CMemFile::Realloc"] +ms.date: 07/23/2020 +f1_keywords: ["CMemFile", "AFX/CMemFile", "AFX/CMemFile::CMemFile", "AFX/CMemFile::Attach", "AFX/CMemFile::Detach", "AFX/CMemFile::Alloc", "AFX/CMemFile::Free", "AFX/CmemFile::GetBufferPtr", "AFX/CMemFile::GrowFile", "AFX/CMemFile::Memcpy", "AFX/CMemFile::Realloc"] helpviewer_keywords: ["CMemFile [MFC], CMemFile", "CMemFile [MFC], Attach", "CMemFile [MFC], Detach", "CMemFile [MFC], Alloc", "CMemFile [MFC], Free", "CMemFile [MFC], GetBufferPtr", "CMemFile [MFC], GrowFile", "CMemFile [MFC], Memcpy", "CMemFile [MFC], Realloc"] -ms.assetid: 20e86515-e465-4f73-b2ea-e49789d63165 --- # CMemFile Class @@ -86,7 +85,7 @@ virtual BYTE* Alloc(SIZE_T nBytes); ### Parameters -*nBytes*
+*nBytes*\ Number of bytes of memory to be allocated. ### Return Value @@ -112,13 +111,13 @@ void Attach( ### Parameters -*lpBuffer*
+*lpBuffer*\ Pointer to the buffer to be attached to `CMemFile`. -*nBufferSize*
+*nBufferSize*\ An integer that specifies the size of the buffer in bytes. -*nGrowBytes*
+*nGrowBytes*\ The memory allocation increment in bytes. ### Remarks @@ -127,7 +126,7 @@ This causes `CMemFile` to use the block of memory as the memory file. If *nGrowBytes* is 0, `CMemFile` will set the file length to *nBufferSize*. This means that the data in the memory block before it was attached to `CMemFile` will be used as the file. Memory files created in this manner can't be grown. -Since the file can't be grown, be careful not to cause `CMemFile` to attempt to grow the file. For example, don't call the `CMemFile` overrides of [CFile:Write](../../mfc/reference/cfile-class.md#write) to write past the end or don't call [CFile:SetLength](../../mfc/reference/cfile-class.md#setlength) with a length longer than *nBufferSize*. +Since the file can't be grown, be careful not to cause `CMemFile` to attempt to grow the file. For example, don't call the `CMemFile` overrides of [CFile::Write](../../mfc/reference/cfile-class.md#write) to write past the end or don't call [CFile::SetLength](../../mfc/reference/cfile-class.md#setlength) with a length longer than *nBufferSize*. If *nGrowBytes* is greater than 0, `CMemFile` will ignore the contents of the memory block you've attached. You'll have to write the contents of the memory file from scratch using the `CMemFile` override of `CFile::Write`. If you attempt to write past the end of the file or grow the file by calling the `CMemFile` override of `CFile::SetLength`, `CMemFile` will grow the memory allocation in increments of *nGrowBytes*. Growing the memory allocation will fail if the memory block you pass to `Attach` wasn't allocated with a method compatible with [Alloc](#alloc). To be compatible with the default implementation of `Alloc`, you must allocate the memory with the run-time library function [malloc](../../c-runtime-library/reference/malloc.md) or [calloc](../../c-runtime-library/reference/calloc.md). @@ -146,13 +145,13 @@ CMemFile( ### Parameters -*nGrowBytes*
+*nGrowBytes*\ The memory allocation increment in bytes. -*lpBuffer* +*lpBuffer*\ Pointer to a buffer that receives information of the size *nBufferSize*. -*nBufferSize*
+*nBufferSize*\ An integer that specifies the size of the file buffer, in bytes. ### Remarks @@ -179,7 +178,7 @@ A pointer to the memory block that contains the contents of the memory file. ### Remarks -Calling this function also closes the `CMemFile`. You can reattach the memory block to `CMemFile` by calling [Attach](#attach). If you want to reattach the file and use the data in it, you should call [CFile::GetLength](../../mfc/reference/cfile-class.md#getlength) to get the length of the file before calling `Detach`. If you attach a memory block to `CMemFile` so that you can use its data ( `nGrowBytes` == 0), then you can't grow the memory file. +Calling this function also closes the `CMemFile`. You can reattach the memory block to `CMemFile` by calling [Attach](#attach). If you want to reattach the file and use the data in it, you should call [CFile::GetLength](../../mfc/reference/cfile-class.md#getlength) to get the length of the file before calling `Detach`. If you attach a memory block to `CMemFile` so that you can use its data (`nGrowBytes` == 0), then you can't grow the memory file. ## CMemFile::Free @@ -191,7 +190,7 @@ virtual void Free(BYTE* lpMem); ### Parameters -*lpMem*
+*lpMem*\ Pointer to the memory to be deallocated. ### Remarks @@ -213,16 +212,16 @@ virtual UINT GetBufferPtr( ### Parameters -*nCommand*
-The [bufferCommand](buffercommand-enumeration.md) to carry out (`bufferCheck`, `bufferCommit`, `bufferRead`, or `bufferWrite` ). +*nCommand*\ +The [bufferCommand](buffercommand-enumeration.md) to carry out (`bufferCheck`, `bufferCommit`, `bufferRead`, or `bufferWrite`). -*nCount*
+*nCount*\ Depending on *nCommand*, the number of bytes in the buffer to read, write, or commit. When reading from the buffer, specify -1 to return a buffer from the current position to the end of the file. -*ppBufStart*
+*ppBufStart*\ [out] The start of the buffer. Must be `NULL` when *nCommand* is `bufferCommit`. -*ppBufMax*
+*ppBufMax*\ [out] The end of the buffer. Must be `NULL` when nCommand is `bufferCommit`. ### Return Value @@ -252,7 +251,7 @@ virtual void GrowFile(SIZE_T dwNewLen); ### Parameters -*dwNewLen*
+*dwNewLen*\ New size of the memory file. ### Remarks @@ -272,13 +271,13 @@ virtual BYTE* Memcpy( ### Parameters -*lpMemTarget*
+*lpMemTarget*\ Pointer to the memory block into which the source memory will be copied. -*lpMemSource*
+*lpMemSource*\ Pointer to the source memory block. -*nBytes*
+*nBytes*\ Number of bytes to be copied. ### Return Value @@ -301,10 +300,10 @@ virtual BYTE* Realloc( ### Parameters -*lpMem*
+*lpMem*\ A pointer to the memory block to be reallocated. -*nBytes*
+*nBytes*\ New size for the memory block. ### Return Value @@ -317,5 +316,5 @@ Override this function to implement custom memory reallocation. If you override ## See also -[CFile Class](../../mfc/reference/cfile-class.md)
+[CFile Class](../../mfc/reference/cfile-class.md)\ [Hierarchy Chart](../../mfc/hierarchy-chart.md) diff --git a/docs/mfc/reference/cmfcbasetabctrl-class.md b/docs/mfc/reference/cmfcbasetabctrl-class.md index cf6a14ee2c1..d34822e52a4 100644 --- a/docs/mfc/reference/cmfcbasetabctrl-class.md +++ b/docs/mfc/reference/cmfcbasetabctrl-class.md @@ -1,7 +1,7 @@ --- title: "CMFCBaseTabCtrl Class" description: "Learn more about: CMFCBaseTabCtrl Class" -ms.date: "11/04/2016" +ms.date: 11/04/2016 f1_keywords: ["CMFCBaseTabCtrl", "AFXBASETABCTRL/CMFCBaseTabCtrl", "AFXBASETABCTRL/CMFCBaseTabCtrl::AddIcon", "AFXBASETABCTRL/CMFCBaseTabCtrl::AddTab", "AFXBASETABCTRL/CMFCBaseTabCtrl::ApplyRestoredTabInfo", "AFXBASETABCTRL/CMFCBaseTabCtrl::AutoDestroyWindow", "AFXBASETABCTRL/CMFCBaseTabCtrl::CalcRectEdit", "AFXBASETABCTRL/CMFCBaseTabCtrl::CleanUp", "AFXBASETABCTRL/CMFCBaseTabCtrl::ClearImageList", "AFXBASETABCTRL/CMFCBaseTabCtrl::DetachTab", "AFXBASETABCTRL/CMFCBaseTabCtrl::EnableActivateLastActive", "AFXBASETABCTRL/CMFCBaseTabCtrl::EnableAutoColor", "AFXBASETABCTRL/CMFCBaseTabCtrl::EnableCustomToolTips", "AFXBASETABCTRL/CMFCBaseTabCtrl::EnableInPlaceEdit", "AFXBASETABCTRL/CMFCBaseTabCtrl::EnableTabDetach", "AFXBASETABCTRL/CMFCBaseTabCtrl::EnableTabSwap", "AFXBASETABCTRL/CMFCBaseTabCtrl::EnsureVisible", "AFXBASETABCTRL/CMFCBaseTabCtrl::EnterDragMode", "AFXBASETABCTRL/CMFCBaseTabCtrl::FindTargetWnd", "AFXBASETABCTRL/CMFCBaseTabCtrl::FireChangeActiveTab", "AFXBASETABCTRL/CMFCBaseTabCtrl::FireChangingActiveTab", "AFXBASETABCTRL/CMFCBaseTabCtrl::GetActiveTab", "AFXBASETABCTRL/CMFCBaseTabCtrl::GetActiveTabColor", "AFXBASETABCTRL/CMFCBaseTabCtrl::GetActiveTabTextColor", "AFXBASETABCTRL/CMFCBaseTabCtrl::GetActiveWnd", "AFXBASETABCTRL/CMFCBaseTabCtrl::GetAutoColors", "AFXBASETABCTRL/CMFCBaseTabCtrl::GetFirstVisibleTab", "AFXBASETABCTRL/CMFCBaseTabCtrl::GetFirstVisibleTabNum", "AFXBASETABCTRL/CMFCBaseTabCtrl::GetHighlightedTab", "AFXBASETABCTRL/CMFCBaseTabCtrl::GetImageList", "AFXBASETABCTRL/CMFCBaseTabCtrl::GetImageSize", "AFXBASETABCTRL/CMFCBaseTabCtrl::GetLastVisibleTab", "AFXBASETABCTRL/CMFCBaseTabCtrl::GetLocation", "AFXBASETABCTRL/CMFCBaseTabCtrl::GetMaxWindowSize", "AFXBASETABCTRL/CMFCBaseTabCtrl::GetTabArea", "AFXBASETABCTRL/CMFCBaseTabCtrl::GetTabBkColor", "AFXBASETABCTRL/CMFCBaseTabCtrl::GetTabBorderSize", "AFXBASETABCTRL/CMFCBaseTabCtrl::GetTabByID", "AFXBASETABCTRL/CMFCBaseTabCtrl::GetTabCloseButton", "AFXBASETABCTRL/CMFCBaseTabCtrl::GetTabFromHwnd", "AFXBASETABCTRL/CMFCBaseTabCtrl::GetTabFromPoint", "AFXBASETABCTRL/CMFCBaseTabCtrl::GetTabFullWidth", "AFXBASETABCTRL/CMFCBaseTabCtrl::GetTabHicon", "AFXBASETABCTRL/CMFCBaseTabCtrl::GetTabID", "AFXBASETABCTRL/CMFCBaseTabCtrl::GetTabIcon", "AFXBASETABCTRL/CMFCBaseTabCtrl::GetTabLabel", "AFXBASETABCTRL/CMFCBaseTabCtrl::GetTabRect", "AFXBASETABCTRL/CMFCBaseTabCtrl::GetTabsHeight", "AFXBASETABCTRL/CMFCBaseTabCtrl::GetTabsRect", "AFXBASETABCTRL/CMFCBaseTabCtrl::GetTabTextColor", "AFXBASETABCTRL/CMFCBaseTabCtrl::GetTabWnd", "AFXBASETABCTRL/CMFCBaseTabCtrl::GetTabWndNoWrapper", "AFXBASETABCTRL/CMFCBaseTabCtrl::GetTabsNum", "AFXBASETABCTRL/CMFCBaseTabCtrl::GetToolTipCtrl", "AFXBASETABCTRL/CMFCBaseTabCtrl::GetVisibleTabsNum", "AFXBASETABCTRL/CMFCBaseTabCtrl::HasImage", "AFXBASETABCTRL/CMFCBaseTabCtrl::HideSingleTab", "AFXBASETABCTRL/CMFCBaseTabCtrl::InsertTab", "AFXBASETABCTRL/CMFCBaseTabCtrl::InvalidateTab", "AFXBASETABCTRL/CMFCBaseTabCtrl::IsActiveTabCloseButton", "AFXBASETABCTRL/CMFCBaseTabCtrl::IsAutoColor", "AFXBASETABCTRL/CMFCBaseTabCtrl::IsAutoDestroyWindow", "AFXBASETABCTRL/CMFCBaseTabCtrl::IsColored", "AFXBASETABCTRL/CMFCBaseTabCtrl::IsDialogControl", "AFXBASETABCTRL/CMFCBaseTabCtrl::IsDrawNoPrefix", "AFXBASETABCTRL/CMFCBaseTabCtrl::IsFlatFrame", "AFXBASETABCTRL/CMFCBaseTabCtrl::IsFlatTab", "AFXBASETABCTRL/CMFCBaseTabCtrl::IsHideSingleTab", "AFXBASETABCTRL/CMFCBaseTabCtrl::IsIconAdded", "AFXBASETABCTRL/CMFCBaseTabCtrl::IsInPlaceEdit", "AFXBASETABCTRL/CMFCBaseTabCtrl::IsLeftRightRounded", "AFXBASETABCTRL/CMFCBaseTabCtrl::IsMDITab", "AFXBASETABCTRL/CMFCBaseTabCtrl::IsOneNoteStyle", "AFXBASETABCTRL/CMFCBaseTabCtrl::IsPtInTabArea", "AFXBASETABCTRL/CMFCBaseTabCtrl::IsTabCloseButtonHighlighted", "AFXBASETABCTRL/CMFCBaseTabCtrl::IsTabCloseButtonPressed", "AFXBASETABCTRL/CMFCBaseTabCtrl::IsTabDetachable", "AFXBASETABCTRL/CMFCBaseTabCtrl::IsTabIconOnly", "AFXBASETABCTRL/CMFCBaseTabCtrl::IsTabSwapEnabled", "AFXBASETABCTRL/CMFCBaseTabCtrl::IsTabVisible", "AFXBASETABCTRL/CMFCBaseTabCtrl::IsVS2005Style", "AFXBASETABCTRL/CMFCBaseTabCtrl::MoveTab", "AFXBASETABCTRL/CMFCBaseTabCtrl::OnChangeTabs", "AFXBASETABCTRL/CMFCBaseTabCtrl::OnDragEnter", "AFXBASETABCTRL/CMFCBaseTabCtrl::OnDragLeave", "AFXBASETABCTRL/CMFCBaseTabCtrl::OnDragOver", "AFXBASETABCTRL/CMFCBaseTabCtrl::OnDrop", "AFXBASETABCTRL/CMFCBaseTabCtrl::OnRenameTab", "AFXBASETABCTRL/CMFCBaseTabCtrl::PreTranslateMessage", "AFXBASETABCTRL/CMFCBaseTabCtrl::RecalcLayout", "AFXBASETABCTRL/CMFCBaseTabCtrl::RemoveAllTabs", "AFXBASETABCTRL/CMFCBaseTabCtrl::RemoveTab", "AFXBASETABCTRL/CMFCBaseTabCtrl::RenameTab", "AFXBASETABCTRL/CMFCBaseTabCtrl::ResetImageList", "AFXBASETABCTRL/CMFCBaseTabCtrl::Serialize", "AFXBASETABCTRL/CMFCBaseTabCtrl::SetActiveTab", "AFXBASETABCTRL/CMFCBaseTabCtrl::SetActiveTabColor", "AFXBASETABCTRL/CMFCBaseTabCtrl::SetActiveTabTextColor", "AFXBASETABCTRL/CMFCBaseTabCtrl::SetAutoColors", "AFXBASETABCTRL/CMFCBaseTabCtrl::SetDockingBarWrapperRTC", "AFXBASETABCTRL/CMFCBaseTabCtrl::SetDrawNoPrefix", "AFXBASETABCTRL/CMFCBaseTabCtrl::SetImageList", "AFXBASETABCTRL/CMFCBaseTabCtrl::SetLocation", "AFXBASETABCTRL/CMFCBaseTabCtrl::SetTabBkColor", "AFXBASETABCTRL/CMFCBaseTabCtrl::SetTabBorderSize", "AFXBASETABCTRL/CMFCBaseTabCtrl::SetTabHicon", "AFXBASETABCTRL/CMFCBaseTabCtrl::SetTabIcon", "AFXBASETABCTRL/CMFCBaseTabCtrl::SetTabIconOnly", "AFXBASETABCTRL/CMFCBaseTabCtrl::SetTabLabel", "AFXBASETABCTRL/CMFCBaseTabCtrl::SetTabsHeight", "AFXBASETABCTRL/CMFCBaseTabCtrl::SetTabTextColor", "AFXBASETABCTRL/CMFCBaseTabCtrl::SetTabsOrder", "AFXBASETABCTRL/CMFCBaseTabCtrl::ShowTab", "AFXBASETABCTRL/CMFCBaseTabCtrl::StartRenameTab", "AFXBASETABCTRL/CMFCBaseTabCtrl::SwapTabs", "AFXBASETABCTRL/CMFCBaseTabCtrl::CreateWrapper", "AFXBASETABCTRL/CMFCBaseTabCtrl::m_bActivateTabOnRightClick", "AFXBASETABCTRL/CMFCBaseTabCtrl::m_bAutoDestroyWindow"] helpviewer_keywords: ["CMFCBaseTabCtrl [MFC], AddIcon", "CMFCBaseTabCtrl [MFC], AddTab", "CMFCBaseTabCtrl [MFC], ApplyRestoredTabInfo", "CMFCBaseTabCtrl [MFC], AutoDestroyWindow", "CMFCBaseTabCtrl [MFC], CalcRectEdit", "CMFCBaseTabCtrl [MFC], CleanUp", "CMFCBaseTabCtrl [MFC], ClearImageList", "CMFCBaseTabCtrl [MFC], DetachTab", "CMFCBaseTabCtrl [MFC], EnableActivateLastActive", "CMFCBaseTabCtrl [MFC], EnableAutoColor", "CMFCBaseTabCtrl [MFC], EnableCustomToolTips", "CMFCBaseTabCtrl [MFC], EnableInPlaceEdit", "CMFCBaseTabCtrl [MFC], EnableTabDetach", "CMFCBaseTabCtrl [MFC], EnableTabSwap", "CMFCBaseTabCtrl [MFC], EnsureVisible", "CMFCBaseTabCtrl [MFC], EnterDragMode", "CMFCBaseTabCtrl [MFC], FindTargetWnd", "CMFCBaseTabCtrl [MFC], FireChangeActiveTab", "CMFCBaseTabCtrl [MFC], FireChangingActiveTab", "CMFCBaseTabCtrl [MFC], GetActiveTab", "CMFCBaseTabCtrl [MFC], GetActiveTabColor", "CMFCBaseTabCtrl [MFC], GetActiveTabTextColor", "CMFCBaseTabCtrl [MFC], GetActiveWnd", "CMFCBaseTabCtrl [MFC], GetAutoColors", "CMFCBaseTabCtrl [MFC], GetFirstVisibleTab", "CMFCBaseTabCtrl [MFC], GetFirstVisibleTabNum", "CMFCBaseTabCtrl [MFC], GetHighlightedTab", "CMFCBaseTabCtrl [MFC], GetImageList", "CMFCBaseTabCtrl [MFC], GetImageSize", "CMFCBaseTabCtrl [MFC], GetLastVisibleTab", "CMFCBaseTabCtrl [MFC], GetLocation", "CMFCBaseTabCtrl [MFC], GetMaxWindowSize", "CMFCBaseTabCtrl [MFC], GetTabArea", "CMFCBaseTabCtrl [MFC], GetTabBkColor", "CMFCBaseTabCtrl [MFC], GetTabBorderSize", "CMFCBaseTabCtrl [MFC], GetTabByID", "CMFCBaseTabCtrl [MFC], GetTabCloseButton", "CMFCBaseTabCtrl [MFC], GetTabFromHwnd", "CMFCBaseTabCtrl [MFC], GetTabFromPoint", "CMFCBaseTabCtrl [MFC], GetTabFullWidth", "CMFCBaseTabCtrl [MFC], GetTabHicon", "CMFCBaseTabCtrl [MFC], GetTabID", "CMFCBaseTabCtrl [MFC], GetTabIcon", "CMFCBaseTabCtrl [MFC], GetTabLabel", "CMFCBaseTabCtrl [MFC], GetTabRect", "CMFCBaseTabCtrl [MFC], GetTabsHeight", "CMFCBaseTabCtrl [MFC], GetTabsRect", "CMFCBaseTabCtrl [MFC], GetTabTextColor", "CMFCBaseTabCtrl [MFC], GetTabWnd", "CMFCBaseTabCtrl [MFC], GetTabWndNoWrapper", "CMFCBaseTabCtrl [MFC], GetTabsNum", "CMFCBaseTabCtrl [MFC], GetToolTipCtrl", "CMFCBaseTabCtrl [MFC], GetVisibleTabsNum", "CMFCBaseTabCtrl [MFC], HasImage", "CMFCBaseTabCtrl [MFC], HideSingleTab", "CMFCBaseTabCtrl [MFC], InsertTab", "CMFCBaseTabCtrl [MFC], InvalidateTab", "CMFCBaseTabCtrl [MFC], IsActiveTabCloseButton", "CMFCBaseTabCtrl [MFC], IsAutoColor", "CMFCBaseTabCtrl [MFC], IsAutoDestroyWindow", "CMFCBaseTabCtrl [MFC], IsColored", "CMFCBaseTabCtrl [MFC], IsDialogControl", "CMFCBaseTabCtrl [MFC], IsDrawNoPrefix", "CMFCBaseTabCtrl [MFC], IsFlatFrame", "CMFCBaseTabCtrl [MFC], IsFlatTab", "CMFCBaseTabCtrl [MFC], IsHideSingleTab", "CMFCBaseTabCtrl [MFC], IsIconAdded", "CMFCBaseTabCtrl [MFC], IsInPlaceEdit", "CMFCBaseTabCtrl [MFC], IsLeftRightRounded", "CMFCBaseTabCtrl [MFC], IsMDITab", "CMFCBaseTabCtrl [MFC], IsOneNoteStyle", "CMFCBaseTabCtrl [MFC], IsPtInTabArea", "CMFCBaseTabCtrl [MFC], IsTabCloseButtonHighlighted", "CMFCBaseTabCtrl [MFC], IsTabCloseButtonPressed", "CMFCBaseTabCtrl [MFC], IsTabDetachable", "CMFCBaseTabCtrl [MFC], IsTabIconOnly", "CMFCBaseTabCtrl [MFC], IsTabSwapEnabled", "CMFCBaseTabCtrl [MFC], IsTabVisible", "CMFCBaseTabCtrl [MFC], IsVS2005Style", "CMFCBaseTabCtrl [MFC], MoveTab", "CMFCBaseTabCtrl [MFC], OnChangeTabs", "CMFCBaseTabCtrl [MFC], OnDragEnter", "CMFCBaseTabCtrl [MFC], OnDragLeave", "CMFCBaseTabCtrl [MFC], OnDragOver", "CMFCBaseTabCtrl [MFC], OnDrop", "CMFCBaseTabCtrl [MFC], OnRenameTab", "CMFCBaseTabCtrl [MFC], PreTranslateMessage", "CMFCBaseTabCtrl [MFC], RecalcLayout", "CMFCBaseTabCtrl [MFC], RemoveAllTabs", "CMFCBaseTabCtrl [MFC], RemoveTab", "CMFCBaseTabCtrl [MFC], RenameTab", "CMFCBaseTabCtrl [MFC], ResetImageList", "CMFCBaseTabCtrl [MFC], Serialize", "CMFCBaseTabCtrl [MFC], SetActiveTab", "CMFCBaseTabCtrl [MFC], SetActiveTabColor", "CMFCBaseTabCtrl [MFC], SetActiveTabTextColor", "CMFCBaseTabCtrl [MFC], SetAutoColors", "CMFCBaseTabCtrl [MFC], SetDockingBarWrapperRTC", "CMFCBaseTabCtrl [MFC], SetDrawNoPrefix", "CMFCBaseTabCtrl [MFC], SetImageList", "CMFCBaseTabCtrl [MFC], SetLocation", "CMFCBaseTabCtrl [MFC], SetTabBkColor", "CMFCBaseTabCtrl [MFC], SetTabBorderSize", "CMFCBaseTabCtrl [MFC], SetTabHicon", "CMFCBaseTabCtrl [MFC], SetTabIcon", "CMFCBaseTabCtrl [MFC], SetTabIconOnly", "CMFCBaseTabCtrl [MFC], SetTabLabel", "CMFCBaseTabCtrl [MFC], SetTabsHeight", "CMFCBaseTabCtrl [MFC], SetTabTextColor", "CMFCBaseTabCtrl [MFC], SetTabsOrder", "CMFCBaseTabCtrl [MFC], ShowTab", "CMFCBaseTabCtrl [MFC], StartRenameTab", "CMFCBaseTabCtrl [MFC], SwapTabs", "CMFCBaseTabCtrl [MFC], CreateWrapper", "CMFCBaseTabCtrl [MFC], m_bActivateTabOnRightClick", "CMFCBaseTabCtrl [MFC], m_bAutoDestroyWindow"] --- @@ -1756,7 +1756,7 @@ virtual void SetActiveTabColor(COLORREF clr); ### Remarks -The framework obtains the default background color for active tabs from the [GetSysColor](/windows/win32/api/winuser/nf-winuser-getsyscolor)method. +The framework obtains the default background color for active tabs from the [GetSysColor](/windows/win32/api/winuser/nf-winuser-getsyscolor) method. ## CMFCBaseTabCtrl::SetActiveTabTextColor diff --git a/docs/mfc/reference/cmfcbutton-class.md b/docs/mfc/reference/cmfcbutton-class.md index 5e3103d3174..a244e55d07e 100644 --- a/docs/mfc/reference/cmfcbutton-class.md +++ b/docs/mfc/reference/cmfcbutton-class.md @@ -11,7 +11,7 @@ The `CMFCButton` class adds functionality to the [`CButton`](../../mfc/reference ## Syntax -``` +```cpp class CMFCButton : public CButton ``` @@ -45,7 +45,7 @@ class CMFCButton : public CButton |[`CMFCButton::IsPushed`](#ispushed)|Indicates whether a button is pushed.| |[`CMFCButton::IsRadioButton`](#isradiobutton)|Indicates whether a button is a radio button.| |[`CMFCButton::IsWindowsThemingEnabled`](#iswindowsthemingenabled)|Indicates whether the style of the button border corresponds to the current Windows theme.| -|`CMFCButton::OnDrawParentBackground`|Draws the background of a button's parent in the specified area. (Overrides [`AFX_GLOBAL_DATA::DrawParentBackground`](../../mfc/reference/afx-global-data-structure.md)| +|`CMFCButton::OnDrawParentBackground`|Draws the background of a button's parent in the specified area. (Overrides [`AFX_GLOBAL_DATA::DrawParentBackground`](../../mfc/reference/afx-global-data-structure.md).)| |`CMFCButton::PreTranslateMessage`|Translates window messages before they are dispatched to the [`TranslateMessage`](/windows/win32/api/winuser/nf-winuser-translatemessage) and [`DispatchMessage`](/windows/win32/api/winuser/nf-winuser-dispatchmessage) Windows functions. (Overrides [`CWnd::PreTranslateMessage`](../../mfc/reference/cwnd-class.md#pretranslatemessage).)| |[`CMFCButton::SetAutorepeatMode`](#setautorepeatmode)|Sets a button to auto-repeat mode.| |[`CMFCButton::SetCheckedImage`](#setcheckedimage)|Sets the image for a checked button.| @@ -78,8 +78,8 @@ class CMFCButton : public CButton |[`CMFCButton::m_bDontUseWinXPTheme`](#m_bDontUseWinXPTheme)|Specifies whether to use Windows XP themes.| |[`CMFCButton::m_bDrawFocus`](#m_bdrawfocus)|Indicates whether to draw a focus rectangle around a button.| |[`CMFCButton::m_nFlatStyle`](#m_nflatstyle)|Specifies the style of the button, such as borderless, flat, semi-flat, or 3D.| -|[`CMFCButton::m_bGrayDisabled`](#m_bGrayDisabled)|When TRUE, enables a disabled button to be drawn as grayed-out.| -|[`CMFCButton::m_bHighlightChecked`](#m_bhighlightchecked)|Indicates whether to highlight a BS_CHECKBOX-style button when the cursor hovers over it.| +|[`CMFCButton::m_bGrayDisabled`](#m_bGrayDisabled)|When `TRUE`, enables a disabled button to be drawn as grayed-out.| +|[`CMFCButton::m_bHighlightChecked`](#m_bhighlightchecked)|Indicates whether to highlight a `BS_CHECKBOX`-style button when the cursor hovers over it.| |[`CMFCButton::m_bResponseOnButtonDown`](#m_bResponseOnButtonDown)|Indicates whether to respond to button down events.| |[`CMFCButton::m_bRightImage`](#m_brightimage)|Indicates whether to display an image on the right side of the button.| |[`CMFCButton::m_bTopImage`](#m_bTopImage)| Indicates whether the image is on top of the button.| @@ -125,7 +125,7 @@ The following example demonstrates how to configure the properties of the button Resets internal variables and frees allocated resources such as images, bitmaps, and icons. -``` +```cpp virtual void CleanUp(); ``` @@ -139,11 +139,9 @@ void EnableFullTextTooltip(BOOL bOn=TRUE); ### Parameters -*`bOn`*
+*`bOn`*\ [in] `TRUE` to display all of the text; `FALSE` to display truncated text. -### Remarks - ## `CMFCButton::EnableMenuFont` Specifies whether the button text font is the same as the application menu font. @@ -156,10 +154,10 @@ void EnableMenuFont( ### Parameters -*`bOn`*
+*`bOn`*\ [in] `TRUE` to use the application menu font as the button text font; `FALSE` to use the system font. The default is `TRUE`. -*`bRedraw`*
+*`bRedraw`*\ [in] `TRUE` to immediately redraw the screen; otherwise, `FALSE`. The default is `TRUE`. ### Remarks @@ -170,13 +168,13 @@ If you do not use this method to specify the button text font, you can specify t Specifies whether the style of the button border corresponds to the current Windows theme. -``` +```cpp static void EnableWindowsTheming(BOOL bEnable = TRUE); ``` ### Parameters -*`bEnable`*
+*`bEnable`*\ [in] `TRUE` to use the current Windows theme to draw button borders; `FALSE` to not use the Windows theme. The default is `TRUE`. ### Remarks @@ -187,7 +185,7 @@ This method affects all buttons in your application that are derived from the `C Returns a reference to the underlying tooltip control. -``` +```cpp CToolTipCtrl& GetToolTipCtrl(); ``` @@ -195,13 +193,11 @@ CToolTipCtrl& GetToolTipCtrl(); A reference to the underlying tooltip control. -### Remarks - ## `CMFCButton::IsAutoCheck` Indicates whether a check box or radio button is an automatic button. -``` +```cpp BOOL IsAutoCheck() const; ``` @@ -209,13 +205,11 @@ BOOL IsAutoCheck() const; `TRUE` if the button has style `BS_AUTOCHECKBOX` or `BS_AUTORADIOBUTTON`; otherwise, `FALSE`. -### Remarks - ## `CMFCButton::IsAutorepeatCommandMode` Indicates whether a button is set to auto-repeat mode. -``` +```cpp BOOL IsAutorepeatCommandMode() const; ``` @@ -231,7 +225,7 @@ Use the [`CMFCButton::SetAutorepeatMode`](#setautorepeatmode) method to set a bu Indicates whether a button is a check box button. -``` +```cpp BOOL IsCheckBox() const; ``` @@ -239,13 +233,11 @@ BOOL IsCheckBox() const; `TRUE` if the button has either `BS_CHECKBOX` or `BS_AUTOCHECKBOX` style; otherwise, `FALSE`. -### Remarks - ## `CMFCButton::IsChecked` Indicates whether the current button is checked. -``` +```cpp BOOL IsChecked() const; ``` @@ -261,7 +253,7 @@ The framework uses different ways to indicate that different kinds of buttons ar Indicates whether a button is highlighted. -``` +```cpp BOOL IsHighlighted() const; ``` @@ -277,7 +269,7 @@ A button becomes highlighted when the mouse hovers over the button. Indicates whether a button is pushed and highlighted. -``` +```cpp BOOL IsPressed() const; ``` @@ -285,13 +277,11 @@ BOOL IsPressed() const; `TRUE` if the button is pressed; otherwise, `FALSE`. -### Remarks - ## `CMFCButton::IsPushed` Indicates whether a button is pushed. -``` +```cpp BOOL IsPushed() const; ``` @@ -299,13 +289,11 @@ BOOL IsPushed() const; `TRUE` if the button is pushed; otherwise, `FALSE`. -### Remarks - ## `CMFCButton::IsRadioButton` Indicates whether a button is a radio button. -``` +```cpp BOOL IsRadioButton() const; ``` @@ -313,13 +301,11 @@ BOOL IsRadioButton() const; `TRUE` if the button style is `BS_RADIOBUTTON` or `BS_AUTORADIOBUTTON`; otherwise, `FALSE`. -### Remarks - ## `CMFCButton::IsWindowsThemingEnabled` Indicates whether the style of the button border corresponds to the current Windows theme. -``` +```cpp static BOOL IsWindowsThemingEnabled(); ``` @@ -331,7 +317,7 @@ static BOOL IsWindowsThemingEnabled(); Specifies whether to use Windows XP themes when drawing the button. -``` +```cpp BOOL m_bDontUseWinXPTheme; ``` @@ -339,7 +325,7 @@ BOOL m_bDontUseWinXPTheme; Indicates whether to draw a focus rectangle around a button. -``` +```cpp BOOL m_bDrawFocus; ``` @@ -353,7 +339,7 @@ The `CMFCButton` constructor initializes this member to `TRUE`. When `TRUE`, enables a disabled button to be drawn as grayed-out. -``` +```cpp BOOL m_bGrayDisabled; ``` @@ -361,7 +347,7 @@ BOOL m_bGrayDisabled; Indicates whether to highlight a `BS_CHECKBOX`-style button when the cursor hovers over it. -``` +```cpp BOOL m_bHighlightChecked; ``` @@ -373,7 +359,7 @@ Set the `m_bHighlightChecked` member to `TRUE` to specify that the framework wil Indicates whether to respond to button down events. -``` +```cpp BOOL m_bResponseOnButtonDown; ``` @@ -381,15 +367,15 @@ BOOL m_bResponseOnButtonDown; Indicates whether to display an image on the right side of the button. -``` +```cpp BOOL m_bRightImage; ``` -## `CMFCButton::m_bTopImage](#m_bTopImage)` +## `CMFCButton::m_bTopImage` Indicates whether the image is on top of the button. -``` +```cpp BOOL m_bTopImage; ``` @@ -401,7 +387,7 @@ Set the `m_bRightImage` member to `TRUE` to specify that the framework will disp Indicates whether the button is transparent. -``` +```cpp BOOL m_bTransparent; ``` @@ -413,7 +399,7 @@ Set the `m_bTransparent` member to `TRUE` to specify that the framework will mak Specifies the alignment of the button text. -``` +```cpp AlignStyle m_nAlignStyle; ``` @@ -429,11 +415,11 @@ Use one of the following `CMFCButton::AlignStyle` enumeration values to specify The `CMFCButton` constructor initializes this member to `ALIGN_CENTER`. -## `CMFCButton::m_bWasDblClk`](#m_bWasDblClk)| +## `CMFCButton::m_bWasDblClk` -Indicates whether the last click event was a double-click.| +Indicates whether the last click event was a double-click. -``` +```cpp BOOL m_bWasDblClk; ``` @@ -441,8 +427,8 @@ BOOL m_bWasDblClk; Specifies the style of the button, such as borderless, flat, semi-flat, or 3D. -``` -FlatStyle m_nFlatStyle; +```cpp +FlatStyle m_nFlatStyle; ``` ### Remarks @@ -469,7 +455,7 @@ The following example demonstrates how to set the values of the `m_nFlatStyle` m Called by the framework to draw a button. -``` +```cpp virtual void OnDraw( CDC* pDC, const CRect& rect, @@ -478,13 +464,13 @@ virtual void OnDraw( ### Parameters -*`pDC`*
+*`pDC`*\ [in] A pointer to a device context. -*`rect`*
+*`rect`*\ [in] A reference to a rectangle that bounds the button. -*`uiState`*
+*`uiState`*\ [in] The current button state. For more information, see the `itemState` member of the [`DRAWITEMSTRUCT` Structure](/windows/win32/api/winuser/ns-winuser-drawitemstruct) topic. ### Remarks @@ -495,7 +481,7 @@ Override this method to use your own code to draw a button. Called by the framework to draw the border of a button. -``` +```cpp virtual void OnDrawBorder( CDC* pDC, CRect& rectClient, @@ -504,13 +490,13 @@ virtual void OnDrawBorder( ### Parameters -*`pDC`*
+*`pDC`*\ [in] A pointer to a device context. -*`rectClient`*
+*`rectClient`*\ [in] A reference to a rectangle that bounds the button. -*`uiState`*
+*`uiState`*\ [in] The current button state. For more information, see the `itemState` member of the [`DRAWITEMSTRUCT` Structure](/windows/win32/api/winuser/ns-winuser-drawitemstruct) topic. ### Remarks @@ -521,7 +507,7 @@ Override this method to use your own code to draw the border. Called by the framework to draw the focus rectangle for a button. -``` +```cpp virtual void OnDrawFocusRect( CDC* pDC, const CRect& rectClient); @@ -529,10 +515,10 @@ virtual void OnDrawFocusRect( ### Parameters -*`pDC`*
+*`pDC`*\ [in] A pointer to a device context. -*`rectClient`*
+*`rectClient`*\ [in] A reference to a rectangle that bounds the button. ### Remarks @@ -543,7 +529,7 @@ Override this method to use your own code to draw the focus rectangle. Called by the framework to draw the button text. -``` +```cpp virtual void OnDrawText( CDC* pDC, const CRect& rect, @@ -554,19 +540,19 @@ virtual void OnDrawText( ### Parameters -*`pDC`*
+*`pDC`*\ [in] A pointer to a device context. -*`rect`*
+*`rect`*\ [in] A reference to a rectangle that bounds the button. -*`strText`*
+*`strText`*\ [in] The text to draw. -*`uiDTFlags`*
+*`uiDTFlags`*\ [in] Flags that specify how to format the text. For more information, see the *`nFormat`* parameter of the [`CDC::DrawText`](../../mfc/reference/cdc-class.md#drawtext) method. -*`uiState`*
+*`uiState`*\ [in] Reserved. ### Remarks @@ -577,7 +563,7 @@ Override this method to use your own code to draw the button text. Called by the framework to draw the background of the button text. -``` +```cpp virtual void OnFillBackground( CDC* pDC, const CRect& rectClient); @@ -585,10 +571,10 @@ virtual void OnFillBackground( ### Parameters -*`pDC`*
+*`pDC`*\ [in] A pointer to a device context. -*`rectClient`*
+*`rectClient`*\ [in] A reference to a rectangle that bounds the button. ### Remarks @@ -599,21 +585,19 @@ Override this method to use your own code to draw the background of a button. Retrieves the font that is associated with the specified device context. -``` +```cpp virtual CFont* SelectFont(CDC* pDC); ``` ### Parameters -*`pDC`*
+*`pDC`*\ [in] A pointer to a device context. ### Return Value Override this method to use your own code to retrieve the font. -### Remarks - ## `CMFCButton::SetAutorepeatMode` Sets a button to auto-repeat mode. @@ -624,7 +608,7 @@ void SetAutorepeatMode(int nTimeDelay=500); ### Parameters -*`nTimeDelay`*
+*`nTimeDelay`*\ [in] A nonnegative number that specifies the interval between messages that are sent to the parent window. The interval is measured in milliseconds and its default value is 500 milliseconds. Specify zero to disable auto-repeat message mode. ### Remarks @@ -658,44 +642,42 @@ void SetCheckedImage( ### Parameters -*`hIcon`*
+*`hIcon`*\ [in] Handle to the icon that contains the bitmap and mask for the new image. -*`bAutoDestroy`*
+*`bAutoDestroy`*\ [in] `TRUE` to specify that bitmap resources be destroyed automatically; otherwise, `FALSE`. The default is `TRUE`. -*`hIconHot`*
+*`hIconHot`*\ [in] Handle to the icon that contains the image for the selected state. -*`hBitmap`*
+*`hBitmap`*\ [in] Handle to the bitmap that contains the image for the non-selected state. -*`hBitmapHot`*
+*`hBitmapHot`*\ [in] Handle to the bitmap that contains the image for the selected state. -*`bMap3dColors`*
+*`bMap3dColors`*\ [in] Specifies a transparent color for the button background; that is, the face of the button. `TRUE` to use the color value RGB(192, 192, 192); `FALSE` to use the color value defined by `AFX_GLOBAL_DATA::clrBtnFace`. -*`uiBmpResId`*
+*`uiBmpResId`*\ [in] Resource ID for the non-selected image. -*`uiBmpHotResId`*
+*`uiBmpHotResId`*\ [in] Resource ID for the selected image. -*`hIconDisabled`*
+*`hIconDisabled`*\ [in] Handle to the icon for the disabled image. -*`hBitmapDisabled`*
+*`hBitmapDisabled`*\ [in] Handle to the bitmap that contains the disabled image. -*`uiBmpDsblResID`*
+*`uiBmpDsblResID`*\ [in] Resource ID of the disabled bitmap. -*`bAlphaBlend`*
+*`bAlphaBlend`*\ [in] `TRUE` to use only 32-bit images that use the alpha channel; `FALSE`, to not use only alpha channel images. The default is `FALSE`. -### Remarks - ## `CMFCButton::SetFaceColor` Sets the background color for the button text. @@ -708,17 +690,17 @@ void SetFaceColor( ### Parameters -*`crFace`*
+*`crFace`*\ [in] An RGB color value. -*`bRedraw`*
+*`bRedraw`*\ [in] `TRUE` to redraw the screen immediately; otherwise, `FALSE`. ### Remarks Use this method to define a new fill color for the button background (face). Note that the background is not filled when the [`CMFCButton::m_bTransparent`](#m_btransparent) member variable is `TRUE`. -## CMFCButton::SetImage +## `CMFCButton::SetImage` Sets the image for a button. @@ -745,44 +727,42 @@ void SetImage( ### Parameters -*`hIcon`*
+*`hIcon`*\ [in] Handle to the icon that contains the bitmap and mask for the new image. -*`bAutoDestroy`*
+*`bAutoDestroy`*\ [in] `TRUE` to specify that bitmap resources be destroyed automatically; otherwise, `FALSE`. The default is `TRUE`. -*`hIconHot`*
+*`hIconHot`*\ [in] Handle to the icon that contains the image for the selected state. -*`hBitmap`*
+*`hBitmap`*\ [in] Handle to the bitmap that contains the image for the non-selected state. -*`hBitmapHot`*
+*`hBitmapHot`*\ [in] Handle to the bitmap that contains the image for the selected state. -*`uiBmpResId`*
+*`uiBmpResId`*\ [in] Resource ID for the non-selected image. -*`uiBmpHotResId`*
+*`uiBmpHotResId`*\ [in] Resource ID for the selected image. -*`bMap3dColors`*
+*`bMap3dColors`*\ [in] Specifies a transparent color for the button background; that is, the face of the button. `TRUE` to use the color value RGB(192, 192, 192); `FALSE` to use the color value defined by `AFX_GLOBAL_DATA::clrBtnFace`. -*`hIconDisabled`*
+*`hIconDisabled`*\ [in] Handle to the icon for the disabled image. -*`hBitmapDisabled`*
+*`hBitmapDisabled`*\ [in] Handle to the bitmap that contains the disabled image. -*`uiBmpDsblResID`*
+*`uiBmpDsblResID`*\ [in] Resource ID of the disabled bitmap. -*`bAlphaBlend`*
+*`bAlphaBlend`*\ [in] `TRUE` to use only 32-bit images that use the alpha channel; `FALSE`, to not use only alpha channel images. The default is `FALSE`. -### Remarks - ### Example The following example demonstrates how to use various versions of the `SetImage` method in the `CMFCButton` class. The example is part of the [New Controls sample](../../overview/visual-cpp-samples.md). @@ -800,7 +780,7 @@ void SetMouseCursor(HCURSOR hcursor); ### Parameters -*`hcursor`*
+*`hcursor`*\ [in] The handle of a cursor. ### Remarks @@ -839,16 +819,14 @@ void SetStdImage( ### Parameters -*`id`*
+*`id`*\ [in] One of the button image identifiers that is defined in the `CMenuImage::IMAGES_IDS` enumeration. The image values specify images such as arrows, pins, and radio buttons. -*`state`*
+*`state`*\ [in] One of the button image state identifiers that is defined in the `CMenuImages::IMAGE_STATE` enumeration. The image states specify button colors such as black, gray, light gray, white, and dark gray. The default value is `CMenuImages::ImageBlack`. -*`idDisabled`*
-[in] One of the button image identifiers that is defined in the `CMenuImage::IMAGES_IDS` enumeration. The image indicates that the button is disabled. The default value is the first button image ( `CMenuImages::IdArrowDown`). - -### Remarks +*`idDisabled`*\ +[in] One of the button image identifiers that is defined in the `CMenuImage::IMAGES_IDS` enumeration. The image indicates that the button is disabled. The default value is the first button image (`CMenuImages::IdArrowDown`). ## `CMFCButton::SetTextColor` @@ -860,11 +838,9 @@ void SetTextColor(COLORREF clrText); ### Parameters -*`clrText`*
+*`clrText`*\ [in] An RGB color value. -### Remarks - ## `CMFCButton::SetTextHotColor` Sets the color of the button text for a button that is selected. @@ -875,11 +851,9 @@ void SetTextHotColor(COLORREF clrTextHot); ### Parameters -*`clrTextHot`*
+*`clrTextHot`*\ [in] An RGB color value. -### Remarks - ## `CMFCButton::SetTooltip` Associates a tooltip with a button. @@ -890,22 +864,20 @@ void SetTooltip(LPCTSTR lpszToolTipText); ### Parameters -*`lpszToolTipText`*
+*`lpszToolTipText`*\ [in] Pointer to the text for the tooltip. Specify `NULL` to disable the tooltip. -### Remarks - ## `CMFCButton::SizeToContent` Resizes a button to contain its button text and image. -``` +```cpp virtual CSize SizeToContent(BOOL bCalcOnly=FALSE); ``` ### Parameters -*`bCalcOnly`*
+*`bCalcOnly`*\ [in] `TRUE` to calculate, but not change, the new size of the button; `FALSE` to change the size of the button. The default is `FALSE`. ### Return Value diff --git a/docs/mfc/reference/cmfcdynamiclayout-class.md b/docs/mfc/reference/cmfcdynamiclayout-class.md index 0c8f47f3f09..c41f1893c72 100644 --- a/docs/mfc/reference/cmfcdynamiclayout-class.md +++ b/docs/mfc/reference/cmfcdynamiclayout-class.md @@ -1,9 +1,8 @@ --- -description: "Learn more about: CMFCDynamicLayout Class" title: "CMFCDynamicLayout Class" +description: "Learn more about: CMFCDynamicLayout Class" ms.date: "08/29/2019" f1_keywords: ["CMFCDynamicLayout", "AFXLAYOUT/CMFCDynamicLayout", "AFXLAYOUT/CMFCDynamicLayout::AddItem", "AFXLAYOUT/CMFCDynamicLayout::Adjust", "AFXLAYOUT/CMFCDynamicLayout::Create", "AFXLAYOUT/CMFCDynamicLayout::GetHostWnd", "AFXLAYOUT/CMFCDynamicLayout::GetMinSize", "AFXLAYOUT/CMFCDynamicLayout::GetWindowRect", "AFXLAYOUT/CMFCDynamicLayout::HasItem", "AFXLAYOUT/CMFCDynamicLayout::IsEmpty", "AFXLAYOUT/CMFCDynamicLayout::LoadResource", "AFXLAYOUT/CMFCDynamicLayout::SetMinSize"] -ms.assetid: c2df2976-f049-47fc-9cf0-abe3e01948bc --- # CMFCDynamicLayout Class @@ -170,7 +169,7 @@ The position and size of a child control is changed dynamically when a hosting w Retrieves the rectangle for the window's current client area. ```cpp -void GetHostWndRect(CRect& rect,); +void GetHostWndRect(CRect& rect); ``` ### Parameters @@ -503,5 +502,5 @@ A [SizeSettings](#sizesettings_structure) value that encapsulates the requested ## See also -[Hierarchy Chart](../../mfc/hierarchy-chart.md)
+[Hierarchy Chart](../../mfc/hierarchy-chart.md)\ [Classes](../../mfc/reference/mfc-classes.md) diff --git a/docs/mfc/reference/cmfceditbrowsectrl-class.md b/docs/mfc/reference/cmfceditbrowsectrl-class.md index 4674427de8b..c24728b72e6 100644 --- a/docs/mfc/reference/cmfceditbrowsectrl-class.md +++ b/docs/mfc/reference/cmfceditbrowsectrl-class.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: CMFCEditBrowseCtrl Class" title: "CMFCEditBrowseCtrl Class" -ms.date: "11/04/2016" +description: "Learn more about: CMFCEditBrowseCtrl Class" +ms.date: 11/04/2016 f1_keywords: ["CMFCEditBrowseCtrl", "AFXEDITBROWSECTRL/CMFCEditBrowseCtrl", "AFXEDITBROWSECTRL/CMFCEditBrowseCtrl::EnableBrowseButton", "AFXEDITBROWSECTRL/CMFCEditBrowseCtrl::EnableFileBrowseButton", "AFXEDITBROWSECTRL/CMFCEditBrowseCtrl::EnableFolderBrowseButton", "AFXEDITBROWSECTRL/CMFCEditBrowseCtrl::GetMode", "AFXEDITBROWSECTRL/CMFCEditBrowseCtrl::OnAfterUpdate", "AFXEDITBROWSECTRL/CMFCEditBrowseCtrl::OnBrowse", "AFXEDITBROWSECTRL/CMFCEditBrowseCtrl::OnChangeLayout", "AFXEDITBROWSECTRL/CMFCEditBrowseCtrl::OnDrawBrowseButton", "AFXEDITBROWSECTRL/CMFCEditBrowseCtrl::OnIllegalFileName", "AFXEDITBROWSECTRL/CMFCEditBrowseCtrl::SetBrowseButtonImage"] helpviewer_keywords: ["CMFCEditBrowseCtrl [MFC], EnableBrowseButton", "CMFCEditBrowseCtrl [MFC], EnableFileBrowseButton", "CMFCEditBrowseCtrl [MFC], EnableFolderBrowseButton", "CMFCEditBrowseCtrl [MFC], GetMode", "CMFCEditBrowseCtrl [MFC], OnAfterUpdate", "CMFCEditBrowseCtrl [MFC], OnBrowse", "CMFCEditBrowseCtrl [MFC], OnChangeLayout", "CMFCEditBrowseCtrl [MFC], OnDrawBrowseButton", "CMFCEditBrowseCtrl [MFC], OnIllegalFileName", "CMFCEditBrowseCtrl [MFC], SetBrowseButtonImage"] -ms.assetid: 69cfd886-3d35-4bee-8901-7c88fcf9520f --- # CMFCEditBrowseCtrl Class @@ -69,7 +68,7 @@ Perform the following steps to incorporate an edit browse control in your applic 1. Embed either the `CMFCEditBrowseCtrl` object or the derived edit browse control object into the parent window object. -1. If you use the **Class Wizard** to create a dialog box, add an edit control ( `CEdit`) to the dialog box form. Also, add a variable to access the control in your header file. In your header file, change the type of the variable from `CEdit` to `CMFCEditBrowseCtrl`. The edit browse control will be created automatically. If you do not use the **Class Wizard**, add a `CMFCEditBrowseCtrl` variable to your header file and then call its `Create` method. +1. If you use the **Class Wizard** to create a dialog box, add an edit control (`CEdit`) to the dialog box form. Also, add a variable to access the control in your header file. In your header file, change the type of the variable from `CEdit` to `CMFCEditBrowseCtrl`. The edit browse control will be created automatically. If you do not use the **Class Wizard**, add a `CMFCEditBrowseCtrl` variable to your header file and then call its `Create` method. 1. If you add an edit browse control to a dialog box, use the **ClassWizard** tool to set up data exchange. diff --git a/docs/mfc/reference/cmfcmenubar-class.md b/docs/mfc/reference/cmfcmenubar-class.md index b541ec3c640..8b8174252b0 100644 --- a/docs/mfc/reference/cmfcmenubar-class.md +++ b/docs/mfc/reference/cmfcmenubar-class.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: CMFCMenuBar Class" title: "CMFCMenuBar Class" +description: "Learn more about: CMFCMenuBar Class" ms.date: "10/18/2018" f1_keywords: ["CMFCMenuBar", "AFXMENUBAR/CMFCMenuBar", "AFXMENUBAR/CMFCMenuBar::AdjustLocations", "AFXMENUBAR/CMFCMenuBar::AllowChangeTextLabels", "AFXMENUBAR/CMFCMenuBar::AllowShowOnPaneMenu", "AFXMENUBAR/CMFCMenuBar::CalcFixedLayout", "AFXMENUBAR/CMFCMenuBar::CalcLayout", "AFXMENUBAR/CMFCMenuBar::CalcMaxButtonHeight", "AFXMENUBAR/CMFCMenuBar::CanBeClosed", "AFXMENUBAR/CMFCMenuBar::CanBeRestored", "AFXMENUBAR/CMFCMenuBar::Create", "AFXMENUBAR/CMFCMenuBar::CreateEx", "AFXMENUBAR/CMFCMenuBar::CreateFromMenu", "AFXMENUBAR/CMFCMenuBar::EnableHelpCombobox", "AFXMENUBAR/CMFCMenuBar::EnableMenuShadows", "AFXMENUBAR/CMFCMenuBar::GetAvailableExpandSize", "AFXMENUBAR/CMFCMenuBar::GetColumnWidth", "AFXMENUBAR/CMFCMenuBar::GetDefaultMenu", "AFXMENUBAR/CMFCMenuBar::GetDefaultMenuResId", "AFXMENUBAR/CMFCMenuBar::GetFloatPopupDirection", "AFXMENUBAR/CMFCMenuBar::GetForceDownArrows", "AFXMENUBAR/CMFCMenuBar::GetHelpCombobox", "AFXMENUBAR/CMFCMenuBar::GetHMenu", "AFXMENUBAR/CMFCMenuBar::GetMenuFont", "AFXMENUBAR/CMFCMenuBar::GetMenuItem", "AFXMENUBAR/CMFCMenuBar::GetRowHeight", "AFXMENUBAR/CMFCMenuBar::GetSystemButton", "AFXMENUBAR/CMFCMenuBar::GetSystemButtonsCount", "AFXMENUBAR/CMFCMenuBar::GetSystemMenu", "AFXMENUBAR/CMFCMenuBar::HighlightDisabledItems", "AFXMENUBAR/CMFCMenuBar::IsButtonExtraSizeAvailable", "AFXMENUBAR/CMFCMenuBar::IsHighlightDisabledItems", "AFXMENUBAR/CMFCMenuBar::IsMenuShadows", "AFXMENUBAR/CMFCMenuBar::IsRecentlyUsedMenus", "AFXMENUBAR/CMFCMenuBar::IsShowAllCommands", "AFXMENUBAR/CMFCMenuBar::IsShowAllCommandsDelay", "AFXMENUBAR/CMFCMenuBar::LoadState", "AFXMENUBAR/CMFCMenuBar::OnChangeHot", "AFXMENUBAR/CMFCMenuBar::OnDefaultMenuLoaded", "AFXMENUBAR/CMFCMenuBar::OnSendCommand", "AFXMENUBAR/CMFCMenuBar::OnSetDefaultButtonText", "AFXMENUBAR/CMFCMenuBar::OnToolHitTest", "AFXMENUBAR/CMFCMenuBar::PreTranslateMessage", "AFXMENUBAR/CMFCMenuBar::RestoreOriginalstate", "AFXMENUBAR/CMFCMenuBar::SaveState", "AFXMENUBAR/CMFCMenuBar::SetDefaultMenuResId", "AFXMENUBAR/CMFCMenuBar::SetForceDownArrows", "AFXMENUBAR/CMFCMenuBar::SetMaximizeMode", "AFXMENUBAR/CMFCMenuBar::SetMenuButtonRTC", "AFXMENUBAR/CMFCMenuBar::SetMenuFont", "AFXMENUBAR/CMFCMenuBar::SetRecentlyUsedMenus", "AFXMENUBAR/CMFCMenuBar::SetShowAllCommands"] helpviewer_keywords: ["CMFCMenuBar [MFC], AdjustLocations", "CMFCMenuBar [MFC], AllowChangeTextLabels", "CMFCMenuBar [MFC], AllowShowOnPaneMenu", "CMFCMenuBar [MFC], CalcFixedLayout", "CMFCMenuBar [MFC], CalcLayout", "CMFCMenuBar [MFC], CalcMaxButtonHeight", "CMFCMenuBar [MFC], CanBeClosed", "CMFCMenuBar [MFC], CanBeRestored", "CMFCMenuBar [MFC], Create", "CMFCMenuBar [MFC], CreateEx", "CMFCMenuBar [MFC], CreateFromMenu", "CMFCMenuBar [MFC], EnableHelpCombobox", "CMFCMenuBar [MFC], EnableMenuShadows", "CMFCMenuBar [MFC], GetAvailableExpandSize", "CMFCMenuBar [MFC], GetColumnWidth", "CMFCMenuBar [MFC], GetDefaultMenu", "CMFCMenuBar [MFC], GetDefaultMenuResId", "CMFCMenuBar [MFC], GetFloatPopupDirection", "CMFCMenuBar [MFC], GetForceDownArrows", "CMFCMenuBar [MFC], GetHelpCombobox", "CMFCMenuBar [MFC], GetHMenu", "CMFCMenuBar [MFC], GetMenuFont", "CMFCMenuBar [MFC], GetMenuItem", "CMFCMenuBar [MFC], GetRowHeight", "CMFCMenuBar [MFC], GetSystemButton", "CMFCMenuBar [MFC], GetSystemButtonsCount", "CMFCMenuBar [MFC], GetSystemMenu", "CMFCMenuBar [MFC], HighlightDisabledItems", "CMFCMenuBar [MFC], IsButtonExtraSizeAvailable", "CMFCMenuBar [MFC], IsHighlightDisabledItems", "CMFCMenuBar [MFC], IsMenuShadows", "CMFCMenuBar [MFC], IsRecentlyUsedMenus", "CMFCMenuBar [MFC], IsShowAllCommands", "CMFCMenuBar [MFC], IsShowAllCommandsDelay", "CMFCMenuBar [MFC], LoadState", "CMFCMenuBar [MFC], OnChangeHot", "CMFCMenuBar [MFC], OnDefaultMenuLoaded", "CMFCMenuBar [MFC], OnSendCommand", "CMFCMenuBar [MFC], OnSetDefaultButtonText", "CMFCMenuBar [MFC], OnToolHitTest", "CMFCMenuBar [MFC], PreTranslateMessage", "CMFCMenuBar [MFC], RestoreOriginalstate", "CMFCMenuBar [MFC], SaveState", "CMFCMenuBar [MFC], SetDefaultMenuResId", "CMFCMenuBar [MFC], SetForceDownArrows", "CMFCMenuBar [MFC], SetMaximizeMode", "CMFCMenuBar [MFC], SetMenuButtonRTC", "CMFCMenuBar [MFC], SetMenuFont", "CMFCMenuBar [MFC], SetRecentlyUsedMenus", "CMFCMenuBar [MFC], SetShowAllCommands"] -ms.assetid: 8a3ce4c7-b012-4dc0-b4f8-53c10b4b86b8 --- # CMFCMenuBar Class @@ -663,7 +662,7 @@ When you configure a menu bar to display recently used items, the menu bar displ - Display the full menu after the user clicks the arrow at the bottom of the menu. -By default, all `CMFCMenuBar` objects use the option to display the full menu after a short delay. This option cannot be changed programmatically in the `CMFCMenuBar` class. However, a user can change the behavior during toolbar customization by using the **Customize** dialog box.. +By default, all `CMFCMenuBar` objects use the option to display the full menu after a short delay. This option cannot be changed programmatically in the `CMFCMenuBar` class. However, a user can change the behavior during toolbar customization by using the **Customize** dialog box. ## CMFCMenuBar::LoadState @@ -977,6 +976,6 @@ If a menu does not display all the menu commands, it hides the commands that are ## See also -[Hierarchy Chart](../../mfc/hierarchy-chart.md)
-[Classes](../../mfc/reference/mfc-classes.md)
+[Hierarchy Chart](../../mfc/hierarchy-chart.md)\ +[Classes](../../mfc/reference/mfc-classes.md)\ [CMFCToolBar Class](../../mfc/reference/cmfctoolbar-class.md) diff --git a/docs/mfc/reference/cmfcpreviewctrlimpl-class.md b/docs/mfc/reference/cmfcpreviewctrlimpl-class.md index 22d3cb15833..0dc7d379523 100644 --- a/docs/mfc/reference/cmfcpreviewctrlimpl-class.md +++ b/docs/mfc/reference/cmfcpreviewctrlimpl-class.md @@ -1,18 +1,17 @@ --- -description: "Learn more about: CMFCPreviewCtrlImpl Class" title: "CMFCPreviewCtrlImpl Class" +description: "Learn more about: CMFCPreviewCtrlImpl Class" ms.date: "11/04/2016" f1_keywords: ["CMFCPreviewCtrlImpl", "AFXWIN/CMFCPreviewCtrlImpl", "AFXWIN/CMFCPreviewCtrlImpl::CMFCPreviewCtrlImpl", "AFXWIN/CMFCPreviewCtrlImpl::Create", "AFXWIN/CMFCPreviewCtrlImpl::Destroy", "AFXWIN/CMFCPreviewCtrlImpl::Focus", "AFXWIN/CMFCPreviewCtrlImpl::GetDocument", "AFXWIN/CMFCPreviewCtrlImpl::Redraw", "AFXWIN/CMFCPreviewCtrlImpl::SetDocument", "AFXWIN/CMFCPreviewCtrlImpl::SetHost", "AFXWIN/CMFCPreviewCtrlImpl::SetPreviewVisuals", "AFXWIN/CMFCPreviewCtrlImpl::SetRect", "AFXWIN/CMFCPreviewCtrlImpl::DoPaint", "AFXWIN/CMFCPreviewCtrlImpl::m_clrBackColor", "AFXWIN/CMFCPreviewCtrlImpl::m_clrTextColor", "AFXWIN/CMFCPreviewCtrlImpl::m_font", "AFXWIN/CMFCPreviewCtrlImpl::m_pDocument"] helpviewer_keywords: ["CMFCPreviewCtrlImpl [MFC], CMFCPreviewCtrlImpl", "CMFCPreviewCtrlImpl [MFC], Create", "CMFCPreviewCtrlImpl [MFC], Destroy", "CMFCPreviewCtrlImpl [MFC], Focus", "CMFCPreviewCtrlImpl [MFC], GetDocument", "CMFCPreviewCtrlImpl [MFC], Redraw", "CMFCPreviewCtrlImpl [MFC], SetDocument", "CMFCPreviewCtrlImpl [MFC], SetHost", "CMFCPreviewCtrlImpl [MFC], SetPreviewVisuals", "CMFCPreviewCtrlImpl [MFC], SetRect", "CMFCPreviewCtrlImpl [MFC], DoPaint", "CMFCPreviewCtrlImpl [MFC], m_clrBackColor", "CMFCPreviewCtrlImpl [MFC], m_clrTextColor", "CMFCPreviewCtrlImpl [MFC], m_font", "CMFCPreviewCtrlImpl [MFC], m_pDocument"] -ms.assetid: 06257fa0-54c9-478d-9d68-c9698c3f93ed --- -# CMFCPreviewCtrlImpl Class +# `CMFCPreviewCtrlImpl` Class This class implements a window that is placed on a host window provided by the Shell for Rich Preview. ## Syntax -``` +```cpp class CMFCPreviewCtrlImpl : public CWnd; ``` @@ -22,37 +21,37 @@ class CMFCPreviewCtrlImpl : public CWnd; |Name|Description| |----------|-----------------| -|[CMFCPreviewCtrlImpl::~CMFCPreviewCtrlImpl](#dtor)|Destructs a preview control object.| -|[CMFCPreviewCtrlImpl::CMFCPreviewCtrlImpl](#cmfcpreviewctrlimpl)|Constructs a preview control object.| +|[`CMFCPreviewCtrlImpl::~CMFCPreviewCtrlImpl`](#dtor)|Destructs a preview control object.| +|[`CMFCPreviewCtrlImpl::CMFCPreviewCtrlImpl`](#cmfcpreviewctrlimpl)|Constructs a preview control object.| ### Public Methods |Name|Description| |----------|-----------------| -|[CMFCPreviewCtrlImpl::Create](#create)|Overloaded. Called by a Rich Preview handler to create the Windows window.| -|[CMFCPreviewCtrlImpl::Destroy](#destroy)|Called by a Rich Preview handler when it needs to destroy this control.| -|[CMFCPreviewCtrlImpl::Focus](#focus)|Sets input focus to this control.| -|[CMFCPreviewCtrlImpl::GetDocument](#getdocument)|Returns a document connected to this preview control.| -|[CMFCPreviewCtrlImpl::Redraw](#redraw)|Tells this control to redraw.| -|[CMFCPreviewCtrlImpl::SetDocument](#setdocument)|Called by the preview handler to create a relationship between the document implementation and the preview control.| -|[CMFCPreviewCtrlImpl::SetHost](#sethost)|Sets a new parent for this control.| -|[CMFCPreviewCtrlImpl::SetPreviewVisuals](#setpreviewvisuals)|Called by a Rich Preview handler when it needs to set visuals of rich preview content.| -|[CMFCPreviewCtrlImpl::SetRect](#setrect)|Sets a new bounding rectangle for this control.| +|[`CMFCPreviewCtrlImpl::Create`](#create)|Overloaded. Called by a Rich Preview handler to create the Windows window.| +|[`CMFCPreviewCtrlImpl::Destroy`](#destroy)|Called by a Rich Preview handler when it needs to destroy this control.| +|[`CMFCPreviewCtrlImpl::Focus`](#focus)|Sets input focus to this control.| +|[`CMFCPreviewCtrlImpl::GetDocument`](#getdocument)|Returns a document connected to this preview control.| +|[`CMFCPreviewCtrlImpl::Redraw`](#redraw)|Tells this control to redraw.| +|[`CMFCPreviewCtrlImpl::SetDocument`](#setdocument)|Called by the preview handler to create a relationship between the document implementation and the preview control.| +|[`CMFCPreviewCtrlImpl::SetHost`](#sethost)|Sets a new parent for this control.| +|[`CMFCPreviewCtrlImpl::SetPreviewVisuals`](#setpreviewvisuals)|Called by a Rich Preview handler when it needs to set visuals of rich preview content.| +|[`CMFCPreviewCtrlImpl::SetRect`](#setrect)|Sets a new bounding rectangle for this control.| ### Protected Methods |Name|Description| |----------|-----------------| -|[CMFCPreviewCtrlImpl::DoPaint](#dopaint)|Called by the framework to render the preview.| +|[`CMFCPreviewCtrlImpl::DoPaint`](#dopaint)|Called by the framework to render the preview.| ### Protected Data Members |Name|Description| |----------|-----------------| -|[CMFCPreviewCtrlImpl::m_clrBackColor](#m_clrbackcolor)|Background color of preview window.| -|[CMFCPreviewCtrlImpl::m_clrTextColor](#m_clrtextcolor)|Text color of preview window.| -|[CMFCPreviewCtrlImpl::m_font](#m_font)|Font used to display text in the preview window.| -|[CMFCPreviewCtrlImpl::m_pDocument](#m_pdocument)|A pointer to a document whose content is previewed in the control.| +|[`CMFCPreviewCtrlImpl::m_clrBackColor`](#m_clrbackcolor)|Background color of preview window.| +|[`CMFCPreviewCtrlImpl::m_clrTextColor`](#m_clrtextcolor)|Text color of preview window.| +|[`CMFCPreviewCtrlImpl::m_font`](#m_font)|Font used to display text in the preview window.| +|[`CMFCPreviewCtrlImpl::m_pDocument`](#m_pdocument)|A pointer to a document whose content is previewed in the control.| ## Requirements @@ -60,99 +59,101 @@ class CMFCPreviewCtrlImpl : public CWnd; ## Inheritance Hierarchy -[CObject](../../mfc/reference/cobject-class.md) +[CObject](cobject-class.md) -[CCmdTarget](../../mfc/reference/ccmdtarget-class.md) +[CCmdTarget](ccmdtarget-class.md) -[CWnd](../../mfc/reference/cwnd-class.md) +[CWnd](cwnd-class.md) -[CMFCPreviewCtrlImpl](../../mfc/reference/cmfcpreviewctrlimpl-class.md) +[CMFCPreviewCtrlImpl](cmfcpreviewctrlimpl-class.md) -## CMFCPreviewCtrlImpl::CMFCPreviewCtrlImpl +## `CMFCPreviewCtrlImpl::CMFCPreviewCtrlImpl` Constructs a preview control object. ### Syntax +```cpp CMFCPreviewCtrlImpl(); +``` -## CMFCPreviewCtrlImpl::Create +## `CMFCPreviewCtrlImpl::Create` Overloaded. Called by a Rich Preview handler to create the Windows window. ### Syntax -``` +```cpp virtual BOOL Create( - HWND hWndParent, - const RECT* prc + HWND hWndParent, + const RECT* prc ); virtual BOOL Create( - HWND hWndParent, - const RECT* prc, - CCreateContext* pContext + HWND hWndParent, + const RECT* prc, + CCreateContext* pContext ); ``` ### Parameters -*hWndParent*
+*`hWndParent`*\ A handle to the host window supplied by the Shell for Rich Preview. -*prc*
+*`prc`*\ Specifies the initial size and position of the window. -*pContext*
+*`pContext`*\ A pointer to a creation context. ### Return Value -TRUE if creation succeeded; otherwise FALSE. +`TRUE` if creation succeeded; otherwise `FALSE`. -## CMFCPreviewCtrlImpl::Destroy +## `CMFCPreviewCtrlImpl::Destroy` Called by a Rich Preview handler when it needs to destroy this control. ### Syntax -``` +```cpp virtual void Destroy(); ``` -## CMFCPreviewCtrlImpl::DoPaint +## `CMFCPreviewCtrlImpl::DoPaint` Called by the framework to render the preview. ### Syntax -``` +```cpp virtual void DoPaint( - CPaintDC* pDC + CPaintDC* pDC ); ``` ### Parameters -*pDC*
+*`pDC`*\ A pointer to a device context for painting. -## CMFCPreviewCtrlImpl::Focus +## `CMFCPreviewCtrlImpl::Focus` Sets input focus to this control. ### Syntax -``` +```cpp virtual void Focus(); ``` -## CMFCPreviewCtrlImpl::GetDocument +## `CMFCPreviewCtrlImpl::GetDocument` Returns a document connected to this preview control. ### Syntax -``` +```cpp ATL::IDocument* GetDocument(); ``` @@ -160,55 +161,57 @@ ATL::IDocument* GetDocument(); A pointer to a document, whose content is previewed in the control. -## CMFCPreviewCtrlImpl::m_clrBackColor +## `CMFCPreviewCtrlImpl::m_clrBackColor` Background color of the preview window. ### Syntax -``` +```cpp COLORREF m_clrBackColor; ``` -## CMFCPreviewCtrlImpl::m_clrTextColor +## `CMFCPreviewCtrlImpl::m_clrTextColor` Text color of the preview window. ### Syntax -``` +```cpp COLORREF m_clrTextColor; ``` -## CMFCPreviewCtrlImpl::m_font Font used to display text in the preview window. +## `CMFCPreviewCtrlImpl::m_font` + +Font used to display text in the preview window. ### Syntax -``` +```cpp CFont m_font; ``` -## CMFCPreviewCtrlImpl::m_pDocument +## `CMFCPreviewCtrlImpl::m_pDocument` A pointer to a document whose content is previewed in the control. ### Syntax -``` +```cpp ATL::IDocument* m_pDocument; ``` -## CMFCPreviewCtrlImpl::Redraw +## `CMFCPreviewCtrlImpl::Redraw` Tells this control to redraw. ### Syntax -``` +```cpp virtual void Redraw(); ``` -## CMFCPreviewCtrlImpl::SetDocument +## `CMFCPreviewCtrlImpl::SetDocument` Called by the preview handler to create a relationship between the document implementation and the preview control. @@ -216,88 +219,88 @@ Called by the preview handler to create a relationship between the document impl ```cpp void SetDocument( - IDocument* pDocument + IDocument* pDocument ); ``` ### Parameters -*pDocument*
+*`pDocument`*\ A pointer to the document implementation. -## CMFCPreviewCtrlImpl::SetHost +## `CMFCPreviewCtrlImpl::SetHost` Sets a new parent for this control. ### Syntax -``` +```cpp virtual void SetHost( - HWND hWndParent + HWND hWndParent ); ``` ### Parameters -*hWndParent*
+*`hWndParent`*\ A handle to the new parent window. -## CMFCPreviewCtrlImpl::SetPreviewVisuals +## `CMFCPreviewCtrlImpl::SetPreviewVisuals` Called by a Rich Preview handler when it needs to set visuals of rich preview content. ### Syntax -``` +```cpp virtual void SetPreviewVisuals( - COLORREF clrBack, - COLORREF clrText, - const LOGFONTW *plf + COLORREF clrBack, + COLORREF clrText, + const LOGFONTW *plf ); ``` ### Parameters -*clrBack*
+*`clrBack`*\ Background color of preview window. -*clrText*
+*`clrText`*\ Text color of preview window. -*plf*
+*`plf`*\ Font used to display text in the preview window. -## CMFCPreviewCtrlImpl::SetRect +## `CMFCPreviewCtrlImpl::SetRect` Sets a new bounding rectangle for this control. ### Syntax -``` +```cpp virtual void SetRect( - const RECT* prc, - BOOL bRedraw + const RECT* prc, + BOOL bRedraw ); ``` ### Parameters -*prc*
+*`prc`*\ Specifies the new size and position of the preview control. -*bRedraw*
+*`bRedraw`*\ Specifies whether the control should be redrawn. ### Remarks Usually a new bounding rectangle is set when the host control is resized. -## CMFCPreviewCtrlImpl::~CMFCPreviewCtrlImpl +## `CMFCPreviewCtrlImpl::~CMFCPreviewCtrlImpl` Destructs a preview control object. ### Syntax -``` +```cpp virtual ~CMFCPreviewCtrlImpl(); ``` diff --git a/docs/mfc/reference/cmfcpropertygridctrl-class.md b/docs/mfc/reference/cmfcpropertygridctrl-class.md index 319ba89f9d9..08bc061cf36 100644 --- a/docs/mfc/reference/cmfcpropertygridctrl-class.md +++ b/docs/mfc/reference/cmfcpropertygridctrl-class.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: CMFCPropertyGridCtrl Class" title: "CMFCPropertyGridCtrl Class" +description: "Learn more about: CMFCPropertyGridCtrl Class" ms.date: "11/19/2018" f1_keywords: ["CMFCPropertyGridCtrl", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridCtrl", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridCtrl::CMFCPropertyGridCtrl", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridCtrl::accSelect", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridCtrl::AddProperty", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridCtrl::AlwaysShowUserToolTip", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridCtrl::CloseColorPopup", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridCtrl::Create", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridCtrl::DeleteProperty", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridCtrl::DrawControlBarColors", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridCtrl::EnableDescriptionArea", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridCtrl::EnableHeaderCtrl", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridCtrl::EnsureVisible", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridCtrl::ExpandAll", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridCtrl::FindItemByData", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridCtrl::get_accChildCount", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridCtrl::get_accFocus", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridCtrl::get_accHelp", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridCtrl::get_accHelpTopic", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridCtrl::get_accKeyboardShortcut", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridCtrl::get_accSelection", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridCtrl::GetBkColor", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridCtrl::GetBoldFont", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridCtrl::GetCurSel", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridCtrl::GetCustomColors", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridCtrl::GetDescriptionHeight", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridCtrl::GetDescriptionRows", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridCtrl::GetHeaderCtrl", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridCtrl::GetHeaderHeight", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridCtrl::GetLeftColumnWidth", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridCtrl::GetListRect", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridCtrl::GetProperty", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridCtrl::GetPropertyColumnWidth", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridCtrl::GetPropertyCount", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridCtrl::GetRowHeight", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridCtrl::GetScrollBarCtrl", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridCtrl::GetTextColor", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridCtrl::HitTest", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridCtrl::InitHeader", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridCtrl::IsAlphabeticMode", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridCtrl::IsAlwaysShowUserToolTip", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridCtrl::IsDescriptionArea", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridCtrl::IsGroupNameFullWidth", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridCtrl::IsHeaderCtrl", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridCtrl::IsMarkModifiedProperties", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridCtrl::IsShowDragContext", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridCtrl::IsVSDotNetLook", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridCtrl::MarkModifiedProperties", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridCtrl::RemoveAll", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridCtrl::ResetOriginalValues", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridCtrl::SetAlphabeticMode", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridCtrl::SetBoolLabels", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridCtrl::SetCurSel", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridCtrl::SetCustomColors", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridCtrl::SetDescriptionRows", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridCtrl::SetGroupNameFullWidth", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridCtrl::SetListDelimiter", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridCtrl::SetShowDragContext", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridCtrl::SetVSDotNetLook", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridCtrl::UpdateColor", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridCtrl::AdjustLayout", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridCtrl::CompareProps", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridCtrl::EditItem", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridCtrl::EndEditItem", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridCtrl::Init", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridCtrl::OnChangeSelection", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridCtrl::OnClickButton", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridCtrl::OnDrawBorder", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridCtrl::OnDrawDescription", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridCtrl::OnDrawList", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridCtrl::OnDrawProperty", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridCtrl::OnPropertyChanged", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridCtrl::OnSelectCombo", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridCtrl::ValidateItemData"] helpviewer_keywords: ["CMFCPropertyGridCtrl [MFC], CMFCPropertyGridCtrl", "CMFCPropertyGridCtrl [MFC], accSelect", "CMFCPropertyGridCtrl [MFC], AddProperty", "CMFCPropertyGridCtrl [MFC], AlwaysShowUserToolTip", "CMFCPropertyGridCtrl [MFC], CloseColorPopup", "CMFCPropertyGridCtrl [MFC], Create", "CMFCPropertyGridCtrl [MFC], DeleteProperty", "CMFCPropertyGridCtrl [MFC], DrawControlBarColors", "CMFCPropertyGridCtrl [MFC], EnableDescriptionArea", "CMFCPropertyGridCtrl [MFC], EnableHeaderCtrl", "CMFCPropertyGridCtrl [MFC], EnsureVisible", "CMFCPropertyGridCtrl [MFC], ExpandAll", "CMFCPropertyGridCtrl [MFC], FindItemByData", "CMFCPropertyGridCtrl [MFC], get_accChildCount", "CMFCPropertyGridCtrl [MFC], get_accFocus", "CMFCPropertyGridCtrl [MFC], get_accHelp", "CMFCPropertyGridCtrl [MFC], get_accHelpTopic", "CMFCPropertyGridCtrl [MFC], get_accKeyboardShortcut", "CMFCPropertyGridCtrl [MFC], get_accSelection", "CMFCPropertyGridCtrl [MFC], GetBkColor", "CMFCPropertyGridCtrl [MFC], GetBoldFont", "CMFCPropertyGridCtrl [MFC], GetCurSel", "CMFCPropertyGridCtrl [MFC], GetCustomColors", "CMFCPropertyGridCtrl [MFC], GetDescriptionHeight", "CMFCPropertyGridCtrl [MFC], GetDescriptionRows", "CMFCPropertyGridCtrl [MFC], GetHeaderCtrl", "CMFCPropertyGridCtrl [MFC], GetHeaderHeight", "CMFCPropertyGridCtrl [MFC], GetLeftColumnWidth", "CMFCPropertyGridCtrl [MFC], GetListRect", "CMFCPropertyGridCtrl [MFC], GetProperty", "CMFCPropertyGridCtrl [MFC], GetPropertyColumnWidth", "CMFCPropertyGridCtrl [MFC], GetPropertyCount", "CMFCPropertyGridCtrl [MFC], GetRowHeight", "CMFCPropertyGridCtrl [MFC], GetScrollBarCtrl", "CMFCPropertyGridCtrl [MFC], GetTextColor", "CMFCPropertyGridCtrl [MFC], HitTest", "CMFCPropertyGridCtrl [MFC], InitHeader", "CMFCPropertyGridCtrl [MFC], IsAlphabeticMode", "CMFCPropertyGridCtrl [MFC], IsAlwaysShowUserToolTip", "CMFCPropertyGridCtrl [MFC], IsDescriptionArea", "CMFCPropertyGridCtrl [MFC], IsGroupNameFullWidth", "CMFCPropertyGridCtrl [MFC], IsHeaderCtrl", "CMFCPropertyGridCtrl [MFC], IsMarkModifiedProperties", "CMFCPropertyGridCtrl [MFC], IsShowDragContext", "CMFCPropertyGridCtrl [MFC], IsVSDotNetLook", "CMFCPropertyGridCtrl [MFC], MarkModifiedProperties", "CMFCPropertyGridCtrl [MFC], RemoveAll", "CMFCPropertyGridCtrl [MFC], ResetOriginalValues", "CMFCPropertyGridCtrl [MFC], SetAlphabeticMode", "CMFCPropertyGridCtrl [MFC], SetBoolLabels", "CMFCPropertyGridCtrl [MFC], SetCurSel", "CMFCPropertyGridCtrl [MFC], SetCustomColors", "CMFCPropertyGridCtrl [MFC], SetDescriptionRows", "CMFCPropertyGridCtrl [MFC], SetGroupNameFullWidth", "CMFCPropertyGridCtrl [MFC], SetListDelimiter", "CMFCPropertyGridCtrl [MFC], SetShowDragContext", "CMFCPropertyGridCtrl [MFC], SetVSDotNetLook", "CMFCPropertyGridCtrl [MFC], UpdateColor", "CMFCPropertyGridCtrl [MFC], AdjustLayout", "CMFCPropertyGridCtrl [MFC], CompareProps", "CMFCPropertyGridCtrl [MFC], EditItem", "CMFCPropertyGridCtrl [MFC], EndEditItem", "CMFCPropertyGridCtrl [MFC], Init", "CMFCPropertyGridCtrl [MFC], OnChangeSelection", "CMFCPropertyGridCtrl [MFC], OnClickButton", "CMFCPropertyGridCtrl [MFC], OnDrawBorder", "CMFCPropertyGridCtrl [MFC], OnDrawDescription", "CMFCPropertyGridCtrl [MFC], OnDrawList", "CMFCPropertyGridCtrl [MFC], OnDrawProperty", "CMFCPropertyGridCtrl [MFC], OnPropertyChanged", "CMFCPropertyGridCtrl [MFC], OnSelectCombo", "CMFCPropertyGridCtrl [MFC], ValidateItemData"] -ms.assetid: 95877cae-2311-4a2a-9031-0c8c3cf0a5f9 --- # CMFCPropertyGridCtrl Class @@ -179,7 +178,7 @@ virtual HRESULT accSelect( ### Parameters [in] *`flagsSelect`*\ -[in] *`varChild`*\ +[in] *`varChild`* ### Return Value @@ -235,7 +234,7 @@ void AlwaysShowUserToolTip(BOOL bShow = TRUE); ### Parameters -[in] *`bShow`*\ +[in] *`bShow`* ### Remarks @@ -524,7 +523,7 @@ virtual HRESULT get_accChildCount(long* pcountChildren); ### Parameters -[in] *`pcountChildren`*\ +[in] *`pcountChildren`* ### Return Value @@ -538,7 +537,7 @@ virtual HRESULT get_accFocus(VARIANT* pvarChild); ### Parameters -[in] *`pvarChild`*\ +[in] *`pvarChild`* ### Return Value @@ -555,7 +554,7 @@ virtual HRESULT get_accHelp( ### Parameters [in] *`varChild`*\ -[in] *`pszHelp`*\ +[in] *`pszHelp`* ### Return Value @@ -574,7 +573,7 @@ virtual HRESULT get_accHelpTopic( [in] *`pszHelpFile`*\ [in] *`varChild`*\ -[in] *`pidTopic`*\ +[in] *`pidTopic`* ### Return Value @@ -591,7 +590,7 @@ virtual HRESULT get_accKeyboardShortcut( ### Parameters [in] *`varChild`*\ -[in] *`pszKeyboardShortcut`*\ +[in] *`pszKeyboardShortcut`* ### Return Value @@ -605,7 +604,7 @@ virtual HRESULT get_accSelection(VARIANT* pvarChildren); ### Parameters -[in] *`pvarChildren`*\ +[in] *`pvarChildren`* ### Return Value @@ -781,7 +780,7 @@ CRect GetListRect() const; ### Return Value -The bounding rectangle of the property grid control. This rectange doesn't include the description area and header. +The bounding rectangle of the property grid control. This rectangle doesn't include the description area and header. ### Remarks diff --git a/docs/mfc/reference/cmfcpropertygridproperty-class.md b/docs/mfc/reference/cmfcpropertygridproperty-class.md index 31a00e36f8f..8bf3752df36 100644 --- a/docs/mfc/reference/cmfcpropertygridproperty-class.md +++ b/docs/mfc/reference/cmfcpropertygridproperty-class.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: CMFCPropertyGridProperty class" title: "CMFCPropertyGridProperty class" -ms.date: "10/12/2022" +description: "Learn more about: CMFCPropertyGridProperty class" +ms.date: 10/12/2022 f1_keywords: ["CMFCPropertyGridProperty", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridProperty", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridProperty::CMFCPropertyGridProperty", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridProperty::AddOption", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridProperty::AddSubItem", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridProperty::AdjustButtonRect", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridProperty::AdjustInPlaceEditRect", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridProperty::AllowEdit", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridProperty::CreateInPlaceEdit", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridProperty::CreateSpinControl", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridProperty::Enable", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridProperty::EnableSpinControl", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridProperty::Expand", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridProperty::FormatProperty", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridProperty::GetData", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridProperty::GetDescription", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridProperty::GetExpandedSubItems", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridProperty::GetHierarchyLevel", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridProperty::GetName", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridProperty::GetNameTooltip", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridProperty::GetOption", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridProperty::GetOptionCount", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridProperty::GetOriginalValue", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridProperty::GetParent", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridProperty::GetRect", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridProperty::GetSubItem", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridProperty::GetSubItemsCount", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridProperty::GetValue", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridProperty::GetValueTooltip", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridProperty::HitTest", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridProperty::IsAllowEdit", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridProperty::IsEnabled", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridProperty::IsExpanded", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridProperty::IsGroup", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridProperty::IsInPlaceEditing", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridProperty::IsModified", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridProperty::IsParentExpanded", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridProperty::IsSelected", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridProperty::IsVisible", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridProperty::OnClickButton", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridProperty::OnClickName", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridProperty::OnClickValue", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridProperty::OnCloseCombo", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridProperty::OnDblClk", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridProperty::OnDrawButton", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridProperty::OnDrawDescription", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridProperty::OnDrawExpandBox", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridProperty::OnDrawName", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridProperty::OnDrawValue", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridProperty::OnEdit", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridProperty::OnEndEdit", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridProperty::OnKillSelection", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridProperty::OnPosSizeChanged", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridProperty::OnRClickName", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridProperty::OnRClickValue", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridProperty::OnSelectCombo", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridProperty::OnSetCursor", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridProperty::OnSetSelection", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridProperty::OnUpdateValue", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridProperty::PushChar", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridProperty::Redraw", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridProperty::RemoveAllOptions", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridProperty::RemoveSubItem", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridProperty::ResetOriginalValue", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridProperty::SetData", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridProperty::SetDescription", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridProperty::SetName", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridProperty::SetOriginalValue", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridProperty::SetValue", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridProperty::Show", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridProperty::CreateCombo", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridProperty::HasButton", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridProperty::Init", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridProperty::IsSubItem", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridProperty::IsValueChanged", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridProperty::OnCtlColor", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridProperty::OnDestroyWindow", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridProperty::OnKillFocus", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridProperty::m_strFormatDouble", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridProperty::m_strFormatFloat", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridProperty::m_strFormatLong", "AFXPROPERTYGRIDCTRL/CMFCPropertyGridProperty::m_strFormatShort"] helpviewer_keywords: ["CMFCPropertyGridProperty [MFC], CMFCPropertyGridProperty", "CMFCPropertyGridProperty [MFC], AddOption", "CMFCPropertyGridProperty [MFC], AddSubItem", "CMFCPropertyGridProperty [MFC], AdjustButtonRect", "CMFCPropertyGridProperty [MFC], AdjustInPlaceEditRect", "CMFCPropertyGridProperty [MFC], AllowEdit", "CMFCPropertyGridProperty [MFC], CreateInPlaceEdit", "CMFCPropertyGridProperty [MFC], CreateSpinControl", "CMFCPropertyGridProperty [MFC], Enable", "CMFCPropertyGridProperty [MFC], EnableSpinControl", "CMFCPropertyGridProperty [MFC], Expand", "CMFCPropertyGridProperty [MFC], FormatProperty", "CMFCPropertyGridProperty [MFC], GetData", "CMFCPropertyGridProperty [MFC], GetDescription", "CMFCPropertyGridProperty [MFC], GetExpandedSubItems", "CMFCPropertyGridProperty [MFC], GetHierarchyLevel", "CMFCPropertyGridProperty [MFC], GetName", "CMFCPropertyGridProperty [MFC], GetNameTooltip", "CMFCPropertyGridProperty [MFC], GetOption", "CMFCPropertyGridProperty [MFC], GetOptionCount", "CMFCPropertyGridProperty [MFC], GetOriginalValue", "CMFCPropertyGridProperty [MFC], GetParent", "CMFCPropertyGridProperty [MFC], GetRect", "CMFCPropertyGridProperty [MFC], GetSubItem", "CMFCPropertyGridProperty [MFC], GetSubItemsCount", "CMFCPropertyGridProperty [MFC], GetValue", "CMFCPropertyGridProperty [MFC], GetValueTooltip", "CMFCPropertyGridProperty [MFC], HitTest", "CMFCPropertyGridProperty [MFC], IsAllowEdit", "CMFCPropertyGridProperty [MFC], IsEnabled", "CMFCPropertyGridProperty [MFC], IsExpanded", "CMFCPropertyGridProperty [MFC], IsGroup", "CMFCPropertyGridProperty [MFC], IsInPlaceEditing", "CMFCPropertyGridProperty [MFC], IsModified", "CMFCPropertyGridProperty [MFC], IsParentExpanded", "CMFCPropertyGridProperty [MFC], IsSelected", "CMFCPropertyGridProperty [MFC], IsVisible", "CMFCPropertyGridProperty [MFC], OnClickButton", "CMFCPropertyGridProperty [MFC], OnClickName", "CMFCPropertyGridProperty [MFC], OnClickValue", "CMFCPropertyGridProperty [MFC], OnCloseCombo", "CMFCPropertyGridProperty [MFC], OnDblClk", "CMFCPropertyGridProperty [MFC], OnDrawButton", "CMFCPropertyGridProperty [MFC], OnDrawDescription", "CMFCPropertyGridProperty [MFC], OnDrawExpandBox", "CMFCPropertyGridProperty [MFC], OnDrawName", "CMFCPropertyGridProperty [MFC], OnDrawValue", "CMFCPropertyGridProperty [MFC], OnEdit", "CMFCPropertyGridProperty [MFC], OnEndEdit", "CMFCPropertyGridProperty [MFC], OnKillSelection", "CMFCPropertyGridProperty [MFC], OnPosSizeChanged", "CMFCPropertyGridProperty [MFC], OnRClickName", "CMFCPropertyGridProperty [MFC], OnRClickValue", "CMFCPropertyGridProperty [MFC], OnSelectCombo", "CMFCPropertyGridProperty [MFC], OnSetCursor", "CMFCPropertyGridProperty [MFC], OnSetSelection", "CMFCPropertyGridProperty [MFC], OnUpdateValue", "CMFCPropertyGridProperty [MFC], PushChar", "CMFCPropertyGridProperty [MFC], Redraw", "CMFCPropertyGridProperty [MFC], RemoveAllOptions", "CMFCPropertyGridProperty [MFC], RemoveSubItem", "CMFCPropertyGridProperty [MFC], ResetOriginalValue", "CMFCPropertyGridProperty [MFC], SetData", "CMFCPropertyGridProperty [MFC], SetDescription", "CMFCPropertyGridProperty [MFC], SetName", "CMFCPropertyGridProperty [MFC], SetOriginalValue", "CMFCPropertyGridProperty [MFC], SetValue", "CMFCPropertyGridProperty [MFC], Show", "CMFCPropertyGridProperty [MFC], CreateCombo", "CMFCPropertyGridProperty [MFC], HasButton", "CMFCPropertyGridProperty [MFC], Init", "CMFCPropertyGridProperty [MFC], IsSubItem", "CMFCPropertyGridProperty [MFC], IsValueChanged", "CMFCPropertyGridProperty [MFC], OnCtlColor", "CMFCPropertyGridProperty [MFC], OnDestroyWindow", "CMFCPropertyGridProperty [MFC], OnKillFocus", "CMFCPropertyGridProperty [MFC], m_strFormatDouble", "CMFCPropertyGridProperty [MFC], m_strFormatFloat", "CMFCPropertyGridProperty [MFC], m_strFormatLong", "CMFCPropertyGridProperty [MFC], m_strFormatShort"] --- @@ -1169,7 +1169,7 @@ virtual void OnKillSelection(CMFCPropertyGridProperty*); ### Parameters -[in] *`CMFCPropertyGridProperty*`*\ +[in] *`CMFCPropertyGridProperty*`* ### Remarks @@ -1183,7 +1183,7 @@ virtual void OnPosSizeChanged(CRect); ### Parameters -[in] *`CRect`*\ +[in] *`CRect`* ### Remarks @@ -1259,12 +1259,12 @@ This method supports the following variant types: `VT_INT`, `VT_I2`, `VT_I4`, `V ## `CMFCPropertyGridProperty::OnSetSelection` ```cpp -virtual void OnSetSelection CMFCPropertyGridProperty*); +virtual void OnSetSelection(CMFCPropertyGridProperty*); ``` ### Parameters -[in] *`CMFCPropertyGridProperty*`*\ +[in] *`CMFCPropertyGridProperty*`* ### Remarks diff --git a/docs/mfc/reference/cmfcribbonbar-class.md b/docs/mfc/reference/cmfcribbonbar-class.md index a0eb85dd1a4..b3ec1757ee4 100644 --- a/docs/mfc/reference/cmfcribbonbar-class.md +++ b/docs/mfc/reference/cmfcribbonbar-class.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: CMFCRibbonBar Class" title: "CMFCRibbonBar Class" +description: "Learn more about: CMFCRibbonBar Class" ms.date: "11/04/2016" f1_keywords: ["CMFCRibbonBar", "AFXRIBBONBAR/CMFCRibbonBar", "AFXRIBBONBAR/CMFCRibbonBar::ActivateContextCategory", "AFXRIBBONBAR/CMFCRibbonBar::AddCategory", "AFXRIBBONBAR/CMFCRibbonBar::AddContextCategory", "AFXRIBBONBAR/CMFCRibbonBar::AddMainCategory", "AFXRIBBONBAR/CMFCRibbonBar::AddPrintPreviewCategory", "AFXRIBBONBAR/CMFCRibbonBar::AddQATOnlyCategory", "AFXRIBBONBAR/CMFCRibbonBar::AddToTabs", "AFXRIBBONBAR/CMFCRibbonBar::CreateEx", "AFXRIBBONBAR/CMFCRibbonBar::Create", "AFXRIBBONBAR/CMFCRibbonBar::DeactivateKeyboardFocus", "AFXRIBBONBAR/CMFCRibbonBar::DrawMenuImage", "AFXRIBBONBAR/CMFCRibbonBar::DWMCompositionChanged", "AFXRIBBONBAR/CMFCRibbonBar::EnableKeyTips", "AFXRIBBONBAR/CMFCRibbonBar::EnablePrintPreview", "AFXRIBBONBAR/CMFCRibbonBar::EnableToolTips", "AFXRIBBONBAR/CMFCRibbonBar::FindByData", "AFXRIBBONBAR/CMFCRibbonBar::FindByID", "AFXRIBBONBAR/CMFCRibbonBar::FindCategoryIndexByData", "AFXRIBBONBAR/CMFCRibbonBar::ForceRecalcLayout", "AFXRIBBONBAR/CMFCRibbonBar::GetActiveCategory", "AFXRIBBONBAR/CMFCRibbonBar::GetCaptionHeight", "AFXRIBBONBAR/CMFCRibbonBar::GetCategory", "AFXRIBBONBAR/CMFCRibbonBar::GetCategoryCount", "AFXRIBBONBAR/CMFCRibbonBar::GetCategoryHeight", "AFXRIBBONBAR/CMFCRibbonBar::GetCategoryIndex", "AFXRIBBONBAR/CMFCRibbonBar::GetContextName", "AFXRIBBONBAR/CMFCRibbonBar::GetDroppedDown", "AFXRIBBONBAR/CMFCRibbonBar::GetElementsByID", "AFXRIBBONBAR/CMFCRibbonBar::GetApplicationButton", "AFXRIBBONBAR/CMFCRibbonBar::GetFocused", "AFXRIBBONBAR/CMFCRibbonBar::GetHideFlags", "AFXRIBBONBAR/CMFCRibbonBar::GetItemIDsList", "AFXRIBBONBAR/CMFCRibbonBar::GetKeyboardNavigationLevel", "AFXRIBBONBAR/CMFCRibbonBar::GetKeyboardNavLevelCurrent", "AFXRIBBONBAR/CMFCRibbonBar::GetKeyboardNavLevelParent", "AFXRIBBONBAR/CMFCRibbonBar::GetMainCategory", "AFXRIBBONBAR/CMFCRibbonBar::GetQATCommandsLocation", "AFXRIBBONBAR/CMFCRibbonBar::GetQATDroppedDown", "AFXRIBBONBAR/CMFCRibbonBar::GetQuickAccessCommands", "AFXRIBBONBAR/CMFCRibbonBar::GetQuickAccessToolbarLocation", "AFXRIBBONBAR/CMFCRibbonBar::GetTabTrancateRatio", "AFXRIBBONBAR/CMFCRibbonBar::GetTooltipFixedWidthLargeImage", "AFXRIBBONBAR/CMFCRibbonBar::GetTooltipFixedWidthRegular", "AFXRIBBONBAR/CMFCRibbonBar::GetVisibleCategoryCount", "AFXRIBBONBAR/CMFCRibbonBar::HideAllContextCategories", "AFXRIBBONBAR/CMFCRibbonBar::HideKeyTips", "AFXRIBBONBAR/CMFCRibbonBar::HitTest", "AFXRIBBONBAR/CMFCRibbonBar::IsKeyTipEnabled", "AFXRIBBONBAR/CMFCRibbonBar::IsMainRibbonBar", "AFXRIBBONBAR/CMFCRibbonBar::IsPrintPreviewEnabled", "AFXRIBBONBAR/CMFCRibbonBar::IsQATEmpty", "AFXRIBBONBAR/CMFCRibbonBar::IsQuickAccessToolbarOnTop", "AFXRIBBONBAR/CMFCRibbonBar::IsReplaceFrameCaption", "AFXRIBBONBAR/CMFCRibbonBar::IsShowGroupBorder", "AFXRIBBONBAR/CMFCRibbonBar::IsToolTipDescrEnabled", "AFXRIBBONBAR/CMFCRibbonBar::IsToolTipEnabled", "AFXRIBBONBAR/CMFCRibbonBar::IsTransparentCaption", "AFXRIBBONBAR/CMFCRibbonBar::IsWindows7Look", "AFXRIBBONBAR/CMFCRibbonBar::LoadFromResource", "AFXRIBBONBAR/CMFCRibbonBar::OnClickButton", "AFXRIBBONBAR/CMFCRibbonBar::OnEditContextMenu", "AFXRIBBONBAR/CMFCRibbonBar::OnRTLChanged", "AFXRIBBONBAR/CMFCRibbonBar::OnSetAccData", "AFXRIBBONBAR/CMFCRibbonBar::OnShowRibbonContextMenu", "AFXRIBBONBAR/CMFCRibbonBar::OnShowRibbonQATMenu", "AFXRIBBONBAR/CMFCRibbonBar::OnSysKeyDown", "AFXRIBBONBAR/CMFCRibbonBar::OnSysKeyUp", "AFXRIBBONBAR/CMFCRibbonBar::PopTooltip", "AFXRIBBONBAR/CMFCRibbonBar::PreTranslateMessage", "AFXRIBBONBAR/CMFCRibbonBar::RecalcLayout", "AFXRIBBONBAR/CMFCRibbonBar::RemoveAllCategories", "AFXRIBBONBAR/CMFCRibbonBar::RemoveAllFromTabs", "AFXRIBBONBAR/CMFCRibbonBar::RemoveCategory", "AFXRIBBONBAR/CMFCRibbonBar::SaveToXMLBuffer", "AFXRIBBONBAR/CMFCRibbonBar::SaveToXMLFile", "AFXRIBBONBAR/CMFCRibbonBar::SetActiveCategory", "AFXRIBBONBAR/CMFCRibbonBar::SetActiveMDIChild", "AFXRIBBONBAR/CMFCRibbonBar::SetElementKeys", "AFXRIBBONBAR/CMFCRibbonBar::SetApplicationButton", "AFXRIBBONBAR/CMFCRibbonBar::SetKeyboardNavigationLevel", "AFXRIBBONBAR/CMFCRibbonBar::SetMaximizeMode", "AFXRIBBONBAR/CMFCRibbonBar::SetQuickAccessCommands", "AFXRIBBONBAR/CMFCRibbonBar::SetQuickAccessDefaultState", "AFXRIBBONBAR/CMFCRibbonBar::SetQuickAccessToolbarOnTop", "AFXRIBBONBAR/CMFCRibbonBar::SetTooltipFixedWidth", "AFXRIBBONBAR/CMFCRibbonBar::SetWindows7Look", "AFXRIBBONBAR/CMFCRibbonBar::ShowCategory", "AFXRIBBONBAR/CMFCRibbonBar::ShowContextCategories", "AFXRIBBONBAR/CMFCRibbonBar::ShowKeyTips", "AFXRIBBONBAR/CMFCRibbonBar::ToggleMimimizeState", "AFXRIBBONBAR/CMFCRibbonBar::TranslateChar"] helpviewer_keywords: ["CMFCRibbonBar [MFC], ActivateContextCategory", "CMFCRibbonBar [MFC], AddCategory", "CMFCRibbonBar [MFC], AddContextCategory", "CMFCRibbonBar [MFC], AddMainCategory", "CMFCRibbonBar [MFC], AddPrintPreviewCategory", "CMFCRibbonBar [MFC], AddQATOnlyCategory", "CMFCRibbonBar [MFC], AddToTabs", "CMFCRibbonBar [MFC], CreateEx", "CMFCRibbonBar [MFC], Create", "CMFCRibbonBar [MFC], DeactivateKeyboardFocus", "CMFCRibbonBar [MFC], DrawMenuImage", "CMFCRibbonBar [MFC], DWMCompositionChanged", "CMFCRibbonBar [MFC], EnableKeyTips", "CMFCRibbonBar [MFC], EnablePrintPreview", "CMFCRibbonBar [MFC], EnableToolTips", "CMFCRibbonBar [MFC], FindByData", "CMFCRibbonBar [MFC], FindByID", "CMFCRibbonBar [MFC], FindCategoryIndexByData", "CMFCRibbonBar [MFC], ForceRecalcLayout", "CMFCRibbonBar [MFC], GetActiveCategory", "CMFCRibbonBar [MFC], GetCaptionHeight", "CMFCRibbonBar [MFC], GetCategory", "CMFCRibbonBar [MFC], GetCategoryCount", "CMFCRibbonBar [MFC], GetCategoryHeight", "CMFCRibbonBar [MFC], GetCategoryIndex", "CMFCRibbonBar [MFC], GetContextName", "CMFCRibbonBar [MFC], GetDroppedDown", "CMFCRibbonBar [MFC], GetElementsByID", "CMFCRibbonBar [MFC], GetApplicationButton", "CMFCRibbonBar [MFC], GetFocused", "CMFCRibbonBar [MFC], GetHideFlags", "CMFCRibbonBar [MFC], GetItemIDsList", "CMFCRibbonBar [MFC], GetKeyboardNavigationLevel", "CMFCRibbonBar [MFC], GetKeyboardNavLevelCurrent", "CMFCRibbonBar [MFC], GetKeyboardNavLevelParent", "CMFCRibbonBar [MFC], GetMainCategory", "CMFCRibbonBar [MFC], GetQATCommandsLocation", "CMFCRibbonBar [MFC], GetQATDroppedDown", "CMFCRibbonBar [MFC], GetQuickAccessCommands", "CMFCRibbonBar [MFC], GetQuickAccessToolbarLocation", "CMFCRibbonBar [MFC], GetTabTrancateRatio", "CMFCRibbonBar [MFC], GetTooltipFixedWidthLargeImage", "CMFCRibbonBar [MFC], GetTooltipFixedWidthRegular", "CMFCRibbonBar [MFC], GetVisibleCategoryCount", "CMFCRibbonBar [MFC], HideAllContextCategories", "CMFCRibbonBar [MFC], HideKeyTips", "CMFCRibbonBar [MFC], HitTest", "CMFCRibbonBar [MFC], IsKeyTipEnabled", "CMFCRibbonBar [MFC], IsMainRibbonBar", "CMFCRibbonBar [MFC], IsPrintPreviewEnabled", "CMFCRibbonBar [MFC], IsQATEmpty", "CMFCRibbonBar [MFC], IsQuickAccessToolbarOnTop", "CMFCRibbonBar [MFC], IsReplaceFrameCaption", "CMFCRibbonBar [MFC], IsShowGroupBorder", "CMFCRibbonBar [MFC], IsToolTipDescrEnabled", "CMFCRibbonBar [MFC], IsToolTipEnabled", "CMFCRibbonBar [MFC], IsTransparentCaption", "CMFCRibbonBar [MFC], IsWindows7Look", "CMFCRibbonBar [MFC], LoadFromResource", "CMFCRibbonBar [MFC], OnClickButton", "CMFCRibbonBar [MFC], OnEditContextMenu", "CMFCRibbonBar [MFC], OnRTLChanged", "CMFCRibbonBar [MFC], OnSetAccData", "CMFCRibbonBar [MFC], OnShowRibbonContextMenu", "CMFCRibbonBar [MFC], OnShowRibbonQATMenu", "CMFCRibbonBar [MFC], OnSysKeyDown", "CMFCRibbonBar [MFC], OnSysKeyUp", "CMFCRibbonBar [MFC], PopTooltip", "CMFCRibbonBar [MFC], PreTranslateMessage", "CMFCRibbonBar [MFC], RecalcLayout", "CMFCRibbonBar [MFC], RemoveAllCategories", "CMFCRibbonBar [MFC], RemoveAllFromTabs", "CMFCRibbonBar [MFC], RemoveCategory", "CMFCRibbonBar [MFC], SaveToXMLBuffer", "CMFCRibbonBar [MFC], SaveToXMLFile", "CMFCRibbonBar [MFC], SetActiveCategory", "CMFCRibbonBar [MFC], SetActiveMDIChild", "CMFCRibbonBar [MFC], SetElementKeys", "CMFCRibbonBar [MFC], SetApplicationButton", "CMFCRibbonBar [MFC], SetKeyboardNavigationLevel", "CMFCRibbonBar [MFC], SetMaximizeMode", "CMFCRibbonBar [MFC], SetQuickAccessCommands", "CMFCRibbonBar [MFC], SetQuickAccessDefaultState", "CMFCRibbonBar [MFC], SetQuickAccessToolbarOnTop", "CMFCRibbonBar [MFC], SetTooltipFixedWidth", "CMFCRibbonBar [MFC], SetWindows7Look", "CMFCRibbonBar [MFC], ShowCategory", "CMFCRibbonBar [MFC], ShowContextCategories", "CMFCRibbonBar [MFC], ShowKeyTips", "CMFCRibbonBar [MFC], ToggleMimimizeState", "CMFCRibbonBar [MFC], TranslateChar"] -ms.assetid: a65d06fa-1a28-4cc0-8971-bc9d7c9198fe --- # `CMFCRibbonBar` Class @@ -119,7 +118,7 @@ class CMFCRibbonBar : public CPane |[`CMFCRibbonBar::ShowCategory`](#showcategory)|Shows or hides the specified ribbon category.| |[`CMFCRibbonBar::ShowContextCategories`](#showcontextcategories)|Shows or hides the context categories that have the specified ID.| |[`CMFCRibbonBar::ShowKeyTips`](#showkeytips)|| -|[`CMFCRibbonBar::ToggleMimimizeState`](#togglemimimizestate)|Toggles the ribbon bar between the minimized and maximized states..| +|[`CMFCRibbonBar::ToggleMimimizeState`](#togglemimimizestate)|Toggles the ribbon bar between the minimized and maximized states.| |[`CMFCRibbonBar::TranslateChar`](#translatechar)|| ## Remarks @@ -1305,7 +1304,7 @@ virtual void OnEditContextMenu( ### Parameters [in] *`pEdit`*\ -[in] *`point`*\ +[in] *`point`* ### Remarks @@ -1360,7 +1359,7 @@ virtual BOOL OnShowRibbonContextMenu( [in] *`pWnd`*\ [in] *`x`*\ [in] *`y`*\ -[in] *`pHit`*\ +[in] *`pHit`* ### Return Value @@ -1381,7 +1380,7 @@ virtual BOOL OnShowRibbonQATMenu( [in] *`pWnd`*\ [in] *`x`*\ [in] *`y`*\ -[in] *`pHit`*\ +[in] *`pHit`* ### Return Value diff --git a/docs/mfc/reference/cmfcribbonbaseelement-class.md b/docs/mfc/reference/cmfcribbonbaseelement-class.md index 27c7ee698a3..7f320909b9d 100644 --- a/docs/mfc/reference/cmfcribbonbaseelement-class.md +++ b/docs/mfc/reference/cmfcribbonbaseelement-class.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: CMFCRibbonBaseElement Class" title: "CMFCRibbonBaseElement Class" +description: "Learn more about: CMFCRibbonBaseElement Class" ms.date: "11/04/2016" f1_keywords: ["CMFCRibbonBaseElement", "AFXBASERIBBONELEMENT/CMFCRibbonBaseElement", "AFXBASERIBBONELEMENT/CMFCRibbonBaseElement::AddToKeyList", "AFXBASERIBBONELEMENT/CMFCRibbonBaseElement::AddToListBox", "AFXBASERIBBONELEMENT/CMFCRibbonBaseElement::CanBeAddedToQuickAccessToolBar", "AFXBASERIBBONELEMENT/CMFCRibbonBaseElement::CanBeCompacted", "AFXBASERIBBONELEMENT/CMFCRibbonBaseElement::CanBeStretched", "AFXBASERIBBONELEMENT/CMFCRibbonBaseElement::CanBeStretchedHorizontally", "AFXBASERIBBONELEMENT/CMFCRibbonBaseElement::CleanUpSizes", "AFXBASERIBBONELEMENT/CMFCRibbonBaseElement::ClosePopupMenu", "AFXBASERIBBONELEMENT/CMFCRibbonBaseElement::CopyFrom", "AFXBASERIBBONELEMENT/CMFCRibbonBaseElement::DestroyCtrl", "AFXBASERIBBONELEMENT/CMFCRibbonBaseElement::DrawImage", "AFXBASERIBBONELEMENT/CMFCRibbonBaseElement::Find", "AFXBASERIBBONELEMENT/CMFCRibbonBaseElement::FindByData", "AFXBASERIBBONELEMENT/CMFCRibbonBaseElement::FindByID", "AFXBASERIBBONELEMENT/CMFCRibbonBaseElement::FindByOriginal", "AFXBASERIBBONELEMENT/CMFCRibbonBaseElement::GetCompactSize", "AFXBASERIBBONELEMENT/CMFCRibbonBaseElement::GetData", "AFXBASERIBBONELEMENT/CMFCRibbonBaseElement::GetDescription", "AFXBASERIBBONELEMENT/CMFCRibbonBaseElement::GetDroppedDown", "AFXBASERIBBONELEMENT/CMFCRibbonBaseElement::GetElements", "AFXBASERIBBONELEMENT/CMFCRibbonBaseElement::GetElementsByID", "AFXBASERIBBONELEMENT/CMFCRibbonBaseElement::GetHighlighted", "AFXBASERIBBONELEMENT/CMFCRibbonBaseElement::GetID", "AFXBASERIBBONELEMENT/CMFCRibbonBaseElement::GetImageSize", "AFXBASERIBBONELEMENT/CMFCRibbonBaseElement::GetIntermediateSize", "AFXBASERIBBONELEMENT/CMFCRibbonBaseElement::GetKeys", "AFXBASERIBBONELEMENT/CMFCRibbonBaseElement::GetKeyTipRect", "AFXBASERIBBONELEMENT/CMFCRibbonBaseElement::GetKeyTipSize", "AFXBASERIBBONELEMENT/CMFCRibbonBaseElement::GetLocationInGroup", "AFXBASERIBBONELEMENT/CMFCRibbonBaseElement::GetMenuKeys", "AFXBASERIBBONELEMENT/CMFCRibbonBaseElement::GetNotifyID", "AFXBASERIBBONELEMENT/CMFCRibbonBaseElement::GetOriginal", "AFXBASERIBBONELEMENT/CMFCRibbonBaseElement::GetParentCategory", "AFXBASERIBBONELEMENT/CMFCRibbonBaseElement::GetParentPanel", "AFXBASERIBBONELEMENT/CMFCRibbonBaseElement::GetParentRibbonBar", "AFXBASERIBBONELEMENT/CMFCRibbonBaseElement::GetParentWnd", "AFXBASERIBBONELEMENT/CMFCRibbonBaseElement::GetPressed", "AFXBASERIBBONELEMENT/CMFCRibbonBaseElement::GetQuickAccessToolBarID", "AFXBASERIBBONELEMENT/CMFCRibbonBaseElement::GetRect", "AFXBASERIBBONELEMENT/CMFCRibbonBaseElement::GetRegularSize", "AFXBASERIBBONELEMENT/CMFCRibbonBaseElement::GetSize", "AFXBASERIBBONELEMENT/CMFCRibbonBaseElement::GetText", "AFXBASERIBBONELEMENT/CMFCRibbonBaseElement::GetToolTipText", "AFXBASERIBBONELEMENT/CMFCRibbonBaseElement::GetTopLevelRibbonBar", "AFXBASERIBBONELEMENT/CMFCRibbonBaseElement::HasCompactMode", "AFXBASERIBBONELEMENT/CMFCRibbonBaseElement::HasFocus", "AFXBASERIBBONELEMENT/CMFCRibbonBaseElement::HasIntermediateMode", "AFXBASERIBBONELEMENT/CMFCRibbonBaseElement::HasLargeMode", "AFXBASERIBBONELEMENT/CMFCRibbonBaseElement::HasMenu", "AFXBASERIBBONELEMENT/CMFCRibbonBaseElement::HitTest", "AFXBASERIBBONELEMENT/CMFCRibbonBaseElement::IsAlignByColumn", "AFXBASERIBBONELEMENT/CMFCRibbonBaseElement::IsAlwaysLargeImage", "AFXBASERIBBONELEMENT/CMFCRibbonBaseElement::IsAutoRepeatMode", "AFXBASERIBBONELEMENT/CMFCRibbonBaseElement::IsChecked", "AFXBASERIBBONELEMENT/CMFCRibbonBaseElement::IsCompactMode", "AFXBASERIBBONELEMENT/CMFCRibbonBaseElement::IsDefaultMenuLook", "AFXBASERIBBONELEMENT/CMFCRibbonBaseElement::IsDisabled", "AFXBASERIBBONELEMENT/CMFCRibbonBaseElement::IsDroppedDown", "AFXBASERIBBONELEMENT/CMFCRibbonBaseElement::IsFocused", "AFXBASERIBBONELEMENT/CMFCRibbonBaseElement::IsGalleryIcon", "AFXBASERIBBONELEMENT/CMFCRibbonBaseElement::IsHighlighted", "AFXBASERIBBONELEMENT/CMFCRibbonBaseElement::IsIntermediateMode", "AFXBASERIBBONELEMENT/CMFCRibbonBaseElement::IsLargeMode", "AFXBASERIBBONELEMENT/CMFCRibbonBaseElement::IsMenuMode", "AFXBASERIBBONELEMENT/CMFCRibbonBaseElement::IsPressed", "AFXBASERIBBONELEMENT/CMFCRibbonBaseElement::IsQATMode", "AFXBASERIBBONELEMENT/CMFCRibbonBaseElement::IsSeparator", "AFXBASERIBBONELEMENT/CMFCRibbonBaseElement::IsShowGroupBorder", "AFXBASERIBBONELEMENT/CMFCRibbonBaseElement::IsShowTooltipOnBottom", "AFXBASERIBBONELEMENT/CMFCRibbonBaseElement::IsTabStop", "AFXBASERIBBONELEMENT/CMFCRibbonBaseElement::IsTextAlwaysOnRight", "AFXBASERIBBONELEMENT/CMFCRibbonBaseElement::IsVisible", "AFXBASERIBBONELEMENT/CMFCRibbonBaseElement::IsWholeRowHeight", "AFXBASERIBBONELEMENT/CMFCRibbonBaseElement::NotifyCommand", "AFXBASERIBBONELEMENT/CMFCRibbonBaseElement::NotifyHighlightListItem", "AFXBASERIBBONELEMENT/CMFCRibbonBaseElement::OnAddToQAToolbar", "AFXBASERIBBONELEMENT/CMFCRibbonBaseElement::OnAfterChangeRect", "AFXBASERIBBONELEMENT/CMFCRibbonBaseElement::OnAutoRepeat", "AFXBASERIBBONELEMENT/CMFCRibbonBaseElement::OnCalcTextSize", "AFXBASERIBBONELEMENT/CMFCRibbonBaseElement::OnChangeMenuHighlight", "AFXBASERIBBONELEMENT/CMFCRibbonBaseElement::OnDraw", "AFXBASERIBBONELEMENT/CMFCRibbonBaseElement::OnDrawKeyTip", "AFXBASERIBBONELEMENT/CMFCRibbonBaseElement::OnDrawMenuImage", "AFXBASERIBBONELEMENT/CMFCRibbonBaseElement::OnDrawOnList", "AFXBASERIBBONELEMENT/CMFCRibbonBaseElement::OnKey", "AFXBASERIBBONELEMENT/CMFCRibbonBaseElement::OnMenuKey", "AFXBASERIBBONELEMENT/CMFCRibbonBaseElement::OnRTLChanged", "AFXBASERIBBONELEMENT/CMFCRibbonBaseElement::OnShow", "AFXBASERIBBONELEMENT/CMFCRibbonBaseElement::OnShowPopupMenu", "AFXBASERIBBONELEMENT/CMFCRibbonBaseElement::PostMenuCommand", "AFXBASERIBBONELEMENT/CMFCRibbonBaseElement::Redraw", "AFXBASERIBBONELEMENT/CMFCRibbonBaseElement::SetACCData", "AFXBASERIBBONELEMENT/CMFCRibbonBaseElement::SetCompactMode", "AFXBASERIBBONELEMENT/CMFCRibbonBaseElement::SetData", "AFXBASERIBBONELEMENT/CMFCRibbonBaseElement::SetDefaultMenuLook", "AFXBASERIBBONELEMENT/CMFCRibbonBaseElement::SetDescription", "AFXBASERIBBONELEMENT/CMFCRibbonBaseElement::SetID", "AFXBASERIBBONELEMENT/CMFCRibbonBaseElement::SetInitialMode", "AFXBASERIBBONELEMENT/CMFCRibbonBaseElement::SetKeys", "AFXBASERIBBONELEMENT/CMFCRibbonBaseElement::SetOriginal", "AFXBASERIBBONELEMENT/CMFCRibbonBaseElement::SetParentCategory", "AFXBASERIBBONELEMENT/CMFCRibbonBaseElement::SetParentMenu", "AFXBASERIBBONELEMENT/CMFCRibbonBaseElement::SetParentRibbonBar", "AFXBASERIBBONELEMENT/CMFCRibbonBaseElement::SetRect", "AFXBASERIBBONELEMENT/CMFCRibbonBaseElement::SetText", "AFXBASERIBBONELEMENT/CMFCRibbonBaseElement::SetTextAlwaysOnRight", "AFXBASERIBBONELEMENT/CMFCRibbonBaseElement::SetToolTipText", "AFXBASERIBBONELEMENT/CMFCRibbonBaseElement::SetVisible", "AFXBASERIBBONELEMENT/CMFCRibbonBaseElement::StretchHorizontally", "AFXBASERIBBONELEMENT/CMFCRibbonBaseElement::StretchToWholeRow", "AFXBASERIBBONELEMENT/CMFCRibbonBaseElement::UpdateTooltipInfo", "AFXBASERIBBONELEMENT/CMFCRibbonBaseElement::OnProcessKey", "AFXBASERIBBONELEMENT/CMFCRibbonBaseElement::OnSetFocus"] helpviewer_keywords: ["CMFCRibbonBaseElement [MFC], AddToKeyList", "CMFCRibbonBaseElement [MFC], AddToListBox", "CMFCRibbonBaseElement [MFC], CanBeAddedToQuickAccessToolBar", "CMFCRibbonBaseElement [MFC], CanBeCompacted", "CMFCRibbonBaseElement [MFC], CanBeStretched", "CMFCRibbonBaseElement [MFC], CanBeStretchedHorizontally", "CMFCRibbonBaseElement [MFC], CleanUpSizes", "CMFCRibbonBaseElement [MFC], ClosePopupMenu", "CMFCRibbonBaseElement [MFC], CopyFrom", "CMFCRibbonBaseElement [MFC], DestroyCtrl", "CMFCRibbonBaseElement [MFC], DrawImage", "CMFCRibbonBaseElement [MFC], Find", "CMFCRibbonBaseElement [MFC], FindByData", "CMFCRibbonBaseElement [MFC], FindByID", "CMFCRibbonBaseElement [MFC], FindByOriginal", "CMFCRibbonBaseElement [MFC], GetCompactSize", "CMFCRibbonBaseElement [MFC], GetData", "CMFCRibbonBaseElement [MFC], GetDescription", "CMFCRibbonBaseElement [MFC], GetDroppedDown", "CMFCRibbonBaseElement [MFC], GetElements", "CMFCRibbonBaseElement [MFC], GetElementsByID", "CMFCRibbonBaseElement [MFC], GetHighlighted", "CMFCRibbonBaseElement [MFC], GetID", "CMFCRibbonBaseElement [MFC], GetImageSize", "CMFCRibbonBaseElement [MFC], GetIntermediateSize", "CMFCRibbonBaseElement [MFC], GetKeys", "CMFCRibbonBaseElement [MFC], GetKeyTipRect", "CMFCRibbonBaseElement [MFC], GetKeyTipSize", "CMFCRibbonBaseElement [MFC], GetLocationInGroup", "CMFCRibbonBaseElement [MFC], GetMenuKeys", "CMFCRibbonBaseElement [MFC], GetNotifyID", "CMFCRibbonBaseElement [MFC], GetOriginal", "CMFCRibbonBaseElement [MFC], GetParentCategory", "CMFCRibbonBaseElement [MFC], GetParentPanel", "CMFCRibbonBaseElement [MFC], GetParentRibbonBar", "CMFCRibbonBaseElement [MFC], GetParentWnd", "CMFCRibbonBaseElement [MFC], GetPressed", "CMFCRibbonBaseElement [MFC], GetQuickAccessToolBarID", "CMFCRibbonBaseElement [MFC], GetRect", "CMFCRibbonBaseElement [MFC], GetRegularSize", "CMFCRibbonBaseElement [MFC], GetSize", "CMFCRibbonBaseElement [MFC], GetText", "CMFCRibbonBaseElement [MFC], GetToolTipText", "CMFCRibbonBaseElement [MFC], GetTopLevelRibbonBar", "CMFCRibbonBaseElement [MFC], HasCompactMode", "CMFCRibbonBaseElement [MFC], HasFocus", "CMFCRibbonBaseElement [MFC], HasIntermediateMode", "CMFCRibbonBaseElement [MFC], HasLargeMode", "CMFCRibbonBaseElement [MFC], HasMenu", "CMFCRibbonBaseElement [MFC], HitTest", "CMFCRibbonBaseElement [MFC], IsAlignByColumn", "CMFCRibbonBaseElement [MFC], IsAlwaysLargeImage", "CMFCRibbonBaseElement [MFC], IsAutoRepeatMode", "CMFCRibbonBaseElement [MFC], IsChecked", "CMFCRibbonBaseElement [MFC], IsCompactMode", "CMFCRibbonBaseElement [MFC], IsDefaultMenuLook", "CMFCRibbonBaseElement [MFC], IsDisabled", "CMFCRibbonBaseElement [MFC], IsDroppedDown", "CMFCRibbonBaseElement [MFC], IsFocused", "CMFCRibbonBaseElement [MFC], IsGalleryIcon", "CMFCRibbonBaseElement [MFC], IsHighlighted", "CMFCRibbonBaseElement [MFC], IsIntermediateMode", "CMFCRibbonBaseElement [MFC], IsLargeMode", "CMFCRibbonBaseElement [MFC], IsMenuMode", "CMFCRibbonBaseElement [MFC], IsPressed", "CMFCRibbonBaseElement [MFC], IsQATMode", "CMFCRibbonBaseElement [MFC], IsSeparator", "CMFCRibbonBaseElement [MFC], IsShowGroupBorder", "CMFCRibbonBaseElement [MFC], IsShowTooltipOnBottom", "CMFCRibbonBaseElement [MFC], IsTabStop", "CMFCRibbonBaseElement [MFC], IsTextAlwaysOnRight", "CMFCRibbonBaseElement [MFC], IsVisible", "CMFCRibbonBaseElement [MFC], IsWholeRowHeight", "CMFCRibbonBaseElement [MFC], NotifyCommand", "CMFCRibbonBaseElement [MFC], NotifyHighlightListItem", "CMFCRibbonBaseElement [MFC], OnAddToQAToolbar", "CMFCRibbonBaseElement [MFC], OnAfterChangeRect", "CMFCRibbonBaseElement [MFC], OnAutoRepeat", "CMFCRibbonBaseElement [MFC], OnCalcTextSize", "CMFCRibbonBaseElement [MFC], OnChangeMenuHighlight", "CMFCRibbonBaseElement [MFC], OnDraw", "CMFCRibbonBaseElement [MFC], OnDrawKeyTip", "CMFCRibbonBaseElement [MFC], OnDrawMenuImage", "CMFCRibbonBaseElement [MFC], OnDrawOnList", "CMFCRibbonBaseElement [MFC], OnKey", "CMFCRibbonBaseElement [MFC], OnMenuKey", "CMFCRibbonBaseElement [MFC], OnRTLChanged", "CMFCRibbonBaseElement [MFC], OnShow", "CMFCRibbonBaseElement [MFC], OnShowPopupMenu", "CMFCRibbonBaseElement [MFC], PostMenuCommand", "CMFCRibbonBaseElement [MFC], Redraw", "CMFCRibbonBaseElement [MFC], SetACCData", "CMFCRibbonBaseElement [MFC], SetCompactMode", "CMFCRibbonBaseElement [MFC], SetData", "CMFCRibbonBaseElement [MFC], SetDefaultMenuLook", "CMFCRibbonBaseElement [MFC], SetDescription", "CMFCRibbonBaseElement [MFC], SetID", "CMFCRibbonBaseElement [MFC], SetInitialMode", "CMFCRibbonBaseElement [MFC], SetKeys", "CMFCRibbonBaseElement [MFC], SetOriginal", "CMFCRibbonBaseElement [MFC], SetParentCategory", "CMFCRibbonBaseElement [MFC], SetParentMenu", "CMFCRibbonBaseElement [MFC], SetParentRibbonBar", "CMFCRibbonBaseElement [MFC], SetRect", "CMFCRibbonBaseElement [MFC], SetText", "CMFCRibbonBaseElement [MFC], SetTextAlwaysOnRight", "CMFCRibbonBaseElement [MFC], SetToolTipText", "CMFCRibbonBaseElement [MFC], SetVisible", "CMFCRibbonBaseElement [MFC], StretchHorizontally", "CMFCRibbonBaseElement [MFC], StretchToWholeRow", "CMFCRibbonBaseElement [MFC], UpdateTooltipInfo", "CMFCRibbonBaseElement [MFC], OnProcessKey", "CMFCRibbonBaseElement [MFC], OnSetFocus"] -ms.assetid: 419ea91b-5062-44cc-b0a3-f87d29566f62 --- # CMFCRibbonBaseElement Class @@ -131,7 +130,7 @@ class CMFCRibbonBaseElement : public CObject |[CMFCRibbonBaseElement::SetParentCategory](#setparentcategory)|Sets the parent category for the ribbon element.| |[CMFCRibbonBaseElement::SetParentMenu](#setparentmenu)|Sets the parent menu container for the ribbon element.| |[CMFCRibbonBaseElement::SetParentRibbonBar](#setparentribbonbar)|Sets the parent ribbon bar for the ribbon element.| -|[CMFCRibbonBaseElement::SetRect](#setrect)|Sets the dimensions fot he display rectangle for the ribbon element.| +|[CMFCRibbonBaseElement::SetRect](#setrect)|Sets the dimensions of the display rectangle for the ribbon element.| |[CMFCRibbonBaseElement::SetText](#settext)|Sets the text for the ribbon element.| |[CMFCRibbonBaseElement::SetTextAlwaysOnRight](#settextalwaysonright)|Sets the text for the ribbon element to display on the right.| |[CMFCRibbonBaseElement::SetToolTipText](#settooltiptext)|Sets the tooltip text for the ribbon element.| @@ -2042,5 +2041,5 @@ TRUE if the ribbon element is focused; otherwise FALSE. ## See also -[Hierarchy Chart](../../mfc/hierarchy-chart.md)
+[Hierarchy Chart](../../mfc/hierarchy-chart.md)\ [Classes](../../mfc/reference/mfc-classes.md) diff --git a/docs/mfc/reference/cmfcribboncategory-class.md b/docs/mfc/reference/cmfcribboncategory-class.md index 74d7ee56cb8..c63b58d2c59 100644 --- a/docs/mfc/reference/cmfcribboncategory-class.md +++ b/docs/mfc/reference/cmfcribboncategory-class.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: CMFCRibbonCategory Class" title: "CMFCRibbonCategory Class" -ms.date: "11/19/2018" +description: "Learn more about: CMFCRibbonCategory Class" +ms.date: 11/19/2018 f1_keywords: ["CMFCRibbonCategory", "AFXRIBBONCATEGORY/CMFCRibbonCategory", "AFXRIBBONCATEGORY/CMFCRibbonCategory::CMFCRibbonCategory", "AFXRIBBONCATEGORY/CMFCRibbonCategory::AddHidden", "AFXRIBBONCATEGORY/CMFCRibbonCategory::AddPanel", "AFXRIBBONCATEGORY/CMFCRibbonCategory::CopyFrom", "AFXRIBBONCATEGORY/CMFCRibbonCategory::FindByData", "AFXRIBBONCATEGORY/CMFCRibbonCategory::FindByID", "AFXRIBBONCATEGORY/CMFCRibbonCategory::FindPanelWithElem", "AFXRIBBONCATEGORY/CMFCRibbonCategory::GetContextID", "AFXRIBBONCATEGORY/CMFCRibbonCategory::GetData", "AFXRIBBONCATEGORY/CMFCRibbonCategory::GetDroppedDown", "AFXRIBBONCATEGORY/CMFCRibbonCategory::GetElements", "AFXRIBBONCATEGORY/CMFCRibbonCategory::GetElementsByID", "AFXRIBBONCATEGORY/CMFCRibbonCategory::GetFirstVisibleElement", "AFXRIBBONCATEGORY/CMFCRibbonCategory::GetFocused", "AFXRIBBONCATEGORY/CMFCRibbonCategory::GetHighlighted", "AFXRIBBONCATEGORY/CMFCRibbonCategory::GetImageCount", "AFXRIBBONCATEGORY/CMFCRibbonCategory::GetImageSize", "AFXRIBBONCATEGORY/CMFCRibbonCategory::GetItemIDsList", "AFXRIBBONCATEGORY/CMFCRibbonCategory::GetLastVisibleElement", "AFXRIBBONCATEGORY/CMFCRibbonCategory::GetLargeImages", "AFXRIBBONCATEGORY/CMFCRibbonCategory::GetMaxHeight", "AFXRIBBONCATEGORY/CMFCRibbonCategory::GetName", "AFXRIBBONCATEGORY/CMFCRibbonCategory::GetPanel", "AFXRIBBONCATEGORY/CMFCRibbonCategory::GetPanelCount", "AFXRIBBONCATEGORY/CMFCRibbonCategory::GetPanelFromPoint", "AFXRIBBONCATEGORY/CMFCRibbonCategory::GetPanelIndex", "AFXRIBBONCATEGORY/CMFCRibbonCategory::GetParentButton", "AFXRIBBONCATEGORY/CMFCRibbonCategory::GetParentMenuBar", "AFXRIBBONCATEGORY/CMFCRibbonCategory::GetParentRibbonBar", "AFXRIBBONCATEGORY/CMFCRibbonCategory::GetRect", "AFXRIBBONCATEGORY/CMFCRibbonCategory::GetSmallImages", "AFXRIBBONCATEGORY/CMFCRibbonCategory::GetTabColor", "AFXRIBBONCATEGORY/CMFCRibbonCategory::GetTabRect", "AFXRIBBONCATEGORY/CMFCRibbonCategory::GetTextTopLine", "AFXRIBBONCATEGORY/CMFCRibbonCategory::GetVisibleElements", "AFXRIBBONCATEGORY/CMFCRibbonCategory::HighlightPanel", "AFXRIBBONCATEGORY/CMFCRibbonCategory::HitTest", "AFXRIBBONCATEGORY/CMFCRibbonCategory::HitTestEx", "AFXRIBBONCATEGORY/CMFCRibbonCategory::HitTestScrollButtons", "AFXRIBBONCATEGORY/CMFCRibbonCategory::IsActive", "AFXRIBBONCATEGORY/CMFCRibbonCategory::IsVisible", "AFXRIBBONCATEGORY/CMFCRibbonCategory::IsWindows7Look", "AFXRIBBONCATEGORY/CMFCRibbonCategory::NotifyControlCommand", "AFXRIBBONCATEGORY/CMFCRibbonCategory::OnCancelMode", "AFXRIBBONCATEGORY/CMFCRibbonCategory::OnDraw", "AFXRIBBONCATEGORY/CMFCRibbonCategory::OnDrawImage", "AFXRIBBONCATEGORY/CMFCRibbonCategory::OnDrawMenuBorder", "AFXRIBBONCATEGORY/CMFCRibbonCategory::OnKey", "AFXRIBBONCATEGORY/CMFCRibbonCategory::OnLButtonDown", "AFXRIBBONCATEGORY/CMFCRibbonCategory::OnLButtonUp", "AFXRIBBONCATEGORY/CMFCRibbonCategory::OnMouseMove", "AFXRIBBONCATEGORY/CMFCRibbonCategory::OnRTLChanged", "AFXRIBBONCATEGORY/CMFCRibbonCategory::OnScrollHorz", "AFXRIBBONCATEGORY/CMFCRibbonCategory::OnUpdateCmdUI", "AFXRIBBONCATEGORY/CMFCRibbonCategory::RecalcLayout", "AFXRIBBONCATEGORY/CMFCRibbonCategory::RemovePanel", "AFXRIBBONCATEGORY/CMFCRibbonCategory::ReposPanels", "AFXRIBBONCATEGORY/CMFCRibbonCategory::SetCollapseOrder", "AFXRIBBONCATEGORY/CMFCRibbonCategory::SetData", "AFXRIBBONCATEGORY/CMFCRibbonCategory::SetKeys", "AFXRIBBONCATEGORY/CMFCRibbonCategory::SetName", "AFXRIBBONCATEGORY/CMFCRibbonCategory::SetTabColor"] helpviewer_keywords: ["CMFCRibbonCategory [MFC], CMFCRibbonCategory", "CMFCRibbonCategory [MFC], AddHidden", "CMFCRibbonCategory [MFC], AddPanel", "CMFCRibbonCategory [MFC], CopyFrom", "CMFCRibbonCategory [MFC], FindByData", "CMFCRibbonCategory [MFC], FindByID", "CMFCRibbonCategory [MFC], FindPanelWithElem", "CMFCRibbonCategory [MFC], GetContextID", "CMFCRibbonCategory [MFC], GetData", "CMFCRibbonCategory [MFC], GetDroppedDown", "CMFCRibbonCategory [MFC], GetElements", "CMFCRibbonCategory [MFC], GetElementsByID", "CMFCRibbonCategory [MFC], GetFirstVisibleElement", "CMFCRibbonCategory [MFC], GetFocused", "CMFCRibbonCategory [MFC], GetHighlighted", "CMFCRibbonCategory [MFC], GetImageCount", "CMFCRibbonCategory [MFC], GetImageSize", "CMFCRibbonCategory [MFC], GetItemIDsList", "CMFCRibbonCategory [MFC], GetLastVisibleElement", "CMFCRibbonCategory [MFC], GetLargeImages", "CMFCRibbonCategory [MFC], GetMaxHeight", "CMFCRibbonCategory [MFC], GetName", "CMFCRibbonCategory [MFC], GetPanel", "CMFCRibbonCategory [MFC], GetPanelCount", "CMFCRibbonCategory [MFC], GetPanelFromPoint", "CMFCRibbonCategory [MFC], GetPanelIndex", "CMFCRibbonCategory [MFC], GetParentButton", "CMFCRibbonCategory [MFC], GetParentMenuBar", "CMFCRibbonCategory [MFC], GetParentRibbonBar", "CMFCRibbonCategory [MFC], GetRect", "CMFCRibbonCategory [MFC], GetSmallImages", "CMFCRibbonCategory [MFC], GetTabColor", "CMFCRibbonCategory [MFC], GetTabRect", "CMFCRibbonCategory [MFC], GetTextTopLine", "CMFCRibbonCategory [MFC], GetVisibleElements", "CMFCRibbonCategory [MFC], HighlightPanel", "CMFCRibbonCategory [MFC], HitTest", "CMFCRibbonCategory [MFC], HitTestEx", "CMFCRibbonCategory [MFC], HitTestScrollButtons", "CMFCRibbonCategory [MFC], IsActive", "CMFCRibbonCategory [MFC], IsVisible", "CMFCRibbonCategory [MFC], IsWindows7Look", "CMFCRibbonCategory [MFC], NotifyControlCommand", "CMFCRibbonCategory [MFC], OnCancelMode", "CMFCRibbonCategory [MFC], OnDraw", "CMFCRibbonCategory [MFC], OnDrawImage", "CMFCRibbonCategory [MFC], OnDrawMenuBorder", "CMFCRibbonCategory [MFC], OnKey", "CMFCRibbonCategory [MFC], OnLButtonDown", "CMFCRibbonCategory [MFC], OnLButtonUp", "CMFCRibbonCategory [MFC], OnMouseMove", "CMFCRibbonCategory [MFC], OnRTLChanged", "CMFCRibbonCategory [MFC], OnScrollHorz", "CMFCRibbonCategory [MFC], OnUpdateCmdUI", "CMFCRibbonCategory [MFC], RecalcLayout", "CMFCRibbonCategory [MFC], RemovePanel", "CMFCRibbonCategory [MFC], ReposPanels", "CMFCRibbonCategory [MFC], SetCollapseOrder", "CMFCRibbonCategory [MFC], SetData", "CMFCRibbonCategory [MFC], SetKeys", "CMFCRibbonCategory [MFC], SetName", "CMFCRibbonCategory [MFC], SetTabColor"] -ms.assetid: 99ba25b6-d060-4fdd-bfab-3c46c22981bb --- # CMFCRibbonCategory Class @@ -99,7 +98,7 @@ The `CMFCRibbonTab` class draws ribbon categories. It is derived from [CMFCRibbo This following example demonstrates how to create a ribbon category and add a panel to it. ```cpp -// Create a new ribbon category and get a pointer to it` +// Create a new ribbon category and get a pointer to it CMFCRibbonCategory* pCategory = m_wndRibbonBar.AddCategory (_T("&Write"), // Category name IDB_WRITE, // Category small images (16 x 16) diff --git a/docs/mfc/reference/cmfcribboncheckbox-class.md b/docs/mfc/reference/cmfcribboncheckbox-class.md index 57ce564c554..dd35d634409 100644 --- a/docs/mfc/reference/cmfcribboncheckbox-class.md +++ b/docs/mfc/reference/cmfcribboncheckbox-class.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: CMFCRibbonCheckBox Class" title: "CMFCRibbonCheckBox Class" -ms.date: "11/04/2016" +description: "Learn more about: CMFCRibbonCheckBox Class" +ms.date: 11/04/2016 f1_keywords: ["CMFCRibbonCheckBox", "AFXRIBBONCHECKBOX/CMFCRibbonCheckBox", "AFXRIBBONCHECKBOX/CMFCRibbonCheckBox::CMFCRibbonCheckBox", "AFXRIBBONCHECKBOX/CMFCRibbonCheckBox::GetCompactSize", "AFXRIBBONCHECKBOX/CMFCRibbonCheckBox::GetIntermediateSize", "AFXRIBBONCHECKBOX/CMFCRibbonCheckBox::GetRegularSize", "AFXRIBBONCHECKBOX/CMFCRibbonCheckBox::IsDrawTooltipImage", "AFXRIBBONCHECKBOX/CMFCRibbonCheckBox::OnDraw", "AFXRIBBONCHECKBOX/CMFCRibbonCheckBox::OnDrawMenuImage", "AFXRIBBONCHECKBOX/CMFCRibbonCheckBox::OnDrawOnList", "AFXRIBBONCHECKBOX/CMFCRibbonCheckBox::SetACCData"] helpviewer_keywords: ["CMFCRibbonCheckBox [MFC], CMFCRibbonCheckBox", "CMFCRibbonCheckBox [MFC], GetCompactSize", "CMFCRibbonCheckBox [MFC], GetIntermediateSize", "CMFCRibbonCheckBox [MFC], GetRegularSize", "CMFCRibbonCheckBox [MFC], IsDrawTooltipImage", "CMFCRibbonCheckBox [MFC], OnDraw", "CMFCRibbonCheckBox [MFC], OnDrawMenuImage", "CMFCRibbonCheckBox [MFC], OnDrawOnList", "CMFCRibbonCheckBox [MFC], SetACCData"] -ms.assetid: 3a6c3891-c8d1-4af0-b954-7b9ab048782a --- # CMFCRibbonCheckBox Class @@ -131,7 +130,7 @@ A `CSize` object containing the intermediate size of the check box. ### Remarks -If not overridden, calculates the intermediate size as the default check box size ( `AFX_CHECK_BOX_DEFAULT_SIZE`) plus the text size, plus margins. +If not overridden, calculates the intermediate size as the default check box size (`AFX_CHECK_BOX_DEFAULT_SIZE`) plus the text size, plus margins. ## CMFCRibbonCheckBox::GetRegularSize diff --git a/docs/mfc/reference/cmfcribboncombobox-class.md b/docs/mfc/reference/cmfcribboncombobox-class.md index 91d6fe19fa7..8c68550f07e 100644 --- a/docs/mfc/reference/cmfcribboncombobox-class.md +++ b/docs/mfc/reference/cmfcribboncombobox-class.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: CMFCRibbonComboBox Class" title: "CMFCRibbonComboBox Class" -ms.date: "11/04/2016" +description: "Learn more about: CMFCRibbonComboBox Class" +ms.date: 11/04/2016 f1_keywords: ["CMFCRibbonComboBox", "AFXRIBBONCOMBOBOX/CMFCRibbonComboBox", "AFXRIBBONCOMBOBOX/CMFCRibbonComboBox::CMFCRibbonComboBox", "AFXRIBBONCOMBOBOX/CMFCRibbonComboBox::AddItem", "AFXRIBBONCOMBOBOX/CMFCRibbonComboBox::DeleteItem", "AFXRIBBONCOMBOBOX/CMFCRibbonComboBox::EnableDropDownListResize", "AFXRIBBONCOMBOBOX/CMFCRibbonComboBox::FindItem", "AFXRIBBONCOMBOBOX/CMFCRibbonComboBox::GetCount", "AFXRIBBONCOMBOBOX/CMFCRibbonComboBox::GetCurSel", "AFXRIBBONCOMBOBOX/CMFCRibbonComboBox::GetDropDownHeight", "AFXRIBBONCOMBOBOX/CMFCRibbonComboBox::GetIntermediateSize", "AFXRIBBONCOMBOBOX/CMFCRibbonComboBox::GetItem", "AFXRIBBONCOMBOBOX/CMFCRibbonComboBox::GetItemData", "AFXRIBBONCOMBOBOX/CMFCRibbonComboBox::HasEditBox", "AFXRIBBONCOMBOBOX/CMFCRibbonComboBox::IsResizeDropDownList", "AFXRIBBONCOMBOBOX/CMFCRibbonComboBox::OnSelectItem", "AFXRIBBONCOMBOBOX/CMFCRibbonComboBox::RemoveAllItems", "AFXRIBBONCOMBOBOX/CMFCRibbonComboBox::SelectItem", "AFXRIBBONCOMBOBOX/CMFCRibbonComboBox::SetDropDownHeight"] helpviewer_keywords: ["CMFCRibbonComboBox [MFC], CMFCRibbonComboBox", "CMFCRibbonComboBox [MFC], AddItem", "CMFCRibbonComboBox [MFC], DeleteItem", "CMFCRibbonComboBox [MFC], EnableDropDownListResize", "CMFCRibbonComboBox [MFC], FindItem", "CMFCRibbonComboBox [MFC], GetCount", "CMFCRibbonComboBox [MFC], GetCurSel", "CMFCRibbonComboBox [MFC], GetDropDownHeight", "CMFCRibbonComboBox [MFC], GetIntermediateSize", "CMFCRibbonComboBox [MFC], GetItem", "CMFCRibbonComboBox [MFC], GetItemData", "CMFCRibbonComboBox [MFC], HasEditBox", "CMFCRibbonComboBox [MFC], IsResizeDropDownList", "CMFCRibbonComboBox [MFC], OnSelectItem", "CMFCRibbonComboBox [MFC], RemoveAllItems", "CMFCRibbonComboBox [MFC], SelectItem", "CMFCRibbonComboBox [MFC], SetDropDownHeight"] -ms.assetid: 9b29a6a4-cf17-4152-9b13-0bf90784b30d --- # CMFCRibbonComboBox Class @@ -102,9 +101,9 @@ public: CMFCRibbonComboBox( UINT nID, BOOL bHasEditBox=TRUE, - Int nWidth=-1, + int nWidth=-1, LPCTSTR lpszLabel=NULL, - Int nImage=-1); + int nImage=-1); protected: CMFCRibbonComboBox(); diff --git a/docs/mfc/reference/cmfcribbonfontcombobox-class.md b/docs/mfc/reference/cmfcribbonfontcombobox-class.md index 3582dbb7f95..e37df6dfc0c 100644 --- a/docs/mfc/reference/cmfcribbonfontcombobox-class.md +++ b/docs/mfc/reference/cmfcribbonfontcombobox-class.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: CMFCRibbonFontComboBox Class" title: "CMFCRibbonFontComboBox Class" +description: "Learn more about: CMFCRibbonFontComboBox Class" ms.date: "11/04/2016" f1_keywords: ["CMFCRibbonFontComboBox", "AFXRIBBONCOMBOBOX/CMFCRibbonFontComboBox", "AFXRIBBONCOMBOBOX/CMFCRibbonFontComboBox::CMFCRibbonFontComboBox", "AFXRIBBONCOMBOBOX/CMFCRibbonFontComboBox::BuildFonts", "AFXRIBBONCOMBOBOX/CMFCRibbonFontComboBox::GetCharSet", "AFXRIBBONCOMBOBOX/CMFCRibbonFontComboBox::GetFontDesc", "AFXRIBBONCOMBOBOX/CMFCRibbonFontComboBox::GetFontType", "AFXRIBBONCOMBOBOX/CMFCRibbonFontComboBox::GetPitchAndFamily", "AFXRIBBONCOMBOBOX/CMFCRibbonFontComboBox::RebuildFonts", "AFXRIBBONCOMBOBOX/CMFCRibbonFontComboBox::SetFont"] helpviewer_keywords: ["CMFCRibbonFontComboBox [MFC], CMFCRibbonFontComboBox", "CMFCRibbonFontComboBox [MFC], BuildFonts", "CMFCRibbonFontComboBox [MFC], GetCharSet", "CMFCRibbonFontComboBox [MFC], GetFontDesc", "CMFCRibbonFontComboBox [MFC], GetFontType", "CMFCRibbonFontComboBox [MFC], GetPitchAndFamily", "CMFCRibbonFontComboBox [MFC], RebuildFonts", "CMFCRibbonFontComboBox [MFC], SetFont"] -ms.assetid: 33b4db50-df4f-45fa-8f05-2e6e73c31435 --- # CMFCRibbonFontComboBox Class @@ -110,7 +109,7 @@ CMFCRibbonFontComboBox( [in] Specifies which font types to display in the combo box. Valid options are DEVICE_FONTTYPE, RASTER_FONTTYPE, and TRUETYPE_FONTTYPE, or any bitwise combination thereof. *nCharSet*
-[in] Filters the fonts in the combo box to those that belong to the specified character set.. +[in] Filters the fonts in the combo box to those that belong to the specified character set. *nPitchAndFamily*
[in] Specifies the pitch and the family of the fonts that are displayed in the combo box. @@ -224,6 +223,6 @@ Pitch and the family (see LOGFONT in the Windows SDK documentation). ## See also -[Hierarchy Chart](../../mfc/hierarchy-chart.md)
-[Classes](../../mfc/reference/mfc-classes.md)
+[Hierarchy Chart](../../mfc/hierarchy-chart.md)\ +[Classes](../../mfc/reference/mfc-classes.md)\ [CMFCRibbonComboBox Class](../../mfc/reference/cmfcribboncombobox-class.md) diff --git a/docs/mfc/reference/cmfctaskspane-class.md b/docs/mfc/reference/cmfctaskspane-class.md index 82935354acd..3f766743078 100644 --- a/docs/mfc/reference/cmfctaskspane-class.md +++ b/docs/mfc/reference/cmfctaskspane-class.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: CMFCTasksPane Class" title: "CMFCTasksPane Class" -ms.date: "07/02/2019" +description: "Learn more about: CMFCTasksPane Class" +ms.date: 07/02/2019 f1_keywords: ["CMFCTasksPane", "AFXTASKSPANE/CMFCTasksPane", "AFXTASKSPANE/CMFCTasksPane::CMFCTasksPane", "AFXTASKSPANE/CMFCTasksPane::AddGroup", "AFXTASKSPANE/CMFCTasksPane::AddLabel", "AFXTASKSPANE/CMFCTasksPane::AddMRUFilesList", "AFXTASKSPANE/CMFCTasksPane::AddPage", "AFXTASKSPANE/CMFCTasksPane::AddSeparator", "AFXTASKSPANE/CMFCTasksPane::AddTask", "AFXTASKSPANE/CMFCTasksPane::AddWindow", "AFXTASKSPANE/CMFCTasksPane::CollapseAllGroups", "AFXTASKSPANE/CMFCTasksPane::CollapseGroup", "AFXTASKSPANE/CMFCTasksPane::CreateDefaultMiniframe", "AFXTASKSPANE/CMFCTasksPane::CreateMenu", "AFXTASKSPANE/CMFCTasksPane::EnableAnimation", "AFXTASKSPANE/CMFCTasksPane::EnableGroupCollapse", "AFXTASKSPANE/CMFCTasksPane::EnableHistoryMenuButtons", "AFXTASKSPANE/CMFCTasksPane::EnableNavigationToolbar", "AFXTASKSPANE/CMFCTasksPane::EnableOffsetCustomControls", "AFXTASKSPANE/CMFCTasksPane::EnableScrollButtons", "AFXTASKSPANE/CMFCTasksPane::EnableWrapLabels", "AFXTASKSPANE/CMFCTasksPane::EnableWrapTasks", "AFXTASKSPANE/CMFCTasksPane::GetActivePage", "AFXTASKSPANE/CMFCTasksPane::GetGroupCaptionHeight", "AFXTASKSPANE/CMFCTasksPane::GetGroupCaptionHorzOffset", "AFXTASKSPANE/CMFCTasksPane::GetGroupCaptionVertOffset", "AFXTASKSPANE/CMFCTasksPane::GetGroupCount", "AFXTASKSPANE/CMFCTasksPane::GetGroupLocation", "AFXTASKSPANE/CMFCTasksPane::GetGroupVertOffset", "AFXTASKSPANE/CMFCTasksPane::GetHorzMargin", "AFXTASKSPANE/CMFCTasksPane::GetNextPages", "AFXTASKSPANE/CMFCTasksPane::GetPageByGroup", "AFXTASKSPANE/CMFCTasksPane::GetPagesCount", "AFXTASKSPANE/CMFCTasksPane::GetPreviousPages", "AFXTASKSPANE/CMFCTasksPane::GetScrollBarCtrl", "AFXTASKSPANE/CMFCTasksPane::GetTask", "AFXTASKSPANE/CMFCTasksPane::GetTaskCount", "AFXTASKSPANE/CMFCTasksPane::GetTaskGroup", "AFXTASKSPANE/CMFCTasksPane::GetTaskLocation", "AFXTASKSPANE/CMFCTasksPane::GetTasksHorzOffset", "AFXTASKSPANE/CMFCTasksPane::GetTasksIconHorzOffset", "AFXTASKSPANE/CMFCTasksPane::GetTasksIconVertOffset", "AFXTASKSPANE/CMFCTasksPane::GetVertMargin", "AFXTASKSPANE/CMFCTasksPane::IsAccessibilityCompatible", "AFXTASKSPANE/CMFCTasksPane::IsAnimationEnabled", "AFXTASKSPANE/CMFCTasksPane::IsBackButtonEnabled", "AFXTASKSPANE/CMFCTasksPane::IsForwardButtonEnabled", "AFXTASKSPANE/CMFCTasksPane::IsGroupCollapseEnabled", "AFXTASKSPANE/CMFCTasksPane::IsHistoryMenuButtonsEnabled", "AFXTASKSPANE/CMFCTasksPane::IsNavigationToolbarEnabled", "AFXTASKSPANE/CMFCTasksPane::IsToolBox", "AFXTASKSPANE/CMFCTasksPane::IsWrapLabelsEnabled", "AFXTASKSPANE/CMFCTasksPane::IsWrapTasksEnabled", "AFXTASKSPANE/CMFCTasksPane::LoadState", "AFXTASKSPANE/CMFCTasksPane::OnCancel", "AFXTASKSPANE/CMFCTasksPane::OnClickTask", "AFXTASKSPANE/CMFCTasksPane::OnOK", "AFXTASKSPANE/CMFCTasksPane::OnPressBackButton", "AFXTASKSPANE/CMFCTasksPane::OnPressForwardButton", "AFXTASKSPANE/CMFCTasksPane::OnPressHomeButton", "AFXTASKSPANE/CMFCTasksPane::OnPressOtherButton", "AFXTASKSPANE/CMFCTasksPane::OnSetAccData", "AFXTASKSPANE/CMFCTasksPane::OnUpdateCmdUI", "AFXTASKSPANE/CMFCTasksPane::PreTranslateMessage", "AFXTASKSPANE/CMFCTasksPane::RecalcLayout", "AFXTASKSPANE/CMFCTasksPane::RemoveAllGroups", "AFXTASKSPANE/CMFCTasksPane::RemoveAllPages", "AFXTASKSPANE/CMFCTasksPane::RemoveAllTasks", "AFXTASKSPANE/CMFCTasksPane::RemoveGroup", "AFXTASKSPANE/CMFCTasksPane::RemovePage", "AFXTASKSPANE/CMFCTasksPane::RemoveTask", "AFXTASKSPANE/CMFCTasksPane::SaveState", "AFXTASKSPANE/CMFCTasksPane::Serialize", "AFXTASKSPANE/CMFCTasksPane::SetActivePage", "AFXTASKSPANE/CMFCTasksPane::SetCaption", "AFXTASKSPANE/CMFCTasksPane::SetGroupCaptionHeight", "AFXTASKSPANE/CMFCTasksPane::SetGroupCaptionHorzOffset", "AFXTASKSPANE/CMFCTasksPane::SetGroupCaptionVertOffset", "AFXTASKSPANE/CMFCTasksPane::SetGroupName", "AFXTASKSPANE/CMFCTasksPane::SetGroupTextColor", "AFXTASKSPANE/CMFCTasksPane::SetGroupVertOffset", "AFXTASKSPANE/CMFCTasksPane::SetHorzMargin", "AFXTASKSPANE/CMFCTasksPane::SetIconsList", "AFXTASKSPANE/CMFCTasksPane::SetPageCaption", "AFXTASKSPANE/CMFCTasksPane::SetTaskName", "AFXTASKSPANE/CMFCTasksPane::SetTasksIconHorzOffset", "AFXTASKSPANE/CMFCTasksPane::SetTasksIconVertOffset", "AFXTASKSPANE/CMFCTasksPane::SetTaskTextColor", "AFXTASKSPANE/CMFCTasksPane::SetTasksHorzOffset", "AFXTASKSPANE/CMFCTasksPane::SetVertMargin", "AFXTASKSPANE/CMFCTasksPane::SetWindowHeight", "AFXTASKSPANE/CMFCTasksPane::ShowCommandMessageString", "AFXTASKSPANE/CMFCTasksPane::ShowTask", "AFXTASKSPANE/CMFCTasksPane::ShowTaskByCmdId", "AFXTASKSPANE/CMFCTasksPane::Update", "AFXTASKSPANE/CMFCTasksPane::OnActivateTasksPanePage"] helpviewer_keywords: ["CMFCTasksPane [MFC], CMFCTasksPane", "CMFCTasksPane [MFC], AddGroup", "CMFCTasksPane [MFC], AddLabel", "CMFCTasksPane [MFC], AddMRUFilesList", "CMFCTasksPane [MFC], AddPage", "CMFCTasksPane [MFC], AddSeparator", "CMFCTasksPane [MFC], AddTask", "CMFCTasksPane [MFC], AddWindow", "CMFCTasksPane [MFC], CollapseAllGroups", "CMFCTasksPane [MFC], CollapseGroup", "CMFCTasksPane [MFC], CreateDefaultMiniframe", "CMFCTasksPane [MFC], CreateMenu", "CMFCTasksPane [MFC], EnableAnimation", "CMFCTasksPane [MFC], EnableGroupCollapse", "CMFCTasksPane [MFC], EnableHistoryMenuButtons", "CMFCTasksPane [MFC], EnableNavigationToolbar", "CMFCTasksPane [MFC], EnableOffsetCustomControls", "CMFCTasksPane [MFC], EnableScrollButtons", "CMFCTasksPane [MFC], EnableWrapLabels", "CMFCTasksPane [MFC], EnableWrapTasks", "CMFCTasksPane [MFC], GetActivePage", "CMFCTasksPane [MFC], GetGroupCaptionHeight", "CMFCTasksPane [MFC], GetGroupCaptionHorzOffset", "CMFCTasksPane [MFC], GetGroupCaptionVertOffset", "CMFCTasksPane [MFC], GetGroupCount", "CMFCTasksPane [MFC], GetGroupLocation", "CMFCTasksPane [MFC], GetGroupVertOffset", "CMFCTasksPane [MFC], GetHorzMargin", "CMFCTasksPane [MFC], GetNextPages", "CMFCTasksPane [MFC], GetPageByGroup", "CMFCTasksPane [MFC], GetPagesCount", "CMFCTasksPane [MFC], GetPreviousPages", "CMFCTasksPane [MFC], GetScrollBarCtrl", "CMFCTasksPane [MFC], GetTask", "CMFCTasksPane [MFC], GetTaskCount", "CMFCTasksPane [MFC], GetTaskGroup", "CMFCTasksPane [MFC], GetTaskLocation", "CMFCTasksPane [MFC], GetTasksHorzOffset", "CMFCTasksPane [MFC], GetTasksIconHorzOffset", "CMFCTasksPane [MFC], GetTasksIconVertOffset", "CMFCTasksPane [MFC], GetVertMargin", "CMFCTasksPane [MFC], IsAccessibilityCompatible", "CMFCTasksPane [MFC], IsAnimationEnabled", "CMFCTasksPane [MFC], IsBackButtonEnabled", "CMFCTasksPane [MFC], IsForwardButtonEnabled", "CMFCTasksPane [MFC], IsGroupCollapseEnabled", "CMFCTasksPane [MFC], IsHistoryMenuButtonsEnabled", "CMFCTasksPane [MFC], IsNavigationToolbarEnabled", "CMFCTasksPane [MFC], IsToolBox", "CMFCTasksPane [MFC], IsWrapLabelsEnabled", "CMFCTasksPane [MFC], IsWrapTasksEnabled", "CMFCTasksPane [MFC], LoadState", "CMFCTasksPane [MFC], OnCancel", "CMFCTasksPane [MFC], OnClickTask", "CMFCTasksPane [MFC], OnOK", "CMFCTasksPane [MFC], OnPressBackButton", "CMFCTasksPane [MFC], OnPressForwardButton", "CMFCTasksPane [MFC], OnPressHomeButton", "CMFCTasksPane [MFC], OnPressOtherButton", "CMFCTasksPane [MFC], OnSetAccData", "CMFCTasksPane [MFC], OnUpdateCmdUI", "CMFCTasksPane [MFC], PreTranslateMessage", "CMFCTasksPane [MFC], RecalcLayout", "CMFCTasksPane [MFC], RemoveAllGroups", "CMFCTasksPane [MFC], RemoveAllPages", "CMFCTasksPane [MFC], RemoveAllTasks", "CMFCTasksPane [MFC], RemoveGroup", "CMFCTasksPane [MFC], RemovePage", "CMFCTasksPane [MFC], RemoveTask", "CMFCTasksPane [MFC], SaveState", "CMFCTasksPane [MFC], Serialize", "CMFCTasksPane [MFC], SetActivePage", "CMFCTasksPane [MFC], SetCaption", "CMFCTasksPane [MFC], SetGroupCaptionHeight", "CMFCTasksPane [MFC], SetGroupCaptionHorzOffset", "CMFCTasksPane [MFC], SetGroupCaptionVertOffset", "CMFCTasksPane [MFC], SetGroupName", "CMFCTasksPane [MFC], SetGroupTextColor", "CMFCTasksPane [MFC], SetGroupVertOffset", "CMFCTasksPane [MFC], SetHorzMargin", "CMFCTasksPane [MFC], SetIconsList", "CMFCTasksPane [MFC], SetPageCaption", "CMFCTasksPane [MFC], SetTaskName", "CMFCTasksPane [MFC], SetTasksIconHorzOffset", "CMFCTasksPane [MFC], SetTasksIconVertOffset", "CMFCTasksPane [MFC], SetTaskTextColor", "CMFCTasksPane [MFC], SetTasksHorzOffset", "CMFCTasksPane [MFC], SetVertMargin", "CMFCTasksPane [MFC], SetWindowHeight", "CMFCTasksPane [MFC], ShowCommandMessageString", "CMFCTasksPane [MFC], ShowTask", "CMFCTasksPane [MFC], ShowTaskByCmdId", "CMFCTasksPane [MFC], Update", "CMFCTasksPane [MFC], OnActivateTasksPanePage"] -ms.assetid: b456328e-2525-4642-b78b-9edd1a1a7d3f --- # CMFCTasksPane Class @@ -1461,7 +1460,7 @@ void SetGroupCaptionHeight(int n = -1); Call this method to customize the margins of the task pane elements. -If *n* is -1, the framework determines the margin value by using the visual manager ( `CMFCVisualManager::GetTasksPaneGroupCaptionHeight`). The default caption height is 25 pixels. +If *n* is -1, the framework determines the margin value by using the visual manager (`CMFCVisualManager::GetTasksPaneGroupCaptionHeight`). The default caption height is 25 pixels. ## CMFCTasksPane::SetGroupCaptionHorzOffset diff --git a/docs/mfc/reference/cmfctoolbar-class.md b/docs/mfc/reference/cmfctoolbar-class.md index 236254137a2..9e9384ef1d5 100644 --- a/docs/mfc/reference/cmfctoolbar-class.md +++ b/docs/mfc/reference/cmfctoolbar-class.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: CMFCToolBar Class" title: "CMFCToolBar Class" -ms.date: "11/04/2016" +description: "Learn more about: CMFCToolBar Class" +ms.date: 11/04/2016 f1_keywords: ["CMFCToolBar", "AFXTOOLBAR/CMFCToolBar", "AFXTOOLBAR/CMFCToolBar::AddBasicCommand", "AFXTOOLBAR/CMFCToolBar::AddCommandUsage", "AFXTOOLBAR/CMFCToolBar::AddToolBarForImageCollection", "AFXTOOLBAR/CMFCToolBar::AdjustLayout", "AFXTOOLBAR/CMFCToolBar::AdjustSize", "AFXTOOLBAR/CMFCToolBar::AllowChangeTextLabels", "AFXTOOLBAR/CMFCToolBar::AreTextLabels", "AFXTOOLBAR/CMFCToolBar::AutoGrayInactiveImages", "AFXTOOLBAR/CMFCToolBar::ButtonToIndex", "AFXTOOLBAR/CMFCToolBar::CalcFixedLayout", "AFXTOOLBAR/CMFCToolBar::CalcSize", "AFXTOOLBAR/CMFCToolBar::CanHandleSiblings", "AFXTOOLBAR/CMFCToolBar::CleanUpImages", "AFXTOOLBAR/CMFCToolBar::CleanUpLockedImages", "AFXTOOLBAR/CMFCToolBar::CanBeClosed", "AFXTOOLBAR/CMFCToolBar::CanBeRestored", "AFXTOOLBAR/CMFCToolBar::CanFocus", "AFXTOOLBAR/CMFCToolBar::CommandToIndex", "AFXTOOLBAR/CMFCToolBar::Create", "AFXTOOLBAR/CMFCToolBar::CreateEx", "AFXTOOLBAR/CMFCToolBar::Deactivate", "AFXTOOLBAR/CMFCToolBar::EnableCustomizeButton", "AFXTOOLBAR/CMFCToolBar::EnableDocking", "AFXTOOLBAR/CMFCToolBar::EnableLargeIcons", "AFXTOOLBAR/CMFCToolBar::EnableQuickCustomization", "AFXTOOLBAR/CMFCToolBar::EnableReflections", "AFXTOOLBAR/CMFCToolBar::EnableTextLabels", "AFXTOOLBAR/CMFCToolBar::FromHandlePermanent", "AFXTOOLBAR/CMFCToolBar::GetAllButtons", "AFXTOOLBAR/CMFCToolBar::GetAllToolbars", "AFXTOOLBAR/CMFCToolBar::GetBasicCommands", "AFXTOOLBAR/CMFCToolBar::GetButton", "AFXTOOLBAR/CMFCToolBar::GetButtonInfo", "AFXTOOLBAR/CMFCToolBar::GetButtonSize", "AFXTOOLBAR/CMFCToolBar::GetButtonStyle", "AFXTOOLBAR/CMFCToolBar::GetButtonText", "AFXTOOLBAR/CMFCToolBar::GetColdImages", "AFXTOOLBAR/CMFCToolBar::GetColumnWidth", "AFXTOOLBAR/CMFCToolBar::GetCommandButtons", "AFXTOOLBAR/CMFCToolBar::GetCount", "AFXTOOLBAR/CMFCToolBar::GetCustomizeButton", "AFXTOOLBAR/CMFCToolBar::GetDefaultImage", "AFXTOOLBAR/CMFCToolBar::GetDisabledImages", "AFXTOOLBAR/CMFCToolBar::GetDisabledMenuImages", "AFXTOOLBAR/CMFCToolBar::GetDroppedDownMenu", "AFXTOOLBAR/CMFCToolBar::GetGrayDisabledButtons", "AFXTOOLBAR/CMFCToolBar::GetHighlightedButton", "AFXTOOLBAR/CMFCToolBar::GetHotBorder", "AFXTOOLBAR/CMFCToolBar::GetHotTextColor", "AFXTOOLBAR/CMFCToolBar::GetHwndLastFocus", "AFXTOOLBAR/CMFCToolBar::GetOVERWRITESetText", "AFXTOOLBAR/CMFCToolBar::GetImageSize", "AFXTOOLBAR/CMFCToolBar::GetImages", "AFXTOOLBAR/CMFCToolBar::GetImagesOffset", "AFXTOOLBAR/CMFCToolBar::GetInvalidateItemRect", "AFXTOOLBAR/CMFCToolBar::GetItemID", "AFXTOOLBAR/CMFCToolBar::GetItemRect", "AFXTOOLBAR/CMFCToolBar::GetLargeColdImages", "AFXTOOLBAR/CMFCToolBar::GetLargeDisabledImages", "AFXTOOLBAR/CMFCToolBar::GetLargeImages", "AFXTOOLBAR/CMFCToolBar::GetLockedColdImages", "AFXTOOLBAR/CMFCToolBar::GetLockedDisabledImages", "AFXTOOLBAR/CMFCToolBar::GetLockedImages", "AFXTOOLBAR/CMFCToolBar::GetLockedImageSize", "AFXTOOLBAR/CMFCToolBar::GetLockedMenuImages", "AFXTOOLBAR/CMFCToolBar::GetMenuButtonSize", "AFXTOOLBAR/CMFCToolBar::GetMenuImageSize", "AFXTOOLBAR/CMFCToolBar::GetMenuImages", "AFXTOOLBAR/CMFCToolBar::GetOrigButtons", "AFXTOOLBAR/CMFCToolBar::GetOrigResetButtons", "AFXTOOLBAR/CMFCToolBar::GetResourceID", "AFXTOOLBAR/CMFCToolBar::GetRouteCommandsViaFrame", "AFXTOOLBAR/CMFCToolBar::GetRowHeight", "AFXTOOLBAR/CMFCToolBar::GetShowTooltips", "AFXTOOLBAR/CMFCToolBar::GetSiblingToolBar", "AFXTOOLBAR/CMFCToolBar::GetUserImages", "AFXTOOLBAR/CMFCToolBar::HitTest", "AFXTOOLBAR/CMFCToolBar::InsertButton", "AFXTOOLBAR/CMFCToolBar::InsertSeparator", "AFXTOOLBAR/CMFCToolBar::InvalidateButton", "AFXTOOLBAR/CMFCToolBar::IsAddRemoveQuickCustomize", "AFXTOOLBAR/CMFCToolBar::IsAltCustomizeMode", "AFXTOOLBAR/CMFCToolBar::IsAutoGrayInactiveImages", "AFXTOOLBAR/CMFCToolBar::IsBasicCommand", "AFXTOOLBAR/CMFCToolBar::IsButtonExtraSizeAvailable", "AFXTOOLBAR/CMFCToolBar::IsButtonHighlighted", "AFXTOOLBAR/CMFCToolBar::IsCommandPermitted", "AFXTOOLBAR/CMFCToolBar::IsCommandRarelyUsed", "AFXTOOLBAR/CMFCToolBar::IsCustomizeMode", "AFXTOOLBAR/CMFCToolBar::IsDragButton", "AFXTOOLBAR/CMFCToolBar::IsExistCustomizeButton", "AFXTOOLBAR/CMFCToolBar::IsFloating", "AFXTOOLBAR/CMFCToolBar::IsLargeIcons", "AFXTOOLBAR/CMFCToolBar::IsLastCommandFromButton", "AFXTOOLBAR/CMFCToolBar::IsLocked", "AFXTOOLBAR/CMFCToolBar::IsOneRowWithSibling", "AFXTOOLBAR/CMFCToolBar::IsUserDefined", "AFXTOOLBAR/CMFCToolBar::LoadBitmap", "AFXTOOLBAR/CMFCToolBar::LoadBitmapEx", "AFXTOOLBAR/CMFCToolBar::LoadParameters", "AFXTOOLBAR/CMFCToolBar::LoadState", "AFXTOOLBAR/CMFCToolBar::LoadToolBar", "AFXTOOLBAR/CMFCToolBar::LoadToolBarEx", "AFXTOOLBAR/CMFCToolBar::OnChangeHot", "AFXTOOLBAR/CMFCToolBar::OnFillBackground", "AFXTOOLBAR/CMFCToolBar::OnReset", "AFXTOOLBAR/CMFCToolBar::OnSetAccData", "AFXTOOLBAR/CMFCToolBar::OnSetDefaultButtonText", "AFXTOOLBAR/CMFCToolBar::RemoveAllButtons", "AFXTOOLBAR/CMFCToolBar::RemoveButton", "AFXTOOLBAR/CMFCToolBar::RemoveStateFromRegistry", "AFXTOOLBAR/CMFCToolBar::ReplaceButton", "AFXTOOLBAR/CMFCToolBar::ResetAll", "AFXTOOLBAR/CMFCToolBar::ResetAllImages", "AFXTOOLBAR/CMFCToolBar::RestoreOriginalState", "AFXTOOLBAR/CMFCToolBar::SaveState", "AFXTOOLBAR/CMFCToolBar::SetBasicCommands", "AFXTOOLBAR/CMFCToolBar::SetButtonInfo", "AFXTOOLBAR/CMFCToolBar::SetButtonStyle", "AFXTOOLBAR/CMFCToolBar::SetButtonText", "AFXTOOLBAR/CMFCToolBar::SetButtons", "AFXTOOLBAR/CMFCToolBar::SetCommandUsageOptions", "AFXTOOLBAR/CMFCToolBar::SetCustomizeMode", "AFXTOOLBAR/CMFCToolBar::SetGrayDisabledButtons", "AFXTOOLBAR/CMFCToolBar::SetHeight", "AFXTOOLBAR/CMFCToolBar::SetHotBorder", "AFXTOOLBAR/CMFCToolBar::SetHotTextColor", "AFXTOOLBAR/CMFCToolBar::SetLargeIcons", "AFXTOOLBAR/CMFCToolBar::SetLockedSizes", "AFXTOOLBAR/CMFCToolBar::SetMenuSizes", "AFXTOOLBAR/CMFCToolBar::SetNonPermittedCommands", "AFXTOOLBAR/CMFCToolBar::SetOneRowWithSibling", "AFXTOOLBAR/CMFCToolBar::SetPermament", "AFXTOOLBAR/CMFCToolBar::SetRouteCommandsViaFrame", "AFXTOOLBAR/CMFCToolBar::SetShowTooltips", "AFXTOOLBAR/CMFCToolBar::SetSiblingToolBar", "AFXTOOLBAR/CMFCToolBar::SetSizes", "AFXTOOLBAR/CMFCToolBar::SetToolBarBtnText", "AFXTOOLBAR/CMFCToolBar::SetTwoRowsWithSibling", "AFXTOOLBAR/CMFCToolBar::SetUserImages", "AFXTOOLBAR/CMFCToolBar::StretchPane", "AFXTOOLBAR/CMFCToolBar::TranslateChar", "AFXTOOLBAR/CMFCToolBar::UpdateButton", "AFXTOOLBAR/CMFCToolBar::WrapToolBar", "AFXTOOLBAR/CMFCToolBar::AllowShowOnList", "AFXTOOLBAR/CMFCToolBar::CalcMaxButtonHeight", "AFXTOOLBAR/CMFCToolBar::DoPaint", "AFXTOOLBAR/CMFCToolBar::DrawButton", "AFXTOOLBAR/CMFCToolBar::DrawSeparator", "AFXTOOLBAR/CMFCToolBar::OnUserToolTip", "AFXTOOLBAR/CMFCToolBar::m_bDontScaleImages", "AFXTOOLBAR/CMFCToolBar::m_dblLargeImageRatio"] helpviewer_keywords: ["CMFCToolBar [MFC], AddBasicCommand", "CMFCToolBar [MFC], AddCommandUsage", "CMFCToolBar [MFC], AddToolBarForImageCollection", "CMFCToolBar [MFC], AdjustLayout", "CMFCToolBar [MFC], AdjustSize", "CMFCToolBar [MFC], AllowChangeTextLabels", "CMFCToolBar [MFC], AreTextLabels", "CMFCToolBar [MFC], AutoGrayInactiveImages", "CMFCToolBar [MFC], ButtonToIndex", "CMFCToolBar [MFC], CalcFixedLayout", "CMFCToolBar [MFC], CalcSize", "CMFCToolBar [MFC], CanHandleSiblings", "CMFCToolBar [MFC], CleanUpImages", "CMFCToolBar [MFC], CleanUpLockedImages", "CMFCToolBar [MFC], CanBeClosed", "CMFCToolBar [MFC], CanBeRestored", "CMFCToolBar [MFC], CanFocus", "CMFCToolBar [MFC], CanHandleSiblings", "CMFCToolBar [MFC], CommandToIndex", "CMFCToolBar [MFC], Create", "CMFCToolBar [MFC], CreateEx", "CMFCToolBar [MFC], Deactivate", "CMFCToolBar [MFC], EnableCustomizeButton", "CMFCToolBar [MFC], EnableDocking", "CMFCToolBar [MFC], EnableLargeIcons", "CMFCToolBar [MFC], EnableQuickCustomization", "CMFCToolBar [MFC], EnableReflections", "CMFCToolBar [MFC], EnableTextLabels", "CMFCToolBar [MFC], FromHandlePermanent", "CMFCToolBar [MFC], GetAllButtons", "CMFCToolBar [MFC], GetAllToolbars", "CMFCToolBar [MFC], GetBasicCommands", "CMFCToolBar [MFC], GetButton", "CMFCToolBar [MFC], GetButtonInfo", "CMFCToolBar [MFC], GetButtonSize", "CMFCToolBar [MFC], GetButtonStyle", "CMFCToolBar [MFC], GetButtonText", "CMFCToolBar [MFC], GetColdImages", "CMFCToolBar [MFC], GetColumnWidth", "CMFCToolBar [MFC], GetCommandButtons", "CMFCToolBar [MFC], GetCount", "CMFCToolBar [MFC], GetCustomizeButton", "CMFCToolBar [MFC], GetDefaultImage", "CMFCToolBar [MFC], GetDisabledImages", "CMFCToolBar [MFC], GetDisabledMenuImages", "CMFCToolBar [MFC], GetDroppedDownMenu", "CMFCToolBar [MFC], GetGrayDisabledButtons", "CMFCToolBar [MFC], GetHighlightedButton", "CMFCToolBar [MFC], GetHotBorder", "CMFCToolBar [MFC], GetHotTextColor", "CMFCToolBar [MFC], GetHwndLastFocus", "CMFCToolBar [MFC], GetIgnoreSetText", "CMFCToolBar [MFC], GetImageSize", "CMFCToolBar [MFC], GetImages", "CMFCToolBar [MFC], GetImagesOffset", "CMFCToolBar [MFC], GetInvalidateItemRect", "CMFCToolBar [MFC], GetItemID", "CMFCToolBar [MFC], GetItemRect", "CMFCToolBar [MFC], GetLargeColdImages", "CMFCToolBar [MFC], GetLargeDisabledImages", "CMFCToolBar [MFC], GetLargeImages", "CMFCToolBar [MFC], GetLockedColdImages", "CMFCToolBar [MFC], GetLockedDisabledImages", "CMFCToolBar [MFC], GetLockedImages", "CMFCToolBar [MFC], GetLockedImageSize", "CMFCToolBar [MFC], GetLockedMenuImages", "CMFCToolBar [MFC], GetMenuButtonSize", "CMFCToolBar [MFC], GetMenuImageSize", "CMFCToolBar [MFC], GetMenuImages", "CMFCToolBar [MFC], GetOrigButtons", "CMFCToolBar [MFC], GetOrigResetButtons", "CMFCToolBar [MFC], GetResourceID", "CMFCToolBar [MFC], GetRouteCommandsViaFrame", "CMFCToolBar [MFC], GetRowHeight", "CMFCToolBar [MFC], GetShowTooltips", "CMFCToolBar [MFC], GetSiblingToolBar", "CMFCToolBar [MFC], GetUserImages", "CMFCToolBar [MFC], HitTest", "CMFCToolBar [MFC], InsertButton", "CMFCToolBar [MFC], InsertSeparator", "CMFCToolBar [MFC], InvalidateButton", "CMFCToolBar [MFC], IsAddRemoveQuickCustomize", "CMFCToolBar [MFC], IsAltCustomizeMode", "CMFCToolBar [MFC], IsAutoGrayInactiveImages", "CMFCToolBar [MFC], IsBasicCommand", "CMFCToolBar [MFC], IsButtonExtraSizeAvailable", "CMFCToolBar [MFC], IsButtonHighlighted", "CMFCToolBar [MFC], IsCommandPermitted", "CMFCToolBar [MFC], IsCommandRarelyUsed", "CMFCToolBar [MFC], IsCustomizeMode", "CMFCToolBar [MFC], IsDragButton", "CMFCToolBar [MFC], IsExistCustomizeButton", "CMFCToolBar [MFC], IsFloating", "CMFCToolBar [MFC], IsLargeIcons", "CMFCToolBar [MFC], IsLastCommandFromButton", "CMFCToolBar [MFC], IsLocked", "CMFCToolBar [MFC], IsOneRowWithSibling", "CMFCToolBar [MFC], IsUserDefined", "CMFCToolBar [MFC], LoadBitmap", "CMFCToolBar [MFC], LoadBitmapEx", "CMFCToolBar [MFC], LoadParameters", "CMFCToolBar [MFC], LoadState", "CMFCToolBar [MFC], LoadToolBar", "CMFCToolBar [MFC], LoadToolBarEx", "CMFCToolBar [MFC], OnChangeHot", "CMFCToolBar [MFC], OnFillBackground", "CMFCToolBar [MFC], OnReset", "CMFCToolBar [MFC], OnSetAccData", "CMFCToolBar [MFC], OnSetDefaultButtonText", "CMFCToolBar [MFC], RemoveAllButtons", "CMFCToolBar [MFC], RemoveButton", "CMFCToolBar [MFC], RemoveStateFromRegistry", "CMFCToolBar [MFC], ReplaceButton", "CMFCToolBar [MFC], ResetAll", "CMFCToolBar [MFC], ResetAllImages", "CMFCToolBar [MFC], RestoreOriginalState", "CMFCToolBar [MFC], SaveState", "CMFCToolBar [MFC], SetBasicCommands", "CMFCToolBar [MFC], SetButtonInfo", "CMFCToolBar [MFC], SetButtonStyle", "CMFCToolBar [MFC], SetButtonText", "CMFCToolBar [MFC], SetButtons", "CMFCToolBar [MFC], SetCommandUsageOptions", "CMFCToolBar [MFC], SetCustomizeMode", "CMFCToolBar [MFC], SetGrayDisabledButtons", "CMFCToolBar [MFC], SetHeight", "CMFCToolBar [MFC], SetHotBorder", "CMFCToolBar [MFC], SetHotTextColor", "CMFCToolBar [MFC], SetLargeIcons", "CMFCToolBar [MFC], SetLockedSizes", "CMFCToolBar [MFC], SetMenuSizes", "CMFCToolBar [MFC], SetNonPermittedCommands", "CMFCToolBar [MFC], SetOneRowWithSibling", "CMFCToolBar [MFC], SetPermament", "CMFCToolBar [MFC], SetRouteCommandsViaFrame", "CMFCToolBar [MFC], SetShowTooltips", "CMFCToolBar [MFC], SetSiblingToolBar", "CMFCToolBar [MFC], SetSizes", "CMFCToolBar [MFC], SetToolBarBtnText", "CMFCToolBar [MFC], SetTwoRowsWithSibling", "CMFCToolBar [MFC], SetUserImages", "CMFCToolBar [MFC], StretchPane", "CMFCToolBar [MFC], TranslateChar", "CMFCToolBar [MFC], UpdateButton", "CMFCToolBar [MFC], WrapToolBar", "CMFCToolBar [MFC], AllowShowOnList", "CMFCToolBar [MFC], CalcMaxButtonHeight", "CMFCToolBar [MFC], DoPaint", "CMFCToolBar [MFC], DrawButton", "CMFCToolBar [MFC], DrawSeparator", "CMFCToolBar [MFC], OnUserToolTip", "CMFCToolBar [MFC], m_bDontScaleImages", "CMFCToolBar [MFC], m_dblLargeImageRatio"] --- @@ -47,7 +47,6 @@ class CMFCToolBar : public CMFCBaseToolBar |[`CMFCToolBar::CanBeClosed`](#canbeclosed)|Specifies whether a user can close the toolbar. (Overrides [`CBasePane::CanBeClosed`](../../mfc/reference/cbasepane-class.md#canbeclosed).)| |[`CMFCToolBar::CanBeRestored`](#canberestored)|Determines whether the system can restore a toolbar to its original state after customization.| |[`CMFCToolBar::CanFocus`](#canfocus)|Specifies whether the pane can receive focus. (Overrides [`CBasePane::CanFocus`](../../mfc/reference/cbasepane-class.md#canfocus).)| -|[`CMFCToolBar::CanHandleSiblings`](#canhandlesiblings)|Determines whether the toolbar and its sibling are positioned on the same pane.| |[`CMFCToolBar::CommandToIndex`](#commandtoindex)|Returns the index of the button in the toolbar with a specified command ID.| |[`CMFCToolBar::Create`](#create)|Creates a `CMFCToolBar` object.| |[`CMFCToolBar::CreateEx`](#createex)|Creates a `CMFCToolBar` object that uses additional style options, such as large icons.| @@ -2303,7 +2302,7 @@ virtual BOOL LoadBitmapEx( ### Parameters [in] *`params`*\ -[in] *`bLocked`*\ +[in] *`bLocked`* ### Return Value @@ -2317,7 +2316,7 @@ static BOOL __stdcall LoadLargeIconsState(LPCTSTR lpszProfileName = NULL); ### Parameters -[in] *`lpszProfileName`*\ +[in] *`lpszProfileName`* ### Return Value @@ -2577,7 +2576,7 @@ virtual BOOL OnSetAccData(long lVal); ### Parameters -[in] *`lVal`*\ +[in] *`lVal`* ### Return Value @@ -2837,7 +2836,7 @@ static BOOL __stdcall SaveParameters(LPCTSTR lpszProfileName = NULL); ### Parameters -[in] *`lpszProfileName`*\ +[in] *`lpszProfileName`* ### Return Value @@ -3099,7 +3098,7 @@ static void __stdcall SetHelpMode(BOOL bOn = TRUE); ### Parameters -[in] *`bOn`*\ +[in] *`bOn`* ### Remarks @@ -3111,7 +3110,7 @@ BOOL SetHot(CMFCToolBarButton* pMenuButton); ### Parameters -[in] *`pMenuButton`*\ +[in] *`pMenuButton`* ### Return Value @@ -3161,7 +3160,7 @@ void SetIgnoreSetText(BOOL bValue); ### Parameters -[in] *`bValue`*\ +[in] *`bValue`* ### Remarks @@ -3222,7 +3221,7 @@ void SetMaskMode(BOOL bMasked); ### Parameters -[in] *`bMasked`*\ +[in] *`bMasked`* ### Remarks @@ -3295,7 +3294,7 @@ void SetOrigButtons(const CObList& lstOrigButtons); ### Parameters -[in] *`lstOrigButtons`*\ +[in] *`lstOrigButtons`* ### Remarks @@ -3472,7 +3471,7 @@ This method generates an assertion failure in Debug builds if the specified `CMF The OutlookDemo, ToolTipDemo, and VisualStudioDemo samples use this method to set the global collection of user-defined images. They load the file that is named UserImages.bmp, which is located in the working directory of the application. -Call the [`CMFCToolBar::GetUserImages](#getuserimages) method to retrieve the collection of user-defined images in the application. +Call the [`CMFCToolBar::GetUserImages`](#getuserimages) method to retrieve the collection of user-defined images in the application. ## `CMFCToolBar::StretchPane` diff --git a/docs/mfc/reference/cmfcvisualmanageroffice2003-class.md b/docs/mfc/reference/cmfcvisualmanageroffice2003-class.md index a2ca2ffc89e..b7e77059dcf 100644 --- a/docs/mfc/reference/cmfcvisualmanageroffice2003-class.md +++ b/docs/mfc/reference/cmfcvisualmanageroffice2003-class.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: CMFCVisualManagerOffice2003 Class" title: "CMFCVisualManagerOffice2003 Class" -ms.date: "11/04/2016" +description: "Learn more about: CMFCVisualManagerOffice2003 Class" +ms.date: 11/04/2016 f1_keywords: ["CMFCVisualManagerOffice2003", "AFXVISUALMANAGEROFFICE2003/CMFCVisualManagerOffice2003", "AFXVISUALMANAGEROFFICE2003/CMFCVisualManagerOffice2003::DrawComboBorderWinXP", "AFXVISUALMANAGEROFFICE2003/CMFCVisualManagerOffice2003::DrawComboDropButtonWinXP", "AFXVISUALMANAGEROFFICE2003/CMFCVisualManagerOffice2003::DrawCustomizeButton", "AFXVISUALMANAGEROFFICE2003/CMFCVisualManagerOffice2003::DrawPushButtonWinXP", "AFXVISUALMANAGEROFFICE2003/CMFCVisualManagerOffice2003::GetBaseThemeColor", "AFXVISUALMANAGEROFFICE2003/CMFCVisualManagerOffice2003::GetHighlightMenuItemColor", "AFXVISUALMANAGEROFFICE2003/CMFCVisualManagerOffice2003::GetPropertyGridGroupColor", "AFXVISUALMANAGEROFFICE2003/CMFCVisualManagerOffice2003::GetPropertyGridGroupTextColor", "AFXVISUALMANAGEROFFICE2003/CMFCVisualManagerOffice2003::GetShowAllMenuItemsHeight", "AFXVISUALMANAGEROFFICE2003/CMFCVisualManagerOffice2003::GetSmartDockingBaseGuideColors", "AFXVISUALMANAGEROFFICE2003/CMFCVisualManagerOffice2003::GetSmartDockingHighlightToneColor", "AFXVISUALMANAGEROFFICE2003/CMFCVisualManagerOffice2003::GetTabFrameColors", "AFXVISUALMANAGEROFFICE2003/CMFCVisualManagerOffice2003::GetToolBarCustomizeButtonMargin", "AFXVISUALMANAGEROFFICE2003/CMFCVisualManagerOffice2003::GetToolbarDisabledColor", "AFXVISUALMANAGEROFFICE2003/CMFCVisualManagerOffice2003::GetToolTipInfo", "AFXVISUALMANAGEROFFICE2003/CMFCVisualManagerOffice2003::IsDefaultWinXPColorsEnabled", "AFXVISUALMANAGEROFFICE2003/CMFCVisualManagerOffice2003::IsDockingTabHasBorder", "AFXVISUALMANAGEROFFICE2003/CMFCVisualManagerOffice2003::IsHighlightOneNoteTabs", "AFXVISUALMANAGEROFFICE2003/CMFCVisualManagerOffice2003::IsOffsetPressedButton", "AFXVISUALMANAGEROFFICE2003/CMFCVisualManagerOffice2003::IsStatusBarOfficeXPLook", "AFXVISUALMANAGEROFFICE2003/CMFCVisualManagerOffice2003::IsToolbarRoundShape", "AFXVISUALMANAGEROFFICE2003/CMFCVisualManagerOffice2003::IsUseGlobalTheme", "AFXVISUALMANAGEROFFICE2003/CMFCVisualManagerOffice2003::IsWindowsThemingSupported", "AFXVISUALMANAGEROFFICE2003/CMFCVisualManagerOffice2003::OnDrawAutoHideButtonBorder", "AFXVISUALMANAGEROFFICE2003/CMFCVisualManagerOffice2003::OnDrawBarGripper", "AFXVISUALMANAGEROFFICE2003/CMFCVisualManagerOffice2003::OnDrawBrowseButton", "AFXVISUALMANAGEROFFICE2003/CMFCVisualManagerOffice2003::OnDrawButtonBorder", "AFXVISUALMANAGEROFFICE2003/CMFCVisualManagerOffice2003::OnDrawCaptionBarBorder", "AFXVISUALMANAGEROFFICE2003/CMFCVisualManagerOffice2003::OnDrawCheckBoxEx", "AFXVISUALMANAGEROFFICE2003/CMFCVisualManagerOffice2003::OnDrawComboBorder", "AFXVISUALMANAGEROFFICE2003/CMFCVisualManagerOffice2003::OnDrawComboDropButton", "AFXVISUALMANAGEROFFICE2003/CMFCVisualManagerOffice2003::OnDrawControlBorder", "AFXVISUALMANAGEROFFICE2003/CMFCVisualManagerOffice2003::OnDrawExpandingBox", "AFXVISUALMANAGEROFFICE2003/CMFCVisualManagerOffice2003::OnDrawHeaderCtrlBorder", "AFXVISUALMANAGEROFFICE2003/CMFCVisualManagerOffice2003::OnDrawMenuBorder", "AFXVISUALMANAGEROFFICE2003/CMFCVisualManagerOffice2003::OnDrawOutlookBarSplitter", "AFXVISUALMANAGEROFFICE2003/CMFCVisualManagerOffice2003::OnDrawOutlookPageButtonBorder", "AFXVISUALMANAGEROFFICE2003/CMFCVisualManagerOffice2003::OnDrawPaneBorder", "AFXVISUALMANAGEROFFICE2003/CMFCVisualManagerOffice2003::OnDrawPaneCaption", "AFXVISUALMANAGEROFFICE2003/CMFCVisualManagerOffice2003::OnDrawPopupWindowBorder", "AFXVISUALMANAGEROFFICE2003/CMFCVisualManagerOffice2003::OnDrawPopupWindowButtonBorder", "AFXVISUALMANAGEROFFICE2003/CMFCVisualManagerOffice2003::OnDrawPopupWindowCaption", "AFXVISUALMANAGEROFFICE2003/CMFCVisualManagerOffice2003::OnDrawRibbonButtonsGroup", "AFXVISUALMANAGEROFFICE2003/CMFCVisualManagerOffice2003::OnDrawRibbonCategoryCaption", "AFXVISUALMANAGEROFFICE2003/CMFCVisualManagerOffice2003::OnDrawRibbonCategoryTab", "AFXVISUALMANAGEROFFICE2003/CMFCVisualManagerOffice2003::OnDrawRibbonProgressBar", "AFXVISUALMANAGEROFFICE2003/CMFCVisualManagerOffice2003::OnDrawRibbonQuickAccessToolBarSeparator", "AFXVISUALMANAGEROFFICE2003/CMFCVisualManagerOffice2003::OnDrawRibbonSliderChannel", "AFXVISUALMANAGEROFFICE2003/CMFCVisualManagerOffice2003::OnDrawRibbonSliderThumb", "AFXVISUALMANAGEROFFICE2003/CMFCVisualManagerOffice2003::OnDrawRibbonSliderZoomButton", "AFXVISUALMANAGEROFFICE2003/CMFCVisualManagerOffice2003::OnDrawRibbonStatusBarPane", "AFXVISUALMANAGEROFFICE2003/CMFCVisualManagerOffice2003::OnDrawScrollButtons", "AFXVISUALMANAGEROFFICE2003/CMFCVisualManagerOffice2003::OnDrawSeparator", "AFXVISUALMANAGEROFFICE2003/CMFCVisualManagerOffice2003::OnDrawShowAllMenuItems", "AFXVISUALMANAGEROFFICE2003/CMFCVisualManagerOffice2003::OnDrawStatusBarPaneBorder", "AFXVISUALMANAGEROFFICE2003/CMFCVisualManagerOffice2003::OnDrawStatusBarProgress", "AFXVISUALMANAGEROFFICE2003/CMFCVisualManagerOffice2003::OnDrawStatusBarSizeBox", "AFXVISUALMANAGEROFFICE2003/CMFCVisualManagerOffice2003::OnDrawTab", "AFXVISUALMANAGEROFFICE2003/CMFCVisualManagerOffice2003::OnDrawTabsButtonBorder", "AFXVISUALMANAGEROFFICE2003/CMFCVisualManagerOffice2003::OnDrawTask", "AFXVISUALMANAGEROFFICE2003/CMFCVisualManagerOffice2003::OnDrawTasksGroupAreaBorder", "AFXVISUALMANAGEROFFICE2003/CMFCVisualManagerOffice2003::OnDrawTasksGroupCaption", "AFXVISUALMANAGEROFFICE2003/CMFCVisualManagerOffice2003::OnDrawTearOffCaption", "AFXVISUALMANAGEROFFICE2003/CMFCVisualManagerOffice2003::OnErasePopupWindowButton", "AFXVISUALMANAGEROFFICE2003/CMFCVisualManagerOffice2003::OnEraseTabsArea", "AFXVISUALMANAGEROFFICE2003/CMFCVisualManagerOffice2003::OnEraseTabsButton", "AFXVISUALMANAGEROFFICE2003/CMFCVisualManagerOffice2003::OnEraseTabsFrame", "AFXVISUALMANAGEROFFICE2003/CMFCVisualManagerOffice2003::OnFillAutoHideButtonBackground", "AFXVISUALMANAGEROFFICE2003/CMFCVisualManagerOffice2003::OnFillBarBackground", "AFXVISUALMANAGEROFFICE2003/CMFCVisualManagerOffice2003::OnFillButtonInterior", "AFXVISUALMANAGEROFFICE2003/CMFCVisualManagerOffice2003::OnFillCommandsListBackground", "AFXVISUALMANAGEROFFICE2003/CMFCVisualManagerOffice2003::OnFillHeaderCtrlBackground", "AFXVISUALMANAGEROFFICE2003/CMFCVisualManagerOffice2003::OnFillHighlightedArea", "AFXVISUALMANAGEROFFICE2003/CMFCVisualManagerOffice2003::OnFillOutlookBarCaption", "AFXVISUALMANAGEROFFICE2003/CMFCVisualManagerOffice2003::OnFillOutlookPageButton", "AFXVISUALMANAGEROFFICE2003/CMFCVisualManagerOffice2003::OnFillPopupWindowBackground", "AFXVISUALMANAGEROFFICE2003/CMFCVisualManagerOffice2003::OnFillTab", "AFXVISUALMANAGEROFFICE2003/CMFCVisualManagerOffice2003::OnFillTasksGroupInterior", "AFXVISUALMANAGEROFFICE2003/CMFCVisualManagerOffice2003::OnFillTasksPaneBackground", "AFXVISUALMANAGEROFFICE2003/CMFCVisualManagerOffice2003::OnHighlightQuickCustomizeMenuButton", "AFXVISUALMANAGEROFFICE2003/CMFCVisualManagerOffice2003::OnHighlightRarelyUsedMenuItems", "AFXVISUALMANAGEROFFICE2003/CMFCVisualManagerOffice2003::OnUpdateSystemColors", "AFXVISUALMANAGEROFFICE2003/CMFCVisualManagerOffice2003::SetDefaultWinXPColors", "AFXVISUALMANAGEROFFICE2003/CMFCVisualManagerOffice2003::SetStatusBarOfficeXPLook", "AFXVISUALMANAGEROFFICE2003/CMFCVisualManagerOffice2003::SetUseGlobalTheme"] helpviewer_keywords: ["CMFCVisualManagerOffice2003 Class [MFC]"] -ms.assetid: 115482cd-e349-450a-8dc4-c6023d092aab --- # CMFCVisualManagerOffice2003 Class @@ -1265,7 +1264,7 @@ Override this method in a derived visual manager to customize the appearance of ## CMFCVisualManagerOffice2003::OnDrawRibbonProgressBar -The framework calls this method when it draws a [CMFCRibbonProgressBar Class](../../mfc/reference/cmfcribbonprogressbar-class.md)object. +The framework calls this method when it draws a [CMFCRibbonProgressBar Class](../../mfc/reference/cmfcribbonprogressbar-class.md) object. ``` virtual void OnDrawRibbonProgressBar( diff --git a/docs/mfc/reference/cmonthcalctrl-class.md b/docs/mfc/reference/cmonthcalctrl-class.md index 75cfdbbb96e..e9ce4d517d5 100644 --- a/docs/mfc/reference/cmonthcalctrl-class.md +++ b/docs/mfc/reference/cmonthcalctrl-class.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: CMonthCalCtrl Class" title: "CMonthCalCtrl Class" -ms.date: "11/04/2016" +description: "Learn more about: CMonthCalCtrl Class" +ms.date: 11/04/2016 f1_keywords: ["CMonthCalCtrl", "AFXDTCTL/CMonthCalCtrl", "AFXDTCTL/CMonthCalCtrl::CMonthCalCtrl", "AFXDTCTL/CMonthCalCtrl::Create", "AFXDTCTL/CMonthCalCtrl::GetCalendarBorder", "AFXDTCTL/CMonthCalCtrl::GetCalendarCount", "AFXDTCTL/CMonthCalCtrl::GetCalendarGridInfo", "AFXDTCTL/CMonthCalCtrl::GetCalID", "AFXDTCTL/CMonthCalCtrl::GetColor", "AFXDTCTL/CMonthCalCtrl::GetCurrentView", "AFXDTCTL/CMonthCalCtrl::GetCurSel", "AFXDTCTL/CMonthCalCtrl::GetFirstDayOfWeek", "AFXDTCTL/CMonthCalCtrl::GetMaxSelCount", "AFXDTCTL/CMonthCalCtrl::GetMaxTodayWidth", "AFXDTCTL/CMonthCalCtrl::GetMinReqRect", "AFXDTCTL/CMonthCalCtrl::GetMonthDelta", "AFXDTCTL/CMonthCalCtrl::GetMonthRange", "AFXDTCTL/CMonthCalCtrl::GetRange", "AFXDTCTL/CMonthCalCtrl::GetSelRange", "AFXDTCTL/CMonthCalCtrl::GetToday", "AFXDTCTL/CMonthCalCtrl::HitTest", "AFXDTCTL/CMonthCalCtrl::IsCenturyView", "AFXDTCTL/CMonthCalCtrl::IsDecadeView", "AFXDTCTL/CMonthCalCtrl::IsMonthView", "AFXDTCTL/CMonthCalCtrl::IsYearView", "AFXDTCTL/CMonthCalCtrl::SetCalendarBorder", "AFXDTCTL/CMonthCalCtrl::SetCalendarBorderDefault", "AFXDTCTL/CMonthCalCtrl::SetCalID", "AFXDTCTL/CMonthCalCtrl::SetCenturyView", "AFXDTCTL/CMonthCalCtrl::SetColor", "AFXDTCTL/CMonthCalCtrl::SetCurrentView", "AFXDTCTL/CMonthCalCtrl::SetCurSel", "AFXDTCTL/CMonthCalCtrl::SetDayState", "AFXDTCTL/CMonthCalCtrl::SetDecadeView", "AFXDTCTL/CMonthCalCtrl::SetFirstDayOfWeek", "AFXDTCTL/CMonthCalCtrl::SetMaxSelCount", "AFXDTCTL/CMonthCalCtrl::SetMonthDelta", "AFXDTCTL/CMonthCalCtrl::SetMonthView", "AFXDTCTL/CMonthCalCtrl::SetRange", "AFXDTCTL/CMonthCalCtrl::SetSelRange", "AFXDTCTL/CMonthCalCtrl::SetToday", "AFXDTCTL/CMonthCalCtrl::SetYearView", "AFXDTCTL/CMonthCalCtrl::SizeMinReq", "AFXDTCTL/CMonthCalCtrl::SizeRectToMin"] helpviewer_keywords: ["CMonthCalCtrl [MFC], CMonthCalCtrl", "CMonthCalCtrl [MFC], Create", "CMonthCalCtrl [MFC], GetCalendarBorder", "CMonthCalCtrl [MFC], GetCalendarCount", "CMonthCalCtrl [MFC], GetCalendarGridInfo", "CMonthCalCtrl [MFC], GetCalID", "CMonthCalCtrl [MFC], GetColor", "CMonthCalCtrl [MFC], GetCurrentView", "CMonthCalCtrl [MFC], GetCurSel", "CMonthCalCtrl [MFC], GetFirstDayOfWeek", "CMonthCalCtrl [MFC], GetMaxSelCount", "CMonthCalCtrl [MFC], GetMaxTodayWidth", "CMonthCalCtrl [MFC], GetMinReqRect", "CMonthCalCtrl [MFC], GetMonthDelta", "CMonthCalCtrl [MFC], GetMonthRange", "CMonthCalCtrl [MFC], GetRange", "CMonthCalCtrl [MFC], GetSelRange", "CMonthCalCtrl [MFC], GetToday", "CMonthCalCtrl [MFC], HitTest", "CMonthCalCtrl [MFC], IsCenturyView", "CMonthCalCtrl [MFC], IsDecadeView", "CMonthCalCtrl [MFC], IsMonthView", "CMonthCalCtrl [MFC], IsYearView", "CMonthCalCtrl [MFC], SetCalendarBorder", "CMonthCalCtrl [MFC], SetCalendarBorderDefault", "CMonthCalCtrl [MFC], SetCalID", "CMonthCalCtrl [MFC], SetCenturyView", "CMonthCalCtrl [MFC], SetColor", "CMonthCalCtrl [MFC], SetCurrentView", "CMonthCalCtrl [MFC], SetCurSel", "CMonthCalCtrl [MFC], SetDayState", "CMonthCalCtrl [MFC], SetDecadeView", "CMonthCalCtrl [MFC], SetFirstDayOfWeek", "CMonthCalCtrl [MFC], SetMaxSelCount", "CMonthCalCtrl [MFC], SetMonthDelta", "CMonthCalCtrl [MFC], SetMonthView", "CMonthCalCtrl [MFC], SetRange", "CMonthCalCtrl [MFC], SetSelRange", "CMonthCalCtrl [MFC], SetToday", "CMonthCalCtrl [MFC], SetYearView", "CMonthCalCtrl [MFC], SizeMinReq", "CMonthCalCtrl [MFC], SizeRectToMin"] -ms.assetid: a42f6bd6-ab5c-4335-82f8-839982fc64a2 --- # CMonthCalCtrl Class @@ -305,7 +304,8 @@ The next code example reports which view the month calendar control currently di Retrieves the system time as indicated by the currently-selected date. ``` -BOOL GetCurSel(COleDateTime& refDateTime) const; BOOL GetCurSel(CTime& refDateTime) const; +BOOL GetCurSel(COleDateTime& refDateTime) const; +BOOL GetCurSel(CTime& refDateTime) const; BOOL GetCurSel(LPSYSTEMTIME pDateTime) const; ``` @@ -320,7 +320,7 @@ A pointer to a [SYSTEMTIME](/windows/win32/api/minwinbase/ns-minwinbase-systemti ### Return Value -Nonzero if successful; otherwize 0. +Nonzero if successful; otherwise 0. ### Remarks @@ -596,7 +596,8 @@ In MFC's implementation of `GetSelRange`, you can specify `COleDateTime` usage, Retrieves the date information for the date specified as "today" for a month calendar control. ``` -BOOL GetToday(COleDateTime& refDateTime) const; BOOL GetToday(COleDateTime& refDateTime) const; +BOOL GetToday(COleDateTime& refDateTime) const; +BOOL GetToday(COleDateTime& refDateTime) const; BOOL GetToday(LPSYSTEMTIME pDateTime) const; ``` diff --git a/docs/mfc/reference/cmousemanager-class.md b/docs/mfc/reference/cmousemanager-class.md index 10ca342ab29..92e14a9af3f 100644 --- a/docs/mfc/reference/cmousemanager-class.md +++ b/docs/mfc/reference/cmousemanager-class.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: CMouseManager Class" title: "CMouseManager Class" +description: "Learn more about: CMouseManager Class" ms.date: "11/04/2016" f1_keywords: ["CMouseManager", "AFXMOUSEMANAGER/CMouseManager", "AFXMOUSEMANAGER/CMouseManager::AddView", "AFXMOUSEMANAGER/CMouseManager::GetViewDblClickCommand", "AFXMOUSEMANAGER/CMouseManager::GetViewIconId", "AFXMOUSEMANAGER/CMouseManager::GetViewIdByName", "AFXMOUSEMANAGER/CMouseManager::GetViewNames", "AFXMOUSEMANAGER/CMouseManager::LoadState", "AFXMOUSEMANAGER/CMouseManager::SaveState", "AFXMOUSEMANAGER/CMouseManager::SetCommandForDblClk"] helpviewer_keywords: ["CMouseManager [MFC], AddView", "CMouseManager [MFC], GetViewDblClickCommand", "CMouseManager [MFC], GetViewIconId", "CMouseManager [MFC], GetViewIdByName", "CMouseManager [MFC], GetViewNames", "CMouseManager [MFC], LoadState", "CMouseManager [MFC], SaveState", "CMouseManager [MFC], SetCommandForDblClk"] -ms.assetid: a4d05017-4e44-4a40-8b57-4ece0de20481 --- # CMouseManager Class @@ -33,7 +32,7 @@ class CMouseManager : public CObject ## Remarks -The `CMouseManager` class maintains a collection of `CView` objects. Each view is identified by a name and by an ID. These views are shown in the **Customization** dialog box. The user can change the command that is associated with any view through the **Customization** dialog box. The associated command is executed when the user double-clicks in that view. To support this from a coding perspective, you must process the WM_LBUTTONDBLCLK message and call the [CWinAppEx::OnViewDoubleClick](../../mfc/reference/cwinappex-class.md#onviewdoubleclick) function in the code for that `CView` object.. +The `CMouseManager` class maintains a collection of `CView` objects. Each view is identified by a name and by an ID. These views are shown in the **Customization** dialog box. The user can change the command that is associated with any view through the **Customization** dialog box. The associated command is executed when the user double-clicks in that view. To support this from a coding perspective, you must process the WM_LBUTTONDBLCLK message and call the [CWinAppEx::OnViewDoubleClick](../../mfc/reference/cwinappex-class.md#onviewdoubleclick) function in the code for that `CView` object. You should not create a `CMouseManager` object manually. It will be created by the framework of your application. It will also be destroyed automatically when the user exits the application. To get a pointer to the mouse manager for your application, call [CWinAppEx::GetMouseManager](../../mfc/reference/cwinappex-class.md#getmousemanager). @@ -246,7 +245,7 @@ If *uiCmd* is set to 0, the specified view is no longer associated with a comman ## See also -[Hierarchy Chart](../../mfc/hierarchy-chart.md)
-[Classes](../../mfc/reference/mfc-classes.md)
-[CWinAppEx Class](../../mfc/reference/cwinappex-class.md)
+[Hierarchy Chart](../../mfc/hierarchy-chart.md)\ +[Classes](../../mfc/reference/mfc-classes.md)\ +[CWinAppEx Class](../../mfc/reference/cwinappex-class.md)\ [Keyboard and Mouse Customization](../../mfc/keyboard-and-mouse-customization.md) diff --git a/docs/mfc/reference/cobarray-class.md b/docs/mfc/reference/cobarray-class.md index 40abda7c8d1..8dd735c1f0e 100644 --- a/docs/mfc/reference/cobarray-class.md +++ b/docs/mfc/reference/cobarray-class.md @@ -1,7 +1,7 @@ --- title: "CObArray Class" -description: "API reference for the `CObArray` `MFC` class which stores `CObject` pointers in an array." -ms.date: "08/27/2020" +description: "API reference for the `CObArray` MFC class which stores `CObject` pointers in an array." +ms.date: 08/27/2020 f1_keywords: ["CObArray", "AFXCOLL/CObArray", "AFXCOLL/CObArray::CObArray", "AFXCOLL/CObArray::Add", "AFXCOLL/CObArray::Append", "AFXCOLL/CObArray::Copy", "AFXCOLL/CObArray::ElementAt", "AFXCOLL/CObArray::FreeExtra", "AFXCOLL/CObArray::GetAt", "AFXCOLL/CObArray::GetCount", "AFXCOLL/CObArray::GetData", "AFXCOLL/CObArray::GetSize", "AFXCOLL/CObArray::GetUpperBound", "AFXCOLL/CObArray::InsertAt", "AFXCOLL/CObArray::IsEmpty", "AFXCOLL/CObArray::RemoveAll", "AFXCOLL/CObArray::RemoveAt", "AFXCOLL/CObArray::SetAt", "AFXCOLL/CObArray::SetAtGrow", "AFXCOLL/CObArray::SetSize"] helpviewer_keywords: ["CObArray [MFC], CObArray", "CObArray [MFC], Add", "CObArray [MFC], Append", "CObArray [MFC], Copy", "CObArray [MFC], ElementAt", "CObArray [MFC], FreeExtra", "CObArray [MFC], GetAt", "CObArray [MFC], GetCount", "CObArray [MFC], GetData", "CObArray [MFC], GetSize", "CObArray [MFC], GetUpperBound", "CObArray [MFC], InsertAt", "CObArray [MFC], IsEmpty", "CObArray [MFC], RemoveAll", "CObArray [MFC], RemoveAt", "CObArray [MFC], SetAt", "CObArray [MFC], SetAtGrow", "CObArray [MFC], SetSize"] --- diff --git a/docs/mfc/reference/codesnippet/CPP/cbutton-class_10.h b/docs/mfc/reference/codesnippet/CPP/cbutton-class_10.h index e34c0f5e239..c428acdc935 100644 --- a/docs/mfc/reference/codesnippet/CPP/cbutton-class_10.h +++ b/docs/mfc/reference/codesnippet/CPP/cbutton-class_10.h @@ -1,5 +1,5 @@ public: -// Variable to access programatically defined command link control. +// Variable to access programmatically defined command link control. CButton m_cmdLink; -// Variable to access programatically defined split button control. +// Variable to access programmatically defined split button control. CButton m_splitButton; \ No newline at end of file diff --git a/docs/mfc/reference/codesnippet/CPP/cmfcrebar-class_2.cpp b/docs/mfc/reference/codesnippet/CPP/cmfcrebar-class_2.cpp index bd1a7ee4322..8827522e7ca 100644 --- a/docs/mfc/reference/codesnippet/CPP/cmfcrebar-class_2.cpp +++ b/docs/mfc/reference/codesnippet/CPP/cmfcrebar-class_2.cpp @@ -1,4 +1,4 @@ -// Each rebar pane will ocupy its own row: +// Each rebar pane will occupy its own row: DWORD dwStyle = RBBS_GRIPPERALWAYS | RBBS_FIXEDBMP | RBBS_BREAK; // CMFCMenuBar m_wndMenuBar // CMFCToolBar m_wndToolBar diff --git a/docs/mfc/reference/codesnippet/CPP/cmfctoolbarscustomizedialog-class_2.cpp b/docs/mfc/reference/codesnippet/CPP/cmfctoolbarscustomizedialog-class_2.cpp index b6138fdf944..170c9fff5ed 100644 --- a/docs/mfc/reference/codesnippet/CPP/cmfctoolbarscustomizedialog-class_2.cpp +++ b/docs/mfc/reference/codesnippet/CPP/cmfctoolbarscustomizedialog-class_2.cpp @@ -1,5 +1,5 @@ CMFCToolBarsCustomizeDialog *pDlgCust = new CMFCToolBarsCustomizeDialog(this, - TRUE /* Automatic menus scaning */); + TRUE /* Automatic menus scanning */); CSliderButton btnSlider(ID_SLIDER); btnSlider.SetRange(0, 100); diff --git a/docs/mfc/reference/codesnippet/CPP/cmfctoolbarscustomizedialog-class_3.cpp b/docs/mfc/reference/codesnippet/CPP/cmfctoolbarscustomizedialog-class_3.cpp index bed3f475417..88446128e81 100644 --- a/docs/mfc/reference/codesnippet/CPP/cmfctoolbarscustomizedialog-class_3.cpp +++ b/docs/mfc/reference/codesnippet/CPP/cmfctoolbarscustomizedialog-class_3.cpp @@ -1,5 +1,5 @@ CMFCToolBarsCustomizeDialog *pDlgCust = new CMFCToolBarsCustomizeDialog(this, - TRUE /* Automatic menus scaning */, + TRUE /* Automatic menus scanning */, AFX_CUSTOMIZE_MENU_SHADOWS | AFX_CUSTOMIZE_TEXT_LABELS | AFX_CUSTOMIZE_MENU_ANIMATIONS); diff --git a/docs/mfc/reference/codesnippet/CPP/cmfctoolbarscustomizedialog-class_4.cpp b/docs/mfc/reference/codesnippet/CPP/cmfctoolbarscustomizedialog-class_4.cpp index 78fa084d092..e01076e8ae9 100644 --- a/docs/mfc/reference/codesnippet/CPP/cmfctoolbarscustomizedialog-class_4.cpp +++ b/docs/mfc/reference/codesnippet/CPP/cmfctoolbarscustomizedialog-class_4.cpp @@ -1,5 +1,5 @@ CMFCToolBarsCustomizeDialog *pDlgCust = new CMFCToolBarsCustomizeDialog(this, - TRUE /* Automatic menus scaning */, + TRUE /* Automatic menus scanning */, AFX_CUSTOMIZE_MENU_SHADOWS | AFX_CUSTOMIZE_TEXT_LABELS | AFX_CUSTOMIZE_MENU_ANIMATIONS, // default parameters &lstCustomPages); // pointer to the list of runtime classes of the custom property pages \ No newline at end of file diff --git a/docs/mfc/reference/codesnippet/CPP/cpagerctrl-class_5.cpp b/docs/mfc/reference/codesnippet/CPP/cpagerctrl-class_5.cpp index 8d26f622010..faf40bf8581 100644 --- a/docs/mfc/reference/codesnippet/CPP/cpagerctrl-class_5.cpp +++ b/docs/mfc/reference/codesnippet/CPP/cpagerctrl-class_5.cpp @@ -1,4 +1,3 @@ - void CCSplitButton_s2Dlg::OnXIsbuttoninvisible() { BOOL bLeft = m_pager.IsButtonInvisible(PGB_TOPORLEFT); diff --git a/docs/mfc/reference/coleclientitem-class.md b/docs/mfc/reference/coleclientitem-class.md index 6bbc2c72fcb..356cf6cdba4 100644 --- a/docs/mfc/reference/coleclientitem-class.md +++ b/docs/mfc/reference/coleclientitem-class.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: COleClientItem Class" title: "COleClientItem Class" -ms.date: "07/02/2019" +description: "Learn more about: COleClientItem Class" +ms.date: 07/02/2019 f1_keywords: ["COleClientItem", "AFXOLE/COleClientItem", "AFXOLE/COleClientItem::COleClientItem", "AFXOLE/COleClientItem::Activate", "AFXOLE/COleClientItem::ActivateAs", "AFXOLE/COleClientItem::AttachDataObject", "AFXOLE/COleClientItem::CanCreateFromData", "AFXOLE/COleClientItem::CanCreateLinkFromData", "AFXOLE/COleClientItem::CanPaste", "AFXOLE/COleClientItem::CanPasteLink", "AFXOLE/COleClientItem::Close", "AFXOLE/COleClientItem::ConvertTo", "AFXOLE/COleClientItem::CopyToClipboard", "AFXOLE/COleClientItem::CreateCloneFrom", "AFXOLE/COleClientItem::CreateFromClipboard", "AFXOLE/COleClientItem::CreateFromData", "AFXOLE/COleClientItem::CreateFromFile", "AFXOLE/COleClientItem::CreateLinkFromClipboard", "AFXOLE/COleClientItem::CreateLinkFromData", "AFXOLE/COleClientItem::CreateLinkFromFile", "AFXOLE/COleClientItem::CreateNewItem", "AFXOLE/COleClientItem::CreateStaticFromClipboard", "AFXOLE/COleClientItem::CreateStaticFromData", "AFXOLE/COleClientItem::Deactivate", "AFXOLE/COleClientItem::DeactivateUI", "AFXOLE/COleClientItem::Delete", "AFXOLE/COleClientItem::DoDragDrop", "AFXOLE/COleClientItem::DoVerb", "AFXOLE/COleClientItem::Draw", "AFXOLE/COleClientItem::GetActiveView", "AFXOLE/COleClientItem::GetCachedExtent", "AFXOLE/COleClientItem::GetClassID", "AFXOLE/COleClientItem::GetClipboardData", "AFXOLE/COleClientItem::GetDocument", "AFXOLE/COleClientItem::GetDrawAspect", "AFXOLE/COleClientItem::GetExtent", "AFXOLE/COleClientItem::GetIconFromRegistry", "AFXOLE/COleClientItem::GetIconicMetafile", "AFXOLE/COleClientItem::GetInPlaceWindow", "AFXOLE/COleClientItem::GetItemState", "AFXOLE/COleClientItem::GetLastStatus", "AFXOLE/COleClientItem::GetLinkUpdateOptions", "AFXOLE/COleClientItem::GetType", "AFXOLE/COleClientItem::GetUserType", "AFXOLE/COleClientItem::IsInPlaceActive", "AFXOLE/COleClientItem::IsLinkUpToDate", "AFXOLE/COleClientItem::IsModified", "AFXOLE/COleClientItem::IsOpen", "AFXOLE/COleClientItem::IsRunning", "AFXOLE/COleClientItem::OnActivate", "AFXOLE/COleClientItem::OnActivateUI", "AFXOLE/COleClientItem::OnChange", "AFXOLE/COleClientItem::OnDeactivate", "AFXOLE/COleClientItem::OnDeactivateUI", "AFXOLE/COleClientItem::OnGetClipboardData", "AFXOLE/COleClientItem::OnInsertMenus", "AFXOLE/COleClientItem::OnRemoveMenus", "AFXOLE/COleClientItem::OnSetMenu", "AFXOLE/COleClientItem::OnShowControlBars", "AFXOLE/COleClientItem::OnUpdateFrameTitle", "AFXOLE/COleClientItem::ReactivateAndUndo", "AFXOLE/COleClientItem::Release", "AFXOLE/COleClientItem::Reload", "AFXOLE/COleClientItem::Run", "AFXOLE/COleClientItem::SetDrawAspect", "AFXOLE/COleClientItem::SetExtent", "AFXOLE/COleClientItem::SetHostNames", "AFXOLE/COleClientItem::SetIconicMetafile", "AFXOLE/COleClientItem::SetItemRects", "AFXOLE/COleClientItem::SetLinkUpdateOptions", "AFXOLE/COleClientItem::SetPrintDevice", "AFXOLE/COleClientItem::UpdateLink", "AFXOLE/COleClientItem::CanActivate", "AFXOLE/COleClientItem::OnChangeItemPosition", "AFXOLE/COleClientItem::OnDeactivateAndUndo", "AFXOLE/COleClientItem::OnDiscardUndoState", "AFXOLE/COleClientItem::OnGetClipRect", "AFXOLE/COleClientItem::OnGetItemPosition", "AFXOLE/COleClientItem::OnGetWindowContext", "AFXOLE/COleClientItem::OnScrollBy", "AFXOLE/COleClientItem::OnShowItem"] helpviewer_keywords: ["COleClientItem [MFC], COleClientItem", "COleClientItem [MFC], Activate", "COleClientItem [MFC], ActivateAs", "COleClientItem [MFC], AttachDataObject", "COleClientItem [MFC], CanCreateFromData", "COleClientItem [MFC], CanCreateLinkFromData", "COleClientItem [MFC], CanPaste", "COleClientItem [MFC], CanPasteLink", "COleClientItem [MFC], Close", "COleClientItem [MFC], ConvertTo", "COleClientItem [MFC], CopyToClipboard", "COleClientItem [MFC], CreateCloneFrom", "COleClientItem [MFC], CreateFromClipboard", "COleClientItem [MFC], CreateFromData", "COleClientItem [MFC], CreateFromFile", "COleClientItem [MFC], CreateLinkFromClipboard", "COleClientItem [MFC], CreateLinkFromData", "COleClientItem [MFC], CreateLinkFromFile", "COleClientItem [MFC], CreateNewItem", "COleClientItem [MFC], CreateStaticFromClipboard", "COleClientItem [MFC], CreateStaticFromData", "COleClientItem [MFC], Deactivate", "COleClientItem [MFC], DeactivateUI", "COleClientItem [MFC], Delete", "COleClientItem [MFC], DoDragDrop", "COleClientItem [MFC], DoVerb", "COleClientItem [MFC], Draw", "COleClientItem [MFC], GetActiveView", "COleClientItem [MFC], GetCachedExtent", "COleClientItem [MFC], GetClassID", "COleClientItem [MFC], GetClipboardData", "COleClientItem [MFC], GetDocument", "COleClientItem [MFC], GetDrawAspect", "COleClientItem [MFC], GetExtent", "COleClientItem [MFC], GetIconFromRegistry", "COleClientItem [MFC], GetIconicMetafile", "COleClientItem [MFC], GetInPlaceWindow", "COleClientItem [MFC], GetItemState", "COleClientItem [MFC], GetLastStatus", "COleClientItem [MFC], GetLinkUpdateOptions", "COleClientItem [MFC], GetType", "COleClientItem [MFC], GetUserType", "COleClientItem [MFC], IsInPlaceActive", "COleClientItem [MFC], IsLinkUpToDate", "COleClientItem [MFC], IsModified", "COleClientItem [MFC], IsOpen", "COleClientItem [MFC], IsRunning", "COleClientItem [MFC], OnActivate", "COleClientItem [MFC], OnActivateUI", "COleClientItem [MFC], OnChange", "COleClientItem [MFC], OnDeactivate", "COleClientItem [MFC], OnDeactivateUI", "COleClientItem [MFC], OnGetClipboardData", "COleClientItem [MFC], OnInsertMenus", "COleClientItem [MFC], OnRemoveMenus", "COleClientItem [MFC], OnSetMenu", "COleClientItem [MFC], OnShowControlBars", "COleClientItem [MFC], OnUpdateFrameTitle", "COleClientItem [MFC], ReactivateAndUndo", "COleClientItem [MFC], Release", "COleClientItem [MFC], Reload", "COleClientItem [MFC], Run", "COleClientItem [MFC], SetDrawAspect", "COleClientItem [MFC], SetExtent", "COleClientItem [MFC], SetHostNames", "COleClientItem [MFC], SetIconicMetafile", "COleClientItem [MFC], SetItemRects", "COleClientItem [MFC], SetLinkUpdateOptions", "COleClientItem [MFC], SetPrintDevice", "COleClientItem [MFC], UpdateLink", "COleClientItem [MFC], CanActivate", "COleClientItem [MFC], OnChangeItemPosition", "COleClientItem [MFC], OnDeactivateAndUndo", "COleClientItem [MFC], OnDiscardUndoState", "COleClientItem [MFC], OnGetClipRect", "COleClientItem [MFC], OnGetItemPosition", "COleClientItem [MFC], OnGetWindowContext", "COleClientItem [MFC], OnScrollBy", "COleClientItem [MFC], OnShowItem"] -ms.assetid: 7f571b7c-2758-4839-847a-0cf1ef643128 --- # COleClientItem Class @@ -1434,7 +1433,7 @@ Override this function to apply special rules to the resize/move operation. If t ## COleClientItem::OnDeactivate -Called by the framework when the OLE item transitions from the in-place active state ( `activeState`) to the loaded state, meaning that it is deactivated after an in-place activation. +Called by the framework when the OLE item transitions from the in-place active state (`activeState`) to the loaded state, meaning that it is deactivated after an in-place activation. ``` virtual void OnDeactivate(); diff --git a/docs/mfc/reference/colecontrolsite-class.md b/docs/mfc/reference/colecontrolsite-class.md index 8b58ebd5845..1e7c3602a6e 100644 --- a/docs/mfc/reference/colecontrolsite-class.md +++ b/docs/mfc/reference/colecontrolsite-class.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: COleControlSite Class" title: "COleControlSite Class" -ms.date: "11/04/2016" +description: "Learn more about: COleControlSite Class" +ms.date: 11/04/2016 f1_keywords: ["COleControlSite", "AFXOCC/COleControlSite", "AFXOCC/COleControlSite::COleControlSite", "AFXOCC/COleControlSite::BindDefaultProperty", "AFXOCC/COleControlSite::BindProperty", "AFXOCC/COleControlSite::CreateControl", "AFXOCC/COleControlSite::DestroyControl", "AFXOCC/COleControlSite::DoVerb", "AFXOCC/COleControlSite::EnableDSC", "AFXOCC/COleControlSite::EnableWindow", "AFXOCC/COleControlSite::FreezeEvents", "AFXOCC/COleControlSite::GetDefBtnCode", "AFXOCC/COleControlSite::GetDlgCtrlID", "AFXOCC/COleControlSite::GetEventIID", "AFXOCC/COleControlSite::GetExStyle", "AFXOCC/COleControlSite::GetProperty", "AFXOCC/COleControlSite::GetStyle", "AFXOCC/COleControlSite::GetWindowText", "AFXOCC/COleControlSite::InvokeHelper", "AFXOCC/COleControlSite::InvokeHelperV", "AFXOCC/COleControlSite::IsDefaultButton", "AFXOCC/COleControlSite::IsWindowEnabled", "AFXOCC/COleControlSite::ModifyStyle", "AFXOCC/COleControlSite::ModifyStyleEx", "AFXOCC/COleControlSite::MoveWindow", "AFXOCC/COleControlSite::QuickActivate", "AFXOCC/COleControlSite::SafeSetProperty", "AFXOCC/COleControlSite::SetDefaultButton", "AFXOCC/COleControlSite::SetDlgCtrlID", "AFXOCC/COleControlSite::SetFocus", "AFXOCC/COleControlSite::SetProperty", "AFXOCC/COleControlSite::SetPropertyV", "AFXOCC/COleControlSite::SetWindowPos", "AFXOCC/COleControlSite::SetWindowText", "AFXOCC/COleControlSite::ShowWindow", "AFXOCC/COleControlSite::GetControlInfo", "AFXOCC/COleControlSite::m_bIsWindowless", "AFXOCC/COleControlSite::m_ctlInfo", "AFXOCC/COleControlSite::m_dwEventSink", "AFXOCC/COleControlSite::m_dwMiscStatus", "AFXOCC/COleControlSite::m_dwPropNotifySink", "AFXOCC/COleControlSite::m_dwStyle", "AFXOCC/COleControlSite::m_hWnd", "AFXOCC/COleControlSite::m_iidEvents", "AFXOCC/COleControlSite::m_nID", "AFXOCC/COleControlSite::m_pActiveObject", "AFXOCC/COleControlSite::m_pCtrlCont", "AFXOCC/COleControlSite::m_pInPlaceObject", "AFXOCC/COleControlSite::m_pObject", "AFXOCC/COleControlSite::m_pWindowlessObject", "AFXOCC/COleControlSite::m_pWndCtrl", "AFXOCC/COleControlSite::m_rect"] helpviewer_keywords: ["COleControlSite [MFC], COleControlSite", "COleControlSite [MFC], BindDefaultProperty", "COleControlSite [MFC], BindProperty", "COleControlSite [MFC], CreateControl", "COleControlSite [MFC], DestroyControl", "COleControlSite [MFC], DoVerb", "COleControlSite [MFC], EnableDSC", "COleControlSite [MFC], EnableWindow", "COleControlSite [MFC], FreezeEvents", "COleControlSite [MFC], GetDefBtnCode", "COleControlSite [MFC], GetDlgCtrlID", "COleControlSite [MFC], GetEventIID", "COleControlSite [MFC], GetExStyle", "COleControlSite [MFC], GetProperty", "COleControlSite [MFC], GetStyle", "COleControlSite [MFC], GetWindowText", "COleControlSite [MFC], InvokeHelper", "COleControlSite [MFC], InvokeHelperV", "COleControlSite [MFC], IsDefaultButton", "COleControlSite [MFC], IsWindowEnabled", "COleControlSite [MFC], ModifyStyle", "COleControlSite [MFC], ModifyStyleEx", "COleControlSite [MFC], MoveWindow", "COleControlSite [MFC], QuickActivate", "COleControlSite [MFC], SafeSetProperty", "COleControlSite [MFC], SetDefaultButton", "COleControlSite [MFC], SetDlgCtrlID", "COleControlSite [MFC], SetFocus", "COleControlSite [MFC], SetProperty", "COleControlSite [MFC], SetPropertyV", "COleControlSite [MFC], SetWindowPos", "COleControlSite [MFC], SetWindowText", "COleControlSite [MFC], ShowWindow", "COleControlSite [MFC], GetControlInfo", "COleControlSite [MFC], m_bIsWindowless", "COleControlSite [MFC], m_ctlInfo", "COleControlSite [MFC], m_dwEventSink", "COleControlSite [MFC], m_dwMiscStatus", "COleControlSite [MFC], m_dwPropNotifySink", "COleControlSite [MFC], m_dwStyle", "COleControlSite [MFC], m_hWnd", "COleControlSite [MFC], m_iidEvents", "COleControlSite [MFC], m_nID", "COleControlSite [MFC], m_pActiveObject", "COleControlSite [MFC], m_pCtrlCont", "COleControlSite [MFC], m_pInPlaceObject", "COleControlSite [MFC], m_pObject", "COleControlSite [MFC], m_pWindowlessObject", "COleControlSite [MFC], m_pWndCtrl", "COleControlSite [MFC], m_rect"] -ms.assetid: 43970644-5eab-434a-8ba6-56d144ff1e3f --- # COleControlSite Class @@ -646,7 +645,7 @@ DWORD m_dwMiscStatus; ### Remarks -For more information, see [OLEMISC](/windows/win32/api/oleidl/ne-oleidl-olemisc)in the Windows SDK. +For more information, see [OLEMISC](/windows/win32/api/oleidl/ne-oleidl-olemisc) in the Windows SDK. ## COleControlSite::m_dwPropNotifySink @@ -722,7 +721,7 @@ LPOLEOBJECT m_pObject; ## COleControlSite::m_pWindowlessObject -Contains the `IOleInPlaceObjectWindowless`[IOleInPlaceObjectWindowless](/windows/win32/api/ocidl/nn-ocidl-ioleinplaceobjectwindowless) interface of the control. +Contains the [`IOleInPlaceObjectWindowless`](/windows/win32/api/ocidl/nn-ocidl-ioleinplaceobjectwindowless) interface of the control. ``` IOleInPlaceObjectWindowless* m_pWindowlessObject; diff --git a/docs/mfc/reference/colecurrency-class.md b/docs/mfc/reference/colecurrency-class.md index d208b9739da..76b27412456 100644 --- a/docs/mfc/reference/colecurrency-class.md +++ b/docs/mfc/reference/colecurrency-class.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: COleCurrency Class" title: "COleCurrency Class" -ms.date: "08/29/2019" +description: "Learn more about: COleCurrency Class" +ms.date: 08/29/2019 f1_keywords: ["COleCurrency", "AFXDISP/COleCurrency", "AFXDISP/COleCurrency::COleCurrency", "AFXDISP/COleCurrency::Format", "AFXDISP/COleCurrency::GetStatus", "AFXDISP/COleCurrency::ParseCurrency", "AFXDISP/COleCurrency::SetCurrency", "AFXDISP/COleCurrency::SetStatus", "AFXDISP/COleCurrency::m_cur", "AFXDISP/COleCurrency::m_status"] helpviewer_keywords: ["COleCurrency [MFC], COleCurrency", "COleCurrency [MFC], Format", "COleCurrency [MFC], GetStatus", "COleCurrency [MFC], ParseCurrency", "COleCurrency [MFC], SetCurrency", "COleCurrency [MFC], SetStatus", "COleCurrency [MFC], m_cur", "COleCurrency [MFC], m_status"] -ms.assetid: 3a36e345-303f-46fb-a57c-858274378a8d --- # COleCurrency Class @@ -290,7 +289,7 @@ A brief description of each operator follows: - **operator =(** `curSrc` **)** The value and status of the operand, an existing `COleCurrency` object are copied into this `COleCurrency` object. -- **operator =(** *varSrc* **)** If the conversion of the `VARIANT` value (or [COleVariant](../../mfc/reference/colevariant-class.md) object) to a currency ( `VT_CY`) is successful, the converted value is copied into this `COleCurrency` object and its status is set to valid. If the conversion is not successful, the value of the `COleCurrency` object is set to 0 and its status to invalid. +- **operator =(** *varSrc* **)** If the conversion of the `VARIANT` value (or [COleVariant](../../mfc/reference/colevariant-class.md) object) to a currency (`VT_CY`) is successful, the converted value is copied into this `COleCurrency` object and its status is set to valid. If the conversion is not successful, the value of the `COleCurrency` object is set to 0 and its status to invalid. For more information, see the [CURRENCY](/windows/win32/api/wtypes/ns-wtypes-cy-r1) and [VARIANT](/windows/win32/api/oaidl/ns-oaidl-variant) entries in the Windows SDK. @@ -486,7 +485,7 @@ BOOL operator>=(const COleCurrency& cur) const; ### Remarks > [!NOTE] -> The return value of the ordering operations ( **<**, **\<=**, **>**, **>=**) is undefined if the status of either operand is null or invalid. The equality operators ( `==`, `!=`) consider the status of the operands. +> The return value of the ordering operations ( **<**, **\<=**, **>**, **>=**) is undefined if the status of either operand is null or invalid. The equality operators (`==`, `!=`) consider the status of the operands. ### Example diff --git a/docs/mfc/reference/coledocument-class.md b/docs/mfc/reference/coledocument-class.md index c8ad83bdfbe..fe1959bf1aa 100644 --- a/docs/mfc/reference/coledocument-class.md +++ b/docs/mfc/reference/coledocument-class.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: COleDocument Class" title: "COleDocument Class" +description: "Learn more about: COleDocument Class" ms.date: "11/04/2016" f1_keywords: ["COleDocument", "AFXOLE/COleDocument", "AFXOLE/COleDocument::COleDocument", "AFXOLE/COleDocument::AddItem", "AFXOLE/COleDocument::ApplyPrintDevice", "AFXOLE/COleDocument::EnableCompoundFile", "AFXOLE/COleDocument::GetInPlaceActiveItem", "AFXOLE/COleDocument::GetNextClientItem", "AFXOLE/COleDocument::GetNextItem", "AFXOLE/COleDocument::GetNextServerItem", "AFXOLE/COleDocument::GetPrimarySelectedItem", "AFXOLE/COleDocument::GetStartPosition", "AFXOLE/COleDocument::HasBlankItems", "AFXOLE/COleDocument::OnShowViews", "AFXOLE/COleDocument::RemoveItem", "AFXOLE/COleDocument::UpdateModifiedFlag", "AFXOLE/COleDocument::OnEditChangeIcon", "AFXOLE/COleDocument::OnEditConvert", "AFXOLE/COleDocument::OnEditLinks", "AFXOLE/COleDocument::OnFileSendMail", "AFXOLE/COleDocument::OnUpdateEditChangeIcon", "AFXOLE/COleDocument::OnUpdateEditLinksMenu", "AFXOLE/COleDocument::OnUpdateObjectVerbMenu", "AFXOLE/COleDocument::OnUpdatePasteLinkMenu", "AFXOLE/COleDocument::OnUpdatePasteMenu"] helpviewer_keywords: ["COleDocument [MFC], COleDocument", "COleDocument [MFC], AddItem", "COleDocument [MFC], ApplyPrintDevice", "COleDocument [MFC], EnableCompoundFile", "COleDocument [MFC], GetInPlaceActiveItem", "COleDocument [MFC], GetNextClientItem", "COleDocument [MFC], GetNextItem", "COleDocument [MFC], GetNextServerItem", "COleDocument [MFC], GetPrimarySelectedItem", "COleDocument [MFC], GetStartPosition", "COleDocument [MFC], HasBlankItems", "COleDocument [MFC], OnShowViews", "COleDocument [MFC], RemoveItem", "COleDocument [MFC], UpdateModifiedFlag", "COleDocument [MFC], OnEditChangeIcon", "COleDocument [MFC], OnEditConvert", "COleDocument [MFC], OnEditLinks", "COleDocument [MFC], OnFileSendMail", "COleDocument [MFC], OnUpdateEditChangeIcon", "COleDocument [MFC], OnUpdateEditLinksMenu", "COleDocument [MFC], OnUpdateObjectVerbMenu", "COleDocument [MFC], OnUpdatePasteLinkMenu", "COleDocument [MFC], OnUpdatePasteMenu"] -ms.assetid: dc2ecb99-03e1-44c7-bb69-48056dd1b672 --- # COleDocument Class @@ -64,9 +63,9 @@ class COleDocument : public CDocument If you are writing a simple container application, derive your document class from `COleDocument`. If you are writing a container application that supports linking to the embedded items contained by its documents, derive your document class from [COleLinkingDoc](../../mfc/reference/colelinkingdoc-class.md). If you are writing a server application or combination container/server, derive your document class from [COleServerDoc](../../mfc/reference/coleserverdoc-class.md). `COleLinkingDoc` and `COleServerDoc` are derived from `COleDocument`, so these classes inherit all the services available in `COleDocument` and `CDocument`. -To use `COleDocument`, derive a class from it and add functionality to manage the application's non-OLE data as well as embedded or linked items. If you define `CDocItem`-derived classes to store the application's native data, you can use the default implementation defined by `COleDocument` to store both your OLE and non-OLE data. You can also design your own data structures for storing your non-OLE data separately from the OLE items. For more information, see the article [Containers: Compound Files](../../mfc/containers-compound-files.md).. +To use `COleDocument`, derive a class from it and add functionality to manage the application's non-OLE data as well as embedded or linked items. If you define `CDocItem`-derived classes to store the application's native data, you can use the default implementation defined by `COleDocument` to store both your OLE and non-OLE data. You can also design your own data structures for storing your non-OLE data separately from the OLE items. For more information, see the article [Containers: Compound Files](../../mfc/containers-compound-files.md). -`CDocument` supports sending your document via mail if mail support (MAPI) is present. `COleDocument` has updated [OnFileSendMail](#onfilesendmail) to handle compound documents correctly. For more information, see the articles [MAPI](../../mfc/mapi.md) and [MAPI Support in MFC](../../mfc/mapi-support-in-mfc.md).. +`CDocument` supports sending your document via mail if mail support (MAPI) is present. `COleDocument` has updated [OnFileSendMail](#onfilesendmail) to handle compound documents correctly. For more information, see the articles [MAPI](../../mfc/mapi.md) and [MAPI Support in MFC](../../mfc/mapi-support-in-mfc.md). ## Inheritance Hierarchy @@ -153,7 +152,7 @@ Specifies whether compound file support is enabled or disabled. ### Remarks -This is also called structured storage. You typically call this function from the constructor of your `COleDocument`-derived class. For more information about compound documents, see the article [Containers: Compound Files](../../mfc/containers-compound-files.md).. +This is also called structured storage. You typically call this function from the constructor of your `COleDocument`-derived class. For more information about compound documents, see the article [Containers: Compound Files](../../mfc/containers-compound-files.md). If you do not call this member function, documents will be stored in a nonstructured ("flat") file format. @@ -356,7 +355,7 @@ afx_msg void OnFileSendMail(); Unlike the implementation of `OnFileSendMail` for `CDocument`, this function handles compound files correctly. -For more information, see the [MAPI Topics](../../mfc/mapi.md) and [MAPI Support in MFC](../../mfc/mapi-support-in-mfc.md) articles.. +For more information, see the [MAPI Topics](../../mfc/mapi.md) and [MAPI Support in MFC](../../mfc/mapi-support-in-mfc.md) articles. ## COleDocument::OnShowViews @@ -491,7 +490,7 @@ This allows the framework to prompt the user to save the document before closing ## See also -[MFC Sample CONTAINER](../../overview/visual-cpp-samples.md)
-[MFC Sample MFCBIND](../../overview/visual-cpp-samples.md)
-[CDocument Class](../../mfc/reference/cdocument-class.md)
+[MFC Sample CONTAINER](../../overview/visual-cpp-samples.md)\ +[MFC Sample MFCBIND](../../overview/visual-cpp-samples.md)\ +[CDocument Class](../../mfc/reference/cdocument-class.md)\ [Hierarchy Chart](../../mfc/hierarchy-chart.md) diff --git a/docs/mfc/reference/coleipframewndex-class.md b/docs/mfc/reference/coleipframewndex-class.md index 69d2da9c479..51faf2f1521 100644 --- a/docs/mfc/reference/coleipframewndex-class.md +++ b/docs/mfc/reference/coleipframewndex-class.md @@ -1,14 +1,13 @@ --- -description: "Learn more about: COleIPFrameWndEx Class" title: "COleIPFrameWndEx Class" -ms.date: "11/04/2016" +description: "Learn more about: COleIPFrameWndEx Class" +ms.date: 11/04/2016 f1_keywords: ["COleIPFrameWndEx", "AFXOLEIPFRAMEWNDEX/COleIPFrameWndEx", "AFXOLEIPFRAMEWNDEX/COleIPFrameWndEx::AddDockSite", "AFXOLEIPFRAMEWNDEX/COleIPFrameWndEx::AddPane", "AFXOLEIPFRAMEWNDEX/COleIPFrameWndEx::AdjustDockingLayout", "AFXOLEIPFRAMEWNDEX/COleIPFrameWndEx::DockPane", "AFXOLEIPFRAMEWNDEX/COleIPFrameWndEx::DockPaneLeftOf", "AFXOLEIPFRAMEWNDEX/COleIPFrameWndEx::EnableAutoHidePanes", "AFXOLEIPFRAMEWNDEX/COleIPFrameWndEx::EnableDocking", "AFXOLEIPFRAMEWNDEX/COleIPFrameWndEx::EnablePaneMenu", "AFXOLEIPFRAMEWNDEX/COleIPFrameWndEx::GetActivePopup", "AFXOLEIPFRAMEWNDEX/COleIPFrameWndEx::GetContainerFrameWindow", "AFXOLEIPFRAMEWNDEX/COleIPFrameWndEx::GetDefaultResId", "AFXOLEIPFRAMEWNDEX/COleIPFrameWndEx::GetDockFrame", "AFXOLEIPFRAMEWNDEX/COleIPFrameWndEx::GetDockingManager", "AFXOLEIPFRAMEWNDEX/COleIPFrameWndEx::GetMainFrame", "AFXOLEIPFRAMEWNDEX/COleIPFrameWndEx::GetMenuBar", "AFXOLEIPFRAMEWNDEX/COleIPFrameWndEx::GetPane", "AFXOLEIPFRAMEWNDEX/COleIPFrameWndEx::GetTearOffBars", "AFXOLEIPFRAMEWNDEX/COleIPFrameWndEx::GetToolbarButtonToolTipText", "AFXOLEIPFRAMEWNDEX/COleIPFrameWndEx::InsertPane", "AFXOLEIPFRAMEWNDEX/COleIPFrameWndEx::IsMenuBarAvailable", "AFXOLEIPFRAMEWNDEX/COleIPFrameWndEx::IsPointNearDockSite", "AFXOLEIPFRAMEWNDEX/COleIPFrameWndEx::LoadFrame", "AFXOLEIPFRAMEWNDEX/COleIPFrameWndEx::OnCloseDockingPane", "AFXOLEIPFRAMEWNDEX/COleIPFrameWndEx::OnCloseMiniFrame", "AFXOLEIPFRAMEWNDEX/COleIPFrameWndEx::OnClosePopupMenu", "AFXOLEIPFRAMEWNDEX/COleIPFrameWndEx::OnCmdMsg", "AFXOLEIPFRAMEWNDEX/COleIPFrameWndEx::OnDrawMenuImage", "AFXOLEIPFRAMEWNDEX/COleIPFrameWndEx::OnDrawMenuLogo", "AFXOLEIPFRAMEWNDEX/COleIPFrameWndEx::OnMenuButtonToolHitTest", "AFXOLEIPFRAMEWNDEX/COleIPFrameWndEx::OnMoveMiniFrame", "AFXOLEIPFRAMEWNDEX/COleIPFrameWndEx::OnSetPreviewMode", "AFXOLEIPFRAMEWNDEX/COleIPFrameWndEx::OnShowCustomizePane", "AFXOLEIPFRAMEWNDEX/COleIPFrameWndEx::OnShowPanes", "AFXOLEIPFRAMEWNDEX/COleIPFrameWndEx::OnShowPopupMenu", "AFXOLEIPFRAMEWNDEX/COleIPFrameWndEx::OnTearOffMenu", "AFXOLEIPFRAMEWNDEX/COleIPFrameWndEx::PaneFromPoint", "AFXOLEIPFRAMEWNDEX/COleIPFrameWndEx::PreTranslateMessage", "AFXOLEIPFRAMEWNDEX/COleIPFrameWndEx::RecalcLayout", "AFXOLEIPFRAMEWNDEX/COleIPFrameWndEx::RemovePaneFromDockManager", "AFXOLEIPFRAMEWNDEX/COleIPFrameWndEx::SetDockState", "AFXOLEIPFRAMEWNDEX/COleIPFrameWndEx::SetupToolbarMenu", "AFXOLEIPFRAMEWNDEX/COleIPFrameWndEx::ShowPane", "AFXOLEIPFRAMEWNDEX/COleIPFrameWndEx::WinHelpA", "AFXOLEIPFRAMEWNDEX/COleIPFrameWndEx::InitUserToobars"] helpviewer_keywords: ["COleIPFrameWndEx [MFC], AddDockSite", "COleIPFrameWndEx [MFC], AddPane", "COleIPFrameWndEx [MFC], AdjustDockingLayout", "COleIPFrameWndEx [MFC], DockPane", "COleIPFrameWndEx [MFC], DockPaneLeftOf", "COleIPFrameWndEx [MFC], EnableAutoHidePanes", "COleIPFrameWndEx [MFC], EnableDocking", "COleIPFrameWndEx [MFC], EnablePaneMenu", "COleIPFrameWndEx [MFC], GetActivePopup", "COleIPFrameWndEx [MFC], GetContainerFrameWindow", "COleIPFrameWndEx [MFC], GetDefaultResId", "COleIPFrameWndEx [MFC], GetDockFrame", "COleIPFrameWndEx [MFC], GetDockingManager", "COleIPFrameWndEx [MFC], GetMainFrame", "COleIPFrameWndEx [MFC], GetMenuBar", "COleIPFrameWndEx [MFC], GetPane", "COleIPFrameWndEx [MFC], GetTearOffBars", "COleIPFrameWndEx [MFC], GetToolbarButtonToolTipText", "COleIPFrameWndEx [MFC], InsertPane", "COleIPFrameWndEx [MFC], IsMenuBarAvailable", "COleIPFrameWndEx [MFC], IsPointNearDockSite", "COleIPFrameWndEx [MFC], LoadFrame", "COleIPFrameWndEx [MFC], OnCloseDockingPane", "COleIPFrameWndEx [MFC], OnCloseMiniFrame", "COleIPFrameWndEx [MFC], OnClosePopupMenu", "COleIPFrameWndEx [MFC], OnCmdMsg", "COleIPFrameWndEx [MFC], OnDrawMenuImage", "COleIPFrameWndEx [MFC], OnDrawMenuLogo", "COleIPFrameWndEx [MFC], OnMenuButtonToolHitTest", "COleIPFrameWndEx [MFC], OnMoveMiniFrame", "COleIPFrameWndEx [MFC], OnSetPreviewMode", "COleIPFrameWndEx [MFC], OnShowCustomizePane", "COleIPFrameWndEx [MFC], OnShowPanes", "COleIPFrameWndEx [MFC], OnShowPopupMenu", "COleIPFrameWndEx [MFC], OnTearOffMenu", "COleIPFrameWndEx [MFC], PaneFromPoint", "COleIPFrameWndEx [MFC], PreTranslateMessage", "COleIPFrameWndEx [MFC], RecalcLayout", "COleIPFrameWndEx [MFC], RemovePaneFromDockManager", "COleIPFrameWndEx [MFC], SetDockState", "COleIPFrameWndEx [MFC], SetupToolbarMenu", "COleIPFrameWndEx [MFC], ShowPane", "COleIPFrameWndEx [MFC], WinHelpA", "COleIPFrameWndEx [MFC], InitUserToobars"] -ms.assetid: ebff1560-a1eb-4854-af00-95d4a192bd55 --- # COleIPFrameWndEx Class -The `COleIPFrameWndEx` class implements an OLE container that supports MFC. You must derive the in-place frame window class for your application from the `COleIPFrameWndEx` class, instead of deriving it from the [COleIPFrameWnd](../../mfc/reference/coleipframewnd-class.md)class. +The `COleIPFrameWndEx` class implements an OLE container that supports MFC. You must derive the in-place frame window class for your application from the `COleIPFrameWndEx` class, instead of deriving it from the [COleIPFrameWnd](../../mfc/reference/coleipframewnd-class.md) class. For more detail see the source code located in the **VC\\atlmfc\\src\\mfc** folder of your Visual Studio installation. ## Syntax @@ -50,8 +49,8 @@ class COleIPFrameWndEx : public COleIPFrameWnd |[COleIPFrameWndEx::OnClosePopupMenu](#onclosepopupmenu)|Called by the framework when an active pop-up menu processes a WM_DESTROY message.| |[COleIPFrameWndEx::OnCmdMsg](#oncmdmsg)|(Overrides `CFrameWnd::OnCmdMsg`.)| |[COleIPFrameWndEx::OnDrawMenuImage](#ondrawmenuimage)|Called by the framework when the image associated with a menu item is drawn.| -|[COleIPFrameWndEx::OnDrawMenuLogo](#ondrawmenulogo)|Called by the framework when a [CMFCPopupMenu](../../mfc/reference/cmfcpopupmenu-class.md)object processes a WM_PAINT message.| -|[COleIPFrameWndEx::OnMenuButtonToolHitTest](#onmenubuttontoolhittest)|Called by the framework when a [CMFCToolBarButton](../../mfc/reference/cmfctoolbarbutton-class.md)object processes WM_NCHITTEST message.| +|[COleIPFrameWndEx::OnDrawMenuLogo](#ondrawmenulogo)|Called by the framework when a [CMFCPopupMenu](../../mfc/reference/cmfcpopupmenu-class.md) object processes a WM_PAINT message.| +|[COleIPFrameWndEx::OnMenuButtonToolHitTest](#onmenubuttontoolhittest)|Called by the framework when a [CMFCToolBarButton](../../mfc/reference/cmfctoolbarbutton-class.md) object processes WM_NCHITTEST message.| |[COleIPFrameWndEx::OnMoveMiniFrame](#onmoveminiframe)|| |[COleIPFrameWndEx::OnSetPreviewMode](#onsetpreviewmode)|Call this member function to set the application's main frame window into and out of print-preview mode. (Overrides [CFrameWnd::OnSetPreviewMode](../../mfc/reference/cframewnd-class.md#onsetpreviewmode).)| |[COleIPFrameWndEx::OnShowCustomizePane](#onshowcustomizepane)|| @@ -571,7 +570,7 @@ Override this method if you want to customize image drawing for the menu items t ## COleIPFrameWndEx::OnDrawMenuLogo -Called by the framework when a [CMFCPopupMenu](../../mfc/reference/cmfcpopupmenu-class.md)object processes a WM_PAINT message. +Called by the framework when a [CMFCPopupMenu](../../mfc/reference/cmfcpopupmenu-class.md) object processes a WM_PAINT message. ``` virtual void OnDrawMenuLogo( @@ -597,7 +596,7 @@ Override this method to display a logo on the pop-up menu associated with the me ## COleIPFrameWndEx::OnMenuButtonToolHitTest -Called by the framework when a [CMFCToolBarButton](../../mfc/reference/cmfctoolbarbutton-class.md)object processes a WM_NCHITTEST message. +Called by the framework when a [CMFCToolBarButton](../../mfc/reference/cmfctoolbarbutton-class.md) object processes a WM_NCHITTEST message. ``` virtual BOOL OnMenuButtonToolHitTest( diff --git a/docs/mfc/reference/colesafearray-class.md b/docs/mfc/reference/colesafearray-class.md index 1efbd04b7f8..f85c05baf87 100644 --- a/docs/mfc/reference/colesafearray-class.md +++ b/docs/mfc/reference/colesafearray-class.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: COleSafeArray Class" title: "COleSafeArray Class" -ms.date: "08/29/2019" +description: "Learn more about: COleSafeArray Class" +ms.date: 08/29/2019 f1_keywords: ["COleSafeArray", "AFXDISP/COleSafeArray", "AFXDISP/COleSafeArray::COleSafeArray", "AFXDISP/COleSafeArray::AccessData", "AFXDISP/COleSafeArray::AllocData", "AFXDISP/COleSafeArray::AllocDescriptor", "AFXDISP/COleSafeArray::Attach", "AFXDISP/COleSafeArray::Clear", "AFXDISP/COleSafeArray::Copy", "AFXDISP/COleSafeArray::Create", "AFXDISP/COleSafeArray::CreateOneDim", "AFXDISP/COleSafeArray::Destroy", "AFXDISP/COleSafeArray::DestroyData", "AFXDISP/COleSafeArray::DestroyDescriptor", "AFXDISP/COleSafeArray::Detach", "AFXDISP/COleSafeArray::GetByteArray", "AFXDISP/COleSafeArray::GetDim", "AFXDISP/COleSafeArray::GetElement", "AFXDISP/COleSafeArray::GetElemSize", "AFXDISP/COleSafeArray::GetLBound", "AFXDISP/COleSafeArray::GetOneDimSize", "AFXDISP/COleSafeArray::GetUBound", "AFXDISP/COleSafeArray::Lock", "AFXDISP/COleSafeArray::PtrOfIndex", "AFXDISP/COleSafeArray::PutElement", "AFXDISP/COleSafeArray::Redim", "AFXDISP/COleSafeArray::ResizeOneDim", "AFXDISP/COleSafeArray::UnaccessData", "AFXDISP/COleSafeArray::Unlock"] helpviewer_keywords: ["COleSafeArray [MFC], COleSafeArray", "COleSafeArray [MFC], AccessData", "COleSafeArray [MFC], AllocData", "COleSafeArray [MFC], AllocDescriptor", "COleSafeArray [MFC], Attach", "COleSafeArray [MFC], Clear", "COleSafeArray [MFC], Copy", "COleSafeArray [MFC], Create", "COleSafeArray [MFC], CreateOneDim", "COleSafeArray [MFC], Destroy", "COleSafeArray [MFC], DestroyData", "COleSafeArray [MFC], DestroyDescriptor", "COleSafeArray [MFC], Detach", "COleSafeArray [MFC], GetByteArray", "COleSafeArray [MFC], GetDim", "COleSafeArray [MFC], GetElement", "COleSafeArray [MFC], GetElemSize", "COleSafeArray [MFC], GetLBound", "COleSafeArray [MFC], GetOneDimSize", "COleSafeArray [MFC], GetUBound", "COleSafeArray [MFC], Lock", "COleSafeArray [MFC], PtrOfIndex", "COleSafeArray [MFC], PutElement", "COleSafeArray [MFC], Redim", "COleSafeArray [MFC], ResizeOneDim", "COleSafeArray [MFC], UnaccessData", "COleSafeArray [MFC], Unlock"] -ms.assetid: f45a5224-5f48-40ec-9ddd-287ef9740150 --- # COleSafeArray Class @@ -554,11 +553,14 @@ A brief description of each operator follows: This operator compares two arrays (`SAFEARRAY`, `VARIANT`, `COleVariant`, or `COleSafeArray` arrays) and returns nonzero if they are equal; otherwise 0. ``` -BOOL operator==(const SAFEARRAY& saSrc) const; BOOL operator==(LPCSAFEARRAY pSrc) const; +BOOL operator==(const SAFEARRAY& saSrc) const; +BOOL operator==(LPCSAFEARRAY pSrc) const; -BOOL operator==(const COleSafeArray& saSrc) const; BOOL operator==(const VARIANT& varSrc) const; +BOOL operator==(const COleSafeArray& saSrc) const; +BOOL operator==(const VARIANT& varSrc) const; -BOOL operator==(LPCVARIANT pSrc) const; BOOL operator==(const COleVariant& varSrc) const; +BOOL operator==(LPCVARIANT pSrc) const; +BOOL operator==(const COleVariant& varSrc) const; ``` ### Remarks diff --git a/docs/mfc/reference/coleserverdoc-class.md b/docs/mfc/reference/coleserverdoc-class.md index 59f7a9c34b2..b81a4ff6fdf 100644 --- a/docs/mfc/reference/coleserverdoc-class.md +++ b/docs/mfc/reference/coleserverdoc-class.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: COleServerDoc Class" title: "COleServerDoc Class" +description: "Learn more about: COleServerDoc Class" ms.date: "11/04/2016" f1_keywords: ["COleServerDoc", "AFXOLE/COleServerDoc", "AFXOLE/COleServerDoc::COleServerDoc", "AFXOLE/COleServerDoc::ActivateDocObject", "AFXOLE/COleServerDoc::ActivateInPlace", "AFXOLE/COleServerDoc::DeactivateAndUndo", "AFXOLE/COleServerDoc::DiscardUndoState", "AFXOLE/COleServerDoc::GetClientSite", "AFXOLE/COleServerDoc::GetEmbeddedItem", "AFXOLE/COleServerDoc::GetItemClipRect", "AFXOLE/COleServerDoc::GetItemPosition", "AFXOLE/COleServerDoc::GetZoomFactor", "AFXOLE/COleServerDoc::IsDocObject", "AFXOLE/COleServerDoc::IsEmbedded", "AFXOLE/COleServerDoc::IsInPlaceActive", "AFXOLE/COleServerDoc::NotifyChanged", "AFXOLE/COleServerDoc::NotifyClosed", "AFXOLE/COleServerDoc::NotifyRename", "AFXOLE/COleServerDoc::NotifySaved", "AFXOLE/COleServerDoc::OnDeactivate", "AFXOLE/COleServerDoc::OnDeactivateUI", "AFXOLE/COleServerDoc::OnDocWindowActivate", "AFXOLE/COleServerDoc::OnResizeBorder", "AFXOLE/COleServerDoc::OnShowControlBars", "AFXOLE/COleServerDoc::OnUpdateDocument", "AFXOLE/COleServerDoc::RequestPositionChange", "AFXOLE/COleServerDoc::SaveEmbedding", "AFXOLE/COleServerDoc::ScrollContainerBy", "AFXOLE/COleServerDoc::UpdateAllItems", "AFXOLE/COleServerDoc::CreateInPlaceFrame", "AFXOLE/COleServerDoc::DestroyInPlaceFrame", "AFXOLE/COleServerDoc::GetDocObjectServer", "AFXOLE/COleServerDoc::OnClose", "AFXOLE/COleServerDoc::OnExecOleCmd", "AFXOLE/COleServerDoc::OnFrameWindowActivate", "AFXOLE/COleServerDoc::OnGetEmbeddedItem", "AFXOLE/COleServerDoc::OnReactivateAndUndo", "AFXOLE/COleServerDoc::OnSetHostNames", "AFXOLE/COleServerDoc::OnSetItemRects", "AFXOLE/COleServerDoc::OnShowDocument"] helpviewer_keywords: ["COleServerDoc [MFC], COleServerDoc", "COleServerDoc [MFC], ActivateDocObject", "COleServerDoc [MFC], ActivateInPlace", "COleServerDoc [MFC], DeactivateAndUndo", "COleServerDoc [MFC], DiscardUndoState", "COleServerDoc [MFC], GetClientSite", "COleServerDoc [MFC], GetEmbeddedItem", "COleServerDoc [MFC], GetItemClipRect", "COleServerDoc [MFC], GetItemPosition", "COleServerDoc [MFC], GetZoomFactor", "COleServerDoc [MFC], IsDocObject", "COleServerDoc [MFC], IsEmbedded", "COleServerDoc [MFC], IsInPlaceActive", "COleServerDoc [MFC], NotifyChanged", "COleServerDoc [MFC], NotifyClosed", "COleServerDoc [MFC], NotifyRename", "COleServerDoc [MFC], NotifySaved", "COleServerDoc [MFC], OnDeactivate", "COleServerDoc [MFC], OnDeactivateUI", "COleServerDoc [MFC], OnDocWindowActivate", "COleServerDoc [MFC], OnResizeBorder", "COleServerDoc [MFC], OnShowControlBars", "COleServerDoc [MFC], OnUpdateDocument", "COleServerDoc [MFC], RequestPositionChange", "COleServerDoc [MFC], SaveEmbedding", "COleServerDoc [MFC], ScrollContainerBy", "COleServerDoc [MFC], UpdateAllItems", "COleServerDoc [MFC], CreateInPlaceFrame", "COleServerDoc [MFC], DestroyInPlaceFrame", "COleServerDoc [MFC], GetDocObjectServer", "COleServerDoc [MFC], OnClose", "COleServerDoc [MFC], OnExecOleCmd", "COleServerDoc [MFC], OnFrameWindowActivate", "COleServerDoc [MFC], OnGetEmbeddedItem", "COleServerDoc [MFC], OnReactivateAndUndo", "COleServerDoc [MFC], OnSetHostNames", "COleServerDoc [MFC], OnSetItemRects", "COleServerDoc [MFC], OnShowDocument"] -ms.assetid: a9cdd96a-e0ac-43bb-9203-2c29237e965c --- # COleServerDoc Class @@ -477,7 +476,7 @@ This function restores the container application's user interface to its origina The undo state information should be unconditionally released at this point. -For more information, see the article [Activation](../../mfc/activation-cpp.md).. +For more information, see the article [Activation](../../mfc/activation-cpp.md). ## COleServerDoc::OnDeactivateUI @@ -515,7 +514,7 @@ Specifies whether the document window is to be activated or deactivated. The default implementation removes or adds the frame-level user interface elements as appropriate. Override this function if you want to perform additional actions when the document containing your item is activated or deactivated. -For more information, see the article [Activation](../../mfc/activation-cpp.md).. +For more information, see the article [Activation](../../mfc/activation-cpp.md). ## COleServerDoc::OnExecOleCmd @@ -599,7 +598,7 @@ Specifies whether the frame window is to be activated or deactivated. The default implementation cancels any help modes the frame window might be in. Override this function if you want to perform special processing when the frame window is activated or deactivated. -For more information, see the article [Activation](../../mfc/activation-cpp.md).. +For more information, see the article [Activation](../../mfc/activation-cpp.md). ## COleServerDoc::OnGetEmbeddedItem @@ -860,9 +859,9 @@ This function calls the `OnUpdate` member function for each of the document's it ## See also -[MFC Sample HIERSVR](../../overview/visual-cpp-samples.md)
-[COleLinkingDoc Class](../../mfc/reference/colelinkingdoc-class.md)
-[Hierarchy Chart](../../mfc/hierarchy-chart.md)
-[COleDocument Class](../../mfc/reference/coledocument-class.md)
-[COleLinkingDoc Class](../../mfc/reference/colelinkingdoc-class.md)
+[MFC Sample HIERSVR](../../overview/visual-cpp-samples.md)\ +[COleLinkingDoc Class](../../mfc/reference/colelinkingdoc-class.md)\ +[Hierarchy Chart](../../mfc/hierarchy-chart.md)\ +[COleDocument Class](../../mfc/reference/coledocument-class.md)\ +[COleLinkingDoc Class](../../mfc/reference/colelinkingdoc-class.md)\ [COleTemplateServer Class](../../mfc/reference/coletemplateserver-class.md) diff --git a/docs/mfc/reference/colestreamfile-class.md b/docs/mfc/reference/colestreamfile-class.md index 053820436c5..964fe4e4dd8 100644 --- a/docs/mfc/reference/colestreamfile-class.md +++ b/docs/mfc/reference/colestreamfile-class.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: COleStreamFile Class" title: "COleStreamFile Class" +description: "Learn more about: COleStreamFile Class" ms.date: "11/04/2016" f1_keywords: ["COleStreamFile", "AFXOLE/COleStreamFile", "AFXOLE/COleStreamFile::COleStreamFile", "AFXOLE/COleStreamFile::Attach", "AFXOLE/COleStreamFile::CreateMemoryStream", "AFXOLE/COleStreamFile::CreateStream", "AFXOLE/COleStreamFile::Detach", "AFXOLE/COleStreamFile::GetStream", "AFXOLE/COleStreamFile::OpenStream"] helpviewer_keywords: ["COleStreamFile [MFC], COleStreamFile", "COleStreamFile [MFC], Attach", "COleStreamFile [MFC], CreateMemoryStream", "COleStreamFile [MFC], CreateStream", "COleStreamFile [MFC], Detach", "COleStreamFile [MFC], GetStream", "COleStreamFile [MFC], OpenStream"] -ms.assetid: e4f93698-e17c-4a18-a7c0-4b4df8eb4d93 --- # COleStreamFile Class @@ -41,7 +40,7 @@ An `IStorage` object must exist before the stream can be opened or created unles `COleStreamFile` objects are manipulated exactly like [CFile](../../mfc/reference/cfile-class.md) objects. -For more information about manipulating streams and storages, see the article [Containers: Compound Files](../../mfc/containers-compound-files.md).. +For more information about manipulating streams and storages, see the article [Containers: Compound Files](../../mfc/containers-compound-files.md). For more information, see [IStream](/windows/win32/api/objidl/nn-objidl-istream) and [IStorage](/windows/win32/api/objidl/nn-objidl-istorage) in the Windows SDK. @@ -222,5 +221,5 @@ For more information, see [IStorage::OpenStream](/windows/win32/api/objidl/nf-ob ## See also -[CFile Class](../../mfc/reference/cfile-class.md)
+[CFile Class](../../mfc/reference/cfile-class.md)\ [Hierarchy Chart](../../mfc/hierarchy-chart.md) diff --git a/docs/mfc/reference/coletemplateserver-class.md b/docs/mfc/reference/coletemplateserver-class.md index e497aa5a489..79a0b6e661b 100644 --- a/docs/mfc/reference/coletemplateserver-class.md +++ b/docs/mfc/reference/coletemplateserver-class.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: COleTemplateServer Class" title: "COleTemplateServer Class" -ms.date: "11/04/2016" +description: "Learn more about: COleTemplateServer Class" +ms.date: 11/04/2016 f1_keywords: ["COleTemplateServer", "AFXDISP/COleTemplateServer", "AFXDISP/COleTemplateServer::COleTemplateServer", "AFXDISP/COleTemplateServer::ConnectTemplate", "AFXDISP/COleTemplateServer::Unregister", "AFXDISP/COleTemplateServer::UpdateRegistry"] helpviewer_keywords: ["COleTemplateServer [MFC], COleTemplateServer", "COleTemplateServer [MFC], ConnectTemplate", "COleTemplateServer [MFC], Unregister", "COleTemplateServer [MFC], UpdateRegistry"] -ms.assetid: 47a2887d-8162-4993-a842-a784177c7f5c --- # COleTemplateServer Class @@ -104,10 +103,6 @@ BOOL Unregister(); TRUE if successful; otherwise FALSE. -### Remarks - -EnterRemarks - ## COleTemplateServer::UpdateRegistry Loads file-type information from the document-template string and places that information in the OLE system registry. diff --git a/docs/mfc/reference/colevariant-class.md b/docs/mfc/reference/colevariant-class.md index d3ac1cbba0e..f3bc198514a 100644 --- a/docs/mfc/reference/colevariant-class.md +++ b/docs/mfc/reference/colevariant-class.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: COleVariant Class" title: "COleVariant Class" -ms.date: "11/04/2016" +description: "Learn more about: COleVariant Class" +ms.date: 11/04/2016 f1_keywords: ["COleVariant", "AFXDISP/COleVariant", "AFXDISP/COleVariant::COleVariant", "AFXDISP/COleVariant::Attach", "AFXDISP/COleVariant::ChangeType", "AFXDISP/COleVariant::Clear", "AFXDISP/COleVariant::Detach", "AFXDISP/COleVariant::GetByteArrayFromVariantArray", "AFXDISP/COleVariant::SetString"] helpviewer_keywords: ["COleVariant [MFC], COleVariant", "COleVariant [MFC], Attach", "COleVariant [MFC], ChangeType", "COleVariant [MFC], Clear", "COleVariant [MFC], Detach", "COleVariant [MFC], GetByteArrayFromVariantArray", "COleVariant [MFC], SetString"] -ms.assetid: e1b5cd4a-b066-4b9b-b48b-6215ed52d998 --- # COleVariant Class @@ -52,7 +51,7 @@ This data type is used in OLE automation. Specifically, the [DISPPARAMS](/window > [!NOTE] > This class is derived from the `VARIANT` structure. This means you can pass a `COleVariant` in a parameter that calls for a `VARIANT` and that the data members of the `VARIANT` structure are accessible data members of `COleVariant`. -The two related MFC classes [COleCurrency](../../mfc/reference/colecurrency-class.md) and [COleDateTime](../../atl-mfc-shared/reference/coledatetime-class.md) encapsulate the variant data types CURRENCY ( `VT_CY`) and DATE ( `VT_DATE`). The `COleVariant` class is used extensively in the DAO classes; see these classes for typical usage of this class, for example [CDaoQueryDef](../../mfc/reference/cdaoquerydef-class.md) and [CDaoRecordset](../../mfc/reference/cdaorecordset-class.md). +The two related MFC classes [COleCurrency](../../mfc/reference/colecurrency-class.md) and [COleDateTime](../../atl-mfc-shared/reference/coledatetime-class.md) encapsulate the variant data types CURRENCY (`VT_CY`) and DATE (`VT_DATE`). The `COleVariant` class is used extensively in the DAO classes; see these classes for typical usage of this class, for example [CDaoQueryDef](../../mfc/reference/cdaoquerydef-class.md) and [CDaoRecordset](../../mfc/reference/cdaorecordset-class.md). For more information, see the [VARIANT](/windows/win32/api/oaidl/ns-oaidl-variant), [CURRENCY](/windows/win32/api/wtypes/ns-wtypes-cy-r1), [DISPPARAMS](/windows/win32/api/oaidl/ns-oaidl-dispparams), and [IDispatch::Invoke](/windows/win32/api/oaidl/nf-oaidl-idispatch-invoke) entries in the Windows SDK. diff --git a/docs/mfc/reference/collection-class-helpers.md b/docs/mfc/reference/collection-class-helpers.md index 4db46796895..ca02e0d281f 100644 --- a/docs/mfc/reference/collection-class-helpers.md +++ b/docs/mfc/reference/collection-class-helpers.md @@ -1,9 +1,8 @@ --- -description: "Learn more about: Collection Class Helpers" title: "Collection Class Helpers" -ms.date: "11/04/2016" +description: "Learn more about: Collection Class Helpers" +ms.date: 11/04/2016 helpviewer_keywords: ["DestructElements function", "ConstructElements function", "SerializeElements function", "collection classes [MFC], helper functions", "helper functions collection class [MFC]"] -ms.assetid: bc3a2368-9edd-4748-9e6a-13cba79517ca --- # Collection Class Helpers @@ -57,7 +56,7 @@ The `CMap` calls use the `CMap` template parameters *KEY* and *ARG_KEY*. The default implementation returns the result of the comparison of *\*pElement1* and *\*pElement2*. Override this function so that it compares the elements in a way that is appropriate for your application. -The C++ language defines the comparison operator ( `==`) for simple types (**`char`**, **`int`**, **`float`**, and so on) but does not define a comparison operator for classes and structures. If you want to use `CompareElements` or to instantiate one of the collection classes that uses it, you must either define the comparison operator or overload `CompareElements` with a version that returns appropriate values. +The C++ language defines the comparison operator (`==`) for simple types (**`char`**, **`int`**, **`float`**, and so on) but does not define a comparison operator for classes and structures. If you want to use `CompareElements` or to instantiate one of the collection classes that uses it, you must either define the comparison operator or overload `CompareElements` with a version that returns appropriate values. ### Requirements diff --git a/docs/mfc/reference/connection-maps.md b/docs/mfc/reference/connection-maps.md index cab71e32998..021a53eeade 100644 --- a/docs/mfc/reference/connection-maps.md +++ b/docs/mfc/reference/connection-maps.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: Connection Maps" title: "Connection Maps" -ms.date: "8/1/2023" +description: "Learn more about: Connection Maps" +ms.date: 8/1/2023 helpviewer_keywords: ["connection maps"] --- @@ -261,7 +261,7 @@ For in-process connections, `TRUE` indicates that creating the connection should **Warning**: In general, it can't be predicted which connections are in-process and which connections are out-of-process, so it is recommended to always set this parameter to `TRUE`. *`dwCookie`*\ -The connection identifier returned by ``AfxConnectionAdvise``. +The connection identifier returned by `AfxConnectionAdvise`. ### Return value diff --git a/docs/mfc/reference/cpane-class.md b/docs/mfc/reference/cpane-class.md index 9611f4835af..72daa26442a 100644 --- a/docs/mfc/reference/cpane-class.md +++ b/docs/mfc/reference/cpane-class.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: CPane Class" title: "CPane Class" -ms.date: "11/04/2016" +description: "Learn more about: CPane Class" +ms.date: 11/04/2016 f1_keywords: ["CPane", "AFXPANE/CPane", "AFXPANE/CPane::AdjustSizeImmediate", "AFXPANE/CPane::AllocElements", "AFXPANE/CPane::AllowShowOnPaneMenu", "AFXPANE/CPane::CalcAvailableSize", "AFXPANE/CPane::CalcInsideRect", "AFXPANE/CPane::CalcRecentDockedRect", "AFXPANE/CPane::CalcSize", "AFXPANE/CPane::CanBeDocked", "AFXPANE/CPane::CanBeTabbedDocument", "AFXPANE/CPane::ConvertToTabbedDocument", "AFXPANE/CPane::CopyState", "AFXPANE/CPane::Create", "AFXPANE/CPane::CreateDefaultMiniframe", "AFXPANE/CPane::CreateEx", "AFXPANE/CPane::DockByMouse", "AFXPANE/CPane::DockPane", "AFXPANE/CPane::DockPaneStandard", "AFXPANE/CPane::DockToFrameWindow", "AFXPANE/CPane::DoesAllowSiblingBars", "AFXPANE/CPane::FloatPane", "AFXPANE/CPane::GetAvailableExpandSize", "AFXPANE/CPane::GetAvailableStretchSize", "AFXPANE/CPane::GetBorders", "AFXPANE/CPane::GetClientHotSpot", "AFXPANE/CPane::GetDockSiteRow", "AFXPANE/CPane::GetExclusiveRowMode", "AFXPANE/CPane::GetHotSpot", "AFXPANE/CPane::GetMinSize", "AFXPANE/CPane::GetPaneName", "AFXPANE/CPane::GetVirtualRect", "AFXPANE/CPane::IsChangeState", "AFXPANE/CPane::IsDragMode", "AFXPANE/CPane::IsInFloatingMultiPaneFrameWnd", "AFXPANE/CPane::IsLeftOf", "AFXPANE/CPane::IsResizable", "AFXPANE/CPane::IsTabbed", "AFXPANE/CPane::LoadState", "AFXPANE/CPane::MoveByAlignment", "AFXPANE/CPane::MovePane", "AFXPANE/CPane::OnAfterChangeParent", "AFXPANE/CPane::OnBeforeChangeParent", "AFXPANE/CPane::OnPressCloseButton", "AFXPANE/CPane::OnShowControlBarMenu", "AFXPANE/CPane::RecalcLayout", "AFXPANE/CPane::SaveState", "AFXPANE/CPane::SetActiveInGroup", "AFXPANE/CPane::SetBorders", "AFXPANE/CPane::SetClientHotSpot", "AFXPANE/CPane::SetDockState", "AFXPANE/CPane::SetExclusiveRowMode", "AFXPANE/CPane::SetMiniFrameRTC", "AFXPANE/CPane::SetMinSize", "AFXPANE/CPane::SetVirtualRect", "AFXPANE/CPane::StretchPaneDeferWndPos", "AFXPANE/CPane::ToggleAutoHide", "AFXPANE/CPane::UndockPane", "AFXPANE/CPane::UpdateVirtualRect", "AFXPANE/CPane::OnAfterDock", "AFXPANE/CPane::OnAfterFloat", "AFXPANE/CPane::OnBeforeDock", "AFXPANE/CPane::OnBeforeFloat", "AFXPANE/CPane::m_bHandleMinSize", "AFXPANE/CPane::m_recentDockInfo"] helpviewer_keywords: ["CPane [MFC], AdjustSizeImmediate", "CPane [MFC], AllocElements", "CPane [MFC], AllowShowOnPaneMenu", "CPane [MFC], CalcAvailableSize", "CPane [MFC], CalcInsideRect", "CPane [MFC], CalcRecentDockedRect", "CPane [MFC], CalcSize", "CPane [MFC], CanBeDocked", "CPane [MFC], CanBeTabbedDocument", "CPane [MFC], ConvertToTabbedDocument", "CPane [MFC], CopyState", "CPane [MFC], Create", "CPane [MFC], CreateDefaultMiniframe", "CPane [MFC], CreateEx", "CPane [MFC], DockByMouse", "CPane [MFC], DockPane", "CPane [MFC], DockPaneStandard", "CPane [MFC], DockToFrameWindow", "CPane [MFC], DoesAllowSiblingBars", "CPane [MFC], FloatPane", "CPane [MFC], GetAvailableExpandSize", "CPane [MFC], GetAvailableStretchSize", "CPane [MFC], GetBorders", "CPane [MFC], GetClientHotSpot", "CPane [MFC], GetDockSiteRow", "CPane [MFC], GetExclusiveRowMode", "CPane [MFC], GetHotSpot", "CPane [MFC], GetMinSize", "CPane [MFC], GetPaneName", "CPane [MFC], GetVirtualRect", "CPane [MFC], IsChangeState", "CPane [MFC], IsDragMode", "CPane [MFC], IsInFloatingMultiPaneFrameWnd", "CPane [MFC], IsLeftOf", "CPane [MFC], IsResizable", "CPane [MFC], IsTabbed", "CPane [MFC], LoadState", "CPane [MFC], MoveByAlignment", "CPane [MFC], MovePane", "CPane [MFC], OnAfterChangeParent", "CPane [MFC], OnBeforeChangeParent", "CPane [MFC], OnPressCloseButton", "CPane [MFC], OnShowControlBarMenu", "CPane [MFC], OnShowControlBarMenu", "CPane [MFC], RecalcLayout", "CPane [MFC], SaveState", "CPane [MFC], SetActiveInGroup", "CPane [MFC], SetBorders", "CPane [MFC], SetClientHotSpot", "CPane [MFC], SetDockState", "CPane [MFC], SetExclusiveRowMode", "CPane [MFC], SetMiniFrameRTC", "CPane [MFC], SetMinSize", "CPane [MFC], SetVirtualRect", "CPane [MFC], StretchPaneDeferWndPos", "CPane [MFC], ToggleAutoHide", "CPane [MFC], UndockPane", "CPane [MFC], UpdateVirtualRect", "CPane [MFC], OnAfterDock", "CPane [MFC], OnAfterFloat", "CPane [MFC], OnBeforeDock", "CPane [MFC], OnBeforeFloat", "CPane [MFC], m_bHandleMinSize", "CPane [MFC], m_recentDockInfo"] -ms.assetid: 5c651a64-3c79-4d94-9676-45f6402a6bc5 --- # CPane Class @@ -75,7 +74,6 @@ class CPane : public CBasePane |[CPane::OnPressCloseButton](#onpressclosebutton)|Called by the framework when the user chooses the Close button on the caption for the pane.| |`CPane::OnProcessDblClk`|Used internally.| |[CPane::OnShowControlBarMenu](#onshowcontrolbarmenu)|Called by the framework when a special pane menu is about to be displayed.| -|[CPane::OnShowControlBarMenu](#onshowcontrolbarmenu)|Called by the framework when a special pane menu is about to be displayed.| |`CPane::PrepareToDock`|Used internally.| |[CPane::RecalcLayout](#recalclayout)|Recalculates layout information for the pane. (Overrides [CBasePane::RecalcLayout](../../mfc/reference/cbasepane-class.md#recalclayout).)| |[CPane::SaveState](#savestate)|Saves the state of the pane to the registry. (Overrides [CBasePane::SaveState](../../mfc/reference/cbasepane-class.md#savestate).)| diff --git a/docs/mfc/reference/creating-a-forms-based-mfc-application.md b/docs/mfc/reference/creating-a-forms-based-mfc-application.md index 9ef2409ba6b..1378686ea70 100644 --- a/docs/mfc/reference/creating-a-forms-based-mfc-application.md +++ b/docs/mfc/reference/creating-a-forms-based-mfc-application.md @@ -24,7 +24,7 @@ The base class for form-based applications is [`CFormView`](cformview-class.md). Even if you use a base class such as [`CView`](cview-class.md), you can later make your applications forms-based by [adding an MFC class](adding-an-mfc-class.md) derived from `CFormView`. -Once you finish with the wizard, your project opens, and if you selected `CFormView` (or a class that inherits from `CFormView`) as your base class or if you created a dialog-based application, Visual C++ opens the dialog editor. At this point, you are ready to design your first form. +Once you finish with the wizard, your project opens, and if you selected `CFormView` (or a class that inherits from `CFormView`) as your base class or if you created a dialog-based application, Visual Studio opens the dialog editor. At this point, you are ready to design your first form. ### To begin creating a forms-based MFC executable diff --git a/docs/mfc/reference/creating-a-web-browser-style-mfc-application.md b/docs/mfc/reference/creating-a-web-browser-style-mfc-application.md index 06aa373199c..ab5e862682c 100644 --- a/docs/mfc/reference/creating-a-web-browser-style-mfc-application.md +++ b/docs/mfc/reference/creating-a-web-browser-style-mfc-application.md @@ -28,7 +28,7 @@ The WebBrowser control supports Web browsing through hyperlinks and Uniform Reso Because `CHtmlView` simply implements the Microsoft Web browser control, its support for printing isn't like other [`CView`](../../mfc/reference/cview-class.md)-derived classes. Rather, the WebBrowser control implements the printer user interface and printing. As a result, `CHtmlView` doesn't support print preview, and the framework doesn't provide for other printing support functions: for example, [`CView::OnPreparePrinting`](../../mfc/reference/cview-class.md#onprepareprinting), [`CView::OnBeginPrinting`](../../mfc/reference/cview-class.md#onbeginprinting), and [`CView::OnEndPrinting`](../../mfc/reference/cview-class.md#onendprinting), which are available in other MFC applications. -`CHtmlView` acts as a wrapper for the Web browser control, which gives your application a view onto a Web or an HTML page. The wizard creates an override to the [`OnInitialUpdate`](../../mfc/reference/cview-class.md#oninitialupdate) function in the view class, providing a navigational link to the Microsoft Visual C++ Web site: +`CHtmlView` acts as a wrapper for the Web browser control, which gives your application a view onto a Web or an HTML page. The wizard creates an override to the [`OnInitialUpdate`](../../mfc/reference/cview-class.md#oninitialupdate) function in the view class, providing a navigational link to the Visual Studio Web site: ```cpp void CWebView::OnInitialUpdate() diff --git a/docs/mfc/reference/creating-an-mfc-application.md b/docs/mfc/reference/creating-an-mfc-application.md index 5a981ca05ca..6d366fb7b8a 100644 --- a/docs/mfc/reference/creating-an-mfc-application.md +++ b/docs/mfc/reference/creating-an-mfc-application.md @@ -56,7 +56,7 @@ The dialog shows the application type, set to Console Application (.exe). Under ## To create an MFC forms or dialog-based application 1. From the Visual Studio main menu, choose **File** > **New** > **Project**. -1. Under the **Installed** templates, choose **Visual C++** > **MFC/ATL**. If you don't see these, use the Visual Studio Installer to add MFC/ATL functionality. You can access the installer from the Visual Studio menu via **Tools** > **Get Tools and Features...** In the installer, select **Individual components** and search for **mfc** and then select the appropriate library for your machine such as **Visual C++ MFC for x86 and x64 with Spectre Mitigations**. +1. Under the **Installed** templates, choose **Visual C++** > **MFC/ATL**. If you don't see these, use the Visual Studio Installer to add MFC/ATL functionality. You can access the installer from the Visual Studio menu via **Tools** > **Get Tools and Features...** In the installer, select **Individual components** and search for **mfc** and then select the appropriate library for your machine such as **C++ MFC for x86 and x64 with Spectre Mitigations**. 1. Choose **MFC App** from the center pane. 1. Modify the configuration values as needed, then press **OK**. diff --git a/docs/mfc/reference/crebarctrl-class.md b/docs/mfc/reference/crebarctrl-class.md index 5dc690832f0..7d66ed8b7f6 100644 --- a/docs/mfc/reference/crebarctrl-class.md +++ b/docs/mfc/reference/crebarctrl-class.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: CReBarCtrl Class" title: "CReBarCtrl Class" -ms.date: "11/19/2018" +description: "Learn more about: CReBarCtrl Class" +ms.date: 11/19/2018 f1_keywords: ["CReBarCtrl", "AFXCMN/CReBarCtrl", "AFXCMN/CReBarCtrl::CReBarCtrl", "AFXCMN/CReBarCtrl::BeginDrag", "AFXCMN/CReBarCtrl::Create", "AFXCMN/CReBarCtrl::CreateEx", "AFXCMN/CReBarCtrl::DeleteBand", "AFXCMN/CReBarCtrl::DragMove", "AFXCMN/CReBarCtrl::EndDrag", "AFXCMN/CReBarCtrl::GetBandBorders", "AFXCMN/CReBarCtrl::GetBandCount", "AFXCMN/CReBarCtrl::GetBandInfo", "AFXCMN/CReBarCtrl::GetBandMargins", "AFXCMN/CReBarCtrl::GetBarHeight", "AFXCMN/CReBarCtrl::GetBarInfo", "AFXCMN/CReBarCtrl::GetBkColor", "AFXCMN/CReBarCtrl::GetColorScheme", "AFXCMN/CReBarCtrl::GetDropTarget", "AFXCMN/CReBarCtrl::GetExtendedStyle", "AFXCMN/CReBarCtrl::GetImageList", "AFXCMN/CReBarCtrl::GetPalette", "AFXCMN/CReBarCtrl::GetRect", "AFXCMN/CReBarCtrl::GetRowCount", "AFXCMN/CReBarCtrl::GetRowHeight", "AFXCMN/CReBarCtrl::GetTextColor", "AFXCMN/CReBarCtrl::GetToolTips", "AFXCMN/CReBarCtrl::HitTest", "AFXCMN/CReBarCtrl::IDToIndex", "AFXCMN/CReBarCtrl::InsertBand", "AFXCMN/CReBarCtrl::MaximizeBand", "AFXCMN/CReBarCtrl::MinimizeBand", "AFXCMN/CReBarCtrl::MoveBand", "AFXCMN/CReBarCtrl::PushChevron", "AFXCMN/CReBarCtrl::RestoreBand", "AFXCMN/CReBarCtrl::SetBandInfo", "AFXCMN/CReBarCtrl::SetBandWidth", "AFXCMN/CReBarCtrl::SetBarInfo", "AFXCMN/CReBarCtrl::SetBkColor", "AFXCMN/CReBarCtrl::SetColorScheme", "AFXCMN/CReBarCtrl::SetExtendedStyle", "AFXCMN/CReBarCtrl::SetImageList", "AFXCMN/CReBarCtrl::SetOwner", "AFXCMN/CReBarCtrl::SetPalette", "AFXCMN/CReBarCtrl::SetTextColor", "AFXCMN/CReBarCtrl::SetToolTips", "AFXCMN/CReBarCtrl::SetWindowTheme", "AFXCMN/CReBarCtrl::ShowBand", "AFXCMN/CReBarCtrl::SizeToRect"] helpviewer_keywords: ["CReBarCtrl [MFC], CReBarCtrl", "CReBarCtrl [MFC], BeginDrag", "CReBarCtrl [MFC], Create", "CReBarCtrl [MFC], CreateEx", "CReBarCtrl [MFC], DeleteBand", "CReBarCtrl [MFC], DragMove", "CReBarCtrl [MFC], EndDrag", "CReBarCtrl [MFC], GetBandBorders", "CReBarCtrl [MFC], GetBandCount", "CReBarCtrl [MFC], GetBandInfo", "CReBarCtrl [MFC], GetBandMargins", "CReBarCtrl [MFC], GetBarHeight", "CReBarCtrl [MFC], GetBarInfo", "CReBarCtrl [MFC], GetBkColor", "CReBarCtrl [MFC], GetColorScheme", "CReBarCtrl [MFC], GetDropTarget", "CReBarCtrl [MFC], GetExtendedStyle", "CReBarCtrl [MFC], GetImageList", "CReBarCtrl [MFC], GetPalette", "CReBarCtrl [MFC], GetRect", "CReBarCtrl [MFC], GetRowCount", "CReBarCtrl [MFC], GetRowHeight", "CReBarCtrl [MFC], GetTextColor", "CReBarCtrl [MFC], GetToolTips", "CReBarCtrl [MFC], HitTest", "CReBarCtrl [MFC], IDToIndex", "CReBarCtrl [MFC], InsertBand", "CReBarCtrl [MFC], MaximizeBand", "CReBarCtrl [MFC], MinimizeBand", "CReBarCtrl [MFC], MoveBand", "CReBarCtrl [MFC], PushChevron", "CReBarCtrl [MFC], RestoreBand", "CReBarCtrl [MFC], SetBandInfo", "CReBarCtrl [MFC], SetBandWidth", "CReBarCtrl [MFC], SetBarInfo", "CReBarCtrl [MFC], SetBkColor", "CReBarCtrl [MFC], SetColorScheme", "CReBarCtrl [MFC], SetExtendedStyle", "CReBarCtrl [MFC], SetImageList", "CReBarCtrl [MFC], SetOwner", "CReBarCtrl [MFC], SetPalette", "CReBarCtrl [MFC], SetTextColor", "CReBarCtrl [MFC], SetToolTips", "CReBarCtrl [MFC], SetWindowTheme", "CReBarCtrl [MFC], ShowBand", "CReBarCtrl [MFC], SizeToRect"] -ms.assetid: 154570d7-e48c-425d-8c7e-c64542bcb4cc --- # CReBarCtrl Class @@ -337,7 +336,7 @@ void GetBandMargins(PMARGINS pMargins); ### Parameters *pMargins*
-A pointer to a [MARGINS](/windows/win32/api/uxtheme/ns-uxtheme-margins)structure that will receive the information. +A pointer to a [MARGINS](/windows/win32/api/uxtheme/ns-uxtheme-margins) structure that will receive the information. ### Remarks diff --git a/docs/mfc/reference/crecordset-class.md b/docs/mfc/reference/crecordset-class.md index 0f955069ad0..ec14c8d5d1e 100644 --- a/docs/mfc/reference/crecordset-class.md +++ b/docs/mfc/reference/crecordset-class.md @@ -728,7 +728,7 @@ The number of records in the recordset; 0 if the recordset contains no records; ### Remarks > [!CAUTION] -> The record count is maintained as a "high water mark," the highest-numbered record yet seen as the user moves through the records. The total number of records is only known after the user has moved beyond the last record. For performance reasons, the count isn't updated when you call `MoveLast`. To count the records yourself, call `MoveNext` repeatedly until `IsEOF` returns nonzero. Adding a record via `CRecordset:AddNew` and `Update` increases the count; deleting a record via `CRecordset::Delete` decreases the count. +> The record count is maintained as a "high water mark," the highest-numbered record yet seen as the user moves through the records. The total number of records is only known after the user has moved beyond the last record. For performance reasons, the count isn't updated when you call `MoveLast`. To count the records yourself, call `MoveNext` repeatedly until `IsEOF` returns nonzero. Adding a record via `CRecordset::AddNew` and `Update` increases the count; deleting a record via `CRecordset::Delete` decreases the count. ## `CRecordset::GetRowsetSize` @@ -1403,7 +1403,7 @@ Accept the default value, `AFX_DB_USE_DEFAULT_TYPE`, or use one of the following - `CRecordset::forwardOnly` A read-only recordset with only forward scrolling. - For `CRecordset`, the default value is `CRecordset::snapshot`. The default-value mechanism allows the Visual C++ wizards to interact with both ODBC `CRecordset` and DAO `CDaoRecordset`, which have different defaults. + For `CRecordset`, the default value is `CRecordset::snapshot`. The default-value mechanism allows the Visual Studio wizards to interact with both ODBC `CRecordset` and DAO `CDaoRecordset`, which have different defaults. For more information about these recordset types, see [Recordset (ODBC)](../../data/odbc/recordset-odbc.md). For related information, see "Using Block and Scrollable Cursors" in the Windows SDK. diff --git a/docs/mfc/reference/crgn-class.md b/docs/mfc/reference/crgn-class.md index 3e1cf67d0b7..6568c4df1c5 100644 --- a/docs/mfc/reference/crgn-class.md +++ b/docs/mfc/reference/crgn-class.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: CRgn Class" title: "CRgn Class" -ms.date: "11/04/2016" +description: "Learn more about: CRgn Class" +ms.date: 11/04/2016 f1_keywords: ["CRgn", "AFXWIN/CRgn", "AFXWIN/CRgn::CRgn", "AFXWIN/CRgn::CombineRgn", "AFXWIN/CRgn::CopyRgn", "AFXWIN/CRgn::CreateEllipticRgn", "AFXWIN/CRgn::CreateEllipticRgnIndirect", "AFXWIN/CRgn::CreateFromData", "AFXWIN/CRgn::CreateFromPath", "AFXWIN/CRgn::CreatePolygonRgn", "AFXWIN/CRgn::CreatePolyPolygonRgn", "AFXWIN/CRgn::CreateRectRgn", "AFXWIN/CRgn::CreateRectRgnIndirect", "AFXWIN/CRgn::CreateRoundRectRgn", "AFXWIN/CRgn::EqualRgn", "AFXWIN/CRgn::FromHandle", "AFXWIN/CRgn::GetRegionData", "AFXWIN/CRgn::GetRgnBox", "AFXWIN/CRgn::OffsetRgn", "AFXWIN/CRgn::PtInRegion", "AFXWIN/CRgn::RectInRegion", "AFXWIN/CRgn::SetRectRgn"] helpviewer_keywords: ["CRgn [MFC], CRgn", "CRgn [MFC], CombineRgn", "CRgn [MFC], CopyRgn", "CRgn [MFC], CreateEllipticRgn", "CRgn [MFC], CreateEllipticRgnIndirect", "CRgn [MFC], CreateFromData", "CRgn [MFC], CreateFromPath", "CRgn [MFC], CreatePolygonRgn", "CRgn [MFC], CreatePolyPolygonRgn", "CRgn [MFC], CreateRectRgn", "CRgn [MFC], CreateRectRgnIndirect", "CRgn [MFC], CreateRoundRectRgn", "CRgn [MFC], EqualRgn", "CRgn [MFC], FromHandle", "CRgn [MFC], GetRegionData", "CRgn [MFC], GetRgnBox", "CRgn [MFC], OffsetRgn", "CRgn [MFC], PtInRegion", "CRgn [MFC], RectInRegion", "CRgn [MFC], SetRectRgn"] -ms.assetid: d904da84-76aa-481e-8780-b09485f49e64 --- # CRgn Class @@ -37,7 +36,7 @@ class CRgn : public CGdiObject |[CRgn::CreatePolygonRgn](#createpolygonrgn)|Initializes a `CRgn` object with a polygonal region. The system closes the polygon automatically, if necessary, by drawing a line from the last vertex to the first.| |[CRgn::CreatePolyPolygonRgn](#createpolypolygonrgn)|Initializes a `CRgn` object with a region consisting of a series of closed polygons. The polygons may be disjoint, or they may overlap.| |[CRgn::CreateRectRgn](#createrectrgn)|Initializes a `CRgn` object with a rectangular region.| -|[CRgn::CreateRectRgnIndirect](#createrectrgnindirect)|Initializes a `CRgn` object with a rectangular region defined by a [RECT](/windows/win32/api/windef/ns-windef-rect)tructure.| +|[CRgn::CreateRectRgnIndirect](#createrectrgnindirect)|Initializes a `CRgn` object with a rectangular region defined by a [RECT](/windows/win32/api/windef/ns-windef-rect) structure.| |[CRgn::CreateRoundRectRgn](#createroundrectrgn)|Initializes a `CRgn` object with a rectangular region with rounded corners.| |[CRgn::EqualRgn](#equalrgn)|Checks two `CRgn` objects to determine whether they are equivalent.| |[CRgn::FromHandle](#fromhandle)|Returns a pointer to a `CRgn` object when given a handle to a Windows region.| @@ -250,7 +249,7 @@ BOOL CreateFromData( ### Parameters *lpXForm*
-Points to an [XFORM](/windows/win32/api/wingdi/ns-wingdi-xform)ata structure that defines the transformation to be performed on the region. If this pointer is NULL, the identity transformation is used. +Points to an [XFORM](/windows/win32/api/wingdi/ns-wingdi-xform) data structure that defines the transformation to be performed on the region. If this pointer is NULL, the identity transformation is used. *nCount*
Specifies the number of bytes pointed to by *pRgnData*. @@ -610,17 +609,14 @@ int GetRgnBox(LPRECT lpRect) const; *lpRect*
Points to a `RECT` structure or `CRect` object to receive the coordinates of the bounding rectangle. The `RECT` structure has the following form: -`typedef struct tagRECT {` - -`int left;` - -`int top;` - -`int right;` - -`int bottom;` - -`} RECT;` +```cpp +typedef struct tagRECT { + int left; + int top; + int right; + int bottom; +} RECT; +``` ### Return Value diff --git a/docs/mfc/reference/cricheditctrl-class.md b/docs/mfc/reference/cricheditctrl-class.md index 95466b4037c..146d92aecf4 100644 --- a/docs/mfc/reference/cricheditctrl-class.md +++ b/docs/mfc/reference/cricheditctrl-class.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: CRichEditCtrl Class" title: "CRichEditCtrl Class" -ms.date: "11/04/2016" +description: "Learn more about: CRichEditCtrl Class" +ms.date: 11/04/2016 f1_keywords: ["CRichEditCtrl", "AFXCMN/CRichEditCtrl", "AFXCMN/CRichEditCtrl::CRichEditCtrl", "AFXCMN/CRichEditCtrl::CanPaste", "AFXCMN/CRichEditCtrl::CanRedo", "AFXCMN/CRichEditCtrl::CanUndo", "AFXCMN/CRichEditCtrl::CharFromPos", "AFXCMN/CRichEditCtrl::Clear", "AFXCMN/CRichEditCtrl::Copy", "AFXCMN/CRichEditCtrl::Create", "AFXCMN/CRichEditCtrl::CreateEx", "AFXCMN/CRichEditCtrl::Cut", "AFXCMN/CRichEditCtrl::DisplayBand", "AFXCMN/CRichEditCtrl::EmptyUndoBuffer", "AFXCMN/CRichEditCtrl::FindText", "AFXCMN/CRichEditCtrl::FindWordBreak", "AFXCMN/CRichEditCtrl::FormatRange", "AFXCMN/CRichEditCtrl::GetCharPos", "AFXCMN/CRichEditCtrl::GetDefaultCharFormat", "AFXCMN/CRichEditCtrl::GetEventMask", "AFXCMN/CRichEditCtrl::GetFirstVisibleLine", "AFXCMN/CRichEditCtrl::GetIRichEditOle", "AFXCMN/CRichEditCtrl::GetLimitText", "AFXCMN/CRichEditCtrl::GetLine", "AFXCMN/CRichEditCtrl::GetLineCount", "AFXCMN/CRichEditCtrl::GetModify", "AFXCMN/CRichEditCtrl::GetOptions", "AFXCMN/CRichEditCtrl::GetParaFormat", "AFXCMN/CRichEditCtrl::GetPunctuation", "AFXCMN/CRichEditCtrl::GetRect", "AFXCMN/CRichEditCtrl::GetRedoName", "AFXCMN/CRichEditCtrl::GetSel", "AFXCMN/CRichEditCtrl::GetSelectionCharFormat", "AFXCMN/CRichEditCtrl::GetSelectionType", "AFXCMN/CRichEditCtrl::GetSelText", "AFXCMN/CRichEditCtrl::GetTextLength", "AFXCMN/CRichEditCtrl::GetTextLengthEx", "AFXCMN/CRichEditCtrl::GetTextMode", "AFXCMN/CRichEditCtrl::GetTextRange", "AFXCMN/CRichEditCtrl::GetUndoName", "AFXCMN/CRichEditCtrl::GetWordWrapMode", "AFXCMN/CRichEditCtrl::HideSelection", "AFXCMN/CRichEditCtrl::LimitText", "AFXCMN/CRichEditCtrl::LineFromChar", "AFXCMN/CRichEditCtrl::LineIndex", "AFXCMN/CRichEditCtrl::LineLength", "AFXCMN/CRichEditCtrl::LineScroll", "AFXCMN/CRichEditCtrl::Paste", "AFXCMN/CRichEditCtrl::PasteSpecial", "AFXCMN/CRichEditCtrl::PosFromChar", "AFXCMN/CRichEditCtrl::Redo", "AFXCMN/CRichEditCtrl::ReplaceSel", "AFXCMN/CRichEditCtrl::RequestResize", "AFXCMN/CRichEditCtrl::SetAutoURLDetect", "AFXCMN/CRichEditCtrl::SetBackgroundColor", "AFXCMN/CRichEditCtrl::SetDefaultCharFormat", "AFXCMN/CRichEditCtrl::SetEventMask", "AFXCMN/CRichEditCtrl::SetModify", "AFXCMN/CRichEditCtrl::SetOLECallback", "AFXCMN/CRichEditCtrl::SetOptions", "AFXCMN/CRichEditCtrl::SetParaFormat", "AFXCMN/CRichEditCtrl::SetPunctuation", "AFXCMN/CRichEditCtrl::SetReadOnly", "AFXCMN/CRichEditCtrl::SetRect", "AFXCMN/CRichEditCtrl::SetSel", "AFXCMN/CRichEditCtrl::SetSelectionCharFormat", "AFXCMN/CRichEditCtrl::SetTargetDevice", "AFXCMN/CRichEditCtrl::SetTextMode", "AFXCMN/CRichEditCtrl::SetUndoLimit", "AFXCMN/CRichEditCtrl::SetWordCharFormat", "AFXCMN/CRichEditCtrl::SetWordWrapMode", "AFXCMN/CRichEditCtrl::StopGroupTyping", "AFXCMN/CRichEditCtrl::StreamIn", "AFXCMN/CRichEditCtrl::StreamOut", "AFXCMN/CRichEditCtrl::Undo"] helpviewer_keywords: ["CRichEditCtrl [MFC], CRichEditCtrl", "CRichEditCtrl [MFC], CanPaste", "CRichEditCtrl [MFC], CanRedo", "CRichEditCtrl [MFC], CanUndo", "CRichEditCtrl [MFC], CharFromPos", "CRichEditCtrl [MFC], Clear", "CRichEditCtrl [MFC], Copy", "CRichEditCtrl [MFC], Create", "CRichEditCtrl [MFC], CreateEx", "CRichEditCtrl [MFC], Cut", "CRichEditCtrl [MFC], DisplayBand", "CRichEditCtrl [MFC], EmptyUndoBuffer", "CRichEditCtrl [MFC], FindText", "CRichEditCtrl [MFC], FindWordBreak", "CRichEditCtrl [MFC], FormatRange", "CRichEditCtrl [MFC], GetCharPos", "CRichEditCtrl [MFC], GetDefaultCharFormat", "CRichEditCtrl [MFC], GetEventMask", "CRichEditCtrl [MFC], GetFirstVisibleLine", "CRichEditCtrl [MFC], GetIRichEditOle", "CRichEditCtrl [MFC], GetLimitText", "CRichEditCtrl [MFC], GetLine", "CRichEditCtrl [MFC], GetLineCount", "CRichEditCtrl [MFC], GetModify", "CRichEditCtrl [MFC], GetOptions", "CRichEditCtrl [MFC], GetParaFormat", "CRichEditCtrl [MFC], GetPunctuation", "CRichEditCtrl [MFC], GetRect", "CRichEditCtrl [MFC], GetRedoName", "CRichEditCtrl [MFC], GetSel", "CRichEditCtrl [MFC], GetSelectionCharFormat", "CRichEditCtrl [MFC], GetSelectionType", "CRichEditCtrl [MFC], GetSelText", "CRichEditCtrl [MFC], GetTextLength", "CRichEditCtrl [MFC], GetTextLengthEx", "CRichEditCtrl [MFC], GetTextMode", "CRichEditCtrl [MFC], GetTextRange", "CRichEditCtrl [MFC], GetUndoName", "CRichEditCtrl [MFC], GetWordWrapMode", "CRichEditCtrl [MFC], HideSelection", "CRichEditCtrl [MFC], LimitText", "CRichEditCtrl [MFC], LineFromChar", "CRichEditCtrl [MFC], LineIndex", "CRichEditCtrl [MFC], LineLength", "CRichEditCtrl [MFC], LineScroll", "CRichEditCtrl [MFC], Paste", "CRichEditCtrl [MFC], PasteSpecial", "CRichEditCtrl [MFC], PosFromChar", "CRichEditCtrl [MFC], Redo", "CRichEditCtrl [MFC], ReplaceSel", "CRichEditCtrl [MFC], RequestResize", "CRichEditCtrl [MFC], SetAutoURLDetect", "CRichEditCtrl [MFC], SetBackgroundColor", "CRichEditCtrl [MFC], SetDefaultCharFormat", "CRichEditCtrl [MFC], SetEventMask", "CRichEditCtrl [MFC], SetModify", "CRichEditCtrl [MFC], SetOLECallback", "CRichEditCtrl [MFC], SetOptions", "CRichEditCtrl [MFC], SetParaFormat", "CRichEditCtrl [MFC], SetPunctuation", "CRichEditCtrl [MFC], SetReadOnly", "CRichEditCtrl [MFC], SetRect", "CRichEditCtrl [MFC], SetSel", "CRichEditCtrl [MFC], SetSelectionCharFormat", "CRichEditCtrl [MFC], SetTargetDevice", "CRichEditCtrl [MFC], SetTextMode", "CRichEditCtrl [MFC], SetUndoLimit", "CRichEditCtrl [MFC], SetWordCharFormat", "CRichEditCtrl [MFC], SetWordWrapMode", "CRichEditCtrl [MFC], StopGroupTyping", "CRichEditCtrl [MFC], StreamIn", "CRichEditCtrl [MFC], StreamOut", "CRichEditCtrl [MFC], Undo"] -ms.assetid: 2be52788-822c-4c27-aafd-2471231e74eb --- # `CRichEditCtrl` Class @@ -553,7 +552,8 @@ For more information, see [`EM_POSFROMCHAR`](/windows/win32/Controls/em-posfromc Gets the default character formatting attributes of this `CRichEditCtrl` object. ``` -DWORD GetDefaultCharFormat(CHARFORMAT& cf) const; DWORD GetDefaultCharFormat(CHARFORMAT2& cf) const; +DWORD GetDefaultCharFormat(CHARFORMAT& cf) const; +DWORD GetDefaultCharFormat(CHARFORMAT2& cf) const; ``` ### Parameters @@ -759,7 +759,8 @@ A combination of the current option flag values. For a list of these values, see Gets the paragraph formatting attributes of the current selection. ``` -DWORD GetParaFormat(PARAFORMAT& pf) const; DWORD GetParaFormat(PARAFORMAT2& pf) const; +DWORD GetParaFormat(PARAFORMAT& pf) const; +DWORD GetParaFormat(PARAFORMAT2& pf) const; ``` ### Parameters @@ -892,7 +893,8 @@ For more information, see [`EM_EXGETSEL`](/windows/win32/Controls/em-exgetsel) m Gets the character formatting attributes of the current selection. ``` -DWORD GetSelectionCharFormat(CHARFORMAT& cf) const; DWORD GetSelectionCharFormat(CHARFORMAT2& cf) const; +DWORD GetSelectionCharFormat(CHARFORMAT& cf) const; +DWORD GetSelectionCharFormat(CHARFORMAT2& cf) const; ``` ### Parameters @@ -951,7 +953,8 @@ For more information, see [`EM_SELECTIONTYPE`](/windows/win32/Controls/em-select Retrieves the text from the current selection in this `CRichEditCtrl` object. ``` -long GetSelText(LPSTR lpBuf) const; CString GetSelText() const; +long GetSelText(LPSTR lpBuf) const; +CString GetSelText() const; ``` ### Parameters diff --git a/docs/mfc/reference/csemaphore-class.md b/docs/mfc/reference/csemaphore-class.md index fce78fae489..a31a4590ab9 100644 --- a/docs/mfc/reference/csemaphore-class.md +++ b/docs/mfc/reference/csemaphore-class.md @@ -4,15 +4,14 @@ title: "CSemaphore Class" ms.date: "11/04/2016" f1_keywords: ["CSemaphore", "AFXMT/CSemaphore", "AFXMT/CSemaphore::CSemaphore"] helpviewer_keywords: ["CSemaphore [MFC], CSemaphore"] -ms.assetid: 385fc7e4-8f86-4be2-85e1-d23b38c12f7f --- # CSemaphore Class -An object of class `CSemaphore` represents a "semaphore" — a synchronization object that allows a limited number of threads in one or more processes to access a Maintains a count of the number of threads currently accessing a specified resource. +An object of class `CSemaphore` represents a "semaphore". A semaphore is a synchronization object that controls access to shared resources and prevents race conditions. ## Syntax -``` +```cpp class CSemaphore : public CSyncObject ``` @@ -22,17 +21,17 @@ class CSemaphore : public CSyncObject |Name|Description| |----------|-----------------| -|[CSemaphore::CSemaphore](#csemaphore)|Constructs a `CSemaphore` object.| +|[`CSemaphore::CSemaphore`](#csemaphore)|Constructs a `CSemaphore` object.| ## Remarks -Semaphores are useful in controlling access to a shared resource that can only support a limited number of users. The current count of the `CSemaphore` object is the number of additional users allowed. When the count reaches zero, all attempts to use the resource controlled by the `CSemaphore` object will be inserted into a system queue and wait until they either time out or the count rises above 0. The maximum number of users who can access the controlled resource at one time is specified during construction of the `CSemaphore` object. +Semaphores are useful in controlling access to a shared resource that can only support a limited number of users. The current count of the `CSemaphore` object is the number of other users allowed. When the count reaches zero, all attempts to use the resource controlled by the `CSemaphore` object are inserted into a system queue and wait until they either time out, or the count rises above 0. The maximum number of users who can access the controlled resource at one time is specified during construction of the `CSemaphore` object. -To use a `CSemaphore` object, construct the `CSemaphore` object when it is needed. Specify the name of the semaphore you wish to wait on, and that your application should initially own it. You can then access the semaphore when the constructor returns. Call [CSyncObject::Unlock](../../mfc/reference/csyncobject-class.md#unlock) when you are done accessing the controlled resource. +To use a `CSemaphore` object, construct the `CSemaphore` object when it is needed. Specify the name of the semaphore you wish to wait on, and that your application should initially own it. You can then access the semaphore when the constructor returns. Call [`CSyncObject::Unlock`](../../mfc/reference/csyncobject-class.md#unlock) when you're done accessing the controlled resource. -An alternative method for using `CSemaphore` objects is to add a variable of type `CSemaphore` as a data member to the class you wish to control. During construction of the controlled object, call the constructor of the `CSemaphore` data member specifying the initial access count, maximum access count, name of the semaphore (if it will be used across process boundaries), and desired security attributes. +An alternative method for using `CSemaphore` objects is to add a variable of type `CSemaphore` as a data member to the class you wish to control. During construction of the controlled object, call the constructor of the `CSemaphore` data member specifying the initial access count, maximum access count, name of the semaphore (if it is used across process boundaries), and desired security attributes. -To access resources controlled by `CSemaphore` objects in this manner, first create a variable of either type [CSingleLock](../../mfc/reference/csinglelock-class.md) or type [CMultiLock](../../mfc/reference/cmultilock-class.md) in your resource's access member function. Then call the lock object's `Lock` member function (for example, [CSingleLock::Lock](../../mfc/reference/csinglelock-class.md#lock)). At this point, your thread will either gain access to the resource, wait for the resource to be released and gain access, or wait for the resource to be released and time out, failing to gain access to the resource. In any case, your resource has been accessed in a thread-safe manner. To release the resource, use the lock object's `Unlock` member function (for example, [CSingleLock::Unlock](../../mfc/reference/csinglelock-class.md#unlock)), or allow the lock object to fall out of scope. +To access resources controlled by `CSemaphore` objects in this manner, first create a variable of either type [CSingleLock](../../mfc/reference/csinglelock-class.md) or type [CMultiLock](../../mfc/reference/cmultilock-class.md) in your resource's access member function. Then call the lock object's `Lock` member function (for example, [CSingleLock::Lock](../../mfc/reference/csinglelock-class.md#lock)). At this point, your thread will either gain access to the resource, wait for the resource to be released and gain access, or wait for the resource to be released and time out, failing to gain access to the resource. In any case, your resource is accessed in a thread-safe manner. To release the resource, use the lock object's `Unlock` member function (for example, [CSingleLock::Unlock](../../mfc/reference/csinglelock-class.md#unlock)), or allow the lock object to fall out of scope. Alternatively, you can create a `CSemaphore` object stand-alone, and access it explicitly before attempting to access the controlled resource. This method, while clearer to someone reading your source code, is more prone to error. @@ -54,7 +53,7 @@ For more information on how to use `CSemaphore` objects, see the article [Multit Constructs a named or unnamed `CSemaphore` object. -``` +```cpp CSemaphore( LONG lInitialCount = 1, LONG lMaxCount = 1, @@ -64,26 +63,26 @@ CSemaphore( ### Parameters -*lInitialCount*
+*`lInitialCount`*\ The initial usage count for the semaphore. Must be greater than or equal to 0, and less than or equal to *lMaxCount*. -*lMaxCount*
+*`lMaxCount`*\ The maximum usage count for the semaphore. Must be greater than 0. -*pstrName*
-The name of the semaphore. Must be supplied if the semaphore will be accessed across process boundaries. If `NULL`, the object will be unnamed. If the name matches an existing semaphore, the constructor builds a new `CSemaphore` object which references the semaphore of that name. If the name matches an existing synchronization object that is not a semaphore, the construction will fail. +*`pstrName`*\ +The name of the semaphore. Must be supplied if the semaphore is accessed across process boundaries. If `NULL`, the object will be unnamed. If the name matches an existing semaphore, the constructor builds a new `CSemaphore` object which references the semaphore of that name. If the name matches an existing synchronization object that isn't a semaphore, the construction fails. -*lpsaAttributes*
+*`lpsaAttributes`*\ Security attributes for the semaphore object. For a full description of this structure, see [SECURITY_ATTRIBUTES](/previous-versions/windows/desktop/legacy/aa379560\(v=vs.85\)) in the Windows SDK. ### Remarks -To access or release a `CSemaphore` object, create a [CMultiLock](../../mfc/reference/cmultilock-class.md) or [CSingleLock](../../mfc/reference/csinglelock-class.md) object and call its [Lock](../../mfc/reference/csinglelock-class.md#lock) and [Unlock](../../mfc/reference/csinglelock-class.md#unlock) member functions. +To access or release a `CSemaphore` object, create a [`CMultiLock`](../../mfc/reference/cmultilock-class.md) or [`CSingleLock`](../../mfc/reference/csinglelock-class.md) object and call its [`Lock`](../../mfc/reference/csinglelock-class.md#lock) and [Unlock](../../mfc/reference/csinglelock-class.md#unlock) member functions. > [!IMPORTANT] -> After creating the `CSemaphore` object, use [GetLastError](/windows/win32/api/errhandlingapi/nf-errhandlingapi-getlasterror) to ensure that the mutex did not already exist. If the mutex did exist unexpectedly, it may indicate a rogue process is squatting and may be intending to use the mutex maliciously. In this case, the recommended security-conscious procedure is to close the handle and continue as if there was a failure in creating the object. +> After creating the `CSemaphore` object, use [`GetLastError`](/windows/win32/api/errhandlingapi/nf-errhandlingapi-getlasterror) to ensure that the mutex didn't already exist. If the mutex did exist unexpectedly, it may indicate a rogue process is squatting and may be intending to use the mutex maliciously. In this case, the recommended security-conscious procedure is to close the handle and continue as if there was a failure in creating the object. ## See also -[CSyncObject Class](../../mfc/reference/csyncobject-class.md)
+[`CSyncObject` Class](../../mfc/reference/csyncobject-class.md)\ [Hierarchy Chart](../../mfc/hierarchy-chart.md) diff --git a/docs/mfc/reference/cspinbuttonctrl-class.md b/docs/mfc/reference/cspinbuttonctrl-class.md index b9e1628b644..d5fc72a6e4e 100644 --- a/docs/mfc/reference/cspinbuttonctrl-class.md +++ b/docs/mfc/reference/cspinbuttonctrl-class.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: CSpinButtonCtrl Class" title: "CSpinButtonCtrl Class" -ms.date: "11/04/2016" +description: "Learn more about: CSpinButtonCtrl Class" +ms.date: 11/04/2016 f1_keywords: ["CSpinButtonCtrl", "AFXCMN/CSpinButtonCtrl", "AFXCMN/CSpinButtonCtrl::CSpinButtonCtrl", "AFXCMN/CSpinButtonCtrl::Create", "AFXCMN/CSpinButtonCtrl::CreateEx", "AFXCMN/CSpinButtonCtrl::GetAccel", "AFXCMN/CSpinButtonCtrl::GetBase", "AFXCMN/CSpinButtonCtrl::GetBuddy", "AFXCMN/CSpinButtonCtrl::GetPos", "AFXCMN/CSpinButtonCtrl::GetRange", "AFXCMN/CSpinButtonCtrl::SetAccel", "AFXCMN/CSpinButtonCtrl::SetBase", "AFXCMN/CSpinButtonCtrl::SetBuddy", "AFXCMN/CSpinButtonCtrl::SetPos", "AFXCMN/CSpinButtonCtrl::SetRange"] helpviewer_keywords: ["CSpinButtonCtrl [MFC], CSpinButtonCtrl", "CSpinButtonCtrl [MFC], Create", "CSpinButtonCtrl [MFC], CreateEx", "CSpinButtonCtrl [MFC], GetAccel", "CSpinButtonCtrl [MFC], GetBase", "CSpinButtonCtrl [MFC], GetBuddy", "CSpinButtonCtrl [MFC], GetPos", "CSpinButtonCtrl [MFC], GetRange", "CSpinButtonCtrl [MFC], SetAccel", "CSpinButtonCtrl [MFC], SetBase", "CSpinButtonCtrl [MFC], SetBuddy", "CSpinButtonCtrl [MFC], SetPos", "CSpinButtonCtrl [MFC], SetRange"] -ms.assetid: 509bfd76-1c5a-4af6-973f-e133c0b87734 --- # CSpinButtonCtrl Class @@ -71,7 +70,7 @@ For more information on using `CSpinButtonCtrl`, see [Controls](../../mfc/contro ## CSpinButtonCtrl::Create -Creates a spin button control and attaches it to a `CSpinButtonCtrl` object.. +Creates a spin button control and attaches it to a `CSpinButtonCtrl` object. ``` virtual BOOL Create( @@ -202,7 +201,8 @@ A pointer to the current buddy window. Retrieves the current position of a spin button control. ``` -int GetPos() const; int GetPos32(LPBOOL lpbError = NULL) const; +int GetPos() const; +int GetPos32(LPBOOL lpbError = NULL) const; ``` ### Parameters @@ -366,7 +366,7 @@ The member function `SetRange32` sets the 32-bit range for the spin button contr ## See also -[MFC Sample CMNCTRL2](../../overview/visual-cpp-samples.md)
-[CWnd Class](../../mfc/reference/cwnd-class.md)
-[Hierarchy Chart](../../mfc/hierarchy-chart.md)
+[MFC Sample CMNCTRL2](../../overview/visual-cpp-samples.md)\ +[CWnd Class](../../mfc/reference/cwnd-class.md)\ +[Hierarchy Chart](../../mfc/hierarchy-chart.md)\ [CSliderCtrl Class](../../mfc/reference/csliderctrl-class.md) diff --git a/docs/mfc/reference/cstatusbar-class.md b/docs/mfc/reference/cstatusbar-class.md index ff4116ac648..ccbf9e66028 100644 --- a/docs/mfc/reference/cstatusbar-class.md +++ b/docs/mfc/reference/cstatusbar-class.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: CStatusBar Class" title: "CStatusBar Class" -ms.date: "11/04/2016" +description: "Learn more about: CStatusBar Class" +ms.date: 11/04/2016 f1_keywords: ["CStatusBar", "AFXEXT/CStatusBar", "AFXEXT/CStatusBar::CStatusBar", "AFXEXT/CStatusBar::CommandToIndex", "AFXEXT/CStatusBar::Create", "AFXEXT/CStatusBar::CreateEx", "AFXEXT/CStatusBar::DrawItem", "AFXEXT/CStatusBar::GetItemID", "AFXEXT/CStatusBar::GetItemRect", "AFXEXT/CStatusBar::GetPaneInfo", "AFXEXT/CStatusBar::GetPaneStyle", "AFXEXT/CStatusBar::GetPaneText", "AFXEXT/CStatusBar::GetStatusBarCtrl", "AFXEXT/CStatusBar::SetIndicators", "AFXEXT/CStatusBar::SetPaneInfo", "AFXEXT/CStatusBar::SetPaneStyle", "AFXEXT/CStatusBar::SetPaneText"] helpviewer_keywords: ["CStatusBar [MFC], CStatusBar", "CStatusBar [MFC], CommandToIndex", "CStatusBar [MFC], Create", "CStatusBar [MFC], CreateEx", "CStatusBar [MFC], DrawItem", "CStatusBar [MFC], GetItemID", "CStatusBar [MFC], GetItemRect", "CStatusBar [MFC], GetPaneInfo", "CStatusBar [MFC], GetPaneStyle", "CStatusBar [MFC], GetPaneText", "CStatusBar [MFC], GetStatusBarCtrl", "CStatusBar [MFC], SetIndicators", "CStatusBar [MFC], SetPaneInfo", "CStatusBar [MFC], SetPaneStyle", "CStatusBar [MFC], SetPaneText"] -ms.assetid: a3bde3db-e71c-4881-a3ca-1d5481c345ba --- # CStatusBar Class @@ -306,7 +305,8 @@ For a list of styles available for status bars, see [Create](#create). Call this member function to retrieve the text that appears in a status-bar pane. ``` -CString GetPaneText(int nIndex) const; void GetPaneText(int nIndex, CString& rString) const; +CString GetPaneText(int nIndex) const; +void GetPaneText(int nIndex, CString& rString) const; ``` ### Parameters diff --git a/docs/mfc/reference/cstdiofile-class.md b/docs/mfc/reference/cstdiofile-class.md index 3692c706a0a..fd2ff46ab5a 100644 --- a/docs/mfc/reference/cstdiofile-class.md +++ b/docs/mfc/reference/cstdiofile-class.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: CStdioFile Class" title: "CStdioFile Class" -ms.date: "08/29/2019" +description: "Learn more about: CStdioFile Class" +ms.date: 08/29/2019 f1_keywords: ["CStdioFile", "AFX/CStdioFile", "AFX/CStdioFile::CStdioFile", "AFX/CStdioFile::Open", "AFX/CStdioFile::ReadString", "AFX/CStdioFile::Seek", "AFX/CStdioFile::WriteString", "AFX/CStdioFile::m_pStream"] helpviewer_keywords: ["CStdioFile [MFC], CStdioFile", "CStdioFile [MFC], Open", "CStdioFile [MFC], ReadString", "CStdioFile [MFC], Seek", "CStdioFile [MFC], WriteString", "CStdioFile [MFC], m_pStream"] -ms.assetid: 88c2274c-4f0e-4327-882a-557ba4b3ae15 --- # `CStdioFile` Class @@ -260,7 +259,7 @@ Specifies a pointer to a buffer that contains a null-terminated string. ### Remarks -The terminating null character ( `\0`) is not written to the file. This method writes newline characters in *`lpsz`* to the file as a carriage return-line feed pair. +The terminating null character (`\0`) is not written to the file. This method writes newline characters in *`lpsz`* to the file as a carriage return-line feed pair. If you want to write data that is not null-terminated to a file, use `CStdioFile::Write` or [`CFile::Write`](../../mfc/reference/cfile-class.md#write). diff --git a/docs/mfc/reference/ctabctrl-class.md b/docs/mfc/reference/ctabctrl-class.md index 8416886a1de..1a2461f10b1 100644 --- a/docs/mfc/reference/ctabctrl-class.md +++ b/docs/mfc/reference/ctabctrl-class.md @@ -1,7 +1,7 @@ --- title: "CTabCtrl Class" description: "Learn more about: CTabCtrl Class" -ms.date: "1/29/2021" +ms.date: 1/29/2021 f1_keywords: ["CTabCtrl", "AFXCMN/CTabCtrl", "AFXCMN/CTabCtrl::CTabCtrl", "AFXCMN/CTabCtrl::AdjustRect", "AFXCMN/CTabCtrl::Create", "AFXCMN/CTabCtrl::CreateEx", "AFXCMN/CTabCtrl::DeleteAllItems", "AFXCMN/CTabCtrl::DeleteItem", "AFXCMN/CTabCtrl::DeselectAll", "AFXCMN/CTabCtrl::DrawItem", "AFXCMN/CTabCtrl::GetCurFocus", "AFXCMN/CTabCtrl::GetCurSel", "AFXCMN/CTabCtrl::GetExtendedStyle", "AFXCMN/CTabCtrl::GetImageList", "AFXCMN/CTabCtrl::GetItem", "AFXCMN/CTabCtrl::GetItemCount", "AFXCMN/CTabCtrl::GetItemRect", "AFXCMN/CTabCtrl::GetItemState", "AFXCMN/CTabCtrl::GetRowCount", "AFXCMN/CTabCtrl::GetToolTips", "AFXCMN/CTabCtrl::HighlightItem", "AFXCMN/CTabCtrl::HitTest", "AFXCMN/CTabCtrl::InsertItem", "AFXCMN/CTabCtrl::RemoveImage", "AFXCMN/CTabCtrl::SetCurFocus", "AFXCMN/CTabCtrl::SetCurSel", "AFXCMN/CTabCtrl::SetExtendedStyle", "AFXCMN/CTabCtrl::SetImageList", "AFXCMN/CTabCtrl::SetItem", "AFXCMN/CTabCtrl::SetItemExtra", "AFXCMN/CTabCtrl::SetItemSize", "AFXCMN/CTabCtrl::SetItemState", "AFXCMN/CTabCtrl::SetMinTabWidth", "AFXCMN/CTabCtrl::SetPadding", "AFXCMN/CTabCtrl::SetToolTips"] helpviewer_keywords: ["CTabCtrl [MFC], CTabCtrl", "CTabCtrl [MFC], AdjustRect", "CTabCtrl [MFC], Create", "CTabCtrl [MFC], CreateEx", "CTabCtrl [MFC], DeleteAllItems", "CTabCtrl [MFC], DeleteItem", "CTabCtrl [MFC], DeselectAll", "CTabCtrl [MFC], DrawItem", "CTabCtrl [MFC], GetCurFocus", "CTabCtrl [MFC], GetCurSel", "CTabCtrl [MFC], GetExtendedStyle", "CTabCtrl [MFC], GetImageList", "CTabCtrl [MFC], GetItem", "CTabCtrl [MFC], GetItemCount", "CTabCtrl [MFC], GetItemRect", "CTabCtrl [MFC], GetItemState", "CTabCtrl [MFC], GetRowCount", "CTabCtrl [MFC], GetToolTips", "CTabCtrl [MFC], HighlightItem", "CTabCtrl [MFC], HitTest", "CTabCtrl [MFC], InsertItem", "CTabCtrl [MFC], RemoveImage", "CTabCtrl [MFC], SetCurFocus", "CTabCtrl [MFC], SetCurSel", "CTabCtrl [MFC], SetExtendedStyle", "CTabCtrl [MFC], SetImageList", "CTabCtrl [MFC], SetItem", "CTabCtrl [MFC], SetItemExtra", "CTabCtrl [MFC], SetItemSize", "CTabCtrl [MFC], SetItemState", "CTabCtrl [MFC], SetMinTabWidth", "CTabCtrl [MFC], SetPadding", "CTabCtrl [MFC], SetToolTips"] --- @@ -80,7 +80,7 @@ For more information about `CTabCtrl`, see [Controls](../../mfc/controls-mfc.md) **Header:** `afxcmn.h` -## `CTabCtrl::AdjustRect` +## `CTabCtrl::AdjustRect` Calculates a tab control's display area given a window rectangle, or calculates the window rectangle that would correspond to a given display area. @@ -366,7 +366,7 @@ Index into the tab control's image list, or -1 if there is no image for the tab. - `lParam` - Application-defined data associated with the tab. If there are more than 4 bytes of application-defined data per tab, an application must define a structure and use it instead of the `TCITEM` structure. The first member of the application-defined structure must be a [`TCITEMHEADER`](/windows/win32/api/commctrl/ns-commctrl-tcitemheaderw)structure. The `TCITEMHEADER` structure is identical to the `TCITEM` structure, but without the `lParam` member. The difference between the size of your structure and the size of the `TCITEMHEADER` structure should equal the number of extra bytes per tab. + Application-defined data associated with the tab. If there are more than 4 bytes of application-defined data per tab, an application must define a structure and use it instead of the `TCITEM` structure. The first member of the application-defined structure must be a [`TCITEMHEADER`](/windows/win32/api/commctrl/ns-commctrl-tcitemheaderw) structure. The `TCITEMHEADER` structure is identical to the `TCITEM` structure, but without the `lParam` member. The difference between the size of your structure and the size of the `TCITEMHEADER` structure should equal the number of extra bytes per tab. ### Example diff --git a/docs/mfc/reference/ctabview-class.md b/docs/mfc/reference/ctabview-class.md index b084e0afbd3..82983a5e29a 100644 --- a/docs/mfc/reference/ctabview-class.md +++ b/docs/mfc/reference/ctabview-class.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: CTabView Class" title: "CTabView Class" -ms.date: "11/04/2016" +description: "Learn more about: CTabView Class" +ms.date: 11/04/2016 f1_keywords: ["CTabView", "AFXTABVIEW/CTabView", "AFXTABVIEW/CTabView::AddView", "AFXTABVIEW/CTabView::FindTab", "AFXTABVIEW/CTabView::GetActiveView", "AFXTABVIEW/CTabView::GetTabControl", "AFXTABVIEW/CTabView::RemoveView", "AFXTABVIEW/CTabView::SetActiveView", "AFXTABVIEW/CTabView::IsScrollBar", "AFXTABVIEW/CTabView::OnActivateView"] helpviewer_keywords: ["CTabView [MFC], AddView", "CTabView [MFC], FindTab", "CTabView [MFC], GetActiveView", "CTabView [MFC], GetTabControl", "CTabView [MFC], RemoveView", "CTabView [MFC], SetActiveView", "CTabView [MFC], IsScrollBar", "CTabView [MFC], OnActivateView"] -ms.assetid: 8e6ecd9d-d28d-432b-8ec8-0446f0204d52 --- # CTabView Class @@ -208,7 +207,7 @@ TRUE if the specified view was made active, FALSE if the view's index is invalid ### Remarks -For more information see [CMFCTabCtrl::SetActiveTab](../../mfc/reference/cmfctabctrl-class.md#setactivetab). +For more information, see [CMFCTabCtrl::SetActiveTab](../../mfc/reference/cmfctabctrl-class.md#setactivetab). ## See also diff --git a/docs/mfc/reference/ctaskdialog-class.md b/docs/mfc/reference/ctaskdialog-class.md index 9c685c35608..2f1d87a8197 100644 --- a/docs/mfc/reference/ctaskdialog-class.md +++ b/docs/mfc/reference/ctaskdialog-class.md @@ -685,7 +685,7 @@ virtual HRESULT OnHelp(); ### Return Value -The default implementation returns S_OK. +The default implementation returns S_FALSE. ### Remarks diff --git a/docs/mfc/reference/ctoolbar-class.md b/docs/mfc/reference/ctoolbar-class.md index 983d20748bc..33cab610164 100644 --- a/docs/mfc/reference/ctoolbar-class.md +++ b/docs/mfc/reference/ctoolbar-class.md @@ -52,7 +52,7 @@ The buttons can act like pushbuttons, check-box buttons, or radio buttons. `CToo [`CToolBar::GetToolBarCtrl`](#gettoolbarctrl), a member function new to MFC 4.0, allows you to take advantage of the Windows common control's support for toolbar customization and additional functionality. `CToolBar` member functions give you most of the functionality of the Windows common controls; however, when you call `GetToolBarCtrl`, you can give your toolbars even more of the characteristics of Windows 95/98 toolbars. When you call `GetToolBarCtrl`, it will return a reference to a `CToolBarCtrl` object. See [`CToolBarCtrl`](../../mfc/reference/ctoolbarctrl-class.md) for more information about designing toolbars using Windows common controls. For more general information about common controls, see [Common Controls](/windows/win32/Controls/common-controls-intro) in the Windows SDK. -Visual C++ provides you with two methods to create a toolbar. To create a toolbar resource using the Resource Editor, follow these steps: +Visual Studio provides you with two methods to create a toolbar. To create a toolbar resource using the Resource Editor, follow these steps: 1. Create a toolbar resource. diff --git a/docs/mfc/reference/ctypedptrarray-class.md b/docs/mfc/reference/ctypedptrarray-class.md index 5bdf3ccd14c..db37f7ca4af 100644 --- a/docs/mfc/reference/ctypedptrarray-class.md +++ b/docs/mfc/reference/ctypedptrarray-class.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: CTypedPtrArray Class" title: "CTypedPtrArray Class" -ms.date: "11/04/2016" +description: "Learn more about: CTypedPtrArray Class" +ms.date: 11/04/2016 f1_keywords: ["CTypedPtrArray", "AFXTEMPL/CTypedPtrArray", "AFXTEMPL/CTypedPtrArray::Add", "AFXTEMPL/CTypedPtrArray::Append", "AFXTEMPL/CTypedPtrArray::Copy", "AFXTEMPL/CTypedPtrArray::ElementAt", "AFXTEMPL/CTypedPtrArray::GetAt", "AFXTEMPL/CTypedPtrArray::InsertAt", "AFXTEMPL/CTypedPtrArray::SetAt", "AFXTEMPL/CTypedPtrArray::SetAtGrow"] helpviewer_keywords: ["CTypedPtrArray [MFC], Add", "CTypedPtrArray [MFC], Append", "CTypedPtrArray [MFC], Copy", "CTypedPtrArray [MFC], ElementAt", "CTypedPtrArray [MFC], GetAt", "CTypedPtrArray [MFC], InsertAt", "CTypedPtrArray [MFC], SetAt", "CTypedPtrArray [MFC], SetAtGrow"] -ms.assetid: e3ecdf1a-a889-4156-92dd-ddbd36ccd919 --- # CTypedPtrArray Class @@ -20,7 +19,7 @@ class CTypedPtrArray : public BASE_CLASS #### Parameters *BASE_CLASS*
-Base class of the typed pointer array class; must be an array class ( `CObArray` or `CPtrArray`). +Base class of the typed pointer array class; must be an array class (`CObArray` or `CPtrArray`). *TYPE*
Type of the elements stored in the base-class array. diff --git a/docs/mfc/reference/ctypedptrlist-class.md b/docs/mfc/reference/ctypedptrlist-class.md index dd4e551d00b..d06daa00f41 100644 --- a/docs/mfc/reference/ctypedptrlist-class.md +++ b/docs/mfc/reference/ctypedptrlist-class.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: CTypedPtrList Class" title: "CTypedPtrList Class" -ms.date: "11/04/2016" +description: "Learn more about: CTypedPtrList Class" +ms.date: 11/04/2016 f1_keywords: ["CTypedPtrList", "AFXTEMPL/CTypedPtrList", "AFXTEMPL/CTypedPtrList::AddHead", "AFXTEMPL/CTypedPtrList::AddTail", "AFXTEMPL/CTypedPtrList::GetAt", "AFXTEMPL/CTypedPtrList::GetHead", "AFXTEMPL/CTypedPtrList::GetNext", "AFXTEMPL/CTypedPtrList::GetPrev", "AFXTEMPL/CTypedPtrList::GetTail", "AFXTEMPL/CTypedPtrList::RemoveHead", "AFXTEMPL/CTypedPtrList::RemoveTail", "AFXTEMPL/CTypedPtrList::SetAt"] helpviewer_keywords: ["CTypedPtrList [MFC], AddHead", "CTypedPtrList [MFC], AddTail", "CTypedPtrList [MFC], GetAt", "CTypedPtrList [MFC], GetHead", "CTypedPtrList [MFC], GetNext", "CTypedPtrList [MFC], GetPrev", "CTypedPtrList [MFC], GetTail", "CTypedPtrList [MFC], RemoveHead", "CTypedPtrList [MFC], RemoveTail", "CTypedPtrList [MFC], SetAt"] -ms.assetid: c273096e-1756-4340-864b-4a08b674a65e --- # CTypedPtrList Class @@ -20,7 +19,7 @@ class CTypedPtrList : public BASE_CLASS #### Parameters *BASE_CLASS*
-Base class of the typed pointer list class; must be a pointer list class ( `CObList` or `CPtrList`). +Base class of the typed pointer list class; must be a pointer list class (`CObList` or `CPtrList`). *TYPE*
Type of the elements stored in the base-class list. diff --git a/docs/mfc/reference/ctypedptrmap-class.md b/docs/mfc/reference/ctypedptrmap-class.md index 03721557f82..1e8ac54c643 100644 --- a/docs/mfc/reference/ctypedptrmap-class.md +++ b/docs/mfc/reference/ctypedptrmap-class.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: CTypedPtrMap Class" title: "CTypedPtrMap Class" -ms.date: "11/04/2016" +description: "Learn more about: CTypedPtrMap Class" +ms.date: 11/04/2016 f1_keywords: ["CTypedPtrMap", "AFXTEMPL/CTypedPtrMap", "AFXTEMPL/CTypedPtrMap::GetNextAssoc", "AFXTEMPL/CTypedPtrMap::Lookup", "AFXTEMPL/CTypedPtrMap::RemoveKey", "AFXTEMPL/CTypedPtrMap::SetAt"] helpviewer_keywords: ["CTypedPtrMap [MFC], GetNextAssoc", "CTypedPtrMap [MFC], Lookup", "CTypedPtrMap [MFC], RemoveKey", "CTypedPtrMap [MFC], SetAt"] -ms.assetid: 9f377385-c6e9-4471-8b40-8fe220c50164 --- # CTypedPtrMap Class @@ -20,7 +19,7 @@ class CTypedPtrMap : public BASE_CLASS #### Parameters *BASE_CLASS*
-Base class of the typed pointer map class; must be a pointer map class ( `CMapPtrToPtr`, `CMapPtrToWord`, `CMapWordToPtr`, or `CMapStringToPtr`). +Base class of the typed pointer map class; must be a pointer map class (`CMapPtrToPtr`, `CMapPtrToWord`, `CMapWordToPtr`, or `CMapStringToPtr`). *KEY*
Class of the object used as the key to the map. diff --git a/docs/mfc/reference/cwinapp-class.md b/docs/mfc/reference/cwinapp-class.md index db9e83c08fb..7f45102a51a 100644 --- a/docs/mfc/reference/cwinapp-class.md +++ b/docs/mfc/reference/cwinapp-class.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: CWinApp Class" title: "CWinApp Class" -ms.date: "07/15/2019" +description: "Learn more about: CWinApp Class" +ms.date: 07/15/2019 f1_keywords: ["CWinApp", "AFXWIN/CWinApp", "AFXWIN/CWinApp::CWinApp", "AFXWIN/CWinApp::AddDocTemplate", "AFXWIN/CWinApp::AddToRecentFileList", "AFXWIN/CWinApp::ApplicationRecoveryCallback", "AFXWIN/CWinApp::CloseAllDocuments", "AFXWIN/CWinApp::CreatePrinterDC", "AFXWIN/CWinApp::DelRegTree", "AFXWIN/CWinApp::DoMessageBox", "AFXWIN/CWinApp::DoWaitCursor", "AFXWIN/CWinApp::EnableD2DSupport", "AFXWIN/CWinApp::EnableHtmlHelp", "AFXWIN/CWinApp::EnableTaskbarInteraction", "AFXWIN/CWinApp::ExitInstance", "AFXWIN/CWinApp::GetApplicationRecoveryParameter", "AFXWIN/CWinApp::GetApplicationRecoveryPingInterval", "AFXWIN/CWinApp::GetApplicationRestartFlags", "AFXWIN/CWinApp::GetAppRegistryKey", "AFXWIN/CWinApp::GetDataRecoveryHandler", "AFXWIN/CWinApp::GetFirstDocTemplatePosition", "AFXWIN/CWinApp::GetHelpMode", "AFXWIN/CWinApp::GetNextDocTemplate", "AFXWIN/CWinApp::GetPrinterDeviceDefaults", "AFXWIN/CWinApp::GetProfileBinary", "AFXWIN/CWinApp::GetProfileInt", "AFXWIN/CWinApp::GetProfileString", "AFXWIN/CWinApp::GetSectionKey", "AFXWIN/CWinApp::HideApplication", "AFXWIN/CWinApp::HtmlHelp", "AFXWIN/CWinApp::InitInstance", "AFXWIN/CWinApp::IsTaskbarInteractionEnabled", "AFXWIN/CWinApp::LoadCursor", "AFXWIN/CWinApp::LoadIcon", "AFXWIN/CWinApp::LoadOEMCursor", "AFXWIN/CWinApp::LoadOEMIcon", "AFXWIN/CWinApp::LoadStandardCursor", "AFXWIN/CWinApp::LoadStandardIcon", "AFXWIN/CWinApp::OnDDECommand", "AFXWIN/CWinApp::OnIdle", "AFXWIN/CWinApp::OpenDocumentFile", "AFXWIN/CWinApp::ParseCommandLine", "AFXWIN/CWinApp::PreTranslateMessage", "AFXWIN/CWinApp::ProcessMessageFilter", "AFXWIN/CWinApp::ProcessShellCommand", "AFXWIN/CWinApp::ProcessWndProcException", "AFXWIN/CWinApp::Register", "AFXWIN/CWinApp::RegisterWithRestartManager", "AFXWIN/CWinApp::ReopenPreviousFilesAtRestart", "AFXWIN/CWinApp::RestartInstance", "AFXWIN/CWinApp::RestoreAutosavedFilesAtRestart", "AFXWIN/CWinApp::Run", "AFXWIN/CWinApp::RunAutomated", "AFXWIN/CWinApp::RunEmbedded", "AFXWIN/CWinApp::SaveAllModified", "AFXWIN/CWinApp::SelectPrinter", "AFXWIN/CWinApp::SetHelpMode", "AFXWIN/CWinApp::SupportsApplicationRecovery", "AFXWIN/CWinApp::SupportsAutosaveAtInterval", "AFXWIN/CWinApp::SupportsAutosaveAtRestart", "AFXWIN/CWinApp::SupportsRestartManager", "AFXWIN/CWinApp::Unregister", "AFXWIN/CWinApp::WinHelp", "AFXWIN/CWinApp::WriteProfileBinary", "AFXWIN/CWinApp::WriteProfileInt", "AFXWIN/CWinApp::WriteProfileString", "AFXWIN/CWinApp::EnableShellOpen", "AFXWIN/CWinApp::LoadStdProfileSettings", "AFXWIN/CWinApp::OnContextHelp", "AFXWIN/CWinApp::OnFileNew", "AFXWIN/CWinApp::OnFileOpen", "AFXWIN/CWinApp::OnFilePrintSetup", "AFXWIN/CWinApp::OnHelp", "AFXWIN/CWinApp::OnHelpFinder", "AFXWIN/CWinApp::OnHelpIndex", "AFXWIN/CWinApp::OnHelpUsing", "AFXWIN/CWinApp::RegisterShellFileTypes", "AFXWIN/CWinApp::SetAppID", "AFXWIN/CWinApp::SetRegistryKey", "AFXWIN/CWinApp::UnregisterShellFileTypes", "AFXWIN/CWinApp::m_bHelpMode", "AFXWIN/CWinApp::m_eHelpType", "AFXWIN/CWinApp::m_hInstance", "AFXWIN/CWinApp::m_lpCmdLine", "AFXWIN/CWinApp::m_nCmdShow", "AFXWIN/CWinApp::m_pActiveWnd", "AFXWIN/CWinApp::m_pszAppID", "AFXWIN/CWinApp::m_pszAppName", "AFXWIN/CWinApp::m_pszExeName", "AFXWIN/CWinApp::m_pszHelpFilePath", "AFXWIN/CWinApp::m_pszProfileName", "AFXWIN/CWinApp::m_pszRegistryKey", "AFXWIN/CWinApp::m_dwRestartManagerSupportFlags", "AFXWIN/CWinApp::m_nAutosaveInterval", "AFXWIN/CWinApp::m_pDataRecoveryHandler"] helpviewer_keywords: ["CWinApp [MFC], CWinApp", "CWinApp [MFC], AddDocTemplate", "CWinApp [MFC], AddToRecentFileList", "CWinApp [MFC], ApplicationRecoveryCallback", "CWinApp [MFC], CloseAllDocuments", "CWinApp [MFC], CreatePrinterDC", "CWinApp [MFC], DelRegTree", "CWinApp [MFC], DoMessageBox", "CWinApp [MFC], DoWaitCursor", "CWinApp [MFC], EnableD2DSupport", "CWinApp [MFC], EnableHtmlHelp", "CWinApp [MFC], EnableTaskbarInteraction", "CWinApp [MFC], ExitInstance", "CWinApp [MFC], GetApplicationRecoveryParameter", "CWinApp [MFC], GetApplicationRecoveryPingInterval", "CWinApp [MFC], GetApplicationRestartFlags", "CWinApp [MFC], GetAppRegistryKey", "CWinApp [MFC], GetDataRecoveryHandler", "CWinApp [MFC], GetFirstDocTemplatePosition", "CWinApp [MFC], GetHelpMode", "CWinApp [MFC], GetNextDocTemplate", "CWinApp [MFC], GetPrinterDeviceDefaults", "CWinApp [MFC], GetProfileBinary", "CWinApp [MFC], GetProfileInt", "CWinApp [MFC], GetProfileString", "CWinApp [MFC], GetSectionKey", "CWinApp [MFC], HideApplication", "CWinApp [MFC], HtmlHelp", "CWinApp [MFC], InitInstance", "CWinApp [MFC], IsTaskbarInteractionEnabled", "CWinApp [MFC], LoadCursor", "CWinApp [MFC], LoadIcon", "CWinApp [MFC], LoadOEMCursor", "CWinApp [MFC], LoadOEMIcon", "CWinApp [MFC], LoadStandardCursor", "CWinApp [MFC], LoadStandardIcon", "CWinApp [MFC], OnDDECommand", "CWinApp [MFC], OnIdle", "CWinApp [MFC], OpenDocumentFile", "CWinApp [MFC], ParseCommandLine", "CWinApp [MFC], PreTranslateMessage", "CWinApp [MFC], ProcessMessageFilter", "CWinApp [MFC], ProcessShellCommand", "CWinApp [MFC], ProcessWndProcException", "CWinApp [MFC], Register", "CWinApp [MFC], RegisterWithRestartManager", "CWinApp [MFC], ReopenPreviousFilesAtRestart", "CWinApp [MFC], RestartInstance", "CWinApp [MFC], RestoreAutosavedFilesAtRestart", "CWinApp [MFC], Run", "CWinApp [MFC], RunAutomated", "CWinApp [MFC], RunEmbedded", "CWinApp [MFC], SaveAllModified", "CWinApp [MFC], SelectPrinter", "CWinApp [MFC], SetHelpMode", "CWinApp [MFC], SupportsApplicationRecovery", "CWinApp [MFC], SupportsAutosaveAtInterval", "CWinApp [MFC], SupportsAutosaveAtRestart", "CWinApp [MFC], SupportsRestartManager", "CWinApp [MFC], Unregister", "CWinApp [MFC], WinHelp", "CWinApp [MFC], WriteProfileBinary", "CWinApp [MFC], WriteProfileInt", "CWinApp [MFC], WriteProfileString", "CWinApp [MFC], EnableShellOpen", "CWinApp [MFC], LoadStdProfileSettings", "CWinApp [MFC], OnContextHelp", "CWinApp [MFC], OnFileNew", "CWinApp [MFC], OnFileOpen", "CWinApp [MFC], OnFilePrintSetup", "CWinApp [MFC], OnHelp", "CWinApp [MFC], OnHelpFinder", "CWinApp [MFC], OnHelpIndex", "CWinApp [MFC], OnHelpUsing", "CWinApp [MFC], RegisterShellFileTypes", "CWinApp [MFC], SetAppID", "CWinApp [MFC], SetRegistryKey", "CWinApp [MFC], UnregisterShellFileTypes", "CWinApp [MFC], m_bHelpMode", "CWinApp [MFC], m_eHelpType", "CWinApp [MFC], m_hInstance", "CWinApp [MFC], m_lpCmdLine", "CWinApp [MFC], m_nCmdShow", "CWinApp [MFC], m_pActiveWnd", "CWinApp [MFC], m_pszAppID", "CWinApp [MFC], m_pszAppName", "CWinApp [MFC], m_pszExeName", "CWinApp [MFC], m_pszHelpFilePath", "CWinApp [MFC], m_pszProfileName", "CWinApp [MFC], m_pszRegistryKey", "CWinApp [MFC], m_dwRestartManagerSupportFlags", "CWinApp [MFC], m_nAutosaveInterval", "CWinApp [MFC], m_pDataRecoveryHandler"] -ms.assetid: e426a3cd-0d15-40d6-bd55-beaa5feb2343 --- # CWinApp Class @@ -897,7 +896,8 @@ Taskbar interaction means that MDI application displays the content of MDI child Loads the cursor resource named by *lpszResourceName* or specified by *nIDResource* from the current executable file. ``` -HCURSOR LoadCursor(LPCTSTR lpszResourceName) const; HCURSOR LoadCursor(UINT nIDResource) const; +HCURSOR LoadCursor(LPCTSTR lpszResourceName) const; +HCURSOR LoadCursor(UINT nIDResource) const; ``` ### Parameters @@ -927,7 +927,8 @@ Use the [LoadStandardCursor](#loadstandardcursor) or [LoadOEMCursor](#loadoemcur Loads the icon resource named by *lpszResourceName* or specified by *nIDResource* from the executable file. ``` -HICON LoadIcon(LPCTSTR lpszResourceName) const; HICON LoadIcon(UINT nIDResource) const; +HICON LoadIcon(LPCTSTR lpszResourceName) const; +HICON LoadIcon(UINT nIDResource) const; ``` ### Parameters @@ -962,7 +963,7 @@ HCURSOR LoadOEMCursor(UINT nIDCursor) const; ### Parameters *nIDCursor*
-An **OCR_** manifest constant identifier that specifies a predefined Windows cursor. You must have `#define OEMRESOURCE` before `#include \` to gain access to the **OCR_** constants in WINDOWS.H. +An **OCR_** manifest constant identifier that specifies a predefined Windows cursor. You must have `#define OEMRESOURCE` before `#include ` to gain access to the **OCR_** constants in WINDOWS.H. ### Return Value @@ -989,7 +990,7 @@ HICON LoadOEMIcon(UINT nIDIcon) const; ### Parameters *nIDIcon*
-An **OIC_** manifest constant identifier that specifies a predefined Windows icon. You must have `#define OEMRESOURCE` before `#include \` to access the **OIC_** constants in WINDOWS.H. +An **OIC_** manifest constant identifier that specifies a predefined Windows icon. You must have `#define OEMRESOURCE` before `#include ` to access the **OIC_** constants in WINDOWS.H. ### Return Value @@ -1535,7 +1536,7 @@ The framework calls this method to open the named [CDocument](../../mfc/referenc ``` virtual CDocument* OpenDocumentFile( - LPCTSTR lpszFileName + LPCTSTR lpszFileName, BOOL bAddToMRU = TRUE); ``` @@ -1621,7 +1622,7 @@ virtual BOOL ProcessMessageFilter( Specifies a hook code. This member function uses the code to determine how to process *lpMsg.* *lpMsg*
-A pointer to a Windows [MSG](/windows/win32/api/winuser/ns-winuser-msg)tructure. +A pointer to a Windows [MSG](/windows/win32/api/winuser/ns-winuser-msg) structure. ### Return Value @@ -1692,7 +1693,7 @@ virtual LRESULT ProcessWndProcException( A pointer to an uncaught exception. *pMsg*
-A [MSG](/windows/win32/api/winuser/ns-winuser-msg)tructure that contains information about the windows message that caused the framework to throw an exception. +A [MSG](/windows/win32/api/winuser/ns-winuser-msg) structure that contains information about the windows message that caused the framework to throw an exception. ### Return Value @@ -1936,7 +1937,7 @@ void SelectPrinter( ### Parameters *hDevNames*
-A handle to a [DEVNAMES](/windows/win32/api/commdlg/ns-commdlg-devnames)tructure that identifies the driver, device, and output port names of a specific printer. +A handle to a [DEVNAMES](/windows/win32/api/commdlg/ns-commdlg-devnames) structure that identifies the driver, device, and output port names of a specific printer. *hDevMode*
A handle to a [DEVMODE](/windows/win32/api/wingdi/ns-wingdi-devmodea) structure that specifies information about the device initialization and environment of a printer. diff --git a/docs/mfc/reference/cwinappex-class.md b/docs/mfc/reference/cwinappex-class.md index d9c7ac4fade..85b09877183 100644 --- a/docs/mfc/reference/cwinappex-class.md +++ b/docs/mfc/reference/cwinappex-class.md @@ -970,7 +970,7 @@ virtual BOOL OnWorkspaceIdle(CWnd*); ### Parameters -[in] *`CWnd*`*\ +[in] *`CWnd*`* ### Return Value diff --git a/docs/mfc/reference/cwindowdc-class.md b/docs/mfc/reference/cwindowdc-class.md index 19f890b5cef..e27c7be752e 100644 --- a/docs/mfc/reference/cwindowdc-class.md +++ b/docs/mfc/reference/cwindowdc-class.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: CWindowDC Class" title: "CWindowDC Class" -ms.date: "11/04/2016" +description: "Learn more about: CWindowDC Class" +ms.date: 11/04/2016 f1_keywords: ["CWindowDC", "AFXWIN/CWindowDC", "AFXWIN/CWindowDC::CWindowDC", "AFXWIN/CWindowDC::m_hWnd"] helpviewer_keywords: ["CWindowDC [MFC], CWindowDC", "CWindowDC [MFC], m_hWnd"] -ms.assetid: 876a3641-4cde-471c-b0d1-fe58b32af79c --- # CWindowDC Class @@ -32,7 +31,7 @@ class CWindowDC : public CDC ## Remarks -Calls the Windows function [GetWindowDC](/windows/win32/api/winuser/nf-winuser-getwindowdc)at construction time and [ReleaseDC](/windows/win32/api/winuser/nf-winuser-releasedc) at destruction time. This means that a `CWindowDC` object accesses the entire screen area of a [CWnd](../../mfc/reference/cwnd-class.md) (both client and nonclient areas). +Calls the Windows function [GetWindowDC](/windows/win32/api/winuser/nf-winuser-getwindowdc) at construction time and [ReleaseDC](/windows/win32/api/winuser/nf-winuser-releasedc) at destruction time. This means that a `CWindowDC` object accesses the entire screen area of a [CWnd](../../mfc/reference/cwnd-class.md) (both client and nonclient areas). For more information on using `CWindowDC`, see [Device Contexts](../../mfc/device-contexts.md). diff --git a/docs/mfc/reference/cwnd-class.md b/docs/mfc/reference/cwnd-class.md index 7465c5223ed..37b4d19b134 100644 --- a/docs/mfc/reference/cwnd-class.md +++ b/docs/mfc/reference/cwnd-class.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: CWnd Class" title: "CWnd Class" -ms.date: "8/25/2021" +description: "Learn more about: CWnd Class" +ms.date: 8/25/2021 f1_keywords: ["CWnd", "AFXWIN/CWnd", "AFXWIN/CWnd::CWnd", "AFXWIN/CWnd::accDoDefaultAction", "AFXWIN/CWnd::accHitTest", "AFXWIN/CWnd::accLocation", "AFXWIN/CWnd::accNavigate", "AFXWIN/CWnd::accSelect", "AFXWIN/CWnd::AnimateWindow", "AFXWIN/CWnd::ArrangeIconicWindows", "AFXWIN/CWnd::Attach", "AFXWIN/CWnd::BeginModalState", "AFXWIN/CWnd::BeginPaint", "AFXWIN/CWnd::BindDefaultProperty", "AFXWIN/CWnd::BindProperty", "AFXWIN/CWnd::BringWindowToTop", "AFXWIN/CWnd::CalcWindowRect", "AFXWIN/CWnd::CancelToolTips", "AFXWIN/CWnd::CenterWindow", "AFXWIN/CWnd::ChangeClipboardChain", "AFXWIN/CWnd::CheckDlgButton", "AFXWIN/CWnd::CheckRadioButton", "AFXWIN/CWnd::ChildWindowFromPoint", "AFXWIN/CWnd::ClientToScreen", "AFXWIN/CWnd::CloseWindow", "AFXWIN/CWnd::ContinueModal", "AFXWIN/CWnd::Create", "AFXWIN/CWnd::CreateAccessibleProxy", "AFXWIN/CWnd::CreateCaret", "AFXWIN/CWnd::CreateControl", "AFXWIN/CWnd::CreateEx", "AFXWIN/CWnd::CreateGrayCaret", "AFXWIN/CWnd::CreateSolidCaret", "AFXWIN/CWnd::DeleteTempMap", "AFXWIN/CWnd::DestroyWindow", "AFXWIN/CWnd::Detach", "AFXWIN/CWnd::DlgDirList", "AFXWIN/CWnd::DlgDirListComboBox", "AFXWIN/CWnd::DlgDirSelect", "AFXWIN/CWnd::DlgDirSelectComboBox", "AFXWIN/CWnd::DragAcceptFiles", "AFXWIN/CWnd::DragDetect", "AFXWIN/CWnd::DrawAnimatedRects", "AFXWIN/CWnd::DrawCaption", "AFXWIN/CWnd::DrawMenuBar", "AFXWIN/CWnd::EnableActiveAccessibility", "AFXWIN/CWnd::EnableDynamicLayout", "AFXWIN/CWnd::EnableD2DSupport", "AFXWIN/CWnd::EnableScrollBar", "AFXWIN/CWnd::EnableScrollBarCtrl", "AFXWIN/CWnd::EnableToolTips", "AFXWIN/CWnd::EnableTrackingToolTips", "AFXWIN/CWnd::EnableWindow", "AFXWIN/CWnd::EndModalLoop", "AFXWIN/CWnd::EndModalState", "AFXWIN/CWnd::EndPaint", "AFXWIN/CWnd::ExecuteDlgInit", "AFXWIN/CWnd::FilterToolTipMessage", "AFXWIN/CWnd::FindWindow", "AFXWIN/CWnd::FindWindowEx", "AFXWIN/CWnd::FlashWindow", "AFXWIN/CWnd::FlashWindowEx", "AFXWIN/CWnd::FromHandle", "AFXWIN/CWnd::FromHandlePermanent", "AFXWIN/CWnd::get_accChild", "AFXWIN/CWnd::get_accChildCount", "AFXWIN/CWnd::get_accDefaultAction", "AFXWIN/CWnd::get_accDescription", "AFXWIN/CWnd::get_accFocus", "AFXWIN/CWnd::get_accHelp", "AFXWIN/CWnd::get_accHelpTopic", "AFXWIN/CWnd::get_accKeyboardShortcut", "AFXWIN/CWnd::get_accName", "AFXWIN/CWnd::get_accParent", "AFXWIN/CWnd::get_accRole", "AFXWIN/CWnd::get_accSelection", "AFXWIN/CWnd::get_accState", "AFXWIN/CWnd::get_accValue", "AFXWIN/CWnd::GetActiveWindow", "AFXWIN/CWnd::GetAncestor", "AFXWIN/CWnd::GetCapture", "AFXWIN/CWnd::GetCaretPos", "AFXWIN/CWnd::GetCheckedRadioButton", "AFXWIN/CWnd::GetClientRect", "AFXWIN/CWnd::GetClipboardOwner", "AFXWIN/CWnd::GetClipboardViewer", "AFXWIN/CWnd::GetControlUnknown", "AFXWIN/CWnd::GetDC", "AFXWIN/CWnd::GetDCEx", "AFXWIN/CWnd::GetDCRenderTarget", "AFXWIN/CWnd::GetDescendantWindow", "AFXWIN/CWnd::GetDesktopWindow", "AFXWIN/CWnd::GetDlgCtrlID", "AFXWIN/CWnd::GetDlgItem", "AFXWIN/CWnd::GetDlgItemInt", "AFXWIN/CWnd::GetDlgItemText", "AFXWIN/CWnd::GetDSCCursor", "AFXWIN/CWnd::GetDynamicLayout", "AFXWIN/CWnd::GetExStyle", "AFXWIN/CWnd::GetFocus", "AFXWIN/CWnd::GetFont", "AFXWIN/CWnd::GetForegroundWindow", "AFXWIN/CWnd::GetIcon", "AFXWIN/CWnd::GetLastActivePopup", "AFXWIN/CWnd::GetLayeredWindowAttributes", "AFXWIN/CWnd::GetMenu", "AFXWIN/CWnd::GetNextDlgGroupItem", "AFXWIN/CWnd::GetNextDlgTabItem", "AFXWIN/CWnd::GetNextWindow", "AFXWIN/CWnd::GetOleControlSite", "AFXWIN/CWnd::GetOpenClipboardWindow", "AFXWIN/CWnd::GetOwner", "AFXWIN/CWnd::GetParent", "AFXWIN/CWnd::GetParentFrame", "AFXWIN/CWnd::GetParentOwner", "AFXWIN/CWnd::GetProperty", "AFXWIN/CWnd::GetRenderTarget", "AFXWIN/CWnd::GetSafeHwnd", "AFXWIN/CWnd::GetSafeOwner", "AFXWIN/CWnd::GetScrollBarCtrl", "AFXWIN/CWnd::GetScrollBarInfo", "AFXWIN/CWnd::GetScrollInfo", "AFXWIN/CWnd::GetScrollLimit", "AFXWIN/CWnd::GetScrollPos", "AFXWIN/CWnd::GetScrollRange", "AFXWIN/CWnd::GetStyle", "AFXWIN/CWnd::GetSystemMenu", "AFXWIN/CWnd::GetTitleBarInfo", "AFXWIN/CWnd::GetTopLevelFrame", "AFXWIN/CWnd::GetTopLevelOwner", "AFXWIN/CWnd::GetTopLevelParent", "AFXWIN/CWnd::GetTopWindow", "AFXWIN/CWnd::GetUpdateRect", "AFXWIN/CWnd::GetUpdateRgn", "AFXWIN/CWnd::GetWindow", "AFXWIN/CWnd::GetWindowContextHelpId", "AFXWIN/CWnd::GetWindowDC", "AFXWIN/CWnd::GetWindowedChildCount", "AFXWIN/CWnd::GetWindowInfo", "AFXWIN/CWnd::GetWindowlessChildCount", "AFXWIN/CWnd::GetWindowPlacement", "AFXWIN/CWnd::GetWindowRect", "AFXWIN/CWnd::GetWindowRgn", "AFXWIN/CWnd::GetWindowText", "AFXWIN/CWnd::GetWindowTextLength", "AFXWIN/CWnd::HideCaret", "AFXWIN/CWnd::HiliteMenuItem", "AFXWIN/CWnd::HtmlHelp", "AFXWIN/CWnd::Invalidate", "AFXWIN/CWnd::InvalidateRect", "AFXWIN/CWnd::InvalidateRgn", "AFXWIN/CWnd::InvokeHelper", "AFXWIN/CWnd::IsChild", "AFXWIN/CWnd::IsD2DSupportEnabled", "AFXWIN/CWnd::IsDialogMessage", "AFXWIN/CWnd::IsDlgButtonChecked", "AFXWIN/CWnd::IsDynamicLayoutEnabled", "AFXWIN/CWnd::IsIconic", "AFXWIN/CWnd::IsTouchWindow", "AFXWIN/CWnd::IsWindowEnabled", "AFXWIN/CWnd::IsWindowVisible", "AFXWIN/CWnd::IsZoomed", "AFXWIN/CWnd::KillTimer", "AFXWIN/CWnd::LockWindowUpdate", "AFXWIN/CWnd::MapWindowPoints", "AFXWIN/CWnd::MessageBox", "AFXWIN/CWnd::ModifyStyle", "AFXWIN/CWnd::ModifyStyleEx", "AFXWIN/CWnd::MoveWindow", "AFXWIN/CWnd::NotifyWinEvent", "AFXWIN/CWnd::OnAmbientProperty", "AFXWIN/CWnd::OnDrawIconicThumbnailOrLivePreview", "AFXWIN/CWnd::OnHelp", "AFXWIN/CWnd::OnHelpFinder", "AFXWIN/CWnd::OnHelpIndex", "AFXWIN/CWnd::OnHelpUsing", "AFXWIN/CWnd::OnToolHitTest", "AFXWIN/CWnd::OpenClipboard", "AFXWIN/CWnd::PaintWindowlessControls", "AFXWIN/CWnd::PostMessage", "AFXWIN/CWnd::PreCreateWindow", "AFXWIN/CWnd::PreSubclassWindow", "AFXWIN/CWnd::PreTranslateMessage", "AFXWIN/CWnd::Print", "AFXWIN/CWnd::PrintClient", "AFXWIN/CWnd::PrintWindow", "AFXWIN/CWnd::RedrawWindow", "AFXWIN/CWnd::RegisterTouchWindow", "AFXWIN/CWnd::ReleaseDC", "AFXWIN/CWnd::RepositionBars", "AFXWIN/CWnd::RunModalLoop", "AFXWIN/CWnd::ScreenToClient", "AFXWIN/CWnd::ScrollWindow", "AFXWIN/CWnd::ScrollWindowEx", "AFXWIN/CWnd::SendChildNotifyLastMsg", "AFXWIN/CWnd::SendDlgItemMessage", "AFXWIN/CWnd::SendMessage", "AFXWIN/CWnd::SendMessageToDescendants", "AFXWIN/CWnd::SendNotifyMessage", "AFXWIN/CWnd::SetActiveWindow", "AFXWIN/CWnd::SetCapture", "AFXWIN/CWnd::SetCaretPos", "AFXWIN/CWnd::SetClipboardViewer", "AFXWIN/CWnd::SetDlgCtrlID", "AFXWIN/CWnd::SetDlgItemInt", "AFXWIN/CWnd::SetDlgItemText", "AFXWIN/CWnd::SetFocus", "AFXWIN/CWnd::SetFont", "AFXWIN/CWnd::SetForegroundWindow", "AFXWIN/CWnd::SetIcon", "AFXWIN/CWnd::SetLayeredWindowAttributes", "AFXWIN/CWnd::SetMenu", "AFXWIN/CWnd::SetOwner", "AFXWIN/CWnd::SetParent", "AFXWIN/CWnd::SetProperty", "AFXWIN/CWnd::SetRedraw", "AFXWIN/CWnd::SetScrollInfo", "AFXWIN/CWnd::SetScrollPos", "AFXWIN/CWnd::SetScrollRange", "AFXWIN/CWnd::SetTimer", "AFXWIN/CWnd::SetWindowContextHelpId", "AFXWIN/CWnd::SetWindowPlacement", "AFXWIN/CWnd::SetWindowPos", "AFXWIN/CWnd::SetWindowRgn", "AFXWIN/CWnd::SetWindowText", "AFXWIN/CWnd::ShowCaret", "AFXWIN/CWnd::ShowOwnedPopups", "AFXWIN/CWnd::ShowScrollBar", "AFXWIN/CWnd::ShowWindow", "AFXWIN/CWnd::SubclassDlgItem", "AFXWIN/CWnd::SubclassWindow", "AFXWIN/CWnd::UnlockWindowUpdate", "AFXWIN/CWnd::UnsubclassWindow", "AFXWIN/CWnd::UpdateData", "AFXWIN/CWnd::UpdateDialogControls", "AFXWIN/CWnd::UpdateLayeredWindow", "AFXWIN/CWnd::UpdateWindow", "AFXWIN/CWnd::ValidateRect", "AFXWIN/CWnd::ValidateRgn", "AFXWIN/CWnd::WindowFromPoint", "AFXWIN/CWnd::WinHelp", "AFXWIN/CWnd::Default", "AFXWIN/CWnd::DefWindowProc", "AFXWIN/CWnd::DoDataExchange", "AFXWIN/CWnd::GetCurrentMessage", "AFXWIN/CWnd::InitDynamicLayout", "AFXWIN/CWnd::LoadDynamicLayoutResource", "AFXWIN/CWnd::OnActivate", "AFXWIN/CWnd::OnActivateApp", "AFXWIN/CWnd::OnAppCommand", "AFXWIN/CWnd::OnAskCbFormatName", "AFXWIN/CWnd::OnCancelMode", "AFXWIN/CWnd::OnCaptureChanged", "AFXWIN/CWnd::OnChangeCbChain", "AFXWIN/CWnd::OnChangeUIState", "AFXWIN/CWnd::OnChar", "AFXWIN/CWnd::OnCharToItem", "AFXWIN/CWnd::OnChildActivate", "AFXWIN/CWnd::OnChildNotify", "AFXWIN/CWnd::OnClipboardUpdate", "AFXWIN/CWnd::OnClose", "AFXWIN/CWnd::OnColorizationColorChanged", "AFXWIN/CWnd::OnCommand", "AFXWIN/CWnd::OnCompacting", "AFXWIN/CWnd::OnCompareItem", "AFXWIN/CWnd::OnCompositionChanged", "AFXWIN/CWnd::OnContextMenu", "AFXWIN/CWnd::OnCopyData", "AFXWIN/CWnd::OnCreate", "AFXWIN/CWnd::OnCtlColor", "AFXWIN/CWnd::OnDeadChar", "AFXWIN/CWnd::OnDeleteItem", "AFXWIN/CWnd::OnDestroy", "AFXWIN/CWnd::OnDestroyClipboard", "AFXWIN/CWnd::OnDeviceChange", "AFXWIN/CWnd::OnDevModeChange", "AFXWIN/CWnd::OnDrawClipboard", "AFXWIN/CWnd::OnDrawItem", "AFXWIN/CWnd::OnDropFiles", "AFXWIN/CWnd::OnEnable", "AFXWIN/CWnd::OnEndSession", "AFXWIN/CWnd::OnEnterIdle", "AFXWIN/CWnd::OnEnterMenuLoop", "AFXWIN/CWnd::OnEnterSizeMove", "AFXWIN/CWnd::OnEraseBkgnd", "AFXWIN/CWnd::OnExitMenuLoop", "AFXWIN/CWnd::OnExitSizeMove", "AFXWIN/CWnd::OnFontChange", "AFXWIN/CWnd::OnGetDlgCode", "AFXWIN/CWnd::OnGetMinMaxInfo", "AFXWIN/CWnd::OnHelpInfo", "AFXWIN/CWnd::OnHotKey", "AFXWIN/CWnd::OnHScroll", "AFXWIN/CWnd::OnHScrollClipboard", "AFXWIN/CWnd::OnIconEraseBkgnd", "AFXWIN/CWnd::OnInitMenu", "AFXWIN/CWnd::OnInitMenuPopup", "AFXWIN/CWnd::OnInputDeviceChange", "AFXWIN/CWnd::OnInputLangChange", "AFXWIN/CWnd::OnInputLangChangeRequest", "AFXWIN/CWnd::OnKeyDown", "AFXWIN/CWnd::OnKeyUp", "AFXWIN/CWnd::OnKillFocus", "AFXWIN/CWnd::OnLButtonDblClk", "AFXWIN/CWnd::OnLButtonDown", "AFXWIN/CWnd::OnLButtonUp", "AFXWIN/CWnd::OnMButtonDblClk", "AFXWIN/CWnd::OnMButtonDown", "AFXWIN/CWnd::OnMButtonUp", "AFXWIN/CWnd::OnMDIActivate", "AFXWIN/CWnd::OnMeasureItem", "AFXWIN/CWnd::OnMenuChar", "AFXWIN/CWnd::OnMenuDrag", "AFXWIN/CWnd::OnMenuGetObject", "AFXWIN/CWnd::OnMenuRButtonUp", "AFXWIN/CWnd::OnMenuSelect", "AFXWIN/CWnd::OnMouseActivate", "AFXWIN/CWnd::OnMouseHover", "AFXWIN/CWnd::OnMouseHWheel", "AFXWIN/CWnd::OnMouseLeave", "AFXWIN/CWnd::OnMouseMove", "AFXWIN/CWnd::OnMouseWheel", "AFXWIN/CWnd::OnMove", "AFXWIN/CWnd::OnMoving", "AFXWIN/CWnd::OnNcActivate", "AFXWIN/CWnd::OnNcCalcSize", "AFXWIN/CWnd::OnNcCreate", "AFXWIN/CWnd::OnNcDestroy", "AFXWIN/CWnd::OnNcHitTest", "AFXWIN/CWnd::OnNcLButtonDblClk", "AFXWIN/CWnd::OnNcLButtonDown", "AFXWIN/CWnd::OnNcLButtonUp", "AFXWIN/CWnd::OnNcMButtonDblClk", "AFXWIN/CWnd::OnNcMButtonDown", "AFXWIN/CWnd::OnNcMButtonUp", "AFXWIN/CWnd::OnNcMouseHover", "AFXWIN/CWnd::OnNcMouseLeave", "AFXWIN/CWnd::OnNcMouseMove", "AFXWIN/CWnd::OnNcPaint", "AFXWIN/CWnd::OnNcRButtonDblClk", "AFXWIN/CWnd::OnNcRButtonDown", "AFXWIN/CWnd::OnNcRButtonUp", "AFXWIN/CWnd::OnNcRenderingChanged", "AFXWIN/CWnd::OnNcXButtonDblClk", "AFXWIN/CWnd::OnNcXButtonDown", "AFXWIN/CWnd::OnNcXButtonUp", "AFXWIN/CWnd::OnNextMenu", "AFXWIN/CWnd::OnNotify", "AFXWIN/CWnd::OnNotifyFormat", "AFXWIN/CWnd::OnPaint", "AFXWIN/CWnd::OnPaintClipboard", "AFXWIN/CWnd::OnPaletteChanged", "AFXWIN/CWnd::OnPaletteIsChanging", "AFXWIN/CWnd::OnParentNotify", "AFXWIN/CWnd::OnPowerBroadcast", "AFXWIN/CWnd::OnQueryDragIcon", "AFXWIN/CWnd::OnQueryEndSession", "AFXWIN/CWnd::OnQueryNewPalette", "AFXWIN/CWnd::OnQueryOpen", "AFXWIN/CWnd::OnQueryUIState", "AFXWIN/CWnd::OnRawInput", "AFXWIN/CWnd::OnRButtonDblClk", "AFXWIN/CWnd::OnRButtonDown", "AFXWIN/CWnd::OnRButtonUp", "AFXWIN/CWnd::OnRenderAllFormats", "AFXWIN/CWnd::OnRenderFormat", "AFXWIN/CWnd::OnSessionChange", "AFXWIN/CWnd::OnSetCursor", "AFXWIN/CWnd::OnSetFocus", "AFXWIN/CWnd::OnSettingChange", "AFXWIN/CWnd::OnShowWindow", "AFXWIN/CWnd::OnSize", "AFXWIN/CWnd::OnSizeClipboard", "AFXWIN/CWnd::OnSizing", "AFXWIN/CWnd::OnSpoolerStatus", "AFXWIN/CWnd::OnStyleChanged", "AFXWIN/CWnd::OnStyleChanging", "AFXWIN/CWnd::OnSysChar", "AFXWIN/CWnd::OnSysColorChange", "AFXWIN/CWnd::OnSysCommand", "AFXWIN/CWnd::OnSysDeadChar", "AFXWIN/CWnd::OnSysKeyDown", "AFXWIN/CWnd::OnSysKeyUp", "AFXWIN/CWnd::OnTCard", "AFXWIN/CWnd::OnTimeChange", "AFXWIN/CWnd::OnTimer", "AFXWIN/CWnd::OnTouchInput", "AFXWIN/CWnd::OnTouchInputs", "AFXWIN/CWnd::OnUniChar", "AFXWIN/CWnd::OnUnInitMenuPopup", "AFXWIN/CWnd::OnUpdateUIState", "AFXWIN/CWnd::OnUserChanged", "AFXWIN/CWnd::OnVKeyToItem", "AFXWIN/CWnd::OnVScroll", "AFXWIN/CWnd::OnVScrollClipboard", "AFXWIN/CWnd::OnWindowPosChanged", "AFXWIN/CWnd::OnWindowPosChanging", "AFXWIN/CWnd::OnWinIniChange", "AFXWIN/CWnd::OnWndMsg", "AFXWIN/CWnd::OnXButtonDblClk", "AFXWIN/CWnd::OnXButtonDown", "AFXWIN/CWnd::OnXButtonUp", "AFXWIN/CWnd::PostNcDestroy", "AFXWIN/CWnd::ReflectChildNotify", "AFXWIN/CWnd::ReflectLastMsg", "AFXWIN/CWnd::ResizeDynamicLayout", "AFXWIN/CWnd::WindowProc", "AFXWIN/CWnd::m_hWnd"] helpviewer_keywords: ["CWnd [MFC], CWnd", "CWnd [MFC], accDoDefaultAction", "CWnd [MFC], accHitTest", "CWnd [MFC], accLocation", "CWnd [MFC], accNavigate", "CWnd [MFC], accSelect", "CWnd [MFC], AnimateWindow", "CWnd [MFC], ArrangeIconicWindows", "CWnd [MFC], Attach", "CWnd [MFC], BeginModalState", "CWnd [MFC], BeginPaint", "CWnd [MFC], BindDefaultProperty", "CWnd [MFC], BindProperty", "CWnd [MFC], BringWindowToTop", "CWnd [MFC], CalcWindowRect", "CWnd [MFC], CancelToolTips", "CWnd [MFC], CenterWindow", "CWnd [MFC], ChangeClipboardChain", "CWnd [MFC], CheckDlgButton", "CWnd [MFC], CheckRadioButton", "CWnd [MFC], ChildWindowFromPoint", "CWnd [MFC], ClientToScreen", "CWnd [MFC], CloseWindow", "CWnd [MFC], ContinueModal", "CWnd [MFC], Create", "CWnd [MFC], CreateAccessibleProxy", "CWnd [MFC], CreateCaret", "CWnd [MFC], CreateControl", "CWnd [MFC], CreateEx", "CWnd [MFC], CreateGrayCaret", "CWnd [MFC], CreateSolidCaret", "CWnd [MFC], DeleteTempMap", "CWnd [MFC], DestroyWindow", "CWnd [MFC], Detach", "CWnd [MFC], DlgDirList", "CWnd [MFC], DlgDirListComboBox", "CWnd [MFC], DlgDirSelect", "CWnd [MFC], DlgDirSelectComboBox", "CWnd [MFC], DragAcceptFiles", "CWnd [MFC], DragDetect", "CWnd [MFC], DrawAnimatedRects", "CWnd [MFC], DrawCaption", "CWnd [MFC], DrawMenuBar", "CWnd [MFC], EnableActiveAccessibility", "CWnd [MFC], EnableDynamicLayout", "CWnd [MFC], EnableD2DSupport", "CWnd [MFC], EnableScrollBar", "CWnd [MFC], EnableScrollBarCtrl", "CWnd [MFC], EnableToolTips", "CWnd [MFC], EnableTrackingToolTips", "CWnd [MFC], EnableWindow", "CWnd [MFC], EndModalLoop", "CWnd [MFC], EndModalState", "CWnd [MFC], EndPaint", "CWnd [MFC], ExecuteDlgInit", "CWnd [MFC], FilterToolTipMessage", "CWnd [MFC], FindWindow", "CWnd [MFC], FindWindowEx", "CWnd [MFC], FlashWindow", "CWnd [MFC], FlashWindowEx", "CWnd [MFC], FromHandle", "CWnd [MFC], FromHandlePermanent", "CWnd [MFC], get_accChild", "CWnd [MFC], get_accChildCount", "CWnd [MFC], get_accDefaultAction", "CWnd [MFC], get_accDescription", "CWnd [MFC], get_accFocus", "CWnd [MFC], get_accHelp", "CWnd [MFC], get_accHelpTopic", "CWnd [MFC], get_accKeyboardShortcut", "CWnd [MFC], get_accName", "CWnd [MFC], get_accParent", "CWnd [MFC], get_accRole", "CWnd [MFC], get_accSelection", "CWnd [MFC], get_accState", "CWnd [MFC], get_accValue", "CWnd [MFC], GetActiveWindow", "CWnd [MFC], GetAncestor", "CWnd [MFC], GetCapture", "CWnd [MFC], GetCaretPos", "CWnd [MFC], GetCheckedRadioButton", "CWnd [MFC], GetClientRect", "CWnd [MFC], GetClipboardOwner", "CWnd [MFC], GetClipboardViewer", "CWnd [MFC], GetControlUnknown", "CWnd [MFC], GetDC", "CWnd [MFC], GetDCEx", "CWnd [MFC], GetDCRenderTarget", "CWnd [MFC], GetDescendantWindow", "CWnd [MFC], GetDesktopWindow", "CWnd [MFC], GetDlgCtrlID", "CWnd [MFC], GetDlgItem", "CWnd [MFC], GetDlgItemInt", "CWnd [MFC], GetDlgItemText", "CWnd [MFC], GetDSCCursor", "CWnd [MFC], GetDynamicLayout", "CWnd [MFC], GetExStyle", "CWnd [MFC], GetFocus", "CWnd [MFC], GetFont", "CWnd [MFC], GetForegroundWindow", "CWnd [MFC], GetIcon", "CWnd [MFC], GetLastActivePopup", "CWnd [MFC], GetLayeredWindowAttributes", "CWnd [MFC], GetMenu", "CWnd [MFC], GetNextDlgGroupItem", "CWnd [MFC], GetNextDlgTabItem", "CWnd [MFC], GetNextWindow", "CWnd [MFC], GetOleControlSite", "CWnd [MFC], GetOpenClipboardWindow", "CWnd [MFC], GetOwner", "CWnd [MFC], GetParent", "CWnd [MFC], GetParentFrame", "CWnd [MFC], GetParentOwner", "CWnd [MFC], GetProperty", "CWnd [MFC], GetRenderTarget", "CWnd [MFC], GetSafeHwnd", "CWnd [MFC], GetSafeOwner", "CWnd [MFC], GetScrollBarCtrl", "CWnd [MFC], GetScrollBarInfo", "CWnd [MFC], GetScrollInfo", "CWnd [MFC], GetScrollLimit", "CWnd [MFC], GetScrollPos", "CWnd [MFC], GetScrollRange", "CWnd [MFC], GetStyle", "CWnd [MFC], GetSystemMenu", "CWnd [MFC], GetTitleBarInfo", "CWnd [MFC], GetTopLevelFrame", "CWnd [MFC], GetTopLevelOwner", "CWnd [MFC], GetTopLevelParent", "CWnd [MFC], GetTopWindow", "CWnd [MFC], GetUpdateRect", "CWnd [MFC], GetUpdateRgn", "CWnd [MFC], GetWindow", "CWnd [MFC], GetWindowContextHelpId", "CWnd [MFC], GetWindowDC", "CWnd [MFC], GetWindowedChildCount", "CWnd [MFC], GetWindowInfo", "CWnd [MFC], GetWindowlessChildCount", "CWnd [MFC], GetWindowPlacement", "CWnd [MFC], GetWindowRect", "CWnd [MFC], GetWindowRgn", "CWnd [MFC], GetWindowText", "CWnd [MFC], GetWindowTextLength", "CWnd [MFC], HideCaret", "CWnd [MFC], HiliteMenuItem", "CWnd [MFC], HtmlHelp", "CWnd [MFC], Invalidate", "CWnd [MFC], InvalidateRect", "CWnd [MFC], InvalidateRgn", "CWnd [MFC], InvokeHelper", "CWnd [MFC], IsChild", "CWnd [MFC], IsD2DSupportEnabled", "CWnd [MFC], IsDialogMessage", "CWnd [MFC], IsDlgButtonChecked", "CWnd [MFC], IsDynamicLayoutEnabled", "CWnd [MFC], IsIconic", "CWnd [MFC], IsTouchWindow", "CWnd [MFC], IsWindowEnabled", "CWnd [MFC], IsWindowVisible", "CWnd [MFC], IsZoomed", "CWnd [MFC], KillTimer", "CWnd [MFC], LockWindowUpdate", "CWnd [MFC], MapWindowPoints", "CWnd [MFC], MessageBox", "CWnd [MFC], ModifyStyle", "CWnd [MFC], ModifyStyleEx", "CWnd [MFC], MoveWindow", "CWnd [MFC], NotifyWinEvent", "CWnd [MFC], OnAmbientProperty", "CWnd [MFC], OnDrawIconicThumbnailOrLivePreview", "CWnd [MFC], OnHelp", "CWnd [MFC], OnHelpFinder", "CWnd [MFC], OnHelpIndex", "CWnd [MFC], OnHelpUsing", "CWnd [MFC], OnToolHitTest", "CWnd [MFC], OpenClipboard", "CWnd [MFC], PaintWindowlessControls", "CWnd [MFC], PostMessage", "CWnd [MFC], PreCreateWindow", "CWnd [MFC], PreSubclassWindow", "CWnd [MFC], PreTranslateMessage", "CWnd [MFC], Print", "CWnd [MFC], PrintClient", "CWnd [MFC], PrintWindow", "CWnd [MFC], RedrawWindow", "CWnd [MFC], RegisterTouchWindow", "CWnd [MFC], ReleaseDC", "CWnd [MFC], RepositionBars", "CWnd [MFC], RunModalLoop", "CWnd [MFC], ScreenToClient", "CWnd [MFC], ScrollWindow", "CWnd [MFC], ScrollWindowEx", "CWnd [MFC], SendChildNotifyLastMsg", "CWnd [MFC], SendDlgItemMessage", "CWnd [MFC], SendMessage", "CWnd [MFC], SendMessageToDescendants", "CWnd [MFC], SendNotifyMessage", "CWnd [MFC], SetActiveWindow", "CWnd [MFC], SetCapture", "CWnd [MFC], SetCaretPos", "CWnd [MFC], SetClipboardViewer", "CWnd [MFC], SetDlgCtrlID", "CWnd [MFC], SetDlgItemInt", "CWnd [MFC], SetDlgItemText", "CWnd [MFC], SetFocus", "CWnd [MFC], SetFont", "CWnd [MFC], SetForegroundWindow", "CWnd [MFC], SetIcon", "CWnd [MFC], SetLayeredWindowAttributes", "CWnd [MFC], SetMenu", "CWnd [MFC], SetOwner", "CWnd [MFC], SetParent", "CWnd [MFC], SetProperty", "CWnd [MFC], SetRedraw", "CWnd [MFC], SetScrollInfo", "CWnd [MFC], SetScrollPos", "CWnd [MFC], SetScrollRange", "CWnd [MFC], SetTimer", "CWnd [MFC], SetWindowContextHelpId", "CWnd [MFC], SetWindowPlacement", "CWnd [MFC], SetWindowPos", "CWnd [MFC], SetWindowRgn", "CWnd [MFC], SetWindowText", "CWnd [MFC], ShowCaret", "CWnd [MFC], ShowOwnedPopups", "CWnd [MFC], ShowScrollBar", "CWnd [MFC], ShowWindow", "CWnd [MFC], SubclassDlgItem", "CWnd [MFC], SubclassWindow", "CWnd [MFC], UnlockWindowUpdate", "CWnd [MFC], UnsubclassWindow", "CWnd [MFC], UpdateData", "CWnd [MFC], UpdateDialogControls", "CWnd [MFC], UpdateLayeredWindow", "CWnd [MFC], UpdateWindow", "CWnd [MFC], ValidateRect", "CWnd [MFC], ValidateRgn", "CWnd [MFC], WindowFromPoint", "CWnd [MFC], WinHelp", "CWnd [MFC], Default", "CWnd [MFC], DefWindowProc", "CWnd [MFC], DoDataExchange", "CWnd [MFC], GetCurrentMessage", "CWnd [MFC], InitDynamicLayout", "CWnd [MFC], LoadDynamicLayoutResource", "CWnd [MFC], OnActivate", "CWnd [MFC], OnActivateApp", "CWnd [MFC], OnAppCommand", "CWnd [MFC], OnAskCbFormatName", "CWnd [MFC], OnCancelMode", "CWnd [MFC], OnCaptureChanged", "CWnd [MFC], OnChangeCbChain", "CWnd [MFC], OnChangeUIState", "CWnd [MFC], OnChar", "CWnd [MFC], OnCharToItem", "CWnd [MFC], OnChildActivate", "CWnd [MFC], OnChildNotify", "CWnd [MFC], OnClipboardUpdate", "CWnd [MFC], OnClose", "CWnd [MFC], OnColorizationColorChanged", "CWnd [MFC], OnCommand", "CWnd [MFC], OnCompacting", "CWnd [MFC], OnCompareItem", "CWnd [MFC], OnCompositionChanged", "CWnd [MFC], OnContextMenu", "CWnd [MFC], OnCopyData", "CWnd [MFC], OnCreate", "CWnd [MFC], OnCtlColor", "CWnd [MFC], OnDeadChar", "CWnd [MFC], OnDeleteItem", "CWnd [MFC], OnDestroy", "CWnd [MFC], OnDestroyClipboard", "CWnd [MFC], OnDeviceChange", "CWnd [MFC], OnDevModeChange", "CWnd [MFC], OnDrawClipboard", "CWnd [MFC], OnDrawItem", "CWnd [MFC], OnDropFiles", "CWnd [MFC], OnEnable", "CWnd [MFC], OnEndSession", "CWnd [MFC], OnEnterIdle", "CWnd [MFC], OnEnterMenuLoop", "CWnd [MFC], OnEnterSizeMove", "CWnd [MFC], OnEraseBkgnd", "CWnd [MFC], OnExitMenuLoop", "CWnd [MFC], OnExitSizeMove", "CWnd [MFC], OnFontChange", "CWnd [MFC], OnGetDlgCode", "CWnd [MFC], OnGetMinMaxInfo", "CWnd [MFC], OnHelpInfo", "CWnd [MFC], OnHotKey", "CWnd [MFC], OnHScroll", "CWnd [MFC], OnHScrollClipboard", "CWnd [MFC], OnIconEraseBkgnd", "CWnd [MFC], OnInitMenu", "CWnd [MFC], OnInitMenuPopup", "CWnd [MFC], OnInputDeviceChange", "CWnd [MFC], OnInputLangChange", "CWnd [MFC], OnInputLangChangeRequest", "CWnd [MFC], OnKeyDown", "CWnd [MFC], OnKeyUp", "CWnd [MFC], OnKillFocus", "CWnd [MFC], OnLButtonDblClk", "CWnd [MFC], OnLButtonDown", "CWnd [MFC], OnLButtonUp", "CWnd [MFC], OnMButtonDblClk", "CWnd [MFC], OnMButtonDown", "CWnd [MFC], OnMButtonUp", "CWnd [MFC], OnMDIActivate", "CWnd [MFC], OnMeasureItem", "CWnd [MFC], OnMenuChar", "CWnd [MFC], OnMenuDrag", "CWnd [MFC], OnMenuGetObject", "CWnd [MFC], OnMenuRButtonUp", "CWnd [MFC], OnMenuSelect", "CWnd [MFC], OnMouseActivate", "CWnd [MFC], OnMouseHover", "CWnd [MFC], OnMouseHWheel", "CWnd [MFC], OnMouseLeave", "CWnd [MFC], OnMouseMove", "CWnd [MFC], OnMouseWheel", "CWnd [MFC], OnMove", "CWnd [MFC], OnMoving", "CWnd [MFC], OnNcActivate", "CWnd [MFC], OnNcCalcSize", "CWnd [MFC], OnNcCreate", "CWnd [MFC], OnNcDestroy", "CWnd [MFC], OnNcHitTest", "CWnd [MFC], OnNcLButtonDblClk", "CWnd [MFC], OnNcLButtonDown", "CWnd [MFC], OnNcLButtonUp", "CWnd [MFC], OnNcMButtonDblClk", "CWnd [MFC], OnNcMButtonDown", "CWnd [MFC], OnNcMButtonUp", "CWnd [MFC], OnNcMouseHover", "CWnd [MFC], OnNcMouseLeave", "CWnd [MFC], OnNcMouseMove", "CWnd [MFC], OnNcPaint", "CWnd [MFC], OnNcRButtonDblClk", "CWnd [MFC], OnNcRButtonDown", "CWnd [MFC], OnNcRButtonUp", "CWnd [MFC], OnNcRenderingChanged", "CWnd [MFC], OnNcXButtonDblClk", "CWnd [MFC], OnNcXButtonDown", "CWnd [MFC], OnNcXButtonUp", "CWnd [MFC], OnNextMenu", "CWnd [MFC], OnNotify", "CWnd [MFC], OnNotifyFormat", "CWnd [MFC], OnPaint", "CWnd [MFC], OnPaintClipboard", "CWnd [MFC], OnPaletteChanged", "CWnd [MFC], OnPaletteIsChanging", "CWnd [MFC], OnParentNotify", "CWnd [MFC], OnPowerBroadcast", "CWnd [MFC], OnQueryDragIcon", "CWnd [MFC], OnQueryEndSession", "CWnd [MFC], OnQueryNewPalette", "CWnd [MFC], OnQueryOpen", "CWnd [MFC], OnQueryUIState", "CWnd [MFC], OnRawInput", "CWnd [MFC], OnRButtonDblClk", "CWnd [MFC], OnRButtonDown", "CWnd [MFC], OnRButtonUp", "CWnd [MFC], OnRenderAllFormats", "CWnd [MFC], OnRenderFormat", "CWnd [MFC], OnSessionChange", "CWnd [MFC], OnSetCursor", "CWnd [MFC], OnSetFocus", "CWnd [MFC], OnSettingChange", "CWnd [MFC], OnShowWindow", "CWnd [MFC], OnSize", "CWnd [MFC], OnSizeClipboard", "CWnd [MFC], OnSizing", "CWnd [MFC], OnSpoolerStatus", "CWnd [MFC], OnStyleChanged", "CWnd [MFC], OnStyleChanging", "CWnd [MFC], OnSysChar", "CWnd [MFC], OnSysColorChange", "CWnd [MFC], OnSysCommand", "CWnd [MFC], OnSysDeadChar", "CWnd [MFC], OnSysKeyDown", "CWnd [MFC], OnSysKeyUp", "CWnd [MFC], OnTCard", "CWnd [MFC], OnTimeChange", "CWnd [MFC], OnTimer", "CWnd [MFC], OnTouchInput", "CWnd [MFC], OnTouchInputs", "CWnd [MFC], OnUniChar", "CWnd [MFC], OnUnInitMenuPopup", "CWnd [MFC], OnUpdateUIState", "CWnd [MFC], OnUserChanged", "CWnd [MFC], OnVKeyToItem", "CWnd [MFC], OnVScroll", "CWnd [MFC], OnVScrollClipboard", "CWnd [MFC], OnWindowPosChanged", "CWnd [MFC], OnWindowPosChanging", "CWnd [MFC], OnWinIniChange", "CWnd [MFC], OnWndMsg", "CWnd [MFC], OnXButtonDblClk", "CWnd [MFC], OnXButtonDown", "CWnd [MFC], OnXButtonUp", "CWnd [MFC], PostNcDestroy", "CWnd [MFC], ReflectChildNotify", "CWnd [MFC], ReflectLastMsg", "CWnd [MFC], ResizeDynamicLayout", "CWnd [MFC], WindowProc", "CWnd [MFC], m_hWnd"] --- @@ -1024,7 +1024,8 @@ The `CWnd`* that is returned may be temporary and shouldn't be stored for later Converts the client coordinates of a given point or rectangle on the display to screen coordinates. ```cpp -void ClientToScreen(LPPOINT lpPoint) const; void ClientToScreen(LPRECT lpRect) const; +void ClientToScreen(LPPOINT lpPoint) const; +void ClientToScreen(LPRECT lpRect) const; ``` ### Parameters @@ -1245,7 +1246,7 @@ Points to a [`POINT` structure](/windows/win32/api/windef/ns-windef-point) or `C *`pSize`*
Points to a [`SIZE`](/windows/win32/api/windef/ns-windef-size) structure or `CSize` object that contains the control's size -*`pParentWnd*`
+*`pParentWnd`*
Specifies the control's parent window. It must not be `NULL`. *`nID`*
@@ -2319,7 +2320,7 @@ BOOL FlashWindowEx( ### Parameters -*`dwFlags*`
+*`dwFlags`*
Specifies the flash status. For a complete list of values, see the [`FLASHWINFO`](/windows/win32/api/winuser/ns-winuser-flashwinfo) structure. *`uCount`*
@@ -4107,7 +4108,7 @@ CWnd* GetWindow(UINT nCmd) const; ### Parameters -*`nCmd*`
+*`nCmd`*
Specifies the relationship between `CWnd` and the returned window. It can take one of the following values: - `GW_CHILD` Identifies the `CWnd` first child window. @@ -10174,7 +10175,8 @@ By default, `ContinueModal` returns `FALSE` after `EndModalLoop` is called. Retu Converts the screen coordinates of a given point or rectangle on the display to client coordinates. ```cpp -void ScreenToClient(LPPOINT lpPoint) const; void ScreenToClient(LPRECT lpRect) const; +void ScreenToClient(LPPOINT lpPoint) const; +void ScreenToClient(LPRECT lpRect) const; ``` ### Parameters diff --git a/docs/mfc/reference/data-types-mfc.md b/docs/mfc/reference/data-types-mfc.md index d1790212f18..9893062dab9 100644 --- a/docs/mfc/reference/data-types-mfc.md +++ b/docs/mfc/reference/data-types-mfc.md @@ -1,24 +1,22 @@ --- -description: "Learn more about: Data Types (MFC)" title: "Data Types (MFC)" -ms.date: "11/04/2016" +description: "Learn more about: Data Types (MFC)" +ms.date: 11/04/2016 f1_keywords: ["LPCRECT", "POSITION"] helpviewer_keywords: ["LPCRECT data type [MFC]", "WPARAM data type [MFC]", "data types [MFC], MFC", "LRESULT [MFC]", "POSITION data type [MFC]", "UINT [MFC]", "LPVOID data type [MFC]", "COLORREF [MFC]", "LPCTSTR [MFC]", "LPSTR [MFC]", "DWORD operator [MFC]", "WORD data type [MFC]", "LPTSTR [MFC]", "BYTE data type (Windows)", "Long data type [MFC], Windows types", "Boolean data type [MFC], supported data types", "LPARAM data type [MFC]", "LPCSTR [MFC]"] -ms.assetid: 8954848b-2c01-4a4f-abf5-ee55f6a05eeb --- # Data Types (MFC) -This topic lists the data types most commonly used in the Microsoft Foundation Class Library. Most of the data types are the same as those in the Platform Software Development Kit (SDK), while others are unique to MFC. - -For information about the data types used in both the Windows SDK and MFC, see [Windows Data Types](/windows/win32/WinProg/windows-data-types). +This topic lists the data types most commonly used in the Microsoft Foundation Class (MFC) Library. Most of the data types are the same as those in the Platform Software Development Kit (SDK), while others are unique to MFC. -Data types unique to the Microsoft Foundation Class Library include the following: +For information about the data types used in both the Windows SDK and MFC, see [Windows Data Types](/windows/win32/WinProg/windows-data-types). -- POSITION A value used to denote the position of an element in a collection; used by MFC collection classes. +Data types unique to MFC include the following: -- LPCRECT A 32-bit pointer to a constant (nonmodifiable) `RECT` structure. +- `POSITION` - A value used to denote the position of an element in a collection; used by MFC collection classes. +- `LPCRECT` - A 32-bit pointer to a constant (nonmodifiable) [`RECT`](/windows/win32/api/windef/ns-windef-rect) structure. ## See also -[Class Overview](../../mfc/class-library-overview.md)
-[Macros and Globals](../../mfc/reference/mfc-macros-and-globals.md) +[Class Overview](../class-library-overview.md)\ +[Macros and Globals](mfc-macros-and-globals.md) diff --git a/docs/mfc/reference/delegate-and-interface-maps.md b/docs/mfc/reference/delegate-and-interface-maps.md index f190e37f4ee..518e659915c 100644 --- a/docs/mfc/reference/delegate-and-interface-maps.md +++ b/docs/mfc/reference/delegate-and-interface-maps.md @@ -1,9 +1,8 @@ --- -description: "Learn more about: Delegate and interface map macros" title: "Delegate and Interface Map Macros (MFC)" -ms.date: "03/30/2017" +description: "Learn more about: Delegate and interface map macros" +ms.date: 03/30/2017 helpviewer_keywords: ["delegate map macros [MFC]", "event map macros [MFC]", "interface map macros [MFC]"] -ms.assetid: 3840e642-ff7d-4bdc-998b-c7d8fc50890e --- # Delegate and interface map macros @@ -215,8 +214,10 @@ INTERFACE_PART( theClass, iid, localClass) *theClass*
The name of the class that contains the interface map. + *iid*
The IID that is to be mapped to the embedded class. + *localClass*
The name of the local class. diff --git a/docs/mfc/reference/diagnostic-services.md b/docs/mfc/reference/diagnostic-services.md index 7bd4aab5395..235d76280b4 100644 --- a/docs/mfc/reference/diagnostic-services.md +++ b/docs/mfc/reference/diagnostic-services.md @@ -1,9 +1,8 @@ --- -description: "Learn more about: Diagnostic Services" title: "Diagnostic Services" +description: "Learn more about: Diagnostic Services" ms.date: 06/29/2022 helpviewer_keywords: ["diagnosi [MFC]s, diagnostic services", "diagnostic macros [MFC], list of general MFC", "services [MFC], diagnostic", "MFC, diagnostic services", "general diagnostic functions and variables [MFC]", "diagnostics [MFC], diagnostic functions and variables", "diagnostics [MFC], list of general MFC", "diagnosis [MFC], diagnostic functions and variables", "diagnosis [MFC], list of general MFC", "general diagnostic macros in MFC", "diagnostic macros [MFC]", "diagnostic services [MFC]", "object diagnostic functions in MFC", "diagnostics [MFC], diagnostic services", "diagnostic functions and variables [MFC]"] -ms.assetid: 8d78454f-9fae-49c2-88c9-d3fabd5393e8 --- # Diagnostic Services @@ -77,7 +76,7 @@ Suppresses compiler warnings for the use of deprecated MFC functions. ### Syntax -``` +```cpp _AFX_SECURE_NO_WARNINGS ``` @@ -105,7 +104,7 @@ Call this function to cause a break (at the location of the call to `AfxDebugBre ### Syntax ```cpp -void AfxDebugBreak( ); +void AfxDebugBreak(); ``` ### Remarks @@ -120,13 +119,13 @@ void AfxDebugBreak( ); Evaluates its argument. -``` +```cpp ASSERT(booleanExpression) ``` ### Parameters -*booleanExpression*
+*booleanExpression*\ Specifies an expression (including pointer values) that evaluates to nonzero or 0. ### Remarks @@ -156,16 +155,16 @@ In the Release version of MFC, ASSERT does not evaluate the expression and thus This macro asserts that the object pointed to is an object of the specified class, or is an object of a class derived from the specified class. -``` +```cpp ASSERT_KINDOF(classname, pobject) ``` ### Parameters -*classname*
+*classname*\ The name of a `CObject`-derived class. -*pobject*
+*pobject*\ A pointer to a class object. ### Remarks @@ -178,7 +177,7 @@ Using the `ASSERT_KINDOF` macro is exactly the same as coding: [!code-cpp[NVC_MFCDocView#195](../../mfc/codesnippet/cpp/diagnostic-services_4.cpp)] -This function works only for classes declared with the [DECLARE_DYNAMIC](run-time-object-model-services.md#declare_dynamic or [DECLARE_SERIAL](run-time-object-model-services.md#declare_serial) macro. +This function works only for classes declared with the [DECLARE_DYNAMIC](run-time-object-model-services.md#declare_dynamic) or [DECLARE_SERIAL](run-time-object-model-services.md#declare_serial) macro. > [!NOTE] > This function is available only in the Debug version of MFC. @@ -191,13 +190,13 @@ This function works only for classes declared with the [DECLARE_DYNAMIC](run-tim Use to test your assumptions about the validity of an object's internal state. -``` +```cpp ASSERT_VALID(pObject) ``` ### Parameters -*pObject*
+*pObject*\ Specifies an object of a class derived from `CObject` that has an overriding version of the `AssertValid` member function. ### Remarks @@ -223,8 +222,8 @@ For more information and examples, see [Debugging MFC Applications](/visualstudi Assists in finding memory leaks. -``` -#define new DEBUG_NEW +```cpp +#define new DEBUG_NEW ``` ### Remarks @@ -250,7 +249,7 @@ Once you insert this directive, the preprocessor will insert DEBUG_NEW wherever In debug mode (when the **_DEBUG** symbol is defined), DEBUG_ONLY evaluates its argument. -``` +```cpp DEBUG_ONLY(expression) ``` @@ -274,14 +273,14 @@ Use to validate data correctness. ### Syntax -``` -ENSURE( booleanExpression ) -ENSURE_VALID( booleanExpression ) +```cpp +ENSURE(booleanExpression) +ENSURE_VALID(booleanExpression) ``` ### Parameters -*booleanExpression*
+*booleanExpression*\ Specifies a boolean expression to be tested. ### Remarks @@ -306,7 +305,7 @@ Expands to the name of the file that is being compiled. ### Syntax -``` +```cpp THIS_FILE ``` @@ -334,9 +333,9 @@ static char THIS_FILE[] = __FILE__; Sends the specified string to the debugger of the current application. -``` +```cpp TRACE(exp) -TRACE(DWORD category, UINT level, LPCSTR lpszFormat, ...) +TRACE(DWORD category, UINT level, LPCSTR lpszFormat, ...) ``` ### Remarks @@ -355,13 +354,13 @@ For more information, see [Debugging MFC Applications](/visualstudio/debugger/mf In the Debug version of MFC, evaluates its argument. -``` +```cpp VERIFY(booleanExpression) ``` ### Parameters -*booleanExpression*
+*booleanExpression*\ Specifies an expression (including pointer values) that evaluates to nonzero or 0. ### Remarks @@ -388,15 +387,15 @@ In the Release version of MFC, VERIFY evaluates the expression but does not prin Provides basic object-dumping capability in your application. -``` -CDumpContext afxDump; +```cpp +CDumpContext afxDump; ``` ### Remarks `afxDump` is a predefined [CDumpContext](../../mfc/reference/cdumpcontext-class.md) object that allows you to send `CDumpContext` information to the debugger output window or to a debug terminal. Typically, you supply `afxDump` as a parameter to `CObject::Dump`. -Under Windows NT and all versions of Windows, `afxDump` output is sent to the Output-Debug window of Visual C++ when you debug your application. +Under Windows NT and all versions of Windows, `afxDump` output is sent to the Output-Debug window of Visual Studio when you debug your application. This variable is defined only in the Debug version of MFC. For more information on `afxDump`, see [Debugging MFC Applications](/visualstudio/debugger/mfc-debugging-techniques). @@ -420,7 +419,7 @@ void AfxDump(const CObject* pOb); ### Parameters -*pOb*
+*pOb*\ A pointer to an object of a class derived from `CObject`. ### Remarks @@ -437,8 +436,8 @@ Your program code should not call `AfxDump`, but should instead call the `Dump` This variable is accessible from a debugger or your program and allows you to tune allocation diagnostics. -``` -int afxMemDF; +```cpp +int afxMemDF; ``` ### Remarks @@ -490,8 +489,8 @@ This function can be used to check the return values of calls to OLE functions i This function validates the free memory pool and prints error messages as required. -``` -BOOL AfxCheckMemory(); +```cpp +BOOL AfxCheckMemory(); ``` ### Return Value @@ -533,7 +532,7 @@ void AfxDump(const CObject* pOb); ### Parameters -*pOb*
+*pOb*\ A pointer to an object of a class derived from `CObject`. ### Remarks @@ -556,7 +555,7 @@ void AFXAPI AfxDumpStack(DWORD dwTarget = AFX_STACK_DUMP_TARGET_DEFAULT); ### Parameters -*dwTarget*
+*dwTarget*\ Indicates the target of the dump output. Possible values, which can be combined using the bitwise-OR (**`|`**) operator, are as follows: - AFX_STACK_DUMP_TARGET_TRACE Sends output by means of the [TRACE](#trace) macro. The TRACE macro generates output in debug builds only; it generates no output in release builds. Also, TRACE can be redirected to other targets besides the debugger. @@ -626,13 +625,13 @@ To use this function successfully: Enables and disables the memory leak dump in the AFX_DEBUG_STATE destructor. -``` +```cpp BOOL AFXAPI AfxEnableMemoryLeakDump(BOOL bDump); ``` ### Parameters -*bDump*
+*bDump*\ [in] TRUE indicates the memory leak dump is enabled; FALSE indicates the memory leak dump is disabled. ### Return Value @@ -656,13 +655,13 @@ If your application loads another library before the MFC library, some memory al Diagnostic memory tracking is normally enabled in the Debug version of MFC. -``` +```cpp BOOL AfxEnableMemoryTracking(BOOL bTrack); ``` ### Parameters -*bTrack*
+*bTrack*\ Setting this value to TRUE turns on memory tracking; FALSE turns it off. ### Return Value @@ -690,7 +689,7 @@ For more information on `AfxEnableMemoryTracking`, see [Debugging MFC Applicatio Tests a memory address to make sure it represents a currently active memory block that was allocated by the diagnostic version of **`new`**. -``` +```cpp BOOL AfxIsMemoryBlock( const void* p, UINT nBytes, @@ -699,13 +698,13 @@ BOOL AfxIsMemoryBlock( ### Parameters -*p*
+*p*\ Points to the block of memory to be tested. -*nBytes*
+*nBytes*\ Contains the length of the memory block in bytes. -*plRequestNumber*
+*plRequestNumber*\ Points to a **`long`** integer that will be filled in with the memory block's allocation sequence number, or zero if it does not represent a currently active memory block. ### Return Value @@ -728,7 +727,7 @@ It also checks the specified size against the original allocated size. If the fu Tests any memory address to ensure that it is contained entirely within the program's memory space. -``` +```cpp BOOL AfxIsValidAddress( const void* lp, UINT nBytes, @@ -737,13 +736,13 @@ BOOL AfxIsValidAddress( ### Parameters -*lp*
+*lp*\ Points to the memory address to be tested. -*nBytes*
+*nBytes*\ Contains the number of bytes of memory to be tested. -*bReadWrite*
+*bReadWrite*\ Specifies whether the memory is both for reading and writing (TRUE) or just reading (FALSE). ### Return Value @@ -768,18 +767,18 @@ The address is not restricted to blocks allocated by **`new`**. Use this function to determine whether a pointer to a string is valid. -``` -BOOL AfxIsValidString( +```cpp +BOOL AfxIsValidString( LPCSTR lpsz, int nLength = -1); ``` ### Parameters -*lpsz*
+*lpsz*\ The pointer to test. -*nLength*
+*nLength*\ Specifies the length of the string to be tested, in bytes. A value of -1 indicates that the string will be null-terminated. ### Return Value @@ -800,13 +799,13 @@ In non-debug builds, nonzero if *lpsz* is not NULL; otherwise 0. Sets a hook that enables calling of the specified function before each memory block is allocated. -``` +```cpp AFX_ALLOC_HOOK AfxSetAllocHook(AFX_ALLOC_HOOK pfnAllocHook); ``` ### Parameters -*pfnAllocHook*
+*pfnAllocHook*\ Specifies the name of the function to call. See the Remarks for the prototype of an allocation function. ### Return Value @@ -819,13 +818,13 @@ The Microsoft Foundation Class Library debug-memory allocator can call a user-de **BOOL AFXAPI AllocHook( size_t** `nSize`**, BOOL** `bObject`**, LONG** `lRequestNumber` **);** -*nSize*
+*nSize*\ The size of the proposed memory allocation. -*bObject*
+*bObject*\ TRUE if the allocation is for a `CObject`-derived object; otherwise FALSE. -*lRequestNumber*
+*lRequestNumber*\ The memory allocation's sequence number. Note that the AFXAPI calling convention implies that the callee must remove the parameters from the stack. @@ -847,10 +846,10 @@ AFXAPI AfxDoForAllClasses( ### Parameters -*pfn*
+*pfn*\ Points to an iteration function to be called for each class. The function arguments are a pointer to a `CRuntimeClass` object and a void pointer to extra data that the caller supplies to the function. -*pContext*
+*pContext*\ Points to optional data that the caller can supply to the iteration function. This pointer can be NULL. ### Remarks @@ -882,10 +881,10 @@ void AfxDoForAllObjects( ### Parameters -*pfn*
+*pfn*\ Points to an iteration function to execute for each object. The function arguments are a pointer to a `CObject` and a void pointer to extra data that the caller supplies to the function. -*pContext*
+*pContext*\ Points to optional data that the caller can supply to the iteration function. This pointer can be NULL. ### Remarks @@ -903,5 +902,5 @@ Stack, global, or embedded objects are not enumerated. The pointer passed to `Af ## See also -[Macros and Globals](mfc-macros-and-globals.md)
+[Macros and Globals](mfc-macros-and-globals.md)\ [CObject::Dump](cobject-class.md#dump) diff --git a/docs/mfc/reference/event-sink-maps.md b/docs/mfc/reference/event-sink-maps.md index bfaaba81ce9..e1475a88c77 100644 --- a/docs/mfc/reference/event-sink-maps.md +++ b/docs/mfc/reference/event-sink-maps.md @@ -1,9 +1,8 @@ --- -description: "Learn more about: Event Sink Maps" title: "Event Sink Maps" -ms.date: "11/04/2016" +description: "Learn more about: Event Sink Maps" +ms.date: 11/04/2016 helpviewer_keywords: ["event sink maps [MFC]"] -ms.assetid: a9757eb2-5f4a-45ec-a2cd-ce5eec85b16f --- # Event Sink Maps @@ -158,7 +157,7 @@ For a list of the **VTS_** constants, see [EVENT_CUSTOM](event-maps.md#event_cus ### Example -The following example demonstrates an event handler, for the MouseDown event, implemented for three controls ( IDC_MYCTRL1 through IDC_MYCTRL3). The event handler function, `OnRangeMouseDown`, is declared in the header file of the dialog class ( `CMyDlg`) as: +The following example demonstrates an event handler, for the MouseDown event, implemented for three controls ( IDC_MYCTRL1 through IDC_MYCTRL3). The event handler function, `OnRangeMouseDown`, is declared in the header file of the dialog class (`CMyDlg`) as: [!code-cpp[NVC_MFCAutomation#12](../../mfc/codesnippet/cpp/event-sink-maps_2.h)] diff --git a/docs/mfc/reference/icommandsource-interface.md b/docs/mfc/reference/icommandsource-interface.md index b75c703c395..80fd3391887 100644 --- a/docs/mfc/reference/icommandsource-interface.md +++ b/docs/mfc/reference/icommandsource-interface.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: ICommandSource Interface" title: "ICommandSource Interface" -ms.date: "03/27/2019" +description: "Learn more about: ICommandSource Interface" +ms.date: 03/27/2019 f1_keywords: ["ICommandSource", "AFXWINFORMS/ICommandSource", "AFXWINFORMS/ICommandSource::AddCommandHandler", "AFXWINFORMS/ICommandSource::AddCommandRangeHandler", "AFXWINFORMS/ICommandSource::AddCommandRangeUIHandler", "AFXWINFORMS/ICommandSource::AddCommandUIHandler", "AFXWINFORMS/ICommandSource::PostCommand", "AFXWINFORMS/ICommandSource::RemoveCommandHandler", "AFXWINFORMS/ICommandSource::RemoveCommandRangeHandler", "AFXWINFORMS/ICommandSource::RemoveCommandRangeUIHandler", "AFXWINFORMS/ICommandSource::RemoveCommandUIHandler", "AFXWINFORMS/ICommandSource::SendCommand"] helpviewer_keywords: ["ICommandSource interface [MFC]"] -ms.assetid: a4b1f698-c09f-4ba8-9b13-0e74a0a4967e --- # ICommandSource Interface @@ -59,6 +58,7 @@ void AddCommandHandler( *cmdID*
The command ID. + *cmdHandler*
A handle to the command handler method. @@ -82,8 +82,10 @@ void AddCommandRangeHandler( *cmdIDMin*
The beginning index of the command ID range. + *cmdIDMax*
The ending index of the command ID range. + *cmdHandler*
A handle to the message handler method to which the commands are mapped. @@ -106,8 +108,10 @@ void AddCommandRangeUIHandler( *cmdIDMin*
The beginning index of the command ID range. + *cmdIDMax*
The ending index of the command ID range. + *cmdHandler*
A handle to the message handler method to which the commands are mapped. @@ -129,6 +133,7 @@ void AddCommandUIHandler( *cmdID*
The command ID. + *cmdUIHandler*
A handle to the user interface command message handler method. @@ -184,6 +189,7 @@ void RemoveCommandRangeUIHandler( *cmdIDMin*
The beginning index of the command ID range. + *cmdIDMax*
The ending index of the command ID range. @@ -205,6 +211,7 @@ void RemoveCommandRangeUIHandler( *cmdIDMin*
The beginning index of the command ID range. + *cmdIDMax*
The ending index of the command ID range. diff --git a/docs/mfc/reference/mfc-application-wizard.md b/docs/mfc/reference/mfc-application-wizard.md index 81d79ea6b6e..1ca347b8771 100644 --- a/docs/mfc/reference/mfc-application-wizard.md +++ b/docs/mfc/reference/mfc-application-wizard.md @@ -68,7 +68,7 @@ This wizard page describes the current application settings for the MFC applicat To change these default settings, select the appropriate tab title in the left column of the wizard and make the changes on the page that appears. -After you create an MFC application project, you can add objects or controls to your project using Visual C++ [code wizards](../../ide/adding-functionality-with-code-wizards-cpp.md). +After you create an MFC application project, you can add objects or controls to your project using Visual Studio [code wizards](../../ide/adding-functionality-with-code-wizards-cpp.md). ## See also diff --git a/docs/mfc/reference/mfc-classes.md b/docs/mfc/reference/mfc-classes.md index 4989897e483..8389dcd7e55 100644 --- a/docs/mfc/reference/mfc-classes.md +++ b/docs/mfc/reference/mfc-classes.md @@ -1,9 +1,8 @@ --- -description: "Learn more about: MFC` Classes" -title: "MFC` Classes" -ms.date: "11/04/2016" +title: "MFC Classes" +description: "Learn more about: MFC Classes" +ms.date: 11/04/2016 helpviewer_keywords: ["MFC, classes", "classes [MFC], MFC"] -ms.assetid: 7b6db805-a572-43fd-9046-0fa6e3663e63 --- # MFC Classes @@ -17,1285 +16,1285 @@ The classes in the following list are included in the Microsoft Foundation Class ## In This Section -[`CAccelerateDecelerateTransition` Class](../../mfc/reference/cacceleratedeceleratetransition-class.md)
+[`CAccelerateDecelerateTransition` Class](cacceleratedeceleratetransition-class.md)\ Implements an accelerate-decelerate transition. -[`CAnimateCtrl` Class](../../mfc/reference/canimatectrl-class.md)
+[`CAnimateCtrl` Class](canimatectrl-class.md)\ Provides the functionality of the Windows common animation control. -[`CAnimationBaseObject` Class](../../mfc/reference/canimationbaseobject-class.md)
+[`CAnimationBaseObject` Class](canimationbaseobject-class.md)\ The base class for all animation objects. -[`CAnimationColor` Class](../../mfc/reference/canimationcolor-class.md)
+[`CAnimationColor` Class](canimationcolor-class.md)\ Implements the functionality of a color whose red, green, and blue components can be animated. -[`CAnimationController` Class](../../mfc/reference/canimationcontroller-class.md)
+[`CAnimationController` Class](canimationcontroller-class.md)\ Implements the animation controller, which provides a central interface for creating and managing animations. -[`CAnimationGroup` Class](../../mfc/reference/canimationgroup-class.md)
+[`CAnimationGroup` Class](canimationgroup-class.md)\ Implements the animation controller, which provides a central interface for creating and managing animations. -[`CAnimationManagerEventHandler` Class](../../mfc/reference/canimationmanagereventhandler-class.md)
+[`CAnimationManagerEventHandler` Class](canimationmanagereventhandler-class.md)\ Implements a callback, which is called by the Animation API when a status of an animation manager is changed. -[`CAnimationPoint` Class](../../mfc/reference/canimationpoint-class.md)
+[`CAnimationPoint` Class](canimationpoint-class.md)\ Implements the functionality of a point whose coordinates can be animated. -[`CAnimationRect` Class](../../mfc/reference/canimationrect-class.md)
+[`CAnimationRect` Class](canimationrect-class.md)\ Implements the functionality of a rectangle whose sides can be animated. -[`CAnimationSize` Class](../../mfc/reference/canimationsize-class.md)
+[`CAnimationSize` Class](canimationsize-class.md)\ Implements the functionality of a size object whose dimensions can be animated. -[`CAnimationStoryboardEventHandler` Class](../../mfc/reference/canimationstoryboardeventhandler-class.md)
+[`CAnimationStoryboardEventHandler` Class](canimationstoryboardeventhandler-class.md)\ Implements a callback, which is called by the Animation API when the status of a storyboard is changed or a storyboard is updated. -[`CAnimationTimerEventHandler` Class](../../mfc/reference/canimationtimereventhandler-class.md)
+[`CAnimationTimerEventHandler` Class](canimationtimereventhandler-class.md)\ Implements a callback, which is called by the Animation API when timing events occur. -[`CAnimationValue` Class](../../mfc/reference/canimationvalue-class.md)
+[`CAnimationValue` Class](canimationvalue-class.md)\ Implements the functionality of animation object that has one value. -[`CAnimationVariable` Class](../../mfc/reference/canimationvariable-class.md)
+[`CAnimationVariable` Class](canimationvariable-class.md)\ Represents an animation variable. -[`CAnimationVariableChangeHandler` Class](../../mfc/reference/canimationvariablechangehandler-class.md)
+[`CAnimationVariableChangeHandler` Class](canimationvariablechangehandler-class.md)\ Implements a callback, which is called by the Animation API when the value of an animation variable changes. -[`CAnimationVariableIntegerChangeHandler` Class](../../mfc/reference/canimationvariableintegerchangehandler-class.md)
+[`CAnimationVariableIntegerChangeHandler` Class](canimationvariableintegerchangehandler-class.md)\ Implements a callback, which is called by the Animation API when the value of an animation variable changes. -[`CArchive` Class](../../mfc/reference/carchive-class.md)
+[`CArchive` Class](carchive-class.md)\ Lets you save a complex network of objects in a permanent binary form (usually disk storage) that persists after those objects are deleted. -[`CArchiveException` Class](../../mfc/reference/carchiveexception-class.md)
+[`CArchiveException` Class](carchiveexception-class.md)\ Represents a serialization exception condition. -[`CArray` Class](../../mfc/reference/carray-class.md)
-Supports arrays that resemble` C arrays, but can dynamically reduce and grow as necessary. +[`CArray` Class](carray-class.md)\ +Supports arrays that resemble C arrays, but can dynamically reduce and grow as necessary. -[`CAsyncMonikerFile` Class](../../mfc/reference/casyncmonikerfile-class.md)
+[`CAsyncMonikerFile` Class](casyncmonikerfile-class.md)\ Provides functionality for the use of asynchronous monikers in ActiveX controls (formerly OLE controls). -[`CAsyncSocket` Class](../../mfc/reference/casyncsocket-class.md)
+[`CAsyncSocket` Class](casyncsocket-class.md)\ Represents a Windows Socket, which is an endpoint of network communication. -[`CAutoHideDockSite` Class](../../mfc/reference/cautohidedocksite-class.md)
-Extends the [`CDockSite` Class](../../mfc/reference/cdocksite-class.md) to implement auto-hide dock panes. +[`CAutoHideDockSite` Class](cautohidedocksite-class.md)\ +Extends the [`CDockSite` Class](cdocksite-class.md) to implement auto-hide dock panes. -[`CBaseKeyFrame` Class](../../mfc/reference/cbasekeyframe-class.md)
+[`CBaseKeyFrame` Class](cbasekeyframe-class.md)\ Implements the basic functionality of a keyframe. -[`CBasePane` Class](../../mfc/reference/cbasepane-class.md)
+[`CBasePane` Class](cbasepane-class.md)\ Base class for all panes. -[`CBaseTabbedPane` Class](../../mfc/reference/cbasetabbedpane-class.md)
-Extends the functionality of the [`CDockablePane` Class](../../mfc/reference/cdockablepane-class.md) to support the creation of tabbed windows. +[`CBaseTabbedPane` Class](cbasetabbedpane-class.md)\ +Extends the functionality of the [`CDockablePane` Class](cdockablepane-class.md) to support the creation of tabbed windows. -[`CBaseTransition` Class](../../mfc/reference/cbasetransition-class.md)
+[`CBaseTransition` Class](cbasetransition-class.md)\ Represents a basic transition. -[`CBitmap` Class](../../mfc/reference/cbitmap-class.md)
+[`CBitmap` Class](cbitmap-class.md)\ Encapsulates a Windows graphics device interface (GDI) bitmap and provides member functions to manipulate the bitmap. -[`CBitmapButton` Class](../../mfc/reference/cbitmapbutton-class.md)
+[`CBitmapButton` Class](cbitmapbutton-class.md)\ Creates pushbutton controls labeled with bitmapped images instead of text. -[`CBitmapRenderTarget` Class](../../mfc/reference/cbitmaprendertarget-class.md)
+[`CBitmapRenderTarget` Class](cbitmaprendertarget-class.md)\ A wrapper for `ID2D1BitmapRenderTarget`. -[`CBrush` Class](../../mfc/reference/cbrush-class.md)
+[`CBrush` Class](cbrush-class.md)\ Encapsulates a Windows graphics device interface (GDI) brush. -[`CButton` Class](../../mfc/reference/cbutton-class.md)
+[`CButton` Class](cbutton-class.md)\ Provides the functionality of Windows button controls. -[`CByteArray` Class](../../mfc/reference/cbytearray-class.md)
+[`CByteArray` Class](cbytearray-class.md)\ Supports dynamic arrays of bytes. -[`CCachedDataPathProperty` Class](../../mfc/reference/ccacheddatapathproperty-class.md)
+[`CCachedDataPathProperty` Class](ccacheddatapathproperty-class.md)\ Implements an OLE control property transferred asynchronously and cached in a memory file. -[`CCheckListBox` Class](../../mfc/reference/cchecklistbox-class.md)
+[`CCheckListBox` Class](cchecklistbox-class.md)\ Provides the functionality of a Windows checklist box. -[`CClientDC` Class](../../mfc/reference/cclientdc-class.md)
+[`CClientDC` Class](cclientdc-class.md)\ Handles the calling of the Windows functions [`GetDC`](/windows/win32/api/winuser/nf-winuser-getdc) at construction time and [`ReleaseDC`](/windows/win32/api/winuser/nf-winuser-releasedc) at destruction time. -[`CCmdTarget` Class](../../mfc/reference/ccmdtarget-class.md)
+[`CCmdTarget` Class](ccmdtarget-class.md)\ Base class for the Microsoft Foundation Class Library message-map architecture. -[`CCmdUI` Class](../../mfc/reference/ccmdui-class.md)
+[`CCmdUI` Class](ccmdui-class.md)\ Used only within an `ON_UPDATE_COMMAND_UI` handler in a `CCmdTarget`-derived class. -[`CColorDialog` Class](../../mfc/reference/ccolordialog-class.md)
+[`CColorDialog` Class](ccolordialog-class.md)\ Lets you incorporate a color-selection dialog box into your application. -[`CComboBox` Class](../../mfc/reference/ccombobox-class.md)
+[`CComboBox` Class](ccombobox-class.md)\ Provides the functionality of a Windows combo box. -[`CComboBoxEx` Class](../../mfc/reference/ccomboboxex-class.md)
+[`CComboBoxEx` Class](ccomboboxex-class.md)\ Extends the combo box control by providing support for image lists. -[`CCommandLineInfo` Class](../../mfc/reference/ccommandlineinfo-class.md)
+[`CCommandLineInfo` Class](ccommandlineinfo-class.md)\ Aids in parsing the command line at application startup. -[`CCommonDialog` Class](../../mfc/reference/ccommondialog-class.md)
+[`CCommonDialog` Class](ccommondialog-class.md)\ The base class for classes that encapsulate functionality of the Windows common dialogs. -[`CConnectionPoint` Class](../../mfc/reference/cconnectionpoint-class.md)
+[`CConnectionPoint` Class](cconnectionpoint-class.md)\ Defines a special type of interface used to communicate with other OLE objects, called a "connection point." -[`CConstantTransition` Class](../../mfc/reference/cconstanttransition-class.md)
+[`CConstantTransition` Class](cconstanttransition-class.md)\ Encapsulates a constant transition. -[`CContextMenuManager` Class](../../mfc/reference/ccontextmenumanager-class.md)
+[`CContextMenuManager` Class](ccontextmenumanager-class.md)\ Manages shortcut menus, also known as context menus. -[`CControlBar` Class](../../mfc/reference/ccontrolbar-class.md)
-Base class for the control-bar classes [`CStatusBar` Class](../../mfc/reference/cstatusbar-class.md), [`CToolBar` Class](../../mfc/reference/ctoolbar-class.md), [`CDialogBar` Class](../../mfc/reference/cdialogbar-class.md), [`CReBar` Class](../../mfc/reference/crebar-class.md), and [`COleResizeBar` Class](../../mfc/reference/coleresizebar-class.md). +[`CControlBar` Class](ccontrolbar-class.md)\ +Base class for the control-bar classes [`CStatusBar` Class](cstatusbar-class.md), [`CToolBar` Class](ctoolbar-class.md), [`CDialogBar` Class](cdialogbar-class.md), [`CReBar` Class](crebar-class.md), and [`COleResizeBar` Class](coleresizebar-class.md). -[`CCriticalSection` Class](../../mfc/reference/ccriticalsection-class.md)
+[`CCriticalSection` Class](ccriticalsection-class.md)\ Represents a "critical section", which is a synchronization object that enables one thread at a time to access a resource or section of code. -[`CCtrlView` Class](../../mfc/reference/cctrlview-class.md)
+[`CCtrlView` Class](cctrlview-class.md)\ Adapts the document-view architecture to the common controls supported by Windows 98 and Windows NT versions 3.51 and later. -[`CCubicTransition` Class](../../mfc/reference/ccubictransition-class.md)
+[`CCubicTransition` Class](ccubictransition-class.md)\ Encapsulates a cubic transition. -[`CCustomInterpolator` Class](../../mfc/reference/ccustominterpolator-class.md)
+[`CCustomInterpolator` Class](ccustominterpolator-class.md)\ Implements a basic interpolator. -[`CCustomTransition` Class](../../mfc/reference/ccustomtransition-class.md)
+[`CCustomTransition` Class](ccustomtransition-class.md)\ Implements a custom transition. -[`CD2DBitmap` Class](../../mfc/reference/cd2dbitmap-class.md)
+[`CD2DBitmap` Class](cd2dbitmap-class.md)\ A wrapper for `ID2D1Bitmap`. -[`CD2DBitmapBrush` Class](../../mfc/reference/cd2dbitmapbrush-class.md)
+[`CD2DBitmapBrush` Class](cd2dbitmapbrush-class.md)\ A wrapper for `ID2D1BitmapBrush`. -[`CD2DBrush` Class](../../mfc/reference/cd2dbrush-class.md)
+[`CD2DBrush` Class](cd2dbrush-class.md)\ A wrapper for `ID2D1Brush`. -[`CD2DBrushProperties` Class](../../mfc/reference/cd2dbrushproperties-class.md)
+[`CD2DBrushProperties` Class](cd2dbrushproperties-class.md)\ A wrapper for `D2D1_BRUSH_PROPERTIES`. -[`CD2DEllipse` Class](../../mfc/reference/cd2dellipse-class.md)
+[`CD2DEllipse` Class](cd2dellipse-class.md)\ A wrapper for `D2D1_BRUSH_PROPERTIES`. -[`CD2DGeometry` Class](../../mfc/reference/cd2dgeometry-class.md)
+[`CD2DGeometry` Class](cd2dgeometry-class.md)\ A wrapper for `ID2D1Geometry`. -[`CD2DGeometrySink` Class](../../mfc/reference/cd2dgeometrysink-class.md)
+[`CD2DGeometrySink` Class](cd2dgeometrysink-class.md)\ A wrapper for `ID2D1GeometrySink`. -[`CD2DGradientBrush` Class](../../mfc/reference/cd2dgradientbrush-class.md)
+[`CD2DGradientBrush` Class](cd2dgradientbrush-class.md)\ The base class of the `CD2DLinearGradientBrush` and the `CD2DRadialGradientBrush` classes. -[`CD2DLayer` Class](../../mfc/reference/cd2dlayer-class.md)
+[`CD2DLayer` Class](cd2dlayer-class.md)\ A wrapper for `ID2D1Layer`. -[`CD2DLinearGradientBrush` Class](../../mfc/reference/cd2dlineargradientbrush-class.md)
+[`CD2DLinearGradientBrush` Class](cd2dlineargradientbrush-class.md)\ A wrapper for `ID2D1LinearGradientBrush`. -[`CD2DMesh` Class](../../mfc/reference/cd2dmesh-class.md)
+[`CD2DMesh` Class](cd2dmesh-class.md)\ A wrapper for `ID2D1Mesh`. -[`CD2DPathGeometry` Class](../../mfc/reference/cd2dpathgeometry-class.md)
+[`CD2DPathGeometry` Class](cd2dpathgeometry-class.md)\ A wrapper for `ID2D1PathGeometry`. -[`CD2DPointF` Class](../../mfc/reference/cd2dpointf-class.md)
+[`CD2DPointF` Class](cd2dpointf-class.md)\ A wrapper for `D2D1_POINT_2F`. -[`CD2DPointU` Class](../../mfc/reference/cd2dpointu-class.md)
+[`CD2DPointU` Class](cd2dpointu-class.md)\ A wrapper for `D2D1_POINT_2U`. -[`CD2DRadialGradientBrush` Class](../../mfc/reference/cd2dradialgradientbrush-class.md)
+[`CD2DRadialGradientBrush` Class](cd2dradialgradientbrush-class.md)\ A wrapper for `ID2D1RadialGradientBrush`. -[`CD2DRectF` Class](../../mfc/reference/cd2drectf-class.md)
+[`CD2DRectF` Class](cd2drectf-class.md)\ A wrapper for `D2D1_RECT_F`. -[`CD2DRectU` Class](../../mfc/reference/cd2drectu-class.md)
+[`CD2DRectU` Class](cd2drectu-class.md)\ A wrapper for `D2D1_RECT_U`. -[`CD2DResource` Class](../../mfc/reference/cd2dresource-class.md)
+[`CD2DResource` Class](cd2dresource-class.md)\ An abstract class that provides an interface for creating and managing `D2D` resources such as brushes, layers, and texts. -[`CD2DRoundedRect` Class](../../mfc/reference/cd2droundedrect-class.md)
+[`CD2DRoundedRect` Class](cd2droundedrect-class.md)\ A wrapper for `D2D1_ROUNDED_RECT`. -[`CD2DSizeF` Class](../../mfc/reference/cd2dsizef-class.md)
+[`CD2DSizeF` Class](cd2dsizef-class.md)\ A wrapper for `D2D1_SIZE_F`. -[`CD2DSizeU` Class](../../mfc/reference/cd2dsizeu-class.md)
+[`CD2DSizeU` Class](cd2dsizeu-class.md)\ A wrapper for `D2D1_SIZE_U`. -[`CD2DSolidColorBrush` Class](../../mfc/reference/cd2dsolidcolorbrush-class.md)
+[`CD2DSolidColorBrush` Class](cd2dsolidcolorbrush-class.md)\ A wrapper for `ID2D1SolidColorBrush`. -[`CD2DTextFormat` Class](../../mfc/reference/cd2dtextformat-class.md)
+[`CD2DTextFormat` Class](cd2dtextformat-class.md)\ A wrapper for `IDWriteTextFormat`. -[`CD2DTextLayout` Class](../../mfc/reference/cd2dtextlayout-class.md)
+[`CD2DTextLayout` Class](cd2dtextlayout-class.md)\ A wrapper for `IDWriteTextLayout`. -[`CDaoDatabase` Class](../../mfc/reference/cdaodatabase-class.md)
+[`CDaoDatabase` Class](cdaodatabase-class.md)\ Represents a connection to a database through which you can operate on the data. -[`CDaoException` Class](../../mfc/reference/cdaoexception-class.md)
+[`CDaoException` Class](cdaoexception-class.md)\ Represents an exception condition arising from the MFC database classes based on data access objects (DAO). -[`CDaoFieldExchange` Class](../../mfc/reference/cdaofieldexchange-class.md)
+[`CDaoFieldExchange` Class](cdaofieldexchange-class.md)\ Supports the DAO record field exchange (DFX) routines used by the DAO database classes. -[`CDaoQueryDef` Class](../../mfc/reference/cdaoquerydef-class.md)
+[`CDaoQueryDef` Class](cdaoquerydef-class.md)\ Represents a query definition, or "querydef," usually one saved in a database. -[`CDaoRecordset` Class](../../mfc/reference/cdaorecordset-class.md)
+[`CDaoRecordset` Class](cdaorecordset-class.md)\ Represents a set of records selected from a data source. -[`CDaoRecordView` Class](../../mfc/reference/cdaorecordview-class.md)
+[`CDaoRecordView` Class](cdaorecordview-class.md)\ A view that displays database records in controls. -[`CDaoTableDef` Class](../../mfc/reference/cdaotabledef-class.md)
+[`CDaoTableDef` Class](cdaotabledef-class.md)\ Represents the stored definition of a base table or an attached table. -[`CDaoWorkspace` Class](../../mfc/reference/cdaoworkspace-class.md)
+[`CDaoWorkspace` Class](cdaoworkspace-class.md)\ Manages a named, password-protected database session from login to logoff, by a single user. -[`CDatabase` Class](../../mfc/reference/cdatabase-class.md)
+[`CDatabase` Class](cdatabase-class.md)\ Represents a connection to a data source, through which you can operate on the data source. -[`CDataExchange` Class](../../mfc/reference/cdataexchange-class.md)
+[`CDataExchange` Class](cdataexchange-class.md)\ Supports the dialog data exchange (DDX) and dialog data validation (DDV) routines used by the Microsoft Foundation classes. -[`CDataPathProperty` Class](../../mfc/reference/cdatapathproperty-class.md)
+[`CDataPathProperty` Class](cdatapathproperty-class.md)\ Implements an OLE control property that can be loaded asynchronously. -[`CDataRecoveryHandler` Class](../../mfc/reference/cdatarecoveryhandler-class.md)
+[`CDataRecoveryHandler` Class](cdatarecoveryhandler-class.md)\ Autosaves documents and restores them if an application unexpectedly exits. -[`CDateTimeCtrl` Class](../../mfc/reference/cdatetimectrl-class.md)
+[`CDateTimeCtrl` Class](cdatetimectrl-class.md)\ Encapsulates the functionality of a date and time picker control. -[`CDBException` Class](../../mfc/reference/cdbexception-class.md)
+[`CDBException` Class](cdbexception-class.md)\ Represents an exception condition arising from the database classes. -[`CDBVariant` Class](../../mfc/reference/cdbvariant-class.md)
+[`CDBVariant` Class](cdbvariant-class.md)\ Represents a variant data type for the MFC ODBC classes. -[`CDC` Class](../../mfc/reference/cdc-class.md)
+[`CDC` Class](cdc-class.md)\ Defines a class of device-context objects. -[`CDCRenderTarget` Class](../../mfc/reference/cdcrendertarget-class.md)
+[`CDCRenderTarget` Class](cdcrendertarget-class.md)\ A wrapper for `ID2D1DCRenderTarget`. -[`CDHtmlDialog` Class](../../mfc/reference/cdhtmldialog-class.md)
+[`CDHtmlDialog` Class](cdhtmldialog-class.md)\ Used to create dialog boxes that use HTML rather than dialog resources to implement their user interface. -[`CDialog` Class](../../mfc/reference/cdialog-class.md)
+[`CDialog` Class](cdialog-class.md)\ Base class used for displaying dialog boxes on the screen. -[`CDialogBar` Class](../../mfc/reference/cdialogbar-class.md)
+[`CDialogBar` Class](cdialogbar-class.md)\ Provides the functionality of a Windows modeless dialog box in a control bar. -[`CDialogEx` Class](../../mfc/reference/cdialogex-class.md)
+[`CDialogEx` Class](cdialogex-class.md)\ Specifies the background color and background image of a dialog box. -[`CDiscreteTransition` Class](../../mfc/reference/cdiscretetransition-class.md)
+[`CDiscreteTransition` Class](cdiscretetransition-class.md)\ Encapsulates a discrete transition. -[`CDocItem` Class](../../mfc/reference/cdocitem-class.md)
+[`CDocItem` Class](cdocitem-class.md)\ The base class for document items, which are components of a document's data. -[`CDockablePane` Class](../../mfc/reference/cdockablepane-class.md)
+[`CDockablePane` Class](cdockablepane-class.md)\ Implements a pane that can either be docked in a dock site or included in a tabbed pane. -[`CDockablePaneAdapter` Class](../../mfc/reference/cdockablepaneadapter-class.md)
+[`CDockablePaneAdapter` Class](cdockablepaneadapter-class.md)\ Provides docking support for `CWnd`-derived panes. -[`CDockingManager` Class](../../mfc/reference/cdockingmanager-class.md)
+[`CDockingManager` Class](cdockingmanager-class.md)\ Implements the core functionality that controls docking layout in a main frame window. -[`CDockingPanesRow` Class](../../mfc/reference/cdockingpanesrow-class.md)
+[`CDockingPanesRow` Class](cdockingpanesrow-class.md)\ Manages a list of panes that are located in the same horizontal or vertical row (column) of a dock site. -[`CDockSite` Class](../../mfc/reference/cdocksite-class.md)
-Provides functionality for arranging panes that are derived from the [`CPane` Class](../../mfc/reference/cpane-class.md) into sets of rows. +[`CDockSite` Class](cdocksite-class.md)\ +Provides functionality for arranging panes that are derived from the [`CPane` Class](cpane-class.md) into sets of rows. -[`CDockState` Class](../../mfc/reference/cdockstate-class.md)
+[`CDockState` Class](cdockstate-class.md)\ A serialized `CObject` class that loads, unloads, or clears the state of one or more docking control bars in persistent memory (a file). -[`CDocObjectServer` Class](../../mfc/reference/cdocobjectserver-class.md)
+[`CDocObjectServer` Class](cdocobjectserver-class.md)\ Implements the additional OLE interfaces needed to make a normal `COleDocument` server into a full DocObject server: `IOleDocument`, `IOleDocumentView`, `IOleCommandTarget`, and `IPrint`. -[`CDocObjectServerItem` Class](../../mfc/reference/cdocobjectserveritem-class.md)
+[`CDocObjectServerItem` Class](cdocobjectserveritem-class.md)\ Implements OLE server verbs specifically for DocObject servers. -[`CDocTemplate` Class](../../mfc/reference/cdoctemplate-class.md)
+[`CDocTemplate` Class](cdoctemplate-class.md)\ An abstract base class that defines the basic functionality for document templates. -[`CDocument` Class](../../mfc/reference/cdocument-class.md)
+[`CDocument` Class](cdocument-class.md)\ Provides the basic functionality for user-defined document classes. -[`CDragListBox` Class](../../mfc/reference/cdraglistbox-class.md)
+[`CDragListBox` Class](cdraglistbox-class.md)\ In addition to providing the functionality of a Windows list box, the `CDragListBox` class lets the user move list box items, such as filenames, within the list box. -[`CDrawingManager` Class](../../mfc/reference/cdrawingmanager-class.md)
+[`CDrawingManager` Class](cdrawingmanager-class.md)\ Implements complex drawing algorithms. -[`CDumpContext` Class](../../mfc/reference/cdumpcontext-class.md)
+[`CDumpContext` Class](cdumpcontext-class.md)\ Supports stream-oriented diagnostic output in the form of human-readable text. -[`CDWordArray` Class](../../mfc/reference/cdwordarray-class.md)
+[`CDWordArray` Class](cdwordarray-class.md)\ Supports arrays of 32-bit doublewords. -[`CEdit` Class](../../mfc/reference/cedit-class.md)
+[`CEdit` Class](cedit-class.md)\ Provides the functionality of a Windows edit control. -[`CEditView` Class](../../mfc/reference/ceditview-class.md)
+[`CEditView` Class](ceditview-class.md)\ A type of view class that provides the functionality of a Windows edit control and can be used to implement simple text-editor functionality. -[`CEvent` Class](../../mfc/reference/cevent-class.md)
+[`CEvent` Class](cevent-class.md)\ Represents an "event", which is a synchronization object that enables one thread to notify another that an event has occurred. -[`CException` Class](../../mfc/reference/cexception-class.md)
+[`CException` Class](cexception-class.md)\ The base class for all exceptions in the Microsoft Foundation Class Library. -[`CFieldExchange` Class](../../mfc/reference/cfieldexchange-class.md)
+[`CFieldExchange` Class](cfieldexchange-class.md)\ Supports the record field exchange (RFX) and bulk record field exchange (Bulk RFX) routines used by the database classes. -[`CFile` Class](../../mfc/reference/cfile-class.md)
+[`CFile` Class](cfile-class.md)\ The base class for Microsoft Foundation Class file classes. -[`CFileDialog` Class](../../mfc/reference/cfiledialog-class.md)
+[`CFileDialog` Class](cfiledialog-class.md)\ Encapsulates the common file dialog box for Windows. -[`CFileException` Class](../../mfc/reference/cfileexception-class.md)
+[`CFileException` Class](cfileexception-class.md)\ Represents a file-related exception condition. -[`CFileFind` Class](../../mfc/reference/cfilefind-class.md)
-Performs local file searches and is the base class for [`CGopherFileFind` Class](../../mfc/reference/cgopherfilefind-class.md) and [`CFtpFileFind` Class](../../mfc/reference/cftpfilefind-class.md), which perform Internet file searches. +[`CFileFind` Class](cfilefind-class.md)\ +Performs local file searches and is the base class for [`CGopherFileFind` Class](cgopherfilefind-class.md) and [`CFtpFileFind` Class](cftpfilefind-class.md), which perform Internet file searches. -[`CFindReplaceDialog` Class](../../mfc/reference/cfindreplacedialog-class.md)
+[`CFindReplaceDialog` Class](cfindreplacedialog-class.md)\ Lets you implement standard string Find/Replace dialog boxes in your application. -[`CFolderPickerDialog` Class](../../mfc/reference/cfolderpickerdialog-class.md)
+[`CFolderPickerDialog` Class](cfolderpickerdialog-class.md)\ Implements `CFileDialog` in the folder picker mode. -[`CFont` Class](../../mfc/reference/cfont-class.md)
+[`CFont` Class](cfont-class.md)\ Encapsulates a Windows graphics device interface (GDI) font and provides member functions for manipulating the font. -[`CFontDialog` Class](../../mfc/reference/cfontdialog-class.md)
+[`CFontDialog` Class](cfontdialog-class.md)\ Lets you incorporate a font-selection dialog box into your application. -[`CFontHolder` Class](../../mfc/reference/cfontholder-class.md)
+[`CFontHolder` Class](cfontholder-class.md)\ Implements the stock Font property and encapsulates the functionality of a Windows font object and the `IFont` interface. -[`CFormView` Class](../../mfc/reference/cformview-class.md)
+[`CFormView` Class](cformview-class.md)\ The base class used for form views. -[`CFrameWnd` Class](../../mfc/reference/cframewnd-class.md)
+[`CFrameWnd` Class](cframewnd-class.md)\ Provides the functionality of a Windows single document interface (SDI) overlapped or pop-up frame window, along with members for managing the window. -[`CFrameWndEx` Class](../../mfc/reference/cframewndex-class.md)
-Implements the functionality of a Windows single document interface (SDI) overlapped or popup frame window, and provides members for managing the window. It extends the [`CFrameWnd` Class](../../mfc/reference/cframewnd-class.md) class. +[`CFrameWndEx` Class](cframewndex-class.md)\ +Implements the functionality of a Windows single document interface (SDI) overlapped or popup frame window, and provides members for managing the window. It extends the [`CFrameWnd` Class](cframewnd-class.md) class. -[`CFtpConnection` Class](../../mfc/reference/cftpconnection-class.md)
+[`CFtpConnection` Class](cftpconnection-class.md)\ Manages your FTP connection to an Internet server and enables direct manipulation of directories and files on that server. -[`CFtpFileFind` Class](../../mfc/reference/cftpfilefind-class.md)
+[`CFtpFileFind` Class](cftpfilefind-class.md)\ Aids in Internet file searches of FTP servers. -[`CGdiObject` Class](../../mfc/reference/cgdiobject-class.md)
+[`CGdiObject` Class](cgdiobject-class.md)\ Provides a base class for various kinds of Windows graphics device interface (GDI) objects such as bitmaps, regions, brushes, pens, palettes, and fonts. -[`CGopherConnection` Class](../../mfc/reference/cgopherconnection-class.md)
+[`CGopherConnection` Class](cgopherconnection-class.md)\ Manages your connection to a gopher Internet server. -[`CGopherFile` Class](../../mfc/reference/cgopherfile-class.md)
+[`CGopherFile` Class](cgopherfile-class.md)\ Provides the functionality to find and read files on a gopher server. -[`CGopherFileFind` Class](../../mfc/reference/cgopherfilefind-class.md)
+[`CGopherFileFind` Class](cgopherfilefind-class.md)\ Aids in Internet file searches of gopher servers. -[`CGopherLocator` Class](../../mfc/reference/cgopherlocator-class.md)
-Gets a gopher "locator" from a gopher server, determines the locator's type, and makes the locator available to [`CGopherFileFind` Class](../../mfc/reference/cgopherfilefind-class.md). +[`CGopherLocator` Class](cgopherlocator-class.md)\ +Gets a gopher "locator" from a gopher server, determines the locator's type, and makes the locator available to [`CGopherFileFind` Class](cgopherfilefind-class.md). -[`CHeaderCtrl` Class](../../mfc/reference/cheaderctrl-class.md)
+[`CHeaderCtrl` Class](cheaderctrl-class.md)\ Provides the functionality of the Windows common header control. -[`CHotKeyCtrl` Class](../../mfc/reference/chotkeyctrl-class.md)
+[`CHotKeyCtrl` Class](chotkeyctrl-class.md)\ Provides the functionality of the Windows common hot key control. -[`CHtmlEditCtrl` Class](../../mfc/reference/chtmleditctrl-class.md)
+[`CHtmlEditCtrl` Class](chtmleditctrl-class.md)\ Provides the functionality of the `WebBrowser` ActiveX control in an MFC window. -[`CHtmlEditCtrlBase` Class](../../mfc/reference/chtmleditctrlbase-class.md)
+[`CHtmlEditCtrlBase` Class](chtmleditctrlbase-class.md)\ Represents an HTML editing component. -[`CHtmlEditDoc` Class](../../mfc/reference/chtmleditdoc-class.md)
-With [`CHtmlEditView` Class](../../mfc/reference/chtmleditview-class.md), provides the functionality of the WebBrowser editing platform within the context of the MFC document-view architecture. +[`CHtmlEditDoc` Class](chtmleditdoc-class.md)\ +With [`CHtmlEditView` Class](chtmleditview-class.md), provides the functionality of the WebBrowser editing platform within the context of the MFC document-view architecture. -[`CHtmlEditView` Class](../../mfc/reference/chtmleditview-class.md)
+[`CHtmlEditView` Class](chtmleditview-class.md)\ Provides the functionality of the WebBrowser editing platform within the context of MFC's document/view architecture. -[`CHtmlView` Class](../../mfc/reference/chtmlview-class.md)
+[`CHtmlView` Class](chtmlview-class.md)\ Provides the functionality of the WebBrowser control within the context of MFC's document/view architecture. -[`CHttpConnection` Class](../../mfc/reference/chttpconnection-class.md)
+[`CHttpConnection` Class](chttpconnection-class.md)\ Manages your connection to an HTTP server. -[`CHttpFile` Class](../../mfc/reference/chttpfile-class.md)
+[`CHttpFile` Class](chttpfile-class.md)\ Provides the functionality to request and read files on an HTTP server. -[`CHwndRenderTarget` Class](../../mfc/reference/chwndrendertarget-class.md)
+[`CHwndRenderTarget` Class](chwndrendertarget-class.md)\ A wrapper for `ID2D1HwndRenderTarget`. -[`CImageList` Class](../../mfc/reference/cimagelist-class.md)
+[`CImageList` Class](cimagelist-class.md)\ Provides the functionality of the Windows common image list control. -[`CInstantaneousTransition` Class](../../mfc/reference/cinstantaneoustransition-class.md)
+[`CInstantaneousTransition` Class](cinstantaneoustransition-class.md)\ Encapsulates an instantaneous transition. -[`CInternetConnection` Class](../../mfc/reference/cinternetconnection-class.md)
+[`CInternetConnection` Class](cinternetconnection-class.md)\ Manages your connection to an Internet server. -[`CInternetException` Class](../../mfc/reference/cinternetexception-class.md)
+[`CInternetException` Class](cinternetexception-class.md)\ Represents an exception condition related to an Internet operation. -[`CInternetFile` Class](../../mfc/reference/cinternetfile-class.md)
+[`CInternetFile` Class](cinternetfile-class.md)\ Enables access to files on remote systems that use Internet protocols. -[`CInternetSession` Class](../../mfc/reference/cinternetsession-class.md)
+[`CInternetSession` Class](cinternetsession-class.md)\ Creates and initializes a single or several simultaneous Internet sessions and, if necessary, describes your connection to a proxy server. -[`CInterpolatorBase` Class](../../mfc/reference/cinterpolatorbase-class.md)
+[`CInterpolatorBase` Class](cinterpolatorbase-class.md)\ Implements a callback, which is called by the Animation API when it has to calculate a new value of an animation variable. -[`CInvalidArgException` Class](../../mfc/reference/cinvalidargexception-class.md)
+[`CInvalidArgException` Class](cinvalidargexception-class.md)\ This class represents an invalid argument exception condition. -[`CIPAddressCtrl` Class](../../mfc/reference/cipaddressctrl-class.md)
+[`CIPAddressCtrl` Class](cipaddressctrl-class.md)\ Provides the functionality of the Windows common IP Address control. -[`CJumpList` Class](../../mfc/reference/cjumplist-class.md)
+[`CJumpList` Class](cjumplist-class.md)\ The list of shortcuts revealed when you right click on an icon in the task bar. -[`CKeyboardManager` Class](../../mfc/reference/ckeyboardmanager-class.md)
+[`CKeyboardManager` Class](ckeyboardmanager-class.md)\ Manages shortcut key tables for the main frame window and child frame windows. -[`CKeyFrame` Class](../../mfc/reference/ckeyframe-class.md)
+[`CKeyFrame` Class](ckeyframe-class.md)\ Represents an animation keyframe. -[`CLinearTransition` Class](../../mfc/reference/clineartransition-class.md)
+[`CLinearTransition` Class](clineartransition-class.md)\ Encapsulates a linear transition. -[`CLinearTransitionFromSpeed` Class](../../mfc/reference/clineartransitionfromspeed-class.md)
+[`CLinearTransitionFromSpeed` Class](clineartransitionfromspeed-class.md)\ Encapsulates a linear-speed transition. -[`CLinkCtrl` Class](../../mfc/reference/clinkctrl-class.md)
+[`CLinkCtrl` Class](clinkctrl-class.md)\ Provides the functionality of the Windows common SysLink control. -[`CList` Class](../../mfc/reference/clist-class.md)
+[`CList` Class](clist-class.md)\ Supports ordered lists of nonunique objects accessible sequentially or by value. -[`CListBox` Class](../../mfc/reference/clistbox-class.md)
+[`CListBox` Class](clistbox-class.md)\ Provides the functionality of a Windows list box. -[`CListCtrl` Class](../../mfc/reference/clistctrl-class.md)
+[`CListCtrl` Class](clistctrl-class.md)\ Encapsulates the functionality of a "list view control," which displays a collection of items each consisting of an icon (from an image list) and a label. -[`CListView` Class](../../mfc/reference/clistview-class.md)
-Simplifies use of the list control and of [`CListCtrl` Class](../../mfc/reference/clistctrl-class.md), the class that encapsulates list-control functionality, with MFC's document-view architecture. +[`CListView` Class](clistview-class.md)\ +Simplifies use of the list control and of [`CListCtrl` Class](clistctrl-class.md), the class that encapsulates list-control functionality, with MFC's document-view architecture. -[`CLongBinary` Class](../../mfc/reference/clongbinary-class.md)
+[`CLongBinary` Class](clongbinary-class.md)\ Simplifies working with very large binary data objects (often called BLOBs, or "binary large objects") in a database. -[`CMap` Class](../../mfc/reference/cmap-class.md)
+[`CMap` Class](cmap-class.md)\ A dictionary collection class that maps unique keys to values. -[`CMapPtrToPtr` Class](../../mfc/reference/cmapptrtoptr-class.md)
+[`CMapPtrToPtr` Class](cmapptrtoptr-class.md)\ Supports maps of void pointers keyed by void pointers. -[`CMapPtrToWord` Class](../../mfc/reference/cmapptrtoword-class.md)
+[`CMapPtrToWord` Class](cmapptrtoword-class.md)\ Supports maps of 16-bit words keyed by void pointers. -[`CMapStringToOb` Class](../../mfc/reference/cmapstringtoob-class.md)
+[`CMapStringToOb` Class](cmapstringtoob-class.md)\ A dictionary collection class that maps unique `CString` objects to `CObject` pointers. -[`CMapStringToPtr` Class](../../mfc/reference/cmapstringtoptr-class.md)
+[`CMapStringToPtr` Class](cmapstringtoptr-class.md)\ Supports maps of void pointers keyed by `CString` objects. -[`CMapStringToString` Class](../../mfc/reference/cmapstringtostring-class.md)
+[`CMapStringToString` Class](cmapstringtostring-class.md)\ Supports maps of `CString` objects keyed by `CString` objects. -[`CMapWordToOb` Class](../../mfc/reference/cmapwordtoob-class.md)
+[`CMapWordToOb` Class](cmapwordtoob-class.md)\ Supports maps of `CObject` pointers keyed by 16-bit words. -[`CMapWordToPtr` Class](../../mfc/reference/cmapwordtoptr-class.md)
+[`CMapWordToPtr` Class](cmapwordtoptr-class.md)\ Supports maps of void pointers keyed by 16-bit words. -[`CMDIChildWnd` Class](../../mfc/reference/cmdichildwnd-class.md)
+[`CMDIChildWnd` Class](cmdichildwnd-class.md)\ Provides the functionality of a Windows multiple document interface (MDI) child window, along with members for managing the window. -[`CMDIChildWndEx` Class](../../mfc/reference/cmdichildwndex-class.md)
-Provides the functionality of a Windows multiple document interface (MDI) child window. It extends the functionality of [`CMDIChildWnd` Class](../../mfc/reference/cmdichildwnd-class.md). The framework requires this class when an MDI application uses certain MFC classes. +[`CMDIChildWndEx` Class](cmdichildwndex-class.md)\ +Provides the functionality of a Windows multiple document interface (MDI) child window. It extends the functionality of [`CMDIChildWnd` Class](cmdichildwnd-class.md). The framework requires this class when an MDI application uses certain MFC classes. -[`CMDIFrameWnd` Class](../../mfc/reference/cmdiframewnd-class.md)
+[`CMDIFrameWnd` Class](cmdiframewnd-class.md)\ Provides the functionality of a Windows multiple document interface (MDI) frame window, along with members for managing the window. -[`CMDIFrameWndEx` Class](../../mfc/reference/cmdiframewndex-class.md)
-Extends the functionality of [`CFrameWnd` Class](../../mfc/reference/cframewnd-class.md), a Windows Multiple Document Interface (MDI) frame window. +[`CMDIFrameWndEx` Class](cmdiframewndex-class.md)\ +Extends the functionality of [`CFrameWnd` Class](cframewnd-class.md), a Windows Multiple Document Interface (MDI) frame window. -[`CMDITabInfo` Class](../../mfc/reference/cmditabinfo-class.md)
-Used to pass parameters to [`CMDIFrameWndEx::EnableMDITabbedGroups`](../../mfc/reference/cmdiframewndex-class.md#enablemditabbedgroups) method. Set members of this class to control the behavior of MDI tabbed groups. +[`CMDITabInfo` Class](cmditabinfo-class.md)\ +Used to pass parameters to [`CMDIFrameWndEx::EnableMDITabbedGroups`](cmdiframewndex-class.md#enablemditabbedgroups) method. Set members of this class to control the behavior of MDI tabbed groups. -[`CMemFile` Class](../../mfc/reference/cmemfile-class.md)
-The [`CFile` Class](../../mfc/reference/cfile-class.md)-derived class that supports memory files. +[`CMemFile` Class](cmemfile-class.md)\ +The [`CFile` Class](cfile-class.md)-derived class that supports memory files. -[`CMemoryException` Class](../../mfc/reference/cmemoryexception-class.md)
+[`CMemoryException` Class](cmemoryexception-class.md)\ Represents an out-of-memory exception condition. -[`CMenu` Class](../../mfc/reference/cmenu-class.md)
+[`CMenu` Class](cmenu-class.md)\ An encapsulation of the Windows `HMENU`. -[`CMenuTearOffManager` Class](../../mfc/reference/cmenutearoffmanager-class.md)
+[`CMenuTearOffManager` Class](cmenutearoffmanager-class.md)\ Manages tear-off menus. A tear-off menu is a menu on the menu bar. The user can remove a tear-off menu from the menu bar, causing the tear-off menu to float. -[`CMetaFileDC` Class](../../mfc/reference/cmetafiledc-class.md)
+[`CMetaFileDC` Class](cmetafiledc-class.md)\ Implements a Windows metafile, which contains a sequence of graphics device interface (GDI) commands that you can replay to create a desired image or text. -[`CMFCAcceleratorKey` Class](../../mfc/reference/cmfcacceleratorkey-class.md)
+[`CMFCAcceleratorKey` Class](cmfcacceleratorkey-class.md)\ Helper class that implements virtual key mapping and formatting. -[`CMFCAcceleratorKeyAssignCtrl` Class](../../mfc/reference/cmfcacceleratorkeyassignctrl-class.md)
-Extends the [`CEdit` Class](../../mfc/reference/cedit-class.md) to support extra system buttons such as ALT, CONTROL, and SHIFT. +[`CMFCAcceleratorKeyAssignCtrl` Class](cmfcacceleratorkeyassignctrl-class.md)\ +Extends the [`CEdit` Class](cedit-class.md) to support extra system buttons such as ALT, CONTROL, and SHIFT. -[`CMFCAutoHideButton` Class](../../mfc/reference/cmfcautohidebutton-class.md)
-A button that displays or hides a [`CDockablePane` Class](../../mfc/reference/cdockablepane-class.md) that is configured to hide. +[`CMFCAutoHideButton` Class](cmfcautohidebutton-class.md)\ +A button that displays or hides a [`CDockablePane` Class](cdockablepane-class.md) that is configured to hide. -[`CMFCBaseTabCtrl` Class](../../mfc/reference/cmfcbasetabctrl-class.md)
+[`CMFCBaseTabCtrl` Class](cmfcbasetabctrl-class.md)\ Implements the base functionality for tabbed windows. -[`CMFCButton` Class](../../mfc/reference/cmfcbutton-class.md)
-Adds functionality to the [`CButton` Class](../../mfc/reference/cbutton-class.md) class such as aligning button text, combining button text and an image, selecting a cursor, and specifying a tool tip. +[`CMFCButton` Class](cmfcbutton-class.md)\ +Adds functionality to the [`CButton` Class](cbutton-class.md) class such as aligning button text, combining button text and an image, selecting a cursor, and specifying a tool tip. -[`CMFCCaptionBar` Class](../../mfc/reference/cmfccaptionbar-class.md)
+[`CMFCCaptionBar` Class](cmfccaptionbar-class.md)\ Control bar that can display three elements: a button, a text label, and a bitmap. It can only display one element of each type at a time. You can align each element to the left or right edges of the control or to the center. You can also apply a flat or 3D style to the top and bottom borders of the caption bar. -[`CMFCCaptionButton` Class](../../mfc/reference/cmfccaptionbutton-class.md)
+[`CMFCCaptionButton` Class](cmfccaptionbutton-class.md)\ Implements a button that is displayed on the caption bar for a docking pane or a mini-frame window. Typically, the framework creates caption buttons automatically. -[`CMFCColorBar` Class](../../mfc/reference/cmfccolorbar-class.md)
+[`CMFCColorBar` Class](cmfccolorbar-class.md)\ Represents a docking control bar that can select colors in a document or application. -[`CMFCColorButton` Class](../../mfc/reference/cmfccolorbutton-class.md)
-The `CMFCColorButton` and [`CMFCColorBar` Class](../../mfc/reference/cmfccolorbar-class.md) classes are used together to implement a color picker control. +[`CMFCColorButton` Class](cmfccolorbutton-class.md)\ +The `CMFCColorButton` and [`CMFCColorBar` Class](cmfccolorbar-class.md) classes are used together to implement a color picker control. -[`CMFCColorDialog` Class](../../mfc/reference/cmfccolordialog-class.md)
+[`CMFCColorDialog` Class](cmfccolordialog-class.md)\ Represents a color selection dialog box. -[`CMFCColorMenuButton` Class](../../mfc/reference/cmfccolormenubutton-class.md)
+[`CMFCColorMenuButton` Class](cmfccolormenubutton-class.md)\ Supports a menu command or a toolbar button that starts a color picker dialog box. -[`CMFCColorPickerCtrl` Class](../../mfc/reference/cmfccolorpickerctrl-class.md)
+[`CMFCColorPickerCtrl` Class](cmfccolorpickerctrl-class.md)\ Provides functionality for a control that is used to select colors. -[`CMFCDesktopAlertDialog` Class](../../mfc/reference/cmfcdesktopalertdialog-class.md)
-Used together with the [`CMFCDesktopAlertWnd` Class](../../mfc/reference/cmfcdesktopalertwnd-class.md) to display a custom dialog in a popup window. +[`CMFCDesktopAlertDialog` Class](cmfcdesktopalertdialog-class.md)\ +Used together with the [`CMFCDesktopAlertWnd` Class](cmfcdesktopalertwnd-class.md) to display a custom dialog in a popup window. -[`CMFCDesktopAlertWnd` Class](../../mfc/reference/cmfcdesktopalertwnd-class.md)
+[`CMFCDesktopAlertWnd` Class](cmfcdesktopalertwnd-class.md)\ Implements the functionality of a modeless dialog box which appears on the screen to inform the user about an event. -[`CMFCDesktopAlertWndInfo` Class](../../mfc/reference/cmfcdesktopalertwndinfo-class.md)
-Used with the [`CMFCDesktopAlertWnd` Class](../../mfc/reference/cmfcdesktopalertwnd-class.md). It specifies the controls that are displayed if the desktop alert window pops up. +[`CMFCDesktopAlertWndInfo` Class](cmfcdesktopalertwndinfo-class.md)\ +Used with the [`CMFCDesktopAlertWnd` Class](cmfcdesktopalertwnd-class.md). It specifies the controls that are displayed if the desktop alert window pops up. -[`CMFCDragFrameImpl` Class](../../mfc/reference/cmfcdragframeimpl-class.md)
+[`CMFCDragFrameImpl` Class](cmfcdragframeimpl-class.md)\ Draws the drag rectangle that appears when the user drags a pane in the standard dock mode. -[`CMFCDropDownToolBar` Class](../../mfc/reference/cmfcdropdowntoolbar-class.md)
+[`CMFCDropDownToolBar` Class](cmfcdropdowntoolbar-class.md)\ A toolbar that appears when the user presses and holds a top-level toolbar button. -[`CMFCDropDownToolbarButton` Class](../../mfc/reference/cmfcdropdowntoolbarbutton-class.md)
-A type of toolbar button that behaves like a regular button when it is clicked. However, it opens a drop-down toolbar ([`CMFCDropDownToolBar` Class](../../mfc/reference/cmfcdropdowntoolbar-class.md) if the user presses and holds the toolbar button down. +[`CMFCDropDownToolbarButton` Class](cmfcdropdowntoolbarbutton-class.md)\ +A type of toolbar button that behaves like a regular button when it is clicked. However, it opens a drop-down toolbar ([`CMFCDropDownToolBar` Class](cmfcdropdowntoolbar-class.md)) if the user presses and holds the toolbar button down. -[`CMFCDynamicLayout` Class](../../mfc/reference/cmfcdynamiclayout-class.md)
+[`CMFCDynamicLayout` Class](cmfcdynamiclayout-class.md)\ Specifies how controls in a window are moved and resized as the user resizes the window. -[`CMFCEditBrowseCtrl` Class](../../mfc/reference/cmfceditbrowsectrl-class.md)
+[`CMFCEditBrowseCtrl` Class](cmfceditbrowsectrl-class.md)\ Supports the edit browse control, which is an editable text box that optionally contains a browse button. When the user clicks the browse button, the control performs a custom action or displays a standard dialog box that contains a file browser or a folder browser. -[`CMFCFilterChunkValueImpl` Class](../../mfc/reference/cmfcfilterchunkvalueimpl-class.md)
+[`CMFCFilterChunkValueImpl` Class](cmfcfilterchunkvalueimpl-class.md)\ Simplifies both chunk and property value pair logic. -[`CMFCFontComboBox` Class](../../mfc/reference/cmfcfontcombobox-class.md)
+[`CMFCFontComboBox` Class](cmfcfontcombobox-class.md)\ Creates a combo box control that contains a list of fonts. -[`CMFCFontInfo` Class](../../mfc/reference/cmfcfontinfo-class.md)
+[`CMFCFontInfo` Class](cmfcfontinfo-class.md)\ Describes the name and other attributes of a font. -[`CMFCHeaderCtrl` Class](../../mfc/reference/cmfcheaderctrl-class.md)
+[`CMFCHeaderCtrl` Class](cmfcheaderctrl-class.md)\ Supports sorting multiple columns in a header control. -[`CMFCImageEditorDialog` Class](../../mfc/reference/cmfcimageeditordialog-class.md)
+[`CMFCImageEditorDialog` Class](cmfcimageeditordialog-class.md)\ Supports an image editor dialog box. -[`CMFCKeyMapDialog` Class](../../mfc/reference/cmfckeymapdialog-class.md)
+[`CMFCKeyMapDialog` Class](cmfckeymapdialog-class.md)\ Supports a control that maps commands to keys on the keyboard. -[`CMFCLinkCtrl` Class](../../mfc/reference/cmfclinkctrl-class.md)
+[`CMFCLinkCtrl` Class](cmfclinkctrl-class.md)\ Displays a button as a hyperlink and invokes the link's target when the button is clicked. -[`CMFCListCtrl` Class](../../mfc/reference/cmfclistctrl-class.md)
-Extends the functionality of [`CListCtrl` Class](../../mfc/reference/clistctrl-class.md) class by supporting the advanced header control functionality of the [`CMFCHeaderCtrl` Class](../../mfc/reference/cmfcheaderctrl-class.md). +[`CMFCListCtrl` Class](cmfclistctrl-class.md)\ +Extends the functionality of [`CListCtrl` Class](clistctrl-class.md) class by supporting the advanced header control functionality of the [`CMFCHeaderCtrl` Class](cmfcheaderctrl-class.md). -[`CMFCMaskedEdit` Class](../../mfc/reference/cmfcmaskededit-class.md)
+[`CMFCMaskedEdit` Class](cmfcmaskededit-class.md)\ Supports a masked edit control, which validates user input against a mask and displays the validated results according to a template. -[`CMFCMenuBar` Class](../../mfc/reference/cmfcmenubar-class.md)
+[`CMFCMenuBar` Class](cmfcmenubar-class.md)\ A menu bar that implements docking. -[`CMFCMenuButton` Class](../../mfc/reference/cmfcmenubutton-class.md)
+[`CMFCMenuButton` Class](cmfcmenubutton-class.md)\ A button that displays a pop-up menu and reports on the user's menu selections. -[`CMFCOutlookBar` Class](../../mfc/reference/cmfcoutlookbar-class.md)
-A tabbed pane with the visual appearance of the **Navigation Pane** in Microsoft Outlook 2000 or Outlook 2003. The `CMFCOutlookBar` object contains a [`CMFCOutlookBarTabCtrl` Class](../../mfc/reference/cmfcoutlookbartabctrl-class.md) object and a series of tabs. The tabs can be either [`CMFCOutlookBarPane` Class](../../mfc/reference/cmfcoutlookbarpane-class.md) objects or `CWnd`-derived objects. To the user, the Outlook bar appears as a series of buttons and a display area. When the user clicks a button, the corresponding control or button pane is displayed. +[`CMFCOutlookBar` Class](cmfcoutlookbar-class.md)\ +A tabbed pane with the visual appearance of the **Navigation Pane** in Microsoft Outlook 2000 or Outlook 2003. The `CMFCOutlookBar` object contains a [`CMFCOutlookBarTabCtrl` Class](cmfcoutlookbartabctrl-class.md) object and a series of tabs. The tabs can be either [`CMFCOutlookBarPane` Class](cmfcoutlookbarpane-class.md) objects or `CWnd`-derived objects. To the user, the Outlook bar appears as a series of buttons and a display area. When the user clicks a button, the corresponding control or button pane is displayed. -[`CMFCOutlookBarPane` Class](../../mfc/reference/cmfcoutlookbarpane-class.md)
-A control derived from [`CMFCToolBar` Class](../../mfc/reference/cmfctoolbar-class.md) that can be inserted into an Outlook bar ([`CMFCOutlookBar` Class](../../mfc/reference/cmfcoutlookbar-class.md)). The Outlook bar pane contains a column of large buttons. The user can scroll up and down the list of buttons if it is larger than the pane. When the user detaches an Outlook bar pane from the Outlook bar, it can float or dock in the main frame window. +[`CMFCOutlookBarPane` Class](cmfcoutlookbarpane-class.md)\ +A control derived from [`CMFCToolBar` Class](cmfctoolbar-class.md) that can be inserted into an Outlook bar ([`CMFCOutlookBar` Class](cmfcoutlookbar-class.md)). The Outlook bar pane contains a column of large buttons. The user can scroll up and down the list of buttons if it is larger than the pane. When the user detaches an Outlook bar pane from the Outlook bar, it can float or dock in the main frame window. -[`CMFCOutlookBarTabCtrl` Class](../../mfc/reference/cmfcoutlookbartabctrl-class.md)
+[`CMFCOutlookBarTabCtrl` Class](cmfcoutlookbartabctrl-class.md)\ A tab control that has the visual appearance of the **Navigation Pane** in Microsoft Outlook. -[`CMFCPopupMenu` Class](../../mfc/reference/cmfcpopupmenu-class.md)
+[`CMFCPopupMenu` Class](cmfcpopupmenu-class.md)\ Implements Windows pop-up menu functionality and extends it by adding features such as tear-off menus and tooltips. -[`CMFCPopupMenuBar` Class](../../mfc/reference/cmfcpopupmenubar-class.md)
+[`CMFCPopupMenuBar` Class](cmfcpopupmenubar-class.md)\ A menu bar embedded into a pop-up menu. -[`CMFCPreviewCtrlImpl` Class](../../mfc/reference/cmfcpreviewctrlimpl-class.md)
+[`CMFCPreviewCtrlImpl` Class](cmfcpreviewctrlimpl-class.md)\ Implements a window that is placed on a host window provided by the Shell for Rich Preview. -[`CMFCPropertyGridColorProperty` Class](../../mfc/reference/cmfcpropertygridcolorproperty-class.md)
+[`CMFCPropertyGridColorProperty` Class](cmfcpropertygridcolorproperty-class.md)\ Supports a property list control item that opens a color selection dialog box. -[`CMFCPropertyGridCtrl` Class](../../mfc/reference/cmfcpropertygridctrl-class.md)
+[`CMFCPropertyGridCtrl` Class](cmfcpropertygridctrl-class.md)\ Supports an editable property grid control that can display properties in alphabetical or hierarchical order. -[`CMFCPropertyGridFileProperty` Class](../../mfc/reference/cmfcpropertygridfileproperty-class.md)
+[`CMFCPropertyGridFileProperty` Class](cmfcpropertygridfileproperty-class.md)\ Supports a property list control item that opens a file selection dialog box. -[`CMFCPropertyGridFontProperty` Class](../../mfc/reference/cmfcpropertygridfontproperty-class.md)
+[`CMFCPropertyGridFontProperty` Class](cmfcpropertygridfontproperty-class.md)\ Supports a property list control item that opens a font selection dialog box. -[`CMFCPropertyGridProperty` Class](../../mfc/reference/cmfcpropertygridproperty-class.md)
+[`CMFCPropertyGridProperty` Class](cmfcpropertygridproperty-class.md)\ Represents a list item in a property list control. -[`CMFCPropertyPage` Class](../../mfc/reference/cmfcpropertypage-class.md)
+[`CMFCPropertyPage` Class](cmfcpropertypage-class.md)\ Supports the display of pop-up menus on a property page. -[`CMFCPropertySheet` Class](../../mfc/reference/cmfcpropertysheet-class.md)
+[`CMFCPropertySheet` Class](cmfcpropertysheet-class.md)\ Supports a property sheet where each property page is denoted by a page tab, a toolbar button, a tree control node, or a list item. -[`CMFCReBar` Class](../../mfc/reference/cmfcrebar-class.md)
+[`CMFCReBar` Class](cmfcrebar-class.md)\ Control bar that provides layout, persistence, and state information for rebar controls. -[`CMFCRibbonApplicationButton` Class](../../mfc/reference/cmfcribbonapplicationbutton-class.md)
+[`CMFCRibbonApplicationButton` Class](cmfcribbonapplicationbutton-class.md)\ Implements a special button located in the top-left corner of the application window. When clicked, the button opens a menu that usually contains common **File** commands like **Open**, **Save**, and **Exit**. -[`CMFCRibbonBaseElement` Class](../../mfc/reference/cmfcribbonbaseelement-class.md)
-Base class for all elements that you can add to a [`CMFCRibbonBar` Class](../../mfc/reference/cmfcribbonbar-class.md). Examples of ribbon elements are ribbon buttons, ribbon check boxes, and ribbon combo boxes. +[`CMFCRibbonBaseElement` Class](cmfcribbonbaseelement-class.md)\ +Base class for all elements that you can add to a [`CMFCRibbonBar` Class](cmfcribbonbar-class.md). Examples of ribbon elements are ribbon buttons, ribbon check boxes, and ribbon combo boxes. -[`CMFCRibbonButton` Class](../../mfc/reference/cmfcribbonbutton-class.md)
+[`CMFCRibbonButton` Class](cmfcribbonbutton-class.md)\ Implements buttons that you can position on ribbon bar elements such as panels, Quick Access Toolbars, and pop-up menus. -[`CMFCRibbonButtonsGroup` Class](../../mfc/reference/cmfcribbonbuttonsgroup-class.md)
+[`CMFCRibbonButtonsGroup` Class](cmfcribbonbuttonsgroup-class.md)\ Lets you organize a set of ribbon buttons into a group. All buttons in the group are directly adjacent to each other horizontally and enclosed in a border. -[`CMFCRibbonCategory` Class](../../mfc/reference/cmfcribboncategory-class.md)
-Implements a ribbon tab that contains a group of [`CMFCRibbonPanel` Class](../../mfc/reference/cmfcribbonpanel-class.md). +[`CMFCRibbonCategory` Class](cmfcribboncategory-class.md)\ +Implements a ribbon tab that contains a group of [`CMFCRibbonPanel` Class](cmfcribbonpanel-class.md). -[`CMFCRibbonCheckBox` Class](../../mfc/reference/cmfcribboncheckbox-class.md)
+[`CMFCRibbonCheckBox` Class](cmfcribboncheckbox-class.md)\ Implements a check box that you can add to a ribbon panel, Quick Access Toolbar, or popup menu. -[`CMFCRibbonColorButton` Class](../../mfc/reference/cmfcribboncolorbutton-class.md)
+[`CMFCRibbonColorButton` Class](cmfcribboncolorbutton-class.md)\ Implements a color button that you can add to a ribbon bar. The ribbon color button displays a drop-down menu that contains one or more color palettes. -[`CMFCRibbonComboBox` Class](../../mfc/reference/cmfcribboncombobox-class.md)
+[`CMFCRibbonComboBox` Class](cmfcribboncombobox-class.md)\ Implements a combo box control that you can add to a ribbon bar, a ribbon panel, or a ribbon popup menu. -[`CMFCRibbonContextCaption` Class](../../mfc/reference/cmfcribboncontextcaption-class.md)
+[`CMFCRibbonContextCaption` Class](cmfcribboncontextcaption-class.md)\ Implements a colored caption that appears at the top of a ribbon category or a context category. -[`CMFCRibbonEdit` Class](../../mfc/reference/cmfcribbonedit-class.md)
+[`CMFCRibbonEdit` Class](cmfcribbonedit-class.md)\ Implements an edit control that is positioned on a ribbon. -[`CMFCRibbonFontComboBox` Class](../../mfc/reference/cmfcribbonfontcombobox-class.md)
+[`CMFCRibbonFontComboBox` Class](cmfcribbonfontcombobox-class.md)\ Implements a combo box that contains a list of fonts. You place the combo box on a ribbon panel. -[`CMFCRibbonGallery` Class](../../mfc/reference/cmfcribbongallery-class.md)
+[`CMFCRibbonGallery` Class](cmfcribbongallery-class.md)\ Implements Office 2007-style ribbon galleries. -[`CMFCRibbonGalleryMenuButton` Class](../../mfc/reference/cmfcribbongallerymenubutton-class.md)
+[`CMFCRibbonGalleryMenuButton` Class](cmfcribbongallerymenubutton-class.md)\ Implements a ribbon menu button that contains ribbon galleries. -[`CMFCRibbonLabel` Class](../../mfc/reference/cmfcribbonlabel-class.md)
+[`CMFCRibbonLabel` Class](cmfcribbonlabel-class.md)\ Implements a non-clickable text label for a ribbon. -[`CMFCRibbonLinkCtrl` Class](../../mfc/reference/cmfcribbonlinkctrl-class.md)
+[`CMFCRibbonLinkCtrl` Class](cmfcribbonlinkctrl-class.md)\ Implements a hyperlink that is positioned on a ribbon. The hyperlink opens a Web page when you click it. -[`CMFCRibbonMainPanel` Class](../../mfc/reference/cmfcribbonmainpanel-class.md)
-Implements a ribbon panel that displays when you click the [`CMFCRibbonApplicationButton` Class](../../mfc/reference/cmfcribbonapplicationbutton-class.md). +[`CMFCRibbonMainPanel` Class](cmfcribbonmainpanel-class.md)\ +Implements a ribbon panel that displays when you click the [`CMFCRibbonApplicationButton` Class](cmfcribbonapplicationbutton-class.md). -[`CMFCRibbonMiniToolBar` Class](../../mfc/reference/cmfcribbonminitoolbar-class.md)
+[`CMFCRibbonMiniToolBar` Class](cmfcribbonminitoolbar-class.md)\ Implements a contextual popup toolbar. -[`CMFCRibbonPanel` Class](../../mfc/reference/cmfcribbonpanel-class.md)
+[`CMFCRibbonPanel` Class](cmfcribbonpanel-class.md)\ Implements a panel that contains a set of ribbon elements. When the panel is drawn, it displays as many elements as possible, given the size of the panel. -[`CMFCRibbonProgressBar` Class](../../mfc/reference/cmfcribbonprogressbar-class.md)
+[`CMFCRibbonProgressBar` Class](cmfcribbonprogressbar-class.md)\ Implements a control that visually indicates the progress of a lengthy operation. -[`CMFCRibbonSlider` Class](../../mfc/reference/cmfcribbonslider-class.md)
+[`CMFCRibbonSlider` Class](cmfcribbonslider-class.md)\ Implements a slider control that you can add to a ribbon bar or ribbon status bar. The ribbon slider control resembles the zoom sliders that appear in Office 2007 applications. -[`CMFCRibbonStatusBar` Class](../../mfc/reference/cmfcribbonstatusbar-class.md)
+[`CMFCRibbonStatusBar` Class](cmfcribbonstatusbar-class.md)\ Implements a status bar control that can display ribbon elements. -[`CMFCRibbonStatusBarPane` Class](../../mfc/reference/cmfcribbonstatusbarpane-class.md)
+[`CMFCRibbonStatusBarPane` Class](cmfcribbonstatusbarpane-class.md)\ Implements a ribbon element that you can add to a ribbon status bar. -[`CMFCRibbonUndoButton` Class](../../mfc/reference/cmfcribbonundobutton-class.md)
+[`CMFCRibbonUndoButton` Class](cmfcribbonundobutton-class.md)\ Implements a split button, a small button with a downward pointing triangle on the rightmost part of the main button. Users can click the triangle to display a drop-down list of their most recently performed actions. Users can then select one or more actions from the drop-down list. However, if the user clicks the button, only the last (the most recently added) action on the drop-down list is undone. You should populate the list with actions as the user performs them. -[`CMFCShellListCtrl` Class](../../mfc/reference/cmfcshelllistctrl-class.md)
+[`CMFCShellListCtrl` Class](cmfcshelllistctrl-class.md)\ Provides Windows list control functionality and expands it by including the ability to display a list of shell items. -[`CMFCShellTreeCtrl` Class](../../mfc/reference/cmfcshelltreectrl-class.md)
-Extends [`CTreeCtrl` Class](../../mfc/reference/ctreectrl-class.md) functionality by displaying a hierarchy of Shell items. +[`CMFCShellTreeCtrl` Class](cmfcshelltreectrl-class.md)\ +Extends [`CTreeCtrl` Class](ctreectrl-class.md) functionality by displaying a hierarchy of Shell items. -[`CMFCSpinButtonCtrl` Class](../../mfc/reference/cmfcspinbuttonctrl-class.md)
+[`CMFCSpinButtonCtrl` Class](cmfcspinbuttonctrl-class.md)\ Supports a visual manager that draws a spin button control. -[`CMFCStatusBar` Class](../../mfc/reference/cmfcstatusbar-class.md)
+[`CMFCStatusBar` Class](cmfcstatusbar-class.md)\ Implements a status bar similar to the `CStatusBar` class. However, the `CMFCStatusBar` class has features not offered by the `CStatusBar` class, such as the ability to display images, animations, and progress bars; and the ability to respond to mouse double-clicks. -[`CMFCTabCtrl` Class](../../mfc/reference/cmfctabctrl-class.md)
+[`CMFCTabCtrl` Class](cmfctabctrl-class.md)\ Provides functionality for a tab control. The tab control displays a dockable window with flat or three-dimensional tabs at its top or bottom. The tabs can display text and an image and can change color when active. -[`CMFCTabToolTipInfo Structure](../../mfc/reference/cmfctabtooltipinfo-structure.md)
+[`CMFCTabToolTipInfo` Structure](cmfctabtooltipinfo-structure.md)\ Provides information about the MDI tab that the user is hovering over. -[`CMFCTasksPane` Class](../../mfc/reference/cmfctaskspane-class.md)
+[`CMFCTasksPane` Class](cmfctaskspane-class.md)\ Implements a list of clickable items (tasks). -[`CMFCTasksPaneTask` Class](../../mfc/reference/cmfctaskspanetask-class.md)
-Helper class that represents tasks for the task pane control ([`CMFCTasksPane` Class](../../mfc/reference/cmfctaskspane-class.md)). The task object represents an item in the task group ([`CMFCTasksPaneTaskGroup` Class](../../mfc/reference/cmfctaskspanetaskgroup-class.md)). Each task can have a command that the framework executes when a user clicks on the task and an icon that appears to the left of the task name. +[`CMFCTasksPaneTask` Class](cmfctaskspanetask-class.md)\ +Helper class that represents tasks for the task pane control ([`CMFCTasksPane` Class](cmfctaskspane-class.md)). The task object represents an item in the task group ([`CMFCTasksPaneTaskGroup` Class](cmfctaskspanetaskgroup-class.md)). Each task can have a command that the framework executes when a user clicks on the task and an icon that appears to the left of the task name. -[`CMFCTasksPaneTaskGroup` Class](../../mfc/reference/cmfctaskspanetaskgroup-class.md)
-Helper class used by the [`CMFCTasksPane` Class](../../mfc/reference/cmfctaskspane-class.md) control. Objects of type `CMFCTasksPaneTaskGroup` represent a *task group*. The task group is a list of items that the framework displays in a separate box that has a collapse button. The box can have an optional caption (group name). If a group is collapsed, the list of tasks is not visible. +[`CMFCTasksPaneTaskGroup` Class](cmfctaskspanetaskgroup-class.md)\ +Helper class used by the [`CMFCTasksPane` Class](cmfctaskspane-class.md) control. Objects of type `CMFCTasksPaneTaskGroup` represent a *task group*. The task group is a list of items that the framework displays in a separate box that has a collapse button. The box can have an optional caption (group name). If a group is collapsed, the list of tasks is not visible. -[`CMFCToolBar` Class](../../mfc/reference/cmfctoolbar-class.md)
-Resembles [`CToolBar` Class](../../mfc/reference/ctoolbar-class.md), but provides additional support for user interface features. These include flat toolbars, toolbars with hot images, large icons, pager buttons, locked toolbars, rebar controls, text under images, background images, and tabbed toolbars. The `CMFCToolBar` class also contains built-in support for user customization of toolbars and menus, drag-and-drop between toolbars and menus, combo box buttons, edit box buttons, color pickers, and roll-up buttons. +[`CMFCToolBar` Class](cmfctoolbar-class.md)\ +Resembles [`CToolBar` Class](ctoolbar-class.md), but provides additional support for user interface features. These include flat toolbars, toolbars with hot images, large icons, pager buttons, locked toolbars, rebar controls, text under images, background images, and tabbed toolbars. The `CMFCToolBar` class also contains built-in support for user customization of toolbars and menus, drag-and-drop between toolbars and menus, combo box buttons, edit box buttons, color pickers, and roll-up buttons. -[`CMFCToolBarImages` Class](../../mfc/reference/cmfctoolbarimages-class.md)
+[`CMFCToolBarImages` Class](cmfctoolbarimages-class.md)\ Manages toolbar images loaded from application resources or from files. -[`CMFCToolBarInfo` Class](../../mfc/reference/cmfctoolbarinfo-class.md)
-Contains the resource IDs of toolbar images in various states. `CMFCToolBarInfo` is a helper class that is used as a parameter of the [`CMFCToolBar::LoadToolBarEx`](../../mfc/reference/cmfctoolbar-class.md#loadtoolbarex) method. +[`CMFCToolBarInfo` Class](cmfctoolbarinfo-class.md)\ +Contains the resource IDs of toolbar images in various states. `CMFCToolBarInfo` is a helper class that is used as a parameter of the [`CMFCToolBar::LoadToolBarEx`](cmfctoolbar-class.md#loadtoolbarex) method. -[`CMFCToolBarMenuButton` Class](../../mfc/reference/cmfctoolbarmenubutton-class.md)
+[`CMFCToolBarMenuButton` Class](cmfctoolbarmenubutton-class.md)\ A toolbar button that contains a pop-up menu. -[`CMFCToolBarsCustomizeDialog` Class](../../mfc/reference/cmfctoolbarscustomizedialog-class.md)
-A modeless tab dialog box ([`CPropertySheet` Class](../../mfc/reference/cpropertysheet-class.md)) that enables the user to customize the toolbars, menus, keyboard shortcuts, user-defined tools, and visual style in an application. Typically, the user accesses this dialog box by selecting **Customize** from the **Tools** menu. +[`CMFCToolBarsCustomizeDialog` Class](cmfctoolbarscustomizedialog-class.md)\ +A modeless tab dialog box ([`CPropertySheet` Class](cpropertysheet-class.md)) that enables the user to customize the toolbars, menus, keyboard shortcuts, user-defined tools, and visual style in an application. Typically, the user accesses this dialog box by selecting **Customize** from the **Tools** menu. -[`CMFCToolTipCtrl` Class](../../mfc/reference/cmfctooltipctrl-class.md)
-An extended tooltip implementation based on the [`CToolTipCtrl` Class](../../mfc/reference/ctooltipctrl-class.md). A tooltip based on the `CMFCToolTipCtrl` class can display an icon, a label, and a description. You can customize its visual appearance by using a gradient fill, custom text and border colors, bold text, rounded corners, or a balloon style. +[`CMFCToolTipCtrl` Class](cmfctooltipctrl-class.md)\ +An extended tooltip implementation based on the [`CToolTipCtrl` Class](ctooltipctrl-class.md). A tooltip based on the `CMFCToolTipCtrl` class can display an icon, a label, and a description. You can customize its visual appearance by using a gradient fill, custom text and border colors, bold text, rounded corners, or a balloon style. -[`CMFCToolTipInfo` Class](../../mfc/reference/cmfctooltipinfo-class.md)
+[`CMFCToolTipInfo` Class](cmfctooltipinfo-class.md)\ Stores information about the visual appearance of tooltips. -[`CMFCVisualManager` Class](../../mfc/reference/cmfcvisualmanager-class.md)
+[`CMFCVisualManager` Class](cmfcvisualmanager-class.md)\ Provides support for changing the appearance of your application at a global level. The `CMFCVisualManager` class works together with a class that provides instructions to draw the GUI controls of your application using a consistent style. These other classes are referred to as visual managers and they inherit from `CMFCBaseVisualManager`. -[`CMFCVisualManagerOffice2003` Class](../../mfc/reference/cmfcvisualmanageroffice2003-class.md)
+[`CMFCVisualManagerOffice2003` Class](cmfcvisualmanageroffice2003-class.md)\ Gives an application a Microsoft Office 2003 appearance. -[`CMFCVisualManagerOffice2007` Class](../../mfc/reference/cmfcvisualmanageroffice2007-class.md)
+[`CMFCVisualManagerOffice2007` Class](cmfcvisualmanageroffice2007-class.md)\ Gives an application a Microsoft Office 2007 appearance. -[`CMFCVisualManagerVS2005` Class](../../mfc/reference/cmfcvisualmanagervs2005-class.md)
+[`CMFCVisualManagerVS2005` Class](cmfcvisualmanagervs2005-class.md)\ Gives an application a Microsoft Visual Studio 2005 appearance. -[`CMFCVisualManagerWindows` Class](../../mfc/reference/cmfcvisualmanagerwindows-class.md)
+[`CMFCVisualManagerWindows` Class](cmfcvisualmanagerwindows-class.md)\ Mimics the appearance of Microsoft Windows XP or Microsoft Vista when the user selects a Windows XP or Vista theme. -[`CMFCVisualManagerWindows7` Class](../../mfc/reference/cmfcvisualmanagerwindows7-class.md)
+[`CMFCVisualManagerWindows7` Class](cmfcvisualmanagerwindows7-class.md)\ Gives an application the appearance of a Windows 7 application. -[`CMFCWindowsManagerDialog` Class](../../mfc/reference/cmfcwindowsmanagerdialog-class.md)
+[`CMFCWindowsManagerDialog` Class](cmfcwindowsmanagerdialog-class.md)\ Enables a user to manage MDI child windows in an MDI application. -[`CMiniFrameWnd` Class](../../mfc/reference/cminiframewnd-class.md)
+[`CMiniFrameWnd` Class](cminiframewnd-class.md)\ Represents a half-height frame window typically seen around floating toolbars. -[`CMonikerFile` Class](../../mfc/reference/cmonikerfile-class.md)
+[`CMonikerFile` Class](cmonikerfile-class.md)\ Represents a stream of data ([`IStream`](/windows/win32/api/objidl/nn-objidl-istream)) named by an [`IMoniker`](/windows/win32/api/objidl/nn-objidl-imoniker). -[`CMonthCalCtrl` Class](../../mfc/reference/cmonthcalctrl-class.md)
+[`CMonthCalCtrl` Class](cmonthcalctrl-class.md)\ Encapsulates the functionality of a month calendar control. -[`CMouseManager` Class](../../mfc/reference/cmousemanager-class.md)
-Lets a user associate different commands with a particular [`CView` Class](../../mfc/reference/cview-class.md) object when the user double-clicks inside that view. +[`CMouseManager` Class](cmousemanager-class.md)\ +Lets a user associate different commands with a particular [`CView` Class](cview-class.md) object when the user double-clicks inside that view. -[`CMultiDocTemplate` Class](../../mfc/reference/cmultidoctemplate-class.md)
+[`CMultiDocTemplate` Class](cmultidoctemplate-class.md)\ Defines a document template that implements the multiple document interface (MDI). -[`CMultiLock` Class](../../mfc/reference/cmultilock-class.md)
+[`CMultiLock` Class](cmultilock-class.md)\ Represents the access-control mechanism used in controlling access to resources in a multithreaded program. -[`CMultiPageDHtmlDialog` Class](../../mfc/reference/cmultipagedhtmldialog-class.md)
+[`CMultiPageDHtmlDialog` Class](cmultipagedhtmldialog-class.md)\ A multipage dialog displays multiple HTML pages sequentially and handles the events from each page. -[`CMultiPaneFrameWnd` Class](../../mfc/reference/cmultipaneframewnd-class.md)
-Extends [`CPaneFrameWnd` Class](../../mfc/reference/cpaneframewnd-class.md). It can support multiple panes. Instead of a single embedded handle to a control bar, `CMultiPaneFrameWnd` contains a [`CPaneContainerManager` Class](../../mfc/reference/cpanecontainermanager-class.md) object that enables the user to dock one `CMultiPaneFrameWnd` to another and dynamically create multiple floating, tabbed windows. +[`CMultiPaneFrameWnd` Class](cmultipaneframewnd-class.md)\ +Extends [`CPaneFrameWnd` Class](cpaneframewnd-class.md). It can support multiple panes. Instead of a single embedded handle to a control bar, `CMultiPaneFrameWnd` contains a [`CPaneContainerManager` Class](cpanecontainermanager-class.md) object that enables the user to dock one `CMultiPaneFrameWnd` to another and dynamically create multiple floating, tabbed windows. -[`CMutex` Class](../../mfc/reference/cmutex-class.md)
+[`CMutex` Class](cmutex-class.md)\ Represents a mutex, which is a synchronization object that allows one thread mutually exclusive access to a resource. -[`CNetAddressCtrl` Class](../../mfc/reference/cnetaddressctrl-class.md)
+[`CNetAddressCtrl` Class](cnetaddressctrl-class.md)\ The `CNetAddressCtrl` class represents the network address control, which you can use to input and validate the format of IPv4, IPv6, and named DNS addresses. -[`CNotSupportedException` Class](../../mfc/reference/cnotsupportedexception-class.md)
+[`CNotSupportedException` Class](cnotsupportedexception-class.md)\ Represents an exception that is the result of a request for an unsupported feature. -[`CObArray` Class](../../mfc/reference/cobarray-class.md)
+[`CObArray` Class](cobarray-class.md)\ Supports arrays of `CObject` pointers. -[`CObject` Class](../../mfc/reference/cobject-class.md)
+[`CObject` Class](cobject-class.md)\ The principal base class for the Microsoft Foundation Class Library. -[`CObList` Class](../../mfc/reference/coblist-class.md)
+[`CObList` Class](coblist-class.md)\ Supports ordered lists of non-unique `CObject` pointers accessible sequentially or by pointer value. -[`COccManager` Class](../../mfc/reference/coccmanager-class.md)
+[`COccManager` Class](coccmanager-class.md)\ Manages various custom control sites; implemented by `COleControlContainer` and `COleControlSite` objects. -[`COleBusyDialog` Class](../../mfc/reference/colebusydialog-class.md)
+[`COleBusyDialog` Class](colebusydialog-class.md)\ Used for the OLE Server Not Responding or Server Busy dialog boxes. -[`COleChangeIconDialog` Class](../../mfc/reference/colechangeicondialog-class.md)
+[`COleChangeIconDialog` Class](colechangeicondialog-class.md)\ Used for the OLE Change Icon dialog box. -[`COleChangeSourceDialog` Class](../../mfc/reference/colechangesourcedialog-class.md)
+[`COleChangeSourceDialog` Class](colechangesourcedialog-class.md)\ Used for the OLE Change Source dialog box. -[`COleClientItem` Class](../../mfc/reference/coleclientitem-class.md)
+[`COleClientItem` Class](coleclientitem-class.md)\ Defines the container interface to OLE items. -[`COleCmdUI` Class](../../mfc/reference/colecmdui-class.md)
+[`COleCmdUI` Class](colecmdui-class.md)\ Implements a method for MFC to update the state of user-interface objects related to the `IOleCommandTarget`-driven features of your application. -[`COleControl` Class](../../mfc/reference/colecontrol-class.md)
+[`COleControl` Class](colecontrol-class.md)\ A powerful base class for developing OLE controls. -[`COleControlContainer` Class](../../mfc/reference/colecontrolcontainer-class.md)
+[`COleControlContainer` Class](colecontrolcontainer-class.md)\ Acts as a control container for ActiveX controls. -[`COleControlModule` Class](../../mfc/reference/colecontrolmodule-class.md)
+[`COleControlModule` Class](colecontrolmodule-class.md)\ The base class from which you derive an OLE control module object. -[`COleControlSite` Class](../../mfc/reference/colecontrolsite-class.md)
+[`COleControlSite` Class](colecontrolsite-class.md)\ Provides support for custom client-side control interfaces. -[`COleConvertDialog` Class](../../mfc/reference/coleconvertdialog-class.md)
+[`COleConvertDialog` Class](coleconvertdialog-class.md)\ For more information, see the [`OLEUICONVERT`](/windows/win32/api/oledlg/ns-oledlg-oleuiconvertw) structure in the Windows SDK. -[`COleCurrency` Class](../../mfc/reference/colecurrency-class.md)
+[`COleCurrency` Class](colecurrency-class.md)\ Encapsulates the `CURRENCY` data type of OLE automation. -[`COleDataObject` Class](../../mfc/reference/coledataobject-class.md)
+[`COleDataObject` Class](coledataobject-class.md)\ Used in data transfers for retrieving data in various formats from the Clipboard, through drag and drop, or from an embedded OLE item. -[`COleDataSource` Class](../../mfc/reference/coledatasource-class.md)
+[`COleDataSource` Class](coledatasource-class.md)\ Acts as a cache into which an application places the data that it will offer during data transfer operations, such as Clipboard or drag-and-drop operations. -[`COleDBRecordView` Class](../../mfc/reference/coledbrecordview-class.md)
+[`COleDBRecordView` Class](coledbrecordview-class.md)\ A view that displays database records in controls. -[`COleDialog` Class](../../mfc/reference/coledialog-class.md)
+[`COleDialog` Class](coledialog-class.md)\ Provides functionality common to dialog boxes for OLE. -[`COleDispatchDriver` Class](../../mfc/reference/coledispatchdriver-class.md)
+[`COleDispatchDriver` Class](coledispatchdriver-class.md)\ Implements the client side of OLE automation. -[`COleDispatchException` Class](../../mfc/reference/coledispatchexception-class.md)
+[`COleDispatchException` Class](coledispatchexception-class.md)\ Handles exceptions specific to the OLE `IDispatch` interface, which is a key part of OLE automation. -[`COleDocObjectItem` Class](../../mfc/reference/coledocobjectitem-class.md)
+[`COleDocObjectItem` Class](coledocobjectitem-class.md)\ Implements Active document containment. -[`COleDocument` Class](../../mfc/reference/coledocument-class.md)
+[`COleDocument` Class](coledocument-class.md)\ The base class for OLE documents that support visual editing. -[`COleDropSource` Class](../../mfc/reference/coledropsource-class.md)
+[`COleDropSource` Class](coledropsource-class.md)\ Enables data to be dragged to a drop target. -[`COleDropTarget` Class](../../mfc/reference/coledroptarget-class.md)
+[`COleDropTarget` Class](coledroptarget-class.md)\ Provides the communication mechanism between a window and the OLE libraries. -[`COleException` Class](../../mfc/reference/coleexception-class.md)
+[`COleException` Class](coleexception-class.md)\ Represents an exception condition related to an OLE operation. -[`COleInsertDialog` Class](../../mfc/reference/coleinsertdialog-class.md)
+[`COleInsertDialog` Class](coleinsertdialog-class.md)\ Used for the OLE Insert Object dialog box. -[`COleIPFrameWnd` Class](../../mfc/reference/coleipframewnd-class.md)
+[`COleIPFrameWnd` Class](coleipframewnd-class.md)\ The base for your application's in-place editing window. -[`COleIPFrameWndEx` Class](../../mfc/reference/coleipframewndex-class.md)
-Implements an OLE container that supports MFC. You must derive the in-place frame window class for your application from the `COleIPFrameWndEx` class, instead of deriving it from the [`COleIPFrameWnd`](../../mfc/reference/coleipframewnd-class.md) class. +[`COleIPFrameWndEx` Class](coleipframewndex-class.md)\ +Implements an OLE container that supports MFC. You must derive the in-place frame window class for your application from the `COleIPFrameWndEx` class, instead of deriving it from the [`COleIPFrameWnd`](coleipframewnd-class.md) class. -[`COleLinkingDoc` Class](../../mfc/reference/colelinkingdoc-class.md)
+[`COleLinkingDoc` Class](colelinkingdoc-class.md)\ The base class for OLE container documents that support linking to the embedded items they contain. -[`COleLinksDialog` Class](../../mfc/reference/colelinksdialog-class.md)
+[`COleLinksDialog` Class](colelinksdialog-class.md)\ Used for the OLE Edit Links dialog box. -[`COleMessageFilter` Class](../../mfc/reference/colemessagefilter-class.md)
+[`COleMessageFilter` Class](colemessagefilter-class.md)\ Manages the concurrency required by the interaction of OLE applications. -[`COleObjectFactory` Class](../../mfc/reference/coleobjectfactory-class.md)
+[`COleObjectFactory` Class](coleobjectfactory-class.md)\ Implements the OLE class factory, which creates OLE objects such as servers, automation objects, and documents. -[`COlePasteSpecialDialog` Class](../../mfc/reference/colepastespecialdialog-class.md)
+[`COlePasteSpecialDialog` Class](colepastespecialdialog-class.md)\ Used for the OLE Paste Special dialog box. -[`COlePropertiesDialog` Class](../../mfc/reference/colepropertiesdialog-class.md)
+[`COlePropertiesDialog` Class](colepropertiesdialog-class.md)\ Encapsulates the Windows common OLE Object Properties dialog box. -[`COlePropertyPage` Class](../../mfc/reference/colepropertypage-class.md)
+[`COlePropertyPage` Class](colepropertypage-class.md)\ Used to display the properties of a custom control in a graphical interface, similar to a dialog box. -[`COleResizeBar` Class](../../mfc/reference/coleresizebar-class.md)
+[`COleResizeBar` Class](coleresizebar-class.md)\ A type of control bar that supports resizing of in-place OLE items. -[`COleSafeArray` Class](../../mfc/reference/colesafearray-class.md)
+[`COleSafeArray` Class](colesafearray-class.md)\ A class for working with arrays of arbitrary type and dimension. -[`COleServerDoc` Class](../../mfc/reference/coleserverdoc-class.md)
+[`COleServerDoc` Class](coleserverdoc-class.md)\ The base class for OLE server documents. -[`COleServerItem` Class](../../mfc/reference/coleserveritem-class.md)
+[`COleServerItem` Class](coleserveritem-class.md)\ Provides the server interface to OLE items. -[`COleStreamFile` Class](../../mfc/reference/colestreamfile-class.md)
+[`COleStreamFile` Class](colestreamfile-class.md)\ Represents a stream of data (`IStream`) in a compound file as part of OLE Structured Storage. -[`COleTemplateServer` Class](../../mfc/reference/coletemplateserver-class.md)
+[`COleTemplateServer` Class](coletemplateserver-class.md)\ Used for OLE visual editing servers, automation servers, and link containers (applications that support links to embeddings). -[`COleUpdateDialog` Class](../../mfc/reference/coleupdatedialog-class.md)
+[`COleUpdateDialog` Class](coleupdatedialog-class.md)\ Used for a special case of the OLE Edit Links dialog box, which should be used when you need to update only existing linked or embedded objects in a document. -[`COleVariant` Class](../../mfc/reference/colevariant-class.md)
+[`COleVariant` Class](colevariant-class.md)\ Encapsulates the [`VARIANT`](/windows/win32/api/oaidl/ns-oaidl-variant) data type. -[`CPagerCtrl` Class](../../mfc/reference/cpagerctrl-class.md)
+[`CPagerCtrl` Class](cpagerctrl-class.md)\ The `CPagerCtrl` class wraps the Windows pager control, which can scroll into view a contained window that does not fit the containing window. -[`CPageSetupDialog` Class](../../mfc/reference/cpagesetupdialog-class.md)
+[`CPageSetupDialog` Class](cpagesetupdialog-class.md)\ Encapsulates the services provided by the Windows common OLE Page Setup dialog box with additional support for setting and modifying print margins. -[`CPaintDC` Class](../../mfc/reference/cpaintdc-class.md)
-A device-context class derived from [`CDC` Class](../../mfc/reference/cdc-class.md). +[`CPaintDC` Class](cpaintdc-class.md)\ +A device-context class derived from [`CDC` Class](cdc-class.md). -[`CPalette` Class](../../mfc/reference/cpalette-class.md)
+[`CPalette` Class](cpalette-class.md)\ Encapsulates a Windows color palette. -[`CPane` Class](../../mfc/reference/cpane-class.md)
-Enhancement of the [`CControlBar` Class](../../mfc/reference/ccontrolbar-class.md). If you are upgrading an existing MFC project, you need to replace all occurrences of `CControlBar` with `CPane`. +[`CPane` Class](cpane-class.md)\ +Enhancement of the [`CControlBar` Class](ccontrolbar-class.md). If you are upgrading an existing MFC project, you need to replace all occurrences of `CControlBar` with `CPane`. -[`CPaneContainer` Class](../../mfc/reference/cpanecontainer-class.md)
-Basic component of the docking model implemented by MFC. An object of this class stores pointers to two docking panes or to two instances of `CPaneContainer`. It also stores a pointer to the divider that separates the panes (or the containers). By nesting containers inside containers, the framework can build a binary tree that represents complex docking layouts. The root of the binary tree is stored in a [`CPaneContainerManager` Class](../../mfc/reference/cpanecontainermanager-class.md) object. +[`CPaneContainer` Class](cpanecontainer-class.md)\ +Basic component of the docking model implemented by MFC. An object of this class stores pointers to two docking panes or to two instances of `CPaneContainer`. It also stores a pointer to the divider that separates the panes (or the containers). By nesting containers inside containers, the framework can build a binary tree that represents complex docking layouts. The root of the binary tree is stored in a [`CPaneContainerManager` Class](cpanecontainermanager-class.md) object. -[`CPaneContainerManager` Class](../../mfc/reference/cpanecontainermanager-class.md)
+[`CPaneContainerManager` Class](cpanecontainermanager-class.md)\ Manages the storage and display of the current docking layout. -[`CPaneDialog` Class](../../mfc/reference/cpanedialog-class.md)
+[`CPaneDialog` Class](cpanedialog-class.md)\ Supports a modeless, dockable dialog box. -[`CPaneDivider` Class](../../mfc/reference/cpanedivider-class.md)
+[`CPaneDivider` Class](cpanedivider-class.md)\ Divides two panes, divides two groups of panes, or separates a group of panes from the client area of the main frame window. -[`CPaneFrameWnd` Class](../../mfc/reference/cpaneframewnd-class.md)
+[`CPaneFrameWnd` Class](cpaneframewnd-class.md)\ Implements a mini-frame window that contains one pane. The pane fills the client area of the window. -[`CParabolicTransitionFromAcceleration` Class](../../mfc/reference/cparabolictransitionfromacceleration-class.md)
+[`CParabolicTransitionFromAcceleration` Class](cparabolictransitionfromacceleration-class.md)\ Encapsulates a parabolic-acceleration transition. -[`CPen` Class](../../mfc/reference/cpen-class.md)
+[`CPen` Class](cpen-class.md)\ Encapsulates a Windows graphics device interface (GDI) pen. -[`CPictureHolder` Class](../../mfc/reference/cpictureholder-class.md)
+[`CPictureHolder` Class](cpictureholder-class.md)\ Implements a Picture property, which lets the user display a picture in your control. -[`CPoint` Class](../../atl-mfc-shared/reference/cpoint-class.md)
+[`CPoint` Class](../../atl-mfc-shared/reference/cpoint-class.md)\ Similar to the Windows `POINT` structure. -[`CPrintDialog` Class](../../mfc/reference/cprintdialog-class.md)
+[`CPrintDialog` Class](cprintdialog-class.md)\ Encapsulates the services provided by the Windows common dialog box for printing. -[`CPrintDialogEx` Class](../../mfc/reference/cprintdialogex-class.md)
+[`CPrintDialogEx` Class](cprintdialogex-class.md)\ Encapsulates the services provided by the Windows Print property sheet. -[`CProgressCtrl` Class](../../mfc/reference/cprogressctrl-class.md)
+[`CProgressCtrl` Class](cprogressctrl-class.md)\ Provides the functionality of the Windows common progress bar control. -[`CPropertyPage` Class](../../mfc/reference/cpropertypage-class.md)
+[`CPropertyPage` Class](cpropertypage-class.md)\ Represents individual pages of a property sheet, otherwise known as a tab dialog box. -[`CPropertySheet` Class](../../mfc/reference/cpropertysheet-class.md)
+[`CPropertySheet` Class](cpropertysheet-class.md)\ Represents property sheets, also known as tab dialog boxes. -[`CPropExchange` Class](../../mfc/reference/cpropexchange-class.md)
+[`CPropExchange` Class](cpropexchange-class.md)\ Supports the implementation of persistence for your OLE controls. -[`CPtrArray` Class](../../mfc/reference/cptrarray-class.md)
+[`CPtrArray` Class](cptrarray-class.md)\ Supports arrays of void pointers. -[`CPtrList` Class](../../mfc/reference/cptrlist-class.md)
+[`CPtrList` Class](cptrlist-class.md)\ Supports lists of void pointers. -[`CReBar` Class](../../mfc/reference/crebar-class.md)
+[`CReBar` Class](crebar-class.md)\ A control bar that provides layout, persistence, and state information for rebar controls. -[`CReBarCtrl` Class](../../mfc/reference/crebarctrl-class.md)
+[`CReBarCtrl` Class](crebarctrl-class.md)\ Encapsulates the functionality of a rebar control, which is a container for a child window. -[`CRecentDockSiteInfo` Class](../../mfc/reference/crecentdocksiteinfo-class.md)
-Helper class that stores recent state information for the [`CPane` Class](../../mfc/reference/cpane-class.md). +[`CRecentDockSiteInfo` Class](crecentdocksiteinfo-class.md)\ +Helper class that stores recent state information for the [`CPane` Class](cpane-class.md). -[`CRecentFileList` Class](../../mfc/reference/crecentfilelist-class.md)
+[`CRecentFileList` Class](crecentfilelist-class.md)\ Supports control of the most recently used (MRU) file list. -[`CRecordset` Class](../../mfc/reference/crecordset-class.md)
+[`CRecordset` Class](crecordset-class.md)\ Represents a set of records selected from a data source. -[`CRecordView` Class](../../mfc/reference/crecordview-class.md)
+[`CRecordView` Class](crecordview-class.md)\ A view that displays database records in controls. -[`CRect` Class](../../atl-mfc-shared/reference/crect-class.md)
+[`CRect` Class](../../atl-mfc-shared/reference/crect-class.md)\ Similar to a Windows [`RECT` structure](/windows/win32/api/windef/ns-windef-rect). -[`CRectTracker` Class](../../mfc/reference/crecttracker-class.md)
+[`CRectTracker` Class](crecttracker-class.md)\ Enables an item to be displayed, moved, and resized in different fashions. -[`CRenderTarget` Class](../../mfc/reference/crendertarget-class.md)
+[`CRenderTarget` Class](crendertarget-class.md)\ A wrapper for `ID2D1RenderTarget`. -[`CResourceException` Class](../../mfc/reference/cresourceexception-class.md)
+[`CResourceException` Class](cresourceexception-class.md)\ Generated when Windows cannot find or allocate a requested resource. -[`CReversalTransition` Class](../../mfc/reference/creversaltransition-class.md)
+[`CReversalTransition` Class](creversaltransition-class.md)\ Encapsulates a reversal transition. -[`CRgn` Class](../../mfc/reference/crgn-class.md)
+[`CRgn` Class](crgn-class.md)\ Encapsulates a Windows graphics device interface (GDI) region. -[`CRichEditCntrItem` Class](../../mfc/reference/cricheditcntritem-class.md)
-With [`CRichEditView` Class](../../mfc/reference/cricheditview-class.md) and [`CRichEditDoc` Class](../../mfc/reference/cricheditdoc-class.md), provides the functionality of the rich edit control within the context of MFC's document view architecture. +[`CRichEditCntrItem` Class](cricheditcntritem-class.md)\ +With [`CRichEditView` Class](cricheditview-class.md) and [`CRichEditDoc` Class](cricheditdoc-class.md), provides the functionality of the rich edit control within the context of MFC's document view architecture. -[`CRichEditCtrl` Class](../../mfc/reference/cricheditctrl-class.md)
+[`CRichEditCtrl` Class](cricheditctrl-class.md)\ Provides the functionality of the rich edit control. -[`CRichEditDoc` Class](../../mfc/reference/cricheditdoc-class.md)
-With [`CRichEditView` Class](../../mfc/reference/cricheditview-class.md) and [`CRichEditCntrItem` Class](../../mfc/reference/cricheditcntritem-class.md), provides the functionality of the rich edit control within the context of MFC's document view architecture. +[`CRichEditDoc` Class](cricheditdoc-class.md)\ +With [`CRichEditView` Class](cricheditview-class.md) and [`CRichEditCntrItem` Class](cricheditcntritem-class.md), provides the functionality of the rich edit control within the context of MFC's document view architecture. -[`CRichEditView` Class](../../mfc/reference/cricheditview-class.md)
-With [`CRichEditDoc` Class](../../mfc/reference/cricheditdoc-class.md) and [`CRichEditCntrItem` Class](../../mfc/reference/cricheditcntritem-class.md), provides the functionality of the rich edit control within the context of MFC's document view architecture. +[`CRichEditView` Class](cricheditview-class.md)\ +With [`CRichEditDoc` Class](cricheditdoc-class.md) and [`CRichEditCntrItem` Class](cricheditcntritem-class.md), provides the functionality of the rich edit control within the context of MFC's document view architecture. -[`CScrollBar` Class](../../mfc/reference/cscrollbar-class.md)
+[`CScrollBar` Class](cscrollbar-class.md)\ Provides the functionality of a Windows scroll-bar control. -[`CScrollView` Class](../../mfc/reference/cscrollview-class.md)
-A [`CView` Class](../../mfc/reference/cview-class.md) with scrolling capabilities. +[`CScrollView` Class](cscrollview-class.md)\ +A [`CView` Class](cview-class.md) with scrolling capabilities. -[`CSemaphore` Class](../../mfc/reference/csemaphore-class.md)
+[`CSemaphore` Class](csemaphore-class.md)\ Represents a "semaphore", which is a synchronization object that allows a limited number of threads in one or more processes to access aMaintains a count of the number of threads currently accessing a specified resource. -[`CSettingsStore` Class](../../mfc/reference/csettingsstore-class.md)
+[`CSettingsStore` Class](csettingsstore-class.md)\ Wraps Windows API functions, providing an object-oriented interface that you use to access the registry. -[`CSettingsStoreSP` Class](../../mfc/reference/csettingsstoresp-class.md)
-Helper class that you can use to create instances of the [`CSettingsStore` Class](../../mfc/reference/csettingsstore-class.md). +[`CSettingsStoreSP` Class](csettingsstoresp-class.md)\ +Helper class that you can use to create instances of the [`CSettingsStore` Class](csettingsstore-class.md). -[`CSharedFile` Class](../../mfc/reference/csharedfile-class.md)
-The [`CMemFile` Class](../../mfc/reference/cmemfile-class.md)-derived class that supports shared memory files. +[`CSharedFile` Class](csharedfile-class.md)\ +The [`CMemFile` Class](cmemfile-class.md)-derived class that supports shared memory files. -[`CShellManager` Class](../../mfc/reference/cshellmanager-class.md)
+[`CShellManager` Class](cshellmanager-class.md)\ Implements several methods that enable you to work with pointers to identifier lists (PIDLs). -[`CSimpleException` Class](../../mfc/reference/csimpleexception-class.md)
+[`CSimpleException` Class](csimpleexception-class.md)\ This class is a base class for resource-critical MFC exceptions. -[`CSingleDocTemplate` Class](../../mfc/reference/csingledoctemplate-class.md)
+[`CSingleDocTemplate` Class](csingledoctemplate-class.md)\ Defines a document template that implements the single document interface (SDI). -[`CSingleLock` Class](../../mfc/reference/csinglelock-class.md)
+[`CSingleLock` Class](csinglelock-class.md)\ Represents the access-control mechanism used in controlling access to a resource in a multithreaded program. -[`CSinusoidalTransitionFromRange` Class](../../mfc/reference/csinusoidaltransitionfromrange-class.md)
+[`CSinusoidalTransitionFromRange` Class](csinusoidaltransitionfromrange-class.md)\ Encapsulates a sinusoidal-range transition that has a given range of oscillation. -[`CSinusoidalTransitionFromVelocity` Class](../../mfc/reference/csinusoidaltransitionfromvelocity-class.md)
+[`CSinusoidalTransitionFromVelocity` Class](csinusoidaltransitionfromvelocity-class.md)\ Encapsulates a sinusoidal-velocity transition that has an amplitude that is determined by the initial velocity of the animation variable. -[`CSize` Class](../../atl-mfc-shared/reference/csize-class.md)
+[`CSize` Class](../../atl-mfc-shared/reference/csize-class.md)\ Similar to the Windows [`SIZE`](/windows/win32/api/windef/ns-windef-size) structure, which implements a relative coordinate or position. -[`CSliderCtrl` Class](../../mfc/reference/csliderctrl-class.md)
+[`CSliderCtrl` Class](csliderctrl-class.md)\ Provides the functionality of the Windows common slider control. -[`CSmartDockingInfo` Class](../../mfc/reference/csmartdockinginfo-class.md)
+[`CSmartDockingInfo` Class](csmartdockinginfo-class.md)\ Defines the appearance of smart docking markers. -[`CSmoothStopTransition` Class](../../mfc/reference/csmoothstoptransition-class.md)
+[`CSmoothStopTransition` Class](csmoothstoptransition-class.md)\ Encapsulates a smooth-stop transition. -[`CSocket` Class](../../mfc/reference/csocket-class.md)
+[`CSocket` Class](csocket-class.md)\ Derives from `CAsyncSocket`, and represents a higher level of abstraction of the Windows Sockets API. -[`CSocketFile` Class](../../mfc/reference/csocketfile-class.md)
+[`CSocketFile` Class](csocketfile-class.md)\ A `CFile` object used for sending and receiving data across a network via Windows Sockets. -[`CSpinButtonCtrl` Class](../../mfc/reference/cspinbuttonctrl-class.md)
+[`CSpinButtonCtrl` Class](cspinbuttonctrl-class.md)\ Provides the functionality of the Windows common spin button control. -[`CSplitButton` Class](../../mfc/reference/csplitbutton-class.md)
+[`CSplitButton` Class](csplitbutton-class.md)\ Represents a split button control. The split button control performs a default behavior when a user clicks the main part of the button, and displays a drop-down menu when a user clicks the drop-down arrow of the button. -[`CSplitterWnd` Class](../../mfc/reference/csplitterwnd-class.md)
+[`CSplitterWnd` Class](csplitterwnd-class.md)\ Provides the functionality of a splitter window, which is a window that contains multiple panes. -[`CSplitterWndEx` Class](csplitterwndex-class.md)
+[`CSplitterWndEx` Class](csplitterwndex-class.md)\ Represents a customized splitter window. -[`CStatic` Class](../../mfc/reference/cstatic-class.md)
+[`CStatic` Class](cstatic-class.md)\ Provides the functionality of a Windows static control. -[`CStatusBar` Class](../../mfc/reference/cstatusbar-class.md)
+[`CStatusBar` Class](cstatusbar-class.md)\ A control bar with a row of text output panes, or "indicators". -[`CStatusBarCtrl` Class](../../mfc/reference/cstatusbarctrl-class.md)
+[`CStatusBarCtrl` Class](cstatusbarctrl-class.md)\ Provides the functionality of the Windows common status bar control. -[`CStdioFile` Class](../../mfc/reference/cstdiofile-class.md)
+[`CStdioFile` Class](cstdiofile-class.md)\ Represents a C run-time stream file as opened by the run-time function [`fopen`, `_wfopen`](../../c-runtime-library/reference/fopen-wfopen.md). -[`CStringArray` Class](../../mfc/reference/cstringarray-class.md)
+[`CStringArray` Class](cstringarray-class.md)\ Supports arrays of `CString` objects. -[`CStringList` Class](../../mfc/reference/cstringlist-class.md)
+[`CStringList` Class](cstringlist-class.md)\ Supports lists of `CString` objects. -[`CSyncObject` Class](../../mfc/reference/csyncobject-class.md)
+[`CSyncObject` Class](csyncobject-class.md)\ A pure virtual class that provides functionality common to the synchronization objects in Win32. -[`CTabbedPane` Class](../../mfc/reference/ctabbedpane-class.md)
+[`CTabbedPane` Class](ctabbedpane-class.md)\ Implements the functionality of a pane with detachable tabs. -[`CTabCtrl` Class](../../mfc/reference/ctabctrl-class.md)
+[`CTabCtrl` Class](ctabctrl-class.md)\ Provides the functionality of the Windows common tab control. -[`CTabView` Class](../../mfc/reference/ctabview-class.md)
-Simplifies the use of the tab control class ([`CTabView` Class](../../mfc/reference/ctabview-class.md)) in applications that use MFC's document/view architecture. +[`CTabView` Class](ctabview-class.md)\ +Simplifies the use of the tab control class ([`CTabView` Class](ctabview-class.md)) in applications that use MFC's document/view architecture. -[`CTaskDialog` Class](../../mfc/reference/ctaskdialog-class.md)
+[`CTaskDialog` Class](ctaskdialog-class.md)\ A pop-up dialog box that functions like a message box but can display additional information to the user. The `CTaskDialog` also includes functionality for gathering information from the user. -[`CToolBar` Class](../../mfc/reference/ctoolbar-class.md)
+[`CToolBar` Class](ctoolbar-class.md)\ Control bars that have a row of bitmapped buttons and optional separators. -[`CToolBarCtrl` Class](../../mfc/reference/ctoolbarctrl-class.md)
+[`CToolBarCtrl` Class](ctoolbarctrl-class.md)\ Provides the functionality of the Windows toolbar common control. -[`CToolTipCtrl` Class](../../mfc/reference/ctooltipctrl-class.md)
+[`CToolTipCtrl` Class](ctooltipctrl-class.md)\ Encapsulates the functionality of a "tool tip control", a small pop-up window that displays a single line of text describing the purpose of a tool in an application. -[`CTooltipManager` Class](../../mfc/reference/ctooltipmanager-class.md)
+[`CTooltipManager` Class](ctooltipmanager-class.md)\ Maintains runtime information about tooltips. The `CTooltipManager` class is instantiated one time per application. -[`CTreeCtrl` Class](../../mfc/reference/ctreectrl-class.md)
+[`CTreeCtrl` Class](ctreectrl-class.md)\ Provides the functionality of the Windows common tree view control. -[`CTreeView` Class](../../mfc/reference/ctreeview-class.md)
-Simplifies use of the tree control and of [`CTreeCtrl` Class](../../mfc/reference/ctreectrl-class.md), the class that encapsulates tree-control functionality, with MFC's document-view architecture. +[`CTreeView` Class](ctreeview-class.md)\ +Simplifies use of the tree control and of [`CTreeCtrl` Class](ctreectrl-class.md), the class that encapsulates tree-control functionality, with MFC's document-view architecture. -[`CTypedPtrArray` Class](../../mfc/reference/ctypedptrarray-class.md)
+[`CTypedPtrArray` Class](ctypedptrarray-class.md)\ Provides a type-safe "wrapper" for objects of class `CPtrArray` or `CObArray`. -[`CTypedPtrList` Class](../../mfc/reference/ctypedptrlist-class.md)
+[`CTypedPtrList` Class](ctypedptrlist-class.md)\ Provides a type-safe "wrapper" for objects of class `CPtrList`. -[`CTypedPtrMap` Class](../../mfc/reference/ctypedptrmap-class.md)
+[`CTypedPtrMap` Class](ctypedptrmap-class.md)\ Provides a type-safe "wrapper" for objects of the pointer-map classes `CMapPtrToPtr`, `CMapPtrToWord`, `CMapWordToPtr`, and `CMapStringToPtr`. -[`CUIntArray` Class](../../mfc/reference/cuintarray-class.md)
+[`CUIntArray` Class](cuintarray-class.md)\ Supports arrays of unsigned integers. -[`CUserException` Class](../../mfc/reference/cuserexception-class.md)
+[`CUserException` Class](cuserexception-class.md)\ Thrown to stop an end-user operation. -[`CUserTool` Class](../../mfc/reference/cusertool-class.md)
-Menu item that runs an external application. The **Tools** tab of the **Customize** dialog box ([`CMFCToolBarsCustomizeDialog` Class](../../mfc/reference/cmfctoolbarscustomizedialog-class.md)) enables the user to add user tools, and to specify the name, command, arguments, and initial directory for each user tool. +[`CUserTool` Class](cusertool-class.md)\ +Menu item that runs an external application. The **Tools** tab of the **Customize** dialog box ([`CMFCToolBarsCustomizeDialog` Class](cmfctoolbarscustomizedialog-class.md)) enables the user to add user tools, and to specify the name, command, arguments, and initial directory for each user tool. -[`CUserToolsManager` Class](../../mfc/reference/cusertoolsmanager-class.md)
-Maintains the collection of [`CUserTool` Class](../../mfc/reference/cusertool-class.md) objects in an application. A user tool is a menu item that runs an external application. The `CUserToolsManager` object enables the user or developer to add new user tools to the application. It supports the execution of the commands associated with user tools, and it also saves information about user tools in the Windows registry. +[`CUserToolsManager` Class](cusertoolsmanager-class.md)\ +Maintains the collection of [`CUserTool` Class](cusertool-class.md) objects in an application. A user tool is a menu item that runs an external application. The `CUserToolsManager` object enables the user or developer to add new user tools to the application. It supports the execution of the commands associated with user tools, and it also saves information about user tools in the Windows registry. -[`CView` Class](../../mfc/reference/cview-class.md)
+[`CView` Class](cview-class.md)\ Provides the basic functionality for user-defined view classes. -[`CVSListBox` Class](../../mfc/reference/cvslistbox-class.md)
+[`CVSListBox` Class](cvslistbox-class.md)\ Supports an editable list control. -[`CWaitCursor` Class](../../mfc/reference/cwaitcursor-class.md)
+[`CWaitCursor` Class](cwaitcursor-class.md)\ Provides a one-line way to show a wait cursor, which is usually displayed as an hourglass, while you're doing a lengthy operation. -[`CWinApp` Class](../../mfc/reference/cwinapp-class.md)
+[`CWinApp` Class](cwinapp-class.md)\ The base class from which you derive a Windows application object. -[`CWinAppEx` Class](../../mfc/reference/cwinappex-class.md)
+[`CWinAppEx` Class](cwinappex-class.md)\ Handles the application state, saves the state to the registry, loads the state from the registry, initializes application managers, and provides links to those same application managers. -[`CWindowDC` Class](../../mfc/reference/cwindowdc-class.md)
+[`CWindowDC` Class](cwindowdc-class.md)\ Derived from `CDC`. -[`CWinFormsControl` Class](../../mfc/reference/cwinformscontrol-class.md)
+[`CWinFormsControl` Class](cwinformscontrol-class.md)\ Provides the basic functionality for hosting of a Windows Forms control. -[`CWinFormsDialog` Class](../../mfc/reference/cwinformsdialog-class.md)
+[`CWinFormsDialog` Class](cwinformsdialog-class.md)\ A wrapper for an MFC dialog class that hosts a Windows Forms user control. -[`CWinFormsView` Class](../../mfc/reference/cwinformsview-class.md)
+[`CWinFormsView` Class](cwinformsview-class.md)\ Provides generic functionality for hosting of a Windows Forms control as an MFC view. -[`CWinThread` Class](../../mfc/reference/cwinthread-class.md)
+[`CWinThread` Class](cwinthread-class.md)\ Represents a thread of execution within an application. -[`CWnd` Class](../../mfc/reference/cwnd-class.md)
+[`CWnd` Class](cwnd-class.md)\ Provides the base functionality of all window classes in the Microsoft Foundation Class Library. -[`CWordArray` Class](../../mfc/reference/cwordarray-class.md)
+[`CWordArray` Class](cwordarray-class.md)\ Supports arrays of 16-bit words. ## Related Sections -[MFC Desktop Applications](../../mfc/mfc-desktop-applications.md)
+[MFC Desktop Applications](../mfc-desktop-applications.md)\ Contains links to topics about the classes, global functions, global variables, and macros that make up the MFC Library. diff --git a/docs/mfc/reference/mfc-dll-wizard.md b/docs/mfc/reference/mfc-dll-wizard.md index 9f7433d1c1c..ad350303e65 100644 --- a/docs/mfc/reference/mfc-dll-wizard.md +++ b/docs/mfc/reference/mfc-dll-wizard.md @@ -16,7 +16,7 @@ This wizard page describes the current [application settings for the MFC DLL pro To change these defaults, click **Application Settings** in the left column of the wizard and make changes in that page of the MFC DLL Wizard. -After you create an MFC DLL project, you can add objects or controls to your project using Visual C++ [code wizards](../../ide/adding-functionality-with-code-wizards-cpp.md). +After you create an MFC DLL project, you can add objects or controls to your project using Visual Studio [code wizards](../../ide/adding-functionality-with-code-wizards-cpp.md). You can perform the following tasks and types of enhancements to a basic MFC DLL project: diff --git a/docs/mfc/reference/styles-used-by-mfc.md b/docs/mfc/reference/styles-used-by-mfc.md index 3afec125dba..7dc94df5291 100644 --- a/docs/mfc/reference/styles-used-by-mfc.md +++ b/docs/mfc/reference/styles-used-by-mfc.md @@ -1,9 +1,8 @@ --- -description: "Learn more about: Styles Used by MFC" title: "Styles Used by MFC" -ms.date: "06/20/2018" +description: "Learn more about: Styles Used by MFC" +ms.date: 06/20/2018 helpviewer_keywords: ["button objects (CButton), button styles", "button styles [MFC]", "buttons, MFC toolbars", "combo boxes [MFC], styles", "edit styles [MFC]", "extended window styles [MFC]", "frame windows [MFC], styles", "list boxes [MFC], styles", "message-box styles [MFC]", "scroll bars [MFC], styles", "scroll-bar styles [MFC]", "static styles [MFC]", "styles [MFC], button objects", "styles [MFC], MFC", "styles [MFC], windows", "styles [MFC]", "window styles, in MFC", "window styles [MFC]", "BS_3STATE constant [MFC]", "BS_AUTO3STATE constant [MFC]", "BS_AUTOCHECKBOX constant [MFC]", "BS_AUTORADIOBUTTON constant [MFC]", "BS_BITMAP constant [MFC]", "BS_BOTTOM constant [MFC]", "BS_CENTER constant [MFC]", "BS_CHECKBOX constant [MFC]", "BS_DEFPUSHBUTTON constant [MFC]", "BS_FLAT constant [MFC]", "BS_GROUPBOX constant [MFC]", "BS_ICON constant [MFC]", "BS_LEFT constant [MFC]", "BS_LEFTTEXT constant [MFC]", "BS_MULTILINE constant [MFC]", "BS_NOTIFY constant [MFC]", "BS_OWNERDRAW constant [MFC]", "BS_PUSHBUTTON constant [MFC]", "BS_PUSHLIKE constant [MFC]", "BS_RADIOBUTTON constant [MFC]", "BS_RIGHT constant [MFC]", "BS_RIGHTBUTTON constant [MFC]", "BS_TEXT constant [MFC]", "BS_TOP constant [MFC]", "BS_USERBUTTON constant [MFC]", "BS_VCENTER constant [MFC]", "CBS_AUTOHSCROLL constant [MFC]", "CBS_DISABLENOSCROLL constant [MFC]", "CBS_DROPDOWN constant [MFC]", "CBS_DROPDOWNLIST constant [MFC]", "CBS_HASSTRINGS constant [MFC]", "CBS_LOWERCASE constant [MFC]", "CBS_NOINTEGRALHEIGHT constant [MFC]", "CBS_OEMCONVERT constant [MFC]", "CBS_OWNERDRAWFIXED constant [MFC]", "CBS_OWNERDRAWVARIABLE constant [MFC]", "CBS_SIMPLE constant [MFC]", "CBS_SORT constant [MFC]", "CBS_UPPERCASE constant [MFC]", "ES_AUTOHSCROLL constant [MFC]", "ES_AUTOVSCROLL constant [MFC]", "ES_CENTER constant [MFC]", "ES_LEFT constant [MFC]", "ES_LOWERCASE constant [MFC]", "ES_MULTILINE constant [MFC]", "ES_NOHIDESEL constant [MFC]", "ES_NUMBER constant [MFC]", "ES_OEMCONVERT constant [MFC]", "ES_PASSWORD constant [MFC]", "ES_READONLY constant [MFC]", "ES_RIGHT constant [MFC]", "ES_UPPERCASE constant [MFC]", "ES_WANTRETURN constant [MFC]", "FWS_ADDTOTITLE constant [MFC]", "FWS_PREFIXTITLE constant [MFC]", "FWS_SNAPTOBARS constant [MFC]", "LBS_DISABLENOSCROLL constant [MFC]", "LBS_EXTENDEDSEL constant [MFC]", "LBS_HASSTRINGS constant [MFC]", "LBS_MULTICOLUMN constant [MFC]", "LBS_MULTIPLESEL constant [MFC]", "LBS_NODATA constant [MFC]", "LBS_NOINTEGRALHEIGHT constant [MFC]", "LBS_NOREDRAW constant [MFC]", "LBS_NOSEL constant [MFC]", "LBS_NOTIFY constant [MFC]", "LBS_OWNERDRAWFIXED constant [MFC]", "LBS_OWNERDRAWVARIABLE constant [MFC]", "LBS_SORT constant [MFC]", "LBS_STANDARD constant [MFC]", "LBS_USETABSTOPS constant [MFC]", "LBS_WANTKEYBOARDINPUT constant [MFC]", "MB_ABORTRETRYOVERWRITE constant [MFC]", "MB_APPLMODAL constant [MFC]", "MB_DEFBUTTON1 constant [MFC]", "MB_DEFBUTTON2 constant [MFC]", "MB_DEFBUTTON3 constant [MFC]", "MB_ICONEXCLAMATION constant [MFC]", "MB_ICONINFORMATION constant [MFC]", "MB_ICONQUESTION constant [MFC]", "MB_ICONSTOP constant [MFC]", "MB_OK constant [MFC]", "MB_OKCANCEL constant [MFC]", "MB_RETRYCANCEL constant [MFC]", "MB_SYSTEMMODAL constant [MFC]", "MB_TASKMODAL constant [MFC]", "MB_YESNO constant [MFC]", "MB_YESNOCANCEL constant [MFC]", "SBS_BOTTOMALIGN constant [MFC]", "SBS_HORZ constant [MFC]", "SBS_LEFTALIGN constant [MFC]", "SBS_RIGHTALIGN constant [MFC]", "SBS_SIZEBOX constant [MFC]", "SBS_SIZEBOXBOTTOMRIGHTALIGN constant [MFC]", "SBS_SIZEBOXTOPLEFTALIGN constant [MFC]", "SBS_TOPALIGN constant [MFC]", "SBS_VERT constant [MFC]", "SS_BITMAP constant [MFC]", "SS_BLACKFRAME constant [MFC]", "SS_BLACKRECT constant [MFC]", "SS_CENTER constant [MFC]", "SS_CENTERIMAGE constant [MFC]", "SS_ENDELLIPSIS constant [MFC]", "SS_ENHMETAFILE constant [MFC]", "SS_ETCHEDFRAME constant [MFC]", "SS_ETCHEDHORZ constant [MFC]", "SS_ETCHEDVERT constant [MFC]", "SS_GRAYFRAME constant [MFC]", "SS_GRAYRECT constant [MFC]", "SS_ICON constant [MFC]", "SS_LEFT constant [MFC]", "SS_LEFTNOWORDWRAP constant [MFC]", "SS_NOPREFIX constant [MFC]", "SS_NOTIFY constant [MFC]", "SS_OWNERDRAW constant [MFC]", "SS_PATHELLIPSIS constant [MFC]", "SS_REALSIZEIMAGE constant [MFC]", "SS_RIGHT constant [MFC]", "SS_RIGHTJUST constant [MFC]", "SS_SIMPLE constant [MFC]", "SS_SUNKEN constant [MFC]", "SS_USERITEM constant [MFC]", "SS_WHITEFRAME constant [MFC]", "SS_WHITERECT constant [MFC]", "SS_WORDELLIPSIS constant [MFC]", "WS_BORDER constant [MFC]", "WS_CAPTION constant [MFC]", "WS_CHILD constant [MFC]", "WS_CHILDWINDOW constant [MFC]", "WS_CLIPCHILDREN constant [MFC]", "WS_CLIPSIBLINGS constant [MFC]", "WS_DISABLED constant [MFC]", "WS_DLGFRAME constant [MFC]", "WS_GROUP constant [MFC]", "WS_HSCROLL constant [MFC]", "WS_ICONIC constant [MFC]", "WS_MAXIMIZE constant [MFC]", "WS_MAXIMIZEBOX constant [MFC]", "WS_MINIMIZE constant [MFC]", "WS_MINIMIZEBOX constant [MFC]", "WS_OVERLAPPED constant [MFC]", "WS_OVERLAPPEDWINDOW constant [MFC]", "WS_POPUP constant [MFC]", "WS_POPUPWINDOW constant [MFC]", "WS_SIZEBOX constant [MFC]", "WS_SYSMENU constant [MFC]", "WS_TABSTOP constant [MFC]", "WS_THICKFRAME constant [MFC]", "WS_TILED constant [MFC]", "WS_TILEDWINDOW constant [MFC]", "WS_VISIBLE constant [MFC]", "WS_VSCROLL constant [MFC]", "WS_EX_ACCEPTFILES constant [MFC]", "WS_EX_APPWINDOW constant [MFC]", "WS_EX_CLIENTEDGE constant [MFC]", "WS_EX_CONTEXTHELP constant [MFC]", "WS_EX_CONTROLPARENT constant [MFC]", "WS_EX_DLGMODALFRAME constant [MFC]", "WS_EX_LEFT constant [MFC]", "WS_EX_LEFTSCROLLBAR constant [MFC]", "WS_EX_LTRREADING constant [MFC]", "WS_EX_MDICHILD constant [MFC]", "WS_EX_NOPARENTNOTIFY constant [MFC]", "WS_EX_OVERLAPPEDWINDOW constant [MFC]", "WS_EX_PALETTEWINDOW constant [MFC]", "WS_EX_RIGHT constant [MFC]", "WS_EX_RIGHTSCROLLBAR constant [MFC]", "WS_EX_RTLREADING constant [MFC]", "WS_EX_STATICEDGE constant [MFC]", "WS_EX_TOOLWINDOW constant [MFC]", "WS_EX_TOPMOST constant [MFC]", "WS_EX_TRANSPARENT constant [MFC]", "WS_EX_WINDOWEDGE constant [MFC]"] -ms.assetid: d3b9af37-31b5-4c97-a8ad-189fd724b04c --- # Styles Used by MFC @@ -11,7 +10,7 @@ Use the following style flags to specify window or control appearance and behavi ## Button styles -Button styles apply to [`CButton Class`](../../mfc/reference/cbutton-class.md) objects, such as radio buttons, check boxes and pushbuttons. Specify a combination of styles in the *`dwStyle`* parameter of [`CButton::Create`](../../mfc/reference/cbutton-class.md#create). For more information on button styles in Windows, see [Button Styles (Windows)](/windows/win32/Controls/button-styles). +Button styles apply to [`CButton Class`](cbutton-class.md) objects, such as radio buttons, check boxes and pushbuttons. Specify a combination of styles in the *`dwStyle`* parameter of [`CButton::Create`](cbutton-class.md#create). For more information on button styles in Windows, see [Button Styles (Windows)](/windows/win32/Controls/button-styles). ### Button types @@ -24,8 +23,8 @@ The following table lists button types. You can optionally choose one of the fol |`BS_AUTOCHECKBOX`|Creates a check box button with two states: `BST_CHECKED` and `BST_UNCHECKED`. Clicking on the button sends a `BN_CLICKED` notification to the owner window and changes the state of the button. By default, associated text is displayed to the right of the check box. To display text to the left of the check box, use the `BS_LEFTTEXT` or `BS_RIGHTBUTTON` style.| |`BS_AUTORADIOBUTTON`|Creates a radio button with two states: `BST_CHECKED` and `BST_UNCHECKED`. Radio buttons are usually used in groups, with each group having a maximum of one checked option at a time. Clicking on the button sends a `BN_CLICKED` notification to the owner window, sets the state of the clicked radio button to `BST_CHECKED`, and sets the states of all other radio buttons in the button group to `BST_UNCHECKED`. By default, associated text is displayed to the right of the radio button. To display text to the left of the radio button, use the `BS_LEFTTEXT` or `BS_RIGHTBUTTON` style.| |`BS_CHECKBOX`|Creates a check box button with two states: `BST_CHECKED` and `BST_UNCHECKED`. Clicking on the button sends a `BN_CLICKED` notification to the owner window but does not change the state of the button. By default, associated text is displayed to the right of the check box. To display text to the left of the check box, use the `BS_LEFTTEXT` or `BS_RIGHTBUTTON` style.| -|`BS_COMMANDLINK`|Creates a command link button. A command link button is a command button specific to Windows Vista that displays a green arrow to the left of the main text and a note below the main text. You can set the note text using [`CButton::SetNote`](../../mfc/reference/cbutton-class.md#setnote).| -|`BS_DEFCOMMANDLINK`|Creates a command link button. A command link button is a command button specific to Windows Vista that displays a green arrow to the left of the main text and a note below the main text. You can set the note text using [`CButton::SetNote`](../../mfc/reference/cbutton-class.md#setnote). If the button is in a dialog box, pressing the ENTER key sends a `BN_CLICKED` notification to the dialog box even when the button does not have the input focus.| +|`BS_COMMANDLINK`|Creates a command link button. A command link button is a command button specific to Windows Vista that displays a green arrow to the left of the main text and a note below the main text. You can set the note text using [`CButton::SetNote`](cbutton-class.md#setnote).| +|`BS_DEFCOMMANDLINK`|Creates a command link button. A command link button is a command button specific to Windows Vista that displays a green arrow to the left of the main text and a note below the main text. You can set the note text using [`CButton::SetNote`](cbutton-class.md#setnote). If the button is in a dialog box, pressing the ENTER key sends a `BN_CLICKED` notification to the dialog box even when the button does not have the input focus.| |`BS_DEFPUSHBUTTON`|Creates a command button that has a heavy black border. If the button is in a dialog box, pressing the ENTER key sends a `BN_CLICKED` notification to the dialog box even when the button does not have the input focus.| |`BS_DEFSPLITBUTTON`|Creates a split button. A split button is a command button specific to Windows Vista that contains a button adjacent to a drop-down arrow. When you click the button, the default command is executed. When you click the drop-down arrow, a menu of additional commands appears. If the split button is in a dialog box, pressing the ENTER key sends a `BN_CLICKED` notification to the dialog box even when the button does not have the input focus| |`BS_GROUPBOX`|Creates a rectangle in which other buttons can be grouped. Text associated with this style is displayed in the rectangle's upper-left corner.| @@ -100,7 +99,7 @@ The following combo-box styles are available in MFC. For more information about ## Edit styles -Edit styles apply to [`CEdit` Class](../../mfc/reference/cedit-class.md) objects. Specify a combination of styles in the *`dwStyle`* parameter of [`CEdit::Create`](../../mfc/reference/cedit-class.md#create). For more information about edit control styles in Windows, see [Edit Control Styles (Windows)](/windows/win32/Controls/edit-control-styles). +Edit styles apply to [`CEdit` Class](cedit-class.md) objects. Specify a combination of styles in the *`dwStyle`* parameter of [`CEdit::Create`](cedit-class.md#create). For more information about edit control styles in Windows, see [Edit Control Styles (Windows)](/windows/win32/Controls/edit-control-styles). |Style|Description| |-----------|-----------------| @@ -121,17 +120,17 @@ Edit styles apply to [`CEdit` Class](../../mfc/reference/cedit-class.md) objects ## Frame-window styles -Frame-window styles apply to [`CFrameWnd` Class](../../mfc/reference/cframewnd-class.md) objects. Specify a combination of styles in the *`dwStyle`* parameter of [`CFrameWnd::Create`](../../mfc/reference/cframewnd-class.md#create). +Frame-window styles apply to [`CFrameWnd` Class](cframewnd-class.md) objects. Specify a combination of styles in the *`dwStyle`* parameter of [`CFrameWnd::Create`](cframewnd-class.md#create). |Style|Description| |-----------|-----------------| |`FWS_ADDTOTITLE`|Specifies information to append to the end of a frame window title. For example, "Microsoft Draw - Drawing in Document1". You can specify the strings displayed in the Document Template Strings tab in the Application Wizard. If you need to turn this option off, override the `CWnd::PreCreateWindow` member function.| |`FWS_PREFIXTITLE`|Shows the document name before the application name in a frame window title. For example, "Document - WordPad". You can specify the strings displayed in the Document Template Strings tab in the Application Wizard. If you need to turn this option off, override the `CWnd::PreCreateWindow` member function.| -|FWS_SNAPTOBARS|Controls sizing of the frame window that encloses a control bar when it is in a floating window rather than docked to a frame window. This style sizes the window to fit the control bar.| +|`FWS_SNAPTOBARS`|Controls sizing of the frame window that encloses a control bar when it is in a floating window rather than docked to a frame window. This style sizes the window to fit the control bar.| ## List-box styles -List-box styles apply to [`CListBox` Class](../../mfc/reference/clistbox-class.md) objects. Specify a combination of styles in the *`dwStyle`* parameter of [`CListBox::Create`](../../mfc/reference/clistbox-class.md#create). For more information about list box styles in Windows, see [List Box Styles (Windows)](/windows/win32/Controls/list-box-styles). +List-box styles apply to [`CListBox` Class](clistbox-class.md) objects. Specify a combination of styles in the *`dwStyle`* parameter of [`CListBox::Create`](clistbox-class.md#create). For more information about list box styles in Windows, see [List Box Styles (Windows)](/windows/win32/Controls/list-box-styles). |Style|Description| |-----------|-----------------| @@ -154,7 +153,7 @@ List-box styles apply to [`CListBox` Class](../../mfc/reference/clistbox-class.m ## Message-box styles -Message-box styles apply to [`AfxMessageBox`](../../mfc/reference/cstring-formatting-and-message-box-display.md#afxmessagebox) items. Specify a combination of styles in the *`nType`* parameter of `AfxMessageBox`. For more information about message box styles in Windows, see [`MessageBox` Function (Windows)](/windows/win32/api/winuser/nf-winuser-messagebox). +Message-box styles apply to [`AfxMessageBox`](cstring-formatting-and-message-box-display.md#afxmessagebox) items. Specify a combination of styles in the *`nType`* parameter of `AfxMessageBox`. For more information about message box styles in Windows, see [`MessageBox` Function (Windows)](/windows/win32/api/winuser/nf-winuser-messagebox). The following message-box styles are available. @@ -196,7 +195,7 @@ The following message-box styles are available. ## Scroll-bar styles -Scroll-bar styles apply to [`CScrollBar` Class](../../mfc/reference/cscrollbar-class.md) objects. Specify a combination of styles in the *`dwStyle`* parameter of [`CScrollBar::Create`](../../mfc/reference/cscrollbar-class.md#create). For more information about scroll bar control styles in Windows, see [Scroll Bar Control Styles (Windows)](/windows/win32/Controls/scroll-bar-control-styles). +Scroll-bar styles apply to [`CScrollBar` Class](cscrollbar-class.md) objects. Specify a combination of styles in the *`dwStyle`* parameter of [`CScrollBar::Create`](cscrollbar-class.md#create). For more information about scroll bar control styles in Windows, see [Scroll Bar Control Styles (Windows)](/windows/win32/Controls/scroll-bar-control-styles). |Style|Description| |-----------|-----------------| @@ -213,7 +212,7 @@ Scroll-bar styles apply to [`CScrollBar` Class](../../mfc/reference/cscrollbar-c ## Static styles -Static styles apply to [`CStatic` Class](../../mfc/reference/cstatic-class.md) objects. Specify a combination of styles in the *`dwStyle`* parameter of [`CStatic::Create`](../../mfc/reference/cstatic-class.md#create). For more information about static control styles in Windows, see [Static Control Styles (Windows)](/windows/win32/Controls/static-control-styles). +Static styles apply to [`CStatic` Class](cstatic-class.md) objects. Specify a combination of styles in the *`dwStyle`* parameter of [`CStatic::Create`](cstatic-class.md#create). For more information about static control styles in Windows, see [Static Control Styles (Windows)](/windows/win32/Controls/static-control-styles). |Style|Description| |-----------|-----------------| @@ -247,7 +246,7 @@ Static styles apply to [`CStatic` Class](../../mfc/reference/cstatic-class.md) o ## Window styles -Window styles apply to [`CWnd` Class](../../mfc/reference/cwnd-class.md) objects. Specify a combination of styles in the *dwStyle* parameter of [`CWnd::Create`](../../mfc/reference/cwnd-class.md#create) or [`CWnd::CreateEx`](../../mfc/reference/cwnd-class.md#createex). For more information about window styles in Windows, see [Window Styles (Windows)](/windows/win32/winmsg/window-styles). +Window styles apply to [`CWnd` Class](cwnd-class.md) objects. Specify a combination of styles in the *dwStyle* parameter of [`CWnd::Create`](cwnd-class.md#create) or [`CWnd::CreateEx`](cwnd-class.md#createex). For more information about window styles in Windows, see [Window Styles (Windows)](/windows/win32/winmsg/window-styles). |Style|Description| |-----------|-----------------| @@ -281,7 +280,7 @@ Window styles apply to [`CWnd` Class](../../mfc/reference/cwnd-class.md) objects ## Extended window styles -Extended window styles apply to [`CWnd` Class](../../mfc/reference/cwnd-class.md) objects. Specify a combination of styles in the *`dwExStyle`* parameter of [`CWnd::CreateEx`](../../mfc/reference/cwnd-class.md#createex). For more information about extended window styles in Windows, see [Extended Window Styles (Windows)](/windows/win32/winmsg/extended-window-styles). +Extended window styles apply to [`CWnd` Class](cwnd-class.md) objects. Specify a combination of styles in the *`dwExStyle`* parameter of [`CWnd::CreateEx`](cwnd-class.md#createex). For more information about extended window styles in Windows, see [Extended Window Styles (Windows)](/windows/win32/winmsg/extended-window-styles). |Style|Description| |-----------|-----------------| @@ -310,21 +309,21 @@ Extended window styles apply to [`CWnd` Class](../../mfc/reference/cwnd-class.md ## See also -[MFC Class Overview](../../mfc/class-library-overview.md)
-[`CWnd::Create`](../../mfc/reference/cwnd-class.md#create)
-[`CWnd::CreateEx`](../../mfc/reference/cwnd-class.md#createex)
-[`CEdit::Create`](../../mfc/reference/cedit-class.md#create)
-[`CScrollBar::Create`](../../mfc/reference/cscrollbar-class.md#create)
-[`CStatic::Create`](../../mfc/reference/cstatic-class.md#create)
-[`AfxMessageBox`](../../mfc/reference/cstring-formatting-and-message-box-display.md#afxmessagebox)
-[`CreateWindow`](/windows/win32/api/winuser/nf-winuser-createwindoww)
-[`CreateWindowEx`](/windows/win32/api/winuser/nf-winuser-createwindowexw)
-[Button Styles (Windows)](/windows/win32/Controls/button-styles)
-[Combo Box Styles (Windows)](/windows/win32/Controls/combo-box-styles)
-[Edit Control Styles (Windows)](/windows/win32/Controls/edit-control-styles)
-[List Box Styles (Windows)](/windows/win32/Controls/list-box-styles)
-[`MessageBox` Function (Windows)](/windows/win32/api/winuser/nf-winuser-messagebox)
-[Scroll Bar Control Styles (Windows)](/windows/win32/Controls/scroll-bar-control-styles)
-[Static Control Styles (Windows)](/windows/win32/Controls/static-control-styles)
-[Window Styles (Windows)](/windows/win32/winmsg/window-styles)
+[MFC Class Overview](../class-library-overview.md)\ +[`CWnd::Create`](cwnd-class.md#create)\ +[`CWnd::CreateEx`](cwnd-class.md#createex)\ +[`CEdit::Create`](cedit-class.md#create)\ +[`CScrollBar::Create`](cscrollbar-class.md#create)\ +[`CStatic::Create`](cstatic-class.md#create)\ +[`AfxMessageBox`](cstring-formatting-and-message-box-display.md#afxmessagebox)\ +[`CreateWindow`](/windows/win32/api/winuser/nf-winuser-createwindoww)\ +[`CreateWindowEx`](/windows/win32/api/winuser/nf-winuser-createwindowexw)\ +[Button Styles (Windows)](/windows/win32/Controls/button-styles)\ +[Combo Box Styles (Windows)](/windows/win32/Controls/combo-box-styles)\ +[Edit Control Styles (Windows)](/windows/win32/Controls/edit-control-styles)\ +[List Box Styles (Windows)](/windows/win32/Controls/list-box-styles)\ +[`MessageBox` Function (Windows)](/windows/win32/api/winuser/nf-winuser-messagebox)\ +[Scroll Bar Control Styles (Windows)](/windows/win32/Controls/scroll-bar-control-styles)\ +[Static Control Styles (Windows)](/windows/win32/Controls/static-control-styles)\ +[Window Styles (Windows)](/windows/win32/winmsg/window-styles)\ [Extended Window Styles (Windows)](/windows/win32/winmsg/extended-window-styles) diff --git a/docs/mfc/registering-window-classes.md b/docs/mfc/registering-window-classes.md index 2d37bda3fb5..20bf96df284 100644 --- a/docs/mfc/registering-window-classes.md +++ b/docs/mfc/registering-window-classes.md @@ -5,6 +5,7 @@ ms.date: "11/04/2016" f1_keywords: ["WndProc"] helpviewer_keywords: ["window classes [MFC], registering", "registry [MFC], registering classes", "AfxRegisterWndClass method [MFC]", "MFC, windows", "WinMain method [MFC], and registering window classes", "WndProc method [MFC]", "classes [MFC], registering window classes", "WinMain method [MFC]", "registering window classes [MFC]"] ms.assetid: 30994bc4-a362-43da-bcc5-1bf67a3fc929 +ms.topic: concept-article --- # Registering Window Classes diff --git a/docs/mfc/relationship-to-the-c-language-api.md b/docs/mfc/relationship-to-the-c-language-api.md index b055335b658..22c012bd971 100644 --- a/docs/mfc/relationship-to-the-c-language-api.md +++ b/docs/mfc/relationship-to-the-c-language-api.md @@ -9,7 +9,7 @@ ms.assetid: 334e8efc-f3cc-4018-bc2e-02908b2a39fe The single characteristic that sets the Microsoft Foundation Class (MFC) Library apart from other class libraries for Windows is the very close mapping to the Windows API written in the C language. Further, you can generally mix calls to the class library freely with direct calls to the Windows API. This direct access does not, however, imply that the classes are a complete replacement for that API. Developers must still occasionally make direct calls to some Windows functions, such as [SetCursor](/windows/win32/api/winuser/nf-winuser-setcursor) and [GetSystemMetrics](/windows/win32/api/winuser/nf-winuser-getsystemmetrics), for example. A Windows function is wrapped by a class member function only when there is a clear advantage to doing so. -Because you sometimes need to make native Windows function calls, you should have access to the C-language Windows API documentation. This documentation is included with Microsoft Visual C++. +Because you sometimes need to make native Windows function calls, you should have access to the C-language Windows API documentation. This documentation is included with Visual Studio. > [!NOTE] > For an overview of how the MFC Library framework operates, see [Using the Classes to Write Applications for Windows](../mfc/using-the-classes-to-write-applications-for-windows.md). diff --git a/docs/mfc/responding-to-dynamic-data-exchange-dde.md b/docs/mfc/responding-to-dynamic-data-exchange-dde.md index 9ec13c9df44..cfcc4ddc454 100644 --- a/docs/mfc/responding-to-dynamic-data-exchange-dde.md +++ b/docs/mfc/responding-to-dynamic-data-exchange-dde.md @@ -4,6 +4,7 @@ title: "Responding to Dynamic Data Exchange (DDE)" ms.date: "11/04/2016" helpviewer_keywords: ["registry [MFC], most recently used files", "frame windows [MFC], dynamic data exchange (DDE)", "DDE (Dynamic Data Exchange), frame windows", "registration [MFC], shell", "Shell [MFC], registering file types", "windows [MFC], and dynamic data exchange", "responding to dynamic data exchange (DDE)", "frame windows [MFC], shell registration"] ms.assetid: 4db838d5-62cf-4123-915a-66e514155c0c +ms.topic: concept-article --- # Responding to Dynamic Data Exchange (DDE) diff --git a/docs/mfc/retrieving-data-from-the-dialog-object.md b/docs/mfc/retrieving-data-from-the-dialog-object.md index 7c870f78077..0177ee9d4a8 100644 --- a/docs/mfc/retrieving-data-from-the-dialog-object.md +++ b/docs/mfc/retrieving-data-from-the-dialog-object.md @@ -4,6 +4,7 @@ title: "Retrieving Data from the Dialog Object" ms.date: "11/04/2016" helpviewer_keywords: ["dialog boxes [MFC], retrieving user data", "dialog box data [MFC]", "data [MFC], retrieving", "GetDlgItemText method [MFC]", "SetDlgItemText method [MFC]", "SetWindowText method [MFC]", "dialog box data [MFC], retrieving", "retrieving data [MFC]", "user input [MFC], retrieving from MFC dialog boxes", "capturing user input [MFC]", "dialog box controls [MFC], initializing values", "DDX (dialog data exchange) [MFC]", "MFC dialog boxes [MFC], retrieving user input", "data retrieval [MFC], dialog boxes", "data [MFC], dialog boxes", "DDX (dialog data exchange) [MFC], about DDX", "DDX (dialog data exchange) [MFC], retrieving data from Dialog object", "GetWindowText method [MFC]"] ms.assetid: bdca2b61-6b53-4c2e-b426-8712c7a38ec0 +ms.topic: concept-article --- # Retrieving Data from the Dialog Object diff --git a/docs/mfc/rubber-banding-and-trackers.md b/docs/mfc/rubber-banding-and-trackers.md index 4fb1ae81c9b..78313d57451 100644 --- a/docs/mfc/rubber-banding-and-trackers.md +++ b/docs/mfc/rubber-banding-and-trackers.md @@ -4,6 +4,7 @@ title: "Rubber-Banding and Trackers" ms.date: "11/04/2016" helpviewer_keywords: ["trackers [MFC]", "CRectTracker class [MFC], implementing trackers", "OLE objects [MFC], selecting", "rubber banding [MFC]", "WM_LBUTTONDOWN [MFC]"] ms.assetid: 0d0fa64c-6418-4baf-ab7f-2d16ca039230 +ms.topic: concept-article --- # Rubber-Banding and Trackers diff --git a/docs/mfc/scrolling-and-scaling-views.md b/docs/mfc/scrolling-and-scaling-views.md index 997ef315f89..ae3f1dd968d 100644 --- a/docs/mfc/scrolling-and-scaling-views.md +++ b/docs/mfc/scrolling-and-scaling-views.md @@ -4,6 +4,7 @@ title: "Scrolling and Scaling Views" ms.date: "11/04/2016" helpviewer_keywords: ["message handlers [MFC]", "scaling views [MFC]", "message handling [MFC], scroll bars in view class [MFC]", "scroll bars [MFC], messages", "scrolling views [MFC]"] ms.assetid: f98a3421-c336-407e-97ee-dbb2ffd76fbd +ms.topic: concept-article --- # Scrolling and Scaling Views diff --git a/docs/mfc/selecting-a-graphic-object-into-a-device-context.md b/docs/mfc/selecting-a-graphic-object-into-a-device-context.md index 711b5ca8758..722c6609e74 100644 --- a/docs/mfc/selecting-a-graphic-object-into-a-device-context.md +++ b/docs/mfc/selecting-a-graphic-object-into-a-device-context.md @@ -4,6 +4,7 @@ title: "Selecting a Graphic Object into a Device Context" ms.date: "11/04/2016" helpviewer_keywords: ["graphic objects [MFC], selecting into device context", "SelectObject method [MFC]", "GDI objects [MFC], device contexts", "lifetime, graphic objects [MFC]", "device contexts, selecting graphic objects into", "device contexts, graphic objects [MFC]"] ms.assetid: cf54a330-63ef-421f-83eb-90ec7bd82eef +ms.topic: concept-article --- # Selecting a Graphic Object into a Device Context diff --git a/docs/mfc/sequence-of-operations-for-building-mfc-applications.md b/docs/mfc/sequence-of-operations-for-building-mfc-applications.md index 3c77d334150..529a989c36c 100644 --- a/docs/mfc/sequence-of-operations-for-building-mfc-applications.md +++ b/docs/mfc/sequence-of-operations-for-building-mfc-applications.md @@ -14,8 +14,8 @@ The following table explains the general sequence you might typically follow as |Task|You do|The framework does| |----------|------------|------------------------| |Create a skeleton application.|Run the [MFC Application Wizard](../mfc/reference/mfc-application-wizard.md). Specify the options you want in the options pages. Options include making the application a COM component, container, or both; adding Automation; and making the application database-aware.|The MFC Application Wizard creates the files for a skeleton application, including source files for your application, document, view, and frame windows; a resource file; a project file; and others, all tailored to your specifications.| -|See what the framework and the MFC Application Wizard offer without adding a line of your own code.|Build the skeleton application and run it in Visual C++.|The running skeleton application derives many standard **File**, **Edit**, **View**, and **Help** menu commands from the framework. For MDI applications, you also get a fully functional Windows menu, and the framework manages creation, arrangement, and destruction of MDI child windows.| -|Construct your application's user interface.|Use the Visual C++ [resource editors](../windows/resource-editors.md) to visually edit the application's user interface:

- Create menus.
- Define accelerators.
- Create dialog boxes.
- Create and edit bitmaps, icons, and cursors.
- Edit the toolbar created for you by the MFC Application Wizard.
- Create and edit other resources.

You can also test the dialog boxes in the dialog editor.|The default resource file created by the MFC Application Wizard supplies many of the resources you need. Visual C++ lets you edit existing resources and add new resources easily and visually.| +|See what the framework and the MFC Application Wizard offer without adding a line of your own code.|Build the skeleton application and run it in Visual Studio.|The running skeleton application derives many standard **File**, **Edit**, **View**, and **Help** menu commands from the framework. For MDI applications, you also get a fully functional Windows menu, and the framework manages creation, arrangement, and destruction of MDI child windows.| +|Construct your application's user interface.|Use the Visual Studio [resource editors](../windows/resource-editors.md) to visually edit the application's user interface:

- Create menus.
- Define accelerators.
- Create dialog boxes.
- Create and edit bitmaps, icons, and cursors.
- Edit the toolbar created for you by the MFC Application Wizard.
- Create and edit other resources.

You can also test the dialog boxes in the dialog editor.|The default resource file created by the MFC Application Wizard supplies many of the resources you need. Visual Studio lets you edit existing resources and add new resources easily and visually.| |Map menus to handler functions.|Use the **Events** button in the [**Properties** window](/visualstudio/ide/reference/properties-window) in **Class View** (or the **Commands** tab in [Class Wizard](reference/mfc-class-wizard.md)) to connect menus and accelerators to handler functions in your code.|These tools insert message-map entries and empty function templates into the source files you specify and manages many manual coding tasks.| |Write your handler code.|Use Class View to jump directly to the code in the source code editor. Fill in the code for your handler functions. For more information on using Class View and about wizards that add code to a project, see [Adding Functionality with Code Wizards](../ide/adding-functionality-with-code-wizards-cpp.md).|Class View opens the editor, scrolls to the empty function template and positions the cursor for you.| |Map toolbar buttons to commands.|Map each button on your toolbar to a menu or accelerator command by assigning the button the appropriate command ID.|The framework controls the drawing, enabling, disabling, checking, and other visual aspects of the toolbar buttons.| @@ -33,7 +33,7 @@ The following table explains the general sequence you might typically follow as |Create database forms.|If you want a form-based data-access application, derive your view class from [CRecordView](../mfc/reference/crecordview-class.md) (for ODBC programming).|The view works like a form view, but its controls are connected to the fields of a [CRecordset](../mfc/reference/crecordset-class.md) object representing a database table. MFC moves data between the controls and the recordset for you.| |Create a simple text editor.|If you want your view to be a simple text editor, derive your view class or classes from [CEditView](../mfc/reference/ceditview-class.md) or [CRichEditView](../mfc/reference/cricheditview-class.md).|The view provides editing functions, Clipboard support, and file input/output. `CRichEditView` provides styled text.| |Add splitter windows.|If you want to support window splitting, add a [CSplitterWnd](../mfc/reference/csplitterwnd-class.md) object to your SDI frame window or MDI child window and hook it up in the window's [OnCreateClient](../mfc/reference/cframewnd-class.md#oncreateclient) member function.|The framework supplies splitter-box controls next to the scroll bars and manages splitting your view into multiple panes. If the user splits a window, the framework creates and attaches additional view objects to the document.| -|Build, test, and debug your application.|Use the facilities of Visual C++ to build, test, and debug your application.|Visual C++ lets you adjust compile, link, and other options. It also lets you browse your source code and class structure.| +|Build, test, and debug your application.|Use the facilities of Visual Studio to build, test, and debug your application.|Visual Studio lets you adjust compile, link, and other options. It also lets you browse your source code and class structure.| ## See also diff --git a/docs/mfc/sequence-of-operations-for-creating-activex-controls.md b/docs/mfc/sequence-of-operations-for-creating-activex-controls.md index 1b1dc9884d5..e534e12453f 100644 --- a/docs/mfc/sequence-of-operations-for-creating-activex-controls.md +++ b/docs/mfc/sequence-of-operations-for-creating-activex-controls.md @@ -16,7 +16,7 @@ The following table shows your role and the framework's role in creating ActiveX |Create an ActiveX control framework.|Run the MFC ActiveX Control Wizard to create your control. Specify the options you want in the options pages. Options include the type and name of the control in the project, licensing, subclassing, and an About Box method.|The MFC ActiveX Control Wizard creates the files for an ActiveX control with basic functionality, including source files for your application, control, and property page or pages; a resource file; a project file; and others, all tailored to your specifications.| |See what the control and the ActiveX Control Wizard offer without adding a line of your own code.|Build the ActiveX control and test it with Internet Explorer or the [TSTCON sample](../overview/visual-cpp-samples.md).|The running control has the ability to be resized and moved. It also has an **About Box** method (if chosen) that can be invoked.| |Implement the control's methods and properties.|Implement your control-specific methods and properties by adding member functions to provide an exposed interface to the control's data. Add member variables to hold data structures and use event handlers to fire events when you determine.|The framework has already defined a map to support the control's events, properties, and methods, leaving you to focus on how the properties and methods are implemented. The default property page is viewable and a default About Box method is supplied.| -|Construct the control's property page or pages.|Use the Visual C++ resource editors to visually edit the control's property page interface:

- Create additional property pages.
- Create and edit bitmaps, icons, and cursors.

You can also test the property page(s) in the dialog editor.|The default resource file created by the MFC Application Wizard supplies many of the resources you need. Visual C++ lets you edit existing resources and add new resources easily and visually.| +|Construct the control's property page or pages.|Use the Visual Studio resource editors to visually edit the control's property page interface:

- Create additional property pages.
- Create and edit bitmaps, icons, and cursors.

You can also test the property page(s) in the dialog editor.|The default resource file created by the MFC Application Wizard supplies many of the resources you need. Visual Studio lets you edit existing resources and add new resources easily and visually.| |Test the control's events, methods, and properties.|Rebuild the control and use Test Container to test that your handlers work correctly.|You can invoke the control's methods and manipulate its properties through the property page interface or through Test Container. In addition, use Test Container to track events fired from the control and notifications received by the control's container.| ## See also diff --git a/docs/mfc/sequence-of-operations-for-creating-database-applications.md b/docs/mfc/sequence-of-operations-for-creating-database-applications.md index 2f39ff70f31..8243421de2d 100644 --- a/docs/mfc/sequence-of-operations-for-creating-database-applications.md +++ b/docs/mfc/sequence-of-operations-for-creating-database-applications.md @@ -10,7 +10,7 @@ ms.assetid: 9371da59-8536-43cd-8314-706ad320e2ec The following table shows your role and the framework's role in writing database applications. > [!NOTE] -> The Visual C++ environment and wizards do not support DAO (although the DAO classes are included and you can still use them). Microsoft recommends that you use ODBC for new MFC projects. You should only use DAO in maintaining existing applications. +> The Visual Studio environment and wizards do not support DAO (although the DAO classes are included and you can still use them). Microsoft recommends that you use ODBC for new MFC projects. You should only use DAO in maintaining existing applications. ### Creating Database Applications @@ -18,7 +18,7 @@ The following table shows your role and the framework's role in writing database |----------|------------|------------------------| |Decide whether to use the MFC ODBC or DAO classes.|Use ODBC for new MFC projects. Use DAO only to maintain existing applications. For general information, see the article [Data Access Programming](../data/data-access-programming-mfc-atl.md).|The framework supplies classes that support database access.| |Create your skeleton application with database options.|Run the MFC Application Wizard. Select options on the Database Support page. If you choose an option that creates a record view, also specify:

- Data source and table name or names
- Query name or names.|The MFC Application Wizard creates files and specifies the necessary includes. Depending on the options you specify, the files can include a recordset class.| -|Design your database form or forms.|Use the Visual C++ dialog editor to place controls on the dialog template resources for your record view classes.|The MFC Application Wizard creates an empty dialog template resource for you to fill in.| +|Design your database form or forms.|Use the Visual Studio dialog editor to place controls on the dialog template resources for your record view classes.|The MFC Application Wizard creates an empty dialog template resource for you to fill in.| |Create additional record view and recordset classes as needed.|Use Class View to create the classes and the dialog editor to design the views.|Class View creates additional files for your new classes.| |Create recordset objects as needed in your code. Use each recordset to manipulate records...|Your recordsets are based on the classes derived from [CRecordset](../mfc/reference/crecordset-class.md) with the wizards.|ODBC uses record field exchange (RFX) to exchange data between the database and your recordset's field data members. If you are using a record view, dialog data exchange (DDX) exchanges data between the recordset and the controls on the record view.| |...or create an explicit [CDatabase](../mfc/reference/cdatabase-class.md) in your code for each database you want to open.|Base your recordset objects on the database objects.|The database object provides an interface to the data source.| diff --git a/docs/mfc/serializing-data-to-and-from-files.md b/docs/mfc/serializing-data-to-and-from-files.md index 9fac8aba10d..4131496be72 100644 --- a/docs/mfc/serializing-data-to-and-from-files.md +++ b/docs/mfc/serializing-data-to-and-from-files.md @@ -4,6 +4,7 @@ title: "Serializing Data to and from Files" ms.date: "11/04/2016" helpviewer_keywords: ["documents [MFC], serialization", "documents [MFC], saving", "saving documents", "deserialization [MFC]", "serialization [MFC], role of document", "serialization [MFC], role of data", "data [MFC]", "data [MFC], serializing", "document data [MFC]"] ms.assetid: b42a0c68-4bc4-4012-9938-5433a26d2c24 +ms.topic: concept-article --- # Serializing Data to and from Files diff --git a/docs/mfc/servers-implementing-in-place-frame-windows.md b/docs/mfc/servers-implementing-in-place-frame-windows.md index 3349e0c1357..ae276eda3ea 100644 --- a/docs/mfc/servers-implementing-in-place-frame-windows.md +++ b/docs/mfc/servers-implementing-in-place-frame-windows.md @@ -7,7 +7,7 @@ ms.assetid: 09bde4d8-15e2-4fba-8d14-9b954d926b92 --- # Servers: Implementing In-Place Frame Windows -This article explains what you must do to implement in-place frame windows in your visual editing server application if you do not use the application wizard to create your server application. In place of following the procedure outlined in this article, you could use an existing in-place frame-window class from either an application wizard-generated application or a sample provided with Visual C++. +This article explains what you must do to implement in-place frame windows in your visual editing server application if you do not use the application wizard to create your server application. In place of following the procedure outlined in this article, you could use an existing in-place frame-window class from either an application wizard-generated application or a sample provided with Visual Studio. #### To declare an in-place frame-window class diff --git a/docs/mfc/setting-a-hot-key.md b/docs/mfc/setting-a-hot-key.md index 75e08246041..fbe03ecfbdd 100644 --- a/docs/mfc/setting-a-hot-key.md +++ b/docs/mfc/setting-a-hot-key.md @@ -4,6 +4,7 @@ title: "Setting a Hot Key" ms.date: "11/04/2016" helpviewer_keywords: ["keyboard shortcuts [MFC], hot keys", "access keys [MFC], hot keys", "CHotKeyCtrl class [MFC], setting hot key"] ms.assetid: 6f3bc141-e346-4dce-9ca7-3e6b2c453f3f +ms.topic: concept-article --- # Setting a Hot Key diff --git a/docs/mfc/setting-the-day-state-of-a-month-calendar-control.md b/docs/mfc/setting-the-day-state-of-a-month-calendar-control.md index 1ab946d3d7d..f563ff6a993 100644 --- a/docs/mfc/setting-the-day-state-of-a-month-calendar-control.md +++ b/docs/mfc/setting-the-day-state-of-a-month-calendar-control.md @@ -5,6 +5,7 @@ ms.date: "11/04/2016" f1_keywords: ["MCN_GETDAYSTATE"] helpviewer_keywords: ["CMonthCalCtrl class [MFC], setting day state info", "MCN_GETDAYSTATE notification [MFC]", "month calendar controls [MFC], day state info"] ms.assetid: 435d1b11-ec0e-4121-9e25-aaa6af812a3c +ms.topic: how-to --- # Setting the Day State of a Month Calendar Control diff --git a/docs/mfc/setting-the-dialog-boxs-background-color.md b/docs/mfc/setting-the-dialog-boxs-background-color.md index 79353401604..f9636fc6710 100644 --- a/docs/mfc/setting-the-dialog-boxs-background-color.md +++ b/docs/mfc/setting-the-dialog-boxs-background-color.md @@ -3,6 +3,7 @@ description: "Learn more about: Setting the Dialog Box's Background Color" title: "Setting the Dialog Box's Background Color" ms.date: 11/17/2023 helpviewer_keywords: ["CSS, background attributes in styles [MFC]", "HTML element formatting, background attributes", "colors, dialog box", "dialog boxes [MFC], colors", "background colors, dialog boxes", "MFC dialog boxes [MFC], colors"] +ms.topic: concept-article --- # Setting the Dialog Box's Background Color diff --git a/docs/mfc/setting-the-images-for-an-individual-item.md b/docs/mfc/setting-the-images-for-an-individual-item.md index 88a9906b6d2..d8b1d62da58 100644 --- a/docs/mfc/setting-the-images-for-an-individual-item.md +++ b/docs/mfc/setting-the-images-for-an-individual-item.md @@ -4,6 +4,7 @@ title: "Setting the Images for an Individual Item" ms.date: "11/04/2016" helpviewer_keywords: ["extended combo boxes [MFC], images", "images [MFC], combo box items"] ms.assetid: bde83db8-23a7-4e35-837a-c86447d2c0af +ms.topic: how-to --- # Setting the Images for an Individual Item diff --git a/docs/mfc/setting-the-mode-of-a-cstatusbarctrl-object.md b/docs/mfc/setting-the-mode-of-a-cstatusbarctrl-object.md index bdfd84d65d0..2b6710e45a3 100644 --- a/docs/mfc/setting-the-mode-of-a-cstatusbarctrl-object.md +++ b/docs/mfc/setting-the-mode-of-a-cstatusbarctrl-object.md @@ -4,6 +4,7 @@ title: "Setting the Mode of a CStatusBarCtrl Object" ms.date: "11/04/2016" helpviewer_keywords: ["simple mode and status bar controls", "IsSimple method, using", "SetSimple method [MFC]", "status bar controls [MFC], simple and nonsimple modes", "non-simple mode and status bar controls", "CStatusBarCtrl class [MFC], simple and nonsimple modes"] ms.assetid: ca6076e5-1501-4e33-8d35-9308941e46c0 +ms.topic: concept-article --- # Setting the Mode of a CStatusBarCtrl Object diff --git a/docs/mfc/slider-control-member-functions.md b/docs/mfc/slider-control-member-functions.md index 10e1c674727..2e0e2228d90 100644 --- a/docs/mfc/slider-control-member-functions.md +++ b/docs/mfc/slider-control-member-functions.md @@ -9,7 +9,7 @@ ms.assetid: dbde49ee-7306-4d14-a6ce-d09aa198178f An application can call the slider control's member functions to retrieve information about the slider control ([CSliderCtrl](../mfc/reference/csliderctrl-class.md)) and to change its characteristics. -To retrieve the position of the slider (that is, the value the user has chosen), use the [GetPos](../mfc/reference/csliderctrl-class.md#getpos) member function. To set the position of the slider, use the [SetPos](../mfc/reference/csliderctrl-class.md#setpos) member function. At any time you can use the `VerifyPos` member function to make sure that the slider is between the minimum and maximum values. +To retrieve the position of the slider (that is, the value the user has chosen), use the [GetPos](../mfc/reference/csliderctrl-class.md#getpos) member function. To set the position of the slider, use the [SetPos](../mfc/reference/csliderctrl-class.md#setpos) member function. The range of a slider control is the set of contiguous values that the slider control can represent. Most applications use the [SetRange](../mfc/reference/csliderctrl-class.md#setrange) member function to set the range of a slider control when it is first created. Applications can dynamically alter the range after the slider control has been created by using the [SetRangeMax](../mfc/reference/csliderctrl-class.md#setrangemax) and [SetRangeMin](../mfc/reference/csliderctrl-class.md#setrangemin) member functions. An application that allows the range to be changed dynamically typically retrieves the final range settings when the user has finished working with the slider control. To retrieve these settings, use the [GetRange](../mfc/reference/csliderctrl-class.md#getrange), [GetRangeMax](../mfc/reference/csliderctrl-class.md#getrangemax), and [GetRangeMin](../mfc/reference/csliderctrl-class.md#getrangemin) member functions. diff --git a/docs/mfc/specifying-levels-of-functionality.md b/docs/mfc/specifying-levels-of-functionality.md index 66ae19f7f99..cfaa99c8a47 100644 --- a/docs/mfc/specifying-levels-of-functionality.md +++ b/docs/mfc/specifying-levels-of-functionality.md @@ -4,6 +4,7 @@ title: "Specifying Levels of Functionality" ms.date: "11/06/2018" helpviewer_keywords: ["CObject class [MFC], adding functionality to derived classes", "runtime [MFC], class information", "serialization [MFC], Cobject", "dynamic creation support", "levels [MFC], functionality in CObject", "run-time class [MFC], information support", "levels [MFC]"] ms.assetid: 562669ba-c858-4f66-b5f1-b3beeea4f486 +ms.topic: how-to --- # Specifying Levels of Functionality diff --git a/docs/mfc/steps-in-a-typical-ftp-client-application-to-delete-a-file.md b/docs/mfc/steps-in-a-typical-ftp-client-application-to-delete-a-file.md index 258b8a4d22f..fe0603edff7 100644 --- a/docs/mfc/steps-in-a-typical-ftp-client-application-to-delete-a-file.md +++ b/docs/mfc/steps-in-a-typical-ftp-client-application-to-delete-a-file.md @@ -4,6 +4,7 @@ title: "Steps in a Typical FTP Client Application to Delete a File" ms.date: "11/04/2016" helpviewer_keywords: ["Internet client applications [MFC], FTP delete", "WinInet classes [MFC], FTP", "FTP (File Transfer Protocol) [MFC], client applications", "Internet applications [MFC], FTP client applications"] ms.assetid: 2c347a96-c0a4-4827-98fe-668406e552bc +ms.topic: how-to --- # Steps in a Typical FTP Client Application to Delete a File diff --git a/docs/mfc/steps-in-a-typical-ftp-client-application.md b/docs/mfc/steps-in-a-typical-ftp-client-application.md index d84e6990dc8..c1d16114ffe 100644 --- a/docs/mfc/steps-in-a-typical-ftp-client-application.md +++ b/docs/mfc/steps-in-a-typical-ftp-client-application.md @@ -4,6 +4,7 @@ title: "Steps in a Typical FTP Client Application" ms.date: "11/04/2016" helpviewer_keywords: ["Internet client applications [MFC], FTP table", "FTP (File Transfer Protocol)", "WinInet classes [MFC], FTP", "FTP (File Transfer Protocol) [MFC], client applications", "Internet applications [MFC], FTP client applications"] ms.assetid: 70bed7b5-6040-40d1-bc77-702e63a698f2 +ms.topic: how-to --- # Steps in a Typical FTP Client Application diff --git a/docs/mfc/steps-in-a-typical-gopher-client-application.md b/docs/mfc/steps-in-a-typical-gopher-client-application.md index 6b00efb5591..4468557ab4d 100644 --- a/docs/mfc/steps-in-a-typical-gopher-client-application.md +++ b/docs/mfc/steps-in-a-typical-gopher-client-application.md @@ -4,6 +4,7 @@ title: "Steps in a Typical Gopher Client Application" ms.date: "11/04/2016" helpviewer_keywords: ["WinInet classes [MFC], gopher", "Internet applications [MFC], gopher client applications", "Gopher client applications [MFC]", "Internet client applications [MFC], gopher table"] ms.assetid: 3e4e1869-5da0-453d-8ba9-b648c894bb90 +ms.topic: how-to --- # Steps in a Typical Gopher Client Application diff --git a/docs/mfc/steps-in-a-typical-http-client-application.md b/docs/mfc/steps-in-a-typical-http-client-application.md index 96b6b19fee6..fa830ffcdb9 100644 --- a/docs/mfc/steps-in-a-typical-http-client-application.md +++ b/docs/mfc/steps-in-a-typical-http-client-application.md @@ -4,6 +4,7 @@ title: "Steps in a Typical HTTP Client Application" ms.date: "11/04/2016" helpviewer_keywords: ["HTTP client applications [MFC]", "client applications [MFC], HTTP", "Internet applications [MFC], HTTP client applications", "applications [MFC], HTTP client", "Internet client applications [MFC], HTTP table", "WinInet classes [MFC], HTTP"] ms.assetid: f86552e8-8acd-4b23-bdc5-0c3a247ebd74 +ms.topic: how-to --- # Steps in a Typical HTTP Client Application diff --git a/docs/mfc/steps-in-a-typical-internet-client-application.md b/docs/mfc/steps-in-a-typical-internet-client-application.md index 927d514d1e1..24f95bcbc51 100644 --- a/docs/mfc/steps-in-a-typical-internet-client-application.md +++ b/docs/mfc/steps-in-a-typical-internet-client-application.md @@ -4,6 +4,7 @@ title: "Steps in a Typical Internet Client Application" ms.date: "11/04/2016" helpviewer_keywords: ["Internet client applications [MFC], general table", "WinInet classes [MFC], programming", "Internet applications [MFC], client applications"] ms.assetid: 7aba135c-7c15-4e2f-8c34-bbaf792c89a6 +ms.topic: how-to --- # Steps in a Typical Internet Client Application diff --git a/docs/mfc/storing-and-loading-cobjects-via-an-archive.md b/docs/mfc/storing-and-loading-cobjects-via-an-archive.md index ccbafa9bdb8..f08ce386eab 100644 --- a/docs/mfc/storing-and-loading-cobjects-via-an-archive.md +++ b/docs/mfc/storing-and-loading-cobjects-via-an-archive.md @@ -4,6 +4,7 @@ title: "Storing and Loading CObjects via an Archive" ms.date: "11/04/2016" helpviewer_keywords: ["CObjects [MFC], loading through archives", "CArchive class [MFC], storing and loading objects", "Serialize method, vs. CArchive operators", "CObject class [MFC], CArchive objects", "CObjects [MFC]"] ms.assetid: a829b6dd-bc31-47e0-8108-fbb946722db9 +ms.topic: concept-article --- # Storing and Loading CObjects via an Archive diff --git a/docs/mfc/testing-internet-applications.md b/docs/mfc/testing-internet-applications.md index 17cd363f1b3..40e53d914f6 100644 --- a/docs/mfc/testing-internet-applications.md +++ b/docs/mfc/testing-internet-applications.md @@ -4,6 +4,7 @@ title: "Testing Internet Applications" ms.date: "11/04/2016" helpviewer_keywords: ["Web applications [MFC], testing", "debugging Web applications [MFC], testing applications", "testing [MFC], Internet applications", "debugging [MFC], Web applications", "Internet debugging and testing"] ms.assetid: ac4c74e3-d4ad-4e19-8f6c-e270de067f01 +ms.topic: concept-article --- # Testing Internet Applications diff --git a/docs/mfc/testing-properties-and-events-with-test-container.md b/docs/mfc/testing-properties-and-events-with-test-container.md index fd24b36eca9..d7258a77d5c 100644 --- a/docs/mfc/testing-properties-and-events-with-test-container.md +++ b/docs/mfc/testing-properties-and-events-with-test-container.md @@ -1,9 +1,9 @@ --- -description: "Learn more about: Testing Properties and Events with Test Container" title: "Testing Properties and Events with Test Container" -ms.date: "11/04/2016" +description: "Learn more about: Testing Properties and Events with Test Container" +ms.date: 11/04/2016 helpviewer_keywords: ["testing, test containers", "tstcon32.exe", "debugging ActiveX controls", "test container", "ActiveX Control Test Container", "ActiveX controls [MFC], testing", "properties [MFC], testing"] -ms.assetid: 626867cf-fe53-4c30-8973-55bb93ef3917 +ms.topic: how-to --- # Testing Properties and Events with Test Container @@ -36,7 +36,7 @@ At this point you can test your control's properties or events. The property now contains the new value. -#### To test events and specify the destination of event information. +#### To test events and specify the destination of event information 1. On the **Options** menu, click **Logging**. diff --git a/docs/mfc/tn002-persistent-object-data-format.md b/docs/mfc/tn002-persistent-object-data-format.md index da977b57ee5..46c468bb74b 100644 --- a/docs/mfc/tn002-persistent-object-data-format.md +++ b/docs/mfc/tn002-persistent-object-data-format.md @@ -1,9 +1,8 @@ --- -description: "Learn more about: TN002: Persistent Object Data Format" title: "TN002: Persistent Object Data Format" -ms.date: "11/04/2016" +description: "Learn more about: TN002: Persistent Object Data Format" +ms.date: 11/04/2016 helpviewer_keywords: ["VERSIONABLE_SCHEMA macro [MFC]", "persistent object data", "CArchive class [MFC], support for persistent data", "persistent C++ objects [MFC]", "TN002"] -ms.assetid: 553fe01d-c587-4c8d-a181-3244a15c2be9 --- # TN002: Persistent Object Data Format @@ -56,7 +55,7 @@ If the object has not been saved before, there are two possibilities to consider The descriptor for this class is then inserted into the archive using the `CRuntimeClass::Store` method. `CRuntimeClass::Store` inserts the schema number of the class (see below) and the ASCII text name of the class. Note that the use of the ASCII text name does not guarantee uniqueness of the archive across applications. Therefore, you should tag your data files to prevent corruption. Following the insertion of the class information, the archive puts the object into the *m_pStoreMap* and then calls the `Serialize` method to insert class-specific data. Placing the object into the *m_pStoreMap* before calling `Serialize` prevents multiple copies of the object from being saved to the store. -When returning to the initial caller (usually the root of the network of objects), you must call [CArchive::Close](../mfc/reference/carchive-class.md#close). If you plan to perform other [CFile](../mfc/reference/cfile-class.md)operations, you must call the `CArchive` method [Flush](../mfc/reference/carchive-class.md#flush) to prevent corruption of the archive. +When returning to the initial caller (usually the root of the network of objects), you must call [CArchive::Close](../mfc/reference/carchive-class.md#close). If you plan to perform other [CFile](../mfc/reference/cfile-class.md) operations, you must call the `CArchive` method [Flush](../mfc/reference/carchive-class.md#flush) to prevent corruption of the archive. > [!NOTE] > This implementation imposes a hard limit of 0x3FFFFFFE indices per archive context. This number represents the maximum number of unique objects and classes that can be saved in a single archive, but a single disk file can have an unlimited number of archive contexts. diff --git a/docs/mfc/tn006-message-maps.md b/docs/mfc/tn006-message-maps.md index 91f8aec4a38..4c24ca0197d 100644 --- a/docs/mfc/tn006-message-maps.md +++ b/docs/mfc/tn006-message-maps.md @@ -97,7 +97,7 @@ pWnd->SendMessage(WM_MYMESSAGE); The range of user-defined messages that use this approach must be in the range WM_USER to 0x7fff. > [!NOTE] -> ClassWizard does not support entering ON_MESSAGE handler routines from the ClassWizard user interface. You must manually enter them from the Visual C++ editor. ClassWizard will parse these entries and let you browse them just like any other message-map entries. +> ClassWizard does not support entering ON_MESSAGE handler routines from the ClassWizard user interface. You must manually enter them from the Visual Studio editor. ClassWizard will parse these entries and let you browse them just like any other message-map entries. ## Registered Windows Messages @@ -150,7 +150,7 @@ Advanced users can use the ON_COMMAND_EX macro, which is an extended form of com Examples of these forms: -- Inside Resource.h (usually generated by Visual C++) +- Inside Resource.h (usually generated by Visual Studio) ```cpp #define ID_MYCMD 100 diff --git a/docs/mfc/tn011-using-mfc-as-part-of-a-dll.md b/docs/mfc/tn011-using-mfc-as-part-of-a-dll.md index 6036c016123..d46e12b6e97 100644 --- a/docs/mfc/tn011-using-mfc-as-part-of-a-dll.md +++ b/docs/mfc/tn011-using-mfc-as-part-of-a-dll.md @@ -17,7 +17,7 @@ If both a DLL and an application want to use MFC, both have a choice to either u regular MFC DLLs have several advantages: -- The application that uses the DLL does not have to use MFC and does not have to be a Visual C++ application. +- The application that uses the DLL does not have to use MFC and does not have to be a Visual Studio application. - With regular MFC DLLs that statically link to MFC, the size of the DLL depends only on the MFC and C runtime routines that are used and linked. @@ -63,7 +63,7 @@ The `DllMain` function that MFC provides will call the [CWinApp::ExitInstance](. ## Linking Your DLL -With regular MFC DLLs that statically link to MFC, you must link your DLL with Nafxcwd.lib or Nafxcw.lib and with the version of the C runtimes named Libcmt.lib. These libraries are pre-built and may be installed by specifying them when you run Visual C++ setup. +With regular MFC DLLs that statically link to MFC, you must link your DLL with Nafxcwd.lib or Nafxcw.lib and with the version of the C runtimes named Libcmt.lib. These libraries are pre-built and may be installed by specifying them when you run Visual Studio setup. ## Sample Code diff --git a/docs/mfc/tn014-custom-controls.md b/docs/mfc/tn014-custom-controls.md index debff5eb3dd..d6eb5e03e11 100644 --- a/docs/mfc/tn014-custom-controls.md +++ b/docs/mfc/tn014-custom-controls.md @@ -38,44 +38,44 @@ By using self-draw controls you can build reusable control classes that use owne - For self-draw buttons: ```cpp - CButton:DrawItem(LPDRAWITEMSTRUCT); + CButton::DrawItem(LPDRAWITEMSTRUCT); // insert code to draw this button ``` - For self-draw menus: ```cpp - CMenu:MeasureItem(LPMEASUREITEMSTRUCT); + CMenu::MeasureItem(LPMEASUREITEMSTRUCT); // insert code to measure the size of an item in this menu - CMenu:DrawItem(LPDRAWITEMSTRUCT); + CMenu::DrawItem(LPDRAWITEMSTRUCT); // insert code to draw an item in this menu ``` - For self-draw list boxes: ```cpp - CListBox:MeasureItem(LPMEASUREITEMSTRUCT); + CListBox::MeasureItem(LPMEASUREITEMSTRUCT); // insert code to measure the size of an item in this list box - CListBox:DrawItem(LPDRAWITEMSTRUCT); + CListBox::DrawItem(LPDRAWITEMSTRUCT); // insert code to draw an item in this list box - CListBox:CompareItem(LPCOMPAREITEMSTRUCT); + CListBox::CompareItem(LPCOMPAREITEMSTRUCT); // insert code to compare two items in this list box if LBS_SORT - CListBox:DeleteItem(LPDELETEITEMSTRUCT); + CListBox::DeleteItem(LPDELETEITEMSTRUCT); // insert code to delete an item from this list box ``` - For self-draw combo boxes: ```cpp - CComboBox:MeasureItem(LPMEASUREITEMSTRUCT); + CComboBox::MeasureItem(LPMEASUREITEMSTRUCT); // insert code to measure the size of an item in this combo box - CComboBox:DrawItem(LPDRAWITEMSTRUCT); + CComboBox::DrawItem(LPDRAWITEMSTRUCT); // insert code to draw an item in this combo box - CComboBox:CompareItem(LPCOMPAREITEMSTRUCT); + CComboBox::CompareItem(LPCOMPAREITEMSTRUCT); // insert code to compare two items in this combo box if CBS_SORT - CComboBox:DeleteItem(LPDELETEITEMSTRUCT); + CComboBox::DeleteItem(LPDELETEITEMSTRUCT); // insert code to delete an item from this combo box ``` diff --git a/docs/mfc/tn020-id-naming-and-numbering-conventions.md b/docs/mfc/tn020-id-naming-and-numbering-conventions.md index 753afb306c8..96b6e6d29b3 100644 --- a/docs/mfc/tn020-id-naming-and-numbering-conventions.md +++ b/docs/mfc/tn020-id-naming-and-numbering-conventions.md @@ -12,13 +12,13 @@ This note describes the ID naming and numbering conventions that MFC 2.0 uses fo The MFC ID naming and numbering conventions are intended to meet the following requirements: -- Provide a consistent ID-naming standard used across the MFC library and MFC applications that are supported by the Visual C++ resource editor. This makes it easier for the programmer to interpret the type and origin of a resource from its ID. +- Provide a consistent ID-naming standard used across the MFC library and MFC applications that are supported by the Visual Studio resource editor. This makes it easier for the programmer to interpret the type and origin of a resource from its ID. - Emphasize the strong 1-to-1 relationship between certain types of IDs. - Conform to already widely used standards for naming IDs in Windows. -- Partition the ID-numbering space. ID numbers can be assigned by the programmer, MFC, Windows, and Visual C++-edited resources. Appropriate partitioning will help avoid duplication of ID numbers. +- Partition the ID-numbering space. ID numbers can be assigned by the programmer, MFC, Windows, and Visual Studio-edited resources. Appropriate partitioning will help avoid duplication of ID numbers. ## The ID Prefix Naming Convention diff --git a/docs/mfc/tn021-command-and-message-routing.md b/docs/mfc/tn021-command-and-message-routing.md index 597613bdc7b..8e2210c3546 100644 --- a/docs/mfc/tn021-command-and-message-routing.md +++ b/docs/mfc/tn021-command-and-message-routing.md @@ -13,7 +13,7 @@ ms.assetid: b5952c8b-123e-406c-a36d-a6ac7c6df307 This note describes the command routing and dispatch architecture as well as advanced topics in general window message routing. -Please refer to Visual C++ for general details on the architectures described here, especially the distinction between Windows messages, control notifications, and commands. This note assumes you are very familiar with the issues described in the printed documentation and only addresses very advanced topics. +Please refer to Visual Studio for general details on the architectures described here, especially the distinction between Windows messages, control notifications, and commands. This note assumes you are very familiar with the issues described in the printed documentation and only addresses very advanced topics. ## Command Routing and Dispatch MFC 1.0 Functionality Evolves to MFC 2.0 Architecture @@ -29,7 +29,7 @@ This functionality has been generalized and extended in MFC 2.0 to allow command ## Command IDs -See Visual C++ for an explanation of the command routing and binding process. [Technical Note 20](../mfc/tn020-id-naming-and-numbering-conventions.md) contains information on ID naming. +See Visual Studio for an explanation of the command routing and binding process. [Technical Note 20](../mfc/tn020-id-naming-and-numbering-conventions.md) contains information on ID naming. We use the generic prefix "ID_" for command IDs. Command IDs are >= 0x8000. The message line or status bar will show the command description string if there is a STRINGTABLE resource with the same IDs as the command ID. @@ -71,7 +71,7 @@ Maintaining the enabled/checked state of all a program's menu items all the time `CFrameWnd` also handles the WM_ENTERIDLE message to describe the current menu item selected on the status bar (also known as the message line). -An application's menu structure, edited by Visual C++, is used to represent the potential commands available at WM_INITMENUPOPUP time. ON_UPDATE_COMMAND_UI handlers can modify the state or text of a menu, or for advanced uses (like the File MRU list or the OLE Verbs pop-up menu), actually modify the menu structure before the menu is drawn. +An application's menu structure, edited by Visual Studio, is used to represent the potential commands available at WM_INITMENUPOPUP time. ON_UPDATE_COMMAND_UI handlers can modify the state or text of a menu, or for advanced uses (like the File MRU list or the OLE Verbs pop-up menu), actually modify the menu structure before the menu is drawn. The same sort of ON_UPDATE_COMMAND_UI processing is done for toolbars (and other control bars) when the application enters its idle loop. See the *Class Library Reference* and [Technical Note 31](../mfc/tn031-control-bars.md) for more information on control bars. diff --git a/docs/mfc/tn022-standard-commands-implementation.md b/docs/mfc/tn022-standard-commands-implementation.md index 87a928b8c48..b58bce0c1b6 100644 --- a/docs/mfc/tn022-standard-commands-implementation.md +++ b/docs/mfc/tn022-standard-commands-implementation.md @@ -13,7 +13,7 @@ ms.assetid: a7883b46-23f7-4870-ac3a-804aed9258b5 This note describes the standard command implementations provided by MFC 2.0. Read [Technical Note 21](../mfc/tn021-command-and-message-routing.md) first because it describes the mechanisms used to implement many of the standard commands. -This description assumes knowledge of the MFC architectures, APIs, and common programming practice. Documented as well as undocumented "implementation only" APIs are described. This is not a place to start learning about the features of or how to program in MFC. Refer to Visual C++ for more general information and for details of documented APIs. +This description assumes knowledge of the MFC architectures, APIs, and common programming practice. Documented as well as undocumented "implementation only" APIs are described. This is not a place to start learning about the features of or how to program in MFC. Refer to Visual Studio for more general information and for details of documented APIs. ## The Problem diff --git a/docs/mfc/tn023-standard-mfc-resources.md b/docs/mfc/tn023-standard-mfc-resources.md index d7e50ae3190..f0dfaccf661 100644 --- a/docs/mfc/tn023-standard-mfc-resources.md +++ b/docs/mfc/tn023-standard-mfc-resources.md @@ -29,7 +29,7 @@ Clip-art resources are additional resources that the framework does not depend o - Prompts.rc: Contains menu-prompt string resources for each predefined command, such as "Create a new document" for ID_FILE_NEW. -- Commdlg.rc: A Visual C++ compatible .rc file that contains the standard COMMDLG dialog templates. +- Commdlg.rc: A Visual Studio compatible .rc file that contains the standard COMMDLG dialog templates. Standard framework resources are resources with AFX-defined IDs that the framework depends on for internal implementations. You will rarely need to change these AFX-defined resources. If you do, you should follow the procedure outlined later in this topic. @@ -47,7 +47,7 @@ The following framework resources are contained in the MFC\INCLUDE directory: #### To use a clip-art binary resource -1. Open your application's resource file in Visual C++. +1. Open your application's resource file in Visual Studio. 1. Open Common.rc. This file contains all the binary clip-art resources. This may take some time because the Common.rc file is compiled. @@ -72,11 +72,11 @@ Standard framework resources are usually included in an application by using the The most common case of customizing standard framework resources is adding or removing additional includes for printing, OLE Client, and OLE Server support. -In some rare cases you might want to customize the contents of the standard framework resources for your particular application, not just add and remove the entire file. The followings steps show how you can limit the resources that are included: +In some rare cases you might want to customize the contents of the standard framework resources for your particular application, not just add and remove the entire file. The following steps show how you can limit the resources that are included: ##### To customize the contents of a standard resource file -1. Open the resource file in Visual C++. +1. Open the resource file in Visual Studio. 1. Using the Resource Set Includes command, remove the `#include` for the standard .rc file that you want to customize. For example, to customize the print-preview toolbar, remove the `#include "afxprint.rc"` line. diff --git a/docs/mfc/tn024-mfc-defined-messages-and-resources.md b/docs/mfc/tn024-mfc-defined-messages-and-resources.md index b510b909b79..4c2ed67fd50 100644 --- a/docs/mfc/tn024-mfc-defined-messages-and-resources.md +++ b/docs/mfc/tn024-mfc-defined-messages-and-resources.md @@ -159,9 +159,9 @@ The default toolbar supplied by AppWizard is based on an RT_TOOLBAR custom resou ## RT_DLGINIT Resource Format -One MFC private resource format is used to store extra dialog initialization information. This includes the initial strings stored in a combo box. The format of this resource is not designed to be manually edited, but is handled by Visual C++. +One MFC private resource format is used to store extra dialog initialization information. This includes the initial strings stored in a combo box. The format of this resource is not designed to be manually edited, but is handled by Visual Studio. -Visual C++ and this RT_DLGINIT resource are not required to use the related features of MFC since there are API alternative to using the information in the resource. Using Visual C++ makes it much easier to write, maintain, and translate your application in the long run. +Visual Studio and this RT_DLGINIT resource are not required to use the related features of MFC since there are API alternative to using the information in the resource. Using Visual Studio makes it much easier to write, maintain, and translate your application in the long run. The basic structure of a RT_DLGINIT resource is as follows: @@ -186,7 +186,7 @@ A repeated section contains the control ID to send the message to, the Message # SendDlgItemMessage(, , 0, &); ``` -This is a very general format, allowing any Windows messages and data content. The Visual C++ resource editor and MFC only support a limited subset of Windows messages: CB_ADDSTRING for the initial list-choices for combo boxes (the data is a text string). +This is a very general format, allowing any Windows messages and data content. The Visual Studio resource editor and MFC only support a limited subset of Windows messages: CB_ADDSTRING for the initial list-choices for combo boxes (the data is a text string). ## See also diff --git a/docs/mfc/tn028-context-sensitive-help-support.md b/docs/mfc/tn028-context-sensitive-help-support.md index 09992516214..7b6b5753c5f 100644 --- a/docs/mfc/tn028-context-sensitive-help-support.md +++ b/docs/mfc/tn028-context-sensitive-help-support.md @@ -8,7 +8,7 @@ ms.assetid: 884f1c55-fa27-4d4c-984f-30907d477484 --- # TN028: Context-Sensitive Help Support -This note describes the rules for assigning Help contexts IDs and other help issues in MFC. Context-sensitive help support requires the help compiler that is available in Visual C++. +This note describes the rules for assigning Help contexts IDs and other help issues in MFC. Context-sensitive help support requires the help compiler that is available in Visual Studio. > [!NOTE] > In addition to implementing context-sensitive help using WinHelp, MFC also supports using HTML Help. For more information on this support and programming with HTML Help, see [HTML Help: Context-Sensitive Help for Your Programs](../mfc/html-help-context-sensitive-help-for-your-programs.md). diff --git a/docs/mfc/tn029-splitter-windows.md b/docs/mfc/tn029-splitter-windows.md index 44ff393dd03..5e0142a3312 100644 --- a/docs/mfc/tn029-splitter-windows.md +++ b/docs/mfc/tn029-splitter-windows.md @@ -14,7 +14,7 @@ This note describes the MFC [CSplitterWnd Class](../mfc/reference/csplitterwnd-c A `CSplitterWnd` supports two different styles of splitting windows. -In "static splitters," the splitter window creates the panes when it is created. The order and number of panes never change. Splitter bars are used to resize the different panes. You can use this style to display a different view class in each pane. The Visual C++ graphics editor and the Windows File Manager are examples of programs that use this splitter style. This style of splitter window does not use splitter boxes. +In "static splitters," the splitter window creates the panes when it is created. The order and number of panes never change. Splitter bars are used to resize the different panes. You can use this style to display a different view class in each pane. The Visual Studio graphics editor and the Windows File Manager are examples of programs that use this splitter style. This style of splitter window does not use splitter boxes. In "dynamic splitters," additional panes are created and destroyed as the user splits and un-splits new views. This splitter starts out with a single view and provides splitter boxes for the user to initiate splitting. The splitter window dynamically creates a new view object when the view is split in one direction. This new view object represents the new pane. If the view is split in two directions by using the keyboard interface, the splitter window creates three new view objects for the three new panes. While the split is active, Windows displays the splitter box as a splitter bar between the panes. Windows destroys additional view objects when the user removes a split, but the original view remains until the splitter window itself is destroyed. Microsoft Excel and Microsoft Word are examples of applications that use the dynamic splitter style. diff --git a/docs/mfc/tn033-dll-version-of-mfc.md b/docs/mfc/tn033-dll-version-of-mfc.md index 0e5df9d531b..b4d84359c16 100644 --- a/docs/mfc/tn033-dll-version-of-mfc.md +++ b/docs/mfc/tn033-dll-version-of-mfc.md @@ -416,9 +416,9 @@ A full rebuild is required after these changes are made. ### Building the Samples -Most of the MFC sample programs can be built from Visual C++ or from a shared NMAKE-compatible MAKEFILE from the command line. +Most of the MFC sample programs can be built from Visual Studio or from a shared NMAKE-compatible MAKEFILE from the command line. -To convert any of these samples to use *`MFCxx.DLL`*, you can load the MAK file into the Visual C++ and set the Project options as described above. If you're using the NMAKE build, you can specify `AFXDLL=1` on the NMAKE command line and that will build the sample using the shared MFC libraries. +To convert any of these samples to use *`MFCxx.DLL`*, you can load the MAK file into the Visual Studio and set the Project options as described above. If you're using the NMAKE build, you can specify `AFXDLL=1` on the NMAKE command line and that will build the sample using the shared MFC libraries. The MFC Advanced Concepts sample [DLLHUSK](../overview/visual-cpp-samples.md) is built with the DLL version of MFC. This sample not only illustrates how to build an application linked with *`MFCxx.DLL`*, but it also illustrates other features of the MFC DLL packaging option such as MFC extension DLLs described later in this technical note. @@ -426,7 +426,7 @@ The MFC Advanced Concepts sample [DLLHUSK](../overview/visual-cpp-samples.md) is The release versions of the DLLs (*`MFCxx.DLL`* and *`MFCxxU.DLL`*) are freely redistributable. The debug versions of the DLLs are not freely redistributable and should be used only during the development of your application. -The debug DLLs are provided with debugging information. By using the Visual C++ debugger, you can trace execution of both your application and the DLL. The Release DLLs (*`MFCxx.DLL`* and *`MFCxxU.DLL`*) don't contain debugging information. +The debug DLLs are provided with debugging information. By using the Visual Studio debugger, you can trace execution of both your application and the DLL. The Release DLLs (*`MFCxx.DLL`* and *`MFCxxU.DLL`*) don't contain debugging information. If you customize or rebuild the DLLs, then you should call them something other than "MFCxx". The MFC SRC file *`MFCDLL.MAK`* describes build options and contains the logic for renaming the DLL. Renaming the files is necessary, since these DLLs are potentially shared by many MFC applications. Having your custom version of the MFC DLLs replace the ones installed on the system may break another MFC application using the shared MFC DLLs. diff --git a/docs/mfc/tn035-using-multiple-resource-files-and-header-files-with-visual-cpp.md b/docs/mfc/tn035-using-multiple-resource-files-and-header-files-with-visual-cpp.md index efb943db144..96416abb045 100644 --- a/docs/mfc/tn035-using-multiple-resource-files-and-header-files-with-visual-cpp.md +++ b/docs/mfc/tn035-using-multiple-resource-files-and-header-files-with-visual-cpp.md @@ -1,17 +1,17 @@ --- -description: "Learn more about: TN035: Using multiple resource files and header files with Visual C++" -title: "TN035: Using multiple resource files and header files with Visual C++" +description: "Learn more about: TN035: Using multiple resource files and header files with Visual Studio" +title: "TN035: Using multiple resource files and header files with Visual Studio" ms.date: "11/04/2016" f1_keywords: ["vc.resources"] helpviewer_keywords: ["resource files, multiple", "TN035"] ms.assetid: 1f08ce5e-a912-44cc-ac56-7dd93ad73fb6 --- -# TN035: Using multiple resource files and header files with Visual C++ +# TN035: Using multiple resource files and header files with Visual Studio > [!NOTE] > The following technical note has not been updated since it was first included in the online documentation. As a result, some procedures and topics might be out of date or incorrect. For the latest information, it is recommended that you search for the topic of interest in the online documentation index. -This note describes how the Visual C++ resource editor supports multiple resource files and header files shared in a single project or shared across multiple projects and how you can take advantage of that support. This note answers these questions: +This note describes how the Visual Studio resource editor supports multiple resource files and header files shared in a single project or shared across multiple projects and how you can take advantage of that support. This note answers these questions: - When might you want to split a project into multiple resource files and/or header files, and how you do it @@ -25,7 +25,7 @@ You should be aware that if you add an additional resource file to your project, This note is structured to answer the above questions as follows: -- **Overview of how Visual C++ manages resource files and header files** provides an overview of how the Resource Set Includes command in Visual C++ lets you use multiple resource files and header files in the same project. +- **Overview of how Visual Studio manages resource files and header files** provides an overview of how the Resource Set Includes command in Visual Studio lets you use multiple resource files and header files in the same project. - **Analysis of AppWizard-created `.RC` and `.H` Files** looks at the multiple resource and header files that are used by an AppWizard-created application. These files serve as a good model for additional resource files and header files you might want to add to your project. @@ -35,17 +35,17 @@ This note is structured to answer the above questions as follows: - **Using multiple resource files in the same project** describes where you might want to break up your project into multiple `.RC` files, and provides details how to do so. -- **Enforcement of non-editable Visual C++ files** describes how you can make sure Visual C++ doesn't edit and unintentionally reformat a custom resource. +- **Enforcement of non-editable Visual Studio files** describes how you can make sure Visual Studio doesn't edit and unintentionally reformat a custom resource. -- **Managing symbols shared by multiple Visual C++-edited `.RC` files** describes how to share the same symbols across multiple `.RC` files and how to avoid assigning duplicate ID numeric values. +- **Managing symbols shared by multiple Visual Studio-edited `.RC` files** describes how to share the same symbols across multiple `.RC` files and how to avoid assigning duplicate ID numeric values. -- **Managing dependencies between `.RC`, `.CPP`, and `.H` files** describes how Visual C++ avoids unnecessary recompiling `.CPP` files that are dependent on resource symbol files. +- **Managing dependencies between `.RC`, `.CPP`, and `.H` files** describes how Visual Studio avoids unnecessary recompiling `.CPP` files that are dependent on resource symbol files. -- **How Visual C++ manages Set Includes information** provides technical details about how Visual C++ keeps track of multiple (nested) `.RC` files and multiple header files that are included by an `.RC` file. +- **How Visual Studio manages Set Includes information** provides technical details about how Visual Studio keeps track of multiple (nested) `.RC` files and multiple header files that are included by an `.RC` file. -## Overview of how Visual C++ manages resource files and header files +## Overview of how Visual Studio manages resource files and header files -Visual C++ manages a single `.RC` resource file and a corresponding `.H` header file as a tightly coupled pair of files. When you edit and save resources in an `.RC` file, you indirectly edit and save symbols in the corresponding `.H` file. Although you can open and edit multiple `.RC` files at a time (using Visual C++'s MDI user interface), for any given `.RC` file you indirectly edit exactly one corresponding header file. +Visual Studio manages a single `.RC` resource file and a corresponding `.H` header file as a tightly coupled pair of files. When you edit and save resources in an `.RC` file, you indirectly edit and save symbols in the corresponding `.H` file. Although you can open and edit multiple `.RC` files at a time (using Visual Studio's MDI user interface), for any given `.RC` file you indirectly edit exactly one corresponding header file. ### Resource View's Resource Includes dialog @@ -53,26 +53,26 @@ To access the **Resource Includes**, open the **Resource View** then right-click #### Symbol Header File -By default, Visual C++ always names the corresponding header file `RESOURCE.H`, regardless of the name of the resource file (for example, `MYAPP.RC`). The **Symbol Header File:** section in the **Resource Includes** dialog in Visual C++, lets you change the name of this header file. Enter a new file name in the section's edit box. +By default, Visual Studio always names the corresponding header file `RESOURCE.H`, regardless of the name of the resource file (for example, `MYAPP.RC`). The **Symbol Header File:** section in the **Resource Includes** dialog in Visual Studio, lets you change the name of this header file. Enter a new file name in the section's edit box. > [!NOTE] > resource files not located in the same directory as the `.RC` file must prepend a relative path with escaped-'\\' to be read properly. #### Read-Only Symbol Directives -Although Visual C++ only edits one header file for any given `.RC` file, Visual C++ supports references to symbols defined in additional read-only header files. The **Read-Only Symbol Directives:** section in the **Resource Includes** dialog lets you specify any number of additional read-only header files as Read-Only Symbol Directives. The "read-only" restriction means that when you add a new resource in the `.RC` file, you can use a symbol defined in the read-only header file. However, if you delete the resource, the symbol still remains defined in the read-only header file. You can't change the numeric value assigned to a read-only symbol. +Although Visual Studio only edits one header file for any given `.RC` file, Visual Studio supports references to symbols defined in additional read-only header files. The **Read-Only Symbol Directives:** section in the **Resource Includes** dialog lets you specify any number of additional read-only header files as Read-Only Symbol Directives. The "read-only" restriction means that when you add a new resource in the `.RC` file, you can use a symbol defined in the read-only header file. However, if you delete the resource, the symbol still remains defined in the read-only header file. You can't change the numeric value assigned to a read-only symbol. #### Compile-Time Directives -Visual C++ also supports nesting of resource files, where one `.RC` file is included within another by using a `#include` directive. When you edit a given `.RC` file using Visual C++, any resources in the included files aren't visible. But when you compile the `.RC` file, the included files are also compiled. The **Compile-Time Directives:** section in the **Resources Includes** dialog lets you specify any number of `.RC` files to include as Compile-Time Directives. +Visual Studio also supports nesting of resource files, where one `.RC` file is included within another by using a `#include` directive. When you edit a given `.RC` file using Visual Studio, any resources in the included files aren't visible. But when you compile the `.RC` file, the included files are also compiled. The **Compile-Time Directives:** section in the **Resources Includes** dialog lets you specify any number of `.RC` files to include as Compile-Time Directives. -Note what happens if you read into Visual C++ an `.RC` file that includes another `.RC` file that isn't* specified as a Compile-Time Directive. This situation might arise when you bring to Visual C++ an `.RC` file that you had been previously maintaining manually with a text editor. When Visual C++ reads the included `.RC` file, it merges the included resources into the parent `.RC` file. When you save the parent `.RC` file, the `#include` statement, in effect, will be replaced by the included resources. If you don't want this merge to happen, you should remove the `#include` statement from the parent `.RC` file *prior* to reading it into Visual C++; then using Visual C++, add back the same `#include` statement as a Compile-Time Directive. +Note what happens if you read into Visual Studio an `.RC` file that includes another `.RC` file that isn't* specified as a Compile-Time Directive. This situation might arise when you bring to Visual Studio an `.RC` file that you had been previously maintaining manually with a text editor. When Visual Studio reads the included `.RC` file, it merges the included resources into the parent `.RC` file. When you save the parent `.RC` file, the `#include` statement, in effect, will be replaced by the included resources. If you don't want this merge to happen, you should remove the `#include` statement from the parent `.RC` file *prior* to reading it into Visual Studio; then using Visual Studio, add back the same `#include` statement as a Compile-Time Directive. -Visual C++ saves in an `.RC` file the three kinds of above Set Includes information (Symbol Header File, Read-Only Symbol Directives, and Compile-Time Directives) in `#include` directives *and* in `TEXTINCLUDE` resources. The `TEXTINCLUDE` resources, an implementation detail that you don't normally need to deal with, are explained in [How Visual C++ manages set includes information](#_mfcnotes_tn035_set_includes). +Visual Studio saves in an `.RC` file the three kinds of above Set Includes information (Symbol Header File, Read-Only Symbol Directives, and Compile-Time Directives) in `#include` directives *and* in `TEXTINCLUDE` resources. The `TEXTINCLUDE` resources, an implementation detail that you don't normally need to deal with, are explained in [How Visual Studio manages set includes information](#_mfcnotes_tn035_set_includes). ## Analysis of AppWizard-created `.RC` and `.H` files -Examining the application code produced by AppWizard provides insight into how Visual C++ manages multiple resource files and header files. The code excerpts examined below are from a `MYAPP` application produced by AppWizard using the default options. +Examining the application code produced by AppWizard provides insight into how Visual Studio manages multiple resource files and header files. The code excerpts examined below are from a `MYAPP` application produced by AppWizard using the default options. An AppWizard-created application uses multiple resource files and multiple header files, as summarized in the diagram below: @@ -88,12 +88,12 @@ An AppWizard-created application uses multiple resource files and multiple heade AFXPRINT.RC ``` -You can view these multiple file relationships using the Visual C++ File/Set Includes command. +You can view these multiple file relationships using the Visual Studio File/Set Includes command. `MYAPP.RC`\ -The application resource file that you edit using Visual C++. +The application resource file that you edit using Visual Studio. -`RESOURCE.H` is the application-specific header file. It's always named `RESOURCE.H` by AppWizard, consistent with Visual C++'s default naming of the header file. The `#include` for this header file is the first statement in the resource file (`MYAPP.RC`): +`RESOURCE.H` is the application-specific header file. It's always named `RESOURCE.H` by AppWizard, consistent with Visual Studio's default naming of the header file. The `#include` for this header file is the first statement in the resource file (`MYAPP.RC`): ```rc //Microsoft Visual C++ generated resource script @@ -102,13 +102,13 @@ The application resource file that you edit using Visual C++. ``` `RES\MYAPP.RC2`\ -Contains resources that won't be edited by Visual C++ but will be included in the final compiled `.EXE` file. AppWizard creates no such resources by default, since Visual C++ can edit all of the standard resources, including the version resource (a new feature in this release). An empty file is generated by AppWizard in case you wish to add your own custom formatted resources to this file. +Contains resources that won't be edited by Visual Studio but will be included in the final compiled `.EXE` file. AppWizard creates no such resources by default, since Visual Studio can edit all of the standard resources, including the version resource (a new feature in this release). An empty file is generated by AppWizard in case you wish to add your own custom formatted resources to this file. -If you use custom formatted resources, you can add them to `RES\MYAPP.RC2` and edit them using the Visual C++ text editor. +If you use custom formatted resources, you can add them to `RES\MYAPP.RC2` and edit them using the Visual Studio text editor. -`AFXRES.RC` and `AFXPRINT.RC` contain standard resources required by certain features of the framework. Like `RES\MYAPP.RC2`, these two framework-provided resource files are included at the end of `MYAPP.RC`, and they're specified in the Compile-Time Directives of the Set Includes dialog box. Thus, you don't directly view or edit these framework resources while you edit `MYAPP.RC` in Visual C++, but they're compiled into the application's binary `.RES` file and final `.EXE` file. For more information on the standard framework resources, including procedures for modifying them, see [Technical Note 23](../mfc/tn023-standard-mfc-resources.md). +`AFXRES.RC` and `AFXPRINT.RC` contain standard resources required by certain features of the framework. Like `RES\MYAPP.RC2`, these two framework-provided resource files are included at the end of `MYAPP.RC`, and they're specified in the Compile-Time Directives of the Set Includes dialog box. Thus, you don't directly view or edit these framework resources while you edit `MYAPP.RC` in Visual Studio, but they're compiled into the application's binary `.RES` file and final `.EXE` file. For more information on the standard framework resources, including procedures for modifying them, see [Technical Note 23](../mfc/tn023-standard-mfc-resources.md). -`AFXRES.H` defines standard symbols, such as `ID_FILE_NEW`, used by the framework and specifically used in `AFXRES.RC`. `AFXRES.H` also uses `#include` to include `WINRES.H`, which contains a subset of `WINDOWS.H` that's needed by Visual C++ generated `.RC` files and `AFXRES.RC`. The symbols defined in `AFXRES.H` are available as you edit the application resource file (`MYAPP.RC`). For example, `ID_FILE_NEW` is used for the `File` `New` menu item in the `MYAPP.RC` file's menu resource. You can't change or delete these framework-defined symbols. +`AFXRES.H` defines standard symbols, such as `ID_FILE_NEW`, used by the framework and specifically used in `AFXRES.RC`. `AFXRES.H` also uses `#include` to include `WINRES.H`, which contains a subset of `WINDOWS.H` that's needed by Visual Studio generated `.RC` files and `AFXRES.RC`. The symbols defined in `AFXRES.H` are available as you edit the application resource file (`MYAPP.RC`). For example, `ID_FILE_NEW` is used for the `File` `New` menu item in the `MYAPP.RC` file's menu resource. You can't change or delete these framework-defined symbols. ## Including additional header files @@ -116,7 +116,7 @@ The AppWizard-created application includes only two header files: `RESOURCE.H` a The header file is provided by an external source, or you want to share the header file among multiple projects or multiple parts of the same project. -The header file has formatting and comments that you don't want Visual C++ to change or filter out when it saves the file. For example, maybe you want to preserve #define's that use symbolic arithmetic such as: +The header file has formatting and comments that you don't want Visual Studio to change or filter out when it saves the file. For example, maybe you want to preserve #define's that use symbolic arithmetic such as: ```h #define RED 0 @@ -170,22 +170,22 @@ The case where the second header file is shared by two `.RC` files in the same a ## Using multiple resource files in the same project -Visual C++ and the Resource Compiler support multiple `.RC` files in the same project through `#include` directives that include one `.RC` file within another. Multiple nesting is allowed. There are various reasons to split your project's resources into multiple `.RC` files: +Visual Studio and the Resource Compiler support multiple `.RC` files in the same project through `#include` directives that include one `.RC` file within another. Multiple nesting is allowed. There are various reasons to split your project's resources into multiple `.RC` files: - It's easier to manage a large number of resources among multiple project team members if you split the resources into multiple `.RC` files. If you use a source control management package for checking out files and checking in changes, splitting the resources into multiple `.RC` files will give you finer control over managing changes to resources. - If you want to use preprocessor directives, such as `#ifdef`, `#endif`, and `#define`, for portions of your resources, you must isolate them in read-only resources that will be compiled by the Resource Compiler. -- Component `.RC` files will load and save faster in Visual C++ than one composite `.RC` file. +- Component `.RC` files will load and save faster in Visual Studio than one composite `.RC` file. -- If you want to maintain a resource with a text editor in a human-readable form, you should keep it in a `.RC` file separate from the one Visual C++ edits. +- If you want to maintain a resource with a text editor in a human-readable form, you should keep it in a `.RC` file separate from the one Visual Studio edits. -- If you need to keep a user-defined resource in a binary or text form that is interpretable by another specialized data editor, then you should keep it in a separate `.RC` file so Visual C++ doesn't change the format to hexadecimal data. The `.WAV` (sound) file resources in the MFC Advanced Concepts sample [SPEAKN](../overview/visual-cpp-samples.md) are a good example. +- If you need to keep a user-defined resource in a binary or text form that is interpretable by another specialized data editor, then you should keep it in a separate `.RC` file so Visual Studio doesn't change the format to hexadecimal data. The `.WAV` (sound) file resources in the MFC Advanced Concepts sample [SPEAKN](../overview/visual-cpp-samples.md) are a good example. You can include `SECOND.RC` in the Compile-Time Directives in the Set Includes dialog box: ```h -#include "res\myapp.rc2" // non-Visual C++ edited resources +#include "res\myapp.rc2" // non-Visual Studio edited resources #include "second.rc" // THE SECOND .RC FILE #include "afxres.rc" // Standard components @@ -207,27 +207,27 @@ The result is illustrated in the following diagram: AFXPRINT.RC ``` -Using Compile-Time Directives, you can organize your Visual C++-editable and non-editable resources into multiple `.RC` files, where the main `MYAPP.RC` does nothing but `#include` the other `.RC` files. If you're using a Visual Studio C++ project `.MAK` file, then you should include the main `.RC` file in the project so that all the included resources are compiled with your application. +Using Compile-Time Directives, you can organize your Visual Studio-editable and non-editable resources into multiple `.RC` files, where the main `MYAPP.RC` does nothing but `#include` the other `.RC` files. If you're using a Visual Studio C++ project `.MAK` file, then you should include the main `.RC` file in the project so that all the included resources are compiled with your application. -## Enforcement of non-editable Visual C++ files +## Enforcement of non-editable Visual Studio files -The AppWizard-created `RES\MYAPP.RC2` file is an example of a file that contains resources that you don't want to accidentally read into Visual C++ and then write back out with loss of formatting information. To protect against this problem, place the following lines in the beginning of the `RES\MYAPP.RC2` file: +The AppWizard-created `RES\MYAPP.RC2` file is an example of a file that contains resources that you don't want to accidentally read into Visual Studio and then write back out with loss of formatting information. To protect against this problem, place the following lines in the beginning of the `RES\MYAPP.RC2` file: ```rc2 #ifdef APSTUDIO_INVOKED - #error this file is not editable by Visual C++ + #error this file is not editable by Visual Studio #endif //APSTUDIO_INVOKED ``` -When Visual C++ compiles the `.RC` file, it defines both `APSTUDIO_INVOKED` and `RC_INVOKED`. If the AppWizard-created file structure is corrupted and Visual C++ reads the #error line above, it reports a fatal error and aborts the reading of the `.RC` file. +When Visual Studio compiles the `.RC` file, it defines both `APSTUDIO_INVOKED` and `RC_INVOKED`. If the AppWizard-created file structure is corrupted and Visual Studio reads the #error line above, it reports a fatal error and aborts the reading of the `.RC` file. -## Managing symbols shared by multiple Visual C++-edited `.RC` files +## Managing symbols shared by multiple Visual Studio-edited `.RC` files -Two issues arise when you split up your resources into multiple `.RC` files that you want to edit separately in Visual C++: +Two issues arise when you split up your resources into multiple `.RC` files that you want to edit separately in Visual Studio: - You might want to share the same symbols across multiple `.RC` files. -- You need to help Visual C++ avoid assigning the same ID numeric values to distinct resources (symbols). +- You need to help Visual Studio avoid assigning the same ID numeric values to distinct resources (symbols). The following diagram illustrates an organization of `.RC` and `.H` files that deals with the first issue: @@ -243,11 +243,11 @@ MYSTRS.H / MYSHARED.H \ MYMENUS.H In this example, string resources are kept in one resource file, `MYSTRS.RC`, and menus are kept in another, `MYMENUS.RC`. Some symbols, such as for commands, may need to be shared between the two files. For example, a `ID_TOOLS_SPELL` may be the menu command ID for the Spell item in a Tools menu; and it may also be the string ID of the command prompt displayed by the framework in the application's main window status bar. -The `ID_TOOLS_SPELL` symbol is kept in the shared header file, `MYSHARED.H`. You maintain this shared header file manually with a text editor; Visual C++ doesn't directly edit it. In the two resource files `MYSTRS.RC` and `MYMENUS.RC`, you specify `#include "MYSHARED.H"` in the Read-Only Directives for `MYAPP.RC`, using the **Resource Includes** command, as described earlier. +The `ID_TOOLS_SPELL` symbol is kept in the shared header file, `MYSHARED.H`. You maintain this shared header file manually with a text editor; Visual Studio doesn't directly edit it. In the two resource files `MYSTRS.RC` and `MYMENUS.RC`, you specify `#include "MYSHARED.H"` in the Read-Only Directives for `MYAPP.RC`, using the **Resource Includes** command, as described earlier. It's most convenient to anticipate a symbol you'll share before you attempt to use it to identify any resource. Add the symbol to the shared header file and, if you haven't already included the shared header file in the Read-Only Directives for the `.RC` file, do so before using the symbol. If you didn't anticipate sharing the symbol in this way, then you'll have to manually (using a text editor) move the #define statement for the symbol from, say, `MYMENUS.H` to `MYSHARED.H` before using it in `MYSTRS.RC`. -When you manage symbols in multiple `.RC` files, you also must help Visual C++ avoid assigning the same ID numeric values to distinct resources (symbols). For any given `.RC` file, Visual C++ incrementally assigns IDs in each of four ID domains. Between editing sessions, Visual C++ keeps track of the last ID it assigned in each of the domains in the Symbol Header File for the `.RC` file. Here's what the `APS_NEXT` values are for an empty (new) `.RC` file: +When you manage symbols in multiple `.RC` files, you also must help Visual Studio avoid assigning the same ID numeric values to distinct resources (symbols). For any given `.RC` file, Visual Studio incrementally assigns IDs in each of four ID domains. Between editing sessions, Visual Studio keeps track of the last ID it assigned in each of the domains in the Symbol Header File for the `.RC` file. Here's what the `APS_NEXT` values are for an empty (new) `.RC` file: ```rc #define _APS_NEXT_RESOURCE_VALUE 101 @@ -264,9 +264,9 @@ When you manage symbols in multiple `.RC` files, you also must help Visual C++ a `_APS_NEXT_SYMED_VALUE` is the next symbol value that will be issued when you manually assign a symbol value using the New command in the Symbol Browser. -Visual C++ starts with slightly higher values that the lowest legal value when creating a new `.RC` file. AppWizard will also initialize these values to something more appropriate for MFC applications. For more information about ID value ranges, see [Technical Note 20](../mfc/tn020-id-naming-and-numbering-conventions.md). +Visual Studio starts with slightly higher values that the lowest legal value when creating a new `.RC` file. AppWizard will also initialize these values to something more appropriate for MFC applications. For more information about ID value ranges, see [Technical Note 20](../mfc/tn020-id-naming-and-numbering-conventions.md). -Now every time you create a new resource file, even in the same project, Visual C++ defines the same `_APS_NEXT_` values. It means that if you add, say, multiple dialogs in two different `.RC` files, it's highly likely that the same #define value will be assigned to different dialogs. For example, `IDD_MY_DLG1` in the first `.RC` file might be assigned the same number, 101, as `IDD_MY_DLG2` in a second `.RC` file. +Now every time you create a new resource file, even in the same project, Visual Studio defines the same `_APS_NEXT_` values. It means that if you add, say, multiple dialogs in two different `.RC` files, it's highly likely that the same #define value will be assigned to different dialogs. For example, `IDD_MY_DLG1` in the first `.RC` file might be assigned the same number, 101, as `IDD_MY_DLG2` in a second `.RC` file. To avoid this issue, you should reserve a separate numeric range for each of the four domains of IDs in the respective `.RC` files. Set the ranges by manually updating the `_APS_NEXT` values in each of the `.RC` files **before** you start adding resources. For example, if the first `.RC` file uses the default `_APS_NEXT` values, then you might want to assign the following `_APS_NEXT` values to the second `.RC` file: @@ -277,13 +277,13 @@ To avoid this issue, you should reserve a separate numeric range for each of the #define _APS_NEXT_SYMED_VALUE 2000 ``` -Of course, it's still possible that Visual C++ will assign so many IDs in the first `.RC` file that the numeric values start to overlap the ones reserved for the second `.RC` file. You should reserve sufficiently large ranges so that this collision doesn't happen. +Of course, it's still possible that Visual Studio will assign so many IDs in the first `.RC` file that the numeric values start to overlap the ones reserved for the second `.RC` file. You should reserve sufficiently large ranges so that this collision doesn't happen. ## Managing dependencies between `.RC`, `.CPP`, and `.H` files -When Visual C++ saves an `.RC` file, it also saves symbol changes to the corresponding `RESOURCE.H` file. Any of your `.CPP` files that refer to resources in the `.RC` file must use `#include` to include the `RESOURCE.H` file, usually from within your project's main header file. This inclusion leads to an undesirable side-effect because of the development environment's internal project management, which scans source files for header dependencies. Every time you add a new symbol in Visual C++, all the `.CPP` files that have `#include "RESOURCE.H"` directives would need to be recompiled. +When Visual Studio saves an `.RC` file, it also saves symbol changes to the corresponding `RESOURCE.H` file. Any of your `.CPP` files that refer to resources in the `.RC` file must use `#include` to include the `RESOURCE.H` file, usually from within your project's main header file. This inclusion leads to an undesirable side-effect because of the development environment's internal project management, which scans source files for header dependencies. Every time you add a new symbol in Visual Studio, all the `.CPP` files that have `#include "RESOURCE.H"` directives would need to be recompiled. -Visual C++, circumvents the dependency on `RESOURCE.H` by including the following comment as the first line of the `RESOURCE.H` file: +Visual Studio, circumvents the dependency on `RESOURCE.H` by including the following comment as the first line of the `RESOURCE.H` file: ```h //{{NO_DEPENDENCIES}} @@ -291,9 +291,9 @@ Visual C++, circumvents the dependency on `RESOURCE.H` by including the followin The development environment interprets this comment by ignoring the changes to `RESOURCE.H` so that dependent `.CPP` files won't need to be recompiled. -Visual C++ always adds the `//{{NO_DEPENDENCIES}}` comment line to a `.RC` file when it saves the file. In some cases, circumventing of the build dependency on `RESOURCE.H` may lead to run-time errors undetected at link time. For example, if you use the Symbol Browser to change the numeric value assigned to a symbol for a resource, the resource won't be correctly found and loaded at application run-time if the `.CPP` file referring to the resource isn't recompiled. In such cases, you should explicitly recompile any `.CPP` files that you know are affected by the symbol changes in `RESOURCE.H` or select **Rebuild All**. If you have the need to frequently change symbol values for a certain group of resources, you'll probably find it more convenient and safer to break out these symbols into a separate read-only header file, as described in the above section [Including Additional Header Files](#_mfcnotes_tn035_including). +Visual Studio always adds the `//{{NO_DEPENDENCIES}}` comment line to a `.RC` file when it saves the file. In some cases, circumventing of the build dependency on `RESOURCE.H` may lead to run-time errors undetected at link time. For example, if you use the Symbol Browser to change the numeric value assigned to a symbol for a resource, the resource won't be correctly found and loaded at application run-time if the `.CPP` file referring to the resource isn't recompiled. In such cases, you should explicitly recompile any `.CPP` files that you know are affected by the symbol changes in `RESOURCE.H` or select **Rebuild All**. If you have the need to frequently change symbol values for a certain group of resources, you'll probably find it more convenient and safer to break out these symbols into a separate read-only header file, as described in the above section [Including Additional Header Files](#_mfcnotes_tn035_including). -## How Visual C++ manages Set Includes information +## How Visual Studio manages Set Includes information As discussed above, the File menu Set Includes command lets you specify three types of information: @@ -303,11 +303,11 @@ As discussed above, the File menu Set Includes command lets you specify three ty - Compile-Time Directives -The following table describes how Visual C++ maintains this information in a `.RC` file. You don't need this information to use Visual C++, but it may enhance your understanding so that you can more confidently use the Set Includes feature. +The following table describes how Visual Studio maintains this information in a `.RC` file. You don't need this information to use Visual Studio, but it may enhance your understanding so that you can more confidently use the Set Includes feature. -Each of the above three types of Set Includes information is stored in the `.RC` file in two forms: (1) as `#include` or other directives interpretable by the Resource Compiler, and (2) as special `TEXTINCLUDE` resources interpretable only by Visual C++. +Each of the above three types of Set Includes information is stored in the `.RC` file in two forms: (1) as `#include` or other directives interpretable by the Resource Compiler, and (2) as special `TEXTINCLUDE` resources interpretable only by Visual Studio. -The purpose of the `TEXTINCLUDE` resource is to safely store Set Include information in a form that is readily presentable in Visual C++'s **Set Includes** dialog box. `TEXTINCLUDE` is a *resource type* defined by Visual C++. Visual C++ recognizes three specific `TEXTINCLUDE` resources that have the resource identification numbers 1, 2 and 3: +The purpose of the `TEXTINCLUDE` resource is to safely store Set Include information in a form that is readily presentable in Visual Studio's **Set Includes** dialog box. `TEXTINCLUDE` is a *resource type* defined by Visual Studio. Visual Studio recognizes three specific `TEXTINCLUDE` resources that have the resource identification numbers 1, 2 and 3: |`TEXTINCLUDE` resource ID|Type of Set Includes information| |-----------------------------|--------------------------------------| @@ -362,21 +362,21 @@ Compile-Time Directives are included at the end of `MYAPP.RC` in the following f // // From TEXTINCLUDE 3 // -#include "res\myapp.rc2" // non-Visual C++ edited resources +#include "res\myapp.rc2" // non-Visual Studio edited resources #include "afxres.rc" // Standard components #include "afxprint.rc" // printing/print preview resources #endif // not APSTUDIO_INVOKED ``` -The `#ifndef APSTUDIO_INVOKED` directive instructs Visual C++ to skip over Compile-Time Directives. +The `#ifndef APSTUDIO_INVOKED` directive instructs Visual Studio to skip over Compile-Time Directives. The corresponding `TEXTINCLUDE` resource is: ```rc 3 TEXTINCLUDE DISCARDABLE BEGIN -"#include ""res\myapp.rc2"" // non-Visual C++ edited resources\r\n" +"#include ""res\myapp.rc2"" // non-Visual Studio edited resources\r\n" "\r\n" "#include ""afxres.rc"" // Standard components\r\n" "#include ""afxprint.rc"" // printing/print preview resources\r\n" diff --git a/docs/mfc/tn038-mfc-ole-iunknown-implementation.md b/docs/mfc/tn038-mfc-ole-iunknown-implementation.md index a7e7375d137..f9dd6560fb7 100644 --- a/docs/mfc/tn038-mfc-ole-iunknown-implementation.md +++ b/docs/mfc/tn038-mfc-ole-iunknown-implementation.md @@ -1,9 +1,8 @@ --- -description: "Learn more about: TN038: MFC/OLE IUnknown Implementation" title: "TN038: MFC-OLE IUnknown Implementation" +description: "Learn more about: TN038: MFC/OLE IUnknown Implementation" ms.date: "06/28/2018" helpviewer_keywords: ["aggregation macros [MFC]", "COM interfaces, base interface", "IUnknown interface", "END_INTERFACE_MAP macro [MFC]", "TN038", "BEGIN_INTERFACE_PART macro [MFC]", "DECLARE_INTERFACE_MAP macro [MFC]", "BEGIN_INTERFACE_MAP macro [MFC]", "OLE [MFC], implementing IUnknown interface", "METHOD_PROLOGUE macro [MFC]", "STDMETHOD macro [MFC]", "END_INTERFACE_PART macro [MFC]", "INTERFACE_PART macro"] -ms.assetid: 19d946ba-beaf-4881-85c6-0b598d7f6f11 --- # TN038: MFC/OLE IUnknown Implementation @@ -518,7 +517,7 @@ END_INTERFACE_PART(MyAdviseSink) would define a local class called XMyAdviseSink derived from IAdviseSink, and a member of the class in which it is declared called m_xMyAdviseSink.Note: > [!NOTE] -> The lines beginning with `STDMETHOD`_ are essentially copied from OLE2.H and modified slightly. Copying them from OLE2.H can reduce errors that are hard to resolve. +> The lines beginning with `STDMETHOD_` are essentially copied from OLE2.H and modified slightly. Copying them from OLE2.H can reduce errors that are hard to resolve. ### BEGIN_INTERFACE_MAP and END_INTERFACE_MAP — Macro Descriptions diff --git a/docs/mfc/tn039-mfc-ole-automation-implementation.md b/docs/mfc/tn039-mfc-ole-automation-implementation.md index f0293d78dae..9cc0196268e 100644 --- a/docs/mfc/tn039-mfc-ole-automation-implementation.md +++ b/docs/mfc/tn039-mfc-ole-automation-implementation.md @@ -85,7 +85,7 @@ The Z property is given a **DISPID** with a zero **HIWORD** since it is defined ## Advanced MFC Dispatch Map Features -There are a number of additional features that ClassWizard does not support with this release of Visual C++. ClassWizard supports `DISP_FUNCTION`, `DISP_PROPERTY`, and `DISP_PROPERTY_EX` which define a method, member variable property, and get/set member function property, respectively. These capabilities are usually all that is needed to create most automation servers. +There are a number of additional features that ClassWizard does not support with this release of Visual Studio. ClassWizard supports `DISP_FUNCTION`, `DISP_PROPERTY`, and `DISP_PROPERTY_EX` which define a method, member variable property, and get/set member function property, respectively. These capabilities are usually all that is needed to create most automation servers. The following additional macros can be used when the ClassWizard supported macros are not adequate: `DISP_PROPERTY_NOTIFY`, and `DISP_PROPERTY_PARAM`. diff --git a/docs/mfc/tn041-mfc-ole1-migration-to-mfc-ole-2.md b/docs/mfc/tn041-mfc-ole1-migration-to-mfc-ole-2.md index 9838cef62ca..5dbdc995f5f 100644 --- a/docs/mfc/tn041-mfc-ole1-migration-to-mfc-ole-2.md +++ b/docs/mfc/tn041-mfc-ole1-migration-to-mfc-ole-2.md @@ -276,7 +276,7 @@ At this point, OCLIENT is a functional OLE container application. It is possible One of the most interesting features of OLE is in-place activation (or "Visual Editing"). This feature allows the server application to take over portions of the container's user interface to provided a more seamless editing interface for the user. To implement in-place activation to OCLIENT, some special resources need to be added, as well as some additional code. These resources and the code are normally provided by AppWizard — in fact, much of the code here was borrowed directly from a fresh AppWizard application with "Container" support. -First of all, it is necessary to add a menu resource to be used when there is an item which is in-place active. You can create this extra menu resource in Visual C++ by copying the IDR_OCLITYPE resource and removing all but the File and Window pop-ups. Two separator bars are inserted between the File and Window pop-ups to indicate the separation of groups (it should look like: `File || Window`). For more information on what these separators mean and how the server and container menus are merged see [Menus and Resources: Menu Merging](../mfc/menus-and-resources-menu-merging.md). +First of all, it is necessary to add a menu resource to be used when there is an item which is in-place active. You can create this extra menu resource in Visual Studio by copying the IDR_OCLITYPE resource and removing all but the File and Window pop-ups. Two separator bars are inserted between the File and Window pop-ups to indicate the separation of groups (it should look like: `File || Window`). For more information on what these separators mean and how the server and container menus are merged see [Menus and Resources: Menu Merging](../mfc/menus-and-resources-menu-merging.md). Once you have these menus created, you need to let the framework know about them. This is done by calling `CDocTemplate::SetContainerInfo` for the document template before you add it to the document template list in your InitInstance. The new code to register the document template looks like this: @@ -292,7 +292,7 @@ pTemplate->SetContainerInfo(IDR_OLECLITYPE_INPLACE); AddDocTemplate(pTemplate); ``` -The IDR_OLECLITYPE_INPLACE resource is the special in-place resource created in Visual C++. +The IDR_OLECLITYPE_INPLACE resource is the special in-place resource created in Visual Studio. To enable in-place activation, there are some things that need to change in both the `CView` (CMainView) derived class as well as the `COleClientItem` derived class (CRectItem). All of these overrides are provided by AppWizard and most of the implementation will come directly from a default AppWizard application. @@ -338,7 +338,7 @@ BOOL CRectItem::OnChangeItemPosition(const CRect& rectPos) At this point, there is enough code to allow an item to be in-place activated and to deal with sizing and moving the item when it is active, but no code will allow the user to exit the editing session. Although some servers will provide this functionality themselves by handling the escape key, it is suggested that containers provide two ways to deactivate an item: (1) by clicking outside the item, and (2) by pressing the ESCAPE key. -For the ESCAPE key, add an accelerator with Visual C++ that maps the VK_ESCAPE key to a command, ID_CANCEL_EDIT is added to the resources. The handler for this command follows: +For the ESCAPE key, add an accelerator with Visual Studio that maps the VK_ESCAPE key to a command, ID_CANCEL_EDIT is added to the resources. The handler for this command follows: ```cpp // The following command handler provides the standard @@ -512,7 +512,7 @@ BOOL COLEServerApp::InitInstance() You will notice that the code above refers to a new resource ID, IDR_HIERSVRTYPE_SRVR_EMB. This is the menu resource to be used when a document that is embedded in another container is edited. In MFC/OLE1 the menu items specific to editing an embedded item were modified on the fly. Using an entirely different menu structure when editing an embedded item instead of editing a file-based document makes it much easier to provide different user interfaces for these two separate modes. As you'll see later, an entirely separate menu resource is used when editing an embedded object in-place. -To create this resource, load the resource script into Visual C++ and copy the existing IDR_HIERSVRTYPE menu resource. Rename the new resource to IDR_HIERSVRTYPE_SRVR_EMB (this is the same naming convention that AppWizard uses). Next change "File Save" to "File Update"; give it command ID ID_FILE_UPDATE. Also change "File Save As" to "File Save Copy As"; give it command ID ID_FILE_SAVE_COPY_AS. The framework provides the implementation of both of these commands. +To create this resource, load the resource script into Visual Studio and copy the existing IDR_HIERSVRTYPE menu resource. Rename the new resource to IDR_HIERSVRTYPE_SRVR_EMB (this is the same naming convention that AppWizard uses). Next change "File Save" to "File Update"; give it command ID ID_FILE_UPDATE. Also change "File Save As" to "File Save Copy As"; give it command ID ID_FILE_SAVE_COPY_AS. The framework provides the implementation of both of these commands. ```Output \hiersvr\svritem.h(60) : error C2433: 'OLESTATUS' : 'virtual' not permitted on data declarations @@ -629,9 +629,9 @@ To add "Visual Editing" (or in-place activation) to this server application, the - You need to tell the framework about these special resources and classes. -The menu resource is easy to create. Run Visual C++, copy the menu resource IDR_HIERSVRTYPE to a menu resource called IDR_HIERSVRTYPE_SRVR_IP. Modify the menu so that only the Edit and Help menu popups are left. Add two separators to the menu in between the Edit and Help menus (it should look like: `Edit || Help`). For more information on what these separators mean and how the server and container menus are merged, see [Menus and Resources: Menu Merging](../mfc/menus-and-resources-menu-merging.md). +The menu resource is easy to create. Run Visual Studio, copy the menu resource IDR_HIERSVRTYPE to a menu resource called IDR_HIERSVRTYPE_SRVR_IP. Modify the menu so that only the Edit and Help menu popups are left. Add two separators to the menu in between the Edit and Help menus (it should look like: `Edit || Help`). For more information on what these separators mean and how the server and container menus are merged, see [Menus and Resources: Menu Merging](../mfc/menus-and-resources-menu-merging.md). -The bitmap for the subset toolbar can be easily created by copying the one from a fresh AppWizard generated application with a "Server" option checked. This bitmap can then be imported into Visual C++. Be sure to give the bitmap an ID of IDR_HIERSVRTYPE_SRVR_IP. +The bitmap for the subset toolbar can be easily created by copying the one from a fresh AppWizard generated application with a "Server" option checked. This bitmap can then be imported into Visual Studio. Be sure to give the bitmap an ID of IDR_HIERSVRTYPE_SRVR_IP. The class derived from `COleIPFrameWnd` can be copied from an AppWizard generated application with server support as well. Copy both files, IPFRAME.CPP and IPFRAME.H and add them to the project. Make sure that the `LoadBitmap` call refers to IDR_HIERSVRTYPE_SRVR_IP, the bitmap created in the previous step. diff --git a/docs/mfc/tn048-writing-odbc-setup-and-administration-programs.md b/docs/mfc/tn048-writing-odbc-setup-and-administration-programs.md index 5c3c307246d..40acefd321e 100644 --- a/docs/mfc/tn048-writing-odbc-setup-and-administration-programs.md +++ b/docs/mfc/tn048-writing-odbc-setup-and-administration-programs.md @@ -4,6 +4,7 @@ title: "TN048: Writing ODBC Setup and Administration Programs for MFC Database A ms.date: "11/04/2016" helpviewer_keywords: ["installing ODBC", "ODBC, installing", "setup, ODBC setup programs", "TN048", "ODBC, and MFC", "MFC, database applications"] ms.assetid: d456cdd4-0513-4a51-80c0-9132b66115ce +ms.topic: install-set-up-deploy --- # TN048: Writing ODBC Setup and Administration Programs for MFC Database Applications diff --git a/docs/mfc/tn053-custom-dfx-routines-for-dao-database-classes.md b/docs/mfc/tn053-custom-dfx-routines-for-dao-database-classes.md index 5902135a9a4..0a40b8e8745 100644 --- a/docs/mfc/tn053-custom-dfx-routines-for-dao-database-classes.md +++ b/docs/mfc/tn053-custom-dfx-routines-for-dao-database-classes.md @@ -8,7 +8,7 @@ ms.assetid: fdcf3c51-4fa8-4517-9222-58aaa4f25cac # TN053: Custom DFX Routines for DAO Database Classes > [!NOTE] -> DAO is used with Access databases and is supported through Office 2013. DAO 3.6 is the final version, and it is considered obsolete. The Visual C++ environment and wizards do not support DAO (although the DAO classes are included and you can still use them). Microsoft recommends that you use [OLE DB Templates](../data/oledb/ole-db-templates.md) or [ODBC and MFC](../data/odbc/odbc-and-mfc.md) for new projects. You should only use DAO in maintaining existing applications. +> DAO is used with Access databases and is supported through Office 2013. DAO 3.6 is the final version, and it is considered obsolete. The Visual Studio environment and wizards do not support DAO (although the DAO classes are included and you can still use them). Microsoft recommends that you use [OLE DB Templates](../data/oledb/ole-db-templates.md) or [ODBC and MFC](../data/odbc/odbc-and-mfc.md) for new projects. You should only use DAO in maintaining existing applications. This technical note describes the DAO record field exchange (DFX) mechanism. To help understand what is happening in the DFX routines, the `DFX_Text` function will be explained in detail as an example. As an additional source of information to this technical note, you can examine the code for the other the individual DFX functions. You probably will not need a custom DFX routine as often as you might need a custom RFX routine (used with ODBC database classes). diff --git a/docs/mfc/tn054-calling-dao-directly-while-using-mfc-dao-classes.md b/docs/mfc/tn054-calling-dao-directly-while-using-mfc-dao-classes.md index 02a2e7b5061..3b44465a053 100644 --- a/docs/mfc/tn054-calling-dao-directly-while-using-mfc-dao-classes.md +++ b/docs/mfc/tn054-calling-dao-directly-while-using-mfc-dao-classes.md @@ -4,11 +4,12 @@ title: "TN054: Calling DAO Directly While Using MFC DAO Classes" ms.date: "09/17/2019" helpviewer_keywords: ["MFC, DAO and", "passwords [MFC], calling DAO", "security [MFC], DAO", "DAO (Data Access Objects), calling directly", "DAO (Data Access Objects), security", "security [MFC]", "TN054", "DAO (Data Access Objects), and MFC"] ms.assetid: f7de7d85-8d6c-4426-aa05-2e617c0da957 +ms.custom: sfi-ropc-nochange --- # TN054: Calling DAO Directly While Using MFC DAO Classes > [!NOTE] -> DAO is used with Access databases and is supported through Office 2013. DAO 3.6 is the final version, and it is considered obsolete. The Visual C++ environment and wizards do not support DAO (although the DAO classes are included and you can still use them). Microsoft recommends that you use [OLE DB Templates](../data/oledb/ole-db-templates.md) or [ODBC and MFC](../data/odbc/odbc-and-mfc.md) for new projects. You should only use DAO in maintaining existing applications. +> DAO is used with Access databases and is supported through Office 2013. DAO 3.6 is the final version, and it is considered obsolete. The Visual Studio environment and wizards do not support DAO (although the DAO classes are included and you can still use them). Microsoft recommends that you use [OLE DB Templates](../data/oledb/ole-db-templates.md) or [ODBC and MFC](../data/odbc/odbc-and-mfc.md) for new projects. You should only use DAO in maintaining existing applications. When using the MFC DAO database classes, there may be situations where it is necessary to use DAO directly. Usually, this will not be the case, but MFC has provided some helper mechanisms to facilitate making direct DAO calls simple when combining the use of the MFC classes with direct DAO calls. Making direct DAO calls to the methods of an MFC-managed DAO object should require only a few lines of code. If you need to create and use DAO objects that are *not* managed by MFC, you will have to do a little more work by actually calling `Release` on the object. This technical note explains when you might want to call DAO directly, what the MFC helpers can do to help you, and how to use the DAO OLE interfaces. Finally, this note provides some sample functions showing how to call DAO directly for DAO security features. diff --git a/docs/mfc/tn055-migrating-mfc-odbc-database-class-applications-to-mfc-dao-classes.md b/docs/mfc/tn055-migrating-mfc-odbc-database-class-applications-to-mfc-dao-classes.md index 4f563326304..20f25fc6f90 100644 --- a/docs/mfc/tn055-migrating-mfc-odbc-database-class-applications-to-mfc-dao-classes.md +++ b/docs/mfc/tn055-migrating-mfc-odbc-database-class-applications-to-mfc-dao-classes.md @@ -8,7 +8,7 @@ ms.assetid: 0f858bd1-e168-4e2e-bcd1-8debd82856e4 # TN055: Migrating MFC ODBC Database Class Applications to MFC DAO Classes > [!NOTE] -> DAO is used with Access databases and is supported through Office 2013. DAO 3.6 is the final version, and it is considered obsolete. The Visual C++ environment and wizards do not support DAO (although the DAO classes are included and you can still use them). Microsoft recommends that you use [OLE DB Templates](../data/oledb/ole-db-templates.md) or [ODBC and MFC](../data/odbc/odbc-and-mfc.md) for new projects. You should only use DAO in maintaining existing applications. +> DAO is used with Access databases and is supported through Office 2013. DAO 3.6 is the final version, and it is considered obsolete. The Visual Studio environment and wizards do not support DAO (although the DAO classes are included and you can still use them). Microsoft recommends that you use [OLE DB Templates](../data/oledb/ole-db-templates.md) or [ODBC and MFC](../data/odbc/odbc-and-mfc.md) for new projects. You should only use DAO in maintaining existing applications. ## Overview diff --git a/docs/mfc/tn061-on-notify-and-wm-notify-messages.md b/docs/mfc/tn061-on-notify-and-wm-notify-messages.md index b035d0e6d44..41abe932b83 100644 --- a/docs/mfc/tn061-on-notify-and-wm-notify-messages.md +++ b/docs/mfc/tn061-on-notify-and-wm-notify-messages.md @@ -4,6 +4,7 @@ title: "TN061: ON_NOTIFY and WM_NOTIFY Messages" ms.date: "06/28/2018" helpviewer_keywords: ["ON_NOTIFY_EX message [MFC]", "TN061", "ON_NOTIFY message [MFC]", "ON_NOTIFY_EX_RANGE message [MFC]", "ON_NOTIFY_RANGE message [MFC]", "notification messages", "WM_NOTIFY message"] ms.assetid: 04a96dde-7049-41df-9954-ad7bb5587caf +ms.topic: reference --- # TN061: ON_NOTIFY and WM_NOTIFY Messages diff --git a/docs/mfc/tn062-message-reflection-for-windows-controls.md b/docs/mfc/tn062-message-reflection-for-windows-controls.md index 9f4d1c7ffe5..ce9be5675ff 100644 --- a/docs/mfc/tn062-message-reflection-for-windows-controls.md +++ b/docs/mfc/tn062-message-reflection-for-windows-controls.md @@ -90,7 +90,7 @@ This simple example creates a reusable control called `CYellowEdit`. The control You must have an application in which to develop the reusable control. If you don't have an existing application to use, create a dialog-based application using AppWizard. -2. With your project loaded into Visual C++, use ClassWizard to create a new class called `CYellowEdit` based on `CEdit`. +2. With your project loaded into Visual Studio, use ClassWizard to create a new class called `CYellowEdit` based on `CEdit`. 3. Add three member variables to your `CYellowEdit` class. The first two will be *COLORREF* variables to hold the text color and the background color. The third will be a `CBrush` object that will hold the brush for painting the background. The `CBrush` object allows you to create the brush once, merely referencing it after that, and to destroy the brush automatically when the `CYellowEdit` control is destroyed. diff --git a/docs/mfc/tn065-dual-interface-support-for-ole-automation-servers.md b/docs/mfc/tn065-dual-interface-support-for-ole-automation-servers.md index 295169fce62..d7b44243e73 100644 --- a/docs/mfc/tn065-dual-interface-support-for-ole-automation-servers.md +++ b/docs/mfc/tn065-dual-interface-support-for-ole-automation-servers.md @@ -31,7 +31,7 @@ Although OLE Automation allows you to implement an `IDispatch` interface, a VTBL A dual interface is really just a custom interface derived from `IDispatch`. The most straightforward way to implement dual-interface support in a `CCmdTarget`-based class is to first implement the normal dispatch interface on your class using MFC and ClassWizard, then add the custom interface later. For the most part, your custom interface implementation will simply delegate back to the MFC `IDispatch` implementation. -First, modify the ODL file for your server to define dual interfaces for your objects. To define a dual interface, you must use an interface statement, instead of the `DISPINTERFACE` statement that the Visual C++ wizards generate. Rather than removing the existing `DISPINTERFACE` statement, add a new interface statement. By retaining the `DISPINTERFACE` form, you can continue to use ClassWizard to add properties and methods to your object, but you must add the equivalent properties and methods to your interface statement. +First, modify the ODL file for your server to define dual interfaces for your objects. To define a dual interface, you must use an interface statement, instead of the `DISPINTERFACE` statement that the Visual Studio wizards generate. Rather than removing the existing `DISPINTERFACE` statement, add a new interface statement. By retaining the `DISPINTERFACE` form, you can continue to use ClassWizard to add properties and methods to your object, but you must add the equivalent properties and methods to your interface statement. An interface statement for a dual interface must have the *OLEAUTOMATION* and *DUAL* attributes, and the interface must be derived from `IDispatch`. You can use the [GUIDGEN](../overview/visual-cpp-samples.md) sample to create a **IID** for the dual interface: @@ -275,7 +275,7 @@ To add the **UUID** definitions from the MkTypLib-generated header file to your ## Specifying the Correct Object Class Name in the Type Library -The wizards shipped with Visual C++ incorrectly use the implementation class name to specify the coclass in the server's ODL file for OLE-creatable classes. While this will work, the implementation class name is probably not the class name you want users of your object to use. To specify the correct name, open the ODL file, locate each coclass statement, and replace the implementation class name with the correct external name. +The wizards shipped with Visual Studio incorrectly use the implementation class name to specify the coclass in the server's ODL file for OLE-creatable classes. While this will work, the implementation class name is probably not the class name you want users of your object to use. To specify the correct name, open the ODL file, locate each coclass statement, and replace the implementation class name with the correct external name. Note that when the coclass statement is changed, the variable names of **CLSID**s in the MkTypLib-generated header file will change accordingly. You will need to update your code to use the new variable names. diff --git a/docs/mfc/toc.yml b/docs/mfc/toc.yml index eff745b7441..fcc45274295 100644 --- a/docs/mfc/toc.yml +++ b/docs/mfc/toc.yml @@ -1493,7 +1493,7 @@ items: href: tn032-mfc-exception-mechanism.md - name: "TN033: DLL version of MFC" href: tn033-dll-version-of-mfc.md - - name: "TN035: Using multiple resource files and header files with Visual C++" + - name: "TN035: Using multiple resource files and header files with Visual Studio" href: tn035-using-multiple-resource-files-and-header-files-with-visual-cpp.md - name: "TN036: Using CFormView with AppWizard and ClassWizard" href: tn036-using-cformview-with-appwizard-and-classwizard.md @@ -2919,6 +2919,6 @@ items: - name: Add a method to an IDL interface in a MFC project href: reference/add-idl-mfc-method-wizard.md - name: Add a property to an IDL interface in a MFC project - href: reference/add-interface-definition-library-mfc-property-wizard.md + href: reference/add-interface-definition-library-mfc-property-wizard.md - name: MFC class wizard - href: reference/mfc-class-wizard.md \ No newline at end of file + href: reference/mfc-class-wizard.md \ No newline at end of file diff --git a/docs/mfc/toolbar-fundamentals.md b/docs/mfc/toolbar-fundamentals.md index 283156c66ef..e6f6328e2f2 100644 --- a/docs/mfc/toolbar-fundamentals.md +++ b/docs/mfc/toolbar-fundamentals.md @@ -47,7 +47,7 @@ The docking, floating, and tool tips calls are optional. You can remove those li ## Editing the Toolbar Resource -The default toolbar you get with the Application Wizard is based on an **RT_TOOLBAR** custom resource, introduced in MFC version 4.0. You can edit this resource with the [toolbar editor](../windows/toolbar-editor.md). The editor lets you easily add, delete, and rearrange buttons. It contains a graphical editor for the buttons that is very similar to the general graphics editor in Visual C++. If you edited toolbars in previous versions of Visual C++, you'll find the task much easier now. +The default toolbar you get with the Application Wizard is based on an **RT_TOOLBAR** custom resource, introduced in MFC version 4.0. You can edit this resource with the [toolbar editor](../windows/toolbar-editor.md). The editor lets you easily add, delete, and rearrange buttons. It contains a graphical editor for the buttons that is very similar to the general graphics editor in Visual Studio. If you edited toolbars in previous versions of Visual Studio, you'll find the task much easier now. To connect a toolbar button to a command, you give the button a command ID, such as `ID_MYCOMMAND`. Specify the command ID in the button's property page in the toolbar editor. Then create a handler function for the command (see [Mapping Messages to Functions](../mfc/reference/mapping-messages-to-functions.md) for more information). diff --git a/docs/mfc/tree-control-item-states-overview.md b/docs/mfc/tree-control-item-states-overview.md index 73e7e0f6327..ca07cec4fa6 100644 --- a/docs/mfc/tree-control-item-states-overview.md +++ b/docs/mfc/tree-control-item-states-overview.md @@ -4,6 +4,7 @@ title: "Tree Control Item States Overview" ms.date: "11/04/2016" helpviewer_keywords: ["states, CTreeCtrl items", "tree controls [MFC], item states overview", "CTreeCtrl class [MFC], item states"] ms.assetid: 2db11ae0-0d87-499d-8c1f-5e0dbe9e94c8 +ms.topic: concept-article --- # Tree Control Item States Overview diff --git a/docs/mfc/turning-off-the-activate-when-visible-option.md b/docs/mfc/turning-off-the-activate-when-visible-option.md index 837eb26f2f8..a72e1bf165f 100644 --- a/docs/mfc/turning-off-the-activate-when-visible-option.md +++ b/docs/mfc/turning-off-the-activate-when-visible-option.md @@ -4,6 +4,7 @@ title: "Turning off the Activate When Visible Option" ms.date: "11/04/2016" helpviewer_keywords: ["MFC ActiveX controls [MFC], activate options", "Activate When Visible option [MFC]"] ms.assetid: 8f7ddc5a-a7a6-4da8-bcb9-1b569f0ecb48 +ms.topic: concept-article --- # Turning off the Activate When Visible Option diff --git a/docs/mfc/updating-the-text-of-a-status-bar-pane.md b/docs/mfc/updating-the-text-of-a-status-bar-pane.md index 389cc228367..1954167790e 100644 --- a/docs/mfc/updating-the-text-of-a-status-bar-pane.md +++ b/docs/mfc/updating-the-text-of-a-status-bar-pane.md @@ -4,6 +4,7 @@ title: "Updating the Text of a Status-Bar Pane" ms.date: "11/04/2016" helpviewer_keywords: ["updating user interface objects [MFC]", "ON_UPDATE_COMMAND_UI macro [MFC]", "user interface objects [MFC], updating", "text, status bar", "CStatusBar class [MFC], updating", "SetText method [MFC]", "panes, status bar", "status bars [MFC], updating"] ms.assetid: 4984a3f4-9905-4d8c-a927-dca19781053b +ms.topic: how-to --- # Updating the Text of a Status-Bar Pane diff --git a/docs/mfc/upgrading-an-existing-activex-control.md b/docs/mfc/upgrading-an-existing-activex-control.md index e2b88e3db99..a6038e41168 100644 --- a/docs/mfc/upgrading-an-existing-activex-control.md +++ b/docs/mfc/upgrading-an-existing-activex-control.md @@ -4,6 +4,7 @@ title: "Upgrading an Existing ActiveX Control" ms.date: 11/03/2021 helpviewer_keywords: ["ActiveX controls [MFC], Internet", "LPK files for Internet controls", "safe for scripting and initialization (controls)", "OLE controls [MFC], upgrading to ActiveX", "CAB files, for ActiveX controls", "Internet applications [MFC], ActiveX controls", "Internet applications [MFC], packaging code for download", "upgrading ActiveX controls", "licensing ActiveX controls"] ms.assetid: 4d12ddfa-b491-4f9f-a0b7-b51458e05651 +ms.topic: how-to --- # Upgrading an Existing ActiveX Control @@ -47,7 +48,7 @@ CODEBASE="http://example.contoso.com/mycontrol.ocx#version=4, 1086" ``` -This solution downloads only the control's .ocx file, and requires any supporting DLLs to already be installed on the client machine. This will work for Internet Explorer and MFC ActiveX controls built with Visual C++, because Internet Explorer ships with the supporting DLLs for Visual C++ controls. If another Internet browser that is ActiveX control-capable is used to view this control, this solution will not work. +This solution downloads only the control's .ocx file, and requires any supporting DLLs to already be installed on the client machine. This will work for Internet Explorer and MFC ActiveX controls built with Visual Studio, because Internet Explorer ships with the supporting DLLs for Visual Studio controls. If another Internet browser that is ActiveX control-capable is used to view this control, this solution will not work. ### Using the CODEBASE Tag with an INF File @@ -157,7 +158,7 @@ HKEY_CLASSES_ROOT\CLSID\{06889605-B8D0-101A-91F1-00608CEAD5B3}\Implemented Categ If you want to use a licensed control on a Web page, you must verify that the license agreement allows its use on the Internet and create a license package file (LPK) for it. -A licensed ActiveX control will not load properly in an HTML page if the computer running Internet Explorer is not licensed to use the control. For example, if a licensed control was built using Visual C++, the HTML page using the control will load properly on the computer where the control was built, but it will not load on a different computer unless licensing information is included. +A licensed ActiveX control will not load properly in an HTML page if the computer running Internet Explorer is not licensed to use the control. For example, if a licensed control was built using Visual Studio, the HTML page using the control will load properly on the computer where the control was built, but it will not load on a different computer unless licensing information is included. To use a licensed ActiveX control in Internet Explorer, you must check the vendor's license agreement to verify that the license for the control permits: diff --git a/docs/mfc/using-a-common-control-as-a-child-window.md b/docs/mfc/using-a-common-control-as-a-child-window.md index b51b02f859c..a6bb23d0b33 100644 --- a/docs/mfc/using-a-common-control-as-a-child-window.md +++ b/docs/mfc/using-a-common-control-as-a-child-window.md @@ -4,6 +4,7 @@ title: "Using a Common Control as a Child Window" ms.date: "11/04/2016" helpviewer_keywords: ["controls [MFC], using as child windows", "windows [MFC], common controls as", "child windows [MFC], common controls as", "common controls [MFC], child windows", "Windows common controls [MFC], child windows"] ms.assetid: 608f7d47-7854-4fce-bde9-856c51e76753 +ms.topic: how-to --- # Using a Common Control as a Child Window diff --git a/docs/mfc/using-a-dialog-bar-with-a-rebar-control.md b/docs/mfc/using-a-dialog-bar-with-a-rebar-control.md index ca097e6d626..896a649cbc1 100644 --- a/docs/mfc/using-a-dialog-bar-with-a-rebar-control.md +++ b/docs/mfc/using-a-dialog-bar-with-a-rebar-control.md @@ -4,6 +4,7 @@ title: "Using a Dialog Bar with a Rebar Control" ms.date: "11/04/2016" helpviewer_keywords: ["WS_EX_TRANSPARENT style", "rebar controls [MFC], dialog bars", "dialog bars [MFC], using with rebar bands"] ms.assetid: e528cea0-6b81-4bdf-9643-7c03b6176590 +ms.topic: how-to --- # Using a Dialog Bar with a Rebar Control diff --git a/docs/mfc/using-a-dialog-template-in-memory.md b/docs/mfc/using-a-dialog-template-in-memory.md index 944130b91b0..2ebc1096f2c 100644 --- a/docs/mfc/using-a-dialog-template-in-memory.md +++ b/docs/mfc/using-a-dialog-template-in-memory.md @@ -4,6 +4,7 @@ title: "Using a Dialog Template in Memory" ms.date: "11/04/2016" helpviewer_keywords: ["templates [MFC], for dialog boxes", "dialog templates [MFC]", "dialog templates [MFC], in memory", "MFC dialog boxes [MFC], dialog templates"] ms.assetid: edb443bb-e614-4f77-8a3b-74d93871e9bd +ms.topic: concept-article --- # Using a Dialog Template in Memory diff --git a/docs/mfc/using-a-hot-key-control.md b/docs/mfc/using-a-hot-key-control.md index 64a2fe30c91..ca29fb0d076 100644 --- a/docs/mfc/using-a-hot-key-control.md +++ b/docs/mfc/using-a-hot-key-control.md @@ -4,6 +4,7 @@ title: "Using a Hot Key Control" ms.date: "11/04/2016" helpviewer_keywords: ["CHotKeyCtrl class [MFC], using", "hot key controls"] ms.assetid: cdd6524b-cc43-447f-b151-164273559685 +ms.topic: concept-article --- # Using a Hot Key Control diff --git a/docs/mfc/using-an-animation-control.md b/docs/mfc/using-an-animation-control.md index cbf09f8efee..ceff13db018 100644 --- a/docs/mfc/using-an-animation-control.md +++ b/docs/mfc/using-an-animation-control.md @@ -4,6 +4,7 @@ title: "Using an Animation Control" ms.date: "11/04/2016" helpviewer_keywords: ["controls [MFC], animation", "CAnimateCtrl class [MFC], animation controls", "animation controls [MFC]"] ms.assetid: a009a464-e12d-4112-bf52-04a09b28dd88 +ms.topic: concept-article --- # Using an Animation Control diff --git a/docs/mfc/using-an-image-list-with-a-rebar-control.md b/docs/mfc/using-an-image-list-with-a-rebar-control.md index 2c8d693dc63..4384b1557b7 100644 --- a/docs/mfc/using-an-image-list-with-a-rebar-control.md +++ b/docs/mfc/using-an-image-list-with-a-rebar-control.md @@ -4,6 +4,7 @@ title: "Using an Image List with a Rebar Control" ms.date: "11/04/2016" helpviewer_keywords: ["image lists [MFC], rebar controls", "rebar controls [MFC], image lists"] ms.assetid: 1a5836ac-019a-46aa-8741-b35c3376b839 +ms.topic: how-to --- # Using an Image List with a Rebar Control diff --git a/docs/mfc/using-an-image-list.md b/docs/mfc/using-an-image-list.md index 4796e5b6fbb..7016e9dd277 100644 --- a/docs/mfc/using-an-image-list.md +++ b/docs/mfc/using-an-image-list.md @@ -4,6 +4,7 @@ title: "Using an Image List" ms.date: "11/04/2016" helpviewer_keywords: ["lists [MFC], image", "CImageList class [MFC], using", "image lists [MFC]"] ms.assetid: e0aed188-a1e6-400e-9f51-033d61c5541f +ms.topic: concept-article --- # Using an Image List diff --git a/docs/mfc/using-an-unclipped-device-context.md b/docs/mfc/using-an-unclipped-device-context.md index 9b81ba4268a..35bd4e6fa10 100644 --- a/docs/mfc/using-an-unclipped-device-context.md +++ b/docs/mfc/using-an-unclipped-device-context.md @@ -4,6 +4,7 @@ title: "Using an Unclipped Device Context" ms.date: "11/04/2016" helpviewer_keywords: ["MFC ActiveX controls [MFC], unclipped device context"] ms.assetid: 9c020063-73da-4803-bf7b-2e1fd950c9ed +ms.topic: concept-article --- # Using an Unclipped Device Context diff --git a/docs/mfc/using-callback-fields-in-a-date-and-time-picker-control.md b/docs/mfc/using-callback-fields-in-a-date-and-time-picker-control.md index 1b2bf9f7f1d..34e4486769c 100644 --- a/docs/mfc/using-callback-fields-in-a-date-and-time-picker-control.md +++ b/docs/mfc/using-callback-fields-in-a-date-and-time-picker-control.md @@ -5,6 +5,7 @@ ms.date: "11/04/2016" f1_keywords: ["DTN_FORMATQUERY", "DTN_FORMAT"] helpviewer_keywords: ["DateTimePicker control [MFC], callback fields", "callback fields in CDateTimeCtrl class [MFC]", "CDateTimeCtrl class [MFC], callback fields", "CDateTimeCtrl class [MFC], handling DTN_FORMAT and DTN_FORMATQ", "DTN_FORMATQUERY notification [MFC]", "DTN_FORMAT notification [MFC]", "DateTimePicker control [MFC]"] ms.assetid: 404f4ba9-cba7-4718-9faa-bc6b274a723f +ms.topic: concept-article --- # Using Callback Fields in a Date and Time Picker Control diff --git a/docs/mfc/using-canimatectrl.md b/docs/mfc/using-canimatectrl.md index 7c02d4b52bf..76302558736 100644 --- a/docs/mfc/using-canimatectrl.md +++ b/docs/mfc/using-canimatectrl.md @@ -4,6 +4,7 @@ title: "Using CAnimateCtrl" ms.date: "11/04/2016" helpviewer_keywords: ["animation controls [MFC], CAnimateCtrl class", "controls [MFC], animation", "CAnimateCtrl class [MFC], about CAnimateCtrl class [MFC]"] ms.assetid: 696c0805-bef0-4e2e-a9e7-b37b9215b7f0 +ms.topic: concept-article --- # Using CAnimateCtrl diff --git a/docs/mfc/using-ccomboboxex.md b/docs/mfc/using-ccomboboxex.md index a0ccb2ebc22..a9c9fca4d11 100644 --- a/docs/mfc/using-ccomboboxex.md +++ b/docs/mfc/using-ccomboboxex.md @@ -4,6 +4,7 @@ title: "Using CComboBoxEx" ms.date: "11/04/2016" helpviewer_keywords: ["combo boxes [MFC], extended", "extended combo boxes [MFC], about extended combo boxes", "combo boxes [MFC], CComboBoxEx class", "CComboBox class [MFC], extended"] ms.assetid: c23cbfe8-75d2-4f98-a753-c942416eda52 +ms.topic: concept-article --- # Using CComboBoxEx diff --git a/docs/mfc/using-cdatetimectrl.md b/docs/mfc/using-cdatetimectrl.md index 1dc32ef93b9..2a67477916f 100644 --- a/docs/mfc/using-cdatetimectrl.md +++ b/docs/mfc/using-cdatetimectrl.md @@ -4,6 +4,7 @@ title: "Using CDateTimeCtrl" ms.date: "11/04/2016" helpviewer_keywords: ["DateTimePicker control [MFC], CDateTimeCtrl class"] ms.assetid: cb2a8720-43f1-4c33-a3a4-def9a1622e00 +ms.topic: concept-article --- # Using CDateTimeCtrl diff --git a/docs/mfc/using-cheaderctrl.md b/docs/mfc/using-cheaderctrl.md index f5d2df5c64a..acc495d5aa1 100644 --- a/docs/mfc/using-cheaderctrl.md +++ b/docs/mfc/using-cheaderctrl.md @@ -4,6 +4,7 @@ title: "Using CHeaderCtrl" ms.date: "11/04/2016" helpviewer_keywords: ["header controls [MFC], using", "CHeaderCtrl class [MFC]"] ms.assetid: fb3e512b-9539-43c4-a7e7-3fafd6d0706e +ms.topic: concept-article --- # Using CHeaderCtrl diff --git a/docs/mfc/using-chotkeyctrl.md b/docs/mfc/using-chotkeyctrl.md index 051b6ffdb9d..2d7022a2830 100644 --- a/docs/mfc/using-chotkeyctrl.md +++ b/docs/mfc/using-chotkeyctrl.md @@ -4,6 +4,7 @@ title: "Using CHotKeyCtrl" ms.date: "11/04/2016" helpviewer_keywords: ["keys, hot and CHotKeyCtrl", "CHotKeyCtrl class [MFC], using", "hot key controls"] ms.assetid: 9b207117-d848-4224-8888-c3d197bb0c95 +ms.topic: concept-article --- # Using CHotKeyCtrl diff --git a/docs/mfc/using-cimagelist.md b/docs/mfc/using-cimagelist.md index 45fcf927268..64daaad06c3 100644 --- a/docs/mfc/using-cimagelist.md +++ b/docs/mfc/using-cimagelist.md @@ -4,6 +4,7 @@ title: "Using CImageList" ms.date: "11/04/2016" helpviewer_keywords: ["image list control", "CImageList class [MFC], using"] ms.assetid: 3d2a909e-d641-46b7-aada-81cab1a29b41 +ms.topic: concept-article --- # Using CImageList diff --git a/docs/mfc/using-clistctrl.md b/docs/mfc/using-clistctrl.md index ea7188aea4f..9381c761991 100644 --- a/docs/mfc/using-clistctrl.md +++ b/docs/mfc/using-clistctrl.md @@ -4,6 +4,7 @@ title: "Using CListCtrl" ms.date: "11/04/2016" helpviewer_keywords: ["CListCtrl class [MFC], using"] ms.assetid: 20d6a5d6-8f07-4ddf-975f-ea2dfebcc835 +ms.topic: concept-article --- # Using CListCtrl diff --git a/docs/mfc/using-cmonthcalctrl.md b/docs/mfc/using-cmonthcalctrl.md index 77869ba574a..270c33595c5 100644 --- a/docs/mfc/using-cmonthcalctrl.md +++ b/docs/mfc/using-cmonthcalctrl.md @@ -4,6 +4,7 @@ title: "Using CMonthCalCtrl" ms.date: "11/04/2016" helpviewer_keywords: ["CMonthCalCtrl class [MFC], about CMonthCalCtrl class"] ms.assetid: 2be0e8c2-ed03-4853-aea1-4461eba18611 +ms.topic: concept-article --- # Using CMonthCalCtrl diff --git a/docs/mfc/using-cobject.md b/docs/mfc/using-cobject.md index af6529ea21d..a528b36ec18 100644 --- a/docs/mfc/using-cobject.md +++ b/docs/mfc/using-cobject.md @@ -4,6 +4,7 @@ title: "Using CObject" ms.date: "11/04/2016" helpviewer_keywords: ["examples [MFC], CObject", "root base class for MFC", "derived classes [MFC], from CObject", "MFC, base class", "CObject class [MFC]"] ms.assetid: d0cd19bb-2856-4b41-abbc-620fd64cb223 +ms.topic: concept-article --- # Using CObject diff --git a/docs/mfc/using-common-controls-in-a-dialog-box.md b/docs/mfc/using-common-controls-in-a-dialog-box.md index 6caadbbe11b..d28c82e7536 100644 --- a/docs/mfc/using-common-controls-in-a-dialog-box.md +++ b/docs/mfc/using-common-controls-in-a-dialog-box.md @@ -4,6 +4,7 @@ title: "Using Common Controls in a Dialog Box" ms.date: "11/04/2016" helpviewer_keywords: ["common controls [MFC], in dialog boxes", "dialog box controls [MFC], common controls", "Windows common controls [MFC], in dialog boxes"] ms.assetid: 17713caf-09f8-484a-bf54-5f48bf09cce9 +ms.topic: how-to --- # Using Common Controls in a Dialog Box diff --git a/docs/mfc/using-cprogressctrl.md b/docs/mfc/using-cprogressctrl.md index 884b121ca0a..07121a9f076 100644 --- a/docs/mfc/using-cprogressctrl.md +++ b/docs/mfc/using-cprogressctrl.md @@ -4,6 +4,7 @@ title: "Using CProgressCtrl" ms.date: "11/04/2016" helpviewer_keywords: ["progress controls [MFC]", "CProgressCtrl class [MFC], using", "progress controls [MFC], CProgressCtrl", "progress controls [MFC], using"] ms.assetid: 61473270-196b-41ab-bf2b-467f46673539 +ms.topic: concept-article --- # Using CProgressCtrl diff --git a/docs/mfc/using-crebarctrl.md b/docs/mfc/using-crebarctrl.md index c77177533ab..ce1e299588f 100644 --- a/docs/mfc/using-crebarctrl.md +++ b/docs/mfc/using-crebarctrl.md @@ -4,6 +4,7 @@ title: "Using CReBarCtrl" ms.date: "11/19/2018" helpviewer_keywords: ["child windows [MFC], rebar controls", "combo boxes [MFC], in rebar controls", "rebar controls"] ms.assetid: 2c0aeec2-ffc3-44b8-97b5-0f56e116a338 +ms.topic: concept-article --- # Using CReBarCtrl diff --git a/docs/mfc/using-cricheditctrl.md b/docs/mfc/using-cricheditctrl.md index 5d14b8c84bb..1d96ea63105 100644 --- a/docs/mfc/using-cricheditctrl.md +++ b/docs/mfc/using-cricheditctrl.md @@ -4,6 +4,7 @@ title: "Using CRichEditCtrl" ms.date: "11/04/2016" helpviewer_keywords: ["rich edit controls [MFC], using", "CRichEditCtrl class [MFC], using"] ms.assetid: e400c6ed-563e-4d4c-ab3b-a3f0aa20273b +ms.topic: concept-article --- # Using CRichEditCtrl diff --git a/docs/mfc/using-csliderctrl.md b/docs/mfc/using-csliderctrl.md index 0b1b04c8216..f4b91032146 100644 --- a/docs/mfc/using-csliderctrl.md +++ b/docs/mfc/using-csliderctrl.md @@ -4,6 +4,7 @@ title: "Using CSliderCtrl" ms.date: "11/04/2016" helpviewer_keywords: ["CSliderCtrl class [MFC], using", "slider controls [MFC], using"] ms.assetid: 242c7bcd-126e-4b9b-8f76-8082ad06fe73 +ms.topic: concept-article --- # Using CSliderCtrl diff --git a/docs/mfc/using-cspinbuttonctrl.md b/docs/mfc/using-cspinbuttonctrl.md index 7e1f5c444c9..9a28599d04b 100644 --- a/docs/mfc/using-cspinbuttonctrl.md +++ b/docs/mfc/using-cspinbuttonctrl.md @@ -4,6 +4,7 @@ title: "Using CSpinButtonCtrl" ms.date: "11/04/2016" helpviewer_keywords: ["up-down controls [MFC], spin button control", "up-down controls", "spin button control", "CSpinButtonCtrl class [MFC], using"] ms.assetid: a91db36b-e11e-42ef-8e89-51915cc486d2 +ms.topic: concept-article --- # Using CSpinButtonCtrl diff --git a/docs/mfc/using-cstatusbarctrl-to-create-a-cstatusbarctrl-object.md b/docs/mfc/using-cstatusbarctrl-to-create-a-cstatusbarctrl-object.md index c332a42a3e1..daf703d6076 100644 --- a/docs/mfc/using-cstatusbarctrl-to-create-a-cstatusbarctrl-object.md +++ b/docs/mfc/using-cstatusbarctrl-to-create-a-cstatusbarctrl-object.md @@ -4,6 +4,7 @@ title: "Using CStatusBarCtrl to Create a CStatusBarCtrl Object" ms.date: "11/04/2016" helpviewer_keywords: ["status bar controls [MFC], creating", "CStatusBarCtrl class [MFC], creating"] ms.assetid: 365c2b65-12de-49e6-9a2e-416c6ee10d60 +ms.topic: how-to --- # Using CStatusBarCtrl to Create a CStatusBarCtrl Object diff --git a/docs/mfc/using-cstatusbarctrl.md b/docs/mfc/using-cstatusbarctrl.md index b7805b4eb79..9cb57d6094d 100644 --- a/docs/mfc/using-cstatusbarctrl.md +++ b/docs/mfc/using-cstatusbarctrl.md @@ -4,6 +4,7 @@ title: "Using CStatusBarCtrl" ms.date: "11/04/2016" helpviewer_keywords: ["CStatusBarCtrl class [MFC], using", "status bar controls [MFC], about status bar controls"] ms.assetid: 08b39f83-580d-439a-b93e-7ef9e2a5702a +ms.topic: concept-article --- # Using CStatusBarCtrl diff --git a/docs/mfc/using-ctabctrl.md b/docs/mfc/using-ctabctrl.md index 75006f68eb2..6d93b0163f0 100644 --- a/docs/mfc/using-ctabctrl.md +++ b/docs/mfc/using-ctabctrl.md @@ -4,6 +4,7 @@ title: "Using CTabCtrl" ms.date: "11/04/2016" helpviewer_keywords: ["CTabCtrl class [MFC], using", "tab controls [MFC], using"] ms.assetid: 6bda6798-0085-4c09-a5ea-fe0e97af5c95 +ms.topic: concept-article --- # Using CTabCtrl diff --git a/docs/mfc/using-ctoolbarctrl.md b/docs/mfc/using-ctoolbarctrl.md index 13abfe7b9e4..51e7fb244bb 100644 --- a/docs/mfc/using-ctoolbarctrl.md +++ b/docs/mfc/using-ctoolbarctrl.md @@ -4,6 +4,7 @@ title: "Using CToolBarCtrl" ms.date: "11/04/2016" helpviewer_keywords: ["CToolBarCtrl class [MFC]", "toolbar controls [MFC], creating"] ms.assetid: 13cf3753-135b-4a3e-a850-ed30177fcf9d +ms.topic: concept-article --- # Using CToolBarCtrl diff --git a/docs/mfc/using-ctooltipctrl-to-create-and-manipulate-a-ctooltipctrl-object.md b/docs/mfc/using-ctooltipctrl-to-create-and-manipulate-a-ctooltipctrl-object.md index 14c85737f80..8bb04ae8078 100644 --- a/docs/mfc/using-ctooltipctrl-to-create-and-manipulate-a-ctooltipctrl-object.md +++ b/docs/mfc/using-ctooltipctrl-to-create-and-manipulate-a-ctooltipctrl-object.md @@ -4,6 +4,7 @@ title: "Using CToolTipCtrl to Create and Manipulate a CToolTipCtrl Object" ms.date: "11/04/2016" helpviewer_keywords: ["tool tips [MFC], creating", "CToolTipCtrl class [MFC], using"] ms.assetid: 0a34583f-f66d-46a1-a239-31b80ea395ad +ms.topic: how-to --- # Using CToolTipCtrl to Create and Manipulate a CToolTipCtrl Object diff --git a/docs/mfc/using-ctooltipctrl.md b/docs/mfc/using-ctooltipctrl.md index edcd85851ea..88c9dd0e09b 100644 --- a/docs/mfc/using-ctooltipctrl.md +++ b/docs/mfc/using-ctooltipctrl.md @@ -4,6 +4,7 @@ title: "Using CToolTipCtrl" ms.date: "11/04/2016" helpviewer_keywords: ["CToolTipCtrl class [MFC], creating tool tips", "CToolTipCtrl class"] ms.assetid: 8fc58a04-4792-4223-a092-d349d11344da +ms.topic: concept-article --- # Using CToolTipCtrl diff --git a/docs/mfc/using-ctreectrl.md b/docs/mfc/using-ctreectrl.md index f7412fec528..18651d78c16 100644 --- a/docs/mfc/using-ctreectrl.md +++ b/docs/mfc/using-ctreectrl.md @@ -4,6 +4,7 @@ title: "Using CTreeCtrl" ms.date: "11/04/2016" helpviewer_keywords: ["CTreeCtrl class [MFC], about CTreeCtrl", "tree controls [MFC], using"] ms.assetid: 6a262f2c-3540-43e5-b03f-e4b6f9cb0325 +ms.topic: concept-article --- # Using CTreeCtrl diff --git a/docs/mfc/using-custom-format-strings-in-a-date-and-time-picker-control.md b/docs/mfc/using-custom-format-strings-in-a-date-and-time-picker-control.md index eae626975e7..0137fffce30 100644 --- a/docs/mfc/using-custom-format-strings-in-a-date-and-time-picker-control.md +++ b/docs/mfc/using-custom-format-strings-in-a-date-and-time-picker-control.md @@ -4,6 +4,7 @@ title: "Using Custom Format Strings in a Date and Time Picker Control" ms.date: "11/04/2016" helpviewer_keywords: ["CDateTimeCtrl class [MFC], display styles", "DateTimePicker control [MFC], display styles", "DateTimePicker control [MFC]"] ms.assetid: 7d577f03-6ca0-4597-9093-50b78f304719 +ms.topic: concept-article --- # Using Custom Format Strings in a Date and Time Picker Control diff --git a/docs/mfc/using-documents.md b/docs/mfc/using-documents.md index aec24f4d756..73f97283a24 100644 --- a/docs/mfc/using-documents.md +++ b/docs/mfc/using-documents.md @@ -4,6 +4,7 @@ title: "Using Documents" ms.date: "11/04/2016" helpviewer_keywords: ["documents [MFC], C++ applications", "data [MFC], reading", "documents [MFC]", "files [MFC], writing to", "data [MFC], documents", "files [MFC]", "views [MFC], C++ applications", "document/view architecture [MFC], documents", "reading data [MFC], documents and views", "printing [MFC], documents", "writing to files [MFC]"] ms.assetid: f390d6d8-d0e1-4497-9b6a-435f7ce0776c +ms.topic: concept-article --- # Using Documents diff --git a/docs/mfc/using-drop-down-buttons-in-a-toolbar-control.md b/docs/mfc/using-drop-down-buttons-in-a-toolbar-control.md index 818fa7efcfe..86403dd5c23 100644 --- a/docs/mfc/using-drop-down-buttons-in-a-toolbar-control.md +++ b/docs/mfc/using-drop-down-buttons-in-a-toolbar-control.md @@ -5,6 +5,7 @@ ms.date: "11/04/2016" f1_keywords: ["TBN_DROPDOWN", "TBSTYLE_EX_DRAWDDARROWS"] helpviewer_keywords: ["CToolBarCtrl class [MFC], drop-down buttons", "toolbars [MFC], drop-down buttons", "drop-down buttons in toolbars", "TBSTYLE_EX_DRAWDDARROWS", "TBN_DROPDOWN notification [MFC]"] ms.assetid: b859f758-d2f6-40d9-9c26-0ff61993b9b2 +ms.topic: how-to --- # Using Drop-Down Buttons in a Toolbar Control diff --git a/docs/mfc/using-frame-windows.md b/docs/mfc/using-frame-windows.md index e6d18fe0760..39440816e66 100644 --- a/docs/mfc/using-frame-windows.md +++ b/docs/mfc/using-frame-windows.md @@ -4,6 +4,7 @@ title: "Using Frame Windows" ms.date: "11/04/2016" helpviewer_keywords: ["windows [MFC], frame windows", "frame windows [MFC], using", "MFC, frame windows"] ms.assetid: 4d773238-11f6-4ccf-8114-57310c5aaa2d +ms.topic: concept-article --- # Using Frame Windows diff --git a/docs/mfc/using-image-lists-in-a-toolbar-control.md b/docs/mfc/using-image-lists-in-a-toolbar-control.md index efa816d9951..5b280fa57e3 100644 --- a/docs/mfc/using-image-lists-in-a-toolbar-control.md +++ b/docs/mfc/using-image-lists-in-a-toolbar-control.md @@ -4,6 +4,7 @@ title: "Using Image Lists in a Toolbar Control" ms.date: "11/04/2016" helpviewer_keywords: ["toolbar controls [MFC], image", "image lists [MFC], toolbar controls", "CToolBarCtrl class [MFC], image lists"] ms.assetid: ccbe8df4-4ed9-4b54-bb93-9a1dcb3b97eb +ms.topic: concept-article --- # Using Image Lists in a Toolbar Control diff --git a/docs/mfc/using-image-lists-in-an-extended-combo-box-control.md b/docs/mfc/using-image-lists-in-an-extended-combo-box-control.md index 60f03d8ba45..4060970825c 100644 --- a/docs/mfc/using-image-lists-in-an-extended-combo-box-control.md +++ b/docs/mfc/using-image-lists-in-an-extended-combo-box-control.md @@ -4,6 +4,7 @@ title: "Using Image Lists in an Extended Combo Box Control" ms.date: "11/04/2016" helpviewer_keywords: ["image lists [MFC], combo boxes", "extended combo boxes [MFC], images", "images [MFC], combo box items"] ms.assetid: dfff25fe-af70-47a2-8032-3901d1e6842d +ms.topic: how-to --- # Using Image Lists in an Extended Combo Box Control diff --git a/docs/mfc/using-image-lists-with-header-controls.md b/docs/mfc/using-image-lists-with-header-controls.md index 346cef44bd1..830297f5a5f 100644 --- a/docs/mfc/using-image-lists-with-header-controls.md +++ b/docs/mfc/using-image-lists-with-header-controls.md @@ -4,6 +4,7 @@ title: "Using Image Lists with Header Controls" ms.date: "11/04/2016" helpviewer_keywords: ["header controls [MFC], image lists", "CHeaderCtrl class [MFC], image lists", "image lists [MFC], header controls"] ms.assetid: d5e9b310-6278-406c-909c-eefa09549a47 +ms.topic: how-to --- # Using Image Lists with Header Controls diff --git a/docs/mfc/using-property-sheets-in-your-application.md b/docs/mfc/using-property-sheets-in-your-application.md index 618786b7ce7..e3dc0d6e6b8 100644 --- a/docs/mfc/using-property-sheets-in-your-application.md +++ b/docs/mfc/using-property-sheets-in-your-application.md @@ -4,6 +4,7 @@ title: "Using Property Sheets in Your Application" ms.date: "11/04/2016" helpviewer_keywords: ["dialog templates [MFC], property sheets", "dialog resources", "property pages [MFC], property sheets", "DoModal method property sheets", "AddPage method [MFC]", "property sheets, about property sheets", "Create method [MFC], property sheets", "CPropertyPage class [MFC], styles"] ms.assetid: 240654d4-152b-4e3f-af7b-44234339206e +ms.topic: how-to --- # Using Property Sheets in Your Application diff --git a/docs/mfc/using-slider-controls.md b/docs/mfc/using-slider-controls.md index ce6fe778aae..2c970e4c5b0 100644 --- a/docs/mfc/using-slider-controls.md +++ b/docs/mfc/using-slider-controls.md @@ -4,6 +4,7 @@ title: "Using Slider Controls" ms.date: "11/04/2016" helpviewer_keywords: ["CSliderCtrl class [MFC], using", "slider controls", "slider controls [MFC], using"] ms.assetid: 2b1a8ac8-2b17-41e1-aa24-83c1fd737049 +ms.topic: concept-article --- # Using Slider Controls diff --git a/docs/mfc/using-the-carchive-output-and-input-operators.md b/docs/mfc/using-the-carchive-output-and-input-operators.md index 3562deb0f97..533547cef5d 100644 --- a/docs/mfc/using-the-carchive-output-and-input-operators.md +++ b/docs/mfc/using-the-carchive-output-and-input-operators.md @@ -4,6 +4,7 @@ title: "Using the CArchive << and >> Operators" ms.date: "11/04/2016" helpviewer_keywords: ["objects [MFC], loading from previously stored values", "CArchive class [MFC], storing and loading objects", "CArchive class [MFC], operators"] ms.assetid: 56aef326-02dc-4992-8282-f0a4b78a064e +ms.topic: how-to --- # Using the CArchive `<<` and `>>` Operators diff --git a/docs/mfc/using-the-classes-to-write-applications-for-windows.md b/docs/mfc/using-the-classes-to-write-applications-for-windows.md index 6b89b84fc1d..26a4f9ebf3c 100644 --- a/docs/mfc/using-the-classes-to-write-applications-for-windows.md +++ b/docs/mfc/using-the-classes-to-write-applications-for-windows.md @@ -4,10 +4,11 @@ title: "Using the Classes to Write Applications for Windows" ms.date: "11/04/2016" helpviewer_keywords: ["Windows applications [MFC], MFC application framework", "MFC, application development", "applications [OLE], MFC application framework", "MFC ActiveX controls [MFC], creating", "OLE applications [MFC], MFC application framework", "database applications [MFC], creating"] ms.assetid: 73f63470-857d-43dd-9a54-b38b7be0f1b7 +ms.topic: concept-article --- # Using the Classes to Write Applications for Windows -Taken together, the classes in the Microsoft Foundation Class (MFC) Library make up an "application framework," on which you build an application for the Windows operating system. At a very general level, the framework defines the skeleton of an application and supplies standard user-interface implementations that can be placed onto the skeleton. Your job as programmer is to fill in the rest of the skeleton, which are those things that are specific to your application. You can get a head start by using the MFC Application Wizard to create the files for a very thorough starter application. You use the Microsoft Visual C++ resource editors to design your user-interface elements visually, Class View commands to connect those elements to code, and the class library to implement your application-specific logic. +Taken together, the classes in the Microsoft Foundation Class (MFC) Library make up an "application framework," on which you build an application for the Windows operating system. At a very general level, the framework defines the skeleton of an application and supplies standard user-interface implementations that can be placed onto the skeleton. Your job as programmer is to fill in the rest of the skeleton, which are those things that are specific to your application. You can get a head start by using the MFC Application Wizard to create the files for a very thorough starter application. You use the Visual Studio resource editors to design your user-interface elements visually, Class View commands to connect those elements to code, and the class library to implement your application-specific logic. Version 3.0 and later of the MFC framework supports programming for Win32 platforms, including Microsoft Windows 95 and later, and Windows NT versions 3.51 and later. MFC Win32 support includes multithreading. Use version 1.5*x* if you need to do 16-bit programming. diff --git a/docs/mfc/using-the-dialog-editor-to-add-controls.md b/docs/mfc/using-the-dialog-editor-to-add-controls.md index fa78c746bd5..c5912c87f60 100644 --- a/docs/mfc/using-the-dialog-editor-to-add-controls.md +++ b/docs/mfc/using-the-dialog-editor-to-add-controls.md @@ -4,6 +4,7 @@ title: "Using the Dialog Editor to Add Controls" ms.date: "11/04/2016" helpviewer_keywords: ["Windows common controls [MFC], adding", "dialog box controls [MFC], adding to dialog boxes", "controls [MFC], adding to dialog boxes", "Dialog editor, creating controls", "common controls [MFC], adding"] ms.assetid: d3f9f994-7e54-4656-a545-42c204557c36 +ms.topic: concept-article --- # Using the Dialog Editor to Add Controls diff --git a/docs/mfc/using-the-mfc-source-files.md b/docs/mfc/using-the-mfc-source-files.md index 77141ce95cd..10c7f2d0fcc 100644 --- a/docs/mfc/using-the-mfc-source-files.md +++ b/docs/mfc/using-the-mfc-source-files.md @@ -4,6 +4,7 @@ title: "Using the MFC source files" ms.date: "08/19/2019" helpviewer_keywords: ["public members", "source files", "MFC, source files", "MFC source files", "comments, MFC", "private member access", "protected member access", "source files, MFC"] ms.assetid: 3230e8fb-3b69-4ddf-9538-365ac7ea5e72 +ms.topic: concept-article --- # Using the MFC source files diff --git a/docs/mfc/using-tooltips-in-a-cstatusbarctrl-object.md b/docs/mfc/using-tooltips-in-a-cstatusbarctrl-object.md index f98699e4cdb..2573a72f55c 100644 --- a/docs/mfc/using-tooltips-in-a-cstatusbarctrl-object.md +++ b/docs/mfc/using-tooltips-in-a-cstatusbarctrl-object.md @@ -4,6 +4,7 @@ title: "Using Tooltips in a CStatusBarCtrl Object" ms.date: "11/04/2016" helpviewer_keywords: ["tool tips [MFC], using in status bars", "status bars [MFC], tool tips", "CStatusBarCtrl class [MFC], tool tips"] ms.assetid: a77597a7-43ef-4b8f-87bc-a8ea1dc63dc3 +ms.topic: how-to --- # Using Tooltips in a CStatusBarCtrl Object diff --git a/docs/mfc/using-tree-controls.md b/docs/mfc/using-tree-controls.md index a0b87f8f551..9130eb9f032 100644 --- a/docs/mfc/using-tree-controls.md +++ b/docs/mfc/using-tree-controls.md @@ -4,6 +4,7 @@ title: "Using Tree Controls" ms.date: "11/04/2016" helpviewer_keywords: ["CTreeCtrl class [MFC], using", "tree controls [MFC], about tree controls"] ms.assetid: 4e92941a-e477-4fb1-b1ce-4abeafbef1c1 +ms.topic: concept-article --- # Using Tree Controls diff --git a/docs/mfc/using-views.md b/docs/mfc/using-views.md index be0abb6f982..2a3ce75afca 100644 --- a/docs/mfc/using-views.md +++ b/docs/mfc/using-views.md @@ -4,6 +4,7 @@ title: "Using Views" ms.date: "11/04/2016" helpviewer_keywords: ["interacting with users and role of view class [MFC]", "drawing [MFC], data", "rendering data", "view classes [MFC], role in managing user interaction", "CView class [MFC], view architecture", "MFC, views", "views [MFC], using", "painting data", "user input [MFC], interpreting through view class [MFC]", "view classes [MFC], role in displaying application data"] ms.assetid: dc3de6ad-5c64-4317-8f10-8bdcc38cdbd5 +ms.topic: concept-article --- # Using Views diff --git a/docs/mfc/using-your-old-toolbars.md b/docs/mfc/using-your-old-toolbars.md index 737b5f6d214..36e8fd1616e 100644 --- a/docs/mfc/using-your-old-toolbars.md +++ b/docs/mfc/using-your-old-toolbars.md @@ -5,10 +5,11 @@ ms.date: "11/04/2016" f1_keywords: ["COldToolBar"] helpviewer_keywords: ["toolbars [MFC], backward compatibility", "COldToolBar class [MFC]"] ms.assetid: 3543257c-8547-43f0-a66a-ee641dc1cf89 +ms.topic: concept-article --- # Using Your Old Toolbars -If you have used previous versions of Visual C++ to create customized toolbars, the new implementation of class [CToolBar](../mfc/reference/ctoolbar-class.md) could cause you problems. So that you don't have to give up your old toolbars to use the new functionality, the old implementation is still supported. +If you have used previous versions of Visual Studio to create customized toolbars, the new implementation of class [CToolBar](../mfc/reference/ctoolbar-class.md) could cause you problems. So that you don't have to give up your old toolbars to use the new functionality, the old implementation is still supported. The DOCKTOOL sample does not use the old-style toolbars, only the new-style toolbars. diff --git a/docs/mfc/walkthrough-adding-a-ctaskdialog-to-an-application.md b/docs/mfc/walkthrough-adding-a-ctaskdialog-to-an-application.md index 962e3caae73..1174ea2988d 100644 --- a/docs/mfc/walkthrough-adding-a-ctaskdialog-to-an-application.md +++ b/docs/mfc/walkthrough-adding-a-ctaskdialog-to-an-application.md @@ -1,18 +1,17 @@ --- -description: "Learn more about: Walkthrough: Adding a CTaskDialog to an Application" +description: "Learn how to add a CTaskDialog to a MFC application" title: "Walkthrough: Adding a CTaskDialog to an Application" -ms.date: "04/25/2019" +ms.date: "2/7/2025" helpviewer_keywords: ["CTaskDialog, adding", "walkthroughs [MFC], dialogs"] -ms.assetid: 3a62abb8-2d86-4bec-bdb8-5784d5f9a9f8 --- -# Walkthrough: Adding a CTaskDialog to an Application +# Walkthrough: Adding a CTaskDialog to an application -This walkthrough introduces the [CTaskDialog Class](../mfc/reference/ctaskdialog-class.md) and shows you how to add one to your application. +This walkthrough introduces the [`CTaskDialog` class](../mfc/reference/ctaskdialog-class.md) and shows how to add it to your application. -The `CTaskDialog` is a task dialog box that replaces the Windows message box in Windows Vista or later. The `CTaskDialog` improves the original message box and adds functionality. The Windows message box is still supported in Visual Studio. +The `CTaskDialog` is a task dialog box that replaces the Windows message box in Windows Vista or later. The `CTaskDialog` improves on the original message box and adds functionality. The Windows message box is still supported in Visual Studio. > [!NOTE] -> Versions of Windows earlier than Windows Vista do not support the `CTaskDialog`. You must program an alternative dialog box option if you want to show a message to a user who runs your application on an earlier version of Windows. You can use the static method [CTaskDialog::IsSupported](../mfc/reference/ctaskdialog-class.md#issupported) to determine at run time whether a user's computer can display a `CTaskDialog`. In addition, the `CTaskDialog` is only available when your application is built with the Unicode library. +> Versions of Windows earlier than Windows Vista don't support the `CTaskDialog`. You must program an alternative dialog box option if you want to show a message to a user who runs your application on an earlier version of Windows. You can use the static method [CTaskDialog::IsSupported](../mfc/reference/ctaskdialog-class.md#issupported) to determine at run time whether a user's computer can display a `CTaskDialog`. In addition, the `CTaskDialog` is only available when your application is built with the Unicode library. The `CTaskDialog` supports several optional elements to gather and display information. For example, a `CTaskDialog` can display command links, customized buttons, customized icons, and a footer. The `CTaskDialog` also has several methods that enable you to query the state of the task dialog box to determine what optional elements the user selected. @@ -21,37 +20,30 @@ The `CTaskDialog` supports several optional elements to gather and display infor You need the following components to complete this walkthrough: - Visual Studio 2010 or later - - Windows Vista or later -## Replacing a Windows Message Box with a CTaskDialog - -The following procedure demonstrates the most basic use of the `CTaskDialog`, which is to replace the Windows message box. This example also changes the icon associated with the task dialog box. Changing the icon makes the `CTaskDialog` appear same to the Windows message box. - -### To Replace a Windows Message Box with a CTaskDialog +## Replace the Windows message box with a CTaskDialog -1. Use the **MFC Application Wizard** to create an MFC application with all the default settings. See [Walkthrough: Using the New MFC Shell Controls](walkthrough-using-the-new-mfc-shell-controls.md) for instructions on how to open the wizard for your version of Visual Studio. +The following demonstrates the most basic use of the `CTaskDialog`, which is to replace the Windows message box. This example also changes the icon associated with the task dialog box. Changing the icon makes the `CTaskDialog` appear similar to the Windows message box. +1. Use the **MFC Application Wizard** to create a Microsoft Foundation Classes (MFC) application with all the default settings. See [Walkthrough: Using the New MFC Shell Controls](walkthrough-using-the-new-mfc-shell-controls.md) for instructions on how to open the wizard for your version of Visual Studio. 1. Call it *MyProject*. - -1. Use the **Solution Explorer** to open the file MyProject.cpp. - +1. Use the **Solution Explorer** to open `MyProject.cpp`. 1. Add `#include "afxtaskdialog.h"` after the list of includes. - 1. Find the method `CMyProjectApp::InitInstance`. Insert the following lines of code before the `return TRUE;` statement. This code creates the strings that we use in either the Windows message box or in the `CTaskDialog`. ```cpp CString message("My message to the user"); CString dialogTitle("My Task Dialog title"); CString emptyString; - ``` - -1. Add the following code after the code from step 4. This code guarantees that the user's computer supports the `CTaskDialog`. If the dialog isn't supported, the application displays a Windows message box instead. - ```cpp + // Check whether the user's computer supports `CTaskDialog`. + // If not, display a Windows message box instead. if (CTaskDialog::IsSupported()) { - + CTaskDialog taskDialog(message, emptyString, dialogTitle, TDCBF_OK_BUTTON); + taskDialog.SetMainIcon(TD_WARNING_ICON); // Set the icon to be the same as the Windows message box + taskDialog.DoModal(); } else { @@ -59,45 +51,18 @@ The following procedure demonstrates the most basic use of the `CTaskDialog`, wh } ``` -1. Insert the following code between the brackets after the **`if`** statement from step 5. This code creates the `CTaskDialog`. - - ```cpp - CTaskDialog taskDialog(message, emptyString, dialogTitle, TDCBF_OK_BUTTON); - ``` - -1. On the next line, add the following code. This code sets the warning icon. - - ```cpp - taskDialog.SetMainIcon(TD_WARNING_ICON); - ``` - -1. On the next line, add the following code. This code displays the task dialog box. - - ```cpp - taskDialog.DoModal(); - ``` - -You can avoid step 7 if you don't want the `CTaskDialog` to display the same icon as the Windows message box. If you avoid that step, the `CTaskDialog` has no icon when the application displays it. - Compile and run the application. The application displays the task dialog box after it starts. -## Adding Functionality to the CTaskDialog - -The following procedure shows you how to add functionality to the `CTaskDialog` that you created in the previous procedure. The example code shows you how to execute specific instructions based on the user's selections. - -### To Add Functionality to the CTaskDialog +## Add functionality to the CTaskDialog -1. Navigate to the **Resource View**. If you can't see the **Resource View**, you can open it from the **View** menu. +The following shows you how to add functionality to the `CTaskDialog` that you created in the previous procedure. The example code shows you how to execute specific instructions based on the user's selections. -1. Expand the **Resource View** until you can select the **String Table** folder. Expand it and double-click the **String Table** entry. - -1. Scroll to the bottom of the string table and add a new entry. Change the ID to `TEMP_LINE1`. Set the caption to **Command Line 1**. - -1. Add another new entry. Change the ID to `TEMP_LINE2`. Set the caption to **Command Line 2**. - -1. Navigate back to MyProject.cpp. - -1. After `CString emptyString;`, add the following code: +1. Navigate to the **Resource View** via **View** > **Other Windows** > **Resource View**. +1. Expand the **Resource View** to the **String Table** folder. Expand it and double-click **String Table**. +1. Scroll to the bottom of the string table and add a new entry. Change the ID to `TEMP_LINE1`. Set the caption to `Command Line 1`. +1. Add another new entry. Change the ID to `TEMP_LINE2`. Set the caption to `Command Line 2`. +1. Navigate back to `MyProject.cpp`. +1. In the `CMyProjectApp::InitInstance()` function, after `CString emptyString;` add the following code: ```cpp CString expandedLabel("Hide extra information"); @@ -109,67 +74,52 @@ The following procedure shows you how to add functionality to the `CTaskDialog` ```cpp taskDialog.SetMainInstruction(L"Warning"); - taskDialog.SetCommonButtons( - TDCBF_YES_BUTTON | TDCBF_NO_BUTTON | TDCBF_CANCEL_BUTTON); + taskDialog.SetCommonButtons(TDCBF_YES_BUTTON | TDCBF_NO_BUTTON | TDCBF_CANCEL_BUTTON); taskDialog.LoadCommandControls(TEMP_LINE1, TEMP_LINE2); - taskDialog.SetExpansionArea( - expansionInfo, collapsedLabel, expandedLabel); + taskDialog.SetExpansionArea(expansionInfo, collapsedLabel, expandedLabel); taskDialog.SetFooterText(L"This is a small footnote to the user"); taskDialog.SetVerificationCheckboxText(L"Remember your selection"); - ``` - -1. Add the following line of code that displays the task dialog box to the user and retrieves the user's selection: - - ```cpp INT_PTR result = taskDialog.DoModal(); - ``` - -1. Insert the following code after the call to `taskDialog.DoModal()`. This section of code processes the user's input: - ```cpp if (taskDialog.GetVerificationCheckboxState()) { - // PROCESS IF the user selects the verification checkbox + // Your code if the user selects the verification checkbox } switch (result) { - case TEMP_LINE1: - // PROCESS IF the first command line - break; - case TEMP_LINE2: - // PROCESS IF the second command line - break; - case IDYES: - // PROCESS IF the user clicks yes - break; - case IDNO: - // PROCESS IF the user clicks no - break; - case IDCANCEL: - // PROCESS IF the user clicks cancel - break; - default: - // This case should not be hit because closing - // the dialog box results in IDCANCEL - break; + case TEMP_LINE1: + // PROCESS IF the first command line + break; + case TEMP_LINE2: + // PROCESS IF the second command line + break; + case IDYES: + // PROCESS IF the user clicks yes + break; + case IDNO: + // PROCESS IF the user clicks no + break; + case IDCANCEL: + // PROCESS IF the user clicks cancel + break; + default: + // This case should not be hit because closing + // the dialog box results in IDCANCEL + break; } ``` -In the code in step 9, replace the comments that start with `PROCESS IF` with the code that you want to execute under the specified conditions. - Compile and run the application. The application displays the task dialog box that uses the new controls and additional information. ## Displaying a CTaskDialog Without Creating a CTaskDialog Object -The following procedure shows you how to display a `CTaskDialog` without first creating a `CTaskDialog` object. This example continues the previous procedures. +The following shows you how to display a `CTaskDialog` without first creating a `CTaskDialog` object. This example continues the previous procedures. ### To Display a CTaskDialog Without Creating a CTaskDialog Object -1. Open the MyProject.cpp file if it isn't already open. - -1. Navigate to the closing bracket for the `if (CTaskDialog::IsSupported())` statement. - +1. Open the `MyProject.cpp` file. +1. In the `CMyProjectApp::InitInstance()` function, navigate to the closing bracket for the `if (CTaskDialog::IsSupported())` statement. 1. Insert the following code immediately before the closing bracket of the **`if`** statement (before the **`else`** block): ```cpp @@ -180,12 +130,12 @@ The following procedure shows you how to display a `CTaskDialog` without first c TEMP_LINE2); ``` -Compile and run the application. The application displays two task dialog boxes. The first dialog box is from the **To Add Functionality to the CTaskDialog** procedure; the second dialog box is from the last procedure. +Compile and run the application. The application displays two task dialog boxes. The first dialog box is from the **To Add Functionality to the CTaskDialog** procedure; the second dialog box is from the previous procedure. These examples don't demonstrate all the available options for a `CTaskDialog`, but should help you get started. See [CTaskDialog Class](../mfc/reference/ctaskdialog-class.md) for a full description of the class. ## See also -[Dialog Boxes](../mfc/dialog-boxes.md)
-[CTaskDialog Class](../mfc/reference/ctaskdialog-class.md)
+[Dialog Boxes](../mfc/dialog-boxes.md)\ +[CTaskDialog Class](../mfc/reference/ctaskdialog-class.md)\ [CTaskDialog::CTaskDialog](../mfc/reference/ctaskdialog-class.md#ctaskdialog) diff --git a/docs/mfc/walkthrough-adding-a-d2d-object-to-an-mfc-project.md b/docs/mfc/walkthrough-adding-a-d2d-object-to-an-mfc-project.md index a1bcbd4b77d..2f3c6645ec7 100644 --- a/docs/mfc/walkthrough-adding-a-d2d-object-to-an-mfc-project.md +++ b/docs/mfc/walkthrough-adding-a-d2d-object-to-an-mfc-project.md @@ -7,7 +7,7 @@ ms.assetid: dda36c33-c231-4da6-a62f-72d69a12b6dd --- # Walkthrough: Adding a D2D Object to an MFC Project -This walkthrough teaches how to add a basic Direct2D (D2D) object to a Visual C++, Microsoft Foundation Class Library (MFC) project, and then build the project into an application that prints "Hello, World!" on a gradient background. +This walkthrough teaches how to add a basic Direct2D (D2D) object to a Visual Studio, Microsoft Foundation Class Library (MFC) project, and then build the project into an application that prints "Hello, World!" on a gradient background. The walkthrough shows how to accomplish these tasks: @@ -25,7 +25,7 @@ The walkthrough shows how to accomplish these tasks: ## Prerequisites -To complete this walkthrough, you must have Visual Studio installed with the **Desktop development with C++** workload and the optional **Visual C++ MFC for x86 and x64** component. +To complete this walkthrough, you must have Visual Studio installed with the **Desktop development with C++** workload and the optional **C++ MFC for x64/x86** component. ## To create an MFC application diff --git a/docs/mfc/walkthrough-adding-animation-to-an-mfc-project.md b/docs/mfc/walkthrough-adding-animation-to-an-mfc-project.md index 2ab962abddd..203b4313782 100644 --- a/docs/mfc/walkthrough-adding-animation-to-an-mfc-project.md +++ b/docs/mfc/walkthrough-adding-animation-to-an-mfc-project.md @@ -7,7 +7,7 @@ ms.assetid: 004f832c-9fd5-4f88-9ca9-ae65dececdc2 --- # Walkthrough: Adding Animation to an MFC Project -This walkthrough teaches how to add a basic animated object to a Visual C++, Microsoft Foundation Class Library (MFC) project. +This walkthrough teaches how to add a basic animated object to a Visual Studio, Microsoft Foundation Class Library (MFC) project. The walkthrough shows how to accomplish these tasks: diff --git a/docs/mfc/walkthrough-putting-controls-on-toolbars.md b/docs/mfc/walkthrough-putting-controls-on-toolbars.md index ca7b06348c4..2d3962ab8c2 100644 --- a/docs/mfc/walkthrough-putting-controls-on-toolbars.md +++ b/docs/mfc/walkthrough-putting-controls-on-toolbars.md @@ -1,13 +1,12 @@ --- -description: "Learn more about: Walkthrough: Putting Controls On Toolbars" title: "Walkthrough: Putting Controls On Toolbars" -ms.date: "04/25/2019" +description: "Learn more about: Walkthrough: Putting Controls On Toolbars" +ms.date: 04/25/2019 helpviewer_keywords: ["Customize dialog box, adding controls", "toolbars [MFC], adding controls"] -ms.assetid: 8fc94bdf-0da7-45d9-8bc4-52b7b1edf205 --- # Walkthrough: Putting Controls On Toolbars -This article describes how to add a toolbar button that contains a Windows control to a toolbar. In MFC, a toolbar button must be a [CMFCToolBarButton Class](../mfc/reference/cmfctoolbarbutton-class.md)-derived class, for example [CMFCToolBarComboBoxButton Class](../mfc/reference/cmfctoolbarcomboboxbutton-class.md), [CMFCToolBarEditBoxButton Class](../mfc/reference/cmfctoolbareditboxbutton-class.md), [CMFCDropDownToolbarButton Class](../mfc/reference/cmfcdropdowntoolbarbutton-class.md), or [CMFCToolBarMenuButton Class](../mfc/reference/cmfctoolbarmenubutton-class.md). +This article describes how to add a toolbar button that contains a Windows control to a toolbar. In MFC, a toolbar button must be a [`CMFCToolBarButton` Class](reference/cmfctoolbarbutton-class.md)-derived class, for example [`CMFCToolBarComboBoxButton` Class](reference/cmfctoolbarcomboboxbutton-class.md), [`CMFCToolBarEditBoxButton` Class](reference/cmfctoolbareditboxbutton-class.md), [`CMFCDropDownToolbarButton` Class](reference/cmfcdropdowntoolbarbutton-class.md), or [`CMFCToolBarMenuButton` Class](reference/cmfctoolbarmenubutton-class.md). ## Adding Controls to Toolbars @@ -21,7 +20,7 @@ To add a control to a toolbar, follow these steps: 1. Construct the button control by using a `CMFCToolbarButton`-derived class. - 1. Replace the dummy button with the new control by using [CMFCToolBar::ReplaceButton](../mfc/reference/cmfctoolbar-class.md#replacebutton). You can construct the button object on the stack, because `ReplaceButton` copies the button object and maintains the copy. + 1. Replace the dummy button with the new control by using [`CMFCToolBar::ReplaceButton`](reference/cmfctoolbar-class.md#replacebutton). You can construct the button object on the stack, because `ReplaceButton` copies the button object and maintains the copy. > [!NOTE] > If you enabled customization in your application, you may have to reset the toolbar by using the **Reset** button on the **Toolbars** tab of the **Customize** dialog box to see the updated control in your application after recompiling. The toolbar state is saved in the Windows registry, and the registry information is loaded and applied after the `ReplaceButton` method is executed during application startup. @@ -30,11 +29,11 @@ To add a control to a toolbar, follow these steps: The **Commands** tab of the **Customize** dialog box contains a list of commands that are available in the application. By default, the **Customize** dialog box processes the application menus and builds a list of standard toolbar buttons in each menu category. To keep the extended functionality that the toolbar controls provide, you must replace the standard toolbar button with the custom control in the **Customize** dialog box. -When you enable customization, you create the **Customize** dialog box in the customization handler `OnViewCustomize` by using the [CMFCToolBarsCustomizeDialog Class](../mfc/reference/cmfctoolbarscustomizedialog-class.md) class. Before you display the **Customize** dialog box by calling [CMFCToolBarsCustomizeDialog::Create](../mfc/reference/cmfctoolbarscustomizedialog-class.md#create), call [CMFCToolBarsCustomizeDialog::ReplaceButton](../mfc/reference/cmfctoolbarscustomizedialog-class.md#replacebutton) to replace the standard button with the new control. +When you enable customization, you create the **Customize** dialog box in the customization handler `OnViewCustomize` by using the [`CMFCToolBarsCustomizeDialog` Class](reference/cmfctoolbarscustomizedialog-class.md) class. Before you display the **Customize** dialog box by calling [`CMFCToolBarsCustomizeDialog::Create`](reference/cmfctoolbarscustomizedialog-class.md#create), call [`CMFCToolBarsCustomizeDialog::ReplaceButton`](reference/cmfctoolbarscustomizedialog-class.md#replacebutton) to replace the standard button with the new control. ## Example: Creating a Find Combo Box -This section describes how to create a **Find** combo box control that appears on a toolbar and contains recent-used search strings. The user can type a string in the control and then press the enter key to search a document, or press the escape key to return the focus to the main frame. This example assumes that the document is displayed in a [CEditView Class](../mfc/reference/ceditview-class.md)-derived view. +This section describes how to create a **Find** combo box control that appears on a toolbar and contains recent-used search strings. The user can type a string in the control and then press the enter key to search a document, or press the escape key to return the focus to the main frame. This example assumes that the document is displayed in a [`CEditView` Class](reference/ceditview-class.md)-derived view. ### Creating the Find Control @@ -46,32 +45,32 @@ First, create the **Find** combo box control: 1. Create a new menu item with the `ID_EDIT_FIND` command ID. - 1. Add a new string "Find the text\nFind" to the string table and assign it an `ID_EDIT_FIND_COMBO` command ID. This ID will be used as the command ID of the **Find** combo box button. + 1. Add a new string `"Find the text\nFind"` to the string table and assign it an `ID_EDIT_FIND_COMBO` command ID. This ID will be used as the command ID of the **Find** combo box button. > [!NOTE] - > Because `ID_EDIT_FIND` is a standard command that is processed by `CEditView`, you are not required to implement a special handler for this command. However, you must implement a handler for the new command `ID_EDIT_FIND_COMBO`. + > Because `ID_EDIT_FIND` is a standard command that is processed by `CEditView`, you are not required to implement a special handler for this command. However, you must implement a handler for the new command `ID_EDIT_FIND_COMBO`. -1. Create a new class, `CFindComboBox`, derived from [CComboBox Class](../mfc/reference/ccombobox-class.md). +1. Create a new class, `CFindComboBox`, derived from [`CComboBox` Class](reference/ccombobox-class.md). -1. In the `CFindComboBox` class, override the `PreTranslateMessage` virtual method. This method will enable the combo box to process the [WM_KEYDOWN](/windows/win32/inputdev/wm-keydown) message. If the user hits the escape key (`VK_ESCAPE`), return the focus to the main frame window. If the user hits the Enter key (`VK_ENTER`), post to the main frame window a `WM_COMMAND` message that contains the `ID_EDIT_FIND_COMBO` command ID. +1. In the `CFindComboBox` class, override the `PreTranslateMessage` virtual method. This method will enable the combo box to process the [`WM_KEYDOWN`](/windows/win32/inputdev/wm-keydown) message. If the user hits the escape key (`VK_ESCAPE`), return the focus to the main frame window. If the user hits the Enter key (`VK_ENTER`), post to the main frame window a `WM_COMMAND` message that contains the `ID_EDIT_FIND_COMBO` command ID. -1. Create a class for the **Find** combo box button, derived from [CMFCToolBarComboBoxButton Class](../mfc/reference/cmfctoolbarcomboboxbutton-class.md). In this example, it's named `CFindComboButton`. +1. Create a class for the **Find** combo box button, derived from [`CMFCToolBarComboBoxButton` Class](reference/cmfctoolbarcomboboxbutton-class.md). In this example, it's named `CFindComboButton`. 1. The constructor of `CMFCToolbarComboBoxButton` takes three parameters: the command ID of the button, the button image index, and the style of the combo box. Set these parameters as follows: 1. Pass the `ID_EDIT_FIND_COMBO` as the command ID. - 1. Use [CCommandManager::GetCmdImage](reference/internal-classes.md) with `ID_EDIT_FIND` to get the image index. + 1. Use [`CCommandManager::GetCmdImage`](reference/internal-classes.md) with `ID_EDIT_FIND` to get the image index. - 1. For a list of available combo box styles, see [Combo-Box Styles](../mfc/reference/styles-used-by-mfc.md#combo-box-styles). + 1. For a list of available combo box styles, see [Combo-Box Styles](reference/styles-used-by-mfc.md#combo-box-styles). 1. In the `CFindComboButton` class, override the `CMFCToolbarComboBoxButton::CreateCombo` method. Here you should create the `CFindComboButton` object and return a pointer to it. -1. Use the [IMPLEMENT_SERIAL](../mfc/reference/run-time-object-model-services.md#implement_serial) macro to make the combo button persistent. The workspace manager automatically loads and saves the button's state in the Windows registry. +1. Use the [`IMPLEMENT_SERIAL`](reference/run-time-object-model-services.md#implement_serial) macro to make the combo button persistent. The workspace manager automatically loads and saves the button's state in the Windows registry. -1. Implement the `ID_EDIT_FIND_COMBO` handler in your document view. Use [CMFCToolBar::GetCommandButtons](../mfc/reference/cmfctoolbar-class.md#getcommandbuttons) with `ID_EDIT_FIND_COMBO` to retrieve all **Find** combo box buttons. There can be several copies of a button with the same command ID because of customization. +1. Implement the `ID_EDIT_FIND_COMBO` handler in your document view. Use [`CMFCToolBar::GetCommandButtons`](reference/cmfctoolbar-class.md#getcommandbuttons) with `ID_EDIT_FIND_COMBO` to retrieve all **Find** combo box buttons. There can be several copies of a button with the same command ID because of customization. -1. In the `ID_EDIT_FIND` message handler `OnFind`, use [CMFCToolBar::IsLastCommandFromButton](../mfc/reference/cmfctoolbar-class.md#islastcommandfrombutton) to determine whether the find command was sent from the **Find** combo box button. If so, find the text and add the search string to the combo box. +1. In the `ID_EDIT_FIND` message handler `OnFind`, use [`CMFCToolBar::IsLastCommandFromButton`](reference/cmfctoolbar-class.md#islastcommandfrombutton) to determine whether the find command was sent from the **Find** combo box button. If so, find the text and add the search string to the combo box. ### Adding the Find Control to the Main Toolbar @@ -82,20 +81,20 @@ To add the combo box button to the toolbar, follow these steps: > [!NOTE] > The framework sends this message to the main frame window when a toolbar is initialized during application startup, or when a toolbar is reset during customization. In either case, you must replace the standard toolbar button with the custom **Find** combo box button. -1. In the `AFX_WM_RESETTOOLBAR` handler, examine the toolbar ID, that is, the *WPARAM* of the AFX_WM_RESETTOOLBAR message. If the toolbar ID is equal to that of the toolbar that contains the **Find** combo box button, call [CMFCToolBar::ReplaceButton](../mfc/reference/cmfctoolbar-class.md#replacebutton) to replace the **Find** button (that is, the button with the command ID `ID_EDIT_FIND)` with a `CFindComboButton` object. +1. In the `AFX_WM_RESETTOOLBAR` handler, examine the toolbar ID, that is, the *`WPARAM`* of the `AFX_WM_RESETTOOLBAR` message. If the toolbar ID is equal to that of the toolbar that contains the **Find** combo box button, call [`CMFCToolBar::ReplaceButton`](reference/cmfctoolbar-class.md#replacebutton) to replace the **Find** button (that is, the button with the command ID `ID_EDIT_FIND`) with a `CFindComboButton` object. > [!NOTE] > You can construct a `CFindComboBox` object on the stack, because `ReplaceButton` copies the button object and maintains the copy. ### Adding the Find Control to the Customize Dialog Box -In the customization handler `OnViewCustomize`, call [CMFCToolBarsCustomizeDialog::ReplaceButton](../mfc/reference/cmfctoolbarscustomizedialog-class.md#replacebutton) to replace the **Find** button (that is, the button with the command ID `ID_EDIT_FIND`) with a `CFindComboButton` object. +In the customization handler `OnViewCustomize`, call [`CMFCToolBarsCustomizeDialog::ReplaceButton`](reference/cmfctoolbarscustomizedialog-class.md#replacebutton) to replace the **Find** button (that is, the button with the command ID `ID_EDIT_FIND`) with a `CFindComboButton` object. ## See also -[Hierarchy Chart](../mfc/hierarchy-chart.md)
-[Classes](../mfc/reference/mfc-classes.md)
-[CMFCToolBar Class](../mfc/reference/cmfctoolbar-class.md)
-[CMFCToolBarButton Class](../mfc/reference/cmfctoolbarbutton-class.md)
-[CMFCToolBarComboBoxButton Class](../mfc/reference/cmfctoolbarcomboboxbutton-class.md)
-[CMFCToolBarsCustomizeDialog Class](../mfc/reference/cmfctoolbarscustomizedialog-class.md) +[Hierarchy Chart](hierarchy-chart.md)\ +[Classes](reference/mfc-classes.md)\ +[`CMFCToolBar` Class](reference/cmfctoolbar-class.md)\ +[`CMFCToolBarButton` Class](reference/cmfctoolbarbutton-class.md)\ +[`CMFCToolBarComboBoxButton` Class](reference/cmfctoolbarcomboboxbutton-class.md)\ +[`CMFCToolBarsCustomizeDialog` Class](reference/cmfctoolbarscustomizedialog-class.md) diff --git a/docs/mfc/what-is-a-carchive-object.md b/docs/mfc/what-is-a-carchive-object.md index 299602c9df4..69b0bdb75a6 100644 --- a/docs/mfc/what-is-a-carchive-object.md +++ b/docs/mfc/what-is-a-carchive-object.md @@ -5,6 +5,7 @@ ms.date: "11/04/2016" helpviewer_keywords: ["archive objects [MFC]", "archives [MFC], for serialization", "buffers, serializable objects", "CArchive class [MFC], about CArchive class [MFC]", "buffering, serializable objects"] ms.assetid: 843f1825-288d-4d89-a1fa-70e1f92d9b8b ms.custom: intro-overview +ms.topic: concept-article --- # What Is a CArchive Object diff --git a/docs/mfc/windows-sockets-example-of-sockets-using-archives.md b/docs/mfc/windows-sockets-example-of-sockets-using-archives.md index bd76e3b6f35..89e332528ba 100644 --- a/docs/mfc/windows-sockets-example-of-sockets-using-archives.md +++ b/docs/mfc/windows-sockets-example-of-sockets-using-archives.md @@ -1,9 +1,8 @@ --- -description: "Learn more about: Windows Sockets: Example of Sockets Using Archives" title: "Windows Sockets: Example of Sockets Using Archives" -ms.date: "11/04/2016" +description: "Learn more about: Windows Sockets: Example of Sockets Using Archives" +ms.date: 11/04/2016 helpviewer_keywords: ["sockets [MFC], with archives", "examples [MFC], Windows Sockets", "Windows Sockets [MFC], with archives"] -ms.assetid: 2e3c9bb2-7e7b-4f28-8dc5-6cb7a484edac --- # Windows Sockets: Example of Sockets Using Archives @@ -50,6 +49,6 @@ For more information, see Windows Sockets Specification: **htonl**, **htons**, * [Windows Sockets in MFC](../mfc/windows-sockets-in-mfc.md)
[CArchive::IsStoring](../mfc/reference/carchive-class.md#isstoring)
[CArchive::operator <<](../mfc/reference/carchive-class.md#operator_lt_lt)
-[CArchive::operator >>](../mfc/reference/carchive-class.md#operator_lt_lt)
+[CArchive::operator >>](../mfc/reference/carchive-class.md#operator_gt_gt)
[CArchive::Flush](../mfc/reference/carchive-class.md#flush)
[CObject::Serialize](../mfc/reference/cobject-class.md#serialize) diff --git a/docs/mfc/windows-sockets-in-mfc.md b/docs/mfc/windows-sockets-in-mfc.md index c75929505b3..ade1e931319 100644 --- a/docs/mfc/windows-sockets-in-mfc.md +++ b/docs/mfc/windows-sockets-in-mfc.md @@ -30,7 +30,7 @@ Creating and using `CSocket` and `CAsyncSocket` objects is described in [Windows ## Windows Sockets DLLs -The Microsoft Windows operating systems supply the Windows Sockets dynamic-link libraries (DLL). Visual C++ supplies the appropriate header files and libraries and the Windows Sockets specification. +The Microsoft Windows operating systems supply the Windows Sockets dynamic-link libraries (DLL). Visual Studio supplies the appropriate header files and libraries and the Windows Sockets specification. For more information about Windows Sockets, see: diff --git a/docs/mfc/windows-sockets-using-class-casyncsocket.md b/docs/mfc/windows-sockets-using-class-casyncsocket.md index b0a56716364..4b93d33ecb9 100644 --- a/docs/mfc/windows-sockets-using-class-casyncsocket.md +++ b/docs/mfc/windows-sockets-using-class-casyncsocket.md @@ -1,16 +1,16 @@ --- -description: "Learn more about: Windows Sockets: Using Class CAsyncSocket" title: "Windows Sockets: Using Class CAsyncSocket" +description: "Learn more about: Windows Sockets: Using Class CAsyncSocket" ms.date: "6/8/2021" helpviewer_keywords: ["CAsyncSocket class [MFC], programming model", "Windows Sockets [MFC], asynchronous", "sockets [MFC], converting between Unicode and MBCS strings", "SOCKET handle", "sockets [MFC], asynchronous operation", "Windows Sockets [MFC], converting Unicode and MBCS strings"] --- # Windows Sockets: Using Class `CAsyncSocket` -This article explains how to use class [`CAsyncSocket`](../mfc/reference/casyncsocket-class.md). This class encapsulates the Windows Sockets API at a very low level. `CAsyncSocket` is for use by programmers who know network communications in detail but want the convenience of callbacks for notification of network events. Based on this assumption, this article provides only basic instruction. You should probably consider using `CAsyncSocket` if you want Windows Sockets' ease of dealing with multiple network protocols in an MFC application but don't want to sacrifice flexibility. You might also feel that you can get better efficiency by programming the communications more directly yourself than you could using the more general alternative model of class `CSocket`. +This article explains how to use class [`CAsyncSocket`](reference/casyncsocket-class.md). This class encapsulates the Windows Sockets API at a very low level. `CAsyncSocket` is for use by programmers who know network communications in detail but want the convenience of callbacks for notification of network events. Based on this assumption, this article provides only basic instruction. You should probably consider using `CAsyncSocket` if you want Windows Sockets' ease of dealing with multiple network protocols in an MFC application but don't want to sacrifice flexibility. You might also feel that you can get better efficiency by programming the communications more directly yourself than you could using the more general alternative model of class `CSocket`. -`CAsyncSocket` is documented in the *MFC Reference*. Visual C++ also supplies the Windows Sockets specification, located in the Windows SDK. The details are left to you. Visual C++ doesn't supply a sample application for `CAsyncSocket`. +`CAsyncSocket` is documented in the *MFC Reference*. Visual Studio also supplies the Windows Sockets specification, located in the Windows SDK. The details are left to you. Visual Studio doesn't supply a sample application for `CAsyncSocket`. -If you aren't highly knowledgeable about network communications and want a simple solution, use class [`CSocket`](../mfc/reference/csocket-class.md) with a `CArchive` object. See [Windows Sockets: Using Sockets with Archives](../mfc/windows-sockets-using-sockets-with-archives.md) for more information. +If you aren't highly knowledgeable about network communications and want a simple solution, use class [`CSocket`](reference/csocket-class.md) with a `CArchive` object. See [Windows Sockets: Using Sockets with Archives](windows-sockets-using-sockets-with-archives.md) for more information. This article covers: @@ -22,19 +22,19 @@ This article covers: #### To use `CAsyncSocket` -1. Construct a [`CAsyncSocket`](../mfc/reference/casyncsocket-class.md) object and use the object to create the underlying **`SOCKET`** handle. +1. Construct a [`CAsyncSocket`](reference/casyncsocket-class.md) object and use the object to create the underlying **`SOCKET`** handle. Creation of a socket follows the MFC pattern of two-stage construction. For example: - [!code-cpp[NVC_MFCSimpleSocket#3](../mfc/codesnippet/cpp/windows-sockets-using-class-casyncsocket_1.cpp)] + [!code-cpp[NVC_MFCSimpleSocket#3](codesnippet/cpp/windows-sockets-using-class-casyncsocket_1.cpp)] -or- - [!code-cpp[NVC_MFCSimpleSocket#4](../mfc/codesnippet/cpp/windows-sockets-using-class-casyncsocket_2.cpp)] + [!code-cpp[NVC_MFCSimpleSocket#4](codesnippet/cpp/windows-sockets-using-class-casyncsocket_2.cpp)] - The first constructor above creates a `CAsyncSocket` object on the stack. The second constructor creates a `CAsyncSocket` on the heap. The first [`Create`](../mfc/reference/casyncsocket-class.md#create) call above uses the default parameters to create a stream socket. The second `Create` call creates a datagram socket with a specified port and address. (You can use either `Create` version with either construction method.) + The first constructor above creates a `CAsyncSocket` object on the stack. The second constructor creates a `CAsyncSocket` on the heap. The first [`Create`](reference/casyncsocket-class.md#create) call above uses the default parameters to create a stream socket. The second `Create` call creates a datagram socket with a specified port and address. (You can use either `Create` version with either construction method.) The parameters to `Create` are: @@ -48,34 +48,34 @@ This article covers: This is your Internet Protocol (IP) address on the network. You'll probably always rely on the default value for this parameter. - The terms "port" and "socket address" are explained in [Windows Sockets: Ports and Socket Addresses](../mfc/windows-sockets-ports-and-socket-addresses.md). + The terms "port" and "socket address" are explained in [Windows Sockets: Ports and Socket Addresses](windows-sockets-ports-and-socket-addresses.md). -1. If the socket is a client, connect the socket object to a server socket, using [`CAsyncSocket::Connect`](../mfc/reference/casyncsocket-class.md#connect). +1. If the socket is a client, connect the socket object to a server socket, using [`CAsyncSocket::Connect`](reference/casyncsocket-class.md#connect). -or- - If the socket is a server, set the socket to begin listening (with [`CAsyncSocket::Listen`](../mfc/reference/casyncsocket-class.md#listen)) for connect attempts from a client. Upon receiving a connection request, accept it with [`CAsyncSocket::Accept`](../mfc/reference/casyncsocket-class.md#accept). + If the socket is a server, set the socket to begin listening (with [`CAsyncSocket::Listen`](reference/casyncsocket-class.md#listen)) for connect attempts from a client. Upon receiving a connection request, accept it with [`CAsyncSocket::Accept`](reference/casyncsocket-class.md#accept). After accepting a connection, you can do tasks like validating passwords. > [!NOTE] - > The `Accept` member function takes a reference to a new, empty `CSocket` object as its parameter. You must construct this object before you call `Accept`. If this socket object goes out of scope, the connection closes. Don't call `Create` for this new socket object. For an example, see the article [Windows Sockets: Sequence of Operations](../mfc/windows-sockets-sequence-of-operations.md). + > The `Accept` member function takes a reference to a new, empty `CSocket` object as its parameter. You must construct this object before you call `Accept`. If this socket object goes out of scope, the connection closes. Don't call `Create` for this new socket object. For an example, see the article [Windows Sockets: Sequence of Operations](windows-sockets-sequence-of-operations.md). 1. Carry out communications with other sockets by calling the `CAsyncSocket` object's member functions that encapsulate the Windows Sockets API functions. - See the Windows Sockets specification and class [`CAsyncSocket`](../mfc/reference/casyncsocket-class.md) in the *MFC Reference*. + See the Windows Sockets specification and class [`CAsyncSocket`](reference/casyncsocket-class.md) in the *MFC Reference*. 1. Destroy the `CAsyncSocket` object. If you created the socket object on the stack, its destructor is called when the containing function goes out of scope. If you created the socket object on the heap, using the **`new`** operator, you're responsible for using the **`delete`** operator to destroy the object. - The destructor calls the object's [`Close`](../mfc/reference/casyncsocket-class.md#close) member function before destroying the object. + The destructor calls the object's [`Close`](reference/casyncsocket-class.md#close) member function before destroying the object. -For an example of this sequence in code (actually for a `CSocket` object), see [Windows Sockets: Sequence of Operations](../mfc/windows-sockets-sequence-of-operations.md). +For an example of this sequence in code (actually for a `CSocket` object), see [Windows Sockets: Sequence of Operations](windows-sockets-sequence-of-operations.md). ## Your responsibilities with `CAsyncSocket` -When you create an object of class [`CAsyncSocket`](../mfc/reference/casyncsocket-class.md), the object encapsulates a Windows **`SOCKET`** handle and supplies operations on that handle. When you use `CAsyncSocket`, you must deal with all the issues you might face if using the API directly. For example: +When you create an object of class [`CAsyncSocket`](reference/casyncsocket-class.md), the object encapsulates a Windows **`SOCKET`** handle and supplies operations on that handle. When you use `CAsyncSocket`, you must deal with all the issues you might face if using the API directly. For example: - "Blocking" scenarios. @@ -83,16 +83,16 @@ When you create an object of class [`CAsyncSocket`](../mfc/reference/casyncsocke - Converting between Unicode and multibyte character set (MBCS) strings. -For definitions of these terms and additional information, see [Windows Sockets: Blocking](../mfc/windows-sockets-blocking.md), [Windows Sockets: Byte Ordering](../mfc/windows-sockets-byte-ordering.md), [Windows Sockets: Converting Strings](../mfc/windows-sockets-converting-strings.md). +For definitions of these terms and additional information, see [Windows Sockets: Blocking](windows-sockets-blocking.md), [Windows Sockets: Byte Ordering](windows-sockets-byte-ordering.md), [Windows Sockets: Converting Strings](windows-sockets-converting-strings.md). Despite these issues, class `CAsyncSocket` may be the right choice for you if your application requires all the flexibility and control you can get. If not, consider using class `CSocket` instead. `CSocket` hides many details from you: it pumps Windows messages during blocking calls and gives you access to `CArchive`, which manages byte order differences and string conversion for you. For more information, see: -- [Windows Sockets: Background](../mfc/windows-sockets-background.md)\ -- [Windows Sockets: Stream Sockets](../mfc/windows-sockets-stream-sockets.md)\ -- [Windows Sockets: Datagram Sockets](../mfc/windows-sockets-datagram-sockets.md) +- [Windows Sockets: Background](windows-sockets-background.md) +- [Windows Sockets: Stream Sockets](windows-sockets-stream-sockets.md) +- [Windows Sockets: Datagram Sockets](windows-sockets-datagram-sockets.md) ## See also -[Windows Sockets in MFC](../mfc/windows-sockets-in-mfc.md) +[Windows Sockets in MFC](windows-sockets-in-mfc.md) diff --git a/docs/mfc/wizards-and-the-resource-editors.md b/docs/mfc/wizards-and-the-resource-editors.md index daf62848239..5646150d063 100644 --- a/docs/mfc/wizards-and-the-resource-editors.md +++ b/docs/mfc/wizards-and-the-resource-editors.md @@ -7,11 +7,11 @@ ms.assetid: f5dd4d13-9dc1-4a49-b6bf-5b3cb45fa8ba --- # Wizards and the Resource Editors -Visual C++ includes several wizards for use in MFC programming, along with many integrated resource editors. For ActiveX controls programming, the [ActiveX Control Wizard](../mfc/reference/mfc-activex-control-wizard.md) serves a purpose much like that of the MFC Application Wizard. While you can write MFC applications without most of these tools, the tools greatly simplify and speed your work. +Visual Studio includes several wizards for use in MFC programming, along with many integrated resource editors. For ActiveX controls programming, the [ActiveX Control Wizard](../mfc/reference/mfc-activex-control-wizard.md) serves a purpose much like that of the MFC Application Wizard. While you can write MFC applications without most of these tools, the tools greatly simplify and speed your work. ## Use the MFC Application Wizard to Create an MFC Application -Use the [MFC Application Wizard](../mfc/reference/mfc-application-wizard.md) to create an MFC project in Visual C++, which can include OLE and database support. Files in the project contain your application, document, view, and frame-window classes; standard resources, including menus and an optional toolbar; other required Windows files; and optional .rtf files containing standard Windows Help topics that you can revise and augment to create your program's help file. +Use the [MFC Application Wizard](../mfc/reference/mfc-application-wizard.md) to create an MFC project in Visual Studio, which can include OLE and database support. Files in the project contain your application, document, view, and frame-window classes; standard resources, including menus and an optional toolbar; other required Windows files; and optional .rtf files containing standard Windows Help topics that you can revise and augment to create your program's help file. ## Use Class View to Manage Classes and Windows Messages @@ -30,11 +30,11 @@ The [Class Wizard](reference/mfc-class-wizard.md) will create empty message-hand ## Use the Resource Editors to Create and Edit Resources -Use the Visual C++ [resource editors](../windows/resource-editors.md) to create and edit menus, dialog boxes, custom controls, accelerator keys, bitmaps, icons, cursors, strings, and version resources. As of Visual C++ version 4.0, a toolbar editor makes creating toolbars much easier. +Use the Visual Studio [resource editors](../windows/resource-editors.md) to create and edit menus, dialog boxes, custom controls, accelerator keys, bitmaps, icons, cursors, strings, and version resources. As of Visual Studio version 4.0, a toolbar editor makes creating toolbars much easier. To help you even more, the Microsoft Foundation Class Library provides a file called COMMON.RES, which contains "clip art" resources that you can copy from COMMON.RES and paste into your own resource file. COMMON.RES includes toolbar buttons, common cursors, icons, and more. You can use, modify, and redistribute these resources in your application. For more information about COMMON.RES, see the [Clipart sample](../overview/visual-cpp-samples.md). -The MFC Application Wizard, the Visual C++ wizards, resource editors, and the MFC framework do a lot of work for you and make managing your code much easier. The bulk of your application-specific code is in your document and view classes. +The MFC Application Wizard, the Visual Studio wizards, resource editors, and the MFC framework do a lot of work for you and make managing your code much easier. The bulk of your application-specific code is in your document and view classes. ## See also diff --git a/docs/mfc/working-with-a-header-control.md b/docs/mfc/working-with-a-header-control.md index 920a1c5ff09..1cd98c32b13 100644 --- a/docs/mfc/working-with-a-header-control.md +++ b/docs/mfc/working-with-a-header-control.md @@ -4,6 +4,7 @@ title: "Working with a Header Control" ms.date: "11/04/2016" helpviewer_keywords: ["header controls [MFC], working with", "header controls"] ms.assetid: af3afb5c-bf97-451b-8fee-3adcb8257210 +ms.topic: concept-article --- # Working with a Header Control diff --git a/docs/mfc/working-with-a-tab-control.md b/docs/mfc/working-with-a-tab-control.md index 6894322f677..e730f954acd 100644 --- a/docs/mfc/working-with-a-tab-control.md +++ b/docs/mfc/working-with-a-tab-control.md @@ -4,6 +4,7 @@ title: "Working with a Tab Control" ms.date: "11/04/2016" helpviewer_keywords: ["CTabCtrl class [MFC], using", "tab controls [MFC], working with", "tab controls [MFC], using"] ms.assetid: 819488e3-4944-44b7-9483-195edb8e0aed +ms.topic: concept-article --- # Working with a Tab Control diff --git a/docs/mfc/working-with-the-toolbar-control.md b/docs/mfc/working-with-the-toolbar-control.md index f0660e38d6d..486ff79f32e 100644 --- a/docs/mfc/working-with-the-toolbar-control.md +++ b/docs/mfc/working-with-the-toolbar-control.md @@ -4,6 +4,7 @@ title: "Working with the Toolbar Control" ms.date: "11/04/2016" helpviewer_keywords: ["GetToolBarCtrl method [MFC]", "toolbars [MFC], accessing common control", "CToolBarCtrl class [MFC], accessing toolbar", "toolbar controls [MFC], accessing"] ms.assetid: b19409d5-3831-42c7-80ae-195c49dc9085 +ms.topic: how-to --- # Working with the Toolbar Control diff --git a/docs/mfc/working-with-window-objects.md b/docs/mfc/working-with-window-objects.md index 3624187334e..55547aac560 100644 --- a/docs/mfc/working-with-window-objects.md +++ b/docs/mfc/working-with-window-objects.md @@ -4,6 +4,7 @@ title: "Working with Window Objects" ms.date: "11/04/2016" helpviewer_keywords: ["child windows [MFC], working with", "window objects [MFC], working with"] ms.assetid: f73aa254-90e3-46a9-8e9b-d78b7054a331 +ms.topic: concept-article --- # Working with Window Objects diff --git a/docs/mfc/writing-an-internet-client-application-using-mfc-wininet-classes.md b/docs/mfc/writing-an-internet-client-application-using-mfc-wininet-classes.md index ce28434c991..89176ac68ec 100644 --- a/docs/mfc/writing-an-internet-client-application-using-mfc-wininet-classes.md +++ b/docs/mfc/writing-an-internet-client-application-using-mfc-wininet-classes.md @@ -4,6 +4,7 @@ title: "Writing an Internet Client Application Using MFC WinInet Classes" ms.date: "11/04/2016" helpviewer_keywords: ["Internet client applications [MFC]", "WinInet classes [MFC], programming", "Internet client applications [MFC], writing", "Internet applications [MFC], WinInet", "Internet applications [MFC], client applications", "MFC, Internet applications"] ms.assetid: a2c4a40c-a94e-4b3e-9dbf-f8a8dc8e5428 +ms.topic: concept-article --- # Writing an Internet Client Application Using MFC WinInet Classes diff --git a/docs/mfc/writing-mfc-applications.md b/docs/mfc/writing-mfc-applications.md index 8858085fae1..abb166fc975 100644 --- a/docs/mfc/writing-mfc-applications.md +++ b/docs/mfc/writing-mfc-applications.md @@ -4,6 +4,7 @@ title: "Writing MFC Applications" ms.date: "09/12/2018" helpviewer_keywords: ["Internet applications [MFC], MFC", "MFC, Internet applications", "application wizards [MFC], Internet applications", "MFC, application development"] ms.assetid: 6a8d8a03-abfa-4976-86c2-c5773a4b7179 +ms.topic: concept-article --- # Writing MFC Applications diff --git a/docs/overview/compiler-versions.md b/docs/overview/compiler-versions.md index e35858c1467..f1502c60088 100644 --- a/docs/overview/compiler-versions.md +++ b/docs/overview/compiler-versions.md @@ -1,14 +1,14 @@ --- -description: "Learn more about Microsoft Visual C++ compiler versioning." -title: "Microsoft Visual C++ compiler versioning (Visual C++)" -ms.date: 02/13/2024 +description: "Learn more about Microsoft C++ compiler versioning." +title: "Microsoft C++ (MSVC) compiler versioning" +ms.date: 02/12/2025 ms.service: "visual-cpp" ms.subservice: "tools" helpviewer_keywords: ["Visual C++, platforms supported", "platforms [C++]"] --- -# Microsoft Visual C++ compiler versioning +# Microsoft C++ (MSVC) compiler versioning -The Microsoft Visual C++ compiler version consists of four fields: +The Microsoft C++ (MSVC) compiler version consists of four fields: M - major version (two digits)\ N - minor version (two digits)\ @@ -33,9 +33,9 @@ The macros reflect these values like this: - `_MSC_BUILD` (the revision) is 0. >[!Note] ->Visual Studio 2019 16.8 and 16.9 share the same major and minor versions, and so have the same value for `_MSC_VER`. As do Visual Studio 2019 16.10 and 16.11. To distinguish them, use `_MSC_FULL_VER` as described in [Service releases starting with Visual Studio 2017](#service-releases-starting-with-visual-studio-2017). +>Visual Studio 2019 versions 16.8 and 16.9 share the same major and minor versions, and so have the same value for `_MSC_VER`. As do Visual Studio 2019 versions 16.10 and 16.11. To distinguish them, use `_MSC_FULL_VER` as described in [Service releases starting with Visual Studio 2017](#service-releases-starting-with-visual-studio-2017). -## A brief history of Visual C++ compiler versioning +## A brief history of Microsoft C++ compiler versioning ### Visual Studio 6.0 through Visual Studio 2015 (14.0) @@ -45,20 +45,26 @@ The macros reflect these values like this: >[!Note] > Visual Studio .NET 2003 was considered a minor release. -### Visual Studio 2017 and later +### Visual Studio 2017 to Visual Studio 2022 - For major releases, the minor version increases by 10. - For minor releases, the minor version increases by 1 starting with Visual Studio 2017 version 15.3. +### Visual Studio 2026 and later + +- The compiler minor version is no longer incremented in relation to Visual Studio version updates. +- The minor version increments by 1 with each new MSVC release. +- Not every new Visual Studio version will ship a new MSVC compiler version. + ### Service releases starting with Visual Studio 2017 -Servicing releases can be distinguished by `_MSC_FULL_VER`. The build field (the BBBBB in the MMNNBBBBB version number) typically increases by 1. +Servicing releases are distinguished by `_MSC_FULL_VER`. The build field (the BBBBB in the MMNNBBBBB version number) typically increases by 1. -For example, two cases where `_MSC_FULL_VER` is useful is to distinguish Visual Studio 2019 16.8 from 16.9, and Visual Studio 2019 16.10 from 16.11. That's because those versions share the same major and minor versions, and so have the same value for `_MSC_VER`. +For example, two cases where `_MSC_FULL_VER` is useful is to distinguish Visual Studio 2019 version 16.8 from 16.9, and Visual Studio 2019 version 16.10 from 16.11. That's because those versions share the same major and minor versions, and so have the same value for `_MSC_VER`. To distinguish these versions, use `_MSC_FULL_VER`.\ -The minimum value of `_MSC_FULL_VER` for Visual Studio 2019 16.8 is 192829333.\ -The minimum value of `_MSC_FULL_VER` for Visual Studio 2019 16.9 is 192829910. +The minimum value of `_MSC_FULL_VER` for Visual Studio 2019 version 16.8 is 192829333.\ +The minimum value of `_MSC_FULL_VER` for Visual Studio 2019 version 16.9 is 192829910. ## Version macros @@ -71,59 +77,63 @@ R - revision version **[`_MSC_VER`](../preprocessor/predefined-macros.md)** distinguishes between major and minor releases. It has the form: MMNN. -**[`_MSC_FULL_VER`](../preprocessor/predefined-macros.md)** represents the major, minor, and build version of the compiler. It has the form: MMNNBBBBB. Use it to distinguish between different versions of the compiler, including servicing releases. See [Service releases starting with Visual Studio 2017](#service-releases-starting-with-visual-studio-2017) for more information about Visual Studio 2019 16.8, 16.9, 16.10 and 16.11. +**[`_MSC_FULL_VER`](../preprocessor/predefined-macros.md)** represents the major, minor, and build version of the compiler. It has the form: MMNNBBBBB. Use it to distinguish between different versions of the compiler, including servicing releases. For more information about Visual Studio 2019 versions 16.8, 16.9, 16.10 and 16.11, see [Service releases starting with Visual Studio 2017](#service-releases-starting-with-visual-studio-2017). **[`_MSC_BUILD`](../preprocessor/predefined-macros.md)** represents the build version of the compiler. It has the form: R. Use it to distinguish between servicing releases. When the major version changed between Visual Studio 2013 and Visual Studio 2015, `_MSC_VER` reflected the change by going from 1800 to 1900. -An example of a minor change is from Visual Studio 2022 17.1 to Visual Studio 2022 17.2. In that case, `_MSC_VER` changed from 1931 to 1932. - -The following table lists the Visual C++ compiler `_MSC_VER` for each Visual Studio release: - -| Visual Studio version | `_MSC_VER` | -|--|--| -| Visual Studio 6.0 | 1200 | -| Visual Studio .NET 2002 (7.0) | 1300 | -| Visual Studio .NET 2003 (7.1) | 1310 | -| Visual Studio 2005 (8.0) | 1400 | -| Visual Studio 2008 (9.0) | 1500 | -| Visual Studio 2010 (10.0) | 1600 | -| Visual Studio 2012 (11.0) | 1700 | -| Visual Studio 2013 (12.0) | 1800 | -| Visual Studio 2015 (14.0) | 1900 | -| Visual Studio 2017 RTW (15.0) | 1910 | -| Visual Studio 2017 version 15.3 | 1911 | -| Visual Studio 2017 version 15.5 | 1912 | -| Visual Studio 2017 version 15.6 | 1913 | -| Visual Studio 2017 version 15.7 | 1914 | -| Visual Studio 2017 version 15.8 | 1915 | -| Visual Studio 2017 version 15.9 | 1916 | -| Visual Studio 2019 RTW 16.0 | 1920 | -| Visual Studio 2019 version 16.1 | 1921 | -| Visual Studio 2019 version 16.2 | 1922 | -| Visual Studio 2019 version 16.3 | 1923 | -| Visual Studio 2019 version 16.4 | 1924 | -| Visual Studio 2019 version 16.5 | 1925 | -| Visual Studio 2019 version 16.6 | 1926 | -| Visual Studio 2019 version 16.7 | 1927 | -| Visual Studio 2019 version 16.8, 16.9 a | 1928 | -| Visual Studio 2019 version 16.10, 16.11 b | 1929 | -| Visual Studio 2022 RTW 17.0 | 1930 | -| Visual Studio 2022 version 17.1 | 1931 | -| Visual Studio 2022 version 17.2 | 1932 | -| Visual Studio 2022 version 17.3 | 1933 | -| Visual Studio 2022 version 17.4 | 1934 | -| Visual Studio 2022 version 17.5 | 1935 | -| Visual Studio 2022 version 17.6 | 1936 | -| Visual Studio 2022 version 17.7 | 1937 | -| Visual Studio 2022 version 17.8 | 1938 | -| Visual Studio 2022 version 17.9 | 1939 | -| Visual Studio 2022 version 17.10 | 1940 | - -a Visual Studio 2019 16.8 and 16.9 share the same major and minor versions (and so have the same value for `_MSC_VER`). To distinguish them, use `_MSC_FULL_VER`. The minimum value of `_MSC_FULL_VER` for Visual Studio 2019 16.8 is 192829333. The minimum value of `_MSC_FULL_VER` for Visual Studio 2019 16.9 is 192829910. - -b Visual Studio 2019 16.10 and 16.11 share the same major and minor versions (and so have the same value for `_MSC_VER`). To distinguish them, use `_MSC_FULL_VER`. The minimum value of `_MSC_FULL_VER` for Visual Studio 2019 16.10 is 192929917. The minimum value of `_MSC_FULL_VER` for Visual Studio 2019 16.11 is 192930129. +An example of a minor change is from Visual Studio 2022 version 17.1 to Visual Studio 2022 version 17.2. In that case, `_MSC_VER` changed from 1931 to 1932. + +The following table lists the Visual Studio version corresponding to each Microsoft C++ compiler (`_MSC_VER`) and MSVC Build Tools release: + +| Visual Studio version | `_MSC_VER` | MSVC Build Tools version | +|--|--|--| +| Visual Studio 6.0 | 1200 | 6.0 | +| Visual Studio .NET 2002 (7.0) | 1300 | 7.0 | +| Visual Studio .NET 2003 (7.1) | 1310 | 7.1 | +| Visual Studio 2005 (8.0) | 1400 | 8.0 | +| Visual Studio 2008 (9.0) | 1500 | 9.0 | +| Visual Studio 2010 (10.0) | 1600 | 10.0 | +| Visual Studio 2012 (11.0) | 1700 | 11.0 | +| Visual Studio 2013 (12.0) | 1800 | 12.0 | +| Visual Studio 2015 (14.0) | 1900 | 14.0 | +| Visual Studio 2017 RTW (15.0) | 1910 | 14.10 | +| Visual Studio 2017 version 15.3 | 1911 | 14.11 | +| Visual Studio 2017 version 15.5 | 1912 | 14.12 | +| Visual Studio 2017 version 15.6 | 1913 | 14.13 | +| Visual Studio 2017 version 15.7 | 1914 | 14.14 | +| Visual Studio 2017 version 15.8 | 1915 | 14.15 | +| Visual Studio 2017 version 15.9 | 1916 | 14.16 | +| Visual Studio 2019 RTW 16.0 | 1920 | 14.20 | +| Visual Studio 2019 version 16.1 | 1921 | 14.21 | +| Visual Studio 2019 version 16.2 | 1922 | 14.22 | +| Visual Studio 2019 version 16.3 | 1923 | 14.23 | +| Visual Studio 2019 version 16.4 | 1924 | 14.24 | +| Visual Studio 2019 version 16.5 | 1925 | 14.25 | +| Visual Studio 2019 version 16.6 | 1926 | 14.26 | +| Visual Studio 2019 version 16.7 | 1927 | 14.27 | +| Visual Studio 2019 version 16.8, 16.9 a | 1928 | 14.28 | +| Visual Studio 2019 version 16.10, 16.11 b | 1929 | 14.29 | +| Visual Studio 2022 RTW 17.0 | 1930 | 14.30 | +| Visual Studio 2022 version 17.1 | 1931 | 14.31 | +| Visual Studio 2022 version 17.2 | 1932 | 14.32 | +| Visual Studio 2022 version 17.3 | 1933 | 14.33 | +| Visual Studio 2022 version 17.4 | 1934 | 14.34 | +| Visual Studio 2022 version 17.5 | 1935 | 14.35 | +| Visual Studio 2022 version 17.6 | 1936 | 14.36 | +| Visual Studio 2022 version 17.7 | 1937 | 14.37 | +| Visual Studio 2022 version 17.8 | 1938 | 14.38 | +| Visual Studio 2022 version 17.9 | 1939 | 14.39 | +| Visual Studio 2022 version 17.10 | 1940 | 14.40 | +| Visual Studio 2022 version 17.11 | 1941 | 14.41 | +| Visual Studio 2022 version 17.12 | 1942 | 14.42 | +| Visual Studio 2022 version 17.13 | 1943 | 14.43 | +| Visual Studio 2022 version 17.14 | 1944 | 14.44 | + +a Visual Studio 2019 versions 16.8 and 16.9 share the same major and minor versions (and so have the same value for `_MSC_VER`). To distinguish them, use `_MSC_FULL_VER`. The minimum value of `_MSC_FULL_VER` for Visual Studio 2019 version 16.8 is 192829333. The minimum value of `_MSC_FULL_VER` for Visual Studio 2019 version 16.9 is 192829910. + +b Visual Studio 2019 versions 16.10 and 16.11 share the same major and minor versions (and so have the same value for `_MSC_VER`). To distinguish them, use `_MSC_FULL_VER`. The minimum value of `_MSC_FULL_VER` for Visual Studio 2019 version 16.10 is 192929917. The minimum value of `_MSC_FULL_VER` for Visual Studio 2019 version 16.11 is 192930129. ## See also diff --git a/docs/overview/cpp-conformance-improvements-2017.md b/docs/overview/cpp-conformance-improvements-2017.md index 557e7983367..72c38c1e4ae 100644 --- a/docs/overview/cpp-conformance-improvements-2017.md +++ b/docs/overview/cpp-conformance-improvements-2017.md @@ -7,7 +7,7 @@ ms.subservice: "cpp-lang" --- # C++ Conformance improvements, behavior changes, and bug fixes in Visual Studio 2017 -Microsoft C/C++ in Visual Studio (MSVC) makes conformance improvements and bug fixes in every release. This article lists the improvements by major release, then by version. To jump directly to the changes for a specific version, use list below **In this article**. +Microsoft C/C++ in Visual Studio (MSVC) makes conformance improvements and bug fixes in every release. This article lists the improvements by major release, then by version. To jump directly to the changes for a specific version, use the list below **In this article**. This document lists the changes in Visual Studio 2017. For a guide to the changes in Visual Studio 2022, see [C++ conformance improvements in Visual Studio 2022](cpp-conformance-improvements.md). For a guide to the changes in Visual Studio 2019, see [C++ conformance improvements in Visual Studio 2019](cpp-conformance-improvements-2019.md). For a complete list of previous conformance improvements, see [Visual C++ What's New 2003 through 2015](../porting/visual-cpp-what-s-new-2003-through-2015.md). @@ -70,7 +70,7 @@ const A& a2{ 1 }; In Visual Studio 2015, the compiler erroneously treated copy-list-initialization in the same way as regular copy-initialization: it considered only converting constructors for overload resolution. In the following example, Visual Studio 2015 chooses `MyInt(23)`. Visual Studio 2017 correctly raises the error. ```cpp -// From http://www.open-std.org/jtc1/sc22/wg21/docs/cwg_closed.html#1228 +// From https://www.open-std.org/jtc1/sc22/wg21/docs/cwg_closed.html#1228 struct MyStore { explicit MyStore(int initialCapacity); }; @@ -465,7 +465,7 @@ int main() // understand C++ and uses BitBlt, which results in a double-free later. f(A()); // C4606 'A': passing argument by value across native and managed // boundary requires valid copy constructor. Otherwise, the runtime - // behavior is undefined.` + // behavior is undefined. } ``` @@ -611,7 +611,7 @@ To fix the warning, put `extern "C"` first: extern "C" __declspec(noinline) HRESULT __stdcall ``` -This warning is off by default in Visual Studio 2017 version 15.3, and only impacts code compiled with **`/Wall`** **`/WX`**. Starting in Visual Studio 2017 version 15.5, it's enabled by default as a level 3 warning. +This warning is off by default in Visual Studio 2017 version 15.3, and only impacts code compiled with **`/Wall`** **`/WX`**. Starting in Visual Studio 2017 version 15.5, it's enabled by default as a level 3 warning. ### `decltype` and calls to deleted destructors @@ -805,7 +805,7 @@ In earlier versions of Visual Studio, the compiler always gave a **`constexpr`** ### Removing allocator support in `std::function` -[P0302R1](https://wg21.link/p0302r1) Prior to C++17, the class template `std::function` had several constructors that took an allocator argument. However, the use of allocators in this context was problematic, and the semantics were unclear. The problem contructors have been removed. +[P0302R1](https://wg21.link/p0302r1) Prior to C++17, the class template `std::function` had several constructors that took an allocator argument. However, the use of allocators in this context was problematic, and the semantics were unclear. The problematic constructors have been removed. ### Fixes for `not_fn()` @@ -1022,7 +1022,7 @@ To fix the error, remove the unused variable. ### Single-line comments -In Visual Studio 2017 version 15.5, warnings C4001 and C4179 are no longer emitted by the C compiler. Previously, they were only emitted under the **`/Za`** compiler switch. The warnings are no longer needed because single-line comments have been part of the C standard since C99. +In Visual Studio 2017 version 15.5, warnings C4001 and C4179 are no longer emitted by the C compiler. Previously, they were only emitted under the **`/Za`** compiler switch. The warnings are no longer needed because single-line comments have been part of the C standard since C99. ```cpp /* C only */ @@ -1051,7 +1051,7 @@ When the code doesn't need to be backwards compatible, avoid the warning by remo ### `__declspec` attributes with `extern "C"` linkage -In earlier versions of Visual Studio, the compiler ignored `__declspec(...)` attributes when `__declspec(...)` was applied before the `extern "C"` linkage specification. This behavior caused code to be generated that user didn't intend, with possible runtime implications. The [C4768](../error-messages/compiler-warnings/c4768.md) warning was added in Visual Studio version 15.3, but was off by default. In Visual Studio 2017 version 15.5, the warning is enabled by default. +In earlier versions of Visual Studio, the compiler ignored `__declspec(...)` attributes when `__declspec(...)` was applied before the `extern "C"` linkage specification. This behavior caused code to be generated that the user didn't intend, with possible runtime implications. The [C4768](../error-messages/compiler-warnings/c4768.md) warning was added in Visual Studio version 15.3, but was off by default. In Visual Studio 2017 version 15.5, the warning is enabled by default. ```cpp __declspec(noinline) extern "C" HRESULT __stdcall // C4768 @@ -1116,7 +1116,7 @@ error C2027: use of undefined type 'S' ### `std::is_convertible` target type -`std::is_convertible` requires the target type to be a valid return type. In earlier versions of Visual Studio, the compiler incorrectly allowed abstract types, which might lead to incorrect overload resolution and unintended runtime behavior. The following code now correctly raises C2338: +`std::is_convertible` requires the target type to be a valid return type. In earlier versions of Visual Studio, the compiler incorrectly allowed abstract types, which might lead to incorrect overload resolution and unintended runtime behavior. The following code now correctly raises C2338: ```cpp #include @@ -1193,7 +1193,7 @@ The warning was added in Visual Studio 2017 version 15.3, but was off by default ### Defaulted functions and `__declspec(nothrow)` -The compiler previously allowed defaulted functions to be declared with `__declspec(nothrow)` when the corresponding base/member functions permitted exceptions. This behavior is contrary to the C++ standard and can cause undefined behavior at runtime. The standard requires such functions to be defined as deleted if there's an exception specification mismatch. Under **`/std:c++17`**, the following code raises C2280: +The compiler previously allowed defaulted functions to be declared with `__declspec(nothrow)` when the corresponding base/member functions permitted exceptions. This behavior is contrary to the C++ standard and can cause undefined behavior at runtime. The standard requires such functions to be defined as deleted if there's an exception specification mismatch. Under **`/std:c++17`**, the following code raises C2280: ```cpp struct A { @@ -1441,7 +1441,7 @@ void sample(A<0> *p) ### C++20: Avoiding unnecessary decay (partial) -[P0777R1](https://wg21.link/p0777r1) Adds differentiation between the concept of "decay" and that of simply removing const or reference qualifiers. New type trait `remove_reference_t` replaces `decay_t` in some contexts. Support for `remove_cvref_t` is implemented in Visual Studio 2019. +[P0777R1](https://wg21.link/p0777r1) Adds differentiation between the concept of "decay" and that of simply removing const or reference qualifiers. New type trait `remove_reference_t` replaces `decay_t` in some contexts. Support for `remove_cvref_t` is implemented in Visual Studio 2019. ### C++17: Parallel algorithms @@ -1457,7 +1457,7 @@ void sample(A<0> *p) ### C++17: Mathematical special functions -[P0226R1](https://wg21.link/p0220r1) Adopts previous technical specifications for Mathematical Special Functions into the standard *``* header. +[P0226R1](https://wg21.link/p0226r1) Adopts previous technical specifications for Mathematical Special Functions into the standard *``* header. ### C++17: Deduction guides for the standard library @@ -1613,7 +1613,7 @@ In [`/permissive-`](../build/reference/permissive-standards-conformance.md) mode ```cpp template -using X = typename T; // C7511: 'T': 'typename' keyword must be +using X = typename T; // C7511: 'T': 'typename' keyword must be // followed by a qualified name ``` @@ -1629,10 +1629,10 @@ The standard C++ attribute [`[[deprecated]]`](../cpp/attributes.md) may be used template using X = __declspec(deprecated("msg")) T; // C2760: syntax error: // unexpected token '__declspec', - // expected 'type specifier'` + // expected 'type specifier' ``` -To fix the error, change to code to the following (with the attribute placed before the '=' of the alias definition): +To fix the error, change the code to the following (with the attribute placed before the '=' of the alias definition): ```cpp template @@ -1678,7 +1678,7 @@ The following code now raises C4643: namespace std { template class vector; // C4643: Forward declaring 'vector' // in namespace std is not permitted - // by the C++ Standard` + // by the C++ Standard } ``` diff --git a/docs/overview/cpp-conformance-improvements-2019.md b/docs/overview/cpp-conformance-improvements-2019.md index 533c1dbe186..c69a47b06b0 100644 --- a/docs/overview/cpp-conformance-improvements-2019.md +++ b/docs/overview/cpp-conformance-improvements-2019.md @@ -7,7 +7,7 @@ ms.subservice: "cpp-lang" --- # C++ Conformance improvements, behavior changes, and bug fixes in Visual Studio 2019 -Microsoft C/C++ in Visual Studio (MSVC) makes conformance improvements and bug fixes in every release. This article lists the improvements by major release, then by version. To jump directly to the changes for a specific version, use the list below **In this article**. +Microsoft C++ (MSVC) Build Tools in Visual Studio makes conformance improvements and bug fixes in every release. This article lists the improvements by major release, then by version. To jump directly to the changes for a specific version, use the list below **In this article**. This document lists the changes in Visual Studio 2019. For a guide to the changes in Visual Studio 2022, see [C++ conformance improvements in Visual Studio 2022](cpp-conformance-improvements.md). For changes in Visual Studio 2017, see [C++ conformance improvements in Visual Studio 2017](cpp-conformance-improvements-2017.md). For a complete list of previous conformance improvements, see [Visual C++ What's New 2003 through 2015](../porting/visual-cpp-what-s-new-2003-through-2015.md). @@ -67,8 +67,8 @@ To avoid the errors, insert a space in the offending line before the final angle ### References to types with mismatched cv-qualifiers ->[!Note] -> This change only affects Visual Studio 2019 versions 16.0 through 16.8. It was reverted starting in Visual Studio 2019 version 16.9 +> [!NOTE] +> This change only affects Visual Studio 2019 versions 16.0 through 16.8. It was reverted starting in Visual Studio 2019 version 16.9. Previously, MSVC allowed direct binding of a reference from a type with mismatched cv-qualifiers below the top level. This binding could allow modification of supposedly const data referred to by the reference. @@ -455,7 +455,7 @@ The `std::bitset` constructor no longer reads the ones and zeroes in reverse ord ### `std::pair::operator=` regression -We fixed a regression in the `std::pair` assignment operator introduced when implementing [LWG 2729 "Missing SFINAE on `std::pair::operator=`";](https://cplusplus.github.io/LWG/issue2729). It now correctly accepts types convertible to `std::pair` again. +We fixed a regression in the `std::pair` assignment operator introduced when implementing [LWG 2729 "Missing SFINAE on `std::pair::operator=`"](https://cplusplus.github.io/LWG/issue2729). It now correctly accepts types convertible to `std::pair` again. ### Non-deduced contexts for `add_const_t` @@ -579,8 +579,8 @@ int main() // The conversion from 'E' to the fixed underlying type 'unsigned char' is better than the // conversion from 'E' to the promoted type 'unsigned int'. f(e); - - // Error C2666. This call is ambiguous, but previously called f(unsigned int, const B&). + + // Error C2666. This call is ambiguous, but previously called f(unsigned int, const B&). f(e, B{}); } ``` @@ -694,7 +694,7 @@ std::equal(std::begin(a), std::end(a), std::begin(b), std::end(b)); ### Effect of defining spaceship operator on `==` and `!=` -A definition of the spaceship operator (**`<=>`**) alone will no longer rewrite expressions involving **`==`** or **`!=`** unless the spaceship operator is marked as **`= default`** ([P1185R2](https://wg21.link/p1185r2)). The following example compiles in Visual Studio 2019 RTW and version 16.1, but produces C2678 in Visual Studio 2019 version 16.2: +A definition of the spaceship operator (**`<=>`**) alone will no longer rewrite expressions involving **`==`** or **`!=`** unless the spaceship operator is marked as **`= default`** ([P1185R2](https://wg21.link/p1185r2)). The following example compiles in Visual Studio 2019 RTW and version 16.1, but produces C2676 in Visual Studio 2019 version 16.2: ```cpp #include @@ -885,7 +885,7 @@ The non-standard headers \ and \ have been removed. Code Two-phase name lookup requires that non-dependent names used in template bodies must be visible to the template at definition time. Previously, such names may have been found when the template is instantiated. This change makes it easier to write portable and conforming code in MSVC under the [`/permissive-`](../build/reference/permissive-standards-conformance.md) flag. -In Visual Studio 2019 version 16.4 with the **`/permissive-`** flag set, the following example produces an error, because `N::f` isn't visible when the `f` template is defined: +In Visual Studio 2019 version 16.4 with the **`/permissive-`** flag set, the following example produces an error, because `N::f` isn't visible when the `f` template is defined: ```cpp template @@ -1249,7 +1249,7 @@ void f() { Previously, thread-local variables in DLLs weren't correctly initialized. Other than on the thread that loaded the DLL, they weren't initialized before first use on threads that existed before the DLL was loaded. This defect has now been corrected. Thread-local variables in such a DLL get initialized immediately before their first use on such threads. -This new behavior of testing for initialization on uses of thread-local variables may be disabled by using the **`/Zc:tlsGuards-`** compiler option. Or, by adding the `[[msvc:no_tls_guard]]` attribute to particular thread local variables. +This new behavior of testing for initialization on uses of thread-local variables may be disabled by using the **`/Zc:tlsGuards-`** compiler option. Or, by adding the `[[msvc::no_tls_guard]]` attribute to particular thread local variables. ### Better diagnosis of call to deleted functions @@ -1424,7 +1424,7 @@ In Visual Studio 2019 version 16.6 and later, the behavior of **`typedef`** decl The same restrictions are applied recursively to each nested class. The restriction is meant to ensure the simplicity of structs that have **`typedef`** names for linkage purposes. They must be simple enough that no linkage calculations are necessary before the compiler gets to the **`typedef`** name for linkage. -This change affects all standards modes of the compiler. In default (**`/std:c++14`**) and **`/std:c++17`** modes, the compiler emits warning C5208 for non-conforming code. If **`/permissive-`** is specified, the compiler emits warning C5208 as an error under **`/std:c++14`** and emits error C7626 under **`/std:c++17`**. The compiler emits error C7626 for non-conforming code when **`/std:c++20`** or **`/std:c++latest`** is specified. +This change affects all standards modes of the compiler. In default (**`/std:c++14`**) and **`/std:c++17`** modes, the compiler emits warning C5208 for non-conforming code. If **`/permissive-`** is specified, the compiler emits warning C5208 as an error under **`/std:c++14`** and emits error C7626 under **`/std:c++17`**. The compiler emits error C7626 for non-conforming code when **`/std:c++20`** or **`/std:c++latest`** is specified. The following sample shows the constructs that are no longer allowed in unnamed structs. Depending on the standards mode specified, C5208 or C7626 errors or warnings are emitted: @@ -1934,14 +1934,14 @@ C++20 doesn't support coroutines with a return type that includes a placeholder auto my_generator() { ... co_yield next; -}; +} // /std:c++latest #include std::experimental::generator my_generator() { ... co_yield next; -}; +} ``` #### Return type of `return_value` @@ -2101,7 +2101,7 @@ The update may change program behavior that relied on an introduced temporary: int func() { int i1 = 13; int i2 = 23; - + int* iptr = &i1; int const * const& iptrcref = iptr; @@ -2110,7 +2110,7 @@ int func() { { return 1; } - + // Now change what iptr points to. // Prior to CWG 2352 iptrcref should be bound to a temporary and still points to the value 13. @@ -2151,7 +2151,7 @@ class B { template B::~B() { /* ... */ } // Before: no diagnostic. -// Now diagnoses a definition mismatch. To fix, define the implementation by +// Now diagnoses a definition mismatch. To fix, define the implementation by // using the same noexcept-specifier. For example, // B::~B() noexcept { /* ... */ } ``` @@ -2254,7 +2254,7 @@ Earlier versions of the compiler would incorrectly convert the argument of `f` f This change can also correct the chosen overload in some other situations: ```cpp -struct Base +struct Base { operator char *(); }; diff --git a/docs/overview/cpp-conformance-improvements.md b/docs/overview/cpp-conformance-improvements.md index a1f9c469fbf..2249e10efaa 100644 --- a/docs/overview/cpp-conformance-improvements.md +++ b/docs/overview/cpp-conformance-improvements.md @@ -1,7 +1,7 @@ --- title: "C++ conformance improvements in Visual Studio 2022" description: "Microsoft C++ in Visual Studio is improving standards conformance and fixing bugs regularly." -ms.date: 11/12/2024 +ms.date: 05/13/2025 ms.service: "visual-cpp" ms.subservice: "cpp-lang" --- @@ -19,6 +19,114 @@ For changes in earlier versions of Visual Studio: | 2017 | [C++ conformance improvements in Visual Studio 2017](cpp-conformance-improvements-2017.md) | | 2003-2015 | [Visual C++ What's New 2003 through 2015](../porting/visual-cpp-what-s-new-2003-through-2015.md) | +## Conformance improvements in Visual Studio 2022 version 17.14 + +Visual Studio 2022 version 17.14 includes the following conformance improvements, bug fixes, and behavior changes in the Microsoft C/C++ compiler. + +### Conformance improvements + +- Standard library hardening ([P3471R4](https://www.open-std.org/jtc1/sc22/wg21/docs/papers/2025/p3471r4.html)) turns some instances of undefined behavior in the standard library into a call to [__fastfail](../intrinsics/fastfail.md). Off by default. Define `_MSVC_STL_HARDENING=1` project-wide to enable. + +### Enhanced behavior + +- Implemented "destructor tombstones" to mitigate use-after-free mistakes. Off by default. Define `_MSVC_STL_DESTRUCTOR_TOMBSTONES=1` project-wide to enable. + +### Bug fixes + +- Fixed errant compiler errors when using `` in a CUDA project. +- Fixed a compiler issue where the address of a local variable could "leak" during `constexpr` evaluation. For example: + + ```cpp + const unsigned & func() + { + const int x = 0; + constexpr const unsigned & r1 = x; // Previously accepted, now an error + return r1; + } + + auto r = func(); // Previously, the local address leaked + ``` + + **Example #2** + + ```cpp + #include + + void test() + { + constexpr std::initializer_list xs { 1, 2, 3 }; // Previously accepted, now an error + + static constexpr std::initializer_list ys { 1, 2, 3 }; // Correct usage - note use of static + } + ``` + +- Code compiled with `/permissive-` no longer accepts a combination of `friend` and `static` on a declaration. The fix is usually to remove `static` from the declaration. For example: + + ```cpp + struct S + { + friend static void f(); // Previously accepted, now emits error C2440: 'static' cannot be used with 'friend' + }; + ``` + +- Reference binding to volatile-qualified types fixed when referring to a base or derived class. For example: + + ```cpp + struct A {}; + struct B : public A {}; + + void f(A&); // 1 + void f(const volatile A&); // 2 + + f(B{}); // Previously called 2. This is ill-formed under /permissive- or /Zc:referenceBinding. Chooses 1 if relaxed reference binding rules are enabled. + ``` + +For an in-depth summary of changes made to the Standard Template Library, including conformance changes, bug fixes, and performance improvements, see [STL Changelog VS 2022 17.14](https://github.com/microsoft/STL/wiki/Changelog#vs-2022-1714). + +## Conformance improvements in Visual Studio 2022 version 17.13 + +Visual Studio 2022 version 17.13 includes the following conformance improvements, bug fixes, and behavior changes in the Microsoft C/C++ compiler. + +For an in-depth summary of changes made to the Standard Template Library, including conformance changes, bug fixes, and performance improvements, see [STL Changelog VS 2022 17.13](https://github.com/microsoft/STL/wiki/Changelog#vs-2022-1713). + +### Argument-dependent lookup (ADL) + +Language constructs such as range-for and structured bindings have special argument-dependent lookup rules for certain identifiers such as `begin`, `end`, or `get`. Previously, this lookup included candidates from the `std` namespace, even when namespace `std` isn't part of the ordinary set of associated namespaces for argument-dependent lookup. + +Programs that introduced declarations to `std` for these constructs no longer compile. Instead, the declarations should be in a normal associated namespace for the types involved (possibly including the global namespace). + +```cpp +template +struct Foo {}; + +namespace std +{ + // To correct the program, move these declarations from std to the global namespace + template + T* begin(Foo& f); + template + T* end(Foo& f); +} + +void f(Foo foo) +{ + for (auto x : foo) // Previously compiled. Now emits error C3312: no callable 'begin' function found for type 'Foo' + { + ... + } +} +``` + +### Can't modify implementation-reserved macros + +Previously, the compiler permitted changing or undefining certain implementation-provided macros such as `_MSC_EXTENSIONS`. Altering the definition of certain macros can result in undefined behavior. + +Attempting to alter or undefine certain reserved macro names now results in the level-1 warning `C5308`. In `/permissive-` mode, this warning is treated as an error. + +```cpp +#undef _MSC_EXTENSIONS // Warning C5308: Modifying reserved macro name `_MSC_EXTENSIONS` may cause undefined behavior +``` + ## Conformance improvements in Visual Studio 2022 version 17.12 Visual Studio 2022 version 17.12 includes the following conformance improvements, bug fixes, and behavior changes in the Microsoft C/C++ compiler. @@ -29,9 +137,9 @@ For an in-depth summary of changes made to the Standard Template Library, includ This is a source/binary breaking change. -The implicit conversion to `bool` from `_com_ptr_t` instances can be surprising or lead to compiler errors. Implicit conversion functions are discouraged by the [C++ Core Guidelines (C.164)](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#Ro-conversion), and `_com_ptr_t` contained implicit conversions to both `bool` and `Interface*`. These two implicit conversions can lead to ambiguities. +The implicit conversion to `bool` from `_com_ptr_t` instances can be surprising or lead to compiler errors. [C.164: Avoid implicit conversion operators](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines#c164-avoid-implicit-conversion-operators) in the C++ Core Guidelines discourage implicit conversion functions. And `_com_ptr_t` contained implicit conversions to both `bool` and `Interface*`. These two implicit conversions can lead to ambiguities. -To help address this, the conversion to `bool` is now explicit. The conversion to `Interface*` is unchanged. +To address this, the conversion to `bool` is now explicit. The conversion to `Interface*` is unchanged. A macro is provided to opt-out of this new behavior and restore the previous implicit conversion. Compile with `/D_COM_DISABLE_EXPLICIT_OPERATOR_BOOL` to opt-out of this change. We recommend that you modify the code to not rely on implicit conversions. @@ -256,7 +364,7 @@ To fix this warning, either use an equality operator, `value == 9`, if this is w Visual Studio 2022 version 17.9 contains the following conformance improvements, bug fixes, and behavior changes in the Microsoft C/C++ compiler. -For a broader summary of changes made to the Standard Template Library, see [STL Changelog VS 2022 17.9](https://github.com/microsoft/STL/wiki/Changelog#vs-2022-179). +For a broader summary of changes made to the Standard Template Library, see [STL Changelog VS 2022 17.9](https://github.com/microsoft/STL/wiki/VS-2022-Changelog#vs-2022-179). ### Application of `_Alignas` on a structured type in C @@ -345,7 +453,7 @@ The C compiler used to accept the `/FU` option, even though it hasn't support ma The C++23 named modules `std` and `std.compat` are now available when compiling with `/std:c++20`. -For a broader summary of changes made to the C++ Standard Library, see [STL Changelog VS 2022 17.8](https://github.com/microsoft/STL/wiki/Changelog#vs-2022-178). +For a broader summary of changes made to the C++ Standard Library, see [STL Changelog VS 2022 17.8](https://github.com/microsoft/STL/wiki/VS-2022-Changelog#vs-2022-178). ## Conformance improvements in Visual Studio 2022 version 17.7 @@ -361,7 +469,7 @@ The `` library is now supported. See [P2093R14 Formatted output](https:// Implemented `views::cartesian_product`. -For a broader summary of changes made to the Standard Template Library, see [STL Changelog VS 2022 17.7](https://github.com/microsoft/STL/wiki/Changelog#vs-2022-177). +For a broader summary of changes made to the Standard Template Library, see [STL Changelog VS 2022 17.7](https://github.com/microsoft/STL/wiki/VS-2022-Changelog#vs-2022-177). ### `using` conformance @@ -481,7 +589,7 @@ bool b = S{} != S{}; The compiler accepts this code, which means that the compiler is more strict with code such as: -```c++ +```cpp struct S { operator bool() const; diff --git a/docs/overview/how-to-report-a-problem-with-the-visual-cpp-toolset.md b/docs/overview/how-to-report-a-problem-with-the-visual-cpp-toolset.md index 5fff09d04d6..5664f47bcee 100644 --- a/docs/overview/how-to-report-a-problem-with-the-visual-cpp-toolset.md +++ b/docs/overview/how-to-report-a-problem-with-the-visual-cpp-toolset.md @@ -1,13 +1,13 @@ --- -title: "How to report a problem with the Microsoft C++ toolset" +title: "How to report a problem with the Microsoft C++ Build Tools" description: How to create a good problem report and repro information for the Microsoft C++ toolset. ms.date: "09/24/2019" ms.service: "visual-cpp" -ms.subservice: "ide" +ms.subservice: "cpp-lang" author: "tylermsft" ms.author: "twhitney" --- -# How to report a problem with the Microsoft C++ toolset or documentation +# How to report a problem with the Microsoft C++ Build Tools or documentation If you find problems in the Microsoft C++ compiler (MSVC), the linker, or other tools and libraries, we want to know about them. When the issue is in our documentation, we want to know about that, too. @@ -311,6 +311,20 @@ After you generate the preprocessed files, it's a good idea to make sure the pro Finally, attach the preprocessed repro files (*filename*.i and *modulename*.i) along with the .ifc output to your report. +#### To generate a module trace file + +When issues involve C++ modules, provide a module trace file along with the preprocessed repro improves diagnostic quality to reduce turnaround time. A module trace file records detailed information about module operations during compilation. + +It's ideal if the example can be condensed to a single source code file, without reference to any user headers. + +Reducing the amount of code we have to consider as a possible contributor to the problem is enormously helpful to us. Using **/MP** or multi-source invocations can cause the trace to represent only the last compiled file or be incomplete. If you can't reduce the problem to a single source file, package your code into a .zip file or similar, or consider using an IDE project repro. For more information, see [Other repros](#other-repros). + +1. Open the **Developer Command Prompt** that matches the Visual Studio version and configuration architecture used to build your project. +1. Enter the command `cl /d1module:enableLogging`*trace.json* [*other-args*] *filename.cpp*. For *trace.json*, specify the desired output file name for the module trace. There can't be a space between `/d1module:enableLogging` and the output file name. For [*other-args*], include any additional compilation arguments. For *filename.cpp*, specify the source file that reproduces the problem. +1. If multiple translation units are involved in the problem, run separate single-file invocations to collect a trace for the specific file that reproduces the problem. You can collect traces for additional relevant files if needed. + +Finally, attach the generated *trace.json* file along with the preprocessed repro to your report. + ### Link repros A *link repro* is the linker-generated contents of a directory, specified either by the **link\_repro** environment variable, or as an argument to the [/LINKREPRO](../build/reference/linkrepro.md) linker option. It contains build artifacts that collectively demonstrate a problem that occurs at link time. Examples include a backend crash involving Link-Time Code Generation (LTCG), or a linker crash. These build artifacts are the ones needed as linker input so the problem can be reproduced. A link repro can be created easily by using this environment variable. It enables the linker's built-in repro generation capability. @@ -382,7 +396,7 @@ For issues with the C++ compiler, linker, and other tools and libraries, first s > Information in the initial Developer Community report will always be public. If this is a concern, see the next section about [Reports and privacy](#reports-and-privacy). > [!TIP] -> For other kinds of problems you might find in Visual Studio that are unrelated to the C++ toolset (For example, UI issues, broken IDE functionality, or general crashes), use the **Report a Problem** tool in the IDE. This is the best choice, due to its screenshot capabilities and its ability to record UI actions that lead to the problem you found. These kinds of errors can also be looked up on the Visual Studio [Developer Community](https://aka.ms/feedback/report?space=8) site. For more information, see [How to report a problem with Visual Studio](/visualstudio/ide/how-to-report-a-problem-with-visual-studio). +> For other kinds of problems you might find in Visual Studio that are unrelated to the Microsoft C++ Build Tools (For example, UI issues, broken IDE functionality, or general crashes), use the **Report a Problem** tool in the IDE. This is the best choice, due to its screenshot capabilities and its ability to record UI actions that lead to the problem you found. These kinds of errors can also be looked up on the Visual Studio [Developer Community](https://aka.ms/feedback/report?space=8) site. For more information, see [How to report a problem with Visual Studio](/visualstudio/ide/how-to-report-a-problem-with-visual-studio). ### Reports and privacy @@ -408,6 +422,6 @@ To maintain your privacy and keep your sensitive information out of public view, ## How to report a C++ documentation issue -We use GitHub issues to track problems reported in our documentation. You can now create GitHub issues directly from a content page, which enables you interact in a richer way with writers and product teams. If you see an issue with a document, a bad code sample, a confusing explanation, a critical omission, or even just a typo, you can easily let us know. Scroll to the bottom of the page and select **Sign in to give documentation feedback**. You need to create a GitHub account if you don't have one already. When you have a GitHub account, you can see all of our documentation issues and their status. You also get notifications when changes are made for the issue you reported. For more information, see our [Feedback System blog entry](/teamblog/a-new-feedback-system-is-coming-to-docs). +If you see an issue with a document, a bad code sample, a confusing explanation, a critical omission, or even just a typo, you can easily let us know by using the feedback buttons on the page. Since 2024, we no longer use GitHub issues to track problems reported. For more information, see [Announcing a new way to give feedback on Microsoft Learn](https://techcommunity.microsoft.com/blog/microsoftlearnblog/announcing-a-new-way-to-give-feedback-on-microsoft-learn/4027635). -You create a documentation issue on GitHub when you use the documentation feedback button. The issue is automatically filled in with some information about the page you created the issue on. That's how we know where the problem is located, so don't edit this information. Just append the details about what's wrong, and if you like, a suggested fix. [Our C++ docs are open source](https://github.com/MicrosoftDocs/cpp-docs/), so if you'd like to submit a fix yourself, you can. For more information about how you can contribute to our documentation, see our [Contributing guide](https://github.com/MicrosoftDocs/cpp-docs/blob/main/CONTRIBUTING.md) on GitHub. +[Our C++ docs are open source](https://github.com/MicrosoftDocs/cpp-docs/), so if you'd like to submit a fix yourself, you can. For more information about how you can contribute to our documentation, see our [Contributing guide](https://github.com/MicrosoftDocs/cpp-docs/blob/main/CONTRIBUTING.md) on GitHub. diff --git a/docs/overview/languages-cpp.md b/docs/overview/languages-cpp.md index b02dc239e2f..8618404b3e1 100644 --- a/docs/overview/languages-cpp.md +++ b/docs/overview/languages-cpp.md @@ -1,8 +1,8 @@ --- -description: "Learn more about: Languages" title: "Languages" -ms.date: "03/29/2019" -helpviewer_keywords: ["C lanugage", "C++ Language", "Assembly Language", "Compiler Intrinsics"] +description: "Learn more about: Languages" +ms.date: 03/29/2019 +helpviewer_keywords: ["C language", "C++ Language", "Assembly Language", "Compiler Intrinsics"] --- # Languages diff --git a/docs/overview/media/clang-tidy-improvements.png b/docs/overview/media/clang-tidy-improvements.png new file mode 100644 index 00000000000..fe999aa5360 Binary files /dev/null and b/docs/overview/media/clang-tidy-improvements.png differ diff --git a/docs/overview/media/cmake-intellisense.png b/docs/overview/media/cmake-intellisense.png new file mode 100644 index 00000000000..7f55a9ca39b Binary files /dev/null and b/docs/overview/media/cmake-intellisense.png differ diff --git a/docs/overview/media/cmake-module-intellisense.png b/docs/overview/media/cmake-module-intellisense.png new file mode 100644 index 00000000000..0d66cfc4df8 Binary files /dev/null and b/docs/overview/media/cmake-module-intellisense.png differ diff --git a/docs/overview/media/cpp-preprocess-menu-entry.png b/docs/overview/media/cpp-preprocess-menu-entry.png new file mode 100644 index 00000000000..59f45d3bc6a Binary files /dev/null and b/docs/overview/media/cpp-preprocess-menu-entry.png differ diff --git a/docs/overview/media/inline-post-return-value.png b/docs/overview/media/inline-post-return-value.png new file mode 100644 index 00000000000..cace675c49f Binary files /dev/null and b/docs/overview/media/inline-post-return-value.png differ diff --git a/docs/overview/media/model-picker.png b/docs/overview/media/model-picker.png new file mode 100644 index 00000000000..287be12cea6 Binary files /dev/null and b/docs/overview/media/model-picker.png differ diff --git a/docs/overview/media/vs2022-copilot-comment-example.png b/docs/overview/media/vs2022-copilot-comment-example.png new file mode 100644 index 00000000000..523959124d4 Binary files /dev/null and b/docs/overview/media/vs2022-copilot-comment-example.png differ diff --git a/docs/overview/media/vs2022-copilot-edit-session-example.png b/docs/overview/media/vs2022-copilot-edit-session-example.png new file mode 100644 index 00000000000..4d154f0bd08 Binary files /dev/null and b/docs/overview/media/vs2022-copilot-edit-session-example.png differ diff --git a/docs/overview/media/vs2022-copilot-edit-session.png b/docs/overview/media/vs2022-copilot-edit-session.png new file mode 100644 index 00000000000..d4a5e14951c Binary files /dev/null and b/docs/overview/media/vs2022-copilot-edit-session.png differ diff --git a/docs/overview/media/vs2022-copilot-git-changes-review.png b/docs/overview/media/vs2022-copilot-git-changes-review.png new file mode 100644 index 00000000000..b42accbd5fd Binary files /dev/null and b/docs/overview/media/vs2022-copilot-git-changes-review.png differ diff --git a/docs/overview/msvc-conformance-improvements.md b/docs/overview/msvc-conformance-improvements.md new file mode 100644 index 00000000000..e9f57255dfa --- /dev/null +++ b/docs/overview/msvc-conformance-improvements.md @@ -0,0 +1,272 @@ +--- +title: "/C++ Conformance improvements, behavior changes, and bug fixes in Microsoft C++ (MSVC) Build Tools" +description: "Summary of conformance improvements in Microsoft C/C++ (MSVC)" +ms.date: 11/03/2025 +ms.service: "visual-cpp" +ms.subservice: "cpp-lang" +--- +# C/C++ Conformance improvements, behavior changes, and bug fixes in Microsoft C++ (MSVC) Build Tools + +Microsoft C++ (MSVC) Build Tools makes conformance improvements and bug fixes in every release. Starting with Visual Studio 2026 version 18.0, major improvements are organized by MSVC Build Tools version number. To jump directly to the changes for a specific version, use the **In this article** links at the top of this article. + +For changes in earlier versions of Visual Studio: + +| Version | Conformance improvements link | +|---|---| +| 2022 | [C++ conformance improvements in Visual Studio 2022](cpp-conformance-improvements.md) | +| 2019 | [C++ conformance improvements in Visual Studio 2019](cpp-conformance-improvements-2019.md) | +| 2017 | [C++ conformance improvements in Visual Studio 2017](cpp-conformance-improvements-2017.md) | +| 2003-2015 | [Visual C++ What's New 2003 through 2015](../porting/visual-cpp-what-s-new-2003-through-2015.md) | + +## C++ conformance improvements, behavior changes, and bug fixes in MSVC Build Tools v14.50 + +MSVC Build Tools v14.50 introduces improvements to the MSVC compiler and standard library, including better C++23 standards conformance, enhanced reliability, and improved correctness. This release also includes numerous bug fixes and updates that benefit large-scale C++ development. + +This version shipped first with Visual Studio 2026 version 18.0 and includes version 19.50 of the MSVC compiler. + +Key highlights of this release include: +- Advanced C++23 feature support including `auto(x)` decay-copy and `#warning` directive. +- Comprehensive `constexpr` improvements, particularly for virtual functions. +- Major stability improvements for C++ modules. +- Extensive reliability fixes reducing internal compiler errors. +- Enhanced C++/CLI support for managed code scenarios. +- The Microsoft C++ standard library (MSVC STL) no longer supports targeting Windows 7/Server 2008 R2, Windows 8/Server 2012, or Windows 8.1/Server 2012 R2. +- Windows 10/Server 2016 are the minimum supported operating systems. + +For more information about performance improvements, bug fixes, and conformance updates in the standard library, see [STL Changelog](https://github.com/microsoft/STL/wiki/Changelog), which is updated regularly. + +## C++23 Features + +MSVC Build Tools v14.50 adds support for several C++23 features, bringing the compiler closer to full C++23 conformance. + +### P0849R8: auto(x) - decay-copy in the language + +[P0849R8](https://www.open-std.org/jtc1/sc22/wg21/docs/papers/2021/p0849r8.html) introduces the `auto(x)` syntax for decay-copy operations directly in the language, providing a more concise way to express decay-copy semantics. + +Before P0849R8, you needed to explicitly perform decay operations: + +```cpp +// Before P0849R8: +void pop_front_alike(auto& x) +{ + using T = std::decay_t; + std::erase(x, T(x.front())); +} +``` + +After P0849R8, you can use the simpler `auto(x)` syntax: + +```cpp +// After P0849R8: +void pop_front_alike(auto& x) +{ + std::erase(x, auto(x.front())); +} +``` + +This feature provides a standardized way to perform decay-copy operations, making code more readable and reducing the need for verbose template metaprogramming. + +### P2437R1: C++23 `#warning` directive + +[P2437R1](https://www.open-std.org/jtc1/sc22/wg21/docs/papers/2022/p2437r1.pdf) implements the C++23 `#warning` preprocessor directive, providing a standard way to emit warnings during compilation. + +```cpp +// Valid before C++23. +#error bad configuration... + +// Valid after C++23. +#warning configuration deprecated... +``` + +The `#warning` directive allows you to emit diagnostic messages without stopping compilation, making it useful for deprecation notices and configuration warnings. For more information, see [#warning directive (C/C++)](/cpp/preprocessor/hash-warning-directive-c-cpp). + +### CWG Issue 2586: Explicit object parameter for assignment and comparison + +[CWG Issue 2586](https://cplusplus.github.io/CWG/issues/2586) allows explicit object parameters in assignment and comparison operators, enabling more flexible operator definitions. + +```cpp +struct S +{ + S& operator=(this S&, const S&) = default; // Valid after CWG2586. + auto operator<=>(this const S&, const S&) = default; // Valid after CWG2586. +}; +``` + +This change allows you to use the explicit object parameter syntax (deducing `this`) in assignment and comparison operators, providing more consistent syntax across different types of member functions. + +### P2266R1 : Simpler implicit move + +The introduction of [P2266R1](https://www.open-std.org/jtc1/sc22/wg21/docs/papers/2021/p2266r1.html) may cause code that was previously treated as an lvalue to be treated as an xvalue or a prvalue. For example: + +```cpp +#include + +template +T& f(T&& t) +{ + return t; +} + +struct S { }; + +void g() +{ + S s1{ }; + S& s2 = f(std::move(s1)); +} +``` + +In C++20, and earlier, this code compiled because even though the type of `t` is `S&&` the use of `t` in `return t` is treated as a glvalue and so it can bind to the return type.\ +With C++23, `t` is treated as an xvalue and so it can't bind to an lvalue reference.\ +One fix is to change to the return type of the function from `T&` to `T&&` but this may affect code that calls this function. An alternative is to use the feature test macro that is associated with this change. For example: + +```cpp +#include + +template +T& f(T&& t) +{ +#if defined(__cpp_implicit_move) + return static_cast&>(t); +#else + return t; +#endif +} +``` + +Adding the cast means that the value-category of the return expression is now an lvalue and so it can bind to the return type. + +### P2280R4: References to unknown values during constant evaluation + +[P2280R4](https://www.open-std.org/jtc1/sc22/wg21/docs/papers/2022/p2280r4.html) allows references to unknown values during constant evaluation, relaxing restrictions on `constexpr` evaluation. + +```cpp +template +constexpr size_t array_size(T (&)[N]) +{ + return N; +} + +void check(int const (¶m)[3]) +{ + constexpr auto s2 = array_size(param); // Previously ill-formed, now accepted as a constant expression after P2280R4. +} +``` + +This improvement allows more code to be evaluated at compile time, particularly when dealing with function parameters in template contexts. + +## Conformance enhancements + +Improved adherence to C++ standards includes better handling of attributes, templates, and C++20/C++23 features. + +### Attribute support + +- Added support for [`[[maybe_unused]]` on labels](https://developercommunity.visualstudio.com/t/unreferenced-label-when-ref-hidden-by-if/102076). +- Fixed warning C4102 (unreferenced label) when the only reference was from a discarded `if constexpr` branch. + +### Template and specialization fixes + +- [Diagnosed ill-formed friend explicit specializations](https://developercommunity.visualstudio.com/t/Defining-explicit-function-template-spec/10933841) that were incorrectly accepted in C++20 or later. +- Added `/Zc:enumEncoding` switch to [correctly encode enum nontype template parameters](https://developercommunity.visualstudio.com/t/Overload-resolution-fails-for-enum-non-t/10398088). +- Fixed issues with [missing 'template' keyword diagnostics](https://developercommunity.visualstudio.com/t/No-diagnostic-for-missing-template-in-d/10501221) + +### C++20 and C++23 Features + +- Enhanced [multidimensional `operator[]` support](https://developercommunity.visualstudio.com/t/Multidimensional-operator-with-Wall-r/10876026) +- Improved [concept and constraint evaluation](https://developercommunity.visualstudio.com/t/VS-1714-if-constexpr-requires--does/10905731) + +### Smaller conformance updates + +MSVC Build Tools v14.50 includes numerous smaller conformance improvements that enhance C++ standard compliance: + +- [CWG2635](https://cplusplus.github.io/CWG/issues/2635): Constrained structured bindings support +- [CWG2465](https://cplusplus.github.io/CWG/issues/2465): Coroutine parameters passed to promise constructor improvements +- [CWG2496](https://cplusplus.github.io/CWG/issues/2496): Ref-qualifiers and virtual overriding corrections +- [CWG2506](https://cplusplus.github.io/CWG/issues/2506): Structured bindings and array cv-qualifiers fixes +- [CWG2507](https://cplusplus.github.io/CWG/issues/2507): Default arguments for `operator[]` support +- [CWG2585](https://cplusplus.github.io/CWG/issues/2585): Behavior alignment with standard requirements +- [CWG2521](https://cplusplus.github.io/CWG/issues/2521): Deprecation of 'operator string-literal identifier' +- [CWG2528](https://cplusplus.github.io/CWG/issues/2528): Relaxed conversion rules for the spaceship operator +- [P2360R0](https://www.open-std.org/jtc1/sc22/wg21/docs/papers/2021/p2360r0.html): Extended init-statement definition to allow alias-declarations +- [P2290R3](https://www.open-std.org/jtc1/sc22/wg21/docs/papers/2022/p2290r3.pdf): C++23 hexadecimal/octal delimited escape sequence support in string literals +- [P2797R0](https://www.open-std.org/jtc1/sc22/wg21/docs/papers/2023/p2797r0.html): Resolution for CWG2692 regarding static and explicit object member functions with the same parameter-type-lists +- [P2266R3](https://www.open-std.org/jtc1/sc22/wg21/docs/papers/2022/p2266r3.html): Simpler implicit move semantics + +## Bug fixes + +Bug fixes for C++ Modules, `constexpr`, and other fixes were made in MSVC Build Tools v14.50. + +For a detailed list of bug fixes, see [Compiler Improvements in v14.50](https://devblogs.microsoft.com/cppblog/c-language-updates-in-msvc-build-tools-v14-50/#compiler-improvements-in-v14.50). + +**Encoding of certain nontype template arguments corrected** + +Affects `/std:c++20` or later. + +Certain nontype pointer type template arguments involving subobjects could lead to linking issues or in some cases silent bad code generation where what should be distinct specializations collide. + +```cpp +struct A +{ + int x; +}; + +struct B +{ + int y; +}; + +template void f(); + +int main() +{ + static A a; + static B b; + constexpr auto px = &a.x; + constexpr auto py = &b.y; + f(); // incorrect encoding of argument 'px' + f(); // incorrect encoding of argument 'py', collided with 'px'. +} +``` + +With this fix, the two calls to `f` get distinct encodings, as required. + +## Migrating to MSVC Build Tools v14.50 + +When upgrading to MSVC Build Tools v14.50, consider the following potential breaking changes and migration guidance: + +### C++23 feature adoption +- Update code to take advantage of new `auto(x)` decay-copy syntax for cleaner template code +- Consider using `#warning` directives for deprecation notices instead of error-prone conditional compilation +- Review explicit object parameter usage in operators for improved consistency + +### `constexpr` improvements +- Existing `constexpr` code may now compile that previously failed, particularly with virtual functions +- Review constant evaluation code for potential new optimization opportunities +- Update CRTP patterns that may now work correctly with static constexpr members + +### Modules migration +- Projects using C++20 modules should see improved stability and compatibility +- Header units now work more reliably with large codebases like Unreal Engine 5 +- Consider migrating from traditional headers to modules for better compilation performance + +### Compiler diagnostics +- New warnings may appear for previously undiagnosed issues +- Review enum type usage if using `/Zc:enumTypes` +- Update code that relies on implicit conversions that may now be flagged + +### C code updates +- C23 features are available with `/std:clatest` +- `typeof` behavior changes may affect existing code +- Review preprocessor usage for new `__VA_OPT__` availability + +## Provide feedback + +For the latest updates and to provide feedback, visit the [Visual Studio Developer Community](https://developercommunity.visualstudio.com/) or contact the team at [visualcpp@microsoft.com](mailto:visualcpp@microsoft.com). Follow us on X [@visualc](https://x.com/visualc) or BlueSky [@msftcpp.bsky.social](https://bsky.app/profile/msftcpp.bsky.social). + +If you encounter problems with MSVC in Visual Studio 2026, please let us know via the [Report a Problem](how-to-report-a-problem-with-the-visual-cpp-toolset.md) option, either from the installer or the Visual Studio IDE itself. + +## See also + +[Microsoft C/C++ language conformance](visual-cpp-language-conformance.md)\ +[What's new for C++ in Visual Studio](what-s-new-for-visual-cpp-in-visual-studio.md)\ +[C++ conformance improvements in Visual Studio 2022](cpp-conformance-improvements.md) \ No newline at end of file diff --git a/docs/overview/overview-of-cpp-development.md b/docs/overview/overview-of-cpp-development.md index 8032f92a349..ac46ec8f83c 100644 --- a/docs/overview/overview-of-cpp-development.md +++ b/docs/overview/overview-of-cpp-development.md @@ -1,7 +1,7 @@ --- title: "Overview of C++ development in Visual Studio" -description: "The Visual Studio IDE supports C++ development on Windows, Linux, Android and iOS with a code editor, debugger, test frameworks, static analyzers, and other programming tools." -ms.date: "12/02/2019" +description: "The Visual Studio IDE supports C++ development on Windows and Linux with a code editor, debugger, test frameworks, static analyzers, and other programming tools." +ms.date: 12/02/2019 helpviewer_keywords: ["Visual C++, development tools"] author: "tylermsft" ms.author: "twhitney" @@ -44,13 +44,13 @@ Source control enables you to coordinate work among multiple developers, isolate ::: moniker range=">=msvc-160" -![Screenshot of the Team Explorer window in Visual Studio 2019.](media/vs2019-team-explorer.png ) +![Screenshot of the Team Explorer window in Visual Studio 2019.](media/vs2019-team-explorer.png) ::: moniker-end ::: moniker range="<=msvc-150" -![Screenshot of the Team Explorer window in Visual Studio 2017.](media/vs2017-team-explorer.png ) +![Screenshot of the Team Explorer window in Visual Studio 2017.](media/vs2017-team-explorer.png) ::: moniker-end @@ -110,7 +110,7 @@ For more information, see [Verifying Code by Using Unit Tests](/visualstudio/tes ## Analyze -Visual Studio includes static code analysis tools that can detect potential problems in your source code. These tools include an implementation of the [C++ Core Guidelines](https://github.com/isocpp/CppCoreGuidelines/blob/master/CppCoreGuidelines.md) rules checkers. For more information, see [Code analysis for C/C++ overview](../code-quality/code-analysis-for-c-cpp-overview.md). +Visual Studio includes static code analysis tools that can detect potential problems in your source code. These tools include an implementation of the [C++ Core Guidelines](https://isocpp.github.io/CppCoreGuidelines/CppCoreGuidelines) rules checkers. For more information, see [Code analysis for C/C++ overview](../code-quality/code-analysis-for-c-cpp-overview.md). ## Deploy completed applications diff --git a/docs/overview/supported-platforms-visual-cpp.md b/docs/overview/supported-platforms-visual-cpp.md index 8c6f293023c..afcfd94885f 100644 --- a/docs/overview/supported-platforms-visual-cpp.md +++ b/docs/overview/supported-platforms-visual-cpp.md @@ -1,47 +1,56 @@ --- -description: "Learn more about: Supported Platforms (Visual C++)" -title: "Supported Platforms (Visual C++)" -ms.date: 11/09/2021 +description: "Learn more about: Supported Platforms (Microsoft C++)" +title: "Supported Platforms (Microsoft C++)" +ms.date: 10/22/2025 ms.service: "visual-cpp" ms.subservice: "tools" helpviewer_keywords: ["Visual C++, platforms supported", "platforms [C++]"] --- -# Supported platforms (Visual C++) +# Supported platforms (Microsoft C++) Apps built by using Visual Studio can be targeted to various platforms. +Support for targeting 32-bit ARM was permanently removed in VS 2026 18.0. + ## Visual Studio target OS and architecture support -| Operating System | x86 | x64 | ARM | ARM64a | -|--|--|--|--|--| -| Windows XP b | X | X | | | -| Windows Vista | X | X | | | -| Windows 7 | X | X | | | -| Windows 8 | X | X | X | | -| Windows 8.1 | X | X | X | | -| Windows 10 | X | X | X | X | -| Windows 11 | X | X | X | X | -| Windows Server 2003 b | X | X | | | -| Windows Server 2008 R2 | X | X | | | -| Windows Server 2012 R2 | X | X | | | -| Windows Server 2016 | X | X | | | -| Windows Server 2019 | X | X | | | -| Windows Server 2022 | X | X | | | -| Android c | X | X | X | X | -| iOS c | X | X | X | X | -| Linux d | X | X | X | X | +| Operating System | x86 | x64 | ARM64a | +|--|--|--|--| +| Windows XP b | X | X | | +| Windows Vistac | X | X | | +| Windows 7d | X | X | | +| Windows 8d | X | X | | +| Windows 8.1d | X | X | | +| Windows 10 | X | X | X | +| Windows 11 | X | X | X | +| Windows Server 2003 b | X | X | | +| Windows Server 2008d | X | X | | +| Windows Server 2008 R2d | X | X | | +| Windows Server 2012d | X | X | | +| Windows Server 2012 R2d | X | X | | +| Windows Server 2016 | X | X | | +| Windows Server 2019 | X | X | | +| Windows Server 2022 | X | X | | +| Windows Server 2025 | X | X | | +| Android e | X | X | X | +| iOS e | | | X | +| Linux f | X | X | X | a ARM64 support is available in Visual Studio 2017 and later. -b You can use the Windows XP platform toolsets included in Visual Studio 2017, Visual Studio 2015, Visual Studio 2013, and Visual Studio 2012 Update 1 to build Windows XP and Windows Server 2003 projects. For information on how to use these platform toolsets, see [Configuring Programs for Windows XP](../build/configuring-programs-for-windows-xp.md). For more information on changing the platform toolset, see [How to: Modify the Target Framework and Platform Toolset](../build/how-to-modify-the-target-framework-and-platform-toolset.md). +b Visual Studio no longer supports targeting Windows XP. Use the Windows XP platform toolsets included in Visual Studio 2017, Visual Studio 2015, Visual Studio 2013, and Visual Studio 2012 Update 1 to build Windows XP and Windows Server 2003 projects. + +c Visual Studio 2022 17.0 and later no longer support targeting Windows Vista or Windows Server 2008. + +d Visual Studio 2026 18.0 and later no longer support targeting Windows 7/8/8.1 or Windows Server 2008 R2/2012/2012 R2. Visual Studio 2026 and later target Windows 10 or later and Windows Server 2016 or later. -c You can install the **Mobile development with C++** workload in the installer for Visual Studio 2017 and later. In Visual Studio 2015 setup, choose the optional **Visual C++ for Cross Platform Mobile Development** component to target iOS or Android platforms. For instructions, see [Install Visual C++ for Cross-Platform Mobile Development](/visualstudio/cross-platform/install-visual-cpp-for-cross-platform-mobile-development). To build iOS code, you must have a Mac computer and meet other requirements. For a list of prerequisites and installation instructions, see [Install And Configure Tools to Build using iOS](/visualstudio/cross-platform/install-and-configure-tools-to-build-using-ios). You can build x86 or ARM code to match the target hardware. Use x86 configurations to build for some Android devices. Use ARM configurations to build for iOS devices and most Android devices. +e You can install the **Mobile development with C++** workload in the installer for Visual Studio 2017 and later. In Visual Studio 2015 setup, choose the optional **Visual C++ for Cross Platform Mobile Development** component to target iOS or Android platforms. For instructions, see [Install Visual C++ for Cross-Platform Mobile Development](/visualstudio/cross-platform/install-visual-cpp-for-cross-platform-mobile-development). To build iOS code, you must have a Mac computer and meet other requirements. For a list of prerequisites and installation instructions, see [Install And Configure Tools to Build using iOS](/visualstudio/cross-platform/install-and-configure-tools-to-build-using-ios). You can build x86 or ARM code to match the target hardware. Use x86 configurations to build for some Android devices. Use ARM configurations to build for iOS devices and most Android devices. **IMPORTANT**: Starting with Visual Studio 2026 (version 18.0), the **Mobile development with C++** workload for iOS and Android targeting in the Visual Studio installer and the **Embedded and IoT tools**--including RTOS Viewer, Serial Monitor, Peripheral Viewer, and ST Project Import--are no longer supported and will be removed in a future update. However, the Android NDKs listed in the Mobile development with C++ workload continue to be supported. -d You can install the **Linux development with C++** workload in the installer for Visual Studio 2017 and later to target Linux platforms. For instructions, see [Download, install, and setup the Linux Workload](../linux/download-install-and-setup-the-linux-development-workload.md). This toolset compiles your executable on the target machine, so you can build for any supported architecture. +f You can install the **Linux development with C++** workload in the installer for Visual Studio 2017 and later to target Linux platforms. For instructions, see [Download, install, and setup the Linux Workload](../linux/download-install-and-setup-the-linux-development-workload.md). This toolset compiles your executable on the target machine, so you can build for any supported architecture. -For information about how to set the target platform configuration, see [How to: Configure Visual C++ projects to target 64-bit, x64 platforms](../build/how-to-configure-visual-cpp-projects-to-target-64-bit-platforms.md). +For information about how to set the target platform configuration, see [How to: Configure Microsoft C++ projects to target 64-bit, x64 platforms](../build/how-to-configure-visual-cpp-projects-to-target-64-bit-platforms.md). ## See also -[Visual C++ tools and features in Visual Studio editions](visual-cpp-tools-and-features-in-visual-studio-editions.md)\ +[Microsoft C++ tools and features in Visual Studio editions](visual-cpp-tools-and-features-in-visual-studio-editions.md)\ [Getting Started](/visualstudio/ide/getting-started-with-cpp-in-visual-studio) diff --git a/docs/overview/toc.yml b/docs/overview/toc.yml index eb098aa4809..39072bdc2eb 100644 --- a/docs/overview/toc.yml +++ b/docs/overview/toc.yml @@ -6,14 +6,16 @@ items: href: ../overview/visual-cpp-in-visual-studio.md - name: Overview of C++ development in Visual Studio href: ../overview/overview-of-cpp-development.md + - name: What's new for MSVC Build Tools + href: ../overview/what-s-new-for-msvc.md - name: What's new for C++ in Visual Studio 2022 href: ../overview/what-s-new-for-visual-cpp-in-visual-studio.md - name: What's new for C++ in Visual Studio 2019 href: ../overview/what-s-new-for-cpp-2019.md - name: What's new for C++ in Visual Studio 2017 href: ../overview/what-s-new-for-cpp-2017.md - - name: What's new for Microsoft C++ docs - href: ../overview/whats-new-cpp-docs.md + - name: C/C++ conformance improvements in Microsoft C++ (MSVC) Build Tools + href: ../overview/msvc-conformance-improvements.md - name: C++ conformance improvements in Visual Studio 2022 href: ../overview/cpp-conformance-improvements.md - name: C++ conformance improvements in Visual Studio 2019 @@ -34,7 +36,7 @@ items: href: ../overview/visual-cpp-samples.md - name: Help and community href: ../overview/visual-cpp-help-and-community.md - - name: How to report a problem with the Visual C++ toolset + - name: How to report a problem with the Microsoft C++ Build Tools href: ../overview/how-to-report-a-problem-with-the-visual-cpp-toolset.md - name: Visual Studio C++ Tutorials expanded: false diff --git a/docs/overview/visual-cpp-in-visual-studio.md b/docs/overview/visual-cpp-in-visual-studio.md index 30012947cad..111b4036a69 100644 --- a/docs/overview/visual-cpp-in-visual-studio.md +++ b/docs/overview/visual-cpp-in-visual-studio.md @@ -44,9 +44,9 @@ helpviewer_keywords: ["Visual C++, home page"] :::moniker-end -Microsoft Visual C++ (MSVC) refers to the C++, C, and assembly language development tools and libraries available as part of Visual Studio on Windows. These tools and libraries let you create native Windows desktop and server applications, Universal Windows Platform (UWP) apps, or managed apps and libraries that use the .NET Framework. Create cross-platform libraries and apps that run on Windows, Linux, Android, and iOS. You can use MSVC to write anything from simple console apps to the most sophisticated and complex apps for Windows desktop. Write device drivers and operating system components or cross-platform games for mobile devices. Target anything from the smallest IoT devices to multi-server high performance computing in the Azure cloud. +Microsoft C++ (MSVC) refers to the C++, C, and assembly language development tools and libraries available as part of Visual Studio on Windows. These tools and libraries let you create native Windows desktop and server applications, Universal Windows Platform (UWP) apps, or managed apps and libraries that use the .NET Framework. Create cross-platform libraries and apps that run on Windows, Linux, Android, and iOS. You can use MSVC to write anything from simple console apps to the most sophisticated and complex apps for Windows desktop. Write device drivers and operating system components or cross-platform games for mobile devices. Target anything from the smallest IoT devices to multi-server high performance computing in the Azure cloud. -Visual Studio 2015, 2017, 2019, and 2022 can be installed side-by-side. You can use Visual Studio 2019 (compiler toolset v142) or Visual Studio 2017 (v141) to edit and build programs using the toolset from Visual Studio 2017 (v141) and Visual Studio 2015 (v140). +You can install Visual Studio 2015 and later side-by-side. For example, you can use Visual Studio 2019 (compiler toolset v142) or Visual Studio 2017 (v141) to edit and build programs using the toolset from Visual Studio 2017 (v141) and Visual Studio 2015 (v140). ## What's new for C++ in Visual Studio @@ -74,7 +74,7 @@ Learn about the breaking changes in previous versions. ## Install Visual Studio C++ and upgrade from earlier versions [Install C++ support in Visual Studio](../build/vscpp-step-0-installation.md)\ -Download Visual Studio and install the Microsoft C/C++ toolset. +Download Visual Studio and install the Microsoft C++ Build Tools. [Microsoft C++ porting and upgrading guide](../porting/visual-cpp-porting-and-upgrading-guide.md)\ Guidance for porting code and upgrading projects to Visual Studio 2015 or later. Take advantage of greater compiler conformance to the C++ standard, greatly improved compilation times, and security features such as Spectre mitigation. diff --git a/docs/overview/visual-cpp-language-conformance.md b/docs/overview/visual-cpp-language-conformance.md index f24433753c9..ed623aaf45c 100644 --- a/docs/overview/visual-cpp-language-conformance.md +++ b/docs/overview/visual-cpp-language-conformance.md @@ -1,7 +1,7 @@ --- title: "Microsoft C/C++ language conformance" description: "Microsoft C and C++ conformance updates by Visual Studio version." -ms.date: 03/01/2023 +ms.date: 11/10/2025 ms.service: "visual-cpp" ms.subservice: "cpp-lang" --- @@ -9,7 +9,7 @@ ms.subservice: "cpp-lang" Standards conformance for the Microsoft C/C++ compiler in Visual Studio (MSVC) is a work in progress. Here's a summary of ISO Standard C and C++ language and library conformance by Visual Studio version. Each C++ compiler and standard library feature name has a link to the ISO Standard C++ proposal paper that describes the feature, when one is available at publication time. The **Supported** column lists the Visual Studio version in which support for the feature first appeared. -For details on conformance improvements, see [C++ conformance improvements in Visual Studio](cpp-conformance-improvements.md). For a list of other changes, see [What's New for Visual C++ in Visual Studio](what-s-new-for-visual-cpp-in-visual-studio.md). For conformance changes in earlier versions, see [Visual C++ change history](../porting/visual-cpp-change-history-2003-2015.md) and [Visual C++ What's New 2003 through 2015](../porting/visual-cpp-what-s-new-2003-through-2015.md). For current news from the C++ team, visit the [C++ team blog](https://devblogs.microsoft.com/cppblog/). +For details on conformance improvements, see [C++ conformance improvements in Visual Studio](cpp-conformance-improvements.md). For a list of other changes, see [What's New for Microsoft C++ in Visual Studio](what-s-new-for-visual-cpp-in-visual-studio.md). For conformance changes in earlier versions, see [Visual C++ change history](../porting/visual-cpp-change-history-2003-2015.md) and [Visual C++ What's New 2003 through 2015](../porting/visual-cpp-what-s-new-2003-through-2015.md). For current news from the C++ team, visit the [C++ team blog](https://devblogs.microsoft.com/cppblog/). > [!NOTE] > There are no binary breaking changes between Visual Studio 2015, 2017, 2019, and 2022. For more information, see [C++ binary compatibility between Visual Studio versions](../porting/binary-compat-2015-2017.md) @@ -174,57 +174,60 @@ For details on conformance improvements, see [C++ conformance improvements in Vi |  [`P1073R3 Immediate functions`](https://wg21.link/P1073R3) | VS 2019 16.10 [20](#note_20) | |  [`P1143R2 constinit`](https://wg21.link/P1143R2) | VS 2019 16.10 [20](#note_20) | |  [`P1353R0 Missing feature-test macros`](https://wg21.link/P1353R0) | VS 2019 16.10 [20](#note_20) | -|  [`P0735R1 Interaction of memory_order_consume with release sequences`](https://wg21.link/P0735R1) | N/A | -|  [`P1236R1 Signed integers are two's complement`](https://wg21.link/P1236R1) | N/A | +|  [`P0735R1 Interaction of memory_order_consume with release sequences`](https://wg21.link/P0735R1) | VS 2022 v17.14 | +|  [`P1236R1 Signed integers are two's complement`](https://wg21.link/P1236R1) | VS 2022 v17.14 | | **C++23 Core language features** | **Supported** | -|  [`P0330R8 Literal Suffix for (signed) size_t`](https://wg21.link/p0330r8) | no | -|  [`P0847R7 Deducing this`](https://wg21.link/p0847r7) | no | -|  [`P0849R8 auto(x): decay-copy in the language`](https://wg21.link/p0849r8) | no | -|  [`P1102R2 Down with ()!`](https://wg21.link/p1102r2) | no | -|  [`P1169R4 static operator()`](https://wg21.link/p1169r4) | no | -|  [`P1401R5 Narrowing contextual conversions to bool`](https://wg21.link/p1401r5) | no | -|  [`P1467R9 Extended floating-point types and standard names`](https://wg21.link/p1467r9) | no | +|  [`P0330R8 Literal Suffix for (signed) size_t`](https://wg21.link/p0330r8) | VS 2022 17.13 [23](#note_23) | +|  [`P0847R7 Deducing this`](https://wg21.link/p0847r7) | VS 2022 17.13 [23](#note_23) | +|  [`P0849R8 auto(x): decay-copy in the language`](https://wg21.link/p0849r8) | MSVC Build Tools version 14.50 [24](#note_24) | +|  [`P1102R2 Down with ()!`](https://wg21.link/p1102r2) | VS 2022 17.14 [23](#note_23) | +|  [`P1169R4 static operator()`](https://wg21.link/p1169r4) | VS 2022 17.14 [23](#note_23) | +|  [`P1401R5 Narrowing contextual conversions to bool`](https://wg21.link/p1401r5) | VS 2022 17.14 [23](#note_23) | +|  [`P1467R9 Extended floating-point types and standard names`](https://wg21.link/p1467r9) | No [U](#note_U) | |  [`P1774R8 Portable assumptions`](https://wg21.link/p1774r8) | no | -|  [`P1787R6 Declarations and where to find them`](https://wg21.link/p1787r6) | no | +|  [`P1787R6 Declarations and where to find them`](https://wg21.link/p1787r6) | No change required | |  [`P1847R4 Make declaration order layout mandated`](https://wg21.link/p1847r4) | VS 2022 17.0 [23](#note_23) | -|  [`P1938R3 if consteval`](https://wg21.link/p1938r3) | no | -|  [`P1949R7 C++ Identifier Syntax using Unicode Standard Annex 31`](https://wg21.link/p1949r7) | no | +|  [`P1938R3 if consteval`](https://wg21.link/p1938r3) | VS 2022 17.14 [23](#note_23) | +|  [`P1949R7 C++ Identifier Syntax using Unicode Standard Annex 31`](https://wg21.link/p1949r7) | MSVC Build Tools version 14.50 [24](#note_24) | |  [`P2029R4 Proposed resolution for core issues 411, 1656, and 2333; numeric and universal character escapes in character and string literals`](https://wg21.link/p2029r4) | no | -|  [`P2036R3 Change scope of lambda trailing-return-type`](https://wg21.link/p2036r3) | no | +|  [`P2036R3 Change scope of lambda trailing-return-type`](https://wg21.link/p2036r3) | MSVC Build Tools version 14.50 [24](#note_24) | |  [`P2071R2 Named universal character escapes`](https://wg21.link/p2071r2) | no | -|  [`P2128R6 Multidimensional subscript operator`](https://wg21.link/p2128r6) | no | -|  [`P2156R1 Allow Duplicate Attributes`](https://wg21.link/p2156r1) | no | -|  [`P2173R1 Attributes on Lambda-Expressions`](https://wg21.link/p2173r1) | no | +|  [`P2128R6 Multidimensional subscript operator`](https://wg21.link/p2128r6) | VS 2022 17.12 [23](#note_23) | +|  [`P2156R1 Allow Duplicate Attributes`](https://wg21.link/p2156r1) | MSVC Build Tools version 14.50 [24](#note_24) | +|  [`P2173R1 Attributes on Lambda-Expressions`](https://wg21.link/p2173r1) | VS 2022 17.14 [23](#note_23) | |  [`P2186R2 Remove Garbage Collection Support`](https://wg21.link/p2186r2) | VS 2022 17.0 [23](#note_23) | -|  [`P2201R1 Mixed string literal concatenation`](https://wg21.link/p2201r1) | no | -|  [`P2223R2 Trimming whitespaces before line splicing`](https://wg21.link/p2223r2) | no | -|  [`P2242R3 Non-literal variables (and labels and gotos) in constexpr functions`](https://wg21.link/p2242r3) | no | +|  [`P2201R1 Mixed string literal concatenation`](https://wg21.link/p2201r1) | VS 2022 17.14 | +|  [`P2223R2 Trimming whitespaces before line splicing`](https://wg21.link/p2223r2) | MSVC Build Tools version 14.50 [24](#note_24) | +|  [`P2242R3 Non-literal variables (and labels and gotos) in constexpr functions`](https://wg21.link/p2242r3) | VS 2022 17.14 [23](#note_23) | |  [`P2246R1 Character encoding of diagnostic text`](https://wg21.link/p2246r1) | VS 2022 17.0 [23](#note_23) | -|  [`P2266R3 Simpler implicit move`](https://wg21.link/p2266r3) | no | -|  [`P2280R4 Using unknown pointers and references in constant expressions`](https://wg21.link/p2280r4) | no | -|  [`P2290R3 Delimited escape sequences`](https://wg21.link/p2290r3) | no | -|  [`P2295R6 Support for UTF-8 as a portable source file encoding`](https://wg21.link/p2295r6) | no | +|  [`P2266R3 Simpler implicit move`](https://wg21.link/p2266r3) | MSVC Build Tools version 14.50 [24](#note_24) | +|  [`P2280R4 Using unknown pointers and references in constant expressions`](https://wg21.link/p2280r4) | MSVC Build Tools version 14.50 [24](#note_24) | +|  [`P2290R3 Delimited escape sequences`](https://wg21.link/p2290r3) | MSVC Build Tools version 14.50 [24](#note_24) | +|  [`P2295R6 Support for UTF-8 as a portable source file encoding`](https://wg21.link/p2295r6) | [V](#note_V) | |  [`P2314R4 Character sets and encodings`](https://wg21.link/p2314r4) | no | |  [`P2316R2 Consistent character literal encoding`](https://wg21.link/p2316r2) | VS 2022 17.0 [23](#note_23) | |  [`P2324R2 Labels at the end of compound statements (C compatibility)`](https://wg21.link/p2324r2) | no | -|  [`P2327R1 De-deprecating volatile compound operations`](https://wg21.link/p2327r1) | no | -|  [`P2334R1 preprocessing directives elifdef and elifndef`](https://wg21.link/p2334r1) | no | -|  [`P2360R0 Extend init-statement to allow alias-declaration`](https://wg21.link/p2360r0) | no | +|  [`P2327R1 De-deprecating volatile compound operations`](https://wg21.link/p2327r1) | VS 2022 v17.14 | +|  [`P2334R1 preprocessing directives elifdef and elifndef`](https://wg21.link/p2334r1) | VS 2022 17.10 [23](#note_23) | +|  [`P2360R0 Extend init-statement to allow alias-declaration`](https://wg21.link/p2360r0) | MSVC Build Tools version 14.50 [24](#note_24) | |  [`P2362R3 Remove non-encodable wide character literals and multicharacter wide character literals`](https://wg21.link/p2362r3) | no | -|  [`P2437R1 Support for #warning`](https://wg21.link/p2437r1) | no | +|  [`P2437R1 Support for #warning`](https://wg21.link/p2437r1) | MSVC Build Tools version 14.50 [24](#note_24) | |  [`P2448R2 Relaxing some constexpr restrictions`](https://wg21.link/p2448r2) | no | -|  [`P2460R2 Relax requirements on wchar_t to match existing practices`](https://wg21.link/p2460r2) | no | -|  [`P2468R2 The Equality Operator You Are Looking For`](https://wg21.link/p2468r2) | no | -|  [`P2493R0 Missing feature test macros for C++20 core papers`](https://wg21.link/p2493r0) | no | -|  [`P2493R0 Missing feature test macros for C++20 core papers`](https://wg21.link/p2493r0) | no | +|  [`P2460R2 Relax requirements on wchar_t to match existing practices`](https://wg21.link/p2460r2) | VS 2022 v17.14 | +|  [`P2468R2 The Equality Operator You Are Looking For`](https://wg21.link/p2468r2) | VS 2022 17.6 [23](#note_23) | +|  [`P2493R0 Missing feature test macros for C++20 core papers`](https://wg21.link/p2493r0) | MSVC Build Tools version 14.50 [24](#note_24) | |  [`P2513R4 char8_t Compatibility and Portability Fix`](https://wg21.link/p2513r4) | VS 2022 17.4 [DR](#note_DR) | -|  [`P2579R0 Mitigation strategies for P2036 ”Changing scope for lambda trailing-return-type”`](https://wg21.link/p2579r0) | no | +|  [`P2579R0 Mitigation strategies for P2036 "Changing scope for lambda trailing-return-type"`](https://wg21.link/p2579r0) | MSVC Build Tools version 14.50 [24](#note_24) | |  [`P2582R1 Wording for class template argument deduction from inherited constructors`](https://wg21.link/p2582r1) | no | ## C++ Standard library features A more detailed listing of Standard Library features and bug fixes by product version is available on the [GitHub Microsoft STL wiki Changelog](https://github.com/microsoft/STL/wiki/Changelog) page. +For the latest information about ongoing conformance work, see: +- [STL C++23 Features](https://github.com/orgs/microsoft/projects/1142/views/2). +- [STL C++26 Features](https://github.com/orgs/microsoft/projects/1143/views/2). + | Feature | Supported | |--|--| | **C++14 Standard library features** | **Supported** | @@ -335,7 +338,7 @@ A more detailed listing of Standard Library features and bug fixes by product ve |  [`P0607R0 Inline Variables for the Standard Library`](https://wg21.link/p0607r0) | VS 2017 15.5 [17](#note_17) | |  [`P0618R0 Deprecating `](https://wg21.link/p0618r0) | VS 2017 15.5 [17](#note_17) | | **C++17 Standard library features (Defect reports)** | **Supported** | -|  [`P0682R1 Repairing Elementary String Conversions`](https://wg21.link/P0682R1) | VS 2015 15.7 [17](#note_17) | +|  [`P0682R1 Repairing Elementary String Conversions`](https://wg21.link/P0682R1) | VS 2017 15.7 [17](#note_17) | |  [`P1164R1 Making create_directory() Intuitive`](https://wg21.link/P1164R1) | VS 2019 16.0 [14](#note_14) | | **C++20 Standard library features** | **Supported** | |  [`P0809R0 Comparing Unordered Containers`](https://wg21.link/p0809r0) | VS 2010 [14](#note_14) | @@ -401,7 +404,7 @@ A more detailed listing of Standard Library features and bug fixes by product ve |  [`P1023R0 constexpr For std::array Comparisons`](https://wg21.link/P1023R0) | VS 2019 16.7 [20](#note_20) | |  [`P1115R3 erase()/erase_if() Return size_type`](https://wg21.link/P1115R3) | VS 2019 16.7 [20](#note_20) | |  [`P1831R1 Deprecating volatile in the standard library`](https://wg21.link/P1831R1) | VS 2019 16.7 [20](#note_20) | -|  [`P1871R1 Concept traits should be named after concepts`](https://wg21.link/P1831R1) | VS 2019 16.7 [20](#note_20) | +|  [`P1871R1 Concept traits should be named after concepts`](https://wg21.link/P1871R1) | VS 2019 16.7 [20](#note_20) | |  [`P1956R1 has_single_bit(), bit_ceil(), bit_floor(), bit_width()`](https://wg21.link/P1956R1) | VS 2019 16.7 [20](#note_20) | |  [`P1964R2 Replacing boolean With boolean-testable`](https://wg21.link/P1964R2) | VS 2019 16.7 [20](#note_20) | |  [`P1976R2 Fixed-size span construction from dynamic range`](https://wg21.link/P1976R2) | VS 2019 16.7 [20](#note_20) | @@ -439,68 +442,72 @@ A more detailed listing of Standard Library features and bug fixes by product ve |  [`P1208R6 `](https://wg21.link/P1208R6) | VS 2019 16.10 [20](#note_20) | |  [`P1502R1 Standard Library Header Units`](https://wg21.link/P1502R1) | VS 2019 16.10 [20](#note_20) | |  [`P1614R2 Adding Spaceship <=> To The Library`](https://wg21.link/P1614R2) | VS 2019 16.10 [20](#note_20) | -|  [`P1285R0 Improving Completeness Requirements For Type Traits`](https://wg21.link/P1285R0) | N/A | +|  [`P1285R0 Improving Completeness Requirements For Type Traits`](https://wg21.link/P1285R0) | VS 2022 v17.14 | | **C++20 Standard library features (Defect reports)** | **Supported** | |  [`P2325R3 Views Should Not Be Required To Be Default Constructible`](https://wg21.link/P2325r3) | VS 2022 17.0 [20abi](#note_20abi) | |  [`P2328R1 join_view should join all views of ranges`](https://wg21.link/P2328R1) | VS 2022 17.0 [20abi](#note_20abi) | |  [`P2367R0 Remove misuses of list-initialization from clause 24 ranges`](https://wg21.link/P2367R0) | VS 2022 17.0 [20abi](#note_20abi) | |  [`P2259R1 Partial LWG issue resolution: repairing Input Range Adaptors and counted_iterator`](https://wg21.link/P2259R1) | VS 2022 17.0 [23](#note_23) | | **C++23 Standard library features** | **Supported** | -|  [`P0288R9 move_only_function​`](https://wg21.link/p0288r9) | VS 2022 17.2 [23](#note_23) | -|  [`P0323R12 ​​`](https://wg21.link/p0323r12) | VS 2022 17.3 [23](#note_23) | -|  [`P0401R6 Providing Size Feedback In The Allocator Interface​`](https://wg21.link/p0401r6) | VS 2022 17.0 [23](#note_23) | -|  [`P0448R4 ​`](https://wg21.link/p0448r4) | VS 2022 17.1 [23](#note_23) | -|  [`P0627R6 unreachable()​`](https://wg21.link/p0627r6) | VS 2022 17.2 [23](#note_23) | -|  [`P0798R8 Monadic Operations For optional​`](https://wg21.link/p0798r8) | VS 2022 17.2 [23](#note_23) | -|  [`P0849R8 auto(x): decay-copy In The Language​`](https://wg21.link/p0849r8) | VS 2022 17.4 [23](#note_23) | -|  [`P0881R7 ​`](https://wg21.link/p0881r7) | VS 2022 17.4 [23](#note_23) | -|  [`P0943R6 Supporting C Atomics In C++​`](https://wg21.link/p0943r6) | VS 2022 17.1 [23](#note_23) | -|  [`P1048R1 is_scoped_enum​`](https://wg21.link/p1048r1) | VS 2022 17.0 [23](#note_23) | -|  [`P1072R10 basic_string::resize_and_overwrite​`](https://wg21.link/p1072r10) | VS 2022 17.1 [23](#note_23) | -|  [`P1132R7 out_ptr(), inout_ptr()​`](https://wg21.link/p1132r7) | VS 2022 17.0 [23](#note_23) | -|  [`P1147R1 Printing volatile Pointers​`](https://wg21.link/p1147r1) | VS 2022 17.1 [23](#note_23) | -|  [`P1206R7 Conversions From Ranges To Containers​`](https://wg21.link/p1206r7) | VS 2022 17.4 [23](#note_23) | -|  [`P1272R4 byteswap()​`](https://wg21.link/p1272r4) | VS 2022 17.1 [23](#note_23) | -|  [`P1328R1 constexpr type_info::operator==()​`](https://wg21.link/p1328r1) | VS 2022 17.4 [23](#note_23) | -|  [`P1413R3 Deprecate aligned_storage And aligned_union​​`](https://wg21.link/p1413r3) | VS 2022 17.3 [23](#note_23) | -|  [`P1425R4 Iterator Pair Constructors For stack And queue​`](https://wg21.link/p1425r4) | VS 2022 17.1 [23](#note_23) | -|  [`P1518R2 Stop Overconstraining Allocators In Container Deduction Guides​`](https://wg21.link/p1518r2) | VS 2022 17.1 [23](#note_23) | -|  [`P1659R3 ranges::starts_with, ranges::ends_with​`](https://wg21.link/p1659r3) | VS 2022 17.1 [23](#note_23) | -|  [`P1679R3 contains() For basic_string/basic_string_view​`](https://wg21.link/p1679r3) | VS 2022 17.0 [23](#note_23) | -|  [`P1682R3 to_underlying() For Enumerations​`](https://wg21.link/p1682r3) | VS 2022 17.0 [23](#note_23) | -|  [`P1899R3 views::stride​`](https://wg21.link/p1899r3) | VS 2022 17.4 [23](#note_23) | -|  [`P1951R1 Default Template Arguments For pair's Forwarding Constructor​`](https://wg21.link/p1951r1) | VS 2022 17.0 [23](#note_23) | -|  [`P1989R2 Range Constructor For string_view​`](https://wg21.link/p1989r2) | VS 2022 17.0 [23](#note_23) | -|  [`P2077R3 Heterogeneous Erasure Overloads For Associative Containers​`](https://wg21.link/p2077r3) | VS 2022 17.2 [23](#note_23) | -|  [`P2136R3 invoke_r()​`](https://wg21.link/p2136r3) | VS 2022 17.1 [23](#note_23) | +|  [`P0288R9 move_only_function`](https://wg21.link/p0288r9) | VS 2022 17.2 [23](#note_23) | +|  [`P0323R12 `](https://wg21.link/p0323r12) | VS 2022 17.3 [23](#note_23) | +|  [`P0401R6 Providing Size Feedback In The Allocator Interface`](https://wg21.link/p0401r6) | VS 2022 17.0 [23](#note_23) | +|  [`P0448R4 `](https://wg21.link/p0448r4) | VS 2022 17.1 [23](#note_23) | +|  [`P0627R6 unreachable()`](https://wg21.link/p0627r6) | VS 2022 17.2 [23](#note_23) | +|  [`P0798R8 Monadic Operations For optional`](https://wg21.link/p0798r8) | VS 2022 17.2 [23](#note_23) | +|  [`P0849R8 auto(x): decay-copy In The Language`](https://wg21.link/p0849r8) | VS 2022 17.4 [23](#note_23) | +|  [`P0881R7 `](https://wg21.link/p0881r7) | VS 2022 17.4 [23](#note_23) | +|  [`P0943R6 Supporting C Atomics In C++`](https://wg21.link/p0943r6) | VS 2022 17.1 [23](#note_23) | +|  [`P1048R1 is_scoped_enum`](https://wg21.link/p1048r1) | VS 2022 17.0 [23](#note_23) | +|  [`P1072R10 basic_string::resize_and_overwrite`](https://wg21.link/p1072r10) | VS 2022 17.1 [23](#note_23) | +|  [`P1132R7 out_ptr(), inout_ptr()`](https://wg21.link/p1132r7) | VS 2022 17.0 [23](#note_23) | +|  [`P1147R1 Printing volatile Pointers`](https://wg21.link/p1147r1) | VS 2022 17.1 [23](#note_23) | +|  [`P1206R7 Conversions From Ranges To Containers`](https://wg21.link/p1206r7) | VS 2022 17.4 [23](#note_23) | +|  [`P1272R4 byteswap()`](https://wg21.link/p1272r4) | VS 2022 17.1 [23](#note_23) | +|  [`P1328R1 constexpr type_info::operator==()`](https://wg21.link/p1328r1) | VS 2022 17.4 [23](#note_23) | +|  [`P1413R3 Deprecate aligned_storage And aligned_union`](https://wg21.link/p1413r3) | VS 2022 17.3 [23](#note_23) | +|  [`P1425R4 Iterator Pair Constructors For stack And queue`](https://wg21.link/p1425r4) | VS 2022 17.1 [23](#note_23) | +|  [`P1518R2 Stop Overconstraining Allocators In Container Deduction Guides`](https://wg21.link/p1518r2) | VS 2022 17.1 [23](#note_23) | +|  [`P1659R3 ranges::starts_with, ranges::ends_with`](https://wg21.link/p1659r3) | VS 2022 17.1 [23](#note_23) | +|  [`P1679R3 contains() For basic_string/basic_string_view`](https://wg21.link/p1679r3) | VS 2022 17.0 [23](#note_23) | +|  [`P1682R3 to_underlying() For Enumerations`](https://wg21.link/p1682r3) | VS 2022 17.0 [23](#note_23) | +|  [`P1899R3 views::stride`](https://wg21.link/p1899r3) | VS 2022 17.4 [23](#note_23) | +|  [`P1951R1 Default Template Arguments For pair's Forwarding Constructor`](https://wg21.link/p1951r1) | VS 2022 17.0 [23](#note_23) | +|  [`P1989R2 Range Constructor For string_view`](https://wg21.link/p1989r2) | VS 2022 17.0 [23](#note_23) | +|  [`P2077R3 Heterogeneous Erasure Overloads For Associative Containers`](https://wg21.link/p2077r3) | VS 2022 17.2 [23](#note_23) | +|  [`P2136R3 invoke_r()`](https://wg21.link/p2136r3) | VS 2022 17.1 [23](#note_23) | |  [`P2162R2 Inheriting from std::variant`](https://wg21.link/P2162R2) | VS 2022 17.0 [17](#note_17) | |  [`P2166R1 Prohibit basic_string and basic_string_view from being constructed from nullptr`](https://wg21.link/P2166R1) | VS 2022 17.0 [23](#note_23), [R](#note_R) | |  [`P2186R2 Removed garbage collection support`](https://wg21.link/P2186R2) | VS 2022 17.0 [23](#note_23), [Q](#note_Q) | -|  [`P2251R1 Require span And basic_string_view To Be Trivially Copyable​`](https://wg21.link/p2251r1) | VS 2022 17.1 [23](#note_23) | -|  [`P2273R3 constexpr unique_ptr​​`](https://wg21.link/p2273r3) | VS 2022 17.3 [23](#note_23) | -|  [`P2291R3 constexpr Integral ​`](https://wg21.link/p2291r3) | VS 2022 17.4 [23](#note_23) | -|  [`P2302R4 ranges::contains, ranges::contains_subrange​`](https://wg21.link/p2302r4) | VS 2022 17.4 [23](#note_23) | -|  [`P2321R2 std::zip​`](https://wg21.link/p2321r2) | partial in VS 2022 17.5 [23](#note_23) | -|  [`P2322R6 ranges::fold_left, ranges::fold_right, etc.​`](https://wg21.link/p2322r6) | VS 2022 17.5 [23](#note_23) | -|  [`P2387R3 Pipe Support For User-Defined Range Adaptors​`](https://wg21.link/p2387r3) | VS 2022 17.4 [23](#note_23) | -|  [`P2393R1 Cleaning Up Integer-Class Types​`](https://wg21.link/p2393r1) | VS 2022 17.2 [23](#note_23) | -|  [`P2401R0 Conditional noexcept For exchange()​`](https://wg21.link/p2401r0) | VS 2022 17.1 [23](#note_23) | -|  [`P2408R5 Ranges Iterators As Inputs To Non-Ranges Algorithms​`](https://wg21.link/p2408r5) | VS 2022 17.4 [23](#note_23) | -|  [`P2417R2 More constexpr bitset​`](https://wg21.link/p2417r2) | VS 2022 17.4 [23](#note_23) | -|  [`P2419R2 Clarify Handling Of Encodings In Localized Formatting Of chrono Types​`](https://wg21.link/p2419r2) | VS 2022 17.4 [23](#note_23) | -|  [`P2438R2 string::substr() &&​`](https://wg21.link/p2438r2) | VS 2022 17.4 [23](#note_23) | -|  [`P2440R1 ranges::iota, ranges::shift_left, ranges::shift_right​`](https://wg21.link/p2440r1) | VS 2022 17.4 [23](#note_23) | -|  [`P2441R2 views::join_with​`](https://wg21.link/p2441r2) | VS 2022 17.4 [23](#note_23) | -|  [`P2442R1 Windowing Range Adaptors: views::chunk, views::slide​​`](https://wg21.link/p2442r1) | VS 2022 17.3 [23](#note_23) | -|  [`P2443R1 views::chunk_by​​`](https://wg21.link/p2443r1) | VS 2022 17.3 [23](#note_23) | -|  [`P2445R1 forward_like()​`](https://wg21.link/p2445r1) | VS 2022 17.4 [23](#note_23) | -|  [`P2446R2 views::as_rvalue​`](https://wg21.link/p2446r2) | VS 2022 17.4 [23](#note_23) | -|  [`P2465R3 Standard Library Modules std And std.compat​`](https://wg21.link/p2465r3) | no | -|  [`P2494R2 Relaxing Range Adaptors To Allow Move-Only Types​`](https://wg21.link/p2494r2) | VS 2022 17.4 [23](#note_23) | -|  [`P2499R0 string_view Range Constructor Should Be explicit​`](https://wg21.link/p2499r0) | VS 2022 17.4 [23](#note_23) | -|  [`P2508R1 basic_format_string, format_string, wformat_string​`](https://wg21.link/p2508r1) | VS 2022 17.5 [23](#note_23) | -|  [`P2517R1 Conditional noexcept For apply()​`](https://wg21.link/p2517r1) | VS 2022 17.4 [23](#note_23) | -|  [`P2520R0 move_iterator Should Be A Random-Access Iterator​​`](https://wg21.link/p2520r0) | VS 2022 17.4 [23](#note_23) | +|  [`P2251R1 Require span And basic_string_view To Be Trivially Copyable`](https://wg21.link/p2251r1) | VS 2022 17.1 [23](#note_23) | +|  [`P2273R3 constexpr unique_ptr`](https://wg21.link/p2273r3) | VS 2022 17.3 [23](#note_23) | +|  [`P2280R4 Using unknown pointers and references in constant expressions`](https://wg21.link/p2280r4) | MSVC Build Tools version 14.5 [24](#note_24) | +|  [`P2290R3 Delimited escape sequences`](https://wg21.link/p2290r3) | MSVC Build Tools version 14.5 [24](#note_24) | +|  [`P2291R3 constexpr Integral `](https://wg21.link/p2291r3) | VS 2022 17.4 [23](#note_23) | +|  [`P2302R4 ranges::contains, ranges::contains_subrange`](https://wg21.link/p2302r4) | VS 2022 17.4 [23](#note_23) | +|  [`P2321R2 std::zip`](https://wg21.link/p2321r2) | partial in VS 2022 17.5 [23](#note_23) | +|  [`P2322R6 ranges::fold_left, ranges::fold_right, etc.`](https://wg21.link/p2322r6) | VS 2022 17.5 [23](#note_23) | +|  [`P2360R0 Extend init-statement to allow alias-declaration`](https://wg21.link/p2360r0) | MSVC Build Tools version 14.5 [24](#note_24) | +|  [`P2387R3 Pipe Support For User-Defined Range Adaptors`](https://wg21.link/p2387r3) | VS 2022 17.4 [23](#note_23) | +|  [`P2393R1 Cleaning Up Integer-Class Types`](https://wg21.link/p2393r1) | VS 2022 17.2 [23](#note_23) | +|  [`P2401R0 Conditional noexcept For exchange()`](https://wg21.link/p2401r0) | VS 2022 17.1 [23](#note_23) | +|  [`P2408R5 Ranges Iterators As Inputs To Non-Ranges Algorithms`](https://wg21.link/p2408r5) | VS 2022 17.4 [23](#note_23) | +|  [`P2417R2 More constexpr bitset`](https://wg21.link/p2417r2) | VS 2022 17.4 [23](#note_23) | +|  [`P2419R2 Clarify Handling Of Encodings In Localized Formatting Of chrono Types`](https://wg21.link/p2419r2) | VS 2022 17.4 [23](#note_23) | +|  [`P2437R1 Support for #warning`](https://wg21.link/p2437r1) | MSVC Build Tools version 14.50 [24](#note_24) | +|  [`P2438R2 string::substr() &&`](https://wg21.link/p2438r2) | VS 2022 17.4 [23](#note_23) | +|  [`P2440R1 ranges::iota, ranges::shift_left, ranges::shift_right`](https://wg21.link/p2440r1) | VS 2022 17.4 [23](#note_23) | +|  [`P2441R2 views::join_with`](https://wg21.link/p2441r2) | VS 2022 17.4 [23](#note_23) | +|  [`P2442R1 Windowing Range Adaptors: views::chunk, views::slide`](https://wg21.link/p2442r1) | VS 2022 17.3 [23](#note_23) | +|  [`P2443R1 views::chunk_by`](https://wg21.link/p2443r1) | VS 2022 17.3 [23](#note_23) | +|  [`P2445R1 forward_like()`](https://wg21.link/p2445r1) | VS 2022 17.4 [23](#note_23) | +|  [`P2446R2 views::as_rvalue`](https://wg21.link/p2446r2) | VS 2022 17.4 [23](#note_23) | +|  [`P2465R3 Standard Library Modules std And std.compat`](https://wg21.link/p2465r3) | no | +|  [`P2494R2 Relaxing Range Adaptors To Allow Move-Only Types`](https://wg21.link/p2494r2) | VS 2022 17.4 [23](#note_23) | +|  [`P2499R0 string_view Range Constructor Should Be explicit`](https://wg21.link/p2499r0) | VS 2022 17.4 [23](#note_23) | +|  [`P2508R1 basic_format_string, format_string, wformat_string`](https://wg21.link/p2508r1) | VS 2022 17.5 [23](#note_23) | +|  [`P2517R1 Conditional noexcept For apply()`](https://wg21.link/p2517r1) | VS 2022 17.4 [23](#note_23) | +|  [`P2520R0 move_iterator Should Be A Random-Access Iterator`](https://wg21.link/p2520r0) | VS 2022 17.4 [23](#note_23) | |  [`P2549R1 unexpected::error()`](https://wg21.link/p2549r1) | VS 2022 17.3 [23](#note_23) | A group of papers listed together indicates a Standard feature along with one or more approved improvements or expansions. These features are implemented together. @@ -537,7 +544,7 @@ A group of papers listed together indicates a Standard feature along with one or |  `gets_s()` | VS 2019 16.8 [C11](#note_C11) | |  Bounds-checking interfaces (`*_s` APIs) | Partial in VS 2015 [C11](#note_C11), [O](#note_O) | |  `fopen` `"x"` option | VS 2019 16.8 [C11](#note_C11) | -|  Static assertions | VS 2019 16.8 [C11](#note_C11), [2104](#note_2104) | +|  Static assertions | VS 2019 16.8 [C11](#note_C11), [2104](#note_2104) | |  `quick_exit` | VS 2019 16.8 [C11](#note_C11) | |  `` macros | VS 2019 16.8 [C11](#note_C11) | |  floating point characteristics `` | VS 2019 16.8 [C11](#note_C11) | @@ -571,11 +578,12 @@ A group of papers listed together indicates a Standard feature along with one or **VS 2022 17.2** Supported in Visual Studio 2022 version 17.2.\ **VS 2022 17.3** Supported in Visual Studio 2022 version 17.3.\ **VS 2022 17.4** Supported in Visual Studio 2022 version 17.4.\ -**VS 2022 17.5** Supported in Visual Studio 2022 version 17.5. +**VS 2022 17.5** Supported in Visual Studio 2022 version 17.5.\ +**MSVC Build Tools version 14.50** Supported in Visual Studio 2026 18.0 (MSVC compiler version 19.50) and up. ### Notes - **A** In [`/std:c++14`](../build/reference/std-specify-language-standard-version.md) mode, dynamic exception specifications remain unimplemented, and `throw()` is still treated as a synonym for `__declspec(nothrow)`. In C++17, dynamic exception specifications were mostly removed by P0003R5, except for one vestige: `throw()` is deprecated and required to behave as a synonym for **`noexcept`**. In [`/std:c++17`](../build/reference/std-specify-language-standard-version.md) mode, MSVC now conforms to the Standard by giving `throw()` the same behavior as **`noexcept`**, that is, enforcement via termination. + **A** In [`/std:c++14`](../build/reference/std-specify-language-standard-version.md) mode, the compiler leaves dynamic exception specifications unimplemented, and treats `throw()` as a synonym for `__declspec(nothrow)`. In C++17, P0003R5 removed most dynamic exception specifications, except for one vestige: the standard deprecated `throw()` and requires it to behave as a synonym for **`noexcept`**. In [`/std:c++17`](../build/reference/std-specify-language-standard-version.md) mode, MSVC now conforms to the Standard by giving `throw()` the same behavior as **`noexcept`**, that is, enforcement via termination. The compiler option [`/Zc:noexceptTypes`](../build/reference/zc-noexcepttypes.md) requests the old behavior of `__declspec(nothrow)`. It's likely that `throw()` will be removed in a future version of C++. To help with migrating code in response to these changes in the Standard and the Microsoft implementation, new compiler warnings for exception specification issues are added under [`/std:c++17`](../build/reference/std-specify-language-standard-version.md) and [`/permissive-`](../build/reference/permissive-standards-conformance.md). @@ -589,7 +597,7 @@ The compiler option [`/Zc:noexceptTypes`](../build/reference/zc-noexcepttypes.md **F** Features removed when the [`/std:c++17`](../build/reference/std-specify-language-standard-version.md) or later compiler option is specified. To re-enable these features (to ease the transition to newer language modes), use these macros: `_HAS_AUTO_PTR_ETC`, `_HAS_FUNCTION_ALLOCATOR_SUPPORT`, `_HAS_OLD_IOSTREAMS_MEMBERS`, and `_HAS_UNEXPECTED`. - **G** C++17's parallel algorithms library is complete. Complete doesn't mean that every algorithm is parallelized in every case. The most important algorithms have been parallelized. Execution policy signatures are provided even where the implementation doesn't parallelize algorithms. The central internal header, ``, contains the following "Parallel Algorithms Notes": C++ allows an implementation to implement parallel algorithms as calls to the serial algorithms. This implementation parallelizes several common algorithm calls, but not all. + **G** C++17's parallel algorithms library is complete. Complete doesn't mean that every algorithm is parallelized in every case. The most important algorithms are parallelized. Execution policy signatures are provided even where the implementation doesn't parallelize algorithms. The central internal header, ``, contains the following "Parallel Algorithms Notes": C++ allows an implementation to implement parallel algorithms as calls to the serial algorithms. This implementation parallelizes several common algorithm calls, but not all. The following algorithms are parallelized: @@ -603,7 +611,7 @@ These algorithms aren't presently parallelized: - `generate`, `generate_n` - Effective parallelism of these algorithms might be infeasible: - `partial_sort`, `partial_sort_copy` -- These algorithms haven't been evaluated yet. The library might implement parallelism in a future release: +- These algorithms aren't evaluated yet. The library might implement parallelism in a future release: - `copy_if`, `includes`, `inplace_merge`, `lexicographical_compare`, `max_element`, `merge`, `min_element`, `minmax_element`, `nth_element`, `partition_copy`, `remove_copy`, `remove_copy_if`, `replace_copy`, `replace_copy_if`, `set_symmetric_difference`, `set_union`, `stable_partition`, `unique`, `unique_copy` **H** This is a wholly new implementation, incompatible with the previous `std::experimental` version, made necessary by symlink support, bug fixes, and changes in standard-required behavior. Currently, `` provides both the new `std::filesystem` and the previous `std::experimental::filesystem`. The `` header provides only the old experimental implementation. Expect removal of the experimental implementation in the next ABI-breaking release of the libraries. @@ -614,7 +622,7 @@ These algorithms aren't presently parallelized: **K** MSVC doesn't support the `_Complex` keyword or native complex types. The Universal CRT `` uses implementation-specific macros to achieve the same effect. For more information, see [C complex math support](../c-runtime-library/complex-math-support.md). - **L** The Universal CRT doesn't implement the `strftime` `E` and `O` alternative conversion modifiers. These modifiers are ignored (for example, `%Oe` behaves the same as `%e`). The modifiers aren't supported by the underlying locale APIs. + **L** The Universal CRT doesn't implement the `strftime` `E` and `O` alternative conversion modifiers. These modifiers are ignored (for example, `%Oe` behaves the same as `%e`). The underlying locale APIs don’t support the modifiers. **M** The Universal CRT doesn't implement C11 `aligned_alloc`, but does provide [`_aligned_malloc`](../c-runtime-library/reference/aligned-malloc.md) and [`_aligned_free`](../c-runtime-library/reference/aligned-free.md). Because the Windows operating system doesn't support aligned allocations, this function is unlikely to be implemented. @@ -632,6 +640,10 @@ These algorithms aren't presently parallelized: **T** `` is currently supported when compiled as C++ (`/std:c++latest`). It isn't yet supported when compiled as C (`/std:c11` and `/std:c17`) + **U** Extended floating-point types are an optional C++23 feature. This feature won't be implemented until C++23 standardization is finalized. + + **V** Use the compiler options `/source-charset:utf-8` and `/we4828` to treat source files as UTF-8 encoded. + **14** These C++17 and C++20 features are always enabled, even when [`/std:c++14`](../build/reference/std-specify-language-standard-version.md) (the default) is specified. The reason is either because the feature was implemented before the introduction of the **`/std`** options, or because conditional implementation was undesirably complex. **17** These features are enabled by the [`/std:c++17`](../build/reference/std-specify-language-standard-version.md) or later compiler option. @@ -642,6 +654,8 @@ These algorithms aren't presently parallelized: **23** In Visual Studio 2022 version 17.0 and up, these features are enabled by the [`/std:c++latest`](../build/reference/std-specify-language-standard-version.md) compiler option. + **24** In MSVC Build Tools version 14.50 and up (first shipped with Visual Studio 2026 version 18.0), these features are enabled by the [`/std:c++latest`](../build/reference/std-specify-language-standard-version.md) compiler option. + **C11** Compiler support for C11 and C17 requires Visual Studio 2019 version 16.8 or higher. Except as noted, C11 and C17 library support requires Windows SDK build 10.0.20211.0 or higher. For more information on how to install support for C11 and C17, see [Install C11 and C17 support in Visual Studio](./install-c17-support.md). **DR** These features are enabled in all C++ [`/std`](../build/reference/std-specify-language-standard-version.md) compiler option modes. The C++ Standard committee adopted this change as a retroactive Defect Report to C++11 and all later versions. @@ -653,7 +667,7 @@ These algorithms aren't presently parallelized: [C++ Language Reference](../cpp/cpp-language-reference.md)\ [C++ Standard Library](../standard-library/cpp-standard-library-reference.md)\ [C++ conformance improvements in Visual Studio](cpp-conformance-improvements.md)\ -[What's New for Visual C++ in Visual Studio](what-s-new-for-visual-cpp-in-visual-studio.md)\ +[What's New for Microsoft C++ in Visual Studio](what-s-new-for-visual-cpp-in-visual-studio.md)\ [Visual C++ change history 2003 through 2015](../porting/visual-cpp-change-history-2003-2015.md)\ [Visual C++ What's New 2003 through 2015](../porting/visual-cpp-what-s-new-2003-through-2015.md)\ [C++ team blog](https://devblogs.microsoft.com/cppblog/) diff --git a/docs/overview/visual-cpp-samples.md b/docs/overview/visual-cpp-samples.md index ab943519359..e3371885a18 100644 --- a/docs/overview/visual-cpp-samples.md +++ b/docs/overview/visual-cpp-samples.md @@ -1,11 +1,11 @@ --- title: "Visual Studio C++ Samples" -description: "Summary descriptions of the samples available in the archived Visual Studio C++ samples repository on GitHub." -ms.date: "03/23/2020" +description: "Learn about the samples available in the archived Visual Studio C++ samples repository on GitHub." +ms.date: 03/25/2025 ms.service: "visual-cpp" ms.subservice: "cpp-lang" --- -# Visual Studio C++ Samples +# Visual Studio C++ samples Samples for Visual Studio C++ are available on the web. Microsoft has produced many C++ samples that demonstrate different functionalities across multiple technologies. Here are a few of the places to find additional samples: @@ -21,7 +21,24 @@ Samples for Visual Studio C++ are available on the web. Microsoft has produced m ## Archived C++ samples on GitHub -Visual Studio included C++ sample code in previous versions. The sample code was either installed with Visual Studio, or was available as a separate download. Many articles in our documentation refer to these samples. They don't get installed by Visual Studio anymore. Instead, a repository is available on GitHub. The tables below have descriptions for each sample, and links to the sample's directory in the repository. +Previous versions of Visual Studio included C++ sample code. The sample code was either installed with Visual Studio, or was available as a separate download. Many articles in our documentation refer to these samples. They don't get installed by Visual Studio anymore. Instead, a repository is available on GitHub. The following tables have descriptions for each sample, and links to the sample's directory in the repository. + +- [ATL samples](#atl-samples) +- [CLR and language samples](#clr-and-language-samples---windows-forms) +- [COM events samples](#com-events-samples) +- [ComTypeLibfor7 samples](#comtypelibfor7-samples) +- [Compiler samples](#compiler-samples) +- [CRT samples](#crt-samples) +- [Debugging samples](#debugging-samples) +- [Fusion samples](#fusion-samples) +- [Hilo sample](#hilo-sample) +- [International samples](#international-samples) +- [Language samples](#language-samples---general) +- [MFC samples](#mfc-samples) +- [ODBC samples](#odbc-samples) +- [OS samples](#os-samples) +- [Unix samples](#unix-samples) +- [Windows 8 samples](#windows-8-samples) [!INCLUDE[note_security_samplecode](includes/note_security_samplecode_md.md)] @@ -34,10 +51,10 @@ Visual Studio included C++ sample code in previous versions. The sample code was | [ActiveDoc](https://github.com/Microsoft/VCSamples/tree/master/VC2010Samples/ATL/Advanced) | Demonstrates how to implement an Active Document Server. | | [Async](https://github.com/Microsoft/VCSamples/tree/master/VC2010Samples/ATL/Advanced) | Downloads data asynchronously from a URL. | | [ATLButton](https://github.com/Microsoft/VCSamples/tree/master/VC2010Samples/ATL/Advanced) | Creates a button that displays itself with three different bitmaps depending on its state. | -| [ATLDuck](https://github.com/Microsoft/VCSamples/tree/master/VC2010Samples/ATL/Advanced) | Demonstrates using connection points with ATL controls. | +| [ATLDuck](https://github.com/Microsoft/VCSamples/tree/master/VC2010Samples/ATL/Advanced) | Demonstrates how to use connection points with ATL controls. | | [ATLSecurity](https://github.com/Microsoft/VCSamples/tree/master/VC2010Samples/ATL/Advanced) | Shows how to use the ATL security classes to examine security settings. | | [ATLTraceTool](https://github.com/Microsoft/VCSamples/tree/master/VC2010Samples/ATL/Advanced) | Displays the output generated by the `ATLTRACE2` macro. | -| [Connect](https://github.com/Microsoft/VCSamples/tree/master/VC2010Samples/ATL/Advanced) | Illustrates the implementation and use of connection points (the IConnectionPointContainer and IConnectionPoint interfaces) in a multithreaded environment. | +| [Connect](https://github.com/Microsoft/VCSamples/tree/master/VC2010Samples/ATL/Advanced) | Illustrates the implementation and use of connection points (the `IConnectionPointContainer` and `IConnectionPoint` interfaces) in a multithreaded environment. | | [CThreadPool](https://github.com/Microsoft/VCSamples/tree/master/VC2010Samples/ATL/Advanced) | Shows how to use a thread pool in an application and how implementing a thread pool can improve the application's performance. | | [DCOM](https://github.com/Microsoft/VCSamples/tree/master/VC2010Samples/ATL/Advanced) | Demonstrates how to call a COM object (implemented in a Windows service) from multiple clients, running on different machines. | | [MFCATL](https://github.com/Microsoft/VCSamples/tree/master/VC2010Samples/ATL/Advanced) | Illustrates how ATL COM objects can be used in an MFC server EXE. | @@ -72,7 +89,7 @@ Visual Studio included C++ sample code in previous versions. The sample code was |--|--| | [CatDB](https://github.com/Microsoft/VCSamples/tree/master/VC2010Samples/ATL/OLEDB/Consumer) | Displays the schema information, such as tables and columns, of OLE DB providers. | | [DBViewer](https://github.com/Microsoft/VCSamples/tree/master/VC2010Samples/ATL/OLEDB/Consumer) | Demonstrates a mid-level application that relies on the `CManualAccessor` class to take full control of data bindings for your applications. | -| [DynamicConsumer](https://github.com/Microsoft/VCSamples/tree/master/VC2010Samples/ATL/OLEDB/Consumer) | Demonstrates using dynamic accessor and schema rowset classes to read metadata from a database. | +| [DynamicConsumer](https://github.com/Microsoft/VCSamples/tree/master/VC2010Samples/ATL/OLEDB/Consumer) | Demonstrates how to use dynamic accessor and schema rowset classes to read metadata from a database. | | [MultiRead](https://github.com/Microsoft/VCSamples/tree/master/VC2010Samples/ATL/OLEDB/Consumer) | Reads through a table in a database using multiple threads. | ### ATL samples - OLEDB - Provider @@ -88,7 +105,6 @@ Visual Studio included C++ sample code in previous versions. The sample code was |--|--| | [BirthdayPicker](https://github.com/Microsoft/VCSamples/tree/master/VC2010Samples/Language/Windows%20Forms) | Shows how the .NET Framework resource mechanism can be used in C++ applications. It also demonstrates some common Window Forms components. | | [Calculator](https://github.com/Microsoft/VCSamples/tree/master/VC2010Samples/Language/Windows%20Forms) | Implements a simple pocket calculator using C++ and the .NET Framework Windows Forms classes. | -| Scribble (using MFC) | An MFC implementation of the Scribble sample, updated and extended to include new .NET functionality. | | [Scribble (Windows Forms)](https://github.com/Microsoft/VCSamples/tree/master/VC2010Samples/Language/General) | A Windows Forms implementation of the Scribble sample, updated and extended to include new .NET functionality. | | [STLCLR](https://github.com/Microsoft/VCSamples/tree/master/VC2010Samples/CLR/stlclr/StlClr%20Sample) | Demonstrates some of the capabilities available when using the STL/CLR Library. | @@ -109,9 +125,9 @@ Visual Studio included C++ sample code in previous versions. The sample code was | [Connect](https://github.com/Microsoft/VCSamples/tree/master/VC2010Samples/ComTypeLibfor7) | Illustrates the use and implementation of connection points (the `IConnectionPointContainer` and `IConnectionPoint` interfaces) in a multithreaded environment. | | [DCOM](https://github.com/Microsoft/VCSamples/tree/master/VC2010Samples/ComTypeLibfor7) | Demonstrates how to call a COM object (implemented in a Windows service) from multiple clients, running on different computers. | | [FreeThrd](https://github.com/Microsoft/VCSamples/tree/master/VC2010Samples/ComTypeLibfor7) | Demonstrates a multithreaded client and free-threaded server with compiler COM support. | -| [InProc](https://github.com/Microsoft/VCSamples/tree/master/VC2010Samples/ComTypeLibfor7) | Demonstrates an in-process Automation server application with compiler COM support. | +| [InProc](https://github.com/Microsoft/VCSamples/tree/master/VC2010Samples/ComTypeLibfor7) | Demonstrates an in-process automation server application with compiler COM support. | | [Labrador](https://github.com/Microsoft/VCSamples/tree/master/VC2010Samples/ComTypeLibfor7) | Implements an EXE server that doesn't have any user interface. | -| [MFCCalc](https://github.com/Microsoft/VCSamples/tree/master/VC2010Samples/ComTypeLibfor7) | Demonstrates an Automation server application with compiler COM support. | +| [MFCCalc](https://github.com/Microsoft/VCSamples/tree/master/VC2010Samples/ComTypeLibfor7) | Demonstrates an automation server application with compiler COM support. | ## Compiler samples @@ -119,7 +135,7 @@ Visual Studio included C++ sample code in previous versions. The sample code was | Sample name | Description | |--|--| -| [ccWrapper](https://github.com/Microsoft/VCSamples/tree/master/VC2010Samples/Compiler) | Demonstrates how to map C/C++ compiler flags from other compilers to the Visual C++ compiler (cl.exe). | +| [ccWrapper](https://github.com/Microsoft/VCSamples/tree/master/VC2010Samples/Compiler) | Demonstrates how to map C/C++ compiler flags from other compilers to the Visual C++ compiler (`cl.exe`). | ### Compiler samples - MASM @@ -137,10 +153,10 @@ Visual Studio included C++ sample code in previous versions. The sample code was |--|--| | [CPUID](https://github.com/Microsoft/VCSamples/tree/master/VC2010Samples/crt) | Determines the capabilities of the CPU being run. | | [CRT_Dbg1](https://github.com/Microsoft/VCSamples/tree/master/VC2010Samples/crt) | Illustrates the basic debugging features of the C run-time libraries. | -| [CRT_Dbg2](https://github.com/Microsoft/VCSamples/tree/master/VC2010Samples/crt) | Demonstrates the C run-time debugging hook functions. | +| [CRT_Dbg2](https://github.com/Microsoft/VCSamples/tree/master/VC2010Samples/crt) | Demonstrates the C runtime debugging hook functions. | | [DFACObjs](https://github.com/Microsoft/VCSamples/tree/master/VC2010Samples/crt) | Shows how to use the _CrtDoForAllClientObjects C run-time function to iterate through a linked list of client objects. | -| [Report](https://github.com/Microsoft/VCSamples/tree/master/VC2010Samples/crt) | Illustrates the C run-time debugging report functions. | -| [RTC](https://github.com/Microsoft/VCSamples/tree/master/VC2010Samples/crt) | Demonstrates the run-time error checks feature. | +| [Report](https://github.com/Microsoft/VCSamples/tree/master/VC2010Samples/crt) | Illustrates the C runtime debugging report functions. | +| [RTC](https://github.com/Microsoft/VCSamples/tree/master/VC2010Samples/crt) | Demonstrates the runtime error checks feature. | | [SecureCRT](https://github.com/Microsoft/VCSamples/tree/master/VC2010Samples/crt) | This sample demonstrates how to upgrade code that used deprecated CRT functions to increase code security. | ## Debugging samples @@ -159,7 +175,7 @@ Visual Studio included C++ sample code in previous versions. The sample code was | Sample name | Description | |--|--| -| [Hilo](https://github.com/Microsoft/VCSamples/tree/master/VC2013Samples/Hilo) | Hilo is a series of articles and sample applications. They demonstrate the power of Windows 7, Visual Studio and C++ to build high performance, responsive client applications. Hilo provides both source code and guidance that will help you design and develop compelling, touch-enabled Windows applications of your own.

This sample has been updated for Visual Studio 2013. It includes a hot fix to the *AsyncLoaderMemoryManager.cpp* file (in lines 36 and 37), which addresses a common crash issue. | +| [Hilo](https://github.com/Microsoft/VCSamples/tree/master/VC2013Samples/Hilo) | Hilo is a series of articles and sample applications. They demonstrate the power of Windows 7, Visual Studio and C++ to build high performance, responsive client applications. Hilo provides both source code and guidance that help you design and develop compelling, touch-enabled Windows applications of your own. | ## International samples @@ -201,13 +217,13 @@ Visual Studio included C++ sample code in previous versions. The sample code was | Sample name | Description | |--|--| | [Button](https://github.com/Microsoft/VCSamples/tree/master/VC2010Samples/MFC/controls) | Demonstrates use of an in-place active menu, a stock property page, and the About box control option. | -| [Circ](https://github.com/Microsoft/VCSamples/tree/master/VC2010Samples/MFC/controls) | Demonstrates ActiveX control basics. These include control painting, stock and custom properties, stock and custom events, use of colors and fonts, the stock Font property page, the default property page, and versioning. | -| [CmnCtrl](https://github.com/Microsoft/VCSamples/tree/master/VC2010Samples/MFC/controls) | Demonstrates some of the new controls available with MFC on wiprlhext: The command link button (`CButton`), the pager control (`CPagerCtrl`), the split button (`CSplitButton`), and the network address control (`CNetAddressCtrl`). | +| [Circ](https://github.com/Microsoft/VCSamples/tree/master/VC2010Samples/MFC/controls) | Demonstrates ActiveX control basics. These include control painting, stock and custom properties, stock and custom events, use of colors and fonts, the stock font property page, the default property page, and versioning. | +| [CmnCtrl](https://github.com/Microsoft/VCSamples/tree/master/VC2010Samples/MFC/controls) | Demonstrates some of the new controls available with MFC on Windows Vista: The command link button (`CButton`), the pager control (`CPagerCtrl`), the split button (`CSplitButton`), and the network address control (`CNetAddressCtrl`). | | [Contain](https://github.com/Microsoft/VCSamples/tree/master/VC2010Samples/MFC/controls) | Demonstrates a Visual Editing Container Application. | | [Image](https://github.com/Microsoft/VCSamples/tree/master/VC2010Samples/MFC/controls) | Demonstrates how to use MFC to build an ActiveX control that downloads data asynchronously. | | [Licensed](https://github.com/Microsoft/VCSamples/tree/master/VC2010Samples/MFC/controls) | A control that enforces use of a design-time and run-time license. | | [Localize](https://github.com/Microsoft/VCSamples/tree/master/VC2010Samples/MFC/controls) | A control with a localized user interface that demonstrates use of separate type libraries and resource dynamic-link libraries (DLLs) for localization. | -| [NetAddr](https://github.com/Microsoft/VCSamples/tree/master/VC2010Samples/MFC/controls) | Demonstrates use of the Windows Vista "Net Address Verifier" control. | +| [NetAddr](https://github.com/Microsoft/VCSamples/tree/master/VC2010Samples/MFC/controls) | Demonstrates use of the Windows Vista *Net Address Verifier* control. | | [Pal](https://github.com/Microsoft/VCSamples/tree/master/VC2010Samples/MFC/controls) | Control that displays the colors of a palette. It demonstrates read-only properties, persistent Get/Set properties, persistent parameterized properties, and picture properties. | | [Push](https://github.com/Microsoft/VCSamples/tree/master/VC2010Samples/MFC/controls) | Control subclassed from a Windows owner-drawn button control. It demonstrates stock properties, custom events, and picture holders. | | [RegSvr](https://github.com/Microsoft/VCSamples/tree/master/VC2010Samples/MFC/controls) | Demonstrates the invocation of Self-Registration Code. | @@ -227,7 +243,7 @@ Visual Studio included C++ sample code in previous versions. The sample code was | [CtrlBars](https://github.com/Microsoft/VCSamples/tree/master/VC2010Samples/MFC/general) | Custom toolbar and status bar, dialog bar, and floating palette. | | [CtrlTest](https://github.com/Microsoft/VCSamples/tree/master/VC2010Samples/MFC/general) | Owner-draw list box and menu, custom control, bitmap button, spin control. | | [DBVList](https://github.com/Microsoft/VCSamples/tree/master/VC2010Samples/MFC/general) | Uses the `CListView` and `CDaoRecordset` classes to implement the virtual list view functionality available for the list view common control. | -| [DIBLook](https://github.com/Microsoft/VCSamples/tree/master/VC2010Samples/MFC/general) | Demonstrates the Use of DIBs and Color Palettes. | +| [DIBLook](https://github.com/Microsoft/VCSamples/tree/master/VC2010Samples/MFC/general) | Demonstrates the use of DIBs and color palettes. | | [DlgCbr32](https://github.com/Microsoft/VCSamples/tree/master/VC2010Samples/MFC/general) | Adding a toolbar and a status bar to a dialog-based application. | | [DlgTempl](https://github.com/Microsoft/VCSamples/tree/master/VC2010Samples/MFC/general) | Demonstrates the dynamic creation of dialog templates. | | [DockTool](https://github.com/Microsoft/VCSamples/tree/master/VC2010Samples/MFC/general) | Dragging and floating toolbars that are dockable. | @@ -258,23 +274,23 @@ Visual Studio included C++ sample code in previous versions. The sample code was |--|--| | [DHTMLExplore](https://github.com/Microsoft/VCSamples/tree/master/VC2010Samples/MFC/internet) | Demonstrates handling DHTML events and using DHTML DDX. | | [HTMLEdit](https://github.com/Microsoft/VCSamples/tree/master/VC2010Samples/MFC/internet) | Wraps the Internet Explorer MSHTML editing control. | -| [MFCIE](https://github.com/Microsoft/VCSamples/tree/master/VC2010Samples/MFC/internet) | Demonstrates the MFC `CHtmlView` and `CReBar` Classes. | +| [MFCIE](https://github.com/Microsoft/VCSamples/tree/master/VC2010Samples/MFC/internet) | Demonstrates the MFC `CHtmlView` and `CReBar` classes. | | [Scheduler](https://github.com/Microsoft/VCSamples/tree/master/VC2010Samples/MFC/internet) | Demonstrates how to create an HTML-based dialog box using the Visual C++ libraries classes. | ### MFC samples - OLE | Sample name | Description | |--|--| -| [ACDual](https://github.com/Microsoft/VCSamples/tree/master/VC2010Samples/MFC/ole) | Demonstrates how to add dual interface support to an MFC-based Automation server. | -| [AutoClik](https://github.com/Microsoft/VCSamples/tree/master/VC2010Samples/MFC/ole) | Illustrates Automation features. Includes AUTODRIV, a simple Automation client application that drives the AUTOCLIK sample application. | +| [ACDual](https://github.com/Microsoft/VCSamples/tree/master/VC2010Samples/MFC/ole) | Demonstrates how to add dual interface support to an MFC-based automation server. | +| [AutoClik](https://github.com/Microsoft/VCSamples/tree/master/VC2010Samples/MFC/ole) | Illustrates automation features. Includes AUTODRIV, a simple Automation client application that drives the AUTOCLIK sample application. | | [CalcDriv](https://github.com/Microsoft/VCSamples/tree/master/VC2010Samples/MFC/ole) | Automation client. | | [DrawCli](https://github.com/Microsoft/VCSamples/tree/master/VC2010Samples/MFC/ole) | Full-featured object-oriented drawing application that is also an ActiveX Visual Editing container. | -| [HierSvr](https://github.com/Microsoft/VCSamples/tree/master/VC2010Samples/MFC/ole) | Demonstrates a Server Application with OLE Drag and Drop. | -| [InProc](https://github.com/Microsoft/VCSamples/tree/master/VC2010Samples/MFC/ole) | An in-process Automation server that can be loaded as a DLL in the client's address space. | -| [IPDrive](https://github.com/Microsoft/VCSamples/tree/master/VC2010Samples/MFC/ole) | A simple Automation client application that drives the INPROC sample application. | -| [MFCBind](https://github.com/Microsoft/VCSamples/tree/master/VC2010Samples/MFC/ole) | Shows how to create an Active document (formerly known as a DocObject) container. | -| [MFCCalc](https://github.com/Microsoft/VCSamples/tree/master/VC2010Samples/MFC/ole) | An Automation server that implements a simple calculator. | -| [OClient](https://github.com/Microsoft/VCSamples/tree/master/VC2010Samples/MFC/ole) | ActiveX Visual Editing container application, with drag and drop. | +| [HierSvr](https://github.com/Microsoft/VCSamples/tree/master/VC2010Samples/MFC/ole) | Demonstrates a server application with OLE Drag and Drop. | +| [InProc](https://github.com/Microsoft/VCSamples/tree/master/VC2010Samples/MFC/ole) | An in-process automation server that can be loaded as a DLL in the client's address space. | +| [IPDrive](https://github.com/Microsoft/VCSamples/tree/master/VC2010Samples/MFC/ole) | A simple automation client application that drives the INPROC sample application. | +| [MFCBind](https://github.com/Microsoft/VCSamples/tree/master/VC2010Samples/MFC/ole) | Shows how to create an active document (formerly known as a DocObject) container. | +| [MFCCalc](https://github.com/Microsoft/VCSamples/tree/master/VC2010Samples/MFC/ole) | An automation server that implements a simple calculator. | +| [OClient](https://github.com/Microsoft/VCSamples/tree/master/VC2010Samples/MFC/ole) | ActiveX visual editing container application, with drag and drop. | | [OLEView](https://github.com/Microsoft/VCSamples/tree/master/VC2010Samples/MFC/ole) | Implementing an OLE object browser through custom OLE interfaces. | | [SuperPad](https://github.com/Microsoft/VCSamples/tree/master/VC2010Samples/MFC/ole) | Demonstrates a visual editing server that edits text using CEditView. | | [TstCon](https://github.com/Microsoft/VCSamples/tree/master/VC2010Samples/MFC/ole) | Implements an ActiveX control container using MFC's support for OLE embedding. You can use TSTCON to test ActiveX controls, change their properties, and invoke their methods. | @@ -306,7 +322,7 @@ Visual Studio included C++ sample code in previous versions. The sample code was | [OutlookDemo](https://github.com/Microsoft/VCSamples/tree/master/VC2010Samples/MFC/Visual%20C%2B%2B%202008%20Feature%20Pack) | Demonstrates how to create an application similar to Outlook 2003/2007. | | [OutlookMultiViews](https://github.com/Microsoft/VCSamples/tree/master/VC2010Samples/MFC/Visual%20C%2B%2B%202008%20Feature%20Pack) | Demonstrates how to switch between multiple views on a single document in an SDI application. The sample uses the Outlook bar control to list the available views and switch between them. | | [OwnerDrawMenu](https://github.com/Microsoft/VCSamples/tree/master/VC2010Samples/MFC/Visual%20C%2B%2B%202008%20Feature%20Pack) | Illustrates how to draw popup menu items dynamically. | -| [PaletteDemo](https://github.com/Microsoft/VCSamples/tree/master/VC2010Samples/MFC/Visual%20C%2B%2B%202008%20Feature%20Pack) | Illustrates how to create a multi-column toolbar with an owner-draw information area. Click 2, 3 or 4 buttons on the Standard toolbar to change at runtime the number of columns of the custom toolbar. | +| [PaletteDemo](https://github.com/Microsoft/VCSamples/tree/master/VC2010Samples/MFC/Visual%20C%2B%2B%202008%20Feature%20Pack) | Illustrates how to create a multi-column toolbar with an owner-draw information area. Click 2, 3, or 4 buttons on the Standard toolbar to change at runtime the number of columns of the custom toolbar. | | [PropSheetDemo](https://github.com/Microsoft/VCSamples/tree/master/VC2010Samples/MFC/Visual%20C%2B%2B%202008%20Feature%20Pack) | Illustrates the following types of Property Sheet control: simple, with tabs at the left side, with tree control at the left side, OneNote-style tabs, list of items at the left side. | | [RebarTest](https://github.com/Microsoft/VCSamples/tree/master/VC2010Samples/MFC/Visual%20C%2B%2B%202008%20Feature%20Pack) | Demonstrates a customizable Rebar control that hosts a toolbar. | | [RibbonGadgets](https://github.com/Microsoft/VCSamples/tree/master/VC2010Samples/MFC/Visual%20C%2B%2B%202008%20Feature%20Pack) | Illustrates various controls that can be hosted in the Ribbon Control. At the bottom of the main frame, you can find the Source Code window with source code text, which outlines how to create a particular gadget. | @@ -349,7 +365,7 @@ Visual Studio included C++ sample code in previous versions. The sample code was | Sample name | Description | |--|--| -| [Unix - ccWrapper](https://github.com/Microsoft/VCSamples/tree/master/VC2010Samples) | Demonstrates a wrapper that maps flags from the Sun Forte and gcc compilers to the Microsoft Visual C++ compiler (cl.exe). | +| [Unix - ccWrapper](https://github.com/Microsoft/VCSamples/tree/master/VC2010Samples) | Demonstrates a wrapper that maps flags from the Sun Forte and gcc compilers to the Microsoft Visual C++ compiler (`cl.exe`). | ## Windows 8 samples @@ -362,27 +378,27 @@ More information is available about the programming models, platforms, languages | [Background Transfer sample (Windows 8)](https://github.com/Microsoft/VCSamples/tree/master/VC2012Samples/Windows%208%20samples/C%2B%2B/Windows%208%20app%20samples) | This sample demonstrates the power-friendly, cost-aware, and flexible behavior of the Background Transfer API for Windows Runtime applications. Provided sample scenarios cover file downloads and uploads. | | [CryptoWinRT sample (Windows 8)](https://github.com/Microsoft/VCSamples/tree/master/VC2012Samples/Windows%208%20samples/C%2B%2B/Windows%208%20app%20samples) | This sample shows how to use the new Cryptography APIs. | | [Print sample (Windows 8)](https://github.com/Microsoft/VCSamples/tree/master/VC2012Samples/Windows%208%20samples/C%2B%2B/Windows%208%20app%20samples) | This sample demonstrates how apps can integrate the Windows print experience. The scenarios demonstrated in this sample include: Printing from the app by using the charms bar and the print contract, Printing from within the app experience, and more. | -| [HttpClient sample (Windows 8)](https://github.com/Microsoft/VCSamples/tree/master/VC2012Samples/Windows%208%20samples/C%2B%2B/Windows%208%20app%20samples) | This sample demonstrates the use of the HttpClient class and the IXMLHTTPRequest2 interface to upload and download various types of content from an HTTP server using the networking features provided by the Windows Runtime. | -| [Accelerometer sensor sample (Windows 8)](https://github.com/Microsoft/VCSamples/tree/master/VC2012Samples/Windows%208%20samples/C%2B%2B/Windows%208%20app%20samples) | This sample shows how to use the `Windows.Devices.Sensors.Accelerometer` API. This sample allows the user to view the acceleration forces along the X-, Y-, and Z-axes for a 3-axis accelerometer. You can choose one of three scenarios. | +| [HttpClient sample (Windows 8)](https://github.com/Microsoft/VCSamples/tree/master/VC2012Samples/Windows%208%20samples/C%2B%2B/Windows%208%20app%20samples) | This sample demonstrates the use of the `HttpClient` class and the `IXMLHTTPRequest2` interface to upload and download various types of content from an HTTP server using the networking features provided by the Windows Runtime. | +| [Accelerometer sensor sample (Windows 8)](https://github.com/Microsoft/VCSamples/tree/master/VC2012Samples/Windows%208%20samples/C%2B%2B/Windows%208%20app%20samples) | This sample shows how to use the `Windows.Devices.Sensors.Accelerometer` API. This sample allows the user to view the acceleration forces along the X-, Y-, and Z-axes for a three-axis accelerometer. You can choose one of three scenarios. | | [Account picture name sample (Windows 8)](https://github.com/Microsoft/VCSamples/tree/master/VC2012Samples/Windows%208%20samples/C%2B%2B/Windows%208%20app%20samples) | This sample demonstrates different ways of getting the name of the user that is currently logged in. It also demonstrates how to get and set the image used for the user's tile. | | [App settings sample (Windows 8)](https://github.com/Microsoft/VCSamples/tree/master/VC2012Samples/Windows%208%20samples/C%2B%2B/Windows%208%20app%20samples) | This sample demonstrates how to use the ApplicationSettings API and settings flyouts to integrate an app's settings UI with the Settings charm. The sample uses the `Windows.UI.ApplicationSettings` namespace and `WinJS.UI.SettingsFlyout`. | | [Windows Store device app for camera sample (Windows 8)](https://github.com/Microsoft/VCSamples/tree/master/VC2012Samples/Windows%208%20samples/C%2B%2B/Windows%208%20app%20samples) | This sample demonstrates how to create a Windows Store device app for a camera. A Windows Store device app is provided by an IHV or OEM to differentiate the capture experience for a particular camera. | | [Getting started with C++ simple blog reader sample (Windows 8)](https://github.com/Microsoft/VCSamples/tree/master/VC2012Samples/Windows%208%20samples/C%2B%2B/Windows%208%20app%20samples) | The sample demonstrates some basic principles of Windows Store app development in native C++ using XAML to define the user interface. It's a complete working version of the application discussed on the Windows Developer Center. | -| [Reading and writing data sample (Windows 8)](https://github.com/Microsoft/VCSamples/tree/master/VC2012Samples/Windows%208%20samples/C%2B%2B/Windows%208%20app%20samples) | This sample shows how to use the DataReader and DataWriter classes to store and retrieve data. | +| [Reading and writing data sample (Windows 8)](https://github.com/Microsoft/VCSamples/tree/master/VC2012Samples/Windows%208%20samples/C%2B%2B/Windows%208%20app%20samples) | This sample shows how to use the `DataReader` and `DataWriter` classes to store and retrieve data. | | [Application data sample (Windows 8)](https://github.com/Microsoft/VCSamples/tree/master/VC2012Samples/Windows%208%20samples/C%2B%2B/Windows%208%20app%20samples) | This sample shows you how to store and retrieve data that is specific to each user and Windows Store app using the Windows Runtime application data APIs. Application data includes session state, user preferences, and other settings. | -| [Custom driver access sample (Windows 8)](https://github.com/Microsoft/VCSamples/tree/master/VC2012Samples/Windows%208%20samples/C%2B%2B/Windows%208%20app%20samples) | This sample shows how to use CreateDeviceAccessInstance and IDeviceIoControl to access a specialized device. | +| [Custom driver access sample (Windows 8)](https://github.com/Microsoft/VCSamples/tree/master/VC2012Samples/Windows%208%20samples/C%2B%2B/Windows%208%20app%20samples) | This sample shows how to use `CreateDeviceAccessInstance` and `IDeviceIoControl` to access a specialized device. | | [XAML ListView and GridView essentials sample (Windows 8)](https://github.com/Microsoft/VCSamples/tree/master/VC2012Samples/Windows%208%20samples/C%2B%2B/Windows%208%20app%20samples) | This sample demonstrates how to use the GridView and ListView controls. | | [Animation metrics sample (Windows 8)](https://github.com/Microsoft/VCSamples/tree/master/VC2012Samples/Windows%208%20samples/C%2B%2B/Windows%208%20app%20samples) | This sample shows how to use the Animation Metrics APIs in `Windows.UI.Core.AnimationMetrics` to access the raw parameters that define the animations in the Windows Animation Library. | -| [Playback Manager msAudioCategory sample (Windows 8)](https://github.com/Microsoft/VCSamples/tree/master/VC2012Samples/Windows%208%20samples/C%2B%2B/Windows%208%20app%20samples) | This sample demonstrates how to select the correct msAudioCategory category for an audio-video (AV) stream to configure it as an audio playback stream. | +| [Playback Manager msAudioCategory sample (Windows 8)](https://github.com/Microsoft/VCSamples/tree/master/VC2012Samples/Windows%208%20samples/C%2B%2B/Windows%208%20app%20samples) | This sample demonstrates how to select the correct `msAudioCategory` category for an audio-video (AV) stream to configure it as an audio playback stream. | | [XAML DirectX 3D shooting game sample (Windows 8)](https://github.com/Microsoft/VCSamples/tree/master/VC2012Samples/Windows%208%20samples/C%2B%2B/Windows%208%20app%20samples) | This sample demonstrates the implementation of a simple first person 3-D game using DirectX (Direct3D 11.1, Direct2D, XInput, and XAudio2) and XAML in a C++ app. XAML is used for the heads-up display and game state messages. | | [XAML scrolling, panning, and zooming sample (Windows 8)](https://github.com/Microsoft/VCSamples/tree/master/VC2012Samples/Windows%208%20samples/C%2B%2B/Windows%208%20app%20samples) | This sample demonstrates how to use the ScrollViewer control to pan and zoom. | | [XAML FlipView control sample (Windows 8)](https://github.com/Microsoft/VCSamples/tree/master/VC2012Samples/Windows%208%20samples/C%2B%2B/Windows%208%20app%20samples) | This sample demonstrates how to use the FlipView control to enable users to flip through a collection. | -| [Gyrometer sensor sample (Windows 8)](https://github.com/Microsoft/VCSamples/tree/master/VC2012Samples/Windows%208%20samples/C%2B%2B/Windows%208%20app%20samples) | This sample shows how to use the `Windows.Devices.Sensors.Gyrometer` API. This sample allows the user to view the angular velocity along the X-, Y-, and Z-axis for a 3-axis gyrometer. | +| [Gyrometer sensor sample (Windows 8)](https://github.com/Microsoft/VCSamples/tree/master/VC2012Samples/Windows%208%20samples/C%2B%2B/Windows%208%20app%20samples) | This sample shows how to use the `Windows.Devices.Sensors.Gyrometer` API. This sample allows the user to view the angular velocity along the X-, Y-, and Z-axis for a three-axis gyrometer. | | [Device app for printers SDK sample (Windows 8)](https://github.com/Microsoft/VCSamples/tree/master/VC2012Samples/Windows%208%20samples/C%2B%2B/Windows%208%20app%20samples) | This sample shows how to create a device app for printers that can be activated from the tile contract, the printTaskSettings contract, and from toast displayed by backgroundTask in response to print driver event. | | [Background task sample (Windows 8)](https://github.com/Microsoft/VCSamples/tree/master/VC2012Samples/Windows%208%20samples/C%2B%2B/Windows%208%20app%20samples) | This sample shows you how to create and register background tasks using the Windows Runtime background task API. A background task is triggered by a system or time event, and can be constrained by one or more conditions. | -| [StreamSocket sample (Windows 8)](https://github.com/Microsoft/VCSamples/tree/master/VC2012Samples/Windows%208%20samples/C%2B%2B/Windows%208%20app%20samples) | This sample demonstrates the basics of the StreamSocket class using the networking features provided by the Windows Runtime. The client component of the sample creates a TCP socket to make a network connection, uses the socket to send data, and more. | +| [StreamSocket sample (Windows 8)](https://github.com/Microsoft/VCSamples/tree/master/VC2012Samples/Windows%208%20samples/C%2B%2B/Windows%208%20app%20samples) | This sample demonstrates the basics of the `StreamSocket` class using the networking features provided by the Windows Runtime. The client component of the sample creates a TCP socket to make a network connection, uses the socket to send data, and more. | | [Scheduled notifications sample (Windows 8)](https://github.com/Microsoft/VCSamples/tree/master/VC2012Samples/Windows%208%20samples/C%2B%2B/Windows%208%20app%20samples) | This sample shows how to use scheduled and recurring tile updates and toast notifications for an app. This ability enables you to specify a precise time to deliver the notification, even if the app isn't running. | -| [Playback Manager Companion Sample (Windows 8)](https://github.com/Microsoft/VCSamples/tree/master/VC2012Samples/Windows%208%20samples/C%2B%2B/Windows%208%20app%20samples) | This sample demonstrates how to select the correct msAudioCategory category for an audio-video stream to configure it as an audio playback stream. | +| [Playback Manager Companion Sample (Windows 8)](https://github.com/Microsoft/VCSamples/tree/master/VC2012Samples/Windows%208%20samples/C%2B%2B/Windows%208%20app%20samples) | This sample demonstrates how to select the correct `msAudioCategory` category for an audio-video stream to configure it as an audio playback stream. | | [OrientationSensor sample (Windows 8)](https://github.com/Microsoft/VCSamples/tree/master/VC2012Samples/Windows%208%20samples/C%2B%2B/Windows%208%20app%20samples) | This sample shows how to use the `Windows.Devices.Sensors.OrientationSensor` API. It allows the user to view the rotation matrix and Quaternion values that reflect the current device orientation. | | [File access sample (Windows 8)](https://github.com/Microsoft/VCSamples/tree/master/VC2012Samples/Windows%208%20samples/C%2B%2B/Windows%208%20app%20samples) | This sample shows how to create, read, write, copy and delete a file, how to retrieve file properties, and how to track a file or folder so that your app can access it again. This sample uses `Windows.Storage` and `Windows.Storage.AccessCache` API. | | [Removable storage sample (Windows 8)](https://github.com/Microsoft/VCSamples/tree/master/VC2012Samples/Windows%208%20samples/C%2B%2B/Windows%208%20app%20samples) | The removable storage sample demonstrates how to transfer files to and from removable storage devices. This sample requires a removable storage device connected to the system, such as a camera, media player, cellular phone, or a USB thumb drive. | @@ -397,7 +413,7 @@ More information is available about the programming models, platforms, languages | [DirectX 3D shooting game sample (Windows 8)](https://github.com/Microsoft/VCSamples/tree/master/VC2012Samples/Windows%208%20samples/C%2B%2B/Windows%208%20app%20samples) | This sample demonstrates the implementation of a simple first person 3-D game using DirectX (Direct3D 11.1, Direct2D, XInput, and XAudio2) in a C++ app. | | [XAML AppBar control sample (Windows 8)](https://github.com/Microsoft/VCSamples/tree/master/VC2012Samples/Windows%208%20samples/C%2B%2B/Windows%208%20app%20samples) | This sample demonstrates how to use the AppBar control to present navigation, commands, and tools to users. The app bar is hidden by default and appears when users swipe a finger from the top or bottom edge of the screen. | | [Date and time formatting sample (Windows 8)](https://github.com/Microsoft/VCSamples/tree/master/VC2012Samples/Windows%208%20samples/C%2B%2B/Windows%208%20app%20samples) | This sample demonstrates how to use the DateTimeFormatter class in the `Windows.Globalization.DateTimeFormatting` namespace to display dates and times according to the user's preferences. | -| [Secondary tiles sample (Windows 8)](https://github.com/Microsoft/VCSamples/tree/master/VC2012Samples/Windows%208%20samples/C%2B%2B/Windows%208%20app%20samples) | This sample shows how to pin and use a secondary tile. That's a tile that directly accesses a specific, non-default section or experience within an app, such as a saved game, or a specific friend in a social networking app. | +| [Secondary tiles sample (Windows 8)](https://github.com/Microsoft/VCSamples/tree/master/VC2012Samples/Windows%208%20samples/C%2B%2B/Windows%208%20app%20samples) | This sample shows how to pin and use a secondary tile. That's a tile that directly accesses a specific, nondefault section or experience within an app, such as a saved game, or a specific friend in a social networking app. | | [Input Touch hit testing sample (Windows 8)](https://github.com/Microsoft/VCSamples/tree/master/VC2012Samples/Windows%208%20samples/C%2B%2B/Windows%208%20app%20samples) | This sample uses a polygon shapes puzzle to demonstrate how to handle pointer input, implement custom hit testing for touch input, and process manipulations in a Windows Store app using C++ and DirectX. | | [Network information sample (Windows 8)](https://github.com/Microsoft/VCSamples/tree/master/VC2012Samples/Windows%208%20samples/C%2B%2B/Windows%208%20app%20samples) | This sample demonstrates how to use the Windows Runtime Network Information APIs. | | [Input Simplified ink sample (Windows 8)](https://github.com/Microsoft/VCSamples/tree/master/VC2012Samples/Windows%208%20samples/C%2B%2B/Windows%208%20app%20samples) | This sample demonstrates how to use ink functionality in Windows Store apps. | @@ -406,11 +422,11 @@ More information is available about the programming models, platforms, languages | [Check if current session is remote sample (Windows 8)](https://github.com/Microsoft/VCSamples/tree/master/VC2012Samples/Windows%208%20samples/C%2B%2B/Windows%208%20app%20samples) | This sample demonstrates the use of `Windows.System.RemoteDesktop` API. | | [Application resources and localization sample (Windows 8)](https://github.com/Microsoft/VCSamples/tree/master/VC2012Samples/Windows%208%20samples/C%2B%2B/Windows%208%20app%20samples) | This sample shows how to use application resources to separate localizable content from application code. The sample uses the `Windows.ApplicationModel.Resources.Core` and `Windows.Globalization` namespaces, and `WinJS.Resources`. | | [Context menu sample (Windows 8)](https://github.com/Microsoft/VCSamples/tree/master/VC2012Samples/Windows%208%20samples/C%2B%2B/Windows%208%20app%20samples) | This sample shows how to create a context menu and how to replace the default context menu for text. This sample uses `Windows.UI.Popups` API, including the PopupMenu and the oncontextmenu event. | -| [Geolocation sample (Windows 8)](https://github.com/Microsoft/VCSamples/tree/master/VC2012Samples/Windows%208%20samples/C%2B%2B/Windows%208%20app%20samples) | The Geolocation sample demonstrates how to use the Geolocation API to get the geographic location of the user's PC. An app can use the Geolocation API to get location one time, or it can continuously track the location. | +| [Geolocation sample (Windows 8)](https://github.com/Microsoft/VCSamples/tree/master/VC2012Samples/Windows%208%20samples/C%2B%2B/Windows%208%20app%20samples) | The Geolocation sample demonstrates how to use the Geolocation API to get the geographic location of the user's PC. An app can use the `Geolocation` API to get location one time, or it can continuously track the location. | | [Message dialog sample (Windows 8)](https://github.com/Microsoft/VCSamples/tree/master/VC2012Samples/Windows%208%20samples/C%2B%2B/Windows%208%20app%20samples) | This sample demonstrates how to use a MessageDialog for displaying dialogs, setting commands and their actions, and changing the default button. The `Windows.UI.Popups` namespace contains the MessageDialog class. | | [MediaStreamSource media extension sample (Windows 8)](https://github.com/Microsoft/VCSamples/tree/master/VC2012Samples/Windows%208%20samples/C%2B%2B/Windows%208%20app%20samples) | This sample shows how to support the Microsoft Silverlight MediaStreamSource concept in a Windows Store app. | | [DirectWrite vertical text sample (Windows 8)](https://github.com/Microsoft/VCSamples/tree/master/VC2012Samples/Windows%208%20samples/C%2B%2B/Windows%208%20app%20samples) | This sample uses DirectWrite and Direct2D to properly display vertical text in a custom layout shape. | -| [DXGI swap chain rotation sample (Windows 8)](https://github.com/Microsoft/VCSamples/tree/master/VC2012Samples/Windows%208%20samples/C%2B%2B/Windows%208%20app%20samples) | This sample demonstrates the IDXGISwapChain1::SetRotation method and how you can use the method in conjunction with prerotated content to improve presentation performance. | +| [DXGI swap chain rotation sample (Windows 8)](https://github.com/Microsoft/VCSamples/tree/master/VC2012Samples/Windows%208%20samples/C%2B%2B/Windows%208%20app%20samples) | This sample demonstrates the IDXGISwapChain1::SetRotation method and how you can use the method with prerotated content to improve presentation performance. | | [Direct2D custom image effects sample (Windows 8)](https://github.com/Microsoft/VCSamples/tree/master/VC2012Samples/Windows%208%20samples/C%2B%2B/Windows%208%20app%20samples) | This sample demonstrates how to implement custom Direct2D Effects using standard pixel, vertex, and compute shaders. | | [DirectX touch input sample (Windows 8)](https://github.com/Microsoft/VCSamples/tree/master/VC2012Samples/Windows%208%20samples/C%2B%2B/Windows%208%20app%20samples) | This sample demonstrates touch and mouse navigation of a 3-D environment in a C++ app with Direct3D. | | [XInput game controller sample (Windows 8)](https://github.com/Microsoft/VCSamples/tree/master/VC2012Samples/Windows%208%20samples/C%2B%2B/Windows%208%20app%20samples) | This sample demonstrates the use of the XInput APIs in a C++ app. It reads input from an Xbox game controller and displays data about the analog stick movements and button presses. | @@ -425,14 +441,14 @@ More information is available about the programming models, platforms, languages | [Display orientation sample (Windows 8)](https://github.com/Microsoft/VCSamples/tree/master/VC2012Samples/Windows%208%20samples/C%2B%2B/Windows%208%20app%20samples) | This sample demonstrates how to use the `DisplayProperties` class to set the display orientation in an app. | | [Direct2D interpolation modes sample (Windows 8)](https://github.com/Microsoft/VCSamples/tree/master/VC2012Samples/Windows%208%20samples/C%2B%2B/Windows%208%20app%20samples) | This sample shows the various interpolation modes used by Direct2D. | | [Globalization preferences sample (Windows 8)](https://github.com/Microsoft/VCSamples/tree/master/VC2012Samples/Windows%208%20samples/C%2B%2B/Windows%208%20app%20samples) | This sample demonstrates how to use the `Windows.System.UserProfile.GlobalizationPreferences` class to obtain the user's globalization preferences. It also shows how to use the `GeographicRegion` and `Language` classes. | -| [Direct2D geometry realization sample (Windows 8)](https://github.com/Microsoft/VCSamples/tree/master/VC2012Samples/Windows%208%20samples/C%2B%2B/Windows%208%20app%20samples) | This sample shows how multi-core geometry tessellation can help reduce geometry rendering time. Using opacity masks and meshes is an alternative to traditional geometry rendering that may be better in some situations. | +| [Direct2D geometry realization sample (Windows 8)](https://github.com/Microsoft/VCSamples/tree/master/VC2012Samples/Windows%208%20samples/C%2B%2B/Windows%208%20app%20samples) | This sample shows how multi-core geometry tessellation can help reduce geometry rendering time. Using opacity masks and meshes is an alternative to traditional geometry rendering that might be better in some situations. | | [Language font mapping sample (Windows 8)](https://github.com/Microsoft/VCSamples/tree/master/VC2012Samples/Windows%208%20samples/C%2B%2B/Windows%208%20app%20samples) | This sample demonstrates how to obtain language-specific font recommendations using the `LanguageFontGroup` class in the `Windows.Globalization.Fonts` namespace. | -| [Inclinometer sensor sample (Windows 8)](https://github.com/Microsoft/VCSamples/tree/master/VC2012Samples/Windows%208%20samples/C%2B%2B/Windows%208%20app%20samples) | This sample shows how to use the `Windows.Devices.Sensors.Inclinometer` API. This sample allows the user to view the angles of incline about the X-, Y-, and Z-axis for a 3-axis inclinometer. | +| [Inclinometer sensor sample (Windows 8)](https://github.com/Microsoft/VCSamples/tree/master/VC2012Samples/Windows%208%20samples/C%2B%2B/Windows%208%20app%20samples) | This sample shows how to use the `Windows.Devices.Sensors.Inclinometer` API. This sample allows the user to view the angles of incline about the X-, Y-, and Z-axis for a three-axis inclinometer. | | [XAML high contrast style sample (Windows 8)](https://github.com/Microsoft/VCSamples/tree/master/VC2012Samples/Windows%208%20samples/C%2B%2B/Windows%208%20app%20samples) | This sample demonstrates various techniques for implementing support for high contrast mode in your app. Support for high contrast mode is important to make your app accessible to people with eyesight problems. | | [Input Device capabilities sample (Windows 8)](https://github.com/Microsoft/VCSamples/tree/master/VC2012Samples/Windows%208%20samples/C%2B%2B/Windows%208%20app%20samples) | This sample demonstrates how to query the input devices that are connected to the user's device. And, how to support the pointer, touch, pen/stylus, mouse, and keyboard input modes of Windows Store apps. | | [EAS policies for mail clients sample (Windows 8)](https://github.com/Microsoft/VCSamples/tree/master/VC2012Samples/Windows%208%20samples/C%2B%2B/Windows%208%20app%20samples) | This sample shows how mail clients can retrieved device information and work with supplied Exchange Active Sync (EAS) policies. Windows Store apps can configure their mail clients to stay compliant with the given EAS policies. | | [DatagramSocket sample (Windows 8)](https://github.com/Microsoft/VCSamples/tree/master/VC2012Samples/Windows%208%20samples/C%2B%2B/Windows%208%20app%20samples) | This sample demonstrates the basics of the `DatagramSocket` class using the networking features provided by the Windows Runtime. The client component of the sample creates a UDP socket, uses the socket to send and receive data, and closes the socket. | -| [DirectWrite hello world sample (Windows 8)](https://github.com/Microsoft/VCSamples/tree/master/VC2012Samples/Windows%208%20samples/C%2B%2B/Windows%208%20app%20samples) | This sample shows how to use DirectWrite and Direct2D to render the text "Hello World" to a `CoreWindow`. | +| [DirectWrite hello world sample (Windows 8)](https://github.com/Microsoft/VCSamples/tree/master/VC2012Samples/Windows%208%20samples/C%2B%2B/Windows%208%20app%20samples) | This sample shows how to use DirectWrite and Direct2D to render the text *Hello World* to a `CoreWindow`. | | [Compression sample (Windows 8)](https://github.com/Microsoft/VCSamples/tree/master/VC2012Samples/Windows%208%20samples/C%2B%2B/Windows%208%20app%20samples) | This sample demonstrates how to read structured data from a file and write compressed data to a new file and how to read compressed data and write decompressed data to a new file. Many applications need to compress and decompress data. | | [Network status background sample (Windows 8)](https://github.com/Microsoft/VCSamples/tree/master/VC2012Samples/Windows%208%20samples/C%2B%2B/Windows%208%20app%20samples) | This sample demonstrates how to determine a change in Internet connection profile by registering a background task handler for Network Status Change event using an Internet Present condition. | | [App package information sample (Windows 8)](https://github.com/Microsoft/VCSamples/tree/master/VC2012Samples/Windows%208%20samples/C%2B%2B/Windows%208%20app%20samples) | This sample shows you how to get package information using the Windows Runtime packaging API. Users acquire your Windows Store app as an app package. Windows uses the information in an app package to install the app on a per-user basis. | @@ -473,7 +489,7 @@ More information is available about the programming models, platforms, languages | [Playlist sample (Windows 8)](https://github.com/Microsoft/VCSamples/tree/master/VC2012Samples/Windows%208%20samples/C%2B%2B/Windows%208%20app%20samples) | This sample demonstrates how to create, save, display, and edit a playlist of audio files. This sample uses classes that are in the `Windows.Media.Playlists` namespace. | | [Media Server client sample (Windows 8)](https://github.com/Microsoft/VCSamples/tree/master/VC2012Samples/Windows%208%20samples/C%2B%2B/Windows%208%20app%20samples) | This sample demonstrates how to create a Media Server client using the Media Server API. The Media Server sample demonstrates how to browse a Digital Media Server programmatically on your local network, and display all of its video files. | | [Direct2D magazine app sample (Windows 8)](https://github.com/Microsoft/VCSamples/tree/master/VC2012Samples/Windows%208%20samples/C%2B%2B/Windows%208%20app%20samples) | This sample shows how to use Direct2D, DirectWrite, Windows Imaging Component (WIC), and XAML to build an app with a magazine-type presentation. | -| [Mobile broadband account and device management sample (Windows 8)](https://github.com/Microsoft/VCSamples/tree/master/VC2012Samples/Windows%208%20samples/C%2B%2B/Windows%208%20app%20samples) | This sample shows how to use the Windows 8 Mobile Broadband API (`Windows.Networking.NetworkOperators`) employed by Mobile Network Operators (MNO). It demonstrates how to use the MobileBroadbandAccount APIs to retrieve and display available Mobile Broadband accounts. | +| [Mobile broadband account and device management sample (Windows 8)](https://github.com/Microsoft/VCSamples/tree/master/VC2012Samples/Windows%208%20samples/C%2B%2B/Windows%208%20app%20samples) | This sample shows how to use the Windows 8 Mobile Broadband API (`Windows.Networking.NetworkOperators`) employed by Mobile Network Operators (MNO). It demonstrates how to use the `MobileBroadbandAccount` APIs to retrieve and display available Mobile Broadband accounts. | | [Proximity sample (Windows 8)](https://github.com/Microsoft/VCSamples/tree/master/VC2012Samples/Windows%208%20samples/C%2B%2B/Windows%208%20app%20samples) | This sample demonstrates how to use the `PeerFinder` and `ProximityDevice` classes to communicate with nearby computers. You can use the `Proximity` API to exchange small messages during a tap gesture or set up a socket connection between peer apps. | | [Creating a Windows Runtime in-process component sample (C++CX) (Windows 8)](https://github.com/Microsoft/VCSamples/tree/master/VC2012Samples/Windows%208%20samples/C%2B%2B/Windows%208%20app%20samples) | This sample shows how to create a component in C++/CX that's used in C++/CX, JavaScript, and C# client code. The OvenServer project contains a runtime class named `Oven`, which implements an `IOven` interface and an `IAppliance` interface. | | [Device auto rotation preferences sample (Windows 8)](https://github.com/Microsoft/VCSamples/tree/master/VC2012Samples/Windows%208%20samples/C%2B%2B/Windows%208%20app%20samples) | This sample shows how to use the `DisplayProperties` class to handle and verify device rotation events. | @@ -495,14 +511,14 @@ More information is available about the programming models, platforms, languages | [Device enumeration sample (Windows 8)](https://github.com/Microsoft/VCSamples/tree/master/VC2012Samples/Windows%208%20samples/C%2B%2B/Windows%208%20app%20samples) | This sample shows how to use the Device Enumeration API to find available devices and look for device information. The sample presents two scenarios: In the first scenario, the Device Enumeration API is used to look for specific device interfaces. | | [DirectWrite paragraph text sample (Windows 8)](https://github.com/Microsoft/VCSamples/tree/master/VC2012Samples/Windows%208%20samples/C%2B%2B/Windows%208%20app%20samples) | This sample shows how to use DirectWrite and Direct2D to render paragraph text to a `CoreWindow`. And, apply justification and character spacing to the layout. | | [Responding to the appearance of the on-screen keyboard sample (Windows 8)](https://github.com/Microsoft/VCSamples/tree/master/VC2012Samples/Windows%208%20samples/C%2B%2B/Windows%208%20app%20samples) | [This documentation is preliminary and is subject to change.] This sample shows how to listen for and respond to the appearance of the onscreen soft keyboard. When focus is given to an element that requires text input on a device that doesn't have a keyboard. | -| [XAML data binding sample (Windows 8)](https://github.com/Microsoft/VCSamples/tree/master/VC2012Samples/Windows%208%20samples/C%2B%2B/Windows%208%20app%20samples) | This sample demonstrates basic data binding techniques using the Binding class and Binding markup extension. | +| [XAML data binding sample (Windows 8)](https://github.com/Microsoft/VCSamples/tree/master/VC2012Samples/Windows%208%20samples/C%2B%2B/Windows%208%20app%20samples) | This sample demonstrates basic data binding techniques using the `Binding` class and `Binding` markup extension. | | [Direct3D tutorial sample (Windows 8)](https://github.com/Microsoft/VCSamples/tree/master/VC2012Samples/Windows%208%20samples/C%2B%2B/Windows%208%20app%20samples) | This sample is a five-lesson tutorial. It provides an introduction to the Direct3D API, and introduces the concepts and code used in many of the other DirectX samples. | | [Direct2D effects photo adjustment app sample (Windows 8)](https://github.com/Microsoft/VCSamples/tree/master/VC2012Samples/Windows%208%20samples/C%2B%2B/Windows%208%20app%20samples) | This sample shows various common photo manipulation techniques using Direct2D Effects. This sample is divided into several parts. Lesson 1: Shows the basics of loading and drawing an image using Direct2D Effects. | | [Windows Audio Session (WASAPI) sample (Windows 8)](https://github.com/Microsoft/VCSamples/tree/master/VC2012Samples/Windows%208%20samples/C%2B%2B/Windows%208%20app%20samples) | Demonstrates how to do various audio related tasks using the Windows Audio Session API (WASAPI). | | [User domain name sample (Windows 8)](https://github.com/Microsoft/VCSamples/tree/master/VC2012Samples/Windows%208%20samples/C%2B%2B/Windows%208%20app%20samples) | This sample demonstrates the domain-related functionality provided by the `UserInformation` class of the `Windows.System.UserProfile` namespace. The UserInformation class enables an app to get and set information about the user. | | [USSD message management sample (Windows 8)](https://github.com/Microsoft/VCSamples/tree/master/VC2012Samples/Windows%208%20samples/C%2B%2B/Windows%208%20app%20samples) | This sample demonstrates network account management using the USSD protocol with GSM-capable mobile broadband devices. USSD is typically used for account management of a mobile broadband profile by the Mobile Network Operator (MNO). | | [Bing Maps Trip Optimizer sample (Windows 8)](https://github.com/Microsoft/VCSamples/tree/master/VC2012Samples/Windows%208%20samples/C%2B%2B/Windows%208%20app%20samples) | The sample demonstrates how to use JavaScript and Visual C++ and to create app for Windows 8 named Bing Maps Trip Optimizer. Bing Maps Trip Optimizer uses JavaScript to define the UI, and C++ for a computationally expensive algorithm in parallel. | -| [Direct2D and DirectWrite animated text on a path sample (Windows 8)](https://github.com/Microsoft/VCSamples/tree/master/VC2012Samples/Windows%208%20samples/C%2B%2B/Windows%208%20app%20samples) | This sample shows how to use Direct2D and DirectWrite to render a string of text along an animated, non-linear geometric path. The app renders "Hello, World!" repeated several times in different languages along a Bezier curve. | +| [Direct2D and DirectWrite animated text on a path sample (Windows 8)](https://github.com/Microsoft/VCSamples/tree/master/VC2012Samples/Windows%208%20samples/C%2B%2B/Windows%208%20app%20samples) | This sample shows how to use Direct2D and DirectWrite to render a string of text along an animated, nonlinear geometric path. The app renders "Hello, World!" repeated several times in different languages along a Bezier curve. | | [Wi-Fi hotspot authentication sample (Windows 8)](https://github.com/Microsoft/VCSamples/tree/master/VC2012Samples/Windows%208%20samples/C%2B%2B/Windows%208%20app%20samples) | This sample demonstrates how to use the Windows 8 Mobile Broadband API (`Windows.Networking.NetworkOperators`) for Wi-Fi hotspot authentication. Use this mechanism as an alternative to configuring static credentials for a Wi-Fi hotspot. | | [XAML images sample (Windows 8)](https://github.com/Microsoft/VCSamples/tree/master/VC2012Samples/Windows%208%20samples/C%2B%2B/Windows%208%20app%20samples) | This sample demonstrates various techniques for displaying and manipulating images in your app using the Image control and the BitmapImage class. | | [HomeGroup app sample (Windows 8)](https://github.com/Microsoft/VCSamples/tree/master/VC2012Samples/Windows%208%20samples/C%2B%2B/Windows%208%20app%20samples) | This sample demonstrates how to use a `HomeGroup` to open, search, and share files. This sample uses some of the `HomeGroup` options found in the `Windows.Storage.Pickers` and `Windows.Storage.KnownFolders`. | @@ -527,9 +543,9 @@ More information is available about the programming models, platforms, languages | [Direct2D command list sample (Windows 8)](https://github.com/Microsoft/VCSamples/tree/master/VC2012Samples/Windows%208%20samples/C%2B%2B/Windows%208%20app%20samples) | This sample demonstrates the use of a command list. It's used for recording a set of vector commands, creating an image brush from the command list, and then filling a rectangle geometry with it. The command list preserves resolution independence of the vector. | | [ControlChannelTrigger XMLHTTPRequest sample (Windows 8)](https://github.com/Microsoft/VCSamples/tree/master/VC2012Samples/Windows%208%20samples/C%2B%2B/Windows%208%20app%20samples) | The sample shows how to use the `ControlChannelTrigger` class to enable a Windows Store app using `IXMLHTTPRequest2` to be always connected and always reachable. This sample demonstrates the use of background network notifications in a Windows Store app. | | [XInput and JavaScript controller sketch sample (Windows 8)](https://github.com/Microsoft/VCSamples/tree/master/VC2012Samples/Windows%208%20samples/C%2B%2B/Windows%208%20app%20samples) | This sample demonstrates how to wrap the XInput C++ API in a Windows Runtime component. Then, it calls it from a Windows Store app using JavaScript. This sample implements a sketch app that lets you use the Xbox game controller to select line thickness and more. | -| [Direct2D convolve matrix effect sample (Windows 8)](https://github.com/Microsoft/VCSamples/tree/master/VC2012Samples/Windows%208%20samples/C%2B%2B/Windows%208%20app%20samples) | This sample demonstrates the Direct2D Effects convolve matrix effect. This sample has some example convolution kernel matrices: Passthrough (no-op), Box blur (width 5), Simple edge detect, Simple sharpen, Emboss, Vertical smear (height 10) theses and more. | +| [Direct2D convolve matrix effect sample (Windows 8)](https://github.com/Microsoft/VCSamples/tree/master/VC2012Samples/Windows%208%20samples/C%2B%2B/Windows%208%20app%20samples) | This sample demonstrates the Direct2D Effects convolve matrix effect. This sample has some example convolution kernel matrices: Passthrough (no-op), Box blur (width 5), Simple edge detect, Simple sharpen, Emboss, Vertical smear (height 10) these and more. | | [DirectX swap chain implementation sample (Windows 8)](https://github.com/Microsoft/VCSamples/tree/master/VC2012Samples/Windows%208%20samples/C%2B%2B/Windows%208%20app%20samples) | This sample shows how to receive `CoreWindow` events in a native application, and how to connect a DirectX swap chain to the application view. | -| [Credential picker sample (Windows 8)](https://github.com/Microsoft/VCSamples/tree/master/VC2012Samples/Windows%208%20samples/C%2B%2B/Windows%208%20app%20samples) | This sample shows how to use the `Windows.Security.Credentials.UI.CredentialPicker` class to retrieve credentials. These credentials may be passed to APIs that require them, for example, `HttpClient`. | +| [Credential picker sample (Windows 8)](https://github.com/Microsoft/VCSamples/tree/master/VC2012Samples/Windows%208%20samples/C%2B%2B/Windows%208%20app%20samples) | This sample shows how to use the `Windows.Security.Credentials.UI.CredentialPicker` class to retrieve credentials. These credentials might be passed to APIs that require them, for example, `HttpClient`. | | [Direct2D animation sample (Windows 8)](https://github.com/Microsoft/VCSamples/tree/master/VC2012Samples/Windows%208%20samples/C%2B%2B/Windows%208%20app%20samples) | This sample shows how to use Direct2D to render and animate a Direct2D primitive along a spiral path. | | [Sharing content target app sample (Windows 8)](https://github.com/Microsoft/VCSamples/tree/master/VC2012Samples/Windows%208%20samples/C%2B%2B/Windows%208%20app%20samples) | This sample demonstrates how an app can receive content shared from another app. This sample uses classes from the `Windows.ApplicationModel.DataTransfer` and `Windows.ApplicationModel.DataTransfer.Share` namespaces. | | [Direct2D save to image file sample (Windows 8)](https://github.com/Microsoft/VCSamples/tree/master/VC2012Samples/Windows%208%20samples/C%2B%2B/Windows%208%20app%20samples) | This sample shows how to render to the screen using Direct2D and DirectWrite. And, how to save the rendered image to disk using the WIC API. | @@ -537,7 +553,7 @@ More information is available about the programming models, platforms, languages | [Creating a Windows Runtime in-process component sample (C#) (Windows 8)](https://github.com/Microsoft/VCSamples/tree/master/VC2012Samples/Windows%208%20samples/C%2B%2B/Windows%208%20app%20samples) | This sample shows how to create a component in C# that's used in C++/CX, JavaScript, and C# client code. The OvenServer project contains a runtime class named `Oven`, which implements an `IOven` interface and an `IAppliance` interface. | | [Push and periodic notifications client-side sample (Windows 8)](https://github.com/Microsoft/VCSamples/tree/master/VC2012Samples/Windows%208%20samples/C%2B%2B/Windows%208%20app%20samples) | This sample shows how a client app can register and listen for push notifications sent from a web server. Push notifications can be used to update a badge or a tile, raise a toast notification, or launch a background task. | | [Portable device API sample (Windows 8)](https://github.com/Microsoft/VCSamples/tree/master/VC2012Samples/Windows%208%20samples/C%2B%2B/Windows%208%20app%20samples) | This sample shows how to access the `IPortableDevice` COM API from a C++ app. To learn how to access the `IPortableDevice` COM API from a Desktop C++ app, refer to the Portable Devices COM API Sample. | -| [PlayToReceiver sample (Windows 8)](https://github.com/Microsoft/VCSamples/tree/master/VC2012Samples/Windows%208%20samples/C%2B%2B/Windows%208%20app%20samples) | This sample demonstrates how to create a software Play To receiver. To advertise the software Play To Receiver, click the Start Receiver button. To stop the receiver, click the Stop Receiver button. | +| [PlayToReceiver sample (Windows 8)](https://github.com/Microsoft/VCSamples/tree/master/VC2012Samples/Windows%208%20samples/C%2B%2B/Windows%208%20app%20samples) | This sample demonstrates how to create a software Play To receiver. To advertise the software Play To receiver, select the **Start Receiver** button. To stop the receiver, select the **Stop Receiver** button. | | [Lock screen personalization sample (Windows 8)](https://github.com/Microsoft/VCSamples/tree/master/VC2012Samples/Windows%208%20samples/C%2B%2B/Windows%208%20app%20samples) | This sample demonstrates how to use the `LockScreen` API to set the current user's lock screen image. This sample uses classes from the `Windows.System.UserProfile` namespace. | | [Credential locker sample (Windows 8)](https://github.com/Microsoft/VCSamples/tree/master/VC2012Samples/Windows%208%20samples/C%2B%2B/Windows%208%20app%20samples) | This sample demonstrates how to use the WinRT `PasswordVault` APIs, and how to use the credential locker to store web credentials. Specific scenarios include a single user with a single resource, and multiple users with a single resource. | | [Media engine native C++ video playback sample (Windows 8)](https://github.com/Microsoft/VCSamples/tree/master/VC2012Samples/Windows%208%20samples/C%2B%2B/Windows%208%20app%20samples) | This sample demonstrates video playback using the `MediaEngine` API in a native C++ app. | diff --git a/docs/overview/visual-cpp-tools-and-features-in-visual-studio-editions.md b/docs/overview/visual-cpp-tools-and-features-in-visual-studio-editions.md index 8f68bdd1c4a..05aadb31dd0 100644 --- a/docs/overview/visual-cpp-tools-and-features-in-visual-studio-editions.md +++ b/docs/overview/visual-cpp-tools-and-features-in-visual-studio-editions.md @@ -3,7 +3,6 @@ description: "Learn more about: C++ Tools and Features in Visual Studio Editions title: "C++ Tools and Features in Visual Studio Editions" ms.date: 10/27/2021 helpviewer_keywords: ["tools and platforms [C++]"] -ms.assetid: 3d88607b-9cc4-490a-8d4c-31ee7610a26f --- # C++ Tools and Features in Visual Studio Editions @@ -15,7 +14,7 @@ The following C++ features are available in Visual Studio. Unless stated otherwi ::: moniker range="<=msvc-150" -The following tables show Visual C++ features that are available in Visual Studio 2017. An X in a cell indicates that the feature is available; an empty cell indicates that the feature is not available. Notes in parentheses indicate that a feature is available, but restricted. +The following tables show C++ features that are available in Visual Studio 2017. An X in a cell indicates that the feature is available; an empty cell indicates that the feature is not available. Notes in parentheses indicate that a feature is available, but restricted. ::: moniker-end @@ -29,6 +28,9 @@ The following tables show Visual C++ features that are available in Visual Studi - Android - iOS +> [!IMPORTANT] +> Starting with Visual Studio 2026 (version 18.0), the Mobile development with C++ workload for iOS and Android, as well as the Embedded and IoT tools (RTOS Viewer, Serial Monitor, Peripheral Viewer, and ST Project Import), are no longer supported and will be removed in a future update. The Android NDKs included in the Mobile development with C++ workload remain supported. + ::: moniker-end ::: moniker range="<=msvc-150" @@ -257,6 +259,9 @@ Optional Components: ### Mobile development with C++ +> [!IMPORTANT] +> Starting with Visual Studio 2026 (version 18.0), the Mobile development with C++ workload for iOS and Android, as well as the Embedded and IoT tools (RTOS Viewer, Serial Monitor, Peripheral Viewer, and ST Project Import), are no longer supported and will be removed in a future update. The Android NDKs included in the Mobile development with C++ workload remain supported. + Included: - C++ core features diff --git a/docs/overview/what-s-new-for-cpp-2017.md b/docs/overview/what-s-new-for-cpp-2017.md index d6cf9b9e02b..d30dc9febd5 100644 --- a/docs/overview/what-s-new-for-cpp-2017.md +++ b/docs/overview/what-s-new-for-cpp-2017.md @@ -10,7 +10,7 @@ ms.custom: intro-whats-new Visual Studio 2017 brings many updates and fixes to the C++ environment. We've fixed over 250 bugs and reported issues in the compiler and tools. Many were submitted by customers through the [Report a Problem and Provide a Suggestion](/visualstudio/ide/how-to-report-a-problem-with-visual-studio?view=vs-2017&preserve-view=true) options under **Send Feedback**. Thank you for reporting bugs! -For more information on what's new in all of Visual Studio, see [What's new in Visual Studio 2017](/visualstudio/ide/whats-new-visual-studio-2017?view=vs-2017&preserve-view=true). For information on what's new for C++ in Visual Studio 2019, see [What's new for C++ in Visual Studio 2019](what-s-new-for-visual-cpp-in-visual-studio.md?preserve-view=true&view=msvc-160). For information on what's new for C++ in Visual Studio 2015 and earlier versions, see [Visual C++ What's New 2003 through 2015](../porting/visual-cpp-what-s-new-2003-through-2015.md). For information about what's new in the C++ docs, see [Microsoft C++ docs: What's new](whats-new-cpp-docs.md). +For more information on what's new in all of Visual Studio, see [What's new in Visual Studio 2017](/visualstudio/ide/whats-new-visual-studio-2017?view=vs-2017&preserve-view=true). For information on what's new for C++ in Visual Studio 2019, see [What's new for C++ in Visual Studio 2019](what-s-new-for-visual-cpp-in-visual-studio.md?preserve-view=true&view=msvc-160). For information on what's new for C++ in Visual Studio 2015 and earlier versions, see [Visual C++ What's New 2003 through 2015](../porting/visual-cpp-what-s-new-2003-through-2015.md). ## Visual Studio 2017 C++ compiler @@ -420,7 +420,7 @@ The Clang/C2 toolset that ships with Visual Studio 2017 now supports the **`/big The C++ Core Checkers for enforcing the [C++ Core Guidelines](https://github.com/isocpp/CppCoreGuidelines) are now distributed with Visual Studio. Enable the checkers in the **Code Analysis Extensions** page in the project's property pages. The extensions are then included when you run code analysis. For more information, see [Using the C++ Core Guidelines checkers](../code-quality/using-the-cpp-core-guidelines-checkers.md). -![Screenshot of the Property Pages dialog box showing Configuration Properties > Code Analysis > General selected and a number of Core Checks listed in teh Run this rule set section.](media/CppCoreCheck.png "CppCoreCheck properties page") +![Screenshot of the Property Pages dialog box showing Configuration Properties > Code Analysis > General selected and a number of Core Checks listed in the Run this rule set section.](media/CppCoreCheck.png "CppCoreCheck properties page") ##### Visual Studio 2017 version 15.3 diff --git a/docs/overview/what-s-new-for-cpp-2019.md b/docs/overview/what-s-new-for-cpp-2019.md index 78890488068..e79f0e6d590 100644 --- a/docs/overview/what-s-new-for-cpp-2019.md +++ b/docs/overview/what-s-new-for-cpp-2019.md @@ -10,7 +10,7 @@ ms.custom: intro-whats-new Visual Studio 2019 brings many updates and fixes to the Microsoft C++ environment. We've fixed many bugs and issues in the compiler and tools. Many of these issues were submitted by customers through the [Report a Problem](/visualstudio/ide/how-to-report-a-problem-with-visual-studio?view=vs-2019&preserve-view=true) and [Provide a Suggestion](https://aka.ms/feedback/suggest?space=62) options under **Send Feedback**. Thank you for reporting bugs! -For more information on what's new in all of Visual Studio, visit [What's new in Visual Studio 2019](/visualstudio/ide/whats-new-visual-studio-2019). For information on what's new for C++ in Visual Studio 2017, see [What's new for C++ in Visual Studio 2017](what-s-new-for-cpp-2017.md). For information on what's new for C++ in Visual Studio 2015 and earlier versions, see [Visual C++ What's New 2003 through 2015](../porting/visual-cpp-what-s-new-2003-through-2015.md). For more information, see [Microsoft C++ docs: What's new](whats-new-cpp-docs.md). +For more information on what's new in all of Visual Studio, visit [What's new in Visual Studio 2019](/visualstudio/ide/whats-new-visual-studio-2019). For information on what's new for C++ in Visual Studio 2017, see [What's new for C++ in Visual Studio 2017](what-s-new-for-cpp-2017.md). For information on what's new for C++ in Visual Studio 2015 and earlier versions, see [Visual C++ What's New 2003 through 2015](../porting/visual-cpp-what-s-new-2003-through-2015.md). ## What's new for C++ in Visual Studio version 16.11 diff --git a/docs/overview/what-s-new-for-msvc.md b/docs/overview/what-s-new-for-msvc.md new file mode 100644 index 00000000000..e9563fdf67e --- /dev/null +++ b/docs/overview/what-s-new-for-msvc.md @@ -0,0 +1,105 @@ +--- +title: "What's new for MSVC Build Tools" +description: "The new features and fixes in the Microsoft C/C++ compiler and tools (MSVC)." +ms.date: 11/11/2025 +ms.service: "visual-cpp" +ms.subservice: "cpp-lang" +ms.custom: intro-whats-new +--- + +# What's new for MSVC Build Tools + +Version 14.50 brings many updates and fixes to the Microsoft C++ compiler and other build tools. + +- For more information about what's new in all of Visual Studio, see [Visual Studio 2026 release notes](/visualstudio/releases/2026/release-notes). + +## What's new for MSVC Build Tools version 14.50 + +* Introduced in Visual Studio 2026 version 18.0 released November 2025. + +Visual Studio 2026 version 18.0 ships with the v145 platform toolset for MSBuild C++ projects and Microsoft C++ (MSVC) Build Tools version 14.50, which offers the best conformance, build performance, and runtime performance story yet. To access all the new language features, build with `/std:c++latest`. Or, if you want to be restricted to features up to C++23, use `/std:c++23preview`. + +MSVC Build Tools version 14.50 preserves binary compatibility with code built with MSVC tools shipped in Visual Studio 2015 or later. For more information about binary compatibility, see [C++ binary compatibility between Visual Studio versions](/cpp/porting/binary-compat-2015-2017). + +| For detailed information about | See | +|---|---| +| What's new for C++ developers | [What’s New for C++ Developers in Visual Studio 2026 version 18.0](https://devblogs.microsoft.com/cppblog/whats-new-for-cpp-developers-in-visual-studio-2026-version-18-0) | +| Standard Library (STL) improvements | [STL Changelog MSVC Build Tools 14.50](https://github.com/microsoft/STL/wiki/Changelog#msvc-build-tools-1450) | +| C++ language updates | [C++ Language Updates in MSVC Build Tools v14.50](https://devblogs.microsoft.com/cppblog/c-language-updates-in-msvc-build-tools-v14-50/) | +| C++ language conformance improvements | [C/C++ Conformance improvements, behavior changes, and bug fixes in Microsoft C++ (MSVC) Build Tools](msvc-conformance-improvements.md) | + +Here's a quick highlight of some of the new features in MSVC Build Tools version 14.50 and Visual Studio 2026 version 18.0: + +### C++ language enhancements + +- C++20 is the default for new Console App, Windows Desktop Application, Dynamic-Link Library, and Static Library C++ projects. +- C++23 preprocessing directive `#warning` allows you to generate a diagnostic message without stopping translation as `#error` does. For more information, see [`#warning` directive](/cpp/preprocessor/hash-warning-directive-c-cpp). +- Easily set debugger command-line arguments for any C++ project using the toolbar for `.vcxproj`, CMake, and Unreal Engine projects. This feature is no longer tied to the Game Development with C++ workload, and is available to all C++ developers without installing any other workloads or components. For more information, see [Pass command-line arguments](/visualstudio/debugger/getting-started-with-the-debugger-cpp?view=visualstudio&preserve-view=true). + +### Standard Library enhancements + +- Enhanced `` reliability and speed. [LWG-2503](https://cplusplus.github.io/LWG/issue2503) added a multiline option to `syntax_option_type`. This is a `regex` behavioral change. By default, `_REGEX_LEGACY_MULTILINE_MODE` is 0, which requests Standard behavior. Set `_REGEX_LEGACY_MULTILINE_MODE` to 1 to request legacy behavior. For more information, see [STL Changelog](https://github.com/microsoft/STL/wiki/Changelog#msvc-build-tools-1450). +- Added and improved vectorized implementations of many types and functions. + +### GitHub Copilot enhancements + +- Copilot Chat allows you to use natural language to get answers to questions (Ask mode) or even implement changes for you automatically (Agent Mode). +- Copilot Chat is smarter with improved context for everyday tasks. Expect better results when searching your codebase and referencing specific lines in your code. +- A **Copilot Actions** option was added to the right-click context menu in the Visual Studio editor. Use it to quickly bring a specific file or lines of code you select to the attention of Copilot Chat. You can then ask Copilot to explain what the code does, make optimizations, generate comments, generate unit tests, and more. +- Better AI code completions for C++. GitHub Copilot uses context from relevant files to improve inline autocomplete for C++. GitHub Copilot includes other relevant files as context which reduces hallucinations while offering more relevant and accurate suggestions. +- For more information, see [New GitHub Copilot capabilities for C++ developers: Upgrade MSVC, improve build performance, and refactor C++ code](https://devblogs.microsoft.com/cppblog/new-github-copilot-capabilities-for-c-developers-upgrade-msvc-improve-build-performance-and-refactor-c-code/). + +### Build enhancements + +- Visual Studio 2026 now includes CMake 4.1.1 by default. CMake also includes a Visual Studio 2026 generator and supports modern SLNX projects, so you can build Visual Studio C++ projects directly from CMake. +- Includes the latest version of the IncrediBuild engine and an updated extension that works with Visual Studio 2026 version 18.0. +- Compiler backend runtime performance improvements. Compared to Visual Studio version 17.14, there's up to a 6% improvement on Unreal Engine's City Sample RenderThread and up to +3% improvements on Unreal Engine's City Sample GameThread benchmark. For more information, see [Why you should upgrade your C++ build tools](https://devblogs.microsoft.com/cppblog/upgrading-c-projects-to-visual-studio-2026/#why-you-should-upgrade-your-c++-build-tools). +- The Visual Studio setup assistant can help you retarget your projects to build with the latest MSVC Build Tools. For more information, see [Retarget your projects with the setup assistant](https://devblogs.microsoft.com/cppblog/upgrading-c-projects-to-visual-studio-2026/#retarget-your-projects-with-the-setup-assistant). + +### Code analysis enhancements + +- Clang-Tidy code analysis improvements provide enhanced configuration options for faster builds and custom workflows: + - Code analysis has new configuration options. You can now allocate more processors to run code analysis as part of your build, speeding up your development workflow. + - You can add custom arguments to the command line used to invoke `clang-tidy`, giving you complete control over your analysis setup. + - Access the new options from **Project Properties** > **Code Analysis** > **Clang-Tidy**: + +![Screenshot of Project Properties dialog showing clang-tidy configuration options including processor allocation and custom command line arguments](./media/clang-tidy-improvements.png) +- AddressSanitizer support for ARM64 Builds (Preview): For some time, the MSVC Build Tools have supported building projects that target x64 and x86 with [AddressSanitizer](/cpp/sanitizers/asan), which allows you to identify hard-to-find memory safety issues with zero false positives at runtime and increase memory safety. Now you can use AddressSanitizer to target ARM64. This feature is in preview. + +### Productivity enhancements + +- Generate preprocessed output for a C++ file. In Visual Studio, right-click a C++ file to instantly generate its preprocessed output, making it easy to debug macros and includes, and see errors immediately: ![Screenshot showing the right-click context menu for a C++ file with the Preprocess option highlighted.](./media/cpp-preprocess-menu-entry.png) +- The Visual Studio debugger now shows the return values of functions inline. This provides real-time visibility into function behavior without stepping into code or setting up watches, making it faster to catch logic issues or unexpected results: ![Screenshot showing inline post-return values displayed in the debugger next to function call."](./media/inline-post-return-value.png) + +### Other changes + +- In the Visual Studio installer, the *C++ Linux* workload is renamed *Linux, Mac, and embedded development with C++*. + +### Deprecations + +- The minimum supported target operating systems for the MSVC Build Tools version 14.50 are Windows 10 or Windows Server 2016. +- MSVC Build Tools version 14.50 no longer targets: + + - Windows 7 / Windows Server 2008 R2 + - Windows 8 / Windows Server 2012 + - Windows 8.1 / Windows Server 2012 R2 + + These changes allow for better performance, enhanced security, and alignment with the most recent Windows platform capabilities. + +The MSVC compiler switch [`/await`](/cpp/build/reference/await-enable-coroutine-support) is deprecated and will be removed in a future release. This switch enabled an early draft implementation of C++ coroutines using the `` header. Developers should transition to standard C++ coroutines by using the `` header available in C++20 and later. For C++14/17 projects, use `/await:strict` (which isn't being deprecated) to access the standard `` header without enabling other C++20 features. + +The Mobile development with C++ workload for iOS and Android, as well as the Embedded and IoT tools (RTOS Viewer, Serial Monitor, Peripheral Viewer, and ST Project Import), are no longer supported and will be removed in a future update. The Android NDKs included in the Mobile development with C++ workload remain supported. This impacts tooling support for iOS and Android development, including new projects, building, and debugging. + +### Removed features + +- C++AMP +- ARM32 toolchain: if you still need to build for ARM32, use an older version of the MSVC Build Tools. For more information, see [Side-by-side Minor Version MSVC Toolsets in Visual Studio 2019](https://devblogs.microsoft.com/cppblog/side-by-side-minor-version-msvc-toolsets-in-visual-studio-2019/). +- `/DEBUG:FASTLINK` linker switch. Use [`/DEBUG:FULL`](/cpp/build/reference/debug-generate-debug-info) for improved debugging support. + +## Feedback and suggestions + +We'd love to hear from you! You can [Report a Problem or Suggest a Feature](/visualstudio/ide/how-to-report-a-problem-with-visual-studio) by using the Send Feedback icon in the upper right-hand corner of either the installer or the Visual Studio IDE, or from **Help** > **Send Feedback**. You can track your issues by using [Visual Studio Developer Community](https://developercommunity.visualstudio.com/), where you add comments or find solutions. You can also get free installation help through our [Live Chat support](https://visualstudio.microsoft.com/vs/support/#talktous). + +## Blogs + +Take advantage of the insights and recommendations available in the [Microsoft Developer Blogs](https://devblogs.microsoft.com/) site to stay up to date on all new releases. The blogs include deep dive posts on a broad range of features. The [C++ Team Blog](https://devblogs.microsoft.com/cppblog) and the [Visual Studio Blog](https://devblogs.microsoft.com/visualstudio) are of particular interest. diff --git a/docs/overview/what-s-new-for-visual-cpp-in-visual-studio.md b/docs/overview/what-s-new-for-visual-cpp-in-visual-studio.md index a24cc6cb366..491f55e9093 100644 --- a/docs/overview/what-s-new-for-visual-cpp-in-visual-studio.md +++ b/docs/overview/what-s-new-for-visual-cpp-in-visual-studio.md @@ -1,21 +1,164 @@ --- title: "What's new for C++ in Visual Studio" description: "The new features and fixes in the Microsoft C/C++ compiler and tools in Visual Studio." -ms.date: 11/12/2024 +ms.date: 11/04/2025 ms.service: "visual-cpp" ms.subservice: "ide" ms.custom: intro-whats-new ai-usage: ai-assisted --- -# What's new for C++ in Visual Studio 2022 +# What's new for C++ in Visual Studio + +Microsoft C++ Build Tools (MSVC Build Tools) versioning is no longer synchronized with Visual Studio versioning starting with Visual Studio 2026 version 18.0 and Microsoft C++ Build Tools version 14.50. For the latest updates to MSVC going forward, see [What's new for MSVC](what-s-new-for-msvc.md). + +## What's new for C++ in Visual Studio 2022 Visual Studio 2022 brings many updates and fixes to the Microsoft C++ compiler and tools. The Visual Studio IDE also offers significant improvements in performance and productivity, and now runs natively as a 64-bit application. -- For more information on what's new in all of Visual Studio, see [What's new in Visual Studio 2022](/visualstudio/ide/whats-new-visual-studio-2022?view=vs-2022&preserve-view=true). -- For information about what's new in the C++ docs, see [Microsoft C++ docs: What's new](./whats-new-cpp-docs.md). +- For more information on what's new in all of Visual Studio, see [What's new in Visual Studio 2022](/visualstudio/ide/whats-new-visual-studio-2022). - For information about version build dates, see [Visual Studio 2022 Release History](/visualstudio/releases/2022/release-history). +## What's new for C++ in Visual Studio version 17.14 + +*Released May 2025* + +| For more information about | See | +|---|---| +| What's new for C++ developers | [What's New for C++ Developers in Visual Studio 2022 17.14](https://devblogs.microsoft.com/cppblog/whats-new-for-c-developers-in-visual-studio-2022-17-14/) | +| Standard Library (STL) merged C++26 and C++23 features, Language Working Group (LWG) issue resolutions, performance improvements, enhanced behavior, and fixed bugs | [STL Changelog 17.14](https://github.com/microsoft/STL/wiki/Changelog#vs-2022-1714) | +| New features in the IDE |[Visual Studio 2022 version 17.14 Release Notes](/visualstudio/releases/2022/release-notes) | +| C++ language updates | [C++ Language Updates in MSVC in Visual Studio 2022 17.14](https://devblogs.microsoft.com/cppblog/c-language-updates-in-msvc-in-visual-studio-2022-17-14/) | +| C++ language conformance improvements | [C++ Conformance improvements, behavior changes, and bug fixes in Visual Studio 2022 17.14](cpp-conformance-improvements.md#improvements_1714) | + +A quick highlight of some of the new features: + +- C++ Dynamic Debugging allows you to debug optimized code without impacting performance. For more information, see [C++ Dynamic Debugging](/visualstudio/debugger/cpp-dynamic-debugging). +- Implemented C++23 features (requires `/std:c++latest` or `/std:c++23preview`): + - [`static operator()`](https://www.open-std.org/jtc1/sc22/wg21/docs/papers/2022/p1169r4.html) + - [`static operator[]`](https://www.open-std.org/jtc1/sc22/wg21/docs/papers/2022/p2589r1.pdf) + - [`if consteval`](https://www.open-std.org/jtc1/sc22/wg21/docs/papers/2021/p1938r3.html). Allows you to run different code depending on whether the statement is executed at compile time or run time. +- Automatically generate documentation comments with GitHub Copilot. For more information, see [Introducing automatic documentation comment generation in Visual Studio](https://devblogs.microsoft.com/visualstudio/introducing-automatic-documentation-comment-generation-in-visual-studio/). +- Use the Model Picker in Visual Studio to select your AI model for GitHub Copilot. For more information, see [Changing the AI model for Copilot Chat](https://docs.github.com/en/copilot/using-github-copilot/ai-models/changing-the-ai-model-for-copilot-chat). This screenshot shows the Model Picker at the bottom of the GitHub Copilot chat window: + :::image type="complex" source="./media/model-picker.png" alt-text="A screenshot of the GitHub Copilot chat window with the Model Picker dropdown highlighted."::: + The dropdown for the Model Picker is open. The options include: GPT-4o, o3-mini, Claude 3.7 Sonnet Thinking, and others. + :::image-end::: +- Unreal Engine integration improvements: + - The Visual Studio C++ debugger now supports Unreal Engine Blueprints. + - Commands for building files, modules, and plugins are available natively in Visual Studio. +- New compiler flag [/forceInterlockedFunctions](../build/reference/force-interlocked-functions.md) dynamically selects between Armv8.0 load, store exclusive instructions or Armv8.1 Large System Extension (LSE) atomic instructions based on CPU capability at runtime. +- Added support for IntelliSense-based completions and quick info for CMake modules in Visual Studio. You can view all available CMake modules and when you hover over a referenced CMake module, IntelliSense provides more info about the selected module: + :::image type="complex" source="./media/cmake-module-intellisense.png" alt-text="A screenshot of intellisense explaining C Make Print Helpers."::: + The screenshot is of an edit in the C Make Lists .txt file. The cursor is on include ( CMakePrintHelpers ). Intellisense says: Convenience functions for printing properties and variables, useful for debugging. + :::image-end::: + + When you start typing a CMake module name in your `CMakeLists.txt` or other CMake script files, IntelliSense provides a list of available modules to choose from: + :::image type="complex" source="./media/cmake-intellisense.png" alt-text="A screenshot of intellisense for a include statement."::: + The screenshot is of an edit in the C Make Lists .txt file. The cursor is on include ( C Make. The Intellisense dropdown contains entries for C Make Add Fortran Subdirectory, C Make Dependent Option, and more. + :::image-end::: +- Guidelines Support Library (GSL) 4.2.0: This release includes performance improvements for `gsl::span`, new features, and better alignment with C++ standards. For more information, see [Announcing Guidelines Support Library v4.2.0](https://devblogs.microsoft.com/cppblog/announcing-guidelines-support-library-v4-2-0/). + +## What's new for C++ in Visual Studio version 17.13 + +*Released February 2025* + +| For more information about | See | +|---|---| +| What's new for C++ developers | [What's New for C++ Developers in Visual Studio 2022 17.13](https://devblogs.microsoft.com/cppblog/whats-new-for-c-developers-in-visual-studio-2022-17-13/) | +| Standard Library (STL) C++26 and C++23 features, Language Working Group (LWG) issue resolutions, performance improvements, enhanced behavior, and fixed bugs | [STL Changelog 17.13](https://github.com/microsoft/STL/wiki/Changelog#vs-2022-1713) | +| New features in the IDE |[Visual Studio 2022 version 17.13 Release Notes](/visualstudio/releases/2022/release-notes-v17.13) | +| C++ language updates | [MSVC compiler updates in Visual Studio 2022 17.13](https://devblogs.microsoft.com/cppblog/msvc-compiler-updates-in-visual-studio-2022-version-17-13/) | +| C++ language conformance improvements | [C++ Conformance improvements, behavior changes, and bug fixes in Visual Studio 2022 17.13](cpp-conformance-improvements.md#improvements_1713) | + +A quick highlight of some new features: + +- **C++ language enhancements** + + - Try out C++23 preview features by setting the C++ Language Standard to `/std:c++23preview`. This setting enables the latest C++23 features and bug fixes. For more information, see [/std (Specify Language Standard Version)](../build/reference/std-specify-language-standard-version.md#stdc23preview). + - Support for C++23’s `size_t` literal suffix, which helps avoid truncations or signed comparison mismatches--especially when writing loops. For example: + ```cpp + // Infinite loop if v.size > max unsigned int + for (auto i = 0u; i < v.size(); ++i) + { + ... + } + + // Fixed because of uz literal + for (auto i = 0uz; i < v.size(); ++i) + { + ... + } + ``` + + - Support for vector lengths for code generation on x86 and x64. For more information, see [/vlen](../build/reference/vlen.md). + - Support for Intel Advanced Vector Extensions 10 version 1. For more information about `/arch:AVX10.1`, see [/arch (x64)](../build/reference/arch-x64.md). + +- **Standard Library enhancements** + + - Standard library support for coroutines. In this example from [P2502R2](https://wg21.link/p2502r2), the `fib` function is a coroutine. When the `co_yield` statement is executed, `fib` is suspended and the value is returned to the caller. You can resume the `fib` coroutine later to produce more values without requiring any manual state handling: + + ```cpp + std::generator fib() + { + auto a = 0, b = 1; + + while (true) + { + co_yield std::exchange(a, std::exchange(b, a + b)); + } + } + + int answer_to_the_universe() + { + auto rng = fib() | std::views::drop(6) | std::views::take(3); + return std::ranges::fold_left(std::move(rng), 0, std::plus{}); + } + ``` + + - Moved `system_clock`, `high_resolution_clock`, and `chrono_literals` from a commonly included internal header to ``. If you see compiler errors that types like `system_clock` or user-defined literals like `1729ms` aren't recognized, include ``. + - Improved the vectorized implementations of `bitset` constructors from strings, `basic_string::find_last_of()`, `remove()`, `ranges::remove`, and the `minmax_element()` and `minmax()` algorithm families. + - Added vectorized implementations of: + - `find_end()` and `ranges::find_end` for 1-byte and 2-byte elements. + - `basic_string::find()` and `basic_string::rfind()` for a substring. + - `basic_string::rfind()` for a single character. + - Merged C++23 Defect Reports: + - [P3107R5](https://wg21.link/P3107R5) Permit an efficient implementation of ``. + - [P3235R3](https://wg21.link/P3235R3) `std::print` More types faster with less memory. + +- **GitHub Copilot** + + - GitHub Copilot Free is now available. Get 2,000 code completions and 50 chat requests per month at no cost. + - GitHub Copilot code completions provide autocomplete suggestions inline as you code. To enhance the experience of C++ developers, GitHub Copilot includes other relevant files as context. This reduces errors while offering more relevant and accurate suggestions. + - You can now request a code review from GitHub Copilot from the Git Changes window: + :::image type="complex" source="./media/vs2022-copilot-git-changes-review.png" alt-text="A screenshot of the Git Changes window with the GitHub Copilot Review button highlighted."::: + The Git Changes window is open with the GitHub Copilot Review button highlighted. + :::image-end::: + + GitHub Copilot looks for potential issues and creates comments for them: + + :::image type="complex" source="./media/vs2022-copilot-comment-example.png" alt-text="A screenshot of the GitHub Copilot explaining an issue."::: + GitHub Copilot found an issue with the line if ( is_enabled_) new_site.disable(). It says it may be a mistake and should likely be if ( is_enabled_) new_site.enable() because the intention seem to be enabling the new site if the breakpoint is enabled. + :::image-end::: + + To use this feature, ensure the following are turned on: + - **Tools** > **Options** > **Preview Features** > **Pull Request Comments** + - **Tools** > **Options** > **GitHub** > **Copilot** > **Source Control Integration** > **Enable Git preview features**. + + - GitHub Copilot Edits is a new feature that can make changes across multiple files in your project. To start a new Edits session, click **Create new edit session** at the top of the GitHub Copilot Chat window: + + :::image type="content" source="./media/vs2022-copilot-edit-session.png" alt-text="A screenshot of the GitHub Copilot Chat window. The Create new edit session button is highlighted."::: + + Describe the changes you want to make and Copilot suggests relevant edits. You can preview the edits one-by-one and accept the ones you want or make corrections: + + :::image type="complex" source="./media/vs2022-copilot-edit-session-example.png" alt-text="A screenshot of the GitHub Copilot Chat window displaying the files it edited."::: + GitHub Copilot is displaying a summary of the changes it made, such as 1. Create a new subclass range_breakpoint in include/libsdb/breakpoint.hpp" and 2. Implement the range_breakpoint class in src/breakpoint.cpp. An option to accept the changes is displayed. + :::image-end::: + + For more information, see [Iterate across multiple files more efficiently with GitHub Copilot Edits](https://devblogs.microsoft.com/visualstudio/iterate-across-multiple-files-more-efficiently-with-github-copilot-edits-preview/). + +- **CMake** + - Now supports CMake Presets v9. New macro expansions in a preset's include field. For more information, see [Macro expansion](https://cmake.org/cmake/help/latest/manual/cmake-presets.7.html#macro-expansion) in the official CMake documentation. + ## What's new for C++ in Visual Studio version 17.12 *Released November 2024* @@ -23,8 +166,8 @@ Visual Studio 2022 brings many updates and fixes to the Microsoft C++ compiler a | For more information about | See | |---|---| | What's new for C++ developers | [What's New for C++ Developers in Visual Studio 2022 17.12](https://devblogs.microsoft.com/cppblog/whats-new-for-c-developers-in-visual-studio-2022-17-12/) | -| Standard Library (STL) merged C++26 and C++23 features, LWG issue resolutions, performance improvements, enhanced behavior, and fixed bugs | [STL Changelog 17.12](https://github.com/microsoft/STL/wiki/Changelog#vs-2022-1712) | -| New features in the Visual Studio 17.12 IDE |[Visual Studio 2022 version 17.12 Release Notes](/visualstudio/releases/2022/release-notes) | +| Standard Library (STL) merged C++26 and C++23 features, Language Working Group (LWG) issue resolutions, performance improvements, enhanced behavior, and fixed bugs | [STL Changelog 17.12](https://github.com/microsoft/STL/wiki/Changelog#vs-2022-1712) | +| New features in the Visual Studio 17.12 IDE |[Visual Studio 2022 version 17.12 Release Notes](/visualstudio/releases/2022/release-notes-v17.12) | | C++ language conformance improvements in Visual Studio 2022 17.12 | [C++ Conformance improvements, behavior changes, and bug fixes in Visual Studio 2022 17.12](cpp-conformance-improvements.md#improvements_1712) | A quick highlight of some of the new features: @@ -48,7 +191,7 @@ A quick highlight of some of the new features: :::image type="complex" source="./media/copilot-smart-variable-inspection.png" alt-text="A screenshot of the Autos window. The variable named it is NULL. The Ask Copilot icon next to it is highlighted."::: The code that caused this problem is: for (auto it = h.animals_.begin(); it <= h.animals_.end(); it++). :::image-end::: - If you click Ask Copilot icon for the `it` variable, it will tell you why it is ``: + If you click Ask Copilot icon for the `it` variable, it tells you why it is ``: :::image type="complex" source="./media/copilot-smart-variable-explanation.png" alt-text="A screenshot of a GitHub Copilot window."::: This error is inside a function defined as int calculate_number_of_cats(const house& h). The GitHub Copilot message says: "The value of the expression it is NULL, which means that the iterator is not pointing to any valid element in the vector animals_. In the context of your program, it is supposed to iterate over the animals_ vector in the house object to count the number of cat objects. Why it is null. Based on the locals and call stack context: the house object h has an empty animals_ vector (size=0). The loop condition it <= h.animals_.end() is incorrect. It should be it != h.animals_.end()." :::image-end::: @@ -63,7 +206,7 @@ A quick highlight of some of the new features: - **Debugging** - New debug visualizers for `mutex`, `recursive_mutex`, and `move_iterator`. - The debugger now displays return values inline: - :::image type="content" source="./media/debugger-inline-return-values.png" alt-text="A screenshot of a tooltip showing the value 8.25. It is the result of the expression following the return statement that was stepped over."::: + :::image type="content" source="./media/debugger-inline-return-values.png" alt-text="A screenshot of a tooltip showing the value 8.25. It's the result of the expression following the return statement that was stepped over."::: ## What's new for C++ in Visual Studio version 17.11 @@ -72,8 +215,8 @@ A quick highlight of some of the new features: | For more information about | See | |---|---| | What's new for C++ developers | [What's New for C++ Developers in Visual Studio 2022 17.11](https://devblogs.microsoft.com/cppblog/whats-new-for-c-developers-in-visual-studio-2022-17-11/) | -| Standard Library (STL) merged C++26 and C++23 features, C++20 defect reports, LWG issue resolutions, performance improvements, enhanced behavior, and fixed bugs | [STL Changelog 17.11](https://github.com/microsoft/STL/wiki/Changelog#vs-2022-1711) | -| New features in the Visual Studio 17.11 IDE |[Visual Studio 2022 version 17.11 Release Notes](/visualstudio/releases/2022/release-notes) | +| Standard Library (STL) merged C++26 and C++23 features, C++20 defect reports, Language Working Group (LWG) issue resolutions, performance improvements, enhanced behavior, and fixed bugs | [STL Changelog 17.11](https://github.com/microsoft/STL/wiki/VS-2022-Changelog#vs-2022-1711) | +| New features in the Visual Studio 17.11 IDE |[Visual Studio 2022 version 17.11 Release Notes](/visualstudio/releases/2022/release-notes-v17.11) | | C++ language conformance improvements in Visual Studio 2022 17.11 | [C++ Conformance improvements, behavior changes, and bug fixes in Visual Studio 2022 17.11](cpp-conformance-improvements.md#improvements_1711) | A partial list of new features: @@ -81,7 +224,7 @@ A partial list of new features: - **Standard Library Enhancements** - The formatted output implementation now includes `std::range_formatter` and formatters for `std::pair` and `std::tuple`. - Added support for `std::println()` with no arguments. This prints a blank line as proposed in [P3142R0](https://wg21.link/P3142R0). - - Improved vectorization for several algorithms including `replace_copy()`, `replace_copy_if()`, `ranges::replace_copy`, `ranges::replace_copy_if`, `find_first_of()` and `ranges::find_first_of`, for 8-bit and 16-bit elements, `mismatch()`, `ranges::mismatch`, `count()` `ranges::count`, `find()`, `ranges::find`, `ranges::find_last`, and `ranges::iota`. + - Improved vectorization for several algorithms including `replace_copy()`, `replace_copy_if()`, `ranges::replace_copy`, `ranges::replace_copy_if`, `find_first_of()` and `ranges::find_first_of`, for 8-bit and 16-bit elements, `mismatch()`, `ranges::mismatch`, `count()`, `ranges::count`, `find()`, `ranges::find`, `ranges::find_last`, and `ranges::iota`. - **Game development in C++** - You can now add common Unreal Engine class templates, modules, and plugins from within Visual Studio. For more information, see [Add Unreal Engine classes, modules, and plugins in Visual Studio](/visualstudio/gamedev/unreal/get-started/vs-tools-unreal-add-class-module-plugin). @@ -90,7 +233,7 @@ A partial list of new features: :::image type="complex" source="./media/include-diagnostics-improved.png" alt-text="A screenshot of the improved Included Files diagnostics results."::: The Included Files view has a new column for the project. The Project column is selected and projects such as (Select All), CompilerIdC, OpenAL, common, and so on, are selected. The included files are listed by relative path and file name and grouped together. :::image-end::: -- CMake debugging +- **CMake debugging** - You can now debug your CMake scripts and `CMakeLists.txt` files in the Visual Studio debugger for CMake projects that target Linux via Windows Subsystem for Linux (WSL) or SSH. To start a CMake debugging session in Visual Studio, set a breakpoint in your `CMakeLists.txt` file and then navigate to **Project** > **Configure Cache with CMake Debugging**. - **GitHub Copilot** - When you hover over symbols in the code editor, click the Copilot **Tell me more** button in the Quick Info dialog to learn more about a given symbol: @@ -123,8 +266,8 @@ A partial list of new features: | For more information about | See | |---|---| | What's new for C++ developers | [What's new for C++ Developers in Visual Studio 2022 17.10](https://devblogs.microsoft.com/cppblog/whats-new-for-c-developers-in-visual-studio-2022-17-10/) | -| Standard Library (STL) merged C++26 and C++23 features, C++20 defect reports, LWG issue resolutions, performance improvements, enhanced behavior, and fixed bugs | [STL Changelog 17.10](https://github.com/microsoft/STL/wiki/Changelog#vs-2022-1710) | -| New features in the Visual Studio 17.10 IDE |[Visual Studio 2022 version 17.10 Release Notes](/visualstudio/releases/2022/release-notes) | +| Standard Library (STL) merged C++26 and C++23 features, C++20 defect reports, Language Working Group (LWG) issue resolutions, performance improvements, enhanced behavior, and fixed bugs | [STL Changelog 17.10](https://github.com/microsoft/STL/wiki/VS-2022-Changelog#vs-2022-1710) | +| New features in the Visual Studio 17.10 IDE |[Visual Studio 2022 version 17.10 Release Notes](/visualstudio/releases/2022/release-notes-v17.10) | | C++ language conformance improvements in Visual Studio 2022 17.10 | [C++ Conformance improvements, behavior changes, and bug fixes in Visual Studio 2022 17.10](cpp-conformance-improvements.md#improvements_1710) | A partial list of new features: @@ -144,7 +287,7 @@ A partial list of new features: :::image-end::: - **Breakpoint/Tracepoint Creation**: You can now create conditional breakpoints or tracepoints directly from expressions in the source code from the right-click menu. This works on property or field names and values from autos, locals, watch windows, or DataTips. - **Attach to Process Dialog**: The functionality provided by the Attach to Process dialog is more user-friendly. You can now easily switch between tree and list views, organize processes better with collapsible sections, and select code types with a simplified combobox. Also, the "Select/Track Window" feature is now easier to use, allowing two-way tracking: selecting a process highlights its window, and clicking on a window selects its process. -- **GitHub Copilot Integration**: GitHub Copilot and Copilot Chat extensions are now unified and now ship directly in Visual Studio. To install it, install the **GitHub Copilot** component in the **Visual Studio Installer**: +- **GitHub Copilot Integration**: GitHub Copilot and Copilot Chat extensions are now unified and ship directly in Visual Studio. To install it, install the **GitHub Copilot** component in the **Visual Studio Installer**: :::image type="complex" source="media/github-copilot-install-option.png" alt-text="Screenshot of the Visual Studio Installer GitHub Copilot installation option." lightbox="media/github-copilot-install-option-expanded.png"::: The Visual Studio installer is open to the Workloads tab. In the installation details pane, GitHub Copilot is shown as selected. :::image-end::: @@ -160,7 +303,7 @@ A partial list of new features: | For more information about | See | |---|---| | What's new for C++ developers | [What's new for C++ Developers in Visual Studio 2022 17.9](https://devblogs.microsoft.com/cppblog/whats-new-for-cpp-developers-in-visual-studio-2022-17-9/) | -| Standard Library (STL) merged C++23 features, performance improvements, enhanced behavior, LWG issue resolutions, and fixed bugs | [STL Changelog 17.9](https://github.com/microsoft/STL/wiki/Changelog#vs-2022-179) | +| Standard Library (STL) merged C++23 features, performance improvements, enhanced behavior, Language Working Group (LWG) issue resolutions, and fixed bugs | [STL Changelog 17.9](https://github.com/microsoft/STL/wiki/VS-2022-Changelog#vs-2022-179) | | New features in the Visual Studio 17.9 IDE |[Visual Studio 2022 version 17.9 Release Notes](/visualstudio/releases/2022/release-notes-v17.9) | | C++ language conformance improvements in Visual Studio 2022 17.9 | [C++ Conformance improvements, behavior changes, and bug fixes in Visual Studio 2022](cpp-conformance-improvements.md#improvements_179) | | Summary of C++ backend updates | [MSVC Backend updates since Visual Studio 2022 version 17.3](https://devblogs.microsoft.com/cppblog/msvc-backend-updates-since-visual-studio-2022-version-17-3/) | @@ -193,7 +336,7 @@ A partial list of new features: | For more information about | See | |---|---| | What's new for C++ developers | [What's new for C++ Developers in Visual Studio 2022 17.8](https://devblogs.microsoft.com/cppblog/whats-new-for-cpp-developers-in-visual-studio-2022-17-8/) | -| Standard Library (STL) merged C++26, C++23 features, C++20 extensions, LWG issue resolutions, performance improvements, enhanced behavior, and fixed bugs | [STL Changelog 17.8](https://github.com/microsoft/STL/wiki/Changelog#vs-2022-178) | +| Standard Library (STL) merged C++26, C++23 features, C++20 extensions, Language Working Group (LWG) issue resolutions, performance improvements, enhanced behavior, and fixed bugs | [STL Changelog 17.8](https://github.com/microsoft/STL/wiki/VS-2022-Changelog#vs-2022-178) | | New features in the Visual Studio 17.8 IDE |[Visual Studio 2022 version 17.8 Release Notes](/visualstudio/releases/2022/release-notes-v17.8) | | C++ language conformance improvements in Visual Studio 2022 17.8 | [C++ Conformance improvements, behavior changes, and bug fixes in Visual Studio 2022](cpp-conformance-improvements.md#improvements_178) | | An overview of C++ improvements in Visual Studio, VS Code, and vcpkg during 2023 | [A year of C++ improvements](https://devblogs.microsoft.com/cppblog/a-year-of-cpp-improvements-in-visual-studio-vs-code-and-vcpkg) | @@ -202,14 +345,14 @@ A partial list of new features: - C++ structured diagnostics in the Output window and a new problem details window that provides more information about the error. For more information, see [Structured SARIF Output](../build/reference/sarif-output.md) and [Problem Details Window](/visualstudio/ide/reference/problem-details-window). - A feature that lets you visualize the size and alignment of your classes, structs, unions, base types, or enums even before the code is compiled. Hover over the identifier and a Quick Info displays the size and alignment information. -- A feature that suggests when to mark member functions `const` because they don’t modify the object’s state. Hover over a member function and click the light bulb icon to mark the function as `const`. +- A feature that suggests when to mark member functions `const` because they don't modify the object's state. Hover over a member function and click the light bulb icon to mark the function as `const`. - Visual Studio now prompts you to mark global functions as static via a screwdriver icon that appears by the function name. Click the screwdriver icon to mark the function as static. - Unused #include directives are dimmed in the editor. You can hover over a dimmed include and use the light bulb menu to either remove that include or all unused includes. You can also add `#include` directives for entities that are indirectly included via other headers. For more information, see [Clean up C/C++ includes in Visual Studio](../ide/include-cleanup-overview.md). - More Unreal Engine support: - Unreal Engine Test Adapter lets you discover, run, manage, and debug your Unreal Engine tests without leaving the Visual Studio IDE. - With Unreal Engine Code Snippets, you can find common Unreal Engine constructs as snippets in your member list. - - Build Insights is now integrated with Visual Studio 2022 and works with MSBuild and CMake projects using MSVC. You can now see additional information about the compilation of a function such as how long it took to compile and the number of ForceInlines, and the impact of header files on build time. For more information, see [Tutorial: Troubleshoot function inlining on build time](../build-insights/tutorials/build-insights-function-view.md) and [Tutorial: Troubleshoot header file impact on build time](../build-insights/tutorials/build-insights-included-files-view.md). -- Remote Linux unit test support now lets you run your CTest and GTest tests on your remote Linux machines from Visual Studio’s Test Explorer, just like your local tests. + - Build Insights is now integrated with Visual Studio 2022 and works with MSBuild and CMake projects using MSVC. You can now see additional information about the compilation of a function such as how long it took to compile, the number of ForceInlines, and the impact of header files on build time. For more information, see [Tutorial: Troubleshoot function inlining on build time](../build-insights/tutorials/build-insights-function-view.md) and [Tutorial: Troubleshoot header file impact on build time](../build-insights/tutorials/build-insights-included-files-view.md). +- Remote Linux unit test support now lets you run your CTest and GTest tests on your remote Linux machines from Visual Studio's Test Explorer, just like your local tests. ## What's new for C++ in Visual Studio version 17.7 @@ -217,9 +360,9 @@ A partial list of new features: | For more information about | See | |---|---| -| What's new for C++ developers | [What’s new for C++ Developers in Visual Studio 2022 17.7](https://devblogs.microsoft.com/cppblog/whats-new-for-c-developers-in-visual-studio-2022-17-7/) | +| What's new for C++ developers | [What's new for C++ Developers in Visual Studio 2022 17.7](https://devblogs.microsoft.com/cppblog/whats-new-for-c-developers-in-visual-studio-2022-17-7/) | | New C++ features specific to game development | [Unleashing the Power of Visual Studio 2022 for C++ Game Development](https://devblogs.microsoft.com/visualstudio/unleashing-the-power-of-visual-studio-2022-for-c-game-development/) | -| Standard Library (STL) merged C++23 features, LWG issue resolutions, performance improvements, enhanced behavior, and fixed bugs | [STL Changelog 17.7](https://github.com/microsoft/STL/wiki/VS-2022-Changelog#vs-2022-177) | +| Standard Library (STL) merged C++23 features, Language Working Group (LWG) issue resolutions, performance improvements, enhanced behavior, and fixed bugs | [STL Changelog 17.7](https://github.com/microsoft/STL/wiki/VS-2022-Changelog#vs-2022-177) | | New features in the Visual Studio 17.7 IDE |[Visual Studio 2022 version 17.7 Release Notes](/visualstudio/releases/2022/release-notes-v17.7) | | C++ language conformance improvements in Visual Studio 2022 17.7 | [C++ Conformance improvements, behavior changes, and bug fixes in Visual Studio 2022](cpp-conformance-improvements.md#improvements_177) | @@ -239,8 +382,8 @@ A partial list of new features: | For more information about | See | |---|---| -| What's new for C++ developers | [What’s New for C++ Developers in Visual Studio 2022 17.6](https://devblogs.microsoft.com/cppblog/visual-studio-17-6-for-cpp-devs/) | -| Standard Library (STL) merged C++23 features, LWG issue resolutions, performance improvements, enhanced behavior, and fixed bugs | [STL Changelog 17.6](https://github.com/microsoft/STL/wiki/VS-2022-Changelog#vs-2022-176) | +| What's new for C++ developers | [What's New for C++ Developers in Visual Studio 2022 17.6](https://devblogs.microsoft.com/cppblog/visual-studio-17-6-for-cpp-devs/) | +| Standard Library (STL) merged C++23 features, Language Working Group (LWG) issue resolutions, performance improvements, enhanced behavior, and fixed bugs | [STL Changelog 17.6](https://github.com/microsoft/STL/wiki/VS-2022-Changelog#vs-2022-176) | | New features in the Visual Studio 17.6 IDE | [Visual Studio 2022 version 17.6 Release Notes](/visualstudio/releases/2022/release-notes-v17.6) | | C++ language conformance improvements in Visual Studio 2022 17.6 | [C++ Conformance improvements, behavior changes, and bug fixes in Visual Studio 2022](cpp-conformance-improvements.md#improvements_176) | @@ -257,13 +400,13 @@ A partial list of new features includes: | For more information about | See | |---|---| -| What's new for C++ developers | [What’s New for C++ Developers in Visual Studio 2022 17.5](https://devblogs.microsoft.com/cppblog/visual-studio-17-5-for-cpp-devs/) | -| Standard Library (STL) merged C++23 features, LWG issue resolutions, performance improvements, enhanced behavior, and fixed bugs | [STL Changelog 17.5](https://github.com/microsoft/STL/wiki/VS-2022-Changelog#vs-2022-175) | +| What's new for C++ developers | [What's New for C++ Developers in Visual Studio 2022 17.5](https://devblogs.microsoft.com/cppblog/visual-studio-17-5-for-cpp-devs/) | +| Standard Library (STL) merged C++23 features, Language Working Group (LWG) issue resolutions, performance improvements, enhanced behavior, and fixed bugs | [STL Changelog 17.5](https://github.com/microsoft/STL/wiki/VS-2022-Changelog#vs-2022-175) | | New features in the Visual Studio 17.5 IDE | [Visual Studio 2022 version 17.5 Release Notes](/visualstudio/releases/2022/release-notes-v17.5) | A partial list of new features includes: -- `std::move`, `std::forward`, `std::move_if_noexcept`, and `std::forward_like` now don't produce function calls in generated code, even in debug mode. This change avoids named casts causing unnecessary overhead in debug builds. `/permissive-` (or an option that implies it, such as `/std:c++20` or `std:c++latest`) is required. +- `std::move`, `std::forward`, `std::move_if_noexcept`, and `std::forward_like` now don't produce function calls in generated code, even in debug mode. This change avoids named casts causing unnecessary overhead in debug builds. `/permissive-` (or an option that implies it, such as `/std:c++20` or `/std:c++latest`) is required. - Added [`[[msvc::intrinsic]]`](../cpp/attributes.md#msvcintrinsic). You can apply this attribute to nonrecursive functions consisting of a single cast, which take only one parameter. - Added support for Linux Console in the Integrated Terminal, which allows for terminal I/O. - Added initial experimental support for C11 atomic primitives (``). You can enable this experimental feature with the `/experimental:c11atomics` option in `/std:c11` mode or later. @@ -296,8 +439,8 @@ A partial list of new features includes: | For more information about | See | |---|---| -| What's new for C++ developers | [What’s New for C++ Developers in Visual Studio 2022 17.4](https://devblogs.microsoft.com/cppblog/whats-new-for-cpp-developers-in-visual-studio-2022-17-4/) | -| Standard Library (STL) merged C++23 features, LWG issue resolutions, performance improvements, enhanced behavior, and fixed bugs | [STL Changelog 17.4](https://github.com/microsoft/STL/wiki/VS-2022-Changelog#vs-2022-174) | +| What's new for C++ developers | [What's New for C++ Developers in Visual Studio 2022 17.4](https://devblogs.microsoft.com/cppblog/whats-new-for-cpp-developers-in-visual-studio-2022-17-4/) | +| Standard Library (STL) merged C++23 features, Language Working Group (LWG) issue resolutions, performance improvements, enhanced behavior, and fixed bugs | [STL Changelog 17.4](https://github.com/microsoft/STL/wiki/VS-2022-Changelog#vs-2022-174) | | New features in the Visual Studio 17.4 IDE | [Visual Studio 2022 version 17.4 Release Notes](/visualstudio/releases/2022/release-notes-v17.4) | | C++ language conformance improvements in Visual Studio 2022 17.4 | [C++ Conformance improvements, behavior changes, and bug fixes in Visual Studio 2022](cpp-conformance-improvements.md#improvements_174) | @@ -329,7 +472,7 @@ A partial list of new features in 17.4: (The compiler part isn't implemented yet. The library part was implemented in C++20 mode when Ranges support was initially implemented.) - [P0881R7](https://wg21.link/p0881r7) `` - - [P2301R1](https://wg21.link/p2301r1) Add A `pmr` Alias For `std::stacktrace` + - [P2301R1](https://wg21.link/p2301r1) Add a `pmr` alias for `std::stacktrace` - [P1328R1](https://wg21.link/p1328r1) `constexpr type_info::operator==()` - [P2440R1](https://wg21.link/p2440r1) `ranges::iota`, `ranges::shift_left`, `ranges::shift_right` - [P2441R2](https://wg21.link/p2441r2) `views::join_with` @@ -345,8 +488,8 @@ A partial list of new features in 17.4: | For more information about | See | |---|---| -| What's new for C++ developers | [C++ improvements in 17.3](https://devblogs.microsoft.com/visualstudio/visual-studio-2022-17-3-is-now-available/#c-improvements) | -| Standard Library (STL) merged C++23 features, LWG issue resolutions, performance improvements, enhanced behavior, and fixed bugs | [STL Changelog 17.3](https://github.com/microsoft/STL/wiki/VS-2022-Changelog#vs-2022-173) | +| What's new for C++ developers | [C++ improvements in 17.3](https://devblogs.microsoft.com/visualstudio/visual-studio-2022-17-3-is-now-available/#c++-improvements) | +| Standard Library (STL) merged C++23 features, Language Working Group (LWG) issue resolutions, performance improvements, enhanced behavior, and fixed bugs | [STL Changelog 17.3](https://github.com/microsoft/STL/wiki/VS-2022-Changelog#vs-2022-173) | | New features in the Visual Studio 17.3 IDE | [Visual Studio 2022 version 17.3 Release Notes](/visualstudio/releases/2022/release-notes-v17.3) | | C++ language conformance improvements in Visual Studio 2022 17.3 | [C++ Conformance improvements, behavior changes, and bug fixes in Visual Studio 2022](cpp-conformance-improvements.md#improvements_173) | @@ -373,14 +516,14 @@ The responsiveness of **Go To All** is improved. Previously, results appeared af | For more information about | See | |---|---| | What's new for C++ developers | [Visual Studio 2022 17.2 is now available](https://devblogs.microsoft.com/visualstudio/visual-studio-2022-17-2-is-now-available/) | -| Standard Library (STL) merged C++20 defect reports, C++23 features, LWG issue resolutions, performance improvements, enhanced behavior, and fixed bugs | [STL Changelog 17.2](https://github.com/microsoft/STL/wiki/VS-2022-Changelog#vs-2022-172) | +| Standard Library (STL) merged C++20 defect reports, C++23 features, Language Working Group (LWG) issue resolutions, performance improvements, enhanced behavior, and fixed bugs | [STL Changelog 17.2](https://github.com/microsoft/STL/wiki/VS-2022-Changelog#vs-2022-172) | | New features in the Visual Studio 17.2 IDE | [Visual Studio 2022 version 17.2 Release Notes](/visualstudio/releases/2022/release-notes-v17.2) | | C++ language conformance improvements in Visual Studio 2022 17.2 | [C++ Conformance improvements, behavior changes, and bug fixes in Visual Studio 2022](cpp-conformance-improvements.md#improvements_172) | A partial list of new features in 17.2: - Added compiler support for C++23 feature [deducing `this`](https://wg21.link/p0847), available under the **`/std:c++latest`** option. -- Added IntelliSense support for C++23 features [deducing `this`](https://wg21.link/p0847) and [`if consteval`](http://wg21.link/p1938). +- Added IntelliSense support for C++23 features [deducing `this`](https://wg21.link/p0847) and [`if consteval`](https://wg21.link/p1938). - Added inline parameter name and type hint support, toggled by pressing **Alt+F1** or double-tapping **Ctrl**. This behavior can be customized under **Tools > Options > Text Editors > C/C++ > IntelliSense**. - Added experimental support for C++20 modules in CMake projects. This support is currently only available with the Visual Studio (MSBuild) generator. - In 17.1, we introduced peripheral register and RTOS views for embedded developers. We continue to improve the capabilities of those views with usability improvements in 17.2: @@ -388,8 +531,8 @@ A partial list of new features in 17.2: - When you double-click an RTOS object in the tool window, it adds a watch for the object. - When you select the start and end values for the stack pointer in the RTOS tool window, it opens in the memory window. - Added thread awareness for device targets to the call stack window. - - Users can now select a pin icon next to peripherals, registers, or fields to pin them the top of the Peripheral View. -- Added implementations of the remaining C++20 defect reports (also known as *backports*). All C++20 features are now available under the **`/std:c++20`** option. For more information about the implemented backports, see the [C++20 Defect Reports project](https://github.com/microsoft/STL/projects/9) in the Microsoft/STL GitHub repository and the [MSVC's STL Completes `/std:c++20`](https://devblogs.microsoft.com/cppblog/msvcs-stl-completes-stdc20/) blog post. + - Users can now select a pin icon next to peripherals, registers, or fields to pin them to the top of the Peripheral View. +- Added implementations of the remaining C++20 defect reports (also known as *backports*). All C++20 features are now available under the **`/std:c++20`** option. For more information about the implemented backports, see the [VS 2022 Changelog](https://github.com/microsoft/STL/wiki/VS-2022-Changelog#vs-2022-172) in the Microsoft/STL GitHub repository and the [MSVC's STL Completes `/std:c++20`](https://devblogs.microsoft.com/cppblog/msvcs-stl-completes-stdc20/) blog post. - We added various C++23 Library features, available under the **`/std:c++latest`** option. For more information about the new features, see the [STL Repo changelog](https://github.com/microsoft/STL/wiki/Changelog). - Improved performance of the initial C++ indexing by up to 20%, depending on the depth of the include graph. @@ -400,7 +543,7 @@ A partial list of new features in 17.2: | For more information about | See | |---|---| | What's new for C++ developers | [Visual Studio 2022 17.1 is now available!](https://devblogs.microsoft.com/visualstudio/visual-studio-2022-17-1-is-now-available/) | -| Standard Library (STL) merged C++23 features, LWG issue resolutions, performance improvements, enhanced behavior, and fixed bugs | [STL Changelog 17.1](https://github.com/microsoft/STL/wiki/VS-2022-Changelog#vs-2022-171) | +| Standard Library (STL) merged C++23 features, Language Working Group (LWG) issue resolutions, performance improvements, enhanced behavior, and fixed bugs | [STL Changelog 17.1](https://github.com/microsoft/STL/wiki/VS-2022-Changelog#vs-2022-171) | | New features in the Visual Studio 17.1 IDE | [Visual Studio 2022 version 17.1 Release Notes](/visualstudio/releases/2022/release-notes-v17.1) | | C++ language conformance improvements in Visual Studio 2022 17.1 | [C++ Conformance improvements, behavior changes, and bug fixes in Visual Studio 2022](cpp-conformance-improvements.md#improvements_171) | @@ -420,7 +563,7 @@ A partial list of new features in 17.1: | For more information about | See | |---|---| | New features in the Visual Studio 17.0 IDE | [Visual Studio 2022 version 17.0 Release Notes](/visualstudio/releases/2022/release-notes-v17.0) | -| Standard Library (STL) merged C++23 and C++26 features, C++20 defect reports, LWG issue resolutions, performance improvements, enhanced behavior, and fixed bugs | [STL Changelog 17.0](https://github.com/microsoft/STL/wiki/Changelog#vs-2022-1710) | +| Standard Library (STL) merged C++23 and C++26 features, C++20 defect reports, Language Working Group (LWG) issue resolutions, performance improvements, enhanced behavior, and fixed bugs | [STL Changelog 17.0](https://github.com/microsoft/STL/wiki/VS-2022-Changelog#vs-2022-170) | | C++ language conformance improvements in Visual Studio 2022 17.0 | [C++ Conformance improvements, behavior changes, and bug fixes in Visual Studio 2022 17.10](cpp-conformance-improvements.md#improvements_170) | An overview of some of the new features in Visual Studio 2022 version 17.0: @@ -453,12 +596,12 @@ In Visual Studio 2022, when you start your app in the debugger, you can use the ### Standard Library improvements -Select Standard Library (STL) improvements are highlighted here. For a comprehensive list of new functionality, changes, bug fixes, and performance improvements, see the STL team's [Changelog](https://github.com/microsoft/STL/wiki/Changelog#vs-2022). +Select Standard Library (STL) improvements are highlighted here. For a comprehensive list of new functionality, changes, bug fixes, and performance improvements, see the STL team's [Changelog](https://github.com/microsoft/STL/wiki/Changelog). - Added debugging visualizers to improve how the following types are displayed: `source_location`, `bind_front()`, `u8string` (and its iterators), `default_sentinel_t`, `unreachable_sentinel_t`, `ranges::empty_view`, `ranges::single_view`, `ranges::iota_view` (and its iterator/sentinel), `ranges::ref_view`, `thread`, `thread::id`, `jthread`, and `filesystem::path` - Added `[[nodiscard]]` to the `stoi()` family of functions in `` and to various functions in `` such as the `collate` member functions, `has_facet()`, and the `isalnum()` and `tolower()` families. - [P0980R1](https://wg21.link/P0980R1) Made `std::string` `constexpr` in VS 2019 16.10. Now supported for Clang. -- [P1004R2](https://wg21.link/P1004R2) Made `std::vector` `constexpr`in VS 2019 16.10. Now supported for Clang. +- [P1004R2](https://wg21.link/P1004R2) Made `std::vector` `constexpr` in VS 2019 16.10. Now supported for Clang. **Highlighted C++23 features** diff --git a/docs/overview/whats-new-cpp-docs.md b/docs/overview/whats-new-cpp-docs.md deleted file mode 100644 index 1bc8090c5c8..00000000000 --- a/docs/overview/whats-new-cpp-docs.md +++ /dev/null @@ -1,292 +0,0 @@ ---- -title: "What's new for the Microsoft C++ docs" -ms.date: 06/26/2024 -description: "A list of new articles and doc updates for the Microsoft C/C++ compiler, ATL/MFC, C runtime, and standard library docs." -ms.custom: intro-whats-new -monikerRange: '>=msvc-160' ---- - -# Microsoft C++ docs: What's new for November 2023 to June 2024 - -This article lists major changes to the Microsoft C++ docs for November 2023 to June 2024. - -- For what was new in the docs in previous months, see [What's new history](#whats-new-history). -- For what's new related to C++ in Visual Studio, see [What's new for C++ in Visual Studio](what-s-new-for-visual-cpp-in-visual-studio.md). -- For the latest C and C++ conformance with ISO standards status, see [C++ conformance improvements in Visual Studio](cpp-conformance-improvements.md). - -### C/C++ compiler intrinsics and assembly language - -**Updated articles** - -- [ARM64 intrinsics](../intrinsics/arm64-intrinsics.md) - added entries to table for new arm64 intrinsics - -### Active Template Library (ATL), Microsoft Foundation Classes (MFC) - -**Updated articles** - -- [Setting the Dialog Box's Background Color](../mfc/setting-the-dialog-boxs-background-color.md) - add code example for setting a dialog box's background color -- [Unicode and Multibyte Character Set (MBCS) Support](../atl-mfc-shared/unicode-and-multibyte-character-set-mbcs-support.md) - Clarified MBCS support in unicode-and-multibyte-character-set-mbcs-support.md - -## C/C++ projects and build systems - -**New articles** - -- [/ARM64XFUNCTIONPADMINX64 (Minimum x64 function padding)](../build/reference/arm64-function-pad-min-x64.md) -- [/NOFUNCTIONPADSECTION (Disable function padding)](../build/reference/no-function-pad-section.md) -- [`/experimental:log` (Structured SARIF diagnostics)](../build/reference/experimental-log.md) -- [`/feature` (ARM64)](../build/reference/feature-arm64.md) -- [`/LINKREPROFULLPATHRSP` (Generate file containing absolute paths of linked files)](../build/reference/link-repro-full-path-rsp.md) -- [`/Qspectre-jmp`](../build/reference/qspectre-jmp.md) -- [`/volatileMetadata` (Generate metadata on volatile memory accesses)](../build/reference/volatile.md) -- [Structured SARIF Diagnostics](../build/reference/sarif-output.md) -- [Tutorial: Troubleshoot function inlining on build time](../build-insights/tutorials/build-insights-function-view.md) -- [Tutorial: Troubleshoot header file impact on build time](../build-insights/tutorials/build-insights-included-files-view.md) - -**Updated articles** - -- [/LARGEADDRESSAWARE (Handle Large Addresses)](../build/reference/largeaddressaware-handle-large-addresses.md) - largeaddressaware:no isn't recommended for 64-bit apps -- [/Qspectre](../build/reference/qspectre.md) - New /QSpectre flag -- [`/arch` (ARM64)](../build/reference/arch-arm64.md) - document __arm_arch macro -- [Advanced Property Page](../build/reference/advanced-property-page.md) - add SARIF diagnostics documentation -- [Linker options](../build/reference/linker-options.md) - - new flag: /LINKREPROFULLPATHRSP - - new linker switches for 17.8 -- [Linking](../build/reference/linking.md) - new linker switches for 17.8 - -### C language - -**New articles** - -- [`typeof_unqual`, `__typeof_unqual__` (C23)](../c-language/typeof-unqual-c.md) -- [`typeof`, `__typeof__` (C23)](../c-language/typeof-c.md) - -**Updated articles** - -- [C Keywords](../c-language/c-keywords.md) - conformance updates -- [C Type Specifiers](../c-language/c-type-specifiers.md) - conformance updates - -### Code quality - -**New articles** - -- [Warning C26459](../code-quality/c26459.md) -- [Warning C26837](../code-quality/c26837.md) -- [Warning C26861](../code-quality/c26861.md) -- [Warning C26862](../code-quality/c26862.md) -- [Warning C26863](../code-quality/c26863.md) -- [Warning C26864](../code-quality/c26864.md) -- [Warning C6392](../code-quality/c6392.md) -- [Warning C6393](../code-quality/c6393.md) -- [Warning C6394](../code-quality/c6394.md) -- [Warning C6396](../code-quality/c6396.md) -- [Warning C6397](../code-quality/c6397.md) -- [Warning C6398](../code-quality/c6398.md) - -**Updated articles** - -- [Using Clang-Tidy in Visual Studio](../code-quality/clang-tidy.md) - fixed code example -- [Warning C6031](../code-quality/c6031.md) - fix some code examples -- [Warning C6059](../code-quality/c6059.md) - add heuristics -- [Warning C6201](../code-quality/c6201.md) - add heuristics - -### C++ in Visual Studio - -**Updated articles** - -- [`break` statement (C++)](../cpp/break-statement-cpp.md) - doc fix -- [Examples of Lambda Expressions](../cpp/examples-of-lambda-expressions.md) - fixed code example -- [Inline functions (C++)](../cpp/inline-functions-cpp.md) - address mistakes in inline functions cpp and remove content contrasting inline functions and macros - -### Cross platform development - -**Updated articles** - -- [Install cross-platform mobile development with C++](../cross-platform/install-visual-cpp-for-cross-platform-mobile-development.md) - updates regarding Xamarin - -### C runtime library - -**Updated articles** - -- [Translation mode constants](../c-runtime-library/translation-mode-constants.md) - clarify that `_O_TEXT` is ANSI - -### C/C++ compiler and tools errors and warnings - -**New articles** - -- [Compiler Error C2323](../error-messages/compiler-errors-1/compiler-error-c2323.md) -- [Compiler Warning (level 1) C5072](../error-messages/compiler-warnings/compiler-warning-c5072.md) -- [Compiler Warning (level 4) C5266](../error-messages/compiler-warnings/compiler-warning-level-4-c5266.md) -- [Compiler warning (level 4) C5267](../error-messages/compiler-warnings/c5267.md) -- [Linker tools warning LNK4306](../error-messages/tool-errors/linker-tools-warning-lnk4306.md) -- [Linker tools warning LNK4307](../error-messages/tool-errors/linker-tools-warning-lnk4307.md) -- [Microsoft C/C++ compiler warnings C5000 through C5199](../error-messages/compiler-warnings/compiler-warnings-c5000-through-c5199.md) -- [Microsoft C/C++ compiler warnings C5200 through C5399](../error-messages/compiler-warnings/compiler-warnings-c5200-through-c5399.md) - -**Updated articles** - -- Updated several compiler error and warning topics to include or refine examples. - -### C++ in Visual Studio tutorials - -**Updated articles** - -- [Create a console calculator in C++](../get-started/tutorial-console-cpp.md) - -### Read and write code using C++ in Visual Studio - -**New articles** - -- [C++ Include Diagnostics in Visual Studio](../ide/include-diagnostics.md) -- [Visualize C/C++ macro expansion](../ide/visualize-macro-expansion.md) - -**Updated articles** - -- [Walkthrough: Deploying Your Program (C++)](../ide/walkthrough-deploying-your-program-cpp.md) - update steps - -### Linux with C++ in Visual Studio - -**Updated articles** - -- [Connect to your target Linux system in Visual Studio](../linux/connect-to-your-remote-linux-computer.md) - -### C/C++ in Visual Studio overview - -**New articles** - -- [Microsoft Visual C++ compiler versioning](../overview/compiler-versions.md) - -**Updated articles** - -- [C++ Conformance improvements, behavior changes, and bug fixes in Visual Studio 2022](../overview/cpp-conformance-improvements.md) - updates for 17.10, added `_alignof` -- [Microsoft C++ docs: What's new for August 2023 to November 2023](../overview/whats-new-cpp-docs.md) -- [What's new for C++ in Visual Studio 2022](../overview/what-s-new-for-visual-cpp-in-visual-studio.md) - updates for 17.10 - -### C++ porting and upgrade guide - -**Updated articles** - -- [C++ binary compatibility between Visual Studio versions](../porting/binary-compat-2015-2017.md) - clarify linking binaries built with different versions of the toolset - -### C/C++ preprocessor reference - -**Updated articles** - -- [Compiler warnings that are off by default](../preprocessor/compiler-warnings-that-are-off-by-default.md) - add new warning for VS 17.6 - C5266 & C5267 and add warning level info -- [Predefined macros](../preprocessor/predefined-macros.md) - documented `__arm_arch` macro - -## Overview of Windows programming in C++ - -**Updated articles** - -- [ClickOnce Deployment for Visual C++ Applications](../windows/clickonce-deployment-for-visual-cpp-applications.md) - fixed code example -- [Microsoft Visual C++ Redistributable latest supported downloads](../windows/latest-supported-vc-redist.md) - note 2013 no longer supported and other updates - -## What's new history - -This section lists major changes to the Microsoft C++ docs for August 2023 to early November 2023. - -### Active Template Library (ATL), Microsoft Foundation Classes (MFC) - -**Updated articles** - -- [CComDynamicUnkArray Class](../atl/reference/ccomdynamicunkarray-class.md) - updated remarks - -### C/C++ projects and build systems - -**New articles** - -- [`/ifcMap`](../build/reference/ifc-map.md) -- [`/Zc:checkGwOdr` (Enforce Standard C++ ODR violations under `/Gw`)](../build/reference/zc-check-gwodr.md) -- [/KERNEL (Create kernel mode binary)](../build/reference/link-code-for-kernel-mode.md) - -**Updated articles** - -- [Configure CMake debugging sessions](../build/configure-cmake-debugging-sessions.md) - updated screenshots. -- [`/permissive-` (Standards conformance)](../build/reference/permissive-standards-conformance.md) - reflect new behavior as of 17.6 -- [`/Zc:externConstexpr` (Enable extern constexpr variables)](../build/reference/zc-externconstexpr.md) - reflect new behavior as of 17.6 -- [Overview of ARM64EC ABI conventions](../build/arm64ec-windows-abi-conventions.md) - ppdated register mapping for integer registers table -- [`/DEBUG` (Generate debug info)](../build/reference/debug-generate-debug-info.md) - correct documentation for `/DEBUG:FASTLINK` and `/DEBUG` - -### Code quality - -**New articles** - -- [Build reliable and secure C++ programs](../code-quality/build-reliable-secure-programs.md) -- [Warning C6395](../code-quality/c6395.md) -- [Warning C26479](../code-quality/c26479.md) - -**Updated articles** - -- [How to specify additional code information by using `_Analysis_assume_`](../code-quality/how-to-specify-additional-code-information-by-using-analysis-assume.md) - updated remarks - -Clarified behavior for the following warnings: - -- [Warning C6053](../code-quality/c6053.md) -- [Warning C26478](../code-quality/c26478.md) -- [Warning C26817](../code-quality/c26817.md) -- [Warning C26820](../code-quality/c26820.md) - -### C++ in Visual Studio - -**New articles** - -- [`alignas` (C++)](../cpp/alignas-specifier.md) - -**Updated articles** - -- [`alignas` (C++)](../cpp/alignas-specifier.md) - updated remarks -- [if-else statement (C++)](../cpp/if-else-statement-cpp.md) - improved code examples -- [__fastcall](../cpp/fastcall.md) - added info about classes, structs, and unions -- [`decltype` (C++)](../cpp/decltype-cpp.md) - fixed code example -- [noreturn](../cpp/noreturn.md) - improved example - -### C runtime library - -**Updated articles** - -- [`fegetround`, `fesetround`](../c-runtime-library/reference/fegetround-fesetround2.md) - noted change of values for `FE_UPWARD` and `FE_DOWNWARD` - -### C/C++ compiler and tools errors and warnings - -**Updated articles** - -Clarified behavior for the following warnings: - -- [Compiler Error C2018](../error-messages/compiler-errors-1/compiler-error-c2018.md), [Compiler Error C2023](../error-messages/compiler-errors-1/compiler-error-c2023.md) -- [Compiler Error C2024](../error-messages/compiler-errors-1/compiler-error-c2024.md), [Compiler Error C2049](../error-messages/compiler-errors-1/compiler-error-c2049.md) -- [Compiler Error C2058](../error-messages/compiler-errors-1/compiler-error-c2058.md), [Compiler Error C2061](../error-messages/compiler-errors-1/compiler-error-c2061.md) -- [Compiler Error C2082](../error-messages/compiler-errors-1/compiler-error-c2082.md), [Compiler Error C2129](../error-messages/compiler-errors-1/compiler-error-c2129.md) -- [Compiler Error C2345](../error-messages/compiler-errors-1/compiler-error-c2345.md), [Compiler Error C2397](../error-messages/compiler-errors-1/compiler-error-c2397.md) -- [Compiler Error C2510](../error-messages/compiler-errors-2/compiler-error-c2510.md), [Compiler Error C2534](../error-messages/compiler-errors-2/compiler-error-c2534.md) -- [Compiler Error C2993](../error-messages/compiler-errors-2/compiler-error-c2993.md), [Compiler Error C3550](../error-messages/compiler-errors-2/compiler-error-c3550.md) -- [Compiler Error C3551](../error-messages/compiler-errors-2/compiler-error-c3551.md) -### Read and write code using C++ in Visual Studio - -**New articles** - -- [Clean up C/C++ includes in Visual Studio](../ide/include-cleanup-overview.md) -- [Configure C/C++ Include Cleanup in Visual Studio](../ide/include-cleanup-config.md) -- [Include Cleanup messages](../ide/include-cleanup-messages.md) -- [`lnt-make-member-function-const`](../ide/lnt-make-member-function-const.md) -- [`lnt-naming-convention`](../ide/lnt-naming-convention.md) - -### C/C++ in Visual Studio overview - -**Updated articles** - -- [C++ Conformance improvements, behavior changes, and bug fixes in Visual Studio 2022](../overview/cpp-conformance-improvements.md) - added conformance updates for 17.7 and 17.8. -- [What's new for C++ in Visual Studio 2022](../overview/what-s-new-for-visual-cpp-in-visual-studio.md) - updated what's new in C++. - -### C++ Standard Template Library (STL) reference - -**Updated articles** - -- [auto_ptr class](../standard-library/auto-ptr-class.md) - added deprecation info - -### Active Template Library (ATL), Microsoft Foundation Classes (MFC) - -**Updated articles** - -- [Connection maps](../mfc/reference/connection-maps.md) - corrected parameter description of `pRefCount` in `AfxConnection(Un)Advise` -- [`CSimpleStringT` Class](../atl-mfc-shared/reference/csimplestringt-class.md) - updated code example -- [MFC class hierarchy chart](../mfc/hierarchy-chart.md) - updated MFC hierarchy chart \ No newline at end of file diff --git a/docs/parallel/amp/cpp-amp-overview.md b/docs/parallel/amp/cpp-amp-overview.md index c6d4d0fb204..71492d2b0f3 100644 --- a/docs/parallel/amp/cpp-amp-overview.md +++ b/docs/parallel/amp/cpp-amp-overview.md @@ -1,7 +1,8 @@ --- -description: "Learn more about: C++ AMP Overview" title: "C++ AMP Overview" -ms.date: "11/19/2018" +description: "Learn more about: C++ AMP Overview" +ms.date: 11/19/2018 +ms.topic: concept-article helpviewer_keywords: ["C++ Accelerated Massive Parallelism, requirements", "C++ Accelerated Massive Parallelism, architecture", "C++ AMP", "C++ Accelerated Massive Parallelism, overview", "C++ Accelerated Massive Parallelism"] --- # C++ AMP Overview @@ -424,7 +425,7 @@ for (int i = 0; i <4; i++) { ## Math Libraries -C++ AMP includes two math libraries. The double-precision library in the [Concurrency::precise_math Namespace](../../parallel/amp/reference/concurrency-precise-math-namespace.md) provides support for double-precision functions. It also provides support for single-precision functions, although double-precision support on the hardware is still required. It conforms to the [C99 Specification (ISO/IEC 9899)](https://go.microsoft.com/fwlink/p/?linkid=225887). The accelerator must support full double precision. You can determine whether it does by checking the value of the [accelerator::supports_double_precision Data Member](reference/accelerator-class.md#supports_double_precision). The fast math library, in the [Concurrency::fast_math Namespace](../../parallel/amp/reference/concurrency-fast-math-namespace.md), contains another set of math functions. These functions, which support only **`float`** operands, execute more quickly but aren't as precise as those in the double-precision math library. The functions are contained in the \ header file and all are declared with `restrict(amp)`. The functions in the \ header file are imported into both the `fast_math` and `precise_math` namespaces. The **`restrict`** keyword is used to distinguish the \ version and the C++ AMP version. The following code calculates the base-10 logarithm, using the fast method, of each value that is in the compute domain. +C++ AMP includes two math libraries. The double-precision library in the [Concurrency::precise_math Namespace](../../parallel/amp/reference/concurrency-precise-math-namespace.md) provides support for double-precision functions. It also provides support for single-precision functions, although double-precision support on the hardware is still required. It conforms to the [C99 Specification (ISO/IEC 9899)](https://go.microsoft.com/fwlink/p/?linkid=225887). The accelerator must support full double precision. You can determine whether it does by checking the value of the [accelerator::supports_double_precision Data Member](reference/accelerator-class.md#supports_double_precision). The fast math library, in the [Concurrency::fast_math Namespace](../../parallel/amp/reference/concurrency-fast-math-namespace.md), contains another set of math functions. These functions, which support only **`float`** operands, execute more quickly but aren't as precise as those in the double-precision math library. The functions are contained in the \ header file and all are declared with `restrict(amp)`. The functions in the \ header file are imported into both the `fast_math` and `precise_math` namespaces. The **`restrict`** keyword is used to distinguish the \ version and the C++ AMP version. The following code calculates the base-10 logarithm, using the fast method, of each value that is in the compute domain. ```cpp #include diff --git a/docs/parallel/amp/graphics-cpp-amp.md b/docs/parallel/amp/graphics-cpp-amp.md index 745744c100f..5368ba8b88e 100644 --- a/docs/parallel/amp/graphics-cpp-amp.md +++ b/docs/parallel/amp/graphics-cpp-amp.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: Graphics (C++ AMP)" title: "Graphics (C++ AMP)" -ms.date: "11/04/2016" +description: "Learn more about: Graphics (C++ AMP)" +ms.date: 11/04/2016 --- # Graphics (C++ AMP) @@ -139,7 +139,7 @@ There are limits on the size of each dimension of the `texture` object, as shown ### Reading from Texture Objects -You can read from a `texture` object by using [texture::operator\[\]](reference/texture-class.md#operator_at), [texture::operator() Operator](reference/texture-class.md#operator_call), or [texture::get Method](reference/texture-class.md#get). The two operators return a value, not a reference. Therefore, you cannot write to a `texture` object by using `texture::operator\[\]`. +You can read from a `texture` object by using [texture::operator\[\]](reference/texture-class.md#operator_at), [texture::operator() Operator](reference/texture-class.md#operator_call), or [texture::get Method](reference/texture-class.md#get). The two operators return a value, not a reference. Therefore, you cannot write to a `texture` object by using `texture::operator[]`. ```cpp void readTexture() { @@ -377,7 +377,7 @@ void write2ComponentTexture() { Texture views whose elements are based on floating-point types—for example, float, float_2, or float_4—can also be read by using texture sampling to take advantage of hardware support for various filtering modes and addressing modes. C++ AMP supports the two filtering modes that are most common in compute scenarios—point-filtering (nearest-neighbor) and linear-filtering (weighted average)—and four addressing modes—wrapped, mirrored, clamped, and border. For more information about addressing modes, see [address_mode Enumeration](reference/concurrency-graphics-namespace-enums.md#address_mode). -In addition to modes that C++ AMP supports directly, you can access other filtering modes and addressing modes of the underlying platform by using the interop APIs to adopt a texture sampler that was created by using the platform APIs directly. For example, Direct3D supports other filtering modes such as anisotropic filtering, and can apply a different addressing mode to each dimension of a texture. You could create a texture sampler whose coordinates are wrapped vertically, mirrored horizontally, and sampled with anisotropic filtering by using the Direct3D APIs, and then leverage the sampler in your C++ AMP code by using the `make_sampler` interop API. For more information see [Texture Sampling in C++ AMP](/archive/blogs/nativeconcurrency/texture-sampling-in-c-amp) on the Parallel Programming in Native Code blog. +In addition to modes that C++ AMP supports directly, you can access other filtering modes and addressing modes of the underlying platform by using the interop APIs to adopt a texture sampler that was created by using the platform APIs directly. For example, Direct3D supports other filtering modes such as anisotropic filtering, and can apply a different addressing mode to each dimension of a texture. You could create a texture sampler whose coordinates are wrapped vertically, mirrored horizontally, and sampled with anisotropic filtering by using the Direct3D APIs, and then leverage the sampler in your C++ AMP code by using the `make_sampler` interop API. For more information, see [Texture Sampling in C++ AMP](/archive/blogs/nativeconcurrency/texture-sampling-in-c-amp) on the Parallel Programming in Native Code blog. Texture views also support the reading of mipmaps. Read-only texture views (those that have a const element type) offer the most flexibility because a range of mip-levels that is determined at instantiation can be dynamically sampled, and because elements that have 1, 2, or 4 components are supported. Read-write texture views that have elements that have one component also support mipmaps, but only of a level that's determined at instantiation. For more information, see [Texture with Mipmaps](/archive/blogs/nativeconcurrency/texture-with-mipmaps) on the Parallel Programming in Native Code blog. diff --git a/docs/parallel/amp/reference/accelerator-class.md b/docs/parallel/amp/reference/accelerator-class.md index 02b879fba94..e5f08b9b8a2 100644 --- a/docs/parallel/amp/reference/accelerator-class.md +++ b/docs/parallel/amp/reference/accelerator-class.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: accelerator Class" title: "accelerator Class" -ms.date: "11/04/2016" +description: "Learn more about: accelerator Class" +ms.date: 11/04/2016 f1_keywords: ["AMPRT/accelerator", "AMPRT/Concurrency::accelerator::accelerator", "AMPRT/Concurrency::accelerator::create_view", "AMPRT/Concurrency::accelerator::get_all", "AMPRT/Concurrency::accelerator::get_auto_selection_view", "AMPRT/Concurrency::accelerator::get_dedicated_memory", "AMPRT/Concurrency::accelerator::get_default_cpu_access_type", "AMPRT/Concurrency::accelerator::get_default_view", "AMPRT/Concurrency::accelerator::get_description", "AMPRT/Concurrency::accelerator::get_device_path", "AMPRT/Concurrency::accelerator::get_has_display", "AMPRT/Concurrency::accelerator::get_is_debug", "AMPRT/Concurrency::accelerator::get_is_emulated", "AMPRT/Concurrency::accelerator::get_supports_cpu_shared_memory", "AMPRT/Concurrency::accelerator::get_supports_double_precision", "AMPRT/Concurrency::accelerator::get_supports_limited_double_precision", "AMPRT/Concurrency::accelerator::get_version", "AMPRT/Concurrency::accelerator::set_default", "AMPRT/Concurrency::accelerator::set_default_cpu_access_type", "AMPRT/Concurrency::accelerator::cpu_accelerator", "AMPRT/Concurrency::accelerator::dedicated_memory", "AMPRT/Concurrency::accelerator::default_accelerator", "AMPRT/Concurrency::accelerator::default_cpu_access_type", "AMPRT/Concurrency::accelerator::default_view", "AMPRT/Concurrency::accelerator::description", "AMPRT/Concurrency::accelerator::device_path", "AMPRT/Concurrency::accelerator::direct3d_ref", "AMPRT/Concurrency::accelerator::direct3d_warp", "AMPRT/Concurrency::accelerator::has_display", "AMPRT/Concurrency::accelerator::is_debug", "AMPRT/Concurrency::accelerator::is_emulated", "AMPRT/Concurrency::accelerator::supports_cpu_shared_memory", "AMPRT/Concurrency::accelerator::supports_double_precision", "AMPRT/Concurrency::accelerator::supports_limited_double_precision", "AMPRT/Concurrency::accelerator::version"] helpviewer_keywords: ["accelerator class"] -ms.assetid: 37eed593-cf87-4611-9cdc-e98df6c2377a --- # accelerator Class @@ -45,7 +44,7 @@ class accelerator; |[get_supports_limited_double_precision](#get_supports_limited_double_precision)|Determines whether the `accelerator` has limited support for double-precision math.| |[get_version](#get_version)|Returns the version of the `accelerator`.| |[set_default](#set_default)|Returns the path of the default accelerator.| -|[set_default_cpu_access_type](#set_default_cpu_access_type)|Sets the default CPU [access_type](concurrency-namespace-enums-amp.md#access_type)for arrays and implicit memory allocations made on this `accelerator`.| +|[set_default_cpu_access_type](#set_default_cpu_access_type)|Sets the default CPU [access_type](concurrency-namespace-enums-amp.md#access_type) for arrays and implicit memory allocations made on this `accelerator`.| ### Public Operators @@ -62,7 +61,7 @@ class accelerator; |[cpu_accelerator](#cpu_accelerator)|Gets a string constant for the CPU `accelerator`.| |[dedicated_memory](#dedicated_memory)|Gets the dedicated memory for the `accelerator`, in kilobytes.| |[default_accelerator](#default_accelerator)|Gets a string constant for the default `accelerator`.| -|[default_cpu_access_type](#default_cpu_access_type)|Gets or sets the default CPU [access_type](concurrency-namespace-enums-amp.md#access_type)for arrays and implicit memory allocations made on this `accelerator`.| +|[default_cpu_access_type](#default_cpu_access_type)|Gets or sets the default CPU [access_type](concurrency-namespace-enums-amp.md#access_type) for arrays and implicit memory allocations made on this `accelerator`.| |[default_view](#default_view)|Gets the default `accelerator_view` object that is associated with the `accelerator`.| |[description](#description)|Gets a short description of the `accelerator` device.| |[device_path](#device_path)|Gets the path of the device.| @@ -165,7 +164,7 @@ static const wchar_t default_accelerator[]; ## default_cpu_access_type -The default cpu [access_type](concurrency-namespace-enums-amp.md#access_type)for arrays and implicit memory allocations made on this `accelerator`. +The default cpu [access_type](concurrency-namespace-enums-amp.md#access_type) for arrays and implicit memory allocations made on this `accelerator`. ```cpp __declspec(property(get= get_default_cpu_access_type)) access_type default_cpu_access_type; diff --git a/docs/parallel/amp/reference/array-class.md b/docs/parallel/amp/reference/array-class.md index ce31e23b618..5fd455d1f15 100644 --- a/docs/parallel/amp/reference/array-class.md +++ b/docs/parallel/amp/reference/array-class.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: array Class" title: "array Class" -ms.date: "11/04/2016" +description: "Learn more about: array Class" +ms.date: 11/04/2016 f1_keywords: ["array", "AMP/array", "AMP/Concurrency::array::array", "AMP/Concurrency::array::copy_to", "AMP/Concurrency::array::data", "AMP/Concurrency::array::get_accelerator_view", "AMP/Concurrency::array::get_associated_accelerator_view", "AMP/Concurrency::array::get_cpu_access_type", "AMP/Concurrency::array::get_extent", "AMP/Concurrency::array::reinterpret_as", "AMP/Concurrency::array::section", "AMP/Concurrency::array::view_as", "AMP/Concurrency::array::rank", "AMP/Concurrency::array::accelerator_view", "AMP/Concurrency::array::associated_accelerator_view", "AMP/Concurrency::array::cpu_access_type", "AMP/Concurrency::array::extent"] helpviewer_keywords: ["array class"] -ms.assetid: 0832b6c1-40f0-421d-9104-6b1baa0c63a7 --- # array Class @@ -52,7 +51,7 @@ The rank of the array. |Name|Description| |----------|-----------------| -|[`operator std::vector`](#operator_vec)|Uses `copy(*this, vector)` to implicitly convert the array to a std::[vector](../../../standard-library/vector-class.md) object.| +|[`operator std::vector`](#operator_vec)|Uses `copy(*this, vector)` to implicitly convert the array to a [std::vector](../../../standard-library/vector-class.md) object.| |[operator()](#operator_call)|Returns the element value that is specified by the parameters.| |[operator\[\]](#operator_at)|Returns the element that is at the specified index.| |[operator=](#operator_eq)|Copies the contents of the specified `array` object into this one.| @@ -362,7 +361,7 @@ explicit array( array( const array_view& _Src, - accelerator_view _Av + accelerator_view _Av, access_type _Cpu_access_type = access_type_auto) restrict(cpu); array( diff --git a/docs/parallel/amp/reference/concurrency-direct3d-namespace-functions-amp.md b/docs/parallel/amp/reference/concurrency-direct3d-namespace-functions-amp.md index d928cc4c0d3..d0a6ddd7c47 100644 --- a/docs/parallel/amp/reference/concurrency-direct3d-namespace-functions-amp.md +++ b/docs/parallel/amp/reference/concurrency-direct3d-namespace-functions-amp.md @@ -46,11 +46,12 @@ f1_keywords: ["amp/Concurrency::direct3d::abs", "amp/Concurrency::direct3d::coun ## Requirements **Header:** amp.h + **Namespace:** Concurrency ## abs -Returns the absolute value of the argument +Returns the absolute value of the argument. ```cpp inline int abs(int _X) restrict(amp); @@ -58,7 +59,7 @@ inline int abs(int _X) restrict(amp); ### Parameters -*_X*
+*_X*\ Integer value ### Return Value @@ -83,13 +84,13 @@ inline int clamp( ### Parameters -*_X*
-The value to be clamped +*_X*\ +The value to be clamped. -*_Min*
+*_Min*\ The lower bound of the clamping range. -*_Max*
+*_Max*\ The upper bound of the clamping range. ### Return Value @@ -98,7 +99,7 @@ The clamped value of `_X`. ## countbits -Counts the number of set bits in _X +Counts the number of set bits in `_X`. ```cpp inline unsigned int countbits(unsigned int _X) restrict(amp); @@ -106,12 +107,12 @@ inline unsigned int countbits(unsigned int _X) restrict(amp); ### Parameters -*_X*
+*_X*\ Unsigned integer value ### Return Value -Returns the number of set bits in _X +Returns the number of set bits in `_X`. ## create_accelerator_view @@ -121,27 +122,27 @@ Creates an [accelerator_view](accelerator-view-class.md) object from a pointer t ```cpp accelerator_view create_accelerator_view( - IUnknown * _D3D_device + IUnknown * _D3D_device, queuing_mode _Qmode = queuing_mode_automatic); accelerator_view create_accelerator_view( accelerator& _Accelerator, - bool _Disable_timeout + bool _Disable_timeout, queuing_mode _Qmode = queuing_mode_automatic); ``` ### Parameters -*_Accelerator*
+*_Accelerator*\ The accelerator on which the new accelerator_view is to be created. -*_D3D_device*
+*_D3D_device*\ The pointer to the Direct3D device interface. -*_Disable_timeout*
+*_Disable_timeout*\ A Boolean parameter that specifies whether timeout should be disabled for the newly created accelerator_view. This corresponds to the D3D11_CREATE_DEVICE_DISABLE_GPU_TIMEOUT flag for Direct3D device creation and is used to indicate if the operating system should allow workloads that take more than 2 seconds to execute without resetting the device per the Windows timeout detection and recovery mechanism. Use of this flag is recommended if you need to perform time consuming tasks on the accelerator_view. -*_Qmode*
+*_Qmode*\ The [queuing_mode](concurrency-namespace-enums-amp.md#queuing_mode) to be used for the newly created accelerator_view. This parameter has a default value of `queuing_mode_automatic`. ## Return Value @@ -166,7 +167,7 @@ void __cdecl d3d_access_lock(accelerator_view& _Av); ### Parameters -*_Av*
+*_Av*\ The accelerator_view to lock. ## d3d_access_try_lock @@ -179,7 +180,7 @@ bool __cdecl d3d_access_try_lock(accelerator_view& _Av); ### Parameters -*_Av*
+*_Av*\ The accelerator_view to lock. ### Return Value @@ -196,12 +197,12 @@ void __cdecl d3d_access_unlock(accelerator_view& _Av); ### Parameters -*_Av*
+*_Av*\ The accelerator_view for which the lock is to be released. ## firstbithigh -Gets the location of the first set bit in _X, beginning with the highest-order bit and moving towards the lowest-order bit. +Gets the location of the first set bit in `_X`, beginning with the highest-order bit and moving towards the lowest-order bit. ```cpp inline int firstbithigh(int _X) restrict(amp); @@ -209,16 +210,16 @@ inline int firstbithigh(int _X) restrict(amp); ### Parameters -*_X*
+*_X*\ Integer value ### Return Value -The location of the first set bit +The location of the first set bit. ## firstbitlow -Gets the location of the first set bit in _X, beginning with the lowest-order bit and working toward the highest-order bit. +Gets the location of the first set bit in `_X`, beginning with the lowest-order bit and working toward the highest-order bit. ```cpp inline int firstbitlow(int _X) restrict(amp); @@ -226,12 +227,12 @@ inline int firstbitlow(int _X) restrict(amp); ### Parameters -*_X*
+*_X*\ Integer value ### Return Value -Returns The location of the first set bit +Returns The location of the first set bit. ## get_buffer @@ -243,18 +244,18 @@ template< int _Rank > IUnknown *get_buffer( - const array& _Array) ; + const array& _Array); ``` ### Parameters -*value_type*
+*value_type*\ The type of elements in the array. -*_Rank*
+*_Rank*\ The rank of the array. -*_Array*
+*_Array*\ An array on a Direct3D accelerator_view for which the underlying Direct3D buffer interface is returned. ### Return Value @@ -271,7 +272,7 @@ IUnknown* get_device(const accelerator_view Av); ### Parameters -*Av*
+*Av*\ The D3D accelerator_view for which the underlying D3D device interface is returned. ### Return value @@ -280,7 +281,7 @@ The `IUnknown` interface pointer of the D3D device underlying the accelerator_vi ## imax -Determine the maximum numeric value of the arguments +Determine the maximum numeric value of the arguments. ```cpp inline int imax( @@ -290,19 +291,19 @@ inline int imax( ### Parameters -*_X*
+*_X*\ Integer value -*_Y*
+*_Y*\ Integer value ### Return Value -Return the maximum numeric value of the arguments +Return the maximum numeric value of the arguments. ## imin -Determine the minimum numeric value of the arguments +Determine the minimum numeric value of the arguments. ```cpp inline int imin( @@ -312,15 +313,15 @@ inline int imin( ### Parameters -*_X*
+*_X*\ Integer value -*_Y*
+*_Y*\ Integer value ### Return Value -Return the minimum numeric value of the arguments +Return the minimum numeric value of the arguments. ## is_timeout_disabled @@ -332,7 +333,7 @@ bool __cdecl is_timeout_disabled(const accelerator_view& _Accelerator_view); ### Parameters -*_Accelerator_view*
+*_Accelerator_view*\ The accelerator_view for which the timeout disabled setting is to be queried. ### Return Value @@ -367,13 +368,13 @@ inline unsigned int mad( ### Parameters -*_X*
+*_X*\ The first specified argument. -*_Y*
+*_Y*\ The second specified argument. -*_Z*
+*_Z*\ The third specified argument. ### Return Value @@ -392,24 +393,24 @@ template< array make_array( const extent<_Rank>& _Extent, const Concurrency::accelerator_view& _Rv, - IUnknown* _D3D_buffer) ; + IUnknown* _D3D_buffer); ``` ### Parameters -*value_type*
+*value_type*\ The element type of the array to be created. -*_Rank*
+*_Rank*\ The rank of the array to be created. -*_Extent*
+*_Extent*\ An extent that describes the shape of the array aggregate. -*_Rv*
+*_Rv*\ A D3D accelerator view on which the array is to be created. -*_D3D_buffer*
+*_D3D_buffer*\ IUnknown interface pointer of the D3D buffer to create the array from. ### Return Value @@ -418,7 +419,7 @@ An array created using the provided Direct3D buffer. ## noise -Generates a random value using the Perlin noise algorithm +Generates a random value using the Perlin noise algorithm. ```cpp inline float noise(float _X) restrict(amp); @@ -426,16 +427,16 @@ inline float noise(float _X) restrict(amp); ### Parameters -*_X*
-Floating-point value from which to generate Perlin noise +*_X*\ +Floating-point value from which to generate Perlin noise. ### Return Value -Returns The Perlin noise value within a range between -1 and 1 +Returns the Perlin noise value within a range between -1 and 1. ## radians -Converts _X from degrees to radians +Converts `_X` from degrees to radians. ```cpp inline float radians(float _X) restrict(amp); @@ -443,12 +444,12 @@ inline float radians(float _X) restrict(amp); ### Parameters -*_X*
+*_X*\ Floating-point value ### Return Value -Returns _X converted from degrees to radians +Returns `_X` converted from degrees to radians. ## rcp @@ -462,7 +463,7 @@ inline double rcp(double _X) restrict(amp); ### Parameters -*_X*
+*_X*\ The value for which to compute the reciprocal. ### Return Value @@ -471,7 +472,7 @@ The reciprocal of the specified argument. ## reversebits -Reverses the order of the bits in _X +Reverses the order of the bits in `_X`. ```cpp inline unsigned int reversebits(unsigned int _X) restrict(amp); @@ -479,16 +480,16 @@ inline unsigned int reversebits(unsigned int _X) restrict(amp); ### Parameters -*_X*
+*_X*\ Unsigned integer value ### Return Value -Returns the value with the bit order reversed in _X +Returns the value with the bit order reversed in `_X`. ## saturate -Clamps _X within the range of 0 to 1 +Clamps `_X` within the range of 0 to 1. ```cpp inline float saturate(float _X) restrict(amp); @@ -496,12 +497,12 @@ inline float saturate(float _X) restrict(amp); ### Parameters -*_X*
+*_X*\ Floating-point value ### Return Value -Returns _X clamped within the range of 0 to 1 +Returns `_X` clamped within the range of 0 to 1. ## sign @@ -513,7 +514,7 @@ inline int sign(int _X) restrict(amp); ### Parameters -*_X*
+*_X*\ Integer value ### Return Value @@ -522,7 +523,7 @@ The sign of the argument. ## smoothstep -Returns a smooth Hermite interpolation between 0 and 1, if _X is in the range [_Min, _Max]. +Returns a smooth Hermite interpolation between 0 and 1, if `_X` is in the range [_Min, _Max]. ```cpp inline float smoothstep( @@ -533,22 +534,22 @@ inline float smoothstep( ### Parameters -*_Min*
+*_Min*\ Floating-point value -*_Max*
+*_Max*\ Floating-point value -*_X*
+*_X*\ Floating-point value ### Return Value -Returns 0 if _X is less than _Min; 1 if _X is greater than _Max; otherwise, a value between 0 and 1 if _X is in the range [_Min, _Max] +Returns 0 if `_X` is less than _Min; 1 if `_X` is greater than _Max; otherwise, a value between 0 and 1 if `_X` is in the range [_Min, _Max]. ## step -Compares two values, returning 0 or 1 based on which value is greater +Compares two values, returning 0 or 1 based on which value is greater. ```cpp inline float step( @@ -558,19 +559,19 @@ inline float step( ### Parameters -*_Y*
+*_Y*\ Floating-point value -*_X*
+*_X*\ Floating-point value ### Return Value -Returns 1 if the _X is greater than or equal to _Y; otherwise, 0 +Returns 1 if the `_X` is greater than or equal to `_Y`; otherwise, 0. ## umax -Determine the maximum numeric value of the arguments +Determine the maximum numeric value of the arguments. ```cpp inline unsigned int umax( @@ -580,19 +581,19 @@ inline unsigned int umax( ### Parameters -*_X*
+*_X*\ Integer value -*_Y*
+*_Y*\ Integer value ### Return Value -Return the maximum numeric value of the arguments +Return the maximum numeric value of the arguments. ## umin -Determine the minimum numeric value of the arguments +Determine the minimum numeric value of the arguments. ```cpp inline unsigned int umin( @@ -602,15 +603,15 @@ inline unsigned int umin( ### Parameters -*_X*
+*_X*\ Integer value -*_Y*
+*_Y*\ Integer value ### Return Value -Return the minimum numeric value of the arguments +Return the minimum numeric value of the arguments. ## See also diff --git a/docs/parallel/amp/reference/concurrency-graphics-direct3d-namespace.md b/docs/parallel/amp/reference/concurrency-graphics-direct3d-namespace.md index ff00042ac40..05afb7f5aed 100644 --- a/docs/parallel/amp/reference/concurrency-graphics-direct3d-namespace.md +++ b/docs/parallel/amp/reference/concurrency-graphics-direct3d-namespace.md @@ -1,9 +1,8 @@ --- -description: "Learn more about: Concurrency::graphics::direct3d Namespace" title: "Concurrency::graphics::direct3d Namespace" -ms.date: "11/04/2016" +description: "Learn more about: Concurrency::graphics::direct3d Namespace" +ms.date: 11/04/2016 f1_keywords: ["amp_graphics/Concurrency::graphics::direct3d", "amp_short_vectors/Concurrency::graphics::direct3d"] -ms.assetid: be283331-07cf-46e4-91a1-e8aa85d4ec8e --- # Concurrency::graphics::direct3d Namespace @@ -19,13 +18,13 @@ namespace direct3d; ### Functions -|Name

Description| -|--------------------------| -|[get_sampler](concurrency-graphics-direct3d-namespace-functions.md#get_sampler)

Get the Direct3D sampler state interface on the given accelerator view that represents the specified sampler object.| -|[get_texture](concurrency-graphics-direct3d-namespace-functions.md#get_texture)

Gets the Direct3D texture interface underlying the specified [texture](texture-class.md) object.| -|[make_sampler](concurrency-graphics-direct3d-namespace-functions.md#make_sampler)

Create a sampler from a Direct3D sampler state interface pointer.| -|[make_texture](concurrency-graphics-direct3d-namespace-functions.md#make_texture)

Creates a [texture](texture-class.md) object by using the specified parameters.| -|[msad4](concurrency-graphics-direct3d-namespace-functions.md#msad4)

Compares a 4-byte reference value and an 8-byte source value and accumulates a vector of 4 sums.| +|Name|Description| +|----------|-----------------| +|[get_sampler](concurrency-graphics-direct3d-namespace-functions.md#get_sampler)|Get the Direct3D sampler state interface on the given accelerator view that represents the specified sampler object.| +|[get_texture](concurrency-graphics-direct3d-namespace-functions.md#get_texture)|Gets the Direct3D texture interface underlying the specified [texture](texture-class.md) object.| +|[make_sampler](concurrency-graphics-direct3d-namespace-functions.md#make_sampler)|Create a sampler from a Direct3D sampler state interface pointer.| +|[make_texture](concurrency-graphics-direct3d-namespace-functions.md#make_texture)|Creates a [texture](texture-class.md) object by using the specified parameters.| +|[msad4](concurrency-graphics-direct3d-namespace-functions.md#msad4)|Compares a 4-byte reference value and an 8-byte source value and accumulates a vector of 4 sums.| ## Requirements diff --git a/docs/parallel/amp/reference/concurrency-graphics-namespace-functions.md b/docs/parallel/amp/reference/concurrency-graphics-namespace-functions.md index ac0f29d6764..e9e8eef1890 100644 --- a/docs/parallel/amp/reference/concurrency-graphics-namespace-functions.md +++ b/docs/parallel/amp/reference/concurrency-graphics-namespace-functions.md @@ -1,14 +1,12 @@ --- -description: "Learn more about: Concurrency::graphics namespace functions" title: "Concurrency::graphics namespace functions" -ms.date: "11/04/2016" +description: "Learn more about: Concurrency::graphics namespace functions" +ms.date: 11/04/2016 f1_keywords: ["amp_graphics/Concurrency::fast_math::copy_async", "amp_graphics/Concurrency::fast_math::copy"] -ms.assetid: ace01cd5-29d3-4356-930e-c81a61c5f934 --- # Concurrency::graphics namespace functions -[copy](#copy)\ -[copy_async](#copy_async) +The following functions are available in the `Concurrency::graphics` namespace: ## copy Function (Concurrency::graphics Namespace) diff --git a/docs/parallel/amp/reference/concurrency-namespace-constants-amp.md b/docs/parallel/amp/reference/concurrency-namespace-constants-amp.md index b3e6db41fd9..a03bea4d1af 100644 --- a/docs/parallel/amp/reference/concurrency-namespace-constants-amp.md +++ b/docs/parallel/amp/reference/concurrency-namespace-constants-amp.md @@ -1,16 +1,14 @@ --- -description: "Learn more about: Concurrency namespace constants (AMP)" title: "Concurrency namespace constants (AMP)" -ms.date: "11/04/2016" +description: "Learn more about: Concurrency namespace constants (AMP)" +ms.date: 11/04/2016 f1_keywords: ["amp/Concurrency::HLSL_MAX_NUM_BUFFERS", "amp/Concurrency::MODULENAME_MAX_LENGTH"] -ms.assetid: 13a8e8cd-2eec-4e60-a91d-5d271072747b --- # Concurrency namespace constants (AMP) -[HLSL_MAX_NUM_BUFFERS](#hlsl_max_num_buffers)\ -[MODULENAME_MAX_LENGTH](#modulename_max_length) +The following constants are defined in the `Concurrency` namespace (AMP): -## HLSL_MAX_NUM_BUFFERS Constant +## `HLSL_MAX_NUM_BUFFERS` Constant The maximum number of buffers allowed by DirectX. @@ -18,9 +16,9 @@ The maximum number of buffers allowed by DirectX. static const UINT HLSL_MAX_NUM_BUFFERS = 64 + 128; ``` -## MODULENAME_MAX_LENGTH Constant +## `MODULENAME_MAX_LENGTH` constant -Stores the maximum length of the module name. This value must be the same on the compiler and runtime. +Stores the maximum length of the module name. This value must be the same at compile time and runtime. ```cpp static const UINT MODULENAME_MAX_LENGTH = 1024; diff --git a/docs/parallel/amp/reference/concurrency-namespace-enums-amp.md b/docs/parallel/amp/reference/concurrency-namespace-enums-amp.md index 55a34e9c713..feef3abec33 100644 --- a/docs/parallel/amp/reference/concurrency-namespace-enums-amp.md +++ b/docs/parallel/amp/reference/concurrency-namespace-enums-amp.md @@ -1,18 +1,14 @@ --- -description: "Learn more about: Concurrency namespace enums (AMP)" title: "Concurrency namespace enums (AMP)" -ms.date: "11/04/2016" +description: "Learn more about: Concurrency namespace enums (AMP)" +ms.date: 11/04/2016 f1_keywords: ["amp/Concurrency::access_type", "amp/Concurrency::queuing_mode"] -ms.assetid: 4c87457e-184f-4992-81ab-ca75e7d524ab --- -# Concurrency namespace enums (AMP) - -[access_type Enumeration](#access_type)\ -[queuing_mode Enumeration](#queuing_mode) +# `Concurrency` namespace enums (AMP) -## access_type Enumeration +The following enumerations are available in the `Concurrency` namespace: -Enumeration type used to denote the various types of access to data. +## `access_type` enumeration ```cpp enum access_type; @@ -28,7 +24,7 @@ enum access_type; |`access_type_read_write`|Shared. The allocation is accessible on the accelerator and is writable on the CPU.| |`access_type_write`|Shared. The allocation is accessible on the accelerator and is both readable and writable on the CPU.| -## queuing_mode Enumeration +## `queuing_mode` enumeration Specifies the queuing modes that are supported on the accelerator. diff --git a/docs/parallel/amp/reference/concurrency-precise-math-namespace-functions.md b/docs/parallel/amp/reference/concurrency-precise-math-namespace-functions.md index a7908a8b415..fba9b56557b 100644 --- a/docs/parallel/amp/reference/concurrency-precise-math-namespace-functions.md +++ b/docs/parallel/amp/reference/concurrency-precise-math-namespace-functions.md @@ -1,7 +1,7 @@ --- title: "Concurrency::precise_math namespace functions" description: "Learn more about: Concurrency::precise_math namespace functions" -ms.date: "11/04/2016" +ms.date: 11/04/2016 f1_keywords: ["amp_math/Concurrency::precise_math::acos", "amp_math/Concurrency::precise_math::acosh", "amp_math/Concurrency::precise_math::acoshf", "amp_math/Concurrency::precise_math::asinf", "amp_math/Concurrency::precise_math::asinh", "amp_math/Concurrency::precise_math::atan", "amp_math/Concurrency::precise_math::atan2", "amp_math/Concurrency::precise_math::atanf", "amp_math/Concurrency::precise_math::atanh", "amp_math/Concurrency::precise_math::cbrt", "amp_math/Concurrency::precise_math::cbrtf", "amp_math/Concurrency::precise_math::ceilf", "amp_math/Concurrency::precise_math::copysign", "amp_math/Concurrency::precise_math::cos", "amp_math/Concurrency::precise_math::cosf", "amp_math/Concurrency::precise_math::coshf", "amp_math/Concurrency::precise_math::cospi", "amp_math/Concurrency::precise_math::erf", "amp_math/Concurrency::precise_math::erfc", "amp_math/Concurrency::precise_math::erfcinv", "amp_math/Concurrency::precise_math::erfcinvf", "amp_math/Concurrency::precise_math::erfinv", "amp_math/Concurrency::precise_math::erfinvf", "amp_math/Concurrency::precise_math::exp10", "amp_math/Concurrency::precise_math::exp10f", "amp_math/Concurrency::precise_math::exp2f", "amp_math/Concurrency::precise_math::expf", "amp_math/Concurrency::precise_math::expm1f", "amp_math/Concurrency::precise_math::fabs", "amp_math/Concurrency::precise_math::floor", "amp_math/Concurrency::precise_math::fdim", "amp_math/Concurrency::precise_math::floorf", "amp_math/Concurrency::precise_math::fmaf", "amp_math/Concurrency::precise_math::fmaxf", "amp_math/Concurrency::precise_math::fmin", "amp_math/Concurrency::precise_math::fmod", "amp_math/Concurrency::precise_math::fmodf", "amp_math/Concurrency::precise_math::frexp", "amp_math/Concurrency::precise_math::frexpf", "amp_math/Concurrency::precise_math::hypotf", "amp_math/Concurrency::precise_math::ilogb", "amp_math/Concurrency::precise_math::isfinite", "amp_math/Concurrency::precise_math::isinf", "amp_math/Concurrency::precise_math::isnormal", "amp_math/Concurrency::precise_math::ldexp", "amp_math/Concurrency::precise_math::lgamma", "amp_math/Concurrency::precise_math::lgammaf", "amp_math/Concurrency::precise_math::log10", "amp_math/Concurrency::precise_math::log10f", "amp_math/Concurrency::precise_math::log1pf", "amp_math/Concurrency::precise_math::log2", "amp_math/Concurrency::precise_math::logb", "amp_math/Concurrency::precise_math::logbf", "amp_math/Concurrency::precise_math::modf", "amp_math/Concurrency::precise_math::modff", "amp_math/Concurrency::precise_math::nanf", "amp_math/Concurrency::precise_math::nearbyint", "amp_math/Concurrency::precise_math::nextafter", "amp_math/Concurrency::precise_math::nextafterf", "amp_math/Concurrency::precise_math::phif", "amp_math/Concurrency::precise_math::pow", "amp_math/Concurrency::precise_math::probit", "amp_math/Concurrency::precise_math::probitf", "amp_math/Concurrency::precise_math::rcbrtf", "amp_math/Concurrency::precise_math::remainder", "amp_math/Concurrency::precise_math::remquo", "amp_math/Concurrency::precise_math::remquof", "amp_math/Concurrency::precise_math::roundf", "amp_math/Concurrency::precise_math::rsqrt", "amp_math/Concurrency::precise_math::scalb", "amp_math/Concurrency::precise_math::scalbf", "amp_math/Concurrency::precise_math::scalbnf", "amp_math/Concurrency::precise_math::signbit", "amp_math/Concurrency::precise_math::sin", "amp_math/Concurrency::precise_math::sincos", "amp_math/Concurrency::precise_math::sinf", "amp_math/Concurrency::precise_math::sinh", "amp_math/Concurrency::precise_math::sinpi", "amp_math/Concurrency::precise_math::sinpif", "amp_math/Concurrency::precise_math::sqrtf", "amp_math/Concurrency::precise_math::tan", "amp_math/Concurrency::precise_math::tanh", "amp_math/Concurrency::precise_math::tanhf", "amp_math/Concurrency::precise_math::tanpif", "amp_math/Concurrency::precise_math::tgamma", "amp_math/Concurrency::precise_math::trunc", "amp_math/Concurrency::precise_math::truncf"] --- # Concurrency::precise_math namespace functions @@ -983,6 +983,7 @@ inline double fdim( *_X*
Floating-point value + *_Y*
Floating-point value @@ -1005,6 +1006,7 @@ inline float fdimf( *_X*
Floating-point value + *_Y*
Floating-point value @@ -1070,8 +1072,10 @@ inline double fma( *_X*
The first floating-point argument. + *_Y*
The second floating-point argument. + *_Z*
The third floating-point argument. @@ -1095,8 +1099,10 @@ inline float fmaf( *_X*
The first floating-point argument. + *_Y*
The second floating-point argument. + *_Z*
The third floating-point argument. diff --git a/docs/parallel/amp/reference/extent-class.md b/docs/parallel/amp/reference/extent-class.md index d14304486f9..f547bd38c0f 100644 --- a/docs/parallel/amp/reference/extent-class.md +++ b/docs/parallel/amp/reference/extent-class.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: extent Class (C++ AMP)" title: "extent Class (C++ AMP)" -ms.date: "03/27/2019" +description: "Learn more about: extent Class (C++ AMP)" +ms.date: 03/27/2019 f1_keywords: ["extent", "AMP/extent", "AMP/Concurrency::extent::extent", "AMP/Concurrency::extent::contains", "AMP/Concurrency::extent::size", "AMP/Concurrency::extent::tile", "AMP/Concurrency::extent::rank Constant"] helpviewer_keywords: ["extent structure"] -ms.assetid: edb5de3d-3935-4dbb-8365-4cc6c4fb0269 --- # extent Class (C++ AMP) @@ -375,8 +374,10 @@ tiled_extent<_Dim0, _Dim1, _Dim2> tile() const ; *_Dim0*
The most significant component of the tiled extent. + *_Dim1*
The next-to-most-significant component of the tiled extent. + *_Dim2*
The least significant component of the tiled extent. diff --git a/docs/parallel/amp/reference/runtime-exception-class.md b/docs/parallel/amp/reference/runtime-exception-class.md index 663c5148d04..ae03941949e 100644 --- a/docs/parallel/amp/reference/runtime-exception-class.md +++ b/docs/parallel/amp/reference/runtime-exception-class.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: runtime_exception Class" title: "runtime_exception Class" -ms.date: "03/27/2019" +description: "Learn more about: runtime_exception Class" +ms.date: 03/27/2019 f1_keywords: ["runtime_exception", "AMPRT/runtime_exception", "AMPRT/Concurrency::runtime_exception", "AMPRT/Concurrency::runtime_exception::get_error_code"] helpviewer_keywords: ["runtime_exception class"] -ms.assetid: 8fe3ce2c-3d4c-4b9c-95e8-e592f37adefd --- # runtime_exception Class @@ -82,7 +81,7 @@ The `runtime_exception` object to copy. The `runtime_exception` object. -## ~runtime_exception Destructor +## ~runtime_exception Destructor Destroys the object. diff --git a/docs/parallel/amp/reference/texture-class.md b/docs/parallel/amp/reference/texture-class.md index f99e078681b..67d5044baea 100644 --- a/docs/parallel/amp/reference/texture-class.md +++ b/docs/parallel/amp/reference/texture-class.md @@ -1,13 +1,12 @@ --- -description: "Learn more about: texture Class" title: "texture Class" -ms.date: "11/04/2016" +description: "Learn more about: texture Class" +ms.date: 11/04/2016 f1_keywords: ["texture", "AMP_GRAPHICS/texture", "AMP_GRAPHICS/concurrency::graphics::texture::texture", "AMP_GRAPHICS/concurrency::graphics::texture::copy_to", "AMP_GRAPHICS/concurrency::graphics::texture::data", "AMP_GRAPHICS/concurrency::graphics::texture::get", "AMP_GRAPHICS/concurrency::graphics::texture::get_associated_accelerator_view", "AMP_GRAPHICS/concurrency::graphics::texture::get_depth_pitch", "AMP_GRAPHICS/concurrency::graphics::texture::get_row_pitch", "AMP_GRAPHICS/concurrency::graphics::texture::set", "AMP_GRAPHICS/concurrency::graphics::texture::rank", "AMP_GRAPHICS/concurrency::graphics::texture::associated_accelerator_view", "AMP_GRAPHICS/concurrency::graphics::texture::depth_pitch", "AMP_GRAPHICS/concurrency::graphics::texture::row_pitch"] -ms.assetid: 16e85d4d-e80a-474a-995d-8bf63fbdf34c --- # texture Class -A texture is a data aggregate on an `accelerator_view` in the extent domain. It is a collection of variables, one for each element in an extent domain. Each variable holds a value corresponding to C++ primitive type ( **`unsigned int`**, **`int`**, **`float`**, **`double`**), a scalar type ( `norm`, or `unorm`), or a short vector type. +A texture is a data aggregate on an `accelerator_view` in the extent domain. It is a collection of variables, one for each element in an extent domain. Each variable holds a value corresponding to C++ primitive type ( **`unsigned int`**, **`int`**, **`float`**, **`double`**), a scalar type (`norm`, or `unorm`), or a short vector type. ## Syntax diff --git a/docs/parallel/amp/reference/texture-view-class.md b/docs/parallel/amp/reference/texture-view-class.md index 610f6fedf52..2ab64c9f966 100644 --- a/docs/parallel/amp/reference/texture-view-class.md +++ b/docs/parallel/amp/reference/texture-view-class.md @@ -40,7 +40,7 @@ The rank of the `texture_view`. |----------|-----------------| |`value_type`|The type of the elements in the texture aggregates.| |`coordinates_type`|The type of the coordinate used to specify a texel in the `texture_view`—that is, a `short_vector` that has the same rank as the associated texture that has a value type of **`float`**.| -|`gather_return_type`|The return type used for gather operations—that is, a rank 4 `short_vector` that holds the four homogenous color components gathered from the four texel values sampled.| +|`gather_return_type`|The return type used for gather operations—that is, a rank 4 `short_vector` that holds the four homogeneous color components gathered from the four texel values sampled.| ### Public Constructors diff --git a/docs/parallel/amp/using-accelerator-and-accelerator-view-objects.md b/docs/parallel/amp/using-accelerator-and-accelerator-view-objects.md index cb5312d9690..5546f803840 100644 --- a/docs/parallel/amp/using-accelerator-and-accelerator-view-objects.md +++ b/docs/parallel/amp/using-accelerator-and-accelerator-view-objects.md @@ -1,11 +1,12 @@ --- -description: "Learn more about: Using accelerator and accelerator_view Objects" title: "Using accelerator and accelerator_view Objects" +description: "Learn more about: Using accelerator and accelerator_view Objects" ms.date: "11/04/2016" +ms.topic: how-to --- # Using accelerator and accelerator_view Objects -You can use the [accelerator](../../parallel/amp/reference/accelerator-class.md) and [accelerator_view](../../parallel/amp/reference/accelerator-view-class.md) classes to specify the device or emulator to run your C++ AMP code on. A system might have several devices or emulators that differ by amount of memory, shared memory support, debugging support, or double-precision support. C++ Accelerated Massive Parallelism (C++ AMP) provides APIs that you can use to examine the available accelerators, set one as the default, specify multiple accelerator_views for multiple calls to parallel_for_each, and perform special debugging tasks. +You can use the [accelerator](reference/accelerator-class.md) and [accelerator_view](reference/accelerator-view-class.md) classes to specify the device or emulator to run your C++ AMP code on. A system might have several devices or emulators that differ by amount of memory, shared memory support, debugging support, or double-precision support. C++ Accelerated Massive Parallelism (C++ AMP) provides APIs that you can use to examine the available accelerators, set one as the default, specify multiple accelerator_views for multiple calls to parallel_for_each, and perform special debugging tasks. > [!NOTE] > C++ AMP headers are deprecated starting with Visual Studio 2022 version 17.0. @@ -45,7 +46,7 @@ void default_properties() { ### CPPAMP_DEFAULT_ACCELERATOR Environment Variable -You can set the CPPAMP_DEFAULT_ACCELERATOR environment variable to specify the `accelerator::device_path` of the default accelerator. The path is hardware-dependent. The following code uses the `accelerator::get_all` function to retrieve a list of the available accelerators and then displays the path and characteristics of each accelerator. +You can set the `CPPAMP_DEFAULT_ACCELERATOR` environment variable to specify the `accelerator::device_path` of the default accelerator. The path is hardware-dependent. The following code uses the `accelerator::get_all` function to retrieve a list of the available accelerators and then displays the path and characteristics of each accelerator. ```cpp void list_all_accelerators() @@ -160,7 +161,7 @@ There are two ways to use multiple accelerators in your app: - You can pass `accelerator_view` objects to the calls to the [parallel_for_each](reference/concurrency-namespace-functions-amp.md#parallel_for_each) method. -- You can construct an **array** object using a specific `accelerator_view` object. The C+AMP runtime will pick up the `accelerator_view` object from the captured **array** object in the lambda expression. +- You can construct an **array** object using a specific `accelerator_view` object. The C++ AMP runtime will pick up the `accelerator_view` object from the captured **array** object in the lambda expression. ## Special Accelerators @@ -178,6 +179,6 @@ The C++ AMP runtime supports interoperability between the `accelerator_view` cla ## See also -[C++ AMP (C++ Accelerated Massive Parallelism)](../../parallel/amp/cpp-amp-cpp-accelerated-massive-parallelism.md)
-[Debugging GPU Code](/visualstudio/debugger/debugging-gpu-code)
-[accelerator_view Class](../../parallel/amp/reference/accelerator-view-class.md) +[C++ AMP (C++ Accelerated Massive Parallelism)](cpp-amp-cpp-accelerated-massive-parallelism.md)\ +[Debugging GPU Code](/visualstudio/debugger/debugging-gpu-code)\ +[accelerator_view Class](reference/accelerator-view-class.md) diff --git a/docs/parallel/amp/using-cpp-amp-in-windows-store-apps.md b/docs/parallel/amp/using-cpp-amp-in-windows-store-apps.md index 7068a8bd01d..48032eb464a 100644 --- a/docs/parallel/amp/using-cpp-amp-in-windows-store-apps.md +++ b/docs/parallel/amp/using-cpp-amp-in-windows-store-apps.md @@ -2,6 +2,7 @@ description: "Learn more about: Using C++ AMP in UWP Apps" title: "Using C++ AMP in UWP Apps" ms.date: "11/04/2016" +ms.topic: concept-article --- # Using C++ AMP in UWP Apps diff --git a/docs/parallel/amp/using-lambdas-function-objects-and-restricted-functions.md b/docs/parallel/amp/using-lambdas-function-objects-and-restricted-functions.md index 8daf3188924..dfe089c6702 100644 --- a/docs/parallel/amp/using-lambdas-function-objects-and-restricted-functions.md +++ b/docs/parallel/amp/using-lambdas-function-objects-and-restricted-functions.md @@ -2,6 +2,7 @@ description: "Learn more about: Using Lambdas, Function Objects, and Restricted Functions" title: "Using Lambdas, Function Objects, and Restricted Functions" ms.date: "11/04/2016" +ms.topic: concept-article --- # Using Lambdas, Function Objects, and Restricted Functions diff --git a/docs/parallel/amp/using-tiles.md b/docs/parallel/amp/using-tiles.md index a68f6a66b8f..e8b2840cdca 100644 --- a/docs/parallel/amp/using-tiles.md +++ b/docs/parallel/amp/using-tiles.md @@ -2,6 +2,7 @@ description: "Learn more about: Using Tiles" title: "Using Tiles" ms.date: "11/19/2018" +ms.topic: how-to --- # Using Tiles diff --git a/docs/parallel/concrt/asynchronous-message-blocks.md b/docs/parallel/concrt/asynchronous-message-blocks.md index 54f4c8092f9..dbbe11f411c 100644 --- a/docs/parallel/concrt/asynchronous-message-blocks.md +++ b/docs/parallel/concrt/asynchronous-message-blocks.md @@ -1,9 +1,8 @@ --- -description: "Learn more about: Asynchronous Message Blocks" title: "Asynchronous Message Blocks" -ms.date: "11/04/2016" +description: "Learn more about: Asynchronous Message Blocks" +ms.date: 11/04/2016 helpviewer_keywords: ["non-greedy join [Concurrency Runtime]", "asynchronous message blocks", "greedy join [Concurrency Runtime]"] -ms.assetid: 79c456c0-1692-480c-bb67-98f2434c1252 --- # Asynchronous Message Blocks @@ -257,7 +256,7 @@ The [concurrency::join](../../parallel/concrt/reference/join-class.md) and [conc Reading from a `join` or `multitype_join` object resembles calling the Windows API function `WaitForMultipleObjects` when it has the `bWaitAll` parameter set to `TRUE`. However, just like a `choice` object, `join` and `multitype_join` objects use an event mechanism that binds data to the event itself instead of to an external synchronization object. -Reading from a `join` object produces a std::[vector](../../standard-library/vector-class.md) object. Reading from a `multitype_join` object produces a std::[tuple](../../standard-library/tuple-class.md) object. Elements appear in these objects in the same order as their corresponding source buffers are linked to the `join` or `multitype_join` object. Because the order in which you link source buffers to a `join` or `multitype_join` object is associated with the order of elements in the resulting `vector` or `tuple` object, we recommend that you do not unlink an existing source buffer from a join. Doing so can result in unspecified behavior. +Reading from a `join` object produces a [std::vector](../../standard-library/vector-class.md) object. Reading from a `multitype_join` object produces a [std::tuple](../../standard-library/tuple-class.md) object. Elements appear in these objects in the same order as their corresponding source buffers are linked to the `join` or `multitype_join` object. Because the order in which you link source buffers to a `join` or `multitype_join` object is associated with the order of elements in the resulting `vector` or `tuple` object, we recommend that you do not unlink an existing source buffer from a join. Doing so can result in unspecified behavior. ### Greedy Versus Non-Greedy Joins @@ -285,7 +284,7 @@ For complete examples that show how to use the `join` class, see [How to: Select ## timer Class -The concurrency::[timer class](../../parallel/concrt/reference/timer-class.md) acts as a message source. A `timer` object sends a message to a target after a specified period of time has elapsed. The `timer` class is useful when you must delay sending a message or you want to send a message at a regular interval. +The [concurrency::timer class](../../parallel/concrt/reference/timer-class.md) acts as a message source. A `timer` object sends a message to a target after a specified period of time has elapsed. The `timer` class is useful when you must delay sending a message or you want to send a message at a regular interval. The `timer` class sends its message to just one target. If you set the `_PTarget` parameter in the constructor to `NULL`, you can later specify the target by calling the [concurrency::ISource::link_target](reference/source-block-class.md#link_target) method. diff --git a/docs/parallel/concrt/best-practices-in-the-asynchronous-agents-library.md b/docs/parallel/concrt/best-practices-in-the-asynchronous-agents-library.md index 88a23f3247a..f41406f07f4 100644 --- a/docs/parallel/concrt/best-practices-in-the-asynchronous-agents-library.md +++ b/docs/parallel/concrt/best-practices-in-the-asynchronous-agents-library.md @@ -4,6 +4,7 @@ title: "Best Practices in the Asynchronous Agents Library" ms.date: 08/25/2021 helpviewer_keywords: ["best practices, Asynchronous Agents Library", "Asynchronous Agents Library, best practices", "Asynchronous Agents Library, practices to avoid", "practices to avoid, Asynchronous Agents Library"] ms.assetid: 85f52354-41eb-4b0d-98c5-f7344ee8a8cf +ms.topic: best-practice --- # Best Practices in the Asynchronous Agents Library diff --git a/docs/parallel/concrt/best-practices-in-the-parallel-patterns-library.md b/docs/parallel/concrt/best-practices-in-the-parallel-patterns-library.md index 6a1a2286785..34ef2be1166 100644 --- a/docs/parallel/concrt/best-practices-in-the-parallel-patterns-library.md +++ b/docs/parallel/concrt/best-practices-in-the-parallel-patterns-library.md @@ -4,6 +4,7 @@ title: "Best Practices in the Parallel Patterns Library" ms.date: "11/04/2016" helpviewer_keywords: ["Parallel Patterns Library, practices to avoid", "practices to avoid, Parallel Patterns Library", "best practices, Parallel Patterns Library", "Parallel Patterns Library, best practices"] ms.assetid: e43e0304-4d54-4bd8-a3b3-b8673559a9d7 +ms.topic: best-practice --- # Best Practices in the Parallel Patterns Library diff --git a/docs/parallel/concrt/cancellation-in-the-ppl.md b/docs/parallel/concrt/cancellation-in-the-ppl.md index 3d97190376d..66e4150037a 100644 --- a/docs/parallel/concrt/cancellation-in-the-ppl.md +++ b/docs/parallel/concrt/cancellation-in-the-ppl.md @@ -215,7 +215,7 @@ This example produces the following output. Caught 50 ``` -The following example uses a Boolean flag to coordinate cancellation in a `parallel_for` loop. Every task runs because this example does not use the `cancel` method or exception handling to cancel the overall set of tasks. Therefore, this technique can have more computational overhead than a cancelation mechanism. +The following example uses a Boolean flag to coordinate cancellation in a `parallel_for` loop. Every task runs because this example does not use the `cancel` method or exception handling to cancel the overall set of tasks. Therefore, this technique can have more computational overhead than a cancellation mechanism. [!code-cpp[concrt-task-tree#8](../../parallel/concrt/codesnippet/cpp/cancellation-in-the-ppl_14.cpp)] diff --git a/docs/parallel/concrt/codesnippet/CPP/cancellation-in-the-ppl_12.cpp b/docs/parallel/concrt/codesnippet/CPP/cancellation-in-the-ppl_12.cpp index 54a60e82783..93413d211ca 100644 --- a/docs/parallel/concrt/codesnippet/CPP/cancellation-in-the-ppl_12.cpp +++ b/docs/parallel/concrt/codesnippet/CPP/cancellation-in-the-ppl_12.cpp @@ -1,4 +1,4 @@ - // To enable cancelation, call parallel_for in a task group. + // To enable cancellation, call parallel_for in a task group. structured_task_group tg; task_group_status status = tg.run_and_wait([&] { diff --git a/docs/parallel/concrt/codesnippet/CPP/cancellation-in-the-ppl_14.cpp b/docs/parallel/concrt/codesnippet/CPP/cancellation-in-the-ppl_14.cpp index 501bef3171f..20dc01ea24a 100644 --- a/docs/parallel/concrt/codesnippet/CPP/cancellation-in-the-ppl_14.cpp +++ b/docs/parallel/concrt/codesnippet/CPP/cancellation-in-the-ppl_14.cpp @@ -1,4 +1,4 @@ - // Create a Boolean flag to coordinate cancelation. + // Create a Boolean flag to coordinate cancellation. bool canceled = false; parallel_for(0, 100, [&](int i) { diff --git a/docs/parallel/concrt/codesnippet/CPP/cancellation-in-the-ppl_6.cpp b/docs/parallel/concrt/codesnippet/CPP/cancellation-in-the-ppl_6.cpp index a2fd7307692..64bd96b60aa 100644 --- a/docs/parallel/concrt/codesnippet/CPP/cancellation-in-the-ppl_6.cpp +++ b/docs/parallel/concrt/codesnippet/CPP/cancellation-in-the-ppl_6.cpp @@ -23,7 +23,7 @@ for (int i = 0; i < 1000; ++i) { // To reduce overhead, occasionally check for - // cancelation. + // cancellation. if ((i%100) == 0) { if (tg2.is_canceling()) diff --git a/docs/parallel/concrt/codesnippet/CPP/exception-handling-in-the-concurrency-runtime_6.cpp b/docs/parallel/concrt/codesnippet/CPP/exception-handling-in-the-concurrency-runtime_6.cpp index ca2b028026c..516134985e6 100644 --- a/docs/parallel/concrt/codesnippet/CPP/exception-handling-in-the-concurrency-runtime_6.cpp +++ b/docs/parallel/concrt/codesnippet/CPP/exception-handling-in-the-concurrency-runtime_6.cpp @@ -18,7 +18,7 @@ int wmain() { parallel_for(-5, 20, [min,max](int i) { - // Throw an exeception if the input value is less than the + // Throw an exception if the input value is less than the // minimum or greater than the maximum. // Otherwise, print the value to the console. diff --git a/docs/parallel/concrt/codesnippet/CPP/how-to-create-a-task-that-completes-after-a-delay_1.cpp b/docs/parallel/concrt/codesnippet/CPP/how-to-create-a-task-that-completes-after-a-delay_1.cpp index 19ec97fbf8d..07d9a402d18 100644 --- a/docs/parallel/concrt/codesnippet/CPP/how-to-create-a-task-that-completes-after-a-delay_1.cpp +++ b/docs/parallel/concrt/codesnippet/CPP/how-to-create-a-task-that-completes-after-a-delay_1.cpp @@ -28,7 +28,7 @@ task complete_after(unsigned int timeout) }); } -// Cancels the provided task after the specifed delay, if the task +// Cancels the provided task after the specified delay, if the task // did not complete. template task cancel_after_timeout(task t, cancellation_token_source cts, unsigned int timeout) diff --git a/docs/parallel/concrt/codesnippet/CPP/how-to-create-a-task-that-completes-after-a-delay_3.cpp b/docs/parallel/concrt/codesnippet/CPP/how-to-create-a-task-that-completes-after-a-delay_3.cpp index 05fa30ae3d4..efdf43e9507 100644 --- a/docs/parallel/concrt/codesnippet/CPP/how-to-create-a-task-that-completes-after-a-delay_3.cpp +++ b/docs/parallel/concrt/codesnippet/CPP/how-to-create-a-task-that-completes-after-a-delay_3.cpp @@ -38,7 +38,7 @@ task complete_after(unsigned int timeout) }); } -// Cancels the provided task after the specifed delay, if the task +// Cancels the provided task after the specified delay, if the task // did not complete. template task cancel_after_timeout(task t, cancellation_token_source cts, unsigned int timeout) diff --git a/docs/parallel/concrt/comparing-synchronization-data-structures-to-the-windows-api.md b/docs/parallel/concrt/comparing-synchronization-data-structures-to-the-windows-api.md index db3fe945cdf..bd772a4ef62 100644 --- a/docs/parallel/concrt/comparing-synchronization-data-structures-to-the-windows-api.md +++ b/docs/parallel/concrt/comparing-synchronization-data-structures-to-the-windows-api.md @@ -4,6 +4,7 @@ title: "Comparing Synchronization Data Structures to the Windows API" ms.date: "11/04/2016" helpviewer_keywords: ["synchronization data structures, compared to Windows API", "event class, example"] ms.assetid: 8b0b1a3a-ef80-408c-91fa-93e6af920b4e +ms.topic: concept-article --- # Comparing Synchronization Data Structures to the Windows API diff --git a/docs/parallel/concrt/comparing-the-concurrency-runtime-to-other-concurrency-models.md b/docs/parallel/concrt/comparing-the-concurrency-runtime-to-other-concurrency-models.md index 6ed662fcd00..6b4db8e930f 100644 --- a/docs/parallel/concrt/comparing-the-concurrency-runtime-to-other-concurrency-models.md +++ b/docs/parallel/concrt/comparing-the-concurrency-runtime-to-other-concurrency-models.md @@ -4,6 +4,7 @@ title: "Comparing the Concurrency Runtime to Other Concurrency Models" ms.date: "11/04/2016" helpviewer_keywords: ["Concurrency Runtime, compared to other models"] ms.assetid: d8b9a1f4-f15f-43c3-a5b4-c0991edf9c86 +ms.topic: concept-article --- # Comparing the Concurrency Runtime to Other Concurrency Models diff --git a/docs/parallel/concrt/concurrency-runtime-best-practices.md b/docs/parallel/concrt/concurrency-runtime-best-practices.md index a3406772d9e..17e5f8d963c 100644 --- a/docs/parallel/concrt/concurrency-runtime-best-practices.md +++ b/docs/parallel/concrt/concurrency-runtime-best-practices.md @@ -4,6 +4,7 @@ title: "Concurrency Runtime Best Practices" ms.date: "11/04/2016" helpviewer_keywords: ["best practices [Concurrency Runtime]", "Concurrency Runtime, practices to avoid", "practices to avoid [Concurrency Runtime]", "Concurrency Runtime, best practices"] ms.assetid: 7231d4be-d1e3-401d-8b66-94fd51b587c9 +ms.topic: best-practice --- # Concurrency Runtime Best Practices diff --git a/docs/parallel/concrt/contexts.md b/docs/parallel/concrt/contexts.md index 47042ab9efe..371b1142c8d 100644 --- a/docs/parallel/concrt/contexts.md +++ b/docs/parallel/concrt/contexts.md @@ -1,13 +1,12 @@ --- -description: "Learn more about: Contexts" title: "Contexts" -ms.date: "11/04/2016" +description: "Learn more about: Contexts" +ms.date: 11/04/2016 helpviewer_keywords: ["contexts [Concurrency Runtime]"] -ms.assetid: 10c1d861-8fbb-4ba0-b2ec-61876b11176e --- # Contexts -This document describes the role of contexts in the Concurrency Runtime. A thread that is attached to a scheduler is known as an *execution context*, or just *context*. The [concurrency::wait](reference/concurrency-namespace-functions.md#wait) function and the concurrency::[Context class](../../parallel/concrt/reference/context-class.md) enable you to control the behavior of contexts. Use the `wait` function to suspend the current context for a specified time. Use the `Context` class when you need more control over when contexts block, unblock, and yield, or when you want to oversubscribe the current context. +This document describes the role of contexts in the Concurrency Runtime. A thread that is attached to a scheduler is known as an *execution context*, or just *context*. The [concurrency::wait](reference/concurrency-namespace-functions.md#wait) function and the [concurrency::Context class](../../parallel/concrt/reference/context-class.md) enable you to control the behavior of contexts. Use the `wait` function to suspend the current context for a specified time. Use the `Context` class when you need more control over when contexts block, unblock, and yield, or when you want to oversubscribe the current context. > [!TIP] > The Concurrency Runtime provides a default scheduler, and therefore you are not required to create one in your application. Because the Task Scheduler helps you fine-tune the performance of your applications, we recommend that you start with the [Parallel Patterns Library (PPL)](../../parallel/concrt/parallel-patterns-library-ppl.md) or the [Asynchronous Agents Library](../../parallel/concrt/asynchronous-agents-library.md) if you are new to the Concurrency Runtime. @@ -24,7 +23,7 @@ For an example that uses the `wait` function to yield the current context, and t ## The Context Class -The concurrency::[Context class](../../parallel/concrt/reference/context-class.md) provides a programming abstraction for an execution context and offers two important features: the ability to cooperatively block, unblock, and yield the current context, and the ability to oversubscribe the current context. +The [concurrency::Context class](../../parallel/concrt/reference/context-class.md) provides a programming abstraction for an execution context and offers two important features: the ability to cooperatively block, unblock, and yield the current context, and the ability to oversubscribe the current context. ### Cooperative Blocking diff --git a/docs/parallel/concrt/convert-an-openmp-loop-that-uses-a-reduction-variable.md b/docs/parallel/concrt/convert-an-openmp-loop-that-uses-a-reduction-variable.md index 456c664ae94..610f700e892 100644 --- a/docs/parallel/concrt/convert-an-openmp-loop-that-uses-a-reduction-variable.md +++ b/docs/parallel/concrt/convert-an-openmp-loop-that-uses-a-reduction-variable.md @@ -4,6 +4,7 @@ title: "How to: Convert an OpenMP Loop that Uses a Reduction Variable to Use the ms.date: "11/04/2016" helpviewer_keywords: ["converting from OpenMP to the Concurrency Runtime, reduction variables", "reduction variables, converting from OpenMP to the Concurrency Runtime"] ms.assetid: 96623f36-5e57-4d3f-8c13-669e6cd535b1 +ms.topic: how-to --- # How to: Convert an OpenMP Loop that Uses a Reduction Variable to Use the Concurrency Runtime diff --git a/docs/parallel/concrt/convert-an-openmp-loop-that-uses-cancellation.md b/docs/parallel/concrt/convert-an-openmp-loop-that-uses-cancellation.md index 2bb78350f39..0afc5284349 100644 --- a/docs/parallel/concrt/convert-an-openmp-loop-that-uses-cancellation.md +++ b/docs/parallel/concrt/convert-an-openmp-loop-that-uses-cancellation.md @@ -4,6 +4,7 @@ title: "How to: Convert an OpenMP Loop that Uses Cancellation to Use the Concurr ms.date: "11/04/2016" helpviewer_keywords: ["converting from OpenMP to the Concurrency Runtime, cancellation", "cancellation, converting from OpenMP to the Concurrency Runtime"] ms.assetid: 4b0b3c33-bfa9-4e96-ae08-aef245a39cbb +ms.topic: how-to --- # How to: Convert an OpenMP Loop that Uses Cancellation to Use the Concurrency Runtime diff --git a/docs/parallel/concrt/convert-an-openmp-loop-that-uses-exception-handling.md b/docs/parallel/concrt/convert-an-openmp-loop-that-uses-exception-handling.md index 7ccc8056816..2b4ed57d1bd 100644 --- a/docs/parallel/concrt/convert-an-openmp-loop-that-uses-exception-handling.md +++ b/docs/parallel/concrt/convert-an-openmp-loop-that-uses-exception-handling.md @@ -4,6 +4,7 @@ title: "How to: Convert an OpenMP Loop that Uses Exception Handling to Use the C ms.date: "11/04/2016" helpviewer_keywords: ["exception handling, converting from OpenMP to the Concurrency Runtime", "converting from OpenMP to the Concurrency Runtime, exception handling"] ms.assetid: 03c28196-21ba-439e-8641-afab1c283e1a +ms.topic: how-to --- # How to: Convert an OpenMP Loop that Uses Exception Handling to Use the Concurrency Runtime diff --git a/docs/parallel/concrt/creating-asynchronous-operations-in-cpp-for-windows-store-apps.md b/docs/parallel/concrt/creating-asynchronous-operations-in-cpp-for-windows-store-apps.md index 99750f5ce7c..ab148345553 100644 --- a/docs/parallel/concrt/creating-asynchronous-operations-in-cpp-for-windows-store-apps.md +++ b/docs/parallel/concrt/creating-asynchronous-operations-in-cpp-for-windows-store-apps.md @@ -4,6 +4,7 @@ title: "Creating Asynchronous Operations in C++ for UWP Apps" ms.date: "11/19/2018" helpviewer_keywords: ["Windows 8.x apps, creating C++ async operations", "Creating C++ async operations"] ms.assetid: a57cecf4-394a-4391-a957-1d52ed2e5494 +ms.topic: concept-article --- # Creating Asynchronous Operations in C++ for UWP Apps diff --git a/docs/parallel/concrt/general-best-practices-in-the-concurrency-runtime.md b/docs/parallel/concrt/general-best-practices-in-the-concurrency-runtime.md index cd72bb5c728..8e933fe5010 100644 --- a/docs/parallel/concrt/general-best-practices-in-the-concurrency-runtime.md +++ b/docs/parallel/concrt/general-best-practices-in-the-concurrency-runtime.md @@ -4,6 +4,7 @@ title: "General Best Practices in the Concurrency Runtime" ms.date: "11/04/2016" helpviewer_keywords: ["Concurrency Runtime, general best practices"] ms.assetid: ce5c784c-051e-44a6-be84-8b3e1139c18b +ms.topic: best-practice --- # General Best Practices in the Concurrency Runtime diff --git a/docs/parallel/concrt/how-to-send-a-message-at-a-regular-interval.md b/docs/parallel/concrt/how-to-send-a-message-at-a-regular-interval.md index 296c70f1280..b1eca2fb42f 100644 --- a/docs/parallel/concrt/how-to-send-a-message-at-a-regular-interval.md +++ b/docs/parallel/concrt/how-to-send-a-message-at-a-regular-interval.md @@ -1,13 +1,12 @@ --- -description: "Learn more about: How to: Send a Message at a Regular Interval" title: "How to: Send a Message at a Regular Interval" -ms.date: "11/04/2016" +description: "Learn more about: How to: Send a Message at a Regular Interval" +ms.date: 11/04/2016 helpviewer_keywords: ["timer class, example", "sending messages at regular intervals [Concurrency Runtime]"] -ms.assetid: 4b60ea6c-97c8-4d69-9f7b-ad79f3548026 --- # How to: Send a Message at a Regular Interval -This example shows how to use the concurrency::[timer class](../../parallel/concrt/reference/timer-class.md) to send a message at a regular interval. +This example shows how to use the [concurrency::timer class](../../parallel/concrt/reference/timer-class.md) to send a message at a regular interval. ## Example diff --git a/docs/parallel/concrt/how-to-use-exception-handling-to-break-from-a-parallel-loop.md b/docs/parallel/concrt/how-to-use-exception-handling-to-break-from-a-parallel-loop.md index bf77fcfa780..19797cae521 100644 --- a/docs/parallel/concrt/how-to-use-exception-handling-to-break-from-a-parallel-loop.md +++ b/docs/parallel/concrt/how-to-use-exception-handling-to-break-from-a-parallel-loop.md @@ -1,9 +1,8 @@ --- -description: "Learn more about: How to: Use Exception Handling to Break from a Parallel Loop" title: "How to: Use Exception Handling to Break from a Parallel Loop" -ms.date: "11/04/2016" +description: "Learn more about: How to: Use Exception Handling to Break from a Parallel Loop" +ms.date: 11/04/2016 helpviewer_keywords: ["search algorithm, writing [Concurrency Runtime]", "writing a search algorithm [Concurrency Runtime]"] -ms.assetid: 16d7278c-2d10-4014-9f58-f1899e719ff9 --- # How to: Use Exception Handling to Break from a Parallel Loop @@ -23,7 +22,7 @@ The following example shows the `for_all` method. It uses the [concurrency::para [!code-cpp[concrt-task-tree-search#1](../../parallel/concrt/codesnippet/cpp/how-to-use-exception-handling-to-break-from-a-parallel-loop_2.cpp)] -## Example: Search the tree for a value +## Example: Search the tree for a value The following example shows the `search_for_value` function, which searches for a value in the provided `tree` object. This function passes to the `for_all` method a work function that throws when it finds a tree node that contains the provided value. diff --git a/docs/parallel/concrt/migrating-from-openmp-to-the-concurrency-runtime.md b/docs/parallel/concrt/migrating-from-openmp-to-the-concurrency-runtime.md index 15d2ff642bd..8cce219c996 100644 --- a/docs/parallel/concrt/migrating-from-openmp-to-the-concurrency-runtime.md +++ b/docs/parallel/concrt/migrating-from-openmp-to-the-concurrency-runtime.md @@ -5,6 +5,7 @@ ms.date: "11/04/2016" helpviewer_keywords: ["Concurrency Runtime, migrating from OpenMP", "OpenMP, migrating to the Concurrency Runtime"] ms.assetid: 9bab7bb1-e45d-44b2-8509-3b226be2c93b ms.custom: intro-migration +ms.topic: upgrade-and-migration-article --- # Migrating from OpenMP to the Concurrency Runtime diff --git a/docs/parallel/concrt/overview-of-the-concurrency-runtime.md b/docs/parallel/concrt/overview-of-the-concurrency-runtime.md index e36669177c0..5c241631492 100644 --- a/docs/parallel/concrt/overview-of-the-concurrency-runtime.md +++ b/docs/parallel/concrt/overview-of-the-concurrency-runtime.md @@ -4,6 +4,7 @@ title: "Overview of the Concurrency Runtime" ms.date: "11/19/2018" helpviewer_keywords: ["Concurrency Runtime, requirements", "Concurrency Runtime, architecture", "Concurrency Runtime, overview", "Concurrency Runtime, lambda expressions"] ms.assetid: 56237d96-10b0-494a-9cb4-f5c5090436c5 +ms.topic: concept-article --- # Overview of the Concurrency Runtime diff --git a/docs/parallel/concrt/parallel-algorithms.md b/docs/parallel/concrt/parallel-algorithms.md index b9f60473e1a..8fb96cb02df 100644 --- a/docs/parallel/concrt/parallel-algorithms.md +++ b/docs/parallel/concrt/parallel-algorithms.md @@ -1,9 +1,9 @@ --- -description: "Learn more about: Parallel Algorithms" title: "Parallel Algorithms" -ms.date: "11/19/2018" +description: "Learn more about: Parallel Algorithms" +ms.date: 11/19/2018 helpviewer_keywords: ["parallel algorithms [Concurrency Runtime]"] -ms.assetid: 045dca7b-4d73-4558-a44c-383b88a28473 +ms.topic: how-to --- # Parallel Algorithms @@ -143,7 +143,7 @@ You can use the `parallel transform` algorithm to perform many data parallelizat - Perform 3-D ray tracing, where each iteration refers to one pixel that must be rendered. -The following example shows the basic structure that is used to call the `parallel_transform` algorithm. This example negates each element of a std::[vector](../../standard-library/vector-class.md) object in two ways. The first way uses a lambda expression. The second way uses [std::negate](../../standard-library/negate-struct.md), which derives from [std::unary_function](../../standard-library/unary-function-struct.md). +The following example shows the basic structure that is used to call the `parallel_transform` algorithm. This example negates each element of a [std::vector](../../standard-library/vector-class.md) object in two ways. The first way uses a lambda expression. The second way uses [std::negate](../../standard-library/negate-struct.md), which derives from [std::unary_function](../../standard-library/unary-function-struct.md). [!code-cpp[concrt-basic-parallel-transform#1](../../parallel/concrt/codesnippet/cpp/parallel-algorithms_4.cpp)] @@ -206,7 +206,7 @@ Divides work into ranges such that each range has at least the number of iterati Divides work into a fixed number of ranges (typically the number of worker threads that are available to work on the loop). This partitioner type can improve performance because it does not use work-stealing and therefore has less overhead. Use this partitioner type when each iteration of a parallel loop performs a fixed and uniform amount of work and you do not require support for cancellation or forward cooperative blocking. > [!WARNING] -> The `parallel_for_each` and `parallel_transform` algorithms support only containers that use random access iterators (such as std::[vector](../../standard-library/vector-class.md)) for the static, simple, and affinity partitioners. The use of containers that use bidirectional and forward iterators produces a compile-time error. The default partitioner, `auto_partitioner`, supports all three of these iterator types. +> The `parallel_for_each` and `parallel_transform` algorithms support only containers that use random access iterators (such as [std::vector](../../standard-library/vector-class.md)) for the static, simple, and affinity partitioners. The use of containers that use bidirectional and forward iterators produces a compile-time error. The default partitioner, `auto_partitioner`, supports all three of these iterator types. Typically, these partitioners are used in the same way, except for `affinity_partitioner`. Most partitioner types do not maintain state and are not modified by the runtime. Therefore you can create these partitioner objects at the call site, as shown in the following example. @@ -262,7 +262,7 @@ This example shows how to provide a hash function to the `parallel_radixsort` al For illustration, this example uses a relatively small data set. You can increase the initial size of the vector to experiment with performance improvements over larger sets of data. -This example uses a lambda expression as the hash function. You can also use one of the built-in implementations of the std::[hash class](../../standard-library/hash-class.md) or define your own specialization. You can also use a custom hash function object, as shown in this example: +This example uses a lambda expression as the hash function. You can also use one of the built-in implementations of the [std::hash class](../../standard-library/hash-class.md) or define your own specialization. You can also use a custom hash function object, as shown in this example: [!code-cpp[concrt-parallel-sort-points#2](../../parallel/concrt/codesnippet/cpp/parallel-algorithms_13.cpp)]   diff --git a/docs/parallel/concrt/reference/concurrency-namespace-functions.md b/docs/parallel/concrt/reference/concurrency-namespace-functions.md index f1aea9adb84..76ea97d01de 100644 --- a/docs/parallel/concrt/reference/concurrency-namespace-functions.md +++ b/docs/parallel/concrt/reference/concurrency-namespace-functions.md @@ -1,9 +1,8 @@ --- -description: "Learn more about: concurrency namespace functions" title: "concurrency namespace functions" -ms.date: "11/04/2016" +description: "Learn more about: concurrency namespace functions" +ms.date: 11/04/2016 f1_keywords: ["concrt/concurrency::Alloc", "concrt/concurrency::DisableTracing", "concrt/concurrency::EnableTracing", "concrtrm/concurrency::GetExecutionContextId", "concrtrm/concurrency::GetOSVersion", "concrtrm/concurrency::GetProcessorNodeCount", "concrtrm/concurrency::GetSchedulerId", "agents/concurrency::asend", "ppltasks/concurrency::cancel_current_task", "ppltasks/concurrency::create_async", "ppltasks/concurrency::create_task", "concurrent_vector/concurrency::internal_assign_iterators", "ppl/concurrency::interruption_point", "agents/concurrency::make_choice", "agents/concurrency::make_greedy_join", "ppl/concurrency::make_task", "ppl/concurrency::parallel_buffered_sort", "ppl/concurrency::parallel_for_each", "ppl/concurrency::parallel_invoke", "ppl/concurrency::parallel_reduce", "ppl/concurrency::parallel_sort", "agents/concurrency::receive", "ppl/concurrency::run_with_cancellation_token", "pplconcrt/concurrency::set_ambient_scheduler", "concrt/concurrency::set_task_execution_resources", "ppltasks/concurrency::task_from_exception", "ppltasks/concurrency::task_from_result", "concrt/concurrency::wait", "ppltasks/concurrency::when_all", "ppltasks/concurrency::when_any"] -ms.assetid: 520a6dff-9324-4df2-990d-302e3050af6a --- # concurrency namespace functions @@ -169,13 +168,13 @@ The return type of the lambda determines whether the construct is an action or a Lambdas that return void cause the creation of actions. Lambdas that return a result of type `TResult` cause the creation of operations of TResult. -The lambda may also return a `task` which encapsulates the aysnchronous work within itself or is the continuation of a chain of tasks that represent the asynchronous work. In this case, the lambda itself is executed inline, since the tasks are the ones that execute asynchronously, and the return type of the lambda is unwrapped to produce the asynchronous construct returned by `create_async`. This implies that a lambda that returns a task\ will cause the creation of actions, and a lambda that returns a task\ will cause the creation of operations of TResult. +The lambda may also return a `task` which encapsulates the asynchronous work within itself or is the continuation of a chain of tasks that represent the asynchronous work. In this case, the lambda itself is executed inline, since the tasks are the ones that execute asynchronously, and the return type of the lambda is unwrapped to produce the asynchronous construct returned by `create_async`. This implies that a lambda that returns a task\ will cause the creation of actions, and a lambda that returns a task\ will cause the creation of operations of TResult. The lambda may take either zero, one or two arguments. The valid arguments are `progress_reporter` and `cancellation_token`, in that order if both are used. A lambda without arguments causes the creation of an asynchronous construct without the capability for progress reporting. A lambda that takes a progress_reporter\ will cause `create_async` to return an asynchronous construct which reports progress of type TProgress each time the `report` method of the progress_reporter object is called. A lambda that takes a cancellation_token may use that token to check for cancellation, or pass it to tasks that it creates so that cancellation of the asynchronous construct causes cancellation of those tasks. -If the body of the lambda or function object returns a result (and not a task\), the lamdba will be executed asynchronously within the process MTA in the context of a task the Runtime implicitly creates for it. The `IAsyncInfo::Cancel` method will cause cancellation of the implicit task. +If the body of the lambda or function object returns a result (and not a task\), the lambda will be executed asynchronously within the process MTA in the context of a task the Runtime implicitly creates for it. The `IAsyncInfo::Cancel` method will cause cancellation of the implicit task. -If the body of the lambda returns a task, the lamba executes inline, and by declaring the lambda to take an argument of type `cancellation_token` you can trigger cancellation of any tasks you create within the lambda by passing that token in when you create them. You may also use the `register_callback` method on the token to cause the Runtime to invoke a callback when you call `IAsyncInfo::Cancel` on the async operation or action produced.. +If the body of the lambda returns a task, the lambda executes inline, and by declaring the lambda to take an argument of type `cancellation_token` you can trigger cancellation of any tasks you create within the lambda by passing that token in when you create them. You may also use the `register_callback` method on the token to cause the Runtime to invoke a callback when you call `IAsyncInfo::Cancel` on the async operation or action produced. This function is only available to Windows Runtime apps. @@ -1532,7 +1531,7 @@ The concurrent vector providing the elements to be swapped, or the vector whose ### Remarks -The template function is an algorithm specialized on the container class `concurrent_vector` to execute the member function `_A`. [concurrent_vector::swap](concurrent-vector-class.md#swap)( `_B`). These are instances of the partial ordering of function templates by the compiler. When template functions are overloaded in such a way that the match of the template with the function call is not unique, then the compiler will select the most specialized version of the template function. The general version of the template function, `template void swap(T&, T&)`, in the algorithm class works by assignment and is a slow operation. The specialized version in each container is much faster as it can work with the internal representation of the container class. +The template function is an algorithm specialized on the container class `concurrent_vector` to execute the member function `_A`. [concurrent_vector::swap](concurrent-vector-class.md#swap)(`_B`). These are instances of the partial ordering of function templates by the compiler. When template functions are overloaded in such a way that the match of the template with the function call is not unique, then the compiler will select the most specialized version of the template function. The general version of the template function, `template void swap(T&, T&)`, in the algorithm class works by assignment and is a slow operation. The specialized version in each container is much faster as it can work with the internal representation of the container class. This method is not concurrency-safe. You must ensure that no other threads are performing operations on either of the concurrent vectors when you call this method. diff --git a/docs/parallel/concrt/reference/concurrency-namespace.md b/docs/parallel/concrt/reference/concurrency-namespace.md index a336049731c..db453f19ce6 100644 --- a/docs/parallel/concrt/reference/concurrency-namespace.md +++ b/docs/parallel/concrt/reference/concurrency-namespace.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: concurrency Namespace" title: "concurrency Namespace" -ms.date: "11/04/2016" +description: "Learn more about: concurrency Namespace" +ms.date: 11/04/2016 f1_keywords: ["concurrent_priority_queue/concurrency", "agents/concurrency", "concurrent_vector/concurrency", "concrt/concurrency", "internal_split_ordered_list/concurrency", "concurrent_queue/concurrency", "pplcancellation_token/concurrency", "pplinterface/concurrency", "ppltasks/concurrency", "ppl/concurrency", "concurrent_unordered_map/concurrency", "concrtrm/concurrency", "concurrent_unordered_set/concurrency", "pplconcrt/concurrency", "internal_concurrent_hash/concurrency"] helpviewer_keywords: ["Concurrency namespace"] -ms.assetid: f1d33ca2-679b-4442-b140-22a9d9df61d1 --- # concurrency Namespace @@ -208,7 +207,7 @@ namespace concurrency; |[operator<=](concurrency-namespace-operators.md#operator_lt_eq)|Tests if the `concurrent_vector` object on the left side of the operator is less than or equal to the `concurrent_vector` object on the right side.| |[operator==](concurrency-namespace-operators.md#operator_eq_eq)|Tests if the `concurrent_vector` object on the left side of the operator is equal to the `concurrent_vector` object on the right side.| |[operator>](concurrency-namespace-operators.md#operator_gt)|Tests if the `concurrent_vector` object on the left side of the operator is greater than the `concurrent_vector` object on the right side.| -|[operator>=](concurrency-namespace-operators.md#operator_lt_eq)|Tests if the `concurrent_vector` object on the left side of the operator is greater than or equal to the `concurrent_vector` object on the right side.| +|[operator>=](concurrency-namespace-operators.md#operator_gt_eq)|Tests if the `concurrent_vector` object on the left side of the operator is greater than or equal to the `concurrent_vector` object on the right side.| ### Constants diff --git a/docs/parallel/concrt/reference/concurrent-priority-queue-class.md b/docs/parallel/concrt/reference/concurrent-priority-queue-class.md index 8e190a3606a..5a6ba9ae4e4 100644 --- a/docs/parallel/concrt/reference/concurrent-priority-queue-class.md +++ b/docs/parallel/concrt/reference/concurrent-priority-queue-class.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: concurrent_priority_queue Class" title: "concurrent_priority_queue Class" -ms.date: "11/04/2016" +description: "Learn more about: concurrent_priority_queue Class" +ms.date: 11/04/2016 f1_keywords: ["concurrent_priority_queue", "CONCURRENT_PRIORITY_QUEUE/concurrency::concurrent_priority_queue", "CONCURRENT_PRIORITY_QUEUE/concurrency::concurrent_priority_queue::concurrent_priority_queue", "CONCURRENT_PRIORITY_QUEUE/concurrency::concurrent_priority_queue::clear", "CONCURRENT_PRIORITY_QUEUE/concurrency::concurrent_priority_queue::empty", "CONCURRENT_PRIORITY_QUEUE/concurrency::concurrent_priority_queue::get_allocator", "CONCURRENT_PRIORITY_QUEUE/concurrency::concurrent_priority_queue::push", "CONCURRENT_PRIORITY_QUEUE/concurrency::concurrent_priority_queue::size", "CONCURRENT_PRIORITY_QUEUE/concurrency::concurrent_priority_queue::swap", "CONCURRENT_PRIORITY_QUEUE/concurrency::concurrent_priority_queue::try_pop"] helpviewer_keywords: ["concurrent_priority_queue class"] -ms.assetid: 3e740381-0f4e-41fc-8b66-ad0bb55f17a3 --- # concurrent_priority_queue Class @@ -14,10 +13,9 @@ The `concurrent_priority_queue` class is a container that allows multiple thread ```cpp template , - typename _Ax = std::allocator ->, - typename _Ax = std::allocator> class concurrent_priority_queue; + typename _Compare = std::less, + typename _Ax = std::allocator> +class concurrent_priority_queue; ``` ### Parameters diff --git a/docs/parallel/concrt/reference/concurrent-unordered-map-class.md b/docs/parallel/concrt/reference/concurrent-unordered-map-class.md index c9e47fc292c..b777495b547 100644 --- a/docs/parallel/concrt/reference/concurrent-unordered-map-class.md +++ b/docs/parallel/concrt/reference/concurrent-unordered-map-class.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: concurrent_unordered_map Class" title: "concurrent_unordered_map Class" -ms.date: "11/04/2016" +description: "Learn more about: concurrent_unordered_map Class" +ms.date: 11/04/2016 f1_keywords: ["concurrent_unordered_map", "CONCURRENT_UNORDERED_MAP/concurrency::concurrent_unordered_map", "CONCURRENT_UNORDERED_MAP/concurrency::concurrent_unordered_map::concurrent_unordered_map", "CONCURRENT_UNORDERED_MAP/concurrency::concurrent_unordered_map::at", "CONCURRENT_UNORDERED_MAP/concurrency::concurrent_unordered_map::hash_function", "CONCURRENT_UNORDERED_MAP/concurrency::concurrent_unordered_map::insert", "CONCURRENT_UNORDERED_MAP/concurrency::concurrent_unordered_map::key_eq", "CONCURRENT_UNORDERED_MAP/concurrency::concurrent_unordered_map::swap", "CONCURRENT_UNORDERED_MAP/concurrency::concurrent_unordered_map::unsafe_erase"] helpviewer_keywords: ["concurrent_unordered_map class"] -ms.assetid: b2d879dd-87ef-4af9-a266-a5443fd538b8 --- # concurrent_unordered_map Class @@ -17,18 +16,8 @@ template , typename key_equality = std::equal_to, - typename _Allocator_type = std::allocator> ->, -typename key_equality = std::equal_to, - typename _Allocator_type = std::allocator>> class concurrent_unordered_map : public details::_Concurrent_hash, - _Allocator_type, -false>>; + typename _Allocator_type = std::allocator>> +class concurrent_unordered_map : public details::_Concurrent_hash, _Allocator_type, false>>; ``` ### Parameters @@ -81,7 +70,7 @@ The type that represents the stored allocator object that encapsulates details a |Name|Description| |----------|-----------------| -|[at](#at)|Overloaded. Finds an element in a `concurrent_unordered_map` with a specified key value.. This method is concurrency-safe.| +|[at](#at)|Overloaded. Finds an element in a `concurrent_unordered_map` with a specified key value. This method is concurrency-safe.| |[hash_function](#hash_function)|Gets the stored hash function object.| |[insert](#insert)|Overloaded. Adds elements to the `concurrent_unordered_map` object.| |[key_eq](#key_eq)|Gets the stored equality comparison function object.| @@ -115,7 +104,7 @@ For detailed information on the `concurrent_unordered_map` class, see [Parallel ## at -Finds an element in a `concurrent_unordered_map` with a specified key value.. This method is concurrency-safe. +Finds an element in a `concurrent_unordered_map` with a specified key value. This method is concurrency-safe. ```cpp mapped_type& at(const key_type& KVal); @@ -430,7 +419,7 @@ A pair that contains an iterator and a boolean value. See the Remarks section fo The first member function determines whether an element X exists in the sequence whose key has equivalent ordering to that of `value`. If not, it creates such an element X and initializes it with `value`. The function then determines the iterator `where` that designates X. If an insertion occurred, the function returns `std::pair(where, true)`. Otherwise, it returns `std::pair(where, false)`. -The second member function returns insert( `value`), using `_Where` as a starting place within the controlled sequence to search for the insertion point. +The second member function returns insert(`value`), using `_Where` as a starting place within the controlled sequence to search for the insertion point. The third member function inserts the sequence of element values from the range [ `first`, `last`). @@ -476,7 +465,7 @@ void max_load_factor(float _Newmax); ### Return Value -The first member function returns the stored maximum load factor. The second member function does not return a value but throws an [out_of_range](../../../standard-library/out-of-range-class.md) exception if the supplied load factor is invalid.. +The first member function returns the stored maximum load factor. The second member function does not return a value but throws an [out_of_range](../../../standard-library/out-of-range-class.md) exception if the supplied load factor is invalid. ## max_size @@ -766,5 +755,5 @@ The maximum number of buckets in this container. ## See also -[concurrency Namespace](concurrency-namespace.md)
+[concurrency Namespace](concurrency-namespace.md)\ [Parallel Containers and Objects](../../../parallel/concrt/parallel-containers-and-objects.md) diff --git a/docs/parallel/concrt/reference/concurrent-unordered-multimap-class.md b/docs/parallel/concrt/reference/concurrent-unordered-multimap-class.md index 9ede5be1d2e..a28357a21e9 100644 --- a/docs/parallel/concrt/reference/concurrent-unordered-multimap-class.md +++ b/docs/parallel/concrt/reference/concurrent-unordered-multimap-class.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: concurrent_unordered_multimap Class" title: "concurrent_unordered_multimap Class" -ms.date: "11/04/2016" +description: "Learn more about: concurrent_unordered_multimap Class" +ms.date: 11/04/2016 f1_keywords: ["concurrent_unordered_multimap", "CONCURRENT_UNORDERED_MAP/concurrency::concurrent_unordered_multimap", "CONCURRENT_UNORDERED_MAP/concurrency::concurrent_unordered_multimap::concurrent_unordered_multimap", "CONCURRENT_UNORDERED_MAP/concurrency::concurrent_unordered_multimap::hash_function", "CONCURRENT_UNORDERED_MAP/concurrency::concurrent_unordered_multimap::insert", "CONCURRENT_UNORDERED_MAP/concurrency::concurrent_unordered_multimap::key_eq", "CONCURRENT_UNORDERED_MAP/concurrency::concurrent_unordered_multimap::swap", "CONCURRENT_UNORDERED_MAP/concurrency::concurrent_unordered_multimap::unsafe_erase"] helpviewer_keywords: ["concurrent_unordered_multimap class"] -ms.assetid: 4dada5d7-15df-4382-b9c9-348e75b2f3c1 --- # concurrent_unordered_multimap Class @@ -17,18 +16,8 @@ template , typename key_equality = std::equal_to, - typename _Allocator_type = std::allocator> ->, -typename key_equality = std::equal_to, - typename _Allocator_type = std::allocator>> class concurrent_unordered_multimap : public details::_Concurrent_hash, - _Allocator_type, -true>>; + typename _Allocator_type = std::allocator>> +class concurrent_unordered_multimap : public details::_Concurrent_hash, _Allocator_type, true>>; ``` ### Parameters @@ -403,7 +392,7 @@ An iterator pointing to the insertion location. The first member function inserts the element `value` in the controlled sequence, then returns the iterator that designates the inserted element. -The second member function returns insert( `value`), using `_Where` as a starting place within the controlled sequence to search for the insertion point. +The second member function returns insert(`value`), using `_Where` as a starting place within the controlled sequence to search for the insertion point. The third member function inserts the sequence of element values from the range [ `first`, `last`). @@ -449,7 +438,7 @@ void max_load_factor(float _Newmax); ### Return Value -The first member function returns the stored maximum load factor. The second member function does not return a value but throws an [out_of_range](../../../standard-library/out-of-range-class.md) exception if the supplied load factor is invalid.. +The first member function returns the stored maximum load factor. The second member function does not return a value but throws an [out_of_range](../../../standard-library/out-of-range-class.md) exception if the supplied load factor is invalid. ## max_size @@ -708,5 +697,5 @@ The maximum number of buckets in this container. ## See also -[concurrency Namespace](concurrency-namespace.md)
+[concurrency Namespace](concurrency-namespace.md)\ [Parallel Containers and Objects](../../../parallel/concrt/parallel-containers-and-objects.md) diff --git a/docs/parallel/concrt/reference/concurrent-unordered-multiset-class.md b/docs/parallel/concrt/reference/concurrent-unordered-multiset-class.md index 3684631591c..487bba17809 100644 --- a/docs/parallel/concrt/reference/concurrent-unordered-multiset-class.md +++ b/docs/parallel/concrt/reference/concurrent-unordered-multiset-class.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: concurrent_unordered_multiset Class" title: "concurrent_unordered_multiset Class" -ms.date: "11/04/2016" +description: "Learn more about: concurrent_unordered_multiset Class" +ms.date: 11/04/2016 f1_keywords: ["concurrent_unordered_multiset", "CONCURRENT_UNORDERED_SET/concurrency::concurrent_unordered_multiset", "CONCURRENT_UNORDERED_SET/concurrency::concurrent_unordered_multiset::concurrent_unordered_multiset", "CONCURRENT_UNORDERED_SET/concurrency::concurrent_unordered_multiset::hash_function", "CONCURRENT_UNORDERED_SET/concurrency::concurrent_unordered_multiset::insert", "CONCURRENT_UNORDERED_SET/concurrency::concurrent_unordered_multiset::key_eq", "CONCURRENT_UNORDERED_SET/concurrency::concurrent_unordered_multiset::swap", "CONCURRENT_UNORDERED_SET/concurrency::concurrent_unordered_multiset::unsafe_erase"] helpviewer_keywords: ["concurrent_unordered_multiset class"] -ms.assetid: 219d7d67-1ff0-45f4-9400-e9cc272991a4 --- # concurrent_unordered_multiset Class @@ -16,15 +15,8 @@ The `concurrent_unordered_multiset` class is an concurrency-safe container that template , typename key_equality = std::equal_to, - typename _Allocator_type = std::allocator ->, - typename key_equality = std::equal_to, - typename _Allocator_type = std::allocator> class concurrent_unordered_multiset : public details::_Concurrent_hash, -_Allocator_type, - true>>; + typename _Allocator_type = std::allocator> +class concurrent_unordered_multiset : public details::_Concurrent_hash, _Allocator_type, true>>; ``` ### Parameters @@ -391,7 +383,7 @@ An iterator pointing to the insertion location. The first member function inserts the element `value` in the controlled sequence, then returns the iterator that designates the inserted element. -The second member function returns insert( `value`), using `_Where` as a starting place within the controlled sequence to search for the insertion point. +The second member function returns insert(`value`), using `_Where` as a starting place within the controlled sequence to search for the insertion point. The third member function inserts the sequence of element values from the range [ `first`, `last`). @@ -437,7 +429,7 @@ void max_load_factor(float _Newmax); ### Return Value -The first member function returns the stored maximum load factor. The second member function does not return a value but throws an [out_of_range](../../../standard-library/out-of-range-class.md) exception if the supplied load factor is invalid.. +The first member function returns the stored maximum load factor. The second member function does not return a value but throws an [out_of_range](../../../standard-library/out-of-range-class.md) exception if the supplied load factor is invalid. ## max_size @@ -694,5 +686,5 @@ The maximum number of buckets in this container. ## See also -[concurrency Namespace](concurrency-namespace.md)
+[concurrency Namespace](concurrency-namespace.md)\ [Parallel Containers and Objects](../../../parallel/concrt/parallel-containers-and-objects.md) diff --git a/docs/parallel/concrt/reference/concurrent-unordered-set-class.md b/docs/parallel/concrt/reference/concurrent-unordered-set-class.md index 52f91b4cfab..5265d958e55 100644 --- a/docs/parallel/concrt/reference/concurrent-unordered-set-class.md +++ b/docs/parallel/concrt/reference/concurrent-unordered-set-class.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: concurrent_unordered_set Class" title: "concurrent_unordered_set Class" -ms.date: "11/04/2016" +description: "Learn more about: concurrent_unordered_set Class" +ms.date: 11/04/2016 f1_keywords: ["concurrent_unordered_set", "CONCURRENT_UNORDERED_SET/concurrency::concurrent_unordered_set", "CONCURRENT_UNORDERED_SET/concurrency::concurrent_unordered_set::concurrent_unordered_set", "CONCURRENT_UNORDERED_SET/concurrency::concurrent_unordered_set::hash_function", "CONCURRENT_UNORDERED_SET/concurrency::concurrent_unordered_set::insert", "CONCURRENT_UNORDERED_SET/concurrency::concurrent_unordered_set::key_eq", "CONCURRENT_UNORDERED_SET/concurrency::concurrent_unordered_set::swap", "CONCURRENT_UNORDERED_SET/concurrency::concurrent_unordered_set::unsafe_erase"] helpviewer_keywords: ["concurrent_unordered_set class"] -ms.assetid: c61f9a9a-4fd9-491a-9251-e300737ecf4b --- # concurrent_unordered_set Class @@ -16,15 +15,8 @@ The `concurrent_unordered_set` class is an concurrency-safe container that contr template , typename key_equality = std::equal_to, - typename _Allocator_type = std::allocator ->, - typename key_equality = std::equal_to, - typename _Allocator_type = std::allocator> class concurrent_unordered_set : public details::_Concurrent_hash, -_Allocator_type, - false>>; + typename _Allocator_type = std::allocator> +class concurrent_unordered_set : public details::_Concurrent_hash, _Allocator_type, false>>; ``` ### Parameters @@ -393,7 +385,7 @@ A pair that contains an iterator and a boolean value. See the Remarks section fo The first member function determines whether an element X exists in the sequence whose key has equivalent ordering to that of `value`. If not, it creates such an element X and initializes it with `value`. The function then determines the iterator `where` that designates X. If an insertion occurred, the function returns `std::pair(where, true)`. Otherwise, it returns `std::pair(where, false)`. -The second member function returns insert( `value`), using `_Where` as a starting place within the controlled sequence to search for the insertion point. +The second member function returns insert(`value`), using `_Where` as a starting place within the controlled sequence to search for the insertion point. The third member function inserts the sequence of element values from the range [ `first`, `last`). @@ -439,7 +431,7 @@ void max_load_factor(float _Newmax); ### Return Value -The first member function returns the stored maximum load factor. The second member function does not return a value but throws an [out_of_range](../../../standard-library/out-of-range-class.md) exception if the supplied load factor is invalid.. +The first member function returns the stored maximum load factor. The second member function does not return a value but throws an [out_of_range](../../../standard-library/out-of-range-class.md) exception if the supplied load factor is invalid. ## max_size @@ -698,5 +690,5 @@ The maximum number of buckets in this container. ## See also -[concurrency Namespace](concurrency-namespace.md)
+[concurrency Namespace](concurrency-namespace.md)\ [Parallel Containers and Objects](../../../parallel/concrt/parallel-containers-and-objects.md) diff --git a/docs/parallel/concrt/reference/concurrent-vector-class.md b/docs/parallel/concrt/reference/concurrent-vector-class.md index af0edeecb83..1bdeb6f2c0c 100644 --- a/docs/parallel/concrt/reference/concurrent-vector-class.md +++ b/docs/parallel/concrt/reference/concurrent-vector-class.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: concurrent_vector Class" title: "concurrent_vector Class" -ms.date: "11/04/2016" +description: "Learn more about: concurrent_vector Class" +ms.date: 11/04/2016 f1_keywords: ["concurrent_vector", "CONCURRENT_VECTOR/concurrency::concurrent_vector", "CONCURRENT_VECTOR/concurrency::concurrent_vector::concurrent_vector", "CONCURRENT_VECTOR/concurrency::concurrent_vector::assign", "CONCURRENT_VECTOR/concurrency::concurrent_vector::at", "CONCURRENT_VECTOR/concurrency::concurrent_vector::back", "CONCURRENT_VECTOR/concurrency::concurrent_vector::begin", "CONCURRENT_VECTOR/concurrency::concurrent_vector::capacity", "CONCURRENT_VECTOR/concurrency::concurrent_vector::cbegin", "CONCURRENT_VECTOR/concurrency::concurrent_vector::cend", "CONCURRENT_VECTOR/concurrency::concurrent_vector::clear", "CONCURRENT_VECTOR/concurrency::concurrent_vector::crbegin", "CONCURRENT_VECTOR/concurrency::concurrent_vector::crend", "CONCURRENT_VECTOR/concurrency::concurrent_vector::empty", "CONCURRENT_VECTOR/concurrency::concurrent_vector::end", "CONCURRENT_VECTOR/concurrency::concurrent_vector::front", "CONCURRENT_VECTOR/concurrency::concurrent_vector::get_allocator", "CONCURRENT_VECTOR/concurrency::concurrent_vector::grow_by", "CONCURRENT_VECTOR/concurrency::concurrent_vector::grow_to_at_least", "CONCURRENT_VECTOR/concurrency::concurrent_vector::max_size", "CONCURRENT_VECTOR/concurrency::concurrent_vector::push_back", "CONCURRENT_VECTOR/concurrency::concurrent_vector::rbegin", "CONCURRENT_VECTOR/concurrency::concurrent_vector::rend", "CONCURRENT_VECTOR/concurrency::concurrent_vector::reserve", "CONCURRENT_VECTOR/concurrency::concurrent_vector::resize", "CONCURRENT_VECTOR/concurrency::concurrent_vector::shrink_to_fit", "CONCURRENT_VECTOR/concurrency::concurrent_vector::size", "CONCURRENT_VECTOR/concurrency::concurrent_vector::swap"] helpviewer_keywords: ["concurrent_vector class"] -ms.assetid: a217b4ac-af2b-4d41-94eb-09a75ee28622 --- # concurrent_vector Class @@ -318,9 +317,9 @@ The second and third constructors specify a copy of the concurrent vector `_Vect The fourth constructor specifies a move of the concurrent vector `_Vector`. -The fifth constructor specifies a repetition of a specified number ( `_N`) of elements of the default value for class `T`. +The fifth constructor specifies a repetition of a specified number (`_N`) of elements of the default value for class `T`. -The sixth constructor specifies a repetition of ( `_N`) elements of value `_Item`. +The sixth constructor specifies a repetition of (`_N`) elements of value `_Item`. The last constructor specifies values supplied by the iterator range [ `_Begin`, `_End`). diff --git a/docs/parallel/concrt/reference/event-class.md b/docs/parallel/concrt/reference/event-class.md index 699ecf71814..0be9869316a 100644 --- a/docs/parallel/concrt/reference/event-class.md +++ b/docs/parallel/concrt/reference/event-class.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: event Class" title: "event Class" -ms.date: "11/04/2016" +description: "Learn more about: event Class" +ms.date: 11/04/2016 f1_keywords: ["CONCRT/concurrency::event", "CONCRT/concurrency::event::reset", "CONCRT/concurrency::event::set", "CONCRT/concurrency::event::wait", "CONCRT/concurrency::event::wait_for_multiple", "CONCRT/concurrency::event::timeout_infinite"] helpviewer_keywords: ["event class"] -ms.assetid: fba35a53-6568-4bfa-9aaf-07c0928cf73d --- # event Class @@ -61,8 +60,6 @@ Constructs a new event. _CRTIMP event(); ``` -### Remarks - ## ~event Destroys an event. diff --git a/docs/parallel/concrt/reference/invalid-scheduler-policy-thread-specification-class.md b/docs/parallel/concrt/reference/invalid-scheduler-policy-thread-specification-class.md index b88cbe2494f..eb5b16e0959 100644 --- a/docs/parallel/concrt/reference/invalid-scheduler-policy-thread-specification-class.md +++ b/docs/parallel/concrt/reference/invalid-scheduler-policy-thread-specification-class.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: invalid_scheduler_policy_thread_specification Class" title: "invalid_scheduler_policy_thread_specification Class" +description: "Learn more about: invalid_scheduler_policy_thread_specification Class" ms.date: "11/04/2016" f1_keywords: ["concrt/concurrency::invalid_scheduler_policy_thread_specification"] helpviewer_keywords: ["invalid_scheduler_policy_thread_specification class"] -ms.assetid: 2d0fafb2-18f8-4284-8040-3db640d33303 --- # invalid_scheduler_policy_thread_specification Class @@ -22,7 +21,7 @@ class invalid_scheduler_policy_thread_specification : public std::exception; |Name|Description| |----------|-----------------| -|[invalid_scheduler_policy_thread_specification](invalid-scheduler-policy-value-class.md#ctor|Overloaded. Constructs an `invalid_scheduler_policy_value` object.| +|[invalid_scheduler_policy_thread_specification](#ctor)|Overloaded. Constructs an `invalid_scheduler_policy_thread_specification` object.| ## Inheritance Hierarchy @@ -48,10 +47,10 @@ invalid_scheduler_policy_thread_specification() throw(); ### Parameters -*_Message*
+*_Message*\ A descriptive message of the error. ## See also -[concurrency Namespace](concurrency-namespace.md)
+[concurrency Namespace](concurrency-namespace.md)\ [SchedulerPolicy Class](schedulerpolicy-class.md) diff --git a/docs/parallel/concrt/reference/invalid-scheduler-policy-value-class.md b/docs/parallel/concrt/reference/invalid-scheduler-policy-value-class.md index 111cc7fea26..8fbbc42ddfb 100644 --- a/docs/parallel/concrt/reference/invalid-scheduler-policy-value-class.md +++ b/docs/parallel/concrt/reference/invalid-scheduler-policy-value-class.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: invalid_scheduler_policy_value Class" title: "invalid_scheduler_policy_value Class" +description: "Learn more about: invalid_scheduler_policy_value Class" ms.date: "11/04/2016" f1_keywords: ["concrt/concurrency::invalid_scheduler_policy_value"] helpviewer_keywords: ["invalid_scheduler_policy_value class"] -ms.assetid: 8c533e3f-2774-4192-8616-b2313b859bf7 --- # invalid_scheduler_policy_value Class @@ -22,7 +21,7 @@ class invalid_scheduler_policy_value : public std::exception; |Name|Description| |----------|-----------------| -|[invalid_scheduler_policy_value](invalid-scheduler-policy-thread-specification-class.md#ctor|Overloaded. Constructs an `invalid_scheduler_policy_value` object.| +|[invalid_scheduler_policy_value](#ctor)|Overloaded. Constructs an `invalid_scheduler_policy_value` object.| ## Inheritance Hierarchy @@ -48,10 +47,10 @@ invalid_scheduler_policy_value() throw(); ### Parameters -*_Message*
+*_Message*\ A descriptive message of the error. ## See also -[concurrency Namespace](concurrency-namespace.md)
+[concurrency Namespace](concurrency-namespace.md)\ [SchedulerPolicy Class](schedulerpolicy-class.md) diff --git a/docs/parallel/concrt/reference/task-class.md b/docs/parallel/concrt/reference/task-class.md index 5f90e1fb296..18fabb896ca 100644 --- a/docs/parallel/concrt/reference/task-class.md +++ b/docs/parallel/concrt/reference/task-class.md @@ -1,14 +1,13 @@ --- -description: "Learn more about: task Class (Concurrency Runtime)" title: "task Class (Concurrency Runtime)" -ms.date: "07/30/2019" +description: "Learn more about: task Class (Concurrency Runtime)" +ms.date: 07/30/2019 f1_keywords: ["task", "PPLTASKS/concurrency::task", "PPLTASKS/concurrency::task::task", "PPLTASKS/concurrency::task::get", "PPLTASKS/concurrency::task::is_apartment_aware", "PPLTASKS/concurrency::task::is_done", "PPLTASKS/concurrency::task::scheduler", "PPLTASKS/concurrency::task::then", "PPLTASKS/concurrency::task::wait"] helpviewer_keywords: ["task class"] -ms.assetid: cdc3a8c0-5cbe-45a0-b5d5-e9f81d94df1a --- # task Class (Concurrency Runtime) -The Parallel Patterns Library (PPL) `task` class. A `task` object represents work that can be executed asynchronously and concurrently with other tasks and parallel work produced by parallel algorithms in the Concurrency Runtime. It produces a result of type `_ResultType` on successful completion. Tasks of type `task` produce no result. A task can be waited upon and canceled independently of other tasks. It can also be composed with other tasks using continuations( `then`), and join( `when_all`) and choice( `when_any`) patterns. When a task object is assigned to a new variable, the behavior is that of `std::shared_ptr`; in other words, both objects represent the same underlying task. +The Parallel Patterns Library (PPL) `task` class. A `task` object represents work that can be executed asynchronously and concurrently with other tasks and parallel work produced by parallel algorithms in the Concurrency Runtime. It produces a result of type `_ResultType` on successful completion. Tasks of type `task` produce no result. A task can be waited upon and canceled independently of other tasks. It can also be composed with other tasks using continuations(`then`), and join(`when_all`) and choice(`when_any`) patterns. When a task object is assigned to a new variable, the behavior is that of `std::shared_ptr`; in other words, both objects represent the same underlying task. ## Syntax @@ -91,7 +90,7 @@ The result of the task. If the task is canceled, a call to `get` will throw a [task_canceled](task-canceled-class.md) exception. If the task encountered an different exception or an exception was propagated to it from an antecedent task, a call to `get` will throw that exception. > [!IMPORTANT] -> In a Universal Windows Platform (UWP) app, do not call [concurrency::task::wait](#wait) or `get` ( `wait` calls `get`) in code that runs on the user-interface thread. Otherwise, the runtime throws [concurrency::invalid_operation](invalid-operation-class.md) because these methods block the current thread and can cause the app to become unresponsive. However, you can call the `get` method to receive the result of the antecedent task in a task-based continuation because the result is immediately available. +> In a Universal Windows Platform (UWP) app, do not call [concurrency::task::wait](#wait) or `get` (`wait` calls `get`) in code that runs on the user-interface thread. Otherwise, the runtime throws [concurrency::invalid_operation](invalid-operation-class.md) because these methods block the current thread and can cause the app to become unresponsive. However, you can call the `get` method to receive the result of the antecedent task in a task-based continuation because the result is immediately available. ## is_apartment_aware diff --git a/docs/parallel/concrt/reference/transformer-class.md b/docs/parallel/concrt/reference/transformer-class.md index b5e9aa9241c..f5674f3eea4 100644 --- a/docs/parallel/concrt/reference/transformer-class.md +++ b/docs/parallel/concrt/reference/transformer-class.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: transformer Class" title: "transformer Class" +description: "Learn more about: transformer Class" ms.date: "11/04/2016" f1_keywords: ["transformer", "AGENTS/concurrency::transformer", "AGENTS/concurrency::transformer::transformer", "AGENTS/concurrency::transformer::accept_message", "AGENTS/concurrency::transformer::consume_message", "AGENTS/concurrency::transformer::link_target_notification", "AGENTS/concurrency::transformer::propagate_message", "AGENTS/concurrency::transformer::propagate_to_any_targets", "AGENTS/concurrency::transformer::release_message", "AGENTS/concurrency::transformer::reserve_message", "AGENTS/concurrency::transformer::resume_propagation", "AGENTS/concurrency::transformer::send_message", "AGENTS/concurrency::transformer::supports_anonymous_source"] helpviewer_keywords: ["transformer class"] -ms.assetid: eea71925-7043-4a92-bfd4-dbc0ece5d081 --- # transformer Class @@ -13,17 +12,17 @@ A `transformer` messaging block is a single-target, multi-source, ordered `propa ## Syntax ```cpp -template +template class transformer : public propagator_block>, multi_link_registry>>; ``` ### Parameters -*_Input*
+*`_Input`*\ The payload type of the messages accepted by the buffer. -*_Output*
+*`_Output`*\ The payload type of the messages stored and propagated out by the buffer. ## Members @@ -32,27 +31,27 @@ The payload type of the messages stored and propagated out by the buffer. |Name|Description| |----------|-----------------| -|[transformer](#ctor)|Overloaded. Constructs a `transformer` messaging block.| -|[~transformer Destructor](#dtor)|Destroys the `transformer` messaging block.| +|[`transformer`](#ctor)|Overloaded. Constructs a `transformer` messaging block.| +|[`~transformer`](#dtor)|Destroys the `transformer` messaging block.| ### Protected Methods |Name|Description| |----------|-----------------| -|[accept_message](#accept_message)|Accepts a message that was offered by this `transformer` messaging block, transferring ownership to the caller.| -|[consume_message](#consume_message)|Consumes a message previously offered by the `transformer` and reserved by the target, transferring ownership to the caller.| -|[link_target_notification](#link_target_notification)|A callback that notifies that a new target has been linked to this `transformer` messaging block.| -|[propagate_message](#propagate_message)|Asynchronously passes a message from an `ISource` block to this `transformer` messaging block. It is invoked by the `propagate` method, when called by a source block.| -|[propagate_to_any_targets](#propagate_to_any_targets)|Executes the transformer function on the input messages.| -|[release_message](#release_message)|Releases a previous message reservation. (Overrides [source_block::release_message](source-block-class.md#release_message).)| -|[reserve_message](#reserve_message)|Reserves a message previously offered by this `transformer` messaging block. (Overrides [source_block::reserve_message](source-block-class.md#reserve_message).)| -|[resume_propagation](#resume_propagation)|Resumes propagation after a reservation has been released. (Overrides [source_block::resume_propagation](source-block-class.md#resume_propagation).)| -|[send_message](#send_message)|Synchronously passes a message from an `ISource` block to this `transformer` messaging block. It is invoked by the `send` method, when called by a source block.| -|[supports_anonymous_source](#supports_anonymous_source)|Overrides the `supports_anonymous_source` method to indicate that this block can accept messages offered to it by a source that is not linked. (Overrides [ITarget::supports_anonymous_source](itarget-class.md#supports_anonymous_source).)| +|[`accept_message`](#accept_message)|Accepts a message that was offered by this `transformer` messaging block, transferring ownership to the caller.| +|[`consume_message`](#consume_message)|Consumes a message previously offered by the `transformer` and reserved by the target, transferring ownership to the caller.| +|[`link_target_notification`](#link_target_notification)|A callback that notifies that a new target has been linked to this `transformer` messaging block.| +|[`propagate_message`](#propagate_message)|Asynchronously passes a message from an `ISource` block to this `transformer` messaging block. It is invoked by the `propagate` method, when called by a source block.| +|[`propagate_to_any_targets`](#propagate_to_any_targets)|Executes the transformer function on the input messages.| +|[`release_message`](#release_message)|Releases a previous message reservation. (Overrides [`source_block::release_message`](source-block-class.md#release_message).)| +|[`reserve_message`](#reserve_message)|Reserves a message previously offered by this `transformer` messaging block. (Overrides [`source_block::reserve_message`](source-block-class.md#reserve_message).)| +|[`resume_propagation`](#resume_propagation)|Resumes propagation after a reservation has been released. (Overrides [`source_block::resume_propagation`](source-block-class.md#resume_propagation).)| +|[`send_message`](#send_message)|Synchronously passes a message from an `ISource` block to this `transformer` messaging block. It is invoked by the `send` method, when called by a source block.| +|[`supports_anonymous_source`](#supports_anonymous_source)|Overrides the `supports_anonymous_source` method to indicate that this block can accept messages offered to it by a source that is not linked. (Overrides [`ITarget::supports_anonymous_source`](itarget-class.md#supports_anonymous_source).)| ## Remarks -For more information, see [Asynchronous Message Blocks](../../../parallel/concrt/asynchronous-message-blocks.md). +For more information, see [Asynchronous Message Blocks](../asynchronous-message-blocks.md). ## Inheritance Hierarchy @@ -72,7 +71,7 @@ For more information, see [Asynchronous Message Blocks](../../../parallel/concrt **Namespace:** concurrency -## accept_message +## `accept_message` Accepts a message that was offered by this `transformer` messaging block, transferring ownership to the caller. @@ -82,14 +81,14 @@ virtual message<_Output>* accept_message(runtime_object_identity _MsgId); ### Parameters -*_MsgId*
+*`_MsgId`*\ The `runtime_object_identity` of the offered `message` object. ### Return Value A pointer to the `message` object that the caller now has ownership of. -## consume_message +## `consume_message` Consumes a message previously offered by the `transformer` and reserved by the target, transferring ownership to the caller. @@ -99,7 +98,7 @@ virtual message<_Output>* consume_message(runtime_object_identity _MsgId); ### Parameters -*_MsgId*
+*`_MsgId`*\ The `runtime_object_identity` of the `message` object being consumed. ### Return Value @@ -110,7 +109,7 @@ A pointer to the `message` object that the caller now has ownership of. Similar to `accept`, but is always preceded by a call to `reserve`. -## link_target_notification +## `link_target_notification` A callback that notifies that a new target has been linked to this `transformer` messaging block. @@ -118,7 +117,7 @@ A callback that notifies that a new target has been linked to this `transformer` virtual void link_target_notification(_Inout_ ITarget<_Output> *); ``` -## propagate_message +## `propagate_message` Asynchronously passes a message from an `ISource` block to this `transformer` messaging block. It is invoked by the `propagate` method, when called by a source block. @@ -130,17 +129,17 @@ virtual message_status propagate_message( ### Parameters -*_PMessage*
+*`_PMessage`*\ A pointer to the `message` object. -*_PSource*
+*`_PSource`*\ A pointer to the source block offering the message. ### Return Value A [message_status](concurrency-namespace-enums.md) indication of what the target decided to do with the message. -## propagate_to_any_targets +## `propagate_to_any_targets` Executes the transformer function on the input messages. @@ -148,7 +147,7 @@ Executes the transformer function on the input messages. virtual void propagate_to_any_targets(_Inout_opt_ message<_Output> *); ``` -## release_message +## `release_message` Releases a previous message reservation. @@ -158,10 +157,10 @@ virtual void release_message(runtime_object_identity _MsgId); ### Parameters -*_MsgId*
+*`_MsgId`*\ The `runtime_object_identity` of the `message` object being released. -## reserve_message +## `reserve_message` Reserves a message previously offered by this `transformer` messaging block. @@ -171,7 +170,7 @@ virtual bool reserve_message(runtime_object_identity _MsgId); ### Parameters -*_MsgId*
+*`_MsgId`*\ The `runtime_object_identity` of the `message` object being reserved. ### Return Value @@ -182,7 +181,7 @@ The `runtime_object_identity` of the `message` object being reserved. After `reserve` is called, if it returns **`true`**, either `consume` or `release` must be called to either take or release ownership of the message. -## resume_propagation +## `resume_propagation` Resumes propagation after a reservation has been released. @@ -190,7 +189,7 @@ Resumes propagation after a reservation has been released. virtual void resume_propagation(); ``` -## send_message +## `send_message` Synchronously passes a message from an `ISource` block to this `transformer` messaging block. It is invoked by the `send` method, when called by a source block. @@ -202,17 +201,17 @@ virtual message_status send_message( ### Parameters -*_PMessage*
+*`_PMessage`*\ A pointer to the `message` object. -*_PSource*
+*`_PSource`*\ A pointer to the source block offering the message. ### Return Value A [message_status](concurrency-namespace-enums.md) indication of what the target decided to do with the message. -## supports_anonymous_source +## `supports_anonymous_source` Overrides the `supports_anonymous_source` method to indicate that this block can accept messages offered to it by a source that is not linked. @@ -224,7 +223,7 @@ virtual bool supports_anonymous_source(); **`true`** because the block does not postpone offered messages. -## transformer +## `transformer` Constructs a `transformer` messaging block. @@ -263,19 +262,19 @@ transformer( ### Parameters -*_Func*
+*`_Func`*\ A function that will be invoked for each accepted message. -*_PTarget*
+*`_PTarget`*\ A pointer to a target block to link with the transformer. -*_Filter*
+*`_Filter`*\ A filter function which determines whether offered messages should be accepted. -*_PScheduler*
+*`_PScheduler`*\ The `Scheduler` object within which the propagation task for the `transformer` messaging block is scheduled. -*_PScheduleGroup*
+*`_PScheduleGroup`*\ The `ScheduleGroup` object within which the propagation task for the `transformer` messaging block is scheduled. The `Scheduler` object used is implied by the schedule group. ### Remarks @@ -286,7 +285,7 @@ The type `_Transform_method` is a functor with signature `_Output (_Input const The type `filter_method` is a functor with signature `bool (_Input const &)` which is invoked by this `transformer` messaging block to determine whether or not it should accept an offered message. -## ~transformer +## `~transformer` Destroys the `transformer` messaging block. @@ -296,5 +295,5 @@ Destroys the `transformer` messaging block. ## See also -[concurrency Namespace](concurrency-namespace.md)
+[concurrency Namespace](concurrency-namespace.md)\ [call Class](call-class.md) diff --git a/docs/parallel/concrt/schedule-groups.md b/docs/parallel/concrt/schedule-groups.md index 72566cc7114..b50caaa5999 100644 --- a/docs/parallel/concrt/schedule-groups.md +++ b/docs/parallel/concrt/schedule-groups.md @@ -1,9 +1,8 @@ --- -description: "Learn more about: Schedule Groups" title: "Schedule Groups" -ms.date: "11/04/2016" +description: "Learn more about: Schedule Groups" +ms.date: 11/04/2016 helpviewer_keywords: ["schedule groups"] -ms.assetid: 03523572-5891-4d17-89ce-fa795605f28b --- # Schedule Groups @@ -18,7 +17,7 @@ The `SchedulingProtocol` scheduler policy influences the order in which the sche The runtime uses the [concurrency::ScheduleGroup](../../parallel/concrt/reference/schedulegroup-class.md) class to represent schedule groups. To create a `ScheduleGroup` object, call the [concurrency::CurrentScheduler::CreateScheduleGroup](reference/currentscheduler-class.md#createschedulegroup) or [concurrency::Scheduler::CreateScheduleGroup](reference/scheduler-class.md#createschedulegroup) method. The runtime uses a reference-counting mechanism to control the lifetime of `ScheduleGroup` objects, just as it does with `Scheduler` objects. When you create a `ScheduleGroup` object, the runtime sets the reference counter to one. The [concurrency::ScheduleGroup::Reference](reference/schedulegroup-class.md#reference) method increments the reference counter by one. The [concurrency::ScheduleGroup::Release](reference/schedulegroup-class.md#release) method decrements the reference counter by one. -Many types in the Concurrency Runtime let you associate an object together with a schedule group. For example, the [concurrency::agent](../../parallel/concrt/reference/agent-class.md) class and message block classes such as [concurrency::unbounded_buffer](reference/unbounded-buffer-class.md), [concurrency::join](../../parallel/concrt/reference/join-class.md), and concurrency::[timer](reference/timer-class.md), provide overloaded versions of the constructor that take a `ScheduleGroup` object. The runtime uses the `Scheduler` object that is associated with this `ScheduleGroup` object to schedule the task. +Many types in the Concurrency Runtime let you associate an object together with a schedule group. For example, the [concurrency::agent](../../parallel/concrt/reference/agent-class.md) class and message block classes such as [concurrency::unbounded_buffer](reference/unbounded-buffer-class.md), [concurrency::join](../../parallel/concrt/reference/join-class.md), and [concurrency::timer](reference/timer-class.md), provide overloaded versions of the constructor that take a `ScheduleGroup` object. The runtime uses the `Scheduler` object that is associated with this `ScheduleGroup` object to schedule the task. You can also use the [concurrency::ScheduleGroup::ScheduleTask](reference/schedulegroup-class.md#scheduletask) method to schedule a lightweight task. For more information about lightweight tasks, see [Lightweight Tasks](../../parallel/concrt/lightweight-tasks.md). diff --git a/docs/parallel/concrt/task-parallelism-concurrency-runtime.md b/docs/parallel/concrt/task-parallelism-concurrency-runtime.md index 06706486753..d6ab7f02cc6 100644 --- a/docs/parallel/concrt/task-parallelism-concurrency-runtime.md +++ b/docs/parallel/concrt/task-parallelism-concurrency-runtime.md @@ -1,9 +1,9 @@ --- -description: "Learn more about: Task Parallelism (Concurrency Runtime)" title: "Task Parallelism (Concurrency Runtime)" -ms.date: "11/04/2016" +description: "Learn more about: Task Parallelism (Concurrency Runtime)" +ms.date: 11/04/2016 helpviewer_keywords: ["structured task groups [Concurrency Runtime]", "structured tasks [Concurrency Runtime]", "task groups [Concurrency Runtime]", "task parallelism", "tasks [Concurrency Runtime]"] -ms.assetid: 42f05ac3-2098-494a-ba84-737fcdcad077 +ms.topic: how-to --- # Task Parallelism (Concurrency Runtime) @@ -150,7 +150,7 @@ This section describes the [concurrency::when_all](reference/concurrency-namespa ### The when_all Function -The `when_all` function produces a task that completes after a set of tasks complete. This function returns a std::[vector](../../standard-library/vector-class.md) object that contains the result of each task in the set. The following basic example uses `when_all` to create a task that represents the completion of three other tasks. +The `when_all` function produces a task that completes after a set of tasks complete. This function returns a [std::vector](../../standard-library/vector-class.md) object that contains the result of each task in the set. The following basic example uses `when_all` to create a task that represents the completion of three other tasks. [!code-cpp[concrt-join-tasks#1](../../parallel/concrt/codesnippet/cpp/task-parallelism-concurrency-runtime_8.cpp)] @@ -257,7 +257,7 @@ The runtime also provides an exception-handling model that enables you to throw Although we recommend that you use `task_group` or `parallel_invoke` instead of the `structured_task_group` class, there are cases where you want to use `structured_task_group`, for example, when you write a parallel algorithm that performs a variable number of tasks or requires support for cancellation. This section explains the differences between the `task_group` and `structured_task_group` classes. -The `task_group` class is thread-safe. Therefore you can add tasks to a `task_group` object from multiple threads and wait on or cancel a `task_group` object from multiple threads. The construction and destruction of a `structured_task_group` object must occur in the same lexical scope. In addition, all operations on a `structured_task_group` object must occur on the same thread. The exception to this rule is the [concurrency::structured_task_group::cancel](reference/structured-task-group-class.md#cancel) and [concurrency::structured_task_group::is_canceling](reference/structured-task-group-class.md#is_canceling) methods. A child task can call these methods to cancel the parent task group or check for cancelation at any time. +The `task_group` class is thread-safe. Therefore you can add tasks to a `task_group` object from multiple threads and wait on or cancel a `task_group` object from multiple threads. The construction and destruction of a `structured_task_group` object must occur in the same lexical scope. In addition, all operations on a `structured_task_group` object must occur on the same thread. The exception to this rule is the [concurrency::structured_task_group::cancel](reference/structured-task-group-class.md#cancel) and [concurrency::structured_task_group::is_canceling](reference/structured-task-group-class.md#is_canceling) methods. A child task can call these methods to cancel the parent task group or check for cancellation at any time. You can run additional tasks on a `task_group` object after you call the [concurrency::task_group::wait](reference/task-group-class.md#wait) or [concurrency::task_group::run_and_wait](reference/task-group-class.md#run_and_wait) method. Conversely, if you run additional tasks on a `structured_task_group` object after you call the [concurrency::structured_task_group::wait](reference/structured-task-group-class.md#wait) or [concurrency::structured_task_group::run_and_wait](reference/structured-task-group-class.md#run_and_wait) methods, then the behavior is undefined. @@ -269,7 +269,7 @@ Unstructured task groups and structured task groups work with task handles in di [!code-cpp[concrt-make-task-structure#1](../../parallel/concrt/codesnippet/cpp/task-parallelism-concurrency-runtime_16.cpp)] -To manage task handles for cases where you have a variable number of tasks, use a stack-allocation routine such as [_malloca](../../c-runtime-library/reference/malloca.md) or a container class, such as std::[vector](../../standard-library/vector-class.md). +To manage task handles for cases where you have a variable number of tasks, use a stack-allocation routine such as [_malloca](../../c-runtime-library/reference/malloca.md) or a container class, such as [std::vector](../../standard-library/vector-class.md). Both `task_group` and `structured_task_group` support cancellation. For more information about cancellation, see [Cancellation in the PPL](cancellation-in-the-ppl.md). diff --git a/docs/parallel/concrt/walkthrough-creating-a-custom-message-block.md b/docs/parallel/concrt/walkthrough-creating-a-custom-message-block.md index debf678980b..c34f0946a6c 100644 --- a/docs/parallel/concrt/walkthrough-creating-a-custom-message-block.md +++ b/docs/parallel/concrt/walkthrough-creating-a-custom-message-block.md @@ -1,9 +1,8 @@ --- -description: "Learn more about: Walkthrough: Creating a Custom Message Block" title: "Walkthrough: Creating a Custom Message Block" -ms.date: "04/25/2019" +description: "Learn more about: Walkthrough: Creating a Custom Message Block" +ms.date: 04/25/2019 helpviewer_keywords: ["creating custom message blocks Concurrency Runtime]", "custom message blocks, creating [Concurrency Runtime]"] -ms.assetid: 4c6477ad-613c-4cac-8e94-2c9e63cd43a1 --- # Walkthrough: Creating a Custom Message Block @@ -57,7 +56,7 @@ The runtime calls the `propagate_message` method to asynchronously transfer a me The `priority_buffer` class is a custom message block type that orders incoming messages first by priority, and then by the order in which messages are received. The `priority_buffer` class resembles the [concurrency::unbounded_buffer](reference/unbounded-buffer-class.md) class because it holds a queue of messages, and also because it acts as both a source and a target message block and can have both multiple sources and multiple targets. However, `unbounded_buffer` bases message propagation only on the order in which it receives messages from its sources. -The `priority_buffer` class receives messages of type std::[tuple](../../standard-library/tuple-class.md) that contain `PriorityType` and `Type` elements. `PriorityType` refers to the type that holds the priority of each message; `Type` refers to the data portion of the message. The `priority_buffer` class sends messages of type `Type`. The `priority_buffer` class also manages two message queues: a [std::priority_queue](../../standard-library/priority-queue-class.md) object for incoming messages and a std::[queue](../../standard-library/queue-class.md) object for outgoing messages. Ordering messages by priority is useful when a `priority_buffer` object receives multiple messages simultaneously or when it receives multiple messages before any messages are read by consumers. +The `priority_buffer` class receives messages of type [std::tuple](../../standard-library/tuple-class.md) that contain `PriorityType` and `Type` elements. `PriorityType` refers to the type that holds the priority of each message; `Type` refers to the data portion of the message. The `priority_buffer` class sends messages of type `Type`. The `priority_buffer` class also manages two message queues: a [std::priority_queue](../../standard-library/priority-queue-class.md) object for incoming messages and a [std::queue](../../standard-library/queue-class.md) object for outgoing messages. Ordering messages by priority is useful when a `priority_buffer` object receives multiple messages simultaneously or when it receives multiple messages before any messages are read by consumers. In addition to the seven methods that a class that derives from `propagator_block` must implement, the `priority_buffer` class also overrides the `link_target_notification` and `send_message` methods. The `priority_buffer` class also defines two public helper methods, `enqueue` and `dequeue`, and a private helper method, `propagate_priority_order`. @@ -71,7 +70,7 @@ The following procedure describes how to implement the `priority_buffer` class. [!code-cpp[concrt-priority-buffer#1](../../parallel/concrt/codesnippet/cpp/walkthrough-creating-a-custom-message-block_2.h)] -1. In the `std` namespace, define specializations of [std::less](../../standard-library/less-struct.md) and [std::greater](../../standard-library/greater-struct.md) that act on concurrency::[message](../../parallel/concrt/reference/message-class.md) objects. +1. In the `std` namespace, define specializations of [std::less](../../standard-library/less-struct.md) and [std::greater](../../standard-library/greater-struct.md) that act on [concurrency::message](../../parallel/concrt/reference/message-class.md) objects. [!code-cpp[concrt-priority-buffer#2](../../parallel/concrt/codesnippet/cpp/walkthrough-creating-a-custom-message-block_3.h)] diff --git a/docs/parallel/concrt/walkthrough-implementing-futures.md b/docs/parallel/concrt/walkthrough-implementing-futures.md index 0eeeb8f2e62..0634c431d40 100644 --- a/docs/parallel/concrt/walkthrough-implementing-futures.md +++ b/docs/parallel/concrt/walkthrough-implementing-futures.md @@ -1,9 +1,8 @@ --- -description: "Learn more about: Walkthrough: Implementing Futures" title: "Walkthrough: Implementing Futures" -ms.date: "04/25/2019" +description: "Learn more about: Walkthrough: Implementing Futures" +ms.date: 04/25/2019 helpviewer_keywords: ["implementing futures [Concurrency Runtime]", "futures, implementing [Concurrency Runtime]"] -ms.assetid: 82ea75cc-aaec-4452-b10d-8abce0a87e5b --- # Walkthrough: Implementing Futures @@ -42,7 +41,7 @@ To implement futures, this topic defines the `async_future` class. The `async_fu ### Description -The following example shows the complete `async_future` class and an example of its usage. The `wmain` function creates a std::[vector](../../standard-library/vector-class.md) object that contains 10,000 random integer values. It then uses `async_future` objects to find the smallest and largest values that are contained in the `vector` object. +The following example shows the complete `async_future` class and an example of its usage. The `wmain` function creates a [std::vector](../../standard-library/vector-class.md) object that contains 10,000 random integer values. It then uses `async_future` objects to find the smallest and largest values that are contained in the `vector` object. ### Code diff --git a/docs/parallel/multithreading-and-locales.md b/docs/parallel/multithreading-and-locales.md index 8df3ba928ec..2cdb9b4db2f 100644 --- a/docs/parallel/multithreading-and-locales.md +++ b/docs/parallel/multithreading-and-locales.md @@ -4,6 +4,7 @@ title: "Multithreading and Locales" ms.date: "11/04/2016" helpviewer_keywords: ["locales [C++], multithreading", "multithreading [C++], locales", "threading [C++], locales", "per-thread locale"] ms.assetid: d6fb159a-eaca-4130-a51a-f95d62f71485 +ms.topic: concept-article --- # Multithreading and Locales diff --git a/docs/parallel/multithreading-creating-user-interface-threads.md b/docs/parallel/multithreading-creating-user-interface-threads.md index fa1abe4c069..093e592a9ab 100644 --- a/docs/parallel/multithreading-creating-user-interface-threads.md +++ b/docs/parallel/multithreading-creating-user-interface-threads.md @@ -5,6 +5,7 @@ ms.date: "08/27/2018" f1_keywords: ["CREATE_SUSPENDED", "SECURITY_ATTRIBUTES"] helpviewer_keywords: ["multithreading [C++], user interface threads", "threading [C++], creating threads", "threading [C++], user interface threads", "user interface threads [C++]", "threading [MFC], user interface threads"] ms.assetid: 446925c1-db59-46ea-ae5b-d5ae5d5b91d8 +ms.topic: how-to --- # Multithreading: Creating MFC User-Interface Threads diff --git a/docs/parallel/multithreading-creating-worker-threads.md b/docs/parallel/multithreading-creating-worker-threads.md index c967eda95e8..00d5e3f3426 100644 --- a/docs/parallel/multithreading-creating-worker-threads.md +++ b/docs/parallel/multithreading-creating-worker-threads.md @@ -4,6 +4,7 @@ title: "Multithreading: Creating Worker Threads in MFC" ms.date: "11/04/2016" helpviewer_keywords: ["multithreading [C++], worker threads", "background tasks [C++]", "threading [C++], worker threads", "worker threads [C++]", "threading [C++], creating threads", "threading [MFC], worker threads", "threading [C++], user input not required"] ms.assetid: 670adbfe-041c-4450-a3ed-be14aab15234 +ms.topic: how-to --- # Multithreading: Creating Worker Threads in MFC diff --git a/docs/parallel/multithreading-how-to-use-the-synchronization-classes.md b/docs/parallel/multithreading-how-to-use-the-synchronization-classes.md index af8f3e3a13e..ffbc5183f2a 100644 --- a/docs/parallel/multithreading-how-to-use-the-synchronization-classes.md +++ b/docs/parallel/multithreading-how-to-use-the-synchronization-classes.md @@ -4,6 +4,7 @@ title: "Multithreading: How to Use the MFC Synchronization Classes" ms.date: "08/27/2018" helpviewer_keywords: ["MFC [C++], multithreading", "threading [MFC], synchronization classes", "resources [C++], multithreading", "thread-safe classes [C++]", "synchronization classes [C++]", "synchronization [C++], multithreading", "threading [MFC], thread-safe class design", "threading [C++], synchronization", "multithreading [C++], synchronization classes", "threading [C++], thread-safe class design"] ms.assetid: f266d4c6-0454-4bda-9758-26157ef74cc5 +ms.topic: how-to --- # Multithreading: How to Use the MFC Synchronization Classes diff --git a/docs/parallel/multithreading-programming-tips.md b/docs/parallel/multithreading-programming-tips.md index 1017d68873a..8048068fc7c 100644 --- a/docs/parallel/multithreading-programming-tips.md +++ b/docs/parallel/multithreading-programming-tips.md @@ -4,6 +4,7 @@ title: "Multithreading: MFC Programming Tips" ms.date: "08/27/2018" helpviewer_keywords: ["multithreading [C++], programming tips", "handle maps [C++]", "access control [C++], multithreading", "objects [C++], multiple threads and", "non-MFC threads [C++]", "threading [MFC], programming tips", "critical sections [C++]", "synchronization [C++], multithreading", "programming [C++], multithreaded", "communications [C++], between threads", "threading [C++], best practices", "troubleshooting [C++], multithreading", "Windows handle maps [C++]"] ms.assetid: ad14cc70-c91c-4c24-942f-13a75e58bf8a +ms.topic: concept-article --- # Multithreading: MFC Programming Tips diff --git a/docs/parallel/multithreading-support-for-older-code-visual-cpp.md b/docs/parallel/multithreading-support-for-older-code-visual-cpp.md index 43071cb689d..b2c9fea8356 100644 --- a/docs/parallel/multithreading-support-for-older-code-visual-cpp.md +++ b/docs/parallel/multithreading-support-for-older-code-visual-cpp.md @@ -4,6 +4,7 @@ title: "Multithreading Support for Older Code (Visual C++)" ms.date: "08/27/2018" helpviewer_keywords: ["threading [C++]", "multiple threads", "concurrent programming [C++]", "programming [C++], multithreaded", "multithreading [C++], about multithreading", "multiple concurrent threads", "multithreading [C++]"] ms.assetid: 24425b1f-5031-4c6b-aac7-017115a40e7c +ms.topic: concept-article --- # Multithreading Support for Older Code (Visual C++) diff --git a/docs/parallel/multithreading-terminating-threads.md b/docs/parallel/multithreading-terminating-threads.md index 5f530d673ad..64fb21623d0 100644 --- a/docs/parallel/multithreading-terminating-threads.md +++ b/docs/parallel/multithreading-terminating-threads.md @@ -4,6 +4,7 @@ title: "Multithreading: Terminating Threads in MFC" ms.date: "08/27/2018" helpviewer_keywords: ["premature thread termination", "starting threads", "threading [MFC], terminating threads", "multithreading [C++], terminating threads", "threading [C++], stopping threads", "terminating threads", "stopping threads", "AfxEndThread method"] ms.assetid: 4c0a8c6d-c02f-456d-bd02-0a8c8d006ecb +ms.topic: how-to --- # Multithreading: Terminating Threads in MFC diff --git a/docs/parallel/multithreading-when-to-use-the-synchronization-classes.md b/docs/parallel/multithreading-when-to-use-the-synchronization-classes.md index 7fad93900e2..0a7c3a15d87 100644 --- a/docs/parallel/multithreading-when-to-use-the-synchronization-classes.md +++ b/docs/parallel/multithreading-when-to-use-the-synchronization-classes.md @@ -4,6 +4,7 @@ title: "Multithreading: When to Use the MFC Synchronization Classes" ms.date: "08/27/2018" helpviewer_keywords: ["threading [MFC], synchronization classes", "resources [C++], multithreading", "synchronization classes [C++]", "synchronization [C++], multithreading", "controlled resource access [C++]", "synchronization access classes [C++]", "threading [C++], synchronization", "multithreading [C++], synchronization classes"] ms.assetid: 4914f54e-68ac-438f-93c9-c013455a657e +ms.topic: how-to --- # Multithreading: When to Use the MFC Synchronization Classes diff --git a/docs/parallel/multithreading-with-c-and-win32.md b/docs/parallel/multithreading-with-c-and-win32.md index 6381e9ba552..e3f2f9335b2 100644 --- a/docs/parallel/multithreading-with-c-and-win32.md +++ b/docs/parallel/multithreading-with-c-and-win32.md @@ -4,6 +4,7 @@ title: "Multithreading with C and Win32" ms.date: "08/09/2019" helpviewer_keywords: ["Windows API [C++], multithreading", "multithreading [C++], C and Win32", "Visual C, multithreading", "Win32 applications [C++], multithreading", "threading [C++], C and Win32", "Win32 [C++], multithreading", "threading [C]"] ms.assetid: 67cdc99e-1ad9-452b-a042-ed246b70040e +ms.topic: concept-article --- # Multithreading with C and Win32 diff --git a/docs/parallel/multithreading-with-cpp-and-mfc.md b/docs/parallel/multithreading-with-cpp-and-mfc.md index 9421b44d6b2..7fc4d93386e 100644 --- a/docs/parallel/multithreading-with-cpp-and-mfc.md +++ b/docs/parallel/multithreading-with-cpp-and-mfc.md @@ -4,6 +4,7 @@ title: "Multithreading with C++ and MFC" ms.date: "08/27/2018" helpviewer_keywords: ["MFC [C++], multithreading", "threading [C++], MFC", "worker threads [C++]", "synchronization classes [C++]", "synchronization [C++], multithreading", "threading [MFC], about threading", "CWinThread class, purpose of", "multithreading [C++], MFC", "threading [MFC]", "user interface threads [C++]"] ms.assetid: 979605f8-3988-44b5-ac9c-b8cce7fcce14 +ms.topic: concept-article --- # Multithreading with C++ and MFC diff --git a/docs/parallel/openmp/1-introduction.md b/docs/parallel/openmp/1-introduction.md index 577e1556d99..3e819472bde 100644 --- a/docs/parallel/openmp/1-introduction.md +++ b/docs/parallel/openmp/1-introduction.md @@ -3,6 +3,7 @@ description: "Learn more about: 1. Introduction" title: "1. Introduction" ms.date: "01/16/2019" ms.assetid: c42e72bc-0e31-4b1c-b670-cd82673c0c5a +ms.topic: concept-article --- # 1. Introduction diff --git a/docs/parallel/openmp/a-examples.md b/docs/parallel/openmp/a-examples.md index dabdf0bc972..43499f5d100 100644 --- a/docs/parallel/openmp/a-examples.md +++ b/docs/parallel/openmp/a-examples.md @@ -1,8 +1,7 @@ --- -description: "Learn more about: A. Examples" title: "A. Examples" -ms.date: "01/18/2019" -ms.assetid: c0f6192f-a205-449b-b84c-cb30dbcc8b8f +description: "Learn more about: A. Examples" +ms.date: 01/18/2019 --- # A. Examples @@ -854,7 +853,7 @@ The following example demonstrates the [num_threads](2-directives.md#23-parallel ```cpp #include -main() +int main() { omp_set_dynamic(1); ... diff --git a/docs/parallel/openmp/c-openmp-c-and-cpp-grammar.md b/docs/parallel/openmp/c-openmp-c-and-cpp-grammar.md index 0fc7ddabdf4..3e5249b640a 100644 --- a/docs/parallel/openmp/c-openmp-c-and-cpp-grammar.md +++ b/docs/parallel/openmp/c-openmp-c-and-cpp-grammar.md @@ -1,15 +1,13 @@ --- -description: "Learn more about: C. OpenMP C and C++ grammar" title: "C. OpenMP C and C++ grammar" -ms.date: "01/16/2019" -ms.assetid: 97a878ce-1533-47f7-a134-66fcbff48524 +description: "Learn more about: C. OpenMP C and C++ grammar" +ms.date: 01/16/2019 --- # C. OpenMP C and C++ grammar -[C.1 Notation](#c1-notation)
-[C.2 Rules](#c2-rules) +Learn about the grammar rules and syntax extensions in C and C++ for OpenMP, a parallel programming framework. -## C.1 Notation +## C.1 notation The grammar rules consist of the name for a non-terminal, followed by a colon, followed by replacement alternatives on separate lines. @@ -22,7 +20,7 @@ The syntactic expression *term*optseq is equivalent to *term-seq* Restrictions on binary compatibility -There are three important restrictions on binary compatibility between the v140, v141, v142, and v143 toolsets and minor numbered version updates: +There are three important restrictions on binary compatibility between the v140, v141, v142, v143, and v145 build tools and minor numbered version updates: -- Binaries created with different versions of the v140, v141, v142, and v143 toolsets can be combined. The key rule is that the linker should only work with inputs built by a toolset that is the same version (or earlier) as itself. This applies to apps, import libraries, static libraries, and other files as described in [LINK input files](../build/reference/link-input-files.md). In some cases, an import library for an [implicitly linked](../build/linking-an-executable-to-a-dll.md#implicit-linking) DLL built by a later version of the toolset can be linked using an earlier version of the toolset--especially if the import library strictly uses `extern "C"` for the imports/exports. Here are some examples of what this all means: - - An app compiled with a 2017 toolset (v141, versions 15.0 to 15.9) can be linked to a static library compiled with Visual Studio 2022 version 17.8 (v143), but the linking must be done using a version 17.8 or later toolset. - - Apps and libraries built using VS 2015, 2017, 2019, or 2022 can be linked together, but the linking must be done using a version of the toolset that is as recent as, or more recent than, the most recent toolset used to build any of the binaries you pass to the linker. For example, given three binaries built with toolsets from VS 2015 version 14.3, VS 2017 version 15.9, and VS 2019 version 16.11, you can link them using any toolset version that is 16.11 or later. - - If a DLL is built with a newer toolset, the import library can sometimes be used with older toolsets if all of the exports follow the C language calling convention (`extern "C"`). However, the only officially supported case is consuming a newer windows SDK with an older toolset. -- The Redistributable your app uses has a similar binary-compatibility restriction. When you mix binaries built by different supported versions of the toolset, the Redistributable version must be at least as new as the latest toolset used by any app component. -- Static libraries or object files compiled using the [`/GL` (Whole program optimization)](../build/reference/gl-whole-program-optimization.md) compiler switch or linked using [`/LTCG` (Link-time code generation)](../build/reference/ltcg-link-time-code-generation.md) *aren't* binary-compatible across versions, including minor version updates. All object files and libraries compiled using **`/GL`** and **`/LTCG`** must use exactly the same toolset for the compile and the final link. For example, code built by using **`/GL`** in the Visual Studio 2019 version 16.7 toolset can't be linked to code built by using **`/GL`** in the Visual Studio 2019 version 16.8 toolset. The compiler emits [Fatal error C1047](../error-messages/compiler-errors-1/fatal-error-c1047.md). +- Binaries created with different versions of the v140, v141, v142, v143, and v145 build tools can be combined. The key rule is that the linker should only work with inputs built by build tools that are the same version (or earlier) as itself. This applies to apps, import libraries, static libraries, and other files as described in [LINK input files](../build/reference/link-input-files.md). In some cases, an import library for an [implicitly linked](../build/linking-an-executable-to-a-dll.md#implicit-linking) DLL built by a later version of the build tools can be linked using an earlier version of the build tools--especially if the import library strictly uses `extern "C"` for the imports/exports. Here are some examples of what this all means: + - An app compiled with the 2017 build tools (v141, versions 15.0 to 15.9) can be linked to a static library compiled with Visual Studio 2022 version 17.8 (v143), but the linking must be done using a version 17.8 or later build tools. + - Apps and libraries built using VS 2015, 2017, 2019, 2022, and 2026 can be linked together, but the linking must be done using a version of the build tools that is as recent as, or more recent than, the most recent build tools used to build any of the binaries you pass to the linker. For example, given three binaries built with build tools from VS 2015 version 14.3, VS 2017 version 15.9, and VS 2019 version 16.11, you can link them using any build tools version that is 16.11 or later. + - If a DLL is built with newer build tools, the import library can sometimes be used with older build tools if all of the exports follow the C language calling convention (`extern "C"`). However, the only officially supported case is consuming a newer windows SDK with older build tools. +- The Redistributable your app uses has a similar binary-compatibility restriction. When you mix binaries built by different supported versions of the build tools, the Redistributable version must be at least as new as the latest build tools used by any app component. +- Static libraries or object files compiled using the [`/GL` (Whole program optimization)](../build/reference/gl-whole-program-optimization.md) compiler switch or linked using [`/LTCG` (Link-time code generation)](../build/reference/ltcg-link-time-code-generation.md) *aren't* binary-compatible across versions, including minor version updates. All object files and libraries compiled using **`/GL`** and **`/LTCG`** must use exactly the same build tools for the compile and the final link. For example, code built by using **`/GL`** in the Visual Studio 2019 version 16.7 build tools can't be linked to code built by using **`/GL`** in the Visual Studio 2019 version 16.8 build tools. The compiler emits [Fatal error C1047](../error-messages/compiler-errors-1/fatal-error-c1047.md). ## Upgrade the Microsoft Visual C++ Redistributable from Visual Studio 2015 and later -We've kept the Microsoft Visual C++ Redistributable major version number the same for Visual Studio 2015, 2017, 2019, and 2022. That means only one instance of the Redistributable can be installed at a time. A newer version overwrites any older version that's already installed. For example, one app may install the Redistributable from Visual Studio 2015. Then, another app installs the Redistributable from Visual Studio 2022. The 2022 version overwrites the older version, but because they're binary-compatible, the earlier app still works fine. We make sure the latest version of the Redistributable has all the newest features, security updates, and bug fixes. That's why we always recommend you upgrade to the latest available version. +We've kept the Microsoft Visual C++ Redistributable major version number the same for Visual Studio 2015, 2017, 2019, 2022, and 2026. That means only one instance of the Redistributable can be installed at a time. A newer version overwrites any older version that's already installed. For example, one app may install the Redistributable from Visual Studio 2015. Then, another app installs the Redistributable from Visual Studio 2026. The 2026 version overwrites the older version, but because they're binary-compatible, the earlier app still works fine. We make sure the latest version of the Redistributable has all the newest features, security updates, and bug fixes. That's why we always recommend you upgrade to the latest available version. -Similarly, you can't install an older Redistributable when a newer version is already installed. The installer reports an error if you try. You'll see an error like this if you install the 2017 or 2019 Redistributable on a machine that already has the 2022 version: +Similarly, you can't install an older Redistributable when a newer version is already installed. The installer reports an error if you try. For example, you'll see an error like this if you install the 2022 Redistributable on a machine that already has the 2026 version: ```Output 0x80070666 - Another version of this product is already installed. Installation of this version cannot continue. To configure or remove the existing version of this product, use Add/Remove Programs on the Control Panel. @@ -39,4 +39,6 @@ This error is by design. We recommend you keep the newest version installed. Mak ## See also [Visual C++ change history](../porting/visual-cpp-change-history-2003-2015.md)\ -[The latest supported Visual C++ Redistributable downloads](../windows/latest-supported-vc-redist.md) +[The latest supported Visual C++ Redistributable downloads](../windows/latest-supported-vc-redist.md)\ +[How to audit Visual C++ Runtime version usage](../windows/redist-version-auditing.md)\ +[Lifecycle FAQ - Visual C++ Redistributable and runtime libraries](/lifecycle/faq/visual-c-faq) diff --git a/docs/porting/build-system-changes.md b/docs/porting/build-system-changes.md index 257ad65325a..afde5d89f65 100644 --- a/docs/porting/build-system-changes.md +++ b/docs/porting/build-system-changes.md @@ -1,13 +1,13 @@ --- title: "VCBuild vs. MSBuild" -description: "The VIsual Studio C++ build system changed from VCBuild to MSBuild in Visual Studio 2010." +description: "The Visual Studio C++ build system changed from VCBuild to MSBuild in Visual Studio 2010." ms.date: "10/25/2019" helpviewer_keywords: ["Build system changes, project file (.vcxprog)", "Build system changes, custom build rules", "Build system changes, MSBuild", "MSBuild, build system changes", "Build system changes, .vsprops", "Build system changes, $(Inherit)", "Build system changes, $(NoInherit)"] ms.assetid: e564d95f-a6cc-4d97-b57e-1a71daf66f4a --- # VCBuild vs. MSBuild: Build system changes in Visual Studio 2010 -The MSBuild system for C++ projects was introduced in Visual Studio 2010. In Visual Studio 2008 and earlier releases, the VCBuild system was used. Certain file types and concepts that depended on VCBuild either do not exist or are represented differently in MSBuild. This document discusses the differences in the current build system. To convert a Visual Studio 2008 project to MSBuild, you must use Visual Studio 2010. After the project is converted, you should use the latest version of Visual Studio to upgrade to the current IDE and compiler toolset. For more information, including how to obtain Visual Studio 2010, see [Instructions for Visual Studio 2008](use-native-multi-targeting.md#instructions-for-visual-studio-2008). +The MSBuild system for C++ projects was introduced in Visual Studio 2010. In Visual Studio 2008 and earlier releases, the VCBuild system was used. Certain file types and concepts that depended on VCBuild either do not exist or are represented differently in MSBuild. This document discusses the differences in the current build system. To convert a Visual Studio 2008 project to MSBuild, you must use Visual Studio 2010. After the project is converted, you should use the latest version of Visual Studio to upgrade to the current IDE and build tools. For more information, including how to obtain Visual Studio 2010, see [Instructions for Visual Studio 2008](use-native-multi-targeting.md#instructions-for-visual-studio-2008). The following sections summarize the changes from VCBuild to MSBuild. If your VCBuild project has custom build rules or macros that aren't recognized by MSBuild, see [Visual Studio Projects - C++](../build/creating-and-managing-visual-cpp-projects.md) to learn how to translate those instructions to the MSBuild system. The initial conversion from VCBuild to MSBuild is just an intermediate step. It isn't necessary to get the project file completely correct or to get the program to compile without errors. You are only using Visual Studio 2010 to convert the project to MSBuild format so that you get the project working in the latest version of Visual Studio. diff --git a/docs/porting/copilot-app-modernization-cpp.md b/docs/porting/copilot-app-modernization-cpp.md new file mode 100644 index 00000000000..9d8ab2b609b --- /dev/null +++ b/docs/porting/copilot-app-modernization-cpp.md @@ -0,0 +1,100 @@ +--- +title: "Modernize your C++ project with GitHub Copilot app modernization" +description: "Instructions on effectively using GitHub Copilot app modernization in your C++ projects" +ms.date: 01/23/2026 +ms.topic: upgrade-and-migration-article +author: michaelbprice +ms.author: miprice +--- + +# Using GitHub Copilot app modernization for C++ + +GitHub Copilot app modernization for C++ helps you upgrade C++ projects to newer MSVC Build Tools versions. If necessary, Copilot will upgrade your project's settings to use the latest MSVC, and then conduct a thorough assessment of the impact of those changes after executing a build. It develops a plan on how to address each identified problem. Once you approve the plan, the agent completes a sequence of tasks and validates that any changes resolved the identified problems. If there remains work to be done, the agent continues iterating until the problems are resolved or you discontinue the conversation. + +> [!NOTE] +> GitHub Copilot app modernization for C++ is currently in preview. + +## Requirements + +- Visual Studio 2026 version 18.3 or later +- A GitHub Copilot account +- A MSBuild-based codebase (`.sln`, `.vcxproj`) OR a CMake-based codebase + +## Enable GitHub Copilot app modernization for C++ + +GitHub Copilot app modernization for C++ is enabled by default. To disable or explicitly enable the feature, follow these steps. + +1. From Visual Studio, select **Tools > Options...** to open the **Options** window. +1. Navigate to **All Settings > GitHub > Copilot > C/C++**. +1. Select (to enable) or clear (to disable) the checkbox for **Enable GitHub Copilot app modernization for C++ (preview)**. +1. Restart Visual Studio for the setting change to take effect. + +:::image type="content" source="media/enable-copilot-app-modernization-cpp.png" alt-text="Screenshot of Visual Studio Options dialog. GitHub > Copilot > C/C++ settings are visible. The app modernization for C++ checkbox is enabled."::: + +## Upgrade your codebase by using GitHub Copilot app modernization for C++ + +This section describes how to start the Modernize agent and the stages it goes through to upgrade your codebase. + +### Start the Modernize agent + +GitHub Copilot app modernization is an agent that operates inside the GitHub Copilot Chat window. You can start the agent in any of the following ways: + +- **From the Solution Explorer context menu**: Right-click on the solution or a loaded project in the Solution Explorer, and choose **Modernize** from the context menu. This automatically launches a GitHub Copilot Chat window, activates the Modernize agent, and provides you with relevant prompts to choose from to get you started. + +:::image type="content" source="media/copilot-app-modernization-context-menu.png" alt-text="Screenshot of Visual Studio Solution Explorer showing a right-click context menu with Modernize selected to start the Copilot agent."::: + +- **From GitHub Copilot Chat**: Open the GitHub Copilot Chat Window by selecting **View > GitHub Copilot Chat**. After the GitHub Copilot Chat window opens, mention `@Modernize` in a prompt to activate the Modernize agent. For example, type this prompt: + + `Use @Modernize to update MSVC Build Tools.` + +#### For MSBuild-based codebases targeting an earlier version of MSVC Build Tools + +The first time that you load a `.vcxproj` project that targets an earlier version of the MSVC Build Tools, you see an option to [upgrade project settings to use a newer version of the MSVC Build Tools](/visualstudio/install/setup-assistant). If you retarget any of your projects to a new version of MSVC Build Tools and GitHub Copilot app modernization for C++ is enabled, you receive an infobar in Visual Studio prompting you to use GitHub Copilot app modernization for C++ to resolve any newly introduced build problems. Selecting **Run GitHub Copilot app modernization for C++** launches the GitHub Copilot Chat window, activates the Modernize agent, and provides you with relevant prompts to choose from to get you started. + +### Start the upgrade + +Once the Modernize agent is active, you can instruct it via a prompt to upgrade your MSVC Build Tools, or select the already constructed prompt from the list shown in the window. If you launched the agent directly in the GitHub Copilot Chat window by mentioning `@Modernize` in your prompt, you probably don't need to provide more prompting. + +:::row::: +:::column::: + +**MSBuild Projects** + +:::column-end::: +:::column::: + +**CMake Projects** + +:::column-end::: +:::row-end::: +:::row::: +:::column::: + +:::image type="content" source="media/app-modernization-msbuild-ice-breaker.png" alt-text="Screenshot of GitHub Copilot Chat window. The dropdown is set to App Modernization experience and Upgrade MSVC Build Tools to the latest version is highlighted."::: + +:::column-end::: +:::column::: + +:::image type="content" source="media/app-modernization-cmake-ice-breaker.png" alt-text="Screenshot of GitHub Copilot Chat window. The dropdown is set to App Modernization experience and Resolve build issues by migrating to modern alternatives is highlighted"::: + +:::column-end::: +:::row-end::: + + +### Assessment stage + +The agent first assesses what kinds of problems show up after upgrading. If you didn't already upgrade the project, the agent guides you through that process before creating its assessment. After ensuring that your project is upgraded, the agent builds your codebase, analyzes the reported warnings and errors, and generates an `assessment.md` file that describes the problems that it found, their severity, and other useful information. This is your opportunity to tell the agent any other context that could help it make a plan. + +One of the things you might choose to do here is to tell the agent not to fix certain discovered problems, because you know that resolving them involves some strategic decisions or because they were preexisting warnings that you decided are acceptable for your project. You should carefully read through the plan, making sure to provide that extra context where it is needed. Once you approve the assessment, the agent moves on to creating a concrete plan on addressing the problems. + +### Planning stage + +Based on the approved assessment and any other context or instructions you provide, the agent creates a `plan.md` file that proposes a detailed plan for resolving each of the identified problems. If the agent produces a plan that doesn't match your organization's coding style or practices, you can provide that guidance to the agent and have it solve the problem differently. After you agree on the plan, the agent moves to the execution stage. + +### Execution stage + +Now that the agent has a plan, it breaks down the necessary tasks to execute the plan. You can define these tasks as finely as you want. The tasks can even include steps to work on a branch or to commit specific changes together in the same commit. After making any changes, the agent builds the project again to confirm that the problems are resolved. If the problems aren't resolved, the agent iterates with you until they're resolved to your satisfaction. + +### Post-upgrade validation + +When the agent finishes, run the changes through any testing infrastructure you have. Have a colleague review the changes in a pull request. Since this feature is currently in preview, you might receive an infobar to complete a product survey to let the product team know how the agent performed on your codebase. The product team looks forward to hearing how they can improve the agent to solve your problems and accelerate your upgrade and modernization efforts. \ No newline at end of file diff --git a/docs/porting/features-deprecated-in-visual-studio.md b/docs/porting/features-deprecated-in-visual-studio.md index 71383dbc034..c4054812aae 100644 --- a/docs/porting/features-deprecated-in-visual-studio.md +++ b/docs/porting/features-deprecated-in-visual-studio.md @@ -1,21 +1,47 @@ --- -description: "Learn more about: C++ features deprecated in Visual Studio" -title: "C++ features deprecated in Visual Studio" -ms.date: 04/07/2022 -helpviewer_keywords: ["Features deprecated in Visual Studio"] +description: "Learn more about: C++ features deprecated or removed from Visual Studio" +title: "C++ features deprecated or removed from Visual Studio" +ms.date: 10/29/2025 +helpviewer_keywords: ["Features deprecated or removed from Visual Studio"] --- -# C++ features deprecated in Visual Studio +# C++ features deprecated or removed from Visual Studio -This article is a non-exhaustive list of C++ features deprecated in Visual Studio 2019 and 2022. For information on breaking changes and conformance improvements for C++ in the latest version of Visual Studio, see [C++ conformance improvements in Visual Studio](../overview/cpp-conformance-improvements.md). +This article is a non-exhaustive list of C++ features deprecated or removed from Visual Studio 2019 and later. For information on breaking changes and conformance improvements for C++ in the latest version of Visual Studio, see [C++ conformance improvements in Visual Studio](../overview/cpp-conformance-improvements.md). -## Deprecated in Visual Studio 2019 +## Visual Studio 2019 -- Support for Windows XP development +### Support for Windows XP development - Visual Studio 2019 and later versions don't include current toolset support for creating code for Windows XP. Support for Windows XP development by using the v141_xp toolset that shipped in Visual Studio 2017 is still available as an optional component in the Visual Studio Installer. For information on how to install the v141_xp Windows XP platform toolset, see [Configuring programs for Windows XP](../build/configuring-programs-for-windows-xp.md). +Visual Studio 2019 and later versions don't include current build tools support for creating code for Windows XP. Support for Windows XP development by using the v141_xp build tools that shipped in Visual Studio 2017 is still available as an optional component in the Visual Studio Installer. For information on how to install the v141_xp Windows XP platform toolset, see [Configuring programs for Windows XP](../build/configuring-programs-for-windows-xp.md). -## Deprecated in Visual Studio 2022 +## Visual Studio 2022 -- Support for project upgrade from Visual C++ 6 - - Visual Studio 2022 and later versions don't support upgrades from Visual C++ 6 Workspace (*`.dsw`*) and Project (*`.dsp`*) files. Visual Studio no longer registers the *`.dsw`* and *`.dsp`* file extensions as Visual Studio file types. To upgrade a project with these extensions, first use Visual Studio 2019 to upgrade the project to modern Solution (*`.sln`*) and C++ Project (*`.vcxproj`*) files. Then use the current version of Visual Studio to upgrade the project again. +### Support for project upgrade from Visual C++ 6 + +Visual Studio 2022 and later versions don't support upgrades from Visual C++ 6 Workspace (*`.dsw`*) and Project (*`.dsp`*) files. Visual Studio no longer registers the *`.dsw`* and *`.dsp`* file extensions as Visual Studio file types. To upgrade a project with these extensions, first use Visual Studio 2019 to upgrade the project to modern Solution (*`.sln`*) and C++ Project (*`.vcxproj`*) files. Then use the current version of Visual Studio to upgrade the project again. + +## Visual Studio 2026 + +### Support for C++AMP, ARM32 toolchain, and /DEBUG:FASTLINK + +Visual Studio 2026 and later versions don't support C++AMP, the ARM32 toolchain, and /DEBUG:FASTLINK. If you're utilizing `/DEBUG:FASTLINK`, it's recommended to switch to [`/DEBUG:FULL`](/cpp/build/reference/debug-generate-debug-info) for improved debugging support. Developers needing to target ARM32 can continue using the Visual Studio 2022 v143 build tools as detailed in this [Microsoft blog post](https://devblogs.microsoft.com/cppblog/side-by-side-minor-version-msvc-toolsets-in-visual-studio-2019/). + +### Deprecation of `/await` + +The MSVC compiler switch `/await` is being deprecated and will be removed in a future release. This switch enabled an early draft implementation of C++ coroutines using the `` header. Developers should transition to standard C++ coroutines by using the `` header available in C++20 and later. For C++14/17 projects, use `/await:strict` (which isn't being deprecated) to access the standard `` header without enabling other C++20 features. + +### Support for Windows 7, 8, and 8.1 for Microsoft C++ Build Tools + +In Visual Studio 2026, the Microsoft C++ (MSVC) Build Tools raised the minimum supported operating system requirements. With this release, the Build Tools no longer target: + +- Windows 7 / Windows Server 2008 R2 +- Windows 8 / Windows Server 2012 +- Windows 8.1 / Windows Server 2012 R2 + +To build applications using the latest C++ tools, your target platform must be **Windows 10** or **Windows Server 2016** (or later). + +These changes allow for better performance, enhanced security, and alignment with the most recent Windows platform capabilities. + +### Support for Mobile development with C++ and Embedded and IoT tools + +Starting with Visual Studio 2026 (version 18.0), the **Mobile development with C++** workload for iOS and Android targeting in the Visual Studio installer and the **Embedded and IoT tools**--including RTOS Viewer, Serial Monitor, Peripheral Viewer, and ST Project Import--are no longer supported and will be removed in a future update. However, the Android NDKs listed in the Mobile development with C++ workload continue to be supported. \ No newline at end of file diff --git a/docs/porting/fix-your-dependencies-on-library-internals.md b/docs/porting/fix-your-dependencies-on-library-internals.md index da55c80f3cb..432dff02a01 100644 --- a/docs/porting/fix-your-dependencies-on-library-internals.md +++ b/docs/porting/fix-your-dependencies-on-library-internals.md @@ -1,9 +1,8 @@ --- -description: "Learn more about: Fix your dependencies on C++ library internals" title: "Fix your dependencies on C++ library internals" -ms.date: "05/24/2017" +description: "Learn more about: Fix your dependencies on C++ library internals" +ms.date: 05/24/2017 helpviewer_keywords: ["library internals in an upgraded Visual Studio C++ project", "_Hash_seq in an upgraded Visual Studio C++ project"] -ms.assetid: 493e0452-6ecb-4edc-ae20-b6fce2d7d3c5 --- # Fix your dependencies on C++ library internals @@ -13,13 +12,13 @@ In most cases, the What's New or Breaking Changes document for each release of V ## _Hash_seq -The internal hash function `std::_Hash_seq(const unsigned char *, size_t)`, used to implement `std::hash` on some string types, was visible in recent versions of the Standard Library. This function implemented an [FNV-1a hash]( https://en.wikipedia.org/wiki/Fowler%E2%80%93Noll%E2%80%93Vo_hash_function) on a character sequence. +The internal hash function `std::_Hash_seq(const unsigned char *, size_t)`, used to implement `std::hash` on some string types, was visible in recent versions of the Standard Library. This function implemented an [FNV-1a hash](https://en.wikipedia.org/wiki/Fowler%E2%80%93Noll%E2%80%93Vo_hash_function) on a character sequence. To remove this dependency, you have a couple of options. - If your intent is to put a `const char *` sequence into an unordered container by using the same hash code machinery as `basic_string`, you can do that by using the `std::hash` template overload that takes a `std::string_view`, which returns that hash code in a portable way. The string library code may or may not rely on use of an FNV-1a hash in the future, so this is the best way to avoid a dependency on a particular hash algorithm. -- If your intent is to generate an FNV-1a hash over arbitrary memory, we've made that code available on GitHub in the [VCSamples]( https://github.com/Microsoft/vcsamples) repository in a stand-alone header file, [fnv1a.hpp](https://github.com/Microsoft/VCSamples/tree/master/VC2015Samples/_Hash_seq), under an [MIT license](https://github.com/Microsoft/VCSamples/blob/master/license.txt). We've also included a copy here for your convenience. You can copy this code into a header file, add the header to any affected code, and then find and replace `_Hash_seq` by `fnv1a_hash_bytes`. You'll get identical behavior to the internal implementation in `_Hash_seq`. +- If your intent is to generate an FNV-1a hash over arbitrary memory, we've made that code available on GitHub in the [VCSamples](https://github.com/Microsoft/vcsamples) repository in a stand-alone header file, [fnv1a.hpp](https://github.com/Microsoft/VCSamples/tree/master/VC2015Samples/_Hash_seq), under an [MIT license](https://github.com/Microsoft/VCSamples/blob/master/license.txt). We've also included a copy here for your convenience. You can copy this code into a header file, add the header to any affected code, and then find and replace `_Hash_seq` by `fnv1a_hash_bytes`. You'll get identical behavior to the internal implementation in `_Hash_seq`. ```cpp /* diff --git a/docs/porting/floating-point-migration-issues.md b/docs/porting/floating-point-migration-issues.md index c35a83ae9c3..6393e435c75 100644 --- a/docs/porting/floating-point-migration-issues.md +++ b/docs/porting/floating-point-migration-issues.md @@ -2,27 +2,26 @@ description: "Learn more about: Floating-point migration issues" title: "Floating-point migration issues" ms.date: "05/17/2017" -ms.assetid: 36a1b552-2f2b-4919-bc9d-c17f42434954 --- # Floating-point migration issues -Sometimes when you upgrade your projects to a newer version of Visual Studio, you may find that the results of certain floating-point operations have changed. This generally happens for one of two reasons: Code generation changes that take better advantage of the available processor, and bug fixes or changes to the algorithms used in math functions in the C runtime library (CRT). In general, the new results are correct to within the limits specified by the language standard. Read on to find out what's changed, and if it's important, how to get the same results your functions got before. +Sometimes when you upgrade your projects to a newer version of Visual Studio, you may notice changes in the results of certain floating-point operations. This generally happens for one of two reasons: Code generation changes that take better advantage of the available processor, and bug fixes or changes to the algorithms used in math functions in the C runtime library (CRT). In general, the new results are correct to within the limits specified by the language standard. Read on to find out what's changed, and if it's important, how to get the same results your functions got before. ## New math functions and Universal CRT changes -Most CRT math functions have been available in Visual Studio for years, but starting in Visual Studio 2013, all of the functions required by ISO C99 are included. These functions are implemented to balance performance with correctness. Because producing the correctly rounded result in every case may be prohibitively expensive, these functions are designed to efficiently produce a close approximation to the correctly rounded result. In most cases, the result produced is within +/-1 unit of least precision, or *ulp*, of the correctly rounded result, though there may be cases where there is greater inaccuracy. If you were using a different math library to get these functions before, implementation differences may be responsible for the change in your results. +Most CRT math functions have been available in Visual Studio for years, but starting in Visual Studio 2013, all of the functions required by ISO C99 are included. These functions are implemented to balance performance with correctness. Because producing the correctly rounded result in every case may be prohibitively expensive, these functions are designed to efficiently produce a close approximation to the correctly rounded result. In most cases, the result produced is within +/-1 unit of least precision, or *ulp*, of the correctly rounded result, though there may be cases where there's greater inaccuracy. If you used a different math library to obtain these functions earlier, implementation differences might explain the change in your results. -When the math functions were moved to the Universal CRT in Visual Studio 2015, some new algorithms were used, and several bugs in the implementation of the functions that were new in Visual Studio 2013 were fixed. These changes can lead to detectable differences in the results of floating-point calculations that use these functions. The functions that had bug issues were erf, exp2, remainder, remquo, scalbln, and scalbn, and their float and long double variants. Other changes in Visual Studio 2015 fixed issues in preserving floating point status word and exception state information in _clear87, _clearfp, fegetenv, fesetenv, and feholdexcept functions. +When the math functions were moved to the Universal CRT in Visual Studio 2015, some new algorithms were used, and several bugs in the implementation of the functions that were new in Visual Studio 2013 were fixed. These changes can lead to detectable differences in the results of floating-point calculations that use these functions. The functions that had bug issues were `erf`, `exp2`, `remainder`, `remquo`, `scalbln`, and `scalbn`, and their float and long double variants. Other changes in Visual Studio 2015 fixed issues in preserving floating point status word and exception state information in `_clear87`, `_clearfp`, `fegetenv`, `fesetenv`, and `feholdexcept` functions. ## Processor differences and compiler flags -Many of the floating point math library functions have different implementations for different CPU architectures. For example, the 32-bit x86 CRT may have a different implementation than the 64-bit x64 CRT. In addition, some of the functions may have multiple implementations for a given CPU architecture. The most efficient implementation is selected dynamically at run-time depending on the instruction sets supported by the CPU. For example, in the 32-bit x86 CRT, some functions have both an x87 implementation and an SSE2 implementation. When running on a CPU that supports SSE2, the faster SSE2 implementation is used. When running on a CPU that does not support SSE2, the slower x87 implementation is used. You may see this when migrating old code, because the default x86 compiler architecture option changed to [/arch:SSE2](../build/reference/arch-x86.md) in Visual Studio 2012. Because different implementations of the math library functions may use different CPU instructions and different algorithms to produce their results, the functions may produce different results on different platforms. In most cases, the results are within +/-1 ulp of the correctly rounded result, but the actual results may vary across CPUs. +Many of the floating point math library functions have different implementations for different CPU architectures. For example, the 32-bit x86 CRT may have a different implementation than the 64-bit x64 CRT. In addition, some of the functions may have multiple implementations for a given CPU architecture. The most efficient implementation is selected dynamically at run-time depending on the instruction sets supported by the CPU. For example, in the 32-bit x86 CRT, some functions have both an x87 implementation and an SSE2 implementation. When running on a CPU that supports SSE2, the faster SSE2 implementation is used. When running on a CPU that doesn't support SSE2, the slower x87 implementation is used. You may see this when migrating old code, because the default x86 compiler architecture option changed to [/arch:SSE2](../build/reference/arch-x86.md) in Visual Studio 2012. Because different implementations of the math library functions may use different CPU instructions and different algorithms to produce their results, the functions may produce different results on different platforms. In most cases, the results are within +/-1 ulp of the correctly rounded result, but the actual results may vary across CPUs. -Code-generation correctness improvements in different floating point modes in Visual Studio can also affect the results of floating-point operations when old code is compared to new code, even when using the same compiler flags. For example, the code generated by Visual Studio 2010 when [/fp:precise](../build/reference/fp-specify-floating-point-behavior.md) (the default) or `/fp:strict` was specified may not have propagated intermediate not-a-number (NaN) values through expressions correctly. Thus, some expressions that gave a numeric result in older compilers may now correctly produce a NaN result. You may also see differences because the code optimizations enabled for `/fp:fast` now take advantage of more processor features. These optimizations can use fewer instructions, but may impact the generated results because some previously visible intermediate operations have been removed. +Code-generation improvements in various floating-point modes can also alter floating-point results when comparing old code to new code, even with identical compiler flags. For example, the code generated by Visual Studio 2010 when [/fp:precise](../build/reference/fp-specify-floating-point-behavior.md) (the default) or `/fp:strict` was specified might not propagate intermediate not-a-number (NaN) values through expressions correctly. Thus, some expressions that gave a numeric result in older compilers may now correctly produce a NaN result. You may also see differences because the code optimizations enabled for `/fp:fast` now take advantage of more processor features. These optimizations can use fewer instructions, but may impact the generated results because some previously visible intermediate operations have been removed. ## How to get identical results -In most cases, the floating-point changes in the newest compilers and libraries result in faster or more correct behavior, or both. You may even see better processor power performance when SSE2 instructions replace x87 instructions. However, if you have code that must precisely replicate the floating point behavior of an older compiler, consider using Visual Studio native multi-targeting capabilities, and build the affected project with the older toolset. For more information, see [Use native multi-targeting in Visual Studio to build old projects](use-native-multi-targeting.md). +In most cases, the floating-point changes in the newest compilers and libraries result in faster or more correct behavior, or both. You may even see better processor power performance when SSE2 instructions replace x87 instructions. However, if you have code that must precisely replicate the floating point behavior of an older compiler, consider using Visual Studio native multi-targeting capabilities, and build the affected project with the older build tools. For more information, see [Use native multi-targeting in Visual Studio to build old projects](use-native-multi-targeting.md). ## See also diff --git a/docs/porting/ide-tools-for-upgrading-code.md b/docs/porting/ide-tools-for-upgrading-code.md index 1ce1e805274..f94f44ac1cb 100644 --- a/docs/porting/ide-tools-for-upgrading-code.md +++ b/docs/porting/ide-tools-for-upgrading-code.md @@ -1,14 +1,14 @@ --- title: "Visual Studio IDE tools for upgrading C++ code" description: "The C++ code editor and code analysis tools in Visual Studio help you to modernize your C++ code base." -ms.date: "11/13/2019" -ms.topic: "conceptual" +ms.date: "11/06/2025" +ms.topic: "concept-article" --- # Visual Studio IDE tools for upgrading C++ code Visual Studio helps you upgrade legacy C++ code with compiler options, code analysis warnings, and editor features such as Quick Fixes, Quick Info, and the enhanced scroll bar. The term "legacy code" refers to any of these categories: -- Code that was formerly allowed by the Microsoft C++ compiler (MSVC) but never conformed to the C++ standard. +- Code that was formerly allowed by the Microsoft C++ (MSVC) compiler but never conformed to the C++ standard. To upgrade older non-conforming MSVC code, turn on the [`/permissive-`](../build/reference/permissive-standards-conformance.md) compiler option. All instances of non-conforming usages are underlined with red squiggles in the code editor. The error messages in the **Error List** window include a recommendation for how to fix the error. Click on the error code to go to its help page in the documentation. If fixing all the errors at once is impractical, you can upgrade non-conforming code in stages by turning on the **`/permissive-`** option, fixing some errors, then turning the option off again. The code will compile with the new improvements, and you can go back and fix the remaining issues at a later time. See the [`/permissive-`](../build/reference/permissive-standards-conformance.md) page for examples of non-conforming MSVC code. @@ -22,19 +22,15 @@ Visual Studio helps you upgrade legacy C++ code with compiler options, code anal ## Open and convert a legacy project -If your legacy project is based on an older version of Visual Studio, you can open it in Visual Studio 2017 or Visual Studio 2019. Visual Studio automatically converts it to the current project schema with support for all the latest compiler and IDE features. +If your legacy projects are based on an older version of Visual Studio, you can still load them in a newer version and work on it there while maintaining backwards compatibility with the older version. When you are ready to permanently move to the new version of Visual Studio, you can retarget your projects. This will enable you to use the latest build tools and project features in the IDE, but you will no longer be able to load the retargeted projects in the older version of Visual Studio. -![Screenshot of the Upgrade a project dialog.](media/upgrade-dialog-v142.png "Upgrade a project") +To retarget projects to the Visual Studio 2026 format, you can use the setup assistant which appears the first time you open a solution containing older projects. You can also access it by right-clicking the solution in **Solution Explorer** and selecting **Retarget solution**. -For more information, see [Upgrade C++ projects from earlier versions of Visual Studio](upgrading-projects-from-earlier-versions-of-visual-cpp.md). - -## Search the code base +![Screenshot of the Visual Studio 2026 setup assistant showing a list of projects selected for retargeting to the latest MSVC Build Tools and v145 Platform Toolset.](media/vs-2026-setup-assistant.png "Upgrade projects") -Upgrading a code base often involves searching through multiple files. To search for anything in your code base, press **Ctrl+T** to bring up the **Go to All** search box. +The setup assistant then gives you the choice to either stay on the older version and install any missing build tools or Windows SDKs necessary to build, or retarget the projects to upgrade them. You can make retargeting selections for each project in the solution or select **Retarget all** > **Apply** to upgrade. -![Screenshot of the Go to all dialog.](media/go-to-all.png "Go to all") - -To narrow the search scope, type one of the 1-letter filters, followed by a space and then the thing you are looking for. +For more information, see [Upgrade C++ projects from earlier versions of Visual Studio](upgrading-projects-from-earlier-versions-of-visual-cpp.md). ## Error List diff --git a/docs/porting/introduction-to-visual-cpp-for-unix-users.md b/docs/porting/introduction-to-visual-cpp-for-unix-users.md index 87dc4245886..e70d60b5806 100644 --- a/docs/porting/introduction-to-visual-cpp-for-unix-users.md +++ b/docs/porting/introduction-to-visual-cpp-for-unix-users.md @@ -3,12 +3,15 @@ description: "Learn more about: Introduction to Microsoft C++ for UNIX Users" title: "Introduction to Microsoft C++ for UNIX Users" ms.date: 06/22/2021 helpviewer_keywords: ["UNIX [C++]"] -ms.assetid: 36108b31-e7fa-49a8-a1f7-7077fcbec873 +ms.topic: concept-article --- # Introduction to Microsoft C++ for UNIX Users This topic provides information for users of all flavors of UNIX who are new to Visual Studio and want to become productive with C++ either from the command line or by using Visual Studio. You can use Visual Studio with the Microsoft C++ compiler to target Windows. You can also use the Visual Studio IDE with GCC or Clang in UNIX environments such as remote Linux machines, MinGW-w64, and Windows Subsystem for Linux. To use C++ in Visual Studio, the **Desktop Development with C++** workload must be installed. Open the Visual Studio Installer to install the workload or add or remove optional components. Also install the **Linux Development with C++** workload if you'll be targeting a remote Linux machine. For Android or iOS development, install the **Mobile Development with C++** workload. +> [!IMPORTANT] +> Starting with Visual Studio 2026 (version 18.0), the Mobile development with C++ workload for iOS and Android, as well as the Embedded and IoT tools (RTOS Viewer, Serial Monitor, Peripheral Viewer, and ST Project Import), are no longer supported and will be removed in a future update. The Android NDKs included in the Mobile development with C++ workload remain supported. + ## Getting started on the command line You can use the Microsoft C++ compiler from the command line in a similar way that you would use a UNIX command-line environment. You compile from the command prompt by using the command-line C and C++ compiler (CL.EXE), linker (LINK.EXE), and other tools, including NMAKE.EXE, the Microsoft version of the UNIX make utility. diff --git a/docs/porting/media/app-modernization-cmake-ice-breaker.png b/docs/porting/media/app-modernization-cmake-ice-breaker.png new file mode 100644 index 00000000000..676e21dbbc5 Binary files /dev/null and b/docs/porting/media/app-modernization-cmake-ice-breaker.png differ diff --git a/docs/porting/media/app-modernization-msbuild-ice-breaker.png b/docs/porting/media/app-modernization-msbuild-ice-breaker.png new file mode 100644 index 00000000000..0820fec37c1 Binary files /dev/null and b/docs/porting/media/app-modernization-msbuild-ice-breaker.png differ diff --git a/docs/porting/media/copilot-app-modernization-context-menu.png b/docs/porting/media/copilot-app-modernization-context-menu.png new file mode 100644 index 00000000000..9b671eadc33 Binary files /dev/null and b/docs/porting/media/copilot-app-modernization-context-menu.png differ diff --git a/docs/porting/media/enable-copilot-app-modernization-cpp.png b/docs/porting/media/enable-copilot-app-modernization-cpp.png new file mode 100644 index 00000000000..3e0047e42cc Binary files /dev/null and b/docs/porting/media/enable-copilot-app-modernization-cpp.png differ diff --git a/docs/porting/media/upgrade-cpp.png b/docs/porting/media/upgrade-cpp.png new file mode 100644 index 00000000000..02870caa060 Binary files /dev/null and b/docs/porting/media/upgrade-cpp.png differ diff --git a/docs/porting/media/vs-2026-setup-assistant.png b/docs/porting/media/vs-2026-setup-assistant.png new file mode 100644 index 00000000000..85fe9817386 Binary files /dev/null and b/docs/porting/media/vs-2026-setup-assistant.png differ diff --git a/docs/porting/modifying-winver-and-win32-winnt.md b/docs/porting/modifying-winver-and-win32-winnt.md index 6c6e1fe1556..79fb1051490 100644 --- a/docs/porting/modifying-winver-and-win32-winnt.md +++ b/docs/porting/modifying-winver-and-win32-winnt.md @@ -4,10 +4,11 @@ description: "When and how to update WINVER and _WIN32_WINNT macros in upgraded ms.date: "06/19/2020" helpviewer_keywords: ["WINVER in an upgraded Visual Studio C++ project", "_WIN32_WINNT in an upgraded Visual Studio C++ project"] ms.assetid: 6a1f1d66-ae0e-48a7-81c3-524d8e8f3447 +ms.topic: how-to --- # Update WINVER and _WIN32_WINNT -When you use the Windows SDK, you can specify which versions of Windows your code can run on. The preprocessor macros **WINVER** and **_WIN32_WINNT** specify the minimum operating system version your code supports. Visual Studio and the Microsoft C++ compiler support targeting Windows 7 SP1 and later. Older toolsets include support for Windows XP SP2, Windows Server 2003 SP1, Vista, and Windows Server 2008. Windows 95, Windows 98, Windows ME, Windows NT, and Windows 2000 are unsupported. +When you use the Windows SDK, you can specify which versions of Windows your code can run on. The preprocessor macros **WINVER** and **_WIN32_WINNT** specify the minimum operating system version your code supports. Visual Studio and the Microsoft C++ compiler support targeting Windows 7 SP1 and later. Older build tools include support for Windows XP SP2, Windows Server 2003 SP1, Vista, and Windows Server 2008. Windows 95, Windows 98, Windows ME, Windows NT, and Windows 2000 are unsupported. When you upgrade an older project, you may need to update your **WINVER** or **_WIN32_WINNT** macros. If they're assigned values for an unsupported version of Windows, you may see compilation errors related to these macros. diff --git a/docs/porting/overview-of-potential-upgrade-issues-visual-cpp.md b/docs/porting/overview-of-potential-upgrade-issues-visual-cpp.md index d6167c1c635..49014006de0 100644 --- a/docs/porting/overview-of-potential-upgrade-issues-visual-cpp.md +++ b/docs/porting/overview-of-potential-upgrade-issues-visual-cpp.md @@ -1,40 +1,41 @@ --- -description: "Learn more about: Overview of potential upgrade issues (Visual C++)" -title: "Overview of potential upgrade issues (Visual C++)" -ms.date: 10/22/2021 +description: "Learn more about: Overview of potential upgrade issues (Microsoft C++)" +title: "Overview of potential upgrade issues (Microsoft C++)" +ms.date: 10/29/2025 ms.assetid: 2c99a8cb-098f-4a9d-bf2c-b80fd06ace43 +ms.topic: upgrade-and-migration-article --- -# Overview of potential upgrade issues (Visual C++) +# Overview of potential upgrade issues (Microsoft C++) -Over the years, the Microsoft C++ compiler has undergone many changes, along with changes in the C++ language itself, the C++ Standard Library, the C runtime (CRT), and other libraries such as MFC and ATL. As a result, when you upgrade an application from an earlier version of Visual Studio you might see compiler and linker errors and warnings in code that previously compiled cleanly. The older the original code base, the greater the potential for such errors. This overview summarizes the most common classes of issues you're likely to see, and provides links to more detailed information. +Over the years, the Microsoft C++ (MSVC) compiler has undergone many changes, along with changes in the C++ language itself, the C++ Standard Library (STL), the C runtime (CRT), and other libraries such as MFC and ATL. As a result, when you upgrade an application from an earlier version of Visual Studio you might see compiler and linker errors and warnings in code that previously compiled cleanly. The older the original code base, the greater the potential for such errors. This overview summarizes the most common classes of issues you're likely to see, and provides links to more detailed information. > [!NOTE] > In the past, we've recommended that upgrades that span several versions of Visual Studio should be performed incrementally one version at a time. We no longer recommend this approach. We've found that it's almost always simpler to upgrade to the most current version of Visual Studio no matter how old the code base. Questions or comments about the upgrade process can be sent to vcupgrade@microsoft.com. -## Library and toolset dependencies +## Library and build tools dependencies > [!NOTE] -> This section applies to applications and libraries built with Visual Studio 2013 and earlier. The toolsets used in Visual Studio 2015, Visual Studio 2017 and Visual Studio 2019 are binary compatible. For more information, see [C++ Binary Compatibility between Visual Studio versions](binary-compat-2015-2017.md). +> This section applies to applications and libraries built with Visual Studio 2013 and earlier. The build tools used in Visual Studio 2015, Visual Studio 2017 and Visual Studio 2019 are binary compatible. For more information, see [C++ Binary Compatibility between Visual Studio versions](binary-compat-2015-2017.md). When you upgrade an app from Visual Studio 2013 or before to a newer version, it's often both advisable and necessary to upgrade all libraries and DLLs the app links to. Either you must have access to the source code, or the library vendor must provide new binary files compiled with the same major version of the compiler. If one of these conditions is true, then you can skip this section, which deals with the details of binary compatibility. If neither is the case, then the libraries might not work in your upgraded app. The information in this section will help you understand whether you can continue with the upgrade. -### Toolset +### Build tools -The *`.obj`* and *`.lib`* file formats are well defined and rarely change. Sometimes additions are made to these file formats, but these additions generally don't affect the ability of newer toolsets to consume object files and libraries produced by older toolsets. The major exception is if you compile using [`/GL` (Whole Program Optimization)](../build/reference/gl-whole-program-optimization.md). If you compile using `/GL`, you can only link the resulting object file by using the same toolset that was used to produce it. So, if you produce an object file with `/GL` and use a Visual Studio 2017 (v141) compiler, you must link it using the Visual Studio 2017 (v141) linker. It's because the internal data structures within the object files aren't stable across major versions of the toolset. Newer toolsets don't understand the older data formats. +The *`.obj`* and *`.lib`* file formats are well defined and rarely change. Sometimes additions are made to these file formats, but these additions generally don't affect the ability of newer build tools to consume object files and libraries produced by older build tools. The major exception is if you compile using [`/GL` (Whole Program Optimization)](../build/reference/gl-whole-program-optimization.md). If you compile using `/GL`, you can only link the resulting object file by using the same build tools that were used to produce it. So, if you produce an object file with `/GL` and use a Visual Studio 2017 (v141) compiler, you must link it using the Visual Studio 2017 (v141) linker. It's because the internal data structures within the object files aren't stable across major versions of the build tools. Newer build tools don't understand the older data formats. -C++ doesn't have a stable application binary interface (ABI). But Visual Studio maintains a stable C++ ABI for all minor versions of a release. Visual Studio 2015 (v140), Visual Studio 2017 (v141), Visual Studio 2019 (v142), and Visual Studio 2022 (v143) toolsets vary only in their minor version. They all have the same major version number, which is 14. For more information, see [C++ Binary Compatibility between Visual Studio versions](binary-compat-2015-2017.md). +C++ doesn't have a stable application binary interface (ABI). But Visual Studio maintains a stable C++ ABI for all minor versions of a release. Visual Studio 2015 (v140), Visual Studio 2017 (v141), Visual Studio 2019 (v142), Visual Studio 2022 (v143), and Visual Studio 2026 (v145) build tools vary only in their minor version. They all have the same major version number, which is 14. For more information, see [C++ Binary Compatibility between Visual Studio versions](binary-compat-2015-2017.md). -If you have an object file that has external symbols with C++ linkage, that object file may not link correctly with object files produced by a different major version of the toolset. There are many possible outcomes: the link might fail entirely (for example, if name decoration changed). The link could succeed, but the app could fail at runtime (for example, if type layouts changed). Or your app might continue to work and nothing will go wrong. Also note, while the C++ ABI isn't stable, the C ABI and the subset of the C++ ABI required for COM are stable. +If you have an object file that has external symbols with C++ linkage, that object file may not link correctly with object files produced by a different major version of the build tools. There are many possible outcomes: the link might fail entirely (for example, if name decoration changed). The link could succeed, but the app could fail at runtime (for example, if type layouts changed). Or your app might continue to work and nothing will go wrong. Also note, while the C++ ABI isn't stable, the C ABI and the subset of the C++ ABI required for COM are stable. -If you link to an import library, any later version of the Visual Studio redistributable libraries that preserve ABI compatibility may be used at runtime. For example, if you compile and link your app by using the Visual Studio 2015 Update 3 toolset, you can use any later redistributable. That's because the 2015, 2017, 2019, and 2022 libraries have preserved backward binary compatibility. The reverse isn't true: You can't use a redistributable for an earlier version of the toolset than you used to build any component of your code. +If you link to an import library, any later version of the Visual Studio redistributable libraries that preserve ABI compatibility may be used at runtime. For example, if you compile and link your app by using the Visual Studio 2015 Update 3 build tools, you can use any later redistributable. That's because the 2015, 2017, 2019, 2022, and 2026 libraries have preserved backward binary compatibility. The reverse isn't true: You can't use a redistributable for an earlier version of the build tools than you used to build any component of your code. ### Libraries If you `#include` a particular version of the header files, you must link the resulting object file to the same version of the libraries. So, for example, if your source file includes the Visual Studio 2015 Update 3 ``, you must link with the Visual Studio 2015 Update 3 *`vcruntime`* library. Similarly, if your source file includes the Visual Studio 2017 version 15.5 ``, you must link with the Visual Studio 2017 version 15.5 Standard C++ library, *`msvcprt`*. Mixing-and-matching isn't supported. -For the C++ Standard Library, mixing-and-matching has been explicitly disallowed by use of `#pragma detect_mismatch` in the standard headers since Visual Studio 2010. If you try to link incompatible object files, or if you link with the wrong standard library, the link fails. +For the Microsoft C++ Standard Library (STL), mixing-and-matching has been explicitly disallowed by use of `#pragma detect_mismatch` in the standard headers since Visual Studio 2010. If you try to link incompatible object files, or if you link with the wrong standard library, the link fails. Older CRT version mixing-and-matching was never supported, but it often just worked because the API surface didn't change much over time. The Universal CRT broke backwards compatibility so that in the future we can maintain backwards compatibility. We have no plans to introduce new, versioned Universal CRT binaries in the future. Instead, the existing Universal CRT is now updated in-place. @@ -46,7 +47,7 @@ If you have a static library built by using an older version of the C Runtime he 1. If you can't (or don't want to) rebuild the static library, you may try linking with *`legacy_stdio_definitions.lib`*. If it satisfies the link-time dependencies of your static library, you'll want to thoroughly test the static library as it's used in the binary. Make sure it isn't adversely affected by any of the [behavioral changes that were made to the Universal CRT](visual-cpp-change-history-2003-2015.md#BK_CRT). -1. Perhaps your static library's dependencies aren't satisfied by *`legacy_stdio_definitions.lib`* or the library doesn't work with the Universal CRT because of behavior changes. In this case, we recommend you encapsulate your static library into a DLL that you link with the required version of the Microsoft C Runtime. For example, if the static library was built using Visual Studio 2013, build this DLL using the Visual Studio 2013 toolset and C++ libraries as well. By building the library into a DLL, you encapsulate the implementation detail that is its dependency on a particular version of the Microsoft C Runtime. Be careful the DLL interface doesn't leak details of which C Runtime it uses, for example, if it returns a `FILE*` across the DLL boundary, or a `malloc`-allocated pointer the caller must `free`. +1. Perhaps your static library's dependencies aren't satisfied by *`legacy_stdio_definitions.lib`* or the library doesn't work with the Universal CRT because of behavior changes. In this case, we recommend you encapsulate your static library into a DLL that you link with the required version of the Microsoft C Runtime. For example, if the static library was built using Visual Studio 2013, build this DLL using the Visual Studio 2013 build tools and C++ libraries as well. By building the library into a DLL, you encapsulate the implementation detail that is its dependency on a particular version of the Microsoft C Runtime. Be careful the DLL interface doesn't leak details of which C Runtime it uses, for example, if it returns a `FILE*` across the DLL boundary, or a `malloc`-allocated pointer the caller must `free`. Use of multiple CRTs in a single process isn't in and of itself problematic. (In fact, most processes load multiple CRT DLLs. For example, Windows operating system components depend on *`msvcrt.dll`*, and the CLR depends on its own private CRT.) Problems arise when you jumble state from different CRTs. For example, you shouldn't allocate memory using `msvcr110.dll!malloc` and attempt to deallocate that memory using `msvcr120.dll!free`, and you shouldn't attempt to open a FILE using `msvcr110!fopen` and attempt to read from that FILE using `msvcr120!fread`. As long as you don't jumble state from different CRTs, you can safely have multiple CRTs loaded in a single process. @@ -71,7 +72,7 @@ For unresolved symbols, you might need to fix up your project settings. - If the external is defined in a *`.lib`* file, have you specified the lib path in the project properties, and is the correct version of the *`.lib`* file located there? -- Are you attempting to link to a *`.lib`* file that was compiled with a different version of Visual Studio? If so, see the previous section on library and toolset dependencies. +- Are you attempting to link to a *`.lib`* file that was compiled with a different version of Visual Studio? If so, see the previous section on library and build tools dependencies. - Do the types of the arguments at the call site actually match an existing overload of the function? Verify the underlying types are what you expect, both for any typedefs in the function's signature and in the code that calls the function. @@ -154,7 +155,7 @@ Windows API documentation lists the minimum or maximum supported operating syste ### Windows version -When upgrading a program that uses the Windows API either directly or indirectly, you need to decide the minimum Windows version to support. In most cases, Windows 7 is a good choice. For more information, see [Header file problems](porting-guide-spy-increment.md#header_file_problems). The `WINVER` macro defines the oldest version of Windows that your program is designed to run on. If your MFC program sets `WINVER` to 0x0501 (Windows XP) you'll get a warning because MFC no longer supports XP, even if the compiler toolset itself has an XP mode. Compiler toolset support for Windows XP ended in Visual Studio 2017. +When upgrading a program that uses the Windows API either directly or indirectly, you need to decide the minimum Windows version to support. In most cases, Windows 7 is a good choice. For more information, see [Header file problems](porting-guide-spy-increment.md#header_file_problems). The `WINVER` macro defines the oldest version of Windows that your program is designed to run on. If your MFC program sets `WINVER` to 0x0501 (Windows XP) you'll get a warning because MFC no longer supports XP, even if the build tools have an XP mode. Build tools support for Windows XP ended in Visual Studio 2017, and support for Windows 7, 8.0 and 8.1 ended in Visual Studio 2026. For more information, see [Updating the target windows version](porting-guide-spy-increment.md#updating_winver) and [More outdated header files](porting-guide-spy-increment.md#outdated_header_files). @@ -170,15 +171,15 @@ This error can occur in MFC applications. It indicates an ordering issue between If your original code is compiled for 32-bit systems, you have the option of creating a 64-bit version instead of (or in addition to) a new 32-bit app. In general, you should get your program compiling in 32-bit mode first, and then attempt 64-bit. Compiling for 64-bit is straightforward, but in some cases it can reveal bugs that were hidden by 32-bit builds. -Also, you should be aware of possible compile-time and runtime issues relating to pointer size, time and size values, and size-specific format specifiers in `printf` and `scanf` functions. For more information, see [Configure Visual C++ for 64-bit, x64 targets](../build/configuring-programs-for-64-bit-visual-cpp.md) and [Common Visual C++ 64-bit migration issues](../build/common-visual-cpp-64-bit-migration-issues.md). For more migration tips, see [Programming guide for 64-bit Windows](/windows/win32/WinProg64/programming-guide-for-64-bit-windows). +Also, you should be aware of possible compile-time and runtime issues relating to pointer size, time and size values, and size-specific format specifiers in `printf` and `scanf` functions. For more information, see [Configure Microsoft C++ for 64-bit, x64 targets](../build/configuring-programs-for-64-bit-visual-cpp.md) and [Common Microsoft C++ 64-bit migration issues](../build/common-visual-cpp-64-bit-migration-issues.md). For more migration tips, see [Programming guide for 64-bit Windows](/windows/win32/WinProg64/programming-guide-for-64-bit-windows). ## Unicode vs MBCS/ASCII Before Unicode was standardized, many programs used the Multibyte Character Set (MBCS) to represent characters that weren't included in the ASCII character set. In older MFC projects, MBCS was the default setting. When you upgrade such a program, you'll see warnings that advise to use Unicode instead. If you decide the conversion to Unicode isn't worth the development cost, you may choose to disable or ignore the warning. To disable it for all projects in your solution, open **View** > **Property Manager**, select all projects for which you want to disable the warning, then right-click on the selected items and choose **Properties**. In the **Property Pages** dialog, select **Configuration Properties** > **C/C++** > **Advanced**. In the **Disable Specific Warnings** property, open the drop-down arrow, and then choose **Edit**. Enter 4996 into the text box. (Don't include the 'C' prefix.) Choose **OK** to save the property, then choose **OK** to save your changes. -For more information, see [Porting from MBCS to Unicode](porting-guide-spy-increment.md#porting_to_unicode). For general information about MBCS vs. Unicode, see [Text and Strings in Visual C++](../text/text-and-strings-in-visual-cpp.md) and [Internationalization](../c-runtime-library/internationalization.md) . +For more information, see [Porting from MBCS to Unicode](porting-guide-spy-increment.md#porting_to_unicode). For general information about MBCS vs. Unicode, see [Text and Strings in Microsoft C++](../text/text-and-strings-in-visual-cpp.md) and [Internationalization](../c-runtime-library/internationalization.md) . ## See also -[Upgrading projects from earlier versions of Visual C++](upgrading-projects-from-earlier-versions-of-visual-cpp.md)
+[Upgrading projects from earlier versions of Microsoft C++](upgrading-projects-from-earlier-versions-of-visual-cpp.md)
[C++ conformance improvements in Visual Studio](../overview/cpp-conformance-improvements.md) diff --git a/docs/porting/porting-and-upgrading-examples-and-case-studies.md b/docs/porting/porting-and-upgrading-examples-and-case-studies.md index 84abafd2e48..d4e1d1b4855 100644 --- a/docs/porting/porting-and-upgrading-examples-and-case-studies.md +++ b/docs/porting/porting-and-upgrading-examples-and-case-studies.md @@ -3,6 +3,7 @@ description: "Learn more about: Porting and Upgrading: Examples and Case Studies title: "Porting and Upgrading: Examples and Case Studies" ms.date: "11/04/2016" ms.assetid: d48bbff9-1ea7-467f-8c8b-758601f01573 +ms.topic: concept-article --- # Porting and Upgrading: Examples and Case Studies diff --git a/docs/porting/porting-from-unix-to-win32.md b/docs/porting/porting-from-unix-to-win32.md index db38c1d6212..379d9fc43da 100644 --- a/docs/porting/porting-from-unix-to-win32.md +++ b/docs/porting/porting-from-unix-to-win32.md @@ -4,6 +4,7 @@ title: "Running Linux programs on Windows" ms.date: "07/31/2019" helpviewer_keywords: ["Linux [C++], porting to Win32"] ms.assetid: 3837e4fe-3f96-4f24-b2a1-7be94718a881 +ms.topic: concept-article --- # Running Linux programs on Windows diff --git a/docs/porting/porting-guide-com-spy.md b/docs/porting/porting-guide-com-spy.md index 787bf8c9a80..3df4ffa9163 100644 --- a/docs/porting/porting-guide-com-spy.md +++ b/docs/porting/porting-guide-com-spy.md @@ -3,6 +3,7 @@ description: "Learn more about: Porting Guide: COM Spy" title: "Porting Guide: COM Spy" ms.date: "11/04/2016" ms.assetid: 24aa0d52-4014-4acb-8052-f4e2e4bbc3bb +ms.topic: concept-article --- # Porting Guide: COM Spy diff --git a/docs/porting/porting-guide-mfc-scribble.md b/docs/porting/porting-guide-mfc-scribble.md index a2b0182ad99..8545e8fa71c 100644 --- a/docs/porting/porting-guide-mfc-scribble.md +++ b/docs/porting/porting-guide-mfc-scribble.md @@ -3,6 +3,7 @@ description: "Learn more about: Porting Guide: MFC Scribble" title: "Porting Guide: MFC Scribble" ms.date: "10/23/2019" ms.assetid: 8ddb517d-89ba-41a1-ab0d-4d2c6d9047e8 +ms.topic: concept-article --- # Porting Guide: MFC Scribble diff --git a/docs/porting/porting-guide-spy-increment.md b/docs/porting/porting-guide-spy-increment.md index 208342a0315..d216108360d 100644 --- a/docs/porting/porting-guide-spy-increment.md +++ b/docs/porting/porting-guide-spy-increment.md @@ -1,8 +1,8 @@ --- -description: "Learn more about: Porting Guide: Spy++" title: "Porting Guide: Spy++" -ms.date: "10/23/2019" -ms.assetid: e558f759-3017-48a7-95a9-b5b779d5e51d +description: "Learn more about: Porting Guide: Spy++" +ms.date: 10/23/2019 +ms.topic: concept-article --- # Porting Guide: Spy++ @@ -14,7 +14,7 @@ Spy++ is a widely used GUI diagnostic tool for the Windows desktop that provides We considered this case to be typical for porting Windows desktop applications that use MFC and the Win32 API, especially for old projects that have not been updated with each release of Visual C++ since Visual C++ 6.0. -## Step 1. Converting the project file. +## Step 1. Converting the project file The project file, two old .dsw files from Visual C++ 6.0, converted easily with no issues that require further attention. One project is the Spy++ application. The other is SpyHk, written in C, a supporting DLL. More complex projects might not upgrade as easily, as discussed [here](../porting/visual-cpp-porting-and-upgrading-guide.md). diff --git a/docs/porting/porting-third-party-libraries.md b/docs/porting/porting-third-party-libraries.md index db6afa9358c..d4dab9694be 100644 --- a/docs/porting/porting-third-party-libraries.md +++ b/docs/porting/porting-third-party-libraries.md @@ -1,24 +1,26 @@ --- description: "Learn more about: Porting third-party libraries" title: "Porting Third-Party Libraries" -ms.date: 10/22/2021 -helpviewer_keywords: ["3rd-party libraries", "vspkg"] +ms.date: 10/29/2025 +helpviewer_keywords: ["3rd-party libraries", "vcpkg"] ms.assetid: b055ed20-8a9e-45b2-ac2a-e3d94271c009 +ms.topic: concept-article --- # Porting third-party libraries -When you upgrade a project from Visual Studio 2013 or earlier to the current version of Visual C++, you also have to upgrade any libraries that the project uses. The library and your project must be built by compatible versions and targets of the compiler toolset. If you don't have access to the library source code, and the library isn't available through vcpkg, then you must obtain an updated binary from the library vendor. For more information, see [Overview of potential upgrade issues](overview-of-potential-upgrade-issues-visual-cpp.md). +When you upgrade a project from Visual Studio 2013 or earlier to the current version of Microsoft C++ (MSVC) Build Tools, you also have to upgrade any libraries that the project uses. The library and your project must be built by compatible versions and targets of the build tools. If you don't have access to the library source code, and the library isn't available through vcpkg, then you must obtain an updated binary from the library vendor. For more information, see [Overview of potential upgrade issues](overview-of-potential-upgrade-issues-visual-cpp.md). When you upgrade an application from Visual Studio 2015 or later, it isn't necessary to upgrade dependencies because the code generated by those versions is binary-compatible. For more information, see [C++ binary compatibility between Visual Studio versions](binary-compat-2015-2017.md). ## Use vcpkg for open-source libraries -In the past, finding and upgrading third-party libraries was sometimes a non-trivial task. To make it easier to acquire and rebuild C++ third-party open-source libraries, the Visual C++ team has created a command-line tool called the **VC++ Packaging Tool** or **vcpkg**. Vcpkg has a searchable catalog of many popular C++ open-source libraries. You can install any library in the catalog directly from the vcpkg command line. When you install a library, Vcpkg creates a directory tree on your machine and adds the *`.h`* files, the *`.lib`* files, and binaries in this folder. You can use this folder in your compilation command line, or integrate it into Visual Studio 2015 or later by using the `vcpkg integrate install` command. After you integrate a library location, Visual Studio can find it and add it to any new project that you create. To use a library, just `#include` it. Visual Studio will automatically add the library path to your project settings and copy the DLL to your solution folder. For more information, see [vcpkg](/vcpkg/). +In the past, finding and upgrading third-party libraries was sometimes a non-trivial task. To make it easier to acquire and rebuild C++ third-party open-source libraries, the Microsoft C++ team has created a command-line tool called **[vcpkg](https://vcpkg.io)**. This tool has a searchable catalog (known as the curated registry) of many popular C/C++ open-source libraries. You can install any library in the catalog directly from the vcpkg command line. When you install a library, vcpkg creates a directory tree on your machine and adds the *`.h`* files, the *`.lib`* files, and binaries in this folder. You can use this folder in your compilation command line, or integrate it into Visual Studio 2015 or later by using the `vcpkg integrate install` command. After you integrate a library location, Visual Studio can find it and add it to any new project that you create. To use a library, just `#include` it. Visual Studio will automatically add the library path to your project settings and copy the DLL to your solution folder. For more information, see [vcpkg](/vcpkg/). You can either install [vcpkg from GitHub](https://github.com/microsoft/vcpkg/) or use the built-in version that ships with Visual Studio 2022 or later. To learn more about vcpkg, see the [vcpkg documentation](/vcpkg). ## Reporting issues -If your open-source library isn't found in the **vcpkg** catalog, you can open an issue on the [GitHub repo](https://github.com/Microsoft/vcpkg/issues). That's where the community and the Visual C++ team can see it and potentially create the port file for this library. +If your open-source library isn't found in the **vcpkg** curated registry, you can open an issue on the [GitHub repo](https://github.com/Microsoft/vcpkg/issues). That's where the community and the Microsoft C++ team can see it and potentially create the port file for this library. ## See also -[Visual C++ Porting and Upgrading Guide](visual-cpp-porting-and-upgrading-guide.md) +[Microsoft C++ Porting and Upgrading Guide](visual-cpp-porting-and-upgrading-guide.md) +[vcpkg Documentation](/vcpkg) diff --git a/docs/porting/porting-to-the-universal-windows-platform-cpp.md b/docs/porting/porting-to-the-universal-windows-platform-cpp.md index d6ac9d6883d..83aeac60192 100644 --- a/docs/porting/porting-to-the-universal-windows-platform-cpp.md +++ b/docs/porting/porting-to-the-universal-windows-platform-cpp.md @@ -3,6 +3,7 @@ description: "Learn more about: Porting to the Universal Windows Platform (C++)" title: "Porting to the Universal Windows Platform (C++)" ms.date: "10/23/2019" ms.assetid: f662d2e4-8940-418d-8109-cb76cb8f8569 +ms.topic: how-to --- # Porting to the Universal Windows Platform (C++) @@ -103,5 +104,5 @@ If you created a new UWP project using Visual Studio, you should not see this er ## See also -[Visual C++ Porting Guide](../porting/porting-to-the-universal-windows-platform-cpp.md)
+[Microsoft C++ Porting Guide](../porting/porting-to-the-universal-windows-platform-cpp.md)
[Develop apps for the Universal Windows Platform (UWP)](/visualstudio/cross-platform/develop-apps-for-the-universal-windows-platform-uwp) diff --git a/docs/porting/toc.yml b/docs/porting/toc.yml index 890de59b9b7..934a9ad9859 100644 --- a/docs/porting/toc.yml +++ b/docs/porting/toc.yml @@ -9,6 +9,8 @@ items: href: ../porting/overview-of-potential-upgrade-issues-visual-cpp.md - name: Upgrade your code to the Universal CRT href: ../porting/upgrade-your-code-to-the-universal-crt.md + - name: Modernize your C++ project with GitHub Copilot app modernization + href: ../porting/copilot-app-modernization-cpp.md - name: Update WINVER and _WIN32_WINNT href: ../porting/modifying-winver-and-win32-winnt.md - name: Fix your dependencies on library internals @@ -17,7 +19,7 @@ items: href: ../porting/floating-point-migration-issues.md - name: Use native multi-targeting in Visual Studio to build old projects href: ../porting/use-native-multi-targeting.md - - name: C++ features deprecated in Visual Studio 2019 + - name: C++ features deprecated in Visual Studio href: ../porting/features-deprecated-in-visual-studio.md - name: VCBuild vs. MSBuild href: ../porting/build-system-changes.md diff --git a/docs/porting/upgrade-your-code-to-the-universal-crt.md b/docs/porting/upgrade-your-code-to-the-universal-crt.md index 03e27d4e2a3..bebc69a3fac 100644 --- a/docs/porting/upgrade-your-code-to-the-universal-crt.md +++ b/docs/porting/upgrade-your-code-to-the-universal-crt.md @@ -1,14 +1,15 @@ --- description: "Learn more about: Upgrade your code to the Universal CRT" title: "Upgrade your code to the Universal CRT" -ms.date: 06/28/2022 +ms.date: 10/29/2025 ms.assetid: eaf34c1b-da98-4058-a059-a10db693a5ce +ms.topic: upgrade-and-migration-article --- # Upgrade your code to the Universal CRT The Microsoft C Runtime Library (CRT) was refactored in Visual Studio 2015. The Standard C Library, POSIX extensions and Microsoft-specific functions, macros, and global variables were moved into a new library, the Universal C Runtime Library (Universal CRT or UCRT). The compiler-specific components of the CRT were moved into a new vcruntime library. -The UCRT is now a Windows component, and ships as part of Windows 10 and later. The UCRT supports a stable ABI based on C calling conventions, and it conforms closely to the ISO C99 standard, with only a few exceptions. It's no longer tied to a specific version of the compiler. You can use the UCRT on any version of Windows supported by Visual Studio 2015 or Visual Studio 2017. The benefit is that you no longer need to update your builds to target a new version of the CRT with every upgrade of Visual Studio. +The UCRT is now a Windows component, and ships as part of Windows 10 and later. The UCRT supports a stable ABI based on C calling conventions, and it conforms closely to the ISO C99 standard, with only a few exceptions. It's no longer tied to a specific version of the compiler. You can use the UCRT on any version of Windows supported by Visual Studio 2015 or later. The benefit is that you no longer need to update your builds to target a new version of the CRT with every upgrade of Visual Studio. This refactoring has changed the names or locations of many CRT header files, library files, and Redistributable files, and the deployment methods required for your code. Many functions and macros in the UCRT were also added or changed to improve standards conformance. To take advantage of these changes, you must update your existing code and project build systems. @@ -24,11 +25,13 @@ The retail and debug UCRT DLLs are found in separate locations. The retail DLLs ## Where to find the standard libraries and headers -The C and C++ compiler-specific runtime support library, `vcruntime`, contains the code required to support program startup and features such as exception handling and intrinsics. The library and its header files are still found in the version-specific Microsoft Visual Studio folder in your *Program Files* or *Program files (x86)* directory. +The C and C++ compiler-specific runtime support library, `vcruntime`, contains the code required to support program startup and features such as exception handling and intrinsics. The library and its header files are still found in the version-specific Microsoft Visual Studio folder in your *Program Files* or *Program Files (x86)* directory. -In Visual Studio 2017, 2019, and 2022, the header files are found under `Microsoft Visual Studio\[year]\[edition]\VC\Tools\MSVC\[lib-version]\include`. Here, `[year]` is the version of Visual Studio, `[edition]` is the edition or nickname for Visual Studio, and `[lib-version]` is the build version of the libraries. +In Visual Studio 2017-2022, the header files are found under `Microsoft Visual Studio\[year]\[edition]\VC\Tools\MSVC\[lib-version]\include`. Here, `[year]` is the version of Visual Studio, `[edition]` is the edition or nickname for Visual Studio, and `[lib-version]` is the build version of the libraries. -The link libraries are found under `Microsoft Visual Studio\[year]\[edition]\VC\Tools\MSVC\[lib-version]\lib\[architecture]`, where `[year]` is the version of Visual Studio, `[edition]` is the edition or nickname for Visual Studio, `[lib-version]` is the build version of the libraries, and `[architecture]` is the target processor architecture. Link libraries for OneCore and Store are also found in the libraries folder. +In Visual Studio 2026, the header files are found under `Microsoft Visual Studio\[version]\[channel]\VC\Tools\MSVC\[lib-version]\include`. Here, `[version]` is the major version number, `[channel]` is Insiders or Stable (depending on your Visual Studio build), and `[lib-version]` is the build version of the libraries. + +The link libraries are found under `Microsoft Visual Studio\[version]\[edition]\VC\Tools\MSVC\[lib-version]\lib\[architecture]`, where `[version]` is the year (Visual Studio 2017 - 2022) or major version number (Visual Studio 2026 or later), `[edition]` is the edition or nickname for Visual Studio, `[lib-version]` is the build version of the libraries, and `[architecture]` is the target processor architecture. Link libraries for OneCore and Store are also found in the libraries folder. The retail and debug versions of the static library are `libvcruntime.lib` and `libvcruntimed.lib`. The dynamic link retail and debug stub libraries are `vcruntime.lib` and `vcruntimed.lib`, respectively. @@ -38,18 +41,18 @@ When you update your Visual Studio C++ projects, if you have set the project's * Because the UCRT is now a Microsoft Windows operating system component, it's included as part of the operating system in Windows 10 and later. It's available through Windows Update for older operating systems, Windows Vista through Windows 8.1. A Redistributable version is available for Windows XP. As an operating system component, UCRT updates and servicing are managed by Windows Update independently of Visual Studio and Microsoft C++ compiler versions. Because the UCRT is a Windows component, for security and ease of updates, and a smaller image size, we strongly recommend you use the Redistributable package to do central deployment of the UCRT for your app. -You can use the UCRT on any version of Windows supported by Visual Studio 2015 or later. You can redistribute it using a `vcredist` package for supported versions of Windows before Windows 10. The `vcredist` packages include the UCRT components and automatically install them on Windows operating systems that don't have them installed by default. For more information, see [Redistributing Visual C++ Files](../windows/redistributing-visual-cpp-files.md). +You can use the UCRT on any version of Windows supported by Visual Studio 2015 or later. You can redistribute it using a `vcredist` package for supported versions of Windows before Windows 10. The `vcredist` packages include the UCRT components and automatically install them on Windows operating systems that don't have them installed by default. For more information, see [Redistributing Microsoft C++ Files](../windows/redistributing-visual-cpp-files.md). -App-local deployment of the UCRT is supported, though not recommended for both performance and security reasons. The DLLs for app-local deployment of the UCRT are included as part of the Windows SDK, under the *`redist`* subdirectory. The DLLs required include `ucrtbase.dll` and a set of **APISet forwarder** DLLs named `api-ms-win-[subset].dll`. The set of DLLs required on each operating system varies, so we recommended that you include all of the DLLs when you use app-local deployment. For more information and recommendations about app-local deployment, see [Deployment in Visual C++](../windows/deployment-in-visual-cpp.md). +App-local deployment of the UCRT is supported, though not recommended for both performance and security reasons. The DLLs for app-local deployment of the UCRT are included as part of the Windows SDK, under the *`redist`* subdirectory. The DLLs required include `ucrtbase.dll` and a set of **APISet forwarder** DLLs named `api-ms-win-[subset].dll`. The set of DLLs required on each operating system varies, so we recommended that you include all of the DLLs when you use app-local deployment. For more information and recommendations about app-local deployment, see [Deployment in Microsoft C++](../windows/deployment-in-visual-cpp.md). ## Changes to the Universal CRT functions and macros -Many functions were added or updated in the UCRT to improve ISO C99 conformance, and to address code quality and security issues. In some cases, this required breaking changes to the library. Your code that compiled cleanly when using an older version of the CRT may break when you compile it using the UCRT. If so, you must change your code to take advantage of UCRT updates and features. For a detailed listing of the breaking changes and updates to the CRT found in the Universal CRT, see the [C Runtime Library (CRT)](visual-cpp-change-history-2003-2015.md#BK_CRT) section of the Visual C++ change history. It includes a list of affected headers and functions that you can use to identify the changes needed in your code. +Many functions were added or updated in the UCRT to improve ISO C99 conformance, and to address code quality and security issues. In some cases, this required breaking changes to the library. Your code that compiled cleanly when using an older version of the CRT may break when you compile it using the UCRT. If so, you must change your code to take advantage of UCRT updates and features. For a detailed listing of the breaking changes and updates to the CRT found in the Universal CRT, see the [C Runtime Library (CRT)](visual-cpp-change-history-2003-2015.md#BK_CRT) section of the Microsoft C++ change history. It includes a list of affected headers and functions that you can use to identify the changes needed in your code. ## See also -[Visual C++ porting and upgrading guide](visual-cpp-porting-and-upgrading-guide.md)\ -[Overview of potential upgrade issues (Visual C++)](overview-of-potential-upgrade-issues-visual-cpp.md)\ -[Upgrading projects from earlier versions of Visual C++](upgrading-projects-from-earlier-versions-of-visual-cpp.md)\ +[Microsoft C++ porting and upgrading guide](visual-cpp-porting-and-upgrading-guide.md)\ +[Overview of potential upgrade issues (Microsoft C++)](overview-of-potential-upgrade-issues-visual-cpp.md)\ +[Upgrading projects from earlier versions of Microsoft C++](upgrading-projects-from-earlier-versions-of-visual-cpp.md)\ [Visual C++ change history 2003 - 2015](visual-cpp-change-history-2003-2015.md)\ [C++ conformance improvements in Visual Studio](../overview/cpp-conformance-improvements.md) diff --git a/docs/porting/upgrading-projects-from-earlier-versions-of-visual-cpp.md b/docs/porting/upgrading-projects-from-earlier-versions-of-visual-cpp.md index 53b9ef1a069..471d6105610 100644 --- a/docs/porting/upgrading-projects-from-earlier-versions-of-visual-cpp.md +++ b/docs/porting/upgrading-projects-from-earlier-versions-of-visual-cpp.md @@ -1,20 +1,21 @@ --- title: "Upgrade C++ projects from earlier versions of Visual Studio" description: "How to upgrade Microsoft C++ projects from older versions of Visual Studio." -ms.date: 04/07/2022 +ms.date: 11/05/2025 helpviewer_keywords: ["32-bit code porting", "upgrading Visual C++ applications, 32-bit code"] ms.assetid: 18cdacaa-4742-43db-9e4c-2d9e73d8cc84 +ms.topic: upgrade-and-migration-article --- # Upgrade C++ projects from earlier versions of Visual Studio -To upgrade a project created in an earlier version of Visual Studio, just open the project in the latest version of Visual Studio. Visual Studio offers to upgrade the project to the current schema. +To upgrade a project created in an earlier version of Visual Studio, open the project in the latest version of Visual Studio. If you're still using an older version of Visual Studio side-by-side, you can choose not to upgrade your projects until you're ready to maintain compatibility with both versions. -If you choose **No**, the project doesn't get upgraded. For projects created in Visual Studio 2010 and later, you can still use the project in the newer version of Visual Studio. Just set your project properties to continue to target the older toolset. If you leave the older version of Visual Studio on your computer, its toolset is available in later versions. For example, if your project must continue to run on Windows XP, you can upgrade to Visual Studio 2019. You then specify the toolset as v141_xp or earlier in your project properties. For more information, see [Use native multi-targeting in Visual Studio to build old projects](use-native-multi-targeting.md). +In Visual Studio 2026, this experience is enhanced with a setup assistant. The setup assistant offers to install missing tools using the Visual Studio installer, and to stay on an older version or retarget your projects to the latest version. You can open the setup assistant in **Solution Explorer** by right-clicking your solution and selecting **Retarget solution**. -If you choose **Yes**, then the project gets upgraded in place. It can't be converted back to the earlier version. In upgrade scenarios, that's why it's good practice to make a backup copy of the existing project and solution files. +With the setup assistant open, choose an action for each target or select **Retarget all** to set all projects at once. Then select **Apply** to complete the upgrade in place. Once your projects are retargeted, they can't be converted back to the earlier version. It's good practice to make a backup copy of the existing project and solution files before upgrading them. > [!NOTE] -> Visual Studio 2022 has deprecated support for the upgrade of project types that have *`.dsw`* or *`.dsp`* extensions. You can use an earlier version of Visual Studio, such as Visual Studio 2019, to upgrade these projects, then upgrade them in Visual Studio 2022 to use the latest tools and features of Visual Studio. +> Visual Studio 2022 and later have deprecated support for the upgrade of project types that have *`.dsw`* or *`.dsp`* extensions. You can use an earlier version of Visual Studio, such as Visual Studio 2019, to upgrade these projects, then upgrade them again in Visual Studio 2022 or later to use the latest tools and features of Visual Studio. ## Upgrade reports @@ -36,7 +37,7 @@ When you upgrade a project, you get an upgrade report. The report is also saved - Runtime errors or unexpected results because of behavior changes. -- Errors that were introduced in the tools. If you find an issue, report it to the Visual C++ team through your normal support channels or by using the [Visual Studio C++ Developer Community](https://aka.ms/feedback/report?space=62) page. +- Errors that were introduced in the tools. If you find an issue, report it to the Microsoft C++ team through your normal support channels or by using the [Visual Studio C++ Developer Community](https://aka.ms/feedback/report?space=62) page. Some upgraded projects and solutions can be built successfully without modification. However, most projects will likely require changes to both project settings and your source code. There's no single correct way to go about fixing these issues, but we recommend using a phased approach. Before you start, review [Overview of potential upgrade issues](../porting/overview-of-potential-upgrade-issues-visual-cpp.md) for more information on many kinds of common errors. @@ -71,7 +72,7 @@ For hard-to-fix errors, you can search for solutions or post a question on [Micr ## See also -[What's New for Visual C++ in Visual Studio](../overview/what-s-new-for-visual-cpp-in-visual-studio.md)\ +[What's New for Microsoft C++ in Visual Studio](../overview/what-s-new-for-visual-cpp-in-visual-studio.md)\ [Visual C++ change history 2003 - 2015](../porting/visual-cpp-change-history-2003-2015.md)\ [Nonstandard Behavior](../cpp/nonstandard-behavior.md)\ [Port data applications](../data/data-access-programming-mfc-atl.md) diff --git a/docs/porting/use-native-multi-targeting.md b/docs/porting/use-native-multi-targeting.md index 280f53a6c89..6d57a353278 100644 --- a/docs/porting/use-native-multi-targeting.md +++ b/docs/porting/use-native-multi-targeting.md @@ -1,29 +1,33 @@ --- description: "Learn more about: Use native multi-targeting in Visual Studio to build old projects" title: "Use native multi-targeting in Visual Studio to build old projects" -ms.date: 02/22/2022 +ms.date: 10/29/2025 helpviewer_keywords: ["C++ native multi-targeting", "upgrading Visual C++ applications, retargeting"] ms.assetid: b115aabe-a9dc-4525-90d3-367d97ea20c9 --- # Use native multi-targeting in Visual Studio to build old projects -Normally, we recommend that you update your projects when you install the latest version of Visual Studio. The cost of updating your projects and code is often more than offset by the benefits of the new IDE, compiler, libraries, and tools. However, we know that you may not be able to update some projects. You may have binaries that are tied to older libraries or platforms that for maintenance reasons you can't upgrade. Your code may use non-standard language constructs that would break if you moved to a more recent compiler. Your code might rely on third-party libraries compiled for a specific version of Visual C++. Or you may produce libraries for others that must target a specific older version of Visual C++. +Normally, we recommend that you update your projects when you install the latest version of Visual Studio. The cost of updating your projects and code is often more than offset by the benefits of the new IDE, compiler, libraries, and tools. However, we know that you may not be able to update some projects. You may have binaries that are tied to older libraries or platforms that for maintenance reasons you can't upgrade. Your code may use non-standard language constructs that would break if you moved to a more recent compiler. Your code might rely on third-party libraries compiled for a specific version of Microsoft C++ (MSVC). Or you may produce libraries for others that must target a specific older version of MSVC. -Fortunately, you can use Visual Studio to build projects that target older compiler toolsets and libraries. If you still have the original tools installed, you don't have to upgrade a project from as far back as Visual Studio 2010 to take advantage of new features in the IDE: +Fortunately, you can use Visual Studio to build projects that target older build tools and libraries. If you still have the original tools installed, you don't have to upgrade a project from as far back as Visual Studio 2010 to take advantage of new features in the IDE: -- New C++ refactoring capabilities and editor experimental features +- New C++ refactoring capabilities and editor features - New Diagnostics tools debugger window and Error List window - Revamped breakpoints, exceptions window and new PerfTips - New code navigation and search tools -- New C++ Quick fixes and the Productivity Power Tools extensions. +- New C++ Quick fixes You can also target Visual Studio 2008 projects, but they can't be used unchanged. For details, see the **Instructions for Visual Studio 2008** section. -The latest versions of Visual Studio support native multi-targeting and round-tripping of projects. Native multi-targeting is the ability of the latest IDE to build using toolsets installed by previous versions of Visual Studio. Round-tripping is the ability of the latest IDE to load projects created by a previous IDE version without making any changes to the project. If you install the latest version of Visual Studio side-by-side with your existing version, you can use the new version of the IDE with the compiler and tools from the existing version to build your projects. Other members of your team can continue to use the projects in the older version of Visual Studio. +The latest versions of Visual Studio support native multi-targeting and round-tripping of projects. Native multi-targeting is the ability of the latest IDE to build using build tools installed by previous versions of Visual Studio. Round-tripping is the ability of the latest IDE to load projects created by a previous IDE version without making any changes to the project. If you install the latest version of Visual Studio side-by-side with your existing version, you can use the new version of the IDE with the compiler and tools from the existing version to build your projects. Other members of your team can continue to use the projects in the older version of Visual Studio. -When you use an older toolset, you can take advantage of many of the latest IDE features, but not the latest advances in the C++ compiler, libraries and build tools. For example, you won't be able to use the new language conformance improvements, new debugging and code analysis features, or get the faster build throughput of the latest toolset. There are also some IDE features that are incompatible with older toolsets. For example, type information may be missing in the Memory Profiler, and the refactoring operation **Convert to Raw string literals** generates C++11-conformant code that won't compile when you use Visual Studio 2012 or older toolsets. +When you use an older build tools version, you can take advantage of many of the latest IDE features, but not the latest advances in the C++ compiler, libraries and build tools. For example, you won't be able to use the new language conformance improvements, new debugging and code analysis features, or get the faster build throughput of the latest build tools. There are also some IDE features that are incompatible with older build tools. For example, type information may be missing in the Memory Profiler, and the refactoring operation **Convert to Raw string literals** generates C++11-conformant code that won't compile when you use Visual Studio 2012 or older build tools. -## How to use native multi-targeting in Visual Studio +## How to use native multi-targeting in Visual Studio 2026 + +Visual Studio 2026 includes a new **Setup assistant**. You can load an existing solution, and in **Solution Explorer** select **Retarget solution** to open the assistant. You can use the assistant to install missing C++ build tools (MSVC components and Windows SDKs) compatible with the projects you are loading, including tools originally shipped with older Visual Studio versions. This allows you to continue working with your existing projects without losing compatibility with your previous Visual Studio version. Later, when you are ready to fully upgrade, you can use the assistant to retarget these projects to the newest version of the IDE. + +## How to use native multi-targeting in Visual Studio 2010-2022 Once you have installed Visual Studio side-by-side with your older version, open your existing project in the new version of Visual Studio. When the project is loaded, Visual Studio asks you whether you want to upgrade it to use the latest C++ compiler and libraries. Since you want the project to keep the older compiler and libraries, choose the **Cancel** button. @@ -44,23 +48,23 @@ First, in addition to the current version of Visual Studio, you must install Vis Next, you must update your Visual Studio 2008 solution and projects to the current version of Visual Studio. We recommend you create a backup of your projects and solution files before the upgrade. To start the upgrade process, open the solution in the current version of Visual Studio. When you get the upgrade prompt, review the information presented, and then choose **OK** to start the upgrade. If the solution has more than one project, you must update each project. The wizard creates new *`.vcxproj`* project files side-by-side with the existing *`.vcproj`* files. As long as you also have a copy of the original *`.sln`* file, the upgrade has no other effect on your existing Visual Studio 2008 projects. > [!NOTE] -> The following steps apply to multi-targeting scenarios only. If you intend to permanently upgrade the project to a later toolset, then your next step is to save the project, open it in the latest version of Visual Studio, and address the build issues that appear there. +> The following steps apply to multi-targeting scenarios only. If you intend to permanently upgrade the project to a later build tools version, then your next step is to save the project, open it in the latest version of Visual Studio, and address the build issues that appear there. When the upgrade completes, if the log report has errors or warnings for any of your projects, review them carefully. The conversion from **VCBuild** to **MSBuild** can cause issues. Make sure you understand and implement any action items listed in the report. For more information on the upgrade log report and issues that may occur when converting **VCBuild** to **MSBuild**, see the [C++ Native Multi-Targeting](https://devblogs.microsoft.com/cppblog/c-native-multi-targeting/) blog post. -When the upgrade is complete and you've fixed any issues in the log file, your solution now targets the latest toolset. As the final step, change the properties for each project in the solution to use the Visual Studio 2008 toolset. With the solution loaded in the current version of Visual Studio, for each project in the solution, open the Project **Property Pages** dialog box: Right-click on the project in **Solution Explorer** and then select **Properties**. In the **Property Pages** dialog box, change the **Configuration** drop-down value to **All Configurations**. In **Configuration Properties**, select **General**, and then change **Platform Toolset** to **Visual Studio 2008 (v90)**. +When the upgrade is complete and you've fixed any issues in the log file, your solution now targets the latest build tools. As the final step, change the properties for each project in the solution to use the Visual Studio 2008 build tools. With the solution loaded in the current version of Visual Studio, for each project in the solution, open the Project **Property Pages** dialog box: Right-click on the project in **Solution Explorer** and then select **Properties**. In the **Property Pages** dialog box, change the **Configuration** drop-down value to **All Configurations**. In **Configuration Properties**, select **General**, and then change **Platform Toolset** to **Visual Studio 2008 (v90)**. After this change, the Visual Studio 2008 compiler and libraries are used to generate project binaries when you build the solution in the current version of Visual Studio. -## Install an older Visual Studio toolset +## Install older Visual Studio build tools -You may have an old Visual Studio C++ project that you can't or don't want to upgrade. To build it, you need the platform toolset version that matches your project. To get the toolset, you can install the free Visual Studio Community or Express edition of the version you need. Every version of Visual Studio from Visual Studio 2008 on can install the compiler, tools, and libraries you need to target that version from the current Visual Studio. Search the Microsoft Download Center to find and download a particular version of Visual Studio. Make sure you choose the C++ installation options during setup. After setup completes, run that version of Visual Studio to install any updates. Also check for any Windows Update changes that might be required. This update check process may need to be repeated more than once to get every update. +You may have an old Visual Studio C++ project that you can't or don't want to upgrade. To build it, you need the build tools version that matches your project. To get the build tools, you can install the free Visual Studio Community or Express edition of the version you need. Every version of Visual Studio from Visual Studio 2008 on can install the compiler, libraries, and other build tools you need to target that version from the current Visual Studio. Search the Microsoft Download Center to find and download a particular version of Visual Studio. Make sure you choose the C++ installation options during setup. After setup completes, run that version of Visual Studio to install any updates. Also check for any Windows Update changes that might be required. This update check process may need to be repeated more than once to get every update. For the currently available downloads, see [Download older Visual Studio software](https://visualstudio.microsoft.com/vs/older-downloads/). -When these products are installed, the **Platform Toolset** property drop-down in the **Property Pages** dialog box is automatically updated to show the available toolsets. You can now use the latest version of Visual Studio to build projects that use an older version of the toolset: no conversion or upgrade required. +When these products are installed, the **MSVC Build Tools Version** property drop-down in the **Property Pages** dialog box is automatically updated to show the available build tools versions. In some cases, there may also be new choices for the **Platform Toolset** property. You can now use the latest version of Visual Studio to build projects that use an older version of the build tools: no conversion or upgrade required. ## See also -[Upgrading projects from earlier versions of Visual C++](upgrading-projects-from-earlier-versions-of-visual-cpp.md)\ +[Upgrading projects from earlier versions of Microsoft C++](upgrading-projects-from-earlier-versions-of-visual-cpp.md)\ [C++ conformance improvements in Visual Studio](../overview/cpp-conformance-improvements.md) diff --git a/docs/porting/visual-cpp-change-history-2003-2015.md b/docs/porting/visual-cpp-change-history-2003-2015.md index 6e2a59a9fa8..83f15d02849 100644 --- a/docs/porting/visual-cpp-change-history-2003-2015.md +++ b/docs/porting/visual-cpp-change-history-2003-2015.md @@ -1,7 +1,7 @@ --- title: "Microsoft C/C++ change history 2003 - 2015" description: "Find all the breaking changes in Microsoft C/C++ from Visual Studio 2003 through Visual Studio 2015 here." -ms.date: "5/25/2023" +ms.date: 5/25/2023 helpviewer_keywords: ["breaking changes [C++]"] --- # Microsoft C/C++ change history 2003 - 2015 @@ -404,7 +404,7 @@ When upgrading code from previous versions, you might also encounter compiler er In Visual Studio 2015, ongoing improvements to compiler conformance can sometimes change how the compiler understands your existing source code. As a result, you might encounter new or different errors during your build, or even behavioral differences in code that previously built and seemed to run correctly. -Fortunately, these differences have little or no impact on most of your source code. When source code or other changes are needed to address these differences, the fixes tend to be small and straight-forward. We've included many examples of previously acceptable source code that might need to be changed *(before)* and the fixes to correct them *(after)*. +Fortunately, these differences have little or no impact on most of your source code. When source code or other changes are needed to address these differences, the fixes tend to be small and straight-forward. We've included many examples of previously acceptable source code that might need to be changed *(before)* and the fixes to correct them *(after)*. Although these differences can affect your source code or other build artifacts, they don't affect binary compatibility between updates to Visual Studio versions. A *breaking change* is more severe, and can affect binary compatibility, but these kinds of binary compatibility breaks only occur between major versions of Visual Studio, for example, between Visual Studio 2013 and Visual Studio 2015. For information on the breaking changes that occurred between Visual Studio 2013 and Visual Studio 2015, see [Visual Studio 2015 Conformance Changes](#VC_2015). @@ -622,7 +622,7 @@ Although these differences can affect your source code or other build artifacts, - **Adjacent string literals** - Similarly to the previous, due to related changes in string parsing, adjacent string literals (either wide or narrow character string literals) without any whitespace were interpreted as a single concatenated string in previous releases of Visaul C++. In Visual Studio 2015, you must now add whitespace between the two strings. For example, the following code must be changed: + Similarly to the previous, due to related changes in string parsing, adjacent string literals (either wide or narrow character string literals) without any whitespace were interpreted as a single concatenated string in previous releases of Visual C++. In Visual Studio 2015, you must now add whitespace between the two strings. For example, the following code must be changed: ```cpp char * str = "abc""def"; @@ -1650,10 +1650,10 @@ Although these differences can affect your source code or other build artifacts, //b.cpp // compile with cl.exe /nologo /LD /EHsc /Osx b.cpp - #pragma comment(lib, "A") + #pragma comment(lib, "A") class __declspec(dllimport) A { - public: A(); + public: A(); A(const A&); virtual ~A(); private: @@ -1667,7 +1667,7 @@ Although these differences can affect your source code or other build artifacts, //c.cpp #pragma comment(lib, "A") - #pragma comment(lib, "B") + #pragma comment(lib, "B") class __declspec(dllimport) A { public: @@ -1974,7 +1974,7 @@ Although these differences can affect your source code or other build artifacts, case settings::bit0 | settings::bit1: // warning C4063 break; } - }; + } ``` Example of C4063 (after) @@ -3365,7 +3365,7 @@ The `SchedulerType` enumeration of `UmsThreadDefault` is deprecated. Specificati - The syntax for SAL Annotations has changed. For more information, see [SAL Annotations](../c-runtime-library/sal-annotations.md). -- The IEEE filter now supports the SSE 4.1 instruction set. For more information, see [_fpieee_flt](../c-runtime-library/reference/fpieee-flt.md)_fpieee_flt. +- The IEEE filter now supports the SSE 4.1 instruction set. For more information, see [`_fpieee_flt`](../c-runtime-library/reference/fpieee-flt.md). - The C Run-Time Libraries that ship with Visual Studio are no longer dependent on the system DLL msvcrt.dll. diff --git a/docs/porting/visual-cpp-porting-and-upgrading-guide.md b/docs/porting/visual-cpp-porting-and-upgrading-guide.md index a37ba527a58..64aa8a53e5e 100644 --- a/docs/porting/visual-cpp-porting-and-upgrading-guide.md +++ b/docs/porting/visual-cpp-porting-and-upgrading-guide.md @@ -1,60 +1,153 @@ --- title: "Microsoft C++ porting and upgrading guide" -description: "Upgrade Microsoft C++ code to the latest version of Visual Studio." -ms.date: 09/10/2020 -ms.assetid: f5fbcc3d-aa72-41a6-ad9a-a706af2166fb +description: "Your comprehensive hub for upgrading and modernizing Microsoft C++ code to the latest version of Visual Studio. Find tools, guides, success stories, and best practices." +ms.date: 11/06/2025 ms.topic: "overview" -ms.custom: intro-overview +ms.custom: intro-hub +author: tylermsft +ms.author: twhitney --- -# Microsoft C++ porting and upgrading guide - -This article provides a guide for upgrading Microsoft C++ code to the latest version of Visual Studio. For projects created in Visual Studio 2010 through 2017, just open the project in Visual Studio 2019. You can upgrade a Visual Studio 2008 or earlier project in two steps. Use Visual Studio 2010 to convert the project to MSBuild format first. Then open the project in Visual Studio 2019. For complete instructions, see [Upgrading C++ projects from earlier versions of Visual Studio](upgrading-projects-from-earlier-versions-of-visual-cpp.md). - -The toolsets in Visual Studio 2015, Visual Studio 2017, and Visual Studio 2019 are binary-compatible. Now you can upgrade to a more recent version of the compiler without having to upgrade your library dependencies. For more information, see [C++ binary compatibility between Visual Studio versions](binary-compat-2015-2017.md). - -When upgrading projects that use open-source libraries or are meant to run on multiple platforms, we recommended migrating to a CMake-based project. For more information, see [CMake projects in Visual Studio](../build/cmake-projects-in-visual-studio.md) - -## Reasons to upgrade C++ code - -If a legacy application is running satisfactorily, in a secure environment, and isn't under active development, there might not be much incentive to upgrade it. However, consider an upgrade in these cases: Your application requires ongoing maintenance. Or, you're doing new feature development, or making performance or security improvements. An upgrade brings these benefits: - -- The same code can run faster, because we've improved compiler optimizations. - -- Modern C++ features and programming practices eliminate many common causes of bugs, and produce code that's far easier to maintain than older C-style idioms. - -- Build times are faster, because of performance improvements in the compiler and linker. -- Better standards conformance. The [/permissive-](../build/reference/permissive-standards-conformance.md) compiler option helps you identify code that doesn't conform to the current C++ standard. The [new preprocessor](../preprocessor/preprocessor-experimental-overview.md) supports code conformance, too. - -- Better run-time security, including more secure [C Runtime library](../c-runtime-library/security-features-in-the-crt.md) features. And, compiler features such as [guard checking](../build/reference/guard-enable-guard-checks.md) and address sanitizers (new in Visual Studio 2019 version 16.4). - -## Multitargeting vs. upgrading - -Perhaps upgrading your code base to a new toolset isn't an option for you. You can still use the latest Visual Studio to build and edit projects that use older toolsets and libraries. In Visual Studio 2019, you can take advantage of features such as: - -- modern static analysis tools, including the C++ Core Guidelines checkers and Clang-Tidy, to help identify potential problems in your source code. - -- automatic formatting according to your choice of modern styles can help make legacy code much more readable. - -For more information, see [Use native multi-targeting in Visual Studio to build old projects](use-native-multi-targeting.md). - -## In this section +# Microsoft C++ porting and upgrading guide -| Title | Description | -|--|--| -| [Upgrading C++ projects from earlier versions of Visual Studio](upgrading-projects-from-earlier-versions-of-visual-cpp.md) | How to upgrade your code base to the latest version of Visual Studio and the compiler. | -| [IDE tools for upgrading C++ code](ide-tools-for-upgrading-code.md) | Useful IDE features that help in the upgrade process. | -| [C++ binary compatibility between Visual Studio versions](binary-compat-2015-2017.md) | Consume v140 and later libraries as-is from v140 and later projects. | -| [Use native multi-targeting in Visual Studio to build old projects](use-native-multi-targeting.md) | Use Visual Studio with older compilers and libraries. | -| [Visual C++ change history 2003 - 2015](visual-cpp-change-history-2003-2015.md) | A list of all the changes in the Microsoft C++ libraries and build tools from Visual Studio 2003 through 2015 that might require changes in your code. | -| [Visual C++ What's New 2003 through 2015](visual-cpp-what-s-new-2003-through-2015.md) | All the "what's new" information for Microsoft C++ from Visual Studio 2003 through Visual Studio 2015. | -| [Porting and Upgrading: Examples and Case Studies](porting-and-upgrading-examples-and-case-studies.md) | For this section, we ported and upgrades several samples and applications and discussed the experiences and results. These articles give you a sense of what's involved in the porting and upgrading process. Throughout the process, we discuss tips and tricks for upgrading and show how specific errors were fixed. | -| [Porting to the Universal Windows Platform](porting-to-the-universal-windows-platform-cpp.md) | Contains information about porting app code to Windows 10 and later | -| [Introduction to Visual C++ for UNIX Users](introduction-to-visual-cpp-for-unix-users.md) | Provides information for UNIX users who are new to Visual C++ and want to become productive with it. | -| [Running Linux programs on Windows](porting-from-unix-to-win32.md) | Discusses options for migrating UNIX applications to Windows. | +**Transform your legacy C++ applications with confidence.** Whether you're upgrading from Visual Studio 2008 or modernizing to take advantage of the latest C++ features, this comprehensive guide provides everything you need for a successful upgrade journey. + +:::row::: +:::column span=""::: +:::column-end::: +:::column span="2"::: +![C++ logo with an upward arrow and abstract code on a blue background suggesting improvements from upgrading.](media/upgrade-cpp.png) +:::column-end::: +:::column span=""::: +:::column-end::: +:::row-end::: + +:::row::: +:::column span="2"::: +## 🚀 Quick start + +**Most projects upgrade seamlessly:** For projects created in Visual Studio 2010-2017, simply open them in the latest Visual Studio. For Visual Studio 2008 or earlier projects, use our [two-step upgrade process](upgrading-projects-from-earlier-versions-of-visual-cpp.md). + +**Binary compatibility:** Visual Studio 2015, 2017, 2019, 2022, and 2026 build tools are binary-compatible, so you can upgrade without rebuilding library dependencies. [Learn more](binary-compat-2015-2017.md). + +**CMake projects:** For projects using open-source libraries or targeting multiple platforms, consider migrating to CMake. [Learn more](../build/cmake-projects-in-visual-studio.md). +:::column-end::: +:::column span="2"::: +## 💡 Why upgrade? + +- **🏃‍♂️ Better Performance:** Faster execution and build times +- **🔒 Enhanced Security:** Address sanitizers and security features +- **📐 Standards Compliance:** Modern C++ features and conformance +- **🛠️ Better Tools:** Advanced debugging and analysis capabilities +:::column-end::: +:::row-end::: + +## 🎯 Choose your upgrade path + +:::row::: +:::column::: +### 📋 Assess & plan +**Evaluate your current codebase and plan your strategy** + +- [🔍 Overview of potential upgrade issues](overview-of-potential-upgrade-issues-visual-cpp.md) +- [🔗 C++ binary compatibility between versions](binary-compat-2015-2017.md) +- [📜 Visual C++ change history 2003-2015](visual-cpp-change-history-2003-2015.md) +- [⚠️ Features deprecated in Visual Studio](features-deprecated-in-visual-studio.md) +- [🎯 Use native multi-targeting for old projects](use-native-multi-targeting.md) +:::column-end::: +:::column::: +### 🔧 Upgrade & modernize +**Step-by-step guides and tools for upgrading** + +- [⬆️ Upgrading C++ Projects to Visual Studio 2026](https://devblogs.microsoft.com/cppblog/upgrading-c-projects-to-visual-studio-2026/) +- [⬆️ Upgrade projects from earlier versions](upgrading-projects-from-earlier-versions-of-visual-cpp.md) +- [🤖 Upgrade with an AI agent (preview)](copilot-app-modernization-cpp.md) +- [🛠️ IDE tools for upgrading C++ code](ide-tools-for-upgrading-code.md) +- [🔄 Upgrade to Universal CRT](upgrade-your-code-to-the-universal-crt.md) +- [🔧 Update WINVER and _WIN32_WINNT](modifying-winver-and-win32-winnt.md) +- [🔗 Fix dependencies on library internals](fix-your-dependencies-on-library-internals.md) +- [📊 Floating-point migration issues](floating-point-migration-issues.md) +:::column-end::: +:::row-end::: + +:::row::: +:::column::: +### 🌐 Platform migration +**Move your applications to modern platforms** + +- [📱 Port to Universal Windows Platform](porting-to-the-universal-windows-platform-cpp.md) +- [🔗 Use existing C++ code in UWP apps](how-to-use-existing-cpp-code-in-a-universal-windows-platform-app.md) +- [🐧 Visual C++ for UNIX users](introduction-to-visual-cpp-for-unix-users.md) +- [🪟 Running Linux programs on Windows](porting-from-unix-to-win32.md) +- [📦 Port third-party libraries](porting-third-party-libraries.md) +:::column-end::: +:::column::: +### ✨ Success stories & examples +**Learn from real-world upgrade experiences** + +- [📖 Examples and case studies overview](porting-and-upgrading-examples-and-case-studies.md) +- [📝 Case study: MFC Scribble upgrade](porting-guide-mfc-scribble.md) +- [🕵️ Case study: COM Spy upgrade](porting-guide-com-spy.md) +- [🔍 Case study: Spy++ upgrade](porting-guide-spy-increment.md) +- [🏗️ VCBuild vs. MSBuild migration](build-system-changes.md) +:::column-end::: +:::row-end::: + +[📚 Read more case studies](porting-and-upgrading-examples-and-case-studies.md) + +## 🛠️ Upgrade benefits + +:::row::: +:::column span="2"::: +### Performance & optimization +- **Faster execution** with improved compiler optimizations +- **Reduced build times** through compiler and linker improvements +- **Better memory usage** with modern runtime optimizations +:::column-end::: +:::column span="2"::: +### Security & reliability +- **Enhanced security** with address sanitizers and [guard checking](../build/reference/guard-enable-guard-checks.md) +- **Secure runtime libraries** with improved [CRT security features](../c-runtime-library/security-features-in-the-crt.md)) +- **Better error detection** with static analysis tools +:::column-end::: +:::row-end::: + +:::row::: +:::column span="2"::: +### Developer experience +- **Modern IDE features** with IntelliSense improvements +- **Advanced debugging** with better visualizers and diagnostics +- **Code analysis** with Core Guidelines checkers and Clang-Tidy +:::column-end::: +:::column span="2"::: +### Standards & compatibility +- **Better C++ standards conformance** with [`/permissive-`](../build/reference/permissive-standards-conformance.md) mode +- **Modern preprocessor** for improved code conformance. [Learn more](../preprocessor/preprocessor-experimental-overview.md) +- **Cross-platform support** with CMake integration +:::column-end::: +:::row-end::: + +## 🤔 Multitargeting vs. upgrading + +**Not ready for a full upgrade?** You can still use the latest Visual Studio with older build tools and libraries: + +- ✅ **Modern static analysis tools** including C++ Core Guidelines checkers and Clang-Tidy +- ✅ **Automatic code formatting** to improve legacy code readability +- ✅ **Latest IDE features** while maintaining compatibility + +[Learn about native multi-targeting →](use-native-multi-targeting.md) + +## 🚀 Ready to start? + +1. **📊 Assess your current project** with our [upgrade issues overview](overview-of-potential-upgrade-issues-visual-cpp.md) +2. **🔄 Follow our step-by-step guide** to [upgrade from earlier versions](upgrading-projects-from-earlier-versions-of-visual-cpp.md) +3. **🛠️ Use our IDE tools** to [streamline the upgrade process](ide-tools-for-upgrading-code.md) +4. **📖 Learn from others** with our [real-world case studies](porting-and-upgrading-examples-and-case-studies.md) + +**Questions?** Join the conversation in [Microsoft Learn Q&A](/answers/topics/c%2B%2B.html) or check out the [C++ Team Blog](https://devblogs.microsoft.com/cppblog/) for the latest updates. ## See also -[C++ in Visual Studio](../overview/visual-cpp-in-visual-studio.md)
-[What's New for The C++ compiler in Visual Studio](../overview/what-s-new-for-visual-cpp-in-visual-studio.md)
-[C++ conformance improvements in Visual Studio](../overview/cpp-conformance-improvements.md)
+[C++ in Visual Studio](../overview/visual-cpp-in-visual-studio.md)\ +[What's new for the C++ compiler in Visual Studio](../overview/what-s-new-for-visual-cpp-in-visual-studio.md)\ +[C++ conformance improvements in Visual Studio](../overview/cpp-conformance-improvements.md) \ No newline at end of file diff --git a/docs/porting/visual-cpp-what-s-new-2003-through-2015.md b/docs/porting/visual-cpp-what-s-new-2003-through-2015.md index e1f77ffdffd..039c2b627c3 100644 --- a/docs/porting/visual-cpp-what-s-new-2003-through-2015.md +++ b/docs/porting/visual-cpp-what-s-new-2003-through-2015.md @@ -1,8 +1,8 @@ --- -description: "Learn more about: Visual C++ What's New 2003 through 2015" title: "Visual C++ What's New 2003 through 2015" -ms.date: "07/02/2019" -ms.assetid: c4afde6f-3d75-40bf-986f-be57e3818e26 +description: "Learn more about: Visual C++ What's New 2003 through 2015" +ms.date: 07/02/2019 +ms.topic: whats-new --- # Visual C++ What's New 2003 through 2015 @@ -15,7 +15,7 @@ This page gathers all the "What's New" pages for all versions of Visual C++ from In Visual Studio 2015 and later, ongoing improvements to compiler conformance can sometimes change how the compiler understands your existing source code. When this happens, you might encounter new or different errors during your build, or even behavioral differences in code that previously built and seemed to run correctly. -Fortunately, these differences have little or no impact on most of your source code and when source code or other changes are needed to address these differences, fixes are usually small and straight-forward. We've included many examples of previously-acceptable source code that might need to be changed *(before)* and the fixes to correct them *(after)*. +Fortunately, these differences have little or no impact on most of your source code and when source code or other changes are needed to address these differences, fixes are usually small and straight-forward. We've included many examples of previously-acceptable source code that might need to be changed *(before)* and the fixes to correct them *(after)*. Although these differences can affect your source code or other build artifacts, they don't affect binary compatibility between updates to Visual C++ versions. A more-severe kind of change, the *breaking change* can affect binary compatibility, but these kinds of binary compatibility breaks only occur between major versions of Visual C++. For example, between Visual C++ 2013 and Visual C++ 2015. For information on the breaking changes that occurred between Visual C++ 2013 and Visual C++ 2015, see [Visual C++ change history 2003 - 2015](../porting/visual-cpp-change-history-2003-2015.md). @@ -227,14 +227,13 @@ Although these differences can affect your source code or other build artifacts, ```cpp error C3688: invalid literal suffix '_x'; literal operator or literal operator template 'operator ""_x' not found note: Did you forget a space between the string literal and the prefix of the following string literal? - ``` To fix this problem, add a space between the string literal and the macro. - **Adjacent string literals** - Similarly to the previous, due to related changes in string parsing, adjacent string literals (either wide or narrow character string literals) without any whitespace were interpreted as a single concatenated string in previous releases of Visaul C++. In Visual Studio 2015, you must now add whitespace between the two strings. For example, the following code must be changed: + Similarly to the previous, due to related changes in string parsing, adjacent string literals (either wide or narrow character string literals) without any whitespace were interpreted as a single concatenated string in previous releases of Visual C++. In Visual Studio 2015, you must now add whitespace between the two strings. For example, the following code must be changed: ```cpp char * str = "abc""def"; @@ -785,7 +784,7 @@ Although these differences can affect your source code or other build artifacts, case settings::bit0 | settings::bit1: // warning C4063 break; } - }; + } ``` Example of C4063 (after) @@ -2206,7 +2205,7 @@ The compiler has breaking changes in this release. - In each function topic, a section on .NET Framework equivalents has been added. - Several string functions now have the option of truncating strings rather than failing when output buffers are too small; see **_TRUNCATE**. - `_set_se_translator` now requires the use of the `/EHa` compiler option. -- `fpos_t` is now **`__int64`** under `/Za` (for C code) and when __STDC__ is set manually (for C++ code). It used to be a **`struct`**. +- `fpos_t` is now **`__int64`** under `/Za` (for C code) and when `__STDC__` is set manually (for C++ code). It used to be a **`struct`**. - _CRT_DISABLE_PERFCRIT_LOCKS can improve the I/O performance of single-threaded programs. - POSIX names have been deprecated in favor of ISO C++ conformant names (for example, use `_getch` rather than `getch`). - New link options .obj files are available for pure mode diff --git a/docs/preprocessor/check-stack.md b/docs/preprocessor/check-stack.md index 33cf7b507fd..546130842ed 100644 --- a/docs/preprocessor/check-stack.md +++ b/docs/preprocessor/check-stack.md @@ -1,9 +1,9 @@ --- description: "Learn more about the check_stack pragma directive in Microsoft C/C++" title: "check_stack pragma" -ms.date: 01/22/2021 +ms.date: 2/7/2025 f1_keywords: ["vc-pragma.check_stack", "check_stack_CPP"] -helpviewer_keywords: ["check_stack pragma", "pragma, check_stack", "pragma, check_stack usage table"] +helpviewer_keywords: ["check_stack pragma", "pragma, check_stack"] no-loc: ["pragma"] --- # `check_stack` pragma @@ -12,24 +12,24 @@ Instructs the compiler to turn off stack probes if **`off`** (or **`-`**) is spe ## Syntax -> **`#pragma check_stack(`** [{ **`on`** | **`off`** }] **`)`**\ +> **`#pragma check_stack(`** { **`on`** | **`off`** } **`)`**\ > **`#pragma check_stack`** { **`+`** | **`-`** } ## Remarks -This pragma takes effect at the first function defined after the pragma is seen. Stack probes are neither a part of macros nor of functions that are generated inline. +This pragma only applies to 32-bit platforms (x86, ARM32). It has no effect on 64-bit platforms. -If you don't give an argument for the **`check_stack`** pragma, stack checking reverts to the behavior specified on the command line. For more information, see [Compiler options](../build/reference/compiler-options.md). The interaction of the `#pragma check_stack` and the [`/Gs`](../build/reference/gs-control-stack-checking-calls.md) option is summarized in the following table. +This pragma takes effect at the first function defined after the pragma is seen. Stack probes are not inserted for macros or functions that are generated inline. -### Using the check_stack Pragma +`#pragma check_stack(off)` / `#pragma Check_stack-` is ignored if the size of the function locals is larger than 4096 or the value specified by `/Gs`. -| Syntax | Compiled with

`/Gs` option? | Action | -|--|--|--| -| `#pragma check_stack( )` or

`#pragma check_stack` | Yes | Turns off stack checking for functions that follow | -| `#pragma check_stack( )` or

`#pragma check_stack` | No | Turns on stack checking for functions that follow | -| `#pragma check_stack(on)`

or `#pragma check_stack +` | Yes or No | Turns on stack checking for functions that follow | -| `#pragma check_stack(off)`

or `#pragma check_stack -` | Yes or No | Turns off stack checking for functions that follow | +The default behavior of the compiler is to insert stack probes at the beginning of each function if the size of the locals exceeds 4096 or the value specified by `/Gs`. + +Use [/Gs (Control stack checking calls)](../build/reference/gs-control-stack-checking-calls.md) to change the threshold of the locals that trigger stack probes. Use with caution. + +Using `#pragma check_stack()` without arguments is deprecated. ## See also +[Compiler options](../build/reference/compiler-options.md)\ [Pragma directives and the `__pragma` and `_Pragma` keywords](./pragma-directives-and-the-pragma-keyword.md) diff --git a/docs/preprocessor/compiler-warnings-that-are-off-by-default.md b/docs/preprocessor/compiler-warnings-that-are-off-by-default.md index da2758a0ba1..04ffb783279 100644 --- a/docs/preprocessor/compiler-warnings-that-are-off-by-default.md +++ b/docs/preprocessor/compiler-warnings-that-are-off-by-default.md @@ -1,6 +1,6 @@ --- -description: "Learn more about: Compiler warnings that are off by default" title: "Compiler warnings that are off by default" +description: "Learn more about: Compiler warnings that are off by default" ms.date: 01/18/2024 helpviewer_keywords: ["warnings, compiler", "cl.exe compiler, setting options"] --- @@ -158,7 +158,7 @@ The following warnings are turned off by default in Visual Studio 2019 and later | Warning | Message | |--|--| -| C5052 (level 3) | Keyword '*keyword-name*' was introduced in C++ *version* and requires use of the '*option*' command-line option` 16.1 | +| C5052 (level 3) | Keyword '*keyword-name*' was introduced in C++ *version* and requires use of the '*option*' command-line option 16.1 | | C5204 (level 3) | A class with virtual functions has non-virtual trivial destructor. 16.5 | | C5214 (level 4) | applying '*keyword*' to an operand with a volatile qualified type is deprecated in C++20 16.7 | | C5215 (level 4) | '*function-parameter*' a function parameter with a volatile qualified type is deprecated in C++20 16.7 | @@ -168,7 +168,7 @@ The following warnings are turned off by default in Visual Studio 2019 and later | C5220 (level 4) | '*member*': a non-static data member with a volatile qualified type no longer implies that
compiler generated copy/move constructors and copy/move assignment operators are not trivial 16.7 | | C5233 (level 4) | explicit lambda capture '*identifier*' is not used 16.10 | | [C5240 (level 4)](../error-messages/compiler-warnings/c5240.md) | '*attribute-name*': attribute is ignored in this syntactic position 16.10 | -| [C5243 (level 1)](../error-messages/compiler-warnings/c5247.md) | '*type-name*': using incomplete class '*class-name*' can cause potential one definition rule violation due to ABI limitation 16.10 | +| [C5243 (level 1)](../error-messages/compiler-warnings/c5243.md) | '*type-name*': using incomplete class '*class-name*' can cause potential one definition rule violation due to ABI limitation 16.10 | | C5245 (level 4) | '*function*': unreferenced function with internal linkage has been removed | | C5246 (level 1) | '*member*': the initialization of a subobject should be wrapped in braces 16.10 | | [C5247 (level 1)](../error-messages/compiler-warnings/c5247.md) | Section '*section-name*' is reserved for C++ dynamic initialization. Manually creating the section will interfere with C++ dynamic initialization and may lead to undefined behavior 16.11 | diff --git a/docs/preprocessor/hash-error-directive-c-cpp.md b/docs/preprocessor/hash-error-directive-c-cpp.md index 2a5ec7bfe95..f98fd41b1fd 100644 --- a/docs/preprocessor/hash-error-directive-c-cpp.md +++ b/docs/preprocessor/hash-error-directive-c-cpp.md @@ -4,11 +4,10 @@ title: "#error directive (C/C++)" ms.date: "08/29/2019" f1_keywords: ["#error"] helpviewer_keywords: ["#error directive", "preprocessor, directives", "error directive (#error directive)"] -ms.assetid: d550a802-ff19-4347-9597-688935d23b2b --- # #error directive (C/C++) -The **#error** directive emits a user-specified error message at compile time, and then terminates the compilation. +The `#error` directive emits a user-specified error message at compile time. Then it terminates the compilation. ## Syntax @@ -26,4 +25,5 @@ The error message that this directive emits includes the *token-string* paramete ## See also -[Preprocessor directives](../preprocessor/preprocessor-directives.md) +[Preprocessor directives](../preprocessor/preprocessor-directives.md)\ +[#warning directive](../preprocessor/hash-warning-directive-c-cpp.md) diff --git a/docs/preprocessor/hash-import-directive-cpp.md b/docs/preprocessor/hash-import-directive-cpp.md index 82e80881160..83b1bc8afb5 100644 --- a/docs/preprocessor/hash-import-directive-cpp.md +++ b/docs/preprocessor/hash-import-directive-cpp.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: #import directive (C++)" title: "#import directive (C++)" +description: "Learn more about: #import directive (C++)" ms.date: "08/29/2019" f1_keywords: ["#import"] helpviewer_keywords: [".tlh files", "#import directive", "import directive (#import)", "tlh files", "tlbid switch", "preprocessor, directives", "COM, type library header file"] -ms.assetid: 787d1112-e543-40d7-ab15-a63d43f4030a --- # #import directive (C++) @@ -130,7 +129,7 @@ The primary type library header file consists of seven sections: Type `IMyInterfacePtr` can then be used in place of the raw interface pointer `IMyInterface*`. Consequently, there's no need to call the various `IUnknown` member functions -- Typeinfo declarations: Primarily consists of class definitions and other items exposing the individual typeinfo items returned by `ITypeLib:GetTypeInfo`. In this section, each typeinfo from the type library is reflected in the header in a form dependent on the `TYPEKIND` information. +- Typeinfo declarations: Primarily consists of class definitions and other items exposing the individual typeinfo items returned by `ITypeLib::GetTypeInfo`. In this section, each typeinfo from the type library is reflected in the header in a form dependent on the `TYPEKIND` information. - Optional old-style GUID definition: Contains initializations of the named GUID constants. These names have the form `CLSID_CoClass` and `IID_Interface`, similar to the ones generated by the MIDL compiler. diff --git a/docs/preprocessor/hash-warning-directive-c-cpp.md b/docs/preprocessor/hash-warning-directive-c-cpp.md new file mode 100644 index 00000000000..83c36ab7418 --- /dev/null +++ b/docs/preprocessor/hash-warning-directive-c-cpp.md @@ -0,0 +1,33 @@ +--- +description: "Learn more about: #warning directive (C/C++)" +title: "#warning directive (C/C++)" +ms.date: 10/15/2025 +f1_keywords: ["#warning"] +helpviewer_keywords: ["#warning directive", "preprocessor, directives", "warning directive (#warning directive)"] +--- +# #warning directive (C/C++) + +The **#warning** directive emits a user-specified warning message at compile time. It doesn't stop compilation. This directive is available starting in C23 and C++23. + +## Syntax + +> **#warning** *token-string* + +## Remarks + +The warning message is the *token-string* parameter. The *token-string* parameter isn't subject to macro expansion and can be optionally enclosed in quotes. + +Use this directive to inform the developer of a nonfatal issue or to communicate other important information during compilation. + +The following example shows how to use the **#warning** directive: + +```cpp +#if defined(_LEGACY_FEATURE_FLAG) +#warning "_LEGACY_FEATURE is deprecated and should not be used." +#endif +``` + +## See also + +[Preprocessor directives](../preprocessor/preprocessor-directives.md)\ +[#error directive](../preprocessor/hash-error-directive-c-cpp.md) \ No newline at end of file diff --git a/docs/preprocessor/optimize.md b/docs/preprocessor/optimize.md index ddcd04b8333..f8dd4c96252 100644 --- a/docs/preprocessor/optimize.md +++ b/docs/preprocessor/optimize.md @@ -1,7 +1,7 @@ --- description: "Learn more about: optimize pragma" title: "optimize pragma" -ms.date: 01/22/2021 +ms.date: 07/25/2025 f1_keywords: ["vc-pragma.optimize", "optimize_CPP"] helpviewer_keywords: ["pragma, optimize", "optimize pragma"] no-loc: ["pragma"] @@ -25,8 +25,8 @@ The *optimization-list* can be zero or more of the parameters shown in the follo | Parameter(s) | Type of optimization | |--------------------|--------------------------| | **`g`** | Enable global optimizations. Deprecated. For more information, see [`/Og` (Global optimizations)](../build/reference/og-global-optimizations.md). | -| **`s`** or **`t`** | Specify short or fast sequences of machine code. | -| **`y`** | Generate frame pointers on the program stack. | +| **`s`** or **`t`** | Favor short or fast sequences of machine code. | +| **`y`** | Omit frame pointers on the program stack. | These parameters are the same letters used with the [`/O`](../build/reference/o-options-optimize-code.md) compiler options. For example, the following pragma is equivalent to the **`/Os`** compiler option: diff --git a/docs/preprocessor/pack.md b/docs/preprocessor/pack.md index 6c153a81912..9941cdcd092 100644 --- a/docs/preprocessor/pack.md +++ b/docs/preprocessor/pack.md @@ -1,6 +1,6 @@ --- -description: "Learn more about the pack pragma directive in Microsoft C/C++" title: "pack pragma" +description: "Learn more about the pack pragma directive in Microsoft C/C++" ms.date: 01/22/2021 f1_keywords: ["pack_CPP", "vc-pragma.pack"] helpviewer_keywords: ["pragma, pack", "pack pragma"] @@ -107,7 +107,7 @@ The following sample shows how to use the *push*, *pop*, and *show* syntax. // pop to the identifier and then set // the value of the current packing alignment: -#pragma pack(pop, r1, 2) // n = 2 , stack popped +#pragma pack(pop, r1, 2) // n = 2, stack popped #pragma pack(show) // C4810 ``` diff --git a/docs/preprocessor/predefined-macros.md b/docs/preprocessor/predefined-macros.md index 40cceea5151..f76713d42fa 100644 --- a/docs/preprocessor/predefined-macros.md +++ b/docs/preprocessor/predefined-macros.md @@ -2,7 +2,7 @@ title: "Predefined macros" description: "Lists and describes the Microsoft C++ compiler predefined preprocessor macros." ms.custom: "update_every_version" -ms.date: 06/11/2024 +ms.date: 06/18/2025 f1_keywords: ["__ARM_ARCH", "_ATL_VER", "__ATOM__", "__AVX__", "__AVX2__", "__AVX512BW__", "__AVX512CD__", "__AVX512DQ__", "__AVX512F__", "__AVX512VL__", "_CHAR_UNSIGNED", "__CLR_VER", "_CONTROL_FLOW_GUARD", "__COUNTER__", "__cplusplus", "__cplusplus_cli", "__cplusplus_winrt", "_CPPRTTI", "_CPPUNWIND", "__DATE__", "_DEBUG", "_DLL", "__FILE__", "__FUNCDNAME__", "__FUNCSIG__", "__FUNCTION__", "_INTEGRAL_MAX_BITS", "_ISO_VOLATILE", "_KERNEL_MODE", "__LINE__", "_M_AMD64", "_M_ARM", "_M_ARM_ARMV7VE", "_M_ARM_FP", "_M_ARM64", "_M_CEE", "_M_CEE_PURE", "_M_CEE_SAFE", "_M_FP_EXCEPT", "_M_FP_FAST", "_M_FP_PRECISE", "_M_FP_STRICT", "_M_IX86", "_M_IX86_FP", "_M_X64", "_MANAGED", "_MFC_VER", "_MSC_BUILD", "_MSC_EXTENSIONS", "_MSC_FULL_VER", "_MSC_VER", "_MSVC_LANG", "__MSVC_RUNTIME_CHECKS", "_MT", "_NATIVE_WCHAR_T_DEFINED", "_NO_SIZED_DEALLOCATION", "_OPENMP", "_PREFAST_", "_RESUMABLE_FUNCTIONS_SUPPORTED", "_RTC_CONVERSION_CHECKS_ENABLED", "__SANITIZE_ADDRESS__", "__STDC__", "__STDC_HOSTED__", "__STDC_NO_ATOMICS__", "__STDC_NO_COMPLEX__", "__STDC_NO_THREADS__", "__STDC_NO_VLA__", "__STDC_VERSION__", "__STDCPP_DEFAULT_NEW_ALIGNMENT__", "__STDCPP_THREADS__", "__TIME__", "__TIMESTAMP__", "__VA_ARGS__", "_VC_NODEFAULTLIB", "_WCHAR_T_DEFINED", "_WIN32", "_WIN64", "_WINRT_DLL"] helpviewer_keywords: ["__ARM_ARCH macro", "timestamps, preprocessor macro", "cl.exe compiler, version number", "version numbers, C/C++ compiler (cl.exe)", "macros, predefined C++", "preprocessor, macros", "predefined macros", "_ATL_VER macro", "__ATOM__ macro", "__AVX__ macro", "__AVX2__ macro", "__AVX512BW__ macro", "__AVX512CD__ macro", "__AVX512DQ__ macro", "__AVX512F__ macro", "__AVX512VL__ macro", "_CHAR_UNSIGNED macro", "__CLR_VER macro", "_CONTROL_FLOW_GUARD macro", "__COUNTER__ macro", "__cplusplus macro", "__cplusplus_cli macro", "__cplusplus_winrt macro", "_CPPRTTI macro", "_CPPUNWIND macro", "__DATE__ macro", "_DEBUG macro", "_DLL macro", "__FILE__ macro", "__FUNCDNAME__ macro", "__FUNCSIG__ macro", "__FUNCTION__ macro", "_INTEGRAL_MAX_BITS macro", "_ISO_VOLATILE macro", "_KERNEL_MODE macro", "__LINE__ macro", "_M_AMD64 macro", "_M_ARM macro", "_M_ARM_ARMV7VE macro", "_M_ARM_FP macro", "_M_ARM64 macro", "_M_ARM64EC macro", "_M_CEE macro", "_M_CEE_PURE macro", "_M_CEE_SAFE macro", "_M_FP_EXCEPT macro", "_M_FP_FAST macro", "_M_FP_PRECISE macro", "_M_FP_STRICT macro", "_M_IX86 macro", "_M_IX86_FP macro", "_M_X64 macro", "_MANAGED macro", "_MFC_VER macro", "_MSC_BUILD macro", "_MSC_EXTENSIONS macro", "_MSC_FULL_VER macro", "_MSC_VER macro", "_MSVC_LANG macro", "__MSVC_RUNTIME_CHECKS macro", "_MT macro", "_NATIVE_WCHAR_T_DEFINED macro", "_NO_SIZED_DEALLOCATION macro", "_OPENMP macro", "_PREFAST_ macro", "_RESUMABLE_FUNCTIONS_SUPPORTED macro", "_RTC_CONVERSION_CHECKS_ENABLED macro", "__SANITIZE_ADDRESS__ macro", "__STDC__ macro", "__STDC_HOSTED__ macro", "__STDC_NO_ATOMICS__ macro", "__STDC_NO_COMPLEX__ macro", "__STDC_NO_THREADS__ macro", "__STDC_NO_VLA__ macro", "__STDC_VERSION__ macro", "__STDCPP_DEFAULT_NEW_ALIGNMENT__", "__STDCPP_THREADS__ macro", "__TIME__ macro", "__TIMESTAMP__ macro", "__VA_ARGS__ macro", "_VC_NODEFAULTLIB macro", "_WCHAR_T_DEFINED macro", "_WIN32 macro", "_WIN64 macro", "_WINRT_DLL macro", "__func__ identifier"] ms.assetid: 1cc5f70a-a225-469c-aed0-fe766238e23f @@ -41,7 +41,7 @@ The compiler supports these predefined macros specified by the ISO C99, C11, C17 - `__LINE__` Defined as the integer line number in the current source file. The value of this macro can be changed by using a `#line` directive. The integral type of the value of `__LINE__` can vary depending on context. This macro is always defined. -- `__STDC__` Defined as 1 when compiled as C and if the [`/Za`](../build/reference/za-ze-disable-language-extensions.md) compiler option is specified. Starting in Visual Studio 2022 version 17.2, it's defined as 1 when compiled as C and if the [`/std:c11`](../build/reference/std-specify-language-standard-version.md) or [`/std:c17`](../build/reference/std-specify-language-standard-version.md) compiler option is specified. Otherwise, undefined. +- `__STDC__` Defined as 1 when compiled as C and if the [`/Za`](../build/reference/za-ze-disable-language-extensions.md) compiler option is specified. Starting in Visual Studio 2022 version 17.2, it's defined as 1 when compiled as C and if the [`/Zc:__STDC__`](../build/reference/zc-stdc.md) compiler option is specified. Otherwise, undefined. - `__STDC_HOSTED__` Defined as 1 if the implementation is a *hosted implementation*, one that supports the entire required standard library. Otherwise, defined as 0. @@ -69,21 +69,21 @@ MSVC supports other predefined macros: - `__ATOM__` Defined as 1 when the [`/favor:ATOM`](../build/reference/favor-optimize-for-architecture-specifics.md) compiler option is set and the compiler target is x86 or x64. Otherwise, undefined. -- `__AVX__` Defined as 1 when the [`/arch:AVX`](../build/reference/arch-x86.md), [`/arch:AVX2`](../build/reference/arch-x86.md), [`/arch:AVX512`](../build/reference/arch-x86.md) or [`/arch:AVX10.1`](../build/reference/arch-x86.md) compiler options are set and the compiler target is x86 or x64. Otherwise, undefined. +- `__AVX__` Defined as 1 when the [`/arch:AVX`](../build/reference/arch-x86.md), [`/arch:AVX2`](../build/reference/arch-x86.md), [`/arch:AVX512`](../build/reference/arch-x86.md), [`/arch:AVX10.1`](../build/reference/arch-x86.md), or [`/arch:AVX10.2`](../build/reference/arch-x86.md) compiler options are set and the compiler target is x86 or x64. Otherwise, undefined. -- `__AVX2__` Defined as 1 when the [`/arch:AVX2`](../build/reference/arch-x86.md), [`/arch:AVX512`](../build/reference/arch-x86.md) or [`/arch:AVX10.1`](../build/reference/arch-x86.md) compiler option is set and the compiler target is x86 or x64. Otherwise, undefined. +- `__AVX2__` Defined as 1 when the [`/arch:AVX2`](../build/reference/arch-x86.md), [`/arch:AVX512`](../build/reference/arch-x86.md), [`/arch:AVX10.1`](../build/reference/arch-x86.md), or [`/arch:AVX10.2`](../build/reference/arch-x86.md) compiler option is set and the compiler target is x86 or x64. Otherwise, undefined. -- `__AVX512BW__` Defined as 1 when the [`/arch:AVX512`](../build/reference/arch-x86.md) or [`/arch:AVX10.1`](../build/reference/arch-x86.md) compiler option is set and the compiler target is x86 or x64. Otherwise, undefined. +- `__AVX512BW__` Defined as 1 when the [`/arch:AVX512`](../build/reference/arch-x86.md), [`/arch:AVX10.1`](../build/reference/arch-x86.md), or [`/arch:AVX10.2`](../build/reference/arch-x86.md) compiler option is set and the compiler target is x86 or x64. Otherwise, undefined. -- `__AVX512CD__` Defined as 1 when the [`/arch:AVX512`](../build/reference/arch-x86.md) or [`/arch:AVX10.1`](../build/reference/arch-x86.md) compiler option is set and the compiler target is x86 or x64. Otherwise, undefined. +- `__AVX512CD__` Defined as 1 when the [`/arch:AVX512`](../build/reference/arch-x86.md), [`/arch:AVX10.1`](../build/reference/arch-x86.md), or [`/arch:AVX10.2`](../build/reference/arch-x86.md) compiler option is set and the compiler target is x86 or x64. Otherwise, undefined. -- `__AVX512DQ__` Defined as 1 when the [`/arch:AVX512`](../build/reference/arch-x86.md) or [`/arch:AVX10.1`](../build/reference/arch-x86.md) compiler option is set and the compiler target is x86 or x64. Otherwise, undefined. +- `__AVX512DQ__` Defined as 1 when the [`/arch:AVX512`](../build/reference/arch-x86.md), [`/arch:AVX10.1`](../build/reference/arch-x86.md), or [`/arch:AVX10.2`](../build/reference/arch-x86.md) compiler option is set and the compiler target is x86 or x64. Otherwise, undefined. -- `__AVX512F__` Defined as 1 when the [`/arch:AVX512`](../build/reference/arch-x86.md) or [`/arch:AVX10.1`](../build/reference/arch-x86.md) compiler option is set and the compiler target is x86 or x64. Otherwise, undefined. +- `__AVX512F__` Defined as 1 when the [`/arch:AVX512`](../build/reference/arch-x86.md), [`/arch:AVX10.1`](../build/reference/arch-x86.md), or [`/arch:AVX10.2`](../build/reference/arch-x86.md) compiler option is set and the compiler target is x86 or x64. Otherwise, undefined. -- `__AVX512VL__` Defined as 1 when the [`/arch:AVX512`](../build/reference/arch-x86.md) or [`/arch:AVX10.1`](../build/reference/arch-x86.md) compiler option is set and the compiler target is x86 or x64. Otherwise, undefined. +- `__AVX512VL__` Defined as 1 when the [`/arch:AVX512`](../build/reference/arch-x86.md), [`/arch:AVX10.1`](../build/reference/arch-x86.md), or [`/arch:AVX10.2`](../build/reference/arch-x86.md) compiler option is set and the compiler target is x86 or x64. Otherwise, undefined. -- `__AVX10_VER__` Defined as an integer that represents version of AVX10 when the [`/arch:AVX10.1`](../build/reference/arch-x86.md) compiler option is set and the compiler target is x86 or x64. Otherwise, undefined. +- `__AVX10_VER__` Defined as an integer that represents version of AVX10 when the [`/arch:AVX10.1`](../build/reference/arch-x86.md) or [`/arch:AVX10.2`](../build/reference/arch-x86.md) compiler option is set and the compiler target is x86 or x64. Otherwise, undefined. - `_CHAR_UNSIGNED` Defined as 1 if the default **`char`** type is unsigned. This value is defined when the [**`/J`** (Default char type is unsigned)](../build/reference/j-default-char-type-is-unsigned.md) compiler option is set. Otherwise, undefined. @@ -179,7 +179,7 @@ MSVC supports other predefined macros: - `__FUNCTION__` Defined as a string literal that contains the undecorated name of the enclosing function. The macro is defined only within a function. The `__FUNCTION__` macro isn't expanded if you use the [`/EP`](../build/reference/ep-preprocess-to-stdout-without-hash-line-directives.md) or [`/P`](../build/reference/p-preprocess-to-a-file.md) compiler option. For an example of usage, see the `__FUNCDNAME__` macro. -- `_INTEGRAL_MAX_BITS` Defined as the integer literal value 64, the maximum size (in bits) for a non-vector integral type. This macro is always defined. +- `_INTEGRAL_MAX_BITS` Defined as the integer literal value 64, the maximum size (in bits) for a nonvector integral type. This macro is always defined. ```cpp // integral_max_bits.cpp @@ -234,10 +234,8 @@ MSVC supports other predefined macros: - `_M_IX86_FP` Defined as an integer literal value that indicates the [`/arch`](../build/reference/arch-arm.md) compiler option that was set, or the default. This macro is always defined when the compilation target is an x86 processor. Otherwise, undefined. When defined, the value is: - 0 if the `/arch:IA32` compiler option was set. - - 1 if the `/arch:SSE` compiler option was set. - - - 2 if the `/arch:SSE2`, `/arch:AVX`, `/arch:AVX2`, `/arch:AVX512` or `/arch:AVX10.1` compiler option was set. This value is the default if an `/arch` compiler option wasn't specified. When `/arch:AVX` is specified, the macro `__AVX__` is also defined. When `/arch:AVX2` is specified, both `__AVX__` and `__AVX2__` are also defined. When `/arch:AVX512` is specified, `__AVX__`, `__AVX2__`, `__AVX512BW__`, `__AVX512CD__`, `__AVX512DQ__`, `__AVX512F__`, and `__AVX512VL__` are also defined. When `/arch:AVX10.1` is specified, `__AVX__`, `__AVX2__`, `__AVX512BW__`, `__AVX512CD__`, `__AVX512DQ__`, `__AVX512F__`, `__AVX512VL__` and `__AVX10_VER__` are also defined. + - 2 if the `/arch:SSE2`, `/arch:AVX`, `/arch:AVX2`, `/arch:AVX512`, `/arch:AVX10.1`, or `/arch:AVX10.2` compiler option was set. This value is the default if an `/arch` compiler option wasn't specified. When `/arch:AVX` is specified, the macro `__AVX__` is also defined. When `/arch:AVX2` is specified, both `__AVX__` and `__AVX2__` are also defined. When `/arch:AVX512` is specified, `__AVX__`, `__AVX2__`, `__AVX512BW__`, `__AVX512CD__`, `__AVX512DQ__`, `__AVX512F__`, and `__AVX512VL__` are also defined. When `/arch:AVX10.1` or `/arch:AVX10.2` is specified, `__AVX__`, `__AVX2__`, `__AVX512BW__`, `__AVX512CD__`, `__AVX512DQ__`, `__AVX512F__`, `__AVX512VL__` and `__AVX10_VER__` are also defined. - For more information, see [**`/arch`** (x86)](../build/reference/arch-x86.md). @@ -312,9 +310,9 @@ MSVC supports other predefined macros: - `_WCHAR_T_DEFINED` Defined as 1 when the default [`/Zc:wchar_t`](../build/reference/zc-wchar-t-wchar-t-is-native-type.md) compiler option is set. The `_WCHAR_T_DEFINED` macro is defined but has no value if the **`/Zc:wchar_t-`** compiler option is set, and **`wchar_t`** is defined in a system header file included in your project. Otherwise, undefined. -- `_WIN32` Defined as 1 when the compilation target is 32-bit ARM, 64-bit ARM, x86, or x64. Otherwise, undefined. +- `_WIN32` Defined as 1 when the compilation target is 32-bit ARM, 64-bit ARM, x86, x64, or ARM64EC. Otherwise, undefined. -- `_WIN64` Defined as 1 when the compilation target is 64-bit ARM or x64. Otherwise, undefined. +- `_WIN64` Defined as 1 when the compilation target is 64-bit ARM, x64, or ARM64EC. Otherwise, undefined. - `_WINRT_DLL` Defined as 1 when compiled as C++ and both [**`/ZW`** (Windows Runtime Compilation)](../build/reference/zw-windows-runtime-compilation.md) and [**`/LD`** or **`/LDd`**](../build/reference/md-mt-ld-use-run-time-library.md) compiler options are set. Otherwise, undefined. diff --git a/docs/preprocessor/preprocessor-directives.md b/docs/preprocessor/preprocessor-directives.md index 38d13833a81..f3c11dd326f 100644 --- a/docs/preprocessor/preprocessor-directives.md +++ b/docs/preprocessor/preprocessor-directives.md @@ -1,13 +1,12 @@ --- description: "Learn more about: Preprocessor directives" title: "Preprocessor directives" -ms.date: "08/29/2019" +ms.date: 10/15/2025 helpviewer_keywords: ["directives, preprocessor", "preprocessor, directives"] -ms.assetid: e0fc4564-b6cf-4a36-bf51-6ccd7abd0a94 --- # Preprocessor directives -Preprocessor directives, such as `#define` and `#ifdef`, are typically used to make source programs easy to change and easy to compile in different execution environments. Directives in the source file tell the preprocessor to take specific actions. For example, the preprocessor can replace tokens in the text, insert the contents of other files into the source file, or suppress compilation of part of the file by removing sections of text. Preprocessor lines are recognized and carried out before macro expansion. Therefore, if a macro expands into something that looks like a preprocessor command, it isn't recognized by the preprocessor. +Preprocessor directives, such as `#define` and `#ifdef`, are used to make source programs easy to change and compile in different execution environments. Directives in the source file tell the preprocessor to take specific actions. For example, the preprocessor can replace tokens in the text, insert the contents of other files into the source file, or suppress compilation of part of the file by removing sections of text. Preprocessor directives are processed before macro expansion. Therefore, if a macro expands into something that looks like a preprocessor command, it isn't recognized by the preprocessor. Preprocessor statements use the same character set as source file statements, with the exception that escape sequences aren't supported. The character set used in preprocessor statements is the same as the execution character set. The preprocessor also recognizes negative character values. @@ -29,7 +28,8 @@ The preprocessor recognizes the following directives: :::column span=""::: [`#import`](../preprocessor/hash-import-directive-cpp.md)\ [`#include`](../preprocessor/hash-include-directive-c-cpp.md)\ - [`#line`](../preprocessor/hash-line-directive-c-cpp.md) + [`#line`](../preprocessor/hash-line-directive-c-cpp.md)\ + [`#warning`](../preprocessor/hash-warning-directive-c-cpp.md) :::column-end::: :::column span=""::: [`#pragma`](../preprocessor/pragma-directives-and-the-pragma-keyword.md)\ diff --git a/docs/preprocessor/toc.yml b/docs/preprocessor/toc.yml index a2121985ada..aa4066ec4e0 100644 --- a/docs/preprocessor/toc.yml +++ b/docs/preprocessor/toc.yml @@ -7,7 +7,7 @@ items: - name: Preprocessor href: ../preprocessor/preprocessor.md - name: New preprocessor overview - href: ../preprocessor/preprocessor-experimental-overview.md + href: ../preprocessor/preprocessor-experimental-overview.md - name: Phases of translation href: ../preprocessor/phases-of-translation.md - name: Preprocessor directives @@ -92,6 +92,8 @@ items: href: ../preprocessor/hash-undef-directive-c-cpp.md - name: "#using directive (C++/CLI)" href: ../preprocessor/hash-using-directive-cpp.md + - name: "#warning directive (C/C++)" + href: ../preprocessor/hash-warning-directive-c-cpp.md - name: Preprocessor operators expanded: false items: diff --git a/docs/preprocessor/warning.md b/docs/preprocessor/warning.md index da6d6189840..8d6d994f0ad 100644 --- a/docs/preprocessor/warning.md +++ b/docs/preprocessor/warning.md @@ -1,7 +1,7 @@ --- title: "warning pragma" description: "Learn more about the warning pragma in Microsoft C/C++" -ms.date: 01/22/2021 +ms.date: 4/30/2025 f1_keywords: ["warning_CPP", "vc-pragma.warning"] helpviewer_keywords: ["pragma, warning", "push pragma warning", "pop warning pragma", "warning pragma"] no-loc: ["pragma"] @@ -13,7 +13,7 @@ Enables selective modification of the behavior of compiler warning messages. ## Syntax > **`#pragma warning(`**\ ->  *`warning-specifier`* **`:`** *`warning-number-list`*\ +>  *`warning-specifier`* **`:`** *`warning-number-list`* [ **`,`** **`justification`** **`:`** *`string-literal`*]\ >  [**`;`** *`warning-specifier`* **`:`** *`warning-number-list`* ... ] **`)`**\ > **`#pragma warning( push`** [ **`,`** *n* ] **`)`**\ > **`#pragma warning( pop )`** @@ -24,30 +24,39 @@ The following warning-specifier parameters are available. | warning-specifier | Meaning | |--|--| -| `1`, `2`, `3`, `4` | Apply the given level to the specified warnings. Also turns on a specified warning that is off by default. | +| `1`, `2`, `3`, `4` | Apply the given level to the specified warnings. For example: `#pragma warning (3 : 5033)` turns off warning 5033 (normally a level 1 warning) unless the warning level is set to `/w3` or higher. Also can be used to turn on a specified warning that is off by default. | | `default` | Reset warning behavior to its default value. Also turns on a specified warning that is off by default. The warning will be generated at its default, documented, level.

For more information, see [Compiler warnings that are off by default](../preprocessor/compiler-warnings-that-are-off-by-default.md). | -| `disable` | Don't issue the specified warning messages. | +| `disable` | Don't issue the specified warning messages. The optional **`justification`** property is allowed. | | `error` | Report the specified warnings as errors. | | `once` | Display the specified message(s) only one time. | -| `suppress` | Pushes the current state of the pragma on the stack, disables the specified warning for the next line, and then pops the warning stack so that the pragma state is reset. | +| `suppress` | Pushes the current state of the pragma on the stack, disables the specified warning for the next line, and then pops the warning stack so that the pragma state is reset. The optional **`justification`** property is allowed. | The following code statement illustrates that a *`warning-number-list`* parameter can contain multiple warning numbers, and that multiple *`warning-specifier`* parameters can be specified in the same pragma directive. ```cpp -#pragma warning( disable : 4507 34; once : 4385; error : 164 ) +#pragma warning( disable : 4507 4034; once : 4385; error : 164 ) ``` +However, when the **`justification`** field is present, only one warning number can be specified. The following code statement illustrates the use of the **`justification`** field. + +```cpp +#pragma warning( disable : 4507, justification : "This warning is disabled" ) +``` + +The **`justification`** fields allows you to explain why a warning is being disable or +suppressed. The **`justification`** field is only supported for the **`disable`** and **`suppress`** *`warning-specifier`*. This value will appear in the SARIF output when the `/analyze:log:includesuppressed` option is specified. Its value is a UTF-8 encoded narrow string literal. + This directive is functionally equivalent to the following code: ```cpp // Disable warning messages 4507 and 4034. -#pragma warning( disable : 4507 34 ) +#pragma warning(disable : 4507 4034) // Issue warning C4385 only once. -#pragma warning( once : 4385 ) +#pragma warning(once : 4385) // Report warning C4164 as an error. -#pragma warning( error : 164 ) +#pragma warning(error : 164) ``` The compiler adds 4000 to any warning number that is between 0 and 999. @@ -58,15 +67,17 @@ Warning numbers in the range 4700-4999 are associated with code generation. For // pragma_warning.cpp // compile with: /W1 #pragma warning(disable:4700) -void Test() { +void Test() +{ int x; - int y = x; // no C4700 here - #pragma warning(default:4700) // C4700 enabled after Test ends + int y = x; // no C4700 here + #pragma warning(default:4700) // C4700 enabled after compiling Test() } -int main() { +int main() +{ int x; - int y = x; // C4700 + int y = x; // C4700 } ``` diff --git a/docs/sanitizers/asan-building.md b/docs/sanitizers/asan-building.md index e1255cb13f7..5ea4cf7b5cf 100644 --- a/docs/sanitizers/asan-building.md +++ b/docs/sanitizers/asan-building.md @@ -1,30 +1,31 @@ --- -title: "AddressSanitizer language, build, and debugging reference" -description: "Technical description of building for the AddressSanitizer" +title: "MSVC AddressSanitizer language, build, and debugging reference" +description: "Technical description of building for the MSVC AddressSanitizer" ms.date: 02/05/2024 f1_keywords: ["__SANITIZE_ADDRESS__", "ASAN_VCASAN_DEBUGGING"] -helpviewer_keywords: ["ASan reference", "AddressSanitizer reference", "Address Sanitizer reference"] +helpviewer_keywords: ["ASan reference", "MSVC AddressSanitizer reference", "MSVC Address Sanitizer reference"] --- -# AddressSanitizer language, build, and debugging reference +# MSVC AddressSanitizer language, build, and debugging reference -The sections in this article describe the AddressSanitizer language specification, compiler options, and linker options. They also describe the options that control Visual Studio debugger integration specific to the AddressSanitizer. +This article describes the MSVC AddressSanitizer language specification, compiler options, linker options, and the options that control Visual Studio debugger integration specific to the MSVC AddressSanitizer. -For more information on the AddressSanitizer runtime, see the [runtime reference](./asan-runtime.md). It includes information on intercepted functions and how to hook custom allocators. For more information on saving crash dumps from AddressSanitizer failures, see the [crash dump reference](./asan-offline-crash-dumps.md). +For more information on the MSVC AddressSanitizer runtime, see the [runtime reference](asan-runtime.md). It includes information on intercepted functions and how to hook custom allocators. For more information on saving crash dumps from MSVC AddressSanitizer failures, see the [crash dump reference](asan-offline-crash-dumps.md). ## Language specification ### `__SANITIZE_ADDRESS__` -The `__SANITIZE_ADDRESS__` preprocessor macro is defined as `1` when [`/fsanitize=address`](../build/reference/fsanitize.md) is set. This macro is useful for advanced users to conditionally specify source code for the presence of the AddressSanitizer runtime. +The `__SANITIZE_ADDRESS__` preprocessor macro is defined as `1` when [`/fsanitize=address`](../build/reference/fsanitize.md) is set. This macro is useful to conditionally specify source code for the presence of the MSVC AddressSanitizer runtime. ```cpp #include -int main() { +int main() +{ #ifdef __SANITIZE_ADDRESS__ - printf("Address sanitizer enabled"); + printf("MSVC AddressSanitizer enabled"); #else - printf("Address sanitizer not enabled"); + printf("MSVC AddressSanitizer not enabled"); #endif return 1; } @@ -35,19 +36,30 @@ int main() { The [`__declspec(no_sanitize_address)`](../cpp/no-sanitize-address.md) specifier can be used to selectively disable the sanitizer on functions, local variables, or global variables. This `__declspec` affects _compiler_ behavior, not _runtime_ behavior. ```cpp -__declspec(no_sanitize_address) -void test1() { +#ifdef __SANITIZE_ADDRESS__ +// no_sanitize_address is only defined when compiling with MSVC AddressSanitizer. +// Guard against this by checking if `__SANITIZE_ADDRESS__` is defined. +#define NO_SANITIZE_ADDRESS __declspec(no_sanitize_address) +#else +#define NO_SANITIZE_ADDRESS +#endif + +NO_SANITIZE_ADDRESS +void test1() +{ int x[100]; x[100] = 5; // ASan exception not caught } -void test2() { - __declspec(no_sanitize_address) int x[100]; +void test2() +{ + NO_SANITIZE_ADDRESS int x[100]; x[100] = 5; // ASan exception not caught } -__declspec(no_sanitize_address) int g[100]; -void test3() { +NO_SANITIZE_ADDRESS int g[100]; +void test3() +{ g[100] = 5; // ASan exception not caught } ``` @@ -56,11 +68,11 @@ void test3() { ### `/fsanitize=address` compiler option -The [**`/fsanitize=address`**](../build/reference/fsanitize.md) compiler option instruments memory references in your code to catch memory safety errors at runtime. The instrumentation hooks loads, stores, scopes, `alloca`, and CRT functions. It can detect hidden bugs such as out-of-bounds, use-after-free, use-after-scope, and so on. For a nonexhaustive list of errors detected at runtime, see [AddressSanitizer error examples](./asan-error-examples.md). +The [**`/fsanitize=address`**](../build/reference/fsanitize.md) compiler option instruments memory references in your code to catch memory safety errors at runtime. The instrumentation hooks loads, stores, scopes, `alloca`, and CRT functions. It can detect hidden bugs such as out-of-bounds, use-after-free, use-after-scope, and so on. For a nonexhaustive list of errors detected at runtime, see [MSVC AddressSanitizer error examples](asan-error-examples.md). -**`/fsanitize=address`** is compatible with all existing C++ or C optimization levels (for example, **`/Od`**, **`/O1`**, **`/O2`**, and **`/O2 /GL`**). The code produced with this option works with static and dynamic CRTs (for example, **`/MD`**, **`/MDd`**, **`/MT`**, and **`/MTd`**). This compiler option can be used to create an .EXE or .DLL targeting x86 or x64. Debug information is required for optimal formatting of call stacks. This compiler option is not supported with profile guided optimization. +**`/fsanitize=address`** is compatible with all existing C++ or C optimization levels (for example, **`/Od`**, **`/O1`**, **`/O2`**, and **`/O2 /GL`**). The code produced with this option works with static and dynamic CRTs (for example, **`/MD`**, **`/MDd`**, **`/MT`**, and **`/MTd`**). This compiler option can be used to create an .EXE or .DLL targeting x86 or x64. Debug information is required for optimal formatting of call stacks. This compiler option isn't supported with profile guided optimization. -For examples of code that demonstrates several kinds of error detection, see [AddressSanitizer error examples](asan-error-examples.md). +For examples of code that demonstrates several kinds of error detection, see [MSVC AddressSanitizer error examples](asan-error-examples.md). ### `/fsanitize=fuzzer` compiler option (experimental) @@ -95,7 +107,7 @@ If you specify **`/NODEFAULTLIB`** and you don't specify one of these libraries, ### `/fsanitize-address-use-after-return` compiler option (experimental) -By default, the MSVC compiler (unlike Clang) doesn't generate code to allocate frames in the heap to catch use-after-return errors. To catch these errors using AddressSanitizer, you must: +By default, the MSVC compiler (unlike Clang) doesn't generate code to allocate frames in the heap to catch use-after-return errors. To catch these errors using MSVC AddressSanitizer, you must: 1. Compile using the [`/fsanitize-address-use-after-return`](../build/reference/fsanitize.md) option. 2. Before executing your program, run `set ASAN_OPTIONS=detect_stack_use_after_return=1` to set the runtime check option. @@ -106,42 +118,51 @@ The dual stack frame in the heap remains after the return from the function that Stack frames are allocated in the heap and remain after functions return. The runtime uses garbage collection to asynchronously free these fake call-frame objects, after a certain time interval. Addresses of locals get transferred to persistent frames in the heap. It's how the system can detect when any locals get used after the defining function returns. For more information, see the [algorithm for stack use after return](https://github.com/google/sanitizers/wiki/AddressSanitizerUseAfterReturn) as documented by Google. +### ASan intrinsic compatibility library + +When building with ASan, the compiler replaces intrinsic functions (like `memset`) with function calls provided by the ASan runtime library (like `__asan_memset`) that complete the same operation but also provide memory safety checks. For user-mode ASan, the compiler and runtime are updated together because Visual Studio provides both. [Kernel-mode ASan (KASan)](/windows-hardware/drivers/devtest/kasan) is part of the Windows OS, so it updates on a different cadence than the compiler. To avoid issues with a new compiler using new intrinsics that the installed version of KASan doesn't support, link the compatibility library (`asan_compat.lib`) to avoid link-time issues. When using `asan_compat.lib`, the program behaves as though the unsupported ASan intrinsics aren't used. Linking with a newer runtime library that supports the new ASan intrinsics supersedes the versions provided by `asan_compat.lib`. This decision is made at link time, so it's imperative to link with the KASan library provided by the Windows SDK that matches the OS version you're targeting. + +The following options are supported in Visual Studio 2022 17.14 Preview 2 and later: +- To include this compatibility library as a default library, use the **`/fsanitize-address-asan-compat-lib`** compiler option. This option is automatically enabled when using **`/fsanitize=kernel-address`**. +- To opt-out of this compatibility library, use the **`/fno-sanitize-address-asan-compat-lib`** compiler option. + +Using **`/fsanitize-address-asan-compat-lib`** to link a newer compiler with an older user-mode ASan runtime isn't currently supported. + ## Linker ### `/INFERASANLIBS[:NO]` linker option -The **`/fsanitize=address`** compiler option marks objects to specify which AddressSanitizer library to link into your executable. The libraries have names that begin with *`clang_rt.asan*`*. The [`/INFERASANLIBS`](../build/reference/inferasanlibs.md) linker option (on by default) links these libraries from their default locations automatically. Here are the libraries chosen and automatically linked in. +The **`/fsanitize=address`** compiler option marks objects to specify which MSVC AddressSanitizer library to link into your executable. The libraries have names that begin with *`clang_rt.asan*`*. The [`/INFERASANLIBS`](../build/reference/inferasanlibs.md) linker option (on by default) links these libraries from their default locations automatically. Here are the libraries chosen and automatically linked in. > [!NOTE] > In the following table, *`{arch}`* is either *`i386`* or *`x86_64`*. > These libraries use Clang conventions for architecture names. MSVC conventions are normally `x86` and `x64` rather than `i386` and `x86_64`. They refer to the same architectures. -| CRT option | AddressSanitizer runtime library (.lib) | Address runtime binary (.dll) +| CRT option | MSVC AddressSanitizer runtime library (.lib) | Address runtime binary (.dll) |--|--|--| -| `/MT` or `/MTd` | *`clang_rt.asan_dynamic-{arch}`*, *`clang_rt.asan_static_runtime_thunk-{arch}`* | *`clang_rt.asan_dynamic-{arch}`* -| `/MD` or `/MDd` | *`clang_rt.asan_dynamic-{arch}`*, *`clang_rt.asan_dynamic_runtime_thunk-{arch}`* | *`clang_rt.asan_dynamic-{arch}`* +| `/MT` or `/MTd` | *`clang_rt.asan_dynamic-{arch}.lib`*, *`/wholearchive:clang_rt.asan_static_runtime_thunk-{arch}.lib`* | *`clang_rt.asan_dynamic-{arch}.dll`* +| `/MD` or `/MDd` | *`clang_rt.asan_dynamic-{arch}.lib`*, *`/wholearchive:clang_rt.asan_dynamic_runtime_thunk-{arch}.lib`* | *`clang_rt.asan_dynamic-{arch}.dll`* -The linker option [`/INFERASANLIBS:NO`](../build/reference/inferasanlibs.md) prevents the linker from linking a *`clang_rt.asan*`* library file from the default location. Add the library path in your build scripts if you use this option. Otherwise, the linker reports an unresolved external symbol error. +The linker option [`/INFERASANLIBS:NO`](../build/reference/inferasanlibs.md) prevents the linker from linking a *`clang_rt.asan*`* library file from the default location. Add the library path in your build scripts if you use this option. Otherwise, the linker reports an unresolved external symbol error. The runtime thunk libraries **must** be linked with the `/wholearchive` option applied. **Previous Versions** -Prior to Visual Studio 17.7 Preview 3, statically linked (**`/MT`** or **`/MTd`**) builds didn't use a DLL dependency. Instead, the AddressSanitizer runtime was statically linked into the user's EXE. DLL projects would then load exports from the user's EXE to access ASan functionality. Also, dynamically linked projects (**`/MD`** or **`/MTd`**) used different libraries and DLLs depending on whether the project was configured for debug or release. For more information about these changes and their motivations, see [MSVC Address Sanitizer – One DLL for all Runtime Configurations](https://devblogs.microsoft.com/cppblog/msvc-address-sanitizer-one-dll-for-all-runtime-configurations/). - +Prior to Visual Studio 17.7 Preview 3, statically linked (**`/MT`** or **`/MTd`**) builds didn't use a DLL dependency. Instead, the MSVC AddressSanitizer runtime was statically linked into the user's EXE. DLL projects would then load exports from the user's EXE to access ASan functionality. Also, dynamically linked projects (**`/MD`** or **`/MTd`**) used different libraries and DLLs depending on whether the project was configured for debug or release. For more information about these changes and their motivations, see [MSVC AddressSanitizer – One DLL for all Runtime Configurations](https://devblogs.microsoft.com/cppblog/msvc-address-sanitizer-one-dll-for-all-runtime-configurations/). -| CRT runtime option | DLL or EXE | AddressSanitizer runtime libraries | +| CRT runtime option | DLL or EXE | MSVC AddressSanitizer runtime libraries | |--|--|--| -| **`/MT`** | EXE | *`clang_rt.asan-{arch}`*, *`clang_rt.asan_cxx-{arch}`* | -| **`/MT`** | DLL | *`clang_rt.asan_dll_thunk-{arch}`* | -| **`/MD`** | Either | *`clang_rt.asan_dynamic-{arch}`*, *`clang_rt.asan_dynamic_runtime_thunk-{arch}`* | -| **`/MTd`** | EXE | *`clang_rt.asan_dbg-{arch}`*, *`clang_rt.asan_dbg_cxx-{arch}`* | -| **`/MTd`** | DLL | *`clang_rt.asan_dbg_dll_thunk-{arch}`* | -| **`/MDd`** | Either | *`clang_rt.asan_dbg_dynamic-{arch}`*, *`clang_rt.asan_dbg_dynamic_runtime_thunk-{arch}`* | +| **`/MT`** | EXE | *`/wholearchive:clang_rt.asan-{arch}.lib`*, *`clang_rt.asan_cxx-{arch}.lib`* | +| **`/MT`** | DLL | *`/wholearchive:clang_rt.asan_dll_thunk-{arch}.lib`* | +| **`/MD`** | Either | *`clang_rt.asan_dynamic-{arch}.lib`*, *`/wholearchive:clang_rt.asan_dynamic_runtime_thunk-{arch}.lib`* | +| **`/MTd`** | EXE | *`/wholearchive:clang_rt.asan_dbg-{arch}.lib`*, *`clang_rt.asan_cxx_dbg-{arch}.lib`* | +| **`/MTd`** | DLL | *`/wholearchive:clang_rt.asan_dbg_dll_thunk-{arch}.lib`* | +| **`/MDd`** | Either | *`/wholearchive:clang_rt.asan_dbg_dynamic-{arch}.lib`*, *`clang_rt.asan_dbg_dynamic_runtime_thunk-{arch}.lib`* | ## Visual Studio integration ### `/fno-sanitize-address-vcasan-lib` compiler option -The **`/fsanitize=address`** option links in extra libraries for an improved Visual Studio debugging experience when an AddressSanitizer exception is thrown. These libraries are called **VCAsan**. The libraries enable Visual Studio to display AddressSanitizer errors on your source code. They also enable the executable to generate crash dumps when an AddressSanitizer error report is created. For more information, see [Visual Studio AddressSanitizer extended functionality library](./asan-debugger-integration.md). +The **`/fsanitize=address`** option links in extra libraries for an improved Visual Studio debugging experience when an MSVC AddressSanitizer exception is thrown. These libraries are called **VCAsan**. The libraries enable Visual Studio to display MSVC AddressSanitizer errors on your source code. They also enable the executable to generate crash dumps when an MSVC AddressSanitizer error report is created. For more information, see [Visual Studio MSVC AddressSanitizer extended functionality library](asan-debugger-integration.md). The library chosen depends on the compiler options, and is automatically linked in. @@ -152,7 +173,7 @@ The library chosen depends on the compiler options, and is automatically linked | **`/MTd`** | *`libvcasand.lib`* | | **`/MDd`** | *`vcasand.lib`* | -However, if you compile using **`/Zl`** (Omit default library name), you must manually specify the library. If you don't, you'll get an unresolved external symbol link error. Here are some typical examples: +However, if you compile using **`/Zl`** (Omit default library name), you must manually specify the library. If you don't, you get an unresolved external symbol link error. Here are some typical examples: ```Output error LNK2001: unresolved external symbol __you_must_link_with_VCAsan_lib @@ -169,10 +190,10 @@ To enable this behavior, run the command `set ASAN_VCASAN_DEBUGGING=1` before yo ## See also -[AddressSanitizer overview](./asan.md)\ -[AddressSanitizer known issues](./asan-known-issues.md)\ -[AddressSanitizer runtime reference](./asan-runtime.md)\ -[AddressSanitizer shadow bytes](./asan-shadow-bytes.md)\ -[AddressSanitizer cloud or distributed testing](./asan-offline-crash-dumps.md)\ -[AddressSanitizer debugger integration](./asan-debugger-integration.md)\ -[AddressSanitizer error examples](./asan-error-examples.md) +[MSVC AddressSanitizer overview](asan.md)\ +[MSVC AddressSanitizer known issues](asan-known-issues.md)\ +[MSVC AddressSanitizer runtime reference](asan-runtime.md)\ +[MSVC AddressSanitizer shadow bytes](asan-shadow-bytes.md)\ +[MSVC AddressSanitizer cloud or distributed testing](asan-offline-crash-dumps.md)\ +[MSVC AddressSanitizer debugger integration](asan-debugger-integration.md)\ +[MSVC AddressSanitizer error examples](asan-error-examples.md) diff --git a/docs/sanitizers/asan-continue-on-error.md b/docs/sanitizers/asan-continue-on-error.md index 0e5694dfc73..f89ab731aea 100644 --- a/docs/sanitizers/asan-continue-on-error.md +++ b/docs/sanitizers/asan-continue-on-error.md @@ -1,18 +1,18 @@ --- -title: "Walkthrough: Use Address Sanitizer Continue On Error to find memory safety issues" -description: "Learn how to use Address Sanitizer continue on error to find memory safety errors in your app." +title: "Walkthrough: Use AddressSanitizer Continue On Error to find memory safety issues" +description: "Learn how to use AddressSanitizer continue on error to find memory safety errors in your app." ms.date: 07/31/2023 f1_keywords: ["AddressSanitizer", "Continue On Error"] helpviewer_keywords: ["ASan", "AddressSanitizer", "Address Sanitizer", "compiling for AddressSanitizer", "Continue On Error", "ASAN continue on error", "Address Sanitizer continue on error"] --- -# Walkthrough: Use Address Sanitizer Continue On Error to find memory safety issues +# Walkthrough: Use AddressSanitizer Continue On Error to find memory safety issues In this walkthrough, create checked builds that find and report memory safety errors. -Memory safety errors like out-of-bounds memory reads and writes, using memory after it has been freed, `NULL` pointer dereferences, and so on, are a top concern for C/C++ code. Address Sanitizer (ASAN) is a compiler and runtime technology that exposes these kinds of hard-to-find bugs, and does it with zero false positives. For an overview of ASAN, see [AddressSanitizer](asan.md). +Memory safety errors like out-of-bounds memory reads and writes, using memory after it has been freed, `NULL` pointer dereferences, and so on, are a top concern for C/C++ code. AddressSanitizer (ASAN) is a compiler and runtime technology that exposes these kinds of hard-to-find bugs, and does it with zero false positives. For an overview of ASAN, see [AddressSanitizer](asan.md). -Continue On Error (COE) is a new ASAN feature that automatically diagnoses and reports memory safety errors as your app runs. When your program exits, a summary of unique memory safety errors is output to `stdout`, `stderr`, or to a log file of your choice. When you create a standard C++ checked build with `-fsanitizer=address`, calls to allocators, deallocators such as `free`, `memcpy`, `memset`, and so on, are forwarded to the ASAN runtime. The ASAN runtime provides the same semantics for these functions, but monitors what happens with the memory. ASAN diagnoses and reports hidden memory safety errors, with zero false positives, as your app runs. +Continue On Error (COE) is a new ASAN feature that automatically diagnoses and reports memory safety errors as your app runs. When your program exits, a summary of unique memory safety errors is output to `stdout`, `stderr`, or to a log file of your choice. When you create a standard C++ checked build with `-fsanitize=address`, calls to allocators, deallocators such as `free`, `memcpy`, `memset`, and so on, are forwarded to the ASAN runtime. The ASAN runtime provides the same semantics for these functions, but monitors what happens with the memory. ASAN diagnoses and reports hidden memory safety errors, with zero false positives, as your app runs. A significant advantage of COE is that, unlike the previous ASAN behavior, your program doesn't stop running when the first memory error is found. Instead, ASAN notes the error, and your app continues to run. After your app exits, a summary of all the memory issues is output. @@ -20,7 +20,7 @@ It's a good practice to create a checked build of your C or C++ app with ASAN tu When your app finishes, you get a summary of the memory issues. With COE, you can compile and deploy an existing application into limited production to find memory safety issues. You can run the checked build for days to fully exercise the code, although the app will run slower due to the ASAN instrumentation. -You can use this feature to create a new shipping gate. If all your existing tests pass, but COE reports a memory safety error or a leak, don’t ship the new code or integrate it into a parent branch. +You can use this feature to create a new shipping gate. If all your existing tests pass, but COE reports a memory safety error or a leak, don't ship the new code or integrate it into a parent branch. Don't deploy a build with COE enabled into production! COE is intended to be used in testing and development environments only. You shouldn't use an ASAN enabled build in production because of the performance impact of the instrumentation added to detect memory errors, the risk of exposing the internal implementation if errors are reported, and to avoid increasing the surface area of possible security exploits by shipping the library functions that ASAN substitutes for memory allocation, freeing, and so on. @@ -44,21 +44,21 @@ Create the example: ```cpp #include #include - + void BadFunction(int *pointer) { free(pointer); free(pointer); // double-free! } - + int main(int argc, const char *argv[]) { int *pointer = static_cast(malloc(4)); BadFunction(pointer); - + // Normally we'd crash before this, but with COE we can see heap-use-after-free error as well printf("\n\n******* Pointer value: %d\n", *pointer); - + return 1; } ``` @@ -67,7 +67,7 @@ In the preceding code, `pointer` is freed twice. This is a contrived example, bu Create a build of the preceding code with COE turned on with the following steps: -1. Compile the code in the developer command prompt you opened earlier: `cl -fsanitize=address -Zi doublefree.cpp`. The `-fsanitize=address` switch turns on ASAN, and `-Zi` creates a separate PDB file that address sanitizer uses to display memory error location information. +1. Compile the code in the developer command prompt you opened earlier: `cl -fsanitize=address -Zi doublefree.cpp`. The `-fsanitize=address` switch turns on ASAN, and `-Zi` creates a separate PDB file that AddressSanitizer uses to display memory error location information. 1. Send ASAN output to `stdout` by setting the `ASAN_OPTIONS` environment variable in the developer command prompt as follows: `set ASAN_OPTIONS=continue_on_error=1` 1. Run the test code with: `doublefree.exe` @@ -146,7 +146,7 @@ This sorting prioritizes memory safety issues that may be the most concerning. F File: D:\a\_work\1\s\src\vctools\asan\llvm\compiler-rt\lib\asan\asan_malloc_win_thunk.cpp Unique call stacks: 1 File: C:\Users\xxx\Desktop\COE\doublefree.cpp Unique call stacks: 1 -`````` +``` Finally, the report contains a summary of where the memory errors occurred: @@ -181,24 +181,24 @@ Create the example: 1. In that directory, create a source file, for example, `coe.cpp`, and paste the following code: ```cpp - #include - + #include + char* func(char* buf, size_t sz) - { - char* local = (char*)malloc(sz); - for (auto ii = 0; ii <= sz; ii++) // bad loop exit test + { + char* local = (char*)malloc(sz); + for (auto ii = 0; ii <= sz; ii++) // bad loop exit test { - local[ii] = ~buf[ii]; // Two memory safety errors + local[ii] = ~buf[ii]; // Two memory safety errors } - - return local; - } - - char buffer[10] = {0,1,2,3,4,5,6,7,8,9}; - - void main() - { - char* inverted_buf= func(buffer, 10); + + return local; + } + + char buffer[10] = {0,1,2,3,4,5,6,7,8,9}; + + int main() + { + char* inverted_buf= func(buffer, 10); } ``` @@ -213,7 +213,7 @@ Errors are only observable if the page following the allocation is unmapped, or Create a build of the preceding code with COE turned on: -1. Compile the code with `cl -fsanitize=address -Zi coe.cpp`. The `-fsanitize=address` switch turns on ASAN, and `-Zi` creates a separate PDB file that address sanitizer uses to display memory error location information. +1. Compile the code with `cl -fsanitize=address -Zi coe.cpp`. The `-fsanitize=address` switch turns on ASAN, and `-Zi` creates a separate PDB file that AddressSanitizer uses to display memory error location information. 1. Send ASAN output to `stdout` by setting the `ASAN_OPTIONS` environment variable in the developer command prompt as follows: `set ASAN_OPTIONS=continue_on_error=1` 1. Run the test code with: `coe.exe` @@ -263,7 +263,7 @@ File: C:\Users\xxx\Desktop\COE\coe.cpp Raw HitCnt: 1 On Reference: 1-byte-write-heap-buffer-overflow ``` -The default Address Sanitizer runtime behavior terminates the app after reporting the first error it finds. It doesn't allow the "bad" machine instruction to execute. The new Address Sanitizer runtime diagnoses and reports errors, but then executes subsequent instructions. +The default AddressSanitizer runtime behavior terminates the app after reporting the first error it finds. It doesn't allow the "bad" machine instruction to execute. The new AddressSanitizer runtime diagnoses and reports errors, but then executes subsequent instructions. COE tries to automatically return control back to the application after reporting each memory safety error. There are situations when it can't, such as when there's a memory access violation (AV) or a failed memory allocation. COE doesn't continue after access violations that the program's structured exception handling doesn't catch. If COE can't return execution to the app, a `CONTINUE CANCELLED - Deadly Signal. Shutting down.` message is output. @@ -317,7 +317,7 @@ int foo_redundant(unsigned long arg_var) return ret; } -void main() +int main() { int cnt = 0; @@ -339,7 +339,7 @@ void main() In `main()` a large number is passed to `foo_redundant`, which is ultimately passed to `_alloca()`, which causes `_alloca()` to fail. -This example outputs `pass` when compiled without ASAN (that is, no `-fsanitize=address` switch) but outputs `fail` when compiled with ASAN turned on (that is, with the `-fsanitize=address` switch). That's because without ASAN, the exception code matches `RET_STACK_EXCEPTION` so `cnt` is set to 1. It behaves differently when compiled with ASAN on because the thrown exception is an Address Sanitizer error instead: dynamic-stack-buffer-overflow. That means the code returns `RET_OTHER_EXCEPTION` instead of `RET_STACK_EXCEPTION` so `cnt` isn't set to 1. +This example outputs `pass` when compiled without ASAN (that is, no `-fsanitize=address` switch) but outputs `fail` when compiled with ASAN turned on (that is, with the `-fsanitize=address` switch). That's because without ASAN, the exception code matches `RET_STACK_EXCEPTION` so `cnt` is set to 1. It behaves differently when compiled with ASAN on because the thrown exception is an AddressSanitizer error instead: dynamic-stack-buffer-overflow. That means the code returns `RET_OTHER_EXCEPTION` instead of `RET_STACK_EXCEPTION` so `cnt` isn't set to 1. ## Other benefits @@ -351,4 +351,4 @@ With the new ASAN runtime, no extra binaries need to be deployed with your app. [Example memory safety errors](asan.md#error-types)\ [-Zi compiler flag](../build/reference/z7-zi-zi-debug-information-format.md#zi)\ [-fsanitize=address compiler flag](../build/reference/fsanitize.md)\ -[Top 25 most dangerous software weaknesses](https://cwe.mitre.org/top25/archive/2021/2021_cwe_top25.html) \ No newline at end of file +[Top 25 most dangerous software weaknesses](https://cwe.mitre.org/top25/archive/2021/2021_cwe_top25.html) diff --git a/docs/sanitizers/asan-flags.md b/docs/sanitizers/asan-flags.md new file mode 100644 index 00000000000..5b526a8cf1b --- /dev/null +++ b/docs/sanitizers/asan-flags.md @@ -0,0 +1,74 @@ +--- +title: "AddressSanitizer Runtime Options" +description: "List of runtime options for the Microsoft C/C++ AddressSanitizer" +ms.date: 8/08/2025 +helpviewer_keywords: ["AddressSanitizer options", "AddressSanitizer flags", "Address sanitizer options", "Address sanitizer flags", "asan options", "asan flags", "sanitizer flags", "asan_options", "AddressSanitizerFlags", "SanitizerCommonFlags"] +--- + +# AddressSanitizer Runtime Options + +The following table lists the options for the AddressSanitizer. Enable them via the `ASAN_OPTIONS` environment variable or by overriding the `__asan_default_options()` user function described [here](asan-runtime.md#runtime-options). + +> [!NOTE] +> These descriptions account for Microsoft Visual C++ (MSVC) specific behaviors, which may vary from Clang's runtime options. + +| Flag | Default value | Description | +|------|---------------|-------------| +|`abort_on_error` | `false` | If `true`, ASan calls `abort()` instead of `_exit()` after printing the error report.| +|`alloc_dealloc_mismatch` | `false` | Detects mismatched memory operations such as `malloc`/`delete`, `new[]`/`free`, and so on.| +|`allocator_frees_and_returns_null_on_realloc_zero` | `true` | If set to `true`, `realloc(p, 0)` is the same as `free(p)` by default (which is the same as the POSIX standard). If set to `false`, `realloc(p, 0)` returns a pointer to an allocated space that can't be used. | +|`allocator_may_return_null` | `false` | If `true`, the allocator returns `nullptr` when out of memory. Instead of crashing, ASan emits a warning about the allocator's failure and execution continues.| +|`allow_user_poisoning` | `true` | If `true`, you may manually mark memory regions as poisoned or unpoisoned using the [Manual AddressSanitizer poisoning interface](asan-runtime.md#poisoning).| +|`check_initialization_order` | `false` | If `true`, attempts to catch initialization order issues.| +|`continue_on_error` | 0 | Allows an application to continue running while reporting memory safety errors.
0-disabled.
1-enabled; errors are sent to `stdout`.
2-enabled; errors are sent to `stderr`.
For more information, see [continue_on_error](asan-continue-on-error.md).| +|`detect_container_overflow` | `true` | If `true`, honor the container overflow annotations. For more information, see [ContainerOverflow](error-container-overflow.md).| +|`detect_invalid_pointer_pairs` | `false` | If `true`, ASan detects operations like `<`, `<=`, `>`, `>=`, and `-` on invalid pointer pairs such as pointers that belong to different objects.| +|`detect_stack_use_after_return` | `false` | Experimental. If `true`, ASan enables `stack-use-after-return` checking at runtime. Requires `/fsanitize-address-use-after-return`. For more information, see [stack-use-after-return](error-stack-use-after-return.md).| +|`exitcode` | 1 | Overrides the program exit status with this value if ASan finds an error.| +|`external_symbolizer_path` | "" | Path to the external symbolizer. If empty, ASan searches `$PATH` for the symbolizer.| +|`fast_unwind_on_malloc` | `true` | If available, ASan uses the fast frame-pointer-based unwinder on `malloc`/`free`.| +|`halt_on_error` | `true` | Not supported. Use `continue_on_error` instead.| +|`handle_segv` | `true` | If `true`, ASan handles `SEGV` errors.| +|`handle_sigfpe` | `true` | If `true`, ASan handles `SIGFPE` errors.| +|`handle_sigill` | `true` | If `true`, ASan handles `SIGILL` errors.| +|`help` | `false` | If `true`, ASan prints the flag options to the console.| +|`iat_overwrite`|`error`|`error` - reports an error whenever an overwrite is detected.
`protect` - tries to avoid using the overwritten definition.
`ignore` - doesn't try to correct any overwritten functions. For more information, see [`iat_overwrite`](asan-runtime.md#msvc-specific-addresssanitizer-runtime-options).| +|`include_if_exists` | "" | Reads options from the specified file. ASan doesn't fail if the file doesn't exist.| +|`intercept_strpbrk` | `true` | If `true`, uses custom wrappers for `strpbrk` to find more errors.| +|`intercept_strspn` | `true` | If `true`, uses custom wrappers for `strspn` and `strcspn` to find more errors.| +|`intercept_strstr` | `true` | If `true`, uses custom wrappers for `strstr` and `strcasestr` to find more errors.| +|`malloc_context_size` | 1 | Maximum number of stack frames to keep for each allocation/deallocation.| +|`malloc_fill_byte` | `0xbe` | Value used to fill newly allocated memory.| +|`max_malloc_fill_size` | 4096 | The ASan allocator fills an allocation with `malloc_fill_byte` up to `max_malloc_fill_size` on a call to `malloc`.| +|`max_redzone` | 2048 | Maximum size (in bytes) of redzones around heap objects.| +|`new_delete_type_mismatch` | `true` | Report errors on mismatch between the size of `new` and `delete`. For more information, see [`new-delete-type-mismatch`](error-new-delete-type-mismatch.md).| +|`poison_heap` | `true` | If `true`, poison the heap memory on allocation and deallocation. `false` is useful for benchmarking the allocator or instrumentator.| +|`poison_partial` | `true` | If `true`, poison partially addressable 8-byte aligned words. This flag affects heap and global buffers, but not stack buffers.| +|`print_cmdline` | `false` | Print the command line on crash. With `continue_on_error` set >= 1, prints the current working directory and is `UTF-16` aware.| +|`print_legend` | `true` | If `true`, print the shadow memory map legend to accompany the ASan report. | +|`print_stats`| `false` | If `true`, print allocator stats after printing ASan report. | +|`print_summary` | `true` | If `false`, disables showing error summaries that accompany error reports.| +|`quarantine_size_mb` | -1 | Size (in Mb) of quarantine used to detect `use-after-free` errors. A lower value may increase the chance of false negatives.| +|`redzone` | 16 | Minimum size (in bytes) of redzones around heap objects. Requirement: `redzone >= 16` and must be a power of two.| +|`replace_str` | `true` | If `true`, uses custom wrappers and replacements for `libc` string functions to find more errors.| +|`report_globals` | 1 | How to respond to buffer overflow for globals:
0-don't detect buffer overflow on globals.
1 - detect buffer overflow.
2 - detect buffer overflow and print registered globals data.| +|`sleep_before_dying` | 0 | Number of seconds to sleep between printing an error report and terminating the program.| +|`stack_trace_format` | `DEFAULT` | Format string used to render stack frames. `DEFAULT` - ` #%n %p %F %L`. List of available placeholders:
`%%` - represents a `'%'` character
`%n` - frame number (copy of `frame_no`)
`%p` - `PC`
`%m` - path to module
`%o` - offset in the module
`%f` - function name
`%q` - if available, offset in the function
`%s` - path to source file
`%l` - line in the source file
`%c` - column in the source file
`%F` - if the function is known, ASan prints `in ` followed by the offset in this function if source is unknown
`%S` - ASan prints file/line/column information
`%L` - If file information is available, ASan prints the file name, line, and column. If module information is available, ASan prints the module name, offset, and architecture. If neither are available, ASan prints `()`
`%M` - If known, ASan prints module basename and offset, or `PC`| +|`strict_memcmp` | `true` | If `true`, assumes that `memcmp(p1, p2, n)` always reads `n` bytes before comparing `p1` and `p2`.| +|`strict_string_checks` | `false` | If `true`, checks that string arguments are properly null-terminated.| +|`strip_path_prefix` | "" | Strips this prefix from file paths in error reports.| +|`symbolize` | `true` | If `true`, use the `llvm-symbolizer` to turn virtual addresses into file or line locations.| +|`symbolize_inline_frames` | `true` | Print inlined frames in stacktraces.| +|`verbosity` | 0 | Verbosity level:
0 - default verbosity.
1 - more output.
2 - even more output.
3 - maximum verbosity. | +|`windows_fast_fail_on_error`| `false` | If `true`, the process can terminate with a `__fastfail(71)` after printing the error report. For more information, see [`windows_fast_fail_on_error`](asan-runtime.md#msvc-specific-addresssanitizer-runtime-options).| +|`windows_hook_legacy_allocators`| `true` |If `true`, enables hooking of (`Global`/`Local`)(`Alloc`/`Free`/`Size`/`ReAlloc`/`Lock`/`Unlock`) functions.| + +## See also + +[AddressSanitizer overview](asan.md)\ +[AddressSanitizer known issues](asan-known-issues.md)\ +[AddressSanitizer build and language reference](asan-building.md)\ +[AddressSanitizer shadow bytes](asan-shadow-bytes.md)\ +[AddressSanitizer cloud or distributed testing](asan-offline-crash-dumps.md)\ +[AddressSanitizer debugger integration](asan-debugger-integration.md)\ +[AddressSanitizer error examples](asan-error-examples.md) diff --git a/docs/sanitizers/asan-known-issues.md b/docs/sanitizers/asan-known-issues.md index cbf822f6b87..7d3b22a2e7a 100644 --- a/docs/sanitizers/asan-known-issues.md +++ b/docs/sanitizers/asan-known-issues.md @@ -1,18 +1,18 @@ --- -title: "AddressSanitizer known issues" +title: "AddressSanitizer known issues and limitations" description: "Technical description of the AddressSanitizer for Microsoft C/C++ known issues." -ms.date: 12/1/2023 +ms.date: 11/19/2025 helpviewer_keywords: ["AddressSanitizer known issues"] --- -# AddressSanitizer known issues +# AddressSanitizer known issues and limitations > [!NOTE] > Send us [feedback](https://aka.ms/vsfeedback/browsecpp) on what you'd like to see in future releases, and [report bugs](https://aka.ms/feedback/report?space=62) if you run into issues. ## Incompatible options and functionality -These options and functionality are incompatible with [`/fsanitize=address`](../build/reference/fsanitize.md) and should be disabled or avoided. +The following options and functionality are incompatible with [`/fsanitize=address`](../build/reference/fsanitize.md) and should be disabled or avoided. - The [`/RTC`](../build/reference/rtc-run-time-error-checks.md) options are incompatible with AddressSanitizer and should be disabled. - [Incremental linking](../build/reference/incremental-link-incrementally.md) is unsupported, and should be disabled. @@ -23,13 +23,13 @@ These options and functionality are incompatible with [`/fsanitize=address`](../ - [C++ AMP](../parallel/amp/cpp-amp-overview.md) is unsupported, and should be disabled. - [Universal Windows Platform](../cppcx/universal-windows-apps-cpp.md) (UWP) applications are unsupported. - [Special case list](https://clang.llvm.org/docs/SanitizerSpecialCaseList.html) files are unsupported. -- [MFC](../mfc/mfc-concepts.md) using the optional [`alloc_dealloc_mismatch`](error-alloc-dealloc-mismatch.md) runtime option is unsupported. +- [Precompiled headers built without `/fsanitize=address`](../build/creating-precompiled-header-files.md#consistency-rules-for-yc-and-yu) are unsupported. ## Standard library support -The MSVC standard library (STL) is partially enlightened to understand the AddressSanitizer and provide other checks. For more information, see [container-overflow error](./error-container-overflow.md). +The Microsoft Visual C++ (MSVC) standard library (STL) makes partial use of the AddressSanitizer and provides other code safety checks. For more information, see [`container-overflow` error](./error-container-overflow.md). -When annotations are disabled or in versions without support, AddressSanitizer exceptions raised in STL code do still identify true bugs. However, they aren't as precise as they could be. +When annotations are disabled, or in versions of the Standard Library that don't support them, AddressSanitizer exceptions raised in STL code still identify real bugs. However, they're more precise if annotations are enabled and you use a version of the Standard Library that supports them. This example demonstrates the lack of precision and the benefits of enabling annotations: @@ -37,7 +37,8 @@ This example demonstrates the lack of precision and the benefits of enabling ann // Compile with: cl /fsanitize=address /Zi #include -int main() { +int main() +{ // Create a vector of size 10, but with a capacity of 20. std::vector v(10); v.reserve(20); @@ -55,30 +56,61 @@ int main() { } ``` -## Windows versions +## Overriding `operator new` and `delete` -As there are dependencies with specific Windows versions, support is focused on Windows 10. MSVC AddressSanitizer was tested on 10.0.14393 (RS1), and 10.0.21323 (prerelease insider build). [Report a bug](https://aka.ms/feedback/report?space=62) if you run into issues. +AddressSanitizer (ASan) uses a custom version of `operator new` and `operator delete` to find allocation errors like [`alloc_dealloc_mismatch`](error-alloc-dealloc-mismatch.md). Run the linker with [`/INFERASANLIBS`](../build/reference/inferasanlibs.md) to ensure that ASan's `new`/`delete` override has lower precedence, so that the linker chooses `operator new` or `operator delete` overrides in other libraries over ASan's custom versions. When this happens, ASan might not catch some errors that rely on its custom `operator new` and `operator delete`. + +[MFC](../mfc/mfc-concepts.md) includes custom overrides for `operator new` and `operator delete`. When Microsoft Foundation Classes (MFC) overrides are used instead of the ASan provided `operator new` and `operator delete`, ASan might miss errors entirely or classify them incorrectly as a result. The following errors may be missed or incorrectly classified: + - [`alloc_dealloc_mismatch`](error-alloc-dealloc-mismatch.md) + - [`double-free`](error-double-free.md) + - [`heap-use-after-free`](error-heap-use-after-free.md) + - [`heap-buffer-overflow`](error-heap-buffer-overflow.md) + - [`new-delete-type-mismatch`](error-new-delete-type-mismatch.md) ## Memory usage -The AddressSanitizer runtime doesn't release memory back to the OS during execution. From the OS's point of view, it may look like there's a memory leak. This design decision is intentional, so as not to allocate all the required memory up front. +The AddressSanitizer runtime doesn't release memory back to the OS during execution so that the memory isn't all allocated up front. From the OS's point of view, it may look like there's a memory leak. ## AddressSanitizer runtime DLL locations -The *`clang_rt.asan*.dll`* runtime files are installed next to the compilers in *`%VSINSTALLDIR%\VC\Tools\MSVC\\bin\\\`*. These locations are on the path in debugging sessions, and in Visual Studio developer command prompts. These files are never placed in *`C:\Windows\System32`* or *`C:\Windows\SysWOW64`*. +The *`clang_rt.asan*.dll`* runtime files are installed next to the compilers in *`%VSINSTALLDIR%\VC\Tools\MSVC\\bin\\\`*. These locations are on the path in debugging sessions and in Visual Studio developer command prompts. These files are never placed in *`C:\Windows\System32`* or *`C:\Windows\SysWOW64`*. ## Custom property sheet support -The Property Manager window in the Visual Studio IDE allows you to add custom *`.props`* files to your projects. Even though the **Enable Address Sanitizer** property (``) is shown, the build doesn't honor it. That's because the custom *`.props`* files get included after *`Microsoft.cpp.props`*, which uses the `` value to set other properties. +The Visual Studio Property Manager window allows you to add custom *`.props`* files to your projects. Even though the **Enable AddressSanitizer** property (``) is shown, the build doesn't honor it. The build doesn't honor it because the custom *`.props`* files are included after *`Microsoft.cpp.props`*, which uses the `` value to set other properties. + +As a workaround, create a *`Directory.Build.props`* file in the root of your project to define the `` property. For more information, see [Customize C++ builds](/visualstudio/msbuild/customize-your-build#customize-c-builds). + +## Thread local variables + +Thread local variables (global variables declared with `__declspec(thread)` or `thread_local`) aren't protected by AddressSanitizer. This limitation isn't specific to Windows or Microsoft Visual C++, but is a general limitation. + +## Custom code skips normal function return sequence + +Using custom code or assembly language to leave the current stack frame without honoring the usual return mechanisms isn't supported. For example, leaving the current stack frame via a long jump may generate false positives. + +Instead, before invoking custom long jump-like code, call [`__asan_handle_no_return()`](https://github.com/llvm/llvm-project/blob/ba84d0c8d762f093c6ef6d5ef5a446a42a8548a5/compiler-rt/include/sanitizer/asan_interface.h#L325-L330) . This function clears all of the shadow bytes associated with the current thread's stack, which results in some lost coverage and introduces the risk of false negatives. But your program can then safely unwind the stack without running into false positives due to stale stack shadow bytes. + +## Issues with partially sanitized executables + +If all of the code in a process isn't compiled with `/fsanitize=address`, ASan may not be able to diagnose all memory safety errors. The most common example is when a DLL compiled with ASan is loaded into a process that contains code not compiled with ASan. In this case, ASan attempts to categorize allocations that took place before ASan initialization. Once those allocations are reallocated, ASan tries to own and monitor the lifetime of the memory. + +If all of the DLLs compiled with ASan are unloaded from the process before the process ends, there may be crashes due to dangling references to intercepted functions such as `memcmp`, `memcpy`, `memmove`, and so on. For the best results, compile all modules under test with `/fsanitize=address`, or don't unload modules compiled with ASan after they enter the process. + +Please report any bugs to our [Developer Community](https://aka.ms/feedback/report?space=62). + +## ASan 64-bit first chance exceptions + +On x64, MSVC ASan's [shadow bytes](./asan-shadow-bytes.md) region occupies several terabytes of virtual address space. ASan doesn't pre-commit this memory. Instead, it uses on-demand paging. When a shadow page is accessed for the first time, a first-chance page fault exception occurs and is handled by ASan, which commits the page. -As a workaround, you can create a *`Directory.Build.props`* file in the root of your project to define the `` property. For more information, see [Customize C++ builds](/visualstudio/msbuild/customize-your-build#customize-c-builds). +The Visual Studio debugger handles this gracefully, and doesn't show these traces. However, debuggers like WinDbgX may break on every exception by default. Disabling breaking on first-chance exceptions is recommended. For example, in WinDbgX, this corresponds to the [`sxd av`](/windows-hardware/drivers/debuggercmds/sx--sxd--sxe--sxi--sxn--sxr--sx---set-exceptions-) command. ## See also -[AddressSanitizer overview](./asan.md)\ -[AddressSanitizer build and language reference](./asan-building.md)\ -[AddressSanitizer runtime reference](./asan-runtime.md)\ -[AddressSanitizer shadow bytes](./asan-shadow-bytes.md)\ -[AddressSanitizer cloud or distributed testing](./asan-offline-crash-dumps.md)\ -[AddressSanitizer debugger integration](./asan-debugger-integration.md)\ -[AddressSanitizer error examples](./asan-error-examples.md) +[AddressSanitizer overview](asan.md)\ +[AddressSanitizer build and language reference](asan-building.md)\ +[AddressSanitizer runtime reference](asan-runtime.md)\ +[AddressSanitizer shadow bytes](asan-shadow-bytes.md)\ +[AddressSanitizer cloud or distributed testing](asan-offline-crash-dumps.md)\ +[AddressSanitizer debugger integration](asan-debugger-integration.md)\ +[AddressSanitizer error examples](asan-error-examples.md) diff --git a/docs/sanitizers/asan-runtime.md b/docs/sanitizers/asan-runtime.md index 88d62f6be7f..4ac0c904d8c 100644 --- a/docs/sanitizers/asan-runtime.md +++ b/docs/sanitizers/asan-runtime.md @@ -7,17 +7,17 @@ helpviewer_keywords: ["AddressSanitizer runtime", "Address Sanitizer runtime", " # AddressSanitizer runtime -The AddressSanitizer runtime library intercepts common memory allocation functions and operations to enable inspection of memory accesses. There are several different runtime libraries that support the various types of executables the compiler may generate. The compiler and linker automatically link the appropriate runtime libraries, as long as you pass the [`/fsanitize=address`](../build/reference/fsanitize.md) option at compile time. You can override the default behavior by using the **`/NODEFAULTLIB`** option at link time. For more information, see the section on [linking](./asan-building.md#linker) in the [AddressSanitizer language, build, and debugging reference](./asan-building.md). +The AddressSanitizer runtime library intercepts common memory allocation functions and operations to enable inspection of memory accesses. There are several different runtime libraries that support the various types of executables the compiler may generate. The compiler and linker automatically link the appropriate runtime libraries, as long as you pass the [`/fsanitize=address`](../build/reference/fsanitize.md) option at compile time. You can override the default behavior by using the **`/NODEFAULTLIB`** option at link time. For more information, see the section on [linking](asan-building.md#linker) in the [AddressSanitizer language, build, and debugging reference](asan-building.md). -When compiling with `cl /fsanitize=address`, the compiler generates instructions to manage and check [shadow bytes](./asan-shadow-bytes.md). Your program uses this instrumentation to check memory accesses on the stack, in the heap, or in the global scope. The compiler also produces metadata describing stack and global variables. This metadata enables the runtime to generate precise error diagnostics: function names, lines, and columns in your source code. Combined, the compiler checks and runtime libraries can precisely diagnose many types of [memory safety bugs](./asan-error-examples.md) if they're encountered at run-time. +When compiling with `cl /fsanitize=address`, the compiler generates instructions to manage and check [shadow bytes](asan-shadow-bytes.md). Your program uses this instrumentation to check memory accesses on the stack, in the heap, or in the global scope. The compiler also produces metadata describing stack and global variables. This metadata enables the runtime to generate precise error diagnostics: function names, lines, and columns in your source code. Combined, the compiler checks and runtime libraries can precisely diagnose many types of [memory safety bugs](asan-error-examples.md) if they're encountered at run-time. -The list of runtime libraries for linking to the AddressSanitizer runtime, as of Visual Studio 17.7 Preview 3, follows. For more information about the `/MT` (statically link the runtime) and `/MD` (dynamically link the redist at runtime) options, see [/MD, /MT, /LD (Use Run-Time Library)](../build/reference/md-mt-ld-use-run-time-library.md). +The list of runtime libraries for linking to the AddressSanitizer runtime, as of Visual Studio 17.7 Preview 3, follows. For more information about the `/MT` (statically link the runtime) and `/MD` (dynamically link the redist at runtime) options, see [`/MD`, `/MT`, `/LD` (Use Run-Time Library)](../build/reference/md-mt-ld-use-run-time-library.md). > [!NOTE] > In the following table, *`{arch}`* is either *`i386`* or *`x86_64`*. > These libraries use Clang conventions for architecture names. MSVC conventions are normally `x86` and `x64` rather than `i386` and `x86_64`, but they refer to the same architectures. -| CRT option | AddressSanitizer runtime library (.lib) | Address runtime binary (.dll) +| CRT option | AddressSanitizer runtime library (`.lib`) | Address runtime binary (`.dll`) |--|--|--| | `/MT` or `/MTd` | *`clang_rt.asan_dynamic-{arch}`*, *`clang_rt.asan_static_runtime_thunk-{arch}`* | *`clang_rt.asan_dynamic-{arch}`* | `/MD` or `/MDd` | *`clang_rt.asan_dynamic-{arch}`*, *`clang_rt.asan_dynamic_runtime_thunk-{arch}`* | *`clang_rt.asan_dynamic-{arch}`* @@ -31,7 +31,7 @@ The image shows three scenarios for linking the runtime library. The first is /M The following diagram shows how the ASan library is linked for various compiler options: :::image type="complex" source="media/asan-one-dll.png" alt-text="Diagram of how the ASan runtime dll is linked." -The image shows four scenarios for linking the ASan runtime library. The scenarios are for /MT (statically link the runtime), /MTd (statically link the debug runtime), /MD (dynamically link the redist at runtime), /MDd (dynamically link the debug redist at runtime). In all cases, my_exe.exe links and its associates my_dll.dll link to a single instance of clang-rt.asan-dynamix-x86_64.dll. +The image shows four scenarios for linking the ASan runtime library. The scenarios are for /MT (statically link the runtime), /MTd (statically link the debug runtime), /MD (dynamically link the redist at runtime), /MDd (dynamically link the debug redist at runtime). In all cases, my_exe.exe links and its associates my_dll.dll link to a single instance of clang_rt.asan_dynamic-x86_64.dll. :::image-end::: Even when statically linking, the ASan runtime DLL must be present at runtime--unlike other C Runtime components. @@ -40,7 +40,7 @@ Even when statically linking, the ASan runtime DLL must be present at runtime--u Before Visual Studio 17.7 Preview 3, statically linked (**`/MT`** or **`/MTd`**) builds didn't use a DLL dependency. Instead, the AddressSanitizer runtime was statically linked into the user's EXE. DLL projects would then load exports from the user's EXE to access ASan functionality. -Dynamically linked projects (**`/MD`** or **`/MDd`**) used different libraries and DLLs depending on whether the project was configured for debug or release. For more information about these changes and their motivations, see [MSVC Address Sanitizer – One DLL for all Runtime Configurations](https://devblogs.microsoft.com/cppblog/msvc-address-sanitizer-one-dll-for-all-runtime-configurations/). +Dynamically linked projects (**`/MD`** or **`/MDd`**) used different libraries and DLLs depending on whether the project was configured for debug or release. For more information about these changes and their motivations, see [MSVC AddressSanitizer – One DLL for all Runtime Configurations](https://devblogs.microsoft.com/cppblog/msvc-address-sanitizer-one-dll-for-all-runtime-configurations/). The following table describes the previous behavior of the AddressSanitizer runtime library linking, before Visual Studio 17.7 Preview 3: @@ -63,7 +63,7 @@ The image shows four scenarios for linking the ASan runtime library. The scenari The AddressSanitizer achieves function interception through many hotpatching techniques. These techniques are [best documented within the source code itself](https://github.com/llvm/llvm-project/blob/1a2eaebc09c6a200f93b8beb37130c8b8aab3934/compiler-rt/lib/interception/interception_win.cpp#L11). -The runtime libraries intercept many common memory management and memory manipulation functions. For a list, see [AddressSanitizer list of intercepted functions](#intercepted_functions). The allocation interceptors manage metadata and shadow bytes related to each allocation call. Every time a CRT function such as `malloc` or `delete` is called, the interceptors set specific values in the AddressSanitizer shadow-memory region to indicate whether those heap locations are currently accessible and what the bounds of the allocation are. These shadow bytes allow the compiler-generated checks of the [shadow bytes](./asan-shadow-bytes.md) to determine whether a load or store is valid. +The runtime libraries intercept many common memory management and memory manipulation functions. For a list, see [AddressSanitizer list of intercepted functions](#intercepted_functions). The allocation interceptors manage metadata and shadow bytes related to each allocation call. Every time a CRT function such as `malloc` or `delete` is called, the interceptors set specific values in the AddressSanitizer shadow-memory region to indicate whether those heap locations are currently accessible and what the bounds of the allocation are. These shadow bytes allow the compiler-generated checks of the [shadow bytes](asan-shadow-bytes.md) to determine whether a load or store is valid. Interception isn't guaranteed to succeed. If a function prologue is too short for a `jmp` to be written, interception can fail. If an interception failure occurs, the program throws a `debugbreak` and halts. If you attach a debugger, it makes the cause of the interception issue clear. If you have this problem, [report a bug](https://aka.ms/feedback/report?space=62). @@ -72,7 +72,7 @@ Interception isn't guaranteed to succeed. If a function prologue is too short fo ## Custom allocators and the AddressSanitizer runtime -The AddressSanitizer runtime provides interceptors for common allocator interfaces, `malloc`/`free`, `new`/`delete`, `HeapAlloc`/`HeapFree` (via `RtlAllocateHeap`/`RtlFreeHeap`). Many programs make use of custom allocators for one reason or another, an example would be any program using `dlmalloc` or a solution using the `std::allocator` interface and `VirtualAlloc()`. The compiler is unable to automatically add shadow-memory management calls to a custom allocator. It's the user's responsibility to use the [provided manual poisoning interface](#poisoning). This API enables these allocators to function properly with the existing AddressSanitizer runtime and [shadow byte](./asan-shadow-bytes.md) conventions. +The AddressSanitizer runtime provides interceptors for common allocator interfaces, `malloc`/`free`, `new`/`delete`, `HeapAlloc`/`HeapFree` (via `RtlAllocateHeap`/`RtlFreeHeap`). Many programs make use of custom allocators for one reason or another, an example would be any program using `dlmalloc` or a solution using the `std::allocator` interface and `VirtualAlloc()`. The compiler is unable to automatically add shadow-memory management calls to a custom allocator. It's the user's responsibility to use the [provided manual poisoning interface](#poisoning). This API enables these allocators to function properly with the existing AddressSanitizer runtime and [shadow byte](asan-shadow-bytes.md) conventions. ## Manual AddressSanitizer poisoning interface @@ -90,20 +90,49 @@ For convenience, the [AddressSanitizer interface header file](https://github.com #define ASAN_UNPOISON_MEMORY_REGION(addr, size) ``` +> [!NOTE] +> If you manually poison memory, you must unpoison it before reuse. This is especially important for stack addresses, such as for a local variable, which are frequently reused during program execution. You risk introducing `use-after-poison` false positives in manually poisoned stack addresses if you don't unpoison them before their stack frame is removed. + ## Alignment requirements for AddressSanitizer poisoning Any manual poisoning of shadow bytes must consider the alignment requirements. The user must add padding if necessary so the shadow bytes end on a byte boundary in the shadow memory. Each bit in the AddressSanitizer shadow memory encodes the state of a single byte in the application's memory. This encoding means the total size of each allocation, including any padding, must align to an 8-byte boundary. If the alignment requirement isn't satisfied, it can lead to incorrect bug reporting. The incorrect reporting could manifest as missing reports (false negatives) or reports on non-errors (false-positives). For an illustration of the alignment requirement and potential issues, see the provided [ASan alignment examples](https://github.com/mcgov/asan_alignment_example). One is a small program to show what can go wrong with manual shadow memory poisoning. The second is an example implementation of manual poisoning using the `std::allocator` interface. -## Run-time options +## Runtime options + +MSVC AddressSanitizer is a regularly synced fork of the [Clang AddressSanitizer runtime](https://github.com/llvm/llvm-project). As a result, MSVC implicitly inherits many of Clang's ASan runtime options. A complete list of options that we actively maintain and test can be found [here](./asan-flags.md). If you discover options that don't function as expected, [report a bug](https://aka.ms/feedback/report?space=62). + + +### Configure runtime options + +ASan runtime options are set in one of two ways: +- The `ASAN_OPTIONS` environment variable +- The `__asan_default_options` user function + +If the environment variable and the user function specify conflicting options, the options in the `ASAN_OPTIONS` environment variable take precedence. + +Multiple options are specified by separating them with a colon (`:`). -Microsoft C/C++ (MSVC) uses a runtime based on the [Clang AddressSanitizer runtime from the llvm-project repository](https://github.com/llvm/llvm-project). Because of this, most runtime options are shared between the two versions. [A complete list of the public Clang runtime options is available here](https://github.com/google/sanitizers/wiki/SanitizerCommonFlags). We document some differences in the sections that follow. If you discover options that don't function as expected, [report a bug](https://aka.ms/feedback/report?space=62). +The following example sets [`alloc_dealloc_mismatch`](error-alloc-dealloc-mismatch.md) to one and `symbolize` to zero: + +```cmd +set ASAN_OPTIONS=alloc_dealloc_mismatch=1:symbolize=0 +``` + +Or add the following function to your code: + +```cpp +extern "C" const char* __asan_default_options() +{ + return "alloc_dealloc_mismatch=1:symbolize=0"; +} +``` ### Unsupported AddressSanitizer options -- detect_container_overflow -- unmap_shadow_on_exit +- `detect_container_overflow` +- `unmap_shadow_on_exit` > [!NOTE] > The AddressSanitizer runtime option `halt_on_error` doesn't function the way you might expect. In both the Clang and the MSVC runtime libraries, many error types are considered **non-continuable**, including most memory corruption errors. @@ -112,13 +141,9 @@ For more information, see the [Differences with Clang 12.0](asan.md#differences) ### MSVC-specific AddressSanitizer runtime options -- `windows_hook_legacy_allocators` - Boolean, set to `false` to disable interception of [`GlobalAlloc`](/windows/win32/api/winbase/nf-winbase-globalalloc) and [`LocalAlloc`](/windows/win32/api/winbase/nf-winbase-localalloc) allocators. +- [`continue_on_error`](asan-continue-on-error.md) Boolean, set to `false` by default. When set to `true`, it allows the program to continue executing after a memory violation is reported, allowing you to collect multiple error reports. + - > [!NOTE] - > The option `windows_hook_legacy_allocators` wasn't available in the public llvm-project runtime when this article was written. The option may eventually be contributed back to the public project; however, it's dependent on code review and community acceptance. - > - > The option `windows_hook_rtl_allocators`, previously an opt-in feature while AddressSanitizer was experimental, is now enabled by default. In versions before Visual Studio 2022 version 17.4.6, the default option value is `false`. In Visual Studio 2022 version 17.4.6 and later versions, the option `windows_hook_rtl_allocators` defaults to `true`. - `iat_overwrite` String, set to `"error"` by default. Other possible values are `"protect"` and `"ignore"`. Some modules may overwrite the [`import address table`](/windows/win32/debug/pe-format#import-address-table) of other modules to customize implementations of certain functions. For example, drivers commonly provide custom implementations for specific hardware. The `iat_overwrite` option manages the AddressSanitizer runtime's protection against overwrites for specific [`memoryapi.h`](/windows/win32/api/memoryapi/) functions. The runtime currently tracks the [`VirtualAlloc`](/windows/win32/api/memoryapi/nf-memoryapi-virtualalloc), [`VirtualProtect`](/windows/win32/api/memoryapi/nf-memoryapi-virtualprotect), and [`VirtualQuery`](/windows/win32/api/memoryapi/nf-memoryapi-virtualquery) functions for protection. This option is available in Visual Studio 2022 version 17.5 Preview 1 and later versions. The following `iat_overwrite` values control how the runtime reacts when protected functions are overwritten: @@ -128,9 +153,19 @@ For more information, see the [Differences with Clang 12.0](asan.md#differences) - If set to `"ignore"`, the runtime doesn't attempt to correct any overwritten functions and proceeds with execution. - `windows_fast_fail_on_error` -Boolean (false by default), set to `true` to enable the process to terminate with a __fastfail(71) after printing the error report. ->[!NOTE] ->When abort_on_error value is set to true, on Windows the program terminates with an exit(3). In order to not change current behavior we decided to introduce this new option instead. If both abort_on_error and windows_fast_fail_on_error are true, the program will exit with the __fastfail. + Boolean (`false` by default), set to `true` to enable the process to terminate with a `__fastfail(71)` after printing the error report. + + > [!NOTE] + > When `abort_on_error` value is set to `true`, on Windows the program terminates with an `exit(3)`. In order to not change current behavior we decided to introduce this new option instead. If both `abort_on_error` and `windows_fast_fail_on_error` are `true`, the program will exit with the `__fastfail`. + +- `windows_hook_legacy_allocators` + Boolean, set to `false` to disable interception of [`GlobalAlloc`](/windows/win32/api/winbase/nf-winbase-globalalloc) and [`LocalAlloc`](/windows/win32/api/winbase/nf-winbase-localalloc) allocators. + + > [!NOTE] + > The option `windows_hook_legacy_allocators` wasn't available in the public llvm-project runtime when this article was written. The option may eventually be contributed back to the public project; however, it's dependent on code review and community acceptance. + > + > The option `windows_hook_rtl_allocators`, previously an opt-in feature while AddressSanitizer was experimental, is now enabled by default. In versions before Visual Studio 2022 version 17.4.6, the default option value is `false`. In Visual Studio 2022 version 17.4.6 and later versions, the option `windows_hook_rtl_allocators` defaults to `true`. + ## AddressSanitizer list of intercepted functions (Windows) @@ -184,7 +219,7 @@ The AddressSanitizer runtime hotpatches many functions to enable memory safety c - [`realloc`](../c-runtime-library/reference/realloc.md) - [`RtlAllocateHeap`](/windows-hardware/drivers/ddi/ntifs/nf-ntifs-rtlallocateheap) - [`RtlCreateHeap`](/windows-hardware/drivers/ddi/ntifs/nf-ntifs-rtlcreateheap) -- [`RtlDestroyHeap`](/windows-hardware/drivers/ddi/ntifs/nf-ntifs-rtlcreateheap) +- [`RtlDestroyHeap`](/windows-hardware/drivers/ddi/ntifs/nf-ntifs-rtldestroyheap) - [`RtlFreeHeap`](/windows-hardware/drivers/ddi/ntifs/nf-ntifs-rtlfreeheap) - [`RtlRaiseException`](/windows/win32/api/rtlsupportapi/nf-rtlsupportapi-rtlraiseexception) - `RtlReAllocateHeap` (undocumented) @@ -215,26 +250,26 @@ The interceptors listed here are only installed when an AddressSanitizer runtime `set ASAN_OPTIONS=windows_hook_legacy_allocators=false` - [`GlobalAlloc`](/windows/win32/api/winbase/nf-winbase-globalalloc) -- [`GlobalFree`](/windows/win32/api/winbase/nf-winbase-GlobalFree) -- [`GlobalHandle`](/windows/win32/api/winbase/nf-winbase-GlobalHandle) -- [`GlobalLock`](/windows/win32/api/winbase/nf-winbase-GlobalLock) -- [`GlobalReAlloc`](/windows/win32/api/winbase/nf-winbase-GlobalReAlloc) -- [`GlobalSize`](/windows/win32/api/winbase/nf-winbase-GlobalSize) -- [`GlobalUnlock`](/windows/win32/api/winbase/nf-winbase-GlobalUnlock) -- [`LocalAlloc`](/windows/win32/api/winbase/nf-winbase-LocalAlloc) -- [`LocalFree`](/windows/win32/api/winbase/nf-winbase-LocalFree) -- [`LocalHandle`](/windows/win32/api/winbase/nf-winbase-LocalHandle) -- [`LocalLock`](/windows/win32/api/winbase/nf-winbase-LocalLock) -- [`LocalReAlloc`](/windows/win32/api/winbase/nf-winbase-LocalReAlloc) -- [`LocalSize`](/windows/win32/api/winbase/nf-winbase-LocalSize) -- [`LocalUnlock`](/windows/win32/api/winbase/nf-winbase-LocalUnlock) +- [`GlobalFree`](/windows/win32/api/winbase/nf-winbase-globalfree) +- [`GlobalHandle`](/windows/win32/api/winbase/nf-winbase-globalhandle) +- [`GlobalLock`](/windows/win32/api/winbase/nf-winbase-globallock) +- [`GlobalReAlloc`](/windows/win32/api/winbase/nf-winbase-globalrealloc) +- [`GlobalSize`](/windows/win32/api/winbase/nf-winbase-globalsize) +- [`GlobalUnlock`](/windows/win32/api/winbase/nf-winbase-globalunlock) +- [`LocalAlloc`](/windows/win32/api/winbase/nf-winbase-localalloc) +- [`LocalFree`](/windows/win32/api/winbase/nf-winbase-localfree) +- [`LocalHandle`](/windows/win32/api/winbase/nf-winbase-localhandle) +- [`LocalLock`](/windows/win32/api/winbase/nf-winbase-locallock) +- [`LocalReAlloc`](/windows/win32/api/winbase/nf-winbase-localrealloc) +- [`LocalSize`](/windows/win32/api/winbase/nf-winbase-localsize) +- [`LocalUnlock`](/windows/win32/api/winbase/nf-winbase-localunlock) ## See also -[AddressSanitizer overview](./asan.md)\ -[AddressSanitizer known issues](./asan-known-issues.md)\ -[AddressSanitizer build and language reference](./asan-building.md)\ -[AddressSanitizer shadow bytes](./asan-shadow-bytes.md)\ -[AddressSanitizer cloud or distributed testing](./asan-offline-crash-dumps.md)\ -[AddressSanitizer debugger integration](./asan-debugger-integration.md)\ -[AddressSanitizer error examples](./asan-error-examples.md) +[AddressSanitizer overview](asan.md)\ +[AddressSanitizer known issues](asan-known-issues.md)\ +[AddressSanitizer build and language reference](asan-building.md)\ +[AddressSanitizer shadow bytes](asan-shadow-bytes.md)\ +[AddressSanitizer cloud or distributed testing](asan-offline-crash-dumps.md)\ +[AddressSanitizer debugger integration](asan-debugger-integration.md)\ +[AddressSanitizer error examples](asan-error-examples.md) diff --git a/docs/sanitizers/asan-shadow-bytes.md b/docs/sanitizers/asan-shadow-bytes.md index 9b6b747e249..a59597629b8 100644 --- a/docs/sanitizers/asan-shadow-bytes.md +++ b/docs/sanitizers/asan-shadow-bytes.md @@ -7,7 +7,7 @@ helpviewer_keywords: ["Shadow bytes", "AddressSanitizer shadow bytes","Address S # AddressSanitizer shadow bytes -We briefly summarize the concept of shadow bytes and how they can be used by the runtime implementation of [`/fsanitize=address`](../build/reference/fsanitize.md). For further details, we refer you to the initial research [AddressSanitizer - Serebryany, et al](https://www.usenix.org/system/files/conference/atc12/atc12-final39.pdf) and the [current AddressSanitizer algorithm documentation](https://github.com/google/sanitizers/wiki/AddressSanitizerAlgorithm). +We briefly summarize the concept of shadow bytes and how they can be used by the runtime implementation of [`/fsanitize=address`](../build/reference/fsanitize.md). For further details, we refer you to the initial research [AddressSanitizer - Serebryany, et al](https://www.usenix.org/system/files/conference/atc12/atc12-final39.pdf) and the [current AddressSanitizer algorithm documentation](https://github.com/google/sanitizers/wiki/AddressSanitizerAlgorithm). ## Core concept @@ -19,6 +19,9 @@ One shadow byte describes how many bytes are currently accessible as follows: - 1-7 means one to seven bytes - Negative numbers encode context for the runtime to use for reporting diagnostics. +> [!NOTE] +> By default, entries in the shadow memory are zero-initialized. Therefore, ASan assumes that the memory is _addressable_ by default, i.e. valid to read and write. The shadow bytes will be populated with non-zero values as the program executes and the lifetime of variables and other allocations come to an end. + ### Shadow byte legend Consider this shadow byte legend where all negative numbers are defined: diff --git a/docs/sanitizers/asan.md b/docs/sanitizers/asan.md index 3de64921d48..80f2a55b825 100644 --- a/docs/sanitizers/asan.md +++ b/docs/sanitizers/asan.md @@ -84,7 +84,10 @@ This article covers the information you require to enable the three workflows li ## Use AddressSanitizer from a developer command prompt -Use the **`/fsanitize=address`** compiler option in a [developer command prompt](../build/building-on-the-command-line.md#developer_command_prompt_shortcuts) to enable compiling for the AddressSanitizer runtime. The **`/fsanitize=address`** option is compatible with all existing C++ or C optimization levels (for example, `/Od`, `/O1`, `/O2`, `/O2 /GL`, and `PGO`). The option works with static and dynamic CRTs (for example, `/MD`, `/MDd`, `/MT`, and `/MTd`). It works whether you create an EXE or a DLL. Debug information is required for optimal formatting of call stacks. In the following example, `cl /fsanitize=address /Zi` is passed on the command line. +Use the **`/fsanitize=address`** compiler option in a [developer command prompt](../build/building-on-the-command-line.md#developer_command_prompt_shortcuts) to enable compiling for the AddressSanitizer runtime. The **`/fsanitize=address`** option is compatible with existing C++ or C optimization levels (for example, `/Od`, `/O1`, `/O2`, and `/O2 /GL`). The option works with static and dynamic CRTs (for example, `/MD`, `/MDd`, `/MT`, and `/MTd`). It works whether you create an EXE or a DLL. Debug information is required for optimal formatting of call stacks. In the following example, `cl /fsanitize=address /Zi` is passed on the command line. + +> [!NOTE] +> AddressSanitizer doesn't support Profile-guided optimization (PGO). AddressSanitizer shouldn't be used in production. The AddressSanitizer libraries (.lib files) are linked for you automatically. For more information, see [AddressSanitizer language, build, and debugging reference](asan-building.md). @@ -134,7 +137,7 @@ AddressSanitizer is integrated with the Visual Studio IDE. To turn on AddressSan To build from the IDE, opt out of any [incompatible options](./asan-known-issues.md#incompatible-options). For an existing project compiled by using **`/Od`** (or Debug mode), you may need to turn off these options: -- Turn off [edit and continue](/visualstudio/debugger/how-to-enable-and-disable-edit-and-continue) +- Turn off [`/ZI` (Debug Information Format)](../build/reference/z7-zi-zi-debug-information-format.md) - Turn off [`/RTC1` (runtime checks)](../build/reference/rtc-run-time-error-checks.md) - Turn off [`/INCREMENTAL` (incremental linking)](../build/reference/incremental-link-incrementally.md) @@ -154,7 +157,7 @@ To enable AddressSanitizer for a [CMake project created to target Windows](../bu 1. Choose the **Edit JSON** link in the editor. This selection switches the view to raw JSON. -1. Add the following snippet to the `"windows-base"` preset, inside `"configurePresets":` to turn on Address Sanitizer: +1. Add the following snippet to the `"windows-base"` preset, inside `"configurePresets":` to turn on AddressSanitizer: ```json "environment": { @@ -189,7 +192,7 @@ To enable AddressSanitizer for a [CMake project created to target Windows](../bu }, ``` -1. Address sanitizer doesn't work if edit-and-continue is specified (`/ZI`), which is enabled by default for new CMake projects. In `CMakeLists.txt`, comment out (prefix with `#`) the line that starts with `set(CMAKE_MSVC_DEBUG_INFORMATION_FORMAT"`. That line looks something like this, afterwards: +1. AddressSanitizer doesn't work if edit-and-continue is specified (`/ZI`), which is enabled by default for new CMake projects. In `CMakeLists.txt`, comment out (prefix with `#`) the line that starts with `set(CMAKE_MSVC_DEBUG_INFORMATION_FORMAT"`. That line looks something like this, afterwards: ```json # set(CMAKE_MSVC_DEBUG_INFORMATION_FORMAT "$,$>,$<$:EditAndContinue>,$<$:ProgramDatabase>>") diff --git a/docs/sanitizers/error-alloc-dealloc-mismatch.md b/docs/sanitizers/error-alloc-dealloc-mismatch.md index 906017a981d..2e717e964f2 100644 --- a/docs/sanitizers/error-alloc-dealloc-mismatch.md +++ b/docs/sanitizers/error-alloc-dealloc-mismatch.md @@ -1,7 +1,7 @@ --- title: "Error: alloc-dealloc-mismatch" -description: "Source examples and live debug screenshots for alloc-dealloc-mismatch errors." -ms.date: 03/02/2021 +description: "Learn about the alloc-dealloc-mismatch Address Sanitizer error." +ms.date: 05/28/2025 f1_keywords: ["alloc-dealloc-mismatch"] helpviewer_keywords: ["alloc-dealloc-mismatch error", "AddressSanitizer error alloc-dealloc-mismatch"] --- @@ -9,38 +9,44 @@ helpviewer_keywords: ["alloc-dealloc-mismatch error", "AddressSanitizer error al > Address Sanitizer Error: Mismatch between allocation and deallocation APIs -The `alloc`/`dealloc` mismatch functionality in AddressSanitizer is off by default for Windows. To enable it, run `set ASAN_OPTIONS=alloc_dealloc_mismatch=1` before running the program. This environment variable is checked at runtime to report errors on `malloc`/`delete`, `new`/`free`, and `new`/`delete[]`. +## Remarks + +Enables runtime detection of mismatched memory operations that may lead to undefined behavior, such as: +- `malloc` must be paired with `free`, not `delete` or `delete[]`. +- `new` must be paired with `delete`, not `free` or `delete[]`. +- `new[]` must be paired with `delete[]`, not `delete` or `free`. + +In Windows, `alloc-dealloc-mismatch` error detection is off by default. To enable it, set the environment variable `set ASAN_OPTIONS=alloc_dealloc_mismatch=1` before running your program. ## Example ```cpp // example1.cpp -// alloc-dealloc-mismatch error +// Demonstrate alloc-dealloc-mismatch error #include #include -int main(int argc, char* argv[]) { - +int main(int argc, char* argv[]) +{ if (argc != 2) return -1; - switch (atoi(argv[1])) { - - case 1: - delete[](new int[10]); - break; - case 2: - delete (new int[10]); // Boom! - break; - default: - printf("arguments: 1: no error 2: runtime error\n"); - return -1; + switch (atoi(argv[1])) + { + case 1: + delete[](new int[10]); + break; + case 2: + delete (new int[10]); // Boom! + break; + default: + printf("arguments: 1: no error 2: runtime error\n"); + return -1; } - return 0; } ``` -To build and test this example, run these commands in a Visual Studio 2019 version 16.9 or later [developer command prompt](../build/building-on-the-command-line.md#developer_command_prompt_shortcuts): +In a Visual Studio 2019 version 16.9 or later [developer command prompt](../build/building-on-the-command-line.md#developer_command_prompt_shortcuts), run the following commands to see an example of `alloc_dealloc_mismatch`: ```cmd cl example1.cpp /fsanitize=address /Zi @@ -48,17 +54,17 @@ set ASAN_OPTIONS=alloc_dealloc_mismatch=1 devenv /debugexe example1.exe 2 ``` -### Resulting error +### Output -:::image type="content" source="media/alloc-dealloc-mismatch-example-1.png" alt-text="Screenshot of debugger displaying alloc-dealloc-mismatch error in example 1."::: +:::image type="content" source="media/alloc-dealloc-mismatch-example-1.png" alt-text="Screenshot of debugger displaying alloc-dealloc-mismatch error in example 1." lightbox="media/alloc-dealloc-mismatch-example-1.png"::: ## See also -[AddressSanitizer overview](./asan.md)\ -[AddressSanitizer known issues](./asan-known-issues.md)\ -[AddressSanitizer build and language reference](./asan-building.md)\ -[AddressSanitizer runtime reference](./asan-runtime.md)\ -[AddressSanitizer shadow bytes](./asan-shadow-bytes.md)\ -[AddressSanitizer cloud or distributed testing](./asan-offline-crash-dumps.md)\ -[AddressSanitizer debugger integration](./asan-debugger-integration.md)\ -[AddressSanitizer error examples](./asan-error-examples.md) +[AddressSanitizer overview](asan.md)\ +[AddressSanitizer known issues](asan-known-issues.md)\ +[AddressSanitizer build and language reference](asan-building.md)\ +[AddressSanitizer runtime reference](asan-runtime.md)\ +[AddressSanitizer shadow bytes](asan-shadow-bytes.md)\ +[AddressSanitizer cloud or distributed testing](asan-offline-crash-dumps.md)\ +[AddressSanitizer debugger integration](asan-debugger-integration.md)\ +[AddressSanitizer error examples](asan-error-examples.md) diff --git a/docs/sanitizers/error-allocation-size-too-big.md b/docs/sanitizers/error-allocation-size-too-big.md index 9e5e7a02d22..8cfe9d85383 100644 --- a/docs/sanitizers/error-allocation-size-too-big.md +++ b/docs/sanitizers/error-allocation-size-too-big.md @@ -1,6 +1,6 @@ --- title: "Error: allocation-size-too-big" -description: "Source examples and live debug screenshots for allocation-size-too-big errors." +description: "Learn about the allocation-size-too-big Address Sanitizer error." ms.date: 03/02/2021 f1_keywords: ["allocation-size-too-big"] helpviewer_keywords: ["allocation-size-too-big error", "AddressSanitizer error allocation-size-too-big"] @@ -10,6 +10,8 @@ helpviewer_keywords: ["allocation-size-too-big error", "AddressSanitizer error a > Address Sanitizer Error: allocation-size-too-big +## Remarks + This example shows the error found when an allocation is too large for the heap. Example sourced from [LLVM compiler-rt test suite](https://github.com/llvm/llvm-project/tree/main/compiler-rt/test/asan/TestCases). ## Example @@ -50,11 +52,11 @@ devenv /debugexe example1.exe ## See also -[AddressSanitizer overview](./asan.md)\ -[AddressSanitizer known issues](./asan-known-issues.md)\ -[AddressSanitizer build and language reference](./asan-building.md)\ -[AddressSanitizer runtime reference](./asan-runtime.md)\ -[AddressSanitizer shadow bytes](./asan-shadow-bytes.md)\ -[AddressSanitizer cloud or distributed testing](./asan-offline-crash-dumps.md)\ -[AddressSanitizer debugger integration](./asan-debugger-integration.md)\ -[AddressSanitizer error examples](./asan-error-examples.md) +[AddressSanitizer overview](asan.md)\ +[AddressSanitizer known issues](asan-known-issues.md)\ +[AddressSanitizer build and language reference](asan-building.md)\ +[AddressSanitizer runtime reference](asan-runtime.md)\ +[AddressSanitizer shadow bytes](asan-shadow-bytes.md)\ +[AddressSanitizer cloud or distributed testing](asan-offline-crash-dumps.md)\ +[AddressSanitizer debugger integration](asan-debugger-integration.md)\ +[AddressSanitizer error examples](asan-error-examples.md) diff --git a/docs/sanitizers/error-calloc-overflow.md b/docs/sanitizers/error-calloc-overflow.md index 5c7ee450593..eff22183f37 100644 --- a/docs/sanitizers/error-calloc-overflow.md +++ b/docs/sanitizers/error-calloc-overflow.md @@ -1,6 +1,6 @@ --- title: "Error: calloc-overflow" -description: "Source examples and live debug screenshots for calloc overflow errors." +description: "Learn about the calloc-overflow Address Sanitizer error." ms.date: 03/02/2021 f1_keywords: ["calloc-overflow"] helpviewer_keywords: ["calloc-overflow error", "AddressSanitizer error calloc-overflow"] @@ -9,6 +9,8 @@ helpviewer_keywords: ["calloc-overflow error", "AddressSanitizer error calloc-ov > Address Sanitizer Error: calloc-overflow +## Remarks + The CRT function [`calloc`](../c-runtime-library/reference/calloc.md) creates an array in memory with elements initialized to 0. The arguments can create an internal error that leads to a NULL pointer as the return value. ## Example @@ -45,11 +47,11 @@ devenv /debugexe example1.exe ## See also -[AddressSanitizer overview](./asan.md)\ -[AddressSanitizer known issues](./asan-known-issues.md)\ -[AddressSanitizer build and language reference](./asan-building.md)\ -[AddressSanitizer runtime reference](./asan-runtime.md)\ -[AddressSanitizer shadow bytes](./asan-shadow-bytes.md)\ -[AddressSanitizer cloud or distributed testing](./asan-offline-crash-dumps.md)\ -[AddressSanitizer debugger integration](./asan-debugger-integration.md)\ -[AddressSanitizer error examples](./asan-error-examples.md) +[AddressSanitizer overview](asan.md)\ +[AddressSanitizer known issues](asan-known-issues.md)\ +[AddressSanitizer build and language reference](asan-building.md)\ +[AddressSanitizer runtime reference](asan-runtime.md)\ +[AddressSanitizer shadow bytes](asan-shadow-bytes.md)\ +[AddressSanitizer cloud or distributed testing](asan-offline-crash-dumps.md)\ +[AddressSanitizer debugger integration](asan-debugger-integration.md)\ +[AddressSanitizer error examples](asan-error-examples.md) diff --git a/docs/sanitizers/error-container-overflow.md b/docs/sanitizers/error-container-overflow.md index b458180a050..39b471251df 100644 --- a/docs/sanitizers/error-container-overflow.md +++ b/docs/sanitizers/error-container-overflow.md @@ -1,6 +1,6 @@ --- title: "Error: container-overflow" -description: "Source examples and live debug screenshots for container overflow errors." +description: "Learn about the container-overflow Address Sanitizer error." ms.date: 06/30/2023 f1_keywords: ["container-overflow", "mismatch detected for 'annotate_vector'", "_DISABLE_VECTOR_ANNOTATION"] helpviewer_keywords: ["container-overflow error", "AddressSanitizer error container-overflow", "mismatch detected for 'annotate_vector'", "_DISABLE_VECTOR_ANNOTATION"] @@ -10,6 +10,8 @@ helpviewer_keywords: ["container-overflow error", "AddressSanitizer error contai > Address Sanitizer Error: Container overflow +## Remarks + In Visual Studio 2022 version 17.2 and later, the Microsoft Visual C++ standard library (STL) is partially enlightened to work with the AddressSanitizer. The following container types have annotations to detect memory access issues: | Standard container type | Disable annotations macro | Supported in version | @@ -90,11 +92,11 @@ If you want the implementation to trust that your custom allocator is handling t ## See also -[AddressSanitizer overview](./asan.md)\ -[AddressSanitizer known issues](./asan-known-issues.md)\ -[AddressSanitizer build and language reference](./asan-building.md)\ -[AddressSanitizer runtime reference](./asan-runtime.md)\ -[AddressSanitizer shadow bytes](./asan-shadow-bytes.md)\ -[AddressSanitizer cloud or distributed testing](./asan-offline-crash-dumps.md)\ -[AddressSanitizer debugger integration](./asan-debugger-integration.md)\ -[AddressSanitizer error examples](./asan-error-examples.md) +[AddressSanitizer overview](asan.md)\ +[AddressSanitizer known issues](asan-known-issues.md)\ +[AddressSanitizer build and language reference](asan-building.md)\ +[AddressSanitizer runtime reference](asan-runtime.md)\ +[AddressSanitizer shadow bytes](asan-shadow-bytes.md)\ +[AddressSanitizer cloud or distributed testing](asan-offline-crash-dumps.md)\ +[AddressSanitizer debugger integration](asan-debugger-integration.md)\ +[AddressSanitizer error examples](asan-error-examples.md) diff --git a/docs/sanitizers/error-double-free.md b/docs/sanitizers/error-double-free.md index c60b825c648..7623468b3fe 100644 --- a/docs/sanitizers/error-double-free.md +++ b/docs/sanitizers/error-double-free.md @@ -1,15 +1,18 @@ --- title: "Error: double-free" -description: "Source examples and live debug screenshots for double free errors." +description: "Learn about the double-free Address Sanitizer error." ms.date: 03/02/2021 f1_keywords: ["double-free"] helpviewer_keywords: ["double-free error", "AddressSanitizer error double-free"] +ms.custom: sfi-image-nochange --- # Error: `double-free` > Address Sanitizer Error: Deallocation of freed memory +## Remarks + In C, you can call `free` erroneously. In C++, you can call `delete` more than once. In these examples, we show errors with `delete`, `free`, and `HeapCreate`. ## Example C++ - double `operator delete` @@ -105,11 +108,11 @@ devenv /debugexe example3.exe ## See also -[AddressSanitizer overview](./asan.md)\ -[AddressSanitizer known issues](./asan-known-issues.md)\ -[AddressSanitizer build and language reference](./asan-building.md)\ -[AddressSanitizer runtime reference](./asan-runtime.md)\ -[AddressSanitizer shadow bytes](./asan-shadow-bytes.md)\ -[AddressSanitizer cloud or distributed testing](./asan-offline-crash-dumps.md)\ -[AddressSanitizer debugger integration](./asan-debugger-integration.md)\ -[AddressSanitizer error examples](./asan-error-examples.md) +[AddressSanitizer overview](asan.md)\ +[AddressSanitizer known issues](asan-known-issues.md)\ +[AddressSanitizer build and language reference](asan-building.md)\ +[AddressSanitizer runtime reference](asan-runtime.md)\ +[AddressSanitizer shadow bytes](asan-shadow-bytes.md)\ +[AddressSanitizer cloud or distributed testing](asan-offline-crash-dumps.md)\ +[AddressSanitizer debugger integration](asan-debugger-integration.md)\ +[AddressSanitizer error examples](asan-error-examples.md) diff --git a/docs/sanitizers/error-dynamic-stack-buffer-overflow.md b/docs/sanitizers/error-dynamic-stack-buffer-overflow.md index 980851d524a..3ff4780ae61 100644 --- a/docs/sanitizers/error-dynamic-stack-buffer-overflow.md +++ b/docs/sanitizers/error-dynamic-stack-buffer-overflow.md @@ -1,6 +1,6 @@ --- title: "Error: dynamic-stack-buffer-overflow" -description: "Source examples and live debug screenshots for alloca errors." +description: "Learn about the dynamic-stack-buffer-overflow Address Sanitizer error." ms.date: 03/02/2021 f1_keywords: ["dynamic-stack-buffer-overflow"] helpviewer_keywords: ["dynamic-stack-buffer-overflow error", "AddressSanitizer error dynamic-stack-buffer-overflow"] @@ -9,6 +9,8 @@ helpviewer_keywords: ["dynamic-stack-buffer-overflow error", "AddressSanitizer e > Address Sanitizer Error: dynamic-stack-buffer-overflow +## Remarks + This example shows the error that results from a buffer access outside the bounds of a stack-allocated object. ## Example - `alloca` overflow (right) @@ -170,11 +172,11 @@ devenv /debugexe example3.exe ## See also -[AddressSanitizer overview](./asan.md)\ -[AddressSanitizer known issues](./asan-known-issues.md)\ -[AddressSanitizer build and language reference](./asan-building.md)\ -[AddressSanitizer runtime reference](./asan-runtime.md)\ -[AddressSanitizer shadow bytes](./asan-shadow-bytes.md)\ -[AddressSanitizer cloud or distributed testing](./asan-offline-crash-dumps.md)\ -[AddressSanitizer debugger integration](./asan-debugger-integration.md)\ -[AddressSanitizer error examples](./asan-error-examples.md) +[AddressSanitizer overview](asan.md)\ +[AddressSanitizer known issues](asan-known-issues.md)\ +[AddressSanitizer build and language reference](asan-building.md)\ +[AddressSanitizer runtime reference](asan-runtime.md)\ +[AddressSanitizer shadow bytes](asan-shadow-bytes.md)\ +[AddressSanitizer cloud or distributed testing](asan-offline-crash-dumps.md)\ +[AddressSanitizer debugger integration](asan-debugger-integration.md)\ +[AddressSanitizer error examples](asan-error-examples.md) diff --git a/docs/sanitizers/error-global-buffer-overflow.md b/docs/sanitizers/error-global-buffer-overflow.md index 9c94be6f3f7..68f2fbb17d9 100644 --- a/docs/sanitizers/error-global-buffer-overflow.md +++ b/docs/sanitizers/error-global-buffer-overflow.md @@ -1,6 +1,6 @@ --- title: "Error: global-buffer-overflow" -description: "Source examples and live debug screenshots for global variable overflow errors." +description: "Learn about the global-buffer-overflow Address Sanitizer error." ms.date: 03/02/2021 f1_keywords: ["global-buffer-overflow"] helpviewer_keywords: ["global-buffer-overflow error", "AddressSanitizer error global-buffer-overflow"] @@ -9,6 +9,8 @@ helpviewer_keywords: ["global-buffer-overflow error", "AddressSanitizer error gl > Address Sanitizer Error: Global buffer overflow +## Remarks + The compiler generates metadata for any variable in the `.data` or `.bss` sections. These variables have language scope of global or file static. They're allocated in memory before `main()` starts. Global variables in C are treated much differently than in C++. This difference is because of the complex rules for linking C. In C, a global variable can be declared in several source files, and each definition can have different types. The compiler can't see all the possible definitions at once, but the linker can. For C, the linker defaults to selecting the largest-sized variable out of all the different declarations. @@ -152,11 +154,11 @@ devenv /debugexe example3.exe -l ## See also -[AddressSanitizer overview](./asan.md)\ -[AddressSanitizer known issues](./asan-known-issues.md)\ -[AddressSanitizer build and language reference](./asan-building.md)\ -[AddressSanitizer runtime reference](./asan-runtime.md)\ -[AddressSanitizer shadow bytes](./asan-shadow-bytes.md)\ -[AddressSanitizer cloud or distributed testing](./asan-offline-crash-dumps.md)\ -[AddressSanitizer debugger integration](./asan-debugger-integration.md)\ -[AddressSanitizer error examples](./asan-error-examples.md) +[AddressSanitizer overview](asan.md)\ +[AddressSanitizer known issues](asan-known-issues.md)\ +[AddressSanitizer build and language reference](asan-building.md)\ +[AddressSanitizer runtime reference](asan-runtime.md)\ +[AddressSanitizer shadow bytes](asan-shadow-bytes.md)\ +[AddressSanitizer cloud or distributed testing](asan-offline-crash-dumps.md)\ +[AddressSanitizer debugger integration](asan-debugger-integration.md)\ +[AddressSanitizer error examples](asan-error-examples.md) diff --git a/docs/sanitizers/error-heap-buffer-overflow.md b/docs/sanitizers/error-heap-buffer-overflow.md index 10600d88071..728edfe0575 100644 --- a/docs/sanitizers/error-heap-buffer-overflow.md +++ b/docs/sanitizers/error-heap-buffer-overflow.md @@ -1,6 +1,6 @@ --- title: "Error: heap-buffer-overflow" -description: "Source examples and live debug screenshots for heap variable overflow errors." +description: "Learn about the heap-buffer-overflow Address Sanitizer error." ms.date: 03/02/2021 f1_keywords: ["heap-buffer-overflow"] helpviewer_keywords: ["heap-buffer-overflow error", "AddressSanitizer error heap-buffer-overflow"] @@ -9,6 +9,8 @@ helpviewer_keywords: ["heap-buffer-overflow error", "AddressSanitizer error heap > Address Sanitizer Error: Heap buffer overflow +## Remarks + This example demonstrates the error that results when a memory access occurs outside the bounds of a heap-allocated object. ## Example - classic heap buffer overflow @@ -109,11 +111,11 @@ devenv /debugexe example3.exe ## See also -[AddressSanitizer overview](./asan.md)\ -[AddressSanitizer known issues](./asan-known-issues.md)\ -[AddressSanitizer build and language reference](./asan-building.md)\ -[AddressSanitizer runtime reference](./asan-runtime.md)\ -[AddressSanitizer shadow bytes](./asan-shadow-bytes.md)\ -[AddressSanitizer cloud or distributed testing](./asan-offline-crash-dumps.md)\ -[AddressSanitizer debugger integration](./asan-debugger-integration.md)\ -[AddressSanitizer error examples](./asan-error-examples.md) +[AddressSanitizer overview](asan.md)\ +[AddressSanitizer known issues](asan-known-issues.md)\ +[AddressSanitizer build and language reference](asan-building.md)\ +[AddressSanitizer runtime reference](asan-runtime.md)\ +[AddressSanitizer shadow bytes](asan-shadow-bytes.md)\ +[AddressSanitizer cloud or distributed testing](asan-offline-crash-dumps.md)\ +[AddressSanitizer debugger integration](asan-debugger-integration.md)\ +[AddressSanitizer error examples](asan-error-examples.md) diff --git a/docs/sanitizers/error-heap-use-after-free.md b/docs/sanitizers/error-heap-use-after-free.md index dd02ecf33b4..6ddd65cbb5e 100644 --- a/docs/sanitizers/error-heap-use-after-free.md +++ b/docs/sanitizers/error-heap-use-after-free.md @@ -1,6 +1,6 @@ --- title: "Error: heap-use-after-free" -description: "Source examples and live debug screenshots for heap use after free errors." +description: "Learn about the heap-use-after-free Address Sanitizer error." ms.date: 04/06/2023 f1_keywords: ["heap-use-after-free"] helpviewer_keywords: ["heap-use-after-free error", "AddressSanitizer error heap-use-after-free"] @@ -9,6 +9,8 @@ helpviewer_keywords: ["heap-use-after-free error", "AddressSanitizer error heap- > Address Sanitizer Error: Use of deallocated memory +## Remarks + We show three examples where storage in the heap can be allocated via `malloc`, `realloc` (C), and `new` (C++), along with a mistaken use of `volatile`. ## Example - `malloc` @@ -144,11 +146,11 @@ The exception thrown dialog points to line 12, *x = 42, and says: Address Saniti ## See also -[AddressSanitizer overview](./asan.md)\ -[AddressSanitizer known issues](./asan-known-issues.md)\ -[AddressSanitizer build and language reference](./asan-building.md)\ -[AddressSanitizer runtime reference](./asan-runtime.md)\ -[AddressSanitizer shadow bytes](./asan-shadow-bytes.md)\ -[AddressSanitizer cloud or distributed testing](./asan-offline-crash-dumps.md)\ -[AddressSanitizer debugger integration](./asan-debugger-integration.md)\ -[AddressSanitizer error examples](./asan-error-examples.md) +[AddressSanitizer overview](asan.md)\ +[AddressSanitizer known issues](asan-known-issues.md)\ +[AddressSanitizer build and language reference](asan-building.md)\ +[AddressSanitizer runtime reference](asan-runtime.md)\ +[AddressSanitizer shadow bytes](asan-shadow-bytes.md)\ +[AddressSanitizer cloud or distributed testing](asan-offline-crash-dumps.md)\ +[AddressSanitizer debugger integration](asan-debugger-integration.md)\ +[AddressSanitizer error examples](asan-error-examples.md) diff --git a/docs/sanitizers/error-invalid-allocation-alignment.md b/docs/sanitizers/error-invalid-allocation-alignment.md index 2197383c97a..bb3a05c022f 100644 --- a/docs/sanitizers/error-invalid-allocation-alignment.md +++ b/docs/sanitizers/error-invalid-allocation-alignment.md @@ -1,6 +1,6 @@ --- title: "Error: invalid-allocation-alignment" -description: "Source examples and live debug screenshots for invalid _aligned_malloc errors." +description: "Learn about the invalid-allocation-alignment Address Sanitizer error." ms.date: 03/02/2021 f1_keywords: ["invalid-allocation-alignment"] helpviewer_keywords: ["invalid-allocation-alignment error", "AddressSanitizer error invalid-allocation-alignment"] @@ -9,6 +9,8 @@ helpviewer_keywords: ["invalid-allocation-alignment error", "AddressSanitizer er > Address Sanitizer Error: invalid-allocation-alignment +## Remarks + The [`_aligned_malloc`](../c-runtime-library/reference/aligned-malloc.md) function requires a power of 2 for expressing the alignment. We simulate the "external" calculation of some alignment factor using an unoptimized global variable. ## Example @@ -42,11 +44,11 @@ devenv /debugexe example1.exe ## See also -[AddressSanitizer overview](./asan.md)\ -[AddressSanitizer known issues](./asan-known-issues.md)\ -[AddressSanitizer build and language reference](./asan-building.md)\ -[AddressSanitizer runtime reference](./asan-runtime.md)\ -[AddressSanitizer shadow bytes](./asan-shadow-bytes.md)\ -[AddressSanitizer cloud or distributed testing](./asan-offline-crash-dumps.md)\ -[AddressSanitizer debugger integration](./asan-debugger-integration.md)\ -[AddressSanitizer error examples](./asan-error-examples.md) +[AddressSanitizer overview](asan.md)\ +[AddressSanitizer known issues](asan-known-issues.md)\ +[AddressSanitizer build and language reference](asan-building.md)\ +[AddressSanitizer runtime reference](asan-runtime.md)\ +[AddressSanitizer shadow bytes](asan-shadow-bytes.md)\ +[AddressSanitizer cloud or distributed testing](asan-offline-crash-dumps.md)\ +[AddressSanitizer debugger integration](asan-debugger-integration.md)\ +[AddressSanitizer error examples](asan-error-examples.md) diff --git a/docs/sanitizers/error-memcpy-param-overlap.md b/docs/sanitizers/error-memcpy-param-overlap.md index 27c4cd85823..005bde29ac8 100644 --- a/docs/sanitizers/error-memcpy-param-overlap.md +++ b/docs/sanitizers/error-memcpy-param-overlap.md @@ -1,6 +1,6 @@ --- title: "Error: memcpy-param-overlap" -description: "Source examples and live debug screenshots for memcpy parameter overlap errors." +description: "Learn about the memcpy-param-overlap Address Sanitizer error." ms.date: 03/02/2021 f1_keywords: ["memcpy-param-overlap"] helpviewer_keywords: ["memcpy-param-overlap error", "AddressSanitizer error memcpy-param-overlap"] @@ -9,6 +9,11 @@ helpviewer_keywords: ["memcpy-param-overlap error", "AddressSanitizer error memc > Address Sanitizer Error: memcpy-param-overlap +## Remarks + +> [!NOTE] +> The `/Oi` flag is required to reliably detect `memcpy-param-overlap` errors. This flag tells the compiler to treat `memcpy` and other functions as intrinsics, which is necessary because some versions of the standard library implement them as such. Since ASan is a dynamic analysis tool, it can only detect errors with an observable runtime effect. Note that when `/O2` is also set, ASan may not be able to reliably detect `memcpy-param-overlap` errors because the intrinsic variant of these functions isn't guaranteed to be used. For more information, see [`/Oi` (Generate Intrinsic Functions)](../build/reference/oi-generate-intrinsic-functions.md). + The CRT function [`memcpy`](../c-runtime-library/reference/memcpy-wmemcpy.md) **doesn't support** overlapping memory. The CRT provides an alternative to `memcpy` that does support overlapping memory: [`memmove`](../c-runtime-library/reference/memmove-wmemmove.md). A common error is to treat `memmove` as being semantically equivalent to `memcpy`. @@ -39,19 +44,17 @@ cl example1.cpp /fsanitize=address /Zi /Oi devenv /debugexe example1.exe ``` -The [/Oi flag](../build/reference/oi-generate-intrinsic-functions.md) tells the compiler to treat `memcpy` and `memmove` as intrinsic functions. This is necessary because some versions of the standard library implement `memcpy` and `memmove` in the same way. Because ASAN is a dynamic analysis tool, it only detects errors with an observable runtime effect. - ### Resulting error :::image type="content" source="media/memcpy-param-overlap-example-1.png" alt-text="Screenshot of debugger displaying memcpy-param-overlap error in example 1."::: ## See also -[AddressSanitizer overview](./asan.md)\ -[AddressSanitizer known issues](./asan-known-issues.md)\ -[AddressSanitizer build and language reference](./asan-building.md)\ -[AddressSanitizer runtime reference](./asan-runtime.md)\ -[AddressSanitizer shadow bytes](./asan-shadow-bytes.md)\ -[AddressSanitizer cloud or distributed testing](./asan-offline-crash-dumps.md)\ -[AddressSanitizer debugger integration](./asan-debugger-integration.md)\ -[AddressSanitizer error examples](./asan-error-examples.md) +[AddressSanitizer overview](asan.md)\ +[AddressSanitizer known issues](asan-known-issues.md)\ +[AddressSanitizer build and language reference](asan-building.md)\ +[AddressSanitizer runtime reference](asan-runtime.md)\ +[AddressSanitizer shadow bytes](asan-shadow-bytes.md)\ +[AddressSanitizer cloud or distributed testing](asan-offline-crash-dumps.md)\ +[AddressSanitizer debugger integration](asan-debugger-integration.md)\ +[AddressSanitizer error examples](asan-error-examples.md) diff --git a/docs/sanitizers/error-new-delete-type-mismatch.md b/docs/sanitizers/error-new-delete-type-mismatch.md index 5a72252cecd..daff0ec1c11 100644 --- a/docs/sanitizers/error-new-delete-type-mismatch.md +++ b/docs/sanitizers/error-new-delete-type-mismatch.md @@ -1,6 +1,6 @@ --- title: "Error: new-delete-type-mismatch" -description: "Source examples and live debug screenshots for new delete type mismatch errors." +description: "Learn about the new-delete-type-mismatch Address Sanitizer error." ms.date: 03/02/2021 f1_keywords: ["new-delete-type-mismatch"] helpviewer_keywords: ["new-delete-type-mismatch error", "AddressSanitizer error new-delete-type-mismatch"] @@ -9,6 +9,8 @@ helpviewer_keywords: ["new-delete-type-mismatch error", "AddressSanitizer error > Address Sanitizer Error: Deallocation size different from allocation size +## Remarks + In this example, only `~Base`, and not `~Derived`, is called. The compiler generates a call to `~Base()` because the `Base` destructor isn't **`virtual`**. When we call `delete b`, the object's destructor is bound to the default definition. The code deletes an empty base class (or 1 byte on Windows). A missing **`virtual`** keyword on the destructor declaration is a common C++ error when using inheritance. ## Example - virtual destructor @@ -48,7 +50,7 @@ To fix the example, add: ```cpp struct Base { virtual ~Base() = default; -} +}; ``` To build and test this example, run these commands in a Visual Studio 2019 version 16.9 or later [developer command prompt](../build/building-on-the-command-line.md#developer_command_prompt_shortcuts): @@ -64,11 +66,11 @@ devenv /debugexe example1.exe ## See also -[AddressSanitizer overview](./asan.md)\ -[AddressSanitizer known issues](./asan-known-issues.md)\ -[AddressSanitizer build and language reference](./asan-building.md)\ -[AddressSanitizer runtime reference](./asan-runtime.md)\ -[AddressSanitizer shadow bytes](./asan-shadow-bytes.md)\ -[AddressSanitizer cloud or distributed testing](./asan-offline-crash-dumps.md)\ -[AddressSanitizer debugger integration](./asan-debugger-integration.md)\ -[AddressSanitizer error examples](./asan-error-examples.md) +[AddressSanitizer overview](asan.md)\ +[AddressSanitizer known issues](asan-known-issues.md)\ +[AddressSanitizer build and language reference](asan-building.md)\ +[AddressSanitizer runtime reference](asan-runtime.md)\ +[AddressSanitizer shadow bytes](asan-shadow-bytes.md)\ +[AddressSanitizer cloud or distributed testing](asan-offline-crash-dumps.md)\ +[AddressSanitizer debugger integration](asan-debugger-integration.md)\ +[AddressSanitizer error examples](asan-error-examples.md) diff --git a/docs/sanitizers/error-stack-buffer-overflow.md b/docs/sanitizers/error-stack-buffer-overflow.md index e11403ba251..403ee7b16bb 100644 --- a/docs/sanitizers/error-stack-buffer-overflow.md +++ b/docs/sanitizers/error-stack-buffer-overflow.md @@ -1,6 +1,6 @@ --- title: "Error: stack-buffer-overflow" -description: "Source examples and live debug screenshots for Stack buffer overflow errors." +description: "Learn about the stack-buffer-overflow Address Sanitizer error." ms.date: 09/29/2021 f1_keywords: ["stack-buffer-overflow"] helpviewer_keywords: ["stack-buffer-overflow error", "AddressSanitizer error stack-buffer-overflow"] @@ -9,6 +9,8 @@ helpviewer_keywords: ["stack-buffer-overflow error", "AddressSanitizer error sta > Address Sanitizer Error: Stack buffer overflow +## Remarks + A stack buffer overflow can happen many ways in C or C++. We provide several examples for this category of error that you can catch by a simple recompile. ## Example - stack buffer overflow @@ -112,11 +114,11 @@ devenv /debugexe example3.exe ## See also -[AddressSanitizer overview](./asan.md)\ -[AddressSanitizer known issues](./asan-known-issues.md)\ -[AddressSanitizer build and language reference](./asan-building.md)\ -[AddressSanitizer runtime reference](./asan-runtime.md)\ -[AddressSanitizer shadow bytes](./asan-shadow-bytes.md)\ -[AddressSanitizer cloud or distributed testing](./asan-offline-crash-dumps.md)\ -[AddressSanitizer debugger integration](./asan-debugger-integration.md)\ -[AddressSanitizer error examples](./asan-error-examples.md) +[AddressSanitizer overview](asan.md)\ +[AddressSanitizer known issues](asan-known-issues.md)\ +[AddressSanitizer build and language reference](asan-building.md)\ +[AddressSanitizer runtime reference](asan-runtime.md)\ +[AddressSanitizer shadow bytes](asan-shadow-bytes.md)\ +[AddressSanitizer cloud or distributed testing](asan-offline-crash-dumps.md)\ +[AddressSanitizer debugger integration](asan-debugger-integration.md)\ +[AddressSanitizer error examples](asan-error-examples.md) diff --git a/docs/sanitizers/error-stack-buffer-underflow.md b/docs/sanitizers/error-stack-buffer-underflow.md index c540483abfb..c8cf463ff24 100644 --- a/docs/sanitizers/error-stack-buffer-underflow.md +++ b/docs/sanitizers/error-stack-buffer-underflow.md @@ -1,6 +1,6 @@ --- title: "Error: stack-buffer-underflow" -description: "Source examples and live debug screenshots for Stack buffer underflow errors." +description: "Learn about the stack-buffer-underflow Address Sanitizer error." ms.date: 03/02/2021 f1_keywords: ["stack-buffer-underflow"] helpviewer_keywords: ["stack-buffer-underflow error", "AddressSanitizer error stack-buffer-underflow"] @@ -9,6 +9,8 @@ helpviewer_keywords: ["stack-buffer-underflow error", "AddressSanitizer error st > Address Sanitizer Error: Stack buffer underflow +## Remarks + These error messages indicate a memory access to somewhere before the beginning of a stack variable. ## Example - local array underflow @@ -74,17 +76,17 @@ cl example2.cpp /fsanitize=address /Zi devenv /debugexe example2.exe ``` -### Resulting error - stack underflow on thread +### Resulting error - stack underflow on thread :::image type="content" source="media/stack-buffer-underflow-example-2.png" alt-text="Screenshot of debugger displaying stack-buffer-underflow error in example 2."::: ## See also -[AddressSanitizer overview](./asan.md)\ -[AddressSanitizer known issues](./asan-known-issues.md)\ -[AddressSanitizer build and language reference](./asan-building.md)\ -[AddressSanitizer runtime reference](./asan-runtime.md)\ -[AddressSanitizer shadow bytes](./asan-shadow-bytes.md)\ -[AddressSanitizer cloud or distributed testing](./asan-offline-crash-dumps.md)\ -[AddressSanitizer debugger integration](./asan-debugger-integration.md)\ -[AddressSanitizer error examples](./asan-error-examples.md) +[AddressSanitizer overview](asan.md)\ +[AddressSanitizer known issues](asan-known-issues.md)\ +[AddressSanitizer build and language reference](asan-building.md)\ +[AddressSanitizer runtime reference](asan-runtime.md)\ +[AddressSanitizer shadow bytes](asan-shadow-bytes.md)\ +[AddressSanitizer cloud or distributed testing](asan-offline-crash-dumps.md)\ +[AddressSanitizer debugger integration](asan-debugger-integration.md)\ +[AddressSanitizer error examples](asan-error-examples.md) diff --git a/docs/sanitizers/error-stack-use-after-return.md b/docs/sanitizers/error-stack-use-after-return.md index 214f9d8ab55..6ddd807d4a8 100644 --- a/docs/sanitizers/error-stack-use-after-return.md +++ b/docs/sanitizers/error-stack-use-after-return.md @@ -1,13 +1,15 @@ --- title: "Error: stack-use-after-return" -description: "Source examples and live debug screenshots for Stack Use After Return errors." +description: "Learn about the stack-use-after-return AddressSanitizer error." ms.date: 03/02/2021 f1_keywords: ["stack-use-after-return"] helpviewer_keywords: ["stack-use-after-return error", "AddressSanitizer error stack-use-after-return"] --- # Error: `stack-use-after-return` -> Address Sanitizer Error: Use of stack memory after return +> AddressSanitizer Error: Use of stack memory after return + +## Remarks This check requires code generation that's activated by an extra compiler option, [`/fsanitize-address-use-after-return`](../build/reference/fsanitize.md), and by setting the environment variable `ASAN_OPTIONS=detect_stack_use_after_return=1`. @@ -109,11 +111,11 @@ ASAN is a form of dynamic analysis, which means it can only detect bad code that ## See also -[AddressSanitizer overview](./asan.md)\ -[AddressSanitizer known issues](./asan-known-issues.md)\ -[AddressSanitizer build and language reference](./asan-building.md)\ -[AddressSanitizer runtime reference](./asan-runtime.md)\ -[AddressSanitizer shadow bytes](./asan-shadow-bytes.md)\ -[AddressSanitizer cloud or distributed testing](./asan-offline-crash-dumps.md)\ -[AddressSanitizer debugger integration](./asan-debugger-integration.md)\ -[AddressSanitizer error examples](./asan-error-examples.md) +[AddressSanitizer overview](asan.md)\ +[AddressSanitizer known issues](asan-known-issues.md)\ +[AddressSanitizer build and language reference](asan-building.md)\ +[AddressSanitizer runtime reference](asan-runtime.md)\ +[AddressSanitizer shadow bytes](asan-shadow-bytes.md)\ +[AddressSanitizer cloud or distributed testing](asan-offline-crash-dumps.md)\ +[AddressSanitizer debugger integration](asan-debugger-integration.md)\ +[AddressSanitizer error examples](asan-error-examples.md) diff --git a/docs/sanitizers/error-stack-use-after-scope.md b/docs/sanitizers/error-stack-use-after-scope.md index fa5a88daa94..951ca39bb4c 100644 --- a/docs/sanitizers/error-stack-use-after-scope.md +++ b/docs/sanitizers/error-stack-use-after-scope.md @@ -1,6 +1,6 @@ --- title: "Error: stack-use-after-scope" -description: "Source examples and live debug screenshots for stack use after scope errors." +description: "Learn about the stack-use-after-scope Address Sanitizer error." ms.date: 02/05/2021 f1_keywords: ["stack-use-after-scope"] helpviewer_keywords: ["stack-use-after-scope error", "AddressSanitizer error stack-use-after-scope"] @@ -9,6 +9,8 @@ helpviewer_keywords: ["stack-use-after-scope error", "AddressSanitizer error sta > Address Sanitizer Error: Use of out-of-scope stack memory +## Remarks + The use of a stack address outside the lexical scope of a variable's lifetime can happen many ways in C or C++. ## Example 1 - simple nested local @@ -80,7 +82,7 @@ devenv /debugexe example2.exe struct IntHolder { explicit IntHolder(int* val = 0) : val_(val) { } ~IntHolder() { - printf("Value: %d\n", *val_); // Bom! + printf("Value: %d\n", *val_); // Boom! } void set(int* val) { val_ = val; } int* get() { return val_; } @@ -138,7 +140,7 @@ void temp_from_conversion() { a.print(); } -void main() { +int main() { explicit_temp(); temp_from_conversion(); } @@ -159,11 +161,11 @@ ASAN is a form of dynamic analysis, which means it can only detect bad code that ## See also -[AddressSanitizer overview](./asan.md)\ -[AddressSanitizer known issues](./asan-known-issues.md)\ -[AddressSanitizer build and language reference](./asan-building.md)\ -[AddressSanitizer runtime reference](./asan-runtime.md)\ -[AddressSanitizer shadow bytes](./asan-shadow-bytes.md)\ -[AddressSanitizer cloud or distributed testing](./asan-offline-crash-dumps.md)\ -[AddressSanitizer debugger integration](./asan-debugger-integration.md)\ -[AddressSanitizer error examples](./asan-error-examples.md) +[AddressSanitizer overview](asan.md)\ +[AddressSanitizer known issues](asan-known-issues.md)\ +[AddressSanitizer build and language reference](asan-building.md)\ +[AddressSanitizer runtime reference](asan-runtime.md)\ +[AddressSanitizer shadow bytes](asan-shadow-bytes.md)\ +[AddressSanitizer cloud or distributed testing](asan-offline-crash-dumps.md)\ +[AddressSanitizer debugger integration](asan-debugger-integration.md)\ +[AddressSanitizer error examples](asan-error-examples.md) diff --git a/docs/sanitizers/error-strncat-param-overlap.md b/docs/sanitizers/error-strncat-param-overlap.md index 3e183956787..e5569f4faba 100644 --- a/docs/sanitizers/error-strncat-param-overlap.md +++ b/docs/sanitizers/error-strncat-param-overlap.md @@ -1,6 +1,6 @@ --- title: "Error: strncat-param-overlap" -description: "Source examples and live debug screenshots for strcat parameter overlap errors." +description: "Learn about the strncat-param-overlap Address Sanitizer error." ms.date: 03/02/2021 f1_keywords: ["strncat-param-overlap"] helpviewer_keywords: ["strncat-param-overlap error", "AddressSanitizer error strcat-param-overlap"] @@ -9,6 +9,8 @@ helpviewer_keywords: ["strncat-param-overlap error", "AddressSanitizer error str > Address Sanitizer Error: strncat-param-overlap +## Remarks + Code that moves memory in overlapping buffer can cause hard-to-diagnose errors. ## Example @@ -47,11 +49,11 @@ devenv /debugexe example1.exe ## See also -[AddressSanitizer overview](./asan.md)\ -[AddressSanitizer known issues](./asan-known-issues.md)\ -[AddressSanitizer build and language reference](./asan-building.md)\ -[AddressSanitizer runtime reference](./asan-runtime.md)\ -[AddressSanitizer shadow bytes](./asan-shadow-bytes.md)\ -[AddressSanitizer cloud or distributed testing](./asan-offline-crash-dumps.md)\ -[AddressSanitizer debugger integration](./asan-debugger-integration.md)\ -[AddressSanitizer error examples](./asan-error-examples.md) +[AddressSanitizer overview](asan.md)\ +[AddressSanitizer known issues](asan-known-issues.md)\ +[AddressSanitizer build and language reference](asan-building.md)\ +[AddressSanitizer runtime reference](asan-runtime.md)\ +[AddressSanitizer shadow bytes](asan-shadow-bytes.md)\ +[AddressSanitizer cloud or distributed testing](asan-offline-crash-dumps.md)\ +[AddressSanitizer debugger integration](asan-debugger-integration.md)\ +[AddressSanitizer error examples](asan-error-examples.md) diff --git a/docs/sanitizers/error-use-after-poison.md b/docs/sanitizers/error-use-after-poison.md index 9ef09bd0dc6..d8347318d35 100644 --- a/docs/sanitizers/error-use-after-poison.md +++ b/docs/sanitizers/error-use-after-poison.md @@ -1,6 +1,6 @@ --- title: "Error: use-after-poison" -description: "Source examples and live debug screenshots for use after poison errors." +description: "Learn about the use-after-poison Address Sanitizer error." ms.date: 03/02/2021 f1_keywords: ["use-after-poison"] helpviewer_keywords: ["use-after-poison error", "AddressSanitizer error use-after-poison"] @@ -9,6 +9,8 @@ helpviewer_keywords: ["use-after-poison error", "AddressSanitizer error use-afte > Address Sanitizer Error: Use of poisoned memory +## Remarks + A developer can manually poison memory to customize debugging. ## Example @@ -45,11 +47,11 @@ devenv /debugexe example1.exe ## See also -[AddressSanitizer overview](./asan.md)\ -[AddressSanitizer known issues](./asan-known-issues.md)\ -[AddressSanitizer build and language reference](./asan-building.md)\ -[AddressSanitizer runtime reference](./asan-runtime.md)\ -[AddressSanitizer shadow bytes](./asan-shadow-bytes.md)\ -[AddressSanitizer cloud or distributed testing](./asan-offline-crash-dumps.md)\ -[AddressSanitizer debugger integration](./asan-debugger-integration.md)\ -[AddressSanitizer error examples](./asan-error-examples.md) +[AddressSanitizer overview](asan.md)\ +[AddressSanitizer known issues](asan-known-issues.md)\ +[AddressSanitizer build and language reference](asan-building.md)\ +[AddressSanitizer runtime reference](asan-runtime.md)\ +[AddressSanitizer shadow bytes](asan-shadow-bytes.md)\ +[AddressSanitizer cloud or distributed testing](asan-offline-crash-dumps.md)\ +[AddressSanitizer debugger integration](asan-debugger-integration.md)\ +[AddressSanitizer error examples](asan-error-examples.md) diff --git a/docs/sanitizers/index.yml b/docs/sanitizers/index.yml index f80ba43bed1..8e8e85e21f4 100644 --- a/docs/sanitizers/index.yml +++ b/docs/sanitizers/index.yml @@ -41,7 +41,7 @@ landingContent: url: ./asan-runtime.md - text: AddressSanitizer error examples url: ./asan-error-examples.md - - text: AddressSanitizer known issues + - text: AddressSanitizer known issues and limitations url: ./asan-known-issues.md # Card diff --git a/docs/sanitizers/toc.yml b/docs/sanitizers/toc.yml index 96ec14bf18c..ac16359f797 100644 --- a/docs/sanitizers/toc.yml +++ b/docs/sanitizers/toc.yml @@ -10,6 +10,8 @@ items: href: ../sanitizers/asan-continue-on-error.md - name: "Build and language reference" href: ../sanitizers/asan-building.md + - name: "Runtime options" + href: ../sanitizers/asan-flags.md - name: "Runtime reference" href: ../sanitizers/asan-runtime.md - name: "Debugger integration" @@ -59,5 +61,5 @@ items: href: ../sanitizers/error-strncat-param-overlap.md - name: "use-after-poison error" href: ../sanitizers/error-use-after-poison.md - - name: "Known issues" + - name: "Known issues and limitations" href: ../sanitizers/asan-known-issues.md diff --git a/docs/security/running-as-a-member-of-the-users-group.md b/docs/security/running-as-a-member-of-the-users-group.md index 833678cb72d..0fec514075e 100644 --- a/docs/security/running-as-a-member-of-the-users-group.md +++ b/docs/security/running-as-a-member-of-the-users-group.md @@ -4,6 +4,7 @@ title: "Running as a Member of the Users Group" ms.date: "11/04/2016" helpviewer_keywords: ["Users Group [C++]", "security [C++], Users Group", "Windows accounts [C++]", "non administrator users [C++]", "user accounts [C++]", "administrator (not running as) [C++]"] ms.assetid: e48a03ec-d345-49f6-809a-1a291eecbc81 +ms.topic: concept-article --- # Running as a Member of the Users Group diff --git a/docs/security/security-best-practices-for-cpp.md b/docs/security/security-best-practices-for-cpp.md index 3774d170834..83ffc267e8e 100644 --- a/docs/security/security-best-practices-for-cpp.md +++ b/docs/security/security-best-practices-for-cpp.md @@ -1,35 +1,35 @@ --- -description: "Learn more about: Security Best Practices for C++" title: "Security Best Practices for C++" -ms.date: "05/08/2018" +description: "Learn more about: Security Best Practices for C++" +ms.date: 05/08/2018 f1_keywords: ["securitybestpracticesVC"] helpviewer_keywords: ["Visual C++, security", "security [C++]", "security [C++], best practices"] -ms.assetid: 86acaccf-cdb4-4517-bd58-553618e3ec42 +ms.topic: best-practice --- # Security Best Practices for C++ This article contains information about security tools and practices. Using them does not make applications immune from attack, but it makes successful attacks less likely. -## Visual C++ Security Features +## Microsoft C++ Security Features These security features are built into the Microsoft C++ compiler and linker: -[`/guard` (Enable Control Flow Guard)](../build/reference/guard-enable-control-flow-guard.md)
+[`/guard` (Enable Control Flow Guard)](../build/reference/guard-enable-control-flow-guard.md)\ Causes the compiler to analyze control flow for indirect call targets at compile time, and then to insert code to verify the targets at runtime. -[`/GS` (Buffer Security Check)](../build/reference/gs-buffer-security-check.md)
+[`/GS` (Buffer Security Check)](../build/reference/gs-buffer-security-check.md)\ Instructs the compiler to insert overrun detection code into functions that are at risk of being exploited. When an overrun is detected, execution is stopped. By default, this option is on. -[`/SAFESEH` (Image has Safe Exception Handlers)](../build/reference/safeseh-image-has-safe-exception-handlers.md)
+[`/SAFESEH` (Image has Safe Exception Handlers)](../build/reference/safeseh-image-has-safe-exception-handlers.md)\ Instructs the linker to include in the output image a table that contains the address of each exception handler. At run time, the operating system uses this table to make sure that only legitimate exception handlers are executed. This helps prevent the execution of exception handlers that are introduced by a malicious attack at run time. By default, this option is off. -[`/NXCOMPAT`](../build/reference/nxcompat.md), [`/NXCOMPAT` (Compatible with Data Execution Prevention)](../build/reference/nxcompat-compatible-with-data-execution-prevention.md) +[`/NXCOMPAT`](../build/reference/nxcompat.md), [`/NXCOMPAT` (Compatible with Data Execution Prevention)](../build/reference/nxcompat-compatible-with-data-execution-prevention.md)\ These compiler and linker options enable Data Execution Prevention (DEP) compatibility. DEP guards the CPU against the execution of non-code pages. -[`/analyze` (Code Analysis)](../build/reference/analyze-code-analysis.md)
+[`/analyze` (Code Analysis)](../build/reference/analyze-code-analysis.md)\ This compiler option activates code analysis that reports potential security issues such as buffer overrun, un-initialized memory, null pointer dereferencing, and memory leaks. By default, this option is off. For more information, see [Code Analysis for C/C++ Overview](../code-quality/code-analysis-for-c-cpp-overview.md). -[`/DYNAMICBASE` (Use address space layout randomization)](../build/reference/dynamicbase-use-address-space-layout-randomization.md)
+[`/DYNAMICBASE` (Use address space layout randomization)](../build/reference/dynamicbase-use-address-space-layout-randomization.md)\ This linker option enables the building of an executable image that can be loaded at different locations in memory at the beginning of execution. This option also makes the stack location in memory much less predictable. ## Security-Enhanced CRT @@ -86,6 +86,6 @@ For information about how to indentify and mitigate against speculative executio ## See also -
-[Security](/dotnet/standard/security/index)
+\ +[Security in .NET](/dotnet/standard/security/index)\ [How User Account Control (UAC) Affects Your Application](how-user-account-control-uac-affects-your-application.md) diff --git a/docs/standard-library/algorithm-functions.md b/docs/standard-library/algorithm-functions.md index 2e049415f2f..65b150d64e8 100644 --- a/docs/standard-library/algorithm-functions.md +++ b/docs/standard-library/algorithm-functions.md @@ -1,6 +1,6 @@ --- -description: "Learn more about: functions" title: " functions" +description: "Learn more about: functions" ms.date: 06/07/2022 f1_keywords: ["algorithm/std::adjacent_find", "algorithm/std::all_of", "algorithm/std::any_of", "algorithm/std::binary_search", "algorithm/std::copy", "algorithm/std::copy_backward", "algorithm/std::copy_if", "algorithm/std::copy_n", "algorithm/std::equal", "algorithm/std::equal_range", "algorithm/std::fill", "algorithm/std::fill_n", "algorithm/std::find", "algorithm/std::find_end", "algorithm/std::find_first_of", "algorithm/std::find_if", "algorithm/std::find_if_not", "algorithm/std::for_each", "algorithm/std::generate", "algorithm/std::generate_n", "algorithm/std::includes", "algorithm/std::inplace_merge", "algorithm/std::is_heap", "algorithm/std::is_heap_until", "algorithm/std::is_partitioned", "algorithm/std::is_permutation", "algorithm/std::is_sorted", "algorithm/std::is_sorted_until", "algorithm/std::iter_swap", "algorithm/std::lexicographical_compare", "algorithm/std::lower_bound", "algorithm/std::make_heap", "algorithm/std::max", "algorithm/std::max_element", "algorithm/std::merge", "algorithm/std::min", "algorithm/std::minmax", "algorithm/std::minmax_element", "algorithm/std::min_element", "algorithm/std::mismatch", "algorithm/std::move", "algorithm/std::move_backward", "algorithm/std::next_permutation", "algorithm/std::none_of", "algorithm/std::nth_element", "algorithm/std::partial_sort", "algorithm/std::partial_sort_copy", "algorithm/std::partition", "algorithm/std::partition_point", "algorithm/std::pop_heap", "algorithm/std::prev_permutation", "algorithm/std::push_heap", "algorithm/std::random_shuffle", "algorithm/std::remove", "algorithm/std::remove_copy", "algorithm/std::remove_copy_if", "algorithm/std::remove_if", "algorithm/std::replace", "algorithm/std::replace_copy", "algorithm/std::replace_copy_if", "algorithm/std::replace_if", "algorithm/std::reverse", "algorithm/std::reverse_copy", "algorithm/std::rotate", "algorithm/std::rotate_copy", "algorithm/std::search", "algorithm/std::search_n", "algorithm/std::set_difference", "algorithm/std::set_intersection", "algorithm/std::set_symmetric_difference", "algorithm/std::set_union", "algorithm/std::shuffle", "algorithm/std::sort", "algorithm/std::sort_heap", "algorithm/std::stable_partition", "algorithm/std::stable_sort", "algorithm/std::swap_ranges", "algorithm/std::transform", "algorithm/std::unique", "algorithm/std::unique_copy", "algorithm/std::upper_bound", "xutility/std::copy", "xutility/std::copy_backward", "xutility/std::copy_n", "xutility/std::count", "xutility/std::equal", "xutility/std::fill", "xutility/std::fill_n", "xutility/std::find", "xutility/std::is_permutation", "xutility/std::lexicographical_compare", "xutility/std::move", "xutility/std::move_backward", "xutility/std::reverse", "xutility/std::rotate", "algorithm/std::count_if", "algorithm/std::partition_copy", "algorithm/std::swap"] helpviewer_keywords: ["std::adjacent_find [C++]", "std::all_of [C++]", "std::any_of [C++]", "std::binary_search [C++]", "std::copy [C++]", "std::copy_backward [C++]", "std::copy_if [C++]", "std::copy_n [C++]", "std::equal [C++]", "std::equal_range [C++]", "std::fill [C++]", "std::fill_n [C++]", "std::find [C++]", "std::find_end [C++]", "std::find_first_of [C++]", "std::find_if [C++]", "std::find_if_not [C++]", "std::for_each [C++]", "std::generate [C++]", "std::generate_n [C++]", "std::includes [C++]", "std::inplace_merge [C++]", "std::is_heap [C++]", "std::is_heap_until [C++]", "std::is_partitioned [C++]", "std::is_permutation [C++]", "std::is_sorted [C++]", "std::is_sorted_until [C++]", "std::iter_swap [C++]", "std::lexicographical_compare [C++]", "std::lower_bound [C++]", "std::make_heap [C++]", "std::max [C++]", "std::max_element [C++]", "std::merge [C++]", "std::min [C++]", "std::minmax [C++]", "std::minmax_element [C++]", "std::min_element [C++]", "std::mismatch [C++]", "std::move [C++]", "std::move_backward [C++]", "std::next_permutation [C++]", "std::none_of [C++]", "std::nth_element [C++]", "std::partial_sort [C++]", "std::partial_sort_copy [C++]", "std::partition [C++]", "std::partition_point [C++]", "std::pop_heap [C++]", "std::prev_permutation [C++]", "std::push_heap [C++]", "std::random_shuffle [C++]", "std::remove [C++]", "std::remove_copy [C++]", "std::remove_copy_if [C++]", "std::remove_if [C++]", "std::replace [C++]", "std::replace_copy [C++]", "std::replace_copy_if [C++]", "std::replace_if [C++]", "std::reverse [C++]", "std::reverse_copy [C++]", "std::rotate [C++]", "std::rotate_copy [C++]", "std::search [C++]", "std::search_n [C++]", "std::set_difference [C++]", "std::set_intersection [C++]", "std::set_symmetric_difference [C++]", "std::set_union [C++]", "std::shuffle [C++]", "std::sort [C++]", "std::sort_heap [C++]", "std::stable_partition [C++]", "std::stable_sort [C++]", "std::swap_ranges [C++]", "std::transform [C++]", "std::unique [C++]", "std::unique_copy [C++]", "std::upper_bound [C++]", "std::copy [C++]", "std::copy_backward [C++]", "std::copy_n [C++]", "std::count [C++]", "std::equal [C++]", "std::fill [C++]", "std::fill_n [C++]", "std::find [C++]", "std::is_permutation [C++]", "std::lexicographical_compare [C++]", "std::move [C++]", "std::move_backward [C++]", "std::reverse [C++]", "std::rotate [C++]", "std::count_if [C++]", "std::partition_copy [C++]", "std::swap [C++]"] @@ -8,6 +8,8 @@ ms.custom: devdivchpfy22 --- # `` functions +The `` header provides the following functions: + ## `adjacent_find` Searches for two adjacent elements that are either equal or satisfy a specified condition. @@ -593,7 +595,7 @@ An output iterator addressing the position that is one past the final element in The source range must be valid and there must be sufficient space at the destination to hold all the elements being copied. -The `copy_backward` algorithm imposes more stringent requirements than that the `copy` algorithm. Both its input and output iterators must be bidirectional. +The `copy_backward` algorithm imposes more stringent requirements than the `copy` algorithm. Both its input and output iterators must be bidirectional. The `copy_backward` and [`move_backward`](algorithm-functions.md#move_backward) algorithms are the only C++ Standard Library algorithms designating the output range with an iterator pointing to the end of the destination range. @@ -906,13 +908,13 @@ int main() vector::iterator::difference_type result; result = count(v1.begin(), v1.end(), 10); - cout << "The number of 10s in v2 is: " << result << "." << endl; + cout << "The number of 10s in v1 is: " << result << "." << endl; } ``` ```Output v1 = ( 10 20 10 40 10 ) -The number of 10s in v2 is: 3. +The number of 10s in v1 is: 3. ``` ## `count_if` @@ -2147,7 +2149,7 @@ public: { } - // The function call to process the next elment + // The function call to process the next element void operator( ) ( int elem ) { num++; // Increment the element count @@ -2290,7 +2292,7 @@ public: } }; -// Utility to display the contents of a vector +// Utility to display the contents of a vector template void print_vector(const std::vector &vec) { std::cout << "( "; @@ -2684,7 +2686,7 @@ int main() cout << *Iter3b << " "; cout << ")." << endl; - // To test for inclusion under an asscending order + // To test for inclusion under an ascending order // with the default binary predicate less( ) bool Result1; Result1 = includes ( v1a.begin( ), v1a.end( ), @@ -2890,7 +2892,7 @@ int main() // Applying a user defined (UD) binary predicate mod_lesser inplace_merge ( v3.begin( ), break3, v3.end( ), mod_lesser ); cout << "Merged inplace with binary predicate mod_lesser specified,\n " - << "vector v3mod = ( " ; ; + << "vector v3mod = ( " ; for ( Iter3 = v3.begin( ) ; Iter3 != v3.end( ) ; Iter3++ ) cout << *Iter3 << " "; cout << ")" << endl; @@ -4422,7 +4424,7 @@ int main() { merge ( v3a.begin( ), v3a.end( ), v3b.begin( ), v3b.end( ), v3.begin( ), mod_lesser ); cout << "Merged inplace with binary predicate mod_lesser specified,\n " - << "vector v3mod = ( " ; ; + << "vector v3mod = ( " ; for ( Iter3 = v3.begin( ) ; Iter3 != v3.end( ) ; Iter3++ ) cout << *Iter3 << " "; cout << ")." << endl; @@ -4947,13 +4949,14 @@ Use the dual-range overloads in C++14 code because the overloads that only take ```cpp template -pair> +pair mismatch( InputIterator1 first1, InputIterator1 last1, InputIterator2 first2 ); -template pair> +template +pair mismatch( InputIterator1 first1, InputIterator1 last1, @@ -4962,14 +4965,15 @@ mismatch( //C++14 template -pair> +pair mismatch( InputIterator1 first1, InputIterator1 last1, InputIterator2 first2, InputIterator2 last2 ); -template pair> +template +pair mismatch( InputIterator1 first1, InputIterator1 last1, @@ -5583,7 +5587,7 @@ template void partial_sort( RandomAccessIterator first, RandomAccessIterator sortEnd, - RandomAccessIterator last + RandomAccessIterator last, Compare pred); template @@ -5931,7 +5935,7 @@ int main() cout << *Iter1 << " "; cout << ")." << endl; - // Partition the range with predicate greater10 + // Partition the range with predicate greater5 partition ( v1.begin( ), v1.end( ), greater5 ); cout << "The partitioned set of elements in v1 is: ( " ; for ( Iter1 = v1.begin( ) ; Iter1 != v1.end( ) ; Iter1++ ) @@ -6658,7 +6662,7 @@ Vector v2 is a copy of v1 with the value 7 removed: ## `remove_copy_if` -Copies elements from a source range to a destination range, except for elements that satisfy a predicate. Elements are copied without disturbing the order of the remaining elements. Returns the end of a new destination range. +Copies elements from a source range to a destination range, except for elements that satisfy a predicate. Elements are copied without disturbing the order of the remaining elements. Returns the end of a new destination range. ```cpp template @@ -6692,7 +6696,7 @@ An input iterator addressing the position one past the final element in the rang An output iterator addressing the position of the first element in the destination range to which elements are being removed. *`pred`*\ -The unary predicate that must be satisfied is the value of an element is to be replaced. +The unary predicate that must be satisfied if the value of an element is to be replaced. ### Return value @@ -6749,7 +6753,7 @@ int main() new_end = remove_copy_if ( v1.begin( ), v1.end( ), v2.begin( ), greater6 ); - cout << "After the appliation of remove_copy_if to v1,\n " + cout << "After the application of remove_copy_if to v1,\n " << "vector v1 is left unchanged as ( " ; for ( Iter1 = v1.begin( ) ; Iter1 != v1.end( ) ; Iter1++ ) cout << *Iter1 << " "; @@ -6765,7 +6769,7 @@ int main() ```Output The original vector v1 is: ( 4 7 7 7 0 5 7 1 6 9 3 7 8 2 ). -After the appliation of remove_copy_if to v1, +After the application of remove_copy_if to v1, vector v1 is left unchanged as ( 4 7 7 7 0 5 7 1 6 9 3 7 8 2 ). Vector v2 is a copy of v1 with values greater than 6 removed: ( 4 0 5 1 6 3 2 ). @@ -6802,7 +6806,7 @@ A forward iterator pointing to the position of the first element in the range fr A forward iterator pointing to the position one past the final element in the range from which elements are being removed. *`pred`*\ -The unary predicate that must be satisfied is the value of an element is to be replaced. +The unary predicate that must be satisfied if the value of an element is to be replaced. ### Return value @@ -7146,7 +7150,7 @@ An input iterator pointing to the position one past the final element in the ran An output iterator pointing to the position of the first element in the destination range to which elements are being copied. *`pred`*\ -The unary predicate that must be satisfied is the value of an element is to be replaced. +The unary predicate that must be satisfied if the value of an element is to be replaced. *`value`*\ The new value being assigned to the elements whose old value satisfies the predicate. @@ -7275,7 +7279,7 @@ A forward iterator pointing to the position of the first element in the range fr An iterator pointing to the position one past the final element in the range from which elements are being replaced. *`pred`*\ -The unary predicate that must be satisfied is the value of an element is to be replaced. +The unary predicate that must be satisfied if the value of an element is to be replaced. *`value`*\ The new value being assigned to the elements whose old value satisfies the predicate. @@ -7783,7 +7787,7 @@ ForwardIterator1 search( ForwardIterator1 first1, ForwardIterator1 last1, ForwardIterator2 first2, - ForwardIterator2 last2 + ForwardIterator2 last2, BinaryPredicate pred); template @@ -8267,7 +8271,7 @@ int main() cout << *Iter3b << " "; cout << ")." << endl; - // To combine into a difference in asscending + // To combine into a difference in ascending // order with the default binary predicate less( ) Result1 = set_difference ( v1a.begin( ), v1a.end( ), v1b.begin( ), v1b.end( ), v1.begin( ) ); @@ -8292,7 +8296,7 @@ int main() Result3 = set_difference ( v3a.begin( ), v3a.end( ), v3b.begin( ), v3b.end( ), v3.begin( ), mod_lesser ); cout << "Set_difference of source ranges with binary " - << "predicate mod_lesser specified,\n vector v3mod = ( " ; ; + << "predicate mod_lesser specified,\n vector v3mod = ( " ; for ( Iter3 = v3.begin( ) ; Iter3 != Result3 ; Iter3++ ) cout << *Iter3 << " "; cout << ")." << endl; @@ -8486,7 +8490,7 @@ int main() cout << *Iter3b << " "; cout << ")." << endl; - // To combine into an intersection in asscending order with the + // To combine into an intersection in ascending order with the // default binary predicate less( ) Result1 = set_intersection ( v1a.begin( ), v1a.end( ), v1b.begin( ), v1b.end( ), v1.begin( ) ); @@ -8511,7 +8515,7 @@ int main() Result3 = set_intersection ( v3a.begin( ), v3a.end( ), v3b.begin( ), v3b.end( ), v3.begin( ), mod_lesser ); cout << "Intersection of source ranges with binary predicate " - << "mod_lesser specified,\n vector v3mod = ( " ; ; + << "mod_lesser specified,\n vector v3mod = ( " ; for ( Iter3 = v3.begin( ) ; Iter3 != Result3 ; ++Iter3 ) cout << *Iter3 << " "; cout << ")." << endl; @@ -8734,7 +8738,7 @@ int main() Result3 = set_symmetric_difference ( v3a.begin( ), v3a.end( ), v3b.begin( ), v3b.end( ), v3.begin( ), mod_lesser ); cout << "Set_symmetric_difference of source ranges with binary " - << "predicate mod_lesser specified,\n vector v3mod = ( " ; ; + << "predicate mod_lesser specified,\n vector v3mod = ( " ; for ( Iter3 = v3.begin( ) ; Iter3 != Result3 ; Iter3++ ) cout << *Iter3 << " "; cout << ")." << endl; @@ -8957,7 +8961,7 @@ int main() Result3 = set_union ( v3a.begin( ), v3a.end( ), v3b.begin( ), v3b.end( ), v3.begin( ), mod_lesser ); cout << "Union of source ranges with binary predicate " - << "mod_lesser specified,\n vector v3mod = ( " ; ; + << "mod_lesser specified,\n vector v3mod = ( " ; for ( Iter3 = v3.begin( ) ; Iter3 != Result3 ; Iter3++ ) cout << *Iter3 << " "; cout << ")." << endl; @@ -9168,7 +9172,7 @@ Heaps have two properties: - Elements may be added or removed in logarithmic time. -After the application if this algorithm, the range it was applied to is no longer a heap. +After the application of this algorithm, the range it was applied to is no longer a heap. `sort_heap` isn't a stable sort because the relative order of equivalent elements isn't necessarily preserved. @@ -9583,7 +9587,7 @@ A forward iterator pointing to one past the final position of the second range w The ranges referenced must be valid; all pointers must be dereferenceable and within each sequence the last position is reachable from the first by incrementation. The second range has to be as large as the first range. -The complexity is linear with *last1* - *first1* swaps performed. If elements from containers of the same type are being swapped, them the `swap` member function from that container should be used, because the member function typically has constant complexity. +The complexity is linear with *last1* - *first1* swaps performed. If elements from containers of the same type are being swapped, then the `swap` member function from that container should be used, because the member function typically has constant complexity. ### Example @@ -9920,7 +9924,7 @@ int main() cout << *v1_Iter1 << " "; cout << ")." << endl; - // Remove consecutive duplicates under the binary prediate mod_equals + // Remove consecutive duplicates under the binary predicate mod_equals v1_NewEnd2 = unique ( v1.begin( ), v1_NewEnd1 , mod_equal ); cout << "Removing adjacent duplicates from vector v1 under the\n " @@ -10076,7 +10080,7 @@ int main() { for ( iv = 0 ; iv <= 7 ; iv++ ) v1.push_back( 10 ); - // Remove consecutive duplicates under the binary prediate mod_equals + // Remove consecutive duplicates under the binary predicate mod_equals v1_NewEnd2 = unique_copy ( v1.begin( ), v1.begin( ) + 14, v1.begin( ) + 14 , mod_equal ); diff --git a/docs/standard-library/allocator-class.md b/docs/standard-library/allocator-class.md index 86e07e0e632..8c090dd434b 100644 --- a/docs/standard-library/allocator-class.md +++ b/docs/standard-library/allocator-class.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: allocator Class" title: "allocator Class" -ms.date: "11/04/2016" +description: "Learn more about: allocator Class" +ms.date: 11/04/2016 f1_keywords: ["memory/std::allocator", "memory/std::allocator::const_pointer", "memory/std::allocator::const_reference", "memory/std::allocator::difference_type", "memory/std::allocator::pointer", "memory/std::allocator::reference", "memory/std::allocator::size_type", "memory/std::allocator::value_type", "memory/std::allocator::address", "memory/std::allocator::allocate", "memory/std::allocator::construct", "memory/std::allocator::deallocate", "memory/std::allocator::destroy", "memory/std::allocator::max_size", "memory/std::allocator::rebind"] helpviewer_keywords: ["std::allocator [C++]", "std::allocator [C++], const_pointer", "std::allocator [C++], const_reference", "std::allocator [C++], difference_type", "std::allocator [C++], pointer", "std::allocator [C++], reference", "std::allocator [C++], size_type", "std::allocator [C++], value_type", "std::allocator [C++], address", "std::allocator [C++], allocate", "std::allocator [C++], construct", "std::allocator [C++], deallocate", "std::allocator [C++], destroy", "std::allocator [C++], max_size", "std::allocator [C++], rebind"] -ms.assetid: 3fd58076-56cc-43bb-ad58-b4b7c9c6b410 --- # allocator Class @@ -396,7 +395,7 @@ int main( ) // vcref = 150; // but the value of the first element could be modified through // its nonconst iterator and the const reference would remain valid -*vfIter = 175; + *vfIter = 175; cout << "The value of the element referred to by vcref," <<"\n after nofication through its nonconst iterator, is: " << vcref << "." << endl; @@ -1024,7 +1023,7 @@ int main( ) vfIter = v.begin( ); allocator::value_type vecVal = 150.0; -*vfIter = vecVal; + *vfIter = vecVal; cout << "The value of the element addressed by vfIter is: " << *vfIter << ",\n the first element in the vector." << endl; diff --git a/docs/standard-library/allocators-functions.md b/docs/standard-library/allocators-functions.md index adcaabbd4e9..fafefa60342 100644 --- a/docs/standard-library/allocators-functions.md +++ b/docs/standard-library/allocators-functions.md @@ -1,9 +1,8 @@ --- -description: "Learn more about: macros" title: " macros" -ms.date: "11/04/2016" +description: "Learn more about: macros" +ms.date: 11/04/2016 f1_keywords: ["allocators/std::ALLOCATOR_DECL", "allocators/std::CACHE_CHUNKLIST", "allocators/std::CACHE_FREELIST", "allocators/std::CACHE_SUBALLOC", "allocators/std::SYNC_DEFAULT"] -ms.assetid: 9cb5ee07-1ff9-4594-ae32-3c8c6efb511a helpviewer_keywords: ["std::ALLOCATOR_DECL [C++]", "std::CACHE_CHUNKLIST [C++]", "std::CACHE_FREELIST [C++]", "std::CACHE_SUBALLOC [C++]", "std::SYNC_DEFAULT [C++]"] --- # `` macros @@ -72,8 +71,6 @@ Yields `stdext::allocators::cache_chunklist`. #define CACHE_CHUNKLIST ``` -### Remarks - ## CACHE_FREELIST Yields `stdext::allocators::cache_freelist`. @@ -82,8 +79,6 @@ Yields `stdext::allocators::cache_freelist`. #define CACHE_FREELIST(max) ``` -### Remarks - ## CACHE_SUBALLOC Yields `stdext::allocators::cache_suballoc`. @@ -92,8 +87,6 @@ Yields `stdext::allocators::cache_suballoc`. #define CACHE_SUBALLOC ``` -### Remarks - ## SYNC_DEFAULT Yields a synchronization filter. diff --git a/docs/standard-library/allocators-operators.md b/docs/standard-library/allocators-operators.md index 90936ade68c..8deacf84301 100644 --- a/docs/standard-library/allocators-operators.md +++ b/docs/standard-library/allocators-operators.md @@ -1,18 +1,14 @@ --- -description: "Learn more about: operators" title: " operators" -ms.date: "11/04/2016" +description: "Learn more about: operators" +ms.date: 11/04/2016 f1_keywords: ["allocators/std::operator!=", "allocators/std::operator=="] -ms.assetid: b55d67cb-3c69-46bf-ad40-e845fb096c4e --- # `` operators These are the global template operator functions defined in ``. For class member operator functions, see the class documentation. -[operator!=](#op_neq)\ -[operator==](#op_eq_eq) - -## operator!= +## `operator!=` Tests for inequality between allocator objects of a specified class. @@ -25,10 +21,10 @@ bool operator!=( ### Parameters -*left*\ +*`left`*\ One of the allocator objects to be tested for inequality. -*right*\ +*`right`*\ One of the allocator objects to be tested for inequality. ### Return Value @@ -39,7 +35,7 @@ One of the allocator objects to be tested for inequality. The template operator returns `!(left == right)`. -## operator== +## `operator==` Tests for equality between allocator objects of a specified class. @@ -52,10 +48,10 @@ bool operator==( ### Parameters -*left*\ +*`left`*\ One of the allocator objects to be tested for equality. -*right*\ +*`right`*\ One of the allocator objects to be tested for equality. ### Return Value @@ -68,4 +64,4 @@ This template operator returns `left.equals(right)`. ## See also -[\](allocators-header.md) +[``](allocators-header.md) diff --git a/docs/standard-library/ambiguous-local-time.md b/docs/standard-library/ambiguous-local-time.md index 72dba2eb717..d90b87dcedc 100644 --- a/docs/standard-library/ambiguous-local-time.md +++ b/docs/standard-library/ambiguous-local-time.md @@ -1,9 +1,9 @@ --- -description: "Learn more about: ambiguous_local_time class" title: "ambiguous_local_time class" +description: "Learn more about: ambiguous_local_time class" ms.date: 10/08/2021 f1_keywords: ["chrono/std::chrono::ambiguous_local_time", "chrono/std::chrono::ambiguous_local_time::what"] -helpviewer_keywords: ["std::chrono [C++], ambiguous_local_time"] +helpviewer_keywords: ["std::chrono [C++], ambiguous_local_time"] dev_langs: ["C++"] --- diff --git a/docs/standard-library/any-functions.md b/docs/standard-library/any-functions.md index 27ebce791b9..aa9ef35d532 100644 --- a/docs/standard-library/any-functions.md +++ b/docs/standard-library/any-functions.md @@ -1,6 +1,6 @@ --- -description: "Learn more about the free functions for use with the std::any class in the C++ Standard Library." title: " functions" +description: "Learn more about the free functions for use with the std::any class in the C++ Standard Library." ms.date: 09/20/2021 f1_keywords: ["any/std::any_cast", "any/std::make_any", "any/std::swap"] no-loc: ["any", "std", "class"] @@ -11,7 +11,7 @@ The [``](any.md) header declares several free functions for working with th ## Functions -|   |   | +| Name | Description | |--|--| | [`any_cast`](#any_cast) | Makes an object into an `any`. | | [`make_any`](#make_any) | Takes values and creates an `any` object. | diff --git a/docs/standard-library/array-functions.md b/docs/standard-library/array-functions.md index a670f42c5bf..8ba4d4fcbca 100644 --- a/docs/standard-library/array-functions.md +++ b/docs/standard-library/array-functions.md @@ -1,45 +1,46 @@ --- -description: "Learn more about: functions" title: " functions" -ms.date: "11/04/2016" -f1_keywords: ["array/std::array::get", "array/std::get", "array/std::swap"] -ms.assetid: e0700a33-a833-4655-8735-16e71175efc8 -helpviewer_keywords: ["std::array [C++], get", "std::get [C++]", "std::swap [C++]"] +description: "Learn more about: functions" +ms.date: 08/20/2025 +f1_keywords: ["array/std::array::get", "array/std::get", "array/std::swap", "array/std::to_array"] +helpviewer_keywords: ["std::array [C++], get", "std::get [C++]", "std::swap [C++]", "std::to_array [C++]"] --- # `` functions -The \ header includes two non-member functions, `get` and `swap`, that operate on **array** objects. - -[get](#get)\ -[swap](#swap) +The `` header includes three non-member functions, `get`, `swap`, and `to_array` that operate on **array** objects. -## get +## `get` Returns a reference to the specified element of the array. ```cpp -template -constexpr T& get(array& arr) noexcept; +template +constexpr Type& get(std::array& arr) noexcept; -template -constexpr const T& get(const array& arr) noexcept; +template +constexpr const Type& get(const std::array& arr) noexcept; -template -constexpr T&& get(array&& arr) noexcept; +template +constexpr Type&& get(std::array&& arr) noexcept; + +template +constexpr const Type&& get(const std::array&& arr) noexcept; ``` -### Parameters +### Template parameters -*Index*\ +*`Index`*\ The element offset. -*T*\ +*`Type`*\ The type of an element. -*N*\ +*`Size`*\ The number of elements in the array. -*arr*\ +### Parameters + +*`arr`*\ The array to select from. ### Example @@ -74,27 +75,29 @@ int main() 1 3 ``` -## swap +## `swap` A non-member template specialization of `std::swap` that swaps two **array** objects. ```cpp -template -void swap(array& left, array& right); +template +void swap(std::array& left, std::array& right); ``` -### Parameters +### Template parameters -*Ty*\ +*`Type`*\ The type of an element. -*N*\ +*`Size`*\ The size of the array. -*left*\ +### Parameters + +*`left`*\ The first array to swap. -*right*\ +*`right`*\ The second array to swap. ### Remarks @@ -147,6 +150,74 @@ int main() 0 1 2 3 ``` +## `to_array` + +Converts a built-in array to a `std::array` object. + +```cpp +// C++20 +template +constexpr std::array, Size> to_array(Type (&arr)[Size]); + +// C++20 +template +constexpr std::array, Size> to_array(Type (&&arr)[Size]); +``` + +### Template parameters + +*`Type`*\ +The type of an element. + +*`Size`*\ +The size of the input array. + +### Parameters + +*`arr`*\ +The input array used for conversion. + +### Example + +```cpp +// std_to_array.cpp +// Requires /std:c++20 or later + +#include +#include + +int main() +{ + int arr1[]{ 1, 2, 3 }; + std::array arr2 = std::to_array(arr1); + + std::cout << "std::to_array(arr1):\n"; + for (const auto& i : arr2) + { + std::cout << i << " "; + } + std::cout << std::endl; + + // The size is 7 as it includes the null terminator + std::array arr3 = std::to_array("string"); + + std::cout << "\nstd::to_array(\"string\"):\n"; + for (const auto& i : arr3) + { + std::cout << i << " "; + } + std::cout << std::endl; +} +``` + +```Output +std::to_array(arr1): +1 2 3 + +std::to_array("string"): +s t r i n g +``` + ## See also -[\](../standard-library/array.md) +[``](array.md) diff --git a/docs/standard-library/array-operators.md b/docs/standard-library/array-operators.md index 866d09f22ef..64b0e538b99 100644 --- a/docs/standard-library/array-operators.md +++ b/docs/standard-library/array-operators.md @@ -1,27 +1,19 @@ --- -description: "Learn more about: operators" title: " operators" -ms.date: "11/04/2016" +description: "Learn more about: operators" +ms.date: 11/04/2016 f1_keywords: ["array/std::array::operator!=", "array/std::array::operator<", "array/std::array::operator<=", "array/std::array::operator>", "array/std::array::operator>=", "array/std::array::operator=="] -ms.assetid: c8f46282-f179-4909-9a01-639cb8e18c27 --- # `` operators -The \ header includes these **array** non-member comparison template functions. - -[operator!=](#op_neq)\ -[`operator>`](#op_gt)\ -[`operator>=`](#op_gt_eq)\ -[`operator<`](#op_lt)\ -[`operator<=`](#op_lt_eq)\ -[operator==](#op_eq_eq) +The `` header includes these **array** non-member comparison template functions. -## operator!= +## `operator!=` Array comparison, not equal. ```cpp -template +template bool operator!=( const array& left, const array& right); @@ -29,16 +21,16 @@ bool operator!=( ### Parameters -*Ty*\ +*`Ty`*\ The type of an element. -*N*\ +*`N`*\ The size of the array. -*left*\ +*`left`*\ Left container to compare. -*right*\ +*`right`*\ Right container to compare. ### Remarks @@ -94,7 +86,7 @@ true Array comparison, less than. ```cpp -template +template bool operator<( const array& left, const array& right); @@ -102,21 +94,21 @@ bool operator<( ### Parameters -*Ty*\ +*`Ty`*\ The type of an element. -*N*\ +*`N`*\ The size of the array. -*left*\ +*`left`*\ Left container to compare. -*right*\ +*`right`*\ Right container to compare. ### Remarks -The template function overloads `operator<` to compare two objects of class template [array Class](../standard-library/array-class-stl.md). The function returns `lexicographical_compare(left.begin(), left.end(), right.begin())`. +The template function overloads `operator<` to compare two objects of class template [`array`](../standard-library/array-class-stl.md). The function returns `lexicographical_compare(left.begin(), left.end(), right.begin())`. ### Example @@ -167,7 +159,7 @@ true Array comparison, less than or equal. ```cpp -template +template bool operator<=( const array& left, const array& right); @@ -175,16 +167,16 @@ bool operator<=( ### Parameters -*Ty*\ +*`Ty`*\ The type of an element. -*N*\ +*`N`*\ The size of the array. -*left*\ +*`left`*\ Left container to compare. -*right*\ +*`right`*\ Right container to compare. ### Remarks @@ -235,12 +227,12 @@ true false ``` -## operator== +## `operator==` Array comparison, equal. ```cpp -template +template bool operator==( const array& left, const array& right); @@ -248,21 +240,21 @@ bool operator==( ### Parameters -*Ty*\ +*`Ty`*\ The type of an element. -*N*\ +*`N`*\ The size of the array. -*left*\ +*`left`*\ Left container to compare. -*right*\ +*`right`*\ Right container to compare. ### Remarks -The template function overloads `operator==` to compare two objects of class template [array Class](../standard-library/array-class-stl.md). The function returns `equal(left.begin(), left.end(), right.begin())`. +The template function overloads `operator==` to compare two objects of class template [`array`](../standard-library/array-class-stl.md). The function returns `equal(left.begin(), left.end(), right.begin())`. ### Example @@ -313,7 +305,7 @@ false Array comparison, greater than. ```cpp -template +template bool operator>( const array& left, const array& right); @@ -321,16 +313,16 @@ bool operator>( ### Parameters -*Ty*\ +*`Ty`*\ The type of an element. -*N*\ +*`N`*\ The size of the array. -*left*\ +*`left`*\ Left container to compare. -*right*\ +*`right`*\ Right container to compare. ### Remarks @@ -386,7 +378,7 @@ true Array comparison, greater than or equal. ```cpp -template +template bool operator>=( const array& left, const array& right); @@ -394,16 +386,16 @@ bool operator>=( ### Parameters -*Ty*\ +*`Ty`*\ The type of an element. -*N*\ +*`N`*\ The size of the array. -*left*\ +*`left`*\ Left container to compare. -*right*\ +*`right`*\ Right container to compare. ### Remarks @@ -456,4 +448,4 @@ false ## See also -[\](../standard-library/array.md) +[``](../standard-library/array.md) diff --git a/docs/standard-library/array.md b/docs/standard-library/array.md index 85273440ba3..331316ee9e2 100644 --- a/docs/standard-library/array.md +++ b/docs/standard-library/array.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: " title: "" -ms.date: "11/04/2016" +description: "Learn more about: " +ms.date: 11/04/2016 f1_keywords: [""] helpviewer_keywords: ["array header"] --- @@ -45,6 +45,7 @@ Defines the container class template **array** and several supporting templates. |-|-| |[get](../standard-library/array-functions.md#get)|Get specified array element.| |[swap](../standard-library/array-functions.md#swap)|Exchanges the contents of one array with the contents of another array.| +| [`to_array`](array-functions.md#to_array) | Converts a built-in array to a `std::array` object. | ## See also diff --git a/docs/standard-library/atomic-functions.md b/docs/standard-library/atomic-functions.md index a8a8db35d41..9dcd5b5baed 100644 --- a/docs/standard-library/atomic-functions.md +++ b/docs/standard-library/atomic-functions.md @@ -1,41 +1,13 @@ --- -description: "Learn more about: functions" title: " functions" -ms.date: "07/11/2018" +description: "Learn more about: functions" +ms.date: 07/11/2018 f1_keywords: ["atomic/std::atomic_compare_exchange_strong", "atomic/std::atomic_compare_exchange_strong_explicit", "atomic/std::atomic_compare_exchange_weak", "atomic/std::atomic_compare_exchange_weak_explicit", "atomic/std::atomic_exchange", "atomic/std::atomic_exchange_explicit", "atomic/std::atomic_fetch_add", "atomic/std::atomic_fetch_add_explicit", "atomic/std::atomic_fetch_and", "atomic/std::atomic_fetch_and_explicit", "atomic/std::atomic_fetch_or", "atomic/std::atomic_fetch_or_explicit", "atomic/std::atomic_fetch_sub", "atomic/std::atomic_fetch_sub_explicit", "atomic/std::atomic_fetch_xor", "atomic/std::atomic_fetch_xor_explicit", "atomic/std::atomic_flag_clear", "atomic/std::atomic_flag_clear_explicit", "atomic/std::atomic_flag_test_and_set", "atomic/std::atomic_flag_test_and_set_explicit", "atomic/std::atomic_init", "atomic/std::atomic_is_lock_free", "atomic/std::atomic_load", "atomic/std::atomic_load_explicit", "atomic/std::atomic_signal_fence", "atomic/std::atomic_store", "atomic/std::atomic_store_explicit", "atomic/std::atomic_thread_fence", "atomic/std::kill_dependency"] helpviewer_keywords: ["std::atomic_compare_exchange_strong [C++]", "std::atomic_compare_exchange_strong_explicit [C++]", "std::atomic_compare_exchange_weak [C++]", "std::atomic_compare_exchange_weak_explicit [C++]", "std::atomic_exchange [C++]", "std::atomic_exchange_explicit [C++]", "std::atomic_fetch_add [C++]", "std::atomic_fetch_add_explicit [C++]", "std::atomic_fetch_and [C++]", "std::atomic_fetch_and_explicit [C++]", "std::atomic_fetch_or [C++]", "std::atomic_fetch_or_explicit [C++]", "std::atomic_fetch_sub [C++]", "std::atomic_fetch_sub_explicit [C++]", "std::atomic_fetch_xor [C++]", "std::atomic_fetch_xor_explicit [C++]", "std::atomic_flag_clear [C++]", "std::atomic_flag_clear_explicit [C++]", "std::atomic_flag_test_and_set [C++]", "std::atomic_flag_test_and_set_explicit [C++]", "std::atomic_init [C++]", "std::atomic_is_lock_free [C++]", "std::atomic_load [C++]", "std::atomic_load_explicit [C++]", "std::atomic_signal_fence [C++]", "std::atomic_store [C++]", "std::atomic_store_explicit [C++]", "std::atomic_thread_fence [C++]", "std::kill_dependency [C++]"] --- # `` functions -[atomic_compare_exchange_strong](#atomic_compare_exchange_strong)\ -[atomic_compare_exchange_strong_explicit](#atomic_compare_exchange_strong_explicit)\ -[atomic_compare_exchange_weak](#atomic_compare_exchange_weak)\ -[atomic_compare_exchange_weak_explicit](#atomic_compare_exchange_weak_explicit)\ -[atomic_exchange](#atomic_exchange)\ -[atomic_exchange_explicit](#atomic_exchange_explicit)\ -[atomic_fetch_add](#atomic_fetch_add)\ -[atomic_fetch_add_explicit](#atomic_fetch_add_explicit)\ -[atomic_fetch_and](#atomic_fetch_and)\ -[atomic_fetch_and_explicit](#atomic_fetch_and_explicit)\ -[atomic_fetch_or](#atomic_fetch_or)\ -[atomic_fetch_or_explicit](#atomic_fetch_or_explicit)\ -[atomic_fetch_sub](#atomic_fetch_sub)\ -[atomic_fetch_sub_explicit](#atomic_fetch_sub_explicit)\ -[atomic_fetch_xor](#atomic_fetch_xor)\ -[atomic_fetch_xor_explicit](#atomic_fetch_xor_explicit)\ -[atomic_flag_clear](#atomic_flag_clear)\ -[atomic_flag_clear_explicit](#atomic_flag_clear_explicit)\ -[atomic_flag_test_and_set](#atomic_flag_test_and_set)\ -[atomic_flag_test_and_set_explicit](#atomic_flag_test_and_set_explicit)\ -[atomic_init](#atomic_init)\ -[atomic_is_lock_free](#atomic_is_lock_free)\ -[atomic_load](#atomic_load)\ -[atomic_load_explicit](#atomic_load_explicit)\ -[atomic_signal_fence](#atomic_signal_fence)\ -[atomic_store](#atomic_store)\ -[atomic_store_explicit](#atomic_store_explicit)\ -[atomic_thread_fence](#atomic_thread_fence)\ -[kill_dependency](#kill_dependency) +The `` header provides the following functions: ## `atomic_compare_exchange_strong` @@ -676,8 +648,8 @@ A [`memory_order`](../standard-library/atomic-enums.md#memory_order_enum). Sets the **`bool`** flag in an [`atomic_flag`](../standard-library/atomic-flag-structure.md) object to **`true`**, within the constraints of the [`memory_order.memory_order_seq_cst`](../standard-library/atomic-enums.md#memory_order_enum). ```cpp -inline bool atomic_flag_test_and_set(volatile atomic_flag* Flag,) noexcept; -inline bool atomic_flag_test_and_set(atomic_flag* Flag,) noexcept; +inline bool atomic_flag_test_and_set(volatile atomic_flag* Flag) noexcept; +inline bool atomic_flag_test_and_set(atomic_flag* Flag) noexcept; ``` ### Parameters diff --git a/docs/standard-library/auto-ptr-class.md b/docs/standard-library/auto-ptr-class.md index 1b22c6ef9b1..3eda9ff3615 100644 --- a/docs/standard-library/auto-ptr-class.md +++ b/docs/standard-library/auto-ptr-class.md @@ -1,6 +1,6 @@ --- -description: "Learn more about: auto_ptr Class" title: "auto_ptr Class" +description: "Learn more about: auto_ptr Class" ms.date: 11/1/2023 f1_keywords: ["memory/std::auto_ptr", "memory/std::auto_ptr::element_type", "memory/std::auto_ptr::get", "memory/std::auto_ptr::release", "memory/std::auto_ptr::reset"] helpviewer_keywords: ["std::auto_ptr [C++]", "std::auto_ptr [C++], element_type", "std::auto_ptr [C++], get", "std::auto_ptr [C++], release", "std::auto_ptr [C++], reset"] @@ -20,8 +20,7 @@ For more information about `throw()` and exception handling, see [Exception Spec class auto_ptr { typedef Type element_type; explicit auto_ptr(Type* ptr = 0) throw(); - auto_ptr(auto_ptr& right) throw() - ; + auto_ptr(auto_ptr& right) throw(); template operator auto_ptr() throw(); template @@ -134,17 +133,17 @@ public: cout << "Constructing " << ( void* )this << endl; x = i; bIsConstructed = true; - }; + } ~Int( ) { cout << "Destructing " << ( void* )this << endl; bIsConstructed = false; - }; + } Int &operator++( ) { x++; return *this; - }; + } int x; private: bool bIsConstructed; @@ -211,11 +210,11 @@ public: { x = i; cout << "Constructing " << ( void* )this << " Value: " << x << endl; - }; + } ~Int( ) { cout << "Destructing " << ( void* )this << " Value: " << x << endl; - }; + } int x; @@ -377,7 +376,7 @@ public: int m_i; }; void f(auto_ptr arg) { -}; +} int main() { const auto_ptr ciap(new C(1)); @@ -433,10 +432,10 @@ public: { x = i; cout << "Constructing " << (void*)this << " Value: " << x << endl; - }; + } ~Int() { cout << "Destructing " << (void*)this << " Value: " << x << endl; - }; + } int x; @@ -493,11 +492,11 @@ public: { x = i; cout << "Constructing " << (void*)this << " Value: " << x << endl; - }; + } ~Int() { cout << "Destructing " << (void*)this << " Value: " << x << endl; - }; + } int x; }; diff --git a/docs/standard-library/back-insert-iterator-class.md b/docs/standard-library/back-insert-iterator-class.md index 41038cc72eb..2134ccf1b15 100644 --- a/docs/standard-library/back-insert-iterator-class.md +++ b/docs/standard-library/back-insert-iterator-class.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: back_insert_iterator Class" title: "back_insert_iterator Class" +description: "Learn more about: back_insert_iterator Class" ms.date: 06/07/2022 f1_keywords: ["iterator/std::back_insert_iterator", "iterator/std::back_insert_iterator::container_type", "iterator/std::back_insert_iterator::reference"] helpviewer_keywords: ["std::back_insert_iterator [C++]", "std::back_insert_iterator [C++], container_type", "std::back_insert_iterator [C++], reference"] -ms.assetid: a1ee07f2-cf9f-46a1-8608-cfaf207f9713 ms.custom: devdivchpfy22 --- # back_insert_iterator Class @@ -103,9 +102,9 @@ int main( ) // Alternatively, insertions can be done with template function back_insert_iterator > backiter ( vec ); -*backiter = 600; + *backiter = 600; backiter++; -*backiter = 700; + *backiter = 700; cout << "After the insertions, the vector vec is: ( "; for ( vIter = vec.begin ( ) ; vIter != vec.end ( ); vIter++) @@ -216,9 +215,9 @@ int main( ) cout << ")." << endl; back_insert_iterator > backiter ( vec ); -*backiter = 10; + *backiter = 10; backiter++; // Increment to the next element -*backiter = 20; + *backiter = 20; backiter++; cout << "After the insertions, the vector vec becomes: ( "; @@ -277,9 +276,9 @@ int main( ) cout << ")." << endl; back_insert_iterator > backiter ( vec ); -*backiter = 30; + *backiter = 30; backiter++; // Increment to the next element -*backiter = 40; + *backiter = 40; backiter++; cout << "After the insertions, the vector vec becomes: ( "; @@ -349,9 +348,9 @@ int main( ) cout << ")." << endl; back_insert_iterator > backiter ( vec ); -*backiter = 10; + *backiter = 10; backiter++; // Increment to the next element -*backiter = 20; + *backiter = 20; backiter++; cout << "After the insertions, the vector vec becomes: ( "; diff --git a/docs/standard-library/bad-alloc-class.md b/docs/standard-library/bad-alloc-class.md index 9cd3cc8bd87..f18b4ca87ec 100644 --- a/docs/standard-library/bad-alloc-class.md +++ b/docs/standard-library/bad-alloc-class.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: bad_alloc Class" title: "bad_alloc Class" +description: "Learn more about: bad_alloc Class" ms.date: "11/04/2016" f1_keywords: ["new/std::bad_alloc"] helpviewer_keywords: ["bad_alloc class"] -ms.assetid: 6429a8e6-5a49-4907-8d56-f4a4ec8131d0 --- # bad_alloc Class @@ -31,8 +30,8 @@ The value returned by `what` is an implementation-defined C string. None of the ```cpp // bad_alloc.cpp // compile with: /EHsc -#include -#include +#include +#include using namespace std; int main() { diff --git a/docs/standard-library/basic-fstream-class.md b/docs/standard-library/basic-fstream-class.md index 7ddc445a518..3a9f9883a8c 100644 --- a/docs/standard-library/basic-fstream-class.md +++ b/docs/standard-library/basic-fstream-class.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: basic_fstream Class" title: "basic_fstream Class" -ms.date: "11/04/2016" +description: "Learn more about: basic_fstream Class" +ms.date: 11/04/2016 f1_keywords: ["fstream/std::basic_fstream", "fstream/std::basic_fstream::close", "fstream/std::basic_fstream::is_open", "fstream/std::basic_fstream::open", "fstream/std::basic_fstream::rdbuf", "fstream/std::basic_fstream::swap"] helpviewer_keywords: ["std::basic_fstream [C++]", "std::basic_fstream [C++], close", "std::basic_fstream [C++], is_open", "std::basic_fstream [C++], open", "std::basic_fstream [C++], rdbuf", "std::basic_fstream [C++], swap"] -ms.assetid: 8473817e-42a4-430b-82b8-b476c86bcf8a --- # basic_fstream Class @@ -204,7 +203,7 @@ The default file opening protection, equivalent to the *shflag* parameter in [_f ### Remarks -The member function calls [rdbuf](#rdbuf) **->** [open](../standard-library/basic-filebuf-class.md#open)(_ *Filename*, `_Mode`). If that function returns a null pointer, the function calls [setstate](../standard-library/basic-ios-class.md#setstate)( `failbit`). +The member function calls [rdbuf](#rdbuf) **->** [open](../standard-library/basic-filebuf-class.md#open)(_ *Filename*, `_Mode`). If that function returns a null pointer, the function calls [setstate](../standard-library/basic-ios-class.md#setstate)(`failbit`). ### Example diff --git a/docs/standard-library/basic-istream-class.md b/docs/standard-library/basic-istream-class.md index f67eaa3dbfa..a5ebefeccee 100644 --- a/docs/standard-library/basic-istream-class.md +++ b/docs/standard-library/basic-istream-class.md @@ -1,6 +1,6 @@ --- -description: "Learn more about: basic_istream Class" title: "basic_istream Class" +description: "Learn more about: basic_istream Class" ms.date: 06/10/2022 f1_keywords: ["istream/std::basic_istream", "istream/std::basic_istream::gcount", "istream/std::basic_istream::get", "istream/std::basic_istream::getline", "istream/std::basic_istream::", "istream/std::basic_istream::peek", "istream/std::basic_istream::putback", "istream/std::basic_istream::read", "istream/std::basic_istream::readsome", "istream/std::basic_istream::seekg", "istream/std::basic_istream::sentry", "istream/std::basic_istream::swap", "istream/std::basic_istream::sync", "istream/std::basic_istream::tellg", "istream/std::basic_istream::unget"] helpviewer_keywords: ["std::basic_istream [C++]", "std::basic_istream [C++], gcount", "std::basic_istream [C++], get", "std::basic_istream [C++], getline", "std::basic_istream [C++], OVERWRITE", "std::basic_istream [C++], peek", "std::basic_istream [C++], putback", "std::basic_istream [C++], read", "std::basic_istream [C++], readsome", "std::basic_istream [C++], seekg", "std::basic_istream [C++], sentry", "std::basic_istream [C++], swap", "std::basic_istream [C++], sync", "std::basic_istream [C++], tellg", "std::basic_istream [C++], unget"] @@ -410,7 +410,7 @@ Type 'abcdef': abcdef def ``` -## `basic\_istream::operator>>` +## `basic_istream::operator>>` Calls a function on the input stream or reads formatted data from the input stream. @@ -451,7 +451,7 @@ The stream (`*this`). ### Remarks -The `` header also defines several global extraction operators. For more information, see [`operator>> (\)`](../standard-library/istream-operators.md#op_gt_gt). +The `` header also defines several global extraction operators. For more information, see [`operator>> ()`](../standard-library/istream-operators.md#op_gt_gt). The first member function ensures that an expression of the form `istr >> ws` calls `ws(istr)`, and then returns `*this`. For more information, see [`ws`](../standard-library/istream-functions.md#ws). diff --git a/docs/standard-library/basic-istream-view-class.md b/docs/standard-library/basic-istream-view-class.md index bac05a4dd9f..e1aa2cc2930 100644 --- a/docs/standard-library/basic-istream-view-class.md +++ b/docs/standard-library/basic-istream-view-class.md @@ -117,7 +117,7 @@ The best way to create a `basic_istream_view` is by using the [`views::istream`] ### Example: `basic_istream_view`, `istream_view`, and `wistream_view` ```cpp -// requires /std:c++20, or later +// requires /std:c++20 or later #include #include #include diff --git a/docs/standard-library/basic-istringstream-class.md b/docs/standard-library/basic-istringstream-class.md index 65784d35920..ddae99f87f7 100644 --- a/docs/standard-library/basic-istringstream-class.md +++ b/docs/standard-library/basic-istringstream-class.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: basic_istringstream Class" title: "basic_istringstream Class" +description: "Learn more about: basic_istringstream Class" ms.date: 06/10/2022 f1_keywords: ["sstream/std::basic_istringstream", "sstream/std::basic_istringstream::allocator_type", "sstream/std::basic_istringstream::rdbuf", "sstream/std::basic_istringstream::str", "sstream/std::basic_istringstream::swap"] helpviewer_keywords: ["std::basic_istringstream [C++]", "std::basic_istringstream [C++], allocator_type", "std::basic_istringstream [C++], rdbuf", "std::basic_istringstream [C++], str", "std::basic_istringstream [C++], swap"] -ms.assetid: 1d5bb4b5-793d-4833-98e5-14676c451915 ms.custom: devdivchpfy22 --- @@ -103,7 +102,7 @@ An rvalue reference of a `basic_istringstream` object. ### Remarks -The first constructor initializes the base class by calling `basic_istream]( sb )`, where `sb` is the stored object of class `basic_stringbuf< Elem, Tr, Alloc>`. It also initializes `sb` by calling `basic_stringbuf< Elem, Tr, Alloc >( _Mode | ios_base::in )`. For more information, see [`basic_istream`](../standard-library/basic-istream-class.md) and [`basic_stringbuf`](../standard-library/basic-stringbuf-class.md). +The first constructor initializes the base class by calling `basic_istream( sb )`, where `sb` is the stored object of class `basic_stringbuf< Elem, Tr, Alloc>`. It also initializes `sb` by calling `basic_stringbuf< Elem, Tr, Alloc >( _Mode | ios_base::in )`. For more information, see [`basic_istream`](../standard-library/basic-istream-class.md) and [`basic_stringbuf`](../standard-library/basic-stringbuf-class.md). The second constructor initializes the base class by calling `basic_istream( sb )`. It also initializes `sb` by calling `basic_stringbuf< Elem, Tr, Alloc >( str, _Mode | ios_base::in )`. @@ -164,7 +163,7 @@ Returns an object of class [basic_string](../standard-library/basic-string-class ### Remarks -The first member function returns [rdbuf](#rdbuf) -> [str](../standard-library/basic-stringbuf-class.md#str). The second member function calls `rdbuf` -> **str**( `_Newstr`). +The first member function returns [rdbuf](#rdbuf) -> [str](../standard-library/basic-stringbuf-class.md#str). The second member function calls `rdbuf` -> **str**(`_Newstr`). ### Example diff --git a/docs/standard-library/basic-ostream-class.md b/docs/standard-library/basic-ostream-class.md index 6365780620d..a2b1b7e6520 100644 --- a/docs/standard-library/basic-ostream-class.md +++ b/docs/standard-library/basic-ostream-class.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: basic_ostream Class" title: "basic_ostream Class" -ms.date: "03/27/2019" +description: "Learn more about: basic_ostream Class" +ms.date: 03/27/2019 f1_keywords: ["ostream/std::basic_ostream", "ostream/std::basic_ostream::flush", "ostream/std::basic_ostream::put", "ostream/std::basic_ostream::seekp", "ostream/std::basic_ostream::sentry", "ostream/std::basic_ostream::swap", "ostream/std::basic_ostream::tellp", "ostream/std::basic_ostream::write"] helpviewer_keywords: ["std::basic_ostream [C++]", "std::basic_ostream [C++], flush", "std::basic_ostream [C++], put", "std::basic_ostream [C++], seekp", "std::basic_ostream [C++], sentry", "std::basic_ostream [C++], swap", "std::basic_ostream [C++], tellp", "std::basic_ostream [C++], write"] -ms.assetid: 5baadc65-b662-4fab-8c9f-94457c58cda1 --- # basic_ostream Class @@ -449,12 +448,15 @@ int main() The nested class describes an object whose declaration structures the formatted output functions and the unformatted output functions. -class sentry { - public: - explicit sentry(basic_ostream\& _Ostr); - operator bool() const; - ~sentry(); - }; +```cpp +class sentry +{ +public: + explicit sentry(basic_ostream& _Ostr); + operator bool() const; + ~sentry(); +}; +``` ### Remarks diff --git a/docs/standard-library/basic-ostringstream-class.md b/docs/standard-library/basic-ostringstream-class.md index 1b79c1a3d2a..29ff6874a72 100644 --- a/docs/standard-library/basic-ostringstream-class.md +++ b/docs/standard-library/basic-ostringstream-class.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: basic_ostringstream Class" title: "basic_ostringstream Class" +description: "Learn more about: basic_ostringstream Class" ms.date: 06/10/2022 f1_keywords: ["sstream/std::basic_ostringstream", "sstream/std::basic_ostringstream::allocator_type", "sstream/std::basic_ostringstream::rdbuf", "sstream/std::basic_ostringstream::str"] helpviewer_keywords: ["std::basic_ostringstream [C++]", "std::basic_ostringstream [C++], allocator_type", "std::basic_ostringstream [C++], rdbuf", "std::basic_ostringstream [C++], str"] -ms.assetid: aea699f7-350f-432a-acca-adbae7b483fb ms.custom: devdivchpfy22 --- @@ -133,7 +132,7 @@ Returns an object of class [basic_string](../standard-library/basic-string-class ### Remarks -The first member function returns [rdbuf](#rdbuf) -> [str](../standard-library/basic-stringbuf-class.md#str). The second member function calls `rdbuf` -> **str**( `_Newstr`). +The first member function returns [rdbuf](#rdbuf) -> [str](../standard-library/basic-stringbuf-class.md#str). The second member function calls `rdbuf` -> **str**(`_Newstr`). ### Example diff --git a/docs/standard-library/basic-streambuf-class.md b/docs/standard-library/basic-streambuf-class.md index e6720817633..4a543f3fef7 100644 --- a/docs/standard-library/basic-streambuf-class.md +++ b/docs/standard-library/basic-streambuf-class.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: basic_streambuf Class" title: "basic_streambuf Class" +description: "Learn more about: basic_streambuf Class" ms.date: 06/10/2022 f1_keywords: ["streambuf/std::basic_streambuf", "streambuf/std::basic_streambuf::char_type", "streambuf/std::basic_streambuf::int_type", "streambuf/std::basic_streambuf::off_type", "streambuf/std::basic_streambuf::pos_type", "streambuf/std::basic_streambuf::traits_type", "streambuf/std::basic_streambuf::eback", "streambuf/std::basic_streambuf::egptr", "streambuf/std::basic_streambuf::epptr", "streambuf/std::basic_streambuf::gbump", "streambuf/std::basic_streambuf::getloc", "streambuf/std::basic_streambuf::gptr", "streambuf/std::basic_streambuf::imbue", "streambuf/std::basic_streambuf::in_avail", "streambuf/std::basic_streambuf::overflow", "streambuf/std::basic_streambuf::pbackfail", "streambuf/std::basic_streambuf::pbase", "streambuf/std::basic_streambuf::pbump", "streambuf/std::basic_streambuf::pptr", "streambuf/std::basic_streambuf::pubimbue", "streambuf/std::basic_streambuf::pubseekoff", "streambuf/std::basic_streambuf::pubseekpos", "streambuf/std::basic_streambuf::pubsetbuf", "streambuf/std::basic_streambuf::pubsync", "streambuf/std::basic_streambuf::sbumpc", "streambuf/std::basic_streambuf::seekoff", "streambuf/std::basic_streambuf::seekpos", "streambuf/std::basic_streambuf::setbuf", "streambuf/std::basic_streambuf::setg", "streambuf/std::basic_streambuf::setp", "streambuf/std::basic_streambuf::sgetc", "streambuf/std::basic_streambuf::sgetn", "streambuf/std::basic_streambuf::showmanyc", "streambuf/std::basic_streambuf::snextc", "streambuf/std::basic_streambuf::sputbackc", "streambuf/std::basic_streambuf::sputc", "streambuf/std::basic_streambuf::sputn", "streambuf/std::basic_streambuf::stossc", "streambuf/std::basic_streambuf::sungetc", "streambuf/std::basic_streambuf::swap", "streambuf/std::basic_streambuf::sync", "streambuf/std::basic_streambuf::uflow", "streambuf/std::basic_streambuf::underflow", "streambuf/std::basic_streambuf::xsgetn", "streambuf/std::basic_streambuf::xsputn"] helpviewer_keywords: ["std::basic_streambuf [C++]", "std::basic_streambuf [C++], char_type", "std::basic_streambuf [C++], int_type", "std::basic_streambuf [C++], off_type", "std::basic_streambuf [C++], pos_type", "std::basic_streambuf [C++], traits_type", "std::basic_streambuf [C++], eback", "std::basic_streambuf [C++], egptr", "std::basic_streambuf [C++], epptr", "std::basic_streambuf [C++], gbump", "std::basic_streambuf [C++], getloc", "std::basic_streambuf [C++], gptr", "std::basic_streambuf [C++], imbue", "std::basic_streambuf [C++], in_avail", "std::basic_streambuf [C++], overflow", "std::basic_streambuf [C++], pbackfail", "std::basic_streambuf [C++], pbase", "std::basic_streambuf [C++], pbump", "std::basic_streambuf [C++], pptr", "std::basic_streambuf [C++], pubimbue", "std::basic_streambuf [C++], pubseekoff", "std::basic_streambuf [C++], pubseekpos", "std::basic_streambuf [C++], pubsetbuf", "std::basic_streambuf [C++], pubsync", "std::basic_streambuf [C++], sbumpc", "std::basic_streambuf [C++], seekoff", "std::basic_streambuf [C++], seekpos", "std::basic_streambuf [C++], setbuf", "std::basic_streambuf [C++], setg", "std::basic_streambuf [C++], setp", "std::basic_streambuf [C++], sgetc", "std::basic_streambuf [C++], sgetn", "std::basic_streambuf [C++], showmanyc", "std::basic_streambuf [C++], snextc", "std::basic_streambuf [C++], sputbackc", "std::basic_streambuf [C++], sputc", "std::basic_streambuf [C++], sputn", "std::basic_streambuf [C++], stossc", "std::basic_streambuf [C++], sungetc", "std::basic_streambuf [C++], swap", "std::basic_streambuf [C++], sync", "std::basic_streambuf [C++], uflow", "std::basic_streambuf [C++], underflow", "std::basic_streambuf [C++], xsgetn", "std::basic_streambuf [C++], xsputn"] -ms.assetid: 136af6c3-13bf-4501-9288-b93da26efac7 ms.custom: devdivchpfy22 --- @@ -550,7 +549,7 @@ The size of the buffer. ### Return Value -Returns [setbuf](#setbuf)( `_Buffer`, `count`). +Returns [setbuf](#setbuf)(`_Buffer`, `count`). ## basic_streambuf::pubsync @@ -750,7 +749,7 @@ The current element. ### Remarks -If a read position is available, the member function returns **traits_type::**[to_int_type](../standard-library/char-traits-struct.md#to_int_type)( `*`[gptr](#gptr)). Otherwise, it returns [underflow](#underflow). +If a read position is available, the member function returns **traits_type::**[to_int_type](../standard-library/char-traits-struct.md#to_int_type)(`*`[gptr](#gptr)). Otherwise, it returns [underflow](#underflow). ### Example @@ -798,7 +797,7 @@ The number of elements read. For more information, see [streamsize](../standard- ### Remarks -The member function returns [xsgetn](#xsgetn)( `ptr`, `count`). +The member function returns [xsgetn](#xsgetn)(`ptr`, `count`). ### Example @@ -898,7 +897,7 @@ Returns the character or failure. ### Remarks -If a putback position is available and *_Ch* compares equal to the character stored in that position, the member function decrements the next pointer for the input buffer and returns **traits_type::**[to_int_type](../standard-library/char-traits-struct.md#to_int_type)( `_Ch`). Otherwise, it returns [pbackfail](#pbackfail)( `_Ch`). +If a putback position is available and *_Ch* compares equal to the character stored in that position, the member function decrements the next pointer for the input buffer and returns **traits_type::**[to_int_type](../standard-library/char-traits-struct.md#to_int_type)(`_Ch`). Otherwise, it returns [pbackfail](#pbackfail)(`_Ch`). ### Example @@ -946,7 +945,7 @@ Returns the character, if successful. ### Remarks -If a `write position` is available, the member function stores *_Ch* in the write position, increments the next pointer for the output buffer, and returns **traits_type::**[to_int_type](../standard-library/char-traits-struct.md#to_int_type)( `_Ch`). Otherwise, it returns [overflow](#overflow)( `_Ch`). +If a `write position` is available, the member function stores *_Ch* in the write position, increments the next pointer for the output buffer, and returns **traits_type::**[to_int_type](../standard-library/char-traits-struct.md#to_int_type)(`_Ch`). Otherwise, it returns [overflow](#overflow)(`_Ch`). ### Example @@ -992,7 +991,7 @@ The number of characters inserted into the stream. ### Remarks -The member function returns [xsputn](#xsputn)( `ptr`, `count`). For more information, see the Remarks section of this member for more information. +The member function returns [xsputn](#xsputn)(`ptr`, `count`). For more information, see the Remarks section of this member for more information. ### Example @@ -1061,7 +1060,7 @@ Returns either the character or failure. ### Remarks -If a putback position is available, the member function decrements the next pointer for the input buffer and returns `traits_type::`[to_int_type](../standard-library/char-traits-struct.md#to_int_type)( `*`[gptr](#gptr)). However, it isn't always possible to determine the last character read so that it can be captured in the state of the current buffer. If this is true, then the function returns [pbackfail](#pbackfail). To avoid this situation, keep track of the character to put back and call `sputbackc(ch)`, which won't fail provided you don't call it at the beginning of the stream and you don't try to put back more than one character. +If a putback position is available, the member function decrements the next pointer for the input buffer and returns `traits_type::`[to_int_type](../standard-library/char-traits-struct.md#to_int_type)(`*`[gptr](#gptr)). However, it isn't always possible to determine the last character read so that it can be captured in the state of the current buffer. If this is true, then the function returns [pbackfail](#pbackfail). To avoid this situation, keep track of the character to put back and call `sputbackc(ch)`, which won't fail provided you don't call it at the beginning of the stream and you don't try to put back more than one character. ### Example diff --git a/docs/standard-library/basic-string-class.md b/docs/standard-library/basic-string-class.md index 43c1e29f5c4..d91955cfbfc 100644 --- a/docs/standard-library/basic-string-class.md +++ b/docs/standard-library/basic-string-class.md @@ -1,5 +1,5 @@ --- -title: "basic_string Class" +title: "basic_string class" description: "API reference for the Standard C++ string class, `basic_string`." ms.date: 07/11/2023 f1_keywords: ["xstring/std::basic_string", "xstring/std::basic_string::allocator_type", "xstring/std::basic_string::const_iterator", "xstring/std::basic_string::const_pointer", "xstring/std::basic_string::const_reference", "xstring/std::basic_string::const_reverse_iterator", "xstring/std::basic_string::difference_type", "xstring/std::basic_string::iterator", "xstring/std::basic_string::npos", "xstring/std::basic_string::pointer", "xstring/std::basic_string::reference", "xstring/std::basic_string::reverse_iterator", "xstring/std::basic_string::size_type", "xstring/std::basic_string::traits_type", "xstring/std::basic_string::value_type", "xstring/std::basic_string::append", "xstring/std::basic_string::assign", "xstring/std::basic_string::at", "xstring/std::basic_string::back", "xstring/std::basic_string::begin", "xstring/std::basic_string::c_str", "xstring/std::basic_string::capacity", "xstring/std::basic_string::cbegin", "xstring/std::basic_string::cend", "xstring/std::basic_string::clear", "xstring/std::basic_string::compare", "xstring/std::basic_string::copy", "xstring/std::basic_string::crbegin", "xstring/std::basic_string::crend", "xstring/std::basic_string::_Copy_s", "xstring/std::basic_string::data", "xstring/std::basic_string::empty", "xstring/std::basic_string::end", "xstring/std::basic_string::erase", "xstring/std::basic_string::find", "xstring/std::basic_string::find_first_not_of", "xstring/std::basic_string::find_first_of", "xstring/std::basic_string::find_last_not_of", "xstring/std::basic_string::find_last_of", "xstring/std::basic_string::front", "xstring/std::basic_string::get_allocator", "xstring/std::basic_string::insert", "xstring/std::basic_string::length", "xstring/std::basic_string::max_size", "xstring/std::basic_string::pop_back", "xstring/std::basic_string::push_back", "xstring/std::basic_string::rbegin", "xstring/std::basic_string::rend", "xstring/std::basic_string::replace", "xstring/std::basic_string::reserve", "xstring/std::basic_string::resize", "xstring/std::basic_string::rfind", "xstring/std::basic_string::shrink_to_fit", "xstring/std::basic_string::size", "xstring/std::basic_string::substr", "xstring/std::basic_string::ends_with", "xstring/std::basic_string::starts_with", "xstring/std::basic_string::swap", 'xstring/std::literals::string_literals', 'std::literals::string_literals', 'string_literals', 'xstring/std::literals::string_literals::operator "s', 'std::literals::string_literals::operator s'] @@ -7,7 +7,7 @@ helpviewer_keywords: ["std::basic_string [C++]", "std::basic_string [C++], alloc ms.custom: devdivchpfy22 --- -# `basic_string` Class +# `basic_string` class The sequences controlled by an object of type `basic_string` are the Standard C++ string class and are referred to as strings, but they shouldn't be confused with the null-terminated C-style strings used throughout the C++ Standard Library. The Standard C++ string is a container that enables the use of strings as normal types, such as comparison and concatenation operations, iterators, C++ Standard Library algorithms, and copying and assigning with class allocator-managed memory. If you need to convert a Standard C++ string to a null-terminated C-style string, use the [`basic_string::c_str`](#c_str) member. @@ -18,13 +18,13 @@ template , class Allocator class basic_string; ``` -### Parameters +### Template parameters *`CharType`*\ -The data type of a single character to be stored in the string. The C++ Standard Library provides specializations of this class template, with the type definitions [`string`](../standard-library/string-typedefs.md#string) for elements of type `char`, [`wstring`](../standard-library/string-typedefs.md#wstring), for `wchar_t`, [`u16string`](../standard-library/string-typedefs.md#u16string) for `char16_t`, and [`u32string`](../standard-library/string-typedefs.md#u32string) for `char32_t`. +The data type of a single character to be stored in the string. The C++ Standard Library provides specializations of this class template, with the type definitions [`string`](string-typedefs.md#string) for elements of type `char`, [`wstring`](string-typedefs.md#wstring), for `wchar_t`, [`u16string`](string-typedefs.md#u16string) for `char16_t`, and [`u32string`](string-typedefs.md#u32string) for `char32_t`. *`Traits`*\ -Various important properties of the `CharType` elements in a basic_string specialization are described by the class `Traits`. The default value is `char_traits`<`CharType`>. +Various important properties of the `CharType` elements in a `basic_string` specialization are described by the class `Traits`. The default value is `char_traits`<`CharType`>. *`Allocator`*\ The type that represents the stored allocator object that encapsulates details about the string's allocation and deallocation of memory. The default value is `allocator`. @@ -61,7 +61,7 @@ The type that represents the stored allocator object that encapsulates details a |[`append`](#append)|Adds characters to the end of a string.| |[`assign`](#assign)|Assigns new character values to the contents of a string.| |[`at`](#at)|Returns a reference to the element at a specified location in the string.| -|[`back`](#back)|| +|[`back`](#back)|Returns a reference to the last element in the string.| |[`begin`](#begin)|Returns an iterator addressing the first element in the string.| |[`c_str`](#c_str)|Converts the contents of a string as a C-style, null-terminated, string.| |[`capacity`](#capacity)|Returns the largest number of elements that could be stored in a string without increasing the memory allocation of the string.| @@ -117,22 +117,22 @@ The headers that define `basic_string` also define the following [user-defined l | Declaration | Description | |--|--| | `inline string operator"" s(const char* str, size_t len)` | Returns: `string(str, len)` | -| `inline string operator"" s(const wchar_t* str, size_t len)` | Returns: `wstring(str, len)` | +| `inline wstring operator"" s(const wchar_t* str, size_t len)` | Returns: `wstring(str, len)` | | `inline basic_string operator"" s(const char8_t* str, size_t len)` | Returns: `basic_string(str, len)` | | `inline u16string operator"" s(const char16_t* str, size_t len)` | Returns: `u16string(str, len)` | | `inline u32string operator"" s(const char32_t* str, size_t len)` | Returns: `u32string(str, len)` | ## Remarks -If a function is asked to generate a sequence longer than [`max_size`](#max_size) elements, the function reports a length error by throwing an object of type [`length_error`](../standard-library/length-error-class.md). +If a function is asked to generate a sequence longer than [`max_size`](#max_size) elements, the function reports a length error by throwing an object of type [`length_error`](length-error-class.md). References, pointers, and iterators that designate elements of the controlled sequence can become invalid after any call to a function that alters the controlled sequence, or after the first call to a non-`const` member function. ## Requirements -**Header:** \ +**Header:** `` -**Namespace:** std +**Namespace:** `std` ## `basic_string::allocator_type` @@ -279,12 +279,12 @@ int main( ) // appending one string to another in two ways, // comparing append and operator [ ] string str1d ( "Hello " ), str2d ( "Wide " ), str3d ( "World " ); - cout << "The string str2d is: " << str2d << endl; + cout << "The string str2d is: " << str2d << endl; str1d.append ( str2d ); cout << "The appended string str1d is: " << str1d << "." << endl; str1d += str3d; - cout << "The doubly appended strig str1 is: " + cout << "The doubly appended string str1 is: " << str1d << "." << endl << endl; // The fifth member function @@ -316,9 +316,9 @@ Appending the 1st part of the C-string cstr1b to string str1 gives: Hello Out. The string str2c is: Wide World The appended string str1 is: Hello World. -The string str2d is: Wide +The string str2d is: Wide The appended string str1d is: Hello Wide . -The doubly appended strig str1 is: Hello Wide World . +The doubly appended string str1 is: Hello Wide World . The string str1 appended with exclamations is: Hello !!!! @@ -379,10 +379,10 @@ The source string whose characters are to be assigned to the target string. The character value to be assigned. *`first`*\ -An input iterator, const_pointer, or const_iterator addressing the first character in the range of the source string to be assigned to the target range. +An input iterator, `const_pointer`, or `const_iterator` addressing the first character in the range of the source string to be assigned to the target range. *`last`*\ -An input iterator, const_pointer, or const_iterator addressing the one beyond the last character in the range of the source string to be assigned to the target range. +An input iterator, `const_pointer`, or `const_iterator` addressing the one beyond the last character in the range of the source string to be assigned to the target range. *`off`*\ The position at which new characters will start to be assigned. @@ -417,7 +417,7 @@ int main( ) << str1a << "." << endl << endl; // The second member function assigning a specific - // number of the of characters a C-string to a string + // number of characters of a C-string to a string string str1b; const char *cstr1b = "Out There"; cout << "The C-string cstr1b is: " << cstr1b << endl; @@ -452,7 +452,7 @@ int main( ) // number of characters of a certain value to a string string str1e ( "Hello " ); str1e.assign ( 4 , '!' ); - cout << "The string str1 assigned with eclamations is: " + cout << "The string str1 assigned with exclamations is: " << str1e << endl << endl; // The sixth member function assigning the value from @@ -481,7 +481,7 @@ The string str1 newly assigned with string str2d is: Wide. The string str3d is: World. The string str1 reassigned with string str3d is: World. -The string str1 assigned with eclamations is: !!!! +The string str1 assigned with exclamations is: !!!! The string str2f is: Wide World The string str1 assigned a range of string str2f is: World. @@ -512,7 +512,7 @@ The first element of the string has an index of zero and the following elements The member [`operator[]`](#op_at) is faster than the member function `at` for providing read and write access to the elements of a string. -The member `operator[]` doesn't check whether the index passed as a parameter is valid but the member function `at` does and so should be used if the validity isn't certain. An invalid index, which is an index less that zero or greater than or equal to the size of the string, passed to the member function `at` throws an [`out_of_range` Class](../standard-library/out-of-range-class.md) exception. An invalid index passed to the `operator[]` results in undefined behavior, but the index equal to the length of the string is a valid index for const strings and the operator returns the null-character when passed this index. +The member `operator[]` doesn't check whether the index passed as a parameter is valid but the member function `at` does and so should be used if the validity isn't certain. An invalid index, which is an index less than zero or greater than or equal to the size of the string, passed to the member function `at` throws an [`out_of_range` Class](out-of-range-class.md) exception. An invalid index passed to the `operator[]` results in undefined behavior, but the index equal to the length of the string is a valid index for const strings and the operator returns the null-character when passed this index. The reference returned may be invalidated by string reallocations or modifications for the non-`const` strings. @@ -569,8 +569,6 @@ reference back(); A reference to the last element of the string, which must be non-empty. -### Remarks - ## `basic_string::basic_string` Constructs a string that is empty, initialized by specific characters, or is a copy of all or part of another string object or C style (null-terminated) string. @@ -664,10 +662,10 @@ The index of a character in a string that is the first to be used to initialize The character value to be copied into the string being constructed. *`first`*\ -An input iterator, const_pointer, or const_iterator addressing the first element in the source range to be inserted. +An input iterator, `const_pointer`, or `const_iterator` addressing the first element in the source range to be inserted. *`last`*\ -An input iterator, const_pointer, or const_iterator addressing the position of the one beyond the last element in the source range to be inserted. +An input iterator, `const_pointer`, or `const_iterator` addressing the position of the one beyond the last element in the source range to be inserted. ### Return value @@ -677,7 +675,7 @@ A reference to the string object that is being constructed by the constructors. All constructors store a [`basic_string::allocator_type`](#allocator_type) and initialize the controlled sequence. The allocator object is the argument `al`, if present. For the copy constructor, it's `right.get_allocator()`, a call to [`basic_string::get_allocator`](#get_allocator). Otherwise, the allocator is `Alloc()`. -The controlled sequence is initialized to a copy of the operand sequence specified by the remaining operands. A constructor without an operand sequence specifies an empty initial controlled sequence. If `InputIterator` is an integer type in a template constructor, the operand sequence `first, last` behaves the same as `(size_type) first, (value_type) last`. +The controlled sequence is initialized to a copy of the operand sequence specified by the remaining operands. A constructor without an operand sequence specifies an empty initial controlled sequence. If `InputIterator` is an integer type in a template constructor, the operand sequence `first, last` behaves the same as `(size_type) first, (value_type) last`. ### Example @@ -762,7 +760,7 @@ int main( ) { cout << "The full original string str1 is: " << str1 << endl; // The dereferenced iterator can be used to modify a character -*str1_Iter = 'G'; + *str1_Iter = 'G'; cout << "The first character of the modified str1 is now: " << *str1_Iter << endl; cout << "The full modified string str1 is now: " << str1 << endl; @@ -1048,7 +1046,7 @@ int compare( int compare( size_type position_1, size_type number_1, - const value_type* ptr + const value_type* ptr, size_type number_2) const; ``` @@ -1081,7 +1079,7 @@ A negative value if the operand string is less than the parameter string; zero i ### Remarks -The `compare` member functions compare either all, or part, of the parameter and operand strings depending on which in used. +The `compare` member functions compare either all, or part, of the parameter and operand strings depending on which is used. The comparison is case-sensitive. @@ -1473,8 +1471,6 @@ const_reverse_iterator crend() const; A `const` reverse iterator that addresses the location succeeding the last element in a reversed string (the location that had preceded the first element in the unreversed string). -### Remarks - ## `basic_string::_Copy_s` Copies at most a specified number of characters from an indexed position in a source string to a target character array. @@ -1782,7 +1778,7 @@ int main( ) if ( str2.begin( ) == str2.end ( ) ) cout << "The string str2 is empty." << endl; else - cout << "The stringstr2 is not empty." << endl; + cout << "The string str2 is not empty." << endl; } ``` @@ -1830,7 +1826,7 @@ See [`starts_with`](#starts_with) to check if a string starts with the specified ### Example ```cpp -// Requires /std:c++20 or /std:c++latest +// Requires /std:c++20 or later #include #include @@ -2451,7 +2447,7 @@ int main( ) << "position is: " << indexCh3b << endl << endl; else cout << "Elements of the substring '5G' were not " - << "found in str3\n after the first occurrrence." + << "found in str3\n after the first occurrence." << endl << endl; // The fourth member function searches a string @@ -2885,8 +2881,6 @@ reference front(); A reference to the first element of the string, which must be non-empty. -### Remarks - ## `basic_string::get_allocator` Returns a copy of the allocator object used to construct the string. @@ -2959,12 +2953,10 @@ basic_string& insert( size_type count, value_type char_value); -iterator insert( - iterator iter); - iterator insert( iterator iter, - value_type char_value)l + value_type char_value); + template void insert( iterator iter, @@ -3208,7 +3200,7 @@ The maximum number of characters a string could contain. ### Remarks -An exception of type [`length_error` Class](../standard-library/length-error-class.md) is thrown when an operation produces a string with a length greater than the maximum size. +An exception of type [`length_error` Class](length-error-class.md) is thrown when an operation produces a string with a length greater than the maximum size. ### Example @@ -3352,7 +3344,7 @@ int main( ) cout << "The appended string str1d is: " << str1d << "." << endl; str1d += str3d; - cout << "The doubly appended strig str1 is: " + cout << "The doubly appended string str1 is: " << str1d << "." << endl << endl; } ``` @@ -3366,7 +3358,7 @@ Appending the C-string cstr1b to string str1 gives: Hello Out There. The string str2d is: Wide The appended string str1d is: Hello Wide . -The doubly appended strig str1 is: Hello Wide World. +The doubly appended string str1 is: Hello Wide World. ``` ## `basic_string::operator=` @@ -3487,11 +3479,11 @@ The first element of the string has an index of zero, and the following elements `operator[]` is faster than the member function [`at`](#at) for providing read and write access to the elements of a string. -`operator[]` doesn't check whether the index passed as a parameter is valid, but the member function `at` does and so should be used in the validity isn't certain. An invalid index (an index less that zero or greater than or equal to the size of the string) passed to the member function `at` throws an [`out_of_range` Class](../standard-library/out-of-range-class.md) exception. An invalid index passed to `operator[]` results in undefined behavior, but the index equal to the length of the string is a valid index for const strings and the operator returns the null character when passed this index. +`operator[]` doesn't check whether the index passed as a parameter is valid, but the member function `at` does and so should be used if the validity isn't certain. An invalid index (an index less than zero or greater than or equal to the size of the string) passed to the member function `at` throws an [`out_of_range` Class](out-of-range-class.md) exception. An invalid index passed to `operator[]` results in undefined behavior, but the index equal to the length of the string is a valid index for const strings and the operator returns the null character when passed this index. The reference returned may be invalidated by string reallocations or modifications for the non-`const` strings. -When compiling with [`_ITERATOR_DEBUG_LEVEL`](../standard-library/iterator-debug-level.md) set to 1 or 2, a runtime error will occur if you attempt to access an element outside the bounds of the string. For more information, see [Checked Iterators](../standard-library/checked-iterators.md). +When compiling with [`_ITERATOR_DEBUG_LEVEL`](iterator-debug-level.md) set to 1 or 2, a runtime error will occur if you attempt to access an element outside the bounds of the string. For more information, see [Checked Iterators](checked-iterators.md). ### Example @@ -3698,7 +3690,7 @@ int main( ) if ( str2.rbegin( ) == str2.rend ( ) ) cout << "The string str2 is empty." << endl; else - cout << "The stringstr2 is not empty." << endl; + cout << "The string str2 is not empty." << endl; } ``` @@ -3796,7 +3788,7 @@ int main( ) if ( str2.rbegin( ) == str2.rend ( ) ) cout << "The string str2 is empty." << endl; else - cout << "The stringstr2 is not empty." << endl; + cout << "The string str2 is not empty." << endl; } ``` @@ -3916,10 +3908,10 @@ An iterator addressing the first character to be removed in the operand string. An iterator addressing the last character to be removed in the operand string. *`first`*\ -An iterator, const_pointer, or const_iterator addressing the first character to be copied in the parameter string. +An iterator, `const_pointer`, or `const_iterator` addressing the first character to be copied in the parameter string. *`last`*\ -An iterator, const_pointer, or const_iterator addressing the last character to be copied in the parameter string. +An iterator, `const_pointer`, or `const_iterator` addressing the last character to be copied in the parameter string. *`count`*\ The number of times *`char_value`* is copied into the operand string. @@ -4159,7 +4151,7 @@ int main( ) sizerStr1 = str1.size ( ); caprStr1 = str1.capacity ( ); - cout << "The string str1with augmented capacity is: " + cout << "The string str1 with augmented capacity is: " << str1 << endl; cout << "The current size of string str1 is: " << sizerStr1 << "." << endl; @@ -4188,7 +4180,7 @@ The original string str1 is: Hello world The current size of original string str1 is: 11. The capacity of original string str1 is: 15. -The string str1with augmented capacity is: Hello world +The string str1 with augmented capacity is: Hello world The current size of string str1 is: 11. The new capacity of string str1 is: 47. @@ -4203,7 +4195,7 @@ Specifies a new size for a string, appending or erasing elements as required. ```cpp void resize( - size_type count,); + size_type count); void resize( size_type count, @@ -4654,7 +4646,7 @@ See [`ends_with`](#ends_with) to see if a string ends with the specified suffix. ### Example ```cpp -// Requires /std:c++20 or /std:c++latest +// Requires /std:c++20 or later #include #include @@ -4813,7 +4805,7 @@ For type `string`, it's equivalent to `char_traits`. ### Example -See the example for [`copy`](../standard-library/char-traits-struct.md#copy) for an example of how to declare and use `traits_type`. +See the example for [`copy`](char-traits-struct.md#copy) for an example of how to declare and use `traits_type`. ## `basic_string::value_type` @@ -4855,5 +4847,5 @@ The character ch2 is: H. ## See also -[``](../standard-library/string.md)\ -[Thread safety in the C++ standard library](../standard-library/thread-safety-in-the-cpp-standard-library.md) +[``](string.md)\ +[Thread safety in the C++ standard library](thread-safety-in-the-cpp-standard-library.md) diff --git a/docs/standard-library/basic-string-view-class.md b/docs/standard-library/basic-string-view-class.md index fda26ef3f89..c92f5cb34cf 100644 --- a/docs/standard-library/basic-string-view-class.md +++ b/docs/standard-library/basic-string-view-class.md @@ -1,9 +1,9 @@ --- title: "basic_string_view Class" description: "API reference for `basic_string_view`, which refers to a constant contiguous sequence of char-like objects." -ms.date: "9/8/2020" +ms.date: 9/8/2020 f1_keywords: ["xstring/std::basic_string_view", "xstring/std::basic_string_view::allocator_type", "xstring/std::basic_string_view::const_iterator", "xstring/std::basic_string_view::const_pointer", "xstring/std::basic_string_view::const_reference", "xstring/std::basic_string_view::const_reverse_iterator", "xstring/std::basic_string_view::difference_type", "xstring/std::basic_string_view::ends_with", "xstring/std::basic_string_view::starts_with", "xstring/std::basic_string_view::iterator", "xstring/std::basic_string_view::npos", "xstring/std::basic_string_view::pointer", "xstring/std::basic_string_view::reference", "xstring/std::basic_string_view::reverse_iterator", "xstring/std::basic_string_view::size_type", "xstring/std::basic_string_view::traits_type", "xstring/std::basic_string_view::value_type", "xstring/std::basic_string_view::append", "xstring/std::basic_string_view::assign", "xstring/std::basic_string_view::at", "xstring/std::basic_string_view::back", "xstring/std::basic_string_view::begin", "xstring/std::basic_string_view::c_str", "xstring/std::basic_string_view::capacity", "xstring/std::basic_string_view::cbegin", "xstring/std::basic_string_view::cend", "xstring/std::basic_string_view::clear", "xstring/std::basic_string_view::compare", "xstring/std::basic_string_view::copy", "xstring/std::basic_string_view::_Copy_s", "xstring/std::basic_string_view::crbegin", "xstring/std::basic_string_view::crend", "xstring/std::basic_string_view::data", "xstring/std::basic_string_view::empty", "xstring/std::basic_string_view::end", "xstring/std::basic_string_view::erase", "xstring/std::basic_string_view::find", "xstring/std::basic_string_view::find_first_not_of", "xstring/std::basic_string_view::find_first_of", "xstring/std::basic_string_view::find_last_not_of", "xstring/std::basic_string_view::find_last_of", "xstring/std::basic_string_view::front", "xstring/std::basic_string_view::get_allocator", "xstring/std::basic_string_view::insert", "xstring/std::basic_string_view::length", "xstring/std::basic_string_view::max_size", "xstring/std::basic_string_view::pop_back", "xstring/std::basic_string_view::push_back", "xstring/std::basic_string_view::rbegin", "xstring/std::basic_string_view::rend", "xstring/std::basic_string_view::remove_prefix","xstring/std::basic_string_view::remove_suffix", "xstring/std::basic_string_view::replace", "xstring/std::basic_string_view::reserve", "xstring/std::basic_string_view::resize", "xstring/std::basic_string_view::rfind", "xstring/std::basic_string_view::shrink_to_fit", "xstring/std::basic_string_view::size", "xstring/std::basic_string_view::substr", "xstring/std::basic_string_view::swap"] -helpviewer_keywords: ["std::basic_string_view", "std::basic_string_view, allocator_type", "std::basic_string_view, const_iterator", "std::basic_string_view, const_pointer", "std::basic_string_view, const_reference", "std::basic_string_view, const_reverse_iterator", "std::basic_string_view, difference_type", "std::basic_string_view, iterator", "std::basic_string_view, npos", "std::basic_string_view, pointer", "std::basic_string_view, reference", "std::basic_string_view, reverse_iterator", "std::basic_string_view, size_type", "std::basic_string_view, traits_type", "std::basic_string_view, value_type", "std::basic_string_view, append", "std::basic_string_view, assign", "std::basic_string_view, at", "std::basic_string_view, back", "std::basic_string_view, begin", "std::basic_string_view, c_str", "std::basic_string_view, capacity", "std::basic_string_view, cbegin", "std::basic_string_view, cend", "std::basic_string_view, clear", "std::basic_string_view, compare", "std::basic_string_view, copy", "std::basic_string_view, crbegin", "std::basic_string_view, crend", "std::basic_string_view, data", "std::basic_string_view, empty", "std::basic_string_view, end", "std::basic_string_view, ends_with", "std::basic_string_view, erase", "std::basic_string_view, find", "std::basic_string_view, find_first_not_of", "std::basic_string_view, find_first_of", "std::basic_string_view, find_last_not_of", "std::basic_string_view, find_last_of", "std::basic_string_view, front", "std::basic_string_view, get_allocator", "std::basic_string_view, insert", "std::basic_string_view, length", "std::basic_string_view, max_size", "std::basic_string_view, pop_back", "std::basic_string_view, push_back", "std::basic_string_view, rbegin", "std::basic_string_view, rend", "std::basic_string_view, remove_prefix","std::basic_string_view, remove_suffix","std::basic_string_view, replace", "std::basic_string_view, reserve", "std::basic_string_view, resize", "std::basic_string_view, rfind", "std::basic_string_view, shrink_to_fit", "std::basic_string_view, size", "std::basic_string_view, starts_with", "std::basic_string_view, substr", "std::basic_string_view, swap"] +helpviewer_keywords: ["std::basic_string_view", "std::basic_string_view, allocator_type", "std::basic_string_view, const_iterator", "std::basic_string_view, const_pointer", "std::basic_string_view, const_reference", "std::basic_string_view, const_reverse_iterator", "std::basic_string_view, difference_type", "std::basic_string_view, iterator", "std::basic_string_view, npos", "std::basic_string_view, pointer", "std::basic_string_view, reference", "std::basic_string_view, reverse_iterator", "std::basic_string_view, size_type", "std::basic_string_view, traits_type", "std::basic_string_view, value_type", "std::basic_string_view, append", "std::basic_string_view, assign", "std::basic_string_view, at", "std::basic_string_view, back", "std::basic_string_view, begin", "std::basic_string_view, c_str", "std::basic_string_view, capacity", "std::basic_string_view, cbegin", "std::basic_string_view, cend", "std::basic_string_view, clear", "std::basic_string_view, compare", "std::basic_string_view, copy", "std::basic_string_view, crbegin", "std::basic_string_view, crend", "std::basic_string_view, data", "std::basic_string_view, empty", "std::basic_string_view, end", "std::basic_string_view, ends_with", "std::basic_string_view, erase", "std::basic_string_view, find", "std::basic_string_view, find_first_not_of", "std::basic_string_view, find_first_of", "std::basic_string_view, find_last_not_of", "std::basic_string_view, find_last_of", "std::basic_string_view, front", "std::basic_string_view, get_allocator", "std::basic_string_view, insert", "std::basic_string_view, length", "std::basic_string_view, max_size", "std::basic_string_view, pop_back", "std::basic_string_view, push_back", "std::basic_string_view, rbegin", "std::basic_string_view, rend", "std::basic_string_view, remove_prefix","std::basic_string_view, remove_suffix","std::basic_string_view, replace", "std::basic_string_view, reserve", "std::basic_string_view, resize", "std::basic_string_view, rfind", "std::basic_string_view, shrink_to_fit", "std::basic_string_view, size", "std::basic_string_view, starts_with", "std::basic_string_view, substr", "std::basic_string_view, swap"] --- # `basic_string_view` class @@ -138,7 +138,7 @@ If a function is asked to generate a sequence longer than [`max_size`](#max_size ## Requirements -[`std:c++17`](../build/reference/std-specify-language-standard-version.md) or later. +[`/std:c++17`](../build/reference/std-specify-language-standard-version.md) or later. **Header:** `` @@ -610,7 +610,7 @@ See [`starts_with`](#starts_with) to check if a string view starts with the spec ### Example ```cpp -// Requires /std:c++20 or /std:c++latest +// Requires /std:c++20 or later #include #include @@ -1013,14 +1013,14 @@ Null-terminated character string containing the prefix to look for. ### Remarks -`starts_with()` is new in C++20. To use it, specify the [`std:c++20`](../build/reference/std-specify-language-standard-version.md) or later compiler option. +`starts_with()` is new in C++20. To use it, specify the [`/std:c++20`](../build/reference/std-specify-language-standard-version.md) or later compiler option. See [`ends_with`](#ends_with) to see if a string ends with a suffix. ### Example ```cpp -// Requires /std:c++20 or /std:c++latest +// Requires /std:c++20 or later #include #include diff --git a/docs/standard-library/basic-stringbuf-class.md b/docs/standard-library/basic-stringbuf-class.md index 465e997c4f4..7fde918659b 100644 --- a/docs/standard-library/basic-stringbuf-class.md +++ b/docs/standard-library/basic-stringbuf-class.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: basic_stringbuf Class" title: "basic_stringbuf Class" +description: "Learn more about: basic_stringbuf Class" ms.date: 06/10/2022 f1_keywords: ["sstream/std::basic_stringbuf", "sstream/std::basic_stringbuf::allocator_type", "sstream/std::basic_stringbuf::char_type", "sstream/std::basic_stringbuf::int_type", "sstream/std::basic_stringbuf::off_type", "sstream/std::basic_stringbuf::pos_type", "sstream/std::basic_stringbuf::traits_type", "sstream/std::basic_stringbuf::overflow", "sstream/std::basic_stringbuf::pbackfail", "sstream/std::basic_stringbuf::seekoff", "sstream/std::basic_stringbuf::seekpos", "sstream/std::basic_stringbuf::str", "sstream/std::basic_stringbuf::underflow"] helpviewer_keywords: ["std::basic_stringbuf [C++]", "std::basic_stringbuf [C++], allocator_type", "std::basic_stringbuf [C++], char_type", "std::basic_stringbuf [C++], int_type", "std::basic_stringbuf [C++], off_type", "std::basic_stringbuf [C++], pos_type", "std::basic_stringbuf [C++], traits_type", "std::basic_stringbuf [C++], overflow", "std::basic_stringbuf [C++], pbackfail", "std::basic_stringbuf [C++], seekoff", "std::basic_stringbuf [C++], seekpos", "std::basic_stringbuf [C++], str", "std::basic_stringbuf [C++], underflow"] -ms.assetid: 40c85f9e-42a5-4a65-af5c-23c8e3bf8113 ms.custom: devdivchpfy22 --- @@ -365,8 +364,6 @@ void basic_stringbuf::swap(basic_stringbuf& other) *other*\ The basic_stringbuf whose contents will be swapped with this basic_stringbuf. -### Remarks - ## basic_stringbuf::operator= Assigns the contents of the basic_stringbuf on the right side of the operator to the basic_stringbuf on the left side. @@ -380,8 +377,6 @@ basic_stringbuf& basic_stringbuf:: operator=(const basic_stringbuf& other) *other*\ A basic_stringbuf whose contents, including locale traits, will be assigned to the stringbuf on the left side of the operator. -### Remarks - ## See also [Thread Safety in the C++ Standard Library](../standard-library/thread-safety-in-the-cpp-standard-library.md)\ diff --git a/docs/standard-library/basic-stringstream-class.md b/docs/standard-library/basic-stringstream-class.md index 998bc38cb28..6b834225d75 100644 --- a/docs/standard-library/basic-stringstream-class.md +++ b/docs/standard-library/basic-stringstream-class.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: basic_stringstream Class" title: "basic_stringstream Class" +description: "Learn more about: basic_stringstream Class" ms.date: 06/10/2022 f1_keywords: ["sstream/std::basic_stringstream", "sstream/std::basic_stringstream::allocator_type", "sstream/std::basic_stringstream::rdbuf", "sstream/std::basic_stringstream::str"] helpviewer_keywords: ["std::basic_stringstream [C++]", "std::basic_stringstream [C++], allocator_type", "std::basic_stringstream [C++], rdbuf", "std::basic_stringstream [C++], str"] -ms.assetid: 49629814-ca37-45c5-931b-4ff894e6ebd2 ms.custom: devdivchpfy22 --- @@ -87,7 +86,7 @@ An object of type `basic_string`. ### Remarks -The first constructor initializes the base class by calling [basic_iostream](../standard-library/basic-iostream-class.md)( **sb**), where `sb` is the stored object of class [basic_stringbuf](../standard-library/basic-stringbuf-class.md)< **Elem**, **Tr**, `Alloc`>. It also initializes `sb` by calling basic_stringbuf< **Elem**, **Tr**, `Alloc`>( `_Mode`). +The first constructor initializes the base class by calling [basic_iostream](../standard-library/basic-iostream-class.md)( **sb**), where `sb` is the stored object of class [basic_stringbuf](../standard-library/basic-stringbuf-class.md)< **Elem**, **Tr**, `Alloc`>. It also initializes `sb` by calling basic_stringbuf< **Elem**, **Tr**, `Alloc`>(`_Mode`). The second constructor initializes the base class by calling basic_iostream( **sb**). It also initializes `sb` by calling basic_stringbuf< **Elem**, **Tr**, `Alloc`>(_ *Str*, `_Mode`). @@ -129,7 +128,7 @@ Returns an object of class [basic_string](../standard-library/basic-string-class ### Remarks -The first member function returns [rdbuf](#rdbuf) -> [str](../standard-library/basic-stringbuf-class.md#str). The second member function calls `rdbuf` -> **str**( `_Newstr`). +The first member function returns [rdbuf](#rdbuf) -> [str](../standard-library/basic-stringbuf-class.md#str). The second member function calls `rdbuf` -> **str**(`_Newstr`). ### Example diff --git a/docs/standard-library/bernoulli-distribution-class.md b/docs/standard-library/bernoulli-distribution-class.md index 0737a964d0d..bd94744c715 100644 --- a/docs/standard-library/bernoulli-distribution-class.md +++ b/docs/standard-library/bernoulli-distribution-class.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: bernoulli_distribution Class" title: "bernoulli_distribution Class" -ms.date: "11/04/2016" +description: "Learn more about: bernoulli_distribution Class" +ms.date: 11/04/2016 f1_keywords: ["random/std::bernoulli_distribution", "random/std::bernoulli_distribution::reset", "random/std::bernoulli_distribution::p", "random/std::bernoulli_distribution::param", "random/std::bernoulli_distribution::min", "random/std::bernoulli_distribution::max", "random/std::bernoulli_distribution::operator()", "random/std::bernoulli_distribution::param_type", "random/std::bernoulli_distribution::param_type::p", "random/std::bernoulli_distribution::param_type::operator==", "random/std::bernoulli_distribution::param_type::operator!="] helpviewer_keywords: ["std::bernoulli_distribution [C++]", "std::bernoulli_distribution [C++], reset", "std::bernoulli_distribution [C++], p", "std::bernoulli_distribution [C++], param", "std::bernoulli_distribution [C++], min", "std::bernoulli_distribution [C++], max", "std::bernoulli_distribution [C++], param_type", "std::bernoulli_distribution [C++], param_type"] -ms.assetid: 586bcde1-95ca-411a-bf17-4aaf19482f34 --- # bernoulli_distribution Class @@ -14,30 +13,30 @@ Generates a Bernoulli distribution. ```cpp class bernoulli_distribution - { +{ public: - // types - typedef bool result_type; - struct param_type; - - // constructors and reset functions - explicit bernoulli_distribution(double p = 0.5); - explicit bernoulli_distribution(const param_type& parm); - void reset(); - - // generating functions - template - result_type operator()(URNG& gen); - template - result_type operator()(URNG& gen, const param_type& parm); - - // property functions - double p() const; - param_type param() const; - void param(const param_type& parm); - result_type min() const; - result_type max() const; - }; + // types + typedef bool result_type; + struct param_type; + + // constructors and reset functions + explicit bernoulli_distribution(double p = 0.5); + explicit bernoulli_distribution(const param_type& parm); + void reset(); + + // generating functions + template + result_type operator()(URNG& gen); + template + result_type operator()(URNG& gen, const param_type& parm); + + // property functions + double p() const; + param_type param() const; + void param(const param_type& parm); + result_type min() const; + result_type max() const; +}; ``` ### Parameters @@ -161,6 +160,7 @@ The second constructor constructs an object whose stored parameters are initiali Contains the parameters of the distribution. +```cpp struct param_type { typedef bernoulli_distribution distribution_type; param_type(double p = 0.5); @@ -169,6 +169,7 @@ struct param_type { bool operator==(const param_type& right) const; bool operator!=(const param_type& right) const; }; +``` ### Parameters diff --git a/docs/standard-library/bit-functions.md b/docs/standard-library/bit-functions.md index 9563428d96e..a989e550d7d 100644 --- a/docs/standard-library/bit-functions.md +++ b/docs/standard-library/bit-functions.md @@ -1,7 +1,7 @@ --- title: " functions" description: "Functions to access, manipulate, and process individual bits and sequences of bits" -ms.date: "08/28/2020" +ms.date: 08/28/2020 f1_keywords: ["bit/std::bit_cast", "bit/std::has_single_bit", "bit/std::bit_ceil", "bit/std::bit_floor", "bit/std::bit_width", "bit/std::rotl", "bit/std::rotr", "bit/std::countl_zero", "bit/std::countl_one","bit/std::countr_zero","bit/std::countr_one","bit/std::popcount"] helpviewer_keywords: ["std::bit [C++], bit_cast", "std::bit [C++], has_single_bit", "std::bit [C++], bit_ceil", "std::bit [C++], bit_floor", "std::bit [C++], bit_width", "std::bit [C++], rotl", "std::bit [C++], rotr", "std::bit [C++], countl_zero", "std::bit [C++], countl_one", "std::bit [C++], countr_zero", "std::bit [C++], countr_one", "std::bit [C++], popcount"] --- @@ -24,7 +24,7 @@ The `` header includes the following non-member template functions: |[`rotl`](#rotl) | Compute the result of a bitwise left rotation. | |[`rotr`](#rotr) | Compute the result of a bitwise right rotation. | -## `bit_cast` +## `bit_cast` Copy a bit pattern from an object of type `From` to a new object of type `To`. @@ -92,7 +92,7 @@ This function template is `constexpr` if and only if `To`, `From`, and the types - Not volatile-qualified - Have no non-static data member that is a reference type -## `bit_ceil` +## `bit_ceil` Find the smallest power of two greater than or equal to a value. For example, given `3`, returns `4`. @@ -142,7 +142,7 @@ bit_ceil(0b0101) = 0b1000 This template function only participates in overload resolution if `T` is an unsigned integer type. For example: `unsigned int`, `unsigned long`, `unsigned short`, `unsigned char`, and so on. -## `bit_floor` +## `bit_floor` Find the largest power of two not greater than a value. For example, given `5`, returns `4`. @@ -193,7 +193,7 @@ bit_floor(0b0101) = 0b0100 This template function only participates in overload resolution if `T` is an unsigned integer type. For example: `unsigned int`, `unsigned long`, `unsigned short`, `unsigned char`, and so on. -## `bit_width` +## `bit_width` Find the smallest number of bits needed to represent a value. @@ -247,7 +247,7 @@ bit_width(8) = 4 This template function only participates in overload resolution if `T` is an unsigned integer type. For example: `unsigned int`, `unsigned long`, `unsigned short`, `unsigned char`, and so on. -## `countl_zero` +## `countl_zero` Count the number of consecutive bits set to zero, starting from the most significant bit. @@ -300,7 +300,7 @@ countl_zero(0b10000000) = 0 This template function only participates in overload resolution if `T` is an unsigned integer type. For example: `unsigned int`, `unsigned long`, `unsigned short`, `unsigned char`, and so on. -## `countl_one` +## `countl_one` Count the number of consecutive bits set to one, starting from the most significant bit. @@ -353,7 +353,7 @@ countl_one(0b11111111) = 8 This template function only participates in overload resolution if `T` is an unsigned integer type. For example: `unsigned int`, `unsigned long`, `unsigned short`, `unsigned char`, and so on. -## `countr_zero` +## `countr_zero` Count the number of consecutive bits set to zero, starting from the least significant bit. @@ -407,7 +407,7 @@ countr_zero(0b10000000) = 7 This template function only participates in overload resolution if `T` is an unsigned integer type. For example: `unsigned int`, `unsigned long`, `unsigned short`, `unsigned char`, and so on. -## `countr_one` +## `countr_one` Count the number of consecutive bits set to one, starting from the least significant bit. @@ -460,7 +460,7 @@ countr_one(0b11111111) = 8 This template function only participates in overload resolution if `T` is an unsigned integer type. For example: `unsigned int`, `unsigned long`, `unsigned short`, `unsigned char`, and so on. -## `has_single_bit` +## `has_single_bit` Check if a value has only one bit set.This is the same as testing whether a value is a power of two. @@ -514,7 +514,7 @@ has_single_bit(0b1001) = false This template function only participates in overload resolution if `T` is an unsigned integer type. For example: `unsigned int`, `unsigned long`, `unsigned short`, `unsigned char`, and so on. -## `popcount` +## `popcount` Count the number of bits set to one in an unsigned integer value. @@ -573,7 +573,7 @@ popcount(0b1111) = 4 This template function only participates in overload resolution if `T` is an unsigned integer type. For example: `unsigned int`, `unsigned long`, `unsigned short`, `unsigned char`, and so on. -## `rotl` +## `rotl` Rotates the bits of an unsigned integer value left the specified number of times. Bits that "fall out" of the leftmost bit are rotated into the rightmost bit. @@ -635,7 +635,7 @@ rotl(0b00000001,-1) = 0b10000000 This template function only participates in overload resolution if `T` is an unsigned integer type. For example: `unsigned int`, `unsigned long`, `unsigned short`, `unsigned char`, and so on. -## `rotr` +## `rotr` Rotates the bits of `value` right the specified number of times. Bits that 'fall out' of the rightmost bit are rotated back into the leftmost bit. diff --git a/docs/standard-library/bit.md b/docs/standard-library/bit.md index ed42bc8ac34..5f6ca69bb1f 100644 --- a/docs/standard-library/bit.md +++ b/docs/standard-library/bit.md @@ -1,7 +1,7 @@ --- title: "" description: "Functions to access, manipulate, and process individual bits and sequences of bits." -ms.date: "08/28/2020" +ms.date: 08/28/2020 f1_keywords: [""] helpviewer_keywords: ["bit header"] --- @@ -13,9 +13,9 @@ For example, there are functions to rotate bits, find the number of consecutive ## Requirements -**Header:** \ +**Header:** `` -**Namespace:** std +**Namespace:** `std` [`/std:c++20`](../build/reference/std-specify-language-standard-version.md) or later is required. @@ -25,24 +25,24 @@ For example, there are functions to rotate bits, find the number of consecutive | Type | Description | |--------|----------| -| [endian](bit-enum.md) | Specifies the endianness of scalar types. | +| [`endian`](bit-enum.md) | Specifies the endianness of scalar types. | ### Functions | Function | Description | |-----|-----| -|[bit_cast](bit-functions.md#bit_cast) | Reinterpret the object representation from one type to another. | -|[bit_ceil](bit-functions.md#bit_ceil) | Find the smallest power of two greater than or equal to a value. | -|[bit_floor](bit-functions.md#bit_floor) | Find the largest integral power of two not greater than a value. | -|[bit_width](bit-functions.md#bit_width) | Find the smallest number of bits needed to represent a value. | -|[countl_zero](bit-functions.md#countl_zero) | Count the number of consecutive bits set to zero, starting from the most significant bit. | -|[countl_one](bit-functions.md#countl_one) | Count the number of consecutive bits set to one, starting from the most significant bit. | -|[countr_zero](bit-functions.md#countr_zero) | Count the number of consecutive bits set to zero, starting from the least significant bit. | -|[countr_one](bit-functions.md#countl_one) | Count the number of consecutive bits set to one, starting from the least significant bit. | -|[has_single_bit](bit-functions.md#has_single_bit) | Check if a value has only a single bit set to one. This is the same as testing whether a value is a power of two. | -|[popcount](bit-functions.md#popcount) | Count the number of bits set to one. | -|[rotl](bit-functions.md#rotl) | Compute the result of a bitwise left-rotation. | -|[rotr](bit-functions.md#rotr) | Compute the result of a bitwise right-rotation. | +|[`bit_cast`](bit-functions.md#bit_cast) | Reinterpret the object representation from one type to another. | +|[`bit_ceil`](bit-functions.md#bit_ceil) | Find the smallest power of two greater than or equal to a value. | +|[`bit_floor`](bit-functions.md#bit_floor) | Find the largest integral power of two not greater than a value. | +|[`bit_width`](bit-functions.md#bit_width) | Find the smallest number of bits needed to represent a value. | +|[`countl_zero`](bit-functions.md#countl_zero) | Count the number of consecutive bits set to zero, starting from the most significant bit. | +|[`countl_one`](bit-functions.md#countl_one) | Count the number of consecutive bits set to one, starting from the most significant bit. | +|[`countr_zero`](bit-functions.md#countr_zero) | Count the number of consecutive bits set to zero, starting from the least significant bit. | +|[`countr_one`](bit-functions.md#countr_one) | Count the number of consecutive bits set to one, starting from the least significant bit. | +|[`has_single_bit`](bit-functions.md#has_single_bit) | Check if a value has only a single bit set to one. This is the same as testing whether a value is a power of two. | +|[`popcount`](bit-functions.md#popcount) | Count the number of bits set to one. | +|[`rotl`](bit-functions.md#rotl) | Compute the result of a bitwise left-rotation. | +|[`rotr`](bit-functions.md#rotr) | Compute the result of a bitwise right-rotation. | ## See also diff --git a/docs/standard-library/bitset-class.md b/docs/standard-library/bitset-class.md index d5fbac7df4a..a70a5b0f934 100644 --- a/docs/standard-library/bitset-class.md +++ b/docs/standard-library/bitset-class.md @@ -1,11 +1,10 @@ --- -description: "Learn more about: bitset Class" title: "bitset Class" +description: "Learn more about: bitset Class" ms.date: 06/10/2022 f1_keywords: ["bitset/std::bitset", "bitset/std::bitset::element_type", "bitset/std::bitset::all", "bitset/std::bitset::any", "bitset/std::bitset::count", "bitset/std::bitset::flip", "bitset/std::bitset::none", "bitset/std::bitset::reset", "bitset/std::bitset::set", "bitset/std::bitset::size", "bitset/std::bitset::test", "bitset/std::bitset::to_string", "bitset/std::bitset::to_ullong", "bitset/std::bitset::to_ulong", "bitset/std::bitset::reference"] helpviewer_keywords: ["std::bitset [C++]", "std::bitset [C++], element_type", "std::bitset [C++], all", "std::bitset [C++], any", "std::bitset [C++], count", "std::bitset [C++], flip", "std::bitset [C++], none", "std::bitset [C++], reset", "std::bitset [C++], set", "std::bitset [C++], size", "std::bitset [C++], test", "std::bitset [C++], to_string", "std::bitset [C++], to_ullong", "std::bitset [C++], to_ulong", "std::bitset [C++], reference"] ms.custom: devdivchpfy22 - --- # `bitset` class diff --git a/docs/standard-library/cache-chunklist-class.md b/docs/standard-library/cache-chunklist-class.md index 914921951d3..e2de788bc76 100644 --- a/docs/standard-library/cache-chunklist-class.md +++ b/docs/standard-library/cache-chunklist-class.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: cache_chunklist Class" title: "cache_chunklist Class" -ms.date: "11/04/2016" +description: "Learn more about: cache_chunklist Class" +ms.date: 11/04/2016 f1_keywords: ["allocators/stdext::cache_chunklist", "allocators/stdext::cache_chunklist::allocate", "allocators/stdext::cache_chunklist::deallocate"] helpviewer_keywords: ["stdext::cache_chunklist", "stdext::cache_chunklist [C++], allocate", "stdext::cache_chunklist [C++], deallocate"] -ms.assetid: af19eccc-4ae7-4a34-bbb2-81e397424cb9 --- # cache_chunklist Class @@ -64,8 +63,6 @@ The number of elements in the array to be allocated. A pointer to the allocated object. -### Remarks - ## cache_chunklist::cache_chunklist Constructs an object of type `cache_chunklist`. @@ -74,8 +71,6 @@ Constructs an object of type `cache_chunklist`. cache_chunklist(); ``` -### Remarks - ## cache_chunklist::deallocate Frees a specified number of objects from storage beginning at a specified position. @@ -92,8 +87,6 @@ A pointer to the first object to be deallocated from storage. *count*\ The number of objects to be deallocated from storage. -### Remarks - ## See also [\](../standard-library/allocators-header.md) diff --git a/docs/standard-library/cache-freelist-class.md b/docs/standard-library/cache-freelist-class.md index 1df5612d0d3..71faf8ebc05 100644 --- a/docs/standard-library/cache-freelist-class.md +++ b/docs/standard-library/cache-freelist-class.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: cache_freelist Class" title: "cache_freelist Class" -ms.date: "11/04/2016" +description: "Learn more about: cache_freelist Class" +ms.date: 11/04/2016 f1_keywords: ["allocators/stdext::cache_freelist", "allocators/stdext::cache_freelist::allocate", "allocators/stdext::cache_freelist::deallocate"] helpviewer_keywords: ["stdext::cache_freelist", "stdext::cache_freelist [C++], allocate", "stdext::cache_freelist [C++], deallocate"] -ms.assetid: 840694de-36ba-470f-8dae-2b723d5a8cd9 --- # cache_freelist Class @@ -67,8 +66,6 @@ The number of elements in the array to be allocated. A pointer to the allocated object. -### Remarks - ## cache_freelist::cache_freelist Constructs an object of type `cache_freelist`. @@ -77,8 +74,6 @@ Constructs an object of type `cache_freelist`. cache_freelist(); ``` -### Remarks - ## cache_freelist::deallocate Frees a specified number of objects from storage beginning at a specified position. @@ -95,8 +90,6 @@ A pointer to the first object to be deallocated from storage. *count*\ The number of objects to be deallocated from storage. -### Remarks - ## See also [\](../standard-library/allocators-header.md) diff --git a/docs/standard-library/cache-suballoc-class.md b/docs/standard-library/cache-suballoc-class.md index 26c070fcad5..12f111137d7 100644 --- a/docs/standard-library/cache-suballoc-class.md +++ b/docs/standard-library/cache-suballoc-class.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: cache_suballoc Class" title: "cache_suballoc Class" -ms.date: "11/04/2016" +description: "Learn more about: cache_suballoc Class" +ms.date: 11/04/2016 f1_keywords: ["allocators/stdext::cache_suballoc", "allocators/stdext::cache_suballoc::allocate", "allocators/stdext::cache_suballoc::deallocate"] helpviewer_keywords: ["stdext::cache_suballoc", "stdext::cache_suballoc [C++], allocate", "stdext::cache_suballoc [C++], deallocate"] -ms.assetid: 9ea9c5e9-1dcc-45d0-b3a7-a56a93d88898 --- # cache_suballoc Class @@ -64,8 +63,6 @@ The number of elements in the array to be allocated. A pointer to the allocated object. -### Remarks - ## cache_suballoc::cache_suballoc Constructs an object of type `cache_suballoc`. @@ -74,8 +71,6 @@ Constructs an object of type `cache_suballoc`. cache_suballoc(); ``` -### Remarks - ## cache_suballoc::deallocate Frees a specified number of objects from storage beginning at a specified position. @@ -92,8 +87,6 @@ A pointer to the first object to be deallocated from storage. *count*\ The number of objects to be deallocated from storage. -### Remarks - ## See also [\](../standard-library/allocators-header.md) diff --git a/docs/standard-library/char-traits-char-struct.md b/docs/standard-library/char-traits-char-struct.md index 22aa1ee35da..fbdc3d0c807 100644 --- a/docs/standard-library/char-traits-char-struct.md +++ b/docs/standard-library/char-traits-char-struct.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: char_traits Struct" title: "char_traits Struct" -ms.date: "11/04/2016" +description: "Learn more about: char_traits Struct" +ms.date: 11/04/2016 f1_keywords: ["iosfwd/std::char_traits", "char_traits"] helpviewer_keywords: ["char_traits class"] -ms.assetid: abd9373a-77db-4031-bf4b-f8ac15087581 --- # `char_traits` Struct @@ -23,4 +22,4 @@ Specialization allows the struct to take advantage of library functions that man ## Example -See the typedefs and member functions of the class template [char_traits Class](../standard-library/char-traits-struct.md) +See the typedefs and member functions of the class template [`char_traits`](../standard-library/char-traits-struct.md) diff --git a/docs/standard-library/char-traits-struct.md b/docs/standard-library/char-traits-struct.md index dcbd8702db4..065c8cf7d2a 100644 --- a/docs/standard-library/char-traits-struct.md +++ b/docs/standard-library/char-traits-struct.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: char_traits Struct" title: "char_traits Struct" -ms.date: "05/07/2019" +description: "Learn more about: char_traits Struct" +ms.date: 05/07/2019 f1_keywords: ["iosfwd/std::char_traits", "iosfwd/std::char_traits::char_type", "iosfwd/std::char_traits::int_type", "iosfwd/std::char_traits::off_type", "iosfwd/std::char_traits::pos_type", "iosfwd/std::char_traits::state_type", "iosfwd/std::char_traits::assign", "iosfwd/std::char_traits::compare", "iosfwd/std::char_traits::copy", "iosfwd/std::char_traits::_Copy_s", "iosfwd/std::char_traits::eof", "iosfwd/std::char_traits::eq", "iosfwd/std::char_traits::eq_int_type", "iosfwd/std::char_traits::find", "iosfwd/std::char_traits::length", "iosfwd/std::char_traits::lt", "iosfwd/std::char_traits::move", "iosfwd/std::char_traits::_Move_s", "iosfwd/std::char_traits::not_eof", "iosfwd/std::char_traits::to_char_type", "iosfwd/std::char_traits::to_int_type"] helpviewer_keywords: ["char_traits struct", "char_traits class"] -ms.assetid: 568e59f0-4521-4207-9223-9dcf6a16d620 --- # char_traits Struct @@ -1010,11 +1009,11 @@ A value of *_Ch* that cannot be represented as such yields an unspecified result The conversion operations [to_int_type](#to_int_type) and `to_char_type` are inverse to each other, so that: -`to_int_type` ( `to_char_type` ( *x* ) ) == *x* +`to_int_type`(`to_char_type`(*x*)) == *x* for any `int_type` *x* and -`to_char_type` ( `to_int_type` ( *x* ) ) == *x* +`to_char_type`(`to_int_type`(*x*)) == *x* for any `char_type` *x*. @@ -1114,11 +1113,11 @@ The `int_type` character corresponding to the `char_type` character. The conversion operations `to_int_type` and [to_char_type](#to_char_type) are inverse to each other, so that: -`to_int_type` ( `to_char_type` ( *x* ) ) == *x* +`to_int_type`(`to_char_type`(*x*)) == *x* for any `int_type` *x*, and -`to_char_type` ( `to_int_type` ( *x* ) ) == *x* +`to_char_type`(`to_int_type`(*x*)) == *x* for any `char_type` *x*. diff --git a/docs/standard-library/charconv-functions.md b/docs/standard-library/charconv-functions.md index 296364799d2..8f601eef05e 100644 --- a/docs/standard-library/charconv-functions.md +++ b/docs/standard-library/charconv-functions.md @@ -236,6 +236,6 @@ int main() ## See also -[\](charconv.md) -[The shortest decimal string that round-trips](https://www.exploringbinary.com/the-shortest-decimal-string-that-round-trips-examples/) +[\](charconv.md)\ +[The shortest decimal string that round-trips](https://www.exploringbinary.com/the-shortest-decimal-string-that-round-trips-examples/)\ [printf() format specifiers](..\c-runtime-library\format-specification-syntax-printf-and-wprintf-functions.md) diff --git a/docs/standard-library/checked-iterators.md b/docs/standard-library/checked-iterators.md index 719992a7af8..3022398c426 100644 --- a/docs/standard-library/checked-iterators.md +++ b/docs/standard-library/checked-iterators.md @@ -1,29 +1,28 @@ --- -description: "Learn more about: Checked Iterators" title: "Checked Iterators" -ms.date: "11/04/2016" +description: "Learn more about: Checked Iterators" +ms.date: 11/04/2016 f1_keywords: ["_SECURE_SCL_THROWS"] helpviewer_keywords: ["Safe Libraries", "Safe Libraries, C++ Standard Library", "Safe C++ Standard Library", "iterators, checked", "checked iterators"] -ms.assetid: cfc87df8-e3d9-403b-ab78-e9483247d940 --- # Checked Iterators -Checked iterators ensure that the bounds of your container are not overwritten. Checked iterators apply to both release builds and debug builds. For more information about how to use debug iterators when you compile in debug mode, see [Debug Iterator Support](../standard-library/debug-iterator-support.md). +Checked iterators ensure that the bounds of your container are not overwritten. Checked iterators apply to both release builds and debug builds. For more information about how to use debug iterators when you compile in debug mode, see [Debug Iterator Support](debug-iterator-support.md). ## Remarks -For information about how to disable warnings that are generated by checked iterators, see [_SCL_SECURE_NO_WARNINGS](../standard-library/scl-secure-no-warnings.md). +For information about how to disable warnings that are generated by checked iterators, see [`_SCL_SECURE_NO_WARNINGS`](scl-secure-no-warnings.md). -You can use the [\_ITERATOR\_DEBUG\_LEVEL](../standard-library/iterator-debug-level.md) preprocessor macro to enable or disable the checked iterators feature. If _ITERATOR_DEBUG_LEVEL is defined as 1 or 2, unsafe use of iterators causes a runtime error and the program is terminated. If defined as 0, checked iterators are disabled. By default, the value for _ITERATOR_DEBUG_LEVEL is 0 for release builds and 2 for debug builds. +You can use the [`_ITERATOR_DEBUG_LEVEL`](iterator-debug-level.md) preprocessor macro to enable or disable the checked iterators feature. If `_ITERATOR_DEBUG_LEVEL` is defined as 1 or 2, unsafe use of iterators causes a runtime error and the program is terminated. If defined as 0, checked iterators are disabled. By default, the value for `_ITERATOR_DEBUG_LEVEL` is 0 for release builds and 2 for debug builds. > [!IMPORTANT] -> Older documentation and source code may refer to the [_SECURE_SCL](../standard-library/secure-scl.md) macro. Use _ITERATOR_DEBUG_LEVEL to control _SECURE_SCL. For more information, see [_ITERATOR_DEBUG_LEVEL](../standard-library/iterator-debug-level.md). +> Older documentation and source code may refer to the [`_SECURE_SCL`](secure-scl.md) macro. Use `_ITERATOR_DEBUG_LEVEL` to control `_SECURE_SCL`. For more information, see [`_ITERATOR_DEBUG_LEVEL`](iterator-debug-level.md). -When _ITERATOR_DEBUG_LEVEL is defined as 1 or 2, these iterator checks are performed: +When `_ITERATOR_DEBUG_LEVEL` is defined as 1 or 2, these iterator checks are performed: -- All standard iterators (for example, [vector::iterator](../standard-library/vector-class.md#iterator)) are checked. +- All standard iterators (for example, [`vector::iterator`](vector-class.md#iterator)) are checked. -- If an output iterator is a checked iterator, calls to standard library functions such as [std::copy](../standard-library/algorithm-functions.md#copy) get checked behavior. +- If an output iterator is a checked iterator, calls to standard library functions such as [`std::copy`](algorithm-functions.md#copy) get checked behavior. - If an output iterator is an unchecked iterator, calls to standard library functions cause compiler warnings. @@ -31,26 +30,26 @@ When _ITERATOR_DEBUG_LEVEL is defined as 1 or 2, these iterator checks are perfo :::row::: :::column span=""::: -   [`basic_string::operator[]`](../standard-library/basic-string-class.md#op_at)\ -   [`bitset::operator[]`](../standard-library/bitset-class.md#op_at)\ -   [`deque::back`](../standard-library/deque-class.md#back)\ -   [`deque::front`](../standard-library/deque-class.md#front) + [`basic_string::operator[]`](basic-string-class.md#op_at)\ + [`bitset::operator[]`](bitset-class.md#op_at)\ + [`deque::back`](deque-class.md#back)\ + [`deque::front`](deque-class.md#front) :::column-end::: :::column span=""::: - [`deque::operator[]`](../standard-library/deque-class.md#op_at)\ - [`list::back`](../standard-library/list-class.md#back)\ - [`list::front`](../standard-library/list-class.md#front)\ - [`queue::back`](../standard-library/queue-class.md#back) + [`deque::operator[]`](deque-class.md#op_at)\ + [`list::back`](list-class.md#back)\ + [`list::front`](list-class.md#front)\ + [`queue::back`](queue-class.md#back) :::column-end::: :::column span=""::: - [`queue::front`](../standard-library/queue-class.md#front)\ - [`vector::back`](../standard-library/vector-class.md#back)\ - [`vector::front`](../standard-library/vector-class.md#front)\ - [`vector::operator[]`](../standard-library/vector-class.md#op_at) + [`queue::front`](queue-class.md#front)\ + [`vector::back`](vector-class.md#back)\ + [`vector::front`](vector-class.md#front)\ + [`vector::operator[]`](vector-class.md#op_at) :::column-end::: :::row-end::: -When _ITERATOR_DEBUG_LEVEL is defined as 0: +When `_ITERATOR_DEBUG_LEVEL` is defined as 0: - All standard iterators are unchecked. Iterators can move beyond the container boundaries, which leads to undefined behavior. @@ -60,11 +59,11 @@ When _ITERATOR_DEBUG_LEVEL is defined as 0: A checked iterator refers to an iterator that calls `invalid_parameter_handler` if you attempt to move past the boundaries of the container. For more information about `invalid_parameter_handler`, see [Parameter Validation](../c-runtime-library/parameter-validation.md). -The iterator adaptors that support checked iterators are [checked_array_iterator Class](../standard-library/checked-array-iterator-class.md) and [unchecked_array_iterator Class](../standard-library/unchecked-array-iterator-class.md). +The iterator adaptors that support checked iterators are [`checked_array_iterator` Class](checked-array-iterator-class.md) and [`unchecked_array_iterator` Class](unchecked-array-iterator-class.md). ## Examples -When you compile by using _ITERATOR_DEBUG_LEVEL set to 1 or 2, a runtime error will occur if you attempt to access an element that is outside the bounds of the container by using the indexing operator of certain classes. +When you compile by using `_ITERATOR_DEBUG_LEVEL` set to 1 or 2, a runtime error will occur if you attempt to access an element that is outside the bounds of the container by using the indexing operator of certain classes. ```cpp // checked_iterators_1.cpp @@ -79,19 +78,19 @@ using namespace std; int main() { - vector v; - v.push_back(67); + vector v; + v.push_back(67); - int i = v[0]; - cout << i << endl; + int i = v[0]; + cout << i << endl; - i = v[1]; //triggers invalid parameter handler + i = v[1]; //triggers invalid parameter handler } ``` This program prints "67" then pops up an assertion failure dialog box with additional information about the failure. -Similarly, when you compile by using _ITERATOR_DEBUG_LEVEL set to 1 or 2, a runtime error will occur if you attempt to access an element by using `front` or `back` in container classes when the container is empty. +Similarly, when you compile by using `_ITERATOR_DEBUG_LEVEL` set to 1 or 2, a runtime error will occur if you attempt to access an element by using `front` or `back` in container classes when the container is empty. ```cpp // checked_iterators_2.cpp @@ -105,15 +104,15 @@ using namespace std; int main() { - vector v; + vector v; - int& i = v.front(); // triggers invalid parameter handler + int& i = v.front(); // triggers invalid parameter handler } ``` This program pops up an assertion failure dialog box with additional information about the failure. -The following code demonstrates various iterator use-case scenarios with comments about each. By default, _ITERATOR_DEBUG_LEVEL is set to 2 in Debug builds, and to 0 in Retail builds. +The following code demonstrates various iterator use-case scenarios with comments about each. By default, `_ITERATOR_DEBUG_LEVEL` is set to 2 in Debug builds, and to 0 in Retail builds. ```cpp // checked_iterators_3.cpp @@ -134,7 +133,8 @@ void print(const string& s, const C& c) { cout << s; - for (const auto& e : c) { + for (const auto& e : c) + { cout << e << " "; } @@ -219,5 +219,5 @@ a8: 0 8 16 24 32 40 48 56 64 72 80 88 96 104 112 120 ## See also -[C++ Standard Library Overview](../standard-library/cpp-standard-library-overview.md)\ -[Debug Iterator Support](../standard-library/debug-iterator-support.md) +[C++ Standard Library Overview](cpp-standard-library-overview.md)\ +[Debug Iterator Support](debug-iterator-support.md) diff --git a/docs/standard-library/chrono-functions.md b/docs/standard-library/chrono-functions.md index 5f4e4a25874..80bc5412963 100644 --- a/docs/standard-library/chrono-functions.md +++ b/docs/standard-library/chrono-functions.md @@ -3,7 +3,7 @@ title: " functions" description: "Learn more about: functions" ms.date: 10/15/2021 f1_keywords: ["chrono/std::duration_cast", "chrono/std::time_point_cast", "chrono/std::chrono::clock_cast", "chrono/std::chrono::duration_cast", "chrono/std::chrono::time_point_cast", "chrono/std::chrono::from_stream", "chrono/std::chrono::abs", "chrono/std::chrono::floor", "chrono/std::chrono::ceil", "chrono/std::chrono::round", "chrono/std::chrono::is_am", "chrono/std::chrono::is_pm", "chrono/std::chrono::make12", "chrono/std::chrono::make24", "chrono/std::chrono::get_leap_second_info", "chrono/std::chrono::get_tzdb", "chrono/std::chrono::get_tzdb_list", "chrono/std::chrono::locate_zone", "chrono/std::chrono::current_zone", "chrono/std::chrono::reload_tzdb", "chrono/std::chrono::remote_version"] -helpviewer_keywords: ["std::duration_cast function", "std::time_point_cast function", "std::chrono::clock_cast", "std::chrono::duration_cast function", "std::chrono::time_point_cast function", "std::chrono::from_stream function", "std::chrono::floor function", "std::chrono::ceil function", "std::chrono::round function", "std::chrono::is_am function", "std::chrono::is_pm function", "std::chrono::make12 function", "std::chrono::make24 function", "std::chrono::get_leap_second_info function", "std::chrono::get_tzdb function", "std::chrono::get_tzdb_list function", "std::chrono::locate_zone function", "std::chrono::current_zone function", "std::chrono::reload_tzdb function", "std::chrono::remote_version function"] +helpviewer_keywords: ["std::duration_cast function", "std::time_point_cast function", "std::chrono::clock_cast", "std::chrono::duration_cast function", "std::chrono::time_point_cast function", "std::chrono::from_stream function", "std::chrono::floor function", "std::chrono::ceil function", "std::chrono::round function", "std::chrono::is_am function", "std::chrono::is_pm function", "std::chrono::make12 function", "std::chrono::make24 function", "std::chrono::get_leap_second_info function", "std::chrono::get_tzdb function", "std::chrono::get_tzdb_list function", "std::chrono::locate_zone function", "std::chrono::current_zone function", "std::chrono::reload_tzdb function", "std::chrono::remote_version function"] --- # `` functions @@ -347,7 +347,7 @@ If the parse fails, `is.setstate`(`ios_base::failbit`) is called and the output ```cpp // 1) day - C++20 -template> +template> basic_istream& from_stream( basic_istream& is, const charT* fmt, @@ -563,7 +563,7 @@ int main() ### Remarks -**7)** If `%Z` is used and successfully parsed, that value will be assigned to `*abbrev `if `abbrev` is non-null. If `%z` (or a modified variant) is used and successfully parsed, that value will be assigned to `*offset` if `offset` is non-null. +**7)** If `%Z` is used and successfully parsed, that value will be assigned to `*abbrev` if `abbrev` is non-null. If `%z` (or a modified variant) is used and successfully parsed, that value will be assigned to `*offset` if `offset` is non-null. **12)** If `%Z` is used and successfully parsed, that value will be assigned to `*abbrev` if `abbrev` is non-null. If `%z` (or a modified variant) is used and successfully parsed, that value will be assigned to `*offset` if `offset` is non-null. @@ -674,7 +674,7 @@ In ISO 8601, weeks begin with Monday. The first week of the year must include Ja | `utc_time` | Z, z, c, x, X, D, F, g, G, j, U, V, W, Y, y, C, b, h, B, m, d, e, a, A, u, w, H, I, M, S, r, R, T, p | | [`weekday`](weekday-class.md) | a, A, u, w | | [`weekday_indexed`](weekdayindexed-class.md) | a, A, u, w | -| [`weekday_last`]() | a, A, u, w | +| [`weekday_last`](weekdaylast-class.md) | a, A, u, w | | [`year`](year-class.md) | Y, y, C | | `year_month` | Y, y, B, g, G, h, C, b, m | | `year_month_day` | D, F, g, G, j, U, V, W, Y, y, C, b, h, B, m, d, e, a, A, u, w | @@ -987,4 +987,4 @@ Unless `ToDuration` is a specialization of [`duration`](../standard-library/dura [`chrono` operators](./chrono-operators.md)\ [`duration` class](./duration-class.md)\ [`time_point` class](./time-point-class.md)\ -[`time_zone` class](./time-zone-class.md) \ No newline at end of file +[`time_zone` class](./time-zone-class.md) diff --git a/docs/standard-library/chrono-operators.md b/docs/standard-library/chrono-operators.md index b585b8ad91c..deb72801957 100644 --- a/docs/standard-library/chrono-operators.md +++ b/docs/standard-library/chrono-operators.md @@ -2,7 +2,7 @@ title: " operators" description: "Learn more about: operators" ms.date: 09/17/2021 -f1_keywords: ["chrono/std::operator modulo", "chrono/std::operator+", "chrono/std::chrono::day::operator+", "chrono/std::chrono::duration::operator+", "chrono/std::chrono::month::operator+", "chrono/std::chrono::time_point::operator+", "chrono/std::chrono::weekday::operator+", "chrono/std::chrono::year_month::operator+", "chrono/std::chrono::year::operator+", "chrono/std::chrono::year_month_day::operator+", "chrono/std::chrono::year_month_day_last::operator+", "chrono/std::chrono::year_month_weekday::operator+", "chrono/std::chrono::year_month_weekday_last::operator+", "chrono/std::operator!=", "chrono/std::operator*", "chrono/std::operator/", "chrono/std::operator-", "chrono/std::operator<", "chrono/std::operator<=", "chrono/std::operator<", "chrono/std::operator==", "chrono/std::operator>>", "chrono/std::operator<=>", "chrono/std::chrono::day::operator<=>", "chrono/std::chrono::month::operator<=>", "chrono/std::chrono::year::operator<=>", "chrono/std::chrono::year_month::operator<=>", "chrono/std::chrono::time_point::operator<=>", "chrono/std::chrono::time_zone_link::operator<=>", "chrono/std::chrono::time_zone_link::operator==", "chrono/std::chrono::duration::operator<=>", "chrono/std::chrono::month_day_last::operator<=>", "chrono/std::chrono::year_month_day_last::operator<=>", "chrono/std::operator==", "chrono/std::chrono::year::operator<==>", "chrono/std::chrono::day::operator==", "chrono/std::chrono::duration::operator==", "chrono/std::chrono::month::operator==", "chrono/std::chrono::month_day::operator==", "chrono/std::chrono::month_day_last::operator==", "chrono/std::chrono::month_weekday::operator==", "chrono/std::chrono::month_weekday_last::operator==", "chrono/std::chrono::time_point::operator==", "chrono/std::chrono::weekday::operator==", "chrono/std::chrono::year_month::operator==", "chrono/std::chrono::year::operator==", "chrono/std::chrono::year_month_day::operator==", "chrono/std::chrono::year_month_day_last::operator==", "chrono/std::chrono::year_month_weekday_last::operator==", "chrono/std::chrono::year_month_weekday::operator==", "chrono/std::chrono::month_weekday_last::operator==", "chrono/std::chrono::weekday::operator==", "chrono/std::chrono::weekday_last::operator==", "chrono/std::chrono::year_month_weekday_indexed::operator==", "chrono/std::chrono::year_month_weekday_last::operator==", "chrono/std::chrono::year::operator==", "chrono/std::chrono::year_month::operator==", "chrono/std::chrono::year_month_day::operator==", "chrono/std::chrono::year_month_day_last::operator==", "chrono/std::chrono::zoned_time::operator==", "chrono/std::operator-", "chrono/std::chrono::day::operator-", "chrono/std::chrono::duration::operator-", "chrono/std::chrono::month::operator-", "chrono/std::chrono::time_point::operator-", "chrono/std::chrono::weekday::operator-", "chrono/std::chrono::year_month::operator-", "chrono/std::chrono::year::operator-", "chrono/std::chrono::year_month_day::operator-", "chrono/std::chrono::year_month_day_last::operator-", "chrono/std::chrono::year_month_weekday::operator-", "chrono/std::chrono::year_month_weekday_last::operator-", "chrono/std::chrono::day::operator<<", "chrono/std::chrono::hh_mm_ss::operator<<", "chrono/std::chrono::month_day::operator<<", "chrono/std::chrono::month_day_last::operator<<", "chrono/std::chrono::month_weekday::operator<<", "chrono/std::chrono::month_weekday_last::operator<<", "chrono/std::chrono::weekday::operator<<", "chrono/std::chrono::weekday_indexed::operator<<", "chrono/std::chrono::weekday_last::operator<<", "chrono/std::chrono::year::operator<<", "chrono/std::chrono::year_month_day::operator<<", "chrono/std::chrono::year_month_day_last::operator<<", "chrono/std::chrono::year_month_weekday::operator<<", "chrono/std::chrono::utc_time::operator<<", "chrono/std::chrono::tai_time::operator<<", "chrono/std::chrono::gps_time::operator<<", "chrono/std::chrono::local_time::operator<<", "chrono/std::chrono::file_time::operator<<", "chrono/std::chrono::sys_info::operator<<", "chrono/std::chrono::local_info::operator<<", "chrono/std::chrono::zoned_time::operator<<"] +f1_keywords: ["chrono/std::operator modulo", "chrono/std::operator+", "chrono/std::chrono::day::operator+", "chrono/std::chrono::duration::operator+", "chrono/std::chrono::month::operator+", "chrono/std::chrono::time_point::operator+", "chrono/std::chrono::weekday::operator+", "chrono/std::chrono::year_month::operator+", "chrono/std::chrono::year::operator+", "chrono/std::chrono::year_month_day::operator+", "chrono/std::chrono::year_month_day_last::operator+", "chrono/std::chrono::year_month_weekday::operator+", "chrono/std::chrono::year_month_weekday_last::operator+", "chrono/std::operator!=", "chrono/std::operator*", "chrono/std::operator/", "chrono/std::operator-", "chrono/std::operator<", "chrono/std::operator<=", "chrono/std::operator<", "chrono/std::operator==", "chrono/std::operator>>", "chrono/std::operator<=>", "chrono/std::chrono::day::operator<=>", "chrono/std::chrono::month::operator<=>", "chrono/std::chrono::year::operator<=>", "chrono/std::chrono::year_month::operator<=>", "chrono/std::chrono::time_point::operator<=>", "chrono/std::chrono::time_zone_link::operator<=>", "chrono/std::chrono::time_zone_link::operator==", "chrono/std::chrono::duration::operator<=>", "chrono/std::chrono::month_day_last::operator<=>", "chrono/std::chrono::year_month_day_last::operator<=>", "chrono/std::operator==", "chrono/std::chrono::year::operator<==>", "chrono/std::chrono::day::operator==", "chrono/std::chrono::duration::operator==", "chrono/std::chrono::month::operator==", "chrono/std::chrono::month_day::operator==", "chrono/std::chrono::month_day_last::operator==", "chrono/std::chrono::month_weekday::operator==", "chrono/std::chrono::month_weekday_last::operator==", "chrono/std::chrono::time_point::operator==", "chrono/std::chrono::weekday::operator==", "chrono/std::chrono::year_month::operator==", "chrono/std::chrono::year::operator==", "chrono/std::chrono::year_month_day::operator==", "chrono/std::chrono::year_month_day_last::operator==", "chrono/std::chrono::year_month_weekday_last::operator==", "chrono/std::chrono::year_month_weekday::operator==", "chrono/std::chrono::month_weekday_last::operator==", "chrono/std::chrono::weekday::operator==", "chrono/std::chrono::weekday_last::operator==", "chrono/std::chrono::year_month_weekday_indexed::operator==", "chrono/std::chrono::year_month_weekday_last::operator==", "chrono/std::chrono::year::operator==", "chrono/std::chrono::year_month::operator==", "chrono/std::chrono::year_month_day::operator==", "chrono/std::chrono::year_month_day_last::operator==", "chrono/std::chrono::zoned_time::operator==", "chrono/std::operator-", "chrono/std::chrono::day::operator-", "chrono/std::chrono::duration::operator-", "chrono/std::chrono::month::operator-", "chrono/std::chrono::time_point::operator-", "chrono/std::chrono::weekday::operator-", "chrono/std::chrono::year_month::operator-", "chrono/std::chrono::year::operator-", "chrono/std::chrono::year_month_day::operator-", "chrono/std::chrono::year_month_day_last::operator-", "chrono/std::chrono::year_month_weekday::operator-", "chrono/std::chrono::year_month_weekday_last::operator-", "chrono/std::chrono::day::operator<<", "chrono/std::chrono::hh_mm_ss::operator<<", "chrono/std::chrono::month_day::operator<<", "chrono/std::chrono::month_day_last::operator<<", "chrono/std::chrono::month_weekday::operator<<", "chrono/std::chrono::month_weekday_last::operator<<", "chrono/std::chrono::weekday::operator<<", "chrono/std::chrono::weekday_indexed::operator<<", "chrono/std::chrono::weekday_last::operator<<", "chrono/std::chrono::year::operator<<", "chrono/std::chrono::year_month_day::operator<<", "chrono/std::chrono::year_month_day_last::operator<<", "chrono/std::chrono::year_month_weekday::operator<<", "chrono/std::chrono::utc_time::operator<<", "chrono/std::chrono::tai_time::operator<<", "chrono/std::chrono::gps_time::operator<<", "chrono/std::chrono::local_time::operator<<", "chrono/std::chrono::file_time::operator<<", "chrono/std::chrono::sys_info::operator<<", "chrono/std::chrono::local_info::operator<<", "chrono/std::chrono::zoned_time::operator<<"] --- # `` operators @@ -23,7 +23,7 @@ Addition operator for the following types: - [`year_month_weekday_last`](year-month-weekday-last-class.md) ```cpp -1) +1) template constexpr typename common_type, duration>::type operator+( @@ -46,7 +46,7 @@ time_point, Durati 4) constexpr day operator+(const day& d, const days& ds) noexcept; // C++20 -constexpr day operator+(const days& ds, const day& d) noexcept; // C++20 +constexpr day operator+(const days& ds, const day& d) noexcept; // C++20 5) constexpr month operator+(const month& m, const months& ms) noexcept; // C++20 @@ -107,7 +107,7 @@ constexpr year_month_weekday_last operator+(const years& dy, const year_month_we 2-3\) Return a `time_point` object that represents a point in time that is displaced by the interval *`Dur`* from the point in time *`Time`*. -4\) Returns the result of `d+ds.count()`. If the result is out of the range [0, 255], then the result is unspecified. +4\) Returns the result of `d+ds.count()`. If the result is out of the range [0, 255], then the result is unspecified. 5\) Returns the result of `m+ms.count()`. If the result is out of the range [1, 12], it's reduced modulo 12 and then +1. @@ -117,13 +117,13 @@ constexpr year_month_weekday_last operator+(const years& dy, const year_month_we 8\) Returns the result of adding the number of months and years to the specified month and year. -9\) Returns the result of adding months or years to a `year_month_day`. If `ymd.month()` is `February` and `ymd.day()` is not in the range [1d, 28d], `ok()` may return `false` for the result of the addition. +9\) Returns the result of adding months or years to a `year_month_day`. If `ymd.month()` is `February` and `ymd.day()` is not in the range [1d, 28d], `ok()` may return `false` for the result of the addition. 10\) Returns `(ymdl.year() / ymdl.month() + dm) / last`. Note: The `/` used here isn't a division operator. It's the date operator. 11\) Returns `ymdl + dm`. -12\) Returns `{ymdl.year()+dy, ymdl.month_day_last()}` +12\) Returns `{ymdl.year()+dy, ymdl.month_day_last()}` 13\) Returns `ymwd + dm.count()`. @@ -163,12 +163,12 @@ int main() // year_month_weekday year_month_weekday ymw{ year(1997) / January / Wednesday[1] }; std::cout << ymw + months{1} << '\n'; // 1997/Feb/Wed[1] - std::cout << ymw + years{1} << '\n'; // 1998/Jan/Wed[1] + std::cout << ymw + years{1} << '\n'; // 1998/Jan/Wed[1] // year_month_weekday_last year_month_weekday_last ymwl{ year(1997) / January / Wednesday[last] }; std::cout << ymwl + months{ 1 } << '\n'; // 1997/Feb/Wed[last] - std::cout << ymwl + years{ 1 } << '\n'; // 1998/Jan/Wed[last] + std::cout << ymwl + years{ 1 } << '\n'; // 1998/Jan/Wed[last] return 0; } @@ -295,7 +295,7 @@ constexpr year_month_weekday_last operator-(const year_month_weekday_last& ymwdl 4\) Returns the result of `d-ds.count()`. If the result is out of the range [0, 255], then the result is unspecified. -5\) If `m.ok() == true` and `ms.ok() == true`, returns the result of subtracting the two month values, or subtracting the number of months. The result will be in the range [1, 12]. If the result is negative, it wraps around. For example, subtracting one month from January (`month m1{1} - months{1};` results in 12 (December). +5\) If `m.ok() == true` and `ms.ok() == true`, returns the result of subtracting the two month values, or subtracting the number of months. The result will be in the range [1, 12]. If the result is negative, it wraps around. For example, subtracting one month from January (`month m1{1} - months{1};` results in 12 (December). 6\) Returns the difference in months between *`Left`* and *`Right`* @@ -303,7 +303,7 @@ constexpr year_month_weekday_last operator-(const year_month_weekday_last& ymwdl 8\) Returns the number of days between two weekdays. -9\) Returns `year(int(y)-ys.count)())` +9\) Returns `year(int(y)-ys.count())` 10\) Returns `years(int(y) - int(y2))`. Subtracting two `year` values results in a `std::chrono::years`, which represents the difference in years between `y` and `y2`. For example, `2021y-2000y` produces `years(21)`. @@ -336,10 +336,10 @@ int main() { // day day d{10}; - d = d - days(5); + d = d - days(5); std::cout << d << '\n'; // 05 - // month + // month month m{2}; m = m - months{1}; std::cout << m << '\n'; // Jan @@ -362,18 +362,18 @@ int main() // year_month_day_last year_month_day_last ymdl = June / last / 2021; - std::cout << ymdl - years{1} - months{1} << '\n'; // 2022/Jul/last + std::cout << ymdl - years{1} - months{1} << '\n'; // 2020/May/last // year_month_weekday year_month_weekday ymw{ year(1997) / January / Wednesday[1] }; std::cout << ymw - months{1} << '\n'; // 1996/Dec/Wed[1] - std::cout << ymw - years{1} << '\n'; // 1996/Jan/Wed[1] + std::cout << ymw - years{1} << '\n'; // 1996/Jan/Wed[1] // year_month_weekday_last year_month_weekday_last ymwl{ year(1997) / January / Wednesday[last] }; std::cout << ymwl - months{ 1 } << '\n'; // 1996/Dec/Wed[last] std::cout << ymwl - years{ 1 } << '\n'; // 1996/Jan/Wed[last] - + return 0; } ``` @@ -458,7 +458,7 @@ The right `duration` or `time_point` object. ### Return value 1\) Returns **`true`** if the number of ticks for the type common to *`Left`* and *`Right`* aren't equal. Otherwise, returns **`false`**.\ -2\) Returns **`true`** if the two [`time_point`](time-point-class.md) objects don't represent the same point in time. Otherwise, returns **`false`**. +2\) Returns **`true`** if the two [`time_point`](time-point-class.md) objects don't represent the same point in time. Otherwise, returns **`false`**. ## `operator*` @@ -644,7 +644,7 @@ constexpr bool operator==(const year_month_day_last& Left, const year_month_day_ // 16) year_month_weekday constexpr bool operator==(const year_month_weekday& Left, const year_month_weekday& Right) noexcept; // C++20 -// 17) year_month_weekday_last +// 17) year_month_weekday_last constexpr bool operator==(const year_month_weekday_last& Left, const year_month_weekday_last& Right) noexcept; // C++20 // 18) time_zone_link @@ -668,8 +668,8 @@ The right object to compare. 1\) Returns **`true`** if the number of ticks for the type common to *`Left`* and *`Right`* are equal. Otherwise, returns **`false`**.\ 2\) Returns **`true`** if *`Left`* and *`Right`* represent the same point in time. Otherwise, returns **`false`**.\ 3-17\) Returns **`true`** if *`Left`* and *`Right`* have the same value. Otherwise, returns **`false`**.\ -18\) Returns **`true`** if `Left.name() == Right.name()`. Otherwise, returns `*false*`.\ -19\) Returns **`true`** if `Left.get_time_zone() == _Right.get_time_zone() && Left.get_sys_time() == Right.get_sys_time();` +18\) Returns **`true`** if `Left.name() == Right.name()`. Otherwise, returns **`false`**.\ +19\) Returns **`true`** if `Left.get_time_zone() == Right.get_time_zone() && Left.get_sys_time() == Right.get_sys_time();` ## `operator>` @@ -678,7 +678,7 @@ The right object to compare. 2\) Determines if the point in time since the epoch of the `Left`[`time_point`](../standard-library/time-point-class.md) is greater than the time since the epoch of the `time_point` in `Right`. ```cpp -1) +1) template constexpr bool operator>( const duration& Left, @@ -786,7 +786,7 @@ strong_ordering operator<=>(const time_zone_link& Left, const time_zone_link& Ri ### Parameters *`Left`, `Right`*\ -The [`day`](day-class.md), [`duration`](duration-class.md), [`month`](month-class.md), [`month_day`](month-day-class.md), [`month_day_last`](month-day-last-class.md), [`time_point`](time-point-class.md), [`time_zone_link`](time-zone-link-class.md), [`year`](year-class.md), [`year_month`](year-month-class.md), [`year_month_day`](year-month-day-class.md), [`year_month_day_last`](year-month-day-last-class.md) to compare. +The [`day`](day-class.md), [`duration`](duration-class.md), [`month`](month-class.md), [`month_day`](month-day-class.md), [`month_day_last`](month-day-last-class.md), [`time_point`](time-point-class.md), [`time_zone_link`](time-zone-link-class.md), [`year`](year-class.md), [`year_month`](year-month-class.md), [`year_month_day`](year-month-day-class.md), [`year_month_day_last`](year-month-day-last-class.md) to compare. ### Return value @@ -846,8 +846,8 @@ int main() ``` ```output -d1 < d2 -true true false +d1 > d2 +true true false ``` ## `operator<<` @@ -1118,7 +1118,7 @@ The output stream you passed in, `os` 21\) In Microsoft's implementation, a `sys_info` is output as its `begin`, `end`, `offset`, `save`, and `abbrev` fields. For example: `begin: 2021-03-14 10:00:00, end: 2021-11-07 09:00:00, offset: -25200s, save: 60min, abbrev: PDT` -22\) In Microsoft's implementation, a `local_info` is output as yyyy-mm-dd hh:mm::ss.ssssss. For example, `2021-09-17 13:55:59.6590120` +22\) In Microsoft's implementation, a `local_info` is output as yyyy-mm-dd hh:mm:ss.ssssss. For example, `2021-09-17 13:55:59.6590120` 23\) The local time in the `zoned_time` (obtained as `zt.get_local_time()`) is output using the format yyyy-mm-dd hh:mm:ss timezone. For example, `2021-09-15 10:45:00 GMT-6` @@ -1160,7 +1160,7 @@ constexpr duration::type 2) template -constexpr typename common_type, duration>::type +constexpr typename common_type, duration>::type operator%( const duration& Left, const duration& Right); @@ -1214,7 +1214,7 @@ A `duration` object. *`Div`*\ An integral value. -*`Left`*\w +*`Left`*\ The left `duration` object. *`Right`*\ @@ -1262,7 +1262,7 @@ operator/(const year& y, const month& m) noexcept; // C++20 // 2 constexpr year_month operator/(const year& y, int m) noexcept; // C++20 - + ///////// returns month_day // 3 @@ -1438,7 +1438,7 @@ operator/(const month_weekday_last& mwdl, int y) noexcept; // C++20 The day. Provided either as an integer in the range [1,31], or as a [`day`](day-class.md). *`lastspec`*\ -An empty tag type that indicates the last item in s sequence. For example, `2021y/May/last` is the last day of May 2021. +An empty tag type that indicates the last item in a sequence. For example, `2021y/May/last` is the last day of May 2021. *`m`*\ The month. Provided either as an integer in the range [1,12], or as a [`month`](month-class.md). diff --git a/docs/standard-library/chrono.md b/docs/standard-library/chrono.md index 82bc6ae8243..f2fdb6b4b75 100644 --- a/docs/standard-library/chrono.md +++ b/docs/standard-library/chrono.md @@ -44,7 +44,7 @@ Using the time-zone facilities on older versions of Windows results in a runtime | [`month` class](month-class.md) | A month of a year. For example, July. | | [`month_day` class](month-day-class.md) | A specific day of a specific month. For example, July 30. | | [`month_day_last` class](month-day-last-class.md) | The last day of a month. | -| [`month_weekday` class](month-day-last-class.md) | The nth weekday of a specific month. | +| [`month_weekday` class](month-weekday-class.md) | The nth weekday of a specific month. | | [`month_weekday_last` class](month-weekday-last-class.md) | The nth weekday of a specific month. | | [`time_point` class](time-point-class.md) | A point in time. | | [`weekday` class](weekday-class.md) | A day of the week. | diff --git a/docs/standard-library/clock-time-conversion-struct.md b/docs/standard-library/clock-time-conversion-struct.md index a014ea0308c..188c50e8ea1 100644 --- a/docs/standard-library/clock-time-conversion-struct.md +++ b/docs/standard-library/clock-time-conversion-struct.md @@ -94,14 +94,14 @@ utc_time operator()(const sys_time& t) const; ### Parameters -**`t`** +*`t`*\ The `time_point` to convert. ### Return value 1-3\) Identity conversions. No conversion. Returns `t` without any changes.\ 4\) Returns `utc_clock::to_sys(t)`.\ -5\) Returns` utc_clock::from_sys(t)`. +5\) Returns `utc_clock::from_sys(t)`. ### Deduction guides diff --git a/docs/standard-library/codecvt-class.md b/docs/standard-library/codecvt-class.md index 72eeb2d1cb4..43d007c8bbd 100644 --- a/docs/standard-library/codecvt-class.md +++ b/docs/standard-library/codecvt-class.md @@ -4,7 +4,6 @@ description: "describes the Microsoft C runtime `codecvt` class API" ms.date: "11/09/2020" f1_keywords: ["xlocale/std::codecvt", "xlocale/std::codecvt::extern_type", "xlocale/std::codecvt::intern_type", "xlocale/std::codecvt::state_type", "xlocale/std::codecvt::always_noconv", "xlocale/std::codecvt::do_always_noconv", "xlocale/std::codecvt::do_encoding", "xlocale/std::codecvt::do_in", "xlocale/std::codecvt::do_length", "xlocale/std::codecvt::do_max_length", "xlocale/std::codecvt::do_out", "xlocale/std::codecvt::do_unshift", "xlocale/std::codecvt::encoding", "xlocale/std::codecvt::in", "xlocale/std::codecvt::length", "xlocale/std::codecvt::max_length", "xlocale/std::codecvt::out", "xlocale/std::codecvt::unshift"] helpviewer_keywords: ["std::codecvt [C++]", "std::codecvt [C++], extern_type", "std::codecvt [C++], intern_type", "std::codecvt [C++], state_type", "std::codecvt [C++], always_noconv", "std::codecvt [C++], do_always_noconv", "std::codecvt [C++], do_encoding", "std::codecvt [C++], do_in", "std::codecvt [C++], do_length", "std::codecvt [C++], do_max_length", "std::codecvt [C++], do_out", "std::codecvt [C++], do_unshift", "std::codecvt [C++], encoding", "std::codecvt [C++], in", "std::codecvt [C++], length", "std::codecvt [C++], max_length", "std::codecvt [C++], out", "std::codecvt [C++], unshift"] -ms.assetid: 37d3efa1-2b7f-42b6-b04f-7a972c8c2c86 --- # `codecvt` Class @@ -228,7 +227,7 @@ virtual result do_in( const Byte*& next1, CharType* first2, CharType* last2, - CharType*& next2,) const; + CharType*& next2) const; ``` ### Parameters @@ -517,7 +516,7 @@ result in( const Byte*& next1, CharType* first2, CharType* last2, - CharType*& next2,) const; + CharType*& next2) const; ``` ### Parameters diff --git a/docs/standard-library/collate-byname-class.md b/docs/standard-library/collate-byname-class.md index 3c79d0aaad5..c63a9c25268 100644 --- a/docs/standard-library/collate-byname-class.md +++ b/docs/standard-library/collate-byname-class.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: collate_byname Class" title: "collate_byname Class" -ms.date: "11/04/2016" +description: "Learn more about: collate_byname Class" +ms.date: 11/04/2016 f1_keywords: ["locale/std::collate_byname"] helpviewer_keywords: ["collate_byname class"] -ms.assetid: 3dc380df-867c-4763-b60e-ba62a8e63ca7 --- # collate_byname Class @@ -40,7 +39,7 @@ An initial reference count. ## Remarks -The class template describes an object that can serve as a [locale facet](../standard-library/locale-class.md#facet_class) of type [collate](../standard-library/collate-class.md#collate)\. Its behavior is determined by the [named](../standard-library/locale-class.md#name) locale *_Locname*. Each constructor initializes its base object with [collate](../standard-library/collate-class.md#collate)\( `_Refs`). +The class template describes an object that can serve as a [locale facet](../standard-library/locale-class.md#facet_class) of type [collate](../standard-library/collate-class.md#collate)\. Its behavior is determined by the [named](../standard-library/locale-class.md#name) locale *_Locname*. Each constructor initializes its base object with [collate](../standard-library/collate-class.md#collate)\(`_Refs`). ## Requirements diff --git a/docs/standard-library/collate-class.md b/docs/standard-library/collate-class.md index fd516200e4d..b391fc83bc5 100644 --- a/docs/standard-library/collate-class.md +++ b/docs/standard-library/collate-class.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: collate Class" title: "collate Class" -ms.date: "11/04/2016" +description: "Learn more about: collate Class" +ms.date: 11/04/2016 f1_keywords: ["locale/std::collate", "locale/std::collate::char_type", "locale/std::collate::string_type", "locale/std::collate::compare", "locale/std::collate::do_compare", "locale/std::collate::do_hash", "locale/std::collate::do_transform", "locale/std::collate::hash", "locale/std::collate::transform"] helpviewer_keywords: ["std::collate [C++]", "std::collate [C++], char_type", "std::collate [C++], string_type", "std::collate [C++], compare", "std::collate [C++], do_compare", "std::collate [C++], do_hash", "std::collate [C++], do_transform", "std::collate [C++], hash", "std::collate [C++], transform"] -ms.assetid: 92168798-9628-4a2e-be6e-fa62dcd4d6a6 --- # collate Class @@ -142,7 +141,7 @@ The member function returns: The first sequence compares less if it has the smaller element in the earliest unequal pair in the sequences, or, if no unequal pairs exist, but the first sequence is shorter. -The member function returns [do_compare](#do_compare)( `first1`, `last1`, `first2`, `last2`). +The member function returns [do_compare](#do_compare)(`first1`, `last1`, `first2`, `last2`). ### Example @@ -290,7 +289,7 @@ A hash value of type **`long`** for the sequence. ### Remarks -The member function returns [do_hash](#do_hash)( `first`, `last`). +The member function returns [do_hash](#do_hash)(`first`, `last`). A hash value can be useful, for example, in distributing sequences pseudo-randomly across an array of lists. diff --git a/docs/standard-library/complex-double.md b/docs/standard-library/complex-double.md index 386c66d380f..a2dd59629c7 100644 --- a/docs/standard-library/complex-double.md +++ b/docs/standard-library/complex-double.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: complex" title: "complex" -ms.date: "11/04/2016" +description: "Learn more about: complex" +ms.date: 11/04/2016 f1_keywords: ["complex/std::complex"] helpviewer_keywords: ["complex function"] -ms.assetid: 0d0b9d2a-9b9b-410b-82a0-86b6df127e47 --- # `complex` @@ -29,13 +28,13 @@ constexpr explicit complex(const complex& complexNum); ### Parameters -*RealVal*\ +*`RealVal`*\ The value of type **`double`** for the real part of the complex number being constructed. -*ImagVal*\ +*`ImagVal`*\ The value of type **`double`** for the imaginary part of the complex number being constructed. -*complexNum*\ +*`complexNum`*\ The complex number of type **`float`** or of type **`long double`** whose real and imaginary parts are used to initialize a complex number of type **`double`** being constructed. ## Return Value @@ -46,7 +45,7 @@ A complex number of type **`double`**. The explicit specialization of the class template complex to a complex class of type **`double`** differs from the class template only in the constructors it defines. The conversion from **`float`** to **`double`** is allowed to be implicit, but the conversion from **`long double`** to **`double`** is required to be **`explicit`**. The use of **`explicit`** rules out the initiation with type conversion using assignment syntax. -For more information on the class template `complex`, see [complex Class](../standard-library/complex-class.md). For a list of members of the class template `complex`, see . +For more information on the class template `complex` and its members, see [`complex` Class](complex-class.md). ## Example @@ -105,11 +104,11 @@ arg ( c3 ) = 0.896055 radians, which is 51.3402 degrees. ## Requirements -**Header**: \ +**Header**: `` -**Namespace:** std +**Namespace:** `std` ## See also -[complex Class](../standard-library/complex-class.md)\ -[Thread Safety in the C++ Standard Library](../standard-library/thread-safety-in-the-cpp-standard-library.md) +[`complex` Class](complex-class.md)\ +[Thread Safety in the C++ Standard Library](thread-safety-in-the-cpp-standard-library.md) diff --git a/docs/standard-library/complex-float.md b/docs/standard-library/complex-float.md index d6672b4dfbe..3a2537bc63e 100644 --- a/docs/standard-library/complex-float.md +++ b/docs/standard-library/complex-float.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: complex" title: "complex" -ms.date: "11/04/2016" +description: "Learn more about: complex" +ms.date: 11/04/2016 f1_keywords: ["complex/std::complex"] helpviewer_keywords: ["complex function"] -ms.assetid: 1178eb1e-39bd-4017-89cd-aea95f813939 --- # `complex` @@ -34,13 +33,13 @@ constexpr complex( ### Parameters -*_RealVal*\ +*`_RealVal`*\ The value of type **`float`** for the real part of the complex number being constructed. -*_ImagVal*\ +*`_ImagVal`*\ The value of type **`float`** for the imaginary part of the complex number being constructed. -*complexNum*\ +*`complexNum`*\ The complex number of type **`double`** or of type **`long double`** whose real and imaginary parts are used to initialize a complex number of type **`float`** being constructed. ## Return Value @@ -51,7 +50,7 @@ A complex number of type **`float`**. The explicit specialization of the class template complex to a complex class of type **`float`** differs from the class template only in the constructors it defines. The conversion from **`float`** to **`double`** is allowed to be implicit, but the less safe conversion from **`float`** to **`long double`** is required to be **`explicit`**. The use of **`explicit`** rules out the initiation with type conversion using assignment syntax. -For more information on the class template `complex`, see [complex Class](../standard-library/complex-class.md). For a list of members of the class template `complex`, see . +For more information on the class template `complex` and its members, see [`complex` Class](complex-class.md). ## Example @@ -111,11 +110,11 @@ arg ( c3 ) = 0.927295 radians, which is 53.1301 degrees. ## Requirements -**Header**: \ +**Header**: `` -**Namespace:** std +**Namespace:** `std` ## See also -[complex Class](../standard-library/complex-class.md)\ -[Thread Safety in the C++ Standard Library](../standard-library/thread-safety-in-the-cpp-standard-library.md) +[`complex` Class](complex-class.md)\ +[Thread Safety in the C++ Standard Library](thread-safety-in-the-cpp-standard-library.md) diff --git a/docs/standard-library/complex-long-double.md b/docs/standard-library/complex-long-double.md index b84606143bb..1ef66888470 100644 --- a/docs/standard-library/complex-long-double.md +++ b/docs/standard-library/complex-long-double.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: complex" title: "complex" -ms.date: "11/04/2016" +description: "Learn more about: complex" +ms.date: 11/04/2016 f1_keywords: ["std::complex", "complex", "std.complex"] helpviewer_keywords: ["complex function"] -ms.assetid: 37591991-b385-46e9-b727-d534dbc10432 --- # `complex` @@ -29,13 +28,13 @@ complex( ### Parameters -*_RealVal*\ +*`_RealVal`*\ The value of type **`long double`** for the real part of the complex number being constructed. -*_ImagVal*\ +*`_ImagVal`*\ The value of type **`long double`** for the imaginary part of the complex number being constructed. -*complexNum*\ +*`complexNum`*\ The complex number of type **`double`** or of type **`float`** whose real and imaginary parts are used to initialize a complex number of type **`long double`** being constructed. ## Return Value @@ -46,7 +45,7 @@ A complex number of type **`long double`**. The explicit specialization of the class template `complex` to a complex class of type **`long double`** differs from the class template only in the constructors it defines. The conversion from **`long double`** to **`float`** is allowed to be implicit, but the conversion from **`double`** to **`long double`** is required to be **`explicit`**. The use of **`explicit`** rules out the initiation with type conversion using assignment syntax. -For more information on the class template `complex` and its members, see [complex Class](../standard-library/complex-class.md). +For more information on the class template `complex` and its members, see [`complex` Class](complex-class.md). **Microsoft-specific**: The **`long double`** and **`double`** types have the same representation, but are distinct types. For more information, see [Built-in types](../cpp/fundamental-types-cpp.md). @@ -108,11 +107,11 @@ arg( c3 ) = 0.927295 radians, which is 53.1301 degrees. ## Requirements -**Header**: \ +**Header**: `` -**Namespace:** std +**Namespace:** `std` ## See also -[complex Class](../standard-library/complex-class.md)\ -[Thread Safety in the C++ Standard Library](../standard-library/thread-safety-in-the-cpp-standard-library.md) +[`complex` Class](complex-class.md)\ +[Thread Safety in the C++ Standard Library](thread-safety-in-the-cpp-standard-library.md) diff --git a/docs/standard-library/condition-variable-enums.md b/docs/standard-library/condition-variable-enums.md index 2f2e3e650ba..23501c7ec38 100644 --- a/docs/standard-library/condition-variable-enums.md +++ b/docs/standard-library/condition-variable-enums.md @@ -1,17 +1,21 @@ --- -description: "Learn more about: enums" title: " enums" -ms.date: "11/04/2016" +description: "Learn more about: enums" +ms.date: 11/04/2016 f1_keywords: ["condition_variable/std::cv_status"] -ms.assetid: f261ad79-e25b-4afa-9f8a-909ce697e0d8 --- # `` enums -## cv_status +The `` header provides the following enums: + +## `cv_status` -Supplies symbolic names for the return values of the methods of class template [condition_variable](../standard-library/condition-variable-class.md). +Supplies symbolic names for the return values of the methods of class template [`condition_variable`](condition-variable-class.md). -class cv_status { - no_timeout - timeout +```cpp +enum class cv_status +{ + no_timeout, + timeout }; +``` diff --git a/docs/standard-library/cpp-standard-library-header-files.md b/docs/standard-library/cpp-standard-library-header-files.md index 42ef673a990..a0eaf3e4630 100644 --- a/docs/standard-library/cpp-standard-library-header-files.md +++ b/docs/standard-library/cpp-standard-library-header-files.md @@ -1,9 +1,8 @@ --- title: "C++ standard library header files" description: "C++ standard library header files, categorized" -ms.date: "08/31/2020" +ms.date: 08/31/2020 helpviewer_keywords: ["header files, C++ Standard Library", "C++ Standard Library, header files"] -ms.assetid: e7bf497a-0f63-48d0-9b54-cb0eef4073c4 --- # C++ standard library header files @@ -15,26 +14,26 @@ Header files for the C++ standard library and extensions, by category. | Category | Headers | | - | - | -| [Algorithms](./algorithms.md) | [``](algorithm.md), [``](cstdlib.md), [``](numeric.md) | +| [Algorithms](algorithms.md) | [``](algorithm.md), [``](cstdlib.md), [``](numeric.md) | | Atomic operations | [``](atomic.md)11 | | C library wrappers | [``](cassert.md), [``](ccomplex.md)11 a b, [``](cctype.md), [``](cerrno.md), [``](cfenv.md)11, [``](cfloat.md), [``](cinttypes.md)11, [``](ciso646.md)b, [``](climits.md), [``](clocale.md), [``](cmath.md), [``](csetjmp.md), [``](csignal.md), [``](cstdalign.md)11 a b, [``](cstdarg.md), [``](cstdbool.md)11 a b, [``](cstddef.md), [``](cstdint.md)11, [``](cstdio.md), [``](cstdlib.md), [``](cstring.md), [``](ctgmath.md)11 a b, [``](ctime.md), [``](cuchar.md)11, [``](cwchar.md), [``](cwctype.md) | | Concepts | ``20 | -| [Containers](./stl-containers.md) | | +| [Containers](stl-containers.md) | | | Sequence containers | [``](array.md)11, [``](deque.md), [``](forward-list.md)11, [``](list.md), [``](vector.md) | | Ordered associative containers| [``](map.md), [``](set.md) | | Unordered associative containers | [``](unordered-map.md)11, [``](unordered-set.md)11 | | Container adaptors | [``](queue.md), [``](stack.md) | | Container views | [``](span.md)20 | | [Errors and exception handling](../cpp/errors-and-exception-handling-modern-cpp.md) | [``](cassert.md), [``](exception.md), [``](stdexcept.md), [``](system-error.md)11 | -| General utilities | ``17, [``](bit.md)20, [``](bitset.md), [``](cstdlib.md), ``17, [``](functional.md), [``](memory.md), ``17, ``17, [``](ratio.md)11, [``](scoped-allocator.md)11, [``](tuple.md)11, [``](type-traits.md)11, [``](typeindex.md)11, [``](utility.md), ``17 | +| General utilities | [``](any.md)17, [``](bit.md)20, [``](bitset.md), [``](cstdlib.md), [``](execution.md)17, [``](functional.md), [``](memory.md), [``](memory-resource.md)17, [``](optional.md)17, [``](ratio.md)11, [``](scoped-allocator.md)11, [``](tuple.md)11, [``](type-traits.md)11, [``](typeindex.md)11, [``](utility.md), [``](variant.md)17 | | [I/O and formatting](../text/string-and-i-o-formatting-modern-cpp.md) | [``](cinttypes.md)11, [``](cstdio.md), [``](filesystem.md)17, [``](fstream.md), [``](iomanip.md), [``](ios.md), [``](iosfwd.md), [``](iostream.md), [``](istream.md), [``](ostream.md), [``](sstream.md), [``](streambuf.md), [``](strstream.md)c, ``20 | | Iterators | [``](iterator.md) | | Language support | [``](cfloat.md), [``](climits.md), [``](codecvt.md)11 a, ``20, ``20, ``20, [``](csetjmp.md), [``](csignal.md), [``](cstdarg.md), [``](cstddef.md), [``](cstdint.md)11, [``](cstdlib.md), [``](exception.md), [``](initializer-list.md)11, [``](limits.md), [``](new.md), [``](typeinfo.md), ``20 | | Localization | [``](clocale.md), [``](codecvt.md)11 a, [``](cvt-wbuffer.md), [``](cvt-wstring.md), [``](locale.md) | -| Math and numerics | ``20, [``](cfenv.md)11, [``](cmath.md), [``](complex.md), [``](cstdlib.md), [``](limits.md), [``](numeric.md), [``](random.md)11, [``](ratio.md)11, [``](valarray.md) | -| [Memory management](../cpp/smart-pointers-modern-cpp.md) | [``](allocators-header.md), [``](memory.md), ``17, [``](new.md), [``](scoped-allocator.md)11 | +| Math and numerics | [``](bit.md)20, [``](cfenv.md)11, [``](cmath.md), [``](complex.md), [``](cstdlib.md), [``](limits.md), [``](numeric.md), [``](random.md)11, [``](ratio.md)11, [``](valarray.md) | +| [Memory management](../cpp/smart-pointers-modern-cpp.md) | [``](allocators-header.md), [``](memory.md), [``](memory-resource.md)17, [``](new.md), [``](scoped-allocator.md)11 | | Multithreading | [``](atomic.md)11, [``](condition-variable.md)11, [``](future.md)11, [``](mutex.md)11, [``](shared-mutex.md)14, [``](thread.md)11 | -| Ranges | ``20 | +| Ranges | [``](ranges.md)20 | | Regular expressions | [``](regex.md)11 | | Strings and character data | [``](charconv.md)17, [``](cctype.md), [``](cstdlib.md), [``](cstring.md), [``](cuchar.md)11, [``](cwchar.md), [``](cwctype.md), [``](regex.md)11, [``](string.md), [``](string-view.md)17 | | Time | [``](chrono.md)11, [``](ctime.md) | @@ -53,9 +52,9 @@ Header files for the C++ standard library and extensions, by category. |Category|Headers| |-|-| -|[Algorithms](./algorithms.md)|[``](algorithm.md)| +|[Algorithms](algorithms.md)|[``](algorithm.md)| |C library wrappers|[``](cassert.md), [``](cctype.md), [``](cerrno.md), [``](cfenv.md), [``](cfloat.md), [``](cinttypes.md), [``](ciso646.md), [``](climits.md), [``](clocale.md), [``](cmath.md), [``](csetjmp.md), [``](csignal.md), [``](cstdarg.md), [``](cstdbool.md), [``](cstddef.md), [``](cstdint.md), [``](cstdio.md), [``](cstdlib.md), [``](cstring.md), [``](ctgmath.md), [``](ctime.md), [``](cwchar.md), [``](cwctype.md)| -|[Containers](./stl-containers.md)|| +|[Containers](stl-containers.md)|| |Sequence containers|[``](array.md), [``](deque.md), [``](forward-list.md), [``](list.md), [``](vector.md)| |Ordered associative containers| [``](map.md), [``](set.md)| |Unordered associative containers|[``](unordered-map.md), [``](unordered-set.md)| diff --git a/docs/standard-library/cpp-standard-library-reference.md b/docs/standard-library/cpp-standard-library-reference.md index acc476cecf9..6ae574d37e9 100644 --- a/docs/standard-library/cpp-standard-library-reference.md +++ b/docs/standard-library/cpp-standard-library-reference.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: C++ Standard Library Reference (STL)" title: "C++ Standard Library Reference" -ms.date: "3/5/2021" +description: "Learn more about: C++ Standard Library Reference (STL)" +ms.date: 3/5/2021 helpviewer_keywords: ["C++ Standard Library, reference", "C++ Standard Library", "template libraries", "libraries, Standard C++", "Microsoft standard template library, reference", "Microsoft STL, reference"] --- @@ -18,11 +18,11 @@ From a historical perspective, "STL" originally referred to the Standard Templat ## In this section -[C++ Standard Library overview](../standard-library/cpp-standard-library-overview.md) +[C++ Standard Library overview](cpp-standard-library-overview.md)\ Provides an overview of the Microsoft implementation of the C++ Standard Library. -[`iostream` programming](../standard-library/iostream-programming.md) +[`iostream` programming](iostream-programming.md)\ Provides an overview of `iostream` programming. -[Header files reference](../standard-library/cpp-standard-library-header-files.md) +[Header files reference](cpp-standard-library-header-files.md)\ Provides links to reference topics about the C++ Standard Library header files, with code examples. diff --git a/docs/standard-library/ctype-byname-class.md b/docs/standard-library/ctype-byname-class.md index f8c4a596674..b959d0f6018 100644 --- a/docs/standard-library/ctype-byname-class.md +++ b/docs/standard-library/ctype-byname-class.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: ctype_byname Class" title: "ctype_byname Class" -ms.date: "11/04/2016" +description: "Learn more about: ctype_byname Class" +ms.date: 11/04/2016 f1_keywords: ["xlocale/std::ctype_byname"] helpviewer_keywords: ["ctype_byname class"] -ms.assetid: a5cec021-a1f8-425f-8757-08e6f064b604 --- # ctype_byname Class @@ -33,7 +32,7 @@ protected: ## Remarks -Its behavior is determined by the named locale `_Locname`. Each constructor initializes its base object with [ctype](../standard-library/ctype-class.md)\( `_Refs`) or the equivalent for base class `ctype`. +Its behavior is determined by the named locale `_Locname`. Each constructor initializes its base object with [ctype](../standard-library/ctype-class.md)\(`_Refs`) or the equivalent for base class `ctype`. ## Requirements diff --git a/docs/standard-library/ctype-char-class.md b/docs/standard-library/ctype-char-class.md index 32beff1c351..8a0c452ec94 100644 --- a/docs/standard-library/ctype-char-class.md +++ b/docs/standard-library/ctype-char-class.md @@ -1,14 +1,13 @@ --- -description: "Learn more about: ctype Class" title: "ctype Class" -ms.date: "11/04/2016" +description: "Learn more about: ctype Class" +ms.date: 11/04/2016 f1_keywords: ["ctype", "locale/std::ctype"] helpviewer_keywords: ["ctype class"] -ms.assetid: ee30acb4-a743-405e-b3d4-13602092da84 --- # `ctype` Class -The class is an explicit specialization of class template `ctype\` to type **`char`**, describing an object that can serve as a locale facet to characterize various properties of a character of type **`char`**. +The class is an explicit specialization of class template `ctype` to type **`char`**, describing an object that can serve as a locale facet to characterize various properties of a character of type **`char`**. ## Syntax @@ -108,7 +107,7 @@ The explicit specialization differs from the class template in several ways: - The static member object `table_size` specifies the minimum number of elements in a ctype mask table. -- The protected static member function `classic_table`( returns the ctype mask table appropriate to the "C" locale. +- The protected static member function `classic_table` returns the ctype mask table appropriate to the "C" locale. - There are no protected virtual member functions [do_is](../standard-library/ctype-class.md#do_is), [do_scan_is](../standard-library/ctype-class.md#do_scan_is), or [do_scan_not](../standard-library/ctype-class.md#do_scan_not). The corresponding public member functions perform the equivalent operations themselves. diff --git a/docs/standard-library/ctype-class.md b/docs/standard-library/ctype-class.md index 3a43c74acff..4d69b959369 100644 --- a/docs/standard-library/ctype-class.md +++ b/docs/standard-library/ctype-class.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: ctype Class" title: "ctype Class" -ms.date: "11/04/2016" +description: "Learn more about: ctype Class" +ms.date: 11/04/2016 f1_keywords: ["xlocale/std::ctype", "xlocale/std::ctype::char_type", "xlocale/std::ctype::do_is", "xlocale/std::ctype::do_narrow", "xlocale/std::ctype::do_scan_is", "xlocale/std::ctype::do_scan_not", "xlocale/std::ctype::do_tolower", "xlocale/std::ctype::do_toupper", "xlocale/std::ctype::do_widen", "xlocale/std::ctype::is", "xlocale/std::ctype::narrow", "xlocale/std::ctype::scan_is", "xlocale/std::ctype::scan_not", "xlocale/std::ctype::tolower", "xlocale/std::ctype::toupper", "xlocale/std::ctype::widen"] helpviewer_keywords: ["std::ctype [C++]", "std::ctype [C++], char_type", "std::ctype [C++], do_is", "std::ctype [C++], do_narrow", "std::ctype [C++], do_scan_is", "std::ctype [C++], do_scan_not", "std::ctype [C++], do_tolower", "std::ctype [C++], do_toupper", "std::ctype [C++], do_widen", "std::ctype [C++], is", "std::ctype [C++], narrow", "std::ctype [C++], scan_is", "std::ctype [C++], scan_not", "std::ctype [C++], tolower", "std::ctype [C++], toupper", "std::ctype [C++], widen"] -ms.assetid: 3627154c-49d9-47b5-b28f-5bbedee38e3b --- # ctype Class @@ -118,7 +117,7 @@ The possible values for the *_Refs* parameter and their significance are: No direct examples are possible, because the destructor is protected. -The constructor initializes its `locale::facet` base object with **locale::**[facet](../standard-library/locale-class.md#facet_class)( `_Refs`). +The constructor initializes its `locale::facet` base object with **locale::**[facet](../standard-library/locale-class.md#facet_class)(`_Refs`). ## ctype::do_is @@ -207,7 +206,7 @@ The second protected member function returns a pointer to the destination range ### Remarks -The second protected member template function stores in `dest`[ `I`] the value `do_narrow`( `first` [ `I`], `default`), for `I` in the interval [0, `last` - `first`). +The second protected member template function stores in `dest`[ `I`] the value `do_narrow`(`first` [ `I`], `default`), for `I` in the interval [0, `last` - `first`). ### Example @@ -241,7 +240,7 @@ A pointer to the first character in a range that does match a specified mask. If ### Remarks -The protected member function returns the smallest pointer `ptr` in the range [ `first`, `last`) for which [do_is](#do_is)( `maskVal`, \* `ptr`) is true. +The protected member function returns the smallest pointer `ptr` in the range [ `first`, `last`) for which [do_is](#do_is)(`maskVal`, \* `ptr`) is true. ### Example @@ -275,7 +274,7 @@ A pointer to the first character in a range that doesn't match a specified mask. ### Remarks -The protected member function returns the smallest pointer `ptr` in the range [ `first`, `last`) for which [do_is](#do_is)( `maskVal`, \* `ptr`) is false. +The protected member function returns the smallest pointer `ptr` in the range [ `first`, `last`) for which [do_is](#do_is)(`maskVal`, \* `ptr`) is false. ### Example @@ -310,7 +309,7 @@ The first protected member function returns the lowercase form of the parameter ### Remarks -The second protected member template function replaces each element `first` [ `I`], for `I` in the interval [0, `last` - `first`), with `do_tolower`( `first` [ `I`]). +The second protected member template function replaces each element `first` [ `I`], for `I` in the interval [0, `last` - `first`), with `do_tolower`(`first` [ `I`]). ### Example @@ -345,7 +344,7 @@ The first protected member function returns the uppercase form of the parameter ### Remarks -The second protected member template function replaces each element `first` [ `I`], for `I` in the interval [0, `last` - `first`), with `do_toupper`( `first` [ `I`]). +The second protected member template function replaces each element `first` [ `I`], for `I` in the interval [0, `last` - `first`), with `do_toupper`(`first` [ `I`]). ### Example @@ -386,7 +385,7 @@ The second protected member function returns a pointer to the destination range ### Remarks -The second protected member template function stores in `dest`[ `I`] the value `do_widen`( `first`[ `I`]), for `I` in the interval [0, `last` - `first`). +The second protected member template function stores in `dest`[ `I`] the value `do_widen`(`first`[ `I`]), for `I` in the interval [0, `last` - `first`). ### Example @@ -466,8 +465,8 @@ int main() { cout << string[i] << ": " << (maskarray[i] & ctype_base::alpha "alpha" : "not alpha") - << endl;; - }; + << endl; + } } ``` @@ -734,7 +733,7 @@ The second member function returns *last*. ### Remarks -The first member function returns [do_toupper](#do_toupper)(`ch`). The second member function returns [do_toupper](#do_toupper)( `first`, `last`). +The first member function returns [do_toupper](#do_toupper)(`ch`). The second member function returns [do_toupper](#do_toupper)(`first`, `last`). ### Example diff --git a/docs/standard-library/cvt-wbuffer.md b/docs/standard-library/cvt-wbuffer.md index 58d5cc7cc31..09f8a4bcb6a 100644 --- a/docs/standard-library/cvt-wbuffer.md +++ b/docs/standard-library/cvt-wbuffer.md @@ -1,14 +1,13 @@ --- -description: "Learn more about: " title: "" -ms.date: "11/04/2016" +description: "Learn more about: " +ms.date: 11/04/2016 f1_keywords: ["stdext.cvt.", "stdext::cvt::", ""] helpviewer_keywords: ["cvt/wbuffer header"] -ms.assetid: 6e6eb44c-1bc4-4d8c-a4bd-b39c753ce725 --- # `` -The header `` in previous versions of Visual Studio defined the class template [wbuffer_convert Class](../standard-library/wbuffer-convert-class.md) in the stdext::cvt namespace. The header is maintained for backward compatibility. New code should use the version of the class that is defined in [\](../standard-library/locale.md) in the `std` namespace +The header `` in previous versions of Visual Studio defined the class template [`wbuffer_convert`](../standard-library/wbuffer-convert-class.md) in the stdext::cvt namespace. The header is maintained for backward compatibility. New code should use the version of the class that is defined in [\](../standard-library/locale.md) in the `std` namespace ## Syntax diff --git a/docs/standard-library/cvt-wstring.md b/docs/standard-library/cvt-wstring.md index 3ce22b8c32e..c2ca25ac7e7 100644 --- a/docs/standard-library/cvt-wstring.md +++ b/docs/standard-library/cvt-wstring.md @@ -1,14 +1,13 @@ --- -description: "Learn more about: " title: "" -ms.date: "11/04/2016" +description: "Learn more about: " +ms.date: 11/04/2016 f1_keywords: ["stdext.cvt.", "", "stdext::cvt::"] helpviewer_keywords: ["cvt/wstring header"] -ms.assetid: d78b04bb-9ac0-4adb-8ffe-3aefb9b14c2d --- # `` -The header `` in previous versions of Visual Studio defined the class template [wstring_convert Class](../standard-library/wstring-convert-class.md) in the stdext::cvt namespace. The header is maintained for backward compatibility. New code should use the version of the class that is defined in [\](../standard-library/locale.md) in the `std` namespace +The header `` in previous versions of Visual Studio defined the class template [`wstring_convert`](wstring-convert-class.md) in the `stdext::cvt` namespace. The header is maintained for backward compatibility. New code should use the version of the class that is defined in [``](locale.md) in the `std` namespace. ## Syntax @@ -16,8 +15,6 @@ The header `` in previous versions of Visual Studio defined the cla #include ``` -## Requirements - ## See also [Header Files Reference](../standard-library/cpp-standard-library-header-files.md) diff --git a/docs/standard-library/day-class.md b/docs/standard-library/day-class.md index 411f71aeace..e97739f9488 100644 --- a/docs/standard-library/day-class.md +++ b/docs/standard-library/day-class.md @@ -1,12 +1,12 @@ --- -description: "Learn more about: day Class" title: "day class" +description: "Learn more about: day Class" ms.date: 09/07/2021 -f1_keywords: ["chrono/std::chrono::day", "chrono/std::chrono::day::ok", "chrono/std::chrono::day:operator++", "chrono/std::chrono::day::operator--", "chrono/std::chrono::day::operator unsigned"] +f1_keywords: ["chrono/std::chrono::day", "chrono/std::chrono::day::ok", "chrono/std::chrono::day::operator++", "chrono/std::chrono::day::operator--", "chrono/std::chrono::day::operator unsigned"] helpviewer_keywords: ["std::chrono [C++], day"] dev_langs: ["C++"] --- -# `day` class +# `day` class Represents a day of the month. For example, the 25th day of the month. @@ -270,4 +270,4 @@ int main() [`month_day_last` class](month-day-last-class.md)\ [`year_month_day`](year-month-day-class.md)\ [`year_month_day_last`](year-month-day-last-class.md)\ -[Header Files Reference](../standard-library/cpp-standard-library-header-files.md) \ No newline at end of file +[Header Files Reference](../standard-library/cpp-standard-library-header-files.md) diff --git a/docs/standard-library/deque-class.md b/docs/standard-library/deque-class.md index ab5e723a027..775b92a2d87 100644 --- a/docs/standard-library/deque-class.md +++ b/docs/standard-library/deque-class.md @@ -1,7 +1,7 @@ --- title: "deque Class" description: "Learn more about: deque Class" -ms.date: "11/04/2016" +ms.date: 11/04/2016 f1_keywords: ["deque/std::deque", "deque/std::deque::allocator_type", "deque/std::deque::const_iterator", "deque/std::deque::const_pointer", "deque/std::deque::const_reference", "deque/std::deque::const_reverse_iterator", "deque/std::deque::difference_type", "deque/std::deque::iterator", "deque/std::deque::pointer", "deque/std::deque::reference", "deque/std::deque::reverse_iterator", "deque/std::deque::size_type", "deque/std::deque::value_type", "deque/std::deque::assign", "deque/std::deque::at", "deque/std::deque::back", "deque/std::deque::begin", "deque/std::deque::cbegin", "deque/std::deque::cend", "deque/std::deque::clear", "deque/std::deque::crbegin", "deque/std::deque::crend", "deque/std::deque::emplace", "deque/std::deque::emplace_back", "deque/std::deque::emplace_front", "deque/std::deque::empty", "deque/std::deque::end", "deque/std::deque::erase", "deque/std::deque::front", "deque/std::deque::get_allocator", "deque/std::deque::insert", "deque/std::deque::max_size", "deque/std::deque::pop_back", "deque/std::deque::pop_front", "deque/std::deque::push_back", "deque/std::deque::push_front", "deque/std::deque::rbegin", "deque/std::deque::rend", "deque/std::deque::resize", "deque/std::deque::shrink_to_fit", "deque/std::deque::size", "deque/std::deque::swap"] helpviewer_keywords: ["std::deque [C++]", "std::deque [C++], allocator_type", "std::deque [C++], const_iterator", "std::deque [C++], const_pointer", "std::deque [C++], const_reference", "std::deque [C++], const_reverse_iterator", "std::deque [C++], difference_type", "std::deque [C++], iterator", "std::deque [C++], pointer", "std::deque [C++], reference", "std::deque [C++], reverse_iterator", "std::deque [C++], size_type", "std::deque [C++], value_type", "std::deque [C++], assign", "std::deque [C++], at", "std::deque [C++], back", "std::deque [C++], begin", "std::deque [C++], cbegin", "std::deque [C++], cend", "std::deque [C++], clear", "std::deque [C++], crbegin", "std::deque [C++], crend", "std::deque [C++], emplace", "std::deque [C++], emplace_back", "std::deque [C++], emplace_front", "std::deque [C++], empty", "std::deque [C++], end", "std::deque [C++], erase", "std::deque [C++], front", "std::deque [C++], get_allocator", "std::deque [C++], insert", "std::deque [C++], max_size", "std::deque [C++], pop_back", "std::deque [C++], pop_front", "std::deque [C++], push_back", "std::deque [C++], push_front", "std::deque [C++], rbegin", "std::deque [C++], rend", "std::deque [C++], resize", "std::deque [C++], shrink_to_fit", "std::deque [C++], size", "std::deque [C++], swap"] --- @@ -11,9 +11,9 @@ Arranges elements of a given type in a linear arrangement and, like a vector, en ## Syntax -```unstlib -template > -class deque +```cpp +template > +class deque; ``` ### Parameters @@ -354,7 +354,7 @@ int main( ) c1_Iter = c1.begin( ); cout << "The first element of c1 is " << *c1_Iter << endl; -*c1_Iter = 20; + *c1_Iter = 20; c1_Iter = c1.begin( ); cout << "The first element of c1 is now " << *c1_Iter << endl; @@ -720,7 +720,7 @@ None of the constructors perform any interim reallocations. ### Example ```cpp -/ compile with: /EHsc +// compile with: /EHsc #include #include #include @@ -1604,7 +1604,7 @@ template struct S { MyDeque::const_iterator iter; for (iter = d.cbegin(); iter != d.cend(); iter++) cout << *iter << " "; -cout << " via unnamed rvalue reference " << endl; + cout << " via unnamed rvalue reference " << endl; } }; @@ -1634,7 +1634,7 @@ int main( ) Provides a pointer to an element in a [`deque`](../standard-library/deque-class.md). -```unstlib +```cpp typedef typename Allocator::pointer pointer; ``` diff --git a/docs/standard-library/deque-functions.md b/docs/standard-library/deque-functions.md index db96fab9930..ed6244dc98f 100644 --- a/docs/standard-library/deque-functions.md +++ b/docs/standard-library/deque-functions.md @@ -1,9 +1,8 @@ --- -description: "Learn more about: functions" title: " functions" +description: "Learn more about: functions" ms.date: "11/04/2016" f1_keywords: ["deque/std::swap"] -ms.assetid: 1d14be53-b0b7-4f66-90cc-65bdeac563fd --- # `` functions @@ -14,7 +13,7 @@ Exchanges the elements of two deques. ```cpp void swap( deque& left, - deque& right,); + deque& right); ``` ### Parameters diff --git a/docs/standard-library/deque.md b/docs/standard-library/deque.md index 4a56c8107b7..30e85cc0034 100644 --- a/docs/standard-library/deque.md +++ b/docs/standard-library/deque.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: " title: "" -ms.date: "11/04/2016" +description: "Learn more about: " +ms.date: 11/04/2016 f1_keywords: [""] helpviewer_keywords: ["deque header"] -ms.assetid: 4521fe92-5a91-4853-9e9f-59600bf9e46f --- # `` @@ -25,7 +24,7 @@ Defines the container class template deque and several supporting templates. |-|-| |[operator!=](../standard-library/deque-operators.md#op_neq)|Tests if the deque object on the left side of the operator is not equal to the deque object on the right side.| |[operator<](../standard-library/deque-operators.md#op_lt)|Tests if the deque object on the left side of the operator is less than the deque object on the right side.| -|[operator\<=](../standard-library/deque-operators.md#op_gt_eq)|Tests if the deque object on the left side of the operator is less than or equal to the deque object on the right side.| +|[operator\<=](../standard-library/deque-operators.md#op_lt_eq)|Tests if the deque object on the left side of the operator is less than or equal to the deque object on the right side.| |[operator==](../standard-library/deque-operators.md#op_eq_eq)|Tests if the deque object on the left side of the operator is equal to the deque object on the right side.| |[operator>](../standard-library/deque-operators.md#op_gt)|Tests if the deque object on the left side of the operator is greater than the deque object on the right side.| |[operator>=](../standard-library/deque-operators.md#op_gt_eq)|Tests if the deque object on the left side of the operator is greater than or equal to the deque object on the right side.| diff --git a/docs/standard-library/domain-error-class.md b/docs/standard-library/domain-error-class.md index fe6bc72dfe1..c976e9d9d67 100644 --- a/docs/standard-library/domain-error-class.md +++ b/docs/standard-library/domain-error-class.md @@ -1,12 +1,11 @@ --- -description: "Learn more about: domain_error Class" -title: "domain_error Class" -ms.date: "09/09/2021" +title: "domain_error class" +description: "Learn more about: domain_error class" +ms.date: 09/09/2021 f1_keywords: ["stdexcept/std::domain_error"] helpviewer_keywords: ["domain_error class"] -ms.assetid: a1d8245d-61c2-4d1e-973f-073bd5dd5fa3 --- -# domain_error Class +# `domain_error` class The class serves as the base class for all exceptions thrown to report a domain error (as in mathematics, not networking). @@ -18,13 +17,12 @@ public: explicit domain_error(const string& message); explicit domain_error(const char *message); - }; ``` ## Remarks -The value returned by `what()` is a copy of `message.data()`. For more information, see [`what`](../standard-library/exception-class.md) and [`data`](../standard-library/basic-string-class.md#data). +The value returned by `what()` is a copy of `message.data()`. For more information, see [`what`](exception-class.md) and [`data`](basic-string-class.md#data). `domain_error` isn't thrown by any functions in the Microsoft implementation of the C++ Standard Library, but it might be thrown by third-party libraries or user code. @@ -51,19 +49,20 @@ int main() cerr << "Type: " << typeid(e).name() << endl; } } -/* Output: +``` + +```Output Caught: Your domain is in error! Type: class std::domain_error -*/ ``` ## Requirements -**Header:** \ +**Header:** `` -**Namespace:** std +**Namespace:** `std` ## See also -[logic_error Class](../standard-library/logic-error-class.md)\ -[Thread Safety in the C++ Standard Library](../standard-library/thread-safety-in-the-cpp-standard-library.md) +[`logic_error` class](logic-error-class.md)\ +[Thread Safety in the C++ Standard Library](thread-safety-in-the-cpp-standard-library.md) diff --git a/docs/standard-library/drop-view-class.md b/docs/standard-library/drop-view-class.md index 84984d30b46..337a2b4cd44 100644 --- a/docs/standard-library/drop-view-class.md +++ b/docs/standard-library/drop-view-class.md @@ -85,7 +85,7 @@ If you specify more elements to drop than exist in the underlying range, then an The best way to create a `drop_view` is by using the [`views::drop`](range-adaptors.md#drop) range adaptor. Range adaptors are the intended way to create view classes. The view types are exposed in case you want to create your own custom view type. -### Example: `drop_view` +### Example: `drop_view` ```cpp // requires /std:c++20 or later diff --git a/docs/standard-library/duration-class.md b/docs/standard-library/duration-class.md index d0fa6d8e030..e3269876783 100644 --- a/docs/standard-library/duration-class.md +++ b/docs/standard-library/duration-class.md @@ -1,6 +1,6 @@ --- -description: "Learn more about: duration class" title: "duration Class" +description: "Learn more about: duration class" ms.date: 01/05/2022 f1_keywords: ["chrono/std::chrono::duration", "chrono/std::chrono::duration::duration", "chrono/std::chrono::duration::count", "chrono/std::chrono::duration::max", "chrono/std::chrono::duration::min", "chrono/std::chrono::duration::zero","chrono/std::chrono::duration::operator-", "chrono/std::chrono::duration::operator--", "chrono/std::chrono::duration::operator%=", "chrono/std::chrono::duration::operator*=", "chrono/std::chrono::duration::operator+", "chrono/std::chrono::duration::operator++", "chrono/std::chrono::duration::operator+=", "chrono/std::chrono::duration::operator-=", "chrono/std::chrono::duration::operator="] helpviewer_keywords: ["std::chrono [C++], duration"] @@ -156,7 +156,7 @@ A duration type `D1` is *incommensurable* with another duration type `D2` if `D2 Unless *`Rep2`* is implicitly convertible to `rep` and either `treat_as_floating_point`*holds true* or `treat_as_floating_point`*holds false*, the second constructor doesn't participate in overload resolution. For more information, see [](type-traits.md). -Unless no overflow is induced in the conversion and `treat_as_floating_point`*holds true*, or both `ratio_divide::den` equals 1 and `treat_as_floating_point`*holds false*, the third constructor doesn't participate in overload resolution. For more information, see [](type-traits.md). +Unless no overflow is induced in the conversion and `treat_as_floating_point`*holds true*, or both `ratio_divide::den` equals 1 and `treat_as_floating_point`*holds false*, the third constructor doesn't participate in overload resolution. For more information, see [](type-traits.md). ## Example: Create a `duration` diff --git a/docs/standard-library/elements-view-class.md b/docs/standard-library/elements-view-class.md index 4197bcf2155..86cbc8b57e8 100644 --- a/docs/standard-library/elements-view-class.md +++ b/docs/standard-library/elements-view-class.md @@ -95,7 +95,7 @@ The best way to create an `elements_view` is by using the [`elements`](range-ada 1\) Create an `elements_view` from the specified view.\ 2\) Default construct an `elements_view`. -### Example: `elements_view` +### Example: `elements_view` ```cpp // requires /std:c++20 or later diff --git a/docs/standard-library/empty-view-class.md b/docs/standard-library/empty-view-class.md index 6d64eedb500..8811f1dd2fb 100644 --- a/docs/standard-library/empty-view-class.md +++ b/docs/standard-library/empty-view-class.md @@ -91,7 +91,7 @@ The best way to create a `empty_view` is by using the [`empty`](range-adaptors.m ### Example `empty_view` ```cpp -// requires /std:c++20 or higher +// requires /std:c++20 or later #include #include @@ -256,7 +256,7 @@ Returns `false`. ### Example `(bool)` ```cpp -// requires /std:c++20 or higher +// requires /std:c++20 or later #include #include diff --git a/docs/standard-library/error-category-class.md b/docs/standard-library/error-category-class.md index 953f7753f93..0eabf941a98 100644 --- a/docs/standard-library/error-category-class.md +++ b/docs/standard-library/error-category-class.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: error_category Class" title: "error_category Class" +description: "Learn more about: error_category Class" ms.date: 06/15/2022 f1_keywords: ["system_error/std::error_category", "system_error/std::error_category::value_type", "system_error/std::error_category::default_error_condition", "system_error/std::error_category::equivalent", "system_error/std::error_category::message", "system_error/std::error_category::name"] helpviewer_keywords: ["std::error_category", "std::error_category::value_type", "std::error_category::default_error_condition", "std::error_category::equivalent", "std::error_category::message", "std::error_category::name"] -ms.assetid: e0a71e14-852d-4905-acd6-5f8ed426706d ms.custom: devdivchpfy22 --- @@ -71,8 +70,6 @@ The error code value to store in the [error_condition](../standard-library/error Returns `error_condition(_Errval, *this)`. -### Remarks - ### equivalent Returns a value that specifies whether error objects are equivalent. @@ -129,8 +126,6 @@ The error code value to describe. Returns a descriptive name of the error code *val* for the category. If the error code is unrecognized, returns `"unknown error"`. -#### Remarks - ### name Returns the name of the category. diff --git a/docs/standard-library/error-code-class.md b/docs/standard-library/error-code-class.md index 9026b35dca2..f7cc93b6fb3 100644 --- a/docs/standard-library/error-code-class.md +++ b/docs/standard-library/error-code-class.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: error_code Class" title: "error_code Class" -ms.date: "11/04/2016" +description: "Learn more about: error_code Class" +ms.date: 11/04/2016 f1_keywords: ["system_error/std::error_code", "system_error/std::error_code::value_type", "system_error/std::error_code::assign", "system_error/std::error_code::category", "system_error/std::error_code::clear", "system_error/std::error_code::default_error_condition", "system_error/std::error_code::message", "system_error/std::error_code::operator bool"] helpviewer_keywords: ["std::error_code", "std::error_code::value_type", "std::error_code::assign", "std::error_code::category", "std::error_code::clear", "std::error_code::default_error_condition", "std::error_code::message"] -ms.assetid: c09b4a96-cb14-4281-a319-63543f9b2b4a --- # error_code Class @@ -82,8 +81,6 @@ Returns the error category. const error_category& category() const; ``` -#### Remarks - ### clear Clears the error code value and category. diff --git a/docs/standard-library/error-condition-class.md b/docs/standard-library/error-condition-class.md index 71767a0471c..ffa0030a441 100644 --- a/docs/standard-library/error-condition-class.md +++ b/docs/standard-library/error-condition-class.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: error_condition Class" title: "error_condition Class" -ms.date: "11/04/2016" +description: "Learn more about: error_condition Class" +ms.date: 11/04/2016 f1_keywords: ["system_error/std::error_condition", "system_error/std::error_condition::value_type", "system_error/std::error_condition::assign", "system_error/std::error_condition::category", "system_error/std::error_condition::clear", "system_error/std::error_condition::message", "system_error/std::error_condition::operator bool"] helpviewer_keywords: ["std::error_condition", "std::error_condition::value_type", "std::error_condition::assign", "std::error_condition::category", "std::error_condition::clear", "std::error_condition::message"] -ms.assetid: 6690f481-97c9-4554-a0ff-851dc96b7a06 --- # error_condition Class @@ -85,8 +84,6 @@ const error_category& category() const; A reference to the stored error category -#### Remarks - ### clear Clears the error code value and category. @@ -160,7 +157,7 @@ bool operator==(const error_condition& right) const; #### Parameters *right*\ -The ojbect to be tested for equality. +The object to be tested for equality. #### Return Value @@ -265,8 +262,6 @@ value_type value() const; The stored error code value of type [value_type](#value_type). -#### Remarks - ### value_type A type that represents the stored error code value. diff --git a/docs/standard-library/exception-typedefs.md b/docs/standard-library/exception-typedefs.md index 2385a803553..f25b44b6dde 100644 --- a/docs/standard-library/exception-typedefs.md +++ b/docs/standard-library/exception-typedefs.md @@ -1,9 +1,8 @@ --- -description: "Learn more about: typedefs" title: " typedefs" -ms.date: "11/04/2016" +description: "Learn more about: typedefs" +ms.date: 11/04/2016 f1_keywords: ["exception/std::exception_ptr", "exception/std::terminate_handler", "exception/std::unexpected_handler"] -ms.assetid: 2a338480-35e2-46f7-b223-52d4e84a5768 --- # `` typedefs @@ -25,11 +24,11 @@ When you declare an `exception_ptr` variable, the variable is not associated wit Use the `current_exception` or `make_exception_ptr` function to assign an exception to an `exception_ptr` object. When you assign an exception to an `exception_ptr` variable, the variable's exception reference field points to a copy of the exception. If there is insufficient memory to copy the exception, the exception reference field points to a copy of a [std::bad_alloc](../standard-library/bad-alloc-class.md) exception. If the `current_exception` or `make_exception_ptr` function cannot copy the exception for any other reason, the function calls the `terminate` CRT function to exit the current process. -Despite its name, an `exception_ptr` object is not itself a pointer. It does not obey pointer semantics and cannot be used with the pointer member access ( `->`) or indirection (*) operators. The `exception_ptr` object has no public data members or member functions. +Despite its name, an `exception_ptr` object is not itself a pointer. It does not obey pointer semantics and cannot be used with the pointer member access (`->`) or indirection (*) operators. The `exception_ptr` object has no public data members or member functions. **Comparisons:** -You can use the equal ( `==`) and not-equal ( `!=`) operators to compare two `exception_ptr` objects. The operators do not compare the binary value (bit pattern) of the `EXCEPTION_RECORD` structures that represent the exceptions. Instead, the operators compare the addresses in the exception reference field of the `exception_ptr` objects. Consequently, a null `exception_ptr` and the NULL value compare as equal. +You can use the equal (`==`) and not-equal (`!=`) operators to compare two `exception_ptr` objects. The operators do not compare the binary value (bit pattern) of the `EXCEPTION_RECORD` structures that represent the exceptions. Instead, the operators compare the addresses in the exception reference field of the `exception_ptr` objects. Consequently, a null `exception_ptr` and the NULL value compare as equal. ## terminate_handler diff --git a/docs/standard-library/file-clock-class.md b/docs/standard-library/file-clock-class.md index fe87f0ce9ea..6f9b2251cec 100644 --- a/docs/standard-library/file-clock-class.md +++ b/docs/standard-library/file-clock-class.md @@ -1,6 +1,6 @@ --- -description: "Learn more about: file_clock class" title: "file_clock class" +description: "Learn more about: file_clock class" ms.date: 3/8/2024 f1_keywords: ["chrono/std::chrono::file_clock", "chrono/std::chrono::file_clock::now", "chrono/std::chrono::file_clock::to_utc", "chrono/std::chrono::file_clock::from_utc", "chrono/std::chrono::file_clock::is_steady Constant"] --- @@ -17,7 +17,7 @@ using file_clock = std::filesystem::_File_time_clock; // C++20 ## Remarks -In the Microsoft implementation, the epoch, or the time from which the `file_clock` starts measuring time, is 1/1/1601 00:00:00. +In the Microsoft implementation, the epoch, or the time from which the `file_clock` starts measuring time, is 1/1/1601 00:00:00. The ISO C++ Standard provides a choice between providing `to_sys()` and `from_sys()`, or `to_utc()` and `from_utc()`. The Microsoft implementation chose [to_utc](#to_utc) and [from_utc](#from_utc). diff --git a/docs/standard-library/file-status-class.md b/docs/standard-library/file-status-class.md index 1dbed5fb4bb..02d399d3cd9 100644 --- a/docs/standard-library/file-status-class.md +++ b/docs/standard-library/file-status-class.md @@ -1,9 +1,8 @@ --- -description: "Learn more about: file_status Class" title: "file_status Class" -ms.date: "09/10/2018" +description: "Learn more about: file_status Class" +ms.date: 09/10/2018 f1_keywords: ["filesystem/std::experimental::filesystem::file_status", "filesystem/std::experimental::filesystem::file_status::operator=", "filesystem/std::experimental::filesystem::file_status::type", "filesystem/std::experimental::filesystem::file_status::permissions"] -ms.assetid: 9781840e-ad22-44dd-ad79-0fabaa94bac4 helpviewer_keywords: ["std::experimental::filesystem::file_status", "std::experimental::filesystem::file_status::operator=", "std::experimental::filesystem::file_status::type", "std::experimental::filesystem::file_status::permissions"] --- # file_status Class @@ -74,7 +73,7 @@ The defaulted member assignment operators behave as expected. ```cpp file_status& operator=(const file_status&) noexcept = default; -file_status& operator=(file_status&&) nexcept = default; +file_status& operator=(file_status&&) noexcept = default; ``` ### Parameters diff --git a/docs/standard-library/filesystem-functions.md b/docs/standard-library/filesystem-functions.md index eef418109a7..2c642f3180a 100644 --- a/docs/standard-library/filesystem-functions.md +++ b/docs/standard-library/filesystem-functions.md @@ -1,6 +1,6 @@ --- -description: "Learn more about: functions" title: " functions" +description: "Learn more about: functions" ms.date: "03/27/2019" f1_keywords: ["FILESYSTEM/std::experimental::filesystem::absolute", "FILESYSTEM/std::experimental::filesystem::canonical", "FILESYSTEM/std::experimental::filesystem::copy", "FILESYSTEM/std::experimental::filesystem::copy_file", "FILESYSTEM/std::experimental::filesystem::copy_symlink", "FILESYSTEM/std::experimental::filesystem::create_directories", "FILESYSTEM/std::experimental::filesystem::create_directory", "FILESYSTEM/std::experimental::filesystem::create_directory_symlink", "FILESYSTEM/std::experimental::filesystem::create_hard_link", "FILESYSTEM/std::experimental::filesystem::create_symlink", "FILESYSTEM/std::experimental::filesystem::current_path", "FILESYSTEM/std::experimental::filesystem::equivalent", "FILESYSTEM/std::experimental::filesystem::exists", "FILESYSTEM/std::experimental::filesystem::file_size", "FILESYSTEM/std::experimental::filesystem::hard_link_count", "FILESYSTEM/std::experimental::filesystem::hash_value", "FILESYSTEM/std::experimental::filesystem::is_block_file", "FILESYSTEM/std::experimental::filesystem::is_character_file", "FILESYSTEM/std::experimental::filesystem::is_directory", "FILESYSTEM/std::experimental::filesystem::is_empty", "FILESYSTEM/std::experimental::filesystem::is_fifo", "FILESYSTEM/std::experimental::filesystem::is_other", "FILESYSTEM/std::experimental::filesystem::is_regular_file", "FILESYSTEM/std::experimental::filesystem::is_socket", "FILESYSTEM/std::experimental::filesystem::is_symlink", "FILESYSTEM/std::experimental::filesystem::last_write_time", "FILESYSTEM/std::experimental::filesystem::permissions", "FILESYSTEM/std::experimental::filesystem::read_symlink", "FILESYSTEM/std::experimental::filesystem::remove", "FILESYSTEM/std::experimental::filesystem::remove_all", "FILESYSTEM/std::experimental::filesystem::rename", "FILESYSTEM/std::experimental::filesystem::resize_file", "FILESYSTEM/std::experimental::filesystem::space", "FILESYSTEM/std::experimental::filesystem::status", "FILESYSTEM/std::experimental::filesystem::status_known", "FILESYSTEM/std::experimental::filesystem::swap", "FILESYSTEM/std::experimental::filesystem::symlink_status", "FILESYSTEM/std::experimental::filesystem::system_complete", "FILESYSTEM/std::experimental::filesystem::temp_directory_path", "FILESYSTEM/std::experimental::filesystem::u8path"] helpviewer_keywords: ["std::experimental::filesystem::absolute", "std::experimental::filesystem::canonical", "std::experimental::filesystem::copy", "std::experimental::filesystem::copy_file", "std::experimental::filesystem::copy_symlink", "std::experimental::filesystem::create_directories", "std::experimental::filesystem::create_directory", "std::experimental::filesystem::create_directory_symlink", "std::experimental::filesystem::create_hard_link", "std::experimental::filesystem::create_symlink", "std::experimental::filesystem::current_path", "std::experimental::filesystem::equivalent", "std::experimental::filesystem::exists", "std::experimental::filesystem::file_size", "std::experimental::filesystem::hard_link_count", "std::experimental::filesystem::hash_value", "std::experimental::filesystem::is_block_file", "std::experimental::filesystem::is_character_file", "std::experimental::filesystem::is_directory", "std::experimental::filesystem::is_empty", "std::experimental::filesystem::is_fifo", "std::experimental::filesystem::is_other", "std::experimental::filesystem::is_regular_file", "std::experimental::filesystem::is_socket", "std::experimental::filesystem::is_symlink", "std::experimental::filesystem::last_write_time", "std::experimental::filesystem::permissions", "std::experimental::filesystem::read_symlink", "std::experimental::filesystem::remove", "std::experimental::filesystem::remove_all", "std::experimental::filesystem::rename", "std::experimental::filesystem::resize_file", "std::experimental::filesystem::space", "std::experimental::filesystem::status", "std::experimental::filesystem::status_known", "std::experimental::filesystem::swap", "std::experimental::filesystem::symlink_status", "std::experimental::filesystem::system_complete", "std::experimental::filesystem::temp_directory_path", "std::experimental::filesystem::u8path"] @@ -129,7 +129,7 @@ The functions all possibly copy the file at *from* to *to* under control of *`op If `exists(to) && !(opts & (copy_options::skip_existing | copy_options::overwrite_existing | copy_options::update_existing))`, then report as an error that the file already exists. -Otherwise, if `!exists(to) || opts & copy_options::overwrite_existing || opts & copy_options::update_existing&& last_write_time(to) < last_write_time(from) || !(opts & (copy_options::skip_existing | copy_options::overwrite_existing | copy_options:update_existing))`, then attempt to copy the contents and attributes of the file *from* to the file *to*. Report as an error if the copy attempt fails. +Otherwise, if `!exists(to) || opts & copy_options::overwrite_existing || opts & copy_options::update_existing&& last_write_time(to) < last_write_time(from) || !(opts & (copy_options::skip_existing | copy_options::overwrite_existing | copy_options::update_existing))`, then attempt to copy the contents and attributes of the file *from* to the file *to*. Report as an error if the copy attempt fails. The functions return **`true`** if the copy is attempted and succeeds, otherwise **`false`**. diff --git a/docs/standard-library/filter-view-class.md b/docs/standard-library/filter-view-class.md index f99b3791bb5..2e36ae8a983 100644 --- a/docs/standard-library/filter-view-class.md +++ b/docs/standard-library/filter-view-class.md @@ -1,8 +1,8 @@ --- -title: filter_view class (C++ Standard Library) +title: "filter_view class (C++ Standard Library)" description: "API reference for the Standard Template Library (STL) filter_view class, which is a view that filters out elements of a range that don't match a predicate." ms.date: 09/27/2022 -f1_keywords: ["ranges/std::filter_view", "ranges/std::filter_view::base", "ranges/std::filter_view::begin", "ranges/std::filter_view::empty", "ranges/std::filter_view::end", "ranges/std::filter_view::operator bool", "ranges/std::filter_view::pred", "ranges/std::filter_view::back", "ranges/std::filter_view::front"] +f1_keywords: ["ranges/std::filter_view", "ranges/std::filter_view::base", "ranges/std::filter_view::begin", "ranges/std::filter_view::empty", "ranges/std::filter_view::end", "ranges/std::filter_view::operator bool", "ranges/std::filter_view::pred", "ranges/std::filter_view::back", "ranges/std::filter_view::front"] helpviewer_keywords: ["std::ranges::filter_view [C++]", "std::ranges::filter_view::base [C++]", "std::ranges::filter_view::begin [C++]", "std::ranges::filter_view::empty [C++]", "std::ranges::filter_view::end [C++]", "std::ranges::filter_view::pred [C++]", "std::ranges::filter_view::back [C++]", "std::ranges::filter_view::front [C++]", "std::ranges::filter_view::operator bool [C++]"] dev_langs: ["C++"] --- diff --git a/docs/standard-library/forward-list-class.md b/docs/standard-library/forward-list-class.md index ecca392abd1..65e5db60422 100644 --- a/docs/standard-library/forward-list-class.md +++ b/docs/standard-library/forward-list-class.md @@ -7,7 +7,7 @@ helpviewer_keywords: ["std::forward_list", "std::forward_list::allocator_type", ms.custom: devdivchpfy22 --- -# forward_list Class +# `forward_list` Class Describes an object that controls a varying-length sequence of elements. The sequence is stored as a singly-linked list of nodes, each containing a member of type `Type`. @@ -21,22 +21,22 @@ class forward_list ### Parameters -Type*\ -The element data type to be stored in the forward_list. +*`Type`*\ +The element data type to be stored in the `forward_list`. -*Allocator*\ -The stored allocator object that encapsulates details about the forward_list allocation and deallocation of memory. This parameter is optional. The default value is allocator<`Type`>. +*`Allocator`*\ +The stored allocator object that encapsulates details about the `forward_list` allocation and deallocation of memory. This parameter is optional. The default value is allocator<`Type`>. ## Remarks -A `forward_list` object allocates and frees storage for the sequence it controls through a stored object of class *Allocator* that is based on [allocator Class](../standard-library/allocator-class.md) (commonly known as `std::allocator)`. For more information, see [Allocators](../standard-library/allocators.md). An allocator object must have the same external interface as an object of type `allocator`. +A `forward_list` object allocates and frees storage for the sequence it controls through a stored object of class *`Allocator`* that is based on [`allocator` Class](../standard-library/allocator-class.md) (commonly known as `std::allocator`). For more information, see [Allocators](../standard-library/allocators.md). An allocator object must have the same external interface as an object of type `allocator`. > [!NOTE] > The stored allocator object is not copied when the container object is assigned. Iterators, pointers and references might become invalid when elements of their controlled sequence are erased through `forward_list`. Insertions and splices performed on the controlled sequence through `forward_list` don't invalidate iterators. -Additions to the controlled sequence might occur by calls to [forward_list::insert_after](#insert_after), which is the only member function that calls the constructor `Type(const T&)`. `forward_list` might also call move constructors. If such an expression throws an exception, the container object inserts no new elements and rethrows the exception. Thus, an object of type `forward_list` is left in a known state when such exceptions occur. +Additions to the controlled sequence might occur by calls to [`forward_list::insert_after`](#insert_after), which is the only member function that calls the constructor `Type(const T&)`. `forward_list` might also call move constructors. If such an expression throws an exception, the container object inserts no new elements and rethrows the exception. Thus, an object of type `forward_list` is left in a known state when such exceptions occur. ## Members @@ -44,62 +44,62 @@ Additions to the controlled sequence might occur by calls to [forward_list::inse |Name|Description| |-|-| -|[forward_list](#forward_list)|Constructs an object of type `forward_list`.| +|[`forward_list`](#forward_list)|Constructs an object of type `forward_list`.| ### Typedefs |Name|Description| |-|-| -|[allocator_type](#allocator_type)|A type that represents the allocator class for a forward list object.| -|[const_iterator](#const_iterator)|A type that provides a constant iterator for the forward list.| -|[const_pointer](#const_pointer)|A type that provides a pointer to a **`const`** element in a forward list.| -|[const_reference](#const_reference)|A type that provides a constant reference to an element in the forward list.| -|[difference_type](#difference_type)|A signed integer type that can be used to represent the number of elements of a forward list in a range between elements pointed to by iterators.| -|[iterator](#iterator)|A type that provides an iterator for the forward list.| -|[pointer](#pointer)|A type that provides a pointer to an element in the forward list.| -|[reference](#reference)|A type that provides a reference to an element in the forward list.| -|[size_type](#size_type)|A type that represents the unsigned distance between two elements.| -|[value_type](#value_type)|A type that represents the type of element stored in a forward list.| +|[`allocator_type`](#allocator_type)|A type that represents the allocator class for a forward list object.| +|[`const_iterator`](#const_iterator)|A type that provides a constant iterator for the forward list.| +|[`const_pointer`](#const_pointer)|A type that provides a pointer to a **`const`** element in a forward list.| +|[`const_reference`](#const_reference)|A type that provides a constant reference to an element in the forward list.| +|[`difference_type`](#difference_type)|A signed integer type that can be used to represent the number of elements of a forward list in a range between elements pointed to by iterators.| +|[`iterator`](#iterator)|A type that provides an iterator for the forward list.| +|[`pointer`](#pointer)|A type that provides a pointer to an element in the forward list.| +|[`reference`](#reference)|A type that provides a reference to an element in the forward list.| +|[`size_type`](#size_type)|A type that represents the unsigned distance between two elements.| +|[`value_type`](#value_type)|A type that represents the type of element stored in a forward list.| ### Functions |Name|Description| |-|-| -|[assign](#assign)|Erases elements from a forward list and copies a new set of elements to a target forward list.| -|[before_begin](#before_begin)|Returns an iterator addressing the position before the first element in a forward list.| -|[begin](#begin)|Returns an iterator addressing the first element in a forward list.| -|[cbefore_begin](#cbefore_begin)|Returns a const iterator addressing the position before the first element in a forward list.| -|[cbegin](#cbegin)|Returns a const iterator addressing the first element in a forward list.| -|[cend](#cend)|Returns a const iterator that addresses the location succeeding the last element in a forward list.| -|[clear](#clear)|Erases all the elements of a forward list.| -|[emplace_after](#emplace_after)|Move constructs a new element after a specified position.| -|[emplace_front](#emplace_front)|Adds an element constructed in place to the beginning of the list.| -|[empty](#empty)|Tests whether a forward list is empty.| -|[end](#end)|Returns an iterator that addresses the location succeeding the last element in a forward list.| -|[erase_after](#erase_after)|Removes elements from the forward list after a specified position.| -|[front](#front)|Returns a reference to the first element in a forward list.| -|[get_allocator](#get_allocator)|Returns a copy of the allocator object used to construct a forward list.| -|[insert_after](#insert_after)|Adds elements to the forward list after a specified position.| -|[max_size](#max_size)|Returns the maximum length of a forward list.| -|[merge](#merge)|Removes the elements from the argument list, inserts them into the target forward list, and orders the new, combined set of elements in ascending order or in some other specified order.| -|[pop_front](#pop_front)|Deletes the element at the beginning of a forward list.| -|[push_front](#push_front)|Adds an element to the beginning of a forward list.| -|[remove](#remove)|Erases elements in a forward list that matches a specified value.| -|[remove_if](#remove_if)|Erases elements from a forward list for which a specified predicate is satisfied.| -|[resize](#resize)|Specifies a new size for a forward list.| -|[reverse](#reverse)|Reverses the order in which the elements occur in a forward list.| -|[sort](#sort)|Arranges the elements in ascending order or with an order specified by a predicate.| -|[splice_after](#splice_after)|Restitches links between nodes.| -|[swap](#swap)|Exchanges the elements of two forward lists.| -|[unique](#unique)|Removes adjacent elements that pass a specified test.| +|[`assign`](#assign)|Erases elements from a forward list and copies a new set of elements to a target forward list.| +|[`before_begin`](#before_begin)|Returns an iterator addressing the position before the first element in a forward list.| +|[`begin`](#begin)|Returns an iterator addressing the first element in a forward list.| +|[`cbefore_begin`](#cbefore_begin)|Returns a const iterator addressing the position before the first element in a forward list.| +|[`cbegin`](#cbegin)|Returns a const iterator addressing the first element in a forward list.| +|[`cend`](#cend)|Returns a const iterator that addresses the location succeeding the last element in a forward list.| +|[`clear`](#clear)|Erases all the elements of a forward list.| +|[`emplace_after`](#emplace_after)|Move constructs a new element after a specified position.| +|[`emplace_front`](#emplace_front)|Adds an element constructed in place to the beginning of the list.| +|[`empty`](#empty)|Tests whether a forward list is empty.| +|[`end`](#end)|Returns an iterator that addresses the location succeeding the last element in a forward list.| +|[`erase_after`](#erase_after)|Removes elements from the forward list after a specified position.| +|[`front`](#front)|Returns a reference to the first element in a forward list.| +|[`get_allocator`](#get_allocator)|Returns a copy of the allocator object used to construct a forward list.| +|[`insert_after`](#insert_after)|Adds elements to the forward list after a specified position.| +|[`max_size`](#max_size)|Returns the maximum length of a forward list.| +|[`merge`](#merge)|Removes the elements from the argument list, inserts them into the target forward list, and orders the new, combined set of elements in ascending order or in some other specified order.| +|[`pop_front`](#pop_front)|Deletes the element at the beginning of a forward list.| +|[`push_front`](#push_front)|Adds an element to the beginning of a forward list.| +|[`remove`](#remove)|Erases elements in a forward list that matches a specified value.| +|[`remove_if`](#remove_if)|Erases elements from a forward list for which a specified predicate is satisfied.| +|[`resize`](#resize)|Specifies a new size for a forward list.| +|[`reverse`](#reverse)|Reverses the order in which the elements occur in a forward list.| +|[`sort`](#sort)|Arranges the elements in ascending order or with an order specified by a predicate.| +|[`splice_after`](#splice_after)|Restitches links between nodes.| +|[`swap`](#swap)|Exchanges the elements of two forward lists.| +|[`unique`](#unique)|Removes adjacent elements that pass a specified test.| ### Operators |Name|Description| |-|-| -|[operator=](#op_eq)|Replaces the elements of the forward list with a copy of another forward list.| +|[`operator=`](#op_eq)|Replaces the elements of the forward list with a copy of another forward list.| -## allocator_type +## `allocator_type` A type that represents the allocator class for a forward list object. @@ -109,9 +109,9 @@ typedef Allocator allocator_type; ### Remarks -`allocator_type` is a synonym for the template parameter Allocator. +`allocator_type` is a synonym for the template parameter `Allocator`. -## assign +## `assign` Erases elements from a forward list and copies a new set of elements to a target forward list. @@ -129,33 +129,33 @@ void assign(InputIterator First, InputIterator Last); ### Parameters -*first*\ +*`first`*\ The beginning of the replacement range. -*last*\ +*`last`*\ The end of the replacement range. -*count*\ +*`count`*\ The number of elements to assign. -*val*\ +*`val`*\ The value to assign each element. -*Type*\ +*`Type`*\ The type of the value. -*IList*\ -The initializer_list to copy. +*`IList`*\ +The `initializer_list` to copy. ### Remarks -If the forward_list is an integer type, the first member function behaves the same as `assign((size_type)First, (Type)Last)`. Otherwise, the first member function replaces the sequence controlled by **`*this`** with the sequence [ `First, Last)`, which must not overlap the initial controlled sequence. +If the `forward_list` is an integer type, the first member function behaves the same as `assign((size_type)First, (Type)Last)`. Otherwise, the first member function replaces the sequence controlled by **`*this`** with the sequence [ `First, Last)`, which must not overlap the initial controlled sequence. The second member function replaces the sequence controlled by **`*this`** with a repetition of `Count` elements of value `Val`. -The third member function copies the elements of the initializer_list into the forward_list. +The third member function copies the elements of the `initializer_list` into the `forward_list`. -## before_begin +## `before_begin` Returns an iterator addressing the position before the first element in a forward list. @@ -168,9 +168,7 @@ iterator before_begin(); A forward iterator that points just before the first element of the sequence (or just before the end of an empty sequence). -### Remarks - -## begin +## `begin` Returns an iterator addressing the first element in a forward list. @@ -183,9 +181,7 @@ iterator begin(); A forward iterator that points at the first element of the sequence (or just beyond the end of an empty sequence). -### Remarks - -## cbefore_begin +## `cbefore_begin` Returns a const iterator addressing the position before the first element in a forward list. @@ -197,9 +193,7 @@ const_iterator cbefore_begin() const; A forward iterator that points just before the first element of the sequence (or just before the end of an empty sequence). -### Remarks - -## cbegin +## `cbegin` Returns a **`const`** iterator that addresses the first element in the range. @@ -215,7 +209,7 @@ A **`const`** forward-access iterator that points at the first element of the ra With the return value of `cbegin`, the elements in the range can't be modified. -You can use this member function in place of the `begin()` member function to guarantee that the return value is `const_iterator`. Typically, it's used with the [auto](../cpp/auto-cpp.md) type deduction keyword, as shown in the following example. In the example, consider `Container` to be a modifiable (non- **`const`**) container of any kind that supports `begin()` and `cbegin()`. +You can use this member function in place of the `begin()` member function to guarantee that the return value is `const_iterator`. Typically, it's used with the [`auto`](../cpp/auto-cpp.md) type deduction keyword, as shown in the following example. In the example, consider `Container` to be a modifiable (non- **`const`**) container of any kind that supports `begin()` and `cbegin()`. ```cpp auto i1 = Container.begin(); @@ -224,7 +218,7 @@ auto i2 = Container.cbegin(); // i2 is Container::const_iterator ``` -## cend +## `cend` Returns a **`const`** iterator that addresses the location just beyond the last element in a range. @@ -240,7 +234,7 @@ A forward-access iterator that points just beyond the end of the range. `cend` is used to test whether an iterator has passed the end of its range. -You can use this member function in place of the `end()` member function to guarantee that the return value is `const_iterator`. Typically, it's used with the [auto](../cpp/auto-cpp.md) type deduction keyword, as shown in the following example. In the example, consider `Container` to be a modifiable (non- **`const`**) container of any kind that supports `end()` and `cend()`. +You can use this member function in place of the `end()` member function to guarantee that the return value is `const_iterator`. Typically, it's used with the [`auto`](../cpp/auto-cpp.md) type deduction keyword, as shown in the following example. In the example, consider `Container` to be a modifiable (non- **`const`**) container of any kind that supports `end()` and `cend()`. ```cpp auto i1 = Container.end(); @@ -252,7 +246,7 @@ auto i2 = Container.cend(); The value returned by `cend` shouldn't be dereferenced. -## clear +## `clear` Erases all the elements of a forward list. @@ -264,7 +258,7 @@ void clear(); This member function calls `erase_after(before_begin(), end())`. -## const_iterator +## `const_iterator` A type that provides a constant iterator for the forward list. @@ -276,7 +270,7 @@ typedef implementation-defined const_iterator; `const_iterator` describes an object that can serve as a constant forward iterator for the controlled sequence. It's described here as a synonym for an implementation-defined type. -## const_pointer +## `const_pointer` A type that provides a pointer to a **`const`** element in a forward list. @@ -285,9 +279,7 @@ typedef typename Allocator::const_pointer const_pointer; ``` -### Remarks - -## const_reference +## `const_reference` A type that provides a constant reference to an element in the forward list. @@ -295,9 +287,7 @@ A type that provides a constant reference to an element in the forward list. typedef typename Allocator::const_reference const_reference; ``` -### Remarks - -## difference_type +## `difference_type` A signed integer type that can be used to represent the number of elements of a forward list in a range between elements pointed to by iterators. @@ -309,7 +299,7 @@ typedef typename Allocator::difference_type difference_type; `difference_type` describes an object that can represent the difference between the addresses of any two elements in the controlled sequence. -## emplace_after +## `emplace_after` Move constructs a new element after a specified position. @@ -320,10 +310,10 @@ iterator emplace_after(const_iterator Where, Type&& val); ### Parameters -*Where*\ +*`Where`*\ The position in the target forward list where the new element is constructed. -*val*\ +*`val`*\ The constructor argument. ### Return Value @@ -332,9 +322,9 @@ An iterator that designates the newly inserted element. ### Remarks -This member function inserts an element with the constructor arguments *val* just after the element pointed to by *Where* in the controlled sequence. Its behavior is otherwise the same as [forward_list::insert_after](#insert_after). +This member function inserts an element with the constructor arguments *`val`* just after the element pointed to by *`Where`* in the controlled sequence. Its behavior is otherwise the same as [`forward_list::insert_after`](#insert_after). -## emplace_front +## `emplace_front` Adds an element constructed in place to the beginning of the list. @@ -345,16 +335,16 @@ template ### Parameters -*val*\ +*`val`*\ The element added to the beginning of the forward list. ### Remarks -This member function inserts an element with the constructor arguments `_ val` at the end of the controlled sequence. +This member function inserts an element with the constructor arguments `val` at the beginning of the controlled sequence. If an exception is thrown, the container is left unaltered and the exception is rethrown. -## empty +## `empty` Tests whether a forward list is empty. @@ -366,7 +356,7 @@ bool empty() const; **`true`** if the forward list is empty; otherwise, **`false`**. -## end +## `end` Returns an iterator that addresses the location succeeding the last element in a forward list. @@ -379,7 +369,7 @@ iterator end(); A forward iterator that points just beyond the end of the sequence. -## erase_after +## `erase_after` Removes elements from the forward list after a specified position. @@ -390,22 +380,22 @@ iterator erase_after(const_iterator first, const_iterator last); ### Parameters -*Where*\ +*`Where`*\ The position in the target forward list where the element is erased. -*first*\ +*`first`*\ The beginning of the range to erase. -*last*\ +*`last`*\ The end of the range to erase. ### Return Value -An iterator that designates the first element remaining beyond any elements removed, or [forward_list::end](#end) if no such element exists. +An iterator that designates the first element remaining beyond any elements removed, or [`forward_list::end`](#end) if no such element exists. ### Remarks -The first member function removes the element of the controlled sequence just after *Where*. +The first member function removes the element of the controlled sequence just after *`Where`*. The second member function removes the elements of the controlled sequence in the range `( first, last)` (neither end point is included). @@ -413,7 +403,7 @@ Erasing `N` elements causes `N` destructor calls. [Reallocation](../standard-lib The member functions never throw an exception. -## forward_list +## `forward_list` Constructs an object of type `forward_list`. @@ -436,36 +426,36 @@ forward_list(InputIterator First, InputIterator Last, const Allocator& Al); ### Parameters -*Al*\ +*`Al`*\ The allocator class to use with this object. -*Count*\ +*`Count`*\ The number of elements in the list constructed. -*Val*\ +*`Val`*\ The value of the elements in the list constructed. -*Right*\ +*`Right`*\ The list of which the constructed list is to be a copy. -*First*\ +*`First`*\ The position of the first element in the range of elements to be copied. -*Last*\ +*`Last`*\ The position of the first element beyond the range of elements to be copied. -*IList*\ -The initializer_list to copy. +*`IList`*\ +The `initializer_list` to copy. ### Remarks -All constructors store an [allocator](../standard-library/allocator-class.md) and initialize the controlled sequence. The allocator object is the argument *Al*, if present. For the copy constructor, it's `right.get_allocator()`. Otherwise, it's `Allocator()`. +All constructors store an [`allocator`](../standard-library/allocator-class.md) and initialize the controlled sequence. The allocator object is the argument *`Al`*, if present. For the copy constructor, it's `right.get_allocator()`. Otherwise, it's `Allocator()`. The first two constructors specify an empty initial controlled sequence. -The third constructor specifies a repetition of *Count* elements of value `Type()`. +The third constructor specifies a repetition of *`Count`* elements of value `Type()`. -The fourth and fifth constructors specify a repetition of *Count* elements of value *Val*. +The fourth and fifth constructors specify a repetition of *`Count`* elements of value *`Val`*. The sixth constructor specifies a copy of the sequence controlled by *Right*. If `InputIterator` is an integer type, the next two constructors specify a repetition of `(size_type)First` elements of value `(Type)Last`. Otherwise, the next two constructors specify the sequence `[First, Last)`. @@ -473,7 +463,7 @@ The ninth and tenth constructors are the same as the sixth, but with an [rvalue] The last constructor specifies the initial controlled sequence with an object of class `initializer_list`. -## front +## `front` Returns a reference to the first element in a forward list. @@ -486,7 +476,7 @@ const_reference front() const; A reference to the first element of the controlled sequence, which must be non-empty. -## get_allocator +## `get_allocator` Returns a copy of the allocator object used to construct a forward list. @@ -496,9 +486,9 @@ allocator_type get_allocator() const; ### Return Value -The stored [allocator](../standard-library/allocator-class.md) object. +The stored [`allocator`](../standard-library/allocator-class.md) object. -## insert_after +## `insert_after` Adds elements to the forward list after a specified position. @@ -513,23 +503,23 @@ template ### Parameters -*Where*\ +*`Where`*\ The position in the target forward list where the first element is inserted. -*Count*\ +*`Count`*\ The number of elements to insert. -*First*\ +*`First`*\ The beginning of the insertion range. -*Last*\ +*`Last`*\ The end of the insertion range. -*Val*\ +*`Val`*\ The element added to the forward list. -*IList*\ -The initializer_list to insert. +*`IList`*\ +The `initializer_list` to insert. ### Return Value @@ -537,11 +527,11 @@ An iterator that designates the newly inserted element (first and last member fu ### Remarks -Each of the member functions inserts—just after the element pointed to by *Where* in the controlled sequence—a sequence that' specified by the remaining operands. +Each of the member functions inserts—just after the element pointed to by *`Where`* in the controlled sequence—a sequence that' specified by the remaining operands. -The first member function inserts an element that has value *Val* and returns an iterator that designates the newly inserted element. +The first member function inserts an element that has value *`Val`* and returns an iterator that designates the newly inserted element. -The second member function inserts a repetition of *Count* elements of value *Val*. +The second member function inserts a repetition of *`Count`* elements of value *`Val`*. If `InputIterator` is an integer type, the third member function behaves the same as `insert(it, (size_type)First, (Type)Last)`. Otherwise, it inserts the sequence `[First, Last)`, which must not overlap the initial controlled sequence. @@ -553,7 +543,7 @@ Inserting `N` elements causes `N` constructor calls. [Reallocation](../standard- If an exception is thrown during the insertion of one or more elements, the container is left unaltered and the exception is rethrown. -## iterator +## `iterator` A type that provides an iterator for the forward list. @@ -565,7 +555,7 @@ typedef implementation-defined iterator; `iterator` describes an object that can serve as a forward iterator for the controlled sequence. It's described here as a synonym for an implementation-defined type. -## max_size +## `max_size` Returns the maximum length of a forward list. @@ -577,9 +567,7 @@ size_type max_size() const; The length of the longest sequence that the object can control. -### Remarks - -## merge +## `merge` Combines two sorted sequences into a single sorted sequence in linear time. Removes the elements from the argument list, and inserts them into this `forward_list`. The two lists should be sorted by the same compare function object before the call to `merge`. The combined list will be sorted by that compare function object. @@ -591,10 +579,10 @@ template ### Parameters -*right*\ +*`right`*\ The forward list to merge from. -*comp*\ +*`comp`*\ The compare function object that is used to sort elements. ### Remarks @@ -603,11 +591,11 @@ The compare function object that is used to sort elements. For the iterators `Pi` and `Pj` designating elements at positions `i` and `j`, the first member function imposes the order `!(*Pj < *Pi)` whenever `i < j`. (The elements are sorted in `ascending` order.) The second member function imposes the order `! comp(*Pj, *Pi)` whenever `i < j`. -No pairs of elements in the original controlled sequence are reversed in the resulting controlled sequence. If a pair of elements in the resulting controlled sequence compares equal ( `!(*Pi < *Pj) && !(*Pj < *Pi)`), an element from the original controlled sequence appears before an element from the sequence controlled by `right`. +No pairs of elements in the original controlled sequence are reversed in the resulting controlled sequence. If a pair of elements in the resulting controlled sequence compares equal (`!(*Pi < *Pj) && !(*Pj < *Pi)`), an element from the original controlled sequence appears before an element from the sequence controlled by `right`. An exception occurs only if `comp` throws an exception. In that case, the controlled sequence is left in unspecified order and the exception is rethrown. -## operator= +## `operator=` Replaces the elements of the forward list with a copy of another forward list. @@ -619,21 +607,21 @@ forward_list& operator=(forward_list&& right); ### Parameters -*right*\ +*`right`*\ The forward list being copied into the forward list. -*IList*\ +*`IList`*\ A brace-enclosed initializer list, which behaves just like a sequence of elements of type `Type`. ### Remarks -The first member operator replaces the controlled sequence with a copy of the sequence controlled by *right*. +The first member operator replaces the controlled sequence with a copy of the sequence controlled by *`right`*. The second member operator replaces the controlled sequence from an object of class `initializer_list`. The third member operator is the same as the first, but with an [rvalue](../cpp/rvalue-reference-declarator-amp-amp.md) reference. -## pointer +## `pointer` A type that provides a pointer to an element in the forward list. @@ -641,7 +629,7 @@ A type that provides a pointer to an element in the forward list. typedef typename Allocator::pointer pointer; ``` -## pop_front +## `pop_front` Deletes the element at the beginning of a forward list. @@ -655,7 +643,7 @@ The first element of the forward list must be non-empty. The member function never throws an exception. -## push_front +## `push_front` Adds an element to the beginning of a forward list. @@ -666,14 +654,14 @@ void push_front(Type&& val); ### Parameters -*val*\ +*`val`*\ The element added to the beginning of the forward list. ### Remarks If an exception is thrown, the container is left unaltered and the exception is rethrown. -## reference +## `reference` A type that provides a reference to an element in the forward list. @@ -681,7 +669,7 @@ A type that provides a reference to an element in the forward list. typedef typename Allocator::reference reference; ``` -## remove +## `remove` Erases elements in a forward list that matches a specified value. @@ -691,7 +679,7 @@ void remove(const Type& val); ### Parameters -*val*\ +*`val`*\ The value which, if held by an element, will result in that element's removal from the list. ### Remarks @@ -700,7 +688,7 @@ The member function removes from the controlled sequence all elements, designate The member function never throws an exception. -## remove_if +## `remove_if` Erases elements from a forward list for which a specified predicate is satisfied. @@ -711,16 +699,16 @@ template ### Parameters -*pred*\ +*`pred`*\ The unary predicate which, if satisfied by an element, results in the deletion of that element from the list. ### Remarks The member function removes from the controlled sequence all elements, designated by the iterator `P`, for which `pred(*P)` is true. -An exception occurs only if *pred* throws an exception. In that case, the controlled sequence is left in an unspecified state and the exception is rethrown. +An exception occurs only if *`pred`* throws an exception. In that case, the controlled sequence is left in an unspecified state and the exception is rethrown. -## resize +## `resize` Specifies a new size for a forward list. @@ -731,17 +719,17 @@ void resize(size_type _Newsize, const Type& val); ### Parameters -*_Newsize*\ +*`_Newsize`*\ The number of elements in the resized forward list. -*val*\ +*`val`*\ The value to use for padding. ### Remarks -The member functions both ensure that the number of elements in the list henceforth is *_Newsize*. If it must make the controlled sequence longer, the first member function appends elements with value `Type()`, while the second member function appends elements with value *val*. To make the controlled sequence shorter, both member functions effectively call `erase_after(begin() + _Newsize - 1, end())`. +The member functions both ensure that the number of elements in the list henceforth is *`_Newsize`*. If it must make the controlled sequence longer, the first member function appends elements with value `Type()`, while the second member function appends elements with value *`val`*. To make the controlled sequence shorter, both member functions effectively call `erase_after(begin() + _Newsize - 1, end())`. -## reverse +## `reverse` Reverses the order in which the elements occur in a forward list. @@ -749,7 +737,7 @@ Reverses the order in which the elements occur in a forward list. void reverse(); ``` -## size_type +## `size_type` A type that represents the unsigned distance between two elements. @@ -761,7 +749,7 @@ typedef typename Allocator::size_type size_type; The unsigned integer type describes an object that can represent the length of any controlled sequence. -## sort +## `sort` Arranges the elements in ascending order or with an order specified by a predicate. @@ -773,7 +761,7 @@ void sort(Predicate pred); ### Parameters -*pred*\ +*`pred`*\ The ordering predicate. ### Remarks @@ -782,11 +770,11 @@ Both member functions order the elements in the controlled sequence by a predica For the iterators `Pi` and `Pj` designating elements at positions `i` and `j`, the first member function imposes the order `!(*Pj < *Pi)` whenever `i < j`. (The elements are sorted in `ascending` order.) The member template function imposes the order `! pred(*Pj, *Pi)` whenever `i < j`. No ordered pairs of elements in the original controlled sequence are reversed in the resulting controlled sequence. (The sort is stable.) -An exception occurs only if *pred* throws an exception. In that case, the controlled sequence is left in unspecified order and the exception is rethrown. +An exception occurs only if *`pred`* throws an exception. In that case, the controlled sequence is left in unspecified order and the exception is rethrown. -## splice_after +## `splice_after` -Removes elements from a source forward_list and inserts them into a destination forward_list. +Removes elements from a source `forward_list` and inserts them into a destination `forward_list`. ```cpp // insert the entire source forward_list @@ -813,30 +801,30 @@ void splice_after( ### Parameters -*Where*\ -The position in the destination forward_list after which to insert. +*`Where`*\ +The position in the destination `forward_list` after which to insert. -*Source*\ -The source forward_list that is to be inserted into the destination forward_list. +*`Source`*\ +The source `forward_list` that is to be inserted into the destination `forward_list`. -*Iter*\ -The element to be inserted from the source forward_list. +*`Iter`*\ +The element to be inserted from the source `forward_list`. -*First*\ -The first element in the range to be inserted from source forward_list. +*`First`*\ +The first element in the range to be inserted from source `forward_list`. -*Last*\ -The first position beyond the range to be inserted from the source forward_list. +*`Last`*\ +The first position beyond the range to be inserted from the source `forward_list`. ### Remarks -The first pair of member functions inserts the sequence controlled by *Source* just after the element in the controlled sequence pointed to by *Where*. It also removes all elements from *Source*. (`&Source` must not equal **`this`**.) +The first pair of member functions inserts the sequence controlled by *`Source`* just after the element in the controlled sequence pointed to by *`Where`*. It also removes all elements from *`Source`*. (`&Source` must not equal **`this`**.) -The second pair of member functions removes the element just after *Iter* in the sequence controlled by *Source* and inserts it just after the element in the controlled sequence pointed to by *Where*. (If `Where == Iter || Where == ++Iter`, no change occurs.) +The second pair of member functions removes the element just after *`Iter`* in the sequence controlled by *`Source`* and inserts it just after the element in the controlled sequence pointed to by *`Where`*. (If `Where == Iter || Where == ++Iter`, no change occurs.) -The third pair of member functions (ranged splice) inserts the subrange designated by `(First, Last)` from the sequence controlled by *Source* just after the element in the controlled sequence pointed to by *Where*. It also removes the original subrange from the sequence controlled by *Source*. (If `&Source == this`, the range `(First, Last)` must not include the element pointed to by *Where*.) +The third pair of member functions (ranged splice) inserts the subrange designated by `(First, Last)` from the sequence controlled by *`Source`* just after the element in the controlled sequence pointed to by *`Where`*. It also removes the original subrange from the sequence controlled by *`Source`*. (If `&Source == this`, the range `(First, Last)` must not include the element pointed to by *`Where`*.) -If the ranged splice inserts `N` elements, and `&Source != this`, an object of class [iterator](#iterator) is incremented `N` times. +If the ranged splice inserts `N` elements, and `&Source != this`, an object of class [`iterator`](#iterator) is incremented `N` times. No iterators, pointers, or references that designate spliced elements become invalid. @@ -913,7 +901,7 @@ int main() Beginning state of lists:c1 = (10) (11)c2 = (20) (21) (22)c3 = (30) (31)c4 = (40) (41) (42) (43)After splicing c1 into c2:c1 =c2 = (20) (21) (10) (11) (22)After splicing the first element of c3 into c2:c3 = (30)c2 = (20) (21) (31) (10) (11) (22)After splicing a range of c4 into c2:c4 = (40) (41)c2 = (20) (21) (42) (43) (31) (10) (11) (22) ``` -## swap +## `swap` Exchanges the elements of two forward lists. @@ -923,14 +911,14 @@ void swap(forward_list& right); ### Parameters -*right*\ +*`right`*\ The forward list providing the elements to be exchanged. ### Remarks -The member function swaps the controlled sequences between **`*this`** and *right*. If `get_allocator() == right.get_allocator()`, it does so in constant time, it throws no exceptions, and it invalidates no references, pointers, or iterators that designate elements in the two controlled sequences. Otherwise, it performs element assignments and constructor calls proportional to the number of elements in the two controlled sequences. +The member function swaps the controlled sequences between **`*this`** and *`right`*. If `get_allocator() == right.get_allocator()`, it does so in constant time, it throws no exceptions, and it invalidates no references, pointers, or iterators that designate elements in the two controlled sequences. Otherwise, it performs element assignments and constructor calls proportional to the number of elements in the two controlled sequences. -## unique +## `unique` Eliminates all but the first element from every consecutive group of equal elements. @@ -942,7 +930,7 @@ void unique(BinaryPredicate comp); ### Parameters -*comp*\ +*`comp`*\ The binary predicate used to compare successive elements. ### Remarks @@ -955,7 +943,7 @@ For a controlled sequence of length `N` (> 0), the predicate `comp(*Pi, *Pj)` is An exception occurs only if `comp` throws an exception. In that case, the controlled sequence is left in an unspecified state and the exception is rethrown. -## value_type +## `value_type` A type that represents the type of element stored in a forward list. diff --git a/docs/standard-library/forward-list-operators.md b/docs/standard-library/forward-list-operators.md index 333f3280e64..f221e375767 100644 --- a/docs/standard-library/forward-list-operators.md +++ b/docs/standard-library/forward-list-operators.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: operators" title: " operators" -ms.date: "11/04/2016" -f1_keywords: ["forward_list/std::operator!=", "forward_list/std::operator==", "forward_list/std::operator>", "forward_list/std::operator>=;", "forward_list/std::operator<", "forward_list/std::operator<="] -ms.assetid: 57492e09-3836-4dbc-9ae5-78ecf506c190 -helpviewer_keywords: ["std::operator!= (forward_list)", "std::operator== (forward_list)", "std::operator> (forward_list)", "std::operator>=; (forward_list)", "std::operator< (forward_list)", "std::operator<= (forward_list)"] +description: "Learn more about: operators" +ms.date: 11/04/2016 +f1_keywords: ["forward_list/std::operator!=", "forward_list/std::operator==", "forward_list/std::operator>", "forward_list/std::operator>=;", "forward_list/std::operator<", "forward_list/std::operator<="] +helpviewer_keywords: ["std::operator!= (forward_list)", "std::operator== (forward_list)", "std::operator> (forward_list)", "std::operator>=; (forward_list)", "std::operator< (forward_list)", "std::operator<= (forward_list)"] --- # `` operators diff --git a/docs/standard-library/forward-list.md b/docs/standard-library/forward-list.md index c7400192b6a..3a614d21840 100644 --- a/docs/standard-library/forward-list.md +++ b/docs/standard-library/forward-list.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: " title: "" -ms.date: "11/04/2016" +description: "Learn more about: " +ms.date: 11/04/2016 f1_keywords: [""] helpviewer_keywords: [""] -ms.assetid: 8b4ab09e-1475-434a-b4e0-fdbc07a08b5b --- # `` @@ -30,7 +29,7 @@ Defines the container class template forward_list and several supporting templat |[operator<](../standard-library/forward-list-operators.md#op_lt)|Tests if the forward list object on the left side of the operator is less than the forward list object on the right side.| |[operator<=](../standard-library/forward-list-operators.md#op_lt_eq)|Tests if the forward list object on the left side of the operator is less than or equal to the forward list object on the right side.| |[operator>](../standard-library/forward-list-operators.md#op_gt)|Tests if the forward list object on the left side of the operator is greater than the forward list object on the right side.| -|[operator>=](../standard-library/forward-list-operators.md#op_lt_eq)|Tests if the forward list object on the left side of the operator is greater than or equal to the forward list object on the right side.| +|[operator>=](../standard-library/forward-list-operators.md#op_gt_eq)|Tests if the forward list object on the left side of the operator is greater than or equal to the forward list object on the right side.| ### Functions diff --git a/docs/standard-library/freelist-class.md b/docs/standard-library/freelist-class.md index 743dececd8a..2d3d4286e5e 100644 --- a/docs/standard-library/freelist-class.md +++ b/docs/standard-library/freelist-class.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: freelist Class" title: "freelist Class" -ms.date: "11/04/2016" +description: "Learn more about: freelist Class" +ms.date: 11/04/2016 f1_keywords: ["allocators/stdext::freelist", "allocators/stdext::freelist::pop", "allocators/stdext::freelist::push"] helpviewer_keywords: ["stdext::freelist", "stdext::freelist [C++], pop", "stdext::freelist [C++], push"] -ms.assetid: 8ad7e35c-4c80-4479-8ede-1a2497b06d71 --- # freelist Class @@ -56,8 +55,6 @@ Constructs an object of type `freelist`. freelist(); ``` -### Remarks - ## freelist::pop Removes the first memory block from the free list. diff --git a/docs/standard-library/front-insert-iterator-class.md b/docs/standard-library/front-insert-iterator-class.md index 3ca56a1eb32..9a5859e8455 100644 --- a/docs/standard-library/front-insert-iterator-class.md +++ b/docs/standard-library/front-insert-iterator-class.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: front_insert_iterator Class" title: "front_insert_iterator Class" +description: "Learn more about: front_insert_iterator Class" ms.date: 06/15/2022 f1_keywords: ["iterator/std::front_insert_iterator", "iterator/std::front_insert_iterator::container_type", "iterator/std::front_insert_iterator::reference"] helpviewer_keywords: ["std::front_insert_iterator [C++]", "std::front_insert_iterator [C++], container_type", "std::front_insert_iterator [C++], reference"] -ms.assetid: a9a9c075-136a-4419-928b-c4871afa033c ms.custom: devdivchpfy22 --- @@ -254,11 +253,11 @@ int main( ) list L1; front_insert_iterator > iter ( L1 ); -*iter = 10; + *iter = 10; iter++; -*iter = 20; + *iter = 20; iter++; -*iter = 30; + *iter = 30; iter++; list ::iterator vIter; @@ -316,11 +315,11 @@ int main( ) list L1; front_insert_iterator > iter ( L1 ); -*iter = 10; + *iter = 10; iter++; -*iter = 20; + *iter = 20; iter++; -*iter = 30; + *iter = 30; iter++; list ::iterator vIter; diff --git a/docs/standard-library/fstream-typedefs.md b/docs/standard-library/fstream-typedefs.md index 0676590e457..4006ded8a5e 100644 --- a/docs/standard-library/fstream-typedefs.md +++ b/docs/standard-library/fstream-typedefs.md @@ -1,20 +1,12 @@ --- -description: "Learn more about: typedefs" title: " typedefs" -ms.date: "11/04/2016" +description: "Learn more about: typedefs" +ms.date: 11/04/2016 f1_keywords: ["fstream/std::filebuf", "fstream/std::fstream", "fstream/std::ifstream", "fstream/std::ofstream", "fstream/std::wfilebuf", "fstream/std::wfstream", "fstream/std::wifstream", "fstream/std::wofstream"] -ms.assetid: 8dddef2d-7f17-42a6-ba08-6f6f20597d23 --- # `` typedefs -[`filebuf`](#filebuf)\ -[`fstream`](#fstream)\ -[`ifstream`](#ifstream)\ -[`ofstream`](#ofstream)\ -[`wfilebuf`](#wfilebuf)\ -[`wfstream`](#wfstream)\ -[`wifstream`](#wifstream)\ -[`wofstream`](#wofstream) +The `` header provides the following typedefs: ## `filebuf` diff --git a/docs/standard-library/function-objects-in-the-stl.md b/docs/standard-library/function-objects-in-the-stl.md index e1055bf6f6d..4289ec032ea 100644 --- a/docs/standard-library/function-objects-in-the-stl.md +++ b/docs/standard-library/function-objects-in-the-stl.md @@ -1,25 +1,24 @@ --- -description: "Learn more about: Function Objects in the C++ Standard Library" title: "Function Objects in the C++ Standard Library" -ms.date: "03/15/2019" +description: "Learn more about: Function Objects in the C++ Standard Library" +ms.date: 06/22/2025 helpviewer_keywords: ["functors", "C++ Standard Library, functors", "C++ Standard Library, function objects", "function objects"] -ms.assetid: 85f8a735-2c7b-4f10-9c4d-95c666ec4192 --- # Function Objects in the C++ Standard Library -A *function object*, or *functor*, is any type that implements operator(). This operator is referred to as the *call operator* or sometimes the *application operator*. The C++ Standard Library uses function objects primarily as sorting criteria for containers and in algorithms. +A *function object*, or *functor*, is any type that implements `operator()`. This operator is referred to as the *call operator* or sometimes the *application operator*. The C++ Standard Library uses function objects primarily as sorting criteria for containers and in algorithms. -Function objects provide two main advantages over a straight function call. The first is that a function object can contain state. The second is that a function object is a type and therefore can be used as a template parameter. +Function objects provide two main advantages over a regular function call. The first is that a function object can contain state. The second is that a function object is a type and therefore can be used as a template parameter. ## Creating a Function Object -To create a function object, create a type and implement operator(), such as: +To create a function object, create a type and implement `operator()`, such as: ```cpp -class Functor +class LessThanFunctor { public: - int operator()(int a, int b) + bool operator()(int a, int b) { return a < b; } @@ -27,42 +26,42 @@ public: int main() { - Functor f; + LessThanFunctor less_than; int a = 5; int b = 7; - int ans = f(a, b); + bool ans = less_than(a, b); } ``` -The last line of the `main` function shows how you call the function object. This call looks like a call to a function, but it's actually calling operator() of the Functor type. This similarity between calling a function object and a function is how the term function object came about. +The last line of the `main` function shows how you call the function object. This call looks like a call to a function, but it's actually calling `operator()` of the `LessThanFunctor` type. This similarity between calling a function object and a function is how the term function object came about. ## Function Objects and Containers -The C++ Standard Library contains several function objects in the [``](../standard-library/functional.md) header file. One use of these function objects is as a sorting criterion for containers. For example, the `set` container is declared as follows: +The C++ Standard Library contains several function objects in the [``](functional.md) header file. One use of these function objects is as a sorting criterion for containers. For example, the [`set`](set-class.md) container is declared as follows: ```cpp template , - class Allocator=allocator> -class set + class Compare = std::less, + class Allocator = std::allocator> +class set; ``` -The second template argument is the function object `less`. This function object returns **`true`** if the first parameter is less than the second parameter. Since some containers sort their elements, the container needs a way of comparing two elements. The comparison is done by using the function object. You can define your own sorting criteria for containers by creating a function object and specifying it in the template list for the container. +The second template argument is the function object [`less`](less-struct.md). This function object returns **`true`** if the first parameter is less than the second parameter. Since some containers sort their elements, the container needs a way of comparing two elements. The comparison is done by using the function object. You can define your own sorting criteria for containers by creating a function object and specifying it in the template list for the container. ## Function Objects and Algorithms -Another use of functional objects is in algorithms. For example, the `remove_if` algorithm is declared as follows: +Another use of function objects is in algorithms. For example, the [`remove_if`](algorithm-functions.md#remove_if) algorithm is declared as follows: ```cpp -template +template ForwardIterator remove_if( ForwardIterator first, ForwardIterator last, - Predicate pred); + UnaryPredicate pred); ``` -The last argument to `remove_if` is a function object that returns a boolean value (a *predicate*). If the result of the function object is **`true`**, then the element is removed from the container being accessed by the iterators `first` and `last`. You can use any of the function objects declared in the [``](../standard-library/functional.md) header for the argument `pred` or you can create your own. +The last argument to `remove_if` is a function object that returns a boolean value (a *predicate*). If the result of the function object is **`true`**, then the element is shifted such that it's beyond the new end returned by `remove_if`. You can use any of the function objects declared in the [``](functional.md) header for the argument `pred` or you can create your own. ## See also -[C++ Standard Library Reference](../standard-library/cpp-standard-library-reference.md) +[C++ Standard Library Reference](cpp-standard-library-reference.md) diff --git a/docs/standard-library/future-enums.md b/docs/standard-library/future-enums.md index 087f8291808..565311c0645 100644 --- a/docs/standard-library/future-enums.md +++ b/docs/standard-library/future-enums.md @@ -1,19 +1,16 @@ --- -description: "Learn more about: enums" title: " enums" -ms.date: "11/04/2016" +description: "Learn more about: enums" +ms.date: 11/04/2016 f1_keywords: ["future/std::future_errc", "future/std::future_status", "future/std::launch"] -ms.assetid: 8c675645-db47-4cab-bc0e-7b87f8a302df --- # `` enums -[future_errc](#future_errc)\ -[future_status](#future_status)\ -[launch](#launch) +The `` header provides the following enums: -## future_errc Enumeration +## `future_errc` enumeration -Supplies symbolic names for all of the errors that are reported by the [future_error](../standard-library/future-error-class.md) class. +Supplies symbolic names for all of the errors that are reported by the [`future_error`](../standard-library/future-error-class.md) class. ```cpp class future_errc { @@ -24,7 +21,7 @@ class future_errc { }; ``` -## future_status Enumeration +## `future_status` enumeration Supplies symbolic names for the reasons that a timed wait function can return. @@ -36,9 +33,9 @@ enum future_status{ }; ``` -## launch Enumeration +## `launch` enumeration -Represents a bitmask type that describes the possible modes for the template function [async](../standard-library/future-functions.md#async). +Represents a bitmask type that describes the possible modes for the template function [`async`](../standard-library/future-functions.md#async). ```cpp class launch{ @@ -49,4 +46,4 @@ class launch{ ## See also -[\](../standard-library/future.md) +[\](future.md) diff --git a/docs/standard-library/future-functions.md b/docs/standard-library/future-functions.md index 0608bf9ba7d..24e91bd0bff 100644 --- a/docs/standard-library/future-functions.md +++ b/docs/standard-library/future-functions.md @@ -1,17 +1,13 @@ --- -description: "Learn more about: functions" title: " functions" +description: "Learn more about: functions" ms.date: 09/11/2024 f1_keywords: ["future/std::async", "future/std::future_category", "future/std::make_error_code", "future/std::make_error_condition", "future/std::swap"] helpviewer_keywords: ["std::async [C++]", "std::future_category [C++]", "std::make_error_code [C++]", "std::make_error_condition [C++]", "std::swap [C++]"] --- # `` functions -[`async`](#async)\ -[`future_category`](#future_category)\ -[`make_error_code`](#make_error_code)\ -[`make_error_condition`](#make_error_condition)\ -[`swap`](#swap)| +The `` header provides the following functions: ## `async` diff --git a/docs/standard-library/gslice-array-class.md b/docs/standard-library/gslice-array-class.md index 727afddc3f6..22e90f11d0b 100644 --- a/docs/standard-library/gslice-array-class.md +++ b/docs/standard-library/gslice-array-class.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: gslice_array class" title: "gslice_array class" +description: "Learn more about: gslice_array class" ms.date: 01/12/2022 f1_keywords: ["valarray/std::gslice_array"] helpviewer_keywords: ["gslice_array class"] -ms.assetid: ad1b4514-b14a-4baf-a293-d5a8e8674c75 --- # `gslice_array` class @@ -42,7 +41,7 @@ public: void operator>>=(const valarray& x) const; // The rest is private or implementation defined -} +}; ``` ## Remarks diff --git a/docs/standard-library/hash-map-class.md b/docs/standard-library/hash-map-class.md index adb3a1e83e3..e7f121e5543 100644 --- a/docs/standard-library/hash-map-class.md +++ b/docs/standard-library/hash-map-class.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: hash_map Class" title: "hash_map Class" -ms.date: "11/04/2016" +description: "Learn more about: hash_map Class" +ms.date: 11/04/2016 f1_keywords: ["hash_map/stdext::hash_map", "hash_map/stdext::hash_map::allocator_type", "hash_map/stdext::hash_map::const_iterator", "hash_map/stdext::hash_map::const_pointer", "hash_map/stdext::hash_map::const_reference", "hash_map/stdext::hash_map::const_reverse_iterator", "hash_map/stdext::hash_map::difference_type", "hash_map/stdext::hash_map::iterator", "hash_map/stdext::hash_map::key_compare", "hash_map/stdext::hash_map::key_type", "hash_map/stdext::hash_map::mapped_type", "hash_map/stdext::hash_map::pointer", "hash_map/stdext::hash_map::reference", "hash_map/stdext::hash_map::reverse_iterator", "hash_map/stdext::hash_map::size_type", "hash_map/stdext::hash_map::value_type", "hash_map/stdext::hash_map::at", "hash_map/stdext::hash_map::begin", "hash_map/stdext::hash_map::cbegin", "hash_map/stdext::hash_map::cend", "hash_map/stdext::hash_map::clear", "hash_map/stdext::hash_map::count", "hash_map/stdext::hash_map::crbegin", "hash_map/stdext::hash_map::crend", "hash_map/stdext::hash_map::emplace", "hash_map/stdext::hash_map::emplace_hint", "hash_map/stdext::hash_map::empty", "hash_map/stdext::hash_map::end", "hash_map/stdext::hash_map::equal_range", "hash_map/stdext::hash_map::erase", "hash_map/stdext::hash_map::find", "hash_map/stdext::hash_map::get_allocator", "hash_map/stdext::hash_map::insert", "hash_map/stdext::hash_map::key_comp", "hash_map/stdext::hash_map::lower_bound", "hash_map/stdext::hash_map::max_size", "hash_map/stdext::hash_map::rbegin", "hash_map/stdext::hash_map::rend", "hash_map/stdext::hash_map::size", "hash_map/stdext::hash_map::swap", "hash_map/stdext::hash_map::upper_bound", "hash_map/stdext::hash_map::value_comp"] helpviewer_keywords: ["stdext::hash_map", "stdext::hash_map::allocator_type", "stdext::hash_map::const_iterator", "stdext::hash_map::const_pointer", "stdext::hash_map::const_reference", "stdext::hash_map::const_reverse_iterator", "stdext::hash_map::difference_type", "stdext::hash_map::iterator", "stdext::hash_map::key_compare", "stdext::hash_map::key_type", "stdext::hash_map::mapped_type", "stdext::hash_map::pointer", "stdext::hash_map::reference", "stdext::hash_map::reverse_iterator", "stdext::hash_map::size_type", "stdext::hash_map::value_type", "stdext::hash_map::at", "stdext::hash_map::begin", "stdext::hash_map::cbegin", "stdext::hash_map::cend", "stdext::hash_map::clear", "stdext::hash_map::count", "stdext::hash_map::crbegin", "stdext::hash_map::crend", "stdext::hash_map::emplace", "stdext::hash_map::emplace_hint", "stdext::hash_map::empty", "stdext::hash_map::end", "stdext::hash_map::equal_range", "stdext::hash_map::erase", "stdext::hash_map::find", "stdext::hash_map::get_allocator", "stdext::hash_map::insert", "stdext::hash_map::key_comp", "stdext::hash_map::lower_bound", "stdext::hash_map::max_size", "stdext::hash_map::rbegin", "stdext::hash_map::rend", "stdext::hash_map::size", "stdext::hash_map::swap", "stdext::hash_map::upper_bound", "stdext::hash_map::value_comp"] --- @@ -58,7 +58,7 @@ The choice of container type should be based in general on the type of searching The `hash_map` should be the associative container of choice when the conditions associating the values with their keys are satisfied by the application. A model for this type of structure is an ordered list of uniquely occurring keywords with associated string values providing, say, definitions. If, instead, the words had more than one correct definition, so that keys weren't unique, then a `hash_multimap` would be the container of choice. If, on the other hand, just the list of words were being stored, then a `hash_set` would be the correct container. If multiple occurrences of the words were allowed, then a `hash_multiset` would be the appropriate container structure. -The `hash_map` orders the sequence it controls by calling a stored hash *`Traits`* object of class [`value_compare`](../standard-library/value-compare-class.md). This stored object may be accessed by calling the member function [`key_comp`](#key_comp). Such a function object must behave the same as an object of class `hash_compare>`. Specifically, for all values *`Key`* of type *`Key`*, the call `Traits`( `Key` ) yields a distribution of values of type `size_t`. For more information, see [`hash_compare`](../standard-library/hash-compare-class.md). +The `hash_map` orders the sequence it controls by calling a stored hash *`Traits`* object of class [`value_compare`](../standard-library/value-compare-class.md). This stored object may be accessed by calling the member function [`key_comp`](#key_comp). Such a function object must behave the same as an object of class `hash_compare>`. Specifically, for all values *`Key`* of type *`Key`*, the call `Traits`(`Key`) yields a distribution of values of type `size_t`. For more information, see [`hash_compare`](../standard-library/hash-compare-class.md). In general, the elements need be merely less than comparable to establish this order: so that, given any two elements, it may be determined either that they're equivalent (in the sense that neither is less than the other) or that one is less than the other. This results in an ordering between the nonequivalent elements. On a more technical note, the comparison function is a binary predicate that induces a strict weak ordering in the standard mathematical sense. A binary predicate f(x y) is a function object that has two argument objects `x` and `y` and a return value of **`true`** or **`false`**. An ordering imposed on a `hash_map` is a strict weak ordering if the binary predicate is irreflexive, antisymmetric, and transitive and if equivalence is transitive, where two objects `x` and `y` are defined to be equivalent when both f(x, y) and f(y, x) are `false`. If the stronger condition of equality between keys replaces that of equivalence, then the ordering becomes total (in the sense that all the elements are ordered with respect to each other) and the keys matched will be indiscernible from each other. @@ -371,8 +371,6 @@ Erases all the elements of a `hash_map`. void clear(); ``` -### Remarks - ### Example The following example demonstrates the use of the `hash_map::clear` member function. @@ -463,8 +461,6 @@ A type that provides a reference to a **`const`** element stored in a `hash_map` typedef list::const_reference const_reference; ``` -### Remarks - ### Example ```cpp @@ -516,7 +512,7 @@ The data value of the first element in the hash_map is 10. A type that provides a bidirectional iterator that can read any **`const`** element in the `hash_map`. ```cpp -typedef list::const_reverse)iterator const_reverse_iterator; +typedef list::const_reverse_iterator const_reverse_iterator; ``` ### Remarks @@ -817,8 +813,8 @@ The [`hash_map::value_type`](#value_type) of an element is a pair, so that the v ```cpp // hash_map_emplace.cpp // compile with: /EHsc -#include -#include +#include +#include #include int main() @@ -878,8 +874,8 @@ Insertion can occur in amortized constant time, instead of logarithmic time, if ```cpp // hash_map_emplace_hint.cpp // compile with: /EHsc -#include -#include +#include +#include #include int main() @@ -917,8 +913,6 @@ bool empty() const; **`true`** if the `hash_map` is empty; **`false`** if the `hash_map` is nonempty. -### Remarks - ### Example ```cpp @@ -1048,8 +1042,6 @@ A pair of iterators such that the first is the [`lower_bound`](#lower_bound) of To access the first iterator of a pair `pr` returned by the member function, use `pr.first` and to dereference the lower bound iterator, use `*(pr.first)`. To access the second iterator of a pair `pr` returned by the member function, use `pr.second` and to dereference the upper bound iterator, use `*(pr.second)`. -### Remarks - ### Example ```cpp @@ -1526,7 +1518,7 @@ The position just beyond the last element to be copied from a `hash_map`. The first `insert` member function returns a pair whose `bool` component returns `true` if an insertion was made and `false` if the `hash_map` already contained an element whose key had an equivalent value in the ordering, and whose iterator component returns the address where a new element was inserted or where the element was already located. -To access the iterator component of a pair `pr` returned by this member function, use `pr.first`, and to dereference it, use `(pr.first)`. To access the **`bool`** component of a pair `pr` returned by this member function, use `pr.second`, and to dereference it, use `\(pr.second)`. +To access the iterator component of a pair `pr` returned by this member function, use `pr.first`, and to dereference it, use `(pr.first)`. To access the **`bool`** component of a pair `pr` returned by this member function, use `pr.second`, and to dereference it, use `(pr.second)`. The second `insert` member function, the hint version, returns an iterator that points to the position where the new element was inserted into the `hash_map`. @@ -1545,8 +1537,8 @@ The third member function inserts the sequence of element values into a `hash_ma ```cpp // hash_map_insert.cpp // compile with: /EHsc -#include -#include +#include +#include #include int main() @@ -1815,8 +1807,6 @@ An [`iterator`](#iterator) or [`const_iterator`](#const_iterator) that addresses If the return value of `lower_bound` is assigned to a `const_iterator`, the `hash_map` object can't be modified. If the return value of `lower_bound` is assigned to a `iterator`, the `hash_map` object can be modified. -### Remarks - ### Example ```cpp @@ -1904,8 +1894,6 @@ size_type max_size() const; The maximum possible length of the `hash_map`. -### Remarks - ### Example ```cpp @@ -2196,8 +2184,6 @@ A type that provides a reference to an element stored in a `hash_map`. typedef list::reference reference; ``` -### Remarks - ### Example ```cpp @@ -2378,8 +2364,6 @@ size_type size() const; The current length of the `hash_map`. -### Remarks - ### Example The following example demonstrates the use of the `hash_map::size` member function. @@ -2424,8 +2408,6 @@ An unsigned integer type that can represent the number of elements in a `hash_ma typedef list::size_type size_type; ``` -### Remarks - ### Example See example for [`size`](#size) for an example of how to declare and use `size_type` @@ -2528,8 +2510,6 @@ An [`iterator`](#iterator) or [`const_iterator`](#const_iterator) that addresses If the return value is assigned to a `const_iterator`, the `hash_map` object can't be modified. If the return value is assigned to an `iterator`, the `hash_map` object can be modified. -### Remarks - ### Example ```cpp diff --git a/docs/standard-library/hash-map-functions.md b/docs/standard-library/hash-map-functions.md index 8cfca3016b1..023610dd7e4 100644 --- a/docs/standard-library/hash-map-functions.md +++ b/docs/standard-library/hash-map-functions.md @@ -1,16 +1,14 @@ --- -description: "Learn more about: functions" title: " functions" -ms.date: "11/04/2016" +description: "Learn more about: functions" +ms.date: 11/04/2016 f1_keywords: ["hash_map/std::swap", "hash_map/std::swap (hash_map)"] -ms.assetid: 28748cd0-71f7-41b9-b068-579183645fba --- # `` functions -[swap](#swap)\ -[swap (hash_map)](#swap_hash_map) +The `` header provides the following functions: -## swap (hash_map) +## `swap` (`hash_map`) > [!NOTE] > This API is obsolete. The alternative is [unordered_map Class](../standard-library/unordered-map-class.md). @@ -19,23 +17,23 @@ Exchanges the elements of two hash_maps. ```cpp void swap( - hash_map & left, + hash_map & left, hash_map & right); ``` ### Parameters -*right*\ -The hash_map whose elements are to be exchanged with those of the map *left*. +*`right`*\ +The hash_map whose elements are to be exchanged with those of the map *`left`*. -*left*\ -The hash_map whose elements are to be exchanged with those of the map *right*. +*`left`*\ +The hash_map whose elements are to be exchanged with those of the map *`right`*. ### Remarks -The template function is an algorithm specialized on the container class hash_map to execute the member function `left.`[swap](../standard-library/basic-ios-class.md#swap)*(right*). This is an instance of the partial ordering of function templates by the compiler. When template functions are overloaded in such a way that the match of the template with the function call is not unique, then the compiler will select the most specialized version of the template function. The general version of the template function, **template \ void swap(T&, T&)**, in the algorithm header file works by assignment and is a slow operation. The specialized version in each container is much faster as it can work with the internal representation of the container class. +The template function is an algorithm specialized on the container class hash_map to execute the member function `left.`[`swap`](../standard-library/basic-ios-class.md#swap)(`right`). This is an instance of the partial ordering of function templates by the compiler. When template functions are overloaded in such a way that the match of the template with the function call is not unique, then the compiler will select the most specialized version of the template function. The general version of the template function, **`template void swap(T&, T&)`**, in the algorithm header file works by assignment and is a slow operation. The specialized version in each container is much faster as it can work with the internal representation of the container class. -## swap +## `swap` > [!NOTE] > This API is obsolete. The alternative is [unordered_multimap Class](../standard-library/unordered-multimap-class.md). @@ -44,22 +42,22 @@ Exchanges the elements of two hash_multimaps. ```cpp void swap( - hash_multimap & left, + hash_multimap & left, hash_multimap & right); ``` ### Parameters -*right*\ -The hash_multimap whose elements are to be exchanged with those of the map *left*. +*`right`*\ +The `hash_multimap` whose elements are to be exchanged with those of the map *`left`*. -*left*\ -The hash_multimap whose elements are to be exchanged with those of the map *right*. +*`left`*\ +The `hash_multimap` whose elements are to be exchanged with those of the map *`right`*. ### Remarks -The template function is an algorithm specialized on the container class hash_multimap to execute the member function `left.`[swap](../standard-library/hash-multimap-class.md#swap)*(right*`)`. This is an instance of the partial ordering of function templates by the compiler. When template functions are overloaded in such a way that the match of the template with the function call is not unique, then the compiler will select the most specialized version of the template function. The general version of the template function, **template \ void swap(T&, T&)**, in the algorithm header file works by assignment and is a slow operation. The specialized version in each container is much faster as it can work with the internal representation of the container class. +The template function is an algorithm specialized on the container class hash_multimap to execute the member function `left.`[`swap`](../standard-library/hash-multimap-class.md#swap)(`right`). This is an instance of the partial ordering of function templates by the compiler. When template functions are overloaded in such a way that the match of the template with the function call is not unique, then the compiler will select the most specialized version of the template function. The general version of the template function, **`template void swap(T&, T&)`**, in the algorithm header file works by assignment and is a slow operation. The specialized version in each container is much faster as it can work with the internal representation of the container class. ## See also -[](../standard-library/hash-map.md) +[``](../standard-library/hash-map.md) diff --git a/docs/standard-library/hash-map-operators.md b/docs/standard-library/hash-map-operators.md index 4367ddecbe4..e3da8726961 100644 --- a/docs/standard-library/hash-map-operators.md +++ b/docs/standard-library/hash-map-operators.md @@ -1,16 +1,12 @@ --- -description: "Learn more about: operators" title: " operators" -ms.date: "11/04/2016" +description: "Learn more about: operators" +ms.date: 11/04/2016 f1_keywords: ["hash_map/std::operator!=", "hash_map/std::operator=="] -ms.assetid: 24b9bb9e-e983-4060-bce5-2c7c8161ee61 --- # `` operators -[operator!=](#op_neq)\ -[operator!= (multimap)](#op_neq_mm)\ -[operator==](#op_eq_eq)\ -[operator== (multimap)](#op_eq_eq_mm) +The `` header provides the following operators: ## operator!= @@ -215,7 +211,7 @@ The hash_multimaps hm1 and hm2 are not equal. The hash_multimaps hm1 and hm3 are equal. ``` -## operator== (hash_multimap) +## operator== (hash_multimap) > [!NOTE] > This API is obsolete. The alternative is [unordered_multimap Class](unordered-multimap-class.md). diff --git a/docs/standard-library/hash-multimap-class.md b/docs/standard-library/hash-multimap-class.md index ca2f5e5b1f1..eaa3fad497d 100644 --- a/docs/standard-library/hash-multimap-class.md +++ b/docs/standard-library/hash-multimap-class.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: hash_multimap Class" title: "hash_multimap Class" -ms.date: "10/18/2018" +description: "Learn more about: hash_multimap Class" +ms.date: 10/18/2018 f1_keywords: ["hash_map/stdext::hash_multimap", "hash_map/stdext::hash_multimap::allocator_type", "hash_map/stdext::hash_multimap::const_iterator", "hash_map/stdext::hash_multimap::const_pointer", "hash_map/stdext::hash_multimap::const_reference", "hash_map/stdext::hash_multimap::const_reverse_iterator", "hash_map/stdext::hash_multimap::difference_type", "hash_map/stdext::hash_multimap::iterator", "hash_map/stdext::hash_multimap::key_compare", "hash_map/stdext::hash_multimap::key_type", "hash_map/stdext::hash_multimap::mapped_type", "hash_map/stdext::hash_multimap::pointer", "hash_map/stdext::hash_multimap::reference", "hash_map/stdext::hash_multimap::reverse_iterator", "hash_map/stdext::hash_multimap::size_type", "hash_map/stdext::hash_multimap::value_type", "hash_map/stdext::hash_multimap::begin", "hash_map/stdext::hash_multimap::cbegin", "hash_map/stdext::hash_multimap::cend", "hash_map/stdext::hash_multimap::clear", "hash_map/stdext::hash_multimap::count", "hash_map/stdext::hash_multimap::crbegin", "hash_map/stdext::hash_multimap::crend", "hash_map/stdext::hash_multimap::emplace", "hash_map/stdext::hash_multimap::emplace_hint", "hash_map/stdext::hash_multimap::empty", "hash_map/stdext::hash_multimap::end", "hash_map/stdext::hash_multimap::equal_range", "hash_map/stdext::hash_multimap::erase", "hash_map/stdext::hash_multimap::find", "hash_map/stdext::hash_multimap::get_allocator", "hash_map/stdext::hash_multimap::insert", "hash_map/stdext::hash_multimap::key_comp", "hash_map/stdext::hash_multimap::lower_bound", "hash_map/stdext::hash_multimap::max_size", "hash_map/stdext::hash_multimap::rbegin", "hash_map/stdext::hash_multimap::rend", "hash_map/stdext::hash_multimap::size", "hash_map/stdext::hash_multimap::swap", "hash_map/stdext::hash_multimap::upper_bound", "hash_map/stdext::hash_multimap::value_comp"] helpviewer_keywords: ["stdext::hash_multimap", "stdext::hash_multimap::allocator_type", "stdext::hash_multimap::const_iterator", "stdext::hash_multimap::const_pointer", "stdext::hash_multimap::const_reference", "stdext::hash_multimap::const_reverse_iterator", "stdext::hash_multimap::difference_type", "stdext::hash_multimap::iterator", "stdext::hash_multimap::key_compare", "stdext::hash_multimap::key_type", "stdext::hash_multimap::mapped_type", "stdext::hash_multimap::pointer", "stdext::hash_multimap::reference", "stdext::hash_multimap::reverse_iterator", "stdext::hash_multimap::size_type", "stdext::hash_multimap::value_type", "stdext::hash_multimap::begin", "stdext::hash_multimap::cbegin", "stdext::hash_multimap::cend", "stdext::hash_multimap::clear", "stdext::hash_multimap::count", "stdext::hash_multimap::crbegin", "stdext::hash_multimap::crend", "stdext::hash_multimap::emplace", "stdext::hash_multimap::emplace_hint", "stdext::hash_multimap::empty", "stdext::hash_multimap::end", "stdext::hash_multimap::equal_range", "stdext::hash_multimap::erase", "stdext::hash_multimap::find", "stdext::hash_multimap::get_allocator", "stdext::hash_multimap::insert", "stdext::hash_multimap::key_comp", "stdext::hash_multimap::lower_bound", "stdext::hash_multimap::max_size", "stdext::hash_multimap::rbegin", "stdext::hash_multimap::rend", "stdext::hash_multimap::size", "stdext::hash_multimap::swap", "stdext::hash_multimap::upper_bound", "stdext::hash_multimap::value_comp"] -ms.assetid: f41a6db9-67aa-43a3-a3c5-dbfe9ec3ae7d --- # hash_multimap Class @@ -327,8 +326,6 @@ Erases all the elements of a hash_multimap. void clear(); ``` -### Remarks - ### Example The following example demonstrates the use of the hash_multimap::clear member function. @@ -419,8 +416,6 @@ A type that provides a reference to a **`const`** element stored in a hash_multi typedef list::const_reference const_reference; ``` -### Remarks - ### Example ```cpp @@ -776,8 +771,8 @@ The [hash_multimap::value_type](#value_type) of an element is a pair, so that th ```cpp // hash_multimap_emplace.cpp // compile with: /EHsc -#include -#include +#include +#include #include int main() @@ -837,8 +832,8 @@ Insertion can occur in amortized constant time, instead of logarithmic time, if ```cpp // hash_multimap_emplace_hint.cpp // compile with: /EHsc -#include -#include +#include +#include #include int main() @@ -876,8 +871,6 @@ bool empty() const; **`true`** if the hash_multimap is empty; **`false`** if the hash_multimap is nonempty. -### Remarks - ### Example ```cpp @@ -1005,9 +998,7 @@ The argument key to be compared with the sort key of an element from the hash_mu A pair of iterators such that the first is the [lower_bound](#lower_bound) of the key and the second is the [upper_bound](#upper_bound) of the key. -To access the first iterator of a pair `pr` returned by the member function, use `pr`. **first** and to dereference the lower bound iterator, use \*( `pr`. **first**). To access the second iterator of a pair `pr` returned by the member function, use `pr`. **second** and to dereference the upper bound iterator, use \*( `pr`. **second**). - -### Remarks +To access the first iterator of a pair `pr` returned by the member function, use `pr`. **first** and to dereference the lower bound iterator, use \*(`pr`. **first**). To access the second iterator of a pair `pr` returned by the member function, use `pr`. **second** and to dereference the upper bound iterator, use \*(`pr`. **second**). ### Example @@ -1686,8 +1677,6 @@ An [iterator](#iterator) or [const_iterator](#const_iterator) that addresses the If the return value of `lower_bound` is assigned to a `const_iterator`, the hash_multimap object cannot be modified. If the return value of `lower_bound` is assigned to an `iterator`, the hash_multimap object can be modified. -### Remarks - ### Example ```cpp @@ -1793,8 +1782,6 @@ size_type max_size() const; The maximum possible length of the hash_multimap. -### Remarks - ### Example ```cpp @@ -1989,8 +1976,6 @@ A type that provides a reference to an element stored in a hash_multimap. typedef list::reference reference; ``` -### Remarks - ### Example ```cpp @@ -2165,8 +2150,6 @@ size_type size() const; The current length of the hash_multimap. -### Remarks - ### Example The following example demonstrates the use of the hash_multimap::size member function. @@ -2211,8 +2194,6 @@ An unsigned integer type that counts the number of elements in a hash_multimap. typedef list::size_type size_type; ``` -### Remarks - ### Example See the example for [size](#size) for an example of how to declare and use `size_type` @@ -2313,8 +2294,6 @@ An [iterator](#iterator) or [const_iterator](#const_iterator) that addresses the If the return value of `upper_bound` is assigned to a `const_iterator`, the hash_multimap object cannot be modified. If the return value of `upper_bound` is assigned to a `iterator`, the hash_multimap object can be modified. -### Remarks - ### Example ```cpp diff --git a/docs/standard-library/hash-multiset-class.md b/docs/standard-library/hash-multiset-class.md index 4c18f9e9e58..8be4252e168 100644 --- a/docs/standard-library/hash-multiset-class.md +++ b/docs/standard-library/hash-multiset-class.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: hash_multiset Class" title: "hash_multiset Class" -ms.date: "11/04/2016" +description: "Learn more about: hash_multiset Class" +ms.date: 11/04/2016 f1_keywords: ["hash_set/stdext::hash_multiset", "hash_set/stdext::hash_multiset::allocator_type", "hash_set/stdext::hash_multiset::const_iterator", "hash_set/stdext::hash_multiset::const_pointer", "hash_set/stdext::hash_multiset::const_reference", "hash_set/stdext::hash_multiset::const_reverse_iterator", "hash_set/stdext::hash_multiset::difference_type", "hash_set/stdext::hash_multiset::iterator", "hash_set/stdext::hash_multiset::key_compare", "hash_set/stdext::hash_multiset::key_type", "hash_set/stdext::hash_multiset::pointer", "hash_set/stdext::hash_multiset::reference", "hash_set/stdext::hash_multiset::reverse_iterator", "hash_set/stdext::hash_multiset::size_type", "hash_set/stdext::hash_multiset::value_compare", "hash_set/stdext::hash_multiset::value_type", "hash_set/stdext::hash_multiset::begin", "hash_set/stdext::hash_multiset::cbegin", "hash_set/stdext::hash_multiset::cend", "hash_set/stdext::hash_multiset::clear", "hash_set/stdext::hash_multiset::count", "hash_set/stdext::hash_multiset::crbegin", "hash_set/stdext::hash_multiset::crend", "hash_set/stdext::hash_multiset::emplace", "hash_set/stdext::hash_multiset::emplace_hint", "hash_set/stdext::hash_multiset::empty", "hash_set/stdext::hash_multiset::end", "hash_set/stdext::hash_multiset::equal_range", "hash_set/stdext::hash_multiset::erase", "hash_set/stdext::hash_multiset::find", "hash_set/stdext::hash_multiset::get_allocator", "hash_set/stdext::hash_multiset::insert", "hash_set/stdext::hash_multiset::key_comp", "hash_set/stdext::hash_multiset::lower_bound", "hash_set/stdext::hash_multiset::max_size", "hash_set/stdext::hash_multiset::rbegin", "hash_set/stdext::hash_multiset::rend", "hash_set/stdext::hash_multiset::size", "hash_set/stdext::hash_multiset::swap", "hash_set/stdext::hash_multiset::upper_bound", "hash_set/stdext::hash_multiset::value_comp"] helpviewer_keywords: ["stdext::hash_multiset", "stdext::hash_multiset::allocator_type", "stdext::hash_multiset::const_iterator", "stdext::hash_multiset::const_pointer", "stdext::hash_multiset::const_reference", "stdext::hash_multiset::const_reverse_iterator", "stdext::hash_multiset::difference_type", "stdext::hash_multiset::iterator", "stdext::hash_multiset::key_compare", "stdext::hash_multiset::key_type", "stdext::hash_multiset::pointer", "stdext::hash_multiset::reference", "stdext::hash_multiset::reverse_iterator", "stdext::hash_multiset::size_type", "stdext::hash_multiset::value_compare", "stdext::hash_multiset::value_type", "stdext::hash_multiset::begin", "stdext::hash_multiset::cbegin", "stdext::hash_multiset::cend", "stdext::hash_multiset::clear", "stdext::hash_multiset::count", "stdext::hash_multiset::crbegin", "stdext::hash_multiset::crend", "stdext::hash_multiset::emplace", "stdext::hash_multiset::emplace_hint", "stdext::hash_multiset::empty", "stdext::hash_multiset::end", "stdext::hash_multiset::equal_range", "stdext::hash_multiset::erase", "stdext::hash_multiset::find", "stdext::hash_multiset::get_allocator", "stdext::hash_multiset::insert", "stdext::hash_multiset::key_comp", "stdext::hash_multiset::lower_bound", "stdext::hash_multiset::max_size", "stdext::hash_multiset::rbegin", "stdext::hash_multiset::rend", "stdext::hash_multiset::size", "stdext::hash_multiset::swap", "stdext::hash_multiset::upper_bound", "stdext::hash_multiset::value_comp"] -ms.assetid: 0580397a-a76e-40ad-aea2-5c6f3a9d0a21 --- # hash_multiset Class @@ -309,8 +308,6 @@ Erases all the elements of a hash_multiset. void clear(); ``` -### Remarks - ### Example ```cpp @@ -389,8 +386,6 @@ A type that provides a reference to a **`const`** element stored in a hash_multi typedef list::const_reference const_reference; ``` -### Remarks - ### Example ```cpp @@ -713,8 +708,6 @@ The value of an element to be inserted into the [hash_multiset](../standard-libr The `emplace` member function returns an iterator that points to the position where the new element was inserted. -### Remarks - ### Example ```cpp @@ -812,8 +805,6 @@ bool empty() const; **`true`** if the hash_multiset is empty; **`false`** if the hash_multiset is nonempty. -### Remarks - ### Example ```cpp @@ -931,7 +922,7 @@ The argument key to be compared with the sort key of an element from the hash_mu A pair of iterators where the first is the [lower_bound](#lower_bound) of the key and the second is the [upper_bound](#upper_bound) of the key. -To access the first iterator of a pair `pr` returned by the member function, use `pr`. **first** and to dereference the lower bound iterator, use \*( `pr`. **first**). To access the second iterator of a pair `pr` returned by the member function, use `pr`. **second** and to dereference the upper bound iterator, use \*( `pr`. **second**). +To access the first iterator of a pair `pr` returned by the member function, use `pr`. **first** and to dereference the lower bound iterator, use \*(`pr`. **first**). To access the second iterator of a pair `pr` returned by the member function, use `pr`. **second** and to dereference the upper bound iterator, use \*(`pr`. **second**). ### Example @@ -1295,11 +1286,11 @@ hash_multiset( hash_multiset( hash_multiset&& Right -}; +); hash_multiset (initializer_list IList); hash_multiset( - initializer_list IList, const Compare& Comp): + initializer_list IList, const Compare& Comp): hash_multiset( initializer_list IList, const Compare& Comp, const Allocator& Al); @@ -1592,8 +1583,6 @@ The argument key to be compared with the sort key of an element from the hash_mu An [iterator](#iterator) or [const_iterator](#const_iterator) that addresses the location of the first element in a hash_multiset with a key that is equal to or greater than the argument key, or that addresses the location succeeding the last element in the hash_multiset if no match is found for the key. -### Remarks - ### Example ```cpp @@ -1652,8 +1641,6 @@ size_type max_size() const; The maximum possible length of the hash_multiset. -### Remarks - ### Example ```cpp @@ -1846,8 +1833,6 @@ A type that provides a reference to an element stored in a hash_multiset. typedef list::reference reference; ``` -### Remarks - ### Example ```cpp @@ -2005,8 +1990,6 @@ size_type size() const; The current length of the hash_multiset. -### Remarks - ### Example ```cpp @@ -2048,8 +2031,6 @@ An unsigned integer type that can represent the number of elements in a hash_mul typedef list::size_type size_type; ``` -### Remarks - ### Example See example for [size](#size) for an example of how to declare and use `size_type` @@ -2150,8 +2131,6 @@ The argument key to be compared with the sort key of an element from the hash_mu An [iterator](#iterator) or [const_iterator](#const_iterator) that addresses the location of the first element in a hash_multiset with a key greater than the argument key, or that addresses the location succeeding the last element in the hash_multiset if no match is found for the key. -### Remarks - ### Example ```cpp diff --git a/docs/standard-library/hash-set-class.md b/docs/standard-library/hash-set-class.md index 703cd2f9c44..642b9a71996 100644 --- a/docs/standard-library/hash-set-class.md +++ b/docs/standard-library/hash-set-class.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: hash_set Class" title: "hash_set Class" -ms.date: "11/04/2016" +description: "Learn more about: hash_set Class" +ms.date: 11/04/2016 f1_keywords: ["hash_set/stdext::hash_set", "hash_set/stdext::hash_set::allocator_type", "hash_set/stdext::hash_set::const_iterator", "hash_set/stdext::hash_set::const_pointer", "hash_set/stdext::hash_set::const_reference", "hash_set/stdext::hash_set::const_reverse_iterator", "hash_set/stdext::hash_set::difference_type", "hash_set/stdext::hash_set::iterator", "hash_set/stdext::hash_set::key_compare", "hash_set/stdext::hash_set::key_type", "hash_set/stdext::hash_set::pointer", "hash_set/stdext::hash_set::reference", "hash_set/stdext::hash_set::reverse_iterator", "hash_set/stdext::hash_set::size_type", "hash_set/stdext::hash_set::value_compare", "hash_set/stdext::hash_set::value_type", "hash_set/stdext::hash_set::begin", "hash_set/stdext::hash_set::cbegin", "hash_set/stdext::hash_set::cend", "hash_set/stdext::hash_set::clear", "hash_set/stdext::hash_set::count", "hash_set/stdext::hash_set::crbegin", "hash_set/stdext::hash_set::crend", "hash_set/stdext::hash_set::emplace", "hash_set/stdext::hash_set::emplace_hint", "hash_set/stdext::hash_set::empty", "hash_set/stdext::hash_set::end", "hash_set/stdext::hash_set::equal_range", "hash_set/stdext::hash_set::erase", "hash_set/stdext::hash_set::find", "hash_set/stdext::hash_set::get_allocator", "hash_set/stdext::hash_set::insert", "hash_set/stdext::hash_set::key_comp", "hash_set/stdext::hash_set::lower_bound", "hash_set/stdext::hash_set::max_size", "hash_set/stdext::hash_set::rbegin", "hash_set/stdext::hash_set::rend", "hash_set/stdext::hash_set::size", "hash_set/stdext::hash_set::swap", "hash_set/stdext::hash_set::upper_bound", "hash_set/stdext::hash_set::value_comp"] helpviewer_keywords: ["stdext::hash_set", "stdext::hash_set::allocator_type", "stdext::hash_set::const_iterator", "stdext::hash_set::const_pointer", "stdext::hash_set::const_reference", "stdext::hash_set::const_reverse_iterator", "stdext::hash_set::difference_type", "stdext::hash_set::iterator", "stdext::hash_set::key_compare", "stdext::hash_set::key_type", "stdext::hash_set::pointer", "stdext::hash_set::reference", "stdext::hash_set::reverse_iterator", "stdext::hash_set::size_type", "stdext::hash_set::value_compare", "stdext::hash_set::value_type", "stdext::hash_set::begin", "stdext::hash_set::cbegin", "stdext::hash_set::cend", "stdext::hash_set::clear", "stdext::hash_set::count", "stdext::hash_set::crbegin", "stdext::hash_set::crend", "stdext::hash_set::emplace", "stdext::hash_set::emplace_hint", "stdext::hash_set::empty", "stdext::hash_set::end", "stdext::hash_set::equal_range", "stdext::hash_set::erase", "stdext::hash_set::find", "stdext::hash_set::get_allocator", "stdext::hash_set::insert", "stdext::hash_set::key_comp", "stdext::hash_set::lower_bound", "stdext::hash_set::max_size", "stdext::hash_set::rbegin", "stdext::hash_set::rend", "stdext::hash_set::size", "stdext::hash_set::swap", "stdext::hash_set::upper_bound", "stdext::hash_set::value_comp"] -ms.assetid: c765c06e-cbb6-48c2-93ca-d15468eb28d7 --- # hash_set Class @@ -317,8 +316,6 @@ Erases all the elements of a hash_set. void clear(); ``` -### Remarks - ### Example ```cpp @@ -397,8 +394,6 @@ A type that provides a reference to a **`const`** element stored in a hash_set f typedef list::const_reference const_reference; ``` -### Remarks - ### Example ```cpp @@ -721,8 +716,6 @@ The value of an element to be inserted into the [hash_set](../standard-library/h The `emplace` member function returns a pair whose **`bool`** component returns **`true`** if an insertion was make and **`false`** if the `hash_set` already contained an element whose key had an equivalent value in the ordering, and whose iterator component returns the address where a new element was inserted or where the element was already located. -### Remarks - ### Example ```cpp @@ -820,8 +813,6 @@ bool empty() const; **`true`** if the hash_set is empty; **`false`** if the hash_set is nonempty. -### Remarks - ### Example ```cpp @@ -939,9 +930,7 @@ The argument key to be compared with the sort key of an element from the hash_se A pair of iterators where the first is the [lower_bound](../standard-library/set-class.md#lower_bound) of the key and the second is the [upper_bound](../standard-library/set-class.md#upper_bound) of the key. -To access the first iterator of a pair pr returned by the member function, use `pr`. **first**, and to dereference the lower bound iterator, use \*( `pr`. **first**). To access the second iterator of a pair `pr` returned by the member function, use `pr`. **second**, and to dereference the upper bound iterator, use \*( `pr`. **second**). - -### Remarks +To access the first iterator of a pair pr returned by the member function, use `pr`. **first**, and to dereference the lower bound iterator, use \*(`pr`. **first**). To access the second iterator of a pair `pr` returned by the member function, use `pr`. **second**, and to dereference the upper bound iterator, use \*(`pr`. **second**). ### Example @@ -1355,7 +1344,7 @@ All constructors initialize their hash_sets. All constructors store a function object of type `Traits` that is used to establish an order among the keys of the `hash_set` and that can later be returned by calling [hash_set::key_comp](#key_comp). For more information on `Traits` see the [hash_set Class](../standard-library/hash-set-class.md) topic. -The first constructor creates an empty initial `hash_set` The second specifies the type of comparison function ( `Comp`) to be used in establishing the order of the elements, and the third explicitly specifies the allocator type ( `Al`) to be used. The key word **`explicit`** suppresses certain kinds of automatic type conversion. +The first constructor creates an empty initial `hash_set` The second specifies the type of comparison function (`Comp`) to be used in establishing the order of the elements, and the third explicitly specifies the allocator type (`Al`) to be used. The key word **`explicit`** suppresses certain kinds of automatic type conversion. The fourth and fifth constructors specify a copy of the `hash_set` `Right`. @@ -1584,8 +1573,6 @@ The argument key to be compared with the sort key of an element from the hash_se An `iterator` or `const_iterator` that addresses the location of an element in a hash_set that with a key that is equal to or greater than the argument key or that addresses the location succeeding the last element in the hash_set if no match is found for the key. -### Remarks - ### Example ```cpp @@ -1651,8 +1638,6 @@ size_type max_size() const; The maximum possible length of the hash_set. -### Remarks - ### Example ```cpp @@ -1845,8 +1830,6 @@ A type that provides a reference to an element stored in a hash_set. typedef list::reference reference; ``` -### Remarks - ### Example ```cpp @@ -2004,8 +1987,6 @@ size_type size() const; The current length of the hash_set. -### Remarks - ### Example ```cpp @@ -2047,8 +2028,6 @@ An unsigned integer type that can represent the number of elements in a hash_set typedef list::size_type size_type; ``` -### Remarks - ### Example See the example for [size](#size) for an example of how to declare and use `size_type` @@ -2149,8 +2128,6 @@ The argument key to be compared with the sort key of an element from the hash_se An `iterator` or `const_iterator` that addresses the location of an element in a hash_set that with a key that is equal to or greater than the argument key, or that addresses the location succeeding the last element in the hash_set if no match is found for the key. -### Remarks - ### Example ```cpp diff --git a/docs/standard-library/hash-set-functions.md b/docs/standard-library/hash-set-functions.md index 2dd96536c7b..43faa5b3061 100644 --- a/docs/standard-library/hash-set-functions.md +++ b/docs/standard-library/hash-set-functions.md @@ -1,14 +1,12 @@ --- -description: "Learn more about: functions" title: " functions" -ms.date: "11/04/2016" +description: "Learn more about: functions" +ms.date: 11/04/2016 f1_keywords: ["hash_set/std::swap", "hash_set/std::swap (hash_multiset)"] -ms.assetid: 557a0162-3728-4537-97dc-f9f6cc7ece94 --- # `` functions -[swap](#swap)\ -[swap (hash_multiset)](#swap_hash_multiset) +The `` header provides the following functions: ## swap diff --git a/docs/standard-library/hash-set-operators.md b/docs/standard-library/hash-set-operators.md index dc6d86cb066..3ed14584a27 100644 --- a/docs/standard-library/hash-set-operators.md +++ b/docs/standard-library/hash-set-operators.md @@ -1,16 +1,12 @@ --- -description: "Learn more about: operators" title: " operators" -ms.date: "03/27/2019" +description: "Learn more about: operators" +ms.date: 03/27/2019 f1_keywords: ["hash_set/std::operator!=", "hash_set/std::operator=="] -ms.assetid: 403d8e4e-0b3f-43fb-bc5a-8100c4f331c5 --- # `` operators -[operator!=](#op_neq)\ -[operator!= (hash_multiset)](#op_neq_hash_multiset)\ -[operator==](#op_eq_eq)\ -[operator== (hash_multiset)](#op_eq_eq_hash_multiset) +The `` header provides the following operators: ## operator!= diff --git a/docs/standard-library/hash-set.md b/docs/standard-library/hash-set.md index 9f11c054220..e0581915841 100644 --- a/docs/standard-library/hash-set.md +++ b/docs/standard-library/hash-set.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: " title: "" -ms.date: "11/04/2016" +description: "Learn more about: " +ms.date: 11/04/2016 f1_keywords: [""] helpviewer_keywords: ["hash_set header"] -ms.assetid: 6b556967-c808-4869-9b4d-f9e030864435 --- # `` @@ -19,8 +18,6 @@ Defines the container class templates hash_set and hash_multiset and their suppo #include ``` -## Remarks - ### Operators |Hash_set version|Hash_multiset version|Description| diff --git a/docs/standard-library/high-resolution-clock-struct.md b/docs/standard-library/high-resolution-clock-struct.md index 702f8d536f8..070d29c7327 100644 --- a/docs/standard-library/high-resolution-clock-struct.md +++ b/docs/standard-library/high-resolution-clock-struct.md @@ -1,10 +1,10 @@ --- -description: "Learn more about: high_resolution_clock struct" title: high_resolution_clock struct +description: "Learn more about: high_resolution_clock struct" ms.custom: "" ms.date: 08/19/2021 ms.topic: "reference" -f1_keywords: ["chrono/std::chrono::high_resolution_clock", chrono/std::chrono::high_resolution_clock::now", "chrono/std::chrono::high_resolution_clock::is_steady constant"] +f1_keywords: ["chrono/std::chrono::high_resolution_clock", "chrono/std::chrono::high_resolution_clock::now", "chrono/std::chrono::high_resolution_clock::is_steady constant"] helpviewer_keywords: ["std::chrono [C++], high_resolution_clock"] dev_langs: ["C++"] author: "tylermsft" diff --git a/docs/standard-library/indirect-array-class.md b/docs/standard-library/indirect-array-class.md index 90054b40f03..8b49ff5f8fe 100644 --- a/docs/standard-library/indirect-array-class.md +++ b/docs/standard-library/indirect-array-class.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: indirect_array class" title: "indirect_array class" +description: "Learn more about: indirect_array class" ms.date: 01/12/2022 f1_keywords: ["valarray/std::indirect_array"] helpviewer_keywords: ["indirect_array class"] -ms.assetid: 10e1eaea-ba5a-405c-a25e-7bdd3eee7fc7 --- # `indirect_array` class @@ -20,7 +19,7 @@ You construct an `indirect_array` object only by writing an expression of The sequence consists of [`xa.size`](../standard-library/valarray-class.md#size) elements, where element `I` becomes the index `xa[I]` within `va`. -## Example: +## Example ```cpp // indirect_array.cpp diff --git a/docs/standard-library/insert-iterator-class.md b/docs/standard-library/insert-iterator-class.md index 73196c26377..591880c48df 100644 --- a/docs/standard-library/insert-iterator-class.md +++ b/docs/standard-library/insert-iterator-class.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: insert_iterator Class" title: "insert_iterator Class" +description: "Learn more about: insert_iterator Class" ms.date: 06/15/2022 f1_keywords: ["iterator/std::insert_iterator", "iterator/std::insert_iterator::container_type", "iterator/std::insert_iterator::reference"] helpviewer_keywords: ["std::insert_iterator [C++]", "std::insert_iterator [C++], container_type", "std::insert_iterator [C++], reference"] -ms.assetid: d5d86405-872e-4e3b-9e68-c69a2b7e8221 ms.custom: devdivchpfy22 --- @@ -268,11 +267,11 @@ int main( ) cout << ")." << endl; insert_iterator > ii ( vec, vec.begin ( ) ); -*ii = 30; + *ii = 30; ii++; -*ii = 40; + *ii = 40; ii++; -*ii = 50; + *ii = 50; cout << "After the insertions, the vector vec becomes:\n ( "; for ( vIter = vec.begin ( ) ; vIter != vec.end ( ); vIter++ ) @@ -293,7 +292,7 @@ Inserts a value into the container and returns the iterator updated to point to ```cpp insert_iterator& operator=( - typename Container::const_reference val,); + typename Container::const_reference val); insert_iterator& operator=( typename Container::value_type&& val); diff --git a/docs/standard-library/invalid-argument-class.md b/docs/standard-library/invalid-argument-class.md index 9a3babf927a..f2a22f505cb 100644 --- a/docs/standard-library/invalid-argument-class.md +++ b/docs/standard-library/invalid-argument-class.md @@ -1,12 +1,11 @@ --- -description: "Learn more about: invalid_argument Class" -title: "invalid_argument Class" -ms.date: "09/09/2021" +title: "invalid_argument class" +description: "Learn more about: invalid_argument class" +ms.date: 09/09/2021 f1_keywords: ["stdexcept/std::invalid_argument"] helpviewer_keywords: ["invalid_argument class"] -ms.assetid: af6c227d-ad7c-4e63-9dee-67af81d83506 --- -# invalid_argument Class +# `invalid_argument` class The class serves as the base class for all exceptions thrown to report an invalid argument. @@ -18,13 +17,12 @@ public: explicit invalid_argument(const string& message); explicit invalid_argument(const char *message); - }; ``` ## Remarks -The value returned by `what()` is a copy of `message.data()`. For more information, see [`what`](../standard-library/exception-class.md) and [`data`](../standard-library/basic-string-class.md#data). +The value returned by `what()` is a copy of `message.data()`. For more information, see [`what`](exception-class.md) and [`data`](basic-string-class.md#data). ## Example @@ -49,19 +47,20 @@ int main() cerr << "Type: " << typeid(e).name() << endl; } } -/* Output: +``` + +```Output Caught: invalid bitset char Type: class std::invalid_argument -*/ ``` ## Requirements -**Header:** \ +**Header:** `` -**Namespace:** std +**Namespace:** `std` ## See also -[logic_error Class](../standard-library/logic-error-class.md)\ -[Thread Safety in the C++ Standard Library](../standard-library/thread-safety-in-the-cpp-standard-library.md) +[`logic_error` class](logic-error-class.md)\ +[Thread Safety in the C++ Standard Library](thread-safety-in-the-cpp-standard-library.md) diff --git a/docs/standard-library/iomanip-functions.md b/docs/standard-library/iomanip-functions.md index 3c821d8b77a..64bf5ddc618 100644 --- a/docs/standard-library/iomanip-functions.md +++ b/docs/standard-library/iomanip-functions.md @@ -1,23 +1,13 @@ --- -description: "Learn more about: functions" title: " functions" +description: "Learn more about: functions" ms.date: 11/19/2021 f1_keywords: ["iomanip/std::get_money", "iomanip/std::get_time", "iomanip/std::put_money", "iomanip/std::put_time", "iomanip/std::quoted", "iomanip/std::resetiosflags", "iomanip/std::setbase", "iomanip/std::setfill", "iomanip/std::setiosflags", "iomanip/std::setprecision", "iomanip/std::setw"] helpviewer_keywords: ["std::get_money [C++]", "std::get_time [C++]", "std::put_money [C++]", "std::put_time [C++]", "std::quoted [C++]", "std::resetiosflags [C++]", "std::setbase [C++]", "std::setfill [C++]", "std::setiosflags [C++]", "std::setprecision [C++]", "std::setw [C++]"] --- # `` functions -[`get_money`](#iomanip_get_money)\ -[`get_time`](#iomanip_get_time)\ -[`put_money`](#iomanip_put_money)\ -[`put_time`](#iomanip_put_time)\ -[`quoted`](#quoted)\ -[`resetiosflags`](#resetiosflags)\ -[`setbase`](#setbase)\ -[`setfill`](#setfill)\ -[`setiosflags`](#setiosflags)\ -[`setprecision`](#setprecision)\ -[`setw`](#setw) +The `` header provides the following functions: ## `get_money` @@ -648,4 +638,4 @@ l5 = 65536 ## See also -[``](../standard-library/iomanip.md) \ No newline at end of file +[``](../standard-library/iomanip.md) diff --git a/docs/standard-library/ios-base-class.md b/docs/standard-library/ios-base-class.md index c8e5762d83e..f84b995bda4 100644 --- a/docs/standard-library/ios-base-class.md +++ b/docs/standard-library/ios-base-class.md @@ -665,7 +665,7 @@ void callback1( ios_base::event e, ios_base& stream, int arg ) case ios_base::copyfmt_event: cout << "an copyfmt event" << endl; break; - }; + } } void callback2( ios_base::event e, ios_base& stream, int arg ) @@ -682,7 +682,7 @@ void callback2( ios_base::event e, ios_base& stream, int arg ) case ios_base::copyfmt_event: cout << "an copyfmt event" << endl; break; - }; + } } int main( ) diff --git a/docs/standard-library/ios-functions.md b/docs/standard-library/ios-functions.md index 3f8e2af70c2..458210579ae 100644 --- a/docs/standard-library/ios-functions.md +++ b/docs/standard-library/ios-functions.md @@ -1,9 +1,8 @@ --- -description: "Learn more about: functions" title: " functions" -ms.date: "11/04/2016" +description: "Learn more about: functions" +ms.date: 11/04/2016 f1_keywords: ["xiosbase/std::defaultfloat", "xiosbase/std::boolalpha", "xiosbase/std::dec", "ios/std::fixed", "ios/std::hex", "ios/std::internal", "ios/std::left", "ios/std::noboolalpha", "ios/std::noshowbase", "ios/std::noshowpoint", "ios/std::noshowpos", "ios/std::noskipws", "ios/std::nounitbuf", "ios/std::nouppercase", "ios/std::oct", "ios/std::right", "ios/std::scientific", "ios/std::showbase", "ios/std::showpoint", "ios/std::showpos", "ios/std::skipws", "ios/std::unitbuf", "ios/std::uppercase"] -ms.assetid: 1382d53f-e531-4b41-adf6-6a1543512e51 helpviewer_keywords: ["std::defaultfloat [C++]", "std::boolalpha [C++]", "std::dec [C++]", "std::fixed [C++]", "std::hex [C++]", "std::hexfloat [C++]", "std::io_errc [C++]", "std::internal [C++]", "std::iostream_category [C++]", "std::is_error_code_enum [C++]", "std::left [C++]", "std::make_error_code [C++]", "std::make_error_condition [C++]", "std::noboolalpha [C++]", "std::noshowbase [C++]", "std::noshowpoint [C++]", "std::noshowpos [C++]", "std::noskipws [C++]", "std::nounitbuf [C++]", "std::nouppercase [C++]", "std::oct [C++]", "std::right [C++]", "std::scientific [C++]", "std::showbase [C++]", "std::showpoint [C++]", "std::showpos [C++]", "std::skipws [C++]", "std::unitbuf [C++]", "std::uppercase [C++]"] --- # `` functions @@ -29,7 +28,7 @@ A reference to the object from which *str* is derived. By default, variables of type **`bool`** are displayed as 1 or 0. -`boolalpha` effectively calls `str.`[setf](../standard-library/ios-base-class.md#setf)( `ios_base::boolalpha`), and then returns *str*. +`boolalpha` effectively calls `str.`[setf](../standard-library/ios-base-class.md#setf)(`ios_base::boolalpha`), and then returns *str*. [noboolalpha](../standard-library/ios-functions.md#noboolalpha) reverses the effect of `boolalpha`. @@ -81,7 +80,7 @@ A reference to the object from which *str* is derived. By default, integer variables are displayed in base 10. -`dec` effectively calls `str.`[setf](../standard-library/ios-base-class.md#setf)( `ios_base::dec`, `ios_base::basefield`), and then returns *str*. +`dec` effectively calls `str.`[setf](../standard-library/ios-base-class.md#setf)(`ios_base::dec`, `ios_base::basefield`), and then returns *str*. ### Example @@ -151,7 +150,7 @@ A reference to the object from which *str* is derived. `fixed` is the default display notation for floating-point numbers. [scientific](../standard-library/ios-functions.md#scientific) causes floating-point numbers to be displayed using scientific notation. -The manipulator effectively calls *str*.[setf](../standard-library/ios-base-class.md#setf)( `ios_base::fixed`, `ios_base::floatfield` ), and then returns *str*. +The manipulator effectively calls *str*.[setf](../standard-library/ios-base-class.md#setf)(`ios_base::fixed`, `ios_base::floatfield`), and then returns *str*. ### Example @@ -199,7 +198,7 @@ A reference to the object from which *str* is derived. By default, integer variables are displayed in base 10 notation. [dec](../standard-library/ios-functions.md#dec) and [oct](../standard-library/ios-functions.md#oct) also change the way integer variables appear. -The manipulator effectively calls `str`**.**[setf](../standard-library/ios-base-class.md#setf)( `ios_base::hex`, `ios_base::basefield`), and then returns *str*. +The manipulator effectively calls `str`**.**[setf](../standard-library/ios-base-class.md#setf)(`ios_base::hex`, `ios_base::basefield`), and then returns *str*. ### Example diff --git a/docs/standard-library/iostreams-conventions.md b/docs/standard-library/iostreams-conventions.md index bfc1b389ddd..33f3588d273 100644 --- a/docs/standard-library/iostreams-conventions.md +++ b/docs/standard-library/iostreams-conventions.md @@ -1,33 +1,32 @@ --- -description: "Learn more about: iostreams Conventions" title: "iostreams Conventions" -ms.date: "11/04/2016" +description: "Learn more about: iostreams Conventions" +ms.date: 11/04/2016 helpviewer_keywords: ["iostream header", "C++ Standard Library, iostreams"] -ms.assetid: 9fe5ded0-37a1-48d1-9671-c81ffc4760ad --- # iostreams Conventions The iostreams headers support conversions between text and encoded forms, and input and output to external files: -[\](../standard-library/fstream.md)\ -[\](../standard-library/iomanip.md)\ -[\](../standard-library/ios.md)\ -[\](../standard-library/iosfwd.md)\ -[\](../standard-library/iostream.md)\ -[\](../standard-library/istream.md)\ -[\](../standard-library/ostream.md)\ -[\](../standard-library/sstream.md)\ -[\](../standard-library/streambuf.md)\ -[\](../standard-library/strstream.md) +[``](fstream.md)\ +[``](iomanip.md)\ +[``](ios.md)\ +[``](iosfwd.md)\ +[``](iostream.md)\ +[``](istream.md)\ +[``](ostream.md)\ +[``](sstream.md)\ +[``](streambuf.md)\ +[``](strstream.md) -The simplest use of iostreams requires only that you include the header [\](../standard-library/iostream.md). You can then extract values from [cin](../standard-library/iostream.md#cin) or [wcin](../standard-library/iostream.md#wcin) to read the standard input. The rules for doing so are outlined in the description of the class [basic_istream Class](../standard-library/basic-istream-class.md). You can also insert values to [cout](../standard-library/iostream.md#cout) or [wcout](../standard-library/iostream.md#wcout) to write the standard output. The rules for doing so are outlined in the description of the class [basic_ostream Class](../standard-library/basic-ostream-class.md). Format control common to both extractors and insertors is managed by the class [basic_ios Class](../standard-library/basic-ios-class.md). Manipulating this format information in the guise of extracting and inserting objects is the province of several manipulators. +The simplest use of iostreams requires only that you include the header [``](iostream.md). You can then extract values from [`cin`](iostream.md#cin) or [`wcin`](iostream.md#wcin) to read the standard input. The rules for doing so are outlined in the description of the [`basic_istream` class](basic-istream-class.md). You can also insert values to [`cout`](iostream.md#cout) or [`wcout`](iostream.md#wcout) to write the standard output. The rules for doing so are outlined in the description of the [`basic_ostream` class](basic-ostream-class.md). Format control common to both extractors and insertors is managed by the [`basic_ios` class](basic-ios-class.md). Manipulating this format information in the guise of extracting and inserting objects is the province of several manipulators. -You can perform the same iostreams operations on files that you open by name, using the classes declared in [\](../standard-library/fstream.md). To convert between iostreams and objects of class [basic_string Class](../standard-library/basic-string-class.md), use the classes declared in [\](../standard-library/sstream.md). To do the same with C strings, use the classes declared in [\](../standard-library/strstream.md). +You can perform the same iostreams operations on files that you open by name, using the classes declared in [``](fstream.md). To convert between iostreams and objects of [`basic_string` class](basic-string-class.md), use the classes declared in [``](sstream.md). To do the same with C strings, use the classes declared in [``](strstream.md). The remaining headers provide support services, typically of direct interest to only the most advanced users of the iostreams classes. ## See also -[C++ Standard Library Overview](../standard-library/cpp-standard-library-overview.md)\ -[iostream Programming](../standard-library/iostream-programming.md)\ -[Thread Safety in the C++ Standard Library](../standard-library/thread-safety-in-the-cpp-standard-library.md) +[C++ Standard Library Overview](cpp-standard-library-overview.md)\ +[`iostream` Programming](iostream-programming.md)\ +[Thread Safety in the C++ Standard Library](thread-safety-in-the-cpp-standard-library.md) diff --git a/docs/standard-library/iota-view-class.md b/docs/standard-library/iota-view-class.md index c54f71c12d0..f33113e8cb6 100644 --- a/docs/standard-library/iota-view-class.md +++ b/docs/standard-library/iota-view-class.md @@ -67,7 +67,7 @@ This view is typically used to iterate over a series of values. For example: ```cpp for (int i : iota_view{1, 10}) // iterate over a view of the integers 1 through 9 { - std::cout << i << ’ ’; // 1 2 3 4 5 6 7 8 9 + std::cout << i << ' '; // 1 2 3 4 5 6 7 8 9 } ``` @@ -116,7 +116,7 @@ When you use one of the constructors that value-initializes the bound, the bound ## `iota_view` constructor example ```cpp -// requires /std:c++20, or later +// requires /std:c++20 or later #include #include #include diff --git a/docs/standard-library/is-error-code-enum-class.md b/docs/standard-library/is-error-code-enum-class.md index 320d487d286..68b900c9dd4 100644 --- a/docs/standard-library/is-error-code-enum-class.md +++ b/docs/standard-library/is-error-code-enum-class.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: is_error_code_enum Class" title: "is_error_code_enum Class" +description: "Learn more about: is_error_code_enum Class" ms.date: "11/04/2016" f1_keywords: ["system_error/std::is_error_code_enum"] helpviewer_keywords: ["is_error_code_enum class"] -ms.assetid: cee5be2d-7c20-4cec-a352-1ab8b7d32601 --- # is_error_code_enum Class @@ -13,8 +12,8 @@ Represents a type predicate that tests for the [error_code](../standard-library/ ## Syntax ```cpp -template <_Enum> - class is_error_code_enum; +template +struct is_error_code_enum; ``` ## Remarks diff --git a/docs/standard-library/is-error-condition-enum-class.md b/docs/standard-library/is-error-condition-enum-class.md index cf277036fe6..f5599c93e10 100644 --- a/docs/standard-library/is-error-condition-enum-class.md +++ b/docs/standard-library/is-error-condition-enum-class.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: is_error_condition_enum Class" title: "is_error_condition_enum Class" +description: "Learn more about: is_error_condition_enum Class" ms.date: "11/04/2016" f1_keywords: ["system_error/std::is_error_condition_enum"] helpviewer_keywords: ["is_error_condition_enum class"] -ms.assetid: 752bb87a-c61c-4304-9254-5aaf228b59c0 --- # is_error_condition_enum Class @@ -13,8 +12,8 @@ Represents a type predicate that tests for the [error_condition](../standard-lib ## Syntax ```cpp -template <_Enum> - class is_error_condition_enum; +template +struct is_error_condition_enum; ``` ## Remarks diff --git a/docs/standard-library/istream-functions.md b/docs/standard-library/istream-functions.md index 5393a82b019..5b0e2c372b6 100644 --- a/docs/standard-library/istream-functions.md +++ b/docs/standard-library/istream-functions.md @@ -1,14 +1,12 @@ --- -description: "Learn more about: functions" title: " functions" -ms.date: "11/04/2016" +description: "Learn more about: functions" +ms.date: 11/04/2016 f1_keywords: ["istream/std::swap", "istream/std::ws"] -ms.assetid: 0301ea0d-4ded-4841-83dd-4253b55b3188 --- # `` functions -[swap](#istream_swap)\ -[ws](#ws) +The `` header provides the following functions: ## swap @@ -39,7 +37,8 @@ A stream. Skips white space in the stream. ```cpp -template class basic_istream& ws(basic_istream& _Istr); +template +basic_istream& ws(basic_istream& _Istr); ``` ### Parameters diff --git a/docs/standard-library/istream-iterator-class.md b/docs/standard-library/istream-iterator-class.md index 7e0a116ca68..4961861016a 100644 --- a/docs/standard-library/istream-iterator-class.md +++ b/docs/standard-library/istream-iterator-class.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: istream_iterator Class" title: "istream_iterator Class" +description: "Learn more about: istream_iterator Class" ms.date: 06/15/2022 f1_keywords: ["iterator/std::istream_iterator", "iterator/std::istream_iterator::char_type", "iterator/std::istream_iterator::istream_type", "iterator/std::istream_iterator::traits_type"] helpviewer_keywords: ["std::istream_iterator [C++]", "std::istream_iterator [C++], char_type", "std::istream_iterator [C++], istream_type", "std::istream_iterator [C++], traits_type"] -ms.assetid: fb52a8cd-7f71-48d1-b73e-4b064e2a8d16 ms.custom: devdivchpfy22 --- @@ -160,7 +159,7 @@ int main( ) istream_iterator intvecRead ( cin ); // Default constructor will test equal to end of stream - // for delimiting source range of vecor + // for delimiting source range of vector copy ( intvecRead , istream_iterator( ) , vec.begin ( ) ); cin.clear ( ); diff --git a/docs/standard-library/istream-typedefs.md b/docs/standard-library/istream-typedefs.md index 2fb9ef751ec..9d43bdeaa16 100644 --- a/docs/standard-library/istream-typedefs.md +++ b/docs/standard-library/istream-typedefs.md @@ -1,16 +1,12 @@ --- -description: "Learn more about: typedefs" title: " typedefs" -ms.date: "11/04/2016" +description: "Learn more about: typedefs" +ms.date: 11/04/2016 f1_keywords: ["istream/std::iostream", "istream/std::istream", "istream/std::wiostream", "istream/std::wistream"] -ms.assetid: 55bc1f84-53a7-46ca-a36f-ac6ef75d0374 --- # `` typedefs -[iostream](#iostream)\ -[istream](#istream)\ -[wiostream](#wiostream)\ -[wistream](#wistream) +The `` header provides the following typedefs: ## iostream diff --git a/docs/standard-library/istreambuf-iterator-class.md b/docs/standard-library/istreambuf-iterator-class.md index 9b05304ed12..13b7a13fc70 100644 --- a/docs/standard-library/istreambuf-iterator-class.md +++ b/docs/standard-library/istreambuf-iterator-class.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: istreambuf_iterator Class" title: "istreambuf_iterator Class" +description: "Learn more about: istreambuf_iterator Class" ms.date: 06/15/2022 f1_keywords: ["streambuf/std::istreambuf_iterator", "iterator/std::istreambuf_iterator::char_type", "iterator/std::istreambuf_iterator::int_type", "iterator/std::istreambuf_iterator::istream_type", "iterator/std::istreambuf_iterator::streambuf_type", "iterator/std::istreambuf_iterator::traits_type", "iterator/std::istreambuf_iterator::equal"] helpviewer_keywords: ["std::istreambuf_iterator [C++]", "std::istreambuf_iterator [C++], char_type", "std::istreambuf_iterator [C++], int_type", "std::istreambuf_iterator [C++], istream_type", "std::istreambuf_iterator [C++], streambuf_type", "std::istreambuf_iterator [C++], traits_type", "std::istreambuf_iterator [C++], equal"] -ms.assetid: 39002da2-61a6-48a5-9d0c-5df8271f6038 ms.custom: devdivchpfy22 --- @@ -15,7 +14,7 @@ The class template istreambuf_iterator describes an input iterator object that e ## Syntax ```cpp -template > +template > class istreambuf_iterator : public iterator ``` @@ -341,7 +340,7 @@ int main( ) ostreambuf_iterator outpos ( cout ); while ( inpos != endpos ) { -*outpos = *inpos; + *outpos = *inpos; ++inpos; //Increment istreambuf_iterator ++outpos; } diff --git a/docs/standard-library/iterator-concepts.md b/docs/standard-library/iterator-concepts.md index b26c47b97a4..a5e205079fb 100644 --- a/docs/standard-library/iterator-concepts.md +++ b/docs/standard-library/iterator-concepts.md @@ -1,6 +1,6 @@ --- -description: "Learn more about iterator concepts." title: "Iterator concepts" +description: "Learn more about iterator concepts." ms.date: 12/16/2022 f1_keywords: ["ranges/std::ranges::range", "ranges/std::ranges::bidirectional_iterator", "ranges/std::ranges::borrowed_iterator", "ranges/std::ranges::common_iterator", "ranges/std::ranges::contiguous_iterator", "ranges/std::ranges::forward_iterator", "ranges/std::ranges::input_iterator", "ranges/std::ranges::output_iterator", "ranges/std::ranges::random_access_iterator", "ranges/std::ranges::simple_view", "ranges/std::ranges::sized_iterator", "ranges/std::ranges::view", "ranges/std::ranges::viewable_iterator"] helpviewer_keywords: ["std::ranges [C++], ranges::range", "std::ranges [C++], ranges::bidirectional_iterator", "std::ranges [C++], ranges::borrowed_iterator", "std::ranges [C++], ranges::common_iterator", "std::ranges [C++], ranges::contiguous_iterator", "std::ranges [C++], ranges::forward_iterator", "std::ranges [C++], ranges::input_iterator", "std::ranges [C++], ranges::output_iterator", "std::ranges [C++], ranges::random_access_iterator", "std::ranges [C++], ranges::simple_view", "std::ranges [C++], ranges::sized_iterator", "std::ranges [C++], ranges::view", "std::ranges [C++], ranges::viewable_iterator"] @@ -70,7 +70,7 @@ In the following table, "Example types" refers to collections/iterators that sat | [`forward_iterator`](#forward_iterator)C++20 | Specifies an iterator that can read (and possibly write) multiple times. | Forward | Read/write | yes | `vector`, `list` | | [`bidirectional_iterator`](#bidirectional_iterator)C++20 | Specifies an iterator that you can read and write both forwards and backwards. | Forward or backward | Read/write | yes | `list`, `set`, `multiset`, `map`, and `multimap`. | | [`random_access_iterator`](#random_access_iterator)C++20 | Specifies an iterator that you can read and write by index. | Forward or backward | Read/write | yes | `vector`, `array`, `deque` | -| [`contiguous_iterator`](#contiguous_iterator)C++20 | Specifies an iterator whose elements are sequential in memory, are the same size, and can be accessed using pointer arithmetic. | Forward or backward | Read/write | yes | `array`, `vector` `string`.| +| [`contiguous_iterator`](#contiguous_iterator)C++20 | Specifies an iterator whose elements are sequential in memory, are the same size, and can be accessed using pointer arithmetic. | Forward or backward | Read/write | yes | `array`, `vector`, `string`.| Other iterator concepts include: @@ -455,8 +455,6 @@ The iterator type. *`S`*\ The sentinel type to test. -### Remarks - ### Example: `sized_sentinel_for` The following example uses the `sized_sentinel_for` concept to verify that the sentinel for a `vector` can be subtracted from the vectors iterator in constant time: diff --git a/docs/standard-library/iterator-functions.md b/docs/standard-library/iterator-functions.md index 99b7df088fa..e758db8a27e 100644 --- a/docs/standard-library/iterator-functions.md +++ b/docs/standard-library/iterator-functions.md @@ -1,7 +1,7 @@ --- title: " functions" description: "Learn more about: functions" -ms.date: "11/04/2016" +ms.date: 11/04/2016 f1_keywords: ["xutility/std::advance", "xutility/std::back_inserter", "xutility/std::begin", "xutility/std::cbegin", "xutility/std::cend", "xutility/std::distance", "xutility/std::end", "xutility/std::front_inserter", "xutility/std::inserter", "xutility/std::make_checked_array_iterator", "xutility/std::make_move_iterator", "xutility/std::make_unchecked_array_iterator", "xutility/std::next", "xutility/std::prev"] helpviewer_keywords: ["std::advance [C++]", "std::back_inserter [C++]", "std::begin [C++]", "std::cbegin [C++]", "std::cend [C++]", "std::distance [C++]", "std::end [C++]", "std::front_inserter [C++]", "std::inserter [C++]", "std::make_checked_array_iterator [C++]", "std::make_move_iterator [C++]", "std::make_unchecked_array_iterator [C++]", "std::next [C++]", "std::prev [C++]"] --- @@ -159,11 +159,11 @@ Retrieves an iterator to the first element in a specified container. ```cpp template -auto begin(Container& cont) ` +auto begin(Container& cont) -> decltype(cont.begin()); template -auto begin(const Container& cont) ` +auto begin(const Container& cont) -> decltype(cont.begin()); template diff --git a/docs/standard-library/iterator-traits-struct.md b/docs/standard-library/iterator-traits-struct.md index 4ad621f7742..b47a2146074 100644 --- a/docs/standard-library/iterator-traits-struct.md +++ b/docs/standard-library/iterator-traits-struct.md @@ -1,7 +1,7 @@ --- title: "iterator_traits Struct" description: "Learn more about: iterator_traits Struct" -ms.date: "11/04/2016" +ms.date: 11/04/2016 f1_keywords: ["xutility/std::iterator_traits"] helpviewer_keywords: ["iterator_traits struct", "iterator_traits class"] --- @@ -88,7 +88,7 @@ function( it i1, it i2 ) x = *i1; cout << x << " "; i1++; - }; + } cout << endl; }; diff --git a/docs/standard-library/iterator.md b/docs/standard-library/iterator.md index 4c87768cbf0..f5ac9540c1b 100644 --- a/docs/standard-library/iterator.md +++ b/docs/standard-library/iterator.md @@ -58,7 +58,7 @@ Visual Studio has added extensions to C++ Standard Library iterators to support |[`operator!=`](../standard-library/iterator-operators.md#op_neq)|Tests if the iterator object on the left side of the operator isn't equal to the iterator object on the right side.| |[`operator==`](../standard-library/iterator-operators.md#op_eq_eq)|Tests if the iterator object on the left side of the operator is equal to the iterator object on the right side.| |[`operator<`](../standard-library/iterator-operators.md#op_lt)|Tests if the iterator object on the left side of the operator is less than the iterator object on the right side.| -|[`operator<=`](../standard-library/iterator-operators.md#op_gt_eq)|Tests if the iterator object on the left side of the operator is less than or equal to the iterator object on the right side.| +|[`operator<=`](../standard-library/iterator-operators.md#op_lt_eq)|Tests if the iterator object on the left side of the operator is less than or equal to the iterator object on the right side.| |[`operator>`](../standard-library/iterator-operators.md#op_gt)|Tests if the iterator object on the left side of the operator is greater than the iterator object on the right side.| |[`operator>=`](../standard-library/iterator-operators.md#op_gt_eq)|Tests if the iterator object on the left side of the operator is greater than or equal to the iterator object on the right side.| |[`operator+`](../standard-library/iterator-operators.md#op_add)|Adds an offset to an iterator and returns the new `reverse_iterator` addressing the inserted element at the new offset position.| diff --git a/docs/standard-library/join-view-class.md b/docs/standard-library/join-view-class.md index aef74d56cfa..0f94798f81d 100644 --- a/docs/standard-library/join-view-class.md +++ b/docs/standard-library/join-view-class.md @@ -90,7 +90,7 @@ For information about the template parameter type, see [Template parameters](#te ### Example: `join_view` ```cpp -// requires /std:c++20, or later +// requires /std:c++20 or later #include #include #include diff --git a/docs/standard-library/keys-view-class.md b/docs/standard-library/keys-view-class.md index 4b9d1e47bee..6108fac74f2 100644 --- a/docs/standard-library/keys-view-class.md +++ b/docs/standard-library/keys-view-class.md @@ -96,7 +96,7 @@ The best way to create an `keys_view` is by using the [`keys`](range-adaptors.md 1\) Create a `keys_view` from the specified view.\ 2\) The default constructor creates an empty `keys_view`. -### Example: `keys_view` +### Example: `keys_view` ```cpp // requires /std:c++20 or later diff --git a/docs/standard-library/lazy-split-view-class.md b/docs/standard-library/lazy-split-view-class.md index c910a9bb5ee..1736de4824c 100644 --- a/docs/standard-library/lazy-split-view-class.md +++ b/docs/standard-library/lazy-split-view-class.md @@ -236,6 +236,6 @@ The sentinel that follows the last element in the view: ## See also [``](ranges.md)\ -[`lazy_split` range adaptor](range-adaptors.md#lazy_split) +[`lazy_split` range adaptor](range-adaptors.md#lazy_split)\ [`split_view` class](split-view-class.md)\ [view classes](view-classes.md) diff --git a/docs/standard-library/length-error-class.md b/docs/standard-library/length-error-class.md index 7df63ed20bc..7230d8b628f 100644 --- a/docs/standard-library/length-error-class.md +++ b/docs/standard-library/length-error-class.md @@ -1,12 +1,11 @@ --- -description: "Learn more about: length_error Class" -title: "length_error Class" -ms.date: "09/09/2021" +title: "length_error class" +description: "Learn more about: length_error class" +ms.date: 09/09/2021 f1_keywords: ["stdexcept/std::length_error"] helpviewer_keywords: ["length_error class"] -ms.assetid: d53c46c5-4626-400d-bd76-bf3e1e0f64ae --- -# length_error Class +# `length_error` class The class serves as the base class for all exceptions thrown to report an attempt to generate an object too long to be specified. @@ -18,13 +17,12 @@ public: explicit length_error(const string& message); explicit length_error(const char *message); - }; ``` ## Remarks -The value returned by `what()` is a copy of `message.data()`. For more information, see [`what`](../standard-library/exception-class.md) and [`data`](../standard-library/basic-string-class.md#data). +The value returned by `what()` is a copy of `message.data()`. For more information, see [`what`](exception-class.md) and [`data`](basic-string-class.md#data). ## Example @@ -50,19 +48,20 @@ int main() cerr << "Type: " << typeid(e).name() << endl; } } -/* Output: +``` + +```Output Caught: vector too long Type: class std::length_error -*/ ``` ## Requirements -**Header:** \ +**Header:** `` -**Namespace:** std +**Namespace:** `std` ## See also -[logic_error Class](../standard-library/logic-error-class.md)\ -[Thread Safety in the C++ Standard Library](../standard-library/thread-safety-in-the-cpp-standard-library.md) +[`logic_error` class](logic-error-class.md)\ +[Thread Safety in the C++ Standard Library](thread-safety-in-the-cpp-standard-library.md) diff --git a/docs/standard-library/less-struct.md b/docs/standard-library/less-struct.md index 380355a2562..d4c3d3ac567 100644 --- a/docs/standard-library/less-struct.md +++ b/docs/standard-library/less-struct.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: less Struct" title: "less Struct" -ms.date: "11/04/2016" +description: "Learn more about: less Struct" +ms.date: 11/04/2016 f1_keywords: ["functional/std::less"] helpviewer_keywords: ["less struct", "less function"] -ms.assetid: 39349da3-11cd-4774-b2cc-b46af5aae5d7 --- # less Struct @@ -80,7 +79,7 @@ int main() { cout << "Original vector v1 = ( " ; for ( Iter1 = v1.begin() ; Iter1 != v1.end() ; Iter1++ ) -cout << Iter1->m_i << " "; + cout << Iter1->m_i << " "; cout << ")" << endl; // To sort in ascending order, @@ -88,7 +87,7 @@ cout << Iter1->m_i << " "; cout << "Sorted vector v1 = ( " ; for ( Iter1 = v1.begin() ; Iter1 != v1.end() ; Iter1++ ) -cout << Iter1->m_i << " "; + cout << Iter1->m_i << " "; cout << ")" << endl; } ``` diff --git a/docs/standard-library/limits-enums.md b/docs/standard-library/limits-enums.md index b94c4afc328..791135fc348 100644 --- a/docs/standard-library/limits-enums.md +++ b/docs/standard-library/limits-enums.md @@ -1,21 +1,24 @@ --- -description: "Learn more about: enums" title: " enums" -ms.date: "11/04/2016" +description: "Learn more about: enums" +ms.date: 11/04/2016 f1_keywords: ["limits/std::float_denorm_style", "limits/std::float_round_style"] -ms.assetid: c86680a2-ba97-4ed9-8c20-a448857d7dc5 --- # `` enums -## float_denorm_style +The `` header provides the following enums: + +## `float_denorm_style` The enumeration describes the various methods that an implementation can choose for representing a denormalized floating-point value — one too small to represent as a normalized value: ```cpp -enum float_denorm_style { +enum float_denorm_style +{ denorm_indeterminate = -1, denorm_absent = 0, - denorm_present = 1 }; + denorm_present = 1 +}; ``` ### Return Value @@ -23,26 +26,26 @@ enum float_denorm_style { The enumeration returns: - `denorm_indeterminate` if the presence or absence of denormalized forms cannot be determined at translation time. - - `denorm_absent` if denormalized forms are absent. - - `denorm_present` if denormalized forms are present. ### Example -See [numeric_limits::has_denorm](../standard-library/numeric-limits-class.md#has_denorm) for an example in which the values of this enumeration may be accessed. +See [`numeric_limits::has_denorm`](numeric-limits-class.md#has_denorm) for an example in which the values of this enumeration may be accessed. -## float_round_style +## `float_round_style` The enumeration describes the various methods that an implementation can choose for rounding a floating-point value to an integer value. ```cpp -enum float_round_style { +enum float_round_style +{ round_indeterminate = -1, round_toward_zero = 0, round_to_nearest = 1, round_toward_infinity = 2, - round_toward_neg_infinity = 3 }; + round_toward_neg_infinity = 3 +}; ``` ### Return Value @@ -50,15 +53,11 @@ enum float_round_style { The enumeration returns: - `round_indeterminate` if the rounding method cannot be determined. - - `round_toward_zero` if the round toward zero. - - `round_to_nearest` if the round to nearest integer. - - `round_toward_infinity` if the round away from zero. - - `round_toward_neg_infinity` if the round to more negative integer. ### Example -See [numeric_limits::round_style](../standard-library/numeric-limits-class.md#round_style) for an example in which the values of this enumeration may be accessed. +See [`numeric_limits::round_style`](numeric-limits-class.md#round_style) for an example in which the values of this enumeration may be accessed. diff --git a/docs/standard-library/list-class.md b/docs/standard-library/list-class.md index 3e8d6dbc987..e2c7a17216c 100644 --- a/docs/standard-library/list-class.md +++ b/docs/standard-library/list-class.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: list Class" title: "list Class" -ms.date: "11/04/2016" +description: "Learn more about: list Class" +ms.date: 11/04/2016 f1_keywords: ["list/std::list", "list/std::list::allocator_type", "list/std::list::const_iterator", "list/std::list::const_pointer", "list/std::list::const_reference", "list/std::list::const_reverse_iterator", "list/std::list::difference_type", "list/std::list::iterator", "list/std::list::pointer", "list/std::list::reference", "list/std::list::reverse_iterator", "list/std::list::size_type", "list/std::list::value_type", "list/std::list::assign", "list/std::list::back", "list/std::list::begin", "list/std::list::cbegin", "list/std::list::cend", "list/std::list::clear", "list/std::list::crbegin", "list/std::list::crend", "list/std::list::emplace", "list/std::list::emplace_back", "list/std::list::emplace_front", "list/std::list::empty", "list/std::list::end", "list/std::list::erase", "list/std::list::front", "list/std::list::get_allocator", "list/std::list::insert", "list/std::list::max_size", "list/std::list::merge", "list/std::list::pop_back", "list/std::list::pop_front", "list/std::list::push_back", "list/std::list::push_front", "list/std::list::rbegin", "list/std::list::remove", "list/std::list::remove_if", "list/std::list::rend", "list/std::list::resize", "list/std::list::reverse", "list/std::list::size", "list/std::list::sort", "list/std::list::splice", "list/std::list::swap", "list/std::list::unique"] helpviewer_keywords: ["std::list [C++]", "std::list [C++], allocator_type", "std::list [C++], const_iterator", "std::list [C++], const_pointer", "std::list [C++], const_reference", "std::list [C++], const_reverse_iterator", "std::list [C++], difference_type", "std::list [C++], iterator", "std::list [C++], pointer", "std::list [C++], reference", "std::list [C++], reverse_iterator", "std::list [C++], size_type", "std::list [C++], value_type", "std::list [C++], assign", "std::list [C++], back", "std::list [C++], begin", "std::list [C++], cbegin", "std::list [C++], cend", "std::list [C++], clear", "std::list [C++], crbegin", "std::list [C++], crend", "std::list [C++], emplace", "std::list [C++], emplace_back", "std::list [C++], emplace_front", "std::list [C++], empty", "std::list [C++], end", "std::list [C++], erase", "std::list [C++], front", "std::list [C++], get_allocator", "std::list [C++], insert", "std::list [C++], max_size", "std::list [C++], merge", "std::list [C++], pop_back", "std::list [C++], pop_front", "std::list [C++], push_back", "std::list [C++], push_front", "std::list [C++], rbegin", "std::list [C++], remove", "std::list [C++], remove_if", "std::list [C++], rend", "std::list [C++], resize", "std::list [C++], reverse", "std::list [C++], size", "std::list [C++], sort", "std::list [C++], splice", "std::list [C++], swap", "std::list [C++], unique"] -ms.assetid: d3707f4a-10fd-444f-b856-f9ca2077c1cd --- # `list` Class @@ -303,7 +302,7 @@ int main( ) c1_Iter = c1.begin( ); cout << "The first element of c1 is " << *c1_Iter << endl; -*c1_Iter = 20; + *c1_Iter = 20; c1_Iter = c1.begin( ); cout << "The first element of c1 is now " << *c1_Iter << endl; @@ -851,7 +850,7 @@ int main( ) cout << "The last integer of c1 is " << *c1_Iter << endl; c1_Iter--; -*c1_Iter = 400; + *c1_Iter = 400; cout << "The new next-to-last integer of c1 is " << *c1_Iter << endl; @@ -1754,7 +1753,7 @@ int main( ) cout << endl; c1_rIter = c1.rbegin( ); -*c1_rIter = 40; + *c1_rIter = 40; cout << "The last element in the list is now " << *c1_rIter << "." << endl; } ``` diff --git a/docs/standard-library/list-functions.md b/docs/standard-library/list-functions.md index 7047605aa77..3827916e5b6 100644 --- a/docs/standard-library/list-functions.md +++ b/docs/standard-library/list-functions.md @@ -1,8 +1,8 @@ --- +title: " functions" description: "Learn more about: functions" -title: functions +ms.date: 11/04/2016 ms.custom: "" -ms.date: "11/04/2016" ms.topic: "reference" f1_keywords: ["list/std::swap"] --- diff --git a/docs/standard-library/list.md b/docs/standard-library/list.md index 389e03c2301..6d8ef3944f2 100644 --- a/docs/standard-library/list.md +++ b/docs/standard-library/list.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: " title: "" -ms.date: "11/04/2016" +description: "Learn more about: " +ms.date: 11/04/2016 f1_keywords: [""] helpviewer_keywords: ["list header"] -ms.assetid: 2345823b-5612-44d8-95d3-aa96ed076d17 --- # `` @@ -27,7 +26,7 @@ Defines the container class template list and several supporting templates. |-|-| |[operator!=](../standard-library/list-operators.md#op_neq)|Tests if the list object on the left side of the operator is not equal to the list object on the right side.| |[operator<](../standard-library/list-operators.md#op_lt)|Tests if the list object on the left side of the operator is less than the list object on the right side.| -|[operator\<=](../standard-library/list-operators.md#op_gt_eq)|Tests if the list object on the left side of the operator is less than or equal to the list object on the right side.| +|[operator\<=](../standard-library/list-operators.md#op_lt_eq)|Tests if the list object on the left side of the operator is less than or equal to the list object on the right side.| |[operator==](../standard-library/list-operators.md#op_eq_eq)|Tests if the list object on the left side of the operator is equal to the list object on the right side.| |[operator>](../standard-library/list-operators.md#op_gt)|Tests if the list object on the left side of the operator is greater than the list object on the right side.| |[operator>=](../standard-library/list-operators.md#op_gt_eq)|Tests if the list object on the left side of the operator is greater than or equal to the list object on the right side.| diff --git a/docs/standard-library/local_t.md b/docs/standard-library/local_t.md index c16c7b89789..f90b3ac8b44 100644 --- a/docs/standard-library/local_t.md +++ b/docs/standard-library/local_t.md @@ -2,7 +2,7 @@ title: "local_t struct" description: "Learn more about: local_t struct" ms.date: 09/02/2021 -f1_keywords: ["chrono/std::chrono::local_t", chrono/std::chrono::local_t:local_time", "chrono/std::chrono::local_days", "chrono/std::chrono::local_seconds"] +f1_keywords: ["chrono/std::chrono::local_t", "chrono/std::chrono::local_time", "chrono/std::chrono::local_days", "chrono/std::chrono::local_seconds"] helpviewer_keywords: ["std::chrono [C++], local_t"] dev_langs: ["C++"] --- diff --git a/docs/standard-library/locale-class.md b/docs/standard-library/locale-class.md index b627b01ac3b..96b2151a0f3 100644 --- a/docs/standard-library/locale-class.md +++ b/docs/standard-library/locale-class.md @@ -1,10 +1,9 @@ --- description: "Learn more about: locale Class" title: "locale Class" -ms.date: 06/15/2022 +ms.date: 11/13/2025 f1_keywords: ["xlocale/std::locale", "xlocale/std::locale::category", "xlocale/std::locale::combine", "xlocale/std::locale::name", "xlocale/std::locale::classic", "xlocale/std::locale::global", "xlocale/std::locale::operator( )", "xlocale/std::locale::facet", "xlocale/std::locale::id"] helpviewer_keywords: ["std::locale [C++]", "std::locale [C++], category", "std::locale [C++], combine", "std::locale [C++], name", "std::locale [C++], classic", "std::locale [C++], global", "std::locale [C++], facet", "std::locale [C++], id"] -ms.assetid: 7dd6d271-472d-4750-8fb5-ea8f55fbef62 ms.custom: devdivchpfy22 --- @@ -92,15 +91,16 @@ messages Some of these predefined facets are used by the `iostream` classes, to control the conversion of numeric values to and from text sequences. -An object of class locale also stores a locale name as an object of class [string](../standard-library/string-typedefs.md#string). Using an invalid locale name to construct a locale facet or a locale object throws an object of class [runtime_error](../standard-library/runtime-error-class.md). The stored locale name is `"*"` if the locale object can't be certain that a C-style locale corresponds exactly to the one represented by the object. Otherwise, you can establish a matching locale within the Standard C Library, for some locale object `locale_object`, by calling `setlocale(LC_ALL , locale_object.`[name](#name)`().c_str())`. - -In this implementation, you can also call the static member function: +An object of class `locale` also stores a locale name as an object of class [string](../standard-library/string-typedefs.md#string). Using an invalid locale name to construct a locale facet or a locale object throws an object of class [runtime_error](../standard-library/runtime-error-class.md). The stored locale name is `"*"` if the locale object can't be certain that a C-style locale corresponds exactly to the one represented by the object. Otherwise, you can establish a matching locale within the Standard C Library, for some locale object `locale_object`, by calling `setlocale(LC_ALL , locale_object.`[name](#name)`().c_str())`. ```cpp static locale empty(); ``` -to construct a locale object that has no facets. It's also a transparent locale. If the template functions [has_facet](../standard-library/locale-functions.md#has_facet) and [use_facet](../standard-library/locale-functions.md#use_facet) can't find the requested facet in a transparent locale, they consult first the global locale and then, if that is transparent, the classic locale. So, you can write: +> [!NOTE] +> `locale::empty()` was deprecated starting with Visual Studio 2022 17.14. It'll be removed starting with MSVC Build Tools 14.51. For more information, see [#5834](https://github.com/microsoft/STL/pull/5834). + +In this implementation, you can also call the static member function `empty()` to construct a locale object that has no facets. It's also a transparent locale. If the template functions [has_facet](../standard-library/locale-functions.md#has_facet) and [use_facet](../standard-library/locale-functions.md#use_facet) can't find the requested facet in a transparent locale, they consult first the global locale and then, if that is transparent, the classic locale. So, you can write: ```cpp cout.imbue(locale::empty()); diff --git a/docs/standard-library/locale-functions.md b/docs/standard-library/locale-functions.md index cf168fad5d7..5a616e7085a 100644 --- a/docs/standard-library/locale-functions.md +++ b/docs/standard-library/locale-functions.md @@ -1,28 +1,13 @@ --- -description: "Learn more about: functions" title: " functions" -ms.date: "11/04/2016" +description: "Learn more about: functions" +ms.date: 11/04/2016 f1_keywords: ["locale/std::has_facet", "locale/std::isalnum", "locale/std::isalpha", "locale/std::iscntrl", "locale/std::isdigit", "locale/std::isgraph", "locale/std::islower", "locale/std::isprint", "locale/std::ispunct", "locale/std::isspace", "locale/std::isupper", "locale/std::isxdigit", "locale/std::tolower", "locale/std::toupper", "locale/std::use_facet"] -ms.assetid: b06c1ceb-33a7-48d3-8d4b-2714bbb27f14 helpviewer_keywords: ["std::has_facet [C++]", "std::isalnum [C++]", "std::isalpha [C++]", "std::iscntrl [C++]", "std::isdigit [C++]", "std::isgraph [C++]", "std::islower [C++]", "std::isprint [C++]", "std::ispunct [C++]", "std::isspace [C++]", "std::isupper [C++]", "std::isxdigit [C++]", "std::tolower [C++]", "std::toupper [C++]", "std::use_facet [C++]"] --- # `` functions -[has_facet](#has_facet)\ -[isalnum](#isalnum)\ -[isalpha](#isalpha)\ -[iscntrl](#iscntrl)\ -[isdigit](#isdigit)\ -[isgraph](#isgraph)\ -[islower](#islower)\ -[isprint](#isprint)\ -[ispunct](#ispunct)\ -[isspace](#isspace)\ -[isupper](#isupper)\ -[isxdigit](#isxdigit)\ -[tolower](#tolower)\ -[toupper](#toupper)\ -[use_facet](#use_facet) +The `` header provides the following functions: ## has_facet @@ -157,7 +142,7 @@ The locale containing the alphabetic element to be tested. ### Remarks -The template function returns [use_facet](../standard-library/locale-functions.md#use_facet)< [ctype](../standard-library/ctype-class.md)\< **CharType**> >( `Loc`). [is](../standard-library/ctype-class.md#is)( **ctype**\< **CharType**>:: **alpha**, `Ch`). +The template function returns [use_facet](../standard-library/locale-functions.md#use_facet)< [ctype](../standard-library/ctype-class.md)\< **CharType**> >(`Loc`). [is](../standard-library/ctype-class.md#is)( **ctype**\< **CharType**>:: **alpha**, `Ch`). ### Example @@ -222,7 +207,7 @@ The locale containing the element to be tested. ### Remarks -The template function returns [use_facet](../standard-library/locale-functions.md#use_facet)< [ctype](../standard-library/ctype-class.md)\< **CharType**> >( `Loc`). [is](../standard-library/ctype-class.md#is)( **ctype**\< **CharType**>:: **cntrl**, `Ch`). +The template function returns [use_facet](../standard-library/locale-functions.md#use_facet)< [ctype](../standard-library/ctype-class.md)\< **CharType**> >(`Loc`). [is](../standard-library/ctype-class.md#is)( **ctype**\< **CharType**>:: **cntrl**, `Ch`). ### Example @@ -287,7 +272,7 @@ The locale containing the element to be tested. ### Remarks -The template function returns [use_facet](../standard-library/locale-functions.md#use_facet)< [ctype](../standard-library/ctype-class.md)\< **CharType**> >( `Loc`). [is](../standard-library/ctype-class.md#is)( **ctype**\< **CharType**>:: **digit**, `Ch`). +The template function returns [use_facet](../standard-library/locale-functions.md#use_facet)< [ctype](../standard-library/ctype-class.md)\< **CharType**> >(`Loc`). [is](../standard-library/ctype-class.md#is)( **ctype**\< **CharType**>:: **digit**, `Ch`). ### Example @@ -352,7 +337,7 @@ The locale containing the element to be tested. ### Remarks -The template function returns [use_facet](../standard-library/locale-functions.md#use_facet)< [ctype](../standard-library/ctype-class.md)\< **CharType**> >( `Loc`). [is](../standard-library/ctype-class.md#is)( **ctype**\< **CharType**>:: **graph**, `Ch`). +The template function returns [use_facet](../standard-library/locale-functions.md#use_facet)< [ctype](../standard-library/ctype-class.md)\< **CharType**> >(`Loc`). [is](../standard-library/ctype-class.md#is)( **ctype**\< **CharType**>:: **graph**, `Ch`). ### Example @@ -417,7 +402,7 @@ The locale containing the element to be tested. ### Remarks -The template function returns [use_facet](../standard-library/locale-functions.md#use_facet)< [ctype](../standard-library/ctype-class.md)\< **CharType**> >( `Loc`). [is](../standard-library/ctype-class.md#is)( **ctype**\< **CharType**>:: **lower**, `Ch`). +The template function returns [use_facet](../standard-library/locale-functions.md#use_facet)< [ctype](../standard-library/ctype-class.md)\< **CharType**> >(`Loc`). [is](../standard-library/ctype-class.md#is)( **ctype**\< **CharType**>:: **lower**, `Ch`). ### Example @@ -482,7 +467,7 @@ The locale containing the element to be tested. ### Remarks -The template function returns [use_facet](../standard-library/locale-functions.md#use_facet)< [ctype](../standard-library/ctype-class.md)\< **CharType**> >( `Loc`). [is](../standard-library/ctype-class.md#is)( **ctype**\< **CharType**>:: **print**, `Ch`). +The template function returns [use_facet](../standard-library/locale-functions.md#use_facet)< [ctype](../standard-library/ctype-class.md)\< **CharType**> >(`Loc`). [is](../standard-library/ctype-class.md#is)( **ctype**\< **CharType**>:: **print**, `Ch`). ### Example @@ -546,7 +531,7 @@ The locale containing the element to be tested. ### Remarks -The template function returns [use_facet](../standard-library/locale-functions.md#use_facet)`<`[ctype](../standard-library/ctype-class.md)\< **CharType**> >( `Loc`). [is](../standard-library/ctype-class.md#is)( **ctype**\< **CharType**>:: **punct**, `Ch`). +The template function returns [use_facet](../standard-library/locale-functions.md#use_facet)`<`[ctype](../standard-library/ctype-class.md)\< **CharType**> >(`Loc`). [is](../standard-library/ctype-class.md#is)( **ctype**\< **CharType**>:: **punct**, `Ch`). ### Example @@ -611,7 +596,7 @@ The locale containing the element to be tested. ### Remarks -The template function returns [use_facet](../standard-library/locale-functions.md#use_facet)< [ctype](../standard-library/ctype-class.md)\< **CharType**> >( `Loc`). [is](../standard-library/ctype-class.md#is)( **ctype**\< **CharType**>:: **space**, `Ch`). +The template function returns [use_facet](../standard-library/locale-functions.md#use_facet)< [ctype](../standard-library/ctype-class.md)\< **CharType**> >(`Loc`). [is](../standard-library/ctype-class.md#is)( **ctype**\< **CharType**>:: **space**, `Ch`). ### Example @@ -676,7 +661,7 @@ The locale containing the element to be tested. ### Remarks -The template function returns [use_facet](../standard-library/locale-functions.md#use_facet)< [ctype](../standard-library/ctype-class.md)\< **CharType**> >( `Loc`). [is](../standard-library/ctype-class.md#is)( **ctype**\< **CharType**>:: **upper**, `Ch`). +The template function returns [use_facet](../standard-library/locale-functions.md#use_facet)< [ctype](../standard-library/ctype-class.md)\< **CharType**> >(`Loc`). [is](../standard-library/ctype-class.md#is)( **ctype**\< **CharType**>:: **upper**, `Ch`). ### Example @@ -741,7 +726,7 @@ The locale containing the element to be tested. ### Remarks -The template function returns [use_facet](../standard-library/locale-functions.md#use_facet)< [ctype](../standard-library/ctype-class.md)\< **CharType**> >( `Loc`). [is](../standard-library/ctype-class.md#is)( **ctype**\< **CharType**>:: **xdigit**, `Ch`). +The template function returns [use_facet](../standard-library/locale-functions.md#use_facet)< [ctype](../standard-library/ctype-class.md)\< **CharType**> >(`Loc`). [is](../standard-library/ctype-class.md#is)( **ctype**\< **CharType**>:: **xdigit**, `Ch`). Hexadecimal digits use base 16 to represent numbers, using the numbers 0 through 9 plus case-insensitive letters A through F to represent the decimal numbers 0 through 15. @@ -808,7 +793,7 @@ The character converted to lower case. ### Remarks -The template function returns [use_facet](../standard-library/locale-functions.md#use_facet)< [ctype](../standard-library/ctype-class.md)\< **CharType**> >( `Loc`). [tolower](../standard-library/ctype-class.md#tolower)( `Ch`). +The template function returns [use_facet](../standard-library/locale-functions.md#use_facet)< [ctype](../standard-library/ctype-class.md)\< **CharType**> >(`Loc`). [tolower](../standard-library/ctype-class.md#tolower)(`Ch`). ### Example @@ -857,7 +842,7 @@ The character converted to upper case. ### Remarks -The template function returns [use_facet](../standard-library/locale-functions.md#use_facet)< [ctype](../standard-library/ctype-class.md)\< **CharType**> >( `Loc`). [toupper](../standard-library/ctype-class.md#toupper)( `Ch`). +The template function returns [use_facet](../standard-library/locale-functions.md#use_facet)< [ctype](../standard-library/ctype-class.md)\< **CharType**> >(`Loc`). [toupper](../standard-library/ctype-class.md#toupper)(`Ch`). ### Example @@ -918,9 +903,10 @@ int main( ) { locale loc1 ( "German_Germany" ), loc2 ( "English_Australia" ); bool result1 = use_facet > ( loc1 ).is( - ctype_base::alpha, 'a' -); - bool result2 = use_facet > ( loc2 ).is( ctype_base::alpha, '!' + ctype_base::alpha, 'a' + ); + bool result2 = use_facet > ( loc2 ).is( + ctype_base::alpha, '!' ); if ( result1 ) diff --git a/docs/standard-library/logic-error-class.md b/docs/standard-library/logic-error-class.md index 63f9e82219b..6d096245bda 100644 --- a/docs/standard-library/logic-error-class.md +++ b/docs/standard-library/logic-error-class.md @@ -1,12 +1,11 @@ --- -description: "Learn more about: logic_error Class" -title: "logic_error Class" -ms.date: "09/09/2021" +title: "logic_error class" +description: "Learn more about: logic_error class" +ms.date: 09/09/2021 f1_keywords: ["stdexcept/std::logic_error"] helpviewer_keywords: ["logic_error class"] -ms.assetid: b290d73d-94e1-4288-af86-2bb5d71f677a --- -# logic_error Class +# `logic_error` class The class serves as the base class for all exceptions thrown to report errors presumably detectable before the program executes, such as violations of logical preconditions. @@ -18,13 +17,12 @@ public: explicit logic_error(const string& message); explicit logic_error(const char *message); - }; ``` ## Remarks -The value returned by `what()` is a copy of `message.data()`. For more information, see [`what`](../standard-library/exception-class.md) and [`data`](../standard-library/basic-string-class.md#data). +The value returned by `what()` is a copy of `message.data()`. For more information, see [`what`](exception-class.md) and [`data`](basic-string-class.md#data). ## Example @@ -49,19 +47,20 @@ int main() cerr << "Type: " << typeid(e).name() << endl; } } -/* Output: +``` + +```Output Caught: Does not compute! Type: class std::logic_error -*/ ``` ## Requirements -**Header:** \ +**Header:** `` -**Namespace:** std +**Namespace:** `std` ## See also -[exception Class](../standard-library/exception-class.md)\ -[Thread Safety in the C++ Standard Library](../standard-library/thread-safety-in-the-cpp-standard-library.md) +[`exception` class](exception-class.md)\ +[Thread Safety in the C++ Standard Library](thread-safety-in-the-cpp-standard-library.md) diff --git a/docs/standard-library/logical-or-struct.md b/docs/standard-library/logical-or-struct.md index 52d41902453..47d9f120cb2 100644 --- a/docs/standard-library/logical-or-struct.md +++ b/docs/standard-library/logical-or-struct.md @@ -1,14 +1,13 @@ --- -description: "Learn more about: logical_or Struct" title: "logical_or Struct" -ms.date: "11/04/2016" +description: "Learn more about: logical_or Struct" +ms.date: 11/04/2016 f1_keywords: ["functional/std::logical_or"] helpviewer_keywords: ["logical_or class", "logical_or struct"] -ms.assetid: ec8143f8-5755-4e7b-8025-507fb6bf6911 --- # logical_or Struct -A predefined function object that performs the logical disjunction operation ( `operator||`) on its arguments. +A predefined function object that performs the logical disjunction operation (`operator||`) on its arguments. ## Syntax diff --git a/docs/standard-library/map-class.md b/docs/standard-library/map-class.md index 264d13d1e06..6cc7a34dabd 100644 --- a/docs/standard-library/map-class.md +++ b/docs/standard-library/map-class.md @@ -1,7 +1,7 @@ --- title: "map Class" description: "API reference for the C++ Standard Template Library (STL) `map` class, which is used for the storage and retrieval of data from a collection in which each element is a pair that has both a data value and a sort key." -ms.date: "9/10/2020" +ms.date: 9/10/2020 f1_keywords: ["map/std::map", "map/std::map::allocator_type", "map/std::map::const_iterator", "map/std::map::const_pointer", "map/std::map::const_reference", "map/std::map::const_reverse_iterator", "map/std::map::difference_type", "map/std::map::iterator", "map/std::map::key_compare", "map/std::map::key_type", "map/std::map::mapped_type", "map/std::map::pointer", "map/std::map::reference", "map/std::map::reverse_iterator", "map/std::map::size_type", "map/std::map::value_type", "map/std::map::at", "map/std::map::begin", "map/std::map::cbegin", "map/std::map::cend", "map/std::map::clear", "map/std::map::count", "map/std::map::contains", "map/std::map::crbegin", "map/std::map::crend", "map/std::map::emplace", "map/std::map::emplace_hint", "map/std::map::empty", "map/std::map::end", "map/std::map::equal_range", "map/std::map::erase", "map/std::map::find", "map/std::map::get_allocator", "map/std::map::insert", "map/std::map::key_comp", "map/std::map::lower_bound", "map/std::map::max_size", "map/std::map::rbegin", "map/std::map::rend", "map/std::map::size", "map/std::map::swap", "map/std::map::upper_bound", "map/std::map::value_comp"] helpviewer_keywords: ["std::map [C++]", "std::map [C++], allocator_type", "std::map [C++], const_iterator", "std::map [C++], const_pointer", "std::map [C++], const_reference", "std::map [C++], const_reverse_iterator", "std::map [C++], difference_type", "std::map [C++], iterator", "std::map [C++], key_compare", "std::map [C++], key_type", "std::map [C++], mapped_type", "std::map [C++], pointer", "std::map [C++], reference", "std::map [C++], reverse_iterator", "std::map [C++], size_type", "std::map [C++], value_type", "std::map [C++], at", "std::map [C++], begin", "std::map [C++], cbegin", "std::map [C++], cend", "std::map [C++], clear", "std::map [C++], count", "std::map [C++], contains", "std::map [C++], crbegin", "std::map [C++], crend", "std::map [C++], emplace", "std::map [C++], emplace_hint", "std::map [C++], empty", "std::map [C++], end", "std::map [C++], equal_range", "std::map [C++], erase", "std::map [C++], find", "std::map [C++], get_allocator", "std::map [C++], insert", "std::map [C++], key_comp", "std::map [C++], lower_bound", "std::map [C++], max_size", "std::map [C++], rbegin", "std::map [C++], rend", "std::map [C++], size", "std::map [C++], swap", "std::map [C++], upper_bound", "std::map [C++], value_comp"] --- @@ -32,7 +32,7 @@ The element data type to be stored in the `map`. *`Traits`*\ The type that provides a function object that can compare two element values as sort keys to determine their relative order in the `map`. This argument is optional and the binary predicate `less` is the default value. -In C++14, you can enable heterogeneous lookup by specifying the `std::less<>` predicate that has no type parameters. See [Heterogeneous Lookup in Associative Containers](../standard-library/stl-containers.md#sequence_containers) for more information. +In C++14, you can enable heterogeneous lookup by specifying the `std::less<>` predicate that has no type parameters. See [Heterogeneous Lookup in Associative Containers](stl-containers.md#heterogeneous-lookup-in-associative-containers) for more information. *`Allocator`*\ The type that represents the stored allocator object that encapsulates details about the map's allocation and deallocation of memory. This argument is optional and the default value is `allocator >`. @@ -64,7 +64,7 @@ The map orders the elements it controls by calling a stored function object of t > [!NOTE] > The comparison function is a binary predicate that induces a strict weak ordering in the standard mathematical sense. A binary predicate f(x,y) is a function object that has two argument objects x and y, and a return value of **`true`** or **`false`**. An ordering imposed on a set is a strict weak ordering if the binary predicate is irreflexive, antisymmetric, and transitive, and if equivalence is transitive, where two objects x and y are defined to be equivalent when both f(x,y) and f(y,x) are **`false`**. If the stronger condition of equality between keys replaces that of equivalence, the ordering becomes total (in the sense that all the elements are ordered with regard to one other), and the keys matched will be indiscernible from one other. > -> In C++14, you can enable heterogeneous lookup by specifying the `std::less<>` or `std::greater<>` predicate that has no type parameters. See [Heterogeneous Lookup in Associative Containers](../standard-library/stl-containers.md#sequence_containers) for more information. +> In C++14, you can enable heterogeneous lookup by specifying the `std::less<>` or `std::greater<>` predicate that has no type parameters. See [Heterogeneous Lookup in Associative Containers](stl-containers.md#heterogeneous-lookup-in-associative-containers) for more information. ## Members @@ -552,12 +552,12 @@ The element's key value to look for. `contains()` is new in C++20. To use it, specify the [`/std:c++20`](../build/reference/std-specify-language-standard-version.md) or later compiler option. -`template bool contains(const K& key) const` only participates in overload resolution if `key_compare` is transparent. See [Heterogeneous lookup in associative containers](./stl-containers.md#heterogeneous-lookup-in-associative-containers-c14) for more information. +`template bool contains(const K& key) const` only participates in overload resolution if `key_compare` is transparent. See [Heterogeneous lookup in associative containers](stl-containers.md#heterogeneous-lookup-in-associative-containers) for more information. ### Example ```cpp -// Requires /std:c++20 or /std:c++latest +// Requires /std:c++20 or later #include #include #include @@ -991,7 +991,7 @@ The argument key value to be compared with the sort key of an element from the m ### Return Value -To access the first iterator of a pair `pr` returned by the member function, use `pr`. **first**, and to dereference the lower bound iterator, use \*( `pr`. **first**). To access the second iterator of a pair `pr` returned by the member function, use `pr`. **second**, and to dereference the upper bound iterator, use \*( `pr`. **second**). +To access the first iterator of a pair `pr` returned by the member function, use `pr`. **first**, and to dereference the lower bound iterator, use \*(`pr`. **first**). To access the second iterator of a pair `pr` returned by the member function, use `pr`. **second**, and to dereference the upper bound iterator, use \*(`pr`. **second**). ### Example diff --git a/docs/standard-library/map-functions.md b/docs/standard-library/map-functions.md index 29e85f2cf33..6567b76e850 100644 --- a/docs/standard-library/map-functions.md +++ b/docs/standard-library/map-functions.md @@ -1,9 +1,8 @@ --- -description: "Learn more about: functions" title: " functions" -ms.date: "11/04/2016" +description: "Learn more about: functions" +ms.date: 11/04/2016 f1_keywords: ["map/std::swap (map)", "map/std::swap (multimap)"] -ms.assetid: 7cb3d1a5-7add-4726-a73f-61927eafd466 --- # `` functions @@ -14,8 +13,8 @@ Exchanges the elements of two maps. ```cpp template void swap( - map& left, - map& right); + map& left, + map& right); ``` ### Parameters @@ -28,7 +27,7 @@ The map whose elements are to be exchanged with those of the map *right*. ### Remarks -The template function is an algorithm specialized on the container class map to execute the member function `left`.[swap](../standard-library/map-class.md#swap)( `right`). This is an instance of the partial ordering of function templates by the compiler. When template functions are overloaded in such a way that the match of the template with the function call is not unique, then the compiler will select the most specialized version of the template function. The general version of the template function, **`template`** \< **class T**> **void swap**( **T&**, **T&**), in the algorithm class works by assignment and is a slow operation. The specialized version in each container is much faster as it can work with the internal representation of the container class. +The template function is an algorithm specialized on the container class map to execute the member function `left`.[swap](../standard-library/map-class.md#swap)(`right`). This is an instance of the partial ordering of function templates by the compiler. When template functions are overloaded in such a way that the match of the template with the function call is not unique, then the compiler will select the most specialized version of the template function. The general version of the template function, **`template`** \< **class T**> **void swap**( **T&**, **T&**), in the algorithm class works by assignment and is a slow operation. The specialized version in each container is much faster as it can work with the internal representation of the container class. ### Example @@ -41,8 +40,8 @@ Exchanges the elements of two multimaps. ```cpp template void swap( - multimap& left, - multimap& right); + multimap& left, + multimap& right); ``` ### Parameters diff --git a/docs/standard-library/memory-functions.md b/docs/standard-library/memory-functions.md index 7476c9e8b9b..5de848e295b 100644 --- a/docs/standard-library/memory-functions.md +++ b/docs/standard-library/memory-functions.md @@ -1,13 +1,14 @@ --- -description: "Learn more about: functions" title: " functions" -ms.date: "08/05/2019" +description: "Learn more about: functions" +ms.date: 08/05/2019 f1_keywords: ["memory/std::addressof", "memory/std::align", "memory/std::allocate_shared", "memory/std::const_pointer_cast", "memory/std::declare_no_pointers", "memory/std::declare_reachable", "memory/std::dynamic_pointer_cast", "memory/std::get_deleter", "memory/std::get_pointer_safety", "memory/std::get_temporary_buffer", "xmemory/std::get_temporary_buffer", "memory/std::make_shared", "memory/std::make_unique", "memory/std::owner_less", "memory/std::reinterpret_pointer_cast", "memory/std::return_temporary_buffer", "xmemory/std::return_temporary_buffer", "memory/std::static_pointer_cast", "memory/std::swap", "memory/std::undeclare_no_pointers", "memory/std::undeclare_reachable", "memory/std::uninitialized_copy", "memory/std::uninitialized_copy_n", "memory/std::uninitialized_fill", "memory/std::uninitialized_fill_n"] -ms.assetid: 3e1898c2-44b7-4626-87ce-84962e4c6f1a helpviewer_keywords: ["std::addressof [C++]", "std::align [C++]", "std::allocate_shared [C++]", "std::const_pointer_cast [C++]", "std::declare_no_pointers [C++]", "std::declare_reachable [C++]", "std::default_delete [C++]", "std::dynamic_pointer_cast [C++]", "std::get_deleter [C++]", "std::get_pointer_safety [C++]", "std::get_temporary_buffer [C++]", "std::make_shared [C++]", "std::make_unique [C++]", "std::owner_less [C++]", "std::return_temporary_buffer [C++]", "std::static_pointer_cast [C++]", "std::swap [C++]", "std::undeclare_no_pointers [C++]", "std::undeclare_reachable [C++]", "std::uninitialized_copy [C++]", "std::uninitialized_copy_n [C++]", "std::uninitialized_fill [C++]", "std::uninitialized_fill_n [C++]", "std::addressof [C++]", "std::align [C++]", "std::allocate_shared [C++]", "std::const_pointer_cast [C++]", "std::declare_no_pointers [C++]", "std::declare_reachable [C++]", "std::default_delete [C++]", "std::dynamic_pointer_cast [C++]", "std::get_deleter [C++]", "std::get_pointer_safety [C++]", "std::get_temporary_buffer [C++]", "std::make_shared [C++]", "std::make_unique [C++]", "std::owner_less [C++]", "std::return_temporary_buffer [C++]", "std::static_pointer_cast [C++]", "std::undeclare_no_pointers [C++]", "std::undeclare_reachable [C++]", "std::uninitialized_copy [C++]", "std::uninitialized_copy_n [C++]", "std::uninitialized_fill [C++]", "std::uninitialized_fill_n [C++]"] --- # `` functions +The `` header provides the following functions: + ## `addressof` Gets the true address of an object. @@ -35,8 +36,6 @@ The object or function for which to obtain the true address. The actual address of the object or function referenced by *`value`*, even if an overloaded `operator&()` exists. -### Remarks - ## `align` Fits storage of the given size, aligned by the given alignment specification, into the first possible address of the given storage. @@ -768,6 +767,7 @@ struct owner_less> template struct owner_less> +{ bool operator()( const weak_ptr& left, const weak_ptr& right) const noexcept; diff --git a/docs/standard-library/memory-operators.md b/docs/standard-library/memory-operators.md index 0ae10aa886c..6fb628d3e2a 100644 --- a/docs/standard-library/memory-operators.md +++ b/docs/standard-library/memory-operators.md @@ -1,9 +1,8 @@ --- -description: "Learn more about: operators" title: " operators" -ms.date: "11/04/2016" +description: "Learn more about: operators" +ms.date: 11/04/2016 f1_keywords: ["memory/std::operator!=", "memory/std::operator>", "memory/std::operator>=", "memory/std::operator<", "memory/std::operator<=", "memory/std::operator<<", "memory/std::operator=="] -ms.assetid: 257e3ba9-c4c2-4ae8-9b11-b156ba9c28de --- # `` operators @@ -127,7 +126,7 @@ bool operator==( template bool operator==( - const shared_ptr& left;, + const shared_ptr& left, const shared_ptr& right); ``` @@ -330,7 +329,7 @@ Tests for one object being greater than a second object. template bool operator>( const unique_ptr& left, - const unique_ptr& right); template bool operator>( diff --git a/docs/standard-library/memory.md b/docs/standard-library/memory.md index 336706d3f92..5e3a65200e2 100644 --- a/docs/standard-library/memory.md +++ b/docs/standard-library/memory.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: " title: "" -ms.date: "08/04/2019" +description: "Learn more about: " +ms.date: 08/04/2019 f1_keywords: [""] helpviewer_keywords: ["memory header"] --- @@ -74,7 +74,7 @@ Defines a class, an operator, and several templates that help allocate and free |[operator==](../standard-library/memory-operators.md#op_eq_eq)|Tests for equality between allocator objects of a specified class.| |[operator>=](../standard-library/memory-operators.md#op_gt_eq)|Tests for one allocator object being greater than or equal to a second allocator object, of a specified class.| |[operator<](../standard-library/memory-operators.md#op_lt)|Tests for one object being less than a second object of a specified class.| -|[operator\<=](../standard-library/memory-operators.md#op_gt_eq)|Tests for one object being less than or equal to a second object of a specified class.| +|[operator\<=](../standard-library/memory-operators.md#op_lt_eq)|Tests for one object being less than or equal to a second object of a specified class.| |[operator>](../standard-library/memory-operators.md#op_gt)|Tests for one object being greater than a second object of a specified class.| |[operator<<](../standard-library/memory-operators.md#op_lt_lt)|`shared_ptr` inserter.| diff --git a/docs/standard-library/messages-byname-class.md b/docs/standard-library/messages-byname-class.md index cf22a906dd6..fe6b2c1f59e 100644 --- a/docs/standard-library/messages-byname-class.md +++ b/docs/standard-library/messages-byname-class.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: messages_byname Class" title: "messages_byname Class" -ms.date: "11/04/2016" +description: "Learn more about: messages_byname Class" +ms.date: 11/04/2016 f1_keywords: ["xlocmes/std::messages_byname"] helpviewer_keywords: ["messages_byname class"] -ms.assetid: c6c64841-3e80-43c8-b54c-fed41833ad6b --- # messages_byname Class @@ -40,7 +39,7 @@ An initial reference count. ## Remarks -Its behavior is determined by the named locale *_Locname*. Each constructor initializes its base object with [messages](../standard-library/messages-class.md#messages)\( `_Refs`). +Its behavior is determined by the named locale *_Locname*. Each constructor initializes its base object with [messages](../standard-library/messages-class.md#messages)\(`_Refs`). ## Requirements diff --git a/docs/standard-library/messages-class.md b/docs/standard-library/messages-class.md index 7468f6fb3c1..4797d927f91 100644 --- a/docs/standard-library/messages-class.md +++ b/docs/standard-library/messages-class.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: messages Class" title: "messages Class" -ms.date: "11/04/2016" +description: "Learn more about: messages Class" +ms.date: 11/04/2016 f1_keywords: ["xlocmes/std::messages", "xlocmes/std::messages::char_type", "xlocmes/std::messages::string_type", "xlocmes/std::messages::close", "xlocmes/std::messages::do_close", "xlocmes/std::messages::do_get", "xlocmes/std::messages::do_open", "xlocmes/std::messages::get", "xlocmes/std::messages::open"] helpviewer_keywords: ["std::messages [C++]", "std::messages [C++], char_type", "std::messages [C++], string_type", "std::messages [C++], close", "std::messages [C++], do_close", "std::messages [C++], do_get", "std::messages [C++], do_open", "std::messages [C++], get", "std::messages [C++], open"] -ms.assetid: c4c71f40-4f24-48ab-9f7c-daccd8d5bd83 --- # messages Class @@ -214,7 +213,7 @@ It returns a copy of *_Dfault* on failure. Otherwise, it returns a copy of the s ### Remarks -The member function returns [do_get](#do_get)( `_Catval`, `_Set`, `_Message`, `_Dfault`). +The member function returns [do_get](#do_get)(`_Catval`, `_Set`, `_Message`, `_Dfault`). ## messages::messages @@ -249,7 +248,7 @@ The possible values for the *_Refs* parameter and their significance are: No direct examples are possible, because the destructor is protected. -The constructor initializes its base object with **locale::**[facet](../standard-library/locale-class.md#facet_class)( `_Refs`). +The constructor initializes its base object with **locale::**[facet](../standard-library/locale-class.md#facet_class)(`_Refs`). ## messages::open @@ -275,7 +274,7 @@ It returns a value that compares less than zero on failure. Otherwise, the retur ### Remarks -The member function returns [do_open](#do_open)( `_Catname`, `_Loc`). +The member function returns [do_open](#do_open)(`_Catname`, `_Loc`). ## messages::string_type diff --git a/docs/standard-library/money-get-class.md b/docs/standard-library/money-get-class.md index 3adbf050df9..275a645404d 100644 --- a/docs/standard-library/money-get-class.md +++ b/docs/standard-library/money-get-class.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: money_get Class" title: "money_get Class" -ms.date: "11/04/2016" +description: "Learn more about: money_get Class" +ms.date: 11/04/2016 f1_keywords: ["xlocmon/std::money_get", "xlocmon/std::money_get::char_type", "xlocmon/std::money_get::iter_type", "xlocmon/std::money_get::string_type", "xlocmon/std::money_get::do_get", "xlocmon/std::money_get::get"] helpviewer_keywords: ["std::money_get [C++]", "std::money_get [C++], char_type", "std::money_get [C++], iter_type", "std::money_get [C++], string_type", "std::money_get [C++], do_get", "std::money_get [C++], get"] -ms.assetid: 692d3374-3fe7-4b46-8aeb-f8d91ed66b2e --- # money_get Class @@ -112,7 +111,7 @@ An input iterator addressing the first element beyond the monetary input field. ### Remarks -The first virtual protected member function tries to match sequential elements beginning at first in the sequence [ `first`, `last`) until it has recognized a complete, nonempty monetary input field. If successful, it converts this field to a sequence of one or more decimal digits, optionally preceded by a minus sign ( `-`), to represent the amount and stores the result in the [string_type](#string_type) object *val*. It returns an iterator designating the first element beyond the monetary input field. Otherwise, the function stores an empty sequence in *val* and sets `ios_base::failbit` in *State*. It returns an iterator designating the first element beyond any prefix of a valid monetary input field. In either case, if the return value equals `last`, the function sets `ios_base::eofbit` in `State`. +The first virtual protected member function tries to match sequential elements beginning at first in the sequence [ `first`, `last`) until it has recognized a complete, nonempty monetary input field. If successful, it converts this field to a sequence of one or more decimal digits, optionally preceded by a minus sign (`-`), to represent the amount and stores the result in the [string_type](#string_type) object *val*. It returns an iterator designating the first element beyond the monetary input field. Otherwise, the function stores an empty sequence in *val* and sets `ios_base::failbit` in *State*. It returns an iterator designating the first element beyond any prefix of a valid monetary input field. In either case, if the return value equals `last`, the function sets `ios_base::eofbit` in `State`. The second virtual protected member function behaves the same as the first, except that if successful it converts the optionally signed digit sequence to a value of type **`long double`** and stores that value in *val*. @@ -242,7 +241,7 @@ int main( ) else cout << "money_get(" << psz2.str( ) << ", intl = 0) = " << fVal/100.0 << endl; -}; +} ``` ## money_get::iter_type diff --git a/docs/standard-library/money-put-class.md b/docs/standard-library/money-put-class.md index b6133994842..af0388fc0bb 100644 --- a/docs/standard-library/money-put-class.md +++ b/docs/standard-library/money-put-class.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: money_put Class" title: "money_put Class" -ms.date: "11/01/2018" +description: "Learn more about: money_put Class" +ms.date: 11/01/2018 f1_keywords: ["xlocmon/std::money_put", "xlocmon/std::money_put::char_type", "xlocmon/std::money_put::iter_type", "xlocmon/std::money_put::string_type", "xlocmon/std::money_put::do_put", "xlocmon/std::money_put::put"] helpviewer_keywords: ["std::money_put [C++]", "std::money_put [C++], char_type", "std::money_put [C++], iter_type", "std::money_put [C++], string_type", "std::money_put [C++], do_put", "std::money_put [C++], put"] -ms.assetid: f439fd56-c9b1-414c-95e1-66c918c6eee6 --- # money_put Class @@ -189,7 +188,7 @@ The possible values for the *_Refs* parameter and their significance are: No direct examples are possible, because the destructor is protected. -The constructor initializes its base object with **locale::**[facet](../standard-library/locale-class.md#facet_class)( `_Refs`). +The constructor initializes its base object with **locale::**[facet](../standard-library/locale-class.md#facet_class)(`_Refs`). ## money_put::put @@ -234,7 +233,7 @@ An output iterator the addresses the position one beyond the last element produc ### Remarks -Both member functions return [do_put](#do_put)( `next`, `_Intl`, `_Iosbase`, `_Fill`, `val`). +Both member functions return [do_put](#do_put)(`next`, `_Intl`, `_Iosbase`, `_Fill`, `val`). ### Example diff --git a/docs/standard-library/moneypunct-byname-class.md b/docs/standard-library/moneypunct-byname-class.md index 701923e297c..9fb1ed976d7 100644 --- a/docs/standard-library/moneypunct-byname-class.md +++ b/docs/standard-library/moneypunct-byname-class.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: moneypunct_byname Class" title: "moneypunct_byname Class" -ms.date: "11/04/2016" +description: "Learn more about: moneypunct_byname Class" +ms.date: 11/04/2016 f1_keywords: ["xlocmon/std::moneypunct_byname"] helpviewer_keywords: ["moneypunct_byname class"] -ms.assetid: e8a544d2-6aee-420d-b513-deb385c9b416 --- # moneypunct_byname Class @@ -33,7 +32,7 @@ protected: ## Remarks -Its behavior is determined by the named locale `_Locname`. Each constructor initializes its base object with [moneypunct](../standard-library/moneypunct-class.md#moneypunct)\( `_Refs`). +Its behavior is determined by the named locale `_Locname`. Each constructor initializes its base object with [moneypunct](../standard-library/moneypunct-class.md#moneypunct)\(`_Refs`). ## Requirements diff --git a/docs/standard-library/moneypunct-class.md b/docs/standard-library/moneypunct-class.md index 04d76312616..2e5d3962502 100644 --- a/docs/standard-library/moneypunct-class.md +++ b/docs/standard-library/moneypunct-class.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: moneypunct Class" title: "moneypunct Class" -ms.date: "11/04/2016" +description: "Learn more about: moneypunct Class" +ms.date: 11/04/2016 f1_keywords: ["xlocmon/std::moneypunct", "xlocmon/std::moneypunct::char_type", "xlocmon/std::moneypunct::string_type", "xlocmon/std::moneypunct::curr_symbol", "xlocmon/std::moneypunct::decimal_point", "xlocmon/std::moneypunct::do_curr_symbol", "xlocmon/std::moneypunct::do_decimal_point", "xlocmon/std::moneypunct::do_frac_digits", "xlocmon/std::moneypunct::do_grouping", "xlocmon/std::moneypunct::do_neg_format", "xlocmon/std::moneypunct::do_negative_sign", "xlocmon/std::moneypunct::do_pos_format", "xlocmon/std::moneypunct::do_positive_sign", "xlocmon/std::moneypunct::do_thousands_sep", "xlocmon/std::moneypunct::frac_digits", "xlocmon/std::moneypunct::grouping", "xlocmon/std::moneypunct::neg_format", "xlocmon/std::moneypunct::negative_sign", "xlocmon/std::moneypunct::pos_format", "xlocmon/std::moneypunct::positive_sign", "xlocmon/std::moneypunct::thousands_sep"] helpviewer_keywords: ["std::moneypunct [C++]", "std::moneypunct [C++], char_type", "std::moneypunct [C++], string_type", "std::moneypunct [C++], curr_symbol", "std::moneypunct [C++], decimal_point", "std::moneypunct [C++], do_curr_symbol", "std::moneypunct [C++], do_decimal_point", "std::moneypunct [C++], do_frac_digits", "std::moneypunct [C++], do_grouping", "std::moneypunct [C++], do_neg_format", "std::moneypunct [C++], do_negative_sign", "std::moneypunct [C++], do_pos_format", "std::moneypunct [C++], do_positive_sign", "std::moneypunct [C++], do_thousands_sep", "std::moneypunct [C++], frac_digits", "std::moneypunct [C++], grouping", "std::moneypunct [C++], neg_format", "std::moneypunct [C++], negative_sign", "std::moneypunct [C++], pos_format", "std::moneypunct [C++], positive_sign", "std::moneypunct [C++], thousands_sep"] -ms.assetid: cf2650da-3e6f-491c-95d5-23e57f582ee6 --- # moneypunct Class @@ -119,7 +118,7 @@ int main( ) const moneypunct < char, false> &mpunct2 = use_facet < moneypunct < char, false> >(loc); cout << loc.name( ) << " domestic currency symbol "<< mpunct2.curr_symbol( ) << endl; -}; +} ``` ## moneypunct::decimal_point @@ -593,7 +592,7 @@ int main( ) use_facet >(loc2); cout << loc2.name( ) << " domestic negative sign: " << mpunct4.negative_sign( ) << endl; -}; +} ``` ```Output @@ -703,7 +702,7 @@ int main( ) use_facet >(loc2); cout << loc2.name( ) << " domestic positive sign:" << mpunct4.positive_sign( ) << endl; -}; +} ``` ```Output diff --git a/docs/standard-library/month-class.md b/docs/standard-library/month-class.md index 047db99cf28..f43deea25ab 100644 --- a/docs/standard-library/month-class.md +++ b/docs/standard-library/month-class.md @@ -1,12 +1,12 @@ --- -description: "Learn more about: month Class" title: "month class" -ms.date: "6/25/2021" +description: "Learn more about: month Class" +ms.date: 6/25/2021 f1_keywords: ["chrono/std::chrono::month", "chrono/std::chrono::month::January", "chrono/std::chrono::month::February", "chrono/std::chrono::month::March","chrono/std::chrono::month::April","chrono/std::chrono::month::May","chrono/std::chrono::month::June","chrono/std::chrono::month::July","chrono/std::chrono::month::August","chrono/std::chrono::month::September","chrono/std::chrono::month::October","chrono/std::chrono::month::November","chrono/std::chrono::month::December","chrono/std::chrono::month::operator++", "chrono/std::chrono::month::operator--", "chrono/std::chrono::month::operator unsigned", "chrono/std::chrono::month::ok"] helpviewer_keywords: ["std::chrono [C++], month"] dev_langs: ["C++"] --- -# `month` class +# `month` class Represents a month of a year. For example, July. diff --git a/docs/standard-library/month-day-class.md b/docs/standard-library/month-day-class.md index a84c17ac088..f8f80f65f9a 100644 --- a/docs/standard-library/month-day-class.md +++ b/docs/standard-library/month-day-class.md @@ -1,13 +1,13 @@ --- -description: "Learn more about: month_day Class" title: "month_day class" -ms.date: "6/28/2021" +description: "Learn more about: month_day Class" +ms.date: 6/28/2021 f1_keywords: ["chrono/std::chrono::month_day", "chrono/std::chrono::month_day::day", "chrono/std::chrono::month_day::month", "chrono/std::chrono::month_day::ok"] helpviewer_keywords: ["std::chrono [C++], month_day"] dev_langs: ["C++"] --- -# `month_day` class +# `month_day` class Represents a specific day of a specific month. The year isn't specified. diff --git a/docs/standard-library/month-day-last-class.md b/docs/standard-library/month-day-last-class.md index bf074911f60..bc2a97a90bc 100644 --- a/docs/standard-library/month-day-last-class.md +++ b/docs/standard-library/month-day-last-class.md @@ -1,13 +1,13 @@ --- -description: "Learn more about: month_day_last Class" title: "month_day_last class" -ms.date: "06/28/2021" +description: "Learn more about: month_day_last Class" +ms.date: 06/28/2021 f1_keywords: ["chrono/std::chrono::month_day_last", "chrono/std::chrono::month_day_last::month", "chrono/std::chrono::month_day_last::ok"] helpviewer_keywords: ["std::chrono [C++], month_day_last"] dev_langs: ["C++"] --- -# `month_day_last` class +# `month_day_last` class Represents the last day of a month. @@ -111,5 +111,5 @@ constexpr bool ok() const noexcept; [`month_day_last` class](month-day-last-class.md)\ [`month_weekday` class](month-weekday-class.md)\ [`month_weekday_last` class](month-weekday-last-class.md)\ -[`operator/`](chrono-operators.md#op_/) -[Header Files Reference](cpp-standard-library-header-files.md) \ No newline at end of file +[`operator/`](chrono-operators.md#op_/)\ +[Header Files Reference](cpp-standard-library-header-files.md) diff --git a/docs/standard-library/month-weekday-class.md b/docs/standard-library/month-weekday-class.md index 0156b703869..a82659be430 100644 --- a/docs/standard-library/month-weekday-class.md +++ b/docs/standard-library/month-weekday-class.md @@ -1,13 +1,13 @@ --- -description: "Learn more about: month_weekday Class" title: "month_weekday class" -ms.date: "06/28/2021" +description: "Learn more about: month_weekday Class" +ms.date: 06/28/2021 f1_keywords: ["chrono/std::chrono::month_weekday", "chrono/std::chrono::month_weekday::weekday", "chrono/std::chrono::month_weekday::month", "chrono/std::chrono::month_weekday::ok", "chrono/std::chrono::month_weekday::weekday_indexed"] helpviewer_keywords: ["std::chrono [C++], month_weekday"] dev_langs: ["C++"] --- -# `month_weekday` class +# `month_weekday` class Represents the nth weekday of a specific month. diff --git a/docs/standard-library/month-weekday-last-class.md b/docs/standard-library/month-weekday-last-class.md index f217ddc7548..9af2b50a786 100644 --- a/docs/standard-library/month-weekday-last-class.md +++ b/docs/standard-library/month-weekday-last-class.md @@ -1,12 +1,12 @@ --- -description: "Learn more about: month_weekday_last Class" title: "month_weekday_last class" -ms.date: "6/28/2021" +description: "Learn more about: month_weekday_last Class" +ms.date: 6/28/2021 f1_keywords: ["chrono/std::chrono::month_weekday_last", "chrono/std::chrono::month_weekday_last::ok", "std::chrono::month_weekday_last::month_weekday_last", "chrono/std::chrono::month_weekday_last::ok", "chrono/std::chrono::month_weekday_last::month"] helpviewer_keywords: ["std::chrono [C++], month_weekday_last"] dev_langs: ["C++"] --- -# `month_weekday_last` class +# `month_weekday_last` class Represents the last weekday of a month. @@ -59,7 +59,7 @@ constexpr month_weekday_last(const month& m, const weekday_last& wdl) noexcept; The `month` value for the created `month_weekday_last` class. *`wdl`*\ -The` weekday_last` value for the created `month_weekday_last` class. +The `weekday_last` value for the created `month_weekday_last` class. ## Remarks: Constructor diff --git a/docs/standard-library/multimap-class.md b/docs/standard-library/multimap-class.md index 5266e0c7029..3db0788cc5f 100644 --- a/docs/standard-library/multimap-class.md +++ b/docs/standard-library/multimap-class.md @@ -1,7 +1,7 @@ --- title: "multimap Class" description: "API reference for the C++ Standard Template Library (STL) `multimap` class, which is used for the storage and retrieval of data from a collection in which each element is a pair that has both a data value and a sort key." -ms.date: "9/9/2020" +ms.date: 9/9/2020 f1_keywords: ["map/std::multimap", "map/std::multimap::allocator_type", "map/std::multimap::const_iterator", "map/std::multimap::const_pointer", "map/std::multimap::const_reference", "map/std::multimap::const_reverse_iterator", "map/std::multimap::difference_type", "map/std::multimap::iterator", "map/std::multimap::key_compare", "map/std::multimap::key_type", "map/std::multimap::mapped_type", "map/std::multimap::pointer", "map/std::multimap::reference", "map/std::multimap::reverse_iterator", "map/std::multimap::size_type", "map/std::multimap::value_type", "map/std::multimap::begin", "map/std::multimap::cbegin", "map/std::multimap::cend", "map/std::multimap::clear", "map/std::multimap::contains", "map/std::multimap::count", "map/std::multimap::crbegin", "map/std::multimap::crend", "map/std::multimap::emplace", "map/std::multimap::emplace_hint", "map/std::multimap::empty", "map/std::multimap::end", "map/std::multimap::equal_range", "map/std::multimap::erase", "map/std::multimap::find", "map/std::multimap::get_allocator", "map/std::multimap::insert", "map/std::multimap::key_comp", "map/std::multimap::lower_bound", "map/std::multimap::max_size", "map/std::multimap::rbegin", "map/std::multimap::rend", "map/std::multimap::size", "map/std::multimap::swap", "map/std::multimap::upper_bound", "map/std::multimap::value_comp"] helpviewer_keywords: ["std::multimap [C++]", "std::multimap [C++], allocator_type", "std::multimap [C++], const_iterator", "std::multimap [C++], const_pointer", "std::multimap [C++], const_reference", "std::multimap [C++], const_reverse_iterator", "std::multimap [C++], difference_type", "std::multimap [C++], iterator", "std::multimap [C++], key_compare", "std::multimap [C++], key_type", "std::multimap [C++], mapped_type", "std::multimap [C++], pointer", "std::multimap [C++], reference", "std::multimap [C++], reverse_iterator", "std::multimap [C++], size_type", "std::multimap [C++], value_type", "std::multimap [C++], begin", "std::multimap [C++], cbegin", "std::multimap [C++], cend", "std::multimap [C++], clear", "std::multimap [C++], contains", "std::multimap [C++], count", "std::multimap [C++], crbegin", "std::multimap [C++], crend", "std::multimap [C++], emplace", "std::multimap [C++], emplace_hint", "std::multimap [C++], empty", "std::multimap [C++], end", "std::multimap [C++], equal_range", "std::multimap [C++], erase", "std::multimap [C++], find", "std::multimap [C++], get_allocator", "std::multimap [C++], insert", "std::multimap [C++], key_comp", "std::multimap [C++], lower_bound", "std::multimap [C++], max_size", "std::multimap [C++], rbegin", "std::multimap [C++], rend", "std::multimap [C++], size", "std::multimap [C++], swap", "std::multimap [C++], upper_bound", "std::multimap [C++], value_comp"] --- @@ -30,7 +30,7 @@ The element data type to be stored in the multimap. *`Traits`*\ The type that provides a function object that can compare two element values as sort keys to determine their relative order in the multimap. The binary predicate `less` is the default value. -In C++14 you can enable heterogeneous lookup by specifying the `std::less<>` or `std::greater<>` predicate that has no type parameters. For more information, see [Heterogeneous Lookup in Associative Containers](../standard-library/stl-containers.md#heterogeneous-lookup-in-associative-containers-c14) +In C++14 you can enable heterogeneous lookup by specifying the `std::less<>` or `std::greater<>` predicate that has no type parameters. For more information, see [Heterogeneous Lookup in Associative Containers](stl-containers.md#heterogeneous-lookup-in-associative-containers) *`Allocator`*\ The type that represents the stored allocator object that encapsulates details about the map's allocation and deallocation of memory. This argument is optional and the default value is `allocator >`. @@ -59,7 +59,7 @@ The `multimap` should be the associative container of choice when the conditions The `multimap` orders the sequence it controls by calling a stored function object of type [`key_compare`](#key_compare). This stored object is a comparison function that may be accessed by calling the member function [`key_comp`](#key_comp). In general, the elements need be merely less than comparable to establish this order: so that, given any two elements, it may be determined either that they are equivalent (in the sense that neither is less than the other) or that one is less than the other. This results in an ordering between the nonequivalent elements. On a more technical note, the comparison function is a binary predicate that induces a strict weak ordering in the standard mathematical sense. A binary predicate `f(x,y)` is a function object that has two argument objects `x` and `y` and a return value of `true` or `false`. An ordering imposed on a set is a strict weak ordering if the binary predicate is irreflexive, antisymmetric, and transitive and if equivalence is transitive, where two objects `x` and `y` are defined to be equivalent when both `f(x,y)` and `f(y,x)` are `false`. If the stronger condition of equality between keys replaces that of equivalence, then the ordering becomes total (in the sense that all the elements are ordered with respect to each other) and the keys matched will be indiscernible from each other. -In C++14 you can enable heterogeneous lookup by specifying the `std::less<>` or `std::greater<>` predicate that has no type parameters. See [Heterogeneous Lookup in Associative Containers](../standard-library/stl-containers.md#sequence_containers) for more information. +In C++14 you can enable heterogeneous lookup by specifying the `std::less<>` or `std::greater<>` predicate that has no type parameters. See [Heterogeneous Lookup in Associative Containers](stl-containers.md#heterogeneous-lookup-in-associative-containers) for more information. ## Members @@ -430,12 +430,12 @@ The element's key value to look for. `contains()` is new in C++20. To use it, specify the [`/std:c++20`](../build/reference/std-specify-language-standard-version.md) or later compiler option. -`template bool contains(const K& key) const` only participates in overload resolution if `key_compare` is transparent. See [Heterogeneous lookup in associative containers](./stl-containers.md#heterogeneous-lookup-in-associative-containers-c14) for more information. +`template bool contains(const K& key) const` only participates in overload resolution if `key_compare` is transparent. See [Heterogeneous lookup in associative containers](stl-containers.md#heterogeneous-lookup-in-associative-containers) for more information. ### Example ```cpp -// Requires /std:c++20 or /std:c++latest +// Requires /std:c++20 or later #include #include #include diff --git a/docs/standard-library/multiset-class.md b/docs/standard-library/multiset-class.md index 1cf0fcb40b9..2ee9fe92c5b 100644 --- a/docs/standard-library/multiset-class.md +++ b/docs/standard-library/multiset-class.md @@ -1,7 +1,7 @@ --- title: "multiset Class" description: "API reference for the C++ Standard Template Library (STL) `multiset` class, which is used for the storage and retrieval of data from a collection in which the values of the elements contained need not be unique and in which they serve as the key values according to which the data is automatically ordered." -ms.date: "9/9/2020" +ms.date: 9/9/2020 f1_keywords: ["set/std::multiset", "set/std::multiset::allocator_type", "set/std::multiset::const_iterator", "set/std::multiset::const_pointer", "set/std::multiset::const_reference", "set/std::multiset::const_reverse_iterator", "set/std::multiset::difference_type", "set/std::multiset::iterator", "set/std::multiset::key_compare", "set/std::multiset::key_type", "set/std::multiset::pointer", "set/std::multiset::reference", "set/std::multiset::reverse_iterator", "set/std::multiset::size_type", "set/std::multiset::value_compare", "set/std::multiset::value_type", "set/std::multiset::begin", "set/std::multiset::cbegin", "set/std::multiset::cend", "set/std::multiset::clear", "set/std::multiset::contains", "set/std::multiset::count", "set/std::multiset::crbegin", "set/std::multiset::crend", "set/std::multiset::emplace", "set/std::multiset::emplace_hint", "set/std::multiset::empty", "set/std::multiset::end", "set/std::multiset::equal_range", "set/std::multiset::erase", "set/std::multiset::find", "set/std::multiset::get_allocator", "set/std::multiset::insert", "set/std::multiset::key_comp", "set/std::multiset::lower_bound", "set/std::multiset::max_size", "set/std::multiset::rbegin", "set/std::multiset::rend", "set/std::multiset::size", "set/std::multiset::swap", "set/std::multiset::upper_bound", "set/std::multiset::value_comp"] helpviewer_keywords: ["std::multiset [C++]", "std::multiset [C++], allocator_type", "std::multiset [C++], const_iterator", "std::multiset [C++], const_pointer", "std::multiset [C++], const_reference", "std::multiset [C++], const_reverse_iterator", "std::multiset [C++], difference_type", "std::multiset [C++], iterator", "std::multiset [C++], key_compare", "std::multiset [C++], key_type", "std::multiset [C++], pointer", "std::multiset [C++], reference", "std::multiset [C++], reverse_iterator", "std::multiset [C++], size_type", "std::multiset [C++], value_compare", "std::multiset [C++], value_type", "std::multiset [C++], begin", "std::multiset [C++], cbegin", "std::multiset [C++], cend", "std::multiset [C++], clear", "std::multiset [C++], contains", "std::multiset [C++], count", "std::multiset [C++], crbegin", "std::multiset [C++], crend", "std::multiset [C++], emplace", "std::multiset [C++], emplace_hint", "std::multiset [C++], empty", "std::multiset [C++], end", "std::multiset [C++], equal_range", "std::multiset [C++], erase", "std::multiset [C++], find", "std::multiset [C++], get_allocator", "std::multiset [C++], insert", "std::multiset [C++], key_comp", "std::multiset [C++], lower_bound", "std::multiset [C++], max_size", "std::multiset [C++], rbegin", "std::multiset [C++], rend", "std::multiset [C++], size", "std::multiset [C++], swap", "std::multiset [C++], upper_bound", "std::multiset [C++], value_comp"] --- @@ -24,7 +24,7 @@ The element data type to be stored in the `multiset`. *`Compare`*\ The type that provides a function object that can compare two element values as sort keys to determine their relative order in the `multiset`. The binary predicate **less**\ is the default value. -In C++14, you can enable heterogeneous lookup by specifying the `std::less<>` or `std::greater<>` predicate that has no type parameters. See [Heterogeneous Lookup in Associative Containers](../standard-library/stl-containers.md#sequence_containers) for more information. +In C++14, you can enable heterogeneous lookup by specifying the `std::less<>` or `std::greater<>` predicate that has no type parameters. See [Heterogeneous Lookup in Associative Containers](stl-containers.md#heterogeneous-lookup-in-associative-containers) for more information. *`Allocator`*\ The type that represents the stored allocator object that encapsulates details about the `multiset`'s allocation and deallocation of memory. The default value is `allocator`. @@ -53,7 +53,7 @@ The `multiset` should be the associative container of choice when the conditions The `multiset` orders the sequence it controls by calling a stored function object of type *`Compare`*. This stored object is a comparison function that may be accessed by calling the member function [`key_comp`](#key_comp). In general, the elements need be merely less than comparable to establish this order: so that, given any two elements, it may be determined either that they're equivalent (in the sense that neither is less than the other) or that one is less than the other. This results in an ordering between the nonequivalent elements. On a more technical note, the comparison function is a binary predicate that induces a strict weak ordering in the standard mathematical sense. A binary predicate *f*(*x*, *y*) is a function object that has two argument objects *x* and *y* and a return value of **`true`** or **`false`**. An ordering imposed on a set is a strict weak ordering if the binary predicate is irreflexive, antisymmetric, and transitive and if equivalence is transitive, where two objects x and y are defined to be equivalent when both *f*(*x,y*) and *f*(*y,x*) are false. If the stronger condition of equality between keys replaces that of equivalence, then the ordering becomes total (in the sense that all the elements are ordered with respect to each other) and the keys matched will be indiscernible from each other. -In C++14, you can enable heterogeneous lookup by specifying the `std::less<>` or `std::greater<>` predicate that has no type parameters. See [Heterogeneous Lookup in Associative Containers](../standard-library/stl-containers.md#sequence_containers) for more information. +In C++14, you can enable heterogeneous lookup by specifying the `std::less<>` or `std::greater<>` predicate that has no type parameters. See [Heterogeneous Lookup in Associative Containers](stl-containers.md#heterogeneous-lookup-in-associative-containers) for more information. ### Constructors @@ -399,12 +399,12 @@ The element's key value to look for. `contains()` is new in C++20. To use it, specify the [/std:c++20](../build/reference/std-specify-language-standard-version.md) or later compiler option. -`template bool contains(const K& key) const` only participates in overload resolution if `key_compare` is transparent. See [Heterogeneous lookup in associative containers](./stl-containers.md#heterogeneous-lookup-in-associative-containers-c14) for more information. +`template bool contains(const K& key) const` only participates in overload resolution if `key_compare` is transparent. See [Heterogeneous lookup in associative containers](stl-containers.md#heterogeneous-lookup-in-associative-containers) for more information. ### Example ```cpp -// Requires /std:c++20 or /std:c++latest +// Requires /std:c++20 or later #include #include @@ -836,7 +836,7 @@ The argument key to be compared with the sort key of an element from the `multis A pair of iterators such that the first is the [`lower_bound`](#lower_bound) of the key and the second is the [`upper_bound`](#upper_bound) of the key. -To access the first iterator of a pair `pr` returned by the member function, use `pr`. **`first`**, and to dereference the lower bound iterator, use \*( `pr`. **`first`**). To access the second iterator of a pair `pr` returned by the member function, use `pr`. **`second`**, and to dereference the upper bound iterator, use \*( `pr`. **`second`**). +To access the first iterator of a pair `pr` returned by the member function, use `pr`. **`first`**, and to dereference the lower bound iterator, use \*(`pr`. **`first`**). To access the second iterator of a pair `pr` returned by the member function, use `pr`. **`second`**, and to dereference the upper bound iterator, use \*(`pr`. **`second`**). ### Example @@ -953,7 +953,7 @@ The key value to be matched by the sort key of an element from the `multiset` be ### Return Value -An iterator that refers to the location of an element with a specified key, or the location succeeding the last element in the `multiset` ( `multiset::end()`) if no match is found for the key. +An iterator that refers to the location of an element with a specified key, or the location succeeding the last element in the `multiset`(`multiset::end()`) if no match is found for the key. ### Remarks @@ -1294,7 +1294,7 @@ The stored object defines the member function: which returns true if *x* strictly precedes *y* in the sort order. -Both [`key_compare`](#key_compare) and [`value_compare`](#value_compare) are synonyms for the template parameter ``Compare``. Both types are provided for the classes set and multiset, where they're identical, for compatibility with the classes map and multimap, where they're distinct. +Both [`key_compare`](#key_compare) and [`value_compare`](#value_compare) are synonyms for the template parameter `Compare`. Both types are provided for the classes set and multiset, where they're identical, for compatibility with the classes map and multimap, where they're distinct. ### Example @@ -1381,7 +1381,7 @@ For more information on `Key`, see the Remarks section of the [`multiset` Class] ### Example -See the example for [`value_type`](#value_type) for an example of how to declare and use ``key_type``. +See the example for [`value_type`](#value_type) for an example of how to declare and use `key_type`. ## `multiset::lower_bound` diff --git a/docs/standard-library/negative-binomial-distribution-class.md b/docs/standard-library/negative-binomial-distribution-class.md index f38c2b51692..ce20bc942ef 100644 --- a/docs/standard-library/negative-binomial-distribution-class.md +++ b/docs/standard-library/negative-binomial-distribution-class.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: negative_binomial_distribution Class" title: "negative_binomial_distribution Class" -ms.date: "11/04/2016" +description: "Learn more about: negative_binomial_distribution Class" +ms.date: 11/04/2016 f1_keywords: ["random/std::negative_binomial_distribution", "random/std::negative_binomial_distribution::reset", "random/std::negative_binomial_distribution::k", "random/std::negative_binomial_distribution::p", "random/std::negative_binomial_distribution::param", "random/std::negative_binomial_distribution::min", "random/std::negative_binomial_distribution::max", "random/std::negative_binomial_distribution::operator()", "random/std::negative_binomial_distribution::param_type", "random/std::negative_binomial_distribution::param_type::k", "random/std::negative_binomial_distribution::param_type::p", "random/std::negative_binomial_distribution::param_type::operator==", "random/std::negative_binomial_distribution::param_type::operator!="] helpviewer_keywords: ["std::negative_binomial_distribution [C++]", "std::negative_binomial_distribution [C++], reset", "std::negative_binomial_distribution [C++], k", "std::negative_binomial_distribution [C++], p", "std::negative_binomial_distribution [C++], param", "std::negative_binomial_distribution [C++], min", "std::negative_binomial_distribution [C++], max", "std::negative_binomial_distribution [C++], param_type", "std::negative_binomial_distribution [C++], param_type"] -ms.assetid: 7f5f0967-7fdd-4578-99d4-88f292b4fe9c --- # negative_binomial_distribution Class @@ -224,15 +223,18 @@ The second constructor constructs an object whose stored parameters are initiali Stores the parameters of the distribution. -struct param_type { - typedef negative_binomial_distribution`<`result_type> distribution_type; - param_type(result_type k = 1, double p = 0.5); - result_type k() const; - double p() const; +```cpp +struct param_type +{ + typedef negative_binomial_distribution distribution_type; + param_type(result_type k = 1, double p = 0.5); + result_type k() const; + double p() const; - bool operator==(const param_type& right) const; - bool operator!=(const param_type& right) const; - }; + bool operator==(const param_type& right) const; + bool operator!=(const param_type& right) const; +}; +``` ### Parameters diff --git a/docs/standard-library/new-functions.md b/docs/standard-library/new-functions.md index 7bcc74e8889..4a7901ce9db 100644 --- a/docs/standard-library/new-functions.md +++ b/docs/standard-library/new-functions.md @@ -1,9 +1,8 @@ --- -description: "Learn more about: functions" title: " functions" +description: "Learn more about: functions" ms.date: "11/04/2016" f1_keywords: ["new/std::get_new_handler", "new/std::nothrow", "new/std::set_new_handler"] -ms.assetid: e250f06a-b025-4509-ae7a-5356d56aad7d --- # `` functions @@ -93,8 +92,8 @@ The function stores *`Pnew`* in a static [`new` handler](../standard-library/new ```cpp // new_set_new_handler.cpp // compile with: /EHsc -#include -#include +#include +#include using namespace std; void __cdecl newhandler( ) diff --git a/docs/standard-library/new-operators.md b/docs/standard-library/new-operators.md index 0df7cbc0715..49e1184de86 100644 --- a/docs/standard-library/new-operators.md +++ b/docs/standard-library/new-operators.md @@ -1,9 +1,8 @@ --- -description: "Learn more about: operators and enums" title: " operators and enums" +description: "Learn more about: operators and enums" ms.date: 05/21/2022 f1_keywords: ["new/std::operator delete", "new/std::operator new"] -ms.assetid: d1af4b56-9a95-4c65-ab01-bf43e982c7bd --- # `` operators and enums @@ -130,8 +129,8 @@ For information on throwing or non-throwing behavior of `new`, see [The `new` an ```cpp // new_op_new.cpp // compile with: /EHsc -#include -#include +#include +#include using namespace std; diff --git a/docs/standard-library/new.md b/docs/standard-library/new.md index 79dfcd6b5b4..09baa6795b1 100644 --- a/docs/standard-library/new.md +++ b/docs/standard-library/new.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: " title: "" -ms.date: "11/04/2016" +description: "Learn more about: " +ms.date: 11/04/2016 f1_keywords: [""] helpviewer_keywords: ["new header"] -ms.assetid: 218e2a15-34e8-4ef3-9122-1e90eccf8559 --- # `` @@ -33,7 +32,7 @@ Some of the functions declared in this header are replaceable. The implementatio |Name|Description| |-|-| |[new_handler](../standard-library/new-typedefs.md#new_handler)|A type that points to a function suitable for use as a new handler.| -|[hardware_constructive_interference_size](../standard-library/new-typedefs.md#hardware_destructive_interference_size)|| +|[hardware_constructive_interference_size](../standard-library/new-typedefs.md#hardware_constructive_interference_size)|| |[hardware_destructive_interference_size](../standard-library/new-typedefs.md#hardware_destructive_interference_size)|| ### Functions diff --git a/docs/standard-library/normal-distribution-class.md b/docs/standard-library/normal-distribution-class.md index db8ba64c3be..e9e4be15c45 100644 --- a/docs/standard-library/normal-distribution-class.md +++ b/docs/standard-library/normal-distribution-class.md @@ -83,7 +83,7 @@ using namespace std; void test(const double m, const double s, const int samples) { // uncomment to use a non-deterministic seed - // random_device gen; + // random_device rd; // mt19937 gen(rd()); mt19937 gen(1701); diff --git a/docs/standard-library/num-put-class.md b/docs/standard-library/num-put-class.md index 2fecf24e5f0..1a9729edc91 100644 --- a/docs/standard-library/num-put-class.md +++ b/docs/standard-library/num-put-class.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: num_put Class" title: "num_put Class" -ms.date: "11/04/2016" +description: "Learn more about: num_put Class" +ms.date: 11/04/2016 f1_keywords: ["xlocnum/std::num_put", "locale/std::num_put::char_type", "locale/std::num_put::iter_type", "locale/std::num_put::do_put", "locale/std::num_put::put"] helpviewer_keywords: ["std::num_put [C++]", "std::num_put [C++], char_type", "std::num_put [C++], iter_type", "std::num_put [C++], do_put", "std::num_put [C++], put"] -ms.assetid: 36c5bffc-8283-4201-8ed4-78c4d81f8a17 --- # num_put Class @@ -384,7 +383,7 @@ An output iterator the addresses the position one beyond the last element produc ### Remarks -All member functions return [do_put](#do_put)( `next`, `_Iosbase`, `_Fill`, `val`). +All member functions return [do_put](#do_put)(`next`, `_Iosbase`, `_Fill`, `val`). ### Example diff --git a/docs/standard-library/numpunct-byname-class.md b/docs/standard-library/numpunct-byname-class.md index 7ab66566f44..5d4feb17983 100644 --- a/docs/standard-library/numpunct-byname-class.md +++ b/docs/standard-library/numpunct-byname-class.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: numpunct_byname Class" title: "numpunct_byname Class" -ms.date: "11/04/2016" +description: "Learn more about: numpunct_byname Class" +ms.date: 11/04/2016 f1_keywords: ["xlocnum/std::numpunct_byname"] helpviewer_keywords: ["numpunct_byname class"] -ms.assetid: 18412924-e085-4771-b5e9-7a200cbdd7c0 --- # numpunct_byname Class @@ -32,7 +31,7 @@ protected: ## Remarks -Its behavior is determined by the [named](../standard-library/locale-class.md#name) locale `_Locname`. The constructor initializes its base object with [numpunct](../standard-library/numpunct-class.md#numpunct)\( `_Refs`). +Its behavior is determined by the [named](../standard-library/locale-class.md#name) locale `_Locname`. The constructor initializes its base object with [numpunct](../standard-library/numpunct-class.md#numpunct)\(`_Refs`). ## Requirements diff --git a/docs/standard-library/numpunct-class.md b/docs/standard-library/numpunct-class.md index d56d1c0b9b0..a0c85da2610 100644 --- a/docs/standard-library/numpunct-class.md +++ b/docs/standard-library/numpunct-class.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: numpunct Class" title: "numpunct Class" -ms.date: "11/04/2016" +description: "Learn more about: numpunct Class" +ms.date: 11/04/2016 f1_keywords: ["xlocnum/std::numpunct", "xlocnum/std::numpunct::char_type", "xlocnum/std::numpunct::string_type", "xlocnum/std::numpunct::decimal_point", "xlocnum/std::numpunct::do_decimal_point", "xlocnum/std::numpunct::do_falsename", "xlocnum/std::numpunct::do_grouping", "xlocnum/std::numpunct::do_thousands_sep", "xlocnum/std::numpunct::do_truename", "xlocnum/std::numpunct::falsename", "xlocnum/std::numpunct::grouping", "xlocnum/std::numpunct::thousands_sep", "xlocnum/std::numpunct::truename"] helpviewer_keywords: ["std::numpunct [C++]", "std::numpunct [C++], char_type", "std::numpunct [C++], string_type", "std::numpunct [C++], decimal_point", "std::numpunct [C++], do_decimal_point", "std::numpunct [C++], do_falsename", "std::numpunct [C++], do_grouping", "std::numpunct [C++], do_thousands_sep", "std::numpunct [C++], do_truename", "std::numpunct [C++], falsename", "std::numpunct [C++], grouping", "std::numpunct [C++], thousands_sep", "std::numpunct [C++], truename"] -ms.assetid: 73fb93cc-ac11-4c98-987c-bfa6267df596 --- # numpunct Class @@ -107,7 +106,7 @@ int main( ) npunct.decimal_point( ) << endl; cout << loc.name( ) << " thousands separator " << npunct.thousands_sep( ) << endl; -}; +} ``` ```Output @@ -378,7 +377,7 @@ int main( ) npunct.decimal_point( ) << endl; cout << loc.name( ) << " thousands separator " << npunct.thousands_sep( ) << endl; -}; +} ``` ```Output diff --git a/docs/standard-library/optional-operators.md b/docs/standard-library/optional-operators.md index 839624fd2d7..99a367665fb 100644 --- a/docs/standard-library/optional-operators.md +++ b/docs/standard-library/optional-operators.md @@ -1,9 +1,8 @@ --- -description: "Learn more about: operators" title: " operators" -ms.date: "11/04/2016" -f1_keywords: ["optional/std::operator!=", "optional/std::operator==", "optional/std::operator>", "optional/std::operator>=;", "optional/std::operator<", "optional/std::operator<="] -ms.assetid: 57492e09-3836-4dbc-9ae5-78ecf506c190 +description: "Learn more about: operators" +ms.date: 11/04/2016 +f1_keywords: ["optional/std::operator!=", "optional/std::operator==", "optional/std::operator>", "optional/std::operator>=;", "optional/std::operator<", "optional/std::operator<="] helpviewer_keywords: ["std::operator!= (optional)", "std::operator== (optional)", "std::operator> (optional)", "std::operator>= (optional)", "std::operator< (optional)", "std::`operator<=` (optional)"] --- # `` operators diff --git a/docs/standard-library/optional.md b/docs/standard-library/optional.md index 776d8b5da68..5a632e0931e 100644 --- a/docs/standard-library/optional.md +++ b/docs/standard-library/optional.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: " title: "" -ms.date: "08/06/2019" +description: "Learn more about: " +ms.date: 08/06/2019 f1_keywords: [""] helpviewer_keywords: [""] --- @@ -26,7 +26,7 @@ Defines the container class template `optional` and several supporting templates |[operator<](../standard-library/optional-operators.md#op_lt)|Tests if the object on the left is less than the object on the right.| |[operator<=](../standard-library/optional-operators.md#op_lt_eq)|Tests if the object on the left is less than or equal to the object on the right.| |[operator>](../standard-library/optional-operators.md#op_gt)|Tests if the object on the left is greater than the object on the right.| -|[operator>=](../standard-library/optional-operators.md#op_lt_eq)|Tests if the object on the left is greater than or equal to the object on the right.| +|[operator>=](../standard-library/optional-operators.md#op_gt_eq)|Tests if the object on the left is greater than or equal to the object on the right.| > [!NOTE] > In addition to relational compares, \ operators also support comparison with **nullopt** and `T`. diff --git a/docs/standard-library/ostream-functions.md b/docs/standard-library/ostream-functions.md index ce0710b50ca..3721ebdd884 100644 --- a/docs/standard-library/ostream-functions.md +++ b/docs/standard-library/ostream-functions.md @@ -1,48 +1,42 @@ --- -description: "Learn more about: functions" title: " functions" -ms.date: "11/04/2016" +description: "Learn more about: functions" +ms.date: 11/04/2016 f1_keywords: ["ostream/std::swap", "ostream/std::endl", "ostream/std::ends", "ostream/std::flush"] -ms.assetid: d6e56cc0-c8df-4dbe-be10-98e14c35ed3a helpviewer_keywords: ["std::swap [C++]", "std::endl [C++]", "std::ends [C++]", "std::flush [C++]"] --- # `` functions -These are the global template functions defined in ``. For member functions, see the [basic_ostream Class](basic-ostream-class.md) documentation. - -[endl](#endl)\ -[ends](#ends)\ -[flush](#flush)\ -[swap](#swap) +These are the global template functions defined in ``. For member functions, see the [`basic_ostream` Class](basic-ostream-class.md) documentation. -## endl +## `endl` Terminates a line and flushes the buffer. ```cpp -template class +template basic_ostream& endl( basic_ostream& Ostr); ``` ### Parameters -*Elem*\ +*`Elem`*\ The element type. -*Ostr*\ -An object of type **basic_ostream**. +*`Ostr`*\ +An object of type **`basic_ostream`**. -*Tr*\ +*`Tr`*\ Character traits. ### Return Value -An object of type **basic_ostream**. +An object of type **`basic_ostream`**. ### Remarks -The manipulator calls *Ostr*.[put](../standard-library/basic-ostream-class.md#put)(*Ostr*.[widen](../standard-library/basic-ios-class.md#widen)('\n')), and then calls *Ostr*.[flush](../standard-library/basic-ostream-class.md#flush). It returns *Ostr*. +The manipulator calls *`Ostr`*.[`put`](../standard-library/basic-ostream-class.md#put)(*`Ostr`*.[`widen`](../standard-library/basic-ios-class.md#widen)('\n')), and then calls *`Ostr`*.[`flush`](../standard-library/basic-ostream-class.md#flush). It returns *`Ostr`*. ### Example @@ -62,25 +56,25 @@ int main( ) testing ``` -## ends +## `ends` Terminates a string. ```cpp -template class +template basic_ostream& ends( basic_ostream& Ostr); ``` ### Parameters -*Elem*\ +*`Elem`*\ The element type. -*Ostr*\ +*`Ostr`*\ An object of type `basic_ostream`. -*Tr*\ +*`Tr`*\ Character traits. ### Return Value @@ -89,7 +83,7 @@ An object of type `basic_ostream`. ### Remarks -The manipulator calls *Ostr*.[put](../standard-library/basic-ostream-class.md#put)(*Elem*('\0')). It returns *Ostr*. +The manipulator calls *`Ostr`*.[`put`](../standard-library/basic-ostream-class.md#put)(*`Elem`*('\0')). It returns *`Ostr`*. ### Example @@ -111,25 +105,25 @@ int main( ) ab c ``` -## flush +## `flush` Flushes the buffer. ```cpp -template class +template basic_ostream& flush( basic_ostream& Ostr); ``` ### Parameters -*Elem*\ +*`Elem`*\ The element type. -*Ostr*\ +*`Ostr`*\ An object of type `basic_ostream`. -*Tr*\ +*`Tr`*\ Character traits. ### Return Value @@ -138,7 +132,7 @@ An object of type `basic_ostream`. ### Remarks -The manipulator calls *Ostr*.[flush](../standard-library/basic-ostream-class.md#flush). It returns *Ostr*. +The manipulator calls *`Ostr`*.[`flush`](../standard-library/basic-ostream-class.md#flush). It returns *`Ostr`*. ### Example @@ -158,7 +152,7 @@ int main( ) testing ``` -## swap +## `swap` Exchanges the values of two `basic_ostream` objects. @@ -171,16 +165,16 @@ void swap( ### Parameters -*Elem*\ +*`Elem`*\ The element type. -*Tr*\ +*`Tr`*\ Character traits. -*left*\ +*`left`*\ An lvalue reference to a `basic_ostream` object. -*right*\ +*`right`*\ An lvalue reference to a `basic_ostream` object. ### Remarks @@ -189,4 +183,4 @@ The template function `swap` executes `left.swap(right)`. ## See also -[\](../standard-library/ostream.md) +[``](../standard-library/ostream.md) diff --git a/docs/standard-library/ostream-iterator-class.md b/docs/standard-library/ostream-iterator-class.md index de3f56cd39c..d3979aaccf5 100644 --- a/docs/standard-library/ostream-iterator-class.md +++ b/docs/standard-library/ostream-iterator-class.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: ostream_iterator Class" title: "ostream_iterator Class" +description: "Learn more about: ostream_iterator Class" ms.date: 06/17/2022 f1_keywords: ["iterator/std::ostream_iterator", "iterator/std::ostream_iterator::char_type", "iterator/std::ostream_iterator::ostream_type", "iterator/std::ostream_iterator::traits_type"] helpviewer_keywords: ["std::ostream_iterator [C++]", "std::ostream_iterator [C++], char_type", "std::ostream_iterator [C++], ostream_type", "std::ostream_iterator [C++], traits_type"] -ms.assetid: 24d842d3-9f45-4bf6-a697-62f5968f5a03 ms.custom: devdivchpfy22 --- @@ -15,7 +14,7 @@ The class template ostream_iterator describes an output iterator object that wri ## Syntax ```cpp -template > +template > class ostream_iterator ``` @@ -145,10 +144,10 @@ int main( ) // Standard iterator interface for writing // elements to the output stream cout << "Elements written to output stream:" << endl; -*intOut = 10; + *intOut = 10; intOut++; // No effect on iterator position -*intOut = 20; -*intOut = 30; + *intOut = 20; + *intOut = 30; } /* Output: Elements written to output stream: @@ -195,10 +194,10 @@ int main( ) // standard iterator interface for writing // elements to the output stream cout << "Elements written to output stream:" << endl; -*intOut = 10; + *intOut = 10; intOut++; // No effect on iterator position -*intOut = 20; -*intOut = 30; + *intOut = 20; + *intOut = 30; } /* Output: Elements written to output stream: @@ -249,10 +248,10 @@ int main( ) // Standard iterator interface for writing // elements to the output stream cout << "Elements written to output stream:" << endl; -*intOut = 10; + *intOut = 10; intOut++; // No effect on iterator position -*intOut = 20; -*intOut = 30; + *intOut = 20; + *intOut = 30; } /* Output: Elements written to output stream: @@ -304,9 +303,9 @@ int main( ) // ostream_iterator for stream cout ostream_iterator intOut ( cout , "\n" ); -*intOut = 10; + *intOut = 10; intOut++; -*intOut = 20; + *intOut = 20; intOut++; int i; diff --git a/docs/standard-library/ostream-operators.md b/docs/standard-library/ostream-operators.md index 6b1d575283a..566531288c6 100644 --- a/docs/standard-library/ostream-operators.md +++ b/docs/standard-library/ostream-operators.md @@ -1,13 +1,12 @@ --- -description: "Learn more about: operators" title: " operators" -ms.date: "11/04/2016" +description: "Learn more about: operators" +ms.date: 11/04/2016 f1_keywords: ["ostream/std::operator<<"] -ms.assetid: 9282a62e-a3d1-4371-a284-fbc9515bb9a2 --- # `` operators -[`operator<<`](#op_lt_lt) +The `` header provides the following operators: ## `operator<<` diff --git a/docs/standard-library/ostream-typedefs.md b/docs/standard-library/ostream-typedefs.md index fd4844f2c2e..7ace186c98e 100644 --- a/docs/standard-library/ostream-typedefs.md +++ b/docs/standard-library/ostream-typedefs.md @@ -1,18 +1,16 @@ --- -description: "Learn more about: typedefs" title: " typedefs" -ms.date: "11/04/2016" +description: "Learn more about: typedefs" +ms.date: 11/04/2016 f1_keywords: ["iosfwd/std::ostream", "iosfwd/std::wostream"] -ms.assetid: 2ec4dc52-a01f-4654-bd65-dd5288777c48 --- # `` typedefs -[ostream](#ostream)\ -[wostream](#wostream) +The `` header provides the following typedefs: -## ostream +## `ostream` -Creates a type from basic_ostream that is specialized on **`char`** and `char_traits` specialized on **`char`**. +Creates a type from `basic_ostream` that is specialized on **`char`** and `char_traits` specialized on **`char`**. ```cpp typedef basic_ostream> ostream; @@ -20,7 +18,7 @@ typedef basic_ostream> ostream; ### Remarks -The type is a synonym for class template [basic_ostream](../standard-library/basic-ostream-class.md), specialized for elements of type **`char`** with default character traits. +The type is a synonym for class template [`basic_ostream`](../standard-library/basic-ostream-class.md), specialized for elements of type **`char`** with default character traits. ## wostream @@ -32,7 +30,7 @@ typedef basic_ostream> wostream; ### Remarks -The type is a synonym for class template [basic_ostream](../standard-library/basic-ostream-class.md), specialized for elements of type **`wchar_t`** with default character traits. +The type is a synonym for class template [`basic_ostream`](../standard-library/basic-ostream-class.md), specialized for elements of type **`wchar_t`** with default character traits. ## See also diff --git a/docs/standard-library/ostreambuf-iterator-class.md b/docs/standard-library/ostreambuf-iterator-class.md index dea0af412dd..dfe0546ad27 100644 --- a/docs/standard-library/ostreambuf-iterator-class.md +++ b/docs/standard-library/ostreambuf-iterator-class.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: ostreambuf_iterator Class" title: "ostreambuf_iterator Class" -ms.date: "11/04/2016" +description: "Learn more about: ostreambuf_iterator Class" +ms.date: 11/04/2016 f1_keywords: ["streambuf/std::ostreambuf_iterator", "iterator/std::ostreambuf_iterator::char_type", "iterator/std::ostreambuf_iterator::ostream_type", "iterator/std::ostreambuf_iterator::streambuf_type", "iterator/std::ostreambuf_iterator::traits_type", "iterator/std::ostreambuf_iterator::failed"] helpviewer_keywords: ["std::ostreambuf_iterator [C++]", "std::ostreambuf_iterator [C++], char_type", "std::ostreambuf_iterator [C++], ostream_type", "std::ostreambuf_iterator [C++], streambuf_type", "std::ostreambuf_iterator [C++], traits_type", "std::ostreambuf_iterator [C++], failed"] -ms.assetid: dad1e624-2f45-4e94-8887-a885e95f9071 --- # ostreambuf_iterator Class @@ -13,7 +12,7 @@ The class template ostreambuf_iterator describes an output iterator object that ## Syntax ```cpp -template > +template > ``` ### Parameters @@ -99,11 +98,11 @@ int main( ) // elements to the output streambuf: cout << "The characters written to the output stream\n" << " by charOutBuf are: "; -*charOutBuf = 'O'; + *charOutBuf = 'O'; charOutBuf++; -*charOutBuf = 'U'; + *charOutBuf = 'U'; charOutBuf++; -*charOutBuf = 'T'; + *charOutBuf = 'T'; charOutBuf++; cout << "." << endl; } @@ -145,11 +144,11 @@ int main( ) // ostreambuf_iterator for stream cout ostreambuf_iterator charOut ( cout ); -*charOut = 'a'; + *charOut = 'a'; charOut ++; -*charOut = 'b'; + *charOut = 'b'; charOut ++; -*charOut = 'c'; + *charOut = 'c'; cout << " are characters output individually." << endl; bool b1 = charOut.failed ( ); @@ -200,10 +199,10 @@ int main( ) // Standard iterator interface for writing // elements to the output stream cout << "Elements written to output stream:" << endl; -*charOutBuf = 'O'; + *charOutBuf = 'O'; charOutBuf++; // no effect on iterator position -*charOutBuf = 'U'; -*charOutBuf = 'T'; + *charOutBuf = 'U'; + *charOutBuf = 'T'; } /* Output: Elements written to output stream: @@ -248,10 +247,10 @@ int main( ) // Standard iterator interface for writing // elements to the output stream cout << "Elements written to output stream:" << endl; -*charOutBuf = 'O'; + *charOutBuf = 'O'; charOutBuf++; // No effect on iterator position -*charOutBuf = 'U'; -*charOutBuf = 'T'; + *charOutBuf = 'U'; + *charOutBuf = 'T'; } /* Output: Elements written to output stream: @@ -300,10 +299,10 @@ int main( ) // Standard iterator interface for writing // elements to the output stream cout << "Elements written to output stream:" << endl; -*charOutBuf = 'O'; + *charOutBuf = 'O'; charOutBuf++; // No effect on iterator position -*charOutBuf = 'U'; -*charOutBuf = 'T'; + *charOutBuf = 'U'; + *charOutBuf = 'T'; } /* Output: Elements written to output stream: @@ -350,11 +349,11 @@ int main( ) // ostreambuf_iterator for stream cout ostreambuf_iterator charOut ( cout ); -*charOut = 'O'; + *charOut = 'O'; charOut ++; -*charOut = 'U'; + *charOut = 'U'; charOut ++; -*charOut = 'T'; + *charOut = 'T'; cout << " are characters output individually." << endl; ostreambuf_iterator strOut ( cout ); @@ -435,11 +434,11 @@ int main( ) // elements to the output streambuf: cout << "The characters written to the output stream\n" << " by charOutBuf are: "; -*charOutBuf = 'O'; + *charOutBuf = 'O'; charOutBuf++; -*charOutBuf = 'U'; + *charOutBuf = 'U'; charOutBuf++; -*charOutBuf = 'T'; + *charOutBuf = 'T'; charOutBuf++; cout << "." << endl; } diff --git a/docs/standard-library/ostrstream-class.md b/docs/standard-library/ostrstream-class.md index c9b7a0acaf3..567245feb6b 100644 --- a/docs/standard-library/ostrstream-class.md +++ b/docs/standard-library/ostrstream-class.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: ostrstream Class" title: "ostrstream Class" -ms.date: "11/04/2016" +description: "Learn more about: ostrstream Class" +ms.date: 11/04/2016 f1_keywords: ["strstream/std::ostrstream::freeze", "strstream/std::ostrstream::pcount", "strstream/std::ostrstream::rdbuf", "strstream/std::ostrstream::str"] helpviewer_keywords: ["std::ostrstream [C++], freeze", "std::ostrstream [C++], pcount", "std::ostrstream [C++], rdbuf", "std::ostrstream [C++], str"] -ms.assetid: e2e34679-b266-4728-a8e1-8eda5d400e46 --- # ostrstream Class @@ -94,7 +93,7 @@ Both constructors initialize the base class by calling [ostream](../standard-lib - If `_Mode` & **ios_base::app**== 0, then `ptr` must designate the first element of an array of `count` elements, and the constructor calls `strstreambuf`(`ptr`, `count`, `ptr`). -- Otherwise, `ptr` must designate the first element of an array of count elements that contains a C string whose first element is designated by `ptr`, and the constructor calls `strstreambuf`(`ptr`, `count`, `ptr` + `strlen`( `ptr`) ). +- Otherwise, `ptr` must designate the first element of an array of count elements that contains a C string whose first element is designated by `ptr`, and the constructor calls `strstreambuf`(`ptr`, `count`, `ptr` + `strlen`(`ptr`)). ## ostrstream::pcount diff --git a/docs/standard-library/other-one-argument-output-stream-manipulators.md b/docs/standard-library/other-one-argument-output-stream-manipulators.md index 0807ff915eb..8495a513707 100644 --- a/docs/standard-library/other-one-argument-output-stream-manipulators.md +++ b/docs/standard-library/other-one-argument-output-stream-manipulators.md @@ -1,9 +1,8 @@ --- -description: "Learn more about: Other One-Argument Output Stream Manipulators" title: "Other One-Argument Output Stream Manipulators" -ms.date: "11/04/2016" +description: "Learn more about: Other One-Argument Output Stream Manipulators" +ms.date: 11/04/2016 helpviewer_keywords: ["output streams, one-argument manipulators"] -ms.assetid: e381dee8-6b16-4cef-805a-4a6a1d2b696b --- # Other One-Argument Output Stream Manipulators @@ -51,7 +50,7 @@ void fb( ios_base& os, char * somename ) { for( int i=0; i < l; i++ ) (*pos) << ' '; - }; + } */ } diff --git a/docs/standard-library/out-of-range-class.md b/docs/standard-library/out-of-range-class.md index 0fb2d3cb673..cf5e79dfc81 100644 --- a/docs/standard-library/out-of-range-class.md +++ b/docs/standard-library/out-of-range-class.md @@ -1,12 +1,11 @@ --- -description: "Learn more about: out_of_range Class" -title: "out_of_range Class" -ms.date: "09/09/2021" +title: "out_of_range class" +description: "Learn more about: out_of_range class" +ms.date: 09/09/2021 f1_keywords: ["stdexcept/std::out_of_range"] helpviewer_keywords: ["out_of_range class"] -ms.assetid: d0e14dc0-065e-4666-9ac9-51e52223c503 --- -# out_of_range Class +# `out_of_range` class The class serves as the base class for all exceptions thrown to report an argument that is out of its valid range. @@ -18,13 +17,12 @@ public: explicit out_of_range(const string& message); explicit out_of_range(const char *message); - }; ``` ## Remarks -The value returned by `what()` is a copy of `message.data()`. For more information, see [`what`](../standard-library/exception-class.md) and [`data`](../standard-library/basic-string-class.md#data). +The value returned by `what()` is a copy of `message.data()`. For more information, see [`what`](exception-class.md) and [`data`](basic-string-class.md#data). ## Example @@ -52,19 +50,20 @@ int main() cerr << "Type: " << typeid(e).name() << endl; } } -/* Output: +``` + +```Output Caught: invalid string position Type: class std::out_of_range -*/ ``` ## Requirements -**Header:** \ +**Header:** `` -**Namespace:** std +**Namespace:** `std` ## See also -[logic_error Class](../standard-library/logic-error-class.md)\ -[Thread Safety in the C++ Standard Library](../standard-library/thread-safety-in-the-cpp-standard-library.md) +[`logic_error` class](logic-error-class.md)\ +[Thread Safety in the C++ Standard Library](thread-safety-in-the-cpp-standard-library.md) diff --git a/docs/standard-library/output-file-stream-member-functions.md b/docs/standard-library/output-file-stream-member-functions.md index f01b65202bf..6c7902a6244 100644 --- a/docs/standard-library/output-file-stream-member-functions.md +++ b/docs/standard-library/output-file-stream-member-functions.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: Output File Stream Member Functions" title: "Output File Stream Member Functions" -ms.date: "08/25/2021" +description: "Learn more about: Output File Stream Member Functions" +ms.date: 08/25/2021 helpviewer_keywords: ["output streams [C++], member functions"] --- # Output File Stream Member Functions @@ -12,7 +12,7 @@ Output stream member functions have three types: those that are equivalent to ma To use an output file stream ([`ofstream`](../standard-library/basic-ofstream-class.md)), you must associate that stream with a specific disk file in the constructor or the `open` function. If you use the `open` function, you can reuse the same stream object with a series of files. In either case, the arguments describing the file are the same. -When you open the file associated with an output stream, you generally specify an `open_mode` flag. You can combine these flags, which are defined as enumerators in the `ios` class, with the bitwise OR ( `|` ) operator. See [`ios_base::openmode`](../standard-library/ios-base-class.md#openmode) for a list of the enumerators. +When you open the file associated with an output stream, you generally specify an `open_mode` flag. You can combine these flags, which are defined as enumerators in the `ios` class, with the bitwise OR (`|`) operator. See [`ios_base::openmode`](../standard-library/ios-base-class.md#openmode) for a list of the enumerators. Three common output stream situations involve mode options: @@ -102,7 +102,7 @@ Use these member functions to test for errors while writing to a stream: |[`good`](basic-ios-class.md#good)|Returns **`true`** if there's no error condition (unrecoverable or otherwise) and the end-of-file flag isn't set.| |[`eof`](basic-ios-class.md#eof)|Returns **`true`** on the end-of-file condition.| |[`clear`](basic-ios-class.md#clear)|Sets the internal error state. If called with the default arguments, it clears all error bits.| -|[`rdstate`](basic-ios-class.md#rdstate|Returns the current error state.| +|[`rdstate`](basic-ios-class.md#rdstate)|Returns the current error state.| The **`!`** operator is overloaded to perform the same function as the `fail` function. Thus the expression: diff --git a/docs/standard-library/output-stream-manipulators-with-one-argument-int-or-long.md b/docs/standard-library/output-stream-manipulators-with-one-argument-int-or-long.md index 1c3cb51e5e9..ee87da5f214 100644 --- a/docs/standard-library/output-stream-manipulators-with-one-argument-int-or-long.md +++ b/docs/standard-library/output-stream-manipulators-with-one-argument-int-or-long.md @@ -1,9 +1,8 @@ --- -description: "Learn more about: Output Stream Manipulators with One Argument (int or long)" title: "Output Stream Manipulators with One Argument (int or long)" -ms.date: "11/04/2016" +description: "Learn more about: Output Stream Manipulators with One Argument (int or long)" +ms.date: 11/04/2016 helpviewer_keywords: ["output streams, int or long argument manipulators"] -ms.assetid: 338f3164-b5e2-4c5a-a605-7d9dc3629ca1 --- # Output Stream Manipulators with One Argument (int or long) @@ -25,7 +24,7 @@ void fb( ios_base& os, int l ) { for( int i=0; i < l; i++ ) (*pos) << ' '; - }; + } } _Smanip diff --git a/docs/standard-library/overflow-error-class.md b/docs/standard-library/overflow-error-class.md index 0ba3c520d48..b4291d01a31 100644 --- a/docs/standard-library/overflow-error-class.md +++ b/docs/standard-library/overflow-error-class.md @@ -1,12 +1,11 @@ --- -description: "Learn more about: overflow_error Class" -title: "overflow_error Class" -ms.date: "09/09/2021" +title: "overflow_error class" +description: "Learn more about: overflow_error class" +ms.date: 09/09/2021 f1_keywords: ["stdexcept/std::overflow_error"] helpviewer_keywords: ["overflow_error class"] -ms.assetid: bae7128d-e36b-4a45-84f1-2f89da441d20 --- -# overflow_error Class +# `overflow_error` class The class serves as the base class for all exceptions thrown to report an arithmetic overflow. @@ -18,13 +17,12 @@ public: explicit overflow_error(const string& message); explicit overflow_error(const char *message); - }; ``` ## Remarks -The value returned by `what()` is a copy of `message.data()`. For more information, see [`what`](../standard-library/exception-class.md) and [`data`](../standard-library/basic-string-class.md#data). +The value returned by `what()` is a copy of `message.data()`. For more information, see [`what`](exception-class.md) and [`data`](basic-string-class.md#data). ## Example @@ -52,19 +50,20 @@ int main() cerr << "Type: " << typeid(e).name() << endl; } } -/* Output: +``` + +```Output Caught: bitset overflow Type: class std::overflow_error -*/ ``` ## Requirements -**Header:** \ +**Header:** `` -**Namespace:** std +**Namespace:** `std` ## See also -[runtime_error Class](../standard-library/runtime-error-class.md)\ -[Thread Safety in the C++ Standard Library](../standard-library/thread-safety-in-the-cpp-standard-library.md) +[`runtime_error` class](runtime-error-class.md)\ +[Thread Safety in the C++ Standard Library](thread-safety-in-the-cpp-standard-library.md) diff --git a/docs/standard-library/path-class.md b/docs/standard-library/path-class.md index 6e5499a4672..8f7edbb9c17 100644 --- a/docs/standard-library/path-class.md +++ b/docs/standard-library/path-class.md @@ -1,6 +1,6 @@ --- -description: "Learn more about: path Class" title: "path Class" +description: "Learn more about: path Class" ms.date: 06/17/2022 f1_keywords: ["filesystem/std::experimental::filesystem::path"] --- @@ -41,7 +41,7 @@ class path; |[`c_str`](#c_str)|Returns a pointer to the first character in `mypath`.| |[`clear`](#clear)|Executes `mypath.clear()`.| |[`compare`](#compare)|Returns comparison values.| -|[`concat`](#compare)|Appends the specified sequence to `mypath`, converted (but not inserting a separator) as needed.| +|[`concat`](#concat)|Appends the specified sequence to `mypath`, converted (but not inserting a separator) as needed.| |[`empty`](#empty)|Returns `mypath.empty()`.| |[`end`](#end)|Returns an end-of-sequence iterator of type `iterator`.| |[`extension`](#extension)|Returns the suffix of `filename()`.| diff --git a/docs/standard-library/priority-queue-class.md b/docs/standard-library/priority-queue-class.md index 8e22659fb47..54de3d14480 100644 --- a/docs/standard-library/priority-queue-class.md +++ b/docs/standard-library/priority-queue-class.md @@ -1,13 +1,13 @@ --- description: "Learn more about: priority_queue Class" title: "priority_queue Class" -ms.date: "11/04/2016" +ms.date: 01/18/2026 f1_keywords: ["queue/std::priority_queue::container_type", "queue/std::priority_queue::size_type", "queue/std::priority_queue::value_type", "queue/std::priority_queue::empty", "queue/std::priority_queue::pop", "queue/std::priority_queue::push", "queue/std::priority_queue::size", "queue/std::priority_queue::top"] helpviewer_keywords: ["std::priority_queue [C++], container_type", "std::priority_queue [C++], size_type", "std::priority_queue [C++], value_type", "std::priority_queue [C++], empty", "std::priority_queue [C++], pop", "std::priority_queue [C++], push", "std::priority_queue [C++], size", "std::priority_queue [C++], top"] --- -# `priority_queue` Class +# `priority_queue` class -A template container adaptor class that provides a restriction of functionality limiting access to the top element of some underlying container type, which is always the largest or of the highest priority. New elements can be added to the `priority_queue` and the top element of the `priority_queue` can be inspected or removed. +A container adaptor that maintains a collection of elements where the largest (or highest priority) element is always accessible at the top. You can add new elements and remove or examine the top element, but you can't directly access elements in the middle of the collection. ## Syntax @@ -19,31 +19,40 @@ class priority_queue ### Parameters *`Type`*\ -The element data type to be stored in the `priority_queue`. +The element data type to store in the `priority_queue`. *`Container`*\ -The type of the underlying container used to implement the `priority_queue`. +The type of the underlying container that stores the elements for the `priority_queue`. *`Compare`*\ -The type that provides a function object that can compare two element values as sort keys to determine their relative order in the `priority_queue`. This argument is optional and the binary predicate `less` is the default value. +The type that provides a function object that compares two element values as sort keys to determine their relative order in the `priority_queue`. This argument is optional. The binary predicate `less` is the default. ## Remarks -The elements of class `Type` stipulated in the first template parameter of a queue object are synonymous with [`value_type`](#value_type) and must match the type of element in the underlying container class `Container` stipulated by the second template parameter. The `Type` must be assignable, so that it's possible to copy objects of that type and to assign values to variables of that type. +Elements of class `Type` specified in the first template parameter of a `priority_queue` object are equivalent to [`value_type`](#value_type) and must match the element type in the underlying container class `Container` specified by the second template parameter. The `Type` must be assignable, which means you can copy objects of that type and assign values to variables of that type. -The `priority_queue` orders the sequence it controls by calling a stored function object of class `Traits`. In general, the elements need be merely less than comparable to establish this order: so that, given any two elements, it may be determined either that they're equivalent (in the sense that neither is less than the other) or that one is less than the other. This results in an ordering between the nonequivalent elements. On a more technical note, the comparison function is a binary predicate that induces a strict weak ordering in the standard mathematical sense. +The `priority_queue` uses a comparison function to determine which elements have higher priority. This comparison function is a function object of class `Traits`. To work with `priority_queue`, your elements only need to support comparison using the less-than operator (`<`) so that it can arrange the elements in order. -Suitable underlying container classes for `priority_queue` include [`deque` Class](../standard-library/deque-class.md) and the default [`vector` Class](../standard-library/vector-class.md) or any other sequence container that supports the operations of `front`, `push_back`, and `pop_back` and a random-access iterator. The underlying container class is encapsulated within the container adaptor, which exposes only the limited set of the sequence container member functions as a public interface. +You can change the underlying container type used by the `priority_queue`. You may want to do that for performance reasons. The default, `vector`, is usually best for cache locality because elements are stored in contiguous storage, and does fewer allocations as it grows. But perhaps you would consider `deque` if you have very large or unbounded queues and moving elements is expensive. For more information about suitable underlying container classes, see [container_type](#container_type). -Adding elements to and removing elements from a `priority_queue` both have logarithmic complexity. Accessing elements in a `priority_queue` has constant complexity. +Adding and removing elements from a `priority_queue` both have logarithmic complexity. Accessing elements in a `priority_queue` has constant complexity. -There are three types of container adaptors defined by the C++ Standard Library: `stack`, `queue`, and `priority_queue`. Each restricts the functionality of some underlying container class to provide a precisely controlled interface to a standard data structure. +The C++ Standard Library defines other container adaptors that you can use to store the elements in your `priority_queue`: `stack`, `queue`, and `priority_queue`: -- The [`stack` Class](../standard-library/stack-class.md) supports a last-in, first-out (LIFO) data structure. A good analogue to keep in mind would be a stack of plates. Elements (plates) may be inserted, inspected, or removed only from the top of the stack, which is the last element at the end of the base container. The restriction to accessing only the top element is the reason for using the `stack` class. +- The [`stack` Class](../standard-library/stack-class.md) supports a last-in, first-out (LIFO) data structure. Consider a stack of plates: you can insert, inspect, or remove elements (plates) only from the top of the stack, which is the last element at the end of the base container. +- The [`queue` Class](../standard-library/queue-class.md) supports a first-in, first-out (FIFO) data structure. Consider people in a line. You add elements (people) to the back of the line and remove them from the front of the line. Both the front and the back of a line can be inspected. +- The `priority_queue` class orders its elements so that the largest element is always at the top. It supports insertion of an element and the inspection and removal of the top element. -- The [`queue` Class](../standard-library/queue-class.md) supports a first-in, first-out (FIFO) data structure. A good analogue to keep in mind would be people lining up for a bank teller. Elements (people) may be added to the back of the line and are removed from the front of the line. Both the front and the back of a line may be inspected. The restriction to accessing only the front and back elements in this way is the reason for using the `queue` class. +## Examples -- The `priority_queue` class orders its elements so that the largest element is always at the top position. It supports insertion of an element and the inspection and removal of the top element. A good analogue to keep in mind would be people lining up where they're arranged by age, height, or some other criterion. +- [Check if the `priority_queue` is empty](#check-if-a-priority_queue-is-empty) +- [Pop elements and check queue size](#pop-elements-and-inspect-size) +- [Use custom containers and comparers](#construct-priority_queue-with-custom-containers-and-comparers) +- [Push elements and read the top](#push-elements-and-read-the-top) +- [Get the number of elements](#get-priority_queue-size) +- [Access the top element](#access-the-top-element) +- [Use the priority_queue value_type alias](#use-the-priority_queue-value_type-alias) +- [Use a user-defined data type](#use-a-user-defined-data-type-with-the-priority_queue) ### Constructors @@ -55,7 +64,7 @@ There are three types of container adaptors defined by the C++ Standard Library: |Type name|Description| |-|-| -|[`container_type`](#container_type)|A type that provides the base container to be adapted by a `priority_queue`.| +|[`container_type`](#container_type)|A type that provides the base container that the `priority_queue` adapts.| |[`size_type`](#size_type)|An unsigned integer type that can represent the number of elements in a `priority_queue`.| |[`value_type`](#value_type)|A type that represents the type of object stored as an element in a `priority_queue`.| @@ -85,13 +94,11 @@ typedef Container container_type; ### Remarks -The type is a synonym for the template parameter `Container`. The C++ Standard Library sequence container class `deque` and the default class `vector` meet the requirements to be used as the base container for a `priority_queue` object. User-defined types satisfying the requirements may also be used. +The type is a synonym for the template parameter `Container`. -For more information on `Container`, see the Remarks section of the [`priority_queue` Class](../standard-library/priority-queue-class.md) topic. +Suitable underlying container classes for `priority_queue` include [`deque` Class](../standard-library/deque-class.md), the default [`vector` Class](../standard-library/vector-class.md), or any other sequence container that supports the operations of `front`, `push_back`, and `pop_back` and a random-access iterator. The container adaptor encapsulates the underlying container class and exposes only a limited set of the sequence container member functions as a public interface. -### Example - -See the example for [`priority_queue`](#priority_queue) for an example of how to declare and use `container_type`. +For an example of how to declare and use `container_type`, see [Use custom containers and comparers](#construct-priority_queue-with-custom-containers-and-comparers) ## `priority_queue::empty` @@ -105,29 +112,28 @@ bool empty() const; **`true`** if the `priority_queue` is empty; **`false`** if the `priority_queue` is nonempty. -### Example +### Example: Check if the `priority_queue` is empty ```cpp -// pqueue_empty.cpp // compile with: /EHsc #include #include -int main( ) +int main() { using namespace std; // Declares priority_queues with default deque base container priority_queue q1, s2; - q1.push( 1 ); + q1.push(1); - if ( q1.empty( ) ) + if (q1.empty()) cout << "The priority_queue q1 is empty." << endl; else cout << "The priority_queue q1 is not empty." << endl; - if ( s2.empty( ) ) + if (s2.empty()) cout << "The priority_queue s2 is empty." << endl; else cout << "The priority_queue s2 is not empty." << endl; @@ -149,42 +155,38 @@ void pop(); ### Remarks -The `priority_queue` must be nonempty to apply the member function. The top of the `priority_queue` is always occupied by the largest element in the container. +The `priority_queue` must be nonempty to use this member function. The top of the `priority_queue` always holds the largest element in the container. -### Example +### Example: Pop elements and check size ```cpp -// pqueue_pop.cpp // compile with: /EHsc #include #include -int main( ) +int main() { using namespace std; priority_queue q1, s2; - q1.push( 10 ); - q1.push( 20 ); - q1.push( 30 ); + q1.push(10); + q1.push(20); + q1.push(30); priority_queue ::size_type i, iii; - i = q1.size( ); + i = q1.size(); cout << "The priority_queue length is " << i << "." << endl; - const int& ii = q1.top( ); - cout << "The element at the top of the priority_queue is " - << ii << "." << endl; + const int& ii = q1.top(); + cout << "The element at the top of the priority_queue is " << ii << "." << endl; - q1.pop( ); + q1.pop(); - iii = q1.size( ); - cout << "After a pop, the priority_queue length is " - << iii << "." << endl; + iii = q1.size(); + cout << "After a pop, the priority_queue length is " << iii << "." << endl; - const int& iv = q1.top( ); - cout << "After a pop, the element at the top of the " - << "priority_queue is " << iv << "." << endl; + const int& iv = q1.top(); + cout << "After a pop, the element at the top of the " << "priority_queue is " << iv << "." << endl; } ``` @@ -197,7 +199,7 @@ After a pop, the element at the top of the priority_queue is 20. ## `priority_queue::priority_queue` -Constructs a `priority_queue` that is empty or that is a copy of a range of a base container object or of another `priority_queue`. +Creates a `priority_queue` that is empty or that copies a range from a base container object or from another `priority_queue`. ```cpp priority_queue(); @@ -243,10 +245,9 @@ The fourth constructor specifies a copy of the `priority_queue right`. The last three constructors copy the range `[first, last)` of some container and use the values to initialize a `priority_queue` with increasing explicitness in specifying the type of comparison function of class `Traits` and `container_type`. -### Example +### Example: Use custom containers and comparers ```cpp -// pqueue_ctor.cpp // compile with: /EHsc #include #include @@ -254,101 +255,94 @@ The last three constructors copy the range `[first, last)` of some container and #include #include -int main( ) +int main() { using namespace std; - // The first member function declares priority_queue - // with a default vector base container + // Declares a priority_queue with a default vector base container priority_queue q1; cout << "q1 = ( "; - while ( !q1.empty( ) ) + while (!q1.empty()) { - cout << q1.top( ) << " "; - q1.pop( ); + cout << q1.top() << " "; + q1.pop(); } cout << ")" << endl; - // Explicitly declares a priority_queue with nondefault - // deque base container - priority_queue > q2; - q2.push( 5 ); - q2.push( 15 ); - q2.push( 10 ); + // Declares a priority_queue with nondefault deque base container + priority_queue > q2; + q2.push(5); + q2.push(15); + q2.push(10); cout << "q2 = ( "; - while ( !q2.empty( ) ) + while (!q2.empty()) { - cout << q2.top( ) << " "; - q2.pop( ); + cout << q2.top() << " "; + q2.pop(); } cout << ")" << endl; - - // This method of printing out the elements of a priority_queue - // removes the elements from the priority queue, leaving it empty - cout << "After printing, q2 has " << q2.size( ) << " elements." << endl; - - // The third member function declares a priority_queue - // with a vector base container and specifies that the comparison - // function greater is to be used for ordering elements - priority_queue , greater > q3; - q3.push( 2 ); - q3.push( 1 ); - q3.push( 3 ); + cout << "After printing, q2 has " << q2.size() << " elements." << endl; + + // Declares a priority_queue with a vector base container and specifies that + // the comparison function greater is to be used for ordering elements + priority_queue , greater> q3; + q3.push(2); + q3.push(1); + q3.push(3); cout << "q3 = ( "; - while ( !q3.empty( ) ) + + while (!q3.empty()) { - cout << q3.top( ) << " "; - q3.pop( ); + cout << q3.top() << " "; + q3.pop(); } cout << ")" << endl; - // The fourth member function declares a priority_queue and - // initializes it with elements copied from another container: - // first, inserting elements into q1, then copying q1 elements into q4 - q1.push( 100 ); - q1.push( 200 ); - priority_queue q4( q1 ); + // Declares a priority_queue and initializes it with elements copied from another + // container by first inserting elements into q1 and then copying q1 elements into q4 + q1.push(100); + q1.push(200); + priority_queue q4(q1); cout << "q4 = ( "; - while ( !q4.empty( ) ) + while (!q4.empty()) { - cout << q4.top( ) << " "; - q4.pop( ); + cout << q4.top() << " "; + q4.pop(); } cout << ")" << endl; // Creates an auxiliary vector object v5 to be used to initialize q5 vector v5; vector ::iterator v5_Iter; - v5.push_back( 10 ); - v5.push_back( 30 ); - v5.push_back( 20 ); + v5.push_back(10); + v5.push_back(30); + v5.push_back(20); cout << "v5 = ( " ; - for ( v5_Iter = v5.begin( ) ; v5_Iter != v5.end( ) ; v5_Iter++ ) + for (v5_Iter = v5.begin() ; v5_Iter != v5.end() ; v5_Iter++) + { cout << *v5_Iter << " "; + } cout << ")" << endl; - // The fifth member function declares and - // initializes a priority_queue q5 by copying the + // Declares and initializes a priority_queue q5 by copying the // range v5[ first, last) from vector v5 - priority_queue q5( v5.begin( ), v5.begin( ) + 2 ); + priority_queue q5(v5.begin(), v5.begin() + 2); cout << "q5 = ( "; - while ( !q5.empty( ) ) + while (!q5.empty()) { - cout << q5.top( ) << " "; - q5.pop( ); + cout << q5.top() << " "; + q5.pop(); } cout << ")" << endl; - // The sixth member function declares a priority_queue q6 - // with a comparison function greater and initializes q6 - // by copying the range v5[ first, last) from vector v5 - priority_queue , greater > - q6( v5.begin( ), v5.begin( ) + 2 ); + // Declares a priority_queue q6 with a comparison function greater and + // initializes q6 by copying the range v5[ first, last) from vector v5 + priority_queue , greater> q6(v5.begin(), v5.begin() + 2); cout << "q6 = ( "; - while ( !q6.empty( ) ) + while (!q6.empty()) { - cout << q6.top( ) << " "; - q6.pop( ); + cout << q6.top() << " "; + q6.pop(); } cout << ")" << endl; } @@ -365,36 +359,34 @@ void push(const Type& val); ### Parameters *`val`*\ -The element added to the top of the `priority_queue`. +The element to add to the top of the `priority_queue`. ### Remarks -The top of the `priority_queue` is the position occupied by the largest element in the container. +The top of the `priority_queue` contains the largest element in the container. -### Example +### Example: Push elements and read the top ```cpp -// pqueue_push.cpp // compile with: /EHsc #include #include -int main( ) +int main() { using namespace std; priority_queue q1; - q1.push( 10 ); - q1.push( 30 ); - q1.push( 20 ); + q1.push(10); + q1.push(30); + q1.push(20); priority_queue::size_type i; - i = q1.size( ); + i = q1.size(); cout << "The priority_queue length is " << i << "." << endl; - const int& ii = q1.top( ); - cout << "The element at the top of the priority_queue is " - << ii << "." << endl; + const int& ii = q1.top(); + cout << "The element at the top of the priority_queue is " << ii << "." << endl; } ``` @@ -415,26 +407,25 @@ size_type size() const; The current length of the `priority_queue`. -### Example +### Example: Get the number of elements in the `priority_queue` ```cpp -// pqueue_size.cpp // compile with: /EHsc #include #include -int main( ) +int main() { using namespace std; priority_queue q1, q2; priority_queue ::size_type i; - q1.push( 1 ); - i = q1.size( ); + q1.push(1); + i = q1.size(); cout << "The priority_queue length is " << i << "." << endl; - q1.push( 2 ); - i = q1.size( ); + q1.push(2); + i = q1.size(); cout << "The priority_queue length is now " << i << "." << endl; } ``` @@ -446,7 +437,7 @@ The priority_queue length is now 2. ## `priority_queue::size_type` -An unsigned integer type that can represent the number of elements in a `priority_queue`. +An unsigned integer type that represents the number of elements in a `priority_queue`. ```cpp typedef typename Container::size_type size_type; @@ -454,11 +445,11 @@ typedef typename Container::size_type size_type; ### Remarks -The type is a synonym for the `size_type` of the base container adapted by the `priority_queue`. +This type is a synonym for the `size_type` of the base container that the `priority_queue` adapts. -### Example +### Example: Access the top element -See the example for [`size`](#size) for an example of how to declare and use `size_type`. +For an example of how to declare and use `size_type`, see [Get the number of elements](#get-priority_queue-size) ## `priority_queue::top` @@ -474,32 +465,30 @@ A reference to the largest element, as determined by the `Traits` function, obje ### Remarks -The `priority_queue` must be nonempty to apply the member function. +The `priority_queue` must be nonempty to use this member function. -### Example +### Example: Get the top element of the `priority_queue` ```cpp -// pqueue_top.cpp // compile with: /EHsc #include #include -int main( ) +int main() { using namespace std; priority_queue q1; - q1.push( 10 ); - q1.push( 30 ); - q1.push( 20 ); + q1.push(10); + q1.push(30); + q1.push(20); priority_queue::size_type i; - i = q1.size( ); + i = q1.size(); cout << "The priority_queue length is " << i << "." << endl; - const int& ii = q1.top( ); - cout << "The element at the top of the priority_queue is " - << ii << "." << endl; + const int& ii = q1.top(); + cout << "The element at the top of the priority_queue is " << ii << "." << endl; } ``` @@ -518,17 +507,16 @@ typedef typename Container::value_type value_type; ### Remarks -The type is a synonym for the `value_type` of the base container adapted by the `priority_queue`. +This type is a synonym for the `value_type` of the base container that the `priority_queue` adapts. -### Example +### Example: Use the priority_queue value_type alias ```cpp -// pqueue_value_type.cpp // compile with: /EHsc #include #include -int main( ) +int main() { using namespace std; @@ -539,9 +527,8 @@ int main( ) cout << "The value_type is AnInt = " << AnInt << endl; priority_queue q1; - q1.push( AnInt ); - cout << "The element at the top of the priority_queue is " - << q1.top( ) << "." << endl; + q1.push(AnInt); + cout << "The element at the top of the priority_queue is " << q1.top() << "." << endl; } ``` @@ -550,6 +537,73 @@ The value_type is AnInt = 69 The element at the top of the priority_queue is 69. ``` +## Example: Use a user-defined data type + +To use `priority_queue` with user-defined type elements, you must provide a way to compare the elements. You can either define `operator<` for your type or provide a custom comparison function object. + +The following example demonstrates a `priority_queue` that stores `Task` objects, ordered by priority level. Tasks with higher priority values are at the top of the queue. + +```cpp +// compile with: /EHsc +#include +#include +#include + +struct Task +{ + int priority; + std::string name; + + // Define operator< for priority_queue ordering + // Returns true if this task has LOWER priority than other + // (priority_queue puts the "largest" element at the top) + bool operator<(const Task& other) const + { + return priority < other.priority; + } +}; + +int main() +{ + std::priority_queue tasks; + + tasks.push({3, "Low priority task"}); + tasks.push({10, "High priority task"}); + tasks.push({5, "Medium priority task"}); + + std::cout << "Processing tasks by priority:\n"; + while (!tasks.empty()) + { + const Task& t = tasks.top(); + std::cout << " Priority " << t.priority << ": " << t.name << "\n"; + tasks.pop(); + } +} +``` + +```Output +Processing tasks by priority: + Priority 10: High priority task + Priority 5: Medium priority task + Priority 3: Low priority task +``` + +### Remarks + +If you want different ordering (for example, lower values first), provide a custom comparator: + +```cpp +struct ComparePriority +{ + bool operator()(const Task& a, const Task& b) + { + return a.priority > b.priority; // Lower priority value means higher priority + } +}; + +std::priority_queue, ComparePriority> minQueue; +``` + ## See also [Thread Safety in the C++ Standard Library](../standard-library/thread-safety-in-the-cpp-standard-library.md)\ diff --git a/docs/standard-library/queue-operators.md b/docs/standard-library/queue-operators.md index 51f688e8766..9f4929c4a97 100644 --- a/docs/standard-library/queue-operators.md +++ b/docs/standard-library/queue-operators.md @@ -1,9 +1,8 @@ --- -description: "Learn more about: operators" title: " operators" +description: "Learn more about: operators" ms.date: "11/04/2016" f1_keywords: ["queue/std::operator!=", "queue/std::operator>", "queue/std::operator>=", "queue/std::operator<", "queue/std::operator<=", "queue/std::operator=="] -ms.assetid: 7c435b48-175c-45b0-88eb-24561044019c helpviewer_keywords: ["std::operator!= (queue)", "std::operator> (queue)", "std::operator>= (queue)", "std::operator< (queue)", "std::operator<= (queue)", "std::operator== (queue)"] --- # `` operators @@ -13,7 +12,7 @@ helpviewer_keywords: ["std::operator!= (queue)", "std::operator> (queue)", "std: Tests if the queue object on the left side of the operator is not equal to the queue object on the right side. ```cpp -bool operator!=(const queue & left, const queue & right,); +bool operator!=(const queue & left, const queue & right); ``` ### Parameters @@ -80,7 +79,7 @@ The queues q1 and q3 are equal. Tests if the queue object on the left side of the operator is less than the queue object on the right side. ```cpp -bool operator<(const queue & left, const queue & right,); +bool operator<(const queue & left, const queue & right); ``` ### Parameters @@ -143,7 +142,7 @@ The queue q1 is not less than the queue q3. Tests if the queue object on the left side of the operator is less than or equal to the queue object on the right side. ```cpp -bool operator<=(const queue & left, const queue & right,); +bool operator<=(const queue & left, const queue & right); ``` ### Parameters @@ -208,7 +207,7 @@ The queue q1 is less than or equal to the queue q3. Tests if the queue object on the left side of the operator is equal to queue object on the right side. ```cpp -bool operator==(const queue & left, const queue & right,); +bool operator==(const queue & left, const queue & right); ``` ### Parameters @@ -274,7 +273,7 @@ The queues q1 and q3 are equal. Tests if the queue object on the left side of the operator is greater than the queue object on the right side. ```cpp -bool operator>(const queue & left, const queue & right,); +bool operator>(const queue & left, const queue & right); ``` ### Parameters @@ -340,7 +339,7 @@ The queue q1 is greater than the queue q3. Tests if the queue object on the left side of the operator is greater than or equal to the queue object on the right side. ```cpp -bool operator>=(const queue & left, const queue & right,); +bool operator>=(const queue & left, const queue & right); ``` ### Parameters diff --git a/docs/standard-library/queue.md b/docs/standard-library/queue.md index cd1709709b5..f580355a8eb 100644 --- a/docs/standard-library/queue.md +++ b/docs/standard-library/queue.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: " title: "" -ms.date: "11/04/2016" +description: "Learn more about: " +ms.date: 11/04/2016 f1_keywords: [""] helpviewer_keywords: ["queue header"] -ms.assetid: 24fcf350-eb0e-48cf-9fef-978be1aeda1f --- # `` @@ -27,7 +26,7 @@ Defines the class templates priority_queue and queue and several supporting temp |-|-| |[operator!=](../standard-library/queue-operators.md#op_neq)|Tests if the queue object on the left side of the operator is not equal to the queue object on the right side.| |[operator<](../standard-library/queue-operators.md#op_lt)|Tests if the queue object on the left side of the operator is less than the queue object on the right side.| -|[operator\<=](../standard-library/queue-operators.md#op_gt_eq)|Tests if the queue object on the left side of the operator is less than or equal to the queue object on the right side.| +|[operator\<=](../standard-library/queue-operators.md#op_lt_eq)|Tests if the queue object on the left side of the operator is less than or equal to the queue object on the right side.| |[operator==](../standard-library/queue-operators.md#op_eq_eq)|Tests if the queue object on the left side of the operator is equal to the queue object on the right side.| |[operator>](../standard-library/queue-operators.md#op_gt)|Tests if the queue object on the left side of the operator is greater than the queue object on the right side.| |[operator>=](../standard-library/queue-operators.md#op_gt_eq)|Tests if the queue object on the left side of the operator is greater than or equal to the queue object on the right side.| diff --git a/docs/standard-library/random.md b/docs/standard-library/random.md index 11b4b91e2be..958524b2451 100644 --- a/docs/standard-library/random.md +++ b/docs/standard-library/random.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: " title: "" -ms.date: "08/24/2017" +description: "Learn more about: " +ms.date: 08/24/2017 f1_keywords: [""] helpviewer_keywords: ["random header"] -ms.assetid: 60afc25c-b162-4811-97c1-1b65398d4c57 --- # `` @@ -17,7 +16,7 @@ Defines facilities for random number generation, allowing creation of uniformly **Namespace:** std > [!NOTE] -> The `` library uses the `#include ' statement. +> The `` library uses the `#include ` statement. ## Summary @@ -45,7 +44,7 @@ Here are some tips to keep in mind when using ``: - The most useful pairing for most applications is the `mt19937` engine with `uniform_int_distribution`, as shown in the [code example](#code) later in this article. -There are many options to choose from in the `` header, and any of them is preferable to the outdated C Runtime function `rand()`. For information about what's wrong with `rand()` and how `` addresses these shortcomings, see [this video](/events/goingnative-2013/rand-considered-harmful). +There are many options to choose from in the `` header, and any of them is preferable to the outdated C Runtime function `rand()`. For information about what's wrong with `rand()` and how `` addresses these shortcomings, see [this video](/shows/goingnative-2013/rand-considered-harmful). ## Examples diff --git a/docs/standard-library/range-adaptors.md b/docs/standard-library/range-adaptors.md index 2b80c881af4..fd269cd19a8 100644 --- a/docs/standard-library/range-adaptors.md +++ b/docs/standard-library/range-adaptors.md @@ -1,6 +1,6 @@ --- -description: "Learn more about range adaptors, which create views on ranges." title: "Range adaptors" +description: "Learn more about range adaptors, which create views on ranges." ms.date: 11/3/2022 f1_keywords: ["ranges/std::all", "ranges/std::all_t", "ranges/std::common", "ranges/std::counted", "ranges/std::drop", "ranges/std::drop_while", "ranges/std::elements", "ranges/std::empty", "ranges/std::filter", "ranges/std::iota", "ranges/std::istream", "ranges/std::join", "ranges/std::keys", "ranges/std::lazy_split", "ranges/std::reverse", "ranges/std::single", "ranges/std::split", "ranges/std::subrange", "ranges/std::take", "ranges/std::take_while", "ranges/std::transform", "ranges/std::values"] helpviewer_keywords: ["std::ranges [C++], all", "std::ranges [C++], all_t", "std::ranges [C++], common", "std::ranges [C++], counted", "std::ranges [C++], drop", "std::ranges [C++], drop_while", "std::ranges [C++], elements", "std::ranges [C++], empty", "std::ranges [C++], filter", "std::ranges [C++], iota", "std::ranges [C++], istream", "std::ranges [C++], join", "std::ranges [C++], keys", "std::ranges [C++], lazy_split", "std::ranges [C++], reverse", "std::ranges [C++], single", "std::ranges [C++], split", "std::ranges [C++], subrange", "std::ranges [C++], take", "std::ranges [C++], take_while", "std::ranges [C++], transform", "std::ranges [C++], values"] @@ -217,7 +217,7 @@ When an API requires the begin iterator and end sentinel to have the same type, ### Example: `common` ```cpp -// requires /std:c++20 or higher +// requires /std:c++20 or later #include #include #include @@ -551,7 +551,7 @@ An `empty_view` can be useful when you're calling code that requires a view but ### Example: `empty` ```cpp -// requires /std:c++20 or higher +// requires /std:c++20 or later #include #include @@ -913,7 +913,7 @@ A [`lazy_split_view`](lazy-split-view-class.md) that contains one or more subran The delimiter isn't part of the result. For example, if you split the range `1,2,3` on the value `2`, you get two subranges: `1` and `3`. -A related adaptor is [`split`](#split). The primary differences between [`split_view](split-view-class.md) and `lazy_split_view` are: +A related adaptor is [`split`](#split). The primary differences between [`split_view`](split-view-class.md) and `lazy_split_view` are: | View | Can split a `const` range | Range iterator | |--|--|--| @@ -1062,7 +1062,7 @@ This view is useful for test purposes, for calling code that needs to be provide ### Example: `single` ```cpp -// requires /std:c++20 or higher +// requires /std:c++20 or later #include #include #include @@ -1389,7 +1389,7 @@ int main() Create a [`values_view`](values-view-class.md) that consists of the second index into each tuple-like value in a collection. This is useful for making a view of the values in an associative container. For example, given a range of `std::tuple` values, create a view that consists of all the `int` elements from each tuple. ```cpp -template +template constexpr ranges::view auto values(R&& rg); ``` diff --git a/docs/standard-library/range-concepts.md b/docs/standard-library/range-concepts.md index a00aec4ef20..dc21a897949 100644 --- a/docs/standard-library/range-concepts.md +++ b/docs/standard-library/range-concepts.md @@ -1,6 +1,6 @@ --- -description: "Learn more about range concepts." title: " concepts" +description: "Learn more about range concepts." ms.date: 12/16/2022 f1_keywords: ["ranges/std::ranges::range", "ranges/std::ranges::bidirectional_range", "ranges/std::ranges::borrowed_range", "ranges/std::ranges::common_range", "ranges/std::ranges::contiguous_range", "ranges/std::ranges::forward_range", "ranges/std::ranges::input_range", "ranges/std::ranges::output_range", "ranges/std::ranges::random_access_range", "ranges/std::ranges::simple_view", "ranges/std::ranges::sized_range", "ranges/std::ranges::view", "ranges/std::ranges::viewable_range"] helpviewer_keywords: ["std::ranges [C++], ranges::range", "std::ranges [C++], ranges::bidirectional_range", "std::ranges [C++], ranges::borrowed_range", "std::ranges [C++], ranges::common_range", "std::ranges [C++], ranges::contiguous_range", "std::ranges [C++], ranges::forward_range", "std::ranges [C++], ranges::input_range", "std::ranges [C++], ranges::output_range", "std::ranges [C++], ranges::random_access_range", "std::ranges [C++], ranges::simple_view", "std::ranges [C++], ranges::sized_range", "std::ranges [C++], ranges::view", "std::ranges [C++], ranges::viewable_range"] @@ -43,7 +43,7 @@ int main() DivideEmUp dividerOfInts; std::cout << dividerOfInts.Divide(6, 3); // outputs 2 // The following line will not compile because the template can't be instantiated - // with char* because char* can be divided + // with char* because char* can't be divided DivideEmUp dividerOfCharPtrs; // compiler error: cannot deduce template arguments } ``` @@ -163,7 +163,7 @@ The type to test to see if it's a `contiguous_range`. ### Remarks -A `contiguous_range` can be accessed by pointer arithmetic because the elements are laid out sequentially in memory and are the same size. This kind of range supports [`continguous_iterator`](iterator-concepts.md#contiguous_iterator), which is the most flexible of all the iterators. +A `contiguous_range` can be accessed by pointer arithmetic because the elements are laid out sequentially in memory and are the same size. This kind of range supports [`contiguous_iterator`](iterator-concepts.md#contiguous_iterator), which is the most flexible of all the iterators. Some examples of a `contiguous_range` are `std::array`, `std::vector`, and `std::string`. @@ -270,7 +270,7 @@ bidirectional_range && random_access_iterator>; ### Parameters *`T`*\ -The type to test to see if it's a `sized_range`. +The type to test to see if it's a `random_access_range`. ### Remarks diff --git a/docs/standard-library/range-error-class.md b/docs/standard-library/range-error-class.md index a8b6485bcf3..35559c39d45 100644 --- a/docs/standard-library/range-error-class.md +++ b/docs/standard-library/range-error-class.md @@ -1,12 +1,11 @@ --- -description: "Learn more about: range_error Class" -title: "range_error Class" -ms.date: "09/09/2021" +title: "range_error class" +description: "Learn more about: range_error class" +ms.date: 09/09/2021 f1_keywords: ["stdexcept/std::range_error"] helpviewer_keywords: ["range_error class"] -ms.assetid: 8afb3e88-fc49-4213-b096-ed63d7aea37c --- -# range_error Class +# `range_error` class The class serves as the base class for all exceptions thrown to report a range error (as in mathematics, not iterators). @@ -22,7 +21,7 @@ public: ## Remarks -The value returned by [what](../standard-library/exception-class.md) is a copy of `message.data()`. For more information, see [basic_string::data](../standard-library/basic-string-class.md#data). +The value returned by [`what`](exception-class.md) is a copy of `message.data()`. For more information, see [`basic_string::data`](basic-string-class.md#data). ## Example @@ -47,19 +46,20 @@ int main() cerr << "Type: " << typeid(e).name() << endl; } } -/* Output: +``` + +```Output Caught: The range is in error! Type: class std::range_error -*/ ``` ## Requirements -**Header:** \ +**Header:** `` -**Namespace:** std +**Namespace:** `std` ## See also -[runtime_error Class](../standard-library/runtime-error-class.md)\ -[Thread Safety in the C++ Standard Library](../standard-library/thread-safety-in-the-cpp-standard-library.md) +[`runtime_error` class](runtime-error-class.md)\ +[Thread Safety in the C++ Standard Library](thread-safety-in-the-cpp-standard-library.md) diff --git a/docs/standard-library/range-functions.md b/docs/standard-library/range-functions.md index 359201dcd0f..52c5fffab5f 100644 --- a/docs/standard-library/range-functions.md +++ b/docs/standard-library/range-functions.md @@ -482,7 +482,7 @@ int main() } ``` -## `rend` +## `rend` Get a reverse iterator to the sentinel at the end of a reversed view of the range. A reverse iterator returns the elements of the range in reverse order. @@ -571,7 +571,7 @@ int main() } ``` -## `ssize` +## `ssize` Get the size of the range as a signed value. diff --git a/docs/standard-library/ranges-alias-templates.md b/docs/standard-library/ranges-alias-templates.md index 20149175337..8e709eff0ca 100644 --- a/docs/standard-library/ranges-alias-templates.md +++ b/docs/standard-library/ranges-alias-templates.md @@ -1,6 +1,6 @@ --- -description: "Learn more about ranges alias templates." title: " alias templates" +description: "Learn more about ranges alias templates." ms.date: 01/28/2023 f1_keywords: ["ranges/std::ranges::borrowed_iterator_t", "ranges/std::ranges::borrowed_subrange_t", "ranges/std::ranges::dangling", "ranges/std::ranges::iterator_t", "ranges/std::ranges::range_difference_t", "ranges/std::ranges::range_reference_t", "ranges/std::ranges::range_rvalue_reference_t", "ranges/std::ranges::range_size_t", "ranges/std::ranges::range_value_t", "ranges/std::ranges::sentinel_t"] helpviewer_keywords: ["std::ranges [C++], ranges::borrowed_iterator_t", "std::ranges [C++], ranges::borrowed_subrange_t", "std::ranges [C++], ranges::dangling", "std::ranges [C++], ranges::iterator_t", "std::ranges [C++], ranges::range_difference_t", "std::ranges [C++], ranges::range_reference_t", "std::ranges [C++], ranges::range_rvalue_reference_t", "std::ranges [C++], ranges::range_size_t", "std::ranges [C++], ranges::range_value_t", "std::ranges [C++], ranges::sentinel_t"] @@ -10,7 +10,7 @@ helpviewer_keywords: ["std::ranges [C++], ranges::borrowed_iterator_t", "std::ra An alias template is an alias for another type, which can make code more readable. For example, the following alias, `conditional_t`, is an alias for either `borrowed_range` or `dangling` range, depending on the kind of `range` that's passed in: ```cpp -// requires /std:c++20, or later +// requires /std:c++20 or later #include #include @@ -94,7 +94,7 @@ If an algorithm function is passed a range whose iterators depend on its lifetim The following example shows how `borrowed_iterator_t` detects a dangling iterator. The function `ranges::max_element()` uses this template alias to determine the return type: ```cpp -// requires /std:c++20, or later +// requires /std:c++20 or later #include #include @@ -165,7 +165,7 @@ If an algorithm function is passed a range whose iterators depend on its lifetim The following example shows how `borrowed_subrange_t` detects a dangling iterator because `equal_range()` and `max_element` use this template alias to determine the return type: ```cpp -// requires /std:c++20, or later +// requires /std:c++20 or later #include #include @@ -228,7 +228,7 @@ A variable number of non-`void` types. They have no effect. The arguments are a The following example shows how `max_element` detects a dangling iterator. ```cpp -// requires /std:c++20, or later +// requires /std:c++20 or later #include #include @@ -272,7 +272,7 @@ The range type to get the iterator type for. The following example shows how `iterator_t` can be used to declare an iterator for a vector: ```cpp -// requires /std:c++20, or later +// requires /std:c++20 or later #include #include @@ -314,7 +314,7 @@ The range whose iterator will provide the difference type. The following example shows how `range_difference_t` is used to hold the distance between elements in a range: ```cpp -// requires /std:c++20, or later +// requires /std:c++20 or later #include #include @@ -356,7 +356,7 @@ The range for which the reference type of its iterator type is returned. The following example shows `range_reference_t` referring to the type of the elements in a range: ```cpp -// requires /std:c++20, or later +// requires /std:c++20 or later #include #include @@ -399,7 +399,7 @@ The range to get the rvalue reference type to its iterator type. The following example shows `range_rvalue_reference_t` referring to a rvalue type of the elements in a range: ```cpp -// requires /std:c++20, or later +// requires /std:c++20 or later #include #include @@ -442,7 +442,7 @@ The range to get the type of its `size` function. The following example shows `range_size_t` referring to the number of elements in a range: ```cpp -// requires /std:c++20, or later +// requires /std:c++20 or later #include #include @@ -484,7 +484,7 @@ The range to get the value type of its iterator. The following example shows how `range_value_t` refers to the type of elements in a range: ```cpp -// requires /std:c++20, or later +// requires /std:c++20 or later #include #include @@ -526,7 +526,7 @@ The range to get the sentinel type for. The following example shows using `sentinel_t` to determine whether the iterator type and sentinel type are the same: ```cpp -// requires /std:c++20, or later +// requires /std:c++20 or later #include #include diff --git a/docs/standard-library/rank-class.md b/docs/standard-library/rank-class.md index 7812e4b0417..f1c39092e5d 100644 --- a/docs/standard-library/rank-class.md +++ b/docs/standard-library/rank-class.md @@ -1,41 +1,41 @@ --- -description: "Learn more about: rank Class" -title: "rank Class" -ms.date: "11/04/2016" +title: "rank class" +description: "Learn more about: rank class" +ms.date: 08/28/2025 f1_keywords: ["type_traits/std::rank"] helpviewer_keywords: ["rank class", "rank"] -ms.assetid: bc9f1b8f-800f-46ca-b6f4-d8579ed5406a --- -# rank Class +# `rank` class Gets number of array dimensions. ## Syntax ```cpp -template +template struct rank; ``` -### Parameters +### Template parameters -*Ty*\ +*`Type`*\ The type to query. ## Remarks -The type query holds the value of the number of dimensions of the array type *Ty*, or 0 if *Ty* is not an array type. +The type query holds the value of the number of dimensions of the array type *`Type`*, or 0 if *`Type`* is not an array type. ## Example ```cpp // std__type_traits__rank.cpp // compile with: /EHsc + #include #include int main() - { +{ std::cout << "rank == " << std::rank::value << std::endl; std::cout << "rank == " @@ -43,23 +43,32 @@ int main() std::cout << "rank == " << std::rank::value << std::endl; - return (0); - } + int single_dim_array[]{ 1, 2, 3 }; + int double_dim_array[2][1]{ { 4 }, { 5 } }; + + std::cout << "\nrank == " + << std::rank::value << std::endl; + std::cout << "rank == " + << std::rank::value << std::endl; +} ``` ```Output rank == 0 rank == 1 rank == 2 + +rank == 1 +rank == 2 ``` ## Requirements -**Header:** \ +**Header:** `` -**Namespace:** std +**Namespace:** `std` ## See also -[](../standard-library/type-traits.md)\ -[extent Class](../standard-library/extent-class.md) +[``](type-traits.md)\ +[`extent` class](extent-class.md) diff --git a/docs/standard-library/ratio.md b/docs/standard-library/ratio.md index 05922b7ff4b..1df9000050b 100644 --- a/docs/standard-library/ratio.md +++ b/docs/standard-library/ratio.md @@ -1,9 +1,8 @@ --- -description: "Learn more about: " title: "" -ms.date: "11/04/2016" +description: "Learn more about: " +ms.date: 11/04/2016 f1_keywords: ["", "ratio/std::mega", "ratio/std::peta", "ratio/std::ratio_greater", "ratio/std::micro", "ratio/std::ratio_add", "ratio/std::ratio_not_equal", "ratio/std::hecto", "ratio/std::nano", "ratio/std::ratio_less_equal", "ratio/std::ratio_less", "ratio/std::centi", "ratio/std::ratio_greater_equal", "ratio/std::ratio_subtract", "ratio/std::atto", "ratio/std::tera", "ratio/std::milli", "ratio/std::ratio_multiply", "ratio/std::kilo", "ratio/std::ratio_divide", "ratio/std::giga", "ratio/std::pico", "ratio/std::femto", "ratio/std::ratio_equal", "ratio/std::ratio", "ratio/std::exa", "ratio/std::deci", "ratio/std::deca"] -ms.assetid: 8543e912-2d84-45ea-b3c0-bd7bfacee405 --- # `` @@ -24,7 +23,7 @@ struct ratio // holds the ratio of Numerator to Denominator static constexpr std::intmax_t num; static constexpr std::intmax_t den; typedef ratio type; -} +}; ``` The template `ratio` defines the static constants `num` and `den` such that `num` / `den` == Numerator / Denominator and `num` and `den` have no common factors. `num` / `den` is the value that is represented by the class template. Therefore, `type` designates the instantiation `ratio`. diff --git a/docs/standard-library/raw-storage-iterator-class.md b/docs/standard-library/raw-storage-iterator-class.md index 3e8ce704732..e4efd88df18 100644 --- a/docs/standard-library/raw-storage-iterator-class.md +++ b/docs/standard-library/raw-storage-iterator-class.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: raw_storage_iterator Class" title: "raw_storage_iterator Class" +description: "Learn more about: raw_storage_iterator Class" ms.date: 06/17/2022 f1_keywords: ["memory/std::raw_storage_iterator", "memory/std::raw_storage_iterator::element_type", "memory/std::raw_storage_iterator::iter_type"] helpviewer_keywords: ["std::raw_storage_iterator [C++]", "std::raw_storage_iterator [C++], element_type", "std::raw_storage_iterator [C++], iter_type"] -ms.assetid: 6f033f15-f48e-452a-a326-647ea2cf346f ms.custom: devdivchpfy22 --- # raw_storage_iterator Class @@ -114,7 +113,7 @@ public: cout << "Constructing " << i << endl; x = i; bIsConstructed = true; - }; + } Int &operator=(int i) { @@ -123,7 +122,7 @@ public: cout << "Copying " << i << endl; x = i; return *this; - }; + } int x; @@ -135,9 +134,9 @@ int main( void) { Int *pInt = ( Int* ) malloc( sizeof( Int ) ); memset( pInt, 0, sizeof( Int ) ); // Set bIsConstructed to false; -*pInt = 5; + *pInt = 5; raw_storage_iterator< Int*, Int > it( pInt ); -*it = 5; + *it = 5; } ``` @@ -190,14 +189,14 @@ public: cout << "Constructing " << i << endl; x = i; bIsConstructed = true; - }; + } Int &operator=( int i ) { if ( !bIsConstructed ) cout << "Not constructed.\n"; cout << "Copying " << i << endl; x = i; return *this; - }; + } int x; private: bool bIsConstructed; @@ -262,9 +261,9 @@ int main( void ) std::raw_storage_iterator it( pInt ); for ( int i = 0; i < 5; i++, it++ ) { *it = 2 * i; - }; + } - for ( int i = 0; i < 5; i++ ) cout << "array " << i << " = " << pInt[i] << endl;; + for ( int i = 0; i < 5; i++ ) cout << "array " << i << " = " << pInt[i] << endl; delete[] pInt; } @@ -310,13 +309,13 @@ public: cout << "Constructing " << i << endl; x = i; bIsConstructed = true; - }; + } Int &operator=( int i ) { if (!bIsConstructed) cout << "Error! I'm not constructed!\n"; cout << "Copying " << i << endl; x = i; return *this; - }; + } int x; bool bIsConstructed; }; @@ -335,7 +334,7 @@ int main( void ) std::copy( l.begin( ), l.end( ), pInt ); // C4996 for (unsigned int i = 0; i < l.size( ); i++) - cout << "array " << i << " = " << pInt[i].x << endl;; + cout << "array " << i << " = " << pInt[i].x << endl; memset (pInt, 0, sizeof(Int)*l.size( )); // hack: make sure bIsConstructed is false diff --git a/docs/standard-library/recursive-mutex-class.md b/docs/standard-library/recursive-mutex-class.md index 451a7686a46..68223c40baa 100644 --- a/docs/standard-library/recursive-mutex-class.md +++ b/docs/standard-library/recursive-mutex-class.md @@ -1,9 +1,8 @@ --- -description: "Learn more about: recursive_mutex Class" title: "recursive_mutex Class" -ms.date: "11/04/2016" +description: "Learn more about: recursive_mutex Class" +ms.date: 11/04/2016 f1_keywords: ["mutex/std::recursive_mutex", "mutex/std::recursive_mutex::recursive_mutex", "mutex/std::recursive_mutex::lock", "mutex/std::recursive_mutex::try_lock", "mutex/std::recursive_mutex::unlock"] -ms.assetid: eb5ffd1b-7e78-4559-8391-bb220ead42fc helpviewer_keywords: ["std::recursive_mutex [C++]", "std::recursive_mutex [C++], recursive_mutex", "std::recursive_mutex [C++], lock", "std::recursive_mutex [C++], try_lock", "std::recursive_mutex [C++], unlock"] --- # recursive_mutex Class @@ -59,7 +58,7 @@ Constructs a `recursive_mutex` object that is not locked. recursive_mutex(); ``` -## ~recursive_mutex +## ~recursive_mutex Releases any resources that are used by the object. diff --git a/docs/standard-library/recursive-timed-mutex-class.md b/docs/standard-library/recursive-timed-mutex-class.md index 3728a0eb94d..d105a0a2646 100644 --- a/docs/standard-library/recursive-timed-mutex-class.md +++ b/docs/standard-library/recursive-timed-mutex-class.md @@ -1,9 +1,8 @@ --- -description: "Learn more about: recursive_timed_mutex Class" title: "recursive_timed_mutex Class" -ms.date: "11/04/2016" +description: "Learn more about: recursive_timed_mutex Class" +ms.date: 11/04/2016 f1_keywords: ["mutex/std::recursive_timed_mutex", "mutex/std::recursive_timed_mutex::recursive_timed_mutex", "mutex/std::recursive_timed_mutex::lock", "mutex/std::recursive_timed_mutex::try_lock", "mutex/std::recursive_timed_mutex::try_lock_for", "mutex/std::recursive_timed_mutex::try_lock_until", "mutex/std::recursive_timed_mutex::unlock"] -ms.assetid: 59cc2d5c-ed80-45f3-a0a8-05652a8ead7e helpviewer_keywords: ["std::recursive_timed_mutex [C++]", "std::recursive_timed_mutex [C++], recursive_timed_mutex", "std::recursive_timed_mutex [C++], lock", "std::recursive_timed_mutex [C++], try_lock", "std::recursive_timed_mutex [C++], try_lock_for", "std::recursive_timed_mutex [C++], try_lock_until", "std::recursive_timed_mutex [C++], unlock"] --- # recursive_timed_mutex Class @@ -61,7 +60,7 @@ Constructs a `recursive_timed_mutex` object that is not locked. recursive_timed_mutex(); ``` -## ~recursive_timed_mutex Destructor +## ~recursive_timed_mutex Destructor Releases any resources that are used by the `recursive_timed_mutex` object. diff --git a/docs/standard-library/regex-constants-class.md b/docs/standard-library/regex-constants-class.md index 63ef9ea01f1..df849bdbf67 100644 --- a/docs/standard-library/regex-constants-class.md +++ b/docs/standard-library/regex-constants-class.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: regex_constants namespace" title: "regex_constants Class" -ms.date: "09/10/2018" +description: "Learn more about: regex_constants namespace" +ms.date: 09/10/2018 f1_keywords: ["regex/std::regex_constants", "regex/std::regex_constants::error_collate", "regex/std::regex_constants::error_ctype", "regex/std::regex_constants::error_escape", "regex/std::regex_constants::error_backref", "regex/std::regex_constants::error_brack", "regex/std::regex_constants::error_paren", "regex/std::regex_constants::error_brace", "regex/std::regex_constants::error_badbrace", "regex/std::regex_constants::error_range", "regex/std::regex_constants::error_space", "regex/std::regex_constants::error_badrepeat", "regex/std::regex_constants::error_complexity", "regex/std::regex_constants::error_stack", "regex/std::regex_constants::error_parse", "regex/std::regex_constants::error_syntax", "regex/std::regex_constants::match_default", "regex/std::regex_constants::match_not_bol", "regex/std::regex_constants::match_not_eol", "regex/std::regex_constants::match_not_bow", "regex/std::regex_constants::match_not_eow", "regex/std::regex_constants::match_any", "regex/std::regex_constants::match_not_null", "regex/std::regex_constants::match_continuous", "regex/std::regex_constants::match_prev_avail", "regex/std::regex_constants::format_default", "regex/std::regex_constants::format_sed", "regex/std::regex_constants::format_no_copy", "regex/std::regex_constants::format_first_only", "regex/std::regex_constants::ECMAScript", "regex/std::regex_constants::basic", "regex/std::regex_constants::extended", "regex/std::regex_constants::awk", "regex/std::regex_constants::grep", "regex/std::regex_constants::egrep", "regex/std::regex_constants::icase", "regex/std::regex_constants::nosubs", "regex/std::regex_constants::optimize", "regex/std::regex_constants::collate"] helpviewer_keywords: ["std::regex_constants [C++]", "std::regex_constants [C++], error_collate", "std::regex_constants [C++], error_ctype", "std::regex_constants [C++], error_escape", "std::regex_constants [C++], error_backref", "std::regex_constants [C++], error_brack", "std::regex_constants [C++], error_paren", "std::regex_constants [C++], error_brace", "std::regex_constants [C++], error_badbrace", "std::regex_constants [C++], error_range", "std::regex_constants [C++], error_space", "std::regex_constants [C++], error_badrepeat", "std::regex_constants [C++], error_complexity", "std::regex_constants [C++], error_stack", "std::regex_constants [C++], error_parse", "std::regex_constants [C++], error_syntax", "std::regex_constants [C++], match_default", "std::regex_constants [C++], match_not_bol", "std::regex_constants [C++], match_not_eol", "std::regex_constants [C++], match_not_bow", "std::regex_constants [C++], match_not_eow", "std::regex_constants [C++], match_any", "std::regex_constants [C++], match_not_null", "std::regex_constants [C++], match_continuous", "std::regex_constants [C++], match_prev_avail", "std::regex_constants [C++], format_default", "std::regex_constants [C++], format_sed", "std::regex_constants [C++], format_no_copy", "std::regex_constants [C++], format_first_only", "std::regex_constants [C++], ECMAScript", "std::regex_constants [C++], basic", "std::regex_constants [C++], extended", "std::regex_constants [C++], awk", "std::regex_constants [C++], grep", "std::regex_constants [C++], egrep", "std::regex_constants [C++], icase", "std::regex_constants [C++], nosubs", "std::regex_constants [C++], optimize", "std::regex_constants [C++], collate"] -ms.assetid: 4a69c0ba-c46d-46e4-bd29-6f4efb805f26 --- # regex_constants namespace @@ -199,7 +198,7 @@ The syntax modifiers are: `icase` -- make matches case-insensitive -`nosubs` -- the implementaton need not keep track of the contents of capture groups +`nosubs` -- the implementation need not keep track of the contents of capture groups `optimize` -- the implementation should emphasize speed of matching rather than speed of regular expression compilation diff --git a/docs/standard-library/regex-operators.md b/docs/standard-library/regex-operators.md index 093cb93bd7d..f062a76a49b 100644 --- a/docs/standard-library/regex-operators.md +++ b/docs/standard-library/regex-operators.md @@ -1,19 +1,12 @@ --- -description: "Learn more about: operators" title: " operators" -ms.date: "11/04/2016" +description: "Learn more about: operators" +ms.date: 11/04/2016 f1_keywords: ["regex/std::operator!=", "regex/std::operator>", "regex/std::operator>=", "regex/std::operator<", "regex/std::operator<=", "regex/std::operator==", "regex/std::operator<<"] -ms.assetid: ec623e65-c186-491f-aa18-6b12b47e1127 --- # `` operators -[operator!=](#op_neq)\ -[`operator>`](#op_gt)\ -[`operator>=`](#op_gt_eq)\ -[`operator<`](#op_lt)\ -[`operator<<`](#op_lt_lt)\ -[`operator<=`](#op_lt_eq)\ -[operator==](#op_eq_eq) +The `` header provides the following operators: ## operator!= diff --git a/docs/standard-library/regex-traits-class.md b/docs/standard-library/regex-traits-class.md index 512a4b7093c..95fd141c40e 100644 --- a/docs/standard-library/regex-traits-class.md +++ b/docs/standard-library/regex-traits-class.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: regex_traits Class" title: "regex_traits Class" -ms.date: "09/10/2018" +description: "Learn more about: regex_traits Class" +ms.date: 09/10/2018 f1_keywords: ["regex/std::regex_traits", "regex/std::regex_traits::char_type", "regex/std::regex_traits::size_type", "regex/std::regex_traits::string_type", "regex/std::regex_traits::locale_type", "regex/std::regex_traits::char_class_type", "regex/std::regex_traits::length", "regex/std::regex_traits::translate", "regex/std::regex_traits::translate_nocase", "regex/std::regex_traits::transform", "regex/std::regex_traits::transform_primary", "regex/std::regex_traits::lookup_classname", "regex/std::regex_traits::lookup_collatename", "regex/std::regex_traits::isctype", "regex/std::regex_traits::value", "regex/std::regex_traits::imbue", "regex/std::regex_traits::getloc"] helpviewer_keywords: ["std::regex_traits [C++]", "std::regex_traits [C++], char_type", "std::regex_traits [C++], size_type", "std::regex_traits [C++], string_type", "std::regex_traits [C++], locale_type", "std::regex_traits [C++], char_class_type", "std::regex_traits [C++], length", "std::regex_traits [C++], translate", "std::regex_traits [C++], translate_nocase", "std::regex_traits [C++], transform", "std::regex_traits [C++], transform_primary", "std::regex_traits [C++], lookup_classname", "std::regex_traits [C++], lookup_collatename", "std::regex_traits [C++], isctype", "std::regex_traits [C++], value", "std::regex_traits [C++], imbue", "std::regex_traits [C++], getloc"] -ms.assetid: bc5a5eed-32fc-4eb7-913d-71c42e729e81 --- # regex_traits Class @@ -24,7 +23,7 @@ The character element type to describe. ## Remarks -The class template describes various regular expression traits for type *Elem*. The class template [basic_regex Class](../standard-library/basic-regex-class.md) uses this information to manipulate elements of type *Elem*. +The class template describes various regular expression traits for type *Elem*. The class template [`basic_regex`](../standard-library/basic-regex-class.md) uses this information to manipulate elements of type *Elem*. Each `regex_traits` object holds an object of type `regex_traits::locale` which is used by some of its member functions. The default locale is a copy of `regex_traits::locale()`. The member function `imbue` replaces the locale object, and the member function `getloc` returns a copy of the locale object. diff --git a/docs/standard-library/regex-typedefs.md b/docs/standard-library/regex-typedefs.md index d9d1058fe18..4c7f083ccd4 100644 --- a/docs/standard-library/regex-typedefs.md +++ b/docs/standard-library/regex-typedefs.md @@ -1,30 +1,12 @@ --- -description: "Learn more about: typedefs" title: " typedefs" -ms.date: "11/04/2016" +description: "Learn more about: typedefs" +ms.date: 11/04/2016 f1_keywords: ["regex/std::cmatch", "regex/std::cregex_iterator", "regex/std::cregex_token_iterator", "regex/std::csub_match", "regex/std::regex", "regex/std::smatch", "regex/std::sregex_iterator", "regex/std::sregex_token_iterator", "regex/std::ssub_match", "regex/std::wcmatch", "regex/std::wcregex_iterator", "regex/std::wcregex_token_iterator", "regex/std::wcsub_match", "regex/std::wregex", "regex/std::wsmatch", "regex/std::wsregex_iterator", "regex/std::wsregex_token_iterator", "regex/std::wssub_match"] -ms.assetid: e6a69067-106c-4a24-9e08-7c867a3a2260 --- # `` typedefs -[cmatch](#cmatch)\ -[cregex_iterator](#cregex_iterator)\ -[cregex_token_iterator](#cregex_token_iterator)\ -[csub_match](#csub_match)\ -[regex](#regex)\ -[smatch](#smatch)\ -[sregex_iterator](#sregex_iterator)\ -[sregex_token_iterator](#sregex_token_iterator)\ -[ssub_match](#ssub_match)\ -[wcmatch](#wcmatch)\ -[wcregex_iterator](#wcregex_iterator)\ -[wcregex_token_iterator](#wcregex_token_iterator)\ -[wcsub_match](#wcsub_match)\ -[wregex](#wregex)\ -[wsmatch](#wsmatch)\ -[wsregex_iterator](#wsregex_iterator)\ -[wsregex_token_iterator](#wsregex_token_iterator)\ -[wssub_match](#wssub_match) +The `` header provides the following typedefs: ## cmatch Typedef @@ -36,7 +18,7 @@ typedef match_results cmatch; ### Remarks -The type describes a specialization of class template [match_results Class](../standard-library/match-results-class.md) for iterators of type `const char*`. +The type describes a specialization of class template [`match_results`](../standard-library/match-results-class.md) for iterators of type `const char*`. ## cregex_iterator Typedef @@ -48,7 +30,7 @@ typedef regex_iterator cregex_iterator; ### Remarks -The type describes a specialization of class template [regex_iterator Class](../standard-library/regex-iterator-class.md) for iterators of type `const char*`. +The type describes a specialization of class template [`regex_iterator`](../standard-library/regex-iterator-class.md) for iterators of type `const char*`. ## cregex_token_iterator Typedef @@ -60,7 +42,7 @@ typedef regex_token_iterator cregex_token_iterator; ### Remarks -The type describes a specialization of class template [regex_token_iterator Class](../standard-library/regex-token-iterator-class.md) for iterators of type `const char*`. +The type describes a specialization of class template [`regex_token_iterator`](../standard-library/regex-token-iterator-class.md) for iterators of type `const char*`. ## csub_match Typedef @@ -72,7 +54,7 @@ typedef sub_match csub_match; ### Remarks -The type describes a specialization of class template [sub_match Class](../standard-library/sub-match-class.md) for iterators of type `const char*`. +The type describes a specialization of class template [`sub_match`](../standard-library/sub-match-class.md) for iterators of type `const char*`. ## regex Typedef @@ -84,7 +66,7 @@ typedef basic_regex regex; ### Remarks -The type describes a specialization of class template [basic_regex Class](../standard-library/basic-regex-class.md) for elements of type **`char`**. +The type describes a specialization of class template [`basic_regex`](../standard-library/basic-regex-class.md) for elements of type **`char`**. > [!NOTE] > High-bit characters will have unpredictable results with `regex`. Values outside the range of 0 to 127 may result in undefined behavior. @@ -99,7 +81,7 @@ typedef match_results smatch; ### Remarks -The type describes a specialization of class template [match_results Class](../standard-library/match-results-class.md) for iterators of type `string::const_iterator`. +The type describes a specialization of class template [`match_results`](../standard-library/match-results-class.md) for iterators of type `string::const_iterator`. ## sregex_iterator Typedef @@ -111,7 +93,7 @@ typedef regex_iterator sregex_iterator; ### Remarks -The type describes a specialization of class template [regex_iterator Class](../standard-library/regex-iterator-class.md) for iterators of type `string::const_iterator`. +The type describes a specialization of class template [`regex_iterator`](../standard-library/regex-iterator-class.md) for iterators of type `string::const_iterator`. ## sregex_token_iterator Typedef @@ -123,7 +105,7 @@ typedef regex_token_iterator sregex_token_iterator; ### Remarks -The type describes a specialization of class template [regex_token_iterator Class](../standard-library/regex-token-iterator-class.md) for iterators of type `string::const_iterator`. +The type describes a specialization of class template [`regex_token_iterator`](../standard-library/regex-token-iterator-class.md) for iterators of type `string::const_iterator`. ## ssub_match Typedef @@ -135,7 +117,7 @@ typedef sub_match ssub_match; ### Remarks -The type describes a specialization of class template [sub_match Class](../standard-library/sub-match-class.md) for iterators of type `string::const_iterator`. +The type describes a specialization of class template [`sub_match`](../standard-library/sub-match-class.md) for iterators of type `string::const_iterator`. ## wcmatch Typedef @@ -147,7 +129,7 @@ typedef match_results wcmatch; ### Remarks -The type describes a specialization of class template [match_results Class](../standard-library/match-results-class.md) for iterators of type `const wchar_t*`. +The type describes a specialization of class template [`match_results`](../standard-library/match-results-class.md) for iterators of type `const wchar_t*`. ## wcregex_iterator Typedef @@ -159,7 +141,7 @@ typedef regex_iterator wcregex_iterator; ### Remarks -The type describes a specialization of class template [regex_iterator Class](../standard-library/regex-iterator-class.md) for iterators of type `const wchar_t*`. +The type describes a specialization of class template [`regex_iterator`](../standard-library/regex-iterator-class.md) for iterators of type `const wchar_t*`. ## wcregex_token_iterator Typedef @@ -171,7 +153,7 @@ typedef regex_token_iterator wcregex_token_iterator; ### Remarks -The type describes a specialization of class template [regex_token_iterator Class](../standard-library/regex-token-iterator-class.md) for iterators of type `const wchar_t*`. +The type describes a specialization of class template [`regex_token_iterator`](../standard-library/regex-token-iterator-class.md) for iterators of type `const wchar_t*`. ## wcsub_match Typedef @@ -183,7 +165,7 @@ typedef sub_match wcsub_match; ### Remarks -The type describes a specialization of class template [sub_match Class](../standard-library/sub-match-class.md) for iterators of type `const wchar_t*`. +The type describes a specialization of class template [`sub_match`](../standard-library/sub-match-class.md) for iterators of type `const wchar_t*`. ## wregex Typedef @@ -195,7 +177,7 @@ typedef basic_regex wregex; ### Remarks -The type describes a specialization of class template [basic_regex Class](../standard-library/basic-regex-class.md) for elements of type **`wchar_t`**. +The type describes a specialization of class template [`basic_regex`](../standard-library/basic-regex-class.md) for elements of type **`wchar_t`**. ## wsmatch Typedef @@ -207,7 +189,7 @@ typedef match_results wsmatch; ### Remarks -The type describes a specialization of class template [match_results Class](../standard-library/match-results-class.md) for iterators of type `wstring::const_iterator`. +The type describes a specialization of class template [`match_results`](../standard-library/match-results-class.md) for iterators of type `wstring::const_iterator`. ## wsregex_iterator Typedef @@ -219,7 +201,7 @@ typedef regex_iterator wsregex_iterator; ### Remarks -The type describes a specialization of class template [regex_iterator Class](../standard-library/regex-iterator-class.md) for iterators of type `wstring::const_iterator`. +The type describes a specialization of class template [`regex_iterator`](../standard-library/regex-iterator-class.md) for iterators of type `wstring::const_iterator`. ## wsregex_token_iterator Typedef @@ -231,7 +213,7 @@ typedef regex_token_iterator wsregex_token_iterator; ### Remarks -The type describes a specialization of class template [regex_token_iterator Class](../standard-library/regex-token-iterator-class.md) for iterators of type `wstring::const_iterator`. +The type describes a specialization of class template [`regex_token_iterator`](../standard-library/regex-token-iterator-class.md) for iterators of type `wstring::const_iterator`. ## wssub_match Typedef @@ -243,7 +225,7 @@ typedef sub_match wssub_match; ### Remarks -The type describes a specialization of class template [sub_match Class](../standard-library/sub-match-class.md) for iterators of type `wstring::const_iterator`. +The type describes a specialization of class template [`sub_match`](../standard-library/sub-match-class.md) for iterators of type `wstring::const_iterator`. ## See also diff --git a/docs/standard-library/regex.md b/docs/standard-library/regex.md index 290bf331a60..7a11ed48c83 100644 --- a/docs/standard-library/regex.md +++ b/docs/standard-library/regex.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: " title: "" -ms.date: "11/04/2016" +description: "Learn more about: " +ms.date: 11/04/2016 f1_keywords: [""] helpviewer_keywords: ["regex header"] --- @@ -17,9 +17,9 @@ Defines a class template to parse [Regular Expressions (C++)](../standard-librar ## Remarks -To create a regular expression object, use the class template [`basic_regex` Class](../standard-library/basic-regex-class.md) or one of its specializations, [`regex`](../standard-library/regex-typedefs.md#regex) and [`wregex`](../standard-library/regex-typedefs.md#wregex), together with the syntax flags of type [`regex_constants::syntax_option_type`](../standard-library/regex-constants-class.md#syntax_option_type). +To create a regular expression object, use the class template [`basic_regex`](../standard-library/basic-regex-class.md) or one of its specializations, [`regex`](../standard-library/regex-typedefs.md#regex) and [`wregex`](../standard-library/regex-typedefs.md#wregex), together with the syntax flags of type [`regex_constants::syntax_option_type`](../standard-library/regex-constants-class.md#syntax_option_type). -To search text for matches to a regular expression object, use the template functions [`regex_match`](../standard-library/regex-functions.md#regex_match) and [`regex_search`](../standard-library/regex-functions.md#regex_search), together with the match flags of type [`regex_constants::match_flag_type`](../standard-library/regex-constants-class.md#match_flag_type). These functions return results by using the class template [`match_results` Class](../standard-library/match-results-class.md) and its specializations, [`cmatch`](../standard-library/regex-typedefs.md#cmatch), [`wcmatch`](../standard-library/regex-typedefs.md#wcmatch), [`smatch`](../standard-library/regex-typedefs.md#smatch), and [`wsmatch`](../standard-library/regex-typedefs.md#wsmatch), together with the class template [`sub_match` Class](../standard-library/sub-match-class.md) and its specializations, [`csub_match`](../standard-library/regex-typedefs.md#csub_match), [`wcsub_match`](../standard-library/regex-typedefs.md#wcsub_match), [`ssub_match`](../standard-library/regex-typedefs.md#ssub_match), and [`wssub_match`](../standard-library/regex-typedefs.md#wssub_match). +To search text for matches to a regular expression object, use the template functions [`regex_match`](../standard-library/regex-functions.md#regex_match) and [`regex_search`](../standard-library/regex-functions.md#regex_search), together with the match flags of type [`regex_constants::match_flag_type`](../standard-library/regex-constants-class.md#match_flag_type). These functions return results by using the class template [`match_results`](../standard-library/match-results-class.md) and its specializations, [`cmatch`](../standard-library/regex-typedefs.md#cmatch), [`wcmatch`](../standard-library/regex-typedefs.md#wcmatch), [`smatch`](../standard-library/regex-typedefs.md#smatch), and [`wsmatch`](../standard-library/regex-typedefs.md#wsmatch), together with the class template [`sub_match`](../standard-library/sub-match-class.md) and its specializations, [`csub_match`](../standard-library/regex-typedefs.md#csub_match), [`wcsub_match`](../standard-library/regex-typedefs.md#wcsub_match), [`ssub_match`](../standard-library/regex-typedefs.md#ssub_match), and [`wssub_match`](../standard-library/regex-typedefs.md#wssub_match). To replace text that matches a regular expression object, use the template function [`regex_replace`](../standard-library/regex-functions.md#regex_replace), together with the match flags of type [`regex_constants::match_flag_type`](../standard-library/regex-constants-class.md#match_flag_type). @@ -81,7 +81,7 @@ To modify the details of the grammar of regular expressions, write a class that |[`operator==`](../standard-library/regex-operators.md#op_eq_eq)|Comparison of various objects, equal.| |[`operator!=`](../standard-library/regex-operators.md#op_neq)|Comparison of various objects, not equal.| |[`operator<`](../standard-library/regex-operators.md#op_lt)|Comparison of various objects, less than.| -|[`operator\<=`](../standard-library/regex-operators.md#op_gt_eq)|Comparison of various objects, less than or equal.| +|[`operator<=`](../standard-library/regex-operators.md#op_lt_eq)|Comparison of various objects, less than or equal.| |[`operator>`](../standard-library/regex-operators.md#op_gt)|Comparison of various objects, greater than.| |[`operator>=`](../standard-library/regex-operators.md#op_gt_eq)|Comparison of various objects, greater than or equal.| |[`operator<<`](../standard-library/regex-operators.md#op_lt_lt)|Inserts a `sub_match` in a stream.| diff --git a/docs/standard-library/regular-expressions-cpp.md b/docs/standard-library/regular-expressions-cpp.md index 8b4505025ce..4704305fde6 100644 --- a/docs/standard-library/regular-expressions-cpp.md +++ b/docs/standard-library/regular-expressions-cpp.md @@ -1,6 +1,6 @@ --- -description: "Learn more about: Regular Expressions (C++)" title: "Regular Expressions (C++)" +description: "Learn more about: Regular Expressions (C++)" ms.date: 07/15/2021 helpviewer_keywords: ["regular expressions [C++]"] no-loc: [ECMAScript, basic, extended, awk, grep, egrep] @@ -12,7 +12,7 @@ The C++ standard library supports multiple regular expression grammars. This top ## Regular expression grammar -The regular expression grammar to use is by specified by the use of one of the `std::regex_constants::syntax_option_type` enumeration values. These regular expression grammars are defined in `std::regex_constants`: +The regular expression grammar to use is specified by the use of one of the `std::regex_constants::syntax_option_type` enumeration values. These regular expression grammars are defined in `std::regex_constants`: - ECMAScript: This is closest to the grammar used by JavaScript and the .NET languages. - basic: The POSIX basic regular expressions or BRE. @@ -56,7 +56,7 @@ An element can be one of the following: - An *anchor*. Anchor `^` matches the beginning of the target sequence. Anchor `$` matches the end of the target sequence. -A *capture group* of the form (*subexpression*), or \\(*subexpression*\\) in basic and grep, which matches the sequence of characters in the target sequence that is matched by the pattern between the delimiters. +- A *capture group* of the form (*subexpression*), or \\(*subexpression*\\) in basic and grep, which matches the sequence of characters in the target sequence that is matched by the pattern between the delimiters. - An *identity escape* of the form `\k`, which matches the character `k` in the target sequence. @@ -92,7 +92,7 @@ In ECMAScript, an element can also be one of the following: - A *control escape sequence* of the form `\ck`. Matches the control character that is named by the character `k`. -- A *word boundary assert* of the form`\b`. Matches when the current position in the target sequence is immediately after a *word boundary*. +- A *word boundary assert* of the form `\b`. Matches when the current position in the target sequence is immediately after a *word boundary*. - A *negative word boundary assert* of the form `\B`. Matches when the current position in the target sequence isn't immediately after a *word boundary*. diff --git a/docs/standard-library/runtime-error-class.md b/docs/standard-library/runtime-error-class.md index e71e28e5ddf..9ae07afd607 100644 --- a/docs/standard-library/runtime-error-class.md +++ b/docs/standard-library/runtime-error-class.md @@ -1,12 +1,11 @@ --- -description: "Learn more about: runtime_error Class" -title: "runtime_error Class" -ms.date: "09/09/2021" +title: "runtime_error class" +description: "Learn more about: runtime_error class" +ms.date: 09/09/2021 f1_keywords: ["stdexcept/std::runtime_error"] helpviewer_keywords: ["runtime_error class"] -ms.assetid: 4d0227bf-847b-45a2-a320-2351ebf98368 --- -# runtime_error Class +# `runtime_error` class The class serves as the base class for all exceptions thrown to report errors presumably detectable only when the program executes. @@ -18,13 +17,12 @@ public: explicit runtime_error(const string& message); explicit runtime_error(const char *message); - }; ``` ## Remarks -The value returned by `what()` is a copy of `message.data()`. For more information, see [`what`](../standard-library/exception-class.md) and [`data`](../standard-library/basic-string-class.md#data). +The value returned by `what()` is a copy of `message.data()`. For more information, see [`what`](exception-class.md) and [`data`](basic-string-class.md#data). ## Example @@ -49,19 +47,20 @@ int main() cerr << "Type: " << typeid(e).name() << endl; } } -/* Output: +``` + +```Output Caught: bad locale name Type: class std::runtime_error -*/ ``` ## Requirements -**Header:** \ +**Header:** `` -**Namespace:** std +**Namespace:** `std` ## See also -[exception Class](../standard-library/exception-class.md)\ -[Thread Safety in the C++ Standard Library](../standard-library/thread-safety-in-the-cpp-standard-library.md) +[`exception` class](exception-class.md)\ +[Thread Safety in the C++ Standard Library](thread-safety-in-the-cpp-standard-library.md) diff --git a/docs/standard-library/scl-secure-no-warnings.md b/docs/standard-library/scl-secure-no-warnings.md index fd9ef309d15..3b64ea9b133 100644 --- a/docs/standard-library/scl-secure-no-warnings.md +++ b/docs/standard-library/scl-secure-no-warnings.md @@ -1,14 +1,13 @@ --- -description: "Learn more about: _SCL_SECURE_NO_WARNINGS" title: "_SCL_SECURE_NO_WARNINGS" -ms.date: "11/04/2016" +description: "Learn more about: _SCL_SECURE_NO_WARNINGS" +ms.date: 11/04/2016 f1_keywords: ["_SCL_SECURE_NO_DEPRECATE", "_SCL_SECURE_NO_WARNINGS"] helpviewer_keywords: ["_SCL_SECURE_NO_DEPRECATE", "_SCL_SECURE_NO_WARNINGS"] -ms.assetid: ef0ddea9-7c62-4b53-8b64-5f4fd369776f --- -# _SCL_SECURE_NO_WARNINGS +# `_SCL_SECURE_NO_WARNINGS` -Calling any of the potentially unsafe methods in the C++ Standard Library results in [Compiler Warning (level 3) C4996](../error-messages/compiler-warnings/compiler-warning-level-3-c4996.md). To disable this warning, define the macro _SCL_SECURE_NO_WARNINGS in your code: +Calling any of the potentially unsafe methods in the C++ Standard Library results in [Compiler Warning (level 3) C4996](../error-messages/compiler-warnings/compiler-warning-level-3-c4996.md). To disable this warning, define the macro `_SCL_SECURE_NO_WARNINGS` in your code: ```cpp #define _SCL_SECURE_NO_WARNINGS @@ -20,26 +19,32 @@ If you use precompiled headers, put this directive in your precompiled header fi Other ways to disable warning C4996 include: -- Using the [/D (Preprocessor Definitions)](../build/reference/d-preprocessor-definitions.md) compiler option: +- Using the [`/D` (Preprocessor Definitions)](../build/reference/d-preprocessor-definitions.md) compiler option: - > cl /D_SCL_SECURE_NO_WARNINGS [other compiler options] myfile.cpp + ```cmd + cl /D_SCL_SECURE_NO_WARNINGS [other compiler options] myfile.cpp + ``` -- Using the [/w](../build/reference/compiler-option-warning-level.md) compiler option: +- Using the [`/w`](../build/reference/compiler-option-warning-level.md) compiler option: - > cl /wd4996 [other compiler options] myfile.cpp + ```cmd + cl /wd4996 [other compiler options] myfile.cpp + ``` -- Using the [#pragma warning](../preprocessor/warning.md) directive: +- Using the [`#pragma warning`](../preprocessor/warning.md) directive: ```cpp #pragma warning(disable:4996) ``` -Also, you can manually change the level of warning C4996 with the **/w\\** compiler option. For example, to set warning C4996 to level 4: +Also, you can manually change the level of warning C4996 with the `/w` compiler option. For example, to set warning C4996 to level 4: -> cl /w44996 [other compiler options] myfile.cpp +```cmd +cl /w44996 myfile.cpp +``` -For more information, see [/w, /W0, /W1, /W2, /W3, /W4, /w1, /w2, /w3, /w4, /Wall, /wd, /we, /wo, /Wv, /WX (Warning Level)](../build/reference/compiler-option-warning-level.md). +For more information, see [`/w`, `/W0`, `/W1`, `/W2`, `/W3`, `/W4`, `/w1`, `/w2`, `/w3`, `/w4`, `/Wall`, `/wd`, `/we`, `/wo`, `/Wv`, `/WX` (Warning Level)](../build/reference/compiler-option-warning-level.md). ## See also -[Safe Libraries: C++ Standard Library](../standard-library/safe-libraries-cpp-standard-library.md) +[Safe Libraries: C++ Standard Library](safe-libraries-cpp-standard-library.md) diff --git a/docs/standard-library/scoped-allocator-adaptor-class.md b/docs/standard-library/scoped-allocator-adaptor-class.md index c937950a65f..b2b7ae1f198 100644 --- a/docs/standard-library/scoped-allocator-adaptor-class.md +++ b/docs/standard-library/scoped-allocator-adaptor-class.md @@ -67,7 +67,7 @@ Three types are defined for the sake of exposition: |Name|Description| |----------|-----------------| -|[scoped_allocator_adaptor::rebind Struct](#rebind_struct)|Defines the type `Outer::rebind\::other` as a synonym for `scoped_allocator_adaptor\`.| +|[scoped_allocator_adaptor::rebind Struct](#rebind_struct)|Defines the type `Outer::rebind::other` as a synonym for `scoped_allocator_adaptor`.| ### Methods @@ -277,7 +277,7 @@ A reference to the stored object of type `outer_allocator_type`. ## scoped_allocator_adaptor::rebind Struct -Defines the type `Outer::rebind\::other` as a synonym for `scoped_allocator_adaptor\`. +Defines the type `Outer::rebind::other` as a synonym for `scoped_allocator_adaptor`. struct rebind{ typedef Other_traits::rebind\ diff --git a/docs/standard-library/scoped-allocator-operators.md b/docs/standard-library/scoped-allocator-operators.md index 9798211db1a..9e8b9098d23 100644 --- a/docs/standard-library/scoped-allocator-operators.md +++ b/docs/standard-library/scoped-allocator-operators.md @@ -1,14 +1,12 @@ --- -description: "Learn more about: operators" title: " operators" -ms.date: "11/04/2016" +description: "Learn more about: operators" +ms.date: 11/04/2016 f1_keywords: ["scoped_allocator/std::operator!=", "scoped_allocator/std::operator=="] -ms.assetid: 4dfe0805-cc6e-479f-887f-a1c164f73837 --- # `` operators -[operator!=](#op_neq)\ -[operator==](#op_eq_eq) +The `` header provides the following operators: ## operator!= diff --git a/docs/standard-library/scoped-lock-class.md b/docs/standard-library/scoped-lock-class.md index 1cb8e0504b8..42b35183393 100644 --- a/docs/standard-library/scoped-lock-class.md +++ b/docs/standard-library/scoped-lock-class.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: scoped_lock Class" title: "scoped_lock Class" -ms.date: "11/04/2016" +description: "Learn more about: scoped_lock Class" +ms.date: 11/04/2016 f1_keywords: ["mutex/std::scoped_lock"] --- # scoped_lock Class @@ -17,5 +17,5 @@ class scoped_lock { ~scoped_lock(); scoped_lock(const scoped_lock&) = delete; scoped_lock& operator=(const scoped_lock&) = delete; -} +}; ``` diff --git a/docs/standard-library/secure-scl.md b/docs/standard-library/secure-scl.md index 011c9f2ca77..01a0b851630 100644 --- a/docs/standard-library/secure-scl.md +++ b/docs/standard-library/secure-scl.md @@ -1,37 +1,36 @@ --- -description: "Learn more about: _SECURE_SCL" title: "_SECURE_SCL" -ms.date: "11/04/2016" +description: "Learn more about: _SECURE_SCL" +ms.date: 11/04/2016 f1_keywords: ["_SECURE_SCL"] helpviewer_keywords: ["_SECURE_SCL"] -ms.assetid: 4ffbc788-cc12-4c6a-8cd7-490081675086 --- -# _SECURE_SCL +# `_SECURE_SCL` -Superseded by [_ITERATOR_DEBUG_LEVEL](../standard-library/iterator-debug-level.md), this macro defines whether [Checked Iterators](../standard-library/checked-iterators.md) are enabled. By default, checked iterators are enabled in Debug builds, and disabled in Retail builds. +Superseded by [`_ITERATOR_DEBUG_LEVEL`](iterator-debug-level.md), this macro defines whether [Checked Iterators](checked-iterators.md) are enabled. By default, checked iterators are enabled in Debug builds, and disabled in Retail builds. > [!IMPORTANT] -> Direct use of the _SECURE_SCL macro is deprecated. Instead, use _ITERATOR_DEBUG_LEVEL to control checked iterator settings. For more information, see [_ITERATOR_DEBUG_LEVEL](../standard-library/iterator-debug-level.md). +> Direct use of the `_SECURE_SCL` macro is deprecated. Instead, use `_ITERATOR_DEBUG_LEVEL` to control checked iterator settings. For more information, see [`_ITERATOR_DEBUG_LEVEL`](iterator-debug-level.md). ## Remarks -When checked iterators are enabled, unsafe iterator use causes a runtime error and the program is terminated. To enable checked iterators, set _ITERATOR_DEBUG_LEVEL to 1 or 2. This is equivalent to a _SECURE_SCL setting of 1, or enabled: +When checked iterators are enabled, unsafe iterator use causes a runtime error and the program is terminated. To enable checked iterators, set `_ITERATOR_DEBUG_LEVEL` to 1 or 2. This is equivalent to a `_SECURE_SCL` setting of 1, or enabled: ```cpp #define _ITERATOR_DEBUG_LEVEL 1 ``` -To disable checked iterators, set _ITERATOR_DEBUG_LEVEL to 0. This is equivalent to a _SECURE_SCL setting of 0, or disabled: +To disable checked iterators, set `_ITERATOR_DEBUG_LEVEL` to 0. This is equivalent to a `_SECURE_SCL` setting of 0, or disabled: ```cpp #define _ITERATOR_DEBUG_LEVEL 0 ``` -For information on how to disable warnings about checked iterators, see [_SCL_SECURE_NO_WARNINGS](../standard-library/scl-secure-no-warnings.md). +For information on how to disable warnings about checked iterators, see [`_SCL_SECURE_NO_WARNINGS`](scl-secure-no-warnings.md). ## See also -[_ITERATOR_DEBUG_LEVEL](../standard-library/iterator-debug-level.md)\ -[Checked Iterators](../standard-library/checked-iterators.md)\ -[Debug Iterator Support](../standard-library/debug-iterator-support.md)\ -[Safe Libraries: C++ Standard Library](../standard-library/safe-libraries-cpp-standard-library.md) +[`_ITERATOR_DEBUG_LEVEL`](iterator-debug-level.md)\ +[Checked Iterators](checked-iterators.md)\ +[Debug Iterator Support](debug-iterator-support.md)\ +[Safe Libraries: C++ Standard Library](safe-libraries-cpp-standard-library.md) diff --git a/docs/standard-library/set-class.md b/docs/standard-library/set-class.md index 044b150c34f..3fb4d1f5de9 100644 --- a/docs/standard-library/set-class.md +++ b/docs/standard-library/set-class.md @@ -1,10 +1,9 @@ --- title: "set Class" description: "API reference for the C++ Standard Library container class `set`, which is used to store and retrieve data from a collection." -ms.date: "9/9/2020" +ms.date: 9/9/2020 f1_keywords: ["set/std::set", "set/std::set::allocator_type", "set/std::set::const_iterator", "set/std::set::const_pointer", "set/std::set::const_reference", "set/std::set::const_reverse_iterator", "set/std::set::difference_type", "set/std::set::iterator", "set/std::set::key_compare", "set/std::set::key_type", "set/std::set::pointer", "set/std::set::reference", "set/std::set::reverse_iterator", "set/std::set::size_type", "set/std::set::value_compare", "set/std::set::value_type", "set/std::set::begin", "set/std::set::cbegin", "set/std::set::cend", "set/std::set::clear", "set/std::set::contains", "set/std::set::count", "set/std::set::crbegin", "set/std::set::crend", "set/std::set::emplace", "set/std::set::emplace_hint", "set/std::set::empty", "set/std::set::end", "set/std::set::equal_range", "set/std::set::erase", "set/std::set::find", "set/std::set::get_allocator", "set/std::set::insert", "set/std::set::key_comp", "set/std::set::lower_bound", "set/std::set::max_size", "set/std::set::rbegin", "set/std::set::rend", "set/std::set::size", "set/std::set::swap", "set/std::set::upper_bound", "set/std::set::value_comp"] helpviewer_keywords: ["std::set [C++]", "std::set [C++], allocator_type", "std::set [C++], const_iterator", "std::set [C++], const_pointer", "std::set [C++], const_reference", "std::set [C++], const_reverse_iterator", "std::set [C++], difference_type", "std::set [C++], iterator", "std::set [C++], key_compare", "std::set [C++], key_type", "std::set [C++], pointer", "std::set [C++], reference", "std::set [C++], reverse_iterator", "std::set [C++], size_type", "std::set [C++], value_compare", "std::set [C++], value_type", "std::set [C++], begin", "std::set [C++], cbegin", "std::set [C++], cend", "std::set [C++], clear", "std::set [C++], contains", "std::set [C++], count", "std::set [C++], crbegin", "std::set [C++], crend", "std::set [C++], emplace", "std::set [C++], emplace_hint", "std::set [C++], empty", "std::set [C++], end", "std::set [C++], equal_range", "std::set [C++], erase", "std::set [C++], find", "std::set [C++], get_allocator", "std::set [C++], insert", "std::set [C++], key_comp", "std::set [C++], lower_bound", "std::set [C++], max_size", "std::set [C++], rbegin", "std::set [C++], rend", "std::set [C++], size", "std::set [C++], swap", "std::set [C++], upper_bound", "std::set [C++], value_comp"] -ms.assetid: 8991f9aa-5509-4440-adc1-371512d32018 --- # `set` Class @@ -27,7 +26,7 @@ The element data type to be stored in the set. *`Traits`*\ The type that provides a function object that can compare two element values as sort keys to determine their relative order in the set. This argument is optional, and the binary predicate `less ` is the default value. -In C++14, you can enable heterogeneous lookup by specifying the `std::less<>` or `std::greater<>` predicate that has no type parameters. See [Heterogeneous Lookup in Associative Containers](../standard-library/stl-containers.md#sequence_containers) for more information. +In C++14, you can enable heterogeneous lookup by specifying the `std::less<>` or `std::greater<>` predicate that has no type parameters. See [Heterogeneous Lookup in Associative Containers](stl-containers.md#heterogeneous-lookup-in-associative-containers) for more information. *`Allocator`*\ The type that represents the stored allocator object that encapsulates details about the set's allocation and deallocation of memory. This argument is optional, and the default value is `allocator`. @@ -52,7 +51,7 @@ The set should be the associative container of choice when the conditions associ The set orders the sequence it controls by calling a stored function object of type [`key_compare`](#key_compare). This stored object is a comparison function that may be accessed by calling the member function [`key_comp`](#key_comp). In general, the elements need to be merely less than comparable to establish this order so that, given any two elements, it may be determined either that they're equivalent (in the sense that neither is less than the other) or that one is less than the other. This results in an ordering between the nonequivalent elements. On a more technical note, the comparison function is a binary predicate that induces a strict weak ordering in the standard mathematical sense. A binary predicate *f*(*x,y*) is a function object that has two argument objects *x* and *y* and a return value of **`true`** or **`false`**. An ordering imposed on a set is a strict weak ordering if the binary predicate is irreflexive, antisymmetric, and transitive and if equivalence is transitive, where two objects *x* and *y* are defined to be equivalent when both *f* *x,y*) and *f*(*y,x*) are false. If the stronger condition of equality between keys replaces that of equivalence, then the ordering becomes total (in the sense that all the elements are ordered with respect to each other) and the keys matched will be indiscernible from each other. -In C++14, you can enable heterogeneous lookup by specifying the `std::less<>` or `std::greater<>` predicate that has no type parameters. See [Heterogeneous Lookup in Associative Containers](../standard-library/stl-containers.md#sequence_containers) for more information. +In C++14, you can enable heterogeneous lookup by specifying the `std::less<>` or `std::greater<>` predicate that has no type parameters. See [Heterogeneous Lookup in Associative Containers](stl-containers.md#heterogeneous-lookup-in-associative-containers) for more information. The iterator provided by the set class is a bidirectional iterator, but the class member functions [`insert`](#insert) and [`set`](#set) have versions that take as template parameters a weaker input iterator, whose functionality requirements are more minimal than those guaranteed by the class of bidirectional iterators. The different iterator concepts form a family related by refinements in their functionality. Each iterator concept has its own set of requirements, and the algorithms that work with them must limit their assumptions to the requirements provided by that type of iterator. It may be assumed that an input iterator may be dereferenced to refer to some object and that it may be incremented to the next iterator in the sequence. This is a minimal set of functionality, but it's enough to be able to talk meaningfully about a range of iterators [ `First`, `Last`) in the context of the class's member functions. @@ -400,12 +399,12 @@ The element's key value to look for. `contains()` is new in C++20. To use it, specify the [`/std:c++20`](../build/reference/std-specify-language-standard-version.md) or later compiler option. -`template bool contains(const K& key) const` only participates in overload resolution if `key_compare` is transparent. See [Heterogeneous lookup in associative containers](./stl-containers.md#heterogeneous-lookup-in-associative-containers-c14) for more information. +`template bool contains(const K& key) const` only participates in overload resolution if `key_compare` is transparent. See [Heterogeneous lookup in associative containers](stl-containers.md#heterogeneous-lookup-in-associative-containers) for more information. ### Example ```cpp -// Requires /std:c++20 or /std:c++latest +// Requires /std:c++20 or later #include #include @@ -886,7 +885,7 @@ The argument key to be compared with the sort key of an element from the set bei A pair of iterators where the first is the [`lower_bound`](#lower_bound) of the key and the second is the [`upper_bound`](#upper_bound) of the key. -To access the first iterator of a pair `pr` returned by the member function, use `pr`. **first**, and to dereference the lower bound iterator, use \*( `pr`. **first**). To access the second iterator of a pair `pr` returned by the member function, use `pr`. **second**, and to dereference the upper bound iterator, use \*( `pr`. **second**). +To access the first iterator of a pair `pr` returned by the member function, use `pr`. **first**, and to dereference the lower bound iterator, use \*(`pr`. **first**). To access the second iterator of a pair `pr` returned by the member function, use `pr`. **second**, and to dereference the upper bound iterator, use \*(`pr`. **second**). ### Example @@ -1081,71 +1080,58 @@ An iterator that refers to the location of an element with a specified key, or t ### Remarks -The member function returns an iterator that refers to an element in the set whose key is equivalent to the argument *key* under a binary predicate that induces an ordering based on a less than comparability relation. +The member function returns an iterator that points to the element in the set that has a key equal to the argument *key*. If no such element exists, the function returns `end()`. The comparison uses a binary predicate based on a less-than ordering relation. -If the return value of `find` is assigned to a `const_iterator`, the set object can't be modified. If the return value of `find` is assigned to an `iterator`, the set object can be modified +If the return value of `find` is assigned to a `const_iterator`, the set object can't be modified. If the return value of `find` is assigned to an `iterator`, the set object can be modified. -### Example +### Example of set::find() ```cpp // compile with: /EHsc /W4 /MTd #include #include -#include -#include - -using namespace std; - -template void print_elem(const T& t) { - cout << "(" << t << ") "; -} -template void print_collection(const T& t) { - cout << t.size() << " elements: "; - - for (const auto& p : t) { - print_elem(p); - } - cout << endl; -} - -template void findit(const C& c, T val) { - cout << "Trying find() on value " << val << endl; - auto result = c.find(val); - if (result != c.end()) { - cout << "Element found: "; print_elem(*result); cout << endl; - } else { - cout << "Element not found." << endl; - } -} +using namespace std; // std c++ libs implemented in std -int main() +void main() { - set s1({ 40, 45 }); - cout << "The starting set s1 is: " << endl; - print_collection(s1); - - vector v; - v.push_back(43); - v.push_back(41); - v.push_back(46); - v.push_back(42); - v.push_back(44); - v.push_back(44); // attempt a duplicate - - cout << "Inserting the following vector data into s1: " << endl; - print_collection(v); - - s1.insert(v.begin(), v.end()); - - cout << "The modified set s1 is: " << endl; - print_collection(s1); - cout << endl; - findit(s1, 45); - findit(s1, 6); + set, allocator> s1{5, 8, 12}; + + // find() returns an iterator that points to the first element + // that has the same key as the value passed to the find function. + // If no such element exists, the iterator equals end(). + + set, allocator>::iterator it; + + // Is 8 in the set? + it = s1.find(8); + if (it != s1.end()) + { + cout << "Found 8" << endl; + } + else + { + cout << "Didn't find 8" << endl; + } + + // Is 6 in the set? + it = s1.find(6); + if (it != s1.end()) + { + cout << "Found 6" << endl; + } + else + { + cout << "Didn't find 6" << endl; + } } ``` +```output +Found 8 +Didn't find 6 +``` + ## `get_allocator` Returns a copy of the allocator object used to construct the set. diff --git a/docs/standard-library/set-functions.md b/docs/standard-library/set-functions.md index 028b7771bc6..76fb181cf43 100644 --- a/docs/standard-library/set-functions.md +++ b/docs/standard-library/set-functions.md @@ -1,9 +1,8 @@ --- -description: "Learn more about: functions" title: " functions" -ms.date: "11/04/2016" +description: "Learn more about: functions" +ms.date: 11/04/2016 f1_keywords: ["set/std::swap (map)", "set/std::swap (multiset)"] -ms.assetid: d1277d14-8502-46c0-b820-bcda820f9406 --- # `` functions @@ -63,4 +62,4 @@ in the algorithm class works by assignment and is a slow operation. The speciali ### Example -See the code example for the member class [multiset::swap](../standard-library/multiset-class.md#swap)for an example of the use of the template version of `swap`. +See the code example for the member class [multiset::swap](../standard-library/multiset-class.md#swap) for an example of the use of the template version of `swap`. diff --git a/docs/standard-library/shared-mutex.md b/docs/standard-library/shared-mutex.md index 4506e8bb917..aa70e3c56c8 100644 --- a/docs/standard-library/shared-mutex.md +++ b/docs/standard-library/shared-mutex.md @@ -1,9 +1,8 @@ --- -description: "Learn more about: " title: "" -ms.date: "03/27/2019" +description: "Learn more about: " +ms.date: 03/27/2019 f1_keywords: ["", "shared_mutex/std::swap", "shared_mutex/std::shared_lock", "shared_mutex/std::shared_lock::shared_lock", "shared_mutex/std::shared_lock::operator=", "shared_mutex/std::shared_lock::operator =", "shared_mutex/std::shared_lock::lock", "shared_mutex/std::shared_lock::try_lock", "shared_mutex/std::shared_lock::try_lock_for", "shared_mutex/std::shared_lock::try_lock_until", "shared_mutex/std::shared_lock::unlock", "shared_mutex/std::shared_lock::swap", "shared_mutex/std::shared_lock::release", "shared_mutex/std::shared_lock::owns_lock", "shared_mutex/std::shared_lock::operator bool", "shared_mutex/std::shared_lock::mutex", "shared_mutex/std::shared_mutex", "shared_mutex/std::shared_mutex::native_handle_type", "shared_mutex/std::shared_mutex::shared_mutex", "shared_mutex/std::shared_mutex::operator=", "shared_mutex/std::shared_mutex::operator =", "shared_mutex/std::shared_mutex::lock", "shared_mutex/std::shared_mutex::try_lock", "shared_mutex/std::shared_mutex::unlock", "shared_mutex/std::shared_mutex::lock_shared", "shared_mutex/std::shared_mutex::try_lock_shared", "shared_mutex/std::shared_mutex::unlock_shared", "shared_mutex/std::shared_mutex::native_handle", "shared_mutex/std::shared_timed_mutex", "shared_mutex/std::shared_timed_mutex::shared_timed_mutex", "shared_mutex/std::shared_timed_mutex::operator=", "shared_mutex/std::shared_timed_mutex::operator =", "shared_mutex/std::shared_timed_mutex::lock", "shared_mutex/std::shared_timed_mutex::try_lock", "shared_mutex/std::shared_timed_mutex::try_lock_for", "shared_mutex/std::shared_timed_mutex::try_lock_until", "shared_mutex/std::shared_timed_mutex::unlock", "shared_mutex/std::shared_timed_mutex::lock_shared", "shared_mutex/std::shared_timed_mutex::try_lock_shared", "shared_mutex/std::shared_timed_mutex::try_lock_shared_for", "shared_mutex/std::shared_timed_mutex::try_lock_shared_until", "shared_mutex/std::shared_timed_mutex::unlock_shared"] -ms.assetid: 0b37a97d-ee5d-4050-b29f-09db9f76beb3 --- # `` @@ -28,9 +27,9 @@ namespace std { class shared_mutex; class shared_timed_mutex; template -class shared_lock; + class shared_lock; template -void swap(shared_lock& x, shared_lock& y) noexcept; + void swap(shared_lock& x, shared_lock& y) noexcept; } ``` diff --git a/docs/standard-library/single-view-class.md b/docs/standard-library/single-view-class.md index 7a42d4dfcc4..67ed5341e15 100644 --- a/docs/standard-library/single-view-class.md +++ b/docs/standard-library/single-view-class.md @@ -100,7 +100,7 @@ The best way to create a `single_view` is by using the [`views::single`](range-a ### Example `single_view` ```cpp -/// requires /std:c++20 or higher +/// requires /std:c++20 or later #include #include #include diff --git a/docs/standard-library/slice-array-class.md b/docs/standard-library/slice-array-class.md index 6bcfaec534d..f8520ffb2b5 100644 --- a/docs/standard-library/slice-array-class.md +++ b/docs/standard-library/slice-array-class.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: slice_array class" title: "slice_array class" +description: "Learn more about: slice_array class" ms.date: 01/12/2022 f1_keywords: ["valarray/std::slice_array"] helpviewer_keywords: ["slice_array class"] -ms.assetid: a182d5f7-f35c-4e76-86f2-b5ac64ddc846 --- # `slice_array` class @@ -30,7 +29,7 @@ public: void operator<<=(const valarray& x) const; void operator>>=(const valarray& x) const; // The rest is private or implementation defined -} +}; ``` ## Remarks diff --git a/docs/standard-library/span-class.md b/docs/standard-library/span-class.md index 010b8fef931..8fc221fe457 100644 --- a/docs/standard-library/span-class.md +++ b/docs/standard-library/span-class.md @@ -1,9 +1,8 @@ --- -title: span class (C++ Standard Library) +title: "span class (C++ Standard Library)" description: "API reference for the Standard Template Library (STL) span class, which provides a lightweight view over a contiguous sequence of objects." -ms.date: "05/28/2020" -f1_keywords: ["span/std::span", "span/std::span::const_pointer", "span/std::span::const_reference", "span/std::span::difference_type", "span/std::span::element_type", "span/std::span::iterator", "span/std::span::pointer", "span/std::span::reference", "span/std::span::reverse_iterator", "span/std::span::size_type", "span/std::span::value_type", "span/std::span::at", "span/std::span::assign", "span/std::span::back", "span/std::span::begin", "span/std::span::data", "span/std::span::empty", "span/std::span::end", "span/std::span::front", "span/std::span::rbegin", "span/std::span::rend", -"span/std::span::size", "span/std::span::size_bytes", "span/std::span::operator=", "span/std::span::operator[]"] +ms.date: 05/28/2020 +f1_keywords: ["span/std::span", "span/std::span::const_pointer", "span/std::span::const_reference", "span/std::span::difference_type", "span/std::span::element_type", "span/std::span::iterator", "span/std::span::pointer", "span/std::span::reference", "span/std::span::reverse_iterator", "span/std::span::size_type", "span/std::span::value_type", "span/std::span::at", "span/std::span::assign", "span/std::span::back", "span/std::span::begin", "span/std::span::data", "span/std::span::empty", "span/std::span::end", "span/std::span::front", "span/std::span::rbegin", "span/std::span::rend", "span/std::span::size", "span/std::span::size_bytes", "span/std::span::operator=", "span/std::span::operator[]"] helpviewer_keywords: ["std::span [C++]", "std::span [C++], const_pointer", "std::span [C++], const_reference", "std::span [C++], difference_type", "std::span [C++], element_type", "std::span [C++], iterator", "std::span [C++], pointer", "std::span [C++], reference", "std::span [C++], reverse_iterator", "std::span [C++], size_type", "std::span [C++], value_type", "std::span [C++], assign", "std::span [C++], at", "std::span [C++], back", "std::span [C++], begin", "std::span [C++], data", "std::span [C++], empty", "std::span [C++], end", "std::span [C++], front", "std::span [C++], rbegin", "std::span [C++], rend", "std::span [C++], size", "std::span [C++], size_bytes"] dev_langs: ["C++"] --- diff --git a/docs/standard-library/span-functions.md b/docs/standard-library/span-functions.md index 456d5c7133e..581e347c753 100644 --- a/docs/standard-library/span-functions.md +++ b/docs/standard-library/span-functions.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: functions" title: " functions" -ms.date: "05/28/2020" +description: "Learn more about: functions" +ms.date: 05/28/2020 f1_keywords: ["span/std::span::as_bytes", "span/std::as_writable_bytes"] helpviewer_keywords: ["std::span [C++], as_writable_bytes", "std::as_bytes [C++]"] dev_langs: ["C++"] @@ -15,7 +15,7 @@ The `` header includes the following non-member functions that operate on |[`as_bytes`](#as_bytes) | Get a read-only view of the object representation of the elements in the span. | |[`as_writable_bytes`](#as_writable_bytes) | Get a read/write view of the object representation of the elements in the span. | -## `as_bytes` +## `as_bytes` Get a read-only view of the object representation of the elements in the span. @@ -47,7 +47,7 @@ A `span` to the first item stored in the span where `S` is `{rein using namespace std; -void main() +int main() { int a[] = { 0,1,2 }; span mySpan(a); @@ -55,7 +55,7 @@ void main() } ``` -## `as_writable_bytes` +## `as_writable_bytes` If `T` isn't **`const`**, gets a read/write view of the raw byte representation of the elements in the span. @@ -87,7 +87,7 @@ A `span` to the first item stored in the span where `S` is `{reinterpre using namespace std; -void main() +int main() { int a[] = { 0,1,2 }; span mySpan(a); diff --git a/docs/standard-library/sstream-functions.md b/docs/standard-library/sstream-functions.md index 80c3aab1537..4c47dc0b0fd 100644 --- a/docs/standard-library/sstream-functions.md +++ b/docs/standard-library/sstream-functions.md @@ -1,13 +1,12 @@ --- -description: "Learn more about: functions" title: " functions" -ms.date: "11/04/2016" +description: "Learn more about: functions" +ms.date: 11/04/2016 f1_keywords: ["sstream/std::swap"] -ms.assetid: bc9607e8-7c6b-44ef-949b-19e917b450ad --- # `` functions -[swap](#sstream_swap) +The `` header provides the following functions: ## swap diff --git a/docs/standard-library/sstream-typedefs.md b/docs/standard-library/sstream-typedefs.md index fb824672c7f..0a392e94bb9 100644 --- a/docs/standard-library/sstream-typedefs.md +++ b/docs/standard-library/sstream-typedefs.md @@ -1,19 +1,12 @@ --- -description: "Learn more about: typedefs" title: " typedefs" -ms.date: "11/04/2016" +description: "Learn more about: typedefs" +ms.date: 11/04/2016 f1_keywords: ["iosfwd/std::istringstream", "iosfwd/std::ostringstream", "iosfwd/std::stringbuf", "iosfwd/std::stringstream", "iosfwd/std::wistringstream", "iosfwd/std::wostringstream", "iosfwd/std::wstringbuf", "iosfwd/std::wstringstream"] --- # `` typedefs -[`istringstream`](#istringstream)\ -[`ostringstream`](#ostringstream)\ -[`stringbuf`](#stringbuf)\ -[`stringstream`](#stringstream)\ -[`wistringstream`](#wistringstream)\ -[`wostringstream`](#wostringstream)\ -[`wstringbuf`](#wstringbuf)\ -[`wstringstream`](#wstringstream) +The `` header provides the following typedefs: ## `istringstream` diff --git a/docs/standard-library/stack-class.md b/docs/standard-library/stack-class.md index 12a610f22ee..8a30a18989f 100644 --- a/docs/standard-library/stack-class.md +++ b/docs/standard-library/stack-class.md @@ -377,7 +377,7 @@ int main( ) stack s1; s1.push( 1 ); - s1.push( 2 ); + s1.push( 3 ); int& i = s1.top( ); const int& ii = s1.top( ); @@ -385,13 +385,13 @@ int main( ) cout << "The top integer of the stack s1 is " << i << "." << endl; i--; - cout << "The next integer down is "<< ii << "." << endl; + cout << "The updated top integer is " << ii << "." << endl; } ``` ```Output -The top integer of the stack s1 is 2. -The next integer down is 1. +The top integer of the stack s1 is 3. +The updated top integer is 2. ``` ## `value_type` diff --git a/docs/standard-library/stack-operators.md b/docs/standard-library/stack-operators.md index a8b308ae8a7..9722dbc4eac 100644 --- a/docs/standard-library/stack-operators.md +++ b/docs/standard-library/stack-operators.md @@ -1,9 +1,8 @@ --- -description: "Learn more about: operators" title: " operators" +description: "Learn more about: operators" ms.date: "11/04/2016" f1_keywords: ["stack/std::operator!=", "stack/std::operator>", "stack/std::operator>=", "stack/std::operator<", "stack/std::operator<=", "stack/std::operator=="] -ms.assetid: 9c1fc282-2f61-4727-9e80-84ea5d4934a2 helpviewer_keywords: ["std::operator!= (stack)", "std::operator> (stack)", "std::operator>= (stack)", "std::operator< (stack)", "std::operator<= (stack)", "std::operator== (stack)"] --- # `` operators @@ -13,7 +12,7 @@ helpviewer_keywords: ["std::operator!= (stack)", "std::operator> (stack)", "std: Tests if the stack object on the left side of the operator is not equal to stack object on the right side. ```cpp -bool operator!=(const stack & left, const stack & right,); +bool operator!=(const stack & left, const stack & right); ``` ### Parameters diff --git a/docs/standard-library/stdexcept.md b/docs/standard-library/stdexcept.md index 6ad13bbc2dd..ac7cf23aeb6 100644 --- a/docs/standard-library/stdexcept.md +++ b/docs/standard-library/stdexcept.md @@ -1,46 +1,40 @@ --- -description: "Learn more about: " title: "" -ms.date: "11/04/2016" +description: "Learn more about: " +ms.date: 11/04/2016 f1_keywords: [""] helpviewer_keywords: ["stdexcept header"] -ms.assetid: 495c10b1-1e60-4514-9f8f-7fda11a2f522 --- # `` -Defines several standard classes used for reporting exceptions. The classes form a derivation hierarchy all derived from class [exception](../standard-library/exception-class.md) and include two general types of exceptions: logical errors and run-time errors. The logical errors are caused programmer mistakes. They derive from the base class logic_error and include: +Defines several standard classes used for reporting exceptions. The classes form a derivation hierarchy all derived from class [`exception`](exception-class.md) and include two general types of exceptions: logical errors and run-time errors. The logical errors are caused by programmer mistakes. They derive from the base class `logic_error` and include: - `domain_error` - - `invalid_argument` - - `length_error` - - `out_of_range` -The run-time errors occur because of mistakes in either the library functions or in the run-time system. They derive from the base class runtime_error and include: +The run-time errors occur because of mistakes in either the library functions or in the run-time system. They derive from the base class `runtime_error` and include: - `overflow_error` - - `range_error` - - `underflow_error` ### Classes |Class|Description| |-|-| -|[domain_error Class](../standard-library/domain-error-class.md)|The class serves as the base class for all exceptions thrown to report a domain error.| -|[invalid_argument Class](../standard-library/invalid-argument-class.md)|The class serves as the base class for all exceptions thrown to report an invalid argument.| -|[length_error Class](../standard-library/length-error-class.md)|The class serves as the base class for all exceptions thrown to report an attempt to generate an object too long to be specified.| -|[logic_error Class](../standard-library/logic-error-class.md)|The class serves as the base class for all exceptions thrown to report errors presumably detectable before the program executes, such as violations of logical preconditions.| -|[out_of_range Class](../standard-library/out-of-range-class.md)|The class serves as the base class for all exceptions thrown to report an argument that is out of its valid range.| -|[overflow_error Class](../standard-library/overflow-error-class.md)|The class serves as the base class for all exceptions thrown to report an arithmetic overflow.| -|[range_error Class](../standard-library/range-error-class.md)|The class serves as the base class for all exceptions thrown to report a range error.| -|[runtime_error Class](../standard-library/runtime-error-class.md)|The class serves as the base class for all exceptions thrown to report errors presumably detectable only when the program executes.| -|[underflow_error Class](../standard-library/underflow-error-class.md)|The class serves as the base class for all exceptions thrown to report an arithmetic underflow.| +|[`domain_error` class](domain-error-class.md)|The class serves as the base class for all exceptions thrown to report a domain error.| +|[`invalid_argument` class](invalid-argument-class.md)|The class serves as the base class for all exceptions thrown to report an invalid argument.| +|[`length_error` class](length-error-class.md)|The class serves as the base class for all exceptions thrown to report an attempt to generate an object too long to be specified.| +|[`logic_error` class](logic-error-class.md)|The class serves as the base class for all exceptions thrown to report errors presumably detectable before the program executes, such as violations of logical preconditions.| +|[`out_of_range` class](out-of-range-class.md)|The class serves as the base class for all exceptions thrown to report an argument that is out of its valid range.| +|[`overflow_error` class](overflow-error-class.md)|The class serves as the base class for all exceptions thrown to report an arithmetic overflow.| +|[`range_error` class](range-error-class.md)|The class serves as the base class for all exceptions thrown to report a range error.| +|[`runtime_error` class](runtime-error-class.md)|The class serves as the base class for all exceptions thrown to report errors presumably detectable only when the program executes.| +|[`underflow_error` class](underflow-error-class.md)|The class serves as the base class for all exceptions thrown to report an arithmetic underflow.| ## See also -[Header Files Reference](../standard-library/cpp-standard-library-header-files.md)\ -[Thread Safety in the C++ Standard Library](../standard-library/thread-safety-in-the-cpp-standard-library.md) +[Header Files Reference](cpp-standard-library-header-files.md)\ +[Thread Safety in the C++ Standard Library](thread-safety-in-the-cpp-standard-library.md) diff --git a/docs/standard-library/steady-clock-struct.md b/docs/standard-library/steady-clock-struct.md index bcb5ea47f5f..27c5ae83a47 100644 --- a/docs/standard-library/steady-clock-struct.md +++ b/docs/standard-library/steady-clock-struct.md @@ -1,8 +1,8 @@ --- -description: "Learn more about: steady_clock struct" title: "steady_clock struct" +description: "Learn more about: steady_clock struct" ms.date: 04/14/2022 -f1_keywords: ["chrono/std::chrono::steady_clock", "chrono/std::chrono::steady_clock::now", "chrono/std::chrono::steady_clock:is_steady"] +f1_keywords: ["chrono/std::chrono::steady_clock", "chrono/std::chrono::steady_clock::now", "chrono/std::chrono::steady_clock::is_steady"] helpviewer_keywords: ["std::chrono [C++], steady_clock"] dev_langs: ["C++"] --- @@ -102,4 +102,4 @@ Elapsed nanoseconds: 1007266700 ns [`system_clock` struct](system-clock-structure.md)\ [`tai_clock` class](tai-clock-class.md)\ [`utc_clock` class](utc-clock-class.md)\ -[Header Files Reference](cpp-standard-library-header-files.md) \ No newline at end of file +[Header Files Reference](cpp-standard-library-header-files.md) diff --git a/docs/standard-library/stl-containers.md b/docs/standard-library/stl-containers.md index ffdac90c0ce..0b8ce549317 100644 --- a/docs/standard-library/stl-containers.md +++ b/docs/standard-library/stl-containers.md @@ -1,9 +1,8 @@ --- -description: "Learn more about: C++ Standard Library Containers" title: "C++ Standard Library Containers" -ms.date: "11/04/2016" +description: "Learn more about: C++ Standard Library Containers" +ms.date: 11/04/2016 helpviewer_keywords: ["C++ Standard Library, class template containers", "containers, C++ Standard Library"] -ms.assetid: 8e915ca1-19ba-4f0d-93c8-e2c3bfd638eb --- # C++ Standard Library Containers @@ -39,7 +38,7 @@ Both `map` and `set` only allow one instance of a key or element to be inserted Ordered maps and sets support bi-directional iterators, and their unordered counterparts support forward iterators. For more information, see [Iterators](../standard-library/iterators.md). -### Heterogeneous Lookup in Associative Containers (C++14) +### Heterogeneous Lookup in Associative Containers (C++14) The ordered associative containers (map, multimap, set, and multiset) now support heterogeneous lookup, which means that you're no longer required to pass the exact same object type as the key or element in member functions such as `find()` and `lower_bound()`. Instead, you can pass any type for which an overloaded `operator<` is defined that enables comparison to the key type. diff --git a/docs/standard-library/streambuf-typedefs.md b/docs/standard-library/streambuf-typedefs.md index 842403c4f07..ab98660169a 100644 --- a/docs/standard-library/streambuf-typedefs.md +++ b/docs/standard-library/streambuf-typedefs.md @@ -1,14 +1,12 @@ --- -description: "Learn more about: typedefs" title: " typedefs" -ms.date: "11/04/2016" +description: "Learn more about: typedefs" +ms.date: 11/04/2016 f1_keywords: ["iosfwd/std::streambuf", "iosfwd/std::wstreambuf"] -ms.assetid: 2678e18f-f0f0-4995-bc53-f1bc7dfc4ec6 --- # `` typedefs -[streambuf](#streambuf)\ -[wstreambuf](#wstreambuf) +The `` header provides the following typedefs: ## streambuf diff --git a/docs/standard-library/string-functions.md b/docs/standard-library/string-functions.md index ec9262a46fa..e1f57695e84 100644 --- a/docs/standard-library/string-functions.md +++ b/docs/standard-library/string-functions.md @@ -1,25 +1,13 @@ --- -description: "Learn more about: functions" title: " functions" -ms.date: "11/04/2016" +description: "Learn more about: functions" +ms.date: 11/04/2016 f1_keywords: ["string/std::getline", "string/std::stod", "string/std::stof", "string/std::stoi", "string/std::stol", "string/std::stold", "string/std::stoll", "string/std::stoul", "string/std::stoull", "string/std::swap", "string/std::to_string", "string/std::to_wstring"] -ms.assetid: 1a4ffd11-dce5-4cc6-a043-b95de034c7c4 helpviewer_keywords: ["std::getline [C++]", "std::stod [C++]", "std::stof [C++]", "std::stoi [C++]", "std::stol [C++]", "std::stold [C++]", "std::stoll [C++]", "std::stoul [C++]", "std::stoull [C++]", "std::swap [C++]", "std::to_string [C++]", "std::to_wstring [C++]"] --- # `` functions -[`getline`](#getline)\ -[`stod`](#stod)\ -[`stof`](#stof)\ -[`stoi`](#stoi)\ -[`stol`](#stol)\ -[`stold`](#stold)\ -[`stoll`](#stoll)\ -[`stoul`](#stoul)\ -[`stoull`](#stoull)\ -[`swap`](#swap)\ -[`to_string`](#to_string)\ -[`to_wstring`](#to_wstring) +The `` header provides the following functions: ## `getline` @@ -144,8 +132,7 @@ double stod( double stod( const wstring& str, - size_t* idx = 0 -; + size_t* idx = 0); ``` ### Parameters @@ -162,7 +149,7 @@ The **`double`** value. ### Remarks -The function converts the sequence of elements in *`str`* to a value of type **`double`** as if by calling `strtod( str.c_str(), _Eptr)`, where `_Eptr` is an object internal to the function. If `str.c_str() == *_Eptr`, it throws an object of type `invalid_argument`. If such a call would set `errno`, it throws an object of type `out_of_range`. Otherwise, if *`idx`* isn't a null pointer, the function stores `*_Eptr - str.c_str()` in `*idx` and returns the value. +The function converts the sequence of elements in *`str`* to a value of type **`double`** as if by calling `strtod( str.c_str(), _Eptr)`, where `_Eptr` is an object internal to the function. If `str.c_str() == *_Eptr`, it throws an object of type `invalid_argument`. If such a call would set `errno`, it throws an object of type `out_of_range`. Otherwise, if *`idx`* isn't a null pointer, the function stores `*_Eptr - str.c_str()` in `*idx` and returns the value. ## `stof` @@ -192,7 +179,7 @@ The **`float`** value. ### Remarks -The function converts the sequence of elements in *`str`* to a value of type **`float`** as if by calling `strtof( str.c_str(), _Eptr)`, where `_Eptr` is an object internal to the function. If `str.c_str() == *_Eptr`, it throws an object of type `invalid_argument`. If such a call would set `errno`, it throws an object of type `out_of_range`. Otherwise, if *`idx`* isn't a null pointer, the function stores `*_Eptr - str.c_str()` in `*idx` and returns the value. +The function converts the sequence of elements in *`str`* to a value of type **`float`** as if by calling `strtof( str.c_str(), _Eptr)`, where `_Eptr` is an object internal to the function. If `str.c_str() == *_Eptr`, it throws an object of type `invalid_argument`. If such a call would set `errno`, it throws an object of type `out_of_range`. Otherwise, if *`idx`* isn't a null pointer, the function stores `*_Eptr - str.c_str()` in `*idx` and returns the value. ## `stoi` @@ -266,7 +253,7 @@ The long-integer value. ### Remarks -The function converts the sequence of elements in *str* to a value of type **`long`** as if by calling `strtol( str.c_str(), _Eptr, idx)`, where `_Eptr` is an object internal to the function. If `str.c_str() == *_Eptr`, it throws an object of type `invalid_argument`. If such a call would set `errno`, it throws an object of type `out_of_range`. Otherwise, if *`idx`* isn't a null pointer, the function stores `*_Eptr - str.c_str()` in `*idx` and returns the value. +The function converts the sequence of elements in *str* to a value of type **`long`** as if by calling `strtol( str.c_str(), _Eptr, idx)`, where `_Eptr` is an object internal to the function. If `str.c_str() == *_Eptr`, it throws an object of type `invalid_argument`. If such a call would set `errno`, it throws an object of type `out_of_range`. Otherwise, if *`idx`* isn't a null pointer, the function stores `*_Eptr - str.c_str()` in `*idx` and returns the value. ## `stold` @@ -296,7 +283,7 @@ The **`long double`** value. ### Remarks -The function converts the sequence of elements in *str* to a value of type **`long double`** as if by calling `strtold( str.c_str(), _Eptr)`, where `_Eptr` is an object internal to the function. If `str.c_str() == *_Eptr`, it throws an object of type `invalid_argument`. If such a call would set `errno`, it throws an object of type `out_of_range`. Otherwise, if *`idx`* isn't a null pointer, the function stores `*_Eptr - str.c_str()` in `*idx` and returns the value. +The function converts the sequence of elements in *str* to a value of type **`long double`** as if by calling `strtold( str.c_str(), _Eptr)`, where `_Eptr` is an object internal to the function. If `str.c_str() == *_Eptr`, it throws an object of type `invalid_argument`. If such a call would set `errno`, it throws an object of type `out_of_range`. Otherwise, if *`idx`* isn't a null pointer, the function stores `*_Eptr - str.c_str()` in `*idx` and returns the value. ## `stoll` @@ -331,7 +318,7 @@ The **`long long`** value. ### Remarks -The function converts the sequence of elements in *str* to a value of type **`long long`** as if by calling `strtoll( str.c_str(), _Eptr, idx)`, where `_Eptr` is an object internal to the function. If `str.c_str() == *_Eptr`, it throws an object of type `invalid_argument`. If such a call would set `errno`, it throws an object of type `out_of_range`. Otherwise, if *idx* isn't a null pointer, the function stores `*_Eptr - str.c_str()` in `*idx` and returns the value. +The function converts the sequence of elements in *str* to a value of type **`long long`** as if by calling `strtoll( str.c_str(), _Eptr, idx)`, where `_Eptr` is an object internal to the function. If `str.c_str() == *_Eptr`, it throws an object of type `invalid_argument`. If such a call would set `errno`, it throws an object of type `out_of_range`. Otherwise, if *idx* isn't a null pointer, the function stores `*_Eptr - str.c_str()` in `*idx` and returns the value. ## `stoul` @@ -366,7 +353,7 @@ The unsigned long-integer value. ### Remarks -The function converts the sequence of elements in *str* to a value of type **`unsigned long`** as if by calling `strtoul( str.c_str(), _Eptr, idx)`, where `_Eptr` is an object internal to the function. If `str.c_str() == *_Eptr`, it throws an object of type `invalid_argument`. If such a call would set `errno`, it throws an object of type `out_of_range`. Otherwise, if *idx* isn't a null pointer, the function stores `*_Eptr - str.c_str()` in `*idx` and returns the value. +The function converts the sequence of elements in *str* to a value of type **`unsigned long`** as if by calling `strtoul( str.c_str(), _Eptr, idx)`, where `_Eptr` is an object internal to the function. If `str.c_str() == *_Eptr`, it throws an object of type `invalid_argument`. If such a call would set `errno`, it throws an object of type `out_of_range`. Otherwise, if *idx* isn't a null pointer, the function stores `*_Eptr - str.c_str()` in `*idx` and returns the value. ## `stoull` @@ -401,7 +388,7 @@ The **`unsigned long long`** value. ### Remarks -The function converts the sequence of elements in *str* to a value of type **`unsigned long long`** as if by calling `strtoull( str.c_str(), _Eptr, idx)`, where `_Eptr` is an object internal to the function. If `str.c_str() == *_Eptr`, it throws an object of type `invalid_argument`. If such a call would set `errno`, it throws an object of type `out_of_range`. Otherwise, if *`idx`* isn't a null pointer, the function stores `*_Eptr - str.c_str()` in `*idx` and returns the value. +The function converts the sequence of elements in *str* to a value of type **`unsigned long long`** as if by calling `strtoull( str.c_str(), _Eptr, idx)`, where `_Eptr` is an object internal to the function. If `str.c_str() == *_Eptr`, it throws an object of type `invalid_argument`. If such a call would set `errno`, it throws an object of type `out_of_range`. Otherwise, if *`idx`* isn't a null pointer, the function stores `*_Eptr - str.c_str()` in `*idx` and returns the value. ## `swap` diff --git a/docs/standard-library/string-operators.md b/docs/standard-library/string-operators.md index 337f916ab36..692a728f2da 100644 --- a/docs/standard-library/string-operators.md +++ b/docs/standard-library/string-operators.md @@ -1,22 +1,13 @@ --- -description: "Learn more about: operators" title: " operators" -ms.date: "11/04/2016" +description: "Learn more about: operators" +ms.date: 11/04/2016 f1_keywords: ["string/std::operator!=", "string/std::operator>", "string/std::operator>>", "string/std::operator>=", "string/std::operator<", "string/std::operator<<", "string/std::operator<=", "string/std::operator+", "string/std::operator=="] -ms.assetid: 33ce8f05-06c7-45d3-a0cb-bcd27cf93910 helpviewer_keywords: ["std::operator!= (string)", "std::operator> (string)", "std::operator>> (string)", "std::operator>= (string)", "std::operator< (string)", "std::operator<< (string)", "std::operator<= (string), std::operator== (string)"] --- # `` operators -[operator!=](#op_neq)\ -[`operator>`](#op_gt)\ -[`operator>>`](#op_gt_gt)\ -[`operator>=`](#op_gt_eq)\ -[`operator<`](#op_lt)\ -[`operator<<`](#op_lt_lt)\ -[`operator<=`](#op_lt_eq)\ -[operator+](#op_add)\ -[operator==](#op_eq_eq) +The `` header provides the following operators: ## operator+ @@ -98,7 +89,7 @@ The string that is the concatenation of the input strings. ### Remarks -The functions each overload `operator+` to concatenate two objects of class template [basic_string Class](../standard-library/basic-string-class.md). All effectively return `basic_string< CharType, Traits, Allocator>(Left).append(right)`. For more information, see [append](../standard-library/basic-string-class.md#append). +The functions each overload `operator+` to concatenate two objects of class template [`basic_string`](../standard-library/basic-string-class.md). All effectively return `basic_string< CharType, Traits, Allocator>(Left).append(right)`. For more information, see [append](../standard-library/basic-string-class.md#append). ### Example @@ -801,7 +792,7 @@ The template function overloads **operator>>** to replace the sequence controlle After the function extracts `_Istr`. [max_size](../standard-library/basic-string-class.md#max_size) elements. -- After the function extracts an element *ch* for which [use_facet](../standard-library/basic-filebuf-class.md#open)< **ctype**\< **CharType**> >( `getloc`). **is**( **ctype**\< **CharType**>:: **space**, *ch*) is true, in which case the character is put back. +- After the function extracts an element *ch* for which [use_facet](../standard-library/basic-filebuf-class.md#open)< **ctype**\< **CharType**> >(`getloc`). **is**( **ctype**\< **CharType**>:: **space**, *ch*) is true, in which case the character is put back. If the function extracts no elements, it calls [setstate](../standard-library/basic-ios-class.md#setstate)(`ios_base::failbit`). In any case, it calls **istr**. **width**(0) and returns \* **`this`**. diff --git a/docs/standard-library/string-typedefs.md b/docs/standard-library/string-typedefs.md index 8f4f7bfa125..23ba6e7b509 100644 --- a/docs/standard-library/string-typedefs.md +++ b/docs/standard-library/string-typedefs.md @@ -1,16 +1,12 @@ --- -description: "Learn more about: typedefs" title: " typedefs" -ms.date: "11/04/2016" +description: "Learn more about: typedefs" +ms.date: 11/04/2016 f1_keywords: ["string/std::string", "string/std::u16string", "string/std::u32string", "string/std::wstring"] -ms.assetid: fdca01e9-f2f1-4b59-abda-0093d760b3cc --- # `` typedefs -[`string`](#string)\ -[`u16string`](#u16string)\ -[`u32string`](#u32string)\ -[`wstring`](#wstring) +The `` header provides the following typedefs: ## `string` diff --git a/docs/standard-library/string-view-operators.md b/docs/standard-library/string-view-operators.md index cc6f5a702b3..1f3f4c44dec 100644 --- a/docs/standard-library/string-view-operators.md +++ b/docs/standard-library/string-view-operators.md @@ -1,7 +1,7 @@ --- title: " operators" -description: "API reference for the `string_view` operators, which are used to compare two `string_view` objects, or a `string_view` and some other string object" -ms.date: "01/15/2021" +description: "API reference for the `string_view` operators, which are used to compare two `string_view` objects, or a `string_view` and some other string object" +ms.date: 01/15/2021 f1_keywords: ["xstring/basic_string_view::operator!=", "xstring/basic_string_view::operator>", "xstring/basic_string_view::operator>=", "xstring/basic_string_view::operator<", "xstring/basic_string_view::operator<<", "xstring/basic_string_view::operator<=", "xstring/basic_string_view::operator+", "xstring/basic_string_view::operator==", 'xstring/std::literals::string_view_literals::operator "sv', 'std::literals::string_view_literals::operator sv', 'std::literals::string_view_literals', 'string_view_literals'] helpviewer_keywords: ["std::basic_string_view::operator!=", "std::basic_string_view::operator>", "std::basic_string_view::operator>=", "std::basic_string_view::operator<", "std::basic_string_view::operator<<", "std::basic_string_view::operator<=, std::basic_string_view::operator=="] --- @@ -9,15 +9,6 @@ helpviewer_keywords: ["std::basic_string_view::operator!=", "std::basic_string_v Use these operators to compare two `string_view` objects, or a `string_view` and some other string object (for example [`std::string`](basic-string-class.md), or `char*`) for which an implicit conversion is provided. -[`operator!=`](#op_neq)\ -[`operator>`](#op_gt)\ -[`operator>=`](#op_gt_eq)\ -[`operator<`](#op_lt)\ -[`operator<<`](#op_lt_lt)\ -[`operator<=`](#op_lt_eq)\ -[`operator==`](#op_eq_eq)\ -[`operator""sv`](#op_sv) - ## `operator!=` Tests if the object on the left side of the operator is not equal to the object on the right side. @@ -41,10 +32,10 @@ bool operator!=( ### Parameters -*left*\ +*`left`*\ Any convertible string type or an object of type `basic_string_view` to be compared. -*right*\ +*`right`*\ Any convertible string type or an object of type `basic_string_view` to be compared. ### Return Value @@ -80,10 +71,10 @@ bool operator==( ### Parameters -*left*\ +*`left`*\ Any convertible string type or an object of type `basic_string_view` to be compared. -*right*\ +*`right`*\ Any convertible string type or an object of type `basic_string_view` to be compared. ### Return Value @@ -119,10 +110,10 @@ bool operator<( ### Parameters -*left*\ +*`left`*\ Any convertible string type or an object of type `basic_string_view` to be compared. -*right*\ +*`right`*\ Any convertible string type or an object of type `basic_string_view` to be compared. ### Return Value @@ -131,7 +122,7 @@ Any convertible string type or an object of type `basic_string_view` to be compa ### Remarks -An implicit conversion must exist from *convertible_string_type* to the string_view on the other side. +An implicit conversion must exist from *convertible_string_type* to the `string_view` on the other side. The comparison is based on a pairwise lexicographical comparison of the character sequences. When the first unequal pair of characters is encountered, the result of that comparison is returned. If no unequal characters are found, but one sequence is shorter, the shorter sequence is less than the longer one. In other words, "cat" is less than "cats". @@ -180,10 +171,10 @@ bool operator<=( ### Parameters -*left*\ +*`left`*\ Any convertible string type or an object of type `basic_string_view` to be compared. -*right*\ +*`right`*\ Any convertible string type or an object of type `basic_string_view` to be compared. ### Return Value @@ -210,7 +201,7 @@ inline basic_ostream& operator<<( an output stream being written to. *`Str`*\ -The string_view to be entered into an output stream. +The `string_view` to be entered into an output stream. ### Return Value @@ -243,10 +234,10 @@ bool operator>( ### Parameters -*left*\ +*`left`*\ Any convertible string type or an object of type `basic_string_view` to be compared. -*right*\ +*`right`*\ Any convertible string type or an object of type `basic_string_view` to be compared. ### Return Value diff --git a/docs/standard-library/string-view-typedefs.md b/docs/standard-library/string-view-typedefs.md index 618b7ffee3a..083d68db246 100644 --- a/docs/standard-library/string-view-typedefs.md +++ b/docs/standard-library/string-view-typedefs.md @@ -1,15 +1,12 @@ --- -description: "Learn more about: typedefs" title: " typedefs" -ms.date: "04/19/2019" +description: "Learn more about: typedefs" +ms.date: 04/19/2019 f1_keywords: ["xstring/std::string_view", "xstring/std::u16string_view", "xstring/std::u32string_view", "xstring/std::wstring_view"] --- # `` typedefs -[string_view](#string_view)\ -[u16string_view](#u16string_view)\ -[u32string_view](#u32string_view)\ -[wstring_view](#wstring_view) +The `` header provides the following typedefs: ## string_view diff --git a/docs/standard-library/string-view.md b/docs/standard-library/string-view.md index 48ef23cc2a2..846721c1956 100644 --- a/docs/standard-library/string-view.md +++ b/docs/standard-library/string-view.md @@ -1,12 +1,12 @@ --- title: "" description: "Overview of `basic_string_view`, which refers to a constant contiguous sequence of char-like objects." -ms.date: "9/4/2020" +ms.date: 9/4/2020 helpviewer_keywords: ["string_view header"] --- # `` -Defines the class template `basic_string_view` and related types and operators. (Requires compiler option [`std:c++17`](../build/reference/std-specify-language-standard-version.md) or later.) +Defines the class template `basic_string_view` and related types and operators. (Requires compiler option [`/std:c++17`](../build/reference/std-specify-language-standard-version.md) or later.) ## Syntax @@ -37,7 +37,7 @@ The `` operators can compare `string_view` objects to objects of an |[`operator==`](../standard-library/string-view-operators.md#op_eq_eq)|Tests if the object on the left side of the operator is equal to the object on the right side.| |[`operator<`](../standard-library/string-view-operators.md#op_lt)|Tests if the object on the left side of the operator is less than to the object on the right side.| |[`operator<=`](../standard-library/string-view-operators.md#op_lt_eq)|Tests if the object on the left side of the operator is less than or equal to the object on the right side.| -|[`operator<\<`](../standard-library/string-view-operators.md#op_lt_lt)|A template function that inserts a `string_view` into an output stream.| +|[`operator<<`](../standard-library/string-view-operators.md#op_lt_lt)|A template function that inserts a `string_view` into an output stream.| |[`operator>`](../standard-library/string-view-operators.md#op_gt)|Tests if the object on the left side of the operator is greater than to the object on the right side.| |[`operator>=`](../standard-library/string-view-operators.md#op_gt_eq)|Tests if the object on the left side of the operator is greater than or equal to the object on the right side.| @@ -60,7 +60,7 @@ The `` operators can compare `string_view` objects to objects of an - **Namespace:** `std` -- **Compiler Option:** [`std:c++17`](../build/reference/std-specify-language-standard-version.md) or later. +- **Compiler Option:** [`/std:c++17`](../build/reference/std-specify-language-standard-version.md) or later. ## See also diff --git a/docs/standard-library/strstream-class.md b/docs/standard-library/strstream-class.md index 3efda849d7e..0a4c9c3d6be 100644 --- a/docs/standard-library/strstream-class.md +++ b/docs/standard-library/strstream-class.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: strstream Class" title: "strstream Class" -ms.date: "11/04/2016" +description: "Learn more about: strstream Class" +ms.date: 11/04/2016 f1_keywords: ["strstream/std::strstream::freeze", "strstream/std::strstream::pcount", "strstream/std::strstream::rdbuf", "strstream/std::strstream::str"] helpviewer_keywords: ["std::strstream [C++], freeze", "std::strstream [C++], pcount", "std::strstream [C++], rdbuf", "std::strstream [C++], str"] -ms.assetid: 63f3be31-9e36-42b1-9715-a474a5997e2a --- # strstream Class @@ -152,9 +151,9 @@ The buffer. Both constructors initialize the base class by calling [streambuf](../standard-library/streambuf-typedefs.md#streambuf)( **sb**), where `sb` is the stored object of class [strstreambuf](../standard-library/strstreambuf-class.md). The first constructor also initializes `sb` by calling [strstreambuf](../standard-library/strstreambuf-class.md#strstreambuf). The second constructor initializes the base class one of two ways: -- If `_Mode` & **ios_base::app**== 0, then *ptr* must designate the first element of an array of `count` elements, and the constructor calls `strstreambuf`( `ptr`, `count`, `ptr`). +- If `_Mode` & **ios_base::app**== 0, then *ptr* must designate the first element of an array of `count` elements, and the constructor calls `strstreambuf`(`ptr`, `count`, `ptr`). -- Otherwise, *ptr* must designate the first element of an array of count elements that contains a C string whose first element is designated by *ptr*, and the constructor calls `strstreambuf`( `ptr`, `count`, `ptr` + `strlen`( `ptr`) ). +- Otherwise, *ptr* must designate the first element of an array of count elements that contains a C string whose first element is designated by *ptr*, and the constructor calls `strstreambuf`(`ptr`, `count`, `ptr` + `strlen`(`ptr`)). ## See also diff --git a/docs/standard-library/subrange-class.md b/docs/standard-library/subrange-class.md index 7f269483d0e..98576c1de55 100644 --- a/docs/standard-library/subrange-class.md +++ b/docs/standard-library/subrange-class.md @@ -1,9 +1,9 @@ --- -title: subrange class (C++ Standard Library) +title: "subrange class (C++ Standard Library)" description: "API reference for the Standard Template Library (STL) subrange class, which is a view of the elements of a range as defined by a begin iterator and a sentinel." ms.date: 10/05/2022 f1_keywords: ["ranges/std::subrange", "ranges/std::subrange::begin", "ranges/std::subrange::data", "ranges/std::subrange::empty", "ranges/std::subrange::end", "ranges/std::subrange::get", "ranges/std::subrange::size", "ranges/std::subrange::operator bool", "ranges/std::subrange::operator PairLike", "ranges/std::subrange::back", "ranges/std::subrange::front", "ranges/std::subrange::operator[]", "ranges/std::subrange::advance", "ranges/std::subrange::prev", "ranges/std::subrange::next"] -helpviewer_keywords: ["std::ranges::subrange [C++]", "std::ranges::subrange::begin [C++]", "std::ranges::subrange::data [C++]", "std::ranges::subrange::empty [C++]", "std::ranges::subrange::end [C++]", "std::ranges::subrange::size [C++]", "std::ranges::subrange::back [C++]", "std::ranges::subrange::front [C++]", "std::ranges::subrange::advance [C++]", "std::ranges::subrange::prev [C++]", "std::ranges::subrange::next [C++]", "std::ranges::subrange::get [C++]", "std::ranges::subrange::operator[] [C++]", "std::ranges::subrange::operator bool [C++]", "std::ranges::subrange::operator PairLike [C++]"] +helpviewer_keywords: ["std::ranges::subrange [C++]", "std::ranges::subrange::begin [C++]", "std::ranges::subrange::data [C++]", "std::ranges::subrange::empty [C++]", "std::ranges::subrange::end [C++]", "std::ranges::subrange::size [C++]", "std::ranges::subrange::back [C++]", "std::ranges::subrange::front [C++]", "std::ranges::subrange::advance [C++]", "std::ranges::subrange::prev [C++]", "std::ranges::subrange::next [C++]", "std::ranges::subrange::get [C++]", "std::ranges::subrange::operator[] [C++]", "std::ranges::subrange::operator bool [C++]", "std::ranges::subrange::operator PairLike [C++]"] dev_langs: ["C++"] --- # `subrange` class (C++ Standard Library) diff --git a/docs/standard-library/sync-none-class.md b/docs/standard-library/sync-none-class.md index 1966997f4a5..df55c41667b 100644 --- a/docs/standard-library/sync-none-class.md +++ b/docs/standard-library/sync-none-class.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: sync_none Class" title: "sync_none Class" -ms.date: "11/04/2016" +description: "Learn more about: sync_none Class" +ms.date: 11/04/2016 f1_keywords: ["allocators/stdext::sync_none", "allocators/stdext::sync_none::allocate", "allocators/stdext::sync_none::deallocate", "allocators/stdext::sync_none::equals"] helpviewer_keywords: ["stdext::sync_none", "stdext::sync_none [C++], allocate", "stdext::sync_none [C++], deallocate", "stdext::sync_none [C++], equals"] -ms.assetid: f7473cee-14f3-4fe1-88bc-68cd085e59e1 --- # sync_none Class @@ -93,8 +92,6 @@ The cache object to compare for equality. The member function always returns **`true`**. -### Remarks - ## See also [\](../standard-library/allocators-header.md) diff --git a/docs/standard-library/sync-per-container-class.md b/docs/standard-library/sync-per-container-class.md index 796756f4288..2a164a0a0b1 100644 --- a/docs/standard-library/sync-per-container-class.md +++ b/docs/standard-library/sync-per-container-class.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: sync_per_container Class" title: "sync_per_container Class" -ms.date: "11/04/2016" +description: "Learn more about: sync_per_container Class" +ms.date: 11/04/2016 f1_keywords: ["allocators/stdext::sync_per_container", "allocators/stdext::sync_per_container::equals"] helpviewer_keywords: ["sync_per_container class"] -ms.assetid: 0b4b2904-b668-4d94-a422-d4f919cbffab --- # sync_per_container Class @@ -55,8 +54,6 @@ The cache object to compare for equality. The member function always returns **`false`**. -### Remarks - ## See also [\](../standard-library/allocators-header.md) diff --git a/docs/standard-library/sync-per-thread-class.md b/docs/standard-library/sync-per-thread-class.md index 6a4b0047247..aa715f4c698 100644 --- a/docs/standard-library/sync-per-thread-class.md +++ b/docs/standard-library/sync-per-thread-class.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: sync_per_thread Class" title: "sync_per_thread Class" -ms.date: "11/04/2016" +description: "Learn more about: sync_per_thread Class" +ms.date: 11/04/2016 f1_keywords: ["allocators/stdext::sync_per_thread", "allocators/stdext::sync_per_thread::allocate", "allocators/stdext::sync_per_thread::deallocate", "allocators/stdext::sync_per_thread::equals"] helpviewer_keywords: ["stdext::sync_per_thread", "stdext::sync_per_thread [C++], allocate", "stdext::sync_per_thread [C++], deallocate", "stdext::sync_per_thread [C++], equals"] -ms.assetid: 47bf75f8-5b02-4760-b1d3-3099d08fe14c --- # sync_per_thread Class @@ -97,8 +96,6 @@ The cache object to compare for equality. **`false`** if no cache object has been allocated for this object or for *Other* in the current thread. Otherwise it returns the result of applying `operator==` to the two cache objects. -### Remarks - ## See also [\](../standard-library/allocators-header.md) diff --git a/docs/standard-library/sync-shared-class.md b/docs/standard-library/sync-shared-class.md index 67ae7354c9e..bd722d3a534 100644 --- a/docs/standard-library/sync-shared-class.md +++ b/docs/standard-library/sync-shared-class.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: sync_shared Class" title: "sync_shared Class" -ms.date: "11/04/2016" +description: "Learn more about: sync_shared Class" +ms.date: 11/04/2016 f1_keywords: ["allocators/stdext::sync_shared", "allocators/stdext::sync_shared::allocate", "allocators/stdext::sync_shared::deallocate", "allocators/stdext::sync_shared::equals"] helpviewer_keywords: ["stdext::sync_shared", "stdext::sync_shared [C++], allocate", "stdext::sync_shared [C++], deallocate", "stdext::sync_shared [C++], equals"] -ms.assetid: cab3af9e-3d1a-4f2c-8580-0f89e5687d8e --- # sync_shared Class @@ -97,8 +96,6 @@ The cache to compare for equality. **`true`** if the result of `cache.equals(Other.cache)`, where `cache` represents the cache object, is **`true`**; otherwise, **`false`**. -### Remarks - ## See also [\](../standard-library/allocators-header.md) diff --git a/docs/standard-library/system-clock-structure.md b/docs/standard-library/system-clock-structure.md index d8bff11b411..e4f4f308681 100644 --- a/docs/standard-library/system-clock-structure.md +++ b/docs/standard-library/system-clock-structure.md @@ -1,6 +1,6 @@ --- -description: "Learn more about: system_clock Structure" title: "system_clock Structure" +description: "Learn more about: system_clock Structure" ms.date: 07/26/2021 f1_keywords: ["chrono/std::chrono::system_clock", "chrono/std::chrono::system_clock::from_time_t", "chrono/std::chrono::system_clock::now", "chrono/std::chrono::system_clock::to_time_t", "chrono/std::chrono::system_clock::is_steady constant"] helpviewer_keywords: ["std::chrono [C++], system_clock"] @@ -66,7 +66,7 @@ A clock is *steady* if it is *monotonic* and if the time between clock ticks is **Namespace:** `std::chrono` -## `from_time_t` +## `from_time_t` Static method that returns a [time_point](../standard-library/time-point-class.md) that most closely approximates the time that is represented by *Tm*. @@ -79,7 +79,7 @@ static time_point from_time_t(time_t Tm) noexcept; *`Tm`*\ A [time_t](../c-runtime-library/standard-types.md) object. -## `is_steady` +## `is_steady` A static value that specifies whether the clock type is *steady*. Because the `system_clock` isn't steady, you can't use this clock to take the time before an event, the time after an event, and reliably subtract them to get the duration of the event because the clock may be adjusted during the timing interval. diff --git a/docs/standard-library/system-error-enums.md b/docs/standard-library/system-error-enums.md index 2551b9345a5..9ad2a056960 100644 --- a/docs/standard-library/system-error-enums.md +++ b/docs/standard-library/system-error-enums.md @@ -1,9 +1,8 @@ --- -description: "Learn more about: enums" title: " enums" -ms.date: "11/04/2016" +description: "Learn more about: enums" +ms.date: 11/04/2016 f1_keywords: ["system_error/std::errc", "system_error/std::io_errc"] -ms.assetid: b21321b7-404a-40de-8777-a85b77c6fa58 --- # `` enums @@ -94,8 +93,6 @@ class errc { }; ``` -### Remarks - ## io_errc Provides symbolic names for the error conditions in \. Can be used to create [error_condition](../standard-library/error-condition-class.md) objects to be compared with the value that's returned by the [ios_base::failure](../standard-library/ios-base-class.md#failure)`code()` function. diff --git a/docs/standard-library/system-error-functions.md b/docs/standard-library/system-error-functions.md index af053fb4cb2..6de6c2d6a28 100644 --- a/docs/standard-library/system-error-functions.md +++ b/docs/standard-library/system-error-functions.md @@ -1,9 +1,8 @@ --- -description: "Learn more about: functions" title: " functions" +description: "Learn more about: functions" ms.date: "03/15/2019" f1_keywords: ["system_error/std::generic_category", "system_error/std::make_error_code", "system_error/std::make_error_condition", "system_error/std::system_category"] -ms.assetid: 57d6f15f-f0b7-4e2f-80fe-31d3c320ee33 helpviewer_keywords: ["std::generic_category", "std::make_error_code", "std::make_error_condition", "std::system_category"] --- # `` functions @@ -18,20 +17,24 @@ const error_category& generic_category() noexcept; ### Remarks -The `generic_category` object is an implementation of [error_category](../standard-library/error-category-class.md). +The `generic_category` object is an implementation of [error_category](error-category-class.md). ## is_error_code_enum_v +A helper variable template for the [`is_error_code_enum`](is-error-code-enum-class.md) value. + ```cpp template - inline constexpr bool is_error_code_enum_v = is_error_code_enum::value; +constexpr bool is_error_code_enum_v = is_error_code_enum::value; ``` ## is_error_condition_enum_v +A helper variable template for the [`is_error_condition_enum`](is-error-condition-enum-class.md) value. + ```cpp template - inline constexpr bool is_error_condition_enum_v = is_error_condition_enum::value; +constexpr bool is_error_condition_enum_v = is_error_condition_enum::value; ``` ## make_error_code @@ -51,8 +54,6 @@ The `std::errc` enumeration value to store in the error code object. The error code object. -### Remarks - ## make_error_condition Creates an error condition object. @@ -64,17 +65,15 @@ error_condition make_error_condition(std::errc error) noexcept; ### Parameters *error*\ -The `std::errc` enumeration value to store in the error code object. +The `std::errc` enumeration value to store in the error condition object. ### Return Value The error condition object. -### Remarks - ## system_category -Represents the category for errors caused by low-level system overflows. +Represents the category for operating system errors. ```cpp const error_category& system_category() noexcept; @@ -82,4 +81,4 @@ const error_category& system_category() noexcept; ### Remarks -The `system_category` object is an implementation of [error_category](../standard-library/error-category-class.md). +The `system_category` object is an implementation of [error_category](error-category-class.md). diff --git a/docs/standard-library/system-error-operators.md b/docs/standard-library/system-error-operators.md index ad43985bc57..58a4e804c31 100644 --- a/docs/standard-library/system-error-operators.md +++ b/docs/standard-library/system-error-operators.md @@ -1,13 +1,12 @@ --- -description: "Learn more about: operators" title: " operators" -ms.date: "11/04/2016" +description: "Learn more about: operators" +ms.date: "3/17/2025" f1_keywords: ["system_error/std::operator!=", "system_error/std::operator=="] -ms.assetid: c14edefb-bd8a-4e90-88d3-c59c98e6f73c --- # `` operators -## operator== +## `operator==` Tests if the object on the left side of the operator is equal to the object on the right side. @@ -24,11 +23,11 @@ bool operator==(const error_condition& left, ### Parameters -*left*\ -The object to be tested for equality. +*`left`*\ +The object to test for equality. -*right*\ -The object to be tested for equality. +*`right`*\ +The object to test for equality. ### Return Value @@ -38,7 +37,7 @@ The object to be tested for equality. This function returns `left.category() == right.category() && left.value() == right.value()`. -## operator!= +## `operator!=` Tests if the object on the left side of the operator is not equal to the object on the right side. @@ -51,15 +50,15 @@ bool operator!=(const error_condition& left, const error_condition& right); ### Parameters -*left*\ -The object to be tested for inequality. +*`left`*\ +The object to test for inequality. -*right*\ -The object to be tested for inequality. +*`right`*\ +The object to test for inequality. ### Return Value -**`true`** if the object passed in *left* is not equal to the object passed in *right*; otherwise **`false`**. +**`true`** if the object passed in *left* is not equal to the object passed in *`right`*; otherwise **`false`**. ### Remarks @@ -95,15 +94,15 @@ inline bool operator<( ### Parameters -*left*\ -The object to be compared. +*`left`*\ +The object to compare. -*right*\ -The object to be compared. +*`right`*\ +The object to compare. ### Return Value -**`true`** if the object passed in *left* is less than the object passed in *right*; Otherwise, **`false`**. +**`true`** if the object passed in *`left`* is less than the object passed in *`right`*; Otherwise, **`false`**. ### Remarks @@ -111,7 +110,42 @@ This function tests the error order. ## `operator<<` +Inserts an [`error_code`](error-code-class.md) object into the output stream. + ```cpp template - basic_ostream& operator<<(basic_ostream& os, const error_code& ec); +basic_ostream& operator<<(basic_ostream& os, const error_code& ec); +``` + +### Parameters + +*`os`*\ +The target output stream. + +*`ec`*\ +The `error_code` object to output. + +### Return Value + +A reference to the modified output stream. + +### Remarks + +This operator does the equivalent of `os << ec.category().name() << ':' << ec.value()`. + +### Example + +```cpp +#include +#include + +int main() +{ + std::error_code ec(1234, std::generic_category()); + std::cout << ec; +} +``` + +```Output +generic:1234 ``` diff --git a/docs/standard-library/system-error.md b/docs/standard-library/system-error.md index 0d12bfef30e..8a633804bff 100644 --- a/docs/standard-library/system-error.md +++ b/docs/standard-library/system-error.md @@ -1,20 +1,19 @@ --- -description: "Learn more about: " title: "" -ms.date: "03/15/2019" +description: "Learn more about: " +ms.date: 03/15/2019 f1_keywords: [""] helpviewer_keywords: ["system_error header"] -ms.assetid: 5e046c6e-48d9-4740-8c8a-05f3727c1215 --- # `` -Include the header \ to define the exception class `system_error` and related templates for processing low-level system errors. +Include the header `` to define the exception class `system_error` and related templates for processing low-level system errors. ## Requirements -**Header:** \ +**Header:** `` -**Namespace:** std +**Namespace:** `std` ## Members @@ -22,45 +21,45 @@ Include the header \ to define the exception class `system_error` |Name|Description| |-|-| -|[generic_category](../standard-library/system-error-functions.md#generic_category)|Represents the category for generic errors.| -|[is_error_code_enum_v](../standard-library/system-error-functions.md#is_error_code_enum_v)|| -|[is_error_condition_enum_v](../standard-library/system-error-functions.md#is_error_condition_enum_v)|| -|[system_category](../standard-library/system-error-functions.md#system_category)|Represents the category for errors caused by low-level system overflows.| +|[`generic_category`](system-error-functions.md#generic_category)|Represents the category for generic errors.| +|[`is_error_code_enum_v`](system-error-functions.md#is_error_code_enum_v)|A helper variable template for the [`is_error_code_enum`](is-error-code-enum-class.md) value.| +|[`is_error_condition_enum_v`](system-error-functions.md#is_error_condition_enum_v)|A helper variable template for the [`is_error_condition_enum`](is-error-condition-enum-class.md) value.| +|[`system_category`](system-error-functions.md#system_category)|Represents the category for operating system errors.| ### Functions |Name|Description| |-|-| -|[make_error_code](../standard-library/system-error-functions.md#make_error_code)|Creates an `error_code` object.| -|[make_error_condition](../standard-library/system-error-functions.md#make_error_condition)|Creates an `error_condition` object.| +|[`make_error_code`](system-error-functions.md#make_error_code)|Creates an [`error_code`](error-code-class.md) object.| +|[`make_error_condition`](system-error-functions.md#make_error_condition)|Creates an [`error_condition`](error-condition-class.md) object.| ### Operators |Name|Description| |-|-| -|[operator==](../standard-library/system-error-operators.md#op_eq_eq)|Tests if the object on the left side of the operator is equal to the object on the right side.| -|[operator!=](../standard-library/system-error-operators.md#op_neq)|Tests if the object on the left side of the operator is not equal to the object on the right side.| -|[operator<](../standard-library/system-error-operators.md#op_lt)|Tests if an object is less than the object passed in for comparison.| -|[operator<<](../standard-library/system-error-operators.md#op_ostream)|| +|[`operator==`](system-error-operators.md#op_eq_eq)|Tests if the object on the left side of the operator is equal to the object on the right side.| +|[`operator!=`](system-error-operators.md#op_neq)|Tests if the object on the left side of the operator is not equal to the object on the right side.| +|[`operator<`](system-error-operators.md#op_lt)|Tests if an object is less than the object passed in for comparison.| +|[`operator<<`](system-error-operators.md#op_ostream)|Inserts an [`error_code`](error-code-class.md) object into the output stream.| ### Enums |Name|Description| |-|-| -|[errc](../standard-library/system-error-enums.md#errc)|Provides symbolic names for all the error-code macros defined by POSIX in ``.| +|[`errc`](system-error-enums.md#errc)|Provides symbolic names for all the error-code macros defined by POSIX in ``.| ### Classes and Structs |Name|Description| |-|-| -|[error_category](../standard-library/error-category-class.md)|Represents the abstract, common base for objects that describes a category of error codes.| -|[error_code](../standard-library/error-code-class.md)|Represents low-level system errors that are implementation-specific.| -|[error_condition](../standard-library/error-condition-class.md)|Represents user-defined error codes.| -|[hash](../standard-library/hash-structure.md#system_error)|| -|[is_error_code_enum](../standard-library/is-error-code-enum-class.md)|Represents a type predicate that tests for the [error_code Class](../standard-library/error-code-class.md) enumeration.| -|[is_error_condition_enum](../standard-library/is-error-condition-enum-class.md)|Represents a type predicate that tests for the [error_condition Class](../standard-library/error-condition-class.md) enumeration.| -|[system_error](../standard-library/system-error-class.md)|Represents the base class for all exceptions thrown to report a low-level system overflow.| +|[`error_category`](error-category-class.md)|Represents the abstract, common base for objects that describes a category of error codes.| +|[`error_code`](error-code-class.md)|Represents low-level system errors that are implementation-specific.| +|[`error_condition`](error-condition-class.md)|Represents user-defined error codes.| +|[`hash`](hash-structure.md#system_error)|Template specializations of [`std::hash`](hash-class.md) for [`error_code`](error-code-class.md) and [`error_condition`](error-condition-class.md).| +|[`is_error_code_enum`](is-error-code-enum-class.md)|Represents a type predicate that tests for the [`error_code`](error-code-class.md) enumeration.| +|[`is_error_condition_enum`](is-error-condition-enum-class.md)|Represents a type predicate that tests for the [`error_condition`](error-condition-class.md) enumeration.| +|[`system_error`](system-error-class.md)|Represents the base class for all exceptions thrown to report a low-level system error.| ## See also -[Header Files Reference](../standard-library/cpp-standard-library-header-files.md) +[Header Files Reference](cpp-standard-library-header-files.md) diff --git a/docs/standard-library/thread-functions.md b/docs/standard-library/thread-functions.md index eea1f7215e9..ed86df6516b 100644 --- a/docs/standard-library/thread-functions.md +++ b/docs/standard-library/thread-functions.md @@ -1,65 +1,80 @@ --- -description: "Learn more about: functions" title: " functions" -ms.date: "11/04/2016" +description: "Learn more about: functions" +ms.date: 11/04/2016 f1_keywords: ["thread/std::get_id", "thread/std::sleep_for", "thread/std::sleep_until", "thread/std::swap", "thread/std::yield"] -ms.assetid: bb1aa1ef-fe3f-4e2c-8b6e-e22dbf2f5a19 helpviewer_keywords: ["std::get_id [C++]", "std::sleep_for [C++]", "std::sleep_until [C++]", "std::swap [C++]", "std::yield [C++]"] --- # `` functions -## get_id +The `` header provides the following functions: + +## `get_id` Uniquely identifies the current thread of execution. ```cpp -thread::id this_thread::get_id() noexcept; +thread::id get_id() noexcept; ``` ### Return Value -An object of type [thread::id](../standard-library/thread-class.md) that uniquely identifies the current thread of execution. +An object of type [`thread::id`](thread-class.md#id_class) that uniquely identifies the current thread of execution. + +### Example + +```cpp +#include +#include + +int main() +{ + std::thread::id current_thread_id = std::this_thread::get_id(); + std::cout << "Current thread id: " << current_thread_id; +} +``` -## sleep_for +```Output +Current thread id: 16196 +``` + +## `sleep_for` Blocks the calling thread. ```cpp -template -inline void sleep_for(const chrono::duration& Rel_time); +template +void sleep_for(const chrono::duration& Rel_time); ``` ### Parameters -*Rel_time*\ -A [duration](../standard-library/duration-class.md) object that specifies a time interval. +*`Rel_time`*\ +A [`duration`](duration-class.md) object that specifies a time interval. ### Remarks -The function blocks the calling thread for at least the time that's specified by *Rel_time*. This function does not throw any exceptions. +The function blocks the calling thread for at least the time that's specified by *`Rel_time`*. This function does not throw any exceptions. -## sleep_until +## `sleep_until` Blocks the calling thread at least until the specified time. ```cpp template void sleep_until(const chrono::time_point& Abs_time); - -void sleep_until(const xtime *Abs_time); ``` ### Parameters -*Abs_time*\ +*`Abs_time`*\ Represents a point in time. ### Remarks This function does not throw any exceptions. -## swap +## `swap` Swaps the states of two `thread` objects. @@ -69,17 +84,17 @@ void swap(thread& Left, thread& Right) noexcept; ### Parameters -*Left*\ +*`Left`*\ The left `thread` object. -*Right*\ +*`Right`*\ The right `thread` object. ### Remarks The function calls `Left.swap(Right)`. -## yield +## `yield` Signals the operating system to run other threads, even if the current thread would ordinarily continue to run. @@ -89,4 +104,4 @@ inline void yield() noexcept; ## See also -[\](../standard-library/thread.md) +[``](thread.md) diff --git a/docs/standard-library/thread-operators.md b/docs/standard-library/thread-operators.md index ad1f33155d7..485cbf10b5f 100644 --- a/docs/standard-library/thread-operators.md +++ b/docs/standard-library/thread-operators.md @@ -1,20 +1,13 @@ --- -description: "Learn more about: operators" title: " operators" -ms.date: "11/04/2016" +description: "Learn more about: operators" +ms.date: 11/04/2016 f1_keywords: ["thread/std::operator!=", "thread/std::operator>", "thread/std::operator>=", "thread/std::operator<", "thread/std::operator<<", "thread/std::operator<=", "thread/std::operator=="] -ms.assetid: e6bb6c0f-64f9-4cb2-9ff2-05b88a6ba7ac helpviewer_keywords: ["std::operator!= (thread)", "std::operator> (thread)", "std::operator>= (thread)", "std::operator< (thread)", "std::operator<< (thread)", "std::operator<= (thread)", "std::operator== (thread)"] --- # `` operators -[operator!=](#op_neq)\ -[`operator>`](#op_gt)\ -[`operator>=`](#op_gt_eq)\ -[`operator<`](#op_lt)\ -[`operator<<`](#op_lt_lt)\ -[`operator<=`](#op_lt_eq)\ -[operator==](#op_eq_eq) +The `` header provides the following operators: ## `operator>=` diff --git a/docs/standard-library/time-get-byname-class.md b/docs/standard-library/time-get-byname-class.md index 25750ba6014..abd437c52b7 100644 --- a/docs/standard-library/time-get-byname-class.md +++ b/docs/standard-library/time-get-byname-class.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: time_get_byname Class" title: "time_get_byname Class" -ms.date: "11/04/2016" +description: "Learn more about: time_get_byname Class" +ms.date: 11/04/2016 f1_keywords: ["xloctime/std::time_get_byname"] helpviewer_keywords: ["time_get_byname class"] -ms.assetid: 6e54153e-da40-4bb9-a942-1a6ce57b30c9 --- # time_get_byname Class @@ -41,7 +40,7 @@ An initial reference count. ## Requirements -Its behavior is determined by the named locale *_Locname*. Each constructor initializes its base object with [time_get](../standard-library/time-get-class.md#time_get)\( `_Refs`). +Its behavior is determined by the named locale *_Locname*. Each constructor initializes its base object with [time_get](../standard-library/time-get-class.md#time_get)\(`_Refs`). **Header:** \ diff --git a/docs/standard-library/time-point-class.md b/docs/standard-library/time-point-class.md index b5b9baf42b6..5535d23dd92 100644 --- a/docs/standard-library/time-point-class.md +++ b/docs/standard-library/time-point-class.md @@ -1,8 +1,8 @@ --- -description: "Learn more about: time_point Class" title: "time_point Class" +description: "Learn more about: time_point Class" ms.date: 01/05/2022 -f1_keywords: ["chrono/std::chrono::time_point", "chrono/std::chrono::time_point::operator +=", "chrono/std::chrono::time_point::operator -=", "chrono/std::chrono::time_point::max", "chrono/std::chrono::time_point::min", "chrono/std::chrono::time_point::time_since_epoch"] +f1_keywords: ["chrono/std::chrono::time_point", "chrono/std::chrono::time_point::operator +=", "chrono/std::chrono::time_point::operator -=", "chrono/std::chrono::time_point::max", "chrono/std::chrono::time_point::min", "chrono/std::chrono::time_point::time_since_epoch"] helpviewer_keywords: ["std::chrono [C++], time_point"] dev_langs: ["C++"] --- diff --git a/docs/standard-library/time-put-class.md b/docs/standard-library/time-put-class.md index 60255f4f25a..7792d1448d1 100644 --- a/docs/standard-library/time-put-class.md +++ b/docs/standard-library/time-put-class.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: time_put Class" title: "time_put Class" -ms.date: "11/04/2016" +description: "Learn more about: time_put Class" +ms.date: 11/04/2016 f1_keywords: ["xloctime/std::time_put", "locale/std::time_put::char_type", "locale/std::time_put::iter_type", "locale/std::time_put::do_put", "locale/std::time_put::put"] helpviewer_keywords: ["std::time_put [C++]", "std::time_put [C++], char_type", "std::time_put [C++], iter_type", "std::time_put [C++], do_put", "std::time_put [C++], put"] -ms.assetid: df79493e-3331-48d2-97c3-ac3a745f0791 --- # time_put Class @@ -176,7 +175,7 @@ An iterator to the first position after the last element inserted. ### Remarks -The first member function returns [do_put](#do_put)(`next`, `_Iosbase`, `_Fill`, `_Pt`, `_Fmt`, `_Mod`). The second member function copies to \* `next` ++ any element in the interval [ `first`, `last`) other than a percent (%). For a percent followed by a character *C* in the interval [ `first`, `last`), the function instead evaluates `next` = `do_put`( `next`, `_Iosbase`, `_Fill`, `_Pt`, *C*, 0) and skips past *C*. If, however, *C* is a qualifier character from the set EOQ#, followed by a character `C2` in the interval [ `first`, `last`), the function instead evaluates `next` = `do_put`( `next`, `_Iosbase`, `_Fill`, `_Pt`, `C2`, *C*) and skips past `C2`. +The first member function returns [do_put](#do_put)(`next`, `_Iosbase`, `_Fill`, `_Pt`, `_Fmt`, `_Mod`). The second member function copies to \* `next` ++ any element in the interval [ `first`, `last`) other than a percent (%). For a percent followed by a character *C* in the interval [ `first`, `last`), the function instead evaluates `next` = `do_put`(`next`, `_Iosbase`, `_Fill`, `_Pt`, *C*, 0) and skips past *C*. If, however, *C* is a qualifier character from the set EOQ#, followed by a character `C2` in the interval [ `first`, `last`), the function instead evaluates `next` = `do_put`(`next`, `_Iosbase`, `_Fill`, `_Pt`, `C2`, *C*) and skips past `C2`. ### Example diff --git a/docs/standard-library/toc.yml b/docs/standard-library/toc.yml index 43e6cbcb4e9..e34f783a1a7 100644 --- a/docs/standard-library/toc.yml +++ b/docs/standard-library/toc.yml @@ -169,9 +169,9 @@ items: href: gps-clock-class.md - name: hh_mm_ss class href: hhmmss-class.md - - name: high_resolution_clock struct + - name: high_resolution_clock struct href: high-resolution-clock-struct.md - - name: is_clock struct + - name: is_clock struct href: is-clock-struct.md - name: last_spec href: last-spec-struct.md @@ -797,6 +797,8 @@ items: href: recursive-mutex-class.md - name: recursive_timed_mutex class href: recursive-timed-mutex-class.md + - name: scoped_lock class + href: scoped-lock-class.md - name: timed_mutex class href: timed-mutex-class.md - name: try_to_lock_t struct @@ -1648,6 +1650,8 @@ items: href: iterators.md - name: Algorithms href: algorithms.md +- name: Vectorized STL Algorithms + href: vectorized-stl-algorithms.md - name: Allocators href: allocators.md - name: Function objects in the C++ Standard Library diff --git a/docs/standard-library/treat-as-floating-point-structure.md b/docs/standard-library/treat-as-floating-point-structure.md index 7389b8620fe..4dbd2818c38 100644 --- a/docs/standard-library/treat-as-floating-point-structure.md +++ b/docs/standard-library/treat-as-floating-point-structure.md @@ -1,11 +1,10 @@ --- -description: "Learn more about: treat_as_floating_point structure" title: "treat_as_floating_point Structure" +description: "Learn more about: treat_as_floating_point structure" ms.date: 07/16/2021 f1_keywords: ["chrono/std::chrono::treat_as_floating_point"] helpviewer_keywords: ["std::chrono [C++], treat_as_floating_point"] dev_langs: ["C++"] - --- # `treat_as_floating_point` structure diff --git a/docs/standard-library/tuple-size-class-tuple.md b/docs/standard-library/tuple-size-class-tuple.md index e5ed361621c..43ca9b50ea4 100644 --- a/docs/standard-library/tuple-size-class-tuple.md +++ b/docs/standard-library/tuple-size-class-tuple.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: tuple_size class;" -title: "tuple_size class;" +title: "tuple_size class" +description: "Learn more about: tuple_size class" ms.date: 06/29/2022 f1_keywords: ["tuple_size", "std::tuple_size", "utility/std::tuple_size"] helpviewer_keywords: ["std::tuple_size"] -ms.assetid: 73852fc5-eb68-41f1-8379-465cedc2314a --- # `tuple_size` class diff --git a/docs/standard-library/type-traits-functions.md b/docs/standard-library/type-traits-functions.md index 4bf7fc0c661..1cf5eab06cd 100644 --- a/docs/standard-library/type-traits-functions.md +++ b/docs/standard-library/type-traits-functions.md @@ -1,26 +1,12 @@ --- -description: "Learn more about: functions" title: " functions" -ms.date: "11/04/2016" -ms.assetid: dce4492f-f3e4-4d5e-bdb4-5875321254ec +description: "Learn more about: functions" +ms.date: 11/04/2016 helpviewer_keywords: ["std::is_assignable", "std::is_copy_assignable", "std::is_copy_constructible", "std::is_default_constructible", "std::is_move_assignable", "std::is_move_constructible", "std::is_nothrow_move_assignable", "std::is_trivially_copy_assignable", "std::is_trivially_move_assignable", "std::is_trivially_move_constructible"] --- # `` functions -[is_assignable](#is_assignable)\ -[is_copy_assignable](#is_copy_assignable)\ -[is_copy_constructible](#is_copy_constructible)\ -[is_default_constructible](#is_default_constructible)\ -[is_move_assignable](#is_move_assignable)\ -[is_move_constructible](#is_move_constructible)\ -[is_nothrow_move_assignable](#is_nothrow_move_assignable)\ -[is_nothrow_swappable](#is_nothrow_swappable)\ -[is_nothrow_swappable_with](#is_nothrow_swappable_with)\ -[is_swappable](#is_swappable)\ -[is_swappable_with](#is_swappable_with)\ -[is_trivially_copy_assignable](#is_trivially_copy_assignable)\ -[is_trivially_move_assignable](#is_trivially_move_assignable)\ -[is_trivially_move_constructible](#is_trivially_move_constructible) +The `` header provides the following functions: ## is_assignable diff --git a/docs/standard-library/type-traits-typedefs.md b/docs/standard-library/type-traits-typedefs.md index b1df31e15f7..95eaa6fc7bc 100644 --- a/docs/standard-library/type-traits-typedefs.md +++ b/docs/standard-library/type-traits-typedefs.md @@ -1,14 +1,12 @@ --- -description: "Learn more about: typedefs" title: " typedefs" -ms.date: "11/04/2016" +description: "Learn more about: typedefs" +ms.date: 11/04/2016 f1_keywords: ["type_traits/std::false_type", "xtr1common/std::false_type", "type_traits/std::true_type", "xtr1common/std::true_type"] -ms.assetid: 8ac040ca-ed2d-4570-adc9-cb5626530053 --- # `` typedefs -[false_type](#false_type)\ -[true_type](#true_type) +The `` header provides the following typedefs: ## false_type Typedef diff --git a/docs/standard-library/type-traits.md b/docs/standard-library/type-traits.md index 80f42ef05a1..b91cd8884c6 100644 --- a/docs/standard-library/type-traits.md +++ b/docs/standard-library/type-traits.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: " title: "" -ms.date: "02/21/2019" +description: "Learn more about: " +ms.date: 02/21/2019 f1_keywords: [""] helpviewer_keywords: ["typetrait header", "type_traits"] -ms.assetid: 2260b51f-8160-4c66-a82f-00b534cb60d4 --- # `` @@ -44,7 +43,7 @@ These are the provided aliases for the `type` members: `add_rvalue_reference_t`\ `add_volatile_t`\ `aligned_storage_t`\ - `aligned_union_t`\ + `aligned_union_t` :::column-end::: :::column::: `common_type_t`\ @@ -54,7 +53,7 @@ These are the provided aliases for the `type` members: `invoke_result_t`\ `make_signed_t`\ `make_unsigned_t`\ - `remove_all_extents_t`\ + `remove_all_extents_t` :::column-end::: :::column::: `remove_const_t`\ @@ -64,7 +63,7 @@ These are the provided aliases for the `type` members: `remove_reference_t`\ `remove_volatile_t`\ `result_of_t`\ - `underlying_type_t`\ + `underlying_type_t` :::column-end::: :::row-end::: diff --git a/docs/standard-library/underflow-error-class.md b/docs/standard-library/underflow-error-class.md index eee569a3f7b..3b1d405babc 100644 --- a/docs/standard-library/underflow-error-class.md +++ b/docs/standard-library/underflow-error-class.md @@ -1,12 +1,11 @@ --- -description: "Learn more about: underflow_error Class" -title: "underflow_error Class" -ms.date: "09/09/2021" +title: "underflow_error class" +description: "Learn more about: underflow_error class" +ms.date: 09/09/2021 f1_keywords: ["stdexcept/std::underflow_error"] helpviewer_keywords: ["underflow_error class"] -ms.assetid: d632f1f9-9c6c-4954-b96b-03041bfab22d --- -# underflow_error Class +# `underflow_error` class The class serves as the base class for all exceptions thrown to report an arithmetic underflow. @@ -18,13 +17,12 @@ public: explicit underflow_error(const string& message); explicit underflow_error(const char *message); - }; ``` ## Remarks -The value returned by `what()` is a copy of `message.data()`. For more information, see [`what`](../standard-library/exception-class.md) and [`data`](../standard-library/basic-string-class.md#data). +The value returned by `what()` is a copy of `message.data()`. For more information, see [`what`](exception-class.md) and [`data`](basic-string-class.md#data). `underflow_error` isn't thrown by any functions in the Microsoft implementation of the C++ Standard Library, but it might be thrown by third-party libraries or user code. @@ -51,19 +49,20 @@ int main() cerr << "Type: " << typeid(e).name() << endl; } } -/* Output: +``` + +```Output Caught: The number's a bit small, captain! Type: class std::underflow_error -*/ ``` ## Requirements -**Header:** \ +**Header:** `` -**Namespace:** std +**Namespace:** `std` ## See also -[runtime_error Class](../standard-library/runtime-error-class.md)\ -[Thread Safety in the C++ Standard Library](../standard-library/thread-safety-in-the-cpp-standard-library.md) +[`runtime_error` class](runtime-error-class.md)\ +[Thread Safety in the C++ Standard Library](thread-safety-in-the-cpp-standard-library.md) diff --git a/docs/standard-library/unique-lock-class.md b/docs/standard-library/unique-lock-class.md index 612058f1d80..6332a02e08d 100644 --- a/docs/standard-library/unique-lock-class.md +++ b/docs/standard-library/unique-lock-class.md @@ -1,9 +1,8 @@ --- -description: "Learn more about: unique_lock Class" title: "unique_lock Class" +description: "Learn more about: unique_lock Class" ms.date: 06/20/2022 f1_keywords: ["mutex/std::unique_lock"] -ms.assetid: f4ed8ba9-c8af-446f-8ef0-0b356bad14bd ms.custom: devdivchpfy22 --- @@ -298,7 +297,7 @@ The remaining constructors store & *Mtx* as the stored `mutex` pointer. Ownershi |`Rel_time`|Ownership is determined by calling `try_lock_for(Rel_time)`.| |`Abs_time`|Ownership is determined by calling `try_lock_until(Abs_time)`.| -## ~unique_lock Destructor +## ~unique_lock Destructor Releases any resources that are associated with the `unique_lock` object. diff --git a/docs/standard-library/unordered-map-class.md b/docs/standard-library/unordered-map-class.md index 90f5e8ac492..fb8bf60b413 100644 --- a/docs/standard-library/unordered-map-class.md +++ b/docs/standard-library/unordered-map-class.md @@ -4,7 +4,6 @@ description: "API reference for the C++ Standard Library container class `unorde ms.date: 06/20/2022 f1_keywords: ["unordered_map/std::unordered_map", "unordered_map/std::unordered_map::allocator_type", "unordered_map/std::unordered_map::const_iterator", "unordered_map/std::unordered_map::const_local_iterator", "unordered_map/std::unordered_map::const_pointer", "unordered_map/std::unordered_map::const_reference", "unordered_map/std::unordered_map::difference_type", "unordered_map/std::unordered_map::hasher", "unordered_map/std::unordered_map::iterator", "unordered_map/std::unordered_map::key_equal", "unordered_map/std::unordered_map::key_type", "unordered_map/std::unordered_map::local_iterator", "unordered_map/std::unordered_map::mapped_type", "unordered_map/std::unordered_map::pointer", "unordered_map/std::unordered_map::reference", "unordered_map/std::unordered_map::size_type", "unordered_map/std::unordered_map::value_type", "unordered_map/std::unordered_map::at", "unordered_map/std::unordered_map::begin", "unordered_map/std::unordered_map::bucket", "unordered_map/std::unordered_map::bucket_count", "unordered_map/std::unordered_map::bucket_size", "unordered_map/std::unordered_map::cbegin", "unordered_map/std::unordered_map::cend", "unordered_map/std::unordered_map::clear", "unordered_map/std::unordered_map::contains", "unordered_map/std::unordered_map::count", "unordered_map/std::unordered_map::emplace", "unordered_map/std::unordered_map::emplace_hint", "unordered_map/std::unordered_map::empty", "unordered_map/std::unordered_map::end", "unordered_map/std::unordered_map::equal_range", "unordered_map/std::unordered_map::erase", "unordered_map/std::unordered_map::find", "unordered_map/std::unordered_map::get_allocator", "unordered_map/std::unordered_map::hash", "unordered_map/std::unordered_map::insert", "unordered_map/std::unordered_map::key_eq", "unordered_map/std::unordered_map::load_factor", "unordered_map/std::unordered_map::max_bucket_count", "unordered_map/std::unordered_map::max_load_factor", "unordered_map/std::unordered_map::max_size", "unordered_map/std::unordered_map::rehash", "unordered_map/std::unordered_map::size", "unordered_map/std::unordered_map::swap", "unordered_map/std::unordered_map::unordered_map", "unordered_map/std::unordered_map::hash_function"] helpviewer_keywords: ["std::unordered_map", "std::unordered_map::allocator_type", "std::unordered_map::const_iterator", "std::unordered_map::const_local_iterator", "std::unordered_map::const_pointer", "std::unordered_map::const_reference", "std::unordered_map::difference_type", "std::unordered_map::hasher", "std::unordered_map::iterator", "std::unordered_map::key_equal", "std::unordered_map::key_type", "std::unordered_map::local_iterator", "std::unordered_map::mapped_type", "std::unordered_map::pointer", "std::unordered_map::reference", "std::unordered_map::size_type", "std::unordered_map::value_type", "std::unordered_map::at", "std::unordered_map::begin", "std::unordered_map::bucket", "std::unordered_map::bucket_count", "std::unordered_map::bucket_size", "std::unordered_map::cbegin", "std::unordered_map::cend", "std::unordered_map::clear", "std::unordered_map::contains", "std::unordered_map::count", "std::unordered_map::emplace", "std::unordered_map::emplace_hint", "std::unordered_map::empty", "std::unordered_map::end", "std::unordered_map::equal_range", "std::unordered_map::erase", "std::unordered_map::find", "std::unordered_map::get_allocator", "std::unordered_map::hash", "std::unordered_map::insert", "std::unordered_map::key_eq", "std::unordered_map::load_factor", "std::unordered_map::max_bucket_count", "std::unordered_map::max_load_factor", "std::unordered_map::max_size", "std::unordered_map::rehash", "std::unordered_map::size", "std::unordered_map::swap", "std::unordered_map::unordered_map", "std::unordered_map::allocator_type", "std::unordered_map::const_iterator", "std::unordered_map::const_local_iterator", "std::unordered_map::const_pointer", "std::unordered_map::const_reference", "std::unordered_map::difference_type", "std::unordered_map::hasher", "std::unordered_map::iterator", "std::unordered_map::key_equal", "std::unordered_map::key_type", "std::unordered_map::local_iterator", "std::unordered_map::mapped_type", "std::unordered_map::pointer", "std::unordered_map::reference", "std::unordered_map::size_type", "std::unordered_map::value_type", "std::unordered_map::at", "std::unordered_map::begin", "std::unordered_map::bucket", "std::unordered_map::bucket_count", "std::unordered_map::bucket_size", "std::unordered_map::cbegin", "std::unordered_map::cend", "std::unordered_map::clear", "std::unordered_map::count", "std::unordered_map::emplace", "std::unordered_map::emplace_hint", "std::unordered_map::empty", "std::unordered_map::end", "std::unordered_map::equal_range", "std::unordered_map::erase", "std::unordered_map::find", "std::unordered_map::get_allocator", "std::unordered_map::hash_function", "std::unordered_map::insert", "std::unordered_map::key_eq", "std::unordered_map::load_factor", "std::unordered_map::max_bucket_count", "std::unordered_map::max_load_factor", "std::unordered_map::max_size", "std::unordered_map::rehash", "std::unordered_map::size", "std::unordered_map::swap"] -ms.assetid: 7cf7cfa1-16e7-461c-a9b2-3b8d8ec24e0d ms.custom: devdivchpfy22 --- @@ -100,7 +99,7 @@ The allocator class. ## Remarks -The object orders the sequence it controls by calling two stored objects, a comparison function object of type [`unordered_map::key_equal`](#key_equal) and a hash function object of type [`unordered_map::hasher`](#hasher). You access the first stored object by calling the member function [`unordered_map::key_eq`](#key_eq)`()`; and you access the second stored object by calling the member function [`unordered_map::hash_function`](#hash)`()`. Specifically, for all values `X` and `Y` of type `Key`, the call `key_eq()(X, Y)` returns true only if the two argument values have equivalent ordering; the call `hash_function()(keyval)` yields a distribution of values of type `size_t`. Unlike class template [`unordered_multimap` Class](../standard-library/unordered-multimap-class.md), an object of type `unordered_map` ensures that `key_eq()(X, Y)` is always false for any two elements of the controlled sequence. (Keys are unique.) +The object orders the sequence it controls by calling two stored objects, a comparison function object of type [`unordered_map::key_equal`](#key_equal) and a hash function object of type [`unordered_map::hasher`](#hasher). You access the first stored object by calling the member function [`unordered_map::key_eq`](#key_eq)`()`; and you access the second stored object by calling the member function [`unordered_map::hash_function`](#hash)`()`. Specifically, for all values `X` and `Y` of type `Key`, the call `key_eq()(X, Y)` returns true only if the two argument values have equivalent ordering; the call `hash_function()(keyval)` yields a distribution of values of type `size_t`. Unlike class template [`unordered_multimap`](../standard-library/unordered-multimap-class.md), an object of type `unordered_map` ensures that `key_eq()(X, Y)` is always false for any two elements of the controlled sequence. (Keys are unique.) The object also stores a maximum load factor, which specifies the maximum desired average number of elements per bucket. If inserting an element causes [`unordered_map::load_factor`](#load_factor)`()` to exceed the maximum load factor, the container increases the number of buckets and rebuilds the hash table as needed. @@ -796,7 +795,7 @@ The key value of the element to look for. ### Example ```cpp -// Requires /std:c++20 or /std:c++latest +// Requires /std:c++20 or later #include #include @@ -2781,4 +2780,4 @@ int main() ## See also [``](../standard-library/unordered-map.md)\ -[Thread Safety in the C++ Standard Library](../standard-library/thread-safety-in-the-cpp-standard-library.md)\ +[Thread Safety in the C++ Standard Library](../standard-library/thread-safety-in-the-cpp-standard-library.md) diff --git a/docs/standard-library/unordered-map-functions.md b/docs/standard-library/unordered-map-functions.md index 36f731bacf1..20e3941dffc 100644 --- a/docs/standard-library/unordered-map-functions.md +++ b/docs/standard-library/unordered-map-functions.md @@ -1,15 +1,13 @@ --- -description: "Learn more about: functions" title: " functions" -ms.date: "11/04/2016" +description: "Learn more about: functions" +ms.date: 11/04/2016 f1_keywords: ["unordered_map/std::swap", "unordered_map/std::swap (unordered_map)", "unordered_map/std::swap (unordered_multimap)"] -ms.assetid: cf2e4115-f205-4a0e-90be-a143ffcc1f44 helpviewer_keywords: ["std::swap (unordered_map/multimap)"] --- # `` functions -[swap (unordered_map)](#swap) -[swap (unordered_multimap)](#swap_function_multimap) +The `` header provides the following functions: ## swap (unordered_map) diff --git a/docs/standard-library/unordered-map-operators.md b/docs/standard-library/unordered-map-operators.md index 1e4e87c66d0..5913612c659 100644 --- a/docs/standard-library/unordered-map-operators.md +++ b/docs/standard-library/unordered-map-operators.md @@ -1,16 +1,12 @@ --- -description: "Learn more about: operators" title: " operators" -ms.date: "11/04/2016" +description: "Learn more about: operators" +ms.date: 11/04/2016 f1_keywords: ["unordered_map/std::operator!=", "unordered_map/std::operator=="] -ms.assetid: 9d5add0b-84bd-4a79-bd82-3f58b55145ed --- # `` operators -[unordered_map::operator!=](#op_neq)\ -[unordered_map::operator==](#op_eq_eq)\ -[unordered_multimap::operator!=](#op_neq_multimap)\ -[unordered_multimap::operator==](#op_eq_eq_multimap) +The `` header provides the following operators: ## operator!= diff --git a/docs/standard-library/unordered-multimap-class.md b/docs/standard-library/unordered-multimap-class.md index 0f61a2cac00..b1071b77809 100644 --- a/docs/standard-library/unordered-multimap-class.md +++ b/docs/standard-library/unordered-multimap-class.md @@ -1,13 +1,9 @@ --- title: "unordered_multimap Class" description: "API overview for the C++ Standard Library container class `unordered_multimap`." -ms.date: "9/9/2020" -f1_keywords: ["unordered_map/std::unordered_multimap", "unordered_map/std::unordered_multimap::allocator_type", "unordered_map/std::unordered_multimap::const_iterator", "unordered_map/std::unordered_multimap::const_local_iterator", "unordered_map/std::unordered_multimap::const_pointer", "unordered_map/std::unordered_multimap::const_reference", "unordered_map/std::unordered_multimap::difference_type", "unordered_map/std::unordered_multimap::hasher", "unordered_map/std::unordered_multimap::iterator", "unordered_map/std::unordered_multimap::key_equal", "unordered_map/std::unordered_multimap::key_type", "unordered_map/std::unordered_multimap::local_iterator", "unordered_map/std::unordered_multimap::mapped_type", "unordered_map/std::unordered_multimap::pointer", "unordered_map/std::unordered_multimap::reference", "unordered_map/std::unordered_multimap::size_type", "unordered_map/std::unordered_multimap::value_type", "unordered_map/std::unordered_multimap::begin", "unordered_map/std::unordered_multimap::bucket", "unordered_map/std::unordered_multimap::bucket_count", "unordered_map/std::unordered_multimap::bucket_size", "unordered_map/std::unordered_multimap::cbegin", "unordered_map/std::unordered_multimap::cend", "unordered_map/std::unordered_multimap::clear", -"unordered_map/std::unordered_multimap::contains", "unordered_map/std::unordered_multimap::count", "unordered_map/std::unordered_multimap::emplace", "unordered_map/std::unordered_multimap::emplace_hint", "unordered_map/std::unordered_multimap::empty", "unordered_map/std::unordered_multimap::end", "unordered_map/std::unordered_multimap::equal_range", "unordered_map/std::unordered_multimap::erase", "unordered_map/std::unordered_multimap::find", "unordered_map/std::unordered_multimap::get_allocator", "unordered_map/std::unordered_multimap::hash", "unordered_map/std::unordered_multimap::insert", "unordered_map/std::unordered_multimap::key_eq", "unordered_map/std::unordered_multimap::load_factor", "unordered_map/std::unordered_multimap::max_bucket_count", "unordered_map/std::unordered_multimap::max_load_factor", "unordered_map/std::unordered_multimap::max_size", "unordered_map/std::unordered_multimap::rehash", "unordered_map/std::unordered_multimap::size", "unordered_map/std::unordered_multimap::swap", "unordered_map/std::unordered_multimap::unordered_multimap", "unordered_map/std::unordered_multimap::operator=", "unordered_map/std::unordered_multimap::hash_function"] -helpviewer_keywords: ["std::unordered_multimap", "std::unordered_multimap::allocator_type", "std::unordered_multimap::const_iterator", "std::unordered_multimap::const_local_iterator", "std::unordered_multimap::const_pointer", "std::unordered_multimap::const_reference", "std::unordered_multimap::difference_type", "std::unordered_multimap::hasher", "std::unordered_multimap::iterator", "std::unordered_multimap::key_equal", "std::unordered_multimap::key_type", "std::unordered_multimap::local_iterator", "std::unordered_multimap::mapped_type", "std::unordered_multimap::pointer", "std::unordered_multimap::reference", "std::unordered_multimap::size_type", "std::unordered_multimap::value_type", "std::unordered_multimap::begin", "std::unordered_multimap::bucket", "std::unordered_multimap::bucket_count", "std::unordered_multimap::bucket_size", "std::unordered_multimap::cbegin", "std::unordered_multimap::cend", "std::unordered_multimap::clear", -"std::unordered_multimap::contains", -"std::unordered_multimap::count", "std::unordered_multimap::emplace", "std::unordered_multimap::emplace_hint", "std::unordered_multimap::empty", "std::unordered_multimap::end", "std::unordered_multimap::equal_range", "std::unordered_multimap::erase", "std::unordered_multimap::find", "std::unordered_multimap::get_allocator", "std::unordered_multimap::hash", "std::unordered_multimap::insert", "std::unordered_multimap::key_eq", "std::unordered_multimap::load_factor", "std::unordered_multimap::max_bucket_count", "std::unordered_multimap::max_load_factor", "std::unordered_multimap::max_size", "std::unordered_multimap::rehash", "std::unordered_multimap::size", "std::unordered_multimap::swap", "std::unordered_multimap::unordered_multimap", "std::unordered_multimap::operator=", "std::unordered_multimap::allocator_type", "std::unordered_multimap::const_iterator", "std::unordered_multimap::const_local_iterator", "std::unordered_multimap::const_pointer", "std::unordered_multimap::const_reference", "std::unordered_multimap::difference_type", "std::unordered_multimap::hasher", "std::unordered_multimap::iterator", "std::unordered_multimap::key_equal", "std::unordered_multimap::key_type", "std::unordered_multimap::local_iterator", "std::unordered_multimap::mapped_type", "std::unordered_multimap::pointer", "std::unordered_multimap::reference", "std::unordered_multimap::size_type", "std::unordered_multimap::value_type", "std::unordered_multimap::begin", "std::unordered_multimap::bucket", "std::unordered_multimap::bucket_count", "std::unordered_multimap::bucket_size", "std::unordered_multimap::cbegin", "std::unordered_multimap::cend", "std::unordered_multimap::clear", "std::unordered_multimap::count", "std::unordered_multimap::emplace", "std::unordered_multimap::emplace_hint", "std::unordered_multimap::empty", "std::unordered_multimap::end", "std::unordered_multimap::equal_range", "std::unordered_multimap::erase", "std::unordered_multimap::find", "std::unordered_multimap::get_allocator", "std::unordered_multimap::hash_function", "std::unordered_multimap::insert", "std::unordered_multimap::key_eq", "std::unordered_multimap::load_factor", "std::unordered_multimap::max_bucket_count", "std::unordered_multimap::max_load_factor", "std::unordered_multimap::max_size", "std::unordered_multimap::rehash", "std::unordered_multimap::size", "std::unordered_multimap::swap"] -ms.assetid: 4baead6c-5870-4b85-940f-a47d6b891c27 +ms.date: 9/9/2020 +f1_keywords: ["unordered_map/std::unordered_multimap", "unordered_map/std::unordered_multimap::allocator_type", "unordered_map/std::unordered_multimap::const_iterator", "unordered_map/std::unordered_multimap::const_local_iterator", "unordered_map/std::unordered_multimap::const_pointer", "unordered_map/std::unordered_multimap::const_reference", "unordered_map/std::unordered_multimap::difference_type", "unordered_map/std::unordered_multimap::hasher", "unordered_map/std::unordered_multimap::iterator", "unordered_map/std::unordered_multimap::key_equal", "unordered_map/std::unordered_multimap::key_type", "unordered_map/std::unordered_multimap::local_iterator", "unordered_map/std::unordered_multimap::mapped_type", "unordered_map/std::unordered_multimap::pointer", "unordered_map/std::unordered_multimap::reference", "unordered_map/std::unordered_multimap::size_type", "unordered_map/std::unordered_multimap::value_type", "unordered_map/std::unordered_multimap::begin", "unordered_map/std::unordered_multimap::bucket", "unordered_map/std::unordered_multimap::bucket_count", "unordered_map/std::unordered_multimap::bucket_size", "unordered_map/std::unordered_multimap::cbegin", "unordered_map/std::unordered_multimap::cend", "unordered_map/std::unordered_multimap::clear", "unordered_map/std::unordered_multimap::contains", "unordered_map/std::unordered_multimap::count", "unordered_map/std::unordered_multimap::emplace", "unordered_map/std::unordered_multimap::emplace_hint", "unordered_map/std::unordered_multimap::empty", "unordered_map/std::unordered_multimap::end", "unordered_map/std::unordered_multimap::equal_range", "unordered_map/std::unordered_multimap::erase", "unordered_map/std::unordered_multimap::find", "unordered_map/std::unordered_multimap::get_allocator", "unordered_map/std::unordered_multimap::hash", "unordered_map/std::unordered_multimap::insert", "unordered_map/std::unordered_multimap::key_eq", "unordered_map/std::unordered_multimap::load_factor", "unordered_map/std::unordered_multimap::max_bucket_count", "unordered_map/std::unordered_multimap::max_load_factor", "unordered_map/std::unordered_multimap::max_size", "unordered_map/std::unordered_multimap::rehash", "unordered_map/std::unordered_multimap::size", "unordered_map/std::unordered_multimap::swap", "unordered_map/std::unordered_multimap::unordered_multimap", "unordered_map/std::unordered_multimap::operator=", "unordered_map/std::unordered_multimap::hash_function"] +helpviewer_keywords: ["std::unordered_multimap", "std::unordered_multimap::allocator_type", "std::unordered_multimap::const_iterator", "std::unordered_multimap::const_local_iterator", "std::unordered_multimap::const_pointer", "std::unordered_multimap::const_reference", "std::unordered_multimap::difference_type", "std::unordered_multimap::hasher", "std::unordered_multimap::iterator", "std::unordered_multimap::key_equal", "std::unordered_multimap::key_type", "std::unordered_multimap::local_iterator", "std::unordered_multimap::mapped_type", "std::unordered_multimap::pointer", "std::unordered_multimap::reference", "std::unordered_multimap::size_type", "std::unordered_multimap::value_type", "std::unordered_multimap::begin", "std::unordered_multimap::bucket", "std::unordered_multimap::bucket_count", "std::unordered_multimap::bucket_size", "std::unordered_multimap::cbegin", "std::unordered_multimap::cend", "std::unordered_multimap::clear", "std::unordered_multimap::contains", "std::unordered_multimap::count", "std::unordered_multimap::emplace", "std::unordered_multimap::emplace_hint", "std::unordered_multimap::empty", "std::unordered_multimap::end", "std::unordered_multimap::equal_range", "std::unordered_multimap::erase", "std::unordered_multimap::find", "std::unordered_multimap::get_allocator", "std::unordered_multimap::hash", "std::unordered_multimap::insert", "std::unordered_multimap::key_eq", "std::unordered_multimap::load_factor", "std::unordered_multimap::max_bucket_count", "std::unordered_multimap::max_load_factor", "std::unordered_multimap::max_size", "std::unordered_multimap::rehash", "std::unordered_multimap::size", "std::unordered_multimap::swap", "std::unordered_multimap::unordered_multimap", "std::unordered_multimap::operator=", "std::unordered_multimap::allocator_type", "std::unordered_multimap::const_iterator", "std::unordered_multimap::const_local_iterator", "std::unordered_multimap::const_pointer", "std::unordered_multimap::const_reference", "std::unordered_multimap::difference_type", "std::unordered_multimap::hasher", "std::unordered_multimap::iterator", "std::unordered_multimap::key_equal", "std::unordered_multimap::key_type", "std::unordered_multimap::local_iterator", "std::unordered_multimap::mapped_type", "std::unordered_multimap::pointer", "std::unordered_multimap::reference", "std::unordered_multimap::size_type", "std::unordered_multimap::value_type", "std::unordered_multimap::begin", "std::unordered_multimap::bucket", "std::unordered_multimap::bucket_count", "std::unordered_multimap::bucket_size", "std::unordered_multimap::cbegin", "std::unordered_multimap::cend", "std::unordered_multimap::clear", "std::unordered_multimap::count", "std::unordered_multimap::emplace", "std::unordered_multimap::emplace_hint", "std::unordered_multimap::empty", "std::unordered_multimap::end", "std::unordered_multimap::equal_range", "std::unordered_multimap::erase", "std::unordered_multimap::find", "std::unordered_multimap::get_allocator", "std::unordered_multimap::hash_function", "std::unordered_multimap::insert", "std::unordered_multimap::key_eq", "std::unordered_multimap::load_factor", "std::unordered_multimap::max_bucket_count", "std::unordered_multimap::max_load_factor", "std::unordered_multimap::max_size", "std::unordered_multimap::rehash", "std::unordered_multimap::size", "std::unordered_multimap::swap"] --- # unordered_multimap Class @@ -99,7 +95,7 @@ The allocator class. ## Remarks -The object orders the sequence it controls by calling two stored objects, a comparison function object of type [unordered_multimap::key_equal](#key_equal) and a hash function object of type [unordered_multimap::hasher](#hasher). You access the first stored object by calling the member function [unordered_multimap::key_eq](#key_eq)`()`; and you access the second stored object by calling the member function [unordered_multimap::hash_function](#hash)`()`. Specifically, for all values `X` and `Y` of type `Key`, the call `key_eq()(X, Y)` returns true only if the two argument values have equivalent ordering; the call `hash_function()(keyval)` yields a distribution of values of type `size_t`. Unlike class template [unordered_map Class](../standard-library/unordered-map-class.md), an object of type `unordered_multimap` does not ensure that `key_eq()(X, Y)` is always false for any two elements of the controlled sequence. (Keys need not be unique.) +The object orders the sequence it controls by calling two stored objects, a comparison function object of type [unordered_multimap::key_equal](#key_equal) and a hash function object of type [unordered_multimap::hasher](#hasher). You access the first stored object by calling the member function [unordered_multimap::key_eq](#key_eq)`()`; and you access the second stored object by calling the member function [unordered_multimap::hash_function](#hash)`()`. Specifically, for all values `X` and `Y` of type `Key`, the call `key_eq()(X, Y)` returns true only if the two argument values have equivalent ordering; the call `hash_function()(keyval)` yields a distribution of values of type `size_t`. Unlike class template [`unordered_map`](../standard-library/unordered-map-class.md), an object of type `unordered_multimap` does not ensure that `key_eq()(X, Y)` is always false for any two elements of the controlled sequence. (Keys need not be unique.) The object also stores a maximum load factor, which specifies the maximum desired average number of elements per bucket. If inserting an element causes [unordered_multimap::load_factor](#load_factor)`()` to exceed the maximum load factor, the container increases the number of buckets and rebuilds the hash table as needed. @@ -750,7 +746,7 @@ The element's key value to look for. ### Example ```cpp -// Requires /std:c++20 or /std:c++latest +// Requires /std:c++20 or later #include #include diff --git a/docs/standard-library/unordered-multiset-class.md b/docs/standard-library/unordered-multiset-class.md index 1a08ac38ecf..1b6e8fd3651 100644 --- a/docs/standard-library/unordered-multiset-class.md +++ b/docs/standard-library/unordered-multiset-class.md @@ -1,10 +1,9 @@ --- title: "unordered_multiset Class" description: "API reference for the C++ Standard Library container class `unordered_multiset`, which describes an object used for the storage and retrieval of data from a collection in which the values of the elements contained need not be unique and in which they serve as the key values. The data isn't automatically ordered." -ms.date: "9/10/2020" +ms.date: 9/10/2020 f1_keywords: ["unordered_set/std::unordered_multiset", "unordered_set/std::unordered_multiset::allocator_type", "unordered_set/std::unordered_multiset::const_iterator", "unordered_set/std::unordered_multiset::const_local_iterator", "unordered_set/std::unordered_multiset::const_pointer", "unordered_set/std::unordered_multiset::const_reference", "unordered_set/std::unordered_multiset::difference_type", "unordered_set/std::unordered_multiset::hasher", "unordered_set/std::unordered_multiset::iterator", "unordered_set/std::unordered_multiset::key_equal", "unordered_set/std::unordered_multiset::key_type", "unordered_set/std::unordered_multiset::local_iterator", "unordered_set/std::unordered_multiset::pointer", "unordered_set/std::unordered_multiset::reference", "unordered_set/std::unordered_multiset::size_type", "unordered_set/std::unordered_multiset::value_type", "unordered_set/std::unordered_multiset::begin", "unordered_set/std::unordered_multiset::bucket", "unordered_set/std::unordered_multiset::bucket_count", "unordered_set/std::unordered_multiset::bucket_size", "unordered_set/std::unordered_multiset::cbegin", "unordered_set/std::unordered_multiset::cend", "unordered_set/std::unordered_multiset::clear", "unordered_set/std::unordered_multiset::contains", "unordered_set/std::unordered_multiset::count", "unordered_set/std::unordered_multiset::emplace", "unordered_set/std::unordered_multiset::emplace_hint", "unordered_set/std::unordered_multiset::empty", "unordered_set/std::unordered_multiset::end", "unordered_set/std::unordered_multiset::equal_range", "unordered_set/std::unordered_multiset::erase", "unordered_set/std::unordered_multiset::find", "unordered_set/std::unordered_multiset::get_allocator", "unordered_set/std::unordered_multiset::hash", "unordered_set/std::unordered_multiset::insert", "unordered_set/std::unordered_multiset::key_eq", "unordered_set/std::unordered_multiset::load_factor", "unordered_set/std::unordered_multiset::max_bucket_count", "unordered_set/std::unordered_multiset::max_load_factor", "unordered_set/std::unordered_multiset::max_size", "unordered_set/std::unordered_multiset::rehash", "unordered_set/std::unordered_multiset::size", "unordered_set/std::unordered_multiset::swap", "unordered_set/std::unordered_multiset::unordered_multiset", "unordered_set/std::unordered_multiset::operator=", "unordered_set/std::unordered_multiset::hash_function"] helpviewer_keywords: ["std::unordered_multiset", "std::unordered_multiset::allocator_type", "std::unordered_multiset::const_iterator", "std::unordered_multiset::const_local_iterator", "std::unordered_multiset::const_pointer", "std::unordered_multiset::const_reference", "std::unordered_multiset::difference_type", "std::unordered_multiset::hasher", "std::unordered_multiset::iterator", "std::unordered_multiset::key_equal", "std::unordered_multiset::key_type", "std::unordered_multiset::local_iterator", "std::unordered_multiset::pointer", "std::unordered_multiset::reference", "std::unordered_multiset::size_type", "std::unordered_multiset::value_type", "std::unordered_multiset::begin", "std::unordered_multiset::bucket", "std::unordered_multiset::bucket_count", "std::unordered_multiset::bucket_size", "std::unordered_multiset::cbegin", "std::unordered_multiset::cend", "std::unordered_multiset::clear", "std::unordered_multiset::contains", "std::unordered_multiset::count", "std::unordered_multiset::emplace", "std::unordered_multiset::emplace_hint", "std::unordered_multiset::empty", "std::unordered_multiset::end", "std::unordered_multiset::equal_range", "std::unordered_multiset::erase", "std::unordered_multiset::find", "std::unordered_multiset::get_allocator", "std::unordered_multiset::hash", "std::unordered_multiset::insert", "std::unordered_multiset::key_eq", "std::unordered_multiset::load_factor", "std::unordered_multiset::max_bucket_count", "std::unordered_multiset::max_load_factor", "std::unordered_multiset::max_size", "std::unordered_multiset::rehash", "std::unordered_multiset::size", "std::unordered_multiset::swap", "std::unordered_multiset::unordered_multiset", "std::unordered_multiset::operator=", "std::unordered_multiset::allocator_type", "std::unordered_multiset::const_iterator", "std::unordered_multiset::const_local_iterator", "std::unordered_multiset::const_pointer", "std::unordered_multiset::const_reference", "std::unordered_multiset::difference_type", "std::unordered_multiset::hasher", "std::unordered_multiset::iterator", "std::unordered_multiset::key_equal", "std::unordered_multiset::key_type", "std::unordered_multiset::local_iterator", "std::unordered_multiset::pointer", "std::unordered_multiset::reference", "std::unordered_multiset::size_type", "std::unordered_multiset::value_type", "std::unordered_multiset::begin", "std::unordered_multiset::bucket", "std::unordered_multiset::bucket_count", "std::unordered_multiset::bucket_size", "std::unordered_multiset::cbegin", "std::unordered_multiset::cend", "std::unordered_multiset::clear", "std::unordered_multiset::count", "std::unordered_multiset::emplace", "std::unordered_multiset::emplace_hint", "std::unordered_multiset::empty", "std::unordered_multiset::end", "std::unordered_multiset::equal_range", "std::unordered_multiset::erase", "std::unordered_multiset::find", "std::unordered_multiset::get_allocator", "std::unordered_multiset::hash_function", "std::unordered_multiset::insert", "std::unordered_multiset::key_eq", "std::unordered_multiset::load_factor", "std::unordered_multiset::max_bucket_count", "std::unordered_multiset::max_load_factor", "std::unordered_multiset::max_size", "std::unordered_multiset::rehash", "std::unordered_multiset::size", "std::unordered_multiset::swap"] -ms.assetid: 70c8dfc5-492a-4af2-84f5-1aa9cb04b71c --- # unordered_multiset Class @@ -91,7 +90,7 @@ The allocator class. ## Remarks -The object orders the sequence it controls by calling two stored objects, a comparison function object of type [unordered_multiset::key_equal](#key_equal) and a hash function object of type [unordered_multiset::hasher](#hasher). You access the first stored object by calling the member function [unordered_multiset::key_eq](#key_eq)`()`; and you access the second stored object by calling the member function [unordered_multiset::hash_function](#hash)`()`. Specifically, for all values `X` and `Y` of type `Key`, the call `key_eq()(X, Y)` returns true only if the two argument values have equivalent ordering; the call `hash_function()(keyval)` yields a distribution of values of type `size_t`. Unlike class template [unordered_set Class](../standard-library/unordered-set-class.md), an object of type `unordered_multiset` does not ensure that `key_eq()(X, Y)` is always false for any two elements of the controlled sequence. (Keys need not be unique.) +The object orders the sequence it controls by calling two stored objects, a comparison function object of type [unordered_multiset::key_equal](#key_equal) and a hash function object of type [unordered_multiset::hasher](#hasher). You access the first stored object by calling the member function [unordered_multiset::key_eq](#key_eq)`()`; and you access the second stored object by calling the member function [unordered_multiset::hash_function](#hash)`()`. Specifically, for all values `X` and `Y` of type `Key`, the call `key_eq()(X, Y)` returns true only if the two argument values have equivalent ordering; the call `hash_function()(keyval)` yields a distribution of values of type `size_t`. Unlike class template [`unordered_set`](../standard-library/unordered-set-class.md), an object of type `unordered_multiset` does not ensure that `key_eq()(X, Y)` is always false for any two elements of the controlled sequence. (Keys need not be unique.) The object also stores a maximum load factor, which specifies the maximum desired average number of elements per bucket. If inserting an element causes [unordered_multiset::load_factor](#load_factor)`()` to exceed the maximum load factor, the container increases the number of buckets and rebuilds the hash table as needed. @@ -741,7 +740,7 @@ The element's key value to look for. ### Example ```cpp -// Requires /std:c++20 or /std:c++latest +// Requires /std:c++20 or later #include #include diff --git a/docs/standard-library/unordered-set-class.md b/docs/standard-library/unordered-set-class.md index ab90d089afb..be1541f0425 100644 --- a/docs/standard-library/unordered-set-class.md +++ b/docs/standard-library/unordered-set-class.md @@ -1,7 +1,7 @@ --- title: "unordered_set Class" description: "API reference for the C++ Standard Library container class `unordered_set`, which is used to store and retrieve data from an unordered collection." -ms.date: "9/9/2020" +ms.date: 9/9/2020 f1_keywords: ["unordered_set/std::unordered_set", "unordered_set/std::unordered_set::allocator_type", "unordered_set/std::unordered_set::const_iterator", "unordered_set/std::unordered_set::const_local_iterator", "unordered_set/std::unordered_set::const_pointer", "unordered_set/std::unordered_set::const_reference", "unordered_set/std::unordered_set::difference_type", "unordered_set/std::unordered_set::hasher", "unordered_set/std::unordered_set::iterator", "unordered_set/std::unordered_set::key_equal", "unordered_set/std::unordered_set::key_type", "unordered_set/std::unordered_set::local_iterator", "unordered_set/std::unordered_set::pointer", "unordered_set/std::unordered_set::reference", "unordered_set/std::unordered_set::size_type", "unordered_set/std::unordered_set::value_type", "unordered_set/std::unordered_set::begin", "unordered_set/std::unordered_set::bucket", "unordered_set/std::unordered_set::bucket_count", "unordered_set/std::unordered_set::bucket_size", "unordered_set/std::unordered_set::cbegin", "unordered_set/std::unordered_set::cend", "unordered_set/std::unordered_set::clear", "unordered_set/std::unordered_set::count", "unordered_set/std::unordered_set::contains", "unordered_set/std::unordered_set::emplace", "unordered_set/std::unordered_set::emplace_hint", "unordered_set/std::unordered_set::empty", "unordered_set/std::unordered_set::end", "unordered_set/std::unordered_set::equal_range", "unordered_set/std::unordered_set::erase", "unordered_set/std::unordered_set::find", "unordered_set/std::unordered_set::get_allocator", "unordered_set/std::unordered_set::hash", "unordered_set/std::unordered_set::insert", "unordered_set/std::unordered_set::key_eq", "unordered_set/std::unordered_set::load_factor", "unordered_set/std::unordered_set::max_bucket_count", "unordered_set/std::unordered_set::max_load_factor", "unordered_set/std::unordered_set::max_size", "unordered_set/std::unordered_set::rehash", "unordered_set/std::unordered_set::size", "unordered_set/std::unordered_set::swap", "unordered_set/std::unordered_set::unordered_set", "unordered_set/std::unordered_set::operator=", "unordered_set/std::unordered_set::hash_function"] helpviewer_keywords: ["std::unordered_set", "std::unordered_set::allocator_type", "std::unordered_set::const_iterator", "std::unordered_set::const_local_iterator", "std::unordered_set::const_pointer", "std::unordered_set::const_reference", "std::unordered_set::difference_type", "std::unordered_set::hasher", "std::unordered_set::iterator", "std::unordered_set::key_equal", "std::unordered_set::key_type", "std::unordered_set::local_iterator", "std::unordered_set::pointer", "std::unordered_set::reference", "std::unordered_set::size_type", "std::unordered_set::value_type", "std::unordered_set::begin", "std::unordered_set::bucket", "std::unordered_set::bucket_count", "std::unordered_set::bucket_size", "std::unordered_set::cbegin", "std::unordered_set::cend", "std::unordered_set::clear", "std::unordered_set::contains", "std::unordered_set::count", "std::unordered_set::emplace", "std::unordered_set::emplace_hint", "std::unordered_set::empty", "std::unordered_set::end", "std::unordered_set::equal_range", "std::unordered_set::erase", "std::unordered_set::find", "std::unordered_set::get_allocator", "std::unordered_set::hash", "std::unordered_set::insert", "std::unordered_set::key_eq", "std::unordered_set::load_factor", "std::unordered_set::max_bucket_count", "std::unordered_set::max_load_factor", "std::unordered_set::max_size", "std::unordered_set::rehash", "std::unordered_set::size", "std::unordered_set::swap", "std::unordered_set::unordered_set", "std::unordered_set::operator=", "std::unordered_set::allocator_type", "std::unordered_set::const_iterator", "std::unordered_set::const_local_iterator", "std::unordered_set::const_pointer", "std::unordered_set::const_reference", "std::unordered_set::difference_type", "std::unordered_set::hasher", "std::unordered_set::iterator", "std::unordered_set::key_equal", "std::unordered_set::key_type", "std::unordered_set::local_iterator", "std::unordered_set::pointer", "std::unordered_set::reference", "std::unordered_set::size_type", "std::unordered_set::value_type", "std::unordered_set::begin", "std::unordered_set::bucket", "std::unordered_set::bucket_count", "std::unordered_set::bucket_size", "std::unordered_set::cbegin", "std::unordered_set::cend", "std::unordered_set::clear", "std::unordered_set::count", "std::unordered_set::emplace", "std::unordered_set::emplace_hint", "std::unordered_set::empty", "std::unordered_set::end", "std::unordered_set::equal_range", "std::unordered_set::erase", "std::unordered_set::find", "std::unordered_set::get_allocator", "std::unordered_set::hash_function", "std::unordered_set::insert", "std::unordered_set::key_eq", "std::unordered_set::load_factor", "std::unordered_set::max_bucket_count", "std::unordered_set::max_load_factor", "std::unordered_set::max_size", "std::unordered_set::rehash", "std::unordered_set::size", "std::unordered_set::swap"] --- @@ -97,7 +97,7 @@ The allocator class. ## Remarks -The object orders the sequence it controls by calling two stored objects, a comparison function object of type [`unordered_set::key_equal`](#key_equal) and a hash function object of type [`unordered_set::hasher`](#hasher). You access the first stored object by calling the member function [`unordered_set::key_eq`](#key_eq)`()`; and you access the second stored object by calling the member function [`unordered_set::hash_function`](#hash)`()`. Specifically, for all values `X` and `Y` of type `Key`, the call `key_eq()(X, Y)` returns true only if the two argument values have equivalent ordering; the call `hash_function()(keyval)` yields a distribution of values of type `size_t`. Unlike class template [`unordered_multiset` Class](../standard-library/unordered-multiset-class.md), an object of type `unordered_set` ensures that `key_eq()(X, Y)` is always false for any two elements of the controlled sequence. (Keys are unique.) +The object orders the sequence it controls by calling two stored objects, a comparison function object of type [`unordered_set::key_equal`](#key_equal) and a hash function object of type [`unordered_set::hasher`](#hasher). You access the first stored object by calling the member function [`unordered_set::key_eq`](#key_eq)`()`; and you access the second stored object by calling the member function [`unordered_set::hash_function`](#hash)`()`. Specifically, for all values `X` and `Y` of type `Key`, the call `key_eq()(X, Y)` returns true only if the two argument values have equivalent ordering; the call `hash_function()(keyval)` yields a distribution of values of type `size_t`. Unlike class template [`unordered_multiset`](../standard-library/unordered-multiset-class.md), an object of type `unordered_set` ensures that `key_eq()(X, Y)` is always false for any two elements of the controlled sequence. (Keys are unique.) The object also stores a maximum load factor, which specifies the maximum desired average number of elements per bucket. If inserting an element causes [`unordered_set::load_factor`](#load_factor)`()` to exceed the maximum load factor, the container increases the number of buckets and rebuilds the hash table as needed. @@ -744,7 +744,7 @@ The element's key value to look for. ### Example ```cpp -// Requires /std:c++20 or /std:c++latest +// Requires /std:c++20 or later #include #include @@ -1089,7 +1089,7 @@ Key value to search for. ### Remarks -The member function returns a pair of iterators `X` such that`[X.first, X.second)` delimits just those elements of the controlled sequence that have equivalent ordering with *`keyval`*. If no such elements exist, both iterators are `end()`. +The member function returns a pair of iterators `X` such that `[X.first, X.second)` delimits just those elements of the controlled sequence that have equivalent ordering with *`keyval`*. If no such elements exist, both iterators are `end()`. ### Example @@ -2376,7 +2376,7 @@ The `initializer_list` containing the elements to copy. ### Remarks -The first constructor specifies a copy of the sequence controlled by *`Right`*. The second constructor specifies an empty controlled sequence. The third constructor specifies a copy of the sequence by moving *`Right`* The fourth through eighth constructors use an `initializer_list` to specify the elements to copy. The ninth constructor inserts the sequence of element values`[first, last)`. +The first constructor specifies a copy of the sequence controlled by *`Right`*. The second constructor specifies an empty controlled sequence. The third constructor specifies a copy of the sequence by moving *`Right`* The fourth through eighth constructors use an `initializer_list` to specify the elements to copy. The ninth constructor inserts the sequence of element values `[first, last)`. All constructors also initialize several stored values. For the copy constructor, the values are obtained from *`Right`*. Otherwise: diff --git a/docs/standard-library/unordered-set-operators.md b/docs/standard-library/unordered-set-operators.md index 1d57b37d00d..ee5bc48f7d7 100644 --- a/docs/standard-library/unordered-set-operators.md +++ b/docs/standard-library/unordered-set-operators.md @@ -1,15 +1,16 @@ --- -description: "Learn more about: operators" title: " operators" -ms.date: "11/04/2016" +description: "Learn more about: operators" +ms.date: 11/04/2016 f1_keywords: ["unordered_set/std::operator!=", "unordered_set/std::operator=="] -ms.assetid: 8653eea6-12f2-4dd7-aa2f-db38a71599a0 --- # `` operators -## operator!= +The `` header provides the following operators: + +## `operator!=` -Tests whether the [unordered_set](../standard-library/unordered-set-class.md) object on the left side of the operator is not equal to the unordered_set object on the right side. +Tests whether the [`unordered_set`](unordered-set-class.md) object on the left side of the operator is not equal to the `unordered_set` object on the right side. ```cpp bool operator!=(const unordered_set & left, const unordered_set & right); @@ -17,19 +18,19 @@ bool operator!=(const unordered_set & left, const un ### Parameters -*left*\ +*`left`*\ An object of type `unordered_set`. -*right*\ +*`right`*\ An object of type `unordered_set`. ### Return Value -**`true`** if the unordered_sets are not equal; **`false`** if they are equal. +**`true`** if the `unordered_set`s are not equal; **`false`** if they are equal. ### Remarks -The comparison between unordered_set objects is not affected by the arbitrary order in which they store their elements. Two unordered_sets are equal if they have the same number of elements and the elements in one container are a permutation of the elements in the other container. Otherwise, they are unequal. +The comparison between `unordered_set` objects is not affected by the arbitrary order in which they store their elements. Two `unordered_set`s are equal if they have the same number of elements and the elements in one container are a permutation of the elements in the other container. Otherwise, they are unequal. ### Example @@ -67,17 +68,15 @@ int main() } ``` -**Output:** - -`c1 != c2: true` - -`c1 != c3: false` - -`c2 != c3: true` +```Output +c1 != c2: true +c1 != c3: false +c2 != c3: true +``` -## operator== +## `operator==` -Tests whether the [unordered_set](../standard-library/unordered-set-class.md) object on the left side of the operator is equal to the unordered_set object on the right side. +Tests whether the [`unordered_set`](unordered-set-class.md) object on the left side of the operator is equal to the `unordered_set` object on the right side. ```cpp bool operator==(const unordered_set & left, const unordered_set & right); @@ -85,19 +84,19 @@ bool operator==(const unordered_set & left, const un ### Parameters -*left*\ +*`left`*\ An object of type `unordered_set`. -*right*\ +*`right`*\ An object of type `unordered_set`. ### Return Value -**`true`** if the unordered_sets are equal; **`false`** if they are not equal. +**`true`** if the `unordered_set`s are equal; **`false`** if they are not equal. ### Remarks -The comparison between unordered_set objects is not affected by the arbitrary order in which they store their elements. Two unordered_sets are equal if they have the same number of elements and the elements in one container are a permutation of the elements in the other container. Otherwise, they are unequal. +The comparison between `unordered_set` objects is not affected by the arbitrary order in which they store their elements. Two `unordered_set`s are equal if they have the same number of elements and the elements in one container are a permutation of the elements in the other container. Otherwise, they are unequal. ### Example @@ -141,9 +140,9 @@ c1 == c3: true c2 == c3: false ``` -## operator!= (multiset) +## `operator!=` (multiset) -Tests whether the [unordered_multiset](../standard-library/unordered-multiset-class.md) object on the left side of the operator is not equal to the unordered_multiset object on the right side. +Tests whether the [`unordered_multiset`](unordered-multiset-class.md) object on the left side of the operator is not equal to the `unordered_multiset` object on the right side. ```cpp bool operator!=(const unordered_multiset & left, const unordered_multiset & right); @@ -151,19 +150,19 @@ bool operator!=(const unordered_multiset & left, con ### Parameters -*left*\ +*`left`*\ An object of type `unordered_multiset`. -*right*\ +*`right`*\ An object of type `unordered_multiset`. ### Return Value -**`true`** if the unordered_multisets are not equal; **`false`** if they are equal. +**`true`** if the `unordered_multiset`s are not equal; **`false`** if they are equal. ### Remarks -The comparison between unordered_multiset objects is not affected by the arbitrary order in which they store their elements. Two unordered_multisets are equal if they have the same number of elements and the elements in one container are a permutation of the elements in the other container. Otherwise, they are unequal. +The comparison between `unordered_multiset` objects is not affected by the arbitrary order in which they store their elements. Two `unordered_multiset`s are equal if they have the same number of elements and the elements in one container are a permutation of the elements in the other container. Otherwise, they are unequal. ### Example @@ -210,9 +209,9 @@ c1 != c3: false c2 != c3: true ``` -## operator== (multiset) +## `operator==` (multiset) -Tests whether the [unordered_multiset](../standard-library/unordered-multiset-class.md) object on the left side of the operator is equal to the unordered_multiset object on the right side. +Tests whether the [`unordered_multiset`](unordered-multiset-class.md) object on the left side of the operator is equal to the `unordered_multiset` object on the right side. ```cpp bool operator==(const unordered_multiset & left, const unordered_multiset & right); @@ -220,19 +219,19 @@ bool operator==(const unordered_multiset & left, con ### Parameters -*left*\ +*`left`*\ An object of type `unordered_multiset`. -*right*\ +*`right`*\ An object of type `unordered_multiset`. ### Return Value -**`true`** if the unordered_multisets are equal; **`false`** if they are not equal. +**`true`** if the `unordered_multiset`s are equal; **`false`** if they are not equal. ### Remarks -The comparison between unordered_multiset objects is not affected by the arbitrary order in which they store their elements. Two unordered_multisets are equal if they have the same number of elements and the elements in one container are a permutation of the elements in the other container. Otherwise, they are unequal. +The comparison between `unordered_multiset` objects is not affected by the arbitrary order in which they store their elements. Two `unordered_multiset`s are equal if they have the same number of elements and the elements in one container are a permutation of the elements in the other container. Otherwise, they are unequal. ### Example diff --git a/docs/standard-library/utc-clock-class.md b/docs/standard-library/utc-clock-class.md index 285b3ce5096..1521bfbe8e1 100644 --- a/docs/standard-library/utc-clock-class.md +++ b/docs/standard-library/utc-clock-class.md @@ -1,6 +1,6 @@ --- -description: "Learn more about: utc_clock class" title: "utc_clock class" +description: "Learn more about: utc_clock class" ms.date: 07/27/2021 f1_keywords: ["chrono/std::chrono::utc_clock", "chrono/std::chrono::utc_clock::now", "chrono/std::chrono::utc_clock::to_sys", "chrono/std::chrono::utc_clock::from_sys", "chrono/std::chrono::utc_clock::is_steady Constant"] helpviewer_keywords: ["std::chrono [C++], utc_clock"] @@ -65,7 +65,7 @@ UTC time, by definition, starts out 10 seconds behind TAI (atomic time). 10 seco |Name|Description| |----------|-----------------| -|[`utc_clock::is_steady constant]`(#is_steady_constant)|Indicates whether the clock type is steady. Its value is `false`.| +|[`utc_clock::is_steady` constant](#is_steady_constant)|Indicates whether the clock type is steady. Its value is `false`.| ## Requirements diff --git a/docs/standard-library/utility.md b/docs/standard-library/utility.md index 266e9840994..c522bcbcd3f 100644 --- a/docs/standard-library/utility.md +++ b/docs/standard-library/utility.md @@ -1,6 +1,6 @@ --- -description: "Learn more about: " title: "" +description: "Learn more about: " ms.date: 11/14/2024 f1_keywords: [""] helpviewer_keywords: ["utility header"] @@ -61,7 +61,7 @@ Pairs are widely used in the C++ Standard Library. They're required both as the |[`operator!=`](../standard-library/utility-operators.md#op_neq)|Tests if the pair object on the left side of the operator isn't equal to the pair object on the right side.| |[`operator==`](../standard-library/utility-operators.md#op_eq_eq)|Tests if the pair object on the left side of the operator is equal to the pair object on the right side.| |[`operator<`](../standard-library/utility-operators.md#op_lt)|Tests if the pair object on the left side of the operator is less than the pair object on the right side.| -|[`operator<=`](../standard-library/utility-operators.md#op_gt_eq)|Tests if the pair object on the left side of the operator is less than or equal to the pair object on the right side.| +|[`operator<=`](../standard-library/utility-operators.md#op_lt_eq)|Tests if the pair object on the left side of the operator is less than or equal to the pair object on the right side.| |[`operator>`](../standard-library/utility-operators.md#op_gt)|Tests if the pair object on the left side of the operator is greater than the pair object on the right side.| |[`operator>=`](../standard-library/utility-operators.md#op_gt_eq)|Tests if the pair object on the left side of the operator is greater than or equal to the pair object on the right side.| diff --git a/docs/standard-library/valarray-class.md b/docs/standard-library/valarray-class.md index 1cc5c5087a9..e51df410949 100644 --- a/docs/standard-library/valarray-class.md +++ b/docs/standard-library/valarray-class.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: valarray Class" title: "valarray class" +description: "Learn more about: valarray Class" ms.date: 06/20/2022 f1_keywords: ["valarray/std::valarray", "valarray/std::valarray::value_type", "valarray/std::valarray::apply", "valarray/std::valarray::cshift", "valarray/std::valarray::free", "valarray/std::valarray::max", "valarray/std::valarray::min", "valarray/std::valarray::resize", "valarray/std::valarray::shift", "valarray/std::valarray::size", "valarray/std::valarray::sum", "valarray/std::valarray::swap"] helpviewer_keywords: ["std::valarray [C++]", "std::valarray [C++], value_type", "std::valarray [C++], apply", "std::valarray [C++], cshift", "std::valarray [C++], free", "std::valarray [C++], max", "std::valarray [C++], min", "std::valarray [C++], resize", "std::valarray [C++], shift", "std::valarray [C++], size", "std::valarray [C++], sum", "std::valarray [C++], swap"] -ms.assetid: 19b862f9-5d09-4003-8844-6ddd02c1a3a7 ms.custom: devdivchpfy22 --- @@ -1143,7 +1142,7 @@ int main( ) for ( i = 0 ; i < 10 ; i += 1 ) va [ i ] = i; for ( i = 0 ; i < 10 ; i+=1 ) - vaR [ i ] = 10 - i; + vaR [ i ] = 10 - i; cout << "The operand valarray va is:"; for ( i = 0 ; i < 10 ; i++ ) @@ -1609,7 +1608,7 @@ int main( ) for ( i = 0 ; i < 10 ; i += 1 ) va1 [ i ] = i; for ( i = 0 ; i < 10 ; i += 1 ) - va2 [ i ] = 10 - i; + va2 [ i ] = 10 - i; cout << "The operand valarray va1(10) is: ( "; for ( i = 0 ; i < 10 ; i++ ) diff --git a/docs/standard-library/value-compare-class.md b/docs/standard-library/value-compare-class.md index 9777faa45ae..18f66856546 100644 --- a/docs/standard-library/value-compare-class.md +++ b/docs/standard-library/value-compare-class.md @@ -1,20 +1,19 @@ --- -description: "Learn more about: value_compare Class" title: "value_compare Class" -ms.date: "11/04/2016" +description: "Learn more about: value_compare Class" +ms.date: 11/04/2016 f1_keywords: ["hash_map/std::value_compare"] helpviewer_keywords: ["value_compare class"] -ms.assetid: c306c5b9-3505-4357-aa6b-216451b951ed --- -# value_compare Class +# `value_compare` Class -Provides a function object that can compare the elements of a hash_map by comparing the values of their keys to determine their relative order in the hash_map. +Provides a function object that can compare the elements of a `hash_map` by comparing the values of their keys to determine their relative order in the `hash_map`. ## Syntax ```cpp class value_compare - : std::public binary_function + : public binary_function { public: bool operator()( @@ -32,22 +31,22 @@ protected: ## Remarks -The comparison criteria provided by value_compare between `value_types` of whole elements contained by a hash_map is induced from a comparison between the keys of the respective elements by the auxiliary class construction. The member function operator uses the object `comp` of type `key_compare` stored in the function object provided by value_compare to compare the sort-key components of two elements. +The comparison criteria provided by `value_compare` between `value_types` of whole elements contained by a `hash_map` is induced from a comparison between the keys of the respective elements by the auxiliary class construction. The member function operator uses the object `comp` of type `key_compare` stored in the function object provided by `value_compare` to compare the sort-key components of two elements. -For hash_sets and hash_multisets, which are simple containers where the key values are identical to the element values, value_compare is equivalent to `key_compare`; for hash_maps and hash_multimaps they are not, because the value of the type `pair` elements is not identical to the value of the element's key. +For `hash_set`s and `hash_multiset`s, which are simple containers where the key values are identical to the element values, `value_compare` is equivalent to `key_compare`; for `hash_map`s and `hash_multimap`s they are not, because the value of the type `pair` elements is not identical to the value of the element's key. ## Example -See the example for [hash_map::value_comp](../standard-library/hash-map-class.md#value_comp) for an example of how to declare and use value_compare. +See the example for [`hash_map::value_comp`](hash-map-class.md#value_comp) for an example of how to declare and use `value_compare`. ## Requirements -**Header:** \ +**Header:** `` -**Namespace:** stdext +**Namespace:** `stdext` ## See also -[binary_function Struct](../standard-library/binary-function-struct.md)\ -[Thread Safety in the C++ Standard Library](../standard-library/thread-safety-in-the-cpp-standard-library.md)\ -[C++ Standard Library Reference](../standard-library/cpp-standard-library-reference.md) +[`binary_function` Struct](binary-function-struct.md)\ +[Thread Safety in the C++ Standard Library](thread-safety-in-the-cpp-standard-library.md)\ +[C++ Standard Library Reference](cpp-standard-library-reference.md) diff --git a/docs/standard-library/variant.md b/docs/standard-library/variant.md index 9be7549e0ec..04f6018d139 100644 --- a/docs/standard-library/variant.md +++ b/docs/standard-library/variant.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: " title: "" -ms.date: "04/04/2019" +description: "Learn more about: " +ms.date: 04/04/2019 f1_keywords: [""] helpviewer_keywords: [""] --- @@ -11,9 +11,9 @@ A variant object holds and manages a value. If the variant holds a value, that v ## Requirements -**Header:** \ +**Header:** `` -**Namespace:** std +**Namespace:** `std` ## Members @@ -21,46 +21,46 @@ A variant object holds and manages a value. If the variant holds a value, that v |Name|Description| |-|-| -|[operator==](../standard-library/forward-list-operators.md#op_eq_eq)|Tests if the variant object on the left side of the operator is equal to the variant object on the right side.| -|[operator!=](../standard-library/forward-list-operators.md#op_neq)|Tests if the variant object on the left side of the operator is not equal to the variant object on the right side.| -|[operator<](../standard-library/forward-list-operators.md#op_lt)|Tests if the variant object on the left side of the operator is less than the variant object on the right side.| -|[operator<=](../standard-library/forward-list-operators.md#op_lt_eq)|Tests if the variant object on the left side of the operator is less than or equal to the variant object on the right side.| -|[operator>](../standard-library/forward-list-operators.md#op_gt)|Tests if the variant object on the left side of the operator is greater than the variant object on the right side.| -|[operator>=](../standard-library/forward-list-operators.md#op_lt_eq)|Tests if the variant object on the left side of the operator is greater than or equal to the variant object on the right side.| +|[`operator==`](variant-operators.md#op_eq_eq)|Tests if the variant object on the left side of the operator is equal to the variant object on the right side.| +|[`operator!=`](variant-operators.md#op_neq)|Tests if the variant object on the left side of the operator is not equal to the variant object on the right side.| +|[`operator<`](variant-operators.md#op_lt)|Tests if the variant object on the left side of the operator is less than the variant object on the right side.| +|[`operator<=`](variant-operators.md#op_lt_eq)|Tests if the variant object on the left side of the operator is less than or equal to the variant object on the right side.| +|[`operator>`](variant-operators.md#op_gt)|Tests if the variant object on the left side of the operator is greater than the variant object on the right side.| +|[`operator>=`](variant-operators.md#op_gt_eq)|Tests if the variant object on the left side of the operator is greater than or equal to the variant object on the right side.| ### Functions |Name|Description| |-|-| -|[get](../standard-library/variant-functions.md#get)|Gets the variant of an object.| -|[get_if](../standard-library/variant-functions.md#get_if)|Gets the variant of an object if it exists.| -|[holds_alternative](../standard-library/variant-functions.md#holds_alternative)|Return **`true`** if a variant exists.| -|[swap](../standard-library/variant-functions.md#swap)|Swaps a **variant**.| -|[visit](../standard-library/variant-functions.md#visit)|Moves to the next **variant**.| +|[`get`](variant-functions.md#get)|Gets the variant of an object.| +|[`get_if`](variant-functions.md#get_if)|Gets the variant of an object if it exists.| +|[`holds_alternative`](variant-functions.md#holds_alternative)|Return **`true`** if a variant exists.| +|[`swap`](variant-functions.md#swap)|Swaps a **variant**.| +|[`visit`](variant-functions.md#visit)|Moves to the next **variant**.| ### Classes |Name|Description| |-|-| -|[bad_variant_access](../standard-library/bad-variant-access-class.md)|Objects thrown to report invalid accesses to the value of a variant object.| -|[variant](../standard-library/variant.md)|An object to either hold a value of one of its alternative types, or no value.| +|[`bad_variant_access`](bad-variant-access-class.md)|Objects thrown to report invalid accesses to the value of a variant object.| +|[`variant`](variant-class.md)|An object to either hold a value of one of its alternative types, or no value.| ### Structs |Name|Description| |-|-| -|[hash](../standard-library/hash-structure.md)|| -|[monostate](../standard-library/monostate-structure.md)|An alternative type for a variant to make the variant type default constructible.| -|[uses_allocator](../standard-library/uses-allocator-structure.md)|| -|[variant_alternative](../standard-library/variant-alternative-structure.md)|Assists the variant objects.| -|[variant_size](../standard-library/variant-size-structure.md)|Assists the variant objects.| +|[`hash`](hash-structure.md)|| +|[`monostate`](monostate-structure.md)|An alternative type for a variant to make the variant type default constructible.| +|[`uses_allocator`](uses-allocator-structure.md)|| +|[`variant_alternative`](variant-alternative-structure.md)|Assists the variant objects.| +|[`variant_size`](variant-size-structure.md)|Assists the variant objects.| ### Objects |Name|Description| |-|-| -|[variant_npos](../standard-library/variant-functions.md#variant_npos)|| +|[`variant_npos`](variant-functions.md#variant_npos)|| ## See also -[Header Files Reference](../standard-library/cpp-standard-library-header-files.md) +[Header Files Reference](cpp-standard-library-header-files.md) diff --git a/docs/standard-library/vector-bool-class.md b/docs/standard-library/vector-bool-class.md index ddfd8b5a20e..8756473a9ef 100644 --- a/docs/standard-library/vector-bool-class.md +++ b/docs/standard-library/vector-bool-class.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: vector Class" title: "vector Class" -ms.date: "11/04/2016" +description: "Learn more about: vector Class" +ms.date: 11/04/2016 f1_keywords: ["vector", "vector/std::vector::flip"] helpviewer_keywords: ["std::vector [C++], const_pointer", "std::vector [C++], const_reference", "std::vector [C++], pointer", "std::vector [C++], flip", "std::vector [C++], swap"] --- @@ -350,7 +350,7 @@ The original value of the 3rd element still stored in a bool: false ## `vector::swap` -Static member function that exchanges two elements of Boolean vectors ( `vector`) by using the proxy class [`vector::reference`](#reference_class). +Static member function that exchanges two elements of Boolean vectors (`vector`) by using the proxy class [`vector::reference`](#reference_class). ```cpp static void swap( diff --git a/docs/standard-library/vector-class.md b/docs/standard-library/vector-class.md index 85cb05379ba..e715fe2ee42 100644 --- a/docs/standard-library/vector-class.md +++ b/docs/standard-library/vector-class.md @@ -13,13 +13,13 @@ The C++ Standard Library vector class is a class template for sequence container ```cpp template > -class vector +class vector; ``` ### Parameters *`Type`*\ -The element data type to be stored in the vector +The element data type to be stored in the vector. *`Allocator`*\ The type that represents the stored allocator object that encapsulates details about the vector's allocation and deallocation of memory. This argument is optional and the default value is `allocator`. @@ -46,7 +46,7 @@ The [`vector` reference class](../standard-library/vector-bool-class.md#re |Name|Description| |-|-| -|`[allocator_type]`(#allocator_type)|A type that represents the `allocator` class for the vector object.| +|[`allocator_type`](#allocator_type)|A type that represents the `allocator` class for the vector object.| |[`const_iterator`](#const_iterator)|A type that provides a random-access iterator that can read a **`const`** element in a vector.| |[`const_pointer`](#const_pointer)|A type that provides a pointer to a **`const`** element in a vector.| |[`const_reference`](#const_reference)|A type that provides a reference to a **`const`** element stored in a vector. It's used for reading and doing **`const`** operations.| @@ -152,7 +152,7 @@ First, `assign` erases any existing elements in a vector. Then, `assign` either ### Example ```cpp -/ vector_assign.cpp +// vector_assign.cpp // compile with: /EHsc #include #include @@ -169,33 +169,45 @@ int main() v1.push_back(50); cout << "v1 = "; - for (auto& v : v1){ + for (auto& v : v1) + { cout << v << " "; } cout << endl; v2.assign(v1.begin(), v1.end()); cout << "v2 = "; - for (auto& v : v2){ + for (auto& v : v2) + { cout << v << " "; } cout << endl; v3.assign(7, 4); cout << "v3 = "; - for (auto& v : v3){ + for (auto& v : v3) + { cout << v << " "; } cout << endl; v3.assign({ 5, 6, 7 }); - for (auto& v : v3){ + cout << "v3 = "; + for (auto& v : v3) + { cout << v << " "; } cout << endl; } ``` +```Output +v1 = 10 20 30 40 50 +v2 = 10 20 30 40 50 +v3 = 4 4 4 4 4 4 4 +v3 = 5 6 7 +``` + ## `at` Returns a reference to the element at a specified location in the vector. @@ -227,18 +239,18 @@ If the return value of `at` is assigned to a `const_reference`, the vector objec #include #include -int main( ) +int main() { - using namespace std; - vector v1; + using namespace std; + vector v1; - v1.push_back( 10 ); - v1.push_back( 20 ); + v1.push_back(10); + v1.push_back(20); - const int &i = v1.at( 0 ); - int &j = v1.at( 1 ); - cout << "The first element is " << i << endl; - cout << "The second element is " << j << endl; + const int &i = v1.at(0); + int &j = v1.at(1); + cout << "The first element is " << i << endl; + cout << "The second element is " << j << endl; } ``` @@ -275,22 +287,28 @@ When compiled by using [`_ITERATOR_DEBUG_LEVEL`](../standard-library/iterator-de #include #include -int main() { - using namespace std; - vector v1; +int main() +{ + using namespace std; + vector v1; - v1.push_back( 10 ); - v1.push_back( 11 ); + v1.push_back(10); + v1.push_back(11); - int& i = v1.back( ); - const int& ii = v1.front( ); + int& i = v1.back(); + const int& ii = v1.front(); - cout << "The last integer of v1 is " << i << endl; - i--; - cout << "The next-to-last integer of v1 is "<< ii << endl; + cout << "The last integer of v1 is " << i << endl; + i--; + cout << "The next-to-last integer of v1 is " << ii << endl; } ``` +```Output +The last integer of v1 is 11 +The next-to-last integer of v1 is 10 +``` + ## `begin` Returns a random-access iterator to the first element in the vector. @@ -378,18 +396,18 @@ The member function [`resize`](#resize) will be more efficient if sufficient mem #include #include -int main( ) +int main() { - using namespace std; - vector v1; + using namespace std; + vector v1; - v1.push_back( 1 ); - cout << "The length of storage allocated is " - << v1.capacity( ) << "." << endl; + v1.push_back(1); + cout << "The length of storage allocated is " + << v1.capacity() << "." << endl; - v1.push_back( 2 ); - cout << "The length of storage allocated is now " - << v1.capacity( ) << "." << endl; + v1.push_back(2); + cout << "The length of storage allocated is now " + << v1.capacity() << "." << endl; } ``` @@ -419,8 +437,8 @@ You can use this member function in place of the `begin()` member function to gu ```cpp auto i1 = Container.begin(); // i1 is Container::iterator -auto i2 = Container.cbegin(); +auto i2 = Container.cbegin(); // i2 is Container::const_iterator ``` @@ -445,8 +463,8 @@ You can use this member function in place of the `end()` member function to guar ```cpp auto i1 = Container.end(); // i1 is Container::iterator -auto i2 = Container.cend(); +auto i2 = Container.cend(); // i2 is Container::const_iterator ``` @@ -468,18 +486,18 @@ void clear(); #include #include -int main( ) +int main() { - using namespace std; - vector v1; + using namespace std; + vector v1; - v1.push_back( 10 ); - v1.push_back( 20 ); - v1.push_back( 30 ); + v1.push_back(10); + v1.push_back(20); + v1.push_back(30); - cout << "The size of v1 is " << v1.size( ) << endl; - v1.clear( ); - cout << "The size of v1 after clearing is " << v1.size( ) << endl; + cout << "The size of v1 is " << v1.size() << endl; + v1.clear(); + cout << "The size of v1 after clearing is " << v1.size() << endl; } ``` @@ -538,22 +556,22 @@ A type `const_reference` can't be used to modify the value of an element. #include #include -int main( ) +int main() { - using namespace std; - vector v1; + using namespace std; + vector v1; - v1.push_back( 10 ); - v1.push_back( 20 ); + v1.push_back(10); + v1.push_back(20); - const vector v2 = v1; - const int &i = v2.front( ); - const int &j = v2.back( ); - cout << "The first element is " << i << endl; - cout << "The second element is " << j << endl; + const vector v2 = v1; + const int& i = v2.front(); + const int& j = v2.back(); + cout << "The first element is " << i << endl; + cout << "The second element is " << j << endl; - // The following line would cause an error as v2 is const - // v2.push_back( 30 ); + // The following line would cause an error as v2 is const + // v2.push_back(30); } ``` @@ -602,22 +620,22 @@ With the return value of `crbegin`, the `vector` object can't be modified. #include #include -int main( ) +int main() { - using namespace std; - vector v1; - vector ::iterator v1_Iter; - vector ::const_reverse_iterator v1_rIter; + using namespace std; + vector v1; + vector::iterator v1_Iter; + vector::const_reverse_iterator v1_rIter; - v1.push_back( 1 ); - v1.push_back( 2 ); + v1.push_back(1); + v1.push_back(2); - v1_Iter = v1.begin( ); - cout << "The first element of vector is " + v1_Iter = v1.begin(); + cout << "The first element of vector is " << *v1_Iter << "." << endl; - v1_rIter = v1.crbegin( ); - cout << "The first element of the reversed vector is " + v1_rIter = v1.crbegin(); + cout << "The first element of the reversed vector is " << *v1_rIter << "." << endl; } ``` @@ -657,17 +675,17 @@ The value returned by `crend` shouldn't be dereferenced. Only use it for compari #include #include -int main( ) +int main() { - using namespace std; - vector v1; - vector ::const_reverse_iterator v1_rIter; + using namespace std; + vector v1; + vector::const_reverse_iterator v1_rIter; - v1.push_back( 1 ); - v1.push_back( 2 ); + v1.push_back(1); + v1.push_back(2); - for ( v1_rIter = v1.rbegin( ) ; v1_rIter != v1.rend( ) ; v1_rIter++ ) - cout << *v1_rIter << endl; + for (v1_rIter = v1.rbegin(); v1_rIter != v1.rend(); v1_rIter++) + cout << *v1_rIter << endl; } ``` @@ -755,31 +773,31 @@ An [iterator](#iterator) is more commonly used to access a vector element. #include #include -int main( ) +int main() { - using namespace std; + using namespace std; - vector c1; - vector ::iterator c1_Iter, c2_Iter; + vector c1; + vector::iterator c1_Iter, c2_Iter; - c1.push_back( 30 ); - c1.push_back( 20 ); - c1.push_back( 30 ); - c1.push_back( 10 ); - c1.push_back( 30 ); - c1.push_back( 20 ); + c1.push_back(30); + c1.push_back(20); + c1.push_back(30); + c1.push_back(10); + c1.push_back(30); + c1.push_back(20); - c1_Iter = c1.begin( ); - c2_Iter = c1.end( ); + c1_Iter = c1.begin(); + c2_Iter = c1.end(); - vector ::difference_type df_typ1, df_typ2, df_typ3; + vector::difference_type df_typ1, df_typ2, df_typ3; - df_typ1 = count( c1_Iter, c2_Iter, 10 ); - df_typ2 = count( c1_Iter, c2_Iter, 20 ); - df_typ3 = count( c1_Iter, c2_Iter, 30 ); - cout << "The number '10' is in c1 collection " << df_typ1 << " times.\n"; - cout << "The number '20' is in c1 collection " << df_typ2 << " times.\n"; - cout << "The number '30' is in c1 collection " << df_typ3 << " times.\n"; + df_typ1 = count(c1_Iter, c2_Iter, 10); + df_typ2 = count(c1_Iter, c2_Iter, 20); + df_typ3 = count(c1_Iter, c2_Iter, 30); + cout << "The number '10' is in c1 collection " << df_typ1 << " times.\n"; + cout << "The number '20' is in c1 collection " << df_typ2 << " times.\n"; + cout << "The number '30' is in c1 collection " << df_typ3 << " times.\n"; } ``` @@ -824,32 +842,32 @@ Any insertion operation can be expensive, see [`vector` class](../standard-libra #include #include -int main( ) +int main() { - using namespace std; - vector v1; - vector ::iterator Iter; - - v1.push_back( 10 ); - v1.push_back( 20 ); - v1.push_back( 30 ); - - cout << "v1 =" ; - for ( Iter = v1.begin( ) ; Iter != v1.end( ) ; Iter++ ) - cout << " " << *Iter; - cout << endl; - -// initialize a vector of vectors by moving v1 - vector < vector > vv1; - - vv1.emplace( vv1.begin(), move( v1 ) ); - if ( vv1.size( ) != 0 && vv1[0].size( ) != 0 ) - { - cout << "vv1[0] ="; - for (Iter = vv1[0].begin( ); Iter != vv1[0].end( ); Iter++ ) - cout << " " << *Iter; - cout << endl; - } + using namespace std; + vector v1; + vector::iterator Iter; + + v1.push_back(10); + v1.push_back(20); + v1.push_back(30); + + cout << "v1 ="; + for (Iter = v1.begin(); Iter != v1.end(); Iter++) + cout << " " << *Iter; + cout << endl; + + // initialize a vector of vectors by moving v1 + vector> vv1; + + vv1.emplace(vv1.begin(), move(v1)); + if (vv1.size() != 0 && vv1[0].size() != 0) + { + cout << "vv1[0] ="; + for (Iter = vv1[0].begin(); Iter != vv1[0].end(); Iter++) + cout << " " << *Iter; + cout << endl; + } } ``` @@ -876,15 +894,16 @@ Constructor arguments. The function infers which constructor overload to invoke ```cpp #include + struct obj { - obj(int, double) {} + obj(int, double) {} }; int main() { - std::vector v; - v.emplace_back(1, 3.14); // obj in created in place in the vector + std::vector v; + v.emplace_back(1, 3.14); // obj in created in place in the vector } ``` @@ -908,17 +927,17 @@ bool empty() const; #include #include -int main( ) +int main() { - using namespace std; - vector v1; + using namespace std; + vector v1; - v1.push_back( 10 ); + v1.push_back(10); - if ( v1.empty( ) ) - cout << "The vector is empty." << endl; - else - cout << "The vector is not empty." << endl; + if (v1.empty()) + cout << "The vector is empty." << endl; + else + cout << "The vector is not empty." << endl; } ``` @@ -951,17 +970,18 @@ If the return value of `end` is assigned to a variable of type `const_iterator`, // compile with: /EHsc #include #include -int main( ) + +int main() { - using namespace std; - vector v1; - vector ::iterator v1_Iter; + using namespace std; + vector v1; + vector::iterator v1_Iter; - v1.push_back( 1 ); - v1.push_back( 2 ); + v1.push_back(1); + v1.push_back(2); - for ( v1_Iter = v1.begin( ) ; v1_Iter != v1.end( ) ; v1_Iter++ ) - cout << *v1_Iter << endl; + for (v1_Iter = v1.begin(); v1_Iter != v1.end(); v1_Iter++) + cout << *v1_Iter << endl; } ``` @@ -1006,34 +1026,34 @@ An iterator that designates the first element remaining beyond any elements remo #include #include -int main( ) +int main() { - using namespace std; - vector v1; - vector ::iterator Iter; - - v1.push_back( 10 ); - v1.push_back( 20 ); - v1.push_back( 30 ); - v1.push_back( 40 ); - v1.push_back( 50 ); - - cout << "v1 =" ; - for ( Iter = v1.begin( ) ; Iter != v1.end( ) ; Iter++ ) - cout << " " << *Iter; - cout << endl; - - v1.erase( v1.begin( ) ); - cout << "v1 ="; - for ( Iter = v1.begin( ) ; Iter != v1.end( ) ; Iter++ ) - cout << " " << *Iter; - cout << endl; - - v1.erase( v1.begin( ) + 1, v1.begin( ) + 3 ); - cout << "v1 ="; - for ( Iter = v1.begin( ) ; Iter != v1.end( ) ; Iter++ ) - cout << " " << *Iter; - cout << endl; + using namespace std; + vector v1; + vector::iterator Iter; + + v1.push_back(10); + v1.push_back(20); + v1.push_back(30); + v1.push_back(40); + v1.push_back(50); + + cout << "v1 ="; + for (Iter = v1.begin(); Iter != v1.end(); Iter++) + cout << " " << *Iter; + cout << endl; + + v1.erase(v1.begin()); + cout << "v1 ="; + for (Iter = v1.begin(); Iter != v1.end(); Iter++) + cout << " " << *Iter; + cout << endl; + + v1.erase(v1.begin() + 1, v1.begin() + 3); + cout << "v1 ="; + for (Iter = v1.begin(); Iter != v1.end(); Iter++) + cout << " " << *Iter; + cout << endl; } ``` @@ -1071,24 +1091,28 @@ When compiled by using [`_ITERATOR_DEBUG_LEVEL`](../standard-library/iterator-de #include #include -int main( ) +int main() { - using namespace std; - vector v1; + using namespace std; + vector v1; - v1.push_back( 10 ); - v1.push_back( 11 ); + v1.push_back(10); + v1.push_back(11); - int& i = v1.front( ); - const int& ii = v1.front( ); + int& i = v1.front(); - cout << "The first integer of v1 is "<< i << endl; - // by incrementing i, we move the front reference to the second element - i++; - cout << "Now, the first integer of v1 is "<< i << endl; + cout << "The first integer of v1 is " << i << endl; + // by incrementing i, we move the front reference to the second element + i++; + cout << "Now, the first integer of v1 is " << i << endl; } ``` +```Output +The first integer of v1 is 10 +Now, the first integer of v1 is 11 +``` + ## `get_allocator` Returns a copy of the allocator object used to construct the vector. @@ -1111,20 +1135,19 @@ Allocators for the vector class specify how the class manages storage. The defau // vector_get_allocator.cpp // compile with: /EHsc #include -#include -int main( ) +int main() { - using namespace std; - // The following lines declare objects that use the default allocator. - vector v1; - vector > v2 = vector >(allocator( )) ; + using namespace std; + // The following lines declare objects that use the default allocator. + vector v1; + vector> v2 = vector>(allocator()); - // v3 will use the same allocator class as v1 - vector v3( v1.get_allocator( ) ); + // v3 will use the same allocator class as v1 + vector v3(v1.get_allocator()); - vector::allocator_type xvec = v3.get_allocator( ); - // You can now call functions on the allocator class used by vec + vector::allocator_type xvec = v3.get_allocator(); + // You can now call functions on the allocator class used by vec } ``` @@ -1186,51 +1209,51 @@ As a precondition, *`first`* and *`last`* must not be iterators into the vector, #include #include -int main( ) +int main() { - using namespace std; - vector v1; - vector ::iterator Iter; - - v1.push_back( 10 ); - v1.push_back( 20 ); - v1.push_back( 30 ); - - cout << "v1 =" ; - for ( Iter = v1.begin( ) ; Iter != v1.end( ) ; Iter++ ) - cout << " " << *Iter; - cout << endl; - - v1.insert( v1.begin( ) + 1, 40 ); - cout << "v1 ="; - for ( Iter = v1.begin( ) ; Iter != v1.end( ) ; Iter++ ) - cout << " " << *Iter; - cout << endl; - v1.insert( v1.begin( ) + 2, 4, 50 ); - - cout << "v1 ="; - for ( Iter = v1.begin( ) ; Iter != v1.end( ) ; Iter++ ) - cout << " " << *Iter; - cout << endl; - - const auto v2 = v1; - v1.insert( v1.begin( )+1, v2.begin( )+2, v2.begin( )+4 ); - cout << "v1 ="; - for (Iter = v1.begin( ); Iter != v1.end( ); Iter++ ) - cout << " " << *Iter; - cout << endl; - -// initialize a vector of vectors by moving v1 - vector < vector > vv1; - - vv1.insert( vv1.begin(), move( v1 ) ); - if ( vv1.size( ) != 0 && vv1[0].size( ) != 0 ) - { - cout << "vv1[0] ="; - for (Iter = vv1[0].begin( ); Iter != vv1[0].end( ); Iter++ ) - cout << " " << *Iter; - cout << endl; - } + using namespace std; + vector v1; + vector::iterator Iter; + + v1.push_back(10); + v1.push_back(20); + v1.push_back(30); + + cout << "v1 ="; + for (Iter = v1.begin(); Iter != v1.end(); Iter++) + cout << " " << *Iter; + cout << endl; + + v1.insert(v1.begin() + 1, 40); + cout << "v1 ="; + for (Iter = v1.begin(); Iter != v1.end(); Iter++) + cout << " " << *Iter; + cout << endl; + v1.insert(v1.begin() + 2, 4, 50); + + cout << "v1 ="; + for (Iter = v1.begin(); Iter != v1.end(); Iter++) + cout << " " << *Iter; + cout << endl; + + const auto v2 = v1; + v1.insert(v1.begin() + 1, v2.begin() + 2, v2.begin() + 4); + cout << "v1 ="; + for (Iter = v1.begin(); Iter != v1.end(); Iter++) + cout << " " << *Iter; + cout << endl; + + // initialize a vector of vectors by moving v1 + vector> vv1; + + vv1.insert(vv1.begin(), move(v1)); + if (vv1.size() != 0 && vv1[0].size() != 0) + { + cout << "vv1[0] ="; + for (Iter = vv1[0].begin(); Iter != vv1[0].end(); Iter++) + cout << " " << *Iter; + cout << endl; + } } ``` @@ -1278,17 +1301,21 @@ The maximum possible length of the vector. #include #include -int main( ) +int main() { - using namespace std; - vector v1; - vector ::size_type i; + using namespace std; + vector v1; + vector::size_type i; - i = v1.max_size( ); - cout << "The maximum possible length of the vector is " << i << "." << endl; + i = v1.max_size(); + cout << "The maximum possible length of the vector is " << i << "." << endl; } ``` +```Output +The maximum possible length of the vector is 4611686018427387903. +``` + ## `operator[]` Returns a reference to the vector element at a specified position. @@ -1322,19 +1349,23 @@ When compiled by using [`_ITERATOR_DEBUG_LEVEL`](../standard-library/iterator-de #include #include -int main( ) +int main() { - using namespace std; - vector v1; + using namespace std; + vector v1; - v1.push_back( 10 ); - v1.push_back( 20 ); + v1.push_back(10); + v1.push_back(20); - int& i = v1[1]; - cout << "The second integer of v1 is " << i << endl; + int& i = v1[1]; + cout << "The second integer of v1 is " << i << endl; } ``` +```Output +The second integer of v1 is 20 +``` + ## `operator=` Replaces the elements of the vector with a copy of another vector. @@ -1362,39 +1393,45 @@ After erasing any existing elements in a `vector`, `operator=` either copies or #include #include -int main( ) +int main() { - using namespace std; - vector v1, v2, v3; - vector::iterator iter; - - v1.push_back(10); - v1.push_back(20); - v1.push_back(30); - v1.push_back(40); - v1.push_back(50); - - cout << "v1 = " ; - for (iter = v1.begin(); iter != v1.end(); iter++) - cout << *iter << " "; - cout << endl; - - v2 = v1; - cout << "v2 = "; - for (iter = v2.begin(); iter != v2.end(); iter++) - cout << *iter << " "; - cout << endl; - -// move v1 into v2 - v2.clear(); - v2 = move(v1); - cout << "v2 = "; - for (iter = v2.begin(); iter != v2.end(); iter++) - cout << *iter << " "; - cout << endl; + using namespace std; + vector v1, v2, v3; + vector::iterator iter; + + v1.push_back(10); + v1.push_back(20); + v1.push_back(30); + v1.push_back(40); + v1.push_back(50); + + cout << "v1 = "; + for (iter = v1.begin(); iter != v1.end(); iter++) + cout << *iter << " "; + cout << endl; + + v2 = v1; + cout << "v2 = "; + for (iter = v2.begin(); iter != v2.end(); iter++) + cout << *iter << " "; + cout << endl; + + // move v1 into v2 + v2.clear(); + v2 = move(v1); + cout << "v2 = "; + for (iter = v2.begin(); iter != v2.end(); iter++) + cout << *iter << " "; + cout << endl; } ``` +```Output +v1 = 10 20 30 40 50 +v2 = 10 20 30 40 50 +v2 = 10 20 30 40 50 +``` + ## `pointer` A type that provides a pointer to an element in a vector. @@ -1415,12 +1452,12 @@ A type **`pointer`** can be used to modify the value of an element. #include #include -int main( ) +int main() { using namespace std; vector v; - v.push_back( 11 ); - v.push_back( 22 ); + v.push_back(11); + v.push_back(22); vector::pointer ptr = &v[0]; cout << *ptr << endl; @@ -1473,14 +1510,19 @@ The value to assign to the element added to the end of the vector. using namespace std; -template void print_elem(const T& t) { +template +void print_elem(const T& t) +{ cout << "(" << t << ") "; } -template void print_collection(const T& t) { +template +void print_collection(const T& t) +{ cout << " " << t.size() << " elements: "; - for (const auto& p : t) { + for (const auto& p : t) + { print_elem(p); } cout << endl; @@ -1489,7 +1531,8 @@ template void print_collection(const T& t) { int main() { vector v; - for (int i = 0; i < 10; ++i) { + for (int i = 0; i < 10; ++i) + { v.push_back(10 + i); } @@ -1497,13 +1540,31 @@ int main() print_collection(v); // pop_back() until it's empty, printing the last element as we go - while (v.begin() != v.end()) { - cout << "v.back(): "; print_elem(v.back()); cout << endl; + while (v.begin() != v.end()) + { + cout << "v.back(): "; + print_elem(v.back()); + cout << endl; v.pop_back(); } } ``` +```Output +vector data: + 10 elements: (10) (11) (12) (13) (14) (15) (16) (17) (18) (19) +v.back(): (19) +v.back(): (18) +v.back(): (17) +v.back(): (16) +v.back(): (15) +v.back(): (14) +v.back(): (13) +v.back(): (12) +v.back(): (11) +v.back(): (10) +``` + ## `rbegin` Returns an iterator to the first element in a reversed vector. @@ -1529,22 +1590,22 @@ If the return value of `rbegin` is assigned to a `const_reverse_iterator`, the v #include #include -int main( ) +int main() { - using namespace std; - vector v1; - vector ::iterator v1_Iter; - vector ::reverse_iterator v1_rIter; + using namespace std; + vector v1; + vector::iterator v1_Iter; + vector::reverse_iterator v1_rIter; - v1.push_back( 1 ); - v1.push_back( 2 ); + v1.push_back(1); + v1.push_back(2); - v1_Iter = v1.begin( ); - cout << "The first element of vector is " + v1_Iter = v1.begin(); + cout << "The first element of vector is " << *v1_Iter << "." << endl; - v1_rIter = v1.rbegin( ); - cout << "The first element of the reversed vector is " + v1_rIter = v1.rbegin(); + cout << "The first element of the reversed vector is " << *v1_rIter << "." << endl; } ``` @@ -1597,17 +1658,17 @@ The value returned by `rend` shouldn't be dereferenced. Only use it for comparis #include #include -int main( ) +int main() { - using namespace std; - vector v1; - vector ::reverse_iterator v1_rIter; + using namespace std; + vector v1; + vector::reverse_iterator v1_rIter; - v1.push_back( 1 ); - v1.push_back( 2 ); + v1.push_back(1); + v1.push_back(2); - for ( v1_rIter = v1.rbegin( ) ; v1_rIter != v1.rend( ) ; v1_rIter++ ) - cout << *v1_rIter << endl; + for (v1_rIter = v1.rbegin(); v1_rIter != v1.rend(); v1_rIter++) + cout << *v1_rIter << endl; } ``` @@ -1637,18 +1698,17 @@ The minimum length of storage to be allocated for the vector. #include #include -int main( ) +int main() { - using namespace std; - vector v1; - //vector ::iterator Iter; - - v1.push_back( 1 ); - cout << "Current capacity of v1 = " - << v1.capacity( ) << endl; - v1.reserve( 20 ); - cout << "Current capacity of v1 = " - << v1.capacity( ) << endl; + using namespace std; + vector v1; + + v1.push_back(1); + cout << "Current capacity of v1 = " + << v1.capacity() << endl; + v1.reserve(20); + cout << "Current capacity of v1 = " + << v1.capacity() << endl; } ``` @@ -1721,16 +1781,20 @@ If the container's size is less than the requested size, *`new_size`*, `resize` using namespace std; -template void print(const string& s, const C& c) { +template +void print(const string& s, const C& c) +{ cout << s; - for (const auto& e : c) { + for (const auto& e : c) + { cout << e << " "; } cout << endl; } -void printvstats(const vector& v) { +void printvstats(const vector& v) +{ cout << " the vector's size is: " << v.size() << endl; cout << " the vector's capacity is: " << v.capacity() << endl; cout << " the vector's maximum size is: " << v.max_size() << endl; @@ -1742,7 +1806,7 @@ int main() vector v; // Show statistics about vector. - cout << endl << "After declaring an empty vector:" << endl; + cout << "After declaring an empty vector:" << endl; printvstats(v); print(" the vector's contents: ", v); @@ -1752,7 +1816,8 @@ int main() printvstats(v); print(" the vector's contents: ", v); - for (int i = 1; i < 10; ++i) { + for (int i = 1; i < 10; ++i) + { v.push_back(i); } cout << endl << "After adding 10 elements:" << endl; @@ -1786,6 +1851,54 @@ int main() } ``` +```Output +After declaring an empty vector: + the vector's size is: 0 + the vector's capacity is: 0 + the vector's maximum size is: 4611686018427387903 + the vector's contents: + +After adding an element: + the vector's size is: 1 + the vector's capacity is: 1 + the vector's maximum size is: 4611686018427387903 + the vector's contents: -1 + +After adding 10 elements: + the vector's size is: 10 + the vector's capacity is: 13 + the vector's maximum size is: 4611686018427387903 + the vector's contents: -1 1 2 3 4 5 6 7 8 9 + +After resizing to 6 elements without an initialization value: + the vector's size is: 6 + the vector's capacity is: 13 + the vector's maximum size is: 4611686018427387903 + the vector's contents: -1 1 2 3 4 5 + +After resizing to 9 elements with an initialization value of 999: + the vector's size is: 9 + the vector's capacity is: 13 + the vector's maximum size is: 4611686018427387903 + the vector's contents: -1 1 2 3 4 5 999 999 999 + +After resizing to 12 elements without an initialization value: + the vector's size is: 12 + the vector's capacity is: 13 + the vector's maximum size is: 4611686018427387903 + the vector's contents: -1 1 2 3 4 5 999 999 999 0 0 0 + +After vector::reserve(1000): + the vector's size is: 12 + the vector's capacity is: 1000 + the vector's maximum size is: 4611686018427387903 + +After vector::resize(2000): + the vector's size is: 2000 + the vector's capacity is: 2000 + the vector's maximum size is: 4611686018427387903 +``` + ## `reverse_iterator` A type that provides a random-access iterator that can read or modify any element in a reversed vector. @@ -1818,21 +1931,20 @@ void shrink_to_fit(); #include #include -int main( ) +int main() { - using namespace std; - vector v1; - //vector ::iterator Iter; - - v1.push_back( 1 ); - cout << "Current capacity of v1 = " - << v1.capacity( ) << endl; - v1.reserve( 20 ); - cout << "Current capacity of v1 = " - << v1.capacity( ) << endl; - v1.shrink_to_fit(); - cout << "Current capacity of v1 = " - << v1.capacity( ) << endl; + using namespace std; + vector v1; + + v1.push_back(1); + cout << "Current capacity of v1 = " + << v1.capacity() << endl; + v1.reserve(20); + cout << "Current capacity of v1 = " + << v1.capacity() << endl; + v1.shrink_to_fit(); + cout << "Current capacity of v1 = " + << v1.capacity() << endl; } ``` @@ -1862,19 +1974,19 @@ The current length of the vector. #include #include -int main( ) +int main() { - using namespace std; - vector v1; - vector ::size_type i; + using namespace std; + vector v1; + vector::size_type i; - v1.push_back( 1 ); - i = v1.size( ); - cout << "Vector length is " << i << "." << endl; + v1.push_back(1); + i = v1.size(); + cout << "Vector length is " << i << "." << endl; - v1.push_back( 2 ); - i = v1.size( ); - cout << "Vector length is now " << i << "." << endl; + v1.push_back(2); + i = v1.size(); + cout << "Vector length is now " << i << "." << endl; } ``` @@ -1924,26 +2036,26 @@ A vector whose elements are to be exchanged with the elements in the vector *`ri #include #include -int main( ) +int main() { - using namespace std; - vector v1, v2; + using namespace std; + vector v1, v2; - v1.push_back( 1 ); - v1.push_back( 2 ); - v1.push_back( 3 ); + v1.push_back(1); + v1.push_back(2); + v1.push_back(3); - v2.push_back( 10 ); - v2.push_back( 20 ); + v2.push_back(10); + v2.push_back(20); - cout << "The number of elements in v1 = " << v1.size( ) << endl; - cout << "The number of elements in v2 = " << v2.size( ) << endl; - cout << endl; + cout << "The number of elements in v1 = " << v1.size() << endl; + cout << "The number of elements in v2 = " << v2.size() << endl; + cout << endl; - v1.swap( v2 ); + v1.swap(v2); - cout << "The number of elements in v1 = " << v1.size( ) << endl; - cout << "The number of elements in v2 = " << v2.size( ) << endl; + cout << "The number of elements in v1 = " << v1.size() << endl; + cout << "The number of elements in v2 = " << v2.size() << endl; } ``` @@ -1975,12 +2087,12 @@ typedef typename Allocator::value_type value_type; #include #include -int main( ) +int main() { - using namespace std; - vector::value_type AnInt; - AnInt = 44; - cout << AnInt << endl; + using namespace std; + vector::value_type AnInt; + AnInt = 44; + cout << AnInt << endl; } ``` @@ -2061,82 +2173,92 @@ The ninth and tenth constructors copy the range [`first`, `last`) of a vector. int main() { using namespace std; - vector ::iterator v1_Iter, v2_Iter, v3_Iter, v4_Iter, v5_Iter, v6_Iter; + vector::iterator v1_Iter, v2_Iter, v3_Iter, v4_Iter, v5_Iter, v6_Iter; // Create an empty vector v0 - vector v0; + vector v0; // Create a vector v1 with 3 elements of default value 0 - vector v1(3); + vector v1(3); // Create a vector v2 with 5 elements of value 2 - vector v2(5, 2); + vector v2(5, 2); // Create a vector v3 with 3 elements of value 1 and with the allocator // of vector v2 - vector v3(3, 1, v2.get_allocator()); + vector v3(3, 1, v2.get_allocator()); // Create a copy, vector v4, of vector v2 - vector v4(v2); + vector v4(v2); // Create a new temporary vector for demonstrating copying ranges - vector v5(5); - for (auto i : v5) { + vector v5(5); + for (auto i : v5) + { v5[i] = i; } // Create a vector v6 by copying the range v5[ first, last) - vector v6(v5.begin() + 1, v5.begin() + 3); + vector v6(v5.begin() + 1, v5.begin() + 3); cout << "v1 ="; - for (auto& v : v1){ + for (auto& v : v1) + { cout << " " << v; } cout << endl; cout << "v2 ="; - for (auto& v : v2){ + for (auto& v : v2) + { cout << " " << v; } cout << endl; cout << "v3 ="; - for (auto& v : v3){ + for (auto& v : v3) + { cout << " " << v; } cout << endl; + cout << "v4 ="; - for (auto& v : v4){ + for (auto& v : v4) + { cout << " " << v; } cout << endl; cout << "v5 ="; - for (auto& v : v5){ + for (auto& v : v5) + { cout << " " << v; } cout << endl; cout << "v6 ="; - for (auto& v : v6){ + for (auto& v : v6) + { cout << " " << v; } cout << endl; // Move vector v2 to vector v7 - vector v7(move(v2)); - vector ::iterator v7_Iter; + vector v7(move(v2)); + vector::iterator v7_Iter; cout << "v7 ="; - for (auto& v : v7){ + for (auto& v : v7) + { cout << " " << v; } cout << endl; cout << "v8 ="; vector v8{ { 1, 2, 3, 4 } }; - for (auto& v : v8){ - cout << " " << v ; + for (auto& v : v8) + { + cout << " " << v; } cout << endl; } diff --git a/docs/standard-library/vector.md b/docs/standard-library/vector.md index f9dd7af32e4..ab97e690485 100644 --- a/docs/standard-library/vector.md +++ b/docs/standard-library/vector.md @@ -1,7 +1,7 @@ --- -description: "Learn more about: " title: "" -ms.date: "11/04/2016" +description: "Learn more about: " +ms.date: 11/04/2016 f1_keywords: [""] helpviewer_keywords: ["vector header"] --- @@ -89,7 +89,7 @@ The second (right) vector in a compare operation. |-|-| |[`operator! =`](../standard-library/vector-operators.md#op_neq)|Tests if the `vector` object on the left side of the operator isn't equal to the `vector` object on the right side.| |[`operator<`](../standard-library/vector-operators.md#op_lt)|Tests if the `vector` object on the left side of the operator is less than the `vector` object on the right side.| -|[`operator<=`](../standard-library/vector-operators.md#op_gt_eq)|Tests if the `vector` object on the left side of the operator is less than or equal to the `vector` object on the right side.| +|[`operator<=`](../standard-library/vector-operators.md#op_lt_eq)|Tests if the `vector` object on the left side of the operator is less than or equal to the `vector` object on the right side.| |[`operator==`](../standard-library/vector-operators.md#op_eq_eq)|Tests if the `vector` object on the left side of the operator is equal to the `vector` object on the right side.| |[`operator>`](../standard-library/vector-operators.md#op_gt)|Tests if the `vector` object on the left side of the operator is greater than the `vector` object on the right side.| |[`operator>=`](../standard-library/vector-operators.md#op_gt_eq)|Tests if the `vector` object on the left side of the operator is greater than or equal to the `vector` object on the right side.| diff --git a/docs/standard-library/vectorized-stl-algorithms.md b/docs/standard-library/vectorized-stl-algorithms.md new file mode 100644 index 00000000000..13cad087a01 --- /dev/null +++ b/docs/standard-library/vectorized-stl-algorithms.md @@ -0,0 +1,81 @@ +--- +title: "Vectorized MSVC STL Algorithms" +description: "Learn more about: Vectorized STL Algorithms" +ms.date: 10/03/2025 +f1_keywords: ["_USE_STD_VECTOR_ALGORITHMS", "_USE_STD_VECTOR_FLOATING_ALGORITHMS"] +helpviewer_keywords: ["_USE_STD_VECTOR_ALGORITHMS", "_USE_STD_VECTOR_FLOATING_ALGORITHMS", "Vector Algorithms", "Vectorization", "SIMD"] +--- +# Vectorized MSVC STL Algorithms + +Under specific conditions, algorithms in the MSVC Standard Template Library (STL) can process multiple elements simultaneously on a single CPU core, rather than handling each element individually. This optimization uses single instruction, multiple data (SIMD) instructions provided by the CPU, a technique called vectorization. When this optimization isn't applied, the implementation is referred to as scalar. + +The conditions required for vectorization are: + - The container or range must be contiguous. Examples include `array`, `vector`, and `basic_string`. Types like `span` and `basic_string_view` provide contiguous ranges. Built-in arrays also form contiguous ranges. Containers like `list` and `map` aren't contiguous. + - The target platform must support the necessary SIMD instructions to implement the algorithm for the element types. This is typically true for arithmetic types and simple operations. + - One of these conditions must be met: + - The compiler can emit vectorized machine code for an implementation written as scalar code (auto-vectorization). + - The algorithm's implementation explicitly uses vectorized code (manual vectorization). + +## Auto-vectorization in the MSVC STL + +For more information about automatic vectorization, see [Auto-Vectorizer](../parallel/auto-parallelization-and-auto-vectorization.md#auto-vectorizer) and the discussion in that article about the [`/arch`](../build/reference/arch-minimum-cpu-architecture.md) switch. This applies to the STL implementation code the same way it applies to user code. + +Algorithms like `transform`, `reduce`, and `accumulate` benefit heavily from auto-vectorization. + +## Manual vectorization in the MSVC STL + +Certain algorithms for x64 and x86 include manual vectorization. This implementation is separately compiled and relies on runtime CPU dispatch, so it applies only to suitable CPUs. + +Manually vectorized algorithms use template metaprogramming to detect if the element type is suitable for vectorization. As a result, they're only vectorized for simple types such as standard integer types. + +Programs either benefit in performance from manual vectorization or remain unaffected by it. Disable manual vectorization by defining `_USE_STD_VECTOR_ALGORITHMS=0` in your project. Manually vectorized algorithms are enabled by default on x64 and x86 because `_USE_STD_VECTOR_ALGORITHMS` defaults to 1 on those platforms. + +Assign the same value to `_USE_STD_VECTOR_ALGORITHMS` for all linked translation units that use algorithms. Configure it in the project properties instead of in the source code for consistency. For more information about how to configure it, see [/D (Preprocessor Definitions)](../build/reference/d-preprocessor-definitions.md). + + +The `_USE_STD_VECTOR_ALGORITHMS` macro controls the behavior of these manually vectorized algorithms: + - `contains`, `contains_subrange` + - `find`, `find_last`, `find_end`, `find_first_of`, `adjacent_find` + - `count` + - `mismatch` + - `search`, `search_n` + - `swap_ranges` + - `replace` + - `remove`, `remove_copy` + - `unique`, `unique_copy` + - `reverse`, `reverse_copy` + - `rotate` + - `is_sorted`, `is_sorted_until` + - `lexicographical_compare`, `lexicographical_compare_three_way` + - `max`, `min`, `minmax` + - `max_element`, `min_element`, `minmax_element` + +The `_USE_STD_VECTOR_ALGORITHMS` macro also controls the manual vectorization of: + + - `basic_string` and `basic_string_view` members: + - `find` + - `rfind` + - `find_first_of`, `find_first_not_of` + - `find_last_of`, `find_last_not_of` + - `bitset` constructors from string and `bitset::to_string` + +## Manually vectorized algorithms for floating point types + +Vectorization of floating-point types involves specific considerations: + - Vectorization might reorder operations, which can affect the precision of floating-point results. + - Floating-point types might contain `NaN` values, which don't behave transitively in comparisons. + - Floating-point operations might raise exceptions. + +The STL addresses the first two considerations safely. Only `max_element`, `min_element`, `minmax_element`, `max`, `min`, `minmax`, `is_sorted`, and `is_sorted_until` are manually vectorized. These algorithms: +- Don’t compute new floating-point values. Instead, they compare existing values to ensure that differences in operation order don't impact precision. +- Because these are sorting algorithms, `NaN` values aren't allowed as inputs. + +Use `_USE_STD_VECTOR_FLOATING_ALGORITHMS` to control the use of these vectorized algorithms for floating-point types. Set it to 0 to disable vectorization. `_USE_STD_VECTOR_FLOATING_ALGORITHMS` doesn't affect anything if `_USE_STD_VECTOR_ALGORITHMS` is set to 0. + +The `_USE_STD_VECTOR_FLOATING_ALGORITHMS` macro defaults to 0 when [`/fp:except`](../build/reference/fp-specify-floating-point-behavior.md#except) is set. + +Assign the same value to `_USE_STD_VECTOR_FLOATING_ALGORITHMS` for all linked translation units that use algorithms. Configure it in the project properties instead of in the source code for consistency. For more information about how to configure it, see [/D (Preprocessor Definitions)](../build/reference/d-preprocessor-definitions.md). + +## See also + +[Auto-Vectorizer](../parallel/auto-parallelization-and-auto-vectorization.md#auto-vectorizer) diff --git a/docs/standard-library/view-classes.md b/docs/standard-library/view-classes.md index 2a37ddfa869..9d03ecae519 100644 --- a/docs/standard-library/view-classes.md +++ b/docs/standard-library/view-classes.md @@ -1,6 +1,6 @@ --- -description: "Learn more about the ranges view classes, which allow you to inexpensively transform ranges." title: "View classes" +description: "Learn more about the ranges view classes, which allow you to inexpensively transform ranges." ms.date: 12/20/2022 f1_keywords: ["RANGES/std::ranges::views", "RANGES/std::views"] helpviewer_keywords: ["RANGES/VIEWS/std", "VIEWS/std"] @@ -51,7 +51,7 @@ Using a view after the range that it's based on is modified can lead to undefine Because views are cheap to create, you should generally re-create a view if you modify the underlying range. The following example demonstrates how to store a view pipeline in a variable so that you can reuse it. ```cpp -// requires /std:c++20, or later +// requires /std:c++20 or later #include #include #include @@ -123,7 +123,7 @@ The following view classes are defined in the `std::ranges` namespace. | [`transform_view`](transform-view-class.md)C++20 | A view of an underlying sequence after a transformation function is applied to each element. | | [`values_view`](values-view-class.md)C++20 | A view over the second index into each tuple-like value in a collection. For example, given a range of `std::tuple` values, create a view that consists of the `int` elements from each tuple. | -Many of these classes have corresponding [range adaptors](range-adaptors.md) in the `std:views` namespace that creates instances of them. Prefer using an adaptor to create a view instead of creating view classes directly. The range adaptors are the intended way to create views, are easier to use, and in some cases are more efficient. +Many of these classes have corresponding [range adaptors](range-adaptors.md) in the `std::views` namespace that creates instances of them. Prefer using an adaptor to create a view instead of creating view classes directly. The range adaptors are the intended way to create views, are easier to use, and in some cases are more efficient. ## View classes characteristics diff --git a/docs/standard-library/view-interface.md b/docs/standard-library/view-interface.md index 67bf457cb5f..2b77da6fd37 100644 --- a/docs/standard-library/view-interface.md +++ b/docs/standard-library/view-interface.md @@ -1,9 +1,9 @@ --- -title: view_interface class (C++ Standard Library) +title: "view_interface class (C++ Standard Library)" description: "API reference for the Standard Template Library (STL) view_interface class, which is the base class for the ranges view classes." ms.date: 10/07/2022 f1_keywords: ["ranges/std::view_interface::back", "ranges/std::view_interface::data","ranges/std::view_interface::empty", "ranges/std::view_interface::front", "ranges/std::view_interface::size", "ranges/std::view_interface::operator[]", "ranges/std::view_interface::operator bool"] -helpviewer_keywords: ["std::ranges::view_interface [C++]", "std::ranges::view_interface [C++], back", "std::ranges::view_interface [C++], data", "std::ranges::view_interface [C++], empty", "std::ranges::view_interface [C++], front", "std::ranges::view_interface [C++], size", "std::ranges::view_interface [C++], operator[]", "std::ranges::view_interface [C++], operator bool"] +helpviewer_keywords: ["std::ranges::view_interface [C++]", "std::ranges::view_interface [C++], back", "std::ranges::view_interface [C++], data", "std::ranges::view_interface [C++], empty", "std::ranges::view_interface [C++], front", "std::ranges::view_interface [C++], size", "std::ranges::view_interface [C++], operator[]", "std::ranges::view_interface [C++], operator bool"] dev_langs: ["C++"] --- # `view_interface` class (C++ Standard Library) diff --git a/docs/standard-library/wbuffer-convert-class.md b/docs/standard-library/wbuffer-convert-class.md index b1f8f7691b4..060e7db84f9 100644 --- a/docs/standard-library/wbuffer-convert-class.md +++ b/docs/standard-library/wbuffer-convert-class.md @@ -20,7 +20,7 @@ class wbuffer_convert ### Parameters *`Codecvt`*\ -The [`locale`](../standard-library/locale-class.md) facet that represents the conversion object. +The [`locale`](locale-class.md) facet that represents the conversion object. *`Elem`*\ The wide-character element type. @@ -36,5 +36,5 @@ Conversion between a sequence of `Elem` values and multibyte sequences is perfor An object of this class template stores: -- A pointer to its underlying byte stream buffer.\ +- A pointer to its underlying byte stream buffer. - A pointer to an allocated conversion facet object, which is freed when the `wbuffer_convert` is destroyed. diff --git a/docs/standard-library/weekday-class.md b/docs/standard-library/weekday-class.md index dc7d9182789..8088e3b8b66 100644 --- a/docs/standard-library/weekday-class.md +++ b/docs/standard-library/weekday-class.md @@ -1,11 +1,11 @@ --- -description: "Learn more about: weekday Class" title: "weekday class" -ms.date: "6/25/2021" +description: "Learn more about: weekday Class" +ms.date: 6/25/2021 f1_keywords: ["chrono/std::chrono::weekday", "chrono/std::chrono::weekday::January", "chrono/std::chrono::weekday::February", "chrono/std::chrono::weekday::March","chrono/std::chrono::weekday::April","chrono/std::chrono::weekday::May","chrono/std::chrono::weekday::June","chrono/std::chrono::weekday::July","chrono/std::chrono::weekday::August","chrono/std::chrono::weekday::September","chrono/std::chrono::weekday::October","chrono/std::chrono::weekday::November","chrono/std::chrono::weekday::December","chrono/std::chrono::weekday::operator++", "chrono/std::chrono::weekday::operator--", "chrono/std::chrono::weekday::operator unsigned", "chrono/std::chrono::weekday::ok", "chrono/std::chrono::weekday::iso_encoding", "chrono/std::chrono::weekday::c_encoding"] helpviewer_keywords: ["std::chrono [C++], weekday"] --- -# `weekday` class +# `weekday` class Represents a day of the week in the [Gregorian calendar](https://en.wikipedia.org/wiki/Proleptic_Gregorian_calendar). For example, Tuesday. @@ -238,7 +238,7 @@ constexpr weekday& operator+=(const days& d) noexcept; ### Parameters -`*d*`\ +*`d`*\ The number of days to add. ### Return value @@ -255,7 +255,7 @@ constexpr weekday& operator-=(const days& d) noexcept; ### Parameters -`*d*`\ +*`d`*\ The number of days to subtract. ### Return value diff --git a/docs/standard-library/weekdayindexed-class.md b/docs/standard-library/weekdayindexed-class.md index 9a16b9c3f53..0bd80a89203 100644 --- a/docs/standard-library/weekdayindexed-class.md +++ b/docs/standard-library/weekdayindexed-class.md @@ -1,11 +1,11 @@ --- -description: "Learn more about: weekday_indexed Class" title: "weekday_indexed class" -ms.date: "06/25/2021" +description: "Learn more about: weekday_indexed Class" +ms.date: 06/25/2021 f1_keywords: ["chrono/std::chrono::weekday_indexed", "chrono/std::chrono::weekday_indexed::ok", "std::chrono::weekday_indexed::weekday", "std::chrono::weekday_indexed::ok"] helpviewer_keywords: ["std::chrono [C++], weekday_indexed"] --- -# `weekday_indexed` class +# `weekday_indexed` class Combines a weekday, representing a day of the week in the Gregorian calendar, with an index in the range [1, 5] that represents the weekday of the month (1st, 2nd, 3rd, and so on). diff --git a/docs/standard-library/weekdaylast-class.md b/docs/standard-library/weekdaylast-class.md index 477069cd668..ab0b3dff1e4 100644 --- a/docs/standard-library/weekdaylast-class.md +++ b/docs/standard-library/weekdaylast-class.md @@ -1,12 +1,12 @@ --- -description: "Learn more about: weekday_last Class" title: "weekday_last class" -ms.date: "06/28/2021" +description: "Learn more about: weekday_last Class" +ms.date: 06/28/2021 f1_keywords: ["chrono/std::chrono::weekday_last", "chrono/std::chrono::weekday_last::ok", "std::chrono::weekday_last::weekday", "chrono/std::chrono::weekday_last::ok", "chrono/std::chrono::weekday_last::weekday"] helpviewer_keywords: ["std::chrono [C++], weekday_last"] --- -# `weekday_last` class +# `weekday_last` class Represents the last weekday of a month. diff --git a/docs/standard-library/wstring-convert-class.md b/docs/standard-library/wstring-convert-class.md index 8b6789b1284..41c72fa8559 100644 --- a/docs/standard-library/wstring-convert-class.md +++ b/docs/standard-library/wstring-convert-class.md @@ -1,10 +1,9 @@ --- -description: "Learn more about: wstring_convert Class" title: "wstring_convert Class" -ms.date: "11/04/2016" +description: "Learn more about: wstring_convert Class" +ms.date: 11/04/2016 f1_keywords: ["wstring/stdext::cvt::wstring_convert", "locale/std::wstring_convert::byte_string", "locale/std::wstring_convert::wide_string", "locale/std::wstring_convert::state_type", "locale/std::wstring_convert::int_type", "locale/std::wstring_convert::from_bytes", "locale/std::wstring_convert::to_bytes", "locale/std::wstring_convert::converted", "locale/std::wstring_convert::state"] helpviewer_keywords: ["stdext::cvt [C++], wstring_convert", "std::wstring_convert [C++], byte_string", "std::wstring_convert [C++], wide_string", "std::wstring_convert [C++], state_type", "std::wstring_convert [C++], int_type", "std::wstring_convert [C++], from_bytes", "std::wstring_convert [C++], to_bytes", "std::wstring_convert [C++], converted", "std::wstring_convert [C++], state"] -ms.assetid: e34f5b65-d572-4bdc-ac69-20778712e376 --- # wstring_convert Class @@ -161,8 +160,6 @@ state_type state() const; The [conversion state](../standard-library/wstring-convert-class.md) object that represents the state of the conversion. -### Remarks - ## wstring_convert::state_type A type that represents the conversion state. diff --git a/docs/standard-library/year-class.md b/docs/standard-library/year-class.md index 7d3f7d181c9..4ada39cf99d 100644 --- a/docs/standard-library/year-class.md +++ b/docs/standard-library/year-class.md @@ -1,11 +1,11 @@ --- -description: "Learn more about: year Class" title: "year class" -ms.date: "06/28/2021" +description: "Learn more about: year Class" +ms.date: 06/28/2021 f1_keywords: ["chrono/std::chrono::year", "chrono/std::chrono::year::operator++", "chrono/std::chrono::year::operator--", "chrono/std::chrono::year::operator+=", "chrono/std::chrono::year::operator-=", "chrono/std::chrono::year::operator int", "chrono/std::chrono::year::is_leap", "chrono/std::chrono::year::max", "chrono/std::chrono::min", "chrono/std::chrono::year::ok"] helpviewer_keywords: ["std::chrono [C++], year"] --- -# `year` class +# `year` class Represents a year in the [Gregorian calendar](https://en.wikipedia.org/wiki/Proleptic_Gregorian_calendar). diff --git a/docs/standard-library/year-month-class.md b/docs/standard-library/year-month-class.md index 88e5800a280..e76df35fa2c 100644 --- a/docs/standard-library/year-month-class.md +++ b/docs/standard-library/year-month-class.md @@ -1,12 +1,12 @@ --- -description: "Learn more about: year_month class" title: "year_month class" -ms.date: "06/28/2021" +description: "Learn more about: year_month class" +ms.date: 06/28/2021 f1_keywords: ["chrono/std::chrono::year_month", "chrono/std::chrono::year_month::operator+=", "chrono/std::chrono::year_month::operator-=", "chrono/std::chrono::year_month::ok"] helpviewer_keywords: ["std::chrono [C++], year_month"] dev_langs: ["C++"] --- -# `year_month` class +# `year_month` class Represents a month and year. The day isn't specified. diff --git a/docs/standard-library/year-month-day-class.md b/docs/standard-library/year-month-day-class.md index e153349e082..3f40644e579 100644 --- a/docs/standard-library/year-month-day-class.md +++ b/docs/standard-library/year-month-day-class.md @@ -1,12 +1,12 @@ --- title: "year_month_day class" description: "Learn more about: year_month_day class" -ms.date: "06/28/2021" +ms.date: 06/28/2021 f1_keywords: ["chrono/std::chrono::year_month_day", "chrono/std::chrono::year::operator+=", "chrono/std::chrono::year::operator-=", "chrono/std::chrono::year::sysdays", "chrono/std::chrono::year::localdays", "chrono/std::chrono::year::ok"] helpviewer_keywords: ["std::chrono [C++], year_month_day"] --- -# `year_month_day` class +# `year_month_day` class Represents a month, year, and day. diff --git a/docs/standard-library/year-month-day-last-class.md b/docs/standard-library/year-month-day-last-class.md index 2427f36c402..b3bfc146db2 100644 --- a/docs/standard-library/year-month-day-last-class.md +++ b/docs/standard-library/year-month-day-last-class.md @@ -1,12 +1,12 @@ --- -description: "Learn more about: year_month_day_last class" title: "year_month_day_last class" -ms.date: "06/28/2021" +description: "Learn more about: year_month_day_last class" +ms.date: 06/28/2021 f1_keywords: ["chrono/std::chrono::year_month_day_last", "chrono/std::chrono::year_month_day_last::operator+=", "chrono/std::chrono::year_month_day_last::operator-=", "chrono/std::chrono::year_month_day_last::sysdays", "chrono/std::chrono::year_month_day_last::local_days", "chrono/std::chrono::year_month_day_last::day", "chrono/std::chrono::year_month_day_last::year", "chrono/std::chrono::year_month_day_last::ok"] helpviewer_keywords: ["std::chrono [C++], year_month_day_last"] dev_langs: ["C++"] --- -# `year_month_day_last` class +# `year_month_day_last` class Represents the last day of a specific year and month. diff --git a/docs/standard-library/year-month-weekday-class.md b/docs/standard-library/year-month-weekday-class.md index f88f88c341c..cb63a01c324 100644 --- a/docs/standard-library/year-month-weekday-class.md +++ b/docs/standard-library/year-month-weekday-class.md @@ -1,13 +1,13 @@ --- -description: "Learn more about: year_month_weekday class" title: "year_month_weekday class" -ms.date: "06/30/2021" +description: "Learn more about: year_month_weekday class" +ms.date: 06/30/2021 f1_keywords: ["chrono/std::chrono::year_month_weekday", "chrono/std::chrono::year_month_weekday::weekday", "chrono/std::chrono::year_month_weekday::month", "chrono/std::chrono::year_month_weekday::index", "chrono/std::chrono::year_month_weekday::year", "chrono/std::chrono::year_month_weekday::weekday", "chrono/std::chrono::year_month_weekday::weekday_indexed", "chrono/std::chrono::year_month_weekday::sys_days", "chrono/std::chrono::year_month_weekday::local_days", "chrono/std::chrono::year_month_weekday::ok", "chrono/std::chrono::year_month_weekday::operator+=", "chrono/std::chrono::year_month_weekday::operator-=", "chrono/std::chrono::year_month_weekday::operator local_days", "chrono/std::chrono::year_month_weekday::operator sys_days"] helpviewer_keywords: ["std::chrono [C++], year_month_weekday"] dev_langs: ["C++"] --- -# `year_month_weekday` class +# `year_month_weekday` class Represents a specific year, month, and nth weekday of the month. @@ -36,7 +36,7 @@ class year_month_weekday; // C++20 | [`operator local_days`](#local_days) | Get the count of days from the `system_clock` epoch to this `year_month_weekday` as [`local_days`](chrono.md#typedefs). | | [`operator sys_days`](#sys_days) | Get the count of days from the `system_clock` epoch to this `year_month_weekday` as [`sys_days`](chrono.md#typedefs). | | [`weekday`](#weekday) | Get the weekday. | -| [`weekday_indexed`](#weekday_indexed) | Get the [`weekday_indexed`] stored in this `year_month_weekday`. | +| [`weekday_indexed`](#weekday_indexed) | Get the [`weekday_indexed`](weekdayindexed-class.md) stored in this `year_month_weekday`. | | [`year`](#year) | Get the year. | ## Non-members @@ -325,5 +325,5 @@ The [`year`](year-class.md) value. [`year_month_day`](year-month-day-class.md)\ [`year_month_day_last`](year-month-day-last-class.md)\ [`year_month_weekday_last`](year-month-weekday-last-class.md)\ -[`operator/`](chrono-operators.md#op_/) -[Header Files Reference](cpp-standard-library-header-files.md) \ No newline at end of file +[`operator/`](chrono-operators.md#op_/)\ +[Header Files Reference](cpp-standard-library-header-files.md) diff --git a/docs/standard-library/year-month-weekday-last-class.md b/docs/standard-library/year-month-weekday-last-class.md index 8cac30f7d47..d7a2a3aba2d 100644 --- a/docs/standard-library/year-month-weekday-last-class.md +++ b/docs/standard-library/year-month-weekday-last-class.md @@ -1,13 +1,13 @@ --- -description: "Learn more about: year_month_weekday_last class" title: "year_month_weekday_last class" -ms.date: "06/30/2021" +description: "Learn more about: year_month_weekday_last class" +ms.date: 06/30/2021 f1_keywords: ["chrono/std::chrono::year_month_weekday_last", "chrono/std::chrono::year_month_weekday_last::month", "chrono/std::chrono::year_month_weekday_last::year", "chrono/std::chrono::year_month_weekday_last::weekday", "chrono/std::chrono::year_month_weekday_last::weekday_last", "chrono/std::chrono::year_month_weekday_last::sys_days", "chrono/std::chrono::year_month_weekday_last::local_days", "chrono/std::chrono::year_month_weekday_last::ok", "chrono/std::chrono::year_month_weekday_last::operator+=", "chrono/std::chrono::year_month_weekday_last::operator-=", "chrono/std::chrono::year_month_weekday_last::operator local_days", "chrono/std::chrono::year_month_weekday_last::operator sys_days"] helpviewer_keywords: ["std::chrono [C++], year_month_weekday_last"] dev_langs: ["C++"] --- -# `year_month_weekday_last` class +# `year_month_weekday_last` class A specific year, month, and last weekday of the month. diff --git a/docs/standard-library/zoned-time-class.md b/docs/standard-library/zoned-time-class.md index 976cc7416cf..c5b82df46cf 100644 --- a/docs/standard-library/zoned-time-class.md +++ b/docs/standard-library/zoned-time-class.md @@ -1,8 +1,8 @@ --- -description: "Learn more about: zoned_time class" title: "zoned_time class" +description: "Learn more about: zoned_time class" ms.date: 05/31/2022 -f1_keywords: ["chrono/std::chrono::zoned_time::get_info", "chrono/std::chrono::zoned_time::get_local_time", "chrono/std::chrono::zoned_time::get_sys_time", "chrono/std::chrono::zoned_time::get_time_zone","chrono/std::chrono::zoned_time:operator=", "chrono/std::chrono::zoned_time:operator local_time", "chrono/std::chrono::zoned_time:operator sys_time"] +f1_keywords: ["chrono/std::chrono::zoned_time::get_info", "chrono/std::chrono::zoned_time::get_local_time", "chrono/std::chrono::zoned_time::get_sys_time", "chrono/std::chrono::zoned_time::get_time_zone","chrono/std::chrono::zoned_time::operator=", "chrono/std::chrono::zoned_time::operator local_time", "chrono/std::chrono::zoned_time::operator sys_time"] helpviewer_keywords: ["std::chrono [C++], zoned_time class", "std::chrono::zoned_time::get_info function", "std::chrono::zoned_time::get_local_time function", "std::chrono::zoned_time::get_sys_time function", "std::chrono::zoned_time::get_time_zone function"] dev_langs: ["C++"] --- @@ -33,7 +33,7 @@ A `zoned_time` always refers to a valid time zone and represents a point in time |[`get_time_zone`](#get_time_zone) | Gets the [time_zone](time-zone-class.md) stored in this `zoned_time`. | |[`operator=`](#op_=)| Assign the value of another `zoned_time`, or another `zoned_time`'s `local_time` or `sys_time`, to this `zoned_time`.| |[`operator local_time`](#op_local_time)| Combines the `zoned_time`'s time zone with the stored time point to produce the local time in that time zone.| -|[`operator sys_time`](#op_local_time)| Gets the time stored in this `zoned_time` without applying the time zone. | +|[`operator sys_time`](#op_sys_time)| Gets the time stored in this `zoned_time` without applying the time zone. | ## Non-members @@ -345,7 +345,7 @@ int main() 1\) The default copy assignment operator. Copies (doesn't move) the stored [`time_point`](time-point-class.md) and [time_zone](time-zone-class.md) pointer from the other `zoned_time` into this `zoned_time`. 2\) Assigns `st` to the [`time_point`](time-point-class.md) in this `zoned_time`. After the assignment, `*this->get_sys_time() == st;` -3\) Converts `lt` (a `local_time`) to a `sys_time`. It does this essentially as `timeZone->to_sys(lt)`, and assigns the result to the [`time_point`] in this `zoned_time`. After the assignment, `*this->get_local_time() == lt;` +3\) Converts `lt` (a `local_time`) to a `sys_time`. It does this essentially as `timeZone->to_sys(lt)`, and assigns the result to the [`time_point`](time-point-class.md) in this `zoned_time`. After the assignment, `*this->get_local_time() == lt;` ## `operator local_time` @@ -423,4 +423,4 @@ int main() [`time_point`](time-point-class.md)\ [`time_zone`](time-zone-class.md)\ [`zoned_traits` struct](zoned-traits-struct.md)\ -[Header files reference](./cpp-standard-library-header-files.md) \ No newline at end of file +[Header files reference](./cpp-standard-library-header-files.md) diff --git a/docs/text/buffer-overflow.md b/docs/text/buffer-overflow.md index 6d7dad95dc2..3107fc90eac 100644 --- a/docs/text/buffer-overflow.md +++ b/docs/text/buffer-overflow.md @@ -4,6 +4,7 @@ title: "Buffer Overflow" ms.date: "11/04/2016" helpviewer_keywords: ["buffers [C++], character sizes", "buffer overflows [C++]", "MBCS [C++], buffer overflow"] ms.assetid: f2b7e40a-f02b-46d8-a449-51d26fc0c663 +ms.topic: how-to --- # Buffer Overflow diff --git a/docs/text/character-assignment.md b/docs/text/character-assignment.md index 0f4e4e7a831..81eaad306a9 100644 --- a/docs/text/character-assignment.md +++ b/docs/text/character-assignment.md @@ -4,6 +4,7 @@ title: "Character Assignment" ms.date: "11/04/2016" helpviewer_keywords: ["characters [C++], assignments", "MBCS [C++], character assignments"] ms.assetid: dcc329cd-92df-4e20-817d-364be62ff28f +ms.topic: how-to --- # Character Assignment diff --git a/docs/text/character-comparison.md b/docs/text/character-comparison.md index e7b4890efaf..b03f26e4cc6 100644 --- a/docs/text/character-comparison.md +++ b/docs/text/character-comparison.md @@ -4,6 +4,7 @@ title: "Character Comparison" ms.date: "11/04/2016" helpviewer_keywords: ["comparing characters", "MBCS [C++], character comparison", "characters [C++], comparing"] ms.assetid: 18846e44-3e6e-40c4-9b42-3153fb15db20 +ms.topic: how-to --- # Character Comparison diff --git a/docs/text/incrementing-and-decrementing-pointers.md b/docs/text/incrementing-and-decrementing-pointers.md index 932ef317088..9958d4e81ab 100644 --- a/docs/text/incrementing-and-decrementing-pointers.md +++ b/docs/text/incrementing-and-decrementing-pointers.md @@ -4,6 +4,7 @@ title: "Incrementing and Decrementing Pointers" ms.date: "11/04/2016" helpviewer_keywords: ["incrementing pointers", "MBCS [C++], pointers", "pointers [C++], multibyte characters", "decrementing pointers"] ms.assetid: 0872b4a0-e2bd-4004-8319-070efb76f2fd +ms.topic: concept-article --- # Incrementing and Decrementing Pointers diff --git a/docs/text/last-character-in-a-string.md b/docs/text/last-character-in-a-string.md index bb58c45d55b..f0cb71ec368 100644 --- a/docs/text/last-character-in-a-string.md +++ b/docs/text/last-character-in-a-string.md @@ -4,6 +4,7 @@ title: "Last Character in a String" ms.date: "11/04/2016" helpviewer_keywords: ["last character in string", "MBCS [C++], last character in string"] ms.assetid: 0a180376-4e55-41e8-9c64-539c7b6d8047 +ms.topic: how-to --- # Last Character in a String diff --git a/docs/text/string-and-i-o-formatting-modern-cpp.md b/docs/text/string-and-i-o-formatting-modern-cpp.md index 1b44ad8e4c8..a122fef058f 100644 --- a/docs/text/string-and-i-o-formatting-modern-cpp.md +++ b/docs/text/string-and-i-o-formatting-modern-cpp.md @@ -2,7 +2,7 @@ title: "String and I/O Formatting (Modern C++)" description: "Choices for formatted string I/O available in modern C++." ms.date: "05/30/2019" -ms.topic: "conceptual" +ms.topic: "concept-article" ms.assetid: 3954e8de-a59b-4175-89c9-4ee842ab89ed --- # String and I/O Formatting (Modern C++) diff --git a/docs/text/text-and-strings-in-visual-cpp.md b/docs/text/text-and-strings-in-visual-cpp.md index f7802b98794..2334f6557ec 100644 --- a/docs/text/text-and-strings-in-visual-cpp.md +++ b/docs/text/text-and-strings-in-visual-cpp.md @@ -1,13 +1,12 @@ --- -description: "Learn more about: Text and Strings in Visual C++" title: "Text and Strings in Visual C++" -ms.date: "11/04/2016" +description: "Learn more about: Text and Strings in Visual C++" +ms.date: 11/04/2016 helpviewer_keywords: ["globalization [C++], character sets", "programming [C++], international", "multiple language support [C++]", "Unicode [C++]", "international applications [C++], about international applications", "portability [C++]", "translation [C++], character sets", "non-European characters [C++]", "character sets [C++]", "globalization [C++]", "Japanese characters [C++]", "Kanji character support [C++]", "local character sets [C++]", "ASCII characters [C++]", "character sets [C++], about character sets", "localization [C++], character sets", "translating code [C++]", "localization [C++]", "character sets [C++], non-European", "portability [C++], character sets", "MBCS [C++], international programming"] -ms.assetid: a1bb27ac-abe5-4c6b-867d-f761d4b93205 --- # Text and Strings in Visual C++ -An important aspect of developing applications for international markets is the adequate representation of local character sets. The ASCII character set defines characters in the range 0x00 to 0x7F. There are other character sets, primarily European, that define the characters within the range 0x00 to 0x7F identically to the ASCII character set and also define an extended character set from 0x80 to 0xFF. Thus, an 8-bit, single-byte-character set (SBCS) is sufficient to represent the ASCII character set, as well as the character sets for many European languages. However, some non-European character sets, such as Japanese Kanji, include many more characters than a single-byte coding scheme can represent, and therefore require multibyte-character set (MBCS) encoding. +An important aspect of developing applications for international markets is the adequate representation of local character sets. The ASCII character set defines characters in the range 0x00 - 0x7F. There are other character sets, primarily European, that define the characters within the range 0x00 - 0x7F identically to the ASCII character set and also define an extended character set from 0x80 - 0xFF. Thus, an 8-bit, single-byte-character set (SBCS) is sufficient to represent the ASCII character set and the character sets for many European languages. However, some non-European character sets, such as Japanese Kanji, include many more characters than a single-byte coding scheme can represent, and therefore require multibyte-character set (MBCS) encoding. ## In This Section diff --git a/docs/text/using-tchar-h-data-types-with-mbcs-code.md b/docs/text/using-tchar-h-data-types-with-mbcs-code.md index d9d216041f9..c800f793487 100644 --- a/docs/text/using-tchar-h-data-types-with-mbcs-code.md +++ b/docs/text/using-tchar-h-data-types-with-mbcs-code.md @@ -4,6 +4,7 @@ title: "Using TCHAR.H Data Types with _MBCS Code" ms.date: "11/04/2016" helpviewer_keywords: ["mapping generic-text", "generic-text data types [C++]", "generic-text mappings [C++]", "MBCS [C++], generic-text mappings", "TCHAR.H data types, mapping", "mappings [C++], TCHAR.H"] ms.assetid: 298583c5-22c3-40f6-920e-9ec96d42abd8 +ms.topic: concept-article --- # Using TCHAR.H Data Types with _MBCS Code diff --git a/docs/windows/adding-editing-or-deleting-controls.md b/docs/windows/adding-editing-or-deleting-controls.md index e068e19ef64..11e5400f7d9 100644 --- a/docs/windows/adding-editing-or-deleting-controls.md +++ b/docs/windows/adding-editing-or-deleting-controls.md @@ -1,10 +1,10 @@ --- -description: "Learn more about: How To: Add, Edit, or Delete Controls (C++)" title: "How To: Add, Edit, or Delete Controls (C++)" +description: "Learn more about: How To: Add, Edit, or Delete Controls (C++)" ms.date: "02/15/2019" f1_keywords: ["vc.controls.activex", "vc.editors.dialog.insertActiveXControls"] helpviewer_keywords: ["Dialog Editor [C++], creating controls", "dialog boxes [C++], adding controls to", "Toolbox [C++], Dialog Editor tab", "controls [C++], types", "syslink controls in dialog boxes", "custom controls [C++], dialog boxes", "controls [C++], standard", "Dialog Editor [C++], creating controls", "controls [C++], adding to dialog boxes", "controls [C++], adding multiple", "dialog box controls [C++], size", "controls [C++], sizing", "dialog boxes [C++], adding ActiveX controls", "ActiveX controls [C++], adding to dialog boxes", "Insert ActiveX Control dialog box [C++]", "controls [C++], editing properties", "ActiveX controls [C++], properties", "controls [C++], undoing changes", "controls [C++], editing properties", "dialog box controls [C++], editing properties", "dialog box controls [C++], deleting", "controls [C++], deleting", "Dialog Editor [C++], default control events", "controls [C++], default control events", "events [C++], controls", "dialog box controls [C++], events", "member variables, defining for controls", "variables, dialog box control member variables", "controls [C++], member variables", "Dialog Editor [C++], defining member variables for controls", "controls [C++], troubleshooting", "Dialog Editor [C++], troubleshooting", "dialog boxes [C++], troubleshooting", "InitCommonControls", "RichEdit 1.0 control", "rich edit controls [C++], RichEdit 1.0"] -ms.assetid: 73cef03f-5c8c-456a-87d1-1458dff185cf +ms.topic: how-to --- # How To: Add, Edit, or Delete Controls (C++) @@ -204,17 +204,17 @@ Win32 ## See also -[Manage Dialog Box Controls](controls-in-dialog-boxes.md)
-[How To: Layout Controls](arrangement-of-controls-on-dialog-boxes.md)
+[Manage Dialog Box Controls](controls-in-dialog-boxes.md)\ +[How To: Layout Controls](arrangement-of-controls-on-dialog-boxes.md)\ [How to: Define Control Access and Values](defining-mnemonics-access-keys.md) diff --git a/docs/windows/arrangement-of-controls-on-dialog-boxes.md b/docs/windows/arrangement-of-controls-on-dialog-boxes.md index 7dbf3020fed..1c2b92daa72 100644 --- a/docs/windows/arrangement-of-controls-on-dialog-boxes.md +++ b/docs/windows/arrangement-of-controls-on-dialog-boxes.md @@ -5,6 +5,7 @@ ms.date: "02/15/2019" f1_keywords: ["vc.editors.dialog.grouping", "vc.editors.dialog.combo"] helpviewer_keywords: ["controls [C++], positioning", "dialog box controls [C++], placement", "Dialog Editor [C++], arranging controls", "Dialog Editor [C++], guides and margins", "guides, clearing", "guides", "dialog box controls [C++], placement", "controls [C++], guides and margins", "guides, creating", "guides, moving", "margins, moving", "DLUs (dialog units)", "controls [C++], aligning", "Dialog Editor [C++], snap to guides", "guides, tick mark interval", "dialog box controls [C++], placement", "guides, aligning controls", "dialog units (DLUs)", "snap to guides (Dialog editor)", "controls [C++], sizing", "tick mark interval in Dialog editor", "controls [C++], snap to guides/grid", "guides, disabling snapping", "controls [C++], snap to guides/grid", "controls [C++], layout grid", "snap to layout grid", "grids, turning on or off", "layout grid in Dialog Editor", "grids, changing size", "grid spacing", "guides, settings", "layout grid in Dialog Editor", "controls [C++], snap to guides/grid", "Guide Settings dialog box (Dialog editor)", "controls [C++], aligning", "controls [C++], positioning", "Space Evenly command", "dialog box controls [C++], placement", "Center in Dialog command", "Arrange Buttons command", "buttons, arranging push buttons in dialog boxes", "push buttons", "member variables, adding to radio button groups", "variables, dialog box control member variables", "dialog box controls [C++], grouping radio buttons", "grouping controls", "radio buttons [C++], grouping on dialog boxes", "controls [C++], tab order", "focus, tab order", "tab controls [C++], tab order", "Tabstop property for controls", "controls [C++], focus", "dialog box controls [C++], tab order", "Dialog Editor [C++], selecting controls", "dominant controls", "dialog box controls [C++], selecting in editor", "controls [C++], selecting", "size, controls", "controls [C++], dominant", "controls [C++], removing from groups", "Dialog Editor [C++], dominant control", "Size to Content command", "size, controls", "text, autosizing controls to fit text", "controls [C++], sizing", "Make Same Size command", "combo boxes, sizing", "list controls [C++], scroll bar width", "CListBox::SetHorizontalExtent", "controls [C++], scroll bar", "scroll bars [C++], displaying in controls", "horizontal scroll bar width", "CListBox class, scroll bar width", "scroll bars [C++], width"] ms.assetid: 832491cf-98af-42e5-a854-2cb135fd45c6 +ms.topic: how-to --- # How To: Layout Controls (C++) diff --git a/docs/windows/attributes/attributes-alphabetical-reference.md b/docs/windows/attributes/attributes-alphabetical-reference.md index 2e6948ed8f4..375d6a5736d 100644 --- a/docs/windows/attributes/attributes-alphabetical-reference.md +++ b/docs/windows/attributes/attributes-alphabetical-reference.md @@ -3,7 +3,7 @@ description: "Learn more about: Attributes Alphabetical Reference" title: "Attributes Alphabetical Reference" ms.custom: "index-page" ms.date: "10/02/2018" -ms.topic: "conceptual" +ms.topic: "concept-article" f1_keywords: ["vc.attributes"] helpviewer_keywords: ["attributes [C++/CLI]"] ms.assetid: fb2216ef-9fbd-44f4-afed-732aa99450e2 diff --git a/docs/windows/attributes/attributes-by-group.md b/docs/windows/attributes/attributes-by-group.md index e344d58f67a..42a1cd2787f 100644 --- a/docs/windows/attributes/attributes-by-group.md +++ b/docs/windows/attributes/attributes-by-group.md @@ -3,7 +3,7 @@ description: "Learn more about: Attributes by Group" title: "Attributes by Group" ms.custom: "index-page" ms.date: "10/02/2018" -ms.topic: "conceptual" +ms.topic: "concept-article" helpviewer_keywords: ["attributes [C++/CLI]"] ms.assetid: 9f4dd43f-9909-43d6-91d2-05734643876e --- diff --git a/docs/windows/attributes/attributes-by-usage.md b/docs/windows/attributes/attributes-by-usage.md index ea43dfd652a..628c0a616ba 100644 --- a/docs/windows/attributes/attributes-by-usage.md +++ b/docs/windows/attributes/attributes-by-usage.md @@ -3,7 +3,7 @@ description: "Learn more about: Attributes by Usage" title: "Attributes by Usage" ms.custom: "index-page" ms.date: "10/02/2018" -ms.topic: "conceptual" +ms.topic: "concept-article" helpviewer_keywords: ["attributes [C++/CLI]"] ms.assetid: 8be2de10-b1ff-4ca4-a114-75318408593c --- diff --git a/docs/windows/attributes/cpp-attributes-com-net.md b/docs/windows/attributes/cpp-attributes-com-net.md index 830c975df11..3ca2ca8b5b9 100644 --- a/docs/windows/attributes/cpp-attributes-com-net.md +++ b/docs/windows/attributes/cpp-attributes-com-net.md @@ -1,11 +1,10 @@ --- -description: "Learn more about: C++ Attributes for COM and .NET" title: "C++ Attributes for COM and .NET" +description: "Learn more about: C++ Attributes for COM and .NET" +ms.date: 11/19/2018 ms.custom: "index-page" -ms.date: "11/19/2018" -ms.topic: "conceptual" +ms.topic: "concept-article" helpviewer_keywords: ["attributes [C++/CLI], reference topics"] -ms.assetid: 613a3611-b3eb-4347-aa38-99b654600e1c --- # C++ Attributes for COM and .NET @@ -96,11 +95,11 @@ This field lists other attributes that are incompatible with the specified attri ## Debug injected code -Using attributes can greatly simplify C++ programming. For more information, see [Concepts](/cpp/windows/attributed-programming-concepts). Some attributes are interpreted directly by the compiler. Other attributes inject code into the program source, which the compiler then compiles. This injected code makes programming easier by reducing the amount of code you have to write. Sometimes, however, a bug may cause your application to fail while it is executing injected code. When this happens, you will probably want to look at the injected code. Visual Studio provides two ways for you to see injected code: +Using attributes can greatly simplify C++ programming. Some attributes are interpreted directly by the compiler. Other attributes inject code into the program source, which the compiler then compiles. This injected code makes programming easier by reducing the amount of code you have to write. Sometimes, however, a bug may cause your application to fail while it is executing injected code. When this happens, you will probably want to look at the injected code. Visual Studio provides two ways for you to see injected code: - You can view injected code in the **Disassembly** window. -- Using [/Fx](/cpp/build/reference/fx-merge-injected-code), you can create a merged source file that contains original and injected code. +- Using [/Fx](../../build/reference/fx-merge-injected-code.md), you can create a merged source file that contains original and injected code. The **Disassembly** window shows assembly-language instructions that correspond to the source code and the code injected by attributes. In addition, the **Disassembly** window can show the source-code annotation. diff --git a/docs/windows/attributes/db-param.md b/docs/windows/attributes/db-param.md index 51538ad0a29..cebb586d5d6 100644 --- a/docs/windows/attributes/db-param.md +++ b/docs/windows/attributes/db-param.md @@ -5,6 +5,7 @@ ms.date: "10/02/2018" f1_keywords: ["vc-attr.db_param"] helpviewer_keywords: ["db_param attribute"] ms.assetid: a28315f5-4722-459e-92ef-32e83c0b205a +ms.custom: sfi-ropc-nochange --- # db_param diff --git a/docs/windows/attributes/db-source.md b/docs/windows/attributes/db-source.md index 4b5d1ff5a7b..d54e30f8a4f 100644 --- a/docs/windows/attributes/db-source.md +++ b/docs/windows/attributes/db-source.md @@ -5,6 +5,7 @@ ms.date: "10/02/2018" f1_keywords: ["vc-attr.db_source"] helpviewer_keywords: ["db_source attribute"] ms.assetid: 0ec8bbf7-ade2-4899-bf4c-8608b92779bc +ms.custom: sfi-ropc-nochange --- # db_source diff --git a/docs/windows/changing-a-symbol-or-symbol-name-id.md b/docs/windows/changing-a-symbol-or-symbol-name-id.md index 03e9c25ca31..82376571371 100644 --- a/docs/windows/changing-a-symbol-or-symbol-name-id.md +++ b/docs/windows/changing-a-symbol-or-symbol-name-id.md @@ -5,6 +5,7 @@ ms.date: "02/14/2019" f1_keywords: ["vc.editors.symbol.changing", "vc.editors.symbol.restrictions.name", "vc.editors.symbol.changing.value", "vc.editors.symbol.restrictions.value", "vc.editors.symbol.changing.header", "vc.editors.symbol.changing.unassigned", "vc.editors.symbol.shared.calculated"] helpviewer_keywords: ["symbol names", "symbols [C++], names", "restrictions, symbol names", "numeric values", "symbols [C++], numeric values", "numeric values, changing symbols", "symbols [C++], value restrictions", "restrictions, symbol values", "resource files [C++], multiple", "Resource Includes dialog box [C++]", "symbol header files [C++], changing names", "symbols [C++], symbol header files", "Resource.h", "symbols [C++], unassigned", "Change Symbol dialog box [C++]", "unassigned symbols", "symbols [C++], deleting", "symbols [C++], read-only", "symbols [C++], shared", "symbols [C++], calculated", "read-only symbols", "symbol directives", "calculated symbols", "shared symbols"] ms.assetid: 26541832-8dba-4177-b642-e08f94502ea7 +ms.topic: how-to --- # How to: Manage Symbols diff --git a/docs/windows/clickonce-deployment-for-visual-cpp-applications.md b/docs/windows/clickonce-deployment-for-visual-cpp-applications.md index 07698cb3de3..1824562d2ab 100644 --- a/docs/windows/clickonce-deployment-for-visual-cpp-applications.md +++ b/docs/windows/clickonce-deployment-for-visual-cpp-applications.md @@ -1,19 +1,19 @@ --- -description: "Learn more about: ClickOnce Deployment for Visual C++ Applications" -title: "ClickOnce Deployment for Visual C++ Applications" +description: "Learn more about: ClickOnce Deployment for Microsoft C++ Applications" +title: "ClickOnce Deployment for Microsoft C++ Applications" ms.date: "11/04/2016" helpviewer_keywords: ["deploying applications [C++], ClickOnce", "application deployment [C++], ClickOnce", "ClickOnce deployment [C++], C++ applications"] --- -# ClickOnce Deployment for Visual C++ Applications +# ClickOnce Deployment for Microsoft C++ Applications Visual Studio provides two different technologies for deploying Windows applications: ClickOnce deployment or [Windows Installer](/windows/win32/Msi/windows-installer-portal) deployment. ## ClickOnce Deployment in C++ > [!NOTE] -> ClickOnce does not support deployment of native C++ applications. However, you can use ClickOnce to deploy a Visual C++ application if it is a dependency of a Visual C# or VB.NET project. For example, if you have a Visual C# project that depends on a Visual C++ project, you can publish the application (including its dependencies) using ClickOnce deployment from the Visual C# development environment. If you have a Visual Basic .NET project that depends on a Visual C++ project, you can publish the application (including its dependencies) using ClickOnce deployment from the Visual Basic .NET development environment. +> ClickOnce does not support deployment of native C++ applications. However, you can use ClickOnce to deploy a Microsoft C++ application if it is a dependency of a C# or VB.NET project. For example, if you have a C# project that depends on a C++ project, you can publish the application (including its dependencies) using ClickOnce deployment from the C# development environment. If you have a Visual Basic .NET project that depends on a C++ project, you can publish the application (including its dependencies) using ClickOnce deployment from the Visual Basic .NET development environment. -To deploy a Visual C++ application using ClickOnce, you first have to build a [ClickOnce Application Manifest](/visualstudio/deployment/clickonce-application-manifest) and a [ClickOnce Deployment Manifest](/visualstudio/deployment/clickonce-deployment-manifest) using the [Mage.exe (Manifest Generation and Editing Tool)](/dotnet/framework/tools/mage-exe-manifest-generation-and-editing-tool) or its graphical user interface version (for information, see [MageUI.exe (Manifest Generation and Editing Tool, Graphical Client)](/dotnet/framework/tools/mageui-exe-manifest-generation-and-editing-tool-graphical-client)). +To deploy a C++ application using ClickOnce, you first have to build a [ClickOnce Application Manifest](/visualstudio/deployment/clickonce-application-manifest) and a [ClickOnce Deployment Manifest](/visualstudio/deployment/clickonce-deployment-manifest) using the [Mage.exe (Manifest Generation and Editing Tool)](/dotnet/framework/tools/mage-exe-manifest-generation-and-editing-tool) or its graphical user interface version (for information, see [MageUI.exe (Manifest Generation and Editing Tool, Graphical Client)](/dotnet/framework/tools/mageui-exe-manifest-generation-and-editing-tool-graphical-client)). You first use Mage.exe to build the application manifest; the resulting file will have the extension .manifest. You then use Mage.exe to build the deployment manifest; the resulting file will have the extension `.application`. You then sign the manifests. @@ -21,7 +21,7 @@ The application manifest must specify the target processor (**x86**, **x64**, or Also, the name of the application and deployment manifests must be different from the name of the C++ application. This avoids conflict between the application manifest created by Mage.exe and the external manifest that is part of the C++ application. -Your deployment needs to install any Visual C++ libraries on which your application depends. To determine the dependencies for a particular application, you can use depends.exe or the `DUMPBIN` utility with the `/DEPENDENTS` option. For more information on dependencies, see [Understanding the Dependencies of a Visual C++ Application](understanding-the-dependencies-of-a-visual-cpp-application.md). You might need to run VCRedist.exe; this utility installs Visual C++ libraries on the target computer. +Your deployment needs to install any C++ libraries on which your application depends. To determine the dependencies for a particular application, you can use depends.exe or the `DUMPBIN` utility with the `/DEPENDENTS` option. For more information on dependencies, see [Understanding the Dependencies of a Microsoft C++ Application](understanding-the-dependencies-of-a-visual-cpp-application.md). You might need to run VCRedist.exe; this utility installs C++ libraries on the target computer. You may also need to build a bootstrapper (prerequisites installer) for your application to deploy prerequisite components; for information on the bootstrapper, see [Creating Bootstrapper Packages](/visualstudio/deployment/creating-bootstrapper-packages). diff --git a/docs/windows/creating-a-new-dialog-box.md b/docs/windows/creating-a-new-dialog-box.md index 50d344c9a50..9552cf35923 100644 --- a/docs/windows/creating-a-new-dialog-box.md +++ b/docs/windows/creating-a-new-dialog-box.md @@ -4,6 +4,7 @@ title: "How To: Create a Dialog Box (C++)" ms.date: "02/15/2019" helpviewer_keywords: ["dialog boxes [C++], creating", "Dialog Editor [C++], creating dialog boxes", "modal dialog boxes [C++], logon screens", "logon screens", "Test Dialog command", "testing, dialog boxes", "dialog boxes [C++], testing", "dialog boxes [C++], size", "dialog boxes [C++], positioning"] ms.assetid: 303de801-c4f8-42e1-b622-353f6423f688 +ms.topic: how-to --- # How to: Create a Dialog Box (C++) diff --git a/docs/windows/creating-an-icon-or-other-image-image-editor-for-icons.md b/docs/windows/creating-an-icon-or-other-image-image-editor-for-icons.md index 004896d77c5..5c477289796 100644 --- a/docs/windows/creating-an-icon-or-other-image-image-editor-for-icons.md +++ b/docs/windows/creating-an-icon-or-other-image-image-editor-for-icons.md @@ -1,24 +1,24 @@ --- -description: "Learn more about: How To: Create an Icon or Other Image" -title: "How To: Create an Icon or Other Image" -ms.date: "02/15/2019" +title: "Create an icon or other image" +description: "Learn how to create a new image, bitmap, icon, cursor, or toolbar, and then use the Image Editor to customize its appearance." +ms.date: 03/21/2025 +ms.topic: how-to helpviewer_keywords: ["bitmaps [C++]", "images [C++], creating", "resources [C++], creating images", "bitmaps [C++], creating", "graphics [C++], creating", "Image editor [C++], creating images", "cursors [C++], creating", "image resources [C++], display devices", "icons [C++], creating", "cursors [C++], types", "icons [C++]", "Image editor [C++], icons and cursors", "cursors [C++]", "display devices [C++], creating icons for", "cursors [C++], hot spots", "icons [C++], types", "icons [C++], creating", "display devices [C++], creating image", "images [C++], creating for display devices", "icons [C++], inserting", "New Image Type dialog box [C++]", "Custom Image dialog box [C++]", "Open Image dialog box [C++]", "New Device Image command", "display devices [C++], adding images", "cursors [C++], adding", "icons, adding", "display devices [C++], copying images", "cursors [C++], copying", "icons, copying", "cursors [C++], deleting", "display devices [C++], deleting device image", "icons, erasing", "icons, deleting", "cursors [C++], undoing changes", "icons, undoing changes", "cursors [C++], screen regions", "inverse colors [C++], device images", "transparent regions, device images", "transparency, device images", "Image editor [C++], device images", "inverse regions, device images", "cursors [C++], transparent regions", "screen colors", "regions, transparent", "icons [C++], transparent regions", "display devices [C++], transparent and screen regions", "transparent regions in devices", "regions, inverse", "colors [C++], Image editor", "device projects [C++], transparent images", "icons [C++], screen regions", "256-color palette", "cursors [C++], color", "colors [C++], icons", "colors [C++], cursors", "icons, color", "colors [C++], icons and cursors", "color palettes, 256-color", "palettes, 256-color", "cursors [C++], hot spots", "hot spots", ".gif files [C++], saving bitmaps as", "jpg files [C++], saving bitmaps as", "jpeg files [C++], saving bitmaps as", ".jpg files [C++], saving bitmaps as", "Image editor [C++], converting image formats", "gif files [C++], saving bitmaps as", "bitmaps [C++], converting formats", ".jpeg files [C++], saving bitmaps as", "graphics [C++], converting formats", "images [C++], converting formats", "images [C++], stand-alone editing", "Image editor [C++], converting image formats", "graphics [C++], converting formats", "images [C++], converting formats"] -ms.assetid: 66db3fb2-cfc1-48a2-9bdd-53f61eb7ee30 --- -# How To: Create an Icon or Other Image +# Create an icon or other image You can create a new image, bitmap, icon, cursor, or toolbar, and then use the **Image Editor** to customize its appearance. You can also create a new bitmap patterned after a [resource template](./how-to-create-a-resource-script-file.md). -## Icons and Cursors: Image Resources for Display Devices +## Icons and cursors: image resources for display devices -Icons and cursors are graphical resources that can contain multiple images in different sizes and color schemes for different types of display devices. A cursor also has a hot spot, the location Windows uses to track its position. Both icons and cursors are created and edited using the **Image Editor**, as are bitmaps and other images. +Icons and cursors are graphical resources that can contain multiple images in different sizes and color schemes for different types of display devices. A cursor also has a hot spot, which is the location that Windows uses to track its position. Both icons and cursors are created and edited using the **Image Editor**, as are bitmaps and other images. When you create a new icon or cursor, the **Image Editor** first creates an image of a standard type. The image is initially filled with the screen (transparent) color. If the image is a cursor, the hot spot is initially the upper-left corner with coordinates `0,0`. -By default, the **Image Editor** supports the creation of additional images for the devices shown in the following table. You can create images for other devices by typing width, height, and color-count parameters into the **Custom Image** dialog box. +By default, the **Image Editor** supports the creation of new images for the devices shown in the following table. You can create images for other devices by typing width, height, and color-count parameters into the **Custom Image** dialog box. |Color|Width (pixels)|Height (pixels)| -|-----------|----------------------|-----------------------| +|-----|--------------|---------------| |Monochrome|16|16| |Monochrome|32|32| |Monochrome|48|48| @@ -37,12 +37,12 @@ By default, the **Image Editor** supports the creation of additional images for ### Create a device image (icon or cursor) -When you create a new icon or cursor resource, the **Image Editor** first creates an image in a specific style (32 × 32, 16 colors for icons and 32 × 32, Monochrome for cursors). You can then add images in different sizes and styles to the initial icon or cursor and edit each additional image, as needed, for the different display devices. You can also edit an image by using a cut-and-paste operation from an existing image type or from a bitmap created in a graphics program. +When you create a new icon or cursor resource, the **Image Editor** first creates an image in a specific style: 32 × 32 pixels and 16 colors for icons; 32 × 32 pixels and monochrome for cursors. You can then add images in different sizes and styles to the initial icon or cursor, and edit each additional image, as needed, for the different display devices. You can also edit an image by using a cut-and-paste operation from an existing image type or from a bitmap created in a graphics program. When you open the icon or cursor resource in the [Image Editor](../windows/image-editor-for-icons.md), the image most closely matching the current display device is opened by default. > [!NOTE] -> If your project doesn't already contain an .rc file, see [Creating a New Resource Script File](../windows/how-to-create-a-resource-script-file.md). +> If your project doesn't already contain an *`.rc`* file, see [Create Resources (C++)](../windows/how-to-create-a-resource-script-file.md). The **New \ Image Type** dialog box enables you to create a new device image of a specified type. To open the **New \ Image** dialog box, go to menu **Image** > **New Image Type**. The following properties included are **Target Image Type** and **Custom**. @@ -50,40 +50,46 @@ The **Target Image Type** property lists the available image types where you sel :::row::: :::column span=""::: - 16 x 16, 16 colors\ - 32 x 32, 16 colors\ - 48 x 48, 16 colors\ - 64 x 64, 16 colors\ - 96 x 96, 16 colors + 16 x 16, 1 bit (monochrome)\ + 16 x 16, 24 bit (16 million colors)\ + 16 x 16, 4 bit (16 colors)\ + 128 x 128, 1 bit (monochrome)\ + 128 x 128, 24 bit (16 million colors)\ + 128 x 128, 4 bit (16 colors)\ + 128 x 128, 8 bit (256 colors) :::column-end::: :::column span=""::: - 16 x 16, 256 colors\ - 32 x 32, 256 colors\ - 48 x 48, 256 colors\ - 64 x 64, 256 colors\ - 96 x 96, 256 colors + 256 x 256, 1 bit (monochrome)\ + 256 x 256, 24 bit (16 million colors)\ + 256 x 256, 4 bit (16 colors)\ + 256 x 256, 8 bit (256 colors)\ + 32 x 32, 1 bit (monochrome)\ + 32 x 32, 24 bit (16 million colors)\ + 32 x 32, 4 bit (16 colors) :::column-end::: :::column span=""::: - 16 x 16, Monochrome\ - 32 x 32, Monochrome\ - 48 x 48, Monochrome\ - 64 x 64, Monochrome\ - 96 x 96, Monochrome + 48 x 48, 1 bit (monochrome)\ + 48 x 48, 24 bit (16 million colors)\ + 48 x 48, 4 bit (16 colors)\ + 64 x 64, 1 bit (monochrome)\ + 64 x 64, 24 bit (16 million colors)\ + 64 x 64, 4 bit (16 colors)\ + 64 x 64, 8 bit (256 colors) :::column-end::: :::row-end::: > [!NOTE] -> Any existing images will not be displayed in this list. +> Existing images are not displayed in this list. The **Custom** property opens the **Custom Image** dialog box in which you can create a new image with a custom size and number of colors. -The **Custom Image** dialog box enables you to create a new image with a custom size and number of colors. The following properties included are: +The **Custom Image** dialog box allows you to create a new image with a custom size and number of colors. The following properties included are: |Property|Description| |---|---| -|**Width**|Provides a space for you to enter the width of the custom image in pixels (1 - 512, limit of 2048).| -|**Height**|Provides a space for you to enter the height for the custom image in pixels (1 - 512, limit of 2048).| -|**Colors**|Provides a space for you to choose the number of colors for the custom image: 2, 16, or 256.| +|**Width**|Provides a space for you to enter the width of the custom image in pixels (1 - 512, limit of 2048)| +|**Height**|Provides a space for you to enter the height for the custom image in pixels (1 - 512, limit of 2048)| +|**Colors**|Provides a space for you to choose the number of bits for color for the custom image: 1, 4, 8, 24| Use the **Open \ Image** dialog box to open device images in C++ projects. It lists existing device images in the current resource (images that are part of the current resource). The following property included is: @@ -93,9 +99,9 @@ Use the **Open \ Image** dialog box to open device images in C++ project #### To create a new icon or cursor -1. In [Resource View](how-to-create-a-resource-script-file.md#create-resources), right-click your *.rc* file, then choose **Insert Resource**. If you already have an existing image resource in your *.rc* file, such as a cursor, you can right-click the **Cursor** folder and select **Insert Cursor**. +1. In [Resource View](how-to-create-a-resource-script-file.md#create-resources), right-click your *`.rc`* file, then choose **Add Resource**. If you already have an existing image resource in your *`.rc`* file, such as a cursor, you can right-click the **Cursor** folder and select **Insert Cursor**. -1. In the [Insert Resource dialog box](./how-to-create-a-resource-script-file.md), select **Icon** or **Cursor** and choose **New**. For icons, this action creates an icon resource with a 32 × 32, 16-color icon. For cursors, a 32 × 32, Monochrome (2-color) image is created. +1. In the [Add Resource dialog box](./how-to-create-a-resource-script-file.md), select **Icon** or **Cursor** and choose **New**. For icons, this action creates an icon resource with a 32 × 32, 16-color icon. For cursors, a 32 × 32, monochrome image is created. If a plus sign (**+**) appears next to the image resource type in the **Insert Resource** dialog box, it means that toolbar templates are available. Select the plus sign to expand the list of templates, select a template, and choose **New**. @@ -120,11 +126,11 @@ Use the **Open \ Image** dialog box to open device images in C++ project While the icon image is displayed in the **Image Editor**, go to menu **Image** > **Delete Device Image**. When you delete the last icon image in the resource, the resource is also deleted. > [!NOTE] -> When you press the **Del** key, the images and colors you have drawn on an icon are deleted but the icon remains and you can now redesign it. If you press **Del** by mistake, press **Ctrl**+**Z** to undo the action. +> When you press the **Del** key, the images and colors you drew on an icon are deleted but the icon remains and you can now redesign it. If you press **Del** by mistake, press **Ctrl**+**Z** to undo the action. ### To create transparent or inverse regions in device images -In the [Image Editor](../windows/image-editor-for-icons.md), the initial icon or cursor image has a transparent attribute. Although icon and cursor images are rectangular, many don't appear so because parts of the image are transparent and the underlying image on the screen shows through the icon or cursor. When you drag an icon, parts of the image may appear in an inverted color. You create this effect by setting the screen color and inverse color in the [Colors window](./image-editor-for-icons.md). +In the [Image Editor](../windows/image-editor-for-icons.md), the initial icon or cursor image has a transparent attribute. Although icon and cursor images are rectangular, many don't appear so because parts of the image are transparent and the underlying image on the screen shows through the icon or cursor. When you drag an icon, parts of the image might appear in an inverted color. You create this effect by setting the screen color and inverse color in the [Colors window](./image-editor-for-icons.md). The screen and inverse colors you apply to icons and cursors either shape and color the derived image or assign inverse regions. The colors indicate parts of the image that have those attributes. You can change the colors that represent the screen-color and inverse-color attributes in editing. These changes don't affect the appearance of the icon or cursor in your application. @@ -154,9 +160,9 @@ Using the **Image Editor**, icons and cursors can be sized large (64 × 64) with #### To create a 256-color icon or cursor -1. In [Resource View](how-to-create-a-resource-script-file.md#create-resources), right-click your *.rc* file, then choose **Insert Resource**. If you already have an existing image resource in your *.rc* file, such as a cursor, you can right-click the **Cursor** folder and select **Insert Cursor**. +1. In [Resource View](how-to-create-a-resource-script-file.md#create-resources), right-click your *`.rc`* file, then choose **Add Resource**. If you already have an existing image resource in your *`.rc`* file, such as a cursor, you can right-click the **Cursor** folder and select **Insert Cursor**. -1. In the [Insert Resource dialog box](./how-to-create-a-resource-script-file.md), select **Icon** or **Cursor** and choose **New**. +1. In the [Add Resource dialog box](./how-to-create-a-resource-script-file.md), select **Icon** or **Cursor** and choose **New**. 1. Go to menu **Image** > **New Device Image** and select the 256-color image style you want. @@ -168,7 +174,7 @@ To draw with a selection from the 256-color palette, you need to select the colo 1. Choose a color from the 256 colors displayed in the **Colors** palette in the **Colors** window. - The color selected will become the current color in the **Colors** palette in the **Colors** window. + The color selected becomes the current color in the **Colors** palette in the **Colors** window. > [!NOTE] > The initial palette used for 256-color images matches the palette returned by the `CreateHalftonePalette` Windows API. All icons intended for the Windows shell should use this palette to prevent flicker during palette realization. @@ -183,9 +189,9 @@ The hot spot of a cursor is the point to which Windows refers in tracking the cu The **Hotspot** property in the **Properties** window displays the new coordinates. -### To create and save a bitmap as a .gif or .jpeg +### To create and save a bitmap as GIF or JPEG -When you create a bitmap, the image is created in bitmap format (.bmp). You can, however, save the image as a GIF or JPEG or in other graphic formats. +When you create a bitmap, the image is created in bitmap format (*`.bmp`*). You can, however, save the image as a *`.gif`* or *`.jpeg`* or in other graphic formats. > [!NOTE] > This process doesn't apply to icons and cursors. @@ -203,7 +209,7 @@ When you create a bitmap, the image is created in bitmap format (.bmp). You can, 1. In the **Save File As** dialog box, type the name you want to give the file and the extension that denotes the file format you want in the **File Name** box. For example, *myfile.gif*. > [!NOTE] - > You must create or open the bitmap outside of your project in order to save it as another file format. If you create or open it within your project, the **Save As** command will be unavailable. For more information, see [Viewing Resources in a Resource Script File Outside of a Project (Standalone)](./how-to-create-a-resource-script-file.md). + > You must create or open the bitmap outside of your project in order to save it as another file format. If you create or open it within your project, the **Save As** command is unavailable. For more information, see [Viewing Resources in a Resource Script File Outside of a Project (Standalone)](./how-to-create-a-resource-script-file.md). 1. Select **Save**. @@ -221,11 +227,11 @@ You can open GIF or JPEG images in the **Image Editor** and save them as bitmaps ### To add a new image resource to an unmanaged C++ project -1. In [Resource View](how-to-create-a-resource-script-file.md#create-resources), right-click your *.rc* file, then choose **Insert Resource**. If you already have an existing image resource in your *.rc* file, such as a cursor, you can simply right-click the **Cursor** folder and select **Insert Cursor**. +1. In [Resource View](how-to-create-a-resource-script-file.md#create-resources), right-click your *`.rc`* file, then choose **Add Resource**. If you already have an existing image resource in your *`.rc`* file, such as a cursor, you can right-click the **Cursor** folder and select **Insert Cursor**. -1. In the [Insert Resource dialog box](./how-to-create-a-resource-script-file.md), select the type of image resource you'd like to create (**Bitmap**, for example) then choose **New**. +1. In the [Add Resource dialog box](./how-to-create-a-resource-script-file.md), select the type of image resource you'd like to create (**Bitmap**, for example) then choose **New**. - If a plus sign (**+**) appears next to the image resource type in the **Insert Resource** dialog box, it means that toolbar templates are available. Select the plus sign to expand the list of templates, select a template, and choose **New**. + If a plus sign (**+**) appears next to the image resource type in the **Add Resource** dialog box, it means that toolbar templates are available. Select the plus sign to expand the list of templates, select a template, and choose **New**. ### To add a new image resource to a project in a .NET programming language @@ -239,17 +245,13 @@ You can open GIF or JPEG images in the **Image Editor** and save them as bitmaps The resource is added to your project in **Solution Explorer** and the resource opens in the [Image Editor](../windows/image-editor-for-icons.md). You can now use all the tools available in the **Image Editor** to modify your image. For more information on adding images to a managed project, see [Loading a Picture at Design Time](/dotnet/framework/winforms/controls/how-to-load-a-picture-using-the-designer-windows-forms). -## Requirements - -None - ## See also -[Image Editor for Icons](../windows/image-editor-for-icons.md)
-[How to: Edit an Image](../windows/selecting-an-area-of-an-image-image-editor-for-icons.md)
-[How to: Use a Drawing Tool](../windows/using-a-drawing-tool-image-editor-for-icons.md)
-[How to: Work with Color](../windows/working-with-color-image-editor-for-icons.md)
-[Accelerator Keys](../windows/accelerator-keys-image-editor-for-icons.md)
+- [Image Editor for Icons](../windows/image-editor-for-icons.md) +- [How to: Edit an Image](../windows/selecting-an-area-of-an-image-image-editor-for-icons.md) +- [How to: Use a Drawing Tool](../windows/using-a-drawing-tool-image-editor-for-icons.md) +- [How to: Work with Color](../windows/working-with-color-image-editor-for-icons.md) +- [Accelerator Keys](../windows/accelerator-keys-image-editor-for-icons.md)