10d29d597c
This is our new RELEASE-4_0 branch which was taken from ansto/93d9a7c Conflicts: .gitignore SICSmain.c asynnet.c confvirtualmot.c counter.c devexec.c drive.c event.h exebuf.c exeman.c histmem.c interface.h motor.c motorlist.c motorsec.c multicounter.c napi.c napi.h napi4.c network.c nwatch.c nxscript.c nxxml.c nxxml.h ofac.c reflist.c scan.c sicshipadaba.c sicsobj.c site_ansto/docs/Copyright.txt site_ansto/instrument/lyrebird/config/tasmad/sicscommon/nxsupport.tcl site_ansto/instrument/lyrebird/config/tasmad/taspub_sics/tasscript.tcl statusfile.c tasdrive.c tasub.c tasub.h tasublib.c tasublib.h
118 lines
3.8 KiB
C
118 lines
3.8 KiB
C
/*---------------------------------------------------------------------------
|
|
D Y N S T R I N G
|
|
|
|
A dynamic String Implementation. You can append and insert into this
|
|
string at will. It automatically takes care of allocating more
|
|
memory when needed.
|
|
|
|
COPYRIGHT:
|
|
CopyLeft, 1998, Mark Koennecke
|
|
There are two things you MAY NOT DO with this code:
|
|
- Sue me or my employer because it does not work.
|
|
- Use it in a critical environment, i.e health,
|
|
radioactive device control, military control
|
|
systems and the like.
|
|
You may do everything else with this code. It has been
|
|
written with swiss taxpayers money.
|
|
|
|
NOTE:
|
|
All functions return 1 or a pointer on success,
|
|
0, or NULL on failure
|
|
|
|
Mark Koennecke, March 1998
|
|
----------------------------------------------------------------------------*/
|
|
#ifndef DYNAMICSTRING
|
|
#define DYNAMICSTRING
|
|
typedef struct __DynString *pDynString;
|
|
|
|
/*----------------------- live and death ----------------------------------*/
|
|
pDynString CreateDynString(int iInitialLength, int iResizeLength);
|
|
/*
|
|
Create a new DynString Object. Its initial length will be iInitialLength.
|
|
It will be resized in iResizeLength steps. This allows for efficient
|
|
storage management. It woul be seriously inefficient to allocate
|
|
per added character.
|
|
*/
|
|
|
|
void DeleteDynString(pDynString self);
|
|
/*----------------------- interface to it --------------------------------- */
|
|
|
|
int DynStringCopy(pDynString self, char *pText);
|
|
|
|
/*
|
|
Copies the text in Text into the DynString starting at 0 and over
|
|
writing anything there beforehand.
|
|
*/
|
|
|
|
int DynStringConcat(pDynString self, char *pText);
|
|
/*
|
|
Concatenates the string in DynString with the one supplied
|
|
in string.
|
|
*/
|
|
int DynStringConcatLine(pDynString self, char *pText);
|
|
/*
|
|
Concatenates the string in DynString with the one supplied
|
|
in string. And add a newline.
|
|
*/
|
|
|
|
int DynStringConcatChar(pDynString self, char c);
|
|
/*
|
|
adds one character at the end of the string
|
|
*/
|
|
int DynStringConcatBytes(pDynString self, char *data, int datalen);
|
|
/*
|
|
* adds datalen bytes from data to the buffer
|
|
*/
|
|
int DynStringInsert(pDynString self, char *pText, int iPos);
|
|
|
|
/*
|
|
inserts the text in pText at Position iPos in the DynString.
|
|
Everything behind iPos will be pushed outwards in order to create
|
|
space for pText.
|
|
*/
|
|
|
|
int DynStringReplace(pDynString self, char *pText, int iPos);
|
|
|
|
/*
|
|
Starting at iPos, replace everything after it with ptext. In
|
|
contrats to insert this won't push data backwards.
|
|
*/
|
|
|
|
char *GetCharArray(pDynString self);
|
|
|
|
/*
|
|
retrieves a pointer to the character array keeping the current
|
|
text. NEVER, ever free this pointer, otherwise you are rewarded
|
|
with a core dump. The pointer belongs to DynString and will be
|
|
deleted when deleting the DynString.
|
|
*/
|
|
|
|
int GetDynStringLength(pDynString self);
|
|
|
|
/*
|
|
returns the current length of the dynamic string.
|
|
*/
|
|
|
|
int DynStringClear(pDynString self);
|
|
/*
|
|
removes all old data from the dynstring
|
|
*/
|
|
int DynStringBackspace(pDynString self);
|
|
/*
|
|
removes one character at the end from the dynstring
|
|
*/
|
|
int DynStringShorten(pDynString self, int length);
|
|
/*
|
|
shorten the dynstring to the given length
|
|
*/
|
|
char *Dyn2Cstring(pDynString self);
|
|
/*
|
|
convert to C string and delete dynstring. The result must be freed when no longer used.
|
|
*/
|
|
/*
|
|
Ensures that the DynString has the capacity length. In order to avoid unnecessary
|
|
concatenation when the length is already known.
|
|
*/
|
|
int DynStringCapacity(pDynString self, int length);
|
|
#endif
|