# NumPy capitalize() function

In this tutorial, we will cover the `capitalize()` function of the char module in the Numpy library.

The `capitalize()` function is basically used to convert the first character of a string to an uppercase (capital) letter. If the string is having its first character as capital already, then this function will return the original string itself.

This function calls the `str.capitalize` in an element-wise manner.

This function is locale-dependent for an 8-bit string.

### Syntax of `capitalize()`:

The syntax required to use this function is as follows:

``numpy.char.capitalize(arr)``

The above syntax indicates that `capitalize()` function takes two parameters.

In the above syntax, the argument `arr` is mainly used to indicate the input array of the string on which this function will be applied.

Returned Values:

This function will return a string with the first character in the capital.

## Example 1: With a string

The code snippet is as follows where we will use `capitalize()` function with a simple string:

``````import numpy as np

a = "welcome to StudyTonight!!"
print("The original string:")
print(a)
print("Capitalizing the string using capitalize() function :")

x = np.char.capitalize(a)
print(x)``````

The original string:
welcome to StudyTonight!!
Capitalizing the string using capitalize() function :
Welcome to studytonight!!

## Example 2:

Below we have a code snippet where we will use a string that is already capitalized as input then check the output for the same:

``````import numpy as np

a = "StudyTonight is a best place to learn coding online"
print("The original string:\n")
print(a)
print("\n")
print("Capitalizing the string using capitalize() function:\n")

x = np.char.capitalize(a)
print(x)``````

The original string:

StudyTonight is a best place to learn coding online

Capitalizing the string using capitalize() function:

Studytonight is a best place to learn coding online

## Example 3: With an array of strings

In this example we will take an array of strings and will use the `capitalize()` function with it:

``````import numpy as np

arr = np.array(['what aRE YOUR', 'plans for Tonight', 'will you','study tonight'])
print ("The original Input array : \n", arr)

output = np.char.capitalize(arr)
print ("The output array: ", output)``````

The original Input array :
['what aRE YOUR' 'plans for Tonight' 'will you' 'study tonight']
The output array: ['What are your' 'Plans for tonight' 'Will you' 'Study tonight']

In the output, you should notice that not only this function changes the first character to uppercase in a string, but it also changes the other characters into lower case if they are in upper case, like it did for the string 'what aRE YOUR' in the above example.

## Summary

In this tutorial we learned about `capitalize()` function in the Numpy Library. We covered how it is used with its syntax and values returned by this function along with multiple code examples.