Añadir docs para val() y val2().

Author: dato

abb_aux.c

@@ -7,6 +7,9 @@
 #include <stdlib.h>
 #include <string.h>
 
+#define VAL(key) (key[0])
+#define VAL2(val) (val * 2)
+
 /*
  * Realiza una serie de operaciones leídas por entrada estándar.
  */
@@ -19,7 +22,7 @@ int main(void) {
   while (getline(&linea, &tam, stdin) >= 0) {
     const char *key = linea + 1;
     void *val;
-    intptr_t ival = *key;
+    intptr_t ival = VAL(key);
 
     switch (*linea) {
     case 'G':
@@ -35,7 +38,7 @@ int main(void) {
 
     case 'R':
       // Reemplazar
-      printf("OK %d\n", abb_guardar(abb, key, (void*) (ival*2)));
+      printf("OK %d\n", abb_guardar(abb, key, (void*) VAL2(ival)));
       break;
 
     case 'O':

abb_test.py

@@ -220,12 +220,19 @@ def setUp(self):
                                  stderr=subprocess.PIPE)
 
 
-def val(x):
-  return x + ord("0")
+def val(key):
+  """Valor guardado en el ABB: código ASCII del primer caracter.
+
+  Debe estar sincronizado con la implementación en C.
+  """
+  assert key < 10  # El código C no soporta double-digits.
+  return key + ord("0")
 
 
-def val2(x):
-  return val(x) * 2
+def val2(key):
+  """Valor para los reemplazos del ABB: el doble del primer valor.
+  """
+  return val(key) * 2
 
 
 if __name__ == "__main__":