winrt:: hstring struct (C++/WinRT)winrt::hstring struct (C++/WinRT)

Uma coleção sequencial de caracteres Unicode UTF-16 que representa uma cadeia de texto.A sequential collection of UTF-16 Unicode characters representing a text string. Para obter mais exemplos e informações sobre o winrt:: hstring, consulte manipulação de cadeia de caracteres em C++/WinRT.For more examples and info about winrt::hstring, see String handling in C++/WinRT. O tipo winrt:: hstring encapsula hstring por trás de uma interface semelhante à de std:: wstring.The winrt::hstring type encapsulates HSTRING behind an interface similar to that of std::wstring. Um HSTRING é um identificador para uma cadeia de caracteres Windows Runtime.A HSTRING is a handle to a Windows Runtime string.

SyntaxSyntax

struct hstring

RequisitosRequirements

SDK mínimo com suporte: SDK do Windows versão 10.0.17134.0 (Windows 10, versão 1803)Minimum supported SDK: Windows SDK version 10.0.17134.0 (Windows 10, version 1803)

Namespace: winrtNamespace: winrt

O cabeçalho % WindowsSdkDir% inclui <WindowsTargetPlatformVersion> \cppwinrt\winrt\base.h (incluído por padrão)Header %WindowsSdkDir%Include<WindowsTargetPlatformVersion>\cppwinrt\winrt\base.h (included by default)

Aliases de tipo de membroMember type aliases

Nome do aliasAlias name TipoType
hstring:: value_typehstring::value_type Um sinônimo para wchar_t.A synonym for wchar_t.
hstring:: size_typehstring::size_type Um sinônimo para uint32_t.A synonym for uint32_t.
hstring:: const_referencehstring::const_reference Um sinônimo para hstring:: value_type const&.A synonym for hstring::value_type const&.
hstring:: const_pointerhstring::const_pointer Um sinônimo para **hstring:: value_type const * **.A synonym for hstring::value_type const*.
hstring:: const_iteratorhstring::const_iterator Um sinônimo para hstring:: const_pointer.A synonym for hstring::const_pointer.
hstring:: const_reverse_iteratorhstring::const_reverse_iterator Um sinônimo para **std:: reverse_iterator <hstring::const_iterator> **.A synonym for std::reverse_iterator<hstring::const_iterator>.

ConstrutoresConstructors

ConstrutorConstructor DescriçãoDescription
Construtor hstring:: hstringhstring::hstring constructor Inicializa uma nova instância do struct hstring com uma cópia dos dados da cadeia de caracteres de entrada.Initializes a new instance of the hstring struct with a copy of the input string data.

Funções de membroMember functions

FunçãoFunction DescriçãoDescription
função hstring:: backhstring::back function Retorna uma referência ao último caractere no objeto hstring .Returns a reference to the last character in the hstring object.
função hstring:: Beginhstring::begin function Retorna um iterador const para o primeiro caractere no objeto hstring .Returns a const iterator to the first character in the hstring object.
função hstring:: c_strhstring::c_str function Retorna um ponteiro para a cadeia de caracteres de estilo C terminada em nulo subjacente dos personagens no objeto hstring ; nenhuma cópia é feita.Returns a pointer to the underlying null-terminated C-style string of the characters in the hstring object; no copy is made.
função hstring:: cbeginhstring::cbegin function Retorna um iterador const para o primeiro caractere no objeto hstring .Returns a const iterator to the first character in the hstring object.
função hstring:: cendhstring::cend function Retorna um iterador const para um após o final de (um após o último caractere) do objeto hstring .Returns a const iterator to one beyond the end of (one beyond the last character in) the hstring object.
função hstring:: Clearhstring::clear function Torna o objeto hstring vazio.Makes the hstring object empty.
função hstring:: crbeginhstring::crbegin function Retorna um iterador reverso const para um após o final de (um além do último caractere no) objeto hstring .Returns a const reverse iterator to one beyond the end of (one beyond the last character in) the hstring object.
função hstring:: crendhstring::crend function Retorna um iterador reverso const para o primeiro caractere no objeto hstring .Returns a const reverse iterator to the first character in the hstring object.
hstring::d função do ATAhstring::data function Retorna uma versão de cadeia de caracteres de estilo C terminada em nulo dos personagens no objeto hstring .Returns a null-terminated C-style string version of the characters in the hstring object.
função hstring:: Emptyhstring::empty function Retorna um valor que indica se o objeto hstring está vazio.Returns a value indicating whether the hstring object is empty.
função hstring:: Endhstring::end function Retorna um iterador const para um após o final de (um após o último caractere) do objeto hstring .Returns a const iterator to one beyond the end of (one beyond the last character in) the hstring object.
função hstring:: fronthstring::front function Retorna uma referência ao primeiro caractere no objeto hstring .Returns a reference to the first character in the hstring object.
função hstring:: rbeginhstring::rbegin function Retorna um iterador reverso const para um após o final de (um além do último caractere no) objeto hstring .Returns a const reverse iterator to one beyond the end of (one beyond the last character in) the hstring object.
função hstring:: rendhstring::rend function Retorna um iterador reverso const para o primeiro caractere no objeto hstring .Returns a const reverse iterator to the first character in the hstring object.
função hstring:: Sizehstring::size function Retorna o número de caracteres no objeto hstring .Returns the number of characters in the hstring object.

