IBM FileNet P8, Version 5.2.1            

Matrisefunksjoner

Denne delen inneholder korte beskrivelser av funksjonene som returnerer informasjon om en bestemt matrise.

Funksjon Hva den gjør
arraytostring Når den får matrisedata, startmønsteret, sluttmønsteret og skilletegnet, returneres det en streng.
elementcount Returnerer antallet elementer som ikke er null eller ikke tomme, i en matrise.
nextelement Når funksjonen får et matrisefelt og en indeks i matrisen, returneres den neste oppføringen som ikke er tom og ikke er null, eller null hvis ingen er tilgjengelig.

elementcount

Returnerer tallet (heltallet) for elementer som ikke er null eller som ikke er tomme i matrisen. Legg merke til at størrelsen på (<array_field>) returnerer den gjeldende størrelsen til matrisen, men at enkelte av elementene kan være tomme oppføringer eller nulloppføringer i matrisen. For vedleggsmatriser betraktes det tomme vedlegget som tomt.
elementcount(array_field)
der array_field er datafeltet som inneholder kildedataene.
Her følger noen eksempler:
A = ("", , "", "alpha", ,"") => elementcount(A) = 1; sizeof (A) = 6
B = (0 , , 0 , 100    , , 0) => elementcount(B) = 4; sizeof (B) = 6

Legg merke til at en tom streng ikke telles i strengmatriser, men at hvert tall telles i numeriske matriser. Det vil si at det ikke finnes noen tomme tall.

Denne funksjonen er nyttig for å håndtere deltaker- og vedleggsmatriser.

nextelement

Når funksjonen får et matrisefelt og en indeks i matrisen, returnerer funksjonen den neste oppføringen som ikke er tom og ikke er null, eller null hvis ingen er tilgjengelig. Hvis heltallsuttrykket er null, returnerer det det første elementet som ikke er tomt eller null.
nextelement(array_field, index_expr)
der:
Tabell 1. Tabell over parametere og beskrivelse av nextelement-funksjonen
Parameter Beskrivelse
array_field    Datafeltet som inneholder kildedataene.
index_expr Indeksen som bør brukes til å starte søket. Hvis den er null, starter den søket fra begynnelsen av matrisen.
For eksempel med matrisene
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
Merk: Prosessmatriseindekser starter på én, men indeksnull brukes til å søke etter det første elementet som ikke er tomt eller ikke er null.

Denne funksjonen er nyttig for å håndtere deltaker- og vedleggsmatriser.

arraytostring

Denne funksjonen konverterer matrisedata til en streng.
arraytostring(array_field, begin_expr, end_expr, separator_expr)
der:
Tabell 2. Parametere og beskrivelse for arraytostring-funksjon
Parameter Beskrivelse
array_field    Datafeltet som inneholder kildedataene.
begin_expr Tekststrengen som markerer begynnelsen på matrisen.
end_expr Tekststrengen som markerer slutten på matrisen.
separator_expr Tekststrengen som brukes til å skille elementene i matrisen.
Med datafeltet MyStringArray med innholdet {1,2,3} kan du for eksempel bruke følgende kommando når du skal returnere strengdata:
  • arraytostring(MyStringArray, "{ ", " }", ",") returnerer { 1,2,3 }
Denne funksjonen kan brukes til å returnere en streng fra en matrise med datafelt i et XML-skjema i MyXMLField.
arraytostring(MyXMLField, ("<tag><value>", "</value></tag>", "</value><value>")
Skjemaeksempel


Last updated: October 2015
bpfe003.htm

© Copyright IBM Corp. 2015.