<?php
include_once $_SERVER['DOCUMENT_ROOT'] . '/include/shared-manual.inc';
$TOC = array();
$TOC_DEPRECATED = array();
$PARENTS = array();
include_once dirname(__FILE__) ."/toc/ref.exec.inc";
$setup = array (
  'home' => 
  array (
    0 => 'index.php',
    1 => 'PHP Manual',
  ),
  'head' => 
  array (
    0 => 'UTF-8',
    1 => 'es',
  ),
  'this' => 
  array (
    0 => 'function.proc-nice.php',
    1 => 'proc_nice',
    2 => 'Modifica la prioridad de ejecuci&oacute;n del proceso actual',
  ),
  'up' => 
  array (
    0 => 'ref.exec.php',
    1 => 'Funciones de ejecuci&oacute;n de programas',
  ),
  'prev' => 
  array (
    0 => 'function.proc-get-status.php',
    1 => 'proc_get_status',
  ),
  'next' => 
  array (
    0 => 'function.proc-open.php',
    1 => 'proc_open',
  ),
  'alternatives' => 
  array (
  ),
  'source' => 
  array (
    'lang' => 'es',
    'path' => 'reference/exec/functions/proc-nice.xml',
  ),
  'history' => 
  array (
  ),
);
$setup["toc"] = $TOC;
$setup["toc_deprecated"] = $TOC_DEPRECATED;
$setup["parents"] = $PARENTS;
manual_setup($setup);

contributors($setup);

?>
<div id="function.proc-nice" class="refentry">
 <div class="refnamediv">
  <h1 class="refname">proc_nice</h1>
  <p class="verinfo">(PHP 5, PHP 7, PHP 8)</p><p class="refpurpose"><span class="refname">proc_nice</span> &mdash; <span class="dc-title">Modifica la prioridad de ejecución del proceso actual</span></p>

 </div>

 <div class="refsect1 description" id="refsect1-function.proc-nice-description">
  <h3 class="title">Descripción</h3>
  <div class="methodsynopsis dc-description">
   <span class="methodname"><strong>proc_nice</strong></span>(<span class="methodparam"><span class="type"><a href="language.types.integer.php" class="type int">int</a></span> <code class="parameter">$priority</code></span>): <span class="type"><a href="language.types.boolean.php" class="type bool">bool</a></span></div>

  <p class="para rdfs-comment">
   <span class="function"><strong>proc_nice()</strong></span> modifica la prioridad del proceso actual
   mediante el argumento especificado <code class="parameter">priority</code>.
   Un argumento <code class="parameter">priority</code> positivo reducirá la
   prioridad del proceso actual, mientras que un valor negativo
   <code class="parameter">priority</code> aumentará la prioridad.
  </p>
  <p class="para">
   <span class="function"><strong>proc_nice()</strong></span> no está relacionado con
   <span class="function"><a href="function.proc-open.php" class="function">proc_open()</a></span> ni con sus funciones asociadas de ninguna manera.
  </p>
 </div>


 <div class="refsect1 parameters" id="refsect1-function.proc-nice-parameters">
  <h3 class="title">Parámetros</h3>
  <p class="para">
   <dl>
    
     <dt><code class="parameter">priority</code></dt>
     <dd>
      <p class="para">
       El nuevo valor de prioridad, este valor puede variar según la plataforma.
      </p>
      <p class="para">
       En Unix, un valor bajo, como <code class="literal">-20</code> indica una prioridad alta, mientras que un valor positivo indica una prioridad baja.
      </p>
      <p class="para">
       Para Windows, el argumento <code class="parameter">priority</code> tiene las
       siguientes significaciones:
      </p>
      <table class="doctable informaltable">
       
        <thead>
         <tr>
          <th>Clase de prioridad</th>
          <th>Valores posibles</th>
         </tr>

        </thead>

        <tbody class="tbody">
         <tr>
          <td style="vertical-align: top;">Prioridad alta</td>
          <td style="vertical-align: top;">
           <code class="parameter">priority</code> <code class="literal">&lt; -9</code>
          </td>
         </tr>

         <tr>
          <td style="vertical-align: top;">Por encima de la prioridad normal</td>
          <td style="vertical-align: top;">
           <code class="parameter">priority</code> <code class="literal">&lt; -4</code>
          </td>
         </tr>

         <tr>
          <td style="vertical-align: top;">Prioridad normal</td>
          <td style="vertical-align: top;">
           <code class="parameter">priority</code> <code class="literal">&lt; 5</code> &amp;
           <code class="parameter">priority</code> <code class="literal">&gt; -5</code>
          </td>
         </tr>

         <tr>
          <td style="vertical-align: top;">Por debajo de la prioridad normal</td>
          <td style="vertical-align: top;">
           <code class="parameter">priority</code> <code class="literal">&gt; 5</code>
          </td>
         </tr>

         <tr>
          <td style="vertical-align: top;">Prioridad inactiva</td>
          <td style="vertical-align: top;">
           <code class="parameter">priority</code> <code class="literal">&gt; 9</code>
          </td>
         </tr>

        </tbody>
       
      </table>

     </dd>
    
   </dl>
  </p>
 </div>


 <div class="refsect1 returnvalues" id="refsect1-function.proc-nice-returnvalues">
  <h3 class="title">Valores devueltos</h3>
  <p class="para">
   Esta función retorna <strong><code><a href="reserved.constants.php#constant.true">true</a></code></strong> en caso de éxito o <strong><code><a href="reserved.constants.php#constant.false">false</a></code></strong> si ocurre un error.
   Si ocurre un error, por ejemplo, si el usuario que intenta cambiar la prioridad de un proceso no tiene
   suficientes permisos para hacerlo, se genera un error de nivel
   <strong><code><a href="errorfunc.constants.php#constant.e-warning">E_WARNING</a></code></strong> y se devuelve <strong><code><a href="reserved.constants.php#constant.false">false</a></code></strong>.
  </p>
 </div>


 <div class="refsect1 changelog" id="refsect1-function.proc-nice-changelog">
  <h3 class="title">Historial de cambios</h3>
  <p class="para">
   <table class="doctable informaltable">
    
     <thead>
      <tr>
       <th>Versión</th>
       <th>Descripción</th>
      </tr>

     </thead>

     <tbody class="tbody">
      <tr>
       <td>7.2.0</td>
       <td>
        Esta función está ahora disponible en Windows.
       </td>
      </tr>

     </tbody>
    
   </table>

  </p>
 </div>


 <div class="refsect1 examples" id="refsect1-function.proc-nice-examples">
  <h3 class="title">Ejemplos</h3>
  <p class="para">
   <div class="example" id="example-1">
    <p><strong>Ejemplo #1 Uso de <span class="function"><strong>proc_nice()</strong></span> para establecer una prioridad de proceso alta</strong></p>
    <div class="example-contents">
