Wednesday, September 17, 2014

Tricks To Increase Firefox Internet Speed

www.gegeek.com

Tricks To Increase Firefox Internet Speed:-

http://www.geniouspc.com/2012/11/firefox-internet-speed-tricks.html

http://www.oxhow.com/access-facebook-when-blocked-office-school/

www.marcofolio.net/tips/increase_your_browser_page_transfer_speed.html

Friday, September 12, 2014

Linux System Help

http://www.techspot.com/community/topics/step-by-step-beginners-guide-to-installing-ubuntu-11-10.172128/

CD , DVD , both RW and R only mounting on Linux system

http://www.linuxnix.com/2012/09/how-to-mount-dvd-or-cdrom-in-linux.html


Secure Copy (scp)

                               source directory
                                        |
                                        $scp -r /media/2068EC5068EC25EE/movie/DEBRABREHAN oracle@192.168.40.2:/uo2/smart/deb/

|       |                 |
   UName       Remote Host _IP Destination Directory


$scp -r /Source_Directory RemotHostUserNaame@IP:/destnation Directory

http://www.linuxfocus.org/English/January2003/article278.shtml

scp Performance

http://www.folkstalk.com/2012/07/scp-command-examples-linux-unix.html

By default scp uses the Triple-DES cipher to encrypt the data being sent. Using the Blowfish cipher has been shown to increase speed. This can be done by using option -c blowfish in the command line.

$scp -c blowfish some_file your_username@remotehost.edu:~

It is often suggested that the -C option for compression should also be used to increase speed. The effect of compression, however, will only significantly increase speed if your connection is very slow. Otherwise it may just be adding extra burden to the CPU. An example of using blowfish and compression:

$ scp -c blowfish -C local_file your_username@remotehost.edu:~

Monday, September 1, 2014

Mobile App Development Tutorial sites

Mobile Browser Download Site

http://www.opera.com/mobile/download/versions/

Mobile BI software
http://www.softwareadvice.com/bi/mobile-business-intelligence-comparison/

                       oracle mobile BI
http://www.oracle.com/us/solutions/business-analytics/business-intelligence/mobile/overview/index.html#ct02-Download

Mobile Contact online Backup system

     https://www.lookout.com/

1. https://netbeans.org/kb/73/javame/quickstart.html

2. http://www.oracle.com/technetwork/java/embedded/javame/java-mobile/learnmore/index.html

3. http://www.oracle.com/technetwork/java/embedded/javame/java-mobile/learnmore/index.html

4. http://www.oracle.com/technetwork/java/embedded/javame/java-mobile/learnmore/index.html

5. https://developer.sony.com/2013/11/29/how-to-develop-an-app-using-the-camera-remote-api-2/

6. http://www.informationweek.com/consumer/online-backup-vs-cloud-storage/d/d-id/1107440?

7. http://www.windowsphone.com/en-in/how-to/wp7/people/set-up-an-email-account

8.   http://alvinalexander.com/java/jwarehouse/apps-for-android/SampleSyncAdapter/src/com/example/android/samplesync/platform/index.shtml

Android example source code file (BatchOperation.java)

This example Android source code file (BatchOperation.java) is included in the DevDaily.com "Java Source Code Warehouse" project. The intent of this project is to help you "Learn Android by Example" ^TM.

Java - Android tags/keywords

android, arraylist, batchoperation, content, contentresolver, operationapplicationexception, os, provider, remoteexception, string, tag, util, utilities

The BatchOperation.java Android example source code

/*
 * Copyright (C) 2010 The Android Open Source Project
 * 
 * Licensed under the Apache License, Version 2.0 (the "License"); you may not
 * use this file except in compliance with the License. You may obtain a copy of
 * the License at
 * 
 * http://www.apache.org/licenses/LICENSE-2.0
 * 
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
 * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
 * License for the specific language governing permissions and limitations under
 * the License.
 */

package com.example.android.samplesync.platform;

import android.content.ContentProviderOperation;
import android.content.ContentResolver;
import android.content.Context;
import android.content.OperationApplicationException;
import android.os.RemoteException;
import android.provider.ContactsContract;
import android.util.Log;

import java.util.ArrayList;

/**
 * This class handles execution of batch mOperations on Contacts provider.
 */
public class BatchOperation {
    private final String TAG = "BatchOperation";

    private final ContentResolver mResolver;
    // List for storing the batch mOperations
    ArrayList<ContentProviderOperation> mOperations;

    public BatchOperation(Context context, ContentResolver resolver) {
        mResolver = resolver;
        mOperations = new ArrayList<ContentProviderOperation>();
    }

    public int size() {
        return mOperations.size();
    }

    public void add(ContentProviderOperation cpo) {
        mOperations.add(cpo);
    }

    public void execute() {
        if (mOperations.size() == 0) {
            return;
        }
        // Apply the mOperations to the content provider
        try {
            mResolver.applyBatch(ContactsContract.AUTHORITY, mOperations);
        } catch (final OperationApplicationException e1) {
            Log.e(TAG, "storing contact data failed", e1);
        } catch (final RemoteException e2) {
            Log.e(TAG, "storing contact data failed", e2);
        }
        mOperations.clear();
    }

}

9.   http://alvinalexander.com/java/jwarehouse/apps-for-android/SampleSyncAdapter/src/com/example/android/samplesync/platform/ContactOperations.java.shtml

Android example source code file (ContactOperations.java)

This example Android source code file (ContactOperations.java) is included in the DevDaily.com "Java Source Code Warehouse" project. The intent of this project is to help you "Learn Android by Example" ^TM.

Java - Android tags/keywords

android, batchoperation, contactoperations, content, contentvalues, context, net, network, provider, string, uri, utilities

The ContactOperations.java Android example source code

/*
 * Copyright (C) 2010 The Android Open Source Project
 * 
 * Licensed under the Apache License, Version 2.0 (the "License"); you may not
 * use this file except in compliance with the License. You may obtain a copy of
 * the License at
 * 
 * http://www.apache.org/licenses/LICENSE-2.0
 * 
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
 * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
 * License for the specific language governing permissions and limitations under
 * the License.
 */

package com.example.android.samplesync.platform;

import android.content.ContentProviderOperation;
import android.content.ContentValues;
import android.content.Context;
import android.net.Uri;
import android.provider.ContactsContract;
import android.provider.ContactsContract.Data;
import android.provider.ContactsContract.RawContacts;
import android.provider.ContactsContract.CommonDataKinds.Email;
import android.provider.ContactsContract.CommonDataKinds.Phone;
import android.provider.ContactsContract.CommonDataKinds.StructuredName;
import android.text.TextUtils;
import android.util.Log;

import com.example.android.samplesync.Constants;
import com.example.android.samplesync.R;

/**
 * Helper class for storing data in the platform content providers.
 */
public class ContactOperations {

    private final ContentValues mValues;
    private ContentProviderOperation.Builder mBuilder;
    private final BatchOperation mBatchOperation;
    private final Context mContext;
    private boolean mYield;
    private long mRawContactId;
    private int mBackReference;
    private boolean mIsNewContact;

    /**
     * Returns an instance of ContactOperations instance for adding new contact
     * to the platform contacts provider.
     * 
     * @param context the Authenticator Activity context
     * @param userId the userId of the sample SyncAdapter user object
     * @param accountName the username of the current login
     * @return instance of ContactOperations
     */
    public static ContactOperations createNewContact(Context context,
        int userId, String accountName, BatchOperation batchOperation) {
        return new ContactOperations(context, userId, accountName,
            batchOperation);
    }

    /**
     * Returns an instance of ContactOperations for updating existing contact in
     * the platform contacts provider.
     * 
     * @param context the Authenticator Activity context
     * @param rawContactId the unique Id of the existing rawContact
     * @return instance of ContactOperations
     */
    public static ContactOperations updateExistingContact(Context context,
        long rawContactId, BatchOperation batchOperation) {
        return new ContactOperations(context, rawContactId, batchOperation);
    }

    public ContactOperations(Context context, BatchOperation batchOperation) {
        mValues = new ContentValues();
        mYield = true;
        mContext = context;
        mBatchOperation = batchOperation;
    }

    public ContactOperations(Context context, int userId, String accountName,
        BatchOperation batchOperation) {
        this(context, batchOperation);
        mBackReference = mBatchOperation.size();
        mIsNewContact = true;
        mValues.put(RawContacts.SOURCE_ID, userId);
        mValues.put(RawContacts.ACCOUNT_TYPE, Constants.ACCOUNT_TYPE);
        mValues.put(RawContacts.ACCOUNT_NAME, accountName);
        mBuilder =
            newInsertCpo(RawContacts.CONTENT_URI, true).withValues(mValues);
        mBatchOperation.add(mBuilder.build());
    }

    public ContactOperations(Context context, long rawContactId,
        BatchOperation batchOperation) {
        this(context, batchOperation);
        mIsNewContact = false;
        mRawContactId = rawContactId;
    }

    /**
     * Adds a contact name
     * 
     * @param name Name of contact
     * @param nameType type of name: family name, given name, etc.
     * @return instance of ContactOperations
     */
    public ContactOperations addName(String firstName, String lastName) {
        mValues.clear();
        if (!TextUtils.isEmpty(firstName)) {
            mValues.put(StructuredName.GIVEN_NAME, firstName);
            mValues.put(StructuredName.MIMETYPE,
                StructuredName.CONTENT_ITEM_TYPE);
        }
        if (!TextUtils.isEmpty(lastName)) {
            mValues.put(StructuredName.FAMILY_NAME, lastName);
            mValues.put(StructuredName.MIMETYPE,
                StructuredName.CONTENT_ITEM_TYPE);
        }
        if (mValues.size() > 0) {
            addInsertOp();
        }
        return this;
    }

    /**
     * Adds an email
     * 
     * @param new email for user
     * @return instance of ContactOperations
     */
    public ContactOperations addEmail(String email) {
        mValues.clear();
        if (!TextUtils.isEmpty(email)) {
            mValues.put(Email.DATA, email);
            mValues.put(Email.TYPE, Email.TYPE_OTHER);
            mValues.put(Email.MIMETYPE, Email.CONTENT_ITEM_TYPE);
            addInsertOp();
        }
        return this;
    }

    /**
     * Adds a phone number
     * 
     * @param phone new phone number for the contact
     * @param phoneType the type: cell, home, etc.
     * @return instance of ContactOperations
     */
    public ContactOperations addPhone(String phone, int phoneType) {
        mValues.clear();
        if (!TextUtils.isEmpty(phone)) {
            mValues.put(Phone.NUMBER, phone);
            mValues.put(Phone.TYPE, phoneType);
            mValues.put(Phone.MIMETYPE, Phone.CONTENT_ITEM_TYPE);
            addInsertOp();
        }
        return this;
    }

    /**
     * Adds a profile action
     * 
     * @param userId the userId of the sample SyncAdapter user object
     * @return instance of ContactOperations
     */
    public ContactOperations addProfileAction(long userId) {
        mValues.clear();
        if (userId != 0) {
            mValues.put(SampleSyncAdapterColumns.DATA_PID, userId);
            mValues.put(SampleSyncAdapterColumns.DATA_SUMMARY, mContext
                .getString(R.string.profile_action));
            mValues.put(SampleSyncAdapterColumns.DATA_DETAIL, mContext
                .getString(R.string.view_profile));
            mValues.put(Data.MIMETYPE, SampleSyncAdapterColumns.MIME_PROFILE);
            addInsertOp();
        }
        return this;
    }

    /**
     * Updates contact's email
     * 
     * @param email email id of the sample SyncAdapter user
     * @param uri Uri for the existing raw contact to be updated
     * @return instance of ContactOperations
     */
    public ContactOperations updateEmail(String email, String existingEmail,
        Uri uri) {
        if (!TextUtils.equals(existingEmail, email)) {
            mValues.clear();
            mValues.put(Email.DATA, email);
            addUpdateOp(uri);
        }
        return this;
    }

    /**
     * Updates contact's name
     * 
     * @param name Name of contact
     * @param existingName Name of contact stored in provider
     * @param nameType type of name: family name, given name, etc.
     * @param uri Uri for the existing raw contact to be updated
     * @return instance of ContactOperations
     */
    public ContactOperations updateName(Uri uri, String existingFirstName,
        String existingLastName, String firstName, String lastName) {
        Log.i("ContactOperations", "ef=" + existingFirstName + "el="
            + existingLastName + "f=" + firstName + "l=" + lastName);
        mValues.clear();
        if (!TextUtils.equals(existingFirstName, firstName)) {
            mValues.put(StructuredName.GIVEN_NAME, firstName);
        }
        if (!TextUtils.equals(existingLastName, lastName)) {
            mValues.put(StructuredName.FAMILY_NAME, lastName);
        }
        if (mValues.size() > 0) {
            addUpdateOp(uri);
        }
        return this;
    }

    /**
     * Updates contact's phone
     * 
     * @param existingNumber phone number stored in contacts provider
     * @param phone new phone number for the contact
     * @param uri Uri for the existing raw contact to be updated
     * @return instance of ContactOperations
     */
    public ContactOperations updatePhone(String existingNumber, String phone,
        Uri uri) {
        if (!TextUtils.equals(phone, existingNumber)) {
            mValues.clear();
            mValues.put(Phone.NUMBER, phone);
            addUpdateOp(uri);
        }
        return this;
    }

    /**
     * Updates contact's profile action
     * 
     * @param userId sample SyncAdapter user id
     * @param uri Uri for the existing raw contact to be updated
     * @return instance of ContactOperations
     */
    public ContactOperations updateProfileAction(Integer userId, Uri uri) {
        mValues.clear();
        mValues.put(SampleSyncAdapterColumns.DATA_PID, userId);
        addUpdateOp(uri);
        return this;
    }

