Skip to content

bpo-35582: Argument Clinic: inline parsing code for positional parameters.#11313

Merged
serhiy-storchaka merged 5 commits intopython:masterfrom
serhiy-storchaka:clinic-inline-multiple-pos-args
Jan 11, 2019
Merged

bpo-35582: Argument Clinic: inline parsing code for positional parameters.#11313
serhiy-storchaka merged 5 commits intopython:masterfrom
serhiy-storchaka:clinic-inline-multiple-pos-args

Conversation

@serhiy-storchaka
Copy link
Copy Markdown
Member

@serhiy-storchaka serhiy-storchaka commented Dec 25, 2018

Copy link
Copy Markdown
Member

@vstinner vstinner left a comment

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

LGTM.

I'm now curious, can you check with a benchmark if it optimizes some specific functions?

@serhiy-storchaka
Copy link
Copy Markdown
Member Author

Added some examples on the tracker.

Comment thread Include/modsupport.h
Py_ssize_t, Py_ssize_t);
#define _PyArg_CheckPositional(funcname, nargs, min, max) \
(((min) <= (nargs) && (nargs) <= (max)) \
|| _PyArg_CheckPositional((funcname), (nargs), (min), (max)))
Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Would it be possible to find a different name for the function? Otherwise, it's unclear what is _PyArg_CheckPositional(). For _PyUnicodeWriter, I used _PyUnicodeWriter_Prepare (macro) and _PyUnicodeWriter_PrepareInternal (func) names.

/* Prepare the buffer to write 'length' characters
   with the specified maximum character.

   Return 0 on success, raise an exception and return -1 on error. */
#define _PyUnicodeWriter_Prepare(WRITER, LENGTH, MAXCHAR)             \
    (((MAXCHAR) <= (WRITER)->maxchar                                  \
      && (LENGTH) <= (WRITER)->size - (WRITER)->pos)                  \
     ? 0                                                              \
     : (((LENGTH) == 0)                                               \
        ? 0                                                           \
        : _PyUnicodeWriter_PrepareInternal((WRITER), (LENGTH), (MAXCHAR))))

/* Don't call this function directly, use the _PyUnicodeWriter_Prepare() macro
   instead. */
PyAPI_FUNC(int)
_PyUnicodeWriter_PrepareInternal(_PyUnicodeWriter *writer,
                                 Py_ssize_t length, Py_UCS4 maxchar);

You may write a static inline function rather than a macro.

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

It is a common method to use the same name for the function and optimizing macro. See for example _PyArg_NoKeywords.

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Ok. It was just a proposition, not a requirement ;-) I'm also fine with have the same name for the macro and function.

@serhiy-storchaka serhiy-storchaka merged commit 4fa9591 into python:master Jan 11, 2019
@serhiy-storchaka serhiy-storchaka deleted the clinic-inline-multiple-pos-args branch January 11, 2019 14:01
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

performance Performance or resource usage skip news

Projects

None yet

Development

Successfully merging this pull request may close these issues.

4 participants