<div class="phpcode"><code><span style="color: #000000"><span style="color: #0000BB">&lt;?php<br /></span><span style="color: #FF8000">// Prioridad más alta<br /></span><span style="color: #0000BB">proc_nice</span><span style="color: #007700">(-</span><span style="color: #0000BB">20</span><span style="color: #007700">);<br /></span><span style="color: #0000BB">?&gt;</span></span></code></div>
    </div>

   </div>
  </p>

 </div>


 <div class="refsect1 notes" id="refsect1-function.proc-nice-notes">
  <h3 class="title">Notas</h3>
  <blockquote class="note"><p><strong class="note">Nota</strong>: 
   <strong>Disponibilidad</strong><br />
   <p class="para">
    <span class="function"><strong>proc_nice()</strong></span> solo está disponible en sistemas que
    disponen de capacidades NICE. NICE es compatible con: SVr4, SVID EXT,
    AT&amp;T, X/OPEN, BSD 4.3.
   </p>
  </p></blockquote>
  <blockquote class="note"><p><strong class="note">Nota</strong>: 
   <strong>Solo Windows</strong><br />
   <p class="para">
    <span class="function"><strong>proc_nice()</strong></span> cambiará la prioridad del <em>proceso</em>
    actual incluso si PHP ha sido compilado utilizando la
    seguridad de hilos.
   </p>
  </p></blockquote>
 </div>


 <div class="refsect1 seealso" id="refsect1-function.proc-nice-seealso">
  <h3 class="title">Ver también</h3>
  <ul class="simplelist">
   <li><span class="function"><a href="function.pcntl-setpriority.php" class="function" rel="rdfs-seeAlso">pcntl_setpriority()</a> - Cambia la prioridad de un proceso</span></li>
  </ul>
 </div>


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