diff -r ebc84c812384 -r 46218c8b8afa Symbian3/PDK/Source/GUID-14FAE656-7CDE-56ED-ACB2-7853276C24E9.dita --- a/Symbian3/PDK/Source/GUID-14FAE656-7CDE-56ED-ACB2-7853276C24E9.dita Thu Mar 11 15:24:26 2010 +0000 +++ b/Symbian3/PDK/Source/GUID-14FAE656-7CDE-56ED-ACB2-7853276C24E9.dita Thu Mar 11 18:02:22 2010 +0000 @@ -1,113 +1,113 @@ - - - - - -Descriptor -Example CodeExamples that explains how to use descriptors. - -
BinaryData: -handling general binary data with descriptors

Download

Click -on the following link to download the example: BinaryData .zip .

Download some additional files -required by the example: CommonFramework.zip.

View the example code: browse . View the additional files: browse.

Description

The example -shows how descriptors can handle general binary data by explicitly using the -8 bit descriptor class variants TBufC8<TInt>, TBuf8<TInt>, TPtr8 etc.

Contrast -this with examples where descriptors contain text. These examples almost always -use the non-explicit forms TBufC<TInt>, TBuf<TInt>, TPtr etc; -these are typedef'd to the 16 bit variant.

Class summary

TBuf8

Security -issues

The example requires no specific capabilities in order -to run - and does not demonstrate any security issues.

-
Buffer: basic -buffer descriptors

Download

Click on the following -link to download the example: Buffer .zip

Download some additional files -required by the example: CommonFramework.zip.

View the example code: browse . View the additional files: browse.

Description

This example -shows the basic idea of buffer descriptors and how they are used.

Class -summary

TBuf TBufC TDesC TPtr TDes

Security issues

The example requires no specific -capabilities in order to run - and does not demonstrate any security issues.

-
InFunct: using -descriptors in function interfaces

Download

Click -on the following link to download the example: InFunct.zip

Download some additional files -required by the example: CommonFramework.zip.

View the example code: browse . View the additional files: browse.

Description

This example -shows how descriptors can be used in function interfaces. Specifically, it -shows the use of:

    -

  • const TDesC& -aString

    • -

  • TDes&

    • -

  • const TDesC8& -aBuffer

    • -

  • TDes8& -aBuffer.

    • -

as function arguments.

Class summary

TBuf TBufC TPtr TPtrC HBufC

Security issues

The -example requires no specific capabilities in order to run - and does not demonstrate -any security issues.

-
HeapBuffer: -heap buffer descriptors

Download

Click on the following -link to download the example: HeapBuffer .zip

Download some additional files -required by the example: CommonFramework.zip.

View the example code: browse . View the additional files: browse.

Description

The example -shows use of the HBufC heap buffer descriptor and:

    -

  • how it can be created -using the HBufC::NewL() static function

    • -

  • how it can be reallocated -using the ReAllocL() function

    • -

  • how its data can be -changed through a TPtr constructed by calling the Des() function

    • -

class summary

HBufC TPtr CleanupStack

Security -issues

The example requires no specific capabilities in order -to run - and does not demonstrate any security issues.

-
Modifier: modifiable -descriptors

Download

Click on the following link -to download the example: Modifier .zip

Download some additional files -required by the example: CommonFramework.zip.

View the example code: - browse . View the additional files: browse.

Description

The example -shows the usage of descriptor functions which can modify the descriptor. These -are the functions defined and implemented by the TDes class: -for example SetLength(), Copy() and Insert().

Class -summary

TDes TBuf TPtr

Security -issues

The example requires no specific capabilities in order -to run - and does not demonstrate any security issues.

-
NonModifier: -non-modifiable descriptors

Download

Click on the -following link to download the example: NonModifier .zip

Download some additional files -required by the example: CommonFramework.zip.

View the example code: - browse . View the additional files: browse.

Description

The example -shows the use of descriptor functions which do not modify the descriptor. -These are the functions defined and implemented by the TDesC class; -for example Length(), Size() and Compare().

Class -summary

TDesC TBufC TPtrC

Security -issues

The example requires no specific capabilities in order -to run - and does not demonstrate any security issues.

-
Pointer: basic -pointer descriptors

Download

Click on the following -link to download the example: Pointer .zip

Download some additional files -required by the example: CommonFramework.zip.

View the example code: - browse . View the additional files: browse.

Description

The example shows -the basic idea of pointer descriptors and how they are used.

Class -summary

TPtr TPtrC TPtrC8 TPtrC16

Security -issues

The example requires no specific capabilities in order -to run - and does not demonstrate any security issues.

-
WriteToFiles: -writes:"Hello World!" to a file

Download

Click on -the following link to download the example: WriteToFiles .zip

Download some additional -files required by the example: CommonFramework.zip.

View the example code: browse . View the additional files: browse.

Description

This writes -the text "Hello World!" to a file. It is used as the basis of all examples -which depend on just the Base and the file server.

Class summary

RFs RFile User TPtrC8

Security issues

The -example writes files to the executable's process private directory: C:\private\0FFFFF00\.

The -second UID in the .mmp file is defined as 0x0FFFFF00 and -this is used as the secure ID on which the name of the private directory is -based.

