FindAsmGadget

Synopsis

asmgad = FindAsmGadget(rei, name)
  D0                    A0    A1

C Prototype

struct AsmGadget *FindAsmGadget(struct REI *, STRPTR);

Description

Finds a pointer to an AsmGadget structure by performing a name-based search through the internal lists. This function was written to simplify the workflow for C programmers.

Inputs

• rei — Address of the REI that contains the AsmGadget to search for.
• name — Pointer to a null-terminated string indicating the name of the gadget to find.

Result

• asmgad — If NULL, no AsmGadget with that name exists in this REI. Otherwise, returns the address of the matching AsmGadget structure.

See Also

SetAsmGadgetAttrsA, GetAsmGadgetAttr

Implementation

The original 68020 assembly implementation:

; (25-Jan-1995) --- asmgadget = FindAsmGadget(rei,name) (a0/a1)
_LVOFindAsmGadget
        lea     rei_HEADAsmGadget(a0),a0
        FINDNAME
        rts