µContest, what is it ? How to participate ? How to solve the challenges proposed ? What language ? You will find all the answers to theses questions in this page. Concerning more specific questions, you can ask them on the forum.

General Presentation How to solve a challenge How to solve a challenge The µContest libraries General information libmicrocontest in C/C++ libmicrocontest in Python libmicrocontest in Java libmicrocontest in PHP Tutorial for C::B & Win & C/C++ users

Example of a challenge resolution I Example presention Solution in C/C++ Solution in Python Solution in Java Solution in PHP Solution in any other language Example of a challenge resolution II Example presention Solution in C/C++ Solution in Python Solution in Java Solution in PHP Solution in any other language

Technical documentations Communication interface, protocols Scoring law Versions of the libraries Library C/C++ documentation Library Python documentation Library Java documentation Library PHP documentation (work in progress)

import com.microcontest.Libmicrocontest2;
import com.microcontest.Contest;

Prototype / Description

boolean checkVersion()

Enables you to check if the lib version if up to date.

Parameters

N/A

Return value

true if the lib is up to date, false otherwise.

Example

if(Libmicrocontest2.checkVersion() == false)
{
	System.out.println("Warning: the version of the libmicrocontest2 is not the last one.");
	System.out.println("Current version :\t" + Libmicrocontest2.VERSION);
	System.out.println("This program may not work properly. Consider downloading the latest version on this page : http://www.microcontest.com/download.php\n");
}

Prototype / Description

• Contest commenceContest(int id_contest, String username, String password)
• Contest commenceContest(int id_contest)

Downloads new variable values from the website and store it. You need to use getxxxx to get them. The second form will use the information you put in credentials.properties in the same directory :

username = harry
password = potter

Parameters

• [in] int id_contest : The ID of the contest you want to solve, written on every contest page.
• [in] String username : (Optional if you use a file credentials.properties) Your username.
• [in] String password : (Optional if you use a file credentials.properties) Your password.

Return value

A Contest object you have to use to retreive the variable values.

Example

Contest cont = Contest.commenceContest(1, "Your nickname", "Your password");
// Contest cont = Contest.commenceContest(1); if you use credentials
 
int a = cont.getInt("a");
int b = cont.getInt("b");
// you can also use getDouble (for floating point values) and getParam (for strings)

Prototype / Description

String getParam(String variable_name)

Once you called Contest.commenceContest, you can retrieve the string variables values with this function.

Parameters

[in] String variable_name : The identificator string of the variable you want to retrieve written on every contest page.

Return value

The string value of the variable.

Example

Contest cont = Contest.commenceContest(4, "Your nickname", "Your password");
// Contest cont = Contest.commenceContest(4); if you use credentials
 
int key = cont.getInt("key");
String txt_crypted = cont.getParam("txt_crypte");

Prototype / Description

byte[] getBytes(String variable_name)

Once you called Contest.commenceContest, you can retrieve a byte array of the string with this function.

Parameters

[in] String variable_name : The identificator string of the variable you want to retrieve written on every contest page.

Return value

A new byte array storing the string bytes.

Example

Contest cont = Contest.commenceContest(6, "Your nickname", "Your password");
// Contest cont = Contest.commenceContest(4); if you use credentials
 
byte[] wav_Data = cont.getByte("wav");

Prototype / Description

int getInt(String variable_name)

Once you called commence_contest, you can retrieve the int variables values with this function.

Parameters

[in] String variable_name : The identificator string of the variable you want to retrieve written on every contest page.

Return value

The value of the variable.

Example

Contest cont = Contest.commenceContest(4, "Your nickname", "Your password");
// Contest cont = Contest.commenceContest(4); if you use credentials
 
int key = cont.getInt("key");
String txt_crypted = cont.getParam("txt_crypte");

Prototype / Description

Double getDouble(String variable_name)

Once you called commence_contest, you can retrieve the double variables values with this function.

Parameters

[in] String variable_name : The identificator string of the variable you want to retrieve written on every contest page.

Return value

The value of the variable.

Example

Contest cont = Contest.commenceContest(4, "Your nickname", "Your password");
// Contest cont = Contest.commenceContest(2); if you use credentials
 
Double a = cont.getDouble("a");
Double b = cont.getDouble("b");
Double c = cont.getDouble("c");

Prototype / Description

• void appendAnswer(String variable_name, int variable_value)
• void appendAnswer(String variable_name, double variable_value)
• void appendAnswer(String variable_name, String variable_value)

Once you solved the challenge, you need to add the answer(s) to the final solution. Then, you will call Contest.submitAnswer that will send all your answers to the website. You should use this function to add variables to the solution. Use the version you need depending on the type of the variable you want to append.

Parameters

• [in] String variable_name : The identificator string of the variable you want to retrieve written on every contest page.
•    [in] int variable_value : The value of your int variable you want to append.
• OR [in] double variable_value : The value of your double variable you want to append.
• OR [in] String variable_value : The string you want to append.

Return value

N/A

Example

Contest cont = Contest.commenceContest(1, "Your nickname", "Your password");
// Contest cont = Contest.commenceContest(1); if you use credentials

int a = cont.getInt("a");
int b = cont.getInt("b");
// you can also use getDouble (for floating point values) and getParam (for strings)

// append the answer
cont.appendAnswer("s", a + b);

// then submit the answer and print result
System.out.println(cont.submitAnswer());

Prototype / Description

String submitAnswer()

Once you solved the challenge and added all the answer variables to the solution, you need to call this function in order to send the solution to the website.

Parameters

N/A

Return value

A string informing you about the result.

Example

Contest cont = Contest.commenceContest(1, "Your nickname", "Your password");
// Contest cont = Contest.commenceContest(1); if you use credentials

int a = cont.getInt("a");
int b = cont.getInt("b");
// you can also use getDouble (for floating point values) and getParam (for strings)

// append the answer
cont.appendAnswer("s", a + b);

// then submit the answer and print result
System.out.println(cont.submitAnswer());