]> git.llucax.com Git - z.facultad/75.43/tp1.git/blobdiff - src/lib/file.log.php
Se pone antes el parámetro caption porque es más probable que se use que summary.
[z.facultad/75.43/tp1.git] / src / lib / file.log.php
index be05b963fa84aa4f6853c07228490d7e915d1826..bcdcb41dec8be0807d29e6fd634e33e9c1b61855 100644 (file)
 require_once 'lib/file.php';
 
 /**
- * Obtiene el log de un usuario
+ * Abre el archivo de log.
  *
- * @return array con id, password, email (false si hubo error o no está).
+ * @return false si hubo error, el file pointer del archivo si se abrió bien.
  */
 function file_log_open($user)
 {
-    return fopen($filename, 'r');
+    return fopen("data/log.$user.csv", 'r');
 }
 
 /**
- * Obtiene el log de un usuario
+ * Obtiene el próximo mensaje del log.
  *
- * @return array con id, password, email (false si hubo error o no está).
+ * @return array con (fecha, mensaje) o false si no hay más.
  */
 function file_log_next($fp)
 {
@@ -31,20 +31,20 @@ function file_log_next($fp)
 }
 
 /**
- * Obtiene el log de un usuario
+ * Se posiciona en un mensaje de log determinado.
  *
- * @return array con id, password, email (false si hubo error o no está).
+ * @return false si hubo error.
  */
 function file_log_seek($fp, $pos)
 {
-    while (!feof($f) and $pos--) fgetcsv($fp, 4096);
+    while (!feof($fp) and $pos--) fgetcsv($fp, 4096);
     return !$pos;
 }
 
 /**
- * Obtiene el log de un usuario
+ * Se posiciona en el primer mensaje de log que sea posterior a $fecha_desde.
  *
- * @return array con id, password, email (false si hubo error o no está).
+ * @return posición del archivo donde empiezan los mensajes posteriores.
  */
 function file_log_seek_fecha($fp, $fecha_desde)
 {
@@ -66,9 +66,9 @@ function file_log_seek_fecha($fp, $fecha_desde)
 }
 
 /**
- * Obtiene el log de un usuario
+ * Cierra el archivo de log
  *
- * @return array con id, password, email (false si hubo error o no está).
+ * @return false si hay error.
  */
 function file_log_close($fp)
 {
@@ -76,9 +76,10 @@ function file_log_close($fp)
 }
 
 /**
- * Obtiene la información de un usuario.
+ * Obtiene la cantidad de mensajes de log que hay para un usuario.
+ * Si se especifica $fecha_desde, se cuentan sólo los posteriores a esa fecha.
  *
- * @return array con id, password, email (false si hubo error o no está).
+ * @return cantidad de mensajes de log.
  */
 function file_log_count($user, $fecha_desde = null)
 {
@@ -91,9 +92,9 @@ function file_log_count($user, $fecha_desde = null)
 }
 
 /**
- * Guarda un nuevo usuario.
+ * Agrega un nuevo mensaje de log.
  *
- * @return bool false si hay error o ya existe.
+ * @return bool false si hay error.
  */
 function file_log_add($user, $msg)
 {