Changeset 883fedc in mainline for uspace/app/sbi/src/strtab.c

Timestamp:

2010-04-23T23:09:56Z (14 years ago)

Author:

Jiri Svoboda <jiri@…>

Branches:

lfn, master, serial, ticket/834-toolchain-update, topic/msim-upgrade, topic/simplify-dev-export

Children:

37c9fc8

Parents:

80badbe (diff), 6c39a907 (diff)
Note: this is a merge changeset, the changes displayed below correspond to the merge itself.
Use the (diff) links above to see all the changes relative to each parent.

Message:

Merge from lp:~jsvoboda/helenos/sysel. New: generic classes, autoboxing, delegates.

File:

• uspace/app/sbi/src/strtab.c (modified) (4 diffs)

uspace/app/sbi/src/strtab.c

@@ -30 +30 @@
  *
  * Converts strings to more compact SID (string ID, integer) and back.
- * The string table is not an object as there will never be a need for
+ * (The point is that this deduplicates the strings. Using SID might actually
+ * not be such a big win.)
+ *
+ * The string table is a singleton as there will never be a need for
  * more than one.
+ *
+ * Current implementation uses a linked list and thus it is slow.
  */
 
@@ -43 +48 @@
 static list_t str_list;
 
+/** Initialize string table. */
 void strtab_init(void)
 {
@@ -48 +54 @@
 }
 
+/** Get SID of a string.
+ *
+ * Return SID of @a str. If @a str is not in the string table yet,
+ * it is added and thus a new SID is assigned.
+ *
+ * @param str   String
+ * @return      SID of @a str.
+ */
 sid_t strtab_get_sid(const char *str)
 {
@@ -70 +84 @@
 }
 
+/** Get string with the given SID.
+ *
+ * Returns string that has SID @a sid. If no such string exists, this
+ * causes a fatal error in the interpreter.
+ *
+ * @param sid   SID of the string.
+ * @return      Pointer to the string.
+ */
 char *strtab_get_str(sid_t sid)
 {