Java الكلاس `Vector` في جافا

مقدمة

الكلاس Vector يستخدم لإنشاء مصفوفات متطورة مقارنةً مع المصفوفات العادية Arrays, حيث يوفر لك مجموعة من الدوال التي تمكنك من البحث فيها, التشييك على عناصرها, إضافة عناصر جديدة, حذف عناصر منها, و معالجة أكثر من عنصر فيها في نفس الوقت إلخ..

أهم ميزة في المصفوفات التي نوعها Vector هي أن عدد العناصر فيها غير ثابت, حيث أنه يزيد عند إضافة عنصر جديد فيها و ينقص عند حذف عنصر منها بشكل تلقائي, و هذه الميزة غير موجودة في المصفوفات العادية.

كما أنك تستطيع الوصول للعناصر الموجودة فيها عن طريق أرقام الـ Index التي تعطى بالترتيب لكل عنصر يضاف فيها.

كونستركتورات الكلاس `Vector`

الجدول التالي يحتوي على جميع الكونستركتورات الموجودين في الكلاس Vector.

الكونستركتور مع تعريفه
`public Vector()` هذا الكونستركتور الإفتراضي في الكلاس `Vector`, يستخدم لإنشاء كائن نوعه `Vector` حجمه 10, أي يمكن أن يحتوي على 10 عناصر. هنا كلما امتلأ الـ `Vector` سيحجز مكان لـ 10 عناصر جديدة في الذاكرة.
`public Vector(int size)` يستخدم هذا الكونستركتور لتحديد حجم كائن الـ `Vector` الأولي. الرقم الذي نضعه كـ Argument في هذا الكونستركتور يحدد عدد العناصر الذي يمكن أن يحتويه كائن الـ `Vector`, و يحدد أيضاً عدد العناصر الذي سيحجز له في الذاكرة كلما امتلأ.
`public Vector(int size, int increment)` يستخدم هذا الكونستركتور لتحديد حجم كائن الـ `Vector` الأولي و تحديد كم عنصر جديد سيضاف فيه كلما امتلأ. الرقم الذي نضعه مكان الباراميتر `size` يحدد عدد العناصر الذي يمكن أن يحتويه كائن الـ `Vector`. الرقم الذي نضعه مكان الباراميتر `increment يحدد أيضاً عدد العناصر الذي سيحجز له في الذاكرة كلما امتلأ.`
`public Vector(Collection c)` يستخدم هذا الكونستركتور لإنشاء كائن نوعه `Vector` يحتوي على عناصر كائن الـ `Collection` الذي نمرره له كـ Argument.

دوال الكلاس `Vector`

الجدول التالي يحتوي على جميع دوال الكلاس Vector.

