name: duk_get_prop_lstring

proto: |
  duk_bool_t duk_get_prop_lstring(duk_context *ctx, duk_idx_t obj_idx, const char *key, duk_size_t key_len);

stack: |
  [ ... obj! ... ] -> [ ... obj! ... val! ]  (if key exists)
  [ ... obj! ... ] -> [ ... obj! ... undefined! ]  (if key doesn't exist)

summary: |
  <p>Like <code><a href="#duk_get_prop">duk_get_prop()</a></code>,
  but the property name is given as a string with explicit length.</p>

example: |
  (void) duk_get_prop_lstring(ctx, -3, "internal" "\x00" "nul", 12);
  printf("obj.internal[00]nul = %s\n", duk_to_string(ctx, -1));
  duk_pop(ctx);

tags:
  - property
  - string

seealso:
  - duk_get_prop
  - duk_get_prop_index
  - duk_get_prop_string
  - duk_get_prop_literal
  - duk_get_prop_heapptr

introduced: 2.0.0