stack.c

常用的线性数据结构: 包括线性表、环形列表、队列、双端队列、单链表、双端链表、堆、栈、字符串数组等。非常有用

/*  stack.c - source code for stack library
 *
 *  STACK - Stack Library
 *
 *  Copyright (C) 2000  Richard Heathfield
 *                      Eton Computer Systems Ltd
 *                      Macmillan Computer Publishing
 *
 *  This program is free software; you can redistribute it
 *  and/or modify it under the terms of the GNU General
 *  Public License as published by the Free Software
 *  Foundation; either version 2 of the License, or
 *  (at your option) any later version.
 *
 *  This program is distributed in the hope that it will
 *  be useful, but WITHOUT ANY WARRANTY; without even the
 *  implied warranty of MERCHANTABILITY or FITNESS FOR A
 *  PARTICULAR PURPOSE.  See the GNU General Public License
 *  for more details.
 *
 *  You should have received a copy of the GNU General
 *  Public License along with this program; if not, write
 *  to the Free Software Foundation, Inc., 675 Mass Ave,
 *  Cambridge, MA 02139, USA.
 *
 *  Richard Heathfield may be contacted by email at:
 *     [e-mail]
 *
 */


#include <string.h>
#include <assert.h>

#include "stack.h"

int StackPush(STACK *Stack,
              int Tag,
              void *Object,
              size_t Size)
{
  int Result = STACK_PUSH_FAILURE;
  int ListResult;
  assert(Stack != NULL);
  assert(0 == Stack->CheckInit1 && 0 == Stack->CheckInit2);

  ListResult = SLFront(&Stack->StackPtr, Tag, Object, Size);

  if(SL_SUCCESS == ListResult)
  {
    Result = STACK_SUCCESS;
    ++Stack->NumItems;
  }

  return Result;
}

int StackPop(void *Object, STACK *Stack)
{
  size_t Size;
  void *p;
  int Result = STACK_SUCCESS;

  assert(Stack != NULL);
  assert(0 == Stack->CheckInit1 && 0 == Stack->CheckInit2);

  if(Stack->NumItems > 0)
  {
    p = SLGetData(Stack->StackPtr, NULL, &Size);
    if(p != NULL)
    {
      if(Object != NULL)
      {
        memcpy(Object, p, Size);
      }
    }
    else
    {
      Result = STACK_POP_FAILURE;
    }
    Stack->StackPtr = SLDeleteThis(Stack->StackPtr);
    --Stack->NumItems;
  }
  else
  {
    Result = STACK_EMPTY;
  }

  return Result;
}

void *StackGetData(STACK *Stack, int *Tag, size_t *Size)
{
  assert(Stack != NULL);
  assert(0 == Stack->CheckInit1 && 0 == Stack->CheckInit2);

  return SLGetData(Stack->StackPtr, Tag, Size);
}

size_t StackCount(STACK *Stack)
{
  assert(Stack != NULL);
  assert(0 == Stack->CheckInit1 && 0 == Stack->CheckInit2);
  return Stack->NumItems;
}

void StackDestroy(STACK *Stack)
{
  assert(Stack != NULL);
  assert(0 == Stack->CheckInit1 && 0 == Stack->CheckInit2);

  while(StackCount(Stack) > 0)
  {
    StackPop(NULL, Stack);
  }
  Stack->StackPtr = NULL;
}