<?php
include_once $_SERVER['DOCUMENT_ROOT'] . '/include/shared-manual.inc';
$TOC = array();
$TOC_DEPRECATED = array();
$PARENTS = array();
include_once dirname(__FILE__) ."/toc/ref.classobj.inc";
$setup = array (
  'home' => 
  array (
    0 => 'index.php',
    1 => 'PHP Manual',
  ),
  'head' => 
  array (
    0 => 'UTF-8',
    1 => 'de',
  ),
  'this' => 
  array (
    0 => 'function.get-class.php',
    1 => 'get_class',
    2 => 'Ermittelt den Klassennamen eines Objekts',
  ),
  'up' => 
  array (
    0 => 'ref.classobj.php',
    1 => 'Klassen- und Objekt-Funktionen',
  ),
  'prev' => 
  array (
    0 => 'function.get-called-class.php',
    1 => 'get_called_class',
  ),
  'next' => 
  array (
    0 => 'function.get-class-methods.php',
    1 => 'get_class_methods',
  ),
  'alternatives' => 
  array (
  ),
  'source' => 
  array (
    'lang' => 'de',
    'path' => 'reference/classobj/functions/get-class.xml',
  ),
  'history' => 
  array (
  ),
);
$setup["toc"] = $TOC;
$setup["toc_deprecated"] = $TOC_DEPRECATED;
$setup["parents"] = $PARENTS;
manual_setup($setup);

contributors($setup);

?>
<div id="function.get-class" class="refentry">
 <div class="refnamediv">
  <h1 class="refname">get_class</h1>
  <p class="verinfo">(PHP 4, PHP 5, PHP 7, PHP 8)</p><p class="refpurpose"><span class="refname">get_class</span> &mdash; <span class="dc-title">Ermittelt den Klassennamen eines Objekts</span></p>

 </div>
 <div class="refsect1 description" id="refsect1-function.get-class-description">
  <h3 class="title">Beschreibung</h3>
  <div class="methodsynopsis dc-description">
   <span class="methodname"><strong>get_class</strong></span>(<span class="methodparam"><span class="type"><a href="language.types.object.php" class="type object">object</a></span> <code class="parameter">$object</code><span class="initializer"> = ?</span></span>): <span class="type"><a href="language.types.string.php" class="type string">string</a></span></div>

  <p class="para rdfs-comment">
   Ermittelt den Klassennamen für das übergebene <code class="parameter">object</code>.
  </p>
 </div>

 <div class="refsect1 parameters" id="refsect1-function.get-class-parameters">
  <h3 class="title">Parameter-Liste</h3>
  <p class="para">
   <dl>
    
     <dt><code class="parameter">object</code></dt>
     <dd>
      <p class="para">
       Das zu untersuchende Objekt.
      </p>
      <blockquote class="note"><p><strong class="note">Hinweis</strong>: 
       <span class="simpara">
        Die explizite Übergabe von <strong><code><a href="reserved.constants.php#constant.null">null</a></code></strong> als <code class="parameter">object</code> ist
        von PHP 7.2.0 an nicht mehr erlaubt und erzeugt einen
        <strong><code><a href="errorfunc.constants.php#constant.e-warning">E_WARNING</a></code></strong>-Hinweis. Seit PHP 8.0.0 wird ein
        <span class="classname"><a href="class.typeerror.php" class="classname">TypeError</a></span> ausgegeben, wenn <strong><code><a href="reserved.constants.php#constant.null">null</a></code></strong> verwendet
        wird.
       </span>
      </p></blockquote>
     </dd>
    
   </dl>
  </p>
 </div>

 <div class="refsect1 returnvalues" id="refsect1-function.get-class-returnvalues">
  <h3 class="title">Rückgabewerte</h3>
  <p class="para">
   Gibt den Namen der Klasse zurück, von der <code class="parameter">object</code>
   eine Instanz ist.
  </p>
  <p class="para">
   Ist <code class="parameter">object</code> eine Instanz einer Klasse in einem
   Namensraum, wird der qualifizierte Name dieser Klasse zurückgegeben.
  </p>
 </div>

 <div class="refsect1 errors" id="refsect1-function.get-class-errors">
  <h3 class="title">Fehler/Exceptions</h3>
  <p class="para">
   Wenn <span class="function"><strong>get_class()</strong></span> mit etwas anderem als einem Objekt
   aufgerufen wird, wird ein <span class="classname"><a href="class.typeerror.php" class="classname">TypeError</a></span> erzeugt. Vor
   PHP 8.0.0 wurde ein Fehler der Stufe <strong><code><a href="errorfunc.constants.php#constant.e-warning">E_WARNING</a></code></strong>
   erzeugt.
  </p>
  <p class="para">
   Wenn <span class="function"><strong>get_class()</strong></span> ohne Parameter von außerhalb einer
   Klasse aufgerufen wird, wird ein <span class="classname"><a href="class.error.php" class="classname">Error</a></span> erzeugt. Vor
   PHP 8.0.0 wurde ein Fehler der Stufe <strong><code><a href="errorfunc.constants.php#constant.e-warning">E_WARNING</a></code></strong> erzeugt.
  </p>
 </div>

 <div class="refsect1 changelog" id="refsect1-function.get-class-changelog">
  <h3 class="title">Changelog</h3>
  <p class="para">
   <table class="doctable informaltable">
    
     <thead>
      <tr>
       <th>Version</th>
       <th>Beschreibung</th>
      </tr>

     </thead>

     <tbody class="tbody">
      <tr>
       <td>8.3.0</td>
       <td>
        Wenn <span class="function"><strong>get_class()</strong></span> ohne Argument aufgerufen wird,
        führt dies nun zu einer <strong><code><a href="errorfunc.constants.php#constant.e-deprecated">E_DEPRECATED</a></code></strong>-Warnung;
        zuvor gab diese Funktion, wenn sie innerhalb einer Klasse aufgerufen
        wurde, den Namen dieser Klasse zurück.
       </td>
      </tr>

      <tr>
       <td>8.0.0</td>
       <td>
        Der Aufruf dieser Funktion von außerhalb einer Klasse ohne jegliche
        Parameter löst nun einen <span class="classname"><a href="class.error.php" class="classname">Error</a></span> aus. Zuvor wurde,
        wurde ein <strong><code><a href="errorfunc.constants.php#constant.e-warning">E_WARNING</a></code></strong> erzeugt und die Funktion gab
        <strong><code><a href="reserved.constants.php#constant.false">false</a></code></strong> zurück.
       </td>
      </tr>

      <tr>
       <td>7.2.0</td>
       <td>
        Vor dieser Version war der Standardwert für <code class="parameter">object</code>
        <strong><code><a href="reserved.constants.php#constant.null">null</a></code></strong>, was denselben Effekt hatte wie das Auslassen dieses Parameters.
        Nun wurde <strong><code><a href="reserved.constants.php#constant.null">null</a></code></strong> als Standardwert für <code class="parameter">object</code>
        entfernt und ist keine gültige Eingabe mehr.
       </td>
      </tr>

     </tbody>
    
   </table>

  </p>
 </div>

 <div class="refsect1 examples" id="refsect1-function.get-class-examples">
  <h3 class="title">Beispiele</h3>
  <p class="para">
   <div class="example" id="example-1">
    <p><strong>Beispiel #1 <span class="function"><strong>get_class()</strong></span>-Beispiel</strong></p>
    <div class="example-contents">