Operadores de membroMember operators

OperadorOperator DescriçãoDescription
hstring:: Operator std:: wstring_viewhstring::operator std::wstring_view Converte o objeto hstring em um std:: wstring_view.Converts the hstring object to a std::wstring_view.
operador hstring:: operator [] ( subscrito))hstring::operator[] (subscript operator)) Retorna uma referência ao caractere na posição especificada dentro do objeto hstring .Returns a reference to the character at the specified position within the hstring object.
hstring:: Operator = (operador de atribuição)hstring::operator= (assignment operator) Atribui um valor ao objeto hstring .Assigns a value to the hstring object.

Funções gratuitasFree functions

FunçãoFunction DescriçãoDescription
função attach_abiattach_abi function Anexa um objeto hstring a um identificador para uma Windows Runtime cadeia de caracteres.Attaches a hstring object to a handle to a Windows Runtime string.
função copy_from_abicopy_from_abi function Copia para um objeto hstring de um identificador para uma Windows Runtime cadeia de caracteres.Copies to a hstring object from a handle to a Windows Runtime string. Limpa o hstring, copia o parâmetro e começa a gerenciar o identificador.Clears the hstring, copies the parameter, and begins managing the handle.
função copy_to_abicopy_to_abi function Copia para um identificador para uma cadeia de Windows Runtime de um objeto hstring .Copies to a handle to a Windows Runtime string from a hstring object.
função detach_abidetach_abi function Desanexa um objeto hstring de seu identificador, talvez para retorná-lo a um chamador.Detaches a hstring object from its handle, perhaps to return it to a caller.
função to_hstringto_hstring function Converte um valor de entrada em um winrt:: hstring que contém a representação de cadeia de caracteres do valor.Converts an input value to a winrt::hstring containing the value's string representation.

Operadores gratuitosFree operators

OperadorOperator DescriçãoDescription
operador! = (operador de desigualdade)operator!= (inequality operator) Retorna um valor que indica se os dois parâmetros são diferentes um do outro.Returns a value indicating whether the two parameters are unequal to one another.
operador + (operador de concatenação)operator+ (concatenation operator) Retorna um novo objeto hstring resultante da concatenação dos dois parâmetros.Returns a new hstring object resulting from concatenating the two parameters together.
operador< (operador menor que)operator< (less-than operator) Retorna um valor que indica se o primeiro parâmetro é menor que o segundo parâmetro.Returns a value indicating whether the first parameter is less than the second parameter.
operador<= (operador menor que ou-igual a)operator<= (less-than-or-equal-to operator) Retorna um valor que indica se o primeiro parâmetro é menor ou igual ao segundo parâmetro.Returns a value indicating whether the first parameter is less than or equal to the second parameter.
Operator = = (operador de igualdade)operator== (equality operator) Retorna um valor que indica se os dois parâmetros são iguais um do outro.Returns a value indicating whether the two parameters are equal to one another.
operador> (operador maior que)operator> (greater-than operator) Retorna um valor que indica se o primeiro parâmetro é maior que o segundo parâmetro.Returns a value indicating whether the first parameter is greater than the second parameter.
operador>= (operador maior que ou-igual a)operator>= (greater-than-or-equal-to operator) Retorna um valor que indica se o primeiro parâmetro é maior ou igual ao segundo parâmetro.Returns a value indicating whether the first parameter is greater than or equal to the second parameter.

