rom/exec/findname.c

   1 /*
   2     Copyright © 1995-2001, The AROS Development Team. All rights reserved.
   3     $Id$
   4
   5     Desc: Search for a node by name.
   6     Lang: english
   7 */
   8 #include <string.h>
   9 #include <aros/debug.h>
  10
  11 /*****************************************************************************
  12
  13     NAME */
  14 #include <exec/lists.h>
  15 #include <proto/exec.h>
  16
  17         AROS_LH2I(struct Node *, FindName,
  18
  19 /*  SYNOPSIS */
  20         AROS_LHA(struct List *, list, A0),
  21         AROS_LHA(const UBYTE *, name, A1),
  22
  23 /*  LOCATION */
  24         struct ExecBase *, SysBase, 46, Exec)
  25
  26 /*  FUNCTION
  27         Look for a node with a certain name in a list.
  28
  29     INPUTS
  30         list - Search this list.
  31         name - This is the name to look for.
  32
  33     RESULT
  34
  35     NOTES
  36         The search is case-sensitive, so "Hello" will not find a node
  37         named "hello".
  38
  39         The list must contain complete Nodes and no MinNodes.
  40
  41     EXAMPLE
  42         struct List * list;
  43         struct Node * node;
  44
  45         // Look for a node with the name "Hello"
  46         node = FindName (list, "Hello");
  47
  48     BUGS
  49
  50     SEE ALSO
  51
  52     INTERNALS
  53
  54 ******************************************************************************/
  55 {
  56     AROS_LIBFUNC_INIT
  57     struct Node * node;
  58
  59     ASSERT(list != NULL);
  60     ASSERT(list != NULL);
  61
  62     /* Look through the list */
  63     for (node=GetHead(list); node; node=GetSucc(node))
  64     {
  65         /* Only compare the names if this node has one. */
  66         if(node->ln_Name)
  67         {
  68             /* Check the node. If we found it, stop. */
  69             if (!strcmp (node->ln_Name, name))
  70                 break;
  71         }
  72     }
  73
  74     /*
  75         If we found a node, this will contain the pointer to it. If we
  76         didn't, this will be NULL (either because the list was
  77         empty or because we tried all nodes in the list)
  78     */
  79     return node;
  80     AROS_LIBFUNC_EXIT
  81 } /* FindName */
  82