virhekoodien

Virhekoodit ovat ohjelmistojen, verkkopalveluiden ja laitteistojen käyttämien virhetilanteiden tunnisteita, jotka kuvaavat virheenlaadun tai tilan yleisen tyypin. Ne voivat olla numeerisia tai merkkijonoina esitettyjä ja ne auttavat sekä järjestelmän sisäistä virheenkorjausta että käyttäjille annettavaa palautetta. Yleensä koodin lisäksi tarjotaan lyhyt kuvaus ja tarvittaessa ohjeet seuraavista toimenpiteistä.

Käyttökohteita ovat käyttöjärjestelmät, ohjelmistot, protokollat ja laitteistot. Virhekoodit soveltuvat sekä automaattiseen virheiden käsittelyyn ohjelmistoissa että manuaaliseen vianetsintään sekä tilastointiin ja raportointiin. Esimerkkejä ovat HTTP-tilakoodit (esimerkiksi 404 Not Found, 500 Internal Server Error), POSIX-errnoarvot (kuten ENOENT, EACCES) sekä Windowsin HRESULT-arvot. Sovellukset voivat lisäksi määrittää omia, sovellukselle räätälöityjä virhekoodilistauksia.

Rakenne ja käyttöönotto vaihtelevat: koodi voi olla pelkkä numero tai merkkijono, ja siihen liittyy usein kuvaus sekä suositellut toimenpiteet. Viestit voivat olla lokalisoituja, mutta itse virhekoodi säilyy usein vakaana ohjelmistojen ja rajapintojen yhteisiä määritelmiä varten. Hyvä käytäntö on erottaa koodit ja niihin liittyvä kuvaus sekä dokumentoida, miten koodi muunnetaan käyttäjätekstiksi.

Koodien hallinta ja standardisointi helpottavat yhteensopivuutta eri järjestelmien välillä. Mikäli virhekoodit muuttuvat tai laajentuvat, on tärkeää tarjota taustatiedot, muutosloki sekä yhteensopivuusohjeet vanhojen ja uusien koodien välille.