DBCREATE([tiedostonimi],[vektorimuuttuja])

Selitys

DBCREATE() funktiolla voidaan luoda uusi DBF tiedosto olemassa olevasta vektorimuuttujasta. DBCREATE() funktiolle annetaan se tiedostonimi, joka halutaan luoda. Lisäksi annetaan vektorimuuttuja, jonka elementeissä määritellään:
1) kentän nimi
Kentän nimi voi olla enintään 10 merkkiä pitkä. Siinä ei saa olla pisteitä, pilkkuja, ym. välimerkkjä tai tyhjiä välejä. Numero ei saa olla ensimmäinen merkki.
Hyviä kenttänimiä on esim.:

IKA
pituus
Vuosi12

Huonoja kenttänimiä on esim.:
IKA nyt     Välilyöntejä ei saa olla.
1Vuosi     Numero ei saa aloittaa kenttänimeä.
append     APPPEND ns. varattu nimi. Samoin esim. DBCREATE.
pitu-abc     Väliviivoja tai vastaavia merkkejä ei saa olla.
liianpitkanimi     Kentän nimi voi olla enintään 10 merkkiä pitkä.

2) kentän tyyppi
Kentän tyyppi voi olla C, D, Tai N. C:llä tarkoitetaan tekstityyppistä kenttää, jossa voi olla myös numeroita. D-kenttään voidaan tallentaa päivämääriä. N-kenttään voidaan tallentaa numeroita.

3) kentän pituus
C-kentät voivat olla enintään 512 merkkiä. Numerokentät ovat maksimissaan 15 numeroa, johon kuuluu mukaan piste ja desimaalit. Päiväkentät ovat aina 8 merkkiä.

4) desimaalien määrä
Desimaaleja käytetään vain numerokentissä. Desimaaleja on eneintään 8.

Parametrit

[tiedostonimi] on se tiedostonimi, joksi aiotaan tallentaa uusi DBF tiedosto. Tämän uuden tiedoston kentät on lueteltu [vektorimuuttuja]:ssa.

Esimerkki

apu=array(4)
apu[1]={"Nimi","C",15,0}
apu[2]={"ika","N",3,0}
apu[3]={"syntpai","D",8,0}
apu[4]={"palkka","N",8,2}
dbcreate("rekis.dbf",apu)

Yllä luodaan ensin vektorimuuttuja "apu", johon mahtuu neljä arvoa.
Sitten tallennetaan arvoihin vektoriarvot, eri kentistä. "palkka" kenttään voi tallentaa enintään 99999.99 suuruisen palkan.
Lopuksi luodaan DBF tiedosto rekis.dbf. Jos sellainen oli ennestään aiempi versio korvataan.

Katso myös ARRAY(), DBSTRUCT(), COPY STRUCTURE TO