Vad är ett här dokument?

I relation till datorer och datorprogrammering är ett här dokument en lista med text som används för att definiera ingångar som ska skickas till ett program genom användning av en speciell operatör så att exceptionellt långa block med kommandon eller text lättare kan skickas. "Här dokument", eller "heredoc", är mer en allmän term eftersom den exakta implementeringen av hur ett här dokument fungerar och vad det kan innehålla kommer att variera från ett operativsystem, applikation eller programmeringsspråk till det nästa. Trots vad namnet antyder är ett här dokument vanligtvis inte en separat fil, utan är istället ett textblock i ett skript eller på något sätt skrivs eller infogas direkt i slutet av ett programkommando. Huvudanvändningen för ett här-dokument kommer när program körs via ett skript eller en batchfil från kommandoraden, där heredoc innehåller antingen en lista med instruktioner för ett program att utföra eller mata in för programmet att bearbeta. Beroende på många faktorer kan ett här dokument vara en enkel lista med ord eller det kan innehålla komplexa variabler eller programmeringskod som operativsystemet eller målapplikationen kan dechiffrera.

I de mest grundläggande termerna är ett här dokument bara en lista med text som innehåller formateringstecken som flikar, vagnreturer och rader. Det är ett bekvämt sätt att överföra argument till ett program som körs från kommandoraden, särskilt om en omslagsfil som ett skript eller en batchfil används. Texten i en heredoc skickas till det körande programmet som om det skrivs in av användaren exakt som det ser ut. Detta gör att en enda heredoc kan användas om och om igen för att ge ett program samma ingång så att den kan utföra samma uppgifter upprepade gånger utan att kräva att användaren faktiskt matar in allt manuellt.

Ett exempel på hur ett här dokument fungerar kan ses med ett enkelt kommandorads sendmail-program som skickar e-post. När det körs ber sändmail-programmet först användaren att ange destinations-e-postadressen; sedan frågar det efter ämnet för e-postmeddelandet och slutligen e-posttexten. Om den körs från kommandoraden svarar användaren på varje prompt genom att skriva in informationen, slå returtangenten och vänta på att programmet ska svara. När en heredoc används i en wrapper-fil kan all information som ska ges till sendmail-programmet skrivas ut i förväg, inklusive returtangenterna och sparas i wrapper-filen. På detta sätt, när sendmail-programmet körs med heredoc, matas ingången automatiskt till programmet och ett e-postmeddelande skickas utan att kräva att användaren gör något mer.