String Classe

Definição

Namespace:
Java.Lang
Assembly:
Mono.Android.dll

A String classe representa cadeias de caracteres.

[Android.Runtime.Register("java/lang/String", DoNotGenerateAcw=true)]
public sealed class String : Java.Lang.Object, IDisposable, Java.IO.ISerializable, Java.Lang.ICharSequence, Java.Lang.IComparable, System.Collections.Generic.IEnumerable<char>
[<Android.Runtime.Register("java/lang/String", DoNotGenerateAcw=true)>]
type String = class
    inherit Object
    interface ISerializable
    interface IJavaObject
    interface IDisposable
    interface IJavaPeerable
    interface ICharSequence
    interface seq<char>
    interface IEnumerable
    interface IComparable
Herança
Object
JavaObject
Object
String
Atributos
RegisterAttribute
Implementações
IJavaObject IJavaPeerable ISerializable ICharSequence IComparable IEnumerable<Char> IEnumerable IDisposable

Comentários

A String classe representa cadeias de caracteres. Todos os literais de cadeia de caracteres em programas Java, como"abc", são implementados como instâncias dessa classe.

Cadeias de caracteres são constantes; seus valores não podem ser alterados depois de criados. Os buffers de cadeia de caracteres dão suporte a cadeias de caracteres mutáveis. Como os objetos String são imutáveis, eles podem ser compartilhados. Por exemplo: <blockquote>

String str = "abc";

</blockquote>

é equivalente a: <blockquote>

char data[] = {'a', 'b', 'c'};
                String str = new String(data);

</blockquote>

Aqui estão mais alguns exemplos de como as cadeias de caracteres podem ser usadas: <blockquote>

System.out.println("abc");
                String cde = "cde";
                System.out.println("abc" + cde);
                String c = "abc".substring(2,3);
                String d = cde.substring(1, 2);

</blockquote>

A classe String inclui métodos para examinar caracteres individuais da sequência, para comparar cadeias de caracteres, para pesquisar cadeias de caracteres, para extrair subcadeias de caracteres e para criar uma cópia de uma cadeia de caracteres com todos os caracteres convertidos em maiúsculas ou minúsculas. O mapeamento de maiúsculas e minúsculas baseia-se na versão Padrão Unicode especificada pela java.lang.Character Character classe.

A linguagem Java fornece suporte especial para o operador de concatenação de cadeia de caracteres (& nbsp;+& nbsp;) e para conversão de outros objetos em cadeias de caracteres. Para obter informações adicionais sobre concatenação e conversão de cadeia de caracteres, consulte The Java& trade; Especificação da linguagem.

A menos que indicado de outra forma, passar um null argumento para um construtor ou método nessa classe fará com que um NullPointerException seja gerado.

Um String representa uma cadeia de caracteres no formato UTF-16 no qual <em>caracteres complementares</em> são representados por <pares>substitutos</em> (consulte a seção Representações de caractere Unicode na Character classe para obter mais informações). Os valores de índice referem-se a char unidades de código, portanto, um caractere suplementar usa duas posições em um String.

A String classe fornece métodos para lidar com pontos de código Unicode (ou seja, caracteres), além daqueles para lidar com unidades de código Unicode (ou seja, char valores).

A menos que indicado de outra forma, os métodos para comparar cadeias de caracteres não levam em conta a localidade. A java.text.Collator classe fornece métodos para comparação de cadeia de caracteres mais refinada e sensível à localidade.

Adicionado em 1.0.

Documentação Java para java.lang.String.

Partes desta página são modificações baseadas no trabalho criado e compartilhado pelo Android Open Source Project e usadas de acordo com os termos descritos na Licença de Atribuição Creative Commons 2.5.

Construtores

Nome Description
String()

Cria uma cadeia de caracteres vazia.
String(Byte[], Charset)

Constrói um novo String decodificação da matriz de bytes especificada usando o java especificado.
String(Byte[], Int32, Int32, Charset)

Constrói um novo String decodificação da subarray especificada de bytes usando o java especificado.
String(Byte[], Int32, Int32, Int32)
Obsoleto.

Aloca um novo String construído a partir de uma subarray de uma matriz de valores inteiros de 8 bits.
String(Byte[], Int32, Int32, String)

