index.html 33 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526
  1. <!DOCTYPE html>
  2. <html lang="en" class="h-full">
  3. <head>
  4. <meta charset="UTF-8">
  5. <meta name="viewport" content="width=device-width,initial-scale=1">
  6. <meta name="color-scheme" content="light dark">
  7. <meta name="turbo-cache-control" content="no-cache" data-turbo-track="reload" data-track-token="4.5.3.829710671039">
  8. <!-- See retype.com -->
  9. <meta name="generator" content="Retype 4.5.3">
  10. <!-- Primary Meta Tags -->
  11. <title>operator | Portable Python 3.x Interpreter in Modern C</title>
  12. <meta name="title" content="operator | Portable Python 3.x Interpreter in Modern C">
  13. <meta name="description" content="The operator module exports a set of efficient functions corresponding to the intrinsic operators of Python. For example, operator.add(x, y) is equivalent to the expression x+y.">
  14. <!-- Canonical -->
  15. <link rel="canonical" href="https://pocketpy.dev/modules/operator/">
  16. <link rel="sitemap" type="application/xml" title="Sitemap" href="https://pocketpy.dev/sitemap.xml">
  17. <!-- Open Graph -->
  18. <meta property="og:type" content="website">
  19. <meta property="og:url" content="https://pocketpy.dev/modules/operator/">
  20. <meta property="og:title" content="operator | Portable Python 3.x Interpreter in Modern C">
  21. <meta property="og:description" content="The operator module exports a set of efficient functions corresponding to the intrinsic operators of Python. For example, operator.add(x, y) is equivalent to the expression x+y.">
  22. <meta property="og:site_name" content="pocketpy">
  23. <meta property="og:locale" content="en_US">
  24. <!-- Twitter -->
  25. <meta name="twitter:card" content="summary_large_image">
  26. <meta name="twitter:url" content="https://pocketpy.dev/modules/operator/">
  27. <meta name="twitter:title" content="operator | Portable Python 3.x Interpreter in Modern C">
  28. <meta name="twitter:description" content="The operator module exports a set of efficient functions corresponding to the intrinsic operators of Python. For example, operator.add(x, y) is equivalent to the expression x+y.">
  29. <!-- Alternate Markdown -->
  30. <link rel="alternate" type="text/markdown" href="https://pocketpy.dev/modules/operator.md">
  31. <script data-cfasync="false">(function(){var cl=document.documentElement.classList,ls=localStorage.getItem("retype_scheme"),hd=cl.contains("dark"),hl=cl.contains("light"),wm=window.matchMedia&&window.matchMedia("(prefers-color-scheme: dark)").matches;if(ls==="dark"||(!ls&&wm&&!hd&&!hl)){cl.remove("light");cl.add("dark")}else if(ls==="light"||(!ls&&!wm&&!hd&&!hl)){cl.remove("dark");cl.add("light")}})();</script>
  32. <link id="retype-favicon" rel="icon" href="../../static/logo.png" />
  33. <link href="../../resources/css/retype.css?v=4.5.3.829710671039" rel="stylesheet">
  34. <script data-cfasync="false" src="../../resources/js/config.js?v=4.5.3.829710671039" data-turbo-eval="false" defer></script>
  35. <script data-cfasync="false" src="../../resources/js/retype.js?v=4.5.3" data-turbo-eval="false" defer></script>
  36. <script id="lunr-js" data-cfasync="false" src="../../resources/js/lunr.js?v=4.5.3.829710671039" data-turbo-eval="false" defer></script>
  37. </head>
  38. <body>
  39. <div id="retype-app" class="relative text-base antialiased text-base-text bg-base-bg font-body">
  40. <div class="absolute bottom-0 left-0" style="top: 5rem; right: 50%"></div>
  41. <header id="retype-header" class="sticky top-0 z-30 flex w-full h-16 bg-header-bg border-b border-header-border md:h-20">
  42. <div class="container relative flex items-center justify-between pr-6 grow md:justify-start">
  43. <!-- Mobile menu button skeleton -->
  44. <button v-cloak class="skeleton retype-mobile-menu-button flex items-center justify-center shrink-0 overflow-hidden dark:text-white focus:outline-hidden rounded-full w-10 h-10 ml-3.5 md:hidden"><svg xmlns="http://www.w3.org/2000/svg" class="mb-px shrink-0" width="24" height="24" viewBox="0 0 24 24" role="presentation" style="margin-bottom: 0px;"><g fill="currentColor"><path d="M2 4h20v2H2zM2 11h20v2H2zM2 18h20v2H2z"></path></g></svg></button>
  45. <div v-cloak id="retype-sidebar-left-toggle-button"></div>
  46. <!-- Logo -->
  47. <div class="flex items-center justify-between h-full py-2 md:w-75">
  48. <div class="flex items-center px-2 md:px-6">
  49. <a id="retype-branding-logo" href="https://pocketpy.dev/" class="flex items-center leading-snug text-2xl">
  50. <span class="w-10 mr-2 grow-0 shrink-0 overflow-hidden">
  51. <img class="max-h-10 md:inline-block" src="../../static/logo.png" alt="" width="40" height="40">
  52. </span>
  53. <span class="dark:text-white font-bold line-clamp-1 md:line-clamp-2">pocketpy</span>
  54. </a><span id="retype-branding-label" class="inline-flex mt-1 px-2 py-1 ml-4 text-xs font-medium leading-none items-center rounded-md bg-branding-label-bg text-branding-label-text ring-1 ring-branding-label-border ring-inset md:inline-block">v2.1.9</span>
  55. </div>
  56. <span class="hidden h-8 border-r md:inline-block border-base-border"></span>
  57. </div>
  58. <div class="flex justify-between md:grow">
  59. <!-- Top Nav -->
  60. <nav id="retype-header-nav" class="hidden md:flex">
  61. <ul class="flex flex-col mb-4 md:pl-16 md:mb-0 md:flex-row md:items-center">
  62. <li class="mr-6">
  63. <a class="py-2 md:mb-0 inline-flex items-center text-sm whitespace-nowrap transition-colors duration-200 ease-linear md:text-header-text font-header-text hover:text-header-text-hover">
  64. <svg xmlns="http://www.w3.org/2000/svg" class="block shrink-0 mr-1.5" width="18" height="18" viewBox="0 0 24 24" fill="currentColor" aria-hidden="true" focusable="false">
  65. <path d="M11.03 2.59a1.501 1.501 0 0 1 1.94 0l7.5 6.363a1.5 1.5 0 0 1 .53 1.144V19.5a1.5 1.5 0 0 1-1.5 1.5h-5.75a.75.75 0 0 1-.75-.75V14h-2v6.25a.75.75 0 0 1-.75.75H4.5A1.5 1.5 0 0 1 3 19.5v-9.403c0-.44.194-.859.53-1.144ZM12 3.734l-7.5 6.363V19.5h5v-6.25a.75.75 0 0 1 .75-.75h3.5a.75.75 0 0 1 .75.75v6.25h5v-9.403Z"/>
  66. </svg>
  67. <span>Home</span>
  68. </a>
  69. </li>
  70. <li class="mr-6">
  71. <a class="py-2 md:mb-0 inline-flex items-center text-sm whitespace-nowrap transition-colors duration-200 ease-linear md:text-header-text font-header-text hover:text-header-text-hover" href="https://pocketpy.dev/static/web/" target="_blank">
  72. <svg xmlns="http://www.w3.org/2000/svg" class="block shrink-0 mr-1.5" width="18" height="18" viewBox="0 0 24 24" fill="currentColor" aria-hidden="true" focusable="false">
  73. <path d="M9.5 15.584V8.416a.5.5 0 0 1 .77-.42l5.576 3.583a.5.5 0 0 1 0 .842l-5.576 3.584a.5.5 0 0 1-.77-.42Z"/><path d="M1 12C1 5.925 5.925 1 12 1s11 4.925 11 11-4.925 11-11 11S1 18.075 1 12Zm11-9.5A9.5 9.5 0 0 0 2.5 12a9.5 9.5 0 0 0 9.5 9.5 9.5 9.5 0 0 0 9.5-9.5A9.5 9.5 0 0 0 12 2.5Z"/>
  74. </svg>
  75. <span>Live Demo</span>
  76. </a>
  77. </li>
  78. <li class="mr-6">
  79. <a class="py-2 md:mb-0 inline-flex items-center text-sm whitespace-nowrap transition-colors duration-200 ease-linear md:text-header-text font-header-text hover:text-header-text-hover" href="https://pocketpy.github.io/examples/" target="_blank">
  80. <svg xmlns="http://www.w3.org/2000/svg" class="block shrink-0 mr-1.5" width="18" height="18" viewBox="0 0 24 24" fill="currentColor" aria-hidden="true" focusable="false">
  81. <path d="M15.22 4.97a.75.75 0 0 1 1.06 0l6.5 6.5a.75.75 0 0 1 0 1.06l-6.5 6.5a.749.749 0 0 1-1.275-.326.749.749 0 0 1 .215-.734L21.19 12l-5.97-5.97a.75.75 0 0 1 0-1.06Zm-6.44 0a.75.75 0 0 1 0 1.06L2.81 12l5.97 5.97a.749.749 0 0 1-.326 1.275.749.749 0 0 1-.734-.215l-6.5-6.5a.75.75 0 0 1 0-1.06l6.5-6.5a.75.75 0 0 1 1.06 0Z"/>
  82. </svg>
  83. <span>Live Examples</span>
  84. </a>
  85. </li>
  86. <li class="mr-6">
  87. <a class="py-2 md:mb-0 inline-flex items-center text-sm whitespace-nowrap transition-colors duration-200 ease-linear md:text-header-text font-header-text hover:text-header-text-hover" href="https://github.com/blueloveth/pocketpy" target="_blank">
  88. <svg xmlns="http://www.w3.org/2000/svg" class="block shrink-0 mr-1.5" width="18" height="18" viewBox="0 0 24 24" fill="currentColor" aria-hidden="true" focusable="false">
  89. <path d="M10.226 17.284c-2.965-.36-5.054-2.493-5.054-5.256 0-1.123.404-2.336 1.078-3.144-.292-.741-.247-2.314.09-2.965.898-.112 2.111.36 2.83 1.01.853-.269 1.752-.404 2.853-.404 1.1 0 1.999.135 2.807.382.696-.629 1.932-1.1 2.83-.988.315.606.36 2.179.067 2.942.72.854 1.101 2 1.101 3.167 0 2.763-2.089 4.852-5.098 5.234.763.494 1.28 1.572 1.28 2.807v2.336c0 .674.561 1.056 1.235.786 4.066-1.55 7.255-5.615 7.255-10.646C23.5 6.188 18.334 1 11.978 1 5.62 1 .5 6.188.5 12.545c0 4.986 3.167 9.12 7.435 10.669.606.225 1.19-.18 1.19-.786V20.63a2.9 2.9 0 0 1-1.078.224c-1.483 0-2.359-.808-2.987-2.313-.247-.607-.517-.966-1.034-1.033-.27-.023-.359-.135-.359-.27 0-.27.45-.471.898-.471.652 0 1.213.404 1.797 1.235.45.651.921.943 1.483.943.561 0 .92-.202 1.437-.719.382-.381.674-.718.944-.943"/>
  90. </svg>
  91. <span>Github</span>
  92. </a>
  93. </li>
  94. <li class="mr-6">
  95. <a class="py-2 md:mb-0 inline-flex items-center text-sm whitespace-nowrap transition-colors duration-200 ease-linear md:text-header-text font-header-text hover:text-header-text-hover" href="https://discord.gg/WWaq72GzXv" target="_blank">
  96. <svg xmlns="http://www.w3.org/2000/svg" class="block shrink-0 mr-1.5" width="18" height="18" viewBox="0 0 24 24" fill="currentColor" aria-hidden="true" focusable="false">
  97. <path d="M1.75 1h12.5c.966 0 1.75.784 1.75 1.75v9.5A1.75 1.75 0 0 1 14.25 14H8.061l-2.574 2.573A1.458 1.458 0 0 1 3 15.543V14H1.75A1.75 1.75 0 0 1 0 12.25v-9.5C0 1.784.784 1 1.75 1ZM1.5 2.75v9.5c0 .138.112.25.25.25h2a.75.75 0 0 1 .75.75v2.19l2.72-2.72a.749.749 0 0 1 .53-.22h6.5a.25.25 0 0 0 .25-.25v-9.5a.25.25 0 0 0-.25-.25H1.75a.25.25 0 0 0-.25.25Z"/><path d="M22.5 8.75a.25.25 0 0 0-.25-.25h-3.5a.75.75 0 0 1 0-1.5h3.5c.966 0 1.75.784 1.75 1.75v9.5A1.75 1.75 0 0 1 22.25 20H21v1.543a1.457 1.457 0 0 1-2.487 1.03L15.939 20H10.75A1.75 1.75 0 0 1 9 18.25v-1.465a.75.75 0 0 1 1.5 0v1.465c0 .138.112.25.25.25h5.5a.75.75 0 0 1 .53.22l2.72 2.72v-2.19a.75.75 0 0 1 .75-.75h2a.25.25 0 0 0 .25-.25v-9.5Z"/>
  98. </svg>
  99. <span>Discord</span>
  100. </a>
  101. </li>
  102. </ul>
  103. </nav>
  104. <div v-cloak class="flex justify-end grow">
  105. <div id="retype-mobile-search-button"></div>
  106. <doc-search-desktop></doc-search-desktop>
  107. <doc-theme-switch class="lg:ml-2"></doc-theme-switch>
  108. <doc-history></doc-history>
  109. </div>
  110. </div>
  111. </div>
  112. </header>
  113. <div id="retype-container" class="container relative flex bg-white">
  114. <!-- Sidebar Skeleton -->
  115. <div v-cloak class="fixed flex flex-col shrink-0 duration-300 ease-in-out bg-sidebar-left-bg border-sidebar-left-border sidebar top-20 w-75 border-r h-screen md:sticky transition-transform skeleton">
  116. <div class="flex items-center h-16 px-6">
  117. <input id="retype-filter-input-mock" class="w-full h-10 pl-8 px-3 py-2 transition-colors duration-200 ease-linear bg-filter-bg border border-filter-border rounded-lg shadow-none md:text-sm hover:border-filter-border-hover focus:outline-hidden focus:border-filter-border-focus placeholder-filter-placeholder" type="text">
  118. </div>
  119. <div class="pl-6 mt-1 mb-4">
  120. <div class="w-32 h-3 mb-4 bg-skeleton-bg rounded-full loading"></div>
  121. <div class="w-48 h-3 mb-4 bg-skeleton-bg rounded-full loading"></div>
  122. <div class="w-40 h-3 mb-4 bg-skeleton-bg rounded-full loading"></div>
  123. <div class="w-32 h-3 mb-4 bg-skeleton-bg rounded-full loading"></div>
  124. <div class="w-48 h-3 mb-4 bg-skeleton-bg rounded-full loading"></div>
  125. <div class="w-40 h-3 mb-4 bg-skeleton-bg rounded-full loading"></div>
  126. </div>
  127. <div class="shrink-0 mt-auto bg-transparent dark:border-base-border">
  128. <a class="flex items-center justify-center flex-nowrap h-16 text-gray-350 dark:text-dark-400 hover:text-gray-600 dark:hover:text-dark-300 transition-colors duration-150 ease-in docs-powered-by" target="_blank" href="https://retype.com/" rel="noopener">
  129. <span class="text-xs whitespace-nowrap">Powered by</span>
  130. <svg xmlns="http://www.w3.org/2000/svg" class="ml-2" fill="currentColor" width="96" height="20" overflow="visible"><path d="M0 0v20h13.59V0H0zm11.15 17.54H2.44V2.46h8.71v15.08zM15.8 20h2.44V4.67L15.8 2.22zM20.45 6.89V20h2.44V9.34z"/><g><path d="M40.16 8.44c0 1.49-.59 2.45-1.75 2.88l2.34 3.32h-2.53l-2.04-2.96h-1.43v2.96h-2.06V5.36h3.5c1.43 0 2.46.24 3.07.73s.9 1.27.9 2.35zm-2.48 1.1c.26-.23.38-.59.38-1.09 0-.5-.13-.84-.4-1.03s-.73-.28-1.39-.28h-1.54v2.75h1.5c.72 0 1.2-.12 1.45-.35zM51.56 5.36V7.2h-4.59v1.91h4.13v1.76h-4.13v1.92h4.74v1.83h-6.79V5.36h6.64zM60.09 7.15v7.48h-2.06V7.15h-2.61V5.36h7.28v1.79h-2.61zM70.81 14.64h-2.06v-3.66l-3.19-5.61h2.23l1.99 3.45 1.99-3.45H74l-3.19 5.61v3.66zM83.99 6.19c.65.55.97 1.4.97 2.55s-.33 1.98-1 2.51-1.68.8-3.04.8h-1.23v2.59h-2.06V5.36h3.26c1.42 0 2.45.28 3.1.83zm-1.51 3.65c.25-.28.37-.69.37-1.22s-.16-.92-.48-1.14c-.32-.23-.82-.34-1.5-.34H79.7v3.12h1.38c.68 0 1.15-.14 1.4-.42zM95.85 5.36V7.2h-4.59v1.91h4.13v1.76h-4.13v1.92H96v1.83h-6.79V5.36h6.64z"/></g></svg>
  131. </a>
  132. </div>
  133. </div>
  134. <!-- Sidebar component -->
  135. <doc-sidebar v-cloak>
  136. <template #sidebar-footer>
  137. <div class="shrink-0 mt-auto border-t md:bg-transparent md:border-none dark:border-base-border">
  138. <div class="py-3 px-6 md:hidden border-b dark:border-base-border">
  139. <nav>
  140. <ul class="flex flex-wrap justify-center items-center">
  141. <li class="mr-6">
  142. <a class="block py-1 inline-flex items-center text-sm whitespace-nowrap transition-colors duration-200 ease-linear md:text-header-text font-header-text hover:text-header-text-hover">
  143. <svg xmlns="http://www.w3.org/2000/svg" class="block shrink-0 mr-1.5" width="18" height="18" viewBox="0 0 24 24" fill="currentColor" aria-hidden="true" focusable="false">
  144. <path d="M11.03 2.59a1.501 1.501 0 0 1 1.94 0l7.5 6.363a1.5 1.5 0 0 1 .53 1.144V19.5a1.5 1.5 0 0 1-1.5 1.5h-5.75a.75.75 0 0 1-.75-.75V14h-2v6.25a.75.75 0 0 1-.75.75H4.5A1.5 1.5 0 0 1 3 19.5v-9.403c0-.44.194-.859.53-1.144ZM12 3.734l-7.5 6.363V19.5h5v-6.25a.75.75 0 0 1 .75-.75h3.5a.75.75 0 0 1 .75.75v6.25h5v-9.403Z"/>
  145. </svg>
  146. <span>Home</span>
  147. </a>
  148. </li>
  149. <li class="mr-6">
  150. <a class="block py-1 inline-flex items-center text-sm whitespace-nowrap transition-colors duration-200 ease-linear md:text-header-text font-header-text hover:text-header-text-hover" href="https://pocketpy.dev/static/web/" target="_blank">
  151. <svg xmlns="http://www.w3.org/2000/svg" class="block shrink-0 mr-1.5" width="18" height="18" viewBox="0 0 24 24" fill="currentColor" aria-hidden="true" focusable="false">
  152. <path d="M9.5 15.584V8.416a.5.5 0 0 1 .77-.42l5.576 3.583a.5.5 0 0 1 0 .842l-5.576 3.584a.5.5 0 0 1-.77-.42Z"/><path d="M1 12C1 5.925 5.925 1 12 1s11 4.925 11 11-4.925 11-11 11S1 18.075 1 12Zm11-9.5A9.5 9.5 0 0 0 2.5 12a9.5 9.5 0 0 0 9.5 9.5 9.5 9.5 0 0 0 9.5-9.5A9.5 9.5 0 0 0 12 2.5Z"/>
  153. </svg>
  154. <span>Live Demo</span>
  155. </a>
  156. </li>
  157. <li class="mr-6">
  158. <a class="block py-1 inline-flex items-center text-sm whitespace-nowrap transition-colors duration-200 ease-linear md:text-header-text font-header-text hover:text-header-text-hover" href="https://pocketpy.github.io/examples/" target="_blank">
  159. <svg xmlns="http://www.w3.org/2000/svg" class="block shrink-0 mr-1.5" width="18" height="18" viewBox="0 0 24 24" fill="currentColor" aria-hidden="true" focusable="false">
  160. <path d="M15.22 4.97a.75.75 0 0 1 1.06 0l6.5 6.5a.75.75 0 0 1 0 1.06l-6.5 6.5a.749.749 0 0 1-1.275-.326.749.749 0 0 1 .215-.734L21.19 12l-5.97-5.97a.75.75 0 0 1 0-1.06Zm-6.44 0a.75.75 0 0 1 0 1.06L2.81 12l5.97 5.97a.749.749 0 0 1-.326 1.275.749.749 0 0 1-.734-.215l-6.5-6.5a.75.75 0 0 1 0-1.06l6.5-6.5a.75.75 0 0 1 1.06 0Z"/>
  161. </svg>
  162. <span>Live Examples</span>
  163. </a>
  164. </li>
  165. <li class="mr-6">
  166. <a class="block py-1 inline-flex items-center text-sm whitespace-nowrap transition-colors duration-200 ease-linear md:text-header-text font-header-text hover:text-header-text-hover" href="https://github.com/blueloveth/pocketpy" target="_blank">
  167. <svg xmlns="http://www.w3.org/2000/svg" class="block shrink-0 mr-1.5" width="18" height="18" viewBox="0 0 24 24" fill="currentColor" aria-hidden="true" focusable="false">
  168. <path d="M10.226 17.284c-2.965-.36-5.054-2.493-5.054-5.256 0-1.123.404-2.336 1.078-3.144-.292-.741-.247-2.314.09-2.965.898-.112 2.111.36 2.83 1.01.853-.269 1.752-.404 2.853-.404 1.1 0 1.999.135 2.807.382.696-.629 1.932-1.1 2.83-.988.315.606.36 2.179.067 2.942.72.854 1.101 2 1.101 3.167 0 2.763-2.089 4.852-5.098 5.234.763.494 1.28 1.572 1.28 2.807v2.336c0 .674.561 1.056 1.235.786 4.066-1.55 7.255-5.615 7.255-10.646C23.5 6.188 18.334 1 11.978 1 5.62 1 .5 6.188.5 12.545c0 4.986 3.167 9.12 7.435 10.669.606.225 1.19-.18 1.19-.786V20.63a2.9 2.9 0 0 1-1.078.224c-1.483 0-2.359-.808-2.987-2.313-.247-.607-.517-.966-1.034-1.033-.27-.023-.359-.135-.359-.27 0-.27.45-.471.898-.471.652 0 1.213.404 1.797 1.235.45.651.921.943 1.483.943.561 0 .92-.202 1.437-.719.382-.381.674-.718.944-.943"/>
  169. </svg>
  170. <span>Github</span>
  171. </a>
  172. </li>
  173. <li class="mr-6">
  174. <a class="block py-1 inline-flex items-center text-sm whitespace-nowrap transition-colors duration-200 ease-linear md:text-header-text font-header-text hover:text-header-text-hover" href="https://discord.gg/WWaq72GzXv" target="_blank">
  175. <svg xmlns="http://www.w3.org/2000/svg" class="block shrink-0 mr-1.5" width="18" height="18" viewBox="0 0 24 24" fill="currentColor" aria-hidden="true" focusable="false">
  176. <path d="M1.75 1h12.5c.966 0 1.75.784 1.75 1.75v9.5A1.75 1.75 0 0 1 14.25 14H8.061l-2.574 2.573A1.458 1.458 0 0 1 3 15.543V14H1.75A1.75 1.75 0 0 1 0 12.25v-9.5C0 1.784.784 1 1.75 1ZM1.5 2.75v9.5c0 .138.112.25.25.25h2a.75.75 0 0 1 .75.75v2.19l2.72-2.72a.749.749 0 0 1 .53-.22h6.5a.25.25 0 0 0 .25-.25v-9.5a.25.25 0 0 0-.25-.25H1.75a.25.25 0 0 0-.25.25Z"/><path d="M22.5 8.75a.25.25 0 0 0-.25-.25h-3.5a.75.75 0 0 1 0-1.5h3.5c.966 0 1.75.784 1.75 1.75v9.5A1.75 1.75 0 0 1 22.25 20H21v1.543a1.457 1.457 0 0 1-2.487 1.03L15.939 20H10.75A1.75 1.75 0 0 1 9 18.25v-1.465a.75.75 0 0 1 1.5 0v1.465c0 .138.112.25.25.25h5.5a.75.75 0 0 1 .53.22l2.72 2.72v-2.19a.75.75 0 0 1 .75-.75h2a.25.25 0 0 0 .25-.25v-9.5Z"/>
  177. </svg>
  178. <span>Discord</span>
  179. </a>
  180. </li>
  181. </ul>
  182. </nav>
  183. </div>
  184. <a class="flex items-center justify-center flex-nowrap h-16 text-gray-350 dark:text-dark-400 hover:text-gray-600 dark:hover:text-dark-300 transition-colors duration-150 ease-in docs-powered-by" target="_blank" href="https://retype.com/" rel="noopener">
  185. <span class="text-xs whitespace-nowrap">Powered by</span>
  186. <svg xmlns="http://www.w3.org/2000/svg" class="ml-2" fill="currentColor" width="96" height="20" overflow="visible"><path d="M0 0v20h13.59V0H0zm11.15 17.54H2.44V2.46h8.71v15.08zM15.8 20h2.44V4.67L15.8 2.22zM20.45 6.89V20h2.44V9.34z"/><g><path d="M40.16 8.44c0 1.49-.59 2.45-1.75 2.88l2.34 3.32h-2.53l-2.04-2.96h-1.43v2.96h-2.06V5.36h3.5c1.43 0 2.46.24 3.07.73s.9 1.27.9 2.35zm-2.48 1.1c.26-.23.38-.59.38-1.09 0-.5-.13-.84-.4-1.03s-.73-.28-1.39-.28h-1.54v2.75h1.5c.72 0 1.2-.12 1.45-.35zM51.56 5.36V7.2h-4.59v1.91h4.13v1.76h-4.13v1.92h4.74v1.83h-6.79V5.36h6.64zM60.09 7.15v7.48h-2.06V7.15h-2.61V5.36h7.28v1.79h-2.61zM70.81 14.64h-2.06v-3.66l-3.19-5.61h2.23l1.99 3.45 1.99-3.45H74l-3.19 5.61v3.66zM83.99 6.19c.65.55.97 1.4.97 2.55s-.33 1.98-1 2.51-1.68.8-3.04.8h-1.23v2.59h-2.06V5.36h3.26c1.42 0 2.45.28 3.1.83zm-1.51 3.65c.25-.28.37-.69.37-1.22s-.16-.92-.48-1.14c-.32-.23-.82-.34-1.5-.34H79.7v3.12h1.38c.68 0 1.15-.14 1.4-.42zM95.85 5.36V7.2h-4.59v1.91h4.13v1.76h-4.13v1.92H96v1.83h-6.79V5.36h6.64z"/></g></svg>
  187. </a>
  188. </div>
  189. </template>
  190. </doc-sidebar>
  191. <div class="grow min-w-0 bg-body-bg">
  192. <!-- Render "toolbar" template here on api pages --><!-- Render page content -->
  193. <div class="flex">
  194. <div id="retype-main" class="min-w-0 p-4 grow md:px-16">
  195. <main class="relative pb-12 lg:pt-2">
  196. <div class="relative retype-markdown" id="retype-content">
  197. <!-- Rendered if sidebar right is enabled -->
  198. <div id="retype-sidebar-right-toggle"></div>
  199. <doc-page-actions></doc-page-actions>
  200. <!-- Page content -->
  201. <h1 id="operator">operator</h1>
  202. <p>The operator module exports a set of efficient functions corresponding to the intrinsic operators of Python. For example, <code translate="no" v-pre>operator.add(x, y)</code> is equivalent to the expression <code translate="no" v-pre>x+y</code>. Many function names are those used for special methods, without the double underscores.</p>
  203. <h2 id="mapping-operators-to-functions">Mapping Operators to Functions</h2>
  204. <div class="table-wrapper scrollbar overflow-hidden">
  205. <table class="comfortable">
  206. <thead>
  207. <tr>
  208. <th>Operation</th>
  209. <th>Syntax</th>
  210. <th>Function</th>
  211. </tr>
  212. </thead>
  213. <tbody>
  214. <tr>
  215. <td>Ordering</td>
  216. <td><code translate="no" v-pre>a &lt;= b</code></td>
  217. <td><code translate="no" v-pre>le(a, b)</code></td>
  218. </tr>
  219. <tr>
  220. <td>Ordering</td>
  221. <td><code translate="no" v-pre>a &lt; b</code></td>
  222. <td><code translate="no" v-pre>lt(a, b)</code></td>
  223. </tr>
  224. <tr>
  225. <td>Ordering</td>
  226. <td><code translate="no" v-pre>a &gt;= b</code></td>
  227. <td><code translate="no" v-pre>ge(a, b)</code></td>
  228. </tr>
  229. <tr>
  230. <td>Ordering</td>
  231. <td><code translate="no" v-pre>a &gt; b</code></td>
  232. <td><code translate="no" v-pre>gt(a, b)</code></td>
  233. </tr>
  234. <tr>
  235. <td>Equality</td>
  236. <td><code translate="no" v-pre>a == b</code></td>
  237. <td><code translate="no" v-pre>eq(a, b)</code></td>
  238. </tr>
  239. <tr>
  240. <td>Equality</td>
  241. <td><code translate="no" v-pre>a != b</code></td>
  242. <td><code translate="no" v-pre>ne(a, b)</code></td>
  243. </tr>
  244. <tr>
  245. <td>Bitwise AND</td>
  246. <td><code translate="no" v-pre>a &amp; b</code></td>
  247. <td><code translate="no" v-pre>and_(a, b)</code></td>
  248. </tr>
  249. <tr>
  250. <td>Bitwise OR</td>
  251. <td><code translate="no" v-pre>a | b</code></td>
  252. <td><code translate="no" v-pre>or_(a, b)</code></td>
  253. </tr>
  254. <tr>
  255. <td>Bitwise XOR</td>
  256. <td><code translate="no" v-pre>a ^ b</code></td>
  257. <td><code translate="no" v-pre>xor(a, b)</code></td>
  258. </tr>
  259. <tr>
  260. <td>Bitwise Inversion</td>
  261. <td><code translate="no" v-pre>~a</code></td>
  262. <td><code translate="no" v-pre>invert(a)</code></td>
  263. </tr>
  264. <tr>
  265. <td>Left Shift</td>
  266. <td><code translate="no" v-pre>a &lt;&lt; b</code></td>
  267. <td><code translate="no" v-pre>lshift(a, b)</code></td>
  268. </tr>
  269. <tr>
  270. <td>Right Shift</td>
  271. <td><code translate="no" v-pre>a &gt;&gt; b</code></td>
  272. <td><code translate="no" v-pre>rshift(a, b)</code></td>
  273. </tr>
  274. <tr>
  275. <td>Identity</td>
  276. <td><code translate="no" v-pre>a is b</code></td>
  277. <td><code translate="no" v-pre>is_(a, b)</code></td>
  278. </tr>
  279. <tr>
  280. <td>Identity</td>
  281. <td><code translate="no" v-pre>a is not b</code></td>
  282. <td><code translate="no" v-pre>is_not(a, b)</code></td>
  283. </tr>
  284. <tr>
  285. <td>Negation (Logical)</td>
  286. <td><code translate="no" v-pre>not a</code></td>
  287. <td><code translate="no" v-pre>not_(a)</code></td>
  288. </tr>
  289. <tr>
  290. <td>Negation (Arithmetic)</td>
  291. <td><code translate="no" v-pre>-a</code></td>
  292. <td><code translate="no" v-pre>neg(a)</code></td>
  293. </tr>
  294. <tr>
  295. <td>Truth Test</td>
  296. <td><code translate="no" v-pre>bool(a)</code></td>
  297. <td><code translate="no" v-pre>truth(a)</code></td>
  298. </tr>
  299. <tr>
  300. <td>Containment Test</td>
  301. <td><code translate="no" v-pre>b in a</code></td>
  302. <td><code translate="no" v-pre>contains(a, b)</code></td>
  303. </tr>
  304. <tr>
  305. <td>Addition</td>
  306. <td><code translate="no" v-pre>a + b</code></td>
  307. <td><code translate="no" v-pre>add(a, b)</code></td>
  308. </tr>
  309. <tr>
  310. <td>Subtraction</td>
  311. <td><code translate="no" v-pre>a - b</code></td>
  312. <td><code translate="no" v-pre>sub(a, b)</code></td>
  313. </tr>
  314. <tr>
  315. <td>Multiplication</td>
  316. <td><code translate="no" v-pre>a * b</code></td>
  317. <td><code translate="no" v-pre>mul(a, b)</code></td>
  318. </tr>
  319. <tr>
  320. <td>Division</td>
  321. <td><code translate="no" v-pre>a / b</code></td>
  322. <td><code translate="no" v-pre>truediv(a, b)</code></td>
  323. </tr>
  324. <tr>
  325. <td>Division</td>
  326. <td><code translate="no" v-pre>a // b</code></td>
  327. <td><code translate="no" v-pre>floordiv(a, b)</code></td>
  328. </tr>
  329. <tr>
  330. <td>Modulo</td>
  331. <td><code translate="no" v-pre>a % b</code></td>
  332. <td><code translate="no" v-pre>mod(a, b)</code></td>
  333. </tr>
  334. <tr>
  335. <td>Exponentiation</td>
  336. <td><code translate="no" v-pre>a ** b</code></td>
  337. <td><code translate="no" v-pre>pow(a, b)</code></td>
  338. </tr>
  339. <tr>
  340. <td>Matrix Multiplication</td>
  341. <td><code translate="no" v-pre>a @ b</code></td>
  342. <td><code translate="no" v-pre>matmul(a, b)</code></td>
  343. </tr>
  344. <tr>
  345. <td>Indexing</td>
  346. <td><code translate="no" v-pre>a[b]</code></td>
  347. <td><code translate="no" v-pre>getitem(a, b)</code></td>
  348. </tr>
  349. <tr>
  350. <td>Index Assignment</td>
  351. <td><code translate="no" v-pre>a[b] = c</code></td>
  352. <td><code translate="no" v-pre>setitem(a, b, c)</code></td>
  353. </tr>
  354. <tr>
  355. <td>Index Deletion</td>
  356. <td><code translate="no" v-pre>del a[b]</code></td>
  357. <td><code translate="no" v-pre>delitem(a, b)</code></td>
  358. </tr>
  359. </tbody>
  360. </table>
  361. </div>
  362. <h2 id="in-place-operators">In-place Operators</h2>
  363. <div class="table-wrapper scrollbar overflow-hidden">
  364. <table class="comfortable">
  365. <thead>
  366. <tr>
  367. <th>Operation</th>
  368. <th>Syntax</th>
  369. <th>Function</th>
  370. </tr>
  371. </thead>
  372. <tbody>
  373. <tr>
  374. <td>Addition</td>
  375. <td><code translate="no" v-pre>a += b</code></td>
  376. <td><code translate="no" v-pre>iadd(a, b)</code></td>
  377. </tr>
  378. <tr>
  379. <td>Subtraction</td>
  380. <td><code translate="no" v-pre>a -= b</code></td>
  381. <td><code translate="no" v-pre>isub(a, b)</code></td>
  382. </tr>
  383. <tr>
  384. <td>Multiplication</td>
  385. <td><code translate="no" v-pre>a *= b</code></td>
  386. <td><code translate="no" v-pre>imul(a, b)</code></td>
  387. </tr>
  388. <tr>
  389. <td>Division</td>
  390. <td><code translate="no" v-pre>a /= b</code></td>
  391. <td><code translate="no" v-pre>itruediv(a, b)</code></td>
  392. </tr>
  393. <tr>
  394. <td>Division</td>
  395. <td><code translate="no" v-pre>a //= b</code></td>
  396. <td><code translate="no" v-pre>ifloordiv(a, b)</code></td>
  397. </tr>
  398. <tr>
  399. <td>Modulo</td>
  400. <td><code translate="no" v-pre>a %= b</code></td>
  401. <td><code translate="no" v-pre>imod(a, b)</code></td>
  402. </tr>
  403. <tr>
  404. <td>Bitwise AND</td>
  405. <td><code translate="no" v-pre>a &amp;= b</code></td>
  406. <td><code translate="no" v-pre>iand(a, b)</code></td>
  407. </tr>
  408. <tr>
  409. <td>Bitwise OR</td>
  410. <td><code translate="no" v-pre>a |= b</code></td>
  411. <td><code translate="no" v-pre>ior(a, b)</code></td>
  412. </tr>
  413. <tr>
  414. <td>Bitwise XOR</td>
  415. <td><code translate="no" v-pre>a ^= b</code></td>
  416. <td><code translate="no" v-pre>ixor(a, b)</code></td>
  417. </tr>
  418. <tr>
  419. <td>Left Shift</td>
  420. <td><code translate="no" v-pre>a &lt;&lt;= b</code></td>
  421. <td><code translate="no" v-pre>ilshift(a, b)</code></td>
  422. </tr>
  423. <tr>
  424. <td>Right Shift</td>
  425. <td><code translate="no" v-pre>a &gt;&gt;= b</code></td>
  426. <td><code translate="no" v-pre>irshift(a, b)</code></td>
  427. </tr>
  428. </tbody>
  429. </table>
  430. </div>
  431. <!-- Required only on API pages -->
  432. <doc-toolbar-member-filter-no-results></doc-toolbar-member-filter-no-results>
  433. </div>
  434. <footer id="retype-content-footer" class="clear-both">
  435. <nav id="retype-nextprev" class="print:hidden flex mt-14">
  436. <div class="w-1/2">
  437. <a class="px-5 py-4 h-full flex items-center break-normal font-medium text-body-link border border-base-border hover:border-base-border-hover rounded-l-lg transition-colors duration-150 relative hover:z-5" href="../../modules/msgpack/">
  438. <svg xmlns="http://www.w3.org/2000/svg" class="mr-3" width="24" height="24" viewBox="0 0 24 24" fill="currentColor" overflow="visible"><path d="M19 11H7.41l5.29-5.29a.996.996 0 10-1.41-1.41l-7 7a1 1 0 000 1.42l7 7a1.024 1.024 0 001.42-.01.996.996 0 000-1.41L7.41 13H19c.55 0 1-.45 1-1s-.45-1-1-1z" /><path fill="none" d="M0 0h24v24H0z" /></svg>
  439. <span>
  440. <span class="block text-xs font-normal text-base-text-muted">Previous</span>
  441. <span class="block mt-1">msgpack</span>
  442. </span>
  443. </a>
  444. </div>
  445. <div class="w-1/2">
  446. <a class="px-5 py-4 -mx-px h-full flex items-center justify-end break-normal font-medium text-body-link border border-base-border hover:border-base-border-hover rounded-r-lg transition-colors duration-150 relative hover:z-5" href="../../modules/periphery/">
  447. <span>
  448. <span class="block text-xs font-normal text-right text-base-text-muted">Next</span>
  449. <span class="block mt-1">periphery</span>
  450. </span>
  451. <svg xmlns="http://www.w3.org/2000/svg" class="ml-3" width="24" height="24" viewBox="0 0 24 24" fill="currentColor" overflow="visible"><path d="M19.92 12.38a1 1 0 00-.22-1.09l-7-7a.996.996 0 10-1.41 1.41l5.3 5.3H5c-.55 0-1 .45-1 1s.45 1 1 1h11.59l-5.29 5.29a.996.996 0 000 1.41c.19.2.44.3.7.3s.51-.1.71-.29l7-7c.09-.09.16-.21.21-.33z" /><path fill="none" d="M0 0h24v24H0z" /></svg>
  452. </a>
  453. </div>
  454. </nav>
  455. </footer>
  456. </main>
  457. <div id="retype-page-footer" class="print:border-none border-t border-base-border pt-6 mb-8">
  458. <footer class="flex flex-wrap items-center justify-between print:justify-center">
  459. <div id="retype-footer-links" class="print:hidden">
  460. <ul class="flex flex-wrap items-center text-sm">
  461. </ul>
  462. </div>
  463. <div id="retype-copyright" class="print:justify-center py-2 text-footer-text font-footer-link text-sm leading-relaxed"><p>© Copyright 2026 - <a href="https://github.com/blueloveTH">blueloveTH</a> - All rights reserved.</p></div>
  464. </footer>
  465. </div>
  466. </div>
  467. <!-- Rendered if sidebar right is enabled -->
  468. <!-- Sidebar right skeleton-->
  469. <div v-cloak class="fixed top-0 bottom-0 right-0 translate-x-full bg-sidebar-right-bg border-sidebar-right-border lg:sticky lg:border-l lg:shrink-0 lg:pt-6 lg:translate-x-0 sm:w-1/2 lg:w-64 lg:z-0 md:w-104 sidebar-right skeleton">
  470. <div class="pl-5">
  471. <div class="w-32 h-3 mb-4 bg-skeleton-bg rounded-full loading"></div>
  472. <div class="w-48 h-3 mb-4 bg-skeleton-bg rounded-full loading"></div>
  473. <div class="w-40 h-3 mb-4 bg-skeleton-bg rounded-full loading"></div>
  474. </div>
  475. </div>
  476. <!-- User should be able to hide sidebar right -->
  477. <doc-sidebar-right v-cloak></doc-sidebar-right>
  478. </div>
  479. </div>
  480. </div>
  481. <doc-search-mobile></doc-search-mobile>
  482. <doc-back-to-top></doc-back-to-top>
  483. </div>
  484. <div id="retype-overlay-target"></div>
  485. <script data-cfasync="false">window.__DOCS__ = { "title": "operator", level: 2, icon: "file", hasPrism: false, hasInstagram: false, hasMermaid: false, hasMath: false, tocDepth: 23, "md": "/modules/operator.md" }</script>
  486. </body>
  487. </html>