<!DOCTYPE html>

<html> <head> <meta charset=“UTF-8”>

<title>class P5_T_34::Interface - RDoc Documentation</title>

<link href=“../fonts.css” rel=“stylesheet”> <link href=“../rdoc.css” rel=“stylesheet”>

<script type=“text/javascript”>

var rdoc_rel_prefix = "../";

</script>

<script src=“../js/jquery.js”></script> <script src=“../js/navigation.js”></script> <script src=“../js/search_index.js”></script> <script src=“../js/search.js”></script> <script src=“../js/searcher.js”></script> <script src=“../js/darkfish.js”></script>

<body id=“top” role=“document” class=“class”> <nav role=“navigation”>

<div id="project-navigation">
  <div id="home-section" role="region" title="Quick navigation" class="nav-section">
<h2>
  <a href="../index.html" rel="home">Home</a>
</h2>

<div id="table-of-contents-navigation">
  <a href="../table_of_contents.html#pages">Pages</a>
  <a href="../table_of_contents.html#classes">Classes</a>
  <a href="../table_of_contents.html#methods">Methods</a>
</div>

</div>

  <div id="search-section" role="search" class="project-section initially-hidden">
<form action="#" method="get" accept-charset="utf-8">
  <div id="search-field-wrapper">
    <input id="search-field" role="combobox" aria-label="Search"
           aria-autocomplete="list" aria-controls="search-results"
           type="text" name="search" placeholder="Search" spellcheck="false"
           title="Type to search, Up and Down to navigate, Enter to load">
  </div>

  <ul id="search-results" aria-label="Search Results"
      aria-busy="false" aria-expanded="false"
      aria-atomic="false" class="initially-hidden"></ul>
</form>

</div>

</div>

<div id="class-metadata">

  <div id="parent-class-section" class="nav-section">
<h3>Parent</h3>

<p class="link">Object

</div>

<!-- Method Quickref -->

<div id=“method-list-section” class=“nav-section”>

<h3>Methods</h3>

<ul class="link-list" role="directory">

  <li ><a href="#method-c-new">::new</a>

  <li ><a href="#method-i-showQuestions">#showQuestions</a>

  <li ><a href="#method-i-simulation">#simulation</a>

  <li ><a href="#method-i-solve">#solve</a>

  <li ><a href="#method-i-solve_to_s">#solve_to_s</a>

  <li ><a href="#method-i-sortIQuestions">#sortIQuestions</a>

  <li ><a href="#method-i-sortQuestions">#sortQuestions</a>

</ul>

</div>

</div>

</nav>

<main role=“main” aria-labelledby=“class-P5_T_34::Interface”>

<h1 id="class-P5_T_34::Interface" class="class">
  class P5_T_34::Interface
</h1>

<section class="description">

<p>Define la interfaz para manipular un exámen (inicializarlo, orodenarlo, corregirlo…)</p>

</section>

<section id="5Buntitled-5D" class="documentation-section">

  <section class="attribute-method-details" class="method-section">
    <header>
      <h3>Attributes</h3>
    </header>

    <div id="attribute-i-calification" class="method-detail">
      <div class="method-heading attribute-method-heading">
        <span class="method-name">calification</span><span
          class="attribute-access-type">[R]</span>
      </div>

      <div class="method-description">

      </div>
    </div>

    <div id="attribute-i-correct" class="method-detail">
      <div class="method-heading attribute-method-heading">
        <span class="method-name">correct</span><span
          class="attribute-access-type">[R]</span>
      </div>

      <div class="method-description">

      </div>
    </div>

    <div id="attribute-i-exam" class="method-detail">
      <div class="method-heading attribute-method-heading">
        <span class="method-name">exam</span><span
          class="attribute-access-type">[R]</span>
      </div>

      <div class="method-description">

      </div>
    </div>

    <div id="attribute-i-incorrect" class="method-detail">
      <div class="method-heading attribute-method-heading">
        <span class="method-name">incorrect</span><span
          class="attribute-access-type">[R]</span>
      </div>

      <div class="method-description">

      </div>
    </div>

    <div id="attribute-i-inverseProc" class="method-detail">
      <div class="method-heading attribute-method-heading">
        <span class="method-name">inverseProc</span><span
          class="attribute-access-type">[R]</span>
      </div>

      <div class="method-description">

      </div>
    </div>

  </section>

   <section id="public-class-5Buntitled-5D-method-details" class="method-section">
     <header>
       <h3>Public Class Methods</h3>
     </header>

    <div id="method-c-new" class="method-detail ">

      <div class="method-heading">
        <span class="method-name">new</span><span
          class="method-args">(examI)</span>

        <span class="method-click-advice">click to toggle source</span>

      </div>

      <div class="method-description">

        <div class="method-source-code" id="new-source">
          <pre><span class="ruby-comment"># File lib/P5_T_34/Interface.rb, line 11</span>

