|
6 | 6 | assert = |
7 | 7 | 'Alsa un error si el valor de sus argumentos es falso. (ej: `nil` ó `falso`); de lo contrario, retorna todos sus argumentos. En caso de error, `message` es el mensaje de error; cuando se omite, el valor predeterminado es `"assertion failed!"`' |
8 | 8 |
|
9 | | -cgopt.collect = |
10 | | -'Realiza un ciclo completo de recolección de basura.' |
11 | | -cgopt.stop = |
12 | | -'Detiene la ejecución automática.' |
13 | | -cgopt.restart = |
14 | | -'Reinicia la ejecución automática.' |
15 | | -cgopt.count = |
16 | | -'Retorna el total de memoria en Kbytes.' |
17 | | -cgopt.step = |
18 | | -[[ |
19 | | -Realiza un paso de recolección de basura. Esta opción puede seguirse por un entero `size`. |
20 | | -Si `size` es un n positivo, el recolector actúa como si se hubieran asignado n nuevos bytes; si `size` es cero, realiza un paso básico. |
21 | | -En modo incremental, un paso básico corresponde al tamaño de paso actual; en modo generacional, un paso básico realiza una recolección menor completa, |
22 | | -o un paso incremental si el recolector ha agendado uno. |
23 | | -En modo incremental, la función retorna `true` si el paso terminó un ciclo de recolección; en modo generacional, retorna `true` si el paso terminó una recolección mayor. |
24 | | -]] |
25 | | -cgopt.setpause = |
26 | | -'Establece la pausa.' |
27 | | -cgopt.setstepmul = |
28 | | -'Establece el multiplicador para el paso de recolección de basura.' |
29 | | -cgopt.incremental = |
30 | | -'Cambia el modo del recolector a incremental y retorna el modo anterior (sea `"generational"` o `"incremental"`).' |
31 | | -cgopt.generational = |
32 | | -'Cambia el modo del recolector a generacional y retorna el modo anterior (sea `"generational"` o `"incremental"`).' |
33 | | -cgopt.param = |
34 | | -[[ |
35 | | -Cambia y/o recupera los valores de un parámetro del recolector. Esta opción debe ir seguida de uno o dos argumentos adicionales: |
36 | | -el nombre del parámetro (una cadena) y un nuevo valor opcional (un entero en el rango [0,100000]). |
37 | | -La llamada siempre retorna el valor anterior del parámetro; si no se da un nuevo valor, el valor se mantiene sin cambios. |
38 | | -Lua almacena estos valores en un formato comprimido, por lo que el valor retornado como anterior puede no ser exactamente el último valor establecido. |
39 | | -]] |
40 | | - |
41 | | -gcparam.minormul = |
42 | | -'El multiplicador menor.' |
43 | | -gcparam.majorminor = |
44 | | -'El multiplicador mayor-menor.' |
45 | | -gcparam.minormajor = |
46 | | -'El multiplicador menor-mayor.' |
47 | | -gcparam.pause = |
48 | | -'La pausa del recolector de basura.' |
49 | | -gcparam.stepmul = |
50 | | -'El multiplicador de paso.' |
51 | | -gcparam.stepsize = |
52 | | -'El tamaño del paso.' |
53 | | - |
54 | | -cgopt.isrunning = |
55 | | -'Retorna si el recolector está corriendo.' |
56 | | - |
57 | | -collectgarbage = |
58 | | -[[ |
59 | | -Interfaz genérica al recolector de basura. Según el primer argumento `opt`, realiza: |
60 | | -• `"collect"`: Realiza un ciclo completo de recolección de basura (opción predeterminada). |
61 | | -• `"stop"`: Detiene la ejecución automática; el recolector corre sólo cuando se invoca explícitamente, hasta `"restart"`. |
62 | | -• `"restart"`: Reinicia la ejecución automática. |
63 | | -• `"count"`: Retorna la memoria total usada por Lua en Kbytes (fraccionario; multiplique por 1024 para bytes). |
64 | | -• `"step"`: Realiza un paso de recolección; entero opcional `size` controla el comportamiento y el retorno (vea `cgopt.step`). |
65 | | -• `"isrunning"`: Retorna si el recolector está corriendo (es decir, no detenido). |
66 | | -• `"incremental"`: Cambia el modo a incremental y retorna el modo anterior. |
67 | | -• `"generational"`: Cambia el modo a generacional y retorna el modo anterior. |
68 | | -• `"param"`: Cambia/lee parámetros del recolector (vea `gcparam.*`), siempre retorna el valor anterior. |
| 9 | +collectgarbage51 = |
| 10 | +[[ |
| 11 | +Esta función es una interfaz genérica para el recolector de basura. Realiza diferentes funciones según su primer argumento, opt: |
| 12 | +
|
| 13 | +* `"collect"`: realiza un ciclo completo de recolección de basura. Esta es la opción predeterminada. |
| 14 | +* `"stop"`: detiene el recolector de basura. |
| 15 | +* `"restart"`: reinicia el recolector de basura. |
| 16 | +* `"count"`: retorna la memoria total en uso por Lua (en Kbytes). |
| 17 | +* `"step"`: realiza un paso de recolección de basura. El "tamaño" del paso es controlado por arg (valores más grandes significan más pasos) de una manera no especificada. Si desea controlar el tamaño del paso, debe ajustar experimentalmente el valor de arg. Retorna true si el paso terminó un ciclo de recolección. |
| 18 | +* `"setpause"`: establece arg como el nuevo valor para la pausa del recolector (ver §2.10). Retorna el valor anterior de pausa. |
| 19 | +* `"setstepmul"`: establece arg como el nuevo valor para el multiplicador de paso del recolector (ver §2.10). Retorna el valor anterior del multiplicador de paso. |
| 20 | +]] |
| 21 | + |
| 22 | +collectgarbage52 = |
| 23 | +[[ |
| 24 | +Esta función es una interfaz genérica para el recolector de basura. Realiza diferentes funciones según su primer argumento, opt: |
| 25 | +
|
| 26 | +* `"collect"`: realiza un ciclo completo de recolección de basura. Esta es la opción predeterminada. |
| 27 | +* `"stop"`: detiene la ejecución automática del recolector de basura. El recolector solo se ejecutará cuando se invoque explícitamente, hasta una llamada para reiniciarlo. |
| 28 | +* `"restart"`: reinicia la ejecución automática del recolector de basura. |
| 29 | +* `"count"`: retorna la memoria total en uso por Lua (en Kbytes) y un segundo valor con la memoria total en bytes módulo 1024. El primer valor tiene una parte fraccionaria, por lo que la siguiente igualdad siempre es verdadera: |
| 30 | + ```lua |
| 31 | + k, b = collectgarbage("count") |
| 32 | + assert(k*1024 == math.floor(k)*1024 + b) |
| 33 | + ``` |
| 34 | + (El segundo resultado es útil cuando Lua se compila con un tipo no flotante para números.) |
| 35 | +* `"step"`: realiza un paso de recolección de basura. El "tamaño" del paso es controlado por arg (valores más grandes significan más pasos) de una manera no especificada. Si desea controlar el tamaño del paso, debe ajustar experimentalmente el valor de arg. Retorna true si el paso terminó un ciclo de recolección. |
| 36 | +* `"setpause"`: establece arg como el nuevo valor para la pausa del recolector (ver §2.5). Retorna el valor anterior de pausa. |
| 37 | +* `"setstepmul"`: establece arg como el nuevo valor para el multiplicador de paso del recolector (ver §2.5). Retorna el valor anterior del multiplicador de paso. |
| 38 | +* `"isrunning"`: retorna un booleano que indica si el recolector está en ejecución (es decir, no detenido). |
| 39 | +* `"generational"`: cambia el recolector al modo generacional. Esta es una característica experimental (ver §2.5). |
| 40 | +* `"incremental"`: cambia el recolector al modo incremental. Este es el modo predeterminado. |
| 41 | +]] |
| 42 | + |
| 43 | +collectgarbage53 = |
| 44 | +[[ |
| 45 | +Esta función es una interfaz genérica para el recolector de basura. Realiza diferentes funciones según su primer argumento, opt: |
| 46 | +
|
| 47 | +* `"collect"`: realiza un ciclo completo de recolección de basura. Esta es la opción predeterminada. |
| 48 | +* `"stop"`: detiene la ejecución automática del recolector de basura. El recolector solo se ejecutará cuando se invoque explícitamente, hasta una llamada para reiniciarlo. |
| 49 | +* `"restart"`: reinicia la ejecución automática del recolector de basura. |
| 50 | +* `"count"`: retorna la memoria total en uso por Lua en Kbytes. El valor tiene una parte fraccionaria, por lo que multiplicado por 1024 da el número exacto de bytes en uso por Lua (excepto por desbordamientos). |
| 51 | +* `"step"`: realiza un paso de recolección de basura. El "tamaño" del paso es controlado por arg. Con un valor cero, el recolector realizará un paso básico (indivisible). Para valores distintos de cero, el recolector se comportará como si esa cantidad de memoria (en KBytes) hubiera sido asignada por Lua. Retorna true si el paso terminó un ciclo de recolección. |
| 52 | +* `"setpause"`: establece arg como el nuevo valor para la pausa del recolector (ver §2.5). Retorna el valor anterior de pausa. |
| 53 | +* `"setstepmul"`: establece arg como el nuevo valor para el multiplicador de paso del recolector (ver §2.5). Retorna el valor anterior del multiplicador de paso. |
| 54 | +* "isrunning"`: retorna un booleano que indica si el recolector está en ejecución (es decir, no detenido). |
| 55 | +]] |
| 56 | + |
| 57 | +collectgarbage54 = |
| 58 | +[[ |
| 59 | +Esta función es una interfaz genérica para el recolector de basura. Realiza diferentes funciones según su primer argumento, opt: |
| 60 | +
|
| 61 | +* `"collect"`: Realiza un ciclo completo de recolección de basura. Esta es la opción predeterminada. |
| 62 | +* `"stop"`: Detiene la ejecución automática del recolector de basura. El recolector solo se ejecutará cuando se invoque explícitamente, hasta una llamada para reiniciarlo. |
| 63 | +* `"restart"`: Reinicia la ejecución automática del recolector de basura. |
| 64 | +* `"count"`: Retorna la memoria total en uso por Lua en Kbytes. El valor tiene una parte fraccionaria, por lo que multiplicado por 1024 da el número exacto de bytes en uso por Lua. |
| 65 | +* `"step"`: Realiza un paso de recolección de basura. El "tamaño" del paso es controlado por arg. Con un valor cero, el recolector realizará un paso básico (indivisible). Para valores distintos de cero, el recolector se comportará como si esa cantidad de memoria (en Kbytes) hubiera sido asignada por Lua. Retorna true si el paso terminó un ciclo de recolección. |
| 66 | +* `"isrunning"`: Retorna un booleano que indica si el recolector está en ejecución (es decir, no detenido). |
| 67 | +* `"incremental"`: Cambia el modo del recolector a incremental. Esta opción puede ir seguida de tres números: la pausa del recolector de basura, el multiplicador de paso y el tamaño del paso (ver §2.5.1). Un cero significa no cambiar ese valor. |
| 68 | +* `"generational"`: Cambia el modo del recolector a generacional. Esta opción puede ir seguida de dos números: el multiplicador menor del recolector de basura y el multiplicador mayor (ver §2.5.2). Un cero significa no cambiar ese valor. |
| 69 | +Vea §2.5 para más detalles sobre la recolección de basura y algunas de estas opciones. |
| 70 | +
|
| 71 | +Esta función no debe ser llamada por un finalizador. |
| 72 | +]] |
| 73 | + |
| 74 | +collectgarbage55 = |
| 75 | +[[ |
| 76 | +Esta función es una interfaz genérica para el recolector de basura. Realiza diferentes funciones según su primer argumento, opt: |
| 77 | +
|
| 78 | +* `"collect"`: Realiza un ciclo completo de recolección de basura. Esta es la opción predeterminada. |
| 79 | +* `"stop"`: Detiene la ejecución automática del recolector de basura. El recolector solo se ejecutará cuando se invoque explícitamente, hasta una llamada para reiniciarlo. |
| 80 | +* `"restart"`: Reinicia la ejecución automática del recolector de basura. |
| 81 | +* `"count"`: Retorna la memoria total en uso por Lua en Kbytes. El valor tiene una parte fraccionaria, por lo que multiplicado por 1024 da el número exacto de bytes en uso por Lua. |
| 82 | +* `"step"`: Realiza un paso de recolección de basura. Esta opción puede ir seguida de un argumento adicional, un entero con el tamaño del paso. |
| 83 | +
|
| 84 | + Si el tamaño es un n positivo, el recolector actúa como si se hubieran asignado n nuevos bytes. Si el tamaño es cero, el recolector realiza un paso básico. En modo incremental, un paso básico corresponde al tamaño de paso actual. En modo generacional, un paso básico realiza una recolección menor completa o un paso incremental, si el recolector ha programado uno. |
| 85 | +
|
| 86 | + En modo incremental, la función retorna true si el paso terminó un ciclo de recolección. En modo generacional, la función retorna true si el paso terminó una recolección mayor. |
| 87 | +
|
| 88 | +* `"isrunning"`: Retorna un booleano que indica si el recolector está en ejecución (es decir, no detenido). |
| 89 | +* `"incremental"`: Cambia el modo del recolector a incremental y retorna el modo anterior. |
| 90 | +* `"generational"`: Cambia el modo del recolector a generacional y retorna el modo anterior. |
| 91 | +* `"param"`: Cambia y/o recupera los valores de un parámetro del recolector. Esta opción debe ir seguida de uno o dos argumentos adicionales: El nombre del parámetro que se cambia o recupera (una cadena) y un nuevo valor opcional para ese parámetro, un entero en el rango [0,100000]. El primer argumento debe tener uno de los siguientes valores: |
| 92 | + * `"minormul"`: El multiplicador menor. |
| 93 | + * `"majorminor"`: El multiplicador mayor-menor. |
| 94 | + * `"minormajor"`: El multiplicador menor-mayor. |
| 95 | + * `"pause"`: La pausa del recolector de basura. |
| 96 | + * `"stepmul"`: El multiplicador de paso. |
| 97 | + * `"stepsize"`: El tamaño del paso. |
| 98 | +
|
| 99 | + La llamada siempre retorna el valor anterior del parámetro. Si la llamada no proporciona un nuevo valor, el valor permanece sin cambios. |
| 100 | +
|
| 101 | + Lua almacena estos valores en un formato comprimido, por lo que el valor retornado como valor anterior puede no ser exactamente el último valor establecido. |
| 102 | +
|
| 103 | +Vea §2.5 para más detalles sobre la recolección de basura y algunas de estas opciones. |
| 104 | +
|
| 105 | +Esta función no debe ser llamada por un finalizador. |
69 | 106 | ]] |
70 | 107 |
|
71 | 108 | dofile = |
|
0 commit comments