Constrói um novo String decodificação da subarray especificada de bytes usando o conjunto de caracteres especificado.
String(Byte[], Int32, Int32)

Constrói um novo String decodificação da subarray especificada de bytes usando o conjunto de caracteres padrão da plataforma.
String(Byte[], Int32)
Obsoleto.

Aloca um novo String caractere contendo caracteres construídos a partir de uma matriz de valores inteiros de 8 bits.
String(Byte[], String)

Constrói um novo String decodificação da matriz de bytes especificada usando o java especificado.
String(Byte[])

Constrói um novo String decodificação da matriz de bytes especificada usando o conjunto de caracteres padrão da plataforma.
String(Char[], Int32, Int32)

Inicializa essa cadeia de caracteres para conter os s especificados char.
String(Char[])

Inicializa essa cadeia de caracteres para conter os s especificados char.
String(Int32[], Int32, Int32)

Aloca um novo String que contém caracteres de uma subarray do argumento de matriz de ponto de código Unicode.
String(String)

Constrói uma nova cadeia de caracteres com a mesma sequência de caracteres toCopyque .
String(StringBuffer)

Aloca uma nova cadeia de caracteres que contém a sequência de caracteres atualmente contida no argumento de buffer de cadeia de caracteres.
String(StringBuilder)

Aloca uma nova cadeia de caracteres que contém a sequência de caracteres atualmente contida no argumento do construtor de cadeias de caracteres.

Propriedades

Nome Description
CaseInsensitiveOrder

Um comparador que ordena String objetos como por compareToIgnoreCase.
Class

Retorna a classe de tempo de execução deste Object.

(Herdado de Object)
Handle

O identificador para a instância subjacente do Android.

(Herdado de Object)
IsBlank

Retorna true se a cadeia de caracteres estiver vazia ou contiver apenas Character#isWhitespace(int) white space pontos de código, caso contrário false.
IsEmpty

Retorna true se, e somente se, #length() for 0.
JniIdentityHashCode

Obtém o código de hash de identidade atribuído a esse par Java pelo runtime de interoperabilidade.

(Herdado de Object)
JniManagedPeerState

A String classe representa cadeias de caracteres.

(Herdado de JavaObject)
JniPeerMembers

Obtém os metadados JNI usados para invocar membros desse par Java.
PeerReference

Obtém a referência de objeto JNI para este par Java.

(Herdado de Object)
ThresholdClass

Essa API é compatível com a infraestrutura Mono para Android e não se destina a ser usada diretamente do seu código.

(Herdado de Object)
ThresholdType

Essa API é compatível com a infraestrutura Mono para Android e não se destina a ser usada diretamente do seu código.

(Herdado de Object)

Métodos

Nome Description
CharAt(Int32)

Retorna o char valor no índice especificado.
Clone()

Cria e retorna uma cópia desse objeto.

(Herdado de Object)
CodePointAt(Int32)

Retorna o caractere (ponto de código Unicode) no índice especificado.
CodePointBefore(Int32)

Retorna o caractere (ponto de código Unicode) antes do índice especificado.
CodePointCount(Int32, Int32)

Retorna o número de pontos de código Unicode no intervalo de texto especificado deste String.
CompareTo(String)

Compara duas cadeias de caracteres lexicograficamente.
CompareToIgnoreCase(String)

Compara duas cadeias de caracteres lexicograficamente, ignorando as diferenças de maiúsculas e minúsculas.
Concat(String)

Concatena a cadeia de caracteres especificada até o final dessa cadeia de caracteres.
Construct(JniObjectReference, JniObjectReferenceOptions)

A String classe representa cadeias de caracteres.

(Herdado de JavaObject)
Contains(ICharSequence)

Retorna true se e somente se essa cadeia de caracteres contiver a sequência especificada de valores char.
Contains(String)

Retorna true se e somente se essa cadeia de caracteres contiver a sequência especificada de valores char.
ContentEquals(ICharSequence)

Compara essa cadeia de caracteres com a especificada CharSequence.
ContentEquals(String)

Compara essa cadeia de caracteres com a especificada CharSequence.
ContentEquals(StringBuffer)

Compara essa cadeia de caracteres com a especificada StringBuffer.
CopyValueOf(Char[], Int32, Int32)

Equivalente a #valueOf(char[], int, int).
CopyValueOf(Char[])

Equivalente a #valueOf(char[]).
Dispose()

Libera os recursos mantidos por esse par Java.

(Herdado de Object)
Dispose(Boolean)

Libera os recursos mantidos por esse par Java.

(Herdado de Object)
DisposeUnlessReferenced()

A String classe representa cadeias de caracteres.

(Herdado de JavaObject)
EndsWith(String)

Testa se essa cadeia de caracteres termina com o sufixo especificado.
Equals(Object)

A String classe representa cadeias de caracteres.

(Herdado de JavaObject)
Equals(Object)

Indica se algum outro objeto é "igual a" este.

(Herdado de Object)
EqualsIgnoreCase(String)

Compara isso String com outro String, ignorando considerações de caso.
Format(Locale, String, Object[])

Retorna uma cadeia de caracteres formatada usando a cadeia de caracteres e argumentos de formato especificados.
Format(String, Object[])

Retorna uma cadeia de caracteres formatada usando a cadeia de caracteres e argumentos de formato especificados.
Formatted(Object[])

Formata essa cadeia de caracteres substituindo os argumentos fornecidos.
GetBytes()

Codifica isso String em uma sequência de bytes usando o conjunto de caracteres padrão da plataforma, armazenando o resultado em uma nova matriz de bytes.
GetBytes(Charset)

Codifica isso String em uma sequência de bytes usando o java especificado.
GetBytes(Int32, Int32, Byte[], Int32)
Obsoleto.

Copia caracteres dessa cadeia de caracteres para a matriz de bytes de destino.
GetBytes(String)

Codifica isso String em uma sequência de bytes usando o conjunto de caracteres nomeado, armazenando o resultado em uma nova matriz de bytes.
GetChars(Int32, Int32, Char[], Int32)

Copia caracteres dessa cadeia de caracteres para a matriz de caracteres de destino.
GetEnumerator()

Retorna um enumerador que itera por meio dos caracteres nesta sequência.
GetHashCode()

Retorna um valor de código hash para o objeto.

(Herdado de Object)
Indent(Int32)

Ajusta o recuo de cada linha dessa cadeia de caracteres com base no valor de e normaliza os caracteres de nterminação de linha.
IndexOf(Int32, Int32)

Retorna o índice dentro dessa cadeia de caracteres da primeira ocorrência do caractere especificado, iniciando a pesquisa no índice especificado.
IndexOf(Int32)

Retorna o índice dentro dessa cadeia de caracteres da primeira ocorrência do caractere especificado.
IndexOf(String, Int32)

Retorna o índice dentro dessa cadeia de caracteres da primeira ocorrência da subcadeia de caracteres especificada, começando no índice especificado.
IndexOf(String)

Retorna o índice dentro dessa cadeia de caracteres da primeira ocorrência da subcadeia de caracteres especificada.
Intern()

Retorna uma representação canônica para o objeto de cadeia de caracteres.
JavaFinalize()

Chamado pelo coletor de lixo em um objeto quando a coleta de lixo determina que não há mais referências ao objeto.

(Herdado de Object)
Join(ICharSequence, ICharSequence[])

Retorna uma nova cadeia de caracteres composta de cópias da junção CharSequence elements com uma cópia do especificado delimiter.
Join(ICharSequence, IIterable)

Retorna uma nova String composta de cópias da junção CharSequence elements com uma cópia do especificado delimiter.
Join(String, IIterable)

Retorna uma nova String composta de cópias da junção CharSequence elements com uma cópia do especificado delimiter.
Join(String, String[])

Retorna uma nova cadeia de caracteres composta de cópias da junção CharSequence elements com uma cópia do especificado delimiter.
LastIndexOf(Int32, Int32)

Retorna o índice dentro dessa cadeia de caracteres da última ocorrência do caractere especificado, pesquisando para trás começando no índice especificado.
LastIndexOf(Int32)

Retorna o índice dentro dessa cadeia de caracteres da última ocorrência do caractere especificado.
LastIndexOf(String, Int32)

Retorna o índice dentro dessa cadeia de caracteres da última ocorrência da subcadeia de caracteres especificada, pesquisando para trás começando no índice especificado.
LastIndexOf(String)

Retorna o índice dentro dessa cadeia de caracteres da última ocorrência da subcadeia de caracteres especificada.
Length()

Retorna o comprimento dessa cadeia de caracteres.
Matches(String)

Informa se essa cadeia de caracteres corresponde ou não à expressão regular fornecida.
Notify()

Ativa um único thread que está aguardando no monitor desse objeto.

(Herdado de Object)
NotifyAll()

Ativa todos os threads que estão aguardando no monitor deste objeto.

(Herdado de Object)
OffsetByCodePoints(Int32, Int32)

Retorna o índice dentro disso String que é deslocado dos pontos de código fornecidos index por codePointOffset pontos de código.
RegionMatches(Boolean, Int32, String, Int32, Int32)

Testa se duas regiões de cadeia de caracteres são iguais.
RegionMatches(Int32, String, Int32, Int32)

Testa se duas regiões de cadeia de caracteres são iguais.
Repeat(Int32)

Retorna uma cadeia de caracteres cujo valor é a concatenação dessa cadeia de caracteres repetidamente count .
Replace(Char, Char)

Retorna uma cadeia de caracteres resultante da substituição de todas as ocorrências dessa cadeia de oldChar caracteres por newChar.
Replace(ICharSequence, ICharSequence)

Substitui cada subcadeia de caracteres dessa cadeia de caracteres que corresponde à sequência de destino literal com a sequência de substituição literal especificada.
Replace(String, String)

Substitui cada subcadeia de caracteres dessa cadeia de caracteres que corresponde à sequência de destino literal com a sequência de substituição literal especificada.
ReplaceAll(String, String)

Substitui cada subcadeia de caracteres dessa cadeia de caracteres que corresponde à expressão regular fornecida com a substituição fornecida.
ReplaceFirst(String, String)

Substitui a primeira subcadeia de caracteres dessa cadeia de caracteres que corresponde à expressão regular fornecida com a substituição fornecida.
SetHandle(IntPtr, JniHandleOwnership)

Define a propriedade Handle

(Herdado de Object)
SetPeerReference(JniObjectReference, JniObjectReferenceOptions)

A String classe representa cadeias de caracteres.

(Herdado de JavaObject)
Split(String, Int32)

Divide essa cadeia de caracteres em torno de correspondências da expressão regular fornecida.
Split(String)

Divide essa cadeia de caracteres em torno de correspondências da expressão regular fornecida.
StartsWith(String, Int32)

Testa se a subcadeia de caracteres dessa cadeia de caracteres que começa no índice especificado começa com o prefixo especificado.
StartsWith(String)

Testa se essa cadeia de caracteres começa com o prefixo especificado.
Strip()

Retorna uma cadeia de caracteres cujo valor é essa cadeia de caracteres, com todos à esquerda e à direita removidos Character#isWhitespace(int) white space .
StripIndent()

Retorna uma cadeia de caracteres cujo valor é essa cadeia de caracteres, com espaço em branco De caracteres incidentais#isWhitespace(int) removido do início e do final de cada linha.
StripLeading()

Retorna uma cadeia de caracteres cujo valor é essa cadeia de caracteres, com todos os líderes Character#isWhitespace(int) white space removidos.
StripTrailing()

Retorna uma cadeia de caracteres cujo valor é essa cadeia de caracteres, com todas as trilhas removidas Character#isWhitespace(int) white space .
SubSequence(Int32, Int32)

Retorna uma sequência de caracteres que é uma subsequência dessa sequência.
SubSequenceFormatted(Int32, Int32)

Retorna uma sequência de caracteres que é uma subsequência dessa sequência.
Substring(Int32, Int32)

Retorna uma cadeia de caracteres que é uma subcadeia de caracteres dessa cadeia de caracteres.
Substring(Int32)

Retorna uma cadeia de caracteres que é uma subcadeia de caracteres dessa cadeia de caracteres.
ToArray<T>()

Cria uma matriz gerenciada com base nesse wrapper de matriz Java.

(Herdado de Object)
ToCharArray()

Converte essa cadeia de caracteres em uma nova matriz de caracteres.
ToLowerCase()

Converte todos os caracteres nesse String caso em letras minúsculas usando as regras da localidade padrão.
ToLowerCase(Locale)

Converte todos os caracteres nesse String caso em letras minúsculas usando as regras do determinado Locale.
ToString()

Converte esse valor em uma cadeia de caracteres.
ToUpperCase()

