String.Intern Method
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Returns a canonical representation for the string object.
[Android.Runtime.Register("intern", "()Ljava/lang/String;", "")]
public string Intern ();[<Android.Runtime.Register("intern", "()Ljava/lang/String;", "")>]
member this.Intern : unit -> stringReturns
a string that has the same contents as this string, but is guaranteed to be from a pool of unique strings.
- Attributes
Remarks
Returns a canonical representation for the string object.
A pool of strings, initially empty, is maintained privately by the class String.
When the intern method is invoked, if the pool already contains a string equal to this String object as determined by the #equals(Object) method, then the string from the pool is returned. Otherwise, this String object is added to the pool and a reference to this String object is returned.
It follows that for any two strings s and t, s.intern() == t.intern() is true if and only if s.equals(t) is true.
All literal strings and string-valued constant expressions are interned. String literals are defined in section 3.10.5 of the <cite>The Java™ Language Specification</cite>.
Java documentation for java.lang.String.intern().
Portions of this page are modifications based on work created and shared by the Android Open Source Project and used according to terms described in the Creative Commons 2.5 Attribution License.