workbench/libs/iffparse/idtostr.c

   1 /*
   2     Copyright © 1995-2007, The AROS Development Team. All rights reserved.
   3     $Id$
   4 */
   5
   6 #include "iffparse_intern.h"
   7
   8 /*****************************************************************************
   9
  10     NAME */
  11 #include <proto/iffparse.h>
  12
  13         AROS_LH2(STRPTR, IDtoStr,
  14
  15 /*  SYNOPSIS */
  16         AROS_LHA(LONG  , id, D0),
  17         AROS_LHA(STRPTR, buf, A0),
  18
  19 /*  LOCATION */
  20         struct Library *, IFFParseBase, 45, IFFParse)
  21
  22 /*  FUNCTION
  23
  24     INPUTS
  25         id  - pointer to an IFF chunk identfication code.
  26         buf  -  buffer into which the id will be stored. Should at least be 5 bytes.
  27
  28     RESULT
  29         buf  -  pointer to the supplied buffer.
  30
  31     NOTES
  32         Assumes that the supplied ID is stored in local byte order.
  33
  34     EXAMPLE
  35         // Print the ID of the current contextnode
  36
  37         UBYTE buf[5];
  38         struct ContextNode *cn;
  39
  40         if (cn = CurrentChunk(iff)
  41             printf
  42             (
  43                 "ID of current chunk: %s\n",
  44                 IDtoStr(cn->cn_ID)
  45             );
  46
  47
  48     BUGS
  49
  50     SEE ALSO
  51
  52     INTERNALS
  53
  54 *****************************************************************************/
  55 {
  56     AROS_LIBFUNC_INIT
  57
  58     UBYTE *idbuf = (UBYTE*)&id;
  59
  60     (void) IFFParseBase;
  61
  62 /* If CPU is little endian, then we must "rotate" when writing to the string */
  63
  64 #if (AROS_BIG_ENDIAN == 0)
  65     buf[0] = idbuf[3];
  66     buf[1] = idbuf[2];
  67     buf[2] = idbuf[1];
  68     buf[3] = idbuf[0];
  69 #else
  70 /* Big endian CPU: no problems */
  71
  72     buf[0] = idbuf[0];
  73     buf[1] = idbuf[1];
  74     buf[2] = idbuf[2];
  75     buf[3] = idbuf[3];
  76 #endif
  77
  78     buf[4] = 0;
  79
  80     return buf;
  81
  82     AROS_LIBFUNC_EXIT
  83 } /* IDtoStr */