Converte todos os caracteres nesse String caso em maiúsculas usando as regras da localidade padrão.
ToUpperCase(Locale)

Converte todos os caracteres nesse String caso em maiúsculas usando as regras do determinado Locale.
Transform(IFunction)

Esse método permite que a aplicação de uma função seja cadeia de caracteres this .
TranslateEscapes()

Retorna uma cadeia de caracteres cujo valor é essa cadeia de caracteres, com sequências de escape traduzidas como se estivesse em um literal de cadeia de caracteres.
Trim()

Retorna uma cadeia de caracteres cujo valor é essa cadeia de caracteres, com todo o espaço à esquerda e à direita removido, em que o espaço é definido como qualquer caractere cujo ponto de código é menor ou igual a 'U+0020' (o caractere de espaço).
UnregisterFromRuntime()

Cancela o registro desse par Java do runtime de interoperabilidade.

(Herdado de Object)
ValueOf(Boolean)

Retorna a representação de cadeia de caracteres do boolean argumento.
ValueOf(Char)

Retorna a representação de cadeia de caracteres do char argumento.
ValueOf(Char[], Int32, Int32)

Retorna a representação de cadeia de caracteres de uma subarray específica do argumento de char matriz.
ValueOf(Char[])

Retorna a representação de cadeia de caracteres do argumento de char matriz.
ValueOf(Double)

Retorna a representação de cadeia de caracteres do double argumento.
ValueOf(Int32)

Retorna a representação de cadeia de caracteres do int argumento.
ValueOf(Int64)

Retorna a representação de cadeia de caracteres do long argumento.
ValueOf(Object)

Retorna a representação de cadeia de caracteres do Object argumento.
ValueOf(Single)

Retorna a representação de cadeia de caracteres do float argumento.
Wait()

Faz com que o thread atual aguarde até ser despertado, normalmente por ser <notificado/em> ou <em>interrompido</em>.<>

(Herdado de Object)
Wait(Int64, Int32)

Faz com que o thread atual aguarde até que ele seja despertado, normalmente por ser <>notificado</em> ou <em>interrompido</em>, ou até que uma determinada quantidade de tempo real tenha decorrido.

(Herdado de Object)
Wait(Int64)

Faz com que o thread atual aguarde até que ele seja despertado, normalmente por ser <>notificado</em> ou <em>interrompido</em>, ou até que uma determinada quantidade de tempo real tenha decorrido.

(Herdado de Object)

Implantações explícitas de interface

Nome Description
IComparable.CompareTo(Object)

Compara esse valor com o objeto especificado para ordenação.
IEnumerable.GetEnumerator()

Retorna um enumerador não genérico para os caracteres nesta sequência.
IJavaPeerable.Disposed()

A String classe representa cadeias de caracteres.

(Herdado de JavaObject)
IJavaPeerable.Finalized()

A String classe representa cadeias de caracteres.

(Herdado de JavaObject)
IJavaPeerable.JniObjectReferenceControlBlock

A String classe representa cadeias de caracteres.

(Herdado de JavaObject)
IJavaPeerable.SetJniIdentityHashCode(Int32)

A String classe representa cadeias de caracteres.

(Herdado de JavaObject)
IJavaPeerable.SetJniManagedPeerState(JniManagedPeerStates)

A String classe representa cadeias de caracteres.

(Herdado de JavaObject)
IJavaPeerable.SetPeerReference(JniObjectReference)

A String classe representa cadeias de caracteres.

(Herdado de JavaObject)
IJavaPeerable.UnregisterFromRuntime()

A String classe representa cadeias de caracteres.

Métodos de Extensão

Nome Description
GetJniTypeName(IJavaPeerable)

Obtém o nome JNI do tipo da instância self.
JavaAs<TResult>(IJavaPeerable)

Tente coagir a digitar selfTResult, verificando se a coerção é válida no lado Java.
JavaCast<TResult>(IJavaObject)

Executa uma conversão de tipo verificada pelo tempo de execução do Android.
JavaCast<TResult>(IJavaObject)

A String classe representa cadeias de caracteres.
SubSequence(ICharSequence, Int32, Int32)

Retorna a subsequência de caractere dentro do intervalo especificado.
TryJavaCast<TResult>(IJavaPeerable, TResult)

Tente coagir a digitar selfTResult, verificando se a coerção é válida no lado Java.

Aplica-se a