Strings.pdf

StringProgrammingGuide

DataManagement:Strings,Text,&Fonts

2009-10-15

AppleInc.

Allrightsreserved.

Nopartofthispublicationmaybereproduced,

storedinaretrievalsystem,ortransmitted,in

anyformorbyanymeans,mechanical,

electronic,photocopying,recording,or

otherwise,withoutpriorwrittenpermissionof

AppleInc.,withthefollowingexceptions:Any

personisherebyauthorizedtostore

documentationonasinglecomputerfor

personaluseonlyandtoprintcopiesof

documentationforpersonaluseprovidedthat

thedocumentationcontainsApple’scopyright

notice.

TheApplelogoisatrademarkofAppleInc.

Nolicenses,expressorimplied,aregranted

withrespecttoanyofthetechnologydescribed

inthisdocument.Appleretainsallintellectual

propertyrightsassociatedwiththetechnology

describedinthisdocument.Thisdocumentis

intendedtoassistapplicationdevelopersto

developapplicationsonlyforApple-labeled

computers.

AppleInc.

1InfiniteLoop

Cupertino,CA95014

408-996-1010

Apple,theApplelogo,Cocoa,Finder,Mac,Mac

OS,Macintosh,Objective-C,andSafariare

trademarksofAppleInc.,registeredinthe

UnitedStatesandothercountries.

EventhoughApplehasreviewedthisdocument,

APPLEMAKESNOWARRANTYORREPRESENTATION,

EITHEREXPRESSORIMPLIED,WITHRESPECTTO

THISDOCUMENT,ITSQUALITY,ACCURACY,

MERCHANTABILITY,ORFITNESSFORAPARTICULAR

PURPOSE.ASARESULT,THISDOCUMENTIS

PROVIDED“ASIS,”ANDYOU,THEREADER,ARE

ASSUMINGTHEENTIRERISKASTOITSQUALITY

ANDACCURACY.

INNOEVENTWILLAPPLEBELIABLEFORDIRECT,

INDIRECT,SPECIAL,INCIDENTAL,OR

CONSEQUENTIALDAMAGESRESULTINGFROMANY

DEFECTORINACCURACYINTHISDOCUMENT,even

ifadvisedofthepossibilityofsuchdamages.

THEWARRANTYANDREMEDIESSETFORTHABOVE

AREEXCLUSIVEANDINLIEUOFALLOTHERS,ORAL

ORWRITTEN,EXPRESSORIMPLIED.NoApple

dealer,agent,oremployeeisauthorizedtomake

anymodification,extension,oradditiontothis

warranty.

Somestatesdonotallowtheexclusionorlimitation

ofimpliedwarrantiesorliabilityforincidentalor

consequentialdamages,sotheabovelimitationor

exclusionmaynotapplytoyou.Thiswarrantygives

youspecificlegalrights,andyoumayalsohave

otherrightswhichvaryfromstatetostate.

Contents

IntroductiontoStringProgrammingGuideforCocoa 7

WhoShouldReadThisDocument 7

OrganizationofThisDocument 7

SeeAlso 8

Strings 9

CreatingandConvertingStringObjects 11

CreatingStrings 11

NSStringfromCStringsandData 11

VariableStrings 12

StringstoPresenttotheUser 12

CombiningandExtractingStrings 13

GettingCStrings 13

ConversionSummary 14

FormattingStringObjects 15

FormattingBasics 15

StringsandNon-ASCIICharacters 16

NSLogandNSLogv 16

StringFormatSpecifiers 17

FormatSpecifiers 17

PlatformDependencies 19

ReadingStringsFromandWritingStringsToFilesandURLs 21

ReadingFromFilesandURLs 21

Readingdatawithaknownencoding 21

Readingdatawithanunknownencoding 22

WritingtoFilesandURLs 22

Summary 23

Searching,Comparing,andSortingStrings 25

SearchandComparisonMethods 25

Searchingstrings 25

Comparingandsortingstrings 26

SearchandComparisonOptions 26

Examples 27

Case-InsensitiveSearchforPrefixandSuffix 27

ComparingStrings 27

SortingstringslikeFinder 28

ParagraphsandLineBreaks 31

LineandParagraphSeparatorCharacters 31

SeparatingaString“byParagraph” 31

CharactersandGraphemeClusters 33

CharacterSets 35

CharacterSetBasics 35

CreatingCharacterSets 35

Performanceconsiderations 36

Creatingacharactersetfile 36

StandardCharacterSetsandUnicodeDefinitions 37

Scanners 39

CreatingaScanner 39

UsingaScanner 39

Example 40

Localization 41

StringRepresentationsofFilePaths 43

RepresentingaPath 43

UserDirectories 44

PathComponents 44

FileNameCompletion 45

DrawingStrings 47

DocumentRevisionHistory 49

Index 51

Tables

StringFormatSpecifiers 17

Table1 Formatspecifierssupportedbythe NSString formattingmethodsandCFString

formattingfunctions 17

Table2 Formatspecifiersfordatatypes 19

Plik z chomika:

Inne pliki z tego folderu:

Inne foldery tego chomika: