Arrayfunktioner
Dette afsnit indeholder korte beskrivelser af de funktioner, der returnerer oplysninger om et angivet array.
Funktion | Virkemåde |
---|---|
arraytostring | Returnerer en streng ud fra arraydata, startmønster, slutmønster og separator. |
elementcount | Returnerer antallet af elementer, der ikke er NULL eller ikke er tomme i et array. |
nextelement | Returnerer den næste indgang, der ikke er tom og ikke er NULL, eller nul, hvis der ikke findes nogen, ud fra et arrayfelt og et indeks i arrayet. |
elementcount
Returnerer nummeret (heltal) på elementer, der ikke er NULL eller ikke er tomme, i arrayet. Bemærk, at sizeof (<arrayfelt>) returnerer den aktuelle størrelse på arrayet, men nogle af elementerne kan være tomme indgange eller NULL-indgange i arrayet. Ved vedhæftningsarrays betragtes den tomme vedhæftning som tom.
elementcount(arrayfelt)
hvor arrayfelt er det datafelt, der indeholder kildedataene.Her er nogle eksempler:
A = ("", , "", "alpha", ,"") => elementcount(A) = 1; sizeof (A) = 6
B = (0 , , 0 , 100 , , 0) => elementcount(B) = 4; sizeof (B) = 6
Bemærk, at en tom streng ikke tælles med i strengarrays, men alle tal tælles med i numeriske arrays. Med andre ord er der ingen tomme tal.
Denne funktion er nyttig ved behandling af deltager- og vedhæftningsarrays.
nextelement
Returnerer den næste indgang, der ikke er tom og ikke er NULL, eller nul, hvis der ikke findes nogen, ud fra et arrayfelt og et indeks i arrayet. Hvis heltalsudtrykket er nul, returneres det første element, der ikke er tomt og ikke er NULL.
nextelement(arrayfelt, indeksudtryk)
hvor:Parameter | Beskrivelse |
---|---|
arrayfelt | Det datafelt, der indeholder kildedataene. |
indeksudtryk | Det indeks, der skal bruges til at starte søgningen. Hvis det er nul, startes søgningen fra starten på arrayet. |
Eksempel ved brug af følgende arrays
A = ("", , "", "alpha",,"") B =(0 , , 0 , 100 , , 0)
nextelement (A, 0) = 4
nextelement (A, 4) = 0
nextelement (B, 0) = 1
nextelement (B, 1) = 3
nextelement (B, 3) = 4
nextelement (B, 4) = 6
nextelement (B, 6) = 0
Bemærk: Process-arrayindekser starter ved én, men indeks nul bruges til at søge efter det første element, der ikke er tomt og ikke er NULL.
Denne funktion er nyttig ved behandling af deltager- og vedhæftningsarrays.
arraytostring
Denne funktion konverterer arraydata til en streng.
arraytostring(arrayfelt, start_udtryk, slut_udtryk, separator_udtryk)
hvor:Parameter | Beskrivelse |
---|---|
arrayfelt | Det datafelt, der indeholder kildedataene. |
start_udtryk | Den tekststreng, der markerer starten på arrayet. |
slut_udtryk | Den tekststreng, der markerer slutningen på arrayet. |
separator_udtryk | Den tekststreng, der bruges til at adskille elementerne i arrayet. |
Hvis datafeltet f.eks. er MitStrengarray med indholdet {1,2,3}, skal du bruge følgende kommando til at returnere strengdata:
- arraytostring(MitStrengarray, "{ ", " }", ",") returnerer { 1,2,3 }
Denne funktion kan bruges til at returnere en streng fra et array med datafelter i et XML-skema i MitXMLFelt.
arraytostring(MitXMLFelt, ("<kode><værdi>", "</værdi></kode>", "</værdi><værdi>")
