home *** CD-ROM | disk | FTP | other *** search
open in: 
MacOS 8.1
|
Win98
|
DOS
browse contents |
view JSON data
|
view as text
This file was processed as: LaTeX Document
(document/latex).
| Confidence | Program | Detection | Match Type | Support
|
|---|
| 100%
| dexvert
| LaTeX Document (document/latex)
| magic
| Supported |
| 1%
| dexvert
| Corel 10 Texture (image/corel10Texture)
| ext
| Unsupported |
| 1%
| dexvert
| Croteam texture file (image/croteamTextureFile)
| ext
| Unsupported |
| 1%
| dexvert
| Text File (text/txt)
| fallback
| Supported |
| 100%
| file
| LaTeX document text
| default
| |
| 99%
| file
| LaTeX document, ASCII text
| default
| |
| 100%
| checkBytes
| Printable ASCII
| default
| |
| 100%
| perlTextCheck
| Likely Text (Perl)
| default
| |
| 100%
| detectItEasy
| Format: plain text[LF]
| default (weak)
| |
| 100%
| xdgMime
| text/x-matlab
| default (weak)
|
|
hex view+--------+-------------------------+-------------------------+--------+--------+
|00000000| 25 20 43 6f 70 79 72 69 | 67 68 74 20 28 63 29 20 |% Copyri|ght (c) |
|00000010| 31 39 39 36 20 62 79 20 | 4c 65 6c 65 20 47 61 69 |1996 by |Lele Gai|
|00000020| 66 61 78 2e 20 20 41 6c | 6c 20 52 69 67 68 74 73 |fax. Al|l Rights|
|00000030| 20 52 65 73 65 72 76 65 | 64 0a 25 0a 25 20 54 68 | Reserve|d.%.% Th|
|00000040| 69 73 20 66 69 6c 65 20 | 69 73 20 70 61 72 74 20 |is file |is part |
|00000050| 6f 66 20 74 68 65 20 50 | 79 4f 62 6a 43 20 70 61 |of the P|yObjC pa|
|00000060| 63 6b 61 67 65 2e 0a 25 | 0a 25 20 24 52 43 53 66 |ckage..%|.% $RCSf|
|00000070| 69 6c 65 3a 20 6c 69 62 | 4f 62 6a 43 2e 74 65 78 |ile: lib|ObjC.tex|
|00000080| 2c 76 20 24 0a 25 20 24 | 52 65 76 69 73 69 6f 6e |,v $.% $|Revision|
|00000090| 3a 20 31 2e 31 2e 31 2e | 37 20 24 0a 25 20 24 44 |: 1.1.1.|7 $.% $D|
|000000a0| 61 74 65 3a 20 31 39 39 | 36 2f 31 31 2f 31 34 20 |ate: 199|6/11/14 |
|000000b0| 30 31 3a 35 30 3a 30 30 | 20 24 0a 25 0a 25 20 43 |01:50:00| $.%.% C|
|000000c0| 72 65 61 74 65 64 20 4d | 6f 6e 20 53 65 70 20 32 |reated M|on Sep 2|
|000000d0| 30 20 31 31 3a 34 37 3a | 33 37 20 31 39 39 36 2e |0 11:47:|37 1996.|
|000000e0| 0a 25 0a 0a 5c 73 65 63 | 74 69 6f 6e 7b 42 75 69 |.%..\sec|tion{Bui|
|000000f0| 6c 74 2d 69 6e 20 4d 6f | 64 75 6c 65 20 5c 73 65 |lt-in Mo|dule \se|
|00000100| 63 74 63 6f 64 65 7b 4f | 62 6a 43 7d 7d 0a 5c 62 |ctcode{O|bjC}}.\b|
|00000110| 69 6d 6f 64 69 6e 64 65 | 78 7b 4f 62 6a 43 7d 0a |imodinde|x{ObjC}.|
|00000120| 5c 72 65 6e 65 77 63 6f | 6d 6d 61 6e 64 7b 5c 69 |\renewco|mmand{\i|
|00000130| 6e 64 65 78 73 75 62 69 | 74 65 6d 7d 7b 28 69 6e |ndexsubi|tem}{(in|
|00000140| 20 6d 6f 64 75 6c 65 20 | 4f 62 6a 43 29 7d 0a 0a | module |ObjC)}..|
|00000150| 54 68 65 20 5c 63 6f 64 | 65 7b 4f 62 6a 43 7d 20 |The \cod|e{ObjC} |
|00000160| 6d 6f 64 75 6c 65 20 66 | 75 72 6e 69 73 68 65 73 |module f|urnishes|
|00000170| 20 74 68 65 20 66 6f 6c | 6c 6f 77 69 6e 67 20 66 | the fol|lowing f|
|00000180| 75 6e 63 74 69 6f 6e 73 | 3a 0a 0a 5c 62 65 67 69 |unctions|:..\begi|
|00000190| 6e 7b 66 75 6e 63 64 65 | 73 63 7d 7b 6d 61 6b 65 |n{funcde|sc}{make|
|000001a0| 5c 5f 70 6f 69 6e 74 65 | 72 7d 7b 69 6e 74 65 67 |\_pointe|r}{integ|
|000001b0| 65 72 2d 76 61 6c 75 65 | 7d 0a 42 75 69 6c 64 20 |er-value|}.Build |
|000001c0| 61 6e 64 20 72 65 74 75 | 72 6e 20 61 20 6e 65 77 |and retu|rn a new|
|000001d0| 20 5c 63 6f 64 65 7b 4f | 62 6a 43 50 6f 69 6e 74 | \code{O|bjCPoint|
|000001e0| 65 72 7d 20 6f 62 6a 65 | 63 74 2c 20 63 6f 6e 74 |er} obje|ct, cont|
|000001f0| 61 69 6e 69 6e 67 20 61 | 20 70 6f 69 6e 74 65 72 |aining a| pointer|
|00000200| 0a 74 6f 20 76 6f 69 64 | 20 77 69 74 68 20 76 61 |.to void| with va|
|00000210| 6c 75 65 20 5c 76 61 72 | 7b 69 6e 74 65 67 65 72 |lue \var|{integer|
|00000220| 2d 76 61 6c 75 65 7d 2e | 20 5c 65 6d 70 68 7b 59 |-value}.| \emph{Y|
|00000230| 6f 75 20 6d 75 73 74 20 | 6b 6e 6f 77 20 77 68 61 |ou must |know wha|
|00000240| 74 20 79 6f 75 0a 61 72 | 65 20 64 6f 69 6e 67 7d |t you.ar|e doing}|
|00000250| 2c 20 73 69 6e 63 65 20 | 6d 69 73 75 73 69 6e 67 |, since |misusing|
|00000260| 20 73 75 63 68 20 6f 62 | 6a 65 63 74 73 20 6d 61 | such ob|jects ma|
|00000270| 79 20 63 72 61 73 68 20 | 79 6f 75 72 0a 61 70 70 |y crash |your.app|
|00000280| 6c 69 63 61 74 69 6f 6e | 2e 0a 54 68 69 73 20 6d |lication|..This m|
|00000290| 65 74 68 6f 64 20 73 68 | 6f 75 6c 64 20 62 65 20 |ethod sh|ould be |
|000002a0| 75 73 65 64 20 77 68 65 | 6e 20 61 20 70 6f 69 6e |used whe|n a poin|
|000002b0| 74 65 72 20 61 72 67 75 | 6d 65 6e 74 20 69 73 20 |ter argu|ment is |
|000002c0| 75 73 65 64 20 61 73 20 | 73 6f 6d 65 0a 73 6f 72 |used as |some.sor|
|000002d0| 74 20 6f 66 20 61 20 66 | 6c 61 67 20 66 72 6f 6d |t of a f|lag from|
|000002e0| 20 74 68 65 20 4f 62 6a | 65 63 74 69 76 65 2d 43 | the Obj|ective-C|
|000002f0| 20 6d 65 74 68 6f 64 2e | 0a 5c 65 6e 64 7b 66 75 | method.|.\end{fu|
|00000300| 6e 63 64 65 73 63 7d 0a | 0a 5c 62 65 67 69 6e 7b |ncdesc}.|.\begin{|
|00000310| 66 75 6e 63 64 65 73 63 | 7d 7b 6c 69 73 74 5c 5f |funcdesc|}{list\_|
|00000320| 63 6c 61 73 73 65 73 7d | 7b 7d 0a 42 75 69 6c 64 |classes}|{}.Build|
|00000330| 20 61 6e 64 20 72 65 74 | 75 72 6e 20 74 68 65 20 | and ret|urn the |
|00000340| 6c 69 73 74 20 6f 66 20 | 61 76 61 69 6c 61 62 6c |list of |availabl|
|00000350| 65 20 4f 62 6a 65 63 74 | 69 76 65 2d 43 20 63 6c |e Object|ive-C cl|
|00000360| 61 73 73 65 73 20 62 79 | 20 71 75 65 72 69 6e 67 |asses by| quering|
|00000370| 0a 69 74 73 20 72 75 6e | 74 69 6d 65 2e 0a 5c 65 |.its run|time..\e|
|00000380| 6e 64 7b 66 75 6e 63 64 | 65 73 63 7d 0a 0a 5c 62 |nd{funcd|esc}..\b|
|00000390| 65 67 69 6e 7b 66 75 6e | 63 64 65 73 63 7d 7b 6c |egin{fun|cdesc}{l|
|000003a0| 6f 61 64 5c 5f 6f 62 6a | 65 63 74 5c 5f 66 69 6c |oad\_obj|ect\_fil|
|000003b0| 65 73 7d 7b 6c 69 73 74 | 5c 5f 6f 66 5c 5f 6f 62 |es}{list|\_of\_ob|
|000003c0| 6a 65 63 74 5c 5f 66 69 | 6c 65 6e 61 6d 65 73 7d |ject\_fi|lenames}|
|000003d0| 0a 54 72 79 20 74 6f 20 | 64 79 6e 61 6d 69 63 61 |.Try to |dynamica|
|000003e0| 6c 6c 79 20 6c 6f 61 64 | 20 65 61 63 68 20 6f 62 |lly load| each ob|
|000003f0| 6a 65 63 74 20 66 69 6c | 65 20 69 6e 0a 5c 76 61 |ject fil|e in.\va|
|00000400| 72 7b 6c 69 73 74 5c 5f | 6f 66 5c 5f 6f 62 6a 65 |r{list\_|of\_obje|
|00000410| 63 74 5c 5f 66 69 6c 65 | 6e 61 6d 65 73 7d 2e 20 |ct\_file|names}. |
|00000420| 54 68 65 79 20 6d 61 79 | 20 61 63 74 75 61 6c 6c |They may| actuall|
|00000430| 79 20 62 65 20 6f 62 6a | 65 63 74 20 66 69 6c 65 |y be obj|ect file|
|00000440| 73 2c 20 6f 72 0a 6c 69 | 62 72 61 72 69 65 73 20 |s, or.li|braries |
|00000450| 6f 66 20 73 75 63 68 20 | 66 69 6c 65 73 2e 0a 5c |of such |files..\|
|00000460| 65 6e 64 7b 66 75 6e 63 | 64 65 73 63 7d 0a 0a 5c |end{func|desc}..\|
|00000470| 62 65 67 69 6e 7b 66 75 | 6e 63 64 65 73 63 7d 7b |begin{fu|ncdesc}{|
|00000480| 6c 6f 6f 6b 75 70 5c 5f | 63 6c 61 73 73 7d 7b 6f |lookup\_|class}{o|
|00000490| 62 6a 63 5c 5f 63 6c 61 | 73 73 5c 5f 6e 61 6d 65 |bjc\_cla|ss\_name|
|000004a0| 7d 0a 4c 6f 63 61 74 65 | 20 74 68 65 20 67 69 76 |}.Locate| the giv|
|000004b0| 65 6e 20 4f 62 6a 65 63 | 74 69 76 65 2d 43 20 5c |en Objec|tive-C \|
|000004c0| 76 61 72 7b 6f 62 6a 63 | 5c 5f 63 6c 61 73 73 5c |var{objc|\_class\|
|000004d0| 5f 6e 61 6d 65 7d 2c 20 | 61 6e 64 20 69 66 20 6b |_name}, |and if k|
|000004e0| 6e 6f 77 6e 20 74 6f 0a | 74 68 65 20 72 75 6e 74 |nown to.|the runt|
|000004f0| 69 6d 65 20 72 65 74 75 | 72 6e 20 61 20 4f 62 6a |ime retu|rn a Obj|
|00000500| 43 4f 62 6a 65 63 74 20 | 77 72 61 70 70 65 72 20 |CObject |wrapper |
|00000510| 61 72 6f 75 6e 64 20 69 | 74 2e 0a 5c 65 6e 64 7b |around i|t..\end{|
|00000520| 66 75 6e 63 64 65 73 63 | 7d 0a 0a 41 6e 20 61 6c |funcdesc|}..An al|
|00000530| 74 65 72 6e 61 74 69 76 | 65 2c 20 61 6e 64 20 6d |ternativ|e, and m|
|00000540| 61 79 62 65 20 63 6c 65 | 61 6e 65 72 2c 20 77 61 |aybe cle|aner, wa|
|00000550| 79 20 74 6f 20 61 63 63 | 65 73 73 20 74 6f 20 74 |y to acc|ess to t|
|00000560| 68 65 20 4f 62 6a 65 63 | 74 69 76 65 2d 43 0a 63 |he Objec|tive-C.c|
|00000570| 6c 61 73 73 65 73 20 69 | 73 20 62 79 20 75 73 69 |lasses i|s by usi|
|00000580| 6e 67 20 74 68 65 20 5c | 76 61 72 7b 2e 72 75 6e |ng the \|var{.run|
|00000590| 74 69 6d 65 7d 20 6d 65 | 6d 62 65 72 20 6f 66 20 |time} me|mber of |
|000005a0| 74 68 65 20 6d 6f 64 75 | 6c 65 2e 0a 0a 5c 62 65 |the modu|le...\be|
|000005b0| 67 69 6e 7b 64 61 74 61 | 64 65 73 63 7d 7b 72 75 |gin{data|desc}{ru|
|000005c0| 6e 74 69 6d 65 7d 0a 54 | 68 69 73 20 6d 65 6d 62 |ntime}.T|his memb|
|000005d0| 65 72 20 69 73 20 61 20 | 4f 62 6a 43 52 75 6e 74 |er is a |ObjCRunt|
|000005e0| 69 6d 65 20 6f 62 6a 65 | 63 74 20 74 68 61 74 20 |ime obje|ct that |
|000005f0| 77 72 61 70 73 20 74 68 | 65 20 4f 62 6a 65 63 74 |wraps th|e Object|
|00000600| 69 76 65 2d 43 20 72 75 | 6e 74 69 6d 65 0a 69 6e |ive-C ru|ntime.in|
|00000610| 20 73 75 63 68 20 61 20 | 77 61 79 20 74 68 61 74 | such a |way that|
|00000620| 20 74 6f 20 72 65 71 75 | 65 73 74 20 61 20 70 61 | to requ|est a pa|
|00000630| 72 74 69 63 75 6c 61 72 | 20 63 6c 61 73 73 20 79 |rticular| class y|
|00000640| 6f 75 20 73 69 6d 70 6c | 79 20 61 73 6b 20 69 74 |ou simpl|y ask it|
|00000650| 20 61 73 0a 61 20 6d 65 | 6d 62 65 72 20 69 6e 20 | as.a me|mber in |
|00000660| 74 68 69 73 20 77 61 79 | 3a 0a 0a 5c 62 65 67 69 |this way|:..\begi|
|00000670| 6e 7b 76 65 72 62 61 74 | 69 6d 7d 0a 3e 3e 3e 20 |n{verbat|im}.>>> |
|00000680| 69 6d 70 6f 72 74 20 4f | 62 6a 43 0a 3e 3e 3e 20 |import O|bjC.>>> |
|00000690| 4f 62 6a 65 63 74 20 3d | 20 4f 62 6a 43 2e 72 75 |Object =| ObjC.ru|
|000006a0| 6e 74 69 6d 65 2e 4f 62 | 6a 65 63 74 0a 5c 65 6e |ntime.Ob|ject.\en|
|000006b0| 64 7b 76 65 72 62 61 74 | 69 6d 7d 0a 5c 65 6e 64 |d{verbat|im}.\end|
|000006c0| 7b 64 61 74 61 64 65 73 | 63 7d 0a 0a 54 68 65 20 |{datades|c}..The |
|000006d0| 6d 6f 64 75 6c 65 20 70 | 72 6f 76 69 64 65 73 20 |module p|rovides |
|000006e0| 74 68 65 20 66 6f 6c 6c | 6f 77 69 6e 67 20 6f 74 |the foll|owing ot|
|000006f0| 68 65 72 73 20 64 61 74 | 61 20 6d 65 6d 62 65 72 |hers dat|a member|
|00000700| 73 3a 0a 0a 5c 62 65 67 | 69 6e 7b 64 61 74 61 64 |s:..\beg|in{datad|
|00000710| 65 73 63 7d 7b 73 74 72 | 65 61 6d 73 7d 0a 54 68 |esc}{str|eams}.Th|
|00000720| 69 73 20 69 73 20 74 68 | 65 20 61 75 74 6f 6d 61 |is is th|e automa|
|00000730| 74 69 63 61 6c 6c 79 20 | 69 6d 70 6f 72 74 65 64 |tically |imported|
|00000740| 20 4f 62 6a 43 53 74 72 | 65 61 6d 73 20 6d 6f 64 | ObjCStr|eams mod|
|00000750| 75 6c 65 2e 0a 5c 65 6e | 64 7b 64 61 74 61 64 65 |ule..\en|d{datade|
|00000760| 73 63 7d 0a 0a 5c 62 65 | 67 69 6e 7b 65 78 63 64 |sc}..\be|gin{excd|
|00000770| 65 73 63 7d 7b 65 72 72 | 6f 72 7d 0a 54 68 69 73 |esc}{err|or}.This|
|00000780| 20 69 73 20 74 68 65 20 | 65 78 63 65 70 74 69 6f | is the |exceptio|
|00000790| 6e 20 74 68 61 74 20 67 | 65 74 73 20 72 61 69 73 |n that g|ets rais|
|000007a0| 65 64 20 75 70 6f 6e 20 | 6f 70 65 72 61 74 69 6f |ed upon |operatio|
|000007b0| 6e 20 66 61 69 6c 75 72 | 65 2c 20 73 75 63 68 20 |n failur|e, such |
|000007c0| 61 73 0a 69 6e 76 61 6c | 69 64 20 61 72 67 75 6d |as.inval|id argum|
|000007d0| 65 6e 74 73 2c 20 75 6e | 6b 6e 6f 77 6e 20 73 65 |ents, un|known se|
|000007e0| 6c 65 63 74 6f 72 73 20 | 61 6e 64 20 73 6f 20 6f |lectors |and so o|
|000007f0| 6e 2e 20 54 68 65 20 65 | 78 63 65 70 74 69 6f 6e |n. The e|xception|
|00000800| 20 61 72 67 75 6d 65 6e | 74 0a 69 73 20 61 20 73 | argumen|t.is a s|
|00000810| 74 72 69 6e 67 20 64 65 | 73 63 72 69 62 69 6e 67 |tring de|scribing|
|00000820| 20 74 68 65 20 72 65 61 | 73 6f 6e 20 6f 66 20 74 | the rea|son of t|
|00000830| 68 65 20 66 61 69 6c 75 | 72 65 2e 0a 5c 65 6e 64 |he failu|re..\end|
|00000840| 7b 65 78 63 64 65 73 63 | 7d 0a 0a 5c 62 65 67 69 |{excdesc|}..\begi|
|00000850| 6e 7b 64 61 74 61 64 65 | 73 63 7d 7b 5f 5f 76 65 |n{datade|sc}{__ve|
|00000860| 72 73 69 6f 6e 5f 5f 7d | 0a 54 68 65 20 76 65 72 |rsion__}|.The ver|
|00000870| 73 69 6f 6e 20 6f 66 20 | 74 68 65 20 6d 6f 64 75 |sion of |the modu|
|00000880| 6c 65 2c 20 61 73 20 61 | 20 66 6c 6f 61 74 69 6e |le, as a| floatin|
|00000890| 67 20 70 6f 69 6e 74 20 | 6e 75 6d 62 65 72 2e 20 |g point |number. |
|000008a0| 54 68 69 73 20 6d 61 6e | 75 61 6c 0a 64 6f 63 75 |This man|ual.docu|
|000008b0| 6d 65 6e 74 73 20 76 65 | 72 73 69 6f 6e 20 30 2e |ments ve|rsion 0.|
|000008c0| 34 37 2e 20 25 20 58 58 | 58 20 75 70 64 61 74 65 |47. % XX|X update|
|000008d0| 20 74 68 69 73 20 62 65 | 66 6f 72 65 20 72 65 6c | this be|fore rel|
|000008e0| 65 61 73 65 2e 0a 5c 65 | 6e 64 7b 64 61 74 61 64 |ease..\e|nd{datad|
|000008f0| 65 73 63 7d 0a 0a 5c 73 | 75 62 73 65 63 74 69 6f |esc}..\s|ubsectio|
|00000900| 6e 7b 4f 62 6a 43 52 75 | 6e 74 69 6d 65 20 6f 62 |n{ObjCRu|ntime ob|
|00000910| 6a 65 63 74 73 7d 0a 5c | 72 65 6e 65 77 63 6f 6d |jects}.\|renewcom|
|00000920| 6d 61 6e 64 7b 5c 69 6e | 64 65 78 73 75 62 69 74 |mand{\in|dexsubit|
|00000930| 65 6d 7d 7b 28 4f 62 6a | 43 52 75 6e 74 69 6d 65 |em}{(Obj|CRuntime|
|00000940| 20 6d 65 74 68 6f 64 29 | 7d 0a 0a 54 68 69 73 20 | method)|}..This |
|00000950| 6f 62 6a 65 63 74 20 72 | 65 73 70 6f 6e 64 73 20 |object r|esponds |
|00000960| 74 6f 20 74 68 65 73 65 | 20 6d 65 74 68 6f 64 73 |to these| methods|
|00000970| 3a 0a 0a 5c 62 65 67 69 | 6e 7b 66 75 6e 63 64 65 |:..\begi|n{funcde|
|00000980| 73 63 7d 7b 6c 6f 61 64 | 5c 5f 6f 62 6a 65 63 74 |sc}{load|\_object|
|00000990| 5c 5f 66 69 6c 65 73 7d | 7b 6c 69 73 74 5c 5f 6f |\_files}|{list\_o|
|000009a0| 66 5c 5f 6f 62 6a 65 63 | 74 5c 5f 66 69 6c 65 6e |f\_objec|t\_filen|
|000009b0| 61 6d 65 73 7d 0a 54 72 | 79 20 74 6f 20 64 79 6e |ames}.Tr|y to dyn|
|000009c0| 61 6d 69 63 61 6c 6c 79 | 20 6c 6f 61 64 20 65 61 |amically| load ea|
|000009d0| 63 68 20 6f 62 6a 65 63 | 74 20 66 69 6c 65 20 69 |ch objec|t file i|
|000009e0| 6e 0a 5c 76 61 72 7b 6c | 69 73 74 5c 5f 6f 66 5c |n.\var{l|ist\_of\|
|000009f0| 5f 6f 62 6a 65 63 74 5c | 5f 66 69 6c 65 6e 61 6d |_object\|_filenam|
|00000a00| 65 73 7d 2e 20 54 68 65 | 79 20 6d 61 79 20 61 63 |es}. The|y may ac|
|00000a10| 74 75 61 6c 6c 79 20 62 | 65 20 6f 62 6a 65 63 74 |tually b|e object|
|00000a20| 20 66 69 6c 65 73 2c 20 | 6f 72 0a 6c 69 62 72 61 | files, |or.libra|
|00000a30| 72 69 65 73 20 6f 66 20 | 73 75 63 68 20 66 69 6c |ries of |such fil|
|00000a40| 65 73 2e 20 41 20 5c 63 | 6f 64 65 7b 4f 62 6a 43 |es. A \c|ode{ObjC|
|00000a50| 2e 65 72 72 6f 72 7d 20 | 65 78 63 65 70 74 69 6f |.error} |exceptio|
|00000a60| 6e 20 69 73 20 72 61 69 | 73 65 64 20 6f 6e 20 66 |n is rai|sed on f|
|00000a70| 61 69 6c 75 72 65 2e 0a | 5c 65 6e 64 7b 66 75 6e |ailure..|\end{fun|
|00000a80| 63 64 65 73 63 7d 0a 0a | 5c 62 65 67 69 6e 7b 66 |cdesc}..|\begin{f|
|00000a90| 75 6e 63 64 65 73 63 7d | 7b 6c 6f 6f 6b 75 70 5c |uncdesc}|{lookup\|
|00000aa0| 5f 63 6c 61 73 73 7d 7b | 6f 62 6a 63 5c 5f 63 6c |_class}{|objc\_cl|
|00000ab0| 61 73 73 5c 5f 6e 61 6d | 65 7d 0a 4c 6f 63 61 74 |ass\_nam|e}.Locat|
|00000ac0| 65 20 74 68 65 20 67 69 | 76 65 6e 20 4f 62 6a 65 |e the gi|ven Obje|
|00000ad0| 63 74 69 76 65 2d 43 20 | 5c 76 61 72 7b 6f 62 6a |ctive-C |\var{obj|
|00000ae0| 63 5c 5f 63 6c 61 73 73 | 5c 5f 6e 61 6d 65 7d 2c |c\_class|\_name},|
|00000af0| 20 61 6e 64 20 69 66 20 | 6b 6e 6f 77 6e 20 74 6f | and if |known to|
|00000b00| 0a 74 68 65 20 72 75 6e | 74 69 6d 65 20 72 65 74 |.the run|time ret|
|00000b10| 75 72 6e 20 61 20 4f 62 | 6a 43 4f 62 6a 65 63 74 |urn a Ob|jCObject|
|00000b20| 20 77 72 61 70 70 65 72 | 20 61 72 6f 75 6e 64 20 | wrapper| around |
|00000b30| 69 74 2e 20 54 68 69 73 | 20 73 68 6f 75 6c 64 20 |it. This| should |
|00000b40| 62 65 0a 73 75 70 65 72 | 63 65 64 65 64 20 62 79 |be.super|ceded by|
|00000b50| 20 60 60 2e 5c 5f 5c 5f | 64 69 63 74 5c 5f 5c 5f | ``.\_\_|dict\_\_|
|00000b60| 2e 6b 65 79 73 28 29 27 | 27 2e 20 41 20 5c 63 6f |.keys()'|'. A \co|
|00000b70| 64 65 7b 4f 62 6a 43 2e | 65 72 72 6f 72 7d 20 65 |de{ObjC.|error} e|
|00000b80| 78 63 65 70 74 69 6f 6e | 0a 69 73 20 72 61 69 73 |xception|.is rais|
|00000b90| 65 64 20 69 66 20 74 68 | 65 20 63 6c 61 73 73 20 |ed if th|e class |
|00000ba0| 64 6f 65 73 20 6e 6f 74 | 20 65 78 69 73 74 2e 0a |does not| exist..|
|00000bb0| 5c 65 6e 64 7b 66 75 6e | 63 64 65 73 63 7d 0a 0a |\end{fun|cdesc}..|
|00000bc0| 49 6e 20 65 76 65 72 79 | 20 61 73 70 65 63 74 73 |In every| aspects|
|00000bd0| 2c 20 74 68 65 73 65 20 | 74 77 6f 20 66 75 6e 63 |, these |two func|
|00000be0| 74 69 6f 6e 73 20 61 72 | 65 20 6d 65 72 65 6c 79 |tions ar|e merely|
|00000bf0| 20 61 6c 69 61 73 65 73 | 20 6f 66 20 74 68 65 0a | aliases| of the.|
|00000c00| 6d 6f 64 75 6c 65 27 73 | 20 66 75 6e 63 74 69 6f |module's| functio|
|00000c10| 6e 73 20 77 69 74 68 20 | 74 68 65 20 73 61 6d 65 |ns with |the same|
|00000c20| 20 6e 61 6d 65 2e 0a 0a | 5c 62 65 67 69 6e 7b 66 | name...|\begin{f|
|00000c30| 75 6e 63 64 65 73 63 7d | 7b 73 65 6c 5c 5f 69 73 |uncdesc}|{sel\_is|
|00000c40| 5c 5f 6d 61 70 70 65 64 | 7d 7b 73 65 6c 65 63 74 |\_mapped|}{select|
|00000c50| 6f 72 4e 61 6d 65 7d 0a | 52 65 74 75 72 6e 73 20 |orName}.|Returns |
|00000c60| 5c 63 6f 64 65 7b 54 72 | 75 65 7d 20 69 66 20 74 |\code{Tr|ue} if t|
|00000c70| 68 65 20 73 65 6c 65 63 | 74 6f 72 20 5c 76 61 72 |he selec|tor \var|
|00000c80| 7b 73 65 6c 65 63 74 6f | 72 4e 61 6d 65 7d 20 69 |{selecto|rName} i|
|00000c90| 73 20 6b 6e 6f 77 6e 20 | 74 6f 20 74 68 65 0a 72 |s known |to the.r|
|00000ca0| 75 6e 74 69 6d 65 2c 20 | 5c 63 6f 64 65 7b 46 61 |untime, |\code{Fa|
|00000cb0| 6c 73 65 7d 20 6f 74 68 | 65 72 77 69 73 65 2e 0a |lse} oth|erwise..|
|00000cc0| 5c 65 6e 64 7b 66 75 6e | 63 64 65 73 63 7d 0a 0a |\end{fun|cdesc}..|
|00000cd0| 54 68 69 73 20 6f 62 6a | 65 63 74 20 63 61 72 72 |This obj|ect carr|
|00000ce0| 69 65 73 20 74 68 65 20 | 66 6f 6c 6c 6f 77 69 6e |ies the |followin|
|00000cf0| 67 20 64 61 74 61 20 6d | 65 6d 62 65 72 73 3a 0a |g data m|embers:.|
|00000d00| 0a 5c 62 65 67 69 6e 7b | 64 61 74 61 64 65 73 63 |.\begin{|datadesc|
|00000d10| 7d 7b 6b 69 6e 64 7d 0a | 54 68 69 73 20 74 65 6c |}{kind}.|This tel|
|00000d20| 6c 73 20 79 6f 75 20 66 | 6f 72 20 77 68 69 63 68 |ls you f|or which|
|00000d30| 20 72 75 6e 74 69 6d 65 | 20 74 68 65 20 6d 6f 64 | runtime| the mod|
|00000d40| 75 6c 65 20 77 61 73 20 | 63 6f 6d 70 69 6c 65 64 |ule was |compiled|
|00000d50| 20 66 6f 72 2c 20 74 68 | 61 74 20 6d 61 79 0a 62 | for, th|at may.b|
|00000d60| 65 20 60 60 4e 65 58 54 | 27 27 20 69 66 20 69 74 |e ``NeXT|'' if it|
|00000d70| 20 69 73 20 75 73 69 6e | 67 20 74 68 65 20 6e 61 | is usin|g the na|
|00000d80| 74 69 76 65 20 4e 65 58 | 54 27 73 20 72 75 6e 74 |tive NeX|T's runt|
|00000d90| 69 6d 65 2c 20 6f 72 20 | 60 60 47 4e 55 27 27 20 |ime, or |``GNU'' |
|00000da0| 77 68 65 6e 0a 75 73 69 | 6e 67 20 74 68 65 20 47 |when.usi|ng the G|
|00000db0| 4e 55 20 4f 62 6a 65 63 | 74 69 76 65 2d 43 20 72 |NU Objec|tive-C r|
|00000dc0| 75 6e 74 69 6d 65 20 64 | 69 73 74 72 69 62 75 69 |untime d|istribui|
|00000dd0| 74 65 64 20 77 69 74 68 | 20 47 4e 55 20 47 43 43 |ted with| GNU GCC|
|00000de0| 2e 0a 5c 65 6e 64 7b 64 | 61 74 61 64 65 73 63 7d |..\end{d|atadesc}|
|00000df0| 0a 0a 5c 62 65 67 69 6e | 7b 64 61 74 61 64 65 73 |..\begin|{datades|
|00000e00| 63 7d 7b 5f 5f 64 69 63 | 74 5f 5f 7d 0a 54 68 69 |c}{__dic|t__}.Thi|
|00000e10| 73 20 69 73 20 61 20 64 | 69 63 74 69 6f 6e 61 72 |s is a d|ictionar|
|00000e20| 79 20 6f 66 20 61 6c 6c | 20 6b 6e 6f 77 6e 20 63 |y of all| known c|
|00000e30| 6c 61 73 73 65 73 2e 0a | 5c 65 6e 64 7b 64 61 74 |lasses..|\end{dat|
|00000e40| 61 64 65 73 63 7d 0a 0a | 5c 62 65 67 69 6e 7b 64 |adesc}..|\begin{d|
|00000e50| 61 74 61 64 65 73 63 7d | 7b 5f 5f 6d 65 6d 62 65 |atadesc}|{__membe|
|00000e60| 72 73 5f 5f 7d 0a 54 68 | 65 20 6c 69 73 74 20 6f |rs__}.Th|e list o|
|00000e70| 66 20 64 61 74 61 20 6d | 65 6d 62 65 72 73 20 6f |f data m|embers o|
|00000e80| 66 20 74 68 69 73 20 6f | 62 6a 65 63 74 2e 0a 5c |f this o|bject..\|
|00000e90| 65 6e 64 7b 64 61 74 61 | 64 65 73 63 7d 0a 0a 62 |end{data|desc}..b|
|00000ea0| 75 74 20 79 6f 75 20 63 | 61 6e 20 61 73 6b 20 66 |ut you c|an ask f|
|00000eb0| 6f 72 20 61 6e 20 4f 62 | 6a 65 63 74 69 76 65 2d |or an Ob|jective-|
|00000ec0| 43 20 63 6c 61 73 73 20 | 75 73 69 6e 67 20 74 68 |C class |using th|
|00000ed0| 65 20 5c 63 6f 64 65 7b | 67 65 74 61 74 74 72 28 |e \code{|getattr(|
|00000ee0| 29 7d 0a 66 75 6e 63 74 | 69 6f 6e 20 6f 72 20 77 |)}.funct|ion or w|
|00000ef0| 69 74 68 20 74 68 65 20 | 60 60 2e 43 6c 61 73 73 |ith the |``.Class|
|00000f00| 4e 61 6d 65 27 27 20 73 | 79 6e 74 61 78 20 74 6f |Name'' s|yntax to|
|00000f10| 6f 2e 0a 0a 0a 5c 73 75 | 62 73 65 63 74 69 6f 6e |o....\su|bsection|
|00000f20| 7b 4f 62 6a 43 4f 62 6a | 65 63 74 20 6f 62 6a 65 |{ObjCObj|ect obje|
|00000f30| 63 74 73 7d 0a 5c 72 65 | 6e 65 77 63 6f 6d 6d 61 |cts}.\re|newcomma|
|00000f40| 6e 64 7b 5c 69 6e 64 65 | 78 73 75 62 69 74 65 6d |nd{\inde|xsubitem|
|00000f50| 7d 7b 28 4f 62 6a 43 4f | 62 6a 65 63 74 20 6d 65 |}{(ObjCO|bject me|
|00000f60| 74 68 6f 64 29 7d 0a 0a | 46 72 6f 6d 20 74 68 65 |thod)}..|From the|
|00000f70| 20 50 79 74 68 6f 6e 20 | 70 6f 69 6e 74 20 6f 66 | Python |point of|
|00000f80| 20 76 69 65 77 2c 20 79 | 6f 75 20 61 63 63 65 73 | view, y|ou acces|
|00000f90| 73 20 4f 62 6a 65 63 74 | 69 76 65 2d 43 20 6f 62 |s Object|ive-C ob|
|00000fa0| 6a 65 63 74 73 20 28 62 | 6f 74 68 0a 63 6c 61 73 |jects (b|oth.clas|
|00000fb0| 73 65 73 20 61 6e 64 20 | 69 6e 73 74 61 6e 63 65 |ses and |instance|
|00000fc0| 73 29 20 75 73 69 6e 67 | 20 61 20 50 79 74 68 6f |s) using| a Pytho|
|00000fd0| 6e 20 77 72 61 70 70 65 | 72 20 61 72 6f 75 6e 64 |n wrappe|r around|
|00000fe0| 20 74 68 65 6d 2c 0a 4f | 62 6a 43 4f 62 6a 65 63 | them,.O|bjCObjec|
|00000ff0| 74 2e 20 49 74 20 69 73 | 20 72 65 73 70 6f 6e 73 |t. It is| respons|
|00001000| 69 62 6c 65 20 6f 66 20 | 66 6f 72 77 61 72 64 69 |ible of |forwardi|
|00001010| 6e 67 20 61 6e 79 20 75 | 6e 6b 6e 6f 77 6e 20 6d |ng any u|nknown m|
|00001020| 65 74 68 6f 64 20 79 6f | 75 0a 65 78 65 63 75 74 |ethod yo|u.execut|
|00001030| 65 20 6f 6e 20 69 74 20 | 74 6f 20 74 68 65 20 4f |e on it |to the O|
|00001040| 62 6a 65 63 74 69 76 65 | 2d 43 20 6f 62 6a 65 63 |bjective|-C objec|
|00001050| 74 20 69 74 20 69 73 20 | 63 61 72 72 79 69 6e 67 |t it is |carrying|
|00001060| 2e 0a 0a 4f 62 6a 43 4f | 62 6a 65 63 74 20 6f 62 |...ObjCO|bject ob|
|00001070| 6a 65 63 74 73 20 68 61 | 76 65 20 74 68 65 20 66 |jects ha|ve the f|
|00001080| 6f 6c 6c 6f 77 69 6e 67 | 20 6d 65 74 68 6f 64 73 |ollowing| methods|
|00001090| 2e 0a 0a 5c 62 65 67 69 | 6e 7b 66 75 6e 63 64 65 |...\begi|n{funcde|
|000010a0| 73 63 7d 7b 69 73 43 6c | 61 73 73 7d 7b 7d 0a 52 |sc}{isCl|ass}{}.R|
|000010b0| 65 74 75 72 6e 20 5c 76 | 61 72 7b 54 72 75 65 7d |eturn \v|ar{True}|
|000010c0| 20 69 66 20 74 68 65 20 | 65 6e 63 6c 6f 73 65 64 | if the |enclosed|
|000010d0| 20 4f 62 6a 65 63 74 69 | 76 65 2d 43 20 6f 62 6a | Objecti|ve-C obj|
|000010e0| 65 63 74 20 69 73 20 61 | 63 74 75 61 6c 6c 79 20 |ect is a|ctually |
|000010f0| 61 0a 63 6c 61 73 73 2c | 20 5c 76 61 72 7b 46 61 |a.class,| \var{Fa|
|00001100| 6c 73 65 7d 20 6f 74 68 | 65 72 77 69 73 65 2e 0a |lse} oth|erwise..|
|00001110| 5c 65 6e 64 7b 66 75 6e | 63 64 65 73 63 7d 0a 0a |\end{fun|cdesc}..|
|00001120| 5c 62 65 67 69 6e 7b 66 | 75 6e 63 64 65 73 63 7d |\begin{f|uncdesc}|
|00001130| 7b 69 73 49 6e 73 74 61 | 6e 63 65 7d 7b 7d 0a 52 |{isInsta|nce}{}.R|
|00001140| 65 74 75 72 6e 20 5c 76 | 61 72 7b 54 72 75 65 7d |eturn \v|ar{True}|
|00001150| 20 69 66 20 74 68 65 20 | 65 6e 63 6c 6f 73 65 64 | if the |enclosed|
|00001160| 20 4f 62 6a 65 63 74 69 | 76 65 2d 43 20 6f 62 6a | Objecti|ve-C obj|
|00001170| 65 63 74 20 69 73 20 61 | 63 74 75 61 6c 6c 79 20 |ect is a|ctually |
|00001180| 61 6e 0a 69 6e 73 74 61 | 6e 63 65 2c 20 5c 76 61 |an.insta|nce, \va|
|00001190| 72 7b 46 61 6c 73 65 7d | 20 6f 74 68 65 72 77 69 |r{False}| otherwi|
|000011a0| 73 65 2e 0a 5c 65 6e 64 | 7b 66 75 6e 63 64 65 73 |se..\end|{funcdes|
|000011b0| 63 7d 0a 0a 5c 62 65 67 | 69 6e 7b 66 75 6e 63 64 |c}..\beg|in{funcd|
|000011c0| 65 73 63 7d 7b 43 6c 61 | 73 73 7d 7b 7d 0a 53 69 |esc}{Cla|ss}{}.Si|
|000011d0| 6e 63 65 20 74 68 65 20 | 77 6f 72 64 20 60 60 63 |nce the |word ``c|
|000011e0| 6c 61 73 73 27 27 20 69 | 73 20 61 20 72 65 73 65 |lass'' i|s a rese|
|000011f0| 72 76 65 64 20 6b 65 79 | 77 6f 72 64 20 69 6e 20 |rved key|word in |
|00001200| 50 79 74 68 6f 6e 20 61 | 6e 64 20 63 61 6e 6e 6f |Python a|nd canno|
|00001210| 74 20 62 65 0a 75 73 65 | 64 20 61 73 20 61 20 6d |t be.use|d as a m|
|00001220| 65 74 68 6f 64 20 6e 61 | 6d 65 2c 20 74 68 69 73 |ethod na|me, this|
|00001230| 20 66 75 6e 63 74 69 6f | 6e 20 72 65 74 75 72 6e | functio|n return|
|00001240| 73 20 74 68 65 20 65 71 | 75 69 76 61 6c 65 6e 74 |s the eq|uivalent|
|00001250| 20 6f 66 20 74 68 65 0a | 4f 62 6a 65 63 74 69 76 | of the.|Objectiv|
|00001260| 65 2d 43 20 65 78 70 72 | 65 73 73 69 6f 6e 20 60 |e-C expr|ession `|
|00001270| 60 5b 6f 62 6a 20 63 6c | 61 73 73 5d 27 27 2e 0a |`[obj cl|ass]''..|
|00001280| 5c 65 6e 64 7b 66 75 6e | 63 64 65 73 63 7d 0a 0a |\end{fun|cdesc}..|
|00001290| 0a 54 6f 20 73 65 6e 64 | 20 61 20 6d 65 73 73 61 |.To send| a messa|
|000012a0| 67 65 20 74 6f 20 61 6e | 20 4f 62 6a 65 63 74 69 |ge to an| Objecti|
|000012b0| 76 65 2d 43 20 6f 62 6a | 65 63 74 20 79 6f 75 20 |ve-C obj|ect you |
|000012c0| 75 73 65 20 74 68 65 20 | 73 61 6d 65 20 73 79 6e |use the |same syn|
|000012d0| 74 61 78 20 61 73 0a 66 | 6f 72 20 61 6e 79 20 6f |tax as.f|or any o|
|000012e0| 74 68 65 72 20 50 79 74 | 68 6f 6e 20 6f 62 6a 65 |ther Pyt|hon obje|
|000012f0| 63 74 3a 0a 0a 5c 62 65 | 67 69 6e 7b 76 65 72 62 |ct:..\be|gin{verb|
|00001300| 61 74 69 6d 7d 0a 3e 3e | 3e 20 69 6d 70 6f 72 74 |atim}.>>|> import|
|00001310| 20 4f 62 6a 43 0a 3e 3e | 3e 20 4c 69 73 74 20 3d | ObjC.>>|> List =|
|00001320| 20 4f 62 6a 43 2e 72 75 | 6e 74 69 6d 65 2e 4c 69 | ObjC.ru|ntime.Li|
|00001330| 73 74 0a 3e 3e 3e 20 6c | 69 73 74 20 3d 20 4c 69 |st.>>> l|ist = Li|
|00001340| 73 74 28 29 0a 3e 3e 3e | 20 4f 62 6a 65 63 74 20 |st().>>>| Object |
|00001350| 3d 20 4f 62 6a 43 2e 72 | 75 6e 74 69 6d 65 2e 4f |= ObjC.r|untime.O|
|00001360| 62 6a 65 63 74 0a 3e 3e | 3e 20 69 6e 73 74 61 6e |bject.>>|> instan|
|00001370| 63 65 20 3d 20 4f 62 6a | 65 63 74 28 29 0a 3e 3e |ce = Obj|ect().>>|
|00001380| 3e 20 6c 69 73 74 2e 61 | 64 64 4f 62 6a 65 63 74 |> list.a|ddObject|
|00001390| 5f 5f 20 28 69 6e 73 74 | 61 6e 63 65 29 0a 5c 65 |__ (inst|ance).\e|
|000013a0| 6e 64 7b 76 65 72 62 61 | 74 69 6d 7d 0a 0a 25 20 |nd{verba|tim}..% |
|000013b0| 58 58 58 20 66 69 78 20 | 77 68 65 6e 65 76 65 72 |XXX fix |whenever|
|000013c0| 20 77 65 20 73 65 6c 65 | 63 74 20 74 68 65 20 61 | we sele|ct the a|
|000013d0| 6c 74 65 72 6e 61 74 69 | 76 65 20 73 79 6e 74 61 |lternati|ve synta|
|000013e0| 78 20 66 6f 72 20 4f 62 | 6a 43 20 6d 65 74 68 6f |x for Ob|jC metho|
|000013f0| 64 73 0a 25 20 6d 61 70 | 70 69 6e 67 2e 0a 0a 44 |ds.% map|ping...D|
|00001400| 75 65 20 74 6f 20 74 68 | 65 20 64 69 66 66 65 72 |ue to th|e differ|
|00001410| 65 6e 74 20 63 61 6c 6c | 69 6e 67 20 73 79 6e 74 |ent call|ing synt|
|00001420| 61 78 20 74 68 6f 75 67 | 68 20 74 68 65 20 4f 62 |ax thoug|h the Ob|
|00001430| 6a 65 63 74 69 76 65 2d | 43 20 73 65 6c 65 63 74 |jective-|C select|
|00001440| 6f 72 73 0a 6e 61 6d 65 | 20 63 68 61 6e 67 65 20 |ors.name| change |
|00001450| 73 6c 69 67 68 74 6c 79 | 3a 20 74 68 65 20 65 78 |slightly|: the ex|
|00001460| 70 72 65 73 73 69 6f 6e | 20 60 60 5b 6f 62 6a 20 |pression| ``[obj |
|00001470| 73 6f 6d 65 4d 65 74 68 | 6f 64 3a 61 72 67 41 0a |someMeth|od:argA.|
|00001480| 77 69 74 68 3a 61 72 67 | 42 5d 27 27 20 62 65 63 |with:arg|B]'' bec|
|00001490| 6f 6d 65 73 20 60 60 6f | 62 6a 2e 73 6f 6d 65 4d |omes ``o|bj.someM|
|000014a0| 65 74 68 6f 64 5c 5f 5c | 5f 77 69 74 68 5c 5f 5c |ethod\_\|_with\_\|
|000014b0| 5f 20 28 61 72 67 41 2c | 20 61 72 67 42 29 27 27 |_ (argA,| argB)''|
|000014c0| 20 6f 6e 63 65 0a 63 6f | 64 65 64 20 69 6e 20 50 | once.co|ded in P|
|000014d0| 79 74 68 6f 6e 2e 20 54 | 68 65 20 72 75 6c 65 20 |ython. T|he rule |
|000014e0| 74 6f 20 66 6f 6c 6c 6f | 77 20 69 73 20 76 65 72 |to follo|w is ver|
|000014f0| 79 20 73 69 6d 70 6c 65 | 3a 20 74 61 6b 65 20 74 |y simple|: take t|
|00001500| 68 65 20 7b 5c 65 6d 0a | 63 6f 6e 63 69 73 65 7d |he {\em.|concise}|
|00001510| 20 6e 6f 74 61 74 69 6f | 6e 20 6f 66 20 74 68 65 | notatio|n of the|
|00001520| 20 73 65 6c 65 63 74 6f | 72 20 28 74 68 65 20 65 | selecto|r (the e|
|00001530| 78 61 6d 70 6c 65 20 61 | 62 6f 76 65 20 67 69 76 |xample a|bove giv|
|00001540| 65 73 0a 60 60 73 6f 6d | 65 4d 65 74 68 6f 64 3a |es.``som|eMethod:|
|00001550| 77 69 74 68 3a 27 27 29 | 20 61 6e 64 20 72 65 70 |with:'')| and rep|
|00001560| 6c 61 63 65 20 65 76 65 | 72 79 20 63 6f 6c 6f 6e |lace eve|ry colon|
|00001570| 20 28 27 3a 27 29 20 63 | 68 61 72 61 63 74 65 72 | (':') c|haracter|
|00001580| 20 77 69 74 68 20 61 0a | 64 6f 75 62 6c 65 20 75 | with a.|double u|
|00001590| 6e 64 65 72 73 63 6f 72 | 65 20 28 27 5c 5f 5c 5f |nderscor|e ('\_\_|
|000015a0| 27 29 2c 20 74 68 65 6e | 20 66 65 65 64 20 74 68 |'), then| feed th|
|000015b0| 65 20 61 72 67 75 6d 65 | 6e 74 73 20 61 73 20 75 |e argume|nts as u|
|000015c0| 73 75 61 6c 2e 20 41 73 | 20 79 6f 75 20 6d 61 79 |sual. As| you may|
|000015d0| 0a 6e 6f 74 69 63 65 2c | 20 74 68 65 20 6e 61 6d |.notice,| the nam|
|000015e0| 65 20 6f 66 20 73 65 6c | 65 63 74 6f 72 73 20 77 |e of sel|ectors w|
|000015f0| 69 74 68 6f 75 74 20 61 | 72 67 75 6d 65 6e 74 73 |ithout a|rguments|
|00001600| 20 64 6f 65 73 20 6e 6f | 74 20 63 68 61 6e 67 65 | does no|t change|
|00001610| 20 61 74 20 61 6c 6c 2e | 0a 0a 41 6e 20 61 6c 74 | at all.|..An alt|
|00001620| 65 72 6e 61 74 69 76 65 | 20 74 72 61 6e 73 6c 61 |ernative| transla|
|00001630| 74 69 6f 6e 20 73 63 68 | 65 6d 65 20 77 61 73 20 |tion sch|eme was |
|00001640| 69 6e 74 72 6f 64 75 63 | 65 64 20 77 69 74 68 20 |introduc|ed with |
|00001650| 76 65 72 73 69 6f 6e 20 | 30 2e 34 35 20 6f 66 20 |version |0.45 of |
|00001660| 74 68 65 0a 6d 6f 64 75 | 6c 65 3a 20 66 69 72 73 |the.modu|le: firs|
|00001670| 74 20 72 65 70 6c 61 63 | 65 20 65 76 65 72 79 20 |t replac|e every |
|00001680| 75 6e 64 65 72 73 63 6f | 72 65 20 69 6e 20 74 68 |undersco|re in th|
|00001690| 65 20 6e 61 6d 65 20 77 | 69 74 68 20 61 20 74 72 |e name w|ith a tr|
|000016a0| 69 70 6c 65 20 6f 6e 65 | 0a 28 27 5c 5f 5c 5f 5c |iple one|.('\_\_\|
|000016b0| 5f 27 29 2c 20 74 68 65 | 6e 20 72 65 70 6c 61 63 |_'), the|n replac|
|000016c0| 65 20 65 76 65 72 79 20 | 63 6f 6c 6f 6e 20 77 69 |e every |colon wi|
|000016d0| 74 68 20 61 20 73 69 6e | 67 6c 65 20 75 6e 64 65 |th a sin|gle unde|
|000016e0| 72 73 63 6f 72 65 2e 20 | 53 69 6e 63 65 0a 75 6e |rscore. |Since.un|
|000016f0| 64 65 72 73 63 6f 72 65 | 73 20 61 72 65 20 6e 6f |derscore|s are no|
|00001700| 74 20 63 6f 6d 6d 6f 6e | 20 69 6e 20 4f 62 6a 65 |t common| in Obje|
|00001710| 63 74 69 76 65 2d 43 20 | 6d 65 74 68 6f 64 20 6e |ctive-C |method n|
|00001720| 61 6d 65 73 2c 20 74 68 | 69 73 20 67 69 76 65 73 |ames, th|is gives|
|00001730| 0a 73 68 6f 72 74 65 72 | 20 6e 61 6d 65 73 2e 20 |.shorter| names. |
|00001740| 0a 0a 5c 65 6d 70 68 7b | 53 69 6e 63 65 20 61 6c |..\emph{|Since al|
|00001750| 6c 6f 77 69 6e 67 20 74 | 68 69 73 20 64 6f 75 62 |lowing t|his doub|
|00001760| 6c 65 20 73 79 6e 74 61 | 78 20 69 6e 74 72 6f 64 |le synta|x introd|
|00001770| 75 63 65 73 20 61 20 6c | 69 74 74 6c 65 20 73 70 |uces a l|ittle sp|
|00001780| 65 65 64 0a 70 65 6e 61 | 6c 69 74 79 2c 20 49 20 |eed.pena|lity, I |
|00001790| 70 6c 61 6e 20 74 6f 20 | 72 65 6d 6f 76 65 20 6f |plan to |remove o|
|000017a0| 6e 65 20 6f 66 20 74 68 | 65 20 61 6c 74 65 72 6e |ne of th|e altern|
|000017b0| 61 74 69 76 65 73 20 69 | 6e 20 74 68 65 20 66 69 |atives i|n the fi|
|000017c0| 6e 61 6c 20 31 2e 30 0a | 72 65 6c 65 61 73 65 2e |nal 1.0.|release.|
|000017d0| 7d 20 0a 0a 54 68 65 20 | 6e 6f 74 61 74 69 6f 6e |} ..The |notation|
|000017e0| 20 60 60 6c 69 73 74 2e | 61 64 64 4f 62 6a 65 63 | ``list.|addObjec|
|000017f0| 74 5c 5f 5c 5f 27 27 20 | 64 6f 65 73 20 61 63 74 |t\_\_'' |does act|
|00001800| 75 61 6c 6c 79 20 72 65 | 74 75 72 6e 20 61 0a 5c |ually re|turn a.\|
|00001810| 63 6f 64 65 7b 4f 62 6a | 43 4d 65 74 68 6f 64 7d |code{Obj|CMethod}|
|00001820| 20 69 6e 73 74 61 6e 63 | 65 2c 20 64 65 73 63 72 | instanc|e, descr|
|00001830| 69 62 65 64 20 62 65 6c | 6f 77 2c 20 74 68 61 74 |ibed bel|ow, that|
|00001840| 20 79 6f 75 20 6d 61 79 | 20 63 61 63 68 65 0a 61 | you may| cache.a|
|00001850| 73 20 61 6e 79 20 6f 74 | 68 65 72 20 6d 65 74 68 |s any ot|her meth|
|00001860| 6f 64 2e 20 46 6f 72 20 | 65 78 61 6d 70 6c 65 3a |od. For |example:|
|00001870| 0a 0a 5c 62 65 67 69 6e | 7b 76 65 72 62 61 74 69 |..\begin|{verbati|
|00001880| 6d 7d 0a 3e 3e 3e 20 69 | 6d 70 6f 72 74 20 4f 62 |m}.>>> i|mport Ob|
|00001890| 6a 43 0a 3e 3e 3e 20 4c | 69 73 74 20 3d 20 4f 62 |jC.>>> L|ist = Ob|
|000018a0| 6a 43 2e 72 75 6e 74 69 | 6d 65 2e 4c 69 73 74 0a |jC.runti|me.List.|
|000018b0| 3e 3e 3e 20 6c 69 73 74 | 5f 61 6c 6c 6f 63 20 3d |>>> list|_alloc =|
|000018c0| 20 4c 69 73 74 2e 61 6c | 6c 6f 63 0a 3e 3e 3e 20 | List.al|loc.>>> |
|000018d0| 69 6e 73 74 61 6e 63 65 | 20 3d 20 6c 69 73 74 5f |instance| = list_|
|000018e0| 61 6c 6c 6f 63 28 29 2e | 69 6e 69 74 28 29 0a 5c |alloc().|init().\|
|000018f0| 65 6e 64 7b 76 65 72 62 | 61 74 69 6d 7d 0a 0a 57 |end{verb|atim}..W|
|00001900| 68 65 6e 20 61 6e 20 4f | 62 6a 43 4f 62 6a 65 63 |hen an O|bjCObjec|
|00001910| 74 20 72 65 70 72 65 73 | 65 6e 74 20 61 20 4f 62 |t repres|ent a Ob|
|00001920| 6a 65 63 74 69 76 65 2d | 43 20 63 6c 61 73 73 2c |jective-|C class,|
|00001930| 20 79 6f 75 20 63 61 6e | 20 60 60 63 61 6c 6c 27 | you can| ``call'|
|00001940| 27 20 69 74 0a 61 73 20 | 79 6f 75 20 6e 6f 72 6d |' it.as |you norm|
|00001950| 61 6c 6c 79 20 64 6f 20 | 77 69 74 68 20 50 79 74 |ally do |with Pyt|
|00001960| 68 6f 6e 20 63 6c 61 73 | 73 65 73 3a 20 69 74 20 |hon clas|ses: it |
|00001970| 69 73 20 61 20 73 68 6f | 72 74 63 75 74 20 66 6f |is a sho|rtcut fo|
|00001980| 72 20 61 20 6c 6f 6e 67 | 65 72 0a 60 60 2e 61 6c |r a long|er.``.al|
|00001990| 6c 6f 63 28 29 2e 69 6e | 69 74 28 29 27 27 2e 20 |loc().in|it()''. |
|000019a0| 59 6f 75 20 63 61 6e 20 | 70 61 73 73 20 69 6e 69 |You can |pass ini|
|000019b0| 74 69 61 6c 69 7a 61 74 | 69 6f 6e 20 61 72 67 75 |tializat|ion argu|
|000019c0| 6d 65 6e 74 73 20 74 6f | 20 74 68 65 0a 63 61 6c |ments to| the.cal|
|000019d0| 6c 3a 20 69 66 20 74 68 | 65 20 4f 62 6a 65 63 74 |l: if th|e Object|
|000019e0| 69 76 65 2d 43 20 63 6c | 61 73 73 20 69 6e 73 74 |ive-C cl|ass inst|
|000019f0| 61 6e 63 65 20 72 65 73 | 70 6f 6e 64 73 20 74 6f |ance res|ponds to|
|00001a00| 20 61 20 6d 65 74 68 6f | 64 20 63 61 6c 6c 65 64 | a metho|d called|
|00001a10| 0a 60 60 69 6e 69 74 3a | 3a 3a 2e 2e 2e 27 27 20 |.``init:|::...'' |
|00001a20| 74 68 61 74 20 6d 65 74 | 68 6f 64 20 69 73 20 63 |that met|hod is c|
|00001a30| 61 6c 6c 65 64 20 66 65 | 65 64 69 6e 67 20 69 74 |alled fe|eding it|
|00001a40| 20 74 68 65 20 61 72 67 | 75 6d 65 6e 74 73 20 61 | the arg|uments a|
|00001a50| 73 0a 75 73 75 61 6c 2e | 20 41 6c 74 65 72 6e 61 |s.usual.| Alterna|
|00001a60| 74 69 76 65 6c 79 2c 20 | 79 6f 75 20 6d 61 79 20 |tively, |you may |
|00001a70| 73 70 65 63 69 66 79 20 | 74 68 65 20 72 69 67 68 |specify |the righ|
|00001a80| 74 20 73 65 6c 65 63 74 | 6f 72 20 74 6f 20 62 65 |t select|or to be|
|00001a90| 20 75 73 65 64 20 74 6f | 0a 69 6e 69 74 69 61 6c | used to|.initial|
|00001aa0| 69 7a 65 20 74 68 65 20 | 6f 62 6a 65 63 74 20 62 |ize the |object b|
|00001ab0| 79 20 75 73 69 6e 67 20 | 74 68 65 20 5c 63 6f 64 |y using |the \cod|
|00001ac0| 65 7b 69 6e 69 74 7d 20 | 6b 65 79 77 6f 72 64 20 |e{init} |keyword |
|00001ad0| 70 61 72 61 6d 65 74 65 | 72 2c 20 69 6e 0a 74 68 |paramete|r, in.th|
|00001ae0| 69 73 20 77 61 79 3a 0a | 0a 5c 62 65 67 69 6e 7b |is way:.|.\begin{|
|00001af0| 76 65 72 62 61 74 69 6d | 7d 0a 3e 3e 3e 20 69 6d |verbatim|}.>>> im|
|00001b00| 70 6f 72 74 20 4f 62 6a | 43 0a 3e 3e 3e 20 4c 69 |port Obj|C.>>> Li|
|00001b10| 73 74 20 3d 20 4f 62 6a | 43 2e 72 75 6e 74 69 6d |st = Obj|C.runtim|
|00001b20| 65 2e 4c 69 73 74 0a 3e | 3e 3e 20 6c 69 73 74 20 |e.List.>|>> list |
|00001b30| 3d 20 4c 69 73 74 28 31 | 30 2c 20 69 6e 69 74 3d |= List(1|0, init=|
|00001b40| 27 69 6e 69 74 43 6f 75 | 6e 74 3a 27 29 0a 5c 65 |'initCou|nt:').\e|
|00001b50| 6e 64 7b 76 65 72 62 61 | 74 69 6d 7d 0a 0a 0a 49 |nd{verba|tim}...I|
|00001b60| 66 20 74 68 65 20 77 72 | 61 70 70 65 64 20 4f 62 |f the wr|apped Ob|
|00001b70| 6a 65 63 74 69 76 65 2d | 43 20 6f 62 6a 65 63 74 |jective-|C object|
|00001b80| 20 69 6d 70 6c 65 6d 65 | 6e 74 73 20 74 68 65 20 | impleme|nts the |
|00001b90| 6d 65 74 68 6f 64 73 0a | 5c 63 6f 64 65 7b 2d 6c |methods.|\code{-l|
|00001ba0| 65 6e 67 74 68 7d 20 28 | 6f 72 20 5c 63 6f 64 65 |ength} (|or \code|
|00001bb0| 7b 2d 63 6f 75 6e 74 7d | 29 20 61 6e 64 20 5c 63 |{-count}|) and \c|
|00001bc0| 6f 64 65 7b 2d 6f 62 6a | 65 63 74 41 74 3a 7d 20 |ode{-obj|ectAt:} |
|00001bd0| 28 6f 72 0a 5c 63 6f 64 | 65 7b 2d 6f 62 6a 65 63 |(or.\cod|e{-objec|
|00001be0| 74 41 74 49 6e 64 65 78 | 3a 7d 29 20 74 68 61 6e |tAtIndex|:}) than|
|00001bf0| 20 69 74 27 73 20 70 6f | 73 73 69 62 6c 65 20 74 | it's po|ssible t|
|00001c00| 6f 20 74 72 65 61 74 20 | 69 74 20 61 73 20 61 6e |o treat |it as an|
|00001c10| 79 20 6f 74 68 65 72 0a | 73 65 71 75 65 6e 63 65 |y other.|sequence|
|00001c20| 20 6f 62 6a 65 63 74 2c | 20 74 68 75 73 20 67 69 | object,| thus gi|
|00001c30| 76 69 6e 67 3a 0a 0a 5c | 62 65 67 69 6e 7b 76 65 |ving:..\|begin{ve|
|00001c40| 72 62 61 74 69 6d 7d 0a | 3e 3e 3e 20 6c 69 73 74 |rbatim}.|>>> list|
|00001c50| 20 3d 20 4f 62 6a 43 2e | 72 75 6e 74 69 6d 65 2e | = ObjC.|runtime.|
|00001c60| 4c 69 73 74 28 29 0a 3e | 3e 3e 20 6c 69 73 74 2e |List().>|>> list.|
|00001c70| 61 64 64 4f 62 6a 65 63 | 74 5f 5f 20 28 27 73 70 |addObjec|t__ ('sp|
|00001c80| 61 6d 27 29 0a 3e 3e 3e | 20 6c 69 73 74 2e 61 64 |am').>>>| list.ad|
|00001c90| 64 4f 62 6a 65 63 74 5f | 5f 20 28 31 29 0a 3e 3e |dObject_|_ (1).>>|
|00001ca0| 3e 20 6c 69 73 74 2e 61 | 64 64 4f 62 6a 65 63 74 |> list.a|ddObject|
|00001cb0| 5f 5f 20 28 27 6c 69 74 | 65 72 27 29 0a 3e 3e 3e |__ ('lit|er').>>>|
|00001cc0| 20 6c 69 73 74 2e 61 64 | 64 4f 62 6a 65 63 74 5f | list.ad|dObject_|
|00001cd0| 5f 20 28 27 70 6c 65 61 | 73 65 29 0a 3e 3e 3e 20 |_ ('plea|se).>>> |
|00001ce0| 70 72 69 6e 74 20 6c 69 | 73 74 2e 63 6f 75 6e 74 |print li|st.count|
|00001cf0| 28 29 0a 34 0a 3e 3e 3e | 20 70 72 69 6e 74 20 6c |().4.>>>| print l|
|00001d00| 69 73 74 2e 63 61 70 61 | 63 69 74 79 28 29 0a 37 |ist.capa|city().7|
|00001d10| 0a 3e 3e 3e 20 70 72 69 | 6e 74 20 6c 69 73 74 5b |.>>> pri|nt list[|
|00001d20| 3a 5d 0a 5b 27 73 70 61 | 6d 27 2c 20 31 2c 20 27 |:].['spa|m', 1, '|
|00001d30| 6c 69 74 65 72 27 2c 20 | 27 70 6c 65 61 73 65 27 |liter', |'please'|
|00001d40| 5d 0a 3e 3e 3e 20 70 72 | 69 6e 74 20 6c 69 73 74 |].>>> pr|int list|
|00001d50| 2b 6c 69 73 74 0a 5b 27 | 73 70 61 6d 27 2c 20 31 |+list.['|spam', 1|
|00001d60| 2c 20 27 6c 69 74 65 72 | 27 2c 20 27 70 6c 65 61 |, 'liter|', 'plea|
|00001d70| 73 65 27 2c 20 27 73 70 | 61 6d 27 2c 20 31 2c 20 |se', 'sp|am', 1, |
|00001d80| 27 6c 69 74 65 72 27 2c | 20 27 70 6c 65 61 73 65 |'liter',| 'please|
|00001d90| 27 5d 0a 3e 3e 3e 20 70 | 72 69 6e 74 20 6c 69 73 |'].>>> p|rint lis|
|00001da0| 74 2a 33 0a 5b 27 73 70 | 61 6d 27 2c 20 31 2c 20 |t*3.['sp|am', 1, |
|00001db0| 27 6c 69 74 65 72 27 2c | 20 27 70 6c 65 61 73 65 |'liter',| 'please|
|00001dc0| 27 2c 20 27 73 70 61 6d | 27 2c 20 31 2c 20 27 6c |', 'spam|', 1, 'l|
|00001dd0| 69 74 65 72 27 2c 20 27 | 70 6c 65 61 73 65 27 2c |iter', '|please',|
|00001de0| 0a 27 73 70 61 6d 27 2c | 20 31 2c 20 27 6c 69 74 |.'spam',| 1, 'lit|
|00001df0| 65 72 27 2c 20 27 70 6c | 65 61 73 65 27 5d 0a 3e |er', 'pl|ease'].>|
|00001e00| 3e 3e 20 66 6f 72 20 69 | 20 69 6e 20 6c 69 73 74 |>> for i| in list|
|00001e10| 3a 20 70 72 69 6e 74 20 | 69 0a 2e 2e 2e 0a 73 70 |: print |i.....sp|
|00001e20| 61 6d 0a 31 0a 6c 69 74 | 65 72 0a 70 6c 65 61 73 |am.1.lit|er.pleas|
|00001e30| 65 0a 5c 65 6e 64 7b 76 | 65 72 62 61 74 69 6d 7d |e.\end{v|erbatim}|
|00001e40| 0a 0a 4f 74 68 65 72 77 | 69 73 65 2c 20 69 66 20 |..Otherw|ise, if |
|00001e50| 69 74 20 69 6d 70 6c 65 | 6d 65 6e 74 73 20 74 68 |it imple|ments th|
|00001e60| 65 20 6d 65 74 68 6f 64 | 73 0a 5c 63 6f 64 65 7b |e method|s.\code{|
|00001e70| 2d 6c 65 6e 67 74 68 7d | 20 28 6f 72 20 5c 63 6f |-length}| (or \co|
|00001e80| 64 65 7b 2d 63 6f 75 6e | 74 7d 29 20 61 6e 64 20 |de{-coun|t}) and |
|00001e90| 5c 63 6f 64 65 7b 2d 76 | 61 6c 75 65 46 6f 72 4b |\code{-v|alueForK|
|00001ea0| 65 79 3a 7d 20 28 6f 72 | 0a 5c 63 6f 64 65 7b 2d |ey:} (or|.\code{-|
|00001eb0| 6f 62 6a 65 63 74 46 6f | 72 4b 65 79 3a 7d 29 20 |objectFo|rKey:}) |
|00001ec0| 74 68 61 6e 20 69 74 27 | 73 20 70 6f 73 73 69 62 |than it'|s possib|
|00001ed0| 6c 65 20 74 6f 20 74 72 | 65 61 74 20 69 74 20 61 |le to tr|eat it a|
|00001ee0| 73 20 61 6e 79 20 6f 74 | 68 65 72 0a 6d 61 70 70 |s any ot|her.mapp|
|00001ef0| 69 6e 67 20 6f 62 6a 65 | 63 74 2e 0a 0a 5c 73 75 |ing obje|ct...\su|
|00001f00| 62 73 65 63 74 69 6f 6e | 7b 4f 62 6a 43 4d 65 74 |bsection|{ObjCMet|
|00001f10| 68 6f 64 20 6f 62 6a 65 | 63 74 73 7d 0a 5c 72 65 |hod obje|cts}.\re|
|00001f20| 6e 65 77 63 6f 6d 6d 61 | 6e 64 7b 5c 69 6e 64 65 |newcomma|nd{\inde|
|00001f30| 78 73 75 62 69 74 65 6d | 7d 7b 28 4f 62 6a 43 4d |xsubitem|}{(ObjCM|
|00001f40| 65 74 68 6f 64 20 6d 65 | 74 68 6f 64 29 7d 0a 0a |ethod me|thod)}..|
|00001f50| 41 6e 20 4f 62 6a 43 4d | 65 74 68 6f 64 20 69 6e |An ObjCM|ethod in|
|00001f60| 73 74 61 6e 63 65 20 69 | 73 20 72 65 74 75 72 6e |stance i|s return|
|00001f70| 65 64 20 77 68 65 6e 20 | 79 6f 75 20 61 73 6b 20 |ed when |you ask |
|00001f80| 74 6f 20 61 6e 20 4f 62 | 6a 43 4f 62 6a 65 63 74 |to an Ob|jCObject|
|00001f90| 20 61 0a 70 61 72 74 69 | 63 75 6c 61 72 20 73 65 | a.parti|cular se|
|00001fa0| 6c 65 63 74 6f 72 2e 20 | 42 79 20 60 60 63 61 6c |lector. |By ``cal|
|00001fb0| 6c 69 6e 67 27 27 20 69 | 74 2c 20 79 6f 75 20 65 |ling'' i|t, you e|
|00001fc0| 78 65 63 75 74 65 20 74 | 68 65 20 61 73 73 6f 63 |xecute t|he assoc|
|00001fd0| 69 61 74 65 64 0a 4f 62 | 6a 65 63 74 69 76 65 2d |iated.Ob|jective-|
|00001fe0| 43 20 6d 65 74 68 6f 64 | 2e 20 49 74 20 6b 6e 6f |C method|. It kno|
|00001ff0| 77 73 20 61 62 6f 75 74 | 20 74 68 65 20 6e 75 6d |ws about| the num|
|00002000| 62 65 72 20 6f 66 20 61 | 72 67 75 6d 65 6e 74 73 |ber of a|rguments|
|00002010| 20 74 68 65 0a 73 65 6c | 65 63 74 6f 72 20 61 63 | the.sel|ector ac|
|00002020| 63 65 70 74 73 2c 20 61 | 6e 64 20 74 68 65 69 72 |cepts, a|nd their|
|00002030| 20 74 79 70 65 2c 20 73 | 6f 20 74 68 61 74 20 69 | type, s|o that i|
|00002040| 74 27 73 20 61 62 6c 65 | 20 74 6f 20 63 6f 6e 76 |t's able| to conv|
|00002050| 65 72 74 20 61 0a 50 79 | 74 68 6f 6e 20 76 61 6c |ert a.Py|thon val|
|00002060| 75 65 20 74 6f 20 61 20 | 73 75 69 74 61 62 6c 65 |ue to a |suitable|
|00002070| 20 43 20 76 61 6c 75 65 | 2c 20 61 6e 64 20 76 69 | C value|, and vi|
|00002080| 63 65 76 65 72 73 61 2e | 20 46 6f 72 20 65 78 61 |ceversa.| For exa|
|00002090| 6d 70 6c 65 2c 20 77 68 | 65 6e 20 61 0a 73 65 6c |mple, wh|en a.sel|
|000020a0| 65 63 74 6f 72 20 74 61 | 6b 65 73 20 61 20 5c 63 |ector ta|kes a \c|
|000020b0| 6f 64 65 7b 73 74 72 75 | 63 74 7d 20 76 61 6c 75 |ode{stru|ct} valu|
|000020c0| 65 2c 20 79 6f 75 20 61 | 63 74 75 61 6c 6c 79 20 |e, you a|ctually |
|000020d0| 66 65 65 64 20 69 74 20 | 61 20 50 79 74 68 6f 6e |feed it |a Python|
|000020e0| 0a 74 75 70 6c 65 20 6f | 62 6a 65 63 74 2c 20 74 |.tuple o|bject, t|
|000020f0| 68 65 6e 20 74 68 65 20 | 4f 62 6a 43 4d 65 74 68 |hen the |ObjCMeth|
|00002100| 6f 64 20 77 69 6c 6c 20 | 63 6f 6e 76 65 72 74 20 |od will |convert |
|00002110| 74 68 61 74 20 74 75 70 | 6c 65 20 74 6f 20 74 68 |that tup|le to th|
|00002120| 65 20 6e 65 65 64 65 64 | 0a 43 20 73 74 72 75 63 |e needed|.C struc|
|00002130| 74 20 76 61 6c 75 65 3b | 20 69 66 20 69 74 20 72 |t value;| if it r|
|00002140| 65 74 75 72 6e 73 20 61 | 20 5c 63 6f 64 65 7b 63 |eturns a| \code{c|
|00002150| 68 61 72 20 2a 7d 20 76 | 61 6c 75 65 2c 20 79 6f |har *} v|alue, yo|
|00002160| 75 20 61 63 74 75 61 6c | 6c 79 0a 72 65 63 65 69 |u actual|ly.recei|
|00002170| 76 65 20 61 20 73 74 61 | 6e 64 61 72 64 20 50 79 |ve a sta|ndard Py|
|00002180| 74 68 6f 6e 20 73 74 72 | 69 6e 67 20 6f 62 6a 65 |thon str|ing obje|
|00002190| 63 74 2e 20 54 68 65 20 | 73 61 6d 65 20 74 72 61 |ct. The |same tra|
|000021a0| 6e 73 6c 61 74 69 6f 6e | 20 68 61 70 70 65 6e 73 |nslation| happens|
|000021b0| 0a 66 6f 72 20 43 20 61 | 72 72 61 79 73 2e 20 4f |.for C a|rrays. O|
|000021c0| 74 68 65 72 20 74 79 70 | 65 73 20 67 65 74 20 74 |ther typ|es get t|
|000021d0| 72 61 6e 73 6c 61 74 65 | 64 20 61 73 20 79 6f 75 |ranslate|d as you|
|000021e0| 27 64 20 65 78 70 65 63 | 74 2c 20 65 78 63 65 70 |'d expec|t, excep|
|000021f0| 74 20 66 6f 72 0a 5c 63 | 6f 64 65 7b 63 68 61 72 |t for.\c|ode{char|
|00002200| 7d 20 76 61 6c 75 65 73 | 2c 20 74 68 61 74 20 61 |} values|, that a|
|00002210| 72 65 20 63 6f 6e 76 65 | 72 74 65 64 20 74 6f 20 |re conve|rted to |
|00002220| 69 6e 74 65 67 65 72 73 | 5c 66 6f 6f 74 6e 6f 74 |integers|\footnot|
|00002230| 65 7b 49 6e 0a 4f 62 6a | 65 63 74 69 76 65 2d 43 |e{In.Obj|ective-C|
|00002240| 20 69 74 27 73 20 61 20 | 63 6f 6d 6d 6f 6e 20 70 | it's a |common p|
|00002250| 72 61 74 69 63 65 20 74 | 6f 20 75 73 65 20 5c 63 |ratice t|o use \c|
|00002260| 6f 64 65 7b 42 4f 4f 4c | 7d 20 76 61 6c 75 65 73 |ode{BOOL|} values|
|00002270| 20 61 6e 64 20 69 6e 0a | 73 6f 6d 65 20 69 6d 70 | and in.|some imp|
|00002280| 6c 65 6d 65 6e 74 61 74 | 69 6f 6e 20 74 68 69 73 |lementat|ion this|
|00002290| 20 74 79 70 65 20 69 73 | 20 61 6e 20 61 6c 69 61 | type is| an alia|
|000022a0| 73 20 66 6f 72 20 5c 63 | 6f 64 65 7b 75 6e 73 69 |s for \c|ode{unsi|
|000022b0| 67 6e 65 64 20 63 68 61 | 72 7d 3a 0a 60 60 69 66 |gned cha|r}:.``if|
|000022c0| 20 6f 62 6a 2e 69 73 43 | 6c 61 73 73 28 29 27 27 | obj.isC|lass()''|
|000022d0| 20 73 65 65 6d 73 20 6d | 6f 72 65 20 6e 61 74 75 | seems m|ore natu|
|000022e0| 72 61 6c 20 74 68 61 6e | 20 60 60 69 66 20 6f 72 |ral than| ``if or|
|000022f0| 64 20 28 6f 62 6a 63 2e | 69 73 43 6c 61 73 73 28 |d (objc.|isClass(|
|00002300| 29 29 0a 3d 3d 20 31 27 | 27 7d 2c 20 61 6c 74 68 |)).== 1'|'}, alth|
|00002310| 6f 75 67 68 20 73 69 6e | 67 6c 65 2d 63 68 61 72 |ough sin|gle-char|
|00002320| 20 73 74 72 69 6e 67 73 | 20 61 72 65 20 61 63 63 | strings| are acc|
|00002330| 65 70 74 65 64 20 61 73 | 20 61 72 67 75 6d 65 6e |epted as| argumen|
|00002340| 74 73 2e 20 57 68 65 6e | 0a 61 20 73 65 6c 65 63 |ts. When|.a selec|
|00002350| 74 6f 72 20 69 73 20 65 | 78 70 65 63 74 65 64 2c |tor is e|xpected,|
|00002360| 20 79 6f 75 20 63 61 6e | 20 67 69 76 65 20 69 74 | you can| give it|
|00002370| 20 62 6f 74 68 20 61 73 | 20 69 74 73 20 63 6f 6e | both as| its con|
|00002380| 63 69 73 65 20 73 74 72 | 69 6e 67 0a 72 65 70 72 |cise str|ing.repr|
|00002390| 65 73 65 6e 74 61 74 69 | 6f 6e 20 6f 72 20 62 79 |esentati|on or by|
|000023a0| 20 70 61 73 73 69 6e 67 | 20 61 6e 20 4f 62 6a 43 | passing| an ObjC|
|000023b0| 4d 65 74 68 6f 64 20 69 | 6e 73 74 61 6e 63 65 20 |Method i|nstance |
|000023c0| 6f 66 20 69 74 2e 0a 0a | 54 6f 20 65 78 70 6c 61 |of it...|To expla|
|000023d0| 69 6e 20 62 65 74 74 65 | 72 2c 20 67 69 76 65 6e |in bette|r, given|
|000023e0| 20 74 68 65 20 4f 62 6a | 65 63 74 69 76 65 2d 43 | the Obj|ective-C|
|000023f0| 20 64 65 63 6c 61 72 61 | 74 69 6f 6e 73 3a 0a 0a | declara|tions:..|
|00002400| 5c 62 65 67 69 6e 7b 76 | 65 72 62 61 74 69 6d 7d |\begin{v|erbatim}|
|00002410| 0a 74 79 70 65 64 65 66 | 20 73 74 72 75 63 74 20 |.typedef| struct |
|00002420| 5f 70 6f 69 6e 74 20 7b | 20 66 6c 6f 61 74 20 78 |_point {| float x|
|00002430| 2c 79 20 7d 20 50 6f 69 | 6e 74 3b 0a 74 79 70 65 |,y } Poi|nt;.type|
|00002440| 64 65 66 20 73 74 72 75 | 63 74 20 5f 73 69 7a 65 |def stru|ct _size|
|00002450| 20 7b 20 66 6c 6f 61 74 | 20 77 2c 68 20 7d 20 53 | { float| w,h } S|
|00002460| 69 7a 65 3b 0a 74 79 70 | 65 64 65 66 20 73 74 72 |ize;.typ|edef str|
|00002470| 75 63 74 20 5f 72 65 63 | 74 20 7b 20 50 6f 69 6e |uct _rec|t { Poin|
|00002480| 74 20 6f 72 69 67 69 6e | 3b 20 53 69 7a 65 20 73 |t origin|; Size s|
|00002490| 69 7a 65 20 7d 20 52 65 | 63 74 3b 0a 0a 40 69 6e |ize } Re|ct;..@in|
|000024a0| 74 65 72 66 61 63 65 20 | 53 71 75 61 72 65 20 3a |terface |Square :|
|000024b0| 20 4f 62 6a 65 63 74 0a | 7b 0a 20 20 52 65 63 74 | Object.|{. Rect|
|000024c0| 20 66 72 61 6d 65 3b 0a | 7d 0a 0a 2d 20 69 6e 69 | frame;.|}..- ini|
|000024d0| 74 57 69 74 68 46 72 61 | 6d 65 3a 28 52 65 63 74 |tWithFra|me:(Rect|
|000024e0| 29 20 72 3b 0a 2d 20 28 | 76 6f 69 64 29 20 67 65 |) r;.- (|void) ge|
|000024f0| 74 46 72 61 6d 65 3a 28 | 52 65 63 74 20 2a 29 20 |tFrame:(|Rect *) |
|00002500| 72 3b 0a 2d 20 28 76 6f | 69 64 29 20 70 65 72 66 |r;.- (vo|id) perf|
|00002510| 6f 72 6d 3a 28 53 45 4c | 29 20 73 65 6c 3b 0a 2d |orm:(SEL|) sel;.-|
|00002520| 20 28 76 6f 69 64 29 20 | 73 68 6f 77 3b 0a 0a 40 | (void) |show;..@|
|00002530| 65 6e 64 0a 5c 65 6e 64 | 7b 76 65 72 62 61 74 69 |end.\end|{verbati|
|00002540| 6d 7d 0a 0a 74 6f 20 70 | 61 73 73 20 74 68 65 20 |m}..to p|ass the |
|00002550| 5c 76 61 72 7b 72 7d 20 | 61 72 67 75 6d 65 6e 74 |\var{r} |argument|
|00002560| 20 74 6f 20 5c 63 6f 64 | 65 7b 69 6e 69 74 57 69 | to \cod|e{initWi|
|00002570| 74 68 46 72 61 6d 65 3a | 7d 20 79 6f 75 20 6d 75 |thFrame:|} you mu|
|00002580| 73 74 20 62 75 69 6c 64 | 20 61 0a 74 75 70 6c 65 |st build| a.tuple|
|00002590| 20 6f 66 20 74 77 6f 20 | 69 74 65 6d 73 2c 20 74 | of two |items, t|
|000025a0| 68 65 20 66 69 72 73 74 | 20 74 6f 20 62 65 20 61 |he first| to be a|
|000025b0| 20 74 75 70 6c 65 20 77 | 69 74 68 20 74 77 6f 20 | tuple w|ith two |
|000025c0| 65 6c 65 6d 65 6e 74 73 | 20 66 6f 72 20 74 68 65 |elements| for the|
|000025d0| 0a 5c 76 61 72 7b 6f 72 | 69 67 69 6e 7d 2c 20 77 |.\var{or|igin}, w|
|000025e0| 69 74 68 20 76 61 6c 75 | 65 73 20 66 6f 72 20 5c |ith valu|es for \|
|000025f0| 76 61 72 7b 78 7d 20 61 | 6e 64 20 5c 76 61 72 7b |var{x} a|nd \var{|
|00002600| 79 7d 20 69 6e 20 69 74 | 3b 20 74 68 65 20 73 65 |y} in it|; the se|
|00002610| 63 6f 6e 64 0a 66 6f 72 | 20 74 68 65 20 5c 76 61 |cond.for| the \va|
|00002620| 72 7b 73 69 7a 65 7d 20 | 73 6c 6f 74 2c 20 61 6e |r{size} |slot, an|
|00002630| 6f 74 68 65 72 20 74 75 | 70 6c 65 20 63 6f 6e 74 |other tu|ple cont|
|00002640| 61 69 6e 69 6e 67 20 76 | 61 6c 75 65 73 20 66 6f |aining v|alues fo|
|00002650| 72 20 5c 76 61 72 7b 77 | 7d 0a 61 6e 64 20 5c 76 |r \var{w|}.and \v|
|00002660| 61 72 7b 68 7d 2e 20 54 | 68 69 73 20 67 69 76 65 |ar{h}. T|his give|
|00002670| 73 3a 0a 0a 5c 62 65 67 | 69 6e 7b 76 65 72 62 61 |s:..\beg|in{verba|
|00002680| 74 69 6d 7d 0a 3e 3e 3e | 20 69 6d 70 6f 72 74 20 |tim}.>>>| import |
|00002690| 4f 62 6a 43 0a 3e 3e 3e | 20 6d 79 72 6f 6f 6d 20 |ObjC.>>>| myroom |
|000026a0| 3d 20 4f 62 6a 43 2e 72 | 75 6e 74 69 6d 65 2e 53 |= ObjC.r|untime.S|
|000026b0| 71 75 61 72 65 2e 61 6c | 6c 6f 63 28 29 0a 3e 3e |quare.al|loc().>>|
|000026c0| 3e 20 6d 79 72 6f 6f 6d | 2e 69 6e 69 74 57 69 74 |> myroom|.initWit|
|000026d0| 68 46 72 61 6d 65 5f 5f | 20 28 20 28 30 2e 30 2c |hFrame__| ( (0.0,|
|000026e0| 20 30 2e 30 29 2c 20 28 | 31 32 2e 33 2c 20 38 2e | 0.0), (|12.3, 8.|
|000026f0| 31 29 20 29 0a 3e 3e 3e | 20 2e 2e 2e 0a 3e 3e 3e |1) ).>>>| ....>>>|
|00002700| 20 23 20 74 68 65 73 65 | 20 61 72 65 20 65 71 75 | # these| are equ|
|00002710| 69 76 61 6c 65 6e 74 0a | 3e 3e 3e 20 6d 79 72 6f |ivalent.|>>> myro|
|00002720| 6f 6d 2e 70 65 72 66 6f | 72 6d 5f 5f 20 28 22 73 |om.perfo|rm__ ("s|
|00002730| 68 6f 77 22 29 0a 3e 3e | 3e 20 6d 79 72 6f 6f 6d |how").>>|> myroom|
|00002740| 2e 70 65 72 66 6f 72 6d | 5f 5f 20 28 6d 79 72 6f |.perform|__ (myro|
|00002750| 6f 6d 2e 73 68 6f 77 29 | 0a 5c 65 6e 64 7b 76 65 |om.show)|.\end{ve|
|00002760| 72 62 61 74 69 6d 7d 0a | 0a 41 20 6c 69 74 74 6c |rbatim}.|.A littl|
|00002770| 65 20 63 6f 6d 70 6c 69 | 63 61 74 69 6f 6e 20 61 |e compli|cation a|
|00002780| 72 69 73 65 73 20 77 69 | 74 68 20 6d 65 74 68 6f |rises wi|th metho|
|00002790| 64 73 20 74 68 61 74 20 | 74 61 6b 65 20 61 0a 5c |ds that |take a.\|
|000027a0| 64 66 6e 7b 70 61 73 73 | 2d 62 79 2d 72 65 66 65 |dfn{pass|-by-refe|
|000027b0| 72 65 6e 63 65 7d 20 61 | 72 67 75 6d 65 6e 74 3a |rence} a|rgument:|
|000027c0| 20 75 73 75 61 6c 6c 79 | 20 73 75 63 68 20 61 72 | usually| such ar|
|000027d0| 67 75 6d 65 6e 74 73 20 | 61 72 65 20 75 73 65 64 |guments |are used|
|000027e0| 20 77 68 65 6e 0a 74 68 | 65 20 73 65 6c 65 63 74 | when.th|e select|
|000027f0| 6f 72 20 77 61 6e 74 73 | 20 74 6f 20 72 65 74 75 |or wants| to retu|
|00002800| 72 6e 20 6d 6f 72 65 20 | 74 68 61 6e 20 6f 6e 65 |rn more |than one|
|00002810| 20 76 61 6c 75 65 2c 20 | 66 6f 72 20 65 78 61 6d | value, |for exam|
|00002820| 70 6c 65 20 61 20 73 74 | 61 74 75 73 0a 6f 66 20 |ple a st|atus.of |
|00002830| 6f 70 65 72 61 74 69 6f | 6e 20 61 6e 64 20 61 6e |operatio|n and an|
|00002840| 20 61 63 74 75 61 6c 20 | 72 65 73 75 6c 74 20 76 | actual |result v|
|00002850| 61 6c 75 65 2e 20 49 6e | 20 74 68 69 73 20 63 61 |alue. In| this ca|
|00002860| 73 65 20 74 68 65 20 6d | 65 74 68 6f 64 20 6d 61 |se the m|ethod ma|
|00002870| 79 0a 6d 6f 64 69 66 79 | 20 69 74 73 20 61 72 67 |y.modify| its arg|
|00002880| 75 6d 65 6e 74 73 3b 20 | 73 69 6e 63 65 20 69 6e |uments; |since in|
|00002890| 20 50 79 74 68 6f 6e 20 | 74 68 65 72 65 20 69 73 | Python |there is|
|000028a0| 20 6e 6f 20 6e 6f 74 69 | 6f 6e 20 6f 66 0a 70 61 | no noti|on of.pa|
|000028b0| 73 73 2d 62 79 2d 72 65 | 66 65 72 65 6e 63 65 20 |ss-by-re|ference |
|000028c0| 61 72 67 75 6d 65 6e 74 | 20 73 79 6e 74 61 78 2c |argument| syntax,|
|000028d0| 20 79 6f 75 20 6d 75 73 | 74 20 75 73 65 20 61 20 | you mus|t use a |
|000028e0| 64 69 66 66 65 72 65 6e | 74 20 77 61 79 2e 0a 0a |differen|t way...|
|000028f0| 5c 62 65 67 69 6e 7b 66 | 75 6e 63 64 65 73 63 7d |\begin{f|uncdesc}|
|00002900| 7b 70 61 63 6b 5f 61 72 | 67 75 6d 65 6e 74 7d 7b |{pack_ar|gument}{|
|00002910| 61 72 67 6e 5c 6f 70 74 | 69 6f 6e 61 6c 7b 2c 20 |argn\opt|ional{, |
|00002920| 76 61 6c 75 65 7d 7d 0a | 54 68 69 73 20 6d 65 74 |value}}.|This met|
|00002930| 68 6f 64 20 62 75 69 6c | 64 73 20 61 20 5c 64 66 |hod buil|ds a \df|
|00002940| 6e 7b 70 61 63 6b 65 64 | 7d 20 72 65 70 72 65 73 |n{packed|} repres|
|00002950| 65 6e 74 61 74 69 6f 6e | 20 6f 66 20 74 68 65 20 |entation| of the |
|00002960| 67 69 76 65 6e 20 50 79 | 74 68 6f 6e 0a 5c 76 61 |given Py|thon.\va|
|00002970| 72 7b 76 61 6c 75 65 7d | 20 73 75 69 74 61 62 6c |r{value}| suitabl|
|00002980| 65 20 74 6f 20 62 65 20 | 66 65 65 64 65 64 20 61 |e to be |feeded a|
|00002990| 73 20 74 68 65 20 5c 76 | 61 72 7b 61 72 67 6e 7d |s the \v|ar{argn}|
|000029a0| 2d 74 68 0a 61 72 67 75 | 6d 65 6e 74 20 6f 66 20 |-th.argu|ment of |
|000029b0| 74 68 65 20 6d 65 74 68 | 6f 64 2c 20 61 6e 64 20 |the meth|od, and |
|000029c0| 72 65 74 75 72 6e 73 20 | 61 6e 20 4f 62 6a 43 50 |returns |an ObjCP|
|000029d0| 6f 69 6e 74 65 72 20 6f | 62 6a 65 63 74 20 61 73 |ointer o|bject as|
|000029e0| 20 69 74 73 0a 63 6f 6e | 74 61 69 6e 65 72 2e 20 | its.con|tainer. |
|000029f0| 49 66 20 5c 76 61 72 7b | 76 61 6c 75 65 7d 20 69 |If \var{|value} i|
|00002a00| 73 20 6e 6f 74 20 67 69 | 76 65 6e 2c 20 74 68 65 |s not gi|ven, the|
|00002a10| 20 63 6f 6e 74 65 6e 74 | 20 6f 66 20 74 68 65 20 | content| of the |
|00002a20| 70 61 63 6b 65 64 0a 76 | 61 6c 75 65 20 77 69 6c |packed.v|alue wil|
|00002a30| 6c 20 6e 6f 74 20 62 65 | 20 69 6e 69 74 69 61 6c |l not be| initial|
|00002a40| 69 7a 65 64 2e 0a 5c 65 | 6e 64 7b 66 75 6e 63 64 |ized..\e|nd{funcd|
|00002a50| 65 73 63 7d 0a 0a 5c 62 | 65 67 69 6e 7b 66 75 6e |esc}..\b|egin{fun|
|00002a60| 63 64 65 73 63 7d 7b 75 | 6e 70 61 63 6b 5f 61 72 |cdesc}{u|npack_ar|
|00002a70| 67 75 6d 65 6e 74 7d 7b | 61 72 67 6e 2c 20 70 61 |gument}{|argn, pa|
|00002a80| 63 6b 65 64 56 61 6c 75 | 65 7d 0a 54 68 69 73 20 |ckedValu|e}.This |
|00002a90| 6d 65 74 68 6f 64 20 74 | 61 6b 65 73 20 74 68 65 |method t|akes the|
|00002aa0| 20 70 61 63 6b 65 64 20 | 76 61 6c 75 65 20 69 6e | packed |value in|
|00002ab0| 20 5c 76 61 72 7b 70 61 | 63 6b 65 64 56 61 6c 75 | \var{pa|ckedValu|
|00002ac0| 65 7d 20 61 6e 64 20 75 | 6e 70 61 63 6b 73 20 69 |e} and u|npacks i|
|00002ad0| 74 0a 61 63 63 6f 72 64 | 69 6e 67 6c 79 20 74 6f |t.accord|ingly to|
|00002ae0| 20 74 68 65 20 74 79 70 | 65 20 6f 66 20 74 68 65 | the typ|e of the|
|00002af0| 20 5c 76 61 72 7b 61 72 | 67 6e 7d 2d 74 68 20 61 | \var{ar|gn}-th a|
|00002b00| 72 67 75 6d 65 6e 74 20 | 6f 66 20 74 68 65 20 6d |rgument |of the m|
|00002b10| 65 74 68 6f 64 2c 0a 74 | 68 75 73 20 72 65 74 75 |ethod,.t|hus retu|
|00002b20| 72 6e 69 6e 67 20 74 68 | 65 20 50 79 74 68 6f 6e |rning th|e Python|
|00002b30| 20 72 65 70 72 65 73 65 | 6e 74 61 74 69 6f 6e 20 | represe|ntation |
|00002b40| 6f 66 20 69 74 2e 20 5c | 76 61 72 7b 70 61 63 6b |of it. \|var{pack|
|00002b50| 65 64 56 61 6c 75 65 7d | 20 6d 61 79 0a 62 65 20 |edValue}| may.be |
|00002b60| 63 6f 6d 69 6e 67 20 66 | 72 6f 6d 20 61 20 5c 63 |coming f|rom a \c|
|00002b70| 6f 64 65 7b 73 74 72 75 | 63 74 2e 70 61 63 6b 28 |ode{stru|ct.pack(|
|00002b80| 29 7d 2c 20 69 65 20 61 | 20 73 74 72 69 6e 67 20 |)}, ie a| string |
|00002b90| 6f 62 6a 65 63 74 2c 20 | 6f 72 20 66 72 6f 6d 20 |object, |or from |
|00002ba0| 61 0a 5c 63 6f 64 65 7b | 2e 70 61 63 6b 5c 5f 61 |a.\code{|.pack\_a|
|00002bb0| 72 67 75 6d 65 6e 74 28 | 29 7d 2c 20 69 65 20 61 |rgument(|)}, ie a|
|00002bc0| 6e 20 4f 62 6a 43 50 6f | 69 6e 74 65 72 20 6f 62 |n ObjCPo|inter ob|
|00002bd0| 6a 65 63 74 2e 0a 5c 65 | 6e 64 7b 66 75 6e 63 64 |ject..\e|nd{funcd|
|00002be0| 65 73 63 7d 0a 0a 47 69 | 76 65 6e 20 74 68 65 20 |esc}..Gi|ven the |
|00002bf0| 4f 62 6a 65 63 74 69 76 | 65 2d 43 20 64 65 63 6c |Objectiv|e-C decl|
|00002c00| 61 72 61 74 69 6f 6e 20 | 61 62 6f 76 65 2c 20 74 |aration |above, t|
|00002c10| 6f 20 67 65 74 20 74 68 | 65 20 5c 76 61 72 7b 66 |o get th|e \var{f|
|00002c20| 72 61 6d 65 7d 20 6f 66 | 20 61 0a 5c 63 6f 64 65 |rame} of| a.\code|
|00002c30| 7b 53 71 75 61 72 65 7d | 20 6f 62 6a 65 63 74 20 |{Square}| object |
|00002c40| 79 6f 75 20 73 68 6f 75 | 6c 64 20 75 73 65 0a 0a |you shou|ld use..|
|00002c50| 5c 62 65 67 69 6e 7b 76 | 65 72 62 61 74 69 6d 7d |\begin{v|erbatim}|
|00002c60| 0a 3e 3e 3e 20 2e 2e 2e | 0a 3e 3e 3e 20 66 72 61 |.>>> ...|.>>> fra|
|00002c70| 6d 65 70 20 3d 20 6d 79 | 72 6f 6f 6d 2e 67 65 74 |mep = my|room.get|
|00002c80| 46 72 61 6d 65 5f 5f 2e | 70 61 63 6b 5f 61 72 67 |Frame__.|pack_arg|
|00002c90| 75 6d 65 6e 74 20 28 30 | 29 0a 3e 3e 3e 20 6d 79 |ument (0|).>>> my|
|00002ca0| 72 6f 6f 6d 2e 67 65 74 | 46 72 61 6d 65 5f 5f 20 |room.get|Frame__ |
|00002cb0| 28 66 72 61 6d 65 70 29 | 0a 3e 3e 3e 20 69 74 73 |(framep)|.>>> its|
|00002cc0| 46 72 61 6d 65 20 3d 20 | 6d 79 72 6f 6f 6d 2e 67 |Frame = |myroom.g|
|00002cd0| 65 74 46 72 61 6d 65 5f | 5f 2e 75 6e 70 61 63 6b |etFrame_|_.unpack|
|00002ce0| 5f 61 72 67 75 6d 65 6e | 74 20 28 30 2c 20 66 72 |_argumen|t (0, fr|
|00002cf0| 61 6d 65 70 29 0a 3e 3e | 3e 20 23 20 77 68 69 63 |amep).>>|> # whic|
|00002d00| 68 20 62 79 20 74 68 65 | 20 77 61 79 20 69 73 20 |h by the| way is |
|00002d10| 74 68 65 20 73 61 6d 65 | 20 61 73 0a 3e 3e 3e 20 |the same| as.>>> |
|00002d20| 69 74 73 46 72 61 6d 65 | 20 3d 20 66 72 61 6d 65 |itsFrame| = frame|
|00002d30| 70 2e 75 6e 70 61 63 6b | 28 29 0a 5c 65 6e 64 7b |p.unpack|().\end{|
|00002d40| 76 65 72 62 61 74 69 6d | 7d 0a 0a 4e 6f 74 65 20 |verbatim|}..Note |
|00002d50| 74 68 61 74 20 4f 62 6a | 43 4d 65 74 68 6f 64 20 |that Obj|CMethod |
|00002d60| 77 69 6c 6c 20 73 69 6c | 65 6e 74 6c 79 20 73 6c |will sil|ently sl|
|00002d70| 75 72 70 20 74 68 65 20 | 61 72 67 75 6d 65 6e 74 |urp the |argument|
|00002d80| 20 69 66 20 70 61 73 73 | 65 64 20 69 6e 20 74 68 | if pass|ed in th|
|00002d90| 65 0a 6e 6f 72 6d 61 6c | 20 77 61 79 2c 20 69 65 |e.normal| way, ie|
|00002da0| 20 6e 6f 74 20 69 6e 20 | 70 61 63 6b 65 64 20 66 | not in |packed f|
|00002db0| 6f 72 6d 2c 20 62 75 74 | 20 79 6f 75 20 77 6f 6e |orm, but| you won|
|00002dc0| 27 74 20 62 65 20 61 62 | 6c 65 20 74 6f 20 66 65 |'t be ab|le to fe|
|00002dd0| 74 63 68 20 69 74 73 0a | 6d 6f 64 69 66 69 65 64 |tch its.|modified|
|00002de0| 20 76 61 6c 75 65 2c 20 | 74 68 61 74 20 69 73 0a | value, |that is.|
|00002df0| 0a 5c 62 65 67 69 6e 7b | 76 65 72 62 61 74 69 6d |.\begin{|verbatim|
|00002e00| 7d 0a 3e 3e 3e 20 2e 2e | 2e 0a 3e 3e 3e 20 66 72 |}.>>> ..|..>>> fr|
|00002e10| 61 6d 65 20 3d 20 28 20 | 28 30 2e 30 2c 20 30 2e |ame = ( |(0.0, 0.|
|00002e20| 30 29 2c 20 28 30 2e 30 | 2c 20 30 2e 30 29 20 29 |0), (0.0|, 0.0) )|
|00002e30| 0a 3e 3e 3e 20 6d 79 72 | 6f 6f 6d 2e 67 65 74 46 |.>>> myr|oom.getF|
|00002e40| 72 61 6d 65 5f 5f 20 28 | 66 72 61 6d 65 29 0a 3e |rame__ (|frame).>|
|00002e50| 3e 3e 20 70 72 69 6e 74 | 20 66 72 61 6d 65 0a 3e |>> print| frame.>|
|00002e60| 3e 3e 20 28 28 30 2e 30 | 2c 30 2e 30 29 2c 28 30 |>> ((0.0|,0.0),(0|
|00002e70| 2e 30 2c 30 2e 30 29 29 | 0a 5c 65 6e 64 7b 76 65 |.0,0.0))|.\end{ve|
|00002e80| 72 62 61 74 69 6d 7d 0a | 0a 41 6e 20 4f 62 6a 43 |rbatim}.|.An ObjC|
|00002e90| 4d 65 74 68 6f 64 20 68 | 61 73 20 74 68 65 73 65 |Method h|as these|
|00002ea0| 20 64 61 74 61 20 6d 65 | 6d 62 65 72 73 3a 0a 0a | data me|mbers:..|
|00002eb0| 5c 62 65 67 69 6e 7b 64 | 61 74 61 64 65 73 63 7d |\begin{d|atadesc}|
|00002ec0| 7b 6e 61 6d 65 7d 0a 54 | 68 69 73 20 69 73 20 74 |{name}.T|his is t|
|00002ed0| 68 65 20 6e 61 6d 65 20 | 6f 66 20 74 68 65 20 4f |he name |of the O|
|00002ee0| 62 6a 43 20 73 65 6c 65 | 63 74 6f 72 20 74 68 69 |bjC sele|ctor thi|
|00002ef0| 73 20 6f 62 6a 65 63 74 | 20 69 73 20 77 72 61 70 |s object| is wrap|
|00002f00| 70 69 6e 67 2e 0a 5c 65 | 6e 64 7b 64 61 74 61 64 |ping..\e|nd{datad|
|00002f10| 65 73 63 7d 0a 0a 5c 62 | 65 67 69 6e 7b 64 61 74 |esc}..\b|egin{dat|
|00002f20| 61 64 65 73 63 7d 7b 5f | 5f 6d 65 6d 62 65 72 73 |adesc}{_|_members|
|00002f30| 5f 5f 7d 0a 54 68 65 20 | 6c 69 73 74 20 6f 66 20 |__}.The |list of |
|00002f40| 64 61 74 61 20 6d 65 6d | 62 65 72 73 20 6f 66 20 |data mem|bers of |
|00002f50| 74 68 69 73 20 6f 62 6a | 65 63 74 2e 0a 5c 65 6e |this obj|ect..\en|
|00002f60| 64 7b 64 61 74 61 64 65 | 73 63 7d 0a 0a 0a 5c 73 |d{datade|sc}...\s|
|00002f70| 75 62 73 65 63 74 69 6f | 6e 7b 4f 62 6a 43 50 6f |ubsectio|n{ObjCPo|
|00002f80| 69 6e 74 65 72 20 6f 62 | 6a 65 63 74 73 7d 0a 5c |inter ob|jects}.\|
|00002f90| 72 65 6e 65 77 63 6f 6d | 6d 61 6e 64 7b 5c 69 6e |renewcom|mand{\in|
|00002fa0| 64 65 78 73 75 62 69 74 | 65 6d 7d 7b 28 4f 62 6a |dexsubit|em}{(Obj|
|00002fb0| 43 50 6f 69 6e 74 65 72 | 20 6d 65 74 68 6f 64 29 |CPointer| method)|
|00002fc0| 7d 0a 0a 57 68 65 6e 20 | 61 20 4f 62 6a 65 63 74 |}..When |a Object|
|00002fd0| 69 76 65 2d 43 20 6d 65 | 74 68 6f 64 20 72 65 74 |ive-C me|thod ret|
|00002fe0| 75 72 6e 73 20 61 20 70 | 6f 69 6e 74 65 72 20 74 |urns a p|ointer t|
|00002ff0| 6f 20 73 6f 6d 65 74 68 | 69 6e 67 2c 20 74 68 69 |o someth|ing, thi|
|00003000| 73 20 76 61 6c 75 65 0a | 67 65 74 73 20 65 6e 63 |s value.|gets enc|
|00003010| 6f 64 65 64 20 69 6e 20 | 61 20 4f 62 6a 43 50 6f |oded in |a ObjCPo|
|00003020| 69 6e 74 65 72 20 69 6e | 73 74 61 6e 63 65 2c 20 |inter in|stance, |
|00003030| 74 68 61 74 20 79 6f 75 | 20 63 61 6e 20 66 65 65 |that you| can fee|
|00003040| 64 20 61 73 20 61 72 67 | 75 6d 65 6e 74 0a 6f 66 |d as arg|ument.of|
|00003050| 20 61 6e 6f 74 68 65 72 | 20 6d 65 74 68 6f 64 20 | another| method |
|00003060| 65 78 70 65 63 74 69 6e | 67 20 61 6e 20 65 71 75 |expectin|g an equ|
|00003070| 69 76 61 6c 65 6e 74 20 | 74 79 70 65 2e 0a 0a 54 |ivalent |type...T|
|00003080| 68 69 73 20 6b 69 6e 64 | 20 6f 66 20 6f 62 6a 65 |his kind| of obje|
|00003090| 63 74 73 20 6d 61 6b 65 | 20 69 74 20 65 61 73 69 |cts make| it easi|
|000030a0| 65 72 20 74 6f 20 61 63 | 63 65 73 73 20 74 68 65 |er to ac|cess the|
|000030b0| 69 72 20 63 6f 6e 74 65 | 6e 74 3a 20 61 73 20 61 |ir conte|nt: as a|
|000030c0| 0a 76 61 72 69 61 6e 74 | 20 6f 66 20 74 68 65 20 |.variant| of the |
|000030d0| 5c 63 6f 64 65 7b 2e 75 | 6e 70 61 63 6b 5c 5f 61 |\code{.u|npack\_a|
|000030e0| 72 67 75 6d 65 6e 74 28 | 29 7d 20 64 65 73 63 72 |rgument(|)} descr|
|000030f0| 69 62 65 64 20 61 62 6f | 76 65 2c 20 74 68 65 79 |ibed abo|ve, they|
|00003100| 0a 70 72 6f 76 69 64 65 | 20 74 68 65 20 66 6f 6c |.provide| the fol|
|00003110| 6c 6f 77 69 6e 67 20 6d | 65 74 68 6f 64 2e 0a 0a |lowing m|ethod...|
|00003120| 5c 62 65 67 69 6e 7b 66 | 75 6e 63 64 65 73 63 7d |\begin{f|uncdesc}|
|00003130| 7b 75 6e 70 61 63 6b 7d | 7b 7d 0a 54 68 69 73 20 |{unpack}|{}.This |
|00003140| 6d 65 74 68 6f 64 20 74 | 61 6b 65 73 20 74 68 65 |method t|akes the|
|00003150| 20 63 6f 6e 74 65 6e 74 | 20 6f 66 20 74 68 65 20 | content| of the |
|00003160| 70 6f 69 6e 74 65 64 20 | 76 61 6c 75 65 20 61 6e |pointed |value an|
|00003170| 64 20 75 6e 70 61 63 6b | 73 20 69 74 0a 61 63 63 |d unpack|s it.acc|
|00003180| 6f 72 64 69 6e 67 6c 79 | 20 74 6f 20 69 74 73 20 |ordingly| to its |
|00003190| 74 79 70 65 2c 20 74 68 | 65 6e 20 72 65 74 75 72 |type, th|en retur|
|000031a0| 6e 73 20 74 68 65 20 50 | 79 74 68 6f 6e 20 72 65 |ns the P|ython re|
|000031b0| 70 72 65 73 65 6e 74 61 | 74 69 6f 6e 20 6f 66 20 |presenta|tion of |
|000031c0| 69 74 2e 0a 5c 65 6e 64 | 7b 66 75 6e 63 64 65 73 |it..\end|{funcdes|
|000031d0| 63 7d 0a 0a 45 61 63 68 | 20 4f 62 6a 43 50 6f 69 |c}..Each| ObjCPoi|
|000031e0| 6e 74 65 72 20 63 61 72 | 72 69 65 73 20 74 68 65 |nter car|ries the|
|000031f0| 73 65 20 64 61 74 61 20 | 6d 65 6d 62 65 72 73 3a |se data |members:|
|00003200| 0a 0a 5c 62 65 67 69 6e | 7b 64 61 74 61 64 65 73 |..\begin|{datades|
|00003210| 63 7d 7b 74 79 70 65 7d | 0a 41 20 73 74 72 69 6e |c}{type}|.A strin|
|00003220| 67 20 6f 62 6a 65 63 74 | 20 63 6f 6e 74 61 69 6e |g object| contain|
|00003230| 69 6e 67 20 74 68 65 20 | 74 79 70 65 20 6f 66 20 |ing the |type of |
|00003240| 74 68 65 20 70 6f 69 6e | 74 65 64 20 76 61 6c 75 |the poin|ted valu|
|00003250| 65 2e 0a 5c 65 6e 64 7b | 64 61 74 61 64 65 73 63 |e..\end{|datadesc|
|00003260| 7d 0a 0a 5c 62 65 67 69 | 6e 7b 64 61 74 61 64 65 |}..\begi|n{datade|
|00003270| 73 63 7d 7b 70 6f 69 6e | 74 65 72 41 73 49 6e 74 |sc}{poin|terAsInt|
|00003280| 65 67 65 72 7d 0a 41 6e | 20 69 6e 74 65 67 65 72 |eger}.An| integer|
|00003290| 20 72 65 70 72 65 73 65 | 6e 74 61 74 69 6f 6e 20 | represe|ntation |
|000032a0| 6f 66 20 74 68 65 20 70 | 6f 69 6e 74 65 72 20 69 |of the p|ointer i|
|000032b0| 74 73 65 6c 66 2e 0a 5c | 65 6e 64 7b 64 61 74 61 |tself..\|end{data|
|000032c0| 64 65 73 63 7d 0a 0a 5c | 62 65 67 69 6e 7b 64 61 |desc}..\|begin{da|
|000032d0| 74 61 64 65 73 63 7d 7b | 5f 5f 6d 65 6d 62 65 72 |tadesc}{|__member|
|000032e0| 73 5f 5f 7d 0a 54 68 65 | 20 6c 69 73 74 20 6f 66 |s__}.The| list of|
|000032f0| 20 64 61 74 61 20 6d 65 | 6d 62 65 72 73 20 6f 66 | data me|mbers of|
|00003300| 20 74 68 69 73 20 6f 62 | 6a 65 63 74 2e 0a 5c 65 | this ob|ject..\e|
|00003310| 6e 64 7b 64 61 74 61 64 | 65 73 63 7d 0a 0a 0a 5c |nd{datad|esc}...\|
|00003320| 73 75 62 73 65 63 74 69 | 6f 6e 7b 4f 62 6a 65 63 |subsecti|on{Objec|
|00003330| 74 69 76 65 2d 43 20 65 | 6e 63 6f 64 69 6e 67 7d |tive-C e|ncoding}|
|00003340| 0a 0a 54 68 65 20 4f 62 | 6a 65 63 74 69 76 65 2d |..The Ob|jective-|
|00003350| 43 20 6c 61 6e 67 75 61 | 67 65 20 68 61 73 20 61 |C langua|ge has a|
|00003360| 20 63 6f 6d 70 69 6c 65 | 72 20 64 69 72 65 63 74 | compile|r direct|
|00003370| 69 76 65 2c 20 5c 64 66 | 6e 7b 40 65 6e 63 6f 64 |ive, \df|n{@encod|
|00003380| 65 7d 2c 20 74 68 61 74 | 0a 77 68 65 6e 20 67 69 |e}, that|.when gi|
|00003390| 76 65 6e 20 61 20 74 79 | 70 65 20 73 70 65 63 69 |ven a ty|pe speci|
|000033a0| 66 69 63 61 74 69 6f 6e | 20 72 65 74 75 72 6e 73 |fication| returns|
|000033b0| 20 61 20 73 74 72 69 6e | 67 20 65 6e 63 6f 64 69 | a strin|g encodi|
|000033c0| 6e 67 20 74 68 61 74 20 | 74 79 70 65 2e 0a 54 68 |ng that |type..Th|
|000033d0| 65 20 74 79 70 65 20 63 | 61 6e 20 62 65 20 61 20 |e type c|an be a |
|000033e0| 62 61 73 69 63 20 74 79 | 70 65 20 73 75 63 68 20 |basic ty|pe such |
|000033f0| 61 73 20 61 6e 20 69 6e | 74 2c 20 61 20 70 6f 69 |as an in|t, a poi|
|00003400| 6e 74 65 72 2c 20 61 20 | 74 61 67 67 65 64 0a 73 |nter, a |tagged.s|
|00003410| 74 72 75 63 74 75 72 65 | 20 6f 72 20 75 6e 69 6f |tructure| or unio|
|00003420| 6e 2c 20 6f 72 20 61 20 | 63 6c 61 73 73 20 6e 61 |n, or a |class na|
|00003430| 6d 65 20 2d 2d 20 61 6e | 79 74 68 69 6e 67 2c 20 |me -- an|ything, |
|00003440| 69 6e 20 66 61 63 74 2c | 20 74 68 61 74 20 63 61 |in fact,| that ca|
|00003450| 6e 20 62 65 0a 75 73 65 | 64 20 61 73 20 61 6e 20 |n be.use|d as an |
|00003460| 61 72 67 75 6d 65 6e 74 | 20 74 6f 20 74 68 65 20 |argument| to the |
|00003470| 43 20 5c 63 6f 64 65 7b | 73 69 7a 65 6f 66 28 29 |C \code{|sizeof()|
|00003480| 7d 20 6f 70 65 72 61 74 | 6f 72 2e 0a 0a 46 6f 72 |} operat|or...For|
|00003490| 20 65 78 61 6d 70 6c 65 | 3a 0a 5c 62 65 67 69 6e | example|:.\begin|
|000034a0| 7b 76 65 72 62 61 74 69 | 6d 7d 0a 63 68 61 72 20 |{verbati|m}.char |
|000034b0| 2a 65 31 20 3d 20 40 65 | 6e 63 6f 64 65 28 69 6e |*e1 = @e|ncode(in|
|000034c0| 74 20 2a 2a 29 3b 0a 09 | 3d 3e 20 5e 5e 69 0a 63 |t **);..|=> ^^i.c|
|000034d0| 68 61 72 20 2a 65 32 20 | 3d 20 40 65 6e 63 6f 64 |har *e2 |= @encod|
|000034e0| 65 28 66 6c 6f 61 74 5b | 31 32 5d 29 3b 0a 09 3d |e(float[|12]);..=|
|000034f0| 3e 20 5b 31 32 66 5d 0a | 63 68 61 72 20 2a 65 33 |> [12f].|char *e3|
|00003500| 20 3d 20 40 65 6e 63 6f | 64 65 28 50 79 53 74 72 | = @enco|de(PyStr|
|00003510| 69 6e 67 4f 62 6a 65 63 | 74 20 2a 29 3b 0a 09 3d |ingObjec|t *);..=|
|00003520| 3e 20 5e 7b 3f 3d 69 5e | 7b 5f 74 79 70 65 6f 62 |> ^{?=i^|{_typeob|
|00003530| 6a 65 63 74 7d 69 6c 5b | 31 63 5d 7d 0a 5c 65 6e |ject}il[|1c]}.\en|
|00003540| 64 7b 76 65 72 62 61 74 | 69 6d 7d 0a 0a 54 68 65 |d{verbat|im}..The|
|00003550| 20 4f 62 6a 43 20 6d 6f | 64 75 6c 65 20 74 72 69 | ObjC mo|dule tri|
|00003560| 65 73 20 74 6f 20 68 69 | 64 65 20 61 73 20 6d 75 |es to hi|de as mu|
|00003570| 63 68 20 61 73 20 70 6f | 73 73 69 62 6c 65 20 74 |ch as po|ssible t|
|00003580| 68 65 73 65 20 64 65 74 | 61 69 6c 73 2c 20 62 75 |hese det|ails, bu|
|00003590| 74 0a 6e 65 76 65 72 74 | 68 65 6c 65 73 73 20 79 |t.nevert|heless y|
|000035a0| 6f 75 20 6d 61 79 20 66 | 69 6e 64 20 75 73 65 66 |ou may f|ind usef|
|000035b0| 75 6c 6c 20 74 6f 20 75 | 6e 64 65 72 73 74 61 6e |ull to u|nderstan|
|000035c0| 64 20 74 68 65 20 6d 65 | 63 68 61 6e 69 73 6d 3a |d the me|chanism:|
|000035d0| 20 77 68 65 6e 0a 79 6f | 75 20 70 61 73 73 20 61 | when.yo|u pass a|
|000035e0| 20 77 72 6f 6e 67 20 61 | 72 67 75 6d 65 6e 74 20 | wrong a|rgument |
|000035f0| 74 6f 20 61 6e 20 4f 62 | 6a 43 20 6d 65 73 73 61 |to an Ob|jC messa|
|00003600| 67 65 2c 20 74 68 65 20 | 65 78 63 65 70 74 69 6f |ge, the |exceptio|
|00003610| 6e 20 72 61 69 73 65 64 | 0a 63 6f 6e 74 61 69 6e |n raised|.contain|
|00003620| 73 20 74 68 65 20 40 65 | 6e 63 6f 64 65 64 20 64 |s the @e|ncoded d|
|00003630| 65 73 63 72 69 70 74 69 | 6f 6e 20 6f 66 20 74 68 |escripti|on of th|
|00003640| 65 20 65 78 70 65 63 74 | 65 64 20 74 79 70 65 20 |e expect|ed type |
|00003650| 66 6f 72 20 74 68 61 74 | 0a 61 72 67 75 6d 65 6e |for that|.argumen|
|00003660| 74 2c 20 61 6e 64 20 75 | 73 69 6e 67 20 74 68 65 |t, and u|sing the|
|00003670| 20 69 6e 66 6f 72 6d 61 | 74 69 6f 6e 20 62 65 6c | informa|tion bel|
|00003680| 6f 77 20 79 6f 75 20 73 | 68 6f 75 6c 64 20 62 65 |ow you s|hould be|
|00003690| 20 61 62 6c 65 20 74 6f | 0a 63 6f 72 72 65 63 74 | able to|.correct|
|000036a0| 6c 79 20 63 6f 6e 73 74 | 72 75 63 74 20 74 68 65 |ly const|ruct the|
|000036b0| 20 6e 65 65 64 65 64 20 | 76 61 6c 75 65 2e 0a 0a | needed |value...|
|000036c0| 54 68 65 20 74 61 62 6c | 65 20 62 65 6c 6f 77 20 |The tabl|e below |
|000036d0| 6c 69 73 74 73 20 74 68 | 65 20 63 68 61 72 61 63 |lists th|e charac|
|000036e0| 74 65 72 73 20 75 73 65 | 64 20 62 79 20 74 68 69 |ters use|d by thi|
|000036f0| 73 20 6d 65 63 68 61 6e | 69 73 6d 2c 20 77 69 74 |s mechan|ism, wit|
|00003700| 68 0a 74 68 65 69 72 20 | 6d 65 61 6e 69 6e 67 73 |h.their |meanings|
|00003710| 2e 20 54 68 65 20 74 68 | 69 72 64 20 63 6f 6c 75 |. The th|ird colu|
|00003720| 6d 6e 20 74 65 6c 6c 73 | 20 68 6f 77 20 74 68 65 |mn tells| how the|
|00003730| 20 70 61 72 74 69 63 75 | 6c 61 72 20 69 74 65 6d | particu|lar item|
|00003740| 20 74 79 70 65 0a 6d 61 | 74 63 68 65 73 20 77 69 | type.ma|tches wi|
|00003750| 74 68 20 74 68 65 20 50 | 79 74 68 6f 6e 20 6f 62 |th the P|ython ob|
|00003760| 6a 65 63 74 73 2e 20 41 | 73 20 70 6f 69 6e 74 65 |jects. A|s pointe|
|00003770| 64 20 6f 75 74 20 61 62 | 6f 76 65 2c 20 79 6f 75 |d out ab|ove, you|
|00003780| 20 63 61 6e 0a 69 6e 64 | 69 66 66 65 72 65 6e 74 | can.ind|ifferent|
|00003790| 6c 79 20 70 61 73 73 20 | 61 6e 20 69 6e 74 65 67 |ly pass |an integ|
|000037a0| 65 72 20 6f 72 20 61 20 | 73 74 72 69 6e 67 20 66 |er or a |string f|
|000037b0| 6f 72 20 61 6e 20 61 72 | 67 75 6d 65 6e 74 20 6f |or an ar|gument o|
|000037c0| 66 20 74 79 70 65 0a 5c | 63 6f 64 65 7b 63 68 61 |f type.\|code{cha|
|000037d0| 72 7d 2c 20 62 75 74 20 | 74 68 65 20 6d 6f 64 75 |r}, but |the modu|
|000037e0| 6c 65 20 74 72 61 6e 73 | 6c 61 74 65 73 20 73 75 |le trans|lates su|
|000037f0| 63 68 20 76 61 6c 75 65 | 73 20 74 6f 20 69 6e 74 |ch value|s to int|
|00003800| 65 67 65 72 73 20 77 68 | 65 6e 0a 74 68 65 79 20 |egers wh|en.they |
|00003810| 61 72 65 20 72 65 74 75 | 72 6e 65 64 20 62 79 20 |are retu|rned by |
|00003820| 61 20 6d 65 74 68 6f 64 | 2e 0a 0a 5c 62 65 67 69 |a method|...\begi|
|00003830| 6e 7b 74 61 62 6c 65 69 | 69 69 7d 7b 7c 63 7c 6c |n{tablei|ii}{|c|l|
|00003840| 7c 63 7c 7d 7b 63 6f 64 | 65 7d 7b 43 6f 64 65 7d ||c|}{cod|e}{Code}|
|00003850| 7b 4d 65 61 6e 69 6e 67 | 7d 7b 50 79 74 68 6f 6e |{Meaning|}{Python|
|00003860| 20 45 71 75 69 76 61 6c | 65 6e 74 7d 0a 5c 6c 69 | Equival|ent}.\li|
|00003870| 6e 65 69 69 69 7b 63 7d | 7b 41 20 63 68 61 72 7d |neiii{c}|{A char}|
|00003880| 7b 50 79 49 6e 74 4f 62 | 6a 65 63 74 20 6f 72 20 |{PyIntOb|ject or |
|00003890| 50 79 53 74 72 69 6e 67 | 4f 62 6a 65 63 74 7d 0a |PyString|Object}.|
|000038a0| 5c 6c 69 6e 65 69 69 69 | 7b 69 7d 7b 41 6e 20 69 |\lineiii|{i}{An i|
|000038b0| 6e 74 7d 7b 50 79 49 6e | 74 4f 62 6a 65 63 74 7d |nt}{PyIn|tObject}|
|000038c0| 0a 5c 6c 69 6e 65 69 69 | 69 7b 73 7d 7b 41 20 73 |.\lineii|i{s}{A s|
|000038d0| 68 6f 72 74 7d 7b 50 79 | 49 6e 74 4f 62 6a 65 63 |hort}{Py|IntObjec|
|000038e0| 74 7d 0a 5c 6c 69 6e 65 | 69 69 69 7b 6c 7d 7b 41 |t}.\line|iii{l}{A|
|000038f0| 20 6c 6f 6e 67 7d 7b 50 | 79 49 6e 74 4f 62 6a 65 | long}{P|yIntObje|
|00003900| 63 74 7d 0a 5c 6c 69 6e | 65 69 69 69 7b 43 7d 7b |ct}.\lin|eiii{C}{|
|00003910| 41 6e 20 75 6e 73 69 67 | 6e 65 64 20 63 68 61 72 |An unsig|ned char|
|00003920| 7d 7b 50 79 49 6e 74 4f | 62 6a 65 63 74 20 6f 72 |}{PyIntO|bject or|
|00003930| 20 50 79 53 74 72 69 6e | 67 4f 62 6a 65 63 74 7d | PyStrin|gObject}|
|00003940| 0a 5c 6c 69 6e 65 69 69 | 69 7b 49 7d 7b 41 6e 20 |.\lineii|i{I}{An |
|00003950| 75 6e 73 69 67 6e 65 64 | 20 69 6e 74 7d 7b 50 79 |unsigned| int}{Py|
|00003960| 49 6e 74 4f 62 6a 65 63 | 74 7d 0a 5c 6c 69 6e 65 |IntObjec|t}.\line|
|00003970| 69 69 69 7b 53 7d 7b 41 | 6e 20 75 6e 73 69 67 6e |iii{S}{A|n unsign|
|00003980| 65 64 20 73 68 6f 72 74 | 7d 7b 50 79 49 6e 74 4f |ed short|}{PyIntO|
|00003990| 62 6a 65 63 74 7d 0a 5c | 6c 69 6e 65 69 69 69 7b |bject}.\|lineiii{|
|000039a0| 4c 7d 7b 41 6e 20 75 6e | 73 69 67 6e 65 64 20 6c |L}{An un|signed l|
|000039b0| 6f 6e 67 7d 7b 50 79 49 | 6e 74 4f 62 6a 65 63 74 |ong}{PyI|ntObject|
|000039c0| 7d 0a 5c 6c 69 6e 65 69 | 69 69 7b 66 7d 7b 41 20 |}.\linei|ii{f}{A |
|000039d0| 66 6c 6f 61 74 7d 7b 50 | 79 46 6c 6f 61 74 4f 62 |float}{P|yFloatOb|
|000039e0| 6a 65 63 74 20 6f 72 20 | 50 79 49 6e 74 4f 62 6a |ject or |PyIntObj|
|000039f0| 65 63 74 7d 0a 5c 6c 69 | 6e 65 69 69 69 7b 64 7d |ect}.\li|neiii{d}|
|00003a00| 7b 41 20 64 6f 75 62 6c | 65 7d 7b 50 79 46 6c 6f |{A doubl|e}{PyFlo|
|00003a10| 61 74 4f 62 6a 65 63 74 | 20 6f 72 20 50 79 49 6e |atObject| or PyIn|
|00003a20| 74 4f 62 6a 65 63 74 7d | 0a 5c 6c 69 6e 65 69 69 |tObject}|.\lineii|
|00003a30| 69 7b 76 7d 7b 41 20 76 | 6f 69 64 7d 7b 7d 0a 5c |i{v}{A v|oid}{}.\|
|00003a40| 6c 69 6e 65 69 69 69 7b | 2a 7d 7b 41 20 63 68 61 |lineiii{|*}{A cha|
|00003a50| 72 61 63 74 65 72 20 73 | 74 72 69 6e 67 20 28 63 |racter s|tring (c|
|00003a60| 68 61 72 20 2a 29 7d 7b | 50 79 53 74 72 69 6e 67 |har *)}{|PyString|
|00003a70| 4f 62 6a 65 63 74 7d 0a | 5c 6c 69 6e 65 69 69 69 |Object}.|\lineiii|
|00003a80| 7b 40 7d 7b 41 6e 20 6f | 62 6a 65 63 74 20 28 69 |{@}{An o|bject (i|
|00003a90| 64 29 7d 7b 4f 62 6a 43 | 4f 62 6a 65 63 74 7d 0a |d)}{ObjC|Object}.|
|00003aa0| 5c 6c 69 6e 65 69 69 69 | 7b 5c 23 7d 7b 41 20 63 |\lineiii|{\#}{A c|
|00003ab0| 6c 61 73 73 20 6f 62 6a | 65 63 74 20 28 43 6c 61 |lass obj|ect (Cla|
|00003ac0| 73 73 29 7d 7b 4f 62 6a | 43 4f 62 6a 65 63 74 7d |ss)}{Obj|CObject}|
|00003ad0| 0a 5c 6c 69 6e 65 69 69 | 69 7b 3a 7d 7b 41 20 6d |.\lineii|i{:}{A m|
|00003ae0| 65 74 68 6f 64 20 73 65 | 6c 65 63 74 6f 72 20 28 |ethod se|lector (|
|00003af0| 53 45 4c 29 7d 7b 4f 62 | 6a 43 4d 65 74 68 6f 64 |SEL)}{Ob|jCMethod|
|00003b00| 20 6f 72 20 50 79 53 74 | 72 69 6e 67 4f 62 6a 65 | or PySt|ringObje|
|00003b10| 63 74 7d 0a 5c 6c 69 6e | 65 69 69 69 7b 5b 2e 2e |ct}.\lin|eiii{[..|
|00003b20| 2e 5d 7d 7b 41 6e 20 61 | 72 72 61 79 7d 7b 50 79 |.]}{An a|rray}{Py|
|00003b30| 54 75 70 6c 65 4f 62 6a | 65 63 74 7d 0a 5c 6c 69 |TupleObj|ect}.\li|
|00003b40| 6e 65 69 69 69 7b 5c 7b | 2e 2e 2e 5c 7d 7d 7b 41 |neiii{\{|...\}}{A|
|00003b50| 20 73 74 72 75 63 74 75 | 72 65 7d 7b 50 79 54 75 | structu|re}{PyTu|
|00003b60| 70 6c 65 4f 62 6a 65 63 | 74 7d 0a 5c 6c 69 6e 65 |pleObjec|t}.\line|
|00003b70| 69 69 69 7b 28 2e 2e 2e | 29 7d 7b 41 20 75 6e 69 |iii{(...|)}{A uni|
|00003b80| 6f 6e 7d 7b 4f 62 6a 43 | 50 6f 69 6e 74 65 72 20 |on}{ObjC|Pointer |
|00003b90| 6f 72 20 50 79 53 74 72 | 69 6e 67 4f 62 6a 65 63 |or PyStr|ingObjec|
|00003ba0| 74 7d 0a 5c 6c 69 6e 65 | 69 69 69 7b 62 6e 75 6d |t}.\line|iii{bnum|
|00003bb0| 7d 7b 41 20 62 69 74 66 | 69 65 6c 64 20 6f 66 20 |}{A bitf|ield of |
|00003bc0| 6e 75 6d 20 62 69 74 73 | 7d 7b 6e 6f 74 20 68 61 |num bits|}{not ha|
|00003bd0| 6e 64 6c 65 64 7d 0a 5c | 6c 69 6e 65 69 69 69 7b |ndled}.\|lineiii{|
|00003be0| 5c 5e 74 79 70 65 7d 7b | 41 20 70 6f 69 6e 74 65 |\^type}{|A pointe|
|00003bf0| 72 20 74 6f 20 74 79 70 | 65 7d 7b 76 61 6c 75 65 |r to typ|e}{value|
|00003c00| 20 66 6f 72 20 74 79 70 | 65 7d 0a 5c 6c 69 6e 65 | for typ|e}.\line|
|00003c10| 69 69 69 7b 3f 7d 7b 41 | 6e 20 75 6e 6b 6e 6f 77 |iii{?}{A|n unknow|
|00003c20| 6e 20 74 79 70 65 7d 7b | 7d 0a 5c 65 6e 64 7b 74 |n type}{|}.\end{t|
|00003c30| 61 62 6c 65 69 69 69 7d | 0a 0a 54 68 65 20 74 79 |ableiii}|..The ty|
|00003c40| 70 65 20 73 70 65 63 69 | 66 69 63 61 74 69 6f 6e |pe speci|fication|
|00003c50| 20 66 6f 72 20 61 6e 20 | 61 72 72 61 79 20 69 73 | for an |array is|
|00003c60| 20 65 6e 63 6c 6f 73 65 | 64 20 77 69 74 68 69 6e | enclose|d within|
|00003c70| 20 73 71 75 61 72 65 0a | 62 72 61 63 6b 65 74 73 | square.|brackets|
|00003c80| 3b 20 74 68 65 20 6e 75 | 6d 62 65 72 20 6f 66 20 |; the nu|mber of |
|00003c90| 65 6c 65 6d 65 6e 74 73 | 20 69 6e 20 74 68 65 20 |elements| in the |
|00003ca0| 61 72 72 61 79 20 69 73 | 20 73 70 65 63 69 66 69 |array is| specifi|
|00003cb0| 65 64 20 69 6d 6d 65 64 | 69 61 74 65 6c 79 0a 61 |ed immed|iately.a|
|00003cc0| 66 74 65 72 20 74 68 65 | 20 6f 70 65 6e 20 62 72 |fter the| open br|
|00003cd0| 61 63 6b 65 74 2c 20 62 | 65 66 6f 72 65 20 74 68 |acket, b|efore th|
|00003ce0| 65 20 61 72 72 61 79 20 | 74 79 70 65 2e 20 20 46 |e array |type. F|
|00003cf0| 6f 72 20 65 78 61 6d 70 | 6c 65 2c 20 61 6e 20 61 |or examp|le, an a|
|00003d00| 72 72 61 79 0a 6f 66 20 | 31 32 20 70 6f 69 6e 74 |rray.of |12 point|
|00003d10| 65 72 73 20 74 6f 20 5c | 63 6f 64 65 7b 66 6c 6f |ers to \|code{flo|
|00003d20| 61 74 73 7d 20 77 6f 75 | 6c 64 20 62 65 20 65 6e |ats} wou|ld be en|
|00003d30| 63 6f 64 65 64 20 61 73 | 3a 0a 0a 5c 62 65 67 69 |coded as|:..\begi|
|00003d40| 6e 7b 76 65 72 62 61 74 | 69 6d 7d 0a 5b 31 32 5e |n{verbat|im}.[12^|
|00003d50| 66 5d 0a 5c 65 6e 64 7b | 76 65 72 62 61 74 69 6d |f].\end{|verbatim|
|00003d60| 7d 0a 0a 53 74 72 75 63 | 74 75 72 65 73 20 61 72 |}..Struc|tures ar|
|00003d70| 65 20 73 70 65 63 69 66 | 69 65 64 20 77 69 74 68 |e specif|ied with|
|00003d80| 69 6e 20 62 72 61 63 65 | 73 2c 20 61 6e 64 20 75 |in brace|s, and u|
|00003d90| 6e 69 6f 6e 73 20 77 69 | 74 68 69 6e 20 70 61 72 |nions wi|thin par|
|00003da0| 65 6e 74 68 65 73 65 73 | 2e 0a 54 68 65 20 73 74 |entheses|..The st|
|00003db0| 72 75 63 74 75 72 65 20 | 74 61 67 20 69 73 20 6c |ructure |tag is l|
|00003dc0| 69 73 74 65 64 20 66 69 | 72 73 74 2c 20 66 6f 6c |isted fi|rst, fol|
|00003dd0| 6c 6f 77 65 64 20 62 79 | 20 61 6e 20 65 71 75 61 |lowed by| an equa|
|00003de0| 6c 20 73 69 67 6e 20 61 | 6e 64 20 74 68 65 0a 63 |l sign a|nd the.c|
|00003df0| 6f 64 65 73 20 66 6f 72 | 20 74 68 65 20 66 69 65 |odes for| the fie|
|00003e00| 6c 64 73 20 6f 66 20 74 | 68 65 20 73 74 72 75 63 |lds of t|he struc|
|00003e10| 74 75 72 65 20 6c 69 73 | 74 65 64 20 69 6e 20 73 |ture lis|ted in s|
|00003e20| 65 71 75 65 6e 63 65 2e | 20 20 46 6f 72 0a 65 78 |equence.| For.ex|
|00003e30| 61 6d 70 6c 65 2c 20 74 | 68 69 73 20 73 74 72 75 |ample, t|his stru|
|00003e40| 63 74 75 72 65 2c 0a 0a | 5c 62 65 67 69 6e 7b 76 |cture,..|\begin{v|
|00003e50| 65 72 62 61 74 69 6d 7d | 0a 74 79 70 65 64 65 66 |erbatim}|.typedef|
|00003e60| 20 73 74 72 75 63 74 20 | 65 78 61 6d 70 6c 65 0a | struct |example.|
|00003e70| 7b 0a 20 20 69 64 20 61 | 6e 4f 62 6a 65 63 74 3b |{. id a|nObject;|
|00003e80| 0a 20 20 63 68 61 72 20 | 2a 61 53 74 72 69 6e 67 |. char |*aString|
|00003e90| 3b 0a 20 20 69 6e 74 20 | 61 6e 49 6e 74 3b 0a 7d |;. int |anInt;.}|
|00003ea0| 20 45 78 61 6d 70 6c 65 | 3b 0a 5c 65 6e 64 7b 76 | Example|;.\end{v|
|00003eb0| 65 72 62 61 74 69 6d 7d | 0a 0a 77 6f 75 6c 64 20 |erbatim}|..would |
|00003ec0| 62 65 20 65 6e 63 6f 64 | 65 64 20 6c 69 6b 65 20 |be encod|ed like |
|00003ed0| 74 68 69 73 3a 0a 0a 5c | 62 65 67 69 6e 7b 76 65 |this:..\|begin{ve|
|00003ee0| 72 62 61 74 69 6d 7d 0a | 7b 65 78 61 6d 70 6c 65 |rbatim}.|{example|
|00003ef0| 3d 40 2a 69 7d 0a 5c 65 | 6e 64 7b 76 65 72 62 61 |=@*i}.\e|nd{verba|
|00003f00| 74 69 6d 7d 0a 0a 54 68 | 65 20 73 61 6d 65 20 65 |tim}..Th|e same e|
|00003f10| 6e 63 6f 64 69 6e 67 20 | 72 65 73 75 6c 74 73 20 |ncoding |results |
|00003f20| 77 68 65 74 68 65 72 20 | 74 68 65 20 64 65 66 69 |whether |the defi|
|00003f30| 6e 65 64 20 74 79 70 65 | 20 6e 61 6d 65 20 28 45 |ned type| name (E|
|00003f40| 78 61 6d 70 6c 65 29 20 | 6f 72 0a 74 68 65 20 73 |xample) |or.the s|
|00003f50| 74 72 75 63 74 75 72 65 | 20 74 61 67 20 28 65 78 |tructure| tag (ex|
|00003f60| 61 6d 70 6c 65 29 20 69 | 73 20 70 61 73 73 65 64 |ample) i|s passed|
|00003f70| 20 74 6f 20 40 65 6e 63 | 6f 64 65 28 29 2e 20 20 | to @enc|ode(). |
|00003f80| 54 68 65 20 65 6e 63 6f | 64 69 6e 67 20 66 6f 72 |The enco|ding for|
|00003f90| 0a 61 20 73 74 72 75 63 | 74 75 72 65 20 70 6f 69 |.a struc|ture poi|
|00003fa0| 6e 74 65 72 20 63 61 72 | 72 69 65 73 20 74 68 65 |nter car|ries the|
|00003fb0| 20 73 61 6d 65 20 61 6d | 6f 75 6e 74 20 6f 66 20 | same am|ount of |
|00003fc0| 69 6e 66 6f 72 6d 61 74 | 69 6f 6e 20 61 62 6f 75 |informat|ion abou|
|00003fd0| 74 20 74 68 65 0a 73 74 | 72 75 63 74 75 72 65 27 |t the.st|ructure'|
|00003fe0| 73 20 66 69 65 6c 64 73 | 3a 0a 0a 5c 62 65 67 69 |s fields|:..\begi|
|00003ff0| 6e 7b 76 65 72 62 61 74 | 69 6d 7d 0a 5e 7b 65 78 |n{verbat|im}.^{ex|
|00004000| 61 6d 70 6c 65 3d 40 2a | 69 7d 0a 5c 65 6e 64 7b |ample=@*|i}.\end{|
|00004010| 76 65 72 62 61 74 69 6d | 7d 0a 0a 48 6f 77 65 76 |verbatim|}..Howev|
|00004020| 65 72 2c 20 61 6e 6f 74 | 68 65 72 20 6c 65 76 65 |er, anot|her leve|
|00004030| 6c 20 6f 66 20 69 6e 64 | 69 72 65 63 74 69 6f 6e |l of ind|irection|
|00004040| 20 72 65 6d 6f 76 65 73 | 20 74 68 65 20 69 6e 74 | removes| the int|
|00004050| 65 72 6e 61 6c 20 74 79 | 70 65 0a 73 70 65 63 69 |ernal ty|pe.speci|
|00004060| 66 69 63 61 74 69 6f 6e | 3a 0a 0a 5c 62 65 67 69 |fication|:..\begi|
|00004070| 6e 7b 76 65 72 62 61 74 | 69 6d 7d 0a 5e 5e 7b 65 |n{verbat|im}.^^{e|
|00004080| 78 61 6d 70 6c 65 7d 0a | 5c 65 6e 64 7b 76 65 72 |xample}.|\end{ver|
|00004090| 62 61 74 69 6d 7d 0a 0a | 49 6e 74 65 72 6e 61 6c |batim}..|Internal|
|000040a0| 6c 79 2c 20 74 68 65 20 | 6d 6f 64 75 6c 65 20 75 |ly, the |module u|
|000040b0| 73 65 73 20 74 77 6f 20 | 66 75 6e 63 74 69 6f 6e |ses two |function|
|000040c0| 73 2c 20 5c 63 6f 64 65 | 7b 70 79 74 68 6f 6e 69 |s, \code|{pythoni|
|000040d0| 66 79 5f 63 5f 76 61 6c | 75 65 28 29 7d 0a 61 6e |fy_c_val|ue()}.an|
|000040e0| 64 20 5c 63 6f 64 65 7b | 64 65 70 79 74 68 6f 6e |d \code{|depython|
|000040f0| 69 66 79 5f 63 5f 76 61 | 6c 75 65 28 29 7d 20 74 |ify_c_va|lue()} t|
|00004100| 6f 20 74 72 61 6e 73 6c | 61 74 65 20 61 20 43 20 |o transl|ate a C |
|00004110| 76 61 6c 75 65 20 69 6e | 74 6f 20 74 68 65 0a 63 |value in|to the.c|
|00004120| 6f 72 72 65 73 70 6f 6e | 64 69 6e 67 20 50 79 74 |orrespon|ding Pyt|
|00004130| 68 6f 6e 20 6f 62 6a 65 | 63 74 20 61 6e 64 20 76 |hon obje|ct and v|
|00004140| 69 63 65 76 65 72 73 61 | 2e 20 45 76 65 6e 74 75 |iceversa|. Eventu|
|00004150| 61 6c 6c 79 2c 20 69 6e | 20 74 68 65 20 66 75 74 |ally, in| the fut|
|00004160| 75 72 65 2c 0a 74 68 65 | 73 65 20 66 75 6e 63 74 |ure,.the|se funct|
|00004170| 69 6f 6e 73 20 77 69 6c | 6c 20 62 65 20 6d 6f 76 |ions wil|l be mov|
|00004180| 65 64 20 69 6e 74 6f 20 | 61 6e 20 69 6e 64 69 70 |ed into |an indip|
|00004190| 65 6e 64 65 6e 74 20 6d | 6f 64 75 6c 65 2c 20 73 |endent m|odule, s|
|000041a0| 6f 20 74 68 61 74 20 74 | 68 65 79 0a 6d 61 79 20 |o that t|hey.may |
|000041b0| 72 65 70 6c 61 63 65 20 | 74 68 65 20 5c 63 6f 64 |replace |the \cod|
|000041c0| 65 7b 73 74 72 75 63 74 | 7d 20 6d 6f 64 75 6c 65 |e{struct|} module|
|000041d0| 27 73 20 66 75 6e 63 74 | 69 6f 6e 61 6c 69 74 69 |'s funct|ionaliti|
|000041e0| 65 73 2e 0a 0a 25 25 20 | 4c 6f 63 61 6c 20 56 61 |es...%% |Local Va|
|000041f0| 72 69 61 62 6c 65 73 3a | 0a 25 25 20 63 68 61 6e |riables:|.%% chan|
|00004200| 67 65 2d 6c 6f 67 2d 64 | 65 66 61 75 6c 74 2d 6e |ge-log-d|efault-n|
|00004210| 61 6d 65 3a 22 2e 2e 2f | 43 68 61 6e 67 65 4c 6f |ame:"../|ChangeLo|
|00004220| 67 2e 50 79 4f 62 6a 43 | 22 0a 25 25 20 45 6e 64 |g.PyObjC|".%% End|
|00004230| 3a 0a 0a | |:.. | |
+--------+-------------------------+-------------------------+--------+--------+
