Mikä on tässä oleva asiakirja?

Tietokoneiden ja tietokoneohjelmoinnin osalta tässä asiakirjassa on luettelo tekstistä, jota käytetään määrittelemään ohjelmaan syötettävä syöttö käyttämällä erityistä operaattoria, joten poikkeuksellisen pitkät komentolohkot tai tekstit voidaan siirtää helpommin. “Here document” tai “heredoc” on enemmänkin yleinen termi, koska täsmällinen toteutus siitä, miten here -asiakirja toimii ja mitä se voi sisältää, vaihtelee käyttöjärjestelmän, sovelluksen tai ohjelmointikielen mukaan. Huolimatta siitä, mitä nimi tarkoittaa, tässä dokumentti ei yleensä ole erillinen tiedosto, vaan se on tekstilohko komentosarjassa tai jollakin tavalla kirjoitettu tai lisätty suoraan ohjelmakomennon loppuun. Tässä asiakirjassa käytetään pääasiassa, kun ohjelmat suoritetaan komentoriviltä komentosarjan tai erätiedoston kautta, jossa heredoc antaa joko luettelon ohjelman suorittamista koskevista ohjeista tai syöttää ohjelman käsiteltäväksi. Tässä asiakirjassa voi monista tekijöistä riippuen olla yksinkertainen sanaluettelo tai se voi sisältää monimutkaisia ​​muuttujia tai ohjelmointikoodin, jonka käyttöjärjestelmä tai kohdesovellus voi tulkita.

Yksinkertaisimmillaan tässä dokumentti on vain luettelo tekstistä, joka sisältää muotoilumerkkejä, kuten välilehdet, rivinvaihdot ja rivinvaihdot. Se on kätevä tapa välittää argumentteja komentoriviltä suoritettavalle ohjelmalle, varsinkin jos käytetään kääritiedostoa, kuten komentosarjaa tai erätiedostoa. Heredocin sisältämä teksti lähetetään suorittavalle ohjelmalle ikään kuin käyttäjä olisi kirjoittanut sen juuri sellaisena kuin se näyttää. Tämä mahdollistaa yhden heredocin käytön yhä uudelleen ja uudelleen, jotta ohjelma saa saman tulon, jotta se voi suorittaa samat tehtävät toistuvasti ilman, että käyttäjän tarvitsee syöttää kaikki tiedot uudelleen manuaalisesti.

Yksi esimerkki tästä asiakirjan toiminnasta voidaan nähdä yksinkertaisella komentorivin sendmail -ohjelmalla, joka lähettää sähköpostia. Suoritettaessa sendmail -ohjelma pyytää ensin käyttäjää syöttämään kohdesähköpostiosoitteen; se kysyy sitten sähköpostin aiheen ja lopuksi sähköpostin tekstin. Jos suoritetaan komentoriviltä, ​​käyttäjä vastaa jokaiseen kehotteeseen kirjoittamalla tiedot, painamalla palautusnäppäintä ja odottamalla ohjelman vastausta. Kun heredocia käytetään kääritiedostossa, kaikki sendmail -ohjelmalle annettavat tiedot voidaan kirjoittaa etukäteen, myös paluunäppäimen painallukset, ja tallentaa kääritiedostoon. Tällä tavalla, kun sendmail -ohjelma suoritetaan heredocilla, syötteet syötetään automaattisesti ohjelmaan ja sähköpostiviesti lähetetään ilman, että käyttäjä tarvitsee mitään muuta.