<div class="phpcode"><code><span style="color: #000000"><span style="color: #0000BB">&lt;?php<br /><br /></span><span style="color: #007700">class </span><span style="color: #0000BB">foo </span><span style="color: #007700">{<br />    function </span><span style="color: #0000BB">name</span><span style="color: #007700">()<br />    {<br />        echo </span><span style="color: #DD0000">"Mein Name ist " </span><span style="color: #007700">, </span><span style="color: #0000BB">get_class</span><span style="color: #007700">(</span><span style="color: #0000BB">$this</span><span style="color: #007700">) , </span><span style="color: #DD0000">"\n"</span><span style="color: #007700">;<br />    }<br />}<br /><br /></span><span style="color: #FF8000">// create an object<br /></span><span style="color: #0000BB">$bar </span><span style="color: #007700">= new </span><span style="color: #0000BB">foo</span><span style="color: #007700">();<br /><br /></span><span style="color: #FF8000">// external call<br /></span><span style="color: #007700">echo </span><span style="color: #DD0000">"Der Name ist " </span><span style="color: #007700">, </span><span style="color: #0000BB">get_class</span><span style="color: #007700">(</span><span style="color: #0000BB">$bar</span><span style="color: #007700">) , </span><span style="color: #DD0000">"\n"</span><span style="color: #007700">;<br /><br /></span><span style="color: #FF8000">// internal call<br /></span><span style="color: #0000BB">$bar</span><span style="color: #007700">-&gt;</span><span style="color: #0000BB">name</span><span style="color: #007700">();<br /><br /></span><span style="color: #0000BB">?&gt;</span></span></code></div>
    </div>

    <div class="example-contents"><p>Das oben gezeigte Beispiel erzeugt folgende Ausgabe:</p></div>
    <div class="example-contents screen">