الدالة مع تعريفها
`public void add(int index, Object element)` تستخدم لإضافة عنصر جديد في مكان محدد في كائن الـ `Vector`.
`public boolean add(Object o)` تستخدم لإضافة عنصر جديد في آخر كائن الـ `Vector`. ترجع `true` إذا تمت الإضافة بنجاح.
`public boolean addAll(Collection c)` تستخدم لإضافة جميع العناصر الموجودين في كائن الـ `Collection` بالترتيب في آخر كائن الـ `Vector`. ترجع `true` إذا تمت الإضافة بنجاح.
`public boolean addAll(int index, Collection c)` تستخدم لإضافة جميع العناصر الموجودين في كائن الـ `Collection` بالترتيب في مكان محدد في كائن الـ `Vector`. ترجع `true` إذا تمت الإضافة بنجاح.
`public void addElement(Object o)` تستخدم لإضافة عنصر جديد في آخر كائن الـ `Vector` مع زيادة عدد العناصر واحداً.
`public int capacity()` ترجع حجم كائن الـ `Vector` المحجوز في الذاكرة.
`public void clear()` تمسح جميع العناصر الموجودة في كائن الـ `Vector`.
`public Object clone()` تنشئ نسخة من كائن الـ `Vector`.
`public boolean contains(Object elem)` ترجع `true` إذا كان كائن الـ `Vector` يحتوي على الكائن الذي نضعه لها كـ Argument.
`public boolean containsAll(Collection c)` ترجع `true` إذا كان كائن الـ `Vector` يحتوي على جميع العناصر الموجودة في كائن الـ `Collection` الذي نضعه لها كـ Argument.
`public void copyInto(Object[] anArray)` تنسخ محتوى كائن الـ `Vector` في مصفوفة من نفس النوع. ملاحظة: حجم المصفوفة التي سيتم نسخ القيم فيها يجب أن لا يكون أصغر من حجم كائن الـ `Vector`. كما أن نوع المصفوفة التي سيتم النسخ فيها يجب أن يتناسب مع نوع القيم المراد تخزينها فيها.
`public Object elementAt(int index)` ترجع العنصر الموجود على الـ index الذي نمرره لها كـ Argument.
`public Enumeration elements()` ترجع كائن نوع `Enumeration` يحتوي على جميع عناصر كائن الـ `Vector`.
`public void ensureCapacity(int minCapacity)` تحدد عدد العناصر الأقل الذي يجب أن يحجز للكائن `Vector` في الذاكرة. إذا كان العدد الموضوع فيها أكبر من عدد العناصر المحجوز للكائن `Vector`, عندها يتم تكبير حجمه. إذا كان العدد الموضوع فيها أصغر من عدد العناصر الموجودة في كائن الـ `Vector`, لن تفعل أي شيء.
`public boolean equals(Object o)` تقارن كائن الـ `Vector` مع أي مصفوفة نمررها لها كـ Argument. ترجع `true` في حال كان كائن الـ `Vector` يتطابق مع المصفوفة في عدد و قيم العناصر الموضوعة فيهما و بنفس الترتيب.
`public Object firstElement()` ترجع أول عنصر موجود في كائن الـ `Vector`, أي العنصر الموجود على الـ index رقم 0.
`public Object get(int index)` ترجع العنصر الموجود على الـ index الذي نمرره لها كـ Argument.
`public int hashCode()` ترجع الـ Hash Code للعنصر الذي قام باستدعائها.
`public int indexOf(Object elem)` تبحث في كائن الـ `Vector` عن أي قيمة نمررها لها كـ Argument. ترجع رقم أول Index يحتوي على القيمة المطلوبة في حال وجود نفس القيمة في أكثر من عنصر. ترجع 1- في حال عدم إيجاد القيمة المطلوبة.
`public int indexOf(Object elem, int index)` تبحث في كائن الـ `Vector` عن أي قيمة نمررها لها كـ Argument. تبدأ عملية البحث من رقم الـ index الذي نضعه مكان الباراميتر الثاني. ترجع رقم أول Index يحتوي على القيمة المطلوبة في حال وجود نفس القيمة في أكثر من عنصر. ترجع 1- في حال عدم إيجاد القيمة المطلوبة.
`public void insertElementAt(Object obj, int index)` تستخدم لإضافة عنصر جديد في مكان محدد في كائن الـ `Vector`.
`public boolean isEmpty()` ترجع `true` في حال كان كائن الـ `Vector` فارغاً.
`public Object lastElement()` ترجع آخر عنصر موجود في كائن الـ `Vector`.
`public int lastIndexOf(Object elem)` تبحث في كائن الـ `Vector` عن أي قيمة نمررها لها كـ Argument. ترجع رقم آخر Index يحتوي على القيمة المطلوبة في حال وجود نفس القيمة في أكثر من عنصر. ترجع 1- في حال عدم إيجاد القيمة المطلوبة.
`public int lastIndexOf(Object elem, int index)` تبحث في كائن الـ `Vector` عن أي قيمة نمررها لها كـ Argument. تبدأ عملية البحث من رقم الـ index الذي نضعه مكان الباراميتر الثاني. ترجع رقم آخر Index يحتوي على القيمة المطلوبة في حال وجود نفس القيمة في أكثر من عنصر. ترجع 1- في حال عدم إيجاد القيمة المطلوبة.
`public Object remove(int index)` تحذف عنصر محدد من كائن الـ `Vector`.
`public boolean remove(Object o)` تحذف أول عنصر يتم إيجاده في كائن الـ `Vector` في حال كان يتطابق مع الكائن الذي نمرره لها كـ Argument. ترجع `true` إذا تم حذف العنصر بنجاح.
`public boolean removeAll(Collection c)` تحذف مجموعة متتالية من العناصر الموجود في كائن الـ `Vector` في حال كانت تتطابق مع كائن الـ `Collection` الذي نمرره لها كـ Argument. ترجع `true` إذا تم حذف جميع العناصر بنجاح.
`public boolean removeAllElements()` تحذف جميع العناصر من كائن الـ `Vector`, و تجعل حجمه يساوي 0. ترجع `true` إذا تم حذف جميع العناصر بنجاح.
`public boolean removeElement(Object obj)` تحذف أول عنصر يتم إيجاده في كائن الـ `Vector` في حال كان يتطابق مع الكائن الذي نمرره لها كـ Argument. ترجع `true` إذا تم حذف العنصر بنجاح.
`public void removeElementAt(int index)` تحذف عنصر محدد من عناصر كائن الـ `Vector`.
`public boolean retainAll(Collection c)` تبقي عناصر كائن الـ `Vector` الموجودة في كائن الـ `Collection` الذي نمرره لها كـ Argument, و تحذف جميع العناصر الأخرى.
`public Object set(int index, Object element)` تبدل عنصر محدد في كائن الـ `Vector` بعنصر جديد, و ترجعه أيضاً.
`public void setElementAt(Object obj, int index)` تبدل عنصر محدد في كائن الـ `Vector` بعنصر جديد.
`public void setSize(int newSize)` تحدد عدد عناصر كائن الـ `Vector`. إذا كان العدد الموضوع فيها أكبر من عدد عناصر كائن الـ `Vector`, عندها توضع القيمة `null` مكان كل عنصر فارغ ( أي غير مستخدم ). إذا كان العدد الموضوع فيها أصغر من عدد العناصر كائن الـ `Vector`, عندها يتم حذف العناصر التي لم يعد كائن الـ `Vector` قادراً على تخزينها.
`public int size()` ترجع عدد العناصر الموجودة في كائن الـ `Vector`.
`public subList(int fromIndex, int toIndex)` ترجع كائن نوعه `List` يمثل العناصر الموجودة في كائن الـ `Vector` إبتداءاً من `fromIndex` وصولاً إلى ما قبل `toIndex`.
`public Object[] toArray()` ترجع مصفوفة نوعها `Object` تحتوي على جميع العناصر الموجودة في كائن الـ `Vector`.
`public String toString()` ترجع كائن نوعه `String` يمثل العناصر الموجودة في كائن الـ `Vector`.
`public void trimToSize()` تصغر حجم كائن الـ `Vector` في الذاكرة, حيث أنها تحذف جميع الأماكن المحجوزة له في الذاكرة و التي لم يضطر إلى استخدامها لأنها ما زالت فارغة ( أي لا تحتوي على عنصر ).

