Microsoft C++, C, and Assembler

https://learn.microsoft.com/en-us/cpp
Admin
Microsoft's comprehensive documentation and development tools for building applications using C++,...
Tokens:7,776,818
Snippets:92,625
Trust Score:10
Update:3 months ago
Show doc for...
Tokens:
Raw
### Input example

Source: https://learn.microsoft.com/en-us/cpp/standard-library/input-stream-member-functions

Example input for the get function demonstration.

```text
1234
```

--------------------------------

### Implement Page Setup Dialog in a View

Source: https://learn.microsoft.com/en-us/cpp/mfc/reference/cpagesetupdialog-class

Example showing how to initialize and display the Page Setup dialog, then apply user selections to the application.

```cpp
void CMyRichEditView::OnPageSetupDlg()
{
   CPageSetupDialog psd(PSD_INTHOUSANDTHSOFINCHES | PSD_MARGINS |
      PSD_ENABLEPAGEPAINTHOOK, this);

   // Initialize margins
   psd.m_psd.rtMargin.top = 1000;
   psd.m_psd.rtMargin.left = 1250;
   psd.m_psd.rtMargin.right = 1250;
   psd.m_psd.rtMargin.bottom = 1000;
   psd.m_psd.lpfnPagePaintHook = (LPPAGEPAINTHOOK)PaintHook;

   if (IDOK == psd.DoModal())
   {
      // Propagate changes to the app
      AfxGetApp()->SelectPrinter(psd.m_psd.hDevNames, psd.m_psd.hDevMode);
   }
   else
   {
      TRACE(_T("CommDlgExtendedError returned error %d from ")
         _T("CPageSetupDialog::DoModal().\n"),
         (int)CommDlgExtendedError());
   }
}
```

--------------------------------

### Bind Default Print Setup Command

Source: https://learn.microsoft.com/en-us/cpp/mfc/reference/cwinapp-class

Example of binding the File Print Setup command to the default framework implementation in a message map.

```cpp
// The following message map, produced by the Application Wizard, binds
// the File New, Open, and Print Setup menu commands to default
// framework implementations of these commands.
BEGIN_MESSAGE_MAP(CStdApp, CWinApp)
// Standard file based document commands
ON_COMMAND(ID_FILE_NEW, &CWinApp::OnFileNew)
ON_COMMAND(ID_FILE_OPEN, &CWinApp::OnFileOpen)
// Standard print setup command
ON_COMMAND(ID_FILE_PRINT_SETUP, &CWinApp::OnFilePrintSetup)
END_MESSAGE_MAP()
```

--------------------------------

### Example output for gets

Source: https://learn.microsoft.com/en-us/cpp/c-runtime-library/gets-getws

Sample output generated by the gets example.

```text
Hello there!The line entered was: Hello there!
```

--------------------------------

### CDC::StartDoc Usage Example

Source: https://learn.microsoft.com/en-us/cpp/mfc/reference/cdc-class

Demonstrates initializing a printer device context, starting a document, and printing a string.

```cpp
void CDCView::DoStartDoc()
{
   // get the default printer
   CPrintDialog dlg(FALSE);
   dlg.GetDefaults();

   // is a default printer set up?
   HDC hdcPrinter = dlg.GetPrinterDC();
   if (hdcPrinter == NULL)
   {
      MessageBox(_T("Buy a printer!"));
   }
   else
   {
      // create a CDC and attach it to the default printer
      CDC dcPrinter;
      dcPrinter.Attach(hdcPrinter);

      // call StartDoc() to begin printing
      DOCINFO docinfo;
      memset(&docinfo, 0, sizeof(docinfo));
      docinfo.cbSize = sizeof(docinfo);
      docinfo.lpszDocName = _T("CDC::StartDoc() Code Fragment");

      // if it fails, complain and exit gracefully
      if (dcPrinter.StartDoc(&docinfo) < 0)
      {
         MessageBox(_T("Printer wouldn't initialize"));
      }
      else
      {
         // start a page
         if (dcPrinter.StartPage() < 0)
         {
            MessageBox(_T("Could not start page"));
            dcPrinter.AbortDoc();
         }
         else
         {
            // actually do some printing
            CGdiObject *pOldFont = dcPrinter.SelectStockObject(SYSTEM_FONT);

            dcPrinter.TextOut(50, 50, _T("Hello World!"), 12);

            dcPrinter.EndPage();
            dcPrinter.EndDoc();
            dcPrinter.SelectObject(pOldFont);
         }
      }
   }
}
```

--------------------------------

### hash_set::begin Example

Source: https://learn.microsoft.com/en-us/cpp/dotnet/hash-set-stl-clr

Example demonstrating the use of begin to obtain an iterator to the start of the hash_set.

```cpp
// cliext_hash_set_begin.cpp
// compile with: /clr
#include <cliext/hash_set>

typedef cliext::hash_set<wchar_t> Myhash_set;
int main()
    {
    Myhash_set c1;
    c1.insert(L'a');
    c1.insert(L'b');
    c1.insert(L'c');

    // display initial contents " a b c"
    for each (wchar_t elem in c1)
        System::Console::Write("{0} ", elem);
    System::Console::WriteLine();

    // inspect first two items
    Myhash_set::iterator it = c1.begin();
    System::Console::WriteLine("*begin() = {0}", *it);
    System::Console::WriteLine("*++begin() = {0}", *++it);
    return (0);
    }
```

--------------------------------

### Create a setup batch file for application deployment

Source: https://learn.microsoft.com/en-us/cpp/windows/deploying-visual-cpp-application-by-using-the-vcpp-redistributable-package

This batch script handles the installation of the required Visual C++ Redistributable and copies the application executable to the target directory.

```batch
@echo off
REM Choose one of the following Redistributable files to install
::vc_redist.x86.exe    REM remove leading :: to install Redistributable for x86
::vc_redist.x64.exe    REM remove leading :: to install Redistributable for x64
::vc_redist.arm64.exe  REM remove leading :: to install Redistributable for ARM64
mkdir "C:\Program Files\MyMFCApp"
copy MyMFCApp.exe "C:\Program Files\MyMFCApp"
```

--------------------------------

### Bind Custom Print Setup Command

Source: https://learn.microsoft.com/en-us/cpp/mfc/reference/cwinapp-class

