TweetFollow Us on Twitter

May 96 Tips
Volume Number:12
Issue Number:5
Column Tag:Tips & Tidbits

Tips & Tidbits

By Steve Sisak

Note: Source code files accompanying article are located on MacTech CD-ROM or source code disks.

Invoking Handlers in Scripts, by Name

This is completely undocumented, as far as I know, but it may help. Suppose you have a script application containing a function:

on DoSomething(param1,param2)
 return param1+param2
end DoSomething

From C, you just have to send the script application an Apple event like this one:

CLASS: ascr

type: psbr

direct object: "----" "LIST"

(the list of AEDescs of parameters to pass to the script function)

additional parameter: "snam" "TEXT"

containing the name of the function to call (in our example: “DoSomething”)

et voilà.

This method allows to write “clean” scripts, using more memorable handler names, not using the «CLASStype» syntax.

Pierre-Loic Raynaud

[This event is called “Subroutine Call” and is described in more detail in Chapter 10 of the Apple Event Registry, “The AppleScript Suite”. On the Developer Mailing Reference Library CD, the pdf file is named “AppleScript Suite”, and the information is on pdf page 5 (paper page 7). - jk]

Swapping Bytes in a High Level Language,
the Saga Continues!

You have probably been swamped with everyone’s comments regarding the “Anti-Tip of the Month” that appeared in MacTech Magazine 11.10 (October 1995).

Greg Poole had the right idea when he submitted his tip about byte-swapping. You can tweak code until your fingers fall off, but often the best way to make something faster is by finding a better way of doing the same thing.

I have attached two files to this message: ByteSwap.c & ByteSwap.h. In a nutshell, we do our swapping as follows:

ByteSwap.h
#define SwapShort(myUnsignedShort)  \
 ((myUnsignedShort)>>8)|((myUnsignedShort)<<8)

In use:

{
    unsigned short someValue = 0x3210;
    someValue = SwapShort(someValue);
}

We quite simply move the hi-byte right, and the lo-byte left, then OR them back together.


ByteSwap.c
#include "byteswap.h"

unsigned long TransposeLong(unsigned long value)
{
  unsigned long   returnValue;
  ((unsigned char *) &returnValue)[3] = 
 ((unsigned char *) &value)[0];
  ((unsigned char *) &returnValue)[2] = 
 ((unsigned char *) &value)[1];
  ((unsigned char *) &returnValue)[1] = 
 ((unsigned char *) &value)[2];
  ((unsigned char *) &returnValue)[0] = 
 ((unsigned char *) &value)[3];
  return returnValue;
}

David Most

The Technical Editor Responds

There are quite a few methods available for byte swapping, but which algorithm is the best depends a great deal on the compiler and processor you are using. For instance, the PowerPC (and many other processors) have instructions specifically for this purpose. Unfortunately, since the C and C++ languages have not kept up with current processors (C is basically processor-independent PDP-11 assembly language), it is our job to trick the compiler into generating the correct code.

Some compilers provide directives for this purpose. For instance, if you are using CodeWarrior on a PowerPC you can just say:

inline long SwapLong(long val)
{
    return __XXXXX(val);  //  <<<need intrinsic for load byte-swapped>>>
}

You may notice that I’m using C++ inline functions here instead of C #defines. To quote the “Apple Unofficial C++ Style Guide” (develop 2, p. 209): “One of the most powerful features of the C++ language is the C preprocessor. Don’t use it.” Inline functions are not only more readable than preprocessor macros, but, because they limit side effects, allow the compiler more latitude in optimizing your code.

Barring that, we need to find something that we can say in C that can get bytes swapped without generating egregiously bad code. David’s solution is probably a good one for shorts because it is a pure mathematical expression, allowing the compiler to optimize it in any way it chooses. For longs, his solution is one of the safest, if you know nothing about the compiler and/or processor you’re building for. (I would, however, convert both to inline functions.)

However, if you do know something about your processor, you can do better. In the case of the PPC, you really want to get your compiler to emit a load byte-swapped instruction. On a 680x0, you have a little latitude. One trick that comes to mind is that the 680x0 has predecrement and postincrement addressing modes. This means that:

foo = *p++ and foo = *--p

are fast and (1 instruction)

foo = *++p and foo = *p--

are slow (3 instructions). Therefore we can swap a long on a 680x0 with:

inline long SwapLong(long val)
{
    Byte* p = ((Byte*) val)[4];  // 680x0’s are big-endian

 long val = *--p;
 val  = (val << 8) | *--p;
 val  = (val << 8) | *--p;
  return (val << 8) | *--p;
}

The PowerPC has only post-increment instructions, so this will generate lousy code. (If someone would like to time a bunch of approaches, I’d be glad to publish the results.)

I must say that the bottom line is: this is all a bunch of work that would be completely unnecessary if the C language had kept up with reality. Here’s my proposal to the ANSI committee:

Make littleendian and bigendian storage classifiers like const and volatile. Then I could just type:

typedef struct Foo
{
    littleendian long    bar;
    bigendian short      baz;
} Foo;

void blah(Foo* foo)
{
    long  bar = foo->bar;
    short baz = foo->baz;

    ...
}

...and let the compiler deal with it while I spend my time writing code which does real work.

- sgs

Fix For Tip Of The Month, January 1996

I’m sending this short note just to point out that, although Greg Poole is right in writing that a file or directory can be moved by the CatMove function only if both the source and destination are on the same volume, he seems to forget that every Macintosh volume, not just the System volume, has a Trash folder.

Thus, if we pass to the FindFolder function the volume reference number of the file to be deleted instead of the constant kOnSystemDisk, we will be able to find the directory ID of the local Trash.

Line #44 of “FSpTrashFile.c” source file should be changed from:

theErr = FindFolder( kOnSystemDisk, kTrashFolderType, 
  kDontCreateFolder, &vRefNum, &dirID );

to:

theErr = FindFolder( (*theFile).vRefNum, kTrashFolderType, 
  kDontCreateFolder, &vRefNum, &dirID );

Live Long and Prosper!

Luigi Belverato

 

Community Search:
MacTech Search:

Software Updates via MacUpdate

