name: duk_require_null

proto: |
  void duk_require_null(duk_context *ctx, duk_idx_t idx);

stack: |
  [ ... val! ... ]

summary: |
  <p>Throw an error if the value at <code>idx</code> is not <code>null</code>
  or if the index is invalid.</p>

  <div class="note">
  There is no "get" primitive (<code>duk_get_null()</code>) because such a
  function would be a no-op.
  </div>

example: |
  duk_require_null(ctx, -3);

tags:
  - stack

introduced: 1.0.0