maxmustermann/terminal
1
0
Fork 0
Code Issues Pull requests Projects Releases Wiki Activity
terminal/src/types/utils.cpp
Dustin L. Howett 54a7fce3e0
Move to GSL 3.1.0 (#6908) 
GSL 3, the next major version of GSL after the one we're using, replaced
their local implementation of `span` with one that more closely mimics
C++20's span. Unfortunately, that is a breaking change for all of GSL's
consumers.

This commit updates our use of span to comply with the new changes in
GSL 3.

Chief among those breaking changes is:

* `span::at` no longer exists; I replaced many instances of `span::at`
  with `gsl::at(x)`
* `span::size_type` has finally given up on `ptrdiff_t` and become
  `size_t` like all other containers

While I was here, I also made the following mechanical replacements:

* In some of our "early standardized" code, we used std::optional's
  `has_value` and `value` back-to-back. Each `value` incurs an
  additional presence test.
  * Change: `x.value().member` -> `x->member` (`optional::operator->`
    skips the presence test)
  * Change: `x.value()` -> `*x` (as above)
* GSL 3 uses `size_t` for `size_type`.
  * Change: `gsl::narrow<size_t>(x.size())` -> `x.size()`
  * Change: `gsl::narrow<ptrdiff_t>(nonSpan.size())` -> `nonSpan.size()`
    during span construction

I also replaced two instances of `x[x.size() - 1]` with `x.back()` and
one instance of a manual array walk (for comparison) with a direct
comparison.

NOTE: Span comparison and `make_span` are not part of the C++20 span
library.

Fixes #6251
2020-07-14 18:30:59 +00:00

483 lines
21 KiB
C++
Raw Blame History

// Copyright (c) Microsoft Corporation.
// Licensed under the MIT license.
#include "precomp.h"
#include "inc/utils.hpp"
using namespace Microsoft::Console;
// Function Description:
// - Creates a String representation of a guid, in the format
// "{12345678-ABCD-EF12-3456-7890ABCDEF12}"
// Arguments:
// - guid: the GUID to create the string for
// Return Value:
// - a string representation of the GUID. On failure, throws E_INVALIDARG.
std::wstring Utils::GuidToString(const GUID guid)
{
return wil::str_printf<std::wstring>(L"{%08x-%04x-%04x-%02x%02x-%02x%02x%02x%02x%02x%02x}", guid.Data1, guid.Data2, guid.Data3, guid.Data4[0], guid.Data4[1], guid.Data4[2], guid.Data4[3], guid.Data4[4], guid.Data4[5], guid.Data4[6], guid.Data4[7]);
}
// Method Description:
// - Parses a GUID from a string representation of the GUID. Throws an exception
// if it fails to parse the GUID. See documentation of IIDFromString for
// details.
// Arguments:
// - wstr: a string representation of the GUID to parse
// Return Value:
// - A GUID if the string could successfully be parsed. On failure, throws the
// failing HRESULT.
GUID Utils::GuidFromString(const std::wstring wstr)
{
GUID result{};
THROW_IF_FAILED(IIDFromString(wstr.c_str(), &result));
return result;
}
// Method Description:
// - Creates a GUID, but not via an out parameter.
// Return Value:
// - A GUID if there's enough randomness; otherwise, an exception.
GUID Utils::CreateGuid()
{
GUID result{};
THROW_IF_FAILED(::CoCreateGuid(&result));
return result;
}
// Function Description:
// - Creates a String representation of a color, in the format "#RRGGBB"
// Arguments:
// - color: the COLORREF to create the string for
// Return Value:
// - a string representation of the color
std::string Utils::ColorToHexString(const til::color color)
{
std::stringstream ss;
ss << "#" << std::uppercase << std::setfill('0') << std::hex;
// Force the compiler to promote from byte to int. Without it, the
// stringstream will try to write the components as chars
ss << std::setw(2) << static_cast<int>(color.r);
ss << std::setw(2) << static_cast<int>(color.g);
ss << std::setw(2) << static_cast<int>(color.b);
return ss.str();
}
// Function Description:
// - Parses a color from a string. The string should be in the format "#RRGGBB" or "#RGB"
// Arguments:
// - str: a string representation of the COLORREF to parse
// Return Value:
// - A COLORREF if the string could successfully be parsed. If the string is not
// the correct format, throws E_INVALIDARG
til::color Utils::ColorFromHexString(const std::string_view str)
{
THROW_HR_IF(E_INVALIDARG, str.size() != 7 && str.size() != 4);
THROW_HR_IF(E_INVALIDARG, str.at(0) != '#');
std::string rStr;
std::string gStr;
std::string bStr;
if (str.size() == 4)
{
rStr = std::string(2, str.at(1));
gStr = std::string(2, str.at(2));
bStr = std::string(2, str.at(3));
}
else
{
rStr = std::string(&str.at(1), 2);
gStr = std::string(&str.at(3), 2);
bStr = std::string(&str.at(5), 2);
}
const BYTE r = gsl::narrow_cast<BYTE>(std::stoul(rStr, nullptr, 16));
const BYTE g = gsl::narrow_cast<BYTE>(std::stoul(gStr, nullptr, 16));
const BYTE b = gsl::narrow_cast<BYTE>(std::stoul(bStr, nullptr, 16));
return til::color{ r, g, b };
}
// Routine Description:
// - Shorthand check if a handle value is null or invalid.
// Arguments:
// - Handle
// Return Value:
// - True if non zero and not set to invalid magic value. False otherwise.
bool Utils::IsValidHandle(const HANDLE handle) noexcept
{
return handle != nullptr && handle != INVALID_HANDLE_VALUE;
}
// Function Description:
// - Fill the first 16 entries of a given color table with the Campbell color
// scheme, in the ANSI/VT RGB order.
// Arguments:
// - table: a color table with at least 16 entries
// Return Value:
// - <none>, throws if the table has less that 16 entries
void Utils::InitializeCampbellColorTable(const gsl::span<COLORREF> table)
{
THROW_HR_IF(E_INVALIDARG, table.size() < 16);
// clang-format off
gsl::at(table, 0) = RGB(12, 12, 12);
gsl::at(table, 1) = RGB(197, 15, 31);
gsl::at(table, 2) = RGB(19, 161, 14);
gsl::at(table, 3) = RGB(193, 156, 0);
gsl::at(table, 4) = RGB(0, 55, 218);
gsl::at(table, 5) = RGB(136, 23, 152);
gsl::at(table, 6) = RGB(58, 150, 221);
gsl::at(table, 7) = RGB(204, 204, 204);
gsl::at(table, 8) = RGB(118, 118, 118);
gsl::at(table, 9) = RGB(231, 72, 86);
gsl::at(table, 10) = RGB(22, 198, 12);
gsl::at(table, 11) = RGB(249, 241, 165);
gsl::at(table, 12) = RGB(59, 120, 255);
gsl::at(table, 13) = RGB(180, 0, 158);
gsl::at(table, 14) = RGB(97, 214, 214);
gsl::at(table, 15) = RGB(242, 242, 242);
// clang-format on
}
// Function Description:
// - Fill the first 16 entries of a given color table with the Campbell color
// scheme, in the Windows BGR order.
// Arguments:
// - table: a color table with at least 16 entries
// Return Value:
// - <none>, throws if the table has less that 16 entries
void Utils::InitializeCampbellColorTableForConhost(const gsl::span<COLORREF> table)
{
THROW_HR_IF(E_INVALIDARG, table.size() < 16);
InitializeCampbellColorTable(table);
SwapANSIColorOrderForConhost(table);
}
// Function Description:
// - modifies in-place the given color table from ANSI (RGB) order to Console order (BRG).
// Arguments:
// - table: a color table with at least 16 entries
// Return Value:
// - <none>, throws if the table has less that 16 entries
void Utils::SwapANSIColorOrderForConhost(const gsl::span<COLORREF> table)
{
THROW_HR_IF(E_INVALIDARG, table.size() < 16);
std::swap(gsl::at(table, 1), gsl::at(table, 4));
std::swap(gsl::at(table, 3), gsl::at(table, 6));
std::swap(gsl::at(table, 9), gsl::at(table, 12));
std::swap(gsl::at(table, 11), gsl::at(table, 14));
}
// Function Description:
// - Fill the first 255 entries of a given color table with the default values
// of a full 256-color table
// Arguments:
// - table: a color table with at least 256 entries
// Return Value:
// - <none>, throws if the table has less that 256 entries
void Utils::Initialize256ColorTable(const gsl::span<COLORREF> table)
{
THROW_HR_IF(E_INVALIDARG, table.size() < 256);
// clang-format off
gsl::at(table, 0) = RGB(0x00, 0x00, 0x00);
gsl::at(table, 1) = RGB(0x80, 0x00, 0x00);
gsl::at(table, 2) = RGB(0x00, 0x80, 0x00);
gsl::at(table, 3) = RGB(0x80, 0x80, 0x00);
gsl::at(table, 4) = RGB(0x00, 0x00, 0x80);
gsl::at(table, 5) = RGB(0x80, 0x00, 0x80);
gsl::at(table, 6) = RGB(0x00, 0x80, 0x80);
gsl::at(table, 7) = RGB(0xc0, 0xc0, 0xc0);
gsl::at(table, 8) = RGB(0x80, 0x80, 0x80);
gsl::at(table, 9) = RGB(0xff, 0x00, 0x00);
gsl::at(table, 10) = RGB(0x00, 0xff, 0x00);
gsl::at(table, 11) = RGB(0xff, 0xff, 0x00);
gsl::at(table, 12) = RGB(0x00, 0x00, 0xff);
gsl::at(table, 13) = RGB(0xff, 0x00, 0xff);
gsl::at(table, 14) = RGB(0x00, 0xff, 0xff);
gsl::at(table, 15) = RGB(0xff, 0xff, 0xff);
gsl::at(table, 16) = RGB(0x00, 0x00, 0x00);
gsl::at(table, 17) = RGB(0x00, 0x00, 0x5f);
gsl::at(table, 18) = RGB(0x00, 0x00, 0x87);
gsl::at(table, 19) = RGB(0x00, 0x00, 0xaf);
gsl::at(table, 20) = RGB(0x00, 0x00, 0xd7);
gsl::at(table, 21) = RGB(0x00, 0x00, 0xff);
gsl::at(table, 22) = RGB(0x00, 0x5f, 0x00);
gsl::at(table, 23) = RGB(0x00, 0x5f, 0x5f);
gsl::at(table, 24) = RGB(0x00, 0x5f, 0x87);
gsl::at(table, 25) = RGB(0x00, 0x5f, 0xaf);
gsl::at(table, 26) = RGB(0x00, 0x5f, 0xd7);
gsl::at(table, 27) = RGB(0x00, 0x5f, 0xff);
gsl::at(table, 28) = RGB(0x00, 0x87, 0x00);
gsl::at(table, 29) = RGB(0x00, 0x87, 0x5f);
gsl::at(table, 30) = RGB(0x00, 0x87, 0x87);
gsl::at(table, 31) = RGB(0x00, 0x87, 0xaf);
gsl::at(table, 32) = RGB(0x00, 0x87, 0xd7);
gsl::at(table, 33) = RGB(0x00, 0x87, 0xff);
gsl::at(table, 34) = RGB(0x00, 0xaf, 0x00);
gsl::at(table, 35) = RGB(0x00, 0xaf, 0x5f);
gsl::at(table, 36) = RGB(0x00, 0xaf, 0x87);
gsl::at(table, 37) = RGB(0x00, 0xaf, 0xaf);
gsl::at(table, 38) = RGB(0x00, 0xaf, 0xd7);
gsl::at(table, 39) = RGB(0x00, 0xaf, 0xff);
gsl::at(table, 40) = RGB(0x00, 0xd7, 0x00);
gsl::at(table, 41) = RGB(0x00, 0xd7, 0x5f);
gsl::at(table, 42) = RGB(0x00, 0xd7, 0x87);
gsl::at(table, 43) = RGB(0x00, 0xd7, 0xaf);
gsl::at(table, 44) = RGB(0x00, 0xd7, 0xd7);
gsl::at(table, 45) = RGB(0x00, 0xd7, 0xff);
gsl::at(table, 46) = RGB(0x00, 0xff, 0x00);
gsl::at(table, 47) = RGB(0x00, 0xff, 0x5f);
gsl::at(table, 48) = RGB(0x00, 0xff, 0x87);
gsl::at(table, 49) = RGB(0x00, 0xff, 0xaf);
gsl::at(table, 50) = RGB(0x00, 0xff, 0xd7);
gsl::at(table, 51) = RGB(0x00, 0xff, 0xff);
gsl::at(table, 52) = RGB(0x5f, 0x00, 0x00);
gsl::at(table, 53) = RGB(0x5f, 0x00, 0x5f);
gsl::at(table, 54) = RGB(0x5f, 0x00, 0x87);
gsl::at(table, 55) = RGB(0x5f, 0x00, 0xaf);
gsl::at(table, 56) = RGB(0x5f, 0x00, 0xd7);
gsl::at(table, 57) = RGB(0x5f, 0x00, 0xff);
gsl::at(table, 58) = RGB(0x5f, 0x5f, 0x00);
gsl::at(table, 59) = RGB(0x5f, 0x5f, 0x5f);
gsl::at(table, 60) = RGB(0x5f, 0x5f, 0x87);
gsl::at(table, 61) = RGB(0x5f, 0x5f, 0xaf);
gsl::at(table, 62) = RGB(0x5f, 0x5f, 0xd7);
gsl::at(table, 63) = RGB(0x5f, 0x5f, 0xff);
gsl::at(table, 64) = RGB(0x5f, 0x87, 0x00);
gsl::at(table, 65) = RGB(0x5f, 0x87, 0x5f);
gsl::at(table, 66) = RGB(0x5f, 0x87, 0x87);
gsl::at(table, 67) = RGB(0x5f, 0x87, 0xaf);
gsl::at(table, 68) = RGB(0x5f, 0x87, 0xd7);
gsl::at(table, 69) = RGB(0x5f, 0x87, 0xff);
gsl::at(table, 70) = RGB(0x5f, 0xaf, 0x00);
gsl::at(table, 71) = RGB(0x5f, 0xaf, 0x5f);
gsl::at(table, 72) = RGB(0x5f, 0xaf, 0x87);
gsl::at(table, 73) = RGB(0x5f, 0xaf, 0xaf);
gsl::at(table, 74) = RGB(0x5f, 0xaf, 0xd7);
gsl::at(table, 75) = RGB(0x5f, 0xaf, 0xff);
gsl::at(table, 76) = RGB(0x5f, 0xd7, 0x00);
gsl::at(table, 77) = RGB(0x5f, 0xd7, 0x5f);
gsl::at(table, 78) = RGB(0x5f, 0xd7, 0x87);
gsl::at(table, 79) = RGB(0x5f, 0xd7, 0xaf);
gsl::at(table, 80) = RGB(0x5f, 0xd7, 0xd7);
gsl::at(table, 81) = RGB(0x5f, 0xd7, 0xff);
gsl::at(table, 82) = RGB(0x5f, 0xff, 0x00);
gsl::at(table, 83) = RGB(0x5f, 0xff, 0x5f);
gsl::at(table, 84) = RGB(0x5f, 0xff, 0x87);
gsl::at(table, 85) = RGB(0x5f, 0xff, 0xaf);
gsl::at(table, 86) = RGB(0x5f, 0xff, 0xd7);
gsl::at(table, 87) = RGB(0x5f, 0xff, 0xff);
gsl::at(table, 88) = RGB(0x87, 0x00, 0x00);
gsl::at(table, 89) = RGB(0x87, 0x00, 0x5f);
gsl::at(table, 90) = RGB(0x87, 0x00, 0x87);
gsl::at(table, 91) = RGB(0x87, 0x00, 0xaf);
gsl::at(table, 92) = RGB(0x87, 0x00, 0xd7);
gsl::at(table, 93) = RGB(0x87, 0x00, 0xff);
gsl::at(table, 94) = RGB(0x87, 0x5f, 0x00);
gsl::at(table, 95) = RGB(0x87, 0x5f, 0x5f);
gsl::at(table, 96) = RGB(0x87, 0x5f, 0x87);
gsl::at(table, 97) = RGB(0x87, 0x5f, 0xaf);
gsl::at(table, 98) = RGB(0x87, 0x5f, 0xd7);
gsl::at(table, 99) = RGB(0x87, 0x5f, 0xff);
gsl::at(table, 100) = RGB(0x87, 0x87, 0x00);
gsl::at(table, 101) = RGB(0x87, 0x87, 0x5f);
gsl::at(table, 102) = RGB(0x87, 0x87, 0x87);
gsl::at(table, 103) = RGB(0x87, 0x87, 0xaf);
gsl::at(table, 104) = RGB(0x87, 0x87, 0xd7);
gsl::at(table, 105) = RGB(0x87, 0x87, 0xff);
gsl::at(table, 106) = RGB(0x87, 0xaf, 0x00);
gsl::at(table, 107) = RGB(0x87, 0xaf, 0x5f);
gsl::at(table, 108) = RGB(0x87, 0xaf, 0x87);
gsl::at(table, 109) = RGB(0x87, 0xaf, 0xaf);
gsl::at(table, 110) = RGB(0x87, 0xaf, 0xd7);
gsl::at(table, 111) = RGB(0x87, 0xaf, 0xff);
gsl::at(table, 112) = RGB(0x87, 0xd7, 0x00);
gsl::at(table, 113) = RGB(0x87, 0xd7, 0x5f);
gsl::at(table, 114) = RGB(0x87, 0xd7, 0x87);
gsl::at(table, 115) = RGB(0x87, 0xd7, 0xaf);
gsl::at(table, 116) = RGB(0x87, 0xd7, 0xd7);
gsl::at(table, 117) = RGB(0x87, 0xd7, 0xff);
gsl::at(table, 118) = RGB(0x87, 0xff, 0x00);
gsl::at(table, 119) = RGB(0x87, 0xff, 0x5f);
gsl::at(table, 120) = RGB(0x87, 0xff, 0x87);
gsl::at(table, 121) = RGB(0x87, 0xff, 0xaf);
gsl::at(table, 122) = RGB(0x87, 0xff, 0xd7);
gsl::at(table, 123) = RGB(0x87, 0xff, 0xff);
gsl::at(table, 124) = RGB(0xaf, 0x00, 0x00);
gsl::at(table, 125) = RGB(0xaf, 0x00, 0x5f);
gsl::at(table, 126) = RGB(0xaf, 0x00, 0x87);
gsl::at(table, 127) = RGB(0xaf, 0x00, 0xaf);
gsl::at(table, 128) = RGB(0xaf, 0x00, 0xd7);
gsl::at(table, 129) = RGB(0xaf, 0x00, 0xff);
gsl::at(table, 130) = RGB(0xaf, 0x5f, 0x00);
gsl::at(table, 131) = RGB(0xaf, 0x5f, 0x5f);
gsl::at(table, 132) = RGB(0xaf, 0x5f, 0x87);
gsl::at(table, 133) = RGB(0xaf, 0x5f, 0xaf);
gsl::at(table, 134) = RGB(0xaf, 0x5f, 0xd7);
gsl::at(table, 135) = RGB(0xaf, 0x5f, 0xff);
gsl::at(table, 136) = RGB(0xaf, 0x87, 0x00);
gsl::at(table, 137) = RGB(0xaf, 0x87, 0x5f);
gsl::at(table, 138) = RGB(0xaf, 0x87, 0x87);
gsl::at(table, 139) = RGB(0xaf, 0x87, 0xaf);
gsl::at(table, 140) = RGB(0xaf, 0x87, 0xd7);
gsl::at(table, 141) = RGB(0xaf, 0x87, 0xff);
gsl::at(table, 142) = RGB(0xaf, 0xaf, 0x00);
gsl::at(table, 143) = RGB(0xaf, 0xaf, 0x5f);
gsl::at(table, 144) = RGB(0xaf, 0xaf, 0x87);
gsl::at(table, 145) = RGB(0xaf, 0xaf, 0xaf);
gsl::at(table, 146) = RGB(0xaf, 0xaf, 0xd7);
gsl::at(table, 147) = RGB(0xaf, 0xaf, 0xff);
gsl::at(table, 148) = RGB(0xaf, 0xd7, 0x00);
gsl::at(table, 149) = RGB(0xaf, 0xd7, 0x5f);
gsl::at(table, 150) = RGB(0xaf, 0xd7, 0x87);
gsl::at(table, 151) = RGB(0xaf, 0xd7, 0xaf);
gsl::at(table, 152) = RGB(0xaf, 0xd7, 0xd7);
gsl::at(table, 153) = RGB(0xaf, 0xd7, 0xff);
gsl::at(table, 154) = RGB(0xaf, 0xff, 0x00);
gsl::at(table, 155) = RGB(0xaf, 0xff, 0x5f);
gsl::at(table, 156) = RGB(0xaf, 0xff, 0x87);
gsl::at(table, 157) = RGB(0xaf, 0xff, 0xaf);
gsl::at(table, 158) = RGB(0xaf, 0xff, 0xd7);
gsl::at(table, 159) = RGB(0xaf, 0xff, 0xff);
gsl::at(table, 160) = RGB(0xd7, 0x00, 0x00);
gsl::at(table, 161) = RGB(0xd7, 0x00, 0x5f);
gsl::at(table, 162) = RGB(0xd7, 0x00, 0x87);
gsl::at(table, 163) = RGB(0xd7, 0x00, 0xaf);
gsl::at(table, 164) = RGB(0xd7, 0x00, 0xd7);
gsl::at(table, 165) = RGB(0xd7, 0x00, 0xff);
gsl::at(table, 166) = RGB(0xd7, 0x5f, 0x00);
gsl::at(table, 167) = RGB(0xd7, 0x5f, 0x5f);
gsl::at(table, 168) = RGB(0xd7, 0x5f, 0x87);
gsl::at(table, 169) = RGB(0xd7, 0x5f, 0xaf);
gsl::at(table, 170) = RGB(0xd7, 0x5f, 0xd7);
gsl::at(table, 171) = RGB(0xd7, 0x5f, 0xff);
gsl::at(table, 172) = RGB(0xd7, 0x87, 0x00);
gsl::at(table, 173) = RGB(0xd7, 0x87, 0x5f);
gsl::at(table, 174) = RGB(0xd7, 0x87, 0x87);
gsl::at(table, 175) = RGB(0xd7, 0x87, 0xaf);
gsl::at(table, 176) = RGB(0xd7, 0x87, 0xd7);
gsl::at(table, 177) = RGB(0xd7, 0x87, 0xff);
gsl::at(table, 178) = RGB(0xd7, 0xaf, 0x00);
gsl::at(table, 179) = RGB(0xd7, 0xaf, 0x5f);
gsl::at(table, 180) = RGB(0xd7, 0xaf, 0x87);
gsl::at(table, 181) = RGB(0xd7, 0xaf, 0xaf);
gsl::at(table, 182) = RGB(0xd7, 0xaf, 0xd7);
gsl::at(table, 183) = RGB(0xd7, 0xaf, 0xff);
gsl::at(table, 184) = RGB(0xd7, 0xd7, 0x00);
gsl::at(table, 185) = RGB(0xd7, 0xd7, 0x5f);
gsl::at(table, 186) = RGB(0xd7, 0xd7, 0x87);
gsl::at(table, 187) = RGB(0xd7, 0xd7, 0xaf);
gsl::at(table, 188) = RGB(0xd7, 0xd7, 0xd7);
gsl::at(table, 189) = RGB(0xd7, 0xd7, 0xff);
gsl::at(table, 190) = RGB(0xd7, 0xff, 0x00);
gsl::at(table, 191) = RGB(0xd7, 0xff, 0x5f);
gsl::at(table, 192) = RGB(0xd7, 0xff, 0x87);
gsl::at(table, 193) = RGB(0xd7, 0xff, 0xaf);
gsl::at(table, 194) = RGB(0xd7, 0xff, 0xd7);
gsl::at(table, 195) = RGB(0xd7, 0xff, 0xff);
gsl::at(table, 196) = RGB(0xff, 0x00, 0x00);
gsl::at(table, 197) = RGB(0xff, 0x00, 0x5f);
gsl::at(table, 198) = RGB(0xff, 0x00, 0x87);
gsl::at(table, 199) = RGB(0xff, 0x00, 0xaf);
gsl::at(table, 200) = RGB(0xff, 0x00, 0xd7);
gsl::at(table, 201) = RGB(0xff, 0x00, 0xff);
gsl::at(table, 202) = RGB(0xff, 0x5f, 0x00);
gsl::at(table, 203) = RGB(0xff, 0x5f, 0x5f);
gsl::at(table, 204) = RGB(0xff, 0x5f, 0x87);
gsl::at(table, 205) = RGB(0xff, 0x5f, 0xaf);
gsl::at(table, 206) = RGB(0xff, 0x5f, 0xd7);
gsl::at(table, 207) = RGB(0xff, 0x5f, 0xff);
gsl::at(table, 208) = RGB(0xff, 0x87, 0x00);
gsl::at(table, 209) = RGB(0xff, 0x87, 0x5f);
gsl::at(table, 210) = RGB(0xff, 0x87, 0x87);
gsl::at(table, 211) = RGB(0xff, 0x87, 0xaf);
gsl::at(table, 212) = RGB(0xff, 0x87, 0xd7);
gsl::at(table, 213) = RGB(0xff, 0x87, 0xff);
gsl::at(table, 214) = RGB(0xff, 0xaf, 0x00);
gsl::at(table, 215) = RGB(0xff, 0xaf, 0x5f);
gsl::at(table, 216) = RGB(0xff, 0xaf, 0x87);
gsl::at(table, 217) = RGB(0xff, 0xaf, 0xaf);
gsl::at(table, 218) = RGB(0xff, 0xaf, 0xd7);
gsl::at(table, 219) = RGB(0xff, 0xaf, 0xff);
gsl::at(table, 220) = RGB(0xff, 0xd7, 0x00);
gsl::at(table, 221) = RGB(0xff, 0xd7, 0x5f);
gsl::at(table, 222) = RGB(0xff, 0xd7, 0x87);
gsl::at(table, 223) = RGB(0xff, 0xd7, 0xaf);
gsl::at(table, 224) = RGB(0xff, 0xd7, 0xd7);
gsl::at(table, 225) = RGB(0xff, 0xd7, 0xff);
gsl::at(table, 226) = RGB(0xff, 0xff, 0x00);
gsl::at(table, 227) = RGB(0xff, 0xff, 0x5f);
gsl::at(table, 228) = RGB(0xff, 0xff, 0x87);
gsl::at(table, 229) = RGB(0xff, 0xff, 0xaf);
gsl::at(table, 230) = RGB(0xff, 0xff, 0xd7);
gsl::at(table, 231) = RGB(0xff, 0xff, 0xff);
gsl::at(table, 232) = RGB(0x08, 0x08, 0x08);
gsl::at(table, 233) = RGB(0x12, 0x12, 0x12);
gsl::at(table, 234) = RGB(0x1c, 0x1c, 0x1c);
gsl::at(table, 235) = RGB(0x26, 0x26, 0x26);
gsl::at(table, 236) = RGB(0x30, 0x30, 0x30);
gsl::at(table, 237) = RGB(0x3a, 0x3a, 0x3a);
gsl::at(table, 238) = RGB(0x44, 0x44, 0x44);
gsl::at(table, 239) = RGB(0x4e, 0x4e, 0x4e);
gsl::at(table, 240) = RGB(0x58, 0x58, 0x58);
gsl::at(table, 241) = RGB(0x62, 0x62, 0x62);
gsl::at(table, 242) = RGB(0x6c, 0x6c, 0x6c);
gsl::at(table, 243) = RGB(0x76, 0x76, 0x76);
gsl::at(table, 244) = RGB(0x80, 0x80, 0x80);
gsl::at(table, 245) = RGB(0x8a, 0x8a, 0x8a);
gsl::at(table, 246) = RGB(0x94, 0x94, 0x94);
gsl::at(table, 247) = RGB(0x9e, 0x9e, 0x9e);
gsl::at(table, 248) = RGB(0xa8, 0xa8, 0xa8);
gsl::at(table, 249) = RGB(0xb2, 0xb2, 0xb2);
gsl::at(table, 250) = RGB(0xbc, 0xbc, 0xbc);
gsl::at(table, 251) = RGB(0xc6, 0xc6, 0xc6);
gsl::at(table, 252) = RGB(0xd0, 0xd0, 0xd0);
gsl::at(table, 253) = RGB(0xda, 0xda, 0xda);
gsl::at(table, 254) = RGB(0xe4, 0xe4, 0xe4);
gsl::at(table, 255) = RGB(0xee, 0xee, 0xee);
// clang-format on
}
// Function Description:
// - Generate a Version 5 UUID (specified in RFC4122 4.3)
// v5 UUIDs are stable given the same namespace and "name".
// Arguments:
// - namespaceGuid: The GUID of the v5 UUID namespace, which provides both
// a seed and a tacit agreement that all UUIDs generated
// with it will follow the same data format.
// - name: Bytes comprising the name (in a namespace-specific format)
// Return Value:
// - a new stable v5 UUID
GUID Utils::CreateV5Uuid(const GUID& namespaceGuid, const gsl::span<const gsl::byte> name)
{
// v5 uuid generation happens over values in network byte order, so let's enforce that
auto correctEndianNamespaceGuid{ EndianSwap(namespaceGuid) };
wil::unique_bcrypt_hash hash;
THROW_IF_NTSTATUS_FAILED(BCryptCreateHash(BCRYPT_SHA1_ALG_HANDLE, &hash, nullptr, 0, nullptr, 0, 0));
// According to N4713 8.2.1.11 [basic.lval], accessing the bytes underlying an object
// through unsigned char or char pointer *is defined*.
THROW_IF_NTSTATUS_FAILED(BCryptHashData(hash.get(), reinterpret_cast<PUCHAR>(&correctEndianNamespaceGuid), sizeof(GUID), 0));
// BCryptHashData is ill-specified in that it leaves off "const" qualification for pbInput
THROW_IF_NTSTATUS_FAILED(BCryptHashData(hash.get(), reinterpret_cast<PUCHAR>(const_cast<gsl::byte*>(name.data())), gsl::narrow<ULONG>(name.size()), 0));
std::array<uint8_t, 20> buffer;
THROW_IF_NTSTATUS_FAILED(BCryptFinishHash(hash.get(), buffer.data(), gsl::narrow<ULONG>(buffer.size()), 0));
buffer.at(6) = (buffer.at(6) & 0x0F) | 0x50; // set the uuid version to 5
buffer.at(8) = (buffer.at(8) & 0x3F) | 0x80; // set the variant to 2 (RFC4122)
// We're using memcpy here pursuant to N4713 6.7.2/3 [basic.types],
// "...the underlying bytes making up the object can be copied into an array
// of char or unsigned char...array is copied back into the object..."
// std::copy may compile down to ::memcpy for these types, but using it might
// contravene the standard and nobody's got time for that.
GUID newGuid{ 0 };
::memcpy_s(&newGuid, sizeof(GUID), buffer.data(), sizeof(GUID));
return EndianSwap(newGuid);
}
Reference in a new issue View git blame Copy permalink