Funções de tratamento de cadeia de caracteres do shell

Esta seção descreve as funções de tratamento de cadeia de caracteres do Windows Shell. Os elementos de programação explicados nesta documentação são exportados por Shlwapi.dll e definidos em Shlwapi.h e Shlwapi.lib.

Nesta seção

Tópico	Descrição
ChrCmpI	Executa uma comparação entre dois caracteres. A comparação não diferencia maiúsculas de minúsculas.
GetAcceptLanguages	Recupera uma cadeia de caracteres usada com sites ao especificar preferências de idioma.
IntlStrEqN	Executa uma comparação que diferencia maiúsculas de minúsculas de um número especificado de caracteres desde o início de duas cadeias de caracteres localizadas.
IntlStrEqNI	Executa uma comparação que não diferencia maiúsculas de minúsculas de um número especificado de caracteres desde o início de duas cadeias de caracteres localizadas.
IntlStrEqWorker	Compara um número especificado de caracteres do início de duas cadeias de caracteres localizadas.
IsCharSpace	Determina se um caractere representa um espaço.
SHLoadIndirectString	Extrai um recurso de texto especificado quando dado esse recurso na forma de uma cadeia de caracteres indireta (uma cadeia de caracteres que começa com o símbolo '@').
SHStrDup	Faz uma cópia de uma cadeia de caracteres na memória recém-alocada.
Strcat	Acrescenta uma cadeia de caracteres a outra. Nota: Não use. Consulte Comentários para obter funções alternativas.
StrCatBuff	Copia e acrescenta caracteres de uma cadeia de caracteres ao final de outra. Nota: Não use. Consulte Comentários para obter funções alternativas.
StrCatChainW	Concatena duas cadeias de caracteres Unicode. Usado quando concatenações repetidas para o mesmo buffer são necessárias.
StrChr	Pesquisa uma cadeia de caracteres para a primeira ocorrência de um caractere que corresponde ao caractere especificado. A comparação diferencia maiúsculas de minúsculas.
StrChrI	Pesquisa uma cadeia de caracteres para a primeira ocorrência de um caractere que corresponde ao caractere especificado. A comparação não diferencia maiúsculas de minúsculas.
StrChrNIW	Pesquisa uma cadeia de caracteres para a primeira ocorrência de um caractere especificado. A comparação não diferencia maiúsculas de minúsculas.
StrChrNW	Pesquisa uma cadeia de caracteres para a primeira ocorrência de um caractere especificado. A comparação diferencia maiúsculas de minúsculas.
Strcmp	Compara duas cadeias de caracteres para determinar se elas são iguais. A comparação diferencia maiúsculas de minúsculas.
StrCmpC	Compara cadeias de caracteres usando regras de ordenação ASCII (tempo de execução C). A comparação diferencia maiúsculas de minúsculas.
StrCmpI	Compara duas cadeias de caracteres para determinar se elas são iguais. A comparação não diferencia maiúsculas de minúsculas.
StrCmpIC	Compara duas cadeias de caracteres usando regras de ordenação ASCII (tempo de execução C). A comparação não diferencia maiúsculas de minúsculas.
StrCmpLogicalW	Compara duas cadeias de caracteres Unicode. Os dígitos nas cadeias de caracteres são considerados como conteúdo numérico em vez de texto. Este teste não diferencia maiúsculas de minúsculas.
StrCmpN	Compara um número especificado de caracteres do início de duas cadeias de caracteres para determinar se eles são iguais. A comparação diferencia maiúsculas de minúsculas. A macro StrNCmp difere apenas dessa função no nome.
StrCmpNC	Compara um número especificado de caracteres do início de duas cadeias de caracteres usando regras de ordenação ASCII (tempo de execução C). A comparação diferencia maiúsculas de minúsculas.
StrCmpNI	Compara um número especificado de caracteres do início de duas cadeias de caracteres para determinar se eles são iguais. A comparação não diferencia maiúsculas de minúsculas. A macro StrNCmpI difere apenas dessa função no nome.
StrCmpNIC	Compara um número especificado de caracteres do início de duas cadeias de caracteres usando regras de ordenação ASCII (tempo de execução C). A comparação não diferencia maiúsculas de minúsculas.
Strcpy	Copia uma cadeia de caracteres para outra. Nota: Não use. Consulte Comentários para obter funções alternativas.
StrCpyN	Copia um número especificado de caracteres do início de uma cadeia de caracteres para outra. Nota: Não use essa função ou a macro StrNCpy . Consulte Comentários para obter funções alternativas.
StrCSpn	Pesquisa uma cadeia de caracteres para a primeira ocorrência de qualquer um de um grupo de caracteres. O método de pesquisa diferencia maiúsculas de minúsculas e o caractere NULL de terminação é incluído na correspondência de padrão de pesquisa.
StrCSpnI	Pesquisa uma cadeia de caracteres para a primeira ocorrência de qualquer um de um grupo de caracteres. O método de pesquisa não diferencia maiúsculas de minúsculas e o caractere NULL de terminação é incluído na correspondência de padrão de pesquisa.
Strdup	Duplica uma cadeia de caracteres.
StrFormatByteSize64	Converte um valor numérico em uma cadeia de caracteres que representa o número expresso como um valor de tamanho em bytes, quilobytes, megabytes ou gigabytes, dependendo do tamanho.
StrFormatByteSizeA	Converte um valor numérico em uma cadeia de caracteres que representa o número expresso como um valor de tamanho em bytes, quilobytes, megabytes ou gigabytes, dependendo do tamanho. Difere de StrFormatByteSizeW em um tipo de parâmetro.
StrFormatByteSizeEx	Converte um valor numérico em uma cadeia de caracteres que representa o número em bytes, quilobytes, megabytes ou gigabytes, dependendo do tamanho. Estende StrFormatByteSizeW oferecendo a opção de arredondar para o dígito exibido mais próximo ou descartar dígitos não reproduzidos.
StrFormatByteSizeW	Converte um valor numérico em uma cadeia de caracteres que representa o número expresso como um valor de tamanho em bytes, quilobytes, megabytes ou gigabytes, dependendo do tamanho. Difere de StrFormatByteSizeA em um tipo de parâmetro.
StrFormatKBSize	Converte um valor numérico em uma cadeia de caracteres que representa o número expresso como um valor de tamanho em quilobytes.
StrFromTimeInterval	Converte um intervalo de tempo, especificado em milissegundos, em uma cadeia de caracteres.
StrIsIntlEqual	Compara um número especificado de caracteres do início de duas cadeias de caracteres para determinar se eles são iguais.
Strncat	Acrescenta um número especificado de caracteres do início de uma cadeia de caracteres ao final de outra. Nota: Não use essa função ou a macro StrCatN . Consulte Comentários para funções alternativas.
StrPBrk	Pesquisa uma cadeia de caracteres para a primeira ocorrência de um caractere contido em um buffer especificado. Essa pesquisa não inclui o caractere nulo de terminação.
Strrchr	Pesquisa uma cadeia de caracteres para a última ocorrência de um caractere especificado. A comparação diferencia maiúsculas de minúsculas.
StrRChrI	Pesquisa uma cadeia de caracteres para a última ocorrência de um caractere especificado. A comparação não diferencia maiúsculas de minúsculas.
StrRetToBSTR	Aceita uma estrutura STRRET retornada por IShellFolder::GetDisplayNameOf que contém ou aponta para uma cadeia de caracteres e retorna essa cadeia de caracteres como um BSTR.
StrRetToBuf	Converte uma estrutura STRRET retornada por IShellFolder::GetDisplayNameOf em uma cadeia de caracteres e coloca o resultado em um buffer.
StrRetToStr	Usa uma estrutura STRRET retornada por IShellFolder::GetDisplayNameOf e retorna um ponteiro para uma cadeia de caracteres alocada que contém o nome de exibição.
StrRetToStrN	Usa uma estrutura STRRET retornada por IShellFolder::GetDisplayNameOf, converte-a em uma cadeia de caracteres e coloca o resultado em um buffer.
StrRStrI	Pesquisa a última ocorrência de uma subcadeia de caracteres especificada dentro de uma cadeia de caracteres. A comparação não diferencia maiúsculas de minúsculas.
StrSpn	Obtém o comprimento de uma subcadeia de caracteres dentro de uma cadeia de caracteres que consiste inteiramente de caracteres contidos em um buffer especificado.
Strstr	Localiza a primeira ocorrência de uma subcadeia de caracteres dentro de uma cadeia de caracteres. A comparação diferencia maiúsculas de minúsculas.
StrStrI	Localiza a primeira ocorrência de uma subcadeia de caracteres dentro de uma cadeia de caracteres. A comparação não diferencia maiúsculas de minúsculas.
StrToInt	Converte uma cadeia de caracteres que representa um valor decimal em um inteiro. A macro StrToLong é idêntica a essa função.
StrToInt64Ex	Converte uma cadeia de caracteres que representa um valor decimal ou hexadecimal em um inteiro de 64 bits.
StrToIntEx	Converte uma cadeia de caracteres que representa um número decimal ou hexadecimal em um inteiro.
StrTrim	Remove os caracteres à esquerda e à direita especificados de uma cadeia de caracteres.
wnsprintf	Usa uma lista de argumentos de comprimento variável e retorna os valores dos argumentos como uma cadeia de caracteres formatada no estilo printf. Nota: Não use essa função. Consulte Comentários para funções alternativas.
wvnsprintf	Usa uma lista de argumentos e retorna os valores dos argumentos como uma cadeia de caracteres formatada no estilo printf. Nota: Não use essa função. Consulte Comentários para funções alternativas.