| .TH cs_parse_string 3 "12 July 2007" "ClearSilver" "cs/cs.h" |
| |
| .de Ss |
| .sp |
| .ft CW |
| .nf |
| .. |
| .de Se |
| .fi |
| .ft P |
| .sp |
| .. |
| .SH NAME |
| cs_parse_string - parse a CS template string |
| .SH SYNOPSIS |
| .Ss |
| #include <cs/cs.h> |
| .Se |
| .Ss |
| NEOERR *cs_parse_string (CSPARSE *parse, char *buf, size_t blen); |
| |
| .Se |
| |
| .SH ARGUMENTS |
| parse - a CSPARSE structure created with cs_init |
| .br |
| buf - the string to parse. Embedded NULLs are not currently |
| .br |
| supported |
| .br |
| blen - the length of the string |
| |
| .SH DESCRIPTION |
| cs_parse_string parses a string. The string is |
| modified, and internal references are kept by the parse |
| tree. For this reason, ownership of the string is |
| transfered to the CS system, and the string will be |
| free'd when cs_destroy() is called. |
| The parse information will be appended to the current |
| parse tree. During parse, the only HDF variables which |
| are evaluated are those used in evar or include |
| statements. |
| |
| .SH "RETURN VALUE" |
| None |
| |
| .SH "SEE ALSO" |
| .BR cs_dump "(3), "cs_destroy "(3), "cs_render "(3), "cs_register_esc_strfunc "(3), "cs_arg_parsev "(3), "cs_register_fileload "(3), "cs_init "(3), "cs_register_strfunc "(3), "cs_arg_parse "(3), "cs_parse_string "(3), "cs_parse_file "(3), "= "(3), "cs_register_function |