<div class="examplescode"><pre class="examplescode">Der Name ist foo
Mein Name ist foo</pre>
</div>
    </div>
   </div>
   <div class="example" id="example-2">
    <p><strong>Beispiel #2 Einsatz von <span class="function"><strong>get_class()</strong></span> in einer Elternklasse</strong></p>
    <div class="example-contents">
<div class="phpcode"><code><span style="color: #000000"><span style="color: #0000BB">&lt;?php<br /><br /></span><span style="color: #007700">abstract class </span><span style="color: #0000BB">bar </span><span style="color: #007700">{<br />    public function </span><span style="color: #0000BB">__construct</span><span style="color: #007700">()<br />    {<br />        </span><span style="color: #0000BB">var_dump</span><span style="color: #007700">(</span><span style="color: #0000BB">get_class</span><span style="color: #007700">(</span><span style="color: #0000BB">$this</span><span style="color: #007700">));<br />        </span><span style="color: #0000BB">var_dump</span><span style="color: #007700">(</span><span style="color: #0000BB">get_class</span><span style="color: #007700">());<br />    }<br />}<br /><br />class </span><span style="color: #0000BB">foo </span><span style="color: #007700">extends </span><span style="color: #0000BB">bar </span><span style="color: #007700">{<br />}<br /><br />new </span><span style="color: #0000BB">foo</span><span style="color: #007700">;<br /><br /></span><span style="color: #0000BB">?&gt;</span></span></code></div>
    </div>

    <div class="example-contents"><p>Das oben gezeigte Beispiel erzeugt folgende Ausgabe:</p></div>
    <div class="example-contents screen">
<div class="examplescode"><pre class="examplescode">string(3) &quot;foo&quot;
string(3) &quot;bar&quot;</pre>
</div>
    </div>
   </div>
   <div class="example" id="example-3">
    <p><strong>Beispiel #3 Verwendung von <span class="function"><strong>get_class()</strong></span> mit Klassen in Namensräumen</strong></p>
    <div class="example-contents">
<div class="phpcode"><code><span style="color: #000000"><span style="color: #0000BB">&lt;?php<br /><br /></span><span style="color: #007700">namespace </span><span style="color: #0000BB">Foo\Bar</span><span style="color: #007700">;<br /><br />class </span><span style="color: #0000BB">Baz </span><span style="color: #007700">{<br />    public function </span><span style="color: #0000BB">__construct</span><span style="color: #007700">()<br />    {<br /><br />    }<br />}<br /><br /></span><span style="color: #0000BB">$baz </span><span style="color: #007700">= new </span><span style="color: #0000BB">\Foo\Bar\Baz</span><span style="color: #007700">;<br /><br /></span><span style="color: #0000BB">var_dump</span><span style="color: #007700">(</span><span style="color: #0000BB">get_class</span><span style="color: #007700">(</span><span style="color: #0000BB">$baz</span><span style="color: #007700">));<br /></span><span style="color: #0000BB">?&gt;</span></span></code></div>
    </div>

    <div class="example-contents"><p>Das oben gezeigte Beispiel erzeugt folgende Ausgabe:</p></div>
    <div class="example-contents screen">
<div class="examplescode"><pre class="examplescode">string(11) &quot;Foo\Bar\Baz&quot;</pre>
</div>
    </div>
   </div>
  </p>
 </div>

 <div class="refsect1 seealso" id="refsect1-function.get-class-seealso">
  <h3 class="title">Siehe auch</h3>
  <p class="para">
   <ul class="simplelist">
    <li><span class="function"><a href="function.get-called-class.php" class="function" rel="rdfs-seeAlso">get_called_class()</a> - Ermittelt den Namen der von einer statischen Methode aufgerufenen Klasse (&quot;Late Static Binding&quot;)</span></li>
    <li><span class="function"><a href="function.get-parent-class.php" class="function" rel="rdfs-seeAlso">get_parent_class()</a> - Gibt den Namen der Elternklasse eines Objektes zur&uuml;ck</span></li>
    <li><span class="function"><a href="function.gettype.php" class="function" rel="rdfs-seeAlso">gettype()</a> - Liefert den Datentyp einer Variablen</span></li>
    <li><span class="function"><a href="function.get-debug-type.php" class="function" rel="rdfs-seeAlso">get_debug_type()</a> - Gets the type name of a variable in a way that is suitable for debugging</span></li>
    <li><span class="function"><a href="function.is-subclass-of.php" class="function" rel="rdfs-seeAlso">is_subclass_of()</a> - Pr&uuml;ft ob ein Objekt von der angegebenen Klasse abstammt oder sie implementiert</span></li>
   </ul>
  </p>
 </div>


</div><?php manual_footer($setup); ?>