Funções de manipulação de cadeia de caracteres do shell

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

Nesta secçã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 a partir do início de duas cadeias de caracteres localizadas.
IntlStrEqNI	Executa uma comparação sem diferenciação de maiúsculas e minúsculas de um número especificado de caracteres a partir do 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 esse recurso recebe 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 utilize. Consulte Observações para funções alternativas.
StrCatBuff	Copia e acrescenta caracteres de uma cadeia de caracteres ao final de outra. Nota: Não utilize. Consulte Observações para 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 agrupamento de tempo de execução C (ASCII). 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 agrupamento em tempo de execução C (ASCII). 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 elas são iguais. A comparação diferencia maiúsculas de minúsculas. A macro StrNCmp difere desta função apenas no nome.
StrCmpNC	Compara um número especificado de caracteres do início de duas cadeias de caracteres usando regras de agrupamento de tempo de execução C (ASCII). 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 elas são iguais. A comparação não diferencia maiúsculas de minúsculas. A macro StrNCmpI difere desta função apenas no nome.
StrCmpNIC	Compara um número especificado de caracteres do início de duas cadeias de caracteres usando regras de agrupamento de tempo de execução C (ASCII). A comparação não diferencia maiúsculas de minúsculas.
StrCpy	Copia uma cadeia de caracteres para outra. Nota: Não utilize. Consulte Observações para 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 esta função ou a macro StrNCpy. Consulte Observações para 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 de terminação NULL é incluído na correspondência do 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 de terminação NULL é incluído na correspondência do 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, kilobytes, 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, kilobytes, 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, kilobytes, 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 exibidos.
StrFormatByteSizeW	Converte um valor numérico em uma cadeia de caracteres que representa o número expresso como um valor de tamanho em bytes, kilobytes, 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 kilobytes.
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 elas 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 esta função ou o macro StrCatN. Consulte Observações para funções alternativas.
StrPBrk	Pesquisa uma cadeia de caracteres para a primeira ocorrência de um caractere contido em um buffer especificado. Esta 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 de 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 de STRRET retornada por IShellFolder::GetDisplayNameOf em uma cadeia de caracteres e coloca o resultado em um buffer.
StrRetToStr	Usa uma estrutura de STRRET retornada por IShellFolder::GetDisplayNameOf e retorna um ponteiro para uma cadeia de caracteres alocada que contém o nome para exibição.
StrRetToStrN	Usa uma estrutura de STRRET retornada por IShellFolder::GetDisplayNameOf, converte-a em uma cadeia de caracteres e coloca o resultado em um buffer.
StrRStrI	Procura a última ocorrência de uma substring 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 substring dentro de uma string que consiste inteiramente de caracteres contidos em um buffer especificado.
StrStr	Localiza a primeira ocorrência de uma substring dentro de uma cadeia de caracteres. A comparação diferencia maiúsculas de minúsculas.
StrStrI	Localiza a primeira ocorrência de uma substring 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 esta 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 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 printfcadeia de caracteres formatada no estilo -. Nota: Não utilize esta função. Consulte Observações para funções alternativas.
wvnsprintf	Obtém uma lista de argumentos e retorna os valores dos argumentos como uma printfcadeia de caracteres formatada no estilo -. Nota: Não utilize esta função. Consulte Observações para funções alternativas.