gbx_string.h

Gambas is a graphical development environment based on a Basic interpreter, like Visual Basic. It us

/***************************************************************************

  String.h

  The String management routines

  (c) 2000-2004 Beno顃 Minisini <[e-mail]>

  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 1, 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.

***************************************************************************/

#ifndef __STRING_H
#define __STRING_H

#include "gbx_value.h"
#include "gbx_subst.h"

typedef
  struct
  {
    long len;
    long ref;
    char data[0];
  }
  PACKED
  STRING;

PUBLIC void STRING_new(char **ptr, const char *src, int len);
PUBLIC void STRING_new_temp(char **ptr, const char *src, int len);
PUBLIC void STRING_free(char **ptr);
PUBLIC void STRING_exit(void);
PUBLIC long STRING_get_free_index(void);

PUBLIC void STRING_extend(char **ptr, int new_len);
PUBLIC void STRING_extend_end(char **ptr);
PUBLIC void STRING_add(char **ptr, const char *src, int len);

PUBLIC void STRING_copy_from_value_temp(char **ptr, VALUE *value);

PUBLIC void STRING_new_temp_value(VALUE *value, const char *src, int len);
PUBLIC void STRING_new_constant_value(VALUE *value, const char *src, int len);

PUBLIC void STRING_char_value(VALUE *value, uchar car);
PUBLIC void STRING_void_value(VALUE *value);

PUBLIC void STRING_ref(char *ptr);
PUBLIC void STRING_unref(char **ptr);
PUBLIC void STRING_unref_keep(char **ptr);

PUBLIC int STRING_comp_value(VALUE *str1, VALUE *str2);

PUBLIC char *STRING_subst(const char *string, long len, SUBST_FUNC get_param);
PUBLIC void STRING_conv(char **result, const char *str, long len, const char *src, const char *dst);
PUBLIC char *STRING_conv_file_name(const char *name, long len);


#define STRING_from_ptr(_ptr) ((STRING *)((_ptr) - offsetof(STRING, data)))
#define STRING_length(_ptr) ((_ptr) == NULL ? 0 : STRING_from_ptr(_ptr)->len)

#endif /* */