Example of binding the File Print Setup command to a custom handler implemented in a CWinApp-derived class.

```cpp
// The following message map illustrates how to rebind the
// File New, Open and Print Setup menu commands to handlers that
// you implement in your CWinApp-derived class.
// Note, you can name the handler CCustomApp::OnFileNew instead of
// CCustomApp::OnMyFileNew, and likewise for the other handlers, if desired.
BEGIN_MESSAGE_MAP(CCustomApp, CWinApp)
ON_COMMAND(ID_FILE_NEW, &CCustomApp::OnMyFileNew)
ON_COMMAND(ID_FILE_OPEN, &CCustomApp::OnMyFileOpen)
ON_COMMAND(ID_FILE_PRINT_SETUP, &CCustomApp::OnMyFilePrintSetup)
END_MESSAGE_MAP()
```

--------------------------------

### Output of set begin example

Source: https://learn.microsoft.com/en-us/cpp/standard-library/set-class

The expected console output after running the set begin example.

```text
The first element of s1 is 1
The first element of s1 is now 2
```

--------------------------------

### Example output

Source: https://learn.microsoft.com/en-us/cpp/standard-library/ios-base-class

The expected console output after running the registration example.

```text
in callback1
an imbue event
in callback1
an erase event
in callback2
an copyfmt event
in callback2
an erase event
in callback2
an erase event
```

--------------------------------

### Example output

Source: https://learn.microsoft.com/en-us/cpp/c-runtime-library/reference/access-waccess

Expected output from the provided _access example.

```text
File crt_ACCESS.C exists.
File crt_ACCESS.C does not have write permission.
```

--------------------------------

### Input for getline example

Source: https://learn.microsoft.com/en-us/cpp/standard-library/input-stream-member-functions

Example input string for the getline demonstration.

```text
test

```

--------------------------------

### Example Output

Source: https://learn.microsoft.com/en-us/cpp/c-runtime-library/reference/strset-strset-l-wcsset-wcsset-l-mbsset-mbsset-l

The console output resulting from the _strset example.

```text
Before: Fill the string with something.
After:  *******************************
```

--------------------------------

### Output for _getch example

Source: https://learn.microsoft.com/en-us/cpp/c-runtime-library/reference/getch-getwch

Expected output from the example program.

```text
Type 'Y' when finished typing keys: Y
```

--------------------------------

### Install and start OpenSSH server

Source: https://learn.microsoft.com/en-us/cpp/linux/set-up-fips-compliant-secure-remote-linux-development

Commands to install and start the OpenSSH service on a Linux system.

```bash
sudo apt install openssh-server
sudo service ssh start
```

--------------------------------

### Example: Registering a Window Class

Source: https://learn.microsoft.com/en-us/cpp/mfc/reference/application-information-and-management

Demonstrates initializing a WNDCLASS structure and registering it using AfxRegisterClass.

```cpp
// Register your unique class name that you wish to use
WNDCLASS wndcls;

memset(&wndcls, 0, sizeof(WNDCLASS));   // start with NULL defaults

wndcls.style = CS_DBLCLKS | CS_HREDRAW | CS_VREDRAW;

//you can specify your own window procedure
wndcls.lpfnWndProc = ::DefWindowProc; 
wndcls.hInstance = AfxGetInstanceHandle();
wndcls.hIcon = LoadIcon(wndcls.hInstance, MAKEINTRESOURCE(IDI_MYICON));
wndcls.hCursor = LoadCursor(wndcls.hInstance, MAKEINTRESOURCE(IDC_ARROW));
wndcls.hbrBackground = (HBRUSH)(COLOR_WINDOW + 1);
wndcls.lpszMenuName = NULL;

// Specify your own class name for using FindWindow later
wndcls.lpszClassName = _T("MyNewClass");

// Register the new class and trace if it fails
if(!AfxRegisterClass(&wndcls))
{
   TRACE("Class Registration Failed\n");
}
```

--------------------------------

### unordered_map::begin example output

Source: https://learn.microsoft.com/en-us/cpp/standard-library/unordered-map-class

The expected console output from the provided unordered_map example.

```text
[c, 3] [b, 2] [a, 1]
[c, 3] [b, 2]
[a, 1]
```

--------------------------------

### Example output

Source: https://learn.microsoft.com/en-us/cpp/c-runtime-library/reference/set-printf-count-output

The expected console output after running the configuration example.

```text
%n support was disabled.
%n support is now enabled.
123456789
i = 5
```

--------------------------------

### Install and Start SSH Server on Linux

Source: https://learn.microsoft.com/en-us/cpp/linux/remote-file-explorer

Commands to update the package list, install the OpenSSH server, and start the SSH service on a remote Linux machine.

```bash
sudo apt update
sudo apt install openssh-server
sudo systemctl start ssh
sudo systemctl status ssh
```

--------------------------------

### Get sys_info example

Source: https://learn.microsoft.com/en-us/cpp/standard-library/sys-info-struct

Demonstrates retrieving sys_info for the current time zone using the chrono library.

```cpp
// compile using: /std:c++latest
#include <iostream>
#include <chrono>

using namespace std::chrono;

int main()
{
    sys_time<system_clock::duration> st = system_clock::now();
    
    const auto& timeZoneDatabase = get_tzdb();
    const auto& currentZone = timeZoneDatabase.current_zone();
    auto sysInfo = currentZone->get_info(st);

    std::cout << sysInfo << "\n";

    return 0;
}
```

```text
begin: 2021-03-14 10:00:00, end: 2021-11-07 09:00:00, offset: -25200s, save: 60min, abbrev: PDT
```

--------------------------------

### Example usage of get with pairs

Source: https://learn.microsoft.com/en-us/cpp/standard-library/utility-functions

Demonstrates retrieving pair elements using both index-based and type-based access.

```C++
#include <utility>
#include <iostream>
using namespace std;
int main()
{
    typedef pair<int, double> MyPair;

    MyPair c0(9, 3.14);

    // get elements by index
    cout << " " << get<0>(c0);
    cout << " " << get<1>(c0) << endl;

    // get elements by type (C++14)
    MyPair c1(1, 0.27);
    cout << " " << get<int>(c1);
    cout << " " << get<double>(c1) << endl;
}
```

```text
9 3.14
1 0.27
```