IteratorsIterators

Um hstring é um intervalo, e esse intervalo é definido pelas funções de membro hstring:: Begin e hstring:: End , cada um deles retorna um iterador const (como do hstring:: cbegin e hstring:: cend).An hstring is a range, and that range is defined by the hstring::begin and hstring::end member functions, each of which returns a const iterator (as do hstring::cbegin and hstring::cend). Por isso, você pode enumerar os caracteres em um objeto hstring com uma instrução baseada em intervalo for ou com a função de modelo std:: for_each .Because of this, you can enumerate the characters in an hstring object with either a range-based for statement, or with the std::for_each template function.

#include <iostream>
using namespace winrt;
...
void Iterators(hstring const& theHstring)
{
    for (auto const& element : theHstring)
    {
        std::wcout << element;
    }

    std::for_each(theHstring.cbegin(), theHstring.cend(), [](T const& element) { std::wcout << element; });
}

Construtor hstring:: hstringhstring::hstring constructor

Inicializa uma nova instância do struct hstring com uma cópia dos dados da cadeia de caracteres de entrada.Initializes a new instance of the hstring struct with a copy of the input string data.

SintaxeSyntax

hstring() noexcept;
hstring(winrt::hstring const& h);
explicit hstring(std::wstring_view const& v);
hstring(std::wchar_t const* c);
hstring(std::wchar_t const* c, uint32_t s);

ParâmetrosParameters

h Um valor de hstring que inicializa o objeto hstring .h An hstring value that initializes the hstring object.

v Um valor std:: wstring_view que inicializa o objeto hstring .v A std::wstring_view value that initializes the hstring object.

c Um ponteiro para uma matriz de wchar_t constantes que inicializa o objeto hstring .c A pointer to an array of constant wchar_t that initializes the hstring object.

s Um número que especifica um tamanho fixo para o objeto hstring .s A number that specifies a fixed size for the hstring object.

ExemploExample

using namespace winrt;
...
void Constructors(
    hstring const& theHstring,
    std::wstring_view const& theWstringView,
    wchar_t const* wideLiteral,
    std::wstring const& wideString)
{
    // hstring() noexcept
    hstring fromDefault{};

    // hstring(hstring const& h)
    hstring fromHstring{ theHstring };

    // explicit hstring(std::wstring_view const& value)
    hstring fromWstringView{ theWstringView };

    // hstring(wchar_t const* value)
    hstring fromWideLiteral{ wideLiteral };
    hstring fromWideString{ wideString.c_str() };

    // hstring(wchar_t const* value, uint32_t size)
    hstring fromWideLiteralWithSize{ wideLiteral, 256 };
    hstring fromWideStringWithSize{ wideString.c_str(), 256 };
}

função hstring:: backhstring::back function

Retorna uma referência ao último caractere no objeto hstring .Returns a reference to the last character in the hstring object.

SintaxeSyntax

std::wchar_t const& back() const noexcept;

Valor retornadoReturn value

Uma referência ao último caractere no objeto hstring .A reference to the last character in the hstring object.

função hstring:: Beginhstring::begin function

Retorna um iterador const para o primeiro caractere no objeto hstring .Returns a const iterator to the first character in the hstring object. Consulte iteradores.See Iterators.

SintaxeSyntax

std::wchar_t const* begin() const noexcept;

Valor retornadoReturn value

Um iterador const para o primeiro caractere no objeto hstring .A const iterator to the first character in the hstring object.

função hstring:: c_strhstring::c_str function

Retorna um ponteiro para a cadeia de caracteres de estilo C terminada em nulo subjacente dos personagens no objeto hstring ; nenhuma cópia é feita.Returns a pointer to the underlying null-terminated C-style string of the characters in the hstring object; no copy is made.