أمثلة شاملة

في كل مثال موضوع استخدامنا كونستركتور مختلف و دوال جديدة.

المثال الأول

في المثال التالي وضحنا الفرق بين حجم كائن الـ Vector في الذاكرة و بين عدد عناصره المستخدمة.

استخدامنا فيه الدوال التالية: add() - capacity() - size() - trimToSize().

Main.java

import java.util.Vector;                                         // Vector هنا قمنا باستدعاء الكلاس
 
public class Main {
 
    public static void main(String[] args) {
 
        Vector v = new Vector();                                 // باستخدام الكونستركتور الإفتراضي v إسمه Vector هنا قمنا بإنشاء كائن من الكلاس
 
        System.out.println("capacity = " + v.capacity());        // في الذاكرة و الذي سيكون 10 لأن هذا الكائن أنشئ بواسطة الكونستركتور الإفتراضي v هنا عرضنا عدد العناصر المحجوز للكائن
        System.out.println("size     = " + v.size() + "\n");     // و الذي سيكون 0 لأننا لم ندخل فيه أي كائن بعد v هنا عرضنا عدد عناصر الكائن
 
        v.add("A");                                              // v هنا قمنا بإضافة 11 عنصر في الكائن
        v.add("B");
        v.add("C");
        v.add("D");
        v.add("E");
        v.add("F");
        v.add("G");
        v.add("H");
        v.add("I");
        v.add("J");
        v.add("K");
 
        System.out.println("capacity = " + v.capacity());        // و الذي أصبح 20 لأن الكونستركتور الإفتراضي يحجز 10 أماكن جديدة كلما إمتلأ v هنا عرضنا عدد العناصر المحجوز للكائن
        System.out.println("size     = " + v.size() + "\n");     // و الذي أصبح 11 لأننا أضفنا فيه 11 عنصراً v هنا عرضنا عدد عناصر الكائن
 
        v.trimToSize();                                          // و التي لم يحتاجها v هنا قمنا بحذف الأماكن المحجوزة في الذاكرة من أجل الكائن
 
        System.out.println("capacity = " + v.capacity());        // هنا عرضنا حجم المصفوفة في الذاكرة و عدد عناصرها, لاحظ أنهما أصبحا متساويان
        System.out.println("size     = " + v.size());
 
    }
 
}