--------------------------------

### Setup shared_ptr example environment

Source: https://learn.microsoft.com/en-us/cpp/cpp/how-to-create-and-use-shared-ptr-instances

Required headers and structure definitions for the shared_ptr examples.

```cpp
// shared_ptr-examples.cpp
// The following examples assume these declarations:
#include <algorithm>
#include <iostream>
#include <memory>
#include <string>
#include <vector>

struct MediaAsset
{
    virtual ~MediaAsset() = default; // make it polymorphic
};

struct Song : public MediaAsset
{
    std::wstring artist;
    std::wstring title;
    Song(const std::wstring& artist_, const std::wstring& title_) :
        artist{ artist_ }, title{ title_ } {}
};

struct Photo : public MediaAsset
{
    std::wstring date;
    std::wstring location;
    std::wstring subject;
    Photo(
        const std::wstring& date_,
        const std::wstring& location_,
        const std::wstring& subject_) :
        date{ date_ }, location{ location_ }, subject{ subject_ } {}
};

using namespace std;

int main()
{
    // The examples go here, in order:
    // Example 1
    // Example 2
    // Example 3
    // Example 4
    // Example 6
}
```

--------------------------------

### Creating and removing a directory

Source: https://learn.microsoft.com/en-us/cpp/c-runtime-library/reference/mkdir-wmkdir

Example demonstrating the creation and subsequent removal of a directory using _mkdir and _rmdir.

```c
// crt_makedir.c

#include <direct.h>
#include <stdlib.h>
#include <stdio.h>

int main( void )
{
   if( _mkdir( "\\testtmp" ) == 0 )
   {
      printf( "Directory '\\testtmp' was successfully created\n" );
      system( "dir \\testtmp" );
      if( _rmdir( "\\testtmp" ) == 0 )
        printf( "Directory '\\testtmp' was successfully removed\n"  );
      else
         printf( "Problem removing directory '\\testtmp'\n" );
   }
   else
      printf( "Problem creating directory '\\testtmp'\n" );
}
```

--------------------------------

### Get Storyboard Start Keyframe

Source: https://learn.microsoft.com/en-us/cpp/mfc/reference/canimationcontroller-class

Retrieves a pointer to the base keyframe identifying the start of a storyboard.

```cpp
static CBaseKeyFrame* GetKeyframeStoryboardStart();
```

--------------------------------

### Get starting offset of a subgroup

Source: https://learn.microsoft.com/en-us/cpp/standard-library/match-results-class

Returns the distance from the start of the target sequence to the beginning of the specified submatch.

```cpp
difference_type position(size_type sub = 0) const;
```

--------------------------------

### get function usage example

Source: https://learn.microsoft.com/en-us/cpp/standard-library/array-functions

Demonstrates accessing specific elements of a std::array using the get function.

```C++
#include <array>
#include <iostream>

using namespace std;

typedef array<int, 4> MyArray;

int main()
{
    MyArray c0 { 0, 1, 2, 3 };

    // display contents " 0 1 2 3"
    for (const auto& e : c0)
    {
        cout << " " << e;
    }
    cout << endl;

    // display odd elements " 1 3"
    cout << " " << get<1>(c0);
    cout << " " << get<3>(c0) << endl;
}
```

```text
0 1 2 3
1 3
```

--------------------------------

### Sample output for directory creation

Source: https://learn.microsoft.com/en-us/cpp/c-runtime-library/reference/mkdir-wmkdir

Expected console output after running the directory creation example.

```text
Directory '\testtmp' was successfully created
Volume in drive C has no label.
Volume Serial Number is E078-087A

Directory of C:\testtmp

02/12/2002  09:56a      <DIR>          .
02/12/2002  09:56a      <DIR>          ..
               0 File(s)              0 bytes
               2 Dir(s)  15,498,690,560 bytes free
Directory '	esttmp' was successfully removed
```

--------------------------------

### _getdiskfree Example

Source: https://learn.microsoft.com/en-us/cpp/c-runtime-library/reference/getdiskfree

A complete example demonstrating how to iterate through available drives and retrieve their disk information.

```C
// crt_getdiskfree.c

#include <windows.h>
#include <direct.h>
#include <stdio.h>

int main(int argc, char* argv[]) 
{
    ULONG uDriveMask = _getdrives();

    for (unsigned uDrive = 1; uDrive <= 26; ++uDrive) 
    {
        if (uDriveMask & 1)
        {
            struct _diskfree_t df = { 0 };
            unsigned uErr = _getdiskfree(uDrive, &df);
            printf("\nDrive: %c\n", uDrive + 'A' - 1);
            
            if (uErr == 0)
            {
                printf("\tTotal clusters:      %11u\n", df.total_clusters);
                printf("\tAvailable clusters:  %11u\n", df.avail_clusters);
                printf("\tSectors per cluster: %11u\n", df.sectors_per_cluster);
                printf("\tBytes per sector:    %11u\n", df.bytes_per_sector);
            }
            else
            {
                WCHAR errMsg[80];
                unsigned uLen = FormatMessage(FORMAT_MESSAGE_FROM_SYSTEM, NULL,
                    uErr, 0, errMsg, sizeof(errMsg), NULL);
                printf("%S\n", errMsg);
            }
        }
        uDriveMask >>= 1;
    }
}
```

--------------------------------

### Example usage of gets

Source: https://learn.microsoft.com/en-us/cpp/c-runtime-library/gets-getws

Demonstrates reading a line from standard input using gets, noting the risk of buffer overruns.

```C
// crt_gets.c
// compile with: /WX /W3

#include <stdio.h>

int main( void )
{
   char line[21]; // room for 20 chars + '\0'
   gets( line );  // C4996
   // Danger: No way to limit input to 20 chars.
   // Consider using gets_s instead.
   printf( "The line entered was: %s\n", line );
}
```

--------------------------------

### Invalid GUID usage triggering C2778

Source: https://learn.microsoft.com/en-us/cpp/error-messages/compiler-errors-2/compiler-error-c2778

Examples of malformed GUID strings that cause the compiler to emit error C2778.

```cpp
// C2778b.cpp
struct __declspec(uuid(" 00000000-0000-0000-0000-000000000000 ")) C { };   // C2778
struct __declspec(uuid("00000000000000000000000000000000")) D { };   // C2778
```