SintaxeSyntax

std::wchar_t const* c_str() const noexcept;

Valor retornadoReturn value

Um ponteiro para a cadeia de caracteres de estilo C terminada em nulo subjacente dos personagens no objeto hstring ; nenhuma cópia é feita.A pointer to the underlying null-terminated C-style string of the characters in the hstring object; no copy is made.

ExemploExample

#include <iostream>
using namespace winrt;
...
void PrintHstring(hstring const& theHstring)
{
    // You can get a standard wide string from an hstring.
    std::wcout << theHstring.c_str() << std::endl;
}

função hstring:: cbeginhstring::cbegin function

Retorna um iterador const para o primeiro caractere no objeto hstring .Returns a const iterator to the first character in the hstring object. Consulte iteradores.See Iterators.

SintaxeSyntax

std::wchar_t const* cbegin() const noexcept;

Valor retornadoReturn value

Um iterador const para o primeiro caractere no objeto hstring .A const iterator to the first character in the hstring object.

função hstring:: cendhstring::cend function

Retorna um iterador const para um após o final de (um após o último caractere) do objeto hstring .Returns a const iterator to one beyond the end of (one beyond the last character in) the hstring object. Consulte iteradores.See Iterators.

SintaxeSyntax

std::wchar_t const* cend() const noexcept;

Valor retornadoReturn value

Um iterador const para um após o final de (um além do último caractere no) objeto hstring .A const iterator to one beyond the end of (one beyond the last character in) the hstring object.

função hstring:: Clearhstring::clear function

Torna o objeto hstring vazio.Makes the hstring object empty.

SyntaxSyntax

void clear() noexcept;

função hstring:: crbeginhstring::crbegin function

Retorna um iterador reverso const para um após o final de (um além do último caractere no) objeto hstring .Returns a const reverse iterator to one beyond the end of (one beyond the last character in) the hstring object.

SintaxeSyntax

std::reverse_iterator<std::wchar_t const*> crbegin() const noexcept;

Valor retornadoReturn value

Um iterador reverso const para um após o final de (um além do último caractere em) o objeto hstring .A const reverse iterator to one beyond the end of (one beyond the last character in) the hstring object.

função hstring:: crendhstring::crend function

Retorna um iterador reverso const para o primeiro caractere no objeto hstring .Returns a const reverse iterator to the first character in the hstring object.

SintaxeSyntax

std::reverse_iterator<std::wchar_t const*> crend() const noexcept;

Valor retornadoReturn value

Um iterador reverso const para o primeiro caractere no objeto hstring .A const reverse iterator to the first character in the hstring object.

hstring::d função do ATAhstring::data function

Retorna uma versão de cadeia de caracteres de estilo C terminada em nulo dos personagens no objeto hstring .Returns a null-terminated C-style string version of the characters in the hstring object.

SintaxeSyntax

std::wchar_t const* data() const noexcept;

Valor retornadoReturn value

Uma versão de cadeia de caracteres em estilo C terminada em nulo dos personagens no objeto hstring .A null-terminated C-style string version of the characters in the hstring object.

ExemploExample

#include <iostream>
using namespace winrt;
...
void PrintHstring(hstring const& theHstring)
{
    // You can get a standard wide string from an hstring.
    std::wcout << theHstring.data() << std::endl;
}

função hstring:: Emptyhstring::empty function

Retorna um valor que indica se o objeto hstring está vazio.Returns a value indicating whether the hstring object is empty.

SintaxeSyntax

bool empty() const noexcept;

Valor retornadoReturn value

true Se o objeto hstring estiver vazio, caso contrário false .true if the hstring object is empty, otherwise false.

função hstring:: Endhstring::end function

Retorna um iterador const para um após o final de (um após o último caractere) do objeto hstring .Returns a const iterator to one beyond the end of (one beyond the last character in) the hstring object. Consulte iteradores.See Iterators.

SintaxeSyntax

std::wchar_t const* end() const noexcept;

Valor retornadoReturn value

Um iterador const para um após o final de (um além do último caractere no) objeto hstring .A const iterator to one beyond the end of (one beyond the last character in) the hstring object.

