workbench/libs/locale/getcatalogstr.c

   1 /*
   2     Copyright © 1995-2011, The AROS Development Team. All rights reserved.
   3     $Id$
   4
   5     Desc:
   6     Lang: english
   7 */
   8
   9 #include <exec/types.h>
  10 #include <proto/exec.h>
  11 #include "locale_intern.h"
  12
  13 /*****************************************************************************
  14
  15     NAME */
  16 #include <proto/locale.h>
  17
  18         AROS_LH3(CONST_STRPTR, GetCatalogStr,
  19
  20 /*  SYNOPSIS */
  21         AROS_LHA(const struct Catalog *, catalog,       A0),
  22         AROS_LHA(ULONG,                  stringNum,     D0),        /* Not a typo! Needs to be unsigned for ICF_INORDER */
  23         AROS_LHA(CONST_STRPTR,           defaultString, A1),
  24
  25 /*  LOCATION */
  26         struct LocaleBase *, LocaleBase, 12, Locale)
  27
  28 /*  FUNCTION
  29         This function will return the string specified by the
  30         stringNum from the given message catalog, or the defaultString
  31         if the string could not be found.
  32
  33         If the catalog == NULL, then the defaultString will also be
  34         returned.
  35
  36     INPUTS
  37         catalog -        Message catalog to search. May be NULL.
  38         stringNum -        ID of the string to find.
  39         defaultString - String to return in case catalog is NULL or
  40                         string could not be found.
  41
  42     RESULT
  43         A pointer to a READ ONLY NULL terminated string. This string
  44         pointer is valid as long as the catalog remains open.
  45
  46     NOTES
  47
  48     EXAMPLE
  49
  50     BUGS
  51
  52     SEE ALSO
  53         OpenCatalogA(), CloseCatalog()
  54
  55     INTERNALS
  56
  57 *****************************************************************************/
  58 {
  59     AROS_LIBFUNC_INIT
  60
  61     CONST_STRPTR str = defaultString;
  62
  63     if (catalog != NULL)
  64     {
  65         struct CatStr *cs = IntCat(catalog)->ic_CatStrings;
  66         ULONG numstrings = IntCat(catalog)->ic_NumStrings;
  67         ULONG i = 0;
  68
  69         for (i = 0; i < numstrings; i++, cs++)
  70         {
  71             if (cs->cs_Id == stringNum)
  72             {
  73                 str = cs->cs_String;
  74
  75                 break;
  76             }
  77             else
  78             {
  79                 if ((IntCat(catalog)->ic_Flags & ICF_INORDER) &&
  80                     (cs->cs_Id > stringNum))
  81                 {
  82                     break;
  83                 }
  84             }
  85         }
  86     }
  87
  88     return str;
  89
  90     AROS_LIBFUNC_EXIT
  91 }