--------------------------------

### Example: Construct CHeapPtr

Source: https://learn.microsoft.com/en-us/cpp/atl/reference/cheapptr-class

Demonstrates creating a new CHeapPtr from an existing one.

```cpp
// Create a new CHeapPtr object
CHeapPtr <int> myHP;
// Create a new CHeapPtr from the first
CHeapPtr <int> myHP2(myHP);
```

--------------------------------

### Output of multiset::begin example

Source: https://learn.microsoft.com/en-us/cpp/standard-library/multiset-class

The expected console output after running the multiset::begin example.

```text
The first element of ms1 is 1
The first element of ms1 is now 2
```

--------------------------------

### Analyze Configuration Manager log output

Source: https://learn.microsoft.com/en-us/cpp/windows/troubleshoot-vc-redistributable-installation-issues

Example log content showing a failed Visual C++ Redistributable installation with return code 1603.

```log
10-31-2025 17:40:06.421    CONFIGURATION_MANAGER_UPDATE    67368 (0x10728)    [Visual C++ 2015-2022 Redistributable (x64)] with older version 14.28.29914 is installed. it needs to upgraded.
10-31-2025 17:40:06.421    CONFIGURATION_MANAGER_UPDATE    67368 (0x10728)    INFO: Start install Visual C redistributable ("C:\Program Files\Microsoft Configuration Manager\CMUStaging\AA928926-5C76-4DE0-B51F-0FE4D365DFE2\SMSSETUP\BIN\X64\vcredist_x64.exe"  /q /norestart /l "C:\Program Files\Microsoft Configuration Manager\Logs\VCRedist64Install.log").
10-31-2025 17:40:14.553    CONFIGURATION_MANAGER_UPDATE    67368 (0x10728)    ERROR: Failed to install Visual C redistributable. Return code: 1603.
10-31-2025 17:40:14.553    CONFIGURATION_MANAGER_UPDATE    67368 (0x10728)    ERROR: 64-bit VC Redist installation ("C:\Program Files\Microsoft Configuration Manager\CMUStaging\AA928926-5C76-4DE0-B51F-0FE4D365DFE2\SMSSETUP\BIN\X64\vcredist_x64.exe") failed. Please check log file [C:\Program Files\Microsoft Configuration Manager\Logs\VCRedist64Install.log].
10-31-2025 17:40:14.554    CONFIGURATION_MANAGER_UPDATE    67368 (0x10728)    Failed to install vc redist. Please manually install it from C:\Program Files\Microsoft Configuration Manager\CMUStaging\AA928926-5C76-4DE0-B51F-0FE4D365DFE2\SMSSETUP\BIN\X64
```

--------------------------------

### Get StartTimestamp

Source: https://learn.microsoft.com/en-us/cpp/build-insights/reference/sdk/cpp-event-data-types/activity

Retrieves the tick value captured when the activity started.

```cpp
const long long& StartTimestamp() const;
```

--------------------------------

### Example input file for _lseek

Source: https://learn.microsoft.com/en-us/cpp/c-runtime-library/reference/lseek-lseeki64

Sample content for the file used in the _lseek demonstration.

```text
Line one.
Line two.
Line three.
Line four.
Line five.
```

--------------------------------

### Get new_handler in C++

Source: https://learn.microsoft.com/en-us/cpp/standard-library/new-functions

Retrieves the currently installed new_handler function.

```C++
new_handler get_new_handler() noexcept;
```

--------------------------------

### CSize Initialization Example

Source: https://learn.microsoft.com/en-us/cpp/atl-mfc-shared/reference/csize-class

Demonstrates initializing CSize objects from different structures and types.

```cpp
CSize szEmpty;
CSize szPointA(10, 25);

SIZE sz;
sz.cx = 10;
sz.cy = 25;
CSize szPointB(sz);

POINT pt;
pt.x = 10;
pt.y = 25;
CSize szPointC(pt);

CPoint ptObject(10, 25);
CSize szPointD(ptObject);   

DWORD dw = MAKELONG(10, 25);
CSize szPointE(dw);

ASSERT(szPointA == szPointB);
ASSERT(szPointB == szPointC);
ASSERT(szPointC == szPointD);
ASSERT(szPointD == szPointE);
```

--------------------------------

### Example output

Source: https://learn.microsoft.com/en-us/cpp/standard-library/weekdaylast-class

The expected output from the weekday_last example.

```text
Mon
```

--------------------------------

### SortChildren Usage Example

Source: https://learn.microsoft.com/en-us/cpp/mfc/reference/ctreectrl-class

Sorts all items in the tree control starting from the root.

```cpp
// Sort all of the items in the tree control.
m_TreeCtrl.SortChildren(TVI_ROOT);
```

--------------------------------

### AddStrings Formatting Examples

Source: https://learn.microsoft.com/en-us/cpp/mfc/reference/ctoolbarctrl-class

Examples showing how to format buffers for adding single or multiple strings to the toolbar.

```cpp
// one null added automatically
lpszStrings = _T("Only one string to add\0");
```

```cpp
// adds three strings with one call
lpszStrings = _T("String 1\0String 2\0String 3\0");
```

--------------------------------

### Get unexpected handler in C++

Source: https://learn.microsoft.com/en-us/cpp/standard-library/exception-functions

Retrieves the currently installed unexpected_handler function.

```cpp
unexpected_handler get_unexpected();
```

--------------------------------

### Get terminate handler in C++

Source: https://learn.microsoft.com/en-us/cpp/standard-library/exception-functions

Retrieves the currently installed terminate_handler function.

```cpp
terminate_handler get_terminate();
```

--------------------------------

### Demonstrating Invalid Identifier Start Character

Source: https://learn.microsoft.com/en-us/cpp/error-messages/compiler-errors-2/compiler-error-c3873

This example shows how using a universal character name at the start of an identifier causes C3873, while the same character is permitted later in the identifier.

```cpp
// C3873.cpp
int main() {
   int \u036F_abc;   // C3873, not in allowed range for initial character
   int abc_\u036F;   // OK, in allowed range for non-initial character
}
```

--------------------------------

### Demonstrating time and date functions

Source: https://learn.microsoft.com/en-us/cpp/c-runtime-library/reference/time-time32-time64