    /**
     * Adds an insert operation into the batch
     */
    private void addInsertOp() {
        if (!mIsNewContact) {
            mValues.put(Phone.RAW_CONTACT_ID, mRawContactId);
        }
        mBuilder =
            newInsertCpo(addCallerIsSyncAdapterParameter(Data.CONTENT_URI),
                mYield);
        mBuilder.withValues(mValues);
        if (mIsNewContact) {
            mBuilder
                .withValueBackReference(Data.RAW_CONTACT_ID, mBackReference);
        }
        mYield = false;
        mBatchOperation.add(mBuilder.build());
    }

    /**
     * Adds an update operation into the batch
     */
    private void addUpdateOp(Uri uri) {
        mBuilder = newUpdateCpo(uri, mYield).withValues(mValues);
        mYield = false;
        mBatchOperation.add(mBuilder.build());
    }

    public static ContentProviderOperation.Builder newInsertCpo(Uri uri,
        boolean yield) {
        return ContentProviderOperation.newInsert(
            addCallerIsSyncAdapterParameter(uri)).withYieldAllowed(yield);
    }

    public static ContentProviderOperation.Builder newUpdateCpo(Uri uri,
        boolean yield) {
        return ContentProviderOperation.newUpdate(
            addCallerIsSyncAdapterParameter(uri)).withYieldAllowed(yield);
    }

    public static ContentProviderOperation.Builder newDeleteCpo(Uri uri,
        boolean yield) {
        return ContentProviderOperation.newDelete(
            addCallerIsSyncAdapterParameter(uri)).withYieldAllowed(yield);

    }

    private static Uri addCallerIsSyncAdapterParameter(Uri uri) {
        return uri.buildUpon().appendQueryParameter(
            ContactsContract.CALLER_IS_SYNCADAPTER, "true").build();
    }

}

10.  http://alvinalexander.com/java/jwarehouse/apps-for-android/SampleSyncAdapter/src/com/example/android/samplesync/platform/SampleSyncAdapterColumns.java.shtml

Android example source code file (SampleSyncAdapterColumns.java)

This example Android source code file (SampleSyncAdapterColumns.java) is included in the DevDaily.com "Java Source Code Warehouse" project. The intent of this project is to help you "Learn Android by Example" ^TM.

Java - Android tags/keywords

data_detail, data_pid, data_summary, mime_profile, samplesyncadaptercolumns, string

The SampleSyncAdapterColumns.java Android example source code

/*
 * Copyright (C) 2010 The Android Open Source Project
 * 
 * Licensed under the Apache License, Version 2.0 (the "License"); you may not
 * use this file except in compliance with the License. You may obtain a copy of
 * the License at
 * 
 * http://www.apache.org/licenses/LICENSE-2.0
 * 
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
 * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
 * License for the specific language governing permissions and limitations under
 * the License.
 */
package com.example.android.samplesync.platform;

import android.provider.ContactsContract.Data;

/*
 * The standard columns representing contact's info from social apps.
 */
public interface SampleSyncAdapterColumns {
    /**
     * MIME-type used when storing a profile {@link Data} entry.
     */
    public static final String MIME_PROFILE =
        "vnd.android.cursor.item/vnd.samplesyncadapter.profile";

    public static final String DATA_PID = Data.DATA1;
    public static final String DATA_SUMMARY = Data.DATA2;
    public static final String DATA_DETAIL = Data.DATA3;

9. http://alvinalexander.com/java/jwarehouse/apps-for-android/SampleSyncAdapter/src/com/example/android/samplesync/platform/ContactManager.java.shtml

Android example source code file (ContactManager.java)

This example Android source code file (ContactManager.java) is included in the DevDaily.com "Java Source Code Warehouse" project. The intent of this project is to help you "Learn Android by Example" ^TM.

Java - Android tags/keywords

android, batchoperation, column_data1, column_data2, column_data3, column_id, contactoperations, content, contentresolver, contentvalues, cursor, custom_im_protocol, net, network, projection, selection, string, user, util, utilities

The ContactManager.java Android example source code

/*
 * Copyright (C) 2010 The Android Open Source Project
 * 
 * Licensed under the Apache License, Version 2.0 (the "License"); you may not
 * use this file except in compliance with the License. You may obtain a copy of
 * the License at
 * 
 * http://www.apache.org/licenses/LICENSE-2.0
 * 
 * Unless required by applicable law or agreed to in writing, software
 * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
 * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
 * License for the specific language governing permissions and limitations under
 * the License.
 */

package com.example.android.samplesync.platform;

import android.content.ContentResolver;
import android.content.ContentUris;
import android.content.ContentValues;
import android.content.Context;
import android.database.Cursor;
import android.net.Uri;
import android.provider.ContactsContract.Data;
import android.provider.ContactsContract.RawContacts;
import android.provider.ContactsContract.StatusUpdates;
import android.provider.ContactsContract.CommonDataKinds.Email;
import android.provider.ContactsContract.CommonDataKinds.Im;
import android.provider.ContactsContract.CommonDataKinds.Phone;
import android.provider.ContactsContract.CommonDataKinds.StructuredName;
import android.util.Log;

import com.example.android.samplesync.Constants;
import com.example.android.samplesync.R;
import com.example.android.samplesync.client.User;

import java.util.List;

/**
 * Class for managing contacts sync related mOperations
 */
public class ContactManager {
    /**
     * Custom IM protocol used when storing status messages.
     */
    public static final String CUSTOM_IM_PROTOCOL = "SampleSyncAdapter";
    private static final String TAG = "ContactManager";

    /**
     * Synchronize raw contacts
     * 
     * @param context The context of Authenticator Activity
     * @param account The username for the account
     * @param users The list of users
     */
    public static synchronized void syncContacts(Context context,
        String account, List<User> users) {
        long userId;
        long rawContactId = 0;
        final ContentResolver resolver = context.getContentResolver();
        final BatchOperation batchOperation =
            new BatchOperation(context, resolver);
        Log.d(TAG, "In SyncContacts");
        for (final User user : users) {
            userId = user.getUserId();
            // Check to see if the contact needs to be inserted or updated
            rawContactId = lookupRawContact(resolver, userId);
            if (rawContactId != 0) {
                if (!user.isDeleted()) {
                    // update contact
                    updateContact(context, resolver, account, user,
                        rawContactId, batchOperation);
                } else {
                    // delete contact
                    deleteContact(context, rawContactId, batchOperation);
                }
            } else {
                // add new contact
                Log.d(TAG, "In addContact");
                if (!user.isDeleted()) {
                    addContact(context, account, user, batchOperation);
                }
            }
            // A sync adapter should batch operations on multiple contacts,
            // because it will make a dramatic performance difference.
            if (batchOperation.size() >= 50) {
                batchOperation.execute();
            }
        }
        batchOperation.execute();
    }

    /**
     * Add a list of status messages to the contacts provider.
     * 
     * @param context the context to use
     * @param accountName the username of the logged in user
     * @param statuses the list of statuses to store
     */
    public static void insertStatuses(Context context, String username,
        List<User.Status> list) {
        final ContentValues values = new ContentValues();
        final ContentResolver resolver = context.getContentResolver();
        final BatchOperation batchOperation =
            new BatchOperation(context, resolver);
        for (final User.Status status : list) {
            // Look up the user's sample SyncAdapter data row
            final long userId = status.getUserId();
            final long profileId = lookupProfile(resolver, userId);

            // Insert the activity into the stream
            if (profileId > 0) {
                values.put(StatusUpdates.DATA_ID, profileId);
                values.put(StatusUpdates.STATUS, status.getStatus());
                values.put(StatusUpdates.PROTOCOL, Im.PROTOCOL_CUSTOM);
                values.put(StatusUpdates.CUSTOM_PROTOCOL, CUSTOM_IM_PROTOCOL);
                values.put(StatusUpdates.IM_ACCOUNT, username);
                values.put(StatusUpdates.IM_HANDLE, status.getUserId());
                values.put(StatusUpdates.STATUS_RES_PACKAGE, context
                    .getPackageName());
                values.put(StatusUpdates.STATUS_ICON, R.drawable.icon);
                values.put(StatusUpdates.STATUS_LABEL, R.string.label);

                batchOperation
                    .add(ContactOperations.newInsertCpo(
                        StatusUpdates.CONTENT_URI, true).withValues(values)
                        .build());
                // A sync adapter should batch operations on multiple contacts,
                // because it will make a dramatic performance difference.
                if (batchOperation.size() >= 50) {
                    batchOperation.execute();
                }
            }
        }
        batchOperation.execute();
    }

    /**
     * Adds a single contact to the platform contacts provider.
     * 
     * @param context the Authenticator Activity context
     * @param accountName the account the contact belongs to
     * @param user the sample SyncAdapter User object
     */
    private static void addContact(Context context, String accountName,
        User user, BatchOperation batchOperation) {
        // Put the data in the contacts provider
        final ContactOperations contactOp =
            ContactOperations.createNewContact(context, user.getUserId(),
                accountName, batchOperation);
        contactOp.addName(user.getFirstName(), user.getLastName()).addEmail(
            user.getEmail()).addPhone(user.getCellPhone(), Phone.TYPE_MOBILE)
            .addPhone(user.getHomePhone(), Phone.TYPE_OTHER).addProfileAction(
                user.getUserId());
    }

    /**
     * Updates a single contact to the platform contacts provider.
     * 
     * @param context the Authenticator Activity context
     * @param resolver the ContentResolver to use
     * @param accountName the account the contact belongs to
     * @param user the sample SyncAdapter contact object.
     * @param rawContactId the unique Id for this rawContact in contacts
     *        provider
     */
    private static void updateContact(Context context,
        ContentResolver resolver, String accountName, User user,
        long rawContactId, BatchOperation batchOperation) {
        Uri uri;
        String cellPhone = null;
        String otherPhone = null;
        String email = null;

        final Cursor c =
            resolver.query(Data.CONTENT_URI, DataQuery.PROJECTION,
                DataQuery.SELECTION,
                new String[] {String.valueOf(rawContactId)}, null);
        final ContactOperations contactOp =
            ContactOperations.updateExistingContact(context, rawContactId,
                batchOperation);

        try {
            while (c.moveToNext()) {
                final long id = c.getLong(DataQuery.COLUMN_ID);
                final String mimeType = c.getString(DataQuery.COLUMN_MIMETYPE);
                uri = ContentUris.withAppendedId(Data.CONTENT_URI, id);

                if (mimeType.equals(StructuredName.CONTENT_ITEM_TYPE)) {
                    final String lastName =
                        c.getString(DataQuery.COLUMN_FAMILY_NAME);
                    final String firstName =
                        c.getString(DataQuery.COLUMN_GIVEN_NAME);
                    contactOp.updateName(uri, firstName, lastName, user
                        .getFirstName(), user.getLastName());
                }

                else if (mimeType.equals(Phone.CONTENT_ITEM_TYPE)) {
                    final int type = c.getInt(DataQuery.COLUMN_PHONE_TYPE);

                    if (type == Phone.TYPE_MOBILE) {
                        cellPhone = c.getString(DataQuery.COLUMN_PHONE_NUMBER);
                        contactOp.updatePhone(cellPhone, user.getCellPhone(),
                            uri);
                    } else if (type == Phone.TYPE_OTHER) {
                        otherPhone = c.getString(DataQuery.COLUMN_PHONE_NUMBER);
                        contactOp.updatePhone(otherPhone, user.getHomePhone(),
                            uri);
                    }
                }

                else if (Data.MIMETYPE.equals(Email.CONTENT_ITEM_TYPE)) {
                    email = c.getString(DataQuery.COLUMN_EMAIL_ADDRESS);
                    contactOp.updateEmail(user.getEmail(), email, uri);

                }
            } // while
        } finally {
            c.close();
        }

        // Add the cell phone, if present and not updated above
        if (cellPhone == null) {
            contactOp.addPhone(user.getCellPhone(), Phone.TYPE_MOBILE);
        }

        // Add the other phone, if present and not updated above
        if (otherPhone == null) {
            contactOp.addPhone(user.getHomePhone(), Phone.TYPE_OTHER);
        }

        // Add the email address, if present and not updated above
        if (email == null) {
            contactOp.addEmail(user.getEmail());
        }

    }

    /**
     * Deletes a contact from the platform contacts provider.
     * 
     * @param context the Authenticator Activity context
     * @param rawContactId the unique Id for this rawContact in contacts
     *        provider
     */
    private static void deleteContact(Context context, long rawContactId,
        BatchOperation batchOperation) {
        batchOperation.add(ContactOperations.newDeleteCpo(
            ContentUris.withAppendedId(RawContacts.CONTENT_URI, rawContactId),
            true).build());
    }

    /**
     * Returns the RawContact id for a sample SyncAdapter contact, or 0 if the
     * sample SyncAdapter user isn't found.
     * 
     * @param context the Authenticator Activity context
     * @param userId the sample SyncAdapter user ID to lookup
     * @return the RawContact id, or 0 if not found
     */
    private static long lookupRawContact(ContentResolver resolver, long userId) {
        long authorId = 0;
        final Cursor c =
            resolver.query(RawContacts.CONTENT_URI, UserIdQuery.PROJECTION,
                UserIdQuery.SELECTION, new String[] {String.valueOf(userId)},
                null);
        try {
            if (c.moveToFirst()) {
                authorId = c.getLong(UserIdQuery.COLUMN_ID);
            }
        } finally {
            if (c != null) {
                c.close();
            }
        }
        return authorId;
    }

