Adding upstream version 1:10.5.12.upstream/1%10.5.12upstream

Signed-off-by: Daniel Baumann <daniel.baumann@progress-linux.org>

1 files changed, 150 insertions, 0 deletions

diff --git a/strings/string.doc b/strings/string.doc
new file mode 100644
index 00000000..3e5b6073
--- /dev/null
+++ b/strings/string.doc
@@ -0,0 +1,150 @@
+Speciella användbara nya string-rutiner:
+
+  bcmp(s1, s2, len) returns 0 if the "len" bytes starting at "s1" are
+  identical to the "len" bytes starting at "s2", non-zero if they are
+  different.
+
+  bfill(dst, len, fill) moves "len" fill characters to "dst".
+  Thus to set a buffer to 80 spaces, do bfill(buff, 80, ' ').
+
+  bmove(dst, src, len) moves exactly "len" bytes from the source "src"
+  to the destination "dst".  It does not check for NUL characters as
+  strncpy() and strnmov() do.
+
+  bmove_upp(dst, src, len) moves exactly "len" bytes from the source
+ "src-len" to the destination "dst-len" counting downwards.
+
+  bzero(dst, len) moves "len" 0 bytes to "dst".
+  Thus to clear a disc buffer to 0s do bzero(buffer, BUFSIZ).
+
+  int2str(dst, radix, val)
+  converts the (long) integer "val" to character form and moves it to
+  the destination string "dst" followed by a terminating NUL.  The
+  result is normally a pointer to this NUL character, but if the radix
+  is dud the result will be NullS and nothing will be changed.
+  If radix is -2..-36, val is taken to be SIGNED.
+  If radix is  2.. 36, val is taken to be UNSIGNED.
+  That is, val is signed if and only if radix is.  You will normally
+  use radix -10 only through itoa and ltoa, for radix 2, 8, or 16
+  unsigned is what you generally want.
+
+  m_ctype.h
+  A better inplementation of the UNIX ctype(3) library.
+  Notes:   global.h should be included before ctype.h
+    - Se efter i filen \c\local\include\m_ctype.h
+    - Används istället för ctype.h för att klara internationella karakterer.
+
+  m_string.h
+  Använd instället för string.h för att supporta snabbare strängfunktioner.
+
+  strintstr(src, from, pat) looks for an instance of pat in src
+  backwards from pos from.  pat is not a regex(3) pattern, it is a literal
+  string which must be matched exactly.
+  The result 0 if the pattern was not found else it is the start char of
+  the pattern counted from the beginning of the string.
+
+  strappend(dest, len, fill) appends fill-characters to a string so that
+  the result length == len. If the string is longer than len it's
+  trunked. The des+len character is allways set to NULL.
+
+  strcat(s, t) concatenates t on the end of s.  There  had  better  be
+  enough  room  in  the  space s points to; strcat has no way to tell.
+  Note that strcat has to search for the end of s, so if you are doing
+  a lot of concatenating it may be better to use strmov, e.g.
+	strmov(strmov(strmov(strmov(s,a),b),c),d)
+    rather than
+	strcat(strcat(strcat(strcpy(s,a),b),c),d).
+    strcat returns the old value of s.
+	- Använd inte strcat, använd strmov (se ovan).
+
+  strcend(s, c) returns a pointer to the  first  place  in  s	where  c
+  occurs,  or a pointer to the end-null of s if c does not occur in s.
+
+  strcont(str, set) if str contanies any character in the string set.
+  The result is the position of the first found character in str, or NullS
+  if there isn't anything found.
+
+  strend(s) returns a character pointer to the NUL which ends s.  That
+  is,  strend(s)-s  ==  strlen(s). This is useful for adding things at
+  the end of strings.  It is redundant, because  strchr(s,'\0')  could
+
+  strfill(dest, len, fill) makes a string of fill-characters. The result
+  string is of length == len. The des+len character is allways set to NULL.
+  strfill() returns pointer to dest+len;
+
+  strfind(src, pat) looks for an instance of pat in src.  pat is not a
+  regex(3) pattern, it is a literal string which must be matched exactly.
+  The result is a pointer to the first character of the located instance,
+  or NullS if pat does not occur in src.
+
+  strmake(dst,src,length) moves length characters, or until end, of src to
+  dst and appends a closing NUL to dst.
+  strmake() returns pointer to closing null;
+
+  strmov(dst, src) moves all the  characters  of  src  (including  the
+  closing NUL) to dst, and returns a pointer to the new closing NUL in
+  dst.	 The similar UNIX routine strcpy returns the old value of dst,
+  which I have never found useful.  strmov(strmov(dst,a),b) moves a//b
+  into dst, which seems useful.
+
+  strnmov(dst,src,length) moves length characters, or until end, of src to
+  dst and appends a closing NUL to dst if src is shorter than length.
+  The result is a pointer to the first NUL in dst, or is dst+n if dst was
+  truncated.
+
+ strrchr(s, c) returns a pointer to the  last  place  in  s	where  c
+ occurs,  or  NullS if c does not occur in s. This function is called
+ rindex in V7 and 4.?bsd systems.
+ strrchr  looks  for single characters, not for sets or strings.
+
+ strxmov(dst, src1, ..., srcn, NullS)
+ moves the concatenation of src1,...,srcn to dst, terminates it
+ with a NUL character, and returns a pointer to the terminating NUL.
+ It is just like strmov except that it concatenates multiple sources.
+ Beware: the last argument should be the null character pointer.
+ Take VERY great care not to omit it!  Also be careful to use NullS
+ and NOT to use 0, as on some machines 0 is not the same size as a
+ character pointer, or not the same bit pattern as NullS.
+
+ strxnmov(dst, len, src1, ..., srcn, NullS)
+ moves the first len characters of the concatenation of src1,...,srcn
+ to dst.  If there aren't that many characters, a NUL character will
+ be added to the end of dst to terminate it properly.  This gives the
+ same effect as calling strxcpy(buff, src1, ..., srcn, NullS) with a
+ large enough buffer, and then calling strnmov(dst, buff, len).
+ It is just like strnmov except that it concatenates multiple sources.
+ Beware: the last argument should be the null character pointer.
+ Take VERY great care not to omit it!  Also be careful to use NullS
+ and NOT to use 0, as on some machines 0 is not the same size as a
+ character pointer, or not the same bit pattern as NullS.
+
+ Note: strxnmov is like strnmov in that it always moves EXACTLY len
+ characters; dst will be padded on the right with NUL characters as
+ needed.  strxncpy does the same.  strxncat, like strncat, does NOT.
+
+
+I mysys:
+
+ stripp_sp(string str)
+ Strips end-space from string and returns new length.
+
+ strlength(const string str)
+ Return length of string with end-space:s not counted.
+
+ void caseup _A((string str,uint length));
+ void casedn _A((string str,uint length));
+ void caseup_str _A((string str));
+ void casedn_str _A((string str));
+ Converts strings or part of string to upper or lower-case.
+
+ void case_sort _A((string str,uint length));
+ Converts string to a string with can be compared with strcmp() to
+ get strings in rigth order.
+
+ string strcfind(str,search)
+ find string in another with no case_sensivity
+
+ my_strcasecmp(s,t)
+ Compare strings without regarding to case
+ - For many strings it quicker to forst use case_sort on all strings and
+   then compare them with strcmp().