base/libs/json/rstring.h

/***************************************************************************
 *   Copyright (C) 2007 by Rui Maciel   *
 *   rui.maciel@gmail.com   *
 *                                                                         *
 *   This program is free software; you can redistribute it and/or modify  *
 *   it under the terms of the GNU Library 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 Library General Public     *
 *   License along with this program; if not, write to the                 *
 *   Free Software Foundation, Inc.,                                       *
 *   59 Temple Place - Suite 330, Boston, MA  02111-1307, USA.             *
 ***************************************************************************/

#include <wchar.h>

#ifndef RSTRING
#define RSTRING

#ifdef __cplusplus
extern "C"
{
#endif


    struct rui_wstring
    {
        wchar_t *text;  /*<! wchar_t c-string */
        size_t max; /*<! usable memory allocated to text minus the space for the nul character */
    };

    typedef struct rui_wstring rwstring;

    struct rui_cstring
    {
        char *text; /*<! char c-string */
        size_t max; /*<! usable memory allocated to text minus the space for the nul character */
    };

    typedef struct rui_cstring rcstring;


    enum rui_string_error_codes
    { RS_MEMORY, RS_OK = 1, RS_UNKNOWN };

    typedef enum rui_string_error_codes rstring_code;

    rwstring *rws_create (size_t length);

    void rws_free (rwstring ** rws);

    rstring_code rws_resize (rwstring * rws, size_t length);

    rwstring *rws_duplicate (rwstring * copied);

    size_t rws_length (rwstring * rws);

    rstring_code rws_copyrws (rwstring * to, const rwstring * from);

    rstring_code rws_copywcs (rwstring * to, const wchar_t * from, const size_t length);

    rstring_code rws_catrws (rwstring * pre, const rwstring * pos);

    rstring_code rws_catrcs (rwstring * pre, const rcstring * pos);

    rstring_code rws_catwcs (rwstring * pre, const wchar_t * pos, const size_t length);

    rstring_code rws_catcs (rwstring * pre, const char *pos, const size_t length);

    rstring_code rws_catwc (rwstring * pre, const wchar_t c);

    rstring_code rws_catc (rwstring * pre, const char c);

    rwstring *rws_wrap (wchar_t * wcs);

    wchar_t *rws_unwrap (rwstring * rws);


    rcstring *rcs_create (size_t length);

    void rcs_free (rcstring ** rcs);

    rstring_code rcs_resize (rcstring * rcs, size_t length);

    rcstring *rcs_duplicate (rcstring * copied);

    size_t rcs_length (rcstring * rcs);

    rstring_code rcs_copyrcs (rcstring * to, const rcstring * from);

    rstring_code rcs_copycs (rcstring * to, const char *from, const size_t length);

    rstring_code rcs_catrcs (rcstring * pre, const rcstring * pos);

    rstring_code rcs_catcs (rcstring * pre, const char *pos, const size_t length);

    rstring_code rcs_catwcs (rcstring * pre, const wchar_t * pos, const size_t length);

    rstring_code rcs_catwc (rcstring * pre, const wchar_t c);

    rstring_code rcs_catc (rcstring * pre, const char c);

    rcstring *rcs_wrap (char *cs);

    char *rcs_unwrap (rcstring * rcs);


#ifdef __cplusplus
}
#endif
#endif

---