<span class=“ruby-keyword”>def</span> <span class=“ruby-identifier”>initialize</span>(<span class=“ruby-identifier”>examI</span>)

<span class="ruby-ivar">@exam</span> = <span class="ruby-identifier">examI</span> <span class="ruby-comment"># Objeto de tipo Exam que contendrá las preguntas a corregir</span>
<span class="ruby-ivar">@calification</span> = <span class="ruby-value">0</span>; <span class="ruby-comment"># Calificación final después de realizar una corrección</span>
<span class="ruby-ivar">@correct</span> = <span class="ruby-value">0</span>; <span class="ruby-comment"># Número de respuestas correctas</span>
<span class="ruby-ivar">@incorrect</span> = <span class="ruby-value">0</span>; <span class="ruby-comment"># Número de respuestas incorrectas</span>

<span class="ruby-comment"># Objeto Proc utilizado para el orden descendente de las preguntas</span>
<span class="ruby-ivar">@inverseProc</span> = <span class="ruby-constant">Proc</span>.<span class="ruby-identifier">new</span> { <span class="ruby-operator">|</span><span class="ruby-identifier">first</span>, <span class="ruby-identifier">second</span><span class="ruby-operator">|</span> <span class="ruby-identifier">second</span> <span class="ruby-operator">&lt;=&gt;</span> <span class="ruby-identifier">first</span> }

<span class=“ruby-keyword”>end</span></pre>

      </div>

    </div>

  </div>

</section>

 <section id="public-instance-5Buntitled-5D-method-details" class="method-section">
   <header>
     <h3>Public Instance Methods</h3>
   </header>

  <div id="method-i-showQuestions" class="method-detail ">

    <div class="method-heading">
      <span class="method-name">showQuestions</span><span
        class="method-args">()</span>

      <span class="method-click-advice">click to toggle source</span>

    </div>

    <div class="method-description">

      <p>Muestra las preguntas en el orden actual de corrección</p>

      <div class="method-source-code" id="showQuestions-source">
        <pre><span class="ruby-comment"># File lib/P5_T_34/Interface.rb, line 28</span>

<span class=“ruby-keyword”>def</span> <span class=“ruby-identifier”>showQuestions</span> ()

<span class="ruby-ivar">@exam</span>.<span class="ruby-identifier">to_s</span>

<span class=“ruby-keyword”>end</span></pre>

    </div>

  </div>

</div>

<div id="method-i-simulation" class="method-detail ">

  <div class="method-heading">
    <span class="method-name">simulation</span><span
      class="method-args">(answers)</span>

    <span class="method-click-advice">click to toggle source</span>

  </div>

  <div class="method-description">

    <p>Muestra por pantalla la solución de un exámen paso a paso</p>

    <div class="method-source-code" id="simulation-source">
      <pre><span class="ruby-comment"># File lib/P5_T_34/Interface.rb, line 22</span>

<span class=“ruby-keyword”>def</span> <span class=“ruby-identifier”>simulation</span>(<span class=“ruby-identifier”>answers</span>)

<span class="ruby-identifier">sortQuestions</span>
<span class="ruby-identifier">solve_to_s</span>(<span class="ruby-identifier">answers</span>)

<span class=“ruby-keyword”>end</span></pre>

    </div>

  </div>

</div>

<div id="method-i-solve" class="method-detail ">

  <div class="method-heading">
    <span class="method-name">solve</span><span
      class="method-args">(answers)</span>

    <span class="method-click-advice">click to toggle source</span>

  </div>

  <div class="method-description">

    <p>Resolver el exámen obteniendo las repuestas en un array. Retorna la

calificación obtenida.</p>

<div class="method-source-code" id="solve-source">
  <pre><span class="ruby-comment"># File lib/P5_T_34/Interface.rb, line 50</span>

<span class=“ruby-keyword”>def</span> <span class=“ruby-identifier”>solve</span> (<span class=“ruby-identifier”>answers</span>)

<span class="ruby-comment"># Inicializamos variables</span>
<span class="ruby-ivar">@correct</span> = <span class="ruby-value">0</span>
<span class="ruby-ivar">@incorrect</span> = <span class="ruby-value">0</span>
<span class="ruby-ivar">@calification</span> = <span class="ruby-value">0</span>
<span class="ruby-identifier">cont</span> = <span class="ruby-value">0</span>