A comprehensive example showing the usage of time, _localtime64_s, _gmtime64_s, mktime, and various formatting functions.

```c
// crt_times.c
// compile with: /W3
// This program demonstrates these time and date functions:
//      time         _ftime    ctime_s     asctime_s
//      _localtime64_s    _gmtime64_s    mktime    _tzset
//      _strtime_s     _strdate_s  strftime
//
// Also the global variable:
//      _tzname
//
// Turn off deprecated unsafe CRT function warnings
#define _CRT_SECURE_NO_WARNINGS 1

#include <time.h>
#include <stdio.h>
#include <stdlib.h>
#include <sys/types.h>
#include <sys/timeb.h>
#include <string.h>

int main()
{
    char tmpbuf[128], timebuf[26], ampm[] = "AM";
    time_t ltime;
    struct _timeb tstruct;
    struct tm today, gmt, xmas = { 0, 0, 12, 25, 11, 93 };
    errno_t err;

    // Set time zone from TZ environment variable. If TZ is not set,
    // the operating system is queried to obtain the default value
    // for the variable.
    //
    _tzset();

    // Display operating system-style date and time.
    _strtime_s( tmpbuf, 128 );
    printf( "OS time:\t\t\t\t%s\n", tmpbuf );
    _strdate_s( tmpbuf, 128 );
    printf( "OS date:\t\t\t\t%s\n", tmpbuf );

    // Get UNIX-style time and display as number and string.
    time( &ltime );
    printf( "Time in seconds since UTC 1/1/70:\t%lld\n", (long long)ltime );
    err = ctime_s(timebuf, 26, &ltime);
    if (err)
    {
        printf("ctime_s failed due to an invalid argument.");
        exit(1);
    }
    printf( "UNIX time and date:\t\t\t%s", timebuf );

    // Display UTC.
    err = _gmtime64_s( &gmt, &ltime );
    if (err)
    {
        printf("_gmtime64_s failed due to an invalid argument.");
    }
    err = asctime_s(timebuf, 26, &gmt);
    if (err)
    {
        printf("asctime_s failed due to an invalid argument.");
        exit(1);
    }
    printf( "Coordinated universal time:\t\t%s", timebuf );

    // Convert to time structure and adjust for PM if necessary.
    err = _localtime64_s( &today, &ltime );
    if (err)
    {
        printf("_localtime64_s failed due to an invalid argument.");
        exit(1);
    }
    if ( today.tm_hour >= 12 )
    {
        strcpy_s( ampm, sizeof(ampm), "PM" );
        today.tm_hour -= 12;
    }
    if ( today.tm_hour == 0 )  // Adjust if midnight hour.
        today.tm_hour = 12;

    // Convert today into an ASCII string
    err = asctime_s(timebuf, 26, &today);
    if (err)
    {
        printf("asctime_s failed due to an invalid argument.");
        exit(1);
    }

    // Note how pointer addition is used to skip the first 11
    // characters and printf is used to trim off terminating
    // characters.
    //
    printf( "12-hour time:\t\t\t\t%.8s %s\n",
        timebuf + 11, ampm );

    // Print additional time information.
    _ftime( &tstruct ); // C4996
    // Note: _ftime is deprecated; consider using _ftime_s instead
    printf( "Plus milliseconds:\t\t\t%u\n", tstruct.millitm );
    printf( "Zone difference in hours from UTC:\t%u\n",
             tstruct.timezone/60 );
    printf( "Time zone name:\t\t\t\t%s\n", _tzname[0] ); //C4996
    // Note: _tzname is deprecated; consider using _get_tzname
    printf( "Daylight savings:\t\t\t%s\n",
             tstruct.dstflag ? "YES" : "NO" );

    // Make time for noon on Christmas, 1993.
    if( mktime( &xmas ) != (time_t)-1 )
    {
        err = asctime_s(timebuf, 26, &xmas);
        if (err)
        {
            printf("asctime_s failed due to an invalid argument.");
            exit(1);
        }
        printf( "Christmas\t\t\t\t%s\n", timebuf );
    }

    // Use time structure to build a customized time string.
    err = _localtime64_s( &today, &ltime );
    if (err)
    {
        printf(" _localtime64_s failed due to invalid arguments.");
        exit(1);
    }

    // Use strftime to build a customized time string.
    strftime( tmpbuf, 128,
              "Today is %A, day %d of %B in the year %Y.\n", &today );
    printf( tmpbuf );
}
```

```text
OS time:            13:51:23
OS date:            04/25/03
Time in seconds since UTC 1/1/70:   1051303883
UNIX time and date:         Fri Apr 25 13:51:23 2003
Coordinated universal time:      Fri Apr 25 20:51:23 2003
12-hour time:            01:51:23 PM
Plus milliseconds:         552
Zone difference in hours from UTC:   8
Time zone name:            Pacific Standard Time
Daylight savings:         YES
Christmas            Sat Dec 25 12:00:00 1993

Today is Friday, day 25 of April in the year 2003.
```

--------------------------------

### SelectString Usage Example

Source: https://learn.microsoft.com/en-us/cpp/mfc/reference/clistbox-class

Searches for an item starting with the specified string and selects it if found.

```cpp
// The string to match.
LPCTSTR lpszmyString = _T("item 5");

// Select the item that begins with the specified string.
int nIndex = m_myListBox.SelectString(0, lpszmyString);
ASSERT(nIndex != LB_ERR);
```

--------------------------------

### BeginPaint Method

Source: https://learn.microsoft.com/en-us/cpp/atl/reference/cwindow-class

Prepares the window for painting.

```cpp
HDC BeginPaint(LPPAINTSTRUCT lpPaint) throw();
```

```cpp
//The following example attaches an HWND to the CWindow object
//and calls CWindow::BeginPaint() and CWindow::EndPaint() in the 
// WM_PAINT handler of a CWindowImpl-derived class
LRESULT CMyCtrl::OnPaint(UINT /*uMsg*/, WPARAM /*wParam*/, LPARAM /*lParam*/, 
   BOOL& /*bHandled*/)
{
   CWindow myWindow;
   myWindow.Attach(m_hWnd);
   PAINTSTRUCT ps;
   HDC hDC  = myWindow.BeginPaint(&ps);
   //Use the hDC as much as you want
   ::Rectangle(hDC, 0, 0, 50, 50);

   myWindow.EndPaint(&ps);

   return 0;
}
```