    /**
     * Returns the Data id for a sample SyncAdapter contact's profile row, or 0
     * if the sample SyncAdapter user isn't found.
     * 
     * @param resolver a content resolver
     * @param userId the sample SyncAdapter user ID to lookup
     * @return the profile Data row id, or 0 if not found
     */
    private static long lookupProfile(ContentResolver resolver, long userId) {
        long profileId = 0;
        final Cursor c =
            resolver.query(Data.CONTENT_URI, ProfileQuery.PROJECTION,
                ProfileQuery.SELECTION, new String[] {String.valueOf(userId)},
                null);
        try {
            if (c != null && c.moveToFirst()) {
                profileId = c.getLong(ProfileQuery.COLUMN_ID);
            }
        } finally {
            if (c != null) {
                c.close();
            }
        }
        return profileId;
    }

    /**
     * Constants for a query to find a contact given a sample SyncAdapter user
     * ID.
     */
    private interface ProfileQuery {
        public final static String[] PROJECTION = new String[] {Data._ID};

        public final static int COLUMN_ID = 0;

        public static final String SELECTION =
            Data.MIMETYPE + "='" + SampleSyncAdapterColumns.MIME_PROFILE
                + "' AND " + SampleSyncAdapterColumns.DATA_PID + "=?";
    }
    /**
     * Constants for a query to find a contact given a sample SyncAdapter user
     * ID.
     */
    private interface UserIdQuery {
        public final static String[] PROJECTION =
            new String[] {RawContacts._ID};

        public final static int COLUMN_ID = 0;

        public static final String SELECTION =
            RawContacts.ACCOUNT_TYPE + "='" + Constants.ACCOUNT_TYPE + "' AND "
                + RawContacts.SOURCE_ID + "=?";
    }

    /**
     * Constants for a query to get contact data for a given rawContactId
     */
    private interface DataQuery {
        public static final String[] PROJECTION =
            new String[] {Data._ID, Data.MIMETYPE, Data.DATA1, Data.DATA2,
                Data.DATA3,};

        public static final int COLUMN_ID = 0;
        public static final int COLUMN_MIMETYPE = 1;
        public static final int COLUMN_DATA1 = 2;
        public static final int COLUMN_DATA2 = 3;
        public static final int COLUMN_DATA3 = 4;
        public static final int COLUMN_PHONE_NUMBER = COLUMN_DATA1;
        public static final int COLUMN_PHONE_TYPE = COLUMN_DATA2;
        public static final int COLUMN_EMAIL_ADDRESS = COLUMN_DATA1;
        public static final int COLUMN_EMAIL_TYPE = COLUMN_DATA2;
        public static final int COLUMN_GIVEN_NAME = COLUMN_DATA2;
        public static final int COLUMN_FAMILY_NAME = COLUMN_DATA3;