+ + + + + +Descriptor +Example CodeExamples that explains how to use descriptors. +
    +

  • BinaryData: handling general binary data with descriptors

    • +

  • Buffer: basic buffer descriptors

    • +

  • InFunct: using descriptors in function interfaces

    • +

  • HeapBuffer: heap buffer descriptors

    • +

  • Modifier: modifiable descriptors

    • +

  • NonModifier: non-modifiable descriptors

    • +

  • Pointer: basic pointer descriptors

    • +

  • WriteToFile: writes "Hello World!" to a file.

    • +
+
BinaryData: +handling general binary data with descriptors

Download

Click +on the following link to download the example: BinaryData .zip .

Download some additional files +required by the example: CommonFramework.zip.

View the example code: browse . View the additional files: browse.

Description

The example +shows how descriptors can handle general binary data by explicitly using the +8 bit descriptor class variants TBufC8<TInt>, TBuf8<TInt>, TPtr8 etc.

Contrast +this with examples where descriptors contain text. These examples almost always +use the non-explicit forms TBufC<TInt>, TBuf<TInt>, TPtr etc; +these are typedef'd to the 16 bit variant.

Class summary

TBuf8

Security +issues

The example requires no specific capabilities in order +to run - and does not demonstrate any security issues.

+
Buffer: basic +buffer descriptors

Download

Click on the following +link to download the example: Buffer .zip

Download some additional files +required by the example: CommonFramework.zip.

View the example code: browse . View the additional files: browse.

Description

This example +shows the basic idea of buffer descriptors and how they are used.

Class +summary

TBuf TBufC TDesC TPtr TDes

Security issues

The example requires no specific +capabilities in order to run - and does not demonstrate any security issues.

+
InFunct: using +descriptors in function interfaces

Download

Click +on the following link to download the example: InFunct.zip

Download some additional files +required by the example: CommonFramework.zip.

View the example code: browse . View the additional files: browse.

Description

This example +shows how descriptors can be used in function interfaces. Specifically, it +shows the use of:

    +

  • const TDesC& +aString

    • +

  • TDes&

    • +

  • const TDesC8& +aBuffer

    • +

  • TDes8& +aBuffer.

    • +

as function arguments.

Class summary

TBuf TBufC TPtr TPtrC HBufC

Security issues

The +example requires no specific capabilities in order to run - and does not demonstrate +any security issues.

+
HeapBuffer: +heap buffer descriptors

Download

Click on the following +link to download the example: HeapBuffer .zip

Download some additional files +required by the example: CommonFramework.zip.

View the example code: browse . View the additional files: browse.

Description

The example +shows use of the HBufC heap buffer descriptor and:

    +

  • how it can be created +using the HBufC::NewL() static function

    • +

  • how it can be reallocated +using the ReAllocL() function

    • +

  • how its data can be +changed through a TPtr constructed by calling the Des() function

    • +

class summary

HBufC TPtr CleanupStack

Security +issues

The example requires no specific capabilities in order +to run - and does not demonstrate any security issues.

+
Modifier: modifiable +descriptors

Download

Click on the following link +to download the example: Modifier .zip

Download some additional files +required by the example: CommonFramework.zip.

View the example code: + browse . View the additional files: browse.

Description

The example +shows the usage of descriptor functions which can modify the descriptor. These +are the functions defined and implemented by the TDes class: +for example SetLength(), Copy() and Insert().

Class +summary

TDes TBuf TPtr

Security +issues

The example requires no specific capabilities in order +to run - and does not demonstrate any security issues.

+
NonModifier: +non-modifiable descriptors

Download

Click on the +following link to download the example: NonModifier .zip

Download some additional files +required by the example: CommonFramework.zip.

View the example code: + browse . View the additional files: browse.

Description

The example +shows the use of descriptor functions which do not modify the descriptor. +These are the functions defined and implemented by the TDesC class; +for example Length(), Size() and Compare().

Class +summary

TDesC TBufC TPtrC

Security +issues

The example requires no specific capabilities in order +to run - and does not demonstrate any security issues.

+
Pointer: basic +pointer descriptors

Download

Click on the following +link to download the example: Pointer .zip

Download some additional files +required by the example: CommonFramework.zip.

View the example code: + browse . View the additional files: browse.

Description

The example shows +the basic idea of pointer descriptors and how they are used.

Class +summary

TPtr TPtrC TPtrC8 TPtrC16

Security +issues

The example requires no specific capabilities in order +to run - and does not demonstrate any security issues.

+
WriteToFiles: +writes:"Hello World!" to a file

Download

Click on +the following link to download the example: WriteToFiles .zip

Download some additional +files required by the example: CommonFramework.zip.

View the example code: browse . View the additional files: browse.

Description

This writes +the text "Hello World!" to a file. It is used as the basis of all examples +which depend on just the Base and the file server.

Class summary

RFs RFile User TPtrC8

Security issues

The +example writes files to the executable's process private directory: C:\private\0FFFFF00\.

The +second UID in the .mmp file is defined as 0x0FFFFF00 and +this is used as the secure ID on which the name of the private directory is +based.

\ No newline at end of file