--------------------------------

### Example Output

Source: https://learn.microsoft.com/en-us/cpp/intrinsics/interlockedcompareexchange-intrinsic-functions

The expected console output when running the synchronization example.

```text
<0
<1
<2
<3
<4
<5
<6
<7
<8
<9
<10
<11
<12
<13
<14
<15
<16
<17
<18
<19
<20
<21
<22
<23
<24
<25
<26
<27
<28
<29
```

--------------------------------

### Example output

Source: https://learn.microsoft.com/en-us/cpp/standard-library/tuple-size-class-tuple

The expected output from the tuple_size usage example.

```text
0 1.5 2 3.7
4
```

--------------------------------

### hash_multimap::begin Example

Source: https://learn.microsoft.com/en-us/cpp/dotnet/hash-multimap-stl-clr

Demonstrates using begin to obtain an iterator to the start of the sequence.

```cpp
// cliext_hash_multimap_begin.cpp
// compile with: /clr
#include <cliext/hash_map>

typedef cliext::hash_multimap<wchar_t, int> Myhash_multimap;
int main()
    {
    Myhash_multimap c1;
    c1.insert(Myhash_multimap::make_value(L'a', 1));
    c1.insert(Myhash_multimap::make_value(L'b', 2));
    c1.insert(Myhash_multimap::make_value(L'c', 3));

    // display contents " [a 1] [b 2] [c 3]"
    for each (Myhash_multimap::value_type elem in c1)
        System::Console::Write("[{0} {1}] ", elem->first, elem->second);
    System::Console::WriteLine();

    // inspect first two items
    Myhash_multimap::iterator it = c1.begin();
    System::Console::WriteLine("*begin() = [{0} {1}]",
        it->first, it->second);
    ++it;
    System::Console::WriteLine("*++begin() = [{0} {1}]",
        it->first, it->second);
    return (0);
    }
```

```text
[a 1] [b 2] [c 3]
*begin() = [a 1]
*++begin() = [b 2]
```

--------------------------------

### Use CWindowDC Example

Source: https://learn.microsoft.com/en-us/cpp/mfc/reference/cwindowdc-class

Example demonstrating how to instantiate a CWindowDC and use the associated window handle.

```cpp
// Get a dc for a CWnd object pointer.
CWindowDC dc(pWnd);

// Send my private message.
::SendMessage(pWnd->m_hWnd, WM_MYMESSAGE, 0, 0);
```

--------------------------------

### Example output for _fullpath

Source: https://learn.microsoft.com/en-us/cpp/c-runtime-library/reference/fullpath-wfullpath

The expected console output when running the _fullpath demonstration program.

```text
Full path is: C:\Documents and Settings\user\My Documents\test
Full path is: C:\test
Full path is: C:\Documents and Settings\user\test
```

--------------------------------

### Obsolete Function Example

Source: https://learn.microsoft.com/en-us/cpp/error-messages/compiler-errors-2/compiler-error-c3861

Using functions removed from the CRT, such as 'gets', will result in C3861.

```cpp
// C3861_c.cpp
#include <stdio.h>
int main() {
   char line[21]; // room for 20 chars + '\0'
   gets( line );  // C3861
   // Use gets_s instead.
   printf( "The line entered was: %s\n", line );
}
```

--------------------------------

### Initializing CMFCFontComboBox

Source: https://learn.microsoft.com/en-us/cpp/mfc/reference/cmfcfontcombobox-class

Example showing how to configure font types and call the Setup method.

```cpp
// specify the font type
// BOOL m_bTrueType: true font type
// BOOL m_bRaster: raster font type
// BOOL m_bDeviceFont: device font type
int nFontType = 0;

if (m_bTrueType)
{
   nFontType |= TRUETYPE_FONTTYPE;
}

if (m_bRaster)
{
   nFontType |= RASTER_FONTTYPE;
}

if (m_bDeviceFont)
{
   nFontType |= DEVICE_FONTTYPE;
}

CWaitCursor wait;
m_wndFont.Setup(nFontType);
```

--------------------------------

### partition Output Example

Source: https://learn.microsoft.com/en-us/cpp/standard-library/algorithm-functions

Expected console output after executing the partition example.

```text
Vector v1 is ( 4 10 7 8 0 5 2 1 6 9 3 ).
The partitioned set of elements in v1 is: ( 9 10 7 8 6 5 2 1 0 4 3 ).
```

--------------------------------

### hash_multiset::begin Example

Source: https://learn.microsoft.com/en-us/cpp/dotnet/hash-multiset-stl-clr

Example demonstrating the use of begin to iterate through a hash_multiset.

```cpp
// cliext_hash_multiset_begin.cpp
// compile with: /clr
#include <cliext/hash_set>

typedef cliext::hash_multiset<wchar_t> Myhash_multiset;
int main()
    {
    Myhash_multiset c1;
    c1.insert(L'a');
    c1.insert(L'b');
    c1.insert(L'c');

    // display initial contents " a b c"
    for each (wchar_t elem in c1)
        System::Console::Write("{0} ", elem);
    System::Console::WriteLine();

    // inspect first two items
    Myhash_multiset::iterator it = c1.begin();
    System::Console::WriteLine("*begin() = {0}", *it);
    System::Console::WriteLine("*++begin() = {0}", *++it);
    return (0);
    }
```

--------------------------------

### Implement Interface Part in Class Definition

Source: https://learn.microsoft.com/en-us/cpp/mfc/tn038-mfc-ole-iunknown-implementation

Example of starting an interface part definition in a header file.

```cpp
BEGIN_INTERFACE_PART(CMyFrameWindow, IOleInPlaceFrameWindow)
```

--------------------------------

### Build and test commands for simple C example

Source: https://learn.microsoft.com/en-us/cpp/sanitizers/error-stack-use-after-return

Commands to compile and run the simple C example with AddressSanitizer enabled.

```batch
cl example1.cpp /fsanitize=address /fsanitize-address-use-after-return /Zi
set ASAN_OPTIONS=detect_stack_use_after_return=1
devenv /debugexe example1.exe
```

--------------------------------

### Example: Toggling Marquee Animation

Source: https://learn.microsoft.com/en-us/cpp/mfc/reference/cprogressctrl-class