<span class="ruby-ivar">@exam</span>.<span class="ruby-identifier">each</span> { <span class="ruby-operator">|</span><span class="ruby-identifier">act</span><span class="ruby-operator">|</span>
    <span class="ruby-keyword">if</span> (<span class="ruby-identifier">answers</span>[<span class="ruby-identifier">cont</span>] <span class="ruby-operator">==</span> <span class="ruby-identifier">act</span>.<span class="ruby-identifier">correct</span>) <span class="ruby-keyword">then</span>
        <span class="ruby-ivar">@correct</span> <span class="ruby-operator">+=</span> <span class="ruby-value">1</span>
    <span class="ruby-keyword">else</span>
        <span class="ruby-ivar">@incorrect</span> <span class="ruby-operator">+=</span> <span class="ruby-value">1</span>
    <span class="ruby-keyword">end</span>
    <span class="ruby-identifier">cont</span> <span class="ruby-operator">+=</span> <span class="ruby-value">1</span> <span class="ruby-comment"># Siguiente respuesta</span>
}
<span class="ruby-ivar">@calification</span> = ((<span class="ruby-ivar">@correct</span> <span class="ruby-operator">*</span> <span class="ruby-value">10</span>) <span class="ruby-operator">/</span> (<span class="ruby-ivar">@exam</span>.<span class="ruby-identifier">size</span>))

<span class=“ruby-keyword”>end</span></pre>

    </div>

  </div>

</div>

<div id="method-i-solve_to_s" class="method-detail ">

  <div class="method-heading">
    <span class="method-name">solve_to_s</span><span
      class="method-args">(answers)</span>

    <span class="method-click-advice">click to toggle source</span>

  </div>

  <div class="method-description">

    <p>Resolver el exámen obteniendo las respuestas en un array. Retorna un string

que contiene todas las preguntas del exámen con sus respuestas corregidas y la calificación final.</p>

<div class="method-source-code" id="solve_to_s-source">
  <pre><span class="ruby-comment"># File lib/P5_T_34/Interface.rb, line 72</span>

<span class=“ruby-keyword”>def</span> <span class=“ruby-identifier”>solve_to_s</span> (<span class=“ruby-identifier”>answers</span>)

<span class="ruby-comment">#Inicializamos variables</span>
<span class="ruby-ivar">@correct</span> = <span class="ruby-value">0</span>
<span class="ruby-ivar">@incorrect</span> = <span class="ruby-value">0</span>
<span class="ruby-ivar">@calification</span> = <span class="ruby-value">0</span>
<span class="ruby-identifier">cont</span> = <span class="ruby-value">0</span>
<span class="ruby-comment">#Comenzamos el examen</span>
<span class="ruby-identifier">texto</span> = <span class="ruby-string">&quot;\nTitulo del examen: &quot;</span> <span class="ruby-operator">+</span> <span class="ruby-ivar">@exam</span>.<span class="ruby-identifier">title</span> <span class="ruby-operator">+</span> <span class="ruby-string">&quot;\n ---------------------------------------------------------------------- \n&quot;</span>

<span class="ruby-ivar">@exam</span>.<span class="ruby-identifier">each</span> { <span class="ruby-operator">|</span><span class="ruby-identifier">act</span><span class="ruby-operator">|</span>
    <span class="ruby-identifier">texto</span> <span class="ruby-operator">+=</span> <span class="ruby-identifier">cont</span>.<span class="ruby-identifier">to_s</span> <span class="ruby-operator">+</span> <span class="ruby-string">&quot;)  &quot;</span> <span class="ruby-operator">+</span> <span class="ruby-identifier">act</span>.<span class="ruby-identifier">to_s</span> <span class="ruby-operator">+</span> <span class="ruby-string">&quot;\n ------------------------ \n Respuesta: &quot;</span> <span class="ruby-operator">+</span> <span class="ruby-identifier">answers</span>[<span class="ruby-identifier">cont</span>].<span class="ruby-identifier">to_s</span>
    <span class="ruby-keyword">if</span> (<span class="ruby-identifier">answers</span>[<span class="ruby-identifier">cont</span>] <span class="ruby-operator">==</span> <span class="ruby-identifier">act</span>.<span class="ruby-identifier">correct</span>) <span class="ruby-keyword">then</span>
        <span class="ruby-ivar">@correct</span> <span class="ruby-operator">+=</span> <span class="ruby-value">1</span>
        <span class="ruby-identifier">texto</span> <span class="ruby-operator">+=</span> <span class="ruby-string">&quot; \t ---&gt; Respuesta Correcta\n ------------------------\n&quot;</span>
    <span class="ruby-keyword">else</span>
        <span class="ruby-ivar">@incorrect</span> <span class="ruby-operator">+=</span> <span class="ruby-value">1</span>
        <span class="ruby-identifier">texto</span> <span class="ruby-operator">+=</span> <span class="ruby-string">&quot; \t ---&gt; Respuesta Incorrecta\n ------------------------\n\n&quot;</span>
    <span class="ruby-keyword">end</span>
    <span class="ruby-identifier">cont</span> <span class="ruby-operator">+=</span> <span class="ruby-value">1</span> <span class="ruby-comment">#Siguiente respuesta</span>
}