função hstring:: fronthstring::front function

Retorna uma referência ao primeiro caractere no objeto hstring .Returns a reference to the first character in the hstring object.

SintaxeSyntax

std::wchar_t const& front() const noexcept;

Valor retornadoReturn value

Uma referência ao primeiro caractere no objeto hstring .A reference to the first character in the hstring object.

hstring:: Operator std:: wstring_viewhstring::operator std::wstring_view

Converte o objeto hstring em um std:: wstring_view.Converts the hstring object to a std::wstring_view.

SintaxeSyntax

operator std::wstring_view() const noexcept;

Valor retornadoReturn value

O objeto hstring convertido em um std:: wstring_view.The hstring object converted to a std::wstring_view.

ExemploExample

using namespace winrt;
...
    Uri contosoUri{ L"https://www.contoso.com" };
    Uri awUri{ L"https://www.adventure-works.com" };

    // Uri::Domain() is of type hstring. But we can use hstring's conversion operator to std::wstring_view.
    std::wstring domainWstring{ contosoUri.Domain() }; // L"contoso.com"
    domainWstring = awUri.Domain(); // L"https://www.adventure-works.com"

operador hstring:: operator [] ( subscrito)hstring::operator[] (subscript operator)

Retorna uma referência ao caractere na posição especificada dentro do objeto hstring .Returns a reference to the character at the specified position within the hstring object.

SintaxeSyntax

std::wchar_t const& operator[](uint32_t pos) const noexcept;

ParâmetrosParameters

pos Uma posição de caractere baseada em zero ou índice.pos A zero-based character position, or index.

Valor retornadoReturn value

Uma referência ao caractere na posição especificada dentro do objeto hstring .A reference to the character at the specified position within the hstring object.

hstring:: Operator = (operador de atribuição)hstring::operator= (assignment operator)

Atribui um valor ao objeto hstring .Assigns a value to the hstring object.

SintaxeSyntax

winrt::hstring& operator=(winrt::hstring const& h);
winrt::hstring& operator=(std::wstring_view const& v);

ParâmetrosParameters

h Um valor de hstring para atribuir ao objeto hstring .h An hstring value to assign to the hstring object.

v Um valor std:: wstring_view para atribuir ao objeto hstring .v A std::wstring_view value to assign to the hstring object.

Valor retornadoReturn value

Uma referência ao objeto hstring .A reference to the hstring object.

função hstring:: rbeginhstring::rbegin function

Retorna um iterador reverso const para um após o final de (um além do último caractere no) objeto hstring .Returns a const reverse iterator to one beyond the end of (one beyond the last character in) the hstring object.

SintaxeSyntax

std::reverse_iterator<std::wchar_t const*> rbegin() const noexcept;

Valor retornadoReturn value

Um iterador reverso const para um após o final de (um além do último caractere em) o objeto hstring .A const reverse iterator to one beyond the end of (one beyond the last character in) the hstring object.

função hstring:: rendhstring::rend function

Retorna um iterador reverso const para o primeiro caractere no objeto hstring .Returns a const reverse iterator to the first character in the hstring object.

SintaxeSyntax

std::reverse_iterator<std::wchar_t const*> rend() const noexcept;

Valor retornadoReturn value

Um iterador reverso const para o primeiro caractere no objeto hstring .A const reverse iterator to the first character in the hstring object.

função hstring:: Sizehstring::size function

Retorna o número de caracteres no objeto hstring .Returns the number of characters in the hstring object.

SintaxeSyntax

uint32_t size() const noexcept;

Valor retornadoReturn value

Um uint32_t que contém o número de caracteres no objeto hstring .A uint32_t containing the number of characters in the hstring object.

função attach_abiattach_abi function

Anexa um objeto hstring a um identificador para uma Windows Runtime cadeia de caracteres.Attaches a hstring object to a handle to a Windows Runtime string.

SintaxeSyntax

void attach_abi(winrt::hstring& object, HSTRING value) noexcept;

ParâmetrosParameters

object Um objeto hstring no qual operar.object A hstring object to operate on.

value Um identificador para uma cadeia de caracteres Windows Runtime.value A handle to a Windows Runtime string.