Demonstrates starting and stopping the marquee animation using the SetMarquee method.

```cpp
// Turn the marquee animation on or off.
void CCProgressCtrl_s1Dlg::OnSetmarqueeOn()
{
   m_progressCtrl.SetMarquee(TRUE, nMarqueeInterval);
}

void CCProgressCtrl_s1Dlg::OnSetmarqueeOff()
{
   m_progressCtrl.SetMarquee(FALSE, nMarqueeInterval);
}
```

--------------------------------

### CListBox::FindString Usage

Source: https://learn.microsoft.com/en-us/cpp/mfc/reference/clistbox-class

Example of using FindString to locate and delete items starting with a specific prefix.

```cpp
// The string to match.
LPCTSTR lpszmyString = _T("item");

// Delete all items that begin with the specified string.
int nIndex = 0;
while ((nIndex = m_myListBox.FindString(nIndex, lpszmyString)) != LB_ERR)
{
   m_myListBox.DeleteString(nIndex);
}
```

--------------------------------

### Build a .bsc File from .sbr Files

Source: https://learn.microsoft.com/en-us/cpp/build/reference/bscmake-command-line

Example command to generate a .bsc file named MAIN.bsc using three input .sbr files.

```text
BSCMAKE main.sbr file1.sbr file2.sbr
```

--------------------------------

### Set and Get Hot Cursor Example

Source: https://learn.microsoft.com/en-us/cpp/mfc/reference/clistctrl-class

Demonstrates setting the hot cursor and verifying it using GetHotCursor.

```cpp
// Set the hot cursor to be the system app starting cursor.
HCURSOR hCursor = ::LoadCursor(NULL, IDC_APPSTARTING);
m_myListCtrl.SetHotCursor(hCursor);
ASSERT(m_myListCtrl.GetHotCursor() == hCursor);
```

--------------------------------

### Input for _getch example

Source: https://learn.microsoft.com/en-us/cpp/c-runtime-library/reference/getch-getwch

Sample input provided for the example program.

```text
abcdefy
```

--------------------------------

### Sample output for _utime example

Source: https://learn.microsoft.com/en-us/cpp/c-runtime-library/reference/utime-utime32-utime64-wutime-wutime32-wutime64

Displays the expected console output after running the _utime demonstration program.

```text
Volume in drive C has no label.
Volume Serial Number is 9CAC-DE74

Directory of C:\test

01/09/2003  05:38 PM               935 crt_utime.c
               1 File(s)            935 bytes
               0 Dir(s)  20,742,955,008 bytes free
File time modified
Volume in drive C has no label.
Volume Serial Number is 9CAC-DE74

Directory of C:\test

01/15/2002  12:00 PM               935 crt_utime.c
               1 File(s)            935 bytes
               0 Dir(s)  20,742,955,008 bytes free
```

--------------------------------

### Using _tell to get file position

Source: https://learn.microsoft.com/en-us/cpp/c-runtime-library/reference/tell-telli64

Example demonstrating the use of _tell after a file read operation.

```C
// crt_tell.c
// This program uses _tell to tell the
// file pointer position after a file read.
//

#include <io.h>
#include <stdio.h>
#include <fcntl.h>
#include <share.h>
#include <string.h>

int main( void )
{
   int  fh;
   char buffer[500];

   if ( _sopen_s( &fh, "crt_tell.txt", _O_RDONLY, _SH_DENYNO, 0) )
   {
      char buff[50];
      _strerror_s( buff, sizeof(buff), NULL );
      printf( buff );
      exit( -1 );
   }

   if( _read( fh, buffer, 500 ) > 0 )
      printf( "Current file position is: %d\n", _tell( fh ) );
   _close( fh );
}
```

--------------------------------

### sqrt Example Output

Source: https://learn.microsoft.com/en-us/cpp/standard-library/valarray-functions

Expected console output from the sqrt example.

```text
The initial valarray is: ( 0 1 4 9 16 ).
The square root of the initial valarray is: ( 0 1 2 3 4 ).
```

--------------------------------

### _kbhit Sample Output

Source: https://learn.microsoft.com/en-us/cpp/c-runtime-library/reference/kbhit

The expected output when running the provided example.

```text
Hit me!! Hit me!! Hit me!! Hit me!! Hit me!! Hit me!! Hit me!!
Key struck was 'q'
```

--------------------------------

### to_sys output example

Source: https://learn.microsoft.com/en-us/cpp/standard-library/time-zone-class

Expected output from the to_sys conversion example.

```text
sys_time: 2021-09-15 23:45:00.0000000
```

--------------------------------

### Output of _creat example

Source: https://learn.microsoft.com/en-us/cpp/c-runtime-library/reference/creat-wcreat

The expected console output after successfully running the _creat example.

```text
Created data file.
```

--------------------------------

### Example output

Source: https://learn.microsoft.com/en-us/cpp/standard-library/subrange-class

The expected console output from the subrange conversion example.

```text
2 3 4 5
2:5
```

--------------------------------

### Output of take_view example

Source: https://learn.microsoft.com/en-us/cpp/standard-library/take-view-class

The expected console output when running the take_view example.

```text
0 1 2
0 1 2
```

--------------------------------

### Install Visual C++ Redistributable via Command Line

Source: https://learn.microsoft.com/en-us/cpp/windows/redistributing-visual-cpp-files

Executes the x64 redistributable installer with passive progress display and suppresses automatic restarts.

```batch
vc_redist.x64.exe /install /passive /norestart
```

--------------------------------

### Output of hash_multiset::begin example

Source: https://learn.microsoft.com/en-us/cpp/standard-library/hash-multiset-class

The expected console output after running the hash_multiset::begin example.

```text
The first element of hms1 is 1
The first element of hms1 is now 2
```

--------------------------------

### Get constant iterator to bucket start

Source: https://learn.microsoft.com/en-us/cpp/parallel/concrt/reference/concurrent-unordered-multiset-class

Returns a constant iterator to the first element in the container for a specific bucket.

```cpp
const_local_iterator unsafe_cbegin(size_type _Bucket) const;
```

--------------------------------

### Tuple example output

Source: https://learn.microsoft.com/en-us/cpp/standard-library/tuple-class

Expected output from the tuple usage example.

