##iinncclluuddee <> </pprree>> < > <
> cchhaarr ****llddaapp__ggeett__vvaalluueess((lldd,, eennttrryy,, aattttrr)) LLDDAAPP **lldd;; LLDDAAPPMMeessssaaggee **eennttrryy;; cchhaarr **aattttrr;; <
> ssttrruucctt bbeerrvvaall ****llddaapp__ggeett__vvaalluueess__lleenn((lldd,, eennttrryy,, aattttrr)) LLDDAAPP **lldd;; LLDDAAPPMMeessssaaggee **eennttrryy;; cchhaarr **aattttrr;; <
> iinntt llddaapp__ccoouunntt__vvaalluueess((vvaallss)) cchhaarr ****vvaallss;; <
> iinntt llddaapp__ccoouunntt__vvaalluueess__lleenn((vvaallss)) ssttrruucctt bbeerrvvaall ****vvaallss;; <
> vvooiidd llddaapp__vvaalluuee__ffrreeee((vvaallss)) cchhaarr ****vvaallss;; <
> vvooiidd llddaapp__vvaalluuee__ffrreeee__lleenn((vvaallss)) ssttrruucctt bbeerrvvaall ****vvaallss;; <
> DDEESSCCRRIIPPTTIIOONN </hh33>> TThheessee rroouuttiinneess aarree uusseedd ttoo rreettrriieevvee aanndd mmaanniippuullaattee aattttrriibbuuttee vvaalluueess ffrroomm aann LLDDAAPP eennttrryy aass rreettuurrnneedd bbyy <>llddaapp__ffiirrsstt__eennttrryy((33))</aa>> oorr <>llddaapp__nneexxtt__eennttrryy((33))</aa>> <>llddaapp__ggeett__vvaalluueess(())</bb>> ttaakkeess tthhee _e_n_t_r_y aanndd tthhee aattttrriibbuuttee _a_t_t_r wwhhoossee vvaalluueess aarree ddeessiirreedd aanndd rreettuurrnnss aa NNUULLLL--tteerrmmiinnaatteedd aarrrraayy ooff tthhee aattttrriibbuuttee''ss vvaalluueess.. _a_t_t_r mmaayy bbee aann aattttrriibbuuttee ttyyppee aass rreettuurrnneedd ffrroomm <>llddaapp__ffiirrsstt__aattttrriibbuuttee((33))</aa>> oorr <>llddaapp__nneexxtt__aattttrriibbuuttee((33))</aa>> oorr iiff tthhee aattttrriibbuuttee ttyyppee iiss kknnoowwnn iitt ccaann ssiimmppllyy bbee ggiivveenn.. < > TThhee nnuummbbeerr ooff vvaalluueess iinn tthhee aarrrraayy ccaann bbee ccoouunntteedd bbyy ccaalllliinngg <>llddaapp__ccoouunntt__vvaalluueess(())</bb>>.. TThhee aarrrraayy ooff vvaalluueess rreettuurrnneedd ccaann bbee ffrreeeedd bbyy ccaalllliinngg <>llddaapp__vvaalluuee__ffrreeee(())</bb>>.. <
> IIff tthhee aattttrriibbuuttee vvaalluueess aarree bbiinnaarryy iinn nnaattuurree,, aanndd tthhuuss nnoott ssuuiittaabbllee ttoo bbee rreettuurrnneedd aass aann aarrrraayy ooff cchhaarr **''ss,, tthhee <>llddaapp__ggeett__vvaalluueess__lleenn(())</bb>> rroouuttiinnee ccaann bbee uusseedd iinnsstteeaadd.. IItt ttaakkeess tthhee ssaammee ppaarraammeetteerrss aass <>llddaapp__ggeett__vvaalluueess(())</bb>>,, bbuutt rreettuurrnnss aa NNUULLLL--tteerrmmiinnaatteedd aarrrraayy ooff ppooiinntteerrss ttoo bbeerrvvaall ssttrruuccttuurreess,, eeaacchh ccoonnttaaiinniinngg tthhee lleennggtthh ooff aanndd aa ppooiinntteerr ttoo aa vvaalluuee.. <
> TThhee nnuummbbeerr ooff vvaalluueess iinn tthhee aarrrraayy ccaann bbee ccoouunntteedd bbyy ccaalllliinngg <>llddaapp__ccoouunntt__vvaalluueess__lleenn(())</bb>>.. TThhee aarrrraayy ooff vvaalluueess rreettuurrnneedd ccaann bbee ffrreeeedd bbyy ccaalllliinngg <>llddaapp__vvaalluuee__ffrreeee__lleenn(())</bb>>.. <
> EERRRROORRSS </hh33>> IIff aann eerrrroorr ooccccuurrss iinn <>llddaapp__ggeett__vvaalluueess(())</bb>> oorr <>llddaapp__ggeett__vvaalluueess__lleenn(())</bb>>,, NNUULLLL iiss rreettuurrnneedd aanndd tthhee <>lldd__eerrrrnnoo</bb>> ffiieelldd iinn tthhee _l_d ppaarraammeetteerr iiss sseett ttoo iinnddiiccaattee tthhee eerrrroorr.. SSeeee <>llddaapp__eerrrroorr((33))</aa>> ffoorr aa ddeessccrriippttiioonn ooff ppoossssiibbllee eerrrroorr ccooddeess.. < > NNOOTTEESS </hh33>> TThheessee rroouuttiinneess ddyynnaammiiccaallllyy aallllooccaattee mmeemmoorryy wwhhiicchh tthhee ccaalllleerr mmuusstt ffrreeee uussiinngg tthhee ssuupppplliieedd rroouuttiinneess.. < > SSEEEE AALLSSOO </hh33>> <>llddaapp((33))</aa>> <>llddaapp__ffiirrsstt__eennttrryy((33))</aa>> <>llddaapp__ffiirrsstt__aattttrriibbuuttee((33))</aa>> <>llddaapp__eerrrroorr((33))</aa>> < > AACCKKNNOOWWLLEEDDGGEEMMEENNTTSS </hh33>> <>OOppeennLLDDAAPP SSooffttwwaarree</bb>> iiss ddeevveellooppeedd aanndd mmaaiinnttaaiinneedd bbyy TThhee OOppeennLLDDAAPP PPrroojjeecctt < >.. <>OOppeennLLDDAAPP SSooffttwwaarree</bb>> iiss ddeerriivveedd ffrroomm UUnniivveerrssiittyy ooff MMiicchhiiggaann LLDDAAPP 33..33 RReelleeaassee.. </bbooddyy>> </hhttmmll>>