função copy_from_abicopy_from_abi function

Copia para um objeto hstring de um identificador para uma Windows Runtime cadeia de caracteres.Copies to a hstring object from a handle to a Windows Runtime string. Limpa o hstring, copia o parâmetro e começa a gerenciar o identificador.Clears the hstring, copies the parameter, and begins managing the handle.

SintaxeSyntax

void copy_from_abi(winrt::hstring& object, HSTRING value);

ParâmetrosParameters

object Um objeto hstring no qual operar.object A hstring object to operate on.

value Um identificador para uma cadeia de caracteres Windows Runtime.value A handle to a Windows Runtime string.

função copy_to_abicopy_to_abi function

Copia para um identificador para uma cadeia de Windows Runtime de um objeto hstring .Copies to a handle to a Windows Runtime string from a hstring object.

SintaxeSyntax

void copy_to_abi(winrt::hstring const& object, HSTRING& value);

ParâmetrosParameters

object Um objeto hstring no qual operar.object A hstring object to operate on.

value Uma referência de identificador, por meio da qual copiar o identificador do hstring.value A handle reference, via which to copy the hstring's handle.

função detach_abidetach_abi function

Desanexa um objeto hstring de seu identificador, talvez para retorná-lo a um chamador.Detaches a hstring object from its handle, perhaps to return it to a caller.

SintaxeSyntax

HSTRING detach_abi(winrt::hstring& object) noexcept;
HSTRING detach_abi(winrt::hstring&& object) noexcept;

ParâmetrosParameters

object Um objeto hstring no qual operar.object A hstring object to operate on.

Valor retornadoReturn value

O identificador para a cadeia de caracteres de Windows Runtime.The handle to the Windows Runtime string.

operador! = (operador de desigualdade)operator!= (inequality operator)

Retorna um valor que indica se os dois parâmetros são diferentes um do outro.Returns a value indicating whether the two parameters are unequal to one another.

SintaxeSyntax

inline bool operator!=(winrt::hstring const& hLeft, winrt::hstring const& hRight) noexcept;
inline bool operator!=(winrt::hstring const& hLeft, std::wstring const& wRight) noexcept;
inline bool operator!=(winrt::hstring const& hLeft, std::wchar_t const* cRight) noexcept;
inline bool operator!=(std::wstring const& wLeft, winrt::hstring const& hRight) noexcept;
inline bool operator!=(std::wchar_t const* cLeft, winrt::hstring const& hRight) noexcept;

ParâmetrosParameters

hLeft``hRightUm valor de hstring para comparar com o outro parâmetro.hLeft hRight An hstring value to compare with the other parameter.

wLeft``wRightUm std::wstring valor a ser comparado com o outro parâmetro.wLeft wRight A std::wstring value to compare with the other parameter.

cLeft``cRightUm ponteiro para uma matriz de wchar_t constante a ser comparado com o outro parâmetro.cLeft cRight A pointer to an array of constant wchar_t to compare with the other parameter.

Valor retornadoReturn value

true Se os dois parâmetros forem desiguais um do outro, caso contrário false .true if the two parameters are unequal to one another, otherwise false.

operador + (operador de concatenação)operator+ (concatenation operator)

Retorna um novo objeto hstring resultante da concatenação dos dois parâmetros.Returns a new hstring object resulting from concatenating the two parameters together.

SintaxeSyntax

inline hstring operator+(winrt::hstring const& hLeft, winrt::hstring const& hRight);
inline hstring operator+(winrt::hstring const& hLeft, std::wstring const& wRight);
inline hstring operator+(winrt::hstring const& hLeft, std::wstring_view const& vRight);
inline hstring operator+(winrt::hstring const& hLeft, std::wchar_t const* cRight);
inline hstring operator+(winrt::hstring const& hLeft, std::wchar_t scRight);
inline hstring operator+(std::wstring const& wLeft, winrt::hstring const& hRight);
inline hstring operator+(std::wstring_view const& vLeft, winrt::hstring const& hRight);
inline hstring operator+(std::wchar_t const* cLeft, winrt::hstring const& hRight);
inline hstring operator+(std::wchar_t scLeft, winrt::hstring const& hRight);