<span class="ruby-ivar">@calification</span> = ((<span class="ruby-ivar">@correct</span> <span class="ruby-operator">*</span> <span class="ruby-value">10</span>)<span class="ruby-operator">/</span> (<span class="ruby-ivar">@exam</span>.<span class="ruby-identifier">size</span>))
<span class="ruby-identifier">texto</span> <span class="ruby-operator">+=</span> <span class="ruby-string">&quot;Calificación final: &quot;</span> <span class="ruby-operator">+</span> <span class="ruby-ivar">@calification</span>.<span class="ruby-identifier">to_s</span>
<span class="ruby-keyword">return</span> <span class="ruby-identifier">texto</span>

<span class=“ruby-keyword”>end</span></pre>

    </div>

  </div>

</div>

<div id="method-i-sortIQuestions" class="method-detail ">

  <div class="method-heading">
    <span class="method-name">sortIQuestions</span><span
      class="method-args">()</span>

    <span class="method-click-advice">click to toggle source</span>

  </div>

  <div class="method-description">

    <p>Ordena las preguntas usando el objeto Proc predefinido en la clase, que

realiza una ordenación descendente.</p>

<div class="method-source-code" id="sortIQuestions-source">
  <pre><span class="ruby-comment"># File lib/P5_T_34/Interface.rb, line 44</span>

<span class=“ruby-keyword”>def</span> <span class=“ruby-identifier”>sortIQuestions</span>

<span class="ruby-identifier">sortQuestions</span> <span class="ruby-operator">&amp;</span><span class="ruby-ivar">@inverseProc</span>

<span class=“ruby-keyword”>end</span></pre>

    </div>

  </div>

</div>

<div id="method-i-sortQuestions" class="method-detail ">

  <div class="method-heading">
    <span class="method-name">sortQuestions</span><span
      class="method-args">(&sortProc)</span>

    <span class="method-click-advice">click to toggle source</span>

  </div>

  <div class="method-description">

    <p>Ordena las preguntas según el bloque que se le pase. En caso de no pasarle

un bloque, se ordena de forma ascendente</p>

<div class="method-source-code" id="sortQuestions-source">
  <pre><span class="ruby-comment"># File lib/P5_T_34/Interface.rb, line 35</span>

<span class=“ruby-keyword”>def</span> <span class=“ruby-identifier”>sortQuestions</span> (<span class=“ruby-operator”>&amp;</span><span class=“ruby-identifier”>sortProc</span>)

<span class="ruby-identifier">titleTmp</span> = <span class="ruby-ivar">@exam</span>.<span class="ruby-identifier">title</span>
<span class="ruby-identifier">aux</span> = <span class="ruby-constant">Exam</span>.<span class="ruby-identifier">new</span>(<span class="ruby-identifier">titleTmp</span>)
<span class="ruby-identifier">aux</span>.<span class="ruby-identifier">push</span>(<span class="ruby-operator">*</span>(<span class="ruby-ivar">@exam</span>.<span class="ruby-identifier">sort</span> <span class="ruby-operator">&amp;</span><span class="ruby-identifier">sortProc</span>))
<span class="ruby-ivar">@exam</span> = <span class="ruby-identifier">aux</span>

<span class=“ruby-keyword”>end</span></pre>

        </div>

      </div>

    </div>

  </section>

</section>

</main>

<footer id=“validator-badges” role=“contentinfo”>

<p><a href="http://validator.w3.org/check/referer">Validate</a>
<p>Generated by <a href="http://rdoc.rubyforge.org">RDoc</a> 4.1.0.
<p>Based on <a href="http://deveiate.org/projects/Darkfish-Rdoc/">Darkfish</a> by <a href="http://deveiate.org">Michael Granger</a>.

</footer>