        public static final String SELECTION = Data.RAW_CONTACT_ID + "=?";
    }
}

11. http://www.telerik.com/platform#overview

12. How to build a mobile app with an App Engine backend (Tutorial)

https://cloud.google.com/developers/articles/how-to-build-mobile-app-with-app-engine-backend-tutorial

java and networking

http://docs.oracle.com/javase/tutorial/networking/overview/networking.html

http://docs.oracle.com/javase/tutorial/networking/

http://www.tutorialspoint.com/java/java_networking.htm

Friday, August 29, 2014

Amestsantim General business support

Troubleshooting

http://www.amestsantim.com/troubleshooting/

Home page

http://www.amestsantim.com/

T24 Technical Support

Amirul Islam

Oracle is a database that responds very well with excellent performance in demanding environments.

http://a2zoraclebd.blogspot.com/2013/06/t24-technical-support.html

T24 Technical Support

http://t24livebranchsupport.blogspot.com/2011/01/t24-account.html

Monday, August 18, 2014

Thesis Topics

CS MS Thesis Topics  link URL

Proposal Writing Template

http://aciar.gov.au/page/project-proposal-guidelines-and-templates

http://gallatin.nyu.edu/academics/graduate/thesis/proposal.html

1. http://www.cse.unsw.edu.au/db/thesis/thesis_topics.php

2. http://www.cs.sdsu.edu/past-theses/

3. http://www.surrey.ac.uk/postgraduate/information-security

4. http://www.surrey.ac.uk/computing/study/pgt/index.htm?ad=mscgclid=CI7T1IvqncACFQcHwwodNbgAWw

5. http://www.cs.sdsu.edu/wp-content/uploads/2012/06/peddola_sri_tulasi.pdf

6. http://ekendraonline.com/thesis/topics/

7 . http://www.lnt.ei.tum.de/en/bachelormaster-theses/

8, http://ec.europa.eu/research/participants/data/ref/h2020/wp/2014_2015/main/h2020-wp1415-leit-ict_en.pdf

9. http://books.google.co.uk/books?id=29h7BLDbRC8C&pg=PA306&lpg=PA306&dq=software+for+object+redio&source=bl&ots=DX8tDIkncL&sig=WoEQEPogXPhHpFgbl4iw08qFS1I&hl=en&sa=X&ei=3A4ZVLDeMsX2O_r8gNgF&ved=0CD0Q6AEwBA#v=onepage&q=software%20for%20object%20redio&f=false

10.   CS Thesis Topic Generation

https://www.cs.purdue.edu/homes/dec/essay.topic.generator.html

11. Thesis Statements and the like

http://www.quora.com/What-are-currently-the-hot-topics-in-computer-science-research

See Prof. Valiant's research statement, I think it's a good summary:

The majority of computational problems, including those with explicit
mathematical characterizations such as the NP-complete problems, fall
within the category of those for which the question of how best to
compute them is little understood. These core problems of complexity
theory remain the most fundamental mathematical challenges of computer
science. They are related to foundational questions in quantum physics,
most notably through polynomial time versions of the Turing hypothesis.

In computer systems major conceptual challenges remain in controlling,
load-balancing and programming large parallel systems, whether they be
multi core devices on a chip or highly distributed systems.. how
to design algorithms for multi-core devices that are portable, and run
efficiently on wide classes of architectural designs with widely varying
performance characteristics.

A fundamental question for artificial intelligence is to characterize
the computational building blocks that are necessary for cognition. A
specific challenge is to build on the success of machine learning so as
to cover broader issues in intelligence. This requires, in particular a
reconciliation between two contradictory characteristics--the apparent
logical nature of reasoning and the statistical nature of learning.

In neuroscience a widely open problem remains how the weak model of
computation that cortex apparently offers can support cognitive
computation at all. .. how broad sets of primitive operations can be computed robustly and on a significant scale even on such a weak model.

A challenge in a different direction is understanding how Darwinian
evolution can evolve complex mechanisms in the numbers of generations
and with population sizes that have apparently been available on earth.
Darwin's notions of variation and selection are computational notions
and offer a very direct challenge for quantitative analysis by the
methods of computer science. What is sought is a quantitative
understanding of the possibilities and limitations of the basic
Darwinian process.

12. http://www.quora.com/What-are-currently-the-hot-topics-in-computer-science-research

Algorithms design and analysis ( For making the algorithms more efficient and powerful ).
Artificial Intelligence and machine learning.
NoSQL databases ( non-relational ) being used by major sites such as Facebook.
Optimizations in programming languages and their constructs.
Data Warehousing and Data Mining.
Threads, Mutexes and locks . (Synchronisation better algorithms).
Making programs smarter i.e programs spawning and managing programs when certain conditions are met.
Making browsers' http requests more faster using SPDY technology used in Chrome browsers.
Development of Smart Routers which adapt themselves to the varying traffic of packets.
HTML5 and OpenWeb technologies such as Firebug and Firephp.

13. http://www.quora.com/What-are-currently-the-hot-topics-in-computer-science-research

Topic Generated

A synchronized functional theorem prover for a balanced binary cache

Literature Review link

http://scholar.google.com/scholar?q=A%20synchronized%20functional%20theorem%20prover%20for%20a%20balanced%20binary%20cache

Monday, August 11, 2014

Data Structure & Algorithms Notes

http://www.cise.ufl.edu/~sahni/cop3530/powerpoint.htm

Saturday, August 9, 2014

C++ Pointers

To Go TO The Original Page , Please click the Link below

http://www.tutorialspoint.com/cplusplus/cpp_pointers.htm

======================================================

What is Pointers ?

C++ pointers are easy and fun to learn. Some C++ tasks are performed more easily with pointers, and other C++ tasks, such as dynamic memory allocation, cannot be performed without them.

As you know every variable is a memory location and every memory location has its address defined which can be accessed using ampersand (&) operator which denotes an address in memory. Consider the following which will print the address of the variables defined:

#include <iostream>

using namespace std;

int main ()
{
   int  var1;
   char var2[10];

   cout << "Address of var1 variable: ";
   cout << &var1 << endl;

   cout << "Address of var2 variable: ";
   cout << &var2 << endl;

   return 0;
}

When the above code is compiled and executed, it produces result something as follows:

Address of var1 variable: 0xbfebd5c0
Address of var2 variable: 0xbfebd5b6

What Are Pointers?

A pointer is a variable whose value is the address of another variable. Like any variable or constant, you must declare a pointer before you can work with it. The general form of a pointer variable declaration is:

type *var-name;

Here, type is the pointer's base type; it must be a valid C++ type and var-name is the name of the pointer variable. The asterisk you used to declare a pointer is the same asterisk that you use for multiplication. However, in this statement the asterisk is being used to designate a variable as a pointer. Following are the valid pointer declaration:

int    *ip;    // pointer to an integer
double *dp;    // pointer to a double
float  *fp;    // pointer to a float
char   *ch     // pointer to character

The actual data type of the value of all pointers, whether integer, float, character, or otherwise, is the same, a long hexadecimal number that represents a memory address. The only difference between pointers of different data types is the data type of the variable or constant that the pointer points to.

Using Pointers in C++:

There are few important operations, which we will do with the pointers very frequently. (a) we define a pointer variables (b) assign the address of a variable to a pointer and (c) finally access the value at the address available in the pointer variable. This is done by using unary operator * that returns the value of the variable located at the address specified by its operand. Following example makes use of these operations:

#include <iostream>

using namespace std;

int main ()
{
   int  var = 20;   // actual variable declaration.
   int  *ip;        // pointer variable 

   ip = &var;       // store address of var in pointer variable

   cout << "Value of var variable: ";
   cout << var << endl;

   // print the address stored in ip pointer variable
   cout << "Address stored in ip variable: ";
   cout << ip << endl;

   // access the value at the address available in pointer
   cout << "Value of *ip variable: ";
   cout << *ip << endl;

   return 0;
}

When the above code is compiled and executed, it produces result something as follows:

Value of var variable: 20
Address stored in ip variable: 0xbfc601ac
Value of *ip variable: 20

C++ Pointers in Detail:

Pointers have many but easy concepts and they are very important to C++ programming. There are following few important pointer concepts which should be clear to a C++ programmer:

Concept	Description
C++ Null Pointers	C++ supports null pointer, which is a constant with a value of zero defined in several standard libraries.
C++ pointer arithmetic	There are four arithmetic operators that can be used on pointers: ++, --, +, -
C++ pointers vs arrays	There is a close relationship between pointers and arrays. Let us check how?
C++ array of pointers	You can define arrays to hold a number of pointers.
C++ pointer to pointer	C++ allows you to have pointer on a pointer and so on.
Passing pointers to functions	Passing an argument by reference or by address both enable the passed argument to be changed in the calling function by the called function.
Return pointer from functions	C++ allows a function to return a pointer to local variable, static variable and dynamically allocated memory as well.

C++ Programming Language Object-Oriented Programming (OOP) in C++

yet another insignificant programming notes... | Goto HOME

TABLE OF CONTENTS (HIDE)

1.  Why OOP?
1.1  Traditional Procedural-Oriented languages
1.2  Object-Oriented Programming Languages
1.3  Benefits of OOP
2.  OOP Basics
2.1  Classes & Instances
2.2  A Class is a 3-Compartment Box encapsulating Data and Functions
2.3  Class Definition
2.4  Creating Instances of a Class
2.5  Dot (.) Operator
2.6  Data Members (Variables)
2.7  Member Functions
2.8  Putting them Together: An OOP Example
2.9  Constructors
2.10  Default Arguments for Functions
2.11  "public" vs. "private" Access Control Modifiers
2.12  Information Hiding and Encapsulation
2.13  Getters and Setters
2.14  Keyword "this"
2.15  "const" Member Functions
2.16  Convention for Getters/Setters and Constructors
2.17  Default Constructor
2.18  Constructor's Member Initializer List
2.19  *Destructor
2.20  *Copy Constructor
2.21  *Copy Assignment Operator (=)
3.  Separating Header and Implementation
4.  Example: The Circle Class
5.  Example: The Time Class
6.  Example: The Point Class
7.  Example: The Account Class
8.  Example: The Ball class
9.  Example: The Author and Book Classes (for a Bookstore)
9.1  Let's start with the Author class
9.2  A Book is written by an Author - Using an "Object" Data Member
9.3  Pass-by-Reference for Objects Function Parameters Author and string

C++ Programming Language

Object-Oriented Programming (OOP) in C++

1. Why OOP?

Suppose that you want to assemble your own PC, you go to a hardware store and pick up a motherboard, a processor, some RAMs, a hard disk, a casing, a power supply, and put them together. You turn on the power, and the PC runs. You need not worry whether the motherboard is a 4-layer or 6-layer board, whether the hard disk has 4 or 6 plates; 3 inches or 5 inches in diameter, whether the RAM is made in Japan or Korea, and so on. You simply put the hardware components together and expect the machine to run. Of course, you have to make sure that you have the correctinterfaces, i.e., you pick an IDE hard disk rather than a SCSI hard disk, if your motherboard supports only IDE; you have to select RAMs with the correct speed rating, and so on. Nevertheless, it is not difficult to set up a machine from hardware components.

Similarly, a car is assembled from parts and components, such as chassis, doors, engine, wheels, brake, and transmission. The components are reusable, e.g., a wheel can be used in many cars (of the same specifications).

Hardware, such as computers and cars, are assembled from parts, which are reusable components.

How about software? Can you "assemble" a software application by picking a routine here, a routine there, and expect the program to run? The answer is obviously no! Unlike hardware, it is very difficult to "assemble" an application from software components. Since the advent of computer 60 years ago, we have written tons and tons of programs. However, for each new application, we have to re-invent the wheels and write the program from scratch.

Why re-invent the wheels?

1.1 Traditional Procedural-Oriented languages

Can we do this in traditional procedural-oriented programming language such as C, Fortran, Cobol, or Pascal?

Traditional procedural-oriented languages (such as C and Pascal) suffer some notable drawbacks in creating reusable software components:

The programs are made up of functions. Functions are often not reusable. It is very difficult to copy a function from one program and reuse in another program because the the function is likely to reference the headers, global variables and other functions. In other words, functions are not well-encapsulated as a self-contained reusable unit.
The procedural languages are not suitable of high-level abstraction for solving real life problems. For example, C programs uses constructs such as if-else, for-loop, array, function, pointer, which are low-level and hard to abstract real problems such as a Customer Relationship Management (CRM) system or a computer soccer game. (Imagine using assembly codes, which is a very low level code, to write a computer soccer game. C is better but no much better.)

In brief, the traditional procedural-languages separate the data structures and algorithms of the software entities.

In the early 1970s, the US Department of Defense (DoD) commissioned a task force to investigate why its IT budget always went out of control; but without much to show for. The findings are:

80% of the budget went to the software (while the remaining 20% to the hardware).
More than 80% of the software budget went to maintenance (only the remaining 20% for new software development).
Hardware components could be applied to various products, and their integrity normally did not affect other products. (Hardware can share and reuse! Hardware faults are isolated!)
Software procedures were often non-sharable and not reusable. Software faults could affect other programs running in computers.

The task force proposed to make software behave like hardware OBJECT. Subsequently, DoD replaces over 450 computer languages, which were then used to build DoD systems, with an object-oriented language called Ada.

1.2 Object-Oriented Programming Languages

Object-oriented programming (OOP) languages are designed to overcome these problems.

The basic unit of OOP is a class, which encapsulates both the static attributes and dynamic behaviors within a "box", and specifies the public interface for using these boxes. Since the class is well-encapsulated (compared with the function), it is easier to reuse these classes. In other words, OOP combines the data structures and algorithms of a software entity inside the same box.
OOP languages permit higher level of abstraction for solving real-life problems. The traditional procedural language (such as C and Pascal) forces you to think in terms of the structure of the computer (e.g. memory bits and bytes, array, decision, loop) rather than thinking in terms of the problem you are trying to solve. The OOP languages (such as Java, C++, C#) let you think in the problem space, and use software objects to represent and abstract entities of the problem space to solve the problem.

As an example, suppose you wish to write a computer soccer games (which I consider as a complex application). It is quite difficult to model the game in procedural-oriented languages. But using OOP languages, you can easily model the program accordingly to the "real things" appear in the soccer games.

Player: attributes include name, number, location in the field, and etc; operations include run, jump, kick-the-ball, and etc.
Ball:
Reference:
Field:
Audience:
Weather:

Most importantly, some of these classes (such as Ball and Audience) can be reused in another application, e.g., computer basketball game, with little or no modification.

1.3 Benefits of OOP

The procedural-oriented languages focus on procedures, with function as the basic unit. You need to first figure out all the functions and then think about how to represent data.

The object-oriented languages focus on components that the user perceives, with objects as the basic unit. You figure out all the objects by putting all the data and operations that describe the user's interaction with the data.

Object-Oriented technology has many benefits:

Ease in software design as you could think in the problem space rather than the machine's bits and bytes. You are dealing with high-level concepts and abstractions. Ease in design leads to more productive software development.
Ease in software maintenance: object-oriented software are easier to understand, therefore easier to test, debug, and maintain.
Reusable software: you don't need to keep re-inventing the wheels and re-write the same functions for different situations. The fastest and safest way of developing a new application is to reuse existing codes - fully tested and proven codes.

2. OOP Basics

2.1 Classes & Instances

Class: A class is a definition of objects of the same kind. In other words, a class is a blueprint, template, or prototype that defines and describes the static attributes and dynamic behaviorscommon to all objects of the same kind.

Instance: An instance is a realization of a particular item of a class. In other words, an instance is an instantiation of a class. All the instances of a class have similar properties, as described in the class definition. For example, you can define a class called "Student" and create three instances of the class "Student" for "Peter", "Paul" and "Pauline".

The term "object" usually refers to instance. But it is often used quite loosely, which may refer to a class or an instance.

2.2 A Class is a 3-Compartment Box encapsulating Data and Functions

A class can be visualized as a three-compartment box, as illustrated:

Classname (or identifier): identifies the class.
Data Members or Variables (or attributes, states, fields): contains the static attributes of the class.
Member Functions (or methods, behaviors, operations): contains the dynamic operations of the class.

In other words, a class encapsulates the static attributes (data) and dynamic behaviors (operations that operate on the data) in a box.

Class Members: The data members and member functions are collectively called class members.

The followings figure shows a few examples of classes:

The following figure shows two instances of the class Student, identified as "paul" and "peter".

Unified Modeling Language (UML) Class and Instance Diagrams: The above class diagrams are drawn according to the UML notations. A class is represented as a 3-compartment box, containing name, data members (variables), and member functions, respectively. classname is shown in bold and centralized. An instance (object) is also represented as a 3-compartment box, with instance name shown as instanceName:Classname and underlined.

Brief Summary

A class is a programmer-defined, abstract, self-contained, reusable software entity that mimics a real-world thing.
A class is a 3-compartment box containing the name, data members (variables) and the member functions.
A class encapsulates the data structures (in data members) and algorithms (member functions). The values of the data members constitute its state. The member functions constitute its behaviors.
An instance is an instantiation (or realization) of a particular item of a class.

2.3 Class Definition

In C++, we use the keyword class to define a class. There are two sections in the class declaration: private and public, which will be explained later. For examples,

class Circle {         // classname
private:
   double radius;      // Data members (variables)
   string color;
public:   
   double getRadius(); // Member functions
   double getArea();
}

class SoccerPlayer {   // classname
private:
   int number;         // Data members (variables)
   string name;
   int x, y;
public:   
   void run();         // Member functions
   void kickBall();
}

Class Naming Convention: A classname shall be a noun or a noun phrase made up of several words. All the words shall be initial-capitalized (camel-case). Use a singular noun for classname. Choose a meaningful and self-descriptive classname. For examples, SoccerPlayer, HttpProxyServer, FileInputStream, PrintStream and SocketFactory.

2.4 Creating Instances of a Class

To create an instance of a class, you have to:

Declare an instance identifier (name) of a particular class.
Invoke a constructor to construct the instance (i.e., allocate storage for the instance and initialize the variables).

For examples, suppose that we have a class called Circle, we can create instances of Circle as follows:

// Construct 3 instances of the class Circle: c1, c2, and c3
Circle c1(1.2, "red");  // radius, color
Circle c2(3.4);         // radius, default color
Circle c3;              // default radius and color

Alternatively, you can invoke the constructor explicitly using the following syntax:

Circle c1 = Circle(1.2, "red");  // radius, color
Circle c2 = Circle(3.4);         // radius, default color
Circle c3 = Circle();            // default radius and color

2.5 Dot (.) Operator

To reference a member of a object (data member or member function), you must:

First identify the instance you are interested in, and then
Use the dot operator (.) to reference the member, in the form of instanceName.memberName.

For example, suppose that we have a class called Circle, with two data members (radius and color) and two functions (getRadius() and getArea()). We have created three instances of the class Circle, namely, c1, c2 and c3. To invoke the function getArea(), you must first identity the instance of interest, says c2, then use the dot operator, in the form of c2.getArea(), to invoke the getArea() function of instance c2.

For example,

// Declare and construct instances c1 and c2 of the class Circle
Circle c1(1.2, "blue");
Circle c2(3.4, "green");
// Invoke member function via dot operator
cout << c1.getArea() << endl;
cout << c2.getArea() << endl;
// Reference data members via dot operator
c1.radius = 5.5;
c2.radius = 6.6;

Calling getArea() without identifying the instance is meaningless, as the radius is unknown (there could be many instances of Circle - each maintaining its own radius).

In general, suppose there is a class called AClass with a data member called aData and a member function called aFunction(). An instance called anInstance is constructed for AClass. You use anInstance.aData and anInstance.aFunction().

2.6 Data Members (Variables)

A data member (variable) has a name (or identifier) and a type; and holds a value of that particular type (as descried in the earlier chapter). A data member can also be an instance of a certain class (to be discussed later).

Data Member Naming Convention: A data member name shall be a noun or a noun phrase made up of several words. The first word is in lowercase and the rest of the words are initial-capitalized (camel-case), e.g., fontSize, roomNumber, xMax, yMin and xTopLeft. Take note that variable name begins with an lowercase, while classname begins with an uppercase.

2.7 Member Functions

A member function (as described in the earlier chapter):

receives parameters from the caller,
performs the operations defined in the function body, and
returns a piece of result (or void) to the caller.

Member Function Naming Convention: A function name shall be a verb, or a verb phrase made up of several words. The first word is in lowercase and the rest of the words are initial-capitalized (camel-case). For example, getRadius(), getParameterValues().

Take note that data member name is a noun (denoting a static attribute), while function name is a verb (denoting an action). They have the same naming convention. Nevertheless, you can easily distinguish them from the context. Functions take arguments in parentheses (possibly zero argument with empty parentheses), but variables do not. In this writing, functions are denoted with a pair of parentheses, e.g., println(), getArea() for clarity.

2.8 Putting them Together: An OOP Example

A class called Circle is to be defined as illustrated in the class diagram. It contains two data members: radius (of type double) and color (of type String); and three member functions: getRadius(), getColor(), and getArea().

Three instances of Circles called c1, c2, and c3 shall then be constructed with their respective data members, as shown in the instance diagrams.

In this example, we shall keep all the codes in a single source file called CircleAIO.cpp.

CircleAIO.cpp

/* The Circle class (All source codes in one file) (CircleAIO.cpp) */
#include <iostream>    // using IO functions
#include <string>      // using string
using namespace std;
 
class Circle {
private:
   double radius;      // Data member (Variable)
   string color;       // Data member (Variable)
 
public:
   // Constructor with default values for data members
   Circle(double r = 1.0, string c = "red") {
      radius = r;
      color = c;
   }
 
   double getRadius() {  // Member function (Getter)
      return radius;
   }
 
   string getColor() {   // Member function (Getter)
      return color;
   }
 
   double getArea() {    // Member function
      return radius*radius*3.1416;
   }
};   // need to end the class declaration with a semi-colon
 
// Test driver function
int main() {
   // Construct a Circle instance
   Circle c1(1.2, "blue");
   cout << "Radius=" << c1.getRadius() << " Area=" << c1.getArea()
        << " Color=" << c1.getColor() << endl;
 
   // Construct another Circle instance
   Circle c2(3.4); // default color
   cout << "Radius=" << c2.getRadius() << " Area=" << c2.getArea()
        << " Color=" << c2.getColor() << endl;
 
   // Construct a Circle instance using default no-arg constructor
   Circle c3;      // default radius and color
   cout << "Radius=" << c3.getRadius() << " Area=" << c3.getArea()
        << " Color=" << c3.getColor() << endl;
   return 0;
}

To compile and run the program (with GNU GCC under Windows):

> g++ -o CircleAIO.exe CircleAIO.cpp
   // -o specifies the output file name
 
> CircleAIO
Radius=1.2 Area=4.5239 Color=blue
Radius=3.4 Area=36.3169 Color=red
Radius=1 Area=3.1416 Color=red

2.9 Constructors

A constructor is a special function that has the function name same as the classname. In the above Circle class, we define a constructor as follows:

// Constructor has the same name as the class
Circle(double r = 1.0, string c = "red") {
   radius = r;
   color = c;
}

A constructor is used to construct and initialize all the data members. To create a new instance of a class, you need to declare the name of the instance and invoke the constructor. For example,

Circle c1(1.2, "blue");
Circle c2(3.4);      // default color
Circle c3;           // default radius and color
                     // Take note that there is no empty bracket ()

A constructor function is different from an ordinary function in the following aspects:

The name of the constructor is the same as the classname.
Constructor has no return type (or implicitly returns void). Hence, no return statement is allowed inside the constructor's body.
Constructor can only be invoked once to initialize the instance constructed. You cannot call the constructor afterwards in your program.
Constructors are not inherited (to be explained later).

2.10 Default Arguments for Functions

In C++, you can specify the default value for the trailing arguments of a function (including constructor) in the function header. For example,

/* Test function default arguments (TestFnDefault.cpp) */
#include <iostream>
using namespace std;
 
// Function prototype
int sum(int n1, int n2, int n3 = 0, int n4 = 0, int n5 = 0);
 
int main() {
   cout << sum(1, 1, 1, 1, 1) << endl; // 5
   cout << sum(1, 1, 1, 1) << endl;    // 4
   cout << sum(1, 1, 1) << endl;       // 3
   cout << sum(1, 1) << endl;          // 2
// cout << sum(1) << endl;  // error: too few arguments
}
 
// Function definition
// The default values shall be specified in function prototype,
//   not the function implementation
int sum(int n1, int n2, int n3, int n4, int n5) {
   return n1 + n2 + n3 + n4 + n5;
}

2.11 "public" vs. "private" Access Control Modifiers

An access control modifier can be used to control the visibility of a data member or a member function within a class. We begin with the following two access control modifiers:

public: The member (data or function) is accessible and available to all in the system.
private: The member (data or function) is accessible and available within this class only.

For example, in the above Circle definition, the data member radius is declared private. As the result, radius is accessible inside the Circle class, but NOT outside the class. In other words, you cannot use "c1.radius" to refer to c1's radius in main(). Try inserting the statement "cout << c1.radius;" in main() and observe the error message:

CircleAIO.cpp:8:11: error: 'double Circle::radius' is private

Try moving radius to the public section, and re-run the statement.

On the other hand, the function getRadius() is declared public in the Circle class. Hence, it can be invoked in the main().

UML Notation: In UML notation, public members are denoted with a "+", while private members with a "-" in the class diagram.

2.12 Information Hiding and Encapsulation

A class encapsulates the static attributes and the dynamic behaviors into a "3-compartment box". Once a class is defined, you can seal up the "box" and put the "box" on the shelve for others to use and reuse. Anyone can pick up the "box" and use it in their application. This cannot be done in the traditional procedural-oriented language like C, as the static attributes (or variables) are scattered over the entire program and header files. You cannot "cut" out a portion of C program, plug into another program and expect the program to run without extensive changes.

Data member of a class are typically hidden from the outside word, with private access control modifier. Access to the private data members are provided via public assessor functions, e.g., getRadius() and getColor().

This follows the principle of information hiding. That is, objects communicate with each others using well-defined interfaces (public functions). Objects are not allowed to know the implementation details of others. The implementation details are hidden or encapsulated within the class. Information hiding facilitates reuse of the class.

Rule of Thumb: Do not make any data member public, unless you have a good reason.

2.13 Getters and Setters

To allow other to read the value of a private data member says xxx, you shall provide a get function (or getter or accessor function) called getXxx(). A getter need not expose the data in raw format. It can process the data and limit the view of the data others will see. Getters shall not modify the data member.

To allow other classes to modify the value of a private data member says xxx, you shall provide a set function (or setter or mutator function) called setXxx(). A setter could provide data validation (such as range checking), and transform the raw data into the internal representation.

For example, in our Circle class, the data members radius and color are declared private. That is to say, they are only available within the Circle class and not visible outside theCircle class - including main(). You cannot access the private data members radius and color from the main() directly - via says c1.radius or c1.color. The Circle class provides two public accessor functions, namely, getRadius() and getColor(). These functions are declared public. The main() can invoke these public accessor functions to retrieve the radiusand color of a Circle object, via says c1.getRadius() and c1.getColor().

There is no way you can change the radius or color of a Circle object, after it is constructed in main(). You cannot issue statements such as c1.radius = 5.0 to change the radius of instance c1, as radius is declared as private in the Circle class and is not visible to other including main().

If the designer of the Circle class permits the change the radius and color after a Circle object is constructed, he has to provide the appropriate setter, e.g.,

// Setter for color
void setColor(string c) {
   color = c;
}
   
// Setter for radius
void setRadius(double r) {
   radius = r;
}

With proper implementation of information hiding, the designer of a class has full control of what the user of the class can and cannot do.

2.14 Keyword "this"

You can use keyword "this" to refer to this instance inside a class definition.

One of the main usage of keyword this is to resolve ambiguity between the names of data member and function parameter. For example,

class Circle {
private:
   double radius;                 // Member variable called "radius"
   ......
public:
   void setRadius(double radius) { // Function's argument also called "radius"
      this->radius = radius;
         // "this.radius" refers to this instance's member variable
         // "radius" resolved to the function's argument.
   }
   ......
}

In the above codes, there are two identifiers called radius - a data member and the function parameter. This causes naming conflict. To resolve the naming conflict, you could name the function parameter r instead of radius. However, radius is more approximate and meaningful in this context. You can use keyword this to resolve this naming conflict. "this->radius" refers to the data member; while "radius" resolves to the function parameter.

"this" is actually a pointer to this object. I will explain pointer and the meaning of "->" operator later.

Alternatively, you could use a prefix (such as m_) or suffix (such as _) to name the data members to avoid name crashes. For example,

class Circle {
private:
   double m_radius;  // or radius_
   ......
public:
   void setRadius(double radius) {
      m_radius = radius;  // or radius_ = radius
   }
   ......
}

C++ Compiler internally names their data members beginning with a leading underscore (e.g., _xxx) and local variables with 2 leading underscores (e.g., __xxx). Hence, avoid name beginning with underscore in your program.

2.15 "const" Member Functions

A const member function, identified by a const keyword at the end of the member function's header, cannot modifies any data member of this object. For example,

double getRadius() const {  // const member function
   radius = 0;  
      // error: assignment of data-member 'Circle::radius' in read-only structure
   return radius;
}

2.16 Convention for Getters/Setters and Constructors

The constructor, getter and setter functions for a private data member called xxx of type T in a class Aaa have the following conventions:

class Aaa {
private:
   // A private variable named xxx of type T
   T xxx;
public:
   // Constructor
   Aaa(T x) { xxx = x; }
   // OR
   Aaa(T xxx) { this->xxx = xxx; }
   // OR using member initializer list (to be explained later)
   Aaa(T xxx) : xxx(xxx) { }
 
   // A getter for variable xxx of type T receives no argument and return a value of type T
   T getXxx() const { return xxx; }
 
   // A setter for variable xxx of type T receives a parameter of type T and return void
   void setXxx(T x) { xxx = x; }
   // OR
   void setXxx(T xxx) { this->xxx = xxx; }
}

For a bool variable xxx, the getter shall be named isXxx(), instead of getXxx(), as follows:

private:
   // Private boolean variable
   bool xxx;
public: 
   // Getter
   bool isXxx() const { return xxx; }
 
   // Setter
   void setXxx(bool x) { xxx = x; }
   // OR
   void setXxx(bool xxx) { this->xxx = xxx; }

2.17 Default Constructor

A default constructor is a constructor with no parameters, or having default values for all the parameters. For example, the above Circle's constructor can be served as default constructor with all the parameters default.

Circle c1;   // Declare c1 as an instance of Circle, and invoke the default constructor
Circle c1(); // Error!
             // (This declares c1 as a function that takes no parameter and returns a Circle instance)

If C++, if you did not provide ANY constructor, the compiler automatically provides a default constructor that does nothing. That is,

ClassName::ClassName() { }  // Take no argument and do nothing

Compiler will not provide a default constructor if you define any constructor(s). If all the constructors you defined require arguments, invoking no-argument default constructor results in error. This is to allow class designer to make it impossible to create an uninitialized instance, by NOT providing an explicit default constructor.

2.18 Constructor's Member Initializer List

Instead of initializing the private data members inside the body of the constructor, as follows:

Circle(double r = 1.0, string c = "red") {
   radius = r;
   color = c;
}

We can use an alternate syntax called member initializer list as follows:

Circle(double r = 1.0, string c = "red") : radius(r), color(c) { }

Member initializer list is placed after the constructor's header, separated by a colon (:). Each initializer is in the form of data_member_name(parameter_name). For fundamental type, it is equivalent to data_member_name = parameter_name. For object, the constructor will be invoked to construct the object. The constructor's body (empty in this case) will be run after the completion of member initializer list.

It is recommended to use member initializer list to initialize all the data members, as it is often more efficient than doing assignment inside the constructor's body.

2.19 *Destructor

A destructor, similar to constructor, is a special function that has the same name as the classname, with a prefix ~, e.g., ~Circle(). Destructor is called implicitly when an object is destroyed.

If you do not define a destructor, the compiler provides a default, which does nothing.

class MyClass {
public:
   // The default destructor that does nothing
   ~MyClass() { }
......
}

Advanced Notes

If your class contains data member which is dynamically allocated (via new or new[] operator), you need to free the storage via delete or delete[].

2.20 *Copy Constructor

A copy constructor constructs a new object by copying an existing object of the same type. In other words, a copy constructor takes an argument, which is an object of the same class.

If you do not define a copy constructor, the compiler provides a default which copies all the data members of the given object. For example,

Circle c4(7.8, "blue");
cout << "Radius=" << c4.getRadius() << " Area=" << c4.getArea()
     << " Color=" << c4.getColor() << endl;
                // Radius=7.8 Area=191.135 Color=blue
 
// Construct a new object by copying an existing object
// via the so-called default copy constructor
Circle c5(c4);
cout << "Radius=" << c5.getRadius() << " Area=" << c5.getArea()
     << " Color=" << c5.getColor() << endl;
                // Radius=7.8 Area=191.135 Color=blue

The copy constructor is particularly important. When an object is passed into a function by value, the copy constructor will be used to make a clone copy of the argument.

Advanced Notes

Pass-by-value for object means calling the copy constructor. To avoid the overhead of creating a clone copy, it is usually better to pass-by-reference-to-const, which will not have side effect on modifying the caller's object.

The copy constructor has the following signature:

class MyClass {
private:
   T1 member1;
   T2 member2;
public:
   // The default copy constructor which constructs an object via memberwise copy
   MyClass(const MyClass & rhs) {
      member1 = rhs.member1;
      member2 = rhs.member2;
   }
......
}

The default copy constructor performs shadow copy. It does not copy the dynamically allocated data members created via new or new[] operator.

2.21 *Copy Assignment Operator (=)

The compiler also provides a default assignment operator (=), which can be used to assign one object to another object of the same class via memberwise copy. For example, using theCircle class defined earlier,

Circle c6(5.6, "orange"), c7;
cout << "Radius=" << c6.getRadius() << " Area=" << c6.getArea()
     << " Color=" << c6.getColor() << endl;
                // Radius=5.6 Area=98.5206 Color=orange
cout << "Radius=" << c7.getRadius() << " Area=" << c7.getArea()
     << " Color=" << c7.getColor() << endl;
                // Radius=1 Area=3.1416 Color=red (default constructor)
 
c7 = c6; // memberwise copy assignment
cout << "Radius=" << c7.getRadius() << " Area=" << c7.getArea()
     << " Color=" << c7.getColor() << endl;
                // Radius=5.6 Area=98.5206 Color=orange

Advanced Notes

You could overload the assignment opeator to override the default.

The copy constructor, instead of copy assignment operator, is used in declaration:

Circle c8 = c6;  // Invoke the copy constructor, NOT copy assignment operator
                 // Same as Circle c8(c6)

The default copy assignment operator performs shadow copy. It does not copy the dynamically allocated data members created via new or new[] operator.

The copy assignment operator has the following signature:

class MyClass {
private:
   T1 member1;
   T2 member2;
public:
   // The default copy assignment operator which assigns an object via memberwise copy
   MyClass & operator=(const MyClass & rhs) {
      member1 = rhs.member1;
      member2 = rhs.member2;
      return *this;
   }
......
}

The copy assignment operator differs from the copy constructor in that it must release the dynamically allocated contents of the target and prevent self assignment. The assignment operator shall return a reference of this object to allow chaining operation (such as x = y = z).
The default constructor, default destructor, default copy constructor, default copy assignment operators are known as special member functions, in which the compiler will automatically generate a copy if they are used in the program and not explicitly defined.

3. Separating Header and Implementation

For better software engineering, it is recommended that the class declaration and implementation be kept in 2 separate files: declaration is a header file ".h"; while implementation in a ".cpp". This is known as separating the public interface (header declaration) and the implementation. Interface is defined by the designer, implementation can be supplied by others. While the interface is fixed, different vendors can provide different implementations. Furthermore, only the header files are exposed to the users, the implementation can be provided in an object file ".o" (or in a library). The source code needs not given to the users.

I shall illustrate with the following examples.

4. Example: The Circle Class

Instead of putting all the codes in a single file. We shall "separate the interface and implementation" by placing the codes in 3 files.

Circle.h: defines the public interface of the Circle class.
Circle.cpp: provides the implementation of the Circle class.
TestCircle.cpp: A test driver program for the Circle class.

Circle.h - Header

/* The Circle class Header (Circle.h) */
#include <string>   // using string
using namespace std;
 
// Circle class declaration
class Circle {
private:   // Accessible by members of this class only
   // private data members (variables)
   double radius;
   string color;
 
public:    // Accessible by ALL
   // Declare prototype of member functions
   // Constructor with default values
   Circle(double radius = 1.0, string color = "red");
 
   // Public getters & setters for private data members
   double getRadius() const;
   void setRadius(double radius);
   string getColor() const;
   void setColor(string color);
 
   // Public member Function
   double getArea() const;
};

Program Notes:

The header file contains declaration statements, that tell the compiler about the names and types, and function prototypes without the implementation details.
C++98/03 does NOT allow you to assign an initial value to a data member (except const static members). Date members are to be initialized via the constructor. For example,
```
double radius = 1.0;
   // error: ISO C++ forbids in-class initialization of non-const static member 'radius'
```
C++11 allows in-class initialization of data members.
You can provide default value to function's arguments in the header. For example,
```
Circle(double radius = 1.0, string color = "red");
```
Header contains function prototype, the parameter names are ignored by the compiler, but good to serve as documentation. For example, you can leave out the parameter names in the prototype as follows:
```
Circle(double = 1.0, string = "red");   // without identifiers
   // Identifiers not needed in prototype but good to serve as documentation
```

Header files shall contains constants, function prototypes, class/struct declarations.

Circle.cpp - Implementation

/* The Circle class Implementation (Circle.cpp) */
#include "Circle.h" // user-defined header in the same directory
 
// Constructor
// default values shall only be specified in the declaration,
// cannot be repeated in definition
Circle::Circle(double r, string c) {
   radius = r;
   color = c;
}
 
// Public getter for private data member radius
double Circle::getRadius() const {
   return radius;
}
 
// Public setter for private data member radius
void Circle::setRadius(double r) {
   radius = r;
}
 
// Public getter for private data member color
string Circle::getColor() const {
   return color;
}
 
// Public setter for private data member color
void Circle::setColor(string c) {
   color = c;
}
 
// A public member function
double Circle::getArea() const {
   return radius*radius*3.14159265;
}

Program Notes:

The implementation file provides the definition of the functions, which are omitted from the declaration in the header file.
#include "Circle.h"
The compiler searches the headers in double quotes (such as "Circle.h") in the current directory first, then the system's include directories. For header in angle bracket (such as<iostream>), the compiler does NOT searches the current directory, but only the system's include directories. Hence, use double quotes for user-defined headers.
Circle::Circle(double r, string c) {
You need to include the className:: (called class scope resolution operator) in front of all the members names, so as to inform the compiler this member belong to a particular class.
(Class Scope: Names defined inside a class have so-called class scope. They are visible within the class only. Hence, you can use the same name in two different classes. To use these names outside the class, the class scope resolution operator className:: is needed.)
You CANNOT place the default arguments in the implementation (they shall be placed in the header). For example,
```
Circle::Circle(double r = 1.0, string c = "red") {   // error!
```

Compiling the Circle Class

You can compile the Circle.cpp to an object file called Circle.o, via option -c (compile-only) in GNU GCC:

> g++ -c Circle.cpp
    // option –c for compile-only, output is Circle.o

To use the Circle class, the user needs Circle.h and Circle.o. He does not need Circle.cpp. In other words, you do not need to give away your source codes, but merely the public declarations and the object codes.

TestCircle.cpp - Test Driver

Let's write a test program to use the Circle class created.

/* A test driver for the Circle class (TestCircle.cpp) */
#include <iostream>
#include "Circle.h"   // using Circle class
using namespace std;
 
int main() {
   // Construct an instance of Circle c1
   Circle c1(1.2, "red");
   cout << "Radius=" << c1.getRadius() << " Area=" << c1.getArea()
        << " Color=" << c1.getColor() << endl;
 
   c1.setRadius(2.1);   // Change radius and color of c1
   c1.setColor("blue");
   cout << "Radius=" << c1.getRadius() << " Area=" << c1.getArea()
        << " Color=" << c1.getColor() << endl;
 
   // Construct another instance using the default constructor
   Circle c2;
   cout << "Radius=" << c2.getRadius() << " Area=" << c2.getArea()
        << " Color=" << c2.getColor()  << endl;
   return 0;
}

Compiling the Test Program

To compile TestCircle.cpp with the object code Circle.o (and Circle.h):

> g++ -o TestCircle.exe TestCircle.cpp Circle.o
     // option -o specifies the output filename

You can also compile TestCircle.cpp with the source code Circle.cpp (and Circle.h)

> g++ -o TestCircle.exe TestCircle.cpp Circle.cpp

5. Example: The Time Class

Let's write a class called Time, which models a specific instance of time with hour, minute and second values, as shown in the class diagram.

The class Time contains the following members:

Three private data members: hour (0-23), minute (0-59) and second (0-59), with default values of 0.
A public constructor Time(), which initializes the data members hour, minute and second with the values provided by the caller.
public getters and setters for private data members: getHour(), getMinute(), getSecond(), setHour(),setMinute(), and setSecond().
A public member function setTime() to set the values of hour, minute and second given by the caller.
A public member function print() to print this Time instance in the format "hh:mm:ss", zero-filled, e.g.,01:30:04.
A public member function nextSecond(), which increase this instance by one second. nextSecond() of23:59:59 shall be 00:00:00.

Let's write the code for the Time class, with the header and implementation separated in two files: Time.h andTime.cpp.

Header - Time.h

/* Header for the Time class (Time.h) */
#ifndef TIME_H   // Include this "block" only if TIME_H is NOT defined
#define TIME_H   // Upon the first inclusion, define TIME_H so that
                 //  this header will not get included more than once
class Time {
private:  // private section
   // private data members
   int hour;     // 0 - 23
   int minute;   // 0 - 59
   int second;   // 0 - 59
 
public:   // public section
   // public member function prototypes
   Time(int h = 0, int m = 0, int s = 0); // Constructor with default values
   int getHour() const;   // public getter for private data member hour
   void setHour(int h);   // public setter for private data member hour
   int getMinute() const; // public getter for private data member minute
   void setMinute(int m); // public setter for private data member minute
   int getSecond() const; // public getter for private data member second
   void setSecond(int s); // public setter for private data member second
   void setTime(int h, int m, int s);   // set hour, minute and second
   void print() const; // Print a description of this instance in "hh:mm:ss"
   void nextSecond();  // Increase this instance by one second
};  // need to terminate the class declaration with a semicolon
 
#endif  // end of "#ifndef" block

Dissecting Time.h

#ifndef TIME_H
#define TIME_H
......
#endif
To prevent an header file from included more than once into a source file (which could result in compilation error if an entity is declared twice, e.g., int i), we wrap the header codes within a pair of preprocessor directives #ifndef (if not define) and #endif. The codes within the if-block will only be included if the identifier TIME_H has not been defined. This is true for the first inclusion, which also defines the identifier TIME_H (the first directive in body of the if-block). No subsequent inclusion is possible, since TIME_H has been defined during the first inclusion. By convention, use the identifier XXX_H (or XXX_H_INCLUDED) for header Xxx.h.

class Time {
private:
......
public:
......
};
The header Time.h contains the class declaration for the class Time. It is divided into two sections: private and public. The private members (data or functions) are accessible by members of this class only, while public members are visible by all (such as the main() function which is outside the class). The class declaration must be terminated by a semicolon.

private:
   int hour;
   int minute;
   int second;
public:
   ......
We declare 3 private data members called hour, minute and second. In C++98/C++03, you are NOT allow to initialize a data member in the class declaration (except const static int data members). For example, setting hour = 0 causes a compilation error. Instead, the data members are to be initialized in the constructor (to be shown later). The newer C++11 allows initialization of data members.

Only member function prototypes are listed in the class declaration. A function prototype consists of the return-type, function name and parameter types.

Time(int h = 0, int m = 0, int s = 0);
declares the so-called constructor. A constructor is a special function that has the same name as the class. A constructor has no return type, or implicitly return void. No return statement is allowed inside the constructor's body. A constructor can only be used during the instance declaration to initialize the data members of the instance. It cannot be invoked thereafter.

In the function prototypes of the header, we can set the default values of the function's parameters for any function member using "= default-value". In this case, this constructor can be invoked with 0 to 3 arguments, the omitted trailing arguments will be set to their default values, e.g.,

Time t1(1, 2, 3); // no default used
Time t2(1, 2);    // s = 0 (default)
Time t3(1);       // m = 0, s = 0 (defaults)
Time t4;          // h = 0, m = 0, s = 0 (all defaults) - no empty parentheses ()

The identifiers h, m and s are not needed in the function prototype - you only need to specify the parameters' types. But they serve as proper documentation, and are strongly recommended.

int getHour() const;
void setHour(int h);
int getHour() const;
void setHour(int h);
int getHour() const;
void setHour(int h);declare the so-called getter and setter for the private data member hour, minute and second. Since the data members are private and are not accessible outside the class, public getters and setters are often provided to read and modify the private data members. By convention, a getter receives nothing (void) from the caller and returns a value of the type of the data member; a setter receives a value of the type of the data member and returns void. Setters may validate the input before setting the value of the data member.
We declare the getter function constant, by placing the keyword const after the function parameter list. A const member function cannot modify any data member of this object. Getter does not need to modify any data member.

void setTime(int h, int m, int s);declares a public member function to set the hour, minute and second of this instance in one call.

void print() const;declares a public member function to print this instance in the format HH:MM:SS, zero-filled, e.g., 01:56:09. The function print() returns void.

void nextSecond();declares a public member function to increase this instance by one second. For example, 23:59:59 becomes 00:00:00. The function nextSecond() returns void.

Implementation - Time.cpp

/* Implementation for the Time Class (Time.cpp) */
#include <iostream>
#include <iomanip>
#include "Time.h"    // include header of Time class
using namespace std;
 
// Constructor with default values. No input validation
Time::Time(int h, int m, int s) {
   hour = h;
   minute = m;
   second = s;
}
 
// public getter for private data member hour
int Time::getHour() const {
   return hour;
}
 
// public setter for private data member hour. No input validation
void Time::setHour(int h) {
   hour = h;
}
 
// public getter for private data member minute
int Time::getMinute() const {
   return minute;
}
 
// public setter for private data member minute. No input validation
void Time::setMinute(int m) {
   minute = m;
}
 
// public getter for private data member second
int Time::getSecond() const {
   return second;
}
 
// public setter for private data member second. No input validation
void Time::setSecond(int s) {
   second = s;
}
 
// Set hour, minute and second. No input validation
void Time::setTime(int h, int m, int s) {
   hour = h;
   minute = m;
   second = s;
}
 
// Print this Time instance in the format of "hh:mm:ss", zero filled
void Time::print() const {
   cout << setfill('0');    // zero-filled, need <iomanip>, sticky
   cout << setw(2) << hour  // set width to 2 spaces, need <iomanip>, non-sticky
        << ":" << setw(2) << minute
        << ":" << setw(2) << second << endl;
}
 
// Increase this instance by one second
void Time::nextSecond() {
   ++second;
   if (second >= 60) {
      second = 0;
      ++minute;
   }
   if (minute >= 60) {
      minute = 0;
      ++hour;
   }
   if (hour >= 24) {
      hour = 0;
   }
}

Dissecting Time.cpp

The implementation file Time.cpp contains member's definitions (whereas the header file contains the declarations), in particular, member functions.

All member's identifiers in the implementation are preceded by the classname and the scope resolution operator (::), e.g., Time::Time and Time::getHour, so that the compiler can tell that these identifiers belong to a particular class, in this case, Time.

Time::Time(int h, int m, int s) {
   hour = h;
   minute = m;
   second = s;
}
In the constructor, we initialize the private data members hour, minute and second based on the inputs provided by the caller. C++ does NOT initialize fundamental-type (e.g., int,double) data members. It also does NOT issue an error message if you use an data member before it is initialized. Hence, It is strongly recommended to initialize all the data members in the constructor, so that the constructed instance is complete, instead of relying on the user to set the values of the data members after construction.

The default values of the parameters are specified in the class declaration (in the header), NOT in the function definition. Placing a default value in function definition (e.g., h = 0) causes a compilation error.

Take note that we have not included input validation (e.g., hour shall be between 0 and 23) in the constructor (and setters). We shall do that in the later example.

int Time::getHour() const {
return hour;
}
the public getter for private data member hour simply returns the value of the data member hour.

void Time::setHour(int h) {
hour = h;
}
the public setter for private data member hour sets the data member hour to the given value h. Again, there is no input validation for h (shall be between 0 to 23).

The rest of the function definitions are self-explanatory.

"this" Pointer

Instead of naming the function parameters h, m and s, we would like to name the parameters hour, minute and second, which are semantically more meaningful. However, these names crashes with the names of private data members. C++ provides a keyword this (which is a pointer to this instance - to be discussed later) to differentiate between the data members and function parameters. this->hour, this->minute and this->second refer to the data members; while hour, minute, and second refer to the function parameters. We can rewrite the constructor and setter as follows:

Time::Time(int hour, int minute, int second) {  // Constructor
   this->hour = hour;
   this->minute = minute;
   this->second = second;
}
 
Time::setHour(int hour) {   // Setter for hour
   this->hour = hour;
}
 
Time::getHour() const {  // Getter for hour
   return this->hour;    // this-> is the default, and hence optional
}

Member Initializer List

C++ provide an alternative syntax to initialize data members in the constructor called member initializer list. For example,

Time::Time(int h, int m, int s) : hour(h), minute(m), second(s) { 
   // The body runs after the member initializer list
   // empty in this case
}

The member initializer list is placed after the function parameter list, separated by a colon, in the form of dataMemberName(parameters). For fundamental-type data members (e.g., int,double), hour(h) is the same as hour = h. For object data members (to be discussed later), the copy constructor will be invoked. The function body will be executed after the member initializer list, which is empty in this case.

The data members in the initializer list are initialized in the order of their declarations in the class declaration, not the order in the initializer list.

Test Driver - TestTime.cpp

/* Test Driver for the Time class (TestTime.cpp) */
#include <iostream>
#include "Time.h"    // include header of Time class
using namespace std;
 
int main() {
   Time t1(23, 59, 59);   // Test constructor
 
   // Test all public member functions
   t1.print();       // 23:59:59
   t1.setHour(12);
   t1.setMinute(30);
   t1.setSecond(15);
   t1.print();       // 12:30:15
   cout << "Hour is "   << t1.getHour()   << endl;
   cout << "Minute is " << t1.getMinute() << endl;
   cout << "Second is " << t1.getSecond() << endl;
 
   Time t2;     // Test constructor with default values for hour, minute and second
   t2.print();  // 00:00:00
   t2.setTime(1, 2, 3);
   t2.print();  // 01:02:03
 
   Time t3(12); // Use default values for minute and second
   t3.print();  // 12:00:00
 
   // Test nextSecond()
   Time t4(23, 59, 58);
   t4.print();
   t4.nextSecond();
   t4.print();
   t4.nextSecond();
   t4.print();
 
   // No input validation
   Time t5(25, 61, 99); // values out of range
   t5.print();  // 25:61:99
}

Dissecting TestTime.cpp

The test driver tests the constructor (with and without the default values) and all the public member functions. Clearly, no input validation is carried out, as reflected in instance t5.

Exercise

Add member functions previousSecond(), nextMinute(), previousMinute(), nextHour(), previousHour() to the Time class.

Compiling the Program

You can compile all the source file together to get the executable file as follows:

// Using GCC on Windows
// Compile all source files, -o specifies the output
> g++ -o TestTime.exe Time.cpp TestTime.cpp  
// Execute the program
> TestTime

Alternatively, you can compile Time.cpp into an object file Time.o, and then the test driver with the object file. In this way, you only distribute the object file and header file, not the source file.

// Compile Time.cpp into object file Time.o, with -c option
> g++ -c Time.cpp
// Compile test driver with object file
> g++ -o TestTime.exe TestTime.cpp Time.o
// Execute the test driver
> TestTime

6. Example: The Point Class

The Point class, as shown in the class diagram, models 2D points with x and y co-ordinates.

In the class diagram, "-" denotes private member; "+" denotes public member. "= xxx" specifies the default value of a data member.

The Point class contains the followings:

Private data members x and y (of type int), with default values of 0.
A constructor, getters and setters for private data member x and y.
A function setXY() to set both x and y coordinates of a Point.
A function getMagnitude() which returns √(x²+y²). You can use the built-in sqrt() function in <cmath> to compute the square root.
A function getArgument() which returns tan^-1(y/x). You can use the built-in atan2(y, x) function in <cmath> to compute the gradient in radians.
A function print() which prints "(x,y)" of this instance.

Point.h - Header

/* The Point class Header (Point.h) */
#ifndef POINT_H
#define POINT_H
 
// Point class declaration
class Point {
private:
   // private data members (variables)
   int x;
   int y;
 
public:
   // Declare member function prototypes
   Point(int x = 0, int y = 0);  // Constructor with default values
   int getX() const;
   void setX(int x);
   int getY() const;
   void setY(int y);
   void setXY(int x, int y);
   double getMagnitude() const;
   double getArgument() const;
   void print() const;
};
 
#endif

Point.cpp - Implementation

/* The Point class Implementation (Point.cpp) */
#include "Point.h" // user-defined header in the same directory
#include <iostream>
#include <cmath>
using namespace std;
 
// Constructor (default values can only be specified in the declaration)
Point::Point(int x, int y) : x(x), y(y) { }  // Use member initializer list
 
// Public getter for private data member x
int Point::getX() const {
   return x;
}
 
// Public setter for private data member x
void Point::setX(int x) {
   this->x = x;
}
 
// Public getter for private data member y
int Point::getY() const {
   return y;
}
 
// Public setter for private data member y
void Point::setY(int y) {
   this->y = y;
}
 
// Public member function to set both x and y
void Point::setXY(int x, int y) {
   this->x = x;
   this->y = y;
}
 
// Public member function to return the magitude
double Point::getMagnitude() const {
   return sqrt(x*x + y*y);    // sqrt in <cmath>
}
 
// Public member function to return the argument
double Point::getArgument() const {
   return atan2(y, x);    // atan2 in <cmath>
}
 
// Public member function to print description about this point
void Point::print() const {
   cout << "(" << x << "," << y << ")" << endl;
}

TestPoint.cpp - Test Driver

/* A test driver for the Point class (TestPoint.cpp) */
#include <iostream>
#include <iomanip>
#include "Point.h"   // using Point class
using namespace std;
 
int main() {
   // Construct an instance of Point p1
   Point p1(3, 4);
   p1.print();
   cout << "x = " << p1.getX() << endl;
   cout << "y = " << p1.getY() << endl;
   cout << fixed << setprecision(2);
   cout << "mag = " << p1.getMagnitude() << endl;
   cout << "arg = " << p1.getArgument() << endl;
   p1.setX(6);
   p1.setY(8);
   p1.print();
   p1.setXY(1, 2);
   p1.print();
 
   // Construct an instance of Point using default constructor
   Point p2;
   p2.print();
}

7. Example: The Account Class

A class called Account, which models a bank account, is designed as shown in the class diagram. It contains:

Two private data members: accountNumber (int) and balance (double), which maintains the current account balance.
Public functions credit() and debit(), which adds or subtracts the given amount from the balance, respectively. The debit() function shall print "amount withdrawn exceeds the current balance!" if amount is more than balance.
A public function print(), which shall print "A/C no: xxx Balance=xxx" (e.g., A/C no: 991234 Balance=$88.88), withbalance rounded to two decimal places.

Header file - Account.h

/* Header for Account class (Account.h) */
#ifndef ACCOUNT_H
#define ACCOUNT_H
 
class Account {
private:
   int accountNumber;
   double balance;
 
public:
   Account(int accountNumber, double balance = 0.0);
   int getAccountNumber() const;
   double getBalance() const;
   void setBalance(double balance);
   void credit(double amount);
   void debit(double amount);
   void print() const;
};
 
#endif

Implementation file - Account.cpp

/* Implementation for the Account class (Account.cpp) */
#include <iostream>
#include <iomanip>
#include "Account.h"
using namespace std;
 
// Constructor
Account::Account(int no, double b) : accountNumber(no), balance(b) { }
 
// Public getter for private data member accountNumber
int Account::getAccountNumber() const {
   return accountNumber;
}
 
// Public getter for private data member balance
double Account::getBalance() const {
   return balance;
}
 
// Public setter for private data member balance
void Account::setBalance(double b) {
   balance = b;
}
 
// Adds the given amount to the balance
void Account::credit(double amount) {
   balance += amount;
}
 
// Subtract the given amount from the balance
void Account::debit(double amount) {
   if (amount <= balance) {
      balance -= amount;
   } else {
      cout << "Amount withdrawn exceeds the current balance!" << endl;
   }
}
 
// Print description for this Account instance
void Account::print() const {
   cout << fixed << setprecision(2);
   cout << "A/C no: " << accountNumber << " Balance=$" << balance << endl;
}

Test Driver - TestAccount.cpp

/* Test Driver for Account class (TestAccount.cpp) */
#include <iostream>
#include "Account.h"
 
using namespace std;
 
int main() {
    Account a1(8111, 99.99);
    a1.print();     // A/C no: 8111 Balance=$99.99
    a1.credit(20);
    a1.debit(10);
    a1.print();     // A/C no: 8111 Balance=$109.99
 
    Account a2(8222);  // default balance
    a2.print();        // A/C no: 8222 Balance=$0.00
    a2.setBalance(100);
    a2.credit(20);
    a2.debit(200);  // Amount withdrawn exceeds the current balance!
    a2.print();     // A/C no: 8222 Balance=$120.00
    return 0;
}

8. Example: The Ball class

A Ball class models a moving ball, designed as shown in the class diagram, contains the following members:

Four private data members x, y, xSpeed and ySpeed to maintain the position and speed of the ball.
A constructor, and public getters and setters for the private data members.
A function setXY(), which sets the position of the ball and setXYSpeed() to set the speed of the ball.
A function move(), which increases x and y by xSpeed and ySpeed, respectively.
A function print(), which prints "Ball @ (x,y) with speed (xSpeed,ySpeed)", to 2 decimal places.

Header File - Ball.h

/* Header for the Ball class (Ball.h) */
#ifndef BALL_H
#define BALL_H
 
class Ball {
private:
   double x, y;           // Position of the ball
   double xSpeed, ySpeed; // Speed of the ball
 
public:
   Ball(double x = 0.0, double y = 0.0,  // Constructor with default values
        double xSpeed = 0.0, double ySpeed = 0.0);
   double getX() const;
   void setX(double x);
   double getY() const;
   void setY(double y);
   double getXSpeed() const;
   void setXSpeed(double xSpeed);
   double getYSpeed() const;
   void setYSpeed(double ySpeed);
   void setXY(double x, double y);
   void setXYSpeed(double xSpeed, double ySpeed);
   void move();
   void print() const;
};
 
#endif

Implementation File - Ball.cpp

/* Implementation for the Ball Class (Ball.cpp) */
#include <iostream>
#include <iomanip>
#include "Ball.h"    // include header of Ball class
using namespace std;
 
// Constructor with default values. No input validation
Ball::Ball(double x, double y, double xSpeed, double ySpeed)
      : x(x), y(y), xSpeed(xSpeed), ySpeed(ySpeed) { }  // use member initializer list
 
// public getters/setters for private data members
double Ball::getX() const {
   return x;
}
double Ball::getY() const {
   return y;
}
void Ball::setX(double x) {
   this->x = x;
}
void Ball::setY(double y) {
   this->y = y;
}
double Ball::getXSpeed() const {
   return xSpeed;
}
double Ball::getYSpeed() const {
   return ySpeed;
}
void Ball::setXSpeed(double xSpeed) {
   this->xSpeed = xSpeed;
}
void Ball::setYSpeed(double ySpeed) {
   this->ySpeed = ySpeed;
}
 
// Set position (x,y)
void Ball::setXY(double x, double y) {
   this->x = x;
   this->y = y;
}
 
// Set speed (xSpeed,ySpeed)
void Ball::setXYSpeed(double xSpeed, double ySpeed) {
   this->xSpeed = xSpeed;
   this->ySpeed = ySpeed;
}
 
// Move the ball by increases x and y by xSpeed and ySpeed
void Ball::move() {
   x += xSpeed;   // increment x by xSpeed
   y += ySpeed;   // increment y by ySpeed
}
 
// Print a description about this Ball instance
void Ball::print() const {
   cout << fixed << setprecision(2);
   cout << "Ball @ (" << x << ',' << y << ") with speed ("
        << xSpeed << ',' << ySpeed << ')' << endl;
}

Test Driver - TestBall.cpp

/* Test Driver for the Ball class (TestBall.cpp) */
#include <iostream>
#include "Ball.h"    // include header of Ball class
using namespace std;
 
int main() {
   Ball ball;
   ball.print();    // Ball @ (0.00,0.00) with speed (0.00,0.00)
   ball.setXY(1.1, 2.2);
   ball.setXYSpeed(3.3, 4.4);
   ball.print();    // Ball @ (1.10,2.20) with speed (3.30,4.40)
   ball.setX(5.5);
   ball.setY(6.6);
   cout << "x is " << ball.getX() << endl;  // x is 5.50
   cout << "y is " << ball.getY() << endl;  // y is 6.60
   ball.move();
   ball.print();    // Ball @ (8.80,11.00) with speed (3.30,4.40)
}

9. Example: The Author and Book Classes (for a Bookstore)

9.1 Let's start with the Author class

Let's begin with a class called Author, designed as shown in the class diagram. It contains:

Three private data members: name (string), email (string), and gender (char of 'm', 'f'or 'u' for unknown).
A constructor to initialize the name, email and gender with the given values. There are no default values for data members.
Getters for name, email and gender, and setter for email. There is no setter for name andgender as we assume that these attributes cannot be changed.
A print() member function that prints "name (gender) at email", e.g., "Peter Jones (m) at peter@somewhere.com".

Header File - Author.h

/* Header for the Author class (Author.h) */
#ifndef AUTHOR_H
#define AUTHOR_H
 
#include <string>
using namespace std;
 
class Author {
private:
   string name;
   string email;
   char gender;   // 'm', 'f', or 'u' for unknown
 
public:
   Author(string name, string email, char gender);
   string getName() const;
   string getEmail() const;
   void setEmail(string email);
   char getGender() const;
   void print() const;
};
 
#endif

Implementation File - Author.cpp

/* Implementation for the Author class (Author.cpp) */
#include <iostream>
#include "Author.h"
using namespace std;
 
// Constructor, with input validation
Author::Author(string name, string email, char gender) {
   this->name = name;
   setEmail(email);  // Call setter to check for valid email
   if (gender == 'm' || gender == 'f') {
      this->gender = gender;
   } else {
      cout << "Invalid gender! Set to 'u' (unknown)." << endl;
      this->gender = 'u';
   }
}
 
string Author::getName() const {
   return name;
}
 
string Author::getEmail() const {
   return email;
}
 
void Author::setEmail(string email) {
   // Check for valid email. Assume that a valid email contains
   //  a '@' that is not the first nor last character.
   size_t atIndex = email.find('@');
   if (atIndex != string::npos && atIndex != 0 && atIndex != email.length()-1) {
      this->email = email;
   } else {
      cout << "Invalid email! Set to empty string." << endl;
      this->email = "";
   }
}
 
char Author::getGender() const {
   return gender;
}
 
// print in the format "name (gender) at email"
void Author::print() const {
   cout << name << " (" << gender << ") at " << email << endl;
}

Dissecting the Author.cpp

Author::Author(string name, string email, char gender) {
this->name = name;
setEmail(email);In this example, we use identifier name in the function's parameter, which crashes with the data member's identifier name. To differentiate between the two identifiers, we use the keywordthis, which is a pointer to this instance. this->name refers to the data member; while name refers to the function's parameter.
No input validation is done on the parameter name. On the other hand, for email, we invoke setter setEmail() which performs input validation.

   if (gender == 'm' || gender == 'f') {
      this->gender = gender;
   } else {
      cout << "Invalid gender! Set to 'u' (unknown)." << endl;
      this->gender = 'u';
   }
}
We validate the input for gender ('m', 'f', or 'u' for unknown). We assign 'u' for any other inputs.

void Author::setEmail(string email) {
   size_t found = email.find('@');
   if (found != string::npos && found != 0 && found != email.length()-1) {
      this->email = email;
   } else {
      cout << "Invalid email! Set to empty string." << endl;
      this->email = "";
   }
}
To validate email, we assume that there is an '@' which is not the first or last character (there are other stricter email validation criteria). We use the string class function find() to find the position of the character '@', which returns a value of type size_t (typically same as unsigned int). The function find() returns a special constant string::npos (which is typically set to -1) to indicate "not found"; 0 for the first character and length()-1 for the last character (where string's function length() returns the length of the string).

TestAuthor.cpp

/* Test Driver for the Author class (TestAuthor.cpp) */
#include "Author.h"
 
int main() {
   // Declare and construct an instance of Author
   Author peter("Peter Jones", "peter@somewhere.com", 'm');
   peter.print();
      // Peter Jones (m) at peter@somewhere.com
   peter.setEmail("peter@xyz.com");
   peter.print();
      // Peter Jones (m) at peter@xyz.com
 
   Author paul("Paul Jones", "@somewhere.com", 'n');
      // Invalid email! Set to empty string.
      // Invalid gender! Set to 'u' (unknown).
   paul.setEmail("paul@");
      // Invalid email! Set to empty string.
   paul.print();
      // Paul Jones (u) at
}

9.2 A Book is written by an Author - Using an "Object" Data Member

Let's design a Book class. Assume that a book is written by one and only one author. The Bookclass (as shown in the class diagram) contains the following members:

Four private data members: name (string), author (an instance of the class Author that we have created earlier), price (double), and qtyInStock (int, with default value of 0). The price shall be positive and the qtyInStock shall be zero or positive.
Take note that data member author is an instance (object) of the class Author, instead of a fundamental types (such as int, double). In fact, name is an object of the class string too.
The public getters and setters for the private data members. Take note thatgetAuthor() returns an object (an instance of class Author).
A public member function print(), which prints "'book-name' by author-name (gender) @email".
A public member function getAuthorName(), which returns the name of the author of this Book instance.

The hallow diamond shape in the class diagram denotes aggregation (or has-a) association relationship. That is, a Book instance has one (and only one) Author instance as its component.

Header File - Book.h

/* Header for the class Book (Book.h) */
#ifndef BOOK_H
#define BOOK_H
 
#include <string>
#include "Author.h"   // Use the Author class
using namespace std;
 
class Book {
private:
   string name;
   Author author; // data member author is an instance of class Author
   double price;
   int qtyInStock;
 
public:
   Book(string name, Author author, double price, int qtyInStock = 0);
      // To recieve an instance of class Author as argument
   string getName() const;
   Author getAuthor() const;  // Returns an instance of the class Author
   double getPrice() const;
   void setPrice(double price);
   int getQtyInStock() const;
   void setQtyInStock(int qtyInStock);
   void print() const;
   string getAuthorName() const;
};
 
#endif

#include "Author.h"We need to include the "Author.h" header, as we use the Author class in this class Book.

private:
Author author;We declare a private data member author as an instance of class Author, defined earlier.

Implementation File - Book.cpp

/* Implementation for the class Book (Book.cpp) */
#include <iostream>
#include "Book.h"
using namespace std;
 
// Constructor, with member initializer list to initialize the
//  component Author instance
Book::Book(string name, Author author, double price, int qtyInStock)
      : name(name), author(author) {   // Must use member initializer list to construct object
   // Call setters to validate price and qtyInStock
   setPrice(price);
   setQtyInStock(qtyInStock);
}
 
string Book::getName() const {
   return name;
}
 
Author Book::getAuthor() const {
   return author;
}
 
double Book::getPrice() const {
   return price;
}
 
// Validate price, which shall be positive
void Book::setPrice(double price) {
   if (price > 0) {
      this->price = price;
   } else {
      cout << "price should be positive! Set to 0" << endl;
      this->price = 0;
   }
}
 
int Book::getQtyInStock() const {
   return qtyInStock;
}
 
// Validate qtyInStock, which cannot be negative
void Book::setQtyInStock(int qtyInStock) {
   if (qtyInStock >= 0) {
      this->qtyInStock = qtyInStock;
   } else {
      cout << "qtyInStock cannot be negative! Set to 0" << endl;
      this->qtyInStock = 0;
   }
}
 
// print in the format ""Book-name" by author-name (gender) at email"
void Book::print() const {
   cout << "'" << name << "' by ";
   author.print();
}
 
// Return the author' name for this Book
string Book::getAuthorName() const {
   return author.getName();   // invoke the getName() on instance author
}

Book::Book(string name, Author author, double price, int qtyInStock)
      : name(name), author(author) {
   setPrice(price);
   setQtyInStock(qtyInStock);
}
In the constructor, the caller is supposed to create an instance of Author, and pass the instance into the constructor. We use member initializer list to initialize data members name andauthor. We call setters in the body, which perform input validation to set the price and qtyInStock. The body is run after the member initializer list. The author(author) invokes the default copy constructor of the Author class, which performs memberwise copy for all the data members. Object data member shall be constructed via the member initializer list, not in the body. Otherwise, the default constructor will be invoked to construct the object.

void Book::setPrice(double price) {
   if (price > 0) {
      this->price = price;
   } else {
      cout << "price should be positive! Set to 0" << endl;
      this->price = 0;
   }
}The setter for price validates the given input.

string Book::getAuthorName() const {
return author.getName();
}
Invoke the getName() of the data member author, which returns the author's name of this Book instance.

TestBook.cpp

/* Test Driver for the Book class (TestBook.cpp) */
#include <iostream>
#include "Book.h"
using namespace std;
 
int main() {
   // Declare and construct an instance of Author
   Author peter("Peter Jones", "peter@somewhere.com", 'm');
   peter.print();  // Peter Jones (m) at peter@somewhere.com
 
   // Declare and construct an instance of Book
   Book cppDummy("C++ for Dummies", peter, 19.99);
   cppDummy.setQtyInStock(88);
   cppDummy.print();
      // 'C++ for Dummies' by Peter Jones (m) at peter@somewhere.com
 
   cout << cppDummy.getQtyInStock() << endl;  // 88
   cout << cppDummy.getPrice() << endl;       // 19.99
   cout << cppDummy.getAuthor().getName() << endl;  // "Peter Jones"
   cout << cppDummy.getAuthor().getEmail() << endl; // "peter@somewhere.com"
   cout << cppDummy.getAuthorName() << endl;        // "Peter Jones"
 
   Book moreCpp("More C++ for Dummies", peter, -19.99);
      // price should be positive! Set to 0
   cout << moreCpp.getPrice() << endl;   // 0
}

The Default Copy Constructor

The initializer author(author) in the constructor invokes the so-called copy constructor. A copy constructor creates a new instance by copying the given instance of the same class. If you do not provide a copy constructor in your class, C++ provides a default copy constructor, which construct a new object via memberwise copy. For example, for Author class, the default copy constructor provided by the compiler is as follows:

// Default copy constructor of Author class provided by C++
Author::Author(const Author& other)
      : name(other.name), email(other.email), gender(other.gender) { }  // memberwise copy

9.3 Pass-by-Reference for Objects Function Parameters Author and string

By default, objects are pass-by-value into functions. That is, a clone copy is created and pass into the function, instead of the original copy. Pass-by-value for huge objects depicts performance due to the overhead of creating a clone copy.

Instead, we could pass an object into function by reference, via the reference (&) declaration in the parameter list. If we do not intend to modify the object inside the function (with side effect to the original copy), we set it as const.

In the Book class, data members of string and Author are objects. Author class was defined earlier; string is a class provided in C++ header <string>, belonging to the namespace std. Instead of including "using namespace std;" in the header (which is a poor practice as this statement will be included in all the files using this header), we shall use the scope resolution operator and refer to it as std::string.

Let's modify our Book class to illustrate pass-by-reference (for performance).

Author.h

/* Header for Author class (Author.h) */
#ifndef AUTHOR_H
#define AUTHOR_H
 
#include <string>
 
class Author {
private:
   std::string name;
   std::string email;
   char gender;   // 'm', 'f', or 'u' for unknown
 
public:
   Author(const std::string & name, const std::string & email, char gender);
          // & specifies pass by reference, const for non-mutable
   std::string getName() const;
   std::string getEmail() const;
   void setEmail(const std::string & email);
   char getGender() const;
   void print() const;
};
 
#endif

Program Notes:

In C++, string is a class in the standard library (in header <string>, belonging to namespace std), just like Point, Circle classes that we have defined.
Instead of including "using namespace std;", which is a poor practice as this statement will be included in all the files using this header, we use the fully-qualified name std::string.
Instead of passing string objects by value into function, which affects performance as a clone copy needs to be made. We pass the string objects by reference (indicated by &).
However, in pass-by-reference, changes inside the function will affect the caller's copy outside the function.
If we do not intend to change the object inside the function, we could use keyword const to indicate immutability. If the object is inadvertently changed inside the function, compiler would issue an error.

Author.cpp

/* Implementation for the Author class (Author.cpp) */
#include <iostream>
#include "Author.h"
using namespace std;
 
// Constructor, with input validation
Author::Author(const string & name, const string & email, char gender) : name(name) {
   setEmail(email);  // Call setter to check for valid email
   if (gender == 'm' || gender == 'f') {
      this->gender = gender;
   } else {
      cout << "Invalid gender! Set to 'u' (unknown)." << endl;
      this->gender = 'u';
   }
}
 
string Author::getName() const {
   return name;
}
 
string Author::getEmail() const {
   return email;
}
 
void Author::setEmail(const string & email) {
   // Check for valid email. Assume that a valid email contains
   //  a '@' that is not the first nor last character.
   size_t atIndex = email.find('@');
   if (atIndex != string::npos && atIndex != 0 && atIndex != email.length()-1) {
      this->email = email;
   } else {
      cout << "Invalid email! Set to empty string." << endl;
      this->email = "";
   }
}
 
char Author::getGender() const {
   return gender;
}
 
// print in the format "name (gender) at email"
void Author::print() const {
   cout << name << " (" << gender << ") at " << email << endl;
}

Program Notes:

Author::Author(const string & name, const string & email, char gender) { ...... }
In the constructor, the string objects are passed by reference. This improves the performance as it eliminates the need of creating a temporary (clone) object. The constructor then invokes the copy constructor of the string class to memberwise copy the arguments into its data members name and email.
We make the parameters const to prevent them from modifying inside the function (with side effect to the original copies).

Book.h

/* Header for the class Book (Book.h) */
#ifndef BOOK_H
#define BOOK_H
 
#include <string>
#include "Author.h"   // Use the Author class
using namespace std;
 
class Book {
private:
   string name;
   Author author;
   double price;
   int qtyInStock;
 
public:
   Book(const string & name, const Author & author, double price, int qtyInStock = 0);
   string getName() const;
   Author getAuthor() const;
   double getPrice() const;
   void setPrice(double price);
   int getQtyInStock() const;
   void setQtyInStock(int qtyInStock);
   void print() const;
   string getAuthorName() const;
};
 
#endif

Program Notes:

Book(const string & name, const Author & author, double price, int qtyInStock = 0);
string and Author objects are passed into the constructor via reference. This improves performance as it eliminates the creation of a temporary clone copy in pass-by-value. The parameters are marked const as we do not intend to modify them inside the function (with side effect to the original copies).
Author getAuthor() const;
The getter returns a copy of the data member author.

Book.cpp

/* Implementation for the class Book (Book.cpp) */
#include <iostream>
#include "Book.h"
using namespace std;
 
// Constructor, with member initializer list to initialize the
//  component Author instance
Book::Book(const string & name, const Author & author, double price, int qtyInStock)
      : name(name), author(author) { // Init object reference in member initializer list
   // Call setters to validate price and qtyInStock
   setPrice(price);
   setQtyInStock(qtyInStock);
}
 
string Book::getName() const {
   return name;
}
 
Author Book::getAuthor() {
   return author;
}
 
double Book::getPrice() const {
   return price;
}
 
// Validate price, which shall be positive
void Book::setPrice(double price) {
   if (price > 0) {
      this->price = price;
   } else {
      cout << "price should be positive! Set to 0" << endl;
      this->price = 0;
   }
}
 
int Book::getQtyInStock() const {
   return qtyInStock;
}
 
// Validate qtyInStock, which cannot be negative
void Book::setQtyInStock(int qtyInStock) {
   if (qtyInStock >= 0) {
      this->qtyInStock = qtyInStock;
   } else {
      cout << "qtyInStock cannnot be negative! Set to 0" << endl;
      this->qtyInStock = 0;
   }
}
 
// print in the format ""Book-name" by author-name (gender) at email"
void Book::print() const {
   cout << "'" << name << "' by ";
   author.print();
}
 
// Return the author' name for this Book
string Book::getAuthorName() const {
   return author.getName();   // invoke the getName() on instance author
}

Book::Book(const string & name, Author & author, double price, int qtyInStock)
: name(name), author(author) { ...... }name(name) and author(author) invoke the default copy constructors to construct new instances of string and Author by memberwise copy the parameters.
Author Book::getAuthor() { return author; }
A copy of the data member author is returned to the caller.
You should avoid returning a reference of a private data member to the caller (e.g., Author & Book::getAuthro() { return author; }), as the caller can change the private data member via the reference, which breaks the concept of "information hiding and encapsulation".

Test Driver - TestBook.cpp

/* Test Driver for the Book class (TestBook.cpp) */
#include <iostream>
#include "Book.h"
using namespace std;
 
int main() {
   // Declare and construct an instance of Author
   Author peter("Peter Jones", "peter@somewhere.com", 'm');
   peter.print();  // Peter Jones (m) at peter@somewhere.com
 
   // Declare and construct an instance of Book
   Book cppDummy("C++ for Dummies", peter, 19.99);
   cppDummy.print();
      // 'C++ for Dummies' by Peter Jones (m) at peter@somewhere.com
 
   peter.setEmail("peter@xyz.com");
   peter.print();   // Peter Jones (m) at peter@xyz.com
   cppDummy.print();
      // 'C++ for Dummies' by Peter Jones (m) at peter@somewhere.com
 
   cppDummy.getAuthor().setEmail("peter@abc.com");
   cppDummy.print();
      // 'C++ for Dummies' by Peter Jones (m) at peter@somewhere.com
}

In the above test program, an instance of Author called peter is constructed (in Line 8). This instance is passed by reference into Book's constructor (Line 12) to create the Book's instancecppDummy.

Summary

All the codes in this version of example (using references) is exactly the same as the previous version (without using references), except that the object function parameters are marked with "const classname &" (e.g., const string &, const Author &). This eliminates the creation of temporary clone object as in the pass-by-value, which improves the performance. Take note that the constructor actually invokes the copy constructor to make a copy for its data member, instead of referencing the copy provided by the caller.

Link to "C++ References & Resources"

Latest version tested: GCC (G++) 4.6.2
Last modified: May, 2013

Feedback, comments, corrections, and errata can be sent to Chua Hock-Chuan (ehchua@ntu.edu.sg) | HOME