ParâmetrosParameters

hLeft``hRightUm valor de hstring para concatenar com o outro parâmetro.hLeft hRight An hstring value to concatenate with the other parameter.

wLeft``wRightUm std::wstring valor a ser concatenado com o outro parâmetro.wLeft wRight A std::wstring value to concatenate with the other parameter.

vLeft``vRightUm valor std:: wstring_view para concatenar com o outro parâmetro.vLeft vRight A std::wstring_view value to concatenate with the other parameter.

cLeft``cRightUm ponteiro para uma matriz de constante wchar_t para concatenar com o outro parâmetro.cLeft cRight A pointer to an array of constant wchar_t to concatenate with the other parameter.

scLeft``scRightUm wchar_t para concatenar com o outro parâmetro.scLeft scRight A wchar_t to concatenate with the other parameter.

Valor retornadoReturn value

Um novo objeto hstring resultante da concatenação dos dois parâmetros.A new hstring object resulting from concatenating the two parameters together.

operador< (operador menor que)operator< (less-than operator)

Retorna um valor que indica se o primeiro parâmetro é menor que o segundo parâmetro.Returns a value indicating whether the first parameter is less than the second parameter.

SintaxeSyntax

inline bool operator<(winrt::hstring const& hLeft, winrt::hstring const& hRight) noexcept;
inline bool operator<(winrt::hstring const& hLeft, std::wstring const& wRight) noexcept;
inline bool operator<(winrt::hstring const& hLeft, std::wchar_t const* cRight) noexcept;
inline bool operator<(std::wstring const& wLeft, winrt::hstring const& hRight) noexcept;
inline bool operator<(std::wchar_t const* cLeft, winrt::hstring const& hRight) noexcept;

ParâmetrosParameters

hLeft``hRightUm valor de hstring para comparar com o outro parâmetro.hLeft hRight An hstring value to compare with the other parameter.

wLeft``wRightUm std::wstring valor a ser comparado com o outro parâmetro.wLeft wRight A std::wstring value to compare with the other parameter.

cLeft``cRightUm ponteiro para uma matriz de wchar_t constante a ser comparado com o outro parâmetro.cLeft cRight A pointer to an array of constant wchar_t to compare with the other parameter.

Valor retornadoReturn value

true Se o primeiro parâmetro for menor do que o segundo parâmetro, caso contrário false .true if the first parameter is less than the second parameter, otherwise false.

operador<= (operador menor que ou-igual a)operator<= (less-than-or-equal-to operator)

Retorna um valor que indica se o primeiro parâmetro é menor ou igual ao segundo parâmetro.Returns a value indicating whether the first parameter is less than or equal to the second parameter.

SintaxeSyntax

inline bool operator<=(winrt::hstring const& hLeft, winrt::hstring const& hRight) noexcept;
inline bool operator<=(winrt::hstring const& hLeft, std::wstring const& wRight) noexcept;
inline bool operator<=(winrt::hstring const& hLeft, std::wchar_t const* cRight) noexcept;
inline bool operator<=(std::wstring const& wLeft, winrt::hstring const& hRight) noexcept;
inline bool operator<=(std::wchar_t const* cLeft, winrt::hstring const& hRight) noexcept;

ParâmetrosParameters

hLeft``hRightUm valor de hstring para comparar com o outro parâmetro.hLeft hRight An hstring value to compare with the other parameter.

wLeft``wRightUm std::wstring valor a ser comparado com o outro parâmetro.wLeft wRight A std::wstring value to compare with the other parameter.

cLeft``cRightUm ponteiro para uma matriz de wchar_t constante a ser comparado com o outro parâmetro.cLeft cRight A pointer to an array of constant wchar_t to compare with the other parameter.

Valor retornadoReturn value

true Se o primeiro parâmetro for menor ou igual ao segundo parâmetro, caso contrário false .true if the first parameter is less than or equal to the second parameter, otherwise false.

Operator = = (operador de igualdade)operator== (equality operator)

Retorna um valor que indica se os dois parâmetros são iguais um do outro.Returns a value indicating whether the two parameters are equal to one another.

