From 849e99602e4b0487dad23e28cb6a94bf013f40a4 Mon Sep 17 00:00:00 2001 From: hunt Date: Thu, 26 May 2005 07:18:22 +0000 Subject: Remove all the generated html files. --- runtime/docs/html/group__string.html | 389 ----------------------------------- 1 file changed, 389 deletions(-) delete mode 100644 runtime/docs/html/group__string.html (limited to 'runtime/docs/html/group__string.html') diff --git a/runtime/docs/html/group__string.html b/runtime/docs/html/group__string.html deleted file mode 100644 index 834b7513..00000000 --- a/runtime/docs/html/group__string.html +++ /dev/null @@ -1,389 +0,0 @@ - - -SystemTap: String Functions - - - -
Main Page | Modules | Directories | File List | Globals | Related Pages
-

String Functions

One of the biggest restrictions the library has is that it cannot allocate things like strings off the stack. -More... - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - - -

Data Structures

struct  string

Defines

-#define STP_STRING_SIZE   2048
 Maximum string size allowed in Strings.
#define _stp_string_cat(str1, str2)
 ConCATenate (append) a String or C string to a String.

Typedefs

-typedef string * String

Functions

String _stp_string_init (int num)
 Initialize a String for our use.
void _stp_sprintf (String str, const char *fmt,...)
 Sprintf into a String.
void _stp_vsprintf (String str, const char *fmt, va_list args)
 Vsprintf into a String Use this if your function already has a va_list.
void _stp_string_cat_cstr (String str1, const char *str2)
 ConCATenate (append) a C string to a String.
void _stp_string_cat_string (String str1, String str2)
 ConCATenate (append) a String to a String.
char * _stp_string_ptr (String str)
 Get a pointer to String's buffer For rare cases when a C string is needed and you have a String.
-

Detailed Description

-One of the biggest restrictions the library has is that it cannot allocate things like strings off the stack. -

-It is also not a good idea to dynamically allocate space for strings with kmalloc(). That leaves us with statically allocated space for strings. This is what is implemented in the String module. Strings use preallocated per-cpu buffers and are safe to use (unlike C strings).


Define Documentation

-

- - - - -
- - - - - - - - - - - - -
#define _stp_string_cat str1,
str2   ) 
-
- - - - - -
-   - - -

-Value:

({                                                            \
-          if (__builtin_types_compatible_p (typeof (str2), char[])) {   \
-                  char *x = (char *)str2;                               \
-                  _str_string_cat_cstr(str1,x);                         \
-          } else {                                                      \
-                  String x = (String)str2;                              \
-                  _str_string_cat_string(str1,x);                       \
-          }                                                             \
-  })
-
ConCATenate (append) a String or C string to a String. -

-This macro selects the proper function to call.

Parameters:
- - - -
str1 A String
str2 A String or C string (char *)
-
-
See also:
_stp_string_cat_cstr _stp_string_cat_string
- -

-Definition at line 150 of file string.c.

-


Function Documentation

-

- - - - -
- - - - - - - - - - - - - - - - - - - - - - - - -
void _stp_sprintf String  str,
const char *  fmt,
  ...
-
- - - - - -
-   - - -

-Sprintf into a String. -

-Like printf, except output goes into a String. Safe because overflowing the buffer is not allowed. Size is limited by length of String, STP_STRING_SIZE.

-

Parameters:
- - - -
str String
fmt A printf-style format string followed by a variable number of args.
-
- -

-Definition at line 77 of file string.c. -

-References STP_STRING_SIZE. -

-Referenced by _stp_symbol_sprint().

-

- - - - -
- - - - - - - - - - - - - - - - - - -
void _stp_string_cat_cstr String  str1,
const char *  str2
-
- - - - - -
-   - - -

-ConCATenate (append) a C string to a String. -

-Like strcat().

Parameters:
- - - -
str1 String
str2 C string (char *)
-
-
See also:
_stp_string_cat
- -

-Definition at line 106 of file string.c. -

-References STP_STRING_SIZE.

-

- - - - -
- - - - - - - - - - - - - - - - - - -
void _stp_string_cat_string String  str1,
String  str2
-
- - - - - -
-   - - -

-ConCATenate (append) a String to a String. -

-Like strcat().

Parameters:
- - - -
str1 String
str2 String
-
-
See also:
_stp_string_cat
- -

-Definition at line 121 of file string.c. -

-References STP_STRING_SIZE.

-

- - - - -
- - - - - - - - - -
String _stp_string_init int  num  ) 
-
- - - - - -
-   - - -

-Initialize a String for our use. -

-This grabs one of the global Strings for our use.

-

Parameters:
- - -
num Number of the preallocated String to use. #STP_NUM_STRINGS are statically allocated for our use. The translator (or author) should be sure to grab a free one.
-
-
Todo:
Global (and static) Strings not implemented yet.
- -

-Definition at line 42 of file string.c. -

-References _stp_log().

-

- - - - -
- - - - - - - - - -
char* _stp_string_ptr String  str  ) 
-
- - - - - -
-   - - -

-Get a pointer to String's buffer For rare cases when a C string is needed and you have a String. -

-One example is when you want to print a String with _stp_printf().

Parameters:
- - -
str String
-
-
Returns:
A C string (char *)
-
Note:
Readonly. Don't write to this pointer or it will mess up the internal String state and probably mess up your output or crash something.
- -

-Definition at line 138 of file string.c.

-

- - - - -
- - - - - - - - - - - - - - - - - - - - - - - - -
void _stp_vsprintf String  str,
const char *  fmt,
va_list  args
-
- - - - - -
-   - - -

-Vsprintf into a String Use this if your function already has a va_list. -

-You probably want _stp_sprintf(). -

-Definition at line 92 of file string.c. -

-References STP_STRING_SIZE.

- -- cgit