Skip to content
Projects
Groups
Snippets
Help
Loading...
Help
Support
Keyboard shortcuts
?
Submit feedback
Contribute to GitLab
Sign in / Register
Toggle navigation
C
cython
Project overview
Project overview
Details
Activity
Releases
Repository
Repository
Files
Commits
Branches
Tags
Contributors
Graph
Compare
Labels
Merge Requests
0
Merge Requests
0
Analytics
Analytics
Repository
Value Stream
Snippets
Snippets
Members
Members
Collapse sidebar
Close sidebar
Activity
Graph
Commits
Open sidebar
nexedi
cython
Commits
abb08286
Commit
abb08286
authored
May 20, 2018
by
gabrieldemarmiesse
Browse files
Options
Browse Files
Download
Email Patches
Plain Diff
Made code examples in the compatible python 2 and 3.
parent
2f3ee7ad
Changes
9
Show whitespace changes
Inline
Side-by-side
Showing
9 changed files
with
55 additions
and
43 deletions
+55
-43
docs/src/tutorial/array.rst
docs/src/tutorial/array.rst
+4
-4
docs/src/tutorial/pure.rst
docs/src/tutorial/pure.rst
+4
-4
docs/src/userguide/extension_types.rst
docs/src/userguide/extension_types.rst
+21
-17
docs/src/userguide/external_C_code.rst
docs/src/userguide/external_C_code.rst
+1
-1
docs/src/userguide/fusedtypes.rst
docs/src/userguide/fusedtypes.rst
+4
-3
docs/src/userguide/language_basics.rst
docs/src/userguide/language_basics.rst
+10
-5
docs/src/userguide/limitations.rst
docs/src/userguide/limitations.rst
+1
-1
docs/src/userguide/sharing_declarations.rst
docs/src/userguide/sharing_declarations.rst
+6
-4
docs/src/userguide/wrapping_CPlusPlus.rst
docs/src/userguide/wrapping_CPlusPlus.rst
+4
-4
No files found.
docs/src/tutorial/array.rst
View file @
abb08286
...
...
@@ -25,7 +25,7 @@ Safe usage with memory views
cdef array.array a = array.array('i', [1, 2, 3])
cdef int[:] ca = a
print
ca[0]
print
(ca[0])
NB: the import brings the regular Python array object into the namespace
while the cimport adds functions accessible from Cython.
...
...
@@ -51,8 +51,8 @@ functions without overhead, so long as it is typed::
cdef int no_overhead(int[:] ca):
return ca[0]
print
overhead(a
) # new memory view will be constructed, overhead
print
no_overhead(ca
) # ca is already a memory view, so no overhead
print
(overhead(a)
) # new memory view will be constructed, overhead
print
(no_overhead(ca)
) # ca is already a memory view, so no overhead
Zero-overhead, unsafe access to raw C pointer
---------------------------------------------
...
...
@@ -69,7 +69,7 @@ right type and signedness.
cdef array.array a = array.array('i', [1, 2, 3])
# access underlying pointer:
print
a.data.as_ints[0]
print
(a.data.as_ints[0])
from libc.string cimport memset
memset(a.data.as_voidptr, 0, len(a) * sizeof(int))
...
...
docs/src/tutorial/pure.rst
View file @
abb08286
...
...
@@ -57,7 +57,7 @@ file to be of the declared type. Thus if one has a file :file:`A.py`::
self.b = b
def foo(self, x):
print
x + _helper(1.0
)
print
(x + _helper(1.0)
)
and adds :file:`A.pxd`::
...
...
@@ -84,7 +84,7 @@ then Cython will compile the :file:`A.py` as if it had been written as follows::
self.b = b
cpdef foo(self, double x):
print
x + _helper(1.0
)
print
(x + _helper(1.0)
)
Notice how in order to provide the Python wrappers to the definitions
in the :file:`.pxd`, that is, to be accessible from Python,
...
...
@@ -312,8 +312,8 @@ Further Cython functions and declarations
::
cython.declare(n=cython.longlong)
print
cython.sizeof(cython.longlong
)
print
cython.sizeof(n
)
print
(cython.sizeof(cython.longlong)
)
print
(cython.sizeof(n)
)
* ``struct`` can be used to create struct types.::
...
...
docs/src/userguide/extension_types.rst
View file @
abb08286
...
...
@@ -14,6 +14,8 @@ statement, Cython also lets you create new built-in Python types, known as
extension types. You define an extension type using the :keyword:`cdef` class
statement. Here's an example::
from __future__ import print_function
cdef class Shrubbery:
cdef int width, height
...
...
@@ -23,8 +25,8 @@ statement. Here's an example::
self.height = h
def describe(self):
print
"This shrubbery is", self.width, \
"by", self.height, "cubits."
print
("This shrubbery is", self.width,
"by", self.height, "cubits.")
As you can see, a Cython extension type definition looks a lot like a Python
class definition. Within it, you use the def statement to define methods that
...
...
@@ -121,13 +123,13 @@ Suppose I have a method :meth:`quest` which returns an object of type :class:`Sh
To access it's width I could write::
cdef Shrubbery sh = quest()
print
sh.width
print
(sh.width)
which requires the use of a local variable and performs a type test on assignment.
If you *know* the return value of :meth:`quest` will be of type :class:`Shrubbery`
you can use a cast to write::
print
(<Shrubbery>quest()).width
print
((<Shrubbery>quest()).width)
This may be dangerous if :meth:`quest()` is not actually a :class:`Shrubbery`, as it
will try to access width as a C struct member which may not exist. At the C level,
...
...
@@ -135,7 +137,7 @@ rather than raising an :class:`AttributeError`, either an nonsensical result wil
returned (interpreting whatever data is at that address as an int) or a segfault
may result from trying to access invalid memory. Instead, one can write::
print
(<Shrubbery?>quest()).width
print
((<Shrubbery?>quest()).width)
which performs a type check (possibly raising a :class:`TypeError`) before making the
cast and allowing the code to proceed.
...
...
@@ -148,8 +150,8 @@ of an extension type must be correct to access its :keyword:`cdef` attributes an
type and does a type check instead, analogous to Pyrex's :meth:`typecheck`.
The old behavior is always available by passing a tuple as the second parameter::
print
isinstance(sh, Shrubbery
) # Check the type of sh
print
isinstance(sh, (Shrubbery,
)) # Check sh.__class__
print
(isinstance(sh, Shrubbery)
) # Check the type of sh
print
(isinstance(sh, (Shrubbery,)
)) # Check sh.__class__
Extension types and None
...
...
@@ -294,16 +296,16 @@ when it is deleted.::
from cheesy import CheeseShop
shop = CheeseShop()
print
shop.cheese
print
(shop.cheese)
shop.cheese = "camembert"
print
shop.cheese
print
(shop.cheese)
shop.cheese = "cheddar"
print
shop.cheese
print
(shop.cheese)
del shop.cheese
print
shop.cheese
print
(shop.cheese)
.. sourcecode:: text
...
...
@@ -371,21 +373,21 @@ compared to a :keyword:`cdef` method::
cdef class Parrot:
cdef void describe(self):
print
"This parrot is resting."
print
("This parrot is resting.")
cdef class Norwegian(Parrot):
cdef void describe(self):
Parrot.describe(self)
print
"Lovely plumage!"
print
("Lovely plumage!")
cdef Parrot p1, p2
p1 = Parrot()
p2 = Norwegian()
print
"p1:"
print
("p1:")
p1.describe()
print
"p2:"
print
("p2:")
p2.describe()
.. sourcecode:: text
...
...
@@ -591,6 +593,8 @@ objects defined in the Python core or in a non-Cython extension module.
Here is an example which will let you get at the C-level members of the
built-in complex object.::
from __future__ import print_function
cdef extern from "complexobject.h":
struct Py_complex:
...
...
@@ -602,8 +606,8 @@ built-in complex object.::
# A function which uses the above type
def spam(complex c):
print
"Real:", c.cval.real
print
"Imag:", c.cval.imag
print
("Real:", c.cval.real)
print
("Imag:", c.cval.imag)
.. note::
...
...
docs/src/userguide/external_C_code.rst
View file @
abb08286
...
...
@@ -475,7 +475,7 @@ made available when you include :file:`modulename_api.h`.::
cdef api void activate(Vehicle *v):
if v.speed >= 88 and v.power >= 1.21:
print
"Time travel achieved"
print
("Time travel achieved")
.. sourcecode:: c
...
...
docs/src/userguide/fusedtypes.rst
View file @
abb08286
...
...
@@ -26,6 +26,7 @@ Quickstart
::
from __future__ import print_function
cimport cython
ctypedef fused char_or_float:
...
...
@@ -41,8 +42,8 @@ Quickstart
cdef:
cython.char a = 127
cython.float b = 127
print
'char', plus_one(a
)
print
'float', plus_one(b
)
print
('char', plus_one(a)
)
print
('float', plus_one(b)
)
This gives::
...
...
@@ -267,7 +268,7 @@ to figure out whether a specialization is part of another set of types
long_pointer = &i
if bunch_of_types in string_t:
print
"s is a string!"
print
("s is a string!")
__signatures__
==============
...
...
docs/src/userguide/language_basics.rst
View file @
abb08286
...
...
@@ -124,6 +124,8 @@ internally to store attributes.
Here is a simple example::
from __future__ import print_function
cdef class Shrubbery:
cdef int width, height
...
...
@@ -133,8 +135,8 @@ Here is a simple example::
self.height = h
def describe(self):
print
"This shrubbery is", self.width, \
"by", self.height, "cubits."
print
("This shrubbery is", self.width,
"by", self.height, "cubits.")
You can read more about them in :ref:`extension-types`.
...
...
@@ -194,6 +196,8 @@ Grouping multiple C declarations
If you have a series of declarations that all begin with :keyword:`cdef`, you
can group them into a :keyword:`cdef` block like this::
from __future__ import print_function
cdef:
struct Spam:
int tons
...
...
@@ -203,7 +207,7 @@ can group them into a :keyword:`cdef` block like this::
Spam *p
void f(Spam *s):
print
s.tons, "Tons of spam"
print
(s.tons, "Tons of spam")
.. _cpdef:
.. _cdef:
...
...
@@ -645,7 +649,6 @@ with ``<object>``, or a more specific builtin or extension type
the object by one, i.e. the cast returns an owned reference.
Here is an example::
from __future__ import print_function
from cpython.ref cimport PyObject
from libc.stdint cimport uintptr_t
...
...
@@ -985,9 +988,11 @@ expression must evaluate to a Python value of type ``int``, ``long``,
::
from __future__ import print_function
cdef int a1[ArraySize]
cdef int a2[OtherArraySize]
print
"I like", FavouriteFood
print
("I like", FavouriteFood)
Conditional Statements
----------------------
...
...
docs/src/userguide/limitations.rst
View file @
abb08286
...
...
@@ -60,4 +60,4 @@ Identity vs. equality for inferred literals
if some_runtime_expression:
b = a # creates a new Python float object
c = a # creates a new Python float object
print
b is c
# most likely not the same object
print
(b is c)
# most likely not the same object
docs/src/userguide/sharing_declarations.rst
View file @
abb08286
...
...
@@ -101,7 +101,7 @@ uses it.
def serve():
cdef spamdish d
prepare(&d)
print
"%d oz spam, filler no. %d" % (d.oz_of_spam, d.filler
)
print
("%d oz spam, filler no. %d" % (d.oz_of_spam, d.filler)
)
It is important to understand that the :keyword:`cimport` statement can only
be used to import C data types, C functions and variables, and extension
...
...
@@ -184,11 +184,13 @@ example:
:file:`spammery.pyx`::
from __future__ import print_function
from volume cimport cube
def menu(description, size):
print
description, ":", cube(size), \
"cubic metres of spam"
print
(description, ":", cube(size),
"cubic metres of spam")
menu("Entree", 1)
menu("Main course", 3)
...
...
@@ -243,7 +245,7 @@ and another module which uses it:
cdef Shrubbing.Shrubbery sh
sh = Shrubbing.standard_shrubbery()
print
"Shrubbery size is %d x %d" % (sh.width, sh.length
)
print
("Shrubbery size is %d x %d" % (sh.width, sh.length)
)
One would then need to compile both of these modules, e.g. using
...
...
docs/src/userguide/wrapping_CPlusPlus.rst
View file @
abb08286
...
...
@@ -428,7 +428,7 @@ Cython uses a bracket syntax for templating. A simple example for wrapping C++ v
cdef vector[int].iterator it = v.begin()
while it != v.end():
print
deref(it
)
print
(deref(it)
)
inc(it)
del v
...
...
@@ -447,8 +447,8 @@ the template parameter list following the function name::
cdef extern from "<algorithm>" namespace "std":
T max[T](T a, T b)
print
max[long](3, 4
)
print
max(1.5, 2.5
) # simple template argument deduction
print
(max[long](3, 4)
)
print
(max(1.5, 2.5)
) # simple template argument deduction
Standard library
...
...
@@ -467,7 +467,7 @@ For example::
for i in range(10):
vect.push_back(i)
for i in range(10):
print
vect[i]
print
(vect[i])
The pxd files in ``/Cython/Includes/libcpp`` also work as good examples on
how to declare C++ classes.
...
...
Write
Preview
Markdown
is supported
0%
Try again
or
attach a new file
Attach a file
Cancel
You are about to add
0
people
to the discussion. Proceed with caution.
Finish editing this message first!
Cancel
Please
register
or
sign in
to comment