Changeset 815 for trunk/superstring/include/superstring/superstring.h

Timestamp:

03/28/08 22:32:22 (4 years ago)

Author:

wd

Message:

Interrim update for superstring bits.

File:

• trunk/superstring/include/superstring/superstring.h (modified) (4 diffs)

trunk/superstring/include/superstring/superstring.h

@@ -114 +114 @@
 };
 
-typedef struct _superstring_jumbo_ * superstring_jumbo;
 typedef struct _superstring_small_ * superstring;
 
@@ -198 +197 @@
 /* Get the C representation of a superstring value. */
 static inline const unsigned char *ss_cstring(superstring str) {
-    if (str == NULL)
+    if (str == NULL) {
+        ss_errno = SS_ERROR_INVALID_PARAMETER;
         return NULL;
-
+    }
+
+    ss_errno = SS_ERROR_SUCCESS;
     return (str->flags & SUPERSTRING_JUMBO ?
             ((const unsigned char *)str) + sizeof(struct _superstring_jumbo_) :
@@ -208 +210 @@
 /* Retrieve the length or size of a string */
 static inline size_t ss_length(superstring str) {
-    if (str == NULL)
+    if (str == NULL) {
+        ss_errno = SS_ERROR_INVALID_PARAMETER;
         return 0; /* bad answer.. */
-
+    }
+
+    ss_errno = SS_ERROR_SUCCESS;
     return (size_t)(str->flags & SUPERSTRING_JUMBO ?
-            ((superstring_jumbo)str)->len :
+            ((struct _superstring_jumbo_ *)str)->len :
             str->len);
 }
 
 static inline size_t ss_size(superstring str) {
-    if (str == NULL)
+    if (str == NULL) {
+        ss_errno = SS_ERROR_INVALID_PARAMETER;
         return 0; /* bad answer.. */
-
+    }
+
+    ss_errno = SS_ERROR_SUCCESS;
     return (size_t)(str->flags & SUPERSTRING_JUMBO ?
-            ((superstring_jumbo)str)->size :
+            ((struct _superstring_jumbo_ *)str)->size :
             str->size);
+}
+
+/* Retrieve or set the character at 'offset' in the string */
+static inline unsigned char ss_char(superstring str, size_t index) {
+    if (str == NULL || index >= str->len) {
+        ss_errno = SS_ERROR_INVALID_PARAMETER;
+        return 0;
+    }
+    return (str->flags & SUPERSTRING_JUMBO ?
+            *((unsigned char *)str + sizeof(struct _superstring_jumbo_) + index) :
+            *((unsigned char *)str + sizeof(struct _superstring_small_) + index));
+}
+static inline int ss_setchar(superstring str, size_t index, char c) {
+    if (str == NULL || index >= str->len)
+        return (ss_errno = SS_ERROR_INVALID_PARAMETER);
+
+    if (str->flags & SUPERSTRING_JUMBO)
+        *((unsigned char *)str + sizeof(struct _superstring_jumbo_) + index) = c;
+    else
+        *((unsigned char *)str + sizeof(struct _superstring_small_) + index) = c;
+
+    return (ss_errno = SS_ERROR_SUCCESS);
 }
 
@@ -249 +279 @@
 
 /*****************************************************************************/
+/* Shorten or lengthen a superstring by trimming or appending data.  For
+ * trim, if the length is greater than the current length spaces (or a
+ * specified character) are appended as necessary. */
+int ss_trim_ex(superstring str, size_t length, char fill);
+static inline int ss_trim(superstring str, size_t length) {
+    return ss_trim_ex(str, length, ' ');
+}
+
+/*****************************************************************************/
+/* Append data to a superstring.  There are several variants provided which
+ * allow for setting maximum string length, using C strings, etc */
+#define SS_APPEND_CSTRING           (0x80000000)
+int ss_append_ex(superstring *lstr, superstring rstr, int flags, size_t length);
+
+/* Append a string with no concern for length */
+static inline int ss_append(superstring *lstr, superstring rstr) {
+    return ss_append_ex(lstr, rstr, 0, 0);
+}
+static inline int ss_append_cs(superstring *lstr, const unsigned char *rstr) {
+    return ss_append_ex(lstr, (superstring)rstr, SS_APPEND_CSTRING, 0);
+}
+
+/* Append a string but do not allow lstr to exceed 'length' */
+static inline int ss_nappend(superstring *lstr, superstring rstr,
+        size_t length) {
+    return ss_append_ex(lstr, rstr, 0, length);
+}
+static inline int ss_nappend_cs(superstring *lstr, const unsigned char *rstr,
+        size_t length) {
+    return ss_append_ex(lstr, (superstring)rstr, SS_APPEND_CSTRING, length);
+}
+
+/*****************************************************************************/
 /* Comparison function, with various wrappers:
    - ss_compare_ex: Compare with flags and length.  If length is 0 it will be