SintaxeSyntax

inline bool operator==(winrt::hstring const& hLeft, winrt::hstring const& hRight) noexcept;
inline bool operator==(winrt::hstring const& hLeft, std::wstring const& wRight) noexcept;
inline bool operator==(winrt::hstring const& hLeft, std::wchar_t const* cRight) noexcept;
inline bool operator==(std::wstring const& wLeft, winrt::hstring const& hRight) noexcept;
inline bool operator==(std::wchar_t const* cLeft, winrt::hstring const& hRight) noexcept;

ParâmetrosParameters

hLeft``hRightUm valor de hstring para comparar com o outro parâmetro.hLeft hRight An hstring value to compare with the other parameter.

wLeft``wRightUm std::wstring valor a ser comparado com o outro parâmetro.wLeft wRight A std::wstring value to compare with the other parameter.

cLeft``cRightUm ponteiro para uma matriz de wchar_t constante a ser comparado com o outro parâmetro.cLeft cRight A pointer to an array of constant wchar_t to compare with the other parameter.

Valor retornadoReturn value

true Se os dois parâmetros forem iguais um do outro, caso contrário false .true if the two parameters are equal to one another, otherwise false.

operador> (operador maior que)operator> (greater-than operator)

Retorna um valor que indica se o primeiro parâmetro é maior que o segundo parâmetro.Returns a value indicating whether the first parameter is greater than the second parameter.

SintaxeSyntax

inline bool operator>(winrt::hstring const& hLeft, winrt::hstring const& hRight) noexcept;
inline bool operator>(winrt::hstring const& hLeft, std::wstring const& wRight) noexcept;
inline bool operator>(winrt::hstring const& hLeft, std::wchar_t const* cRight) noexcept;
inline bool operator>(std::wstring const& wLeft, winrt::hstring const& hRight) noexcept;
inline bool operator>(std::wchar_t const* cLeft, winrt::hstring const& hRight) noexcept;

ParâmetrosParameters

hLeft``hRightUm valor de hstring para comparar com o outro parâmetro.hLeft hRight An hstring value to compare with the other parameter.

wLeft``wRightUm std::wstring valor a ser comparado com o outro parâmetro.wLeft wRight A std::wstring value to compare with the other parameter.

cLeft``cRightUm ponteiro para uma matriz de wchar_t constante a ser comparado com o outro parâmetro.cLeft cRight A pointer to an array of constant wchar_t to compare with the other parameter.

Valor retornadoReturn value

true Se o primeiro parâmetro for maior que o segundo parâmetro, caso contrário false .true if the first parameter is greater than the second parameter, otherwise false.

operador>= (operador maior que ou-igual a)operator>= (greater-than-or-equal-to operator)

Retorna um valor que indica se o primeiro parâmetro é maior ou igual ao segundo parâmetro.Returns a value indicating whether the first parameter is greater than or equal to the second parameter.

SintaxeSyntax

inline bool operator>=(winrt::hstring const& hLeft, winrt::hstring const& hRight) noexcept;
inline bool operator>=(winrt::hstring const& hLeft, std::wstring const& wRight) noexcept;
inline bool operator>=(winrt::hstring const& hLeft, std::wchar_t const* cRight) noexcept;
inline bool operator>=(std::wstring const& wLeft, winrt::hstring const& hRight) noexcept;
inline bool operator>=(std::wchar_t const* cLeft, winrt::hstring const& hRight) noexcept;

ParâmetrosParameters

hLeft``hRightUm valor de hstring para comparar com o outro parâmetro.hLeft hRight An hstring value to compare with the other parameter.

wLeft``wRightUm std::wstring valor a ser comparado com o outro parâmetro.wLeft wRight A std::wstring value to compare with the other parameter.

cLeft``cRightUm ponteiro para uma matriz de wchar_t constante a ser comparado com o outro parâmetro.cLeft cRight A pointer to an array of constant wchar_t to compare with the other parameter.

Valor retornadoReturn value

true Se o primeiro parâmetro for maior ou igual ao segundo parâmetro, caso contrário false .true if the first parameter is greater than or equal to the second parameter, otherwise false.

Veja tambémSee also