mirror of
https://gitflic.ru/project/openide/openide.git
synced 2026-01-07 05:09:37 +07:00
2faaa1dfa3
#IDEA-312778 fixed (Red fonts in JavaDoc comments for unresolved links are too bright and eye catching) GitOrigin-RevId: d9045aa1d5ef10320d343a0924b14eb26aa54441
60 lines
4.7 KiB
HTML
60 lines
4.7 KiB
HTML
<html><head><base href="placeholder"></head><body><div class="bottom"><icon src="AllIcons.Nodes.Package"> <a href="psi_element://java.lang"><code><span style="color:#000000;">java.lang</span></code></a></div><div class='definition'><pre><span style="color:#000080;font-weight:bold;">public final</span> <span style="color:#000080;font-weight:bold;">class</span> <span style="color:#000000;">String</span>
|
|
<span style="color:#000080;font-weight:bold;">implements</span> <a href="psi_element://java.io.Serializable"><code><span style="color:#000000;">java.io.Serializable</span></code></a><span style="">,</span> <a href="psi_element://java.lang.Comparable"><code><span style="color:#000000;">Comparable</span></code></a><span style=""><</span><a href="psi_element://java.lang.String"><code><span style="color:#000000;">String</span></code></a><span style="">></span><span style="">,</span> <a href="psi_element://java.lang.CharSequence"><code><span style="color:#000000;">CharSequence</span></code></a></pre></div><div class='content'>
|
|
The <code>String</code> class represents character strings. All
|
|
string literals in Java programs, such as <code>"abc"</code>, are
|
|
implemented as instances of this class.
|
|
<p>
|
|
Strings are constant; their values cannot be changed after they
|
|
are created. String buffers support mutable strings.
|
|
Because String objects are immutable they can be shared. For example:
|
|
<p><blockquote><pre>
|
|
String str = "abc";
|
|
</pre></blockquote><p>
|
|
is equivalent to:
|
|
<p><blockquote><pre>
|
|
char data[] = {'a', 'b', 'c'};
|
|
String str = new String(data);
|
|
</pre></blockquote><p>
|
|
Here are some more examples of how strings can be used:
|
|
<p><blockquote><pre>
|
|
System.out.println("abc");
|
|
String cde = "cde";
|
|
System.out.println("abc" + cde);
|
|
String c = "abc".substring(2,3);
|
|
String d = cde.substring(1, 2);
|
|
</pre></blockquote>
|
|
<p>
|
|
The class <code>String</code> includes methods for examining
|
|
individual characters of the sequence, for comparing strings, for
|
|
searching strings, for extracting substrings, and for creating a
|
|
copy of a string with all characters translated to uppercase or to
|
|
lowercase. Case mapping is based on the Unicode Standard version
|
|
specified by the <a href="psi_element://java.lang.Character"><code><span style="color:#0000ff;">Character</span></code></a> class.
|
|
<p>
|
|
The Java language provides special support for the string
|
|
concatenation operator ( + ), and for conversion of
|
|
other objects to strings. String concatenation is implemented
|
|
through the <code>StringBuilder</code>(or <code>StringBuffer</code>)
|
|
class and its <code>append</code> method.
|
|
String conversions are implemented through the method
|
|
<code>toString</code>, defined by <code>Object</code> and
|
|
inherited by all classes in Java. For additional information on
|
|
string concatenation and conversion, see Gosling, Joy, and Steele,
|
|
<i>The Java Language Specification</i>.
|
|
|
|
<p> Unless otherwise noted, passing a <tt>null</tt> argument to a constructor
|
|
or method in this class will cause a <a href="psi_element://java.lang.NullPointerException"><code><span style="color:#0000ff;">NullPointerException</span></code></a> to be
|
|
thrown.
|
|
|
|
<p>A <code>String</code> represents a string in the UTF-16 format
|
|
in which <em>supplementary characters</em> are represented by <em>surrogate
|
|
pairs</em> (see the section <a href="psi_element://java.lang.Character###unicode">Unicode
|
|
Character Representations</a> in the <code>Character</code> class for
|
|
more information).
|
|
Index values refer to <code>char</code> code units, so a supplementary
|
|
character uses two positions in a <code>String</code>.
|
|
<p>The <code>String</code> class provides methods for dealing with
|
|
Unicode code points (i.e., characters), in addition to those for
|
|
dealing with Unicode code units (i.e., <code>char</code> values).
|
|
|
|
</div><table class='sections'><p><tr><td valign='top' class='section'><p>Since:</td><td valign='top'><p> JDK1.0</td><tr><td valign='top' class='section'><p>See Also:</td><td valign='top'><p><a href="psi_element://java.lang.Object#toString()"><code><span style="color:#0000ff;">Object</span><span style="">.</span><span style="color:#0000ff;">toString</span><span style="">()</span></code></a>,<br><a href="psi_element://java.lang.StringBuffer"><code><span style="color:#0000ff;">StringBuffer</span></code></a>,<br><a href="psi_element://java.lang.StringBuilder"><code><span style="color:#0000ff;">StringBuilder</span></code></a>,<br><span style="color:#ff0000">java.nio.charset.Charset</span></td><tr><td valign='top' class='section'><p>Author:</td><td valign='top'><p>Lee Boynton, Arthur van Hoff, Martin Buchholz, Ulf Zibis</td></table> |