Gordon Ramsay DASH: Guide to upgrading a...
If we've learned anything about celebrity chef Gordon Ramsay over the years, it's that you don't want him angry and breathing down your neck. He's not above calling you out on TV, making a mockery of your efforts in the kitchen in front of... | Read more »
Galaxy of Trian (Games)
Galaxy of Trian 1.1.0 Device: iOS Universal Category: Games Price: $6.99, Version: 1.1.0 (iTunes) Description: Galaxy of Trian is an exciting, fast paced digital board game based on the highly acclaimed tabletop title. | Read more »
Dead In Bermuda (Games)
Dead In Bermuda 1.0 Device: iOS Universal Category: Games Price: $4.99, Version: 1.0 (iTunes) Description: | Read more »
The Little Fox (Games)
The Little Fox 1.0.1 Device: iOS Universal Category: Games Price: $2.99, Version: 1.0.1 (iTunes) Description: The Little Fox is an alternative perspective on the world-renowned ‘fairy tale for adults', The Little Prince by Antoine de... | Read more »
5 popular free fertility apps
There was a good article this week in The Independent about how more women are using fertility appsas a de facto form of contraception. It's apparently not working too well, leading to numerous unwanted pregnancies. [Read more] | Read more »
How to get more cars in CSR Racing 2
NaturalMotion and Zynga brought a lot of real life cars to the table for CSR Racing 2. From souped up everyday rides made by Nissan and Hyundai to supercars produced by the likes of McLaren and Pagani, there really is something for everyone. [... | Read more »
Crypt of the NecroDancer Pocket Edition...
Crypt of the NecroDancer Pocket Edition 1.0 Device: iOS Universal Category: Games Price: $4.99, Version: 1.0 (iTunes) Description: Crypt of the NecroDancer is an award winning hardcore roguelike rhythm game. Move to the music and... | Read more »
Gear-grinding puzzle title Inner Circle...
If you saw our post earlier this month announcing the imminent release of ZPlay’s new creation, Inner Circle, you’ll be happy to know that it’s now available on the App Store. Established in 2010, developer and publisher ZPlay have taken the... | Read more »
CSR Racing 2: Your guide to what's...
CSR Racing 2, or CSR2, as it likes to call itself, has finally arrived. The follow-up to the immensely popular drag racing game CSR Racing is the first release from NaturalMotion since the studio's acquisition by Zynga in early 2014. [Read more] | Read more »
Nanuleu (Games)
Nanuleu 1.1 Device: iOS Universal Category: Games Price: $2.99, Version: 1.1 (iTunes) Description: Nanuleu is a strategy game where you take control of ancient magical trees that protect the land from an invading dark force. A... | Read more »

Price Scanner via MacPrices.net

July 4th sale: $100 off 13-inch MacBook Airs
Amazon has 13″ MacBook Airs on sale for $100 off MSRP for a limited time. Shipping is free: - 13″ 1.6GHz/128GB MacBook Air (sku MMGF2LL/A): $899.99 $100 off MSRP - 13″ 1.6GHz/256GB MacBook Air (sku... Read more
Swiftpoint Launches Advanced Pivot, Tilt And...
Christchurch, New Zealand based Swiftpoint has announced the launch of its new generation computer mouse, The Z, on the crowdfunding website kickstarter.com. The company’s previous device, the... Read more
Clearance 12-inch Retina MacBooks, Apple refu...
Apple has Certified Refurbished 2015 12″ Retina MacBooks available starting at $929. Apple will include a standard one-year warranty with each MacBook, and shipping is free. The following... Read more
12-inch MacBooks available with free bundles...
Adorama has 12″ Retina MacBooks available including free shipping plus NY & NJ sales tax only. For a limited time, Adorama will include a free Apple USB-C to USB Adapter, free 4-Port USB Hub, and... Read more
Das Keyboard Unveils First Cloud-Connected Ke...
Austin, Texas based Das Keyboard has unveiled the newest addition to its family of high-performance mechanical keyboards with the introduction of the Das Keyboard 5Q on Kickstarter. Built with... Read more
13-inch 2.7GHz Retina MacBook Pros on sale fo...
Adorama has 13″ 2.7GHz Retina MacBook Pros on sale for up to $130 off MSRP. Shipping is free, and Adorama charges NY & NJ sales tax only: - 13″ 2.7GHz/128GB Retina MacBook Pro: $1169 $130 off -... Read more
New App Reminds Us to Put Down Our Phones and...
Mode, a new smartphone app that makes us more mindful of how we use our devices, debuts in the app stores today. The Mode app tracks time spent in different modes of day-to-day life without... Read more
ZuumSpeed Personalized Speedometer + HUD For...
RMKapps has announced the release and immediate availability of ZuumSpeed 1.0, its personalized speedometer plus heads up display for iOS devices. ZuumSpeed gives users over 18 custom fonts available... Read more
Apple refurbished clearance 15-inch Retina Ma...
Apple has Certified Refurbished 2014 15″ 2.2GHz Retina MacBook Pros available for $1609, $390 off original MSRP. Apple’s one-year warranty is included, and shipping is free. They have refurbished 15... Read more
9-inch 128GB Silver iPad Pro on sale for $50...
B&H Photo has the 9.7″ 128GB Silver Apple iPad Pro on sale for $699 including free shipping plus NY tax only. Their price is $50 off MSRP. Read more

Jobs Board

*Apple* Retail - Multiple Positions - Apple,...
Job Description: Sales Specialist - Retail Customer Service and Sales Transform Apple Store visitors into loyal Apple customers. When customers enter the store, Read more
*Apple* iPhone 6s and New Products Tester Ne...
…we therefore look forward to put out products to quality test for durability. Apple leads the digital music revolution with its iPods and iTunes online store, Read more
*Apple* Retail - Multiple Positions, Fort Wo...
Sales Specialist - Retail Customer Service and Sales Transform Apple Store visitors into loyal Apple customers. When customers enter the store, you're also the Read more
*Apple* Retail - Multiple Positions - Apple,...
Job Description: Sales Specialist - Retail Customer Service and Sales Transform Apple Store visitors into loyal Apple customers. When customers enter the store, Read more
*Apple* iPhone 6s and New Products Tester Ne...
…we therefore look forward to put out products to quality test for durability. Apple leads the digital music revolution with its iPods and iTunes online store, Read more
All contents are Copyright 1984-2011 by Xplain Corporation. All rights reserved. Theme designed by Icreon.