Tipos · token heredoc
Heredoc
Contenido multilínea con descriptor opcional. Ideal para HTML, SQL o scripts.
Reglas
- Comienza con <<< seguido de un descriptor opcional, por ejemplo HTML o SCRIPT.
- El contenido empieza en la línea siguiente y debe tener más indentación que la declaración.
- Termina cuando aparece un token con indentación igual o menor a la de la declaración.
- El contenido (payload) se obtiene quitando la menor indentación mayor que la de la declaración a todas las líneas.
- Si no hay token de cierre, consume el resto del contenido.
- Para controlar con precisión espacios e indentación, usa strings en lugar de heredocs.
Ejemplos
Básico
template <<<HTML
<div>
<h1>Hello</h1>
</div>Sin descriptor
template <<<
foo
tarDentro de un bloque
server {
response <<<HTML
<html>
<body>Content</body>
</html>
handler
}Notas
- Dentro de un bloque, la llave de cierre } tiene menos indentación y cierra el heredoc.
- En JavaScript llega como HeredocValue, con descriptor (null si se omite) y content. El nombre anterior, delimiter, se acepta al decodificar JSON pero está en desuso.