duktape/website/api/duk_pcompile_string.yaml

name: duk_pcompile_string

proto: |
  duk_int_t duk_pcompile_string(duk_context *ctx, duk_uint_t flags, const char *src);

stack: |
  [ ... ] -> [ ... function! ]  (if success, return value == 0)
  [ ... ] -> [ ... err! ]  (if failure, return value != 0)

summary: |
  <p>Like
  <code><a href="#duk_pcompile">duk_pcompile()</a></code>, but the compile input
  is given as a C string.  The filename associated with the function is
  automatically provided from the <code>__FILE__</code> preprocessor define
  of the caller.</p>

  <div include="no-string-intern.html" />

example: |
  if (duk_pcompile_string(ctx, 0, "print('program code'); syntax error here=") != 0) {
      printf("compile failed: %s\n", duk_safe_to_string(ctx, -1));
  } else {
      duk_call(ctx, 0);      /* [ func ] -> [ result ] */
      printf("program result: %s\n", duk_safe_to_string(ctx, -1));
  }
  duk_pop(ctx);

tags:
  - compile
  - protected

introduced: 1.0.0