```text
0 1 2 3
0 1 2 3
x 4
0 1 2 3
4 5 6 7
```

--------------------------------

### Output of clear example

Source: https://learn.microsoft.com/en-us/cpp/standard-library/unordered-set-class

The expected console output after running the clear example.

```text
[c] [b] [a]
size == 0
empty() == true
[e] [d]
size == 2
empty() == false
```

--------------------------------

### Example Output File Content

Source: https://learn.microsoft.com/en-us/cpp/c-runtime-library/reference/fflush

The resulting content of myfile.txt after running the example.

```text
User selected 5
```

--------------------------------

### Parameterized Property Member Functions

Source: https://learn.microsoft.com/en-us/cpp/mfc/tn039-mfc-ole-automation-implementation

Example of the Get and Set member function signatures corresponding to the DISP_PROPERTY_PARAM macro.

```C++
LPDISPATCH CMyObject::GetItem(short row, short col)
void CMyObject::SetItem(short row, short col, LPDISPATCH newValue)
```

--------------------------------

### Example Output

Source: https://learn.microsoft.com/en-us/cpp/standard-library/valarray-operators

The console output generated by the valarray addition example.

```text
The initial Left valarray is: ( 2 -1 2 -1 2 -1 2 -1 ).
The initial Right valarray is: ( 0 1 2 3 4 5 6 7 ).
The element-by-element result of the sum is the
valarray: ( 2 0 4 2 6 4 8 6 ).
```

--------------------------------

### Output of hash_set::begin example

Source: https://learn.microsoft.com/en-us/cpp/standard-library/hash-set-class

The console output resulting from the hash_set::begin example code.

```text
The first element of hs1 is 1
The first element of hs1 is now 2
```

--------------------------------

### Declare complex parameterized property access functions

Source: https://learn.microsoft.com/en-us/cpp/mfc/reference/dispatch-maps

Example declarations for Get and Set functions with three parameters.

```C++
IDispatch* GetItem(SHORT index1, SHORT index2, SHORT index3);
void SetItem(SHORT index1, SHORT index2, SHORT index3, IDispatch* pVal);
```

--------------------------------

### Sample Output for _futime Example

Source: https://learn.microsoft.com/en-us/cpp/c-runtime-library/reference/futime-futime32-futime64

The expected console output after running the _futime example.

```text
Volume in drive Z has no label.
Volume Serial Number is 5C68-57C1

Directory of Z:\crt

03/25/2004  10:40 AM                24 crt_futime.c_input
               1 File(s)             24 bytes
               0 Dir(s)  24,268,476,416 bytes free
Volume in drive Z has no label.
Volume Serial Number is 5C68-57C1

Directory of Z:\crt

03/25/2004  10:41 AM                24 crt_futime.c_input
               1 File(s)             24 bytes
               0 Dir(s)  24,268,476,416 bytes free
File time modified
```

--------------------------------

### CComboBox::GetEditSel

Source: https://learn.microsoft.com/en-us/cpp/mfc/reference/ccombobox-class

Gets the starting and ending character positions of the current selection in the edit control of a combo box.

```APIDOC
## CComboBox::GetEditSel

### Description
Gets the starting and ending character positions of the current selection in the edit control of a combo box.

### Signature
DWORD GetEditSel() const;

### Return Value
A 32-bit value containing the starting position in the low-order word and the position of the first nonselected character after the end of the selection in the high-order word. Returns CB_ERR if the combo box does not have an edit control.
```

--------------------------------

### Value Initialization Examples

Source: https://learn.microsoft.com/en-us/cpp/cpp/initializers

Demonstrates value initialization using empty braces or parentheses.

```cpp
class BaseClass {
private:
    int m_int;
};

int main() {
    BaseClass bc{};     // class is initialized
    BaseClass*  bc2 = new BaseClass();  // class is initialized, m_int value is 0
    int int_arr[3]{};  // value of all members is 0
    int a{};     // value of a is 0
    double b{};  // value of b is 0.00000000000000000
}
```

--------------------------------

### Get Gradient Coordinates

Source: https://learn.microsoft.com/en-us/cpp/mfc/reference/cd2dlineargradientbrush-class

Retrieves the start or end coordinates of the linear gradient in the brush's coordinate space.

```cpp
CD2DPointF GetEndPoint() const;
```

```cpp
CD2DPointF GetStartPoint() const;
```

--------------------------------

### Output of year_month_day_last example

Source: https://learn.microsoft.com/en-us/cpp/standard-library/year-month-day-last-class

The expected console output for the provided year_month_day_last example.

```text
1975/Apr/last
```

--------------------------------

### Reproducing Compiler Error C2776

Source: https://learn.microsoft.com/en-us/cpp/error-messages/compiler-errors-2/compiler-error-c2776

This example demonstrates the invalid declaration of a property with two distinct 'get' methods.

```cpp
// C2776.cpp
struct A {
   __declspec(property(get=GetProp,get=GetPropToo))
   // try the following line instead
   // __declspec(property(get=GetProp))
      int prop;   // C2776
   int GetProp(void);
   int GetPropToo(void);
};
```

--------------------------------

### SetUpByID Method

Source: https://learn.microsoft.com/en-us/cpp/mfc/reference/cpanecontainer-class

Sets up the container using a specific ID.

```cpp
BOOL SetUpByID(
    UINT nID,
    CDockablePane* pBar);
```

--------------------------------

### Example Output for uniform_int_distribution

Source: https://learn.microsoft.com/en-us/cpp/standard-library/uniform-int-distribution-class

Sample console output resulting from the execution of the uniform_int_distribution example code.

```text
Use CTRL-Z to bypass data entry and run using default values.
Enter an integer value for the lower bound of the distribution: 0
Enter an integer value for the upper bound of the distribution: 12
Enter an integer value for the sample count: 200
lower bound == 0
upper bound == 12
Distribution for 200 samples:
    0 :::::::::::::::
    1 :::::::::::::::::::::
    2 ::::::::::::::::::
    3 :::::::::::::::
    4 :::::::
    5 :::::::::::::::::::::
    6 :::::::::::::
    7 ::::::::::
    8 :::::::::::::::
    9 :::::::::::::
   10 ::::::::::::::::::::::
   11 :::::::::::::
   12 :::::::::::::::::
```
Tokens:
Raw