Slex (Simusol lex) es una biblioteca de análisis léxico escrita en C, reentrante y basada en PCRE2. Divide un texto en tokens —palabras, números, símbolos o instrucciones— mediante expresiones regulares. Cada contexto mantiene su propio estado; distintos contextos pueden ejecutarse concurrentemente, aunque un mismo contexto debe usarse desde un solo hilo a la vez. Se desarrolló para los lenguajes del proyecto Simusol, pero puede incorporarse a otros programas. Es software libre, con licencia GPL versión 3 o posterior.

Un lexer reconoce las piezas del texto; un parser interpreta cómo se combinan. Slex puede alimentar un parser de Bison o entregar directamente los tokens y sus capturas a un programa C. No es por sí solo un compilador, un resolvedor de ecuaciones ni un integrador.

Qué puede hacer

Descargas e instalación

Los paquetes están en las descargas de Simusol, dentro del directorio de Slex. Se ofrecen paquetes DEB, RPM y TGZ y, cuando esté publicado, el archivo de fuentes. Hay que elegir el formato, la distribución y la arquitectura que correspondan; un binario no es universal.

Con curl instalado, descargar y ejecutar el instalador de SummaPack:

curl -fsSLO https://www.simusol.org/downloads/installsumma.sh &&
sh installsumma.sh slex

El instalador permite elegir el formato disponible. Para pedir DEB explícitamente, por ejemplo en Debian o Ubuntu:

sh installsumma.sh --para deb slex

Esto instala SummaPack si hace falta y solicita los paquetes del proyecto Slex con sus dependencias. Puede requerir permisos de administrador. Revisar el script antes de ejecutarlo y usar únicamente fuentes de confianza: instalar paquetes ejecuta código.

Si SummaPack ya está instalado:

bajar-paquetes --para deb --instalar slex

Para compilar el ejemplo se necesitan además un compilador C y pkg-config. Para construir el proyecto desde sus fuentes se usan Autoconf, Automake, Libtool, Bison, PCRE2, mem_util y unidades; el empaquetado DEB agrega debhelper. Los nombres concretos de las dependencias cambian según la distribución.

Primer ejemplo en C

Guardar lo siguiente como ejemplo.c. Las reglas reconocen palabras y enteros positivos; los blancos llevan código cero y se omiten mediante slex_ctx_set_skip. Es un ejemplo deliberadamente pequeño, no un lexer completo de C ni de expresiones numéricas.

Compilar y ejecutar:

cc -std=c11 -Wall -Wextra ejemplo.c -o ejemplo $(pkg-config --cflags --libs slex)
./ejemplo

Salida esperada:

1 temperatura
2 25

Para leer las reglas desde un archivo se reemplaza slex_ctx_ini_string(ctx, reglas) por slex_ctx_ini_file(ctx, "reglas.slex"). Los números finales de cada regla son códigos elegidos por la aplicación. Para usar acciones, se registran con slex_ctx_register antes de cargar las reglas.

La API actual

La API histórica (ini_slex, get_token y otras funciones sin contexto explícito) se conserva por compatibilidad sobre un contexto predeterminado. Para código nuevo se recomienda la API por contexto. La compatibilidad no convierte automáticamente una aplicación antigua en reentrante: también debe separar su propio estado y sus acciones.

Uso en Simusol: d2datdinc

d2datdinc es una aplicación de Slex, no otro nombre de la biblioteca. Lee circuitos del formato SCEPTRE .d y de los formatos .ds/.ds2, interpreta sus secciones y construye un árbol de datos en memoria. Puede guardar ese árbol como JSON .dat o generar directamente ecuaciones .din para Calcula, sin escribir y volver a leer un JSON intermedio.

d2datdinc circuito.d
d2datdinc circuito.ds -o -
d2datdinc --din circuito.ds

• La primera orden genera circuito.dat; la segunda escribe JSON por la salida estándar.
• La tercera genera los sistemas según la selección de métodos de la entrada. Los nombres incorporan el método: no se debe suponer un único archivo llamado circuito.din.
• Los avisos y errores van a la salida de error; -v habilita avisos y -d N las trazas.
• La generación de ecuaciones y descriptores de RK, GLM, IMEX, Rosenbrock o composición pertenece al conversor y a din/, con límites propios de cada método. Slex solamente analiza el texto.
• La simulación posterior corresponde a Siru y Calcula, instalados separadamente.

Otros programas que usan Slex

En Calcula, las expresiones matemáticas de los sistemas dinámicos las compila ExprTk: reconocer la estructura del archivo con Slex no sustituye ese trabajo. Las peticiones del protocolo --machine se leen por líneas en machine.c, sin pasar por el lexer de órdenes; la carga del sistema .din sí utiliza su lector Slex/Bison.

Uso con Bison

El lexer entrega el código de token que espera la gramática; la aplicación conecta ese resultado con yylex, el valor semántico y la ubicación. Para parsers independientes se usa %define api.pure full, parámetros de contexto y %locations; si conviven varias gramáticas también se separan sus prefijos. La prueba tests/bison/ muestra esa conexión. Las reglas .slex no son intercambiables con archivos de Lex/Flex.

Alcance y cuidados

• Un mismo contexto debe usarse desde un solo hilo del sistema a la vez. Distintos contextos pueden trabajar en distintos hilos; los datos compartidos por las acciones de la aplicación necesitan su propia protección.
• Las columnas se cuentan en bytes desde uno, no en caracteres visuales de Unicode.
• El texto y las capturas pertenecen al historial del contexto. No se deben usar después de olvidar los tokens, reiniciar o liberar ese contexto. En lecturas largas conviene administrar ese historial.
• La biblioteca tiene límites de recursos y de ejecución; el costo depende de las expresiones regulares. No se promete memoria ilimitada ni superioridad de velocidad frente a Flex.
• La API por contexto informa errores. Algunas rutas de la API histórica conservan el comportamiento de terminar el proceso ante errores fatales.

Documentación y ejemplos en las fuentes

La documentación detallada está en el árbol de fuentes del proyecto. Los paquetes de ejecución no necesariamente incluyen todos estos documentos; esta página no presupone que los PDF estén publicados en un directorio web de documentos.